SpyBara
Go Premium

Documentation 2026-07-09 23:58 UTC to 2026-07-10 17:00 UTC

112 files changed +1,764 −976. View all changes and history on the product overview
2026
Sat 11 07:01 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01

admin-setup.md +6 −6

Details

15</Note>15</Note>

16 16 

17| Entscheidung | Was Sie wählen | Referenz |17| Entscheidung | Was Sie wählen | Referenz |

18| :---------------------------------------------------------------------------------------- | :-------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |18| :---------------------------------------------------------------------------------------- | :-------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

19| [API-Anbieter wählen](#choose-your-api-provider) | Wo Claude Code sich authentifiziert und wie es abgerechnet wird | [Authentifizierung](/de/authentication), [Bedrock](/de/amazon-bedrock), [Vertex AI](/de/google-vertex-ai), [Foundry](/de/microsoft-foundry) |19| [API-Anbieter wählen](#choose-your-api-provider) | Wo Claude Code sich authentifiziert und wie es abgerechnet wird | [Authentifizierung](/de/authentication), [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry) |

20| [Entscheiden Sie, wie Einstellungen Geräte erreichen](#decide-how-settings-reach-devices) | Wie verwaltete Richtlinien Entwicklermaschinen erreichen | [Server-verwaltete Einstellungen](/de/server-managed-settings), [Einstellungsdateien](/de/settings#settings-files) |20| [Entscheiden Sie, wie Einstellungen Geräte erreichen](#decide-how-settings-reach-devices) | Wie verwaltete Richtlinien Entwicklermaschinen erreichen | [Server-verwaltete Einstellungen](/de/server-managed-settings), [Einstellungsdateien](/de/settings#settings-files) |

21| [Entscheiden Sie, was durchgesetzt werden soll](#decide-what-to-enforce) | Welche Tools, Befehle und Integrationen zulässig sind | [Berechtigungen](/de/permissions), [Sandboxing](/de/sandboxing) |21| [Entscheiden Sie, was durchgesetzt werden soll](#decide-what-to-enforce) | Welche Tools, Befehle und Integrationen zulässig sind | [Berechtigungen](/de/permissions), [Sandboxing](/de/sandboxing) |

22| [Nutzungssichtbarkeit einrichten](#set-up-usage-visibility) | Wie Sie Ausgaben und Akzeptanz verfolgen | [Analytik](/de/analytics), [Überwachung](/de/monitoring-usage), [Kosten](/de/costs) |22| [Nutzungssichtbarkeit einrichten](#set-up-usage-visibility) | Wie Sie Ausgaben und Akzeptanz verfolgen | [Analytik](/de/analytics), [Überwachung](/de/monitoring-usage), [Kosten](/de/costs) |


33| Claude für Teams / Enterprise | Sie möchten Claude Code und claude.ai unter einem Pro-Sitz-Abonnement ohne Infrastruktur zum Ausführen. Dies ist die Standardempfehlung. |33| Claude für Teams / Enterprise | Sie möchten Claude Code und claude.ai unter einem Pro-Sitz-Abonnement ohne Infrastruktur zum Ausführen. Dies ist die Standardempfehlung. |

34| Claude Console | Sie sind API-first oder möchten Pay-as-you-go-Abrechnung |34| Claude Console | Sie sind API-first oder möchten Pay-as-you-go-Abrechnung |

35| Amazon Bedrock | Sie möchten vorhandene AWS-Compliance-Kontrollen und Abrechnung erben |35| Amazon Bedrock | Sie möchten vorhandene AWS-Compliance-Kontrollen und Abrechnung erben |

36| Google Vertex AI | Sie möchten vorhandene GCP-Compliance-Kontrollen und Abrechnung erben |36| Google Cloud's Agent Platform | Sie möchten vorhandene GCP-Compliance-Kontrollen und Abrechnung erben |

37| Microsoft Foundry | Sie möchten vorhandene Azure-Compliance-Kontrollen und Abrechnung erben |37| Microsoft Foundry | Sie möchten vorhandene Azure-Compliance-Kontrollen und Abrechnung erben |

38 38 

39Einige Claude Code-Funktionen erfordern ein claude.ai-Konto. [Claude Code im Web](/de/claude-code-on-the-web), [Routinen](/de/routines), [Code Review](/de/code-review), [Remote Control](/de/remote-control) und die [Chrome-Erweiterung](/de/chrome) sind nicht über Console API-Schlüssel oder Cloud-Provider-Anmeldedaten allein verfügbar. Wenn Sie über Bedrock, Vertex oder Foundry bereitstellen, planen Sie, ob Entwickler auch Claude für Teams oder Enterprise-Sitze benötigen. Jede Funktionsseite listet ihre Plan-Anforderungen auf.39Einige Claude Code-Funktionen erfordern ein claude.ai-Konto. [Claude Code im Web](/de/claude-code-on-the-web), [Routinen](/de/routines), [Code Review](/de/code-review), [Remote Control](/de/remote-control) und die [Chrome-Erweiterung](/de/chrome) sind nicht über Console API-Schlüssel oder Cloud-Provider-Anmeldedaten allein verfügbar. Wenn Sie über Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry bereitstellen, planen Sie, ob Entwickler auch Claude für Teams oder Enterprise-Sitze benötigen. Jede Funktionsseite listet ihre Plan-Anforderungen auf.

40 40 

41Für den vollständigen Anbietervergleich mit Authentifizierung, Regionen und Funktionsparität siehe [Übersicht zur Enterprise-Bereitstellung](/de/third-party-integrations). Die Auth-Einrichtung für jeden Anbieter finden Sie unter [Authentifizierung](/de/authentication).41Für den vollständigen Anbietervergleich mit Authentifizierung, Regionen und Funktionsparität siehe [Übersicht zur Enterprise-Bereitstellung](/de/third-party-integrations). Die Auth-Einrichtung für jeden Anbieter finden Sie unter [Authentifizierung](/de/authentication).

42 42 


57 57 

58Ein konfigurierter [`policyHelper`](/de/settings#compute-managed-settings-with-a-policy-helper) setzt sich vor alle vier Quellen durch: Seine Ausgabe wird die einzige verwaltete Konfiguration für den Durchlauf. Siehe [Einstellungspriorität](/de/settings#settings-precedence).58Ein konfigurierter [`policyHelper`](/de/settings#compute-managed-settings-with-a-policy-helper) setzt sich vor alle vier Quellen durch: Seine Ausgabe wird die einzige verwaltete Konfiguration für den Durchlauf. Siehe [Einstellungspriorität](/de/settings#settings-precedence).

59 59 

60Server-verwaltete Einstellungen erreichen Geräte zum Authentifizierungszeitpunkt und werden während aktiver Sitzungen stündlich aktualisiert, ohne dass eine Endpunkt-Infrastruktur erforderlich ist. Die Lieferung über die claude.ai-Administratorkonsole erfordert einen Claude for Teams oder Enterprise-Plan. Bereitstellungen auf Bedrock, Vertex AI oder Foundry können die gleiche Remote-Lieferung durch Ausführung eines [Claude-Apps-Gateways](/de/claude-apps-gateway) erhalten oder stattdessen einen der dateibasierten oder Betriebssystem-Mechanismen verwenden.60Server-verwaltete Einstellungen erreichen Geräte zum Authentifizierungszeitpunkt und werden während aktiver Sitzungen stündlich aktualisiert, ohne dass eine Endpunkt-Infrastruktur erforderlich ist. Die Lieferung über die claude.ai-Administratorkonsole erfordert einen Claude for Teams oder Enterprise-Plan. Bereitstellungen auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry können die gleiche Remote-Lieferung durch Ausführung eines [Claude-Apps-Gateways](/de/claude-apps-gateway) erhalten oder stattdessen einen der dateibasierten oder Betriebssystem-Mechanismen verwenden.

61 61 

62Wenn Ihre Organisation mehrere Anbieter mischt, konfigurieren Sie [server-verwaltete Einstellungen](/de/server-managed-settings) für claude.ai-Benutzer plus ein [dateibasiertes oder plist/Registry-Fallback](/de/settings#settings-files), damit andere Benutzer immer noch verwaltete Richtlinien erhalten.62Wenn Ihre Organisation mehrere Anbieter mischt, konfigurieren Sie [server-verwaltete Einstellungen](/de/server-managed-settings) für claude.ai-Benutzer plus ein [dateibasiertes oder plist/Registry-Fallback](/de/settings#settings-files), damit andere Benutzer immer noch verwaltete Richtlinien erhalten.

63 63 


153* [Server-verwaltete Einstellungen](/de/server-managed-settings): Liefern Sie verwaltete Richtlinien über die Claude-Administratorkonsole153* [Server-verwaltete Einstellungen](/de/server-managed-settings): Liefern Sie verwaltete Richtlinien über die Claude-Administratorkonsole

154* [Einstellungsreferenz](/de/settings): Jeder Einstellungsschlüssel, Dateispeicherort und Prioritätsregel154* [Einstellungsreferenz](/de/settings): Jeder Einstellungsschlüssel, Dateispeicherort und Prioritätsregel

155* [Monorepos und große Repositorys](/de/large-codebases): Pro-Verzeichnis-Konfigurationsmuster für Organisationen, die in einem Monorepo bereitstellen155* [Monorepos und große Repositorys](/de/large-codebases): Pro-Verzeichnis-Konfigurationsmuster für Organisationen, die in einem Monorepo bereitstellen

156* [Amazon Bedrock](/de/amazon-bedrock), [Google Vertex AI](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry): Anbieter-spezifische Bereitstellung156* [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry): Anbieter-spezifische Bereitstellung

157* [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO, SCIM, Sitzplatzverwaltung und Rollout-Playbook157* [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO, SCIM, Sitzplatzverwaltung und Rollout-Playbook

advisor.md +2 −2

Details

9{/* plan-availability: feature=advisor providers=anthropic */}9{/* plan-availability: feature=advisor providers=anthropic */}

10 10 

11<Note>11<Note>

12 Das Advisor-Tool ist experimentell und erfordert Claude Code v2.1.98 oder später mit der Anthropic API. Es ist nicht auf Amazon Bedrock, Google Vertex AI oder Microsoft Foundry verfügbar. Verhalten, Preisgestaltung und Verfügbarkeit können sich ändern.12 Das Advisor-Tool ist experimentell und erfordert Claude Code v2.1.98 oder später mit der Anthropic API. Es ist nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar. Verhalten, Preisgestaltung und Verfügbarkeit können sich ändern.

13</Note>13</Note>

14 14 

15Das Advisor-Tool ermöglicht es Claude, ein zweites, typischerweise stärkeres Modell an wichtigen Momenten während einer Aufgabe zu konsultieren, z. B. bevor ein Ansatz festgelegt wird, wenn ein wiederkehrender Fehler auftritt, oder bevor eine Aufgabe als abgeschlossen erklärt wird. Der Advisor erhält das gesamte Gespräch, einschließlich aller Tool-Aufrufe und Ergebnisse, und gibt Anleitung zurück, die Claude vor dem Fortfahren anwendet.15Das Advisor-Tool ermöglicht es Claude, ein zweites, typischerweise stärkeres Modell an wichtigen Momenten während einer Aufgabe zu konsultieren, z. B. bevor ein Ansatz festgelegt wird, wenn ein wiederkehrender Fehler auftritt, oder bevor eine Aufgabe als abgeschlossen erklärt wird. Der Advisor erhält das gesamte Gespräch, einschließlich aller Tool-Aufrufe und Ergebnisse, und gibt Anleitung zurück, die Claude vor dem Fortfahren anwendet.


162Das Advisor-Tool erfordert alle folgenden Voraussetzungen:162Das Advisor-Tool erfordert alle folgenden Voraussetzungen:

163 163 

164* **Claude Code v2.1.98 oder später**: Führen Sie `claude update` aus, um zu aktualisieren.164* **Claude Code v2.1.98 oder später**: Führen Sie `claude update` aus, um zu aktualisieren.

165* **Nur Anthropic API**: Der Advisor ist ein serverseitig ausgeführtes Tool. Er ist nicht auf Amazon Bedrock, Google Vertex AI oder Microsoft Foundry verfügbar. Über ein [LLM-Gateway](/de/llm-gateway), das mit `ANTHROPIC_BASE_URL` konfiguriert ist, hängt die Verfügbarkeit davon ab, ob das Gateway die Anfrage intakt an die Anthropic API weiterleitet.165* **Nur Anthropic API**: Der Advisor ist ein serverseitig ausgeführtes Tool. Er ist nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar. Über ein [LLM-Gateway](/de/llm-gateway), das mit `ANTHROPIC_BASE_URL` konfiguriert ist, hängt die Verfügbarkeit davon ab, ob das Gateway die Anfrage intakt an die Anthropic API weiterleitet.

166* **Unterstütztes Hauptmodell**: Opus 4.6 oder später, Sonnet 4.6 oder später oder Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5 qualifiziert sich auch auf Claude Code v2.1.170 oder später.166* **Unterstütztes Hauptmodell**: Opus 4.6 oder später, Sonnet 4.6 oder später oder Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5 qualifiziert sich auch auf Claude Code v2.1.170 oder später.

167 167 

168<h2 id="turn-the-advisor-off">168<h2 id="turn-the-advisor-off">

Details

202 202 

203Wenn eines der Limits erreicht wird, gibt das SDK eine `ResultMessage` mit einem entsprechenden Fehler-Subtyp (`error_max_turns` oder `error_max_budget_usd`) zurück. Siehe [Ergebnis verarbeiten](#handle-the-result) für die Überprüfung dieser Subtypen und [`ClaudeAgentOptions`](/de/agent-sdk/python#claudeagentoptions) / [`Options`](/de/agent-sdk/typescript#options) für die Syntax.203Wenn eines der Limits erreicht wird, gibt das SDK eine `ResultMessage` mit einem entsprechenden Fehler-Subtyp (`error_max_turns` oder `error_max_budget_usd`) zurück. Siehe [Ergebnis verarbeiten](#handle-the-result) für die Überprüfung dieser Subtypen und [`ClaudeAgentOptions`](/de/agent-sdk/python#claudeagentoptions) / [`Options`](/de/agent-sdk/typescript#options) für die Syntax.

204 204 

205Mit [Streaming-Eingabe](/de/agent-sdk/streaming-vs-single-mode) bleibt eine Nachricht, die Sie senden, während eine Runde noch läuft, in der Warteschlange, wenn diese Runde am Max-Turns-Limit endet, und sie startet ihre eigene Runde mit ihrem eigenen Max-Turns-Limit. Vor v2.1.205 konnte eine Nachricht, die in der letzten Iteration der Runde ankam, in die endende Runde aufgenommen und verloren gehen, ohne jemals das Modell zu erreichen.

206 

205<h3 id="effort-level">207<h3 id="effort-level">

206 Anstrengungsgrad208 Anstrengungsgrad

207</h3>209</h3>


231Die Berechtigungsmodus-Option (`permission_mode` in Python, `permissionMode` in TypeScript) kontrolliert, ob der Agent vor der Verwendung von Werkzeugen um Genehmigung fragt:233Die Berechtigungsmodus-Option (`permission_mode` in Python, `permissionMode` in TypeScript) kontrolliert, ob der Agent vor der Verwendung von Werkzeugen um Genehmigung fragt:

232 234 

233| Modus | Verhalten |235| Modus | Verhalten |

234| :------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |236| :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

235| `"default"` | Werkzeuge, die nicht durch Zulassungsregeln abgedeckt sind, lösen Ihren Genehmigungsrückruf aus; kein Rückruf bedeutet Ablehnung |237| `"default"` | Werkzeuge, die nicht durch Zulassungsregeln abgedeckt sind, lösen Ihren Genehmigungsrückruf aus; kein Rückruf bedeutet Ablehnung |

236| `"acceptEdits"` | Genehmigt automatisch Dateibearbeitungen und häufige Dateisystem-Befehle (`mkdir`, `touch`, `mv`, `cp`, usw.); andere Bash-Befehle folgen Standardregeln |238| `"acceptEdits"` | Genehmigt automatisch Dateibearbeitungen und häufige Dateisystem-Befehle (`mkdir`, `touch`, `mv`, `cp`, usw.); andere Bash-Befehle folgen Standardregeln |

237| `"plan"` | Claude erkundet und plant, ohne Ihre Quelldateien zu bearbeiten; Dateibearbeitungen werden nie automatisch genehmigt und werden durch Ihren `canUseTool`-Rückruf aufgefordert |239| `"plan"` | Claude erkundet und plant, ohne Ihre Quelldateien zu bearbeiten; Dateibearbeitungen werden nie automatisch genehmigt und werden durch Ihren `canUseTool`-Rückruf aufgefordert |

238| `"dontAsk"` | Fragt nie. Werkzeuge, die durch [Berechtigungsregeln](/de/settings#permission-settings) vorab genehmigt wurden, laufen, alles andere wird abgelehnt |240| `"dontAsk"` | Fragt nie. Werkzeuge, die durch [Berechtigungsregeln](/de/settings#permission-settings) vorab genehmigt wurden, laufen, alles andere wird abgelehnt |

239| `"auto"` (nur TypeScript) | Verwendet einen Modell-Klassifizierer, um jeden Werkzeugaufruf zu genehmigen oder abzulehnen. Siehe [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) für Verfügbarkeit und Verhalten |241| `"auto"` | Verwendet einen Modell-Klassifizierer, um jeden Werkzeugaufruf zu genehmigen oder abzulehnen. Siehe [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) für Verfügbarkeit und Verhalten |

240| `"bypassPermissions"` | Führt alle zulässigen Werkzeuge aus, ohne zu fragen, es sei denn, eine explizite [`ask`-Regel](/de/settings#permission-settings) passt; siehe [Wie Berechtigungen ausgewertet werden](/de/agent-sdk/permissions#how-permissions-are-evaluated) für die Position von Ask-Regeln in der Vorrangordnung. Kann nicht verwendet werden, wenn als Root auf Unix ausgeführt wird. Verwenden Sie nur in isolierten Umgebungen, in denen die Aktionen des Agenten keine Systeme beeinflussen können, die Ihnen wichtig sind |242| `"bypassPermissions"` | Führt alle zulässigen Werkzeuge aus, ohne zu fragen, es sei denn, eine explizite [`ask`-Regel](/de/settings#permission-settings) passt; siehe [Wie Berechtigungen ausgewertet werden](/de/agent-sdk/permissions#how-permissions-are-evaluated) für die Position von Ask-Regeln in der Vorrangordnung. Kann nicht verwendet werden, wenn als Root auf Unix ausgeführt wird. Verwenden Sie nur in isolierten Umgebungen, in denen die Aktionen des Agenten keine Systeme beeinflussen können, die Ihnen wichtig sind |

241 243 

242Für interaktive Anwendungen verwenden Sie `"default"` mit einem Werkzeug-Genehmigungsrückruf, um Genehmigungsaufforderungen anzuzeigen. Für autonome Agenten auf einer Dev-Maschine verwenden Sie `"acceptEdits"`, um Dateibearbeitungen und häufige Dateisystem-Befehle (`mkdir`, `touch`, `mv`, `cp`, usw.) automatisch zu genehmigen, während Sie andere `Bash`-Befehle immer noch hinter Zulassungsregeln gating. Reservieren Sie `"bypassPermissions"` für CI, Container oder andere isolierte Umgebungen. Siehe [Berechtigungen](/de/agent-sdk/permissions) für vollständige Details.244Für interaktive Anwendungen verwenden Sie `"default"` mit einem Werkzeug-Genehmigungsrückruf, um Genehmigungsaufforderungen anzuzeigen. Für autonome Agenten auf einer Dev-Maschine verwenden Sie `"acceptEdits"`, um Dateibearbeitungen und häufige Dateisystem-Befehle (`mkdir`, `touch`, `mv`, `cp`, usw.) automatisch zu genehmigen, während Sie andere `Bash`-Befehle immer noch hinter Zulassungsregeln gating. Reservieren Sie `"bypassPermissions"` für CI, Container oder andere isolierte Umgebungen. Siehe [Berechtigungen](/de/agent-sdk/permissions) für vollständige Details.


260Hier ist, wie jede Komponente den Kontext im SDK beeinflusst:262Hier ist, wie jede Komponente den Kontext im SDK beeinflusst:

261 263 

262| Quelle | Wann es lädt | Auswirkung |264| Quelle | Wann es lädt | Auswirkung |

263| :--------------------------- | :------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |265| :--------------------------- | :------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

266| **Werkzeugdefinitionen** | Jede Anfrage; MCP-Schemas standardmäßig aufgeschoben | Integrierte Werkzeugschemas werden bei jeder Anfrage geladen. [Werkzeugsuche](/de/agent-sdk/mcp#mcp-tool-search) schiebt MCP-Werkzeugschemas standardmäßig auf und fällt auf vorherige Laden auf Vertex AI oder einer Nicht-First-Party-`ANTHROPIC_BASE_URL` zurück. Siehe [Werkzeugsuche konfigurieren](/de/agent-sdk/tool-search#configure-tool-search) für die vollständige Matrix |268| **Werkzeugdefinitionen** | Jede Anfrage; MCP-Schemas standardmäßig aufgeschoben | Integrierte Werkzeugschemas werden bei jeder Anfrage geladen. [Werkzeugsuche](/de/agent-sdk/mcp#mcp-tool-search) schiebt MCP-Werkzeugschemas standardmäßig auf und fällt auf vorherige Laden auf Google Cloud's Agent Platform oder einer Nicht-First-Party-`ANTHROPIC_BASE_URL` zurück. Siehe [Werkzeugsuche konfigurieren](/de/agent-sdk/tool-search#configure-tool-search) für die vollständige Matrix |

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

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

269 271 


305 307 

306* **Verwenden Sie Subagenten für Unteraufgaben.** Jeder Subagent startet mit einem frischen Gespräch (kein vorheriger Nachrichtenverlauf, obwohl er seinen eigenen System-Prompt und Projekt-Kontext wie CLAUDE.md lädt). Er sieht nicht die Runden des Elternteils, und nur seine endgültige Antwort kehrt zum Elternteil als Werkzeugergebnis zurück. Der Kontext des Hauptagenten wächst um diese Zusammenfassung, nicht um das vollständige Unteraufgaben-Transkript. Siehe [Was Subagenten erben](/de/agent-sdk/subagents#what-subagents-inherit) für Details.308* **Verwenden Sie Subagenten für Unteraufgaben.** Jeder Subagent startet mit einem frischen Gespräch (kein vorheriger Nachrichtenverlauf, obwohl er seinen eigenen System-Prompt und Projekt-Kontext wie CLAUDE.md lädt). Er sieht nicht die Runden des Elternteils, und nur seine endgültige Antwort kehrt zum Elternteil als Werkzeugergebnis zurück. Der Kontext des Hauptagenten wächst um diese Zusammenfassung, nicht um das vollständige Unteraufgaben-Transkript. Siehe [Was Subagenten erben](/de/agent-sdk/subagents#what-subagents-inherit) für Details.

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

308* **Beobachten Sie MCP-Server-Kosten.** [MCP-Werkzeugsuche](/de/agent-sdk/mcp#mcp-tool-search) schiebt MCP-Werkzeugschemas standardmäßig auf und lädt sie bei Bedarf. Wenn die Werkzeugsuche ausgeschaltet ist, auf Vertex AI oder hinter einer Nicht-First-Party-`ANTHROPIC_BASE_URL`, fügt jeder MCP-Server alle seine Werkzeugschemas zu jeder Anfrage hinzu, daher können ein paar Server mit vielen Werkzeugen erheblichen Kontext verbrauchen, bevor der Agent irgendwelche Arbeiten verrichtet.310* **Beobachten Sie MCP-Server-Kosten.** [MCP-Werkzeugsuche](/de/agent-sdk/mcp#mcp-tool-search) schiebt MCP-Werkzeugschemas standardmäßig auf und lädt sie bei Bedarf. Wenn die Werkzeugsuche ausgeschaltet ist, auf Google Cloud's Agent Platform oder hinter einer Nicht-First-Party-`ANTHROPIC_BASE_URL`, fügt jeder MCP-Server alle seine Werkzeugschemas zu jeder Anfrage hinzu, daher können ein paar Server mit vielen Werkzeugen erheblichen Kontext verbrauchen, bevor der Agent irgendwelche Arbeiten verrichtet.

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

310 312 

311Für eine detaillierte Aufschlüsselung der Pro-Feature-Kontextkosten siehe [Kontextkosten verstehen](/de/features-overview#understand-context-costs).313Für eine detaillierte Aufschlüsselung der Pro-Feature-Kontextkosten siehe [Kontextkosten verstehen](/de/features-overview#understand-context-costs).

Details

292 Prompt-Cache-TTL auf eine Stunde verlängern292 Prompt-Cache-TTL auf eine Stunde verlängern

293</h3>293</h3>

294 294 

295Cache-Einträge, die vom SDK geschrieben werden, verwenden standardmäßig eine 5-Minuten-TTL, wenn Sie sich mit einem API-Schlüssel authentifizieren oder auf Amazon Bedrock, Google Cloud Vertex AI oder Microsoft Foundry ausführen. Wenn Ihre Workload viele kurze Sitzungen gegen das gleiche System-Prompt und den gleichen Kontext mit Lücken länger als 5 Minuten zwischen ihnen ausführt, läuft der Cache zwischen Sitzungen ab und jede neue Sitzung zahlt den vollen Input-Preis.295Cache-Einträge, die vom SDK geschrieben werden, verwenden standardmäßig eine 5-Minuten-TTL, wenn Sie sich mit einem API-Schlüssel authentifizieren oder auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry ausführen. Wenn Ihre Workload viele kurze Sitzungen gegen das gleiche System-Prompt und den gleichen Kontext mit Lücken länger als 5 Minuten zwischen ihnen ausführt, läuft der Cache zwischen Sitzungen ab und jede neue Sitzung zahlt den vollen Input-Preis.

296 296 

297Um eine 1-Stunden-TTL bei Cache-Schreibvorgängen anzufordern, setzen Sie die [`ENABLE_PROMPT_CACHING_1H`](/de/env-vars) Umgebungsvariable. Sie können sie in Ihrer Shell- oder Container-Umgebung exportieren oder sie durch `options.env` übergeben.297Um eine 1-Stunden-TTL bei Cache-Schreibvorgängen anzufordern, setzen Sie die [`ENABLE_PROMPT_CACHING_1H`](/de/env-vars) Umgebungsvariable. Sie können sie in Ihrer Shell- oder Container-Umgebung exportieren oder sie durch `options.env` übergeben.

298 298 

299Das folgende Beispiel aktiviert 1-Stunden-TTL für einen Agenten, der auf Bedrock ausgeführt wird:299Das folgende Beispiel aktiviert 1-Stunden-TTL für einen Agenten, der auf Amazon Bedrock ausgeführt wird:

300 300 

301<CodeGroup>301<CodeGroup>

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

Details

21| Ein Tool vorab genehmigen | Fügen Sie es zu Ihren zulässigen Tools hinzu. Siehe [Konfigurieren Sie zulässige Tools](#configure-allowed-tools). |21| Ein Tool vorab genehmigen | Fügen Sie es zu Ihren zulässigen Tools hinzu. Siehe [Konfigurieren Sie zulässige Tools](#configure-allowed-tools). |

22| Entfernen Sie ein integriertes Tool aus Claudes Kontext | Übergeben Sie ein `tools`-Array, das nur die gewünschten integrierten Tools auflistet. Siehe [Konfigurieren Sie zulässige Tools](#configure-allowed-tools). |22| Entfernen Sie ein integriertes Tool aus Claudes Kontext | Übergeben Sie ein `tools`-Array, das nur die gewünschten integrierten Tools auflistet. Siehe [Konfigurieren Sie zulässige Tools](#configure-allowed-tools). |

23| Lassen Sie Claude Tools parallel aufrufen | Setzen Sie `readOnlyHint: true` auf Tools ohne Nebenwirkungen. Siehe [Fügen Sie Tool-Annotationen hinzu](#add-tool-annotations). |23| Lassen Sie Claude Tools parallel aufrufen | Setzen Sie `readOnlyHint: true` auf Tools ohne Nebenwirkungen. Siehe [Fügen Sie Tool-Annotationen hinzu](#add-tool-annotations). |

24| Fehler behandeln, ohne die Schleife zu stoppen | Geben Sie `isError: true` zurück, anstatt zu werfen. Siehe [Fehler behandeln](#handle-errors). |24| Kontrollieren Sie die Fehlermeldung, die Claude liest | Geben Sie `isError: true` zurück, um die Nachricht zu verfassen, anstatt die rohe Ausnahme zu zeigen. Siehe [Fehler behandeln](#handle-errors). |

25| Geben Sie Bilder oder Dateien zurück | Verwenden Sie `image`- oder `resource`-Blöcke im Content-Array. Siehe [Geben Sie Bilder und Ressourcen zurück](#return-images-and-resources). |25| Geben Sie Bilder oder Dateien zurück | Verwenden Sie `image`- oder `resource`-Blöcke im Content-Array. Siehe [Geben Sie Bilder und Ressourcen zurück](#return-images-and-resources). |

26| Geben Sie ein maschinenlesbares JSON-Ergebnis zurück | Setzen Sie `structuredContent` auf das Ergebnis. Siehe [Geben Sie strukturierte Daten zurück](#return-structured-data). |26| Geben Sie ein maschinenlesbares JSON-Ergebnis zurück | Setzen Sie `structuredContent` auf das Ergebnis. Siehe [Geben Sie strukturierte Daten zurück](#return-structured-data). |

27| Skalieren Sie auf viele Tools | Verwenden Sie [Tool-Suche](/de/agent-sdk/tool-search), um Tools bei Bedarf zu laden. |27| Skalieren Sie auf viele Tools | Verwenden Sie [Tool-Suche](/de/agent-sdk/tool-search), um Tools bei Bedarf zu laden. |


356 Fehler behandeln356 Fehler behandeln

357</h2>357</h2>

358 358 

359Wie Ihr Handler Fehler meldet, bestimmt, ob die Agent-Schleife fortgesetzt oder gestoppt wird:359Ein Handler-Fehler stoppt die Agent-Schleife nicht. Der In-Process-MCP-Server des SDK fängt nicht abgefangene Ausnahmen ab und gibt sie als Fehler-Ergebnisse zurück. Daher bestimmt, wie Sie einen Fehler melden, was Claude liest, nicht ob die Abfrage fehlschlägt:

360 360 

361| Was passiert | Ergebnis |361| Was passiert | Ergebnis |

362| :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------ |362| :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

363| Handler wirft eine nicht abgefangene Ausnahme | Agent-Schleife stoppt. Claude sieht den Fehler nie, und der `query`-Aufruf schlägt fehl. |363| Handler wirft eine nicht abgefangene Ausnahme | Der MCP-Server konvertiert sie in ein Fehler-Ergebnis mit der rohen Ausnahmemeldung. Claude sieht diese Meldung, und die Agent-Schleife setzt sich fort. |

364| Handler fängt den Fehler ab und gibt `isError: true` (TS) / `"is_error": True` (Python) zurück | Agent-Schleife setzt sich fort. Claude sieht den Fehler als Daten und kann erneut versuchen, ein anderes Tool versuchen oder den Fehler erklären. |364| Handler fängt den Fehler ab und gibt `isError: true` (TS) / `"is_error": True` (Python) zurück | Claude sieht die Meldung, die Sie verfassen. Sie können Kontext hinzufügen, den die rohe Ausnahme nicht hat, z. B. welche Anfrage fehlgeschlagen ist oder was stattdessen zu versuchen ist. |

365 365 

366Das Beispiel unten fängt zwei Arten von Fehlern im Handler ab, anstatt sie werfen zu lassen. Ein Nicht-200-HTTP-Status wird aus der Antwort abgefangen und als Fehler-Ergebnis zurückgegeben. Ein Netzwerkfehler oder ungültiges JSON wird durch das umgebende `try/except` (Python) oder `try/catch` (TypeScript) abgefangen und auch als Fehler-Ergebnis zurückgegeben. In beiden Fällen gibt der Handler normal zurück und die Agent-Schleife setzt sich fort.366In beiden Fällen kann Claude erneut versuchen, ein anderes Tool versuchen oder den Fehler erklären. Fangen Sie Fehler selbst ab, wenn die rohe Ausnahmemeldung nicht ausreicht, damit Claude handeln kann.

367 

368Das Beispiel unten fängt zwei Arten von Fehlern im Handler ab und verfasst die Fehlermeldung, die Claude liest. Ein Nicht-200-HTTP-Status wird aus der Antwort abgefangen und als Fehler-Ergebnis zurückgegeben. Ein Netzwerkfehler oder ungültiges JSON wird durch das umgebende `try/except` (Python) oder `try/catch` (TypeScript) abgefangen und auch als Fehler-Ergebnis zurückgegeben. In beiden Fällen erhält Claude eine Meldung, die den Fehler beschreibt, anstatt einer bloßen Ausnahmemeldung.

367 369 

368<CodeGroup>370<CodeGroup>

369 ```python Python theme={null}371 ```python Python theme={null}


397 data = response.json()399 data = response.json()

398 return {"content": [{"type": "text", "text": json.dumps(data, indent=2)}]}400 return {"content": [{"type": "text", "text": json.dumps(data, indent=2)}]}

399 except Exception as e:401 except Exception as e:

400 # Catching here keeps the agent loop alive. An uncaught exception402 # Composes the message Claude reads. An uncaught exception would

401 # would end the whole query() call.403 # reach Claude as the raw str(e) with no context.

402 return {404 return {

403 "content": [{"type": "text", "text": f"Failed to fetch data: {str(e)}"}],405 "content": [{"type": "text", "text": f"Failed to fetch data: {str(e)}"}],

404 "is_error": True,406 "is_error": True,


440 ]442 ]

441 };443 };

442 } catch (error) {444 } catch (error) {

443 // Catching here keeps the agent loop alive. An uncaught throw445 // Composes the message Claude reads. An uncaught throw would

444 // would end the whole query() call.446 // reach Claude as the raw error message with no context.

445 return {447 return {

446 content: [448 content: [

447 {449 {


461 Geben Sie Bilder und Ressourcen zurück463 Geben Sie Bilder und Ressourcen zurück

462</h2>464</h2>

463 465 

464Das `content`-Array in einem Tool-Ergebnis akzeptiert `text`-, `image`-, `audio`-, `resource`- und `resource_link`-Blöcke. Sie können sie in derselben Antwort mischen. Audio-Blöcke werden auf der Festplatte gespeichert und Claude erhält einen Text-Block mit dem gespeicherten Dateipfad. Resource-Link-Blöcke werden in einen Text-Block konvertiert, der den Namen, die URI und die Beschreibung des Links enthält.466Das `content`-Array in einem Tool-Ergebnis akzeptiert `text`-, `image`-, `audio`-, `resource`- und `resource_link`-Blöcke. Sie können sie in derselben Antwort mischen. In TypeScript werden Audio-Blöcke auf der Festplatte gespeichert und Claude erhält einen Text-Block mit dem gespeicherten Dateipfad; in Python löscht das SDK Audio-Blöcke aus dem Tool-Ergebnis und protokolliert eine Warnung. Resource-Link-Blöcke werden in einen Text-Block konvertiert, der den Namen, die URI und die Beschreibung des Links enthält.

465 467 

466<h3 id="images">468<h3 id="images">

467 Bilder469 Bilder


535Ein Ressourcenblock bettet ein Stück Inhalt ein, das durch einen URI identifiziert wird. Der URI ist ein Label für Claude, um darauf zu verweisen; der tatsächliche Inhalt befindet sich im `text`- oder `blob`-Feld des Blocks. Verwenden Sie dies, wenn Ihr Tool etwas produziert, das sinnvoll ist, um später nach Name adressiert zu werden, wie eine generierte Datei oder ein Datensatz aus einem externen System.537Ein Ressourcenblock bettet ein Stück Inhalt ein, das durch einen URI identifiziert wird. Der URI ist ein Label für Claude, um darauf zu verweisen; der tatsächliche Inhalt befindet sich im `text`- oder `blob`-Feld des Blocks. Verwenden Sie dies, wenn Ihr Tool etwas produziert, das sinnvoll ist, um später nach Name adressiert zu werden, wie eine generierte Datei oder ein Datensatz aus einem externen System.

536 538 

537| Feld | Typ | Notizen |539| Feld | Typ | Notizen |

538| :------------------ | :----------- | :----------------------------------------------------------------------- |540| :------------------ | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |

539| `type` | `"resource"` | |541| `type` | `"resource"` | |

540| `resource.uri` | `string` | Bezeichner für den Inhalt. Beliebiges URI-Schema |542| `resource.uri` | `string` | Bezeichner für den Inhalt. Beliebiges URI-Schema |

541| `resource.text` | `string` | Der Inhalt, wenn er Text ist. Geben Sie dies oder `blob` an, nicht beide |543| `resource.text` | `string` | Der Inhalt, wenn er Text ist. Geben Sie dies oder `blob` an, nicht beide |

542| `resource.blob` | `string` | Der Inhalt Base64-kodiert, wenn er binär ist |544| `resource.blob` | `string` | Der Inhalt Base64-kodiert, wenn er binär ist. Nur TypeScript: das Python SDK löscht binäre Ressourcen aus dem Tool-Ergebnis und protokolliert eine Warnung |

543| `resource.mimeType` | `string` | Optional |545| `resource.mimeType` | `string` | Optional |

544 546 

545Dieses Beispiel zeigt einen Ressourcenblock, der von innen aus einem Tool-Handler zurückgegeben wird. Der URI `file:///tmp/report.md` ist ein Label, das Claude später referenzieren kann; das SDK liest nicht aus diesem Pfad.547Dieses Beispiel zeigt einen Ressourcenblock, der von innen aus einem Tool-Handler zurückgegeben wird. Der URI `file:///tmp/report.md` ist ein Label, das Claude später referenzieren kann; das SDK liest nicht aus diesem Pfad.

Details

250 250 

251* **Eingabedaten:** ein typisiertes Objekt mit Ereignisdetails. Jeder Hook-Typ hat seine eigene Eingabeform. Beispielsweise enthält `PreToolUseHookInput` `tool_name` und `tool_input`, während `NotificationHookInput` `message` enthält. Siehe die vollständigen Typdefinitionen in den [TypeScript](/de/agent-sdk/typescript#hookinput) und [Python](/de/agent-sdk/python#hookinput) SDK-Referenzen.251* **Eingabedaten:** ein typisiertes Objekt mit Ereignisdetails. Jeder Hook-Typ hat seine eigene Eingabeform. Beispielsweise enthält `PreToolUseHookInput` `tool_name` und `tool_input`, während `NotificationHookInput` `message` enthält. Siehe die vollständigen Typdefinitionen in den [TypeScript](/de/agent-sdk/typescript#hookinput) und [Python](/de/agent-sdk/python#hookinput) SDK-Referenzen.

252 * Alle Hook-Eingaben teilen `session_id`, `cwd` und `hook_event_name`.252 * Alle Hook-Eingaben teilen `session_id`, `cwd` und `hook_event_name`.

253 * `agent_id` und `agent_type` werden ausgefüllt, wenn der Hook in einem Subagent ausgelöst wird. In TypeScript befinden sich diese in der Basis-Hook-Eingabe und sind für alle Hook-Typen verfügbar. In Python sind sie nur auf `PreToolUse`, `PostToolUse` und `PostToolUseFailure` vorhanden.253 * `agent_id` und `agent_type` werden ausgefüllt, wenn der Hook in einem Subagent ausgelöst wird. In TypeScript befinden sich diese in der Basis-Hook-Eingabe und sind für alle Hook-Typen verfügbar. In Python sind sie optionale Felder auf `PreToolUse`, `PostToolUse`, `PostToolUseFailure` und `PermissionRequest`, und erforderliche Felder auf `SubagentStart` und `SubagentStop`.

254* **Tool-Verwendungs-ID** (`str | None` / `string | undefined`): korreliert `PreToolUse` und `PostToolUse` Ereignisse für denselben Tool-Aufruf.254* **Tool-Verwendungs-ID** (`str | None` / `string | undefined`): korreliert `PreToolUse` und `PostToolUse` Ereignisse für denselben Tool-Aufruf.

255* **Kontext:** In TypeScript enthält eine `signal` Eigenschaft (`AbortSignal`) für Abbruch. In Python ist dieses Argument für zukünftige Verwendung reserviert.255* **Kontext:** In TypeScript enthält eine `signal` Eigenschaft (`AbortSignal`) für Abbruch. In Python ist dieses Argument für zukünftige Verwendung reserviert.

256 256 

Details

189 Netzwerk189 Netzwerk

190</h3>190</h3>

191 191 

192Das SDK benötigt ausgehende HTTPS zu `api.anthropic.com` oder zu Ihrem regionalen Endpunkt des Anbieters, wenn Sie auf Bedrock oder Vertex ausführen. Wenn Ihre Agents [MCP-Server](/de/agent-sdk/mcp) oder externe Tools verwenden, benötigen sie auch ausgehenden Zugriff auf diese Endpunkte. Für die Produktion leiten Sie ausgehenden Datenverkehr durch einen Egress-Proxy, der Domain-Allowlists durchsetzt, Anmeldeinformationen injiziert und Anfragen protokolliert. Siehe [Sichere Bereitstellung](/de/agent-sdk/secure-deployment) für das vollständige Muster.192Das SDK benötigt ausgehende HTTPS zu `api.anthropic.com` oder zu Ihrem regionalen Endpunkt des Anbieters, wenn Sie auf Amazon Bedrock oder Google Cloud's Agent Platform ausführen. Wenn Ihre Agents [MCP-Server](/de/agent-sdk/mcp) oder externe Tools verwenden, benötigen sie auch ausgehenden Zugriff auf diese Endpunkte. Für die Produktion leiten Sie ausgehenden Datenverkehr durch einen Egress-Proxy, der Domain-Allowlists durchsetzt, Anmeldeinformationen injiziert und Anfragen protokolliert. Siehe [Sichere Bereitstellung](/de/agent-sdk/secure-deployment) für das vollständige Muster.

193 193 

194Für eingehenden Datenverkehr stellen Sie einen HTTP- oder WebSocket-Port auf dem Container bereit. Ihre Anwendung verarbeitet Client-Anfragen auf diesem Port und ruft das SDK intern auf; der Unterprozess selbst lauscht nicht im Netzwerk.194Für eingehenden Datenverkehr stellen Sie einen HTTP- oder WebSocket-Port auf dem Container bereit. Ihre Anwendung verarbeitet Client-Anfragen auf diesem Port und ruft das SDK intern auf; der Unterprozess selbst lauscht nicht im Netzwerk.

195 195 

Details

823 Verbindungs-Timeouts823 Verbindungs-Timeouts

824</h3>824</h3>

825 825 

826Das MCP SDK hat ein Standard-Timeout von 60 Sekunden für Serververbindungen. Wenn Ihr Server länger zum Starten benötigt, schlägt die Verbindung fehl. Für Server, die mehr Startzeit benötigen, erwägen Sie:826MCP-Serververbindungen haben standardmäßig ein Timeout von 30 Sekunden. Wenn Ihr Server länger zum Starten benötigt, schlägt die Verbindung fehl. Erhöhen Sie das Limit mit der Umgebungsvariablen [`MCP_TIMEOUT`](/de/env-vars) in Millisekunden. Für Server, die mehr Startzeit benötigen, erwägen Sie auch:

827 827 

828* Verwendung eines leichteren Servers, falls verfügbar828* Verwendung eines leichteren Servers, falls verfügbar

829* Vorwärmung des Servers vor dem Starten Ihres Agenten829* Vorwärmung des Servers vor dem Starten Ihres Agenten

Details

152 152 

153* **CLI**: Führen Sie `/config` aus und wählen Sie einen Ausgabestil153* **CLI**: Führen Sie `/config` aus und wählen Sie einen Ausgabestil

154* **Einstellungen**: Setzen Sie `outputStyle` in `.claude/settings.local.json`154* **Einstellungen**: Setzen Sie `outputStyle` in `.claude/settings.local.json`

155* **TypeScript SDK**: Setzen Sie `outputStyle` innerhalb des Inline-`settings`-Objekts, das an `query()` übergeben wird, oder verweisen Sie `settings` auf eine Einstellungsdatei, die es setzt. `outputStyle` ist kein Feld auf oberster Ebene von `Options`155* **TypeScript SDK**: Setzen Sie `outputStyle` innerhalb des Inline-`settings`-Objekts, das an `query()` übergeben wird, oder verweisen Sie `settings` auf eine Einstellungsdatei, die es setzt. `outputStyle` ist kein Feld auf oberster Ebene von `Options`:

156 

157 ```typescript theme={null}

158 const options = { settings: { outputStyle: "Explanatory" } };

159 ```

156 160 

157Das Python SDK hat keine Option, einen Ausgabestil programmgesteuert auszuwählen. Verwenden Sie für Code-only-Bereitstellungen, bei denen Sie nicht in `.claude/settings.local.json` schreiben können, stattdessen `append` oder eine benutzerdefinierte Eingabeaufforderungszeichenkette.161Das Python SDK hat keine Option, einen Ausgabestil programmgesteuert auszuwählen. Verwenden Sie für Code-only-Bereitstellungen, bei denen Sie nicht in `.claude/settings.local.json` schreiben können, stattdessen `append` oder eine benutzerdefinierte Eingabeaufforderungszeichenkette.

158 162 

Details

206 206 

207Die CLI fügt [Identitätsattribute](/de/monitoring-usage#standard-attributes) an jeden Event basierend auf der Anmeldeinformation an, die sie zum Aufrufen von Anthropic verwendet. Wenn Sie eine Anwendung erstellen, die viele Endbenutzer aus einer Bereitstellung bedient, identifizieren diese Attribute die Anmeldeinformation Ihres Service, nicht den Endbenutzer, in dessen Namen der Agent handelte.207Die CLI fügt [Identitätsattribute](/de/monitoring-usage#standard-attributes) an jeden Event basierend auf der Anmeldeinformation an, die sie zum Aufrufen von Anthropic verwendet. Wenn Sie eine Anwendung erstellen, die viele Endbenutzer aus einer Bereitstellung bedient, identifizieren diese Attribute die Anmeldeinformation Ihres Service, nicht den Endbenutzer, in dessen Namen der Agent handelte.

208 208 

209Um Tool-Aufrufe und MCP-Aktivität Ihren Anwendungs-Endbenutzern zuzuordnen, injizieren Sie die Endbenutzer-Identität als Ressourcenattribute bei jedem `query()`-Aufruf. Prozentcodieren Sie Werte, bevor Sie sie interpolieren, da `OTEL_RESOURCE_ATTRIBUTES` [Kommas, Leerzeichen und Gleichheitszeichen reserviert](/de/monitoring-usage#multi-team-organization-support). Das folgende Beispiel fügt den anfordernden Benutzer und Mandanten an jeden Span und Event aus einer Anfrage an:209Um Tool-Aufrufe und MCP-Aktivität Ihren Anwendungs-Endbenutzern zuzuordnen, injizieren Sie die Endbenutzer-Identität als Ressourcenattribute bei jedem `query()`-Aufruf. Prozentcodieren Sie Werte, bevor Sie sie interpolieren, da `OTEL_RESOURCE_ATTRIBUTES` [Kommas, Leerzeichen und Gleichheitszeichen reserviert](/de/monitoring-usage#multi-team-organization-support). Das folgende Beispiel fügt den anfordernden Benutzer und Mandanten an jeden Span und Event aus einer Anfrage an. Es setzt ein `request`-Objekt aus Ihrem Web-Framework voraus, das die Benutzer- und Mandanten-IDs trägt:

210 210 

211<CodeGroup>211<CodeGroup>

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


231 ```231 ```

232</CodeGroup>232</CodeGroup>

233 233 

234Mit Endbenutzer-Identität angeheftet, werden die `tool_decision`-, `tool_result`-, `mcp_server_connection`- und `permission_mode_changed`-Events zu einem Pro-Benutzer-Audit-Trail, den Sie an eine Security Information and Event Management (SIEM)-Plattform weiterleiten können. Siehe [Sicherheitsereignisse prüfen](/de/monitoring-usage#audit-security-events) in der Überwachungsreferenz für die vollständige Liste sicherheitsrelevanter Events und der Attribute, die jedes trägt.234Mit Endbenutzer-Identität angeheftet, werden die `tool_decision`-, `tool_result`-, `mcp_server_connection`- und `permission_mode_changed`-Events, die als Log-Datensätze mit einem `claude_code.`-Präfix exportiert werden, zu einem Pro-Benutzer-Audit-Trail, den Sie an eine Security Information and Event Management (SIEM)-Plattform weiterleiten können. Siehe [Sicherheitsereignisse prüfen](/de/monitoring-usage#audit-security-events) in der Überwachungsreferenz für die vollständige Liste sicherheitsrelevanter Events und der Attribute, die jedes trägt.

235 235 

236<h2 id="control-sensitive-data-in-exports">236<h2 id="control-sensitive-data-in-exports">

237 Kontrollieren Sie sensible Daten in Exporten237 Kontrollieren Sie sensible Daten in Exporten

Details

87 87 

88 * **Amazon Bedrock**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_BEDROCK=1` und konfigurieren Sie AWS-Anmeldedaten88 * **Amazon Bedrock**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_BEDROCK=1` und konfigurieren Sie AWS-Anmeldedaten

89 * **Claude Platform on AWS**: Setzen Sie `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` und `ANTHROPIC_AWS_WORKSPACE_ID` und konfigurieren Sie AWS-Anmeldedaten89 * **Claude Platform on AWS**: Setzen Sie `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` und `ANTHROPIC_AWS_WORKSPACE_ID` und konfigurieren Sie AWS-Anmeldedaten

90 * **Google Vertex AI**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_VERTEX=1` und konfigurieren Sie Google Cloud-Anmeldedaten90 * **Google Cloud's Agent Platform**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_VERTEX=1` und konfigurieren Sie Google Cloud-Anmeldedaten

91 * **Microsoft Azure**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_FOUNDRY=1` und konfigurieren Sie Azure-Anmeldedaten91 * **Microsoft Azure**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_FOUNDRY=1` und konfigurieren Sie Azure-Anmeldedaten

92 92 

93 Weitere Informationen finden Sie in den Einrichtungsleitfäden für [Bedrock](/de/amazon-bedrock), [Claude Platform on AWS](/de/claude-platform-on-aws), [Vertex AI](/de/google-vertex-ai) oder [Azure AI Foundry](/de/microsoft-foundry).93 Weitere Informationen finden Sie in den Einrichtungsleitfäden für [Amazon Bedrock](/de/amazon-bedrock), [Claude Platform on AWS](/de/claude-platform-on-aws), [Google Cloud's Agent Platform](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry).

94 94 

95 <Note>95 <Note>

96 Sofern nicht zuvor genehmigt, erlaubt Anthropic Drittentwicklern nicht, claude.ai-Anmeldungen oder Ratenlimits für ihre Produkte anzubieten, einschließlich Agenten, die auf dem Claude Agent SDK basieren. Verwenden Sie stattdessen die in diesem Dokument beschriebenen API-Schlüssel-Authentifizierungsmethoden.96 Sofern nicht zuvor genehmigt, erlaubt Anthropic Drittentwicklern nicht, claude.ai-Anmeldungen oder Ratenlimits für ihre Produkte anzubieten, einschließlich Agenten, die auf dem Claude Agent SDK basieren. Verwenden Sie stattdessen die in diesem Dokument beschriebenen API-Schlüssel-Authentifizierungsmethoden.

Details

109Das SDK unterstützt diese Berechtigungsmodi:109Das SDK unterstützt diese Berechtigungsmodi:

110 110 

111| Modus | Beschreibung | Tool-Verhalten |111| Modus | Beschreibung | Tool-Verhalten |

112| :---------------------- | :----------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |112| :------------------ | :----------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

113| `default` | Standardberechtigungsverhalten | Keine automatischen Genehmigungen; nicht übereinstimmende Tools lösen Ihren `canUseTool`-Callback aus |113| `default` | Standardberechtigungsverhalten | Keine automatischen Genehmigungen; nicht übereinstimmende Tools lösen Ihren `canUseTool`-Callback aus |

114| `dontAsk` | Ablehnung statt Nachfrage | Alles, das nicht von `allowed_tools` oder Regeln vorab genehmigt ist, wird abgelehnt; `canUseTool` wird nie aufgerufen |114| `dontAsk` | Ablehnung statt Nachfrage | Alles, das nicht von `allowed_tools` oder Regeln vorab genehmigt ist, wird abgelehnt; `canUseTool` wird nie aufgerufen |

115| `acceptEdits` | Dateibearbeitungen automatisch akzeptieren | Dateibearbeitungen und [Dateisystemvorgänge](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv` usw.) werden automatisch genehmigt |115| `acceptEdits` | Dateibearbeitungen automatisch akzeptieren | Dateibearbeitungen und [Dateisystemvorgänge](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv` usw.) werden automatisch genehmigt |

116| `bypassPermissions` | Alle Berechtigungsprüfungen umgehen | Tools werden ohne Berechtigungsaufforderungen ausgeführt, es sei denn, eine explizite [`ask`-Regel](#how-permissions-are-evaluated) stimmt überein (mit Vorsicht verwenden) |116| `bypassPermissions` | Alle Berechtigungsprüfungen umgehen | Tools werden ohne Berechtigungsaufforderungen ausgeführt, es sei denn, eine explizite [`ask`-Regel](#how-permissions-are-evaluated) stimmt überein (mit Vorsicht verwenden) |

117| `plan` | Planungsmodus | Claude erkundet und plant, ohne Ihre Quelldateien zu bearbeiten; Dateibearbeitungen werden nie automatisch genehmigt und werden durch Ihren `canUseTool`-Callback angefordert |117| `plan` | Planungsmodus | Claude erkundet und plant, ohne Ihre Quelldateien zu bearbeiten; Dateibearbeitungen werden nie automatisch genehmigt und werden durch Ihren `canUseTool`-Callback angefordert |

118| `auto` (nur TypeScript) | Modellklassifizierte Genehmigungen | Ein Modellklassifizierer genehmigt oder lehnt jeden Tool-Aufruf ab. Siehe [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) für Verfügbarkeit |118| `auto` | Modellklassifizierte Genehmigungen | Ein Modellklassifizierer genehmigt oder lehnt jeden Tool-Aufruf ab. Siehe [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) für Verfügbarkeit |

119 119 

120<Warning>120<Warning>

121 **Subagent-Vererbung:** Wenn der übergeordnete Agent `bypassPermissions`, `acceptEdits` oder `auto` verwendet, erben alle Subagents diesen Modus und er kann nicht pro Subagent überschrieben werden. Subagents können unterschiedliche Systemaufforderungen und weniger eingeschränktes Verhalten als Ihr Hauptagent haben, daher erbt `bypassPermissions` ihnen vollständigen, autonomen Systemzugriff. Eine explizite [`ask`-Regel](#how-permissions-are-evaluated) erzwingt weiterhin eine Aufforderung.121 **Subagent-Vererbung:** Wenn der übergeordnete Agent `bypassPermissions`, `acceptEdits` oder `auto` verwendet, erben alle Subagents diesen Modus und er kann nicht pro Subagent überschrieben werden. Subagents können unterschiedliche Systemaufforderungen und weniger eingeschränktes Verhalten als Ihr Hauptagent haben, daher erbt `bypassPermissions` ihnen vollständigen, autonomen Systemzugriff. Eine explizite [`ask`-Regel](#how-permissions-are-evaluated) erzwingt weiterhin eine Aufforderung.

Details

854class ClaudeAgentOptions:854class ClaudeAgentOptions:

855 tools: list[str] | ToolsPreset | None = None855 tools: list[str] | ToolsPreset | None = None

856 allowed_tools: list[str] = field(default_factory=list)856 allowed_tools: list[str] = field(default_factory=list)

857 system_prompt: str | SystemPromptPreset | None = None857 system_prompt: str | SystemPromptPreset | SystemPromptFile | None = None

858 mcp_servers: dict[str, McpServerConfig] | str | Path = field(default_factory=dict)858 mcp_servers: dict[str, McpServerConfig] | str | Path = field(default_factory=dict)

859 strict_mcp_config: bool = False859 strict_mcp_config: bool = False

860 permission_mode: PermissionMode | None = None860 permission_mode: PermissionMode | None = None


900| :---------------------------- | :------------------------------------------------------------------------------------ | :---------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |900| :---------------------------- | :------------------------------------------------------------------------------------ | :---------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

901| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Tools-Konfiguration. Verwenden Sie `{"type": "preset", "preset": "claude_code"}` für die Standard-Tools von Claude Code |901| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Tools-Konfiguration. Verwenden Sie `{"type": "preset", "preset": "claude_code"}` für die Standard-Tools von Claude Code |

902| `allowed_tools` | `list[str]` | `[]` | Tools, die automatisch genehmigt werden, ohne zu fragen. Dies beschränkt Claude nicht nur auf diese Tools; nicht aufgelistete Tools fallen durch `permission_mode` und `can_use_tool`. Verwenden Sie `disallowed_tools`, um Tools zu blockieren. Siehe [Berechtigungen](/de/agent-sdk/permissions#allow-and-deny-rules) |902| `allowed_tools` | `list[str]` | `[]` | Tools, die automatisch genehmigt werden, ohne zu fragen. Dies beschränkt Claude nicht nur auf diese Tools; nicht aufgelistete Tools fallen durch `permission_mode` und `can_use_tool`. Verwenden Sie `disallowed_tools`, um Tools zu blockieren. Siehe [Berechtigungen](/de/agent-sdk/permissions#allow-and-deny-rules) |

903| `system_prompt` | `str \| SystemPromptPreset \| None` | `None` | System-Prompt-Konfiguration. Übergeben Sie eine Zeichenkette für einen benutzerdefinierten Prompt, oder verwenden Sie `{"type": "preset", "preset": "claude_code"}` für den System-Prompt von Claude Code. Fügen Sie `"append"` hinzu, um den Preset zu erweitern |903| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptFile \| None` | `None` | System-Prompt-Konfiguration. Übergeben Sie eine Zeichenkette für einen benutzerdefinierten Prompt, `{"type": "preset", "preset": "claude_code"}` für den System-Prompt von Claude Code mit optionalem `"append"`, oder `{"type": "file", "path": "..."}` zum Laden eines großen Prompts von der Festplatte. Siehe [`SystemPromptPreset`](#systempromptpreset) und [`SystemPromptFile`](#systempromptfile) |

904| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | MCP-Server-Konfigurationen oder Pfad zur Konfigurationsdatei |904| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | MCP-Server-Konfigurationen oder Pfad zur Konfigurationsdatei |

905| `strict_mcp_config` | `bool` | `False` | Wenn `True`, verwenden Sie nur die Server, die in `mcp_servers` übergeben werden, und ignorieren Sie das Projekt `.mcp.json`, Benutzereinstellungen, von Plugins bereitgestellte MCP-Server und [claude.ai-Konnektoren](/de/mcp#use-mcp-servers-from-claude-ai). Entspricht dem CLI-Flag `--strict-mcp-config` |905| `strict_mcp_config` | `bool` | `False` | Wenn `True`, verwenden Sie nur die Server, die in `mcp_servers` übergeben werden, und ignorieren Sie das Projekt `.mcp.json`, Benutzereinstellungen, von Plugins bereitgestellte MCP-Server und [claude.ai-Konnektoren](/de/mcp#use-mcp-servers-from-claude-ai). Entspricht dem CLI-Flag `--strict-mcp-config` |

906| `permission_mode` | `PermissionMode \| None` | `None` | Berechtigungsmodus für die Tool-Nutzung |906| `permission_mode` | `PermissionMode \| None` | `None` | Berechtigungsmodus für die Tool-Nutzung |


1002| `append` | Nein | Zusätzliche Anweisungen, die an den Preset-System-Prompt angehängt werden |1002| `append` | Nein | Zusätzliche Anweisungen, die an den Preset-System-Prompt angehängt werden |

1003| `exclude_dynamic_sections` | Nein | Verschieben Sie sitzungsspezifischen Kontext wie Arbeitsverzeichnis, Git-Status und Memory-Pfade aus dem System-Prompt in die erste Benutzernachricht. Verbessert die Prompt-Cache-Wiederverwendung über Benutzer und Maschinen hinweg. Siehe [System-Prompts ändern](/de/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |1003| `exclude_dynamic_sections` | Nein | Verschieben Sie sitzungsspezifischen Kontext wie Arbeitsverzeichnis, Git-Status und Memory-Pfade aus dem System-Prompt in die erste Benutzernachricht. Verbessert die Prompt-Cache-Wiederverwendung über Benutzer und Maschinen hinweg. Siehe [System-Prompts ändern](/de/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

1004 1004 

1005<h3 id="systempromptfile">

1006 `SystemPromptFile`

1007</h3>

1008 

1009Konfiguration zum Laden eines benutzerdefinierten System-Prompts aus einer Datei, anstatt ihn als Zeichenkette zu übergeben. Das SDK ordnet dies dem CLI-Flag [`--system-prompt-file`](/de/cli-reference#system-prompt-flags) zu. Verwenden Sie die Dateiform, wenn der Prompt groß ist: Das SDK übergibt einen Zeichenketten-`system_prompt` auf der CLI-Subprozess-argv, die OS-Befehlszeilenlängenbeschränkungen unterliegt, bevor das SDK eine API-Anfrage sendet. Auf Linux schlägt ein einzelnes Argument, das länger als ungefähr 128 KB ist, beim Prozessstart mit `Argument list too long` fehl. Unter Windows ist die gesamte Befehlszeile auf ungefähr 32 KB begrenzt, daher schlägt die Zeichenkettenform bei einem niedrigeren Schwellenwert fehl.

1010 

1011```python theme={null}

1012class SystemPromptFile(TypedDict):

1013 type: Literal["file"]

1014 path: str

1015```

1016 

1017| Feld | Erforderlich | Beschreibung |

1018| :----- | :----------- | :------------------------------------------------------------ |

1019| `type` | Ja | Muss `"file"` sein, um den Prompt von der Festplatte zu laden |

1020| `path` | Ja | Pfad zu einer Datei, die den System-Prompt enthält |

1021 

1005<h3 id="settingsource">1022<h3 id="settingsource">

1006 `SettingSource`1023 `SettingSource`

1007</h3>1024</h3>


1192 "plan", # Planning mode - explore without editing1209 "plan", # Planning mode - explore without editing

1193 "dontAsk", # Deny anything not pre-approved instead of prompting1210 "dontAsk", # Deny anything not pre-approved instead of prompting

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

1212 "auto", # A model classifier approves or denies each tool call

1195]1213]

1196```1214```

1197 1215 


1434Verwenden Sie mit dem Feld `betas` in `ClaudeAgentOptions`, um Beta-Funktionen zu aktivieren.1452Verwenden Sie mit dem Feld `betas` in `ClaudeAgentOptions`, um Beta-Funktionen zu aktivieren.

1435 1453 

1436<Warning>1454<Warning>

1437 Die `context-1m-2025-08-07`-Beta ist seit dem 30. April 2026 veraltet. Das Übergeben dieses Headers mit Claude Sonnet 4.5 oder Sonnet 4 hat keine Auswirkung, und Anfragen, die das Standard-200k-Token-Kontextfenster überschreiten, geben einen Fehler zurück. Um ein 1M-Token-Kontextfenster zu verwenden, migrieren Sie zu [Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7 oder Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), die 1M-Kontext zu Standardpreisen ohne Beta-Header enthalten.1455 Die `context-1m-2025-08-07`-Beta ist seit dem 30. April 2026 veraltet. Das Übergeben dieses Headers mit Claude Sonnet 4.5 oder Sonnet 4 hat keine Auswirkung, und Anfragen, die das Standard-200k-Token-Kontextfenster überschreiten, geben einen Fehler zurück. Um ein 1M-Token-Kontextfenster zu verwenden, migrieren Sie zu [Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7 oder Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), die 1M-Kontext zu Standardpreisen ohne Beta-Header enthalten.

1438</Warning>1456</Warning>

1439 1457 

1440<h3 id="mcpsdkserverconfig">1458<h3 id="mcpsdkserverconfig">


1755```1773```

1756 1774 

1757| Feld | Typ | Beschreibung |1775| Feld | Typ | Beschreibung |

1758| :------------------- | :--------------- | :-------------------------------------------------------------------------- |1776| :------------------- | :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1759| `uuid` | `str` | Eindeutige Kennung für dieses Ereignis |1777| `uuid` | `str` | Eindeutige Kennung für dieses Ereignis |

1760| `session_id` | `str` | Sitzungskennung |1778| `session_id` | `str` | Sitzungskennung |

1761| `event` | `dict[str, Any]` | Die rohen Claude API-Stream-Ereignisdaten |1779| `event` | `dict[str, Any]` | Die rohen Claude API-Stream-Ereignisdaten |

1762| `parent_tool_use_id` | `str \| None` | Übergeordnete Tool-Use-ID, wenn dieses Ereignis von einem Subagenten stammt |1780| `parent_tool_use_id` | `str \| None` | Immer `None`. Stream-Ereignisse werden nur für die Hauptsitzung ausgegeben. Für die Zuordnung von Subagenten verwenden Sie vollständige Nachrichten wie [`AssistantMessage`](#assistantmessage) |

1763 1781 

1764<h3 id="ratelimitevent">1782<h3 id="ratelimitevent">

1765 `RateLimitEvent`1783 `RateLimitEvent`


2393 tool_name: str2411 tool_name: str

2394 tool_input: dict[str, Any]2412 tool_input: dict[str, Any]

2395 permission_suggestions: NotRequired[list[Any]]2413 permission_suggestions: NotRequired[list[Any]]

2414 agent_id: NotRequired[str]

2415 agent_type: NotRequired[str]

2396```2416```

2397 2417 

2398| Feld | Typ | Beschreibung |2418| Feld | Typ | Beschreibung |

2399| :----------------------- | :----------------------------- | :------------------------------------------------------- |2419| :----------------------- | :----------------------------- | :------------------------------------------------------------------------------------- |

2400| `hook_event_name` | `Literal["PermissionRequest"]` | Immer "PermissionRequest" |2420| `hook_event_name` | `Literal["PermissionRequest"]` | Immer "PermissionRequest" |

2401| `tool_name` | `str` | Name des Tools, das Berechtigung anfordert |2421| `tool_name` | `str` | Name des Tools, das Berechtigung anfordert |

2402| `tool_input` | `dict[str, Any]` | Eingabeparameter für das Tool |2422| `tool_input` | `dict[str, Any]` | Eingabeparameter für das Tool |

2403| `permission_suggestions` | `list[Any]` (optional) | Vorgeschlagene Berechtigungsaktualisierungen von der CLI |2423| `permission_suggestions` | `list[Any]` (optional) | Vorgeschlagene Berechtigungsaktualisierungen von der CLI |

2424| `agent_id` | `str` (optional) | Subagenten-Kennung, vorhanden, wenn der Hook innerhalb eines Subagenten ausgelöst wird |

2425| `agent_type` | `str` (optional) | Subagenten-Typ, vorhanden, wenn der Hook innerhalb eines Subagenten ausgelöst wird |

2404 2426 

2405<h3 id="hookjsonoutput">2427<h3 id="hookjsonoutput">

2406 `HookJSONOutput`2428 `HookJSONOutput`

Details

121 121 

122 * **Amazon Bedrock**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_BEDROCK=1` und konfigurieren Sie AWS-Anmeldedaten122 * **Amazon Bedrock**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_BEDROCK=1` und konfigurieren Sie AWS-Anmeldedaten

123 * **Claude Platform on AWS**: Setzen Sie `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` und `ANTHROPIC_AWS_WORKSPACE_ID` und konfigurieren Sie AWS-Anmeldedaten123 * **Claude Platform on AWS**: Setzen Sie `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` und `ANTHROPIC_AWS_WORKSPACE_ID` und konfigurieren Sie AWS-Anmeldedaten

124 * **Google Vertex AI**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_VERTEX=1` und konfigurieren Sie Google Cloud-Anmeldedaten124 * **Google Cloud's Agent Platform**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_VERTEX=1` und konfigurieren Sie Google Cloud-Anmeldedaten

125 * **Microsoft Azure**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_FOUNDRY=1` und konfigurieren Sie Azure-Anmeldedaten125 * **Microsoft Azure**: Setzen Sie die Umgebungsvariable `CLAUDE_CODE_USE_FOUNDRY=1` und konfigurieren Sie Azure-Anmeldedaten

126 126 

127 Weitere Informationen finden Sie in den Einrichtungsleitfäden für [Bedrock](/de/amazon-bedrock), [Claude Platform on AWS](/de/claude-platform-on-aws), [Vertex AI](/de/google-vertex-ai) oder [Azure AI Foundry](/de/microsoft-foundry).127 Weitere Informationen finden Sie in den Einrichtungsleitfäden für [Amazon Bedrock](/de/amazon-bedrock), [Claude Platform on AWS](/de/claude-platform-on-aws), [Google Cloud's Agent Platform](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry).

128 128 

129 <Note>129 <Note>

130 Sofern nicht zuvor genehmigt, erlaubt Anthropic Drittentwicklern nicht, claude.ai-Anmeldungen oder Ratenlimits für ihre Produkte anzubieten, einschließlich Agenten, die auf dem Claude Agent SDK basieren. Verwenden Sie stattdessen die in diesem Dokument beschriebenen API-Schlüssel-Authentifizierungsmethoden.130 Sofern nicht zuvor genehmigt, erlaubt Anthropic Drittentwicklern nicht, claude.ai-Anmeldungen oder Ratenlimits für ihre Produkte anzubieten, einschließlich Agenten, die auf dem Claude Agent SDK basieren. Verwenden Sie stattdessen die in diesem Dokument beschriebenen API-Schlüssel-Authentifizierungsmethoden.


368**Genehmigungsmodi** steuern, wie viel menschliche Aufsicht Sie möchten:368**Genehmigungsmodi** steuern, wie viel menschliche Aufsicht Sie möchten:

369 369 

370| Modus | Verhalten | Anwendungsfall |370| Modus | Verhalten | Anwendungsfall |

371| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ |371| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ |

372| `acceptEdits` | Genehmigt Dateibearbeitungen und häufige Dateisystembefehle automatisch, fragt nach anderen Aktionen | Vertrauenswürdige Entwicklungs-Workflows |372| `acceptEdits` | Genehmigt Dateibearbeitungen und häufige Dateisystembefehle automatisch, fragt nach anderen Aktionen | Vertrauenswürdige Entwicklungs-Workflows |

373| `plan` | Führt schreibgeschützte Tools aus; Dateibearbeitungen werden nie automatisch genehmigt und erreichen Ihren `canUseTool`-Callback | Aufgabenumfang vor Genehmigung der Ausführung |373| `plan` | Führt schreibgeschützte Tools aus; Dateibearbeitungen werden nie automatisch genehmigt und erreichen Ihren `canUseTool`-Callback | Aufgabenumfang vor Genehmigung der Ausführung |

374| `dontAsk` | Lehnt alles ab, das nicht in `allowedTools` enthalten ist | Gesperrte Headless-Agenten |374| `dontAsk` | Lehnt alles ab, das nicht in `allowedTools` enthalten ist | Gesperrte Headless-Agenten |

375| `auto` (nur TypeScript) | Ein Modell-Klassifizierer genehmigt oder lehnt jeden Tool-Aufruf ab | Autonome Agenten mit Sicherheitsvorkehrungen |375| `auto` | Ein Modell-Klassifizierer genehmigt oder lehnt jeden Tool-Aufruf ab | Autonome Agenten mit Sicherheitsvorkehrungen |

376| `bypassPermissions` | Führt jedes Tool ohne Eingabeaufforderungen aus, es sei denn, eine explizite [`ask`-Regel](/de/agent-sdk/permissions#how-permissions-are-evaluated) stimmt überein | Sandboxed CI, vollständig vertrauenswürdige Umgebungen |376| `bypassPermissions` | Führt jedes Tool ohne Eingabeaufforderungen aus, es sei denn, eine explizite [`ask`-Regel](/de/agent-sdk/permissions#how-permissions-are-evaluated) stimmt überein | Sandboxed CI, vollständig vertrauenswürdige Umgebungen |

377| `default` | Erfordert einen `canUseTool`-Callback zur Genehmigungsbehandlung | Benutzerdefinierte Genehmigungsabläufe |377| `default` | Erfordert einen `canUseTool`-Callback zur Genehmigungsbehandlung | Benutzerdefinierte Genehmigungsabläufe |

378 378 

Details

91 uuid: str # Unique identifier for this event91 uuid: str # Unique identifier for this event

92 session_id: str # Session identifier92 session_id: str # Session identifier

93 event: dict[str, Any] # The raw Claude API stream event93 event: dict[str, Any] # The raw Claude API stream event

94 parent_tool_use_id: str | None # Parent tool ID if from a subagent94 parent_tool_use_id: str | None # Always None

95 ```95 ```

96 96 

97 ```typescript TypeScript theme={null}97 ```typescript TypeScript theme={null}


106 ```106 ```

107</CodeGroup>107</CodeGroup>

108 108 

109Das Feld `parent_tool_use_id` ist in Python immer `None` und in TypeScript immer `null`. Streaming-Ereignisse werden nur für die Hauptsitzung ausgegeben; Token-Level-Deltas von Subagenten werden nicht weitergeleitet. Um die Ausgabe einem Subagenten zuzuordnen, verwenden Sie vollständige Nachrichten, die `parent_tool_use_id` enthalten. Siehe [Subagenten-Aufruf erkennen](/de/agent-sdk/subagents#detect-subagent-invocation).

110 

109Das Feld `event` enthält das rohe Streaming-Ereignis aus der [Claude API](https://platform.claude.com/docs/en/build-with-claude/streaming#event-types). Häufige Ereignistypen sind:111Das Feld `event` enthält das rohe Streaming-Ereignis aus der [Claude API](https://platform.claude.com/docs/en/build-with-claude/streaming#event-types). Häufige Ereignistypen sind:

110 112 

111| Ereignistyp | Beschreibung |113| Ereignistyp | Beschreibung |

Details

247 247 

248Das SDK unterstützt Standard-JSON-Schema-Funktionen, einschließlich aller grundlegenden Typen (object, array, string, number, boolean, null), `enum`, `const`, `required`, verschachtelte Objekte und `$ref`-Definitionen. Die vollständige Liste der unterstützten Funktionen und Einschränkungen finden Sie unter [JSON Schema-Einschränkungen](https://platform.claude.com/docs/de/build-with-claude/structured-outputs#json-schema-limitations).248Das SDK unterstützt Standard-JSON-Schema-Funktionen, einschließlich aller grundlegenden Typen (object, array, string, number, boolean, null), `enum`, `const`, `required`, verschachtelte Objekte und `$ref`-Definitionen. Die vollständige Liste der unterstützten Funktionen und Einschränkungen finden Sie unter [JSON Schema-Einschränkungen](https://platform.claude.com/docs/de/build-with-claude/structured-outputs#json-schema-limitations).

249 249 

250Ein Schema, das kein gültiges JSON Schema ist, führt beim Start zu einem Fehler, der das Problem benennt. Vor v2.1.205 wurde ein ungültiges Schema stillschweigend ignoriert und der Agent gab unstrukturierten Text zurück.

251 

252Das Schlüsselwort `format`, wie z. B. `"format": "email"`, wird als Anmerkung akzeptiert und wird vom Validator des SDK nicht erzwungen. Vor v2.1.205 wurde jedes Schema, das `format` enthielt, als ungültig behandelt.

253 

250<h2 id="example-todo-tracking-agent">254<h2 id="example-todo-tracking-agent">

251 Beispiel: TODO-Tracking-Agent255 Beispiel: TODO-Tracking-Agent

252</h2>256</h2>

Details

234 Der übergeordnete Agent erhält die abschließende Nachricht des Subagenten wörtlich als Agent-Tool-Ergebnis, kann sie aber in seiner eigenen Antwort zusammenfassen. Um die Ausgabe des Subagenten wörtlich in der benutzerorientierten Antwort zu bewahren, fügen Sie eine Anweisung dazu in den Prompt oder die `systemPrompt`-Option ein, die Sie an den Haupt-`query()`-Aufruf übergeben.234 Der übergeordnete Agent erhält die abschließende Nachricht des Subagenten wörtlich als Agent-Tool-Ergebnis, kann sie aber in seiner eigenen Antwort zusammenfassen. Um die Ausgabe des Subagenten wörtlich in der benutzerorientierten Antwort zu bewahren, fügen Sie eine Anweisung dazu in den Prompt oder die `systemPrompt`-Option ein, die Sie an den Haupt-`query()`-Aufruf übergeben.

235</Note>235</Note>

236 236 

237{/* min-version: 2.1.199 */}Ab Claude Code v2.1.199 wird ein API-Fehler, der den Subagenten vorzeitig beendet, wie z. B. ein Ratenlimit, niemals als sein Ergebnis bereitgestellt. Wenn der Subagent bereits Ausgabe produziert hat, gibt das Agent-Tool diese Teilausgabe mit einem Hinweis zurück, dass der Subagent nicht fertig wurde; andernfalls ist das Tool-Ergebnis eine Fehlermeldung, `Agent terminated early due to an API error`, gefolgt von der Fehlerdetail. Siehe [API-Fehler in Subagenten](/de/sub-agents#api-errors-in-subagents) für das Vordergrund- und Hintergrundverhalten.237{/* min-version: 2.1.199 */}Ein API-Fehler, der den Subagenten vorzeitig beendet, wie z. B. ein Ratenlimit, wird niemals als sein Ergebnis bereitgestellt. Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Vordergrund-Subagenten unterbricht, der bereits Textausgabe produziert hat, gibt das Agent-Tool diese Teilausgabe mit einem Hinweis zurück, dass der Subagent nicht fertig wurde. {/* min-version: 2.1.200 */}Ein Subagent, der nichts produziert hat oder dessen einzige Ausgabe Tool-Aufrufe ohne Text waren, schlägt mit einer Fehlermeldung fehl, `Agent terminated early due to an API error`, gefolgt von der Fehlerdetail. Siehe [API-Fehler in Subagenten](/de/sub-agents#api-errors-in-subagents) für das Vordergrund- und Hintergrundverhalten.

238 

239Diese Teilausgabe-Behandlung erfordert Claude Code v2.1.199 oder später. In v2.1.199 hinterließ ein Ratenlimit, eine Überlastung oder ein Serverfehler die Form „nur Tool-Aufrufe" mit einem leeren Teilergebnis, das nur den Abbruchhinweis enthielt.

238 240 

239<h2 id="invoke-subagents">241<h2 id="invoke-subagents">

240 Aufrufen von Subagenten242 Aufrufen von Subagenten

Details

296</h4>296</h4>

297 297 

298| Eigenschaft | Typ | Beschreibung |298| Eigenschaft | Typ | Beschreibung |

299| :------------------- | :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- |299| :------------------- | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

300| `type` | `"user" \| "assistant"` | Nachrichtenrolle |300| `type` | `"user" \| "assistant"` | Nachrichtenrolle |

301| `uuid` | `string` | Eindeutige Nachrichten-ID |301| `uuid` | `string` | Eindeutige Nachrichten-ID |

302| `session_id` | `string` | Sitzung, zu der diese Nachricht gehört |302| `session_id` | `string` | Sitzung, zu der diese Nachricht gehört |

303| `message` | `unknown` | Rohe Nachricht-Payload aus dem Transkript |303| `message` | `unknown` | Rohe Nachricht-Payload aus dem Transkript |

304| `parent_tool_use_id` | `string \| null` | Für Subagent-Nachrichten die `tool_use_id` des spawning `Agent`-Tool-Aufrufs. `null` für Hauptsitzungs-Nachrichten und ältere Sitzungen |304| `parent_tool_use_id` | `string \| null` | Für Subagent-Nachrichten die `tool_use_id` des spawning `Agent`-Tool-Aufrufs. `null` für Hauptsitzungs-Nachrichten und ältere Sitzungen |

305| `parent_agent_id` | `string \| null` | Für Nachrichten von einem [verschachtelten Subagent](/de/sub-agents#spawn-nested-subagents) die `agentId` des Subagents, der sie spawnt hat. `null` für Hauptsitzungs-Nachrichten, Nachrichten von Top-Level-Subagents und ältere Sitzungen. {/* min-version: 2.1.202 */}Erfordert Claude Code v2.1.202 oder später |

305 306 

306<h4 id="example-2">307<h4 id="example-2">

307 Beispiel308 Beispiel


563 564 

564```typescript theme={null}565```typescript theme={null}

565interface Query extends AsyncGenerator<SDKMessage, void> {566interface Query extends AsyncGenerator<SDKMessage, void> {

566 interrupt(): Promise<void>;567 interrupt(): Promise<SDKControlInterruptResponse | undefined>;

567 rewindFiles(568 rewindFiles(

568 userMessageId: string,569 userMessageId: string,

569 options?: { dryRun?: boolean }570 options?: { dryRun?: boolean }


594 595 

595| Methode | Beschreibung |596| Methode | Beschreibung |

596| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |597| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

597| `interrupt()` | Unterbricht die Abfrage (nur im Streaming-Eingabemodus verfügbar) |598| `interrupt()` | Unterbricht die Abfrage. Nur im Streaming-Eingabemodus verfügbar. {/* min-version: 2.1.205 */}Wenn die CLI die `interrupt_receipt_v1`-Funktion in [`SDKSystemMessage.capabilities`](#sdksystemmessage) ankündigt, wird mit einem [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) aufgelöst, das die in der Warteschlange befindlichen Nachrichten auflistet, die den Interrupt überstehen. Wird auf CLIs vor v2.1.205 mit `undefined` aufgelöst |

598| `rewindFiles(userMessageId, options?)` | Stellt Dateien in ihren Zustand bei der angegebenen Benutzer-Nachricht wieder her. Übergeben Sie `{ dryRun: true }`, um Änderungen in der Vorschau anzuzeigen. Erfordert `enableFileCheckpointing: true`. Siehe [Datei-Checkpointing](/de/agent-sdk/file-checkpointing) |599| `rewindFiles(userMessageId, options?)` | Stellt Dateien in ihren Zustand bei der angegebenen Benutzer-Nachricht wieder her. Übergeben Sie `{ dryRun: true }`, um Änderungen in der Vorschau anzuzeigen. Erfordert `enableFileCheckpointing: true`. Siehe [Datei-Checkpointing](/de/agent-sdk/file-checkpointing) |

599| `setPermissionMode()` | Ändert den Berechtigungsmodus (nur im Streaming-Eingabemodus verfügbar) |600| `setPermissionMode()` | Ändert den Berechtigungsmodus (nur im Streaming-Eingabemodus verfügbar) |

600| `setModel()` | Ändert das Modell (nur im Streaming-Eingabemodus verfügbar) |601| `setModel()` | Ändert das Modell (nur im Streaming-Eingabemodus verfügbar) |


625* **Angewendet beim nächsten Turn**: `model`, `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `awaySummaryEnabled`, `agent`. Das Wechseln von `agent` wendet auch die Modellüberschreibung, Hooks und das System-Prompt dieses Agenten beim nächsten Turn an.626* **Angewendet beim nächsten Turn**: `model`, `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `awaySummaryEnabled`, `agent`. Das Wechseln von `agent` wendet auch die Modellüberschreibung, Hooks und das System-Prompt dieses Agenten beim nächsten Turn an.

626* **Keine Auswirkung mitten in der Sitzung**: die Systemeingabeaufforderungsoptionen. Diese werden einmal beim Start aufgelöst, sodass die laufende Sitzung den ursprünglichen Wert behält, obwohl der Aufruf erfolgreich ist. Um sie zu ändern, starten Sie eine neue Sitzung.627* **Keine Auswirkung mitten in der Sitzung**: die Systemeingabeaufforderungsoptionen. Diese werden einmal beim Start aufgelöst, sodass die laufende Sitzung den ursprünglichen Wert behält, obwohl der Aufruf erfolgreich ist. Um sie zu ändern, starten Sie eine neue Sitzung.

627 628 

629`effortLevel` akzeptiert einen [Aufwandsstufen](/de/model-config#adjust-effort-level)-Namen. Es akzeptiert auch `"ultracode"`, das die Sitzung mit `xhigh`-Aufwand ausführt und [ultracode](/de/workflows#let-claude-decide-with-ultracode) aktiviert. Der `Settings`-Typ deklariert `effortLevel` ohne diesen Wert, daher übergeben Sie das Äquivalent `{ ultracode: true }` in TypeScript. {/* min-version: 2.1.203 */}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.

630 

628Die Werte werden in die Flag-Einstellungsebene geschrieben, die gleiche Ebene, die die Inline-`settings`-Option von `query()` beim Start füllt. Flag-Einstellungen befinden sich in der Nähe der Oberseite der [Einstellungspriorität](/de/settings#settings-precedence): Sie überschreiben Benutzer-, Projekt- und lokale Einstellungen, und nur verwaltete Richtlinieneinstellungen können sie überschreiben. Dies ist die gleiche Ebene, die der [Abschnitt zur Priorität auf der Seite](#settings-precedence) programmatische Optionen nennt.631Die Werte werden in die Flag-Einstellungsebene geschrieben, die gleiche Ebene, die die Inline-`settings`-Option von `query()` beim Start füllt. Flag-Einstellungen befinden sich in der Nähe der Oberseite der [Einstellungspriorität](/de/settings#settings-precedence): Sie überschreiben Benutzer-, Projekt- und lokale Einstellungen, und nur verwaltete Richtlinieneinstellungen können sie überschreiben. Dies ist die gleiche Ebene, die der [Abschnitt zur Priorität auf der Seite](#settings-precedence) programmatische Optionen nennt.

629 632 

630Aufeinanderfolgende Aufrufe führen Top-Level-Schlüssel flach zusammen. Ein zweiter Aufruf mit `{ permissions: {...} }` ersetzt das gesamte `permissions`-Objekt aus dem vorherigen Aufruf, anstatt es tief zusammenzuführen. Um einen Schlüssel aus der Flag-Ebene zu löschen und auf niedrigere Prioritätsquellen zurückzugreifen, übergeben Sie `null` für diesen Schlüssel. Das Übergeben von `undefined` hat keine Auswirkung, da die JSON-Serialisierung es löscht.633Aufeinanderfolgende Aufrufe führen Top-Level-Schlüssel flach zusammen. Ein zweiter Aufruf mit `{ permissions: {...} }` ersetzt das gesamte `permissions`-Objekt aus dem vorherigen Aufruf, anstatt es tief zusammenzuführen. Um einen Schlüssel aus der Flag-Ebene zu löschen und auf niedrigere Prioritätsquellen zurückzugreifen, übergeben Sie `null` für diesen Schlüssel. Das Übergeben von `undefined` hat keine Auswirkung, da die JSON-Serialisierung es löscht.


693 696 

694Dies sind Anfragen, die vor der Verbindung des Clients gestellt wurden und noch auf eine Antwort warten. Das SDK liest das Array für Sie und versendet jeden Eintrag an Ihren [`canUseTool`](#canusetool)-Callback, die gleiche Wiederversendung, die [`reinitialize()`](#query-object) nach einer Transportlücke auslöst. Behandeln Sie wiederholte Request-IDs idempotent, da ein Eintrag eine Anfrage wiederholen kann, die der Callback bereits erhalten hat, bevor die Verbindung unterbrochen wurde.697Dies sind Anfragen, die vor der Verbindung des Clients gestellt wurden und noch auf eine Antwort warten. Das SDK liest das Array für Sie und versendet jeden Eintrag an Ihren [`canUseTool`](#canusetool)-Callback, die gleiche Wiederversendung, die [`reinitialize()`](#query-object) nach einer Transportlücke auslöst. Behandeln Sie wiederholte Request-IDs idempotent, da ein Eintrag eine Anfrage wiederholen kann, die der Callback bereits erhalten hat, bevor die Verbindung unterbrochen wurde.

695 698 

699<h3 id="sdkcontrolinterruptresponse">

700 `SDKControlInterruptResponse`

701</h3>

702 

703Der Interrupt-Beleg: der Wert, mit dem [`interrupt()`](#query-object) auf einer CLI aufgelöst wird, die die `interrupt_receipt_v1`-Funktion in [`SDKSystemMessage.capabilities`](#sdksystemmessage) ankündigt. Erfordert Claude Code v2.1.205 oder später. Frühere CLIs beantworten den Interrupt mit einer leeren Erfolgsnutzlast, daher wird `interrupt()` mit `undefined` aufgelöst.

704 

705```typescript theme={null}

706type SDKControlInterruptResponse = {

707 still_queued: string[];

708};

709```

710 

711`still_queued` listet die UUIDs von Benutzernachrichten auf, die den Interrupt überstehen: Nachrichten, die sich noch in der Warteschlange befinden, plus jeden Batch, der bereits für den nächsten Turn aus der Warteschlange entfernt wurde, aber noch nicht vom Abort erreichbar ist. Jede wird als eigener Turn nach dem Interrupt ausgeführt, es sei denn, Sie brechen sie zuerst ab. Verwenden Sie den Beleg, um zu entscheiden, ob Sie etwas erneut senden möchten; das erneute Senden einer Nachricht, die bereits aufgelistet ist, erzeugt einen doppelten Turn.

712 

713Interpretieren Sie die Liste mit diesen Vorbehalten:

714 

715* Nur Nachrichten, die mit einer UUID in die Warteschlange eingereiht wurden, werden angezeigt. Ein leeres Array bedeutet nicht, dass nichts anderes ausgeführt wird.

716* Nur Hauptthread-Nachrichten werden aufgelistet. Nachrichten, die an einen Subagenten adressiert sind, sind außerhalb des Geltungsbereichs.

717* Die Liste kann UUIDs enthalten, die Ihr Client nie gesendet hat, z. B. [geplante Task](/de/scheduled-tasks)-Trigger. Ignorieren Sie UUIDs, die Sie nicht erkennen, anstatt sie als Fehler zu behandeln.

718 

719Der Beleg ist eine Momentaufnahme, die zum Zeitpunkt der Verarbeitung des Interrupts erstellt wird, und bei einem sauberen Interrupt kommt er an, bevor das [`SDKResultMessage`](#sdkresultmessage) des unterbrochenen Turns. Lesen Sie den Beleg, anstatt die Warteschlange nach diesem Ergebnis zu überprüfen: Die Schleife startet den nächsten in der Warteschlange befindlichen Turn sofort, sodass sich die Warteschlange, die Sie nach dem Ergebnis überprüfen, bereits geändert hat.

720 

696<h3 id="agentdefinition">721<h3 id="agentdefinition">

697 `AgentDefinition`722 `AgentDefinition`

698</h3>723</h3>


1097 | SDKTaskStartedMessage1122 | SDKTaskStartedMessage

1098 | SDKTaskProgressMessage1123 | SDKTaskProgressMessage

1099 | SDKTaskUpdatedMessage1124 | SDKTaskUpdatedMessage

1125 | SDKBackgroundTasksChangedMessage

1100 | SDKSessionStateChangedMessage1126 | SDKSessionStateChangedMessage

1101 | SDKWorkerShuttingDownMessage1127 | SDKWorkerShuttingDownMessage

1102 | SDKCommandsChangedMessage1128 | SDKCommandsChangedMessage


1110 | SDKPromptSuggestionMessage1136 | SDKPromptSuggestionMessage

1111 | SDKAPIRetryMessage1137 | SDKAPIRetryMessage

1112 | SDKMirrorErrorMessage1138 | SDKMirrorErrorMessage

1113 | SDKInformationalMessage;1139 | SDKInformationalMessage

1140 | SDKConversationResetMessage;

1114```1141```

1115 1142 

1116<h3 id="sdkassistantmessage">1143<h3 id="sdkassistantmessage">


1273 output_style: string;1300 output_style: string;

1274 skills: string[];1301 skills: string[];

1275 plugins: { name: string; path: string }[];1302 plugins: { name: string; path: string }[];

1303 capabilities?: string[];

1276};1304};

1277```1305```

1278 1306 

1307{/* min-version: 2.1.205 */}

1308 

1309Das `capabilities`-Array benennt die Protokoll-Verhaltensweisen, die diese CLI implementiert, damit Sie Feature-Erkennung durchführen können, anstatt `claude_code_version`-Zeichenketten zu vergleichen. Es ist ein offenes Set: Ignorieren Sie Werte, die Sie nicht erkennen, und überprüfen Sie auf die spezifische Fähigkeit, deren Verhalten Sie benötigen. Das Feld erfordert Claude Code v2.1.205 oder später und fehlt auf früheren CLIs.

1310 

1311| Fähigkeit | Bedeutung |

1312| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1313| `interrupt_receipt_v1` | [`interrupt()`](#query-object) wird mit einer [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) Quittung aufgelöst, die die in die Warteschlange eingereihten Nachrichten benennt, die den Interrupt überstehen |

1314 

1279<h3 id="sdkpartialassistantmessage">1315<h3 id="sdkpartialassistantmessage">

1280 `SDKPartialAssistantMessage`1316 `SDKPartialAssistantMessage`

1281</h3>1317</h3>

1282 1318 

1283Streaming-Teilnachricht (nur wenn `includePartialMessages` true ist).1319Streaming-Teilnachricht (nur wenn `includePartialMessages` true ist). Das `parent_tool_use_id`-Feld ist immer `null`: Stream-Ereignisse werden nur für die Hauptsitzung ausgegeben. Für die Zuordnung von Subagenten verwenden Sie vollständige Nachrichten, die `parent_tool_use_id` enthalten, oder aktivieren Sie [`forwardSubagentText`](#options), um Subagenten-Text und Thinking als vollständige Nachrichten zu erhalten.

1284 1320 

1285```typescript theme={null}1321```typescript theme={null}

1286type SDKPartialAssistantMessage = {1322type SDKPartialAssistantMessage = {


1421type SDKMessageOrigin =1457type SDKMessageOrigin =

1422 | { kind: "human" }1458 | { kind: "human" }

1423 | { kind: "channel"; server: string }1459 | { kind: "channel"; server: string }

1424 | { kind: "peer"; from: string; name?: string; senderTaskId?: string }1460 | {

1461 kind: "peer";

1462 from: string;

1463 name?: string;

1464 senderTaskId?: string;

1465 body?: string;

1466 }

1425 | { kind: "task-notification" }1467 | { kind: "task-notification" }

1426 | { kind: "coordinator" }1468 | { kind: "coordinator" }

1427 | { kind: "auto-continuation" };1469 | { kind: "auto-continuation" };

1428```1470```

1429 1471 

1430| `kind` | Bedeutung |1472| `kind` | Bedeutung |

1431| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1473| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1432| `human` | Direkte Eingabe vom Endbenutzer. Bei Benutzer-Nachrichten bedeutet auch eine fehlende `origin` menschliche Eingabe. |1474| `human` | Direkte Eingabe vom Endbenutzer. Bei Benutzer-Nachrichten bedeutet auch eine fehlende `origin` menschliche Eingabe. |

1433| `channel` | Nachricht, die auf einem [Kanal](/de/channels) ankommt. `server` ist der Name des Quell-MCP-Servers. |1475| `channel` | Nachricht, die auf einem [Kanal](/de/channels) ankommt. `server` ist der Name des Quell-MCP-Servers. |

1434| `peer` | Nachricht von einem anderen Agent. Für einen In-Process-[Teamkollegen](/de/agent-teams), der an `main` über `SendMessage` sendet, ist `from` der Name des Teamkollegen und `senderTaskId` ist seine Task-ID. Für einen Cross-Session-Peer wie einen anderen lokalen Claude Code-Prozess ist `from` die Absenderadresse und `senderTaskId` fehlt. Das `name`-Feld ist reserviert. |1476| `peer` | Nachricht von einem anderen Agent. Für einen In-Process-[Teamkollegen](/de/agent-teams), der an `main` über `SendMessage` sendet, ist `from` der Name des Teamkollegen und `senderTaskId` ist seine Task-ID. Für einen Cross-Session-Peer wie einen anderen lokalen Claude Code-Prozess ist `from` die Absenderadresse und `senderTaskId` fehlt. {/* min-version: 2.1.205 */}`name` und `body` erfordern Claude Code v2.1.205 oder später. `name` ist der Anzeigename des Absenders, normalisiert von Claude Code: Es entfernt Unicode-Steuer-, Format-, Surrogate- und Zeilen- oder Absatz-Trennzeichen-Codepunkte, schneidet dann das Ergebnis ab und begrenzt es auf 64 Codepunkte mit einer Ellipse. `body` ist der dekodierte Nachrichtentext mit der Peer-Hülle entfernt, byte-genau mit dem, was das Modell sieht. Für eine Teamkollegen-Nachricht ist `body` immer vorhanden; für einen Cross-Session-Peer ist es nur vorhanden, wenn der Turn genau eine von Claude Code gebildete Peer-Hülle ist. Rendern Sie `name` und `body` anstatt die Nachricht erneut zu analysieren. |

1435| `task-notification` | Synthetischer Turn, der nach Abschluss einer Hintergrund-Aufgabe eingefügt wird. Siehe [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |1477| `task-notification` | Synthetischer Turn, der nach Abschluss einer Hintergrund-Aufgabe eingefügt wird. Siehe [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |

1436| `coordinator` | Nachricht von einem Team-Koordinator in einem [Agent-Team](/de/agent-teams). |1478| `coordinator` | Nachricht von einem Team-Koordinator in einem [Agent-Team](/de/agent-teams). |

1437| `auto-continuation` | Synthetischer Turn, der eingefügt wird, wenn die Sitzung ohne neue Benutzereingabe fortgesetzt wird, z. B. ein Befehlsergebnis, das eine Follow-up-Eingabeaufforderung auslöst. |1479| `auto-continuation` | Synthetischer Turn, der eingefügt wird, wenn die Sitzung ohne neue Benutzereingabe fortgesetzt wird, z. B. ein Befehlsergebnis, das eine Follow-up-Eingabeaufforderung auslöst. |


2357 2399 

2358```typescript theme={null}2400```typescript theme={null}

2359type ExitPlanModeInput = {2401type ExitPlanModeInput = {

2402 /** Veraltet: wird nicht mehr verwendet. */

2360 allowedPrompts?: Array<{2403 allowedPrompts?: Array<{

2361 tool: "Bash";2404 tool: "Bash";

2362 prompt: string;2405 prompt: string;


2364};2407};

2365```2408```

2366 2409 

2367Beendet den Planungsmodus. Optional gibt Eingabeaufforderungsbasierte Berechtigungen an, die zur Implementierung des Plans erforderlich sind.2410Beendet den Planungsmodus. Das Feld `allowedPrompts` ist veraltet und wird ignoriert; Claude Code akzeptiert es immer noch, damit vorhandene Aufrufer und Transkripte validiert werden. Vor v2.1.205 forderte es eingabeaufforderungsbasierte Bash-Berechtigungen zur Implementierung des Plans an.

2368 2411 

2369<h3 id="listmcpresources">2412<h3 id="listmcpresources">

2370 ListMcpResources2413 ListMcpResources


2408};2451};

2409```2452```

2410 2453 

2411Erstellt und betritt einen temporären Git-Worktree für isolierte Arbeit. Übergeben Sie `path`, um stattdessen in einen vorhandenen Worktree des aktuellen Repositorys zu wechseln. `name` und `path` schließen sich gegenseitig aus.2454Erstellt und betritt einen temporären Git-Worktree für isolierte Arbeit. Übergeben Sie `path`, um stattdessen in einen vorhandenen Worktree zu wechseln. Beim ersten Eintritt muss das Ziel ein registrierter Worktree des aktuellen Repositorys sein oder, in einem Multi-Repo-Workspace, eines Repositorys, das darin verschachtelt ist; von innerhalb einer Worktree-Sitzung muss es unter `.claude/worktrees/` des Repositorys der Sitzung sein. `name` und `path` schließen sich gegenseitig aus.

2412 2455 

2413<h2 id="tool-output-types">2456<h2 id="tool-output-types">

2414 Tool-Ausgabetypen2457 Tool-Ausgabetypen


3656};3699};

3657```3700```

3658 3701 

3702<h3 id="sdkbackgroundtaskschangedmessage">

3703 `SDKBackgroundTasksChangedMessage`

3704</h3>

3705 

3706Wird ausgegeben, wenn sich die Menge der aktiven Hintergrund-Aufgaben ändert: eine Aufgabe startet, wird abgeschlossen, wird beendet oder ein Vordergrund-Agent wird in den Hintergrund verschoben. Das `tasks`-Array ist die vollständige aktive Menge. Ersetzen Sie alle zwischengespeicherten Mengen mit jeder Nutzlast, anstatt `task_started`- und `task_notification`-Ereignisse zu koppeln, sodass die nächste Änderung der Mitgliedschaft alle verpassten Ereignisse korrigiert.

3707 

3708Die Reihenfolge relativ zu diesen Pro-Aufgaben-Ereignissen ist nicht spezifiziert, daher korrelieren Sie die beiden Streams nicht.

3709 

3710Beim Start wird nichts ausgegeben. Setzen Sie auf eine leere Menge zurück, wenn der CLI-Prozess der Sitzung startet oder neu startet, und lassen Sie die nächste Änderung der Mitgliedschaft ihn neu auffüllen.

3711 

3712{/* min-version: 2.1.203 */}Erfordert Claude Code v2.1.203 oder später.

3713 

3714```typescript theme={null}

3715type SDKBackgroundTasksChangedMessage = {

3716 type: "system";

3717 subtype: "background_tasks_changed";

3718 tasks: {

3719 task_id: string;

3720 task_type: string;

3721 description: string;

3722 }[];

3723 uuid: UUID;

3724 session_id: string;

3725};

3726```

3727 

3659<h3 id="sdkfilespersistedevent">3728<h3 id="sdkfilespersistedevent">

3660 `SDKFilesPersistedEvent`3729 `SDKFilesPersistedEvent`

3661</h3>3730</h3>


3745};3814};

3746```3815```

3747 3816 

3817<h3 id="sdkconversationresetmessage">

3818 `SDKConversationResetMessage`

3819</h3>

3820 

3821Wird ausgegeben, wenn die Konversation der Sitzung ersetzt wird, ohne die Sitzung zu beenden, z. B. nach `/clear`, beim Beenden des Plan-Modus oder wenn eine neue Konversation startet. Mounten Sie ein leeres Transkript unter `new_conversation_id` und verwerfen Sie alle zwischengespeicherten Sitzungstitel.

3822 

3823```typescript theme={null}

3824type SDKConversationResetMessage = {

3825 type: "conversation_reset";

3826 new_conversation_id: UUID;

3827 uuid: UUID;

3828 session_id: string;

3829};

3830```

3831 

3832{/* min-version: 2.1.203 */}Die 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.

3833 

3748<h3 id="aborterror">3834<h3 id="aborterror">

3749 `AbortError`3835 `AbortError`

3750</h3>3836</h3>

Details

198</CodeGroup>198</CodeGroup>

199 199 

200<Note>200<Note>

201 In Python erfordert `can_use_tool` den [Streaming-Modus](/de/agent-sdk/streaming-vs-single-mode) und einen `PreToolUse`-Hook, der `{"continue_": True}` zurückgibt, um den Stream offen zu halten. Ohne diesen Hook wird der Stream geschlossen, bevor der Berechtigungscallback aufgerufen werden kann.201 In Python erfordert `can_use_tool` den [Streaming-Modus](/de/agent-sdk/streaming-vs-single-mode). Wenn Sie einen endlichen Nachrichtenstrom durch `query(prompt=generator)` oder `ClaudeSDKClient.connect(prompt=async_iterable)` übergeben, schließt das SDK den Eingabestrom nach der letzten Nachricht, bevor der Berechtigungscallback aufgerufen werden kann, es sei denn, ein registrierter Hook oder ein In-Process-MCP-Server hält ihn offen. Das obige Beispiel hält ihn mit einem `PreToolUse`-Hook offen, der `{"continue_": True}` zurückgibt. Das Verbinden ohne Eingabeaufforderung und das Senden von Nachrichten über `ClaudeSDKClient.query()` hält den Stream von selbst offen und benötigt keinen Hook.

202</Note>202</Note>

203 203 

204Dieses Beispiel verwendet einen `y/n`-Ablauf, bei dem jede Eingabe außer `y` als Ablehnung behandelt wird. In der Praxis könnten Sie eine umfangreichere Benutzeroberfläche erstellen, die es Benutzern ermöglicht, die Anfrage zu ändern, Feedback zu geben oder Claude vollständig umzuleiten. Siehe [Auf Tool-Anfragen reagieren](#respond-to-tool-requests) für alle Möglichkeiten, wie Sie reagieren können.204Dieses Beispiel verwendet einen `y/n`-Ablauf, bei dem jede Eingabe außer `y` als Ablehnung behandelt wird. In der Praxis könnten Sie eine umfangreichere Benutzeroberfläche erstellen, die es Benutzern ermöglicht, die Anfrage zu ändern, Feedback zu geben oder Claude vollständig umzuleiten. Siehe [Auf Tool-Anfragen reagieren](#respond-to-tool-requests) für alle Möglichkeiten, wie Sie reagieren können.


6864. **Ordnen Sie Antworten zu**: Der Code überprüft, ob die Eingabe numerisch ist (verwendet das Label der Option) oder freier Text (verwendet den Text direkt)6864. **Ordnen Sie Antworten zu**: Der Code überprüft, ob die Eingabe numerisch ist (verwendet das Label der Option) oder freier Text (verwendet den Text direkt)

6875. **Geben Sie an Claude zurück**: Die Antwort enthält sowohl das ursprüngliche `questions`-Array als auch die `answers`-Zuordnung6875. **Geben Sie an Claude zurück**: Die Antwort enthält sowohl das ursprüngliche `questions`-Array als auch die `answers`-Zuordnung

688 688 

689Speichern Sie die TypeScript-Version als `ask.ts` und führen Sie sie mit `npx tsx ask.ts` aus, oder speichern Sie die Python-Version als `ask.py` und führen Sie sie mit `python ask.py` aus.

690 

689<CodeGroup>691<CodeGroup>

690 ```python Python theme={null}692 ```python Python theme={null}

691 import asyncio693 import asyncio

agent-view.md +66 −22

Details

90 90 

91```text theme={null}91```text theme={null}

92Angeheftet92Angeheftet

93 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m93 ✽ clawd walk cycle Drawing the walk-cycle sprite frames 3m

94 94 

95Bereit zur Überprüfung95Bereit zur Überprüfung

96 ∙ jump physics Opened PR with collision fix #2048 2h96 ∙ jump physics Opened PR with collision fix #2048 2h

97 97 

98Benötigt Eingabe98Benötigt Eingabe

99 ✻ power-up design needs input: double jump or wall climb? 1m99 ✻ power-up design double jump or wall climb? 1m

100 100 

101Funktioniert101Funktioniert

102 ✽ collision detection Edit src/physics/CollisionSystem.ts 2m102 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m

103 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m103 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m

104 104 

105Abgeschlossen105Abgeschlossen


131| `∙` | Der Prozess ist beendet. Sie können immer noch Vorschau anzeigen, antworten oder anhängen, und Claude startet von dort neu, wo es aufgehört hat |131| `∙` | Der Prozess ist beendet. Sie können immer noch Vorschau anzeigen, antworten oder anhängen, und Claude startet von dort neu, wo es aufgehört hat |

132| `✢` | Eine [`/loop`](/de/scheduled-tasks)-Sitzung, die zwischen Iterationen schläft. Die Zeile zeigt ihre Laufzahl und einen Countdown |132| `✢` | Eine [`/loop`](/de/scheduled-tasks)-Sitzung, die zwischen Iterationen schläft. Die Zeile zeigt ihre Laufzahl und einen Countdown |

133 133 

134Das `#N`-Label, das am rechten Rand einer Zeile erscheinen kann, ist der [Pull Request, den die Sitzung geöffnet hat](#pull-request-status), nicht Teil des Status-Symbols.134Das `#N`-Label, das am rechten Rand einer Zeile erscheinen kann, ist ein [Pull Request, mit dem die Sitzung verknüpft ist](#pull-request-status), nicht Teil des Status-Symbols.

135 135 

136Der Terminal-Tab-Titel zeigt die Anzahl der wartenden Eingaben, während die Agenten-Ansicht offen ist: `2 awaiting input · claude agents`, wenn Sitzungen Eingabe benötigen, oder `claude agents`, wenn keine benötigen.136Der Terminal-Tab-Titel zeigt die Anzahl der wartenden Eingaben, während die Agenten-Ansicht offen ist: `2 awaiting input · claude agents`, wenn Sitzungen Eingabe benötigen, oder `claude agents`, wenn keine benötigen.

137 137 


141 141 

142Der Sitzungsstatus wird auf der Festplatte durch automatische Updates und Supervisor-Neustarts beibehalten. Sitzungen werden auch beibehalten, wenn Ihr Computer in den Ruhezustand wechselt. Ihre Prozesse werden beim Aufwachen fortgesetzt und der Supervisor verbindet sich wieder mit ihnen, anstatt die Zeitlücke als untätig zu behandeln. Das Herunterfahren stoppt immer noch laufende Sitzungen; siehe [Sitzungen werden nach dem Herunterfahren als fehlgeschlagen angezeigt](#sessions-show-as-failed-after-shutdown), um zu erfahren, wie Sie sie wiederherstellen.142Der Sitzungsstatus wird auf der Festplatte durch automatische Updates und Supervisor-Neustarts beibehalten. Sitzungen werden auch beibehalten, wenn Ihr Computer in den Ruhezustand wechselt. Ihre Prozesse werden beim Aufwachen fortgesetzt und der Supervisor verbindet sich wieder mit ihnen, anstatt die Zeitlücke als untätig zu behandeln. Das Herunterfahren stoppt immer noch laufende Sitzungen; siehe [Sitzungen werden nach dem Herunterfahren als fehlgeschlagen angezeigt](#sessions-show-as-failed-after-shutdown), um zu erfahren, wie Sie sie wiederherstellen.

143 143 

144Wenn Sie eine Sitzung öffnen, die nicht mehr reagiert, startet der Supervisor ihren Prozess neu und die Sitzung setzt die unterbrochene Antwort von dort fort, wo sie unterbrochen wurde. Eine Sitzung kann in diesen Zustand geraten, wenn der Computer in den Ruhezustand wechselt, während er sich mitten in einer Antwort befindet. Erfordert Claude Code v2.1.200 oder später.

145 

144<h3 id="row-summaries">146<h3 id="row-summaries">

145 Zeilenzusammenfassungen147 Zeilenzusammenfassungen

146</h3>148</h3>

147 149 

148Die einzeilige Zusammenfassung in jeder Zeile wird von einem [Haiku-Klasse-Modell](/de/model-config) generiert, sodass die Zeile Ihnen zeigen kann, was die Sitzung tut, was sie benötigt oder was sie produziert hat, ohne das Transkript zu öffnen. Während eine Sitzung aktiv funktioniert, wird die Zusammenfassung höchstens alle 15 Sekunden aktualisiert, plus einmal, wenn jede Runde endet.150Die einzeilige Zusammenfassung in jeder Zeile wird von einem [Haiku-Klasse-Modell](/de/model-config) generiert, sodass die Zeile Ihnen zeigen kann, was die Sitzung tut, was sie benötigt oder was sie produziert hat, ohne das Transkript zu öffnen. Während eine Sitzung aktiv funktioniert, wird der Zeilentext höchstens alle 15 Sekunden aus der eigenen aktuellen Ausgabe der Sitzung aktualisiert, ohne eine Modellanfrage zu senden, und das Modell schreibt eine neue Zusammenfassung, wenn jede Runde endet.

151 

152Eine arbeitende Zeile zeigt, was die Sitzung sagt, dass sie tut, und eine blockierte Zeile zeigt die Frage, die sie stellt. Während einer langen Runde schreibt das Modell die Zusammenfassung auch etwa einmal pro Minute neu, wartet nach jedem Neuschreiben doppelt so lange, bis zu vier Minuten, sodass eine beschäftigte Zeile nicht weiterhin eine veraltete Zusammenfassung anzeigt. Der Text wird bei 64 Spalten abgeschnitten; öffnen Sie das [Vorschau-Panel](#peek-and-reply), um den ganzen Satz zu lesen. Vor v2.1.205 konnte eine arbeitende Zeile einen rohen Tool-Aufruf anstelle eines Berichts anzeigen, und eine Sitzung, die parallele Arbeitselemente ausführte, zeigte eine `done/total`-Anzahl wie `2/5` vor dem Text.

153 

154Wenn die Liste [nach Verzeichnis gruppiert ist](#organize-the-list), öffnet sich die Zusammenfassung mit dem Status der Sitzung als farbiges Wort, z. B. `Benötigt Eingabe · double jump or wall climb?`. Bei der Standard-Status-Gruppierung benennt der Gruppenkopf bereits den Status, sodass die Zeile nur die Zusammenfassung anzeigt. Vor v2.1.205 trugen verzeichnis-gruppierte Zeilen kein Status-Wort.

149 155 

150Wenn die Sitzung zwei oder mehr parallele Arbeitselemente ausführt, wie z. B. Subagenten, Hintergrund-Shell-Befehle oder Monitore, wird eine `done/total`-Anzahl wie `2/5` vor dem Zusammenfassungstext angezeigt.156Eine Runde, deren gesamte Ausgabe keine Buchstaben oder Ziffern enthält, wie z. B. eine [`/loop`](/de/scheduled-tasks)-Sitzung, die bei einer ruhigen Iteration ein einzelnes Symbol druckt, behält die vorherige Zusammenfassung und den Status der Zeile bei. Vor v2.1.205 wurde diese Runde neu klassifiziert und konnte eine Sitzung, die auf Ihre Eingabe wartete, zurück zu `Funktioniert` umschalten.

151 157 

152Jede Aktualisierung ist eine kurze Haiku-Klasse-Anfrage durch Ihren normalen Anbieter, abgerechnet und behandelt unter denselben [Datennutzungsbedingungen](/de/data-usage) wie die Sitzung selbst. Bei Drittanbieter-Anbietern wie Bedrock, Vertex AI, Microsoft Foundry und benutzerdefinierten Gateways wird die Anfrage auf das Hauptmodell der Sitzung zurückgeführt, wenn kein Haiku-Modell konfiguriert ist. Legen Sie [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/de/model-config#environment-variables) fest, um das Modell für diese Zusammenfassungen bei diesen Anbietern auszuwählen.158Die End-of-Turn-Zusammenfassung und jedes Mid-Turn-Neuschreiben sind eine kurze Haiku-Klasse-Anfrage durch Ihren normalen Anbieter, abgerechnet und behandelt unter denselben [Datennutzungsbedingungen](/de/data-usage) wie die Sitzung selbst. Die 15-Sekunden-Updates zwischen Modell-Neuschreiben verwenden die eigene Ausgabe der Sitzung wieder und senden keine Anfrage. Bei Drittanbieter-Anbietern wie Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und benutzerdefinierten Gateways wird die Anfrage auf das Hauptmodell der Sitzung zurückgeführt, wenn kein Haiku-Modell konfiguriert ist. Legen Sie [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/de/model-config#environment-variables) fest, um das Modell für diese Zusammenfassungen bei diesen Anbietern auszuwählen.

153 159 

154<h3 id="pull-request-status">160<h3 id="pull-request-status">

155 Pull-Request-Status161 Pull-Request-Status


157 163 

158Wenn eine Sitzung einen Pull Request öffnet, wird ein `#1234`-Label am rechten Rand der Zeile angezeigt, verlinkt zum Pull Request in Terminals, die Hyperlinks unterstützen. Das Label bleibt bestehen, wenn Sie eine Nachverfolgung an die Sitzung senden, sodass der Pull Request sichtbar bleibt, während die Zeile zum Live-Fortschritt zurückkehrt. Hintergrund-Sitzungen, die ihre Änderungen in einem Worktree isoliert haben, öffnen diese Pull Requests selbst; [Wie Datei-Edits isoliert werden](#how-file-edits-are-isolated) behandelt, wann das passiert und was eine Sitzung niemals ohne zu fragen tut.164Wenn eine Sitzung einen Pull Request öffnet, wird ein `#1234`-Label am rechten Rand der Zeile angezeigt, verlinkt zum Pull Request in Terminals, die Hyperlinks unterstützen. Das Label bleibt bestehen, wenn Sie eine Nachverfolgung an die Sitzung senden, sodass der Pull Request sichtbar bleibt, während die Zeile zum Live-Fortschritt zurückkehrt. Hintergrund-Sitzungen, die ihre Änderungen in einem Worktree isoliert haben, öffnen diese Pull Requests selbst; [Wie Datei-Edits isoliert werden](#how-file-edits-are-isolated) behandelt, wann das passiert und was eine Sitzung niemals ohne zu fragen tut.

159 165 

160Wenn eine Sitzung mehr als einen Pull Request geöffnet hat, zeigt das Label eine Anzahl statt, z. B. `3 PRs`, farbig gekennzeichnet nach dem offenen Pull Request, der am meisten Aufmerksamkeit benötigt. Öffnen Sie das [Vorschau-Panel](#peek-and-reply), um sie alle zu sehen.166Eine Sitzung, die an einem bestehenden Pull Request arbeitet, ist auf die gleiche Weise damit verknüpft. Das Bearbeiten, Kommentieren, Schließen oder Markieren eines Pull Requests als bereit mit `gh` verknüpft den Pull Request, den die Ausgabe des Befehls selbst benennt, sodass ein `gh`-Befehl, dessen erfasste Ausgabe keinen Pull Request benennt, keinen Link erstellt; `gh pr merge` ist der häufige Fall, da er sein Ergebnis nur auf einem interaktiven Terminal druckt. Das Auschecken eines Pull Requests mit `gh pr checkout` oder das Pushen zu einem Branch, der einen offenen Pull Request hat, verknüpft ihn, indem stattdessen `gh pr view` nachgeschlagen wird. Vor v2.1.205 waren nur Pull Requests, die die Sitzung erstellt oder ausgecheckt hatte, verknüpft, und ein Push verknüpfte einen nur, wenn der lokale Branch-Name übereinstimmte.

167 

168Claude Code liest den Pull Request aus der vollständigen Befehlsausgabe, einschließlich des Teils, der in einer Datei gespeichert wird, wenn die Ausgabe eines Befehls das Inline-Limit überschreitet. Vor v2.1.205 war ein Pull Request, der in einem Bash-Aufruf erstellt wurde, dessen Ausgabe etwa 30.000 Zeichen überschritt, nicht verknüpft.

169 

170Wenn eine Sitzung mit mehr als einem Pull Request verknüpft ist, zeigt das Label stattdessen eine Anzahl, z. B. `3 PRs`, farbig gekennzeichnet nach dem offenen Pull Request, der am meisten Aufmerksamkeit benötigt. Öffnen Sie das [Vorschau-Panel](#peek-and-reply), um sie alle zu sehen.

161 171 

162Die Pull-Request-Nummer ist nach ihrem Status farbig gekennzeichnet:172Die Pull-Request-Nummer ist nach ihrem Status farbig gekennzeichnet:

163 173 


174 Vorschau und Antwort184 Vorschau und Antwort

175</h3>185</h3>

176 186 

177Drücken Sie `Space` auf einer ausgewählten Zeile, um das Vorschau-Panel zu öffnen. Es zeigt, was die Sitzung von Ihnen benötigt, ihre neueste Ausgabe und alle Pull Requests, die sie geöffnet hat. Meistens reicht dies aus, und Sie müssen das vollständige Transkript nie öffnen.187Drücken Sie `Space` auf einer ausgewählten Zeile, um das Vorschau-Panel zu öffnen. Es öffnet sich mit dem vollständigen Status-Satz der Sitzung, den die Zeile abschneidet, und wie lange ago es sich geändert hat, gefolgt von allen Pull Requests, die mit der Sitzung verknüpft sind. Für eine Sitzung, die auf Sie wartet, wird auch die genaue Frage, die sie stellt, über der Antwort-Eingabe angezeigt. Meistens reicht das Vorschau-Panel aus und Sie müssen das vollständige Transkript nie öffnen.

178 188 

179Wenn die Sitzung parallele Arbeitselemente ausführt, benennt das Panel auch das am längsten laufende Arbeitselement und wie lange es läuft, sodass Sie sehen können, worauf die Sitzung wartet, ohne sich anzuhängen.189Vor v2.1.205 wiederholte das Panel den Status-Satz nur, wenn es nichts anderes zu zeigen hatte, und benannte das am längsten laufende parallele Arbeitselement.

180 190 

181Geben Sie eine Antwort im Vorschau-Panel ein und drücken Sie `Enter`, um sie an diese Sitzung zu senden. Wenn die Sitzung eine Multiple-Choice-Frage stellt, zeigt das Vorschau-Panel die Optionen an und Sie können eine Zahlentaste drücken, um eine auszuwählen. Für andere blockierte Sitzungen drücken Sie `Tab`, um die Eingabe mit einer vorgeschlagenen Antwort zu füllen, die Sie vor dem Senden bearbeiten können. Präfixieren Sie eine Antwort mit `!`, um stattdessen einen Bash-Befehl zu senden.191Geben Sie eine Antwort im Vorschau-Panel ein und drücken Sie `Enter`, um sie an diese Sitzung zu senden. Wenn die Sitzung eine Multiple-Choice-Frage stellt, zeigt das Vorschau-Panel die Optionen an und Sie können eine Zahlentaste drücken, um eine auszuwählen. Für andere blockierte Sitzungen drücken Sie `Tab`, um die Eingabe mit einer vorgeschlagenen Antwort zu füllen, die Sie vor dem Senden bearbeiten können. Präfixieren Sie eine Antwort mit `!`, um stattdessen einen Bash-Befehl zu senden.

182 192 


206 216 

207Wenn ein Tool läuft, wenn Sie `←` drücken, wartet Claude Code bis zu etwa zehn Sekunden, bis es fertig ist, bevor es in den Hintergrund geht, und die Antwort wird in der Hintergrund-Sitzung fortgesetzt. Drücken Sie `←` erneut, um sofort in den Hintergrund zu gehen, anstatt zu warten. Wenn laufende Arbeit nicht zur Hintergrund-Sitzung übertragen werden kann, wird zuerst das Dialog `Background this session?` angezeigt, genauso wie mit [`/background`](#from-inside-a-session).217Wenn ein Tool läuft, wenn Sie `←` drücken, wartet Claude Code bis zu etwa zehn Sekunden, bis es fertig ist, bevor es in den Hintergrund geht, und die Antwort wird in der Hintergrund-Sitzung fortgesetzt. Drücken Sie `←` erneut, um sofort in den Hintergrund zu gehen, anstatt zu warten. Wenn laufende Arbeit nicht zur Hintergrund-Sitzung übertragen werden kann, wird zuerst das Dialog `Background this session?` angezeigt, genauso wie mit [`/background`](#from-inside-a-session).

208 218 

209Die Zeile wird auch aus einer neuen Sitzung ohne Gesprächsverlauf erstellt, sodass `` zu ihr zurückkehrt. Wenn diese Zeile die einzige ist, zeigt die Agenten-Ansicht einen Onboarding-Hinweis darunter an.219Die Zehn-Sekunden-Grenze gilt nicht, während [Subagenten](/de/sub-agents) laufen. Claude Code wartet weiter, damit ihre Arbeit übertragen wird, und zeigt eine `Still backgrounding after the current tool`-Benachrichtigung an, während es wartet; drücken Sie `` erneut, um ohne Warten in den Hintergrund zu gehen, was die Subagenten von vorne neu startet. Vor v2.1.203 endete das Warten nach zehn Sekunden und die laufenden Subagenten wurden ohne Warnung von vorne neu gestartet.

210 220 

211Sie können diesen Tastaturkürzel in `/config` ausschalten (die `leftArrowOpensAgents`-Einstellung).221Die Zeile wird auch aus einer neuen Sitzung ohne Gesprächsverlauf erstellt, sodass `` zu ihr zurückkehrt. {/* max-version: 2.1.202 */}Vor v2.1.203 zeigte die Agenten-Ansicht einen Onboarding-Hinweis unter dieser Zeile an, wenn sie die einzige war.

222 

223Sie können diesen Tastaturkürzel mit der `leftArrowOpensAgents`-Einstellung in `/config` ausschalten.

212 224 

213<h3 id="organize-the-list">225<h3 id="organize-the-list">

214 Die Liste organisieren226 Die Liste organisieren


302* `/model` setzt das [Versand-Modell](#set-the-model)314* `/model` setzt das [Versand-Modell](#set-the-model)

303* {/* min-version: 2.1.198 */}Ab v2.1.198 öffnet `/login` den Anmeldedialog, damit Sie sich erneut anmelden können, ohne an eine Sitzung anzuhängen315* {/* min-version: 2.1.198 */}Ab v2.1.198 öffnet `/login` den Anmeldedialog, damit Sie sich erneut anmelden können, ohne an eine Sitzung anzuhängen

304 316 

305Skills, Ihre eigenen Befehle und Eingabeaufforderungs-erweiternde Built-ins wie `/init` werden als erste Eingabeaufforderung an eine neue Hintergrund-Sitzung gesendet. Andere Built-in-Befehle zeigen stattdessen einen `attach to a session to run it`-Hinweis an.317Skills, Ihre eigenen Befehle und Eingabeaufforderungs-erweiternde Built-ins wie `/init` werden als erste Eingabeaufforderung an eine neue Hintergrund-Sitzung gesendet. Andere Built-in-Befehle zeigen stattdessen einen `attach to a session to run it`-Hinweis an. {/* min-version: 2.1.203 */}Alles, was Sie eingegeben haben, bleibt in der Eingabe neben dem Hinweis, damit Sie es bearbeiten können. Vor v2.1.203 hat der Hinweis die Eingabe gelöscht und der eingegebene Text ging verloren.

306 318 

307Das Verpacken einer wiederkehrenden Aufgabe als [Skill](/de/skills) ermöglicht es Ihnen, denselben Workflow aus der Agenten-Ansicht wiederholt zu starten, ohne die Eingabeaufforderung erneut einzugeben.319Das Verpacken einer wiederkehrenden Aufgabe als [Skill](/de/skills) ermöglicht es Ihnen, denselben Workflow aus der Agenten-Ansicht wiederholt zu starten, ohne die Eingabeaufforderung erneut einzugeben.

308 320 


315Eine neue Sitzung läuft in dem Verzeichnis, in dem Sie die Agenten-Ansicht geöffnet haben. Um ein anderes Verzeichnis anzusteuern, verwenden Sie eines dieser Verfahren:327Eine neue Sitzung läuft in dem Verzeichnis, in dem Sie die Agenten-Ansicht geöffnet haben. Um ein anderes Verzeichnis anzusteuern, verwenden Sie eines dieser Verfahren:

316 328 

317* Öffnen Sie `claude agents` in diesem Verzeichnis.329* Öffnen Sie `claude agents` in diesem Verzeichnis.

318* Öffnen Sie `claude agents` in einem übergeordneten Verzeichnis und erwähnen Sie ein untergeordnetes Repository mit `@<repo>` in der Eingabeaufforderung. Wenn Sie `@` eingeben, werden Git-Repositories eine Ebene unter dem Startverzeichnis sowie alle Verzeichnisse aufgelistet, die bereits eine Sitzung in der Liste haben. Ein Verzeichnis, dessen Name ein Leerzeichen enthält, wird nicht aufgelistet.330* Öffnen Sie `claude agents` in einem übergeordneten Verzeichnis und erwähnen Sie ein untergeordnetes Repository mit `@<repo>` in der Eingabeaufforderung. Wenn Sie `@` eingeben, werden diese Ziele aufgelistet:

331 

332 * Git-Repositories eine Ebene unter dem Startverzeichnis

333 * Die registrierten [Git-Worktrees](/de/worktrees) des Repositories, von dem Sie gestartet haben, die sich in seinem Verzeichnisbaum befinden, wie die, die Claude unter `.claude/worktrees/` erstellt, gekennzeichnet mit ihrem ausgecheckten Branch. Worktrees, die außerhalb des Repositories hinzugefügt wurden, wie mit `git worktree add ../feature`, werden nicht aufgelistet

334 * Jedes Verzeichnis, das bereits eine Sitzung in der Liste hat

335 

336 Ein Verzeichnis, dessen Name ein Leerzeichen enthält, wird nicht aufgelistet. {/* min-version: 2.1.203 */}Vor v2.1.203 wurden registrierte Worktrees nicht aufgelistet, daher bedeutete das Versenden in einen Worktree das Ausführen von `claude --bg` aus dem Verzeichnis dieses Worktrees.

319* Führen Sie in der Shell `cd` in das Verzeichnis aus und führen Sie `claude --bg "<prompt>"` aus.337* Führen Sie in der Shell `cd` in das Verzeichnis aus und führen Sie `claude --bg "<prompt>"` aus.

320 338 

321Wenn die Agenten-Ansicht nach Verzeichnis gruppiert ist, wird das Verzeichnis der hervorgehobenen Zeile zum Versand-Ziel, sodass Sie zu einer Gruppe scrollen und darin versenden können, ohne den Pfad erneut einzugeben.339Wenn die Agenten-Ansicht nach Verzeichnis gruppiert ist, wird das Verzeichnis der hervorgehobenen Zeile zum Versand-Ziel, sodass Sie zu einer Gruppe scrollen und darin versenden können, ohne den Pfad erneut einzugeben.


371claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"389claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

372```390```

373 391 

374Nach dem Versenden druckt Claude die kurze ID der Sitzung und die Befehle zu ihrer Verwaltung. Wenn Sie `--name` übergeben, wird der Name nach der kurzen ID angezeigt:392Nach dem Versenden druckt Claude die kurze ID der Sitzung und die Befehle zu ihrer Verwaltung. Wenn der Service, der Hintergrund-Sitzungen hostet, noch nicht läuft, kann `--bg` zuerst `Starting background service…` über dieser Ausgabe drucken. Wenn Sie `--name` übergeben, wird der Name nach der kurzen ID angezeigt:

375 393 

376```text theme={null}394```text theme={null}

377backgrounded · 7c5dcf5d · flaky-test-fix395backgrounded · 7c5dcf5d · flaky-test-fix


425 443 

426Außerhalb eines Git-Repositories schreiben Sitzungen direkt in das Arbeitsverzeichnis und sind nicht voneinander isoliert, daher vermeiden Sie das Versenden paralleler Sitzungen, die dieselben Dateien bearbeiten. Wenn Sie ein anderes Versionskontrollsystem verwenden, konfigurieren Sie einen [`WorktreeCreate`-Hook](/de/worktrees#non-git-version-control) und Claude isoliert Bearbeitungen auf die gleiche Weise wie für Git.444Außerhalb eines Git-Repositories schreiben Sitzungen direkt in das Arbeitsverzeichnis und sind nicht voneinander isoliert, daher vermeiden Sie das Versenden paralleler Sitzungen, die dieselben Dateien bearbeiten. Wenn Sie ein anderes Versionskontrollsystem verwenden, konfigurieren Sie einen [`WorktreeCreate`-Hook](/de/worktrees#non-git-version-control) und Claude isoliert Bearbeitungen auf die gleiche Weise wie für Git.

427 445 

446Wenn der Hook in einem Verzeichnis fehlschlägt, das kein Git-Repository ist, überspringt die Sitzung die Isolation für dieses Verzeichnis und bearbeitet das Arbeitsverzeichnis an Ort und Stelle. Innerhalb eines Git-Repositories bleiben Schreibvorgänge blockiert, bis sich die Sitzung isoliert. Vor v2.1.203 konnte eine Hintergrund-Sitzung in diesem Zustand keine Datei bearbeiten: Jeder Schreibvorgang wurde abgelehnt, bis er sich isolierte, und der Hook konnte dieses Verzeichnis niemals isolieren.

447 

428Das Löschen einer Sitzung in der Agenten-Ansicht mit `Ctrl+X` zweimal entfernt einen Worktree, den Claude für sie erstellt hat, einschließlich aller nicht committeten Änderungen, daher führen Sie die Änderungen zusammen oder pushen Sie sie, die Sie behalten möchten, bevor Sie löschen. Das Löschen aus der Shell mit [`claude rm`](#manage-sessions-from-the-shell) behält einen Worktree mit nicht committeten Änderungen und druckt seinen Pfad, damit Sie ihn selbst bereinigen können. Ein Worktree, den Sie selbst erstellt haben und in dem Sie die Sitzung gestartet haben, wird in jedem Fall beibehalten.448Das Löschen einer Sitzung in der Agenten-Ansicht mit `Ctrl+X` zweimal entfernt einen Worktree, den Claude für sie erstellt hat, einschließlich aller nicht committeten Änderungen, daher führen Sie die Änderungen zusammen oder pushen Sie sie, die Sie behalten möchten, bevor Sie löschen. Das Löschen aus der Shell mit [`claude rm`](#manage-sessions-from-the-shell) behält einen Worktree mit nicht committeten Änderungen und druckt seinen Pfad, damit Sie ihn selbst bereinigen können. Ein Worktree, den Sie selbst erstellt haben und in dem Sie die Sitzung gestartet haben, wird in jedem Fall beibehalten.

429 449 

430Um den Worktree-Pfad einer Sitzung zu finden, schauen Sie sich die Sitzung an oder hängen Sie an und überprüfen Sie ihr Arbeitsverzeichnis.450Um den Worktree-Pfad einer Sitzung zu finden, schauen Sie sich die Sitzung an oder hängen Sie an und überprüfen Sie ihr Arbeitsverzeichnis.


464 484 

465Eine Hintergrund-Sitzung liest ihre [Einstellungen](/de/settings) aus dem Verzeichnis, in dem sie läuft, genauso wie wenn Sie `claude` dort gestartet hätten. Dies umfasst [`env`-Werte](/de/settings#available-settings) in Projekteinstellungen, sodass ein dort gesetzter `ANTHROPIC_MODEL` oder Provider-Variable auf Hintergrund-Sitzungen in diesem Verzeichnis angewendet wird.485Eine Hintergrund-Sitzung liest ihre [Einstellungen](/de/settings) aus dem Verzeichnis, in dem sie läuft, genauso wie wenn Sie `claude` dort gestartet hätten. Dies umfasst [`env`-Werte](/de/settings#available-settings) in Projekteinstellungen, sodass ein dort gesetzter `ANTHROPIC_MODEL` oder Provider-Variable auf Hintergrund-Sitzungen in diesem Verzeichnis angewendet wird.

466 486 

467Die Cloud-Provider-Auswahl, wie `CLAUDE_CODE_USE_BEDROCK` oder `CLAUDE_CODE_USE_VERTEX`, und `ANTHROPIC_DEFAULT_*_MODEL`-Aliase folgen der Shell, die die Sitzung versendet hat. Gateway-Endpunkt-Variablen wie `ANTHROPIC_BASE_URL` und sein gepaarter `ANTHROPIC_AUTH_TOKEN` tun dies nicht. Siehe [der Supervisor-Prozess](#the-supervisor-process), um zu erfahren, wie Hintergrund-Sitzungen Provider-Einstellungen und Anmeldedaten beziehen.487Die Cloud-Provider-Auswahl, wie `CLAUDE_CODE_USE_BEDROCK` oder `CLAUDE_CODE_USE_VERTEX`, und `ANTHROPIC_DEFAULT_*_MODEL`-Aliase folgen der Shell, die die Sitzung versendet hat. Ein Gateway-`ANTHROPIC_BASE_URL`, das in dieser Shell exportiert wird, folgt ihm auch, zusammen mit `ANTHROPIC_CUSTOM_HEADERS`, wenn der Supervisor mit der gleichen Gateway-Umgebung läuft und die Sitzung in dem Verzeichnis läuft, von dem Sie versenden, oder Ihre eigene Sitzung ist, die mit `` oder `/background` in den Hintergrund verschoben wurde. Das ist der normale Fall, wenn die erste Shell, die die Agenten-Ansicht öffnet oder eine Hintergrund-Sitzung versendet, die Gateway-Shell ist. Das Versenden in ein anderes Verzeichnis mit `@repo` oder `--cwd` trägt das Gateway des Shells nicht mit sich; die [Einstellungen](/de/settings) dieses Projekts liefern den Endpunkt. Siehe [der Supervisor-Prozess](#the-supervisor-process), um zu erfahren, wie Hintergrund-Sitzungen Provider-Einstellungen und Anmeldedaten beziehen.

468 488 

469Der [Berechtigungsmodus](/de/permissions) hängt davon ab, wie Sie die Sitzung gestartet haben. Das Verschieben einer vorhandenen Sitzung mit `/bg` oder `←` behält den aktuellen Berechtigungsmodus bei, sodass eine Sitzung, die Sie zu `acceptEdits` oder `auto` gewechselt haben, nach dem Trennen in diesem Modus bleibt. Das Versenden aus der Agenten-Ansicht-Eingabe oder das Ausführen von `claude --bg` aus der Shell verwendet den `defaultMode` aus den Einstellungen dieses Verzeichnisses oder den `permissionMode` aus dem Frontmatter des versendeten [Subagenten](/de/sub-agents#supported-frontmatter-fields).489Der [Berechtigungsmodus](/de/permissions) hängt davon ab, wie Sie die Sitzung gestartet haben. Das Verschieben einer vorhandenen Sitzung mit `/bg` oder `←` behält den aktuellen Berechtigungsmodus bei, sodass eine Sitzung, die Sie zu `acceptEdits` oder `auto` gewechselt haben, nach dem Trennen in diesem Modus bleibt. Das Versenden aus der Agenten-Ansicht-Eingabe oder das Ausführen von `claude --bg` aus der Shell verwendet den `defaultMode` aus den Einstellungen dieses Verzeichnisses oder den `permissionMode` aus dem Frontmatter des versendeten [Subagenten](/de/sub-agents#supported-frontmatter-fields).

470 490 

471Der Berechtigungsmodus, das Modell und der Aufwand, mit dem eine Hintergrund-Sitzung gestartet wurde, sowie die [Konfigurationsflags, die sie trägt](#from-inside-a-session), bleiben alle bestehen, wenn der Supervisor später [die Sitzung stoppt und neu startet](#the-supervisor-process). Eine Sitzung, die Sie mit `claude --bg --dangerously-skip-permissions` oder `claude --bg --permission-mode bypassPermissions` gestartet haben, bleibt nach diesem Neustart in `bypassPermissions`, anstatt auf den `defaultMode` des Verzeichnisses zurückzufallen, und ein Modell oder Aufwand, den Sie während der Sitzung mit `/model` oder `/effort` geändert haben, wird beibehalten.491Der Berechtigungsmodus, das Modell und der Aufwand, mit dem eine Hintergrund-Sitzung gestartet wurde, sowie die [Konfigurationsflags, die sie trägt](#from-inside-a-session), bleiben alle bestehen, wenn der Supervisor später [die Sitzung stoppt und neu startet](#the-supervisor-process). Eine Sitzung, die Sie mit `claude --bg --dangerously-skip-permissions` oder `claude --bg --permission-mode bypassPermissions` gestartet haben, bleibt nach diesem Neustart in `bypassPermissions`, anstatt auf den `defaultMode` des Verzeichnisses zurückzufallen, und ein Modell oder Aufwand, den Sie während der Sitzung mit `/model` oder `/effort` geändert haben, wird beibehalten.

472 492 

493Ein Aufwand, den die Sitzung aus der [`effortLevel`-Einstellung](/de/settings#available-settings) statt aus `--effort` oder `/effort` genommen hat, ist nicht beim Versenden festgelegt: Jeder Prozess, der für die Sitzung gestartet wird, liest die Einstellung erneut, sodass das Bearbeiten von `effortLevel` in `settings.json` Sitzungen erreicht, die Sie mit `←` oder `/bg` in den Hintergrund verschieben, und ihre späteren Neustarts. Vor v2.1.203 hat das Verschieben einer Sitzung ihren aus Einstellungen stammenden Aufwand aufgezeichnet, als hätten Sie `--effort` übergeben, sodass spätere `effortLevel`-Bearbeitungen ihn niemals erreichten.

494 

495Ein Name, den Sie mit [`/rename`](/de/commands) oder `Ctrl+R` festgelegt haben, bleibt auch über diesen Neustart hinweg bestehen, sodass [`claude --resume <name>`](/de/sessions#name-your-sessions) die Sitzung immer noch auflöst. Vor v2.1.202 hat der Neustart die Sitzung auf den Namen zurückgesetzt, mit dem sie versendet wurde, und der neue Name hat nicht mehr aufgelöst.

496 

473Um Standardwerte für jede Sitzung festzulegen, die Sie aus der Agenten-Ansicht versenden, übergeben Sie eines der folgenden Elemente beim Öffnen: `--permission-mode`, `--model`, `--effort` oder `--agent`:497Um Standardwerte für jede Sitzung festzulegen, die Sie aus der Agenten-Ansicht versenden, übergeben Sie eines der folgenden Elemente beim Öffnen: `--permission-mode`, `--model`, `--effort` oder `--agent`:

474 498 

475```bash theme={null}499```bash theme={null}


544 568 

545Der Supervisor und seine Sitzungen authentifizieren sich mit denselben Anmeldedaten wie Ihre interaktiven Sitzungen und stellen keine zusätzlichen Netzwerkverbindungen über die Modell-API hinaus her. Anbieter-Auswahlvariablen wie `CLAUDE_CODE_USE_BEDROCK` und `ANTHROPIC_DEFAULT_*_MODEL`-Aliase werden aus der Shell gelesen, die jede Sitzung dispatcht, und werden auf ihren Worker angewendet.569Der Supervisor und seine Sitzungen authentifizieren sich mit denselben Anmeldedaten wie Ihre interaktiven Sitzungen und stellen keine zusätzlichen Netzwerkverbindungen über die Modell-API hinaus her. Anbieter-Auswahlvariablen wie `CLAUDE_CODE_USE_BEDROCK` und `ANTHROPIC_DEFAULT_*_MODEL`-Aliase werden aus der Shell gelesen, die jede Sitzung dispatcht, und werden auf ihren Worker angewendet.

546 570 

547Eine Hintergrund-Sitzung erbt keine Gateway-Endpunkt-Variablen wie `ANTHROPIC_BASE_URL`, die entsprechenden Bedrock-, Vertex- und Foundry-Basis-URL-Variablen oder ein gekoppeltes `ANTHROPIC_AUTH_TOKEN` aus der Shell, die den Supervisor gestartet hat, oder aus der Dispatch-Shell. Die Sitzung verwendet Ihre gespeicherten Anmeldedaten und alle `env`-Werte im [settings](/de/settings) des Projektverzeichnisses. Um Hintergrund-Sitzungen in einem Projekt auf ein [LLM-Gateway](/de/llm-gateway) zu verweisen, setzen Sie `ANTHROPIC_BASE_URL` im `env`-Block der `.claude/settings.json` dieses Projekts, anstatt es in Ihrer Shell zu exportieren.571Der `PATH` der Dispatch-Shell wird auf den Worker auf die gleiche Weise angewendet, daher finden Shell-Befehle, die die Sitzung ausführt, die gleichen Tools wie Ihr Terminal. Vor v2.1.203 behielt eine Hintergrund-Sitzung den `PATH` der Shell, die den Supervisor zuerst gestartet hat, daher konnten Tools, die Sie Ihrem `PATH` hinzugefügt haben, seitdem fehlen, am häufigsten unter Windows.

572 

573Eine Hintergrund-Sitzung erbt keine Gateway-Endpunkt-Variablen wie `ANTHROPIC_BASE_URL` oder die entsprechenden Amazon Bedrock-, Google Cloud Agent Platform- und Microsoft Foundry-Basis-URL-Variablen aus der Shell, die den Supervisor gestartet hat. Ohne ein Gateway, das in der Shell exportiert ist, von der Sie dispatchen, verwendet die Sitzung Ihre gespeicherten Anmeldedaten und alle `env`-Werte im [settings](/de/settings) des Projektverzeichnisses. Um jede Sitzung in einem Projekt auf ein [LLM-Gateway](/de/llm-gateway) zu verweisen, setzen Sie `ANTHROPIC_BASE_URL` im `env`-Block der `.claude/settings.json` dieses Projekts.

574 

575{/* min-version: 2.1.203 */}Ein Gateway `ANTHROPIC_BASE_URL`, das in der Shell exportiert ist, von der Sie dispatchen, erreicht den Worker dieser Sitzung, zusammen mit `ANTHROPIC_CUSTOM_HEADERS` und den Anmeldedaten, die neben ihnen exportiert sind, wenn der Supervisor aus einer Umgebung mit dem gleichen Gateway gestartet wurde. Der Supervisor erfasst seine Umgebung aus der ersten Shell, die die Agenten-Ansicht öffnet oder eine Hintergrund-Sitzung dispatcht, daher gibt das Starten aus der Gateway-Shell ihm diese Umgebung. Die Weiterleitung gilt auch nur für Sitzungen, die in das Verzeichnis dispatcht werden, von dem aus Sie dispatchen, oder die mit `←` oder `/background` in den Hintergrund verschoben werden: Das Dispatchen in ein anderes Verzeichnis mit `@repo` oder `--cwd` trägt das Gateway der Shell nicht mit sich, und der `settings.json` `env`-Block dieses Projekts liefert stattdessen den Endpunkt. Wenn die Umgebung des Supervisors ein anderes Gateway oder keines trägt, behält der Worker Ihre gespeicherten Anmeldedaten gegen den Standard-Endpunkt, anstatt die Anmeldedaten einer Umgebung mit dem Endpunkt einer anderen zu vermischen. Vor v2.1.203 wurde der `ANTHROPIC_BASE_URL` der Dispatch-Shell gelöscht, während der `ANTHROPIC_API_KEY`, der neben ihm exportiert wurde, beibehalten wurde, daher wurde der Schlüssel des Gateways an den Standard-Endpunkt gesendet und jede Anfrage schlug mit einem 401 fehl.

576 

577Der weitergeleitete Endpunkt gilt nur für diesen Live-Prozess und wird niemals auf die Festplatte geschrieben. Wenn der Supervisor eine untätige Sitzung stoppt und sie später neu startet, liest der neu gestartete Prozess seinen Endpunkt erneut aus Ihren Einstellungen: Mit einem Gateway `ANTHROPIC_AUTH_TOKEN` fällt er auf Ihre gespeicherten Anmeldedaten zurück, und mit einem von einem Gateway ausgegebenen `ANTHROPIC_API_KEY` kann die Authentifizierung fehlschlagen, bis das Gateway in den Einstellungen gesetzt wird.

548 578 

549Jede Hintergrund-Sitzung ist ihr eigener Claude Code-Prozess, der vom Supervisor verwaltet wird, anstatt an Ihr Terminal gebunden zu sein. Eine Sitzung, die aktiv funktioniert, auf Ihre Eingabe wartet oder ein Terminal angehängt hat, behält ihren Prozess am Laufen. Ein laufender Hintergrund-Shell-Befehl, Subagent, dynamischer Workflow oder Monitor zählt als aktive Arbeit, daher hält ein langfristiger Prozess wie ein Dev-Server die Sitzung am Leben.579Jede Hintergrund-Sitzung ist ihr eigener Claude Code-Prozess, der vom Supervisor verwaltet wird, anstatt an Ihr Terminal gebunden zu sein. Eine Sitzung, die aktiv funktioniert, auf Ihre Eingabe wartet oder ein Terminal angehängt hat, behält ihren Prozess am Laufen. Ein laufender Hintergrund-Shell-Befehl, Subagent, dynamischer Workflow oder Monitor zählt als aktive Arbeit, daher hält ein langfristiger Prozess wie ein Dev-Server die Sitzung am Leben.

550 580 


570 600 

571Der Supervisor beobachtet die installierte Claude Code-Binärdatei auf der Festplatte und startet in die neue Version neu, nachdem der reguläre [Auto-Updater](/de/setup#auto-updates) sie ersetzt. Dies ist eine lokale Dateiüberwachung, keine Netzwerkprüfung. Hintergrund-Sitzungen sind abgelöste Prozesse, daher laufen sie während des Neustarts weiter und der neue Supervisor verbindet sich wieder mit ihnen. Eine untätige angeheftete Sitzung wird auch an Ort und Stelle in die neue Version neu gestartet, damit sie das Update aufgreift, ohne dass Sie sie erneut anhängen müssen.601Der Supervisor beobachtet die installierte Claude Code-Binärdatei auf der Festplatte und startet in die neue Version neu, nachdem der reguläre [Auto-Updater](/de/setup#auto-updates) sie ersetzt. Dies ist eine lokale Dateiüberwachung, keine Netzwerkprüfung. Hintergrund-Sitzungen sind abgelöste Prozesse, daher laufen sie während des Neustarts weiter und der neue Supervisor verbindet sich wieder mit ihnen. Eine untätige angeheftete Sitzung wird auch an Ort und Stelle in die neue Version neu gestartet, damit sie das Update aufgreift, ohne dass Sie sie erneut anhängen müssen.

572 602 

603Das Ausführen von `claude attach`, während der Supervisor eine Sitzung neu startet, sei es für ein Update, einen Stall oder eine Migration, wartet auf den Ersatzprozess, anstatt fehlzuschlagen. Eine Statuszeile wie `Agent is updating to the new Claude Code…` benennt, worauf es wartet, und zählt die verstrichenen Sekunden, und der Befehl verbindet sich, sobald die Sitzung bereit ist. Nach etwa 60 Sekunden stoppt es das Warten und meldet einen Fehler. Vor v2.1.205 stoppte `claude attach` das Wiederholen nach wenigen Sekunden und druckte einen Fehler, während die Sitzung noch neu gestartet wurde.

604 

573<h3 id="where-state-is-stored">605<h3 id="where-state-is-stored">

574 Wo der Status gespeichert ist606 Wo der Status gespeichert ist

575</h3>607</h3>


585 617 

586Jede Hintergrund-Sitzung hat die Umgebungsvariable `CLAUDE_JOB_DIR` auf ihr `~/.claude/jobs/<id>`-Verzeichnis gesetzt, daher können Shell-Befehle, die die Sitzung ausführt, temporäre Dateien in `$CLAUDE_JOB_DIR/tmp` schreiben, ohne mit parallelen Sitzungen zu kollidieren.618Jede Hintergrund-Sitzung hat die Umgebungsvariable `CLAUDE_JOB_DIR` auf ihr `~/.claude/jobs/<id>`-Verzeichnis gesetzt, daher können Shell-Befehle, die die Sitzung ausführt, temporäre Dateien in `$CLAUDE_JOB_DIR/tmp` schreiben, ohne mit parallelen Sitzungen zu kollidieren.

587 619 

588Um diesen Status zu überprüfen, ohne die Dateien direkt zu lesen, führen Sie `claude daemon status` aus. Es meldet, ob der Supervisor erreichbar ist, seine Prozess-ID und Version, das Socket-Verzeichnis und wie viele Hintergrund-Sitzungen aktiv sind. `/doctor` enthält eine Zusammenfassung derselben Überprüfung.620Um diesen Status zu überprüfen, ohne die Dateien direkt zu lesen, führen Sie `claude daemon status` aus. Es meldet, ob der Supervisor erreichbar ist, seine Prozess-ID und Version, das Socket-Verzeichnis und wie viele Hintergrund-Sitzungen aktiv sind.

589 621 

590Der Befehl warnt auch, wenn der laufende Supervisor eine andere Version hat als der `claude`, den Sie aufgerufen haben, was nach einem Update geschieht, das der Supervisor noch nicht neu gestartet hat. Die Warnung zeigt beide Versionen an und teilt Ihnen mit, dass Sie `claude daemon stop --any` ausführen sollen, um die neue Version zu übernehmen. Wenn Claude Code als Betriebssystem-Dienst installiert ist, ist der vorgeschlagene Befehl `claude daemon stop` ohne das Flag.622Der Befehl warnt auch, wenn der laufende Supervisor eine andere Version hat als der `claude`, den Sie aufgerufen haben, was nach einem Update geschieht, das der Supervisor noch nicht neu gestartet hat. Die Warnung zeigt beide Versionen an und teilt Ihnen mit, dass Sie `claude daemon stop --any` ausführen sollen, um die neue Version zu übernehmen. Wenn Claude Code als Betriebssystem-Dienst installiert ist, ist der vorgeschlagene Befehl `claude daemon stop` ohne das Flag.

591 623 

592Sitzungen bleiben bei diesem Versionskonflikt intakt: Eine ältere Claude Code-Version, die die `state.json` einer Sitzung aktualisiert, behält Felder, die sie nicht erkennt, und behält die Sitzung in der Liste.624Sitzungen bleiben bei diesem Versionskonflikt intakt: Eine ältere Claude Code-Version, die die `state.json` einer Sitzung aktualisiert, behält Felder, die sie nicht erkennt, und behält die Sitzung in der Liste. {/* min-version: 2.1.200 */}Die Sitzungsliste in `roster.json` folgt derselben Regel: Eine ältere Version, die sie umschreibt, behält Felder, die eine neuere Version geschrieben hat, daher bleiben Sitzungen, die von der neueren Version gestartet wurden, erreichbar und akzeptieren weiterhin Eingaben, nachdem der Supervisor neu gestartet wird. Vor v2.1.200 konnten ältere Versionen diese Felder beim Umschreiben löschen.

593 625 

594Unter Windows zeigt `claude daemon status` den zugrunde liegenden Dateifehler an, wenn die Pipe-Schlüsseldatei des Daemons gesperrt oder nicht lesbar ist, anstatt einen generischen Verbindungsfehler zu melden.626Unter Windows zeigt `claude daemon status` den zugrunde liegenden Dateifehler an, wenn die Pipe-Schlüsseldatei des Daemons gesperrt oder nicht lesbar ist, anstatt einen generischen Verbindungsfehler zu melden.

595 627 


615 Agenten-Ansicht öffnet sich ohne Sitzungen647 Agenten-Ansicht öffnet sich ohne Sitzungen

616</h3>648</h3>

617 649 

618Bevor Sie Ihre erste Sitzung versenden, zeigt die Agenten-Ansicht einen kurzen Onboarding-Hinweis mit Beispiel-Eingabeaufforderungen anstelle der Sitzungsliste. Geben Sie eine Eingabeaufforderung in die Eingabe am unteren Rand ein und drücken Sie `Enter`, um Ihre erste Sitzung zu versenden.650Bevor Sie Ihre erste Sitzung versenden, zeigt die Agenten-Ansicht die leeren Abschnittskopfzeilen mit einer Beschreibung unter jedem sowie eine einzeilige Erklärung über der Eingabe anstelle der Sitzungsliste. Geben Sie eine Eingabeaufforderung in die Eingabe am unteren Rand ein und drücken Sie `Enter`, um Ihre erste Sitzung zu versenden.

619 651 

620<h3 id="backgrounding-shows-a-background-this-session-dialog">652<h3 id="backgrounding-shows-a-background-this-session-dialog">

621 Backgrounding zeigt einen `Background this session?`-Dialog653 Backgrounding zeigt einen `Background this session?`-Dialog


637 669 

638Der Ruhezustand allein verursacht dies nicht. Sitzungen werden über den Ruhezustand hinweg beibehalten und der Supervisor verbindet sich beim Aufwachen wieder mit ihnen.670Der Ruhezustand allein verursacht dies nicht. Sitzungen werden über den Ruhezustand hinweg beibehalten und der Supervisor verbindet sich beim Aufwachen wieder mit ihnen.

639 671 

672<h3 id="opening-a-session-says-the-conversation-is-already-open">

673 Öffnen einer Sitzung besagt, dass die Konversation bereits offen ist

674</h3>

675 

676Das Öffnen einer gestoppten Zeile, deren Konversation auch von einem anderen laufenden nicht-interaktiven Claude Code-Prozess geöffnet wird, z. B. ein Hintergrund-Worker für dieselbe Konversation, der noch heruntergefahren wird, zeigt `This conversation is already open in another running Claude session` anstatt den Prozess der Zeile zu starten, da zwei Prozesse nicht in dasselbe Transkript schreiben können. Antworten Sie in der Sitzung, die die Konversation bereits offen hat, oder beenden Sie sie und öffnen Sie die Zeile erneut. Eine Antwort, die Sie mit dem abgelehnten Versuch eingegeben haben, geht nicht verloren; sie wird gesendet, wenn die Sitzung das nächste Mal startet.

677 

678Vor v2.1.203 startete dieser Zustand trotzdem einen zweiten Prozess. Dieser Prozess beendete sich mit einem `currently running as a background agent`-Fehler und die Zeile zeigte als fehlgeschlagen.

679 

640<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">680<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

641 Eine Sitzung schlägt vor dem Start mit einer `possibly low memory`-Notiz fehl681 Eine Sitzung schlägt vor dem Start mit einer `possibly low memory`-Notiz fehl

642</h3>682</h3>


730Die Agenten-Ansicht hat sich während der Forschungsvorschau schnell entwickelt. Wenn Sie eine ältere Claude Code-Version verwenden, kann sich einiges auf dieser Seite unterscheiden; insbesondere lehnt `claude agents` Flags ab, die es noch nicht unterstützt, mit einem `unknown option`-Fehler. Die folgende Tabelle listet auf, wann jedes Flag und Verhalten hinzugefügt wurde.770Die Agenten-Ansicht hat sich während der Forschungsvorschau schnell entwickelt. Wenn Sie eine ältere Claude Code-Version verwenden, kann sich einiges auf dieser Seite unterscheiden; insbesondere lehnt `claude agents` Flags ab, die es noch nicht unterstützt, mit einem `unknown option`-Fehler. Die folgende Tabelle listet auf, wann jedes Flag und Verhalten hinzugefügt wurde.

731 771 

732| Version | Änderung |772| Version | Änderung |

733| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |773| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

774| v2.1.205 | {/* min-version: 2.1.205 */}Zeilenzusammenfassungen zeigen den eigenen einzeiligen Bericht der Sitzung, abgeschnitten bei 64 Spalten, anstelle einer rohen Tool-Aufrufe oder einer `done/total`-Anzahl; verzeichnisgruppierten Zeilen öffnen sich mit einem farbigen Statuswort. Das Vorschau-Panel öffnet sich mit dem vollständigen Statussatz und für eine Sitzung, die auf Sie wartet, ihrer genauen Frage über der Antwort-Eingabe. Sitzungen, die einen Pull Request mit `gh` bearbeiten, kommentieren, schließen oder als bereit markieren, sind damit verknüpft, nicht nur solche, die einen Pull Request erstellen oder auschecken, ein Push verknüpft einen Pull Request auch wenn der lokale Branch-Name nicht übereinstimmt, und ein Pull Request, dessen Erstellungsbefehl-Ausgabe das Inline-Limit überschritten hat, ist auch verknüpft. Eine Wendung ohne lesbaren Text behält den vorherigen Zustand der Sitzung bei, anstatt ihn zurück auf `Working` zu setzen. `claude attach` wartet bis zu etwa 60 Sekunden auf eine Sitzung, die neu startet, mit einer Statuszeile, die angibt warum, anstatt fehlzuschlagen. |

775| v2.1.203 | {/* min-version: 2.1.203 */}Ein Gateway `ANTHROPIC_BASE_URL`, das in der Versand-Shell exportiert wird, erreicht die von ihr versendeten Sitzungen in demselben Verzeichnis, wenn der Supervisor diese Gateway-Umgebung teilt, anstatt gelöscht zu werden, während der daneben exportierte API-Schlüssel beibehalten wird. Der `PATH` der Versand-Shell wird auf den Worker jeder Sitzung angewendet. Das Drücken von `←` während Subagenten laufen, wartet auf sie, anstatt sie nach zehn Sekunden neu zu starten. Die leere Liste zeigt immer die Abschnittskopfzeilen mit einer Beschreibung unter jedem an. Das Eingeben von `@` in der Versand-Eingabe listet auch die registrierten Git-Worktrees des Start-Repositorys auf, die sich in seinem Verzeichnisbaum befinden. Ein Aufwand, der von der `effortLevel`-Einstellung geerbt wird, folgt späteren Änderungen dieser Einstellung, anstatt beim Versand festgelegt zu werden. Das Öffnen einer gestoppten Sitzung, deren Unterhaltung bereits in einer anderen laufenden Sitzung offen ist, wird mit einer Nachricht abgelehnt, anstatt die Zeile fehlschlagen zu lassen. Ein Befehl, der in der Agenten-Ansicht nicht verfügbar ist, lässt den eingegebenen Text in der Eingabe. Ein `WorktreeCreate`-Hook, der außerhalb eines Git-Repositorys fehlschlägt, blockiert die Sitzung nicht mehr beim Bearbeiten von Dateien. |

776| v2.1.202 | {/* min-version: 2.1.202 */}Ein Name, der mit `/rename` oder `Ctrl+R` in einer Hintergrund-Sitzung festgelegt wird, bleibt erhalten, wenn der Supervisor seinen Prozess stoppt und neu startet, anstatt auf den Namen zurückzusetzen, mit dem die Sitzung versendet wurde. |

777| v2.1.200 | {/* min-version: 2.1.200 */}Eine ältere Claude Code-Version, die die Sitzungsliste in `roster.json` umschreibt, behält Felder bei, die von einer neueren Version geschrieben wurden, was der bestehenden `state.json`-Garantie entspricht, sodass Sitzungen, die von der neueren Version gestartet wurden, nach dem Neustart des Supervisors weiterhin Eingaben akzeptieren. Wenn Sie eine Sitzung öffnen, die nicht mehr reagiert, startet der Supervisor ihren Prozess neu und die Sitzung setzt die unterbrochene Antwort von dort fort, wo sie stehen geblieben ist. |

734| v2.1.199 | {/* min-version: 2.1.199 */}Eine Hintergrund-Sitzung, deren Prozess beendet wird, bevor sie auf einem Host mit wenig Speicher vollständig startet, zeigt `possibly low memory — free some up and retry` in ihrem Zeilenstatus an, anstatt nur die bloße Beendigungsursache anzuzeigen. Das Verschieben einer Sitzung in den Hintergrund mit `←` oder `/background` überträgt ihre `/color`-Einstellung auf die neue Zeile. |778| v2.1.199 | {/* min-version: 2.1.199 */}Eine Hintergrund-Sitzung, deren Prozess beendet wird, bevor sie auf einem Host mit wenig Speicher vollständig startet, zeigt `possibly low memory — free some up and retry` in ihrem Zeilenstatus an, anstatt nur die bloße Beendigungsursache anzuzeigen. Das Verschieben einer Sitzung in den Hintergrund mit `←` oder `/background` überträgt ihre `/color`-Einstellung auf die neue Zeile. |

735| v2.1.198 | {/* min-version: 2.1.198 */}Die Agenten-Ansicht sendet eine Benachrichtigung über `preferredNotifChannel`, wenn eine Hintergrund-Sitzung Eingabe benötigt, beendet wird oder fehlschlägt, und löst den `Notification`-Hook mit dem Typ `agent_needs_input` oder `agent_completed` aus. `←` und `/exit` innerhalb von `claude attach <id>` kehren zur Agenten-Ansicht zurück, anstatt zur Shell zu beenden; `Ctrl+Z` kehrt zur Shell zurück. Eine Hintergrund-Sitzung, die ihre Arbeit in einem Worktree isoliert, committed und pusht ihren eigenen isolierten Branch, niemals `main` oder `master`, und öffnet einen Entwurf eines Pull Requests, wenn sie beendet wird, anstatt zuerst zu fragen. `/login` wird in der Agenten-Ansicht ausgeführt und öffnet den Anmeldedialog. Der Beendigungsdialog `Background work is running` bietet `Move to background and exit` an. Die Beendigungsübergabe deckt auch Hintergrund-Subagenten ab, die beim nächsten Aufwachen aus ihrem Transkript fortgesetzt werden, anstatt als fehlgeschlagen gemeldet zu werden. `claude --bg` kombiniert mit `-p` oder `--print` wird mit einem Fehler abgelehnt. |779| v2.1.198 | {/* min-version: 2.1.198 */}Die Agenten-Ansicht sendet eine Benachrichtigung über `preferredNotifChannel`, wenn eine Hintergrund-Sitzung Eingabe benötigt, beendet wird oder fehlschlägt, und löst den `Notification`-Hook mit dem Typ `agent_needs_input` oder `agent_completed` aus. `←` und `/exit` innerhalb von `claude attach <id>` kehren zur Agenten-Ansicht zurück, anstatt zur Shell zu beenden; `Ctrl+Z` kehrt zur Shell zurück. Eine Hintergrund-Sitzung, die ihre Arbeit in einem Worktree isoliert, committed und pusht ihren eigenen isolierten Branch, niemals `main` oder `master`, und öffnet einen Entwurf eines Pull Requests, wenn sie beendet wird, anstatt zuerst zu fragen. `/login` wird in der Agenten-Ansicht ausgeführt und öffnet den Anmeldedialog. Der Beendigungsdialog `Background work is running` bietet `Move to background and exit` an. Die Beendigungsübergabe deckt auch Hintergrund-Subagenten ab, die beim nächsten Aufwachen aus ihrem Transkript fortgesetzt werden, anstatt als fehlgeschlagen gemeldet zu werden. `claude --bg` kombiniert mit `-p` oder `--print` wird mit einem Fehler abgelehnt. |

736| v2.1.196 | {/* min-version: 2.1.196 */}Ein einzelner `←`-Druck verschieben eine Vordergrund-Sitzung in den Hintergrund; frühere Versionen erforderten zwei Drücke, mit einem Fußzeilen-Hinweis und einer Bestätigung. `--dangerously-skip-permissions`, das an `claude agents` übergeben wird, zeigt den Bypass-Haftungsausschluss an, anstatt stillschweigend gelöscht zu werden. Interaktive Sitzungen, die Sie nie benannt haben, tragen einen Standard-Namen wie `my-app-3f` in Sitzungsauflistungen und `claude agents --json`. Hintergrund-Shell-Befehle und dynamische Workflows überleben das Stoppen, Neustarten oder Aktualisieren des Sitzungsprozesses, einschließlich unter Windows; setzen Sie `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1`, um die Übergabe auszuschalten. Ein Transkript, das beim Neustart als leer missverstanden wird, wird mit einem `.orphaned-`-Suffix umbenannt, anstatt gelöscht zu werden. |780| v2.1.196 | {/* min-version: 2.1.196 */}Ein einzelner `←`-Druck verschiebt eine Vordergrund-Sitzung in den Hintergrund; frühere Versionen erforderten zwei Drücke, mit einem Fußzeilen-Hinweis und einer Bestätigung. `--dangerously-skip-permissions`, das an `claude agents` übergeben wird, zeigt den Bypass-Haftungsausschluss an, anstatt stillschweigend gelöscht zu werden. Interaktive Sitzungen, die Sie nie benannt haben, tragen einen Standard-Namen wie `my-app-3f` in Sitzungsauflistungen und `claude agents --json`. Hintergrund-Shell-Befehle und dynamische Workflows überleben das Stoppen, Neustarten oder Aktualisieren des Sitzungsprozesses, einschließlich unter Windows; setzen Sie `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1`, um die Übergabe auszuschalten. Ein Transkript, das beim Neustart als leer missverstanden wird, wird mit einem `.orphaned-`-Suffix umbenannt, anstatt gelöscht zu werden. |

737| v2.1.195 | {/* min-version: 2.1.195 */}Laufende Arbeit wird auch unter Windows übertragen, wenn Sie eine Sitzung in den Hintergrund verschieben; setzen Sie `CLAUDE_DISABLE_ADOPT=1`, um sie stattdessen zu stoppen. Die Gruppe `Abgeschlossen` füllt den verbleibenden vertikalen Platz und die Kopfzeile wird auf kurzen Terminals komprimiert. Eine ältere Claude Code-Version löscht nicht mehr neuere Sitzungs-`state.json`-Felder oder versteckt diese Sitzungen nicht vor `claude agents`. Das Anhängen an eine gestoppte Sitzung wechselt sofort, anstatt bis zu fünf Sekunden einen leeren Bildschirm zu zeigen. Ein Supervisor, der keine Verbindungen akzeptieren kann, beendet sich selbst und gibt seine Sperre frei. |781| v2.1.195 | {/* min-version: 2.1.195 */}Laufende Arbeit wird auch unter Windows übertragen, wenn Sie eine Sitzung in den Hintergrund verschieben; setzen Sie `CLAUDE_DISABLE_ADOPT=1`, um sie stattdessen zu stoppen. Die Gruppe `Abgeschlossen` füllt den verbleibenden vertikalen Platz und die Kopfzeile wird auf kurzen Terminals komprimiert. Eine ältere Claude Code-Version löscht nicht mehr neuere Sitzungs-`state.json`-Felder oder versteckt diese Sitzungen nicht vor `claude agents`. Das Anhängen an eine gestoppte Sitzung wechselt sofort, anstatt bis zu fünf Sekunden einen leeren Bildschirm zu zeigen. Ein Supervisor, der keine Verbindungen akzeptieren kann, beendet sich selbst und gibt seine Sperre frei. |

738| v2.1.174 | {/* min-version: 2.1.174 */}Hintergrund-Sitzungen erben keine Gateway-Endpunkt-Variablen wie `ANTHROPIC_BASE_URL` aus der Supervisor-Start-Shell mehr; der Supervisor stellt einen frischen Snapshot der Anmeldedaten für vorgewärmte Worker bereit, was spurlose `Could not resolve authentication method`-Fehler behebt. |782| v2.1.174 | {/* min-version: 2.1.174 */}Hintergrund-Sitzungen erben keine Gateway-Endpunkt-Variablen wie `ANTHROPIC_BASE_URL` aus der Supervisor-Start-Shell mehr; der Supervisor stellt einen frischen Snapshot der Anmeldedaten für vorgewärmte Worker bereit, was spurlose `Could not resolve authentication method`-Fehler behebt. |

739| v2.1.172 | {/* min-version: 2.1.172 */}`/model` in der Versand-Eingabe setzt eine Sitzungs-Bereichs-Versand-Modell-Überschreibung. |783| v2.1.172 | {/* min-version: 2.1.172 */}`/model` in der Versand-Eingabe setzt eine Sitzungs-Bereichs-Versand-Modell-Überschreibung. |

amazon-bedrock.md +36 −36

Details

82 Voraussetzungen82 Voraussetzungen

83</h2>83</h2>

84 84 

85Bevor Sie Claude Code mit Bedrock konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:85Bevor Sie Claude Code mit Amazon Bedrock konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:

86 86 

87* Ein AWS-Konto mit aktiviertem Bedrock-Zugriff87* Ein AWS-Konto mit aktiviertem Amazon Bedrock-Zugriff

88* Zugriff auf gewünschte Claude-Modelle (z. B. Claude Sonnet 4.6) in Bedrock88* Zugriff auf gewünschte Claude-Modelle (z. B. Claude Sonnet 4.6) in Amazon Bedrock

89* AWS CLI installiert und konfiguriert (optional – nur erforderlich, wenn Sie keinen anderen Mechanismus zur Beschaffung von Anmeldedaten haben)89* AWS CLI installiert und konfiguriert (optional – nur erforderlich, wenn Sie keinen anderen Mechanismus zur Beschaffung von Anmeldedaten haben)

90* Angemessene IAM-Berechtigungen90* Angemessene IAM-Berechtigungen

91 91 

92Um sich mit Ihren eigenen Bedrock-Anmeldedaten anzumelden, folgen Sie [Mit Bedrock anmelden](#sign-in-with-bedrock) unten. Um Claude Code in einem Team bereitzustellen, verwenden Sie die Schritte zum [manuellen Setup](#set-up-manually) und [fixieren Sie Ihre Modellversionen](#4-pin-model-versions), bevor Sie ausrollen.92Um sich mit Ihren eigenen Amazon Bedrock-Anmeldedaten anzumelden, folgen Sie [Mit Amazon Bedrock anmelden](#sign-in-with-bedrock) unten. Um Claude Code in einem Team bereitzustellen, verwenden Sie die Schritte zum [manuellen Setup](#set-up-manually) und [fixieren Sie Ihre Modellversionen](#4-pin-model-versions), bevor Sie ausrollen.

93 93 

94<h2 id="sign-in-with-bedrock">94<h2 id="sign-in-with-bedrock">

95 Mit Bedrock anmelden95 Mit Bedrock anmelden

96</h2>96</h2>

97 97 

98Wenn Sie AWS-Anmeldedaten haben und Claude Code über Bedrock verwenden möchten, führt Sie der Anmelde-Assistent durch den Prozess. Sie führen die AWS-seitigen Voraussetzungen einmal pro Konto durch; der Assistent kümmert sich um die Claude Code-Seite.98Wenn Sie AWS-Anmeldedaten haben und Claude Code über Amazon Bedrock verwenden möchten, führt Sie der Anmelde-Assistent durch den Prozess. Sie führen die AWS-seitigen Voraussetzungen einmal pro Konto durch; der Assistent kümmert sich um die Claude Code-Seite.

99 99 

100<Steps>100<Steps>

101 <Step title="Aktivieren Sie Anthropic-Modelle in Ihrem AWS-Konto">101 <Step title="Aktivieren Sie Anthropic-Modelle in Ihrem AWS-Konto">

102 Öffnen Sie in der [Amazon Bedrock-Konsole](https://console.aws.amazon.com/bedrock/) den Modellkatalog, wählen Sie ein Anthropic-Modell aus und reichen Sie das Anwendungsfallformular ein. Der Zugriff wird unmittelbar nach der Einreichung gewährt. Siehe [Anwendungsfalldetails einreichen](#1-submit-use-case-details) für AWS Organizations und [IAM-Konfiguration](#iam-configuration) für die Berechtigungen, die Ihre Rolle benötigt.102 Öffnen Sie in der [Amazon Bedrock-Konsole](https://console.aws.amazon.com/bedrock/) den Modellkatalog, wählen Sie ein Anthropic-Modell aus und reichen Sie das Anwendungsfallformular ein. Der Zugriff wird unmittelbar nach der Einreichung gewährt. Siehe [Anwendungsfalldetails einreichen](#1-submit-use-case-details) für AWS Organizations und [IAM-Konfiguration](#iam-configuration) für die Berechtigungen, die Ihre Rolle benötigt.

103 </Step>103 </Step>

104 104 

105 <Step title="Starten Sie Claude Code und wählen Sie Bedrock">105 <Step title="Starten Sie Claude Code und wählen Sie Amazon Bedrock">

106 Führen Sie `claude` aus. Wählen Sie bei der Anmeldeeingabeaufforderung **3rd-party platform** und dann **Amazon Bedrock**.106 Führen Sie `claude` aus. Wählen Sie bei der Anmeldeeingabeaufforderung **3rd-party platform** und dann **Amazon Bedrock**.

107 </Step>107 </Step>

108 108 

109 <Step title="Folgen Sie den Assistent-Eingabeaufforderungen">109 <Step title="Folgen Sie den Assistent-Eingabeaufforderungen">

110 Wählen Sie, wie Sie sich bei AWS authentifizieren: ein AWS-Profil, das aus Ihrem `~/.aws`-Verzeichnis erkannt wird, ein Bedrock API-Schlüssel, ein Zugriffsschlüssel und Geheimnis oder Anmeldedaten, die bereits in Ihrer Umgebung vorhanden sind. Der Assistent erkennt Ihre Region, überprüft, welche Claude-Modelle Ihr Konto aufrufen kann, und ermöglicht es Ihnen, diese zu fixieren. Das Ergebnis wird im `env`-Block Ihrer [Benutzereinstellungsdatei](/de/settings) gespeichert, sodass Sie Umgebungsvariablen nicht selbst exportieren müssen.110 Wählen Sie, wie Sie sich bei AWS authentifizieren: ein AWS-Profil, das aus Ihrem `~/.aws`-Verzeichnis erkannt wird, ein Amazon Bedrock API-Schlüssel, ein Zugriffsschlüssel und Geheimnis oder Anmeldedaten, die bereits in Ihrer Umgebung vorhanden sind. Der Assistent erkennt Ihre Region, überprüft, welche Claude-Modelle Ihr Konto aufrufen kann, und ermöglicht es Ihnen, diese zu fixieren. Das Ergebnis wird im `env`-Block Ihrer [Benutzereinstellungsdatei](/de/settings) gespeichert, sodass Sie Umgebungsvariablen nicht selbst exportieren müssen.

111 </Step>111 </Step>

112</Steps>112</Steps>

113 113 


117 Manuelles Setup117 Manuelles Setup

118</h2>118</h2>

119 119 

120Um Bedrock über Umgebungsvariablen statt über den Assistenten zu konfigurieren, z. B. in CI oder einem skriptgesteuerten Enterprise-Rollout, folgen Sie den folgenden Schritten.120Um Amazon Bedrock über Umgebungsvariablen statt über den Assistenten zu konfigurieren, z. B. in CI oder einem skriptgesteuerten Enterprise-Rollout, folgen Sie den folgenden Schritten.

121 121 

122<h3 id="1-submit-use-case-details">122<h3 id="1-submit-use-case-details">

123 1. Anwendungsfalldetails einreichen123 1. Anwendungsfalldetails einreichen


168 168 

169[Erfahren Sie mehr](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) über `aws login`.169[Erfahren Sie mehr](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) über `aws login`.

170 170 

171**Option E: Bedrock API-Schlüssel**171**Option E: Amazon Bedrock API-Schlüssel**

172 172 

173```bash theme={null}173```bash theme={null}

174export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key174export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

175```175```

176 176 

177Bedrock API-Schlüssel bieten eine einfachere Authentifizierungsmethode ohne vollständige AWS-Anmeldedaten. [Erfahren Sie mehr über Bedrock API-Schlüssel](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).177Amazon Bedrock API-Schlüssel bieten eine einfachere Authentifizierungsmethode ohne vollständige AWS-Anmeldedaten. [Erfahren Sie mehr über Amazon Bedrock API-Schlüssel](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).

178 178 

179<h4 id="advanced-credential-configuration">179<h4 id="advanced-credential-configuration">

180 Erweiterte Anmeldedatenkonfiguration180 Erweiterte Anmeldedatenkonfiguration


185Diese zwei Einstellungen haben unterschiedliche Auslösebedingungen:185Diese zwei Einstellungen haben unterschiedliche Auslösebedingungen:

186 186 

187* **`awsAuthRefresh`**: wird nur ausgeführt, wenn Claude Code erkennt, dass Ihre AWS-Anmeldedaten abgelaufen sind, entweder lokal basierend auf ihrem Zeitstempel oder wenn die API einen Anmeldedatenfehler zurückgibt, und versucht dann die Anfrage mit aktualisierten Anmeldedaten erneut.187* **`awsAuthRefresh`**: wird nur ausgeführt, wenn Claude Code erkennt, dass Ihre AWS-Anmeldedaten abgelaufen sind, entweder lokal basierend auf ihrem Zeitstempel oder wenn die API einen Anmeldedatenfehler zurückgibt, und versucht dann die Anfrage mit aktualisierten Anmeldedaten erneut.

188* **`awsCredentialExport`**: wird beim Sitzungsstart und bei jeder Anmeldedatenaktualisierung ausgeführt, auch wenn die Anmeldedaten in Ihrer AWS-Standard-Anmeldedatenkette noch gültig sind. Verwenden Sie dies, wenn Ihr Bedrock-Konto Cross-Account-Anmeldedaten erfordert, die sich von denen unterscheiden, die die Standard-Anmeldedatenkette auflösen würde.188* **`awsCredentialExport`**: wird beim Sitzungsstart und bei jeder Anmeldedatenaktualisierung ausgeführt, auch wenn die Anmeldedaten in Ihrer AWS-Standard-Anmeldedatenkette noch gültig sind. Verwenden Sie dies, wenn Ihr Amazon Bedrock-Konto Cross-Account-Anmeldedaten erfordert, die sich von denen unterscheiden, die die Standard-Anmeldedatenkette auflösen würde.

189 189 

190<h5 id="example-configuration">190<h5 id="example-configuration">

191 Beispielkonfiguration191 Beispielkonfiguration


227 3. Claude Code konfigurieren227 3. Claude Code konfigurieren

228</h3>228</h3>

229 229 

230Legen Sie die folgenden Umgebungsvariablen fest, um Bedrock zu aktivieren:230Legen Sie die folgenden Umgebungsvariablen fest, um Amazon Bedrock zu aktivieren:

231 231 

232```bash theme={null}232```bash theme={null}

233# Bedrock-Integration aktivieren233# Bedrock-Integration aktivieren


243# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com243# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

244```244```

245 245 

246Beachten Sie beim Aktivieren von Bedrock für Claude Code Folgendes:246Beachten Sie beim Aktivieren von Amazon Bedrock für Claude Code Folgendes:

247 247 

248* {/* min-version: 2.1.172 */}Ab v2.1.172 müssen Sie nur `AWS_REGION` setzen, um die Region Ihres AWS-Profils zu überschreiben oder wenn Ihr Profil keine Region hat. Claude Code löst die Region in dieser Reihenfolge auf:248* {/* min-version: 2.1.172 */}Ab v2.1.172 müssen Sie nur `AWS_REGION` setzen, um die Region Ihres AWS-Profils zu überschreiben oder wenn Ihr Profil keine Region hat. Claude Code löst die Region in dieser Reihenfolge auf:

249 249 


253 * `us-east-1`253 * `us-east-1`

254 254 

255 Das aktive Profil ist `AWS_PROFILE`, falls gesetzt, andernfalls `default`. Setzen Sie `AWS_SHARED_CREDENTIALS_FILE` oder `AWS_CONFIG_FILE`, um auf nicht-standardmäßige Dateipfade zu verweisen. Führen Sie `/status` aus, um die aufgelöste Region zu sehen. Wenn die Region aus Ihren AWS-Konfigurationsdateien oder dem Standard-Fallback stammt, notiert `/status` auch die Quelle. Bei v2.1.171 und früher liest Claude Code die AWS-Konfigurationsdateien nicht, daher setzen Sie `AWS_REGION` explizit.255 Das aktive Profil ist `AWS_PROFILE`, falls gesetzt, andernfalls `default`. Setzen Sie `AWS_SHARED_CREDENTIALS_FILE` oder `AWS_CONFIG_FILE`, um auf nicht-standardmäßige Dateipfade zu verweisen. Führen Sie `/status` aus, um die aufgelöste Region zu sehen. Wenn die Region aus Ihren AWS-Konfigurationsdateien oder dem Standard-Fallback stammt, notiert `/status` auch die Quelle. Bei v2.1.171 und früher liest Claude Code die AWS-Konfigurationsdateien nicht, daher setzen Sie `AWS_REGION` explizit.

256* Bei Verwendung von Bedrock ist der `/logout`-Befehl nicht verfügbar, da die Authentifizierung über AWS-Anmeldedaten erfolgt.256* Bei Verwendung von Amazon Bedrock ist der `/logout`-Befehl nicht verfügbar, da die Authentifizierung über AWS-Anmeldedaten erfolgt.

257* Das WebSearch-Tool ist auf Bedrock nicht verfügbar. Siehe [WebSearch-Tool-Verhalten](/de/tools-reference#websearch-tool-behavior).257* Das WebSearch-Tool ist auf Amazon Bedrock nicht verfügbar. Siehe [WebSearch-Tool-Verhalten](/de/tools-reference#websearch-tool-behavior).

258* Sie können Einstellungsdateien für Umgebungsvariablen wie `AWS_PROFILE` verwenden, die Sie nicht an andere Prozesse weitergeben möchten. Weitere Informationen finden Sie unter [Einstellungen](/de/settings).258* Sie können Einstellungsdateien für Umgebungsvariablen wie `AWS_PROFILE` verwenden, die Sie nicht an andere Prozesse weitergeben möchten. Weitere Informationen finden Sie unter [Einstellungen](/de/settings).

259 259 

260<h3 id="4-pin-model-versions">260<h3 id="4-pin-model-versions">


262</h3>262</h3>

263 263 

264<Warning>264<Warning>

265 Fixieren Sie spezifische Modellversionen bei der Bereitstellung für mehrere Benutzer. Ohne Fixierung werden Modellaliase wie `sonnet` und `opus` zu Claude Code's integriertem Standard für Bedrock aufgelöst, der hinter der neuesten Version zurückbleiben kann und möglicherweise noch nicht in Ihrem Konto verfügbar ist. Claude Code [fällt beim Start](#startup-model-checks) auf die vorherige Version zurück, wenn der Standard nicht verfügbar ist, aber die Fixierung ermöglicht es Ihnen, zu kontrollieren, wann Ihre Benutzer zu einem neuen Modell wechseln.265 Fixieren Sie spezifische Modellversionen bei der Bereitstellung für mehrere Benutzer. Ohne Fixierung werden Modellaliase wie `sonnet` und `opus` zu Claude Code's integriertem Standard für Amazon Bedrock aufgelöst, der hinter der neuesten Version zurückbleiben kann und möglicherweise noch nicht in Ihrem Konto verfügbar ist. Claude Code [fällt beim Start](#startup-model-checks) auf die vorherige Version zurück, wenn der Standard nicht verfügbar ist, aber die Fixierung ermöglicht es Ihnen, zu kontrollieren, wann Ihre Benutzer zu einem neuen Modell wechseln.

266</Warning>266</Warning>

267 267 

268Legen Sie diese Umgebungsvariablen auf spezifische Bedrock-Modell-IDs fest.268Legen Sie diese Umgebungsvariablen auf spezifische Amazon Bedrock-Modell-IDs fest.

269 269 

270Ohne `ANTHROPIC_DEFAULT_OPUS_MODEL` wird der `opus`-Alias auf Bedrock zu Opus 4.6 aufgelöst. Legen Sie ihn auf die Opus 4.8-ID fest, um das neueste Modell zu verwenden:270Ohne `ANTHROPIC_DEFAULT_OPUS_MODEL` wird der `opus`-Alias auf Amazon Bedrock zu Opus 4.6 aufgelöst. Legen Sie ihn auf die Opus 4.8-ID fest, um das neueste Modell zu verwenden:

271 271 

272```bash theme={null}272```bash theme={null}

273export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'273export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'


284| Primäres Modell | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |284| Primäres Modell | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |

285| Kleines/schnelles Modell | Gleich wie primäres Modell |285| Kleines/schnelles Modell | Gleich wie primäres Modell |

286 286 

287Hintergrundaufgaben wie die Generierung von Sitzungstiteln verwenden das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Auf Bedrock setzt Claude Code dies standardmäßig auf das primäre Modell, da Haiku möglicherweise nicht in jedem Konto oder jeder Region aktiviert ist. Um Haiku für Hintergrundaufgaben zu verwenden, legen Sie `ANTHROPIC_DEFAULT_HAIKU_MODEL` auf eine Modell-ID fest, die in Ihrem Konto verfügbar ist.287Hintergrundaufgaben wie die Generierung von Sitzungstiteln verwenden das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Auf Amazon Bedrock setzt Claude Code dies standardmäßig auf das primäre Modell, da Haiku möglicherweise nicht in jedem Konto oder jeder Region aktiviert ist. Um Haiku für Hintergrundaufgaben zu verwenden, legen Sie `ANTHROPIC_DEFAULT_HAIKU_MODEL` auf eine Modell-ID fest, die in Ihrem Konto verfügbar ist.

288 288 

289Um Modelle weiter anzupassen, verwenden Sie eine dieser Methoden:289Um Modelle weiter anzupassen, verwenden Sie eine dieser Methoden:

290 290 


305 305 

306Die 1-Stunden-Cache-TTL wird mit einer höheren Rate als die 5-Minuten-Standard abgerechnet. Siehe [Cache-Lebensdauer](/de/prompt-caching#cache-lifetime).306Die 1-Stunden-Cache-TTL wird mit einer höheren Rate als die 5-Minuten-Standard abgerechnet. Siehe [Cache-Lebensdauer](/de/prompt-caching#cache-lifetime).

307 307 

308<Note>Prompt Caching ist möglicherweise nicht in allen Bedrock-Regionen verfügbar. Wenn die Cache-Token-Zählungen bei Null bleiben, überprüfen Sie [unterstützte Modelle, Regionen und Limits](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) in der Bedrock-Dokumentation.</Note>308<Note>Prompt Caching ist möglicherweise nicht in allen Amazon Bedrock-Regionen verfügbar. Wenn die Cache-Token-Zählungen bei Null bleiben, überprüfen Sie [unterstützte Modelle, Regionen und Limits](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) in der Amazon Bedrock-Dokumentation.</Note>

309 309 

310<h4 id="map-each-model-version-to-an-inference-profile">310<h4 id="map-each-model-version-to-an-inference-profile">

311 Jede Modellversion einem Inferenzprofil zuordnen311 Jede Modellversion einem Inferenzprofil zuordnen


326}326}

327```327```

328 328 

329Wenn ein Benutzer eine dieser Versionen in `/model` auswählt, ruft Claude Code Bedrock mit dem zugeordneten ARN auf. Versionen ohne Überschreibung fallen auf die integrierte Bedrock-Modell-ID oder ein beliebiges übereinstimmendes Inferenzprofil zurück, das beim Start erkannt wird. Siehe [Modell-IDs pro Version überschreiben](/de/model-config#override-model-ids-per-version) für Details, wie Überschreibungen mit `availableModels` und anderen Modelleinstellungen interagieren.329Wenn ein Benutzer eine dieser Versionen in `/model` auswählt, ruft Claude Code Amazon Bedrock mit dem zugeordneten ARN auf. {/* min-version: 2.1.200 */}Die gleiche Zuordnung gilt, wenn Sie die Anthropic-Modell-ID direkt über `--model` oder `ANTHROPIC_MODEL` übergeben. Versionen ohne Überschreibung fallen auf die integrierte Amazon Bedrock-Modell-ID oder ein beliebiges übereinstimmendes Inferenzprofil zurück, das beim Start erkannt wird. Vor v2.1.200 erreichten `--model`- und `ANTHROPIC_MODEL`-Werte Amazon Bedrock unverändert, ohne die Überschreibungszuordnung zu durchlaufen. Siehe [Modell-IDs pro Version überschreiben](/de/model-config#override-model-ids-per-version) für Details, wie Überschreibungen mit `availableModels` und anderen Modelleinstellungen interagieren.

330 330 

331<h2 id="startup-model-checks">331<h2 id="startup-model-checks">

332 Startup-Modellprüfungen332 Startup-Modellprüfungen

333</h2>333</h2>

334 334 

335Wenn Claude Code mit konfiguriertem Bedrock startet, überprüft es, dass die Modelle, die es verwenden möchte, in Ihrem Konto zugänglich sind. Diese Prüfung erfordert Claude Code v2.1.94 oder später.335Wenn Claude Code mit konfiguriertem Amazon Bedrock startet, überprüft es, dass die Modelle, die es verwenden möchte, in Ihrem Konto zugänglich sind. Diese Prüfung erfordert Claude Code v2.1.94 oder später.

336 336 

337Wenn Sie eine Modellversion fixiert haben, die älter ist als der aktuelle Claude Code-Standard, und Ihr Konto die neuere Version aufrufen kann, fordert Claude Code Sie auf, die Fixierung zu aktualisieren. Das Akzeptieren schreibt die neue Modell-ID in Ihre [Benutzereinstellungsdatei](/de/settings) und startet Claude Code neu. Das Ablehnen wird bis zur nächsten Standardversionänderung beibehalten. Fixierungen, die auf einen [Anwendungsinferenzprofil-ARN](#map-each-model-version-to-an-inference-profile) verweisen, werden übersprungen, da diese von Ihrem Administrator verwaltet werden.337Wenn Sie eine Modellversion fixiert haben, die älter ist als der aktuelle Claude Code-Standard, und Ihr Konto die neuere Version aufrufen kann, fordert Claude Code Sie auf, die Fixierung zu aktualisieren. Das Akzeptieren schreibt die neue Modell-ID in Ihre [Benutzereinstellungsdatei](/de/settings) und startet Claude Code neu. Das Ablehnen wird bis zur nächsten Standardversionänderung beibehalten. Fixierungen, die auf einen [Anwendungsinferenzprofil-ARN](#map-each-model-version-to-an-inference-profile) verweisen, werden übersprungen, da diese von Ihrem Administrator verwaltet werden.

338 338 

339Wenn Sie ein Modell nicht fixiert haben und der aktuelle Standard in Ihrem Konto nicht verfügbar ist, fällt Claude Code für die aktuelle Sitzung auf die vorherige Version zurück und zeigt einen Hinweis an. Das Fallback wird nicht beibehalten. Aktivieren Sie das neuere Modell in Ihrem Bedrock-Konto oder [fixieren Sie eine Version](#4-pin-model-versions), um die Auswahl dauerhaft zu machen.339Wenn Sie ein Modell nicht fixiert haben und der aktuelle Standard in Ihrem Konto nicht verfügbar ist, fällt Claude Code für die aktuelle Sitzung auf die vorherige Version zurück und zeigt einen Hinweis an. Das Fallback wird nicht beibehalten. Aktivieren Sie das neuere Modell in Ihrem Amazon Bedrock-Konto oder [fixieren Sie eine Version](#4-pin-model-versions), um die Auswahl dauerhaft zu machen.

340 340 

341<h2 id="iam-configuration">341<h2 id="iam-configuration">

342 IAM-Konfiguration342 IAM-Konfiguration


433 Verwenden Sie den Mantle-Endpunkt433 Verwenden Sie den Mantle-Endpunkt

434</h2>434</h2>

435 435 

436Mantle ist ein Amazon Bedrock-Endpunkt, der Claude-Modelle über die native Anthropic API-Form statt über die Bedrock Invoke API bereitstellt. Er verwendet die gleichen AWS-Anmeldedaten, IAM-Berechtigungen und `awsAuthRefresh`-Konfiguration, die weiter oben auf dieser Seite beschrieben sind.436Mantle ist ein Amazon Bedrock-Endpunkt, der Claude-Modelle über die native Anthropic API-Form statt über die Amazon Bedrock Invoke API bereitstellt. Er verwendet die gleichen AWS-Anmeldedaten, IAM-Berechtigungen und `awsAuthRefresh`-Konfiguration, die weiter oben auf dieser Seite beschrieben sind.

437 437 

438<Note>438<Note>

439 Mantle erfordert Claude Code v2.1.94 oder später. Führen Sie `claude --version` aus, um zu überprüfen.439 Mantle erfordert Claude Code v2.1.94 oder später. Führen Sie `claude --version` aus, um zu überprüfen.


450export AWS_REGION=us-east-1450export AWS_REGION=us-east-1

451```451```

452 452 

453Claude Code erstellt die Endpunkt-URL aus der AWS-Region. {/* min-version: 2.1.172 */}Ab v2.1.172 wird die Region mit der gleichen Priorität aufgelöst wie [Bedrock oben](#3-configure-claude-code); frühere Versionen verwenden nur `AWS_REGION`. Um die URL für einen benutzerdefinierten Endpunkt oder ein Gateway zu überschreiben, legen Sie `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` fest.453Claude Code erstellt die Endpunkt-URL aus der AWS-Region. {/* min-version: 2.1.172 */}Ab v2.1.172 wird die Region mit der gleichen Priorität aufgelöst wie [Amazon Bedrock oben](#3-configure-claude-code); frühere Versionen verwenden nur `AWS_REGION`. Um die URL für einen benutzerdefinierten Endpunkt oder ein Gateway zu überschreiben, legen Sie `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` fest.

454 454 

455Führen Sie `/status` in Claude Code aus, um zu bestätigen. Die Provider-Zeile zeigt `Amazon Bedrock (Mantle)`, wenn Mantle aktiv ist.455Führen Sie `/status` in Claude Code aus, um zu bestätigen. Die Provider-Zeile zeigt `Amazon Bedrock (Mantle)`, wenn Mantle aktiv ist.

456 456 


470 Führen Sie Mantle neben der Invoke API aus470 Führen Sie Mantle neben der Invoke API aus

471</h3>471</h3>

472 472 

473Die Modelle, die Ihnen auf Mantle zur Verfügung stehen, enthalten möglicherweise nicht alle Modelle, die Sie heute verwenden. Das Setzen von `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_MANTLE` ermöglicht es Claude Code, beide Endpunkte aus derselben Sitzung aufzurufen. Modell-IDs, die dem Mantle-Format entsprechen, werden zu Mantle weitergeleitet, und alle anderen Modell-IDs gehen zur Bedrock Invoke API.473Die Modelle, die Ihnen auf Mantle zur Verfügung stehen, enthalten möglicherweise nicht alle Modelle, die Sie heute verwenden. Das Setzen von `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_MANTLE` ermöglicht es Claude Code, beide Endpunkte aus derselben Sitzung aufzurufen. Modell-IDs, die dem Mantle-Format entsprechen, werden zu Mantle weitergeleitet, und alle anderen Modell-IDs gehen zur Amazon Bedrock Invoke API.

474 474 

475```bash theme={null}475```bash theme={null}

476export CLAUDE_CODE_USE_BEDROCK=1476export CLAUDE_CODE_USE_BEDROCK=1


508Diese Variablen sind spezifisch für den Mantle-Endpunkt. Siehe [Umgebungsvariablen](/de/env-vars) für die vollständige Liste.508Diese Variablen sind spezifisch für den Mantle-Endpunkt. Siehe [Umgebungsvariablen](/de/env-vars) für die vollständige Liste.

509 509 

510| Variable | Zweck |510| Variable | Zweck |

511| :-------------------------------------- | :----------------------------------------------------------------------------------- |511| :-------------------------------------- | :------------------------------------------------------------------------------------------ |

512| `CLAUDE_CODE_USE_MANTLE` | Aktivieren Sie den Mantle-Endpunkt. Legen Sie auf `1` oder `true` fest. |512| `CLAUDE_CODE_USE_MANTLE` | Aktivieren Sie den Mantle-Endpunkt. Legen Sie auf `1` oder `true` fest. |

513| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreiben Sie die Standard-Mantle-Endpunkt-URL |513| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreiben Sie die Standard-Mantle-Endpunkt-URL |

514| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Überspringen Sie die clientseitige Authentifizierung für Proxy-Setups |514| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Überspringen Sie die clientseitige Authentifizierung für Proxy-Setups |

515| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Überschreiben Sie die AWS-Region für das Haiku-Klasse-Modell (gemeinsam mit Bedrock) |515| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Überschreiben Sie die AWS-Region für das Haiku-Klasse-Modell (gemeinsam mit Amazon Bedrock) |

516 516 

517<h2 id="troubleshooting">517<h2 id="troubleshooting">

518 Fehlerbehebung518 Fehlerbehebung


540 540 

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

542 542 

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

544 544 

545<h3 id="zero-token-counts-in-/context">545<h3 id="zero-token-counts-in-/context">

546 Null-Token-Zählungen in /context546 Null-Token-Zählungen in /context

547</h3>547</h3>

548 548 

549Der `/context`-Befehl zählt Token für jede Tool-Gruppe, indem die Tool-Schemas an die Bedrock-API zum Zählen von Tokens gesendet werden. {/* min-version: 2.1.196 */}Bei Claude Code-Versionen vor v2.1.196 lehnte Bedrock diese Anfrage ab, da die Schemas Felder enthielten, die die API zum Zählen von Tokens nicht akzeptiert, sodass jede Tool-Gruppe 0 Tokens anzeigte. Andere Zeilen in der Aufschlüsselung, wie Nachrichten und Speicherdateien, sind nicht betroffen.549Der `/context`-Befehl zählt Token für jede Tool-Gruppe, indem die Tool-Schemas an die Amazon Bedrock-API zum Zählen von Tokens gesendet werden. {/* min-version: 2.1.196 */}Bei Claude Code-Versionen vor v2.1.196 lehnte Amazon Bedrock diese Anfrage ab, da die Schemas Felder enthielten, die die API zum Zählen von Tokens nicht akzeptiert, sodass jede Tool-Gruppe 0 Tokens anzeigte. Andere Zeilen in der Aufschlüsselung, wie Nachrichten und Speicherdateien, sind nicht betroffen.

550 550 

551Aktualisieren Sie auf v2.1.196 oder später.551Aktualisieren Sie auf v2.1.196 oder später.

552 552 


558 558 

559Ein `403` vom Mantle-Endpunkt mit gültigen Anmeldedaten bedeutet, dass Ihrem AWS-Konto kein Zugriff auf das angeforderte Modell gewährt wurde. Wenden Sie sich an Ihr AWS-Kontoteam, um Zugriff anzufordern.559Ein `403` vom Mantle-Endpunkt mit gültigen Anmeldedaten bedeutet, dass Ihrem AWS-Konto kein Zugriff auf das angeforderte Modell gewährt wurde. Wenden Sie sich an Ihr AWS-Kontoteam, um Zugriff anzufordern.

560 560 

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

562 562 

563<h2 id="additional-resources">563<h2 id="additional-resources">

564 Zusätzliche Ressourcen564 Zusätzliche Ressourcen

565</h2>565</h2>

566 566 

567* [Bedrock-Dokumentation](https://docs.aws.amazon.com/bedrock/)567* [Amazon Bedrock-Dokumentation](https://docs.aws.amazon.com/bedrock/)

568* [Bedrock-Preisgestaltung](https://aws.amazon.com/bedrock/pricing/)568* [Amazon Bedrock-Preisgestaltung](https://aws.amazon.com/bedrock/pricing/)

569* [Bedrock-Inferenzprofile](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)569* [Amazon Bedrock-Inferenzprofile](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)

570* [Bedrock-Token-Burndown und Kontingente](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)570* [Amazon Bedrock-Token-Burndown und Kontingente](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)

571* [Claude Code auf Amazon Bedrock: Schnellstartanleitung](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)571* [Claude Code auf Amazon Bedrock: Schnellstartanleitung](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)

572* [Claude Code Monitoring Implementation (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)572* [Claude Code Monitoring Implementation (Amazon Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)

Details

6 6 

7> Melden Sie sich bei Claude Code an und konfigurieren Sie die Authentifizierung für Einzelpersonen, Teams und Organisationen.7> Melden Sie sich bei Claude Code an und konfigurieren Sie die Authentifizierung für Einzelpersonen, Teams und Organisationen.

8 8 

9Claude Code unterstützt mehrere Authentifizierungsmethoden je nach Ihrer Einrichtung. Einzelne Benutzer können sich mit einem Claude.ai-Konto anmelden, während Teams Claude for Teams oder Enterprise, die Claude Console oder einen Cloud-Anbieter wie Amazon Bedrock, Google Vertex AI oder Microsoft Foundry verwenden können.9Claude Code unterstützt mehrere Authentifizierungsmethoden je nach Ihrer Einrichtung. Einzelne Benutzer können sich mit einem Claude.ai-Konto anmelden, während Teams Claude for Teams oder Enterprise, die Claude Console oder einen Cloud-Anbieter wie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verwenden können.

10 10 

11<h2 id="log-in-to-claude-code">11<h2 id="log-in-to-claude-code">

12 Melden Sie sich bei Claude Code an12 Melden Sie sich bei Claude Code an


23* **Claude Pro oder Max Abonnement**: Melden Sie sich mit Ihrem Claude.ai-Konto an. Abonnieren Sie unter [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).23* **Claude Pro oder Max Abonnement**: Melden Sie sich mit Ihrem Claude.ai-Konto an. Abonnieren Sie unter [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

24* **Claude for Teams oder Enterprise**: Melden Sie sich mit dem Claude.ai-Konto an, zu dem Sie Ihr Team-Administrator eingeladen hat.24* **Claude for Teams oder Enterprise**: Melden Sie sich mit dem Claude.ai-Konto an, zu dem Sie Ihr Team-Administrator eingeladen hat.

25* **Claude Console**: Melden Sie sich mit Ihren Console-Anmeldedaten an. Ihr Administrator muss Sie zunächst [eingeladen haben](#claude-console-authentication).25* **Claude Console**: Melden Sie sich mit Ihren Console-Anmeldedaten an. Ihr Administrator muss Sie zunächst [eingeladen haben](#claude-console-authentication).

26* **Cloud-Anbieter**: Wenn Ihre Organisation [Amazon Bedrock](/de/amazon-bedrock), [Google Vertex AI](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) verwendet, legen Sie die erforderlichen Umgebungsvariablen fest, bevor Sie `claude` ausführen. Es ist keine Browser-Anmeldung erforderlich.26* **Cloud-Anbieter**: Wenn Ihre Organisation [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) verwendet, legen Sie die erforderlichen Umgebungsvariablen fest, bevor Sie `claude` ausführen. Es ist keine Browser-Anmeldung erforderlich.

27* **Cloud-Gateway**: Wenn Ihre Organisation ein selbstgehostetes [Claude Apps Gateway](/de/claude-apps-gateway) betreibt, melden Sie sich über `/login` mit Corporate SSO an. Das vom Gateway ausgegebene Token ist die einzige Anmeldeinformation der Sitzung.27* **Cloud-Gateway**: Wenn Ihre Organisation ein selbstgehostetes [Claude Apps Gateway](/de/claude-apps-gateway) betreibt, melden Sie sich über `/login` mit Corporate SSO an. Das vom Gateway ausgegebene Token ist die einzige Anmeldeinformation der Sitzung.

28 28 

29Um sich abzumelden und sich erneut zu authentifizieren, geben Sie `/logout` an der Claude Code-Eingabeaufforderung ein.29Um sich abzumelden und sich erneut zu authentifizieren, geben Sie `/logout` an der Claude Code-Eingabeaufforderung ein.


40* [Claude Console](#claude-console-authentication)40* [Claude Console](#claude-console-authentication)

41* [Claude apps gateway](/de/claude-apps-gateway), ein selbst gehostetes Gateway, das Entwickler mit Ihrem IdP anmeldet und Inferenzen an den von Ihnen konfigurierten Cloud-Anbieter weiterleitet41* [Claude apps gateway](/de/claude-apps-gateway), ein selbst gehostetes Gateway, das Entwickler mit Ihrem IdP anmeldet und Inferenzen an den von Ihnen konfigurierten Cloud-Anbieter weiterleitet

42* [Amazon Bedrock](/de/amazon-bedrock)42* [Amazon Bedrock](/de/amazon-bedrock)

43* [Google Vertex AI](/de/google-vertex-ai)43* [Google Cloud's Agent Platform](/de/google-vertex-ai)

44* [Microsoft Foundry](/de/microsoft-foundry)44* [Microsoft Foundry](/de/microsoft-foundry)

45 45 

46<h3 id="claude-for-teams-or-enterprise">46<h3 id="claude-for-teams-or-enterprise">


105 Cloud-Anbieter-Authentifizierung105 Cloud-Anbieter-Authentifizierung

106</h3>106</h3>

107 107 

108Für Teams, die Amazon Bedrock, Google Vertex AI oder Microsoft Foundry verwenden:108Für Teams, die Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verwenden:

109 109 

110<Steps>110<Steps>

111 <Step title="Befolgen Sie die Anbieter-Einrichtung">111 <Step title="Befolgen Sie die Anbieter-Einrichtung">

112 Befolgen Sie die [Bedrock-Dokumentation](/de/amazon-bedrock), [Vertex-Dokumentation](/de/google-vertex-ai) oder [Microsoft Foundry-Dokumentation](/de/microsoft-foundry).112 Befolgen Sie die [Amazon Bedrock-Dokumentation](/de/amazon-bedrock), [Google Cloud's Agent Platform-Dokumentation](/de/google-vertex-ai) oder [Microsoft Foundry-Dokumentation](/de/microsoft-foundry).

113 </Step>113 </Step>

114 114 

115 <Step title="Verteilen Sie die Konfiguration">115 <Step title="Verteilen Sie die Konfiguration">


140 140 

141`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 [von der Organisation verteilte Inferenzkonfiguration eines Drittanbieters](/de/llm-gateway-connect#desktop-app) ausführen, die sich mit den Anmeldedaten dieser Konfiguration authentifizieren.141`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 [von der Organisation verteilte Inferenzkonfiguration eines Drittanbieters](/de/llm-gateway-connect#desktop-app) ausführen, die sich mit den Anmeldedaten dieser Konfiguration authentifizieren.

142 142 

143<h3 id="renew-an-expiring-login">

144 Ablauf einer Anmeldung erneuern

145</h3>

146 

147Wenn die Anmeldung, die Sie mit `/login` erstellt haben, innerhalb von fünf 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.

148 

149Fü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.

150 

151Die 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.

152 

153Eine frühzeitige Erneuerung ist am wichtigsten für Sitzungen, die unbeaufsichtigt ausgeführt werden. Eine [Hintergrundsitzung in der Agent-Ansicht](/de/agent-view) oder eine [Remote Control](/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.

154 

143<h3 id="authentication-precedence">155<h3 id="authentication-precedence">

144 Authentifizierungspriorität156 Authentifizierungspriorität

145</h3>157</h3>


1535. `CLAUDE_CODE_OAUTH_TOKEN` Umgebungsvariable. Ein langlebiges OAuth-Token, das von [`claude setup-token`](#generate-a-long-lived-token) generiert wird. Verwenden Sie dies für CI-Pipelines und Skripte, bei denen Browser-Anmeldung nicht verfügbar ist.1655. `CLAUDE_CODE_OAUTH_TOKEN` Umgebungsvariable. Ein langlebiges OAuth-Token, das von [`claude setup-token`](#generate-a-long-lived-token) generiert wird. Verwenden Sie dies für CI-Pipelines und Skripte, bei denen Browser-Anmeldung nicht verfügbar ist.

1546. Abonnement-OAuth-Anmeldedaten von `/login`. Dies ist die Standardeinstellung für Claude Pro, Max, Team und Enterprise-Benutzer.1666. Abonnement-OAuth-Anmeldedaten von `/login`. Dies ist die Standardeinstellung für Claude Pro, Max, Team und Enterprise-Benutzer.

155 167 

156Eine angemeldete [Claude Apps Gateway](/de/claude-apps-gateway) Sitzung steht außerhalb dieser Liste: Sie ist eine Anbieterauswahl wie Bedrock oder Vertex 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 die Bearer-Token-, API-Schlüssel- und `apiKeyHelper`-Einträge oben werden nicht verwendet.168Eine angemeldete [Claude Apps Gateway](/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 die Bearer-Token-, API-Schlüssel- und `apiKeyHelper`-Einträge oben werden nicht verwendet.

157 169 

158Wenn Sie ein aktives Claude-Abonnement haben, aber auch `ANTHROPIC_API_KEY` in Ihrer Umgebung gesetzt haben, hat der API-Schlüssel Vorrang, sobald er genehmigt ist. Dies kann zu Authentifizierungsfehlern führen, wenn der Schlüssel zu einer deaktivierten oder abgelaufenen Organisation gehört. Führen Sie `unset ANTHROPIC_API_KEY` aus, um auf Ihr Abonnement zurückzugreifen, und überprüfen Sie `/status`, um zu bestätigen, welche Methode aktiv ist.170Wenn Sie ein aktives Claude-Abonnement haben, aber auch `ANTHROPIC_API_KEY` in Ihrer Umgebung gesetzt haben, hat der API-Schlüssel Vorrang, sobald er genehmigt ist. Dies kann zu Authentifizierungsfehlern führen, wenn der Schlüssel zu einer deaktivierten oder abgelaufenen Organisation gehört. Führen Sie `unset ANTHROPIC_API_KEY` aus, um auf Ihr Abonnement zurückzugreifen, und überprüfen Sie `/status`, um zu bestätigen, welche Methode aktiv ist.

159 171 

Details

9[Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) ermöglicht es Claude Code, ohne routinemäßige Berechtigungsaufforderungen zu laufen, indem Tool-Aufrufe 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](/de/permission-modes#eliminate-prompts-with-auto-mode) ermöglicht es Claude Code, ohne routinemäßige Berechtigungsaufforderungen zu laufen, indem Tool-Aufrufe 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 der Anthropic API verfügbar. Bei Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry und angemeldeten [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzungen müssen Sie zunächst [`CLAUDE_CODE_ENABLE_AUTO_MODE`](/de/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry) festlegen. Wenn Claude Code meldet, dass Auto-Modus für Ihr Konto nicht verfügbar ist, überprüfen Sie die [vollständigen Anforderungen](/de/permission-modes#eliminate-prompts-with-auto-mode), die auch die unterstützten Modelle und die Owner-Aktivierung auf Team- und Enterprise-Plänen abdecken.12 Auto-Modus ist für alle Benutzer auf der Anthropic API verfügbar. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzungen müssen Sie zunächst [`CLAUDE_CODE_ENABLE_AUTO_MODE`](/de/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) festlegen. Wenn Claude Code meldet, dass Auto-Modus für Ihr Konto nicht verfügbar ist, überprüfen Sie die [vollständigen Anforderungen](/de/permission-modes#eliminate-prompts-with-auto-mode), die auch die unterstützten Modelle und die Owner-Aktivierung auf Team- und Enterprise-Plänen abdecken.

13</Note>13</Note>

14 14 

15Standardmäßig vertraut der Klassifizierer nur dem Arbeitsverzeichnis und den konfigurierten Remotes des aktuellen Repos. Aktionen wie das Pushen zu Ihrer Unternehmens-Quellcode-Verwaltungsorganisation oder das Schreiben in einen Team-Cloud-Bucket werden blockiert, bis Sie sie zu `autoMode.environment` hinzufügen.15Standardmäßig vertraut der Klassifizierer nur dem Arbeitsverzeichnis und den konfigurierten Remotes des aktuellen Repos. Aktionen wie das Pushen zu Ihrer Unternehmens-Quellcode-Verwaltungsorganisation oder das Schreiben in einen Team-Cloud-Bucket werden blockiert, bis Sie sie zu `autoMode.environment` hinzufügen.


59 * **Organisation**59 * **Organisation**

60 * **Primäre Verwendung von Claude Code**: wird standardmäßig auf Softwareentwicklung gesetzt60 * **Primäre Verwendung von Claude Code**: wird standardmäßig auf Softwareentwicklung gesetzt

61 * **Cloud-Anbieter**61 * **Cloud-Anbieter**

62 * **Repository-Sichtbarkeit**: Ein Repository wird als privat angenommen, es sei denn, sein Remote-Host und Name deuten anderweitig darauf hin62 * **Repository-Sichtbarkeit**: Ein Repository wird als privat angenommen, es sei denn, sein Remote-Host und Name deuten anderweitig darauf hin, {/* min-version: 2.1.200 */}oder eine Sichtbarkeitsprüfung früher in der Konversation, die der Klassifizierer liest, zeigt, dass es öffentlich ist. Der Klassifizierer liest Ihre Nachrichten und die Befehle, die Claude ausführt, nicht deren Ausgabe, daher muss der Beweis etwas sein, das er lesen kann, wie Ihre eigene Nachricht, die das Repository als öffentlich benennt; die Ausgabe eines `gh repo view` allein erreicht ihn nicht. Die Transkript-Evidenz-Überprüfung erfordert Claude Code v2.1.200 oder später

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

64 * **Organisationsspezifische CLIs**64 * **Organisationsspezifische CLIs**

65 * **Secrets-Verwaltung**65 * **Secrets-Verwaltung**


68 * **Netzwerk-Lage**68 * **Netzwerk-Lage**

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

70 * **Datenspeicherung / Klassifizierungsaufhebung**70 * **Datenspeicherung / Klassifizierungsaufhebung**

71* **Vertrauens-Slots**: benennen, was der Klassifizierer als innerhalb Ihrer Grenze behandelt. Die Slots sind Vertrauenswürdiges Repo, Quellcode-Verwaltung, Vertrauenswürdige interne Domains, Vertrauenswürdige Cloud-Buckets, Wichtige interne Services und Interne Paket-Registry. Die Repo- und Quellcode-Verwaltungseinträge werden standardmäßig auf das Arbeits-Repo und seine konfigurierten Remotes gesetzt. Jeder andere Vertrauens-Slot wird standardmäßig auf `Keine konfiguriert` gesetzt, daher wird nichts anderes vertraut, bis Sie es hinzufügen.71* **Vertrauens-Slots**: benennen, was der Klassifizierer als innerhalb Ihrer Grenze behandelt. Die Slots sind Vertrauenswürdiges Repo, Quellcode-Verwaltung, Vertrauenswürdige interne Domains, Vertrauenswürdige Cloud-Buckets, Wichtige interne Services und Interne Paket-Registry. Die Repo- und Quellcode-Verwaltungseinträge werden standardmäßig auf das Arbeits-Repo und seine konfigurierten Remotes gesetzt. Jeder andere Vertrauens-Slot wird standardmäßig auf `Keine konfiguriert` gesetzt, daher wird nichts anderes vertraut, bis Sie es hinzufügen. {/* min-version: 2.1.203 */}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 löscht niemals Geheimnisse oder persönliche oder anvertraute Daten darin, und der Klassifizierer behandelt Inhalte, die von außerhalb des Arbeits-Repositorys portiert, umgeleitet oder zuerst gelesen werden, als nicht die eigene Arbeit dieses Repositorys. Diese Scoping-Anforderung erfordert Claude Code v2.1.203 oder später.

72* **Sensitivitäts-Slots**: benennen, was die Schutzregeln als hochriskant behandeln. Die Slots sind Sensible Datenspeicherorte & Zielgruppen, Sensible Remote-Ziele und Geschützte IaC-Bereiche. Jeder wird standardmäßig auf eine breite Heuristik gesetzt, wie z. B. die Behandlung eines Hosts oder Namespace, dessen Name `prod` oder `production` trägt, als sensibles Remote-Ziel, daher sind die Schutzregeln aktiv, bevor Sie etwas konfigurieren. Das Benennen konkreter Ziele in einem Sensitivitäts-Slot lässt diese Regeln auf die benannten Ziele anstelle der Heuristik angewendet werden.72* **Sensitivitäts-Slots**: benennen, was die Schutzregeln als hochriskant behandeln. Die Slots sind Sensible Datenspeicherorte & Zielgruppen, Sensible Remote-Ziele und Geschützte IaC-Bereiche. Jeder wird standardmäßig auf eine breite Heuristik gesetzt, wie z. B. die Behandlung eines Hosts oder Namespace, dessen Name `prod` oder `production` trägt, als sensibles Remote-Ziel, daher sind die Schutzregeln aktiv, bevor Sie etwas konfigurieren. Das Benennen konkreter Ziele in einem Sensitivitäts-Slot lässt diese Regeln auf die benannten Ziele anstelle der Heuristik angewendet werden.

73 73 

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

channels.md +1 −1

Details

7> Verwenden Sie Kanäle, um Nachrichten, Benachrichtigungen und Webhooks von einem MCP-Server in Ihre Claude Code-Sitzung zu übertragen. Leiten Sie CI-Ergebnisse, Chat-Nachrichten und Überwachungsereignisse weiter, damit Claude reagieren kann, während Sie weg sind.7> Verwenden Sie Kanäle, um Nachrichten, Benachrichtigungen und Webhooks von einem MCP-Server in Ihre Claude Code-Sitzung zu übertragen. Leiten Sie CI-Ergebnisse, Chat-Nachrichten und Überwachungsereignisse weiter, damit Claude reagieren kann, während Sie weg sind.

8 8 

9<Note>9<Note>

10 Kanäle befinden sich in der [Forschungsvorschau](#research-preview) und erfordern Claude Code v2.1.80 oder später. Sie erfordern eine Anthropic-Authentifizierung über claude.ai oder einen Console-API-Schlüssel und sind nicht auf Amazon Bedrock, Google Vertex AI oder Microsoft Foundry verfügbar. Team- und Enterprise-Organisationen müssen [sie explizit aktivieren](#enterprise-controls).10 Kanäle befinden sich in der [Forschungsvorschau](#research-preview) und erfordern Claude Code v2.1.80 oder später. Sie erfordern eine Anthropic-Authentifizierung über claude.ai oder einen Console-API-Schlüssel und sind nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar. Team- und Enterprise-Organisationen müssen [sie explizit aktivieren](#enterprise-controls).

11</Note>11</Note>

12 12 

13Ein Kanal ist ein MCP-Server, der Ereignisse in Ihre laufende Claude Code-Sitzung überträgt, damit Claude auf Dinge reagieren kann, die passieren, während Sie nicht am Terminal sind. Kanäle können bidirektional sein: Claude liest das Ereignis und antwortet über denselben Kanal zurück, wie eine Chat-Brücke. Ereignisse treffen nur ein, während die Sitzung offen ist. Für ein Always-On-Setup führen Sie Claude in einem Hintergrundprozess oder persistenten Terminal aus.13Ein Kanal ist ein MCP-Server, der Ereignisse in Ihre laufende Claude Code-Sitzung überträgt, damit Claude auf Dinge reagieren kann, die passieren, während Sie nicht am Terminal sind. Kanäle können bidirektional sein: Claude liest das Ereignis und antwortet über denselben Kanal zurück, wie eine Chat-Brücke. Ereignisse treffen nur ein, während die Sitzung offen ist. Für ein Always-On-Setup führen Sie Claude in einem Hintergrundprozess oder persistenten Terminal aus.

Details

36* **Chat-Plattformen** (Telegram, Discord): Ihr Plugin läuft lokal und fragt die API der Plattform nach neuen Nachrichten ab. Wenn jemand Ihrem Bot eine Direktnachricht sendet, empfängt das Plugin die Nachricht und leitet sie an Claude weiter. Keine URL zum Bereitstellen erforderlich.36* **Chat-Plattformen** (Telegram, Discord): Ihr Plugin läuft lokal und fragt die API der Plattform nach neuen Nachrichten ab. Wenn jemand Ihrem Bot eine Direktnachricht sendet, empfängt das Plugin die Nachricht und leitet sie an Claude weiter. Keine URL zum Bereitstellen erforderlich.

37* **Webhooks** (CI, Überwachung): Ihr Server lauscht auf einem lokalen HTTP-Port. Externe Systeme POSTen an diesen Port, und Ihr Server pusht die Payload an Claude.37* **Webhooks** (CI, Überwachung): Ihr Server lauscht auf einem lokalen HTTP-Port. Externe Systeme POSTen an diesen Port, und Ihr Server pusht die Payload an Claude.

38 38 

39<img src="https://mintlify.s3.us-west-1.amazonaws.com/claude-code/de/images/channel-architecture.svg" alt="Architekturdiagramm, das externe Systeme zeigt, die sich mit Ihrem lokalen Channel-Server verbinden, der über stdio mit Claude Code kommuniziert" />39<img src="https://mintcdn.com/claude-code/9FG0ZKj9uKYiHmbi/images/channel-architecture.svg?fit=max&auto=format&n=9FG0ZKj9uKYiHmbi&q=85&s=9a037b7da80184ae49015c0256b21a1f" alt="Architekturdiagramm, das externe Systeme zeigt, die sich mit Ihrem lokalen Channel-Server verbinden, der über stdio mit Claude Code kommuniziert" width="600" height="220" data-path="images/channel-architecture.svg" />

40 40 

41<h2 id="what-you-need">41<h2 id="what-you-need">

42 Was Sie benötigen42 Was Sie benötigen


474 474 

475Der lokale Terminal-Dialog bleibt während all dessen offen. Wenn jemand am Terminal antwortet, bevor das Remote-Urteil ankommt, wird diese Antwort stattdessen angewendet und die ausstehende Remote-Anfrage wird gelöscht.475Der lokale Terminal-Dialog bleibt während all dessen offen. Wenn jemand am Terminal antwortet, bevor das Remote-Urteil ankommt, wird diese Antwort stattdessen angewendet und die ausstehende Remote-Anfrage wird gelöscht.

476 476 

477<img src="https://mintlify.s3.us-west-1.amazonaws.com/claude-code/de/images/channel-permission-relay.svg" alt="Sequenzdiagramm: Claude Code sendet eine permission_request-Benachrichtigung an den Channel-Server, der Server formatiert und sendet den Prompt an die Chat-App, der Mensch antwortet mit einem Urteil, und der Server analysiert diese Antwort in eine Berechtigungsbenachrichtigung zurück an Claude Code" />477<img src="https://mintcdn.com/claude-code/9FG0ZKj9uKYiHmbi/images/channel-permission-relay.svg?fit=max&auto=format&n=9FG0ZKj9uKYiHmbi&q=85&s=97d57f128f0da55f105ab1e3a7e10240" alt="Sequenzdiagramm: Claude Code sendet eine permission_request-Benachrichtigung an den Channel-Server, der Server formatiert und sendet den Prompt an die Chat-App, der Mensch antwortet mit einem Urteil, und der Server analysiert diese Antwort in eine Berechtigungsbenachrichtigung zurück an Claude Code" width="600" height="230" data-path="images/channel-permission-relay.svg" />

478 478 

479<h3 id="permission-request-fields">479<h3 id="permission-request-fields">

480 Berechtigungsanfrage-Felder480 Berechtigungsanfrage-Felder

chrome.md +1 −1

Details

40* Einen direkten Anthropic-Plan (Pro, Max, Team oder Enterprise)40* Einen direkten Anthropic-Plan (Pro, Max, Team oder Enterprise)

41 41 

42<Note>42<Note>

43 Die Chrome-Integration ist nicht über Drittanbieter wie Amazon Bedrock, Google Cloud Vertex AI oder Microsoft Foundry verfügbar. Wenn Sie Claude ausschließlich über einen Drittanbieter nutzen, benötigen Sie ein separates claude.ai-Konto, um diese Funktion zu verwenden.43 Die Chrome-Integration ist nicht über Drittanbieter wie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar. Wenn Sie Claude ausschließlich über einen Drittanbieter nutzen, benötigen Sie ein separates claude.ai-Konto, um diese Funktion zu verwenden.

44</Note>44</Note>

45 45 

46<h2 id="get-started-in-the-cli">46<h2 id="get-started-in-the-cli">

Details

4 4 

5# Claude Apps Gateway-Konfiguration5# Claude Apps Gateway-Konfiguration

6 6 

7> Referenz für jede gateway.yaml-Option: Listener und TLS, OIDC, Session, Postgres-Speicher, Bedrock/Claude Platform auf AWS/Agent Platform/Foundry-Upstreams, Modellrouting, verwaltete Richtlinien und Telemetrie.7> Referenz für jede gateway.yaml-Option: Listener und TLS, OIDC, Session, Postgres-Speicher, Amazon Bedrock, Claude Platform auf AWS, Google Cloud's Agent Platform und Microsoft Foundry-Upstreams, Modellrouting, verwaltete Richtlinien und Telemetrie.

8 8 

9Eine Claude Apps Gateway-Bereitstellung wird durch eine YAML-Datei konfiguriert, üblicherweise `gateway.yaml`. Die Datei definiert alles, was das Gateway tut: wo es lauscht, wie sich Entwickler anmelden, wohin Inferenz geht und welche Richtlinien und Telemetrie gelten. Diese Seite ist die Referenz für jede Option in dieser Datei.9Eine Claude Apps Gateway-Bereitstellung wird durch eine YAML-Datei konfiguriert, üblicherweise `gateway.yaml`. Die Datei definiert alles, was das Gateway tut: wo es lauscht, wie sich Entwickler anmelden, wohin Inferenz geht und welche Richtlinien und Telemetrie gelten. Diese Seite ist die Referenz für jede Option in dieser Datei.

10 10 


26* [`oidc`](#oidc): Ihr Identitätsanbieter (IdP), einschließlich Aussteller, Client, Anspruchszuordnung und wer sich anmelden darf26* [`oidc`](#oidc): Ihr Identitätsanbieter (IdP), einschließlich Aussteller, Client, Anspruchszuordnung und wer sich anmelden darf

27* [`session`](#session): die Bearer-Token, die das Gateway ausstellt, mit Geheimnis und Lebensdauer27* [`session`](#session): die Bearer-Token, die das Gateway ausstellt, mit Geheimnis und Lebensdauer

28* [`store`](#store): PostgreSQL, für Gerätezuschüsse und Rate-Limit-Zähler28* [`store`](#store): PostgreSQL, für Gerätezuschüsse und Rate-Limit-Zähler

29* [`upstreams`](#upstreams): wohin Inferenz geht, ob Anthropic, Bedrock, Claude Platform auf AWS, Agent Platform oder Foundry29* [`upstreams`](#upstreams): wohin Inferenz geht, ob Anthropic, Amazon Bedrock, Claude Platform auf AWS, Agent Platform von Google Cloud oder Microsoft Foundry

30 30 

31**Optionale Abschnitte:**31**Optionale Abschnitte:**

32 32 


408 `models`408 `models`

409</h3>409</h3>

410 410 

411Der `models`-Block ist eine optionale von Admin kuratierte Modellliste, die unter `/v1/models` bereitgestellt wird und zum Übersetzen von Modell-IDs pro Upstream verwendet wird. Es ist erforderlich für Nicht-US-Bedrock-Regionen, Bedrock-bereitgestellte Durchsatz-ARNs und Foundry-Bereitstellungsnamen.411Der `models`-Block ist eine optionale von Admin kuratierte Modellliste, die unter `/v1/models` bereitgestellt wird und zum Übersetzen von Modell-IDs pro Upstream verwendet wird. Es ist erforderlich für Nicht-US-Amazon Bedrock-Regionen, Amazon Bedrock-bereitgestellte Durchsatz-ARNs und Microsoft Foundry-Bereitstellungsnamen.

412 412 

413```yaml theme={null}413```yaml theme={null}

414auto_include_builtin_models: true # false: nur die Liste unten exponieren414auto_include_builtin_models: true # false: nur die Liste unten exponieren


560* `sandbox.network.allowManagedDomainsOnly` und `sandbox.filesystem.allowManagedReadPathsOnly`: wenn gesperrt, werden die entsprechenden Zulassungslisten über Quellen vereinigt560* `sandbox.network.allowManagedDomainsOnly` und `sandbox.filesystem.allowManagedReadPathsOnly`: wenn gesperrt, werden die entsprechenden Zulassungslisten über Quellen vereinigt

561* [`allowAllClaudeAiMcps`](/de/settings#available-settings): Zulassung-nur-Überschreibung für die claude.ai MCP-Server-Zulassungsliste561* [`allowAllClaudeAiMcps`](/de/settings#available-settings): Zulassung-nur-Überschreibung für die claude.ai MCP-Server-Zulassungsliste

562* `sandbox.bwrapPath` und `sandbox.socatPath`: Dateisystempfade zu den [Sandbox](/de/sandboxing)-Helper-Binärdateien562* `sandbox.bwrapPath` und `sandbox.socatPath`: Dateisystempfade zu den [Sandbox](/de/sandboxing)-Helper-Binärdateien

563* [`forceRemoteSettingsRefresh`](/de/server-managed-settings): blockiert den Start, bis Remote-verwaltete Einstellungen frisch abgerufen werden, sodass eine MDM- oder Datei-Richtlinie, die sie setzt, geehrt wird, auch wenn ein gecachter Remote-Payload, dem der Schlüssel fehlt, die höchste Prioritätsquelle ist

563 564 

564`allowManagedPermissionRulesOnly` und `disableBypassPermissionsMode` sind nicht Cross-Source, sodass nur der Wert der gewinnenden Quelle gilt.565Jeder andere Schlüssel, einschließlich `allowManagedPermissionRulesOnly` und `disableBypassPermissionsMode`, kommt nur von der höchsten Prioritätsquelle. Siehe [Einstellungs-Vorrang](/de/settings#settings-precedence) für die gleiche Regel auf der Einstellungsseite.

565 566 

566Gateway-Richtlinien gelten für jeden Claude Code-Aufruf auf der Maschine, einschließlich nicht-interaktiver `claude -p`-Läufe und Sessions, die vom Agent SDK erzeugt werden. Wenn das Gateway beim Start nicht erreichbar ist, beenden sich angemeldete Sessions mit einem Fehler, anstatt ohne ihre Richtlinie zu laufen.567Gateway-Richtlinien gelten für jeden Claude Code-Aufruf auf der Maschine, einschließlich nicht-interaktiver `claude -p`-Läufe und Sessions, die vom Agent SDK erzeugt werden. Wenn das Gateway beim Start nicht erreichbar ist, beenden sich angemeldete Sessions mit einem Fehler, anstatt ohne ihre Richtlinie zu laufen.

567 568 

Details

283| Boot beendet mit einem Postgres-Berechtigungsfehler | App-Rolle fehlt `CREATE TABLE` | Erstellen Sie das Schema vorab mit einer Admin-Rolle und gewähren Sie DML der App-Rolle, oder gewähren Sie DDL vorübergehend für Boots, die neue Migrationen anwenden |283| Boot beendet mit einem Postgres-Berechtigungsfehler | App-Rolle fehlt `CREATE TABLE` | Erstellen Sie das Schema vorab mit einer Admin-Rolle und gewähren Sie DML der App-Rolle, oder gewähren Sie DDL vorübergehend für Boots, die neue Migrationen anwenden |

284| `/oauth/callback` zeigt "Sign-in could not be completed" | E-Mail-Domain abgelehnt, id\_token-Validierung fehlgeschlagen, oder `email_verified` ist explizit `false`, was das Gateway immer ohne Überschreibung ablehnt | Überprüfen Sie `allowed_email_domains` und dass der IdP einen verifizierten `email`-Claim zurückgibt. Für `email_verified: false` beheben Sie die IdP-seitige Verifikation. Wenn Ihr IdP E-Mail unter einem anderen Claim-Namen ausgibt, setzen Sie `oidc.email_claim`. |284| `/oauth/callback` zeigt "Sign-in could not be completed" | E-Mail-Domain abgelehnt, id\_token-Validierung fehlgeschlagen, oder `email_verified` ist explizit `false`, was das Gateway immer ohne Überschreibung ablehnt | Überprüfen Sie `allowed_email_domains` und dass der IdP einen verifizierten `email`-Claim zurückgibt. Für `email_verified: false` beheben Sie die IdP-seitige Verifikation. Wenn Ihr IdP E-Mail unter einem anderen Claim-Namen ausgibt, setzen Sie `oidc.email_claim`. |

285| Protokoll: `token exchange failed: id_token missing email claim` | Der IdP enthält `email` nicht standardmäßig im id\_token. Diese Ablehnung wird nur ausgelöst, wenn `allowed_email_domains` gesetzt ist; ohne sie prägt ein fehlende E-Mail eine Sitzung ohne E-Mail | Konfigurieren Sie den IdP, um `email` im id\_token auszugeben. Okta: Fügen Sie `email` zu den ID-Token-Claims eines benutzerdefinierten Autorisierungsservers hinzu. Entra: Fügen Sie `email` als optionalen Claim bei der App-Registrierung hinzu. PingFederate: Aktivieren Sie eine OpenID-Connect-Richtlinie, die `email` ausgibt. Wenn der IdP `email` vom Userinfo-Endpoint bedient, aber nicht im id\_token einbeziehen wird, wie der Okta-Org-Autorisierungsserver, setzen Sie `oidc.userinfo_fallback: true`. |285| Protokoll: `token exchange failed: id_token missing email claim` | Der IdP enthält `email` nicht standardmäßig im id\_token. Diese Ablehnung wird nur ausgelöst, wenn `allowed_email_domains` gesetzt ist; ohne sie prägt ein fehlende E-Mail eine Sitzung ohne E-Mail | Konfigurieren Sie den IdP, um `email` im id\_token auszugeben. Okta: Fügen Sie `email` zu den ID-Token-Claims eines benutzerdefinierten Autorisierungsservers hinzu. Entra: Fügen Sie `email` als optionalen Claim bei der App-Registrierung hinzu. PingFederate: Aktivieren Sie eine OpenID-Connect-Richtlinie, die `email` ausgibt. Wenn der IdP `email` vom Userinfo-Endpoint bedient, aber nicht im id\_token einbeziehen wird, wie der Okta-Org-Autorisierungsserver, setzen Sie `oidc.userinfo_fallback: true`. |

286| Jede Bedrock-Anfrage gibt 502 zurück; Protokoll zeigt `Could not load credentials from any providers` | Auf EC2 blockiert IMDSv2s Standard-Hop-Limit von 1 die Instanz-Metadata-Anfrage von innerhalb des Containers. Boot und `/readyz` bestehen trotzdem, da das AWS SDK Instanz-Anmeldedaten bei der ersten Anfrage auflöst, nicht bei der Client-Konstruktion | Erhöhen Sie das Hop-Limit mit `aws ec2 modify-instance-metadata-options --instance-id <id> --http-put-response-hop-limit 2`, oder setzen Sie es in der Launch-Vorlage. Die Änderung gilt für jeden Container auf der Instanz. Bevorzugen Sie ECS-Task-Rollen, wo verfügbar, die Anmeldedaten vom ECS-Container-Credentials-Endpoint lesen und die Änderung ganz vermeiden, oder wenden Sie die Änderung auf einer dedizierten Gateway-Instanz an, um die Exposition zu begrenzen. |286| Jede Amazon-Bedrock-Anfrage gibt 502 zurück; Protokoll zeigt `Could not load credentials from any providers` | Auf EC2 blockiert IMDSv2s Standard-Hop-Limit von 1 die Instanz-Metadata-Anfrage von innerhalb des Containers. Boot und `/readyz` bestehen trotzdem, da das AWS SDK Instanz-Anmeldedaten bei der ersten Anfrage auflöst, nicht bei der Client-Konstruktion | Erhöhen Sie das Hop-Limit mit `aws ec2 modify-instance-metadata-options --instance-id <id> --http-put-response-hop-limit 2`, oder setzen Sie es in der Launch-Vorlage. Die Änderung gilt für jeden Container auf der Instanz. Bevorzugen Sie ECS-Task-Rollen, wo verfügbar, die Anmeldedaten vom ECS-Container-Credentials-Endpoint lesen und die Änderung ganz vermeiden, oder wenden Sie die Änderung auf einer dedizierten Gateway-Instanz an, um die Exposition zu begrenzen. |

287| IdP-Fehler: unknown or unsupported scope | Der IdP lehnt Scopes ab, die er nicht erkennt | Setzen Sie `oidc.scopes` auf genau die Liste, die Ihr IdP akzeptiert; sie muss `openid` enthalten. Der Standard ist `openid profile email offline_access`. |287| IdP-Fehler: unknown or unsupported scope | Der IdP lehnt Scopes ab, die er nicht erkennt | Setzen Sie `oidc.scopes` auf genau die Liste, die Ihr IdP akzeptiert; sie muss `openid` enthalten. Der Standard ist `openid profile email offline_access`. |

288| Sitzungen erneuern sich nicht stillschweigend nach dem Setzen von `oidc.scopes` | `offline_access` wurde aus der Überschreibung gelöscht | Fügen Sie `offline_access` zurück, wenn Ihr IdP es unterstützt. Ohne einen Refresh-Token führen Entwickler die Browser-Anmeldung alle `session.ttl_hours` erneut aus. |288| Sitzungen erneuern sich nicht stillschweigend nach dem Setzen von `oidc.scopes` | `offline_access` wurde aus der Überschreibung gelöscht | Fügen Sie `offline_access` zurück, wenn Ihr IdP es unterstützt. Ohne einen Refresh-Token führen Entwickler die Browser-Anmeldung alle `session.ttl_hours` erneut aus. |

289| Browser zeigt "This request came from another site and was blocked" | Cross-Site-Form-POST, blockiert als CSRF-Schutz. Erwartet für eingebettete oder proxied Seiten | Öffnen Sie den Verifikations-Link direkt |289| Browser zeigt "This request came from another site and was blocked" | Cross-Site-Form-POST, blockiert als CSRF-Schutz. Erwartet für eingebettete oder proxied Seiten | Öffnen Sie den Verifikations-Link direkt |

Details

61 61 

62Nach jeder Antwort liest ein Nutzungsmesser Token-Zählungen aus der Antwort, während sie zum Client streamt, bewertet sie zum USD-Listenpreis und erhöht Postgres-Zähler für alle drei Zeitraum-Buckets. Der Messer ist ein einzelner Leser im Stream, daher werden die Bytes des Clients nicht berührt und ein Messfehler bricht die Antwort nicht.62Nach jeder Antwort liest ein Nutzungsmesser Token-Zählungen aus der Antwort, während sie zum Client streamt, bewertet sie zum USD-Listenpreis und erhöht Postgres-Zähler für alle drei Zeitraum-Buckets. Der Messer ist ein einzelner Leser im Stream, daher werden die Bytes des Clients nicht berührt und ein Messfehler bricht die Antwort nicht.

63 63 

64Ausgabenlimits schätzen Ausgaben aus Token-Zählungen zum USD-Listenpreis; sie sind ein Schutzschalter, keine Rechnung. Für verbindliche Abrechnung gleichen Sie gegen die eigene Nutzungsberichterstattung Ihres Anbieters ab, wie die Anthropic Usage & Cost Admin API, Aufruflogs auf Bedrock oder Cloud Monitoring auf Google Cloud.64Ausgabenlimits schätzen Ausgaben aus Token-Zählungen zum USD-Listenpreis; sie sind ein Schutzschalter, keine Rechnung. Für verbindliche Abrechnung gleichen Sie gegen die eigene Nutzungsberichterstattung Ihres Anbieters ab, wie die Anthropic Usage & Cost Admin API, Aufruflogs auf Amazon Bedrock oder Cloud Monitoring auf Google Cloud.

65 65 

66Die Preisgestaltung verwendet die gleiche Tabelle, die die Claude Code CLI für ihre eigene Kostenanzahl verwendet, mit der gleichen Modell-ID-Kanonisierung über Anthropic, Bedrock (`us.anthropic.…-v1:0`), Agent Platform (`claude-…@date`) und Foundry ID-Formen. Eine Modell-ID, die die Tabelle nicht platzieren kann, wie ein Foundry-Bereitstellungsname oder ein Inferenz-Profil-ARN, wird zum Standard-Tier für unbekannte Modelle von 5 USD/25 USD pro Million Input-/Output-Token bewertet, anstatt null, sodass eine nicht erkannte ID ein Limit nicht durch Nicht-Messung umgehen kann. Das Gateway warnt beim Start und einmal pro ID zur Laufzeit, wenn ein Modell durch den Fallback bewertet wird.66Die Preisgestaltung verwendet die gleiche Tabelle, die die Claude Code CLI für ihre eigene Kostenanzahl verwendet, mit der gleichen Modell-ID-Kanonisierung über Anthropic, Amazon Bedrock (`us.anthropic.…-v1:0`), Google Cloud's Agent Platform (`claude-…@date`) und Microsoft Foundry ID-Formen. Eine Modell-ID, die die Tabelle nicht platzieren kann, wie ein Microsoft Foundry-Bereitstellungsname oder ein Inferenz-Profil-ARN, wird zum Standard-Tier für unbekannte Modelle von \$5/\$25 pro Million Input-/Output-Token bewertet, anstatt null, sodass eine nicht erkannte ID ein Limit nicht durch Nicht-Messung umgehen kann. Das Gateway warnt beim Start und einmal pro ID zur Laufzeit, wenn ein Modell durch den Fallback bewertet wird.

67 67 

68Client-Abbrüche werden auch abgerechnet. Der Upstream meldet Output-Token nur im Terminal-Frame des Streams, daher trägt ein abgebrochener Stream sie nicht. Der Messer behält eine konservative Untergrenze aus der gestreamten Inhaltsgröße bei, etwa vier Zeichen pro Token, und rechnet sie ab, wenn und nur wenn der Terminal-Nutzungs-Frame fehlt. Ein vollständiger Stream rechnet immer die vom Upstream gemeldete Anzahl ab. Ohne dies könnte ein begrenzter Entwickler Output streamen und jede Anfrage unmittelbar vor dem Ende abbrechen, ohne jemals gezählt zu werden.68Client-Abbrüche werden auch abgerechnet. Der Upstream meldet Output-Token nur im Terminal-Frame des Streams, daher trägt ein abgebrochener Stream sie nicht. Der Messer behält eine konservative Untergrenze aus der gestreamten Inhaltsgröße bei, etwa vier Zeichen pro Token, und rechnet sie ab, wenn und nur wenn der Terminal-Nutzungs-Frame fehlt. Ein vollständiger Stream rechnet immer die vom Upstream gemeldete Anzahl ab. Ohne dies könnte ein begrenzter Entwickler Output streamen und jede Anfrage unmittelbar vor dem Ende abbrechen, ohne jemals gezählt zu werden.

69 69 

Details

4 4 

5# Claude Code im Web verwenden5# Claude Code im Web verwenden

6 6 

7> Konfigurieren Sie Cloud-Umgebungen, Setup-Skripte, Netzwerkzugriff und Docker in Anthropics Sandbox. Verschieben Sie Sitzungen zwischen Web und Terminal mit `--remote` und `--teleport`.7> Konfigurieren Sie Cloud-Umgebungen, Setup-Skripte, Netzwerkzugriff und Docker in Anthropics Sandbox. Verschieben Sie Sitzungen zwischen Web und Terminal mit `--cloud` und `--teleport`.

8 8 

9<Note>9<Note>

10 Claude Code im Web befindet sich in der Forschungsvorschau für Pro-, Max- und Team-Benutzer sowie für Enterprise-Benutzer mit Premium-Sitzen oder Chat + Claude Code-Sitzen.10 Claude Code im Web befindet sich in der Forschungsvorschau für Pro-, Max- und Team-Benutzer sowie für Enterprise-Benutzer mit Premium-Sitzen oder Chat + Claude Code-Sitzen.


22* [Die Cloud-Umgebung](#the-cloud-environment): welche Konfiguration übertragen wird, welche Tools installiert sind und wie Umgebungen konfiguriert werden22* [Die Cloud-Umgebung](#the-cloud-environment): welche Konfiguration übertragen wird, welche Tools installiert sind und wie Umgebungen konfiguriert werden

23* [Setup-Skripte](#setup-scripts) und Abhängigkeitsverwaltung23* [Setup-Skripte](#setup-scripts) und Abhängigkeitsverwaltung

24* [Netzwerkzugriff](#network-access): Ebenen, Proxys und die Standard-Allowlist24* [Netzwerkzugriff](#network-access): Ebenen, Proxys und die Standard-Allowlist

25* [Aufgaben zwischen Web und Terminal verschieben](#move-tasks-between-web-and-terminal) mit `--remote` und `--teleport`25* [Aufgaben zwischen Web und Terminal verschieben](#move-tasks-between-web-and-terminal) mit `--cloud` und `--teleport`

26* [Mit Sitzungen arbeiten](#work-with-sessions): Überprüfung, Freigabe, Archivierung, Löschung26* [Mit Sitzungen arbeiten](#work-with-sessions): Überprüfung, Freigabe, Archivierung, Löschung

27* [Auto-fix Pull Requests](#auto-fix-pull-requests): automatische Reaktion auf CI-Fehler und Review-Kommentare27* [Auto-fix Pull Requests](#auto-fix-pull-requests): automatische Reaktion auf CI-Fehler und Review-Kommentare

28* [Sicherheit und Isolation](#security-and-isolation): wie Sitzungen isoliert sind28* [Sicherheit und Isolation](#security-and-isolation): wie Sitzungen isoliert sind


182Umgebungen steuern [Netzwerkzugriff](#network-access), Umgebungsvariablen und das [Setup-Skript](#setup-scripts), das vor einer Sitzung ausgeführt wird. Siehe [Installierte Tools](#installed-tools) für das, was ohne Konfiguration verfügbar ist. Sie können Umgebungen über die Web-Oberfläche oder das Terminal verwalten:182Umgebungen steuern [Netzwerkzugriff](#network-access), Umgebungsvariablen und das [Setup-Skript](#setup-scripts), das vor einer Sitzung ausgeführt wird. Siehe [Installierte Tools](#installed-tools) für das, was ohne Konfiguration verfügbar ist. Sie können Umgebungen über die Web-Oberfläche oder das Terminal verwalten:

183 183 

184| Aktion | Wie |184| Aktion | Wie |

185| :-------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |185| :----------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

186| Umgebung hinzufügen | Wählen Sie die aktuelle Umgebung, um die Auswahl zu öffnen, dann wählen Sie **Umgebung hinzufügen**. Der Dialog enthält Name, Netzwerkzugriffsstufe, Umgebungsvariablen und Setup-Skript. |186| Umgebung hinzufügen | Wählen Sie die aktuelle Umgebung, um die Auswahl zu öffnen, dann wählen Sie **Umgebung hinzufügen**. Der Dialog enthält Name, Netzwerkzugriffsstufe, Umgebungsvariablen und Setup-Skript. |

187| Umgebung bearbeiten | Wählen Sie das Cloud-Symbol mit dem Namen der aktuellen Umgebung, um die Auswahl zu öffnen, bewegen Sie den Mauszeiger über eine Umgebung und klicken Sie auf das Einstellungssymbol, das auf der rechten Seite erscheint. |187| Umgebung bearbeiten | Wählen Sie das Cloud-Symbol mit dem Namen der aktuellen Umgebung, um die Auswahl zu öffnen, bewegen Sie den Mauszeiger über eine Umgebung und klicken Sie auf das Einstellungssymbol, das auf der rechten Seite erscheint. |

188| Umgebung archivieren | Öffnen Sie die Umgebung zum Bearbeiten und wählen Sie **Archivieren**. Archivierte Umgebungen sind in der Auswahl ausgeblendet, aber vorhandene Sitzungen werden weiterhin ausgeführt. |188| Umgebung archivieren | Öffnen Sie die Umgebung zum Bearbeiten und wählen Sie **Archivieren**. Archivierte Umgebungen sind in der Auswahl ausgeblendet, aber vorhandene Sitzungen werden weiterhin ausgeführt. |

189| Standard für `--remote` festlegen | Führen Sie `/remote-env` in Ihrem Terminal aus. Wenn Sie eine einzelne Umgebung haben, zeigt dieser Befehl Ihre aktuelle Konfiguration. `/remote-env` wählt nur den Standard; fügen Sie Umgebungen über die Web-Oberfläche hinzu, bearbeiten und archivieren Sie sie. |189| Standard für CLI-Cloud-Sitzungen festlegen | Führen Sie `/remote-env` in Ihrem Terminal aus. Wenn Sie eine einzelne Umgebung haben, zeigt dieser Befehl Ihre aktuelle Konfiguration. `/remote-env` wählt nur den Standard; fügen Sie Umgebungen über die Web-Oberfläche hinzu, bearbeiten und archivieren Sie sie. |

190 190 

191Umgebungsvariablen verwenden das `.env`-Format mit einem `KEY=value`-Paar pro Zeile. Wickeln Sie Werte nicht in Anführungszeichen ein, da Anführungszeichen als Teil des Werts gespeichert werden. Dieses Beispiel definiert drei Variablen:191Umgebungsvariablen verwenden das `.env`-Format mit einem `KEY=value`-Paar pro Zeile. Wickeln Sie Werte nicht in Anführungszeichen ein, da Anführungszeichen als Teil des Werts gespeichert werden. Dieses Beispiel definiert drei Variablen:

192 192 


629Diese Workflows erfordern die [Claude Code CLI](/de/quickstart), die bei demselben claude.ai-Konto angemeldet ist. Sie können neue Cloud-Sitzungen von Ihrem Terminal aus starten oder Cloud-Sitzungen in Ihr Terminal ziehen, um lokal fortzufahren. Cloud-Sitzungen bleiben bestehen, auch wenn Sie Ihren Laptop schließen, und Sie können sie von überall aus überwachen, einschließlich der Claude Mobile-App.629Diese Workflows erfordern die [Claude Code CLI](/de/quickstart), die bei demselben claude.ai-Konto angemeldet ist. Sie können neue Cloud-Sitzungen von Ihrem Terminal aus starten oder Cloud-Sitzungen in Ihr Terminal ziehen, um lokal fortzufahren. Cloud-Sitzungen bleiben bestehen, auch wenn Sie Ihren Laptop schließen, und Sie können sie von überall aus überwachen, einschließlich der Claude Mobile-App.

630 630 

631<Note>631<Note>

632 Von der CLI ist die Sitzungsübergabe unidirektional: Sie können Cloud-Sitzungen mit `--teleport` in Ihr Terminal ziehen, aber Sie können keine vorhandene Terminal-Sitzung ins Web verschieben. Das Flag `--remote` erstellt eine neue Cloud-Sitzung für Ihr aktuelles Repository. Die [Desktop-App](/de/desktop#continue-in-another-surface) bietet ein Continue in-Menü, das eine lokale Sitzung ins Web senden kann.632 Von der CLI ist die Sitzungsübergabe unidirektional: Sie können Cloud-Sitzungen mit `--teleport` in Ihr Terminal ziehen, aber Sie können keine vorhandene Terminal-Sitzung ins Web verschieben. Das Flag `--cloud` erstellt eine neue Cloud-Sitzung für Ihr aktuelles Repository. Die [Desktop-App](/de/desktop#continue-in-another-surface) bietet ein Continue in-Menü, das eine lokale Sitzung ins Web senden kann.

633</Note>633</Note>

634 634 

635<h3 id="from-terminal-to-web">635<h3 id="from-terminal-to-web">

636 Vom Terminal zum Web636 Vom Terminal zum Web

637</h3>637</h3>

638 638 

639Starten Sie eine Cloud-Sitzung von der Befehlszeile mit dem Flag `--remote`:639Starten Sie eine Cloud-Sitzung von der Befehlszeile mit dem Flag `--cloud`:

640 640 

641```bash theme={null}641```bash theme={null}

642claude --remote "Fix the authentication bug in src/auth/login.ts"642claude --cloud "Fix the authentication bug in src/auth/login.ts"

643```643```

644 644 

645Dies erstellt eine neue Cloud-Sitzung auf claude.ai. Die Sitzung klont Ihr aktuelles Verzeichnis's GitHub-Remote bei Ihrem aktuellen Branch, daher pushen Sie zuerst, wenn Sie lokale Commits haben, da die VM von GitHub klont, nicht von Ihrem Computer. `--remote` funktioniert mit einem Repository auf einmal. Die Aufgabe wird in der Cloud ausgeführt, während Sie lokal weiterarbeiten.645Dies erstellt eine neue Cloud-Sitzung auf claude.ai. Die Sitzung klont Ihr aktuelles Verzeichnis's GitHub-Remote bei Ihrem aktuellen Branch, daher pushen Sie zuerst, wenn Sie lokale Commits haben, da die VM von GitHub klont, nicht von Ihrem Computer. `--cloud` funktioniert mit einem Repository auf einmal. Die Aufgabe wird in der Cloud ausgeführt, während Sie lokal weiterarbeiten. Die ältere Schreibweise `--remote` funktioniert immer noch als veralteter Alias für `--cloud`.

646 646 

647{/* min-version: 2.1.195 */}Ab v2.1.195 zeigt die CLI eine Live-Checkliste von Setup-Schritten an, wie z. B. das Klonen des Repositories und das Ausführen Ihres [Setup-Skripts](#setup-scripts), während der Cloud-Container startet. Nachrichten, die Sie eingeben, während der Container bereitgestellt wird, werden in die Warteschlange eingereiht und gesendet, sobald die Sitzung bereit ist.647{/* min-version: 2.1.195 */}Ab v2.1.195 zeigt die CLI eine Live-Checkliste von Setup-Schritten an, wie z. B. das Klonen des Repositories und das Ausführen Ihres [Setup-Skripts](#setup-scripts), während der Cloud-Container startet. Nachrichten, die Sie eingeben, während der Container bereitgestellt wird, werden in die Warteschlange eingereiht und gesendet, sobald die Sitzung bereit ist.

648 648 

649<Note>649<Note>

650 `--remote` erstellt Cloud-Sitzungen. `--remote-control` ist nicht verwandt: Es stellt eine lokale CLI-Sitzung zur Überwachung vom Web aus bereit. Siehe [Remote Control](/de/remote-control).650 `--cloud` erstellt Cloud-Sitzungen. `--remote-control` ist nicht verwandt: Es stellt eine lokale CLI-Sitzung zur Überwachung vom Web aus bereit. Siehe [Remote Control](/de/remote-control).

651</Note>651</Note>

652 652 

653Verwenden Sie `/tasks` in der Claude Code CLI, um den Fortschritt zu überprüfen, oder öffnen Sie die Sitzung auf claude.ai oder der Claude Mobile-App, um direkt zu interagieren. Von dort aus können Sie Claude steuern, Feedback geben oder Fragen beantworten, genau wie in jedem anderen Gespräch.653Verwenden Sie `/tasks` in der Claude Code CLI, um den Fortschritt zu überprüfen, oder öffnen Sie die Sitzung auf claude.ai oder der Claude Mobile-App, um direkt zu interagieren. Von dort aus können Sie Claude steuern, Feedback geben oder Fragen beantworten, genau wie in jedem anderen Gespräch.


665Im Plan Mode liest Claude Dateien, führt Befehle aus, um zu erkunden, und schlägt einen Plan vor, ohne Quellcode zu bearbeiten. Sobald Sie mit dem Plan zufrieden sind, speichern Sie den Plan im Repo, committen und pushen Sie, damit die Cloud-VM ihn klonen kann. Dann starten Sie eine Cloud-Sitzung für autonome Ausführung:665Im Plan Mode liest Claude Dateien, führt Befehle aus, um zu erkunden, und schlägt einen Plan vor, ohne Quellcode zu bearbeiten. Sobald Sie mit dem Plan zufrieden sind, speichern Sie den Plan im Repo, committen und pushen Sie, damit die Cloud-VM ihn klonen kann. Dann starten Sie eine Cloud-Sitzung für autonome Ausführung:

666 666 

667```bash theme={null}667```bash theme={null}

668claude --remote "Execute the migration plan in docs/migration-plan.md"668claude --cloud "Execute the migration plan in docs/migration-plan.md"

669```669```

670 670 

671Dieses Muster gibt Ihnen Kontrolle über die Strategie, während Claude autonom in der Cloud ausgeführt wird.671Dieses Muster gibt Ihnen Kontrolle über die Strategie, während Claude autonom in der Cloud ausgeführt wird.

672 672 

673**Planen Sie in der Cloud mit ultraplan**: Um den Plan selbst in einer Web-Sitzung zu entwerfen und zu überprüfen, verwenden Sie [ultraplan](/de/ultraplan). Claude generiert den Plan auf Claude Code im Web, während Sie weiterarbeiten, dann kommentieren Sie Abschnitte in Ihrem Browser und wählen, ob Sie remote ausführen oder den Plan zurück zu Ihrem Terminal senden.673**Planen Sie in der Cloud mit ultraplan**: Um den Plan selbst in einer Web-Sitzung zu entwerfen und zu überprüfen, verwenden Sie [ultraplan](/de/ultraplan). Claude generiert den Plan auf Claude Code im Web, während Sie weiterarbeiten, dann kommentieren Sie Abschnitte in Ihrem Browser und wählen, ob Sie remote ausführen oder den Plan zurück zu Ihrem Terminal senden.

674 674 

675**Führen Sie Aufgaben parallel aus**: Jeder `--remote`-Befehl erstellt seine eigene Cloud-Sitzung, die unabhängig ausgeführt wird. Sie können mehrere Aufgaben starten und sie werden alle gleichzeitig in separaten Sitzungen ausgeführt:675**Führen Sie Aufgaben parallel aus**: Jeder `--cloud`-Befehl erstellt seine eigene Cloud-Sitzung, die unabhängig ausgeführt wird. Sie können mehrere Aufgaben starten und sie werden alle gleichzeitig in separaten Sitzungen ausgeführt:

676 676 

677```bash theme={null}677```bash theme={null}

678claude --remote "Fix the flaky test in auth.spec.ts"678claude --cloud "Fix the flaky test in auth.spec.ts"

679claude --remote "Update the API documentation"679claude --cloud "Update the API documentation"

680claude --remote "Refactor the logger to use structured output"680claude --cloud "Refactor the logger to use structured output"

681```681```

682 682 

683Überwachen Sie alle Sitzungen mit `/tasks` in der Claude Code CLI. Wenn eine Sitzung abgeschlossen ist, können Sie einen PR aus der Web-Oberfläche erstellen oder [die Sitzung teleportieren](#from-web-to-terminal), um lokal fortzufahren.683Überwachen Sie alle Sitzungen mit `/tasks` in der Claude Code CLI. Wenn eine Sitzung abgeschlossen ist, können Sie einen PR aus der Web-Oberfläche erstellen oder [die Sitzung teleportieren](#from-web-to-terminal), um lokal fortzufahren.


686 Senden Sie lokale Repositories ohne GitHub686 Senden Sie lokale Repositories ohne GitHub

687</h4>687</h4>

688 688 

689Wenn Sie `claude --remote` aus einem Repository ausführen, das nicht mit GitHub verbunden ist, bündelt Claude Code Ihr lokales Repository und lädt es direkt in die Cloud-Sitzung hoch. Das Bündel enthält Ihre vollständige Repository-Historie über alle Branches hinweg, plus alle nicht committeten Änderungen an verfolgten Dateien.689Wenn Sie `claude --cloud` aus einem Repository ausführen, das nicht mit GitHub verbunden ist, bündelt Claude Code Ihr lokales Repository und lädt es direkt in die Cloud-Sitzung hoch. Das Bündel enthält Ihre vollständige Repository-Historie über alle Branches hinweg, plus alle nicht committeten Änderungen an verfolgten Dateien.

690 690 

691Dieses Fallback wird automatisch aktiviert, wenn GitHub-Zugriff nicht verfügbar ist. Um es zu erzwingen, auch wenn GitHub verbunden ist, setzen Sie `CCR_FORCE_BUNDLE=1`:691Dieses Fallback wird automatisch aktiviert, wenn GitHub-Zugriff nicht verfügbar ist. Um es zu erzwingen, auch wenn GitHub verbunden ist, setzen Sie `CCR_FORCE_BUNDLE=1`:

692 692 

693```bash theme={null}693```bash theme={null}

694CCR_FORCE_BUNDLE=1 claude --remote "Run the test suite and fix any failures"694CCR_FORCE_BUNDLE=1 claude --cloud "Run the test suite and fix any failures"

695```695```

696 696 

697Gebündelte Repositories müssen diese Limits erfüllen:697Gebündelte Repositories müssen diese Limits erfüllen:


733 `--teleport` ist nicht verfügbar733 `--teleport` ist nicht verfügbar

734</h4>734</h4>

735 735 

736Teleport erfordert claude.ai-Abonnement-Authentifizierung. Wenn Sie sich über API-Schlüssel, Bedrock, Vertex AI oder Microsoft Foundry authentifizieren, führen Sie `/login` aus, um sich stattdessen mit Ihrem claude.ai-Konto anzumelden. Wenn Sie bereits über claude.ai angemeldet sind und `--teleport` immer noch nicht verfügbar ist, hat Ihre Organisation möglicherweise Cloud-Sitzungen deaktiviert.736Teleport erfordert claude.ai-Abonnement-Authentifizierung. Wenn Sie sich über API-Schlüssel, Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry authentifizieren, führen Sie `/login` aus, um sich stattdessen mit Ihrem claude.ai-Konto anzumelden. Wenn Sie bereits über claude.ai angemeldet sind und `--teleport` immer noch nicht verfügbar ist, hat Ihre Organisation möglicherweise Cloud-Sitzungen deaktiviert.

737 737 

738<h2 id="work-with-sessions">738<h2 id="work-with-sessions">

739 Mit Sitzungen arbeiten739 Mit Sitzungen arbeiten


745 Kontext verwalten745 Kontext verwalten

746</h3>746</h3>

747 747 

748Cloud-Sitzungen unterstützen [integrierte Befehle](/de/commands), die Textausgabe erzeugen. Befehle, die eine interaktive Terminal-Auswahl öffnen, wie `/model` oder `/config`, sind nicht verfügbar.748Cloud-Sitzungen unterstützen [integrierte Befehle](/de/commands), die Textausgabe erzeugen. Befehle, die nur in der Terminal-Schnittstelle ausgeführt werden, wie `/plugin` oder `/resume`, sind nicht verfügbar. {/* min-version: 2.1.205 */}}`/model`, `/effort`, `/fast`, `/color` und `/rename` funktionieren mit dem Wert als Argument, zum Beispiel `/model sonnet`, anstatt die Terminal-Auswahl oder den Schieberegler zu öffnen; die Argumentformen erfordern Claude Code v2.1.205 oder später in der Umgebung der Sitzung und folgen den [Verfügbarkeitshinweisen](/de/commands#all-commands) jedes Befehls, daher meldet `/effort` `Not applied`, während ein [Launch-Standard-Effort-Hold](/de/model-config#adjust-effort-level) eines Modells in Kraft ist, und `/fast` funktioniert nur in einer Sitzung, die mit aktiviertem Fast-Modus gestartet wurde. `/config` setzt eine Einstellung, wenn Sie `key=value` übergeben.

749 749 

750Für Kontextverwaltung speziell:750Für Kontextverwaltung speziell:

751 751 


757 757 

758Auto-Kompaktierung wird automatisch ausgeführt, wenn sich das Kontextfenster der Kapazität nähert. Um es früher auszulösen, setzen Sie [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/de/env-vars) in Ihren [Umgebungsvariablen](#configure-your-environment). Zum Beispiel kompaktiert `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70` bei 70% Kapazität statt des Wartens, bis das Fenster fast voll ist. Um die effektive Fenstergröße für Kompaktierungsberechnungen zu ändern, verwenden Sie [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/de/env-vars).758Auto-Kompaktierung wird automatisch ausgeführt, wenn sich das Kontextfenster der Kapazität nähert. Um es früher auszulösen, setzen Sie [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/de/env-vars) in Ihren [Umgebungsvariablen](#configure-your-environment). Zum Beispiel kompaktiert `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70` bei 70% Kapazität statt des Wartens, bis das Fenster fast voll ist. Um die effektive Fenstergröße für Kompaktierungsberechnungen zu ändern, verwenden Sie [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/de/env-vars).

759 759 

760[Subagents](/de/sub-agents) funktionieren genauso wie lokal. Claude kann sie mit dem Task-Tool spawnen, um Forschung oder parallele Arbeit in ein separates Kontextfenster auszulagern, um das Hauptgespräch leichter zu halten. Subagents, die in Ihrem Repo's `.claude/agents/` definiert sind, werden automatisch aufgegriffen. [Agent-Teams](/de/agent-teams) sind standardmäßig deaktiviert, können aber aktiviert werden, indem Sie `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` zu Ihren [Umgebungsvariablen](#configure-your-environment) hinzufügen.760[Subagents](/de/sub-agents) funktionieren genauso wie lokal. Claude kann sie mit dem Task-Tool spawnen, um Forschung oder parallele Arbeit in ein separates Kontextfenster auszulagern, um das Hauptgespräch leichter zu halten. Subagents, die in Ihrem Repo's `.claude/agents/` definiert sind, werden automatisch aufgegriffen.

761 

762[Agent-Teams](/de/agent-teams) sind standardmäßig deaktiviert, können aber aktiviert werden, indem Sie `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` zu Ihren [Umgebungsvariablen](#configure-your-environment) hinzufügen.

761 763 

762<h3 id="review-changes">764<h3 id="review-changes">

763 Änderungen überprüfen765 Änderungen überprüfen

Details

270 270 

271`ANTHROPIC_AWS_WORKSPACE_ID` ist erforderlich und wird bei jeder Anfrage als `anthropic-workspace-id`-Header gesendet. Die Basis-URL wird aus `AWS_REGION` als `https://aws-external-anthropic.{region}.api.aws` berechnet. Um die URL direkt zu überschreiben, setzen Sie `ANTHROPIC_AWS_BASE_URL`.271`ANTHROPIC_AWS_WORKSPACE_ID` ist erforderlich und wird bei jeder Anfrage als `anthropic-workspace-id`-Header gesendet. Die Basis-URL wird aus `AWS_REGION` als `https://aws-external-anthropic.{region}.api.aws` berechnet. Um die URL direkt zu überschreiben, setzen Sie `ANTHROPIC_AWS_BASE_URL`.

272 272 

273Claude Platform on AWS ist optional, auch wenn AWS-Anmeldedaten in Ihrer Umgebung vorhanden sind. Bedrock und Foundry haben Vorrang beim Provider-Routing, daher heben Sie `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_FOUNDRY` auf, wenn sie gesetzt sind.273Claude Platform on AWS ist optional, auch wenn AWS-Anmeldedaten in Ihrer Umgebung vorhanden sind. Amazon Bedrock und Microsoft Foundry haben Vorrang beim Provider-Routing, daher heben Sie `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_FOUNDRY` auf, wenn sie gesetzt sind.

274 274 

275<h3 id="3-pin-model-versions">275<h3 id="3-pin-model-versions">

276 3. Modellversionen anheften276 3. Modellversionen anheften

cli-reference.md +10 −7

Details

22| `claude -c -p "query"` | Fortsetzen über SDK | `claude -c -p "Check for type errors"` |22| `claude -c -p "query"` | Fortsetzen über SDK | `claude -c -p "Check for type errors"` |

23| `claude -r "<session>" "query"` | Sitzung nach ID oder Name fortsetzen | `claude -r "auth-refactor" "Finish this PR"` |23| `claude -r "<session>" "query"` | Sitzung nach ID oder Name fortsetzen | `claude -r "auth-refactor" "Finish this PR"` |

24| `claude update` | Auf neueste Version aktualisieren | `claude update` |24| `claude update` | Auf neueste Version aktualisieren | `claude update` |

25| `claude gateway` | Starten Sie den selbstgehosteten [Claude Apps Gateway](/de/claude-apps-gateway) Server für Administratoren, die SSO und Richtlinien vor Claude Code auf Bedrock, Vertex AI oder Foundry bereitstellen. Erfordert `--config`, das auf eine [`gateway.yaml`](/de/claude-apps-gateway-config) verweist. Verfügbar in Claude Code v2.1.195 und später. | `claude gateway --config gateway.yaml` |25| `claude gateway` | Starten Sie den selbstgehosteten [Claude Apps Gateway](/de/claude-apps-gateway) Server für Administratoren, die SSO und Richtlinien vor Claude Code auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry bereitstellen. Erfordert `--config`, das auf eine [`gateway.yaml`](/de/claude-apps-gateway-config) verweist. Verfügbar in Claude Code v2.1.195 und später. | `claude gateway --config gateway.yaml` |

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](/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](/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` |

28| `claude auth logout` | Abmelden von Ihrem Anthropic-Konto | `claude auth logout` |28| `claude auth logout` | Abmelden von Ihrem Anthropic-Konto | `claude auth logout` |


32| `claude auto-mode defaults` | Drucken Sie die integrierten [Auto-Modus](/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 | `claude auto-mode defaults > rules.json` |32| `claude auto-mode defaults` | Drucken Sie die integrierten [Auto-Modus](/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 | `claude auto-mode defaults > rules.json` |

33| `claude daemon status` | Drucken Sie den Hintergrund-Sitzungs-[Supervisor](/de/agent-view#the-supervisor-process) Status, Version, Socket-Verzeichnis und Worker-Anzahl für Diagnosen. Beendet mit 1, wenn der Supervisor nicht läuft | `claude daemon status` |33| `claude daemon status` | Drucken Sie den Hintergrund-Sitzungs-[Supervisor](/de/agent-view#the-supervisor-process) Status, Version, Socket-Verzeichnis und Worker-Anzahl für Diagnosen. Beendet mit 1, wenn der Supervisor nicht läuft | `claude daemon status` |

34| `claude daemon stop --any` | Stoppen Sie den Hintergrund-Sitzungs-[Supervisor](/de/agent-view#the-supervisor-process) und die Sitzungen, die er hostet. Übergeben Sie `--keep-workers`, um Hintergrundsitzungen laufen zu lassen, damit sich der nächste Supervisor mit ihnen verbindet. `--any` bestätigt das Stoppen eines On-Demand-Supervisors, was die Standardeinstellung ist. Verwenden Sie dies, um sich von einem [nicht reagierenden Supervisor](/de/agent-view#agent-view-says-the-background-service-did-not-respond) zu erholen | `claude daemon stop --any --keep-workers` |34| `claude daemon stop --any` | Stoppen Sie den Hintergrund-Sitzungs-[Supervisor](/de/agent-view#the-supervisor-process) und die Sitzungen, die er hostet. Übergeben Sie `--keep-workers`, um Hintergrundsitzungen laufen zu lassen, damit sich der nächste Supervisor mit ihnen verbindet. `--any` bestätigt das Stoppen eines On-Demand-Supervisors, was die Standardeinstellung ist. Verwenden Sie dies, um sich von einem [nicht reagierenden Supervisor](/de/agent-view#agent-view-says-the-background-service-did-not-respond) zu erholen | `claude daemon stop --any --keep-workers` |

35| `claude doctor` | Drucken Sie schreibgeschützte Installations- und Einstellungsdiagnosen vom Terminal aus, ohne eine Sitzung zu starten, einschließlich Installationsintegrität, Validierungsfehlern in der Einstellungsdatei und Remote Control-Berechtigung. Für die In-Session-Setup-Überprüfung, die auch Fixes anwenden kann, führen Sie [`/doctor`](/de/commands#all-commands) aus | `claude doctor` |

35| `claude logs <id>` | Drucken Sie die aktuelle Ausgabe aus einer [Hintergrundsitzung](/de/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |36| `claude logs <id>` | Drucken Sie die aktuelle Ausgabe aus einer [Hintergrundsitzung](/de/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |

36| `claude mcp` | Model Context Protocol (MCP) Server konfigurieren | Siehe die [Claude Code MCP-Dokumentation](/de/mcp). |37| `claude mcp` | Model Context Protocol (MCP) Server konfigurieren | Siehe die [Claude Code MCP-Dokumentation](/de/mcp). |

37| `claude mcp login <name>` | {/* min-version: 2.1.186 */}Führen Sie den OAuth-Fluss eines konfigurierten MCP-Servers aus, ohne das interaktive `/mcp`-Panel zu öffnen. Funktioniert für HTTP-, SSE- und claude.ai-Connector-Server. Fügen Sie `--no-browser` über SSH hinzu, um die Autorisierungs-URL auszudrucken, anstatt einen Browser zu öffnen, und fügen Sie dann die Umleitungs-URL an der Eingabeaufforderung ein. Erfordert Claude Code v2.1.186 oder später. Siehe [Authentifizierung über die Befehlszeile](/de/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |38| `claude mcp login <name>` | {/* min-version: 2.1.186 */}Führen Sie den OAuth-Fluss eines konfigurierten MCP-Servers aus, ohne das interaktive `/mcp`-Panel zu öffnen. Funktioniert für HTTP-, SSE- und claude.ai-Connector-Server. Fügen Sie `--no-browser` über SSH hinzu, um die Autorisierungs-URL auszudrucken, anstatt einen Browser zu öffnen, und fügen Sie dann die Umleitungs-URL an der Eingabeaufforderung ein. Erfordert Claude Code v2.1.186 oder später. Siehe [Authentifizierung über die Befehlszeile](/de/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |


63| `--agents` | Definieren Sie benutzerdefinierte Subagenten dynamisch über JSON. Verwendet die gleichen Feldnamen wie Subagent [Frontmatter](/de/sub-agents#supported-frontmatter-fields), plus ein `prompt`-Feld für die Anweisungen des Agenten | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |64| `--agents` | Definieren Sie benutzerdefinierte Subagenten dynamisch über JSON. Verwendet die gleichen Feldnamen wie Subagent [Frontmatter](/de/sub-agents#supported-frontmatter-fields), plus ein `prompt`-Feld für die Anweisungen des Agenten | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

64| `--allow-dangerously-skip-permissions` | Fügen Sie `bypassPermissions` zum `Shift+Tab` Modus-Zyklus hinzu, ohne damit zu beginnen. Ermöglicht es Ihnen, in einem anderen Modus wie `plan` zu beginnen und später zu `bypassPermissions` zu wechseln. Siehe [Berechtigungsmodi](/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |65| `--allow-dangerously-skip-permissions` | Fügen Sie `bypassPermissions` zum `Shift+Tab` Modus-Zyklus hinzu, ohne damit zu beginnen. Ermöglicht es Ihnen, in einem anderen Modus wie `plan` zu beginnen und später zu `bypassPermissions` zu wechseln. Siehe [Berechtigungsmodi](/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

65| `--allowedTools`, `--allowed-tools` | Tools, die ohne Aufforderung zur Berechtigung ausgeführt werden. Siehe [Berechtigung Regelsyntax](/de/settings#permission-rule-syntax) für Musterabgleich. Um einzuschränken, welche Tools verfügbar sind, verwenden Sie stattdessen `--tools` | `"Bash(git log *)" "Bash(git diff *)" "Read"` |66| `--allowedTools`, `--allowed-tools` | Tools, die ohne Aufforderung zur Berechtigung ausgeführt werden. Siehe [Berechtigung Regelsyntax](/de/settings#permission-rule-syntax) für Musterabgleich. Um einzuschränken, welche Tools verfügbar sind, verwenden Sie stattdessen `--tools` | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Fügen Sie benutzerdefinierten Text am Ende des Systemprompts jedes [Subagenten](/de/sub-agents) an, einschließlich verschachtelter Subagenten. 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"` |

66| `--append-system-prompt` | Fügen Sie benutzerdefinierten Text am Ende des Standard-Systemprompts an | `claude --append-system-prompt "Always use TypeScript"` |68| `--append-system-prompt` | Fügen Sie benutzerdefinierten Text am Ende des Standard-Systemprompts an | `claude --append-system-prompt "Always use TypeScript"` |

67| `--append-system-prompt-file` | Laden Sie zusätzlichen Systemprompt-Text aus einer Datei und fügen Sie ihn zum Standard-Prompt an | `claude --append-system-prompt-file ./extra-rules.txt` |69| `--append-system-prompt-file` | Laden Sie zusätzlichen Systemprompt-Text aus einer Datei und fügen Sie ihn zum Standard-Prompt an | `claude --append-system-prompt-file ./extra-rules.txt` |

68| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Erzwingt den klassischen Renderer, sodass die [`tui`](/de/settings#available-settings) Einstellung für die Sitzung keine Auswirkung hat. Hat Vorrang vor [`CLAUDE_AX_SCREEN_READER`](/de/env-vars) und der [`axScreenReader`](/de/settings#available-settings) Einstellung. Erfordert Claude Code v2.1.181 oder später | `claude --ax-screen-reader` |70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Erzwingt den klassischen Renderer, sodass die [`tui`](/de/settings#available-settings) Einstellung für die Sitzung keine Auswirkung hat. Hat Vorrang vor [`CLAUDE_AX_SCREEN_READER`](/de/env-vars) und der [`axScreenReader`](/de/settings#available-settings) Einstellung. Erfordert Claude Code v2.1.181 oder später | `claude --ax-screen-reader` |


71| `--bg`, `--background` | Starten Sie die Sitzung als [Hintergrund-Agent](/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 anstelle einer Claude-Sitzung auszuführen, oder mit `--agent`, um einen bestimmten Subagenten auszuführen. {/* min-version: 2.1.198 */}Kann nicht mit `-p`/`--print` kombiniert werden; siehe die [Fehlerreferenz](/de/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |73| `--bg`, `--background` | Starten Sie die Sitzung als [Hintergrund-Agent](/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 anstelle einer Claude-Sitzung auszuführen, oder mit `--agent`, um einen bestimmten Subagenten auszuführen. {/* min-version: 2.1.198 */}Kann nicht mit `-p`/`--print` kombiniert werden; siehe die [Fehlerreferenz](/de/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

72| `--channels` | (Forschungsvorschau) MCP-Server, deren [Kanal](/de/channels) Benachrichtigungen Claude in dieser Sitzung abhören sollte. Durch Leerzeichen getrennte Liste von `plugin:<name>@<marketplace>` Einträgen. Erfordert Claude.ai-Authentifizierung | `claude --channels plugin:my-notifier@my-marketplace` |74| `--channels` | (Forschungsvorschau) MCP-Server, deren [Kanal](/de/channels) Benachrichtigungen Claude in dieser Sitzung abhören sollte. Durch Leerzeichen getrennte Liste von `plugin:<name>@<marketplace>` Einträgen. Erfordert Claude.ai-Authentifizierung | `claude --channels plugin:my-notifier@my-marketplace` |

73| `--chrome` | Aktivieren Sie [Chrome-Browser-Integration](/de/chrome) für Web-Automatisierung und Tests | `claude --chrome` |75| `--chrome` | Aktivieren Sie [Chrome-Browser-Integration](/de/chrome) für Web-Automatisierung und Tests | `claude --chrome` |

76| `--cloud` | Erstellen Sie eine neue [Web-Sitzung](/de/claude-code-on-the-web) auf claude.ai mit der bereitgestellten Aufgabenbeschreibung | `claude --cloud "Fix the login bug"` |

74| `--continue`, `-c` | Laden Sie die letzte Konversation im aktuellen Verzeichnis. Schließt Sitzungen ein, die dieses Verzeichnis mit `/add-dir` hinzugefügt haben | `claude --continue` |77| `--continue`, `-c` | Laden Sie die letzte Konversation im aktuellen Verzeichnis. Schließt Sitzungen ein, die dieses Verzeichnis mit `/add-dir` hinzugefügt haben | `claude --continue` |

75| `--dangerously-load-development-channels` | Aktivieren Sie [Kanäle](/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` |78| `--dangerously-load-development-channels` | Aktivieren Sie [Kanäle](/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` |

76| `--dangerously-skip-permissions` | Überspringen Sie Berechtigungsaufforderungen. Entspricht `--permission-mode bypassPermissions`. Siehe [Berechtigungsmodi](/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) für das, was dies überspringt und nicht überspringt | `claude --dangerously-skip-permissions` |79| `--dangerously-skip-permissions` | Überspringen Sie Berechtigungsaufforderungen. Entspricht `--permission-mode bypassPermissions`. Siehe [Berechtigungsmodi](/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) für das, was dies überspringt und nicht überspringt | `claude --dangerously-skip-permissions` |


78| `--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` |81| `--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` |

79| `--disable-slash-commands` | Deaktivieren Sie alle Skills und Befehle für diese Sitzung | `claude --disable-slash-commands` |82| `--disable-slash-commands` | Deaktivieren Sie alle Skills und Befehle für diese Sitzung | `claude --disable-slash-commands` |

80| `--disallowedTools`, `--disallowed-tools` | Ablehnungsregeln. Ein bloßer Tool-Name entfernt die entsprechenden Tools aus dem Kontext des Modells: `"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 übereinstimmende Aufrufe ab | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |83| `--disallowedTools`, `--disallowed-tools` | Ablehnungsregeln. Ein bloßer Tool-Name entfernt die entsprechenden Tools aus dem Kontext des Modells: `"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 übereinstimmende Aufrufe ab | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

81| `--effort` | Legen Sie die [Aufwandsstufe](/de/model-config#adjust-effort-level) für die aktuelle Sitzung fest. Optionen: `low`, `medium`, `high`, `xhigh`, `max`; verfügbare Stufen hängen vom Modell ab. Überschreibt die [`effortLevel`](/de/settings#available-settings) Einstellung für diese Sitzung und wird nicht beibehalten | `claude --effort high` |84| `--effort` | Legen Sie die [Aufwandsstufe](/de/model-config#adjust-effort-level) für die aktuelle Sitzung fest. Optionen: `low`, `medium`, `high`, `xhigh`, `max` oder {/* min-version: 2.1.203 */}}`ultracode`. Verfügbare Stufen hängen vom Modell ab. `ultracode` startet die Sitzung mit `xhigh` Aufwand und [ultracode](/de/workflows#let-claude-decide-with-ultracode) aktiviert, und erfordert Claude Code v2.1.203 oder später. Überschreibt die [`effortLevel`](/de/settings#available-settings) Einstellung für diese Sitzung und wird nicht beibehalten | `claude --effort high` |

82| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Entfernt in v2.1.111. Auto-Modus ist jetzt standardmäßig im `Shift+Tab` Zyklus; verwenden Sie `--permission-mode auto`, um darin zu starten | `claude --permission-mode auto` |85| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Entfernt in v2.1.111. Auto-Modus ist jetzt standardmäßig im `Shift+Tab` Zyklus; verwenden Sie `--permission-mode auto`, um darin zu starten | `claude --permission-mode auto` |

83| `--exclude-dynamic-system-prompt-sections` | Verschieben Sie maschinenspezifische Abschnitte aus dem Systemprompt (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-Systemprompt; 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"` |86| `--exclude-dynamic-system-prompt-sections` | Verschieben Sie maschinenspezifische Abschnitte aus dem Systemprompt (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-Systemprompt; 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"` |

84| `--exec` | Führen Sie einen Shell-Befehl als PTY-gestützten Hintergrund-Job anstelle einer Claude-Sitzung aus. Verwenden Sie mit `--bg`, um von der Shell aus zu starten | `claude --bg --exec 'pytest -x'` |87| `--exec` | Führen Sie einen Shell-Befehl als PTY-gestützten Hintergrund-Job anstelle einer Claude-Sitzung aus. Verwenden Sie mit `--bg`, um von der Shell aus zu starten | `claude --bg --exec 'pytest -x'` |


91| `--include-hook-events` | Schließen Sie alle Hook-Lebenszyklusereignisse in den Ausgabestrom ein. Erfordert `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |94| `--include-hook-events` | Schließen Sie alle Hook-Lebenszyklusereignisse in den Ausgabestrom ein. Erfordert `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |

92| `--include-partial-messages` | Schließen 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"` |95| `--include-partial-messages` | Schließen 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"` |

93| `--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` |96| `--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` |

94| `--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](/de/agent-sdk/structured-outputs)) | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |97| `--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](/de/agent-sdk/structured-outputs). {/* min-version: 2.1.205 */}Claude Code beendet sich mit einem Fehler bei einem ungültigen Schema und akzeptiert das `format` Schlüsselwort als Anmerkung ohne clientseitige Validierung. Vor v2.1.205 erzeugte ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler, und Schemas mit `format` wurden als ungültig behandelt | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

95| `--maintenance` | Führen Sie [Setup Hooks](/de/hooks#setup) mit dem `maintenance` Matcher vor der Sitzung aus (nur Print-Modus) | `claude -p --maintenance "query"` |98| `--maintenance` | Führen Sie [Setup Hooks](/de/hooks#setup) mit dem `maintenance` Matcher vor der Sitzung aus (nur Print-Modus) | `claude -p --maintenance "query"` |

96| `--max-budget-usd` | Maximaler Dollarbetrag, der für API-Aufrufe ausgegeben werden kann, bevor gestoppt wird (nur Print-Modus) | `claude -p --max-budget-usd 5.00 "query"` |99| `--max-budget-usd` | Maximaler Dollarbetrag, der für API-Aufrufe ausgegeben werden kann, bevor gestoppt wird (nur Print-Modus) | `claude -p --max-budget-usd 5.00 "query"` |

97| `--max-turns` | Begrenzen Sie die Anzahl der agentic Turns (nur Print-Modus). Beendet mit einem Fehler, wenn das Limit erreicht wird. Standardmäßig kein Limit | `claude -p --max-turns 3 "query"` |100| `--max-turns` | Begrenzen Sie die Anzahl der agentic Turns (nur Print-Modus). Beendet mit einem Fehler, wenn das Limit erreicht wird. Standardmäßig kein Limit. {/* min-version: 2.1.205 */}Mit `--input-format stream-json` bleibt eine Nachricht, die gesendet wird, während Claude arbeitet, in der Warteschlange und wird als eigener Turn mit eigenem Limit ausgeführt, wenn das Limit den aktuellen beendet. Vor v2.1.205 verwarf Claude Code diese Nachricht | `claude -p --max-turns 3 "query"` |

98| `--mcp-config` | Laden Sie MCP-Server aus JSON-Dateien oder Strings (durch Leerzeichen getrennt) | `claude --mcp-config ./mcp.json` |101| `--mcp-config` | Laden Sie MCP-Server aus JSON-Dateien oder Strings (durch Leerzeichen getrennt) | `claude --mcp-config ./mcp.json` |

99| `--model` | Legt das Modell für die aktuelle Sitzung mit einem Alias für das neueste Modell (`sonnet`, `opus`, `haiku` oder `fable`) oder den vollständigen Namen eines Modells fest. Überschreibt die [`model`](/de/settings#available-settings) Einstellung und [`ANTHROPIC_MODEL`](/de/model-config#environment-variables) | `claude --model claude-sonnet-5` |102| `--model` | Legt das Modell für die aktuelle Sitzung mit einem Alias für das neueste Modell (`sonnet`, `opus`, `haiku` oder `fable`) oder den vollständigen Namen eines Modells fest. Überschreibt die [`model`](/de/settings#available-settings) Einstellung und [`ANTHROPIC_MODEL`](/de/model-config#environment-variables) | `claude --model claude-sonnet-5` |

100| `--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. <br /><br />[`/rename`](/de/commands) ändert den Namen während der Sitzung und zeigt ihn auch in der Eingabeaufforderungsleiste an | `claude -n "my-feature-work"` |103| `--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. <br /><br />[`/rename`](/de/commands) ändert den Namen während der Sitzung und zeigt ihn auch in der Eingabeaufforderungsleiste an | `claude -n "my-feature-work"` |

101| `--no-chrome` | Deaktivieren Sie [Chrome-Browser-Integration](/de/chrome) für diese Sitzung | `claude --no-chrome` |104| `--no-chrome` | Deaktivieren Sie [Chrome-Browser-Integration](/de/chrome) für diese Sitzung | `claude --no-chrome` |

102| `--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`](/de/env-vars) Umgebungsvariable bewirkt das Gleiche in jedem Modus | `claude -p --no-session-persistence "query"` |105| `--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`](/de/env-vars) Umgebungsvariable bewirkt das Gleiche in jedem Modus | `claude -p --no-session-persistence "query"` |

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

104| `--permission-mode` | Beginnen Sie in einem angegebenen [Berechtigungsmodus](/de/permission-modes). Akzeptiert `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` oder `bypassPermissions`. Überschreibt `defaultMode` aus Einstellungsdateien | `claude --permission-mode plan` |107| `--permission-mode` | Beginnen Sie in einem angegebenen [Berechtigungsmodus](/de/permission-modes). Akzeptiert `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` oder {/* min-version: 2.1.200 */}}`manual` als Alias für `default`. Der `manual` Alias wählt den Modus aus, den die Benutzeroberfläche als Manuell 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 | `claude --permission-mode plan` |

105| `--permission-prompt-tool` | Geben Sie ein MCP-Tool an, um Berechtigungsaufforderungen im nicht-interaktiven Modus zu verarbeiten. {/* min-version: 2.1.199 */}Ab v2.1.199 kann das Prompt-Tool ein MCP-Tool, das als [Benutzerinteraktion erforderlich](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet ist, nicht genehmigen: ein `allow` Ergebnis für eines wird in eine Ablehnung umgewandelt | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |108| `--permission-prompt-tool` | Geben Sie ein MCP-Tool an, um Berechtigungsaufforderungen im nicht-interaktiven Modus zu verarbeiten. {/* min-version: 2.1.199 */}Ab v2.1.199 kann das Prompt-Tool ein MCP-Tool, das als [Benutzerinteraktion erforderlich](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet ist, nicht genehmigen: ein `allow` Ergebnis für eines wird in eine Ablehnung umgewandelt | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

106| `--plugin-dir` | Laden Sie ein Plugin aus einem Verzeichnis oder `.zip` Archiv nur für diese Sitzung. Jedes Flag nimmt einen Pfad auf. Wiederholen Sie das Flag für mehrere Plugins: `--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |109| `--plugin-dir` | Laden Sie ein Plugin aus einem Verzeichnis oder `.zip` Archiv nur für diese Sitzung. Jedes Flag nimmt einen Pfad auf. Wiederholen Sie das Flag für mehrere Plugins: `--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |

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

108| `--print`, `-p` | Geben Sie die Antwort ohne interaktiven Modus aus (siehe [Agent SDK-Dokumentation](/de/agent-sdk/overview) für Details zur programmatischen Verwendung) | `claude -p "query"` |111| `--print`, `-p` | Geben Sie die Antwort ohne interaktiven Modus aus (siehe [Agent SDK-Dokumentation](/de/agent-sdk/overview) für Details zur programmatischen Verwendung) | `claude -p "query"` |

109| `--prompt-suggestions` | Geben Sie eine `prompt_suggestion` Nachricht nach jedem Turn mit einem vorhergesagten nächsten Benutzer-Prompt aus. Erfordert `--print`, `--output-format stream-json` und `--verbose`. Siehe [Prompt-Vorschläge](/de/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |112| `--prompt-suggestions` | Geben Sie eine `prompt_suggestion` Nachricht nach jedem Turn mit einem vorhergesagten nächsten Benutzer-Prompt aus. Erfordert `--print`, `--output-format stream-json` und `--verbose`. Siehe [Prompt-Vorschläge](/de/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

110| `--remote` | Erstellen Sie eine neue [Web-Sitzung](/de/claude-code-on-the-web) auf claude.ai mit der bereitgestellten Aufgabenbeschreibung | `claude --remote "Fix the login bug"` |113| `--remote` | Veralteter Alias für `--cloud` | `claude --remote "Fix the login bug"` |

111| `--remote-control`, `--rc` | Starten Sie eine interaktive Sitzung mit aktiviertem [Remote Control](/de/remote-control#start-a-remote-control-session), sodass Sie sie auch von claude.ai oder der Claude App aus steuern können. Optional einen Namen für die Sitzung übergeben | `claude --remote-control "My Project"` |114| `--remote-control`, `--rc` | Starten Sie eine interaktive Sitzung mit aktiviertem [Remote Control](/de/remote-control#start-a-remote-control-session), sodass Sie sie auch von claude.ai oder der Claude App aus steuern können. Optional einen Namen für die Sitzung übergeben | `claude --remote-control "My Project"` |

112| `--remote-control-session-name-prefix <prefix>` | Präfix für automatisch generierte [Remote Control](/de/remote-control) Sitzungsnamen, wenn kein expliziter Name gesetzt ist. Standardmäßig der Hostname Ihrer Maschine, was Namen wie `myhost-graceful-unicorn` erzeugt. Setzen Sie `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` für den gleichen Effekt | `claude remote-control --remote-control-session-name-prefix dev-box` |115| `--remote-control-session-name-prefix <prefix>` | Präfix für automatisch generierte [Remote Control](/de/remote-control) Sitzungsnamen, wenn kein expliziter Name gesetzt ist. Standardmäßig der Hostname Ihrer Maschine, was Namen wie `myhost-graceful-unicorn` erzeugt. Setzen Sie `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` für den gleichen Effekt | `claude remote-control --remote-control-session-name-prefix dev-box` |

113| `--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` |116| `--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` |


120| `--system-prompt` | Ersetzen Sie den gesamten Systemprompt durch benutzerdefinierten Text | `claude --system-prompt "You are a Python expert"` |123| `--system-prompt` | Ersetzen Sie den gesamten Systemprompt durch benutzerdefinierten Text | `claude --system-prompt "You are a Python expert"` |

121| `--system-prompt-file` | Laden Sie den Systemprompt aus einer Datei, ersetzen Sie den Standard-Prompt | `claude --system-prompt-file ./custom-prompt.txt` |124| `--system-prompt-file` | Laden Sie den Systemprompt aus einer Datei, ersetzen Sie den Standard-Prompt | `claude --system-prompt-file ./custom-prompt.txt` |

122| `--teleport` | Setzen Sie eine [Web-Sitzung](/de/claude-code-on-the-web) in Ihrem lokalen Terminal fort | `claude --teleport` |125| `--teleport` | Setzen Sie eine [Web-Sitzung](/de/claude-code-on-the-web) in Ihrem lokalen Terminal fort | `claude --teleport` |

123| `--teammate-mode` | Legen Sie fest, wie [Agent-Team](/de/agent-teams) Teamkollegen angezeigt werden: `in-process` (Standard), `auto`, `tmux` oder {/* min-version: 2.1.186 */}`iterm2` (hinzugefügt in v2.1.186). Der Standard hat sich von `auto` in v2.1.179 geändert. Überschreibt die [`teammateMode`](/de/settings#available-settings) Einstellung für diese Sitzung. Siehe [Anzeigemodus wählen](/de/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |126| `--teammate-mode` | Legen Sie fest, wie [Agent-Team](/de/agent-teams) Teamkollegen angezeigt werden: `in-process` (Standard), `auto`, `tmux` oder {/* min-version: 2.1.186 */}}`iterm2` (hinzugefügt in v2.1.186). Der Standard hat sich von `auto` in v2.1.179 geändert. Überschreibt die [`teammateMode`](/de/settings#available-settings) Einstellung für diese Sitzung. Siehe [Anzeigemodus wählen](/de/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

124| `--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` |127| `--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` |

125| `--tools` | Beschränken Sie, welche integrierten Tools Claude verwenden kann. Verwenden Sie `""`, um alle zu deaktivieren, `"default"` für alle oder Tool-Namen wie `"Bash,Edit,Read"`. MCP-Tools sind nicht betroffen; um diese auch zu verweigern, verwenden Sie `--disallowedTools "mcp__*"` oder übergeben Sie `--strict-mcp-config` ohne `--mcp-config`, sodass keine MCP-Server geladen werden | `claude --tools "Bash,Edit,Read"` |128| `--tools` | Beschränken Sie, welche integrierten Tools Claude verwenden kann. Verwenden Sie `""`, um alle zu deaktivieren, `"default"` für alle oder Tool-Namen wie `"Bash,Edit,Read"`. MCP-Tools sind nicht betroffen; um diese auch zu verweigern, verwenden Sie `--disallowedTools "mcp__*"` oder übergeben Sie `--strict-mcp-config` ohne `--mcp-config`, sodass keine MCP-Server geladen werden | `claude --tools "Bash,Edit,Read"` |

126| `--verbose` | Aktivieren Sie ausführliches Logging, zeigt vollständige Turn-by-Turn-Ausgabe. Überschreibt die [`viewMode`](/de/settings#available-settings) Einstellung für diese Sitzung | `claude --verbose` |129| `--verbose` | Aktivieren Sie ausführliches Logging, zeigt vollständige Turn-by-Turn-Ausgabe. Überschreibt die [`viewMode`](/de/settings#available-settings) Einstellung für diese Sitzung | `claude --verbose` |

code-review.md +1 −1

Details

275 275 

276In jedem Modus führt das Kommentieren von `@claude review` [den PR in Push-ausgelöste Reviews auf](#manually-trigger-reviews), sodass zusätzliche Kosten pro Push nach diesem Kommentar anfallen. Um eine einzelne Überprüfung auszuführen, ohne sich für zukünftige Pushes zu abonnieren, kommentieren Sie stattdessen `@claude review once`.276In jedem Modus führt das Kommentieren von `@claude review` [den PR in Push-ausgelöste Reviews auf](#manually-trigger-reviews), sodass zusätzliche Kosten pro Push nach diesem Kommentar anfallen. Um eine einzelne Überprüfung auszuführen, ohne sich für zukünftige Pushes zu abonnieren, kommentieren Sie stattdessen `@claude review once`.

277 277 

278Kosten erscheinen auf Ihrer Anthropic-Rechnung, unabhängig davon, ob Ihre Organisation Amazon Bedrock oder Google Vertex AI für andere Claude Code-Funktionen verwendet. Um eine monatliche Ausgabenbegrenzung für Code Review festzulegen, gehen Sie zu [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) und konfigurieren Sie das Limit für den Claude Code Review-Service.278Kosten erscheinen auf Ihrer Anthropic-Rechnung, unabhängig davon, ob Ihre Organisation Amazon Bedrock oder Google Cloud's Agent Platform für andere Claude Code-Funktionen verwendet. Um eine monatliche Ausgabenbegrenzung für Code Review festzulegen, gehen Sie zu [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) und konfigurieren Sie das Limit für den Claude Code Review-Service.

279 279 

280Überwachen Sie die Ausgaben über das wöchentliche Kostendiagramm in [analytics](#view-usage) oder die durchschnittliche Kostenspalte pro Repository in den Admin-Einstellungen.280Überwachen Sie die Ausgaben über das wöchentliche Kostendiagramm in [analytics](#view-usage) oder die durchschnittliche Kostenspalte pro Repository in den Admin-Einstellungen.

281 281 

commands.md +16 −16

Details

24 24 

25**Parallele Arbeit ausführen.** Claude delegiert Nebenaufgaben an [Subagenten](/de/sub-agents), und `/tasks` listet auf, was im Hintergrund der aktuellen Sitzung läuft. `/background` trennt die gesamte Sitzung ab, um als [Hintergrund-Agent](/de/agent-view) weiter zu laufen, und gibt Ihr Terminal frei. Für eine große Änderung, die sich über die Codebasis erstreckt, zerlegt `/batch` sie in unabhängige Einheiten und führt jede in ihrem eigenen [Worktree](/de/worktrees) aus. Siehe [Agenten parallel ausführen](/de/agents), um zu verstehen, wie diese Ansätze zusammenhängen.25**Parallele Arbeit ausführen.** Claude delegiert Nebenaufgaben an [Subagenten](/de/sub-agents), und `/tasks` listet auf, was im Hintergrund der aktuellen Sitzung läuft. `/background` trennt die gesamte Sitzung ab, um als [Hintergrund-Agent](/de/agent-view) weiter zu laufen, und gibt Ihr Terminal frei. Für eine große Änderung, die sich über die Codebasis erstreckt, zerlegt `/batch` sie in unabhängige Einheiten und führt jede in ihrem eigenen [Worktree](/de/worktrees) aus. Siehe [Agenten parallel ausführen](/de/agents), um zu verstehen, wie diese Ansätze zusammenhängen.

26 26 

27**Bevor Sie versenden.** `/diff` zeigt, was sich geändert hat, `/code-review` überprüft das Diff auf Korrektheitsfehler und Bereinigungen und kann die Erkenntnisse mit `--fix` anwenden, `/review` führt dieselbe schreibgeschützte Überprüfung auf einem GitHub-Pull-Request durch, und `/security-review` gibt einen tieferen schreibgeschützten Durchgang. `/code-review ultra` führt eine Multi-Agent-Überprüfung in der Cloud aus.27**Bevor Sie versenden.** `/diff` zeigt, was sich geändert hat, `/code-review` überprüft das Diff auf Korrektheitsfehler und Bereinigungen und kann die Erkenntnisse mit `--fix` anwenden, `/review` führt eine schnelle einmalige, schreibgeschützte Überprüfung eines GitHub-Pull-Requests durch, `/code-review <level> <pr#>` führt eine Multi-Agent-Überprüfung eines durch, und `/security-review` überprüft das Diff auf Sicherheitslücken. `/code-review ultra` führt eine Multi-Agent-Überprüfung in der Cloud aus.

28 28 

29**Zwischen Sitzungen.** `/clear` startet frisch bei einer neuen Aufgabe, während die Projektmemory erhalten bleibt. `/resume` und `/branch` ermöglichen es Ihnen, zu einem früheren Gespräch zurückzukehren oder es zu verzweigen. `/teleport` zieht eine Web-Sitzung in dieses Terminal, und `/remote-control` ermöglicht es Ihnen, diese lokale Sitzung von einem anderen Gerät fortzusetzen.29**Zwischen Sitzungen.** `/clear` startet frisch bei einer neuen Aufgabe, während die Projektmemory erhalten bleibt. `/resume` und `/branch` ermöglichen es Ihnen, zu einem früheren Gespräch zurückzukehren oder es zu verzweigen. `/teleport` zieht eine Web-Sitzung in dieses Terminal, und `/remote-control` ermöglicht es Ihnen, diese lokale Sitzung von einem anderen Gerät fortzusetzen.

30 30 

31**Wenn etwas schief geht.** `/rewind` setzt Code und Gespräch zu einem Checkpoint zurück, oder fasst einen Teil des Gesprächs zusammen. `/doctor` und `/debug` diagnostizieren Installations- und Laufzeitprobleme, und `/feedback` meldet einen Fehler mit Sitzungskontext an.31**Wenn etwas schief geht.** `/rewind` setzt Code und Gespräch zu einem Checkpoint zurück, oder fasst einen Teil des Gesprächs zusammen. `/doctor` führt eine Setup-Überprüfung durch, die Installations- und Konfigurationsprobleme diagnostiziert und beheben kann, `/debug` diagnostiziert Laufzeitprobleme, und `/feedback` meldet einen Fehler mit Sitzungskontext an.

32 32 

33<h2 id="all-commands">33<h2 id="all-commands">

34 Alle Befehle34 Alle Befehle


48</Note>48</Note>

49 49 

50| Befehl | Zweck |50| Befehl | Zweck |

51| :--------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |51| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

52| `/add-dir <path>` | Fügen Sie ein Arbeitsverzeichnis für den Dateizugriff während der aktuellen Sitzung hinzu. Die meisten `.claude/`-Konfigurationen werden [nicht erkannt](/de/permissions#additional-directories-grant-file-access-not-configuration) aus dem hinzugefügten Verzeichnis. Sie können die Sitzung später aus dem hinzugefügten Verzeichnis mit `--continue` oder `--resume` fortsetzen |52| `/add-dir <path>` | Fügen Sie ein Arbeitsverzeichnis für den Dateizugriff während der aktuellen Sitzung hinzu. Die meisten `.claude/`-Konfigurationen werden [nicht erkannt](/de/permissions#additional-directories-grant-file-access-not-configuration) aus dem hinzugefügten Verzeichnis. Sie können die Sitzung später aus dem hinzugefügten Verzeichnis mit `--continue` oder `--resume` fortsetzen |

53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}Aktivieren oder deaktivieren Sie das [Advisor-Tool](/de/advisor), das ein zweites Modell für Anleitung in Schlüsselmomenten während einer Aufgabe konsultiert. Akzeptiert `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+) oder eine vollständige Modell-ID. Ohne Argument wird eine Auswahl geöffnet. Erfordert Claude Code v2.1.98 oder später |53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}Aktivieren oder deaktivieren Sie das [Advisor-Tool](/de/advisor), das ein zweites Modell für Anleitung in Schlüsselmomenten während einer Aufgabe konsultiert. Akzeptiert `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+) oder eine vollständige Modell-ID. Ohne Argument wird eine Auswahl geöffnet. Erfordert Claude Code v2.1.98 oder später |

54| `/agents` | {/* min-version: 2.1.198 */}Ab v2.1.198 druckt die Ausführung von `/agents` eine Erinnerung aus, Claude zu bitten, [Subagenten](/de/sub-agents) zu erstellen oder zu verwalten, oder `.claude/agents/` oder `~/.claude/agents/` direkt zu bearbeiten. {/* max-version: 2.1.197 */}In v2.1.197 und früher wird eine interaktive Schnittstelle zum Erstellen und Verwalten von Subagenten-Konfigurationen geöffnet |54| `/agents` | {/* min-version: 2.1.198 */}Ab v2.1.198 druckt die Ausführung von `/agents` eine Erinnerung aus, Claude zu bitten, [Subagenten](/de/sub-agents) zu erstellen oder zu verwalten, oder `.claude/agents/` oder `~/.claude/agents/` direkt zu bearbeiten. {/* max-version: 2.1.197 */}In v2.1.197 und früher wird eine interaktive Schnittstelle zum Erstellen und Verwalten von Subagenten-Konfigurationen geöffnet |


62| `/claude-api [migrate\|managed-agents-onboard]` | **[Skill](/de/skills#bundled-skills).** Laden Sie Claude API-Referenzmaterial für die Sprache Ihres Projekts (Python, TypeScript, Java, Go, Ruby, C#, PHP oder cURL) und Managed Agents-Referenz. Behandelt Tool-Nutzung, Streaming, Batches, strukturierte Ausgaben und häufige Fallstricke. Wird auch automatisch aktiviert, wenn Ihr Code `anthropic` oder `@anthropic-ai/sdk` importiert. Führen Sie `/claude-api migrate` aus, um vorhandenen Claude API-Code auf ein neueres Modell zu aktualisieren: Claude fragt, welche Dateien gescannt werden sollen und welches Modell das Ziel sein soll, dann aktualisiert Modell-IDs, Thinking-Konfiguration und andere Parameter, die sich zwischen Versionen geändert haben. Führen Sie `/claude-api managed-agents-onboard` aus, um eine interaktive Anleitung zu erhalten, die einen neuen Managed Agent von Grund auf erstellt |62| `/claude-api [migrate\|managed-agents-onboard]` | **[Skill](/de/skills#bundled-skills).** Laden Sie Claude API-Referenzmaterial für die Sprache Ihres Projekts (Python, TypeScript, Java, Go, Ruby, C#, PHP oder cURL) und Managed Agents-Referenz. Behandelt Tool-Nutzung, Streaming, Batches, strukturierte Ausgaben und häufige Fallstricke. Wird auch automatisch aktiviert, wenn Ihr Code `anthropic` oder `@anthropic-ai/sdk` importiert. Führen Sie `/claude-api migrate` aus, um vorhandenen Claude API-Code auf ein neueres Modell zu aktualisieren: Claude fragt, welche Dateien gescannt werden sollen und welches Modell das Ziel sein soll, dann aktualisiert Modell-IDs, Thinking-Konfiguration und andere Parameter, die sich zwischen Versionen geändert haben. Führen Sie `/claude-api managed-agents-onboard` aus, um eine interaktive Anleitung zu erhalten, die einen neuen Managed Agent von Grund auf erstellt |

63| `/clear [name]` | Starten Sie ein neues Gespräch mit leerem Kontext. Das vorherige Gespräch bleibt in `/resume` verfügbar. Übergeben Sie einen Namen, um das vorherige Gespräch in der `/resume`-Auswahl zu kennzeichnen. Um Kontext freizugeben und gleichzeitig das gleiche Gespräch fortzusetzen, verwenden Sie stattdessen `/compact`. Aliase: `/reset`, `/new` |63| `/clear [name]` | Starten Sie ein neues Gespräch mit leerem Kontext. Das vorherige Gespräch bleibt in `/resume` verfügbar. Übergeben Sie einen Namen, um das vorherige Gespräch in der `/resume`-Auswahl zu kennzeichnen. Um Kontext freizugeben und gleichzeitig das gleiche Gespräch fortzusetzen, verwenden Sie stattdessen `/compact`. Aliase: `/reset`, `/new` |

64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/de/skills#bundled-skills).** Überprüfen Sie den aktuellen Diff auf Korrektheitsfehler und auf Wiederverwendung, Vereinfachung und Effizienzbereinigungen. Übergeben Sie `--fix`, um Erkenntnisse auf Ihren Arbeitsbaum anzuwenden, `--comment`, um sie als Inline-GitHub-PR-Kommentare zu posten, oder `ultra`, um eine tiefe [Cloud-Überprüfung](/de/ultrareview) durchzuführen. {/* min-version: 2.1.154 */}Ab v2.1.154 führt `/simplify` eine separate Bereinigungsüberprüfung durch, die Fixes anwendet, ohne nach Fehlern zu suchen. Siehe [Diff lokal überprüfen](/de/code-review#review-a-diff-locally) für Anstrengungsstufen und Zielbestimmung |64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/de/skills#bundled-skills).** Überprüfen Sie den aktuellen Diff auf Korrektheitsfehler und auf Wiederverwendung, Vereinfachung und Effizienzbereinigungen. Übergeben Sie `--fix`, um Erkenntnisse auf Ihren Arbeitsbaum anzuwenden, `--comment`, um sie als Inline-GitHub-PR-Kommentare zu posten, oder `ultra`, um eine tiefe [Cloud-Überprüfung](/de/ultrareview) durchzuführen. {/* min-version: 2.1.154 */}Ab v2.1.154 führt `/simplify` eine separate Bereinigungsüberprüfung durch, die Fixes anwendet, ohne nach Fehlern zu suchen. Siehe [Diff lokal überprüfen](/de/code-review#review-a-diff-locally) für Anstrengungsstufen und Zielbestimmung |

65| `/color [color\|default]` | Legen Sie die Farbe der Eingabeaufforderungsleiste für die aktuelle Sitzung fest. Verfügbare Farben: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Verwenden Sie `default`, um zurückzusetzen, oder führen Sie ohne Argument aus, um eine zufällige Farbe auszuwählen. Wenn [Remote Control](/de/remote-control) verbunden ist, wird die Farbe mit claude.ai/code synchronisiert |65| `/color [color\|default]` | Legen Sie die Farbe der Eingabeaufforderungsleiste für die aktuelle Sitzung fest. Verfügbare Farben: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Verwenden Sie `default`, um zurückzusetzen, oder führen Sie ohne Argument aus, um eine zufällige Farbe auszuwählen. Wenn [Remote Control](/de/remote-control) verbunden ist, wird die Farbe mit claude.ai/code synchronisiert. {/* min-version: 2.1.205 */}Auch im nicht-interaktiven Modus (`-p`) verfügbar; erfordert Claude Code v2.1.205 oder später |

66| `/compact [instructions]` | Geben Sie Kontext frei, indem Sie das bisherige Gespräch zusammenfassen. Übergeben Sie optional Fokusanweisungen für die Zusammenfassung. Siehe [wie Komprimierung Regeln, Skills und Speicherdateien handhabt](/de/context-window#what-survives-compaction) |66| `/compact [instructions]` | Geben Sie Kontext frei, indem Sie das bisherige Gespräch zusammenfassen. Übergeben Sie optional Fokusanweisungen für die Zusammenfassung. Siehe [wie Komprimierung Regeln, Skills und Speicherdateien handhabt](/de/context-window#what-survives-compaction) |

67| `/config [key=value ...]` | Öffnen Sie die [Einstellungen](/de/settings)-Schnittstelle, um Design, Modell, [Ausgabestil](/de/output-styles) und andere Einstellungen anzupassen. {/* min-version: 2.1.181 */}Ab v2.1.181 können Sie ein oder mehrere `key=value`-Paare übergeben, um eine Einstellung direkt festzulegen, ohne die Schnittstelle zu öffnen, zum Beispiel `/config thinking=false`. {/* min-version: 2.1.182 */}Ab v2.1.182 werden auch benannte Kurzschlüssel akzeptiert, wie `/config theme=dark` oder `/config model=sonnet`. Das `key=value`-Format funktioniert auch im nicht-interaktiven Modus (`-p`) und von [Remote Control](/de/remote-control). Führen Sie `/config --help` aus, um jeden einstellbaren Schlüssel mit seinen Optionen aufzulisten. Alias: `/settings` |67| `/config [key=value ...]` | Öffnen Sie die [Einstellungen](/de/settings)-Schnittstelle, um Design, Modell, [Ausgabestil](/de/output-styles) und andere Einstellungen anzupassen. {/* min-version: 2.1.181 */}Ab v2.1.181 können Sie ein oder mehrere `key=value`-Paare übergeben, um eine Einstellung direkt festzulegen, ohne die Schnittstelle zu öffnen, zum Beispiel `/config thinking=false`. {/* min-version: 2.1.182 */}Ab v2.1.182 werden auch benannte Kurzschlüssel akzeptiert, wie `/config theme=dark` oder `/config model=sonnet`. Das `key=value`-Format funktioniert auch im nicht-interaktiven Modus (`-p`) und von [Remote Control](/de/remote-control). Führen Sie `/config --help` aus, um jeden einstellbaren Schlüssel mit seinen Optionen aufzulisten. Alias: `/settings` |

68| `/context [all]` | Visualisieren Sie die aktuelle Kontextnutzung als farbiges Gitter. Zeigt Optimierungsvorschläge für kontextintensive Tools, Speicherverschwendung und Kapazitätswarnungen. Im [Vollbildmodus](/de/fullscreen) wird die Pro-Element-Aufschlüsselung zusammengeklappt, um das Gitter sichtbar zu halten. Übergeben Sie `all`, um es zu erweitern |68| `/context [all]` | Visualisieren Sie die aktuelle Kontextnutzung als farbiges Gitter. Zeigt Optimierungsvorschläge für kontextintensive Tools, Speicherverschwendung und Kapazitätswarnungen. Im [Vollbildmodus](/de/fullscreen) wird die Pro-Element-Aufschlüsselung zusammengeklappt, um das Gitter sichtbar zu halten. Übergeben Sie `all`, um es zu erweitern |


72| `/debug [description]` | **[Skill](/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 die Ausführung von `/debug` während der Sitzung die Erfassung von Protokollen ab diesem Punkt. Beschreiben Sie optional das Problem, um die Analyse zu fokussieren |72| `/debug [description]` | **[Skill](/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 die Ausführung von `/debug` während der Sitzung die Erfassung von Protokollen ab diesem Punkt. Beschreiben Sie optional das Problem, um die Analyse zu fokussieren |

73| `/deep-research <question>` | **[Workflow](/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 |73| `/deep-research <question>` | **[Workflow](/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 |

74| `/design-login` | Autorisieren Sie den Design-System-Zugriff für `/design-sync` mit Ihrem claude.ai-Konto |74| `/design-login` | Autorisieren Sie den Design-System-Zugriff für `/design-sync` mit Ihrem claude.ai-Konto |

75| `/design-sync [hint]` | **[Skill](/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 von ihm erstellten Designs Ihre echten Komponenten verwenden. Benennen Sie optional das Design-System, zum Beispiel `/design-sync Acme DS`. Eine erste Synchronisierung überprüft jede Komponente und kann bei einem großen Repo mehrere Stunden dauern. Verfügbar auf der Anthropic API; auf Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry kann das zugrunde liegende Tool nicht auf claude.ai zugreifen, daher ist der Befehl nicht verfügbar |75| `/design-sync [hint]` | **[Skill](/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 von ihm erstellten Designs Ihre echten Komponenten verwenden. Benennen Sie optional das Design-System, zum Beispiel `/design-sync Acme DS`. Eine erste Synchronisierung überprüft jede Komponente und kann bei einem großen Repo mehrere Stunden dauern. Verfügbar auf der Anthropic API; auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry kann das zugrunde liegende Tool nicht auf claude.ai zugreifen, daher ist der Befehl nicht verfügbar |

76| `/desktop` | Setzen Sie die aktuelle Sitzung in der Claude Code Desktop-App fort. Erfordert macOS oder Windows und ein Claude-Abonnement. Alias: `/app` |76| `/desktop` | Setzen Sie die aktuelle Sitzung in der Claude Code Desktop-App fort. Erfordert macOS oder Windows und ein Claude-Abonnement. Alias: `/app` |

77| `/diff` | Öffnen Sie einen interaktiven Diff-Viewer, der nicht committete Änderungen und Pro-Turn-Diffs anzeigt. Verwenden Sie Links-/Rechtspfeile, um zwischen dem aktuellen Git-Diff und einzelnen Claude-Turns zu wechseln, und Auf-/Abwärtspfeile zum Durchsuchen von Dateien. {/* min-version: 2.1.198 */}Ab v2.1.198 wird der offene Viewer auch automatisch aktualisiert, wenn sich der Git-Status des Repositorys außerhalb der Sitzung ändert, z. B. bei einem Branch-Wechsel oder Commit in einem anderen Terminal |77| `/diff` | Öffnen Sie einen interaktiven Diff-Viewer, der nicht committete Änderungen und Pro-Turn-Diffs anzeigt. Verwenden Sie Links-/Rechtspfeile, um zwischen dem aktuellen Git-Diff und einzelnen Claude-Turns zu wechseln, und Auf-/Abwärtspfeile zum Durchsuchen von Dateien. {/* min-version: 2.1.198 */}Ab v2.1.198 wird der offene Viewer auch automatisch aktualisiert, wenn sich der Git-Status des Repositorys außerhalb der Sitzung ändert, z. B. bei einem Branch-Wechsel oder Commit in einem anderen Terminal |

78| `/doctor` | Diagnostizieren und überprüfen Sie Ihre Claude Code-Installation und -Einstellungen. Ergebnisse werden mit Statussymbolen angezeigt. Drücken Sie `f`, um Claude alle gemeldeten Probleme beheben zu lassen |78| `/doctor` | **[Skill](/de/skills#bundled-skills).** Führen Sie eine Setup-Überprüfung durch, 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, dedupliziert lokale `CLAUDE.md`-Dateien gegen eingecheckte, migriert immer geladene Anleitung in [Skills](/de/skills) und verschachtelte `CLAUDE.md`-Dateien, die bei Bedarf geladen werden, kennzeichnet langsame [Hooks](/de/hooks) und prüft auf eine neuere Version. Bietet auch an, [Auto-Modus](/de/permissions#permission-modes) zu Ihrem Standard zu machen und häufig abgelehnte schreibgeschützte Befehle [vorab zu genehmigen](/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`. {/* min-version: 2.1.205 */}Vor v2.1.205 öffnete `/doctor` einen schreibgeschützten Diagnose-Bildschirm und das Drücken von `f` sendete den Bericht an Claude |

79| `/effort [level\|auto]` | Legen Sie die Modell-[Anstrengungsstufe](/de/model-config#adjust-effort-level) fest. Akzeptiert `low`, `medium`, `high`, `xhigh`, `max` oder `ultracode`; verfügbare Stufen hängen vom Modell ab, und `max` und `ultracode` sind nur für die Sitzung. `ultracode` ist eine Claude Code-Einstellung, die `xhigh`-Reasoning mit automatischer [Workflow](/de/workflows#let-claude-decide-with-ultracode)-Orchestrierung kombiniert. `auto` setzt auf den Modellstandard zurück. Ohne Argument wird ein interaktiver Schieberegler geöffnet; verwenden Sie Links- und Rechtspfeile, um eine Stufe auszuwählen, und `Enter`, um sie anzuwenden. Wird sofort wirksam, ohne auf die Fertigstellung der aktuellen Antwort zu warten |79| `/effort [level\|auto]` | Legen Sie die Modell-[Anstrengungsstufe](/de/model-config#adjust-effort-level) fest. Akzeptiert `low`, `medium`, `high`, `xhigh`, `max` oder `ultracode`; verfügbare Stufen hängen vom Modell ab, und `max` und `ultracode` sind nur für die Sitzung. `ultracode` ist eine Claude Code-Einstellung, die `xhigh`-Reasoning mit automatischer [Workflow](/de/workflows#let-claude-decide-with-ultracode)-Orchestrierung kombiniert. `auto` setzt auf den Modellstandard zurück. Ohne Argument wird ein interaktiver Schieberegler geöffnet; verwenden Sie Links- und Rechtspfeile, um eine Stufe auszuwählen, und `Enter`, um sie anzuwenden. Wird sofort wirksam, ohne auf die Fertigstellung der aktuellen Antwort zu warten. {/* min-version: 2.1.205 */}Auch im nicht-interaktiven Modus (`-p`) mit einem Level-Argument verfügbar, wo es nur auf die aktuelle Sitzung angewendet wird und nicht als Standard gespeichert wird; erfordert Claude Code v2.1.205 oder später. Auf Fable 5, Opus 4.8 und Opus 4.7 meldet ein nicht-interaktives `/effort` `Not applied`, während die [Modell-Standard-Anstrengungssperre](/de/model-config#adjust-effort-level) in Kraft ist, daher übergeben Sie stattdessen `--effort` beim Start |

80| `/exit` | Beenden Sie die CLI. In einer angehängten [Hintergrund-Sitzung](/de/agent-view#attach-to-a-session) wird diese getrennt und die Sitzung läuft weiter. Alias: `/quit` |80| `/exit` | Beenden Sie die CLI. In einer angehängten [Hintergrund-Sitzung](/de/agent-view#attach-to-a-session) wird diese getrennt und die Sitzung läuft weiter. Alias: `/quit` |

81| `/export [filename]` | Exportieren Sie das aktuelle Gespräch als Klartext. Mit einem Dateinamen wird direkt in diese Datei geschrieben. Ohne Dateinamen wird ein Dialog geöffnet, um in die Zwischenablage zu kopieren oder in eine Datei zu speichern |81| `/export [filename]` | Exportieren Sie das aktuelle Gespräch als Klartext. Mit einem Dateinamen wird direkt in diese Datei geschrieben. Ohne Dateinamen wird ein Dialog geöffnet, um in die Zwischenablage zu kopieren oder in eine Datei zu speichern |

82| `/fast [on\|off]` | Schalten Sie den [schnellen Modus](/de/fast-mode) ein oder aus |82| `/fast [on\|off]` | Schalten Sie den [schnellen Modus](/de/fast-mode) ein oder aus. {/* min-version: 2.1.205 */}Im nicht-interaktiven Modus (`-p`) funktioniert `/fast` nur in einer Sitzung, die mit schnellem Modus in ihrem [`--settings`](/de/cli-reference#cli-flags)-Wert gestartet wurde, zum Beispiel `claude -p --settings '{"fastMode": true}'`; der Toggle wird dann nur auf die aktuelle Sitzung angewendet und nicht als Standard gespeichert, und in jeder anderen nicht-interaktiven Sitzung meldet der Befehl, dass schneller Modus nicht verfügbar ist. Erfordert Claude Code v2.1.205 oder später |

83| `/feedback [report]` | Geben Sie Feedback zu Claude Code, melden Sie einen Fehler oder teilen Sie Ihr Gespräch. Aliase: `/bug`, `/share` |83| `/feedback [report]` | Geben Sie Feedback zu Claude Code, melden Sie einen Fehler oder teilen Sie Ihr Gespräch. Aliase: `/bug`, `/share` |

84| `/fewer-permission-prompts` | **[Skill](/de/skills#bundled-skills).** Scannen Sie Ihre Transkripte nach häufigen schreibgeschützten Bash- und MCP-Tool-Aufrufen, dann fügen Sie eine priorisierte Allowlist zu Projekt `.claude/settings.json` hinzu, um Berechtigungsaufforderungen zu reduzieren |84| `/fewer-permission-prompts` | **[Skill](/de/skills#bundled-skills).** Scannen Sie Ihre Transkripte nach häufigen schreibgeschützten Bash- und MCP-Tool-Aufrufen, dann fügen Sie eine priorisierte Allowlist zu Projekt `.claude/settings.json` hinzu, um Berechtigungsaufforderungen zu reduzieren |

85| `/focus` | Schalten Sie die Fokusansicht um, die nur Ihre letzte Eingabeaufforderung, eine einzeilige Tool-Call-Zusammenfassung mit Edit-Diffstats und die endgültige Antwort anzeigt. {/* min-version: 2.1.198 */}Ab v2.1.198 zählt die Tool-Call-Zusammenfassung auch die in der Turn gestarteten Subagenten und klappt abgeschlossene Hintergrund-Task-Benachrichtigungen in eine einzelne Zählung zusammen. Die Auswahl bleibt über Sitzungen hinweg erhalten; legen Sie [`viewMode`](/de/settings#available-settings) in Einstellungen fest, um dies zu überschreiben. Nur in [Vollbildrendering](/de/fullscreen) verfügbar |85| `/focus` | Schalten Sie die Fokusansicht um, die nur Ihre letzte Eingabeaufforderung, eine einzeilige Tool-Call-Zusammenfassung mit Edit-Diffstats und die endgültige Antwort anzeigt. {/* min-version: 2.1.198 */}Ab v2.1.198 zählt die Tool-Call-Zusammenfassung auch die in der Turn gestarteten Subagenten und klappt abgeschlossene Hintergrund-Task-Benachrichtigungen in eine einzelne Zählung zusammen. Die Auswahl bleibt über Sitzungen hinweg erhalten; legen Sie [`viewMode`](/de/settings#available-settings) in Einstellungen fest, um dies zu überschreiben. Nur in [Vollbildrendering](/de/fullscreen) verfügbar |


97| `/login` | Melden Sie sich bei Ihrem Anthropic-Konto an |97| `/login` | Melden Sie sich bei Ihrem Anthropic-Konto an |

98| `/logout` | Melden Sie sich von Ihrem Anthropic-Konto ab |98| `/logout` | Melden Sie sich von Ihrem Anthropic-Konto ab |

99| `/loop [interval] [prompt]` | **[Skill](/de/skills#bundled-skills).** Führen Sie eine Eingabeaufforderung wiederholt aus, während die Sitzung offen bleibt. Lassen Sie das Intervall weg und Claude bestimmt das Tempo zwischen Iterationen selbst. Lassen Sie die Eingabeaufforderung weg und Claude führt, [wo verfügbar](/de/scheduled-tasks#run-the-built-in-maintenance-prompt), eine autonome Wartungsprüfung durch oder die Eingabeaufforderung in `.claude/loop.md`. Beispiel: `/loop 5m check if the deploy finished`. Siehe [Eingabeaufforderungen nach Zeitplan ausführen](/de/scheduled-tasks). Alias: `/proactive` |99| `/loop [interval] [prompt]` | **[Skill](/de/skills#bundled-skills).** Führen Sie eine Eingabeaufforderung wiederholt aus, während die Sitzung offen bleibt. Lassen Sie das Intervall weg und Claude bestimmt das Tempo zwischen Iterationen selbst. Lassen Sie die Eingabeaufforderung weg und Claude führt, [wo verfügbar](/de/scheduled-tasks#run-the-built-in-maintenance-prompt), eine autonome Wartungsprüfung durch oder die Eingabeaufforderung in `.claude/loop.md`. Beispiel: `/loop 5m check if the deploy finished`. Siehe [Eingabeaufforderungen nach Zeitplan ausführen](/de/scheduled-tasks). Alias: `/proactive` |

100| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Verwalten Sie MCP-Serververbindungen und OAuth-Authentifizierung. Führen Sie ohne Argument aus, um die interaktive Liste zu öffnen, übergeben Sie `reconnect <server>`, um einen getrennt verbundenen Server erneut zu verbinden, oder übergeben Sie `enable`/`disable` mit einem Servernamen oder `all`, um den Verbindungsstatus zu ändern, ohne das Dialogfeld zu öffnen |100| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Verwalten Sie MCP-Serververbindungen und OAuth-Authentifizierung. Führen Sie ohne Argument aus, um die interaktive Liste zu öffnen, übergeben Sie `reconnect <server>`, um einen getrennt verbundenen Server erneut zu verbinden, oder übergeben Sie `enable`/`disable` mit einem Servernamen oder `all`, um den Verbindungsstatus zu ändern, ohne das Dialogfeld zu öffnen. {/* min-version: 2.1.205 */}Auch im nicht-interaktiven Modus (`-p`) verfügbar, wo die Ausführung ohne Argument eine Textzusammenfassung des Serverstatus anstelle der Liste druckt; erfordert Claude Code v2.1.205 oder später |

101| `/memory` | Bearbeiten Sie `CLAUDE.md`-Speicherdateien, aktivieren oder deaktivieren Sie [Auto-Memory](/de/memory#auto-memory), und zeigen Sie Auto-Memory-Einträge an |101| `/memory` | Bearbeiten Sie `CLAUDE.md`-Speicherdateien, aktivieren oder deaktivieren Sie [Auto-Memory](/de/memory#auto-memory), und zeigen Sie Auto-Memory-Einträge an |

102| `/mobile` | Zeigen Sie QR-Code zum Herunterladen der Claude Mobile-App an. Aliase: `/ios`, `/android` |102| `/mobile` | Zeigen Sie QR-Code zum Herunterladen der Claude Mobile-App an. Aliase: `/ios`, `/android` |

103| `/model [model]` | Wechseln Sie das KI-Modell und speichern Sie es als Standard für neue Sitzungen. Für Modelle, die dies unterstützen, verwenden Sie Links-/Rechtspfeile, um die [Anstrengungsstufe anzupassen](/de/model-config#adjust-effort-level). Ohne Argument wird eine Auswahl geöffnet; drücken Sie `s` auf einer Zeile, um nur für die aktuelle Sitzung zu wechseln. Die Auswahl fordert zur Bestätigung auf, wenn das Gespräch vorherige Ausgaben hat, da die nächste Antwort die vollständige Historie ohne zwischengespeicherten Kontext erneut liest. Nach Bestätigung wird die Änderung sofort wirksam, ohne auf die Fertigstellung der aktuellen Antwort zu warten |103| `/model [model]` | Wechseln Sie das KI-Modell und speichern Sie es als Standard für neue Sitzungen. Für Modelle, die dies unterstützen, verwenden Sie Links-/Rechtspfeile, um die [Anstrengungsstufe anzupassen](/de/model-config#adjust-effort-level). Ohne Argument wird eine Auswahl geöffnet; drücken Sie `s` auf einer Zeile, um nur für die aktuelle Sitzung zu wechseln. Die Auswahl fordert zur Bestätigung auf, wenn das Gespräch vorherige Ausgaben hat, da die nächste Antwort die vollständige Historie ohne zwischengespeicherten Kontext erneut liest. Nach Bestätigung wird die Änderung sofort wirksam, ohne auf die Fertigstellung der aktuellen Antwort zu warten. {/* min-version: 2.1.205 */}Auch im nicht-interaktiven Modus (`-p`) mit einem Model-Argument anstelle der Auswahl verfügbar, wo es nur auf die aktuelle Sitzung angewendet wird und nicht als Standard gespeichert wird; erfordert Claude Code v2.1.205 oder später |

104| `/passes` | Teilen Sie eine kostenlose Woche Claude Code mit Freunden. Nur sichtbar, wenn Ihr Konto berechtigt ist |104| `/passes` | Teilen Sie eine kostenlose Woche Claude Code mit Freunden. Nur sichtbar, wenn Ihr Konto berechtigt ist |

105| `/permissions` | Verwalten Sie Zulassen-, Fragen- und Ablehnen-Regeln für Tool-Berechtigungen. Öffnet einen interaktiven Dialog, in dem Sie Regeln nach Umfang anzeigen, Regeln hinzufügen oder entfernen, Arbeitsverzeichnisse verwalten und [kürzliche Auto-Modus-Ablehnungen](/de/auto-mode-config#review-denials) überprüfen können. Alias: `/allowed-tools` |105| `/permissions` | Verwalten Sie Zulassen-, Fragen- und Ablehnen-Regeln für Tool-Berechtigungen. Öffnet einen interaktiven Dialog, in dem Sie Regeln nach Umfang anzeigen, Regeln hinzufügen oder entfernen, Arbeitsverzeichnisse verwalten und [kürzliche Auto-Modus-Ablehnungen](/de/auto-mode-config#review-denials) überprüfen können. Alias: `/allowed-tools` |

106| `/plan [description]` | Geben Sie den Plan-Modus direkt von der Eingabeaufforderung ein. Übergeben Sie eine optionale Beschreibung, um den Plan-Modus zu aktivieren und sofort mit dieser Aufgabe zu beginnen, zum Beispiel `/plan fix the auth bug` |106| `/plan [description]` | Geben Sie den Plan-Modus direkt von der Eingabeaufforderung ein. Übergeben Sie eine optionale Beschreibung, um den Plan-Modus zu aktivieren und sofort mit dieser Aufgabe zu beginnen, zum Beispiel `/plan fix the auth bug` |


108| `/powerup` | Entdecken Sie Claude Code-Funktionen durch schnelle interaktive Lektionen mit animierten Demos |108| `/powerup` | Entdecken Sie Claude Code-Funktionen durch schnelle interaktive Lektionen mit animierten Demos |

109| `/pr-comments [PR]` | {/* max-version: 2.1.90 */}Entfernt in v2.1.91. Fragen Sie Claude direkt, um Pull Request-Kommentare anzuzeigen. In früheren Versionen werden Kommentare aus einem GitHub Pull Request abgerufen und angezeigt; erkennt automatisch den PR für den aktuellen Branch, oder übergeben Sie eine PR-URL oder -Nummer. Erfordert die `gh` CLI |109| `/pr-comments [PR]` | {/* max-version: 2.1.90 */}Entfernt in v2.1.91. Fragen Sie Claude direkt, um Pull Request-Kommentare anzuzeigen. In früheren Versionen werden Kommentare aus einem GitHub Pull Request abgerufen und angezeigt; erkennt automatisch den PR für den aktuellen Branch, oder übergeben Sie eine PR-URL oder -Nummer. Erfordert die `gh` CLI |

110| `/privacy-settings` | Zeigen Sie Ihre Datenschutzeinstellungen an und aktualisieren Sie sie. Nur für Pro- und Max-Plan-Abonnenten verfügbar |110| `/privacy-settings` | Zeigen Sie Ihre Datenschutzeinstellungen an und aktualisieren Sie sie. Nur für Pro- und Max-Plan-Abonnenten verfügbar |

111| `/radio` | Öffnen Sie Claude FM Lo-Fi-Radio in Ihrem Browser. Druckt die Stream-URL, wenn kein Browser verfügbar ist. Nicht verfügbar auf Bedrock, Vertex oder Foundry |111| `/radio` | Öffnen Sie Claude FM Lo-Fi-Radio in Ihrem Browser. Druckt die Stream-URL, wenn kein Browser verfügbar ist. Nicht verfügbar auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry |

112| `/recap` | Generieren Sie eine einzeilige Zusammenfassung der aktuellen Sitzung auf Anfrage. Siehe [Sitzungs-Recap](/de/interactive-mode#session-recap) für das automatische Recap, das angezeigt wird, nachdem Sie weg waren |112| `/recap` | Generieren Sie eine einzeilige Zusammenfassung der aktuellen Sitzung auf Anfrage. Siehe [Sitzungs-Recap](/de/interactive-mode#session-recap) für das automatische Recap, das angezeigt wird, nachdem Sie weg waren |

113| `/release-notes` | Zeigen Sie das Änderungsprotokoll in einer interaktiven Versionswahl an. Wählen Sie eine bestimmte Version, um ihre Versionshinweise anzuzeigen, oder wählen Sie, um alle Versionen anzuzeigen |113| `/release-notes` | Zeigen Sie das Änderungsprotokoll in einer interaktiven Versionswahl an. Wählen Sie eine bestimmte Version, um ihre Versionshinweise anzuzeigen, oder wählen Sie, um alle Versionen anzuzeigen |

114| `/reload-plugins [--force]` | Laden Sie alle aktiven [Plugins](/de/plugins) neu, um ausstehende Änderungen anzuwenden, ohne neu zu starten. Meldet Zählungen für jede neu geladene Komponente und kennzeichnet alle Ladefehler. Wenn das Neuladen ändern würde, welche MCP-Tools geladen werden und den Prompt-Cache ungültig machen würde, warnt der Befehl und überspringt, es sei denn, Sie übergeben `--force` |114| `/reload-plugins [--force]` | Laden Sie alle aktiven [Plugins](/de/plugins) neu, um ausstehende Änderungen anzuwenden, ohne neu zu starten. Meldet Zählungen für jede neu geladene Komponente und kennzeichnet alle Ladefehler. Wenn das Neuladen ändern würde, welche MCP-Tools geladen werden und den Prompt-Cache ungültig machen würde, warnt der Befehl und überspringt, es sei denn, Sie übergeben `--force` |

115| `/reload-skills` | {/* min-version: 2.1.152 */}Scannen Sie [Skill](/de/skills)- und Befehlsverzeichnisse erneut, damit Skills, die während der Sitzung auf der Festplatte hinzugefügt oder geändert wurden, ohne Neustart verfügbar werden. Meldet, wie viele Skills verfügbar sind und wie viele hinzugefügt oder entfernt wurden. Hinzugefügt in v2.1.152 |115| `/reload-skills` | {/* min-version: 2.1.152 */}Scannen Sie [Skill](/de/skills)- und Befehlsverzeichnisse erneut, damit Skills, die während der Sitzung auf der Festplatte hinzugefügt oder geändert wurden, ohne Neustart verfügbar werden. Meldet, wie viele Skills verfügbar sind und wie viele hinzugefügt oder entfernt wurden. Hinzugefügt in v2.1.152 |

116| `/remote-control` | Machen Sie diese Sitzung für [Fernsteuerung](/de/remote-control) von claude.ai verfügbar. Alias: `/rc` |116| `/remote-control` | Machen Sie diese Sitzung für [Fernsteuerung](/de/remote-control) von claude.ai verfügbar. Alias: `/rc` |

117| `/remote-env` | Wählen Sie die Standard-Umgebung für [Cloud-Agenten](/de/claude-code-on-the-web#configure-your-environment) |117| `/remote-env` | Wählen Sie die Standard-Umgebung für [Cloud-Agenten](/de/claude-code-on-the-web#configure-your-environment) |

118| `/rename [name]` | Benennen Sie die aktuelle Sitzung um und zeigen Sie den Namen in der Eingabeaufforderungsleiste an. Ohne einen Namen wird automatisch einer aus dem Gesprächsverlauf generiert |118| `/rename [name]` | Benennen Sie die aktuelle Sitzung um und zeigen Sie den Namen in der Eingabeaufforderungsleiste an. Ohne einen Namen wird automatisch einer aus dem Gesprächsverlauf generiert. {/* min-version: 2.1.205 */}Auch im nicht-interaktiven Modus (`-p`) verfügbar; erfordert Claude Code v2.1.205 oder später |

119| `/resume [session]` | Setzen Sie ein Gespräch nach ID oder Name fort, oder öffnen Sie die Sitzungsauswahl. Ab v2.1.144 werden [Hintergrund-Sitzungen](/de/agent-view) in der Auswahl mit `bg` gekennzeichnet angezeigt. Alias: `/continue` |119| `/resume [session]` | Setzen Sie ein Gespräch nach ID oder Name fort, oder öffnen Sie die Sitzungsauswahl. Ab v2.1.144 werden [Hintergrund-Sitzungen](/de/agent-view) in der Auswahl mit `bg` gekennzeichnet angezeigt. Alias: `/continue` |

120| `/review [PR]` | Überprüfen Sie einen GitHub Pull Request nach Nummer, wobei Sie die gleiche Review-Engine wie `/code-review` verwenden. Ohne Argumente werden offene PRs zur Auswahl aufgelistet. Für eine Cloud-basierte Überprüfung siehe [`/code-review ultra`](/de/ultrareview) |120| `/review [PR]` | {/* min-version: 2.1.202 */}Führen Sie eine schnelle, einmalige, schreibgeschützte Überprüfung eines GitHub Pull Request nach Nummer durch. Ohne Argument werden offene PRs zur Auswahl aufgelistet; Text nach der PR-Nummer wird zu zusätzlichen Review-Anweisungen. Ab v2.1.186 bis v2.1.201 führte `/review` stattdessen die gleiche Multi-Agent-Engine wie `/code-review medium` aus. Für eine Multi-Agent-Überprüfung auf einer gewählten Anstrengungsstufe verwenden Sie [`/code-review <level> <pr#>`](/de/code-review#review-a-diff-locally); für eine Cloud-basierte Überprüfung siehe [`/code-review ultra`](/de/ultrareview) |

121| `/rewind` | Spulen Sie das Gespräch und/oder den Code zu einem früheren Punkt zurück, oder fassen Sie ab einer ausgewählten Nachricht zusammen. Siehe [Checkpointing](/de/checkpointing). Aliase: `/checkpoint`, `/undo` |121| `/rewind` | Spulen Sie das Gespräch und/oder den Code zu einem früheren Punkt zurück, oder fassen Sie ab einer ausgewählten Nachricht zusammen. Siehe [Checkpointing](/de/checkpointing). Aliase: `/checkpoint`, `/undo` |

122| `/run` | **[Skill](/de/skills#bundled-skills).** Starten und steuern Sie die App Ihres Projekts, um eine Änderung in der laufenden App zu sehen, nicht nur in Tests. Siehe [App ausführen und überprüfen](/de/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Erfordert Claude Code v2.1.145 oder später |122| `/run` | **[Skill](/de/skills#bundled-skills).** Starten und steuern Sie die App Ihres Projekts, um eine Änderung in der laufenden App zu sehen, nicht nur in Tests. Siehe [App ausführen und überprüfen](/de/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Erfordert Claude Code v2.1.145 oder später |

123| `/run-skill-generator` | **[Skill](/de/skills#bundled-skills).** Lehren Sie `/run` und `/verify`, wie Sie die App Ihres Projekts aus einer sauberen Umgebung erstellen, starten und steuern, indem Sie einen projektspezifischen [Skill](/de/skills#run-and-verify-your-app) schreiben. {/* min-version: 2.1.145 */}Erfordert Claude Code v2.1.145 oder später |123| `/run-skill-generator` | **[Skill](/de/skills#bundled-skills).** Lehren Sie `/run` und `/verify`, wie Sie die App Ihres Projekts aus einer sauberen Umgebung erstellen, starten und steuern, indem Sie einen projektspezifischen [Skill](/de/skills#run-and-verify-your-app) schreiben. {/* min-version: 2.1.145 */}Erfordert Claude Code v2.1.145 oder später |


125| `/schedule [description]` | Erstellen, aktualisieren, listen oder führen Sie [Routinen](/de/routines) aus, die auf von Anthropic verwalteter Cloud-Infrastruktur ausgeführt werden. Claude führt Sie conversational durch die Einrichtung. Alias: `/routines` |125| `/schedule [description]` | Erstellen, aktualisieren, listen oder führen Sie [Routinen](/de/routines) aus, die auf von Anthropic verwalteter Cloud-Infrastruktur ausgeführt werden. Claude führt Sie conversational durch die Einrichtung. Alias: `/routines` |

126| `/scroll-speed` | Passen Sie die Mausrad-[Scrollgeschwindigkeit](/de/fullscreen#mouse-wheel-scrolling) interaktiv an, mit einem Lineal, das Sie scrollen können, während das Dialogfeld offen ist, um die Änderung in der Vorschau anzuzeigen. Nur in [Vollbildrendering](/de/fullscreen) verfügbar und nicht im JetBrains IDE-Terminal |126| `/scroll-speed` | Passen Sie die Mausrad-[Scrollgeschwindigkeit](/de/fullscreen#mouse-wheel-scrolling) interaktiv an, mit einem Lineal, das Sie scrollen können, während das Dialogfeld offen ist, um die Änderung in der Vorschau anzuzeigen. Nur in [Vollbildrendering](/de/fullscreen) verfügbar und nicht im JetBrains IDE-Terminal |

127| `/security-review` | Analysieren Sie ausstehende Änderungen im aktuellen Branch auf Sicherheitslücken. Überprüft den Git-Diff und identifiziert Risiken wie Injection, Authentifizierungsprobleme und Datenverlust |127| `/security-review` | Analysieren Sie ausstehende Änderungen im aktuellen Branch auf Sicherheitslücken. Überprüft den Git-Diff und identifiziert Risiken wie Injection, Authentifizierungsprobleme und Datenverlust |

128| `/setup-bedrock` | Konfigurieren Sie [Amazon Bedrock](/de/amazon-bedrock)-Authentifizierung, Region und Modell-Pins durch einen interaktiven Wizard. Nur sichtbar, wenn `CLAUDE_CODE_USE_BEDROCK=1` gesetzt ist. Erstbenutzer von Bedrock können auch auf diesen Wizard vom Login-Bildschirm zugreifen |128| `/setup-bedrock` | Konfigurieren Sie [Amazon Bedrock](/de/amazon-bedrock)-Authentifizierung, Region und Modell-Pins durch einen interaktiven Wizard. Nur sichtbar, wenn `CLAUDE_CODE_USE_BEDROCK=1` gesetzt ist. Erstbenutzer von Amazon Bedrock können auch auf diesen Wizard vom Login-Bildschirm zugreifen |

129| `/setup-vertex` | Konfigurieren Sie [Google Vertex AI](/de/google-vertex-ai)-Authentifizierung, Projekt, Region und Modell-Pins durch einen interaktiven Wizard. Nur sichtbar, wenn `CLAUDE_CODE_USE_VERTEX=1` gesetzt ist. Erstbenutzer von Vertex AI können auch auf diesen Wizard vom Login-Bildschirm zugreifen |129| `/setup-vertex` | Konfigurieren Sie [Google Cloud's Agent Platform](/de/google-vertex-ai)-Authentifizierung, Projekt, Region und Modell-Pins durch einen interaktiven Wizard. Nur sichtbar, wenn `CLAUDE_CODE_USE_VERTEX=1` gesetzt ist. Erstbenutzer von Google Cloud's Agent Platform können auch auf diesen Wizard vom Login-Bildschirm zugreifen |

130| `/simplify [target]` | {/* min-version: 2.1.154 */}**[Skill](/de/skills#bundled-skills).** Überprüfen Sie den geänderten Code auf Bereinigungsmöglichkeiten und wenden Sie die Fixes an. Vier Review-[Agenten](/de/sub-agents) laufen parallel und behandeln Wiederverwendung vorhandener Helfer, Vereinfachung, Effizienz und ob die Änderung auf der richtigen Abstraktionsebene liegt. Ab v2.1.154 sucht die Überprüfung nicht nach Korrektheitsfehler. Verwenden Sie `/code-review`, um Fehler zu finden. In früheren Versionen ist `/simplify` gleichbedeutend mit `/code-review --fix`. Übergeben Sie einen Pfad oder PR-Referenz, um ein bestimmtes Ziel zu überprüfen |130| `/simplify [target]` | {/* min-version: 2.1.154 */}**[Skill](/de/skills#bundled-skills).** Überprüfen Sie den geänderten Code auf Bereinigungsmöglichkeiten und wenden Sie die Fixes an. Vier Review-[Agenten](/de/sub-agents) laufen parallel und behandeln Wiederverwendung vorhandener Helfer, Vereinfachung, Effizienz und ob die Änderung auf der richtigen Abstraktionsebene liegt. Ab v2.1.154 sucht die Überprüfung nicht nach Korrektheitsfehler. Verwenden Sie `/code-review`, um Fehler zu finden. In früheren Versionen ist `/simplify` gleichbedeutend mit `/code-review --fix`. Übergeben Sie einen Pfad oder PR-Referenz, um ein bestimmtes Ziel zu überprüfen |

131| `/skills` | Listet verfügbare [Skills](/de/skills) auf. {/* min-version: 2.1.121 */}Ab v2.1.121 können Sie eingeben, um die Liste nach Name zu filtern. Drücken Sie `t`, um nach Token-Anzahl zu sortieren. Drücken Sie `Space`, um [einen Skill vor Claude oder dem `/`-Menü zu verbergen](/de/skills#override-skill-visibility-from-settings), dann `Enter`, um zu speichern |131| `/skills` | Listet verfügbare [Skills](/de/skills) auf. {/* min-version: 2.1.121 */}Ab v2.1.121 können Sie eingeben, um die Liste nach Name zu filtern. Drücken Sie `t`, um nach Token-Anzahl zu sortieren. Drücken Sie `Space`, um [einen Skill vor Claude oder dem `/`-Menü zu verbergen](/de/skills#override-skill-visibility-from-settings), dann `Enter`, um zu speichern |

132| `/stats` | Alias für `/usage`. Öffnet auf der Registerkarte Stats |132| `/stats` | Alias für `/usage`. Öffnet auf der Registerkarte Stats |


144| `/ultrareview [PR]` | Führen Sie eine tiefe, Multi-Agent-Code-Überprüfung in einer Cloud-Sandbox mit [Ultrareview](/de/ultrareview) durch. Die bevorzugte Invokation ist jetzt `/code-review ultra`, und `/ultrareview` bleibt als Alias erhalten. Enthält 3 kostenlose Durchläufe auf Pro und Max, dann erfordert [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |144| `/ultrareview [PR]` | Führen Sie eine tiefe, Multi-Agent-Code-Überprüfung in einer Cloud-Sandbox mit [Ultrareview](/de/ultrareview) durch. Die bevorzugte Invokation ist jetzt `/code-review ultra`, und `/ultrareview` bleibt als Alias erhalten. Enthält 3 kostenlose Durchläufe auf Pro und Max, dann erfordert [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

145| `/upgrade` | Öffnen Sie die Upgrade-Seite, um zu einem höheren Plan-Tier zu wechseln |145| `/upgrade` | Öffnen Sie die Upgrade-Seite, um zu einem höheren Plan-Tier zu wechseln |

146| `/usage` | Zeigen Sie Sitzungskosten, Plan-Nutzungslimits und Aktivitätsstatistiken an. Auf einem Pro-, Max-, Team- oder Enterprise-Plan enthält dies eine Aufschlüsselung der Nutzung nach Skill, Subagent, Plugin und MCP-Server. Siehe die [Kostentracking-Anleitung](/de/costs#using-the-%2Fusage-command) für Details. `/cost` und `/stats` sind Aliase |146| `/usage` | Zeigen Sie Sitzungskosten, Plan-Nutzungslimits und Aktivitätsstatistiken an. Auf einem Pro-, Max-, Team- oder Enterprise-Plan enthält dies eine Aufschlüsselung der Nutzung nach Skill, Subagent, Plugin und MCP-Server. Siehe die [Kostentracking-Anleitung](/de/costs#using-the-%2Fusage-command) für Details. `/cost` und `/stats` sind Aliase |

147| `/usage-credits` | Konfigurieren Sie Nutzungsguthaben, um weiterzuarbeiten, wenn Sie ein Limit erreichen. Zuvor `/extra-usage` |147| `/usage-credits` | Konfigurieren Sie Nutzungsguthaben, um weiterzuarbeiten, wenn Sie ein Limit erreichen. Öffnet die Nutzungsguthaben-Abrechnungsseite in Ihrem Browser. {/* min-version: 2.1.205 */}Wenn kein Browser geöffnet werden kann, zum Beispiel über SSH, druckt der Befehl stattdessen die URL zum Besuchen; dies erfordert Claude Code v2.1.205 oder später, und frühere Versionen zeigten in diesem Fall nichts. Zuvor `/extra-usage` |

148| `/verify` | **[Skill](/de/skills#bundled-skills).** Bestätigen Sie, dass eine Codeänderung das tut, was sie soll, indem Sie die App Ihres Projekts erstellen, ausführen und das Ergebnis beobachten, anstatt sich auf Tests oder Typprüfungen zu verlassen. Siehe [App ausführen und überprüfen](/de/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Erfordert Claude Code v2.1.145 oder später |148| `/verify` | **[Skill](/de/skills#bundled-skills).** Bestätigen Sie, dass eine Codeänderung das tut, was sie soll, indem Sie die App Ihres Projekts erstellen, ausführen und das Ergebnis beobachten, anstatt sich auf Tests oder Typprüfungen zu verlassen. Siehe [App ausführen und überprüfen](/de/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Erfordert Claude Code v2.1.145 oder später |

149| `/vim` | {/* max-version: 2.1.91 */}Entfernt in v2.1.92. Um zwischen Vim- und Normal-Bearbeitungsmodi zu wechseln, verwenden Sie `/config` → Editor mode |149| `/vim` | {/* max-version: 2.1.91 */}Entfernt in v2.1.92. Um zwischen Vim- und Normal-Bearbeitungsmodi zu wechseln, verwenden Sie `/config` → Editor mode |

150| `/voice [hold\|tap\|off]` | Schalten Sie [Sprachdiktat](/de/voice-dictation) um, oder aktivieren Sie es in einem bestimmten Modus. Erfordert ein Claude.ai-Konto |150| `/voice [hold\|tap\|off]` | Schalten Sie [Sprachdiktat](/de/voice-dictation) um, oder aktivieren Sie es in einem bestimmten Modus. Erfordert ein Claude.ai-Konto |

Details

255 </Step>255 </Step>

256</Steps>256</Steps>

257 257 

258Wenn Sie einen PR mit `gh pr create` erstellen, wird die Sitzung automatisch mit diesem PR verknüpft. Um später zu ihr zurückzukehren, führen Sie `claude --from-pr <number>` aus oder fügen Sie die PR-URL in die [`/resume` Auswahl](/de/sessions#use-the-session-picker) ein.258Wenn Sie einen PR mit `gh pr create` erstellen, wird die Sitzung automatisch mit diesem PR verknüpft. Um später zu ihr zurückzukehren, führen Sie `claude --from-pr 123` aus, wobei Sie 123 durch die PR-Nummer ersetzen, oder fügen Sie die PR-URL in die [`/resume` Auswahl](/de/sessions#use-the-session-picker) ein.

259 259 

260<Tip>260<Tip>

261 Überprüfen Sie den von Claude generierten PR vor dem Einreichen und bitten Sie Claude, potenzielle Risiken oder Überlegungen hervorzuheben.261 Überprüfen Sie den von Claude generierten PR vor dem Einreichen und bitten Sie Claude, potenzielle Risiken oder Überlegungen hervorzuheben.

Details

341möchten Sie einfach, dass es ausgeliefert wird. Sie sollten sich nicht341möchten Sie einfach, dass es ausgeliefert wird. Sie sollten sich nicht

342für immer für einen entscheiden müssen.342für immer für einen entscheiden müssen.

343 343 

344*Shift+Tab* durchläuft, wie viel Spielraum Claude bekommt: *default* fragt344*Shift+Tab* durchläuft, wie viel Spielraum Claude bekommt: *Manual* (die

345vor riskanten Sachen, *acceptEdits* lässt Dateibearbeitungen und häufige345`default` Einstellungswert) fragt vor jeder Aktion, *acceptEdits* lässt

346Dateisystem-Befehle durchfließen, während immer noch vor anderen346Dateibearbeitungen und häufige Dateisystem-Befehle durchfließen, während

347Shell-Befehlen überprüft wird, und *plan* schlägt Änderungen zur Genehmigung347immer noch vor anderen Shell-Befehlen überprüft wird, und *plan* schlägt

348vor, bevor etwas angefasst wird. Plan-Modus ist der Vertrauensaufbauer,348Änderungen zur Genehmigung vor, bevor etwas angefasst wird. Plan-Modus ist

349also beginnen Sie damit für alles, das mehrere Dateien anfasst.349der Vertrauensaufbauer, also beginnen Sie damit für alles, das mehrere

350Dateien anfasst.

350 351 

351*Probieren Sie es jetzt:* Bei Ihrem nächsten Refactoring drücken Sie352*Probieren Sie es jetzt:* Bei Ihrem nächsten Refactoring drücken Sie

352Shift+Tab, bis Sie „plan" sehen, dann beschreiben Sie die Änderung. Sie353Shift+Tab, bis Sie „plan" sehen, dann beschreiben Sie die Änderung. Sie

computer-use.md +1 −1

Details

240* Sie auf macOS sind. Die Computernutzung in der CLI ist nicht auf Linux oder Windows verfügbar. Unter Windows verwenden Sie stattdessen [Computernutzung in Desktop](/de/desktop#let-claude-use-your-computer).240* Sie auf macOS sind. Die Computernutzung in der CLI ist nicht auf Linux oder Windows verfügbar. Unter Windows verwenden Sie stattdessen [Computernutzung in Desktop](/de/desktop#let-claude-use-your-computer).

241* Sie Claude Code v2.1.85 oder später ausführen. Führen Sie `claude --version` aus, um zu überprüfen.241* Sie Claude Code v2.1.85 oder später ausführen. Führen Sie `claude --version` aus, um zu überprüfen.

242* Sie einen Pro- oder Max-Plan haben. Führen Sie `/status` aus, um Ihr Abonnement zu bestätigen.242* Sie einen Pro- oder Max-Plan haben. Führen Sie `/status` aus, um Ihr Abonnement zu bestätigen.

243* Sie sich über claude.ai authentifiziert haben. Die Computernutzung ist nicht mit Drittanbieter-Providern wie Amazon Bedrock, Google Cloud Vertex AI oder Microsoft Foundry verfügbar. Wenn Sie Claude ausschließlich über einen Drittanbieter-Provider nutzen, benötigen Sie ein separates claude.ai-Konto, um diese Funktion zu nutzen.243* Sie sich über claude.ai authentifiziert haben. Die Computernutzung ist nicht mit Drittanbieter-Providern wie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar. Wenn Sie Claude ausschließlich über einen Drittanbieter-Provider nutzen, benötigen Sie ein separates claude.ai-Konto, um diese Funktion zu nutzen.

244* Sie sind in einer interaktiven Sitzung. Die Computernutzung ist nicht im nicht-interaktiven Modus mit dem Flag `-p` verfügbar.244* Sie sind in einer interaktiven Sitzung. Die Computernutzung ist nicht im nicht-interaktiven Modus mit dem Flag `-p` verfügbar.

245 245 

246<h2 id="see-also">246<h2 id="see-also">

costs.md +1 −1

Details

51 Für Organisationen mit benutzerdefinierten Ratenlimits zählt Claude Code-Verkehr in diesem Workspace zu den gesamten API-Ratenlimits Ihrer Organisation. Sie können ein [Workspace-Ratenlimit](https://platform.claude.com/docs/de/api/rate-limits#setting-lower-limits-for-workspaces) auf der Limits-Seite dieses Workspace in der Claude Console festlegen, um Claude Code's Anteil zu begrenzen und andere Produktions-Workloads zu schützen.51 Für Organisationen mit benutzerdefinierten Ratenlimits zählt Claude Code-Verkehr in diesem Workspace zu den gesamten API-Ratenlimits Ihrer Organisation. Sie können ein [Workspace-Ratenlimit](https://platform.claude.com/docs/de/api/rate-limits#setting-lower-limits-for-workspaces) auf der Limits-Seite dieses Workspace in der Claude Console festlegen, um Claude Code's Anteil zu begrenzen und andere Produktions-Workloads zu schützen.

52</Note>52</Note>

53 53 

54Bei Bedrock, Vertex und Foundry sendet Claude Code keine Metriken aus Ihrer Cloud. Ein selbst gehostetes [Claude Apps Gateway](/de/claude-apps-gateway) bietet Nutzungszuordnung pro Benutzer, OTLP-Metriken mit Token-Zählungen und [Ausgabenlimits pro Benutzer](/de/claude-apps-gateway-spend-limits) auf diesen Anbietern. Organisationen, die Claude Code über ein anderes [LLM-Gateway](/de/llm-gateway) leiten, können die Ausgaben stattdessen am Gateway verfolgen, da es jede Anfrage sieht.54Bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry sendet Claude Code keine Metriken aus Ihrer Cloud. Ein selbst gehostetes [Claude Apps Gateway](/de/claude-apps-gateway) bietet Nutzungszuordnung pro Benutzer, OTLP-Metriken mit Token-Zählungen und [Ausgabenlimits pro Benutzer](/de/claude-apps-gateway-spend-limits) auf diesen Anbietern. Organisationen, die Claude Code über ein anderes [LLM-Gateway](/de/llm-gateway) leiten, können die Ausgaben stattdessen am Gateway verfolgen, da es jede Anfrage sieht.

55 55 

56<h3 id="rate-limit-recommendations">56<h3 id="rate-limit-recommendations">

57 Empfehlungen für Ratenlimits57 Empfehlungen für Ratenlimits

data-usage.md +8 −8

Details

23 Development Partner Program23 Development Partner Program

24</h3>24</h3>

25 25 

26Wenn Sie sich explizit dafür entscheiden, uns Materialien zum Trainieren bereitzustellen, z. B. über das [Development Partner Program](https://support.claude.com/de/articles/11174108-about-the-development-partner-program), können wir diese Materialien zum Trainieren unserer Modelle verwenden. Ein Organisationsadministrator kann sich explizit für das Development Partner Program für seine Organisation anmelden. Beachten Sie, dass dieses Programm nur für die Anthropic-API von Erstanbietern verfügbar ist und nicht für Bedrock- oder Vertex-Nutzer.26Wenn Sie sich explizit dafür entscheiden, uns Materialien zum Trainieren bereitzustellen, z. B. über das [Development Partner Program](https://support.claude.com/de/articles/11174108-about-the-development-partner-program), können wir diese Materialien zum Trainieren unserer Modelle verwenden. Ein Organisationsadministrator kann sich explizit für das Development Partner Program für seine Organisation anmelden. Beachten Sie, dass dieses Programm nur für die Anthropic-API von Erstanbietern verfügbar ist und nicht für Amazon Bedrock oder Google Cloud's Agent Platform-Nutzer.

27 27 

28<h3 id="feedback-using-the-/feedback-command">28<h3 id="feedback-using-the-/feedback-command">

29 Feedback mit dem `/feedback`-Befehl29 Feedback mit dem `/feedback`-Befehl


39 39 

40Nach der Bewertungsaufforderung sehen Sie möglicherweise eine separate Folgefrage: „Kann Anthropic Ihr Sitzungstranskript ansehen, um uns bei der Verbesserung von Claude Code zu helfen?". Dies ist ein optionaler zweiter Schritt, der sich von der Bewertung unterscheidet:40Nach der Bewertungsaufforderung sehen Sie möglicherweise eine separate Folgefrage: „Kann Anthropic Ihr Sitzungstranskript ansehen, um uns bei der Verbesserung von Claude Code zu helfen?". Dies ist ein optionaler zweiter Schritt, der sich von der Bewertung unterscheidet:

41 41 

42* **Ja**: lädt Ihr Gesprächstranskript, alle Subagenten-Transkripte und die Raw-Sitzungsprotokoll-Datei von der Festplatte zu Anthropic hoch. Bekannte API-Schlüssel- und Token-Muster werden vor dem Hochladen redigiert. Quellcode, Dateiinhalte und andere Gesprächsinhalte werden unverändert hochgeladen. Freigegebene Transkripte werden bis zu 6 Monate lang aufbewahrt. Auf Bedrock, Vertex AI, Foundry und angemeldeten [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzungen schreibt „Ja" dieselbe Nutzlast stattdessen in ein lokales Archiv unter `~/.claude/feedback-bundles/`; nichts verlässt Ihren Computer, bis Sie diese Datei weiterleiten.42* **Ja**: lädt Ihr Gesprächstranskript, alle Subagenten-Transkripte und die Raw-Sitzungsprotokoll-Datei von der Festplatte zu Anthropic hoch. Bekannte API-Schlüssel- und Token-Muster werden vor dem Hochladen redigiert. Quellcode, Dateiinhalte und andere Gesprächsinhalte werden unverändert hochgeladen. Freigegebene Transkripte werden bis zu 6 Monate lang aufbewahrt. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzungen schreibt „Ja" dieselbe Nutzlast stattdessen in ein lokales Archiv unter `~/.claude/feedback-bundles/`; nichts verlässt Ihren Computer, bis Sie diese Datei weiterleiten.

43* **Nein**: lehnt ab, ohne etwas zu senden43* **Nein**: lehnt ab, ohne etwas zu senden

44* **Nicht erneut fragen**: lehnt ab und verhindert, dass diese Folgefrage in zukünftigen Sitzungen angezeigt wird44* **Nicht erneut fragen**: lehnt ab und verhindert, dass diese Folgefrage in zukünftigen Sitzungen angezeigt wird

45 45 


90Die Verschlüsselung im Ruhezustand hängt von Ihrem Modelldienstanbieter ab:90Die Verschlüsselung im Ruhezustand hängt von Ihrem Modelldienstanbieter ab:

91 91 

92| Anbieter | Verschlüsselung im Ruhezustand |92| Anbieter | Verschlüsselung im Ruhezustand |

93| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |93| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |

94| Anthropic API | Verschlüsselung auf Infrastrukturebene (AES-256). Aktivieren Sie [Zero Data Retention](/de/zero-data-retention) für keine serverseitige Persistierung. |94| Anthropic API | Verschlüsselung auf Infrastrukturebene (AES-256). Aktivieren Sie [Zero Data Retention](/de/zero-data-retention) für keine serverseitige Persistierung. |

95| Amazon Bedrock | AES-256 mit von AWS verwalteten Schlüsseln. Von Kunden verwaltete Schlüssel verfügbar über AWS KMS. |95| Amazon Bedrock | AES-256 mit von AWS verwalteten Schlüsseln. Von Kunden verwaltete Schlüssel verfügbar über AWS KMS. |

96| Google Cloud Vertex AI | Von Google verwaltete Verschlüsselungsschlüssel. CMEK verfügbar. |96| Google Cloud's Agent Platform | Von Google verwaltete Verschlüsselungsschlüssel. CMEK verfügbar. |

97| Microsoft Foundry | Anfragen werden an die Anthropic-Infrastruktur mit AES-256-Festplattenverschlüsselung weitergeleitet. |97| Microsoft Foundry | Anfragen werden an die Anthropic-Infrastruktur mit AES-256-Festplattenverschlüsselung weitergeleitet. |

98 98 

99Claude Code basiert auf den APIs von Anthropic. Weitere Informationen zu den Sicherheitskontrollen unserer API, einschließlich unserer API-Protokollierungsverfahren, finden Sie in den Compliance-Artefakten im [Anthropic Trust Center](https://trust.anthropic.com).99Claude Code basiert auf den APIs von Anthropic. Weitere Informationen zu den Sicherheitskontrollen unserer API, einschließlich unserer API-Protokollierungsverfahren, finden Sie in den Compliance-Artefakten im [Anthropic Trust Center](https://trust.anthropic.com).


121 121 

122Wenn Sie den `/feedback`-Befehl ausführen, wird eine Kopie Ihres Gesprächsverlaufs einschließlich Code an Anthropic gesendet. Vor dem Absenden wählen Sie, wie viel Verlauf Sie einbeziehen möchten: nur die aktuelle Sitzung, was die Standardeinstellung ist, oder auch andere Sitzungen aus demselben Projekt der letzten 24 Stunden oder 7 Tage. Die Daten werden während der Übertragung über TLS verschlüsselt und in Google Cloud Storage gespeichert, das gespeicherte Daten im Ruhezustand standardmäßig verschlüsselt. Optional wird ein GitHub-Problem im öffentlichen Repository erstellt. Um sich abzumelden, setzen Sie die Umgebungsvariable `DISABLE_FEEDBACK_COMMAND` auf `1`.122Wenn Sie den `/feedback`-Befehl ausführen, wird eine Kopie Ihres Gesprächsverlaufs einschließlich Code an Anthropic gesendet. Vor dem Absenden wählen Sie, wie viel Verlauf Sie einbeziehen möchten: nur die aktuelle Sitzung, was die Standardeinstellung ist, oder auch andere Sitzungen aus demselben Projekt der letzten 24 Stunden oder 7 Tage. Die Daten werden während der Übertragung über TLS verschlüsselt und in Google Cloud Storage gespeichert, das gespeicherte Daten im Ruhezustand standardmäßig verschlüsselt. Optional wird ein GitHub-Problem im öffentlichen Repository erstellt. Um sich abzumelden, setzen Sie die Umgebungsvariable `DISABLE_FEEDBACK_COMMAND` auf `1`.

123 123 

124Wenn Sie einen Drittanbieter wie Bedrock oder Vertex verwenden oder keine Anthropic-Anmeldedaten konfiguriert haben, schreibt `/feedback` den Bericht stattdessen in ein lokales Archiv unter `~/.claude/feedback-bundles/`, anstatt ihn an Anthropic zu senden. Bekannte API-Schlüssel- und Token-Muster werden vor dem Schreiben des Archivs redigiert. Nichts verlässt Ihren Computer, bis Sie diese Datei an Ihren Anthropic-Kontorepräsentanten senden oder sie an eine Supportanfrage anhängen.124Wenn Sie einen Drittanbieter wie Amazon Bedrock oder Google Cloud's Agent Platform verwenden oder keine Anthropic-Anmeldedaten konfiguriert haben, schreibt `/feedback` den Bericht stattdessen in ein lokales Archiv unter `~/.claude/feedback-bundles/`, anstatt ihn an Anthropic zu senden. Bekannte API-Schlüssel- und Token-Muster werden vor dem Schreiben des Archivs redigiert. Nichts verlässt Ihren Computer, bis Sie diese Datei an Ihren Anthropic-Kontorepräsentanten senden oder sie an eine Supportanfrage anhängen.

125 125 

126<h2 id="default-behaviors-by-api-provider">126<h2 id="default-behaviors-by-api-provider">

127 Standardverhalten nach API-Anbieter127 Standardverhalten nach API-Anbieter

128</h2>128</h2>

129 129 

130Standardmäßig sind Fehlerberichterstattung, Telemetrie und Bug-Berichterstattung deaktiviert, wenn Sie Bedrock, Vertex, Foundry oder Claude Platform auf AWS verwenden. Sitzungsqualitätsumfragen und die WebFetch-Domänensicherheitsprüfung sind Ausnahmen und werden unabhängig vom Anbieter ausgeführt. Auf einer angemeldeten [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzung sind Nutzungsanalysen, Fehlerberichterstattung und Umfragebewertungen an Anthropic durch die Gateway-Anmeldedaten selbst deaktiviert, ohne dass eine Einstellung zum erneuten Aktivieren vorhanden ist. Sie können sich auf einmal von all dem nicht wesentlichen Datenverkehr, einschließlich Umfragen, abmelden, indem Sie `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` setzen. Diese Variable beeinträchtigt die WebFetch-Prüfung nicht, die ihre eigene Abmeldeoption hat. Hier sind die vollständigen Standardverhalten:130Standardmäßig sind Fehlerberichterstattung, Telemetrie und Bug-Berichterstattung deaktiviert, wenn Sie Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform auf AWS verwenden. Sitzungsqualitätsumfragen und die WebFetch-Domänensicherheitsprüfung sind Ausnahmen und werden unabhängig vom Anbieter ausgeführt. Auf einer angemeldeten [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzung sind Nutzungsanalysen, Fehlerberichterstattung und Umfragebewertungen an Anthropic durch die Gateway-Anmeldedaten selbst deaktiviert, ohne dass eine Einstellung zum erneuten Aktivieren vorhanden ist. Sie können sich auf einmal von all dem nicht wesentlichen Datenverkehr, einschließlich Umfragen, abmelden, indem Sie `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` setzen. Diese Variable beeinträchtigt die WebFetch-Prüfung nicht, die ihre eigene Abmeldeoption hat. Hier sind die vollständigen Standardverhalten:

131 131 

132| Dienst | Claude API | Vertex API | Bedrock API | Foundry API | Claude Platform auf AWS |132| Dienst | Claude API | Google Cloud's Agent Platform API | Amazon Bedrock API | Microsoft Foundry API | Claude Platform auf AWS |

133| -------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |133| -------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |

134| **Anthropic (Metriken)** | Standardmäßig aktiviert.<br />`DISABLE_TELEMETRY=1` zum Deaktivieren. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_VERTEX` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_BEDROCK` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_FOUNDRY` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` muss 1 sein. |134| **Anthropic (Metriken)** | Standardmäßig aktiviert.<br />`DISABLE_TELEMETRY=1` zum Deaktivieren. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_VERTEX` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_BEDROCK` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_FOUNDRY` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` muss 1 sein. |

135| **Sentry (Fehler)** | Standardmäßig aktiviert.<br />`DISABLE_ERROR_REPORTING=1` zum Deaktivieren. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_VERTEX` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_BEDROCK` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_FOUNDRY` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` muss 1 sein. |135| **Sentry (Fehler)** | Standardmäßig aktiviert.<br />`DISABLE_ERROR_REPORTING=1` zum Deaktivieren. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_VERTEX` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_BEDROCK` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_FOUNDRY` muss 1 sein. | Standardmäßig deaktiviert.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` muss 1 sein. |


139 139 

140Alle Umgebungsvariablen können in `settings.json` eingecheckt werden (siehe [Einstellungsreferenz](/de/settings)).140Alle Umgebungsvariablen können in `settings.json` eingecheckt werden (siehe [Einstellungsreferenz](/de/settings)).

141 141 

142Ab v2.1.126 werden Metriken standardmäßig aktiviert für Vertex, Bedrock und Foundry, wenn eine Host-Plattform `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` setzt, und folgen der Standard-Abmeldeoption `DISABLE_TELEMETRY`. Sentry-Fehlerberichterstattung und `/feedback`-Berichte bleiben standardmäßig auf diesen Anbietern deaktiviert.142Ab v2.1.126 werden Metriken standardmäßig aktiviert für Google Cloud's Agent Platform, Amazon Bedrock und Microsoft Foundry, wenn eine Host-Plattform `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` setzt, und folgen der Standard-Abmeldeoption `DISABLE_TELEMETRY`. Sentry-Fehlerberichterstattung und `/feedback`-Berichte bleiben standardmäßig auf diesen Anbietern deaktiviert.

143 143 

144<h3 id="webfetch-domain-safety-check">144<h3 id="webfetch-domain-safety-check">

145 WebFetch-Domänensicherheitsprüfung145 WebFetch-Domänensicherheitsprüfung

Details

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

20 20 

21| Befehl | Zeigt |21| Befehl | Zeigt |

22| :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |22| :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

23| `/memory` | Welche `CLAUDE.md`- und Regeldateien geladen wurden, plus Auto-Memory-Einträge |23| `/memory` | Welche `CLAUDE.md`- und Regeldateien geladen wurden, plus Auto-Memory-Einträge |

24| `/skills` | Verfügbare Skills aus Projekt-, Benutzer- und Plugin-Quellen |24| `/skills` | Verfügbare Skills aus Projekt-, Benutzer- und Plugin-Quellen |

25| `/hooks` | Aktive Hook-Konfigurationen |25| `/hooks` | Aktive Hook-Konfigurationen |

26| `/mcp` | Verbundene MCP-Server und ihr Status |26| `/mcp` | Verbundene MCP-Server und ihr Status |

27| `/permissions` | Aufgelöste Allow- und Deny-Regeln, die derzeit wirksam sind |27| `/permissions` | Aufgelöste Allow- und Deny-Regeln, die derzeit wirksam sind |

28| `/doctor` | Konfigurationsdiagnose: ungültige Schlüssel, Schemafehler, Installationsintegrität. {/* min-version: 2.1.196 */}Ab v2.1.196 werden auch doppelte [Subagenten](/de/sub-agents)-Namen gemeldet, die im gleichen Bereich definiert sind, und es wird gekennzeichnet, welcher aktiv ist |28| `/doctor` | Konfigurationsdiagnose: Installationsintegrität, ungültige Einstellungsdateien, ungenutzte Erweiterungen und doppelte [Subagenten](/de/sub-agents)-Namen im gleichen Verzeichnis, mit vorgeschlagenen Fixes |

29| `/debug [issue]` | Aktiviert Debug-Protokollierung für die Sitzung und fordert Claude auf, die Diagnose mithilfe der Protokollausgabe und Einstellungspfade durchzuführen |29| `/debug [issue]` | Aktiviert Debug-Protokollierung für die Sitzung und fordert Claude auf, die Diagnose mithilfe der Protokollausgabe und Einstellungspfade durchzuführen |

30| `/status` | Aktive Einstellungsquellen, einschließlich ob verwaltete Einstellungen wirksam sind |30| `/status` | Aktive Einstellungsquellen, einschließlich ob verwaltete Einstellungen wirksam sind |

31 31 


45 45 

46Einstellungen werden über verwaltete, Benutzer-, Projekt- und lokale Bereiche zusammengeführt. Verwaltete Einstellungen gewinnen immer, wenn sie vorhanden sind. Bei den übrigen überschreibt der nähere Bereich den breiteren in der Reihenfolge lokal, dann Projekt, dann Benutzer. Einige Einstellungen können auch durch Befehlszeilenflaggen oder [Umgebungsvariablen](/de/env-vars) festgelegt werden, die als eine weitere Überschreibungsebene fungieren. Wenn eine Einstellung nicht angewendet zu werden scheint, wird der von Ihnen festgelegte Wert normalerweise durch einen anderen Bereich oder eine Umgebungsvariable überschrieben.46Einstellungen werden über verwaltete, Benutzer-, Projekt- und lokale Bereiche zusammengeführt. Verwaltete Einstellungen gewinnen immer, wenn sie vorhanden sind. Bei den übrigen überschreibt der nähere Bereich den breiteren in der Reihenfolge lokal, dann Projekt, dann Benutzer. Einige Einstellungen können auch durch Befehlszeilenflaggen oder [Umgebungsvariablen](/de/env-vars) festgelegt werden, die als eine weitere Überschreibungsebene fungieren. Wenn eine Einstellung nicht angewendet zu werden scheint, wird der von Ihnen festgelegte Wert normalerweise durch einen anderen Bereich oder eine Umgebungsvariable überschrieben.

47 47 

48Führen Sie `/doctor` aus, um Ihre Konfigurationsdateien zu validieren und ungültige Schlüssel oder Schemafehler zu identifizieren. Wenn `/doctor` Probleme meldet, drücken Sie `f`, um den Diagnosebericht an Claude zu senden und ihn die Behebung mit Ihnen durchzugehen.48Führen Sie `/doctor` aus, um Ihre Konfiguration und Installation zu überprüfen. Es meldet, was es findet, einschließlich ungültiger Einstellungsdateien, doppelter Installationen und ungenutzter Erweiterungen, und schlägt dann Fixes vor, die es nur nach Ihrer Bestätigung anwendet. Vor v2.1.205 öffnete `/doctor` einen schreibgeschützten Diagnosebildschirm und das Drücken von `f` sendete den Bericht an Claude zur Behebung.

49 

50Aus dem Terminal druckt `claude doctor` schreibgeschützte Installations- und Einstellungsdiagnosen, ohne eine Sitzung zu starten.

49 51 

50Führen Sie `/status` aus, um zu sehen, welche Einstellungsquellen aktiv sind, einschließlich ob verwaltete Einstellungen wirksam sind. Um zu verstehen, welcher Bereich für einen bestimmten Schlüssel gewinnt, siehe [Wie Bereiche interagieren](/de/settings#how-scopes-interact).52Führen Sie `/status` aus, um zu sehen, welche Einstellungsquellen aktiv sind, einschließlich ob verwaltete Einstellungen wirksam sind. Um zu verstehen, welcher Bereich für einen bestimmten Schlüssel gewinnt, siehe [Wie Bereiche interagieren](/de/settings#how-scopes-interact).

51 53 


67 69 

68Führen Sie `/hooks` aus, um jeden Hook aufzulisten, der für die aktuelle Sitzung registriert ist, gruppiert nach Ereignis. Wenn ein von Ihnen definierter Hook nicht angezeigt wird, wird er nicht gelesen: Hooks gehen unter den Schlüssel `"hooks"` in einer Einstellungsdatei, nicht in einer eigenständigen Datei.70Führen Sie `/hooks` aus, um jeden Hook aufzulisten, der für die aktuelle Sitzung registriert ist, gruppiert nach Ereignis. Wenn ein von Ihnen definierter Hook nicht angezeigt wird, wird er nicht gelesen: Hooks gehen unter den Schlüssel `"hooks"` in einer Einstellungsdatei, nicht in einer eigenständigen Datei.

69 71 

70Wenn der Hook angezeigt wird, aber nicht ausgelöst wird, ist der Matcher die übliche Ursache. Das Feld `matcher` ist eine einzelne Zeichenkette, die `|` verwendet, um mehrere Tool-Namen zu entsprechen, z. B. `"Edit|Write"`. {/* min-version: 2.1.191 */}Auf Claude Code v2.1.191 oder später funktioniert auch `,` als Trennzeichen, sodass `"Edit,Write"` gleichwertig ist. In früheren Versionen wird ein Komma zur Regex-Auswertung durchgeleitet und der Matcher stimmt nie überein, daher verwenden Sie `|`, wenn Sie nicht auf v2.1.191 sind. Ein falsch geschriebener Tool-Name schlägt stillschweigend fehl, aus demselben Grund. Ein Array-Wert ist ein Schemafehler: Claude Code zeigt einen Einstellungsfehler an, `/doctor` meldet den Validierungsfehler, und der Hook-Eintrag wird gelöscht, sodass er nicht in `/hooks` angezeigt wird.72Wenn der Hook angezeigt wird, aber nicht ausgelöst wird, ist der Matcher die übliche Ursache. Überprüfen Sie ihn auf diese Fehler:

73 

74* Das Feld `matcher` ist eine einzelne Zeichenkette, die `|` verwendet, um mehrere Tool-Namen zu entsprechen, z. B. `"Edit|Write"`. {/* min-version: 2.1.191 */}Ein `,`-Trennzeichen ist gleichwertig, sodass `"Edit,Write"` dieselben Tools entspricht. Vor v2.1.191 wurde ein Komma zur Regex-Auswertung durchgeleitet und der Matcher stimmte nie überein, daher verwenden Sie `|`, wenn Sie nicht auf v2.1.191 sind.

75* Ein falsch geschriebener Tool-Name erzeugt einen Matcher, der nichts entspricht, sodass der Hook stillschweigend fehlschlägt.

76* Ein Array-Wert ist ein Schemafehler: Claude Code zeigt einen Einstellungsfehler an und lehnt die gesamte Benutzer-, Projekt- oder lokale Einstellungsdatei ab, `claude doctor` meldet den Validierungsfehler, und kein Hook aus dieser Datei wird in `/hooks` angezeigt. In [verwalteten Einstellungen](/de/settings#settings-files) wird nur der ungültige Eintrag entfernt und die anderen Hooks der Datei gelten weiterhin.

71 77 

72Änderungen an `settings.json` werden in der laufenden Sitzung nach einer kurzen Dateistabilitätsverzögerung wirksam. Sie müssen nicht neu starten. Wenn `/hooks` einige Sekunden nach dem Speichern immer noch die alte Definition anzeigt, führen Sie `/hooks` erneut aus, um die Ansicht zu aktualisieren.78Änderungen an `settings.json` werden in der laufenden Sitzung nach einer kurzen Dateistabilitätsverzögerung wirksam. Sie müssen nicht neu starten. Wenn `/hooks` einige Sekunden nach dem Speichern immer noch die alte Definition anzeigt, führen Sie `/hooks` erneut aus, um die Ansicht zu aktualisieren.

73 79 


77 Testen Sie gegen eine saubere Konfiguration83 Testen Sie gegen eine saubere Konfiguration

78</h2>84</h2>

79 85 

80{/* min-version: 2.1.169 */}Beginnen Sie mit [`claude --safe-mode`](/de/cli-reference#cli-flags), das eine Sitzung mit allen deaktivierten Anpassungen startet, einschließlich `CLAUDE.md`, Skills, Plugins, Hooks, MCP-Servern und benutzerdefinierten Befehlen und Agenten. Authentifizierung, Modellauswahl, integrierte Tools und Berechtigungen funktionieren normal. Wenn das Problem im abgesicherten Modus verschwindet, ist eine dieser Oberflächen die Ursache; verwenden Sie die gezielten Überprüfungen oben, um herauszufinden, welche. Verwaltete Einstellungen, die von Ihrer Organisation bereitgestellt werden, gelten immer noch teilweise, daher werden richtlinienkonfigurierte Hooks und die Statuszeile auch im abgesicherten Modus ausgeführt.86{/* min-version: 2.1.169 */}Beginnen Sie mit [`claude --safe-mode`](/de/cli-reference#cli-flags), das eine Sitzung mit allen deaktivierten Anpassungen startet, einschließlich `CLAUDE.md`, Skills, Plugins, Hooks, MCP-Servern und benutzerdefinierten Befehlen und Agenten. Authentifizierung, Modellauswahl, integrierte Tools und Berechtigungen funktionieren normal. Wenn das Problem im abgesicherten Modus verschwindet, ist eine dieser Oberflächen die Ursache; verwenden Sie die gezielten Überprüfungen oben, um herauszufinden, welche. Der abgesicherte Modus wendet immer noch verwaltete Hooks und die Einstellungsrichtlinie Ihrer Organisation an. Verwaltete Plugins, Skills, `CLAUDE.md` und MCP-Server sind ausgeschaltet.

81 87 

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

83 89 

desktop.md +72 −38

Details

29In der Registerkarte Code ist jedes Gespräch eine **Sitzung**: Es hat seinen eigenen Chat-Verlauf, Projektordner und Code-Änderungen, unabhängig von jeder anderen Sitzung. Die Seitenleiste listet Ihre Sitzungen auf und ermöglicht es Ihnen, mehrere parallel auszuführen. Innerhalb einer Sitzung können Sie:29In der Registerkarte Code ist jedes Gespräch eine **Sitzung**: Es hat seinen eigenen Chat-Verlauf, Projektordner und Code-Änderungen, unabhängig von jeder anderen Sitzung. Die Seitenleiste listet Ihre Sitzungen auf und ermöglicht es Ihnen, mehrere parallel auszuführen. Innerhalb einer Sitzung können Sie:

30 30 

31* [Diffs überprüfen und kommentieren](#review-changes-with-diff-view), dann [den resultierenden PR durch CI überwachen](#monitor-pull-request-status)31* [Diffs überprüfen und kommentieren](#review-changes-with-diff-view), dann [den resultierenden PR durch CI überwachen](#monitor-pull-request-status)

32* [Ihre laufende App](#preview-your-app) in einem eingebetteten Browser in der Vorschau anzeigen, während Claude seine eigenen Änderungen überprüft32* [Ihre laufende App](#preview-your-app) in einem eingebetteten Browser in der Vorschau anzeigen, während Claude seine eigenen Änderungen überprüft, und [externe Websites](#browse-external-sites) daneben öffnen

33* [Panes anordnen](#arrange-your-workspace) für Chat, Diff, Vorschau, Terminal und Datei-Editor nebeneinander33* [Panes anordnen](#arrange-your-workspace) für Chat, Diff, Browser, Terminal und Datei-Editor nebeneinander

34* Eine [Seitenfrage](#ask-a-side-question-without-derailing-the-session) stellen, die den Kontext der Sitzung nutzt, ohne sie zu beeinträchtigen34* Eine [Seitenfrage](#ask-a-side-question-without-derailing-the-session) stellen, die den Kontext der Sitzung nutzt, ohne sie zu beeinträchtigen

35* [Externe Tools verbinden](#connect-external-tools) wie GitHub, Slack und Linear35* [Externe Tools verbinden](#connect-external-tools) wie GitHub, Slack und Linear

36* Claude [Apps öffnen und Ihren Bildschirm steuern lassen](#let-claude-use-your-computer)36* Claude [Apps öffnen und Ihren Bildschirm steuern lassen](#let-claude-use-your-computer)


78 Wählen Sie einen Berechtigungsmodus78 Wählen Sie einen Berechtigungsmodus

79</h3>79</h3>

80 80 

81Berechtigungsmodi kontrollieren, wie viel Autonomie Claude während einer Sitzung hat: ob es vor dem Bearbeiten von Dateien, dem Ausführen von Befehlen oder beidem fragt. Sie können Modi jederzeit mit dem Moduswahlschalter neben der Schaltfläche „Senden" wechseln. Beginnen Sie mit „Berechtigungen erfragen", um genau zu sehen, was Claude tut, und wechseln Sie dann zu „Bearbeitungen automatisch akzeptieren" oder Plan Mode", wenn Sie sich wohler fühlen.81Berechtigungsmodi kontrollieren, wie viel Autonomie Claude während einer Sitzung hat: ob es vor dem Bearbeiten von Dateien, dem Ausführen von Befehlen oder beidem fragt. Sie können Modi jederzeit mit dem Moduswahlschalter neben der Schaltfläche „Senden" wechseln. Beginnen Sie mit Manual, um genau zu sehen, was Claude tut, und wechseln Sie dann zu Accept edits oder Plan, wenn Sie sich wohler fühlen.

82 82 

83| Modus | Einstellungsschlüssel | Verhalten |83| Modus | Einstellungsschlüssel | Verhalten |

84| ----------------------------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |84| ---------------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

85| **Berechtigungen erfragen** | `default` | Claude fragt vor dem Bearbeiten von Dateien oder dem Ausführen von Befehlen. Sie sehen einen Diff und können jede Änderung akzeptieren oder ablehnen. Empfohlen für neue Benutzer. |85| **Manual** | `default` | Claude fragt vor dem Bearbeiten von Dateien oder dem Ausführen von Befehlen. Sie sehen einen Diff und können jede Änderung akzeptieren oder ablehnen. Empfohlen für neue Benutzer. |

86| **Bearbeitungen automatisch akzeptieren** | `acceptEdits` | Claude akzeptiert Dateibearbeitungen automatisch und häufige Dateisystem-Befehle wie `mkdir`, `touch` und `mv`, fragt aber immer noch vor dem Ausführen anderer Terminal-Befehle. Verwenden Sie dies, wenn Sie Dateiänderungen vertrauen und schnellere Iterationen wünschen. |86| **Accept edits** | `acceptEdits` | Claude akzeptiert Dateibearbeitungen automatisch und häufige Dateisystem-Befehle wie `mkdir`, `touch` und `mv`, fragt aber immer noch vor dem Ausführen anderer Terminal-Befehle. Verwenden Sie dies, wenn Sie Dateiänderungen vertrauen und schnellere Iterationen wünschen. |

87| **Plan Mode** | `plan` | Claude liest Dateien und führt Befehle aus, um zu erkunden, schlägt dann einen Plan vor, ohne Ihren Quellcode zu bearbeiten. Gut für komplexe Aufgaben, bei denen Sie den Ansatz zuerst überprüfen möchten. |87| **Plan** | `plan` | Claude liest Dateien und führt Befehle aus, um zu erkunden, schlägt dann einen Plan vor, ohne Ihren Quellcode zu bearbeiten. Gut für komplexe Aufgaben, bei denen Sie den Ansatz zuerst überprüfen möchten. |

88| **Auto** | `auto` | Claude führt alle Aktionen mit Hintergrund-Sicherheitsprüfungen aus, die die Ausrichtung mit Ihrer Anfrage überprüfen. Reduziert Berechtigungsaufforderungen bei Beibehaltung der Überwachung. Aktivieren Sie in Ihren Einstellungen → Claude Code. Siehe [Verfügbarkeitsanforderungen](#auto-mode-availability) unten. |88| **Auto** | `auto` | Claude führt alle Aktionen mit Hintergrund-Sicherheitsprüfungen aus, die die Ausrichtung mit Ihrer Anfrage überprüfen. Reduziert Berechtigungsaufforderungen bei Beibehaltung der Überwachung. Aktivieren Sie in Ihren Einstellungen → Claude Code. Siehe [Verfügbarkeitsanforderungen](#auto-mode-availability) unten. |

89| **Berechtigungen umgehen** | `bypassPermissions` | Claude läuft ohne Berechtigungsaufforderungen, außer denen, die durch explizite [Ask-Regeln](/de/permissions#manage-permissions) erzwungen werden; äquivalent zu `--dangerously-skip-permissions` in der CLI. Aktivieren Sie dies in Ihren Einstellungen → Claude Code unter „Bypass-Berechtigungsmodus zulassen". Verwenden Sie dies nur in sandboxierten Containern oder VMs. Enterprise-Administratoren können diese Option deaktivieren. |89| **Bypass permissions** | `bypassPermissions` | Claude läuft ohne Berechtigungsaufforderungen, außer denen, die durch explizite [ask rules](/de/permissions#manage-permissions) erzwungen werden oder durch Sicherheitsklassifizierer, wenn Claude [auf externen Websites agiert](#browse-external-sites); äquivalent zu `--dangerously-skip-permissions` in der CLI. Aktivieren Sie dies in Ihren Einstellungen → Claude Code unter „Allow bypass permissions mode". Verwenden Sie dies nur in sandboxierten Containern oder VMs. Enterprise-Administratoren können diese Option deaktivieren. |

90 

91Frühere Versionen der Code-Registerkarte bezeichneten diese Modi als Ask permissions, Auto accept edits und Plan mode.

90 92 

91Der Berechtigungsmodus `dontAsk` ist nur in der [CLI](/de/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) verfügbar.93Der Berechtigungsmodus `dontAsk` ist nur in der [CLI](/de/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) verfügbar.

92 94 

93<span id="auto-mode-availability" />95<span id="auto-mode-availability" />

94 96 

95Auto Mode ist eine Forschungsvorschau, die allen Benutzern auf der Anthropic API verfügbar ist und Claude Opus 4.6 oder später oder Sonnet 4.6 oder später erfordert. Bei Enterprise-Bereitstellungen, die Desktop zu Google Cloud Vertex AI weiterleiten, ist Auto Mode deaktiviert, bis Sie [`CLAUDE_CODE_ENABLE_AUTO_MODE`](/de/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry) setzen, und nur Claude Sonnet 5, Opus 4.7 und Opus 4.8 werden dort unterstützt.97Auto mode ist eine Forschungsvorschau, die allen Benutzern auf der Anthropic API verfügbar ist und Claude Opus 4.6 oder später oder Sonnet 4.6 oder später erfordert. Bei Enterprise-Bereitstellungen, die Desktop zu Google Cloud's Agent Platform weiterleiten, ist Auto mode deaktiviert, bis Sie [`CLAUDE_CODE_ENABLE_AUTO_MODE`](/de/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) setzen, und nur Claude Sonnet 5, Opus 4.7 und Opus 4.8 werden dort unterstützt.

96 98 

97<Tip title="Best Practice">99<Tip title="Best practice">

98 Beginnen Sie komplexe Aufgaben im Plan Mode, damit Claude einen Ansatz abbildet, bevor Änderungen vorgenommen werden. Sobald Sie den Plan genehmigen, wechseln Sie zu 'Bearbeitungen automatisch akzeptieren" oder „Berechtigungen erfragen", um ihn auszuführen. Siehe [Zuerst erkunden, dann planen, dann codieren](/de/best-practices#explore-first-then-plan-then-code) für mehr zu diesem Workflow.100 Beginnen Sie komplexe Aufgaben im Plan, damit Claude einen Ansatz abbildet, bevor Änderungen vorgenommen werden. Sobald Sie den Plan genehmigen, wechseln Sie zu Accept edits oder Manual, um ihn auszuführen. Siehe [explore first, then plan, then code](/de/best-practices#explore-first-then-plan-then-code) für mehr zu diesem Workflow.

99</Tip>101</Tip>

100 102 

101Cloud-Sitzungen unterstützen „Bearbeitungen automatisch akzeptieren", Plan Mode" und Auto Mode". „Bearbeitungen automatisch akzeptieren" entspricht dem `default`-Modus: Cloud-Sitzungen genehmigen Dateibearbeitungen vorab, daher zeigt der Wahlschalter „Bearbeitungen automatisch akzeptieren" statt „Berechtigungen erfragen" an. „Berechtigungen umgehen" ist nicht verfügbar, da die Cloud-Umgebung bereits sandboxed ist.103Cloud-Sitzungen unterstützen Accept edits, Plan und Auto. Accept edits entspricht dem `default`-Modus: Cloud-Sitzungen genehmigen Dateibearbeitungen vorab, daher zeigt der Wahlschalter Accept edits statt Manual an. Bypass permissions ist nicht verfügbar, da die Cloud-Umgebung bereits sandboxed ist.

102 104 

103Enterprise-Administratoren können einschränken, welche Berechtigungsmodi verfügbar sind. Siehe [Unternehmenskonfiguration](#enterprise-configuration) für Details.105Enterprise-Administratoren können einschränken, welche Berechtigungsmodi verfügbar sind. Siehe [enterprise configuration](#enterprise-configuration) für Details.

104 106 

105<h3 id="preview-your-app">107<h3 id="preview-your-app">

106 Vorschau Ihrer App108 Vorschau Ihrer App

107</h3>109</h3>

108 110 

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

110 112 

111Das Vorschau-Pane kann auch statische HTML-Dateien, PDFs, Bilder und Videos aus Ihrem Projekt öffnen. Klicken Sie auf einen HTML-, PDF-, Bild- oder Videopfad im Chat, um ihn in der Vorschau zu öffnen.113Das Browser-Pane kann auch statische HTML-Dateien, PDFs, Bilder und Videos aus Ihrem Projekt öffnen. Klicken Sie auf einen HTML-, PDF-, Bild- oder Videopfad im Chat, um ihn dort zu öffnen.

112 114 

113Aus dem Vorschau-Pane können Sie:115Aus dem Browser-Pane können Sie:

114 116 

115* Direkt im eingebetteten Browser mit Ihrer laufenden App interagieren117* Direkt im Browser-Pane mit Ihrer laufenden App interagieren

116* Beobachten, wie Claude seine eigenen Änderungen automatisch überprüft: Es macht Screenshots, inspiziert das DOM, klickt auf Elemente, füllt Formulare aus und behebt Probleme, die es findet118* Beobachten, wie Claude seine eigenen Änderungen automatisch überprüft: Es macht Screenshots, inspiziert das DOM, klickt auf Elemente, füllt Formulare aus und behebt Probleme, die es findet

117* Server aus dem Dropdown **Vorschau** in der Sitzungs-Symbolleiste starten oder stoppen119* Server aus dem Server-Dropdown in der Sitzungs-Symbolleiste starten oder stoppen

118* Cookies und lokalen Speicher über Server-Neustarts hinweg beibehalten, indem Sie **Sitzungen beibehalten** im Dropdown auswählen, damit Sie sich während der Entwicklung nicht erneut anmelden müssen120* Cookies und lokalen Speicher über Server-Neustarts hinweg beibehalten, indem Sie **Persist sessions** im Dropdown auswählen, damit Sie sich während der Entwicklung nicht erneut anmelden müssen

119* Die Server-Konfiguration bearbeiten oder alle Server auf einmal stoppen121* Die Server-Konfiguration bearbeiten oder alle Server auf einmal stoppen

120 122 

121Claude erstellt die anfängliche Server-Konfiguration basierend auf Ihrem Projekt. Wenn Ihre App einen benutzerdefinierten Dev-Befehl verwendet, bearbeiten Sie `.claude/launch.json`, um Ihr Setup zu entsprechen. Siehe [Vorschau-Server konfigurieren](#configure-preview-servers) für die vollständige Referenz.123Claude erstellt die anfängliche Server-Konfiguration basierend auf Ihrem Projekt. Wenn Ihre App einen benutzerdefinierten Dev-Befehl verwendet, bearbeiten Sie `.claude/launch.json`, um Ihr Setup zu entsprechen. Siehe [Configure preview servers](#configure-preview-servers) für die vollständige Referenz.

124 

125Um gespeicherte Sitzungsdaten zu löschen oder den Browser vollständig auszuschalten, verwenden Sie die Umschalter in Einstellungen → Claude Code.

126 

127<h3 id="browse-external-sites">

128 Externe Websites durchsuchen

129</h3>

130 

131Das Browser-Pane ist ein Browser mit Registerkarten, daher können Sie Dokumentation, Issue-Tracker oder andere Websites neben Ihrer laufenden App öffnen. Um den Browser zu öffnen, drücken Sie **Cmd+Shift+B** auf macOS oder **Ctrl+Shift+B** auf Windows, oder wählen Sie ihn aus dem Menü **Views**. Wenn Sie auf einen externen Link im Chat klicken, bietet ein Wahlschalter **Open in app** an, um das Browser-Pane zu verwenden, oder **Default browser**, um Ihren eigenen Browser zu verwenden; **Cmd**-Klick auf macOS oder **Ctrl**-Klick auf Windows öffnet einen Link direkt in Ihrem Systembrowser. Sie können sich auf Websites im Pane anmelden, einschließlich Popup-Anmeldungsflows wie Google OAuth.

132 

133Claude kann externe Seiten lesen und mit ihnen interagieren, indem es die gleichen Tools verwendet, die es zum [Überprüfen Ihrer App](#preview-your-app) nutzt, mit zwei zusätzlichen Sicherheitsprüfungen:

134 

135* Sicherheitsklassifizierer überprüfen Claudes Schreibaktionen auf externen Seiten, wie Klicken und Tippen, in jedem Berechtigungsmodus. Dies sind die gleichen Klassifizierer, die [Auto mode](#choose-a-permission-mode) verwendet, und wenn sie eine Aktion kennzeichnen, erhalten Sie eine Berechtigungsaufforderung unabhängig vom Modus.

136* In Berechtigungsmodi außer Auto und Bypass permissions wird auch eine Domain-Allowlist-Prüfung angewendet, bevor Claude zu einer neuen Website navigiert.

137 

138<h4 id="approve-claude’s-actions-on-a-site">

139 Genehmigen Sie Claudes Aktionen auf einer Website

140</h4>

141 

142Wenn Claude zum ersten Mal auf einer externen Website agiert, wird eine Berechtigungskarte angezeigt und Claude wartet auf Ihre Wahl: **Allow once**, **Always allow** oder **Deny**. **Allow once** genehmigt die Aktion, ohne etwas zu speichern. **Always allow** speichert die Genehmigung für diese Website auf Ihrem Gerät, und Sie können sie in Einstellungen widerrufen. Jede Website benötigt ihre eigene Genehmigung, einschließlich Subdomains. Ihre lokalen Dev-Server und Projektdateien benötigen keine Genehmigung, daher funktioniert [auto-verify](#auto-verify-changes) ohne Aufforderungen.

143 

144Auch auf einer genehmigten Website wird Claude keine Artikel kaufen, Konten erstellen oder CAPTCHAs umgehen, ohne Ihre Eingabe. Das Durchsuchen im Browser-Pane verwendet das gleiche Sicherheitsmodell wie die [Claude in Chrome-Erweiterung](/de/chrome). Siehe [Using Claude in Chrome safely](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) für die Behandlung sensibler Websites und riskanter Aktionen durch Claude.

145 

146<h4 id="choose-between-the-browser-and-the-chrome-extension">

147 Wählen Sie zwischen dem Browser-Pane und der Chrome-Erweiterung

148</h4>

149 

150Das Browser-Pane verwendet ein sauberes Browser-Profil, getrennt von Ihrem persönlichen Browser, ohne Ihre gespeicherten Anmeldungen oder Verlauf. Verwenden Sie es zum Erstellen und Testen Ihrer App und für Websites, die Ihre Identität nicht benötigen. Wenn Sie möchten, dass Claude als Sie in Ihren angemeldeten Sitzungen agiert, verwenden Sie stattdessen die [Claude in Chrome-Erweiterung](/de/chrome), die den Anmeldestatus Ihres Browsers teilt.

151 

152<h4 id="restrict-external-browsing-for-your-organization">

153 Beschränken Sie das externe Durchsuchen für Ihre Organisation

154</h4>

122 155 

123Um gespeicherte Sitzungsdaten zu löschen, schalten Sie **Vorschau-Sitzungen beibehalten** in Einstellungen Claude Code aus. Um die Vorschau vollständig zu deaktivieren, schalten Sie **Vorschau** in Einstellungen Claude Code aus.156Der Browser folgt den gleichen [Site-Allowlist- und Blocklist-Kontrollen](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls) wie die Claude in Chrome-Erweiterung. Wenn Ihre Organisation diese Listen bereits für die Erweiterung konfiguriert hat, respektiert der Browser sie automatisch. Administratoren können auch Claudes Tools auf externen Seiten mit der verwalteten Einstellung [`browserExternalPageTools`](#managed-settings) ausschalten. Mit deaktivierten Tools können Benutzer immer noch zu externen Websites navigieren; Claudes Tools können sie nicht lesen oder bearbeiten.

124 157 

125<h3 id="review-changes-with-diff-view">158<h3 id="review-changes-with-diff-view">

126 Überprüfen Sie Änderungen mit der Diff-Ansicht159 Überprüfen Sie Änderungen mit der Diff-Ansicht


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

134 167 

135* **macOS**: drücken Sie **Cmd+Eingabe**168* **macOS**: drücken Sie **Cmd+Eingabe**

136* **Windows**: drücken Sie **Strg+Eingabe**169* **Windows**: drücken Sie **Ctrl+Eingabe**

137 170 

138Claude liest Ihre Kommentare und nimmt die angeforderten Änderungen vor, die als neuer Diff angezeigt werden, den Sie überprüfen können.171Claude liest Ihre Kommentare und nimmt die angeforderten Änderungen vor, die als neuer Diff angezeigt werden, den Sie überprüfen können.

139 172 


141 Überprüfen Sie Ihren Code174 Überprüfen Sie Ihren Code

142</h3>175</h3>

143 176 

144Klicken Sie in der Diff-Ansicht auf **Code überprüfen** in der oberen rechten Symbolleiste, um Claude zu bitten, die Änderungen vor dem Commit zu bewerten. Claude untersucht die aktuellen Diffs und hinterlässt Kommentare direkt in der Diff-Ansicht. Sie können auf jeden Kommentar antworten oder Claude bitten, zu überarbeiten.177Klicken Sie in der Diff-Ansicht auf **Review code** in der oberen rechten Symbolleiste, um Claude zu bitten, die Änderungen vor dem Commit zu bewerten. Claude untersucht die aktuellen Diffs und hinterlässt Kommentare direkt in der Diff-Ansicht. Sie können auf jeden Kommentar antworten oder Claude bitten, zu überarbeiten.

145 178 

146Die Überprüfung konzentriert sich auf hochwertige Probleme: Kompilierungsfehler, definitive Logikfehler, Sicherheitslücken und offensichtliche Fehler. Sie kennzeichnet keine Stil-, Formatierungs-, bereits vorhandenen Probleme oder etwas, das ein Linter erfassen würde.179Die Überprüfung konzentriert sich auf hochwertige Probleme: Kompilierungsfehler, definitive Logikfehler, Sicherheitslücken und offensichtliche Fehler. Sie kennzeichnet keine Stil-, Formatierungs-, bereits vorhandenen Probleme oder etwas, das ein Linter erfassen würde.

147 180 


151 184 

152Nachdem Sie einen Pull Request öffnen, wird eine CI-Statusleiste in der Sitzung angezeigt. Claude Code verwendet die GitHub CLI, um Prüfergebnisse abzurufen und Fehler anzuzeigen.185Nachdem Sie einen Pull Request öffnen, wird eine CI-Statusleiste in der Sitzung angezeigt. Claude Code verwendet die GitHub CLI, um Prüfergebnisse abzurufen und Fehler anzuzeigen.

153 186 

154* **Automatische Fehlerbehebung**: Wenn aktiviert, versucht Claude automatisch, fehlgeschlagene CI-Prüfungen zu beheben, indem die Fehlerausgabe gelesen und iteriert wird.187* **Auto-fix**: Wenn aktiviert, versucht Claude automatisch, fehlgeschlagene CI-Prüfungen zu beheben, indem die Fehlerausgabe gelesen und iteriert wird.

155* **Automatisches Merge**: Wenn aktiviert, führt Claude den PR zusammen, sobald alle Prüfungen bestanden sind. Die Merge-Methode ist Squash. Das automatische Merge muss [in Ihren GitHub-Repository-Einstellungen aktiviert sein](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository), damit dies funktioniert.188* **Auto-merge**: Wenn aktiviert, führt Claude den PR zusammen, sobald alle Prüfungen bestanden sind. Die Merge-Methode ist Squash. Das Auto-merge muss [in Ihren GitHub-Repository-Einstellungen aktiviert sein](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository), damit dies funktioniert.

156 189 

157Verwenden Sie die Umschalter **Automatische Fehlerbehebung** und **Automatisches Merge** in der CI-Statusleiste, um eine der beiden Optionen zu aktivieren. Claude Code sendet auch eine Desktop-Benachrichtigung, wenn CI abgeschlossen ist. Um die Sitzung automatisch zu archivieren, sobald der PR zusammengeführt oder geschlossen wird, schalten Sie [Auto-Archivieren](#work-in-parallel-with-sessions) in Einstellungen → Claude Code ein.190Verwenden Sie die Umschalter **Auto-fix** und **Auto-merge** in der CI-Statusleiste, um eine der beiden Optionen zu aktivieren. Claude Code sendet auch eine Desktop-Benachrichtigung, wenn CI abgeschlossen ist. Um die Sitzung automatisch zu archivieren, sobald der PR zusammengeführt oder geschlossen wird, schalten Sie [auto-archive](#work-in-parallel-with-sessions) in Einstellungen → Claude Code ein.

158 191 

159<Note>192<Note>

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


164 Anordnen Ihres Arbeitsbereichs197 Anordnen Ihres Arbeitsbereichs

165</h2>198</h2>

166 199 

167Die Code-Registerkarte ist um Panes aufgebaut, die Sie in jedem Layout anordnen können: Chat, Diff, Vorschau, Terminal, Datei, Plan, Aufgaben und Subagent. Ziehen Sie ein Pane an seiner Kopfzeile, um es zu verschieben, oder ziehen Sie eine Pane-Kante, um es zu vergrößern. Drücken Sie **Cmd+\\** auf macOS oder **Ctrl+\\** auf Windows, um das fokussierte Pane zu schließen. Öffnen Sie zusätzliche Panes aus dem Menü **Ansichten** in der Sitzungs-Symbolleiste.200Die Code-Registerkarte ist um Panes aufgebaut, die Sie in jedem Layout anordnen können: Chat, Diff, Browser, Terminal, Datei, Plan, Aufgaben und Subagent. Ziehen Sie ein Pane an seiner Kopfzeile, um es zu verschieben, oder ziehen Sie eine Pane-Kante, um es zu vergrößern. Drücken Sie **Cmd+\\** auf macOS oder **Ctrl+\\** auf Windows, um das fokussierte Pane zu schließen. Öffnen Sie zusätzliche Panes aus dem Menü **Ansichten** in der Sitzungs-Symbolleiste.

168 201 

169<Note>202<Note>

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


180 Öffnen und bearbeiten Sie Dateien213 Öffnen und bearbeiten Sie Dateien

181</h3>214</h3>

182 215 

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

184 217 

185Das Datei-Pane ist in lokalen und SSH-Sitzungen verfügbar. Für Remote-Sitzungen bitten Sie Claude, die Änderung vorzunehmen.218Das Datei-Pane ist in lokalen und SSH-Sitzungen verfügbar. Für Cloud-Sitzungen bitten Sie Claude, die Änderung vorzunehmen.

186 219 

187<h3 id="open-files-in-other-apps">220<h3 id="open-files-in-other-apps">

188 Öffnen Sie Dateien in anderen Apps221 Öffnen Sie Dateien in anderen Apps


224| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Nächste oder vorherige Sitzung |257| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Nächste oder vorherige Sitzung |

225| `Esc` | Claudes Antwort stoppen |258| `Esc` | Claudes Antwort stoppen |

226| `Cmd` `Shift` `D` | Diff-Pane umschalten |259| `Cmd` `Shift` `D` | Diff-Pane umschalten |

227| `Cmd` `Shift` `P` | Vorschau-Pane umschalten |260| `Cmd` `Shift` `B` | Browser-Pane umschalten |

228| `Cmd` `Shift` `S` | Element in Vorschau auswählen |261| `Cmd` `Shift` `S` | Element im Browser auswählen |

229| `Ctrl` `` ` `` | Terminal-Pane umschalten |262| `Ctrl` `` ` `` | Terminal-Pane umschalten |

230| `Cmd` `\` | Fokussiertes Pane schließen |263| `Cmd` `\` | Fokussiertes Pane schließen |

231| `Cmd` `;` | Seitenchat öffnen |264| `Cmd` `;` | Seitenchat öffnen |


461 494 

462Wenn `autoVerify` aktiviert ist, überprüft Claude automatisch Code-Änderungen nach dem Bearbeiten von Dateien. Es macht Screenshots, prüft auf Fehler und bestätigt, dass Änderungen funktionieren, bevor es seine Antwort abschließt.495Wenn `autoVerify` aktiviert ist, überprüft Claude automatisch Code-Änderungen nach dem Bearbeiten von Dateien. Es macht Screenshots, prüft auf Fehler und bestätigt, dass Änderungen funktionieren, bevor es seine Antwort abschließt.

463 496 

464Die automatische Überprüfung ist standardmäßig aktiviert. Deaktivieren Sie sie pro Projekt, indem Sie `"autoVerify": false` zu `.claude/launch.json` hinzufügen, oder schalten Sie sie aus dem Dropdown **Vorschau** um.497Die automatische Überprüfung ist standardmäßig aktiviert. Deaktivieren Sie sie pro Projekt, indem Sie `"autoVerify": false` zu `.claude/launch.json` hinzufügen, oder schalten Sie sie aus dem Dropdown Vorschau" um.

465 498 

466```json theme={null}499```json theme={null}

467{500{


686 719 

687Diese Einstellungen werden über die [Admin-Einstellungskonsole](https://claude.ai/admin-settings/claude-code) konfiguriert:720Diese Einstellungen werden über die [Admin-Einstellungskonsole](https://claude.ai/admin-settings/claude-code) konfiguriert:

688 721 

689* **Code in der Desktop-App**: Kontrollieren Sie, ob Benutzer in Ihrer Organisation auf Claude Code in der Desktop-App zugreifen können722* **Code in der Desktop**: Kontrollieren Sie, ob Benutzer in Ihrer Organisation auf Claude Code in der Desktop-App zugreifen können

690* **Code im Web**: Aktivieren oder deaktivieren Sie [Web-Sitzungen](/de/claude-code-on-the-web) für Ihre Organisation723* **Code im Web**: Aktivieren oder deaktivieren Sie [Web-Sitzungen](/de/claude-code-on-the-web) für Ihre Organisation

691* **Remote Control**: Aktivieren oder deaktivieren Sie [Remote Control](/de/remote-control) für Ihre Organisation724* **Remote Control**: Aktivieren oder deaktivieren Sie [Remote Control](/de/remote-control) für Ihre Organisation

692* **Bypass-Berechtigungsmodus deaktivieren**: Verhindern Sie, dass Benutzer in Ihrer Organisation den Bypass-Berechtigungsmodus aktivieren725* **Bypass-Berechtigungsmodus deaktivieren**: Verhindern Sie, dass Benutzer in Ihrer Organisation den Bypass-Berechtigungsmodus aktivieren


702| `permissions.disableBypassPermissionsMode` | auf `"disable"` setzen, um Benutzer daran zu hindern, den Bypass-Berechtigungsmodus zu aktivieren. |735| `permissions.disableBypassPermissionsMode` | auf `"disable"` setzen, um Benutzer daran zu hindern, den Bypass-Berechtigungsmodus zu aktivieren. |

703| `disableAutoMode` | auf `"disable"` setzen, um Benutzer daran zu hindern, den [Auto](/de/permission-modes#eliminate-prompts-with-auto-mode)-Modus zu aktivieren. Entfernt Auto aus dem Moduswahlschalter. Auch unter `permissions` akzeptiert. |736| `disableAutoMode` | auf `"disable"` setzen, um Benutzer daran zu hindern, den [Auto](/de/permission-modes#eliminate-prompts-with-auto-mode)-Modus zu aktivieren. Entfernt Auto aus dem Moduswahlschalter. Auch unter `permissions` akzeptiert. |

704| `autoMode` | passen Sie an, was der Auto-Modus-Klassifizierer über Ihre Organisation vertraut und blockiert. Siehe [Auto-Modus konfigurieren](/de/auto-mode-config). |737| `autoMode` | passen Sie an, was der Auto-Modus-Klassifizierer über Ihre Organisation vertraut und blockiert. Siehe [Auto-Modus konfigurieren](/de/auto-mode-config). |

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

705| `sshConfigs` | vorkonfigurieren Sie [SSH-Verbindungen](#pre-configure-ssh-connections-for-your-team), die in der Umgebungs-Dropdown angezeigt werden. Benutzer können verwaltete Verbindungen nicht bearbeiten oder löschen. |739| `sshConfigs` | vorkonfigurieren Sie [SSH-Verbindungen](#pre-configure-ssh-connections-for-your-team), die in der Umgebungs-Dropdown angezeigt werden. Benutzer können verwaltete Verbindungen nicht bearbeiten oder löschen. |

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

707| `managedMcpServers` | übertragen Sie MCP-Serverkonfigurationen an alle Benutzer in einer Drittanbieter-Bereitstellung. Jeder Eintrag gibt einen Transport von `"http"`, `"sse"` oder `"stdio"`, Verbindungsdetails und optional eine `toolPolicy`-Zuordnung an, die einschränkt, welche Tools in diesem Server Benutzer aufrufen können. Nur in Drittanbieter-Desktop-Bereitstellungen (3P) verfügbar. Stellen Sie diesen Schlüssel über die verwaltete Einstellungsdatei oder MDM bereit, da Drittanbieter-Bereitstellungen keine Admin-Konsolen-Einstellungen erhalten. |741| `managedMcpServers` | übertragen Sie MCP-Serverkonfigurationen an alle Benutzer in einer Drittanbieter-Bereitstellung. Jeder Eintrag gibt einen Transport von `"http"`, `"sse"` oder `"stdio"`, Verbindungsdetails und optional eine `toolPolicy`-Zuordnung an, die einschränkt, welche Tools in diesem Server Benutzer aufrufen können. Nur in Drittanbieter-Desktop-Bereitstellungen (3P) verfügbar. Stellen Sie diesen Schlüssel über die verwaltete Einstellungsdatei oder MDM bereit, da Drittanbieter-Bereitstellungen keine Admin-Konsolen-Einstellungen erhalten. |


754 788 

755Wenn Sie bereits die Claude Code CLI verwenden, führt Desktop dieselbe zugrunde liegende Engine mit einer grafischen Benutzeroberfläche aus. Sie können beide gleichzeitig auf demselben Computer ausführen, sogar auf demselben Projekt. Jede behält separate Sitzungsverlauf, aber sie teilen Konfiguration und Projektgedächtnis über CLAUDE.md-Dateien.789Wenn Sie bereits die Claude Code CLI verwenden, führt Desktop dieselbe zugrunde liegende Engine mit einer grafischen Benutzeroberfläche aus. Sie können beide gleichzeitig auf demselben Computer ausführen, sogar auf demselben Projekt. Jede behält separate Sitzungsverlauf, aber sie teilen Konfiguration und Projektgedächtnis über CLAUDE.md-Dateien.

756 790 

757Um 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 Windows verfügbar, wenn Sie mit einem Claude-Abonnement angemeldet sind. Er ist nicht mit API-Schlüssel-Authentifizierung oder auf Bedrock, Vertex oder Foundry verfügbar.791Um 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 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.

758 792 

759<Tip>793<Tip>

760 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.794 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.


804Diese Tabelle vergleicht Kernfunktionen zwischen CLI und Desktop. Für eine vollständige Liste der CLI-Flags siehe die [CLI-Referenz](/de/cli-reference).838Diese Tabelle vergleicht Kernfunktionen zwischen CLI und Desktop. Für eine vollständige Liste der CLI-Flags siehe die [CLI-Referenz](/de/cli-reference).

805 839 

806| Funktion | CLI | Desktop |840| Funktion | CLI | Desktop |

807| ------------------------------------------------------ | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |841| ------------------------------------------------------ | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

808| Berechtigungsmodi | Alle Modi einschließlich `dontAsk` | Berechtigungen erfragen, Bearbeitungen automatisch akzeptieren, Plan Mode, Auto und Bypass-Berechtigungen über Einstellungen |842| Berechtigungsmodi | Alle Modi einschließlich `dontAsk` | Berechtigungen erfragen, Bearbeitungen automatisch akzeptieren, Plan Mode, Auto und Bypass-Berechtigungen über Einstellungen |

809| `--dangerously-skip-permissions` | CLI-Flag | Bypass-Berechtigungsmodus. Aktivieren Sie in Einstellungen → Claude Code → „Bypass-Berechtigungsmodus zulassen" |843| `--dangerously-skip-permissions` | CLI-Flag | Bypass-Berechtigungsmodus. Aktivieren Sie in Einstellungen → Claude Code → „Bypass-Berechtigungsmodus zulassen" |

810| [Drittanbieter-Provider](/de/third-party-integrations) | Bedrock, Vertex AI, Foundry | Anthropics API standardmäßig. Enterprise-Bereitstellungen können Vertex AI und Gateway-Provider konfigurieren. Siehe das [Enterprise-Konfigurationshandbuch](https://support.claude.com/en/articles/12622667-enterprise-configuration). Um die Code-Registerkarte auf Bedrock, Vertex AI, Foundry oder einem selbstgehosteten LLM-Gateway auszuführen, siehe [Cowork on 3P Research Preview](https://claude.com/docs/cowork/3p/overview). |844| [Drittanbieter-Provider](/de/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | Anthropic's API standardmäßig. Enterprise-Bereitstellungen können Google Cloud's Agent Platform und Gateway-Provider konfigurieren. Siehe das [Enterprise-Konfigurationshandbuch](https://support.claude.com/en/articles/12622667-enterprise-configuration). Um die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway auszuführen, siehe [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |

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

812| [Plugins](/de/plugins) | `/plugin`-Befehl | Plugin-Manager-UI |846| [Plugins](/de/plugins) | `/plugin`-Befehl | Plugin-Manager-UI |

813| @mention-Dateien | Textbasiert | Mit Autovervollständigung; lokale und SSH-Sitzungen nur |847| @mention-Dateien | Textbasiert | Mit Autovervollständigung; lokale und SSH-Sitzungen nur |


825 859 

826Die folgenden Funktionen sind nur in der CLI oder VS Code-Erweiterung verfügbar, außer wo anders angegeben:860Die folgenden Funktionen sind nur in der CLI oder VS Code-Erweiterung verfügbar, außer wo anders angegeben:

827 861 

828* **Drittanbieter-Provider**: Desktop verbindet sich mit Anthropics API standardmäßig. Enterprise-Bereitstellungen können Vertex AI und Gateway-Provider über [verwaltete Einstellungen](https://support.claude.com/en/articles/12622667-enterprise-configuration) konfigurieren. Für Bedrock oder Foundry in der CLI siehe [Schnellstart](/de/quickstart). Als Ausnahme zum obigen Abschnitt führt [Cowork on 3P Research Preview](https://claude.com/docs/cowork/3p/overview) die Code-Registerkarte auf Bedrock, Vertex AI, Foundry oder einem selbstgehosteten LLM-Gateway aus.862* **Drittanbieter-Provider**: Desktop verbindet sich mit Anthropic's API standardmäßig. Enterprise-Bereitstellungen können Google Cloud's Agent Platform und Gateway-Provider über [verwaltete Einstellungen](https://support.claude.com/en/articles/12622667-enterprise-configuration) konfigurieren. Für Amazon Bedrock oder Microsoft Foundry in der CLI siehe [Schnellstart](/de/quickstart). Als Ausnahme zum obigen Abschnitt führt [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway aus.

829* **Linux (Beta)**: Computernutzung ist noch nicht in der Linux-Desktop-App verfügbar. Siehe [Claude Desktop auf Linux](/de/desktop-linux).863* **Linux (Beta)**: Computernutzung ist noch nicht in der Linux-Desktop-App verfügbar. Siehe [Claude Desktop auf Linux](/de/desktop-linux).

830* **Inline-Code-Vorschläge**: Desktop bietet keine Autovervollständigungs-ähnlichen Vorschläge. Es funktioniert durch Gesprächseingaben und explizite Code-Änderungen.864* **Inline-Code-Vorschläge**: Desktop bietet keine Autovervollständigungs-ähnlichen Vorschläge. Es funktioniert durch Gesprächseingaben und explizite Code-Änderungen.

831* **Agent-Teams**: Parallele Claude Code-Sitzungen, die sich gegenseitig Nachrichten senden, sind in der [CLI](/de/agent-teams) verfügbar, nicht in Desktop. Für Multi-Agent-Arbeit innerhalb einer Sitzung verwenden Sie [dynamische Workflows](/de/workflows), die in Desktop ausgeführt werden.865* **Agent-Teams**: Parallele Claude Code-Sitzungen, die sich gegenseitig Nachrichten senden, sind in der [CLI](/de/agent-teams) verfügbar, nicht in Desktop. Für Multi-Agent-Arbeit innerhalb einer Sitzung verwenden Sie [dynamische Workflows](/de/workflows), die in Desktop ausgeführt werden.

832* **Terminal-Dialog-Befehle**: Integrierte Befehle, die ein interaktives Panel im Terminal öffnen, wie `/permissions`, `/config` und `/doctor`, sind nicht auf der Registerkarte „Code" verfügbar und antworten mit `isn't available in this environment`. Bearbeiten Sie [Einstellungsdateien](/de/settings) direkt, um Berechtigungsregeln und Konfiguration zu verwalten, oder führen Sie den Befehl aus der eigenständigen CLI aus.866* **Terminal-Dialog-Befehle**: Integrierte Befehle, die ein interaktives Panel im Terminal öffnen, wie `/permissions` und `/config`, sind nicht auf der Registerkarte „Code" verfügbar und antworten mit `isn't available in this environment`. `/config` setzt eine Einstellung, wenn Sie `key=value` übergeben, zum Beispiel `/config theme=dark`; nur die Auswahlform ist nicht verfügbar. Bearbeiten Sie [Einstellungsdateien](/de/settings) direkt, um Berechtigungsregeln und Konfiguration zu verwalten, oder führen Sie den Befehl aus der eigenständigen CLI aus.

833 867 

834<h2 id="troubleshooting">868<h2 id="troubleshooting">

835 Fehlerbehebung869 Fehlerbehebung

desktop-linux.md +26 −2

Details

25 Installation25 Installation

26</h2>26</h2>

27 27 

28Installieren Sie aus dem apt-Repository von Anthropic, damit Updates über die regulären Paketaktualisierungen Ihres Systems ankommen.28Installieren Sie aus dem apt-Repository von Anthropic, damit Updates über die regulären Paketaktualisierungen Ihres Systems ankommen. Öffnen Sie ein Terminal und führen Sie die Befehle in jedem Schritt aus.

29 29 

30<Steps>30<Steps>

31 <Step title="Anthropics apt-Repository hinzufügen">31 <Step title="Anthropics apt-Repository hinzufügen">

32 Dieser Schritt lädt den Signaturschlüssel mit `curl` herunter, den frische Debian- und Ubuntu-Installationen möglicherweise nicht enthalten. Wenn der Download-Befehl mit `sudo: curl: command not found` fehlschlägt, installieren Sie zunächst curl:

33 

34 ```bash theme={null}

35 sudo apt install curl

36 ```

37 

32 Laden Sie den Signaturschlüssel von Anthropic herunter:38 Laden Sie den Signaturschlüssel von Anthropic herunter:

33 39 

34 ```bash theme={null}40 ```bash theme={null}


69 Installation aus einer heruntergeladenen Datei75 Installation aus einer heruntergeladenen Datei

70</h3>76</h3>

71 77 

72Wenn Sie das apt-Repository nicht verwenden können, laden Sie das `.deb`-Paket für Ihre Architektur (x64 oder arm64) von [claude.com/download](https://claude.com/download) herunter und öffnen Sie es entweder mit Ihrem Software-Installer oder führen Sie es aus Ihrem Download-Verzeichnis aus:78Wenn Sie das apt-Repository nicht verwenden können, laden Sie zunächst das `.deb`-Paket für Ihre Architektur (x64 oder arm64) von [claude.com/download](https://claude.com/download) herunter. Öffnen Sie dann die heruntergeladene Datei mit Ihrem Software-Installer oder installieren Sie sie mit apt aus dem Verzeichnis, das die heruntergeladene Datei enthält:

73 79 

74```bash theme={null}80```bash theme={null}

75sudo apt install ./claude-desktop_*.deb81sudo apt install ./claude-desktop_*.deb

76```82```

77 83 

84Wenn apt `E: Unsupported file ./claude-desktop_*.deb given on commandline` meldet, hat das Muster keine `.deb`-Datei im aktuellen Verzeichnis gefunden. Bestätigen Sie, dass der Download abgeschlossen ist, und führen Sie den Befehl erneut aus dem Verzeichnis aus, das die Datei enthält.

85 

78Ein auf diese Weise installiertes `.deb`-Paket erhält keine Updates. Um Updates über apt zu erhalten, fügen Sie das Repository wie oben gezeigt hinzu oder kommentieren Sie die `deb`-Zeile im Platzhalter-Eintrag aus, den das Paket in `/etc/apt/sources.list.d/claude-desktop.list` schreibt.86Ein auf diese Weise installiertes `.deb`-Paket erhält keine Updates. Um Updates über apt zu erhalten, fügen Sie das Repository wie oben gezeigt hinzu oder kommentieren Sie die `deb`-Zeile im Platzhalter-Eintrag aus, den das Paket in `/etc/apt/sources.list.d/claude-desktop.list` schreibt.

79 87 

80<h2 id="update">88<h2 id="update">


103sudo rm /etc/apt/sources.list.d/claude-desktop.list111sudo rm /etc/apt/sources.list.d/claude-desktop.list

104```112```

105 113 

114<h2 id="troubleshoot">

115 Fehlerbehebung

116</h2>

117 

118<h3 id="unable-to-locate-package-claude-desktop">

119 Paket claude-desktop kann nicht gefunden werden

120</h3>

121 

122Wenn `sudo apt install claude-desktop` mit `E: Unable to locate package claude-desktop` fehlschlägt, hat apt das hinzugefügte Repository nicht gefunden. Überprüfen Sie Folgendes:

123 

124* Bestätigen Sie, dass der Repository-Eintrag geschrieben wurde. `cat /etc/apt/sources.list.d/claude-desktop.list` sollte die `deb`-Zeile aus dem Schritt [Anthropics apt-Repository hinzufügen](#install) anzeigen. Wenn die Datei leer oder fehlend ist, führen Sie diesen Schritt erneut aus.

125* Bestätigen Sie, dass Ihre Architektur unterstützt wird. `dpkg --print-architecture` sollte `amd64` oder `arm64` ausgeben. Das Repository veröffentlicht keine Pakete für andere Architekturen.

126* Führen Sie `sudo apt update` erneut aus und überprüfen Sie die Ausgabe auf Fehler im Zusammenhang mit `downloads.claude.ai`. Ein Netzwerk- oder Schlüsselfehler dort bedeutet, dass das Repository hinzugefügt wurde, aber nicht erreichbar oder nicht verifizierbar war.

127 

128Wenn das Repository vorhanden und erreichbar ist und das Paket immer noch nicht gefunden wird, [installieren Sie stattdessen aus einer heruntergeladenen Datei](#install-from-a-downloaded-file).

129 

106<h2 id="what’s-not-in-the-linux-beta-yet">130<h2 id="what’s-not-in-the-linux-beta-yet">

107 Was noch nicht in der Linux-Beta enthalten ist131 Was noch nicht in der Linux-Beta enthalten ist

108</h2>132</h2>

Details

113 113 

114**Überprüfen Sie Änderungen vor dem Commit.** Nachdem Claude Dateien bearbeitet hat, wird ein `+12 -1`-Indikator angezeigt. Klicken Sie darauf, um die [Diff-Ansicht](/de/desktop#review-changes-with-diff-view) zu öffnen, überprüfen Sie Änderungen Datei für Datei und kommentieren Sie bestimmte Zeilen. Claude liest Ihre Kommentare und überarbeitet. Klicken Sie auf **Code überprüfen**, um Claude die Diffs selbst auswerten zu lassen und Inline-Vorschläge zu hinterlassen.114**Überprüfen Sie Änderungen vor dem Commit.** Nachdem Claude Dateien bearbeitet hat, wird ein `+12 -1`-Indikator angezeigt. Klicken Sie darauf, um die [Diff-Ansicht](/de/desktop#review-changes-with-diff-view) zu öffnen, überprüfen Sie Änderungen Datei für Datei und kommentieren Sie bestimmte Zeilen. Claude liest Ihre Kommentare und überarbeitet. Klicken Sie auf **Code überprüfen**, um Claude die Diffs selbst auswerten zu lassen und Inline-Vorschläge zu hinterlassen.

115 115 

116**Passen Sie an, wie viel Kontrolle Sie haben.** Ihr [Berechtigungsmodus](/de/desktop#choose-a-permission-mode) steuert das Gleichgewicht. „Berechtigungen erfragen" (Standard) erfordert Genehmigung vor jeder Bearbeitung. „Auto-Akzeptanz" akzeptiert Dateibearbeitungen automatisch für schnellere Iteration. Der Plan Mode lässt Claude einen Ansatz planen, ohne Dateien zu berühren, was vor einem großen Refactoring nützlich ist.116**Passen Sie an, wie viel Kontrolle Sie haben.** Ihr [Berechtigungsmodus](/de/desktop#choose-a-permission-mode) steuert, wie viel Claude ohne Genehmigung tun kann:

117 

118* **Manuell**: die Standardeinstellung. Claude fragt vor dem Bearbeiten von Dateien oder dem Ausführen von Befehlen.

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

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

117 121 

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

119 123 

120**Arrangieren Sie Ihren Arbeitsbereich.** Ziehen Sie die Chat-, Diff-, Terminal-, Datei- und Vorschau-Bereiche in das Layout, das Sie möchten. Öffnen Sie das Terminal mit **Strg+\`**, um Befehle neben Ihrer Sitzung auszuführen, oder klicken Sie auf einen Dateipfad, um ihn im Datei-Bereich zu öffnen. Siehe [Arrangieren Sie Ihren Arbeitsbereich](/de/desktop#arrange-your-workspace).124**Arrangieren Sie Ihren Arbeitsbereich.** Ziehen Sie die Chat-, Diff-, Terminal-, Datei- und Browser-Bereiche in das Layout, das Sie möchten. Öffnen Sie das Terminal mit **Strg+\`**, um Befehle neben Ihrer Sitzung auszuführen, oder klicken Sie auf einen Dateipfad, um ihn im Datei-Bereich zu öffnen. Siehe [Arrangieren Sie Ihren Arbeitsbereich](/de/desktop#arrange-your-workspace).

121 125 

122**Zeigen Sie eine Vorschau Ihrer App an.** Klicken Sie auf das Dropdown-Menü **Vorschau**, um Ihren Dev-Server direkt im Desktop auszuführen. Claude kann die laufende App anzeigen, Endpunkte testen, Protokolle überprüfen und auf das, was es sieht, iterieren. Siehe [Zeigen Sie eine Vorschau Ihrer App an](/de/desktop#preview-your-app).126**Zeigen Sie eine Vorschau Ihrer App an.** Wenn Sie Ihren Dev-Server im Desktop ausführen, öffnet sich Ihre App im Browser-Bereich, der auch [externe Websites öffnen](/de/desktop#browse-external-sites) kann. Claude kann die laufende App anzeigen, Endpunkte testen, Protokolle überprüfen und auf das, was es sieht, iterieren. Siehe [Zeigen Sie eine Vorschau Ihrer App an](/de/desktop#preview-your-app).

123 127 

124**Verfolgen Sie Ihren Pull Request.** Nachdem Sie einen PR geöffnet haben, überwacht Claude Code die CI-Prüfungsergebnisse und kann Fehler automatisch beheben oder den PR zusammenführen, sobald alle Prüfungen bestanden sind. Siehe [Überwachen Sie den Pull-Request-Status](/de/desktop#monitor-pull-request-status).128**Verfolgen Sie Ihren Pull Request.** Nachdem Sie einen PR geöffnet haben, überwacht Claude Code die CI-Prüfungsergebnisse und kann Fehler automatisch beheben oder den PR zusammenführen, sobald alle Prüfungen bestanden sind. Siehe [Überwachen Sie den Pull-Request-Status](/de/desktop#monitor-pull-request-status).

125 129 

devcontainer.md +2 −2

Details

75Was Sie bei der Authentifizierungsaufforderung sehen, hängt von Ihrem Anbieter ab:75Was Sie bei der Authentifizierungsaufforderung sehen, hängt von Ihrem Anbieter ab:

76 76 

77* **Anthropic**: Melden Sie sich über einen Browser mit Ihrem Claude- oder Anthropic Console-Konto an77* **Anthropic**: Melden Sie sich über einen Browser mit Ihrem Claude- oder Anthropic Console-Konto an

78* **[Amazon Bedrock, Google Vertex AI oder Microsoft Foundry](/de/third-party-integrations)**: Claude Code verwendet Ihre Cloud-Anbieter-Anmeldedaten, ohne Browser-Aufforderung78* **[Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry](/de/third-party-integrations)**: Claude Code verwendet Ihre Cloud-Anbieter-Anmeldedaten, ohne Browser-Aufforderung

79 79 

80Für Cloud-Anbieter übergeben Sie Anmeldedaten an den Container als Umgebungsvariablen über `containerEnv`, ein Codespaces-Geheimnis oder die Workload-Identität Ihrer Cloud, anstatt Anmeldedatendateien vom Host einzubinden. Siehe [Amazon Bedrock](/de/amazon-bedrock), [Google Vertex AI](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) für die Anmeldedatenkette, die Claude Code liest.80Für Cloud-Anbieter übergeben Sie Anmeldedaten an den Container als Umgebungsvariablen über `containerEnv`, ein Codespaces-Geheimnis oder die Workload-Identität Ihrer Cloud, anstatt Anmeldedatendateien vom Host einzubinden. Siehe [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) für die Anmeldedatenkette, die Claude Code liest.

81 81 

82Siehe [Wählen Sie Ihren API-Anbieter](/de/admin-setup#choose-your-api-provider), um zu entscheiden, welcher Weg zu Ihrer Organisation passt.82Siehe [Wählen Sie Ihren API-Anbieter](/de/admin-setup#choose-your-api-provider), um zu entscheiden, welcher Weg zu Ihrer Organisation passt.

83 83 

Details

332* eingeben, um nach Plugin-Name oder Beschreibung zu filtern332* eingeben, um nach Plugin-Name oder Beschreibung zu filtern

333* Enter drücken, um die Detailansicht eines Plugins zu öffnen und es zu aktivieren, zu deaktivieren oder zu deinstallieren333* Enter drücken, um die Detailansicht eines Plugins zu öffnen und es zu aktivieren, zu deaktivieren oder zu deinstallieren

334 334 

335Das Deinstallieren eines Plugins, das die `.claude/settings.json` eines Projekts aktiviert, fragt, welchen Bereich Sie meinen: Deaktivieren Sie es nur für sich selbst, was einen Override in Ihre `.claude/settings.local.json` schreibt und das Plugin für das Projekt installiert lässt, oder deinstallieren Sie es für alle, was es aus der gemeinsamen `.claude/settings.json` entfernt. Erfordert Claude Code v2.1.203 oder später. Vor v2.1.203 bot der Dialog nur die lokale Deaktivierung an.

336 

335Die Detailansicht zeigt die Komponenten, die das Plugin bereitstellt: Befehle, Skills, Agenten, Hooks, MCP-Server und LSP-Server. Das gleiche Inventar ist über die Befehlszeile mit `claude plugin details` verfügbar.337Die Detailansicht zeigt die Komponenten, die das Plugin bereitstellt: Befehle, Skills, Agenten, Hooks, MCP-Server und LSP-Server. Das gleiche Inventar ist über die Befehlszeile mit `claude plugin details` verfügbar.

336 338 

337In Claude Code v2.1.187 und später fügt die Registerkarte „Installed" eine Gruppe **Not used recently** für Marketplace-Plugins hinzu, die Sie selbst installiert haben, aber in mindestens zwei Wochen und über mindestens 10 Sitzungen hinweg nicht aufgerufen haben, und die Detailansicht zeigt eine Zeile **Last used** für jedes Plugin. Verwenden Sie diese, um Plugins zu finden, die Sie nicht mehr verwenden, aber die immer noch Startup- und Kontextkosten verursachen, und deaktivieren oder deinstallieren Sie diese dann.339Die Registerkarte **Installed** sammelt auch Marketplace-Plugins, die Sie selbst installiert haben, aber in mindestens zwei Wochen über einen Zeitraum von mindestens 10 Sitzungen nicht verwendet haben, unter einem Header **Not used recently**. Die Detailansicht zeigt eine Zeile **Last used** für jedes Plugin. Verwenden Sie diese, um Plugins zu finden, die immer noch Startup- und Kontextkosten verursachen, obwohl Sie sie nicht mehr verwenden, und deaktivieren oder deinstallieren Sie diese dann. Erfordert Claude Code v2.1.187 oder später.

340 

341Zwei Arten von Plugins werden niemals als ungenutzt aufgelistet:

342 

343* Plugins, die Ihre Organisation verwaltet oder die Sie mit `--plugin-dir` laden

344* Plugins, die ein Theme, einen Output-Stil, einen Monitor oder einen Workflow bereitstellen, da diese Wert ohne eine zu verfolgbare Invocation liefern

345 

346Der Header **Not used recently** und die Zeile **Last used** sind beide verborgen, wenn Ihre Organisation Marketplaces mit [`strictKnownMarketplaces`](/de/settings#strictknownmarketplaces) einschränkt.

338 347 

339Plugins, die Ihre Organisation verwaltet oder die Sie mit `--plugin-dir` laden, werden niemals als ungenutzt aufgelistet, und Plugins, die einen LSP-Server, ein Theme, einen Output-Stil, einen Monitor oder einen Workflow bereitstellen, werden ebenfalls niemals aufgelistet, da diese Wert ohne eine zu verfolgbare Invocation liefern. Die Gruppe und die Zeile **Last used** sind beide verborgen, wenn Ihre Organisation Marketplaces mit [`strictKnownMarketplaces`](/de/settings#strictknownmarketplaces) einschränkt.348Ein [Language Server](/de/plugins#add-lsp-servers-to-your-plugin) eines Plugins zählt als verwendet, wenn er Diagnostiken liefert oder eine Code-Navigationsanfrage beantwortet, sodass ein LSP-Plugin, dessen Server in Ihren Sitzungen aktiv ist, nicht als ungenutzt aufgelistet wird. Vor v2.1.203 konnte die Language-Server-Aktivität nicht als Verwendung gezählt werden, sodass Plugins, die einen LSP-Server bereitstellen, vollständig von der Gruppe ausgenommen waren, genauso wie Theme- und Output-Style-Plugins es immer noch sind.

340 349 

341Wenn Sie ein Plugin installieren, das Abhängigkeiten deklariert, listet die Installationsausgabe auf, welche Abhängigkeiten zusammen mit ihm automatisch installiert wurden.350Wenn Sie ein Plugin installieren, das Abhängigkeiten deklariert, listet die Installationsausgabe auf, welche Abhängigkeiten zusammen mit ihm automatisch installiert wurden.

342 351 

env-vars.md +57 −51

Details

102| `ANTHROPIC_AWS_API_KEY` | Workspace API-Schlüssel für [Claude Platform on AWS](/de/claude-platform-on-aws), generiert in der AWS-Konsole. Wird als `x-api-key` gesendet und hat Vorrang vor AWS SigV4 |102| `ANTHROPIC_AWS_API_KEY` | Workspace API-Schlüssel für [Claude Platform on AWS](/de/claude-platform-on-aws), generiert in der AWS-Konsole. Wird als `x-api-key` gesendet und hat Vorrang vor AWS SigV4 |

103| `ANTHROPIC_AWS_BASE_URL` | Überschreiben Sie die [Claude Platform on AWS](/de/claude-platform-on-aws)-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Regionen oder beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Standardmäßig `https://aws-external-anthropic.{AWS_REGION}.api.aws` |103| `ANTHROPIC_AWS_BASE_URL` | Überschreiben Sie die [Claude Platform on AWS](/de/claude-platform-on-aws)-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Regionen oder beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Standardmäßig `https://aws-external-anthropic.{AWS_REGION}.api.aws` |

104| `ANTHROPIC_AWS_WORKSPACE_ID` | Erforderlich für [Claude Platform on AWS](/de/claude-platform-on-aws). Wird bei jeder Anfrage als `anthropic-workspace-id`-Header gesendet |104| `ANTHROPIC_AWS_WORKSPACE_ID` | Erforderlich für [Claude Platform on AWS](/de/claude-platform-on-aws). Wird bei jeder Anfrage als `anthropic-workspace-id`-Header gesendet |

105| `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 die [MCP-Tool-Suche](/de/mcp#scale-with-mcp-tool-search) standardmäßig deaktiviert. Setzen Sie `ENABLE_TOOL_SEARCH=true`, wenn Ihr Proxy `tool_reference`-Blöcke weiterleitet. {/* min-version: 2.1.196 */}Ab v2.1.196 ist die [Remote Control](/de/remote-control#requirements) deaktiviert, wenn dies auf einen anderen Host als `api.anthropic.com` verweist, was seinem Verhalten auf Bedrock, Vertex AI und Foundry entspricht |105| `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 die [MCP-Tool-Suche](/de/mcp#scale-with-mcp-tool-search) standardmäßig deaktiviert. Setzen Sie `ENABLE_TOOL_SEARCH=true`, wenn Ihr Proxy `tool_reference`-Blöcke weiterleitet. {/* min-version: 2.1.196 */}Ab v2.1.196 ist die [Remote Control](/de/remote-control#requirements) deaktiviert, wenn dies auf einen anderen Host als `api.anthropic.com` verweist, was seinem Verhalten auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry entspricht |

106| `ANTHROPIC_BEDROCK_BASE_URL` | Überschreiben Sie die Bedrock-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Bedrock-Endpunkte oder beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Siehe [Amazon Bedrock](/de/amazon-bedrock) |106| `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](/de/llm-gateway). Siehe [Amazon Bedrock](/de/amazon-bedrock) |

107| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreiben Sie die Bedrock Mantle-Endpunkt-URL. Siehe [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) |107| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreiben Sie die Amazon Bedrock Mantle-Endpunkt-URL. Siehe [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) |

108| `ANTHROPIC_BEDROCK_SERVICE_TIER` | 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](/de/amazon-bedrock#service-tiers) |108| `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](/de/amazon-bedrock#service-tiers) |

109| `ANTHROPIC_BETAS` | Kommagetrennte 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](/de/cli-reference#cli-flags), das API-Schlüssel-Authentifizierung erfordert, funktioniert diese Variable mit allen Authentifizierungsmethoden, einschließlich Claude.ai-Abonnement |109| `ANTHROPIC_BETAS` | Kommagetrennte 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](/de/cli-reference#cli-flags), das API-Schlüssel-Authentifizierung erfordert, funktioniert diese Variable mit allen Authentifizierungsmethoden, einschließlich Claude.ai-Abonnement |

110| `ANTHROPIC_CUSTOM_HEADERS` | Benutzerdefinierte Header, die zu Anfragen hinzugefügt werden (Format `Name: Value`, durch Zeilenumbruch getrennt für mehrere Header) |110| `ANTHROPIC_CUSTOM_HEADERS` | Benutzerdefinierte Header, die zu Anfragen hinzugefügt werden (Format `Name: Value`, durch Zeilenumbruch getrennt für mehrere Header) |

111| `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](/de/model-config#add-a-custom-model-option) |111| `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](/de/model-config#add-a-custom-model-option) |


129| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |129| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |

130| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |130| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |

131| `ANTHROPIC_FOUNDRY_API_KEY` | API-Schlüssel für Microsoft Foundry-Authentifizierung (siehe [Microsoft Foundry](/de/microsoft-foundry)) |131| `ANTHROPIC_FOUNDRY_API_KEY` | API-Schlüssel für Microsoft Foundry-Authentifizierung (siehe [Microsoft Foundry](/de/microsoft-foundry)) |

132| `ANTHROPIC_FOUNDRY_BASE_URL` | Vollständige Basis-URL für die Foundry-Ressource (z. B. `https://my-resource.services.ai.azure.com/anthropic`). Alternative zu `ANTHROPIC_FOUNDRY_RESOURCE` (siehe [Microsoft Foundry](/de/microsoft-foundry)) |132| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | {/* min-version: 2.1.203 */}Bearer-Token für Microsoft Foundry-Authentifizierung, z. B. ein Microsoft Entra-Zugriffstoken. Claude Code sendet es als `Authorization: Bearer`-Header. Hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY` und vor der Azure-Standard-Anmeldedatenkette. Siehe [Microsoft Foundry](/de/microsoft-foundry). Erfordert Claude Code v2.1.203 oder später |

133| `ANTHROPIC_FOUNDRY_RESOURCE` | Foundry-Ressourcenname (z. B. `my-resource`). Erforderlich, wenn `ANTHROPIC_FOUNDRY_BASE_URL` nicht gesetzt ist (siehe [Microsoft Foundry](/de/microsoft-foundry)) |133| `ANTHROPIC_FOUNDRY_BASE_URL` | Vollständige Basis-URL für die Microsoft Foundry-Ressource (z. B. `https://my-resource.services.ai.azure.com/anthropic`). Alternative zu `ANTHROPIC_FOUNDRY_RESOURCE` (siehe [Microsoft Foundry](/de/microsoft-foundry)) |

134| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry-Ressourcenname (z. B. `my-resource`). Erforderlich, wenn `ANTHROPIC_FOUNDRY_BASE_URL` nicht gesetzt ist (siehe [Microsoft Foundry](/de/microsoft-foundry)) |

134| `ANTHROPIC_MODEL` | Name der zu verwendenden Modelleinstellung (siehe [Modellkonfiguration](/de/model-config#environment-variables)) |135| `ANTHROPIC_MODEL` | Name der zu verwendenden Modelleinstellung (siehe [Modellkonfiguration](/de/model-config#environment-variables)) |

135| `ANTHROPIC_SMALL_FAST_MODEL` | \[VERALTET] Name des [Haiku-Klasse-Modells für Hintergrundaufgaben](/de/costs) |136| `ANTHROPIC_SMALL_FAST_MODEL` | \[VERALTET] Name des [Haiku-Klasse-Modells für Hintergrundaufgaben](/de/costs) |

136| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | AWS-Region für das Haiku-Klasse-Modell bei Verwendung von Bedrock oder Bedrock Mantle überschreiben. Auf Bedrock wirkt sich dies nur aus, wenn `ANTHROPIC_DEFAULT_HAIKU_MODEL` oder das veraltete `ANTHROPIC_SMALL_FAST_MODEL` auch gesetzt ist, da Bedrock ansonsten das primäre Modell für Hintergrundaufgaben verwendet |137| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | AWS-Region für das Haiku-Klasse-Modell bei Verwendung von Amazon Bedrock oder Amazon Bedrock Mantle überschreiben. Auf Amazon Bedrock wirkt sich dies nur aus, wenn `ANTHROPIC_DEFAULT_HAIKU_MODEL` oder das veraltete `ANTHROPIC_SMALL_FAST_MODEL` auch gesetzt ist, da Amazon Bedrock ansonsten das primäre Modell für Hintergrundaufgaben verwendet |

137| `ANTHROPIC_VERTEX_BASE_URL` | Überschreiben Sie die Vertex AI-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Vertex-Endpunkte oder beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Siehe [Google Vertex AI](/de/google-vertex-ai) |138| `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](/de/llm-gateway). Siehe [Google Cloud's Agent Platform](/de/google-vertex-ai) |

138| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP-Projekt-ID für Vertex AI-Anfragen. Wird überschrieben durch `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` oder das Projekt in Ihrer `GOOGLE_APPLICATION_CREDENTIALS`-Anmeldedatei. Siehe [Google Vertex AI](/de/google-vertex-ai) |139| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP-Projekt-ID für Google Cloud's Agent Platform-Anfragen. Wird überschrieben durch `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` oder das Projekt in Ihrer `GOOGLE_APPLICATION_CREDENTIALS`-Anmeldedatei. Siehe [Google Cloud's Agent Platform](/de/google-vertex-ai) |

139| `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 Verbundungsregel auf mehr als einen Workspace beschränkt ist, damit der Token-Austausch weiß, welcher Workspace das Ziel ist |140| `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 Verbundungsregel auf mehr als einen Workspace beschränkt ist, damit der Token-Austausch weiß, welcher Workspace das Ziel ist |

140| `API_FORCE_IDLE_TIMEOUT` | {/* min-version: 2.1.169 */}Überschreiben Sie das 5-Minuten-Idle-Timeout, das eine Streaming-Modell-Antwort abbricht, wenn keine Bytes ankommen. Setzen Sie auf `0`, um das Timeout zu deaktivieren, z. B. wenn ein langsames [Gateway](/de/llm-gateway) oder lokales Modell länger als 5 Minuten zwischen Chunks pausiert. Setzen Sie auf `1`, um das Timeout bei jedem Provider zu behalten. Wenn nicht gesetzt, ist das Timeout bei direkten Anthropic API- und [Claude Platform on AWS](/de/claude-platform-on-aws)-Verbindungen inaktiv, wo Claude Codes eigener Byte-Level-Stream-Watchdog läuft, und aktiv bei jedem anderen Provider, einschließlich [Vertex AI](/de/google-vertex-ai), [Foundry](/de/microsoft-foundry), [Mantle](/de/amazon-bedrock#use-the-mantle-endpoint), [Bedrock](/de/amazon-bedrock) und Gateway-Verbindungen, sodass ein stillgelegter Stream abbricht, anstatt zu hängen. Ab v2.1.169 |141| `API_FORCE_IDLE_TIMEOUT` | {/* min-version: 2.1.169 */}Überschreiben Sie das 5-Minuten-Idle-Timeout, das eine Streaming-Modell-Antwort abbricht, wenn keine Bytes ankommen. Setzen Sie auf `0`, um das Timeout zu deaktivieren, z. B. wenn ein langsames [Gateway](/de/llm-gateway) oder lokales Modell länger als 5 Minuten zwischen Chunks pausiert. Setzen Sie auf `1`, um das Timeout bei jedem Provider zu behalten. Wenn nicht gesetzt, ist das Timeout bei direkten Anthropic API- und [Claude Platform on AWS](/de/claude-platform-on-aws)-Verbindungen inaktiv, wo Claude Codes eigener Byte-Level-Stream-Watchdog läuft, und aktiv bei jedem anderen Provider, einschließlich [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry), [Mantle](/de/amazon-bedrock#use-the-mantle-endpoint), [Amazon Bedrock](/de/amazon-bedrock) und Gateway-Verbindungen, sodass ein stillgelegter Stream abbricht, anstatt zu hängen. Ab v2.1.169 |

141| `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-Fehler verursachen. Werte über dem Maximum führen zu Überläufen des zugrunde liegenden Timers und verursachen, dass Anfragen sofort fehlschlagen |142| `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-Fehler verursachen. Werte über dem Maximum führen zu Überläufen des zugrunde liegenden Timers und verursachen, dass Anfragen sofort fehlschlagen |

142| `AWS_BEARER_TOKEN_BEDROCK` | Bedrock API-Schlüssel für Authentifizierung (siehe [Bedrock API-Schlüssel](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |143| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock API-Schlüssel für Authentifizierung (siehe [Amazon Bedrock API-Schlüssel](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

143| `BASH_DEFAULT_TIMEOUT_MS` | Standard-Timeout für lang laufende Bash-Befehle (Standard: 120000 oder 2 Minuten) |144| `BASH_DEFAULT_TIMEOUT_MS` | Standard-Timeout für lang laufende Bash-Befehle (Standard: 120000 oder 2 Minuten) |

144| `BASH_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen in Bash-Ausgaben, bevor die vollständige Ausgabe in einer Datei gespeichert wird und Claude den Pfad plus eine kurze Vorschau erhält. Siehe [Bash-Tool-Verhalten](/de/tools-reference#bash-tool-behavior) |145| `BASH_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen in Bash-Ausgaben, bevor die vollständige Ausgabe in einer Datei gespeichert wird und Claude den Pfad plus eine kurze Vorschau erhält. Siehe [Bash-Tool-Verhalten](/de/tools-reference#bash-tool-behavior) |

145| `BASH_MAX_TIMEOUT_MS` | Maximales Timeout, das das Modell für lang laufende Bash-Befehle setzen kann (Standard: 600000 oder 10 Minuten) |146| `BASH_MAX_TIMEOUT_MS` | Maximales Timeout, das das Modell für lang laufende Bash-Befehle setzen kann (Standard: 600000 oder 10 Minuten) |

146| `CCR_FORCE_BUNDLE` | Setzen Sie auf `1`, um [`claude --remote`](/de/claude-code-on-the-web#send-local-repositories-without-github) zu erzwingen, Ihr lokales Repository zu bündeln und hochzuladen, auch wenn GitHub-Zugriff verfügbar ist |147| `CCR_FORCE_BUNDLE` | Setzen Sie auf `1`, um [`claude --cloud`](/de/claude-code-on-the-web#send-local-repositories-without-github) zu erzwingen, Ihr lokales Repository zu bündeln und hochzuladen, auch wenn GitHub-Zugriff verfügbar ist |

147| `CLAUDECODE` | Auf `1` in Subprozessen gesetzt, die Claude Code spawnt (Bash- und PowerShell-Tools, tmux-Sitzungen, [Hook](/de/hooks)-Befehle, [Statuszeilen](/de/statusline)-Befehle, stdio [MCP-Server](/de/mcp)-Subprozesse). IDE-Erweiterungen setzen dies auch in ihren integrierten Terminals. Verwenden Sie, um zu erkennen, wenn ein Skript in einem Subprozess ausgeführt wird, der von Claude Code gespawnt wurde. Um zu überprüfen, ob der aktuelle Prozess direkt von einem Tool-Aufruf oder Hook gespawnt wurde, anstatt in einem stdio [MCP-Server](/de/mcp), den Claude Code gestartet hat, verwenden Sie stattdessen `CLAUDE_CODE_CHILD_SESSION` |148| `CLAUDECODE` | Auf `1` in Subprozessen gesetzt, die Claude Code spawnt (Bash- und PowerShell-Tools, tmux-Sitzungen, [Hook](/de/hooks)-Befehle, [Statuszeilen](/de/statusline)-Befehle, stdio [MCP-Server](/de/mcp)-Subprozesse). IDE-Erweiterungen setzen dies auch in ihren integrierten Terminals. Verwenden Sie, um zu erkennen, wenn ein Skript in einem Subprozess ausgeführt wird, der von Claude Code gespawnt wurde. Um zu überprüfen, ob der aktuelle Prozess direkt von einem Tool-Aufruf oder Hook gespawnt wurde, anstatt in einem stdio [MCP-Server](/de/mcp), den Claude Code gestartet hat, verwenden Sie stattdessen `CLAUDE_CODE_CHILD_SESSION` |

149| `CLAUDE_AFK_COUNTDOWN_MS` | {/* min-version: 2.1.198 */}Wie viele Millisekunden vor dem Auto-Fortfahren der Countdown auf dem Bildschirm auf einem unbeantworteten [`AskUserQuestion`](/de/tools-reference)-Dialog angezeigt wird. Standard `20000` (20 Sekunden), begrenzt durch das Auto-Fortfahren-Timeout. Hat keine Auswirkung, es sei denn, Auto-Fortfahren ist aktiviert; siehe die Einstellung [`askUserQuestionTimeout`](/de/settings#available-settings) und `CLAUDE_AFK_TIMEOUT_MS`. Erfordert Claude Code v2.1.198 oder später |

150| `CLAUDE_AFK_TIMEOUT_MS` | {/* min-version: 2.1.198 */}Wie viele Millisekunden Leerlaufzeit, bevor ein unbeantworteter [`AskUserQuestion`](/de/tools-reference)-Dialog automatisch fortfährt, ohne Sie. {/* min-version: 2.1.200 */}Auto-Fortfahren ist standardmäßig aus; melden Sie sich mit der Einstellung [`askUserQuestionTimeout`](/de/settings#available-settings) an. Diese Variable ist eine Überschreibung für Demos und automatisierte Tests: Wenn gesetzt, hat sie Vorrang vor dieser Einstellung und schaltet Auto-Fortfahren 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-Fortfahren standardmäßig mit einem `60000` (60 Sekunden)-Timeout aktiviert. Erfordert Claude Code v2.1.198 oder später |

148| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Setzen Sie auf `1`, um alle integrierten [Subagenten](/de/sub-agents)-Typen wie Explore und Plan zu deaktivieren. Gilt nur im nicht-interaktiven Modus (das Flag `-p`). Nützlich für SDK-Benutzer, die eine leere Grundlage wünschen |151| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Setzen Sie auf `1`, um alle integrierten [Subagenten](/de/sub-agents)-Typen wie Explore und Plan zu deaktivieren. Gilt nur im nicht-interaktiven Modus (das Flag `-p`). Nützlich für SDK-Benutzer, die eine leere Grundlage wünschen |

149| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Setzen Sie auf `1`, um das Präfix `mcp__<server>__` bei Tool-Namen von SDK-erstellten MCP-Servern zu überspringen. Tools verwenden ihre ursprünglichen Namen. Nur SDK-Verwendung |152| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Setzen Sie auf `1`, um das Präfix `mcp__<server>__` bei Tool-Namen von SDK-erstellten MCP-Servern zu überspringen. Tools verwenden ihre ursprünglichen Namen. Nur SDK-Verwendung |

150| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Stall-Timeout in Millisekunden für Hintergrund-Subagenten. Standard `600000` (10 Minuten). Der Timer wird bei jedem Streaming-Fortschrittsereignis zurückgesetzt; wenn kein Fortschritt innerhalb des Fensters ankommt, wird der Subagent abgebrochen und die Aufgabe als fehlgeschlagen markiert, wobei alle Teilergebnisse dem übergeordneten Element angezeigt werden |153| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Stall-Timeout in Millisekunden für Hintergrund-Subagenten. Standard `600000` (10 Minuten). Der Timer wird bei jedem Streaming-Fortschrittsereignis zurückgesetzt; wenn kein Fortschritt innerhalb des Fensters ankommt, wird der Subagent abgebrochen und die Aufgabe als fehlgeschlagen markiert, wobei alle Teilergebnisse dem übergeordneten Element angezeigt werden |


162| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Setzen Sie auf `0`, um den Attributionsblock (Client-Version und Prompt-Fingerabdruck) vom Anfang des System-Prompts wegzulassen. Das Deaktivieren verbessert die Prompt-Cache-Hit-Raten beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Anthropic API-Caching ist nicht betroffen |165| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Setzen Sie auf `0`, um den Attributionsblock (Client-Version und Prompt-Fingerabdruck) vom Anfang des System-Prompts wegzulassen. Das Deaktivieren verbessert die Prompt-Cache-Hit-Raten beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Anthropic API-Caching ist nicht betroffen |

163| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Legen Sie die Kontextkapazität in Token fest, die für Berechnungen der automatischen Komprimierung verwendet wird. Standardmäßig das Kontextfenster des Modells: 200K für Standard-Modelle oder 1M für [erweiterte Kontext](/de/model-config#extended-context)-Modelle, außer auf Sonnet 5, das seinen eigenen [Standard-Schwellenwert](/de/model-config#sonnet-5-context-window) hat. Verwenden Sie einen niedrigeren Wert wie `500000` auf einem 1M-Modell, um das Fenster für Komprimierungszwecke als 500K zu behandeln. Der Wert ist auf das tatsächliche Kontextfenster des Modells begrenzt. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` wird als Prozentsatz dieses Wertes angewendet. Das Setzen dieser Variablen entkoppelt den Komprimierungsschwellenwert von der `used_percentage` der Statuszeile, die immer das vollständige Kontextfenster des Modells verwendet |166| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Legen Sie die Kontextkapazität in Token fest, die für Berechnungen der automatischen Komprimierung verwendet wird. Standardmäßig das Kontextfenster des Modells: 200K für Standard-Modelle oder 1M für [erweiterte Kontext](/de/model-config#extended-context)-Modelle, außer auf Sonnet 5, das seinen eigenen [Standard-Schwellenwert](/de/model-config#sonnet-5-context-window) hat. Verwenden Sie einen niedrigeren Wert wie `500000` auf einem 1M-Modell, um das Fenster für Komprimierungszwecke als 500K zu behandeln. Der Wert ist auf das tatsächliche Kontextfenster des Modells begrenzt. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` wird als Prozentsatz dieses Wertes angewendet. Das Setzen dieser Variablen entkoppelt den Komprimierungsschwellenwert von der `used_percentage` der Statuszeile, die immer das vollständige Kontextfenster des Modells verwendet |

164| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Überschreiben Sie die automatische [IDE-Verbindung](/de/vs-code). Standardmäßig verbindet sich Claude Code automatisch, wenn es im 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, z. B. wenn tmux das übergeordnete Terminal verdeckt. Hat Vorrang vor der Einstellung [`autoConnectIde`](/de/settings#global-config-settings) |167| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Überschreiben Sie die automatische [IDE-Verbindung](/de/vs-code). Standardmäßig verbindet sich Claude Code automatisch, wenn es im 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, z. B. wenn tmux das übergeordnete Terminal verdeckt. Hat Vorrang vor der Einstellung [`autoConnectIde`](/de/settings#global-config-settings) |

168| `CLAUDE_CODE_BRIDGE_SESSION_ID` | {/* min-version: 2.1.199 */}Wird automatisch in Bash-Tool- und [Hook-Befehls](/de/hooks)-Subprozessen gesetzt, während die Sitzung eine aktive [Remote Control](/de/remote-control)-Verbindung hat, und entfernt, wenn die Verbindung endet. Der Wert ist die Sitzungs-ID in `session_`-Form, der gleiche Bezeichner, der in der `claude.ai/code`-URL der Sitzung angezeigt wird, sodass ein Skript zurück zur Sitzung, die es ausgeführt hat, verlinken kann. Erfordert Claude Code v2.1.199 oder später. Lesen Sie in [Cloud-Sitzungen](/de/claude-code-on-the-web) stattdessen `CLAUDE_CODE_REMOTE_SESSION_ID` |

165| `CLAUDE_CODE_CERT_STORE` | Kommagetrennte Liste von CA-Zertifikatquellen für TLS-Verbindungen. `bundled` ist der Mozilla CA-Satz, der mit Claude Code ausgeliefert wird. `system` ist der Betriebssystem-Vertrauensspeicher, schreibgeschützt auf Runtimes mit `tls.getCACertificates`: die native Binärdatei oder Node 22.15 oder später für npm-Installationen. Siehe [CA-Zertifikatsspeicher](/de/network-config#ca-certificate-store). Standard ist `bundled,system` |169| `CLAUDE_CODE_CERT_STORE` | Kommagetrennte Liste von CA-Zertifikatquellen für TLS-Verbindungen. `bundled` ist der Mozilla CA-Satz, der mit Claude Code ausgeliefert wird. `system` ist der Betriebssystem-Vertrauensspeicher, schreibgeschützt auf Runtimes mit `tls.getCACertificates`: die native Binärdatei oder Node 22.15 oder später für npm-Installationen. Siehe [CA-Zertifikatsspeicher](/de/network-config#ca-certificate-store). Standard ist `bundled,system` |

166| `CLAUDE_CODE_CHILD_SESSION` | {/* min-version: 2.1.172 */}Auf `1` in Subprozessen gesetzt, die Claude Code über die Bash-, PowerShell- und Monitor-Tools, [Hook](/de/hooks)-Befehle und [Statuszeilen](/de/statusline)-Befehle spawnt. Nicht gesetzt für stdio [MCP-Server](/de/mcp)-Subprozesse, die langlebig sind und die Sitzung, die sie gespawnt hat, überdauern. Im Gegensatz zu `CLAUDECODE` wird dies nur von Claude Codes eigenem Spawn-Pfad gesetzt 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 weiterhin bestehen. Setzen Sie `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, um diese Ausschließung zu überschreiben. Erfordert Claude Code v2.1.172 oder später |170| `CLAUDE_CODE_CHILD_SESSION` | {/* min-version: 2.1.172 */}Auf `1` in Subprozessen gesetzt, die Claude Code über die Bash-, PowerShell- und Monitor-Tools, [Hook](/de/hooks)-Befehle und [Statuszeilen](/de/statusline)-Befehle spawnt. Nicht gesetzt für stdio [MCP-Server](/de/mcp)-Subprozesse, die langlebig sind und die Sitzung, die sie gespawnt hat, überdauern. Im Gegensatz zu `CLAUDECODE` wird dies nur von Claude Codes eigenem Spawn-Pfad gesetzt 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 weiterhin bestehen. Setzen Sie `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, um diese Ausschließung zu überschreiben. Erfordert Claude Code v2.1.172 oder später |

167| `CLAUDE_CODE_CLIENT_CERT` | Pfad zur Client-Zertifikatsdatei für mTLS-Authentifizierung |171| `CLAUDE_CODE_CLIENT_CERT` | Pfad zur Client-Zertifikatsdatei für mTLS-Authentifizierung |


179| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Setzen Sie auf `1`, um die Verarbeitung von Anhängen zu deaktivieren. Dateierweiterungen mit `@`-Syntax werden als Klartext gesendet, anstatt in Dateiinhalte erweitert zu werden |183| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Setzen Sie auf `1`, um die Verarbeitung von Anhängen zu deaktivieren. Dateierweiterungen mit `@`-Syntax werden als Klartext gesendet, anstatt in Dateiinhalte erweitert zu werden |

180| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Setzen Sie auf `1`, um [automatisches Speichern](/de/memory#auto-memory) zu deaktivieren. Setzen Sie auf `0`, um automatisches Speichern zu erzwingen, auch wenn `--bare`-Modus oder [`autoMemoryEnabled: false`](/de/settings#available-settings) es ansonsten deaktivieren würde. Wenn deaktiviert, erstellt oder lädt Claude keine automatischen Speicherdateien |184| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Setzen Sie auf `1`, um [automatisches Speichern](/de/memory#auto-memory) zu deaktivieren. Setzen Sie auf `0`, um automatisches Speichern zu erzwingen, auch wenn `--bare`-Modus oder [`autoMemoryEnabled: false`](/de/settings#available-settings) es ansonsten deaktivieren würde. Wenn deaktiviert, erstellt oder lädt Claude keine automatischen Speicherdateien |

181| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie auf `1`, um alle Hintergrundaufgaben-Funktionalität zu deaktivieren, einschließlich des Parameters `run_in_background` auf Bash- und Subagenten-Tools, automatisches Hintergrund-Ausführen und die Strg+B-Verknüpfung |185| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie auf `1`, um alle Hintergrundaufgaben-Funktionalität zu deaktivieren, einschließlich des Parameters `run_in_background` auf Bash- und Subagenten-Tools, automatisches Hintergrund-Ausführen und die Strg+B-Verknüpfung |

182| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}Setzen Sie auf `1`, um in-flight Hintergrundarbeit zu stoppen, anstatt sie zu übernehmen, wenn Sie eine [Hintergrund-Sitzung](/de/agent-view) durch Drücken von `←` oder mit [`/background`](/de/agent-view#from-inside-a-session) in den Hintergrund verschieben. Claude Code fragt Sie zur Bestätigung auf, bevor Sie in den Hintergrund verschieben, und stoppt dann die Aufgaben, die ansonsten übernommen würden. Betrifft nur diese Übergabe: Das Verschieben einer Sitzung mit `←` oder [`/background`](/de/agent-view#from-inside-a-session) trägt weiterhin in-flight-Arbeit über, und `CLAUDE_DISABLE_ADOPT` schaltet beide aus. Erfordert Claude Code v2.1.196 oder später |186| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}Setzen Sie auf `1`, um in-flight Hintergrundarbeit zu stoppen, anstatt sie zu übernehmen, wenn der [Supervisor](/de/agent-view#the-supervisor-process) eine [Hintergrund-Sitzung](/de/agent-view) stoppt, neu startet oder den Prozess dieser Sitzung aktualisiert, anstatt sie an den nächsten Prozess der Sitzung zu übergeben. Betrifft nur diese Übergabe: Das Verschieben einer Sitzung mit `←` oder [`/background`](/de/agent-view#from-inside-a-session) trägt weiterhin in-flight-Arbeit über, und `CLAUDE_DISABLE_ADOPT` schaltet beide aus. Erfordert Claude Code v2.1.196 oder später |

183| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}Setzen Sie auf `1`, um Claude Code davon abzuhalten, [Hintergrund-Shell-Befehle](/de/interactive-mode#background-bash-commands) zu beenden, wenn das Betriebssystem Speicherdruck meldet. Standardmäßig beendet Claude Code auf macOS und Linux eine im Hauptsitzung gestartete Hintergrund-Shell bei einem Speicherdruck-Signal, sobald die Sitzung 30 Minuten untätig war und kein Turn oder Subagent ausgeführt wird. Windows hat kein Speicherdruck-Signal, daher hat diese Variable dort keine Auswirkung. Erfordert Claude Code v2.1.193 oder später |187| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}Setzen Sie auf `1`, um Claude Code davon abzuhalten, [Hintergrund-Shell-Befehle](/de/interactive-mode#background-bash-commands) zu beenden, wenn das Betriebssystem Speicherdruck meldet. Standardmäßig beendet Claude Code auf macOS und Linux eine im Hauptsitzung gestartete Hintergrund-Shell bei einem Speicherdruck-Signal, sobald die Sitzung 30 Minuten untätig war und kein Turn oder Subagent ausgeführt wird. Windows hat kein Speicherdruck-Signal, daher hat diese Variable dort keine Auswirkung. Erfordert Claude Code v2.1.193 oder später |

184| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Setzen Sie auf `1`, um die [Skills](/de/skills) und Workflows zu deaktivieren, die mit Claude Code ausgeliefert werden: Gebündelte Skills und Workflows werden vollständig entfernt, während integrierte Slash-Befehle wie `/init` tippbar bleiben, aber vom Modell ausgeblendet werden. Skills von Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Äquivalent zur Einstellung [`disableBundledSkills`](/de/settings#available-settings); `0` überschreibt sie nicht |188| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Setzen Sie auf `1`, um die [Skills](/de/skills) und Workflows zu deaktivieren, die mit Claude Code ausgeliefert werden: Gebündelte Skills und Workflows werden vollständig entfernt, während integrierte Slash-Befehle wie `/init` tippbar bleiben, aber vom Modell ausgeblendet werden. Skills von Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Äquivalent zur Einstellung [`disableBundledSkills`](/de/settings#available-settings); `0` überschreibt sie nicht |

185| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Setzen Sie auf `1`, um das Laden von CLAUDE.md-Speicherdateien in den Kontext zu verhindern, einschließlich Benutzer-, Projekt- und automatischen Speicherdateien |189| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Setzen Sie auf `1`, um das Laden von CLAUDE.md-Speicherdateien in den Kontext zu verhindern, einschließlich Benutzer-, Projekt- und automatischen Speicherdateien |

186| `CLAUDE_CODE_DISABLE_CRON` | Setzen Sie auf `1`, um [geplante Aufgaben](/de/scheduled-tasks) zu deaktivieren. Der `/loop`-Skill und Cron-Tools werden nicht verfügbar und alle bereits geplanten Aufgaben werden nicht mehr ausgelöst, einschließlich Aufgaben, die bereits während der Sitzung ausgeführt werden |190| `CLAUDE_CODE_DISABLE_CRON` | Setzen Sie auf `1`, um [geplante Aufgaben](/de/scheduled-tasks) zu deaktivieren. Der `/loop`-Skill und Cron-Tools werden nicht verfügbar und alle bereits geplanten Aufgaben werden nicht mehr ausgelöst, einschließlich Aufgaben, die bereits während der Sitzung ausgeführt werden |

187| `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 |191| `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 |

192| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | {/* min-version: 2.1.198 */}Setzen Sie auf `1`, um die integrierten [Explore und Plan Subagenten](/de/sub-agents#built-in-subagents) zu deaktivieren. Claude erkundet mit seinen Such-Tools oder dem allgemeinen Subagenten, und [Plan-Modus](/de/permission-modes#analyze-before-you-edit-with-plan-mode) liest Dateien direkt, anstatt Explore und Plan Agenten zu starten. Benutzerdefinierte Subagenten mit dem Namen `Explore` oder `Plan` sind nicht betroffen. Um jeden integrierten Subagenten-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 |

188| `CLAUDE_CODE_DISABLE_FAST_MODE` | Setzen Sie auf `1`, um [Schnellmodus](/de/fast-mode) zu deaktivieren |193| `CLAUDE_CODE_DISABLE_FAST_MODE` | Setzen Sie auf `1`, um [Schnellmodus](/de/fast-mode) zu deaktivieren |

189| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Setzen Sie auf `1`, um die Umfragen zur Sitzungsqualität „Wie läuft es mit Claude?" zu deaktivieren. Umfragen werden 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 Stichprobenquote festzulegen, verwenden Sie die Einstellung [`feedbackSurveyRate`](/de/settings#available-settings). Siehe [Umfragen zur Sitzungsqualität](/de/data-usage#session-quality-surveys) |194| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Setzen Sie auf `1`, um die Umfragen zur Sitzungsqualität „Wie läuft es mit Claude?" zu deaktivieren. Umfragen werden 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 Stichprobenquote festzulegen, verwenden Sie die Einstellung [`feedbackSurveyRate`](/de/settings#available-settings). Siehe [Umfragen zur Sitzungsqualität](/de/data-usage#session-quality-surveys) |

190| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Setzen Sie auf `1`, um Datei-[Checkpointing](/de/checkpointing) zu deaktivieren. Der `/rewind`-Befehl kann keine Code-Änderungen wiederherstellen |195| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Setzen Sie auf `1`, um Datei-[Checkpointing](/de/checkpointing) zu deaktivieren. Der `/rewind`-Befehl kann keine Code-Änderungen wiederherstellen |

191| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Setzen Sie auf `1`, um integrierte Commit- und PR-Workflow-Anweisungen und den Git-Status-Snapshot aus Claudes System-Prompt zu entfernen. Nützlich bei Verwendung eigener Git-Workflow-Skills. Hat Vorrang vor der Einstellung [`includeGitInstructions`](/de/settings#available-settings), wenn gesetzt |196| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Setzen Sie auf `1`, um integrierte Commit- und PR-Workflow-Anweisungen und den Git-Status-Snapshot aus Claudes System-Prompt zu entfernen. Nützlich bei Verwendung eigener Git-Workflow-Skills. Hat Vorrang vor der Einstellung [`includeGitInstructions`](/de/settings#available-settings), wenn gesetzt |

192| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Setzen Sie auf `1`, um die automatische Umleitung 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 fixieren möchten. Die Umleitung wird nicht auf Bedrock, Vertex oder Foundry ausgeführt |197| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Setzen Sie auf `1`, um die automatische Umleitung 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 fixieren möchten. Die Umleitung wird nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry ausgeführt |

193| `CLAUDE_CODE_DISABLE_MOUSE` | Setzen Sie auf `1`, um die Mausverfolgung in der [Vollbilddarstellung](/de/fullscreen) zu deaktivieren. Tastaturscrolling mit `PgUp` und `PgDn` funktioniert weiterhin. Verwenden Sie dies, um das native Kopieren-beim-Auswählen-Verhalten Ihres Terminals beizubehalten |198| `CLAUDE_CODE_DISABLE_MOUSE` | Setzen Sie auf `1`, um die Mausverfolgung in der [Vollbilddarstellung](/de/fullscreen) zu deaktivieren. Tastaturscrolling mit `PgUp` und `PgDn` funktioniert weiterhin. Verwenden Sie dies, um das native Kopieren-beim-Auswählen-Verhalten Ihres Terminals beizubehalten |

194| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | {/* min-version: 2.1.195 */}Setzen Sie auf `1`, um Click-, Drag- und Hover-Handling in der [Vollbilddarstellung](/de/fullscreen) zu deaktivieren, während Sie das Mausrad-Scrolling behalten. Verwenden Sie dies, wenn Sie möchten, dass das Rad-Scroll in Claude Code funktioniert, aber Sie 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 |199| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | {/* min-version: 2.1.195 */}Setzen Sie auf `1`, um Click-, Drag- und Hover-Handling in der [Vollbilddarstellung](/de/fullscreen) zu deaktivieren, während Sie das Mausrad-Scrolling behalten. Verwenden Sie dies, wenn Sie möchten, dass das Rad-Scroll in Claude Code funktioniert, aber Sie 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 |

195| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Äquivalent zum Setzen von `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` und `DISABLE_TELEMETRY` |200| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Äquivalent zum Setzen von `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` und `DISABLE_TELEMETRY` |


202| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Setzen Sie auf `1`, um virtuelles Scrollen in der [Vollbilddarstellung](/de/fullscreen) zu deaktivieren und jede Nachricht im Transkript zu rendern. Verwenden Sie dies, wenn das Scrollen im Vollbildmodus leere Bereiche anzeigt, in denen Nachrichten erscheinen sollten |207| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Setzen Sie auf `1`, um virtuelles Scrollen in der [Vollbilddarstellung](/de/fullscreen) zu deaktivieren und jede Nachricht im Transkript zu rendern. Verwenden Sie dies, wenn das Scrollen im Vollbildmodus leere Bereiche anzeigt, in denen Nachrichten erscheinen sollten |

203| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Setzen Sie auf `1`, um [Workflows](/de/workflows#turn-workflows-off) zu deaktivieren. Äquivalent zur Einstellung [`disableWorkflows`](/de/settings#available-settings) |208| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Setzen Sie auf `1`, um [Workflows](/de/workflows#turn-workflows-off) zu deaktivieren. Äquivalent zur Einstellung [`disableWorkflows`](/de/settings#available-settings) |

204| `CLAUDE_CODE_EFFORT_LEVEL` | Legen Sie die Anstrengungsstufe für unterstützte Modelle fest. Werte: `low`, `medium`, `high`, `xhigh`, `max` oder `auto` für den Modellstandard. Verfügbare Stufen hängen vom Modell ab. Hat Vorrang vor `/effort` und der `effortLevel`-Einstellung. Siehe [Anstrengungsstufe anpassen](/de/model-config#adjust-effort-level) |209| `CLAUDE_CODE_EFFORT_LEVEL` | Legen Sie die Anstrengungsstufe für unterstützte Modelle fest. Werte: `low`, `medium`, `high`, `xhigh`, `max` oder `auto` für den Modellstandard. Verfügbare Stufen hängen vom Modell ab. Hat Vorrang vor `/effort` und der `effortLevel`-Einstellung. Siehe [Anstrengungsstufe anpassen](/de/model-config#adjust-effort-level) |

205| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.158 */}Setzen Sie auf `1`, um [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) auf Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry und angemeldete [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzungen verfügbar zu machen. Erfordert Claude Code v2.1.158 oder später. Hat keine Auswirkung auf die Anthropic API, wo Auto-Modus standardmäßig verfügbar ist. Siehe [Auto-Modus auf Bedrock, Vertex AI oder Foundry aktivieren](/de/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry) |210| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | {/* min-version: 2.1.205 */}Setzen Sie auf `1`, um das Anhängen von zusätzlichem Text an das Ende des System-Prompts jedes [Subagenten](/de/sub-agents) zu aktivieren. Das Flag [`--append-subagent-system-prompt`](/de/cli-reference#cli-flags) liefert den angehängten Text und setzt diese Variable automatisch, daher müssen Sie sie nicht selbst setzen. Erfordert Claude Code v2.1.205 oder später |

211| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.158 */}Setzen Sie auf `1`, um [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldete [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzungen verfügbar zu machen. Erfordert Claude Code v2.1.158 oder später. Hat keine Auswirkung auf die Anthropic API, wo Auto-Modus standardmäßig verfügbar ist. Siehe [Auto-Modus auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry aktivieren](/de/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) |

206| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Überschreiben Sie die Verfügbarkeit von [Sitzungs-Zusammenfassung](/de/interactive-mode#session-recap). Setzen Sie auf `0`, um Zusammenfassungen unabhängig vom `/config`-Umschalter auszuschalten. Setzen Sie auf `1`, um Zusammenfassungen zu erzwingen, wenn [`awaySummaryEnabled`](/de/settings#available-settings) `false` ist. Hat Vorrang vor der Einstellung und dem `/config`-Umschalter |212| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Überschreiben Sie die Verfügbarkeit von [Sitzungs-Zusammenfassung](/de/interactive-mode#session-recap). Setzen Sie auf `0`, um Zusammenfassungen unabhängig vom `/config`-Umschalter auszuschalten. Setzen Sie auf `1`, um Zusammenfassungen zu erzwingen, wenn [`awaySummaryEnabled`](/de/settings#available-settings) `false` ist. Hat Vorrang vor der Einstellung und dem `/config`-Umschalter |

207| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Setzen Sie auf `1`, um den Plugin-Status an Turn-Grenzen im [nicht-interaktiven Modus](/de/headless) zu aktualisieren, nachdem eine Hintergrund-Installation abgeschlossen ist. Standardmäßig aus, da die Aktualisierung den System-Prompt mitten in der Sitzung ändert, was [Prompt-Caching](/de/prompt-caching) für diesen Turn ungültig macht |213| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Setzen Sie auf `1`, um den Plugin-Status an Turn-Grenzen im [nicht-interaktiven Modus](/de/headless) zu aktualisieren, nachdem eine Hintergrund-Installation abgeschlossen ist. Standardmäßig aus, da die Aktualisierung den System-Prompt mitten in der Sitzung ändert, was [Prompt-Caching](/de/prompt-caching) für diesen Turn ungültig macht |

208| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Setzen Sie auf `1`, um die Umfrage zur Sitzungsqualität „Wie läuft es mit Claude?" an Ihren eigenen [OpenTelemetry-Collector](/de/monitoring-usage) zu leiten, wenn Anthropic-gebundener nicht wesentlicher Traffic blockiert wird. Umfragebewertungen werden nur als OTEL-Ereignisse an Ihren konfigurierten Collector ausgegeben. Keine Umfragedaten werden in diesem Modus an Anthropic gesendet. Gilt, wenn `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist, und hat ansonsten keine Auswirkung. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` und die Produktfeedback-Richtlinie der Organisation haben Vorrang |214| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Setzen Sie auf `1`, um die Umfrage zur Sitzungsqualität „Wie läuft es mit Claude?" an Ihren eigenen [OpenTelemetry-Collector](/de/monitoring-usage) zu leiten, wenn Anthropic-gebundener nicht wesentlicher Traffic blockiert wird. Umfragebewertungen werden nur als OTEL-Ereignisse an Ihren konfigurierten Collector ausgegeben. Keine Umfragedaten werden in diesem Modus an Anthropic gesendet. Gilt, wenn `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist, und hat ansonsten keine Auswirkung. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` und die Produktfeedback-Richtlinie der Organisation haben Vorrang |

209| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Steuert, ob Tool-Call-Eingaben von der API streamen, während Claude sie generiert. Wenn dies aus ist, kommt eine große Tool-Eingabe wie ein langer Datei-Schreibvorgang erst an, nachdem Claude die Generierung abgeschlossen hat, was aussehen kann, als würde es hängen. Standardmäßig für direkte Anthropic API-Verbindungen aktiviert. Auf Bedrock und Vertex, aktiviert pro Modell, wo der bereitgestellte Container es unterstützt. Setzen Sie auf `0`, um sich abzumelden. 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 aus auf Foundry und [Gateway](/de/llm-gateway)-Verbindungen |215| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Steuert, ob Tool-Call-Eingaben von der API streamen, während Claude sie generiert. Wenn dies aus ist, kommt eine große Tool-Eingabe wie ein langer Datei-Schreibvorgang erst an, nachdem Claude die Generierung abgeschlossen hat, was aussehen kann, als würde es hängen. Standardmäßig für direkte Anthropic API-Verbindungen aktiviert. Auf Amazon Bedrock und Google Cloud's Agent Platform, aktiviert pro Modell, wo der bereitgestellte Container es unterstützt. Setzen Sie auf `0`, um sich abzumelden. 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 aus auf Microsoft Foundry und [Gateway](/de/llm-gateway)-Verbindungen |

210| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Setzen Sie auf `1`, um die `/model`-Auswahl aus dem `/v1/models`-Endpunkt Ihres Gateways zu füllen, wenn `ANTHROPIC_BASE_URL` auf ein Anthropic-kompatibles Gateway wie LiteLLM, Kong oder einen internen Proxy verweist. Standardmäßig aus, da Gateways, die von einem gemeinsamen API-Schlüssel unterstützt werden, ansonsten jedem Benutzer jedes Modell anzeigen würden, auf das der Schlüssel zugreifen kann. Erkannte Modelle werden weiterhin durch die [`availableModels`](/de/settings#available-settings)-Zulassungsliste gefiltert, die die Sitzung erhält; liefern Sie die Liste über [MDM oder eine verwaltete Einstellungsdatei](/de/settings#settings-files), da [Server-verwaltete Bereitstellung auf Gateway-Konfigurationen nicht verfügbar ist](/de/server-managed-settings#platform-availability) |216| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Setzen Sie auf `1`, um die `/model`-Auswahl aus dem `/v1/models`-Endpunkt Ihres Gateways zu füllen, wenn `ANTHROPIC_BASE_URL` auf ein Anthropic-kompatibles Gateway wie LiteLLM, Kong oder einen internen Proxy verweist. Standardmäßig aus, da Gateways, die von einem gemeinsamen API-Schlüssel unterstützt werden, ansonsten jedem Benutzer jedes Modell anzeigen würden, auf das der Schlüssel zugreifen kann. Erkannte Modelle werden weiterhin durch die [`availableModels`](/de/settings#available-settings)-Zulassungsliste gefiltert, die die Sitzung erhält; liefern Sie die Liste über [MDM oder eine verwaltete Einstellungsdatei](/de/settings#settings-files), da [Server-verwaltete Bereitstellung auf Gateway-Konfigurationen nicht verfügbar ist](/de/server-managed-settings#platform-availability) |

211| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Entfernt in v2.1.142, wenn der [Schnellmodus](/de/fast-mode) standardmäßig von Opus 4.6 zu Opus 4.7 wechselte |217| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Entfernt in v2.1.142, wenn der [Schnellmodus](/de/fast-mode) standardmäßig von Opus 4.6 zu Opus 4.7 wechselte |

212| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Setzen Sie auf `false`, um Prompt-Vorschläge zu deaktivieren (der Umschalter „Prompt-Vorschläge" in `/config`). Dies sind die ausgegraut angezeigten Vorhersagen, die in Ihrer Prompt-Eingabe nach Claudes Antwort erscheinen. Siehe [Prompt-Vorschläge](/de/interactive-mode#prompt-suggestions) |218| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Setzen Sie auf `false`, um Prompt-Vorschläge zu deaktivieren (der Umschalter „Prompt-Vorschläge" in `/config`). Dies sind die ausgegraut angezeigten Vorhersagen, die in Ihrer Prompt-Eingabe nach Claudes Antwort erscheinen. Siehe [Prompt-Vorschläge](/de/interactive-mode#prompt-suggestions) |


230| `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 die automatische Verbindung Ihre IDE nicht findet, obwohl sie ausgeführt wird |236| `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 die automatische Verbindung Ihre IDE nicht findet, obwohl sie ausgeführt wird |

231| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Überschreiben Sie die Kontextfenstergröße, die Claude Code für das aktive Modell annimmt. {/* min-version: 2.1.193 */}Ab v2.1.193 direkt angewendet für Modellnamen, die Claude Code nicht als Claude-Modell erkennt; für erkannte Claude-Modelle wirkt sich dies nur aus, wenn `DISABLE_COMPACT` auch gesetzt ist. Verwenden Sie dies, wenn Sie zu einem Modell durch `ANTHROPIC_BASE_URL` routen, dessen Kontextfenster nicht der integrierten Größe für seinen Namen entspricht |237| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Überschreiben Sie die Kontextfenstergröße, die Claude Code für das aktive Modell annimmt. {/* min-version: 2.1.193 */}Ab v2.1.193 direkt angewendet für Modellnamen, die Claude Code nicht als Claude-Modell erkennt; für erkannte Claude-Modelle wirkt sich dies nur aus, wenn `DISABLE_COMPACT` auch gesetzt ist. Verwenden Sie dies, wenn Sie zu einem Modell durch `ANTHROPIC_BASE_URL` routen, dessen Kontextfenster nicht der integrierten Größe für seinen Namen entspricht |

232| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Legen Sie die maximale Anzahl von Ausgabe-Token für die meisten Anfragen fest. Standard und Obergrenzen variieren je nach Modell; siehe [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Das Erhöhen dieses Wertes reduziert das verfügbare effektive Kontextfenster, bevor die [automatische Komprimierung](/de/costs#reduce-token-usage) ausgelöst wird |238| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Legen Sie die maximale Anzahl von Ausgabe-Token für die meisten Anfragen fest. Standard und Obergrenzen variieren je nach Modell; siehe [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Das Erhöhen dieses Wertes reduziert das verfügbare effektive Kontextfenster, bevor die [automatische Komprimierung](/de/costs#reduce-token-usage) ausgelöst wird |

233| `CLAUDE_CODE_MAX_RETRIES` | Überschreiben Sie die Anzahl der Wiederholungen fehlgeschlagener API-Anfragen (Standard: 10). {/* min-version: 2.1.186 */}Begrenzt auf 15 ab v2.1.186. Für unbeaufsichtigte Sitzungen, die längere Ausfallzeiten abwarten müssen, setzen Sie stattdessen `CLAUDE_CODE_RETRY_WATCHDOG` |239| `CLAUDE_CODE_MAX_RETRIES` | Überschreiben Sie die Anzahl der Wiederholungen fehlgeschlagener API-Anfragen (Standard: 10). {/* min-version: 2.1.186 */}Begrenzt auf 15 ab v2.1.186; {/* min-version: 2.1.199 */}ab v2.1.199 hebt `CLAUDE_CODE_RETRY_WATCHDOG` die Standardanzahl an und entfernt die Obergrenze. Für unbeaufsichtigte Sitzungen, die längere Ausfallzeiten abwarten müssen, setzen Sie stattdessen `CLAUDE_CODE_RETRY_WATCHDOG` |

234| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Maximale Anzahl von schreibgeschützten Tools und Subagenten, die parallel ausgeführt werden können (Standard: 10). Höhere Werte erhöhen die Parallelität, verbrauchen aber mehr Ressourcen |240| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Maximale Anzahl von schreibgeschützten Tools und Subagenten, die parallel ausgeführt werden können (Standard: 10). Höhere Werte erhöhen die Parallelität, verbrauchen aber mehr Ressourcen |

235| `CLAUDE_CODE_MAX_TURNS` | Begrenzen Sie die Anzahl der agentic Turns, wenn kein explizites Limit übergeben wird. Äquivalent zum Übergeben von [`--max-turns`](/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 kein Limit behandelt zu werden |241| `CLAUDE_CODE_MAX_TURNS` | Begrenzen Sie die Anzahl der agentic Turns, wenn kein explizites Limit übergeben wird. Äquivalent zum Übergeben von [`--max-turns`](/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 kein Limit behandelt zu werden |

236| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Setzen Sie auf `1`, um stdio MCP-Server nur mit einer sicheren Baseline-Umgebung plus der konfigurierten `env` des Servers zu spawnen, anstatt Ihre Shell-Umgebung zu erben |242| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Setzen Sie auf `1`, um stdio MCP-Server nur mit einer sicheren Baseline-Umgebung plus der konfigurierten `env` des Servers zu spawnen, anstatt Ihre Shell-Umgebung zu erben |

237| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}Idle-Timeout in Millisekunden für Remote-MCP-Tool-Aufrufe (Standard: 300000 oder 5 Minuten). Wenn ein HTTP-, SSE-, WebSocket- oder [claude.ai-Connector](/de/mcp#use-mcp-servers-from-claude-ai) MCP-Server für diese lange keine Antwort und keine Fortschrittsbenachrichtigung sendet, bricht der Tool-Aufruf mit einem Fehler ab, anstatt auf das Wall-Clock-`MCP_TOOL_TIMEOUT` zu warten. Setzen Sie auf `0`, um die Idle-Überprüfung zu deaktivieren. Werte unter 1000 werden auf eine Sekunde erhöht, und der Wert ist auf das effektive `MCP_TOOL_TIMEOUT` begrenzt. Gilt nicht für stdio- oder IDE-Server. Erfordert Claude Code v2.1.187 oder später |243| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}Idle-Timeout in Millisekunden für MCP-Tool-Aufrufe. Wenn ein stdio-, HTTP-, SSE-, WebSocket- oder [claude.ai-Connector](/de/mcp#use-mcp-servers-from-claude-ai) MCP-Server für diese lange keine Antwort und keine Fortschrittsbenachrichtigung 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-Überprü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. {/* min-version: 2.1.203 */}Vor v2.1.203 waren stdio-Server vom Idle-Timeout ausgenommen |

238| `CLAUDE_CODE_NATIVE_CURSOR` | Setzen Sie auf `1`, um den eigenen Cursor des Terminals an der Eingabeeinfügemarke anzuzeigen, anstatt eines gezeichneten Blocks. Der Cursor respektiert die Blink-, Form- und Fokuseinstellungen des Terminals |244| `CLAUDE_CODE_NATIVE_CURSOR` | Setzen Sie auf `1`, um den eigenen Cursor des Terminals an der Eingabeeinfügemarke anzuzeigen, anstatt eines gezeichneten Blocks. Der Cursor respektiert die Blink-, Form- und Fokuseinstellungen des Terminals |

239| `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 Aufforderung |245| `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 Aufforderung |

240| `CLAUDE_CODE_NO_FLICKER` | Setzen Sie auf `1`, um die [Vollbilddarstellung](/de/fullscreen) zu aktivieren, eine Forschungsvorschau, die Flimmern reduziert und den Speicher in langen Konversationen flach hält. Äquivalent zur [`tui`](/de/settings#available-settings)-Einstellung; Sie können auch mit `/tui fullscreen` wechseln |246| `CLAUDE_CODE_NO_FLICKER` | Setzen Sie auf `1`, um die [Vollbilddarstellung](/de/fullscreen) zu aktivieren, eine Forschungsvorschau, die Flimmern reduziert und den Speicher in langen Konversationen flach hält. Äquivalent zur [`tui`](/de/settings#available-settings)-Einstellung; Sie können auch mit `/tui fullscreen` wechseln |


256| `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 Statuszeilen-Befehle zu übergeben, und respektieren Sie stattdessen die effektive Ausführungsrichtlinie des Computers. Standardmäßig umgeht Claude Code die Ausführungsrichtlinie im Prozessbereich, sodass `.ps1`-Skripte und Modul-Importe auf Standard-Restricted Windows-Installationen funktionieren. Prozessbereich-Bypass überschreibt niemals Group Policy `MachinePolicy` oder `UserPolicy`, unabhängig von dieser Einstellung |262| `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 Statuszeilen-Befehle zu übergeben, und respektieren Sie stattdessen die effektive Ausführungsrichtlinie des Computers. Standardmäßig umgeht Claude Code die Ausführungsrichtlinie im Prozessbereich, sodass `.ps1`-Skripte und Modul-Importe auf Standard-Restricted Windows-Installationen funktionieren. Prozessbereich-Bypass überschreibt niemals Group Policy `MachinePolicy` oder `UserPolicy`, unabhängig von dieser Einstellung |

257| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}Maximale Zeit in Millisekunden, die der [nicht-interaktive Modus](/de/headless#background-tasks-at-exit) mit dem Flag `-p` nach dem letzten Turn auf Hintergrund-Subagenten und Workflows wartet, deren Ergebnis Teil der Ausgabe ist. Standard: `600000` oder 10 Minuten. Wenn die Obergrenze überschritten wird, werden verbleibende Hintergrundaufgaben beendet und der Prozess beendet. Setzen Sie auf `0`, um unbegrenzt zu warten. Diese Obergrenze ist separat von der fünfsekündigen Kulanzfrist, die für einfache Hintergrund-Shells gilt |263| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}Maximale Zeit in Millisekunden, die der [nicht-interaktive Modus](/de/headless#background-tasks-at-exit) mit dem Flag `-p` nach dem letzten Turn auf Hintergrund-Subagenten und Workflows wartet, deren Ergebnis Teil der Ausgabe ist. Standard: `600000` oder 10 Minuten. Wenn die Obergrenze überschritten wird, werden verbleibende Hintergrundaufgaben beendet und der Prozess beendet. Setzen Sie auf `0`, um unbegrenzt zu warten. Diese Obergrenze ist separat von der fünfsekündigen Kulanzfrist, die für einfache Hintergrund-Shells gilt |

258| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Setzen Sie auf `1`, um W3C-Trace-Kontext zu propagieren, wenn `ANTHROPIC_BASE_URL` auf einen benutzerdefinierten Proxy verweist. Die Propagation umfasst den `traceparent`-Header auf Modell- und HTTP-MCP-Anfragen sowie die `TRACEPARENT`-Umgebungsvariable für Bash-, PowerShell- und Hook-Subprozesse. Standardmäßig ist die Propagation nur bei direkter Verbindung zur Anthropic API aktiviert. Hinzugefügt in v2.1.152. Siehe [Traces (Beta)](/de/monitoring-usage#traces-beta) |264| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Setzen Sie auf `1`, um W3C-Trace-Kontext zu propagieren, wenn `ANTHROPIC_BASE_URL` auf einen benutzerdefinierten Proxy verweist. Die Propagation umfasst den `traceparent`-Header auf Modell- und HTTP-MCP-Anfragen sowie die `TRACEPARENT`-Umgebungsvariable für Bash-, PowerShell- und Hook-Subprozesse. Standardmäßig ist die Propagation nur bei direkter Verbindung zur Anthropic API aktiviert. Hinzugefügt in v2.1.152. Siehe [Traces (Beta)](/de/monitoring-usage#traces-beta) |

259| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Wird von Host-Plattformen gesetzt, die Claude Code einbetten und das Modell-Provider-Routing in ihrem Namen verwalten. Wenn gesetzt, werden Provider-Auswahl-, Endpunkt- und Authentifizierungsvariablen wie `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` und `ANTHROPIC_API_KEY` in Einstellungsdateien ignoriert, sodass Benutzereinstellungen das Routing des Hosts nicht überschreiben können. Die automatische Telemetrie-Abmeldung für Bedrock, Vertex und Foundry wird ebenfalls übersprungen, sodass die Telemetrie der Standard-`DISABLE_TELEMETRY`-Abmeldung folgt. Siehe [Standardverhalten nach API-Provider](/de/data-usage#default-behaviors-by-api-provider) |265| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Wird von Host-Plattformen gesetzt, die Claude Code einbetten und das Modell-Provider-Routing in ihrem Namen verwalten. Wenn gesetzt, werden Provider-Auswahl-, Endpunkt- und Authentifizierungsvariablen wie `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` und `ANTHROPIC_API_KEY` in Einstellungsdateien ignoriert, sodass Benutzereinstellungen das Routing des Hosts nicht überschreiben können. Die automatische Telemetrie-Abmeldung für Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry wird ebenfalls übersprungen, sodass die Telemetrie der Standard-`DISABLE_TELEMETRY`-Abmeldung folgt. Siehe [Standardverhalten nach API-Provider](/de/data-usage#default-behaviors-by-api-provider) |

260| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Setzen Sie auf `1`, um dem Proxy zu ermöglichen, DNS-Auflösung durchzuführen, anstatt des Aufrufers. Opt-in für Umgebungen, in denen der Proxy die Hostname-Auflösung durchführen sollte |266| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Setzen Sie auf `1`, um dem Proxy zu ermöglichen, DNS-Auflösung durchzuführen, anstatt des Aufrufers. Opt-in für Umgebungen, in denen der Proxy die Hostname-Auflösung durchführen sollte |

261| `CLAUDE_CODE_REMOTE` | Wird automatisch auf `true` gesetzt, wenn Claude Code als [Cloud-Sitzung](/de/claude-code-on-the-web) ausgeführt wird. Lesen Sie dies aus einem Hook oder Setup-Skript, um zu erkennen, ob Sie sich in einer Cloud-Umgebung befinden |267| `CLAUDE_CODE_REMOTE` | Wird automatisch auf `true` gesetzt, wenn Claude Code als [Cloud-Sitzung](/de/claude-code-on-the-web) ausgeführt wird. Lesen Sie dies aus einem Hook oder Setup-Skript, um zu erkennen, ob Sie sich in einer Cloud-Umgebung befinden |

262| `CLAUDE_CODE_REMOTE_SESSION_ID` | Wird automatisch in [Cloud-Sitzungen](/de/claude-code-on-the-web) auf die ID der aktuellen Sitzung gesetzt. Lesen Sie dies, um einen Link zurück zur Sitzungs-Abschrift zu erstellen. Siehe [Ausgabe zurück zur Sitzung verlinken](/de/claude-code-on-the-web#link-output-back-to-the-session) |268| `CLAUDE_CODE_REMOTE_SESSION_ID` | Wird automatisch in [Cloud-Sitzungen](/de/claude-code-on-the-web) auf die ID der aktuellen Sitzung gesetzt. Lesen Sie dies, um einen Link zurück zur Sitzungs-Abschrift zu erstellen. Siehe [Ausgabe zurück zur Sitzung verlinken](/de/claude-code-on-the-web#link-output-back-to-the-session) |

263| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Setzen Sie auf `1`, um automatisch fortzufahren, wenn die vorherige Sitzung mitten in einem Turn endete. Wird im SDK-Modus verwendet, damit das Modell fortfährt, ohne dass das SDK den Prompt erneut senden muss |269| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Setzen Sie auf `1`, um automatisch fortzufahren, wenn die vorherige Sitzung mitten in einem Turn endete. Wird im SDK-Modus verwendet, damit das Modell fortfährt, ohne dass das SDK den Prompt erneut senden muss |

264| `CLAUDE_CODE_RESUME_PROMPT` | Überschreiben Sie die Fortsetzungsmeldung, die eingefügt wird, wenn eine Sitzung fortgesetzt wird, die mitten in einem Turn endete. Standardmäßig `Continue from where you left off.`. Spawn-Skripte für lang laufende Agenten können dies auf eine direktere Boot-Nachricht setzen. Eine leere Zeichenkette verwendet den Standard |270| `CLAUDE_CODE_RESUME_PROMPT` | Überschreiben Sie die Fortsetzungsmeldung, die eingefügt wird, wenn eine Sitzung fortgesetzt wird, die mitten in einem Turn endete. Standardmäßig `Continue from where you left off.`. Spawn-Skripte für lang laufende Agenten können dies auf eine direktere Boot-Nachricht setzen. Eine leere Zeichenkette verwendet den Standard |

265| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}Setzen Sie auf `1` für unbeaufsichtigte Sitzungen wie Eval-Harnesses, CI-Jobs oder Remote-Worker. Wiederholt `429` und `529` Kapazitätsfehler unbegrenzt, anstatt nach `CLAUDE_CODE_MAX_RETRIES`-Versuchen zu fehlschlagen. 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, sodass eine Sitzung, die ein Nutzungslimit trifft, das verbleibende Fenster abwartet. Erfordert Claude Code v2.1.186 oder später |271| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}Setzen Sie auf `1` für unbeaufsichtigte Sitzungen wie Eval-Harnesses, CI-Jobs oder Remote-Worker. Wiederholt `429` und `529` Kapazitätsfehler unbegrenzt, anstatt nach `CLAUDE_CODE_MAX_RETRIES`-Versuchen zu fehlschlagen. 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, sodass eine Sitzung, die ein Nutzungslimit trifft, das verbleibende Fenster abwartet. {/* min-version: 2.1.199 */}Ab v2.1.199 erhöht es auch die Standard-Wiederholungsanzahl für andere vorübergehende Fehler, wie z. B. 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 |

266| `CLAUDE_CODE_SAFE_MODE` | Setzen Sie auf `1`, um im sicheren Modus zu starten: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Designs, benutzerdefinierte Tastenbindungen, Statuszeilen- und Datei-Vorschlag-Befehle, LSP-Server und automatisches Speichern werden nicht geladen, um eine fehlerhafte Konfiguration zu beheben. Verwaltete Einstellungsrichtlinie gilt weiterhin, einschließlich richtlinien-konfigurierter Hooks, Statuszeilen und Datei-Vorschlag-Befehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und richtlinien-konfigurierte MCP-Server nicht. Äquivalent zum Übergeben von [`--safe-mode`](/de/cli-reference#cli-flags). Direkt gespawnte untergeordnete Prozesse erben die Variable |272| `CLAUDE_CODE_SAFE_MODE` | Setzen Sie auf `1`, um im sicheren Modus zu starten: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Designs, benutzerdefinierte Tastenbindungen, Statuszeilen- und Datei-Vorschlag-Befehle, LSP-Server und automatisches Speichern werden nicht geladen, um eine fehlerhafte Konfiguration zu beheben. Verwaltete Einstellungsrichtlinie gilt weiterhin, einschließlich richtlinien-konfigurierter Hooks, Statuszeilen und Datei-Vorschlag-Befehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und richtlinien-konfigurierte MCP-Server nicht. Äquivalent zum Übergeben von [`--safe-mode`](/de/cli-reference#cli-flags). Direkt gespawnte untergeordnete Prozesse erben die Variable |

267| `CLAUDE_CODE_SCRIPT_CAPS` | JSON-Objekt, das begrenzt, wie oft bestimmte 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 ganzzahlige Aufruflimits. Zum Beispiel `{"deploy.sh": 2}` erlaubt `deploy.sh`, höchstens zweimal aufgerufen zu werden. Der Abgleich ist substring-basiert, daher zählen Shell-Erweiterungstricks wie `./scripts/deploy.sh $(evil)` weiterhin gegen das Limit. Runtime-Fan-out über `xargs` oder `find -exec` wird nicht erkannt; dies ist eine Defense-in-Depth-Kontrolle |273| `CLAUDE_CODE_SCRIPT_CAPS` | JSON-Objekt, das begrenzt, wie oft bestimmte 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 ganzzahlige Aufruflimits. Zum Beispiel `{"deploy.sh": 2}` erlaubt `deploy.sh`, höchstens zweimal aufgerufen zu werden. Der Abgleich ist substring-basiert, daher zählen Shell-Erweiterungstricks wie `./scripts/deploy.sh $(evil)` weiterhin gegen das Limit. Runtime-Fan-out über `xargs` oder `find -exec` wird nicht erkannt; dies ist eine Defense-in-Depth-Kontrolle |

268| `CLAUDE_CODE_SCROLL_SPEED` | Legen Sie den Mausrad-Scroll-Multiplikator in der [Vollbilddarstellung](/de/fullscreen#mouse-wheel-scrolling) fest. Akzeptiert Werte von 1 bis 20 und Bruchteile unter 1 wie `0,5`, um beschleunigtes Trackpad- und Mausrad-Scrolling in Terminals zu verlangsamen. Setzen Sie auf `3`, um `vim` zu entsprechen, wenn Ihr Terminal ein Mausrad-Ereignis pro Kerbe ohne Verstärkung sendet. Wird im JetBrains IDE-Terminal ignoriert, wo Claude Code sein eigenes Scroll-Handling verwendet |274| `CLAUDE_CODE_SCROLL_SPEED` | Legen Sie den Mausrad-Scroll-Multiplikator in der [Vollbilddarstellung](/de/fullscreen#mouse-wheel-scrolling) fest. Akzeptiert Werte von 1 bis 20 und Bruchteile unter 1 wie `0,5`, um beschleunigtes Trackpad- und Mausrad-Scrolling in Terminals zu verlangsamen. Setzen Sie auf `3`, um `vim` zu entsprechen, wenn Ihr Terminal ein Mausrad-Ereignis pro Kerbe ohne Verstärkung sendet. Wird im JetBrains IDE-Terminal ignoriert, wo Claude Code sein eigenes Scroll-Handling verwendet |


273| `CLAUDE_CODE_SIMPLE` | Setzen Sie auf `1`, um mit einem minimalen System-Prompt und nur den Tools Bash, Datei lesen und Datei bearbeiten auszuführen. MCP-Tools aus `--mcp-config` sind weiterhin verfügbar. Deaktiviert die automatische Erkennung von Hooks, Skills, Plugins, MCP-Servern, automatisches Speichern und CLAUDE.md. OAuth-Token und Keychain-Anmeldedaten werden nicht gelesen, daher muss die Anthropic-Authentifizierung von `ANTHROPIC_API_KEY` oder einem `apiKeyHelper` in `--settings` stammen. Äquivalent zum Übergeben von [`--bare`](/de/headless#start-faster-with-bare-mode) |279| `CLAUDE_CODE_SIMPLE` | Setzen Sie auf `1`, um mit einem minimalen System-Prompt und nur den Tools Bash, Datei lesen und Datei bearbeiten auszuführen. MCP-Tools aus `--mcp-config` sind weiterhin verfügbar. Deaktiviert die automatische Erkennung von Hooks, Skills, Plugins, MCP-Servern, automatisches Speichern und CLAUDE.md. OAuth-Token und Keychain-Anmeldedaten werden nicht gelesen, daher muss die Anthropic-Authentifizierung von `ANTHROPIC_API_KEY` oder einem `apiKeyHelper` in `--settings` stammen. Äquivalent zum Übergeben von [`--bare`](/de/headless#start-faster-with-bare-mode) |

274| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Setzen Sie auf `1`, um einen kürzeren System-Prompt und zusammengefasste Tool-Beschreibungen auf jedem Modell zu verwenden. Setzen Sie auf `0`, `false`, `no` oder `off`, um sich abzumelden, auch wenn das Experiment oder die Server-Konfiguration es ansonsten aktivieren würde. Der vollständige Tool-Satz, Hooks, MCP-Server und CLAUDE.md-Erkennung bleiben aktiviert |280| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Setzen Sie auf `1`, um einen kürzeren System-Prompt und zusammengefasste Tool-Beschreibungen auf jedem Modell zu verwenden. Setzen Sie auf `0`, `false`, `no` oder `off`, um sich abzumelden, auch wenn das Experiment oder die Server-Konfiguration es ansonsten aktivieren würde. Der vollständige Tool-Satz, Hooks, MCP-Server und CLAUDE.md-Erkennung bleiben aktiviert |

275| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Überspringen Sie die clientseitige Authentifizierung für [Claude Platform on AWS](/de/claude-platform-on-aws), für Gateways, die Anfragen selbst signieren |281| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Überspringen Sie die clientseitige Authentifizierung für [Claude Platform on AWS](/de/claude-platform-on-aws), für Gateways, die Anfragen selbst signieren |

276| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Überspringen Sie die AWS-Authentifizierung für Bedrock (z. B. bei Verwendung eines LLM-Gateways) |282| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Überspringen Sie die AWS-Authentifizierung für Amazon Bedrock (z. B. bei Verwendung eines LLM-Gateways) |

277| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Überspringen Sie die Azure-Authentifizierung für Microsoft Foundry. Für ein Gateway setzen Sie stattdessen die Anmeldedaten in `ANTHROPIC_FOUNDRY_API_KEY`; ohne einen API-Schlüssel lässt diese Variable den Foundry-Client nicht in der Lage, Anfragen zu senden |283| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Überspringen Sie die 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 behält den `Authorization`-Header, den Sie bereitstellen, z. B. durch `ANTHROPIC_CUSTOM_HEADERS`. Wird ignoriert, wenn `ANTHROPIC_FOUNDRY_API_KEY` oder `ANTHROPIC_FOUNDRY_AUTH_TOKEN` gesetzt ist. {/* min-version: 2.1.203 */}Vor v2.1.203 ließ diese Variable den Microsoft Foundry-Client nicht in der Lage, Anfragen zu senden, es sei denn, ein API-Schlüssel war auch gesetzt |

278| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Überspringen Sie die AWS-Authentifizierung für Bedrock Mantle (z. B. bei Verwendung eines LLM-Gateways) |284| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Überspringen Sie die AWS-Authentifizierung für Amazon Bedrock Mantle (z. B. bei Verwendung eines LLM-Gateways) |

279| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Setzen Sie auf `1`, um das Schreiben von Prompt-Verlauf und Sitzungs-Abschriften auf die Festplatte zu überspringen. Sitzungen, die mit dieser Variablen gestartet werden, erscheinen nicht in `--resume`, `--continue` oder Up-Arrow-Verlauf. Nützlich für kurzlebige Skript-Sitzungen |285| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Setzen Sie auf `1`, um das Schreiben von Prompt-Verlauf und Sitzungs-Abschriften auf die Festplatte zu überspringen. Sitzungen, die mit dieser Variablen gestartet werden, erscheinen nicht in `--resume`, `--continue` oder Up-Arrow-Verlauf. Nützlich für kurzlebige Skript-Sitzungen |

280| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Überspringen Sie die Google-Authentifizierung für Vertex (z. B. bei Verwendung eines LLM-Gateways) |286| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Überspringen Sie die Google-Authentifizierung für Google Cloud's Agent Platform (z. B. bei Verwendung eines LLM-Gateways) |

281| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Maximale Anzahl von aufeinanderfolgenden Malen, die ein [Stop](/de/hooks#stop) oder [SubagentStop](/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 benötigt, um sich zu beheben |287| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Maximale Anzahl von aufeinanderfolgenden Malen, die ein [Stop](/de/hooks#stop) oder [SubagentStop](/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 benötigt, um sich zu beheben |

282| `CLAUDE_CODE_SUBAGENT_MODEL` | Siehe [Modellkonfiguration](/de/model-config). {/* min-version: 2.1.196 */}Ab v2.1.196 ist das Setzen auf `inherit` dasselbe wie das Nichtsetzen; frühere Versionen behandelten `inherit` als eine Überschreibung, die jeden Subagenten auf das Modell der Hauptkonversation zwang |288| `CLAUDE_CODE_SUBAGENT_MODEL` | Siehe [Modellkonfiguration](/de/model-config). {/* min-version: 2.1.196 */}Ab v2.1.196 ist das Setzen auf `inherit` dasselbe wie das Nichtsetzen; frühere Versionen behandelten `inherit` als eine Überschreibung, die jeden Subagenten auf das Modell der Hauptkonversation zwang |

283| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Setzen Sie auf `1`, um Anthropic- und Cloud-Provider-Anmeldedaten aus Subprocess-Umgebungen zu entfernen (Bash-Tool, Hooks, MCP-Stdio-Server). Der übergeordnete Claude-Prozess behält diese Anmeldedaten für API-Aufrufe, aber untergeordnete Prozesse können sie nicht lesen, was die Exposition gegenüber Prompt-Injection-Angriffen reduziert, die versuchen, Geheimnisse über Shell-Erweiterung zu exfiltrieren. Unter Linux führt dies auch Bash-Subprozesse in einem isolierten PID-Namespace aus, sodass sie Host-Prozessumgebungen über `/proc` nicht lesen können; 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 |289| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Setzen Sie auf `1`, um Anthropic- und Cloud-Provider-Anmeldedaten aus Subprocess-Umgebungen zu entfernen (Bash-Tool, Hooks, MCP-Stdio-Server). Der übergeordnete Claude-Prozess behält diese Anmeldedaten für API-Aufrufe, aber untergeordnete Prozesse können sie nicht lesen, was die Exposition gegenüber Prompt-Injection-Angriffen reduziert, die versuchen, Geheimnisse über Shell-Erweiterung zu exfiltrieren. Unter Linux führt dies auch Bash-Subprozesse in einem isolierten PID-Namespace aus, sodass sie Host-Prozessumgebungen über `/proc` nicht lesen können; 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 |


292| `CLAUDE_CODE_TMPDIR` | Überschreiben Sie das Temp-Verzeichnis, das für interne Temp-Dateien verwendet wird. Claude Code hängt `/claude-{uid}/` (Unix) oder `/claude/` (Windows) an diesen Pfad an. Standard: `/tmp` auf macOS, `os.tmpdir()` auf Linux und Windows. {/* min-version: 2.1.161 */}Ab v2.1.161 erhalten [Sandboxed](/de/sandboxing) Bash-Subprozesse auf macOS und Linux einen kurzen Fallback-`$TMPDIR` unter dem Systemstandard, 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` unverändert. Claude Codes eigene Temp-Dateien verwenden immer Ihren Override |298| `CLAUDE_CODE_TMPDIR` | Überschreiben Sie das Temp-Verzeichnis, das für interne Temp-Dateien verwendet wird. Claude Code hängt `/claude-{uid}/` (Unix) oder `/claude/` (Windows) an diesen Pfad an. Standard: `/tmp` auf macOS, `os.tmpdir()` auf Linux und Windows. {/* min-version: 2.1.161 */}Ab v2.1.161 erhalten [Sandboxed](/de/sandboxing) Bash-Subprozesse auf macOS und Linux einen kurzen Fallback-`$TMPDIR` unter dem Systemstandard, 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` unverändert. Claude Codes eigene Temp-Dateien verwenden immer Ihren Override |

293| `CLAUDE_CODE_TMUX_TRUECOLOR` | Setzen Sie auf `1`, um 24-Bit-Truecolor-Ausgabe in tmux zu ermöglichen. Standardmäßig begrenzt Claude Code auf 256 Farben, wenn `$TMUX` gesetzt ist, da 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](/de/terminal-config) für andere tmux-Einstellungen |299| `CLAUDE_CODE_TMUX_TRUECOLOR` | Setzen Sie auf `1`, um 24-Bit-Truecolor-Ausgabe in tmux zu ermöglichen. Standardmäßig begrenzt Claude Code auf 256 Farben, wenn `$TMUX` gesetzt ist, da 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](/de/terminal-config) für andere tmux-Einstellungen |

294| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Verwenden Sie [Claude Platform on AWS](/de/claude-platform-on-aws) |300| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Verwenden Sie [Claude Platform on AWS](/de/claude-platform-on-aws) |

295| `CLAUDE_CODE_USE_BEDROCK` | Verwenden Sie [Bedrock](/de/amazon-bedrock) |301| `CLAUDE_CODE_USE_BEDROCK` | Verwenden Sie [Amazon Bedrock](/de/amazon-bedrock) |

296| `CLAUDE_CODE_USE_FOUNDRY` | Verwenden Sie [Microsoft Foundry](/de/microsoft-foundry) |302| `CLAUDE_CODE_USE_FOUNDRY` | Verwenden Sie [Microsoft Foundry](/de/microsoft-foundry) |

297| `CLAUDE_CODE_USE_MANTLE` | Verwenden Sie den Bedrock-[Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) |303| `CLAUDE_CODE_USE_MANTLE` | Verwenden Sie den Amazon Bedrock-[Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) |

298| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Setzen Sie auf `1`, um benutzerdefinierte Befehle, Subagenten und Ausgabestile mit Node.js-Datei-APIs anstelle von ripgrep zu ermitteln. Setzen Sie dies, wenn die gebündelte ripgrep-Binärdatei in Ihrer Umgebung nicht verfügbar oder blockiert ist. Beeinflusst nicht die Grep- oder Datei-Such-Tools |304| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Setzen Sie auf `1`, um benutzerdefinierte Befehle, Subagenten und Ausgabestile mit Node.js-Datei-APIs anstelle von ripgrep zu ermitteln. Setzen Sie dies, wenn die gebündelte ripgrep-Binärdatei in Ihrer Umgebung nicht verfügbar oder blockiert ist. Beeinflusst nicht die Grep- oder Datei-Such-Tools |

299| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Steuert das PowerShell-Tool. Unter Windows ohne Git Bash ist das Tool automatisch aktiviert; setzen Sie auf `0`, um es zu deaktivieren. Unter Windows mit installiertem Git Bash wird das Tool schrittweise eingeführt: Setzen Sie auf `1`, um sich anzumelden, oder auf `0`, um sich abzumelden. Unter Linux, macOS und WSL setzen Sie auf `1`, um es zu aktivieren, was `pwsh` auf Ihrem `PATH` erfordert. Wenn unter Windows aktiviert, kann Claude PowerShell-Befehle nativ ausführen, anstatt sie durch Git Bash zu leiten. Siehe [PowerShell-Tool](/de/tools-reference#powershell-tool) |305| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Steuert das PowerShell-Tool. Unter Windows ohne Git Bash ist das Tool automatisch aktiviert; setzen Sie auf `0`, um es zu deaktivieren. Unter Windows mit installiertem Git Bash wird das Tool schrittweise eingeführt: Setzen Sie auf `1`, um sich anzumelden, oder auf `0`, um sich abzumelden. Unter Linux, macOS und WSL setzen Sie auf `1`, um es zu aktivieren, was `pwsh` auf Ihrem `PATH` erfordert. Wenn unter Windows aktiviert, kann Claude PowerShell-Befehle nativ ausführen, anstatt sie durch Git Bash zu leiten. Siehe [PowerShell-Tool](/de/tools-reference#powershell-tool) |

300| `CLAUDE_CODE_USE_VERTEX` | Verwenden Sie [Vertex](/de/google-vertex-ai) |306| `CLAUDE_CODE_USE_VERTEX` | Verwenden Sie [Google Cloud's Agent Platform](/de/google-vertex-ai) |

301| `CLAUDE_CONFIG_DIR` | Überschreiben Sie das Konfigurationsverzeichnis (Standard: `~/.claude`). Alle Einstellungen, Anmeldedaten, Sitzungsverlauf und Plugins werden unter diesem Pfad gespeichert. Nützlich zum Ausführen mehrerer Konten nebeneinander: z. B. `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |307| `CLAUDE_CONFIG_DIR` | Überschreiben Sie das Konfigurationsverzeichnis (Standard: `~/.claude`). Alle Einstellungen, Sitzungsverlauf und Plugins werden unter diesem Pfad gespeichert, ebenso wie Anmeldedaten unter Linux und Windows; auf macOS befinden sich Anmeldedaten im System Keychain. Nützlich zum Ausführen mehrerer Konten nebeneinander: z. B. `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

302| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}Setzen Sie auf `1`, um in-flight Hintergrundarbeit zu stoppen, anstatt sie zu übernehmen, wenn Sie eine Sitzung durch Drücken von `←` oder mit [`/background`](/de/agent-view#from-inside-a-session) in den Hintergrund verschieben. Claude Code fragt Sie zur Bestätigung auf, bevor Sie in den Hintergrund verschieben, und stoppt dann die Aufgaben, die ansonsten übernommen würden. Erfordert Claude Code v2.1.195 oder später |308| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}Setzen Sie auf `1`, um in-flight Hintergrundarbeit zu stoppen, anstatt sie zu übernehmen, wenn Sie eine Sitzung durch Drücken von `←` oder mit [`/background`](/de/agent-view#from-inside-a-session) in den Hintergrund verschieben. Claude Code fragt Sie zur Bestätigung auf, bevor Sie in den Hintergrund verschieben, und stoppt dann die Aufgaben, die ansonsten übernommen würden. Erfordert Claude Code v2.1.195 oder später |

303| `CLAUDE_EFFORT` | Wird automatisch in Bash-Tool-Subprozessen und Hook-Befehlen auf die aktive [Anstrengungsstufe](/de/model-config#adjust-effort-level) für den Turn gesetzt: `low`, `medium`, `high`, `xhigh` oder `max`. Ultracode ist keine separate Stufe und wird als `xhigh` gemeldet. Entspricht dem Feld `effort.level`, das an [Hooks](/de/hooks) übergeben wird. Wird nur gesetzt, wenn das aktuelle Modell den Effort-Parameter unterstützt |309| `CLAUDE_EFFORT` | Wird automatisch in Bash-Tool-Subprozessen und Hook-Befehlen auf die aktive [Anstrengungsstufe](/de/model-config#adjust-effort-level) für den Turn gesetzt: `low`, `medium`, `high`, `xhigh` oder `max`. Ultracode ist keine separate Stufe und wird als `xhigh` gemeldet. Entspricht dem Feld `effort.level`, das an [Hooks](/de/hooks) übergeben wird. Wird nur gesetzt, wenn das aktuelle Modell den Effort-Parameter unterstützt |

304| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Setzen Sie auf `1`, um den Byte-Level-Streaming-Idle-Watchdog zu erzwingen, oder auf `0`, um ihn zu deaktivieren. Wenn nicht gesetzt, ist der Watchdog standardmäßig für direkte Anthropic API- und [Claude Platform on AWS](/de/claude-platform-on-aws)-Verbindungen aktiviert. Der Byte-Watchdog bricht eine Verbindung ab, wenn für 180 Sekunden standardmäßig bei direkten Anthropic API-Verbindungen, 300 Sekunden bei Claude Platform on AWS und bei Aktivierung auf Bedrock oder für den Wert von `CLAUDE_STREAM_IDLE_TIMEOUT_MS` keine Bytes auf dem Draht ankommen, wenn dieser gesetzt ist, was auf ein Minimum von 5 Minuten begrenzt ist, unabhängig vom Event-Level-Watchdog |310| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Setzen Sie auf `1`, um den Byte-Level-Streaming-Idle-Watchdog zu erzwingen, oder auf `0`, um ihn zu deaktivieren. Wenn nicht gesetzt, ist der Watchdog standardmäßig für direkte Anthropic API- und [Claude Platform on AWS](/de/claude-platform-on-aws)-Verbindungen aktiviert. Der Byte-Watchdog bricht eine Verbindung ab, wenn für 180 Sekunden standardmäßig bei direkten Anthropic API-Verbindungen, 300 Sekunden bei Claude Platform on AWS und bei Aktivierung auf Amazon Bedrock oder für den Wert von `CLAUDE_STREAM_IDLE_TIMEOUT_MS` keine Bytes auf dem Draht ankommen, wenn dieser gesetzt ist, was auf ein Minimum von 5 Minuten begrenzt ist, unabhängig vom Event-Level-Watchdog |

305| `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. Standardmäßig aus. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |311| `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. Standardmäßig aus. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

306| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Setzen Sie auf `0`, um den Event-Level-Streaming-Idle-Watchdog zu deaktivieren, oder auf `1`, um ihn zu erzwingen. {/* min-version: 2.1.196 */}Wenn nicht gesetzt, ist der Watchdog standardmäßig für alle Provider aktiviert. Vor v2.1.196 war der nicht gesetzte Standard Server-gesteuert auf der direkten Anthropic API und aus auf anderen Providern. {/* min-version: 2.1.169 */}Ab v2.1.169 haben Provider außer der direkten Anthropic API und Claude Platform on AWS auch ein Standard-On 5-Minuten-Body-Idle-Timeout unabhängig von dieser Variablen; siehe `API_FORCE_IDLE_TIMEOUT`. Auf Bedrock können Sie auch den unabhängigen Byte-Level-Watchdog mit `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` aktivieren; die beiden laufen zusammen, wenn beide gesetzt sind. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |312| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Setzen Sie auf `0`, um den Event-Level-Streaming-Idle-Watchdog zu deaktivieren, oder auf `1`, um ihn zu erzwingen. {/* min-version: 2.1.196 */}Wenn nicht gesetzt, ist der Watchdog standardmäßig für alle Provider aktiviert. Vor v2.1.196 war der nicht gesetzte Standard Server-gesteuert auf der direkten Anthropic API und aus auf anderen Providern. {/* min-version: 2.1.169 */}Ab v2.1.169 haben Provider außer der direkten Anthropic API und Claude Platform on AWS auch ein Standard-On 5-Minuten-Body-Idle-Timeout unabhängig von dieser Variablen; siehe `API_FORCE_IDLE_TIMEOUT`. Auf Amazon Bedrock können Sie auch den unabhängigen Byte-Level-Watchdog mit `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` aktivieren; die beiden laufen zusammen, wenn beide gesetzt sind. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

307| `CLAUDE_ENV_FILE` | Pfad zu einem Shell-Skript, dessen Inhalte Claude Code vor jedem Bash-Befehl im gleichen Shell-Prozess ausführt, sodass Exporte in der Datei für den Befehl sichtbar sind. Verwenden Sie, um virtualenv- oder Conda-Aktivierung über Befehle hinweg beizubehalten. Wird auch dynamisch von [SessionStart](/de/hooks#persist-environment-variables), [Setup](/de/hooks#setup), [CwdChanged](/de/hooks#cwdchanged) und [FileChanged](/de/hooks#filechanged)-Hooks gefüllt |313| `CLAUDE_ENV_FILE` | Pfad zu einem Shell-Skript, dessen Inhalte Claude Code vor jedem Bash-Befehl im gleichen Shell-Prozess ausführt, sodass Exporte in der Datei für den Befehl sichtbar sind. Verwenden Sie, um virtualenv- oder Conda-Aktivierung über Befehle hinweg beizubehalten. Wird auch dynamisch von [SessionStart](/de/hooks#persist-environment-variables), [Setup](/de/hooks#setup), [CwdChanged](/de/hooks#cwdchanged) und [FileChanged](/de/hooks#filechanged)-Hooks gefüllt |

308| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Präfix für automatisch generierte [Remote Control](/de/remote-control)-Sitzungsnamen, wenn kein expliziter Name angegeben ist. Standardmäßig der Hostname Ihres Computers, was Namen wie `myhost-graceful-unicorn` erzeugt. Das CLI-Flag `--remote-control-session-name-prefix` setzt denselben Wert für einen einzelnen Aufruf |314| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Präfix für automatisch generierte [Remote Control](/de/remote-control)-Sitzungsnamen, wenn kein expliziter Name angegeben ist. Standardmäßig der Hostname Ihres Computers, was Namen wie `myhost-graceful-unicorn` erzeugt. Das CLI-Flag `--remote-control-session-name-prefix` setzt denselben Wert für einen einzelnen Aufruf |

309| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in Millisekunden, bevor der Streaming-Idle-Watchdog eine stillgelegte Verbindung schließt. Wenn Sie diese Variable explizit setzen, ist das Minimum `300000` (5 Minuten); niedrigere Werte werden stillschweigend auf die Obergrenze begrenzt, um erweiterte Denk-Pausen und Proxy-Pufferung zu absorbieren. Wenn nicht gesetzt, beträgt der Event-Level-Watchdog-Standard 300 Sekunden und der Byte-Level-Watchdog-Standard 180 Sekunden bei direkten Anthropic API-Verbindungen (300 Sekunden bei Claude Platform on AWS und anderen Providern). Das nicht gesetzte 180-Sekunden-Byte-Watchdog-Standard ist ein separater Wert und unterliegt nicht der 5-Minuten-Obergrenze. Das Body-Idle-Timeout, das unter `API_FORCE_IDLE_TIMEOUT` beschrieben wird, gilt unabhängig. Auf Bedrock gilt auch, wenn `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |315| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in Millisekunden, bevor der Streaming-Idle-Watchdog eine stillgelegte Verbindung schließt. Wenn Sie diese Variable explizit setzen, ist das Minimum `300000` (5 Minuten); niedrigere Werte werden stillschweigend auf die Obergrenze begrenzt, um erweiterte Denk-Pausen und Proxy-Pufferung zu absorbieren. Wenn nicht gesetzt, beträgt der Event-Level-Watchdog-Standard 300 Sekunden und der Byte-Level-Watchdog-Standard 180 Sekunden bei direkten Anthropic API-Verbindungen (300 Sekunden bei Claude Platform on AWS und anderen Providern). Das nicht gesetzte 180-Sekunden-Byte-Watchdog-Standard ist ein separater Wert und unterliegt nicht der 5-Minuten-Obergrenze. Das Body-Idle-Timeout, das unter `API_FORCE_IDLE_TIMEOUT` beschrieben wird, gilt unabhängig. Auf Amazon Bedrock gilt auch, wenn `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |

310| `DEBUG` | Setzen Sie auf `1`, um Debug-Modus zu aktivieren, äquivalent zum Starten mit [`--debug`](/de/cli-reference#cli-flags). Debug-Protokolle werden in `~/.claude/debug/<session-id>.txt` geschrieben, oder in den Pfad, der von `CLAUDE_CODE_DEBUG_LOGS_DIR` gesetzt ist. Nur die wahren 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 |316| `DEBUG` | Setzen Sie auf `1`, um Debug-Modus zu aktivieren, äquivalent zum Starten mit [`--debug`](/de/cli-reference#cli-flags). Debug-Protokolle werden in `~/.claude/debug/<session-id>.txt` geschrieben, oder in den Pfad, der von `CLAUDE_CODE_DEBUG_LOGS_DIR` gesetzt ist. Nur die wahren 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 |

311| `DISABLE_AUTOUPDATER` | Setzen Sie auf `1`, um automatische Hintergrund-Updates zu deaktivieren. Manuelles `claude update` funktioniert weiterhin. Verwenden Sie `DISABLE_UPDATES`, um beide zu blockieren |317| `DISABLE_AUTOUPDATER` | Setzen Sie auf `1`, um automatische Hintergrund-Updates zu deaktivieren. Manuelles `claude update` funktioniert weiterhin. Verwenden Sie `DISABLE_UPDATES`, um beide zu blockieren |

312| `DISABLE_AUTO_COMPACT` | Setzen Sie auf `1`, um die automatische Komprimierung bei Annäherung an das Kontextlimit zu deaktivieren. Der manuelle `/compact`-Befehl bleibt verfügbar. Verwenden Sie, wenn Sie explizite Kontrolle darüber wünschen, wann Komprimierung auftritt |318| `DISABLE_AUTO_COMPACT` | Setzen Sie auf `1`, um die automatische Komprimierung bei Annäherung an das Kontextlimit zu deaktivieren. Der manuelle `/compact`-Befehl bleibt verfügbar. Verwenden Sie, wenn Sie explizite Kontrolle darüber wünschen, wann Komprimierung auftritt |


318| `DISABLE_FEEDBACK_COMMAND` | Setzen Sie auf `1`, um den `/feedback`-Befehl zu deaktivieren. Der ältere Name `DISABLE_BUG_COMMAND` wird ebenfalls akzeptiert |324| `DISABLE_FEEDBACK_COMMAND` | Setzen Sie auf `1`, um den `/feedback`-Befehl zu deaktivieren. Der ältere Name `DISABLE_BUG_COMMAND` wird ebenfalls akzeptiert |

319| `DISABLE_GROWTHBOOK` | Setzen Sie auf `1`, um GrowthBook-Feature-Flag-Abruf zu deaktivieren und Code-Standardwerte für jedes Flag zu verwenden. Telemetrie-Ereignisprotokollierung bleibt aktiviert, es sei denn, `DISABLE_TELEMETRY` ist auch gesetzt |325| `DISABLE_GROWTHBOOK` | Setzen Sie auf `1`, um GrowthBook-Feature-Flag-Abruf zu deaktivieren und Code-Standardwerte für jedes Flag zu verwenden. Telemetrie-Ereignisprotokollierung bleibt aktiviert, es sei denn, `DISABLE_TELEMETRY` ist auch gesetzt |

320| `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 verbergen kann |326| `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 verbergen kann |

321| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Setzen Sie auf `1`, um den `/install-github-app`-Befehl auszublenden. Bereits ausgeblendet bei Verwendung von Drittanbieter-Providern (Bedrock, Vertex oder Foundry) |327| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Setzen Sie auf `1`, um den `/install-github-app`-Befehl auszublenden. Bereits ausgeblendet bei Verwendung von Drittanbieter-Providern (Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry) |

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

323| `DISABLE_LOGIN_COMMAND` | Setzen Sie auf `1`, um den `/login`-Befehl auszublenden. Nützlich, wenn die Authentifizierung extern über API-Schlüssel oder `apiKeyHelper` erfolgt |329| `DISABLE_LOGIN_COMMAND` | Setzen Sie auf `1`, um den `/login`-Befehl auszublenden. Nützlich, wenn die Authentifizierung extern über API-Schlüssel oder `apiKeyHelper` erfolgt |

324| `DISABLE_LOGOUT_COMMAND` | Setzen Sie auf `1`, um den `/logout`-Befehl auszublenden |330| `DISABLE_LOGOUT_COMMAND` | Setzen Sie auf `1`, um den `/logout`-Befehl auszublenden |


332| `DISABLE_UPGRADE_COMMAND` | Setzen Sie auf `1`, um den `/upgrade`-Befehl auszublenden |338| `DISABLE_UPGRADE_COMMAND` | Setzen Sie auf `1`, um den `/upgrade`-Befehl auszublenden |

333| `DO_NOT_TRACK` | Setzen Sie auf `1`, um sich von Telemetrie abzumelden. Äquivalent zum Setzen von `DISABLE_TELEMETRY`. Claude Code ehrt dies als die Cross-Tool-Konvention, die von vielen Entwickler-CLIs anerkannt wird |339| `DO_NOT_TRACK` | Setzen Sie auf `1`, um sich von Telemetrie abzumelden. Äquivalent zum Setzen von `DISABLE_TELEMETRY`. Claude Code ehrt dies als die Cross-Tool-Konvention, die von vielen Entwickler-CLIs anerkannt wird |

334| `ENABLE_CLAUDEAI_MCP_SERVERS` | Setzen Sie auf `false`, um [claude.ai MCP-Server](/de/mcp#use-mcp-servers-from-claude-ai) in Claude Code zu deaktivieren. Standardmäßig für angemeldete Benutzer aktiviert. Um pro-Projekt oder pro-Org zu deaktivieren, setzen Sie stattdessen [`disableClaudeAiConnectors`](/de/settings#available-settings) in Einstellungen |340| `ENABLE_CLAUDEAI_MCP_SERVERS` | Setzen Sie auf `false`, um [claude.ai MCP-Server](/de/mcp#use-mcp-servers-from-claude-ai) in Claude Code zu deaktivieren. Standardmäßig für angemeldete Benutzer aktiviert. Um pro-Projekt oder pro-Org zu deaktivieren, setzen Sie stattdessen [`disableClaudeAiConnectors`](/de/settings#available-settings) in Einstellungen |

335| `ENABLE_PROMPT_CACHING_1H` | Setzen Sie auf `1`, um eine 1-Stunden-[Prompt-Cache-TTL](/de/prompt-caching#cache-lifetime) anstelle der Standard-5-Minuten anzufordern. Vorgesehen für API-Schlüssel-, [Bedrock](/de/amazon-bedrock)-, [Vertex](/de/google-vertex-ai)-, [Foundry](/de/microsoft-foundry)- und [Claude Platform on AWS](/de/claude-platform-on-aws)-Benutzer. Abonnement-Benutzer erhalten automatisch 1-Stunden-TTL. 1-Stunden-Cache-Schreibvorgänge werden mit einer höheren Rate abgerechnet |341| `ENABLE_PROMPT_CACHING_1H` | Setzen Sie auf `1`, um eine 1-Stunden-[Prompt-Cache-TTL](/de/prompt-caching#cache-lifetime) anstelle der Standard-5-Minuten anzufordern. Vorgesehen für API-Schlüssel-, [Amazon Bedrock](/de/amazon-bedrock)-, [Google Cloud's Agent Platform](/de/google-vertex-ai)-, [Microsoft Foundry](/de/microsoft-foundry)- und [Claude Platform on AWS](/de/claude-platform-on-aws)-Benutzer. Abonnement-Benutzer erhalten automatisch 1-Stunden-TTL. 1-Stunden-Cache-Schreibvorgänge werden mit einer höheren Rate abgerechnet |

336| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Veraltet. Verwenden Sie stattdessen `ENABLE_PROMPT_CACHING_1H` |342| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Veraltet. Verwenden Sie stattdessen `ENABLE_PROMPT_CACHING_1H` |

337| `ENABLE_TOOL_SEARCH` | Steuert [MCP-Tool-Suche](/de/mcp#scale-with-mcp-tool-search). Nicht gesetzt: alle MCP-Tools standardmäßig aufgeschoben, aber upfront geladen auf Vertex AI oder wenn `ANTHROPIC_BASE_URL` auf einen Nicht-First-Party-Host verweist. Werte: `true` (immer aufgeschoben und Beta-Header senden, Anfragen schlagen auf Vertex AI-Modellen älter als Sonnet 4.5 oder Opus 4.5 fehl, oder auf Proxies, die `tool_reference` nicht unterstützen), `auto` (Schwellenwertmodus: upfront laden, wenn Tools in 10 % des Kontexts passen), `auto:N` (benutzerdefinierter Schwellenwert, z. B. `auto:5` für 5 %), `false` (alle upfront laden) |343| `ENABLE_TOOL_SEARCH` | Steuert [MCP-Tool-Suche](/de/mcp#scale-with-mcp-tool-search). Nicht gesetzt: alle MCP-Tools standardmäßig aufgeschoben, aber upfront geladen auf Google Cloud's Agent Platform oder wenn `ANTHROPIC_BASE_URL` auf einen Nicht-First-Party-Host verweist. Werte: `true` (immer aufgeschoben und Beta-Header senden, Anfragen schlagen auf Google Cloud's Agent Platform-Modellen älter als Sonnet 4.5 oder Opus 4.5 fehl, oder auf Proxies, die `tool_reference` nicht unterstützen), `auto` (Schwellenwertmodus: upfront laden, wenn Tools in 10 % des Kontexts passen), `auto:N` (benutzerdefinierter Schwellenwert, z. B. `auto:5` für 5 %), `false` (alle upfront laden) |

338| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Setzen Sie auf einen beliebigen Nicht-Leer-Wert, um alle Modelle, nicht nur Opus, zu veranlassen, bei wiederholten Überladungsfehlern nicht mehr zu versuchen, wenn kein Fallback-Modell konfiguriert ist. {/* min-version: 2.1.160 */}Ab v2.1.160 löst eine konfigurierte [Fallback-Modellkette](/de/model-config#fallback-model-chains) bei wiederholten Überladungsfehlern für jedes primäre Modell aus, sodass diese Variable das Wechseln zu einem Fallback-Modell nicht beeinflusst |344| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Setzen Sie auf einen beliebigen Nicht-Leer-Wert, um alle Modelle, nicht nur Opus, zu veranlassen, bei wiederholten Überladungsfehlern nicht mehr zu versuchen, wenn kein Fallback-Modell konfiguriert ist. {/* min-version: 2.1.160 */}Ab v2.1.160 löst eine konfigurierte [Fallback-Modellkette](/de/model-config#fallback-model-chains) bei wiederholten Überladungsfehlern für jedes primäre Modell aus, sodass diese Variable das Wechseln zu einem Fallback-Modell nicht beeinflusst |

339| `FORCE_AUTOUPDATE_PLUGINS` | Setzen Sie auf `1`, um Plugin-Auto-Updates zu erzwingen, auch wenn der Haupt-Auto-Updater über `DISABLE_AUTOUPDATER` deaktiviert ist |345| `FORCE_AUTOUPDATE_PLUGINS` | Setzen Sie auf `1`, um Plugin-Auto-Updates zu erzwingen, auch wenn der Haupt-Auto-Updater über `DISABLE_AUTOUPDATER` deaktiviert ist |

340| `FORCE_PROMPT_CACHING_5M` | Setzen Sie auf `1`, um die 5-Minuten-Prompt-Cache-TTL zu erzwingen, auch wenn 1-Stunden-TTL ansonsten gelten würde. Überschreibt `ENABLE_PROMPT_CACHING_1H` |346| `FORCE_PROMPT_CACHING_5M` | Setzen Sie auf `1`, um die 5-Minuten-Prompt-Cache-TTL zu erzwingen, auch wenn 1-Stunden-TTL ansonsten gelten würde. Überschreibt `ENABLE_PROMPT_CACHING_1H` |


351| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von Remote-MCP-Servern (HTTP/SSE), die während des Starts parallel verbunden werden (Standard: 20) |357| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von Remote-MCP-Servern (HTTP/SSE), die während des Starts parallel verbunden werden (Standard: 20) |

352| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von lokalen MCP-Servern (stdio), die während des Starts parallel verbunden werden (Standard: 3) |358| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von lokalen MCP-Servern (stdio), die während des Starts parallel verbunden werden (Standard: 3) |

353| `MCP_TIMEOUT` | Timeout in Millisekunden für MCP-Server-Start (Standard: 30000 oder 30 Sekunden) |359| `MCP_TIMEOUT` | Timeout in Millisekunden für MCP-Server-Start (Standard: 30000 oder 30 Sekunden) |

354| `MCP_TOOL_TIMEOUT` | Timeout in Millisekunden für MCP-Tool-Ausführung (Standard: 100000000, etwa 28 Stunden). Ein pro-Server `timeout`-Feld in `.mcp.json` überschreibt dies für diesen Server. Für die Env-Variable werden Werte unter 1000 auf eine Sekunde begrenzt; für das pro-Server-Feld werden Werte unter 1000 ignoriert |360| `MCP_TOOL_TIMEOUT` | Timeout in Millisekunden für MCP-Tool-Ausführung (Standard: 100000000, etwa 28 Stunden). Ein pro-Server `timeout`-Feld in `.mcp.json` überschreibt dies für diesen Server. {/* min-version: 2.1.203 */}Ein Pro-Server-`timeout` von mindestens 1000 setzt auch das Mindest-Idle-Fenster für die Tool-Aufrufe dieses Servers, sodass `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` sie nie früher abbricht; dieser Floor 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 |

355| `NO_PROXY` | Liste von Domains und IPs, an die Anfragen direkt gestellt werden, wobei der Proxy umgangen wird |361| `NO_PROXY` | Liste von Domains und IPs, an die Anfragen direkt gestellt werden, wobei der Proxy umgangen wird |

356| `OTEL_LOG_ASSISTANT_RESPONSES` | {/* min-version: 2.1.193 */}Setzen Sie auf `1`, um den Text der Modell-Antwort auf `assistant_response` OpenTelemetry-Protokollereignissen einzubeziehen. Wenn nicht gesetzt, wird der Wert von `OTEL_LOG_USER_PROMPTS` verwendet. Setzen Sie auf `0`, um Antworten redigiert zu halten, auch wenn `OTEL_LOG_USER_PROMPTS` gesetzt ist. Erfordert Claude Code v2.1.193 oder später. Siehe [Überwachung](/de/monitoring-usage#assistant-response-event) |362| `OTEL_LOG_ASSISTANT_RESPONSES` | {/* min-version: 2.1.193 */}Setzen Sie auf `1`, um den Text der Modell-Antwort auf `assistant_response` OpenTelemetry-Protokollereignissen einzubeziehen. Wenn nicht gesetzt, wird der Wert von `OTEL_LOG_USER_PROMPTS` verwendet. Setzen Sie auf `0`, um Antworten redigiert zu halten, auch wenn `OTEL_LOG_USER_PROMPTS` gesetzt ist. Erfordert Claude Code v2.1.193 oder später. Siehe [Überwachung](/de/monitoring-usage#assistant-response-event) |

357| `OTEL_LOG_RAW_API_BODIES` | Geben Sie Anthropic Messages API-Anfrage- und Antwort-JSON als `api_request_body` / `api_response_body`-Protokollereignisse aus. Setzen Sie auf `1` für Inline-Texte, die auf 60 KB gekürzt sind, oder `file:<dir>`, um ungekürzte Texte auf die Festplatte zu schreiben und stattdessen einen `body_ref`-Pfad auszugeben. Standardmäßig deaktiviert; Texte enthalten die gesamte Konversationshistorie. Siehe [Überwachung](/de/monitoring-usage#api-request-body-event) |363| `OTEL_LOG_RAW_API_BODIES` | Geben Sie Anthropic Messages API-Anfrage- und Antwort-JSON als `api_request_body` / `api_response_body`-Protokollereignisse aus. Setzen Sie auf `1` für Inline-Texte, die auf 60 KB gekürzt sind, oder `file:<dir>`, um ungekürzte Texte auf die Festplatte zu schreiben und stattdessen einen `body_ref`-Pfad auszugeben. Standardmäßig deaktiviert; Texte enthalten die gesamte Konversationshistorie. Siehe [Überwachung](/de/monitoring-usage#api-request-body-event) |

358| `OTEL_LOG_TOOL_CONTENT` | Setzen Sie auf `1`, um Tool-Input- und Output-Inhalte in OpenTelemetry-Span-Ereignisse einzubeziehen. Standardmäßig deaktiviert, um sensible Daten zu schützen. Siehe [Überwachung](/de/monitoring-usage) |364| `OTEL_LOG_TOOL_CONTENT` | Setzen Sie auf `1`, um Tool-Input- und Output-Inhalte in OpenTelemetry-Span-Ereignisse einzubeziehen. Standardmäßig deaktiviert, um sensible Daten zu schützen. Siehe [Überwachung](/de/monitoring-usage) |

359| `OTEL_LOG_TOOL_DETAILS` | Setzen Sie auf `1`, um Tool-Input-Argumente, MCP-Servernamen, rohe Fehlerstrings bei Tool-Fehlern, die Verweigerungskategorie bei `api_refusal`-Ereignissen und andere Tool-Details in OpenTelemetry-Traces und Protokollen einzubeziehen. Standardmäßig deaktiviert, um PII zu schützen. Siehe [Überwachung](/de/monitoring-usage) |365| `OTEL_LOG_TOOL_DETAILS` | Setzen Sie auf `1`, um Tool-Input-Argumente, MCP-Servernamen, Benutzer-erstellte Workflow-Namen, rohe Fehlerstrings bei Tool-Fehlern, die Verweigerungskategorie bei `api_refusal`-Ereignissen und andere Tool-Details in OpenTelemetry-Traces und Protokollen einzubeziehen. Standardmäßig deaktiviert, um PII zu schützen. Siehe [Überwachung](/de/monitoring-usage) |

360| `OTEL_LOG_USER_PROMPTS` | Setzen Sie auf `1`, um Benutzer-Prompt-Text in OpenTelemetry-Traces und Protokollen einzubeziehen. Standardmäßig deaktiviert (Prompts werden redigiert). Siehe [Überwachung](/de/monitoring-usage) |366| `OTEL_LOG_USER_PROMPTS` | Setzen Sie auf `1`, um Benutzer-Prompt-Text in OpenTelemetry-Traces und Protokollen einzubeziehen. Standardmäßig deaktiviert (Prompts werden redigiert). Siehe [Überwachung](/de/monitoring-usage) |

361| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Setzen Sie auf `false`, um Account UUID aus Metrik-Attributen auszuschließen (Standard: enthalten). Siehe [Überwachung](/de/monitoring-usage) |367| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Setzen Sie auf `false`, um Account UUID aus Metrik-Attributen auszuschließen (Standard: enthalten). Siehe [Überwachung](/de/monitoring-usage) |

362| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}Setzen Sie auf `true`, um den Session-Einstiegspunkt in Metrik-Attributen einzubeziehen (Standard: ausgeschlossen). Hinzugefügt in v2.1.152. Siehe [Überwachung](/de/monitoring-usage) |368| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}Setzen Sie auf `true`, um den Session-Einstiegspunkt in Metrik-Attributen einzubeziehen (Standard: ausgeschlossen). Hinzugefügt in v2.1.152. Siehe [Überwachung](/de/monitoring-usage) |


366| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Überschreiben Sie das Zeichenbudget für Skill-Metadaten, die dem [Skill-Tool](/de/skills#control-who-invokes-a-skill) angezeigt werden. Das Budget skaliert dynamisch bei 1 % des Kontextfensters, mit einem Fallback von 8.000 Zeichen. Legacy-Name für Rückwärtskompatibilität beibehalten |372| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Überschreiben Sie das Zeichenbudget für Skill-Metadaten, die dem [Skill-Tool](/de/skills#control-who-invokes-a-skill) angezeigt werden. Das Budget skaliert dynamisch bei 1 % des Kontextfensters, mit einem Fallback von 8.000 Zeichen. Legacy-Name für Rückwärtskompatibilität beibehalten |

367| `TASK_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen in [Subagenten](/de/sub-agents)-Ausgabe vor Kürzung (Standard: 32000, Maximum: 160000). Bei Kürzung wird die vollständige Ausgabe auf der Festplatte gespeichert und der Pfad ist in der gekürzten Antwort enthalten |373| `TASK_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen in [Subagenten](/de/sub-agents)-Ausgabe vor Kürzung (Standard: 32000, Maximum: 160000). Bei Kürzung wird die vollständige Ausgabe auf der Festplatte gespeichert und der Pfad ist in der gekürzten Antwort enthalten |

368| `USE_BUILTIN_RIPGREP` | Setzen Sie auf `0`, um das systeminstallierte `rg` anstelle des in Claude Code enthaltenen `rg` zu verwenden |374| `USE_BUILTIN_RIPGREP` | Setzen Sie auf `0`, um das systeminstallierte `rg` anstelle des in Claude Code enthaltenen `rg` zu verwenden |

369| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Überschreiben Sie die Region für Claude 3.5 Haiku bei Verwendung von Vertex AI |375| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Überschreiben Sie die Region für Claude 3.5 Haiku bei Verwendung von Google Cloud's Agent Platform |

370| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Überschreiben Sie die Region für Claude 3.5 Sonnet bei Verwendung von Vertex AI |376| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Überschreiben Sie die Region für Claude 3.5 Sonnet bei Verwendung von Google Cloud's Agent Platform |

371| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Überschreiben Sie die Region für Claude 3.7 Sonnet bei Verwendung von Vertex AI |377| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Überschreiben Sie die Region für Claude 3.7 Sonnet bei Verwendung von Google Cloud's Agent Platform |

372| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Überschreiben Sie die Region für Claude 4.0 Opus bei Verwendung von Vertex AI |378| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Überschreiben Sie die Region für Claude 4.0 Opus bei Verwendung von Google Cloud's Agent Platform |

373| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Überschreiben Sie die Region für Claude 4.0 Sonnet bei Verwendung von Vertex AI |379| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Überschreiben Sie die Region für Claude 4.0 Sonnet bei Verwendung von Google Cloud's Agent Platform |

374| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Überschreiben Sie die Region für Claude 4.1 Opus bei Verwendung von Vertex AI |380| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Überschreiben Sie die Region für Claude 4.1 Opus bei Verwendung von Google Cloud's Agent Platform |

375| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Überschreiben Sie die Region für Claude Opus 4.5 bei Verwendung von Vertex AI |381| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Überschreiben Sie die Region für Claude Opus 4.5 bei Verwendung von Google Cloud's Agent Platform |

376| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Überschreiben Sie die Region für Claude Sonnet 4.5 bei Verwendung von Vertex AI |382| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Überschreiben Sie die Region für Claude Sonnet 4.5 bei Verwendung von Google Cloud's Agent Platform |

377| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Überschreiben Sie die Region für Claude Opus 4.6 bei Verwendung von Vertex AI |383| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Überschreiben Sie die Region für Claude Opus 4.6 bei Verwendung von Google Cloud's Agent Platform |

378| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Überschreiben Sie die Region für Claude Sonnet 4.6 bei Verwendung von Vertex AI |384| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Überschreiben Sie die Region für Claude Sonnet 4.6 bei Verwendung von Google Cloud's Agent Platform |

379| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Überschreiben Sie die Region für Claude Opus 4.7 bei Verwendung von Vertex AI. Hinzugefügt in v2.1.111 |385| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Überschreiben Sie die Region für Claude Opus 4.7 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.111 |

380| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Überschreiben Sie die Region für Claude Opus 4.8 bei Verwendung von Vertex AI. Hinzugefügt in v2.1.154 |386| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Überschreiben Sie die Region für Claude Opus 4.8 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.154 |

381| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Überschreiben Sie die Region für Claude Sonnet 5 bei Verwendung von Vertex AI. Hinzugefügt in v2.1.197 |387| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Überschreiben Sie die Region für Claude Sonnet 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.197 |

382| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Überschreiben Sie die Region für Claude Fable 5 bei Verwendung von Vertex AI. Hinzugefügt in v2.1.170 |388| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Überschreiben Sie die Region für Claude Fable 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.170 |

383| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Überschreiben Sie die Region für Claude Haiku 4.5 bei Verwendung von Vertex AI |389| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Überschreiben Sie die Region für Claude Haiku 4.5 bei Verwendung von Google Cloud's Agent Platform |

384 390 

385Standard-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 signalspezifische Varianten) werden ebenfalls unterstützt. Siehe [Überwachung](/de/monitoring-usage) für Konfigurationsdetails.391Standard-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 signalspezifische Varianten) werden ebenfalls unterstützt. Siehe [Überwachung](/de/monitoring-usage) für Konfigurationsdetails.

386 392 

errors.md +447 −239

Details

53| `SSL certificate verification failed` | [Netzwerk](#ssl-certificate-errors) |53| `SSL certificate verification failed` | [Netzwerk](#ssl-certificate-errors) |

54| `SSL certificate error (...)` during login or startup | [Netzwerk](#ssl-certificate-errors) |54| `SSL certificate error (...)` during login or startup | [Netzwerk](#ssl-certificate-errors) |

55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Netzwerk](#host-not-allowed-in-a-cloud-session) |55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Netzwerk](#host-not-allowed-in-a-cloud-session) |

56| `Couldn't reconnect to your Remote Control session` | [Netzwerk](#couldn%E2%80%99t-reconnect-to-your-remote-control-session) |

56| `Prompt is too long` | [Anfragefehler](#prompt-is-too-long) |57| `Prompt is too long` | [Anfragefehler](#prompt-is-too-long) |

57| `Error during compaction: Conversation too long` | [Anfragefehler](#error-during-compaction-conversation-too-long) |58| `Error during compaction: Conversation too long` | [Anfragefehler](#error-during-compaction-conversation-too-long) |

58| `Request too large` | [Anfragefehler](#request-too-large) |59| `Request too large` | [Anfragefehler](#request-too-large) |


61| `PDF too large` / `PDF is password protected` | [Anfragefehler](#pdf-errors) |62| `PDF too large` / `PDF is password protected` | [Anfragefehler](#pdf-errors) |

62| `Extra inputs are not permitted` | [Anfragefehler](#extra-inputs-are-not-permitted) |63| `Extra inputs are not permitted` | [Anfragefehler](#extra-inputs-are-not-permitted) |

63| `There's an issue with the selected model` | [Anfragefehler](#there%E2%80%99s-an-issue-with-the-selected-model) |64| `There's an issue with the selected model` | [Anfragefehler](#there%E2%80%99s-an-issue-with-the-selected-model) |

65| `Model ... is not a recognized model id` | [Anfragefehler](#model-is-not-a-recognized-model-id) |

64| `Claude Opus is not available with the Claude Pro plan` | [Anfragefehler](#claude-opus-is-not-available-with-the-claude-pro-plan) |66| `Claude Opus is not available with the Claude Pro plan` | [Anfragefehler](#claude-opus-is-not-available-with-the-claude-pro-plan) |

65| `Model ... is restricted by your organization's settings` | [Anfragefehler](#model-is-restricted-by-your-organization%E2%80%99s-settings) |67| `Model ... is restricted by your organization's settings` | [Anfragefehler](#model-is-restricted-by-your-organization%E2%80%99s-settings) |

66| `thinking.type.enabled is not supported for this model` | [Anfragefehler](#thinking-type-enabled-is-not-supported-for-this-model) |68| `thinking.type.enabled is not supported for this model` | [Anfragefehler](#thinking-type-enabled-is-not-supported-for-this-model) |

67| `max_tokens must be greater than thinking.budget_tokens` | [Anfragefehler](#thinking-budget-exceeds-output-limit) |69| `max_tokens must be greater than thinking.budget_tokens` | [Anfragefehler](#thinking-budget-exceeds-output-limit) |

68| `API Error: 400 due to tool use concurrency issues` | [Anfragefehler](#tool-use-or-thinking-block-mismatch) |70| `API Error: 400 due to tool use concurrency issues` | [Anfragefehler](#tool-use-or-thinking-block-mismatch) |

69| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Anfragefehler](#usage-policy-refusal) |71| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Anfragefehler](#usage-policy-refusal) |

72| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Anfragefehler](#safety-measures-flagged-a-cybersecurity-topic) |

73| `Installation was killed before it could finish (exit code 137)` | [Installationsfehler](#installation-was-killed-before-it-could-finish) |

74| `The connection dropped while downloading the update` | [Installationsfehler](#the-connection-dropped-while-downloading-the-update) |

75| `Download timed out: exceeded the total deadline` | [Installationsfehler](#the-connection-dropped-while-downloading-the-update) |

70| `--bg and --print conflict` | [Befehlszeilenfehler](#command-line-errors) |76| `--bg and --print conflict` | [Befehlszeilenfehler](#command-line-errors) |

77| `Error: --json-schema is not a valid JSON Schema` | [Befehlszeilenfehler](#command-line-errors) |

78| `Could not import <server>: <reason>` | [Befehlszeilenfehler](#could-not-import-a-server-from-claude-desktop) |

79| `Marketplace "<name>" is registered from an untrusted source` | [Plugin-Fehler](#marketplace-is-registered-from-an-untrusted-source) |

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

71| Responses seem lower quality than usual | [Antwortqualität](#responses-seem-lower-quality-than-usual) |81| Responses seem lower quality than usual | [Antwortqualität](#responses-seem-lower-quality-than-usual) |

72 82 

73<h2 id="automatic-retries">83<h2 id="automatic-retries">


99 Serverfehler109 Serverfehler

100</h2>110</h2>

101 111 

102Diese Fehler stammen vom Inferenz-Anbieter und nicht von Ihrem Konto oder Ihrer Anfrage. Bei der Anthropic API bedeutet das Anthropic-Infrastruktur. Bei Bedrock, Vertex AI, Foundry oder einem benutzerdefinierten Gateway bedeutet das die Infrastruktur dieses Anbieters.112Diese Fehler stammen vom Inferenzanbieter und nicht von Ihrem Konto oder Ihrer Anfrage. Bei der Anthropic API bedeutet das Anthropic-Infrastruktur. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem benutzerdefinierten Gateway bedeutet das die Infrastruktur dieses Anbieters.

103 113 

104<h3 id="api-error-500-internal-server-error">114<h3 id="api-error-500-internal-server-error">

105 API Error: 500 Internal server error115 API-Fehler: 500 Interner Serverfehler

106</h3>116</h3>

107 117 

108Claude Code zeigt den Statuscode und die Fehlermeldung der API für jede 5xx-Antwort an. Das folgende Beispiel zeigt eine 500-Antwort bei der Anthropic API:118Claude Code zeigt den Statuscode und die Fehlermeldung der API für jede 5xx-Antwort an. Das folgende Beispiel zeigt eine 500-Antwort auf der Anthropic API:

109 119 

110```text theme={null}120```text theme={null}

111API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.121API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

112```122```

113 123 

114Der abschließende Satz gibt an, wo die Dienststabilität überprüft werden kann, und variiert je nach Anbieter. Bedrock-, Vertex AI- und Foundry-Konfigurationen geben den Dienststatus dieses Anbieters an. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` gibt den Gateway-Host an.124Der abschließende Satz benennt, wo die Serviceintegrität überprüft werden kann, und variiert je nach Anbieter. Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry-Konfigurationen benennen die Servicestatuseite dieses Anbieters. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` benennt den Gateway-Host.

115 125 

116Dies zeigt einen unerwarteten Fehler in der API an. Er wird nicht durch Ihren Prompt, Ihre Einstellungen oder Ihr Konto verursacht.126Dies deutet auf einen unerwarteten Fehler innerhalb der API hin. Er wird nicht durch Ihren Prompt, Ihre Einstellungen oder Ihr Konto verursacht.

117 127 

118**Was zu tun ist:**128**Was zu tun ist:**

119 129 

120* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die in der Meldung genannte Statusseite des Anbieters auf aktive Vorfälle130* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die in der Meldung genannte Servicestatusseite des Anbieters auf aktive Vorfälle

121* Warten Sie eine Minute und senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht ist noch in der Konversation, daher können Sie für einen langen Prompt `try again` eingeben, anstatt das Ganze erneut einzufügen.131* Warten Sie eine Minute und senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht ist noch im Gespräch, sodass Sie bei einem langen Prompt `try again` eingeben können, anstatt alles erneut einzufügen.

122* Wenn der Fehler ohne veröffentlichten Vorfall weiterhin auftritt, führen Sie `/feedback` aus, damit Anthropic mit Ihren Anfrageinformationen untersuchen kann. Siehe [Fehler melden](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist.132* Wenn der Fehler ohne einen veröffentlichten Vorfall weiterhin auftritt, führen Sie `/feedback` aus, damit Anthropic Ihre Anfrageinformationen untersuchen kann. Siehe [Fehler melden](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist.

123 133 

124<h3 id="api-error-repeated-529-overloaded-errors">134<h3 id="api-error-repeated-529-overloaded-errors">

125 API Error: Repeated 529 Overloaded errors135 API-Fehler: Wiederholte 529 Overloaded-Fehler

126</h3>136</h3>

127 137 

128Die API ist vorübergehend über alle Benutzer hinweg ausgelastet. Claude Code hat bereits mehrmals versucht, bevor diese Meldung angezeigt wird:138Die API ist vorübergehend über alle Benutzer hinweg ausgelastet. Claude Code hat bereits mehrmals versucht, die Anfrage erneut zu senden, bevor diese Meldung angezeigt wird:

129 139 

130```text theme={null}140```text theme={null}

131API 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.141API 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.


133 143 

134Der abschließende Satz variiert je nach Anbieter auf die gleiche Weise wie der 500-Fehler oben.144Der abschließende Satz variiert je nach Anbieter auf die gleiche Weise wie der 500-Fehler oben.

135 145 

136Ein 529 ist nicht Ihr Nutzungslimit und wird nicht gegen Ihr Kontingent angerechnet.146Ein 529-Fehler ist nicht Ihr Nutzungslimit und wird nicht auf Ihr Kontingent angerechnet.

137 147 

138**Was zu tun ist:**148**Was zu tun ist:**

139 149 

140* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die in der Meldung genannte Statusseite des Anbieters auf Kapazitätsmitteilungen150* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die in der Meldung genannte Servicestatusseite des Anbieters auf Kapazitätsmitteilungen

141* Versuchen Sie es in ein paar Minuten erneut151* Versuchen Sie es in ein paar Minuten erneut

142* 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 ist, zum Beispiel `Opus is experiencing high load, please use /model to switch to Sonnet`.152* 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, zum Beispiel `Opus is experiencing high load, please use /model to switch to Sonnet`.

143 153 

144<h3 id="request-timed-out">154<h3 id="request-timed-out">

145 Request timed out155 Anfrage hat das Zeitlimit überschritten

146</h3>156</h3>

147 157 

148Die API hat nicht vor der Verbindungsfrist geantwortet.158Die API hat nicht vor der Verbindungsfrist geantwortet.


151Request timed out161Request timed out

152```162```

153 163 

154Dies kann während Zeiten hoher Last oder bei der Generierung einer sehr großen Antwort auftreten. Das Standard-Anfrage-Timeout beträgt 10 Minuten.164Dies kann während Zeiten hoher Last auftreten oder wenn das Modell eine sehr große Antwort generiert. Das Standard-Anfrage-Zeitlimit beträgt 10 Minuten.

155 165 

156**Was zu tun ist:**166**Was zu tun ist:**

157 167 

158* Wiederholen Sie die Anfrage168* Wiederholen Sie die Anfrage

159* Für langfristige Aufgaben teilen Sie die Arbeit in kleinere Prompts auf169* Teilen Sie die Arbeit bei langfristigen Aufgaben in kleinere Prompts auf

160* Wenn ein langsames Netzwerk oder Proxy die Ursache ist, erhöhen Sie `API_TIMEOUT_MS` wie in [Automatische Wiederholungen](#automatic-retries) beschrieben170* Wenn eine langsame Netzwerkverbindung oder ein Proxy die Ursache ist, erhöhen Sie `API_TIMEOUT_MS` wie in [Automatische Wiederholungen](#automatic-retries) beschrieben

161* Wenn Timeouts häufig sind und Ihr Netzwerk ansonsten gesund ist, siehe [Netzwerk- und Verbindungsfehler](#network-and-connection-errors) unten171* Wenn Zeitüberschreitungen häufig auftreten und Ihr Netzwerk ansonsten fehlerfrei ist, siehe [Netzwerk- und Verbindungsfehler](#network-and-connection-errors) unten

162 172 

163<h3 id="the-response-above-may-be-incomplete">173<h3 id="the-response-above-may-be-incomplete">

164 The response above may be incomplete174 Die obige Antwort kann unvollständig sein

165</h3>175</h3>

166 176 

167Eine Streaming-Antwort ist fehlgeschlagen, nachdem Claude bereits sichtbare Ausgabe erzeugt hatte. Das erneute Senden der Anfrage könnte die gleichen Tool-Aufrufe zweimal ausführen, daher behält Claude Code das bei, was bereits gestreamt wurde, und fügt stattdessen diese Benachrichtigung an. Welche Variante Sie sehen, benennt die Ursache:177Eine Streaming-Antwort ist fehlgeschlagen, nachdem Claude bereits sichtbare Ausgabe produziert hatte. Das erneute Senden der Anfrage könnte die gleichen Tool-Aufrufe zweimal ausführen, daher behält Claude Code das bereits Gestreamte und fügt stattdessen diese Mitteilung an, anstatt den Zug zu verwerfen. Welche Variante Sie sehen, benennt die Ursache:

168 178 

169```text theme={null}179```text theme={null}

170API Error: Server error mid-response. The response above may be incomplete.180API Error: Server error mid-response. The response above may be incomplete.


172API Error: Response stalled mid-stream. The response above may be incomplete.182API Error: Response stalled mid-stream. The response above may be incomplete.

173```183```

174 184 

175* {/* min-version: 2.1.199 */}}`Server error mid-response`: ein Mid-Stream-Überlastungs- oder 5xx-Serverfehler. Diese Variante erfordert Claude Code v2.1.199 oder später; davor verwarf dieser Fall die Teilausgabe und meldete den gesamten Turn als Fehler.185* {/* min-version: 2.1.199 */}`Server error mid-response`: ein Mid-Stream-Overloaded- oder 5xx-Serverfehler. Diese Variante erfordert Claude Code v2.1.199 oder später; davor verwarf dieser Fall die teilweise Ausgabe und meldete den gesamten Zug als Fehler.

176* `Connection closed mid-response`: die Verbindung wurde unterbrochen.186* `Connection closed mid-response`: die Verbindung wurde unterbrochen.

177* `Response stalled mid-stream`: der Stream hat aufgehört, Daten zu senden.187* `Response stalled mid-stream`: der Stream hat das Senden von Daten gestoppt.

178 188 

179**Was zu tun ist:**189**Was zu tun ist:**

180 190 

181* Lesen Sie die Antwort, die gestreamt wurde. Nichts ist verloren gegangen, aber die letzten Sätze oder Tool-Aufrufe könnten fehlen.191* Lesen Sie die Antwort, die gestreamt wurde. Nichts ist verloren gegangen, aber die letzten Sätze oder Tool-Aufrufe können fehlen.

182* Antworten Sie mit `continue`, damit Claude dort weitermacht, wo es aufgehört hat192* Antworten Sie mit `continue`, damit Claude dort weitermacht, wo es aufgehört hat

183* Wenn der gleiche Fehler vor sichtbarer Ausgabe angezeigt wird, wiederholt Claude Code die Anfrage, anstatt sie abzuschließen. Siehe [Automatische Wiederholungen](#automatic-retries).193* Wenn der gleiche Fehler vor einer sichtbaren Ausgabe auftritt, wiederholt Claude Code die Anfrage, anstatt sie abzuschließen. Siehe [Automatische Wiederholungen](#automatic-retries).

184 194 

185<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">195<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">

186 Auto mode cannot determine the safety of an action196 Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen

187</h3>197</h3>

188 198 

189Das Modell, das [auto mode](/de/permission-modes#eliminate-prompts-with-auto-mode) zur Klassifizierung von Aktionen verwendet, konnte keine Entscheidung treffen, daher hat auto mode die Aktion nicht automatisch genehmigt. Die Meldung, die Sie sehen, hängt davon ab, warum der Klassifizierer fehlgeschlagen ist.199Das Modell, das der [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) zur Klassifizierung von Aktionen verwendet, konnte keine Entscheidung treffen, daher genehmigte der Auto-Modus die Aktion nicht automatisch. Die Meldung, die Sie sehen, hängt davon ab, warum der Klassifizierer fehlgeschlagen ist.

190 200 

191Lesevorgänge, Suchen und Bearbeitungen in Ihrem Arbeitsverzeichnis überspringen den Klassifizierer, daher funktionieren sie in all diesen Fällen weiterhin.201Lesevorgänge, Suchen und Bearbeitungen in Ihrem Arbeitsverzeichnis überspringen den Klassifizierer, daher funktionieren sie in all diesen Fällen weiterhin.

192 202 


200 210 

201* Wiederholen Sie nach ein paar Sekunden; Claude sieht die gleiche Meldung und wiederholt normalerweise automatisch211* Wiederholen Sie nach ein paar Sekunden; Claude sieht die gleiche Meldung und wiederholt normalerweise automatisch

202* Wenn Wiederholungen weiterhin fehlschlagen, fahren Sie mit schreibgeschützten Aufgaben fort und kehren Sie später zur blockierten Aktion zurück212* Wenn Wiederholungen weiterhin fehlschlagen, fahren Sie mit schreibgeschützten Aufgaben fort und kehren Sie später zur blockierten Aktion zurück

203* Dies ist vorübergehend und nicht mit der [auto mode-Berechtigung](/de/permission-modes#eliminate-prompts-with-auto-mode) verbunden; Sie müssen die Einstellungen nicht ändern213* Dies ist vorübergehend und hängt nicht mit der [Auto-Modus-Berechtigung](/de/permission-modes#eliminate-prompts-with-auto-mode) zusammen; Sie müssen die Einstellungen nicht ändern

204 214 

205Wenn der Klassifizierer eine nicht analysierbare Antwort zurückgegeben hat:215Wenn der Klassifizierer eine nicht analysierbare Antwort zurückgegeben hat:

206 216 


213* Wiederholen Sie die Aktion; dies ist normalerweise beim nächsten Versuch erfolgreich223* Wiederholen Sie die Aktion; dies ist normalerweise beim nächsten Versuch erfolgreich

214* Führen Sie `claude --debug` aus und wiederholen Sie die Aktion, um die zugrunde liegende Klassifizierer-Antwort im Debug-Protokoll zu sehen224* Führen Sie `claude --debug` aus und wiederholen Sie die Aktion, um die zugrunde liegende Klassifizierer-Antwort im Debug-Protokoll zu sehen

215 225 

216Wenn eine separate API-Sicherheitsprüfung die Klassifizierer-Anfrage aufgrund früherer Konversationsinhalte blockiert hat:226Wenn eine separate API-Sicherheitsprüfung die Klassifizierer-Anfrage aufgrund früherer Gesprächsinhalte blockiert hat:

217 227 

218```text theme={null}228```text theme={null}

219Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details229Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details


221 231 

222**Was zu tun ist:**232**Was zu tun ist:**

223 233 

224* Dies ist keine Entscheidung über Ihre Aktion. Ein Sicherheitsfilter in der API wurde durch vorhandene Inhalte in Ihrer Konversation ausgelöst, als auto mode die Konversation an den Klassifizierer sendete234* Dies ist keine Entscheidung über Ihre Aktion. Inhalte, die bereits in Ihrem Gespräch vorhanden sind, haben einen Sicherheitsfilter auf der API ausgelöst, als der Auto-Modus das Gespräch an den Klassifizierer sendete

225* Wiederholung hilft nicht; der gleiche Konversationsinhalt löst den Filter erneut aus235* Eine Wiederholung hilft nicht; der gleiche Gesprächsinhalt löst den Filter erneut aus

226* Wechseln Sie zu einem anderen [Genehmigungsmodus](/de/permission-modes), damit Sie die Aktion bei Aufforderung genehmigen können, oder starten Sie eine neue Konversation ohne den auslösenden Inhalt236* Wechseln Sie zu einem anderen [Berechtigungsmodus](/de/permission-modes), damit Sie die Aktion bei Aufforderung genehmigen können, oder starten Sie ein neues Gespräch ohne den auslösenden Inhalt

227 237 

228Wenn die Konversation größer als das Kontextfenster des Klassifizierers geworden ist:238Wenn das Gespräch größer als das Kontextfenster des Klassifizierers geworden ist:

229 239 

230```text theme={null}240```text theme={null}

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

232```242```

233 243 

234In einer interaktiven Sitzung fällt auto mode auf eine normale Genehmigungsaufforderung für diese Aktion zurück, damit Sie sie manuell genehmigen oder ablehnen können. Im [nicht-interaktiven Modus](/de/headless) wird die Ausführung abgebrochen, da das Transkript nur wächst und Wiederholungen nicht erfolgreich sein können.244In einer interaktiven Sitzung fällt der Auto-Modus auf eine normale Berechtigungsaufforderung für diese Aktion zurück, damit Sie sie manuell genehmigen oder ablehnen können. Im [nicht-interaktiven Modus](/de/headless) wird die Ausführung abgebrochen, da das Transkript nur wächst und eine Wiederholung nicht erfolgreich sein kann.

235 245 

236**Was zu tun ist:**246**Was zu tun ist:**

237 247 

238* Genehmigen oder lehnen Sie die Aktion in der angezeigten Aufforderung ab248* Genehmigen oder lehnen Sie die Aktion in der angezeigten Aufforderung ab

239* Führen Sie `/compact` aus, um die Konversationsgröße zu reduzieren, damit nachfolgende Aktionen wieder in das Klassifizierer-Fenster passen249* Führen Sie `/compact` aus, um die Gesprächsgröße zu reduzieren, damit nachfolgende Aktionen wieder in das Klassifizierer-Fenster passen

240 250 

241<h3 id="agent-terminated-early-due-to-an-api-error">251<h3 id="agent-terminated-early-due-to-an-api-error">

242 Agent terminated early due to an API error252 Agent wurde aufgrund eines API-Fehlers vorzeitig beendet

243</h3>253</h3>

244 254 

245{/* min-version: 2.1.199 */}Eine [Subagenten](/de/sub-agents)-API-Anfrage ist terminal fehlgeschlagen, zum Beispiel weil ein Nutzungslimit erreicht wurde oder Wiederholungen für einen Serverfehler aufgebraucht wurden, daher hat der Subagent vor Abschluss seiner Aufgabe gestoppt. Diese Meldung erfordert Claude Code v2.1.199 oder später; davor wurde der API-Fehlertext an Claude zurückgegeben, als wäre er das Ergebnis des Subagenten.255{/* min-version: 2.1.199 */}Eine [Subagent](/de/sub-agents)-API-Anfrage ist terminal fehlgeschlagen, zum Beispiel weil ein Nutzungslimit erreicht wurde oder Wiederholungen für einen Serverfehler aufgebraucht wurden, daher stoppte der Subagent, bevor er seine Aufgabe beendete. Diese Meldung erfordert Claude Code v2.1.199 oder später; davor wurde der API-Fehlertext an Claude zurückgegeben, als wäre er das Ergebnis des Subagenten.

246 256 

247```text theme={null}257```text theme={null}

248Agent terminated early due to an API error: <error detail>258Agent terminated early due to an API error: <error detail>


250 260 

251**Was zu tun ist:**261**Was zu tun ist:**

252 262 

253* Ordnen Sie das Fehlerdetail nach dem Doppelpunkt seinem eigenen Abschnitt auf dieser Seite zu, wie [Nutzungslimits](#usage-limits) oder [Serverfehler](#server-errors), und folgen Sie den Schritten dieses Abschnitts263* Ordnen Sie die Fehlerdetails nach dem Doppelpunkt einem eigenen Abschnitt auf dieser Seite zu, wie z. B. [Nutzungslimits](#usage-limits) oder [Serverfehler](#server-errors), und folgen Sie den Schritten dieses Abschnitts

254* Sobald der zugrunde liegende Fehler behoben ist, bitten Sie Claude, die Aufgabe zu wiederholen oder [den Subagenten fortzusetzen](/de/sub-agents#resume-subagents)264* Sobald der zugrunde liegende Fehler behoben ist, bitten Sie Claude, die Aufgabe zu wiederholen oder den [Subagenten fortzusetzen](/de/sub-agents#resume-subagents)

255 265 

256Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Vordergrund-Subagenten unterbricht, der bereits Ausgabe erzeugt hat, erhält Claude diese Teilausgabe, die als unvollständig markiert ist, anstelle dieses Fehlers. Siehe [API-Fehler in Subagenten](/de/sub-agents#api-errors-in-subagents).266Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Vordergrund-Subagenten unterbricht, der bereits Textausgabe produziert hat, erhält Claude diese teilweise Ausgabe als unvollständig markiert, anstatt diesen Fehler. {/* min-version: 2.1.200 */}Ein Subagent, dessen einzige Ausgabe Tool-Aufrufe waren, erhält auch diesen Fehler; in v2.1.199 gab dies stattdessen ein leeres Teilergebnis zurück. Siehe [API-Fehler in Subagenten](/de/sub-agents#api-errors-in-subagents).

257 267 

258<h2 id="usage-limits">268<h2 id="usage-limits">

259 Nutzungslimits269 Nutzungslimits


262Diese Fehler bedeuten, dass ein Kontingent, das an Ihr Konto oder Ihren Plan gebunden ist, erreicht wurde. Sie unterscheiden sich von [Serverfehlern](#server-errors), die alle betreffen.272Diese Fehler bedeuten, dass ein Kontingent, das an Ihr Konto oder Ihren Plan gebunden ist, erreicht wurde. Sie unterscheiden sich von [Serverfehlern](#server-errors), die alle betreffen.

263 273 

264<h3 id="you’ve-hit-your-session-limit">274<h3 id="you’ve-hit-your-session-limit">

265 You've hit your session limit275 Sie haben Ihr Sitzungslimit erreicht

266</h3>276</h3>

267 277 

268Abonnementpläne enthalten ein rollendes Nutzungskontingent. Wenn es aufgebraucht ist, sehen Sie eine dieser Meldungen:278Abonnementpläne enthalten eine rollende Nutzungszuteilung. Wenn diese aufgebraucht ist, sehen Sie eine dieser Meldungen:

269 279 

270```text theme={null}280```text theme={null}

271You've hit your session limit · resets 3:45pm281You've hit your session limit · resets 3:45pm


273You've hit your Opus limit · resets 3:45pm283You've hit your Opus limit · resets 3:45pm

274```284```

275 285 

276Claude Code blockiert weitere Anfragen bis zur in der Meldung angezeigten Rückstellungszeit.286Claude Code blockiert weitere Anfragen bis zum in der Meldung angezeigten Zurücksetzzeitpunkt.

277 287 

278**Was zu tun ist:**288**Was Sie tun können:**

279 289 

280* Warten Sie auf die in der Fehlermeldung angezeigte Rückstellungszeit290* Warten Sie auf den im Fehler angezeigten Zurücksetzzeitpunkt

281* Führen Sie `/usage` aus, um Ihre Planlimits und deren Rückstellungszeiten anzuzeigen291* Führen Sie `/usage` aus, um Ihre Planlimits und deren Zurücksetzzeitpunkte anzuzeigen

282* Führen Sie `/usage-credits` aus, um zusätzliche Nutzung auf Pro und Max zu kaufen, oder um sie von Ihrem Administrator auf Team und Enterprise anzufordern. Siehe [Zusätzliche Nutzung für bezahlte Claude-Pläne](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) für die Abrechnung.292* Führen Sie `/usage-credits` aus, um zusätzliche Nutzung auf Pro und Max zu kaufen, oder fordern Sie diese von Ihrem Administrator auf Team und Enterprise an. Siehe [Nutzungsguthaben für bezahlte Pläne](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) für Informationen zur Abrechnung.

283* Um Ihren Plan für höhere Basislimits zu aktualisieren, siehe [claude.com/pricing](https://claude.com/pricing)293* Um Ihren Plan für höhere Basislimits zu aktualisieren, siehe [claude.com/pricing](https://claude.com/pricing)

284 294 

285Um Ihr verbleibendes Kontingent zu überwachen, bevor Sie das Limit erreichen, fügen Sie die `rate_limits`-Felder zu einer [benutzerdefinierten Statuszeile](/de/statusline#rate-limit-usage) hinzu, oder klicken Sie in der Desktop-App auf den [Nutzungsring](/de/desktop#check-usage) neben dem Modellwähler.295Um Ihre verbleibende Zuteilung zu überwachen, bevor Sie das Limit erreichen, fügen Sie die `rate_limits`-Felder zu einer [benutzerdefinierten Statuszeile](/de/statusline#rate-limit-usage) hinzu, oder klicken Sie in der Desktop-App auf den [Nutzungsring](/de/desktop#check-usage) neben dem Modellwähler.

286 296 

287<h3 id="usage-credits-required-for-1m-context">297<h3 id="usage-credits-required-for-1m-context">

288 Usage credits required for 1M context298 Nutzungsguthaben erforderlich für 1M-Kontext

289</h3>299</h3>

290 300 

291Das ausgewählte Modell verwendet das 1M-Token-Fenster mit erweitertem Kontext, und Ihr Plan enthält es nur über Nutzungsguthaben.301Das ausgewählte Modell verwendet das 1M-Token-Kontextfenster mit erweiterter Länge, und Ihr Plan enthält es nur über Nutzungsguthaben.

292 302 

293```text theme={null}303```text theme={null}

294API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context304API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

295```305```

296 306 

297Dies ist eine Berechtigungsprüfung, keine Kontingenterschöpfung. Sie wird ausgelöst, auch wenn Ihre Sitzungs- und Wochenkontingente noch Kapazität haben. Siehe [Erweiterter Kontext](/de/model-config#extended-context) für die Pläne, die 1M-Kontext direkt enthalten, und welche Nutzungsguthaben erfordern.307Dies ist eine Berechtigungsprüfung, keine Kontingenterschöpfung. Sie wird auch dann ausgelöst, wenn Ihre Sitzungs- und Wochenzuteilungen noch Kapazität haben. Siehe [Erweiterter Kontext](/de/model-config#extended-context) für Informationen darüber, welche Pläne 1M-Kontext direkt enthalten und welche Nutzungsguthaben erfordern.

298 308 

299{/* min-version: 2.1.172 */}Wenn dieser Fehler während eines Gesprächs auftritt, weil der Kontext über 200K Token hinauswächst, komprimiert Claude Code das Gespräch automatisch zurück unter das Standard-Kontextlimit und behält die Sitzung danach auf diesem Limit, sodass keine Aktion erforderlich ist. In Versionen vor v2.1.172 wiederholte sich der Fehler bei jeder nachfolgenden Anfrage einschließlich `/compact`; führen Sie `/clear` in diesen Versionen aus, um die Wiederherstellung durchzuführen. Die folgenden Schritte gelten, wenn Sie explizit ein `[1m]`-Modell ausgewählt haben.309{/* min-version: 2.1.172 */}Wenn dieser Fehler während eines Gesprächs 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, sodass keine Aktion erforderlich ist. In Versionen vor v2.1.172 wiederholte sich der Fehler bei jeder nachfolgenden Anfrage einschließlich `/compact`; führen Sie `/clear` in diesen Versionen aus, um die Funktion wiederherzustellen. Die folgenden Schritte gelten, wenn Sie explizit ein `[1m]`-Modell ausgewählt haben.

300 310 

301**Was zu tun ist:**311**Was Sie tun können:**

302 312 

303* Führen Sie `/model` aus und wählen Sie die Variante ohne das `[1m]`-Suffix, um auf das Standard-Kontextfenster zurückzugreifen313* Führen Sie `/model` aus und wählen Sie die Variante ohne das `[1m]`-Suffix, um auf das Standard-Kontextfenster zurückzufallen

304* Führen Sie `/usage-credits` aus, um die getaktete Abrechnung für die 1M-Variante auf Pro und Max zu aktivieren, oder um sie von Ihrem Administrator auf Team und Enterprise anzufordern314* Führen Sie `/usage-credits` aus, um die getaktete Abrechnung für die 1M-Variante auf Pro und Max zu aktivieren, oder fordern Sie diese von Ihrem Administrator auf Team und Enterprise an

305* Wenn der Fehler nach `/model` weiterhin auftritt, kann eine 1M-Modell-ID an anderer Stelle festgelegt sein. Siehe [Es gibt ein Problem mit dem ausgewählten Modell](#there%E2%80%99s-an-issue-with-the-selected-model) für die Konfigurationsorte, die in Prioritätsreihenfolge überprüft werden sollen.315* Wenn der Fehler nach `/model` weiterhin besteht, kann eine 1M-Modell-ID an anderer Stelle festgelegt sein. Siehe [Es gibt ein Problem mit dem ausgewählten Modell](#there%E2%80%99s-an-issue-with-the-selected-model) für die Konfigurationsorte, die in Prioritätsreihenfolge zu überprüfen sind.

306* Um 1M-Varianten vollständig aus dem Modellwähler zu entfernen, setzen Sie [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/de/env-vars)316* Um 1M-Varianten vollständig aus dem Modellwähler zu entfernen, setzen Sie [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/de/env-vars)

307 317 

308<h3 id="server-is-temporarily-limiting-requests">318<h3 id="server-is-temporarily-limiting-requests">

309 Server is temporarily limiting requests319 Server drosselt Anfragen vorübergehend

310</h3>320</h3>

311 321 

312Die API hat eine kurzfristige Drosselung angewendet, die nicht mit Ihrem Plankontingent zusammenhängt.322Die API hat eine kurzlebige Drosselung angewendet, die nicht mit Ihrem Plankontingent zusammenhängt.

313 323 

314```text theme={null}324```text theme={null}

315API Error: Server is temporarily limiting requests (not your usage limit)325API Error: Server is temporarily limiting requests (not your usage limit)

316```326```

317 327 

318Claude Code unterscheidet diese von Ihrem Planlimit durch das Fehlen der einheitlichen Quota-Header, die eine echte Limit-Antwort trägt. {/* min-version: 2.1.199 */}Ab v2.1.199 wird dies [automatisch wiederholt](#automatic-retries) mit Backoff, bevor es angezeigt wird, unabhängig davon, wie Sie sich authentifizieren. In früheren Versionen schlugen Sitzungen, die mit einem claude.ai-Abonnement angemeldet waren, beim ersten Auftreten fehl; nur API-Schlüssel- und Enterprise-Anmeldungen wiederholten es.328Claude Code unterscheidet diese von Ihrem Planlimit durch das Fehlen der einheitlichen Kontingent-Header, die eine echte Limit-Antwort trägt. {/* min-version: 2.1.199 */}Ab v2.1.199 wird dies [automatisch erneut versucht](#automatic-retries) mit Backoff, bevor es angezeigt wird, unabhängig davon, wie Sie sich authentifizieren. In früheren Versionen schlug eine Sitzung, die mit einem claude.ai-Abonnement angemeldet war, beim ersten Auftreten fehl; nur API-Schlüssel und Enterprise-Anmeldungen wiederholten den Versuch.

319 329 

320**Was zu tun ist:**330**Was Sie tun können:**

321 331 

322* Warten Sie kurz und versuchen Sie es erneut332* Warten Sie kurz und versuchen Sie es erneut

323* Überprüfen Sie [status.claude.com](https://status.claude.com), wenn es weiterhin auftritt333* Überprüfen Sie [status.claude.com](https://status.claude.com), wenn das Problem weiterhin besteht

324 334 

325<h3 id="request-rejected-429">335<h3 id="request-rejected-429">

326 Request rejected (429)336 Anfrage abgelehnt (429)

327</h3>337</h3>

328 338 

329Sie haben das für Ihren API-Schlüssel, Ihr Amazon Bedrock-Projekt oder Ihr Google Vertex AI-Projekt konfigurierte Ratenlimit erreicht.339Sie haben das für Ihren API-Schlüssel, Ihr Amazon Bedrock-Projekt oder Ihr Google Cloud-Projekt konfigurierte Ratenlimit erreicht.

330 340 

331```text theme={null}341```text theme={null}

332API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.342API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

333```343```

334 344 

335Der nachfolgende Satz benennt, wo die Dienststabilität überprüft werden kann, und variiert je nach Anbieter. Bedrock-, Vertex AI- und Foundry-Konfigurationen benennen stattdessen die Dienststatus-Seite dieses Anbieters anstelle der Anthropic-Statusseite. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` benennt den Gateway-Host.345Der nachfolgende Satz benennt, wo die Serviceintegrität überprüft werden kann, und variiert je nach Anbieter. Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry-Konfigurationen benennen stattdessen die Servicestatusseite dieses Anbieters anstelle der Anthropic-Statusseite. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` benennt den Gateway-Host.

336 346 

337**Was zu tun ist:**347**Was Sie tun können:**

338 348 

339* Führen Sie `/status` aus und bestätigen Sie, dass die aktive Anmeldeinformation die ist, die Sie erwarten. Ein verwaister `ANTHROPIC_API_KEY` in Ihrer Umgebung kann Anfragen durch einen Low-Tier-Schlüssel statt durch Ihr Abonnement leiten.349* Führen Sie `/status` aus und bestätigen Sie, dass die aktive Anmeldeinformation die ist, die Sie erwarten. Ein verwaister `ANTHROPIC_API_KEY` in Ihrer Umgebung kann Anfragen über einen Low-Tier-Schlüssel statt über Ihr Abonnement leiten.

340* Überprüfen Sie Ihre Anbieter-Konsole auf die aktiven Limits und fordern Sie einen höheren Tier an, falls erforderlich350* Überprüfen Sie Ihre Anbieter-Konsole auf die aktiven Limits und fordern Sie einen höheren Tier an, falls erforderlich

341* Für Anthropic API-Schlüssel siehe die [Ratenlimit-Referenz](https://platform.claude.com/docs/en/api/rate-limits) für die Funktionsweise von Tiers und wie Sie Pro-Workspace-Limits setzen351* Für Anthropic API-Schlüssel siehe die [Ratenlimit-Referenz](https://platform.claude.com/docs/en/api/rate-limits) für Informationen zur Funktionsweise von Tiers und zum Festlegen von Pro-Workspace-Limits

342* Reduzieren Sie die Parallelität: senken Sie [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/de/env-vars), vermeiden Sie die Ausführung vieler paralleler Subagenten, oder wechseln Sie mit `/model` zu einem kleineren Modell für Hochvolumen-Skriptläufe352* Reduzieren Sie die Parallelität: senken Sie [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/de/env-vars), vermeiden Sie die Ausführung vieler paralleler Subagenten, oder wechseln Sie mit `/model` zu einem kleineren Modell für Läufe mit hohem Volumen

343 353 

344<h3 id="credit-balance-is-too-low">354<h3 id="credit-balance-is-too-low">

345 Credit balance is too low355 Guthabensaldo ist zu niedrig

346</h3>356</h3>

347 357 

348Ihre Console-Organisation hat keine vorausbezahlten Guthaben mehr.358Ihre Console-Organisation hat die vorausbezahlten Guthaben aufgebraucht.

349 359 

350```text theme={null}360```text theme={null}

351Credit balance is too low361Credit balance is too low

352```362```

353 363 

354**Was zu tun ist:**364**Was Sie tun können:**

355 365 

356* Fügen Sie Guthaben unter [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) hinzu, und erwägen Sie, dort Auto-Reload zu aktivieren, damit das Guthaben aufgefüllt wird, bevor es null erreicht366* Fügen Sie Guthaben unter [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) hinzu, und erwägen Sie, dort das automatische Nachladen zu aktivieren, damit der Saldo aufgefüllt wird, bevor er null erreicht

357* Wechseln Sie mit `/login` zur Abonnement-Authentifizierung, wenn Sie einen Pro-, Max-, Team- oder Enterprise-Plan haben367* Wechseln Sie mit `/login` zur Abonnement-Authentifizierung, wenn Sie einen Pro-, Max-, Team- oder Enterprise-Plan haben

358* Legen Sie Pro-Workspace-Ausgabenlimits in der Console fest, um zu verhindern, dass ein einzelnes Projekt das Org-Guthaben aufbraucht. Siehe [Kosten effektiv verwalten](/de/costs).368* Legen Sie Pro-Workspace-Ausgabenlimits in der Console fest, um zu verhindern, dass ein einzelnes Projekt das Organisationsguthaben aufbraucht. Siehe [Kosten effektiv verwalten](/de/costs).

359 369 

360<h2 id="authentication-errors">370<h2 id="authentication-errors">

361 Authentifizierungsfehler371 Authentifizierungsfehler

362</h2>372</h2>

363 373 

364Diese Fehler bedeuten, dass Claude Code nicht nachweisen kann, wer Sie für die API sind. Führen Sie `/status` jederzeit aus, um zu sehen, welche Anmeldeinformation derzeit aktiv ist.374Diese Fehler bedeuten, dass Claude Code nicht nachweisen kann, wer Sie gegenüber der API sind. Führen Sie jederzeit `/status` aus, um zu sehen, welche Anmeldedaten derzeit aktiv sind.

365 375 

366<h3 id="not-logged-in">376<h3 id="not-logged-in">

367 Not logged in377 Nicht angemeldet

368</h3>378</h3>

369 379 

370Für diese Sitzung ist keine gültige Anmeldeinformation verfügbar.380Für diese Sitzung ist keine gültige Anmeldedaten verfügbar.

371 381 

372```text theme={null}382```text theme={null}

373Not logged in · Please run /login383Not logged in · Please run /login


375 385 

376**Was zu tun ist:**386**Was zu tun ist:**

377 387 

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

379* 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 haben389* 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

380* Für CI oder Automatisierung, bei der interaktive Anmeldung nicht möglich ist, konfigurieren Sie ein [`apiKeyHelper`](/de/settings#available-settings)-Skript, das beim Start einen Schlüssel abruft390* Für CI oder Automatisierung, bei der interaktive Anmeldung nicht möglich ist, konfigurieren Sie ein [`apiKeyHelper`](/de/settings#available-settings)-Skript, das beim Start einen Schlüssel abruft

381* Siehe [Authentifizierungspriorität](/de/authentication#authentication-precedence), um zu verstehen, welche Anmeldeinformation gewinnt, wenn mehrere vorhanden sind391* Siehe [Authentifizierungspriorität](/de/authentication#authentication-precedence), um zu verstehen, welche Anmeldedaten Claude Code verwendet, wenn mehrere vorhanden sind

382 392 

383Wenn Sie wiederholt aufgefordert werden, sich anzumelden, siehe [Not logged in or token expired](/de/troubleshoot-install#not-logged-in-or-token-expired) für Systemuhr- und macOS Keychain-Fixes.393Wenn Sie wiederholt zur Anmeldung aufgefordert werden, siehe [Nicht angemeldet oder Token abgelaufen](/de/troubleshoot-install#not-logged-in-or-token-expired) für Systemuhr- und macOS-Keychain-Korrektionen.

384 394 

385<h3 id="could-not-resolve-authentication-method">395<h3 id="could-not-resolve-authentication-method">

386 Could not resolve authentication method396 Authentifizierungsmethode konnte nicht aufgelöst werden

387</h3>397</h3>

388 398 

389Die Sitzung erreichte den API-Client ohne Anmeldeinformation. Dies wird in [Hintergrundsitzungen](/de/agent-view), Cloud-Sitzungen und Agent SDK-Kontexten angezeigt, in denen die interaktive Anmeldungsprüfung nicht vor der ersten Anfrage ausgeführt wird.399Die Sitzung erreichte den API-Client ohne Anmeldedaten. Dies erscheint in [Hintergrundsitzungen](/de/agent-view), Cloud-Sitzungen und Agent-SDK-Kontexten, bei denen die interaktive Anmeldungsprüfung nicht vor der ersten Anfrage ausgeführt wird.

390 400 

391```text theme={null}401```text theme={null}

392Could 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 omitted402Could 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

393```403```

394 404 

395{/* min-version: 2.1.174 */}Vor v2.1.174 konnte eine Hintergrund- oder Cloud-Sitzung, die einem untätigen vorinitialisiertem Worker zugewiesen war, auf diese Weise fehlschlagen, selbst wenn gültige Anmeldeinformationen konfiguriert waren. Führen Sie ein Upgrade durch, um die Funktion wiederherzustellen. In aktuellen Versionen bedeutet der Fehler, dass dem Worker-Prozess keine Anmeldeinformation verfügbar war.405{/* min-version: 2.1.174 */}Vor v2.1.174 konnte eine Hintergrund- oder Cloud-Sitzung, die einem untätigen vorinitialisiertem Worker zugewiesen war, auf diese Weise fehlschlagen, selbst wenn gültige Anmeldedaten konfiguriert waren. Führen Sie ein Upgrade durch, um die Funktion wiederherzustellen. In aktuellen Versionen bedeutet der Fehler, dass dem Worker-Prozess keine Anmeldedaten verfügbar waren.

396 406 

397**Was zu tun ist:**407**Was zu tun ist:**

398 408 

399* Führen Sie ein Upgrade auf v2.1.174 oder später durch, wenn dies in einer Hintergrund- oder Cloud-Sitzung angezeigt wird und Ihre Anmeldeinformationen bereits konfiguriert sind409* Führen Sie ein Upgrade auf v2.1.174 oder später durch, wenn dies in einer Hintergrund- oder Cloud-Sitzung angezeigt wird und Ihre Anmeldedaten bereits konfiguriert sind

400* Bestätigen Sie, dass `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` oder Ihre Cloud-Provider-Anmeldeinformationen in der Umgebung gesetzt sind, die den Worker startet, nicht nur in Ihrer interaktiven Shell410* Bestätigen Sie, dass `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` oder Ihre Cloud-Provider-Anmeldedaten in der Umgebung gesetzt sind, die den Worker startet, nicht nur in Ihrer interaktiven Shell

401* Für das Agent SDK siehe [Authentifizierungseinrichtung](/de/agent-sdk/overview#get-started)411* Für das Agent SDK siehe [Authentifizierungseinrichtung](/de/agent-sdk/overview#get-started)

402* Führen Sie `/status` in einer interaktiven Sitzung in der gleichen Umgebung aus, um zu bestätigen, welche Anmeldeinformationsquelle aufgelöst wird412* Führen Sie `/status` in einer interaktiven Sitzung in derselben Umgebung aus, um zu bestätigen, welche Anmeldedatenquelle aufgelöst wird

403 413 

404<h3 id="invalid-api-key">414<h3 id="invalid-api-key">

405 Invalid API key415 Ungültiger API-Schlüssel

406</h3>416</h3>

407 417 

408Die Umgebungsvariable `ANTHROPIC_API_KEY` oder das `apiKeyHelper`-Skript hat einen Schlüssel zurückgegeben, den die API abgelehnt hat.418Die Umgebungsvariable `ANTHROPIC_API_KEY` oder das `apiKeyHelper`-Skript hat einen Schlüssel zurückgegeben, den die API abgelehnt hat.


414**Was zu tun ist:**424**Was zu tun ist:**

415 425 

416* Überprüfen Sie auf Tippfehler und bestätigen Sie, dass der Schlüssel nicht in der [Console](https://platform.claude.com/settings/keys) widerrufen wurde426* Überprüfen Sie auf Tippfehler und bestätigen Sie, dass der Schlüssel nicht in der [Console](https://platform.claude.com/settings/keys) widerrufen wurde

417* Führen Sie `env | grep ANTHROPIC` in der gleichen Shell aus. Tools wie direnv, dotenv Shell-Plugins und IDE-Terminals können einen veralteten Schlüssel aus einer `.env`-Datei in Ihrem Projekt laden, ohne dass Sie ihn explizit setzen427* Führen Sie `env | grep ANTHROPIC` in derselben Shell aus. Tools wie direnv, dotenv-Shell-Plugins und IDE-Terminals können einen veralteten Schlüssel aus einer `.env`-Datei in Ihrem Projekt laden, ohne dass Sie ihn explizit setzen

418* Heben Sie `ANTHROPIC_API_KEY` auf und führen Sie `/login` aus, um stattdessen Abonnement-Authentifizierung zu verwenden428* Heben Sie `ANTHROPIC_API_KEY` auf und führen Sie `/login` aus, um stattdessen Abonnement-Authentifizierung zu verwenden

419* Wenn der Schlüssel von einem [`apiKeyHelper`](/de/settings#available-settings)-Skript stammt, führen Sie das Skript direkt aus, um zu bestätigen, dass es einen gültigen Schlüssel auf stdout ausgibt429* Wenn der Schlüssel von einem [`apiKeyHelper`](/de/settings#available-settings)-Skript stammt, führen Sie das Skript direkt aus, um zu bestätigen, dass es einen gültigen Schlüssel auf stdout ausgibt

420* Führen Sie `/status` aus, um zu bestätigen, welche Anmeldeinformationsquelle Claude Code tatsächlich verwendet430* Führen Sie `/status` aus, um zu bestätigen, welche Anmeldedatenquelle Claude Code tatsächlich verwendet

421 431 

422<h3 id="this-organization-has-been-disabled">432<h3 id="this-organization-has-been-disabled">

423 This organization has been disabled433 Diese Organisation wurde deaktiviert

424</h3>434</h3>

425 435 

426Ein veralteter `ANTHROPIC_API_KEY` von einer deaktivierten Console-Organisation überschreibt Ihre Abonnement-Anmeldung.436Ein veralteter `ANTHROPIC_API_KEY` von einer deaktivierten Console-Organisation überschreibt Ihre Abonnement-Anmeldung.


430API Error: 400 ... This organization has been disabled.440API Error: 400 ... This organization has been disabled.

431```441```

432 442 

433Umgebungsvariablen haben Vorrang vor `/login`, daher wird ein Schlüssel, der in Ihrem Shell-Profil exportiert oder aus einer `.env`-Datei geladen wird, verwendet, auch wenn Sie ein funktionierendes Pro- oder Max-Abonnement haben. Im nicht-interaktiven Modus (`-p`) wird der Schlüssel immer verwendet, wenn er vorhanden ist.443Umgebungsvariablen haben Vorrang vor `/login`, daher wird ein Schlüssel, der in Ihrem Shell-Profil exportiert oder aus einer `.env`-Datei geladen wird, verwendet, selbst wenn Sie ein funktionierendes Pro- oder Max-Abonnement haben. Im nicht-interaktiven Modus (`-p`) wird der Schlüssel immer verwendet, wenn er vorhanden ist.

434 444 

435**Was zu tun ist:**445**Was zu tun ist:**

436 446 

437* Heben Sie `ANTHROPIC_API_KEY` in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil, dann starten Sie `claude` neu447* Heben Sie `ANTHROPIC_API_KEY` in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil, dann starten Sie `claude` neu

438* Führen Sie danach `/status` aus, um zu bestätigen, dass die aktive Anmeldeinformation Ihr Abonnement ist448* Führen Sie danach `/status` aus, um zu bestätigen, dass die aktive Anmeldedaten Ihr Abonnement sind

439* Wenn keine Umgebungsvariable gesetzt ist und der Fehler weiterhin auftritt, ist die deaktivierte Organisation die, die an Ihrem `/login` gebunden ist. Kontaktieren Sie den Support oder melden Sie sich mit einem anderen Konto an.449* Wenn keine Umgebungsvariable gesetzt ist und der Fehler weiterhin besteht, ist die deaktivierte Organisation diejenige, die mit Ihrem `/login` verknüpft ist. Kontaktieren Sie den Support oder melden Sie sich mit einem anderen Konto an.

440 450 

441<h3 id="your-organization-has-disabled-api-key-authentication">451<h3 id="your-organization-has-disabled-api-key-authentication">

442 Your organization has disabled API key authentication452 Ihre Organisation hat die API-Schlüssel-Authentifizierung deaktiviert

443</h3>453</h3>

444 454 

445Ihr Console-Organisationsadministrator hat die API-Schlüssel-Authentifizierung deaktiviert, daher lehnt die API den Schlüssel ab, den Claude Code sendet. Der Wiederherstellungshinweis nach dem `·` variiert je nachdem, woher der Schlüssel stammt:455Diese Meldung erfordert Claude Code v2.1.169 oder später. Der Administrator Ihrer Console-Organisation hat die API-Schlüssel-Authentifizierung deaktiviert, daher lehnt die API den Schlüssel ab, den Claude Code sendet. Der Wiederherstellungshinweis nach dem `·` variiert je nachdem, woher der Schlüssel stammt:

446 456 

447```text theme={null}457```text theme={null}

448Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account458Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account


455 465 

456**Was zu tun ist:**466**Was zu tun ist:**

457 467 

458* Wenn die Nachricht `ANTHROPIC_API_KEY` nennt, heben Sie es in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil oder der `.env`-Datei, dann starten Sie `claude` neu468* Wenn die Meldung `ANTHROPIC_API_KEY` nennt, heben Sie es in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil oder `.env`-Datei, dann starten Sie `claude` neu

459* Wenn die Nachricht `apiKeyHelper` nennt, entfernen Sie die [`apiKeyHelper`](/de/settings#available-settings)-Einstellung aus Ihrer `settings.json`469* Wenn die Meldung `apiKeyHelper` nennt, entfernen Sie die [`apiKeyHelper`](/de/settings#available-settings)-Einstellung aus Ihrer `settings.json`

460* Führen Sie `/login` aus, um sich mit Ihrem claude.ai-Konto anzumelden470* Führen Sie `/login` aus, um sich mit Ihrem claude.ai-Konto anzumelden

461* Führen Sie danach `/status` aus, um zu bestätigen, dass die aktive Anmeldeinformation Ihr Abonnement ist und nicht ein API-Schlüssel471* Führen Sie danach `/status` aus, um zu bestätigen, dass die aktive Anmeldedaten Ihr Abonnement und nicht ein API-Schlüssel sind

462* Wenn Sie API-Schlüssel-Authentifizierung für Automatisierung benötigen, bitten Sie Ihren Organisationsadministrator, sie in der Console erneut zu aktivieren472* Wenn Sie API-Schlüssel-Authentifizierung für Automatisierung benötigen, bitten Sie Ihren Organisations-Administrator, sie in der Console erneut zu aktivieren

463 473 

464<h3 id="your-organization-has-disabled-claude-subscription-access">474<h3 id="your-organization-has-disabled-claude-subscription-access">

465 Your organization has disabled Claude subscription access475 Ihre Organisation hat den Claude-Abonnementzugriff deaktiviert

466</h3>476</h3>

467 477 

468Ihre Claude-Organisation erlaubt die Anmeldung bei Claude Code nicht mit einer Abonnement-Anmeldung. Das erneute Ausführen von `/login` mit demselben Konto gibt denselben Fehler zurück.478Ihre Claude-Organisation erlaubt nicht, sich bei Claude Code mit einer Abonnement-Anmeldung anzumelden. Das erneute Ausführen von `/login` mit demselben Konto gibt denselben Fehler zurück.

469 479 

470```text theme={null}480```text theme={null}

471Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access481Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access


473 483 

474Dies ist eine serverseitige Organisationseinstellung, daher kann sie nicht durch lokale Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden.484Dies ist eine serverseitige Organisationseinstellung, daher kann sie nicht durch lokale Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden.

475 485 

476Das Agent SDK und `-p` nicht-interaktiver Modus zeigen dies als Fehlercode `oauth_org_not_allowed` an.486Das Agent SDK und der `-p` nicht-interaktive Modus zeigen dies als `oauth_org_not_allowed`-Fehlercode an.

477 487 

478**Was zu tun ist:**488**Was zu tun ist:**

479 489 

480* Bitten Sie Ihren Administrator, Claude Code-Zugriff für Ihre Organisation zu aktivieren490* Bitten Sie Ihren Administrator, den Claude-Code-Zugriff für Ihre Organisation zu aktivieren

481* Authentifizieren Sie sich stattdessen mit einem Console API-Schlüssel anstelle Ihres Abonnements. Siehe [Claude Console-Authentifizierung](/de/authentication#claude-console-authentication) für die Einrichtung.491* Authentifizieren Sie sich stattdessen mit einem Console-API-Schlüssel anstelle Ihres Abonnements. Siehe [Claude-Console-Authentifizierung](/de/authentication#claude-console-authentication) für die Einrichtung.

482* Wenn Sie der Administrator sind und keine Option zum Aktivieren des Zugriffs sehen, kontaktieren Sie [Anthropic-Support](https://support.claude.com)492* Wenn Sie der Administrator sind und keine Option zum Aktivieren des Zugriffs sehen, kontaktieren Sie den [Anthropic-Support](https://support.claude.com)

483 493 

484<h3 id="routines-are-disabled-by-your-organization’s-policy">494<h3 id="routines-are-disabled-by-your-organization’s-policy">

485 Routines are disabled by your organization's policy495 Routinen sind durch die Richtlinie Ihrer Organisation deaktiviert

486</h3>496</h3>

487 497 

488Ein Owner in Ihrer Team- oder Enterprise-Organisation hat Routinen auf Organisationsebene deaktiviert. Der Fehler wird angezeigt, wenn Sie versuchen, eine Routine zu erstellen oder auszuführen, einschließlich von `/schedule` und der [Routines](/de/routines)-Benutzeroberfläche auf claude.ai/code.498Ein Eigentümer in Ihrer Team- oder Enterprise-Organisation hat Routinen auf Organisationsebene deaktiviert. Der Fehler erscheint, wenn Sie versuchen, eine Routine zu erstellen oder auszuführen, einschließlich von `/schedule` und der [Routinen](/de/routines)-Benutzeroberfläche auf claude.ai/code.

489 499 

490```text theme={null}500```text theme={null}

491Routines are disabled by your organization's policy.501Routines are disabled by your organization's policy.


495 505 

496**Was zu tun ist:**506**Was zu tun ist:**

497 507 

498* Bitten Sie einen Owner in Ihrer Organisation, den **Routines**-Schalter unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) zu aktivieren508* 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 aktivieren

499* Für einmalige geplante Arbeiten, die keine Routinen auf Organisationsebene erfordern, siehe [geplante Aufgaben](/de/scheduled-tasks)509* Für einmalige geplante Arbeiten, die keine Routinen auf Organisationsebene erfordern, siehe [geplante Aufgaben](/de/scheduled-tasks)

500 510 

501<h3 id="remote-control-requires-the-anthropic-api">511<h3 id="remote-control-requires-the-anthropic-api">

502 Remote Control requires the Anthropic API512 Remote Control erfordert die Anthropic API

503</h3>513</h3>

504 514 

505Die Sitzung spricht nicht direkt mit der Anthropic API, daher gibt es kein claude.ai-Backend für [Remote Control](/de/remote-control) zum Koppeln.515Die Sitzung spricht nicht direkt mit der Anthropic API, daher gibt es kein claude.ai-Backend für [Remote Control](/de/remote-control) zum Koppeln.


508Remote Control is only available when using Claude via api.anthropic.com.518Remote Control is only available when using Claude via api.anthropic.com.

509```519```

510 520 

511Dies wird auf Amazon Bedrock, Google Vertex AI und Microsoft Foundry angezeigt. {/* min-version: 2.1.196 */}Ab v2.1.196 wird es auch angezeigt, wenn [`ANTHROPIC_BASE_URL`](/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. ein [LLM-Gateway](/de/llm-gateway) oder Proxy, auch wenn Sie sich mit claude.ai anmelden.521Dies erscheint auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry. {/* min-version: 2.1.196 */}Ab v2.1.196 erscheint es auch, wenn [`ANTHROPIC_BASE_URL`](/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. ein [LLM-Gateway](/de/llm-gateway) oder Proxy, selbst wenn Sie sich mit claude.ai anmelden.

512 522 

513**Was zu tun ist:**523**Was zu tun ist:**

514 524 

515* Heben Sie `ANTHROPIC_BASE_URL` auf und starten Sie die Sitzung neu, oder starten Sie Remote Control von einer Sitzung aus, die direkt mit der Anthropic API spricht525* Heben Sie `ANTHROPIC_BASE_URL` auf und starten Sie die Sitzung neu, oder starten Sie Remote Control von einer Sitzung aus, die direkt mit der Anthropic API spricht

516* Für diese und die anderen Remote Control-Startmeldungen siehe [Remote Control fehlerbeheben](/de/remote-control#troubleshooting)526* Für diese und die anderen Remote-Control-Startmeldungen siehe [Remote Control beheben](/de/remote-control#troubleshooting)

517 527 

518<h3 id="oauth-token-revoked-or-expired">528<h3 id="oauth-token-revoked-or-expired">

519 OAuth token revoked or expired529 OAuth-Token widerrufen oder abgelaufen

520</h3>530</h3>

521 531 

522Ihre 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 mitten in der Sitzung fehlgeschlagen ist.532Ihre 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.

523 533 

524```text theme={null}534```text theme={null}

525OAuth token revoked · Please run /login535OAuth token revoked · Please run /login


530**Was zu tun ist:**540**Was zu tun ist:**

531 541 

532* Führen Sie `/login` aus, um sich erneut anzumelden542* Führen Sie `/login` aus, um sich erneut anzumelden

533* Wenn der Fehler nach der erneuten Authentifizierung in der gleichen Sitzung zurückkommt, führen Sie zuerst `/logout` aus, um den gespeicherten Token vollständig zu löschen, dann `/login`543* Wenn der Fehler nach der erneuten Authentifizierung innerhalb derselben Sitzung zurückkommt, führen Sie zuerst `/logout` aus, um das gespeicherte Token vollständig zu löschen, dann `/login`

534* Für wiederholte Anmeldungsaufforderungen über Starts hinweg siehe die Systemuhr- und macOS Keychain-Überprüfungen in [Fehlerbehebung](/de/troubleshoot-install#not-logged-in-or-token-expired)544* Für wiederholte Anmeldungsaufforderungen über Starts hinweg siehe die Systemuhr- und macOS-Keychain-Prüfungen in [Fehlerbehebung](/de/troubleshoot-install#not-logged-in-or-token-expired)

535* Für andere Fehler einschließlich `403 Forbidden` und OAuth-Browser-Probleme siehe [Anmeldung und Authentifizierung](/de/troubleshoot-install#login-and-authentication)545* Für andere Fehler einschließlich `403 Forbidden` und OAuth-Browser-Probleme siehe [Anmeldung und Authentifizierung](/de/troubleshoot-install#login-and-authentication)

536 546 

537<h3 id="oauth-scope-requirement">547<h3 id="oauth-scope-requirement">

538 OAuth scope requirement548 OAuth-Bereichsanforderung

539</h3>549</h3>

540 550 

541Der gespeicherte Token stammt von vor einem Berechtigungsumfang, den ein neueres Feature benötigt. Sie sehen dies am häufigsten von `/usage` und dem Statuszeilen-Nutzungsindikator:551Das gespeicherte Token stammt von vor einem Berechtigungsbereich, den eine neuere Funktion benötigt. Sie sehen dies am häufigsten von `/usage` und dem Nutzungsindikator in der Statuszeile:

542 552 

543```text theme={null}553```text theme={null}

544OAuth token does not meet scope requirement: user:profile554OAuth token does not meet scope requirement: user:profile


546 556 

547**Was zu tun ist:**557**Was zu tun ist:**

548 558 

549* Führen Sie `/login` aus, um einen neuen Token mit den aktuellen Umfängen zu erstellen. Sie müssen sich nicht zuerst abmelden.559* Führen Sie `/login` aus, um ein neues Token mit den aktuellen Bereichen zu erhalten. Sie müssen sich nicht zuerst abmelden.

550 560 

551<h3 id="aws-credentials-expired-or-invalid">561<h3 id="aws-credentials-expired-or-invalid">

552 AWS credentials expired or invalid562 AWS-Anmeldedaten abgelaufen oder ungültig

553</h3>563</h3>

554 564 

555{/* min-version: 2.1.198 */}Diese Meldung erfordert Claude Code v2.1.198 oder später und wird nur angezeigt, wenn [`awsAuthRefresh`](/de/amazon-bedrock#advanced-credential-configuration) in Ihrer Einstellungsdatei gesetzt ist. Ihr AWS-Sitzungstoken ist abgelaufen oder wurde abgelehnt, und die automatische Aktualisierung, die Claude Code bereits ausgeführt hat, hat keine Anmeldeinformation erzeugt, die die API akzeptiert. Sie wird auf einem 401 von [Claude Platform auf AWS](/de/claude-platform-on-aws) oder dem [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) angezeigt, was ist, wie diese Anbieter ein abgelaufenes Sicherheitstoken melden.565{/* min-version: 2.1.198 */}Diese Meldung erfordert Claude Code v2.1.198 oder später und erscheint nur, wenn [`awsAuthRefresh`](/de/amazon-bedrock#advanced-credential-configuration) in Ihrer Einstellungsdatei gesetzt ist. Ihr AWS-Sitzungs-Token ist abgelaufen oder wurde abgelehnt, und die automatische Aktualisierung, die Claude Code bereits ausgeführt hat, hat keine Anmeldedaten erzeugt, die die API akzeptiert. Es erscheint bei einem 401 von [Claude Platform on AWS](/de/claude-platform-on-aws) oder dem [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint), wie diese Anbieter ein abgelaufenes Sicherheits-Token melden.

556 566 

557Der Aktionshinweis in der Mitte benennt den `awsAuthRefresh` Befehl aus Ihren Einstellungen, daher variiert er. Der stabile Teil ist der führende `AWS credentials expired or invalid`:567Der Aktionshinweis in der Mitte nennt den `awsAuthRefresh`-Befehl aus Ihren Einstellungen, daher variiert er. Der stabile Teil ist der führende `AWS credentials expired or invalid`:

558 568 

559```text theme={null}569```text theme={null}

560AWS 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 ...570AWS 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 ...

561```571```

562 572 

563Ohne `awsAuthRefresh` konfiguriert, zeigt der gleiche 401 stattdessen die generische `Please run /login` Nachricht, die AWS-Anmeldeinformationen nicht aktualisieren kann.573Ohne `awsAuthRefresh` konfiguriert, zeigt derselbe 401 stattdessen die generische `Please run /login`-Meldung an, die AWS-Anmeldedaten nicht aktualisieren kann.

564 574 

565**Was zu tun ist:**575**Was zu tun ist:**

566 576 

567* Führen Sie den `awsAuthRefresh` Befehl aus, der in der Nachricht benannt ist, wie `aws sso login --profile myprofile`, in einem anderen Terminal aus und schließen Sie die Browser-Anmeldung ab, dann versuchen Sie es erneut577* Führen Sie den in der Meldung genannten `awsAuthRefresh`-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

568* In einer interaktiven Sitzung führen Sie `/login` aus, wählen Sie **3rd-party platform**, dann wählen Sie **Claude Platform on AWS · refresh credentials** unter **Using 3rd-party platforms**, um den gleichen Befehl auszuführen, ohne Claude Code neu zu starten. Siehe [AWS-Anmeldeinformationen konfigurieren](/de/claude-platform-on-aws#1-configure-aws-credentials)578* Führen Sie in einer interaktiven Sitzung `/login` aus, wählen Sie **3rd-party platform**, dann wählen Sie **Claude Platform on AWS · refresh credentials** unter **Using 3rd-party platforms**, um denselben Befehl auszuführen, ohne Claude Code neu zu starten. Siehe [AWS-Anmeldedaten konfigurieren](/de/claude-platform-on-aws#1-configure-aws-credentials)

569* Wenn der Fehler nach dem erfolgreichen Ausführen des Aktualisierungsbefehls 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 ist579* 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 derselben Shell und demselben Profil gültig ist

570 580 

571<h3 id="aws-authentication-failed">581<h3 id="aws-authentication-failed">

572 AWS authentication failed582 AWS-Authentifizierung fehlgeschlagen

573</h3>583</h3>

574 584 

575{/* min-version: 2.1.198 */}Diese Meldung erfordert Claude Code v2.1.198 oder später und wird nur angezeigt, wenn [`awsAuthRefresh`](/de/amazon-bedrock#advanced-credential-configuration) in Ihrer Einstellungsdatei gesetzt ist. Ihr AWS-Anbieter hat einen 403 zurückgegeben, oder [Amazon Bedrock](/de/amazon-bedrock) hat einen 401 zurückgegeben.585{/* min-version: 2.1.198 */}Diese Meldung erfordert Claude Code v2.1.198 oder später und erscheint nur, wenn [`awsAuthRefresh`](/de/amazon-bedrock#advanced-credential-configuration) in Ihrer Einstellungsdatei gesetzt ist. Ihr AWS-Anbieter hat einen 403 zurückgegeben, oder [Amazon Bedrock](/de/amazon-bedrock) hat einen 401 zurückgegeben.

576 586 

577Claude Code kann nicht sagen, welche Ursache Sie treffen. Amazon Bedrock meldet ein abgelaufenes Sicherheitstoken als 403, aber ein 403 ist auch, wie es eine Autorisierungsverweigerung meldet, wie eine `AccessDeniedException` von einer fehlenden IAM-Berechtigung oder einem Modell, das nicht für Ihr Konto aktiviert ist.587Claude Code kann nicht sagen, welche Ursache Sie getroffen haben. Amazon 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 oder ein Modell, das nicht für Ihr Konto aktiviert ist.

578 588 

579Ein 401 von Amazon Bedrock landet auch hier statt unter [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid), weil Bedrock ein abgelaufenes Token nicht als 401 meldet. Ein 401 von diesem Endpunkt kommt normalerweise von etwas anderem im Anfragepfad, wie ein Unternehmens-Proxy.589Ein 401 von Amazon Bedrock landet hier auch anstelle von [AWS-Anmeldedaten abgelaufen oder ungültig](#aws-credentials-expired-or-invalid), da 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.

580 590 

581Eine Anmeldeinformations-Aktualisierung behebt ein abgelaufenes Token und kann die anderen Ursachen nicht beheben, daher bietet die Nachricht beide:591Eine Anmeldedaten-Aktualisierung behebt ein abgelaufenes Token und kann die anderen Ursachen nicht beheben, daher bietet die Meldung beide an:

582 592 

583```text theme={null}593```text theme={null}

584AWS 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 ...594AWS 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 ...

585```595```

586 596 

587Der Aktionshinweis in der Mitte benennt den `awsAuthRefresh` Befehl aus Ihren Einstellungen, daher variiert er. Der stabile Teil ist der führende `AWS authentication failed`.597Der Aktionshinweis in der Mitte nennt den `awsAuthRefresh`-Befehl aus Ihren Einstellungen, daher variiert er. Der stabile Teil ist der führende `AWS authentication failed`.

588 598 

589**Was zu tun ist:**599**Was zu tun ist:**

590 600 

591* Führen Sie den `awsAuthRefresh` Befehl aus, der in der Nachricht benannt ist, oder `aws sso login`, falls ein abgelaufenes Anmeldeinformationen die Ursache ist601* Führen Sie den in der Meldung genannten `awsAuthRefresh`-Befehl oder `aws sso login` aus, falls ein abgelaufenes Anmeldedaten die Ursache ist

592* Wenn Ihre Anmeldeinformationen aktuell sind, bestätigen Sie die IAM-Berechtigungen in [IAM-Konfiguration](/de/amazon-bedrock#iam-configuration) sind an die Identität angehängt, die Sie verwenden, und dass das ausgewählte Modell für Ihr Konto und Ihre Region aktiviert ist602* Wenn Ihre Anmeldedaten aktuell sind, bestätigen Sie, dass die IAM-Berechtigungen in [IAM-Konfiguration](/de/amazon-bedrock#iam-configuration) 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

593* 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 einen Berechtigungsmismatch603* 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 einen Berechtigungskonflikt

594 604 

595<h2 id="network-and-connection-errors">605<h2 id="network-and-connection-errors">

596 Netzwerk- und Verbindungsfehler606 Netzwerk- und Verbindungsfehler

597</h2>607</h2>

598 608 

599Diese Fehler bedeuten, dass eine Netzwerkanfrage von Claude Code ihr Ziel nicht erreicht hat. Sie stammen normalerweise aus Ihrem lokalen Netzwerk, Proxy oder Firewall oder aus der Netzwerkrichtlinie der Cloud-Umgebung.609Diese Fehler bedeuten, dass eine Netzwerkanfrage von Claude Code ihr Ziel nicht erreicht hat. Sie entstehen normalerweise in Ihrem lokalen Netzwerk, Proxy oder Firewall oder in der Netzwerkrichtlinie der Cloud-Umgebung.

600 610 

601<h3 id="unable-to-connect-to-api">611<h3 id="unable-to-connect-to-api">

602 Unable to connect to API612 Verbindung zur API nicht möglich

603</h3>613</h3>

604 614 

605Die TCP-Verbindung zur API ist fehlgeschlagen oder wurde nie abgeschlossen.615Die TCP-Verbindung zur API ist fehlgeschlagen oder wurde nie abgeschlossen.


613Request timed out. Check your internet connection and proxy settings623Request timed out. Check your internet connection and proxy settings

614```624```

615 625 

616Häufige Ursachen sind kein Internetzugang, ein VPN, das `api.anthropic.com` blockiert, oder ein erforderlicher Unternehmens-Proxy, der nicht konfiguriert ist.626Häufige Ursachen sind fehlender Internetzugang, ein VPN, das `api.anthropic.com` blockiert, oder ein erforderlicher Unternehmens-Proxy, der nicht konfiguriert ist.

617 627 

618**Was zu tun ist:**628**Was zu tun ist:**

619 629 

620* Bestätigen Sie, dass Sie den API-Host aus der gleichen Shell erreichen können, indem Sie `curl -I https://api.anthropic.com` ausführen. Verwenden Sie auf Windows PowerShell `curl.exe -I https://api.anthropic.com`, damit der integrierte `Invoke-WebRequest`-Alias nicht verwendet wird.630* Bestätigen Sie, dass Sie den API-Host aus derselben Shell erreichen können, indem Sie `curl -I https://api.anthropic.com` ausführen. Verwenden Sie unter Windows PowerShell `curl.exe -I https://api.anthropic.com`, damit der integrierte `Invoke-WebRequest`-Alias nicht verwendet wird.

621* Wenn Sie hinter einem Unternehmens-Proxy sind, setzen Sie `HTTPS_PROXY`, bevor Sie Claude Code starten, und siehe [Netzwerkkonfiguration](/de/network-config)631* Wenn Sie sich hinter einem Unternehmens-Proxy befinden, setzen Sie `HTTPS_PROXY` vor dem Starten von Claude Code und siehe [Netzwerkkonfiguration](/de/network-config)

622* Wenn Sie durch ein LLM-Gateway oder Relay leiten, setzen Sie [`ANTHROPIC_BASE_URL`](/de/env-vars) auf seine Adresse. Siehe [Claude Code mit einem LLM-Gateway verbinden](/de/llm-gateway-connect) für die Einrichtung.632* Wenn Sie über ein LLM-Gateway oder Relay weiterleiten, setzen Sie [`ANTHROPIC_BASE_URL`](/de/env-vars) auf dessen Adresse. Siehe [Claude Code mit einem LLM-Gateway verbinden](/de/llm-gateway-connect) für die Einrichtung.

623* Stellen Sie sicher, dass Ihre Firewall die in [Netzwerkzugriffsanforderungen](/de/network-config#network-access-requirements) aufgelisteten Hosts zulässt633* Stellen Sie sicher, dass Ihre Firewall die in [Netzwerkzugriffsanforderungen](/de/network-config#network-access-requirements) aufgelisteten Hosts zulässt

624* Vorübergehende Fehler werden [automatisch wiederholt](#automatic-retries); anhaltende Fehler deuten auf ein lokales Netzwerkproblem hin634* Vorübergehende Fehler werden [automatisch wiederholt](#automatic-retries); anhaltende Fehler deuten auf ein lokales Netzwerkproblem hin

625 635 

626Wenn `curl` erfolgreich ist, aber Claude Code immer noch fehlschlägt, ist die Ursache normalerweise etwas zwischen der Laufzeit und dem Netzwerk und nicht das Netzwerk selbst:636Wenn `curl` erfolgreich ist, aber Claude Code immer noch fehlschlägt, liegt die Ursache normalerweise bei etwas zwischen der Laufzeit und dem Netzwerk und nicht beim Netzwerk selbst:

627 637 

628* Überprüfen Sie auf Linux und WSL `/etc/resolv.conf` auf einen unerreichbaren Nameserver. WSL kann insbesondere einen fehlerhaften Resolver vom Host erben.638* Unter Linux und WSL überprüfen Sie `/etc/resolv.conf` auf einen unerreichbaren Nameserver. WSL kann insbesondere einen fehlerhaften Resolver vom Host erben.

629* Auf macOS kann ein VPN-Client, der getrennt oder deinstalliert wurde, eine Tunnel-Schnittstelle oder Routing-Regel hinterlassen. Überprüfen Sie `ifconfig` auf verwaiste `utun`-Schnittstellen und entfernen Sie die Netzwerkerweiterung des VPN in den Systemeinstellungen.639* 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.

630* Docker Desktop und ähnliche Container-Runtimes können ausgehenden Datenverkehr abfangen. Beenden Sie sie und versuchen Sie es erneut, um dies auszuschließen.640* Docker Desktop und ähnliche Container-Laufzeiten können ausgehenden Datenverkehr abfangen. Beenden Sie diese und versuchen Sie es erneut, um dies auszuschließen.

631 641 

632<h3 id="ssl-certificate-errors">642<h3 id="ssl-certificate-errors">

633 SSL certificate errors643 SSL-Zertifikatsfehler

634</h3>644</h3>

635 645 

636Ein Proxy oder Sicherheitsgerät in Ihrem Netzwerk fängt TLS-Datenverkehr mit seinem eigenen Zertifikat ab, und Claude Code vertraut ihm nicht.646Ein Proxy oder eine Sicherheitsappliance in Ihrem Netzwerk fängt TLS-Datenverkehr mit seinem eigenen Zertifikat ab, und Claude Code vertraut ihm nicht.

637 647 

638```text theme={null}648```text theme={null}

639Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates649Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates

640Unable to connect to API: Self-signed certificate detected650Unable to connect to API: Self-signed certificate detected

641```651```

642 652 

643{/* min-version: 2.1.199 */}Ab v2.1.199 wird ein Zertifikatvalidierungsfehler nicht wiederholt, daher wird dieser Fehler beim ersten Versuch angezeigt, anstatt nach dem vollständigen [Wiederholungsbudget](#automatic-retries). Frühere Versionen verbrachten ein paar Minuten damit, zu wiederholen, bevor es angezeigt wurde. Vorübergehende TLS-Bedingungen, wie ein Handshake-Timeout, werden weiterhin wiederholt.653{/* min-version: 2.1.199 */}Ab v2.1.199 wird ein Zertifikatvalidierungsfehler nicht wiederholt, daher wird dieser Fehler beim ersten Versuch angezeigt, anstatt nach dem vollständigen [Wiederholungsbudget](#automatic-retries). Frühere Versionen verbrachten einige Minuten mit Wiederholungen, bevor sie angezeigt wurden. Vorübergehende TLS-Bedingungen, wie z. B. ein Handshake-Timeout, werden weiterhin wiederholt.

644 654 

645Während `/login` und der Startup-Konnektivitätsprüfung wird der gleiche Fehler mit dem OpenSSL-Code und der Behebung inline gemeldet:655Während `/login` und der Startup-Konnektivitätsprüfung wird derselbe Fehler mit dem OpenSSL-Code und der Behebung inline gemeldet:

646 656 

647```text theme={null}657```text theme={null}

648SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run /doctor for details.658SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

649```659```

650 660 

651**Was zu tun ist:**661**Was zu tun ist:**

652 662 

653* Exportieren Sie das CA-Bundle Ihrer Organisation und zeigen Sie Claude Code mit `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem` darauf663* Exportieren Sie das CA-Bundle Ihrer Organisation und verweisen Sie Claude Code darauf mit `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`

654* Siehe [Netzwerkkonfiguration](/de/network-config#custom-ca-certificates) für vollständige Einrichtungsanweisungen664* Siehe [Netzwerkkonfiguration](/de/network-config#custom-ca-certificates) für vollständige Einrichtungsanweisungen

655* Setzen Sie nicht `NODE_TLS_REJECT_UNAUTHORIZED=0`, was die Zertifikatvalidierung vollständig deaktiviert665* Setzen Sie nicht `NODE_TLS_REJECT_UNAUTHORIZED=0`, was die Zertifikatvalidierung vollständig deaktiviert

656 666 

657<h3 id="host-not-allowed-in-a-cloud-session">667<h3 id="host-not-allowed-in-a-cloud-session">

658 Host not allowed in a cloud session668 Host nicht zulässig in einer Cloud-Sitzung

659</h3>669</h3>

660 670 

661Eine ausgehende HTTP-Anfrage von einer Cloud-Sitzung oder Routine wurde durch die Netzwerkrichtlinie der Umgebung blockiert.671Eine ausgehende HTTP-Anfrage von einer Cloud-Sitzung oder Routine wurde durch die Netzwerkrichtlinie der Umgebung blockiert.


665x-deny-reason: host_not_allowed675x-deny-reason: host_not_allowed

666```676```

667 677 

668Möglicherweise wird auch ein TLS-Zertifikat angezeigt, das nicht dem echten Zertifikat des Ziels entspricht. Die Cloud-Umgebung leitet ausgehenden Datenverkehr durch einen Proxy, der die Netzwerkrichtlinie durchsetzt, daher bedeutet ein nicht übereinstimmendes Zertifikat, dass der Proxy die Verbindung beendet hat, nicht das Ziel.678Möglicherweise wird auch ein TLS-Zertifikat angezeigt, das nicht dem echten Zertifikat des Ziels entspricht. Die Cloud-Umgebung leitet ausgehenden Datenverkehr durch einen Proxy weiter, der die Netzwerkrichtlinie durchsetzt, daher bedeutet ein nicht übereinstimmendes Zertifikat, dass der Proxy die Verbindung beendet hat, nicht das Ziel.

669 679 

670Dies ist kein clientseitiges Netzwerkproblem. Cloud-Sitzungen und [Routinen](/de/routines) werden in einer Sandbox-Umgebung ausgeführt, deren ausgehender Datenverkehr auf die Zulassungsliste der Umgebung gefiltert wird. Die **Standard**-Umgebung verwendet **Vertrauenswürdigen** Zugriff, der die [Standard-Zulassungsliste](/de/claude-code-on-the-web#default-allowed-domains) von Paketregistern, Cloud-Provider-APIs, Container-Registern und häufigen Entwicklungsdomänen zulässt, aber alles andere blockiert.680Dies ist kein clientseitiges Netzwerkproblem. Cloud-Sitzungen und [Routinen](/de/routines) werden in einer Sandbox-Umgebung ausgeführt, deren ausgehender Datenverkehr auf die Zulassungsliste der Umgebung gefiltert wird. Die **Standard**-Umgebung verwendet **Vertrauenswürdigen** Zugriff, der die [Standard-Zulassungsliste](/de/claude-code-on-the-web#default-allowed-domains) von Paketregistern, Cloud-Provider-APIs, Container-Registern und häufigen Entwicklungsdomänen zulässt, aber alles andere blockiert.

671 681 

672**Was zu tun ist:**682**Was zu tun ist:**

673 683 

674* Öffnen Sie die Routine zum Bearbeiten, oder starten Sie eine Cloud-Sitzung. Wählen Sie das Cloud-Symbol, das den Namen Ihrer Umgebung anzeigt, z. B. **Standard**, um die Auswahl zu öffnen. Bewegen Sie den Mauszeiger über Ihre Umgebung und klicken Sie auf das Einstellungssymbol.684* Öffnen Sie die Routine zum Bearbeiten oder starten Sie eine Cloud-Sitzung. Wählen Sie das Cloud-Symbol mit dem Namen Ihrer Umgebung, z. B. **Standard**, um die Auswahl zu öffnen. Bewegen Sie den Mauszeiger über Ihre Umgebung und klicken Sie auf das Einstellungssymbol.

675* Im Dialog **Cloud-Umgebung aktualisieren** ändern Sie **Netzwerkzugriff** von **Vertrauenswürdig** zu **Benutzerdefiniert**, und fügen Sie dann die blockierte Domain zu **Zulässige Domains** hinzu. Geben Sie eine Domain pro Zeile ein. Aktivieren Sie **Auch Standard-Liste häufiger Paketmanager einschließen**, um die [Standard-Zulassungsliste](/de/claude-code-on-the-web#default-allowed-domains) neben Ihren benutzerdefinierten Domains zu behalten. Wählen Sie stattdessen **Vollständig**, wenn Sie uneingeschränkten Zugriff möchten.685* Ändern Sie im Dialog **Cloud-Umgebung aktualisieren** den **Netzwerkzugriff** von **Vertrauenswürdig** zu **Benutzerdefiniert**, und fügen Sie dann die blockierte Domain zu **Zulässige Domains** hinzu. Geben Sie eine Domain pro Zeile ein. Aktivieren Sie **Auch Standard-Liste häufiger Paketmanager einschließen**, um die [Standard-Zulassungsliste](/de/claude-code-on-the-web#default-allowed-domains) neben Ihren benutzerdefinierten Domains zu behalten. Wählen Sie stattdessen **Vollständig**, wenn Sie uneingeschränkten Zugriff möchten.

676* Klicken Sie auf **Änderungen speichern**. Der nächste Durchlauf verwendet die aktualisierte Zulassungsliste.686* Klicken Sie auf **Änderungen speichern**. Die nächste Ausführung verwendet die aktualisierte Zulassungsliste.

677 687 

678Siehe [Netzwerkzugriff](/de/claude-code-on-the-web#network-access) für Zugriffsstufen und die Standard-Zulassungsliste. Lokale CLI-Sitzungen sind von dieser Richtlinie nicht betroffen.688Siehe [Netzwerkzugriff](/de/claude-code-on-the-web#network-access) für Zugriffsstufen und die Standard-Zulassungsliste. Lokale CLI-Sitzungen sind von dieser Richtlinie nicht betroffen.

679 689 

690<h3 id="couldn’t-reconnect-to-your-remote-control-session">

691 Verbindung zu Ihrer Remote-Control-Sitzung konnte nicht wiederhergestellt werden

692</h3>

693 

694```text theme={null}

695Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

696```

697 

698Das Fortsetzen mit `claude --resume` oder `claude --continue` stellt die Verbindung zur [Remote Control](/de/remote-control)-Sitzung wieder her, die in diesem Gespräch aufgezeichnet wurde. Diese Meldung bedeutet, dass die Wiederverbindung aus einem Grund fehlgeschlagen ist, der vorübergehend sein kann, z. B. eine Netzwerkunterbrechung oder ein Serverfehler, daher kann Claude Code nicht bestätigen, ob die Remote-Sitzung noch vorhanden ist. Ihre lokale Sitzung wird ohne Remote Control weiterhin ausgeführt.

699 

700**Was zu tun ist:**

701 

702* Führen Sie `/remote-control` aus, um die Verbindung erneut zu versuchen

703* Starten Sie Claude Code ohne `--resume`, um eine neue Remote-Control-Sitzung zu erstellen

704* Weitere Remote-Control-Startmeldungen finden Sie unter [Remote Control beheben](/de/remote-control#troubleshooting)

705 

706Diese Meldung wird nicht angezeigt, wenn der Server bestätigt, dass die vorherige Sitzung nicht mehr vorhanden ist. Claude Code erstellt in diesem Fall eine neue. {/* min-version: 2.1.200 */}Vor v2.1.200 hat jeder Wiederverbindungsfehler eine neue Remote-Control-Sitzung erstellt, was zusätzliche Sitzungen in der Sitzungsliste unter claude.ai/code hinterlassen hat.

707 

680<h2 id="request-errors">708<h2 id="request-errors">

681 Anfragefehler709 Anfragefehler

682</h2>710</h2>

683 711 

684Diese Fehler bedeuten, dass die API Ihre Anfrage erhalten hat, aber ihren Inhalt abgelehnt hat.712Diese 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.

685 713 

686<h3 id="prompt-is-too-long">714<h3 id="prompt-is-too-long">

687 Prompt is too long715 Eingabeaufforderung ist zu lang

688</h3>716</h3>

689 717 

690Die Konversation plus angehängte Dateien überschreitet das Kontextfenster des Modells.718Das Gespräch plus angehängte Dateien überschreitet das Kontextfenster des Modells.

691 719 

692```text theme={null}720```text theme={null}

693Prompt is too long721Prompt is too long


696**Was zu tun ist:**724**Was zu tun ist:**

697 725 

698* Führen Sie `/compact` aus, um frühere Turns zusammenzufassen und Platz freizugeben, oder `/clear`, um neu zu beginnen726* Führen Sie `/compact` aus, um frühere Turns zusammenzufassen und Platz freizugeben, oder `/clear`, um neu zu beginnen

699* Führen Sie `/context` aus, um eine Aufschlüsselung zu sehen, was das Fenster verbraucht: Systemprompt, Tools, Memory-Dateien und Nachrichten727* Führen Sie `/context` aus, um eine Aufschlüsselung zu sehen, was das Fenster verbraucht: Systemaufforderung, Tools, Speicherdateien und Nachrichten

700* Deaktivieren Sie MCP-Server, die Sie nicht verwenden, mit `/mcp disable <name>`, um ihre Tool-Definitionen aus dem Kontext zu entfernen728* Deaktivieren Sie MCP-Server, die Sie nicht verwenden, mit `/mcp disable <name>`, um ihre Tool-Definitionen aus dem Kontext zu entfernen

701* Trimmen Sie große `CLAUDE.md` Memory-Dateien, oder verschieben Sie Anweisungen in [pfadgebundene Regeln](/de/memory#path-specific-rules), die nur bei Bedarf geladen werden729* Trimmen Sie große `CLAUDE.md`-Speicherdateien, oder verschieben Sie Anweisungen in [pfadgebundene Regeln](/de/memory#path-specific-rules), die nur bei Bedarf geladen werden

702* Subagenten erben jede MCP-Tool-Definition von der übergeordneten Sitzung, was ihr Kontextfenster füllen kann, bevor der erste Turn stattfindet. Deaktivieren Sie MCP-Server, die Sie nicht verwenden, bevor Sie Subagenten spawnen.730* Subagenten erben jede MCP-Tool-Definition von der übergeordneten Sitzung, was ihr Kontextfenster füllen kann, bevor der erste Turn stattfindet. Deaktivieren Sie MCP-Server, die Sie nicht verwenden, bevor Sie Subagenten spawnen.

703* Auto-compact ist standardmäßig aktiviert und verhindert normalerweise diesen Fehler. Wenn Sie [`DISABLE_AUTO_COMPACT`](/de/env-vars) gesetzt haben, aktivieren Sie es erneut oder führen Sie `/compact` manuell aus, bevor das Fenster voll wird.731* Auto-Compact ist standardmäßig aktiviert und verhindert normalerweise diesen Fehler. Wenn Sie [`DISABLE_AUTO_COMPACT`](/de/env-vars) gesetzt haben, aktivieren Sie es erneut oder führen Sie `/compact` manuell aus, bevor das Fenster voll wird.

704 732 

705Siehe [Erkunden Sie das Kontextfenster](/de/context-window) für eine interaktive Ansicht, wie sich der Kontext füllt.733Siehe [Erkunden Sie das Kontextfenster](/de/context-window) für eine interaktive Ansicht, wie sich der Kontext füllt.

706 734 

707<h3 id="error-during-compaction-conversation-too-long">735<h3 id="error-during-compaction-conversation-too-long">

708 Error during compaction: Conversation too long736 Fehler während der Komprimierung: Gespräch zu lang

709</h3>737</h3>

710 738 

711`/compact` selbst ist fehlgeschlagen, weil nicht genug freier Kontext vorhanden ist, um die Zusammenfassung zu halten, die es erzeugt.739`/compact` selbst ist fehlgeschlagen, weil nicht genug freier Kontext vorhanden ist, um die erzeugte Zusammenfassung zu halten.

712 740 

713```text theme={null}741```text theme={null}

714Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.742Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

715```743```

716 744 

717Dies kann auftreten, wenn das Fenster bereits voll ist, wenn auto-compact ausgelöst wird, oder wenn Sie `/compact` ausführen, nachdem Sie `Prompt is too long` gesehen haben.745Dies kann passieren, wenn das Fenster bereits voll ist, wenn Auto-Compact ausgelöst wird, oder wenn Sie `/compact` ausführen, nachdem Sie `Prompt is too long` gesehen haben.

718 746 

719**Was zu tun ist:**747**Was zu tun ist:**

720 748 

721* Drücken Sie Esc zweimal, um die Nachrichtenliste zu öffnen und mehrere Turns zurückzugehen. Dies lässt die neuesten Nachrichten aus dem Kontext fallen. Führen Sie dann `/compact` erneut aus.749* Drücken Sie Esc zweimal, um die Nachrichtenliste zu öffnen und mehrere Turns zurückzugehen. Dies entfernt die neuesten Nachrichten aus dem Kontext. Führen Sie dann `/compact` erneut aus.

722* Wenn das Zurückgehen nicht genug Platz freimacht, führen Sie `/clear` aus, um eine neue Sitzung zu starten. Ihre vorherige Konversation wird beibehalten und kann mit `/resume` erneut geöffnet werden.750* Wenn das Zurückgehen nicht genug Platz freimacht, führen Sie `/clear` aus, um eine neue Sitzung zu starten. Ihr vorheriges Gespräch bleibt erhalten und kann mit `/resume` erneut geöffnet werden.

723 751 

724<h3 id="request-too-large">752<h3 id="request-too-large">

725 Request too large753 Anfrage zu groß

726</h3>754</h3>

727 755 

728Der rohe Anfragekörper überschritt das Byte-Limit der API vor der Tokenisierung, normalerweise wegen einer großen eingefügten Datei oder eines Anhangs.756Der rohe Anfragekörper überschritt das Byte-Limit der API vor der Tokenisierung, normalerweise wegen einer großen eingefügten Datei oder eines Anhangs.


735 763 

736**Was zu tun ist:**764**Was zu tun ist:**

737 765 

738* Drücken Sie Esc zweimal und gehen Sie zurück über den Turn, der den übergroßen Inhalt hinzugefügt hat766* Drücken Sie Esc zweimal und gehen Sie zurück zum Turn, der den übergroßen Inhalt hinzugefügt hat

739* Referenzieren Sie große Dateien nach Pfad, anstatt ihren Inhalt einzufügen, damit Claude sie in Chunks lesen kann767* Referenzieren Sie große Dateien nach Pfad, anstatt ihren Inhalt einzufügen, damit Claude sie in Chunks lesen kann

740* Für Bilder siehe [Image was too large](#image-was-too-large) unten768* Für Bilder siehe [Bild war zu groß](#image-was-too-large) unten

741 769 

742<h3 id="image-was-too-large">770<h3 id="image-was-too-large">

743 Image was too large771 Bild war zu groß

744</h3>772</h3>

745 773 

746Ein eingefügtes oder angehängtes Bild überschreitet die Größen- oder Dimensionslimits der API.774Ein eingefügtes oder angehängtes Bild überschreitet die Größen- oder Dimensionslimits der API.


750API Error: 400 ... image dimensions exceed max allowed size778API Error: 400 ... image dimensions exceed max allowed size

751```779```

752 780 

753{/* min-version: 2.1.142 */}Claude 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 in der Konversation verbleiben und denselben Fehler bei jeder nachfolgenden Nachricht wiederholen. Um auf diesen Versionen zu genesen, drücken Sie Esc zweimal und gehen Sie zurück über den Turn, in dem das Bild hinzugefügt wurde.781{/* min-version: 2.1.142 */}Claude Code ersetzt das nicht verarbeitbare Bild durch einen Textplatzhalter und versucht es erneut, sodass nachfolgende Nachrichten erfolgreich sind. 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 in diesen Versionen zu erholen, drücken Sie Esc zweimal und gehen Sie zurück zum Turn, in dem das Bild hinzugefügt wurde.

754 782 

755**Was zu tun ist:**783**Was zu tun ist:**

756 784 

757* Ä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.785* Ä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.

758* Machen Sie einen engeren Screenshot des relevanten Bereichs statt des gesamten Bildschirms786* Machen Sie einen engeren Screenshot des relevanten Bereichs anstelle des gesamten Bildschirms

759 787 

760<h3 id="unable-to-resize-image">788<h3 id="unable-to-resize-image">

761 Unable to resize image789 Bild konnte nicht in der Größe geändert werden

762</h3>790</h3>

763 791 

764Claude Code konnte ein angehängtes Bild nicht herunterskalieren, bevor es an die API gesendet wurde.792Claude Code konnte ein angehängtes Bild nicht herunterskalieren, bevor es an die API gesendet wurde.


770Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.798Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.

771```799```

772 800 

773Claude Code skaliert große Bilder normalerweise automatisch herunter. Diese Fehler bedeuten, dass der native Bildprozessor nicht geladen werden konnte oder einen Fehler zurückgegeben hat, daher konnte das Bild nicht so angepasst werden, dass es in die API-Limits passt.801Claude Code ändert normalerweise die Größe großer Bilder automatisch. Diese Fehler bedeuten, dass der native Bildprozessor nicht geladen werden konnte oder einen Fehler zurückgegeben hat, sodass das Bild nicht an die API-Limits angepasst werden konnte.

774 802 

775**Was zu tun ist:**803**Was zu tun ist:**

776 804 

777* Wenn die Nachricht 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 den Bildprozessor zu verwenden.805* Wenn die Nachricht Sie auffordert, das Bild zu konvertieren, konvertieren Sie es in PNG, JPEG, GIF oder WebP und fügen Sie es erneut an. Claude Code kann Dimensionen für diese Formate ohne den Bildprozessor überprüfen.

778* 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.806* 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.

779 807 

780<h3 id="pdf-errors">808<h3 id="pdf-errors">

781 PDF errors809 PDF-Fehler

782</h3>810</h3>

783 811 

784Das PDF, das Sie angehängt haben, konnte nicht verarbeitet werden.812Das angehängte PDF konnte nicht verarbeitet werden.

785 813 

786```text theme={null}814```text theme={null}

787PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.815PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.


791 819 

792**Was zu tun ist:**820**Was zu tun ist:**

793 821 

794* Für übergroß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 Pfad822* Für übergroße PDFs bitten Sie Claude, einen Seitenbereich mit dem Read-Tool zu lesen, anstatt die gesamte Datei anzuhängen, oder extrahieren Sie Text mit einem Tool wie `pdftotext` und referenzieren Sie die Ausgabedatei nach Pfad

795* 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 erneut823* Für geschützte oder ungültige PDFs entfernen Sie das Passwort oder exportieren Sie die Datei erneut aus ihrer Quellanwendung und versuchen Sie es erneut

796 824 

797<h3 id="extra-inputs-are-not-permitted">825<h3 id="extra-inputs-are-not-permitted">

798 Extra inputs are not permitted826 Zusätzliche Eingaben sind nicht zulässig

799</h3>827</h3>

800 828 

801Ein Proxy oder LLM-Gateway zwischen Claude Code und der API hat den `anthropic-beta` Request-Header entfernt, daher hat die API Felder abgelehnt, die davon abhängen.829Ein Proxy oder LLM-Gateway zwischen Claude Code und der API hat den `anthropic-beta`-Anfrage-Header entfernt, sodass die API Felder ablehnte, die davon abhängen.

802 830 

803```text theme={null}831```text theme={null}

804API Error: 400 ... Extra inputs are not permitted ... context_management832API Error: 400 ... Extra inputs are not permitted ... context_management


806API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header834API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

807```835```

808 836 

809Claude Code sendet Beta-only-Felder wie `context_management`, `effort` und Tool `input_examples` zusammen mit einem `anthropic-beta` Header, der sie aktiviert. Wenn ein Gateway den Body weiterleitet, aber den Header löscht, sieht die API Felder, die sie nicht erkennt.837Claude Code sendet Beta-only-Felder wie `context_management`, `effort` und Tool-`input_examples` 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.

810 838 

811**Was zu tun ist:**839**Was zu tun ist:**

812 840 

813* Konfigurieren Sie Ihr Gateway, um den `anthropic-beta` Header weiterzuleiten. Siehe [Feature-Durchleitung](/de/llm-gateway-protocol#feature-pass-through) für das, was Gateways weiterleiten müssen.841* Konfigurieren Sie Ihr Gateway, um den `anthropic-beta`-Header weiterzuleiten. Siehe [Feature-Durchleitung](/de/llm-gateway-protocol#feature-pass-through) für das, was Gateways weiterleiten müssen.

814* Setzen Sie als Fallback [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/de/env-vars) vor dem Start. Dies deaktiviert Features, die den Beta-Header benötigen, damit Anfragen durch ein Gateway erfolgreich sind, das ihn nicht weiterleiten kann.842* Setzen Sie als Fallback [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/de/env-vars) vor dem Start. Dies deaktiviert Funktionen, die den Beta-Header erfordern, sodass Anfragen durch ein Gateway erfolgreich sind, das ihn nicht weiterleiten kann.

815 843 

816<h3 id="there’s-an-issue-with-the-selected-model">844<h3 id="there’s-an-issue-with-the-selected-model">

817 There's an issue with the selected model845 Es gibt ein Problem mit dem ausgewählten Modell

818</h3>846</h3>

819 847 

820Der konfigurierte Modellname wurde nicht erkannt oder Ihr Konto hat keinen Zugriff darauf. Ab v2.1.160 variiert der nachfolgende Hinweis, der hier in seiner interaktiven Form angezeigt wird, je nach Oberfläche.848Der konfigurierte Modellname wurde nicht erkannt oder Ihr Konto hat keinen Zugriff darauf. Ab v2.1.160 variiert der nachfolgende Hinweis, der hier in seiner interaktiven Form angezeigt wird, je nach Oberfläche.


827 855 

828* **Interaktive CLI**: Führen Sie `/model` aus, um aus Modellen auszuwählen, die für Ihr Konto verfügbar sind.856* **Interaktive CLI**: Führen Sie `/model` aus, um aus Modellen auszuwählen, die für Ihr Konto verfügbar sind.

829* **Nicht-interaktiver Modus (`-p`)**: Übergeben Sie `--model` mit einem gültigen Alias oder einer ID, oder setzen Sie [`ANTHROPIC_MODEL`](/de/env-vars). Der Fehlertext zeigt `Run --model` auf dieser Oberfläche.857* **Nicht-interaktiver Modus (`-p`)**: Übergeben Sie `--model` mit einem gültigen Alias oder einer ID, oder setzen Sie [`ANTHROPIC_MODEL`](/de/env-vars). Der Fehlertext zeigt `Run --model` auf dieser Oberfläche.

830* **Agent SDK**: Der Fehlertext lässt den Hinweis weg, da das Modell programmgesteuert gesetzt wird. Setzen Sie [`model` auf `Options`](/de/agent-sdk/typescript#options) in TypeScript oder [`ClaudeAgentOptions(model=...)`](/de/agent-sdk/python#claudeagentoptions) in Python, und behandeln Sie den strukturierten `model_not_found` Fehler, um Ihre eigene Wiederholung oder Modellauswahl anzuzeigen.858* **Agent SDK**: Der Fehlertext lässt den Hinweis weg, da das Modell programmgesteuert gesetzt wird. Setzen Sie [`model` auf `Options`](/de/agent-sdk/typescript#options) in TypeScript oder [`ClaudeAgentOptions(model=...)`](/de/agent-sdk/python#claudeagentoptions) in Python, und behandeln Sie den strukturierten `model_not_found`-Fehler, um Ihren eigenen Wiederholungs- oder Modellwähler anzuzeigen.

831* Verwenden Sie einen Alias wie `sonnet` oder `opus` statt einer vollständigen versionierten ID. Aliases verfolgen die neueste Version, daher werden sie nicht veraltet. Siehe [Modellkonfiguration](/de/model-config).859* Verwenden Sie einen Alias wie `sonnet` oder `opus` anstelle einer vollständigen versionierten ID. Aliase werden zu einem verwalteten Standard aufgelöst, sodass sie nicht veralten. Siehe [Modellkonfiguration](/de/model-config).

832* Wenn das falsche Modell immer wieder zurückkommt, ist eine veraltete ID irgendwo gesetzt. Überprüfen Sie in [Prioritätsreihenfolge](/de/model-config#setting-your-model): das `--model` Flag, die `ANTHROPIC_MODEL` Umgebungsvariable, dann das `model` Feld in `.claude/settings.local.json`, die `settings.json` Ihres Projekts und `~/.claude/settings.json`. Entfernen Sie den veralteten Wert und Claude Code fällt auf Ihren Kontostandard zurück.860* Wenn die falsche Modell immer wieder in der CLI zurückkommt, ist eine veraltete ID irgendwo gesetzt. Überprüfen Sie in [Prioritätsreihenfolge](/de/model-config#setting-your-model): das `--model`-Flag, die `ANTHROPIC_MODEL`-Umgebungsvariable, dann das `model`-Feld in `.claude/settings.local.json`, die `.claude/settings.json` Ihres Projekts und `~/.claude/settings.json`. Entfernen Sie den veralteten Wert und Claude Code fällt auf Ihren Kontostandardwert zurück.

833* Für Vertex AI-Bereitstellungen siehe [Vertex AI-Fehlerbehebung](/de/google-vertex-ai#troubleshooting).861* Für Google Cloud's Agent Platform-Bereitstellungen siehe [Google Cloud's Agent Platform-Fehlerbehebung](/de/google-vertex-ai#troubleshooting).

862 

863<h3 id="model-is-not-a-recognized-model-id">

864 Modell ist keine erkannte Modell-ID

865</h3>

866 

867Die 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`, wobei 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 beim nächsten Request mit [Es gibt ein Problem mit dem ausgewählten Modell](#there%E2%80%99s-an-issue-with-the-selected-model) fehl.

868 

869```text theme={null}

870Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

871```

872 

873Der nachfolgende Hinweis nennt den nächsten passenden Alias oder die Modell-ID. Wenn nichts nah genug ist, lautet es stattdessen `Run /model to see available models.`

874 

875Claude 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](/de/agent-sdk/typescript) `setModel()`-Methode oder durch eine App wie die [Desktop-App](/de/desktop) gesetzt wird, die die Claude Code CLI für Sie ausführt.

876 

877**Was zu tun ist:**

878 

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

880* 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 Überprüfung, auch wenn das Modell neuer ist als Ihre Claude Code-Version, sodass ein Upgrade nicht erforderlich ist.

881* 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 [Es gibt ein Problem mit dem ausgewählten Modell](#there%E2%80%99s-an-issue-with-the-selected-model) aufgelisteten Speicherorten.

882* Die Überprüfung wird nur auf der Anthropic API ausgeführt. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/de/claude-platform-on-aws) und hinter einem [LLM-Gateway](/de/llm-gateway) oder einer benutzerdefinierten `ANTHROPIC_BASE_URL` definiert Ihr Anbieter oder Gateway die Modellnamen, sodass Claude Code jede Zeichenkette akzeptiert und durchleitet.

834 883 

835<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">884<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

836 Claude Opus is not available with the Claude Pro plan885 Claude Opus ist nicht mit dem Claude Pro-Plan verfügbar

837</h3>886</h3>

838 887 

839Ihr aktiver Abonnementplan enthält nicht das Modell, das Sie ausgewählt haben.888Ihr aktiver Abonnementplan beinhaltet nicht das Modell, das Sie ausgewählt haben.

840 889 

841```text theme={null}890```text theme={null}

842Claude Opus is not available with the Claude Pro plan · Select a different model in /model891Claude Opus is not available with the Claude Pro plan · Select a different model in /model


844 893 

845**Was zu tun ist:**894**Was zu tun ist:**

846 895 

847* Führen Sie `/model` aus und wählen Sie ein Modell, das Ihr Plan enthält896* Führen Sie `/model` aus und wählen Sie ein Modell, das Ihr Plan beinhaltet

848* Wenn Sie Ihren Plan kürzlich aktualisiert haben und dies immer noch sehen, führen Sie `/logout` dann `/login` aus. Der gespeicherte Token spiegelt Ihren Plan zum Zeitpunkt der Anmeldung wider, daher wird ein Upgrade im Web nicht in einer bestehenden Sitzung wirksam, bis Sie sich erneut authentifizieren.897* 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, sodass ein Upgrade im Web in einer bestehenden Sitzung erst nach erneuter Authentifizierung wirksam wird.

849* Siehe [claude.com/pricing](https://claude.com/pricing) für die Modelle, die jeder Plan enthält898* Siehe [claude.com/pricing](https://claude.com/pricing) für die Modelle, die jeder Plan beinhaltet

850 899 

851<h3 id="model-is-restricted-by-your-organization’s-settings">900<h3 id="model-is-restricted-by-your-organization’s-settings">

852 Model is restricted by your organization's settings901 Modell ist durch die Einstellungen Ihrer Organisation eingeschränkt

853</h3>902</h3>

854 903 

855Ihr Organisationsadministrator hat dieses Modell in der Claude Console deaktiviert, oder es wird durch eine [`availableModels`](/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.904Ihr Organisationsadministrator hat dieses Modell in der claude.ai-Administratorkonsole deaktiviert, oder es ist durch eine [`availableModels`](/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.

856 905 

857```text theme={null}906```text theme={null}

858Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.907Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

859```908```

860 909 

910Claude Code behandelt einen Modellgruppen-Alias, einen von `opus`, `sonnet`, `haiku` oder `fable`, als Anfrage für diese Gruppe statt für ihre neueste Version. Auf der Anthropic API und auf [Claude Platform on AWS](/de/claude-platform-on-aws) wird ein eingeschränkter Gruppen-Alias zur neuesten Version der Gruppe aufgelöst, die Ihre Organisation und die `availableModels`-Zulassungsliste zulassen, und die Ersetzungsmitteilung nennt diese Version. Claude Code lehnt `/model <alias>` nur ab, wenn jede Version der Gruppe eingeschränkt ist. Vor v2.1.205 wurde ein Gruppen-Alias basierend auf seiner neuesten Version allein ersetzt oder abgelehnt, auch wenn eine ältere Version derselben Gruppe zulässig war.

911 

861**Was zu tun ist:**912**Was zu tun ist:**

862 913 

863* Führen Sie `/model` aus, um aus den Modellen auszuwählen, die Ihre Organisation zulässt. Eingeschränkte Modelle sind in der Auswahl verborgen.914* Führen Sie `/model` aus, um aus den Modellen auszuwählen, die Ihre Organisation zulässt. Eingeschränkte Modelle sind im Wähler verborgen.

864* Wenn das eingeschränkte Modell in `--model`, `ANTHROPIC_MODEL` oder dem `model` Feld einer Einstellungsdatei gesetzt wurde, entfernen oder aktualisieren Sie diesen Wert, damit die Benachrichtigung nicht bei jedem Start erneut angezeigt wird915* Wenn das eingeschränkte Modell in `--model`, `ANTHROPIC_MODEL` oder dem `model`-Feld einer Einstellungsdatei gesetzt wurde, entfernen oder aktualisieren Sie diesen Wert, sodass die Mitteilung nicht bei jedem Start erneut angezeigt wird

865* Wenn Sie Zugriff auf das eingeschränkte Modell benötigen, bitten Sie Ihren Organisationsadministrator, es zu aktivieren. Siehe [Organisationsmodellbeschränkungen](/de/model-config#organization-model-restrictions).916* Wenn Sie Zugriff auf das eingeschränkte Modell benötigen, bitten Sie Ihren Organisationsadministrator, es zu aktivieren. Siehe [Organisationsmodell-Einschränkungen](/de/model-config#organization-model-restrictions).

866 917 

867<h3 id="thinking-type-enabled-is-not-supported-for-this-model">918<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

868 thinking.type.enabled is not supported for this model919 thinking.type.enabled wird für dieses Modell nicht unterstützt

869</h3>920</h3>

870 921 

871Ihre Claude Code-Version ist älter als das Minimum für Sonnet 5, Opus 4.8 oder Opus 4.7. Die CLI hat eine Thinking-Konfiguration gesendet, die das Modell nicht mehr akzeptiert.922Ihre Claude Code-Version ist älter als das Minimum für Sonnet 5, Opus 4.8 oder Opus 4.7. Die CLI hat eine Thinking-Konfiguration gesendet, die das Modell nicht mehr akzeptiert.


881* {/* min-version: agent-sdk@0.3.197 */}Wenn Sie dies im [Agent SDK](/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äter932* {/* min-version: agent-sdk@0.3.197 */}Wenn Sie dies im [Agent SDK](/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

882 933 

883<h3 id="thinking-budget-exceeds-output-limit">934<h3 id="thinking-budget-exceeds-output-limit">

884 Thinking budget exceeds output limit935 Thinking-Budget überschreitet Ausgabelimit

885</h3>936</h3>

886 937 

887Das konfigurierte Extended Thinking-Budget überschreitet die maximale Antwortlänge, daher bleibt kein Platz für die tatsächliche Antwort.938Das konfigurierte Extended Thinking-Budget überschreitet die maximale Antwortlänge, sodass kein Platz für die eigentliche Antwort bleibt.

888 939 

889```text theme={null}940```text theme={null}

890API Error: 400 ... max_tokens must be greater than thinking.budget_tokens941API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

891```942```

892 943 

893Claude Code passt diese Werte auf der Anthropic API automatisch an. Sie sehen diesen Fehler normalerweise auf Amazon Bedrock oder Google Vertex AI, wenn [`MAX_THINKING_TOKENS`](/de/env-vars) höher als das Output-Limit des Anbieters gesetzt ist, oder wenn Plan Mode das Thinking-Budget erhöht.944Claude Code passt diese Werte auf der Anthropic API automatisch an. Sie sehen diesen Fehler normalerweise auf Amazon Bedrock oder Google Cloud's Agent Platform, wenn [`MAX_THINKING_TOKENS`](/de/env-vars) höher als das Ausgabelimit des Anbieters gesetzt ist, oder wenn Plan Mode das Thinking-Budget erhöht.

894 945 

895**Was zu tun ist:**946**Was zu tun ist:**

896 947 

897* Senken Sie `MAX_THINKING_TOKENS`, oder erhöhen Sie [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/de/env-vars) über das Thinking-Budget948* Senken Sie `MAX_THINKING_TOKENS`, oder erhöhen Sie [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/de/env-vars) über das Thinking-Budget

898* Siehe [Extended Thinking](/de/model-config#extended-thinking) für wie das Budget mit der Ausgabelänge interagiert949* Siehe [Extended Thinking](/de/model-config#extended-thinking) für die Interaktion des Budgets mit der Ausgabelänge

899 950 

900<h3 id="tool-use-or-thinking-block-mismatch">951<h3 id="tool-use-or-thinking-block-mismatch">

901 Tool use or thinking block mismatch952 Tool-Verwendung oder Thinking-Block-Nichtübereinstimmung

902</h3>953</h3>

903 954 

904Die Konversationshistorie erreichte die API in einem inkonsistenten Zustand, normalerweise nachdem ein Tool-Aufruf unterbrochen oder ein Turn während des Streams bearbeitet wurde.955Die Gesprächshistorie erreichte die API in einem inkonsistenten Zustand, normalerweise nachdem ein Tool-Aufruf unterbrochen oder ein Turn während des Streams bearbeitet wurde.

905 956 

906```text theme={null}957```text theme={null}

907API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.958API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.


909API Error: 400 ... thinking blocks ... cannot be modified960API Error: 400 ... thinking blocks ... cannot be modified

910```961```

911 962 

912Alle drei Varianten bedeuten das Gleiche: die Sequenz von `tool_use`, `tool_result` und `thinking` Blöcken in der Historie stimmt nicht mehr mit dem überein, was die API erwartet.963Alle drei 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.

913 964 

914**Was zu tun ist:**965**Was zu tun ist:**

915 966 

916* {/* max-version: 2.1.155 */}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-Nutzung auslösen, und `/rewind` löscht ihn nicht.967* {/* max-version: 2.1.155 */}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.

917* Führen Sie `/rewind` aus, oder drücken Sie Esc zweimal, um zu einem Checkpoint vor dem beschädigten Turn zurückzugehen und von dort aus fortzufahren. Siehe [Checkpointing](/de/checkpointing) für die Erstellung und Wiederherstellung von Checkpoints.968* Führen Sie `/rewind` aus, oder drücken Sie Esc zweimal, um zu einem Checkpoint vor dem beschädigten Turn zurückzugehen und von dort aus fortzufahren. Siehe [Checkpointing](/de/checkpointing) für die Erstellung und Wiederherstellung von Checkpoints.

918 969 

919<h3 id="usage-policy-refusal">970<h3 id="usage-policy-refusal">

920 Usage Policy refusal971 Richtlinienverletzung bei Nutzung

921</h3>972</h3>

922 973 

923Die API lehnte es ab zu antworten, weil Inhalte in der Konversation eine [Nutzungsrichtlinie](https://www.anthropic.com/legal/aup) Überprüfung ausgelöst haben. Die Nachricht enthält eine Request-ID, die Sie dem Support mitteilen können, wenn Sie glauben, dass die Ablehnung falsch ist.974Die API lehnte es ab zu antworten, da Inhalte im Gespräch eine [Nutzungsrichtlinie](https://www.anthropic.com/legal/aup)-Überprüfung auslösten. Die Nachricht enthält eine Request-ID, die Sie dem Support mitteilen können, wenn Sie glauben, dass die Ablehnung falsch ist.

924 975 

925```text theme={null}976```text theme={null}

926API Error: 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.977API Error: 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.

927```978```

928 979 

929Die Überprüfung bewertet die gesamte Konversation, nicht nur Ihren neuesten Prompt, 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.980Die Überprüfung bewertet das gesamte Gespräch, nicht nur Ihre neueste Eingabeaufforderung, sodass das Senden einer neuen Nachricht in derselben Sitzung normalerweise dieselbe Ablehnung erneut auslöst. 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](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) und [Microsoft Foundry](/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).

981 

982**Was zu tun ist:**

983 

984* Drücken Sie Esc zweimal oder führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der die Ablehnung auslöste, und formulieren Sie dann neu oder versuchen Sie einen anderen Ansatz. Siehe [Checkpointing](/de/checkpointing).

985* Wenn Sie nicht identifizieren können, welcher Turn es verursacht hat, führen Sie `/clear` aus, um ein neues Gespräch im selben Projekt zu starten. Ihr vorheriges Gespräch bleibt auf der Festplatte erhalten und ist in `/resume` verfügbar.

986* Im [nicht-interaktiven Modus](/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, sodass der Wechsel zu einem anderen Modell mit `--model` die Ablehnung in einigen Fällen auch beheben kann.

987 

988<h3 id="safety-measures-flagged-a-cybersecurity-topic">

989 Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet

990</h3>

991 

992Die Sicherheitsmaßnahmen des Modells haben Inhalte im Gespräch als Cybersicherheitsthema gekennzeichnet. Die Nachricht nennt das Modell, das die Anfrage gekennzeichnet hat:

993 

994```text theme={null}

995API Error: Opus 4.8 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: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.

996 

997If you were not engaging in a cybersecurity topic, please send feedback via /feedback.

998```

999 

1000Die Nachricht 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. Die Schutzmaßnahme selbst ist serverseitig und stammt vor v2.1.203; diese Version änderte nur die Formulierung der Nachricht und die Seite, auf die sie verlinkt.

1001 

1002Was Sie sehen, hängt von Ihrem Anbieter und Modus ab:

1003 

1004* Auf [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) und [Microsoft Foundry](/de/microsoft-foundry) erzeugt eine Cybersicherheits-Kennzeichnung stattdessen die [Richtlinienverletzung bei Nutzung](#usage-policy-refusal)-Nachricht.

1005* Der [nicht-interaktive Modus](/de/headless) lässt den `/feedback`-Satz weg.

1006 

1007{/* max-version: 2.1.202 */}Vor v2.1.203 lautete die Nachricht `<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.

1008 

1009**Was zu tun ist:**

1010 

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

1012* Wenn Ihre Anfrage nicht über ein Cybersicherheitsthema war, führen Sie `/feedback` aus, um das falsch positive Ergebnis zu melden

1013* Um in derselben Sitzung weiterzuarbeiten, drücken Sie Esc zweimal oder führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der die Kennzeichnung auslöste, und versuchen Sie dann einen anderen Ansatz. Siehe [Checkpointing](/de/checkpointing).

1014 

1015<h2 id="installation-errors">

1016 Installationsfehler

1017</h2>

1018 

1019Diese Fehler treten bei der Installation oder Aktualisierung von Claude Code auf, entweder vom [Installationsskript](/de/setup#install-claude-code), von `claude install` oder von `claude update`. Für `command not found`, PATH-, Berechtigungs- und TLS-Probleme während der Einrichtung siehe [Installationen und Anmeldung beheben](/de/troubleshoot-install).

1020 

1021<h3 id="installation-was-killed-before-it-could-finish">

1022 Installation wurde beendet, bevor sie abgeschlossen werden konnte

1023</h3>

1024 

1025Das Installationsskript meldet, wenn der `claude install`-Schritt durch ein Signal beendet wird. Unter Linux bedeutet Exit-Code 137, dass der Prozess SIGKILL erhalten hat, und auf einem Host mit wenig Speicher ist das normalerweise der Kernel-Out-of-Memory (OOM)-Killer. Das Skript gibt diese Erklärung aus und beendet sich mit Code 137:

1026 

1027```text theme={null}

1028Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

1029Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

1030```

1031 

1032Für jedes andere tödliche Signal und für Exit-Code 137 auf macOS gibt das Skript `Installation was killed before it could finish (exit code <N>)` mit dem tatsächlichen Exit-Code aus und lässt die Out-of-Memory-Erklärung weg. Die Meldung stammt vom Installationsskript, das macOS und Linux verwenden, das auch Installationen innerhalb von WSL abdeckt; die nativen Windows-Installationsskripte geben es nie aus. Vor v2.1.200 beendete sich das Skript nur mit der bloßen `Killed`-Zeile der Shell.

1033 

1034**Was zu tun ist:**

1035 

1036* Beenden Sie andere Prozesse, um Speicher freizugeben, und führen Sie dann das Installationsprogramm erneut aus

1037* Fügen Sie Swap-Speicher hinzu oder wechseln Sie zu einer größeren Instanz. Siehe [Installation auf Linux-Servern mit wenig Speicher beendet](/de/troubleshoot-install#install-killed-on-low-memory-linux-servers) für die Swap-Datei-Befehle.

1038 

1039<h3 id="the-connection-dropped-while-downloading-the-update">

1040 Die Verbindung wurde während des Download der Aktualisierung unterbrochen

1041</h3>

1042 

1043Die Verbindung zum Download-Server wurde geschlossen, während `claude install`, `claude update` oder das [automatische Update-Programm](/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. {/* min-version: 2.1.202 */}Vor v2.1.202 führte eine einzelne unterbrochene Verbindung sofort zum Fehlschlag des Downloads mit dem bloßen Fehler `aborted` statt zu wiederholen.

1044 

1045```text theme={null}

1046The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

1047```

1048 

1049Der Text in Klammern nennt, welcher Versuch fehlgeschlagen ist, und den zugrunde liegenden Netzwerkfehler. `claude update` stellt der Meldung `Error: Failed to install native update` auf stderr voran.

1050 

1051Ein 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. Vor v2.1.205 wurde die gleiche 10-Minuten-Frist als generischer `timeout of 600000ms exceeded` des HTTP-Clients gemeldet.

1052 

1053Die übliche 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 beeinträchtigt, dennoch unterbrochen werden.

930 1054 

931**Was zu tun ist:**1055**Was zu tun ist:**

932 1056 

933* Drücken Sie Esc zweimal oder führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der die Ablehnung ausgelöst hat, dann umformulieren Sie oder versuchen Sie einen anderen Ansatz. Siehe [Checkpointing](/de/checkpointing).1057* Führen Sie `claude update` erneut aus. Bei einem ansonsten gesunden Netzwerk ist der Download normalerweise beim nächsten Durchlauf erfolgreich. Für die Timeout-Meldung führen Sie es erneut aus einem schnelleren oder weniger gedrosselten Netzwerk aus.

934* Wenn Sie nicht identifizieren können, welcher Turn es verursacht hat, führen Sie `/clear` aus, um eine neue Konversation im gleichen Projekt zu starten. Ihre vorherige Konversation wird auf der Festplatte beibehalten und bleibt in `/resume` verfügbar.1058* Wenn Ihr Netzwerk einen Proxy erfordert, setzen Sie `HTTPS_PROXY` vor dem Ausführen des Installationsprogramms oder `claude update`. Siehe [Netzwerkkonnektivität überprüfen](/de/troubleshoot-install#check-network-connectivity).

935* Im [nicht-interaktiven Modus](/de/headless) (`-p`), wo Rewind nicht verfügbar ist, versuchen Sie es erneut mit einem umformulierten Prompt in einer neuen Sitzung ohne `--continue`. Policy-Überprüfungen variieren je nach Modell, daher kann ein Wechsel zu einem anderen Modell mit `--model` die Ablehnung in einigen Fällen auch beheben.1059* Wenn ein Unternehmens-Proxy die Übertragung immer wieder beendet, bitten Sie Ihr Netzwerk-Team, den vollständigen Download von `downloads.claude.ai` zuzulassen. Siehe [Netzwerkzugriffsanforderungen](/de/network-config#network-access-requirements).

1060* Führen Sie `claude doctor` aus Ihrer Shell aus, um Installationsdiagnosen durchzuführen

936 1061 

937<h2 id="command-line-errors">1062<h2 id="command-line-errors">

938 Command-line errors1063 Befehlszeilenfehler

939</h2>1064</h2>

940 1065 

941Diese Fehler stammen von Claude Codes eigener Validierung der `claude` Befehlszeile. Claude Code gibt sie sofort aus, bevor es eine Sitzung erstellt oder eine API-Anfrage sendet.1066Diese Fehler stammen aus dem `claude` Befehl und seinen Unterbefehlen. Claude Code gibt sie aus, bevor er Ihren Prompt ausführt oder eine API-Anfrage sendet.

942 1067 

943<h3 id="conflict-between-bg-and-print">1068<h3 id="conflict-between-bg-and-print">

944 Conflict between --bg and --print1069 Konflikt zwischen --bg und --print

945</h3>1070</h3>

946 1071 

947Diese Meldung erfordert Claude Code v2.1.198 oder später. Sie haben `--bg` mit `-p` oder `--print` in der gleichen `claude` Invokation kombiniert. `--bg` startet eine [Hintergrundsitzung](/de/agent-view#from-your-shell), die Sie später mit `claude agents` anhängen, während `--print` [nicht-interaktiv](/de/headless) ausgeführt wird und nie die interaktive Sitzung startet, die `claude agents` anhängt. Vor v2.1.198 erstellte diese Kombination stillschweigend einen Background-Job, der nie angehängt werden konnte.1072Diese Meldung erfordert Claude Code v2.1.198 oder später. Sie haben `--bg` mit `-p` oder `--print` in demselben `claude` Aufruf kombiniert. `--bg` startet eine [Hintergrundsitzung](/de/agent-view#from-your-shell), an die Sie sich später mit `claude agents` anschließen, während `--print` [nicht interaktiv](/de/headless) ausgeführt wird und niemals die interaktive Sitzung startet, an die sich `claude agents` anschließt. Vor v2.1.198 hat diese Kombination stillschweigend einen Hintergrund-Job erstellt, der niemals angehängt werden konnte.

948 1073 

949```text theme={null}1074```text theme={null}

950--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.1075--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.


952 1077 

953**Was zu tun ist:**1078**Was zu tun ist:**

954 1079 

955* Lassen Sie `-p` oder `--print` weg. `--bg` nimmt den Prompt als sein Positions-Argument, daher ist `claude --bg "<task>"` der vollständige Befehl. Siehe [Dispatch new agents from your shell](/de/agent-view#from-your-shell).1080* Lassen Sie `-p` oder `--print` weg. `--bg` nimmt den Prompt als sein Positionsargument, also ist `claude --bg "<task>"` der vollständige Befehl. Siehe [Dispatch new agents from your shell](/de/agent-view#from-your-shell).

956* Um den Prompt nicht-interaktiv auszuführen und das Ergebnis auszudrucken, anstatt eine Hintergrundsitzung zu erstellen, lassen Sie `--bg` weg und führen Sie `claude -p "<task>"` aus1081* Um den Prompt nicht interaktiv auszuführen und das Ergebnis auszugeben, anstatt eine Hintergrundsitzung zu erstellen, lassen Sie `--bg` weg und führen Sie `claude -p "<task>"` aus

1082 

1083<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

1084 Der --json-schema Wert ist kein gültiges JSON Schema

1085</h3>

1086 

1087Das Schema, das Sie an [`--json-schema`](/de/cli-reference#cli-flags) im [nicht interaktiven Modus](/de/headless#get-structured-output) übergeben haben, ist bei der JSON Schema Kompilierung fehlgeschlagen, daher beendet sich `claude` mit Code 1, anstatt den Prompt auszuführen. Vor v2.1.205 hat ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler erzeugt, und jedes Schema, das das `format` Schlüsselwort verwendete, wurde als ungültig behandelt.

1088 

1089```text theme={null}

1090Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

1091```

1092 

1093Der Text nach dem zweiten Doppelpunkt ist die Diagnose des Validators und benennt das Schlüsselwort oder die Position, die fehlgeschlagen ist. Schemas, die das `format` Schlüsselwort verwenden, wie z. B. `"format": "email"`, sind gültig: Claude Code akzeptiert `format` als Anmerkung und erzwingt es nicht.

1094 

1095Claude Code führt zwei Überprüfungen vor der Schema-Kompilierung durch: Es lehnt einen Wert ab, der nicht als JSON analysierbar ist, mit `Error: --json-schema is not valid JSON` ab, und gültiges JSON, das kein Objekt ist, mit `Error: --json-schema must be a JSON object`.

1096 

1097**Was zu tun ist:**

1098 

1099* Beheben Sie den Teil des Schemas, den die Diagnose benennt, und führen Sie dann den Befehl erneut aus

1100* Wenn die Diagnose `schema too large` ist, reduzieren Sie die Verschachtelung des Schemas und die `$ref` Wiederverwendung

1101* Siehe [Get structured output](/de/headless#get-structured-output) für ein funktionierendes Schema und einen Befehl

1102 

1103<h3 id="could-not-import-a-server-from-claude-desktop">

1104 Server konnte nicht aus Claude Desktop importiert werden

1105</h3>

1106 

1107Claude Code konnte einen der Server, die Sie in `claude mcp add-from-claude-desktop` ausgewählt haben, nicht hinzufügen. Der Befehl importiert weiterhin die anderen ausgewählten Server und gibt eine Zeile pro Server aus, 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.

1108 

1109```text theme={null}

1110Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

1111```

1112 

1113Der Text nach dem Servernamen ist der Grund. Der häufigste ist die Namensüberprüfung: Claude Desktop erlaubt Zeichen in Servernamen, wie Leerzeichen und Punkte, die `claude mcp` auf Buchstaben, Zahlen, Bindestriche und Unterstriche beschränkt. Andere Gründe sind eine Serverkonfiguration, die die Validierung nicht besteht, und ein Server, der durch die [MCP-Richtlinie](/de/managed-mcp) Ihrer Organisation blockiert wird.

1114 

1115**Was zu tun ist:**

1116 

1117* Benennen Sie den Server in `claude_desktop_config.json` um, um nur Buchstaben, Zahlen, Bindestriche und Unterstriche zu verwenden, und führen Sie dann `claude mcp add-from-claude-desktop` erneut aus

1118* Fügen Sie diesen Server direkt mit `claude mcp add` oder `claude mcp add-json` unter einem gültigen Namen hinzu. Siehe [Import MCP servers from Claude Desktop](/de/mcp#import-mcp-servers-from-claude-desktop).

1119 

1120<h2 id="plugin-errors">

1121 Plugin-Fehler

1122</h2>

1123 

1124Diese Fehler stammen aus der [Plugin](/de/plugins)- und [Marketplace](/de/plugin-marketplaces)-Konfiguration. Bei Plugin-Problemen, die keine der Meldungen auf dieser Seite erzeugen, z. B. eine Marketplace-URL, die nicht geladen wird, oder ein Plugin, das installiert wird, aber nicht angezeigt wird, siehe [Plugin-Fehlerbehebung](/de/discover-plugins#troubleshooting).

1125 

1126<h3 id="marketplace-is-registered-from-an-untrusted-source">

1127 Marketplace ist von einer nicht vertrauenswürdigen Quelle registriert

1128</h3>

1129 

1130Der Marketplace ist unter einem Namen registriert, der [für offizielle Anthropic-Marketplaces reserviert ist](/de/plugin-marketplaces#marketplace-schema), 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.

1131 

1132```text theme={null}

1133Marketplace "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.

1134```

1135 

1136**Was zu tun ist:**

1137 

1138* Führen Sie `claude plugin marketplace remove <name>` aus und fügen Sie den Marketplace dann erneut aus dem offiziellen `github.com/anthropics`-Repository hinzu

1139* Wenn Sie einen Drittanbieter-Marketplace veröffentlichen, der den Namen verwendet hat, bevor er reserviert wurde, benennen Sie ihn um und bitten Sie Benutzer, ihn von Ihrer Quelle erneut hinzuzufügen

1140* Siehe die Liste der reservierten Namen unter [Marketplace-Schema](/de/plugin-marketplaces#marketplace-schema)

1141 

1142<h2 id="configuration-warnings">

1143 Konfigurationswarnungen

1144</h2>

1145 

1146Claude Code schreibt diese Meldungen beim Start in stderr statt einen Fehler im Gespräch anzuzeigen. Sie berichten über Konfigurationen, die gelesen, aber nicht angewendet wurden.

1147 

1148<h3 id="workspace-has-not-been-trusted">

1149 Arbeitsbereich wurde nicht vertraut

1150</h3>

1151 

1152Claude Code fand `permissions.allow`-Regeln oder `permissions.additionalDirectories`-Einträge in der Datei `.claude/settings.json` oder `.claude/settings.local.json` des Projekts und wendete sie nicht an, da [Allow-Regeln aus Projekteinstellungen Arbeitsbereichsvertrauen erfordern](/de/permissions#project-allow-rules-and-workspace-trust). Die Anzahl, der Einstellungsname und die in der Meldung genannte Datei variieren je nach Ihrer Konfiguration. `deny`- und `ask`-Regeln sind nicht betroffen.

1153 

1154```text theme={null}

1155Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.

1156```

1157 

1158**Was zu tun ist:**

1159 

1160* Führen Sie `claude` im Verzeichnis aus und akzeptieren Sie den Vertrauensdialog. {/* min-version: 2.1.200 */}Der Dialog wird auch angezeigt, wenn ein übergeordnetes Verzeichnis bereits vertraut ist, listet die zurückgehaltenen Regeln auf und ermöglicht es Ihnen, abzulehnen und ohne diese weiterzuarbeiten. Vor v2.1.200 wurde in dieser Situation kein Dialog angezeigt, daher konnte dieser Schritt dort nicht abgeschlossen werden.

1161* Im [nicht-interaktiven Modus](/de/headless) mit `-p` wird kein Dialog angezeigt. Legen Sie den `hasTrustDialogAccepted`-Eintrag in `~/.claude.json` mit dem genauen `projects`-Schlüssel fest, den die Meldung ausgibt.

1162* {/* min-version: 2.1.200 */}Wenn die Meldung `.claude/settings.local.json` nennt und Sie Claude Code außerhalb eines Git-Repositorys oder in Ihrem Home-Verzeichnis gestartet haben, aktualisieren Sie auf v2.1.200 oder später. Die Versionen 2.1.196 bis 2.1.199 behandelten Ihre eigene `.claude/settings.local.json` in diesen Arbeitsbereichen als vom Repository bereitgestellt. Siehe [Project allow rules and workspace trust](/de/permissions#project-allow-rules-and-workspace-trust).

957 1163 

958<h2 id="responses-seem-lower-quality-than-usual">1164<h2 id="responses-seem-lower-quality-than-usual">

959 Responses seem lower quality than usual1165 Antworten scheinen von geringerer Qualität als üblich

960</h2>1166</h2>

961 1167 

962Wenn Claudes Antworten weniger fähig erscheinen als erwartet, aber kein Fehler angezeigt wird, ist die Ursache normalerweise der Konversationszustand und nicht das Modell selbst. Claude Code ändert Modellversionen nicht stillschweigend. Es kann in drei spezifischen Fällen zu einem Fallback-Modell wechseln:1168Wenn Claudes Antworten weniger leistungsfähig erscheinen als erwartet, aber kein Fehler angezeigt wird, liegt die Ursache normalerweise im Gesprächszustand und nicht im Modell selbst. Claude Code ändert nicht stillschweigend Modellversionen. Es kann in drei spezifischen Fällen zu einem Fallback-Modell wechseln:

963 1169 

964* Ein konfiguriertes [`--fallback-model`](/de/cli-reference#cli-flags) übernimmt nach einem Verfügbarkeitsfehler für diesen Turn nur mit einer Benachrichtigung im Transkript1170* Ein konfiguriertes [`--fallback-model`](/de/cli-reference#cli-flags) übernimmt nach einem Verfügbarkeitsfehler für diesen Zug nur mit einer Notiz im Transkript

965* Eine Bedrock- oder Vertex AI-Startprüfung stellt fest, dass Ihr Standardmodell nicht verfügbar ist1171* Eine Amazon Bedrock oder Google Cloud Agent Platform Startprüfung stellt fest, dass Ihr Standardmodell nicht verfügbar ist

966* [Automatic model fallback](/de/model-config#automatic-model-fallback) auf Fable 5 verschiebt die Sitzung zum Standard-Opus-Modell und zeigt eine Benachrichtigung im Transkript1172* [Automatisches Modell-Fallback](/de/model-config#automatic-model-fallback) auf Fable 5 verschiebt die Sitzung zum Standard-Opus-Modell und zeigt eine Notiz im Transkript an

967 1173 

968Die Modellauswahlprüfung unten erfasst den zweiten und dritten Fall; der erste erscheint als Transkriptbenachrichtigung statt als `/model`-Änderung. [Model configuration](/de/model-config) erklärt, wann jeder Fallback angewendet wird.1174Die Modellauswahlprüfung unten erfasst den zweiten und dritten Fall; der erste erscheint als Transkriptnotiz statt als `/model`-Änderung. [Modellkonfiguration](/de/model-config) erklärt, wann jedes Fallback gilt.

969 1175 

970Überprüfen Sie diese zuerst:1176Überprüfen Sie diese zuerst:

971 1177 

972* **Modellauswahl**: Führen Sie `/model` aus, um zu bestätigen, dass Sie auf dem Modell sind, das Sie erwarten. Eine vorherige `/model`-Wahl oder eine `ANTHROPIC_MODEL` Umgebungsvariable kann Sie auf einem kleineren Modell haben als beabsichtigt.1178* **Modellauswahl**: Führen Sie `/model` aus, um zu bestätigen, dass Sie sich auf dem erwarteten Modell befinden. Eine vorherige `/model`-Auswahl oder eine `ANTHROPIC_MODEL`-Umgebungsvariable könnte Sie auf einem kleineren Modell als beabsichtigt platzieren.

973* **Anstrengungsstufe**: Führen Sie `/effort` aus, um die aktuelle Reasoning-Stufe zu überprüfen und sie für schwieriges Debugging oder Design-Arbeit zu erhöhen. Die Standardwerte variieren je nach Modell, daher überprüfen Sie, bevor Sie davon ausgehen, dass Sie unter dem Maximum sind. Siehe [Adjust effort level](/de/model-config#adjust-effort-level) für Pro-Modell-Standardwerte und die `ultrathink` Verknüpfung.1179* **Anstrengungsgrad**: Führen Sie `/effort` aus, um die aktuelle Reasoning-Ebene zu überprüfen und sie für schwieriges Debugging oder Designarbeit zu erhöhen. Die Standardwerte variieren je nach Modell, daher überprüfen Sie, bevor Sie davon ausgehen, dass Sie unter dem Maximum liegen. Siehe [Anstrengungsgrad anpassen](/de/model-config#adjust-effort-level) für modellspezifische Standardwerte und die `ultrathink`-Verknüpfung.

974* **Kontextdruck**: Führen Sie `/context` aus, um zu sehen, wie voll das Fenster ist. Wenn es sich der Kapazität nähert, führen Sie `/compact` an einem natürlichen Haltepunkt oder `/clear` aus, um neu zu beginnen. Siehe [Explore the context window](/de/context-window) für die Auswirkungen von auto-compact auf frühere Turns.1180* **Kontextdruck**: Führen Sie `/context` aus, um zu sehen, wie voll das Fenster ist. Wenn es sich der Kapazität nähert, führen Sie `/compact` an einem natürlichen Haltepunkt oder `/clear` aus, um neu zu beginnen. Siehe [Erkunden Sie das Kontextfenster](/de/context-window), um zu erfahren, wie Auto-Compact frühere Züge beeinflusst.

975* **Veraltete Anweisungen**: Große oder veraltete `CLAUDE.md` Dateien und MCP-Tool-Definitionen verbrauchen Kontext und können Antworten lenken. `/doctor` kennzeichnet übergroße Memory-Dateien und Subagenten-Definitionen; `/context` zeigt die MCP-Tool-Token-Nutzung.1181* **Veraltete Anweisungen**: Große oder veraltete `CLAUDE.md`-Dateien und MCP-Tool-Definitionen verbrauchen Kontext und können Antworten lenken. {/* min-version: 2.1.205 */}Die `/doctor`-Überprüfung kennzeichnet übergroße Speicherdateien und ungenutzte Erweiterungen, und `/context` zeigt die Token-Nutzung von MCP-Tools. Vor v2.1.205 öffnete `/doctor` einen Diagnosebildschirm, der übergroße Speicherdateien und Subagent-Definitionen kennzeichnete.

1182 

1183Wenn eine Antwort schiefgeht, funktioniert das Zurückspulen normalerweise besser als das Antworten mit Korrektionen. Drücken Sie zweimal Esc oder führen Sie `/rewind` aus, um vor dem fehlerhaften Zug zurückzugehen, und formulieren Sie dann die Eingabeaufforderung mit mehr Spezifika neu. Korrigieren im Thread behält den falschen Versuch im Kontext, was später Antworten daran verankern kann. Siehe [Checkpointing](/de/checkpointing).

976 1184 

977Wenn eine Antwort schiefgeht, funktioniert das Zurückspulen normalerweise besser als das Antworten mit Korrektionen. Drücken Sie Esc zweimal oder führen Sie `/rewind` aus, um zu vor dem schlechten Turn zurückzugehen, dann formulieren Sie den Prompt mit mehr Spezifika um. Korrigieren im Thread hält den falschen Versuch im Kontext, was später Antworten daran verankern kann. Siehe [Checkpointing](/de/checkpointing).1185Wenn die Qualität nach Überprüfung der obigen Punkte immer noch schlecht erscheint, führen Sie `/feedback` aus und beschreiben Sie, was Sie erwartet haben im Vergleich zu dem, was Sie erhalten haben. Auf diese Weise eingereichte Rückmeldungen enthalten das Gesprächstranskript, das die schnellste Möglichkeit für Anthropic ist, eine echte Regression zu diagnostizieren. Siehe [Fehler melden](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist.

978 1186 

979Wenn die Qualität immer noch seltsam wirkt, nachdem Sie das Obige überprüft haben, führen Sie `/feedback` aus und beschreiben Sie, was Sie erwartet haben versus was Sie bekommen haben. Auf diese Weise eingereichte Rückmeldungen enthalten das Konversationstranskript, das der schnellste Weg für Anthropic ist, eine echte Regression zu diagnostizieren. Siehe [Report an error](#report-an-error), wenn `/feedback` bei Ihrem Anbieter nicht verfügbar ist.1187{/* min-version: 2.1.201 */}Wenn Sonnet 5 eine Anfrage ablehnt und eine vermutete Prompt-Injection auf Claude Code v2.1.200 oder früher anführt, führen Sie `claude update` aus, um die v2.1.201-Korrektur zu erhalten.

980 1188 

981<h2 id="report-an-error">1189<h2 id="report-an-error">

982 Report an error1190 Fehler melden

983</h2>1191</h2>

984 1192 

985Für Fehler von Komponenten, die diese Seite nicht abdeckt, siehe das relevante Handbuch:1193Für Fehler von Komponenten, die auf dieser Seite nicht behandelt werden, siehe die relevanten Anleitungen:

986 1194 

987* MCP-Server konnte sich nicht verbinden oder authentifizieren: [MCP](/de/mcp)1195* MCP-Server konnte sich nicht verbinden oder authentifizieren: [MCP](/de/mcp)

988* Hook-Skript ist fehlgeschlagen oder hat ein Tool blockiert: [Debug hooks](/de/hooks#debug-hooks)1196* Hook-Skript ist fehlgeschlagen oder hat ein Tool blockiert: [Debug-Hooks](/de/hooks#debug-hooks)

989* Berechtigung verweigert oder Dateisystemfehler während der Installation: [Troubleshooting-Installation und Anmeldung](/de/troubleshoot-install)1197* Berechtigung verweigert oder Dateisystemfehler während der Installation: [Troubleshoot-Installation und -Anmeldung](/de/troubleshoot-install)

990 1198 

991Wenn ein Fehler hier nicht aufgelistet ist oder der vorgeschlagene Fix nicht hilft:1199Wenn ein Fehler hier nicht aufgeführt ist oder die vorgeschlagene Lösung nicht hilft:

992 1200 

993* Führen Sie `/feedback` in Claude Code aus, um das Transkript und eine Beschreibung an Anthropic zu senden. Der Befehl bietet auch an, ein vorausgefülltes GitHub-Problem zu öffnen. Auf Bedrock, Vertex AI, Foundry und anderen Drittanbieter-Plattformen speichert `/feedback` ein lokales Archiv, das Sie stattdessen an Ihren Anthropic-Kontovertreter senden können.1201* Führen Sie `/feedback` in Claude Code aus, um das Transkript und eine Beschreibung an Anthropic zu senden. Der Befehl bietet auch an, ein vorausgefülltes GitHub-Issue zu öffnen. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und anderen Drittanbieter-Plattformen speichert `/feedback` ein lokales Archiv, das Sie stattdessen an Ihren Anthropic-Kontorepräsentanten senden können.

994* Führen Sie `/doctor` aus, um auf lokale Konfigurationsprobleme zu überprüfen1202* Führen Sie `claude doctor` aus Ihrer Shell aus, um eine schreibgeschützte Diagnose Ihrer Installation zu erhalten, oder führen Sie die `/doctor`-Überprüfung in Claude Code aus, um Setup-Probleme zu finden und zu beheben

995* Überprüfen Sie [status.claude.com](https://status.claude.com) auf aktive Vorfälle1203* Überprüfen Sie [status.claude.com](https://status.claude.com) auf aktive Vorfälle

996* Suchen Sie [existing issues](https://github.com/anthropics/claude-code/issues) auf GitHub1204* Suchen Sie nach [bestehenden Issues](https://github.com/anthropics/claude-code/issues) auf GitHub

fast-mode.md +2 −2

Details

38* Geben Sie `/fast` ein und drücken Sie Tab, um ihn ein- oder auszuschalten38* Geben Sie `/fast` ein und drücken Sie Tab, um ihn ein- oder auszuschalten

39* Setzen Sie `"fastMode": true` in Ihrer [Benutzereinstellungsdatei](/de/settings)39* Setzen Sie `"fastMode": true` in Ihrer [Benutzereinstellungsdatei](/de/settings)

40 40 

41Standardmäßig bleibt der Schnellmodus über Sitzungen hinweg erhalten. Administratoren können den Schnellmodus so konfigurieren, dass er sich bei jeder Sitzung zurückgesetzt wird. Weitere Informationen finden Sie unter [Opt-in pro Sitzung erforderlich](#require-per-session-opt-in).41Standardmäßig bleibt der Schnellmodus, den Sie in einer interaktiven Sitzung aktivieren, über Sitzungen hinweg erhalten. {/* min-version: 2.1.205 */}Im [nicht-interaktiven Modus](/de/headless) mit dem `-p`-Flag funktioniert `/fast` nur in einer Sitzung, die mit dem Schnellmodus in ihrem [`--settings`](/de/cli-reference#cli-flags)-Wert gestartet wurde, zum Beispiel `claude -p --settings '{"fastMode": true}'`; der Toggle gilt dann nur für diese Sitzung und wird nicht als Ihr Standard gespeichert, und in jeder anderen nicht-interaktiven Sitzung meldet der Befehl, dass der Schnellmodus nicht verfügbar ist. Administratoren können den Schnellmodus so konfigurieren, dass er sich bei jeder Sitzung zurückgesetzt wird. Weitere Informationen finden Sie unter [Opt-in pro Sitzung erforderlich](#require-per-session-opt-in).

42 42 

43Für die beste Kosteneffizienz aktivieren Sie den Schnellmodus am Anfang einer Sitzung, anstatt ihn mitten in einem Gespräch zu wechseln. Weitere Informationen finden Sie unter [Kostenabwägung verstehen](#understand-the-cost-tradeoff).43Für die beste Kosteneffizienz aktivieren Sie den Schnellmodus am Anfang einer Sitzung, anstatt ihn mitten in einem Gespräch zu wechseln. Weitere Informationen finden Sie unter [Kostenabwägung verstehen](#understand-the-cost-tradeoff).

44 44 


103 103 

104Der Schnellmodus erfordert alle folgenden Voraussetzungen:104Der Schnellmodus erfordert alle folgenden Voraussetzungen:

105 105 

106* **Nur Anthropic API oder Abonnement**: Der Schnellmodus ist über die Anthropic Console API und für Claude-Abonnementpläne mit Nutzungsguthaben verfügbar. Er ist nicht auf Amazon Bedrock, Google Vertex AI, Microsoft Azure Foundry oder Claude Platform auf AWS verfügbar.106* **Nur Anthropic API oder Abonnement**: Der Schnellmodus ist über die Anthropic Console API und für Claude-Abonnementpläne mit Nutzungsguthaben verfügbar. Er ist nicht auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform auf AWS verfügbar.

107* **Nutzungsguthaben aktiviert**: Ihr Konto muss Nutzungsguthaben aktiviert haben, was eine Abrechnung über die in Ihrem Plan enthaltene Nutzung hinaus ermöglicht. Aktivieren Sie dies für einzelne Konten in Ihren [Console-Abrechnungseinstellungen](https://platform.claude.com/settings/organization/billing). Für Teams und Enterprise muss ein Administrator die Nutzungsguthaben für die Organisation aktivieren.107* **Nutzungsguthaben aktiviert**: Ihr Konto muss Nutzungsguthaben aktiviert haben, was eine Abrechnung über die in Ihrem Plan enthaltene Nutzung hinaus ermöglicht. Aktivieren Sie dies für einzelne Konten in Ihren [Console-Abrechnungseinstellungen](https://platform.claude.com/settings/organization/billing). Für Teams und Enterprise muss ein Administrator die Nutzungsguthaben für die Organisation aktivieren.

108 108 

109<Note>109<Note>

Details

4 4 

5# Verfügbarkeit von Funktionen5# Verfügbarkeit von Funktionen

6 6 

7> Vergleichen Sie, welche Claude Code-Funktionen in Anthropic-Abonnementplänen, der Anthropic Console, Amazon Bedrock, Claude Platform on AWS, Google Vertex AI und Microsoft Foundry verfügbar sind.7> Vergleichen Sie, welche Claude Code-Funktionen in Anthropic-Abonnementplänen, der Anthropic Console, Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry verfügbar sind.

8 8 

9Die Claude Code CLI und alles, was lokal ausgeführt wird, funktioniert auf jedem Anbieter identisch. Anweisungen zur Einrichtung pro Anbieter finden Sie in der [Übersicht zur Enterprise-Bereitstellung](/de/third-party-integrations). Um direkt zu sehen, was auf Ihrem Anbieter fehlt, siehe die Registerkarten [Zusammenfassung nach Anbieter](#summary-by-provider).9Die Claude Code CLI und alles, was lokal ausgeführt wird, funktioniert auf jedem Anbieter identisch. Anweisungen zur Einrichtung pro Anbieter finden Sie in der [Übersicht zur Enterprise-Bereitstellung](/de/third-party-integrations). Um direkt zu sehen, was auf Ihrem Anbieter fehlt, siehe die Registerkarten [Zusammenfassung nach Anbieter](#summary-by-provider).

10 10 


18 18 

19* **Claude-Abonnement**: Sie melden sich mit einem claude.ai-Konto im Pro-, Max-, Team- oder Enterprise-Plan an19* **Claude-Abonnement**: Sie melden sich mit einem claude.ai-Konto im Pro-, Max-, Team- oder Enterprise-Plan an

20* **Anthropic Console**: Sie authentifizieren sich mit einem Anthropic API-Schlüssel20* **Anthropic Console**: Sie authentifizieren sich mit einem Anthropic API-Schlüssel

21* **Amazon Bedrock**: Sie verwenden Claude-Modelle aus dem Bedrock-Modellkatalog und setzen `CLAUDE_CODE_USE_BEDROCK`. Der [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) wird von dieser Spalte abgedeckt21* **Amazon Bedrock**: Sie verwenden Claude-Modelle aus dem Amazon Bedrock-Modellkatalog und setzen `CLAUDE_CODE_USE_BEDROCK`. Der [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) wird von dieser Spalte abgedeckt

22* **Claude Platform on AWS**: Sie haben Claude über AWS Marketplace gekauft, rufen aber die Anthropic API auf und setzen `CLAUDE_CODE_USE_ANTHROPIC_AWS`22* **Claude Platform on AWS**: Sie haben Claude über AWS Marketplace gekauft, rufen aber die Anthropic API auf und setzen `CLAUDE_CODE_USE_ANTHROPIC_AWS`

23* **Google Vertex AI**: Von Google betrieben; Sie setzen `CLAUDE_CODE_USE_VERTEX`23* **Google Cloud's Agent Platform**: Von Google betrieben; Sie setzen `CLAUDE_CODE_USE_VERTEX`

24* **Microsoft Foundry**: Von Anthropic auf Azure betrieben; Sie setzen `CLAUDE_CODE_USE_FOUNDRY`24* **Microsoft Foundry**: Von Anthropic auf Azure betrieben; Sie setzen `CLAUDE_CODE_USE_FOUNDRY`

25 25 

26<h3 id="features-available-on-every-provider">26<h3 id="features-available-on-every-provider">


53* [Artifacts](/de/artifacts): Pro-, Max-, Team- und Enterprise-Pläne53* [Artifacts](/de/artifacts): Pro-, Max-, Team- und Enterprise-Pläne

54* [Voice dictation](/de/voice-dictation)54* [Voice dictation](/de/voice-dictation)

55 55 

56Desktop ist die teilweise Ausnahme: Enterprise-Bereitstellungen können Desktop über [verwaltete Einstellungen](https://support.claude.com/en/articles/12622667-enterprise-configuration) an Vertex AI oder einen Gateway-Anbieter weiterleiten, und die [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview) führt die Code-Registerkarte auf Bedrock, Vertex AI, Foundry oder einem selbstgehosteten LLM-Gateway aus. Für die Verfügbarkeit dieser Funktionen pro Plan siehe [Verfügbarkeit nach Abonnementplan](#availability-by-subscription-plan).56Desktop ist die teilweise Ausnahme: Enterprise-Bereitstellungen können Desktop über [verwaltete Einstellungen](https://support.claude.com/en/articles/12622667-enterprise-configuration) an Google Cloud's Agent Platform oder einen Gateway-Anbieter weiterleiten, und [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) führt die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway aus. Für die Verfügbarkeit dieser Funktionen pro Plan siehe [Verfügbarkeit nach Abonnementplan](#availability-by-subscription-plan).

57 57 

58<h3 id="cli-capabilities-that-vary-by-provider">58<h3 id="cli-capabilities-that-vary-by-provider">

59 CLI-Funktionen, die je nach Anbieter unterschiedlich sind59 CLI-Funktionen, die je nach Anbieter unterschiedlich sind


69 <th>Anthropic Console</th>69 <th>Anthropic Console</th>

70 <th>Amazon Bedrock</th>70 <th>Amazon Bedrock</th>

71 <th>Claude Platform on AWS</th>71 <th>Claude Platform on AWS</th>

72 <th>Google Vertex AI</th>72 <th>Google Cloud's Agent Platform</th>

73 <th>Microsoft Foundry</th>73 <th>Microsoft Foundry</th>

74 </tr>74 </tr>

75 </thead>75 </thead>


161 <th>Anthropic Console</th>161 <th>Anthropic Console</th>

162 <th>Amazon Bedrock</th>162 <th>Amazon Bedrock</th>

163 <th>Claude Platform on AWS</th>163 <th>Claude Platform on AWS</th>

164 <th>Google Vertex AI</th>164 <th>Google Cloud's Agent Platform</th>

165 <th>Microsoft Foundry</th>165 <th>Microsoft Foundry</th>

166 </tr>166 </tr>

167 </thead>167 </thead>


199 </tbody>199 </tbody>

200</table>200</table>

201 201 

202<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Auf Vertex AI ist Web search für Claude 4-Modelle und später verfügbar.<br />202<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 />

203<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Erfordert `CLAUDE_CODE_ENABLE_AUTO_MODE`. Siehe [Auto mode configuration](/de/auto-mode-config).<br />203<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Erfordert `CLAUDE_CODE_ENABLE_AUTO_MODE`. Siehe [Auto mode configuration](/de/auto-mode-config).<br />

204<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Explizite Intervalle wie `/loop every 2 hours` funktionieren auf jedem Anbieter. Auf Bedrock, Vertex AI und Foundry kann `/loop` sein eigenes Intervall nicht auswählen oder die Standard-Wartungsaufforderung bereitstellen, daher wird eine Aufforderung ohne Intervall alle 10 Minuten ausgeführt, und `/loop` ohne Argumente zeigt die Nutzungsmeldung. Siehe [Scheduled tasks](/de/scheduled-tasks).<br />204<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Explizite Intervalle wie `/loop every 2 hours` funktionieren auf jedem Anbieter. Auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry kann `/loop` sein eigenes Intervall nicht auswählen oder die Standard-Wartungsaufforderung bereitstellen, daher wird eine Aufforderung ohne Intervall alle 10 Minuten ausgeführt, und `/loop` ohne Argumente zeigt die Nutzungsmeldung. Siehe [Scheduled tasks](/de/scheduled-tasks).<br />

205<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Unterliegt Ihrer Vereinbarung mit dem Cloud-Anbieter.<br />205<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Unterliegt Ihrer Vereinbarung mit dem Cloud-Anbieter.<br />

206<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Dashboard und API nur. [Contribution metrics](/de/analytics#enable-contribution-metrics) erfordert eine claude.ai Team- oder Enterprise-Organisation.206<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Dashboard und API nur. [Contribution metrics](/de/analytics#enable-contribution-metrics) erfordert eine claude.ai Team- oder Enterprise-Organisation.

207 207 


213 Zusammenfassung nach Anbieter213 Zusammenfassung nach Anbieter

214</h3>214</h3>

215 215 

216Jede Registerkarte listet auf, was auf diesem Anbieter nicht verfügbar oder teilweise unterstützt wird, mit Alternativen, wo vorhanden. Alles, was nicht aufgelistet ist, funktioniert genauso wie bei einem Claude-Abonnement. Auf Bedrock, Vertex AI, Foundry und Claude Platform on AWS sind Fehlerberichterstattung und Telemetrie an Anthropic standardmäßig deaktiviert. Siehe [Standardverhalten nach API-Anbieter](/de/data-usage#default-behaviors-by-api-provider) für welcher Datenverkehr noch Anthropic erreicht und wie Sie sich abmelden.216Jede Registerkarte listet auf, was auf diesem Anbieter nicht verfügbar oder teilweise unterstützt wird, mit Alternativen, wo vorhanden. Alles, was nicht aufgelistet ist, funktioniert genauso wie bei einem Claude-Abonnement. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS sind Fehlerberichterstattung und Telemetrie an Anthropic standardmäßig deaktiviert. Siehe [Standardverhalten nach API-Anbieter](/de/data-usage#default-behaviors-by-api-provider) für welcher Datenverkehr noch Anthropic erreicht und wie Sie sich abmelden.

217 217 

218<Tabs>218<Tabs>

219 <Tab title="Amazon Bedrock">219 <Tab title="Amazon Bedrock">


221 221 

222 **Teilweise Unterstützung:**222 **Teilweise Unterstützung:**

223 223 

224 * [Desktop](/de/desktop): nur über die [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview)224 * [Desktop](/de/desktop): nur über [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

225 * [Auto mode](/de/auto-mode-config): setzen Sie `CLAUDE_CODE_ENABLE_AUTO_MODE`225 * [Auto mode](/de/auto-mode-config): setzen Sie `CLAUDE_CODE_ENABLE_AUTO_MODE`

226 * [`/loop`](/de/scheduled-tasks): nur explizite Intervalle226 * [`/loop`](/de/scheduled-tasks): nur explizite Intervalle

227 * [Zero Data Retention](/de/zero-data-retention): unterliegt Ihrer AWS-Vereinbarung227 * [Zero Data Retention](/de/zero-data-retention): unterliegt Ihrer AWS-Vereinbarung


232 <Tab title="Claude Platform on AWS">232 <Tab title="Claude Platform on AWS">

233 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [fast mode](/de/fast-mode), [Advisor](/de/advisor), [Channels](/de/channels), das [analytics dashboard](/de/analytics) und [server-managed settings](/de/server-managed-settings).233 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [fast mode](/de/fast-mode), [Advisor](/de/advisor), [Channels](/de/channels), das [analytics dashboard](/de/analytics) und [server-managed settings](/de/server-managed-settings).

234 234 

235 **Verfügbar** wo Bedrock nicht ist: [Web search](/de/tools-reference#websearch-tool-behavior), [auto mode](/de/auto-mode-config) ohne ein Opt-in-Flag und [`/loop` self-pacing](/de/scheduled-tasks).235 **Verfügbar** wo Amazon Bedrock nicht ist: [Web search](/de/tools-reference#websearch-tool-behavior), [auto mode](/de/auto-mode-config) ohne ein Opt-in-Flag und [`/loop` self-pacing](/de/scheduled-tasks).

236 236 

237 **Alternativen:** Verwenden Sie für die Planung [`/loop`](/de/scheduled-tasks) statt `/schedule`. Für Cloud-Sitzungen verwenden Sie [GitHub Actions](/de/github-actions) oder [GitLab CI/CD](/de/gitlab-ci-cd).237 **Alternativen:** Verwenden Sie für die Planung [`/loop`](/de/scheduled-tasks) statt `/schedule`. Für Cloud-Sitzungen verwenden Sie [GitHub Actions](/de/github-actions) oder [GitLab CI/CD](/de/gitlab-ci-cd).

238 </Tab>238 </Tab>

239 239 

240 <Tab title="Google Vertex AI">240 <Tab title="Google Cloud's Agent Platform">

241 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [fast mode](/de/fast-mode), [Advisor](/de/advisor), [Channels](/de/channels), das [analytics dashboard](/de/analytics) und [server-managed settings](/de/server-managed-settings).241 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [fast mode](/de/fast-mode), [Advisor](/de/advisor), [Channels](/de/channels), das [analytics dashboard](/de/analytics) und [server-managed settings](/de/server-managed-settings).

242 242 

243 **Teilweise Unterstützung:**243 **Teilweise Unterstützung:**

244 244 

245 * [Desktop](/de/desktop): über [verwaltete Einstellungen](https://support.claude.com/en/articles/12622667-enterprise-configuration) oder die [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview)245 * [Desktop](/de/desktop): über [verwaltete Einstellungen](https://support.claude.com/en/articles/12622667-enterprise-configuration) oder [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

246 * [Web search](/de/tools-reference#websearch-tool-behavior): Claude 4-Modelle und später246 * [Web search](/de/tools-reference#websearch-tool-behavior): Claude 4-Modelle und später

247 * [Auto mode](/de/auto-mode-config): setzen Sie `CLAUDE_CODE_ENABLE_AUTO_MODE`247 * [Auto mode](/de/auto-mode-config): setzen Sie `CLAUDE_CODE_ENABLE_AUTO_MODE`

248 * [`/loop`](/de/scheduled-tasks): nur explizite Intervalle248 * [`/loop`](/de/scheduled-tasks): nur explizite Intervalle


256 256 

257 **Teilweise Unterstützung:**257 **Teilweise Unterstützung:**

258 258 

259 * [Desktop](/de/desktop): nur über die [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview)259 * [Desktop](/de/desktop): nur über [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

260 * [Auto mode](/de/auto-mode-config): setzen Sie `CLAUDE_CODE_ENABLE_AUTO_MODE`260 * [Auto mode](/de/auto-mode-config): setzen Sie `CLAUDE_CODE_ENABLE_AUTO_MODE`

261 * [`/loop`](/de/scheduled-tasks): nur explizite Intervalle261 * [`/loop`](/de/scheduled-tasks): nur explizite Intervalle

262 * [Zero Data Retention](/de/zero-data-retention): unterliegt Ihrer Azure-Vereinbarung262 * [Zero Data Retention](/de/zero-data-retention): unterliegt Ihrer Azure-Vereinbarung


275 Verfügbarkeit nach Abonnementplan275 Verfügbarkeit nach Abonnementplan

276</h2>276</h2>

277 277 

278Wenn Sie sich über Bedrock, Vertex AI, Foundry oder einen Anthropic Console API-Schlüssel authentifizieren, gilt dieser Abschnitt nicht für Sie. Wenn Sie sich mit einem claude.ai-Konto anmelden, bestimmt Ihr Plan, welche der folgenden Funktionen verfügbar sind.278Wenn Sie sich über Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einen Anthropic Console API-Schlüssel authentifizieren, gilt dieser Abschnitt nicht für Sie. Wenn Sie sich mit einem claude.ai-Konto anmelden, bestimmt Ihr Plan, welche der folgenden Funktionen verfügbar sind.

279 279 

280| Funktion | Pro | Max | Team | Enterprise |280| Funktion | Pro | Max | Team | Enterprise |

281| :-------------------------------------------------------------------------------------- | :-- | :-- | :-------------- | :-------------------------------- |281| :-------------------------------------------------------------------------------------- | :-- | :-- | :-------------- | :-------------------------------- |


303 Modellverfügbarkeit303 Modellverfügbarkeit

304</h2>304</h2>

305 305 

306Für welche Claude-Modelle und Kontextfenstergrößen pro Anbieter und Region verfügbar sind, siehe [Model configuration](/de/model-config) und die [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, PDF-Eingabe und erweitertes Denken sind Modellfunktionen und keine Claude Code-Funktionen und funktionieren auf jedem Anbieter, der das Modell anbietet. [Prompt caching](/de/prompt-caching) funktioniert auf den meisten Anbietern gleich; auf Bedrock variiert die Unterstützung je nach Modell.306Für welche Claude-Modelle und Kontextfenstergrößen pro Anbieter und Region verfügbar sind, siehe [Model configuration](/de/model-config) und die [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, PDF-Eingabe und erweitertes Denken sind Modellfunktionen und keine Claude Code-Funktionen und funktionieren auf jedem Anbieter, der das Modell anbietet. [Prompt caching](/de/prompt-caching) funktioniert auf den meisten Anbietern gleich; auf Amazon Bedrock variiert die Unterstützung je nach Modell.

307 307 

308<h2 id="related-resources">308<h2 id="related-resources">

309 Verwandte Ressourcen309 Verwandte Ressourcen

310</h2>310</h2>

311 311 

312* [Enterprise deployment overview](/de/third-party-integrations): Vergleichen Sie Authentifizierung, Abrechnung und Regionen über Anbieter hinweg312* [Enterprise deployment overview](/de/third-party-integrations): Vergleichen Sie Authentifizierung, Abrechnung und Regionen über Anbieter hinweg

313* Provider-Einrichtungsleitfäden: [Amazon Bedrock](/de/amazon-bedrock), [Claude Platform on AWS](/de/claude-platform-on-aws), [Google Vertex AI](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry)313* Provider-Einrichtungsleitfäden: [Amazon Bedrock](/de/amazon-bedrock), [Claude Platform on AWS](/de/claude-platform-on-aws), [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry)

314* [Platforms and integrations](/de/platforms): wo Claude Code ausgeführt wird, einschließlich CLI, Desktop, IDE-Erweiterungen, Web, Mobilgeräte und CI/CD314* [Platforms and integrations](/de/platforms): wo Claude Code ausgeführt wird, einschließlich CLI, Desktop, IDE-Erweiterungen, Web, Mobilgeräte und CI/CD

fullscreen.md +3 −1

Details

170 170 

171Vollbildrendering ist nicht kompatibel mit iTerm2s tmux-Integrationsmodus, das ist der Modus, den Sie mit `tmux -CC` aktivieren. Im Integrationsmodus rendert iTerm2 jeden tmux-Bereich als natives Split, anstatt tmux auf dem Terminal zeichnen zu lassen. Der alternative Bildschirmpuffer und die Mausverfolgung funktionieren dort nicht korrekt: das Mausrad tut nichts, und Doppelklick kann den Terminal-Status beschädigen. Aktivieren Sie Vollbildrendering nicht in `tmux -CC` Sitzungen. Reguläres tmux in iTerm2 ohne `-CC` funktioniert einwandfrei.171Vollbildrendering ist nicht kompatibel mit iTerm2s tmux-Integrationsmodus, das ist der Modus, den Sie mit `tmux -CC` aktivieren. Im Integrationsmodus rendert iTerm2 jeden tmux-Bereich als natives Split, anstatt tmux auf dem Terminal zeichnen zu lassen. Der alternative Bildschirmpuffer und die Mausverfolgung funktionieren dort nicht korrekt: das Mausrad tut nichts, und Doppelklick kann den Terminal-Status beschädigen. Aktivieren Sie Vollbildrendering nicht in `tmux -CC` Sitzungen. Reguläres tmux in iTerm2 ohne `-CC` funktioniert einwandfrei.

172 172 

173tmux unterstützt keine synchronisierte Ausgabe, daher können Sie während Neuzeichnungen mehr Flimmern sehen als beim direkten Ausführen von Claude Code in Ihrem Terminal. Wenn das Flimmern besonders über SSH auffällig ist, führen Sie Claude Code in seiner eigenen Terminal-Registerkarte außerhalb von tmux aus.173Nicht jede tmux-Version wendet synchronisierte Ausgabe von Anwendungen an, daher können Sie während Neuzeichnungen unter tmux mehr Flimmern sehen als beim direkten Ausführen von Claude Code in Ihrem Terminal. Wenn das Flimmern auffällig ist, besonders über SSH, führen Sie ein Upgrade auf die neueste tmux-Version durch oder führen Sie Claude Code in seiner eigenen Terminal-Registerkarte außerhalb von tmux aus. Überprüfen Sie Ihre tmux-Version mit `tmux -V`.

174 

175{/* min-version: 2.1.200 */}Claude Code aktiviert synchronisierte Ausgabe automatisch, wenn es tmux 3.4 oder später aus der `TERM_PROGRAM_VERSION`-Variable erkennt, und greift auf direkte Abfragen des Terminals nach Unterstützung für synchronisierte Ausgabe zurück, wenn die Version nicht bestimmt werden kann. Ob Neuzeichnungen tatsächlich atomar werden, hängt davon ab, ob Ihre tmux-Version synchronisierte Ausgabe berücksichtigt; wenn Sie unter tmux 3.4 oder später immer noch Flimmern sehen, führen Sie ein Upgrade auf die neueste tmux-Version durch. Diese Erkennung erfordert Claude Code v2.1.200 oder später.

174 176 

175<h2 id="keep-native-text-selection">177<h2 id="keep-native-text-selection">

176 Native Textauswahl beibehalten178 Native Textauswahl beibehalten

github-actions.md +22 −22

Details

51<Note>51<Note>

52 * Sie müssen ein Repository-Admin sein, um die GitHub-App zu installieren und Secrets hinzuzufügen52 * Sie müssen ein Repository-Admin sein, um die GitHub-App zu installieren und Secrets hinzuzufügen

53 * Die GitHub-App fordert Lese- und Schreibberechtigungen für Contents, Issues und Pull Requests an53 * Die GitHub-App fordert Lese- und Schreibberechtigungen für Contents, Issues und Pull Requests an

54 * Diese Schnellstart-Methode ist nur für direkte Claude API-Benutzer verfügbar. Wenn Sie Amazon Bedrock oder Google Vertex AI verwenden, siehe bitte den Abschnitt [Verwendung mit Amazon Bedrock & Google Vertex AI](#using-with-amazon-bedrock-%26-google-vertex-ai).54 * Diese Schnellstart-Methode ist nur für direkte Claude API-Benutzer verfügbar. Wenn Sie Amazon Bedrock oder Google Cloud's Agent Platform verwenden, siehe bitte den Abschnitt [Verwendung mit Amazon Bedrock und Google Cloud](#using-with-amazon-bedrock-and-google-cloud).

55</Note>55</Note>

56 56 

57<h2 id="manual-setup">57<h2 id="manual-setup">


320 Wenn Claude auf Issue- oder PR-Kommentare antwortet, antwortet er automatisch auf @claude-Erwähnungen. Für andere Events verwenden Sie den `prompt`-Parameter, um Anweisungen bereitzustellen.320 Wenn Claude auf Issue- oder PR-Kommentare antwortet, antwortet er automatisch auf @claude-Erwähnungen. Für andere Events verwenden Sie den `prompt`-Parameter, um Anweisungen bereitzustellen.

321</Tip>321</Tip>

322 322 

323<h2 id="using-with-amazon-bedrock--google-vertex-ai">323<h2 id="using-with-amazon-bedrock-and-google-cloud">

324 Verwendung mit Amazon Bedrock & Google Vertex AI324 Verwendung mit Amazon Bedrock und Google Cloud

325</h2>325</h2>

326 326 

327Für Unternehmensumgebungen können Sie Claude Code GitHub Actions mit Ihrer eigenen Cloud-Infrastruktur verwenden. Dieser Ansatz gibt Ihnen Kontrolle über Datenresidenz und Abrechnung, während Sie die gleiche Funktionalität beibehalten.327Für Unternehmensumgebungen können Sie Claude Code GitHub Actions mit Ihrer eigenen Cloud-Infrastruktur verwenden. Dieser Ansatz gibt Ihnen Kontrolle über Datenresidenz und Abrechnung, während Sie die gleiche Funktionalität beibehalten.


332 332 

333Bevor Sie Claude Code GitHub Actions mit Cloud-Providern einrichten, benötigen Sie:333Bevor Sie Claude Code GitHub Actions mit Cloud-Providern einrichten, benötigen Sie:

334 334 

335<h4 id="for-google-cloud-vertex-ai">335<h4 id="for-google-cloud’s-agent-platform">

336 Für Google Cloud Vertex AI:336 Für Google Cloud's Agent Platform:

337</h4>337</h4>

338 338 

3391. Ein Google Cloud-Projekt mit aktiviertem Vertex AI3391. Ein Google Cloud-Projekt mit aktivierter Google Cloud's Agent Platform

3402. Workload Identity Federation für GitHub Actions konfiguriert3402. Workload Identity Federation für GitHub Actions konfiguriert

3413. Ein Service-Konto mit erforderlichen Berechtigungen3413. Ein Service-Konto mit erforderlichen Berechtigungen

3424. Eine GitHub-App (empfohlen) oder verwenden Sie das Standard-GITHUB\_TOKEN3424. Eine GitHub-App (empfohlen) oder verwenden Sie das Standard-GITHUB\_TOKEN


347 347 

3481. Ein AWS-Konto mit aktiviertem Amazon Bedrock3481. Ein AWS-Konto mit aktiviertem Amazon Bedrock

3492. GitHub OIDC Identity Provider in AWS konfiguriert3492. GitHub OIDC Identity Provider in AWS konfiguriert

3503. Eine IAM-Rolle mit Bedrock-Berechtigungen3503. Eine IAM-Rolle mit Amazon Bedrock-Berechtigungen

3514. Eine GitHub-App (empfohlen) oder verwenden Sie das Standard-GITHUB\_TOKEN3514. Eine GitHub-App (empfohlen) oder verwenden Sie das Standard-GITHUB\_TOKEN

352 352 

353<Steps>353<Steps>

354 <Step title="Erstellen Sie eine benutzerdefinierte GitHub-App (empfohlen für 3P-Provider)">354 <Step title="Erstellen Sie eine benutzerdefinierte GitHub-App (empfohlen für 3P-Provider)">

355 Für beste Kontrolle und Sicherheit bei der Verwendung von 3P-Providern wie Vertex AI oder Bedrock empfehlen wir, Ihre eigene GitHub-App zu erstellen:355 Für beste Kontrolle und Sicherheit bei der Verwendung von 3P-Providern wie Google Cloud's Agent Platform oder Amazon Bedrock empfehlen wir, Ihre eigene GitHub-App zu erstellen:

356 356 

357 1. Gehen Sie zu [https://github.com/settings/apps/new](https://github.com/settings/apps/new)357 1. Gehen Sie zu [https://github.com/settings/apps/new](https://github.com/settings/apps/new)

358 2. Füllen Sie die grundlegenden Informationen aus:358 2. Füllen Sie die grundlegenden Informationen aus:


428 Siehe [AWS-Dokumentation](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) für detaillierte OIDC-Setup-Anweisungen.428 Siehe [AWS-Dokumentation](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) für detaillierte OIDC-Setup-Anweisungen.

429 </Accordion>429 </Accordion>

430 430 

431 <Accordion title="Google Vertex AI">431 <Accordion title="Google Cloud's Agent Platform">

432 **Konfigurieren Sie Google Cloud, um GitHub Actions die sichere Authentifizierung ohne Speicherung von Anmeldedaten zu ermöglichen.**432 **Konfigurieren Sie Google Cloud, um GitHub Actions die sichere Authentifizierung ohne Speicherung von Anmeldedaten zu ermöglichen.**

433 433 

434 > **Sicherheitshinweis**: Verwenden Sie Repository-spezifische Konfigurationen und gewähren Sie nur die minimal erforderlichen Berechtigungen.434 > **Sicherheitshinweis**: Verwenden Sie Repository-spezifische Konfigurationen und gewähren Sie nur die minimal erforderlichen Berechtigungen.


438 1. **Aktivieren Sie APIs** in Ihrem Google Cloud-Projekt:438 1. **Aktivieren Sie APIs** in Ihrem Google Cloud-Projekt:

439 * IAM Credentials API439 * IAM Credentials API

440 * Security Token Service (STS) API440 * Security Token Service (STS) API

441 * Vertex AI API441 * Google Cloud's Agent Platform API

442 442 

443 2. **Erstellen Sie Workload Identity Federation-Ressourcen**:443 2. **Erstellen Sie Workload Identity Federation-Ressourcen**:

444 * Erstellen Sie einen Workload Identity Pool444 * Erstellen Sie einen Workload Identity Pool


483 * `APP_ID`: Die ID Ihrer GitHub-App483 * `APP_ID`: Die ID Ihrer GitHub-App

484 * `APP_PRIVATE_KEY`: Der Inhalt des privaten Schlüssels (.pem)484 * `APP_PRIVATE_KEY`: Der Inhalt des privaten Schlüssels (.pem)

485 485 

486 #### Für Google Cloud Vertex AI486 #### Für Google Cloud's Agent Platform

487 487 

488 1. **Für GCP-Authentifizierung**:488 1. **Für GCP-Authentifizierung**:

489 * `GCP_WORKLOAD_IDENTITY_PROVIDER`489 * `GCP_WORKLOAD_IDENTITY_PROVIDER`


504 </Step>504 </Step>

505 505 

506 <Step title="Erstellen Sie Workflow-Dateien">506 <Step title="Erstellen Sie Workflow-Dateien">

507 Erstellen Sie GitHub Actions-Workflow-Dateien, die sich in Ihren Cloud-Provider integrieren. Die folgenden Beispiele zeigen vollständige Konfigurationen für Amazon Bedrock und Google Vertex AI:507 Erstellen Sie GitHub Actions-Workflow-Dateien, die sich in Ihren Cloud-Provider integrieren. Die folgenden Beispiele zeigen vollständige Konfigurationen für Amazon Bedrock und Google Cloud's Agent Platform:

508 508 

509 <AccordionGroup>509 <AccordionGroup>

510 <Accordion title="Amazon Bedrock-Workflow">510 <Accordion title="Amazon Bedrock-Workflow">


512 512 

513 * Amazon Bedrock-Zugriff aktiviert mit Claude-Modell-Berechtigungen513 * Amazon Bedrock-Zugriff aktiviert mit Claude-Modell-Berechtigungen

514 * GitHub als OIDC-Identity-Provider in AWS konfiguriert514 * GitHub als OIDC-Identity-Provider in AWS konfiguriert

515 * IAM-Rolle mit Bedrock-Berechtigungen, die GitHub Actions vertraut515 * IAM-Rolle mit Amazon Bedrock-Berechtigungen, die GitHub Actions vertraut

516 516 

517 **Erforderliche GitHub-Secrets:**517 **Erforderliche GitHub-Secrets:**

518 518 

519 | Secret-Name | Beschreibung |519 | Secret-Name | Beschreibung |

520 | -------------------- | ------------------------------------------------------------------ |520 | -------------------- | ------------------------------------------------------------------ |

521 | `AWS_ROLE_TO_ASSUME` | ARN der IAM-Rolle für Bedrock-Zugriff |521 | `AWS_ROLE_TO_ASSUME` | ARN der IAM-Rolle für Amazon Bedrock-Zugriff |

522 | `APP_ID` | Ihre GitHub-App-ID (aus App-Einstellungen) |522 | `APP_ID` | Ihre GitHub-App-ID (aus App-Einstellungen) |

523 | `APP_PRIVATE_KEY` | Der private Schlüssel, den Sie für Ihre GitHub-App generiert haben |523 | `APP_PRIVATE_KEY` | Der private Schlüssel, den Sie für Ihre GitHub-App generiert haben |

524 524 


573 ```573 ```

574 574 

575 <Tip>575 <Tip>

576 Das Modell-ID-Format für Bedrock enthält ein Regions-Präfix (zum Beispiel `us.anthropic.claude-sonnet-4-6`).576 Das Modell-ID-Format für Amazon Bedrock enthält ein Regions-Präfix (zum Beispiel `us.anthropic.claude-sonnet-4-6`).

577 </Tip>577 </Tip>

578 </Accordion>578 </Accordion>

579 579 

580 <Accordion title="Google Vertex AI-Workflow">580 <Accordion title="Google Cloud's Agent Platform-Workflow">

581 **Voraussetzungen:**581 **Voraussetzungen:**

582 582 

583 * Vertex AI API in Ihrem GCP-Projekt aktiviert583 * Google Cloud's Agent Platform API in Ihrem GCP-Projekt aktiviert

584 * Workload Identity Federation für GitHub konfiguriert584 * Workload Identity Federation für GitHub konfiguriert

585 * Service-Konto mit Vertex AI-Berechtigungen585 * Service-Konto mit Google Cloud's Agent Platform-Berechtigungen

586 586 

587 **Erforderliche GitHub-Secrets:**587 **Erforderliche GitHub-Secrets:**

588 588 

589 | Secret-Name | Beschreibung |589 | Secret-Name | Beschreibung |

590 | -------------------------------- | ------------------------------------------------------------------ |590 | -------------------------------- | ------------------------------------------------------------------ |

591 | `GCP_WORKLOAD_IDENTITY_PROVIDER` | Workload Identity Provider-Ressourcenname |591 | `GCP_WORKLOAD_IDENTITY_PROVIDER` | Workload Identity Provider-Ressourcenname |

592 | `GCP_SERVICE_ACCOUNT` | Service-Konto-E-Mail mit Vertex AI-Zugriff |592 | `GCP_SERVICE_ACCOUNT` | Service-Konto-E-Mail mit Google Cloud's Agent Platform-Zugriff |

593 | `APP_ID` | Ihre GitHub-App-ID (aus App-Einstellungen) |593 | `APP_ID` | Ihre GitHub-App-ID (aus App-Einstellungen) |

594 | `APP_PRIVATE_KEY` | Der private Schlüssel, den Sie für Ihre GitHub-App generiert haben |594 | `APP_PRIVATE_KEY` | Der private Schlüssel, den Sie für Ihre GitHub-App generiert haben |

595 595 


675 Authentifizierungsfehler675 Authentifizierungsfehler

676</h3>676</h3>

677 677 

678Bestätigen Sie, dass der API-Schlüssel gültig ist und ausreichende Berechtigungen hat. Für Bedrock/Vertex überprüfen Sie die Anmeldedaten-Konfiguration und stellen Sie sicher, dass Secrets in Workflows korrekt benannt sind.678Bestätigen Sie, dass der API-Schlüssel gültig ist und ausreichende Berechtigungen hat. Für Amazon Bedrock oder Google Cloud's Agent Platform überprüfen Sie die Anmeldedaten-Konfiguration und stellen Sie sicher, dass Secrets in Workflows korrekt benannt sind.

679 679 

680<h2 id="advanced-configuration">680<h2 id="advanced-configuration">

681 Erweiterte Konfiguration681 Erweiterte Konfiguration


697| `github_token` | GitHub-Token für API-Zugriff | Nein |697| `github_token` | GitHub-Token für API-Zugriff | Nein |

698| `trigger_phrase` | Benutzerdefinierte Trigger-Phrase (Standard: "@claude") | Nein |698| `trigger_phrase` | Benutzerdefinierte Trigger-Phrase (Standard: "@claude") | Nein |

699| `use_bedrock` | Verwenden Sie Amazon Bedrock statt Claude API | Nein |699| `use_bedrock` | Verwenden Sie Amazon Bedrock statt Claude API | Nein |

700| `use_vertex` | Verwenden Sie Google Vertex AI statt Claude API | Nein |700| `use_vertex` | Verwenden Sie Google Cloud's Agent Platform statt Claude API | Nein |

701 701 

702\*Prompt ist optional – wenn für Issue/PR-Kommentare weggelassen, antwortet Claude auf Trigger-Phrase\702\*Prompt ist optional – wenn für Issue/PR-Kommentare weggelassen, antwortet Claude auf Trigger-Phrase\

703\*\*Erforderlich für direkte Claude API, nicht für Bedrock/Vertex703\*\*Erforderlich für direkte Claude API, nicht für Amazon Bedrock oder Google Cloud's Agent Platform

704 704 

705<h4 id="pass-cli-arguments">705<h4 id="pass-cli-arguments">

706 Übergeben Sie CLI-Argumente706 Übergeben Sie CLI-Argumente

Details

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, automatisierte Code-Reviews erhalten und Plugins aus internen Marktplätzen installieren, ohne dass eine Konfiguration pro Repository erforderlich ist.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.

14 14 

15Für Repositories auf github.com siehe [Claude Code im Web](/de/claude-code-on-the-web) und [Code Review](/de/code-review). Um Claude in Ihrer eigenen CI-Infrastruktur auszuführen, siehe [GitHub Actions](/de/github-actions).15Für Repositories auf github.com siehe [Claude Code im Web](/de/claude-code-on-the-web) und [Code Review](/de/code-review). Um Claude in Ihrer eigenen CI-Infrastruktur auszuführen, siehe [GitHub Actions](/de/github-actions).

16 16 


21Die folgende Tabelle zeigt, welche Claude Code-Funktionen GHES unterstützen und welche Unterschiede zum Verhalten von github.com bestehen.21Die folgende Tabelle zeigt, welche Claude Code-Funktionen GHES unterstützen und welche Unterschiede zum Verhalten von github.com bestehen.

22 22 

23| Funktion | GHES-Unterstützung | Hinweise |23| Funktion | GHES-Unterstützung | Hinweise |

24| :----------------- | :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------- |24| :----------------- | :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------- |

25| Claude Code im Web | ✅ Unterstützt | Ein Owner verbindet die GHES-Instanz einmalig; Entwickler verwenden `claude --remote` oder [claude.ai/code](https://claude.ai/code) wie gewohnt |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 |

26| Code Review | ✅ Unterstützt | Gleiche automatisierte PR-Reviews wie github.com |26| Code Review | ✅ Unterstützt | Gleiche automatisierte PR-Reviews wie github.com |

27| Claude Security | ✅ Unterstützt | Verfügbar in öffentlicher Beta für Enterprise-Pläne unter [claude.ai/security](https://claude.ai/security) |27| Claude Security | ✅ Unterstützt | Verfügbar in öffentlicher Beta für Enterprise-Pläne unter [claude.ai/security](https://claude.ai/security) |

28| Teleport-Sitzungen | ✅ Unterstützt | Verschieben Sie Sitzungen zwischen Web und Terminal mit `--teleport` |28| Teleport-Sitzungen | ✅ Unterstützt | Verschieben Sie Sitzungen zwischen Web und Terminal mit `--teleport` |

29| Plugin-Marktplätze | ✅ Unterstützt | Verwenden Sie vollständige Git-URLs anstelle der `owner/repo`-Kurzform |29| Plugin-Marktplätze | ✅ Unterstützt | Anforderungen an Anmeldedaten unterscheiden sich je nach Oberfläche. Siehe [Plugin-Marktplätze auf GHES](#plugin-marketplaces-on-ghes) |

30| Beitragskennzahlen | ✅ Unterstützt | Bereitgestellt über Webhooks zum [Analytics-Dashboard](/de/analytics) |30| Beitragskennzahlen | ✅ Unterstützt | Bereitgestellt über Webhooks zum [Analytics-Dashboard](/de/analytics) |

31| GitHub Actions | ✅ Unterstützt | Erfordert manuelle Workflow-Einrichtung; `/install-github-app` ist nur für github.com |31| GitHub Actions | ✅ Unterstützt | Erfordert manuelle Workflow-Einrichtung; `/install-github-app` ist nur für github.com |

32| GitHub MCP-Server | ❌ Nicht unterstützt | Der GitHub MCP-Server funktioniert nicht mit GHES-Instanzen |32| GitHub MCP-Server | ❌ Nicht unterstützt | Der GitHub MCP-Server funktioniert nicht mit GHES-Instanzen |


107Starten Sie dann eine Web-Sitzung. Claude erkennt den GHES-Host aus Ihrem Git-Remote und leitet die Sitzung durch Ihre konfigurierte Organisationsinstanz:107Starten Sie dann eine Web-Sitzung. Claude erkennt den GHES-Host aus Ihrem Git-Remote und leitet die Sitzung durch Ihre konfigurierte Organisationsinstanz:

108 108 

109```bash theme={null}109```bash theme={null}

110claude --remote "Add retry logic to the payment webhook handler"110claude --cloud "Add retry logic to the payment webhook handler"

111```111```

112 112 

113Die Sitzung wird auf der Anthropic-Infrastruktur ausgeführt, klont Ihr Repository von GHES und pusht Änderungen zurück zu einem Branch. Überwachen Sie den Fortschritt mit `/tasks` oder unter [claude.ai/code](https://claude.ai/code). Siehe [Claude Code im Web](/de/claude-code-on-the-web) für den vollständigen Cloud-Sitzungs-Workflow einschließlich Diff-Review, Auto-Fix und Routinen.113Die Sitzung wird auf der Anthropic-Infrastruktur ausgeführt, klont Ihr Repository von GHES und pusht Änderungen zurück zu einem Branch. Überwachen Sie den Fortschritt mit `/tasks` oder unter [claude.ai/code](https://claude.ai/code). Siehe [Claude Code im Web](/de/claude-code-on-the-web) für den vollständigen Cloud-Sitzungs-Workflow einschließlich Diff-Review, Auto-Fix und Routinen.


122 Plugin-Marktplätze auf GHES122 Plugin-Marktplätze auf GHES

123</h2>123</h2>

124 124 

125Hosten Sie Plugin-Marktplätze auf Ihrer GHES-Instanz, um interne Tools in Ihrer Organisation zu verteilen. Die Marktplatzstruktur ist identisch mit auf github.com gehosteten Marktplätzen; der einzige Unterschied ist, wie Sie auf sie verweisen.125Hosten Sie Plugin-Marktplätze auf Ihrer GHES-Instanz, um interne Tools in Ihrer Organisation zu verteilen. Die Marktplatzstruktur ist identisch mit auf github.com gehosteten Marktplätzen, aber die Installation funktioniert unterschiedlich, je nachdem, wo Sie den Marktplatz hinzufügen, und die Anmeldedaten unterscheiden sich zwischen den Oberflächen:

126 

127| Oberfläche | Funktionsweise der Installation | Was jeder Benutzer benötigt |

128| :-------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

129| Claude Code CLI und Desktop | Claude Code klont das Marktplatz-Repository mit den vorhandenen Git-Anmeldedaten des Computers | Git-Zugriff auf Ihren GHES-Host von ihrem Computer |

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

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

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

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

134 

135<Warning>

136 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.

137</Warning>

126 138 

127<h3 id="add-a-ghes-marketplace">139<h3 id="add-a-ghes-marketplace">

128 Fügen Sie einen GHES-Marktplatz hinzu140 Fügen Sie einen GHES-Marktplatz hinzu

129</h3>141</h3>

130 142 

131Die `owner/repo`-Kurzform wird immer zu github.com aufgelöst. Für GHES-gehostete Marktplätze verwenden Sie die vollständige Git-URL:143Die `owner/repo`-Kurzform wird immer zu github.com aufgelöst. Für GHES-gehostete Marktplätze verwenden Sie die vollständige Git-URL. HTTPS-URLs werden empfohlen:

132 144 

133```bash theme={null}145```bash theme={null}

134/plugin marketplace add git@github.example.com:platform/claude-plugins.git146/plugin marketplace add https://github.example.com/platform/claude-plugins.git

135```147```

136 148 

137HTTPS-URLs funktionieren auch:149SSH-URLs funktionieren, wenn der Computer Ihren GHES-Host bereits vertraut:

138 150 

139```bash theme={null}151```bash theme={null}

140/plugin marketplace add https://github.example.com/platform/claude-plugins.git152/plugin marketplace add git@github.example.com:platform/claude-plugins.git

141```153```

142 154 

155Claude 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.

156 

143Siehe [Erstellen und Verteilen eines Plugin-Marktplatzes](/de/plugin-marketplaces) für die vollständige Anleitung zum Erstellen von Marktplätzen.157Siehe [Erstellen und Verteilen eines Plugin-Marktplatzes](/de/plugin-marketplaces) für die vollständige Anleitung zum Erstellen von Marktplätzen.

144 158 

159<h3 id="pre-register-ghes-marketplaces-with-managed-settings">

160 Registrieren Sie GHES-Marktplätze vorab mit verwalteten Einstellungen

161</h3>

162 

163Die `extraKnownMarketplaces`-Einstellung registriert einen Marktplatz vorab, damit Entwickler ihn ohne manuelle Einrichtung erhalten. Sie funktioniert aus [jeder Einstellungsdatei](/de/settings#extraknownmarketplaces), einschließlich der `.claude/settings.json` eines Repositories; verwaltete Einstellungen liefern sie organisationsweit:

164 

165```json theme={null}

166{

167 "extraKnownMarketplaces": {

168 "internal-tools": {

169 "source": {

170 "source": "git",

171 "url": "https://github.example.com/platform/claude-plugins.git"

172 }

173 }

174 }

175}

176```

177 

178Claude Code installiert diese Marktplätze lokal: Es registriert jeden Eintrag und klont das Repository mit den vorhandenen Git-Anmeldedaten des Computers. Dieser Pfad verläuft nicht über claude.ai, daher ist die GitHub Enterprise-Verbindung pro Benutzer nicht erforderlich. Für einen erfolgreichen Rollout:

179 

180* **Verwenden Sie eine vollständige Git-URL.** Die `owner/repo`-Kurzform wird immer zu github.com aufgelöst und kann nicht auf einen GHES-Host verweisen.

181* **Bevorzugen Sie HTTPS-URLs.** SSH-Klone schlagen auf Computern fehl, die Ihren GHES-Host-Schlüssel nicht bereits vertrauen. Eine HTTPS-URL mit dem Standard-Git-Credential-Helper Ihrer Organisation funktioniert auf jedem Computer mit konfigurierten Anmeldedaten.

182* **Bestätigen Sie, dass jeder Computer von Ihrem GHES-Host klonen kann.** Wenn ein Computer keine Anmeldedaten hat, wird der Marktplatz registriert, aber nie installiert, und seine Plugins werden als nicht gefunden gemeldet, anstatt nach Anmeldedaten zu fragen.

183* **Bestätigen Sie, dass die Einstellung jeden Computer erreicht.** Eine verwaltete Einstellungsdatei wird nur auf Computern wirksam, auf denen sie bereitgestellt wird, beispielsweise über Ihr Geräteverwaltungssystem. Siehe [verwaltete Einstellungen](/de/settings#settings-files) für Dateispeicherorte.

184 

145<h3 id="allowlist-ghes-marketplaces-in-managed-settings">185<h3 id="allowlist-ghes-marketplaces-in-managed-settings">

146 Whitelist GHES-Marktplätze in verwalteten Einstellungen186 Whitelist GHES-Marktplätze in verwalteten Einstellungen

147</h3>187</h3>


159}199}

160```200```

161 201 

162Sie können auch Marktplätze für Entwickler vorab registrieren, damit sie ohne manuelle Einrichtung angezeigt werden. Dieses Beispiel macht einen Marktplatz für interne Tools organisationsweit verfügbar:

163 

164```json theme={null}

165{

166 "extraKnownMarketplaces": {

167 "internal-tools": {

168 "source": {

169 "source": "git",

170 "url": "git@github.example.com:platform/claude-plugins.git"

171 }

172 }

173 }

174}

175```

176 

177Siehe die Referenz zu den Einstellungen [strictKnownMarketplaces](/de/settings#strictknownmarketplaces) und [extraKnownMarketplaces](/de/settings#extraknownmarketplaces) für das vollständige Schema.202Siehe die Referenz zu den Einstellungen [strictKnownMarketplaces](/de/settings#strictknownmarketplaces) und [extraKnownMarketplaces](/de/settings#extraknownmarketplaces) für das vollständige Schema.

178 203 

179<h2 id="limitations">204<h2 id="limitations">


193 Web-Sitzung kann Repository nicht klonen218 Web-Sitzung kann Repository nicht klonen

194</h3>219</h3>

195 220 

196Wenn `claude --remote` 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.221Wenn `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.

197 222 

198<h3 id="marketplace-add-fails-with-a-policy-error">223<h3 id="marketplace-add-fails-with-a-policy-error">

199 Marktplatz-Hinzufügen schlägt mit Richtlinienfehler fehl224 Marktplatz-Hinzufügen schlägt mit Richtlinienfehler fehl


201 226 

202Wenn `/plugin marketplace add` für Ihre GHES-URL blockiert wird, hat Ihre Organisation Marktplatzquellen eingeschränkt. Bitten Sie Ihren Administrator, einen `hostPattern`-Eintrag für Ihren GHES-Hostnamen in [verwalteten Einstellungen](#allowlist-ghes-marketplaces-in-managed-settings) hinzuzufügen.227Wenn `/plugin marketplace add` für Ihre GHES-URL blockiert wird, hat Ihre Organisation Marktplatzquellen eingeschränkt. Bitten Sie Ihren Administrator, einen `hostPattern`-Eintrag für Ihren GHES-Hostnamen in [verwalteten Einstellungen](#allowlist-ghes-marketplaces-in-managed-settings) hinzuzufügen.

203 228 

229<h3 id="marketplace-add-on-claude-ai-fails-with-a-github-access-error">

230 Marktplatz-Hinzufügen auf claude.ai schlägt mit GitHub-Zugriffsfehler fehl

231</h3>

232 

233Wenn das Hinzufügen eines GHES-Marktplatzes aus Ihren Benutzereinstellungen mit einem generischen Fehler wie „Marktplatz konnte nicht hinzugefügt werden" fehlschlägt, überprüfen Sie zunächst Ihre GitHub Enterprise-Verbindung. Dies ist das, was angezeigt wird, wenn Ihr eigenes GitHub Enterprise-Konto nicht mit Claude verbunden ist, auch wenn Ihre GHES-Instanz der Organisation konfiguriert ist und andere Benutzer verbunden sind. Der Dialog verweist nicht auf den GitHub Enterprise-Verbindungsfluss, und die Option „Mit GitHub verbinden" auf der Registerkarte „Durchsuchen" meldet sich bei github.com an, was keinen Zugriff auf GHES-Repositories gewährt.

234 

235Um Ihr GitHub Enterprise-Konto zu verbinden: Die Repository-Auswahl auf [claude.ai/code](https://claude.ai/code) bietet eine Verbindungsoption für jede konfigurierte GHES-Instanz, und Owners können sich auch aus dem GitHub Enterprise-Bereich der [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code) verbinden. Fügen Sie dann den Marktplatz erneut hinzu. Alternativ können Sie einen Owner bitten, den Marktplatz in den Organisationsplug-in-Einstellungen hinzuzufügen, was die Anforderung der Benutzerverbindung pro Benutzer entfernt.

236 

237Auf anderen claude.ai-Oberflächen deutet ein Fehler „Repository nicht gefunden. Falls es privat ist, ist GitHub-Zugriff erforderlich" auf einem GHES-Marktplatz normalerweise auf dieselbe fehlende Verbindung hin. Verbinden Sie Ihr GitHub Enterprise-Konto über einen der oben genannten Pfade und versuchen Sie es dann erneut.

238 

204<h3 id="ghes-instance-not-reachable">239<h3 id="ghes-instance-not-reachable">

205 GHES-Instanz nicht erreichbar240 GHES-Instanz nicht erreichbar

206</h3>241</h3>

gitlab-ci-cd.md +30 −30

Details

24* **Automatisierte Implementierung**: Verwandeln Sie Probleme mit einem einzigen Befehl oder einer Erwähnung in funktionierenden Code24* **Automatisierte Implementierung**: Verwandeln Sie Probleme mit einem einzigen Befehl oder einer Erwähnung in funktionierenden Code

25* **Projektbewusst**: Claude folgt Ihren `CLAUDE.md`-Richtlinien und vorhandenen Code-Mustern25* **Projektbewusst**: Claude folgt Ihren `CLAUDE.md`-Richtlinien und vorhandenen Code-Mustern

26* **Einfaches Setup**: Fügen Sie einen Job zu `.gitlab-ci.yml` und eine maskierte CI/CD-Variable hinzu26* **Einfaches Setup**: Fügen Sie einen Job zu `.gitlab-ci.yml` und eine maskierte CI/CD-Variable hinzu

27* **Enterprise-ready**: Wählen Sie Claude API, Amazon Bedrock oder Google Vertex AI, um Anforderungen an Datenresidenz und Beschaffung zu erfüllen27* **Enterprise-ready**: Wählen Sie Claude API, Amazon Bedrock oder Google Cloud's Agent Platform, um Anforderungen an Datenresidenz und Beschaffung zu erfüllen

28* **Standardmäßig sicher**: Läuft in Ihren GitLab-Runnern mit Ihrem Branch-Schutz und Genehmigungen28* **Standardmäßig sicher**: Läuft in Ihren GitLab-Runnern mit Ihrem Branch-Schutz und Genehmigungen

29 29 

30<h2 id="how-it-works">30<h2 id="how-it-works">


382. **Provider-Abstraktion**: Verwenden Sie den Provider, der zu Ihrer Umgebung passt:382. **Provider-Abstraktion**: Verwenden Sie den Provider, der zu Ihrer Umgebung passt:

39 * Claude API (SaaS)39 * Claude API (SaaS)

40 * Amazon Bedrock (IAM-basierter Zugriff, regionsübergreifende Optionen)40 * Amazon Bedrock (IAM-basierter Zugriff, regionsübergreifende Optionen)

41 * Google Vertex AI (GCP-nativ, Workload Identity Federation)41 * Google Cloud's Agent Platform (GCP-nativ, Workload Identity Federation)

42 42 

433. **Sandboxed-Ausführung**: Jede Interaktion läuft in einem Container mit strikten Netzwerk- und Dateisystem-Regeln. Claude Code erzwingt Workspace-bezogene Berechtigungen, um Schreibvorgänge einzuschränken. Jede Änderung fließt durch einen MR, damit Reviewer den Diff sehen und Genehmigungen weiterhin gelten.433. **Sandboxed-Ausführung**: Jede Interaktion läuft in einem Container mit strikten Netzwerk- und Dateisystem-Regeln. Claude Code erzwingt Workspace-bezogene Berechtigungen, um Schreibvorgänge einzuschränken. Jede Änderung fließt durch einen MR, damit Reviewer den Diff sehen und Genehmigungen weiterhin gelten.

44 44 


108Nach dem Hinzufügen des Jobs und Ihrer `ANTHROPIC_API_KEY`-Variable testen Sie, indem Sie den Job manuell von **CI/CD** → **Pipelines** ausführen, oder lösen Sie ihn von einem MR aus, um Claude zu ermöglichen, Updates in einem Branch vorzuschlagen und bei Bedarf einen MR zu öffnen.108Nach dem Hinzufügen des Jobs und Ihrer `ANTHROPIC_API_KEY`-Variable testen Sie, indem Sie den Job manuell von **CI/CD** → **Pipelines** ausführen, oder lösen Sie ihn von einem MR aus, um Claude zu ermöglichen, Updates in einem Branch vorzuschlagen und bei Bedarf einen MR zu öffnen.

109 109 

110<Note>110<Note>

111 Um stattdessen auf Amazon Bedrock oder Google Vertex AI auszuführen, siehe den Abschnitt [Verwendung mit Amazon Bedrock & Google Vertex AI](#using-with-amazon-bedrock-%26-google-vertex-ai) unten für Authentifizierung und Umgebungssetup.111 Um stattdessen auf Amazon Bedrock oder Google Cloud's Agent Platform auszuführen, siehe den Abschnitt [Verwendung mit Amazon Bedrock und Google Cloud](#using-with-amazon-bedrock-and-google-cloud) unten für Authentifizierung und Umgebungssetup.

112</Note>112</Note>

113 113 

114<h3 id="manual-setup-recommended-for-production">114<h3 id="manual-setup-recommended-for-production">


119 119 

1201. **Konfigurieren Sie Provider-Zugriff**:1201. **Konfigurieren Sie Provider-Zugriff**:

121 * **Claude API**: Erstellen und speichern Sie `ANTHROPIC_API_KEY` als maskierte CI/CD-Variable121 * **Claude API**: Erstellen und speichern Sie `ANTHROPIC_API_KEY` als maskierte CI/CD-Variable

122 * **Amazon Bedrock**: **Konfigurieren Sie GitLab** → **AWS OIDC** und erstellen Sie eine IAM-Rolle für Bedrock122 * **Amazon Bedrock**: **Konfigurieren Sie GitLab** → **AWS OIDC** und erstellen Sie eine IAM-Rolle für Amazon Bedrock

123 * **Google Vertex AI**: **Konfigurieren Sie Workload Identity Federation für GitLab** → **GCP**123 * **Google Cloud's Agent Platform**: **Konfigurieren Sie Workload Identity Federation für GitLab** → **GCP**

124 124 

1252. **Fügen Sie Projekt-Anmeldedaten für GitLab API-Operationen hinzu**:1252. **Fügen Sie Projekt-Anmeldedaten für GitLab API-Operationen hinzu**:

126 * Verwenden Sie `CI_JOB_TOKEN` standardmäßig, oder erstellen Sie ein Project Access Token mit `api`-Bereich126 * Verwenden Sie `CI_JOB_TOKEN` standardmäßig, oder erstellen Sie ein Project Access Token mit `api`-Bereich


172 172 

173Claude lokalisiert den Bug, implementiert eine Korrektur und aktualisiert den Branch oder öffnet einen neuen MR.173Claude lokalisiert den Bug, implementiert eine Korrektur und aktualisiert den Branch oder öffnet einen neuen MR.

174 174 

175<h2 id="using-with-amazon-bedrock--google-vertex-ai">175<h2 id="using-with-amazon-bedrock-and-google-cloud">

176 Verwendung mit Amazon Bedrock & Google Vertex AI176 Verwendung mit Amazon Bedrock und Google Cloud

177</h2>177</h2>

178 178 

179Für Enterprise-Umgebungen können Sie Claude Code vollständig auf Ihrer Cloud-Infrastruktur mit der gleichen Entwicklererfahrung ausführen.179Für Enterprise-Umgebungen können Sie Claude Code vollständig auf Ihrer Cloud-Infrastruktur mit der gleichen Entwicklererfahrung ausführen.


186 186 

187 1. Ein AWS-Konto mit Amazon Bedrock-Zugriff auf die gewünschten Claude-Modelle187 1. Ein AWS-Konto mit Amazon Bedrock-Zugriff auf die gewünschten Claude-Modelle

188 2. GitLab als OIDC-Identitätsanbieter in AWS IAM konfiguriert188 2. GitLab als OIDC-Identitätsanbieter in AWS IAM konfiguriert

189 3. Eine IAM-Rolle mit Bedrock-Berechtigungen und einer Vertrauensrichtlinie, die auf Ihr GitLab-Projekt/Refs beschränkt ist189 3. Eine IAM-Rolle mit Amazon Bedrock-Berechtigungen und einer Vertrauensrichtlinie, die auf Ihr GitLab-Projekt/Refs beschränkt ist

190 4. GitLab CI/CD-Variablen für Rollenübernahme:190 4. GitLab CI/CD-Variablen für Rollenübernahme:

191 * `AWS_ROLE_TO_ASSUME` (Rollen-ARN)191 * `AWS_ROLE_TO_ASSUME` (Rollen-ARN)

192 * `AWS_REGION` (Bedrock-Region)192 * `AWS_REGION` (Amazon Bedrock-Region)

193 193 

194 ### Setup-Anweisungen194 ### Setup-Anweisungen

195 195 


200 1. Aktivieren Sie Amazon Bedrock und fordern Sie Zugriff auf Ihre Ziel-Claude-Modelle an200 1. Aktivieren Sie Amazon Bedrock und fordern Sie Zugriff auf Ihre Ziel-Claude-Modelle an

201 2. Erstellen Sie einen IAM OIDC-Provider für GitLab, falls nicht bereits vorhanden201 2. Erstellen Sie einen IAM OIDC-Provider für GitLab, falls nicht bereits vorhanden

202 3. Erstellen Sie eine IAM-Rolle, der der GitLab OIDC-Provider vertraut, beschränkt auf Ihr Projekt und geschützte Refs202 3. Erstellen Sie eine IAM-Rolle, der der GitLab OIDC-Provider vertraut, beschränkt auf Ihr Projekt und geschützte Refs

203 4. Fügen Sie Least-Privilege-Berechtigungen für Bedrock-Invoke-APIs an203 4. Fügen Sie Least-Privilege-Berechtigungen für Amazon Bedrock-Invoke-APIs an

204 204 

205 **Erforderliche Werte zum Speichern in CI/CD-Variablen:**205 **Erforderliche Werte zum Speichern in CI/CD-Variablen:**

206 206 


218 Verwenden Sie das Amazon Bedrock-Job-Beispiel oben, um das GitLab-Job-Token gegen temporäre AWS-Anmeldedaten zur Laufzeit auszutauschen.218 Verwenden Sie das Amazon Bedrock-Job-Beispiel oben, um das GitLab-Job-Token gegen temporäre AWS-Anmeldedaten zur Laufzeit auszutauschen.

219 </Tab>219 </Tab>

220 220 

221 <Tab title="Google Vertex AI">221 <Tab title="Google Cloud's Agent Platform">

222 ### Voraussetzungen222 ### Voraussetzungen

223 223 

224 Bevor Sie Claude Code mit Google Vertex AI einrichten, benötigen Sie:224 Bevor Sie Claude Code mit Google Cloud's Agent Platform einrichten, benötigen Sie:

225 225 

226 1. Ein Google Cloud-Projekt mit:226 1. Ein Google Cloud-Projekt mit:

227 * Aktivierter Vertex AI API227 * Aktivierter Google Cloud's Agent Platform API

228 * Workload Identity Federation konfiguriert, um GitLab OIDC zu vertrauen228 * Workload Identity Federation konfiguriert, um GitLab OIDC zu vertrauen

229 2. Ein dediziertes Service-Konto mit nur den erforderlichen Vertex AI-Rollen229 2. Ein dediziertes Service-Konto mit nur den erforderlichen Google Cloud's Agent Platform-Rollen

230 3. GitLab CI/CD-Variablen für WIF:230 3. GitLab CI/CD-Variablen für WIF:

231 * `GCP_WORKLOAD_IDENTITY_PROVIDER` (vollständiger Ressourcenname)231 * `GCP_WORKLOAD_IDENTITY_PROVIDER` (vollständiger Ressourcenname)

232 * `GCP_SERVICE_ACCOUNT` (Service-Konto-E-Mail)232 * `GCP_SERVICE_ACCOUNT` (Service-Konto-E-Mail)


237 237 

238 **Erforderliches Setup:**238 **Erforderliches Setup:**

239 239 

240 1. Aktivieren Sie IAM Credentials API, STS API und Vertex AI API240 1. Aktivieren Sie IAM Credentials API, STS API und Google Cloud's Agent Platform API

241 2. Erstellen Sie einen Workload Identity Pool und Provider für GitLab OIDC241 2. Erstellen Sie einen Workload Identity Pool und Provider für GitLab OIDC

242 3. Erstellen Sie ein dediziertes Service-Konto mit Vertex AI-Rollen242 3. Erstellen Sie ein dediziertes Service-Konto mit Google Cloud's Agent Platform-Rollen

243 4. Gewähren Sie dem WIF-Principal die Berechtigung, das Service-Konto zu imitieren243 4. Gewähren Sie dem WIF-Principal die Berechtigung, das Service-Konto zu imitieren

244 244 

245 **Erforderliche Werte zum Speichern in CI/CD-Variablen:**245 **Erforderliche Werte zum Speichern in CI/CD-Variablen:**


250 Fügen Sie Variablen in Einstellungen → CI/CD → Variablen hinzu:250 Fügen Sie Variablen in Einstellungen → CI/CD → Variablen hinzu:

251 251 

252 ```yaml theme={null}252 ```yaml theme={null}

253 # Für Google Vertex AI:253 # Für Google Cloud's Agent Platform:

254 - GCP_WORKLOAD_IDENTITY_PROVIDER254 - GCP_WORKLOAD_IDENTITY_PROVIDER

255 - GCP_SERVICE_ACCOUNT255 - GCP_SERVICE_ACCOUNT

256 - CLOUD_ML_REGION (zum Beispiel us-east5)256 - CLOUD_ML_REGION (zum Beispiel us-east5)

257 ```257 ```

258 258 

259 Verwenden Sie das Google Vertex AI-Job-Beispiel oben, um sich ohne Speicherung von Schlüsseln zu authentifizieren.259 Verwenden Sie das Job-Beispiel oben für Google Cloud's Agent Platform, um sich ohne Speicherung von Schlüsseln zu authentifizieren.

260 </Tab>260 </Tab>

261</Tabs>261</Tabs>

262 262 


305 305 

306* Amazon Bedrock aktiviert mit Zugriff auf Ihr gewähltes Claude-Modell(e)306* Amazon Bedrock aktiviert mit Zugriff auf Ihr gewähltes Claude-Modell(e)

307* GitLab OIDC in AWS konfiguriert mit einer Rolle, die Ihr GitLab-Projekt und Refs vertraut307* GitLab OIDC in AWS konfiguriert mit einer Rolle, die Ihr GitLab-Projekt und Refs vertraut

308* IAM-Rolle mit Bedrock-Berechtigungen (Least Privilege empfohlen)308* IAM-Rolle mit Amazon Bedrock-Berechtigungen (Least Privilege empfohlen)

309 309 

310**Erforderliche CI/CD-Variablen:**310**Erforderliche CI/CD-Variablen:**

311 311 

312* `AWS_ROLE_TO_ASSUME`: ARN der IAM-Rolle für Bedrock-Zugriff312* `AWS_ROLE_TO_ASSUME`: ARN der IAM-Rolle für Amazon Bedrock-Zugriff

313* `AWS_REGION`: Bedrock-Region (zum Beispiel `us-west-2`)313* `AWS_REGION`: Amazon Bedrock-Region (zum Beispiel `us-west-2`)

314 314 

315```yaml theme={null}315```yaml theme={null}

316claude-bedrock:316claude-bedrock:


347```347```

348 348 

349<Note>349<Note>

350 Modell-IDs für Bedrock enthalten regionsspezifische Präfixe (zum Beispiel `us.anthropic.claude-sonnet-4-6`). Übergeben Sie das gewünschte Modell über Ihre Job-Konfiguration oder den Prompt, wenn Ihr Workflow dies unterstützt.350 Modell-IDs für Amazon Bedrock enthalten regionsspezifische Präfixe (zum Beispiel `us.anthropic.claude-sonnet-4-6`). Übergeben Sie das gewünschte Modell über Ihre Job-Konfiguration oder den Prompt, wenn Ihr Workflow dies unterstützt.

351</Note>351</Note>

352 352 

353<h3 id="google-vertex-ai-job-example-workload-identity-federation">353<h3 id="agent-platform-job-example-workload-identity-federation">

354 Google Vertex AI-Job-Beispiel (Workload Identity Federation)354 Agent Platform-Job-Beispiel (Workload Identity Federation)

355</h3>355</h3>

356 356 

357**Voraussetzungen:**357**Voraussetzungen:**

358 358 

359* Vertex AI API in Ihrem GCP-Projekt aktiviert359* Google Cloud's Agent Platform API in Ihrem GCP-Projekt aktiviert

360* Workload Identity Federation konfiguriert, um GitLab OIDC zu vertrauen360* Workload Identity Federation konfiguriert, um GitLab OIDC zu vertrauen

361* Ein Service-Konto mit Vertex AI-Berechtigungen361* Ein Service-Konto mit Google Cloud's Agent Platform-Berechtigungen

362 362 

363**Erforderliche CI/CD-Variablen:**363**Erforderliche CI/CD-Variablen:**

364 364 

365* `GCP_WORKLOAD_IDENTITY_PROVIDER`: Vollständiger Provider-Ressourcenname365* `GCP_WORKLOAD_IDENTITY_PROVIDER`: Vollständiger Provider-Ressourcenname

366* `GCP_SERVICE_ACCOUNT`: Service-Konto-E-Mail366* `GCP_SERVICE_ACCOUNT`: Service-Konto-E-Mail

367* `CLOUD_ML_REGION`: Vertex-Region (zum Beispiel `us-east5`)367* `CLOUD_ML_REGION`: Google Cloud's Agent Platform-Region (zum Beispiel `us-east5`)

368 368 

369```yaml theme={null}369```yaml theme={null}

370claude-vertex:370claude-vertex:


490</h3>490</h3>

491 491 

492* **Für Claude API**: Bestätigen Sie, dass `ANTHROPIC_API_KEY` gültig und nicht abgelaufen ist492* **Für Claude API**: Bestätigen Sie, dass `ANTHROPIC_API_KEY` gültig und nicht abgelaufen ist

493* **Für Bedrock/Vertex**: Überprüfen Sie OIDC/WIF-Konfiguration, Rollenimitierung und Geheimnisnamen; bestätigen Sie Region und Modellverfügbarkeit493* **Für Amazon Bedrock oder Google Cloud's Agent Platform**: Überprüfen Sie OIDC/WIF-Konfiguration, Rollenimitierung und Geheimnisnamen; bestätigen Sie Region und Modellverfügbarkeit

494 494 

495<h2 id="advanced-configuration">495<h2 id="advanced-configuration">

496 Erweiterte Konfiguration496 Erweiterte Konfiguration


505* `prompt` / `prompt_file`: Geben Sie Anweisungen inline (`-p`) oder über eine Datei an505* `prompt` / `prompt_file`: Geben Sie Anweisungen inline (`-p`) oder über eine Datei an

506* `max_turns`: Begrenzen Sie die Anzahl der Hin- und Herbewegungen506* `max_turns`: Begrenzen Sie die Anzahl der Hin- und Herbewegungen

507* `timeout_minutes`: Begrenzen Sie die Gesamtausführungszeit507* `timeout_minutes`: Begrenzen Sie die Gesamtausführungszeit

508* `ANTHROPIC_API_KEY`: Erforderlich für die Claude API (nicht für Bedrock/Vertex verwendet)508* `ANTHROPIC_API_KEY`: Erforderlich für die Claude API (nicht für Amazon Bedrock oder Google Cloud's Agent Platform verwendet)

509* Provider-spezifische Umgebung: `AWS_REGION`, Projekt-/Regionsvariablen für Vertex509* Provider-spezifische Umgebung: `AWS_REGION`, Projekt-/Regionsvariablen für Google Cloud's Agent Platform

510 510 

511<Note>511<Note>

512 Genaue Flags und Parameter können je nach Version von `@anthropic-ai/claude-code` variieren. Führen Sie `claude --help` in Ihrem Job aus, um unterstützte Optionen zu sehen.512 Genaue Flags und Parameter können je nach Version von `@anthropic-ai/claude-code` variieren. Führen Sie `claude --help` in Ihrem Job aus, um unterstützte Optionen zu sehen.

glossary.md +3 −1

Details

262 262 

263Das Baseline-Genehmigungsverhalten für die Sitzung. Wechseln Sie mit `Shift+Tab` in der CLI oder verwenden Sie den Mode-Selector in VS Code, Desktop und claude.ai. Verfügbare Modi sind `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` und `bypassPermissions`.263Das Baseline-Genehmigungsverhalten für die Sitzung. Wechseln Sie mit `Shift+Tab` in der CLI oder verwenden Sie den Mode-Selector in VS Code, Desktop und claude.ai. Verfügbare Modi sind `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` und `bypassPermissions`.

264 264 

265Der `default` Mode wird in der CLI und in den VS Code- und JetBrains-Erweiterungen als Manual bezeichnet, und Claude Code akzeptiert `manual` als Alias für den Wert.

266 

265Weitere Informationen: [Wählen Sie einen Permission Mode](/de/permission-modes)267Weitere Informationen: [Wählen Sie einen Permission Mode](/de/permission-modes)

266 268 

267<h3 id="permission-rule">269<h3 id="permission-rule">


388 Teleport390 Teleport

389</h3>391</h3>

390 392 

391Ein Befehl, `/teleport`, der eine Cloud Claude Code-Sitzung in Ihr lokales Terminal zieht. Claude ruft den Branch ab, lädt den Konversationsverlauf und setzt die Web-Sitzung fort, wo sie zuletzt war. Die umgekehrte Richtung ist `--remote`, die eine lokale Aufgabe zum Ausführen im Web sendet.393Ein Befehl, `/teleport`, der eine Cloud Claude Code-Sitzung in Ihr lokales Terminal zieht. Claude ruft den Branch ab, lädt den Konversationsverlauf und setzt die Web-Sitzung fort, wo sie zuletzt war. Die umgekehrte Richtung ist `--cloud`, die eine lokale Aufgabe zum Ausführen im Web sendet.

392 394 

393Weitere Informationen: [Vom Web zum Terminal](/de/claude-code-on-the-web#from-web-to-terminal)395Weitere Informationen: [Vom Web zum Terminal](/de/claude-code-on-the-web#from-web-to-terminal)

394 396 

Details

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

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

4 4 

5# Claude Code auf Google Vertex AI5# Claude Code auf Google Clouds Agent Platform

6 6 

7> Erfahren Sie, wie Sie Claude Code über Google Vertex AI konfigurieren, einschließlich Setup, IAM-Konfiguration und Fehlerbehebung.7> Erfahren Sie, wie Sie Claude Code über Google Clouds Agent Platform konfigurieren, ehemals Vertex AI, einschließlich Setup, IAM-Konfiguration und Fehlerbehebung.

8 8 

9export const ContactSalesCard = ({surface}) => {9export const ContactSalesCard = ({surface}) => {

10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;


82 Voraussetzungen82 Voraussetzungen

83</h2>83</h2>

84 84 

85Bevor Sie Claude Code mit Vertex AI konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:85Bevor Sie Claude Code mit Google Cloud's Agent Platform, ehemals Vertex AI, konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:

86 86 

87* Ein Google Cloud Platform (GCP)-Konto mit aktivierter Abrechnung87* Ein Google Cloud Platform (GCP)-Konto mit aktivierter Abrechnung

88* Ein GCP-Projekt mit aktivierter Vertex AI API88* Ein GCP-Projekt mit aktivierter Google Cloud's Agent Platform API

89* Zugriff auf gewünschte Claude-Modelle (z. B. Claude Sonnet 4.6)89* Zugriff auf gewünschte Claude-Modelle (z. B. Claude Sonnet 4.6)

90* Google Cloud SDK (`gcloud`) installiert und konfiguriert90* Google Cloud SDK (`gcloud`) installiert und konfiguriert

91* Kontingent im gewünschten GCP-Bereich zugewiesen91* Kontingent im gewünschten GCP-Bereich zugewiesen

92 92 

93Um sich mit Ihren eigenen Vertex AI-Anmeldedaten anzumelden, folgen Sie [Anmelden mit Vertex AI](#sign-in-with-vertex-ai) unten. Um Claude Code in einem Team bereitzustellen, verwenden Sie die Schritte zum [manuellen Setup](#set-up-manually) und [fixieren Sie Ihre Modellversionen](#5-pin-model-versions), bevor Sie ausrollen.93Um sich mit Ihren eigenen Google Cloud's Agent Platform-Anmeldedaten anzumelden, folgen Sie [Anmelden mit Google Cloud's Agent Platform](#sign-in-with-agent-platform) unten. Um Claude Code in einem Team bereitzustellen, verwenden Sie die Schritte zum [manuellen Setup](#set-up-manually) und [fixieren Sie Ihre Modellversionen](#5-pin-model-versions), bevor Sie ausrollen.

94 94 

95<h2 id="sign-in-with-vertex-ai">95<h2 id="sign-in-with-agent-platform">

96 Anmelden mit Vertex AI96 Anmelden mit Agent Platform

97</h2>97</h2>

98 98 

99Wenn Sie Google Cloud-Anmeldedaten haben und Claude Code über Vertex AI verwenden möchten, führt Sie der Anmeldeasistent durch den Prozess. Sie führen die GCP-seitigen Voraussetzungen einmal pro Projekt durch; der Assistent kümmert sich um die Claude Code-Seite.99Wenn Sie Google Cloud-Anmeldedaten haben und Claude Code über Google Cloud's Agent Platform verwenden möchten, führt Sie der Anmeldeasistent durch den Prozess. Sie führen die GCP-seitigen Voraussetzungen einmal pro Projekt durch; der Assistent kümmert sich um die Claude Code-Seite.

100 100 

101<Note>101<Note>

102 Der Vertex AI-Setup-Assistent erfordert Claude Code v2.1.98 oder später. Führen Sie `claude --version` aus, um dies zu überprüfen.102 Der Google Cloud's Agent Platform-Setup-Assistent erfordert Claude Code v2.1.98 oder später. Führen Sie `claude --version` aus, um dies zu überprüfen.

103</Note>103</Note>

104 104 

105<Steps>105<Steps>

106 <Step title="Aktivieren Sie Claude-Modelle in Ihrem GCP-Projekt">106 <Step title="Aktivieren Sie Claude-Modelle in Ihrem GCP-Projekt">

107 [Aktivieren Sie die Vertex AI API](#1-enable-vertex-ai-api) für Ihr Projekt, und fordern Sie dann Zugriff auf die Claude-Modelle an, die Sie im [Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) möchten. Siehe [IAM-Konfiguration](#iam-configuration) für die Berechtigungen, die Ihr Konto benötigt.107 [Aktivieren Sie Google Cloud's Agent Platform API](#1-enable-agent-platform-api) für Ihr Projekt, und fordern Sie dann Zugriff auf die Claude-Modelle an, die Sie im [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) möchten. Siehe [IAM-Konfiguration](#iam-configuration) für die Berechtigungen, die Ihr Konto benötigt.

108 </Step>108 </Step>

109 109 

110 <Step title="Starten Sie Claude Code und wählen Sie Vertex AI">110 <Step title="Starten Sie Claude Code und wählen Sie Google Cloud's Agent Platform">

111 Führen Sie `claude` aus. Wählen Sie bei der Anmeldeeingabeaufforderung **3rd-party platform** und dann **Google Vertex AI**.111 Führen Sie `claude` aus. Wählen Sie bei der Anmeldeeingabeaufforderung **3rd-party platform** und dann **Google Vertex AI**, das Label, das die Anmeldeeingabeaufforderung immer noch für Google Cloud's Agent Platform verwendet.

112 </Step>112 </Step>

113 113 

114 <Step title="Folgen Sie den Eingabeaufforderungen des Assistenten">114 <Step title="Folgen Sie den Eingabeaufforderungen des Assistenten">


122 Regionskonfiguration122 Regionskonfiguration

123</h2>123</h2>

124 124 

125Claude Code unterstützt Vertex AI [globale](https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai), Multi-Region- und regionale Endpunkte. Legen Sie `CLOUD_ML_REGION` auf `global`, einen Multi-Region-Standort wie `eu` oder `us` oder eine bestimmte Region wie `us-east5` fest. Claude Code wählt den korrekten Vertex AI-Hostnamen für jedes Formular aus, einschließlich der Hosts `aiplatform.eu.rep.googleapis.com` und `aiplatform.us.rep.googleapis.com` für Multi-Region-Standorte.125Claude Code unterstützt Google Cloud's Agent Platform [globale](https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai), Multi-Region- und regionale Endpunkte. Legen Sie `CLOUD_ML_REGION` auf `global`, einen Multi-Region-Standort wie `eu` oder `us` oder eine bestimmte Region wie `us-east5` fest. Claude Code wählt den korrekten Google Cloud's Agent Platform-Hostnamen für jedes Formular aus, einschließlich der Hosts `aiplatform.eu.rep.googleapis.com` und `aiplatform.us.rep.googleapis.com` für Multi-Region-Standorte.

126 126 

127<Note>127<Note>

128 Vertex AI unterstützt möglicherweise die Claude Code-Standardmodelle nicht auf jedem Endpunkttyp. Die Modellverfügbarkeit variiert je nach [spezifischen Regionen](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#genai-partner-models), Multi-Region-Standorten und [globalen Endpunkten](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#supported_models). Möglicherweise müssen Sie zu einem unterstützten Standort wechseln oder ein unterstütztes Modell angeben.128 Google Cloud's Agent Platform unterstützt möglicherweise die Claude Code-Standardmodelle nicht auf jedem Endpunkttyp. Die Modellverfügbarkeit variiert je nach [spezifischen Regionen](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#genai-partner-models), Multi-Region-Standorten und [globalen Endpunkten](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#supported_models). Möglicherweise müssen Sie zu einem unterstützten Standort wechseln oder ein unterstütztes Modell angeben.

129</Note>129</Note>

130 130 

131<h2 id="set-up-manually">131<h2 id="set-up-manually">

132 Manuelles Setup132 Manuelles Setup

133</h2>133</h2>

134 134 

135Um Vertex AI über Umgebungsvariablen statt über den Assistenten zu konfigurieren, z. B. in CI oder einem skriptgesteuerten Enterprise-Rollout, folgen Sie den folgenden Schritten.135Um Google Cloud's Agent Platform über Umgebungsvariablen statt über den Assistenten zu konfigurieren, z. B. in CI oder einem skriptgesteuerten Enterprise-Rollout, folgen Sie den folgenden Schritten.

136 136 

137<h3 id="1-enable-vertex-ai-api">137<h3 id="1-enable-agent-platform-api">

138 1. Aktivieren Sie die Vertex AI API138 1. Aktivieren Sie die Agent Platform API

139</h3>139</h3>

140 140 

141Aktivieren Sie die Vertex AI API in Ihrem GCP-Projekt:141Aktivieren Sie die Agent Platform API von Google Cloud in Ihrem GCP-Projekt:

142 142 

143```bash theme={null}143```bash theme={null}

144# Legen Sie Ihre Projekt-ID fest144# Legen Sie Ihre Projekt-ID fest

145gcloud config set project YOUR-PROJECT-ID145gcloud config set project YOUR-PROJECT-ID

146 146 

147# Aktivieren Sie die Vertex AI API147# Aktivieren Sie die Agent Platform API

148gcloud services enable aiplatform.googleapis.com148gcloud services enable aiplatform.googleapis.com

149```149```

150 150 


152 2. Fordern Sie Modellzugriff an152 2. Fordern Sie Modellzugriff an

153</h3>153</h3>

154 154 

155Fordern Sie Zugriff auf Claude-Modelle in Vertex AI an:155Fordern Sie Zugriff auf Claude-Modelle in Google Cloud's Agent Platform an:

156 156 

1571. Navigieren Sie zum [Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)1571. Navigieren Sie zum [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)

1582. Suchen Sie nach 'Claude"-Modellen1582. Suchen Sie nach 'Claude"-Modellen

1593. Fordern Sie Zugriff auf gewünschte Claude-Modelle an (z. B. Claude Sonnet 4.6)1593. Fordern Sie Zugriff auf gewünschte Claude-Modelle an (z. B. Claude Sonnet 4.6)

1604. Warten Sie auf Genehmigung (kann 24–48 Stunden dauern)1604. Warten Sie auf Genehmigung (kann 24–48 Stunden dauern)


170Claude Code v2.1.121 oder später unterstützt [X.509-zertifikatbasierte Workload Identity Federation](https://cloud.google.com/iam/docs/workload-identity-federation-with-x509-certificates) über die gleiche Application Default Credentials-Kette. Legen Sie `GOOGLE_APPLICATION_CREDENTIALS` auf den Pfad Ihrer Anmeldedaten-Konfigurationsdatei fest.170Claude Code v2.1.121 oder später unterstützt [X.509-zertifikatbasierte Workload Identity Federation](https://cloud.google.com/iam/docs/workload-identity-federation-with-x509-certificates) über die gleiche Application Default Credentials-Kette. Legen Sie `GOOGLE_APPLICATION_CREDENTIALS` auf den Pfad Ihrer Anmeldedaten-Konfigurationsdatei fest.

171 171 

172<Note>172<Note>

173 Claude Code verwendet `ANTHROPIC_VERTEX_PROJECT_ID` als die Projekt-ID für Vertex AI-Anfragen. Die Umgebungsvariablen `GCLOUD_PROJECT` und `GOOGLE_CLOUD_PROJECT` sowie die Anmeldedatei, auf die `GOOGLE_APPLICATION_CREDENTIALS` verweist, haben Vorrang vor ihr. Wenn keine dieser Optionen gesetzt sind, wird die Projekt-ID aus Ihrer `gcloud`-Konfiguration oder dem angehängten Service-Konto aufgelöst.173 Claude Code verwendet `ANTHROPIC_VERTEX_PROJECT_ID` als die Projekt-ID für Google Cloud's Agent Platform-Anfragen. Die Umgebungsvariablen `GCLOUD_PROJECT` und `GOOGLE_CLOUD_PROJECT` sowie die Anmeldedatei, auf die `GOOGLE_APPLICATION_CREDENTIALS` verweist, haben Vorrang vor ihr. Wenn keine dieser Optionen gesetzt sind, wird die Projekt-ID aus Ihrer `gcloud`-Konfiguration oder dem angehängten Service-Konto aufgelöst.

174</Note>174</Note>

175 175 

176<h4 id="advanced-credential-configuration">176<h4 id="advanced-credential-configuration">


197Legen Sie die folgenden Umgebungsvariablen fest:197Legen Sie die folgenden Umgebungsvariablen fest:

198 198 

199```bash theme={null}199```bash theme={null}

200# Aktivieren Sie die Vertex AI-Integration200# Aktivieren Sie die Agent Platform-Integration

201export CLAUDE_CODE_USE_VERTEX=1201export CLAUDE_CODE_USE_VERTEX=1

202export CLOUD_ML_REGION=global202export CLOUD_ML_REGION=global

203export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID203export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

204 204 

205# Optional: Überschreiben Sie die Vertex-Endpunkt-URL für benutzerdefinierte Endpunkte oder Gateways205# Optional: Überschreiben Sie die Agent Platform-Endpunkt-URL für benutzerdefinierte Endpunkte oder Gateways

206# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com206# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com

207 207 

208# Optional: Deaktivieren Sie Prompt Caching bei Bedarf208# Optional: Deaktivieren Sie Prompt Caching bei Bedarf


216export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1216export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

217```217```

218 218 

219Die meisten Modellversionen haben eine entsprechende `VERTEX_REGION_CLAUDE_*`-Variable. Siehe die [Referenz für Umgebungsvariablen](/de/env-vars) für die vollständige Liste. Überprüfen Sie [Vertex Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), um zu bestimmen, welche Modelle globale Endpunkte versus nur regionale Endpunkte unterstützen.219Die meisten Modellversionen haben eine entsprechende `VERTEX_REGION_CLAUDE_*`-Variable. Siehe die [Referenz für Umgebungsvariablen](/de/env-vars) für die vollständige Liste. Überprüfen Sie [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), um zu bestimmen, welche Modelle globale Endpunkte versus nur regionale Endpunkte unterstützen.

220 220 

221[Prompt Caching](/de/prompt-caching) wird automatisch aktiviert. Um es zu deaktivieren, legen Sie `DISABLE_PROMPT_CACHING=1` fest. Um eine 1-Stunden-Cache-TTL statt des 5-Minuten-Standards anzufordern, legen Sie `ENABLE_PROMPT_CACHING_1H=1` fest; Cache-Schreibvorgänge mit einer 1-Stunden-TTL werden mit einem höheren Satz abgerechnet. Für erhöhte Ratenlimits wenden Sie sich an den Google Cloud-Support. Bei Verwendung von Vertex AI ist der Befehl `/logout` nicht verfügbar, da die Authentifizierung über Google Cloud-Anmeldedaten erfolgt.221[Prompt Caching](/de/prompt-caching) wird automatisch aktiviert. Um es zu deaktivieren, legen Sie `DISABLE_PROMPT_CACHING=1` fest. Um eine 1-Stunden-Cache-TTL statt des 5-Minuten-Standards anzufordern, legen Sie `ENABLE_PROMPT_CACHING_1H=1` fest; Cache-Schreibvorgänge mit einer 1-Stunden-TTL werden mit einem höheren Satz abgerechnet. Für erhöhte Ratenlimits wenden Sie sich an den Google Cloud-Support. Bei Verwendung von Google Cloud's Agent Platform ist der Befehl `/logout` nicht verfügbar, da die Authentifizierung über Google Cloud-Anmeldedaten erfolgt.

222 222 

223Claude Code deaktiviert [MCP-Toolsuche](/de/mcp#scale-with-mcp-tool-search) standardmäßig auf Vertex AI, sodass MCP-Tool-Definitionen beim Start geladen werden. Vertex AI unterstützt Toolsuche für Claude Sonnet 4.5 und später sowie Claude Opus 4.5 und später. Legen Sie `ENABLE_TOOL_SEARCH=true` fest, um sie auf diesen Modellen zu aktivieren. Frühere Modelle auf Vertex AI akzeptieren den erforderlichen Beta-Header nicht, und Anfragen schlagen fehl, wenn Sie die Toolsuche mit ihnen aktivieren.223Claude Code deaktiviert [MCP-Toolsuche](/de/mcp#scale-with-mcp-tool-search) standardmäßig auf Google Cloud's Agent Platform, sodass MCP-Tool-Definitionen beim Start geladen werden. Google Cloud's Agent Platform unterstützt Toolsuche für Claude Sonnet 4.5 und später sowie Claude Opus 4.5 und später. Legen Sie `ENABLE_TOOL_SEARCH=true` fest, um sie auf diesen Modellen zu aktivieren. Frühere Modelle auf Google Cloud's Agent Platform akzeptieren den erforderlichen Beta-Header nicht, und Anfragen schlagen fehl, wenn Sie die Toolsuche mit ihnen aktivieren.

224 224 

225<h3 id="5-pin-model-versions">225<h3 id="5-pin-model-versions">

226 5. Fixieren Sie Modellversionen226 5. Fixieren Sie Modellversionen

227</h3>227</h3>

228 228 

229<Warning>229<Warning>

230 Fixieren Sie spezifische Modellversionen bei der Bereitstellung für mehrere Benutzer. Ohne Fixierung werden Modellaliase wie `sonnet` und `opus` zu Claude Codes integriertem Standard für Vertex AI aufgelöst, der hinter der neuesten Version zurückbleiben kann und möglicherweise noch nicht in Ihrem Projekt aktiviert ist. Claude Code [fällt zurück](#startup-model-checks) beim Start zur vorherigen Version zurück, wenn der Standard nicht verfügbar ist, aber das Fixieren ermöglicht es Ihnen, zu kontrollieren, wann Ihre Benutzer zu einem neuen Modell wechseln.230 Fixieren Sie spezifische Modellversionen bei der Bereitstellung für mehrere Benutzer. Ohne Fixierung werden Modellaliase wie `sonnet` und `opus` zu Claude Codes integriertem Standard für Google Cloud's Agent Platform aufgelöst, der hinter der neuesten Version zurückbleiben kann und möglicherweise noch nicht in Ihrem Projekt aktiviert ist. Claude Code [fällt zurück](#startup-model-checks) beim Start zur vorherigen Version zurück, wenn der Standard nicht verfügbar ist, aber das Fixieren ermöglicht es Ihnen, zu kontrollieren, wann Ihre Benutzer zu einem neuen Modell wechseln.

231</Warning>231</Warning>

232 232 

233Legen Sie diese Umgebungsvariablen auf spezifische Vertex AI-Modell-IDs fest.233Legen Sie diese Umgebungsvariablen auf spezifische Google Cloud's Agent Platform-Modell-IDs fest.

234 234 

235Ohne `ANTHROPIC_DEFAULT_OPUS_MODEL` wird der `opus`-Alias auf Vertex zu Opus 4.6 aufgelöst. Legen Sie ihn auf die Opus 4.8-ID fest, um das neueste Modell zu verwenden:235Ohne `ANTHROPIC_DEFAULT_OPUS_MODEL` wird der `opus`-Alias auf Google Cloud's Agent Platform zu Opus 4.6 aufgelöst. Legen Sie ihn auf die Opus 4.8-ID fest, um das neueste Modell zu verwenden:

236 236 

237```bash theme={null}237```bash theme={null}

238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'


249| Primäres Modell | `claude-sonnet-4-5@20250929` |249| Primäres Modell | `claude-sonnet-4-5@20250929` |

250| Kleines/schnelles Modell | Gleich wie primäres Modell |250| Kleines/schnelles Modell | Gleich wie primäres Modell |

251 251 

252Hintergrundaufgaben wie die Generierung von Sitzungstiteln verwenden das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Auf Vertex AI setzt Claude Code dies standardmäßig auf das primäre Modell, da Haiku möglicherweise nicht in jedem Projekt oder jeder Region aktiviert ist. Um Haiku für Hintergrundaufgaben zu verwenden, legen Sie `ANTHROPIC_DEFAULT_HAIKU_MODEL` auf eine Modell-ID fest, die in Ihrem Projekt verfügbar ist.252Hintergrundaufgaben wie die Generierung von Sitzungstiteln verwenden das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Auf Google Cloud's Agent Platform setzt Claude Code dies standardmäßig auf das primäre Modell, da Haiku möglicherweise nicht in jedem Projekt oder jeder Region aktiviert ist. Um Haiku für Hintergrundaufgaben zu verwenden, legen Sie `ANTHROPIC_DEFAULT_HAIKU_MODEL` auf eine Modell-ID fest, die in Ihrem Projekt verfügbar ist.

253 253 

254Um Modelle weiter anzupassen:254Um Modelle weiter anzupassen:

255 255 


262 Startmodellprüfungen262 Startmodellprüfungen

263</h2>263</h2>

264 264 

265Wenn Claude Code mit konfiguriertem Vertex AI startet, überprüft es, dass die Modelle, die es verwenden möchte, in Ihrem Projekt zugänglich sind. Diese Prüfung erfordert Claude Code v2.1.98 oder später.265Wenn Claude Code mit Google Cloud's Agent Platform konfiguriert startet, überprüft es, dass die Modelle, die es verwenden möchte, in Ihrem Projekt zugänglich sind. Diese Prüfung erfordert Claude Code v2.1.98 oder später.

266 266 

267Wenn Sie eine Modellversion fixiert haben, die älter als der aktuelle Claude Code-Standard ist, und Ihr Projekt die neuere Version aufrufen kann, fordert Claude Code Sie auf, die Fixierung zu aktualisieren. Das Akzeptieren schreibt die neue Modell-ID in Ihre [Benutzereinstellungsdatei](/de/settings) und startet Claude Code neu. Das Ablehnen wird bis zur nächsten Standardversionänderung beibehalten.267Wenn Sie eine Modellversion fixiert haben, die älter als der aktuelle Claude Code-Standard ist, und Ihr Projekt die neuere Version aufrufen kann, fordert Claude Code Sie auf, die Fixierung zu aktualisieren. Das Akzeptieren schreibt die neue Modell-ID in Ihre [Benutzereinstellungsdatei](/de/settings) und startet Claude Code neu. Das Ablehnen wird bis zur nächsten Standardversionänderung beibehalten.

268 268 


280 280 

281Für restriktivere Berechtigungen erstellen Sie eine benutzerdefinierte Rolle nur mit den oben genannten Berechtigungen.281Für restriktivere Berechtigungen erstellen Sie eine benutzerdefinierte Rolle nur mit den oben genannten Berechtigungen.

282 282 

283Weitere Informationen finden Sie in der [Vertex IAM-Dokumentation](https://cloud.google.com/vertex-ai/docs/general/access-control).283Weitere Informationen finden Sie in der [Google Cloud Agent Platform IAM-Dokumentation](https://cloud.google.com/vertex-ai/docs/general/access-control).

284 284 

285<Note>285<Note>

286 Erstellen Sie ein dediziertes GCP-Projekt für Claude Code, um die Kostenverfolgung und Zugriffskontrolle zu vereinfachen.286 Erstellen Sie ein dediziertes GCP-Projekt für Claude Code, um die Kostenverfolgung und Zugriffskontrolle zu vereinfachen.


290 1M-Token-Kontextfenster290 1M-Token-Kontextfenster

291</h2>291</h2>

292 292 

293Claude Sonnet 5, Opus 4.6 und später sowie Sonnet 4.6 unterstützen das [1M-Token-Kontextfenster](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window) auf Vertex AI. Sonnet 5 läuft immer mit dem 1M-Fenster, ohne dass eine `[1m]`-Variante zum Auswählen vorhanden ist. Bei den anderen Modellen aktiviert Claude Code automatisch das erweiterte Kontextfenster, wenn Sie eine 1M-Modellvariante auswählen.293Claude Sonnet 5, Opus 4.6 und später sowie Sonnet 4.6 unterstützen das [1M-Token-Kontextfenster](https://platform.claude.com/docs/de/build-with-claude/context-windows#1m-token-context-window) auf Google Cloud's Agent Platform. Sonnet 5 läuft immer mit dem 1M-Fenster, ohne dass eine `[1m]`-Variante zum Auswählen vorhanden ist. Bei den anderen Modellen aktiviert Claude Code automatisch das erweiterte Kontextfenster, wenn Sie eine 1M-Modellvariante auswählen.

294 294 

295Der [Setup-Assistent](#sign-in-with-vertex-ai) bietet eine 1M-Kontextoption an, wenn er Modelle fixiert. Um es stattdessen für ein manuell fixiertes Modell zu aktivieren, hängen Sie `[1m]` an die Modell-ID an. Siehe [Modelle für Drittanbieter-Bereitstellungen fixieren](/de/model-config#pin-models-for-third-party-deployments) für Details.295Der [Setup-Assistent](#sign-in-with-agent-platform) bietet eine 1M-Kontextoption an, wenn er Modelle fixiert. Um es stattdessen für ein manuell fixiertes Modell zu aktivieren, hängen Sie `[1m]` an die Modell-ID an. Siehe [Modelle für Drittanbieter-Bereitstellungen fixieren](/de/model-config#pin-models-for-third-party-deployments) für Details.

296 296 

297<h2 id="troubleshooting">297<h2 id="troubleshooting">

298 Fehlerbehebung298 Fehlerbehebung


325 Zusätzliche Ressourcen325 Zusätzliche Ressourcen

326</h2>326</h2>

327 327 

328* [Vertex AI-Dokumentation](https://cloud.google.com/vertex-ai/docs)328* [Google Cloud's Agent Platform-Dokumentation](https://cloud.google.com/vertex-ai/docs)

329* [Vertex AI-Preisgestaltung](https://cloud.google.com/vertex-ai/pricing)329* [Google Cloud's Agent Platform-Preisgestaltung](https://cloud.google.com/vertex-ai/pricing)

330* [Vertex AI-Kontingente und -Limits](https://cloud.google.com/vertex-ai/docs/quotas)330* [Google Cloud's Agent Platform-Kontingente und -Limits](https://cloud.google.com/vertex-ai/docs/quotas)

headless.md +9 −3

Details

56| Benutzerdefinierte Agenten | `--agents <json>` |56| Benutzerdefinierte Agenten | `--agents <json>` |

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

58 58 

59Der Bare-Modus überspringt OAuth und Keychain-Lesevorgänge. Die Anthropic-Authentifizierung muss von `ANTHROPIC_API_KEY` oder einem `apiKeyHelper` in der an `--settings` übergebenen JSON stammen. Bedrock, Vertex und Foundry verwenden ihre üblichen Anmeldedaten des Anbieters.59Der Bare-Modus überspringt OAuth und Keychain-Lesevorgänge. Die Anthropic-Authentifizierung muss von `ANTHROPIC_API_KEY` oder einem `apiKeyHelper` in der an `--settings` übergebenen JSON stammen. Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry verwenden ihre üblichen Anmeldedaten des Anbieters.

60 60 

61<Note>61<Note>

62 `--bare` ist der empfohlene Modus für skriptgesteuerte und SDK-Aufrufe und wird in einer zukünftigen Version zum Standard für `-p`.62 `--bare` ist der empfohlene Modus für skriptgesteuerte und SDK-Aufrufe und wird in einer zukünftigen Version zum Standard für `-p`.


136 --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'136 --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'

137```137```

138 138 

139Wenn der Wert kein gültiges JSON Schema ist, beendet sich `claude` mit `Error: --json-schema is not a valid JSON Schema` gefolgt von der Diagnose des Validators. Claude Code akzeptiert Schemas, die das Schlüsselwort `format` verwenden, wie `"format": "email"`, behandelt aber `format` als Anmerkung und erzwingt es nicht. Vor v2.1.205 ignorierte Claude Code ein ungültiges Schema stillschweigend und gab unstrukturierten Text zurück, und behandelte jedes Schema, das `format` enthielt, als ungültig.

140 

139<Tip>141<Tip>

140 Verwenden Sie ein Tool wie [jq](https://jqlang.github.io/jq/), um die Antwort zu analysieren und bestimmte Felder zu extrahieren:142 Verwenden Sie ein Tool wie [jq](https://jqlang.github.io/jq/), um die Antwort zu analysieren und bestimmte Felder zu extrahieren:

141 143 


182| `uuid` | Zeichenkette | eindeutige Ereigniskennung |184| `uuid` | Zeichenkette | eindeutige Ereigniskennung |

183| `session_id` | Zeichenkette | Sitzung, zu der das Ereignis gehört |185| `session_id` | Zeichenkette | Sitzung, zu der das Ereignis gehört |

184 186 

185Das `system/init`-Ereignis meldet Sitzungsmetadaten einschließlich des Modells, Tools, MCP-Server und geladener Plugins. Es ist das erste Ereignis im Stream, es sei denn, [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/de/env-vars) ist gesetzt. In diesem Fall gehen `plugin_install`-Ereignisse voraus. Verwenden Sie die Plugin-Felder, um CI fehlschlagen zu lassen, wenn ein Plugin nicht geladen wurde:187Das `system/init`-Ereignis meldet Sitzungsmetadaten einschließlich des Modells, Tools, MCP-Server und geladener Plugins. Es ist das erste Ereignis im Stream, es sei denn, [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/de/env-vars) ist gesetzt. In diesem Fall gehen `plugin_install`-Ereignisse voraus.

188 

189Das Ereignis enthält auch ein optionales Array `capabilities` von Zeichenketten, das die Protokollverhalten benennt, die diese Claude Code-Version implementiert, wie `interrupt_receipt_v1`. Überprüfen Sie es, um Funktionen zu erkennen, anstatt Versionsnummern zu vergleichen, und ignorieren Sie Werte, die Sie nicht erkennen. Das Feld erfordert Claude Code v2.1.205 oder später und fehlt in früheren Versionen. Siehe [`SDKSystemMessage`](/de/agent-sdk/typescript#sdksystemmessage) für die Funktionsliste.

190 

191Verwenden Sie die Plugin-Felder, um CI fehlschlagen zu lassen, wenn ein Plugin nicht geladen wurde:

186 192 

187| Feld | Typ | Beschreibung |193| Feld | Typ | Beschreibung |

188| --------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |194| --------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |


234Das Flag `--allowedTools` verwendet [Berechtigungsregelsyntax](/de/settings#permission-rule-syntax). Das nachfolgende ` *` ermöglicht Präfix-Matching, sodass `Bash(git diff *)` jeden Befehl erlaubt, der mit `git diff` beginnt. Das Leerzeichen vor `*` ist wichtig: ohne es würde `Bash(git diff*)` auch `git diff-index` entsprechen.240Das Flag `--allowedTools` verwendet [Berechtigungsregelsyntax](/de/settings#permission-rule-syntax). Das nachfolgende ` *` ermöglicht Präfix-Matching, sodass `Bash(git diff *)` jeden Befehl erlaubt, der mit `git diff` beginnt. Das Leerzeichen vor `*` ist wichtig: ohne es würde `Bash(git diff*)` auch `git diff-index` entsprechen.

235 241 

236<Note>242<Note>

237 Benutzer-aufgerufene [skills](/de/skills) und benutzerdefinierte Befehle funktionieren im `-p`-Modus: Fügen Sie `/skill-name` in die Eingabeaufforderungszeichenkette ein und Claude Code erweitert sie vor dem Ausführen. Integrierte Befehle, die einen interaktiven Dialog öffnen, wie `/login`, sind im `-p`-Modus nicht verfügbar. {/* min-version: 2.1.181 */}Um eine Einstellung von einer `-p`-Aufruf zu ändern, übergeben Sie `key=value` an `/config`, zum Beispiel `/config thinking=false`.243 Benutzer-aufgerufene [skills](/de/skills) und benutzerdefinierte Befehle funktionieren im `-p`-Modus: Fügen Sie `/skill-name` in die Eingabeaufforderungszeichenkette ein und Claude Code erweitert sie vor dem Ausführen. Integrierte Befehle, die nur in der Terminalschnittstelle ausgeführt werden, wie `/login`, sind im `-p`-Modus nicht verfügbar. {/* min-version: 2.1.205 */}`/model`, `/effort`, `/fast`, `/color` und `/rename` akzeptieren den Wert als Argument, zum Beispiel `/model sonnet`, und `/mcp` ohne Argument gibt eine Textzusammenfassung des Serverstatus aus; diese Formen erfordern Claude Code v2.1.205 oder später und folgen den [Verfügbarkeitshinweisen](/de/commands#all-commands) jedes Befehls. {/* min-version: 2.1.181 */}Um eine Einstellung von einer `-p`-Aufruf zu ändern, übergeben Sie `key=value` an `/config`, zum Beispiel `/config thinking=false`.

238</Note>244</Note>

239 245 

240<h3 id="customize-the-system-prompt">246<h3 id="customize-the-system-prompt">

hooks.md +16 −10

Details

164Hooks werden in JSON-Einstellungsdateien definiert. Die Konfiguration hat drei Verschachtelungsebenen:164Hooks werden in JSON-Einstellungsdateien definiert. Die Konfiguration hat drei Verschachtelungsebenen:

165 165 

1661. Wählen Sie ein [Hook-Ereignis](#hook-events) aus, auf das Sie reagieren möchten, wie `PreToolUse` oder `Stop`1661. Wählen Sie ein [Hook-Ereignis](#hook-events) aus, auf das Sie reagieren möchten, wie `PreToolUse` oder `Stop`

1672. Fügen Sie eine [Matcher-Gruppe](#matcher-patterns) hinzu, um zu filtern, wann es ausgelöst wird, wie 'nur für das Bash-Tool"1672. Fügen Sie eine [Matcher-Gruppe](#matcher-patterns) hinzu, um zu filtern, wann es ausgelöst wird, wie nur für das Bash-Tool"

1683. Definieren Sie einen oder mehrere [Hook-Handler](#hook-handler-fields), die ausgeführt werden, wenn sie passen1683. Definieren Sie einen oder mehrere [Hook-Handler](#hook-handler-fields), die ausgeführt werden, wenn sie passen

169 169 

170Siehe [Wie ein Hook aufgelöst wird](#how-a-hook-resolves) oben für eine vollständige Anleitung mit einem kommentierten Beispiel.170Siehe [Wie ein Hook aufgelöst wird](#how-a-hook-resolves) oben für eine vollständige Anleitung mit einem kommentierten Beispiel.


280 280 

281Bindestriche in der Exact-Match-Menge erfordern Claude Code v2.1.195 oder später. In früheren Versionen wird ein bloßes hypheniertes Präfix wie `mcp__brave-search` als unverankerte Regex evaluiert und passt zu jedem Tool von diesem Server. Die Form `mcp__brave-search__.*` funktioniert auf jeder Version.281Bindestriche in der Exact-Match-Menge erfordern Claude Code v2.1.195 oder später. In früheren Versionen wird ein bloßes hypheniertes Präfix wie `mcp__brave-search` als unverankerte Regex evaluiert und passt zu jedem Tool von diesem Server. Die Form `mcp__brave-search__.*` funktioniert auf jeder Version.

282 282 

283Tools von einem [Plugin-gebündelten MCP-Server](/de/mcp#plugin-provided-mcp-servers) verwenden ein Scope-Server-Segment, das den Plugin-Namen enthält: `mcp__plugin_<plugin-name>_<server-name>__<tool>`. Ein Matcher, der gegen den bloßen Server-Schlüssel geschrieben ist, wird niemals für diese Tools ausgelöst. Für ein Plugin namens `my-plugin`, das einen Server unter dem Schlüssel `db` bündelt, erscheint ein `query`-Tool als `mcp__plugin_my-plugin_db__query`, daher ist der Matcher für jedes Tool von diesem Server `mcp__plugin_my-plugin_db__.*`. Verwenden Sie denselben Scope-Tool-Namen im Feld [`if`](#common-fields) eines Handlers. Siehe [Plugin-bereitgestellte MCP-Server](/de/mcp#plugin-provided-mcp-servers), um zu erfahren, wie der Scope-Name erstellt wird.

284 

283Dieses Beispiel protokolliert alle Memory-Server-Operationen und validiert Schreibvorgänge von jedem MCP-Server:285Dieses Beispiel protokolliert alle Memory-Server-Operationen und validiert Schreibvorgänge von jedem MCP-Server:

284 286 

285```json theme={null}287```json theme={null}


456Zusätzlich zu den [gemeinsamen Feldern](#common-fields) akzeptieren MCP-Tool-Hooks diese Felder:458Zusätzlich zu den [gemeinsamen Feldern](#common-fields) akzeptieren MCP-Tool-Hooks diese Felder:

457 459 

458| Feld | Erforderlich | Beschreibung |460| Feld | Erforderlich | Beschreibung |

459| :------- | :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |461| :------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

460| `server` | ja | Name eines konfigurierten MCP-Servers. Der Server muss bereits verbunden sein; der Hook löst niemals einen OAuth- oder Verbindungsfluss aus |462| `server` | ja | Name eines konfigurierten MCP-Servers. Für einen [Plugin-gebündelten Server](/de/mcp#plugin-provided-mcp-servers) ist dies der Scope-Name `plugin:<plugin-name>:<server-name>`, wie `plugin:my-plugin:db`, nicht der bloße Server-Schlüssel. Der Server muss bereits verbunden sein; der Hook löst niemals einen OAuth- oder Verbindungsfluss aus |

461| `tool` | ja | Name des Tools, das auf diesem Server aufgerufen werden soll |463| `tool` | ja | Name des Tools, das auf diesem Server aufgerufen werden soll |

462| `input` | nein | Argumente, die an das Tool übergeben werden. String-Werte unterstützen `${path}`-Substitution aus der [JSON-Eingabe](#hook-input-and-output) des Hooks, wie `"${tool_input.file_path}"` |464| `input` | nein | Argumente, die an das Tool übergeben werden. String-Werte unterstützen `${path}`-Substitution aus der [JSON-Eingabe](#hook-input-and-output) des Hooks, wie `"${tool_input.file_path}"` |

463 465 


638| :---------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |640| :---------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

639| `session_id` | Aktuelle Sitzungs-ID |641| `session_id` | Aktuelle Sitzungs-ID |

640| `prompt_id` | UUID, die die aktuell verarbeitete Benutzereingabeaufforderung identifiziert. Entspricht dem [`prompt.id`-Attribut bei OpenTelemetry-Ereignissen](/de/monitoring-usage#event-correlation-attributes), sodass Sie Hook-Ausgabe mit Telemetrie für eine einzelne Eingabeaufforderung korrelieren können. Nicht vorhanden, bis zur ersten Benutzereingabe. {/* min-version: 2.1.196 */}Erfordert Claude Code v2.1.196 oder später |642| `prompt_id` | UUID, die die aktuell verarbeitete Benutzereingabeaufforderung identifiziert. Entspricht dem [`prompt.id`-Attribut bei OpenTelemetry-Ereignissen](/de/monitoring-usage#event-correlation-attributes), sodass Sie Hook-Ausgabe mit Telemetrie für eine einzelne Eingabeaufforderung korrelieren können. Nicht vorhanden, bis zur ersten Benutzereingabe. {/* min-version: 2.1.196 */}Erfordert Claude Code v2.1.196 oder später |

641| `transcript_path` | Pfad zur Gesprächs-JSON |643| `transcript_path` | Pfad zur Gesprächs-JSON. Die Transkriptdatei wird asynchron geschrieben und kann der In-Memory-Konversation hinterherhinken, sodass sie möglicherweise noch nicht die neuesten Nachrichten des aktuellen Zugs enthält, wenn ein Hook ausgelöst wird. Hooks, die den endgültigen Assistententext des aktuellen Zugs benötigen, sollten `last_assistant_message` auf [Stop](#stop) und [SubagentStop](#subagentstop) verwenden, anstatt das Transkript zu lesen |

642| `cwd` | Aktuelles Arbeitsverzeichnis, wenn der Hook aufgerufen wird |644| `cwd` | Aktuelles Arbeitsverzeichnis, wenn der Hook aufgerufen wird |

643| `permission_mode` | Aktueller [Berechtigungsmodus](/de/permissions#permission-modes): `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` oder `"bypassPermissions"`. Nicht alle Ereignisse erhalten dieses Feld: siehe jedes Ereignis-JSON-Beispiel unten, um zu prüfen |645| `permission_mode` | Aktueller [Berechtigungsmodus](/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 Ereignisse erhalten dieses Feld. Überprüfen Sie das JSON-Beispiel in jedem Abschnitt [Hook-Ereignis](#hook-events) |

644| `effort` | Objekt mit einem `level`-Feld, das die aktive [Anstrengungsstufe](/de/model-config#adjust-effort-level) für den Zug enthält: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Wenn die angeforderte Modell-Anstrengung das überschreitet, was das aktuelle Modell unterstützt, ist dies die herabgestufte Stufe, die das Modell tatsächlich verwendet hat. Ultracode ist keine separate Stufe und wird als `"xhigh"` gemeldet. Das Objekt entspricht dem [Statuszeilen](/de/statusline#available-data)-Feld `effort`. Vorhanden für Ereignisse, die innerhalb eines Tool-Use-Kontexts ausgelöst werden, wie `PreToolUse`, `PostToolUse`, `Stop` und `SubagentStop`, wenn das aktuelle Modell den Anstrengungsparameter unterstützt. Die Stufe ist auch für Hook-Befehle und das Bash-Tool als die Umgebungsvariable `$CLAUDE_EFFORT` verfügbar. |646| `effort` | Objekt mit einem `level`-Feld, das die aktive [Anstrengungsstufe](/de/model-config#adjust-effort-level) für den Zug enthält: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Wenn die angeforderte Modell-Anstrengung das überschreitet, was das aktuelle Modell unterstützt, ist dies die herabgestufte Stufe, die das Modell tatsächlich verwendet hat. Ultracode ist keine separate Stufe und wird als `"xhigh"` gemeldet. Das Objekt entspricht dem [Statuszeilen](/de/statusline#available-data)-Feld `effort`. Vorhanden für Ereignisse, die innerhalb eines Tool-Use-Kontexts ausgelöst werden, wie `PreToolUse`, `PostToolUse`, `Stop` und `SubagentStop`, wenn das aktuelle Modell den Anstrengungsparameter unterstützt. Die Stufe ist auch für Hook-Befehle und das Bash-Tool als die Umgebungsvariable `$CLAUDE_EFFORT` verfügbar. |

645| `hook_event_name` | Name des ausgelösten Ereignisses |647| `hook_event_name` | Name des ausgelösten Ereignisses |

646 648 


1757Das Ausgabefeld `updatedPermissions` und das [`permission_suggestions`-Eingabefeld](#permissionrequest-input) verwenden beide das gleiche Array von Einträgen. Jeder Eintrag hat einen `type`, der seine anderen Felder bestimmt, und ein `destination`, das steuert, wo die Änderung geschrieben wird.1759Das Ausgabefeld `updatedPermissions` und das [`permission_suggestions`-Eingabefeld](#permissionrequest-input) verwenden beide das gleiche Array von Einträgen. Jeder Eintrag hat einen `type`, der seine anderen Felder bestimmt, und ein `destination`, das steuert, wo die Änderung geschrieben wird.

1758 1760 

1759| `type` | Felder | Effekt |1761| `type` | Felder | Effekt |

1760| :------------------ | :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1762| :------------------ | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1761| `addRules` | `rules`, `behavior`, `destination` | Fügt Berechtigungsregeln hinzu. `rules` ist ein Array von `{toolName, ruleContent?}` Objekten. Lassen Sie `ruleContent` weg, um das ganze Tool zu treffen. `behavior` ist `"allow"`, `"deny"` oder `"ask"` |1763| `addRules` | `rules`, `behavior`, `destination` | Fügt Berechtigungsregeln hinzu. `rules` ist ein Array von `{toolName, ruleContent?}` Objekten. Lassen Sie `ruleContent` weg, um das ganze Tool zu treffen. `behavior` ist `"allow"`, `"deny"` oder `"ask"` |

1762| `replaceRules` | `rules`, `behavior`, `destination` | Ersetzt alle Regeln des gegebenen `behavior` am `destination` mit den bereitgestellten `rules` |1764| `replaceRules` | `rules`, `behavior`, `destination` | Ersetzt alle Regeln des gegebenen `behavior` am `destination` mit den bereitgestellten `rules` |

1763| `removeRules` | `rules`, `behavior`, `destination` | Entfernt passende Regeln des gegebenen `behavior` |1765| `removeRules` | `rules`, `behavior`, `destination` | Entfernt passende Regeln des gegebenen `behavior` |

1764| `setMode` | `mode`, `destination` | Ändert den Berechtigungsmodus. Gültige Modi sind `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions` und `plan` |1766| `setMode` | `mode`, `destination` | Ändert den Berechtigungsmodus. Gültige Modi sind `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` und {/* min-version: 2.1.200 */}`manual` als Alias für `default`. Der Alias `manual` erfordert Claude Code v2.1.200 oder später |

1765| `addDirectories` | `directories`, `destination` | Fügt Arbeitsverzeichnisse hinzu. `directories` ist ein Array von Pfad-Zeichenketten |1767| `addDirectories` | `directories`, `destination` | Fügt Arbeitsverzeichnisse hinzu. `directories` ist ein Array von Pfad-Zeichenketten |

1766| `removeDirectories` | `directories`, `destination` | Entfernt Arbeitsverzeichnisse |1768| `removeDirectories` | `directories`, `destination` | Entfernt Arbeitsverzeichnisse |

1767 1769 


2651 2653 

2652Da der Hook das Standard-Verhalten vollständig ersetzt, wird [`.worktreeinclude`](/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.2654Da der Hook das Standard-Verhalten vollständig ersetzt, wird [`.worktreeinclude`](/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.

2653 2655 

2654Der Hook muss den absoluten Pfad zum erstellten Worktree-Verzeichnis zurückgeben. Claude Code verwendet diesen Pfad als Arbeitsverzeichnis für die isolierte Sitzung. Command-Hooks geben ihn auf stdout aus; HTTP-Hooks geben ihn über `hookSpecificOutput.worktreePath` zurück.2656Der Hook muss den absoluten 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.

2655 2657 

2656Dieses Beispiel erstellt eine SVN-Arbeitskopie und gibt den Pfad aus, damit Claude Code ihn verwenden kann. Ersetzen Sie die Repository-URL durch Ihre eigene:2658Dieses Beispiel erstellt eine SVN-Arbeitskopie und gibt den Pfad aus, damit Claude Code ihn verwenden kann. Ersetzen Sie die Repository-URL durch Ihre eigene:

2657 2659 


2696 2698 

2697WorktreeCreate-Hooks verwenden nicht das Standard-Allow/Block-Entscheidungsmodell. Stattdessen bestimmt der Erfolg oder Misserfolg des Hooks das Ergebnis. Der Hook muss den absoluten Pfad zum erstellten Worktree-Verzeichnis zurückgeben:2699WorktreeCreate-Hooks verwenden nicht das Standard-Allow/Block-Entscheidungsmodell. Stattdessen bestimmt der Erfolg oder Misserfolg des Hooks das Ergebnis. Der Hook muss den absoluten Pfad zum erstellten Worktree-Verzeichnis zurückgeben:

2698 2700 

2699* **Command-Hooks** (`type: "command"`): geben den Pfad auf stdout aus.2701* **Command-Hooks** (`type: "command"`): geben den Pfad auf stdout aus. Claude Code entfernt ANSI-Escape-Codes, bevor diese Zeile gelesen wird, daher werden Shell-Startup-Banner, die vor Ihrem `echo` gedruckt werden, ignoriert. Leiten Sie jede andere Hook-Ausgabe zu stderr um.

2700* **HTTP-Hooks** (`type: "http"`): geben `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` im Response-Body zurück.2702* **HTTP-Hooks** (`type: "http"`): geben `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` im Response-Body zurück.

2701 2703 

2702Wenn der Hook fehlschlägt oder keinen Pfad erzeugt, schlägt die Worktree-Erstellung mit einem Fehler fehl.2704Wenn der Hook fehlschlägt oder keinen Pfad erzeugt, schlägt die Worktree-Erstellung mit einem Fehler fehl.

2703 2705 

2706Claude Code löst einen relativen Pfad gegen das Verzeichnis auf, in dem der Hook ausgeführt wurde. 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. Vor v2.1.205 stürzte ein relativer Pfad oder ein Pfad, der nicht auf der Festplatte existierte, die Sitzung beim Start ab, und mit `-p` stagnierte es etwa 30 Sekunden, bevor es mit Code 0 beendet wurde.

2707 

2704<h3 id="worktreeremove">2708<h3 id="worktreeremove">

2705 WorktreeRemove2709 WorktreeRemove

2706</h3>2710</h3>


2709 2713 

2710Für Git-basierte Worktrees handhabt Claude Code die Bereinigung automatisch mit `git worktree remove`. Wenn Sie einen WorktreeCreate-Hook für ein nicht-Git-Versionskontrollsystem konfiguriert haben, koppeln Sie ihn mit einem WorktreeRemove-Hook, um die Bereinigung zu handhaben. Ohne einen wird das Worktree-Verzeichnis auf der Festplatte belassen.2714Für Git-basierte Worktrees handhabt Claude Code die Bereinigung automatisch mit `git worktree remove`. Wenn Sie einen WorktreeCreate-Hook für ein nicht-Git-Versionskontrollsystem konfiguriert haben, koppeln Sie ihn mit einem WorktreeRemove-Hook, um die Bereinigung zu handhaben. Ohne einen wird das Worktree-Verzeichnis auf der Festplatte belassen.

2711 2715 

2712Claude Code übergibt den Pfad, den WorktreeCreate auf stdout ausgegeben hat, als `worktree_path` in der Hook-Eingabe. Dieses Beispiel liest diesen Pfad und entfernt das Verzeichnis:2716Claude 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:

2713 2717 

2714```json theme={null}2718```json theme={null}

2715{2719{


3222 3226 

3223Nachdem der Hintergrund-Prozess beendet ist, wenn der Hook eine JSON-Response mit einem `additionalContext`-Feld erzeugt hat, wird dieser Inhalt Claude beim nächsten Gesprächsturn als Kontext geliefert. Ein `systemMessage`-Feld wird Ihnen angezeigt, nicht Claude.3227Nachdem der Hintergrund-Prozess beendet ist, wenn der Hook eine JSON-Response mit einem `additionalContext`-Feld erzeugt hat, wird dieser Inhalt Claude beim nächsten Gesprächsturn als Kontext geliefert. Ein `systemMessage`-Feld wird Ihnen angezeigt, nicht Claude.

3224 3228 

3229Claude Code validiert diese JSON-Response gegen das gleiche [Ausgabeschema](#json-output) wie synchrone Hooks und verwirft jedes Feld, dessen Wert den falschen Typ hat, wie z. B. eine `systemMessage`, die keine Zeichenkette ist, anstatt es zu liefern. Führen Sie mit `--debug` aus, um eine Warnung zu sehen, die jedes verworfene Feld benennt. Vor v2.1.202 konnte fehlerhafte JSON-Ausgabe von einem asynchronen Hook die Sitzung zum Absturz bringen, und der Absturz trat jedes Mal auf, wenn die Sitzung fortgesetzt wurde.

3230 

3225Benachrichtigungen über den Abschluss asynchroner Hooks werden standardmäßig unterdrückt. Um sie zu sehen, aktivieren Sie den ausführlichen Modus mit `Ctrl+O` oder starten Sie Claude Code mit `--verbose`.3231Benachrichtigungen über den Abschluss asynchroner Hooks werden standardmäßig unterdrückt. Um sie zu sehen, aktivieren Sie den ausführlichen Modus mit `Ctrl+O` oder starten Sie Claude Code mit `--verbose`.

3226 3232 

3227<h3 id="run-tests-after-file-changes">3233<h3 id="run-tests-after-file-changes">

hooks-guide.md +1 −1

Details

695 </Tab>695 </Tab>

696 696 

697 <Tab title="MCP-Tools abgleichen">697 <Tab title="MCP-Tools abgleichen">

698 MCP-Tools verwenden eine andere Namenskonvention als integrierte Tools: `mcp__<server>__<tool>`, wobei `<server>` der MCP-Servername und `<tool>` das Tool ist, das er bereitstellt. Beispielsweise `mcp__github__search_repositories` oder `mcp__filesystem__read_file`. Verwenden Sie einen Regex-Matcher, um alle Tools von einem bestimmten Server zu erfassen, oder gleichen Sie Server übergreifend mit einem Muster wie `mcp__.*__write.*` ab. Siehe [MCP-Tools abgleichen](/de/hooks#match-mcp-tools) in der Referenz für die vollständige Liste der Beispiele.698 MCP-Tools verwenden eine andere Namenskonvention als integrierte Tools: `mcp__<server>__<tool>`, wobei `<server>` der MCP-Servername und `<tool>` das Tool ist, das er bereitstellt. Beispielsweise `mcp__github__search_repositories` oder `mcp__filesystem__read_file`. Tools von einem [Plugin-gebündelten Server](/de/mcp#plugin-provided-mcp-servers) verwenden stattdessen ein Scoped-Server-Segment, z. B. `mcp__plugin_my-plugin_db__query`. Verwenden Sie einen Regex-Matcher, um alle Tools von einem bestimmten Server zu erfassen, oder gleichen Sie Server übergreifend mit einem Muster wie `mcp__.*__write.*` ab. Siehe [MCP-Tools abgleichen](/de/hooks#match-mcp-tools) in der Referenz für die vollständige Liste der Beispiele.

699 699 

700 Der folgende Befehl extrahiert den Tool-Namen aus der Hook-JSON-Eingabe mit `jq` und schreibt ihn auf stderr. Das Schreiben auf stderr hält stdout sauber für JSON-Ausgabe und sendet die Meldung in das [Debug-Protokoll](/de/hooks#debug-hooks):700 Der folgende Befehl extrahiert den Tool-Namen aus der Hook-JSON-Eingabe mit `jq` und schreibt ihn auf stderr. Das Schreiben auf stderr hält stdout sauber für JSON-Ausgabe und sendet die Meldung in das [Debug-Protokoll](/de/hooks#debug-hooks):

701 701 

Details

186 186 

187Drücken Sie `Shift+Tab`, um durch die Berechtigungsmodi zu wechseln:187Drücken Sie `Shift+Tab`, um durch die Berechtigungsmodi zu wechseln:

188 188 

189* **Standard**: Claude fragt vor Dateibearbeitungen und Shell-Befehlen189* **Manual**: Claude fragt vor Dateibearbeitungen und Shell-Befehlen

190* **Auto-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 Befehlen190* **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

191* **Plan Mode**: Claude erkundet und schlägt einen Plan vor, ohne Ihre Quelldateien zu bearbeiten; Berechtigungsaufforderungen gelten weiterhin wie im Standardmodus191* **Plan**: Claude erkundet und schlägt einen Plan vor, ohne Ihre Quelldateien zu bearbeiten; Berechtigungsaufforderungen gelten weiterhin wie im Manual-Modus

192* **Auto Mode**: Claude bewertet alle Aktionen mit Hintergrund-Sicherheitsprüfungen. Derzeit eine Forschungsvorschau192* **Auto**: Claude bewertet alle Aktionen mit Hintergrund-Sicherheitsprüfungen. Derzeit eine Forschungsvorschau

193 193 

194Sie können auch spezifische Befehle in `.claude/settings.json` zulassen, damit Claude nicht jedes Mal fragt. Dies ist nützlich für vertrauenswürdige Befehle wie `npm test` oder `git status`. Einstellungen können von organisationsweiten Richtlinien bis zu persönlichen Vorlieben reichen. Siehe [Berechtigungen](/de/permissions) für Details.194Sie können auch spezifische Befehle in `.claude/settings.json` zulassen, damit Claude nicht jedes Mal fragt. Dies ist nützlich für vertrauenswürdige Befehle wie `npm test` oder `git status`. Einstellungen können von organisationsweiten Richtlinien bis zu persönlichen Vorlieben reichen. Siehe [Berechtigungen](/de/permissions) für Details.

195 195 


210Integrierte Befehle führen Sie auch durch die Einrichtung:210Integrierte Befehle führen Sie auch durch die Einrichtung:

211 211 

212* `/init` führt Sie durch die Erstellung einer CLAUDE.md für Ihr Projekt212* `/init` führt Sie durch die Erstellung einer CLAUDE.md für Ihr Projekt

213* `/doctor` diagnostiziert häufige Probleme mit Ihrer Installation213* `/doctor` führt eine Einrichtungsüberprüfung durch, die Installations- und Konfigurationsprobleme diagnostiziert und diese beheben kann

214 214 

215<h3 id="it’s-a-conversation">215<h3 id="it’s-a-conversation">

216 Es ist eine Konversation216 Es ist eine Konversation

Details

40| `Ctrl+T` | Task-Liste umschalten | Zeigen oder verbergen Sie [Claudes Task-Liste](#task-list) im Statusbereich. Dies ist nicht die Hintergrund-Task-Ansicht; verwenden Sie [`/tasks`](/de/commands), um laufende Shells und Subagenten anzuzeigen |40| `Ctrl+T` | Task-Liste umschalten | Zeigen oder verbergen Sie [Claudes Task-Liste](#task-list) im Statusbereich. Dies ist nicht die Hintergrund-Task-Ansicht; verwenden Sie [`/tasks`](/de/commands), um laufende Shells und Subagenten anzuzeigen |

41| `Left/Right arrows` | Durch Dialog-Registerkarten navigieren | Navigieren Sie zwischen Registerkarten in Berechtigungsdialogen und Menüs |41| `Left/Right arrows` | Durch Dialog-Registerkarten navigieren | Navigieren Sie zwischen Registerkarten in Berechtigungsdialogen und Menüs |

42| `Up/Down arrows` oder `Ctrl+P`/`Ctrl+N` | Cursor bewegen oder Befehlsverlauf navigieren | Wenn die Eingabe mehr als eine visuelle Zeile umfasst, ob umgebrochen oder mehrzeilig, bewegt sich der Cursor zunächst innerhalb der Eingabeaufforderung. Sobald sich der Cursor bereits am oberen oder unteren Rand befindet, navigiert das erneute Drücken durch den Befehlsverlauf. {/* min-version: 2.1.169 */}Ab v2.1.169 verhält sich umgebrochene einzeilige Eingabe genauso wie mehrzeilige Eingabe |42| `Up/Down arrows` oder `Ctrl+P`/`Ctrl+N` | Cursor bewegen oder Befehlsverlauf navigieren | Wenn die Eingabe mehr als eine visuelle Zeile umfasst, ob umgebrochen oder mehrzeilig, bewegt sich der Cursor zunächst innerhalb der Eingabeaufforderung. Sobald sich der Cursor bereits am oberen oder unteren Rand befindet, navigiert das erneute Drücken durch den Befehlsverlauf. {/* min-version: 2.1.169 */}Ab v2.1.169 verhält sich umgebrochene einzeilige Eingabe genauso wie mehrzeilige Eingabe |

43| `Esc` | Claude unterbrechen | Stoppen Sie die aktuelle Antwort oder den Tool-Aufruf in der Mitte des Zuges, um umzuleiten. Claude behält die bisherige Arbeit bei |43| `Esc` | Claude unterbrechen oder einen Dialog schließen | Stoppen Sie die aktuelle Antwort oder den Tool-Aufruf in der Mitte des Zuges, um umzuleiten. Claude behält die bisherige Arbeit bei. Wenn ein Dialog wie eine Berechtigungsaufforderung offen ist, schließt `Esc` den Dialog, anstatt Claude zu unterbrechen. {/* min-version: 2.1.202 */}Vor v2.1.202 unterbrach `Esc` bei einigen Dialogen Claude und ließ den Dialog offen |

44| `Esc` + `Esc` | Eingabeentwurf löschen oder zurückspulen | Wenn die Eingabeaufforderung Text enthält, löscht doppeltes `Esc` sie und speichert den Entwurf im Verlauf, sodass `Up` ihn abruft. Wenn die Eingabe leer ist, öffnet doppeltes `Esc` das [Zurückspul-Menü](/de/checkpointing), um Code und Gespräch von einem vorherigen Punkt wiederherzustellen oder zusammenzufassen |44| `Esc` + `Esc` | Eingabeentwurf löschen oder zurückspulen | Wenn die Eingabeaufforderung Text enthält, löscht doppeltes `Esc` sie und speichert den Entwurf im Verlauf, sodass `Up` ihn abruft. Wenn die Eingabe leer ist, öffnet doppeltes `Esc` das [Zurückspul-Menü](/de/checkpointing), um Code und Gespräch von einem vorherigen Punkt wiederherzustellen oder zusammenzufassen |

45| `Shift+Tab` oder `Alt+M` (einige Konfigurationen) | Berechtigungsmodi umschalten | Wechseln Sie zwischen `default`, `acceptEdits`, `plan` und allen Modi, die Sie aktiviert haben, z. B. `auto` oder `bypassPermissions`. Siehe [Berechtigungsmodi](/de/permission-modes). |45| `Shift+Tab` oder `Alt+M` (einige Konfigurationen) | Berechtigungsmodi umschalten | Wechseln Sie zwischen `default` (mit „Manual" im Modus-Indikator gekennzeichnet), `acceptEdits`, `plan` und allen Modi, die Sie aktiviert haben, z. B. `auto` oder `bypassPermissions`. Siehe [Berechtigungsmodi](/de/permission-modes). |

46| `Option+P` (macOS) oder `Alt+P` (Windows/Linux) | Modell wechseln | Wechseln Sie Modelle, ohne Ihren Prompt zu löschen |46| `Option+P` (macOS) oder `Alt+P` (Windows/Linux) | Modell wechseln | Wechseln Sie Modelle, ohne Ihren Prompt zu löschen |

47| `Option+T` (macOS) oder `Alt+T` (Windows/Linux) | Extended Thinking umschalten | Aktivieren oder deaktivieren Sie den Extended Thinking-Modus. Hat keine Auswirkung auf Fable 5, das immer Extended Thinking verwendet. {/* min-version: 2.1.132 */}Ab v2.1.132 funktioniert dieses Kürzel auf macOS ohne Konfiguration von Option als Meta |47| `Option+T` (macOS) oder `Alt+T` (Windows/Linux) | Extended Thinking umschalten | Aktivieren oder deaktivieren Sie den Extended Thinking-Modus. Hat keine Auswirkung auf Fable 5, das immer Extended Thinking verwendet. {/* min-version: 2.1.132 */}Ab v2.1.132 funktioniert dieses Kürzel auf macOS ohne Konfiguration von Option als Meta |

48| `Option+O` (macOS) oder `Alt+O` (Windows/Linux) | Schnellmodus umschalten | Aktivieren oder deaktivieren Sie den [Schnellmodus](/de/fast-mode) |48| `Option+O` (macOS) oder `Alt+O` (Windows/Linux) | Schnellmodus umschalten | Aktivieren oder deaktivieren Sie den [Schnellmodus](/de/fast-mode) |


270 270 

271Die Suche lädt die 100 neuesten eindeutigen Eingabeaufforderungen im ausgewählten Bereich, wobei Duplikate zum neuesten Vorkommen zusammengefasst werden. Übereinstimmende Eingabeaufforderungen werden mit dem hervorgehobenen Suchbegriff angezeigt, sodass Sie vorherige Eingaben finden und wiederverwenden können.271Die Suche lädt die 100 neuesten eindeutigen Eingabeaufforderungen im ausgewählten Bereich, wobei Duplikate zum neuesten Vorkommen zusammengefasst werden. Übereinstimmende Eingabeaufforderungen werden mit dem hervorgehobenen Suchbegriff angezeigt, sodass Sie vorherige Eingaben finden und wiederverwenden können.

272 272 

273Das Akzeptieren einer Übereinstimmung oder das Abbrechen der Suche wird sofort wirksam, auch während Claude Code den Verlauf noch lädt. Vor v2.1.202 konnte das Akzeptieren oder Abbrechen während dieses Ladevorgangs einen internen Fehler melden.

274 

273<h2 id="background-bash-commands">275<h2 id="background-bash-commands">

274 Bash-Befehle im Hintergrund276 Bash-Befehle im Hintergrund

275</h2>277</h2>

keybindings.md +12 −13

Details

71| `Select` | Generische Select/List-Komponenten |71| `Select` | Generische Select/List-Komponenten |

72| `Plugin` | Plugin-Dialog (durchsuchen, entdecken, verwalten) |72| `Plugin` | Plugin-Dialog (durchsuchen, entdecken, verwalten) |

73| `Scroll` | Konversations-Scrolling und Textauswahl im Vollbildmodus |73| `Scroll` | Konversations-Scrolling und Textauswahl im Vollbildmodus |

74| `Doctor` | `/doctor` Diagnose-Bildschirm |74 

75{/* max-version: 2.1.204 */}Vor v2.1.205 existierten ein `Doctor`-Kontext und eine `doctor:fix`-Aktion für den `/doctor`-Diagnose-Bildschirm.

75 76 

76<h2 id="available-actions">77<h2 id="available-actions">

77 Verfügbare Aktionen78 Verfügbare Aktionen


356| `select:accept` | Enter, Leertaste | Ändern Sie die ausgewählte Einstellung oder öffnen Sie das Untermenü |357| `select:accept` | Enter, Leertaste | Ändern Sie die ausgewählte Einstellung oder öffnen Sie das Untermenü |

357| `confirm:no` | Escape | Schließen Sie das Panel. Änderungen sind bereits gespeichert |358| `confirm:no` | Escape | Schließen Sie das Panel. Änderungen sind bereits gespeichert |

358 359 

359<h3 id="doctor-actions">

360 Doctor-Aktionen

361</h3>

362 

363Aktionen verfügbar im `Doctor`-Kontext:

364 

365| Aktion | Standard | Beschreibung |

366| :----------- | :------- | :------------------------------------------------------------------------------------------------------------------------ |

367| `doctor:fix` | F | Senden Sie den Diagnosebericht an Claude, um die gemeldeten Probleme zu beheben. Nur aktiv, wenn Probleme gefunden werden |

368 

369<h3 id="voice-actions">360<h3 id="voice-actions">

370 Sprach-Aktionen361 Sprach-Aktionen

371</h3>362</h3>


477}468}

478```469```

479 470 

480Dies funktioniert auch für Akkord-Bindings. Das Aufheben aller Akkorde, die ein Präfix teilen, gibt dieses Präfix für die Verwendung als Single-Key-Binding frei:471Dies funktioniert auch für Akkord-Bindings. Das Aufheben aller Akkorde, die ein Präfix teilen, gibt dieses Präfix für die Verwendung als Single-Key-Binding frei. Ein Akkord in einem beliebigen aktiven Kontext behält sein Präfix reserviert, daher müssen Sie jeden Akkord in dem Kontext aufheben, der ihn definiert.

472 

473Die Standard-`Ctrl+X`-Familie umfasst zwei Kontexte: `ctrl+x ctrl+k` und `ctrl+x ctrl+e` in `Chat` sowie `ctrl+x ctrl+b` in `Task`. Um `ctrl+x` selbst als Single-Key-Binding zurückzugewinnen, heben Sie alle auf:

481 474 

482```json theme={null}475```json theme={null}

483{476{

484 "bindings": [477 "bindings": [

478 {

479 "context": "Task",

480 "bindings": {

481 "ctrl+x ctrl+b": null

482 }

483 },

485 {484 {

486 "context": "Chat",485 "context": "Chat",

487 "bindings": {486 "bindings": {


546* Terminal-Multiplexer-Konflikte545* Terminal-Multiplexer-Konflikte

547* Doppelte Bindings im selben Kontext546* Doppelte Bindings im selben Kontext

548 547 

549Führen Sie `/doctor` aus, um Keybinding-Warnungen anzuzeigen.548Claude Code meldet Warnungen, wenn die Datei geladen wird, und schreibt jede einzelne in das Debug-Protokoll. Starten Sie Claude Code mit [`--debug`](/de/cli-reference#cli-flags), um die Details zu sehen.

Details

209 Desktop-App209 Desktop-App

210</h3>210</h3>

211 211 

212Die Desktop-App liest Gateway-Routing aus einer [von Administrator verteilten Konfiguration](https://claude.com/docs/cowork/3p/gateway), nicht aus `ANTHROPIC_BASE_URL` oder `settings.json`. Wenn Ihre Organisation sie verteilt hat, leitet die Desktop-App ohne Einrichtung auf Ihrer Seite durch das Gateway; wenn nicht, verwenden Sie die Terminal-CLI oder VS Code-Erweiterung für Gateway-Sitzungen. Administratoren verteilen die Konfiguration wie in der [Organisations-Rollout](/de/llm-gateway-rollout#distribute-through-managed-settings) beschrieben.212Die Desktop-App liest Gateway-Routing aus einer [von Administrator verteilten Konfiguration](https://claude.com/docs/third-party/claude-desktop/gateway), nicht aus `ANTHROPIC_BASE_URL` oder `settings.json`. Wenn Ihre Organisation sie verteilt hat, leitet die Desktop-App ohne Einrichtung auf Ihrer Seite durch das Gateway; wenn nicht, verwenden Sie die Terminal-CLI oder VS Code-Erweiterung für Gateway-Sitzungen. Administratoren verteilen die Konfiguration wie in der [Organisations-Rollout](/de/llm-gateway-rollout#distribute-through-managed-settings) beschrieben.

213 213 

214Wenn die Desktop-App `Gateway was unreachable` anzeigt, konnte die App die konfigurierte Basis-URL beim Start nicht erreichen; überprüfen Sie die URL und den Netzwerkpfad mit dem [curl-Test oben](#verify-the-connection).214Wenn die Desktop-App `Gateway was unreachable` anzeigt, konnte die App die konfigurierte Basis-URL beim Start nicht erreichen; überprüfen Sie die URL und den Netzwerkpfad mit dem [curl-Test oben](#verify-the-connection).

215 215 


287 287 

288[Remote Control](/de/remote-control) und [Sprachdiktat](/de/voice-dictation) verlassen sich beide auf eine claude.ai-Identität: Remote Control, um eine Live-Sitzung mit Ihrem Konto zu koppeln, und Sprachdiktat, um den claude.ai-Transkriptions-Endpunkt zu erreichen. Sie sind nicht verfügbar, während `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder ein `apiKeyHelper` aktiv ist. {/* min-version: 2.1.196 */}Ab v2.1.196 ist Remote Control auch deaktiviert, während `ANTHROPIC_BASE_URL` auf einen Nicht-Anthropic-Host verweist, daher ist die Anmeldung mit claude.ai allein nicht ausreichend.288[Remote Control](/de/remote-control) und [Sprachdiktat](/de/voice-dictation) verlassen sich beide auf eine claude.ai-Identität: Remote Control, um eine Live-Sitzung mit Ihrem Konto zu koppeln, und Sprachdiktat, um den claude.ai-Transkriptions-Endpunkt zu erreichen. Sie sind nicht verfügbar, während `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder ein `apiKeyHelper` aktiv ist. {/* min-version: 2.1.196 */}Ab v2.1.196 ist Remote Control auch deaktiviert, während `ANTHROPIC_BASE_URL` auf einen Nicht-Anthropic-Host verweist, daher ist die Anmeldung mit claude.ai allein nicht ausreichend.

289 289 

290Um eines dieser Features wiederherzustellen, melden Sie sich mit claude.ai an und heben Sie die Festlegung der Gateway-Variablen auf, die es überprüft. `/doctor` benennt die Anmeldedaten-Variable, die aufgehoben werden soll.290Um eines dieser Features wiederherzustellen, melden Sie sich mit claude.ai an und heben Sie die Festlegung der Gateway-Variablen auf, die es überprüft. Der Remote Control-Abschnitt von `claude doctor` benennt die Anmeldedaten-Variable, die aufgehoben werden soll.

291 291 

292* Sprachdiktat: Heben Sie die Festlegung der Gateway-Anmeldedaten auf292* Sprachdiktat: Heben Sie die Festlegung der Gateway-Anmeldedaten auf

293* Remote Control: Heben Sie die Festlegung der Gateway-Anmeldedaten und `ANTHROPIC_BASE_URL` auf293* Remote Control: Heben Sie die Festlegung der Gateway-Anmeldedaten und `ANTHROPIC_BASE_URL` auf


393 Leiten Sie zu einem Cloud-Anbieter über ein Gateway weiter393 Leiten Sie zu einem Cloud-Anbieter über ein Gateway weiter

394</h3>394</h3>

395 395 

396Diese Konfigurationen richten Claude Code auf ein Gateway über eine anbieter-spezifische Basis-URL-Variable anstelle von `ANTHROPIC_BASE_URL` aus. Bedrock- und Agent Platform-Gateways akzeptieren die nativen Anforderungsformate dieser Anbieter; Foundry- und Claude Platform on AWS-Gateways akzeptieren das Anthropic Messages-Format und unterscheiden sich nur in der Basis-URL-Variable, die sie erreicht.396Diese Konfigurationen richten Claude Code auf ein Gateway über eine anbieter-spezifische Basis-URL-Variable anstelle von `ANTHROPIC_BASE_URL` aus. Amazon Bedrock und Google Cloud's Agent Platform-Gateways akzeptieren die nativen Anforderungsformate dieser Anbieter; Microsoft Foundry und Claude Platform on AWS-Gateways akzeptieren das Anthropic Messages-Format und unterscheiden sich nur in der Basis-URL-Variable, die sie erreicht.

397 397 

398Verwenden Sie eine nur, wenn Ihr Gateway-Team speziell Bedrock, Agent Platform, Foundry oder die Claude Platform on AWS benannt hat. Wenn die [Überprüfungsanfrage](#verify-the-connection) oben JSON zurückgegeben hat, können Sie diesen Abschnitt überspringen.398Verwenden Sie eine nur, wenn Ihr Gateway-Team speziell Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder die Claude Platform on AWS benannt hat. Wenn die [Überprüfungsanfrage](#verify-the-connection) oben JSON zurückgegeben hat, können Sie diesen Abschnitt überspringen.

399 399 

400Legen Sie den Block für den Anbieter fest, den Ihr Gateway-Team benannt hat. Die Skip-Auth-Variablen teilen Claude Code mit, dass Anfragen nicht mit Anbieter-Anmeldedaten signiert werden sollen, da das Gateway diese hält. Wenn das Gateway sein eigenes Token benötigt, fügen Sie `ANTHROPIC_AUTH_TOKEN` nach dem Block hinzu, außer für Foundry, das `ANTHROPIC_FOUNDRY_API_KEY` wie gezeigt verwendet.400Legen Sie den Block für den Anbieter fest, den Ihr Gateway-Team benannt hat. Die Skip-Auth-Variablen teilen Claude Code mit, dass Anfragen nicht mit Anbieter-Anmeldedaten signiert werden sollen, da das Gateway diese hält. Wenn das Gateway sein eigenes Token benötigt, fügen Sie `ANTHROPIC_AUTH_TOKEN` nach dem Block hinzu, außer für Microsoft Foundry, das `ANTHROPIC_FOUNDRY_API_KEY` wie gezeigt verwendet. {/* min-version: 2.1.203 */}Ein Microsoft Foundry-Gateway, das einen Bearer-Token erwartet, kann stattdessen [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/de/env-vars) verwenden; es hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY`, wenn beide gesetzt sind. `ANTHROPIC_FOUNDRY_AUTH_TOKEN` erfordert Claude Code v2.1.203 oder später.

401 401 

402<h4 id="amazon-bedrock">402<h4 id="amazon-bedrock">

403 Amazon Bedrock403 Amazon Bedrock


451 Microsoft Foundry451 Microsoft Foundry

452</h4>452</h4>

453 453 

454Legen Sie die Anmeldedaten des Gateways in `ANTHROPIC_FOUNDRY_API_KEY` fest; sie werden an das Gateway als `x-api-key`-Header gesendet. `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` gilt hier nicht: Ohne einen API-Schlüssel schlägt der Foundry-Client jede Anfrage fehl, bevor sie die Maschine verlässt.454Legen Sie die Anmeldedaten des Gateways in `ANTHROPIC_FOUNDRY_API_KEY` fest; sie werden an das Gateway als `x-api-key`-Header gesendet. {/* min-version: 2.1.203 */}Ein Gateway, das einen Bearer-Token erwartet, kann stattdessen [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/de/env-vars) verwenden. Claude Code sendet diesen Wert als `Authorization: Bearer`-Header, und er hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY`, wenn beide gesetzt sind. Erfordert Claude Code v2.1.203 oder später.

455 

456Für ein Gateway, das seinen eigenen `Authorization`-Header injiziert, legen Sie `CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` fest und lassen Sie beide Anmeldedaten-Variablen ungesetzt. Claude Code sendet dann Anfragen ohne eine Azure-Anmeldedaten und bewahrt den `Authorization`-Header, den Sie bereitstellen, z. B. durch `ANTHROPIC_CUSTOM_HEADERS`. {/* min-version: 2.1.203 */}Vor v2.1.203 ließ `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` ohne einen API-Schlüssel den Microsoft Foundry-Client unfähig, Anfragen zu senden.

455 457 

456<Tabs>458<Tabs>

457 <Tab title="Bash oder Zsh">459 <Tab title="Bash oder Zsh">

Details

34 API-Formate34 API-Formate

35</h2>35</h2>

36 36 

37Ein Gateway muss mindestens eines der folgenden API-Formate für Claude Code-Clients bereitstellen. Welches Format Claude Code spricht, wird durch die Konfiguration des Clients bestimmt: die Variable in der Spalte „Ausgewählt von" der folgenden Tabelle verweist Claude Code auf Ihr Gateway in diesem Format. Agent Platform ist Googles Claude-Endpunkt in Google Cloud, ehemals Vertex AI; seine Variablennamen behalten die Schreibweise `VERTEX`.37Ein Gateway muss mindestens eines der folgenden API-Formate für Claude Code-Clients bereitstellen. Welches Format Claude Code spricht, wird durch die Konfiguration des Clients bestimmt: die Variable in der Spalte „Ausgewählt von" der folgenden Tabelle verweist Claude Code auf Ihr Gateway in diesem Format. Google Cloud's Agent Platform ist Googles Claude-Endpunkt in Google Cloud, ehemals Vertex AI; seine Variablennamen behalten die Schreibweise `VERTEX`.

38 38 

39| Format | Ausgewählt von | Endpunkte | Unverändert weiterleiten |39| Format | Ausgewählt von | Endpunkte | Unverändert weiterleiten |

40| :------------------------ | :----------------------------------------------------------- | :----------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------ |40| :--------------------------------------- | :----------------------------------------------------------- | :----------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------ |

41| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (optional) | `anthropic-beta` und `anthropic-version` Request-Header |41| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (optional) | `anthropic-beta` und `anthropic-version` Request-Header |

42| Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` mit `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream` | `anthropic_beta` und `anthropic_version` Request-Body-Felder |42| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` mit `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream` | `anthropic_beta` und `anthropic_version` Request-Body-Felder |

43| Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` mit `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (optional) | `anthropic-beta` und `anthropic-version` Request-Header sowie das `anthropic_version` Request-Body-Feld |43| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` mit `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (optional) | `anthropic-beta` und `anthropic-version` Request-Header sowie das `anthropic_version` Request-Body-Feld |

44 44 

45<h3 id="foundry-and-claude-platform-on-aws">45<h3 id="foundry-and-claude-platform-on-aws">

46 Foundry und Claude Platform on AWS46 Foundry und Claude Platform on AWS


52 Optionale Endpunkte und Startup-Traffic52 Optionale Endpunkte und Startup-Traffic

53</h3>53</h3>

54 54 

55Token-Counting-Endpunkte sind die einzigen optionalen: Wenn sie fehlen, schätzt Claude Code die Kontextnutzung lokal. Inferenzanfragen werden an `/v1/messages?beta=true` gesendet, daher sollten Sie auf dem Pfad abgleichen, nicht auf der vollständigen URL. Die Agent Platform-Methode hängt Suffixe an den Publisher-Modellpfad an, wie in `/projects/{project}/locations/{location}/publishers/anthropic/models/{model}:streamRawPredict`.55Token-Counting-Endpunkte sind die einzigen optionalen: Wenn sie fehlen, schätzt Claude Code die Kontextnutzung lokal. Inferenzanfragen werden an `/v1/messages?beta=true` gesendet, daher sollten Sie auf dem Pfad abgleichen, nicht auf der vollständigen URL. Die Google Cloud's Agent Platform-Methode hängt Suffixe an den Publisher-Modellpfad an, wie in `/projects/{project}/locations/{location}/publishers/anthropic/models/{model}:streamRawPredict`.

56 56 

57Ein Gateway sieht auch Best-Effort-Startup-Traffic, den es ablehnen kann, ohne etwas zu unterbrechen: eine `HEAD /` Konnektivitätsprobe und auf Bedrock-Format-Gateways eine `GET /inference-profiles?type=SYSTEM_DEFINED` Anfrage.57Ein Gateway sieht auch Best-Effort-Startup-Traffic, den es ablehnen kann, ohne etwas zu unterbrechen: eine `HEAD /` Konnektivitätsprobe und auf Amazon Bedrock-Format-Gateways eine `GET /inference-profiles?type=SYSTEM_DEFINED` Anfrage.

58 58 

59<h3 id="streaming">59<h3 id="streaming">

60 Streaming60 Streaming


68 68 

69Welches Format der Client spricht, bestimmt, was Ihr Gateway empfängt. Der häufige Fehlermodus ist ein Mismatch zwischen dem Format, das der Client an Ihr Gateway sendet, und dem Format, das der Upstream-Provider dahinter akzeptiert.69Welches Format der Client spricht, bestimmt, was Ihr Gateway empfängt. Der häufige Fehlermodus ist ein Mismatch zwischen dem Format, das der Client an Ihr Gateway sendet, und dem Format, das der Upstream-Provider dahinter akzeptiert.

70 70 

71* Wenn der Client das Bedrock- oder Agent Platform-Format spricht, sendet Claude Code nur die Teilmenge seiner vollständigen Funktionsmenge, die diese Provider akzeptieren71* Wenn der Client das Amazon Bedrock- oder Google Cloud's Agent Platform-Format spricht, sendet Claude Code nur die Teilmenge seiner vollständigen Funktionsmenge, die diese Provider akzeptieren

72* Wenn der Client das Anthropic Messages-Format spricht, sendet Claude Code die vollständige Menge, auch wenn Ihr Gateway an ein Bedrock- oder Agent Platform-Upstream weiterleitet72* Wenn der Client das Anthropic Messages-Format spricht, sendet Claude Code die vollständige Menge, auch wenn Ihr Gateway an ein Amazon Bedrock- oder Google Cloud's Agent Platform-Upstream weiterleitet

73 73 

74Diese Differenz zu überbrücken ist die Aufgabe Ihres Gateways. [Funktionsdurchleitung](#feature-pass-through) beschreibt, was bricht, wenn dies nicht der Fall ist.74Diese Differenz zu überbrücken ist die Aufgabe Ihres Gateways. [Funktionsdurchleitung](#feature-pass-through) beschreibt, was bricht, wenn dies nicht der Fall ist.

75 75 


82| Header | Beschreibung |82| Header | Beschreibung |

83| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |83| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

84| `Authorization`, `x-api-key` | Die Gateway-Anmeldedaten des Entwicklers, in einem oder beiden Headern, je nachdem, welche [Anmeldedaten-Variable](/de/llm-gateway-connect#set-the-credential-variable) sie setzen |84| `Authorization`, `x-api-key` | Die Gateway-Anmeldedaten des Entwicklers, in einem oder beiden Headern, je nachdem, welche [Anmeldedaten-Variable](/de/llm-gateway-connect#set-the-credential-variable) sie setzen |

85| `anthropic-version` | API-Version, derzeit `2023-06-01`. Bedrock- und Agent Platform-Format-Anfragen enthalten auch das `anthropic_version` Body-Feld, dessen Wert die Provider-Dialekt-Zeichenkette ist, nicht der Wert dieses Headers |85| `anthropic-version` | API-Version, derzeit `2023-06-01`. Amazon Bedrock- und Google Cloud Agent Platform-Format-Anfragen enthalten auch das `anthropic_version` Body-Feld, dessen Wert die Provider-Dialekt-Zeichenkette ist, nicht der Wert dieses Headers |

86| `anthropic-beta` | Komma-getrennte Funktionswerte für die Anfrage. Leiten Sie den Header wörtlich weiter; erstellen Sie keine Allowlist einzelner Werte, da sich die Menge mit Claude Code-Versionen ändert. Wenn sich der Entwickler mit einer claude.ai-Anmeldung authentifiziert, was möglich ist, wenn `ANTHROPIC_BASE_URL` ohne eine Gateway-Anmeldedaten-Variable gesetzt ist, trägt dieser Header auch eine OAuth-Funktion, die das Upstream benötigt, und das Löschen führt zu `401` Fehlern bei diesen Anfragen |86| `anthropic-beta` | Komma-getrennte Funktionswerte für die Anfrage. Leiten Sie den Header wörtlich weiter; erstellen Sie keine Allowlist einzelner Werte, da sich die Menge mit Claude Code-Versionen ändert. Wenn sich der Entwickler mit einer claude.ai-Anmeldung authentifiziert, was möglich ist, wenn `ANTHROPIC_BASE_URL` ohne eine Gateway-Anmeldedaten-Variable gesetzt ist, trägt dieser Header auch eine OAuth-Funktion, die das Upstream benötigt, und das Löschen führt zu `401` Fehlern bei diesen Anfragen |

87| `x-claude-code-session-id` | Ein eindeutiger Bezeichner für die aktuelle Claude Code-Sitzung. Verwenden Sie ihn, um alle Anfragen aus einer Sitzung zu aggregieren, ohne Request-Bodies zu analysieren |87| `x-claude-code-session-id` | Ein eindeutiger Bezeichner für die aktuelle Claude Code-Sitzung. Verwenden Sie ihn, um alle Anfragen aus einer Sitzung zu aggregieren, ohne Request-Bodies zu analysieren |

88| `x-claude-code-agent-id` | Bezeichner des [Subagenten](/de/sub-agents), der die Anfrage gestellt hat, vorhanden nur bei Anfragen von einem Agenten, den Claude Code in der Sitzung spawnt. Verwenden Sie ihn mit der Sitzungs-ID, um Kosten parallelen Agenten zuzuordnen |88| `x-claude-code-agent-id` | Bezeichner des [Subagenten](/de/sub-agents), der die Anfrage gestellt hat, vorhanden nur bei Anfragen von einem Agenten, den Claude Code in der Sitzung spawnt. Verwenden Sie ihn mit der Sitzungs-ID, um Kosten parallelen Agenten zuzuordnen |


100 100 

101Beim Weiterleiten an ein Anthropic-Format-Upstream leiten Sie `anthropic-*` Request-Header und Request-Body-Felder unverändert durch, anstatt die heute beobachteten zu allowlisten. Ein Gateway, das an eine beobachtete Liste gepinnt ist, löscht den Header oder das Feld der nächsten Funktion und bricht es bei der Veröffentlichung, die es einführt.101Beim Weiterleiten an ein Anthropic-Format-Upstream leiten Sie `anthropic-*` Request-Header und Request-Body-Felder unverändert durch, anstatt die heute beobachteten zu allowlisten. Ein Gateway, das an eine beobachtete Liste gepinnt ist, löscht den Header oder das Feld der nächsten Funktion und bricht es bei der Veröffentlichung, die es einführt.

102 102 

103Die Ausnahme ist ein Nicht-Anthropic-Upstream wie Bedrock oder Agent Platform, wo die Überbrückung der Schemadifferenz die Aufgabe des Gateways ist; siehe [Funktionsdurchleitung](#feature-pass-through).103Die Ausnahme ist ein Nicht-Anthropic-Upstream wie Amazon Bedrock oder Google Cloud Agent Platform, wo die Überbrückung der Schemadifferenz die Aufgabe des Gateways ist; siehe [Funktionsdurchleitung](#feature-pass-through).

104 104 

105<h2 id="system-prompt-attribution-block">105<h2 id="system-prompt-attribution-block">

106 System-Prompt-Attributionsblock106 System-Prompt-Attributionsblock

Details

185| `apiKeyHelper`, oder eine Anmeldedaten in `ANTHROPIC_AUTH_TOKEN` oder `ANTHROPIC_API_KEY` | Authentifiziert jede Anfrage an das Gateway. Der Helper führt einen Befehl aus, um den Schlüssel zu holen; die Variablen halten einen statischen Schlüssel, gesendet als `Authorization: Bearer` und `x-api-key` jeweils | Immer; eine der drei |185| `apiKeyHelper`, oder eine Anmeldedaten in `ANTHROPIC_AUTH_TOKEN` oder `ANTHROPIC_API_KEY` | Authentifiziert jede Anfrage an das Gateway. Der Helper führt einen Befehl aus, um den Schlüssel zu holen; die Variablen halten einen statischen Schlüssel, gesendet als `Authorization: Bearer` und `x-api-key` jeweils | Immer; eine der drei |

186| `ANTHROPIC_CUSTOM_HEADERS` | Fügt zusätzliche HTTP-Header zu jeder API-Anfrage hinzu | Ihr Gateway erfordert einen Mandanten- oder Routing-Header bei jeder Anfrage |186| `ANTHROPIC_CUSTOM_HEADERS` | Fügt zusätzliche HTTP-Header zu jeder API-Anfrage hinzu | Ihr Gateway erfordert einen Mandanten- oder Routing-Header bei jeder Anfrage |

187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Fragt das `/v1/models` des Gateways beim Start ab und fügt die zurückgegebenen Namen zur `/model`-Auswahl hinzu | Ihr Gateway stellt `/v1/models` bereit und Sie möchten, dass die Auswahl der Entwickler von ihm gefüllt wird |187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Fragt das `/v1/models` des Gateways beim Start ab und fügt die zurückgegebenen Namen zur `/model`-Auswahl hinzu | Ihr Gateway stellt `/v1/models` bereit und Sie möchten, dass die Auswahl der Entwickler von ihm gefüllt wird |

188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Stoppt Claude Code beim Senden von Pre-Release-Capability-Headern und Body-Feldern | Ihr Gateway leitet zu einem Bedrock- oder Agent Platform-Upstream weiter, der Beta-Felder ablehnt; siehe [Gateway-Anforderungen](#gateway-requirements) |188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Stoppt Claude Code beim Senden von Pre-Release-Capability-Headern und Body-Feldern | Ihr Gateway leitet zu einem Amazon Bedrock- oder Google Cloud Agent Platform-Upstream weiter, der Beta-Felder ablehnt; siehe [Gateway-Anforderungen](#gateway-requirements) |

189| `ANTHROPIC_MODEL` oder [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/de/model-config) | Legen Sie fest, welchen Modellnamen Claude Code für die Hauptsitzung und für Hintergrund-Traffic anfordert | Ihr Gateway leitet Modellnamen weiter, die nicht Claude Codes Standardwerte entsprechen, oder Sie leiten [Hintergrund-Funktionalität](/de/costs#background-token-usage) an ein anderes Modell weiter. Leiten Sie sowohl die Override-Namen als auch die integrierten Modell-IDs weiter, die Claude Code anfordert, wenn kein Override gesetzt ist, da einige Unter-Aufrufe unabhängig vom Override eine integrierte ID anfordern; [Modellkonfiguration](/de/model-config) behandelt, welches Modell jeder Teil einer Sitzung verwendet |189| `ANTHROPIC_MODEL` oder [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/de/model-config) | Legen Sie fest, welchen Modellnamen Claude Code für die Hauptsitzung und für Hintergrund-Traffic anfordert | Ihr Gateway leitet Modellnamen weiter, die nicht Claude Codes Standardwerte entsprechen, oder Sie leiten [Hintergrund-Funktionalität](/de/costs#background-token-usage) an ein anderes Modell weiter. Leiten Sie sowohl die Override-Namen als auch die integrierten Modell-IDs weiter, die Claude Code anfordert, wenn kein Override gesetzt ist, da einige Unter-Aufrufe unabhängig vom Override eine integrierte ID anfordern; [Modellkonfiguration](/de/model-config) behandelt, welches Modell jeder Teil einer Sitzung verwendet |

190| `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, `ANTHROPIC_FOUNDRY_BASE_URL`, oder `ANTHROPIC_AWS_BASE_URL` mit den [Variablen für diesen Anbieter](/de/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) | Zeigen Sie Claude Code auf das Gateway durch eine anbieter-spezifische Basis-URL. Bedrock und Agent Platform wechseln auch zu den nativen Request-Formaten dieser Anbieter | Ihr Gateway frontet Bedrock, Agent Platform, Foundry oder die Claude Platform auf AWS; siehe [API-Formate](/de/llm-gateway-protocol#api-formats) |190| `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, `ANTHROPIC_FOUNDRY_BASE_URL`, oder `ANTHROPIC_AWS_BASE_URL` mit den [Variablen für diesen Anbieter](/de/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) | Zeigen Sie Claude Code auf das Gateway durch eine anbieter-spezifische Basis-URL. Amazon Bedrock und Google Cloud Agent Platform wechseln auch zu den nativen Request-Formaten dieser Anbieter | Ihr Gateway frontet Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry oder die Claude Platform auf AWS; siehe [API-Formate](/de/llm-gateway-protocol#api-formats) |

191 191 

192<h4 id="distribute-through-managed-settings">192<h4 id="distribute-through-managed-settings">

193 Verteilen Sie über verwaltete Einstellungen193 Verteilen Sie über verwaltete Einstellungen


214 214 

215Einige Umgebungen benötigen separate Lieferung:215Einige Umgebungen benötigen separate Lieferung:

216 216 

217* Die Desktop-App liest Gateway-Routing nur aus ihrer MDM-bereitgestellten Drittanbieter-Inferenzkonfiguration; stellen Sie diese Datei neben verwalteten Einstellungen bereit, damit Desktop-Sitzungen auch durch das Gateway geleitet werden. Siehe die [Desktop-Drittanbieter-Konfigurationsdocs](https://claude.com/docs/cowork/3p/configuration) und die [Desktop-Gateway-Docs](https://claude.com/docs/cowork/3p/gateway)217* Die Desktop-App liest Gateway-Routing nur aus ihrer MDM-bereitgestellten Drittanbieter-Inferenzkonfiguration; stellen Sie diese Datei neben verwalteten Einstellungen bereit, damit Desktop-Sitzungen auch durch das Gateway geleitet werden. Siehe die [Desktop-Drittanbieter-Konfigurationsdocs](https://claude.com/docs/third-party/claude-desktop/configuration) und die [Desktop-Gateway-Docs](https://claude.com/docs/third-party/claude-desktop/gateway)

218* CI-Runner benötigen `ANTHROPIC_BASE_URL` und die Anmeldedaten in der [Umgebung des Runners](/de/llm-gateway-connect#configure-each-surface) gesetzt218* CI-Runner benötigen `ANTHROPIC_BASE_URL` und die Anmeldedaten in der [Umgebung des Runners](/de/llm-gateway-connect#configure-each-surface) gesetzt

219* WSL auf verwalteten Windows-Maschinen liest die Windows-verwalteten Einstellungen nur, wenn [`wslInheritsWindowsSettings`](/de/settings#available-settings) `true` ist219* WSL auf verwalteten Windows-Maschinen liest die Windows-verwalteten Einstellungen nur, wenn [`wslInheritsWindowsSettings`](/de/settings#available-settings) `true` ist

220 220 

mcp.md +31 −14

Details

85 85 

86Bei der Konfiguration von MCP-Servern über JSON in `.mcp.json`, `~/.claude.json` oder `claude mcp add-json` akzeptiert das Feld `type` `streamable-http` als Alias für `http`. Die MCP-Spezifikation verwendet den Namen `streamable-http` für dieses Transportprotokoll, sodass Konfigurationen, die aus der Server-Dokumentation kopiert werden, ohne Änderungen funktionieren.86Bei der Konfiguration von MCP-Servern über JSON in `.mcp.json`, `~/.claude.json` oder `claude mcp add-json` akzeptiert das Feld `type` `streamable-http` als Alias für `http`. Die MCP-Spezifikation verwendet den Namen `streamable-http` für dieses Transportprotokoll, sodass Konfigurationen, die aus der Server-Dokumentation kopiert werden, ohne Änderungen funktionieren.

87 87 

88Ein 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`.

89 

88<h3 id="option-2-add-a-remote-sse-server">90<h3 id="option-2-add-a-remote-sse-server">

89 Option 2: Einen Remote-SSE-Server hinzufügen91 Option 2: Einen Remote-SSE-Server hinzufügen

90</h3>92</h3>


113 115 

114Claude Code setzt `CLAUDE_PROJECT_DIR` in der Umgebung des erzeugten Servers auf das Projektstammverzeichnis, sodass Ihr Server projektrelative Pfade auflösen kann, ohne vom Arbeitsverzeichnis abhängig zu sein. Dies ist das gleiche Verzeichnis, das Hooks in ihrer `CLAUDE_PROJECT_DIR`-Variable erhalten. Lesen Sie es aus Ihrem Serverprozess, zum Beispiel `process.env.CLAUDE_PROJECT_DIR` in Node oder `os.environ["CLAUDE_PROJECT_DIR"]` in Python.116Claude Code setzt `CLAUDE_PROJECT_DIR` in der Umgebung des erzeugten Servers auf das Projektstammverzeichnis, sodass Ihr Server projektrelative Pfade auflösen kann, ohne vom Arbeitsverzeichnis abhängig zu sein. Dies ist das gleiche Verzeichnis, das Hooks in ihrer `CLAUDE_PROJECT_DIR`-Variable erhalten. Lesen Sie es aus Ihrem Serverprozess, zum Beispiel `process.env.CLAUDE_PROJECT_DIR` in Node oder `os.environ["CLAUDE_PROJECT_DIR"]` in Python.

115 117 

116Ihr Server kann auch die MCP-Anfrage `roots/list` aufrufen, die das Verzeichnis zurückgibt, aus dem Claude Code gestartet wurde.118`CLAUDE_PROJECT_DIR` ist das stabile Projektstammverzeichnis und ändert sich nicht, wenn Sie während einer Sitzung Arbeitsverzeichnisse hinzufügen oder entfernen. Ein Server, der seinen eigenen Dateisystemzugriff auf einen Satz zulässiger Verzeichnisse beschränkt, sollte stattdessen die MCP-Anfrage `roots/list` implementieren. Claude Code antwortet auf `roots/list` mit dem Startverzeichnis der Sitzung plus jedem [zusätzlichen Arbeitsverzeichnis](/de/permissions#working-directories), das Sie mit `--add-dir`, `/add-dir` oder der Einstellung `additionalDirectories` gewährt haben. Claude Code sendet `notifications/roots/list_changed`, wenn sich dieser Satz ändert. Vor v2.1.203 gab `roots/list` nur das Startverzeichnis zurück und Claude Code sendete `notifications/roots/list_changed` nicht.

117 119 

118Diese Variable wird in der Umgebung des Servers gesetzt, nicht in der Umgebung von Claude Code selbst, daher erfordert das Referenzieren über `${VAR}`-Erweiterung in einer projekt- oder benutzergesteuerten `.mcp.json` `command` oder `args` einen Standard wie `${CLAUDE_PROJECT_DIR:-.}`. Von Plugins bereitgestellte MCP-Konfigurationen ersetzen `${CLAUDE_PROJECT_DIR}` direkt und benötigen keinen Standard.120Diese Variable wird in der Umgebung des Servers gesetzt, nicht in der Umgebung von Claude Code selbst, daher erfordert das Referenzieren über `${VAR}`-Erweiterung in einer projekt- oder benutzergesteuerten `.mcp.json` `command` oder `args` einen Standard wie `${CLAUDE_PROJECT_DIR:-.}`. Von Plugins bereitgestellte MCP-Konfigurationen ersetzen `${CLAUDE_PROJECT_DIR}` direkt und benötigen keinen Standard.

119 121 


191 193 

192Das `/mcp`-Panel zeigt die Tool-Anzahl neben jedem verbundenen Server an und kennzeichnet Server, die die Tools-Funktion ankündigen, aber keine Tools bereitstellen.194Das `/mcp`-Panel zeigt die Tool-Anzahl neben jedem verbundenen Server an und kennzeichnet Server, die die Tools-Funktion ankündigen, aber keine Tools bereitstellen.

193 195 

194Wenn Ihre Anfrage Tools von einem Server benötigt, der sich noch im Hintergrund verbindet, wartet Claude auf diesen Server, bevor er fortfährt. Mit [Tool-Suche](#scale-with-mcp-tool-search) aktiviert, was die Standardeinstellung ist, erfolgt das Warten innerhalb des `ToolSearch`-Aufrufs. In Konfigurationen ohne Tool-Suche, wie Vertex AI, eine benutzerdefinierte `ANTHROPIC_BASE_URL` oder `ENABLE_TOOL_SEARCH=false`, verwendet Claude stattdessen das `WaitForMcpServers`-Tool.196Wenn Ihre Anfrage Tools von einem Server benötigt, der sich noch im Hintergrund verbindet, wartet Claude auf diesen Server, bevor er fortfährt. Mit [Tool-Suche](#scale-with-mcp-tool-search) aktiviert, was die Standardeinstellung ist, erfolgt das Warten innerhalb des `ToolSearch`-Aufrufs. In Konfigurationen ohne Tool-Suche, wie Google Cloud's Agent Platform, eine benutzerdefinierte `ANTHROPIC_BASE_URL` oder `ENABLE_TOOL_SEARCH=false`, verwendet Claude stattdessen das `WaitForMcpServers`-Tool.

197 

198Einige Servernamen sind für Claude Codes integrierte Server reserviert: `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` und `Claude Browser`. Wenn Ihre Konfiguration einen Server mit einem reservierten Namen definiert, überspringt Claude Code ihn beim Laden und zeigt eine Warnung an, die Sie auffordert, ihn umzubenennen. `claude mcp add` lehnt einen reservierten Namen mit einem Fehler ab.

195 199 

196Der Servername `workspace` ist für interne Verwendung reserviert. Wenn Ihre Konfiguration einen Server mit diesem Namen definiert, überspringt Claude Code ihn beim Laden und zeigt eine Warnung an, die Sie auffordert, ihn umzubenennen.200`Claude Preview` und `Claude Browser` benennen beide den integrierten Server, den der [Claude Code Desktop-App-Vorschaubereich](/de/desktop#preview-your-app) verwendet. Vor v2.1.205 war `Claude Browser` nicht reserviert, daher konnte ein benutzerkonfigurierter Server sich unter diesem Namen registrieren.

197 201 

198<h3 id="dynamic-tool-updates">202<h3 id="dynamic-tool-updates">

199 Dynamische Tool-Updates203 Dynamische Tool-Updates


209 213 

210Das gleiche Backoff gilt, wenn ein HTTP- oder SSE-Server beim Start seine anfängliche Verbindung nicht herstellt. Ab v2.1.121 versucht Claude Code die anfängliche Verbindung bis zu dreimal bei vorübergehenden Fehlern wie einer 5xx-Antwort, einer Verbindungsverweigerung oder einem Timeout erneut, markiert den Server dann als fehlgeschlagen, wenn er immer noch keine Verbindung herstellen kann. Authentifizierungs- und Not-Found-Fehler werden nicht erneut versucht, da sie eine Konfigurationsänderung erfordern, um behoben zu werden.214Das gleiche Backoff gilt, wenn ein HTTP- oder SSE-Server beim Start seine anfängliche Verbindung nicht herstellt. Ab v2.1.121 versucht Claude Code die anfängliche Verbindung bis zu dreimal bei vorübergehenden Fehlern wie einer 5xx-Antwort, einer Verbindungsverweigerung oder einem Timeout erneut, markiert den Server dann als fehlgeschlagen, wenn er immer noch keine Verbindung herstellen kann. Authentifizierungs- und Not-Found-Fehler werden nicht erneut versucht, da sie eine Konfigurationsänderung erfordern, um behoben zu werden.

211 215 

216Wenn ein konfigurierter Server keine Verbindung herstellen kann, teilt Claude Code Claude mit, welcher Server fehlgeschlagen ist und sein Verbindungsfehler, einschließlich in `ToolSearch`-Ergebnissen, die kein passendes Tool finden, sodass Claude den Verbindungsfehler in seiner Antwort meldet. Erfordert [Tool-Suche](#scale-with-mcp-tool-search), die standardmäßig aktiviert ist. In Konfigurationen ohne Tool-Suche, wie eine benutzerdefinierte `ANTHROPIC_BASE_URL`, `ENABLE_TOOL_SEARCH=false` oder ein Haiku-Modell, und auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, meldet Claude Code fehlgeschlagene Server-Verbindungen nicht an Claude. Vor v2.1.205 übergab Claude Code Verbindungsfehler nicht an Claude, und Claude konnte antworten, als ob die Tools des fehlgeschlagenen Servers nie konfiguriert wurden.

217 

212Ab v2.1.191 versuchen die Funktionsentdeckungsanfragen, die nach einer erfolgreichen Verbindung ausgeführt werden, wie `tools/list`, `prompts/list` und `resources/list`, auch vorübergehende Netzwerk- und Serverfehler bis zu dreimal mit kurzem Backoff erneut. Authentifizierungsfehler, 4xx-Antworten und Request-Timeouts werden nicht erneut versucht.218Ab v2.1.191 versuchen die Funktionsentdeckungsanfragen, die nach einer erfolgreichen Verbindung ausgeführt werden, wie `tools/list`, `prompts/list` und `resources/list`, auch vorübergehende Netzwerk- und Serverfehler bis zu dreimal mit kurzem Backoff erneut. Authentifizierungsfehler, 4xx-Antworten und Request-Timeouts werden nicht erneut versucht.

213 219 

214<h3 id="push-messages-with-channels">220<h3 id="push-messages-with-channels">


220<Tip>226<Tip>

221 Tipps:227 Tipps:

222 228 

223 * Verwenden Sie das Flag `--scope`, um anzugeben, wo die Konfiguration gespeichert wird:229 * Verwenden Sie das Flag `-s` oder `--scope`, um anzugeben, wo die Konfiguration gespeichert wird:

224 * `local` (Standard): Nur für Sie im aktuellen Projekt verfügbar. Ältere Versionen nannten diesen Bereich `project`230 * `local` (Standard): Nur für Sie im aktuellen Projekt verfügbar. Ältere Versionen nannten diesen Bereich `project`

225 * `project`: Geteilt mit allen im Projekt über die Datei `.mcp.json`231 * `project`: Geteilt mit allen im Projekt über die Datei `.mcp.json`

226 * `user`: Für Sie über alle Projekte hinweg verfügbar. Ältere Versionen nannten diesen Bereich `global`232 * `user`: Für Sie über alle Projekte hinweg verfügbar. Ältere Versionen nannten diesen Bereich `global`

227 * Legen Sie Umgebungsvariablen mit `--env`-Flags fest (zum Beispiel `--env KEY=value`)233 * Legen Sie Umgebungsvariablen mit `-e` oder `--env`-Flags fest (zum Beispiel `-e KEY=value`)

234 * Die Flags `--transport` und `--header` akzeptieren auch die Kurzformen `-t` und `-H`

228 * Konfigurieren Sie das Startup-Timeout des MCP-Servers mit der Umgebungsvariablen `MCP_TIMEOUT` (zum Beispiel `MCP_TIMEOUT=10000 claude` setzt ein 10-Sekunden-Timeout)235 * Konfigurieren Sie das Startup-Timeout des MCP-Servers mit der Umgebungsvariablen `MCP_TIMEOUT` (zum Beispiel `MCP_TIMEOUT=10000 claude` setzt ein 10-Sekunden-Timeout)

229 * Setzen Sie ein Pro-Server-Tool-Ausführungs-Timeout, indem Sie ein `timeout`-Feld in Millisekunden zum `.mcp.json`-Eintrag dieses Servers hinzufügen, zum Beispiel `"timeout": 600000` für zehn Minuten. Dies überschreibt die Umgebungsvariable `MCP_TOOL_TIMEOUT` nur für diesen Server236 * Setzen Sie ein Pro-Server-Tool-Ausführungs-Timeout, indem Sie ein `timeout`-Feld in Millisekunden zum `.mcp.json`-Eintrag dieses Servers hinzufügen, zum Beispiel `"timeout": 600000` für zehn Minuten. Dies überschreibt die Umgebungsvariable `MCP_TOOL_TIMEOUT` nur für diesen Server

230 * Claude Code zeigt eine Warnung an, wenn die MCP-Tool-Ausgabe 10.000 Token überschreitet. Um dieses Limit zu erhöhen, setzen Sie die Umgebungsvariable `MAX_MCP_OUTPUT_TOKENS` (zum Beispiel `MAX_MCP_OUTPUT_TOKENS=50000`)237 * Claude Code zeigt eine Warnung an, wenn die MCP-Tool-Ausgabe 10.000 Token überschreitet. Um dieses Limit zu erhöhen, setzen Sie die Umgebungsvariable `MAX_MCP_OUTPUT_TOKENS` (zum Beispiel `MAX_MCP_OUTPUT_TOKENS=50000`)


233 240 

234Das Pro-Server-`timeout` ist eine harte Wanduhr-Grenze pro Tool-Aufruf, und Fortschrittsbenachrichtigungen vom Server verlängern sie nicht. Werte unter 1000 werden ignoriert und fallen auf `MCP_TOOL_TIMEOUT` zurück, oder auf seinen Standard von etwa 28 Stunden, wenn diese Variable nicht gesetzt ist. {/* min-version: 2.1.162 */}Vor v2.1.162 wurden Werte unter 1000 stattdessen auf eine Sekunde begrenzt.241Das Pro-Server-`timeout` ist eine harte Wanduhr-Grenze pro Tool-Aufruf, und Fortschrittsbenachrichtigungen vom Server verlängern sie nicht. Werte unter 1000 werden ignoriert und fallen auf `MCP_TOOL_TIMEOUT` zurück, oder auf seinen Standard von etwa 28 Stunden, wenn diese Variable nicht gesetzt ist. {/* min-version: 2.1.162 */}Vor v2.1.162 wurden Werte unter 1000 stattdessen auf eine Sekunde begrenzt.

235 242 

243Ein Pro-Server-`timeout` von mindestens 1000 fungiert auch als Untergrenze für das unten beschriebene Idle-Timeout: Claude Code bricht die Tool-Aufrufe dieses Servers niemals wegen Untätigkeit früher ab als das Pro-Server-`timeout`. Erfordert Claude Code v2.1.203 oder später.

244 

236Bei HTTP- und SSE-Servern hat das Pro-Request-Fetch-First-Byte-Budget ein 60-Sekunden-Minimum.245Bei HTTP- und SSE-Servern hat das Pro-Request-Fetch-First-Byte-Budget ein 60-Sekunden-Minimum.

237 246 

238Ab v2.1.187 bricht ein Tool-Aufruf an einen Remote-HTTP-, SSE-, WebSocket- oder [claude.ai-Connector](#use-mcp-servers-from-claude-ai)-Server, der 5 Minuten lang keine Antwort und keine Fortschrittsbenachrichtigung sendet, mit einem Fehler ab, anstatt auf die Wanduhr-Grenze zu warten. Setzen Sie die Umgebungsvariable [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/de/env-vars) in Millisekunden, um das Idle-Fenster zu ändern, oder setzen Sie sie auf `0`, um die Überprüfung zu deaktivieren. Stdio-Server sind lokale Prozesse und unterliegen nicht dem Idle-Timeout.247Ein Tool-Aufruf an einen MCP-Server, der für das Idle-Fenster keine Antwort und keine Fortschrittsbenachrichtigung sendet, bricht mit einem Fehler ab, anstatt auf die Wanduhr-Grenze zu warten. Das Idle-Timeout erfordert Claude Code v2.1.187 oder später. {/* min-version: 2.1.203 */}Es gilt für jeden Server-Typ außer IDE-Servern und SDK-In-Process-Servern. Das Idle-Fenster beträgt standardmäßig fünf Minuten für HTTP-, SSE-, WebSocket- und [claude.ai-Connector](#use-mcp-servers-from-claude-ai)-Server und 30 Minuten für Stdio-Server. Vor v2.1.203 waren Stdio-Server vom Idle-Timeout ausgenommen.

248 

249Setzen Sie die Umgebungsvariable [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/de/env-vars) in Millisekunden, um das Idle-Fenster zu ändern, oder setzen Sie sie auf `0`, um die Überprüfung zu deaktivieren.

239 250 

240<h3 id="plugin-provided-mcp-servers">251<h3 id="plugin-provided-mcp-servers">

241 Von Plugins bereitgestellte MCP-Server252 Von Plugins bereitgestellte MCP-Server


306mcp__plugin_my-plugin_database-tools__query317mcp__plugin_my-plugin_database-tools__query

307```318```

308 319 

309Verwenden Sie diesen vollständigen Namen, wenn Sie auf das Tool in [Berechtigungsregeln](/de/permissions), der `allowed-tools`-Liste eines Skills oder dem [`tools`-Feld eines Subagenten](/de/sub-agents#available-tools) verweisen.320Verwenden Sie diesen vollständigen Namen, wenn Sie auf das Tool in [Berechtigungsregeln](/de/permissions), der `allowed-tools`-Liste eines Skills, dem [`tools`-Feld eines Subagenten](/de/sub-agents#available-tools) oder einem [Hook-Matcher](/de/hooks#match-mcp-tools) verweisen. Ein Hook-Matcher, der gegen den bloßen Server-Schlüssel geschrieben wurde, wie `mcp__database-tools__.*`, wird niemals für einen Plugin-gebündelten Server ausgelöst.

321 

322Der Server selbst registriert sich unter dem scoped Namen `plugin:<plugin-name>:<server-name>`, wie `plugin:my-plugin:database-tools`. Verwenden Sie diesen Namen, wo ein konfigurierter Server-Name erwartet wird, wie das [`server`-Feld eines `mcp_tool`-Hooks](/de/hooks#mcp-tool-hook-fields).

310 323 

311**Vorteile von Plugin-MCP-Servern**:324**Vorteile von Plugin-MCP-Servern**:

312 325 


860 </Step>873 </Step>

861</Steps>874</Steps>

862 875 

876Servernamen, die über `claude mcp`-Befehle hinzugefügt werden, dürfen nur Buchstaben, Zahlen, Bindestriche und Unterstriche enthalten. Claude Desktop wendet diese Einschränkung nicht an, daher kann ein Claude Desktop-Server, dessen Name ein anderes Zeichen wie ein Leerzeichen enthält, nicht importiert werden. Der Import meldet jeden Namen, den er ablehnt, und importiert weiterhin die anderen Server, die Sie ausgewählt haben. Vor v2.1.205 stoppte der erste ungültige Name den Import und keiner der ausgewählten Server wurde hinzugefügt.

877 

863<Tip>878<Tip>

864 Tipps:879 Tipps:

865 880 

866 * Diese Funktion funktioniert nur auf macOS und Windows Subsystem for Linux (WSL)881 * Diese Funktion funktioniert nur auf macOS und Windows Subsystem for Linux (WSL)

867 * Sie liest die Claude Desktop-Konfigurationsdatei von ihrem Standardort auf diesen Plattformen882 * Sie liest die Claude Desktop-Konfigurationsdatei von ihrem Standardort auf diesen Plattformen

868 * Verwenden Sie das Flag `--scope user`, um Server zu Ihrer Benutzerkonfiguration hinzuzufügen883 * Verwenden Sie das Flag `--scope user`, um Server zu Ihrer Benutzerkonfiguration hinzuzufügen

869 * Importierte Server haben die gleichen Namen wie in Claude Desktop884 * Importierte Server behalten die gleichen Namen wie in Claude Desktop, wenn der Name nur Buchstaben, Zahlen, Bindestriche und Unterstriche enthält. Claude Code meldet einen Server, dessen Name ein anderes Zeichen enthält, und überspringt ihn

870 * Wenn Server mit den gleichen Namen bereits vorhanden sind, erhalten sie ein numerisches Suffix (zum Beispiel `server_1`)885 * Wenn Server mit den gleichen Namen bereits vorhanden sind, erhalten sie ein numerisches Suffix (zum Beispiel `server_1`)

871</Tip>886</Tip>

872 887 


898 913 

899Ab v2.1.161 werden Connectoren, bei denen Sie sich noch nie angemeldet haben, hinter einer Zeile `Show unused connectors` am Ende des Claude.ai-Abschnitts eingeklappt, sodass 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.914Ab v2.1.161 werden Connectoren, bei denen Sie sich noch nie angemeldet haben, hinter einer Zeile `Show unused connectors` am Ende des Claude.ai-Abschnitts eingeklappt, sodass 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.

900 915 

901Claude.ai-Connectoren werden nur abgerufen, wenn Ihre aktive [Authentifizierungsmethode](/de/authentication#authentication-precedence) Ihr Claude.ai-Abonnement ist. Sie werden nicht geladen, wenn `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper` oder ein Drittanbieter wie Bedrock oder Vertex aktiv ist, auch wenn Sie zuvor `/login` ausgeführt haben. Wenn `/mcp` einen Connector, den Sie hinzugefügt haben, nicht auflistet, führen Sie `/status` aus, um zu bestätigen, welche Authentifizierungsmethode aktiv ist, heben Sie diese Umgebungsvariable auf oder entfernen Sie die `apiKeyHelper`-Einstellung, und führen Sie dann `/login` aus, um Ihr Claude.ai-Konto auszuwählen.916Claude.ai-Connectoren werden nur abgerufen, wenn Ihre aktive [Authentifizierungsmethode](/de/authentication#authentication-precedence) Ihr Claude.ai-Abonnement ist. Sie werden nicht geladen, wenn `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper` oder ein Drittanbieter wie Amazon Bedrock oder Google Cloud's Agent Platform aktiv ist, auch wenn Sie zuvor `/login` ausgeführt haben.

917 

918Wenn `/mcp` einen Connector, den Sie hinzugefügt haben, nicht auflistet, führen Sie `/status` aus, um zu bestätigen, welche Authentifizierungsmethode aktiv ist, heben Sie diese Umgebungsvariable auf oder entfernen Sie die `apiKeyHelper`-Einstellung, und führen Sie dann `/login` aus, um Ihr Claude.ai-Konto auszuwählen.

902 919 

903Ein Server, den Sie in Claude Code hinzugefügt haben, hat [Vorrang](#scope-hierarchy-and-precedence) vor einem Claude.ai-Connector, der auf dieselbe URL verweist. Wenn dies geschieht, listet `/mcp` den Connector als verborgen auf und zeigt, wie Sie das Duplikat entfernen können, wenn Sie lieber den Connector verwenden möchten.920Ein Server, den Sie in Claude Code hinzugefügt haben, hat [Vorrang](#scope-hierarchy-and-precedence) vor einem Claude.ai-Connector, der auf dieselbe URL verweist. Wenn dies geschieht, listet `/mcp` den Connector als verborgen auf und zeigt, wie Sie das Duplikat entfernen können, wenn Sie lieber den Connector verwenden möchten.

904 921 


1174 Tool-Suche konfigurieren1191 Tool-Suche konfigurieren

1175</h3>1192</h3>

1176 1193 

1177Die Tool-Suche ist standardmäßig aktiviert: MCP-Tools werden aufgeschoben und bei Bedarf entdeckt. Claude Code deaktiviert sie standardmäßig auf Vertex AI. Sie ist auch deaktiviert, wenn `ANTHROPIC_BASE_URL` auf einen Host von Drittanbietern verweist, da die meisten Proxys `tool_reference`-Blöcke nicht weiterleiten. Setzen Sie `ENABLE_TOOL_SEARCH` explizit fest, um eine der beiden Fallback-Einstellungen zu überschreiben.1194Die Tool-Suche ist standardmäßig aktiviert: MCP-Tools werden aufgeschoben und bei Bedarf entdeckt. Claude Code deaktiviert sie standardmäßig auf Google Cloud's Agent Platform. Sie ist auch deaktiviert, wenn `ANTHROPIC_BASE_URL` auf einen Host von Drittanbietern verweist, da die meisten Proxys `tool_reference`-Blöcke nicht weiterleiten. Setzen Sie `ENABLE_TOOL_SEARCH` explizit fest, um eine der beiden Fallback-Einstellungen zu überschreiben.

1178 1195 

1179Die Tool-Suche erfordert ein Modell, das `tool_reference`-Blöcke unterstützt. Haiku-Modelle unterstützen dies nicht. Auf Vertex AI wird die Tool-Suche für Claude Sonnet 4.5 und später sowie Claude Opus 4.5 und später unterstützt.1196Die Tool-Suche erfordert ein Modell, das `tool_reference`-Blöcke unterstützt. Haiku-Modelle unterstützen dies nicht. Auf Google Cloud's Agent Platform wird die Tool-Suche für Claude Sonnet 4.5 und später sowie Claude Opus 4.5 und später unterstützt.

1180 1197 

1181Steuern Sie das Verhalten der Tool-Suche mit der Umgebungsvariablen `ENABLE_TOOL_SEARCH`:1198Steuern Sie das Verhalten der Tool-Suche mit der Umgebungsvariablen `ENABLE_TOOL_SEARCH`:

1182 1199 

1183| Wert | Verhalten |1200| Wert | Verhalten |

1184| :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1201| :-------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1185| (nicht gesetzt) | Alle MCP-Tools werden aufgeschoben und bei Bedarf geladen. Fällt auf das Laden vorab zurück auf Vertex AI oder wenn `ANTHROPIC_BASE_URL` ein Host von Drittanbietern ist |1202| (nicht gesetzt) | Alle MCP-Tools werden aufgeschoben und bei Bedarf geladen. Fällt auf das Laden vorab zurück auf Google Cloud's Agent Platform oder wenn `ANTHROPIC_BASE_URL` ein Host von Drittanbietern ist |

1186| `true` | Alle MCP-Tools werden aufgeschoben. Claude Code sendet den Beta-Header auch auf Vertex AI und durch Proxys. Anfragen schlagen fehl bei Vertex AI-Modellen älter als Sonnet 4.5 oder Opus 4.5 oder bei Proxys, die `tool_reference`-Blöcke nicht unterstützen |1203| `true` | Alle MCP-Tools werden aufgeschoben. Claude Code sendet den Beta-Header auch auf Google Cloud's Agent Platform und durch Proxys. Anfragen schlagen fehl bei Google Cloud's Agent Platform-Modellen älter als Sonnet 4.5 oder Opus 4.5 oder bei Proxys, die `tool_reference`-Blöcke nicht unterstützen |

1187| `auto` | Schwellenmodus: Tools werden vorab geladen, wenn sie in 10 % des Kontextfensters passen, andernfalls aufgeschoben |1204| `auto` | Schwellenmodus: Tools werden vorab geladen, wenn sie in 10 % des Kontextfensters passen, andernfalls aufgeschoben |

1188| `auto:N` | Schwellenmodus mit benutzerdefiniertem Prozentsatz, wobei `N` 0-100 ist. Beispiel: `auto:5` für 5 % |1205| `auto:N` | Schwellenmodus mit benutzerdefiniertem Prozentsatz, wobei `N` 0-100 ist. Beispiel: `auto:5` für 5 % |

1189| `false` | Alle MCP-Tools werden vorab geladen, keine Verschiebung |1206| `false` | Alle MCP-Tools werden vorab geladen, keine Verschiebung |

Details

315 Claude Code hat keine Server für das aktuelle Verzeichnis gefunden. Die häufigsten Ursachen:315 Claude Code hat keine Server für das aktuelle Verzeichnis gefunden. Die häufigsten Ursachen:

316 316 

317 * Sie haben `claude mcp add` aus einem anderen Projekt ausgeführt. Lokal begrenzte Server sind an das Projekt gebunden, in dem Sie sie hinzugefügt haben: das Repository-Stammverzeichnis oder das genaue Verzeichnis, wenn Sie sich nicht in einem Git-Repository befanden. Fügen Sie den Server aus dem Projekt erneut hinzu, in dem Sie sich jetzt befinden, oder fügen Sie ihn mit `--scope user` hinzu, damit er nicht an ein Projekt gebunden ist.317 * Sie haben `claude mcp add` aus einem anderen Projekt ausgeführt. Lokal begrenzte Server sind an das Projekt gebunden, in dem Sie sie hinzugefügt haben: das Repository-Stammverzeichnis oder das genaue Verzeichnis, wenn Sie sich nicht in einem Git-Repository befanden. Fügen Sie den Server aus dem Projekt erneut hinzu, in dem Sie sich jetzt befinden, oder fügen Sie ihn mit `--scope user` hinzu, damit er nicht an ein Projekt gebunden ist.

318 * Sie haben eine Konfigurationsdatei unter dem falschen Pfad bearbeitet. Die richtigen Dateien sind `~/.claude.json` und `<project>/.mcp.json`. Claude Code liest keine Pfade wie `~/.claude/config/mcp.json`, `~/.claude/mcp.json` oder `%APPDATA%\Claude\mcp.json`.318 * Sie haben eine Konfigurationsdatei unter dem falschen Pfad bearbeitet. Die richtigen Dateien sind `~/.claude.json` und `<project>/.mcp.json`. Claude Code liest keine Pfade wie `~/.claude/.mcp.json`, `~/.claude/config/mcp.json`, `~/.claude/mcp.json` oder `%APPDATA%\Claude\mcp.json`. Für benutzerbereichsbegrenzte Server führen Sie `claude mcp add --scope user` aus, das in den `mcpServers`-Schlüssel in `~/.claude.json` schreibt; für projektbereichsbegrenzte Server bearbeiten Sie `.mcp.json` im Projektstammverzeichnis.

319 </Accordion>319 </Accordion>

320 320 

321 <Accordion title="Status shows Failed to connect or Connection error">321 <Accordion title="Status shows Failed to connect or Connection error">

Details

113 2) Azure-Anmeldedaten konfigurieren113 2) Azure-Anmeldedaten konfigurieren

114</h3>114</h3>

115 115 

116Claude Code unterstützt zwei Authentifizierungsmethoden für Microsoft Foundry. Wählen Sie die Methode, die Ihren Sicherheitsanforderungen am besten entspricht.116Claude Code unterstützt drei Authentifizierungsmethoden für Microsoft Foundry. Wählen Sie die Methode, die Ihren Sicherheitsanforderungen am besten entspricht.

117 117 

118**Option A: API-Schlüssel-Authentifizierung**118**Option A: API-Schlüssel-Authentifizierung**

119 119 


128 128 

129**Option B: Microsoft Entra ID-Authentifizierung**129**Option B: Microsoft Entra ID-Authentifizierung**

130 130 

131Wenn `ANTHROPIC_FOUNDRY_API_KEY` nicht gesetzt ist, verwendet Claude Code automatisch die Azure SDK [Standard-Anmeldekette](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview).131Wenn weder `ANTHROPIC_FOUNDRY_API_KEY` noch `ANTHROPIC_FOUNDRY_AUTH_TOKEN` gesetzt ist, verwendet Claude Code automatisch die Azure SDK [Standard-Anmeldekette](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview).

132Dies unterstützt eine Vielzahl von Methoden zur Authentifizierung lokaler und Remote-Workloads.132Dies unterstützt eine Vielzahl von Methoden zur Authentifizierung lokaler und Remote-Workloads.

133 133 

134In lokalen Umgebungen können Sie häufig die Azure CLI verwenden:134In lokalen Umgebungen können Sie häufig die Azure CLI verwenden:


137az login137az login

138```138```

139 139 

140**Option C: Bearer-Token-Authentifizierung**

141 

142{/* min-version: 2.1.203 */}Claude Code sendet den Wert von `ANTHROPIC_FOUNDRY_AUTH_TOKEN` bei jeder Anfrage als `Authorization: Bearer`-Header. Verwenden Sie diese Option, wenn ein anderer Prozess, z. B. eine Host-Anwendung oder ein Anmeldeskript, bereits ein Zugriffstoken für Sie erhalten hat. Erfordert Claude Code v2.1.203 oder später.

143 

144Legen Sie die Variable auf ein Bearer-Token fest, das Microsoft Entra ID für Ihre Ressource ausgestellt hat:

145 

146```bash theme={null}

147export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

148```

149 

150`ANTHROPIC_FOUNDRY_AUTH_TOKEN` hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY` und vor der Standard-Anmeldekette.

151 

140<Note>152<Note>

141 Bei Verwendung von Microsoft Foundry ist der `/logout`-Befehl nicht verfügbar, da die Authentifizierung über Azure-Anmeldedaten erfolgt.153 Bei Verwendung von Microsoft Foundry ist der `/logout`-Befehl nicht verfügbar, da die Authentifizierung über Azure-Anmeldedaten erfolgt.

142</Note>154</Note>


162</h3>174</h3>

163 175 

164<Warning>176<Warning>

165 Fixieren Sie spezifische Modellversionen für jede Bereitstellung. Ohne Fixierung werden Modellaliase wie `sonnet` und `opus` zu Claude Codes integriertem Standard für Foundry aufgelöst, der hinter der neuesten Version zurückbleiben kann und möglicherweise noch nicht in Ihrem Konto verfügbar ist. Foundry hat keine Startup-Modellprüfung, daher schlagen Anfragen fehl, wenn der Standard nicht verfügbar ist. Wenn Sie Azure-Bereitstellungen erstellen, wählen Sie eine spezifische Modellversion anstelle von „automatisch auf die neueste Version aktualisieren".177 Fixieren Sie spezifische Modellversionen für jede Bereitstellung. Ohne Fixierung werden Modellaliase wie `sonnet` und `opus` zu Claude Codes integriertem Standard für Microsoft Foundry aufgelöst, der hinter der neuesten Version zurückbleiben kann und möglicherweise noch nicht in Ihrem Konto verfügbar ist. Microsoft Foundry hat keine Startup-Modellprüfung, daher schlagen Anfragen fehl, wenn der Standard nicht verfügbar ist. Wenn Sie Azure-Bereitstellungen erstellen, wählen Sie eine spezifische Modellversion anstelle von „automatisch auf die neueste Version aktualisieren".

166</Warning>178</Warning>

167 179 

168Legen Sie die Modellvariablen so fest, dass sie den Bereitstellungsnamen entsprechen, die Sie in Schritt 1 erstellt haben.180Legen Sie die Modellvariablen so fest, dass sie den Bereitstellungsnamen entsprechen, die Sie in Schritt 1 erstellt haben.

169 181 

170Ohne `ANTHROPIC_DEFAULT_OPUS_MODEL` wird der `opus`-Alias auf Foundry zu Opus 4.6 aufgelöst. Legen Sie ihn auf die Opus 4.8-ID fest, um das neueste Modell zu verwenden:182Ohne `ANTHROPIC_DEFAULT_OPUS_MODEL` wird der `opus`-Alias auf Microsoft Foundry zu Opus 4.6 aufgelöst. Legen Sie ihn auf die Opus 4.8-ID fest, um das neueste Modell zu verwenden:

171 183 

172```bash theme={null}184```bash theme={null}

173export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'185export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'


175export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'187export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'

176```188```

177 189 

178Hintergrundaufgaben wie die Generierung von Sitzungstiteln verwenden das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Bei Foundry setzt Claude Code dies standardmäßig auf das primäre Modell, da nicht jedes Konto eine Haiku-Bereitstellung hat. Um Haiku für Hintergrundaufgaben zu verwenden, legen Sie `ANTHROPIC_DEFAULT_HAIKU_MODEL` auf eine Haiku-Bereitstellung fest, die in Ihrem Konto verfügbar ist, wie oben gezeigt.190Hintergrundaufgaben wie die Generierung von Sitzungstiteln verwenden das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Bei Microsoft Foundry setzt Claude Code dies standardmäßig auf das primäre Modell, da nicht jedes Konto eine Haiku-Bereitstellung hat. Um Haiku für Hintergrundaufgaben zu verwenden, legen Sie `ANTHROPIC_DEFAULT_HAIKU_MODEL` auf eine Haiku-Bereitstellung fest, die in Ihrem Konto verfügbar ist, wie oben gezeigt.

179 191 

180Aktuelle und ältere Modell-IDs finden Sie unter [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Siehe [Modellkonfiguration](/de/model-config#pin-models-for-third-party-deployments) für die vollständige Liste der Umgebungsvariablen.192Aktuelle und ältere Modell-IDs finden Sie unter [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Siehe [Modellkonfiguration](/de/model-config#pin-models-for-third-party-deployments) für die vollständige Liste der Umgebungsvariablen.

181 193 


189 5. Claude Code ausführen201 5. Claude Code ausführen

190</h3>202</h3>

191 203 

192Wenn die Umgebungsvariablen gesetzt sind, starten Sie Claude Code aus Ihrem Projektverzeichnis:204Mit den gesetzten Umgebungsvariablen starten Sie Claude Code aus Ihrem Projektverzeichnis:

193 205 

194```bash theme={null}206```bash theme={null}

195claude207claude

196```208```

197 209 

198Claude Code liest `CLAUDE_CODE_USE_FOUNDRY` und die anderen Foundry-Variablen aus der Umgebung und verbindet sich bei der ersten Eingabeaufforderung mit Ihrer Azure-Ressource. Im Gegensatz zu Bedrock und Vertex AI hat Foundry keinen interaktiven Setup-Assistenten, daher sind die Umgebungsvariablen in den Schritten 3 und 4 der einzige Konfigurationspfad.210Claude Code liest `CLAUDE_CODE_USE_FOUNDRY` und die anderen Microsoft Foundry-Variablen aus der Umgebung und verbindet sich bei der ersten Eingabeaufforderung mit Ihrer Azure-Ressource. Im Gegensatz zu Amazon Bedrock und Google Cloud's Agent Platform hat Microsoft Foundry keinen interaktiven Setup-Assistenten, daher sind die Umgebungsvariablen in den Schritten 3 und 4 der einzige Konfigurationspfad.

199 211 

200<h2 id="azure-rbac-configuration">212<h2 id="azure-rbac-configuration">

201 Azure RBAC-Konfiguration213 Azure RBAC-Konfiguration

model-config.md +88 −33

Details

15* Einen **Modellalias**15* Einen **Modellalias**

16* Einen **Modellnamen**16* Einen **Modellnamen**

17 * Anthropic API: Einen vollständigen **[Modellnamen](https://platform.claude.com/docs/de/about-claude/models/overview)**17 * Anthropic API: Einen vollständigen **[Modellnamen](https://platform.claude.com/docs/de/about-claude/models/overview)**

18 * Bedrock: ein Inference-Profil-ARN18 * Amazon Bedrock: ein Inference-Profil-ARN

19 * Foundry: einen Bereitstellungsnamen19 * Microsoft Foundry: einen Bereitstellungsnamen

20 * Vertex: einen Versionsnamen20 * Google Cloud's Agent Platform: einen Versionsnamen

21 21 

22<Note>22<Note>

23 `ANTHROPIC_BASE_URL` ändert, wohin Anfragen gesendet werden, nicht welches Modell sie beantwortet. Um Claude durch ein LLM-Gateway zu leiten, siehe [LLM-Gateways](/de/llm-gateway).23 `ANTHROPIC_BASE_URL` ändert, wohin Anfragen gesendet werden, nicht welches Modell sie beantwortet. Um Claude durch ein LLM-Gateway zu leiten, siehe [LLM-Gateways](/de/llm-gateway).


41| **`opus[1m]`** | Verwendet Opus mit einem [1-Million-Token-Kontextfenster](https://platform.claude.com/docs/de/build-with-claude/context-windows#1m-token-context-window) für lange Sitzungen |41| **`opus[1m]`** | Verwendet Opus mit einem [1-Million-Token-Kontextfenster](https://platform.claude.com/docs/de/build-with-claude/context-windows#1m-token-context-window) für lange Sitzungen |

42| **`opusplan`** | Spezieller Modus, der `opus` während des Plan Mode verwendet und dann zu `sonnet` für die Ausführung wechselt |42| **`opusplan`** | Spezieller Modus, der `opus` während des Plan Mode verwendet und dann zu `sonnet` für die Ausführung wechselt |

43 43 

44Bei der Anthropic API wird `opus` zu Opus 4.8 und `sonnet` zu Sonnet 5 aufgelöst. Bei [Claude Platform on AWS](/de/claude-platform-on-aws) wird `opus` zu Opus 4.7 und `sonnet` zu Sonnet 4.6 aufgelöst. Bei Bedrock, Vertex und Foundry wird `opus` zu Opus 4.6 und `sonnet` zu Sonnet 4.5 aufgelöst; neuere Modelle sind bei diesen Anbietern verfügbar, indem Sie den vollständigen Modellnamen explizit auswählen oder `ANTHROPIC_DEFAULT_OPUS_MODEL` oder `ANTHROPIC_DEFAULT_SONNET_MODEL` setzen.44Bei der Anthropic API wird `opus` zu Opus 4.8 und `sonnet` zu Sonnet 5 aufgelöst. Bei [Claude Platform on AWS](/de/claude-platform-on-aws) wird `opus` zu Opus 4.7 und `sonnet` zu Sonnet 4.6 aufgelöst. Bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry wird `opus` zu Opus 4.6 und `sonnet` zu Sonnet 4.5 aufgelöst; neuere Modelle sind bei diesen Anbietern verfügbar, indem Sie den vollständigen Modellnamen explizit auswählen oder `ANTHROPIC_DEFAULT_OPUS_MODEL` oder `ANTHROPIC_DEFAULT_SONNET_MODEL` setzen.

45 45 

46Aliase 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-4-8`, oder setzen Sie die entsprechende Umgebungsvariable wie `ANTHROPIC_DEFAULT_OPUS_MODEL`.46Aliase 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-4-8`, oder setzen Sie die entsprechende Umgebungsvariable wie `ANTHROPIC_DEFAULT_OPUS_MODEL`.

47 47 


84* `Enter`: Modell wechseln und als Standard speichern84* `Enter`: Modell wechseln und als Standard speichern

85* `s`: Modell nur für diese Sitzung wechseln85* `s`: Modell nur für diese Sitzung wechseln

86 86 

87Die direkte Eingabe von `/model <name>` verhält sich wie `Enter`. Projekt- und verwaltete Einstellungen haben weiterhin Vorrang und werden beim nächsten Start erneut angewendet. {/* min-version: 2.1.196 */}Ein [Organisationsstandardmodell](#organization-default-model), das Ihr Administrator konfiguriert hat, um die Benutzerauswahl zu überschreiben, wird auch beim nächsten Start erneut angewendet.87Die direkte Eingabe von `/model <name>` verhält sich wie `Enter`. {/* min-version: 2.1.205 */}Ein Modell, das mit `/model` im [nicht-interaktiven Modus](/de/headless) mit dem `-p`-Flag gesetzt wird, gilt nur für die aktuelle Sitzung und wird nicht als Standard gespeichert. Projekt- und verwaltete Einstellungen haben weiterhin Vorrang und werden beim nächsten Start erneut angewendet. {/* min-version: 2.1.196 */}Ein [Organisationsstandardmodell](#organization-default-model), das Ihr Administrator konfiguriert hat, um die Benutzerauswahl zu überschreiben, wird auch beim nächsten Start erneut angewendet.

88 88 

89In v2.1.144 bis v2.1.152 galt `/model` nur für die aktuelle Sitzung und `d` in der Auswahl speicherte einen Standard.89In v2.1.144 bis v2.1.152 galt `/model` nur für die aktuelle Sitzung und `d` in der Auswahl speicherte einen Standard.

90 90 


96 96 

97Wenn das aktive Modell beim Start aus Projekt- oder verwalteten Einstellungen stammt und nicht aus Ihrer eigenen Auswahl, zeigt der Startheader an, welche Einstellungsdatei es festgelegt hat. Führen Sie `/model` aus, um es zu überschreiben; die Projekt- oder verwaltete Einstellung wird beim nächsten Start erneut angewendet.97Wenn das aktive Modell beim Start aus Projekt- oder verwalteten Einstellungen stammt und nicht aus Ihrer eigenen Auswahl, zeigt der Startheader an, welche Einstellungsdatei es festgelegt hat. Führen Sie `/model` aus, um es zu überschreiben; die Projekt- oder verwaltete Einstellung wird beim nächsten Start erneut angewendet.

98 98 

99Wenn ein Modellwechsel durch die [Agent SDK](/de/agent-sdk/overview) `setModel()`-Methode oder durch eine App wie die [Desktop-App](/de/desktop), die die Claude Code CLI für Sie ausführt, angefordert wird, überprüft Claude Code, dass die Zeichenkette eine ist, die es erkennt, bevor es sie speichert. Diese Überprüfung erfordert Claude Code v2.1.200 oder später. Bei der Anthropic API erkennt Claude Code:

100 

101* einen Modellalias

102* einen Eintrag aus der `/model`-Auswahl

103* jeden Namen, der mit `claude-` beginnt

104* einen Wert, den Sie selbst als [benutzerdefinierte Modelloption](#add-a-custom-model-option) oder in [`modelOverrides`](#override-model-ids-per-version) konfiguriert haben

105 

106Claude Code lehnt eine unbekannte Zeichenkette mit `Model "<name>" is not a recognized model id.` ab und die Sitzung behält ihr aktuelles Modell bei, anstatt die Zeichenkette zu speichern und beim nächsten Request zu fehlschlagen. Siehe [die Fehlerreferenz](/de/errors#model-is-not-a-recognized-model-id) für Wiederherstellungsschritte.

107 

108Die Überprüfung wird nur bei der Anthropic API durchgeführt. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/de/claude-platform-on-aws) und hinter einem [LLM-Gateway](/de/llm-gateway) oder einem benutzerdefinierten `ANTHROPIC_BASE_URL` definiert Ihr Anbieter oder Gateway die Modellnamen, daher leitet Claude Code jede Zeichenkette ohne Überprüfung durch. Die Überprü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](/de/errors#there%E2%80%99s-an-issue-with-the-selected-model) beim ersten Request statt.

109 

99Wenn das angeforderte Modell ein geplantes Ruhestandsdatum hat oder automatisch auf eine neuere Version neu zugeordnet wird, zeigt Claude Code eine Warnung an, die das angeforderte Modell benennt. Interaktive Sitzungen zeigen es als Startnachricht an. Ab v2.1.182 wird die gleiche Warnung in [nicht-interaktivem Modus](/de/headless) auf stderr geschrieben, wenn das Standard-Textausgabeformat verwendet wird. Die Überprüfung deckt auch ein `model` ab, das in [Subagent-Frontmatter](/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](/de/headless#get-structured-output).110Wenn das angeforderte Modell ein geplantes Ruhestandsdatum hat oder automatisch auf eine neuere Version neu zugeordnet wird, zeigt Claude Code eine Warnung an, die das angeforderte Modell benennt. Interaktive Sitzungen zeigen es als Startnachricht an. Ab v2.1.182 wird die gleiche Warnung in [nicht-interaktivem Modus](/de/headless) auf stderr geschrieben, wenn das Standard-Textausgabeformat verwendet wird. Die Überprüfung deckt auch ein `model` ab, das in [Subagent-Frontmatter](/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](/de/headless#get-structured-output).

100 111 

101Beispielverwendung:112Beispielverwendung:


135* **Advisor-Modell**: die konfigurierte [`advisorModel`](/de/advisor)-Einstellung und das `--advisor`-Flag146* **Advisor-Modell**: die konfigurierte [`advisorModel`](/de/advisor)-Einstellung und das `--advisor`-Flag

136* **Hintergrund-Agent-Modell**: das Modell, das in der [Dispatch-Auswahl](/de/agent-view) ausgewählt ist147* **Hintergrund-Agent-Modell**: das Modell, das in der [Dispatch-Auswahl](/de/agent-view) ausgewählt ist

137 148 

138Das Wechseln zu einem blockierten Modell mit `/model` wird mit einem Fehler abgelehnt, während ein blockiertes `--model`-Flag, `ANTHROPIC_MODEL` oder `model`-Einstellungswert beim Start mit einer Warnung ersetzt wird, die sowohl das angeforderte als auch das ersetzte Modell benennt, und die Sitzung startet auf dem Standardmodell. Ein blockierter Subagent-, Skill- oder Befehl-Override fällt auf das geerbte oder Standardmodell zurück, anstatt die Anfrage fehlschlagen zu lassen; eine blockierte `advisorModel`-Einstellung deaktiviert den Advisor für die Sitzung, während ein blockiertes `--advisor`-Flag-Wert beim Start mit einem Fehler beendet wird. Ausgeschlossene Modelle sind in der `/model`-Auswahl verborgen. {/* min-version: 2.1.199 */}Ab v2.1.199 erscheint eine vollständige Modell-ID in der Liste, die keine integrierte Picker-Zeile hat, wie eine ältere Version, die die Liste fixiert, in der `/model`-Auswahl als eigene beschriftete Zeile. In früheren Versionen ist eine solche ID nur durch Eingabe von `/model <id>` auswählbar.149Auf der Anthropic API und [Claude Platform auf AWS](/de/claude-platform-on-aws) wird ein Modellfamilien-Alias, `opus`, `sonnet`, `haiku` oder `fable`, zur neuesten Version seiner Familie aufgelöst, die die Zulassungsliste zulässt. Wenn die Zulassungsliste bestimmte Versionen fixiert, beispielsweise `["sonnet", "claude-opus-4-6"]`, wählen sowohl `/model opus` als auch `--model opus` Claude Opus 4.6, die neueste zulässige Opus-Version, und zeigen eine Mitteilung an, die sowohl das angeforderte als auch das ersetzte Modell benennt. Vor v2.1.205 wurde ein Alias, dessen neueste veröffentlichte Version außerhalb der Liste lag, wie jede andere blockierte Auswahl abgelehnt oder ersetzt, auch wenn die Liste eine ältere Version zulässig machte.

150 

151Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und [Mantle](/de/amazon-bedrock#use-the-mantle-endpoint) verwenden anbieterspezifische Bereitstellungs-IDs anstelle von Anthropic-Modell-IDs, daher folgt ein blockierter Alias dort dem Ablehnungs- und Ersetzungsverhalten unten.

139 152 

140Automatische Modellwechsel werden auf die gleiche Weise überprüft: Elemente einer [Fallback-Modellkette](#fallback-model-chains) außerhalb der Zulassungsliste werden gelöscht, ein Plan-Modus-Upgrade wie [`opusplan`](#opusplan-model-setting) zu einem ausgeschlossenen Modell wird übersprungen, sodass die Planung auf dem Sitzungsmodell fortgesetzt wird, und ein [automatisches Modell-Fallback](#automatic-model-fallback), dessen Ziel ausgeschlossen ist, wird nicht ausgeführt, sodass die gekennzeichnete Anfrage stattdessen mit einer Ablehnung endet. Das Aktivieren des [Schnellmodus](/de/fast-mode) wird abgelehnt, wenn das Modell, auf dem die Sitzung danach ausgeführt würde, außerhalb der Zulassungsliste liegt.153Claude Code behandelt jede andere blockierte Auswahl je nachdem, wo das Modell gesetzt wurde:

154 

155* **`/model`**: der Wechsel wird mit einem Fehler abgelehnt

156* **`--model`-Flag, `ANTHROPIC_MODEL` oder die `model`-Einstellung**: der Wert wird beim Start mit einer Warnung ersetzt, die sowohl das angeforderte als auch das ersetzte Modell benennt, und die Sitzung startet auf dem Standardmodell

157* **Subagent-, Skill- oder Befehl-Override**: der Override fällt auf das geerbte oder Standardmodell zurück, anstatt die Anfrage fehlschlagen zu lassen

158* **`advisorModel`-Einstellung**: der Advisor wird für die Sitzung deaktiviert

159* **`--advisor`-Flag**: Claude Code beendet sich beim Start mit einem Fehler

160 

161Ausgeschlossene Modelle sind in der `/model`-Auswahl verborgen. {/* min-version: 2.1.199 */}Eine vollständige Modell-ID in der Liste, die keine integrierte Picker-Zeile hat, wie eine ältere Version, die die Liste fixiert, erscheint in der `/model`-Auswahl als eigene beschriftete Zeile. Vor v2.1.199 war eine solche ID nur durch Eingabe von `/model <id>` auswählbar.

162 

163Modellwechsel, die Claude Code in Ihrem Namen vornimmt, werden auf die gleiche Weise überprüft:

164 

165* **[Fallback-Modellketten](#fallback-model-chains)**: Elemente außerhalb der Zulassungsliste werden gelöscht

166* **Plan-Modus-Upgrades**: auf der Anthropic API und Claude Platform auf AWS verwendet ein Upgrade wie [`opusplan`](#opusplan-model-setting) zu einem ausgeschlossenen Modell die neueste zulässige Version der Upgrade-Familie. Bei Anbietern mit anbieterspezifischen Modell-IDs und wenn keine Version zulässig ist, wird das Upgrade übersprungen und die Planung wird auf dem Sitzungsmodell fortgesetzt

167* **[Automatisches Modell-Fallback](#automatic-model-fallback)**: ein Fallback, dessen Ziel ausgeschlossen ist, wird nicht ausgeführt, daher endet die gekennzeichnete Anfrage mit einer Ablehnung statt

168* **[Schnellmodus](/de/fast-mode)**: das Aktivieren des Schnellmodus wird abgelehnt, wenn das Modell, auf dem die Sitzung danach ausgeführt würde, außerhalb der Zulassungsliste liegt

141 169 

142```json theme={null}170```json theme={null}

143{171{


158 186 

159* Cloud-Sitzungen auf [Claude Code im Web](/de/claude-code-on-the-web) oder in der Desktop-App werden auf von Anthropic verwalteten VMs ausgeführt: Einstellungen, die auf Ihrem Gerät bereitgestellt werden, erreichen sie nicht, daher stellen Sie die Zulassungsliste über serververwaltete Einstellungen bereit. Ein Modellwechsel während einer Sitzung in einer Cloud-Sitzung wird abgelehnt, wenn das angeforderte Modell durch die Zulassungsliste ausgeschlossen ist. Die serverseitige Ablehnung bei der Sitzungserstellung gilt für [Organisationsmodellbeschränkungen](#organization-model-restrictions), nicht für den `availableModels`-Einstellungsschlüssel.187* Cloud-Sitzungen auf [Claude Code im Web](/de/claude-code-on-the-web) oder in der Desktop-App werden auf von Anthropic verwalteten VMs ausgeführt: Einstellungen, die auf Ihrem Gerät bereitgestellt werden, erreichen sie nicht, daher stellen Sie die Zulassungsliste über serververwaltete Einstellungen bereit. Ein Modellwechsel während einer Sitzung in einer Cloud-Sitzung wird abgelehnt, wenn das angeforderte Modell durch die Zulassungsliste ausgeschlossen ist. Die serverseitige Ablehnung bei der Sitzungserstellung gilt für [Organisationsmodellbeschränkungen](#organization-model-restrictions), nicht für den `availableModels`-Einstellungsschlüssel.

160* Cowork, die agentengesteuerte Arbeitsregisterkarte in der Claude Desktop-App, ist keine Claude Code-Oberfläche und erhält serververwaltete Einstellungen nicht absichtlich. Eine verwaltete Einstellungsdatei gilt für Cowork-Sitzungen, wenn sie dort vorhanden ist, wo die Sitzung ausgeführt wird; Remote-Cowork-Sitzungen werden auf von Anthropic verwalteten VMs ausgeführt, wo eine gerätebereits bereitgestellte Datei nicht vorhanden ist.188* Cowork, die agentengesteuerte Arbeitsregisterkarte in der Claude Desktop-App, ist keine Claude Code-Oberfläche und erhält serververwaltete Einstellungen nicht absichtlich. Eine verwaltete Einstellungsdatei gilt für Cowork-Sitzungen, wenn sie dort vorhanden ist, wo die Sitzung ausgeführt wird; Remote-Cowork-Sitzungen werden auf von Anthropic verwalteten VMs ausgeführt, wo eine gerätebereits bereitgestellte Datei nicht vorhanden ist.

161* Sitzungen auf [Drittanbieter-Anbietern](/de/server-managed-settings#platform-availability) wie Bedrock, Vertex AI, Foundry und [Claude Platform auf AWS](/de/claude-platform-on-aws) erhalten keine serververwalteten Einstellungen, daher stellen Sie die Zulassungsliste dort über MDM oder verwaltete Einstellungsdateien bereit.189* Sitzungen auf [Drittanbieter-Anbietern](/de/server-managed-settings#platform-availability) wie Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und [Claude Platform auf AWS](/de/claude-platform-on-aws) erhalten keine serververwalteten Einstellungen, daher stellen Sie die Zulassungsliste dort über MDM oder verwaltete Einstellungsdateien bereit.

162* Die serververwaltete Bereitstellung erfordert auch, dass sich die Sitzung mit einem Organisationslogin oder einem direkt konfigurierten API-Schlüssel authentifiziert. Flotten, die Schlüssel nur über ein [`apiKeyHelper`](/de/settings#available-settings)-Skript generieren, sollten die Zulassungsliste über MDM oder verwaltete Einstellungsdateien bereitstellen.190* Die serververwaltete Bereitstellung erfordert auch, dass sich die Sitzung mit einem Organisationslogin oder einem direkt konfigurierten API-Schlüssel authentifiziert. Flotten, die Schlüssel nur über ein [`apiKeyHelper`](/de/settings#available-settings)-Skript generieren, sollten die Zulassungsliste über MDM oder verwaltete Einstellungsdateien bereitstellen.

163* Die Desktop Code-Registerkarte hostet auch [SSH-Sitzungen](/de/desktop#ssh-sessions), die die verwaltete Einstellungsdatei vom Remote-Host lesen, auf dem sie ausgeführt werden. Siehe [Desktop-verwaltete Einstellungen](/de/desktop#managed-settings).191* Die Desktop Code-Registerkarte hostet auch [SSH-Sitzungen](/de/desktop#ssh-sessions), die die verwaltete Einstellungsdatei vom Remote-Host lesen, auf dem sie ausgeführt werden. Siehe [Desktop-verwaltete Einstellungen](/de/desktop#managed-settings).

164* Die Modellauswahl auf claude.ai und in der Desktop-App verbergen oder graut Modelle aus, die durch die Zulassungsliste Ihrer Organisation ausgeschlossen sind. Der Auswahlzustand ist eine Annehmlichkeit für Benutzer; die Erzwingung erfolgt in der Sitzung.192* Die Modellauswahl auf claude.ai und in der Desktop-App verbergen oder graut Modelle aus, die durch die Zulassungsliste Ihrer Organisation ausgeschlossen sind. Der Auswahlzustand ist eine Annehmlichkeit für Benutzer; die Erzwingung erfolgt in der Sitzung.


167 Standardmodell-Verhalten195 Standardmodell-Verhalten

168</h3>196</h3>

169 197 

170Die Option „Standard" in der Modellauswahl wird nicht von `availableModels` beeinflusst, es sei denn, [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) ist auch gesetzt. Allein lässt `availableModels` „Standard" verfügbar, das sich zum Laufzeit-Standard des Systems auflöst, [basierend auf dem Abonnement-Tier des Benutzers](#default-model-setting). Wenn der Tier-Standard ein Modell ist, das Sie einschränken möchten, setzen Sie auch `enforceAvailableModels`.198Die Option „Standard" in der Modellauswahl wird nicht von `availableModels` beeinflusst, es sei denn, [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) ist auch gesetzt. Allein lässt `availableModels` „Standard" verfügbar, das sich zum [Laufzeit-Standard](#default-model-setting) des Systems auflöst. Wenn dieser Standard ein Modell ist, das Sie einschränken möchten, setzen Sie auch `enforceAvailableModels`.

171 199 

172Ein 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.200Ein 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.

173 201 


184}212}

185```213```

186 214 

187Wenn das Standardmodell für den Kontotyp des Benutzers nicht in der Zulassungsliste enthalten ist, wird die Option „Standard" stattdessen auf den ersten `availableModels`-Eintrag aufgelöst, der ein zulässiges, verfügbares Modell benennt, und die Zeile „Standard" der `/model`-Auswahl 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 das Fallback, das verwendet wird, wenn eine ausgeschlossene Auswahl gelöscht wird.215Das Standardmodell wird zum Kontotyp-Standard oder zum [Organisationsstandardmodell](#organization-default-model) aufgelöst, wenn ein Administrator eines festgelegt hat. Wenn dieses Modell nicht in der Zulassungsliste enthalten ist, wird die Option „Standard" stattdessen auf den ersten `availableModels`-Eintrag aufgelöst, der ein zulässiges, verfügbares Modell benennt, und die Zeile „Standard" der `/model`-Auswahl 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 das Fallback, das verwendet wird, wenn eine ausgeschlossene Auswahl gelöscht wird.

188 216 

189`enforceAvailableModels` hat keine Auswirkung, wenn `availableModels` nicht gesetzt oder leer ist: Mit `availableModels: []` bleibt das Standardmodell für den Kontotyp nutzbar, sodass die Einstellung Benutzer nicht aus jedem Modell sperren kann. Wenn `availableModels` nicht leer ist, aber kein Eintrag zu einem zulässigen und verfügbaren Modell aufgelöst wird, wird die Erzwingung herabgestuft und „Standard" fällt auf den Kontotyp-Standard zurück, mit einer Warnung, die nur unter `--debug` sichtbar ist. Behalten Sie mindestens einen garantiert verfügbaren Eintrag in der Liste, um dies zu vermeiden.217`enforceAvailableModels` hat keine Auswirkung, wenn `availableModels` nicht gesetzt oder leer ist: Mit `availableModels: []` bleibt das Standardmodell für den Kontotyp nutzbar, sodass die Einstellung Benutzer nicht aus jedem Modell sperren kann. Wenn `availableModels` nicht leer ist, aber kein Eintrag zu einem zulässigen und verfügbaren Modell aufgelöst wird, wird die Erzwingung herabgestuft und „Standard" fällt auf den Kontotyp-Standard zurück, mit einer Warnung, die nur unter `--debug` sichtbar ist. Behalten Sie mindestens einen garantiert verfügbaren Eintrag in der Liste, um dies zu vermeiden.

190 218 


194 Kontrollieren Sie das Modell, auf dem Benutzer ausgeführt werden222 Kontrollieren Sie das Modell, auf dem Benutzer ausgeführt werden

195</h3>223</h3>

196 224 

197Die `model`-Einstellung ist eine anfängliche Auswahl, keine Erzwingung. Sie legt fest, welches Modell aktiv ist, wenn eine Sitzung startet, aber Benutzer können weiterhin `/model` öffnen und „Standard" auswählen, das sich zum Systemstandard für ihren Tier auflöst, unabhängig davon, was `model` gesetzt ist, es sei denn, [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) leitet es um.225Die `model`-Einstellung ist eine anfängliche Auswahl, keine Erzwingung. Sie legt fest, welches Modell aktiv ist, wenn eine Sitzung startet, aber Benutzer können weiterhin `/model` öffnen und „Standard" auswählen, das sich zum [Laufzeit-Standard](#default-model-setting) des Systems auflöst, unabhängig davon, was `model` gesetzt ist, es sei denn, [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) leitet es um.

198 226 

199Um die Modellerfahrung vollständig zu kontrollieren, kombinieren Sie diese Einstellungen:227Um die Modellerfahrung vollständig zu kontrollieren, kombinieren Sie diese Einstellungen:

200 228 


230 Mantle-Modell-IDs258 Mantle-Modell-IDs

231</h3>259</h3>

232 260 

233Wenn der [Bedrock Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) aktiviert ist, werden Einträge in `availableModels`, die mit `anthropic.` beginnen, als benutzerdefinierte Optionen zur `/model`-Auswahl hinzugefügt und zum Mantle-Endpunkt weitergeleitet. Dies ist eine Ausnahme zu der in [Modelle für Drittanbieter-Bereitstellungen fixieren](#pin-models-for-third-party-deployments) beschriebenen Alias-Zuordnung. Die Einstellung schränkt die Auswahl weiterhin auf aufgelistete Einträge ein, und eine Mantle-ID enthält einen Familiennamen, daher zählt sie als spezifischer Eintrag und deaktiviert den Wildcard dieser Familie: Führen Sie zusammen mit allen Mantle-IDs die Versionspräfixe oder vollständigen IDs auf, die Sie selektierbar halten möchten. Siehe [Merge-Verhalten](#merge-behavior).261Wenn der [Amazon Bedrock Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) aktiviert ist, werden Einträge in `availableModels`, die mit `anthropic.` beginnen, als benutzerdefinierte Optionen zur `/model`-Auswahl hinzugefügt und zum Mantle-Endpunkt weitergeleitet. Dies ist eine Ausnahme zu der in [Modelle für Drittanbieter-Bereitstellungen fixieren](#pin-models-for-third-party-deployments) beschriebenen Alias-Zuordnung. Die Einstellung schränkt die Auswahl weiterhin auf aufgelistete Einträge ein, und eine Mantle-ID enthält einen Familiennamen, daher zählt sie als spezifischer Eintrag und deaktiviert den Wildcard dieser Familie: Führen Sie zusammen mit allen Mantle-IDs die Versionspräfixe oder vollständigen IDs auf, die Sie selektierbar halten möchten. Siehe [Merge-Verhalten](#merge-behavior).

234 262 

235<h3 id="organization-model-restrictions">263<h3 id="organization-model-restrictions">

236 Organisationsmodellbeschränkungen264 Organisationsmodellbeschränkungen


244 272 

245Ein eingeschränktes Modell ist in der `/model`-Auswahl verborgen. Die Auswahl nach Name mit `--model`, der `ANTHROPIC_MODEL`-Umgebungsvariable oder der `model`-Einstellung zeigt die Mitteilung `Model "<name>" is restricted by your organization's settings. Using <model> instead.` und die Sitzung startet auf einem zulässigen Modell. Die Eingabe von `/model <name>` für ein eingeschränktes Modell wird mit `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` abgelehnt und die Sitzung behält ihr aktuelles Modell.273Ein eingeschränktes Modell ist in der `/model`-Auswahl verborgen. Die Auswahl nach Name mit `--model`, der `ANTHROPIC_MODEL`-Umgebungsvariable oder der `model`-Einstellung zeigt die Mitteilung `Model "<name>" is restricted by your organization's settings. Using <model> instead.` und die Sitzung startet auf einem zulässigen Modell. Die Eingabe von `/model <name>` für ein eingeschränktes Modell wird mit `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` abgelehnt und die Sitzung behält ihr aktuelles Modell.

246 274 

247Die beiden Mechanismen setzen sich zusammen: Ein Modell ist nur selektierbar, wenn es durch `availableModels` zulässig ist und nicht durch die Organisation eingeschränkt ist. Organisationsbeschränkungen werden an Sitzungen auf der Anthropic API und [LLM Gateway](/de/llm-gateway)-Bereitstellungen bereitgestellt. Sitzungen auf Bedrock, Vertex AI, Foundry und Claude Platform auf AWS erhalten sie nicht, daher verwenden Sie stattdessen `availableModels` auf diesen Anbietern.275Ein [Modellfamilien-Alias](#restrict-model-selection) wie `opus` wird zur neuesten Version seiner Familie aufgelöst, die die Organisation zulässt, mit der gleichen Ersetzungsmitteilung. `/model <alias>` wird nur abgelehnt, wenn jede Version seiner Familie eingeschränkt ist; ein Alias, der mit `--model`, `ANTHROPIC_MODEL` oder der `model`-Einstellung gesetzt wird, wird beim Start in diesem Fall immer noch ersetzt. Vor v2.1.205 wurde ein Familienalias basierend auf seiner neuesten veröffentlichten Version allein ersetzt oder abgelehnt, auch wenn eine ältere Version zulässig war.

276 

277Beschränkungen gelten organisationsweit oder pro Rolle:

278 

279* Das Deaktivieren eines Modells auf Organisationsebene entfernt es für jedes Mitglied.

280* Rollenbezogener Zugriff gewährt verschiedenen benutzerdefinierten Rollen unterschiedliche Modelle, und ein Mitglied, das mehrere Rollen innehat, kann jedes Modell verwenden, das eine seiner Rollen gewährt.

281* Haiku-Modelle sind immer verfügbar und können nicht deaktiviert werden, daher behält jedes Mitglied mindestens ein nutzbares Modell.

282* Eine Zugriffänderung wird innerhalb von etwa einer Minute bei neuen Anfragen wirksam; die `/model`-Auswahl spiegelt dies wider, wenn eine Sitzung das nächste Mal startet.

283 

284Beide Beschränkungen gelten zusammen: Ein Modell ist nur selektierbar, wenn es durch `availableModels` zulässig ist und nicht durch die Organisation eingeschränkt ist. Organisationsbeschränkungen werden an Sitzungen auf der Anthropic API und [LLM Gateway](/de/llm-gateway)-Bereitstellungen bereitgestellt. Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS erhalten sie nicht, daher verwenden Sie stattdessen `availableModels` auf diesen Anbietern.

248 285 

249<h2 id="organization-default-model">286<h2 id="organization-default-model">

250 Organisationsstandardmodell287 Organisationsstandardmodell


303* **Max, Team Premium, Enterprise Pay-as-you-go und Anthropic API**: Standard ist Opus 4.8340* **Max, Team Premium, Enterprise Pay-as-you-go und Anthropic API**: Standard ist Opus 4.8

304* **Claude Platform auf AWS**: Standard ist Opus 4.7341* **Claude Platform auf AWS**: Standard ist Opus 4.7

305* **Pro, Team Standard und Enterprise-Abonnementplätze**: Standard ist Sonnet 5342* **Pro, Team Standard und Enterprise-Abonnementplätze**: Standard ist Sonnet 5

306* **Bedrock, Vertex und Foundry**: Standard ist Sonnet 4.5343* **Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry**: Standard ist Sonnet 4.5

307 344 

308Enterprise Pay-as-you-go bedeutet eine Enterprise-Organisation, die nach Nutzung statt nach Abonnementplatz abgerechnet wird.345Enterprise Pay-as-you-go bedeutet eine Enterprise-Organisation, die nach Nutzung statt nach Abonnementplatz abgerechnet wird.

309 346 


326 363 

327Das Kontextfenster der Plan-Modus-Opus-Phase ist das gleiche wie bei der `opus`-Modelleinstellung. Bei Abonnement-Tiers, bei denen Opus [automatisch auf 1M-Kontext aktualisiert wird](#extended-context), erhält `opusplan` die Aktualisierung auch im Plan-Modus. Um 1M-Kontext für beide Phasen zu erzwingen, wenn Sie sich nicht auf einem Auto-Upgrade-Tier befinden, setzen Sie das Modell auf `opusplan[1m]`.364Das Kontextfenster der Plan-Modus-Opus-Phase ist das gleiche wie bei der `opus`-Modelleinstellung. Bei Abonnement-Tiers, bei denen Opus [automatisch auf 1M-Kontext aktualisiert wird](#extended-context), erhält `opusplan` die Aktualisierung auch im Plan-Modus. Um 1M-Kontext für beide Phasen zu erzwingen, wenn Sie sich nicht auf einem Auto-Upgrade-Tier befinden, setzen Sie das Modell auf `opusplan[1m]`.

328 365 

329Wenn [`availableModels`](#restrict-model-selection) Opus ausschließt, bleibt `opusplan` im Plan-Modus auf Sonnet, anstatt zu wechseln. Ähnlich bleibt eine Haiku-Sitzung, die normalerweise im Plan-Modus zu Sonnet aktualisiert würde, auf Haiku, wenn Sonnet ausgeschlossen ist.366Wenn [`availableModels`](#restrict-model-selection) das neueste Opus ausschließt, aber eine ältere Version erlaubt, z. B. `["sonnet", "claude-opus-4-6"]`, verwendet `opusplan` das neueste erlaubte Opus für die Planung und bleibt nur auf Sonnet, wenn jedes Opus ausgeschlossen ist. Eine Haiku-Sitzung, die normalerweise im Plan-Modus zu Sonnet aktualisiert würde, verwendet ebenfalls das neueste erlaubte Sonnet und bleibt nur auf Haiku, wenn jedes Sonnet ausgeschlossen ist. Vor v2.1.205 blieb der Plan-Modus auf dem Modell der Sitzung, wenn die neueste Version der Upgrade-Familie ausgeschlossen war, auch wenn die Zulassungsliste eine ältere erlaubte.

367 

368Die Substitution einer älteren erlaubten Version gilt auf der Anthropic API und [Claude Platform auf AWS](/de/claude-platform-on-aws). Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Mantle, deren Bereitstellungen anbieter-spezifische Modell-IDs verwenden, bleibt der Plan-Modus auf dem Modell der Sitzung, wenn das Upgrade-Modell ausgeschlossen ist.

330 369 

331Für einen Hybrid-Ansatz, bei dem Claude während einer Aufgabe entscheidet, wann ein zweites Modell konsultiert werden soll, anstatt an der Plan-Grenze zu wechseln, siehe das [Advisor-Tool](/de/advisor).370Für einen Hybrid-Ansatz, bei dem Claude während einer Aufgabe entscheidet, wann ein zweites Modell konsultiert werden soll, anstatt an der Plan-Grenze zu wechseln, siehe das [Advisor-Tool](/de/advisor).

332 371 


392* Im [nicht-interaktiven Modus](/de/cli-reference#cli-flags) und SDK-Integrationen, die den Prompt nicht anzeigen können, endet eine gekennzeichnete Anfrage den Durchgang mit einer Ablehnung.431* Im [nicht-interaktiven Modus](/de/cli-reference#cli-flags) und SDK-Integrationen, die den Prompt nicht anzeigen können, endet eine gekennzeichnete Anfrage den Durchgang mit einer Ablehnung.

393* Wenn das Fallback-Ziel durch [`availableModels`](#restrict-model-selection) blockiert ist, wird der Prompt nicht angezeigt. Die gekennzeichnete Anfrage endet mit der Ablehnung, genauso wie automatisches Fallback, wenn das Ziel blockiert ist.432* Wenn das Fallback-Ziel durch [`availableModels`](#restrict-model-selection) blockiert ist, wird der Prompt nicht angezeigt. Die gekennzeichnete Anfrage endet mit der Ablehnung, genauso wie automatisches Fallback, wenn das Ziel blockiert ist.

394 433 

395<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">434<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

396 Aktivieren Sie Fallback auf Bedrock, Vertex AI und Foundry435 Aktivieren Sie Fallback auf Bedrock, Agent Platform und Foundry

397</h4>436</h4>

398 437 

399Auf [Amazon Bedrock](/de/amazon-bedrock), [Google Vertex AI](/de/google-vertex-ai) und [Microsoft Foundry](/de/microsoft-foundry) sind Modell-IDs anbieter-spezifisch, daher funktioniert automatisches Fallback nur, wenn Claude Code beide beteiligten Modelle identifizieren kann:438Auf [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) und [Microsoft Foundry](/de/microsoft-foundry) sind Modell-IDs anbieter-spezifisch, daher funktioniert automatisches Fallback nur, wenn Claude Code beide beteiligten Modelle identifizieren kann:

400 439 

401* Claude Code muss das aktuelle Modell als Fable 5 erkennen: Die Modell-ID enthält `claude-fable-5`, stimmt mit dem Wert von `ANTHROPIC_DEFAULT_FABLE_MODEL` überein oder ist mit [`modelOverrides`](#override-model-ids-per-version) zugeordnet.440* Claude Code muss das aktuelle Modell als Fable 5 erkennen: Die Modell-ID enthält `claude-fable-5`, stimmt mit dem Wert von `ANTHROPIC_DEFAULT_FABLE_MODEL` überein oder ist mit [`modelOverrides`](#override-model-ids-per-version) zugeordnet.

402* Das Fallback-Ziel muss zu einem Opus-Modell aufgelöst werden: Der Wert von `ANTHROPIC_DEFAULT_OPUS_MODEL`, falls gesetzt, andernfalls ein Opus 4.8-Eintrag in der Modellliste des Anbieters.441* Das Fallback-Ziel muss zu einem Opus-Modell aufgelöst werden: Der Wert von `ANTHROPIC_DEFAULT_OPUS_MODEL`, falls gesetzt, andernfalls ein Opus 4.8-Eintrag in der Modellliste des Anbieters.


429 468 

430Der Standard-Aufwand ist `high` auf Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 und Sonnet 4.6 und `xhigh` auf Opus 4.7.469Der Standard-Aufwand ist `high` auf Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 und Sonnet 4.6 und `xhigh` auf Opus 4.7.

431 470 

432Wenn Sie Fable 5, Opus 4.8 oder Opus 4.7 zum ersten Mal ausführen, wendet Claude Code das Standard-Aufwandsniveau dieses Modells an, auch wenn Sie zuvor ein anderes Niveau für ein anderes Modell gesetzt haben: `high` auf Fable 5 und Opus 4.8 und `xhigh` auf Opus 4.7. Führen Sie `/effort` erneut aus, um nach dem Wechsel ein anderes Niveau zu wählen.471Wenn Sie Fable 5, Opus 4.8 oder Opus 4.7 zum ersten Mal ausführen, wendet Claude Code das Standard-Aufwandsniveau dieses Modells an, auch wenn Sie zuvor ein anderes Niveau für ein anderes Modell gesetzt haben: `high` auf Fable 5 und Opus 4.8 und `xhigh` auf Opus 4.7. Führen Sie `/effort` erneut aus, um nach dem Wechsel ein anderes Niveau zu wählen. Dieser Standard wird über Sitzungen hinweg beibehalten, bis Sie eine explizite Aufwandsauswahl treffen, z. B. durch Ausführen von `/effort` in einer interaktiven Sitzung oder Starten mit `--effort`.

472 

473`low`, `medium`, `high` und `xhigh` bleiben über Sitzungen hinweg erhalten, wenn Sie sie in einer interaktiven Sitzung setzen. {/* min-version: 2.1.205 */}Ein Niveau, das mit `/effort` im [nicht-interaktiven Modus](/de/headless) mit dem `-p`-Flag gesetzt wird, gilt nur für die aktuelle Sitzung und wird nicht als Ihr Standard gespeichert. Ein nicht-interaktives `/effort` kann auch die Modell-Standard-Sperre oben nicht freigeben: Bei Fable 5, Opus 4.8 und Opus 4.7 meldet es `Not applied` und die Sitzung bleibt beim Standard-Aufwand des Modells, daher übergeben Sie stattdessen `--effort` beim Start. `max` bietet das tiefste Reasoning ohne Einschränkung bei der Token-Ausgabe und gilt nur für die aktuelle Sitzung, außer wenn es über die `CLAUDE_CODE_EFFORT_LEVEL`-Umgebungsvariable gesetzt wird.

474 

475Das `/effort`-Menü bietet auch `ultracode`. Ultracode ist eine Claude Code-Einstellung und keine Modell-Aufwandsebene: Es sendet `xhigh` an das Modell und lässt Claude zusätzlich [dynamische Workflows](/de/workflows) für substantielle Aufgaben orchestrieren. Es gilt nur für die aktuelle Sitzung.

433 476 

434`low`, `medium`, `high` und `xhigh` bleiben über Sitzungen hinweg erhalten. `max` bietet das tiefste Reasoning ohne Einschränkung bei der Token-Ausgabe und gilt nur für die aktuelle Sitzung, außer wenn es über die `CLAUDE_CODE_EFFORT_LEVEL`-Umgebungsvariable gesetzt wird.477Sie können Ultracode durch eine der folgenden Methoden aktivieren:

435 478 

436Das `/effort`-Menü bietet auch `ultracode`. Ultracode ist eine Claude Code-Einstellung und keine Modell-Aufwandsebene: Es sendet `xhigh` an das Modell und lässt Claude zusätzlich [dynamische Workflows](/de/workflows) für substantielle Aufgaben orchestrieren. Es gilt nur für die aktuelle Sitzung. Setzen Sie es über `/effort` oder übergeben Sie `"ultracode": true` über `--settings` oder eine Agent SDK-Steueranforderung. Es ist nicht Teil der `effortLevel`-Einstellung, des `--effort`-Flags oder `CLAUDE_CODE_EFFORT_LEVEL`.479* **`/effort`**: Führen Sie `/effort ultracode` aus oder wählen Sie es aus dem Menü

480* **`--effort`-Flag**: Starten Sie mit `claude --effort ultracode`, das die Sitzung mit `xhigh`-Aufwand und aktiviertem Ultracode startet

481* **`--settings` oder eine Agent SDK-Steueranforderung**: Übergeben Sie `"ultracode": true`. Eine [`applyFlagSettings()`](/de/agent-sdk/typescript#applyflagsettings)-Anforderung akzeptiert auch `effortLevel: "ultracode"`

482 

483Das Ü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 gab `--effort ultracode` `Unknown --effort value 'ultracode'` aus und die Sitzung startete mit dem Standard-Aufwand.

484 

485Die persistierte `effortLevel`-Einstellung und die `CLAUDE_CODE_EFFORT_LEVEL`-Umgebungsvariable akzeptieren nicht `ultracode`.

486 

487Wenn Ultracode nicht verfügbar ist, z. B. wenn [Workflows ausgeschaltet sind](/de/workflows#turn-workflows-off), setzt `--effort ultracode` nur `xhigh`-Aufwand.

437 488 

438<h4 id="choose-an-effort-level">489<h4 id="choose-an-effort-level">

439 Wählen Sie ein Aufwandsniveau490 Wählen Sie ein Aufwandsniveau


590 Modelle für Drittanbieter-Bereitstellungen fixieren641 Modelle für Drittanbieter-Bereitstellungen fixieren

591</h3>642</h3>

592 643 

593Beim Bereitstellen von Claude Code über [Bedrock](/de/amazon-bedrock), [Vertex AI](/de/google-vertex-ai), [Foundry](/de/microsoft-foundry) oder [Claude Platform on AWS](/de/claude-platform-on-aws) sollten Sie Modellversionen vor dem Rollout für Benutzer fixieren.644Beim Bereitstellen von Claude Code über [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry) oder [Claude Platform on AWS](/de/claude-platform-on-aws) sollten Sie Modellversionen vor dem Rollout für Benutzer fixieren.

594 645 

595Ohne Fixierung verwendet Claude Code Modellaliase wie `fable`, `opus`, `sonnet` und `haiku`, die zur integrierten Standard-Modell-ID für jeden Anbieter aufgelöst werden. Dieser Standard kann hinter der neuesten Anthropic-Veröffentlichung zurückbleiben, und das Modell, auf das er verweist, ist möglicherweise noch nicht in einem Benutzerkonto aktiviert. Wenn der Standard nicht verfügbar ist, sehen Bedrock- und Vertex AI-Benutzer einen Hinweis und greifen für diese Sitzung auf die vorherige Version zurück, während Foundry-Benutzer Fehler sehen, da Foundry keine entsprechende Startprüfung hat.646Ohne Fixierung verwendet Claude Code Modellaliase wie `fable`, `opus`, `sonnet` und `haiku`, die zur integrierten Standard-Modell-ID für jeden Anbieter aufgelöst werden. Dieser Standard kann hinter der neuesten Anthropic-Veröffentlichung zurückbleiben, und das Modell, auf das er verweist, ist möglicherweise noch nicht in einem Benutzerkonto aktiviert. Wenn der Standard nicht verfügbar ist, sehen Amazon Bedrock- und Google Cloud's Agent Platform-Benutzer einen Hinweis und greifen für diese Sitzung auf die vorherige Version zurück, während Microsoft Foundry-Benutzer Fehler sehen, da Microsoft Foundry keine entsprechende Startprüfung hat.

596 647 

597<Warning>648<Warning>

598 Setzen Sie die Modell-Umgebungsvariablen auf spezifische Versions-IDs als Teil Ihres anfänglichen Setups. Das Fixieren ermöglicht es Ihnen, zu kontrollieren, wann Ihre Benutzer zu einem neuen Modell wechseln.649 Setzen Sie die Modell-Umgebungsvariablen auf spezifische Versions-IDs als Teil Ihres anfänglichen Setups. Das Fixieren ermöglicht es Ihnen, zu kontrollieren, wann Ihre Benutzer zu einem neuen Modell wechseln.


601Verwenden Sie die folgenden Umgebungsvariablen mit versionsspezifischen Modell-IDs für Ihren Anbieter:652Verwenden Sie die folgenden Umgebungsvariablen mit versionsspezifischen Modell-IDs für Ihren Anbieter:

602 653 

603| Anbieter | Beispiel |654| Anbieter | Beispiel |

604| :-------- | :------------------------------------------------------------------- |655| :---------------------------- | :------------------------------------------------------------------- |

605| Bedrock | `export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` |656| Amazon Bedrock | `export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` |

606| Vertex AI | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |657| Google Cloud's Agent Platform | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

607| Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |658| Microsoft Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

608 659 

609Wenden Sie das gleiche Muster auf `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` und `ANTHROPIC_DEFAULT_HAIKU_MODEL` an. Für aktuelle und ältere Modell-IDs über alle Anbieter hinweg siehe [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Um Benutzer auf eine neue Modellversion zu aktualisieren, aktualisieren Sie diese Umgebungsvariablen und stellen Sie erneut bereit.660Wenden Sie das gleiche Muster auf `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` und `ANTHROPIC_DEFAULT_HAIKU_MODEL` an. Für aktuelle und ältere Modell-IDs über alle Anbieter hinweg siehe [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Um Benutzer auf eine neue Modellversion zu aktualisieren, aktualisieren Sie diese Umgebungsvariablen und stellen Sie erneut bereit.

610 661 


618 669 

619* Claude Code entfernt das Suffix, bevor die Modell-ID an Ihren Anbieter gesendet wird.670* Claude Code entfernt das Suffix, bevor die Modell-ID an Ihren Anbieter gesendet wird.

620* Fügen Sie `[1m]` nur an, wenn das zugrunde liegende Modell [1M-Kontext unterstützt](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window).671* Fügen Sie `[1m]` nur an, wenn das zugrunde liegende Modell [1M-Kontext unterstützt](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window).

621* Das Suffix wird pro Variable gelesen, nicht pro Modell. Bei Bedrock, Vertex und Foundry verwendet eine Modell-ID ohne `[1m]` in einer Variable 200K-Kontext, auch wenn eine andere Variable das gleiche Modell mit dem Suffix setzt. Sonnet 5 wird auf diesen Anbietern immer mit dem 1M-Fenster ausgeführt und benötigt niemals das Suffix.672* Das Suffix wird pro Variable gelesen, nicht pro Modell. Bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry verwendet eine Modell-ID ohne `[1m]` in einer Variable 200K-Kontext, auch wenn eine andere Variable das gleiche Modell mit dem Suffix setzt. Sonnet 5 wird auf diesen Anbietern immer mit dem 1M-Fenster ausgeführt und benötigt niemals das Suffix.

622 673 

623<Note>674<Note>

624 Eine `availableModels`-Zulassungsliste, die über [MDM oder eine verwaltete Einstellungsdatei](/de/settings#settings-files) bereitgestellt wird, gilt weiterhin bei Verwendung von Drittanbieter-Anbietern; [server-verwaltete Einstellungen werden dort nicht bereitgestellt](/de/server-managed-settings#platform-availability). Die Filterung stimmt mit einem Modellalias wie `opus`, einem Versionspräfix wie `claude-opus-4-8` oder der vollständigen Modell-ID in Anbieterform überein. Anbieterspezifische Präfixe wie `us.anthropic.` werden nicht entfernt, daher müssen Sie zum Zulassen eines bestimmten Modells die gleiche Anbieterform-ID auflisten, die die Auswahl anzeigt, oder sie durch [`modelOverrides`](#override-model-ids-per-version) zuordnen. Alle `[1m]`-Suffixe werden sowohl aus dem Zulassungslisten-Eintrag als auch aus dem angeforderten Modell vor dem Abgleich entfernt.675 Eine `availableModels`-Zulassungsliste, die über [MDM oder eine verwaltete Einstellungsdatei](/de/settings#settings-files) bereitgestellt wird, gilt weiterhin bei Verwendung von Drittanbieter-Anbietern; [server-verwaltete Einstellungen werden dort nicht bereitgestellt](/de/server-managed-settings#platform-availability). Die Filterung stimmt mit einem Modellalias wie `opus`, einem Versionspräfix wie `claude-opus-4-8` oder der vollständigen Modell-ID in Anbieterform überein. Anbieterspezifische Präfixe wie `us.anthropic.` werden nicht entfernt, daher müssen Sie zum Zulassen eines bestimmten Modells die gleiche Anbieterform-ID auflisten, die die Auswahl anzeigt, oder sie durch [`modelOverrides`](#override-model-ids-per-version) zuordnen. Alle `[1m]`-Suffixe werden sowohl aus dem Zulassungslisten-Eintrag als auch aus dem angeforderten Modell vor dem Abgleich entfernt.


630 681 

631Wenn Sie ein Modell bei einem Drittanbieter fixieren, erscheint die anbieterspezifische ID in der `/model`-Auswahl und Claude Code erkennt möglicherweise nicht, welche Funktionen das Modell unterstützt. Sie können den Anzeigenamen und die deklarierten Funktionen mit Begleit-Umgebungsvariablen für jedes fixierte Modell überschreiben.682Wenn Sie ein Modell bei einem Drittanbieter fixieren, erscheint die anbieterspezifische ID in der `/model`-Auswahl und Claude Code erkennt möglicherweise nicht, welche Funktionen das Modell unterstützt. Sie können den Anzeigenamen und die deklarierten Funktionen mit Begleit-Umgebungsvariablen für jedes fixierte Modell überschreiben.

632 683 

633Diese Variablen wirken sich auf Drittanbieter wie Bedrock, Vertex AI und Foundry aus. Die Variablen `_NAME` und `_DESCRIPTION` wirken sich auch aus, wenn `ANTHROPIC_BASE_URL` auf ein [LLM-Gateway](/de/llm-gateway) verweist. Sie haben keine Auswirkung bei direkter Verbindung zu `api.anthropic.com`.684Diese Variablen wirken sich auf Drittanbieter wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry aus. Die Variablen `_NAME` und `_DESCRIPTION` wirken sich auch aus, wenn `ANTHROPIC_BASE_URL` auf ein [LLM-Gateway](/de/llm-gateway) verweist. Sie haben keine Auswirkung bei direkter Verbindung zu `api.anthropic.com`.

634 685 

635| Umgebungsvariable | Beschreibung |686| Umgebungsvariable | Beschreibung |

636| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |687| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |


640 691 

641Die gleichen `_NAME`-, `_DESCRIPTION`- und `_SUPPORTED_CAPABILITIES`-Suffixe sind für `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL` und `ANTHROPIC_CUSTOM_MODEL_OPTION` verfügbar.692Die gleichen `_NAME`-, `_DESCRIPTION`- und `_SUPPORTED_CAPABILITIES`-Suffixe sind für `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL` und `ANTHROPIC_CUSTOM_MODEL_OPTION` verfügbar.

642 693 

643Claude Code aktiviert Funktionen wie [Aufwandsniveaus](#adjust-effort-level) und [erweitertes Denken](#extended-thinking) durch Abgleich der Modell-ID mit bekannten Mustern. Anbieterspezifische IDs wie Bedrock-ARNs oder benutzerdefinierte Bereitstellungsnamen stimmen oft nicht mit diesen Mustern überein, wodurch unterstützte Funktionen deaktiviert bleiben. Setzen Sie `_SUPPORTED_CAPABILITIES`, um Claude Code mitzuteilen, welche Funktionen das Modell tatsächlich unterstützt:694Claude Code aktiviert Funktionen wie [Aufwandsniveaus](#adjust-effort-level) und [erweitertes Denken](#extended-thinking) durch Abgleich der Modell-ID mit bekannten Mustern. Anbieterspezifische IDs wie Amazon Bedrock-ARNs oder benutzerdefinierte Bereitstellungsnamen stimmen oft nicht mit diesen Mustern überein, wodurch unterstützte Funktionen deaktiviert bleiben. Setzen Sie `_SUPPORTED_CAPABILITIES`, um Claude Code mitzuteilen, welche Funktionen das Modell tatsächlich unterstützt:

644 695 

645| Funktionswert | Aktiviert |696| Funktionswert | Aktiviert |

646| ---------------------- | -------------------------------------------------------------------------------------------- |697| ---------------------- | -------------------------------------------------------------------------------------------- |


653 704 

654Wenn `_SUPPORTED_CAPABILITIES` gesetzt ist, werden aufgelistete Funktionen aktiviert und nicht aufgelistete Funktionen werden für das entsprechende fixierte Modell deaktiviert. Wenn die Variable nicht gesetzt ist, greift Claude Code auf die integrierte Erkennung basierend auf der Modell-ID zurück.705Wenn `_SUPPORTED_CAPABILITIES` gesetzt ist, werden aufgelistete Funktionen aktiviert und nicht aufgelistete Funktionen werden für das entsprechende fixierte Modell deaktiviert. Wenn die Variable nicht gesetzt ist, greift Claude Code auf die integrierte Erkennung basierend auf der Modell-ID zurück.

655 706 

656Dieses Beispiel fixiert Opus auf ein benutzerdefiniertes Bedrock-Modell-ARN, setzt einen benutzerfreundlichen Namen und deklariert seine Funktionen:707Dieses Beispiel fixiert Opus auf ein benutzerdefiniertes Amazon Bedrock-Modell-ARN, setzt einen benutzerfreundlichen Namen und deklariert seine Funktionen:

657 708 

658```bash theme={null}709```bash theme={null}

659export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'710export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'


670 721 

671`modelOverrides` ordnet einzelne Anthropic-Modell-IDs den anbieterspezifischen Strings zu, die Claude Code an die API Ihres Anbieters sendet. Wenn ein Benutzer ein zugeordnetes Modell in der `/model`-Auswahl auswählt, verwendet Claude Code Ihren konfigurierten Wert anstelle des integrierten Standards.722`modelOverrides` ordnet einzelne Anthropic-Modell-IDs den anbieterspezifischen Strings zu, die Claude Code an die API Ihres Anbieters sendet. Wenn ein Benutzer ein zugeordnetes Modell in der `/model`-Auswahl auswählt, verwendet Claude Code Ihren konfigurierten Wert anstelle des integrierten Standards.

672 723 

673Dies ermöglicht es Enterprise-Administratoren, jede Modellversion zu einem bestimmten Bedrock-Inference-Profil-ARN, Vertex AI-Versionsnamen oder Foundry-Bereitstellungsnamen für Governance, Kostenzuteilung oder regionales Routing zu leiten.724Dies ermöglicht es Enterprise-Administratoren, jede Modellversion zu einem bestimmten Amazon Bedrock-Inference-Profil-ARN, Google Cloud's Agent Platform-Versionsnamen oder Microsoft Foundry-Bereitstellungsnamen für Governance, Kostenzuteilung oder regionales Routing zu leiten.

674 725 

675Setzen Sie `modelOverrides` in Ihrer [Einstellungsdatei](/de/settings#settings-files):726Setzen Sie `modelOverrides` in Ihrer [Einstellungsdatei](/de/settings#settings-files):

676 727 


686 737 

687Schlüssel müssen Anthropic-Modell-IDs sein, wie in der [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview) aufgelistet. Für datierte Modell-IDs fügen Sie das Datumssuffix genau so ein, wie es dort angezeigt wird. Unbekannte Schlüssel werden ignoriert.738Schlüssel müssen Anthropic-Modell-IDs sein, wie in der [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview) aufgelistet. Für datierte Modell-IDs fügen Sie das Datumssuffix genau so ein, wie es dort angezeigt wird. Unbekannte Schlüssel werden ignoriert.

688 739 

689Überschreibungen ersetzen die integrierten Modell-IDs, die jeden Eintrag in der `/model`-Auswahl unterstützen. Bei Bedrock haben Überschreibungen Vorrang vor allen Inference-Profilen, die Claude Code beim Start automatisch erkennt. Werte, die Sie direkt über `ANTHROPIC_MODEL`, `--model` oder die `ANTHROPIC_DEFAULT_*_MODEL`-Umgebungsvariablen bereitstellen, werden unverändert an den Anbieter übergeben und werden nicht durch `modelOverrides` transformiert.740Überschreibungen ersetzen die integrierten Modell-IDs, die jeden Eintrag in der `/model`-Auswahl unterstützen. Bei Amazon Bedrock haben Überschreibungen Vorrang vor allen Inference-Profilen, die Claude Code beim Start automatisch erkennt. Claude Code übergibt Werte, die bereits anbieterspezifisch sind, wie Amazon Bedrock-Inference-Profil-ARNs oder Microsoft Foundry-Bereitstellungsnamen, unverändert an den Anbieter.

741 

742{/* min-version: 2.1.200 */}Überschreibungen gelten auch, wenn Sie eine Anthropic-Modell-ID direkt über `--model`, die `ANTHROPIC_MODEL`-Umgebungsvariable oder eine `ANTHROPIC_DEFAULT_*_MODEL`-Umgebungsvariable übergeben. Bei Amazon Bedrock, Google Cloud's Agent Platform und [Mantle](/de/amazon-bedrock#use-the-mantle-endpoint) wird eine Anthropic-Modell-ID ohne `modelOverrides`-Eintrag zur gleichen anbieterspezifischen ID aufgelöst wie die `/model`-Auswahl-Zeile für diese Version, wenn der Anbieter diese Version unterstützt. Mantle unterstützt eine Teilmenge von Versionen. Für eine Anthropic-Modell-ID außerhalb dieser Teilmenge sendet Claude Code die rohe ID an Mantle ohne Zuordnung, es sei denn, ein `modelOverrides`-Eintrag deckt sie ab. Vor v2.1.200 erreichten `--model` und die Umgebungsvariablenwerte den Anbieter unverändert, ohne die Überschreibungskarte zu durchlaufen.

690 743 

691`modelOverrides` funktioniert zusammen mit `availableModels`. Die Zulassungsliste wird gegen die Anthropic-Modell-ID ausgewertet, nicht gegen den Überschreibungswert, daher ein Eintrag wie `"opus"` in `availableModels` stimmt weiterhin überein, auch wenn Opus-Versionen ARNs zugeordnet sind. Wenn `enforceAvailableModels` in verwalteten Einstellungen gesetzt ist, wird der erzwungene Standard durch `modelOverrides` aus der [höchsten Prioritätsquelle für verwaltete Einstellungen](/de/server-managed-settings#settings-precedence) aufgelöst. Die Zuordnung eines Administrators, wie eine Version, die an ein Inference-Profil-ARN fixiert ist, wird im erzwungenen Standard berücksichtigt. Überschreibungen aus Benutzer- oder Projekteinstellungen beeinflussen ihn nicht.744`modelOverrides` funktioniert zusammen mit `availableModels`. Die Zulassungsliste wird gegen die Anthropic-Modell-ID ausgewertet, nicht gegen den Überschreibungswert, daher ein Eintrag wie `"opus"` in `availableModels` stimmt weiterhin überein, auch wenn Opus-Versionen ARNs zugeordnet sind. Wenn `enforceAvailableModels` in verwalteten Einstellungen gesetzt ist, wird der erzwungene Standard durch `modelOverrides` aus der [höchsten Prioritätsquelle für verwaltete Einstellungen](/de/server-managed-settings#settings-precedence) aufgelöst. Die Zuordnung eines Administrators, wie eine Version, die an ein Inference-Profil-ARN fixiert ist, wird im erzwungenen Standard berücksichtigt. Überschreibungen aus Benutzer- oder Projekteinstellungen beeinflussen ihn nicht.

692 745 

746{/* min-version: 2.1.200 */}Wenn `availableModels` in [verwalteten Einstellungen](/de/settings#settings-files) gesetzt ist, gelten nur `modelOverrides` aus dieser verwalteten Quelle für eine Anthropic-Modell-ID, die direkt über `--model` oder die oben genannten Umgebungsvariablen übergeben wird. Claude Code ignoriert Überschreibungen in Benutzer- oder Projekteinstellungen für diese IDs und löst niemals eine ID auf, die die verwaltete Liste ausschließt, durch `modelOverrides` aus einer beliebigen Einstellungsquelle. Diese Einschränkung der verwalteten Quelle erfordert Claude Code v2.1.200 oder später. Siehe [Modellauswahl einschränken](#restrict-model-selection), um zu erfahren, wie blockierte IDs behandelt werden.

747 

693<h3 id="prompt-caching-configuration">748<h3 id="prompt-caching-configuration">

694 Prompt-Caching-Konfiguration749 Prompt-Caching-Konfiguration

695</h3>750</h3>

Details

94| `OTEL_LOGS_EXPORT_INTERVAL` | Logs-Exportintervall in Millisekunden (Standard: 5000) | `1000`, `10000` |94| `OTEL_LOGS_EXPORT_INTERVAL` | Logs-Exportintervall in Millisekunden (Standard: 5000) | `1000`, `10000` |

95| `OTEL_LOG_USER_PROMPTS` | Aktiviert die Protokollierung von Benutzer-Prompt-Inhalten (Standard: deaktiviert) | `1` zum Aktivieren |95| `OTEL_LOG_USER_PROMPTS` | Aktiviert die Protokollierung von Benutzer-Prompt-Inhalten (Standard: deaktiviert) | `1` zum Aktivieren |

96| `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. {/* min-version: 2.1.193 */}Erfordert Claude Code v2.1.193 oder später | `1` zum Aktivieren, `0` zum Beibehalten von Redaktionen |96| `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. {/* min-version: 2.1.193 */}Erfordert Claude Code v2.1.193 oder später | `1` zum Aktivieren, `0` zum Beibehalten von Redaktionen |

97| `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 und Tool-Eingabe. Aktiviert auch benutzerdefinierte, Plugin- und MCP-Befehlsnamen bei `user_prompt`-Ereignissen (Standard: deaktiviert) | `1` zum Aktivieren |97| `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) | `1` zum Aktivieren |

98| `OTEL_LOG_TOOL_CONTENT` | Aktiviert die Protokollierung von Tool-Eingabe- und Ausgabeinhalten in Span-Ereignissen (Standard: deaktiviert). Erfordert [Tracing](#traces-beta). Der Inhalt wird bei 60 KB gekürzt | `1` zum Aktivieren |98| `OTEL_LOG_TOOL_CONTENT` | Aktiviert die Protokollierung von Tool-Eingabe- und Ausgabeinhalten in Span-Ereignissen (Standard: deaktiviert). Erfordert [Tracing](#traces-beta). Der Inhalt wird bei 60 KB gekürzt | `1` zum Aktivieren |

99| `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 60 KB, oder `file:<dir>` für ungekürzte Texte auf der Festplatte mit einem `body_ref`-Zeiger im Ereignis |99| `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 60 KB, oder `file:<dir>` für ungekürzte Texte auf der Festplatte mit einem `body_ref`-Zeiger im Ereignis |

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


191**`claude_code.llm_request`**191**`claude_code.llm_request`**

192 192 

193| Attribut | Beschreibung | Gated durch |193| Attribut | Beschreibung | Gated durch |

194| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ----------- |194| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |

195| `model` | Modellkennung | |195| `model` | Modellkennung | |

196| `gen_ai.system` | Immer `anthropic`. OpenTelemetry GenAI semantische Konvention | |196| `gen_ai.system` | Immer `anthropic`. OpenTelemetry GenAI semantische Konvention | |

197| `gen_ai.request.model` | Gleicher Wert wie `model`. OpenTelemetry GenAI semantische Konvention | |197| `gen_ai.request.model` | Gleicher Wert wie `model`. OpenTelemetry GenAI semantische Konvention | |

198| `query_source` | Subsystem, das die Anfrage gestellt hat, wie `repl_main_thread` oder ein Subagent-Name | |198| `query_source` | Subsystem, das die Anfrage gestellt hat, wie `repl_main_thread` oder ein Subagent-Name | |

199| `agent_id` | Kennung des Subagenten oder Teamkollegen, der die Anfrage gestellt hat. Fehlt in der Hauptsitzung | |199| `agent_id` | Kennung des Subagenten oder Teamkollegen, der die Anfrage gestellt hat. Fehlt in der Hauptsitzung | |

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

201| `workflow.run_id` | Run-Kennung des [Workflow](/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 | |

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

201| `speed` | `fast` oder `normal` | |203| `speed` | `fast` oder `normal` | |

202| `llm_request.context` | `interaction`, `tool` oder `standalone` je nach übergeordnetem Span | |204| `llm_request.context` | `interaction`, `tool` oder `standalone` je nach übergeordnetem Span | |

203| `duration_ms` | Wanduhr-Dauer einschließlich Wiederholungen | |205| `duration_ms` | Wanduhr-Dauer einschließlich Wiederholungen | |


228| `result_tokens` | Ungefähre Token-Größe des Tool-Ergebnisses | |230| `result_tokens` | Ungefähre Token-Größe des Tool-Ergebnisses | |

229| `agent_id` | Kennung des Subagenten oder Teamkollegen, der das Tool ausgeführt hat. Fehlt in der Hauptsitzung | |231| `agent_id` | Kennung des Subagenten oder Teamkollegen, der das Tool ausgeführt hat. Fehlt in der Hauptsitzung | |

230| `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 | |232| `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 | |

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

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

231| `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 | |235| `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 | |

232| `gen_ai.tool.call.id` | Gleicher Wert wie `tool_use_id`. OpenTelemetry GenAI semantische Konvention | |236| `gen_ai.tool.call.id` | Gleicher Wert wie `tool_use_id`. OpenTelemetry GenAI semantische Konvention | |

233| `file_path` | Zieldateipfad für Read-, Edit- und Write-Tools | `OTEL_LOG_TOOL_DETAILS` |237| `file_path` | Zieldateipfad für Read-, Edit- und Write-Tools | `OTEL_LOG_TOOL_DETAILS` |


309 313 

310Wenn das Helper-Skript fehlschlägt oder eine Ausgabe druckt, die diese Anforderungen nicht erfüllt, meldet Claude Code den Fehler in:314Wenn das Helper-Skript fehlschlägt oder eine Ausgabe druckt, die diese Anforderungen nicht erfüllt, meldet Claude Code den Fehler in:

311 315 

312* `/doctor` Ausgabe316* `/status` Ausgabe

313* Das Debug-Log, wenn Sie mit [`--debug`](/de/cli-reference#cli-flags) ausführen oder nach dem Ausführen von `/debug` in der Sitzung317* Das Debug-Log, wenn Sie mit [`--debug`](/de/cli-reference#cli-flags) ausführen oder nach dem Ausführen von `/debug` in der Sitzung

314* stderr, in nicht-interaktiven Sitzungen, die mit `-p` gestartet werden318* stderr, in nicht-interaktiven Sitzungen, die mit `-p` gestartet werden

315 319 


443 447 

444* `prompt.id`: UUID, die einen Benutzer-Prompt mit allen nachfolgenden Ereignissen bis zum nächsten Prompt korreliert. Siehe [Ereigniskorrelationsattribute](#event-correlation-attributes).448* `prompt.id`: UUID, die einen Benutzer-Prompt mit allen nachfolgenden Ereignissen bis zum nächsten Prompt korreliert. Siehe [Ereigniskorrelationsattribute](#event-correlation-attributes).

445* `workspace.host_paths`: Host-Workspace-Verzeichnisse, die in der Desktop-App ausgewählt wurden, als String-Array449* `workspace.host_paths`: Host-Workspace-Verzeichnisse, die in der Desktop-App ausgewählt wurden, als String-Array

450* `workflow.run_id`: Lauf-Kennung mit dem Präfix `wf_` auf der API und Tool-Ereignisse, die von Agents ausgegeben werden, die zu einem [Workflow](/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 Agents, die das Workflow-Skript erzeugt, und alle Agents, die diese wiederum erzeugen, z. B. Skill-Aufrufe. Sie entspricht der Lauf-Kennung, die im Workflow-Tool-Ergebnis gemeldet wird. Nicht vorhanden bei allen anderen Ereignissen. {/* min-version: 2.1.202 */}Erfordert Claude Code v2.1.202 oder später

451* `workflow.name`: Name des Workflows, das `meta.name` des Skripts, ausgegeben zusammen mit `workflow.run_id`. Integrierte Workflow-Namen erscheinen wörtlich, wenn der Lauf das unmodifizierte 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. {/* min-version: 2.1.202 */}Erfordert Claude Code v2.1.202 oder später

446 452 

447<h3 id="metrics">453<h3 id="metrics">

448 Metriken454 Metriken


884 Interner Fehler-Ereignis890 Interner Fehler-Ereignis

885</h4>891</h4>

886 892 

887Protokolliert, wenn Claude Code einen unerwarteten internen Fehler abfängt. Nur der Fehlerklassenname und ein errno-ähnlicher Code werden aufgezeichnet. Die Fehlermeldung und Stack-Trace sind nie enthalten. Dieses Ereignis wird nicht ausgegeben, wenn gegen Bedrock, Vertex oder Foundry ausgeführt wird, oder wenn `DISABLE_ERROR_REPORTING` gesetzt ist.893Protokolliert, wenn Claude Code einen unerwarteten internen Fehler abfängt. Nur der Fehlerklassenname 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.

888 894 

889**Ereignisname**: `claude_code.internal_error`895**Ereignisname**: `claude_code.internal_error`

890 896 


1163* Zuordnung von Ausgaben zu spezifischen Skills, Plugins oder Subagent-Typen über die Attribute `skill.name`, `plugin.name` und `agent.name`1169* Zuordnung von Ausgaben zu spezifischen Skills, Plugins oder Subagent-Typen über die Attribute `skill.name`, `plugin.name` und `agent.name`

1164 1170 

1165<Note>1171<Note>

1166 Kostenmetriken sind Näherungswerte. Für offizielle Abrechnungsdaten konsultieren Sie Ihren API-Anbieter (Claude Console, Amazon Bedrock oder Google Cloud Vertex).1172 Kostenmetriken sind Näherungswerte. Für offizielle Abrechnungsdaten konsultieren Sie Ihren API-Anbieter (Claude Console, Amazon Bedrock oder Google Cloud's Agent Platform).

1167</Note>1173</Note>

1168 1174 

1169<h3 id="alerting-and-segmentation">1175<h3 id="alerting-and-segmentation">


1176* Ungewöhnlicher Token-Verbrauch1182* Ungewöhnlicher Token-Verbrauch

1177* Hohes Sitzungsvolumen von bestimmten Benutzern1183* Hohes Sitzungsvolumen von bestimmten Benutzern

1178 1184 

1179Alle Metriken können nach den [Standard-Attributen](#standard-attributes) segmentiert werden. Das Attribut `model` ist auf `claude_code.token.usage`, `claude_code.cost.usage` und {/* min-version: 2.1.172 */}ab v2.1.172 auf `claude_code.lines_of_code.count` verfügbar. Aufschlüsselungen pro Modell von Commits können nur durch Verknüpfung mit den Token- oder Kostenmetriken auf `session.id` angenähert werden, da eine Sitzung mehrere Modelle umfassen kann. Filtern Sie die Token- oder Kostenseite auf Zeilen, bei denen `query_source` `"main"` ist, damit Hilfs- und Subagent-Anfragen die Commits der Sitzung nicht einem Modell zuordnen, das sie nicht erstellt hat.1185Alle Metriken können nach den [Standard-Attributen](#standard-attributes) segmentiert werden. Das Attribut `model` ist auf `claude_code.token.usage`, `claude_code.cost.usage` und {/* min-version: 2.1.172 */}ab v2.1.172 auf `claude_code.lines_of_code.count` verfügbar.

1186 

1187Aufschlüsselungen pro Modell von Commits können nur durch Verknüpfung mit den Token- oder Kostenmetriken auf `session.id` angenähert werden, da eine Sitzung mehrere Modelle umfassen kann. Filtern Sie die Token- oder Kostenseite auf Zeilen, bei denen `query_source` `"main"` ist, damit Hilfs- und Subagent-Anfragen die Commits der Sitzung nicht einem Modell zuordnen, das sie nicht erstellt hat.

1180 1188 

1181<h3 id="detect-retry-exhaustion">1189<h3 id="detect-retry-exhaustion">

1182 Wiederholungserschöpfung erkennen1190 Wiederholungserschöpfung erkennen


1217 1225 

1218MCP-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](/de/claude-apps-gateway)-Sitzung.1226MCP-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](/de/claude-apps-gateway)-Sitzung.

1219 1227 

1220Wenn Claude Code sich mit einem direkten API-Schlüssel authentifiziert oder gegen Bedrock, Vertex AI 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.1228Wenn 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.

1221 1229 

1222```bash theme={null}1230```bash theme={null}

1223export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."1231export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."


1352 Überwachung von Claude Code auf Amazon Bedrock1360 Überwachung von Claude Code auf Amazon Bedrock

1353</h2>1361</h2>

1354 1362 

1355Für detaillierte Anleitung zur Überwachung der Claude Code-Nutzung für Amazon Bedrock siehe [Claude Code Monitoring Implementation (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md).1363Für detaillierte Anleitung zur Überwachung der Claude Code-Nutzung für Amazon Bedrock siehe [Claude Code Monitoring Implementation (Amazon Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md).

Details

110export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"110export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"

111```111```

112 112 

113Claude Code liest die Zertifikat- und Schlüsseldateien beim Start ein und liest sie jedes Mal erneut ein, wenn es Einstellungen anwendet, einschließlich wenn sich die Einstellungen während einer Sitzung ändern. Um das Zertifikat und den Schlüssel zu rotieren, ersetzen Sie die Dateien unter denselben Pfaden.

114 

113<h2 id="network-access-requirements">115<h2 id="network-access-requirements">

114 Netzwerkzugriffanforderungen116 Netzwerkzugriffanforderungen

115</h2>117</h2>


131 133 

132Claude Code sendet standardmäßig optionale operative Telemetrie, die Sie mit Umgebungsvariablen deaktivieren können. Siehe [Telemetrie-Dienste](/de/data-usage#telemetry-services), um zu erfahren, wie Sie diese deaktivieren, bevor Sie Ihre Allowlist finalisieren.134Claude Code sendet standardmäßig optionale operative Telemetrie, die Sie mit Umgebungsvariablen deaktivieren können. Siehe [Telemetrie-Dienste](/de/data-usage#telemetry-services), um zu erfahren, wie Sie diese deaktivieren, bevor Sie Ihre Allowlist finalisieren.

133 135 

134Bei Verwendung von [Amazon Bedrock](/de/amazon-bedrock), [Google Vertex AI](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry) oder einer angemeldeten [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzung geht der Modell-Datenverkehr und die Authentifizierung zu Ihrem Anbieter oder Gateway statt zu `api.anthropic.com`, `claude.ai` oder `platform.claude.com`. Das WebFetch-Tool ruft weiterhin `api.anthropic.com` für seine [Domain-Sicherheitsprüfung](/de/data-usage#webfetch-domain-safety-check) auf, es sei denn, Sie setzen `skipWebFetchPreflight: true` in [Einstellungen](/de/settings).136Bei Verwendung von [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry) oder einer angemeldeten [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzung geht der Modell-Datenverkehr und die Authentifizierung zu Ihrem Anbieter oder Gateway statt zu `api.anthropic.com`, `claude.ai` oder `platform.claude.com`. Das WebFetch-Tool ruft weiterhin `api.anthropic.com` für seine [Domain-Sicherheitsprüfung](/de/data-usage#webfetch-domain-safety-check) auf, es sei denn, Sie setzen `skipWebFetchPreflight: true` in [Einstellungen](/de/settings).

135 137 

136[Claude Code im Web](/de/claude-code-on-the-web) und [Code Review](/de/code-review) verbinden sich von der von Anthropic verwalteten Infrastruktur aus mit Ihren Repositories. Wenn Ihre GitHub Enterprise Cloud-Organisation den Zugriff nach IP-Adresse einschränkt, aktivieren Sie [IP-Allowlist-Vererbung für installierte GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). Die Claude GitHub App registriert ihre IP-Bereiche, sodass die Aktivierung dieser Einstellung den Zugriff ohne manuelle Konfiguration ermöglicht. Um [die Bereiche stattdessen manuell zu Ihrer Allowlist hinzuzufügen](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) oder um andere Firewalls zu konfigurieren, siehe [Anthropic API IP-Adressen](https://platform.claude.com/docs/en/api/ip-addresses).138[Claude Code im Web](/de/claude-code-on-the-web) und [Code Review](/de/code-review) verbinden sich von der von Anthropic verwalteten Infrastruktur aus mit Ihren Repositories. Wenn Ihre GitHub Enterprise Cloud-Organisation den Zugriff nach IP-Adresse einschränkt, aktivieren Sie [IP-Allowlist-Vererbung für installierte GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). Die Claude GitHub App registriert ihre IP-Bereiche, sodass die Aktivierung dieser Einstellung den Zugriff ohne manuelle Konfiguration ermöglicht. Um [die Bereiche stattdessen manuell zu Ihrer Allowlist hinzuzufügen](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) oder um andere Firewalls zu konfigurieren, siehe [Anthropic API IP-Adressen](https://platform.claude.com/docs/en/api/ip-addresses).

137 139 

overview.md +3 −3

Details

12 Erste Schritte12 Erste Schritte

13</h2>13</h2>

14 14 

15Wählen Sie Ihre Umgebung, um zu beginnen. Die meisten Oberflächen erfordern ein [Claude-Abonnement](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) oder ein [Anthropic Console](https://console.anthropic.com/)-Konto. Das Terminal CLI und VS Code unterstützen auch [Drittanbieter](/de/third-party-integrations).15Claude Code läuft auf mehreren Oberflächen: dem Terminal, IDE-Erweiterungen, einer Desktop-App und dem Web. Wählen Sie einen aus den Registerkarten unten aus, um zu beginnen. Die meisten Oberflächen erfordern ein [Claude-Abonnement](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) oder ein [Anthropic Console](https://console.anthropic.com/)-Konto. Das Terminal CLI und VS Code unterstützen auch [Drittanbieter](/de/third-party-integrations).

16 16 

17<Tabs>17<Tabs>

18 <Tab title="Terminal">18 <Tab title="Terminal">


221 Verwenden Sie Claude Code überall221 Verwenden Sie Claude Code überall

222</h2>222</h2>

223 223 

224Jede Oberfläche verbindet sich mit der gleichen zugrunde liegenden Claude Code-Engine, sodass Ihre CLAUDE.md-Dateien, Einstellungen und MCP-Server auf allen Oberflächen funktionieren.224Jede [Oberfläche](/de/glossary#surface) verbindet sich mit der gleichen zugrunde liegenden Claude Code-Engine, sodass Ihre CLAUDE.md-Dateien, Einstellungen und MCP-Server auf allen Oberflächen funktionieren.

225 225 

226Über die oben genannten Umgebungen [Terminal](/de/quickstart), [VS Code](/de/vs-code), [JetBrains](/de/jetbrains), [Desktop](/de/desktop) und [Web](/de/claude-code-on-the-web) hinaus integriert sich Claude Code mit CI/CD-, Chat- und Browser-Workflows:226Über die [Terminal](/de/quickstart), [VS Code](/de/vs-code), [JetBrains](/de/jetbrains), [Desktop](/de/desktop) und [Web](/de/claude-code-on-the-web) Oberflächen hinaus integriert sich Claude Code mit CI/CD-, Chat- und Browser-Workflows:

227 227 

228| Ich möchte... | Beste Option |228| Ich möchte... | Beste Option |

229| ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |229| ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |

Details

6 6 

7> Steuern Sie, ob Claude vor dem Bearbeiten von Dateien oder dem Ausführen von Befehlen fragt. Wechseln Sie Modi mit Shift+Tab in der CLI oder verwenden Sie den Moduswahlschalter in VS Code, Desktop und claude.ai.7> Steuern Sie, ob Claude vor dem Bearbeiten von Dateien oder dem Ausführen von Befehlen fragt. Wechseln Sie Modi mit Shift+Tab in der CLI oder verwenden Sie den Moduswahlschalter in VS Code, Desktop und claude.ai.

8 8 

9Wenn Claude eine Datei bearbeiten, einen Shell-Befehl ausführen oder eine Netzwerkanfrage stellen möchte, pausiert es und fragt Sie um Genehmigung. Berechtigungsmodi steuern, wie oft diese Pause auftritt. Der Modus, den Sie wählen, prägt den Ablauf einer Sitzung: Der Standardmodus lässt Sie jede Aktion überprüfen, während lockerere Modi Claude in längeren ununterbrochenen Abschnitten arbeiten lassen und dann berichten, wenn es fertig ist. Wählen Sie mehr Überwachung für sensible Arbeiten oder weniger Unterbrechungen, wenn Sie der Richtung vertrauen.9Wenn Claude eine Datei bearbeiten, einen Shell-Befehl ausführen oder eine Netzwerkanfrage stellen möchte, pausiert es und fragt Sie um Genehmigung. Berechtigungsmodi steuern, wie oft diese Pause auftritt. Der Modus, den Sie wählen, prägt den Ablauf einer Sitzung: Der manuelle Modus lässt Sie jede Aktion überprüfen, während lockerere Modi Claude in längeren ununterbrochenen Abschnitten arbeiten lassen und dann berichten, wenn es fertig ist. Wählen Sie mehr Überwachung für sensible Arbeiten oder weniger Unterbrechungen, wenn Sie der Richtung vertrauen.

10 10 

11<h2 id="available-modes">11<h2 id="available-modes">

12 Verfügbare Modi12 Verfügbare Modi


16 16 

17| Modus | Was ohne Nachfrage ausgeführt wird | Am besten für |17| Modus | Was ohne Nachfrage ausgeführt wird | Am besten für |

18| :------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------- | :----------------------------------------------------- |18| :------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------- | :----------------------------------------------------- |

19| `default` | Nur Lesevorgänge | Erste Schritte, sensible Arbeiten |19| `default` | Nur Lesevorgänge. Mit der Bezeichnung **Manuell** in der CLI und IDE-Erweiterungen | Erste Schritte, sensible Arbeiten |

20| [`acceptEdits`](#auto-approve-file-edits-with-acceptedits-mode) | Lesevorgänge, Dateibearbeitungen und häufige Dateisystem-Befehle (`mkdir`, `touch`, `mv`, `cp` usw.) | Iteration über Code, den Sie überprüfen |20| [`acceptEdits`](#auto-approve-file-edits-with-acceptedits-mode) | Lesevorgänge, Dateibearbeitungen und häufige Dateisystem-Befehle (`mkdir`, `touch`, `mv`, `cp` usw.) | Iteration über Code, den Sie überprüfen |

21| [`plan`](#analyze-before-you-edit-with-plan-mode) | Nur Lesevorgänge | Erkunden einer Codebasis vor Änderungen |21| [`plan`](#analyze-before-you-edit-with-plan-mode) | Nur Lesevorgänge | Erkunden einer Codebasis vor Änderungen |

22| [`auto`](#eliminate-prompts-with-auto-mode) | Alles, mit Hintergrund-Sicherheitsprüfungen | Lange Aufgaben, Reduzierung von Aufforderungsmüdigkeit |22| [`auto`](#eliminate-prompts-with-auto-mode) | Alles, mit Hintergrund-Sicherheitsprüfungen | Lange Aufgaben, Reduzierung von Aufforderungsmüdigkeit |

23| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Nur vorab genehmigte Tools | Gesperrte CI und Skripte |23| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Nur vorab genehmigte Tools | Gesperrte CI und Skripte |

24| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Alles | Nur isolierte Container und VMs |24| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Alles | Nur isolierte Container und VMs |

25 25 

26Der Modus, der jede Aktion überprüft, wird in der CLI, in `claude --help` und in den VS Code- und JetBrains-Erweiterungen als **Manuell** bezeichnet. Sein Konfigurationswert ist `default`, was Hooks und SDK-Integrationen verwenden. Die CLI akzeptiert `manual` als Alias überall dort, wo Sie den Wert eingeben, zum Beispiel `claude --permission-mode manual` oder `"defaultMode": "manual"`. Die Bezeichnung „Manuell" und der Alias `manual` erfordern Claude Code v2.1.200 oder später.

27 

26In jedem Modus außer `bypassPermissions` werden Schreibvorgänge zu [geschützten Pfaden](#protected-paths) niemals automatisch genehmigt, um den Repository-Status und Claudes eigene Konfiguration vor versehentlicher Beschädigung zu schützen.28In jedem Modus außer `bypassPermissions` werden Schreibvorgänge zu [geschützten Pfaden](#protected-paths) niemals automatisch genehmigt, um den Repository-Status und Claudes eigene Konfiguration vor versehentlicher Beschädigung zu schützen.

27 29 

28Modi legen die Grundlage fest. Überlagern Sie [Berechtigungsregeln](/de/permissions#manage-permissions) darauf, um bestimmte Tools vorab zu genehmigen oder zu blockieren. Ablehnungsregeln und explizite Anfragungsregeln gelten in jedem Modus, einschließlich `bypassPermissions`. Genehmigungsregeln haben keine Auswirkung in diesem Modus, da alles andere bereits genehmigt ist.30Modi legen die Grundlage fest. Überlagern Sie [Berechtigungsregeln](/de/permissions#manage-permissions) darauf, um bestimmte Tools vorab zu genehmigen oder zu blockieren. Ablehnungsregeln und explizite Anfragungsregeln gelten in jedem Modus, einschließlich `bypassPermissions`. Genehmigungsregeln haben keine Auswirkung in diesem Modus, da alles andere bereits genehmigt ist.


35 37 

36<Tabs>38<Tabs>

37 <Tab title="CLI">39 <Tab title="CLI">

38 **Während einer Sitzung**: Drücken Sie `Shift+Tab`, um `default` → `acceptEdits` → `plan` zu durchlaufen. Der aktuelle Modus wird in der Statusleiste angezeigt. Nicht jeder Modus ist im Standard-Zyklus:40 **Während einer Sitzung**: Drücken Sie `Shift+Tab`, um `default` → `acceptEdits` → `plan` zu durchlaufen. Der aktuelle Modus wird in der Statusleiste angezeigt. {/* min-version: 2.1.203 */}Der manuelle Modus, `default` in diesem Zyklus, zeigt ein graues `⏸ manual mode on`-Abzeichen. Vor v2.1.203 zeigte die Statusleiste im manuellen Modus kein Abzeichen.

41 

42 Nicht jeder Modus ist im Standard-Zyklus:

39 43 

40 * `auto`: wird angezeigt, wenn Ihr Konto die [Auto-Modus-Anforderungen](#eliminate-prompts-with-auto-mode) erfüllt; das Durchlaufen zu Auto schaltet Modi ohne eine Bestätigungsaufforderung um44 * `auto`: wird angezeigt, wenn Ihr Konto die [Auto-Modus-Anforderungen](#eliminate-prompts-with-auto-mode) erfüllt; das Durchlaufen zu Auto schaltet Modi ohne eine Bestätigungsaufforderung um

41 * `bypassPermissions`: wird angezeigt, nachdem Sie mit `--permission-mode bypassPermissions`, `--dangerously-skip-permissions` oder `--allow-dangerously-skip-permissions` starten; die `--allow-`-Variante fügt den Modus zum Zyklus hinzu, ohne ihn zu aktivieren45 * `bypassPermissions`: wird angezeigt, nachdem Sie mit `--permission-mode bypassPermissions`, `--dangerously-skip-permissions` oder `--allow-dangerously-skip-permissions` starten; die `--allow-`-Variante fügt den Modus zum Zyklus hinzu, ohne ihn zu aktivieren


70 Der Modusindikator zeigt diese Bezeichnungen, die dem Modus zugeordnet sind, auf den sich jede bezieht:74 Der Modusindikator zeigt diese Bezeichnungen, die dem Modus zugeordnet sind, auf den sich jede bezieht:

71 75 

72 | UI-Bezeichnung | Modus |76 | UI-Bezeichnung | Modus |

73 | :----------------------- | :------------------ |77 | :--------------------- | :------------------ |

74 | Vor Bearbeitungen fragen | `default` |78 | Manuell | `default` |

75 | Automatisch bearbeiten | `acceptEdits` |79 | Automatisch bearbeiten | `acceptEdits` |

76 | Planungsmodus | `plan` |80 | Planungsmodus | `plan` |

77 | Auto-Modus | `auto` |81 | Auto-Modus | `auto` |

78 | Berechtigungen umgehen | `bypassPermissions` |82 | Berechtigungen umgehen | `bypassPermissions` |

79 83 

84 Vor v2.1.205 bezeichnete die Erweiterung `plan` als Plan mode und `auto` als Auto mode.

85 

80 Auto-Modus wird im Modusindikator angezeigt, wenn Ihr Konto alle Anforderungen erfüllt, die im [Auto-Modus-Abschnitt](#eliminate-prompts-with-auto-mode) aufgelistet sind. Die `claudeCode.initialPermissionMode`-Einstellung akzeptiert nicht `auto`. Um standardmäßig im Auto-Modus zu starten, legen Sie stattdessen `defaultMode` in Ihren [Benutzereinstellungen](/de/settings#settings-files) fest. Claude Code ignoriert `defaultMode: "auto"` in Projekt- und lokalen Einstellungen.86 Auto-Modus wird im Modusindikator angezeigt, wenn Ihr Konto alle Anforderungen erfüllt, die im [Auto-Modus-Abschnitt](#eliminate-prompts-with-auto-mode) aufgelistet sind. Die `claudeCode.initialPermissionMode`-Einstellung akzeptiert nicht `auto`. Um standardmäßig im Auto-Modus zu starten, legen Sie stattdessen `defaultMode` in Ihren [Benutzereinstellungen](/de/settings#settings-files) fest. Claude Code ignoriert `defaultMode: "auto"` in Projekt- und lokalen Einstellungen.

81 87 

82 Berechtigungen umgehen erfordert den Umschalter **Berechtigungen gefährlich überspringen zulassen** in den Erweiterungseinstellungen, bevor es im Modusindikator angezeigt wird.88 Berechtigungen umgehen erfordert den Umschalter **Berechtigungen gefährlich überspringen zulassen** in den Erweiterungseinstellungen, bevor es im Modusindikator angezeigt wird.


95 <Tab title="Web und Mobilgeräte">101 <Tab title="Web und Mobilgeräte">

96 Verwenden Sie das Modus-Dropdown 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 ausgeführt wird:102 Verwenden Sie das Modus-Dropdown 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 ausgeführt wird:

97 103 

98 * **Cloud-Sitzungen** auf [Claude Code im Web](/de/claude-code-on-the-web): Bearbeitungen automatisch akzeptieren, Planungsmodus und Auto-Modus. Bearbeitungen automatisch akzeptieren entspricht dem `default`-Modus: Die Cloud-Umgebung genehmigt Dateibearbeitungen unabhängig vom Modus vorab, daher zeigt das Dropdown "Bearbeitungen automatisch akzeptieren" anstelle von "Berechtigungen erfragen" an. `defaultMode: "acceptEdits"` aus den Einstellungen wird weiterhin berücksichtigt. Auto-Modus wird nur angezeigt, wenn Ihre Organisation ihn zulässt und das ausgewählte Modell ihn unterstützt. Berechtigungen umgehen ist nicht verfügbar.104 * **Cloud-Sitzungen** auf [Claude Code im Web](/de/claude-code-on-the-web): Bearbeitungen akzeptieren, Planungsmodus und Auto-Modus. Bearbeitungen akzeptieren entspricht dem `default`-Modus: Die Cloud-Umgebung genehmigt Dateibearbeitungen unabhängig vom Modus vorab, daher zeigt das Dropdown "Bearbeitungen akzeptieren" anstelle von "Manuell" an. Cloud-Sitzungen berücksichtigen weiterhin `defaultMode: "acceptEdits"` aus den Einstellungen. Auto-Modus wird nur angezeigt, wenn Ihre Organisation ihn zulässt und das ausgewählte Modell ihn unterstützt. Berechtigungen umgehen ist nicht verfügbar.

99 * **[Remote Control](/de/remote-control)-Sitzungen** auf Ihrem lokalen Computer: Berechtigungen erfragen, Bearbeitungen automatisch akzeptieren und Planungsmodus. Auto und Berechtigungen umgehen sind nicht verfügbar.105 * **[Remote Control](/de/remote-control)-Sitzungen** auf Ihrem lokalen Computer: Manuell, Bearbeitungen akzeptieren und Planungsmodus. Sie können Auto oder Berechtigungen umgehen nicht aus der App auswählen. {/* min-version: 2.1.202 */}Das Dropdown zeigt den Modus an, in dem sich die lokale Sitzung befindet, einschließlich eines Modus, der vom Terminal aus festgelegt wurde, und wird aktualisiert, wenn sich der Modus in der App oder im Terminal ändert. Die einzige Ausnahme ist Berechtigungen umgehen: Die Sitzung meldet diesen Modus niemals an claude.ai, daher ändert sich das Dropdown nicht, wenn Sie vom Terminal aus in diesen Modus wechseln. Vor v2.1.202 meldeten Sitzungen, die mit `/remote-control` oder `claude --remote-control` verbunden waren, ihren Modus überhaupt nicht, daher konnten claude.ai und die mobile App einen Modus anzeigen, in dem sich die Sitzung nicht befand. Die Nichtübereinstimmung betraf nur die Bezeichnung: Claude Code generierte Berechtigungsaufforderungen vom tatsächlichen Modus der Sitzung, und sie erschienen weiterhin in der App zur Genehmigung.

100 106 

101 Für Remote Control können Sie auch den Startmodus beim Starten des Hosts festlegen:107 Für Remote Control können Sie auch den Startmodus beim Starten des Hosts festlegen:

102 108 


116 122 

117Wenn das [PowerShell-Tool](/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.123Wenn das [PowerShell-Tool](/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.

118 124 

119Verwenden Sie `acceptEdits`, wenn Sie Änderungen in Ihrem Editor oder über `git diff` überprüfen möchten, anstatt jede Bearbeitung inline zu genehmigen. Drücken Sie `Shift+Tab` einmal vom Standardmodus, um ihn zu betreten, oder starten Sie direkt damit:125Verwenden Sie `acceptEdits`, wenn Sie Änderungen in Ihrem Editor oder über `git diff` überprüfen möchten, anstatt jede Bearbeitung inline zu genehmigen.

126 

127Drücken Sie `Shift+Tab` einmal vom Manuellen Modus, um ihn zu betreten, oder starten Sie direkt damit:

120 128 

121```bash theme={null}129```bash theme={null}

122claude --permission-mode acceptEdits130claude --permission-mode acceptEdits


188 196 

189* **Plan**: Alle Pläne.197* **Plan**: Alle Pläne.

190* **Owner**: Bei Team und Enterprise muss ein Owner ihn in [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code) aktivieren, bevor Benutzer ihn einschalten können. Administratoren können ihn auch sperren, indem sie `permissions.disableAutoMode` in [verwalteten Einstellungen](/de/permissions#managed-settings) auf `"disable"` setzen.198* **Owner**: Bei Team und Enterprise muss ein Owner ihn in [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code) aktivieren, bevor Benutzer ihn einschalten können. Administratoren können ihn auch sperren, indem sie `permissions.disableAutoMode` in [verwalteten Einstellungen](/de/permissions#managed-settings) auf `"disable"` setzen.

191* **Modell**: Bei der Anthropic API Claude Opus 4.6 oder später oder Sonnet 4.6 oder später. Bei Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry und angemeldeten [Claude-Apps-Gateway](/de/claude-apps-gateway)-Sitzungen nur Claude Sonnet 5, Opus 4.7 und Opus 4.8. Ältere Modelle, einschließlich Sonnet 4.5, Opus 4.5, Haiku und claude-3-Modelle, werden auf keinem Anbieter unterstützt.199* **Modell**: Bei der Anthropic API Claude Opus 4.6 oder später oder Sonnet 4.6 oder später. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten [Claude-Apps-Gateway](/de/claude-apps-gateway)-Sitzungen nur Claude Sonnet 5, Opus 4.7 und Opus 4.8. Ältere Modelle, einschließlich Sonnet 4.5, Opus 4.5, Haiku und claude-3-Modelle, werden auf keinem Anbieter unterstützt.

192* **Anbieter**: Standardmäßig auf der Anthropic API verfügbar. Bei Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry und angemeldeten Claude-Apps-Gateway-Sitzungen ist Auto-Modus deaktiviert, bis Sie [`CLAUDE_CODE_ENABLE_AUTO_MODE`](#enable-auto-mode-on-bedrock-vertex-ai-or-foundry) setzen.200* **Anbieter**: Standardmäßig auf der Anthropic API verfügbar. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten Claude-Apps-Gateway-Sitzungen ist Auto-Modus deaktiviert, bis Sie [`CLAUDE_CODE_ENABLE_AUTO_MODE`](#enable-auto-mode-on-bedrock-agent-platform-or-foundry) setzen.

193 201 

194Wenn Claude Code Auto-Modus als nicht verfügbar meldet, ist eine dieser Anforderungen nicht erfüllt; dies ist kein vorübergehender Ausfall. Eine separate Nachricht, die ein Modell benennt und sagt, Auto-Modus "kann die Sicherheit" einer Aktion nicht bestimmen, ist ein vorübergehender Klassifizierer-Ausfall; siehe die [Fehlerreferenz](/de/errors#auto-mode-cannot-determine-the-safety-of-an-action).202Wenn Claude Code Auto-Modus als nicht verfügbar meldet, ist eine dieser Anforderungen nicht erfüllt; dies ist kein vorübergehender Ausfall. Eine separate Nachricht, die ein Modell benennt und sagt, Auto-Modus "kann die Sicherheit" einer Aktion nicht bestimmen, ist ein vorübergehender Klassifizierer-Ausfall; siehe die [Fehlerreferenz](/de/errors#auto-mode-cannot-determine-the-safety-of-an-action).

195 203 

196Wenn Sie `defaultMode: "auto"` in [Einstellungen](/de/settings#available-settings) setzen und die Sitzung im `default`-Modus ohne Fehler startet, befindet sich die Einstellung wahrscheinlich in `.claude/settings.json` oder `.claude/settings.local.json`. Claude Code v2.1.142 und später ignorieren `auto` aus diesen Dateien, daher kann ein Repository sich selbst nicht den Auto-Modus gewähren. Verschieben Sie es zu `~/.claude/settings.json`.204Wenn Sie `defaultMode: "auto"` in [Einstellungen](/de/settings#available-settings) setzen und die Sitzung im `default`-Modus ohne Fehler startet, befindet sich die Einstellung wahrscheinlich in `.claude/settings.json` oder `.claude/settings.local.json`. Claude Code v2.1.142 und später ignorieren `auto` aus diesen Dateien, daher kann ein Repository sich selbst nicht den Auto-Modus gewähren. Verschieben Sie es zu `~/.claude/settings.json`.

197 205 

198<h3 id="enable-auto-mode-on-bedrock-vertex-ai-or-foundry">206<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">

199 Auto-Modus auf Bedrock, Vertex AI oder Foundry aktivieren207 Auto-Modus auf Bedrock, Agent Platform oder Foundry aktivieren

200</h3>208</h3>

201 209 

202Bei [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud Vertex AI](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry) und angemeldeten [Claude-Apps-Gateway](/de/claude-apps-gateway)-Sitzungen wird Auto-Modus nicht im `Shift+Tab`-Zyklus angezeigt, bis `CLAUDE_CODE_ENABLE_AUTO_MODE` auf `1` gesetzt ist. Die Variable funktioniert in Claude Code v2.1.158 und später. Nur Claude Sonnet 5, Opus 4.7 und Opus 4.8 werden auf diesen Anbietern unterstützt.210Bei [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry) und angemeldeten [Claude-Apps-Gateway](/de/claude-apps-gateway)-Sitzungen wird Auto-Modus nicht im `Shift+Tab`-Zyklus angezeigt, bis `CLAUDE_CODE_ENABLE_AUTO_MODE` auf `1` gesetzt ist. Die Variable funktioniert in Claude Code v2.1.158 und später. Nur Claude Sonnet 5, Opus 4.7 und Opus 4.8 werden auf diesen Anbietern unterstützt.

203 211 

204Um es für einen Entwickler zu aktivieren, fügen Sie die Variable zum `env`-Block in `~/.claude/settings.json` hinzu:212Um es für einen Entwickler zu aktivieren, fügen Sie die Variable zum `env`-Block in `~/.claude/settings.json` hinzu:

205 213 


223 Was der Klassifizierer standardmäßig blockiert231 Was der Klassifizierer standardmäßig blockiert

224</h3>232</h3>

225 233 

226Der Klassifizierer vertraut Ihrem Arbeitsverzeichnis und den konfigurierten Remotes Ihres Repositories. Alles andere wird als extern behandelt, bis Sie [vertrauenswürdige Infrastruktur konfigurieren](/de/auto-mode-config).234Der Klassifizierer vertraut Ihrem Arbeitsverzeichnis und den Remotes, die für es konfiguriert wurden, als die Sitzung gestartet wurde. {/* min-version: 2.1.200 */}Ein Remote, das während der Sitzung mit `git remote add` oder `git remote set-url` hinzugefügt oder umgeleitet wird, wird nicht vertraut, und alles andere wird als extern behandelt, bis Sie [vertrauenswürdige Infrastruktur konfigurieren](/de/auto-mode-config). Vor v2.1.200 wurden Remotes, die während der Sitzung hinzugefügt wurden, ebenfalls vertraut.

227 235 

228**Standardmäßig blockiert**:236**Standardmäßig blockiert**:

229 237 


234* Gewährung von IAM- oder Repository-Berechtigungen242* Gewährung von IAM- oder Repository-Berechtigungen

235* Änderung gemeinsamer Infrastruktur243* Änderung gemeinsamer Infrastruktur

236* Irreversibles Löschen von Dateien, die vor der Sitzung vorhanden waren244* Irreversibles Löschen von Dateien, die vor der Sitzung vorhanden waren

237* Force-Push oder direktes Pushen zu `main`245* Force-Push

246* {/* min-version: 2.1.203 */}Pushen zum Standard-Branch des Repositories, wenn der Push sensible Inhalte wie Secrets oder persönliche oder anvertraute Daten enthält, Änderungen verborgen oder falsch beschrieben im Vergleich zu dem, was Sie gefordert haben, enthält, Inhalte enthält, die von außerhalb des Repositories portiert oder zuerst gelesen wurden, oder um einen Pull Request, eine Überprüfung oder eine Prüfung herumleitet, die Sie gefordert haben. Ein einfacher Push zum Standard-Branch wird nicht allein blockiert, und das Löschen eines gekennzeichneten Push erfordert das Benennen des gekennzeichneten Inhalts oder der umgangenen Überprüfung, nicht nur des Push. Der Klassifizierer ist eine Schicht: [`permissions.deny`-Regeln](/de/permissions#manage-permissions) gelten in jedem Modus und können Pushes zum Standard-Branch vollständig blockieren, und der Branch-Schutz des Remote gilt immer noch. Vor v2.1.203 wurde jeder direkte Push zum Standard-Branch blockiert

238* {/* min-version: 2.1.182 */}`git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` oder `git stash clear`, von denen der Klassifizierer annimmt, dass sie nicht committete Änderungen verwerfen würden247* {/* min-version: 2.1.182 */}`git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` oder `git stash clear`, von denen der Klassifizierer annimmt, dass sie nicht committete Änderungen verwerfen würden

239* `git commit --amend`, wenn der Commit am HEAD nicht in dieser Sitzung erstellt wurde248* `git commit --amend`, wenn der Commit am HEAD nicht in dieser Sitzung erstellt wurde

240* {/* min-version: 2.1.198 */}Ab v2.1.198 `git commit --amend`, wenn der Commit am HEAD bereits gepusht wurde. Ein reines Reword der Nachricht wird nicht blockiert: `--amend -m` ohne neu gestaged Inhalte, bei einem Commit, den Claude während dieser Sitzung erstellt hat249* {/* min-version: 2.1.198 */}Ab v2.1.198 `git commit --amend`, wenn der Commit am HEAD bereits gepusht wurde. Ein reines Reword der Nachricht wird nicht blockiert: `--amend -m` ohne neu gestaged Inhalte, bei einem Commit, den Claude während dieser Sitzung erstellt hat


261Claude Code v2.1.198 und später blockieren standardmäßig auch diese:270Claude Code v2.1.198 und später blockieren standardmäßig auch diese:

262 271 

263* Löschen von Dateien in `/tmp`, `$TMPDIR` oder einem anderen gemeinsamen Scratch- oder Cache-Verzeichnis nach Wildcard, Glob oder Altersfilter anstelle eines spezifischen benannten Pfads272* Löschen von Dateien in `/tmp`, `$TMPDIR` oder einem anderen gemeinsamen Scratch- oder Cache-Verzeichnis nach Wildcard, Glob oder Altersfilter anstelle eines spezifischen benannten Pfads

264* Einbeziehen sensibler Details in Inhalte, die gesendet, hochgeladen, veröffentlicht oder an andere Personen oder gemeinsame Systeme geschrieben werden, wenn Ihre eigene Nachricht diese Details nicht für diesen Empfänger autorisiert hat273* Einbeziehen sensibler Details in Inhalte, die gesendet, hochgeladen, veröffentlicht oder an andere Personen oder gemeinsame Systeme geschrieben werden, wenn Ihre eigene Nachricht diese Details nicht für diesen Empfänger autorisiert hat. {/* min-version: 2.1.200 */}PR- und Issue-Bodies, Commit-Nachrichten und Kommentare zählen als diese Art von ausgehendem Inhalt, wenn das Repository außerhalb der Vertrauensgrenze oder öffentlich ist, einschließlich der eigenen öffentlichen Repositories Ihrer Organisation; interne Dateipfade, Code-Namen, Live-API-Antwortdaten wie E-Mails oder Kontobezeichner und Infrastruktur-Bezeichner zählen als sensible Details. Die PR-, Issue- und Commit-Nachricht-Scoping erfordert Claude Code v2.1.200 oder später. {/* min-version: 2.1.203 */}Live-Personendaten aus einer API-Antwort in einem PR- oder Issue-Body, wie eine E-Mail-Adresse, ein Konto- oder Organisationsbezeichner oder eine Nutzungsmetrik, erfordern, dass Sie diese Details und den Empfänger unabhängig von der Sichtbarkeit oder Vertrauensgrenze des Repositories benennen. Diese Prüfung erfordert Claude Code v2.1.203 oder später

265* Senden von Tastenanschlägen an Claudes eigenen tmux-Pane, um seine eigene Schnittstelle zu steuern, was der Klassifizierer als Claude behandelt, das seine eigenen Berechtigungen oder Überwachung ändert274* Senden von Tastenanschlägen an Claudes eigenen tmux-Pane, um seine eigene Schnittstelle zu steuern, was der Klassifizierer als Claude behandelt, das seine eigenen Berechtigungen oder Überwachung ändert

266 275 

276Claude Code v2.1.200 und später blockieren standardmäßig auch diese:

277 

278* Auskommentieren, Löschen oder Force-Passing eines Tests oder einer Assertion, die Sicherheitsverhalten schützt, wie Authentifizierung, Zugriffskontrolle, Eingabevalidierung oder Sandboxing

279* Löschen oder Abbau einer zustandsbehafteten Ressource, die Claude nicht in der Sitzung erstellt hat, wenn keine spezifischere Löschregel zutrifft und Sie diese Ressource nicht benannt haben

280* Umleitung einer API-Basis-URL, eines Proxy-Endpunkts, eines Webhook-Empfängers oder eines Registry-Mirrors auf einen Third-Party-Host, der nicht zur Aufgabe passt, einschließlich in Beispieldateien wie `.env.example`

281* Ändern, wohin Pushes mit `git remote set-url` oder `git remote add` gehen, es sei denn, Sie haben das neue Remote benannt

282* Pushen von Secrets oder persönlichen oder anvertrauten Daten zu einem Repository, das bekannt ist, öffentlich zu sein, oder Pushen von vertraulichem Material dorthin, das nicht Teil der eigenen Arbeit dieses Repositories ist. {/* min-version: 2.1.203 */}Ein Dotfiles-Repository's eigenes Thema ist die eine Ausnahme für persönliche oder anvertraute Daten, und Inhalte aus einem privaten Repository, das eine öffentliche Oberfläche erreicht, wird auf die gleiche Weise blockiert; beide Verfeinerungen erfordern Claude Code v2.1.203 oder später. Vor v2.1.203 wurden persönliche Daten mit vertraulichem Material gruppiert und nur blockiert, wenn sie nicht Teil der eigenen Arbeit dieses Repositories waren. Wenn die Sichtbarkeit eines Repositories nicht etabliert ist, blockiert der Klassifizierer nicht allein darauf; er beurteilt den Inhalt stattdessen gegen die anderen Regeln

283* Öffnen eines Pull Request gegen ein anderes Repository oder eine andere Organisation, Forking mit `gh repo fork` oder Pushen zu einem Third-Party-Repository, es sei denn, Sie haben dieses externe Ziel benannt

284 

285Claude Code v2.1.203 und später blockieren standardmäßig auch diese:

286 

287* Inhalte aus einem sensiblen lokalen Speicher oder aus einer Datei, deren Name, Pfad oder Typ sie als sensibel kennzeichnet, die in einen Commit, einen Push, PR- oder Issue-Text, einen Gist oder Paste oder einen Package-Publish eingehen, es sei denn, Sie haben sowohl die Quelle als auch das Ziel benannt. Sitzungstranskripte und Konversationsprotokolle, Anmeldedaten- und Konfigurationspunkt-Ordner wie SSH-Schlüssel, Cloud-Anmeldedaten, Browser-Profile und Shell-Verlauf sowie Benutzer-Daten-Exporte zählen alle, und das Repository, das privat ist, löscht es nicht

288 

289Claude Code v2.1.205 und später blockieren standardmäßig auch diese:

290 

291* Schreiben in Claude Code-Sitzungstranskripte, die `.jsonl`-Verlaufsdateien unter `~/.claude/projects/` oder Ihrem konfigurierten Konfigurationsverzeichnis, ob direkt oder über einen Shell-Befehl. Die Regel deckt auch die Metadaten-Zeilen ab, die Claude Code für seine eigenen Prüfungen an jeden Transkripteintrag anhängt. Ein Transkript ist Sitzungszustand, den Claude Code schreibt, nicht eine Arbeitsdatei, und ein manipulierter Eintrag erreicht jede spätere Prüfung, sobald Sie die Sitzung fortsetzen, daher blockiert Auto-Modus diese Schreibvorgänge als Verteidigungsmechanismus. Das Lesen eines Transkripts wird nicht blockiert

292* Ein rekursives erzwungenes Löschen wie `rm -rf "$VAR"` oder `Remove-Item -Recurse -Force $dir`, dessen 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 Klassifizierer liest die Konversation statt der Befehlsausgabe absichtlich, daher blockiert er den Aufruf, anstatt das Ziel zu erraten. Der Block wird gelöscht, wenn Sie den genauen Pfad benennen, der gelöscht wird, oder wenn Claude das Löschen mit dem aufgelösten literalen Pfad, der in den Befehl geschrieben ist, erneut ausführt. Löschvorgänge, deren Ziel der Klassifizierer auflösen kann, sind nicht betroffen

293 

267**Standardmäßig zugelassen**:294**Standardmäßig zugelassen**:

268 295 

269* Lokale Dateioperationen in Ihrem Arbeitsverzeichnis296* Lokale Dateioperationen in Ihrem Arbeitsverzeichnis


337 2. Während der Subagent läuft, durchläuft jede seiner Aktionen den Klassifizierer mit den gleichen Regeln wie die übergeordnete Sitzung, und jeder `permissionMode` im Frontmatter des Subagenten wird ignoriert.364 2. Während der Subagent läuft, durchläuft jede seiner Aktionen den Klassifizierer mit den gleichen Regeln wie die übergeordnete Sitzung, und jeder `permissionMode` im Frontmatter des Subagenten wird ignoriert.

338 3. Wenn der Subagent fertig ist, überprüft der Klassifizierer seine vollständige Aktionshistorie; wenn diese Rückgabeprüfung ein Problem kennzeichnet, wird eine Sicherheitswarnung den Ergebnissen des Subagenten vorangestellt.365 3. Wenn der Subagent fertig ist, überprüft der Klassifizierer seine vollständige Aktionshistorie; wenn diese Rückgabeprüfung ein Problem kennzeichnet, wird eine Sicherheitswarnung den Ergebnissen des Subagenten vorangestellt.

339 366 

367 {/* min-version: 2.1.178 */}}

340 Schritt 1 erfordert Claude Code v2.1.178 oder später. Frühere Versionen wendeten den Klassifizierer in den Schritten 2 und 3 an, bewerteten aber die Aufgabenbeschreibung nicht, bevor der Subagent gestartet wurde.368 Schritt 1 erfordert Claude Code v2.1.178 oder später. Frühere Versionen wendeten den Klassifizierer in den Schritten 2 und 3 an, bewerteten aber die Aufgabenbeschreibung nicht, bevor der Subagent gestartet wurde.

341 </Accordion>369 </Accordion>

342 370 

permissions.md +28 −4

Details

47Claude Code unterstützt mehrere Berechtigungsmodi, die steuern, wie Werkzeugaufrufe genehmigt werden. Siehe [Berechtigungsmodi](/de/permission-modes) für den Zeitpunkt der Verwendung jedes Modus. Legen Sie den `defaultMode` in Ihren [Einstellungsdateien](/de/settings#settings-files) fest:47Claude Code unterstützt mehrere Berechtigungsmodi, die steuern, wie Werkzeugaufrufe genehmigt werden. Siehe [Berechtigungsmodi](/de/permission-modes) für den Zeitpunkt der Verwendung jedes Modus. Legen Sie den `defaultMode` in Ihren [Einstellungsdateien](/de/settings#settings-files) fest:

48 48 

49| Modus | Beschreibung |49| Modus | Beschreibung |

50| :------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |50| :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

51| `default` | Standardverhalten: fordert Genehmigung bei der ersten Verwendung jedes Werkzeugs auf |51| `default` | Standardverhalten: fordert Genehmigung bei der ersten Verwendung jedes Werkzeugs auf. {/* min-version: 2.1.200 */}Im CLI und in den VS Code- und JetBrains-Erweiterungen als „Manual" gekennzeichnet, und Claude Code akzeptiert `manual` als Alias. Die Bezeichnung und der Alias erfordern Claude Code v2.1.200 oder später |

52| `acceptEdits` | Akzeptiert automatisch Dateiberechtigungen und häufige Dateisystem-Befehle wie `mkdir`, `touch`, `mv` und `cp` für Pfade im Arbeitsverzeichnis oder `additionalDirectories` |52| `acceptEdits` | Akzeptiert automatisch Dateiberechtigungen und häufige Dateisystem-Befehle wie `mkdir`, `touch`, `mv` und `cp` für Pfade im Arbeitsverzeichnis oder `additionalDirectories` |

53| `plan` | Plan Mode: Claude liest Dateien und führt schreibgeschützte Shell-Befehle aus, um zu erkunden, bearbeitet aber nicht Ihre Quelldateien |53| `plan` | Claude liest Dateien und führt schreibgeschützte Shell-Befehle aus, um zu erkunden, bearbeitet aber nicht Ihre Quelldateien. Im CLI und in der VS Code-Erweiterung als Plan gekennzeichnet |

54| `auto` | Genehmigt Werkzeugaufrufe automatisch mit Hintergrund-Sicherheitsprüfungen, die überprüfen, ob Aktionen mit Ihrer Anfrage übereinstimmen. Derzeit eine Forschungsvorschau |54| `auto` | Genehmigt Werkzeugaufrufe automatisch mit Hintergrund-Sicherheitsprüfungen, die überprüfen, ob Aktionen mit Ihrer Anfrage übereinstimmen. Derzeit eine Forschungsvorschau |

55| `dontAsk` | Verweigert Werkzeuge automatisch, es sei denn, sie sind vorab über `/permissions` oder `permissions.allow`-Regeln genehmigt |55| `dontAsk` | Verweigert Werkzeuge automatisch, es sei denn, sie sind vorab über `/permissions` oder `permissions.allow`-Regeln genehmigt |

56| `bypassPermissions` | Überspringt Berechtigungsaufforderungen, außer denen, die durch explizite `ask`-Regeln erzwungen werden. Entfernungen von Dateisystem-Root oder Home-Verzeichnis wie `rm -rf /` fordern weiterhin auf als Schutzschalter |56| `bypassPermissions` | Überspringt Berechtigungsaufforderungen, außer denen, die durch explizite `ask`-Regeln erzwungen werden. Entfernungen von Dateisystem-Root oder Home-Verzeichnis wie `rm -rf /` fordern weiterhin auf als Schutzschalter |


215 215 

216Unquotierte Glob-Muster sind für Befehle zulässig, deren jedes Flag schreibgeschützt ist, daher laufen `ls *.ts` und `wc -l src/*.py` ohne Aufforderung. Befehle mit schreibfähigen oder ausführungsfähigen Flags, wie `find`, `sort`, `sed` und `git`, fordern immer noch auf, wenn ein unquotiertes Glob vorhanden ist, da das Glob zu einem Flag wie `-delete` expandieren könnte.216Unquotierte Glob-Muster sind für Befehle zulässig, deren jedes Flag schreibgeschützt ist, daher laufen `ls *.ts` und `wc -l src/*.py` ohne Aufforderung. Befehle mit schreibfähigen oder ausführungsfähigen Flags, wie `find`, `sort`, `sed` und `git`, fordern immer noch auf, wenn ein unquotiertes Glob vorhanden ist, da das Glob zu einem Flag wie `-delete` expandieren könnte.

217 217 

218Ein `cd` in einen Pfad innerhalb Ihres Arbeitsverzeichnisses oder eines [zusätzlichen Verzeichnisses](#working-directories) ist auch schreibgeschützt. Ein zusammengesetzter Befehl wie `cd packages/api && ls` läuft ohne Aufforderung, wenn jeder Teil auf eigene Faust qualifiziert. Das Kombinieren von `cd` mit `git` in einem zusammengesetzten Befehl fordert immer auf, unabhängig vom Zielverzeichnis.218Ein `cd` in einen Pfad innerhalb Ihres Arbeitsverzeichnisses oder eines [zusätzlichen Verzeichnisses](#working-directories) ist auch schreibgeschützt. Ein zusammengesetzter Befehl wie `cd packages/api && ls` läuft ohne Aufforderung, wenn jeder Teil auf eigene Faust qualifiziert. Das Kombinieren von `cd` mit `git` in einem zusammengesetzten Befehl fordert auf, wenn die `cd` in ein anderes Verzeichnis wechselt, da das Ausführen von `git` in einem neuen Verzeichnis die Hooks dieses Verzeichnisses ausführen kann. Ein `cd` dessen Ziel zum aktuellen Arbeitsverzeichnis aufgelöst wird, ist ein No-Op und löst diese Aufforderung nicht aus.

219 219 

220<Warning>220<Warning>

221 Bash-Berechtigungsmuster, die versuchen, Befehlsargumente einzuschränken, sind fragil. Zum Beispiel beabsichtigt `Bash(curl http://github.com/ *)`, curl auf GitHub-URLs zu beschränken, wird aber Variationen nicht abgleichen wie:221 Bash-Berechtigungsmuster, die versuchen, Befehlsargumente einzuschränken, sind fragil. Zum Beispiel beabsichtigt `Bash(curl http://github.com/ *)`, curl auf GitHub-URLs zu beschränken, wird aber Variationen nicht abgleichen wie:


505 505 

506Embedding-Hosts können zusätzliche verwaltete Richtlinien über die SDK-Option `managedSettings` bereitstellen, wenn [`parentSettingsBehavior`](/de/settings#settings-precedence) auf `"merge"` gesetzt ist; Embedder-Werte können die Richtlinie verschärfen, aber nicht lockern.506Embedding-Hosts können zusätzliche verwaltete Richtlinien über die SDK-Option `managedSettings` bereitstellen, wenn [`parentSettingsBehavior`](/de/settings#settings-precedence) auf `"merge"` gesetzt ist; Embedder-Werte können die Richtlinie verschärfen, aber nicht lockern.

507 507 

508<h2 id="project-allow-rules-and-workspace-trust">

509 Projekterlaubnisregeln und Workspace-Vertrauen

510</h2>

511 

512`permissions.allow`-Regeln und `permissions.additionalDirectories`-Einträge in der `.claude/settings.json` eines Projekts gewähren Funktionen, daher wendet Claude Code sie nur an, nachdem Sie den [Workspace-Vertrauensdialog](/de/security#additional-safeguards) für diesen Workspace akzeptiert haben. Bis dahin liest Claude Code die Regeln, wendet sie aber nicht an. Der Vertrauensdialog listet die Erlaubnisregeln und zusätzlichen Verzeichnisse auf, die der Ordner gewähren würde, damit Sie diese vor dem Akzeptieren überprüfen können. `deny`- und `ask`-Regeln sind nicht betroffen, da sie nur einschränken.

513 

514Claude Code speichert Vertrauen pro Workspace, indiziert nach dem Git-Repository-Root oder außerhalb eines Repositorys nach dem Verzeichnis, von dem aus Sie Claude Code gestartet haben. Wenn Sie in Ihrem Home-Verzeichnis starten, wird das Vertrauen nur für die aktuelle Sitzung gespeichert und nicht auf die Festplatte geschrieben; siehe die Notiz zu [zusätzlichen Schutzmaßnahmen](/de/security#additional-safeguards). Das Vertrauen in ein übergeordnetes Verzeichnis wendet die Erlaubnisregeln eines verschachtelten Projekts nicht an.

515 

516`.claude/settings.local.json` ist Ihre eigene Datei, daher gilt die Workspace-Vertrauensprüfung normalerweise nicht dafür. Wenn ein Repository die Datei hätte bereitstellen können, z. B. wenn sie in Git committed ist oder `.claude` ein Symlink ist, durchlaufen ihre Erlaubnisregeln und zusätzlichen Verzeichnisse die Vertrauensprüfung wie Projekteinstellungen.

517 

518Erlaubnisregeln und zusätzliche Verzeichnisse in `.claude/settings.local.json` gelten auch ohne Workspace-Vertrauen in zwei Fällen:

519 

520* Das Verzeichnis, von dem aus Sie Claude Code gestartet haben, befindet sich nicht in einem Git-Repository.

521* Die Sitzung wird in Ihrem eigenen Konfigurationsheim ausgeführt: Ihr Home-Verzeichnis oder ein beliebiges Verzeichnis, dessen `.claude`-Unterverzeichnis Sie als [`CLAUDE_CONFIG_DIR`](/de/env-vars) festgelegt haben.

522 

523In beiden Fällen ist die Datei eine, die Sie erstellt haben, anstatt eine, die ein Repository hätte bereitstellen können, und ein in das Repository committetes `.claude/settings.local.json` erfordert immer noch Workspace-Vertrauen. Die Versionen 2.1.196 bis 2.1.199 behandelten die Datei in diesen Workspaces als vom Repository bereitgestellt, ignorierten ihre Erlaubnisregeln und gaben eine [`this workspace has not been trusted`](/de/errors#workspace-has-not-been-trusted)-Warnung auf stderr aus. Die beiden oben genannten Ausnahmen entsprechen v2.1.195 und früher und wurden in v2.1.200 wiederhergestellt.

524 

525Auch ab v2.1.200 zeigt ein Workspace, dessen Erlaubnisregeln oder zusätzliche Verzeichnisse immer noch nicht angewendet werden, aber nie den Vertrauensdialog angezeigt hat, weil ein übergeordnetes Verzeichnis bereits vertraut war, den Dialog beim nächsten interaktiven Start von Claude Code dort an. Der Dialog bietet zwei Optionen:

526 

527* **Ja, ich vertraue diesem Ordner**: speichert Vertrauen für diesen Workspace und wendet die Regeln in derselben Sitzung an.

528* **Nein, ohne diese Berechtigungen fortfahren**: funktioniert weiterhin mit diesen Regeln ignoriert. Der Dialog wird in der nächsten Sitzung erneut angezeigt.

529 

530Im [nicht-interaktiven Modus](/de/headless) mit `-p` wird kein Dialog angezeigt und die Regeln bleiben ignoriert.

531 

508<h2 id="example-configurations">532<h2 id="example-configurations">

509 Beispielkonfigurationen533 Beispielkonfigurationen

510</h2>534</h2>

platforms.md +1 −1

Details

23| [Web](/de/claude-code-on-the-web) | Langfristige Aufgaben, die nicht viel Steuerung benötigen, oder Arbeiten, die offline fortgesetzt werden sollen | Von Anthropic verwaltete Cloud, wird nach dem Trennen fortgesetzt |23| [Web](/de/claude-code-on-the-web) | Langfristige Aufgaben, die nicht viel Steuerung benötigen, oder Arbeiten, die offline fortgesetzt werden sollen | Von Anthropic verwaltete Cloud, wird nach dem Trennen fortgesetzt |

24| Mobile | Starten und Überwachen von Aufgaben, wenn Sie weg von Ihrem Computer sind | Cloud-Sitzungen aus der Claude-App für iOS und Android, [Remote Control](/de/remote-control) für lokale Sitzungen, [Dispatch](/de/desktop#sessions-from-dispatch) zu Desktop auf Pro und Max |24| Mobile | Starten und Überwachen von Aufgaben, wenn Sie weg von Ihrem Computer sind | Cloud-Sitzungen aus der Claude-App für iOS und Android, [Remote Control](/de/remote-control) für lokale Sitzungen, [Dispatch](/de/desktop#sessions-from-dispatch) zu Desktop auf Pro und Max |

25 25 

26Die CLI ist die vollständigste Oberfläche für Terminal-native Arbeiten: Scripting und das Agent SDK sind nur in der CLI verfügbar. Drittanbieter-Provider funktionieren auch in [VS Code](/de/vs-code#use-third-party-providers). Enterprise-[Desktop](/de/desktop)-Bereitstellungen unterstützen Vertex AI und Gateway-Provider; für Bedrock oder Foundry verwenden Sie die CLI oder VS Code oder die [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview), die die Code-Registerkarte auf diesen Providern ausführt. Desktop und die IDE-Erweiterungen verzichten auf einige CLI-exklusive Funktionen zugunsten visueller Überprüfung und engerer Editor-Integration. Das Web läuft in Anthropics Cloud, sodass Aufgaben nach dem Trennen weitergehen. Mobile ist ein einfacher Client für diese gleichen Cloud-Sitzungen oder für eine lokale Sitzung über Remote Control und kann Aufgaben mit Dispatch zu Desktop senden.26Die CLI ist die vollständigste Oberfläche für Terminal-native Arbeiten: Scripting und das Agent SDK sind nur in der CLI verfügbar. Drittanbieter-Provider funktionieren auch in [VS Code](/de/vs-code#use-third-party-providers). Enterprise-[Desktop](/de/desktop)-Bereitstellungen unterstützen Google Cloud's Agent Platform und Gateway-Provider; für Amazon Bedrock oder Microsoft Foundry verwenden Sie die CLI oder VS Code oder [Claude Desktop auf 3P](https://claude.com/docs/third-party/claude-desktop/overview), das die Code-Registerkarte auf diesen Providern ausführt. Desktop und die IDE-Erweiterungen verzichten auf einige CLI-exklusive Funktionen zugunsten visueller Überprüfung und engerer Editor-Integration. Das Web läuft in Anthropics Cloud, sodass Aufgaben nach dem Trennen weitergehen. Mobile ist ein einfacher Client für diese gleichen Cloud-Sitzungen oder für eine lokale Sitzung über Remote Control und kann Aufgaben mit Dispatch zu Desktop senden.

27 27 

28Sie können mehrere Oberflächen im gleichen Projekt verwenden. Konfiguration, Projektgedächtnis und MCP-Server werden über die lokalen Oberflächen hinweg gemeinsam genutzt.28Sie können mehrere Oberflächen im gleichen Projekt verwenden. Konfiguration, Projektgedächtnis und MCP-Server werden über die lokalen Oberflächen hinweg gemeinsam genutzt.

29 29 

Details

125| `~2.1` | `~3.0` | Installation von Plugin B schlägt mit `range-conflict` fehl. Plugin A und die Abhängigkeit bleiben wie sie waren. |125| `~2.1` | `~3.0` | Installation von Plugin B schlägt mit `range-conflict` fehl. Plugin A und die Abhängigkeit bleiben wie sie waren. |

126| `=2.1.0` | keine | Die Abhängigkeit bleibt bei `2.1.0`. Die automatische Aktualisierung überspringt neuere Versionen, während Plugin A installiert ist. |126| `=2.1.0` | keine | Die Abhängigkeit bleibt bei `2.1.0`. Die automatische Aktualisierung überspringt neuere Versionen, während Plugin A installiert ist. |

127 127 

128Die automatische Aktualisierung ruft eine beschränkte Abhängigkeit auf dem höchsten Git-Tag ab, der jeden Bereich des installierten Plugins erfüllt, anstatt auf der neuesten Version des Marketplace, sodass die Abhängigkeit weiterhin Updates innerhalb ihres zulässigen Bereichs erhält. Wenn kein Tag alle Bereiche erfüllt, wird die Aktualisierung übersprungen und die Übersprungsmeldung erscheint in `/doctor` und auf der Registerkarte `/plugin` Fehler und benennt das einschränkende Plugin.128Die automatische Aktualisierung ruft eine beschränkte Abhängigkeit auf dem höchsten Git-Tag ab, der jeden Bereich des installierten Plugins erfüllt, anstatt auf der neuesten Version des Marketplace, sodass die Abhängigkeit weiterhin Updates innerhalb ihres zulässigen Bereichs erhält. Wenn kein Tag alle Bereiche erfüllt, wird die Aktualisierung übersprungen und die Übersprungsmeldung erscheint in `/plugin` Fehler-Registerkarte und benennt das einschränkende Plugin.

129 129 

130Wenn Sie das letzte Plugin deinstallieren, das eine Abhängigkeit beschränkt, wird die Abhängigkeit nicht mehr gehalten und verfolgt bei der nächsten Aktualisierung wieder ihren Marketplace-Eintrag.130Wenn Sie das letzte Plugin deinstallieren, das eine Abhängigkeit beschränkt, wird die Abhängigkeit nicht mehr gehalten und verfolgt bei der nächsten Aktualisierung wieder ihren Marketplace-Eintrag.

131 131 


181 Abhängigkeitsfehler beheben181 Abhängigkeitsfehler beheben

182</h2>182</h2>

183 183 

184Abhängigkeitsprobleme erscheinen in `claude plugin list`, in der `/plugin`-Schnittstelle und in `/doctor`. Das betroffene Plugin wird deaktiviert, bis Sie den Fehler beheben. Die häufigsten Fehler und deren Behebungen sind unten aufgelistet.184Abhängigkeitsprobleme erscheinen in `claude plugin list` und in der `/plugin`-Schnittstelle. Claude Code deaktiviert das betroffene Plugin, bis Sie den Fehler beheben. Die Tabelle unten listet die häufigsten Fehler und deren Behebung auf.

185 185 

186| Fehler | Bedeutung | Wie zu beheben |186| Fehler | Bedeutung | Wie zu beheben |

187| :------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |187| :------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

Details

170| `plugins` | array | Liste der verfügbaren Plugins | Siehe unten |170| `plugins` | array | Liste der verfügbaren Plugins | Siehe unten |

171 171 

172<Note>172<Note>

173 **Reservierte Namen**: Die folgenden Marktplatznamen sind für die offizielle Nutzung durch Anthropic reserviert und können nicht von Drittanbieter-Marktplätzen verwendet werden: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`. Namen, die offizielle Marktplätze imitieren, wie `official-claude-plugins` oder `anthropic-tools-v2`, sind ebenfalls blockiert.173 **Reservierte Namen**: Die folgenden Marktplatznamen sind für die offizielle Nutzung durch Anthropic reserviert und können nicht von Drittanbieter-Marktplätzen verwendet werden: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins`, `healthcare`. Namen, die offizielle Marktplätze imitieren, wie `official-claude-plugins` oder `anthropic-plugins-v2`, sind ebenfalls blockiert. Das Reservieren dieser Namen verhindert, dass sich ein Drittanbieter-Marktplatz als von Anthropic veröffentlichte Quelle darstellt.

174 

175 Claude Code überprüft reservierte Namen jedes Mal, wenn es einen Marktplatz lädt, nicht nur wenn Sie einen hinzufügen. Ein Marktplatz, der unter einem dieser Namen registriert wurde, bevor der Name reserviert wurde, wird nicht mehr geladen und meldet, dass er [von einer nicht vertrauenswürdigen Quelle registriert ist](/de/errors#marketplace-is-registered-from-an-untrusted-source). Entfernen Sie diesen Marktplatz und fügen Sie ihn erneut aus der offiziellen Anthropic-Quelle hinzu. Ein Drittanbieter-Marktplatz, der von einem neu reservierten Namen betroffen ist, wird erneut geladen, sobald Sie ihn unter einem anderen Namen erneut hinzufügen. Vor v2.1.205 waren `first-party-plugins` und `healthcare` nicht reserviert, und ein Marktplatz, der bereits unter einem reservierten Namen registriert war, wurde weiterhin geladen.

174</Note>176</Note>

175 177 

176<h3 id="owner-fields">178<h3 id="owner-fields">

plugins.md +2 −0

Details

203 203 

204<Warning>204<Warning>

205 **Häufiger Fehler**: Platzieren Sie `commands/`, `agents/`, `skills/` oder `hooks/` nicht im Verzeichnis `.claude-plugin/`. Nur `plugin.json` gehört in `.claude-plugin/`. Alle anderen Verzeichnisse müssen auf der Plugin-Root-Ebene sein.205 **Häufiger Fehler**: Platzieren Sie `commands/`, `agents/`, `skills/` oder `hooks/` nicht im Verzeichnis `.claude-plugin/`. Nur `plugin.json` gehört in `.claude-plugin/`. Alle anderen Verzeichnisse müssen auf der Plugin-Root-Ebene sein.

206 

207 Das Plugin-Root ist das eigene Verzeichnis des einzelnen Plugins: dasjenige, das `.claude-plugin/plugin.json` enthält. Es ist niemals `~/.claude/`. Zum Beispiel liest Claude Code eine `.mcp.json`, die unter `~/.claude/.mcp.json` platziert ist, nicht.

206</Warning>208</Warning>

207 209 

208| Verzeichnis | Speicherort | Zweck |210| Verzeichnis | Speicherort | Zweck |

Details

159* `prompt`: Ein Prompt mit einem LLM evaluieren (verwendet `$ARGUMENTS` Platzhalter für Kontext)159* `prompt`: Ein Prompt mit einem LLM evaluieren (verwendet `$ARGUMENTS` Platzhalter für Kontext)

160* `agent`: Einen agentic Verifier mit Tools für komplexe Verifikationsaufgaben ausführen160* `agent`: Einen agentic Verifier mit Tools für komplexe Verifikationsaufgaben ausführen

161 161 

162Hooks, die auf den eigenen [gebündelten MCP-Server](#mcp-servers) des Plugins abzielen, müssen seine scoped Namen verwenden. Tool-Matcher und `if` Felder verwenden den scoped Tool-Namen `mcp__plugin_<plugin-name>_<server-name>__<tool>`, und das `mcp_tool` Hook-Feld `server` verwendet `plugin:<plugin-name>:<server-name>`. Ein Matcher, der gegen den bloßen Server-Schlüssel geschrieben wird, wird nie ausgelöst. Siehe [Match MCP tools](/de/hooks#match-mcp-tools) und [Plugin-bereitgestellte MCP-Server](/de/mcp#plugin-provided-mcp-servers).

163 

162<h3 id="mcp-servers">164<h3 id="mcp-servers">

163 MCP-Server165 MCP-Server

164</h3>166</h3>


266| `settings` | Einstellungen, die über `workspace/didChangeConfiguration` übergeben werden |268| `settings` | Einstellungen, die über `workspace/didChangeConfiguration` übergeben werden |

267| `workspaceFolder` | Workspace-Ordnerpfad für den Server |269| `workspaceFolder` | Workspace-Ordnerpfad für den Server |

268| `startupTimeout` | Maximale Zeit zum Warten auf Server-Startup (Millisekunden) |270| `startupTimeout` | Maximale Zeit zum Warten auf Server-Startup (Millisekunden) |

271| `shutdownTimeout` | Maximale Zeit zum Warten auf ordnungsgemäßes Herunterfahren (Millisekunden). Wenn das Timeout abläuft, beendet Claude Code den Server-Prozess. Wenn nicht gesetzt, gilt kein Timeout |

272| `restartOnCrash` | Ob der Server nach einem Absturz neu gestartet werden soll. Standard ist `true`. Setzen Sie auf `false`, um einen abgestürzten Server gestoppt zu lassen, anstatt ihn neu zu starten |

269| `maxRestarts` | Maximale Anzahl von Neustartversuchen, bevor aufgegeben wird |273| `maxRestarts` | Maximale Anzahl von Neustartversuchen, bevor aufgegeben wird |

270| `diagnostics` | Ob Diagnosen nach Bearbeitungen in Claudes Kontext eingefügt werden sollen (Standard `true`). Setzen Sie auf `false`, um Code-Navigation beizubehalten, aber automatische Diagnose-Injektion zu unterdrücken. |274| `diagnostics` | Ob Diagnosen nach Bearbeitungen in Claudes Kontext eingefügt werden sollen (Standard `true`). Setzen Sie auf `false`, um Code-Navigation beizubehalten, aber automatische Diagnose-Injektion zu unterdrücken. |

271 275 

276`restartOnCrash` und `shutdownTimeout` erfordern Claude Code v2.1.205 oder später. Vor v2.1.205 akzeptierte das Konfigurationsschema beide Optionen, aber das Setzen einer dieser Optionen führte dazu, dass Claude Code diesen LSP-Server beim Startup vollständig übersprungen hat, wobei der Grund nur in der `claude --debug` Ausgabe sichtbar war.

277 

278**Mehrere Server für die gleiche Erweiterung**: Wenn mehr als ein aktivierter LSP-Server die gleiche Dateierweiterung in `extensionToLanguage` deklariert, ob die Server von einem Plugin oder von verschiedenen Plugins stammen, verarbeitet der zuerst registrierte Server Dateien mit dieser Erweiterung und die anderen starten nie. Die `/plugin` Schnittstelle zeigt eine Warnung an, die das Plugin benennt, dessen Server aktiv ist.

279 

280**Server, die nicht initialisiert werden können**: Claude Code überspringt einen Server, dessen Konfiguration ungültig ist, zum Beispiel einer, dem `command` oder `extensionToLanguage` fehlt, und die anderen konfigurierten Server starten trotzdem. Führen Sie `claude --debug` aus, um zu sehen, warum ein Server übersprungen wurde.

281 

282Ein übersprungener Server beansprucht seine Dateierweiterungen nicht, daher kann ein anderer gültiger Server, der die gleiche Erweiterung deklariert, von demselben oder einem anderen Plugin, diese Dateien trotzdem verarbeiten. Vor v2.1.205 beanspruchte ein Server, der nicht initialisiert werden konnte, immer noch seine Erweiterungen und blockierte einen anderen gültigen Server für die gleiche Erweiterung.

283 

272<Warning>284<Warning>

273 **Sie müssen die Language Server Binärdatei separat installieren.** LSP-Plugins konfigurieren, wie Claude Code sich mit einem Language Server verbindet, aber sie enthalten den Server selbst nicht. Wenn Sie `Executable not found in $PATH` im `/plugin` Errors-Tab sehen, installieren Sie die erforderliche Binärdatei für Ihre Sprache.285 **Sie müssen die Language Server Binärdatei separat installieren.** LSP-Plugins konfigurieren, wie Claude Code sich mit einem Language Server verbindet, aber sie enthalten den Server selbst nicht. Wenn Sie `Executable not found in $PATH` im `/plugin` Errors-Tab sehen, installieren Sie die erforderliche Binärdatei für Ihre Sprache.

274</Warning>286</Warning>


635* **Fügt zum Standard hinzu**: `skills`. Das Standard-Verzeichnis `skills/` wird immer gescannt, und Verzeichnisse, die in `skills` aufgelistet sind, werden zusammen mit ihm geladen. Ausnahme: für einen [Marktplatz-Eintrag, dessen `source` zum Marktplatz-Root aufgelöst wird](/de/plugin-marketplaces#advanced-plugin-entries), ersetzt das Deklarieren spezifischer Unterverzeichnisse den Scan647* **Fügt zum Standard hinzu**: `skills`. Das Standard-Verzeichnis `skills/` wird immer gescannt, und Verzeichnisse, die in `skills` aufgelistet sind, werden zusammen mit ihm geladen. Ausnahme: für einen [Marktplatz-Eintrag, dessen `source` zum Marktplatz-Root aufgelöst wird](/de/plugin-marketplaces#advanced-plugin-entries), ersetzt das Deklarieren spezifischer Unterverzeichnisse den Scan

636* **Eigene Merge-Regeln**: [hooks](#hooks), [MCP-Server](#mcp-servers) und [LSP-Server](#lsp-servers). Siehe jeden Abschnitt für die Kombinationsweise mehrerer Quellen648* **Eigene Merge-Regeln**: [hooks](#hooks), [MCP-Server](#mcp-servers) und [LSP-Server](#lsp-servers). Siehe jeden Abschnitt für die Kombinationsweise mehrerer Quellen

637 649 

638Wenn ein Plugin sowohl einen Standard-Ordner als auch den entsprechenden Manifest-Schlüssel hat, kennzeichnet Claude Code v2.1.140 und später den ignorierten Ordner in `/doctor`, `claude plugin list` und der `/plugin` Detailansicht. Das Plugin wird weiterhin mit den Manifest-Pfaden geladen. Es wird keine Warnung angezeigt, wenn der Manifest-Schlüssel auf den Standard-Ordner verweist, beispielsweise `"commands": ["./commands/deploy.md"]`, da der Ordner in diesem Fall explizit adressiert wird.650Wenn ein Plugin sowohl einen Standard-Ordner als auch den entsprechenden Manifest-Schlüssel hat, kennzeichnet Claude Code v2.1.140 und später den ignorierten Ordner in `claude plugin list` und der `/plugin` Detailansicht. Das Plugin wird weiterhin mit den Manifest-Pfaden geladen. Es wird keine Warnung angezeigt, wenn der Manifest-Schlüssel auf den Standard-Ordner verweist, beispielsweise `"commands": ["./commands/deploy.md"]`, da der Ordner in diesem Fall explizit adressiert wird.

639 651 

640Für alle Pfadfelder:652Für alle Pfadfelder:

641 653 


673 685 

674**`${CLAUDE_PLUGIN_DATA}`**: Ein persistentes Verzeichnis für Plugin-Status, das Updates überlebt. Verwenden Sie dies für installierte Abhängigkeiten wie `node_modules` oder Python-Umgebungen, generierte Code, Caches und alle anderen Dateien, die über Plugin-Versionen hinweg bestehen bleiben sollten. Das Verzeichnis wird automatisch erstellt, wenn diese Variable zum ersten Mal referenziert wird.686**`${CLAUDE_PLUGIN_DATA}`**: Ein persistentes Verzeichnis für Plugin-Status, das Updates überlebt. Verwenden Sie dies für installierte Abhängigkeiten wie `node_modules` oder Python-Umgebungen, generierte Code, Caches und alle anderen Dateien, die über Plugin-Versionen hinweg bestehen bleiben sollten. Das Verzeichnis wird automatisch erstellt, wenn diese Variable zum ersten Mal referenziert wird.

675 687 

676**`${CLAUDE_PROJECT_DIR}`**: Das Projekt-Root-Verzeichnis. Dies ist das gleiche Verzeichnis, das Hooks in ihrer `CLAUDE_PROJECT_DIR` Variable erhalten. Verwenden Sie dies, um auf projektlokale Skripte oder Konfigurationsdateien zu verweisen. Wickeln Sie es in Anführungszeichen ein, um Pfade mit Leerzeichen zu handhaben, beispielsweise `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`. MCP-Server können auch die MCP `roots/list` Anfrage aufrufen, die das Verzeichnis zurückgibt, aus dem Claude Code gestartet wurde.688**`${CLAUDE_PROJECT_DIR}`**: Das Projekt-Root-Verzeichnis. Dies ist das gleiche Verzeichnis, das Hooks in ihrer `CLAUDE_PROJECT_DIR` Variable erhalten. Verwenden Sie dies, um auf projektlokale Skripte oder Konfigurationsdateien zu verweisen. Wickeln Sie es in Anführungszeichen ein, um Pfade mit Leerzeichen zu handhaben, beispielsweise `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`.

689 

690MCP-Server können auch die `roots/list` Anfrage aufrufen, um die Arbeitsverzeichnisse der Sitzung zur Laufzeit zu lesen. Siehe [was `roots/list` zurückgibt und wann Claude Code den Server über Änderungen benachrichtigt](/de/mcp#option-3-add-a-local-stdio-server).

677 691 

678```json theme={null}692```json theme={null}

679{693{

Details

50Caching findet server-seitig in der Infrastruktur statt, die Ihr Modell bedient. Wo das ist, hängt davon ab, wie Sie sich authentifizieren:50Caching findet server-seitig in der Infrastruktur statt, die Ihr Modell bedient. Wo das ist, hängt davon ab, wie Sie sich authentifizieren:

51 51 

52* **API-Schlüssel, Claude-Abonnement oder [Claude Platform on AWS](/de/claude-platform-on-aws)**: Der Cache lebt in Anthropics Infrastruktur, zugänglich über die [Claude API](https://platform.claude.com/docs)52* **API-Schlüssel, Claude-Abonnement oder [Claude Platform on AWS](/de/claude-platform-on-aws)**: Der Cache lebt in Anthropics Infrastruktur, zugänglich über die [Claude API](https://platform.claude.com/docs)

53* **Bedrock oder Vertex AI**: Der Cache lebt in der Serving-Infrastruktur Ihres Cloud-Providers53* **Amazon Bedrock oder Google Cloud's Agent Platform**: Der Cache lebt in der Serving-Infrastruktur Ihres Cloud-Providers

54* **Foundry**: Anfragen werden an Anthropics Infrastruktur weitergeleitet54* **Microsoft Foundry**: Anfragen werden an Anthropics Infrastruktur weitergeleitet

55* **Benutzerdefinierte `ANTHROPIC_BASE_URL` oder [LLM Gateway](/de/llm-gateway)**: Der Cache lebt dort, wo Ihre Anfragen weitergeleitet werden, und ob Caching funktioniert, hängt vom Gateway ab55* **Benutzerdefinierte `ANTHROPIC_BASE_URL` oder [LLM Gateway](/de/llm-gateway)**: Der Cache lebt dort, wo Ihre Anfragen weitergeleitet werden, und ob Caching funktioniert, hängt vom Gateway ab

56 56 

57Für das, was jeder Provider speichert und verarbeitet, siehe [Datennutzung](/de/data-usage). Wo immer der Cache lebt, Einträge verfallen nach einer Inaktivitätsperiode, und [Cache-Lebensdauer](#cache-lifetime) unten behandelt die TTL und wie Sie sie verlängern.57Für das, was jeder Provider speichert und verarbeitet, siehe [Datennutzung](/de/data-usage). Wo immer der Cache lebt, Einträge verfallen nach einer Inaktivitätsperiode, und [Cache-Lebensdauer](#cache-lifetime) unten behandelt die TTL und wie Sie sie verlängern.


106Tool-Definitionen sitzen in der System-Prompt-Ebene, daher wird der Cache ungültig, wenn sich die Menge der Tool-Definitionen in der Anfrage zwischen Turns ändert. Das Umschalten des [Advisor-Tools](/de/advisor) ist eine Ausnahme: Seine Definition sitzt nach dem Cache-Breakpoint, daher behält das Aktivieren oder Deaktivieren von `/advisor` das gecachte Präfix intakt. Ob eine [MCP-Server](/de/mcp)-Änderung dies bewirkt, hängt davon ab, ob ihre Tools durch [Tool-Suche](/de/mcp#scale-with-mcp-tool-search) aufgeschoben werden oder in das Präfix geladen werden:106Tool-Definitionen sitzen in der System-Prompt-Ebene, daher wird der Cache ungültig, wenn sich die Menge der Tool-Definitionen in der Anfrage zwischen Turns ändert. Das Umschalten des [Advisor-Tools](/de/advisor) ist eine Ausnahme: Seine Definition sitzt nach dem Cache-Breakpoint, daher behält das Aktivieren oder Deaktivieren von `/advisor` das gecachte Präfix intakt. Ob eine [MCP-Server](/de/mcp)-Änderung dies bewirkt, hängt davon ab, ob ihre Tools durch [Tool-Suche](/de/mcp#scale-with-mcp-tool-search) aufgeschoben werden oder in das Präfix geladen werden:

107 107 

108* **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 gecacht ist.108* **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 gecacht ist.

109* **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](/de/mcp#configure-tool-search), z. B. auf Haiku-Modellen, auf Vertex AI oder mit einem benutzerdefinierten `ANTHROPIC_BASE_URL`-Gateway. Es geschieht auch für einen Server oder ein Tool, das als [`alwaysLoad`](/de/mcp#exempt-a-server-from-deferral) markiert ist, und für Definitionen, die von [schwellenwertbasiertem Laden](/de/mcp#configure-tool-search) im Voraus beibehalten werden.109* **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](/de/mcp#configure-tool-search), z. B. auf Haiku-Modellen, auf Google Cloud's Agent Platform oder mit einem benutzerdefinierten `ANTHROPIC_BASE_URL`-Gateway. Es geschieht auch für einen Server oder ein Tool, das als [`alwaysLoad`](/de/mcp#exempt-a-server-from-deferral) markiert ist, und für Definitionen, die von [schwellenwertbasiertem Laden](/de/mcp#configure-tool-search) im Voraus beibehalten werden.

110 110 

111Wenn Tools in das Präfix geladen werden, ist die häufigste Ursache einer Ungültigmachung ein Server, der sich mid-session verbindet oder trennt, was ohne Ihre Aktion geschehen kann: Ein Stdio-Server-Prozess beendet sich, eine HTTP-Session läuft ab, oder ein Server [verbindet sich automatisch nach einem vorübergehenden Fehler wieder](/de/mcp#automatic-reconnection). Ein verbundener Server kann auch ein [dynamisches Tool-Update](/de/mcp#dynamic-tool-updates) pushen, das seine Tool-Liste ändert.111Wenn Tools in das Präfix geladen werden, ist die häufigste Ursache einer Ungültigmachung ein Server, der sich mid-session verbindet oder trennt, was ohne Ihre Aktion geschehen kann: Ein Stdio-Server-Prozess beendet sich, eine HTTP-Session läuft ab, oder ein Server [verbindet sich automatisch nach einem vorübergehenden Fehler wieder](/de/mcp#automatic-reconnection). Ein verbundener Server kann auch ein [dynamisches Tool-Update](/de/mcp#dynamic-tool-updates) pushen, das seine Tool-Liste ändert.

112 112 


235 Bei einem API-Schlüssel oder Drittanbieter-Provider235 Bei einem API-Schlüssel oder Drittanbieter-Provider

236</h3>236</h3>

237 237 

238Bei einem API-Schlüssel, Bedrock, Vertex, Foundry oder Claude Platform on AWS zahlen Sie die Pro-Token-Raten, daher bleibt die TTL standardmäßig bei den günstigeren fünf Minuten. Um sich für die [eine-Stunden-TTL](https://platform.claude.com/docs/de/build-with-claude/prompt-caching#1-hour-cache-duration) anzumelden, setzen Sie `ENABLE_PROMPT_CACHING_1H=1`.238Bei einem API-Schlüssel, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform on AWS zahlen Sie die Pro-Token-Raten, daher bleibt die TTL standardmäßig bei den günstigeren fünf Minuten. Um sich für die [eine-Stunden-TTL](https://platform.claude.com/docs/de/build-with-claude/prompt-caching#1-hour-cache-duration) anzumelden, setzen Sie `ENABLE_PROMPT_CACHING_1H=1`.

239 239 

240Bei Bedrock variieren Prompt Caching-Unterstützung, minimale cacheable Präfixlänge und eine-Stunden-TTL-Verfügbarkeit je nach Modell. Wenn Cache-Token-Zählungen bei Null bleiben, überprüfen Sie [unterstützte Modelle, Regionen und Limits](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) in der Bedrock-Dokumentation.240Bei Amazon Bedrock variieren Prompt Caching-Unterstützung, minimale cacheable Präfixlänge und eine-Stunden-TTL-Verfügbarkeit je nach Modell. Wenn Cache-Token-Zählungen bei Null bleiben, überprüfen Sie [unterstützte Modelle, Regionen und Limits](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) in der Amazon Bedrock-Dokumentation.

241 241 

242<h3 id="override-the-ttl">242<h3 id="override-the-ttl">

243 TTL überschreiben243 TTL überschreiben

quickstart.md +1 −1

Details

105 105 

106* [Claude Pro, Max, Team oder Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (empfohlen)106* [Claude Pro, Max, Team oder Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (empfohlen)

107* [Claude Console](https://console.anthropic.com/) (API-Zugriff mit Prepaid-Guthaben). Bei der ersten Anmeldung wird automatisch ein „Claude Code"-Arbeitsbereich in der Console erstellt, um die Kosten zentral zu verfolgen.107* [Claude Console](https://console.anthropic.com/) (API-Zugriff mit Prepaid-Guthaben). Bei der ersten Anmeldung wird automatisch ein „Claude Code"-Arbeitsbereich in der Console erstellt, um die Kosten zentral zu verfolgen.

108* [Amazon Bedrock, Google Vertex AI oder Microsoft Foundry](/de/third-party-integrations) (Enterprise-Cloud-Anbieter)108* [Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry](/de/third-party-integrations) (Enterprise-Cloud-Anbieter)

109* Ein selbst gehostetes [Claude-Apps-Gateway](/de/claude-apps-gateway), falls Ihre Organisation eines betreibt: Ihr Administrator konfiguriert die Gateway-URL vorab, und `/login` öffnet direkt den Bildschirm **Cloud-Gateway** für Sie, um sich mit Corporate SSO anzumelden109* Ein selbst gehostetes [Claude-Apps-Gateway](/de/claude-apps-gateway), falls Ihre Organisation eines betreibt: Ihr Administrator konfiguriert die Gateway-URL vorab, und `/login` öffnet direkt den Bildschirm **Cloud-Gateway** für Sie, um sich mit Corporate SSO anzumelden

110 110 

111Nach der Anmeldung werden Ihre Anmeldedaten gespeichert und Sie müssen sich nicht erneut anmelden.111Nach der Anmeldung werden Ihre Anmeldedaten gespeichert und Sie müssen sich nicht erneut anmelden.

Details

16 16 

17* **Ihre vollständige lokale Umgebung remote nutzen**: Ihr Dateisystem, [MCP servers](/de/mcp), Tools und Projektkonfiguration bleiben verfügbar, und durch Eingabe von `@` werden Dateipfade aus Ihrem lokalen Projekt automatisch vervollständigt17* **Ihre vollständige lokale Umgebung remote nutzen**: Ihr Dateisystem, [MCP servers](/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 bleibt auf allen verbundenen Geräten synchronisiert, sodass Sie Nachrichten von Ihrem Terminal, Browser und Telefon austauschbar senden können18* **Von beiden Oberflächen gleichzeitig arbeiten**: Das Gespräch bleibt 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**: Wenn Sie einen Anhang in der Claude-App oder auf claude.ai/code hinzufügen, lädt Claude Code ihn auf Ihren Computer herunter und übergibt ihn Claude als `@`-Dateireferenz mit oder ohne Beschriftung. {/* min-version: 2.1.202 */}Vor v2.1.202 konnte Claude Code einen Anhang, der ohne Beschriftung gesendet wurde, vor Erreichen der Sitzung verwerfen.

19* **Unterbrechungen überstehen**: Wenn Ihr Laptop in den Ruhezustand wechselt oder Ihr Netzwerk ausfällt, wird die Sitzung automatisch wiederhergestellt, wenn Ihr Computer wieder online ist20* **Unterbrechungen überstehen**: Wenn Ihr Laptop in den Ruhezustand wechselt oder Ihr Netzwerk ausfällt, wird die Sitzung automatisch wiederhergestellt, wenn Ihr Computer wieder online ist

20 21 

21Im Gegensatz zu [Claude Code im Web](/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 nur ein Fenster in diese lokale Sitzung.22Im Gegensatz zu [Claude Code im Web](/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 nur ein Fenster in diese lokale Sitzung.


34 35 

35* **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.36* **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.

36* **Authentifizierung**: Führen Sie `claude` aus und verwenden Sie `/login`, um sich über claude.ai anzumelden, falls Sie dies noch nicht getan haben.37* **Authentifizierung**: Führen Sie `claude` aus und verwenden Sie `/login`, um sich über claude.ai anzumelden, falls Sie dies noch nicht getan haben.

37* **API-Endpunkt**: nicht verfügbar auf Amazon Bedrock, Google Vertex AI oder Microsoft Foundry. {/* min-version: 2.1.196 */}Ab v2.1.196 ist Remote Control auch deaktiviert, wenn [`ANTHROPIC_BASE_URL`](/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. ein [LLM-Gateway](/de/llm-gateway) oder Proxy. Heben Sie die Variablenzuweisung auf, um Remote Control zu verwenden.38* **API-Endpunkt**: nicht verfügbar auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry. {/* min-version: 2.1.196 */}Ab v2.1.196 ist Remote Control auch deaktiviert, wenn [`ANTHROPIC_BASE_URL`](/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. eine [LLM-Gateway](/de/llm-gateway) oder einen Proxy. Heben Sie die Variablenzuweisung auf, um Remote Control zu verwenden.

38* **Workspace-Vertrauen**: Führen Sie `claude` mindestens einmal in Ihrem Projektverzeichnis aus, um den Workspace-Vertrauensdialog zu akzeptieren.39* **Workspace-Vertrauen**: Führen Sie `claude` mindestens einmal in Ihrem Projektverzeichnis aus, um den Workspace-Vertrauensdialog zu akzeptieren.

39 40 

40<h2 id="start-a-remote-control-session">41<h2 id="start-a-remote-control-session">


59 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |60 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

60 | `--name "My Project"` | Legen Sie einen benutzerdefinierten Sitzungstitel fest, der in der Sitzungsliste unter claude.ai/code sichtbar ist. |61 | `--name "My Project"` | Legen Sie einen benutzerdefinierten Sitzungstitel fest, der in der Sitzungsliste unter claude.ai/code sichtbar ist. |

61 | `--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. |62 | `--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. |

63 | `-c`, `--continue` | {/* min-version: 2.1.200 */}Setzen Sie die zuletzt gestartete Remote Control-Sitzung aus diesem Verzeichnis fort, anstatt eine neue zu erstellen. 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. |

64 | `--session-id <id>` | {/* min-version: 2.1.200 */}Setzen Sie eine bestimmte Remote Control-Sitzung anhand ihrer ID fort. 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 | `--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](/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. |65 | `--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](/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 | `--capacity <N>` | Maximale Anzahl gleichzeitiger Sitzungen. Standard ist 32. Kann nicht mit `--spawn=session` verwendet werden. |66 | `--capacity <N>` | Maximale Anzahl gleichzeitiger Sitzungen. Standard ist 32. Kann nicht mit `--spawn=session` verwendet werden. |

67 | `--[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; übergeben Sie `--no-create-session-in-dir`, um ohne zu starten. |

64 | `--verbose` | Zeigen Sie detaillierte Verbindungs- und Sitzungsprotokolle an. |68 | `--verbose` | Zeigen Sie detaillierte Verbindungs- und Sitzungsprotokolle an. |

65 | `--sandbox` / `--no-sandbox` | Aktivieren oder deaktivieren Sie [sandboxing](/de/sandboxing) für Dateisystem- und Netzwerkisolation. Standardmäßig deaktiviert. |69 | `--sandbox` / `--no-sandbox` | Aktivieren oder deaktivieren Sie [sandboxing](/de/sandboxing) für Dateisystem- und Netzwerkisolation. Standardmäßig deaktiviert. |

66 </Tab>70 </Tab>


149 Aktivieren Sie Remote Control für alle Sitzungen153 Aktivieren Sie Remote Control für alle Sitzungen

150</h3>154</h3>

151 155 

152Remote Control wird nur aktiviert, wenn Sie explizit `claude remote-control`, `claude --remote-control` oder `/remote-control` ausführen, es sei denn, die automatische Verbindung ist aktiviert. Um es automatisch für jede interaktive Sitzung zu aktivieren, führen Sie `/config` in Claude Code aus und setzen Sie **Enable Remote Control for all sessions** auf `true`. Setzen Sie es auf `false`, um es nie automatisch zu verbinden, oder lassen Sie es ungesetzt, um dem Standard Ihrer Organisation zu folgen. In der Desktop-App können Sie dies auch unter **Einstellungen → Claude Code → Enable remote control by default** umschalten.156Remote Control wird nur aktiviert, wenn Sie explizit `claude remote-control`, `claude --remote-control` oder `/remote-control` ausführen, es sei denn, die automatische Verbindung ist aktiviert. Um es automatisch für jede interaktive Sitzung zu aktivieren, führen Sie `/config` in Claude Code aus und setzen Sie **Enable Remote Control for all sessions** auf `true`. Setzen Sie es auf `false`, um es nie automatisch zu verbinden, oder lassen Sie es ungesetzt, um dem Standard Ihrer Organisation zu folgen. In der Desktop-App können Sie dies auch unter **Einstellungen → Claude Code → Enable remote control by default** umschalten. {/* min-version: 2.1.203 */}In der [VS Code-Erweiterung](/de/vs-code#use-the-prompt-box) wird derselbe Schalter als **Enable Remote Control for all sessions** im Abschnitt „Einstellungen" des Befehlsmenüs angezeigt; erfordert Claude Code v2.1.203 oder später.

153 157 

154Mit dieser Einstellung registriert jeder interaktive Claude Code-Prozess eine Remote-Sitzung. Wenn Sie mehrere Instanzen ausführen, erhält jede ihre eigene Umgebung und Sitzung. Um mehrere gleichzeitige Sitzungen aus einem einzelnen Prozess auszuführen, verwenden Sie stattdessen den [Server-Modus](#start-a-remote-control-session).158Mit dieser Einstellung registriert jeder interaktive Claude Code-Prozess eine Remote-Sitzung. Wenn Sie mehrere Instanzen ausführen, erhält jede ihre eigene Umgebung und Sitzung. Um mehrere gleichzeitige Sitzungen aus einem einzelnen Prozess auszuführen, verwenden Sie stattdessen den [Server-Modus](#start-a-remote-control-session).

155 159 


280* **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, endet die Sitzung.284* **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, endet die Sitzung.

281* **Längerer Netzwerkausfall**: Wenn Ihr Computer aktiv ist, aber länger als etwa 10 Minuten das Netzwerk nicht erreichen kann, läuft die Sitzung ab und der Prozess wird beendet. Führen Sie `claude remote-control` erneut aus, um eine neue Sitzung zu starten.285* **Längerer Netzwerkausfall**: Wenn Ihr Computer aktiv ist, aber länger als etwa 10 Minuten das Netzwerk nicht erreichen kann, läuft die Sitzung ab und der Prozess wird beendet. Führen Sie `claude remote-control` erneut aus, um eine neue Sitzung zu starten.

282* **Ultraplan trennt Remote Control**: Das Starten einer [ultraplan](/de/ultraplan)-Sitzung trennt jede aktive Remote Control-Sitzung, da beide Funktionen die Schnittstelle claude.ai/code belegen und nur eine gleichzeitig verbunden sein kann.286* **Ultraplan trennt Remote Control**: Das Starten einer [ultraplan](/de/ultraplan)-Sitzung trennt jede aktive Remote Control-Sitzung, da beide Funktionen die Schnittstelle claude.ai/code belegen und nur eine gleichzeitig verbunden sein kann.

283* **Einige Befehle sind nur lokal verfügbar**: Befehle, die eine interaktive Auswahl im Terminal öffnen, wie `/plugin` oder `/resume`, funktionieren nur über die lokale CLI. Die folgenden funktionieren von mobil und Web aus:287* **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:

284 * Textausgabe-Befehle: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, `/reload-plugins`288 * Textausgabe-Befehle: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, `/reload-plugins`

289 * `/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.

285 * {/* min-version: 2.1.166 */}`/mcp`, ab v2.1.166: gibt eine Textzusammenfassung des Server-Status zurück, anstatt die Auswahl zu öffnen, und akzeptiert die `reconnect`-, `enable`- und `disable`-[Unterbefehle](/de/commands#all-commands). Im Gegensatz zur lokalen CLI verbindet `/mcp reconnect` ohne Servernamen jeden Server wieder, der fehlgeschlagen ist oder eine Authentifizierung benötigt.290 * {/* min-version: 2.1.166 */}`/mcp`, ab v2.1.166: gibt eine Textzusammenfassung des Server-Status zurück, anstatt die Auswahl zu öffnen, und akzeptiert die `reconnect`-, `enable`- und `disable`-[Unterbefehle](/de/commands#all-commands). Im Gegensatz zur lokalen CLI verbindet `/mcp reconnect` ohne Servernamen jeden Server wieder, der fehlgeschlagen ist oder eine Authentifizierung benötigt.

286 * {/* min-version: 2.1.181 */}`/config`, ab v2.1.181: ü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.291 * {/* min-version: 2.1.181 */}`/config`, ab v2.1.181: ü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.

287 292 


323 „Remote Control ist nur verfügbar, wenn Sie Claude über api.anthropic.com verwenden"328 „Remote Control ist nur verfügbar, wenn Sie Claude über api.anthropic.com verwenden"

324</h3>329</h3>

325 330 

326Die Sitzung kommuniziert nicht direkt mit der Anthropic-API, daher gibt es kein claude.ai-Backend zum Koppeln. Dies geschieht auf Amazon Bedrock, Google Vertex AI und Microsoft Foundry. {/* min-version: 2.1.196 */}Ab v2.1.196 geschieht dies auch, wenn [`ANTHROPIC_BASE_URL`](/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. ein [LLM-Gateway](/de/llm-gateway) oder Proxy, auch wenn Sie sich mit claude.ai anmelden. Heben Sie `ANTHROPIC_BASE_URL` auf und starten Sie die Sitzung neu, um Remote Control zu verwenden.331Die 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. {/* min-version: 2.1.196 */}Ab v2.1.196 geschieht dies auch, wenn [`ANTHROPIC_BASE_URL`](/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. ein [LLM-Gateway](/de/llm-gateway) oder Proxy, auch wenn Sie sich mit claude.ai anmelden. Heben Sie `ANTHROPIC_BASE_URL` auf und starten Sie die Sitzung neu, um Remote Control zu verwenden.

327 332 

328<h3 id="remote-control-is-disabled-by-your-organization’s-policy">333<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

329 „Remote Control ist durch die Richtlinie Ihrer Organisation deaktiviert"334 „Remote Control ist durch die Richtlinie Ihrer Organisation deaktiviert"


352* 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.357* 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.

353* 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.358* 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.

354 359 

360<h3 id="couldn’t-reconnect-to-your-remote-control-session">

361 „Konnte nicht erneut mit Ihrer Remote Control-Sitzung verbunden werden"

362</h3>

363 

364Wenn 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, z. B. eine Netzwerkunterbrechung oder ein Serverfehler, daher kann Claude Code nicht bestätigen, ob die Remote-Sitzung noch vorhanden ist. Wenn der Server bestätigt, dass die vorherige Sitzung nicht mehr vorhanden ist, erstellt Claude Code eine neue Remote Control-Sitzung, ohne diese Meldung anzuzeigen.

365 

366Ihre lokale Sitzung läuft ohne Remote Control weiter. Führen Sie `/remote-control` aus, um die Verbindung erneut zu versuchen, oder starten Sie Claude Code ohne `--resume`, um eine neue Remote Control-Sitzung zu erstellen.

367 

368{/* min-version: 2.1.200 */}Vor v2.1.200 hat ein Wiederverbindungsfehler eine neue Remote Control-Sitzung erstellt, anstatt diese Meldung anzuzeigen, was zusätzliche Sitzungen in der Sitzungsliste unter claude.ai/code hinterlassen hat.

369 

355<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">370<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">

356 „Ihre Organisation erfordert vertrauenswürdige Geräte für Remote Control, aber dieses Gerät ist nicht registriert"371 „Ihre Organisation erfordert vertrauenswürdige Geräte für Remote Control, aber dieses Gerät ist nicht registriert"

357</h3>372</h3>

routines.md +1 −1

Details

416 416 

417Die CLI blendet `/schedule` aus, wenn eine ihrer Anforderungen nicht erfüllt ist. Das Befehlsmenü zeigt daher `No commands match "/schedule"` während der Eingabe an, und das Absenden gibt `Unknown command: /schedule` zurück. Die Ursache ist normalerweise eine der folgenden:417Die CLI blendet `/schedule` aus, wenn eine ihrer Anforderungen nicht erfüllt ist. Das Befehlsmenü zeigt daher `No commands match "/schedule"` während der Eingabe an, und das Absenden gibt `Unknown command: /schedule` zurück. Die Ursache ist normalerweise eine der folgenden:

418 418 

419* Sie sind mit einem Console-API-Schlüssel oder einem Cloud-Anbieter wie Bedrock, Vertex oder Foundry authentifiziert. `/schedule` erfordert eine claude.ai-Abonnement-Anmeldung. Wenn `ANTHROPIC_API_KEY` oder `ANTHROPIC_AUTH_TOKEN` in Ihrer Shell oder `apiKeyHelper` in `settings.json` gesetzt ist, entfernen Sie es zuerst, da diese Vorrang vor einer claude.ai-Anmeldung haben419* Sie sind mit einem Console-API-Schlüssel oder einem Cloud-Anbieter wie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry authentifiziert. `/schedule` erfordert eine claude.ai-Abonnement-Anmeldung. Wenn `ANTHROPIC_API_KEY` oder `ANTHROPIC_AUTH_TOKEN` in Ihrer Shell oder `apiKeyHelper` in `settings.json` gesetzt ist, entfernen Sie es zuerst, da diese Vorrang vor einer claude.ai-Anmeldung haben

420* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK` ist in Ihrer Shell-Umgebung oder im `env`-Block einer [`settings.json`-Datei](/de/settings#available-settings) gesetzt. Diese deaktivieren das Abrufen von Feature-Flags, auf das `/schedule` angewiesen ist420* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` oder `DISABLE_GROWTHBOOK` ist in Ihrer Shell-Umgebung oder im `env`-Block einer [`settings.json`-Datei](/de/settings#available-settings) gesetzt. Diese deaktivieren das Abrufen von Feature-Flags, auf das `/schedule` angewiesen ist

421* Sie befinden sich in einer Claude Code-Sitzung im Web. Verwalten Sie Routinen stattdessen über die [Web-Benutzeroberfläche](https://claude.ai/code/routines)421* Sie befinden sich in einer Claude Code-Sitzung im Web. Verwalten Sie Routinen stattdessen über die [Web-Benutzeroberfläche](https://claude.ai/code/routines)

422* {/* min-version: 2.1.81 */}Ihre CLI ist älter als v2.1.81. Führen Sie `claude update` aus422* {/* min-version: 2.1.81 */}Ihre CLI ist älter als v2.1.81. Führen Sie `claude update` aus

sandboxing.md +1 −1

Details

237 237 

238Mit `mask` sieht der Sandbox-Befehl einen pro-Sitzungs-Sentinel-Wert anstelle des echten. Wenn eine Anfrage die Sandbox für einen der `injectHosts` der Anmeldedaten verlässt, ersetzt der [Sandbox-Proxy](#network-isolation) den Sentinel durch den echten Wert. Der Befehl und alles, das er protokolliert, hält niemals die echte Anmeldedaten, aber seine Anfragen authentifizieren sich immer noch.238Mit `mask` sieht der Sandbox-Befehl einen pro-Sitzungs-Sentinel-Wert anstelle des echten. Wenn eine Anfrage die Sandbox für einen der `injectHosts` der Anmeldedaten verlässt, ersetzt der [Sandbox-Proxy](#network-isolation) den Sentinel durch den echten Wert. Der Befehl und alles, das er protokolliert, hält niemals die echte Anmeldedaten, aber seine Anfragen authentifizieren sich immer noch.

239 239 

240Der Proxy ersetzt die Anmeldedaten in Anfrageinhalten, daher muss er diese sehen. Setzen Sie [`network.tlsTerminate`](/de/settings#sandbox-settings), damit der Proxy HTTPS selbst beendet. Ohne ihn schlägt die Maskierung geschlossen fehl: Der Befehl sieht immer noch nur den Sentinel, aber der Sentinel erreicht den Server unverändert und die Authentifizierung schlägt fehl. Claude Code meldet diese Fehlkonfiguration beim Start und in `/doctor`.240Der Proxy ersetzt die Anmeldedaten in Anfrageinhalten, daher muss er diese sehen. Setzen Sie [`network.tlsTerminate`](/de/settings#sandbox-settings), damit der Proxy TLS selbst beendet. Ohne ihn schlägt die Maskierung geschlossen fehl: Der Befehl sieht immer noch nur den Sentinel, aber der Sentinel erreicht den Server unverändert und die Authentifizierung schlägt fehl. Claude Code meldet diese Fehlkonfiguration beim Start.

241 241 

242Das folgende Beispiel maskiert zwei Token. `GH_TOKEN` wird nur bei Anfragen an `api.github.com` ersetzt, während `NPM_TOKEN` keine `injectHosts` hat und bei Anfragen an jeden Host in `network.allowedDomains` ersetzt wird. Jeder `injectHosts`-Eintrag muss selbst von `network.allowedDomains` abgedeckt werden.242Das folgende Beispiel maskiert zwei Token. `GH_TOKEN` wird nur bei Anfragen an `api.github.com` ersetzt, während `NPM_TOKEN` keine `injectHosts` hat und bei Anfragen an jeden Host in `network.allowedDomains` ersetzt wird. Jeder `injectHosts`-Eintrag muss selbst von `network.allowedDomains` abgedeckt werden.

243 243 

Details

86Eine dynamisch geplante Schleife erscheint in Ihrer [geplanten Aufgabenliste](#manage-scheduled-tasks) wie jede andere Aufgabe, sodass Sie sie auf die gleiche Weise auflisten oder stornieren können. Die [Jitter-Regeln](#jitter) gelten nicht dafür, aber die [sieben-Tage-Ablauf](#seven-day-expiry) tut es: die Schleife endet automatisch sieben Tage nach dem Start.86Eine dynamisch geplante Schleife erscheint in Ihrer [geplanten Aufgabenliste](#manage-scheduled-tasks) wie jede andere Aufgabe, sodass Sie sie auf die gleiche Weise auflisten oder stornieren können. Die [Jitter-Regeln](#jitter) gelten nicht dafür, aber die [sieben-Tage-Ablauf](#seven-day-expiry) tut es: die Schleife endet automatisch sieben Tage nach dem Start.

87 87 

88<Note>88<Note>

89 Bei Bedrock, Vertex AI und Microsoft Foundry läuft ein Prompt ohne Intervall stattdessen nach einem festen 10-Minuten-Zeitplan.89 Bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry läuft ein Prompt ohne Intervall stattdessen nach einem festen 10-Minuten-Zeitplan.

90</Note>90</Note>

91 91 

92<h3 id="run-the-built-in-maintenance-prompt">92<h3 id="run-the-built-in-maintenance-prompt">


108Ein einfaches `/loop` führt diesen Prompt in einem [dynamisch gewählten Intervall](#let-claude-choose-the-interval) aus. Fügen Sie ein Intervall hinzu, zum Beispiel `/loop 15m`, um es stattdessen nach einem festen Zeitplan auszuführen. Um den integrierten Prompt durch Ihren eigenen Standard zu ersetzen, siehe [Passen Sie den Standard-Prompt mit loop.md an](#customize-the-default-prompt-with-loop-md).108Ein einfaches `/loop` führt diesen Prompt in einem [dynamisch gewählten Intervall](#let-claude-choose-the-interval) aus. Fügen Sie ein Intervall hinzu, zum Beispiel `/loop 15m`, um es stattdessen nach einem festen Zeitplan auszuführen. Um den integrierten Prompt durch Ihren eigenen Standard zu ersetzen, siehe [Passen Sie den Standard-Prompt mit loop.md an](#customize-the-default-prompt-with-loop-md).

109 109 

110<Note>110<Note>

111 Bei Bedrock, Vertex AI und Microsoft Foundry wird `/loop` ohne Prompt die Nutzungsmeldung gedruckt, anstatt den Wartungs-Prompt auszuführen.111 Bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry wird `/loop` ohne Prompt die Nutzungsmeldung gedruckt, anstatt den Wartungs-Prompt auszuführen.

112</Note>112</Note>

113 113 

114<h3 id="customize-the-default-prompt-with-loop-md">114<h3 id="customize-the-default-prompt-with-loop-md">


136Änderungen an `loop.md` treten bei der nächsten Iteration in Kraft, sodass Sie die Anweisungen verfeinern können, während eine Schleife läuft. Wenn keine `loop.md` an einem der beiden Orte vorhanden ist, fällt die Schleife auf den integrierten Wartungs-Prompt zurück. Halten Sie die Datei prägnant: Inhalte über 25.000 Bytes werden gekürzt.136Änderungen an `loop.md` treten bei der nächsten Iteration in Kraft, sodass Sie die Anweisungen verfeinern können, während eine Schleife läuft. Wenn keine `loop.md` an einem der beiden Orte vorhanden ist, fällt die Schleife auf den integrierten Wartungs-Prompt zurück. Halten Sie die Datei prägnant: Inhalte über 25.000 Bytes werden gekürzt.

137 137 

138<Note>138<Note>

139 Bei Bedrock, Vertex AI und Microsoft Foundry wird `loop.md` nicht gelesen und `/loop` ohne Prompt druckt die Nutzungsmeldung aus.139 Bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry wird `loop.md` nicht gelesen und `/loop` ohne Prompt druckt die Nutzungsmeldung aus.

140</Note>140</Note>

141 141 

142<h3 id="stop-a-loop">142<h3 id="stop-a-loop">


145 145 

146Um eine `/loop` zu stoppen, während sie auf die nächste Iteration wartet, drücken Sie `Esc`. Dies löscht den ausstehenden Wakeup, sodass die Schleife nicht erneut läuft. Aufgaben, die Sie durch [direktes Fragen an Claude](#manage-scheduled-tasks) geplant haben, sind nicht von `Esc` betroffen und bleiben bestehen, bis Sie sie löschen.146Um eine `/loop` zu stoppen, während sie auf die nächste Iteration wartet, drücken Sie `Esc`. Dies löscht den ausstehenden Wakeup, sodass die Schleife nicht erneut läuft. Aufgaben, die Sie durch [direktes Fragen an Claude](#manage-scheduled-tasks) geplant haben, sind nicht von `Esc` betroffen und bleiben bestehen, bis Sie sie löschen.

147 147 

148Im [selbstgesteuertem Modus](#let-claude-choose-the-interval) kann Claude die Schleife auch selbst beenden, indem es die nächste Wakeup nicht plant, sobald die Aufgabe nachweislich abgeschlossen ist. Schleifen nach einem festen Intervall laufen weiter, bis Sie sie stoppen oder [sieben Tage vergehen](#seven-day-expiry).148Im [selbstgesteuertem Modus](#let-claude-choose-the-interval) kann Claude die Schleife auch selbst beenden, sobald die Aufgabe abgeschlossen ist. Claude ruft das [`ScheduleWakeup`-Tool](/de/tools-reference) mit `stop: true` auf, was den ausstehenden Wakeup sofort storniert. Wenn eine Iteration endet, ohne entweder neu zu planen oder zu stoppen, plant Claude Code einen Fallback-Wakeup etwa 20 Minuten später und beendet die Schleife, wenn diese Iteration auch nicht neu plant. Vor v2.1.202 war das Nicht-Neuplanung die einzige Möglichkeit, wie Claude eine Schleife selbst beenden konnte.

149 

150Schleifen nach einem festen Intervall laufen weiter, bis Sie sie stoppen oder [sieben Tage vergehen](#seven-day-expiry).

149 151 

150<h2 id="set-a-one-time-reminder">152<h2 id="set-a-one-time-reminder">

151 Setzen Sie eine einmalige Erinnerung153 Setzen Sie eine einmalige Erinnerung

Details

219/plugin uninstall security-guidance@claude-plugins-official219/plugin uninstall security-guidance@claude-plugins-official

220```220```

221 221 

222Wenn das Plugin durch die `.claude/settings.json` eines Projekts aktiviert wurde, schreibt das Deaktivieren von `/plugin` einen Override in Ihre `.claude/settings.local.json`, anstatt die eingecheckte Datei zu bearbeiten, sodass das Plugin für Sie ausgeschaltet bleibt, während Ihre Teamkollegen nicht betroffen sind. Wenn es durch [verwaltete Einstellungen](/de/admin-setup) aktiviert wurde, kann nur ein Administrator es deaktivieren.222Wenn das Plugin durch die `.claude/settings.json` eines Projekts aktiviert wurde, schreibt das Deaktivieren von `/plugin` einen Override in Ihre `.claude/settings.local.json`, anstatt die eingecheckte Datei zu bearbeiten, sodass das Plugin für Sie ausgeschaltet bleibt, während Ihre Teamkollegen nicht betroffen sind. {/* min-version: 2.1.203 */}Derselbe Dialog bietet auch an, das Plugin für alle zu deinstallieren, indem es aus der gemeinsamen `.claude/settings.json` entfernt wird; diese Option erfordert Claude Code v2.1.203 oder später. Wenn es durch [verwaltete Einstellungen](/de/admin-setup) aktiviert wurde, kann nur ein Administrator es deaktivieren.

223 223 

224<h2 id="how-the-plugin-integrates-with-claude-code">224<h2 id="how-the-plugin-integrates-with-claude-code">

225 Wie das Plugin mit Claude Code integriert wird225 Wie das Plugin mit Claude Code integriert wird

Details

255Serververwaltete Einstellungen sind nicht verfügbar, wenn Drittanbieter-Modellprovider verwendet werden:255Serververwaltete Einstellungen sind nicht verfügbar, wenn Drittanbieter-Modellprovider verwendet werden:

256 256 

257* Amazon Bedrock257* Amazon Bedrock

258* Google Vertex AI258* Google Cloud's Agent Platform

259* Microsoft Foundry259* Microsoft Foundry

260* [Claude Platform on AWS](/de/claude-platform-on-aws)260* [Claude Platform on AWS](/de/claude-platform-on-aws)

261* Benutzerdefinierte API-Endpunkte über `ANTHROPIC_BASE_URL` oder Drittanbieter-[LLM-Gateways](/de/llm-gateway)261* Benutzerdefinierte API-Endpunkte über `ANTHROPIC_BASE_URL` oder Drittanbieter-[LLM-Gateways](/de/llm-gateway)

262 262 

263Für Bedrock-, Vertex AI- und Foundry-Bereitstellungen bietet ein selbstgehostetes [Claude-Apps-Gateway](/de/claude-apps-gateway) die entsprechende Remote-Verwaltung von Einstellungen: Mit dem Gateway angemeldete Clients rufen verwaltete Einstellungen vom Gateway statt von `api.anthropic.com` ab. Die Fehlerbehandlung unterscheidet sich beim Start: Ein Gateway-Client, der das Gateway nicht erreichen kann, beendet sich mit einem Fehler, anstatt auf zwischengespeicherte Einstellungen zurückzugreifen, während die stündliche Hintergrundaktualisierung auf beiden Kanälen fehleroffen ist.263Für Amazon Bedrock-, Google Cloud's Agent Platform- und Microsoft Foundry-Bereitstellungen bietet ein selbstgehostetes [Claude-Apps-Gateway](/de/claude-apps-gateway) die entsprechende Remote-Verwaltung von Einstellungen: Mit dem Gateway angemeldete Clients rufen verwaltete Einstellungen vom Gateway statt von `api.anthropic.com` ab. Die Fehlerbehandlung unterscheidet sich beim Start: Ein Gateway-Client, der das Gateway nicht erreichen kann, beendet sich mit einem Fehler, anstatt auf zwischengespeicherte Einstellungen zurückzugreifen, während die stündliche Hintergrundaktualisierung auf beiden Kanälen fehleroffen ist.

264 264 

265<h2 id="audit-logging">265<h2 id="audit-logging">

266 Audit-Protokollierung266 Audit-Protokollierung

settings.md +37 −29

Details

95* **Projekteinstellungen** werden in Ihrem Projektverzeichnis gespeichert:95* **Projekteinstellungen** werden in Ihrem Projektverzeichnis gespeichert:

96 * `.claude/settings.json` für Einstellungen, die in die Versionskontrolle eingecheckt und mit Ihrem Team geteilt werden96 * `.claude/settings.json` für Einstellungen, die in die Versionskontrolle eingecheckt und mit Ihrem Team geteilt werden

97 * `.claude/settings.local.json` für Einstellungen, die nicht eingecheckt werden, nützlich für persönliche Voreinstellungen und Experimente. Wenn Claude Code `.claude/settings.local.json` erstellt, konfiguriert es Git so, dass die Datei ignoriert wird. Wenn Sie die Datei selbst erstellen, fügen Sie sie manuell zu Ihrer gitignore hinzu.97 * `.claude/settings.local.json` für Einstellungen, die nicht eingecheckt werden, nützlich für persönliche Voreinstellungen und Experimente. Wenn Claude Code `.claude/settings.local.json` erstellt, konfiguriert es Git so, dass die Datei ignoriert wird. Wenn Sie die Datei selbst erstellen, fügen Sie sie manuell zu Ihrer gitignore hinzu.

98 

99 Da diese Datei Ihnen gehört und nicht dem Repository, werden ihre Berechtigungsregeln `allow` ohne den [Workspace-Trust](/de/permissions#project-allow-rules-and-workspace-trust)-Schritt wirksam, den `allow`-Regeln in `.claude/settings.json` erfordern. Wenn das Repository die Datei bereitstellt, z. B. durch Committen, gilt Workspace-Trust weiterhin.

98* **Verwaltete Einstellungen**: Für Organisationen, die zentrale Kontrolle benötigen, unterstützt Claude Code mehrere Bereitstellungsmechanismen für verwaltete Einstellungen. Alle verwenden das gleiche JSON-Format und können nicht durch Benutzer- oder Projekteinstellungen überschrieben werden:100* **Verwaltete Einstellungen**: Für Organisationen, die zentrale Kontrolle benötigen, unterstützt Claude Code mehrere Bereitstellungsmechanismen für verwaltete Einstellungen. Alle verwenden das gleiche JSON-Format und können nicht durch Benutzer- oder Projekteinstellungen überschrieben werden:

99 101 

100 * **Serververwaltete Einstellungen**: von Anthropics Servern über die Claude.ai-Administratorkonsole bereitgestellt oder von einem selbstgehosteten [Claude-Apps-Gateway](/de/claude-apps-gateway). Siehe [serververwaltete Einstellungen](/de/server-managed-settings).102 * **Serververwaltete Einstellungen**: von Anthropics Servern über die Claude.ai-Administratorkonsole bereitgestellt oder von einem selbstgehosteten [Claude-Apps-Gateway](/de/claude-apps-gateway). Siehe [Serververwaltete Einstellungen](/de/server-managed-settings).

101 * **MDM/OS-Richtlinien**: über native Geräteverwaltung auf macOS und Windows bereitgestellt:103 * **MDM/OS-Richtlinien**: über native Geräteverwaltung auf macOS und Windows bereitgestellt:

102 * macOS: `com.anthropic.claudecode` verwaltete Präferenzdomäne. Die Schlüssel der obersten Ebene der plist spiegeln `managed-settings.json` wider, mit verschachtelten Einstellungen als Wörterbücher und Arrays als plist-Arrays. Bereitstellung über Konfigurationsprofile in Jamf, Iru (Kandji) oder ähnlichen MDM-Tools.104 * macOS: `com.anthropic.claudecode` verwaltete Präferenzdomäne. Die Schlüssel der obersten Ebene der plist spiegeln `managed-settings.json` wider, mit verschachtelten Einstellungen als Wörterbücher und Arrays als plist-Arrays. Bereitstellung über Konfigurationsprofile in Jamf, Iru (Kandji) oder ähnlichen MDM-Tools.

103 * Windows: `HKLM\SOFTWARE\Policies\ClaudeCode` Registrierungsschlüssel mit einem `Settings`-Wert (REG\_SZ oder REG\_EXPAND\_SZ) mit JSON (bereitgestellt über Gruppenrichtlinie oder Intune)105 * Windows: `HKLM\SOFTWARE\Policies\ClaudeCode` Registrierungsschlüssel mit einem `Settings`-Wert (REG\_SZ oder REG\_EXPAND\_SZ) mit JSON (bereitgestellt über Gruppenrichtlinie oder Intune)


118 120 

119 Verwenden Sie numerische Präfixe, um die Zusammenführungsreihenfolge zu steuern, z. B. `10-telemetry.json` und `20-security.json`.121 Verwenden Sie numerische Präfixe, um die Zusammenführungsreihenfolge zu steuern, z. B. `10-telemetry.json` und `20-security.json`.

120 122 

121 Siehe [verwaltete Einstellungen](/de/permissions#managed-only-settings) und [Verwaltete MCP-Konfiguration](/de/managed-mcp) für Details.123 Siehe [Verwaltete Einstellungen](/de/permissions#managed-only-settings) und [Verwaltete MCP-Konfiguration](/de/managed-mcp) für Details.

122 124 

123 Dieses [Repository](https://github.com/anthropics/claude-code/tree/main/examples/mdm) enthält Starter-Bereitstellungsvorlagen für Jamf, Iru (Kandji), Intune und Gruppenrichtlinie. Verwenden Sie diese als Ausgangspunkte und passen Sie sie an Ihre Anforderungen an.125 Dieses [Repository](https://github.com/anthropics/claude-code/tree/main/examples/mdm) enthält Starter-Bereitstellungsvorlagen für Jamf, Iru (Kandji), Intune und Gruppenrichtlinie. Verwenden Sie diese als Ausgangspunkte und passen Sie sie an Ihre Anforderungen an.

124 126 


178 Ungültige Einträge in verwalteten Einstellungen180 Ungültige Einträge in verwalteten Einstellungen

179</h3>181</h3>

180 182 

181Verwaltete Einstellungen werden tolerant analysiert. Wenn eine verwaltete Konfiguration einen Eintrag enthält, der die Schema-Validierung nicht besteht, entfernt Claude Code diesen Eintrag, zeichnet eine Warnung auf und erzwingt jede verbleibende gültige Richtlinie. Ein einzelner Tippfehler kann nicht die restliche Organisationsrichtlinie deaktivieren. Dieses Verhalten ist konsistent über alle drei Bereitstellungsmechanismen: [serververwaltete Einstellungen](/de/server-managed-settings), plist- und Registry-Richtlinien, die über MDM bereitgestellt werden, und `managed-settings.json`-Dateien. Erfordert Claude Code v2.1.169 oder später.183Verwaltete Einstellungen werden tolerant analysiert. Wenn eine verwaltete Konfiguration einen Eintrag enthält, der die Schema-Validierung nicht besteht, entfernt Claude Code diesen Eintrag, zeichnet eine Warnung auf und erzwingt jede verbleibende gültige Richtlinie. Ein einzelner Tippfehler kann nicht die restliche Organisationsrichtlinie deaktivieren. Dieses Verhalten ist konsistent über alle drei Bereitstellungsmechanismen: [Serververwaltete Einstellungen](/de/server-managed-settings), plist- und Registry-Richtlinien, die über MDM bereitgestellt werden, und `managed-settings.json`-Dateien. Erfordert Claude Code v2.1.169 oder später.

182 184 

183Sicherheitsdurchsetzungsfelder werden pro Feld behandelt, anstatt vollständig entfernt zu werden, wenn sie vorhanden, aber ungültig sind:185Sicherheitsdurchsetzungsfelder werden pro Feld behandelt, anstatt vollständig entfernt zu werden, wenn sie vorhanden, aber ungültig sind:

184 186 


211`settings.json` unterstützt eine Reihe von Optionen:213`settings.json` unterstützt eine Reihe von Optionen:

212 214 

213| Schlüssel | Beschreibung | Beispiel |215| Schlüssel | Beschreibung | Beispiel |

214| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |216| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

215| `advisorModel` | {/* min-version: 2.1.98 */}Modell für das serverseitige [Advisor-Tool](/de/advisor). Akzeptiert einen Modellalias wie `"opus"`, `"sonnet"` oder `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+) oder eine vollständige Modell-ID. Wird automatisch geschrieben, wenn Sie `/advisor` ausführen. Nicht gesetzt, um den Advisor zu deaktivieren. Erfordert Claude Code v2.1.98 oder später | `"opus"` |217| `advisorModel` | {/* min-version: 2.1.98 */}Modell für das serverseitige [Advisor-Tool](/de/advisor). Akzeptiert einen Modellalias wie `"opus"`, `"sonnet"` oder `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+) oder eine vollständige Modell-ID. Wird automatisch geschrieben, wenn Sie `/advisor` ausführen. Nicht gesetzt, um den Advisor zu deaktivieren. Erfordert Claude Code v2.1.98 oder später | `"opus"` |

216| `agent` | Führen Sie den Haupt-Thread als benannten Subagent aus und legen Sie den Standard-Agent für Sitzungen fest, die von `claude agents` versendet werden. Wendet den Systemaufforderung, die Werkzeugbeschränkungen und das Modell des Subagent an. Siehe [Rufen Sie Subagents explizit auf](/de/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |218| `agent` | Führen Sie den Haupt-Thread als benannten Subagent aus und legen Sie den Standard-Agent für Sitzungen fest, die von `claude agents` versendet werden. Wendet den Systemaufforderung, die Werkzeugbeschränkungen und das Modell des Subagent an. Siehe [Rufen Sie Subagents explizit auf](/de/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

217| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**Standard**: `false`. Wenn [Remote Control](/de/remote-control) verbunden ist, erlauben Sie Claude, proaktive Push-Benachrichtigungen an Ihr Telefon zu senden, z. B. wenn eine lange Aufgabe endet. Wird in `/config` als **Push when Claude decides** angezeigt. Siehe [Mobile Push-Benachrichtigungen](/de/remote-control#mobile-push-notifications). Erfordert Claude Code v2.1.119 oder später | `true` |219| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**Standard**: `false`. Wenn [Remote Control](/de/remote-control) verbunden ist, erlauben Sie Claude, proaktive Push-Benachrichtigungen an Ihr Telefon zu senden, z. B. wenn eine lange Aufgabe endet. Wird in `/config` als **Push when Claude decides** angezeigt. Siehe [Mobile Push-Benachrichtigungen](/de/remote-control#mobile-push-notifications). Erfordert Claude Code v2.1.119 oder später | `true` |


224| `allowManagedPermissionRulesOnly` | (Nur verwaltete Einstellungen) Verhindern Sie, dass Benutzer- und Projekteinstellungen `allow`, `ask` oder `deny` Berechtigungsregeln definieren. Nur Regeln in verwalteten Einstellungen gelten. Siehe [Nur verwaltete Einstellungen](/de/permissions#managed-only-settings) | `true` |226| `allowManagedPermissionRulesOnly` | (Nur verwaltete Einstellungen) Verhindern Sie, dass Benutzer- und Projekteinstellungen `allow`, `ask` oder `deny` Berechtigungsregeln definieren. Nur Regeln in verwalteten Einstellungen gelten. Siehe [Nur verwaltete Einstellungen](/de/permissions#managed-only-settings) | `true` |

225| `alwaysThinkingEnabled` | Aktivieren Sie [erweitertes Denken](/de/model-config#extended-thinking) standardmäßig für alle Sitzungen. Normalerweise über den Befehl `/config` konfiguriert, anstatt direkt zu bearbeiten. Um das Denken unabhängig von dieser Einstellung auszuschalten, setzen Sie [`MAX_THINKING_TOKENS=0`](/de/env-vars) in `env`, was das Denken auf der Anthropic API deaktiviert, außer auf Fable 5, das Denken nicht ausschalten kann. Bei [Drittanbieter-Providern](/de/third-party-integrations) wird stattdessen der `thinking`-Parameter weggelassen, und adaptive-reasoning-Modelle können weiterhin denken | `true` |227| `alwaysThinkingEnabled` | Aktivieren Sie [erweitertes Denken](/de/model-config#extended-thinking) standardmäßig für alle Sitzungen. Normalerweise über den Befehl `/config` konfiguriert, anstatt direkt zu bearbeiten. Um das Denken unabhängig von dieser Einstellung auszuschalten, setzen Sie [`MAX_THINKING_TOKENS=0`](/de/env-vars) in `env`, was das Denken auf der Anthropic API deaktiviert, außer auf Fable 5, das Denken nicht ausschalten kann. Bei [Drittanbieter-Providern](/de/third-party-integrations) wird stattdessen der `thinking`-Parameter weggelassen, und adaptive-reasoning-Modelle können weiterhin denken | `true` |

226| `apiKeyHelper` | Benutzerdefiniertes Skript, das in `/bin/sh` auf macOS und Linux oder `cmd` auf Windows ausgeführt werden soll, um einen Auth-Wert zu generieren. Dieser Wert wird als `X-Api-Key` und `Authorization: Bearer` Header für Modellanfragen gesendet. Setzen Sie das Aktualisierungsintervall mit [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/de/env-vars) | `/bin/generate_temp_api_key.sh` |228| `apiKeyHelper` | Benutzerdefiniertes Skript, das in `/bin/sh` auf macOS und Linux oder `cmd` auf Windows ausgeführt werden soll, um einen Auth-Wert zu generieren. Dieser Wert wird als `X-Api-Key` und `Authorization: Bearer` Header für Modellanfragen gesendet. Setzen Sie das Aktualisierungsintervall mit [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/de/env-vars) | `/bin/generate_temp_api_key.sh` |

229| `askUserQuestionTimeout` | {/* min-version: 2.1.200 */}**Standard**: `"never"`. Leerlaufzeit vor einer unbeantworteten [`AskUserQuestion`](/de/tools-reference) Dialog, der automatisch mit den bereits ausgewählten Optionen fortfährt. Akzeptiert `"60s"`, `"5m"`, `"10m"` oder `"never"`. Mit dem Standard warten Fragen, bis Sie sie beantworten. Wird in `/config` als **Question auto-continue timeout** angezeigt, das diesen Schlüssel in Benutzereinstellungen schreibt. Nicht aus Projekt- oder lokalen Einstellungen gelesen. Erfordert Claude Code v2.1.200 oder später | `"5m"` |

227| `attribution` | Passen Sie die Zuschreibung für Git-Commits und Pull Requests an. Siehe [Zuschreibungseinstellungen](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |230| `attribution` | Passen Sie die Zuschreibung für Git-Commits und Pull Requests an. Siehe [Zuschreibungseinstellungen](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |

228| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**Standard**: `true`. Komprimieren Sie das Gespräch automatisch, wenn sich der Kontext dem Limit nähert. Wird in `/config` als **Auto-compact** angezeigt. Um dies über eine Umgebungsvariable zu deaktivieren, setzen Sie [`DISABLE_AUTO_COMPACT`](/de/env-vars) in `env` | `false` |231| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**Standard**: `true`. Komprimieren Sie das Gespräch automatisch, wenn sich der Kontext dem Limit nähert. Wird in `/config` als **Auto-compact** angezeigt. Um dies über eine Umgebungsvariable zu deaktivieren, setzen Sie [`DISABLE_AUTO_COMPACT`](/de/env-vars) in `env` | `false` |

229| `autoMemoryDirectory` | Benutzerdefiniertes Verzeichnis für [automatisches Speichern](/de/memory#storage-location). Akzeptiert einen absoluten Pfad oder einen `~/`-erweiterten Pfad. Aus Projekt- oder lokalen Einstellungen wird dies nur berücksichtigt, nachdem Sie den Workspace-Trust-Dialog akzeptieren, da ein geklontes Repository diese Datei bereitstellen kann | `"~/my-memory-dir"` |232| `autoMemoryDirectory` | Benutzerdefiniertes Verzeichnis für [automatisches Speichern](/de/memory#storage-location). Akzeptiert einen absoluten Pfad oder einen `~/`-erweiterten Pfad. Aus Projekt- oder lokalen Einstellungen wird dies nur berücksichtigt, nachdem Sie den Workspace-Trust-Dialog akzeptieren, da ein geklontes Repository diese Datei bereitstellen kann | `"~/my-memory-dir"` |


238| `awsCredentialExport` | Benutzerdefiniertes Skript, das JSON mit AWS-Anmeldedaten ausgibt (siehe [erweiterte Anmeldedatenkonfiguration](/de/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |241| `awsCredentialExport` | Benutzerdefiniertes Skript, das JSON mit AWS-Anmeldedaten ausgibt (siehe [erweiterte Anmeldedatenkonfiguration](/de/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |

239| `axScreenReader` | {/* min-version: 2.1.181 */}Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Der Bildschirmleser-Modus verwendet immer den klassischen Renderer, daher hat die `tui`-Einstellung keine Auswirkung, während er aktiv ist. Die Umgebungsvariable [`CLAUDE_AX_SCREEN_READER`](/de/env-vars) und das Flag [`--ax-screen-reader`](/de/cli-reference#cli-flags) haben Vorrang. Erfordert Claude Code v2.1.181 oder später | `true` |242| `axScreenReader` | {/* min-version: 2.1.181 */}Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Der Bildschirmleser-Modus verwendet immer den klassischen Renderer, daher hat die `tui`-Einstellung keine Auswirkung, während er aktiv ist. Die Umgebungsvariable [`CLAUDE_AX_SCREEN_READER`](/de/env-vars) und das Flag [`--ax-screen-reader`](/de/cli-reference#cli-flags) haben Vorrang. Erfordert Claude Code v2.1.181 oder später | `true` |

240| `blockedMarketplaces` | (Nur verwaltete Einstellungen) Blocklist von Marketplace-Quellen. Erzwungen bei Marketplace-Hinzufügung und bei Plugin-Installation, Update, Aktualisierung und Auto-Update, sodass ein Marketplace, der vor dem Setzen der Richtlinie hinzugefügt wurde, nicht zum Abrufen von Plugins verwendet werden kann. Blockierte Quellen werden vor dem Download überprüft, sodass sie das Dateisystem nie berühren. Siehe [Verwaltete Marketplace-Einschränkungen](/de/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |243| `blockedMarketplaces` | (Nur verwaltete Einstellungen) Blocklist von Marketplace-Quellen. Erzwungen bei Marketplace-Hinzufügung und bei Plugin-Installation, Update, Aktualisierung und Auto-Update, sodass ein Marketplace, der vor dem Setzen der Richtlinie hinzugefügt wurde, nicht zum Abrufen von Plugins verwendet werden kann. Blockierte Quellen werden vor dem Download überprüft, sodass sie das Dateisystem nie berühren. Siehe [Verwaltete Marketplace-Einschränkungen](/de/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

244| `browserExternalPageTools` | (Nur verwaltete Einstellungen) Setzen Sie auf `"disabled"`, um zu verhindern, dass Claude Tools verwendet, um externe Seiten im [Browser-Bereich](/de/desktop#browse-external-sites) der Desktop-App zu lesen oder zu bearbeiten. Benutzer können weiterhin selbst zu externen Seiten navigieren, und lokale Dev-Server-Vorschau sind nicht betroffen | `"disabled"` |

241| `channelsEnabled` | (Nur verwaltete Einstellungen) Erlauben Sie [Kanäle](/de/channels) für die Organisation. Bei Claude.ai Team- und Enterprise-Plänen werden Kanäle blockiert, wenn dies nicht gesetzt oder `false` ist. Für [Anthropic Console](/de/authentication#claude-console-authentication)-Konten mit API-Schlüssel-Authentifizierung sind Kanäle standardmäßig zulässig, es sei denn, Ihre Organisation stellt verwaltete Einstellungen bereit. In diesem Fall muss dieser Schlüssel auf `true` gesetzt werden | `true` |245| `channelsEnabled` | (Nur verwaltete Einstellungen) Erlauben Sie [Kanäle](/de/channels) für die Organisation. Bei Claude.ai Team- und Enterprise-Plänen werden Kanäle blockiert, wenn dies nicht gesetzt oder `false` ist. Für [Anthropic Console](/de/authentication#claude-console-authentication)-Konten mit API-Schlüssel-Authentifizierung sind Kanäle standardmäßig zulässig, es sei denn, Ihre Organisation stellt verwaltete Einstellungen bereit. In diesem Fall muss dieser Schlüssel auf `true` gesetzt werden | `true` |

242| `claudeMd` | (Nur verwaltete Einstellungen) CLAUDE.md-ähnliche Anweisungen, die als organisationsverwalteter Speicher eingespritzt werden. Wird nur berücksichtigt, wenn in verwalteten oder Richtlinieneinstellungen gesetzt, und ignoriert in Benutzer-, Projekt- und lokalen Einstellungen. Siehe [organisationsweite CLAUDE.md](/de/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |246| `claudeMd` | (Nur verwaltete Einstellungen) CLAUDE.md-ähnliche Anweisungen, die als organisationsverwalteter Speicher eingespritzt werden. Wird nur berücksichtigt, wenn in verwalteten oder Richtlinieneinstellungen gesetzt, und ignoriert in Benutzer-, Projekt- und lokalen Einstellungen. Siehe [organisationsweite CLAUDE.md](/de/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |

243| `claudeMdExcludes` | Glob-Muster oder absolute Pfade von `CLAUDE.md`-Dateien, die beim Laden von [Speicher](/de/memory) übersprungen werden sollen. Muster werden gegen absolute Dateipfade abgeglichen. Gilt nur für Benutzer-, Projekt- und lokalen Speicher; verwaltete Richtliniendateien können nicht ausgeschlossen werden | `["**/vendor/**/CLAUDE.md"]` |247| `claudeMdExcludes` | Glob-Muster oder absolute Pfade von `CLAUDE.md`-Dateien, die beim Laden von [Speicher](/de/memory) übersprungen werden sollen. Muster werden gegen absolute Dateipfade abgeglichen. Gilt nur für Benutzer-, Projekt- und lokalen Speicher; verwaltete Richtliniendateien können nicht ausgeschlossen werden | `["**/vendor/**/CLAUDE.md"]` |

244| `cleanupPeriodDays` | **Standard**: `30` Tage, Minimum `1`. Sitzungsdateien, die älter als dieser Zeitraum sind, werden beim Start gelöscht. Das Setzen auf `0` wird mit einem Validierungsfehler abgelehnt. Steuert auch den Altersgrenzwert für die automatische Entfernung von [verwaisten Subagent-Worktrees](/de/worktrees#clean-up-worktrees) beim Start. Um Transkriptschreibvorgänge vollständig zu deaktivieren, setzen Sie die Umgebungsvariable [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/de/env-vars) oder verwenden Sie im nicht-interaktiven Modus (`-p`) das Flag `--no-session-persistence` oder die SDK-Option `persistSession: false`. | `20` |248| `cleanupPeriodDays` | **Standard**: `30` Tage, Minimum `1`. Claude Code löscht [Sitzungsdateien und andere Anwendungsdaten](/de/claude-directory#cleaned-up-automatically), die älter als dieser Zeitraum sind, beim Start. Das Setzen auf `0` wird mit einem Validierungsfehler abgelehnt. Der gleiche Altersgrenzwert gilt für die automatische Entfernung von [verwaisten Worktrees](/de/worktrees#clean-up-worktrees) beim Start. {/* min-version: 2.1.203 */}Wenn Claude Code eine Einstellungsdatei nicht lesen oder analysieren kann, pausiert es die Aufbewahrungsbereinigung und zeigt eine Warnung in `/status` an, bis Sie die Datei beheben, es sei denn, [verwaltete Einstellungen](/de/server-managed-settings) stellen `cleanupPeriodDays` bereit. In diesem Fall wird die Bereinigung beim verwalteten Wert ausgeführt. Vor v2.1.203 wurde die Bereinigung beim 30-Tage-Standard ausgeführt und konnte Transkripte löschen, die ein längeres `cleanupPeriodDays` behalten sollte; Dateien, die neuer als 30 Tage waren, wurden nie entfernt. Um Transkriptschreibvorgänge vollständig zu deaktivieren, setzen Sie die Umgebungsvariable [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/de/env-vars). Im nicht-interaktiven Modus übergeben Sie `--no-session-persistence` neben `-p` oder setzen Sie `persistSession: false` im Agent SDK. | `20` |

245| `companyAnnouncements` | Ankündigung, die Benutzern beim Start angezeigt werden soll. Wenn mehrere Ankündigungen bereitgestellt werden, werden sie zufällig durchlaufen. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |249| `companyAnnouncements` | Ankündigung, die Benutzern beim Start angezeigt werden soll. Wenn mehrere Ankündigungen bereitgestellt werden, werden sie zufällig durchlaufen. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |

246| `defaultShell` | **Standard**: `"bash"`, oder `"powershell"` unter Windows, wenn Bash nicht verfügbar ist. Standard-Shell für Input-Box `!` Befehle. Akzeptiert `"bash"` oder `"powershell"`. Das Setzen auf `"powershell"` leitet interaktive `!` Befehle über PowerShell unter Windows. Erfordert `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Siehe [PowerShell-Tool](/de/tools-reference#powershell-tool) | `"powershell"` |250| `defaultShell` | **Standard**: `"bash"`, oder `"powershell"` unter Windows, wenn Bash nicht verfügbar ist. Standard-Shell für Input-Box `!` Befehle. Akzeptiert `"bash"` oder `"powershell"`. Das Setzen auf `"powershell"` leitet interaktive `!` Befehle über PowerShell unter Windows. Erfordert `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Siehe [PowerShell-Tool](/de/tools-reference#powershell-tool) | `"powershell"` |

247| `deniedMcpServers` | Wenn in managed-settings.json gesetzt, Denylist von MCP-Servern, die explizit blockiert sind. Gilt für alle Bereiche einschließlich verwalteter Server. Denylist hat Vorrang vor Allowlist. Siehe [Verwaltete MCP-Konfiguration](/de/managed-mcp) | `[{ "serverName": "filesystem" }]` |251| `deniedMcpServers` | Wenn in managed-settings.json gesetzt, Denylist von MCP-Servern, die explizit blockiert sind. Gilt für alle Bereiche einschließlich verwalteter Server. Denylist hat Vorrang vor Allowlist. Siehe [Verwaltete MCP-Konfiguration](/de/managed-mcp) | `[{ "serverName": "filesystem" }]` |


249| `disableAllHooks` | Deaktivieren Sie alle [Hooks](/de/hooks) und alle benutzerdefinierten [Statuszeilen](/de/statusline) | `true` |253| `disableAllHooks` | Deaktivieren Sie alle [Hooks](/de/hooks) und alle benutzerdefinierten [Statuszeilen](/de/statusline) | `true` |

250| `disableArtifact` | Setzen Sie auf `true`, um das [Artifact](/de/artifacts)-Tool zu deaktivieren, das Sitzungsausgabe als private Webseite auf claude.ai veröffentlicht. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_ARTIFACT` auf `1` | `true` |254| `disableArtifact` | Setzen Sie auf `true`, um das [Artifact](/de/artifacts)-Tool zu deaktivieren, das Sitzungsausgabe als private Webseite auf claude.ai veröffentlicht. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_ARTIFACT` auf `1` | `true` |

251| `disableAutoMode` | Setzen Sie auf `"disable"`, um zu verhindern, dass der [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) aktiviert wird. Entfernt `auto` aus dem `Shift+Tab`-Zyklus und lehnt `--permission-mode auto` beim Start ab. Am nützlichsten in [verwalteten Einstellungen](/de/permissions#managed-settings), wo Benutzer es nicht überschreiben können | `"disable"` |255| `disableAutoMode` | Setzen Sie auf `"disable"`, um zu verhindern, dass der [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) aktiviert wird. Entfernt `auto` aus dem `Shift+Tab`-Zyklus und lehnt `--permission-mode auto` beim Start ab. Am nützlichsten in [verwalteten Einstellungen](/de/permissions#managed-settings), wo Benutzer es nicht überschreiben können | `"disable"` |

252| `disableBundledSkills` | Setzen Sie auf `true`, um die [Skills](/de/skills) und Workflows zu deaktivieren, die mit Claude Code ausgeliefert werden: Gebündelte Skills und Workflows werden vollständig entfernt, während integrierte Slash-Befehle wie `/init` tippbar bleiben, aber vom Modell ausgeblendet werden. Skills von Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` auf `1` | `true` |256| `disableBundledSkills` | Setzen Sie auf `true`, um die [Skills](/de/skills) und Workflows zu deaktivieren, die mit Claude Code ausgeliefert werden: Gebündelte Skills und Workflows werden vollständig entfernt, während integrierte Slash-Befehle wie `/init` tippbar bleiben, aber vom Modell ausgeblendet werden. `/doctor` bleibt tippbar wie die integrierten Befehle; blenden Sie ihn mit [`DISABLE_DOCTOR_COMMAND`](/de/env-vars) statt aus. Skills von Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` auf `1` | `true` |

253| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Deaktivieren Sie [claude.ai MCP-Konnektoren](/de/mcp#use-mcp-servers-from-claude-ai), sodass sie nicht automatisch abgerufen oder verbunden werden. Setzen Sie in jedem Einstellungsbereich. `true` in jeder Quelle hat Vorrang, daher kann eine eingecheckte Projekt-`.claude/settings.json` ein Repo aus Cloud-Konnektoren ausschließen, aber ein Projekt-Level `false` kann ein Benutzer- oder Richtlinien-Level `true` nicht überschreiben. Server, die explizit über `--mcp-config` übergeben werden, sind nicht betroffen. Um einzelne Konnektoren statt aller zu verweigern, verwenden Sie [`deniedMcpServers`](/de/managed-mcp). Erfordert Claude Code v2.1.182 oder später | `true` |257| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Deaktivieren Sie [claude.ai MCP-Konnektoren](/de/mcp#use-mcp-servers-from-claude-ai), sodass sie nicht automatisch abgerufen oder verbunden werden. Setzen Sie in jedem Einstellungsbereich. `true` in jeder Quelle hat Vorrang, daher kann eine eingecheckte Projekt-`.claude/settings.json` ein Repo aus Cloud-Konnektoren ausschließen, aber ein Projekt-Level `false` kann ein Benutzer- oder Richtlinien-Level `true` nicht überschreiben. Server, die explizit über `--mcp-config` übergeben werden, sind nicht betroffen. Um einzelne Konnektoren statt aller zu verweigern, verwenden Sie [`deniedMcpServers`](/de/managed-mcp). Erfordert Claude Code v2.1.182 oder später | `true` |

254| `disableDeepLinkRegistration` | Setzen Sie auf `"disable"`, um zu verhindern, dass Claude Code den `claude-cli://` Protokoll-Handler beim Start mit dem Betriebssystem registriert. [Deep Links](/de/deep-links) ermöglichen es externen Tools, eine Claude Code-Sitzung mit einer vorausgefüllten Aufforderung zu öffnen. Nützlich in Umgebungen, in denen die Protokoll-Handler-Registrierung eingeschränkt oder separat verwaltet wird | `"disable"` |258| `disableDeepLinkRegistration` | Setzen Sie auf `"disable"`, um zu verhindern, dass Claude Code den `claude-cli://` Protokoll-Handler beim Start mit dem Betriebssystem registriert. [Deep Links](/de/deep-links) ermöglichen es externen Tools, eine Claude Code-Sitzung mit einer vorausgefüllten Aufforderung zu öffnen. Nützlich in Umgebungen, in denen die Protokoll-Handler-Registrierung eingeschränkt oder separat verwaltet wird | `"disable"` |

255| `disabledMcpjsonServers` | Liste spezifischer MCP-Server aus `.mcp.json`-Dateien zum Ablehnen | `["filesystem"]` |259| `disabledMcpjsonServers` | Liste spezifischer MCP-Server aus `.mcp.json`-Dateien zum Ablehnen | `["filesystem"]` |


262| `enableAllProjectMcpServers` | Genehmigen Sie automatisch alle MCP-Server, die in Projekt-`.mcp.json`-Dateien definiert sind. {/* min-version: 2.1.196 */}Ab v2.1.196 berücksichtigen `claude mcp list` und `claude mcp get` diesen Schlüssel in einem nicht vertrauenswürdigen Ordner nur aus [Einstellungsdateien, die nicht in das Repository eingecheckt sind](/de/mcp#managing-your-servers) | `true` |266| `enableAllProjectMcpServers` | Genehmigen Sie automatisch alle MCP-Server, die in Projekt-`.mcp.json`-Dateien definiert sind. {/* min-version: 2.1.196 */}Ab v2.1.196 berücksichtigen `claude mcp list` und `claude mcp get` diesen Schlüssel in einem nicht vertrauenswürdigen Ordner nur aus [Einstellungsdateien, die nicht in das Repository eingecheckt sind](/de/mcp#managing-your-servers) | `true` |

263| `enableArtifact` | {/* min-version: 2.1.196 */}Aktivieren oder deaktivieren Sie das [Artifact](/de/artifacts)-Tool für diesen Benutzer. Wenn nicht gesetzt, folgt der Standard der [Verfügbarkeit](/de/artifacts#availability) der Funktion für Ihr Konto. Die Zeile **Artifacts** in `/config` schreibt diesen Schlüssel. Ein verwaltetes `disableArtifact` und die [Admin-Einstellung](/de/artifacts#manage-artifacts-for-your-organization) Ihrer Organisation haben Vorrang, und der Schlüssel wird in Projekt- und lokalen Einstellungen (`.claude/settings.json`, `.claude/settings.local.json`) ignoriert, die ein Repository ansonsten committen könnte. Erfordert Claude Code v2.1.196 oder später | `true` |267| `enableArtifact` | {/* min-version: 2.1.196 */}Aktivieren oder deaktivieren Sie das [Artifact](/de/artifacts)-Tool für diesen Benutzer. Wenn nicht gesetzt, folgt der Standard der [Verfügbarkeit](/de/artifacts#availability) der Funktion für Ihr Konto. Die Zeile **Artifacts** in `/config` schreibt diesen Schlüssel. Ein verwaltetes `disableArtifact` und die [Admin-Einstellung](/de/artifacts#manage-artifacts-for-your-organization) Ihrer Organisation haben Vorrang, und der Schlüssel wird in Projekt- und lokalen Einstellungen (`.claude/settings.json`, `.claude/settings.local.json`) ignoriert, die ein Repository ansonsten committen könnte. Erfordert Claude Code v2.1.196 oder später | `true` |

264| `enabledMcpjsonServers` | Liste spezifischer MCP-Server aus `.mcp.json`-Dateien zum Genehmigen. {/* min-version: 2.1.196 */}Ab v2.1.196 berücksichtigen `claude mcp list` und `claude mcp get` diesen Schlüssel in einem nicht vertrauenswürdigen Ordner nur aus [Einstellungsdateien, die nicht in das Repository eingecheckt sind](/de/mcp#managing-your-servers) | `["memory", "github"]` |268| `enabledMcpjsonServers` | Liste spezifischer MCP-Server aus `.mcp.json`-Dateien zum Genehmigen. {/* min-version: 2.1.196 */}Ab v2.1.196 berücksichtigen `claude mcp list` und `claude mcp get` diesen Schlüssel in einem nicht vertrauenswürdigen Ordner nur aus [Einstellungsdateien, die nicht in das Repository eingecheckt sind](/de/mcp#managing-your-servers) | `["memory", "github"]` |

265| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Erweitern Sie die `availableModels` Allowlist auf das Standardmodell. Wenn `true` in verwalteten Einstellungen und `availableModels` ist ein nicht leeres Array, fällt die Standardoption auf den ersten zulässigen Eintrag zurück, der verfügbar ist. Hat keine Auswirkung, wenn `availableModels` nicht gesetzt oder leer ist. Siehe [Erzwingen Sie die Allowlist für das Standardmodell](/de/model-config#enforce-the-allowlist-for-the-default-model). Erfordert Claude Code v2.1.175 oder später | `true` |269| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Erweitern Sie die `availableModels` Allowlist auf das Standardmodell. Wenn `true` in verwalteten Einstellungen und `availableModels` ist ein nicht leeres Array, fällt die Standardoption auf den ersten zulässigen Eintrag zurück, der verfügbar ist, aber nur wenn das Modell, auf das Standard zurückfallen würde (die [Organisationsstandardeinstellung](/de/model-config#organization-default-model), wenn eine gilt, ansonsten die Kontotyp-Standard), nicht in der Allowlist ist; ein zulässiger Standard wird wie es ist beibehalten. Hat keine Auswirkung, wenn `availableModels` nicht gesetzt oder leer ist. Siehe [Erzwingen Sie die Allowlist für das Standardmodell](/de/model-config#enforce-the-allowlist-for-the-default-model). Erfordert Claude Code v2.1.175 oder später | `true` |

266| `env` | Umgebungsvariablen, die auf jede Sitzung und auf Subprozesse angewendet werden, die Claude Code von ihr aus startet. {/* min-version: 2.1.143 */}Ab v2.1.143 werden `NO_COLOR` und `FORCE_COLOR`, die hier gesetzt sind, an Subprozesse übergeben, ändern aber nicht die Farben der Claude Code-Oberfläche selbst. Setzen Sie diese in Ihrer Shell, bevor Sie `claude` starten, um die Oberflächenfarben zu ändern. {/* min-version: 2.1.195 */}Ab v2.1.195 werden Identitätsvariablen, die Claude Code's Hosting-Umgebungen setzen, z. B. `CLAUDE_CODE_REMOTE` und `CLAUDE_CODE_ACCOUNT_UUID`, ignoriert, wenn sie hier gesetzt sind | `{"FOO": "bar"}` |270| `env` | Umgebungsvariablen, die auf jede Sitzung und auf Subprozesse angewendet werden, die Claude Code von ihr aus startet. {/* min-version: 2.1.143 */}Ab v2.1.143 werden `NO_COLOR` und `FORCE_COLOR`, die hier gesetzt sind, an Subprozesse übergeben, ändern aber nicht die Farben der Claude Code-Oberfläche selbst. Setzen Sie diese in Ihrer Shell, bevor Sie `claude` starten, um die Oberflächenfarben zu ändern. {/* min-version: 2.1.195 */}Ab v2.1.195 werden Identitätsvariablen, die Claude Code's Hosting-Umgebungen setzen, z. B. `CLAUDE_CODE_REMOTE` und `CLAUDE_CODE_ACCOUNT_UUID`, ignoriert, wenn sie hier gesetzt sind | `{"FOO": "bar"}` |

267| `fallbackModel` | Fallback-Modell(e) zum Ausprobieren in der Reihenfolge, wenn das primäre Modell überlastet oder nicht verfügbar ist. Claude Code wechselt für den Rest der Runde zum nächsten verfügbaren Modell in der Kette und zeigt einen Hinweis an. `"default"` wird zum Standardmodell erweitert. Ketten sind auf drei Modelle begrenzt; zusätzliche Einträge werden ignoriert. Im Gegensatz zu den meisten Array-Einstellungen wird dieser Schlüssel nicht über Einstellungsdateien zusammengeführt: Die Datei mit der höchsten Priorität, die ihn definiert, liefert die gesamte Kette. Das Flag [`--fallback-model`](/de/cli-reference#cli-flags) überschreibt dies für eine Sitzung. Siehe [Fallback-Modellketten](/de/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |271| `fallbackModel` | Fallback-Modell(e) zum Ausprobieren in der Reihenfolge, wenn das primäre Modell überlastet oder nicht verfügbar ist. Claude Code wechselt für den Rest der Runde zum nächsten verfügbaren Modell in der Kette und zeigt einen Hinweis an. `"default"` wird zum Standardmodell erweitert. Ketten sind auf drei Modelle begrenzt; zusätzliche Einträge werden ignoriert. Im Gegensatz zu den meisten Array-Einstellungen wird dieser Schlüssel nicht über Einstellungsdateien zusammengeführt: Die Datei mit der höchsten Priorität, die ihn definiert, liefert die gesamte Kette. Das Flag [`--fallback-model`](/de/cli-reference#cli-flags) überschreibt dies für eine Sitzung. Siehe [Fallback-Modellketten](/de/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |

268| `fastModePerSessionOptIn` | Wenn `true`, bleibt der schnelle Modus nicht über Sitzungen hinweg bestehen. Jede Sitzung startet mit ausgeschaltetem schnellen Modus und erfordert, dass Benutzer ihn mit `/fast` aktivieren. Die Voreinstellung des Benutzers für den schnellen Modus wird weiterhin gespeichert. Siehe [Opt-in pro Sitzung erforderlich](/de/fast-mode#require-per-session-opt-in) | `true` |272| `fastModePerSessionOptIn` | Wenn `true`, bleibt der schnelle Modus nicht über Sitzungen hinweg bestehen. Jede Sitzung startet mit ausgeschaltetem schnellen Modus und erfordert, dass Benutzer ihn mit `/fast` aktivieren. Die Voreinstellung des Benutzers für den schnellen Modus wird weiterhin gespeichert. Siehe [Opt-in pro Sitzung erforderlich](/de/fast-mode#require-per-session-opt-in) | `true` |

269| `feedbackSurveyRate` | Wahrscheinlichkeit (0–1), dass die [Sitzungsqualitätsumfrage](/de/data-usage#session-quality-surveys) angezeigt wird, wenn berechtigt. Setzen Sie auf `0`, um vollständig zu unterdrücken, oder setzen Sie [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/de/env-vars) in `env`. Nützlich bei Verwendung von Bedrock, Vertex oder Foundry, wo die Standard-Stichprobenquote nicht gilt | `0.05` |273| `feedbackSurveyRate` | Wahrscheinlichkeit (0–1), dass die [Sitzungsqualitätsumfrage](/de/data-usage#session-quality-surveys) angezeigt wird, wenn berechtigt. Setzen Sie auf `0`, um vollständig zu unterdrücken, oder setzen Sie [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/de/env-vars) in `env`. Nützlich bei Verwendung von Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry, wo die Standard-Stichprobenquote nicht gilt | `0.05` |

270| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**Standard**: `true`. Erstellen Sie Snapshots von Dateien vor jeder Bearbeitung, damit [`/rewind`](/de/checkpointing) sie wiederherstellen kann. Wird in `/config` als **Rewind code (checkpoints)** angezeigt. Um dies über eine Umgebungsvariable zu deaktivieren, setzen Sie [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/de/env-vars) in `env` | `false` |274| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**Standard**: `true`. Erstellen Sie Snapshots von Dateien vor jeder Bearbeitung, damit [`/rewind`](/de/checkpointing) sie wiederherstellen kann. Wird in `/config` als **Rewind code (checkpoints)** angezeigt. Um dies über eine Umgebungsvariable zu deaktivieren, setzen Sie [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/de/env-vars) in `env` | `false` |

271| `fileSuggestion` | Konfigurieren Sie ein benutzerdefiniertes Skript für `@` Datei-Autovervollständigung. Siehe [Dateivorschlag-Einstellungen](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |275| `fileSuggestion` | Konfigurieren Sie ein benutzerdefiniertes Skript für `@` Datei-Autovervollständigung. Siehe [Dateivorschlag-Einstellungen](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |

272| `footerLinksRegexes` | {/* min-version: 2.1.176 */}Rendern Sie zusätzliche anklickbare Badges in der Fußzeile, wenn ein Regex die Ausgabe der Runde abgleicht. Jeder Eintrag hat ein `pattern`, eine URL-Vorlage mit `{name}` Platzhaltern, die aus benannten Erfassungsgruppen gefüllt werden, und ein optionales `label`. Nur aus Benutzereinstellungen, dem Flag `--settings` und verwalteten Einstellungen gelesen. Siehe [Footer-Link-Badges](#footer-link-badges) für URL-Einschränkungen, Scheme-Allowlist und Limits. Erfordert Claude Code v2.1.176 oder später | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |276| `footerLinksRegexes` | {/* min-version: 2.1.176 */}Rendern Sie zusätzliche anklickbare Badges in der Fußzeile, wenn ein Regex die Ausgabe der Runde abgleicht. Jeder Eintrag hat ein `pattern`, eine URL-Vorlage mit `{name}` Platzhaltern, die aus benannten Erfassungsgruppen gefüllt werden, und ein optionales `label`. Nur aus Benutzereinstellungen, dem Flag `--settings` und verwalteten Einstellungen gelesen. Siehe [Footer-Link-Badges](#footer-link-badges) für URL-Einschränkungen, Scheme-Allowlist und Limits. Erfordert Claude Code v2.1.176 oder später | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |

273| `forceLoginMethod` | Verwenden Sie `claudeai`, um die Anmeldung auf Claude.ai-Konten zu beschränken, `console`, um die Anmeldung auf Claude Console-Konten zu beschränken, oder `gateway`, um die Anmeldung auf ein Cloud-Gateway zu beschränken; siehe [Claude-Apps-Gateway](/de/claude-apps-gateway). Wenn in verwalteten Einstellungen gesetzt, werden Sitzungen, die durch `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert sind, beim Start blockiert, da eine Umgebungsanmeldedaten die erforderliche Anmeldungsmethode nicht erfüllen kann. Drittanbieter-Provider-Sitzungen wie Bedrock, Vertex und Foundry werden nicht blockiert: Sie authentifizieren sich gegen Ihren Cloud-Provider statt gegen Anthropic | `claudeai` |277| `forceLoginMethod` | Verwenden Sie `claudeai`, um die Anmeldung auf Claude.ai-Konten zu beschränken, `console`, um die Anmeldung auf Claude Console-Konten zu beschränken, oder `gateway`, um die Anmeldung auf ein Cloud-Gateway zu beschränken; siehe [Claude-Apps-Gateway](/de/claude-apps-gateway). Wenn in verwalteten Einstellungen gesetzt, werden Sitzungen, die durch `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert sind, beim Start blockiert, da eine Umgebungsanmeldedaten die erforderliche Anmeldungsmethode nicht erfüllen kann. Drittanbieter-Provider-Sitzungen wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry werden nicht blockiert: Sie authentifizieren sich gegen Ihren Cloud-Provider statt gegen Anthropic | `claudeai` |

274| `forceLoginGatewayUrl` | Füllt den Gateway-URL auf dem `/login` Cloud-Gateway-Bildschirm aus und sperrt ihn. Entweder dieser Schlüssel oder `forceLoginMethod: "gateway"` zeigt diesen Bildschirm an; setzen Sie beide, damit die URL ausgefüllt ist. Wird nur auf der verwalteten Richtlinienebene berücksichtigt; ignoriert in Benutzer- und Projekteinstellungen. Siehe [Claude-Apps-Gateway](/de/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |278| `forceLoginGatewayUrl` | Füllt den Gateway-URL auf dem `/login` Cloud-Gateway-Bildschirm aus und sperrt ihn. Entweder dieser Schlüssel oder `forceLoginMethod: "gateway"` zeigt diesen Bildschirm an; setzen Sie beide, damit die URL ausgefüllt ist. Wird nur auf der verwalteten Richtlinienebene berücksichtigt; ignoriert in Benutzer- und Projekteinstellungen. Siehe [Claude-Apps-Gateway](/de/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |

275| `forceLoginOrgUUID` | Geben Sie die UUID einer Organisation an, um sie während der Anmeldung automatisch auszuwählen und den Organisationsauswahlschritt zu umgehen, oder akzeptieren Sie ein Array von UUIDs, wobei jede aufgelistete Organisation ohne Vorauswahl akzeptiert wird. Wenn in verwalteten Einstellungen gesetzt, schlägt die Anmeldung fehl, wenn das authentifizierte Konto nicht zu einer aufgelisteten Organisation gehört, und Sitzungen, die durch `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert sind, werden beim Start blockiert, da die Organisationszugehörigkeit für sie nicht überprüft werden kann. Drittanbieter-Provider-Sitzungen wie Bedrock, Vertex und Foundry werden nicht blockiert: Verwenden Sie Ihre Cloud-IAM, um einzuschränken, welche Cloud-Konten verwendet werden können. Ein leeres Array schlägt geschlossen fehl und blockiert die Anmeldung mit einer Fehlkonfigurationsmeldung | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` oder `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |279| `forceLoginOrgUUID` | Geben Sie die UUID einer Organisation an, um sie während der Anmeldung automatisch auszuwählen und den Organisationsauswahlschritt zu umgehen, oder akzeptieren Sie ein Array von UUIDs, wobei jede aufgelistete Organisation ohne Vorauswahl akzeptiert wird. Wenn in verwalteten Einstellungen gesetzt, schlägt die Anmeldung fehl, wenn das authentifizierte Konto nicht zu einer aufgelisteten Organisation gehört, und Sitzungen, die durch `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert sind, werden beim Start blockiert, da die Organisationszugehörigkeit für sie nicht überprüft werden kann. Drittanbieter-Provider-Sitzungen wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry werden nicht blockiert: Verwenden Sie Ihre Cloud-IAM, um einzuschränken, welche Cloud-Konten verwendet werden können. Ein leeres Array schlägt geschlossen fehl und blockiert die Anmeldung mit einer Fehlkonfigurationsmeldung | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` oder `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |

276| `forceRemoteSettingsRefresh` | (Nur verwaltete Einstellungen) Blockieren Sie den CLI-Start, bis verwaltete Einstellungen aus der Ferne vom Server abgerufen werden. Wenn der Abruf fehlschlägt, wird die CLI beendet, anstatt mit zwischengespeicherten oder keinen Einstellungen fortzufahren. Wenn nicht gesetzt, wird der Start ohne Warten auf Remote-Einstellungen fortgesetzt. Siehe [Fail-Closed-Durchsetzung](/de/server-managed-settings#enforce-fail-closed-startup) | `true` |280| `forceRemoteSettingsRefresh` | (Nur verwaltete Einstellungen) Blockieren Sie den CLI-Start, bis verwaltete Einstellungen aus der Ferne vom Server abgerufen werden. Wenn der Abruf fehlschlägt, wird die CLI beendet, anstatt mit zwischengespeicherten oder keinen Einstellungen fortzufahren. Wenn nicht gesetzt, wird der Start ohne Warten auf Remote-Einstellungen fortgesetzt. Siehe [Fail-Closed-Durchsetzung](/de/server-managed-settings#enforce-fail-closed-startup) | `true` |

277| `gcpAuthRefresh` | Benutzerdefiniertes Skript, das GCP Application Default Credentials aktualisiert, wenn sie ablaufen oder nicht geladen werden können. Siehe [erweiterte Anmeldedatenkonfiguration](/de/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |281| `gcpAuthRefresh` | Benutzerdefiniertes Skript, das GCP Application Default Credentials aktualisiert, wenn sie ablaufen oder nicht geladen werden können. Siehe [erweiterte Anmeldedatenkonfiguration](/de/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |

278| `hooks` | Konfigurieren Sie benutzerdefinierte Befehle, die bei Lebenszyklusereignissen ausgeführt werden. Siehe [Hooks-Dokumentation](/de/hooks) für das Format | Siehe [Hooks](/de/hooks) |282| `hooks` | Konfigurieren Sie benutzerdefinierte Befehle, die bei Lebenszyklusereignissen ausgeführt werden. Siehe [Hooks-Dokumentation](/de/hooks) für das Format | Siehe [Hooks](/de/hooks) |


282| `language` | Konfigurieren Sie Claudes bevorzugte Antwortsprache (z. B. `"japanese"`, `"spanish"`, `"french"`). Claude wird standardmäßig in dieser Sprache antworten. Legt auch die Sprache für [Sprachdiktieren](/de/voice-dictation#change-the-dictation-language) und automatisch generierte Sitzungstitel fest. {/* min-version: 2.1.176 */}Ab v2.1.176 entsprechen Sitzungstitel, wenn nicht gesetzt, der Sprache Ihres Gesprächs | `"japanese"` |286| `language` | Konfigurieren Sie Claudes bevorzugte Antwortsprache (z. B. `"japanese"`, `"spanish"`, `"french"`). Claude wird standardmäßig in dieser Sprache antworten. Legt auch die Sprache für [Sprachdiktieren](/de/voice-dictation#change-the-dictation-language) und automatisch generierte Sitzungstitel fest. {/* min-version: 2.1.176 */}Ab v2.1.176 entsprechen Sitzungstitel, wenn nicht gesetzt, der Sprache Ihres Gesprächs | `"japanese"` |

283| `minimumVersion` | Verhindern Sie, dass der Auto-Updater und `claude update` eine Version unter dieser installieren. Das Wechseln vom `"latest"`-Kanal zu `"stable"` über `/config` fordert Sie auf, auf der aktuellen Version zu bleiben oder das Downgrade zu erlauben. Wenn Sie sich entscheiden zu bleiben, wird dieser Wert gesetzt. Auch nützlich in [verwalteten Einstellungen](/de/permissions#managed-settings) um eine organisationsweite Mindestversion festzulegen. Für einen Hard Floor, der den Start vollständig blockiert, siehe `requiredMinimumVersion` | `"2.1.100"` |287| `minimumVersion` | Verhindern Sie, dass der Auto-Updater und `claude update` eine Version unter dieser installieren. Das Wechseln vom `"latest"`-Kanal zu `"stable"` über `/config` fordert Sie auf, auf der aktuellen Version zu bleiben oder das Downgrade zu erlauben. Wenn Sie sich entscheiden zu bleiben, wird dieser Wert gesetzt. Auch nützlich in [verwalteten Einstellungen](/de/permissions#managed-settings) um eine organisationsweite Mindestversion festzulegen. Für einen Hard Floor, der den Start vollständig blockiert, siehe `requiredMinimumVersion` | `"2.1.100"` |

284| `model` | Überschreiben Sie das Standardmodell für Claude Code. `--model` und [`ANTHROPIC_MODEL`](/de/model-config#environment-variables) überschreiben dies für eine Sitzung | `"claude-sonnet-5"` |288| `model` | Überschreiben Sie das Standardmodell für Claude Code. `--model` und [`ANTHROPIC_MODEL`](/de/model-config#environment-variables) überschreiben dies für eine Sitzung | `"claude-sonnet-5"` |

285| `modelOverrides` | Ordnen Sie Anthropic-Modell-IDs Anbieter-spezifischen Modell-IDs wie Bedrock-Inferenzprofil-ARNs zu. Jeder Modellwähler-Eintrag verwendet seinen zugeordneten Wert beim Aufrufen der Anbieter-API. Siehe [Modell-IDs pro Version überschreiben](/de/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |289| `modelOverrides` | Ordnen Sie Anthropic-Modell-IDs Anbieter-spezifischen Modell-IDs wie Amazon Bedrock-Inferenzprofil-ARNs zu. Jeder Modellwähler-Eintrag verwendet seinen zugeordneten Wert beim Aufrufen der Anbieter-API. Siehe [Modell-IDs pro Version überschreiben](/de/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |

286| `otelHeadersHelper` | Skript zum Generieren dynamischer OpenTelemetry-Header. Wird beim Start und regelmäßig ausgeführt. Setzen Sie das Aktualisierungsintervall mit [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/de/env-vars). Siehe [Dynamische Header](/de/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |290| `otelHeadersHelper` | Skript zum Generieren dynamischer OpenTelemetry-Header. Wird beim Start und regelmäßig ausgeführt. Setzen Sie das Aktualisierungsintervall mit [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/de/env-vars). Siehe [Dynamische Header](/de/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |

287| `outputStyle` | Konfigurieren Sie einen Ausgabestil, um die Systemaufforderung anzupassen. Siehe [Ausgabestil-Dokumentation](/de/output-styles) | `"Explanatory"` |291| `outputStyle` | Konfigurieren Sie einen Ausgabestil, um die Systemaufforderung anzupassen. Siehe [Ausgabestil-Dokumentation](/de/output-styles) | `"Explanatory"` |

288| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Nur verwaltete Einstellungen) **Standard**: `"first-wins"`. Steuert, ob verwaltete Einstellungen, die programmgesteuert von einem eingebetteten Host-Prozess wie dem Agent SDK oder einer IDE-Erweiterung bereitgestellt werden, gelten, wenn auch eine von Admin bereitgestellte verwaltete Ebene vorhanden ist. `"first-wins"`: die von Parent bereitgestellten Einstellungen werden verworfen und nur die Admin-Ebene gilt. `"merge"`: die von Parent bereitgestellten Einstellungen gelten unter der Admin-Ebene, gefiltert, sodass sie die Richtlinie verschärfen, aber nicht lockern können. Hat keine Auswirkung, wenn keine Admin-Ebene bereitgestellt wird. Erfordert Claude Code v2.1.133 oder später | `"merge"` |292| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Nur verwaltete Einstellungen) **Standard**: `"first-wins"`. Steuert, ob verwaltete Einstellungen, die programmgesteuert von einem eingebetteten Host-Prozess wie dem Agent SDK oder einer IDE-Erweiterung bereitgestellt werden, gelten, wenn auch eine von Admin bereitgestellte verwaltete Ebene vorhanden ist. `"first-wins"`: die von Parent bereitgestellten Einstellungen werden verworfen und nur die Admin-Ebene gilt. `"merge"`: die von Parent bereitgestellten Einstellungen gelten unter der Admin-Ebene, gefiltert, sodass sie die Richtlinie verschärfen, aber nicht lockern können. Hat keine Auswirkung, wenn keine Admin-Ebene bereitgestellt wird. Erfordert Claude Code v2.1.133 oder später | `"merge"` |


302| `showClearContextOnPlanAccept` | **Standard**: `false`. Zeigen Sie die Option "Kontext löschen" auf dem Plan-Akzeptanz-Bildschirm an. Setzen Sie auf `true`, um die Option wiederherzustellen | `true` |306| `showClearContextOnPlanAccept` | **Standard**: `false`. Zeigen Sie die Option "Kontext löschen" auf dem Plan-Akzeptanz-Bildschirm an. Setzen Sie auf `true`, um die Option wiederherzustellen | `true` |

303| `showThinkingSummaries` | **Standard**: `false`. Zeigen Sie [erweitertes Denken](/de/model-config#extended-thinking) Zusammenfassungen in interaktiven Sitzungen an. Wenn nicht gesetzt oder `false`, werden Denk-Blöcke von der API redigiert und als zusammengeklappter Stub angezeigt. Redaktion ändert nur, was Sie sehen, nicht was das Modell generiert: Um Denk-Ausgaben zu reduzieren, [senken Sie das Budget oder deaktivieren Sie das Denken](/de/model-config#extended-thinking) stattdessen. Dieser Einstellung hat keine Auswirkung im nicht-interaktiven Modus (`-p`), dem Agent SDK oder IDE-Erweiterungen wie VS Code | `true` |307| `showThinkingSummaries` | **Standard**: `false`. Zeigen Sie [erweitertes Denken](/de/model-config#extended-thinking) Zusammenfassungen in interaktiven Sitzungen an. Wenn nicht gesetzt oder `false`, werden Denk-Blöcke von der API redigiert und als zusammengeklappter Stub angezeigt. Redaktion ändert nur, was Sie sehen, nicht was das Modell generiert: Um Denk-Ausgaben zu reduzieren, [senken Sie das Budget oder deaktivieren Sie das Denken](/de/model-config#extended-thinking) stattdessen. Dieser Einstellung hat keine Auswirkung im nicht-interaktiven Modus (`-p`), dem Agent SDK oder IDE-Erweiterungen wie VS Code | `true` |

304| `showTurnDuration` | **Standard**: `true`. Zeigen Sie Nachrichten zur Dauer der Runde nach Antworten an, z. B. "Cooked for 1m 6s". Wird in `/config` als **Show turn duration** angezeigt | `false` |308| `showTurnDuration` | **Standard**: `true`. Zeigen Sie Nachrichten zur Dauer der Runde nach Antworten an, z. B. "Cooked for 1m 6s". Wird in `/config` als **Show turn duration** angezeigt | `false` |

305| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**Standard**: `0.01` (1%). Anteil des Kontextfensters des Modells, das für die [Skill-Auflistung](/de/skills#skill-descriptions-are-cut-short) reserviert ist, die Claude jede Runde sieht. Wenn die Auflistung das Budget überschreitet, werden Beschreibungen für die am wenigsten verwendeten Skills auf bloße Namen reduziert, sodass Claude sie weiterhin aufrufen kann, aber nicht sieht, warum. Erhöhen Sie, um mehr Beschreibungen sichtbar zu halten, auf Kosten von mehr Kontext pro Runde. `/doctor` zeigt die aktuelle Kürzungsanzahl und welche Skills betroffen sind. Erfordert Claude Code v2.1.105 oder später | `0.02` |309| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**Standard**: `0.01`. Anteil des Kontextfensters des Modells, das für die [Skill-Auflistung](/de/skills#skill-descriptions-are-cut-short) reserviert ist, die Claude jede Runde sieht. Wenn die Auflistung das Budget überschreitet, werden Beschreibungen für die am wenigsten verwendeten Skills auf bloße Namen reduziert, sodass Claude sie weiterhin aufrufen kann, aber nicht sieht, warum. Erhöhen Sie, um mehr Beschreibungen sichtbar zu halten, auf Kosten von mehr Kontext pro Runde. `/doctor` zeigt die aktuelle Kürzungsanzahl und welche Skills betroffen sind. Erfordert Claude Code v2.1.105 oder später | `0.02` |

306| `skillListingMaxDescChars` | {/* min-version: 2.1.105 */}**Standard**: `1536`. Pro-Skill-Zeichenbegrenzung für den kombinierten `description` und `when_to_use` Text in der [Skill-Auflistung](/de/skills#skill-descriptions-are-cut-short), die Claude jede Runde sieht. Text, der länger als dies ist, wird gekürzt. Erhöhen Sie, um lange Beschreibungen intakt zu halten, auf Kosten von mehr Kontext pro Runde; senken Sie, um mehr Skills unter [`skillListingBudgetFraction`](#available-settings) zu passen. Erfordert Claude Code v2.1.105 oder später | `2048` |310| `skillListingMaxDescChars` | {/* min-version: 2.1.105 */}**Standard**: `1536`. Pro-Skill-Zeichenbegrenzung für den kombinierten `description` und `when_to_use` Text in der [Skill-Auflistung](/de/skills#skill-descriptions-are-cut-short), die Claude jede Runde sieht. Text, der länger als dies ist, wird gekürzt. Erhöhen Sie, um lange Beschreibungen intakt zu halten, auf Kosten von mehr Kontext pro Runde; senken Sie, um mehr Skills unter [`skillListingBudgetFraction`](#available-settings) zu passen. Erfordert Claude Code v2.1.105 oder später | `2048` |

307| `skillOverrides` | {/* min-version: 2.1.129 */}Pro-Skill-Sichtbarkeitsüberschreibungen, die nach Skill-Name verschlüsselt sind. Der Wert ist `"on"`, `"name-only"`, `"user-invocable-only"` oder `"off"`. Ermöglicht es Ihnen, einen Skill auszublenden oder zu reduzieren, ohne seine SKILL.md zu bearbeiten. Gilt nicht für Plugin-Skills, die über `/plugin` verwaltet werden. Das Menü `/skills` schreibt diese in `.claude/settings.local.json`. Siehe [Skill-Sichtbarkeit aus Einstellungen überschreiben](/de/skills#override-skill-visibility-from-settings). Erfordert Claude Code v2.1.129 oder später | `{"legacy-context": "name-only", "deploy": "off"}` |311| `skillOverrides` | {/* min-version: 2.1.129 */}Pro-Skill-Sichtbarkeitsüberschreibungen, die nach Skill-Name verschlüsselt sind. Der Wert ist `"on"`, `"name-only"`, `"user-invocable-only"` oder `"off"`. Ermöglicht es Ihnen, einen Skill auszublenden oder zu reduzieren, ohne seine SKILL.md zu bearbeiten. Gilt nicht für Plugin-Skills, die über `/plugin` verwaltet werden. Das Menü `/skills` schreibt diese in `.claude/settings.local.json`. Siehe [Skill-Sichtbarkeit aus Einstellungen überschreiben](/de/skills#override-skill-visibility-from-settings). Erfordert Claude Code v2.1.129 oder später | `{"legacy-context": "name-only", "deploy": "off"}` |

308| `skipWebFetchPreflight` | Überspringen Sie die [WebFetch-Domänensicherheitsprüfung](/de/data-usage#webfetch-domain-safety-check), die jeden angeforderten Hostnamen an `api.anthropic.com` sendet, bevor Sie abrufen. Setzen Sie auf `true` in Umgebungen, die den Datenverkehr zu Anthropic blockieren, wie Bedrock, Vertex AI oder Foundry-Bereitstellungen mit restriktivem Ausgang. Wenn übersprungen, versucht WebFetch jede URL, ohne die Blocklist zu konsultieren | `true` |312| `skipWebFetchPreflight` | Überspringen Sie die [WebFetch-Domänensicherheitsprüfung](/de/data-usage#webfetch-domain-safety-check), die jeden angeforderten Hostnamen an `api.anthropic.com` sendet, bevor Sie abrufen. Setzen Sie auf `true` in Umgebungen, die den Datenverkehr zu Anthropic blockieren, wie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry-Bereitstellungen mit restriktivem Ausgang. Wenn übersprungen, versucht WebFetch jede URL, ohne die Blocklist zu konsultieren | `true` |

309| `spinnerTipsEnabled` | **Standard**: `true`. Zeigen Sie Tipps im Spinner an, während Claude arbeitet. Setzen Sie auf `false`, um Tipps zu deaktivieren | `false` |313| `spinnerTipsEnabled` | **Standard**: `true`. Zeigen Sie Tipps im Spinner an, während Claude arbeitet. Setzen Sie auf `false`, um Tipps zu deaktivieren | `false` |

310| `spinnerTipsOverride` | Überschreiben Sie Spinner-Tipps mit benutzerdefinierten Zeichenketten. `tips`: Array von Tipp-Zeichenketten. `excludeDefault`: wenn `true`, nur benutzerdefinierte Tipps anzeigen; wenn `false` oder nicht vorhanden, werden benutzerdefinierte Tipps mit integrierten Tipps zusammengeführt | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |314| `spinnerTipsOverride` | Überschreiben Sie Spinner-Tipps mit benutzerdefinierten Zeichenketten. `tips`: Array von Tipp-Zeichenketten. `excludeDefault`: wenn `true`, nur benutzerdefinierte Tipps anzeigen; wenn `false` oder nicht vorhanden, werden benutzerdefinierte Tipps mit integrierten Tipps zusammengeführt | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |

311| `spinnerVerbs` | Passen Sie die Aktionsverben an, die im Spinner angezeigt werden, während eine Runde läuft. Setzen Sie `mode` auf `"replace"`, um nur Ihre Verben zu verwenden, oder `"append"`, um sie zu den Standardwerten hinzuzufügen | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |315| `spinnerVerbs` | Passen Sie die Aktionsverben an, die im Spinner angezeigt werden, während eine Runde läuft. Setzen Sie `mode` auf `"replace"`, um nur Ihre Verben zu verwenden, oder `"append"`, um sie zu den Standardwerten hinzuzufügen | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |


314| `strictKnownMarketplaces` | (Nur verwaltete Einstellungen) Allowlist von Plugin-Marketplace-Quellen. Undefined = keine Einschränkungen, leeres Array = Lockdown. Erzwungen bei Marketplace-Hinzufügung und bei Plugin-Installation, Update, Aktualisierung und Auto-Update, sodass ein Marketplace, der vor dem Setzen der Richtlinie hinzugefügt wurde, nicht zum Abrufen von Plugins verwendet werden kann. Siehe [Verwaltete Marketplace-Einschränkungen](/de/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |318| `strictKnownMarketplaces` | (Nur verwaltete Einstellungen) Allowlist von Plugin-Marketplace-Quellen. Undefined = keine Einschränkungen, leeres Array = Lockdown. Erzwungen bei Marketplace-Hinzufügung und bei Plugin-Installation, Update, Aktualisierung und Auto-Update, sodass ein Marketplace, der vor dem Setzen der Richtlinie hinzugefügt wurde, nicht zum Abrufen von Plugins verwendet werden kann. Siehe [Verwaltete Marketplace-Einschränkungen](/de/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |

315| `strictPluginOnlyCustomization` | (Nur verwaltete Einstellungen) Block Skills, Agenten, Hooks und MCP-Server aus Benutzer- und Projektquellen, sodass sie nur von Plugins oder verwalteten Einstellungen stammen können. `true` sperrt alle vier Oberflächen; ein Array sperrt nur die benannten. Siehe [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |319| `strictPluginOnlyCustomization` | (Nur verwaltete Einstellungen) Block Skills, Agenten, Hooks und MCP-Server aus Benutzer- und Projektquellen, sodass sie nur von Plugins oder verwalteten Einstellungen stammen können. `true` sperrt alle vier Oberflächen; ein Array sperrt nur die benannten. Siehe [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |

316| `syntaxHighlightingDisabled` | Deaktivieren Sie Syntax-Hervorhebung in Diffs, Code-Blöcken und Dateivorschau | `true` |320| `syntaxHighlightingDisabled` | Deaktivieren Sie Syntax-Hervorhebung in Diffs, Code-Blöcken und Dateivorschau | `true` |

317| `teammateMode` | **Standard**: `in-process`. Wie [Agent-Team](/de/agent-teams) Teamkollegen angezeigt werden: `in-process`, `auto` (geteilte Bereiche in tmux oder iTerm2, ansonsten In-Process), `tmux` (geteilte Bereiche mit tmux oder iTerm2, erkannt von Ihrem Terminal) oder {/* min-version: 2.1.186 */}`iterm2` (iTerm2 native Split Panes über die `it2` CLI, hinzugefügt in v2.1.186). Der Standard hat sich in v2.1.179 von `auto` geändert. `--teammate-mode` überschreibt dies für eine Sitzung. Siehe [Wählen Sie einen Anzeigemodus](/de/agent-teams#choose-a-display-mode) | `"auto"` |321| `teammateMode` | **Standard**: `in-process`. Wie [Agent-Team](/de/agent-teams) Teamkollegen angezeigt werden: `in-process`, `auto` (geteilte Bereiche in tmux oder iTerm2, ansonsten In-Process), `tmux` (geteilte Bereiche mit tmux oder iTerm2, erkannt von Ihrem Terminal) oder {/* min-version: 2.1.186 */}}`iterm2` (iTerm2 native Split Panes über die `it2` CLI, hinzugefügt in v2.1.186). Der Standard hat sich in v2.1.179 von `auto` geändert. `--teammate-mode` überschreibt dies für eine Sitzung. Siehe [Wählen Sie einen Anzeigemodus](/de/agent-teams#choose-a-display-mode) | `"auto"` |

318| `terminalProgressBarEnabled` | **Standard**: `true`. Zeigen Sie die Terminal-Fortschrittsleiste in unterstützten Terminals an: ConEmu, Ghostty 1.2.0+ und iTerm2 3.6.6+. Wird in `/config` als **Terminal progress bar** angezeigt | `false` |322| `terminalProgressBarEnabled` | **Standard**: `true`. Zeigen Sie die Terminal-Fortschrittsleiste in unterstützten Terminals an: ConEmu, Ghostty 1.2.0+ und iTerm2 3.6.6+. Wird in `/config` als **Terminal progress bar** angezeigt | `false` |

319| `theme` | {/* min-version: 2.1.119 */}**Standard**: `"dark"`. Farbschema für die Oberfläche: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"` oder eine benutzerdefinierte Theme-Referenz wie `"custom:<slug>"` oder `"custom:<plugin-name>:<slug>"`. Siehe [Erstellen Sie ein benutzerdefiniertes Theme](/de/terminal-config#create-a-custom-theme). Wird in `/config` als **Theme** angezeigt | `"dark"` |323| `theme` | {/* min-version: 2.1.119 */}**Standard**: `"dark"`. Farbschema für die Oberfläche: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"` oder eine benutzerdefinierte Theme-Referenz wie `"custom:<slug>"` oder `"custom:<plugin-name>:<slug>"`. Siehe [Erstellen Sie ein benutzerdefiniertes Theme](/de/terminal-config#create-a-custom-theme). Wird in `/config` als **Theme** angezeigt | `"dark"` |

320| `tui` | Terminal-UI-Renderer. Verwenden Sie `"fullscreen"` für den flimmerfreien [Alt-Screen-Renderer](/de/fullscreen) mit virtualisiertem Scrollback. Verwenden Sie `"default"` für den klassischen Main-Screen-Renderer. Setzen Sie über `/tui`. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_NO_FLICKER`](/de/env-vars) setzen. Hintergrund-Sitzungen, die von [Agent-Ansicht](/de/agent-view) geöffnet werden, verwenden immer den Fullscreen-Renderer, unabhängig von dieser Einstellung | `"fullscreen"` |324| `tui` | Terminal-UI-Renderer. Verwenden Sie `"fullscreen"` für den flimmerfreien [Alt-Screen-Renderer](/de/fullscreen) mit virtualisiertem Scrollback. Verwenden Sie `"default"` für den klassischen Main-Screen-Renderer. Setzen Sie über `/tui`. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_NO_FLICKER`](/de/env-vars) setzen. Hintergrund-Sitzungen, die von [Agent-Ansicht](/de/agent-view) geöffnet werden, verwenden immer den Fullscreen-Renderer, unabhängig von dieser Einstellung | `"fullscreen"` |

321| `ultracode` | Aktivieren Sie [ultracode](/de/workflows#let-claude-decide-with-ultracode) für die Sitzung. Nur für Sitzung und nicht aus `settings.json` gelesen. Setzen Sie über `/effort ultracode`, `--settings` oder eine Agent SDK-Steueranforderung | `true` |325| `ultracode` | Aktivieren Sie [ultracode](/de/workflows#let-claude-decide-with-ultracode) für die Sitzung. Dieser Schlüssel wird nicht aus `settings.json` gelesen. Setzen Sie über `/effort ultracode`, `--settings` oder eine Agent SDK-Steueranforderung. {/* min-version: 2.1.203 */}Um eine Sitzung mit ultracode bereits aktiviert zu starten, starten Sie mit `claude --effort ultracode`, was Claude Code v2.1.203 oder später erfordert | `true` |

322| `useAutoModeDuringPlan` | **Standard**: `true`. Ob Plan Mode Auto-Mode-Semantik verwendet, wenn Auto Mode verfügbar ist. Nicht aus gemeinsamen Projekteinstellungen gelesen. Wird in `/config` als "Use auto mode during plan" angezeigt | `false` |326| `useAutoModeDuringPlan` | **Standard**: `true`. Ob Plan Mode Auto-Mode-Semantik verwendet, wenn Auto Mode verfügbar ist. Nicht aus gemeinsamen Projekteinstellungen gelesen. Wird in `/config` als "Use auto mode during plan" angezeigt | `false` |

323| `verbose` | {/* min-version: 2.1.119 */}**Standard**: `false`. Zeigen Sie vollständige Werkzeugausgabe statt gekürzte Zusammenfassungen an. Wird in `/config` als **Verbose output** angezeigt. Das Flag `--verbose` überschreibt dies für eine Sitzung | `true` |327| `verbose` | {/* min-version: 2.1.119 */}**Standard**: `false`. Zeigen Sie vollständige Werkzeugausgabe statt gekürzte Zusammenfassungen an. Wird in `/config` als **Verbose output** angezeigt. Das Flag `--verbose` überschreibt dies für eine Sitzung | `true` |

324| `viewMode` | Standard-Transkript-Ansichtsmodus beim Start: `"default"`, `"verbose"` oder `"focus"`. Überschreibt die klebrige `/focus`-Auswahl, wenn gesetzt. Das Flag `--verbose` überschreibt dies für eine Sitzung | `"verbose"` |328| `viewMode` | Standard-Transkript-Ansichtsmodus beim Start: `"default"`, `"verbose"` oder `"focus"`. Überschreibt die klebrige `/focus`-Auswahl, wenn gesetzt. Das Flag `--verbose` überschreibt dies für eine Sitzung | `"verbose"` |


339</Note>343</Note>

340 344 

341| Schlüssel | Beschreibung | Beispiel |345| Schlüssel | Beschreibung | Beispiel |

342| :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------- |346| :------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |

343| `autoConnectIde` | **Standard**: `false`. Verbinden Sie sich automatisch mit einer laufenden IDE, wenn Claude Code von einem externen Terminal aus startet. Wird in `/config` als **Auto-connect to IDE (external terminal)** angezeigt, wenn außerhalb eines VS Code oder JetBrains-Terminals ausgeführt wird. Die Umgebungsvariable [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/de/env-vars) überschreibt dies, wenn gesetzt | `true` |347| `autoConnectIde` | **Standard**: `false`. Verbinden Sie sich automatisch mit einer laufenden IDE, wenn Claude Code von einem externen Terminal aus startet. Wird in `/config` als **Auto-connect to IDE (external terminal)** angezeigt, wenn außerhalb eines VS Code oder JetBrains-Terminals ausgeführt wird. Die Umgebungsvariable [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/de/env-vars) überschreibt dies, wenn gesetzt | `true` |

344| `autoInstallIdeExtension` | **Standard**: `true`. Installieren Sie die Claude Code IDE-Erweiterung automatisch, wenn Sie von einem VS Code-Terminal aus ausgeführt werden. Wird in `/config` als **Auto-install IDE extension** angezeigt, wenn Sie in einem VS Code oder JetBrains-Terminal ausgeführt werden. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/de/env-vars) setzen | `false` |348| `autoInstallIdeExtension` | **Standard**: `true`. Installieren Sie die Claude Code IDE-Erweiterung automatisch, wenn Sie von einem VS Code-Terminal aus ausgeführt werden. Wird in `/config` als **Auto-install IDE extension** angezeigt, wenn Sie in einem VS Code oder JetBrains-Terminal ausgeführt werden. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/de/env-vars) auf `1` setzen | `false` |

345| `externalEditorContext` | **Standard**: `false`. Stellen Sie Claudes vorherige Antwort als `#`-kommentierter Kontext voran, wenn Sie den externen Editor mit `Ctrl+G` öffnen. Wird in `/config` als **Show last response in external editor** angezeigt | `true` |349| `externalEditorContext` | **Standard**: `false`. Stellen Sie Claudes vorherige Antwort als `#`-kommentierter Kontext voran, wenn Sie den externen Editor mit `Ctrl+G` öffnen. Wird in `/config` als **Show last response in external editor** angezeigt | `true` |

346| `teammateDefaultModel` | Standardmodell für [Agent-Team](/de/agent-teams) Teamkollegen, wenn die Spawn-Aufforderung keinen angibt. Setzen Sie auf einen Modellalias wie `"sonnet"` oder `null`, um das aktuelle `/model`-Modell des Leads zu erben. Wird in `/config` als **Default teammate model** angezeigt | `"sonnet"` |350| `teammateDefaultModel` | Standardmodell für [Agent-Team](/de/agent-teams) Teamkollegen, wenn die Spawn-Aufforderung keinen angibt. Setzen Sie auf einen Modellalias wie `"sonnet"` oder `null`, um das aktuelle `/model`-Modell des Leads zu erben. Wird in `/config` als **Default teammate model** angezeigt | `"sonnet"` |

351| `workflowSizeGuideline` | {/* min-version: 2.1.202 */}**Standard**: `unrestricted`, das keinen Leitfaden sendet. Legt die [Agent-Anzahl fest, auf die Claude abzielt](/de/workflows#set-a-size-guideline) in den dynamischen Workflows, die es schreibt. Claude Code sendet den Wert an Claude als Ratschlag, nicht als erzwungene Obergrenze. Akzeptiert `unrestricted`, `small`, `medium` oder `large`. Wird in `/config` als **Dynamic workflow size** angezeigt. Sie können es auch direkt mit `/config workflowSizeGuideline=small` setzen. Erfordert Claude Code v2.1.202 oder später. {/* min-version: 2.1.203 */}Der Leitfaden der Agent-Anzahl ersetzt auch den Standard-Schwellenwert für die [`Large workflow` Warnung](/de/workflows#cost); dieses Verhalten erfordert Claude Code v2.1.203 oder später | `"small"` |

347 352 

348<h3 id="worktree-settings">353<h3 id="worktree-settings">

349 Worktree-Einstellungen354 Worktree-Einstellungen


352Konfigurieren Sie, wie `--worktree` Git-Worktrees erstellt und verwaltet.357Konfigurieren Sie, wie `--worktree` Git-Worktrees erstellt und verwaltet.

353 358 

354| Schlüssel | Beschreibung | Beispiel |359| Schlüssel | Beschreibung | Beispiel |

355| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |360| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

356| `worktree.baseRef` | Welcher Ref neue Worktrees branchen von. `"fresh"` (Standard) brancht von `origin/<default-branch>` für einen sauberen Baum, der dem Remote entspricht. `"head"` brancht von Ihrem aktuellen lokalen `HEAD`, sodass nicht gepushte Commits und Feature-Branch-Status im Worktree vorhanden sind. Gilt für `--worktree`, das `EnterWorktree`-Tool und die Subagent-Isolation | `"head"` |361| `worktree.baseRef` | Welcher Ref neue Worktrees branchen von. `"fresh"` (Standard) brancht von `origin/<default-branch>` für einen sauberen Baum, der dem Remote entspricht. `"head"` brancht von Ihrem aktuellen lokalen `HEAD`, sodass nicht gepushte Commits und Feature-Branch-Status im Worktree vorhanden sind. Gilt für `--worktree`, das `EnterWorktree`-Tool und die Subagent-Isolation | `"head"` |

357| `worktree.symlinkDirectories` | Verzeichnisse, die vom Haupt-Repository in jeden Worktree symlinkt werden, um große Verzeichnisse auf der Festplatte zu duplizieren. Standardmäßig werden keine Verzeichnisse symlinkt | `["node_modules", ".cache"]` |362| `worktree.symlinkDirectories` | Verzeichnisse, die vom Haupt-Repository in jeden Worktree symlinkt werden, um große Verzeichnisse auf der Festplatte zu duplizieren. Standardmäßig werden keine Verzeichnisse symlinkt | `["node_modules", ".cache"]` |

358| `worktree.sparsePaths` | Verzeichnisse, die in jedem Worktree über Git Sparse-Checkout ausgecheckt werden. Nur die aufgelisteten Verzeichnisse plus Root-Level-Dateien werden auf die Festplatte geschrieben, was in großen Monorepos schneller ist | `["packages/my-app", "shared/utils"]` |363| `worktree.sparsePaths` | Verzeichnisse, die in jedem Worktree über Git Sparse-Checkout ausgecheckt werden. Nur die aufgelisteten Verzeichnisse plus Root-Level-Dateien werden auf die Festplatte geschrieben, was in großen Monorepos schneller ist | `["packages/my-app", "shared/utils"]` |

359| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Isolationsmodus für [Hintergrund-Sitzungen](/de/agent-view#how-file-edits-are-isolated). `"worktree"` (Standard) blockiert `Edit`/`Write` im Haupt-Checkout, bis `EnterWorktree` aufgerufen wird. `"none"` ermöglicht es Hintergrund-Jobs, die Arbeitskopie direkt zu bearbeiten. Erfordert Claude Code v2.1.143 oder später | `"none"` |364| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Isolationsmodus für [Hintergrund-Sitzungen](/de/agent-view#how-file-edits-are-isolated). `"worktree"` (Standard) blockiert `Edit`/`Write` im Haupt-Checkout, bis `EnterWorktree` aufgerufen wird. {/* min-version: 2.1.203 */}Außerhalb eines Git-Repositorys gibt ein [`WorktreeCreate` Hook](/de/worktrees#non-git-version-control), der fehlschlägt, die Sperre frei, sodass die Sitzung das Arbeitsverzeichnis an Ort und Stelle bearbeiten kann; erfordert Claude Code v2.1.203 oder später. `"none"` ermöglicht es Hintergrund-Jobs, die Arbeitskopie direkt zu bearbeiten. Erfordert Claude Code v2.1.143 oder später | `"none"` |

360 365 

361Um gitignorierte Dateien wie `.env` in neue Worktrees zu kopieren, verwenden Sie stattdessen eine [`.worktreeinclude`-Datei](/de/worktrees#copy-gitignored-files-into-worktrees) in Ihrem Projektstamm.366Um gitignorierte Dateien wie `.env` in neue Worktrees zu kopieren, verwenden Sie stattdessen eine [`.worktreeinclude`-Datei](/de/worktrees#copy-gitignored-files-into-worktrees) in Ihrem Projektstamm.

362 367 


365</h3>370</h3>

366 371 

367| Schlüssel | Beschreibung | Beispiel |372| Schlüssel | Beschreibung | Beispiel |

368| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |373| :---------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |

369| `allow` | Array von Berechtigungsregeln, um die Werkzeugnutzung zu erlauben. Werkzeugname-Globs werden nur in der Werkzeugposition nach einem literalen `mcp__<server>__` Präfix unterstützt, z. B. `mcp__github__get_*`; das Server-Segment muss glob-frei sein. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) unten für Details zur Mustererkennung | `[ "Bash(git diff *)" ]` |374| `allow` | Array von Berechtigungsregeln, um die Werkzeugnutzung zu erlauben. Werkzeugname-Globs werden nur in der Werkzeugposition nach einem literalen `mcp__<server>__` Präfix unterstützt, z. B. `mcp__github__get_*`; das Server-Segment muss glob-frei sein. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) unten für Details zur Mustererkennung | `[ "Bash(git diff *)" ]` |

370| `ask` | Array von Berechtigungsregeln, um bei der Werkzeugnutzung um Bestätigung zu bitten. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) unten | `[ "Bash(git push *)" ]` |375| `ask` | Array von Berechtigungsregeln, um bei der Werkzeugnutzung um Bestätigung zu bitten. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) unten | `[ "Bash(git push *)" ]` |

371| `deny` | Array von Berechtigungsregeln, um die Werkzeugnutzung zu verweigern. Verwenden Sie dies, um sensible Dateien vom Claude Code-Zugriff auszuschließen. Werkzeugnamen akzeptieren Glob-Muster: `"*"` verweigert jedes Werkzeug und `"mcp__*"` verweigert alle MCP-Werkzeuge. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) und [Bash-Berechtigungsbeschränkungen](/de/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |376| `deny` | Array von Berechtigungsregeln, um die Werkzeugnutzung zu verweigern. Verwenden Sie dies, um sensible Dateien vom Claude Code-Zugriff auszuschließen. Werkzeugnamen akzeptieren Glob-Muster: `"*"` verweigert jedes Werkzeug und `"mcp__*"` verweigert alle MCP-Werkzeuge. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) und [Bash-Berechtigungsbeschränkungen](/de/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

372| `additionalDirectories` | Zusätzliche [Arbeitsverzeichnisse](/de/permissions#working-directories) für Dateizugriff. Die meisten `.claude/`-Konfigurationen werden [nicht erkannt](/de/permissions#additional-directories-grant-file-access-not-configuration) aus diesen Verzeichnissen | `[ "../docs/" ]` |377| `additionalDirectories` | Zusätzliche [Arbeitsverzeichnisse](/de/permissions#working-directories) für Dateizugriff. Die meisten `.claude/`-Konfigurationen werden [nicht erkannt](/de/permissions#additional-directories-grant-file-access-not-configuration) aus diesen Verzeichnissen | `[ "../docs/" ]` |

373| `defaultMode` | Standard-[Berechtigungsmodus](/de/permission-modes) beim Öffnen von Claude Code. Gültige Werte: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. {/* min-version: 2.1.142 */}Ab Claude Code v2.1.142 wird `auto` ignoriert, wenn es in Projekt- oder lokalen Einstellungen (`.claude/settings.json`, `.claude/settings.local.json`) gesetzt ist, sodass ein Repository sich nicht selbst den Auto-Modus gewähren kann. Setzen Sie es stattdessen in `~/.claude/settings.json`. Das CLI-Flag `--permission-mode` überschreibt diese Einstellung für eine einzelne Sitzung | `"acceptEdits"` |378| `defaultMode` | Standard-[Berechtigungsmodus](/de/permission-modes) beim Öffnen von Claude Code. Gültige Werte: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` und {/* min-version: 2.1.200 */}}`manual` als Alias für `default`, der Modus mit der Bezeichnung Manual in der CLI und den VS Code- und JetBrains-Erweiterungen. Der Alias `manual` erfordert Claude Code v2.1.200 oder später. {/* min-version: 2.1.142 */}}`auto` wird ignoriert, wenn es in Projekt- oder lokalen Einstellungen gesetzt ist, sodass ein Repository sich nicht selbst den Auto-Modus gewähren kann; setzen Sie es stattdessen in `~/.claude/settings.json`. Vor v2.1.142 konnten Projekteinstellungen `auto` setzen. Das CLI-Flag `--permission-mode` überschreibt diese Einstellung für eine einzelne Sitzung | `"acceptEdits"` |

374| `disableBypassPermissionsMode` | Setzen Sie auf `"disable"`, um zu verhindern, dass der `bypassPermissions`-Modus aktiviert wird. Dies deaktiviert das Befehlszeilenflag `--dangerously-skip-permissions`. Normalerweise in [verwalteten Einstellungen](/de/permissions#managed-settings) platziert, um Organisationsrichtlinien durchzusetzen, funktioniert aber aus jedem Bereich | `"disable"` |379| `disableBypassPermissionsMode` | Setzen Sie auf `"disable"`, um zu verhindern, dass der `bypassPermissions`-Modus aktiviert wird. Dies deaktiviert das Befehlszeilenflag `--dangerously-skip-permissions`. Normalerweise in [verwalteten Einstellungen](/de/permissions#managed-settings) platziert, um Organisationsrichtlinien durchzusetzen, funktioniert aber aus jedem Bereich | `"disable"` |

375| `skipDangerousModePermissionPrompt` | Überspringen Sie die Bestätigungsaufforderung, die vor dem Betreten des Bypass-Berechtigungsmodus über `--dangerously-skip-permissions` oder `defaultMode: "bypassPermissions"` angezeigt wird. Wird ignoriert, wenn in Projekteinstellungen (`.claude/settings.json`) gesetzt, um zu verhindern, dass nicht vertrauenswürdige Repositories die Aufforderung automatisch umgehen | `true` |380| `skipDangerousModePermissionPrompt` | Überspringen Sie die Bestätigungsaufforderung, die vor dem Betreten des Bypass-Berechtigungsmodus über `--dangerously-skip-permissions` oder `defaultMode: "bypassPermissions"` angezeigt wird. Wird ignoriert, wenn in Projekteinstellungen (`.claude/settings.json`) gesetzt, um zu verhindern, dass nicht vertrauenswürdige Repositories die Aufforderung automatisch umgehen | `true` |

376 381 


398Konfigurieren Sie erweitertes Sandbox-Verhalten. Sandboxing isoliert Bash-Befehle von Ihrem Dateisystem und Netzwerk. Siehe [Sandboxing](/de/sandboxing) für Details.403Konfigurieren Sie erweitertes Sandbox-Verhalten. Sandboxing isoliert Bash-Befehle von Ihrem Dateisystem und Netzwerk. Siehe [Sandboxing](/de/sandboxing) für Details.

399 404 

400| Schlüssel | Beschreibung | Beispiel |405| Schlüssel | Beschreibung | Beispiel |

401| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------- |406| :------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

402| `enabled` | Aktivieren Sie Bash-Sandboxing (macOS, Linux und WSL2). Standard: false | `true` |407| `enabled` | Aktivieren Sie Bash-Sandboxing (macOS, Linux und WSL2). Standard: false | `true` |

403| `failIfUnavailable` | Beenden Sie mit einem Fehler beim Start, wenn `sandbox.enabled` true ist, aber die Sandbox nicht gestartet werden kann (fehlende Abhängigkeiten oder nicht unterstützte Plattform). Wenn false (Standard), wird eine Warnung angezeigt und Befehle werden unsandboxed ausgeführt. Vorgesehen für verwaltete Einstellungsbereitstellungen, die Sandboxing als Hard Gate erfordern | `true` |408| `failIfUnavailable` | Beenden Sie mit einem Fehler beim Start, wenn `sandbox.enabled` true ist, aber die Sandbox nicht gestartet werden kann (fehlende Abhängigkeiten oder nicht unterstützte Plattform). Wenn false (Standard), wird eine Warnung angezeigt und Befehle werden unsandboxed ausgeführt. Vorgesehen für verwaltete Einstellungsbereitstellungen, die Sandboxing als Hard Gate erfordern | `true` |

404| `autoAllowBashIfSandboxed` | Genehmigen Sie Bash-Befehle automatisch, wenn sie in einer Sandbox ausgeführt werden. Standard: true | `true` |409| `autoAllowBashIfSandboxed` | Genehmigen Sie Bash-Befehle automatisch, wenn sie in einer Sandbox ausgeführt werden. Standard: true | `true` |


409| `filesystem.denyRead` | Pfade, aus denen Sandbox-Befehle nicht lesen können. Arrays werden über alle Einstellungsbereiche zusammengeführt. Auch zusammengeführt mit Pfaden aus `Read(...)` Deny-Berechtigungsregeln. | `["~/.aws/credentials"]` |414| `filesystem.denyRead` | Pfade, aus denen Sandbox-Befehle nicht lesen können. Arrays werden über alle Einstellungsbereiche zusammengeführt. Auch zusammengeführt mit Pfaden aus `Read(...)` Deny-Berechtigungsregeln. | `["~/.aws/credentials"]` |

410| `filesystem.allowRead` | Pfade zum erneuten Erlauben des Lesens innerhalb von `denyRead`-Regionen. Hat Vorrang vor `denyRead`. Arrays werden über alle Einstellungsbereiche zusammengeführt. Verwenden Sie dies, um Workspace-only-Lesezugriffsmuster zu erstellen. | `["."]` |415| `filesystem.allowRead` | Pfade zum erneuten Erlauben des Lesens innerhalb von `denyRead`-Regionen. Hat Vorrang vor `denyRead`. Arrays werden über alle Einstellungsbereiche zusammengeführt. Verwenden Sie dies, um Workspace-only-Lesezugriffsmuster zu erstellen. | `["."]` |

411| `filesystem.allowManagedReadPathsOnly` | (Nur verwaltete Einstellungen) Nur `filesystem.allowRead` Pfade aus verwalteten Einstellungen werden berücksichtigt. `denyRead` wird weiterhin aus allen Quellen zusammengeführt. Standard: false | `true` |416| `filesystem.allowManagedReadPathsOnly` | (Nur verwaltete Einstellungen) Nur `filesystem.allowRead` Pfade aus verwalteten Einstellungen werden berücksichtigt. `denyRead` wird weiterhin aus allen Quellen zusammengeführt. Standard: false | `true` |

412| `credentials.files` | Anmeldedatendateien oder Verzeichnisse, die Sandbox-Befehle nicht lesen können. Wendet die gleiche Lesesperre wie `filesystem.denyRead` an; der separate Schlüssel hält Anmeldedatenpfade gruppiert mit `credentials.envVars` und getrennt von allgemeinen Dateisystemregeln. Jeder Eintrag ist `{ "path": "...", "mode": "deny" }`. Pfade verwenden die gleichen [Präfixe](#sandbox-path-prefixes) wie `filesystem.*`-Einstellungen. Arrays werden über alle Einstellungsbereiche zusammengeführt. Nur `deny` wird unterstützt. Erfordert Claude Code v2.1.187 oder später. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |417| `credentials.files` | {/* min-version: 2.1.187 */}Anmeldedatendateien oder Verzeichnisse, die Sandbox-Befehle nicht lesen können. Wendet die gleiche Lesesperre wie `filesystem.denyRead` an; der separate Schlüssel hält Anmeldedatenpfade gruppiert mit `credentials.envVars` und getrennt von allgemeinen Dateisystemregeln. Jeder Eintrag ist `{ "path": "...", "mode": "deny" }`, und `deny` ist der einzige unterstützte Modus für Dateien. Pfade verwenden die gleichen [Präfixe](#sandbox-path-prefixes) wie `filesystem.*`-Einstellungen. Arrays werden über alle Einstellungsbereiche zusammengeführt. Erfordert Claude Code v2.1.187 oder später. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |

413| `credentials.envVars` | Umgebungsvariablen, die vor dem Ausführen von Sandbox-Befehlen nicht gesetzt werden. Jeder Eintrag ist `{ "name": "...", "mode": "deny" }`. Arrays werden über alle Einstellungsbereiche zusammengeführt. Nur `deny` wird unterstützt. Erfordert Claude Code v2.1.187 oder später. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |418| `credentials.envVars` | {/* min-version: 2.1.187 */}Umgebungsvariablen zum [Schutz vor Sandbox-Befehlen](/de/sandboxing#protect-credentials). Jeder Eintrag hat einen `name` und einen `mode`; der Name muss mit einem Buchstaben oder Unterstrich beginnen und darf nur Buchstaben, Ziffern und Unterstriche enthalten. `deny` entfernt die Variable aus der Umgebung von Sandbox-Befehlen. Erfordert Claude Code v2.1.187 oder später. {/* min-version: 2.1.199 */}}`mask` ersetzt die Variable mit einem Pro-Sitzungs-Sentinel-Wert innerhalb der Sandbox, während der Sandbox-Proxy den echten Wert bei ausgehenden Anfragen an die `injectHosts` dieses Eintrags ersetzt; es erfordert `network.tlsTerminate` und Claude Code v2.1.199 oder später. `mask` Einträge werden nur aus Benutzer-, verwalteten oder CLI-`--settings` Einstellungen berücksichtigt, nicht aus `.claude/settings.json` oder `.claude/settings.local.json`. Arrays werden über alle Einstellungsbereiche zusammengeführt, und `deny` hat Vorrang, wenn die gleiche Variable mit beiden Modi erscheint. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |

419| `credentials.envVars[].injectHosts` | Hosts, wo der Sandbox-Proxy den echten Wert eines `mask` Eintrags ersetzt. Jeder Host muss auch von `network.allowedDomains` abgedeckt sein, entweder genau oder durch einen Platzhalter. Wenn nicht gesetzt, ersetzt der Proxy den Wert bei Anfragen an jeden Host in `network.allowedDomains`. Wird akzeptiert, aber ignoriert, wenn `mode` `deny` ist. Erfordert Claude Code v2.1.199 oder später. {/* min-version: 2.1.199 */} | `["api.github.com"]` |

420| `credentials.allowPlaintextInject` | Erlauben Sie `mask` Substitution auf Plain-HTTP-Anfragen sowie TLS-terminiertem HTTPS. Bei Plain-HTTP ist die Upstream-Identität nicht überprüft und die Anmeldedaten werden im Klartext übertragen, daher lassen Sie dies außerhalb vertrauenswürdiger Test-Netzwerke aus. Wird nur aus Benutzer-, verwalteten oder CLI-`--settings` Einstellungen berücksichtigt, nicht aus `.claude/settings.json` oder `.claude/settings.local.json`. Standard: false. Erfordert Claude Code v2.1.199 oder später. {/* min-version: 2.1.199 */} | `true` |

414| `network.allowUnixSockets` | (Nur macOS) Unix-Socket-Pfade, auf die in der Sandbox zugegriffen werden kann. Wird unter Linux und WSL2 ignoriert, wo der Seccomp-Filter `socket(AF_UNIX, ...)` Aufrufe nicht überprüfen kann; verwenden Sie stattdessen `allowAllUnixSockets`. | `["~/.ssh/agent-socket"]` |421| `network.allowUnixSockets` | (Nur macOS) Unix-Socket-Pfade, auf die in der Sandbox zugegriffen werden kann. Wird unter Linux und WSL2 ignoriert, wo der Seccomp-Filter `socket(AF_UNIX, ...)` Aufrufe nicht überprüfen kann; verwenden Sie stattdessen `allowAllUnixSockets`. | `["~/.ssh/agent-socket"]` |

415| `network.allowAllUnixSockets` | Erlauben Sie alle Unix-Socket-Verbindungen in der Sandbox. Unter Linux und WSL2 ist dies die einzige Möglichkeit, Unix-Sockets zu erlauben, da der Seccomp-Filter übersprungen wird, der ansonsten `socket(AF_UNIX, ...)` Aufrufe blockiert. Standard: false | `true` |422| `network.allowAllUnixSockets` | Erlauben Sie alle Unix-Socket-Verbindungen in der Sandbox. Unter Linux und WSL2 ist dies die einzige Möglichkeit, Unix-Sockets zu erlauben, da der Seccomp-Filter übersprungen wird, der ansonsten `socket(AF_UNIX, ...)` Aufrufe blockiert. Standard: false | `true` |

416| `network.allowLocalBinding` | Erlauben Sie das Binden an Localhost-Ports (nur macOS). Standard: false | `true` |423| `network.allowLocalBinding` | Erlauben Sie das Binden an Localhost-Ports (nur macOS). Standard: false | `true` |


420| `network.allowManagedDomainsOnly` | (Nur verwaltete Einstellungen) Nur `allowedDomains` und `WebFetch(domain:...)` Allow-Regeln aus verwalteten Einstellungen werden berücksichtigt. Domänen aus Benutzer-, Projekt- und lokalen Einstellungen werden ignoriert. Nicht zulässige Domänen werden automatisch blockiert, ohne den Benutzer zu fragen. Verweigerte Domänen werden weiterhin aus allen Quellen berücksichtigt. Standard: false | `true` |427| `network.allowManagedDomainsOnly` | (Nur verwaltete Einstellungen) Nur `allowedDomains` und `WebFetch(domain:...)` Allow-Regeln aus verwalteten Einstellungen werden berücksichtigt. Domänen aus Benutzer-, Projekt- und lokalen Einstellungen werden ignoriert. Nicht zulässige Domänen werden automatisch blockiert, ohne den Benutzer zu fragen. Verweigerte Domänen werden weiterhin aus allen Quellen berücksichtigt. Standard: false | `true` |

421| `network.httpProxyPort` | HTTP-Proxy-Port, der verwendet wird, wenn Sie Ihren eigenen Proxy verwenden möchten. Wenn nicht angegeben, führt Claude seinen eigenen Proxy aus. | `8080` |428| `network.httpProxyPort` | HTTP-Proxy-Port, der verwendet wird, wenn Sie Ihren eigenen Proxy verwenden möchten. Wenn nicht angegeben, führt Claude seinen eigenen Proxy aus. | `8080` |

422| `network.socksProxyPort` | SOCKS5-Proxy-Port, der verwendet wird, wenn Sie Ihren eigenen Proxy verwenden möchten. Wenn nicht angegeben, führt Claude seinen eigenen Proxy aus. | `8081` |429| `network.socksProxyPort` | SOCKS5-Proxy-Port, der verwendet wird, wenn Sie Ihren eigenen Proxy verwenden möchten. Wenn nicht angegeben, führt Claude seinen eigenen Proxy aus. | `8081` |

430| `network.tlsTerminate` | Experimentell. Beenden Sie TLS innerhalb des Sandbox-Proxys, damit er den Inhalt von HTTPS-Anfragen lesen kann. Erforderlich für `mask` [Anmeldedaten-Substitution](/de/sandboxing#protect-credentials). Setzen Sie `{}`, um eine ephemerale Zertifizierungsstelle für die Sitzung zu generieren, oder setzen Sie `caCertPath` und `caKeyPath`, um Ihre eigene zu verwenden. Wird nur aus Benutzer-, verwalteten oder CLI-`--settings` Einstellungen berücksichtigt, nicht aus `.claude/settings.json` oder `.claude/settings.local.json`. Erfordert Claude Code v2.1.199 oder später. {/* min-version: 2.1.199 */} | `{}` |

423| `enableWeakerNestedSandbox` | Aktivieren Sie schwächere Sandbox für unprivilegierte Docker-Umgebungen (nur Linux und WSL2). **Reduziert die Sicherheit.** Standard: false | `true` |431| `enableWeakerNestedSandbox` | Aktivieren Sie schwächere Sandbox für unprivilegierte Docker-Umgebungen (nur Linux und WSL2). **Reduziert die Sicherheit.** Standard: false | `true` |

424| `enableWeakerNetworkIsolation` | (Nur macOS) Erlauben Sie den Zugriff auf den System-TLS-Vertrauensdienst (`com.apple.trustd.agent`) in der Sandbox. Erforderlich für Go-basierte Tools wie `gh`, `gcloud` und `terraform`, um TLS-Zertifikate zu überprüfen, wenn `httpProxyPort` mit einem MITM-Proxy und benutzerdefinierter CA verwendet wird. **Reduziert die Sicherheit** durch Öffnen eines möglichen Datenexfiltrationspfads. Standard: false | `true` |432| `enableWeakerNetworkIsolation` | (Nur macOS) Erlauben Sie den Zugriff auf den System-TLS-Vertrauensdienst (`com.apple.trustd.agent`) in der Sandbox. Erforderlich für Go-basierte Tools wie `gh`, `gcloud` und `terraform`, um TLS-Zertifikate zu überprüfen, wenn `httpProxyPort` mit einem MITM-Proxy und benutzerdefinierter CA verwendet wird. **Reduziert die Sicherheit** durch Öffnen eines möglichen Datenexfiltrationspfads. Standard: false | `true` |

425| `allowAppleEvents` | (Nur macOS) Erlauben Sie Sandbox-Befehlen, Apple Events zu senden. Erforderlich für `open`, `osascript` und Tools, die URLs in einem Browser öffnen, die ansonsten mit Fehler `-600` fehlschlagen. **Entfernt Code-Ausführungs-Isolation.** Sandbox-Befehle können andere Anwendungen unsandboxed ohne Benutzer-Aufforderung starten; sie können auch AppleScript-Befehle an laufende Anwendungen wie Terminal senden, unterliegen aber der Pro-App-macOS-Automatisierungs-Zustimmungs-Aufforderung (TCC). Wird nur aus Benutzer-, verwalteten oder CLI-Einstellungen berücksichtigt, nicht aus Projekteinstellungen. Standard: false | `true` |433| `allowAppleEvents` | (Nur macOS) Erlauben Sie Sandbox-Befehlen, Apple Events zu senden. Erforderlich für `open`, `osascript` und Tools, die URLs in einem Browser öffnen, die ansonsten mit Fehler `-600` fehlschlagen. **Entfernt Code-Ausführungs-Isolation.** Sandbox-Befehle können andere Anwendungen unsandboxed ohne Benutzer-Aufforderung starten; sie können auch AppleScript-Befehle an laufende Anwendungen wie Terminal senden, unterliegen aber der Pro-App-macOS-Automatisierungs-Zustimmungs-Aufforderung (TCC). Wird nur aus Benutzer-, verwalteten oder CLI-Einstellungen berücksichtigt, nicht aus Projekteinstellungen. Standard: false | `true` |


627 Berechnen Sie verwaltete Einstellungen mit einem Policy Helper635 Berechnen Sie verwaltete Einstellungen mit einem Policy Helper

628</h3>636</h3>

629 637 

630Die Einstellung `policyHelper` verweist auf eine ausführbare Datei, die verwaltete Einstellungen beim Start dynamisch berechnet, sodass Administratoren Richtlinien von Geräteposition, Identität oder einem Remote-Service ableiten können, anstatt eine statische Datei zu verwenden. Konfigurieren Sie sie von MDM oder einer System-`managed-settings.json`-Datei. Claude Code ignoriert `policyHelper`, wenn es in einem anderen Bereich erscheint, einschließlich Benutzereinstellungen, Projekteinstellungen, der HKCU-Registry-Struktur und [serververwalteten Einstellungen](/de/server-managed-settings).638Die Einstellung `policyHelper` verweist auf eine ausführbare Datei, die verwaltete Einstellungen beim Start dynamisch berechnet, sodass Administratoren Richtlinien von Geräteposition, Identität oder einem Remote-Service ableiten können, anstatt eine statische Datei zu verwenden. Konfigurieren Sie sie von MDM oder einer System-`managed-settings.json`-Datei. Claude Code ignoriert `policyHelper`, wenn es in einem anderen Bereich erscheint, einschließlich Benutzereinstellungen, Projekteinstellungen, der HKCU-Registry-Struktur und [Serververwalteten Einstellungen](/de/server-managed-settings).

631 639 

632Die Einstellung akzeptiert diese Schlüssel:640Die Einstellung akzeptiert diese Schlüssel:

633 641 


657 665 

658Einstellungen werden in Prioritätsreihenfolge angewendet. Von höchster zu niedrigster:666Einstellungen werden in Prioritätsreihenfolge angewendet. Von höchster zu niedrigster:

659 667 

6601. **Verwaltete Einstellungen** ([serververwaltete](/de/server-managed-settings), [MDM/OS-Richtlinien](#configuration-scopes) oder [verwaltete Einstellungen](/de/settings#settings-files))6681. **Verwaltete Einstellungen** ([Serververwaltete](/de/server-managed-settings), [MDM/OS-Richtlinien](#configuration-scopes) oder [Verwaltete Einstellungen](/de/settings#settings-files))

661 * Richtlinien, die von IT über Server-Bereitstellung, MDM-Konfigurationsprofile, Registry-Richtlinien oder verwaltete Einstellungsdateien bereitgestellt werden669 * Richtlinien, die von IT über Server-Bereitstellung, MDM-Konfigurationsprofile, Registry-Richtlinien oder verwaltete Einstellungsdateien bereitgestellt werden

662 * Können nicht durch andere Ebenen überschrieben werden, einschließlich Befehlszeilenargumenten670 * Können nicht durch andere Ebenen überschrieben werden, einschließlich Befehlszeilenargumenten

663 * Innerhalb der verwalteten Ebene ist die Priorität: [`policyHelper`](#compute-managed-settings-with-a-policy-helper) Ausgabe, die bei Konfiguration die einzige verwaltete Quelle ist > Remote (claude.ai [serververwaltete](/de/server-managed-settings) oder [Claude-Apps-Gateway](/de/claude-apps-gateway)-bereitgestellt) > MDM/OS-Richtlinien > dateibasierte (`managed-settings.d/*.json` + `managed-settings.json`) > HKCU-Registry (nur Windows). Nur eine verwaltete Quelle wird verwendet; Quellen werden nicht zusammengeführt, mit einer Ausnahme: die Sandbox-Sperr-Schlüssel `sandbox.network.allowManagedDomainsOnly` und `sandbox.filesystem.allowManagedReadPathsOnly`, mit ihren zugehörigen Allowlists, `allowAllClaudeAiMcps` und die Sandbox-Binär-Pfade `sandbox.bwrapPath` und `sandbox.socatPath` werden berücksichtigt, wenn eine Admin-kontrollierte verwaltete Quelle sie setzt; die benutzerbare HKCU-Ebene ist ausgeschlossen. Innerhalb der dateibasierten Ebene werden Drop-in-Dateien und die Basisdatei zusammengeführt.671 * Innerhalb der verwalteten Ebene ist die Priorität: [`policyHelper`](#compute-managed-settings-with-a-policy-helper) Ausgabe, die bei Konfiguration die einzige verwaltete Quelle ist > Remote (claude.ai [Serververwaltete](/de/server-managed-settings) oder [Claude-Apps-Gateway](/de/claude-apps-gateway)-bereitgestellt) > MDM/OS-Richtlinien > dateibasierte (`managed-settings.d/*.json` + `managed-settings.json`) > HKCU-Registry (nur Windows). Nur eine verwaltete Quelle wird verwendet; Quellen werden nicht zusammengeführt, mit einer Ausnahme: die Sandbox-Sperr-Schlüssel `sandbox.network.allowManagedDomainsOnly` und `sandbox.filesystem.allowManagedReadPathsOnly`, mit ihren zugehörigen Allowlists, `allowAllClaudeAiMcps` und die Sandbox-Binär-Pfade `sandbox.bwrapPath` und `sandbox.socatPath` werden berücksichtigt, wenn eine Admin-kontrollierte verwaltete Quelle sie setzt; die benutzerbare HKCU-Ebene ist ausgeschlossen. Innerhalb der dateibasierten Ebene werden Drop-in-Dateien und die Basisdatei zusammengeführt.

664 * Eingebettete Hosts wie Claude Desktop können Richtlinien über die SDK `managedSettings` Option bereitstellen. Standardmäßig wird dies ignoriert, wenn eine Admin-bereitgestellte verwaltete Quelle vorhanden ist: serververwaltete Einstellungen, eine MDM- oder OS-Richtlinie oder eine verwaltete Einstellungsdatei. Der benutzerbare HKCU-Registry-Fallback zählt nicht als Admin-bereitgestellte Quelle. Administratoren können sich anmelden, indem sie [`parentSettingsBehavior`](#available-settings) auf `"merge"` setzen. Die Werte des Embedders werden gefiltert, sodass sie verwaltete Richtlinien verschärfen, aber nicht lockern können.672 * Eingebettete Hosts wie Claude Desktop können Richtlinien über die SDK `managedSettings` Option bereitstellen. Standardmäßig wird dies ignoriert, wenn eine Admin-bereitgestellte verwaltete Quelle vorhanden ist: Serververwaltete Einstellungen, eine MDM- oder OS-Richtlinie oder eine verwaltete Einstellungsdatei. Der benutzerbare HKCU-Registry-Fallback zählt nicht als Admin-bereitgestellte Quelle. Administratoren können sich anmelden, indem sie [`parentSettingsBehavior`](#available-settings) auf `"merge"` setzen. Die Werte des Embedders werden gefiltert, sodass sie verwaltete Richtlinien verschärfen, aber nicht lockern können.

665 673 

6662. **Befehlszeilenargumente**6742. **Befehlszeilenargumente**

667 * Temporäre Überschreibungen für eine bestimmte Sitzung. JSON, das über `--settings <file-or-json>` übergeben wird, wird mit dateibasierten Einstellungen unter Verwendung der gleichen Regeln wie die anderen Ebenen zusammengeführt: Ein hier gesetzter Schlüssel überschreibt den gleichen Schlüssel in lokalen, Projekt- oder Benutzereinstellungen, und das Weglassen eines Schlüssels lässt den Wert der niedrigeren Ebene bestehen675 * Temporäre Überschreibungen für eine bestimmte Sitzung. JSON, das über `--settings <file-or-json>` übergeben wird, wird mit dateibasierten Einstellungen unter Verwendung der gleichen Regeln wie die anderen Ebenen zusammengeführt: Ein hier gesetzter Schlüssel überschreibt den gleichen Schlüssel in lokalen, Projekt- oder Benutzereinstellungen, und das Weglassen eines Schlüssels lässt den Wert der niedrigeren Ebene bestehen


697* Wenn eine Ebene wie `User settings` oder `Project local settings` angezeigt wird, wird diese Datei gelesen.705* Wenn eine Ebene wie `User settings` oder `Project local settings` angezeigt wird, wird diese Datei gelesen.

698* Wenn eine Ebene fehlt, wurde diese Datei nicht gefunden oder enthält keine Schlüssel.706* Wenn eine Ebene fehlt, wurde diese Datei nicht gefunden oder enthält keine Schlüssel.

699 707 

700Wenn [verwaltete Einstellungen](/de/admin-setup#decide-how-settings-reach-devices) wirksam sind, zeigt der Eintrag den Bereitstellungskanal in Klammern an, z. B. `Enterprise managed settings (remote)`, `(plist)`, `(HKLM)`, `(HKCU)` oder `(file)`. Der `remote` Kanal deckt sowohl claude.ai serververwaltete Einstellungen als auch [Claude-Apps-Gateway](/de/claude-apps-gateway)-bereitgestellte Richtlinien ab.708Wenn [verwaltete Einstellungen](/de/admin-setup#decide-how-settings-reach-devices) wirksam sind, zeigt der Eintrag den Bereitstellungskanal in Klammern an, z. B. `Enterprise managed settings (remote)`, `(plist)`, `(HKLM)`, `(HKCU)` oder `(file)`. Der `remote` Kanal deckt sowohl claude.ai Serververwaltete Einstellungen als auch [Claude-Apps-Gateway](/de/claude-apps-gateway)-bereitgestellte Richtlinien ab.

701 709 

702Die Zeile bestätigt, welche Dateien gelesen werden, nicht welche Ebene jeden einzelnen Schlüssel bereitgestellt hat. Die Registerkarte **Config** im gleichen Dialog bearbeitet integrierte Umschalter wie Thema und ausführliche Ausgabe, nicht Ihre `settings.json`-Inhalte.710Die Zeile bestätigt, welche Dateien gelesen werden, nicht welche Ebene jeden einzelnen Schlüssel bereitgestellt hat. Die Registerkarte **Config** im gleichen Dialog bearbeitet integrierte Umschalter wie Thema und ausführliche Ausgabe, nicht Ihre `settings.json`-Inhalte.

703 711 

setup.md +9 −3

Details

188 Authentifizierung188 Authentifizierung

189</h2>189</h2>

190 190 

191Claude Code erfordert ein Pro-, Max-, Team-, Enterprise- oder Console-Konto. Der kostenlose Claude.ai-Plan beinhaltet keinen Claude Code-Zugriff. Sie können Claude Code auch mit einem Drittanbieter-API-Provider wie [Amazon Bedrock](/de/amazon-bedrock), [Google Vertex AI](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) verwenden.191Claude Code erfordert ein Pro-, Max-, Team-, Enterprise- oder Console-Konto. Der kostenlose Claude.ai-Plan beinhaltet keinen Claude Code-Zugriff. Sie können Claude Code auch mit einem Drittanbieter-API-Provider wie [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) verwenden.

192 192 

193Nach der Installation melden Sie sich an, indem Sie `claude` ausführen und den Browser-Aufforderungen folgen. Siehe [Authentifizierung](/de/authentication) für alle Kontotypen und Team-Setup-Optionen.193Nach der Installation melden Sie sich an, indem Sie `claude` ausführen und den Browser-Aufforderungen folgen. Siehe [Authentifizierung](/de/authentication) für alle Kontotypen und Team-Setup-Optionen.

194 194 


376 376 

377<Tabs>377<Tabs>

378 <Tab title="apt">378 <Tab title="apt">

379 Für Debian und Ubuntu. Die folgenden Befehle konfigurieren den `stable`-Kanal:379 Für Debian und Ubuntu. Die Installationsbefehle unten laden den Signaturschlüssel mit `curl` herunter, den frische Debian- und Ubuntu-Installationen möglicherweise nicht enthalten. Wenn der Download mit `sudo: curl: command not found` fehlschlägt, installieren Sie zuerst curl:

380 

381 ```bash theme={null}

382 sudo apt install curl

383 ```

384 

385 Die folgenden Befehle konfigurieren den `stable`-Kanal:

380 386 

381 ```bash theme={null}387 ```bash theme={null}

382 sudo install -d -m 0755 /etc/apt/keyrings388 sudo install -d -m 0755 /etc/apt/keyrings


526 </Step>532 </Step>

527 533 

528 <Step title="Überprüfen Sie die Binärdatei gegen das Manifest">534 <Step title="Überprüfen Sie die Binärdatei gegen das Manifest">

529 Vergleichen Sie die SHA256-Prüfsumme Ihrer heruntergeladenen Binärdatei mit dem Wert, der unter `platforms.<platform>.checksum` in `manifest.json` aufgelistet ist.535 Vergleichen Sie die SHA256-Prüfsumme der Binärdatei mit dem Wert, der unter `platforms.<platform>.checksum` in `manifest.json` aufgelistet ist. Die folgenden Befehle gehen davon aus, dass sich eine `claude`-Binärdatei im aktuellen Verzeichnis befindet. Um stattdessen eine installierte native Binärdatei zu überprüfen, führen Sie den Befehl gegen `~/.local/share/claude/versions/VERSION` aus und ersetzen Sie VERSION durch die Veröffentlichung, die Sie in Schritt 2 festgelegt haben.

530 536 

531 <Tabs>537 <Tabs>

532 <Tab title="Linux">538 <Tab title="Linux">

skills.md +12 −4

Details

22 Gebündelte Skills22 Gebündelte Skills

23</h2>23</h2>

24 24 

25Claude Code wird mit einer Reihe von gebündelten Skills ausgeliefert, die in jeder Sitzung verfügbar sind, sofern sie nicht mit der Einstellung [`disableBundledSkills`](/de/settings#available-settings) deaktiviert werden, einschließlich `/code-review`, `/batch`, `/debug`, `/loop` und `/claude-api`. Im Gegensatz zu den meisten integrierten Befehlen, die direkt feste Logik ausführen, sind gebündelte Skills prompt-basiert: Sie geben Claude detaillierte Anweisungen und lassen es die Arbeit mit seinen Tools orchestrieren. Sie rufen sie auf die gleiche Weise auf wie jeden anderen Skill, indem Sie `/` gefolgt vom Skill-Namen eingeben.25Claude Code wird mit einer Reihe von gebündelten Skills ausgeliefert, die in jeder Sitzung verfügbar sind, sofern sie nicht mit der Einstellung [`disableBundledSkills`](/de/settings#available-settings) deaktiviert werden, einschließlich `/doctor`, `/code-review`, `/batch`, `/debug`, `/loop` und `/claude-api`. Im Gegensatz zu den meisten integrierten Befehlen, die direkt feste Logik ausführen, sind gebündelte Skills prompt-basiert: Sie geben Claude detaillierte Anweisungen und lassen es die Arbeit mit seinen Tools orchestrieren. Sie rufen sie auf die gleiche Weise auf wie jeden anderen Skill, indem Sie `/` gefolgt vom Skill-Namen eingeben.

26 

27Die [`/doctor`](/de/commands#all-commands) Setup-Überprüfung ist die eine Ausnahme zu `disableBundledSkills` in Claude Code v2.1.205 und später: Sie bleibt eingabbar, wenn die Einstellung aktiviert ist. Um sie auszublenden, setzen Sie die Umgebungsvariable `DISABLE_DOCTOR_COMMAND` oder einen [`skillOverrides`](#override-skill-visibility-from-settings) Eintrag von `"doctor": "off"`. Vor v2.1.205 war `/doctor` ein integrierter Befehl und kein gebündelter Skill.

26 28 

27Gebündelte Skills sind in der [Befehlsreferenz](/de/commands) neben integrierten Befehlen aufgelistet und mit **Skill** in der Spalte „Zweck" gekennzeichnet.29Gebündelte Skills sind in der [Befehlsreferenz](/de/commands) neben integrierten Befehlen aufgelistet und mit **Skill** in der Spalte „Zweck" gekennzeichnet.

28 30 


129 131 

130Wenn Sie `/deploy` eingeben, wird der Skill in der Projekt-Root ausgeführt. Geben Sie den qualifizierten Namen `/apps/web:deploy` ein, um die verschachtelte Variante explizit auszuführen.132Wenn Sie `/deploy` eingeben, wird der Skill in der Projekt-Root ausgeführt. Geben Sie den qualifizierten Namen `/apps/web:deploy` ein, um die verschachtelte Variante explizit auszuführen.

131 133 

134Wenn Sie oder Claude den unqualifizierten Namen aufrufen, wird der Skill in der Projekt-Root geladen, und Claude Code fügt eine Liste der verzeichnisqualifizierten Varianten zu seinem Inhalt mit einer Anweisung hinzu, auch jede Variante aufzurufen, deren Verzeichnis die Dateien enthält, an denen Claude arbeitet. Ein verschachtelter Skill gilt daher immer noch für die Arbeit in seinem Verzeichnis, wenn nur der unqualifizierte Name aufgerufen wird. Erfordert Claude Code v2.1.203 oder später.

135 

132Ein `<skill-name>`-Eintrag an den Standorten Unternehmen, Persönlich oder Projekt kann ein Symlink zu einem Verzeichnis an anderer Stelle auf der Festplatte sein. Claude Code folgt dem Symlink und liest `SKILL.md` aus dem Zielverzeichnis, und wenn dasselbe Ziel von mehr als einem Ort aus erreichbar ist, lädt Claude Code den Skill einmal. Plugin-Skills handhaben Symlinks anders; siehe [Dateien in einem Marketplace mit Symlinks teilen](/de/plugins-reference#share-files-within-a-marketplace-with-symlinks).136Ein `<skill-name>`-Eintrag an den Standorten Unternehmen, Persönlich oder Projekt kann ein Symlink zu einem Verzeichnis an anderer Stelle auf der Festplatte sein. Claude Code folgt dem Symlink und liest `SKILL.md` aus dem Zielverzeichnis, und wenn dasselbe Ziel von mehr als einem Ort aus erreichbar ist, lädt Claude Code den Skill einmal. Plugin-Skills handhaben Symlinks anders; siehe [Dateien in einem Marketplace mit Symlinks teilen](/de/plugins-reference#share-files-within-a-marketplace-with-symlinks).

133 137 

134<Note>138<Note>


294| `$ARGUMENTS` | Alle Argumente, die beim Aufrufen des Skills übergeben werden. Wenn `$ARGUMENTS` nicht im Inhalt vorhanden ist, werden Argumente als `ARGUMENTS: <value>` angehängt. |298| `$ARGUMENTS` | Alle Argumente, die beim Aufrufen des Skills übergeben werden. Wenn `$ARGUMENTS` nicht im Inhalt vorhanden ist, werden Argumente als `ARGUMENTS: <value>` angehängt. |

295| `$ARGUMENTS[N]` | Greifen Sie auf ein bestimmtes Argument nach 0-basiertem Index zu, z. B. `$ARGUMENTS[0]` für das erste Argument. |299| `$ARGUMENTS[N]` | Greifen Sie auf ein bestimmtes Argument nach 0-basiertem Index zu, z. B. `$ARGUMENTS[0]` für das erste Argument. |

296| `$N` | Kurzform für `$ARGUMENTS[N]`, z. B. `$0` für das erste Argument oder `$1` für das zweite. |300| `$N` | Kurzform für `$ARGUMENTS[N]`, z. B. `$0` für das erste Argument oder `$1` für das zweite. |

297| `$name` | Benanntes Argument, das in der [`arguments`](#frontmatter-reference)-Frontmatter-Liste deklariert ist. Namen werden in Reihenfolge auf Positionen abgebildet, daher wird mit `arguments: [issue, branch]` der Platzhalter `$issue` zum ersten Argument erweitert und `$branch` zum zweiten. |301| `$name` | Benanntes Argument, das in der [`arguments`](#available-string-substitutions)-Frontmatter-Liste deklariert ist. Namen werden in Reihenfolge auf Positionen abgebildet, daher wird mit `arguments: [issue, branch]` der Platzhalter `$issue` zum ersten Argument erweitert und `$branch` zum zweiten. |

298| `${CLAUDE_SESSION_ID}` | Die aktuelle Sitzungs-ID. Nützlich zum Protokollieren, Erstellen sitzungsspezifischer Dateien oder Korrelieren der Skill-Ausgabe mit Sitzungen. |302| `${CLAUDE_SESSION_ID}` | Die aktuelle Sitzungs-ID. Nützlich zum Protokollieren, Erstellen sitzungsspezifischer Dateien oder Korrelieren der Skill-Ausgabe mit Sitzungen. |

299| `${CLAUDE_EFFORT}` | Die aktuelle Anstrengungsstufe: `low`, `medium`, `high`, `xhigh` oder `max`. Ultracode ist keine separate Stufe und wird als `xhigh` gemeldet. Verwenden Sie dies, um Skill-Anweisungen an die aktive Anstrengungseinstellung anzupassen. |303| `${CLAUDE_EFFORT}` | Die aktuelle Anstrengungsstufe: `low`, `medium`, `high`, `xhigh` oder `max`. Ultracode ist keine separate Stufe und wird als `xhigh` gemeldet. Verwenden Sie dies, um Skill-Anweisungen an die aktive Anstrengungseinstellung anzupassen. |

300| `${CLAUDE_SKILL_DIR}` | Das Verzeichnis, das die `SKILL.md`-Datei des Skills enthält. Für Plugin-Skills ist dies das Skill-Unterverzeichnis im Plugin, nicht das Plugin-Root. Verwenden Sie dies in Bash-Injektionsbefehlen, um auf Scripts oder Dateien zu verweisen, die mit dem Skill gebündelt sind, unabhängig vom aktuellen Arbeitsverzeichnis. |304| `${CLAUDE_SKILL_DIR}` | Das Verzeichnis, das die `SKILL.md`-Datei des Skills enthält. Für Plugin-Skills ist dies das Skill-Unterverzeichnis im Plugin, nicht das Plugin-Root. Verwenden Sie dies in Bash-Injektionsbefehlen, um auf Scripts oder Dateien zu verweisen, die mit dem Skill gebündelt sind, unabhängig vom aktuellen Arbeitsverzeichnis. |


390 394 

391Wenn Sie oder Claude einen Skill aufrufen, wird der gerenderte `SKILL.md`-Inhalt als einzelne Nachricht in das Gespräch eingegeben und bleibt dort für den Rest der Sitzung. Claude Code liest die Skill-Datei bei späteren Zügen nicht erneut, daher schreiben Sie Anleitung, die während einer Aufgabe gelten sollte, als stehende Anweisungen statt als einmalige Schritte.395Wenn Sie oder Claude einen Skill aufrufen, wird der gerenderte `SKILL.md`-Inhalt als einzelne Nachricht in das Gespräch eingegeben und bleibt dort für den Rest der Sitzung. Claude Code liest die Skill-Datei bei späteren Zügen nicht erneut, daher schreiben Sie Anleitung, die während einer Aufgabe gelten sollte, als stehende Anweisungen statt als einmalige Schritte.

392 396 

397Wenn Claude einen Skill erneut aufruft, dessen gerenderter Inhalt identisch mit der bereits im Kontext vorhandenen Kopie ist, fügt Claude Code eine kurze Notiz hinzu, dass der Skill bereits geladen ist, anstatt eine zweite Kopie des Inhalts zu erstellen. Wenn sich der gerenderte Inhalt unterscheidet, weil sich die Argumente geändert haben oder ein [dynamischer Kontext](#inject-dynamic-context)-Befehl neue Ausgabe erzeugt hat, hängt Claude Code den vollständigen Inhalt erneut an. Vor v2.1.202 hängte jeder erneute Aufruf eine weitere vollständige Kopie der Skill-Anweisungen an.

398 

393[Auto-Komprimierung](/de/how-claude-code-works#when-context-fills-up) trägt aufgerufene Skills innerhalb eines Token-Budgets weiter. Wenn das Gespräch zusammengefasst wird, um Kontext freizugeben, hängt Claude Code die neueste Aufrufe jedes Skills nach der Zusammenfassung wieder an und behält die ersten 5.000 Token jedes Skills. Wieder angehängte Skills teilen sich ein kombiniertes Budget von 25.000 Token. Claude Code füllt dieses Budget ab dem zuletzt aufgerufenen Skill, sodass ältere Skills vollständig gelöscht werden können, wenn Sie viele in einer Sitzung aufgerufen haben.399[Auto-Komprimierung](/de/how-claude-code-works#when-context-fills-up) trägt aufgerufene Skills innerhalb eines Token-Budgets weiter. Wenn das Gespräch zusammengefasst wird, um Kontext freizugeben, hängt Claude Code die neueste Aufrufe jedes Skills nach der Zusammenfassung wieder an und behält die ersten 5.000 Token jedes Skills. Wieder angehängte Skills teilen sich ein kombiniertes Budget von 25.000 Token. Claude Code füllt dieses Budget ab dem zuletzt aufgerufenen Skill, sodass ältere Skills vollständig gelöscht werden können, wenn Sie viele in einer Sitzung aufgerufen haben.

394 400 

395Wenn ein Skill das Verhalten nach der ersten Antwort nicht mehr zu beeinflussen scheint, ist der Inhalt normalerweise immer noch vorhanden und das Modell wählt andere Tools oder Ansätze. Stärken Sie die `description` und Anweisungen des Skills, damit das Modell es weiterhin bevorzugt, oder verwenden Sie [Hooks](/de/hooks), um Verhalten deterministisch zu erzwingen. Wenn der Skill groß ist oder Sie mehrere andere danach aufgerufen haben, rufen Sie ihn nach der Komprimierung erneut auf, um den vollständigen Inhalt wiederherzustellen.401Wenn ein Skill das Verhalten nach der ersten Antwort nicht mehr zu beeinflussen scheint, ist der Inhalt normalerweise immer noch vorhanden und das Modell wählt andere Tools oder Ansätze. Stärken Sie die `description` und Anweisungen des Skills, damit das Modell es weiterhin bevorzugt, oder verwenden Sie [Hooks](/de/hooks), um Verhalten deterministisch zu erzwingen. Wenn der Skill groß ist oder Sie mehrere andere danach aufgerufen haben, rufen Sie ihn nach der Komprimierung erneut auf, um den vollständigen Inhalt wiederherzustellen.


908 Skill-Beschreibungen werden gekürzt914 Skill-Beschreibungen werden gekürzt

909</h3>915</h3>

910 916 

911Skill-Beschreibungen werden in den Kontext geladen, damit Claude weiß, was verfügbar ist. Alle Skill-Namen sind immer enthalten, aber wenn Sie viele Skills haben, werden Beschreibungen gekürzt, um in das Zeichenbudget zu passen, was die Schlüsselwörter entfernen kann, die Claude benötigt, um Ihre Anfrage zu erfüllen. Das Budget skaliert bei 1% des Kontextfensters des Modells. Wenn es überläuft, werden Beschreibungen für die Skills, die Sie am wenigsten aufrufen, zuerst gelöscht, sodass die Skills, die Sie tatsächlich verwenden, ihren vollständigen Text behalten. Führen Sie `/doctor` aus, um zu sehen, wie viele Skill-Beschreibungen gekürzt oder gelöscht werden und welche Skills betroffen sind.917Claude Code lädt eine Auflistung von Skill-Namen und Beschreibungen in den Kontext, damit Claude weiß, was verfügbar ist. Die Auflistung enthält immer jeden Skill-Namen, aber wenn Sie viele Skills haben, kürzt Claude Code Beschreibungen, um in das Zeichenbudget der Auflistung zu passen, was die Schlüsselwörter entfernen kann, die Claude benötigt, um Ihre Anfrage zu erfüllen. Das Budget skaliert bei 1% des Kontextfensters des Modells. Wenn die Auflistung überläuft, löscht Claude Code Beschreibungen beginnend mit den Skills, die Sie am wenigsten aufrufen, sodass die Skills, die Sie am meisten verwenden, ihren vollständigen Text behalten.

918 

919Führen Sie `/doctor` aus, um eine Schätzung der Kontextkosten der Auflistung und ihrer größten Beitragenden zu erhalten. Wenn die Auflistung ihr Budget überschreitet, schreibt Claude Code auch eine Warnung in das Debug-Protokoll, sichtbar mit [`--debug`](/de/cli-reference#cli-flags).

912 920 

913Ab v2.1.196 zeigt die Skills-Zeile in `/context` die Größe der Auflistung nach Anwendung des Budgets an, sodass sie dem entspricht, was das Modell erhält. Frühere Versionen zählten den vollständigen Text jeder Beschreibung, sodass die Zeile einen Wert anzeigen konnte, der mehrmals größer als das Budget ist, das `/doctor` meldet.921Die Skills-Zeile in `/context` meldet die Größe der Auflistung nach Anwendung des Budgets, sodass sie dem entspricht, was das Modell erhält. Vor v2.1.196 zählte die Zeile den vollständigen Text jeder Beschreibung und konnte einen Wert anzeigen, der mehrmals größer als das konfigurierte Budget ist.

914 922 

915Um das Budget zu erhöhen, setzen Sie die Einstellung [`skillListingBudgetFraction`](/de/settings#available-settings) (z. B. `0.02` = 2%) oder die Umgebungsvariable `SLASH_COMMAND_TOOL_CHAR_BUDGET` auf eine feste Zeichenanzahl. Um Budget für andere Skills freizugeben, setzen Sie Einträge mit niedriger Priorität auf `"name-only"` in [`skillOverrides`](#override-skill-visibility-from-settings), damit sie ohne Beschreibung aufgelistet werden. Sie können auch den Text `description` und `when_to_use` an der Quelle kürzen: Stellen Sie den wichtigsten Anwendungsfall an den Anfang, da der kombinierte Text jedes Eintrags unabhängig vom Budget auf 1.536 Zeichen begrenzt ist. Die Obergrenze ist mit [`skillListingMaxDescChars`](/de/settings#available-settings) konfigurierbar.923Um das Budget zu erhöhen, setzen Sie die Einstellung [`skillListingBudgetFraction`](/de/settings#available-settings) (z. B. `0.02` = 2%) oder die Umgebungsvariable `SLASH_COMMAND_TOOL_CHAR_BUDGET` auf eine feste Zeichenanzahl. Um Budget für andere Skills freizugeben, setzen Sie Einträge mit niedriger Priorität auf `"name-only"` in [`skillOverrides`](#override-skill-visibility-from-settings), damit sie ohne Beschreibung aufgelistet werden. Sie können auch den Text `description` und `when_to_use` an der Quelle kürzen: Stellen Sie den wichtigsten Anwendungsfall an den Anfang, da der kombinierte Text jedes Eintrags unabhängig vom Budget auf 1.536 Zeichen begrenzt ist. Die Obergrenze ist mit [`skillListingMaxDescChars`](/de/settings#available-settings) konfigurierbar.

916 924 

statusline.md +3 −1

Details

1044}1044}

1045```1045```

1046 1046 

1047Der Befehl wird einmal pro Aktualisierungstick mit allen sichtbaren Subagenten-Zeilen ausgeführt, die als einzelnes JSON-Objekt auf stdin übergeben werden. Die Eingabe enthält die [Basis-Hook-Felder](/de/hooks#common-input-fields) plus `columns` (die nutzbare Zeilenbreite) und ein `tasks` Array, wobei jede Aufgabe `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `tokenCount`, `tokenSamples` und `cwd` hat.1047Der Befehl wird einmal pro Aktualisierungstick mit allen sichtbaren Subagenten-Zeilen ausgeführt, die als einzelnes JSON-Objekt auf stdin übergeben werden. Die Eingabe enthält die [Basis-Hook-Felder](/de/hooks#common-input-fields), ein `columns` Feld mit der nutzbaren Zeilenbreite und ein `tasks` Array. Jede Aufgabe hat `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `model`, `contextWindowSize`, `tokenCount`, `tokenSamples` und `cwd`.

1048 

1049Das `model` Feld pro Aufgabe ist die aufgelöste Modell-ID, auf der die Aufgabe ausgeführt wird. `contextWindowSize` ist das Kontextfenster dieses Modells in Token, berechnet auf die gleiche Weise wie das `context_window.context_window_size` der Hauptstatuszeile, sodass Sie einen Prozentsatz pro Zeile aus `tokenCount` rendern können. Beide Felder erfordern Claude Code v2.1.205 oder später und werden für eine Aufgabe weggelassen, deren Modell noch nicht aufgelöst ist.

1048 1050 

1049Schreiben Sie eine JSON-Zeile auf stdout pro Zeile, die Sie überschreiben möchten, in der Form `{"id": "<task id>", "content": "<row body>"}`. Der `content` String wird wie vorhanden gerendert, einschließlich ANSI-Farben und OSC 8 Hyperlinks. Lassen Sie die `id` einer Aufgabe weg, um die Standard-Rendering für diese Zeile zu behalten; geben Sie einen leeren `content` String aus, um sie auszublenden.1051Schreiben Sie eine JSON-Zeile auf stdout pro Zeile, die Sie überschreiben möchten, in der Form `{"id": "<task id>", "content": "<row body>"}`. Der `content` String wird wie vorhanden gerendert, einschließlich ANSI-Farben und OSC 8 Hyperlinks. Lassen Sie die `id` einer Aufgabe weg, um die Standard-Rendering für diese Zeile zu behalten; geben Sie einen leeren `content` String aus, um sie auszublenden.

1050 1052 

sub-agents.md +14 −6

Details

183 183 

184Claude Code scannt `.claude/agents/` und `~/.claude/agents/` rekursiv, sodass Sie Definitionen in Unterordnern wie `agents/review/` oder `agents/research/` organisieren können. Der Unterverzeichnis-Pfad beeinflusst nicht, wie ein Subagent identifiziert oder aufgerufen wird, da die Identität nur vom `name`-Frontmatter-Feld stammt.184Claude Code scannt `.claude/agents/` und `~/.claude/agents/` rekursiv, sodass Sie Definitionen in Unterordnern wie `agents/review/` oder `agents/research/` organisieren können. Der Unterverzeichnis-Pfad beeinflusst nicht, wie ein Subagent identifiziert oder aufgerufen wird, da die Identität nur vom `name`-Frontmatter-Feld stammt.

185 185 

186Halten Sie `name`-Werte über den gesamten Baum eindeutig: Wenn zwei Dateien innerhalb eines Umfangs denselben Namen deklarieren, behält Claude Code eine und verwirft die andere ohne Warnung. {/* min-version: 2.1.196 */}Ab v2.1.196 meldet die Ausführung von `/doctor` Duplikate von Agenten mit gleichem Umfang und zeigt, welche Definition aktiv ist.186Halten Sie `name`-Werte über den gesamten Baum eindeutig: Wenn zwei Dateien unter demselben `.claude/agents/`-Verzeichnis, einschließlich seiner Unterordner, denselben Namen deklarieren, lädt Claude Code nur eine von ihnen, ausgewählt nach Dateisystem-Lesereihenfolge statt nach dokumentierter Priorität. Über verschachtelte Projekt-Verzeichnisse hinweg gewinnt die Definition, die dem Arbeitsverzeichnis am nächsten liegt, wie oben beschrieben. {/* min-version: 2.1.205 */}Die [`/doctor`](/de/commands#all-commands)-Setup-Überprüfung meldet Dateien im selben Verzeichnis, die einen Namen teilen, und schlägt vor, alle außer einer umzubenennen oder zu entfernen. Vor v2.1.205 öffnete `/doctor` einen Diagnose-Bildschirm, der Duplikate auflistete und zeigte, welche Definition aktiv war.

187 187 

188Plugin-`agents/`-Verzeichnisse werden ebenfalls rekursiv gescannt. Im Gegensatz zu Projekt- und Benutzer-Umfängen wird ein Unterordner in einem Plugin-`agents/`-Verzeichnis Teil des [scoped identifier](#invoke-subagents-explicitly): Eine Datei unter `agents/review/security.md` im Plugin `my-plugin` registriert sich als `my-plugin:review:security`.188Plugin-`agents/`-Verzeichnisse werden ebenfalls rekursiv gescannt. Im Gegensatz zu Projekt- und Benutzer-Umfängen wird ein Unterordner in einem Plugin-`agents/`-Verzeichnis Teil des [scoped identifier](#invoke-subagents-explicitly): Eine Datei unter `agents/review/security.md` im Plugin `my-plugin` registriert sich als `my-plugin:review:security`.

189 189 


266specific, actionable feedback on quality, security, and best practices.266specific, actionable feedback on quality, security, and best practices.

267```267```

268 268 

269Das Frontmatter definiert die Metadaten und Konfiguration des Subagenten. Der Body wird zum Systemprompt, der das Verhalten des Subagenten leitet. Subagenten erhalten nur diesen Systemprompt (plus grundlegende Umgebungsdetails wie Arbeitsverzeichnis), nicht den vollständigen Claude Code-Systemprompt.269Das Frontmatter definiert die Metadaten und Konfiguration des Subagenten. Der Body wird zum Systemprompt, der das Verhalten des Subagenten leitet. Subagenten erhalten nur diesen Systemprompt plus grundlegende Umgebungsdetails wie Arbeitsverzeichnis, nicht den vollständigen Claude Code-Systemprompt.

270 

271Im [nicht-interaktiven Modus](/de/headless) hängt das Flag [`--append-subagent-system-prompt`](/de/cli-reference#cli-flags) den von Ihnen bereitgestellten Text an das Ende des Systemprompts jedes Subagenten an, einschließlich verschachtelter Subagenten. Erfordert Claude Code v2.1.205 oder später.

270 272 

271Ein Subagent startet im aktuellen Arbeitsverzeichnis der Hauptkonversation. Innerhalb eines Subagenten bleiben `cd`-Befehle nicht zwischen Bash- oder PowerShell-Werkzeugaufrufen bestehen und beeinflussen nicht das Arbeitsverzeichnis der Hauptkonversation. Um dem Subagenten stattdessen eine isolierte Kopie des Repositorys zu geben, setzen Sie [`isolation: worktree`](#supported-frontmatter-fields).273Ein Subagent startet im aktuellen Arbeitsverzeichnis der Hauptkonversation. Innerhalb eines Subagenten bleiben `cd`-Befehle nicht zwischen Bash- oder PowerShell-Werkzeugaufrufen bestehen und beeinflussen nicht das Arbeitsverzeichnis der Hauptkonversation. Um dem Subagenten stattdessen eine isolierte Kopie des Repositorys zu geben, setzen Sie [`isolation: worktree`](#supported-frontmatter-fields).

272 274 

275{/* min-version: 2.1.203 */}Ein Subagent mit `isolation: worktree` führt seine Bash- und PowerShell-Befehle in seinem Worktree aus. Ein Befehl, dessen Arbeitsverzeichnis sich stattdessen zu Ihrem Haupt-Checkout auflöst, beispielsweise weil das Worktree-Verzeichnis entfernt wurde, während der Subagent lief, schlägt mit einem Fehler fehl. Vor v2.1.203 konnte ein solcher Befehl im Haupt-Checkout ausgeführt werden.

276 

273<h4 id="supported-frontmatter-fields">277<h4 id="supported-frontmatter-fields">

274 Unterstützte Frontmatter-Felder278 Unterstützte Frontmatter-Felder

275</h4>279</h4>


283| `tools` | Nein | [Werkzeuge](#available-tools), die der Subagent verwenden kann. Erbt alle Werkzeuge, wenn weggelassen. Um Skills in den Kontext zu laden, verwenden Sie das `skills`-Feld statt `Skill` hier aufzulisten |287| `tools` | Nein | [Werkzeuge](#available-tools), die der Subagent verwenden kann. Erbt alle Werkzeuge, wenn weggelassen. Um Skills in den Kontext zu laden, verwenden Sie das `skills`-Feld statt `Skill` hier aufzulisten |

284| `disallowedTools` | Nein | Werkzeuge zum Verweigern, entfernt aus geerbter oder angegebener Liste |288| `disallowedTools` | Nein | Werkzeuge zum Verweigern, entfernt aus geerbter oder angegebener Liste |

285| `model` | Nein | [Modell](#choose-a-model) zu verwenden: `sonnet`, `opus`, `haiku`, `fable`, eine vollständige Modell-ID (z. B. `claude-opus-4-8`) oder `inherit`. Standard ist `inherit` |289| `model` | Nein | [Modell](#choose-a-model) zu verwenden: `sonnet`, `opus`, `haiku`, `fable`, eine vollständige Modell-ID (z. B. `claude-opus-4-8`) oder `inherit`. Standard ist `inherit` |

286| `permissionMode` | Nein | [Berechtigungsmodus](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions` oder `plan`. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |290| `permissionMode` | Nein | [Berechtigungsmodus](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan` oder {/* min-version: 2.1.200 */}`manual` als Alias für `default`. Der `manual`-Alias erfordert Claude Code v2.1.200 oder später. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |

287| `maxTurns` | Nein | Maximale Anzahl von Agenten-Turns, bevor der Subagent stoppt |291| `maxTurns` | Nein | Maximale Anzahl von Agenten-Turns, bevor der Subagent stoppt |

288| `skills` | Nein | [Skills](/de/skills) zum Vorausladen in den Kontext des Subagenten beim Start. Der vollständige Skill-Inhalt wird eingespritzt, nicht nur die Beschreibung. Subagenten können weiterhin unlisted Projekt-, Benutzer- und Plugin-Skills durch das Skill-Werkzeug aufrufen |292| `skills` | Nein | [Skills](/de/skills) zum Vorausladen in den Kontext des Subagenten beim Start. Der vollständige Skill-Inhalt wird eingespritzt, nicht nur die Beschreibung. Subagenten können weiterhin unlisted Projekt-, Benutzer- und Plugin-Skills durch das Skill-Werkzeug aufrufen |

289| `mcpServers` | Nein | [MCP-Server](/de/mcp) verfügbar für diesen Subagenten. Jeder Eintrag ist entweder ein Servername, der auf einen bereits konfigurierten Server verweist (z. B. `"slack"`) oder eine Inline-Definition mit dem Servernamen als Schlüssel und einer vollständigen [MCP-Server-Konfiguration](/de/mcp#installing-mcp-servers) als Wert. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |293| `mcpServers` | Nein | [MCP-Server](/de/mcp) verfügbar für diesen Subagenten. Jeder Eintrag ist entweder ein Servername, der auf einen bereits konfigurierten Server verweist (z. B. `"slack"`) oder eine Inline-Definition mit dem Servernamen als Schlüssel und einer vollständigen [MCP-Server-Konfiguration](/de/mcp#installing-mcp-servers) als Wert. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |


304* **Modell-Alias**: Verwenden Sie einen der verfügbaren Aliase: `sonnet`, `opus`, `haiku` oder `fable`308* **Modell-Alias**: Verwenden Sie einen der verfügbaren Aliase: `sonnet`, `opus`, `haiku` oder `fable`

305* **Vollständige Modell-ID**: Verwenden Sie eine vollständige Modell-ID wie `claude-opus-4-8` oder `claude-sonnet-5`. Akzeptiert dieselben Werte wie das `--model`-Flag309* **Vollständige Modell-ID**: Verwenden Sie eine vollständige Modell-ID wie `claude-opus-4-8` oder `claude-sonnet-5`. Akzeptiert dieselben Werte wie das `--model`-Flag

306* **inherit**: Verwenden Sie dasselbe Modell wie die Hauptkonversation310* **inherit**: Verwenden Sie dasselbe Modell wie die Hauptkonversation

307* **Weggelassen**: Wenn nicht angegeben, wird standardmäßig `inherit` verwendet (verwendet dasselbe Modell wie die Hauptkonversation)311* **Omitted**: Wenn nicht angegeben, wird standardmäßig `inherit` verwendet (verwendet dasselbe Modell wie die Hauptkonversation)

308 312 

309Wenn Claude einen Subagenten aufruft, kann es auch einen `model`-Parameter für diese spezifische Invokation übergeben. Claude Code löst das Modell des Subagenten in dieser Reihenfolge auf:313Wenn Claude einen Subagenten aufruft, kann es auch einen `model`-Parameter für diese spezifische Invokation übergeben. Claude Code löst das Modell des Subagenten in dieser Reihenfolge auf:

310 314 

3111. Die Umgebungsvariable [`CLAUDE_CODE_SUBAGENT_MODEL`](/de/model-config#environment-variables), falls gesetzt3151. Die Umgebungsvariable [`CLAUDE_CODE_SUBAGENT_MODEL`](/de/model-config#environment-variables), wenn gesetzt auf einen Modell-Alias oder eine Modell-ID

3122. Der `model`-Parameter pro Invokation3162. Der `model`-Parameter pro Invokation

3133. Das `model`-Frontmatter der Subagenten-Definition3173. Das `model`-Frontmatter der Subagenten-Definition

3144. Das Modell der Hauptkonversation3184. Das Modell der Hauptkonversation


792 796 

793{/* min-version: 2.1.199 */}Ab v2.1.199 meldet ein Subagent, dessen Ausführung mit einem API-Fehler endet, z. B. ein Nutzungslimit oder ein wiederholter 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 ausgeführt wurde:797{/* min-version: 2.1.199 */}Ab v2.1.199 meldet ein Subagent, dessen Ausführung mit einem API-Fehler endet, z. B. ein Nutzungslimit oder ein wiederholter 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 ausgeführt wurde:

794 798 

795* **Vordergrund**: Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Subagenten unterbricht, der bereits Ausgaben erzeugt hat, gibt das Agent-Werkzeug diese Teilausgabe mit einem Hinweis zurück, dass der Subagent unterbrochen wurde und seine Aufgabe nicht abgeschlossen hat. Andernfalls schlägt der Werkzeugaufruf mit [`Agent terminated early due to an API error`](/de/errors#agent-terminated-early-due-to-an-api-error) fehl, gefolgt von der Fehlerdetail.799* **Vordergrund**: Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Subagenten unterbricht, der bereits Ausgaben erzeugt hat, gibt das Agent-Werkzeug diese Teilausgabe mit einem Hinweis zurück, dass der Subagent unterbrochen wurde und seine Aufgabe nicht abgeschlossen hat. {/* min-version: 2.1.200 */}Ein Subagent, der nichts erzeugt hat, oder dessen einzige Ausgabe Werkzeugaufrufe waren, schlägt mit [`Agent terminated early due to an API error`](/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 mit Werkzeugaufrufen unterbrach, ein leeres Teilergebnis zurück, das nur den Unterbrechungshinweis enthielt.

796* **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 Teilarbeit nicht verloren geht.800* **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 Teilarbeit nicht verloren geht.

797 801 

798Sobald der zugrunde liegende API-Fehler behoben ist, bitten Sie Claude, die Aufgabe zu wiederholen oder [setzen Sie den Subagenten fort](#resume-subagents).802Sobald der zugrunde liegende API-Fehler behoben ist, bitten Sie Claude, die Aufgabe zu wiederholen oder [setzen Sie den Subagenten fort](#resume-subagents).


868 872 

869Ein verschachtelter Subagent wird genauso konfiguriert wie ein Top-Level-Subagent und wird aus denselben [Scopes](#choose-the-subagent-scope) aufgelöst.873Ein verschachtelter Subagent wird genauso konfiguriert wie ein Top-Level-Subagent und wird aus denselben [Scopes](#choose-the-subagent-scope) aufgelöst.

870 874 

875Das Subagenten-Panel unter der Eingabeaufforderung zeigt den vollständigen Baum: Jede Zeile zeigt eine `(+N)`-Anzahl von Nachkommen an, und {/* min-version: 2.1.193 */}ab v2.1.193 zeigt das Öffnen einer Zeile die Geschwister und direkten Kinder dieses Subagenten mit einem Pfad zurück zu `main`.

876 

871Die Tiefe wird als die Anzahl der Subagenten-Ebenen unter der Hauptkonversation gezählt, unabhängig davon, ob jede Ebene im [Vordergrund oder Hintergrund](#run-subagents-in-foreground-or-background) ausgeführt wird. Ein Subagent in Tiefe fünf erhält das Agent-Werkzeug nicht und kann nicht weiter spawnen. Das Limit ist fest und nicht konfigurierbar.877Die Tiefe wird als die Anzahl der Subagenten-Ebenen unter der Hauptkonversation gezählt, unabhängig davon, ob jede Ebene im [Vordergrund oder Hintergrund](#run-subagents-in-foreground-or-background) ausgeführt wird. Ein Subagent in Tiefe fünf erhält das Agent-Werkzeug nicht und kann nicht weiter spawnen. Das Limit ist fest und nicht konfigurierbar.

872 878 

873Ab Claude Code v2.1.187 ist die Tiefe eines Hintergrund-Subagenten festgelegt, wenn er zuerst spawnt wird, und das [Fortsetzen](#resume-subagents) später ändert diese Tiefe nicht. Wenn beispielsweise Ihre Hauptkonversation Subagent A spawnt und A einen Hintergrund-Subagenten B in Tiefe zwei spawnt, ist B immer noch in Tiefe zwei, wenn Sie ihn später direkt aus der Hauptkonversation fortsetzen. Das Fortsetzen eines Subagenten aus einem flacheren Kontext erlaubt ihm nicht, zusätzliche Ebenen zu spawnen, die das Tiefenlimit bereits verhindert hat.879Ab Claude Code v2.1.187 ist die Tiefe eines Hintergrund-Subagenten festgelegt, wenn er zuerst spawnt wird, und das [Fortsetzen](#resume-subagents) später ändert diese Tiefe nicht. Wenn beispielsweise Ihre Hauptkonversation Subagent A spawnt und A einen Hintergrund-Subagenten B in Tiefe zwei spawnt, ist B immer noch in Tiefe zwei, wenn Sie ihn später direkt aus der Hauptkonversation fortsetzen. Das Fortsetzen eines Subagenten aus einem flacheren Kontext erlaubt ihm nicht, zusätzliche Ebenen zu spawnen, die das Tiefenlimit bereits verhindert hat.


922 928 

923Wenn ein gestoppter Subagent eine `SendMessage` erhält, wird er automatisch im Hintergrund fortgesetzt, ohne dass eine neue `Agent`-Invokation erforderlich ist.929Wenn ein gestoppter Subagent eine `SendMessage` erhält, wird er automatisch im Hintergrund fortgesetzt, ohne dass eine neue `Agent`-Invokation erforderlich ist.

924 930 

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

932 

925{/* min-version: 2.1.199 */}Ab 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 gestarteter 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, welchen Agenten der Name jetzt erreicht, damit Claude neu ausrichten kann. Um den früheren Agenten zu erreichen, während er noch läuft, adressiert Claude ihn nach der Agent-ID aus seinem Spawn-Ergebnis. Die Überprüfung ist auf die aktuelle Konversation beschränkt und wird bei `/clear` zurückgesetzt.933{/* min-version: 2.1.199 */}Ab 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 gestarteter 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, welchen Agenten der Name jetzt erreicht, damit Claude neu ausrichten kann. Um den früheren Agenten zu erreichen, während er noch läuft, adressiert Claude ihn nach der Agent-ID aus seinem Spawn-Ergebnis. Die Überprüfung ist auf die aktuelle Konversation beschränkt und wird bei `/clear` zurückgesetzt.

926 934 

927{/* min-version: 2.1.198 */}Ab 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 danach innerhalb seiner eigenen Berechtigungseinstellungen. Zwei Limits gelten immer noch unabhängig davon, wer die Nachricht gesendet hat: Keine Nachricht von einem Agenten zählt als Ihre Genehmigung für eine ausstehende Berechtigungsaufforderung, und keine Agent-Nachricht kann die Berechtigungseinstellungen, `CLAUDE.md` oder Konfiguration eines Subagenten ändern. Nur das Berechtigungssystem oder Ihre eigenen Nachrichten können Genehmigung gewähren.935{/* min-version: 2.1.198 */}Ab 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 danach innerhalb seiner eigenen Berechtigungseinstellungen. Zwei Limits gelten immer noch unabhängig davon, wer die Nachricht gesendet hat: Keine Nachricht von einem Agenten zählt als Ihre Genehmigung für eine ausstehende Berechtigungsaufforderung, und keine Agent-Nachricht kann die Berechtigungseinstellungen, `CLAUDE.md` oder Konfiguration eines Subagenten ändern. Nur das Berechtigungssystem oder Ihre eigenen Nachrichten können Genehmigung gewähren.

Details

102 <th>Anthropic Console</th>102 <th>Anthropic Console</th>

103 <th>Amazon Bedrock</th>103 <th>Amazon Bedrock</th>

104 <th>Claude Platform on AWS</th>104 <th>Claude Platform on AWS</th>

105 <th>Google Vertex AI</th>105 <th>Google Cloud's Agent Platform, ehemals Vertex AI</th>

106 <th>Microsoft Foundry</th>106 <th>Microsoft Foundry</th>

107 </tr>107 </tr>

108 </thead>108 </thead>


196 196 

197* [Claude for Teams oder Enterprise](/de/authentication#claude-for-teams-or-enterprise)197* [Claude for Teams oder Enterprise](/de/authentication#claude-for-teams-or-enterprise)

198* [Anthropic Console](/de/authentication#claude-console-authentication)198* [Anthropic Console](/de/authentication#claude-console-authentication)

199* [Claude Apps Gateway](/de/claude-apps-gateway), ein selbst gehostetes Gateway, das IdP-Anmeldung vor Amazon Bedrock, Claude Platform on AWS, Google Vertex AI, Microsoft Foundry oder der Anthropic API hinzufügt199* [Claude Apps Gateway](/de/claude-apps-gateway), ein selbst gehostetes Gateway, das IdP-Anmeldung vor Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, Microsoft Foundry oder der Anthropic API hinzufügt

200* [Amazon Bedrock](/de/amazon-bedrock)200* [Amazon Bedrock](/de/amazon-bedrock)

201* [Claude Platform on AWS](/de/claude-platform-on-aws)201* [Claude Platform on AWS](/de/claude-platform-on-aws)

202* [Google Vertex AI](/de/google-vertex-ai)202* [Google Cloud's Agent Platform](/de/google-vertex-ai)

203* [Microsoft Foundry](/de/microsoft-foundry)203* [Microsoft Foundry](/de/microsoft-foundry)

204 204 

205<h2 id="configure-proxies-and-gateways">205<h2 id="configure-proxies-and-gateways">


219 219 

220<Tabs>220<Tabs>

221 <Tab title="Unternehmens-Proxy">221 <Tab title="Unternehmens-Proxy">

222 Leiten Sie Bedrock-Datenverkehr über Ihren Unternehmens-Proxy weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:222 Leiten Sie Amazon Bedrock-Datenverkehr über Ihren Unternehmens-Proxy weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:

223 223 

224 ```bash theme={null}224 ```bash theme={null}

225 # Enable Bedrock225 # Enable Bedrock


232 </Tab>232 </Tab>

233 233 

234 <Tab title="LLM-Gateway">234 <Tab title="LLM-Gateway">

235 Leiten Sie Bedrock-Datenverkehr über Ihr LLM-Gateway weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:235 Leiten Sie Amazon Bedrock-Datenverkehr über Ihr LLM-Gateway weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:

236 236 

237 ```bash theme={null}237 ```bash theme={null}

238 # Enable Bedrock238 # Enable Bedrock


251 251 

252<Tabs>252<Tabs>

253 <Tab title="Unternehmens-Proxy">253 <Tab title="Unternehmens-Proxy">

254 Leiten Sie Foundry-Datenverkehr über Ihren Unternehmens-Proxy weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:254 Leiten Sie Microsoft Foundry-Datenverkehr über Ihren Unternehmens-Proxy weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:

255 255 

256 ```bash theme={null}256 ```bash theme={null}

257 # Enable Microsoft Foundry257 # Enable Microsoft Foundry


265 </Tab>265 </Tab>

266 266 

267 <Tab title="LLM-Gateway">267 <Tab title="LLM-Gateway">

268 Leiten Sie Foundry-Datenverkehr über Ihr LLM-Gateway weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:268 Leiten Sie Microsoft Foundry-Datenverkehr über Ihr LLM-Gateway weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:

269 269 

270 ```bash theme={null}270 ```bash theme={null}

271 # Enable Microsoft Foundry271 # Enable Microsoft Foundry


278 </Tab>278 </Tab>

279</Tabs>279</Tabs>

280 280 

281<h3 id="google-vertex-ai">281<h3 id="google-cloud’s-agent-platform">

282 Google Vertex AI282 Google Cloud's Agent Platform

283</h3>283</h3>

284 284 

285<Tabs>285<Tabs>

286 <Tab title="Unternehmens-Proxy">286 <Tab title="Unternehmens-Proxy">

287 Leiten Sie Vertex AI-Datenverkehr über Ihren Unternehmens-Proxy weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:287 Leiten Sie Google Cloud's Agent Platform-Datenverkehr über Ihren Unternehmens-Proxy weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:

288 288 

289 ```bash theme={null}289 ```bash theme={null}

290 # Enable Vertex290 # Enable Agent Platform

291 export CLAUDE_CODE_USE_VERTEX=1291 export CLAUDE_CODE_USE_VERTEX=1

292 export CLOUD_ML_REGION=us-east5292 export CLOUD_ML_REGION=us-east5

293 export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id293 export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id


298 </Tab>298 </Tab>

299 299 

300 <Tab title="LLM-Gateway">300 <Tab title="LLM-Gateway">

301 Leiten Sie Vertex AI-Datenverkehr über Ihr LLM-Gateway weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:301 Leiten Sie Google Cloud's Agent Platform-Datenverkehr über Ihr LLM-Gateway weiter, indem Sie die folgenden [Umgebungsvariablen](/de/env-vars) setzen:

302 302 

303 ```bash theme={null}303 ```bash theme={null}

304 # Enable Vertex304 # Enable Agent Platform

305 export CLAUDE_CODE_USE_VERTEX=1305 export CLAUDE_CODE_USE_VERTEX=1

306 306 

307 # Configure LLM gateway307 # Configure LLM gateway


348 Pinnen Sie Modellversionen für Cloud-Anbieter348 Pinnen Sie Modellversionen für Cloud-Anbieter

349</h3>349</h3>

350 350 

351Wenn Sie über [Bedrock](/de/amazon-bedrock), [Vertex AI](/de/google-vertex-ai), [Foundry](/de/microsoft-foundry) oder [Claude Platform on AWS](/de/claude-platform-on-aws) bereitstellen, pinnen Sie spezifische Modellversionen mit `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` und `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Ohne Pinning werden Modellaliase zu Claude Codes integriertem Standard für diesen Anbieter aufgelöst, was hinter der neuesten Version zurückbleiben kann und möglicherweise noch nicht in Ihrem Konto aktiviert ist. Pinning ermöglicht es Ihnen, zu kontrollieren, wann Ihre Benutzer zu einem neuen Modell wechseln. Siehe [Modellkonfiguration](/de/model-config#pin-models-for-third-party-deployments) für Details zu dem, was jeder Anbieter tut, wenn die Standardversion nicht verfügbar ist.351Wenn Sie über [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry) oder [Claude Platform on AWS](/de/claude-platform-on-aws) bereitstellen, pinnen Sie spezifische Modellversionen mit `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` und `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Ohne Pinning werden Modellaliase zu Claude Codes integriertem Standard für diesen Anbieter aufgelöst, was hinter der neuesten Version zurückbleiben kann und möglicherweise noch nicht in Ihrem Konto aktiviert ist. Pinning ermöglicht es Ihnen, zu kontrollieren, wann Ihre Benutzer zu einem neuen Modell wechseln. Siehe [Modellkonfiguration](/de/model-config#pin-models-for-third-party-deployments) für Details zu dem, was jeder Anbieter tut, wenn die Standardversion nicht verfügbar ist.

352 352 

353<h3 id="configure-security-policies">353<h3 id="configure-security-policies">

354 Konfigurieren Sie Sicherheitsrichtlinien354 Konfigurieren Sie Sicherheitsrichtlinien

tools-reference.md +11 −11

Details

11Um benutzerdefinierte Werkzeuge hinzuzufügen, verbinden Sie einen [MCP-Server](/de/mcp). Um Claude mit wiederverwendbaren Prompt-basierten Workflows zu erweitern, schreiben Sie einen [Skill](/de/skills), der über das vorhandene `Skill`-Werkzeug ausgeführt wird, anstatt einen neuen Werkzeugeintrag hinzuzufügen.11Um benutzerdefinierte Werkzeuge hinzuzufügen, verbinden Sie einen [MCP-Server](/de/mcp). Um Claude mit wiederverwendbaren Prompt-basierten Workflows zu erweitern, schreiben Sie einen [Skill](/de/skills), der über das vorhandene `Skill`-Werkzeug ausgeführt wird, anstatt einen neuen Werkzeugeintrag hinzuzufügen.

12 12 

13| Werkzeug | Beschreibung | Berechtigung erforderlich |13| Werkzeug | Beschreibung | Berechtigung erforderlich |

14| :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------ |14| :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------ |

15| `Agent` | Erzeugt einen [Subagenten](/de/sub-agents) mit eigenem Kontextfenster zur Bewältigung einer Aufgabe. Siehe [Agent-Werkzeugverhalten](#agent-tool-behavior) | Nein |15| `Agent` | Erzeugt einen [Subagenten](/de/sub-agents) mit eigenem Kontextfenster zur Bewältigung einer Aufgabe. Siehe [Agent-Werkzeugverhalten](#agent-tool-behavior) | Nein |

16| `Artifact` | Veröffentlicht eine HTML- oder Markdown-Datei als [Artefakt](/de/artifacts): eine private, interaktive Seite auf claude.ai. In Team- und Enterprise-Plänen können Sie diese in Ihrer Organisation freigeben. {/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Erfordert einen Pro-, Max-, Team- oder Enterprise-Plan und `/login`-Authentifizierung; siehe [Verfügbarkeit](/de/artifacts#availability) | Ja |16| `Artifact` | Veröffentlicht eine HTML- oder Markdown-Datei als [Artefakt](/de/artifacts): eine private, interaktive Seite auf claude.ai. In Team- und Enterprise-Plänen können Sie diese in Ihrer Organisation freigeben. {/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Erfordert einen Pro-, Max-, Team- oder Enterprise-Plan und `/login`-Authentifizierung; siehe [Verfügbarkeit](/de/artifacts#availability) | Ja |

17| `AskUserQuestion` | Stellt Multiple-Choice-Fragen, um Anforderungen zu sammeln oder Mehrdeutigkeiten zu klären. {/* min-version: 2.1.198 */}Ab v2.1.198 schließt sich der Dialog automatisch, wenn Sie nicht innerhalb von 60 Sekunden antworten: Er sendet alle Optionen, die Sie bereits ausgewählt haben, und teilt Claude mit, dass Sie möglicherweise weg von Ihrer Tastatur sind, damit Claude nach eigenem Ermessen fortfährt und später erneut fragen kann. Ein Countdown wird in den letzten 20 Sekunden angezeigt. Jeder Tastendruck hält den Dialog offen, ebenso wie ein fokussiertes Fenster auf Terminals, die Fokus melden. Setzen Sie die Umgebungsvariable [`CLAUDE_AFK_TIMEOUT_MS`](/de/env-vars#variables), um zu ändern, wie lange Claude Code wartet, oder auf einen großen Wert wie `86400000`, 24 Stunden, um Fragen offen zu halten, während Sie weg sind. Dieses Timeout gilt nur für die Multiple-Choice-Fragen von `AskUserQuestion`; Berechtigungsaufforderungen, einschließlich Planbestätigung, werden bei Untätigkeit nie automatisch aufgelöst | Nein |17| `AskUserQuestion` | Stellt Multiple-Choice-Fragen, um Anforderungen zu sammeln oder Mehrdeutigkeiten zu klären. {/* min-version: 2.1.200 */}Fragen bleiben offen, bis Sie sie beantworten: Es gibt standardmäßig kein Idle-Timeout. Um einen Idle-Dialog stattdessen automatisch fortzusetzen, setzen Sie die Einstellung [`askUserQuestionTimeout`](/de/settings#available-settings) auf `60s`, `5m` oder `10m`, entweder in Ihrer Benutzer-`settings.json` oder in der Zeile **Question auto-continue timeout** in `/config`. Sobald die gewählte Idle-Zeit ohne Eingabe verstrichen ist, schließt sich der Dialog von selbst: Er sendet alle Optionen, die Sie bereits ausgewählt haben, und teilt Claude mit, dass Sie möglicherweise weg von Ihrer Tastatur sind, damit Claude nach eigenem Ermessen fortfährt und später erneut fragen kann. Ein Countdown wird in den letzten 20 Sekunden angezeigt. Jeder Tastendruck setzt den Timer zurück, ebenso wie ein fokussiertes Fenster auf Terminals, die Fokus melden. Das Timeout gilt nur für die Multiple-Choice-Fragen von `AskUserQuestion`; Berechtigungsaufforderungen, einschließlich Planbestätigung, werden bei Untätigkeit nie automatisch aufgelöst. In v2.1.198 und v2.1.199 wurde der Dialog standardmäßig nach 60 Sekunden Untätigkeit automatisch fortgesetzt, und [`CLAUDE_AFK_TIMEOUT_MS`](/de/env-vars#variables) war die einzige Möglichkeit, dies zu ändern | Nein |

18| `Bash` | Führt Shell-Befehle in Ihrer Umgebung aus. Siehe [Bash-Werkzeugverhalten](#bash-tool-behavior) | Ja |18| `Bash` | Führt Shell-Befehle in Ihrer Umgebung aus. Siehe [Bash-Werkzeugverhalten](#bash-tool-behavior) | Ja |

19| `CronCreate` | Plant eine wiederkehrende oder einmalige Eingabeaufforderung innerhalb der aktuellen Sitzung. Aufgaben sind sitzungsbezogen und werden bei `--resume` oder `--continue` wiederhergestellt, wenn sie nicht abgelaufen sind. Siehe [geplante Aufgaben](/de/scheduled-tasks) | Nein |19| `CronCreate` | Plant eine wiederkehrende oder einmalige Eingabeaufforderung innerhalb der aktuellen Sitzung. Aufgaben sind sitzungsbezogen und werden bei `--resume` oder `--continue` wiederhergestellt, wenn sie nicht abgelaufen sind. Siehe [geplante Aufgaben](/de/scheduled-tasks) | Nein |

20| `CronDelete` | Bricht eine geplante Aufgabe nach ID ab | Nein |20| `CronDelete` | Bricht eine geplante Aufgabe nach ID ab | Nein |

21| `CronList` | Listet alle geplanten Aufgaben in der Sitzung auf | Nein |21| `CronList` | Listet alle geplanten Aufgaben in der Sitzung auf | Nein |

22| `Edit` | Nimmt gezielte Änderungen an bestimmten Dateien vor. Siehe [Edit-Werkzeugverhalten](#edit-tool-behavior) | Ja |22| `Edit` | Nimmt gezielte Änderungen an bestimmten Dateien vor. Siehe [Edit-Werkzeugverhalten](#edit-tool-behavior) | Ja |

23| `EnterPlanMode` | Wechselt in Plan Mode, um einen Ansatz vor dem Codieren zu entwerfen | Nein |23| `EnterPlanMode` | Wechselt in Plan Mode, um einen Ansatz vor dem Codieren zu entwerfen | Nein |

24| `EnterWorktree` | Erstellt einen isolierten [Git Worktree](/de/worktrees) und wechselt hinein. Übergeben Sie einen `path`, um stattdessen in einen vorhandenen Worktree des aktuellen Repositorys zu wechseln, anstatt einen neuen zu erstellen. Aus einer Worktree-Sitzung oder von einem Subagenten mit einem angehefteten Arbeitsverzeichnis wie [`isolation: worktree`](/de/sub-agents#supported-frontmatter-fields) ist nur die `path`-Form verfügbar und das Ziel muss unter `.claude/worktrees/` liegen | Nein |24| `EnterWorktree` | Erstellt einen isolierten [Git Worktree](/de/worktrees) und wechselt hinein. Übergeben Sie einen `path`, um stattdessen in einen vorhandenen Worktree zu wechseln. {/* min-version: 2.1.203 */}Beim ersten Eintritt kann das Ziel ein Worktree des aktuellen Repositorys oder in einem Multi-Repo-Workspace ein darin verschachteltes Repository sein. Vor v2.1.203 wurde ein Worktree eines verschachtelten Repositorys abgelehnt. Aus einer Worktree-Sitzung oder von einem Subagenten mit einem angehefteten Arbeitsverzeichnis wie [`isolation: worktree`](/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 | Nein |

25| `ExitPlanMode` | Präsentiert einen Plan zur Genehmigung und beendet Plan Mode | Ja |25| `ExitPlanMode` | Präsentiert einen Plan zur Genehmigung und beendet Plan Mode | Ja |

26| `ExitWorktree` | Beendet eine Worktree-Sitzung und kehrt zum ursprünglichen Verzeichnis zurück. Nicht für Subagenten verfügbar, die bereits in ihrem eigenen Arbeitsverzeichnis ausgeführt werden, z. B. mit [`isolation: worktree`](/de/sub-agents#supported-frontmatter-fields) | Nein |26| `ExitWorktree` | Beendet eine Worktree-Sitzung und kehrt zum ursprünglichen Verzeichnis zurück. Nicht für Subagenten verfügbar, die bereits in ihrem eigenen Arbeitsverzeichnis ausgeführt werden, z. B. mit [`isolation: worktree`](/de/sub-agents#supported-frontmatter-fields) | Nein |

27| `Glob` | Findet Dateien basierend auf Musterabgleich. Siehe [Glob-Werkzeugverhalten](#glob-tool-behavior) | Nein |27| `Glob` | Findet Dateien basierend auf Musterabgleich. Siehe [Glob-Werkzeugverhalten](#glob-tool-behavior) | Nein |


31| `Monitor` | Führt einen Befehl im Hintergrund aus und gibt jede Ausgabezeile an Claude zurück, damit er auf Protokolleinträge, Dateiänderungen oder abgerufene Status während des Gesprächs reagieren kann. Kann auch einen WebSocket öffnen und jede eingehende Nachricht als Ereignis behandeln. Siehe [Monitor-Werkzeug](#monitor-tool) | Ja |31| `Monitor` | Führt einen Befehl im Hintergrund aus und gibt jede Ausgabezeile an Claude zurück, damit er auf Protokolleinträge, Dateiänderungen oder abgerufene Status während des Gesprächs reagieren kann. Kann auch einen WebSocket öffnen und jede eingehende Nachricht als Ereignis behandeln. Siehe [Monitor-Werkzeug](#monitor-tool) | Ja |

32| `NotebookEdit` | Ändert Jupyter-Notebook-Zellen. Siehe [NotebookEdit-Werkzeugverhalten](#notebookedit-tool-behavior) | Ja |32| `NotebookEdit` | Ändert Jupyter-Notebook-Zellen. Siehe [NotebookEdit-Werkzeugverhalten](#notebookedit-tool-behavior) | Ja |

33| `PowerShell` | Führt PowerShell-Befehle nativ aus. Siehe [PowerShell-Werkzeug](#powershell-tool) für Verfügbarkeit | Ja |33| `PowerShell` | Führt PowerShell-Befehle nativ aus. Siehe [PowerShell-Werkzeug](#powershell-tool) für Verfügbarkeit | Ja |

34| `PushNotification` | Sendet eine Desktop-Benachrichtigung und eine Telefon-Push-Benachrichtigung, wenn [Remote Control](/de/remote-control) verbunden ist, damit eine langfristige Aufgabe oder [geplante Aufgabe](/de/scheduled-tasks) Sie erreichen kann, wenn Sie weg sind. {/* plan-availability: feature=push-notifications providers=anthropic */}Push-Zustellung läuft über von Anthropic gehostete Infrastruktur, auf die von Amazon Bedrock, Google Vertex AI oder Microsoft Foundry nicht zugegriffen werden kann | Nein |34| `PushNotification` | Sendet eine Desktop-Benachrichtigung und eine Telefon-Push-Benachrichtigung, wenn [Remote Control](/de/remote-control) verbunden ist, damit eine langfristige Aufgabe oder [geplante Aufgabe](/de/scheduled-tasks) Sie erreichen kann, wenn Sie weg sind. {/* plan-availability: feature=push-notifications providers=anthropic */}Push-Zustellung läuft über von Anthropic gehostete Infrastruktur, auf die von Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry nicht zugegriffen werden kann | Nein |

35| `Read` | Liest den Inhalt von Dateien. Siehe [Read-Werkzeugverhalten](#read-tool-behavior) | Nein |35| `Read` | Liest den Inhalt von Dateien. Siehe [Read-Werkzeugverhalten](#read-tool-behavior) | Nein |

36| `ReadMcpResourceTool` | Liest eine bestimmte MCP-Ressource nach URI | Nein |36| `ReadMcpResourceTool` | Liest eine bestimmte MCP-Ressource nach URI | Nein |

37| `RemoteTrigger` | Erstellt, aktualisiert, führt aus und listet [Routinen](/de/routines) auf claude.ai auf. Unterstützt den `/schedule`-Befehl. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routinen befinden sich auf claude.ai und erfordern einen Pro-, Max-, Team- oder Enterprise-Plan, daher ist dieses Werkzeug nicht über Amazon Bedrock, Google Vertex AI oder Microsoft Foundry zugänglich | Nein |37| `RemoteTrigger` | Erstellt, aktualisiert, führt aus und listet [Routinen](/de/routines) auf claude.ai auf. Unterstützt den `/schedule`-Befehl. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routinen befinden sich auf claude.ai und erfordern einen Pro-, Max-, Team- oder Enterprise-Plan, daher ist dieses Werkzeug nicht über Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry zugänglich | Nein |

38| `ReportFindings` | Meldet Code-Review-Ergebnisse als strukturierte Liste mit einer Datei, Zusammenfassung und Fehlerfall pro Ergebnis, damit Claude Code sie rendern kann, anstatt sie als Text auszudrucken. Claude ruft es auf, wenn aktive Code-Review-Anweisungen dies vorsehen. {/* min-version: 2.1.196 */}Erfordert Claude Code v2.1.196 oder später. {/* min-version: 2.1.199 */}Ab v2.1.199 kann ein Ergebnis auch einen optionalen `category`-Slug tragen, wie `correctness` oder `test-coverage`, der neben dem Dateispeicherort in der gerenderten Liste angezeigt wird | Nein |38| `ReportFindings` | Meldet Code-Review-Ergebnisse als strukturierte Liste mit einer Datei, Zusammenfassung und Fehlerfall pro Ergebnis, damit Claude Code sie rendern kann, anstatt sie als Text auszudrucken. Claude ruft es auf, wenn aktive Code-Review-Anweisungen dies vorsehen. {/* min-version: 2.1.196 */}Erfordert Claude Code v2.1.196 oder später. {/* min-version: 2.1.199 */}Ab v2.1.199 kann ein Ergebnis auch einen optionalen `category`-Slug tragen, wie `correctness` oder `test-coverage`, der neben dem Dateispeicherort in der gerenderten Liste angezeigt wird | Nein |

39| `ScheduleWakeup` | Plant die nächste Iteration eines [selbstgesteuerten `/loop`](/de/scheduled-tasks#let-claude-choose-the-interval) neu. Claude ruft dies am Ende jeder Iteration auf, um auszuwählen, wann die nächste ausgeführt wird, zwischen einer Minute und einer Stunde später; Sie rufen es nicht direkt auf. Das ausstehende Wakeup wird in `session_crons` in [Stop-Hook-Eingabe](/de/hooks#stop-input) angezeigt. {/* plan-availability: feature=loop-dynamic providers=anthropic */}Nicht verfügbar auf Amazon Bedrock, Google Vertex AI oder Microsoft Foundry, wo ein `/loop`-Prompt ohne Intervall stattdessen nach einem festen Zeitplan ausgeführt wird | Nein |39| `ScheduleWakeup` | Plant die nächste Iteration eines [selbstgesteuerten `/loop`](/de/scheduled-tasks#let-claude-choose-the-interval) neu. Claude ruft dies am Ende jeder Iteration auf, um auszuwählen, wann die nächste ausgeführt wird, zwischen einer Minute und einer Stunde später; Sie rufen es nicht direkt auf. Um die Schleife stattdessen zu beenden, ruft Claude es mit `stop: true` auf, was das ausstehende Wakeup abbricht. {/* min-version: 2.1.202 */}Das Feld `stop` erfordert Claude Code v2.1.202 oder später. Das ausstehende Wakeup wird in `session_crons` in [Stop-Hook-Eingabe](/de/hooks#stop-input) angezeigt. {/* plan-availability: feature=loop-dynamic providers=anthropic */}Nicht verfügbar auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry, wo ein `/loop`-Prompt ohne Intervall stattdessen nach einem festen Zeitplan ausgeführt wird | Nein |

40| `SendMessage` | Sendet eine Nachricht an einen [Agent-Team](/de/agent-teams)-Mitarbeiter oder [setzt einen Subagenten](/de/sub-agents#resume-subagents) nach seiner Agent-ID oder seinem Namen fort. Gestoppte Subagenten werden automatisch im Hintergrund fortgesetzt. Strukturierte Team-Protokoll-Nachrichten erfordern Agent-Teams. Ein Empfänger behandelt eine Nachricht von einem anderen Agenten niemals als Ihre Zustimmung oder Genehmigung. {/* min-version: 2.1.198 */}Ab v2.1.198 behandelt ein Subagent eine Nachricht vom Agent, der ihn gestartet hat, als normale Aufgabenrichtung statt als Peer-Anfrage. {/* min-version: 2.1.199 */}Ab v2.1.199 wird ein Senden an einen Namen, der sich jetzt zu einem anderen Agenten auflöst als früher im Gespräch, abgelehnt statt zugestellt; siehe [Subagenten fortsetzen](/de/sub-agents#resume-subagents) | Nein |40| `SendMessage` | Sendet eine Nachricht an einen [Agent-Team](/de/agent-teams)-Mitarbeiter oder [setzt einen Subagenten](/de/sub-agents#resume-subagents) nach seiner Agent-ID oder seinem Namen fort. Gestoppte Subagenten werden automatisch im Hintergrund fortgesetzt. Strukturierte Team-Protokoll-Nachrichten erfordern Agent-Teams. Ein Empfänger behandelt eine Nachricht von einem anderen Agenten niemals als Ihre Zustimmung oder Genehmigung. {/* min-version: 2.1.198 */}Ab v2.1.198 behandelt ein Subagent eine Nachricht vom Agent, der ihn gestartet hat, als normale Aufgabenrichtung statt als Peer-Anfrage. {/* min-version: 2.1.199 */}Ab v2.1.199 wird ein Senden an einen Namen, der sich jetzt zu einem anderen Agenten auflöst als früher im Gespräch, abgelehnt statt zugestellt; siehe [Subagenten fortsetzen](/de/sub-agents#resume-subagents) | Nein |

41| `SendUserFile` | Sendet Dateien aus der Sitzung an Sie mit einer optionalen Beschriftung, damit ein generierter Bericht, Diagramm, Screenshot oder erstelltes Artefakt Ihr Gerät erreicht, anstatt nur im Transkript erwähnt zu werden. {/* min-version: 2.1.196 */}Ab v2.1.196 steuert die optionale `display`-Eingabe die Präsentation: `render` öffnet die Datei inline im Client, `attach` zeigt nur eine Download-Karte an, und wenn nicht gesetzt, entscheidet der Client nach Dateityp. Verfügbar, wenn ein [Remote Control](/de/remote-control)-Client verbunden ist oder die Sitzung in einer verwalteten Cloud-Umgebung wie [Claude Code im Web](/de/claude-code-on-the-web) ausgeführt wird. Die Zustellung läuft über von Anthropic gehostete Infrastruktur, daher ist das Werkzeug nicht auf Amazon Bedrock, Google Vertex AI oder Microsoft Foundry verfügbar | Nein |41| `SendUserFile` | Sendet Dateien aus der Sitzung an Sie mit einer optionalen Beschriftung, damit ein generierter Bericht, Diagramm, Screenshot oder erstelltes Artefakt Ihr Gerät erreicht, anstatt nur im Transkript erwähnt zu werden. {/* min-version: 2.1.196 */}Ab v2.1.196 steuert die optionale `display`-Eingabe die Präsentation: `render` öffnet die Datei inline im Client, `attach` zeigt nur eine Download-Karte an, und wenn nicht gesetzt, entscheidet der Client nach Dateityp. Verfügbar, wenn ein [Remote Control](/de/remote-control)-Client verbunden ist oder die Sitzung in einer verwalteten Cloud-Umgebung wie [Claude Code im Web](/de/claude-code-on-the-web) ausgeführt wird. Die Zustellung läuft über von Anthropic gehostete Infrastruktur, daher ist das Werkzeug nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar | Nein |

42| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Lädt `ONBOARDING.md` hoch und gibt einen Freigabelink zurück, den Mitarbeiter in Claude Code öffnen können. Wird nach dem Schreiben des Leitfadens von `/team-onboarding` aufgerufen. Verfügbar für claude.ai-Abonnenten mit Pro-, Max-, Team- und Enterprise-Plänen | Ja |42| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Lädt `ONBOARDING.md` hoch und gibt einen Freigabelink zurück, den Mitarbeiter in Claude Code öffnen können. Wird nach dem Schreiben des Leitfadens von `/team-onboarding` aufgerufen. Verfügbar für claude.ai-Abonnenten mit Pro-, Max-, Team- und Enterprise-Plänen | Ja |

43| `Skill` | Führt einen [Skill](/de/skills#control-who-invokes-a-skill) innerhalb des Hauptgesprächs aus | Ja |43| `Skill` | Führt einen [Skill](/de/skills#control-who-invokes-a-skill) innerhalb des Hauptgesprächs aus | Ja |

44| `TaskCreate` | Erstellt eine neue Aufgabe in der Aufgabenliste | Nein |44| `TaskCreate` | Erstellt eine neue Aufgabe in der Aufgabenliste | Nein |

45| `TaskGet` | Ruft vollständige Details für eine bestimmte Aufgabe ab | Nein |45| `TaskGet` | Ruft vollständige Details für eine bestimmte Aufgabe ab | Nein |

46| `TaskList` | Listet alle Aufgaben mit ihrem aktuellen Status auf | Nein |46| `TaskList` | Listet alle Aufgaben mit ihrem aktuellen Status auf | Nein |

47| `TaskOutput` | (Veraltet) Ruft Ausgabe von einer Hintergrundaufgabe ab. Bevorzugen Sie `Read` auf dem Ausgabedateipfad der Aufgabe | Nein |47| `TaskOutput` | Ruft Ausgabe von einer Hintergrundaufgabe ab. Veraltet zugunsten von `Read` auf dem Ausgabedateipfad der Aufgabe. {/* min-version: 2.1.203 */}Wenn keine Aufgabe der ID entspricht, listet der Fehler die laufenden Hintergrund-Agenten nach ID und Beschreibung auf. Vor v2.1.203 benannte der Fehler nur die fehlende ID | Nein |

48| `TaskStop` | Beendet eine laufende Hintergrundaufgabe nach ID. {/* min-version: 2.1.198 */}Ab v2.1.198 akzeptiert es auch einen [Agent-Team-Mitarbeiter](/de/agent-teams) oder einen benannten Hintergrund-Agenten nach Agent-ID oder Name | Nein |48| `TaskStop` | Beendet eine laufende Hintergrundaufgabe nach ID. {/* min-version: 2.1.198 */}Es akzeptiert auch einen [Agent-Team-Mitarbeiter](/de/agent-teams) oder einen benannten Hintergrund-Agenten nach Agent-ID oder Name. Vor v2.1.198 akzeptierte es nur eine Hintergrundaufgaben-ID. {/* min-version: 2.1.203 */}Wenn keine Aufgabe der ID entspricht, listet der Fehler die laufenden Hintergrund-Agenten nach ID und Beschreibung auf, einschließlich Agenten, die ein anderer Agent erzeugt hat. Vor v2.1.203 listete der Fehler laufende Mitarbeiter und benannte Agenten auf, aber nicht Hintergrund-Agenten, die ein anderer Agent erzeugt hat, daher konnten diese nicht identifiziert oder aus dem Hauptgespräch gestoppt werden | Nein |

49| `TaskUpdate` | Aktualisiert Aufgabenstatus, Abhängigkeiten, Details oder löscht Aufgaben | Nein |49| `TaskUpdate` | Aktualisiert Aufgabenstatus, Abhängigkeiten, Details oder löscht Aufgaben | Nein |

50| `TodoWrite` | {/* min-version: 2.1.142 */}Verwaltet die Sitzungs-Aufgabenliste. Standardmäßig ab v2.1.142 deaktiviert zugunsten von `TaskCreate`, `TaskGet`, `TaskList` und `TaskUpdate`. Setzen Sie `CLAUDE_CODE_ENABLE_TASKS=0`, um es erneut zu aktivieren | Nein |50| `TodoWrite` | {/* min-version: 2.1.142 */}Verwaltet die Sitzungs-Aufgabenliste. Standardmäßig ab v2.1.142 deaktiviert zugunsten von `TaskCreate`, `TaskGet`, `TaskList` und `TaskUpdate`. Setzen Sie `CLAUDE_CODE_ENABLE_TASKS=0`, um es erneut zu aktivieren | Nein |

51| `ToolSearch` | Sucht nach verschobenen Werkzeugen und lädt sie, wenn [Tool-Suche](/de/mcp#scale-with-mcp-tool-search) aktiviert ist | Nein |51| `ToolSearch` | Sucht nach verschobenen Werkzeugen und lädt sie, wenn [Tool-Suche](/de/mcp#scale-with-mcp-tool-search) aktiviert ist | Nein |


220 220 

221Wenn Monitor einen Befehl ausführt, verwendet es die gleichen [Berechtigungsregeln wie Bash](/de/permissions#tool-specific-permission-rules), daher gelten `allow`- und `deny`-Muster, die Sie für Bash festgelegt haben, auch hier. Die [WebSocket-Quelle](#websocket-source) hat ihre eigene Genehmigungsaufforderung.221Wenn Monitor einen Befehl ausführt, verwendet es die gleichen [Berechtigungsregeln wie Bash](/de/permissions#tool-specific-permission-rules), daher gelten `allow`- und `deny`-Muster, die Sie für Bash festgelegt haben, auch hier. Die [WebSocket-Quelle](#websocket-source) hat ihre eigene Genehmigungsaufforderung.

222 222 

223Das Werkzeug ist nicht auf Amazon Bedrock, Google Vertex AI oder Microsoft Foundry verfügbar. Es ist auch nicht verfügbar, wenn `DISABLE_TELEMETRY` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` gesetzt ist.223Das Werkzeug ist nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar. Es ist auch nicht verfügbar, wenn `DISABLE_TELEMETRY` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` gesetzt ist.

224 224 

225Plugins können Monitore deklarieren, die automatisch starten, wenn das Plugin aktiv ist, anstatt Claude zu bitten, sie zu starten. Siehe [Plugin-Monitore](/de/plugins-reference#monitors).225Plugins können Monitore deklarieren, die automatisch starten, wenn das Plugin aktiv ist, anstatt Claude zu bitten, sie zu starten. Siehe [Plugin-Monitore](/de/plugins-reference#monitors).

226 226 


371WebSearch-Berechtigungsregeln nehmen keinen Specifier. Ein bloßer `WebSearch`-Eintrag in `allow` oder `deny` ist die einzige Form.371WebSearch-Berechtigungsregeln nehmen keinen Specifier. Ein bloßer `WebSearch`-Eintrag in `allow` oder `deny` ist die einzige Form.

372 372 

373<Note>373<Note>

374 WebSearch ist auf der Claude API, [Claude Platform on AWS](/de/claude-platform-on-aws) und Microsoft Foundry verfügbar. Auf Google Cloud Vertex AI funktioniert es mit Claude 4 und späteren Modellen, einschließlich Opus, Sonnet und Haiku. Amazon Bedrock stellt das serverseitige Web-Such-Werkzeug nicht bereit.374 WebSearch ist auf der Claude API, [Claude Platform on AWS](/de/claude-platform-on-aws) und Microsoft Foundry verfügbar. Auf Google Cloud's Agent Platform funktioniert es mit Claude 4 und späteren Modellen, einschließlich Opus, Sonnet und Haiku. Amazon Bedrock stellt das serverseitige Web-Such-Werkzeug nicht bereit.

375</Note>375</Note>

376 376 

377<h2 id="write-tool-behavior">377<h2 id="write-tool-behavior">

Details

15Ordnen Sie die Fehlermeldung oder das Symptom, das Sie sehen, einer Lösung zu:15Ordnen Sie die Fehlermeldung oder das Symptom, das Sie sehen, einer Lösung zu:

16 16 

17| Was Sie sehen | Lösung |17| Was Sie sehen | Lösung |

18| :------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------- |18| :------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------- |

19| `command not found: claude` oder `'claude' is not recognized` | [Beheben Sie Ihren PATH](#command-not-found-claude-after-installation) |19| `command not found: claude` oder `'claude' is not recognized` | [Beheben Sie Ihren PATH](#command-not-found-claude-after-installation) |

20| `syntax error near unexpected token '<'` | [Installationsskript gibt HTML zurück](#install-script-returns-html-instead-of-a-shell-script) |20| `syntax error near unexpected token '<'` | [Installationsskript gibt HTML zurück](#install-script-returns-html-instead-of-a-shell-script) |

21| `curl: (22) The requested URL returned error: 403` | [Installationsskript hat 403 zurückgegeben](#install-script-returns-html-instead-of-a-shell-script) |21| `curl: (22) The requested URL returned error: 403` | [Installationsskript hat 403 zurückgegeben](#install-script-returns-html-instead-of-a-shell-script) |

22| `curl: (23)` oder `curl: (56) Failure writing output to destination` | [Überprüfen Sie die Konnektivität oder verwenden Sie ein alternatives Installationsprogramm](#curl-56-failure-writing-output-to-destination) |22| `curl: (23)` oder `curl: (56) Failure writing output to destination` | [Überprüfen Sie die Konnektivität oder verwenden Sie ein alternatives Installationsprogramm](#curl-56-failure-writing-output-to-destination) |

23| `Killed` während der Installation unter Linux | [Fügen Sie Swap-Speicher für Server mit wenig Speicher hinzu](#install-killed-on-low-memory-linux-servers) |23| `Killed` während der Installation unter Linux oder `Installation was killed before it could finish (exit code 137)` | [Geben Sie Speicher frei oder fügen Sie Swap-Speicher hinzu](#install-killed-on-low-memory-linux-servers) |

24| `TLS connect error` oder `SSL/TLS secure channel` | [Aktualisieren Sie CA-Zertifikate](#tls-or-ssl-connection-errors) |24| `TLS connect error` oder `SSL/TLS secure channel` | [Aktualisieren Sie CA-Zertifikate](#tls-or-ssl-connection-errors) |

25| `Failed to fetch version` oder kann den Download-Server nicht erreichen | [Überprüfen Sie Netzwerk- und Proxy-Einstellungen](#check-network-connectivity) |25| `Failed to fetch version` oder kann den Download-Server nicht erreichen | [Überprüfen Sie Netzwerk- und Proxy-Einstellungen](#check-network-connectivity) |

26| `irm is not recognized` oder `&& is not valid` | [Verwenden Sie den richtigen Befehl für Ihre Shell](#wrong-install-command-on-windows) |26| `irm is not recognized` oder `&& is not valid` | [Verwenden Sie den richtigen Befehl für Ihre Shell](#wrong-install-command-on-windows) |


39| `App unavailable in region` | Claude Code ist in Ihrem Land nicht verfügbar. Siehe [unterstützte Länder](https://www.anthropic.com/supported-countries). |39| `App unavailable in region` | Claude Code ist in Ihrem Land nicht verfügbar. Siehe [unterstützte Länder](https://www.anthropic.com/supported-countries). |

40| `unable to get local issuer certificate` | [Konfigurieren Sie Unternehmens-CA-Zertifikate](#tls-or-ssl-connection-errors) |40| `unable to get local issuer certificate` | [Konfigurieren Sie Unternehmens-CA-Zertifikate](#tls-or-ssl-connection-errors) |

41| `OAuth error` oder `403 Forbidden` | [Beheben Sie die Authentifizierung](#login-and-authentication) |41| `OAuth error` oder `403 Forbidden` | [Beheben Sie die Authentifizierung](#login-and-authentication) |

42| `Could not load the default credentials` oder `Could not load credentials from any providers` | [Bedrock-, Vertex- oder Foundry-Anmeldedaten](#bedrock-vertex-or-foundry-credentials-not-loading) |42| `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) |

43| `ChainedTokenCredential authentication failed` oder `CredentialUnavailableError` | [Bedrock-, Vertex- oder Foundry-Anmeldedaten](#bedrock-vertex-or-foundry-credentials-not-loading) |43| `ChainedTokenCredential authentication failed` oder `CredentialUnavailableError` | [Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Anmeldedaten](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

44| `API Error: 500`, `529 Overloaded`, `429` oder andere 4xx und 5xx Fehler, die oben nicht aufgeführt sind | Siehe die [Fehlerreferenz](/de/errors) |44| `API Error: 500`, `529 Overloaded`, `429` oder andere 4xx und 5xx Fehler, die oben nicht aufgeführt sind | Siehe die [Fehlerreferenz](/de/errors) |

45 45 

46Wenn Ihr Problem nicht aufgeführt ist, führen Sie die Diagnoseprüfungen unten durch, um die Ursache einzugrenzen.46Wenn Ihr Problem nicht aufgeführt ist, führen Sie die Diagnoseprüfungen unten durch, um die Ursache einzugrenzen.


538 Installation auf Linux-Servern mit wenig Speicher beendet538 Installation auf Linux-Servern mit wenig Speicher beendet

539</h3>539</h3>

540 540 

541Wenn Sie während der Installation auf einem VPS oder einer Cloud-Instanz `Killed` sehen:541Eine `Killed` Meldung während der Installation bedeutet normalerweise, dass der Linux Out-of-Memory (OOM) Killer den `claude install` Schritt beendet hat, weil dem System der Speicher ausgegangen ist. Dies ist häufig auf kleinen VPS und Cloud-Instanzen der Fall. Das Installationsskript meldet die Ursache und beendet sich mit Exit-Code 137:

542 542 

543```text theme={null}543```text theme={null}

544Setting up Claude Code...544Setting up Claude Code...

545Installing Claude Code native build latest...

546bash: line 142: 34803 Killed "$binary_path" install ${TARGET:+"$TARGET"}545bash: line 142: 34803 Killed "$binary_path" install ${TARGET:+"$TARGET"}

546Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

547Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

547```548```

548 549 

549Der Linux OOM-Killer hat den Prozess beendet, weil dem System der Speicher ausgegangen ist. Claude Code benötigt mindestens 4 GB verfügbaren RAM.550Vor v2.1.200 beendete sich das Skript nur mit der bloßen `Killed` Zeile der Shell und ohne Erklärung.

551 

552Die Installation benötigt ungefähr 512 MB freien Speicher, und das Ausführen von Claude Code benötigt mehr. Siehe die [Systemanforderungen](/de/setup#system-requirements).

550 553 

551**Lösungen:**554**Lösungen:**

552 555 


781Das `@anthropic-ai/claude-code` npm-Paket zieht die native Binärdatei durch eine pro-Plattform optionale Abhängigkeit wie `@anthropic-ai/claude-code-darwin-arm64` ein. Wenn das Ausführen von `claude` nach der Installation `Could not find native binary package "@anthropic-ai/claude-code-<platform>"` ausgibt, überprüfen Sie die folgenden Ursachen:784Das `@anthropic-ai/claude-code` npm-Paket zieht die native Binärdatei durch eine pro-Plattform optionale Abhängigkeit wie `@anthropic-ai/claude-code-darwin-arm64` ein. Wenn das Ausführen von `claude` nach der Installation `Could not find native binary package "@anthropic-ai/claude-code-<platform>"` ausgibt, überprüfen Sie die folgenden Ursachen:

782 785 

783* **Optionale Abhängigkeiten sind deaktiviert.** Entfernen Sie `--omit=optional` aus Ihrem npm-Installationsbefehl, `--no-optional` von pnpm oder `--ignore-optional` von yarn, und überprüfen Sie, dass `.npmrc` nicht `optional=false` setzt. Dann installieren Sie erneut. Die native Binärdatei wird nur als optionale Abhängigkeit bereitgestellt, daher gibt es keinen JavaScript-Fallback, wenn sie übersprungen wird.786* **Optionale Abhängigkeiten sind deaktiviert.** Entfernen Sie `--omit=optional` aus Ihrem npm-Installationsbefehl, `--no-optional` von pnpm oder `--ignore-optional` von yarn, und überprüfen Sie, dass `.npmrc` nicht `optional=false` setzt. Dann installieren Sie erneut. Die native Binärdatei wird nur als optionale Abhängigkeit bereitgestellt, daher gibt es keinen JavaScript-Fallback, wenn sie übersprungen wird.

784* **Nicht unterstützte Plattform.** Vorkompilierte Binärdateien werden für `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` und `win32-arm64` veröffentlicht. Claude Code liefert keine Binärdatei für andere Plattformen; siehe die [Systemanforderungen](/de/setup#system-requirements).787* **Nicht unterstützte Plattform.** Vorkompilierte Binärdateien werden für `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` und `win32-arm64` veröffentlicht. Claude Code liefert keine Binärdatei für andere Plattformen; siehe die [Systemanforderungen](/de/setup#system-requirements). {/* min-version: 2.1.205 */}Auf FreeBSD meldet das Installationsprogramm die Plattform als nicht unterstützt. Vor v2.1.205 behandelte es FreeBSD als Linux und lud eine Binärdatei herunter, die nicht ausgeführt werden konnte.

785* **Unternehmens-npm-Spiegel fehlen die Plattform-Pakete.** Stellen Sie sicher, dass Ihr Registry alle acht `@anthropic-ai/claude-code-*` Plattform-Pakete zusätzlich zum Meta-Paket spiegelt.788* **Unternehmens-npm-Spiegel fehlen die Plattform-Pakete.** Stellen Sie sicher, dass Ihr Registry alle acht `@anthropic-ai/claude-code-*` Plattform-Pakete zusätzlich zum Meta-Paket spiegelt.

786 789 

787Die Installation mit `--ignore-scripts` löst diesen Fehler nicht aus. Der Postinstall-Schritt, der die Binärdatei verknüpft, wird übersprungen, daher fällt Claude Code auf einen Wrapper zurück, der die Plattform-Binärdatei bei jedem Start findet und startet. Dies funktioniert, aber startet langsamer; installieren Sie mit aktivierten Skripten für direkte Ausführung erneut.790Die Installation mit `--ignore-scripts` löst diesen Fehler nicht aus. Der Postinstall-Schritt, der die Binärdatei verknüpft, wird übersprungen, daher fällt Claude Code auf einen Wrapper zurück, der die Plattform-Binärdatei bei jedem Start findet und startet. Dies funktioniert, aber startet langsamer; installieren Sie mit aktivierten Skripten für direkte Ausführung erneut.


876 879 

877Auf macOS kann die Anmeldung auch fehlschlagen, wenn der Keychain gesperrt ist oder sein Passwort nicht mit Ihrem Kontopasswort synchronisiert ist, was Claude Code daran hindert, Anmeldedaten zu speichern. Führen Sie `claude doctor` aus, um den Keychain-Zugriff zu überprüfen. Um den Keychain manuell zu entsperren, führen Sie `security unlock-keychain ~/Library/Keychains/login.keychain-db` aus. Wenn das Entsperren nicht hilft, öffnen Sie Keychain Access, wählen Sie den `login` Keychain und wählen Sie Bearbeiten > Passwort für Keychain „login" ändern, um es mit Ihrem Kontopasswort zu resynchronisieren.880Auf macOS kann die Anmeldung auch fehlschlagen, wenn der Keychain gesperrt ist oder sein Passwort nicht mit Ihrem Kontopasswort synchronisiert ist, was Claude Code daran hindert, Anmeldedaten zu speichern. Führen Sie `claude doctor` aus, um den Keychain-Zugriff zu überprüfen. Um den Keychain manuell zu entsperren, führen Sie `security unlock-keychain ~/Library/Keychains/login.keychain-db` aus. Wenn das Entsperren nicht hilft, öffnen Sie Keychain Access, wählen Sie den `login` Keychain und wählen Sie Bearbeiten > Passwort für Keychain „login" ändern, um es mit Ihrem Kontopasswort zu resynchronisieren.

878 881 

879<h3 id="bedrock-vertex-or-foundry-credentials-not-loading">882<h3 id="bedrock-agent-platform-or-foundry-credentials-not-loading">

880 Bedrock-, Vertex- oder Foundry-Anmeldedaten werden nicht geladen883 Bedrock-, Agent Platform- oder Foundry-Anmeldedaten werden nicht geladen

881</h3>884</h3>

882 885 

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

884 887 

885Für Bedrock bestätigen Sie, dass Ihre AWS-Anmeldedaten gültig sind:888Für Amazon Bedrock bestätigen Sie, dass Ihre AWS-Anmeldedaten gültig sind:

886 889 

887```bash theme={null}890```bash theme={null}

888aws sts get-caller-identity891aws sts get-caller-identity

889```892```

890 893 

891Für Vertex AI bestätigen Sie, dass `ANTHROPIC_VERTEX_PROJECT_ID` und `CLOUD_ML_REGION` in Ihrer Shell gesetzt sind, dann setzen Sie Anwendungs-Standard-Anmeldedaten:894Für Google Cloud's Agent Platform bestätigen Sie, dass `ANTHROPIC_VERTEX_PROJECT_ID` und `CLOUD_ML_REGION` in Ihrer Shell gesetzt sind, dann setzen Sie Anwendungs-Standard-Anmeldedaten:

892 895 

893```bash theme={null}896```bash theme={null}

894gcloud auth application-default login897gcloud auth application-default login


902 905 

903Wenn Anmeldedaten in Ihrem Terminal funktionieren, aber nicht in der VS Code oder JetBrains-Erweiterung, hat der IDE-Prozess wahrscheinlich Ihre Shell-Umgebung nicht geerbt. Setzen Sie die Anbieter-Umgebungsvariablen in den IDE-eigenen Einstellungen, oder starten Sie die IDE von einem Terminal aus, in dem sie bereits exportiert sind.906Wenn Anmeldedaten in Ihrem Terminal funktionieren, aber nicht in der VS Code oder JetBrains-Erweiterung, hat der IDE-Prozess wahrscheinlich Ihre Shell-Umgebung nicht geerbt. Setzen Sie die Anbieter-Umgebungsvariablen in den IDE-eigenen Einstellungen, oder starten Sie die IDE von einem Terminal aus, in dem sie bereits exportiert sind.

904 907 

905Siehe [Amazon Bedrock](/de/amazon-bedrock), [Google Vertex AI](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) für die vollständige Anbieter-Einrichtung.908Siehe [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) für die vollständige Anbieter-Einrichtung.

906 909 

907<h2 id="still-stuck">910<h2 id="still-stuck">

908 Immer noch festgefahren911 Immer noch festgefahren

Details

9Diese Seite behandelt Leistungs-, Stabilitäts- und Suchprobleme, sobald Claude Code läuft. Für andere Probleme beginnen Sie mit der Seite, die zu Ihrer Situation passt:9Diese Seite behandelt Leistungs-, Stabilitäts- und Suchprobleme, sobald Claude Code läuft. Für andere Probleme beginnen Sie mit der Seite, die zu Ihrer Situation passt:

10 10 

11| Symptom | Gehen Sie zu |11| Symptom | Gehen Sie zu |

12| :--------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |12| :------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |

13| `command not found`, Installation schlägt fehl, PATH-Probleme, `EACCES`, TLS-Fehler | [Fehlerbehebung bei Installation und Anmeldung](/de/troubleshoot-install) |13| `command not found`, Installation schlägt fehl, PATH-Probleme, `EACCES`, TLS-Fehler | [Fehlerbehebung bei Installation und Anmeldung](/de/troubleshoot-install) |

14| Anmeldeschleifen, OAuth-Fehler, `403 Forbidden`, „Organisation deaktiviert", Bedrock/Vertex/Foundry-Anmeldedaten | [Fehlerbehebung bei Installation und Anmeldung](/de/troubleshoot-install#login-and-authentication) |14| Update oder Installation schlägt fehl mit `The connection dropped while downloading the update` oder `aborted` | [Fehlerreferenz](/de/errors#the-connection-dropped-while-downloading-the-update) |

15| Anmeldeschleifen, OAuth-Fehler, `403 Forbidden`, „Organisation deaktiviert", Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry-Anmeldedaten | [Fehlerbehebung bei Installation und Anmeldung](/de/troubleshoot-install#login-and-authentication) |

15| Einstellungen werden nicht angewendet, Hooks werden nicht ausgelöst, MCP-Server werden nicht geladen | [Debuggen Sie Ihre Konfiguration](/de/debug-your-config) |16| Einstellungen werden nicht angewendet, Hooks werden nicht ausgelöst, MCP-Server werden nicht geladen | [Debuggen Sie Ihre Konfiguration](/de/debug-your-config) |

16| `API Error: 5xx`, `529 Overloaded`, `429`, Request-Validierungsfehler | [Fehlerreferenz](/de/errors) |17| `API Error: 5xx`, `529 Overloaded`, `429`, Request-Validierungsfehler | [Fehlerreferenz](/de/errors) |

17| `model not found` oder `you may not have access to it` | [Fehlerreferenz](/de/errors#there%E2%80%99s-an-issue-with-the-selected-model) |18| `model not found` oder `you may not have access to it` | [Fehlerreferenz](/de/errors#there%E2%80%99s-an-issue-with-the-selected-model) |


19| JetBrains-Plugin oder IDE wird nicht erkannt | [JetBrains-Integration](/de/jetbrains#troubleshooting) |20| JetBrains-Plugin oder IDE wird nicht erkannt | [JetBrains-Integration](/de/jetbrains#troubleshooting) |

20| Hohe CPU oder Speicher, langsame Antworten, Hänger, Suche findet Dateien nicht | [Leistung und Stabilität](#performance-and-stability) unten |21| Hohe CPU oder Speicher, langsame Antworten, Hänger, Suche findet Dateien nicht | [Leistung und Stabilität](#performance-and-stability) unten |

21 22 

22Wenn Sie sich nicht sicher sind, welcher Fall zutrifft, führen Sie `/doctor` in Claude Code aus, um eine automatisierte Überprüfung Ihrer Installation, Einstellungen, MCP-Server und Kontextnutzung durchzuführen. Wenn `claude` überhaupt nicht startet, führen Sie stattdessen `claude doctor` aus Ihrer Shell aus.23Wenn Sie sich nicht sicher sind, welcher Fall zutrifft, führen Sie `/doctor` in Claude Code aus, um eine automatisierte Überprüfung Ihrer Installation, Einstellungen, Erweiterungen und Kontextnutzung durchzuführen; es schlägt Korrektionen vor, die es nach Ihrer Bestätigung anwenden kann. Wenn `claude` überhaupt nicht startet, führen Sie stattdessen `claude doctor` aus Ihrer Shell aus. Führen Sie `/mcp` aus, um den MCP-Server-Status zu überprüfen.

23 24 

24<h2 id="performance-and-stability">25<h2 id="performance-and-stability">

25 Leistung und Stabilität26 Leistung und Stabilität


119Leistungseinbußen beim Lesen von Festplatten beim [Arbeiten über Dateisysteme auf WSL](https://learn.microsoft.com/en-us/windows/wsl/filesystems) können zu weniger als erwarteten Übereinstimmungen führen, wenn Sie Claude Code auf WSL verwenden. Die Suche funktioniert immer noch, gibt aber weniger Ergebnisse zurück als auf einem nativen Dateisystem.120Leistungseinbußen beim Lesen von Festplatten beim [Arbeiten über Dateisysteme auf WSL](https://learn.microsoft.com/en-us/windows/wsl/filesystems) können zu weniger als erwarteten Übereinstimmungen führen, wenn Sie Claude Code auf WSL verwenden. Die Suche funktioniert immer noch, gibt aber weniger Ergebnisse zurück als auf einem nativen Dateisystem.

120 121 

121<Note>122<Note>

122 `/doctor` zeigt in diesem Fall die Suche als OK an.123 `claude doctor` zeigt in diesem Fall die Suche als OK an.

123</Note>124</Note>

124 125 

125**Lösungen:**126**Lösungen:**

126 127 

1271. **Senden Sie spezifischere Suchen**: Reduzieren Sie die Anzahl der durchsuchten Dateien, indem Sie Verzeichnisse oder Dateitypen angeben: 'Search for JWT validation logic in the auth-service package" oder „Find use of md5 hash in JS files".1281. **Senden Sie spezifischere Suchen**: Reduzieren Sie die Anzahl der durchsuchten Dateien, indem Sie Verzeichnisse oder Dateitypen angeben: Search for JWT validation logic in the auth-service package" oder „Find use of md5 hash in JS files".

128 129 

1292. **Verschieben Sie das Projekt auf das Linux-Dateisystem**: Stellen Sie sicher, dass sich Ihr Projekt auf dem Linux-Dateisystem (`/home/`) statt auf dem Windows-Dateisystem (`/mnt/c/`) befindet.1302. **Verschieben Sie das Projekt auf das Linux-Dateisystem**: Stellen Sie sicher, dass sich Ihr Projekt auf dem Linux-Dateisystem (`/home/`) statt auf dem Windows-Dateisystem (`/mnt/c/`) befindet.

130 131 


136 137 

137Wenn Sie Probleme haben, die hier nicht behandelt werden:138Wenn Sie Probleme haben, die hier nicht behandelt werden:

138 139 

1391. Führen Sie `/doctor` aus, um Installationsintegrität, Einstellungsgültigkeit, MCP-Konfiguration und Kontextnutzung in einem Durchgang zu überprüfen1401. Führen Sie `/doctor` aus, um eine Installationsprüfung durchzuführen, und `/mcp`, um den MCP-Serverstatus zu überprüfen

1402. Verwenden Sie den `/feedback`-Befehl in Claude Code, um Probleme direkt an Anthropic zu melden1412. Verwenden Sie den `/feedback`-Befehl in Claude Code, um Probleme direkt an Anthropic zu melden

1413. Überprüfen Sie das [GitHub-Repository](https://github.com/anthropics/claude-code) auf bekannte Probleme1423. Überprüfen Sie das [GitHub-Repository](https://github.com/anthropics/claude-code) auf bekannte Probleme

1424. Fragen Sie Claude direkt nach seinen Fähigkeiten und Funktionen. Claude hat integrierten Zugriff auf seine Dokumentation.1434. Fragen Sie Claude direkt nach seinen Fähigkeiten und Funktionen. Claude hat integrierten Zugriff auf seine Dokumentation.

ultraplan.md +1 −1

Details

18* **Freihändiger Entwurf**: Der Plan wird remote generiert, sodass Ihr Terminal für andere Arbeiten frei bleibt18* **Freihändiger Entwurf**: Der Plan wird remote generiert, sodass Ihr Terminal für andere Arbeiten frei bleibt

19* **Flexible Ausführung**: Genehmigen Sie den Plan zur Ausführung im Web und öffnen Sie einen Pull Request, oder senden Sie ihn zurück an Ihr Terminal19* **Flexible Ausführung**: Genehmigen Sie den Plan zur Ausführung im Web und öffnen Sie einen Pull Request, oder senden Sie ihn zurück an Ihr Terminal

20 20 

21Ultraplan erfordert ein [Claude Code im Web](/de/claude-code-on-the-web)-Konto und ein GitHub-Repository. Da es auf der Cloud-Infrastruktur von Anthropic ausgeführt wird, ist es nicht verfügbar, wenn Sie Amazon Bedrock, Google Cloud Vertex AI oder Microsoft Foundry verwenden. Die Cloud-Sitzung wird in der Standard-[Cloud-Umgebung](/de/claude-code-on-the-web#the-cloud-environment) Ihres Kontos ausgeführt. Wenn Sie noch keine Cloud-Umgebung haben, erstellt Ultraplan beim ersten Start automatisch eine.21Ultraplan erfordert ein [Claude Code im Web](/de/claude-code-on-the-web)-Konto und ein GitHub-Repository. Da es auf der Cloud-Infrastruktur von Anthropic ausgeführt wird, ist es nicht verfügbar, wenn Sie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verwenden. Die Cloud-Sitzung wird in der Standard-[Cloud-Umgebung](/de/claude-code-on-the-web#the-cloud-environment) Ihres Kontos ausgeführt. Wenn Sie noch keine Cloud-Umgebung haben, erstellt Ultraplan beim ersten Start automatisch eine.

22 22 

23<h2 id="launch-ultraplan-from-the-cli">23<h2 id="launch-ultraplan-from-the-cli">

24 Ultraplan von der CLI aus starten24 Ultraplan von der CLI aus starten

ultrareview.md +4 −4

Details

15Im Vergleich zu einer lokalen `/code-review` oder `/review` bietet Ultrareview:15Im Vergleich zu einer lokalen `/code-review` oder `/review` bietet Ultrareview:

16 16 

17* **Höhere Signalqualität**: Jeder gemeldete Fund wird unabhängig reproduziert und verifiziert, sodass sich die Ergebnisse auf echte Bugs konzentrieren und nicht auf Stilvorschläge17* **Höhere Signalqualität**: Jeder gemeldete Fund wird unabhängig reproduziert und verifiziert, sodass sich die Ergebnisse auf echte Bugs konzentrieren und nicht auf Stilvorschläge

18* **Breitere Abdeckung**: Eine größere Flotte von Reviewer-Agenten erkundet die Änderung parallel, was Probleme aufdeckt, die eine mittlere lokale Review übersehen könnte18* **Breitere Abdeckung**: Eine größere Flotte von Reviewer-Agenten erkundet die Änderung parallel, was Probleme aufdeckt, die eine lokale Review übersehen könnte

19* **Keine lokale Ressourcennutzung**: Die Review läuft vollständig in einer Remote-Sandbox, sodass Ihr Terminal für andere Arbeiten frei bleibt, während sie läuft19* **Keine lokale Ressourcennutzung**: Die Review läuft vollständig in einer Remote-Sandbox, sodass Ihr Terminal für andere Arbeiten frei bleibt, während sie läuft

20 20 

21Ultrareview erfordert eine Authentifizierung mit einem Claude.ai-Konto, da es auf Claude Code in der Web-Infrastruktur ausgeführt wird. Wenn Sie nur mit einem API-Schlüssel angemeldet sind, führen Sie `/login` aus und authentifizieren Sie sich zuerst mit Claude.ai. Ultrareview ist nicht verfügbar, wenn Sie Claude Code mit Amazon Bedrock, Google Cloud Vertex AI oder Microsoft Foundry verwenden, und es ist nicht für Organisationen verfügbar, die Zero Data Retention aktiviert haben.21Ultrareview erfordert eine Authentifizierung mit einem Claude.ai-Konto, da es auf Claude Code in der Web-Infrastruktur ausgeführt wird. Wenn Sie nur mit einem API-Schlüssel angemeldet sind, führen Sie `/login` aus und authentifizieren Sie sich zuerst mit Claude.ai. Ultrareview ist nicht verfügbar, wenn Sie Claude Code mit Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verwenden, und es ist nicht für Organisationen verfügbar, die Zero Data Retention aktiviert haben.

22 22 

23<h2 id="run-ultrareview-from-the-cli">23<h2 id="run-ultrareview-from-the-cli">

24 Ultrareview von der CLI ausführen24 Ultrareview von der CLI ausführen


107| ------------- | ---------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |107| ------------- | ---------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |

108| Ziel | Ihr Working Diff | einen GitHub Pull Request | Ihr Working Diff oder einen Pull Request |108| Ziel | Ihr Working Diff | einen GitHub Pull Request | Ihr Working Diff oder einen Pull Request |

109| Läuft | lokal in Ihrer Sitzung | lokal in Ihrer Sitzung | remote in einer Cloud-Sandbox |109| Läuft | lokal in Ihrer Sitzung | lokal in Ihrer Sitzung | remote in einer Cloud-Sandbox |

110| Tiefe | skaliert mit dem Effort-Argument | die mittlere `/code-review`-Engine | Multi-Agent-Flotte mit unabhängiger Verifizierung |110| Tiefe | skaliert mit dem Effort-Argument | eine einzelne Review auf dem Effort der Sitzung | Multi-Agent-Flotte mit unabhängiger Verifizierung |

111| Dauer | Sekunden bis wenige Minuten | wenige Minuten | ungefähr 5 bis 10 Minuten |111| Dauer | Sekunden bis wenige Minuten | Sekunden bis wenige Minuten | ungefähr 5 bis 10 Minuten |

112| Kosten | zählt zur normalen Nutzung | zählt zur normalen Nutzung | kostenlose Durchläufe, dann ungefähr 5 bis 20 Dollar pro Review als Nutzungsguthaben |112| Kosten | zählt zur normalen Nutzung | zählt zur normalen Nutzung | kostenlose Durchläufe, dann ungefähr 5 bis 20 Dollar pro Review als Nutzungsguthaben |

113| Am besten für | schnelles Feedback während der Iteration | Überprüfung eines Pull Requests eines Teamkollegen vor der Genehmigung | Pre-Merge-Sicherheit bei wesentlichen Änderungen |113| Am besten für | schnelles Feedback während der Iteration | Überprüfung eines Pull Requests eines Teamkollegen vor der Genehmigung | Pre-Merge-Sicherheit bei wesentlichen Änderungen |

114 114 

Details

20 20 

21Die Spracherfassung streamt Ihre aufgenommene Audiodatei an Anthropic-Server zur Transkription. Audio wird nicht lokal verarbeitet. Dies erfordert alle folgenden Voraussetzungen:21Die Spracherfassung streamt Ihre aufgenommene Audiodatei an Anthropic-Server zur Transkription. Audio wird nicht lokal verarbeitet. Dies erfordert alle folgenden Voraussetzungen:

22 22 

23* **Ein Claude.ai-Konto**: Der Sprache-zu-Text-Dienst ist nur verfügbar, wenn Sie sich mit einem authentifizieren, und ist nicht verfügbar, wenn Claude Code für die Verwendung eines Anthropic API-Schlüssels direkt, Amazon Bedrock, Google Vertex AI oder Microsoft Foundry konfiguriert ist.23* **Ein Claude.ai-Konto**: Der Sprache-zu-Text-Dienst ist nur verfügbar, wenn Sie sich mit einem authentifizieren, und ist nicht verfügbar, wenn Claude Code für die Verwendung eines Anthropic API-Schlüssels direkt, Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry konfiguriert ist.

24* **Eine Organisation ohne aktivierte HIPAA-Compliance**: `/voice` zeigt `Voice mode is disabled by your organization's policy` an, wenn diese Einschränkung gilt.24* **Eine Organisation ohne aktivierte HIPAA-Compliance**: `/voice` zeigt `Voice mode is disabled by your organization's policy` an, wenn diese Einschränkung gilt.

25* **Ein lokales Mikrofon**: Die Spracherfassung funktioniert nicht in Remote-Umgebungen wie [Claude Code im Web](/de/claude-code-on-the-web) oder SSH-Sitzungen.25* **Ein lokales Mikrofon**: Die Spracherfassung funktioniert nicht in Remote-Umgebungen wie [Claude Code im Web](/de/claude-code-on-the-web) oder SSH-Sitzungen.

26* **WSLg, wenn Sie Claude Code in WSL ausführen**: WSLg ist in WSL2 enthalten, wenn es unter Windows 10 oder 11 aus dem Microsoft Store installiert wird. Wenn WSLg nicht verfügbar ist, beispielsweise unter WSL1, führen Sie Claude Code stattdessen nativ unter Windows aus.26* **WSLg, wenn Sie Claude Code in WSL ausführen**: WSLg ist in WSL2 enthalten, wenn es unter Windows 10 oder 11 aus dem Microsoft Store installiert wird. Wenn WSLg nicht verfügbar ist, beispielsweise unter WSL1, führen Sie Claude Code stattdessen nativ unter Windows aus.


183* **`No audio recording tool found` 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`.183* **`No audio recording tool found` 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`.

184* **`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. {/* min-version: 2.1.195 */}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.184* **`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. {/* min-version: 2.1.195 */}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.

185* **`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.185* **`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.

186* **`Voice input is failing repeatedly and has been paused`**: Die Spracherfassung ist mehrmals hintereinander fehlgeschlagen und hat versucht, neue Sitzungen zu stoppen, bis eine erfolgreich ist. 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.186* **`Voice input is failing repeatedly and has been paused`**: Die Spracherfassung ist mehrmals hintereinander fehlgeschlagen und hat versucht, neue Sitzungen zu stoppen, bis eine erfolgreich ist. 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. {/* min-version: 2.1.202 */}Vor v2.1.202 zählten nur Start-Fehler zur Pause.

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

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

189* **`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.189* **`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.

190* **`Voice connection failed`**: Ihre Aufnahme erreichte den Transkriptionsdienst nicht, da die Verbindung fehlgeschlagen ist. Überprüfen Sie Ihr Netzwerk und versuchen Sie es erneut. {/* min-version: 2.1.200 */}Eine Aufnahme, die keinen Audio erfasst, meldet stattdessen `No audio detected from microphone`. Vor v2.1.200 konnte ein stilles Mikrofon einen Verbindungsfehler melden, was auf ein Netzwerkproblem hindeutete, wenn das eigentliche Problem das Eingabegerät war.

190* **`No speech detected`**: Audio erreichte den Transkriptionsdienst, aber es wurden keine Wörter erkannt. Sprechen Sie näher zum Mikrofon, reduzieren Sie Hintergrundgeräusche und bestätigen Sie, dass Ihre [Erfassungssprache](#change-the-dictation-language) der Sprache entspricht, die Sie sprechen.191* **`No speech detected`**: Audio erreichte den Transkriptionsdienst, aber es wurden keine Wörter erkannt. Sprechen Sie näher zum Mikrofon, reduzieren Sie Hintergrundgeräusche und bestätigen Sie, dass Ihre [Erfassungssprache](#change-the-dictation-language) der Sprache entspricht, die Sie sprechen.

191* **Transkription ist verzerrt oder in der falschen Sprache**: Die Erfassung wird standardmäßig auf Englisch eingestellt. Wenn Sie in einer anderen Sprache erfassen, legen Sie sie zuerst in `/config` fest. Siehe [Ändern Sie die Erfassungssprache](#change-the-dictation-language).192* **Transkription ist verzerrt oder in der falschen Sprache**: Die Erfassung wird standardmäßig auf Englisch eingestellt. Wenn Sie in einer anderen Sprache erfassen, legen Sie sie zuerst in `/config` fest. Siehe [Ändern Sie die Erfassungssprache](#change-the-dictation-language).

192 193 

vs-code.md +11 −7

Details

19Stellen Sie vor der Installation sicher, dass Sie folgende Voraussetzungen erfüllen:19Stellen Sie vor der Installation sicher, dass Sie folgende Voraussetzungen erfüllen:

20 20 

21* VS Code 1.98.0 oder höher21* VS Code 1.98.0 oder höher

22* Ein Anthropic-Konto: Jedes bezahlte Claude-Abonnement (Pro, Max, Team oder Enterprise) oder ein Claude Console-Konto funktioniert, und es ist kein API-Schlüssel erforderlich. Sie [melden sich an](/de/authentication#log-in-to-claude-code) mit diesem Konto an, wenn Sie die Erweiterung zum ersten Mal öffnen. Wenn Sie Claude über einen Drittanbieter wie Amazon Bedrock oder Google Vertex AI nutzen, siehe [Drittanbieter verwenden](#use-third-party-providers) für Setupanweisungen.22* Ein Anthropic-Konto: Jedes bezahlte Claude-Abonnement (Pro, Max, Team oder Enterprise) oder ein Claude Console-Konto funktioniert, und es ist kein API-Schlüssel erforderlich. Sie [melden sich an](/de/authentication#log-in-to-claude-code) mit diesem Konto an, wenn Sie die Erweiterung zum ersten Mal öffnen. Wenn Sie Claude über einen Drittanbieter wie Amazon Bedrock oder Google Cloud's Agent Platform nutzen, siehe [Drittanbieter verwenden](#use-third-party-providers) für Setupanweisungen.

23 23 

24<Tip>24<Tip>

25 Die Erweiterung enthält eine eigene Kopie der CLI (Befehlszeilenschnittstelle) für das Chat-Panel. Um `claude` im integrierten Terminal von VS Code auszuführen, benötigen Sie auch die [eigenständige CLI-Installation](/de/setup). Siehe [VS Code-Erweiterung vs. Claude Code CLI](#vs-code-extension-vs-claude-code-cli) für Details.25 Die Erweiterung enthält eine eigene Kopie der CLI (Befehlszeilenschnittstelle) für das Chat-Panel. Um `claude` im integrierten Terminal von VS Code auszuführen, benötigen Sie auch die [eigenständige CLI-Installation](/de/setup). Siehe [VS Code-Erweiterung vs. Claude Code CLI](#vs-code-extension-vs-claude-code-cli) für Details.


102 102 

103Das Eingabefeld unterstützt mehrere Funktionen:103Das Eingabefeld unterstützt mehrere Funktionen:

104 104 

105* **Genehmigungsmodi**: Klicken Sie auf den Modusindikator am unteren Rand des Eingabefelds, um Modi zu wechseln. Im normalen Modus fragt Claude vor jeder Aktion um Genehmigung. Im Plan Mode beschreibt Claude, was es tun wird, und wartet auf Genehmigung, bevor es Änderungen vornimmt. 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. Im Auto-Accept-Modus nimmt Claude Bearbeitungen vor, ohne zu fragen. Legen Sie den Standard in den VS Code-Einstellungen unter `claudeCode.initialPermissionMode` fest.105* **Genehmigungsmodi**: Klicken Sie auf den Modusindikator am unteren Rand des Eingabefelds, um Modi zu wechseln, oder legen Sie den Standard in den VS Code-Einstellungen unter `claudeCode.initialPermissionMode` fest. Siehe [Genehmigungsmodi](/de/permission-modes#switch-permission-modes) für jeden Modus, den der Indikator bietet.

106 * **Manuell**: Claude fragt vor jeder Aktion um Genehmigung.

107 * **Plan**: Claude beschreibt, was es tun wird, und wartet auf Genehmigung, bevor es Änderungen vornimmt. 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.

108 * **Automatisch bearbeiten**: Claude nimmt Bearbeitungen vor, ohne zu fragen.

106* **Befehlsmenü**: Klicken Sie auf `/` oder geben Sie `/` ein, um das Befehlsmenü zu öffnen. Zu den Optionen gehören das Anhängen von Dateien, das Wechseln von Modellen, das Umschalten von erweitertem Denken, das Anzeigen der Plannutzung (`/usage`) und das Starten einer [Remote Control](/de/remote-control)-Sitzung (`/remote-control`). Der Abschnitt „Anpassen" bietet Zugriff auf MCP servers, hooks, memory, permissions und plugins. Elemente mit einem Terminal-Symbol werden im integrierten Terminal geöffnet.109* **Befehlsmenü**: Klicken Sie auf `/` oder geben Sie `/` ein, um das Befehlsmenü zu öffnen. Zu den Optionen gehören das Anhängen von Dateien, das Wechseln von Modellen, das Umschalten von erweitertem Denken, das Anzeigen der Plannutzung (`/usage`) und das Starten einer [Remote Control](/de/remote-control)-Sitzung (`/remote-control`). Der Abschnitt „Anpassen" bietet Zugriff auf MCP servers, hooks, memory, permissions und plugins. Elemente mit einem Terminal-Symbol werden im integrierten Terminal geöffnet.

110 * {/* min-version: 2.1.203 */}Der Abschnitt „Einstellungen" enthält **Remote Control für alle Sitzungen aktivieren**, das [`remoteControlAtStartup`](/de/settings#available-settings) setzt, sodass [jede neue interaktive Sitzung automatisch eine Verbindung zu Remote Control herstellt](/de/remote-control#enable-remote-control-for-all-sessions). Erfordert Claude Code v2.1.203 oder später.

107* **Kontextindikator**: Das Eingabefeld zeigt, wie viel von Claudes context window Sie verwenden. Claude komprimiert automatisch bei Bedarf, oder Sie können `/compact` manuell ausführen.111* **Kontextindikator**: Das Eingabefeld zeigt, wie viel von Claudes context window Sie verwenden. Claude komprimiert automatisch bei Bedarf, oder Sie können `/compact` manuell ausführen.

108* **Erweitertes Denken**: Ermöglicht Claude, mehr Zeit für die Überlegung komplexer Probleme aufzuwenden. Aktivieren Sie es über das Befehlsmenü (`/`). Claudes Überlegungen werden im Gespräch als zusammengeklappte Blöcke angezeigt: Klicken Sie auf einen Block, um ihn zu lesen, oder drücken Sie `Ctrl+O`, um jeden Denkblock in der Sitzung zu erweitern oder zu reduzieren. Siehe [Erweitertes Denken](/de/model-config#extended-thinking) für Details.112* **Erweitertes Denken**: Ermöglicht Claude, mehr Zeit für die Überlegung komplexer Probleme aufzuwenden. Aktivieren Sie es über das Befehlsmenü (`/`). Claudes Überlegungen werden im Gespräch als zusammengeklappte Blöcke angezeigt: Klicken Sie auf einen Block, um ihn zu lesen, oder drücken Sie `Ctrl+O`, um jeden Denkblock in der Sitzung zu erweitern oder zu reduzieren. Siehe [Erweitertes Denken](/de/model-config#extended-thinking) für Details.

109* **Mehrzeilige Eingabe**: Drücken Sie `Shift+Enter`, um eine neue Zeile hinzuzufügen, ohne zu senden. Dies funktioniert auch in der Freitexteingabe „Sonstiges" von Frage-Dialogen.113* **Mehrzeilige Eingabe**: Drücken Sie `Shift+Enter`, um eine neue Zeile hinzuzufügen, ohne zu senden. Dies funktioniert auch in der Freitexteingabe „Sonstiges" von Frage-Dialogen.


159 Konto und Nutzung überprüfen163 Konto und Nutzung überprüfen

160</h3>164</h3>

161 165 

162Führen Sie `/usage` aus dem Befehlsmenü aus, um das Dialogfeld 'Konto & Nutzung" zu öffnen. Es zeigt Ihr angemeldetes Konto, Ihren Plan und Nutzungsbalken für die aktuelle Sitzung und Woche mit der verbleibenden Zeit bis zum Zurücksetzen jedes Limits.166Führen Sie `/usage` aus dem Befehlsmenü aus, um das Dialogfeld Konto & Nutzung" zu öffnen. Es zeigt Ihr angemeldetes Konto, Ihren Plan und Nutzungsbalken für die aktuelle Sitzung und Woche mit der verbleibenden Zeit bis zum Zurücksetzen jedes Limits.

163 167 

164Das Dialogfeld zeigt auch auf, was zu Ihren Planlimits beiträgt. Es kennzeichnet Verhaltensweisen, die 10 % oder mehr der letzten Nutzung ausmachen, wie z. B. Cache-Misses, langer Kontext und Subagent-intensive oder hochgradig parallele Sitzungen, jeweils mit einem Tipp zur Reduzierung. Attributionstabellen zeigen, wie viel Nutzung von jedem Skill, Subagent, Plugin und MCP server kam. Erfordert Claude Code v2.1.174 oder später.168Das Dialogfeld zeigt auch auf, was zu Ihren Planlimits beiträgt. Es kennzeichnet Verhaltensweisen, die 10 % oder mehr der letzten Nutzung ausmachen, wie z. B. Cache-Misses, langer Kontext und Subagent-intensive oder hochgradig parallele Sitzungen, jeweils mit einem Tipp zur Reduzierung. Attributionstabellen zeigen, wie viel Nutzung von jedem Skill, Subagent, Plugin und MCP server kam. Erfordert Claude Code v2.1.174 oder später.

165 169 


356</h3>360</h3>

357 361 

358| Einstellung | Standard | Beschreibung |362| Einstellung | Standard | Beschreibung |

359| ----------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |363| ----------------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

360| `useTerminal` | `false` | Starten Sie Claude im Terminal-Modus statt im grafischen Panel |364| `useTerminal` | `false` | Starten Sie Claude im Terminal-Modus statt im grafischen Panel |

361| `initialPermissionMode` | `default` | Steuert Genehmigungsaufforderungen für neue Gespräche: `default`, `plan`, `acceptEdits` oder `bypassPermissions`. Siehe [Genehmigungsmodi](/de/permission-modes). |365| `initialPermissionMode` | `default` | Steuert Genehmigungsaufforderungen für neue Gespräche: `default`, `plan`, `acceptEdits` oder `bypassPermissions`. {/* min-version: 2.1.200 */}`manual` ist ein Alias für `default` und wählt den Modus mit der Bezeichnung **Manual** im Modusindikator. Erfordert Claude Code v2.1.200 oder später. Siehe [Genehmigungsmodi](/de/permission-modes). |

362| `preferredLocation` | `panel` | Wo Claude öffnet: `sidebar` (rechts) oder `panel` (neue Registerkarte) |366| `preferredLocation` | `panel` | Wo Claude öffnet: `sidebar` (rechts) oder `panel` (neue Registerkarte) |

363| `autosave` | `true` | Speichern Sie Dateien automatisch, bevor Claude sie liest oder schreibt |367| `autosave` | `true` | Speichern Sie Dateien automatisch, bevor Claude sie liest oder schreibt |

364| `useCtrlEnterToSend` | `false` | Verwenden Sie Ctrl/Cmd+Enter statt Enter, um Eingabeaufforderungen zu senden |368| `useCtrlEnterToSend` | `false` | Verwenden Sie Ctrl/Cmd+Enter statt Enter, um Eingabeaufforderungen zu senden |


479 Verwenden Sie Drittanbieter483 Verwenden Sie Drittanbieter

480</h2>484</h2>

481 485 

482Standardmäßig verbindet sich Claude Code direkt mit der API von Anthropic. Wenn Ihre Organisation Amazon Bedrock, Google Vertex AI oder Microsoft Foundry verwendet, um auf Claude zuzugreifen, konfigurieren Sie die Erweiterung, um stattdessen Ihren Anbieter zu verwenden:486Standardmäßig verbindet sich Claude Code direkt mit der API von Anthropic. Wenn Ihre Organisation Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verwendet, um auf Claude zuzugreifen, konfigurieren Sie die Erweiterung, um stattdessen Ihren Anbieter zu verwenden:

483 487 

484<Steps>488<Steps>

485 <Step title="Deaktivieren Sie die Anmeldungsaufforderung">489 <Step title="Deaktivieren Sie die Anmeldungsaufforderung">


492 Folgen Sie dem Setup-Leitfaden für Ihren Anbieter:496 Folgen Sie dem Setup-Leitfaden für Ihren Anbieter:

493 497 

494 * [Claude Code auf Amazon Bedrock](/de/amazon-bedrock)498 * [Claude Code auf Amazon Bedrock](/de/amazon-bedrock)

495 * [Claude Code auf Google Vertex AI](/de/google-vertex-ai)499 * [Claude Code auf Google Cloud's Agent Platform](/de/google-vertex-ai)

496 * [Claude Code auf Microsoft Foundry](/de/microsoft-foundry)500 * [Claude Code auf Microsoft Foundry](/de/microsoft-foundry)

497 501 

498 Diese Leitfäden behandeln die Konfiguration Ihres Anbieters in `~/.claude/settings.json`, was sicherstellt, dass Ihre Einstellungen zwischen der VS Code-Erweiterung und der CLI geteilt werden.502 Diese Leitfäden behandeln die Konfiguration Ihres Anbieters in `~/.claude/settings.json`, was sicherstellt, dass Ihre Einstellungen zwischen der VS Code-Erweiterung und der CLI geteilt werden.

Details

43Claude Code verhält sich überall gleich. Was sich ändert, ist, wo Code ausgeführt wird und ob Ihre lokale Konfiguration verfügbar ist. Die Desktop-App bietet sowohl lokale als auch Cloud-Sitzungen, daher hängen die Antworten unten davon ab, welche Sie wählen:43Claude Code verhält sich überall gleich. Was sich ändert, ist, wo Code ausgeführt wird und ob Ihre lokale Konfiguration verfügbar ist. Die Desktop-App bietet sowohl lokale als auch Cloud-Sitzungen, daher hängen die Antworten unten davon ab, welche Sie wählen:

44 44 

45| | Im Web | Remote Control | Terminal CLI | Desktop-App |45| | Im Web | Remote Control | Terminal CLI | Desktop-App |

46| :------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------- | :----------------------- | :----------------------------- |46| :------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------- | :----------------------- | :----------------------------- |

47| **Code wird ausgeführt auf** | Anthropic Cloud VM | Ihrem Computer | Ihrem Computer | Ihrem Computer oder Cloud VM |47| **Code wird ausgeführt auf** | Anthropic Cloud VM | Ihrem Computer | Ihrem Computer | Ihrem Computer oder Cloud VM |

48| **Sie chatten von** | claude.ai oder Mobilanwendung | claude.ai oder Mobilanwendung | Ihrem Terminal | Der Desktop-Benutzeroberfläche |48| **Sie chatten von** | claude.ai oder Mobilanwendung | claude.ai oder Mobilanwendung | Ihrem Terminal | Der Desktop-Benutzeroberfläche |

49| **Verwendet Ihre lokale Konfiguration** | Nein, nur Repository | Ja | Ja | Ja für lokal, nein für Cloud |49| **Verwendet Ihre lokale Konfiguration** | Nein, nur Repository | Ja | Ja | Ja für lokal, nein für Cloud |

50| **Erfordert GitHub** | Ja, oder [bündeln Sie ein lokales Repository](/de/claude-code-on-the-web#send-local-repositories-without-github) über `--remote` | Nein | Nein | Nur für Cloud-Sitzungen |50| **Erfordert GitHub** | Ja, oder [bündeln Sie ein lokales Repository](/de/claude-code-on-the-web#send-local-repositories-without-github) über `--cloud` | Nein | Nein | Nur für Cloud-Sitzungen |

51| **Läuft weiter, wenn Sie die Verbindung trennen** | Ja | Während das Terminal offen bleibt | Nein | Hängt vom Sitzungstyp ab |51| **Läuft weiter, wenn Sie die Verbindung trennen** | Ja | Während das Terminal offen bleibt | Nein | Hängt vom Sitzungstyp ab |

52| **[Berechtigungsmodi](/de/permission-modes)** | Änderungen automatisch akzeptieren, Plan | Fragen, Änderungen automatisch akzeptieren, Plan | Alle Modi | Hängt vom Sitzungstyp ab |52| **[Berechtigungsmodi](/de/permission-modes)** | Änderungen akzeptieren, Plan, Auto | Fragen, Änderungen automatisch akzeptieren, Plan | Alle Modi | Hängt vom Sitzungstyp ab |

53| **Netzwerkzugriff** | Konfigurierbar pro Umgebung | Netzwerk Ihres Computers | Netzwerk Ihres Computers | Hängt vom Sitzungstyp ab |53| **Netzwerkzugriff** | Konfigurierbar pro Umgebung | Netzwerk Ihres Computers | Netzwerk Ihres Computers | Hängt vom Sitzungstyp ab |

54 54 

55Siehe die Dokumentation zu [Terminal-Schnellstart](/de/quickstart), [Desktop-App](/de/desktop) oder [Remote Control](/de/remote-control), um diese einzurichten.55Siehe die Dokumentation zu [Terminal-Schnellstart](/de/quickstart), [Desktop-App](/de/desktop) oder [Remote Control](/de/remote-control), um diese einzurichten.


113 /web-setup113 /web-setup

114 ```114 ```

115 115 

116 Dies synchronisiert Ihr `gh`-Token mit Ihrem Claude-Konto. Wenn Sie noch keine Cloud-Umgebung haben, erstellt `/web-setup` eine mit Trusted-Netzwerkzugriff und ohne Setup-Skript. Sie können [die Umgebung bearbeiten oder Variablen hinzufügen](/de/claude-code-on-the-web#configure-your-environment) danach. Sobald `/web-setup` abgeschlossen ist, können Sie Cloud-Sitzungen von Ihrem Terminal aus mit [`--remote`](/de/claude-code-on-the-web#from-terminal-to-web) starten oder wiederkehrende Aufgaben mit [`/schedule`](/de/routines) einrichten.116 Dies synchronisiert Ihr `gh`-Token mit Ihrem Claude-Konto. Wenn Sie noch keine Cloud-Umgebung haben, erstellt `/web-setup` eine mit Trusted-Netzwerkzugriff und ohne Setup-Skript. Sie können [die Umgebung bearbeiten oder Variablen hinzufügen](/de/claude-code-on-the-web#configure-your-environment) danach. Sobald `/web-setup` abgeschlossen ist, können Sie Cloud-Sitzungen von Ihrem Terminal aus mit [`--cloud`](/de/claude-code-on-the-web#from-terminal-to-web) starten oder wiederkehrende Aufgaben mit [`/schedule`](/de/routines) einrichten.

117 </Step>117 </Step>

118</Steps>118</Steps>

119 119 


129 </Step>129 </Step>

130 130 

131 <Step title="Wählen Sie einen Berechtigungsmodus">131 <Step title="Wählen Sie einen Berechtigungsmodus">

132 Der Modus-Dropdown neben der Eingabe ist standardmäßig auf **Änderungen automatisch akzeptieren** eingestellt, wobei Claude Änderungen vornimmt und einen Branch pusht, ohne auf Genehmigung zu warten. Wechseln Sie zu **Plan-Modus**, wenn Claude einen Ansatz vorschlagen und auf Ihr Okay warten soll, bevor Dateien bearbeitet werden. Cloud-Sitzungen bieten keine Ask-Berechtigungen oder Bypass-Berechtigungen. Siehe [Berechtigungsmodi](/de/permission-modes) für die vollständige Liste.132 Der Modus-Dropdown neben der Eingabe ist standardmäßig auf **Änderungen automatisch akzeptieren** eingestellt, wobei Claude Änderungen vornimmt und einen Branch pusht, ohne auf Genehmigung zu warten. Wechseln Sie zu **Plan-Modus**, wenn Claude einen Ansatz vorschlagen und auf Ihr Okay warten soll, bevor Dateien bearbeitet werden. Cloud-Sitzungen bieten keine Ask-Berechtigungen oder Bypass-Berechtigungen. Siehe die [vollständige Liste der Berechtigungsmodi](/de/permission-modes#available-modes) für das, was jeder Modus erlaubt.

133 </Step>133 </Step>

134 134 

135 <Step title="Beschreiben Sie die Aufgabe und übermitteln Sie sie">135 <Step title="Beschreiben Sie die Aufgabe und übermitteln Sie sie">

136 Geben Sie eine Beschreibung dessen ein, was Sie möchten, und drücken Sie die Eingabetaste. Seien Sie spezifisch:136 Geben Sie eine Beschreibung dessen ein, was Sie möchten, und drücken Sie die Eingabetaste. Seien Sie spezifisch:

137 137 

138 * Nennen Sie die Datei oder Funktion: 'Fügen Sie eine README mit Setup-Anweisungen hinzu" oder „Beheben Sie den fehlgeschlagenen Auth-Test in `tests/test_auth.py`" ist besser als „Tests beheben"138 * Nennen Sie die Datei oder Funktion: Fügen Sie eine README mit Setup-Anweisungen hinzu" oder „Beheben Sie den fehlgeschlagenen Auth-Test in `tests/test_auth.py`" ist besser als „Tests beheben"

139 * Fügen Sie Fehlerausgabe ein, falls vorhanden139 * Fügen Sie Fehlerausgabe ein, falls vorhanden

140 * Beschreiben Sie das erwartete Verhalten, nicht nur das Symptom140 * Beschreiben Sie das erwartete Verhalten, nicht nur das Symptom

141 141 


206 „Nicht verfügbar für die ausgewählte Organisation"206 „Nicht verfügbar für die ausgewählte Organisation"

207</h3>207</h3>

208 208 

209Enterprise-Organisationen müssen möglicherweise von einem Administrator Claude Code im Web aktivieren lassen. Kontaktieren Sie Ihr Anthropic-Account-Team.209Enterprise-Organisationen müssen möglicherweise von einem Owner Claude Code im Web aktivieren lassen. Kontaktieren Sie Ihr Anthropic-Account-Team.

210 210 

211<h3 id="/web-setup-shows-no-commands-match-or-unknown-command">211<h3 id="/web-setup-shows-no-commands-match-or-unknown-command">

212 `/web-setup` zeigt „Keine Befehle stimmen überein" oder „Unbekannter Befehl"212 `/web-setup` zeigt „Keine Befehle stimmen überein" oder „Unbekannter Befehl"


216 216 

217Wenn Sie es in Claude Code eingegeben haben und das Befehlsmenü `Keine Befehle stimmen überein "/web-setup"` anzeigt oder das Absenden `Unbekannter Befehl: /web-setup` zurückgibt, ist der Befehl verborgen, weil eine Anforderung nicht erfüllt ist. Die Ursache ist normalerweise, dass Ihre CLI älter als v2.1.80 ist oder Sie mit einem API-Schlüssel oder einem Drittanbieter-Provider authentifiziert sind, anstatt mit einem claude.ai-Abonnement. Führen Sie `claude update` aus und dann `/login`, um sich mit Ihrem claude.ai-Konto anzumelden.217Wenn Sie es in Claude Code eingegeben haben und das Befehlsmenü `Keine Befehle stimmen überein "/web-setup"` anzeigt oder das Absenden `Unbekannter Befehl: /web-setup` zurückgibt, ist der Befehl verborgen, weil eine Anforderung nicht erfüllt ist. Die Ursache ist normalerweise, dass Ihre CLI älter als v2.1.80 ist oder Sie mit einem API-Schlüssel oder einem Drittanbieter-Provider authentifiziert sind, anstatt mit einem claude.ai-Abonnement. Führen Sie `claude update` aus und dann `/login`, um sich mit Ihrem claude.ai-Konto anzumelden.

218 218 

219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-remote-or-ultraplan">219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud-or-ultraplan">

220 „Cloud-Umgebung konnte nicht erstellt werden" oder „Keine Cloud-Umgebung verfügbar" bei Verwendung von `--remote` oder ultraplan220 „Cloud-Umgebung konnte nicht erstellt werden" oder „Keine Cloud-Umgebung verfügbar" bei Verwendung von `--cloud` oder ultraplan

221</h3>221</h3>

222 222 

223Remote-Sitzungsfunktionen erstellen automatisch eine Standard-Cloud-Umgebung, wenn Sie noch keine haben. Wenn Sie „Cloud-Umgebung konnte nicht erstellt werden" sehen, ist die automatische Erstellung fehlgeschlagen. {/* max-version: 2.1.100 */}Wenn Sie „Keine Cloud-Umgebung verfügbar" sehen, ist Ihre CLI älter als die automatische Erstellung. Führen Sie in beiden Fällen `/web-setup` in der Claude Code CLI aus, um eine manuell zu erstellen, oder besuchen Sie [claude.ai/code](https://claude.ai/code) und folgen Sie dem Schritt **Erstellen Sie Ihre Umgebung** oben.223Remote-Sitzungsfunktionen erstellen automatisch eine Standard-Cloud-Umgebung, wenn Sie noch keine haben. Wenn Sie „Cloud-Umgebung konnte nicht erstellt werden" sehen, ist die automatische Erstellung fehlgeschlagen. {/* max-version: 2.1.100 */}Wenn Sie „Keine Cloud-Umgebung verfügbar" sehen, ist Ihre CLI älter als die automatische Erstellung. Führen Sie in beiden Fällen `/web-setup` in der Claude Code CLI aus, um eine manuell zu erstellen, oder besuchen Sie [claude.ai/code](https://claude.ai/code) und folgen Sie dem Schritt **Erstellen Sie Ihre Umgebung** oben.

whats-new.md +1 −1

Details

33</Update>33</Update>

34 34 

35<Update label="Woche 23" description="1.–5. Juni 2026" tags={["v2.1.158–v2.1.165"]}>35<Update label="Woche 23" description="1.–5. Juni 2026" tags={["v2.1.158–v2.1.165"]}>

36 **Auto-Modus auf Bedrock, Vertex und Foundry**: Auto-Modus ist jetzt auf Drittanbieter-Providern für Opus 4.7 und Opus 4.8 verfügbar und ersetzt Genehmigungsaufforderungen durch Hintergrund-Sicherheitsprüfungen.36 **Auto-Modus auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry**: Auto-Modus ist jetzt auf Drittanbieter-Providern für Opus 4.7 und Opus 4.8 verfügbar und ersetzt Genehmigungsaufforderungen durch Hintergrund-Sicherheitsprüfungen.

37 37 

38 Auch diese Woche: **sicherere automatische Bearbeitungen** fordern auf, bevor Dateien geschrieben werden, die Code im `acceptEdits`-Modus ausführen können; **`/plugin list`** druckt Ihre installierten Plugins inline; und **Versionsanforderungen** ermöglichen es verwalteten Bereitstellungen, einen genehmigten Claude Code-Versionsbereich zu erfordern.38 Auch diese Woche: **sicherere automatische Bearbeitungen** fordern auf, bevor Dateien geschrieben werden, die Code im `acceptEdits`-Modus ausführen können; **`/plugin list`** druckt Ihre installierten Plugins inline; und **Versionsanforderungen** ermöglichen es verwalteten Bereitstellungen, einen genehmigten Claude Code-Versionsbereich zu erfordern.

39 39 

Details

102 102 

103 <div className="digest-wins-grid">103 <div className="digest-wins-grid">

104 <div>Fokus-Ansicht: Drücken Sie <code>Ctrl+O</code> im flimmerfreien Modus, um die Ansicht auf Ihren letzten Prompt, eine einzeilige Tool-Zusammenfassung mit Diffstats und Claudes endgültige Antwort zu reduzieren</div>104 <div>Fokus-Ansicht: Drücken Sie <code>Ctrl+O</code> im flimmerfreien Modus, um die Ansicht auf Ihren letzten Prompt, eine einzeilige Tool-Zusammenfassung mit Diffstats und Claudes endgültige Antwort zu reduzieren</div>

105 <div>Geführte <a href="/de/docs/amazon-bedrock">Bedrock</a>- und <a href="/de/docs/google-vertex-ai">Vertex AI</a>-Setup-Assistenten auf dem Anmeldebildschirm: Wählen Sie „3rd-party platform" für schrittweise Authentifizierung, Region, Anmeldedaten-Überprüfung und Modell-Pinning</div>105 <div>Geführte <a href="/de/docs/amazon-bedrock">Amazon Bedrock</a>- und <a href="/de/docs/google-vertex-ai">Google Cloud's Agent Platform</a>-Setup-Assistenten auf dem Anmeldebildschirm: Wählen Sie „3rd-party platform" für schrittweise Authentifizierung, Region, Anmeldedaten-Überprüfung und Modell-Pinning</div>

106 <div><code>/agents</code> erhält ein Tabbed-Layout: Ein Running-Tab zeigt Live-Subagents mit einer <code>● N running</code>-Anzeige sowie Run agent und View running instance-Aktionen im Library-Tab</div>106 <div><code>/agents</code> erhält ein Tabbed-Layout: Ein Running-Tab zeigt Live-Subagents mit einer <code>● N running</code>-Anzeige sowie Run agent und View running instance-Aktionen im Library-Tab</div>

107 <div>Die Standard-Anstrengungsstufe ist jetzt <code>high</code> für API-Key-, Bedrock-, Vertex-, Foundry-, Team- und Enterprise-Benutzer (steuern Sie mit <code>/effort</code>)</div>107 <div>Die Standard-Anstrengungsstufe ist jetzt <code>high</code> für API-Key-, Amazon Bedrock-, Google Cloud's Agent Platform-, Microsoft Foundry-, Team- und Enterprise-Benutzer (steuern Sie mit <code>/effort</code>)</div>

108 <div><code>/cost</code> zeigt eine Pro-Modell- und Cache-Hit-Aufschlüsselung für Abonnement-Benutzer</div>108 <div><code>/cost</code> zeigt eine Pro-Modell- und Cache-Hit-Aufschlüsselung für Abonnement-Benutzer</div>

109 <div><code>/release-notes</code> ist jetzt ein interaktiver Versions-Picker</div>109 <div><code>/release-notes</code> ist jetzt ein interaktiver Versions-Picker</div>

110 <div>Statuszeile: neue <code>refreshInterval</code>-Einstellung führt den Befehl alle N Sekunden erneut aus, und <code>workspace.git\_worktree</code> in der JSON-Eingabe</div>110 <div>Statuszeile: neue <code>refreshInterval</code>-Einstellung führt den Befehl alle N Sekunden erneut aus, und <code>workspace.git\_worktree</code> in der JSON-Eingabe</div>

Details

105 <div>MCP-Server, die während des Starts einen vorübergehenden Fehler treffen, versuchen jetzt automatisch bis zu 3 Mal erneut, anstatt getrennt zu bleiben</div>105 <div>MCP-Server, die während des Starts einen vorübergehenden Fehler treffen, versuchen jetzt automatisch bis zu 3 Mal erneut, anstatt getrennt zu bleiben</div>

106 <div>`ANTHROPIC_BEDROCK_SERVICE_TIER` wählt einen Bedrock-Service-Tier: `default`, `flex` oder `priority`</div>106 <div>`ANTHROPIC_BEDROCK_SERVICE_TIER` wählt einen Bedrock-Service-Tier: `default`, `flex` oder `priority`</div>

107 <div>`/terminal-setup` aktiviert die Clipboard-Zugriffseinstellen von iTerm2, damit `/copy` funktioniert, auch von tmux aus</div>107 <div>`/terminal-setup` aktiviert die Clipboard-Zugriffseinstellen von iTerm2, damit `/copy` funktioniert, auch von tmux aus</div>

108 <div>Vertex AI unterstützt jetzt X.509-Zertifikat-basierte Workload Identity Federation (mTLS ADC)</div>108 <div>Google Cloud's Agent Platform unterstützt jetzt X.509-Zertifikat-basierte Workload Identity Federation (mTLS ADC)</div>

109 <div>Signifikante Speicherleck-Fixes: bildintensive Sitzungen, `/usage` bei großen Transkript-Historien und lang laufende Tools ohne Progress-Events</div>109 <div>Signifikante Speicherleck-Fixes: bildintensive Sitzungen, `/usage` bei großen Transkript-Historien und lang laufende Tools ohne Progress-Events</div>

110 </div>110 </div>

111</div>111</div>

Details

37 <div>Neuer <a href="/de/code-review"><code>/code-review</code></a>-Befehl meldet Korrektheitsfehler auf einer gewählten Aufwandsebene wie <code>/code-review high</code>, und <code>--comment</code> veröffentlicht Ergebnisse als Inline-GitHub-PR-Kommentare. <code>/simplify</code> bleibt als separate Bereinigungsprüfung erhalten.</div>37 <div>Neuer <a href="/de/code-review"><code>/code-review</code></a>-Befehl meldet Korrektheitsfehler auf einer gewählten Aufwandsebene wie <code>/code-review high</code>, und <code>--comment</code> veröffentlicht Ergebnisse als Inline-GitHub-PR-Kommentare. <code>/simplify</code> bleibt als separate Bereinigungsprüfung erhalten.</div>

38 <div>Hintergrundsitzungen werden jetzt in <code>/resume</code> neben interaktiven angezeigt, gekennzeichnet mit <code>bg</code>, und Sitzungen, die mit <code>Ctrl+T</code> in <code>claude agents</code> angeheftet werden, bleiben aktiv, wenn sie untätig sind</div>38 <div>Hintergrundsitzungen werden jetzt in <code>/resume</code> neben interaktiven angezeigt, gekennzeichnet mit <code>bg</code>, und Sitzungen, die mit <code>Ctrl+T</code> in <code>claude agents</code> angeheftet werden, bleiben aktiv, wenn sie untätig sind</div>

39 <div><code>claude agents --json</code> listet Live-Sitzungen als JSON für Scripting auf, z. B. Statusleisten und Sitzungsauswahl</div>39 <div><code>claude agents --json</code> listet Live-Sitzungen als JSON für Scripting auf, z. B. Statusleisten und Sitzungsauswahl</div>

40 <div>Das PowerShell-Tool ist jetzt standardmäßig auf Windows für Bedrock-, Vertex- und Foundry-Benutzer aktiviert; deaktivieren Sie es mit <code>CLAUDE\_CODE\_USE\_POWERSHELL\_TOOL=0</code></div>40 <div>Das PowerShell-Tool ist jetzt standardmäßig auf Windows für Amazon Bedrock-, Google Cloud's Agent Platform- und Microsoft Foundry-Benutzer aktiviert; deaktivieren Sie es mit <code>CLAUDE\_CODE\_USE\_POWERSHELL\_TOOL=0</code></div>

41 <div><code>claude plugin disable</code> weigert sich jetzt, wenn ein anderes aktiviertes Plugin vom Ziel abhängt, und <code>claude plugin enable</code> erzwingt transitiv abhängige Plugins</div>41 <div><code>claude plugin disable</code> weigert sich jetzt, wenn ein anderes aktiviertes Plugin vom Ziel abhängt, und <code>claude plugin enable</code> erzwingt transitiv abhängige Plugins</div>

42 <div>Der <code>/plugin</code>-Marketplace-Browsing-Bereich zeigt die projizierte Kontextkosten an, und die Discover- und Browse-Bildschirme listen die Befehle, Agenten, Skills, Hooks und MCP/LSP-Server eines Plugins vor der Installation auf</div>42 <div>Der <code>/plugin</code>-Marketplace-Browsing-Bereich zeigt die projizierte Kontextkosten an, und die Discover- und Browse-Bildschirme listen die Befehle, Agenten, Skills, Hooks und MCP/LSP-Server eines Plugins vor der Installation auf</div>

43 <div>Neue <code>worktree.bgIsolation: "none"</code>-Einstellung ermöglicht es Hintergrundsitzungen, die Arbeitskopie direkt ohne <code>EnterWorktree</code> zu bearbeiten, für Repositories, bei denen Worktrees unpraktisch sind</div>43 <div>Neue <code>worktree.bgIsolation: "none"</code>-Einstellung ermöglicht es Hintergrundsitzungen, die Arbeitskopie direkt ohne <code>EnterWorktree</code> zu bearbeiten, für Repositories, bei denen Worktrees unpraktisch sind</div>

Details

109 <div>Claude Code wechselt jetzt zu Ihrem konfigurierten <code>--fallback-model</code> für den Rest der Sitzung, wenn das primäre Modell nicht gefunden wird, anstatt jede Anfrage fehlschlagen zu lassen</div>109 <div>Claude Code wechselt jetzt zu Ihrem konfigurierten <code>--fallback-model</code> für den Rest der Sitzung, wenn das primäre Modell nicht gefunden wird, anstatt jede Anfrage fehlschlagen zu lassen</div>

110 <div>Plugins können <code>defaultEnabled: false</code> in <code>plugin.json</code> oder einem Marketplace-Eintrag deklarieren, sodass sie installiert werden, ohne sich einzuschalten, bis Sie sie aktivieren</div>110 <div>Plugins können <code>defaultEnabled: false</code> in <code>plugin.json</code> oder einem Marketplace-Eintrag deklarieren, sodass sie installiert werden, ohne sich einzuschalten, bis Sie sie aktivieren</div>

111 <div>Vim-Modus: <code>/</code> im NORMAL-Modus öffnet die umgekehrte Verlaufssuche, passend zu Bash und Zsh vi-mode</div>111 <div>Vim-Modus: <code>/</code> im NORMAL-Modus öffnet die umgekehrte Verlaufssuche, passend zu Bash und Zsh vi-mode</div>

112 <div>Die Streaming-Tool-Ausführung ist jetzt immer aktiviert, auch mit deaktivierter Telemetrie und auf Bedrock, Vertex und Foundry</div>112 <div>Die Streaming-Tool-Ausführung ist jetzt immer aktiviert, auch mit deaktivierter Telemetrie und auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry</div>

113 <div><code>←←</code> zum Öffnen der Agents-Ansicht funktioniert jetzt auf Bedrock, Vertex, Foundry und mit deaktivierter Telemetrie</div>113 <div><code>←←</code> zum Öffnen der Agents-Ansicht funktioniert jetzt auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und mit deaktivierter Telemetrie</div>

114 <div>Claude in Chrome: Wählen Sie, welcher verbundene Browser verwendet werden soll, über <code>/chrome</code> → „Browser auswählen…" oder im Chat, wenn eine Browser-Aktion mit mehreren verbundenen ausgeführt wird</div>114 <div>Claude in Chrome: Wählen Sie, welcher verbundene Browser verwendet werden soll, über <code>/chrome</code> → „Browser auswählen…" oder im Chat, wenn eine Browser-Aktion mit mehreren verbundenen ausgeführt wird</div>

115 <div><code>claude mcp list</code> und <code>claude mcp get</code> zeigen jetzt nicht genehmigte <code>.mcp.json</code>-Server als ausstehende Genehmigung an, anstatt sie automatisch zu genehmigen und zu verbinden, wenn die Ausgabe weitergeleitet wird</div>115 <div><code>claude mcp list</code> und <code>claude mcp get</code> zeigen jetzt nicht genehmigte <code>.mcp.json</code>-Server als ausstehende Genehmigung an, anstatt sie automatisch zu genehmigen und zu verbinden, wenn die Ausgabe weitergeleitet wird</div>

116 </div>116 </div>

Details

4 4 

5# Woche 23 · 1.–5. Juni 20265# Woche 23 · 1.–5. Juni 2026

6 6 

7> Führen Sie den Auto-Modus auf Bedrock, Vertex und Foundry aus, fordern Sie vor dem Schreiben von Dateien auf, die Code im acceptEdits-Modus ausführen können, listen Sie installierte Plugins mit /plugin list auf, und erfordern Sie einen genehmigten Versionsbereich für verwaltete Bereitstellungen.7> Führen Sie den Auto-Modus auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry aus, fordern Sie vor dem Schreiben von Dateien auf, die Code im acceptEdits-Modus ausführen können, listen Sie installierte Plugins mit /plugin list auf, und erfordern Sie einen genehmigten Versionsbereich für verwaltete Bereitstellungen.

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>Releases <a href="/docs/de/changelog#2-1-158">v2.1.158 → v2.1.165</a></span>10 <span>Releases <a href="/docs/de/changelog#2-1-158">v2.1.158 → v2.1.165</a></span>


13 13 

14<div className="digest-feature">14<div className="digest-feature">

15 <div className="digest-feature-header">15 <div className="digest-feature-header">

16 <span className="digest-feature-title">Auto-Modus auf Bedrock, Vertex und Foundry</span>16 <span className="digest-feature-title">Auto-Modus auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry</span>

17 <span className="digest-feature-pill">v2.1.158</span>17 <span className="digest-feature-pill">v2.1.158</span>

18 </div>18 </div>

19 19 

20 <p className="digest-feature-lede">Der Auto-Modus ist jetzt auf Bedrock, Vertex und Foundry für Opus 4.7 und Opus 4.8 verfügbar und ersetzt Berechtigungsaufforderungen durch Sicherheitsprüfungen im Hintergrund bei Drittanbieter-Providern. Aktivieren Sie ihn durch Setzen von <code>CLAUDE\_CODE\_ENABLE\_AUTO\_MODE=1</code>.</p>20 <p className="digest-feature-lede">Der Auto-Modus ist jetzt auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry für Opus 4.7 und Opus 4.8 verfügbar und ersetzt Berechtigungsaufforderungen durch Sicherheitsprüfungen im Hintergrund bei Drittanbieter-Providern. Aktivieren Sie ihn durch Setzen von <code>CLAUDE\_CODE\_ENABLE\_AUTO\_MODE=1</code>.</p>

21 21 

22 <p className="digest-feature-try">Aktivieren Sie ihn bei einem Drittanbieter-Provider und wechseln Sie dann mit Shift+Tab zum Auto-Modus:</p>22 <p className="digest-feature-try">Aktivieren Sie ihn bei einem Drittanbieter-Provider und wechseln Sie dann mit Shift+Tab zum Auto-Modus:</p>

23 23 


25 export CLAUDE_CODE_ENABLE_AUTO_MODE=125 export CLAUDE_CODE_ENABLE_AUTO_MODE=1

26 ```26 ```

27 27 

28 <a className="digest-feature-link" href="/docs/de/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry">Auto-Modus bei Drittanbieter-Providern aktivieren</a>28 <a className="digest-feature-link" href="/docs/de/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry">Auto-Modus bei Drittanbieter-Providern aktivieren</a>

29</div>29</div>

30 30 

31<div className="digest-feature">31<div className="digest-feature">

Details

82 <div>API-Verbindungsabbrüche während des Denkens werden nun automatisch wiederholt, anstatt „Verbindung während des Denkens geschlossen" anzuzeigen</div>82 <div>API-Verbindungsabbrüche während des Denkens werden nun automatisch wiederholt, anstatt „Verbindung während des Denkens geschlossen" anzuzeigen</div>

83 <div>Mit <code>CLAUDE\_CODE\_EXPERIMENTAL\_AGENT\_TEAMS=1</code> gesetzt, hat jede Sitzung ein implizites Team, daher können Sie Teamkollegen direkt mit dem Parameter <code>name</code> des Agent-Tools spawnen</div>83 <div>Mit <code>CLAUDE\_CODE\_EXPERIMENTAL\_AGENT\_TEAMS=1</code> gesetzt, hat jede Sitzung ein implizites Team, daher können Sie Teamkollegen direkt mit dem Parameter <code>name</code> des Agent-Tools spawnen</div>

84 <div>Skills in verschachtelten <code>.claude/skills</code>-Verzeichnissen werden geladen, wenn Sie an Dateien dort arbeiten; bei einem Namenskonflikt wird der verschachtelte Skill als `<dir>:<name>` angezeigt, damit beide verfügbar bleiben</div>84 <div>Skills in verschachtelten <code>.claude/skills</code>-Verzeichnissen werden geladen, wenn Sie an Dateien dort arbeiten; bei einem Namenskonflikt wird der verschachtelte Skill als `<dir>:<name>` angezeigt, damit beide verfügbar bleiben</div>

85 <div>Behoben: Prompt Caching liest nicht auf einer benutzerdefinierten <code>ANTHROPIC\_BASE\_URL</code> und auf Foundry</div>85 <div>Behoben: Prompt Caching liest nicht auf einer benutzerdefinierten <code>ANTHROPIC\_BASE\_URL</code> und auf Microsoft Foundry</div>

86 <div>Behoben: Write und Edit erzeugen Null-Byte- oder abgeschnittene Dateien auf Netzlaufwerken und Cloud-synchronisierten Ordnern</div>86 <div>Behoben: Write und Edit erzeugen Null-Byte- oder abgeschnittene Dateien auf Netzlaufwerken und Cloud-synchronisierten Ordnern</div>

87 </div>87 </div>

88</div>88</div>

workflows.md +29 −3

Details

9{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}9{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}

10 10 

11<Note>11<Note>

12 Dynamische Workflows erfordern Claude Code v2.1.154 oder später und sind auf allen bezahlten Plänen, mit Anthropic API-Zugriff und auf Amazon Bedrock, Google Cloud Vertex AI und Microsoft Foundry verfügbar. Aktivieren Sie sie auf Pro über die Zeile „Dynamic workflows" in `/config`.12 Dynamische Workflows erfordern Claude Code v2.1.154 oder später und sind auf allen bezahlten Plänen, mit Anthropic API-Zugriff und auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry verfügbar. Aktivieren Sie sie auf Pro über die Zeile „Dynamic workflows" in `/config`.

13</Note>13</Note>

14 14 

15Ein dynamischer Workflow ist ein JavaScript-Skript, das [Subagenten](/de/sub-agents) im großen Maßstab orchestriert. Claude schreibt das Skript für die Aufgabe, die Sie beschreiben, und eine Laufzeit führt es im Hintergrund aus, während Ihre Sitzung reaktionsschnell bleibt.15Ein dynamischer Workflow ist ein JavaScript-Skript, das [Subagenten](/de/sub-agents) im großen Maßstab orchestriert. Claude schreibt das Skript für die Aufgabe, die Sie beschreiben, und eine Laufzeit führt es im Hintergrund aus, während Ihre Sitzung reaktionsschnell bleibt.


148/effort ultracode148/effort ultracode

149```149```

150 150 

151Um eine Sitzung mit bereits aktiviertem Ultracode zu starten, starten Sie mit `claude --effort ultracode`. Erfordert Claude Code v2.1.203 oder später.

152 

151Mit 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.153Mit 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.

152 154 

153Ultracode dauert für die aktuelle Sitzung und wird zurückgesetzt, wenn Sie eine neue starten. Gehen Sie mit `/effort high` zurück, wenn Sie zur Routinearbeit zurückkehren. Es ist auf Modellen verfügbar, die `xhigh` [Anstrengung](/de/model-config#adjust-effort-level) unterstützen; auf anderen Modellen bietet das `/effort`-Menü es nicht an.155Ultracode dauert für die aktuelle Sitzung und wird zurückgesetzt, wenn Sie eine neue starten. Gehen Sie mit `/effort high` zurück, wenn Sie zur Routinearbeit zurückkehren. Es ist auf Modellen verfügbar, die `xhigh` [Anstrengung](/de/model-config#adjust-effort-level) unterstützen; auf anderen Modellen bietet das `/effort`-Menü es nicht an.


194 196 

195Drücken Sie Enter zum Speichern. Der Workflow wird in zukünftigen Sitzungen von beiden Orten aus als `/<name>` ausgeführt.197Drücken Sie Enter zum Speichern. Der Workflow wird in zukünftigen Sitzungen von beiden Orten aus als `/<name>` ausgeführt.

196 198 

197{/* min-version: 2.1.178 */}Ab v2.1.178 schreibt das Speichern am Projektort in das nächste `.claude/workflows/`-Verzeichnis, das bereits zwischen Ihrem Arbeitsverzeichnis und dem Repository-Root vorhanden ist, oder zum Repository-Root, wenn noch keines vorhanden ist. Projekt-Workflows werden auch aus jedem `.claude/workflows/` entlang dieses Pfads geladen, und wenn mehr als einer denselben Namen definiert, führt Claude Code denjenigen aus, der dem Arbeitsverzeichnis am nächsten ist.199{/* min-version: 2.1.178 */}In einem Monorepo mit mehreren `.claude/`-Verzeichnissen können Sie Workflows neben dem Paket speichern, auf das sie sich beziehen. Ab v2.1.178 schreibt das Speichern am Projektort in das nächste `.claude/workflows/`-Verzeichnis, das bereits zwischen Ihrem Arbeitsverzeichnis und dem Repository-Root vorhanden ist, oder zum Repository-Root, wenn noch keines vorhanden ist. Projekt-Workflows werden auch aus jedem `.claude/workflows/` entlang dieses Pfads geladen, und wenn mehr als einer denselben Namen definiert, führt Claude Code denjenigen aus, der dem Arbeitsverzeichnis am nächsten ist.

198 200 

199Wenn ein Projekt-Workflow und ein persönlicher Workflow denselben Namen teilen, wird der Projekt-Workflow ausgeführt.201Wenn ein Projekt-Workflow und ein persönlicher Workflow denselben Namen teilen, wird der Projekt-Workflow ausgeführt.

200 202 


346 348 

347Ein Workflow spawnt viele Agenten, sodass eine einzelne Ausführung bedeutend mehr Token verwenden kann als die Bearbeitung der gleichen Aufgabe in einem Gespräch. Ausführungen zählen zur Nutzung und zu Ratenlimits Ihres Plans wie jede andere Sitzung.349Ein Workflow spawnt viele Agenten, sodass eine einzelne Ausführung bedeutend mehr Token verwenden kann als die Bearbeitung der gleichen Aufgabe in einem Gespräch. Ausführungen zählen zur Nutzung und zu Ratenlimits Ihres Plans wie jede andere Sitzung.

348 350 

349Um die Ausgaben vor der Verpflichtung zu einer großen Aufgabe zu schätzen, führen Sie den Workflow zunächst auf einem kleinen Ausschnitt aus: ein Verzeichnis statt des gesamten Repositorys oder eine enge Frage statt einer breiten. Die `/workflows`-Ansicht zeigt die Token-Nutzung jedes Agenten während der Ausführung an, und Sie können die Ausführung dort jederzeit beenden, ohne abgeschlossene Arbeiten zu verlieren. Die Laufzeit-[Agent-Limits](#behavior-and-limits) begrenzen, wie viele Agenten eine einzelne Ausführung spawnen kann, was die Kosten eines unkontrollierten Skripts begrenzt.351Um die Ausgaben vor der Verpflichtung zu einer großen Aufgabe zu schätzen, führen Sie den Workflow zunächst auf einem kleinen Ausschnitt aus: ein Verzeichnis statt des gesamten Repositorys oder eine enge Frage statt einer breiten. Die `/workflows`-Ansicht zeigt die Token-Nutzung jedes Agenten während der Ausführung an, und Sie können die Ausführung dort jederzeit beenden, ohne abgeschlossene Arbeiten zu verlieren. Die Laufzeit-[Agent-Limits](#behavior-and-limits) begrenzen, wie viele Agenten eine einzelne Ausführung spawnen kann, was die Kosten eines unkontrollierten Skripts begrenzt. Um jeden Durchlauf standardmäßig kleiner zu halten, [legen Sie eine Größenrichtlinie fest](#set-a-size-guideline) in `/config`.

352 

353Claude Code kennzeichnet auch eine Ausführung, die ungewöhnlich groß wird. Wenn ein Workflow mehr als 25 Agenten plant oder seine projizierte Token-Gesamtzahl 1,5 Millionen überschreitet, zeigt die Fortschrittszeile im Aufgabenpanel unter dem Eingabefeld eine `Large workflow`-Warnung an. Die Warnung verweist Sie auf [`/workflows`](#watch-the-run), wo Sie die Ausführung beenden können. Erfordert Claude Code v2.1.203 oder später.

354 

355Die Warnung ist informativ: Sie pausiert oder begrenzt die Ausführung nicht. Zwei Einstellungen ändern sich, wenn Sie sie sehen:

356 

357* Wenn Sie [eine Größenrichtlinie festlegen](#set-a-size-guideline), ersetzt die Agentenzahl der Richtlinie den Schwellenwert von 25 Agenten.

358* Sitzungen mit [ultracode](#let-claude-decide-with-ultracode) aktiviert zeigen die Warnung nicht an, da das Aktivieren von ultracode Sie bereits für große Ausführungen anmeldet.

350 359 

351Jeder Agent in einem Workflow verwendet das Modell Ihrer Sitzung, es sei denn, das Skript leitet eine Phase zu einem anderen weiter. Um die Modellkosten zu kontrollieren:360Jeder Agent in einem Workflow verwendet das Modell Ihrer Sitzung, es sei denn, das Skript leitet eine Phase zu einem anderen weiter. Um die Modellkosten zu kontrollieren:

352 361 

353* Überprüfen Sie `/model` vor einer großen Ausführung, wenn Sie normalerweise zu einem kleineren Modell für Routinearbeit wechseln362* Überprüfen Sie `/model` vor einer großen Ausführung, wenn Sie normalerweise zu einem kleineren Modell für Routinearbeit wechseln

354* Bitten Sie Claude, ein kleineres Modell für Phasen zu verwenden, die nicht das stärkste benötigen, wenn Sie die Aufgabe beschreiben363* Bitten Sie Claude, ein kleineres Modell für Phasen zu verwenden, die nicht das stärkste benötigen, wenn Sie die Aufgabe beschreiben

355 364 

365<h3 id="set-a-size-guideline">

366 Legen Sie eine Größenrichtlinie fest

367</h3>

368 

369Die Einstellung „Dynamic workflow size" in `/config` hält die Workflows, die Claude schreibt, standardmäßig in einem kleineren Maßstab. Claude Code sendet die Einstellung an Claude als Ratschlag, sodass ein Prompt, der einen anderen Maßstab fordert, diese Einstellung immer noch überschreibt. Erfordert Claude Code v2.1.202 oder später.

370 

371Jeder Wert legt die Agentenzahl fest, auf die Claude in den von ihm geschriebenen Skripten abzielt.

372 

373| Wert | An Claude gesendete Anleitung |

374| :------------- | :-------------------------------------------------- |

375| `unrestricted` | Keine Richtlinie. Dies ist die Standardeinstellung. |

376| `small` | Ziel: weniger als 5 Agenten. |

377| `medium` | Ziel: weniger als 15 Agenten. |

378| `large` | Ziel: weniger als 50 Agenten. |

379 

380Änderungen werden beim nächsten Prompt wirksam. Die [Laufzeit-Agent-Limits](#behavior-and-limits) gelten weiterhin unabhängig von der Einstellung.

381 

356<h3 id="turn-workflows-off">382<h3 id="turn-workflows-off">

357 Schalten Sie Workflows aus383 Schalten Sie Workflows aus

358</h3>384</h3>

worktrees.md +6 −0

Details

40 40 

41Bevor Sie `--worktree` interaktiv in einem Verzeichnis zum ersten Mal verwenden, akzeptieren Sie den Dialog zum Vertrauen des Arbeitsbereichs, indem Sie `claude` einmal in diesem Verzeichnis ausführen. Wenn das Vertrauen noch nicht akzeptiert wurde, beendet sich `--worktree` mit einem Fehler und fordert Sie auf, zuerst `claude` im Verzeichnis auszuführen. Nicht-interaktive Ausführungen mit `-p` überspringen die [Vertrauensprüfung](/de/security), sodass `claude -p --worktree` ohne diese fortfährt.41Bevor Sie `--worktree` interaktiv in einem Verzeichnis zum ersten Mal verwenden, akzeptieren Sie den Dialog zum Vertrauen des Arbeitsbereichs, indem Sie `claude` einmal in diesem Verzeichnis ausführen. Wenn das Vertrauen noch nicht akzeptiert wurde, beendet sich `--worktree` mit einem Fehler und fordert Sie auf, zuerst `claude` im Verzeichnis auszuführen. Nicht-interaktive Ausführungen mit `-p` überspringen die [Vertrauensprüfung](/de/security), sodass `claude -p --worktree` ohne diese fortfährt.

42 42 

43Wenn Claude Code beim Start nicht in das Worktree-Verzeichnis wechseln kann, beispielsweise weil ein [`WorktreeCreate`-Hook](/de/hooks#worktreecreate) etwas anderes als das erstellte Verzeichnis ausgegeben hat oder weil das Verzeichnis nach der Einrichtung gelöscht wurde, gibt Claude Code einen Fehler aus, der den Pfad benennt, und beendet sich mit Code 1. Vor v2.1.205 stürzte dies die Sitzung ab, und mit `-p` stagnierte es etwa 30 Sekunden lang, bevor es mit Code 0 beendet wurde.

44 

45{/* min-version: 2.1.200 */}Plugins, die im [Projektbereich](/de/plugins-reference#plugin-installation-scopes) aus dem Haupt-Checkout installiert sind, werden auch in Worktrees desselben Repositories geladen, sodass Sie sie nicht pro Worktree neu installieren müssen. Dies gilt, ob Sie den Worktree mit `--worktree` oder mit `git worktree add` erstellen. Erfordert Claude Code v2.1.200 oder später.

46 

43<Tip>47<Tip>

44 Fügen Sie `.claude/worktrees/` zu Ihrer `.gitignore` hinzu, damit Worktree-Inhalte nicht als nicht verfolgte Dateien in Ihrem Haupt-Checkout angezeigt werden.48 Fügen Sie `.claude/worktrees/` zu Ihrer `.gitignore` hinzu, damit Worktree-Inhalte nicht als nicht verfolgte Dateien in Ihrem Haupt-Checkout angezeigt werden.

45</Tip>49</Tip>


106 110 

107Während ein Agent ausgeführt wird, führt Claude `git worktree lock` auf seinem Worktree aus, damit eine gleichzeitige Bereinigung ihn nicht entfernen kann. Die Sperre wird freigegeben, wenn der Agent beendet wird. Um einen Worktree zu bereinigen, den die Bereinigung beibehält, führen Sie `git worktree remove` aus und fügen Sie `--force` hinzu, wenn der Worktree nicht committete Änderungen oder nicht verfolgte Dateien hat.111Während ein Agent ausgeführt wird, führt Claude `git worktree lock` auf seinem Worktree aus, damit eine gleichzeitige Bereinigung ihn nicht entfernen kann. Die Sperre wird freigegeben, wenn der Agent beendet wird. Um einen Worktree zu bereinigen, den die Bereinigung beibehält, führen Sie `git worktree remove` aus und fügen Sie `--force` hinzu, wenn der Worktree nicht committete Änderungen oder nicht verfolgte Dateien hat.

108 112 

113Unter Windows entfernt Claude Code vor dem Entfernen eines Worktrees alle NTFS-Junctions oder Verzeichnis-Symlinks in beliebiger Tiefe darin als Link-Eintrag, sodass das Entfernen des Worktrees nicht die Dateien löscht, auf die ein Link verweist. Vor v2.1.205 entfernte Claude Code nur Links auf oberster Ebene als Link-Einträge, und das Entfernen eines Worktrees mit einer Junction in einem Unterverzeichnis könnte den Inhalt des Verzeichnisses löschen, auf das der Link außerhalb des Worktrees verweist.

114 

109<h2 id="manage-worktrees-manually">115<h2 id="manage-worktrees-manually">

110 Worktrees manuell verwalten116 Worktrees manuell verwalten

111</h2>117</h2>

Details

19* [Serververwaltete Einstellungen](/de/server-managed-settings)19* [Serververwaltete Einstellungen](/de/server-managed-settings)

20* Audit-Protokolle20* Audit-Protokolle

21 21 

22ZDR für Claude Code auf Claude for Enterprise gilt nur für die direkte Plattform von Anthropic. Für Claude-Bereitstellungen auf Amazon Bedrock, Google Vertex AI oder Microsoft Foundry beachten Sie die Datenspeicherungsrichtlinien dieser Plattformen.22ZDR für Claude Code auf Claude for Enterprise gilt nur für die direkte Plattform von Anthropic. Für Claude-Bereitstellungen auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry beachten Sie die Datenspeicherungsrichtlinien dieser Plattformen.

23 23 

24<h2 id="zdr-scope">24<h2 id="zdr-scope">

25 ZDR-Umfang25 ZDR-Umfang