Documentation — Spybara

agent-sdk/agent-loop.md +1 −1

Details

325 325

326Ein paar Strategien für langfristig laufende Agenten:326Ein paar Strategien für langfristig laufende Agenten:

327 327

328* **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](/docs/de/agent-sdk/subagents#what-subagents-inherit) für Details.328* **Verwenden Sie Subagenten für Teilaufgaben.** Jeder Subagent startet mit einer neuen Konversation (kein vorheriger Nachrichtenverlauf, er lädt jedoch seinen eigenen System-Prompt und Kontext auf Projektebene wie CLAUDE.md). Er sieht die Turns des übergeordneten Agenten nicht, und nur seine abschließende Antwort wird an den übergeordneten Agenten zurückgegeben. Der Kontext des Hauptagenten wächst um diese Zusammenfassung, nicht um das vollständige Transkript der Teilaufgabe. Siehe [Was Subagenten erben](/docs/de/agent-sdk/subagents#what-subagents-inherit) für Details.

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

330* **Beobachten Sie MCP-Server-Kosten.** [MCP tool search](/docs/de/agent-sdk/mcp#mcp-tool-search) schiebt MCP-Werkzeugschemas standardmäßig auf und lädt sie bei Bedarf. Wenn die Werkzeugsuche ausgeschaltet ist oder auf vorherige Laden auf nicht unterstützten Modellen und bestimmten Plattformen zurückgefallen ist, 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. Siehe [Configure tool search](/docs/de/agent-sdk/tool-search#configure-tool-search) für die Konfigurationen, bei denen das Fallback angewendet wird.330* **Beobachten Sie MCP-Server-Kosten.** [MCP tool search](/docs/de/agent-sdk/mcp#mcp-tool-search) schiebt MCP-Werkzeugschemas standardmäßig auf und lädt sie bei Bedarf. Wenn die Werkzeugsuche ausgeschaltet ist oder auf vorherige Laden auf nicht unterstützten Modellen und bestimmten Plattformen zurückgefallen ist, 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. Siehe [Configure tool search](/docs/de/agent-sdk/tool-search#configure-tool-search) für die Konfigurationen, bei denen das Fallback angewendet wird.

331* **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.331* **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.

agent-sdk/cost-tracking.md +144 −66

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# Kosten und Nutzung verfolgen~~5# Kosten und Nutzung nachverfolgen

6 6

~~7> Erfahren Sie, wie Sie die Token-Nutzung verfolgen, Kosten schätzen und Prompt Caching mit dem Claude Agent SDK konfigurieren.~~7> Erfahren Sie, wie Sie mit dem Claude Agent SDK die Token-Nutzung nachverfolgen, Kosten schätzen und Prompt-Caching konfigurieren.

8 8

9Das Claude Agent SDK bietet detaillierte Token-Nutzungsinformationen für jede Interaktion mit Claude. Dieser Leitfaden erklärt, wie Sie die Nutzung ordnungsgemäß verfolgen und die Kostenberichterstattung verstehen, besonders bei parallelen Tool-Verwendungen und mehrstufigen Gesprächen.9Das Claude Agent SDK liefert detaillierte Informationen zur Token-Nutzung für jede Interaktion mit Claude. Dieser Leitfaden erklärt, wie Sie die Nutzung korrekt nachverfolgen und die Kostenberichte verstehen, insbesondere bei paralleler Tool-Nutzung und mehrstufigen Konversationen.

10 10

~~11Für die vollständige API-Dokumentation siehe die [TypeScript SDK-Referenz](/docs/de/agent-sdk/typescript) und [Python SDK-Referenz](/docs/de/agent-sdk/python).~~11Die vollständige API-Dokumentation finden Sie in der [TypeScript SDK-Referenz](/docs/de/agent-sdk/typescript) und der [Python SDK-Referenz](/docs/de/agent-sdk/python).

12 12

13<Warning>13<Warning>

14 Die Felder `total_cost_usd` und `costUSD` sind clientseitige Schätzungen, keine verbindlichen Abrechnungsdaten. Das SDK berechnet sie lokal aus einer Preistabelle, die zur Build-Zeit gebündelt wird, daher können sie von dem abweichen, was Sie tatsächlich abgerechnet bekommen, wenn:14 Die Felder `total_cost_usd` und `costUSD` sind clientseitige Schätzungen und keine verbindlichen Abrechnungsdaten. Das SDK berechnet sie lokal anhand einer Preistabelle, die zum Build-Zeitpunkt eingebunden wird, sofern keine [`modelPricing`](/docs/de/settings-reference#modelpricing)-Tabelle aktiv ist. Sie können von dem abweichen, was Ihnen tatsächlich in Rechnung gestellt wird, wenn:

15 15

16 * sich die Preise ändern16 * sich die Preise ändern

17 * die installierte SDK-Version ein Modell nicht erkennt17 * die installierte SDK-Version ein Modell nicht erkennt

~~18 * Abrechnungsregeln gelten, die der Client nicht modellieren kann~~18 * Abrechnungsregeln gelten, die der Client nicht abbilden kann

19 19

20 Verwenden Sie diese Felder für Entwicklungseinblicke und ungefähre Budgetierung. Für verbindliche Abrechnung verwenden Sie die [Usage and Cost API](https://platform.claude.com/docs/en/build-with-claude/usage-cost-api) oder die Seite „Nutzung" in der [Claude Console](https://platform.claude.com/usage). Berechnen Sie Endbenutzer nicht und treffen Sie keine finanziellen Entscheidungen basierend auf diesen Feldern.20 Eine Abrechnungsregel, die das SDK abbildet, ist die [Preisgestaltung für Datenresidenz](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing). Wenn das `usage`-Feld einer Antwort `inference_geo: "us"` meldet, multipliziert das SDK den Listenpreis der Token dieser Antwort mit 1,1. Gebühren pro Anfrage, etwa für die Websuche, werden nicht multipliziert. Erfordert TypeScript Agent SDK v0.3.239 oder höher bzw. Python Agent SDK v0.2.144 oder höher.

22 Verwenden Sie diese Felder für Einblicke während der Entwicklung und für eine ungefähre Budgetplanung. Für verbindliche Abrechnungsdaten nutzen Sie die [Usage and Cost API](https://platform.claude.com/docs/en/build-with-claude/usage-cost-api) oder die Seite „Usage“ in der [Claude Console](https://platform.claude.com/usage). Stellen Sie Endnutzern keine Beträge auf Grundlage dieser Felder in Rechnung und treffen Sie keine finanziellen Entscheidungen auf ihrer Basis.

21</Warning>23</Warning>

22 24

23<h2 id="understand-token-usage">25<h2 id="understand-token-usage">

24 Token-Nutzung verstehen26 Token-Nutzung verstehen

25</h2>27</h2>

26 28

~~27Die TypeScript- und Python-SDKs stellen die gleichen Nutzungsdaten mit unterschiedlichen Feldnamen bereit:~~29Die TypeScript- und Python-SDKs stellen dieselben Nutzungsdaten mit unterschiedlichen Feldnamen bereit:

31* **TypeScript** bietet Token-Aufschlüsselungen pro Schritt für jede Assistenten-Nachricht (`message.message.id`, `message.message.usage`), Kosten pro Modell über `modelUsage` in der Ergebnisnachricht sowie eine kumulierte Gesamtsumme in der Ergebnisnachricht.

32* **Python** bietet Token-Aufschlüsselungen pro Schritt für jede Assistenten-Nachricht als `message.usage` und `message.message_id`, Kosten pro Modell über `model_usage` in der Ergebnisnachricht sowie die kumulierte Gesamtsumme in der Ergebnisnachricht als `total_cost_usd`.

28 33

29* **TypeScript** bietet Token-Aufschlüsselungen pro Schritt auf jeder Assistenten-Nachricht (`message.message.id`, `message.message.usage`), Kosten pro Modell über `modelUsage` auf der Ergebnis-Nachricht und eine kumulative Summe auf der Ergebnis-Nachricht.34Beide SDKs verwenden dasselbe zugrunde liegende Kostenmodell und bieten dieselbe Granularität. Der Unterschied liegt in der Benennung der Felder und darin, wo die Nutzung pro Schritt verschachtelt ist.

30* **Python** bietet Token-Aufschlüsselungen pro Schritt auf jeder Assistenten-Nachricht (`message.usage`, `message.message_id`), Kosten pro Modell über `model_usage` auf der Ergebnis-Nachricht und die akkumulierte Summe auf der Ergebnis-Nachricht (`total_cost_usd` und `usage` dict).

31 35

32Beide SDKs verwenden das gleiche zugrunde liegende Kostenmodell und stellen die gleiche Granularität bereit. Der Unterschied liegt in der Feldbennung und wo die Nutzung pro Schritt verschachtelt ist.36Die Kostenverfolgung setzt voraus, dass Sie verstehen, wie das SDK Nutzungsdaten abgrenzt:

33 37

~~34Die Kostenverfolgung hängt davon ab, zu verstehen, wie das SDK Nutzungsdaten umfasst:~~38* **`query()`-Aufruf:** ein Aufruf der `query()`-Funktion des SDK. Ein einzelner Aufruf kann mehrere Schritte umfassen: Claude antwortet, verwendet Tools, erhält Ergebnisse und antwortet erneut. Jeder Aufruf erzeugt am Ende eine [`result`](/docs/de/agent-sdk/typescript#sdkresultmessage)-Nachricht, außer im [Streaming-Eingabemodus](/docs/de/agent-sdk/streaming-vs-single-mode), in dem ein `query()`-Aufruf mehrere Benutzer-Turns umfasst und jeder Turn seine eigene `result`-Nachricht ausgibt.

39* **Schritt:** ein einzelner Anfrage-/Antwort-Zyklus innerhalb eines `query()`-Aufrufs. Jeder Schritt erzeugt Assistenten-Nachrichten mit Token-Nutzung.

40* **Sitzung:** eine Reihe von `query()`-Aufrufen, die über eine Sitzungs-ID mithilfe der Option `resume` verknüpft sind. Die Ergebnisse eines fortgesetzten Aufrufs geben die gesamten Ausgaben der Sitzung an, nicht nur die des jeweiligen Aufrufs. Unter [Kosten über mehrere Aufrufe hinweg kumulieren](#accumulate-costs-across-multiple-calls) erfahren Sie, wie die Summen übernommen werden.

35 41

36* **`query()` Aufruf:** eine Invokation der `query()` Funktion des SDK. Ein einzelner Aufruf kann mehrere Schritte beinhalten (Claude antwortet, verwendet Tools, erhält Ergebnisse, antwortet erneut). Jeder Aufruf erzeugt am Ende eine [`result`](/docs/de/agent-sdk/typescript#sdkresultmessage) Nachricht.42Das folgende Diagramm zeigt den Nachrichtenstrom eines einzelnen `query()`-Aufrufs, wobei die Token-Nutzung bei jedem Schritt und die kumulierte Schätzung am Ende gemeldet werden:

~~37* **Schritt:** ein einzelner Request/Response-Zyklus innerhalb eines `query()` Aufrufs. Jeder Schritt erzeugt Assistenten-Nachrichten mit Token-Nutzung.~~

38* **Sitzung:** eine Serie von `query()` Aufrufen, die durch eine Sitzungs-ID verknüpft sind (mit der `resume` Option). Jeder `query()` Aufruf innerhalb einer Sitzung meldet seine eigenen Kosten unabhängig.

39 43

~~40Das folgende Diagramm zeigt den Nachrichtenstrom aus einem einzelnen `query()` Aufruf, mit Token-Nutzung, die bei jedem Schritt gemeldet wird, und der kumulativen Schätzung am Ende:~~44<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agent-sdk/message-usage-flow.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=68497aee338e01cc745323af7aea378e" className="dark:hidden" alt="Diagramm, das eine Abfrage zeigt, die zwei Schritte von Nachrichten erzeugt. Schritt 1 hat vier Assistenten-Nachrichten mit derselben ID und Nutzung (einmal zählen), Schritt 2 hat eine Assistenten-Nachricht mit einer neuen ID, und die abschließende Ergebnisnachricht zeigt die geschätzten total_cost_usd." width="760" height="520" data-path="images/agent-sdk/message-usage-flow.svg" />

41 45

42<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agent-sdk/message-usage-flow.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=68497aee338e01cc745323af7aea378e" alt="Diagramm, das eine Abfrage zeigt, die zwei Schritte von Nachrichten erzeugt. Schritt 1 hat vier Assistenten-Nachrichten, die die gleiche ID und Nutzung teilen (einmal zählen), Schritt 2 hat eine Assistenten-Nachricht mit einer neuen ID, und die endgültige Ergebnis-Nachricht zeigt die geschätzte total_cost_usd." width="760" height="520" data-path="images/agent-sdk/message-usage-flow.svg" />46<img src="https://mintcdn.com/claude-code/_xqph1dUOslCOwsj/images/agent-sdk/message-usage-flow-dark.svg?fit=max&auto=format&n=_xqph1dUOslCOwsj&q=85&s=8ea95085abc0a6b7f55ecef498bd4d14" className="hidden dark:block" alt="Diagramm, das eine Abfrage zeigt, die zwei Schritte von Nachrichten erzeugt. Schritt 1 hat vier Assistenten-Nachrichten mit derselben ID und Nutzung (einmal zählen), Schritt 2 hat eine Assistenten-Nachricht mit einer neuen ID, und die abschließende Ergebnisnachricht zeigt die geschätzten total_cost_usd." width="760" height="520" data-path="images/agent-sdk/message-usage-flow-dark.svg" />

43 47

44<Steps>48<Steps>

45 <Step title="Jeder Schritt erzeugt Assistenten-Nachrichten">49 <Step title="Jeder Schritt erzeugt Assistenten-Nachrichten">

46 Wenn Claude antwortet, sendet es eine oder mehrere Assistenten-Nachrichten. In TypeScript enthält jede Assistenten-Nachricht eine verschachtelte `BetaMessage` (zugänglich über `message.message`) mit einer `id` und einem [`usage`](https://platform.claude.com/docs/en/api/messages) Objekt mit Token-Zählungen (`input_tokens`, `output_tokens`). In Python stellt die `AssistantMessage` Dataclass die gleichen Daten direkt über `message.usage` und `message.message_id` bereit. Wenn Claude mehrere Tools in einer Runde verwendet, teilen alle Nachrichten in dieser Runde die gleiche ID, daher deduplizieren Sie nach ID, um Doppelzählungen zu vermeiden.50 Wenn Claude antwortet, sendet es eine oder mehrere Assistenten-Nachrichten. In TypeScript enthält jede Assistenten-Nachricht eine verschachtelte `BetaMessage` (Zugriff über `message.message`) mit einer `id` und einem [`usage`](https://platform.claude.com/docs/en/api/messages)-Objekt mit Token-Zählungen (`input_tokens`, `output_tokens`). In Python stellt die Dataclass `AssistantMessage` dieselben Daten direkt über `message.usage` und `message.message_id` bereit. Wenn Claude mehrere Tools in einem Turn verwendet, teilen alle Nachrichten in diesem Turn dieselbe ID. Deduplizieren Sie daher nach ID, um Doppelzählungen zu vermeiden.

47 </Step>51 </Step>

48 52

~~49 <Step title="Die Ergebnis-Nachricht bietet die kumulative Schätzung">~~53 <Step title="Die Ergebnisnachricht liefert die kumulierte Schätzung">

50 Wenn der `query()` Aufruf abgeschlossen ist, gibt das SDK eine Ergebnis-Nachricht mit `total_cost_usd` und kumulativer `usage` aus. Dies ist in TypeScript ([`SDKResultMessage`](/docs/de/agent-sdk/typescript#sdkresultmessage)) und Python ([`ResultMessage`](/docs/de/agent-sdk/python#resultmessage)) verfügbar. Wenn Sie mehrere `query()` Aufrufe tätigen (zum Beispiel in einer mehrstufigen Sitzung), spiegelt jedes Ergebnis nur die Kosten dieses einzelnen Aufrufs wider. Wenn Sie nur die geschätzte Summe benötigen, können Sie die Nutzung pro Schritt ignorieren und diesen einzelnen Wert lesen.54 Wenn der `query()`-Aufruf abgeschlossen ist, gibt das SDK eine Ergebnisnachricht mit `total_cost_usd` und kumulierter `usage` aus, typisiert als [`SDKResultMessage`](/docs/de/agent-sdk/typescript#sdkresultmessage) in TypeScript und [`ResultMessage`](/docs/de/agent-sdk/python#resultmessage) in Python. Wenn Sie nur die geschätzte Gesamtsumme benötigen, können Sie die Nutzung pro Schritt ignorieren und diesen einzelnen Wert auslesen.

56 Wenn Sie mehrere unabhängige `query()`-Aufrufe durchführen, spiegelt jedes Ergebnis nur die Kosten des jeweiligen Aufrufs wider. Ein Aufruf, der eine Sitzung fortsetzt, zählt auch die früheren Ausgaben der Sitzung mit.

58 Im Streaming-Eingabemodus gibt jeder Turn seine eigene Ergebnisnachricht aus. Unter [Kosten im Streaming-Eingabemodus verfolgen](#track-costs-in-streaming-input-mode) erfahren Sie, wie Sie in diesem Modus die Gesamtsummen der Aufrufe auslesen.

51 </Step>59 </Step>

52</Steps>60</Steps>

53 61

62<h2 id="track-costs-in-streaming-input-mode">

63 Kosten im Streaming-Eingabemodus verfolgen

64</h2>

66Im [Streaming-Eingabemodus](/docs/de/agent-sdk/streaming-vs-single-mode) umfasst ein einzelner `query()`-Aufruf mehrere Benutzer-Turns, und jeder Turn gibt seine eigene Ergebnisnachricht aus. Die Ergebnisfelder unterscheiden sich in ihrem Umfang:

68* **`usage`**: umfasst nur diesen Turn und darin nur die Hauptagentenschleife, nicht die Subagenten, die sie ausgeführt hat.

69* **`total_cost_usd` und `modelUsage` bzw. `model_usage` in Python**: enthalten die laufende Gesamtsumme für den gesamten bisherigen Aufruf sowie alle Ausgaben, die wiederhergestellt wurden, als der Aufruf eine Sitzung fortgesetzt hat.

71Lesen Sie in einem Aufruf, in dem Ihre App niemals `/clear`, `/reset` oder `/new` sendet, das neueste Ergebnis für die Gesamtsummen des Aufrufs, anstatt über alle Ergebnisse zu summieren.

73Die laufenden Gesamtsummen beginnen jedes Mal neu, wenn Ihre App einen dieser drei Befehle sendet, und innerhalb eines `query()`-Aufrufs setzt sie nichts anderes zurück. Drei Ergebnisse sind für Ihre Abrechnung relevant:

75* **Das eigene Ergebnis des `/clear`-Turns**: umfasst nur das, was seit dem Zurücksetzen ausgeführt wurde, und enthält eine neue `session_id`.

76* **Jedes spätere Ergebnis**: zählt ab diesem Zurücksetzen weiter.

77* **Das letzte Ergebnis vor jedem `/clear`**: enthält die Gesamtsumme für die Turns seit dem vorherigen Zurücksetzen.

79Um die Gesamtsumme des gesamten Aufrufs zu ermitteln, addieren Sie das letzte Ergebnis vor jedem `/clear` zum abschließenden Ergebnis des Aufrufs. Jedes andere Ergebnis, einschließlich des eigenen Ergebnisses des `/clear`-Turns, wird durch ein späteres ersetzt.

81In TypeScript gibt das SDK bei jedem Zurücksetzen außerdem eine [`SDKConversationResetMessage`](/docs/de/agent-sdk/typescript#sdkconversationresetmessage) aus, sodass Sie Zurücksetzungen im Stream erkennen können. In Python gibt das SDK entsprechend eine `ConversationResetMessage` aus. Vor Python SDK v0.2.137 hat der Python-Iterator diese Nachricht verworfen; zählen Sie die Zurücksetzungen bei diesen Versionen daher selbst anhand der `/clear`-Turns, die Ihre App sendet.

83`maxBudgetUsd` (TypeScript) bzw. `max_budget_usd` (Python) zählt nur die eigenen Ausgaben des Aufrufs: Aus einer fortgesetzten Sitzung wiederhergestellte Gesamtsummen werden nicht darauf angerechnet, und ein `/clear` lässt das Budget von vorne beginnen.

54<h2 id="get-the-total-cost-of-a-query">85<h2 id="get-the-total-cost-of-a-query">

~~55 Gesamtkosten einer Abfrage abrufen~~86 Die Gesamtkosten einer Abfrage ermitteln

56</h2>87</h2>

57 88

58Die Ergebnis-Nachricht ([TypeScript](/docs/de/agent-sdk/typescript#sdkresultmessage), [Python](/docs/de/agent-sdk/python#resultmessage)) markiert das Ende der Agent-Schleife für einen `query()`-Aufruf. Sie enthält `total_cost_usd`, die geschätzte kumulative Kosten über alle Schritte in diesem Aufruf. Dies funktioniert sowohl für erfolgreiche als auch für Fehler-Ergebnisse. Wenn Sie Sitzungen verwenden, um mehrere `query()`-Aufrufe zu tätigen, spiegelt jedes Ergebnis nur die Kosten dieses einzelnen Aufrufs wider.89Die Ergebnisnachricht, in TypeScript als [`SDKResultMessage`](/docs/de/agent-sdk/typescript#sdkresultmessage) und in Python als [`ResultMessage`](/docs/de/agent-sdk/python#resultmessage) typisiert, markiert das Ende der Agentenschleife für einen `query()`-Aufruf. Sie enthält `total_cost_usd`, die kumulierten geschätzten Kosten über alle Schritte dieses Aufrufs. Ein Aufruf, der eine Sitzung fortsetzt, zählt auch die früheren Ausgaben der Sitzung mit. Beim Auslesen des Werts gelten zwei Einschränkungen:

59 90

60Die drei Felder auf Ergebnis-Ebene unterscheiden sich darin, was sie zählen, wenn der Agent [Subagenten](/docs/de/agent-sdk/subagents) erzeugt. Verwenden Sie `modelUsage` oder `model_usage` in Python für die Gesamtbaum-Token-Abrechnung; das Feld `usage` unterschätzt, sobald Verschachtelung auftritt.91* In Python ist das Feld als optional typisiert. Prüfen Sie daher, dass es nicht `None` ist, bevor Sie es auslesen.

92* Sowohl Erfolgs- als auch Fehlerergebnisse enthalten es, allerdings kann das endgültige Ergebnis nach einem [Sitzungsabsturz](#recover-totals-after-a-session-crash) den Wert auf null gesetzt enthalten.

61 93

~~62| Feld | Subagenten-Aktivität |~~94Im Streaming-Eingabemodus lesen Sie die Aufrufsummen wie unter [Kosten im Streaming-Eingabemodus verfolgen](#track-costs-in-streaming-input-mode) beschrieben aus.

96Die drei Felder auf Ergebnisebene unterscheiden sich darin, was sie zählen, wenn der Agent [Subagenten](/docs/de/agent-sdk/subagents) startet. Verwenden Sie `modelUsage` bzw. `model_usage` in Python für die Token-Abrechnung über den gesamten Baum; das Feld `usage` zählt zu wenig, sobald eine Verschachtelung auftritt.

98| Feld | Aktivität von Subagenten |

63| - | - |99| - | - |

~~64| `usage` | Ausgeschlossen. Zählt nur die Agent-Schleife auf oberster Ebene, daher werden Token, die in Subagenten verbraucht werden, nicht hinzugefügt |~~100| `usage` | Ausgeschlossen. Zählt nur die Agentenschleife der obersten Ebene, sodass innerhalb von Subagenten verbrauchte Token nicht hinzugerechnet werden |

~~66| `modelUsage` / `model_usage` | Eingeschlossen. Zählt Subagenten-Anfragen zusammen mit der Schleife auf oberster Ebene, aufgeschlüsselt nach Modell |~~102| `modelUsage` / `model_usage` | Eingeschlossen. Zählt Anfragen von Subagenten zusammen mit der Schleife der obersten Ebene, aufgeschlüsselt nach Modell |

67 103

~~68Die folgenden Beispiele durchlaufen den Nachrichtenstrom aus einem `query()`-Aufruf und geben die Gesamtkosten aus, wenn die `result`-Nachricht ankommt:~~104Im [Einzelnachrichten-Eingabemodus](/docs/de/agent-sdk/streaming-vs-single-mode#single-message-input) wartet Claude Code, wenn am Ende des letzten Turns noch Subagenten im Hintergrund laufen, bis zu der unter [Hintergrundaufgaben beim Beenden](/docs/de/headless#background-tasks-at-exit) beschriebenen Obergrenze auf diese, bevor das Ergebnis ausgegeben wird. Die Werte `total_cost_usd`, `duration_api_ms` und `modelUsage` bzw. `model_usage` in Python des Ergebnisses schließen die während dieser Wartezeit geleistete Arbeit ein.

105

106Die folgenden Beispiele durchlaufen den Nachrichtenstrom eines `query()`-Aufrufs und geben die Gesamtkosten aus, sobald die `result`-Nachricht eintrifft:

69 107

70<CodeGroup>108<CodeGroup>

71 ```typescript TypeScript theme={null}109 ```typescript TypeScript theme={null}

98 print(f"Total cost: ${message.total_cost_usd or 0}")136 print(f"Total cost: ${message.total_cost_usd or 0}")

99 except Exception as error:137 except Exception as error:

100 # A single-shot query() raises after yielding an error result. If the138 # A single-shot query() raises after yielding an error result. If the

101 # failure was an error result, it still carried total_cost_usd and the139 # failure was an error result, the branch above has already run;

102 # branch above has already run; connection or process failures yield140 # connection or process failures yield no result message.

103 # no result message.

104 print(f"Session ended with an error: {error}")141 print(f"Session ended with an error: {error}")

105 142

106 143

108 ```145 ```

109</CodeGroup>146</CodeGroup>

110 147

148Um zu begrenzen, wie viel Subagenten zu `total_cost_usd` beitragen können, legen Sie für die Abfrage die [Limits für Tiefe, Parallelität und Ausgaben](/docs/de/agent-sdk/subagents#cap-subagent-depth-concurrency-and-spend) fest.

149

111<h2 id="track-per-step-and-per-model-usage">150<h2 id="track-per-step-and-per-model-usage">

112 Nutzung pro Schritt und pro Modell verfolgen151 Nutzung pro Schritt und pro Modell verfolgen

113</h2>152</h2>

114 153

115Die Beispiele in diesem Abschnitt verwenden TypeScript-Feldnamen. In Python sind die entsprechenden Felder [`AssistantMessage.usage`](/docs/de/agent-sdk/python#assistantmessage) und `AssistantMessage.message_id` für die Nutzung pro Schritt, und [`ResultMessage.model_usage`](/docs/de/agent-sdk/python#resultmessage) für Aufschlüsselungen pro Modell.154Die Beispiele in diesem Abschnitt verwenden TypeScript-Feldnamen. In Python sind die entsprechenden Felder [`AssistantMessage.usage`](/docs/de/agent-sdk/python#assistantmessage) und `AssistantMessage.message_id` für die Nutzung pro Schritt sowie [`ResultMessage.model_usage`](/docs/de/agent-sdk/python#resultmessage) für Aufschlüsselungen pro Modell.

116 155

117<h3 id="track-per-step-usage">156<h3 id="track-per-step-usage">

118 Nutzung pro Schritt verfolgen157 Nutzung pro Schritt verfolgen

119</h3>158</h3>

120 159

121Jede Assistenten-Nachricht enthält eine verschachtelte `BetaMessage` (zugänglich über `message.message`) mit einer `id` und einem `usage` Objekt mit Token-Zählungen. Wenn Claude Tools parallel verwendet, teilen mehrere Nachrichten die gleiche `id` mit identischen Nutzungsdaten. Verfolgen Sie, welche IDs Sie bereits gezählt haben, und überspringen Sie Duplikate, um aufgeblähte Summen zu vermeiden.160Jede Assistant-Nachricht enthält eine verschachtelte `BetaMessage` (Zugriff über `message.message`) mit einer `id` und einem `usage`-Objekt mit Token-Zählungen. Wenn Claude Tools parallel verwendet, teilen sich mehrere Nachrichten dieselbe `id` mit identischen Nutzungsdaten. Verfolgen Sie, welche IDs Sie bereits gezählt haben, und überspringen Sie Duplikate, um überhöhte Summen zu vermeiden.

122 161

123<Warning>162<Warning>

124 Parallele Tool-Aufrufe erzeugen mehrere Assistenten-Nachrichten, deren verschachtelte `BetaMessage` die gleiche `id` und identische Nutzung teilt. Deduplizieren Sie immer nach ID, um genaue Token-Zählungen pro Schritt zu erhalten.163 Die deduplizierten Werte pro Schritt sind für Eingabe- und Cache-Token genau. Das `output_tokens` pro Schritt ist ein Platzhalterwert, daher sollten Sie [die Ausgabe-Token aus der Ergebnisnachricht lesen](#read-output-tokens-from-the-result-message).

125</Warning>164</Warning>

126 165

127Das folgende Beispiel akkumuliert Input- und Output-Tokens über alle Schritte, zählt jede eindeutige Nachrichten-ID nur einmal:166Das folgende Beispiel summiert die Eingabe-Token über alle Schritte hinweg, wobei jede eindeutige Nachrichten-ID der Hauptschleife nur einmal gezählt und Nachrichten von Subagenten übersprungen werden. Die Gesamtzahl der Ausgabe-Token wird aus der Ergebnisnachricht gelesen, die die Hauptschleife abdeckt:

128 167

129```typescript theme={null}168```typescript theme={null}

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

131 170

132const seenIds = new Set<string>();171const seenIds = new Set<string>();

133let totalInputTokens = 0;172let totalInputTokens = 0;

134let totalOutputTokens = 0;173let resultOutputTokens = 0;

135 174

136try {175try {

137 for await (const message of query({ prompt: "Summarize this project" })) {176 for await (const message of query({ prompt: "Summarize this project" })) {

138 if (message.type === "assistant") {177 if (message.type === "assistant" && !message.parent_tool_use_id) {

139 const msgId = message.message.id;178 const msgId = message.message.id;

140 179

141 // Parallel tool calls share the same ID, only count once180 // Parallel tool calls share the same ID, only count once

142 if (!seenIds.has(msgId)) {181 if (!seenIds.has(msgId)) {

143 seenIds.add(msgId);182 seenIds.add(msgId);

144 totalInputTokens += message.message.usage.input_tokens;183 totalInputTokens += message.message.usage.input_tokens;

145 totalOutputTokens += message.message.usage.output_tokens;

146 }184 }

147 }185 }

186 if (message.type === "result") {

187 // Per-step output_tokens is a placeholder; the result message

188 // carries the accumulated output total.

189 resultOutputTokens = message.usage.output_tokens;

190 }

148 }191 }

149} catch (error) {192} catch (error) {

150 // A single-shot query() throws after yielding an error result, so the193 // A single-shot query() throws after yielding an error result, so the

151 // totals below still reflect the steps that ran before the failure.194 // input total below still reflects the steps that ran before the failure.

152 console.error(`Session ended with an error: ${error}`);195 console.error(`Session ended with an error: ${error}`);

153}196}

154 197

155console.log(`Steps: ${seenIds.size}`);198console.log(`Steps: ${seenIds.size}`);

156console.log(`Input tokens: ${totalInputTokens}`);199console.log(`Input tokens: ${totalInputTokens}`);

157console.log(`Output tokens: ${totalOutputTokens}`);200console.log(`Output tokens: ${resultOutputTokens}`);

158```201```

159 202

160<h3 id="break-down-usage-per-model">203<h3 id="break-down-usage-per-model">

161 Nutzung pro Modell aufschlüsseln204 Nutzung pro Modell aufschlüsseln

162</h3>205</h3>

163 206

164Die Ergebnis-Nachricht enthält [`modelUsage`](/docs/de/agent-sdk/typescript#modelusage), eine Zuordnung von Modellname zu Token-Zählungen und Kosten pro Modell. Dies ist nützlich, wenn Sie mehrere Modelle ausführen (zum Beispiel Haiku für Sub-Agenten und Opus für den Haupt-Agenten) und sehen möchten, wohin die Tokens gehen.207Die Ergebnisnachricht enthält [`modelUsage`](/docs/de/agent-sdk/typescript#modelusage), eine Zuordnung von Modellnamen zu Token-Zählungen und Kosten pro Modell. Dies ist nützlich, wenn Sie mehrere Modelle ausführen (zum Beispiel Haiku für Subagenten und Opus für den Hauptagenten) und sehen möchten, wohin die Token fließen.

208

209Das Feld `costBasis` jedes Eintrags gibt an, mit welcher Preistabelle die letzte Anfrage dieses Modells berechnet wurde: `list` für den Listenpreis, `managed` für eine [`modelPricing`](/docs/de/settings-reference#modelpricing)-Tabelle oder `unknown`, wenn keine der beiden auf die Modell-ID zutraf. Das Feld erfordert Claude Code v2.1.246 oder höher.

165 210

166Das folgende Beispiel führt eine Abfrage aus und gibt die Kosten und Token-Aufschlüsselung für jedes verwendete Modell aus:211Das folgende Beispiel führt eine Abfrage aus und gibt die Kosten- und Token-Aufschlüsselung für jedes verwendete Modell aus:

167 212

168```typescript theme={null}213```typescript theme={null}

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

189```234```

190 235

191<h2 id="accumulate-costs-across-multiple-calls">236<h2 id="accumulate-costs-across-multiple-calls">

192 Kosten über mehrere Aufrufe akkumulieren237 Kosten über mehrere Aufrufe hinweg akkumulieren

193</h2>238</h2>

194 239

195Jeder `query()` Aufruf gibt seinen eigenen `total_cost_usd` zurück. Das SDK bietet keine Sitzungs-Ebenen-Summe, daher müssen Sie, wenn Ihre Anwendung mehrere `query()` Aufrufe tätigt (zum Beispiel in einer mehrstufigen Sitzung oder über verschiedene Benutzer), die Summen selbst akkumulieren.240Jeder `query()`-Aufruf gibt in seinen Ergebnissen `total_cost_usd` zurück. Wie Sie die Werte kombinieren, hängt davon ab, ob die Aufrufe eine Sitzung gemeinsam nutzen:

241

242* **Unabhängige Aufrufe ohne die Option `resume` oder `continue`**: Jedes Ergebnis deckt nur den eigenen Aufruf ab, daher addieren Sie die Gesamtwerte selbst, wie es die folgenden Beispiele tun.

243* **Aufrufe, die dieselbe Sitzung fortsetzen**: Claude Code speichert die Gesamtwerte der Sitzung in ihrem [Transkript](/docs/de/sessions#where-transcripts-are-stored), wenn der Prozess normal beendet wird, und stellt sie wieder her, wenn ein späterer Aufruf die Sitzung fortsetzt oder forkt. Jedes Ergebnis enthält bereits die früheren Ausgaben der Sitzung. Lesen Sie das neueste Ergebnis, um den Gesamtwert der Sitzung zu erhalten; wenn Sie die Ergebnisse summieren, werden die wiederhergestellten Ausgaben doppelt gezählt. Vor v2.1.277 begannen die Gesamtwerte einer Sitzung, die Sie über das SDK oder `claude -p` fortgesetzt haben, bei null, sodass die Ergebnisse jedes Aufrufs nur diesen Aufruf abdeckten.

244

245Im Streaming-Eingabemodus lesen Sie den Gesamtwert jedes Aufrufs wie unter [Kosten im Streaming-Eingabemodus verfolgen](#track-costs-in-streaming-input-mode) beschrieben. Für einen Aufruf, der mit einem Absturz endete, siehe [Gesamtwerte nach einem Sitzungsabsturz wiederherstellen](#recover-totals-after-a-session-crash).

196 246

197Die folgenden Beispiele führen zwei `query()` Aufrufe nacheinander aus, addieren den `total_cost_usd` jedes Aufrufs zu einer laufenden Summe und geben sowohl die Kosten pro Aufruf als auch die kombinierten Kosten aus:247Die folgenden Beispiele führen zwei `query()`-Aufrufe nacheinander aus, addieren das `total_cost_usd` jedes Aufrufs zu einer laufenden Summe und geben sowohl die Kosten pro Aufruf als auch die kombinierten Kosten aus:

198 248

199<CodeGroup>249<CodeGroup>

200 ```typescript TypeScript theme={null}250 ```typescript TypeScript theme={null}

263 ```313 ```

264</CodeGroup>314</CodeGroup>

265 315

266<h2 id="handle-errors-caching-and-token-discrepancies">316<h2 id="handle-errors-caching-and-output-token-counts">

267 Fehler, Caching und Token-Diskrepanzen behandeln317 Fehler, Caching und Ausgabe-Token-Zählungen behandeln

268</h2>318</h2>

269 319

270Für genaue Kostenverfolgung müssen Sie fehlgeschlagene Gespräche, Cache-Token-Preisgestaltung und gelegentliche Berichterstattungsinkonsistenzen berücksichtigen.320Für eine genaue Kostenverfolgung sollten Sie die Platzhalter-Ausgabezählung bei Assistentennachrichten, die von einer fehlgeschlagenen Konversation verbrauchten Token und die Preise für Cache-Token berücksichtigen.

271 321

272<h3 id="resolve-output-token-discrepancies">322<h3 id="read-output-tokens-from-the-result-message">

273 Output-Token-Diskrepanzen auflösen323 Ausgabe-Token aus der Ergebnisnachricht lesen

274</h3>324</h3>

275 325

276In seltenen Fällen können Sie unterschiedliche `output_tokens` Werte für Nachrichten mit der gleichen ID beobachten. Wenn dies auftritt:326Claude Code erstellt jede Assistentennachricht aus der Nutzung, die die API zu Beginn der Antwort gemeldet hat. Daher ist `output_tokens` einer Nachricht nur die Zählung, die die API bei `message_start` gemeldet hatte, bevor die Antwort generiert wurde. Eine API-Antwort kann mehrere Assistentennachrichten erzeugen, und jede von ihnen enthält denselben Platzhalter.

277 327

2781. **Verwenden Sie den höchsten Wert:** die letzte Nachricht in einer Gruppe enthält typischerweise die genaue Summe.328Die API meldet die tatsächliche Ausgabezählung am Ende der Antwort, und Claude Code fügt sie der Ergebnisnachricht hinzu. Lesen Sie Ausgabe-Token aus `usage` des Ergebnisses oder aus `modelUsage` für eine Aufschlüsselung pro Modell.

2792. **Bevorzugen Sie die Ergebnis-Nachricht:** die `total_cost_usd` in der Ergebnis-Nachricht spiegelt die akkumulierte Schätzung des SDK über alle Schritte wider, daher ist sie zuverlässiger als die Summe der Werte pro Schritt selbst. Es ist immer noch eine Schätzung und kann von Ihrer tatsächlichen Rechnung abweichen.329

2803. **Melden Sie Inkonsistenzen:** reichen Sie Probleme im [Claude Code GitHub Repository](https://github.com/anthropics/claude-code/issues) ein.330Um zu beobachten, wie die Ausgabezählung einer Antwort während des Streamings wächst, setzen Sie `includePartialMessages` bzw. `include_partial_messages` in Python und lesen Sie `usage` aus jedem `message_delta`-Stream-Event, typisiert als [`SDKPartialAssistantMessage`](/docs/de/agent-sdk/typescript#sdkpartialassistantmessage) in TypeScript und [`StreamEvent`](/docs/de/agent-sdk/python#streamevent) in Python.

281 331

282<h3 id="track-costs-on-failed-conversations">332<h3 id="track-costs-on-failed-conversations">

283 Kosten bei fehlgeschlagenen Gesprächen verfolgen333 Kosten bei fehlgeschlagenen Konversationen verfolgen

284</h3>334</h3>

285 335

286Sowohl erfolgreiche als auch Fehler-Ergebnis-Nachrichten enthalten `usage` und `total_cost_usd`. Wenn ein Gespräch in der Mitte fehlschlägt, haben Sie immer noch Tokens bis zum Punkt des Fehlers verbraucht. Lesen Sie Kostendaten immer aus der Ergebnis-Nachricht, unabhängig von ihrem `subtype`.336Sowohl Erfolgs- als auch Fehler-Ergebnisnachrichten enthalten `usage` und `total_cost_usd`. In Python sind beide Felder als optional typisiert, prüfen Sie also, dass sie nicht `None` sind, bevor Sie sie lesen.

337

338Wenn eine Konversation mittendrin fehlschlägt, haben Sie bis zum Zeitpunkt des Fehlers trotzdem Token verbraucht. Lesen Sie Kostendaten aus jeder Ergebnisnachricht, unabhängig davon, ob ihr `subtype` `success` oder einer der Fehler-Subtypen ist. Bei einigen Fehlerergebnissen meldet `usage` weniger, als der Aufruf tatsächlich verbraucht hat:

339

340* **`error_during_execution` nach einem [Sitzungsabsturz](#recover-totals-after-a-session-crash)**: Alle Kostenfelder können auf null gesetzt sein.

341* **`error_max_budget_usd`**: `usage` lässt die Antwort aus, die das Budget überschritten hat, während `total_cost_usd` und `modelUsage` sie enthalten.

342

343Wenn Sie die Wahl haben, rechnen Sie auf Basis von `total_cost_usd` oder `modelUsage` statt `usage` ab.

344

345<h3 id="recover-totals-after-a-session-crash">

346 Summen nach einem Sitzungsabsturz wiederherstellen

347</h3>

348

349Wenn der Claude-Code-Prozess abstürzt, gibt er ein abschließendes `error_during_execution`-Ergebnis aus und beendet sich, sowohl im Single-Shot- als auch im Streaming-Eingabemodus. Dieses Ergebnis kann auf null gesetzte Werte für `usage`, `total_cost_usd` und `modelUsage` enthalten. Stellen Sie die Summen des Aufrufs daher aus dem wieder her, was davor eingetroffen ist. Schritt 1 stellt die vollständigen Summen wieder her, sofern ein früheres Ergebnis existiert; der Fallback in Schritt 2 stellt nur die Eingabe- und Cache-Token der Hauptschleife wieder her.

350

3511. Verwenden Sie das Ergebnis des Turns vor dem Absturz. Im Streaming-Eingabemodus enthält es die laufende Summe, die unter [Kosten im Streaming-Eingabemodus verfolgen](#track-costs-in-streaming-input-mode) beschrieben ist. Gehen Sie stattdessen zu Schritt 2, wenn Ihnen dieses Ergebnis nicht weiterhilft:

352 * Der Aufruf war Single-Shot, daher existiert kein früheres Ergebnis.

353 * Der Absturz trat im ersten Turn auf.

354 * Der Turn vor dem Absturz war das `/clear` selbst, sodass sein Ergebnis nur das Zurücksetzen abdeckt.

3552. Summieren Sie stattdessen `usage` der Assistentennachrichten und zählen Sie jede API-Antwort nur einmal, wie es das Beispiel unter [Nutzung pro Schritt verfolgen](#track-per-step-usage) tut. Im Single-Shot-Modus summieren Sie alle; im Streaming-Eingabemodus summieren Sie diejenigen, die nach dem letzten Ergebnis eingetroffen sind. Dadurch erhalten Sie die Eingabe- und Cache-Token der Hauptschleife. Die Nutzung von Subagenten lässt sich auf diese Weise nicht wiederherstellen, ebenso wenig Ausgabe-Token oder USD-Kosten, da [`output_tokens` pro Schritt ein Platzhalter ist](#read-output-tokens-from-the-result-message).

287 356

288<h3 id="track-cache-tokens">357<h3 id="track-cache-tokens">

289 Cache-Tokens verfolgen358 Cache-Token verfolgen

290</h3>359</h3>

291 360

292Das Agent SDK verwendet automatisch [prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching), um Kosten bei wiederholtem Inhalt zu reduzieren. Sie müssen Caching nicht selbst konfigurieren. Das Nutzungs-Objekt enthält zwei zusätzliche Felder für Cache-Verfolgung:361Das Agent SDK verwendet automatisch [Prompt-Caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching), um die Kosten für wiederholte Inhalte zu senken. Sie müssen das Caching nicht selbst konfigurieren. Das Nutzungsobjekt enthält zwei zusätzliche Felder zur Cache-Verfolgung:

293 362

294* `cache_creation_input_tokens`: Tokens, die zum Erstellen neuer Cache-Einträge verwendet werden (berechnet zu einem höheren Satz als Standard-Input-Tokens).363* `cache_creation_input_tokens`: Token, die zum Erstellen neuer Cache-Einträge verwendet werden (zu einem höheren Tarif abgerechnet als Standard-Eingabe-Token).

295* `cache_read_input_tokens`: Tokens, die aus vorhandenen Cache-Einträgen gelesen werden (berechnet zu einem reduzierten Satz).364* `cache_read_input_tokens`: Token, die aus vorhandenen Cache-Einträgen gelesen werden (zu einem reduzierten Tarif abgerechnet).

296 365

297Verfolgen Sie diese separat von `input_tokens`, um Cache-Einsparungen zu verstehen. In TypeScript sind diese Felder auf dem [`Usage`](/docs/de/agent-sdk/typescript#usage) Objekt typisiert. In Python erscheinen sie als Schlüssel im [`ResultMessage.usage`](/docs/de/agent-sdk/python#resultmessage) dict (zum Beispiel, `message.usage.get("cache_read_input_tokens", 0)`).366Verfolgen Sie diese getrennt von `input_tokens`, um die Einsparungen durch Caching nachzuvollziehen. In TypeScript sind diese Felder im [`Usage`](/docs/de/agent-sdk/typescript#usage)-Objekt typisiert. In Python erscheinen sie als Schlüssel im Dict [`ResultMessage.usage`](/docs/de/agent-sdk/python#resultmessage) (zum Beispiel `message.usage.get("cache_read_input_tokens", 0)`).

298 367

299<h3 id="extend-the-prompt-cache-ttl-to-one-hour">368<h3 id="extend-the-prompt-cache-ttl-to-one-hour">

300 Prompt-Cache-TTL auf eine Stunde verlängern369 Die TTL des Prompt-Caches auf eine Stunde verlängern

301</h3>370</h3>

302 371

303Cache-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.372Ihre eigenen Turns fallen in den [TTL-Bereich der Hauptkonversation](/docs/de/prompt-caching#which-ttl-each-request-gets), zusammen mit den Hilfsanfragen, die Claude Code inline mit ihnen ausführt. Die Anfragen, die Claude Code außerhalb dieser Konversation stellt, etwa [Subagenten](/docs/de/agent-sdk/subagents), haben eine [separate TTL-Steuerung](/docs/de/prompt-caching#choose-the-ttl-yourself).

304 373

305Um eine 1-Stunden-TTL bei Cache-Schreibvorgängen anzufordern, setzen Sie die [`ENABLE_PROMPT_CACHING_1H`](/docs/de/env-vars) Umgebungsvariable. Sie können sie in Ihrer Shell- oder Container-Umgebung exportieren oder sie durch `options.env` übergeben.374Cache-Einträge für Ihre eigenen Turns verwenden standardmäßig eine TTL von 5 Minuten, wenn Sie sich mit einem API-Schlüssel authentifizieren oder auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder [Claude Platform on AWS](/docs/de/claude-platform-on-aws) ausführen. Wenn Ihr Workload viele kurze Sitzungen mit demselben System-Prompt und Kontext ausführt und zwischen ihnen Pausen von mehr als 5 Minuten liegen, läuft der Cache zwischen den Sitzungen ab, und jede neue Sitzung zahlt den vollen Eingabepreis.

306 375

307Das folgende Beispiel aktiviert 1-Stunden-TTL für einen Agenten, der auf Amazon Bedrock ausgeführt wird:376Um eine TTL von 1 Stunde für Cache-Schreibvorgänge anzufordern, setzen Sie die Umgebungsvariable [`ENABLE_PROMPT_CACHING_1H`](/docs/de/env-vars). Sie können sie in Ihrer Shell- oder Container-Umgebung exportieren oder über `options.env` übergeben.

377

378Das folgende Beispiel aktiviert die 1-Stunden-TTL für einen Agenten, der auf Amazon Bedrock läuft. Da es `CLAUDE_CODE_USE_BEDROCK` setzt, benötigt es funktionierende AWS-Anmeldedaten für [Amazon Bedrock](/docs/de/amazon-bedrock); ohne diese schlägt die Abfrage fehl.

308 379

309<CodeGroup>380<CodeGroup>

310 ```python Python theme={null}381 ```python Python theme={null}

344 ```415 ```

345</CodeGroup>416</CodeGroup>

346 417

347Cache-Schreibvorgänge mit einer 1-Stunden-TTL werden zu einem höheren Satz als 5-Minuten-Schreibvorgänge berechnet, daher aktiviert dies einen Austausch von höheren Schreibkosten für mehr Cache-Lesevorgänge. Siehe [prompt caching Preisgestaltung](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) für Details. Claude-Abonnement-Benutzer erhalten bereits automatisch 1-Stunden-TTL und müssen diese Variable nicht setzen.418Cache-Schreibvorgänge mit einer TTL von 1 Stunde werden zu einem höheren Tarif abgerechnet als 5-Minuten-Schreibvorgänge. Durch das Aktivieren tauschen Sie also höhere Schreibkosten gegen mehr Cache-Lesevorgänge. Details finden Sie unter [Preise für Prompt-Caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching). Mit einem Claude-Abonnement erhalten Sie innerhalb der in Ihrem Plan enthaltenen Nutzung die 1-Stunden-TTL für Ihre eigenen Turns und für einige der Hilfsanfragen, die Claude Code daneben stellt, ohne diese Variable zu setzen. Claude Code stuft diese Turns auf die 5-Minuten-TTL herab, sobald Sie [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) in Anspruch nehmen.

419

420`ENABLE_PROMPT_CACHING_1H` fordert die 1-Stunden-TTL für jede Anfrage in beiden Bereichen an. Um für jeden Bereich separat eine TTL zu wählen, verwenden Sie stattdessen diese Steuerungen. Jede akzeptiert `5m` oder `1h` und hat Vorrang vor `ENABLE_PROMPT_CACHING_1H`:

421

422* Hauptkonversation: die [Umgebungsvariable](/docs/de/env-vars) `CLAUDE_CODE_PROMPT_CACHE_TTL` oder die Einstellung [`promptCacheTtl`](/docs/de/settings-reference#promptcachettl)

423* Alles andere: die Umgebungsvariable `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` oder die Einstellung [`subagentPromptCacheTtl`](/docs/de/settings-reference#subagentpromptcachettl)

424

425Wenn Sie `promptCacheTtl` auf `1h` setzen, bleibt der 1-Stunden-Cache für die Hauptkonversation erhalten, während Sie Nutzungsguthaben in Anspruch nehmen. Die vollständige Rangfolge finden Sie unter [die TTL selbst wählen](/docs/de/prompt-caching#choose-the-ttl-yourself).

348 426

349<h2 id="related-documentation">427<h2 id="related-documentation">

350 Verwandte Dokumentation428 Verwandte Dokumentation

agent-sdk/python.md +95 −93

Details

896| Eigenschaft | Typ | Standard | Beschreibung |896| Eigenschaft | Typ | Standard | Beschreibung |

897| :- | :- | :- | :- |897| :- | :- | :- | :- |

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

899| `allowed_tools` | `list[str]` | `[]` | Tools, die automatisch genehmigt werden, ohne zu fragen. Dies beschränkt Claude nicht nur auf diese Tools. Wenn Sie einen der [Task-Tracking-Tools](/docs/de/agent-sdk/todo-tracking#model-availability) hier nennen, aktiviert Claude Code die Sitzung auch. Andere nicht aufgelistete Tools fallen durch `permission_mode` und `can_use_tool`. Verwenden Sie `disallowed_tools`, um Tools zu blockieren. Siehe [Berechtigungen](/docs/de/agent-sdk/permissions#allow-and-deny-rules) |899| `allowed_tools` | `list[str]` | `[]` | Tools, die automatisch genehmigt werden, ohne nachzufragen. Dies beschränkt Claude nicht nur auf diese Tools. Wenn Sie eines der [Task-Tracking-Tools](/docs/de/agent-sdk/todo-tracking#model-availability) hier nennen, aktiviert Claude Code diese auch für die Sitzung. Andere nicht aufgelistete Tools fallen auf `permission_mode` und `can_use_tool` durch. Verwenden Sie `disallowed_tools`, um Tools zu blockieren. Siehe [Berechtigungen](/docs/de/agent-sdk/permissions#allow-and-deny-rules) |

900| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptCustom \| 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"`, `{"type": "custom", "prompt": "..."}` für einen benutzerdefinierten Prompt, der auch `"snapshot"` setzen kann, oder `{"type": "file", "path": "..."}` zum Laden eines großen Prompts von der Festplatte. Siehe [`SystemPromptPreset`](#systempromptpreset), [`SystemPromptCustom`](#systempromptcustom) und [`SystemPromptFile`](#systempromptfile) |900| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptCustom \| 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"`, `{"type": "custom", "prompt": "..."}` für einen benutzerdefinierten Prompt, der auch `"snapshot"` setzen kann, oder `{"type": "file", "path": "..."}` zum Laden eines großen Prompts von der Festplatte. Siehe [`SystemPromptPreset`](#systempromptpreset), [`SystemPromptCustom`](#systempromptcustom) und [`SystemPromptFile`](#systempromptfile) |

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

902| `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](/docs/de/mcp#use-mcp-servers-from-claude-ai). Entspricht dem CLI-Flag `--strict-mcp-config` |902| `strict_mcp_config` | `bool` | `False` | Wenn `True`, werden nur die in `mcp_servers` übergebenen Server verwendet und die Projektdatei `.mcp.json`, Benutzereinstellungen, von Plugins bereitgestellte MCP-Server und [claude.ai-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) ignoriert. Entspricht dem CLI-Flag `--strict-mcp-config` |

906| `session_id` | `str \| None` | `None` | Verwenden Sie eine bestimmte Sitzungs-ID statt einer automatisch generierten. Muss eine gültige UUID sein. Kann nicht mit `continue_conversation` oder `resume` kombiniert werden, es sei denn, `fork_session` ist auch gesetzt |906| `session_id` | `str \| None` | `None` | Verwenden Sie eine bestimmte Sitzungs-ID statt einer automatisch generierten. Muss eine gültige UUID sein. Kann nicht mit `continue_conversation` oder `resume` kombiniert werden, es sei denn, `fork_session` ist auch gesetzt |

908| `max_budget_usd` | `float \| None` | `None` | Stoppen Sie die Abfrage, wenn die clientseitige Kostenschätzung diesen USD-Wert erreicht. Zählt nur die Ausgaben des Aufrufs selbst; Gesamtwerte aus einer fortgesetzten Sitzung zählen nicht. Für Genauigkeitsvorbehalt und Zurücksetzen-Verhalten siehe [Kosten und Nutzung verfolgen](/docs/de/agent-sdk/cost-tracking) |908| `max_budget_usd` | `float \| None` | `None` | Stoppen Sie die Abfrage, wenn die clientseitige Kostenschätzung diesen USD-Wert erreicht. Zählt nur die Ausgaben des Aufrufs selbst; Gesamtwerte aus einer fortgesetzten Sitzung zählen nicht. Für Einschränkungen zur Genauigkeit und zum Zurücksetzungsverhalten siehe [Kosten und Nutzung verfolgen](/docs/de/agent-sdk/cost-tracking) |

909| `disallowed_tools` | `list[str]` | `[]` | Tools, die verweigert werden. Ein einfacher Name wie `"Bash"` entfernt das Tool aus Claudes Kontext. Eine scoped-Regel wie `"Bash(rm *)"` lässt das Tool verfügbar und verweigert übereinstimmende Aufrufe in jedem Berechtigungsmodus, einschließlich `bypassPermissions`, für den Befehl [wie geschrieben](/docs/de/permissions#bash-rule-limits). Siehe [Berechtigungen](/docs/de/agent-sdk/permissions#allow-and-deny-rules) |909| `disallowed_tools` | `list[str]` | `[]` | Tools, die verweigert werden. Ein einfacher Name wie `"Bash"` entfernt das Tool aus Claudes Kontext. Eine eingeschränkte Regel wie `"Bash(rm *)"` lässt das Tool verfügbar und verweigert übereinstimmende Aufrufe in jedem Berechtigungsmodus, einschließlich `bypassPermissions`, für den Befehl [wie geschrieben](/docs/de/permissions#bash-rule-limits). Siehe [Berechtigungen](/docs/de/agent-sdk/permissions#allow-and-deny-rules) |

912| `fallback_model` | `str \| None` | `None` | Fallback-Modell, das verwendet wird, wenn das primäre Modell fehlschlägt. Akzeptiert eine kommagetrennte Liste. Anleitungen finden Sie unter [Modell auswählen](/docs/de/agent-sdk/configuration#choose-a-model) |912| `fallback_model` | `str \| None` | `None` | Fallback-Modell, das verwendet wird, wenn das primäre Modell fehlschlägt. Akzeptiert eine kommagetrennte Liste. Anleitungen finden Sie unter [Modell auswählen](/docs/de/agent-sdk/configuration#choose-a-model) |

914| `output_format` | `dict[str, Any] \| None` | `None` | Ausgabeformat für strukturierte Antworten (z. B. `{"type": "json_schema", "schema": {...}}`). Siehe [Strukturierte Ausgaben](/docs/de/agent-sdk/structured-outputs) für Details |914| `output_format` | `dict[str, Any] \| None` | `None` | Ausgabeformat für strukturierte Antworten (z. B. `{"type": "json_schema", "schema": {...}}`). Siehe [Strukturierte Ausgaben](/docs/de/agent-sdk/structured-outputs) für Details |

916| `cwd` | `str \| Path \| None` | `None` | Aktuelles Arbeitsverzeichnis |916| `cwd` | `str \| Path \| None` | `None` | Aktuelles Arbeitsverzeichnis |

919| `add_dirs` | `list[str \| Path]` | `[]` | Zusätzliche Verzeichnisse, auf die Claude zugreifen kann. Das SDK übergibt jeden Eintrag an Claude Code als `--add-dir`, daher lädt Claude Code mit der `project`-Einstellungsquelle auch [die Skills, Befehle und Subagenten des Verzeichnisses](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) |919| `add_dirs` | `list[str \| Path]` | `[]` | Zusätzliche Verzeichnisse, auf die Claude zugreifen kann. Das SDK übergibt jeden Eintrag an Claude Code als `--add-dir`, daher lädt Claude Code mit der `project`-Einstellungsquelle auch [die Skills, Befehle und Subagenten des Verzeichnisses](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) |

920| `env` | `dict[str, str]` | `{}` | Umgebungsvariablen, die auf der geerbten Prozessumgebung zusammengeführt werden. Siehe [Umgebungsvariablen](/docs/de/env-vars) für Variablen, die die zugrunde liegende CLI liest, und [Langsame oder steckengebliebene API-Antworten handhaben](#handle-slow-or-stalled-api-responses) für Timeout-bezogene Variablen. Setzen Sie `CLAUDE_AGENT_SDK_CLIENT_APP`, um Ihre App im User-Agent-Header zu identifizieren |920| `env` | `dict[str, str]` | `{}` | Umgebungsvariablen, die über die geerbte Prozessumgebung gelegt werden. Siehe [Umgebungsvariablen](/docs/de/env-vars) für Variablen, die die zugrunde liegende CLI liest, und [Langsame oder steckengebliebene API-Antworten handhaben](#handle-slow-or-stalled-api-responses) für Timeout-bezogene Variablen. Setzen Sie `CLAUDE_AGENT_SDK_CLIENT_APP`, um Ihre App im User-Agent-Header zu identifizieren |

921| `extra_args` | `dict[str, str \| None]` | `{}` | Zusätzliche CLI-Argumente, die direkt an die CLI übergeben werden |921| `extra_args` | `dict[str, str \| None]` | `{}` | Zusätzliche CLI-Argumente, die direkt an die CLI übergeben werden |

925| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Tool-Berechtigungs-Callback, der nur aufgerufen wird, wenn der [Berechtigungsfluss](/docs/de/agent-sdk/permissions#how-permissions-are-evaluated) zu einer Aufforderung führt. Nicht aufgerufen für Aufrufe, die automatisch von `allowed_tools`, Allow-Regeln oder `permission_mode` genehmigt werden. Eine Allow-Regel genehmigt nicht vorab die [Aktionen, die kein Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves). Siehe [`CanUseTool`](#canusetool) für Details |925| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Tool-Berechtigungs-Callback, der nur aufgerufen wird, wenn der [Berechtigungsablauf](/docs/de/agent-sdk/permissions#how-permissions-are-evaluated) zu einer Berechtigungsabfrage führt. Wird nicht für Aufrufe ausgeführt, die automatisch durch `allowed_tools`, Allow-Regeln oder `permission_mode` genehmigt werden. Eine Allow-Regel genehmigt nicht vorab die [Aktionen, die kein Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves). Siehe [`CanUseTool`](#canusetool) für Details |

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

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

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

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

938| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI-Standard: alle Quellen) | Kontrollieren Sie, welche Dateisystem-Einstellungen geladen werden. Übergeben Sie `[]`, um Benutzer-, Projekt- und lokale Einstellungen zu deaktivieren. Mit `skills` gesetzt und dieses Feld nicht gesetzt, werden nur Benutzer- und Projektquellen geladen. Setzen Sie `setting_sources` explizit, um lokale Einstellungen zu behalten. Endpoint-verwaltete Richtlinie wird unabhängig davon geladen; Server-verwaltete Einstellungen werden abgerufen, wenn sich die Sitzung mit einer Organisationsanmeldedaten auf einer [berechtigten Konfiguration](/docs/de/server-managed-settings#platform-availability) authentifiziert. Für Eingaben, die unabhängig von dieser Option gelesen werden, siehe [Was settingSources nicht kontrolliert](/docs/de/agent-sdk/claude-code-features#what-settingsources-does-not-control) |938| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI-Standard: alle Quellen) | Steuern Sie, welche Dateisystem-Einstellungen geladen werden. Übergeben Sie `[]`, um Benutzer-, Projekt- und lokale Einstellungen zu deaktivieren. Wenn `skills` gesetzt ist und dieses Feld nicht, werden nur Benutzer- und Projektquellen geladen. Setzen Sie `setting_sources` explizit, um lokale Einstellungen zu behalten. Endpoint-verwaltete Richtlinien werden unabhängig davon geladen; serververwaltete Einstellungen werden abgerufen, wenn sich die Sitzung mit Anmeldedaten einer Organisation auf einer [berechtigten Konfiguration](/docs/de/server-managed-settings#platform-availability) authentifiziert. Für Eingaben, die unabhängig von dieser Option gelesen werden, siehe [Was settingSources nicht steuert](/docs/de/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

939| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills, die der Sitzung zur Verfügung stehen. Übergeben Sie `"all"`, um jeden erkannten Skill zu aktivieren, oder eine Liste von Skill-Namen. Übergeben Sie nur exakte Namen. Das SDK lehnt fehlerhafte und Wildcard-Form-Namen mit einem `ValueError` ab, bevor der Claude Code-Prozess gestartet wird; diese Überprüfung erfordert Python Agent SDK 0.2.129 oder später. Wenn gesetzt, aktiviert das SDK das Skill-Tool automatisch in `allowed_tools`. Wenn Sie auch `tools` übergeben, schließen Sie `"Skill"` in diese Liste ein. Siehe [Skills](/docs/de/agent-sdk/skills) |939| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills, die der Sitzung zur Verfügung stehen. Übergeben Sie `"all"`, um jeden erkannten Skill zu aktivieren, oder eine Liste von Skill-Namen. Übergeben Sie nur exakte Namen. Das SDK lehnt fehlerhafte Namen und Namen in Wildcard-Form mit einem `ValueError` ab, bevor der Claude Code-Prozess gestartet wird; diese Überprüfung erfordert Python Agent SDK 0.2.129 oder später. Wenn gesetzt, fügt das SDK das Skill-Tool automatisch zu `allowed_tools` hinzu. Wenn Sie auch `tools` übergeben, schließen Sie `"Skill"` in diese Liste ein. Siehe [Skills](/docs/de/agent-sdk/skills) |

943| `session_store` | [`SessionStore`](/docs/de/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Spiegeln Sie Sitzungstranskripte zu einem externen Backend, damit jeder Host sie fortsetzen kann. Siehe [Sitzungen im externen Speicher beibehalten](/docs/de/agent-sdk/session-storage) |943| `session_store` | [`SessionStore`](/docs/de/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Spiegeln Sie Sitzungstranskripte in ein externes Backend, damit ein anderer Host sie fortsetzen kann. Siehe [Sitzungen in externem Speicher persistieren](/docs/de/agent-sdk/session-storage) |

944| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Wann sollen gespiegelte Transkripteinträge zu `session_store` geleert werden. `"batched"` leert einmal pro Umdrehung oder wenn der Puffer voll wird; `"eager"` löst nach jedem Frame einen Hintergrund-Flush aus. Wird ignoriert, wenn `session_store` `None` ist |944| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Wann gespiegelte Transkripteinträge an `session_store` übertragen werden. `"batched"` überträgt einmal pro Turn oder wenn der Puffer voll ist; `"eager"` löst nach jedem Frame einen Flush im Hintergrund aus. Wird ignoriert, wenn `session_store` `None` ist |

945| `load_timeout_ms` | `int` | `60000` | Pro-Aufruf-Timeout für `session_store.load()` und `list_subkeys()` während der Wiederaufnahme-Materialisierung in Millisekunden |945| `load_timeout_ms` | `int` | `60000` | Timeout pro Aufruf für `session_store.load()` und `list_subkeys()` während der Materialisierung bei der Wiederaufnahme, in Millisekunden |

946| `task_budget` | `TaskBudget \| None` | `None` | API-seitiges Token-Budget. Wird als `output_config.task_budget` mit dem `task-budgets-2026-03-13`-Beta-Header gesendet. Übergeben Sie `{"total": <int>}`. |946| `task_budget` | `TaskBudget \| None` | `None` | API-seitiges Token-Budget. Wird als `output_config.task_budget` mit dem Beta-Header `task-budgets-2026-03-13` gesendet. Übergeben Sie `{"total": <int>}`. |

947 947

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

949 Langsame oder steckengebliebene API-Antworten handhaben949 Langsame oder steckengebliebene API-Antworten handhaben

950</h4>950</h4>

951 951

952Die CLI-Subprozess liest mehrere Umgebungsvariablen, die API-Timeouts und Stall-Erkennung steuern. Übergeben Sie sie durch `ClaudeAgentOptions.env`:952Der CLI-Subprozess liest mehrere Umgebungsvariablen, die API-Timeouts und die Erkennung von Stillständen steuern. Übergeben Sie sie über `ClaudeAgentOptions.env`:

953 953

954```python theme={null}954```python theme={null}

955from claude_agent_sdk import ClaudeAgentOptions955from claude_agent_sdk import ClaudeAgentOptions

963)963)

964```964```

965 965

966* `API_TIMEOUT_MS`: Pro-Request-Timeout auf dem Anthropic-Client in Millisekunden. Standard `600000`. Gilt für die Hauptschleife und alle Subagenten.966* `API_TIMEOUT_MS`: Timeout pro Anfrage auf dem Anthropic-Client in Millisekunden. Standard `600000`. Gilt für die Hauptschleife und alle Subagenten.

967* `CLAUDE_CODE_MAX_RETRIES`: Maximale API-Wiederholungen. Standard `10`, begrenzt auf `15`. Jede Wiederholung erhält sein eigenes `API_TIMEOUT_MS`-Fenster, daher ist die schlimmste Wandzeit ungefähr `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` plus Backoff. Für unbeaufsichtigte Läufe, die längere Ausfallzeiten abwarten müssen, setzen Sie [`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/de/errors#tune-retry-behavior): Es wiederholt Kapazitätsfehler unbegrenzt und ab Claude Code v2.1.199 erhöht sich der Standard für andere vorübergehende Fehler auf `300` und entfernt die Obergrenze für diese Variable.967* `CLAUDE_CODE_MAX_RETRIES`: Maximale Anzahl von API-Wiederholungsversuchen. Standard `10`, begrenzt auf `15`. Jeder Wiederholungsversuch erhält sein eigenes `API_TIMEOUT_MS`-Fenster, daher beträgt die Gesamtdauer im ungünstigsten Fall ungefähr `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` plus Backoff. Für unbeaufsichtigte Läufe, die längere Ausfälle abwarten müssen, setzen Sie [`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/de/errors#tune-retry-behavior): Damit werden vorübergehende Kapazitätsfehler unbegrenzt erneut versucht, und ab Claude Code v2.1.199 wird der Standard für andere vorübergehende Fehler auf `300` erhöht und die Obergrenze für diese Variable entfernt.

968* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: Stall-Watchdog für Subagenten. Während der Stream-Watchdog an ist, ist der Standard `CLAUDE_STREAM_IDLE_TIMEOUT_MS` plus 5 Minuten, was `600000` ergibt, es sei denn, Sie erhöhen diese Variable. Mit dem Stream-Watchdog aus ist der Standard `600000`. Vor v2.1.257 war der Standard immer `600000`.968* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: Stall-Watchdog für Subagenten. Während der Stream-Watchdog eingeschaltet ist, beträgt der Standard `CLAUDE_STREAM_IDLE_TIMEOUT_MS` plus 5 Minuten, was `600000` ergibt, es sei denn, Sie erhöhen diese Variable. Bei ausgeschaltetem Stream-Watchdog ist der Standard `600000`. Vor v2.1.257 war der Standard immer `600000`.

969 969

970 Der Timer setzt sich bei jedem Stream-Ereignis zurück. Bei Stall bricht Claude Code den Subagenten ab und meldet den Stall dem übergeordneten Element. Für einen Hintergrund-Subagenten markiert es auch die Aufgabe als fehlgeschlagen und hängt jedes Teilergebnis an.970 Der Timer wird bei jedem Stream-Ereignis zurückgesetzt. Bei einem Stillstand bricht Claude Code den Subagenten ab und meldet den Stillstand an den übergeordneten Agenten. Bei einem Hintergrund-Subagenten markiert es außerdem die Aufgabe als fehlgeschlagen und hängt ein eventuelles Teilergebnis an.

971* `CLAUDE_ENABLE_STREAM_WATCHDOG` mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: Stream-Watchdog, der die Anfrage abbricht, wenn Header angekommen sind, aber der Antwortkörper nicht mehr streamt. Der Watchdog ist standardmäßig für alle Anbieter aktiviert; setzen Sie `CLAUDE_ENABLE_STREAM_WATCHDOG=0`, um ihn zu deaktivieren. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` hat einen Standard von `300000` und ist auf dieses Minimum begrenzt. Nach dem Abbruch behandelt [Automatische Wiederholungen](/docs/de/errors#automatic-retries) das, was Claude Code tut, basierend darauf, wie weit die Antwort fortgeschritten war.971* `CLAUDE_ENABLE_STREAM_WATCHDOG` mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: Stream-Watchdog, der die Anfrage abbricht, wenn Header angekommen sind, aber der Response-Body nicht mehr streamt. Der Watchdog ist standardmäßig für alle Anbieter aktiviert; setzen Sie `CLAUDE_ENABLE_STREAM_WATCHDOG=0`, um ihn zu deaktivieren. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` hat einen Standard von `300000` und wird auf dieses Minimum begrenzt. Was Claude Code nach dem Abbruch tut, abhängig davon, wie weit die Antwort fortgeschritten war, beschreibt [Automatische Wiederholungsversuche](/docs/de/errors#automatic-retries).

972 972

973 Während der Watchdog auf eine Antwort wartet, die ein Gateway hinter `ANTHROPIC_BASE_URL` mit Keep-Alive-Pings offen hält, empfängt ein Host, der `include_partial_messages` setzt, weiterhin `ping`-[`StreamEvent`](#streamevent)-Nachrichten. Lesen Sie diese Frames als Lebenszeichen, anstatt die Sitzung bei Stille zu unterbrechen. Vor v2.1.257 stoppten die Frames 5 Minuten nach dem letzten echten Stream-Ereignis.973 Während der Watchdog auf eine Antwort wartet, die ein Gateway hinter `ANTHROPIC_BASE_URL` mit Keep-Alive-Pings offen hält, empfängt ein Host, der `include_partial_messages` setzt, weiterhin `ping`-[`StreamEvent`](#streamevent)-Nachrichten. Werten Sie diese Frames als Lebenszeichen, anstatt die Sitzung bei Stille per Timeout zu beenden. Vor v2.1.257 stoppten die Frames 5 Minuten nach dem letzten echten Stream-Ereignis.

974 974

975<h3 id="outputformat">975<h3 id="outputformat">

976 `OutputFormat`976 `OutputFormat`

1011| `type` | Ja | Muss `"preset"` sein, um einen Preset-System-Prompt zu verwenden |1011| `type` | Ja | Muss `"preset"` sein, um einen Preset-System-Prompt zu verwenden |

1012| `preset` | Ja | Muss `"claude_code"` sein, um den System-Prompt von Claude Code zu verwenden |1012| `preset` | Ja | Muss `"claude_code"` sein, um den System-Prompt von Claude Code zu verwenden |

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

1015| `snapshot` | Nein | Setzen Sie auf `False`, um den System-Prompt bei jeder Anfrage neu zu erstellen, anstatt [den Prompt wiederzuverwenden, den die Sitzung bei ihrer ersten Anfrage aufgezeichnet hat](/docs/de/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Erfordert `claude-agent-sdk` v0.2.153 oder später |1015| `snapshot` | Nein | Setzen Sie auf `False`, um den System-Prompt bei jeder Anfrage neu zu erstellen, anstatt [den Prompt wiederzuverwenden, den die Sitzung bei ihrer ersten Anfrage aufgezeichnet hat](/docs/de/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Erfordert `claude-agent-sdk` v0.2.153 oder später |

1016 1016

1017<h3 id="systempromptcustom">1017<h3 id="systempromptcustom">

1031| :- | :- | :- |1031| :- | :- | :- |

1032| `type` | Ja | Muss `"custom"` sein |1032| `type` | Ja | Muss `"custom"` sein |

1033| `prompt` | Ja | Der System-Prompt-Text. Wird an die CLI als Befehlszeilenargument übergeben, daher gelten die [Befehlszeilenlängenbeschränkungen](#systempromptfile) |1033| `prompt` | Ja | Der System-Prompt-Text. Wird an die CLI als Befehlszeilenargument übergeben, daher gelten die [Längenbeschränkungen der Befehlszeile](#systempromptfile) |

1035 1035

1036<h3 id="systempromptfile">1036<h3 id="systempromptfile">

1037 `SystemPromptFile`1037 `SystemPromptFile`

1038</h3>1038</h3>

1039 1039

1040Konfiguration 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`](/docs/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.1040Konfiguration 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`](/docs/de/cli-reference#system-prompt-flags) zu. Verwenden Sie die Dateiform, wenn der Prompt groß ist: Das SDK übergibt einen `system_prompt` als Zeichenkette in der argv des CLI-Subprozesses, die den Längenbeschränkungen der Befehlszeile des Betriebssystems unterliegt, bevor das SDK eine API-Anfrage sendet. Unter 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.

1041 1041

1042```python theme={null}1042```python theme={null}

1043class SystemPromptFile(TypedDict):1043class SystemPromptFile(TypedDict):

1054 `SettingSource`1054 `SettingSource`

1055</h3>1055</h3>

1056 1056

1057Steuert, welche dateisystembasierte Konfigurationsquellen das SDK Einstellungen aus lädt.1057Steuert, aus welchen dateisystembasierten Konfigurationsquellen das SDK Einstellungen lädt.

1058 1058

1059```python theme={null}1059```python theme={null}

1060SettingSource = Literal["user", "project", "local"]1060SettingSource = Literal["user", "project", "local"]

1064| :- | :- | :- |1064| :- | :- | :- |

1068 1068

1069<h4 id="default-behavior">1069<h4 id="default-behavior">

1070 Standardverhalten1070 Standardverhalten

1071</h4>1071</h4>

1072 1072

1073Wenn `setting_sources` weggelassen oder `None` ist und `skills` nicht gesetzt ist, lädt `query()` die gleichen Dateisystem-Einstellungen wie die Claude Code CLI: Benutzer, Projekt und lokal. Mit `skills` gesetzt, beschreibt die [`setting_sources`](#claudeagentoptions)-Zeile den aktuellen Standard. Endpoint-verwaltete Richtlinie wird in allen Fällen geladen; Server-verwaltete Einstellungen werden abgerufen, wenn sich die Sitzung mit einer Organisationsanmeldedaten auf einer [berechtigten Konfiguration](/docs/de/server-managed-settings#platform-availability) authentifiziert. Weitere Informationen finden Sie unter [Was settingSources nicht kontrolliert](/docs/de/agent-sdk/claude-code-features#what-settingsources-does-not-control).1073Wenn `setting_sources` weggelassen oder `None` ist und `skills` nicht gesetzt ist, lädt `query()` die gleichen Dateisystem-Einstellungen wie die Claude Code CLI: Benutzer, Projekt und lokal. Wenn `skills` gesetzt ist, beschreibt die Zeile [`setting_sources`](#claudeagentoptions) den aktuellen Standard. Endpoint-verwaltete Richtlinien werden in allen Fällen geladen; serververwaltete Einstellungen werden abgerufen, wenn sich die Sitzung mit Anmeldedaten einer Organisation auf einer [berechtigten Konfiguration](/docs/de/server-managed-settings#platform-availability) authentifiziert. Weitere Informationen finden Sie unter [Was settingSources nicht steuert](/docs/de/agent-sdk/claude-code-features#what-settingsources-does-not-control).

1074 1074

1075<h4 id="why-use-setting_sources">1075<h4 id="why-use-setting_sources">

1076 Warum setting\_sources verwenden1076 Warum setting\_sources verwenden

1098```1098```

1099 1099

1100<Note>1100<Note>

1101 Im Python SDK 0.1.59 und früher wurde eine leere Liste gleich behandelt wie das Weglassen der Option, daher hatte `setting_sources=[]` keine Auswirkung auf die Deaktivierung von Dateisystem-Einstellungen. Aktualisieren Sie auf eine neuere Version, wenn Sie benötigen, dass eine leere Liste wirksam wird. Das TypeScript SDK ist nicht betroffen.1101 Im Python SDK 0.1.59 und früher wurde eine leere Liste genauso behandelt wie das Weglassen der Option, daher hat `setting_sources=[]` Dateisystem-Einstellungen nicht deaktiviert. Aktualisieren Sie auf eine neuere Version, wenn eine leere Liste wirksam werden soll. Das TypeScript SDK ist nicht betroffen.

1102</Note>1102</Note>

1103 1103

1104**Nur bestimmte Einstellungsquellen laden:**1104**Nur bestimmte Einstellungsquellen laden:**

1122asyncio.run(main())1122asyncio.run(main())

1123```1123```

1124 1124

1125**SDK-only-Anwendungen:**1125**Reine SDK-Anwendungen:**

1126 1126

1127```python theme={null}1127```python theme={null}

1128# Define everything programmatically.1128# Define everything programmatically.

1151asyncio.run(main())1151asyncio.run(main())

1152```1152```

1153 1153

1154Um CLAUDE.md-Projektanweisungen zu laden, schließen Sie `"project"` in `setting_sources` ein. Siehe [System-Prompts ändern](/docs/de/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions) für die Interaktion des CLAUDE.md-Ladens mit den System-Prompt-Optionen.1154Um CLAUDE.md-Projektanweisungen zu laden, schließen Sie `"project"` in `setting_sources` ein. Siehe [System-Prompts ändern](/docs/de/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions) für das Zusammenspiel des Ladens von CLAUDE.md mit den System-Prompt-Optionen.

1155 1155

1156<h4 id="settings-precedence">1156<h4 id="settings-precedence">

1157 Einstellungspriorität1157 Vorrang der Einstellungen

1158</h4>1158</h4>

1159 1159

1160Wenn mehrere Quellen geladen werden, werden Einstellungen mit dieser Priorität zusammengeführt (höchste zu niedrigste):1160Wenn mehrere Quellen geladen werden, werden Einstellungen in dieser Rangfolge zusammengeführt (höchste zu niedrigste):

1161 1161

11621. Lokale Einstellungen (`.claude/settings.local.json`)11621. Lokale Einstellungen (`.claude/settings.local.json`)

11632. Projekteinstellungen (`.claude/settings.json`)11632. Projekteinstellungen (`.claude/settings.json`)

1193| :- | :- | :- |1193| :- | :- | :- |

1194| `description` | Ja | Natürlichsprachige Beschreibung, wann dieser Agent verwendet werden sollte |1194| `description` | Ja | Natürlichsprachige Beschreibung, wann dieser Agent verwendet werden sollte |

1195| `prompt` | Ja | Der System-Prompt des Agenten |1195| `prompt` | Ja | Der System-Prompt des Agenten |

1197| `disallowedTools` | Nein | Array von Tool-Namen, die aus dem Tool-Set des Agenten entfernt werden. MCP-Server-Level-Muster werden auch akzeptiert: `mcp__server` oder `mcp__server__*` entfernt jedes Tool von diesem Server, und `mcp__*` entfernt jedes MCP-Tool von jedem Server |1197| `disallowedTools` | Nein | Array von Tool-Namen, die aus dem Tool-Set des Agenten entfernt werden. Muster auf MCP-Server-Ebene werden ebenfalls akzeptiert: `mcp__server` oder `mcp__server__*` entfernt jedes Tool dieses Servers, und `mcp__*` entfernt jedes MCP-Tool aller Server |

1198| `model` | Nein | Modell-Override für diesen Agenten. Akzeptiert einen Alias wie `"sonnet"`, `"opus"`, `"haiku"` oder `"inherit"`, oder eine vollständige Modell-ID. Wenn Sie es weglassen, wählt Claude Code das Modell in der [Subagenten-Modellreihenfolge](/docs/de/sub-agents#choose-a-model) |1198| `model` | Nein | Modell-Override für diesen Agenten. Akzeptiert einen Alias wie `"sonnet"`, `"opus"`, `"haiku"` oder `"inherit"`, oder eine vollständige Modell-ID. Wenn Sie es weglassen, wählt Claude Code das Modell gemäß der [Subagenten-Modellreihenfolge](/docs/de/sub-agents#choose-a-model) |

1199| `skills` | Nein | Liste von Skill-Namen, die beim Start in den Kontext des Agenten vorgeladen werden. Nicht aufgelistete Skills bleiben über das Skill-Tool aufrufbar |1199| `skills` | Nein | Liste von Skill-Namen, die beim Start in den Kontext des Agenten vorgeladen werden. Nicht aufgelistete Skills bleiben über das Skill-Tool aufrufbar |

1201| `mcpServers` | Nein | MCP-Server, die diesem Agenten zur Verfügung stehen. Jeder Eintrag ist ein Servername oder ein Inline-`{name: config}`-Dict |1201| `mcpServers` | Nein | MCP-Server, die diesem Agenten zur Verfügung stehen. Jeder Eintrag ist ein Servername oder ein Inline-`{name: config}`-Dict |

1206| `permissionMode` | Nein | Berechtigungsmodus für die Tool-Ausführung innerhalb dieses Agenten. Die [Subagenten-Vererbungsregeln](/docs/de/agent-sdk/permissions#available-modes) entscheiden, wann er angewendet wird. Siehe [`PermissionMode`](#permissionmode) |1206| `permissionMode` | Nein | Berechtigungsmodus für die Tool-Ausführung innerhalb dieses Agenten. Die [Vererbungsregeln für Subagenten](/docs/de/agent-sdk/permissions#available-modes) entscheiden, wann er angewendet wird. Siehe [`PermissionMode`](#permissionmode) |

1207 1207

1208<Note>1208<Note>

1209 `AgentDefinition`-Feldnamen verwenden camelCase, wie `disallowedTools`, `permissionMode` und `maxTurns`. Diese Namen werden direkt dem Drahtformat zugeordnet, das mit dem TypeScript SDK geteilt wird. Dies unterscheidet sich von `ClaudeAgentOptions`, das Python snake\_case für die entsprechenden Top-Level-Felder wie `disallowed_tools` und `permission_mode` verwendet. Da `AgentDefinition` eine Dataclass ist, wirft das Übergeben eines snake\_case-Schlüsselworts einen `TypeError` zur Konstruktionszeit auf.1209 `AgentDefinition`-Feldnamen verwenden camelCase, wie `disallowedTools`, `permissionMode` und `maxTurns`. Diese Namen entsprechen direkt dem Wire-Format, das mit dem TypeScript SDK geteilt wird. Dies unterscheidet sich von `ClaudeAgentOptions`, das für die entsprechenden Top-Level-Felder wie `disallowed_tools` und `permission_mode` Python-snake\_case verwendet. Da `AgentDefinition` eine Dataclass ist, löst das Übergeben eines snake\_case-Schlüsselworts bei der Konstruktion einen `TypeError` aus.

1210</Note>1210</Note>

1211 1211

1212<h3 id="permissionmode">1212<h3 id="permissionmode">

1213 `PermissionMode`1213 `PermissionMode`

1214</h3>1214</h3>

1215 1215

1216Berechtigungsmodi zur Kontrolle der Tool-Ausführung.1216Berechtigungsmodi zur Steuerung der Tool-Ausführung.

1217 1217

1218```python theme={null}1218```python theme={null}

1219PermissionMode = Literal[1219PermissionMode = Literal[

1230 `EffortLevel`1230 `EffortLevel`

1231</h3>1231</h3>

1232 1232

1233Anstrengungsstufen zur Steuerung der Denktiefe.1233Effort-Stufen zur Steuerung der Denktiefe.

1234 1234

1235```python theme={null}1235```python theme={null}

1236EffortLevel = Literal[1236EffortLevel = Literal[

1262 1262

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

1264 1264

1265Der Callback ist der SDK-Ersatz für die interaktive Berechtigungsaufforderung: Er wird nur aufgerufen, wenn der [Berechtigungsbewertungsfluss](/docs/de/agent-sdk/permissions#how-permissions-are-evaluated) zu einer Aufforderung führt. Tool-Aufrufe, die bereits von einem `allowed_tools`-Eintrag, einer Settings-Allow-Regel oder dem Berechtigungsmodus wie `acceptEdits` oder `bypassPermissions` genehmigt wurden, rufen ihn nie auf. Um jeden Tool-Aufruf zu kontrollieren, verwenden Sie stattdessen einen [`PreToolUse`-Hook](/docs/de/agent-sdk/hooks). Eine Allow-Regel genehmigt nicht vorab die [Aktionen, die kein Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves); siehe [Wie Berechtigungen bewertet werden](/docs/de/agent-sdk/permissions#how-permissions-are-evaluated) für welche von ihnen den Callback erreichen und was in `dontAsk`- und `auto`-Modus passiert.1265Der Callback ist der SDK-Ersatz für die interaktive Berechtigungsabfrage: Er wird nur aufgerufen, wenn der [Ablauf der Berechtigungsprüfung](/docs/de/agent-sdk/permissions#how-permissions-are-evaluated) zu einer Berechtigungsabfrage führt. Tool-Aufrufe, die bereits durch einen `allowed_tools`-Eintrag, eine Allow-Regel in den Einstellungen oder den Berechtigungsmodus wie `acceptEdits` oder `bypassPermissions` genehmigt wurden, rufen ihn nie auf. Um jeden Tool-Aufruf zu kontrollieren, verwenden Sie stattdessen einen [`PreToolUse`-Hook](/docs/de/agent-sdk/hooks).

1266

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

1266 1268

1267<h3 id="toolpermissioncontext">1269<h3 id="toolpermissioncontext">

1268 `ToolPermissionContext`1270 `ToolPermissionContext`

1286 1288

1287| Feld | Typ | Beschreibung |1289| Feld | Typ | Beschreibung |

1288| :- | :- | :- |1290| :- | :- | :- |

1290| `suggestions` | `list[PermissionUpdate]` | Berechtigungsaktualisierungsvorschläge von der CLI. Bash-Aufforderungen enthalten einen Vorschlag mit dem `localSettings`-Ziel, daher gibt das Zurückgeben in `updated_permissions` die Regel in `.claude/settings.local.json` aus und bleibt über Sitzungen hinweg bestehen. |1292| `suggestions` | `list[PermissionUpdate]` | Vorschläge für Berechtigungsaktualisierungen von der CLI. Bash-Berechtigungsabfragen enthalten einen Vorschlag mit dem Ziel `localSettings`, daher schreibt das Zurückgeben dieses Vorschlags in `updated_permissions` die Regel in `.claude/settings.local.json`, wo sie über Sitzungen hinweg bestehen bleibt. |

1293| `blocked_path` | `str \| None` | Dateipfad, der die Berechtigungsanfrage ausgelöst hat, falls zutreffend. Zum Beispiel, wenn ein Bash-Befehl versucht, auf einen Pfad außerhalb zulässiger Verzeichnisse zuzugreifen |1295| `blocked_path` | `str \| None` | Dateipfad, der die Berechtigungsanfrage ausgelöst hat, falls zutreffend. Zum Beispiel, wenn ein Bash-Befehl versucht, auf einen Pfad außerhalb zulässiger Verzeichnisse zuzugreifen |

1294| `decision_reason` | `str \| None` | Grund, warum diese Berechtigungsanfrage ausgelöst wurde. Weitergeleitet von einem PreToolUse-Hook's `permissionDecisionReason`, wenn der Hook `"ask"` zurückgegeben hat |1296| `decision_reason` | `str \| None` | Grund, warum diese Berechtigungsanfrage ausgelöst wurde. Wird aus dem `permissionDecisionReason` eines PreToolUse-Hooks weitergeleitet, wenn der Hook `"ask"` zurückgegeben hat |

1298 1300

1299<h3 id="permissionresult">1301<h3 id="permissionresult">

1300 `PermissionResult`1302 `PermissionResult`

1301</h3>1303</h3>

1302 1304

1303Union-Typ für Berechtigungs-Callback-Ergebnisse.1305Union-Typ für Ergebnisse von Berechtigungs-Callbacks.

1304 1306

1305```python theme={null}1307```python theme={null}

1306PermissionResult = PermissionResultAllow | PermissionResultDeny1308PermissionResult = PermissionResultAllow | PermissionResultDeny

1310 `PermissionResultAllow`1312 `PermissionResultAllow`

1311</h3>1313</h3>

1312 1314

1313Ergebnis, das angibt, dass der Tool-Aufruf zulässig sein sollte.1315Ergebnis, das angibt, dass der Tool-Aufruf erlaubt werden soll.

1314 1316

1315```python theme={null}1317```python theme={null}

1316@dataclass1318@dataclass

1323| Feld | Typ | Standard | Beschreibung |1325| Feld | Typ | Standard | Beschreibung |

1324| :- | :- | :- | :- |1326| :- | :- | :- | :- |

1328 1330

1329<h3 id="permissionresultdeny">1331<h3 id="permissionresultdeny">

1330 `PermissionResultDeny`1332 `PermissionResultDeny`

1331</h3>1333</h3>

1332 1334

1333Ergebnis, das angibt, dass der Tool-Aufruf verweigert werden sollte.1335Ergebnis, das angibt, dass der Tool-Aufruf verweigert werden soll.

1334 1336

1335```python theme={null}1337```python theme={null}

1336@dataclass1338@dataclass

1375| Feld | Typ | Beschreibung |1377| Feld | Typ | Beschreibung |

1376| :- | :- | :- |1378| :- | :- | :- |

1383 1385

1384<h3 id="permissionrulevalue">1386<h3 id="permissionrulevalue">

1410 `ThinkingConfig`1412 `ThinkingConfig`

1411</h3>1413</h3>

1412 1414

1413Steuert das Verhalten des erweiterten Denkens. Eine Union von drei Konfigurationen:1415Steuert das Verhalten von Extended Thinking. Eine Union aus drei Konfigurationen:

1414 1416

1415```python theme={null}1417```python theme={null}

1416ThinkingDisplay = Literal["summarized", "omitted"]1418ThinkingDisplay = Literal["summarized", "omitted"]

1436 1438

1438| :- | :- | :- |1440| :- | :- | :- |

1442 1444

1443Das optionale Feld `display` steuert, ob Thinking-Text `"summarized"` oder `"omitted"` zurückgegeben wird. Bei Claude Opus 4.7 und später ist der API-Standard `"omitted"`, daher setzen Sie `"summarized"`, um Thinking-Inhalte in [`ThinkingBlock`](#thinkingblock)-Ausgaben zu erhalten. Claude Code sendet `display` nicht an Amazon Bedrock oder Google Cloud's Agent Platform, daher geben Opus 4.7 und später auf diesen Anbietern leere `ThinkingBlock`-Ausgaben zurück, auch wenn Sie `display` auf `"summarized"` setzen.1445Das optionale Feld `display` steuert, ob Thinking-Text `"summarized"` oder `"omitted"` zurückgegeben wird. Bei Claude Opus 4.7 und später ist der API-Standard `"omitted"`, setzen Sie daher `"summarized"`, um Thinking-Inhalte in [`ThinkingBlock`](#thinkingblock)-Ausgaben zu erhalten. Claude Code sendet `display` nicht an Amazon Bedrock oder die Agent Platform von Google Cloud, daher geben Opus 4.7 und später bei diesen Anbietern leere `ThinkingBlock`-Ausgaben zurück, auch wenn Sie `display` auf `"summarized"` setzen.

1444 1446

1445Da dies `TypedDict`-Klassen sind, sind sie zur Laufzeit einfache Dicts. Konstruieren Sie sie entweder als Dict-Literale oder rufen Sie die Klasse wie einen Konstruktor auf; beide erzeugen ein `dict`. Greifen Sie auf Felder mit `config["budget_tokens"]` zu, nicht mit `config.budget_tokens`:1447Da dies `TypedDict`-Klassen sind, sind sie zur Laufzeit einfache Dicts. Konstruieren Sie sie entweder als Dict-Literale oder rufen Sie die Klasse wie einen Konstruktor auf; beide Varianten erzeugen ein `dict`. Greifen Sie auf Felder mit `config["budget_tokens"]` zu, nicht mit `config.budget_tokens`:

1446 1448

1447```python theme={null}1449```python theme={null}

1448from claude_agent_sdk import ClaudeAgentOptions, ThinkingConfigEnabled1450from claude_agent_sdk import ClaudeAgentOptions, ThinkingConfigEnabled

1460 `TaskBudget`1462 `TaskBudget`

1461</h3>1463</h3>

1462 1464

1463API-seitiges Task-Budget in Token, verwendet mit dem Feld `task_budget` in `ClaudeAgentOptions`.1465API-seitiges Aufgabenbudget in Token, verwendet mit dem Feld `task_budget` in `ClaudeAgentOptions`.

1464 1466

1465```python theme={null}1467```python theme={null}

1466class TaskBudget(TypedDict):1468class TaskBudget(TypedDict):

1471| :- | :- | :- |1473| :- | :- | :- |

1472| `total` | `int` | Gesamtes Token-Budget für die Aufgabe |1474| `total` | `int` | Gesamtes Token-Budget für die Aufgabe |

1473 1475

1474Da dies eine `TypedDict` ist, übergeben Sie sie als einfaches Dict, wie `ClaudeAgentOptions(task_budget={"total": 50000})`.1476Da dies ein `TypedDict` ist, übergeben Sie es als einfaches Dict, etwa `ClaudeAgentOptions(task_budget={"total": 50000})`.

1475 1477

1476<h3 id="sdkbeta">1478<h3 id="sdkbeta">

1477 `SdkBeta`1479 `SdkBeta`

1483SdkBeta = Literal["context-1m-2025-08-07"]1485SdkBeta = Literal["context-1m-2025-08-07"]

1484```1486```

1485 1487

1486Verwenden Sie mit dem Feld `betas` in `ClaudeAgentOptions`, um Beta-Funktionen zu aktivieren.1488Verwenden Sie ihn mit dem Feld `betas` in `ClaudeAgentOptions`, um Beta-Funktionen zu aktivieren.

1487 1489

1488<Warning>1490<Warning>

1489 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 Opus 5.5, Claude Opus 5, 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.1491 In der Claude API ist die Beta `context-1m-2025-08-07` für Claude Sonnet 4.5 und Claude Sonnet 4 außer Betrieb genommen. Wenn Sie sie mit einem dieser Modelle weiterhin übergeben, geben Anfragen, die das Standard-Kontextfenster von 200K Token überschreiten, einen Fehler zurück; entfernen Sie sie daher aus `betas`. Um eine Sitzung mit einem Kontextfenster von 1M Token auszuführen, setzen Sie `model` auf ein Modell, das [standardmäßig mit dem 1M-Fenster läuft](/docs/de/model-config#extended-context), etwa `claude-sonnet-5-5` oder `claude-opus-5-5`. Bei einem Modell, das 1M nur über seine `[1m]`-Variante erreicht, hängen Sie das Suffix an die Modell-ID an, wie in `claude-opus-4-6[1m]`.

1490</Warning>1492</Warning>

1491 1493

1492<h3 id="mcpsdkserverconfig">1494<h3 id="mcpsdkserverconfig">

1493 `McpSdkServerConfig`1495 `McpSdkServerConfig`

1494</h3>1496</h3>

1495 1497

1496Konfiguration für SDK MCP-Server, die mit `create_sdk_mcp_server()` erstellt wurden.1498Konfiguration für SDK-MCP-Server, die mit `create_sdk_mcp_server()` erstellt wurden.

1497 1499

1498```python theme={null}1500```python theme={null}

1499class McpSdkServerConfig(TypedDict):1501class McpSdkServerConfig(TypedDict):

1552 `McpServerStatusConfig`1554 `McpServerStatusConfig`

1553</h3>1555</h3>

1554 1556

1555Die Konfiguration eines MCP-Servers, wie von [`get_mcp_status()`](#methods) gemeldet. Dies ist die Union aller [`McpServerConfig`](#mcpserverconfig)-Transport-Varianten plus eine nur-Ausgabe-`claudeai-proxy`-Variante für Server, die durch claude.ai proxiert werden.1557Die Konfiguration eines MCP-Servers, wie von [`get_mcp_status()`](#methods) gemeldet. Dies ist die Union aller [`McpServerConfig`](#mcpserverconfig)-Transportvarianten plus einer reinen Ausgabevariante `claudeai-proxy` für Server, die über claude.ai proxiert werden.

1556 1558

1557```python theme={null}1559```python theme={null}

1558McpServerStatusConfig = (1560McpServerStatusConfig = (

1564)1566)

1565```1567```

1566 1568

1567`McpSdkServerConfigStatus` ist die serialisierbare Form von [`McpSdkServerConfig`](#mcpsdkserverconfig) mit nur `type` (`"sdk"`) und `name` (`str`)-Feldern; die In-Process-`instance` wird weggelassen. `McpClaudeAIProxyServerConfig` hat `type` (`"claudeai-proxy"`), `url` (`str`) und `id` (`str`)-Felder.1569`McpSdkServerConfigStatus` ist die serialisierbare Form von [`McpSdkServerConfig`](#mcpsdkserverconfig) mit nur den Feldern `type` (`"sdk"`) und `name` (`str`); die prozessinterne `instance` wird weggelassen. `McpClaudeAIProxyServerConfig` hat die Felder `type` (`"claudeai-proxy"`), `url` (`str`) und `id` (`str`).

1568 1570

1569<h3 id="mcpstatusresponse">1571<h3 id="mcpstatusresponse">

1570 `McpStatusResponse`1572 `McpStatusResponse`

1571</h3>1573</h3>

1572 1574

1573Antwort von [`ClaudeSDKClient.get_mcp_status()`](#methods). Umhüllt die Liste der Server-Status unter dem `mcpServers`-Schlüssel.1575Antwort von [`ClaudeSDKClient.get_mcp_status()`](#methods). Umschließt die Liste der Serverstatus unter dem Schlüssel `mcpServers`.

1574 1576

1575```python theme={null}1577```python theme={null}

1576class McpStatusResponse(TypedDict):1578class McpStatusResponse(TypedDict):

1600| `status` | `str` | Einer von `"connected"`, `"failed"`, `"needs-auth"`, `"pending"` oder `"disabled"` |1602| `status` | `str` | Einer von `"connected"`, `"failed"`, `"needs-auth"`, `"pending"` oder `"disabled"` |

1601| `serverInfo` | `dict` (optional) | Servername und Version (`{"name": str, "version": str}`) |1603| `serverInfo` | `dict` (optional) | Servername und Version (`{"name": str, "version": str}`) |

1603| `config` | [`McpServerStatusConfig`](#mcpserverstatusconfig) (optional) | Server-Konfiguration. Gleiche Form wie [`McpServerConfig`](#mcpserverconfig) (stdio, SSE, HTTP oder SDK), plus eine `claudeai-proxy`-Variante für Server, die über claude.ai verbunden sind |1605| `config` | [`McpServerStatusConfig`](#mcpserverstatusconfig) (optional) | Serverkonfiguration. Gleiche Form wie [`McpServerConfig`](#mcpserverconfig) (stdio, SSE, HTTP oder SDK), plus eine `claudeai-proxy`-Variante für Server, die über claude.ai verbunden sind |

1606 1608

1607<h3 id="contextusageresponse">1609<h3 id="contextusageresponse">

1608 `ContextUsageResponse`1610 `ContextUsageResponse`

1609</h3>1611</h3>

1610 1612

1611Antwort von [`ClaudeSDKClient.get_context_usage()`](#methods). Dies ist die gleiche Nutzlast, die Claude Code für den `/context`-Befehl in einer interaktiven Sitzung rendert, daher trägt sie neben den Token-Zählungen auch Anzeigefelder wie `color` und `gridRows`, die Claude Code verwendet, um das `/context`-Nutzungsgitter zu zeichnen.1613Antwort von [`ClaudeSDKClient.get_context_usage()`](#methods). Dies ist dieselbe Payload, die Claude Code für den Befehl `/context` in einer interaktiven Sitzung rendert, daher enthält sie neben den Token-Zählungen auch Anzeigefelder wie `color` und `gridRows`, mit denen Claude Code das `/context`-Nutzungsraster zeichnet.

1612 1614

1613Claude Code erstellt diese Nutzlast, indem es mehrere Anfragen an die [Token-Zählung](https://platform.claude.com/docs/en/build-with-claude/token-counting)-API sendet. Diese Anfragen erscheinen nicht im Nachrichtenstrom, daher sieht die Kostenverfolgung, die den Strom liest, sie nicht. Auf der Anthropic API wird die Token-Zählung nicht abgerechnet.1615Claude Code erstellt diese Payload, indem es mehrere Anfragen an die [Token-Counting](https://platform.claude.com/docs/en/build-with-claude/token-counting)-API sendet. Diese Anfragen erscheinen nicht im Nachrichtenstrom, daher sieht eine Kostenverfolgung, die den Strom liest, sie nicht. In der Anthropic API wird Token-Counting nicht abgerechnet.

1614 1616

1615```python theme={null}1617```python theme={null}

1616class ContextUsageResponse(TypedDict):1618class ContextUsageResponse(TypedDict):

1635 apiUsage: NotRequired[dict[str, Any] | None]1637 apiUsage: NotRequired[dict[str, Any] | None]

1636```1638```

1637 1639

1638Jeder `ContextUsageCategory`-Eintrag trägt `name`, `tokens`, `color` und ein optionales `isDeferred`-Flag. `totalTokens` ist die aktuelle Kontextnutzung der Sitzung, und `maxTokens` ist das Fenster, gegen das die Nutzung gemessen wird. Dieses Fenster ist das Kontextfenster des Modells oder das niedrigere Auto-Kompaktierungsfenster, wenn eines zutrifft, und `rawMaxTokens` trägt den gleichen Wert wie `maxTokens`. `apiUsage` enthält die Nutzung aus der neuesten API-Antwort, nicht eine laufende Summe für die Sitzung. Claude Code lässt die optionalen Schlüssel `deferredBuiltinTools`, `systemTools` und `systemPromptSections` ungesetzt, daher erwarten Sie, dass sie abwesend sind, auch wenn der Typ sie deklariert.1640Jeder `ContextUsageCategory`-Eintrag enthält `name`, `tokens`, `color` und ein optionales Flag `isDeferred`. `totalTokens` ist die aktuelle Kontextnutzung der Sitzung, und `maxTokens` ist das Fenster, an dem diese Nutzung gemessen wird. Dieses Fenster ist das Kontextfenster des Modells oder das niedrigere Fenster der automatischen Komprimierung, sofern eines gilt, und `rawMaxTokens` enthält denselben Wert wie `maxTokens`. `apiUsage` enthält die Nutzung aus der neuesten API-Antwort, keine laufende Summe für die Sitzung. Claude Code lässt die optionalen Schlüssel `deferredBuiltinTools`, `systemTools` und `systemPromptSections` ungesetzt; rechnen Sie also damit, dass sie fehlen, obwohl der Typ sie deklariert.

1639 1641

1640<h3 id="sdkpluginconfig">1642<h3 id="sdkpluginconfig">

1641 `SdkPluginConfig`1643 `SdkPluginConfig`

agent-sdk/streaming-vs-single-mode.md +15 −13

Details

16* **Einzelne Nachricht-Eingabe**: One-Shot-Abfragen, die Sitzungszustand und Wiederaufnahme verwenden16* **Einzelne Nachricht-Eingabe**: One-Shot-Abfragen, die Sitzungszustand und Wiederaufnahme verwenden

17 17

18<h2 id="streaming-input-mode-recommended">18<h2 id="streaming-input-mode-recommended">

~~19 Streaming-Eingabemodus (Empfohlen)~~19 Streaming-Eingabemodus (empfohlen)

20</h2>20</h2>

21 21

22Der Streaming-Eingabemodus ist die **bevorzugte** Methode zur Verwendung des Claude Agent SDK. Er bietet vollständigen Zugriff auf die Fähigkeiten des Agenten und ermöglicht umfangreiche, interaktive Erfahrungen.22Der Streaming-Eingabemodus ist die **bevorzugte** Methode zur Verwendung des Claude Agent SDK. Er bietet vollen Zugriff auf die Fähigkeiten des Agenten und ermöglicht umfassende, interaktive Erfahrungen.

23 23

24Er ermöglicht es dem Agenten, als langlebiger Prozess zu fungieren, der Benutzereingaben entgegennimmt, Unterbrechungen verarbeitet, Berechtigungsanfragen anzeigt und die Sitzungsverwaltung übernimmt.24Er ermöglicht es dem Agenten, als langlebiger Prozess zu arbeiten, der Benutzereingaben entgegennimmt, Unterbrechungen verarbeitet, Berechtigungsanfragen anzeigt und die Sitzungsverwaltung übernimmt.

25 25

26<h3 id="benefits">26<h3 id="benefits">

27 Vorteile27 Vorteile

28</h3>28</h3>

29 29

~~30Im Streaming-Eingabemodus arbeiten Sie in einer persistenten Sitzung mit diesen Fähigkeiten:~~30Im Streaming-Eingabemodus arbeiten Sie in einer persistenten Sitzung mit diesen Funktionen:

31 31

~~32* **Bild-Uploads**: Bilder direkt an Nachrichten anhängen für visuelle Analyse und Verständnis~~32* **Bild-Uploads**: Hängen Sie Bilder direkt an Nachrichten an, um sie visuell analysieren und verstehen zu lassen

~~33* **Warteschlangen-Nachrichten**: Mehrere Nachrichten senden, die sequenziell verarbeitet werden, mit der Möglichkeit zu unterbrechen~~33* **Nachrichten in der Warteschlange**: Senden Sie mehrere Nachrichten, die nacheinander verarbeitet werden, mit der Möglichkeit zur Unterbrechung

~~34* **Tool-Integration**: Vollständiger Zugriff auf alle Tools und benutzerdefinierten MCP-Server während der Sitzung~~34* **Tool-Integration**: Voller Zugriff auf alle Tools und benutzerdefinierten MCP-Server während der Sitzung

~~35* **Echtzeit-Feedback**: Sehen Sie Antworten, während sie generiert werden, nicht nur die endgültigen Ergebnisse~~35* **Echtzeit-Feedback**: Sehen Sie Antworten, während sie generiert werden, nicht nur die Endergebnisse

~~36* **Kontext-Persistenz**: Behalten Sie den Gesprächskontext über mehrere Umdrehungen hinweg natürlich bei~~36* **Kontextpersistenz**: Behalten Sie den Konversationskontext über mehrere Turns hinweg auf natürliche Weise bei

37 37

38<h3 id="implementation-example">38<h3 id="implementation-example">

39 Implementierungsbeispiel39 Implementierungsbeispiel

40</h3>40</h3>

41 41

~~42Diese Beispiele lesen ein Bild namens `diagram.png` aus dem Arbeitsverzeichnis. Erstellen Sie zuerst eines dort, oder ändern Sie den Dateinamen, um auf Ihr eigenes Bild zu verweisen.~~42Diese Beispiele lesen ein Bild namens `diagram.png` aus dem Arbeitsverzeichnis. Erstellen Sie dort zuerst eines, oder ändern Sie den Dateinamen so, dass er auf Ihr eigenes Bild verweist.

43 43

44<CodeGroup>44<CodeGroup>

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

164 ```164 ```

165</CodeGroup>165</CodeGroup>

166 166

167Wenn Sie das Beispiel ausführen, gibt die TypeScript-Version jede Antwort aus, sobald sie abgeschlossen ist. Die `receive_response()`-Schleife der Python-Version endet bei der ersten Ergebnismeldung, daher gibt sie die Sicherheitsanalyse aus. Um beide Antworten zu lesen, verwenden Sie ein `query()`- und `receive_response()`-Paar pro Nachricht, wie im [Beispiel der Python-Referenz zum Fortsetzen einer Konversation](/docs/de/agent-sdk/python#example-continuing-a-conversation) gezeigt.167Wenn Sie das Beispiel ausführen, gibt die TypeScript-Version jede Antwort aus, sobald sie abgeschlossen ist. Die `receive_response()`-Schleife der Python-Version endet bei der ersten Ergebnisnachricht, sodass sie die Sicherheitsanalyse ausgibt; um beide Antworten zu lesen, verwenden Sie pro Nachricht ein Paar aus `query()` und `receive_response()`, wie im [Beispiel der Python-Referenz zum Fortsetzen einer Konversation](/docs/de/agent-sdk/python#example-continuing-a-conversation) gezeigt.

168

169Wenn die `source` eines Bildblocks fehlt oder kein Objekt ist, meldet das SDK keinen Fehler. Claude Code sendet Claude anstelle des Bildes einen Texthinweis, etwa `[Image could not be processed: image block has no source object]`, und die Sitzung wird fortgesetzt.

168 170

169<Note>171<Note>

170 Im TypeScript SDK endet der Stream mit einem Fehler, der `Claude Code process aborted by user` lautet, wenn Ihr Nachrichtengenerator beispielsweise eine fehlende Datei liest, anstatt den ursprünglichen Fehler anzuzeigen. Überprüfen Sie daher zuerst den Code in Ihrem Generator, wenn Sie diese Meldung sehen. Der Fehler kann auch einer langen verkleinerten Zeile mit gebündeltem SDK-Quellcode vorangehen, daher lesen Sie bis zum Ende der Ausgabe, um den Fehlertext zu finden.172 Wenn im TypeScript SDK Ihr Nachrichtengenerator eine Ausnahme auslöst, beispielsweise weil eine Datei fehlt, die er liest, endet der Stream mit einem Fehler mit dem Text `Claude Code process aborted by user` anstelle des ursprünglichen Fehlers. Prüfen Sie daher zuerst den Code in Ihrem Generator, wenn Sie diese Meldung sehen. Dem Fehler kann außerdem eine lange minifizierte Zeile des gebündelten SDK-Quellcodes vorangehen, lesen Sie die Ausgabe also bis zum Ende, um den Fehlertext zu finden.

171 173

172 Im Python SDK wird eine Generatorausnahme auf Debug-Ebene protokolliert und die Sitzung stellt sich ohne Auslösen ein. Wenn also eine Streaming-Sitzung ohne Ausgabe hängen bleibt, aktivieren Sie Debug-Protokollierung und überprüfen Sie Ihren Generator.174 Im Python SDK wird eine Ausnahme im Generator auf Debug-Ebene protokolliert, und die Sitzung bleibt hängen, ohne eine Ausnahme auszulösen. Wenn eine Streaming-Sitzung also ohne Ausgabe hängen bleibt, aktivieren Sie das Debug-Logging und prüfen Sie Ihren Generator.

173</Note>175</Note>

174 176

175<h2 id="single-message-input">177<h2 id="single-message-input">

agent-sdk/subagents.md +1 −1

Details

204| Tool-Definitionen (geerbt vom übergeordneten Agent oder die Teilmenge in `tools`, [gefiltert für Hintergrund-Läufe](/docs/de/sub-agents#available-tools)) | Der System-Prompt des übergeordneten Agenten |204| Tool-Definitionen (geerbt vom übergeordneten Agent oder die Teilmenge in `tools`, [gefiltert für Hintergrund-Läufe](/docs/de/sub-agents#available-tools)) | Der System-Prompt des übergeordneten Agenten |

205 205

206<Note>206<Note>

207 Der übergeordnete Agent erhält die letzte Nachricht des Subagenten 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 Hauptaufruf `query()` übergeben.207 Der übergeordnete Agent erhält den abschließenden Bericht des Subagenten, kann ihn 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 Hauptaufruf `query()` übergeben.

208 208

209 In v2.1.210 und später [scannt Claude Code die letzte Nachricht auf anweisungsähnliche Muster](/docs/de/sub-agents#subagent-output-scanning), bevor der übergeordnete Agent sie liest. Der Scan behandelt drei Arten von Mustern unterschiedlich:209 In v2.1.210 und später [scannt Claude Code die letzte Nachricht auf anweisungsähnliche Muster](/docs/de/sub-agents#subagent-output-scanning), bevor der übergeordnete Agent sie liest. Der Scan behandelt drei Arten von Mustern unterschiedlich:

210 210

agent-sdk/typescript.md +37 −36

Details

1596 1596

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

1598 1598

1599Für das `Agent`-Tool ist `tool_use_result` [`AgentOutput`](#agent-2). Bei einem `completed`-Ergebnis enthält `content` den Bericht des Subagenten ohne die Agent-ID und den Nutzungs-Trailer, den Claude Code an den `tool_result`-Text anhängt, daher rendern Sie stattdessen aus `tool_use_result`.1599Für das `Agent`-Tool ist `tool_use_result` [`AgentOutput`](#agent-2). Rendern Sie daraus, anstatt den `tool_result`-Text zu analysieren. Bei einem `completed`-Ergebnis enthält `content` den Bericht des Subagenten oder, bei einem Subagenten, dessen Bericht über einen `SubagentHandback`-Tool-Aufruf läuft, anstelle des Berichts einen kurzen Hinweis auf diese Übergabe. Im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) ab Claude Code v2.1.271 berichtet jeder Subagent, der ein `completed`-Ergebnis erzeugt, auf diese Weise, sofern er kein [Fork](/docs/de/sub-agents#fork-the-current-conversation) ist, und Claude erhält den Bericht als separate Nachricht vom Subagenten.

1600 1600

1601Für ein MCP-Tool, dessen Ergebnis `resource_link`-Blöcke enthält, ist `tool_use_result` ein Objekt mit einem `resourceLinks`-Array von [`SDKMcpResourceLink`](#sdkmcpresourcelink)-Einträgen. Claude empfängt jeden Link als Textzeile im `tool_result`-Block, daher lesen Sie `resourceLinks`, um die vom Server zurückgegebenen Dateien zu rendern, anstatt diesen Text zu analysieren. Claude Code lässt `resourceLinks` weg, wenn das Ergebnis keine Links hat und bei Ergebnissen von Subagenten, behält höchstens 50 Links pro Ergebnis und stoppt das Hinzufügen von Links, sobald das Array 64 KiB serialisiertes JSON erreicht. `resourceLinks` erfordert Agent SDK v0.3.257 oder später.1601Für ein MCP-Tool, dessen Ergebnis `resource_link`-Blöcke enthält, ist `tool_use_result` ein Objekt mit einem `resourceLinks`-Array von [`SDKMcpResourceLink`](#sdkmcpresourcelink)-Einträgen. Claude empfängt jeden Link als Textzeile im `tool_result`-Block, daher lesen Sie `resourceLinks`, um die vom Server zurückgegebenen Dateien zu rendern, anstatt diesen Text zu analysieren. Claude Code lässt `resourceLinks` weg, wenn das Ergebnis keine Links hat und bei Ergebnissen von Subagenten, behält höchstens 50 Links pro Ergebnis und stoppt das Hinzufügen von Links, sobald das Array 64 KiB serialisiertes JSON erreicht. `resourceLinks` erfordert Agent SDK v0.3.257 oder später.

1602 1602

5141```5141```

5142 5142

5143<Warning>5143<Warning>

5144 Das `context-1m-2025-08-07`-Beta ist ab dem 30. April 2026 veraltet. Das Übergeben dieses Wertes 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 Opus 5.5, Claude Opus 5, 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.5144 In der Claude API ist die Beta `context-1m-2025-08-07` für Claude Sonnet 4.5 und Claude Sonnet 4 nicht mehr verfügbar. Wenn Sie sie weiterhin mit einem dieser Modelle übergeben, geben Anfragen, die das Standard-Kontextfenster von 200K Token überschreiten, einen Fehler zurück; entfernen Sie sie daher aus `betas`. Um eine Sitzung mit einem Kontextfenster von 1M Token auszuführen, setzen Sie `model` auf ein Modell, das [standardmäßig mit dem 1M-Fenster läuft](/docs/de/model-config#extended-context), z. B. `claude-sonnet-5-5` oder `claude-opus-5-5`. Bei einem Modell, das 1M nur über seine `[1m]`-Variante erreicht, hängen Sie das Suffix an die Modell-ID an, wie in `claude-opus-4-6[1m]`.

5145</Warning>5145</Warning>

5146 5146

5147<h3 id="slashcommand">5147<h3 id="slashcommand">

5185| Feld | Typ | Beschreibung |5185| Feld | Typ | Beschreibung |

5186| :- | :- | :- |5186| :- | :- | :- |

5188| `resolvedModel` | `string \| undefined` | Kanonische Wire-Modell-ID, in die sich der `value` dieses Eintrags auflöst. Ein Alias-Eintrag wie `sonnet` wird in eine explizite Modell-ID wie `claude-sonnet-5` aufgelöst, sodass ein Host eine gespeicherte explizite Modell-ID mit dem Alias-Eintrag abgleichen kann, der sie abdeckt. Erfordert Claude Code v2.1.197 oder später. |5188| `resolvedModel` | `string \| undefined` | Die Modell-ID, in die sich der `value` dieses Eintrags auflöst, z. B. `claude-sonnet-5-5` für den Alias-Eintrag `sonnet`. Erfordert Claude Code v2.1.197 oder später. |

5196 5196

5197<h3 id="agentinfo">5197<h3 id="agentinfo">

5230| Feld | Typ | Beschreibung |5230| Feld | Typ | Beschreibung |

5231| :- | :- | :- |5231| :- | :- | :- |

5234 5234

5235`source` nimmt einen der folgenden Werte an. Die Menge ist offen, daher behandeln Sie einen Wert, den Sie nicht erkennen, als konfigurierte Quelle, niemals als `sdk`:5235`source` nimmt einen der folgenden Werte an. Die Menge ist offen, daher behandeln Sie einen Wert, den Sie nicht erkennen, als konfigurierte Quelle, niemals als `sdk`:

5236 5236

5237* **`sdk`**: ein In-Process-Server, den Ihre Anwendung registriert hat. Nur die SDK-Host-Anwendung kann einen registrieren, daher meldet ein konfigurierter Server niemals `sdk`, unabhängig von seinem Namen.5237* **`sdk`**: ein In-Process-Server, den Ihre Anwendung registriert hat. Nur die SDK-Host-Anwendung kann einen registrieren, daher meldet ein konfigurierter Server niemals `sdk`, unabhängig von seinem Namen.

5238* **`plugin`**: ein Server, den ein [Plugin](/docs/de/agent-sdk/plugins) bereitstellt. Sein `name` ist die scoped `plugin:<plugin-name>:<server-name>`-Form, die unter [Plugin-bereitgestellte MCP-Server](/docs/de/mcp#plugin-provided-mcp-servers) beschrieben wird.5238* **`plugin`**: ein Server, den ein [Plugin](/docs/de/agent-sdk/plugins) bereitstellt. Sein `name` ist die scoped `plugin:<plugin-name>:<server-name>`-Form, die unter [Plugin-bereitgestellte MCP-Server](/docs/de/mcp#plugin-provided-mcp-servers) beschrieben wird.

5239* **Ein Konfigurationsbereich**: `user`, `project`, `local`, `dynamic`, `managed`, `enterprise`, `claudeai` oder `agent`. Ein `.mcp.json`-Server meldet `project`, und [MCP-Installationsbereiche](/docs/de/mcp#mcp-installation-scopes) definiert `local`, `project` und `user`. Server, die Ihre Anwendung in der [`mcpServers`-Option](#options) übergibt, außer In-Process-SDK-Servern, melden `dynamic`.5239* **Ein Konfigurations-Geltungsbereich**: `user`, `project`, `local`, `dynamic`, `managed`, `enterprise`, `claudeai` oder `agent`. Ein `.mcp.json`-Server meldet `project`, und [Geltungsbereiche der MCP-Installation](/docs/de/mcp#mcp-installation-scopes) definiert `local`, `project` und `user`. Server, die Ihre Anwendung in der [`mcpServers`-Option](#options) übergibt, außer In-Process-SDK-Servern, melden `dynamic`.

5240 5240

5241Basieren Sie Vertrauensentscheidungen auf `source`, nicht auf `name` oder dem `mcp__<server>__`-Tool-Namen-Präfix. Für jede Quelle außer `sdk` ist `name` nicht vertrauenswürdiger Text: maskieren Sie ihn vor der Anzeige.5241Basieren Sie Vertrauensentscheidungen auf `source`, nicht auf `name` oder dem `mcp__<server>__`-Tool-Namen-Präfix. Für jede Quelle außer `sdk` ist `name` nicht vertrauenswürdiger Text: maskieren Sie ihn vor der Anzeige.

5242 5242

5314 `ModelUsage`5314 `ModelUsage`

5315</h3>5315</h3>

5316 5316

5317Pro-Modell-Nutzungsstatistiken, die in Ergebnis-Nachrichten zurückgegeben werden. Der `costUSD`-Wert ist eine clientseitige Schätzung. Siehe [Kosten und Nutzung verfolgen](/docs/de/agent-sdk/cost-tracking) für Abrechnungsvorbehalt.5317Pro-Modell-Nutzungsstatistiken, die in Ergebnis-Nachrichten zurückgegeben werden. Der `costUSD`-Wert ist eine clientseitige Schätzung. Siehe [Kosten und Nutzung verfolgen](/docs/de/agent-sdk/cost-tracking) für Abrechnungsvorbehalte.

5318 5318

5319```typescript theme={null}5319```typescript theme={null}

5320type ModelUsage = {5320type ModelUsage = {

5333};5333};

5334```5334```

5335 5335

5336`thinkingTokens` zählt die Denk-Token, die dieses Modell generiert hat. `outputTokens` enthält sie bereits, daher addieren Sie die beiden nicht zusammen. Das Feld fehlt, bis ein Turn auf einer Claude-Code-Version läuft, die es aufzeichnet, daher meldet eine fortgesetzte Sitzung, die auf einer früheren Version begann, eine teilweise Anzahl. `thinkingTokens` erfordert Agent SDK v0.3.257 oder später.5336`thinkingTokens` zählt die Thinking-Token, die dieses Modell generiert hat. `outputTokens` enthält sie bereits, daher addieren Sie die beiden nicht zusammen. Das Feld fehlt, bis ein Turn auf einer Claude-Code-Version läuft, die es aufzeichnet, daher meldet eine fortgesetzte Sitzung, die auf einer früheren Version begann, eine teilweise Anzahl. `thinkingTokens` erfordert Agent SDK v0.3.257 oder später.

5337 5337

5338Die Felder `canonicalModel` und `provider` erfordern Claude Code v2.1.218 oder später. `canonicalModel` ist die kanonische Modell-ID, die die Preissuche verwendet; sie kann sich von der rohen Modell-Zeichenkette unterscheiden, die den Eintrag indiziert, z. B. wenn diese Zeichenkette eine anbieter-spezifische ID oder ein Alias ist.5338Die Felder `canonicalModel` und `provider` erfordern Claude Code v2.1.218 oder später. `canonicalModel` ist die kanonische Modell-ID, die die Preissuche verwendet; sie kann sich von der rohen Modell-Zeichenkette unterscheiden, die den Eintrag indiziert, z. B. wenn diese Zeichenkette eine anbieter-spezifische ID oder ein Alias ist.

5339 5339

5340`provider` benennt das API-Backend, das das Modell bereitgestellt hat, z. B. `firstParty`, `bedrock`, `vertex`, `foundry`, `anthropicAws`, `mantle` oder `gateway`.5340`provider` benennt das API-Backend, das das Modell bereitgestellt hat, z. B. `firstParty`, `bedrock`, `vertex`, `foundry`, `anthropicAws`, `mantle` oder `gateway`.

5341 5341

5342`costBasis` benennt die Preistabelle, die das Modell der letzten Anfrage bepreist hat: `list` für Listenpreis, `managed` für eine [`modelPricing`](/docs/de/settings-reference#modelpricing)-Tabelle, oder `unknown`, wenn keine die Modell-ID abglich. Das Feld erfordert Claude Code v2.1.246 oder später.5342`costBasis` benennt die Preistabelle, die die letzte Anfrage des Modells bepreist hat: `list` für Listenpreis, `managed` für eine [`modelPricing`](/docs/de/settings-reference#modelpricing)-Tabelle, oder `unknown`, wenn keine zur Modell-ID passte. Das Feld erfordert Claude Code v2.1.246 oder später.

5343 5343

5344<h3 id="configscope">5344<h3 id="configscope">

5345 `ConfigScope`5345 `ConfigScope`

5388 5388

5389`BetaServerToolUsage`, `BetaIterationsUsage` und `BetaOutputTokensDetails` sind in `@anthropic-ai/sdk` definiert.5389`BetaServerToolUsage`, `BetaIterationsUsage` und `BetaOutputTokensDetails` sind in `@anthropic-ai/sdk` definiert.

5390 5390

5391`output_tokens_details` unterteilt die abgerechnete Ausgabe nach Kategorie. Sie trägt derzeit ein Feld, `thinking_tokens: number`, das die Ausgabe-Token zählt, die das Modell als interne Überlegung generiert hat, einschließlich der Denk-Block-Trennzeichen. Das Feld `output_tokens_details` erfordert TypeScript SDK v0.3.228 oder später, das Claude Code v2.1.228 bündelt.5391`output_tokens_details` unterteilt die abgerechnete Ausgabe nach Kategorie. Sie trägt derzeit ein Feld, `thinking_tokens: number`, das die Ausgabe-Token zählt, die das Modell als interne Überlegung generiert hat, einschließlich der Trennzeichen der Thinking-Blöcke. Das Feld `output_tokens_details` erfordert TypeScript SDK v0.3.228 oder später, das Claude Code v2.1.228 bündelt.

5392 5392

5393* **Abrechnung**: Lesen Sie die Aufschlüsselung zur Beobachtung, nicht zur Abrechnung. `output_tokens` bleibt die autoritative Summe, und `output_tokens - thinking_tokens` approximiert die Nicht-Reasoning-Ausgabe.5393* **Abrechnung**: Lesen Sie die Aufschlüsselung zur Beobachtung, nicht zur Abrechnung. `output_tokens` bleibt die autoritative Summe, und `output_tokens - thinking_tokens` approximiert die Nicht-Reasoning-Ausgabe.

5394* **Was die Anzahl abdeckt**: das rohe Reasoning, das das Modell produziert hat, das länger sein kann als der Denk-Text, der im Antwortkörper zurückgegeben wird. Die API berechnet es durch erneutes Tokenisieren dieses rohen Textes, daher kann es sich um einige Token von der genauen Generierungsanzahl des Modells unterscheiden.5394* **Was die Anzahl abdeckt**: das rohe Reasoning, das das Modell produziert hat, das länger sein kann als der Thinking-Text, der im Response-Body zurückgegeben wird. Die API berechnet es durch erneutes Tokenisieren dieses rohen Textes, daher kann es sich um einige Token von der genauen Generierungsanzahl des Modells unterscheiden.

5395* **Streaming**: Bei gestreamten Assistenten-Nachrichten ist diese Aufschlüsselung wie `output_tokens` ein `message_start`-Platzhalter und trägt keine echte Anzahl, daher lesen Sie sie aus der Ergebnis-Nachricht `usage`, wie [Ausgabe-Token aus der Ergebnis-Nachricht lesen](/docs/de/agent-sdk/cost-tracking#read-output-tokens-from-the-result-message) beschreibt. In der Ergebnis-Nachricht liest `thinking_tokens` `0`, wenn das Modell oder der Provider keine Aufschlüsselung meldet.5395* **Streaming**: Bei gestreamten Assistenten-Nachrichten ist diese Aufschlüsselung wie `output_tokens` ein `message_start`-Platzhalter und trägt keine echte Anzahl, daher lesen Sie sie aus der Ergebnis-Nachricht `usage`, wie [Ausgabe-Token aus der Ergebnis-Nachricht lesen](/docs/de/agent-sdk/cost-tracking#read-output-tokens-from-the-result-message) beschreibt. In der Ergebnis-Nachricht liest `thinking_tokens` `0`, wenn das Modell oder der Provider keine Aufschlüsselung meldet.

5396* **`null`-Fälle**: `output_tokens_details` selbst ist `null` bei Assistenten-Nachrichten, die Claude Code synthetisiert, z. B. API-Fehler-Nachrichten.5396* **`null`-Fälle**: `output_tokens_details` selbst ist `null` bei Assistenten-Nachrichten, die Claude Code synthetisiert, z. B. API-Fehler-Nachrichten.

5397 5397

5446 `ThinkingConfig`5446 `ThinkingConfig`

5447</h3>5447</h3>

5448 5448

5449Steuert das Denk-/Reasoning-Verhalten von Claude. Hat Vorrang vor dem veralteten `maxThinkingTokens`.5449Steuert das Thinking-/Reasoning-Verhalten von Claude. Hat Vorrang vor dem veralteten `maxThinkingTokens`.

5450 5450

5451```typescript theme={null}5451```typescript theme={null}

5452type ThinkingDisplay = "summarized" | "omitted";5452type ThinkingDisplay = "summarized" | "omitted";

5453 5453

5454type ThinkingConfig =5454type ThinkingConfig =

5455 | { type: "adaptive"; display?: ThinkingDisplay } // Das Modell bestimmt, wann und wie viel zu denken ist (Opus 4.6+)5455 | { type: "adaptive"; display?: ThinkingDisplay } // Das Modell bestimmt, wann und wie viel nachgedacht wird (Opus 4.6+)

5456 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Festes Denk-Token-Budget5456 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Festes Thinking-Token-Budget

5457 | { type: "disabled" }; // Kein erweitertes Denken5457 | { type: "disabled" }; // Kein Extended Thinking

5458```5458```

5459 5459

5460Das optionale `display`-Feld steuert, ob Denk-Text `"summarized"` oder `"omitted"` zurückgegeben wird. Bei Claude Opus 4.7 und später ist der API-Standard `"omitted"`, daher setzen Sie `"summarized"`, um Denk-Inhalte in `thinking`-Blöcken zu erhalten. Claude Code sendet `display` nicht an Amazon Bedrock oder Google Cloud's Agent Platform, daher geben Opus 4.7 und später auf diesen Anbietern leere `thinking`-Blöcke zurück, auch wenn Sie `display` auf `"summarized"` setzen.5460Das optionale `display`-Feld steuert, ob Thinking-Text `"summarized"` oder `"omitted"` zurückgegeben wird. Bei Claude Opus 4.7 und später ist der API-Standard `"omitted"`, daher setzen Sie `"summarized"`, um Thinking-Inhalte in `thinking`-Blöcken zu erhalten. Claude Code sendet `display` nicht an Amazon Bedrock oder Google Cloud's Agent Platform, daher geben Opus 4.7 und später auf diesen Anbietern leere `thinking`-Blöcke zurück, auch wenn Sie `display` auf `"summarized"` setzen.

5461 5461

5462<h3 id="spawnedprocess">5462<h3 id="spawnedprocess">

5463 `SpawnedProcess`5463 `SpawnedProcess`

5576 `SDKTaskNotificationMessage`5576 `SDKTaskNotificationMessage`

5577</h3>5577</h3>

5578 5578

5579Benachrichtigung, wenn eine Hintergrund-Aufgabe abgeschlossen, fehlgeschlagen oder gestoppt wird. Hintergrund-Aufgaben umfassen `run_in_background` Bash-Befehle, [Monitor](#monitor)-Watches und Hintergrund-Subagenten. Für das `ambient`-Feld siehe [`SDKTaskStartedMessage`](#sdktaskstartedmessage), das es definiert und seine Versionsanforderung.5579Benachrichtigung, wenn eine Hintergrundaufgabe abgeschlossen, fehlgeschlagen oder gestoppt wird. Hintergrundaufgaben umfassen `run_in_background` Bash-Befehle, [Monitor](#monitor)-Watches und Hintergrund-Subagenten. Für das `ambient`-Feld siehe [`SDKTaskStartedMessage`](#sdktaskstartedmessage), das es und seine Versionsanforderung definiert.

5580 5580

5581```typescript theme={null}5581```typescript theme={null}

5582type SDKTaskNotificationMessage = {5582type SDKTaskNotificationMessage = {

5716 5716

5717Während ein Tool-Aufruf in der Hauptkonversation läuft, gibt Claude Code alle 30 Sekunden eine `tool_progress`-Nachricht mit `heartbeat: true` aus. Jeder Heartbeat trägt den Tool-Namen und verstrichene Sekunden, daher können Sie einen lang laufenden Aufruf von einer steckengebliebenen Sitzung unterscheiden. Claude Code gibt keine Heartbeats für Tool-Aufrufe innerhalb eines Subagenten aus. Das `heartbeat`-Feld erfordert Agent SDK v0.3.214 oder später. Vor v2.1.257 gab Claude Code auch keine Heartbeats für einen Vordergrund-Agent-Tool-Aufruf aus.5717Während ein Tool-Aufruf in der Hauptkonversation läuft, gibt Claude Code alle 30 Sekunden eine `tool_progress`-Nachricht mit `heartbeat: true` aus. Jeder Heartbeat trägt den Tool-Namen und verstrichene Sekunden, daher können Sie einen lang laufenden Aufruf von einer steckengebliebenen Sitzung unterscheiden. Claude Code gibt keine Heartbeats für Tool-Aufrufe innerhalb eines Subagenten aus. Das `heartbeat`-Feld erfordert Agent SDK v0.3.214 oder später. Vor v2.1.257 gab Claude Code auch keine Heartbeats für einen Vordergrund-Agent-Tool-Aufruf aus.

5718 5718

5719Bei `tool_progress`-Nachrichten für das Agent-Tool außer Heartbeats benennt `subagent_type` den laufenden Subagenten-Typ, z. B. `general-purpose`. `subagent_retry` ist vorhanden, während dieser Subagent einen API-Fehler-Backoff wartet, z. B. ein Ratenlimit oder Überlastung, mit einer Nachricht pro Wiederholungsversuch. Beide Felder erfordern Agent SDK v0.3.214 oder später.5719Bei `tool_progress`-Nachrichten für das Agent-Tool außer Heartbeats benennt `subagent_type` den laufenden Subagenten-Typ, z. B. `general-purpose`. `subagent_retry` ist vorhanden, während dieser Subagent einen API-Fehler-Backoff abwartet, z. B. ein Rate-Limit oder eine Überlastung, mit einer Nachricht pro Wiederholungsversuch. Beide Felder erfordern Agent SDK v0.3.214 oder später.

5720 5720

5721Um einen Wiederholungs-Indikator aus `subagent_retry` zu rendern:5721Um einen Wiederholungs-Indikator aus `subagent_retry` zu rendern:

5722 5722

5723* Verfolgen Sie den Indikator nach `parent_tool_use_id`, das pro Subagent eindeutig ist. `tool_use_id` wird von parallelen Subagenten aus einem Assistenten-Turn geteilt, daher würde die Verfolgung danach den Indikator eines Subagenten löschen. Löschen Sie den Indikator, wenn ein späterer `tool_progress` für den gleichen `parent_tool_use_id` ankommt, ohne `subagent_retry` noch `heartbeat: true`, oder wenn die Ergebnis-Nachricht des Tools ankommt. Frames mit `heartbeat: true` melden nur Lebendigkeit, daher behalten Sie den Indikator, wenn einer ankommt. `attempt` kann `max_retries` unter persistenter Wiederholung überschreiten, daher leiten Sie das Löschen nicht von den Zählern ab.5723* Verfolgen Sie den Indikator nach `parent_tool_use_id`, das pro Subagent eindeutig ist. `tool_use_id` wird von parallelen Subagenten aus einem Assistenten-Turn geteilt, daher würde die Verfolgung danach zulassen, dass das Update eines Subagenten den Indikator eines anderen löscht.

5724* Löschen Sie den Indikator, wenn ein späterer `tool_progress` für den gleichen `parent_tool_use_id` weder mit `subagent_retry` noch mit `heartbeat: true` ankommt, oder wenn die Ergebnis-Nachricht des Tools ankommt. Frames mit `heartbeat: true` melden nur Lebendigkeit, daher behalten Sie den Indikator, wenn einer ankommt. `attempt` kann `max_retries` bei persistenten Wiederholungsversuchen überschreiten, daher leiten Sie das Löschen nicht von den Zählern ab.

5724* Behandeln Sie `error_category` als Token zur Auswahl Ihres eigenen Nachrichtentextes, nicht als Anzeigetext. Die Werte sind `rate_limit`, `overloaded`, `authentication_failed`, `server_error`, `cloud_credential_error` und `unknown`. Behandeln Sie einen Wert, den Sie nicht erkennen, wie `unknown`, weil spätere Versionen Werte hinzufügen können.5725* Behandeln Sie `error_category` als Token zur Auswahl Ihres eigenen Nachrichtentextes, nicht als Anzeigetext. Die Werte sind `rate_limit`, `overloaded`, `authentication_failed`, `server_error`, `cloud_credential_error` und `unknown`. Behandeln Sie einen Wert, den Sie nicht erkennen, wie `unknown`, weil spätere Versionen Werte hinzufügen können.

5725 5726

5726<h3 id="sdkauthstatusmessage">5727<h3 id="sdkauthstatusmessage">

5777 `SDKTaskProgressMessage`5778 `SDKTaskProgressMessage`

5778</h3>5779</h3>

5779 5780

5780Wird regelmäßig ausgegeben, während ein Subagent oder eine Hintergrund-Aufgabe läuft.5781Wird regelmäßig ausgegeben, während ein Subagent oder eine Hintergrundaufgabe läuft.

5781 5782

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

5783 5784

5784```typescript theme={null}5785```typescript theme={null}

5785type SDKTaskProgressMessage = {5786type SDKTaskProgressMessage = {

5805 `SDKTaskUpdatedMessage`5806 `SDKTaskUpdatedMessage`

5806</h3>5807</h3>

5807 5808

5808Wird ausgegeben, wenn sich der Status einer Hintergrund-Aufgabe ändert, z. B. wenn sie von `running` zu `completed` übergeht. Führen Sie `patch` in Ihre lokale Aufgabenkarte zusammen, die nach `task_id` indiziert ist. Das `end_time`-Feld ist ein Unix-Epoch-Zeitstempel in Millisekunden, vergleichbar mit `Date.now()`.5809Wird ausgegeben, wenn sich der Status einer Hintergrundaufgabe ändert, z. B. wenn sie von `running` zu `completed` übergeht. Führen Sie `patch` in Ihre lokale Aufgabenkarte zusammen, die nach `task_id` indiziert ist. Das `end_time`-Feld ist ein Unix-Epoch-Zeitstempel in Millisekunden, vergleichbar mit `Date.now()`.

5809 5810

5810```typescript theme={null}5811```typescript theme={null}

5811type SDKTaskUpdatedMessage = {5812type SDKTaskUpdatedMessage = {

5829 `SDKBackgroundTasksChangedMessage`5830 `SDKBackgroundTasksChangedMessage`

5830</h3>5831</h3>

5831 5832

5832Wird ausgegeben, wenn sich die Menge der aktiven Hintergrund-Aufgaben ändert: eine Aufgabe startet, wird abgeschlossen, wird beendet, ein Vordergrund-Agent wird in den Hintergrund verschoben, oder das `description`- oder `ambient`-Feld einer Aufgabe ändert sich.5833Wird ausgegeben, wenn sich die Menge der aktiven Hintergrundaufgaben ändert: eine Aufgabe startet, wird abgeschlossen, wird beendet, ein Vordergrund-Agent wird in den Hintergrund verschoben, oder das `description`- oder `ambient`-Feld einer Aufgabe ändert sich.

5833 5834

5834Das `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.5835Das `tasks`-Array ist die vollständige aktive Menge. Ersetzen Sie alle zwischengespeicherten Mengen mit jeder Payload, anstatt `task_started`- und `task_notification`-Ereignisse zu koppeln, sodass die nächste Änderung der Mitgliedschaft alle verpassten Ereignisse korrigiert.

5835 5836

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

5837 5838

5860 `SDKThinkingTokensMessage`5861 `SDKThinkingTokensMessage`

5861</h3>5862</h3>

5862 5863

5863Wird ausgegeben, während Claude einen Denk-Block produziert, einschließlich eines redigierten. `estimated_tokens` ist eine laufende Schätzung der bisher im aktuellen Block generierten Denk-Token, und `estimated_tokens_delta` ist das Inkrement, das von diesem Frame getragen wird. Verwenden Sie diese Schätzungen für die Fortschrittsanzeige.5864Wird ausgegeben, während Claude einen Thinking-Block produziert, einschließlich eines redigierten. `estimated_tokens` ist eine laufende Schätzung der bisher im aktuellen Block generierten Thinking-Token, und `estimated_tokens_delta` ist das Inkrement, das von diesem Frame getragen wird. Verwenden Sie diese Schätzungen für die Fortschrittsanzeige.

5864 5865

5865Wenn das Modell oder der Provider eine Aufschlüsselung meldet, ist die endgültige Anzahl für die Top-Level-Agent-Schleife die [`usage.output_tokens_details.thinking_tokens`](#usage) der Ergebnis-Nachricht, die [keine Subagenten-Token enthält](/docs/de/agent-sdk/cost-tracking#get-the-total-cost-of-a-query).5866Wenn das Modell oder der Provider eine Aufschlüsselung meldet, ist die endgültige Anzahl für die Top-Level-Agentenschleife die [`usage.output_tokens_details.thinking_tokens`](#usage) der Ergebnis-Nachricht, die [keine Subagenten-Token enthält](/docs/de/agent-sdk/cost-tracking#get-the-total-cost-of-a-query).

5866 5867

5867Erfordert Claude Code v2.1.153 oder später.5868Erfordert Claude Code v2.1.153 oder später.

5868 5869

5900 `SDKRateLimitEvent`5901 `SDKRateLimitEvent`

5901</h3>5902</h3>

5902 5903

5903Wird ausgegeben, wenn die Sitzung auf ein Ratenlimit trifft.5904Wird ausgegeben, wenn die Sitzung auf ein Rate-Limit trifft.

5904 5905

5905```typescript theme={null}5906```typescript theme={null}

5906type SDKRateLimitEvent = {5907type SDKRateLimitEvent = {

5918};5919};

5919```5920```

5920 5921

5921Wenn `errorCode` `"credits_required"` ist, stammt die Ablehnung von einem claude.ai-Abonnement, dessen enthaltene Nutzung aufgebraucht ist, und die Sitzung kann nicht fortgesetzt werden, bis der Benutzer Nutzungsguthaben kauft. `canUserPurchaseCredits` gibt an, ob der authentifizierte Benutzer Guthaben für das Konto kaufen kann, und `hasChargeableSavedPaymentMethod` gibt an, ob eine gespeicherte Zahlungsmethode hinterlegt ist. Alle drei Felder fehlen bei Ratenlimit-Ereignissen, die keine Guthaben-erforderlich-Ablehnungen sind. Erfordert Claude Code v2.1.181 oder später.5922Wenn `errorCode` `"credits_required"` ist, stammt die Ablehnung von einem claude.ai-Abonnement, dessen enthaltene Nutzung aufgebraucht ist, und die Sitzung kann nicht fortgesetzt werden, bis der Benutzer Nutzungsguthaben kauft. `canUserPurchaseCredits` gibt an, ob der authentifizierte Benutzer Guthaben für das Konto kaufen kann, und `hasChargeableSavedPaymentMethod` gibt an, ob eine gespeicherte Zahlungsmethode hinterlegt ist. Alle drei Felder fehlen bei Rate-Limit-Ereignissen, die keine Guthaben-erforderlich-Ablehnungen sind. Erfordert Claude Code v2.1.181 oder später.

5922 5923

5923<h3 id="sdklocalcommandoutputmessage">5924<h3 id="sdklocalcommandoutputmessage">

5924 `SDKLocalCommandOutputMessage`5925 `SDKLocalCommandOutputMessage`

5925</h3>5926</h3>

5926 5927

5927Claude Code gibt diese Nachrichtentyp nicht aus. Wenn Sie einen Befehl wie `/context` oder `/usage` als Eingabeaufforderung senden, kommt seine Ausgabe als [`SDKAssistantMessage`](#sdkassistantmessage) an.5928Claude Code gibt diesen Nachrichtentyp nicht aus. Wenn Sie einen Befehl wie `/context` oder `/usage` als Prompt senden, kommt seine Ausgabe als [`SDKAssistantMessage`](#sdkassistantmessage) an.

5928 5929

5929```typescript theme={null}5930```typescript theme={null}

5930type SDKLocalCommandOutputMessage = {5931type SDKLocalCommandOutputMessage = {

5940 `SDKCommandsChangedMessage`5941 `SDKCommandsChangedMessage`

5941</h3>5942</h3>

5942 5943

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

5944 5945

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

5946 5947

5958 `SDKPromptSuggestionMessage`5959 `SDKPromptSuggestionMessage`

5959</h3>5960</h3>

5960 5961

5961Wird nach einem Turn ausgegeben, wenn [`promptSuggestions`](#options) aktiviert ist und Claude Code eine Suggestion für diesen Turn generiert hat. Enthält die vorhergesagte nächste Benutzer-Eingabeaufforderung. Für die Turns, die keine erhalten, siehe [Wenn Claude Code Suggestions überspringt](/docs/de/interactive-mode#when-claude-code-skips-suggestions).5962Wird nach einem Turn ausgegeben, wenn [`promptSuggestions`](#options) aktiviert ist und Claude Code eine Suggestion für diesen Turn generiert hat. Enthält den vorhergesagten nächsten Benutzer-Prompt. Für die Turns, die keine erhalten, siehe [Wenn Claude Code Suggestions überspringt](/docs/de/interactive-mode#when-claude-code-skips-suggestions).

5962 5963

5963```typescript theme={null}5964```typescript theme={null}

5964type SDKPromptSuggestionMessage = {5965type SDKPromptSuggestionMessage = {

5995 5996

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

5997 5998

5998Die 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.5999Die 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"` bei der Typprüfung fehl, wenn `skipLibCheck` deaktiviert war.

5999 6000

6000<h3 id="aborterror">6001<h3 id="aborterror">

6001 `AbortError`6002 `AbortError`

6007class AbortError extends Error {}6008class AbortError extends Error {}

6008```6009```

6009 6010

6010`AbortError` ist die einzige Fehlerklasse in der typisierten API des SDK. Andere Fehler, wie das Beenden oder Fehlschlag des Claude-Code-Prozesses, lehnen die Nachrichteniteration mit Fehlern ab, die keine SDK-Klasse zum Abgleichen tragen. [Troubleshooting](/docs/de/agent-sdk/troubleshooting) indiziert diese Fehler nach Nachricht, mit der Ursache und Behebung für jeden.6011`AbortError` ist die einzige Fehlerklasse in der typisierten API des SDK. Andere Fehler, wie das Beenden oder der fehlgeschlagene Start des Claude-Code-Prozesses, lehnen die Nachrichteniteration mit Fehlern ab, die keine SDK-Klasse zum Abgleichen tragen. [Fehlerbehebung](/docs/de/agent-sdk/troubleshooting) ordnet diese Fehler nach Nachricht, mit der Ursache und Behebung für jeden.

6011 6012

6012<h2 id="sandbox-configuration">6013<h2 id="sandbox-configuration">

6013 Sandbox-Konfiguration6014 Sandbox-Konfiguration

amazon-bedrock.md +2 −0

Details

526 526

527Wenn Ihre Organisation die Guardrail-Header stattdessen über eine [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Richtlinie bereitstellt, zählen sie als [Einstellungen, die Genehmigung benötigen](/docs/de/server-managed-settings#environment-variables-and-the-approval-dialog).527Wenn Ihre Organisation die Guardrail-Header stattdessen über eine [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-Richtlinie bereitstellt, zählen sie als [Einstellungen, die Genehmigung benötigen](/docs/de/server-managed-settings#environment-variables-and-the-approval-dialog).

528 528

529Wenn der Guardrail eine Antwort mittendrin blockiert, bleibt der bis dahin gestreamte Text erhalten, und die Antwort endet mit der Nachricht, die auf dem Guardrail für blockierte Antworten konfiguriert ist.

530

529<h2 id="use-the-mantle-endpoint">531<h2 id="use-the-mantle-endpoint">

530 Verwenden Sie den Mantle-Endpunkt532 Verwenden Sie den Mantle-Endpunkt

531</h2>533</h2>

claude-apps-gateway-config.md +296 −176

Details

67| `public_url` | Sofern `host` nicht loopback ist | Der extern sichtbare `https://`-Ursprung, der zum Erstellen des IdP-`redirect_uri` und der Discovery-Metadaten verwendet wird. Erforderlich, wenn `host` keine Loopback-Adresse ist, unabhängig davon, ob TLS bei einem Proxy wie ALB, Ingress oder Cloud Run oder beim Gateway selbst über `tls` beendet wird, da das Gateway seinen eigenen Ursprung niemals aus `X-Forwarded-*`-Headern ableitet; diese können vom Client gefälscht werden. Der Start schlägt ohne diese fehl. `trusted_proxies` unten regelt nur die Client-IP-Auflösung. Auch erforderlich, um [Telemetrie](#telemetry) zu aktivieren, da das Gateway den OTLP-Endpunkt, den es an Clients überträgt, aus dieser URL erstellt. |67| `public_url` | Sofern `host` nicht loopback ist | Der extern sichtbare `https://`-Ursprung, der zum Erstellen des IdP-`redirect_uri` und der Discovery-Metadaten verwendet wird. Erforderlich, wenn `host` keine Loopback-Adresse ist, unabhängig davon, ob TLS bei einem Proxy wie ALB, Ingress oder Cloud Run oder beim Gateway selbst über `tls` beendet wird, da das Gateway seinen eigenen Ursprung niemals aus `X-Forwarded-*`-Headern ableitet; diese können vom Client gefälscht werden. Der Start schlägt ohne diese fehl. `trusted_proxies` unten regelt nur die Client-IP-Auflösung. Auch erforderlich, um [Telemetrie](#telemetry) zu aktivieren, da das Gateway den OTLP-Endpunkt, den es an Clients überträgt, aus dieser URL erstellt. |

69| `trusted_proxies` | Nein | CIDRs oder IPs von Load Balancern vor dem Gateway. Wenn gesetzt, vertraut das Gateway `X-Forwarded-For` nur von diesen Peers und zeichnet die echte Client-IP für Pro-IP-Ratenbegrenzung und Audit auf. Äquivalent zu nginx `set_real_ip_from`. `X-Forwarded-For`-Einträge, die als `ipv4:port` oder `[ipv6]:port` geschrieben sind, wie es einige Load Balancer tun, werden mit dem Port gelesen, der gelöscht wird. Eine IPv6-Adresse mit angehängtem Port und ohne Klammern kann als eine andere Adresse gelesen werden oder überhaupt nicht gelesen werden, daher deaktivieren Sie die Port-Option auf jedem Proxy, der diese Form schreibt. |69| `trusted_proxies` | Nein | CIDRs oder IPs von Load Balancern vor dem Gateway. Wenn gesetzt, vertraut das Gateway `X-Forwarded-For` nur von diesen Peers und zeichnet die echte Client-IP für Rate-Limits pro IP und Audit auf. Äquivalent zu nginx `set_real_ip_from`. `X-Forwarded-For`-Einträge, die als `ipv4:port` oder `[ipv6]:port` geschrieben sind, wie es einige Load Balancer tun, werden ohne den Port gelesen. Eine IPv6-Adresse mit angehängtem Port und ohne Klammern kann als eine andere Adresse gelesen werden oder überhaupt nicht gelesen werden, daher deaktivieren Sie die Port-Option auf jedem Proxy, der diese Form schreibt. |

70 70

71<h3 id="oidc">71<h3 id="oidc">

72 `oidc`72 `oidc`

83| `allowed_email_domains` | Nein | Lehnen Sie id\_tokens ab, deren `email`-Anspruch nicht in einer dieser Domänen liegt, Groß-/Kleinschreibung wird ignoriert. Defense-in-Depth gegen Multi-Tenant-IdP-Fehlkonfiguration. Unabhängig von dieser Einstellung wird ein id\_token, dessen `email_verified`-Anspruch explizit `false` ist, immer abgelehnt. |83| `allowed_email_domains` | Nein | Lehnen Sie id\_tokens ab, deren `email`-Anspruch nicht in einer dieser Domänen liegt, Groß-/Kleinschreibung wird ignoriert. Defense-in-Depth gegen Multi-Tenant-IdP-Fehlkonfiguration. Unabhängig von dieser Einstellung wird ein id\_token, dessen `email_verified`-Anspruch explizit `false` ist, immer abgelehnt. |

84| `allowed_groups` | Nein | Beschränken Sie die Anmeldung auf Mitglieder dieser IdP-Gruppen, abgeglichen gegen `groups_claim`. Ein Benutzer in einer zulässigen E-Mail-Domäne, aber in keiner dieser Gruppen, wird abgelehnt. Erfordert, dass der IdP den Gruppenanspruch ausgibt. Der Abgleich ist ein exakter, Groß-/Kleinschreibung beachtender Zeichenfolgenvergleich gegen die Werte in diesem Anspruch, und das Gateway erweitert verschachtelte Gruppen nicht: Um Mitglieder einer Untergruppe zuzulassen, listen Sie die Untergruppe hier auf oder konfigurieren Sie den IdP so, dass er flache Mitgliedschaften ausgibt. |84| `allowed_groups` | Nein | Beschränken Sie die Anmeldung auf Mitglieder dieser IdP-Gruppen, abgeglichen gegen `groups_claim`. Ein Benutzer in einer zulässigen E-Mail-Domäne, aber in keiner dieser Gruppen, wird abgelehnt. Erfordert, dass der IdP den Gruppenanspruch ausgibt. Der Abgleich ist ein exakter, Groß-/Kleinschreibung beachtender Zeichenfolgenvergleich gegen die Werte in diesem Anspruch, und das Gateway erweitert verschachtelte Gruppen nicht: Um Mitglieder einer Untergruppe zuzulassen, listen Sie die Untergruppe hier auf oder konfigurieren Sie den IdP so, dass er flache Mitgliedschaften ausgibt. |

85| `groups_claim` | Nein | Welcher id\_token-Anspruch trägt die Gruppenmitgliedschaft. Standard `groups`. Microsoft Entra gibt App-Rollen unter `roles` aus. Akzeptiert einen flachen Schlüssel oder einen RFC-6901-JSON-Pointer wie `/resource_access/gateway/roles` für verschachtelte Ansprüche. |85| `groups_claim` | Nein | Welcher id\_token-Anspruch trägt die Gruppenmitgliedschaft. Standard `groups`. Microsoft Entra gibt App-Rollen unter `roles` aus. Akzeptiert einen flachen Schlüssel oder einen RFC-6901-JSON-Pointer wie `/resource_access/gateway/roles` für verschachtelte Ansprüche. |

86| `google_groups` | Nein | Schlagen Sie die Gruppen des angemeldeten Benutzers über die Google Workspace Admin SDK Directory API nach, da Googles id\_token keinen Gruppenanspruch trägt. Setzen Sie `service_account_json_path` auf eine Service-Account-Schlüsseldatei mit Domain-weiter Delegierung im Bereich `https://www.googleapis.com/auth/admin.directory.group.readonly`, und `admin_email` auf einen Workspace-Administrator, den der Service Account annimmt; die Directory API erfordert ein echtes Admin-Subjekt. Die E-Mail-Adressen jeder Benutzergruppe werden zu ihrem Gruppenanspruch, daher stimmen `allowed_groups` und `managed.policies.match.groups` mit Gruppen-E-Mails überein. |86| `google_groups` | Nein | Schlagen Sie die Gruppen des angemeldeten Benutzers über die Google Workspace Admin SDK Directory API nach, da Googles id\_token keinen Gruppenanspruch trägt. Setzen Sie `service_account_json_path` auf eine Service-Account-Schlüsseldatei mit Domain-weiter Delegierung im Scope `https://www.googleapis.com/auth/admin.directory.group.readonly`, und `admin_email` auf einen Workspace-Administrator, den der Service Account annimmt; die Directory API erfordert ein echtes Admin-Subjekt. Die E-Mail-Adressen jeder Benutzergruppe werden zu ihrem Gruppenanspruch, daher stimmen `allowed_groups` und `managed.policies.match.groups` mit Gruppen-E-Mails überein. |

87| `email_claim` | Nein | Welcher id\_token-Anspruch trägt die E-Mail des Benutzers. Standard `email`. Einige IdPs wie ADFS und Entra B2C geben stattdessen `upn` oder `preferred_username` aus. Akzeptiert einen flachen Schlüssel, einen JSON-Pointer oder eine Liste von Fallback-Schlüsseln, wobei der erste vorhandene Schlüssel verwendet wird. |87| `email_claim` | Nein | Welcher id\_token-Anspruch trägt die E-Mail des Benutzers. Standard `email`. Einige IdPs wie ADFS und Entra B2C geben stattdessen `upn` oder `preferred_username` aus. Akzeptiert einen flachen Schlüssel, einen JSON-Pointer oder eine Liste von Fallback-Schlüsseln, wobei der erste vorhandene Schlüssel verwendet wird. |

88| `scopes` | Nein | Vollständige Überschreibung der OIDC-Bereiche, die das Gateway anfordert. Standard `[openid, profile, email, offline_access]`. Setzen Sie, wenn Ihr IdP Bereiche ablehnt, die er nicht erkennt, oder einen benutzerdefinierten Bereich erfordert, um Gruppen oder E-Mail auszugeben. Muss `openid` enthalten. Das Löschen von `offline_access` deaktiviert Aktualisierungstoken, daher führen Entwickler die Browser-Anmeldung alle `session.ttl_hours` erneut aus. Siehe [Identitätsanbieter-Setup](/docs/de/claude-apps-gateway-deploy#identity-provider-setup) für IdP-spezifische Bereichsrezepte wie Googles Aktualisierungstoken-Flow. |88| `scopes` | Nein | Vollständige Überschreibung der OIDC-Scopes, die das Gateway anfordert. Standard `[openid, profile, email, offline_access]`. Setzen Sie, wenn Ihr IdP Scopes ablehnt, die er nicht erkennt, oder einen benutzerdefinierten Scope erfordert, um Gruppen oder E-Mail auszugeben. Muss `openid` enthalten. Das Entfernen von `offline_access` deaktiviert Aktualisierungstoken, daher führen Entwickler die Browser-Anmeldung alle `session.ttl_hours` erneut aus. Siehe [Identitätsanbieter-Setup](/docs/de/claude-apps-gateway-deploy#identity-provider-setup) für IdP-spezifische Scope-Rezepte wie Googles Aktualisierungstoken-Flow. |

89| `scope_on_refresh` | Nein | Senden Sie auch `scope` mit der gleichen Liste wie die Anmeldeanfrage, wenn das Gateway ein Aktualisierungstoken austauscht. Standard `false`: die Aktualisierungsanfrage lässt `scope` weg. Die meisten IdPs geben bei jeder Aktualisierung ein id\_token zurück und benötigen dies nicht. Setzen Sie `true`, wenn Ihr IdP ein id\_token bei Aktualisierung nur zurückgibt, wenn `openid` erneut angefordert wird, was Okta für seinen Aktualisierungszuschuss dokumentiert. Ohne ein id\_token hängt jede Aktualisierung davon ab, dass der Userinfo-Endpunkt des IdP das aktualisierte Zugriffstoken akzeptiert. Wenn Sie die Anmeldung oder Richtlinienabgleiche auf Gruppen beschränken und das id\_token Ihres IdP zur Aktualisierungszeit diese auslässt, setzen Sie auch `userinfo_fallback: true`, damit das Gateway diese vom Userinfo-Endpunkt ausfüllt. Ein IdP, der weniger Bereiche als angefordert gewährte, kann die Aktualisierung mit `invalid_scope` ablehnen, auch für bestehende Sitzungen, wenn Sie Einträge zu `scopes` hinzufügen, während dies aktiviert ist. Heben Sie den Schlüssel auf, wenn Aktualisierungen nach dem Setzen am `token_endpoint` fehlschlagen. Erfordert Claude Code v2.1.260 oder später auf dem Gateway-Server. |89| `scope_on_refresh` | Nein | Senden Sie auch `scope` mit der gleichen Liste wie die Anmeldeanfrage, wenn das Gateway ein Aktualisierungstoken austauscht. Standard `false`: die Aktualisierungsanfrage lässt `scope` weg. Die meisten IdPs geben bei jeder Aktualisierung ein id\_token zurück und benötigen dies nicht. Setzen Sie `true`, wenn Ihr IdP ein id\_token bei Aktualisierung nur zurückgibt, wenn `openid` erneut angefordert wird, was Okta für seinen Refresh-Grant dokumentiert. Ohne ein id\_token hängt jede Aktualisierung davon ab, dass der Userinfo-Endpunkt des IdP das aktualisierte Zugriffstoken akzeptiert. Wenn Sie die Anmeldung oder Richtlinienabgleiche auf Gruppen beschränken und das id\_token Ihres IdP zur Aktualisierungszeit diese auslässt, setzen Sie auch `userinfo_fallback: true`, damit das Gateway diese vom Userinfo-Endpunkt ausfüllt. Ein IdP, der weniger Scopes als angefordert gewährte, kann die Aktualisierung mit `invalid_scope` ablehnen, auch für bestehende Sitzungen, wenn Sie Einträge zu `scopes` hinzufügen, während dies aktiviert ist. Entfernen Sie den Schlüssel, wenn Aktualisierungen nach dem Setzen am `token_endpoint` fehlschlagen. Erfordert Claude Code v2.1.260 oder später auf dem Gateway-Server. |

90| `extra_auth_params` | Nein | Zusätzliche Abfrageparameter, die wörtlich an die IdP-Autorisierungsanfrage angehängt werden. Dies ist der Überschreibungsmechanismus für IdP-spezifisches Verhalten, wie `access_type: offline` für Google-Aktualisierungstoken, `domain_hint` für einige Entra-Mandanten oder `acr_values` für Step-up-Flows. Kann die vom Gateway verwalteten Protokollparameter nicht überschreiben: `state`, `nonce`, `redirect_uri`, PKCE, `scope`, `response_type`, `response_mode` und `client_id`. |90| `extra_auth_params` | Nein | Zusätzliche Abfrageparameter, die wörtlich an die IdP-Autorisierungsanfrage angehängt werden. Dies ist der Überschreibungsmechanismus für IdP-spezifisches Verhalten, wie `access_type: offline` für Google-Aktualisierungstoken, `domain_hint` für einige Entra-Mandanten oder `acr_values` für Step-up-Flows. Kann die vom Gateway verwalteten Protokollparameter nicht überschreiben: `state`, `nonce`, `redirect_uri`, PKCE, `scope`, `response_type`, `response_mode` und `client_id`. |

91| `userinfo_fallback` | Nein | Wenn das id\_token E-Mail oder Gruppen auslässt, rufen Sie diese von `/userinfo` ab. Erforderlich für Keycloak-Lightweight-Zugriffstokens, den Okta-Org-Server und ADFS-Minimal-Tokens. Das id\_token bleibt maßgeblich; userinfo füllt nur Lücken. Standard `false`. |91| `userinfo_fallback` | Nein | Wenn das id\_token E-Mail oder Gruppen auslässt, rufen Sie diese von `/userinfo` ab. Erforderlich für Keycloak-Lightweight-Zugriffstokens, den Okta-Org-Server und ADFS-Minimal-Tokens. Das id\_token bleibt maßgeblich; userinfo füllt nur Lücken. Standard `false`. |

92| `use_pkce` | Nein | Senden Sie eine PKCE-Herausforderung (S256) in der Autorisierungsanfrage. Standard `true`. Setzen Sie `false` nur, wenn Ihr IdP PKCE für diesen vertraulichen Client ablehnt. |92| `use_pkce` | Nein | Senden Sie eine PKCE-Herausforderung (S256) in der Autorisierungsanfrage. Standard `true`. Setzen Sie `false` nur, wenn Ihr IdP PKCE für diesen vertraulichen Client ablehnt. |

105 105

106Die Inference-Upstreams beachten `HTTPS_PROXY` und `HTTP_PROXY` in jeder Version. Die eigenen Anfragen des Gateways an den IdP, Discovery, JWKS, Token und Userinfo gehen direkt, sofern Sie nicht `oidc.use_proxy: true` setzen, was v2.1.227 oder später erfordert. Wenn eine Proxy-Variable gesetzt ist, `use_proxy` nicht gesetzt ist und der Aussteller nicht von `NO_PROXY` abgedeckt ist, hält das Gateway diese Anfragen direkt und protokolliert beim Start einen Hinweis, der Sie auffordert, eine Wahl zu treffen; `use_proxy: false` hält sie direkt und unterdrückt den Hinweis.106Die Inference-Upstreams beachten `HTTPS_PROXY` und `HTTP_PROXY` in jeder Version. Die eigenen Anfragen des Gateways an den IdP, Discovery, JWKS, Token und Userinfo gehen direkt, sofern Sie nicht `oidc.use_proxy: true` setzen, was v2.1.227 oder später erfordert. Wenn eine Proxy-Variable gesetzt ist, `use_proxy` nicht gesetzt ist und der Aussteller nicht von `NO_PROXY` abgedeckt ist, hält das Gateway diese Anfragen direkt und protokolliert beim Start einen Hinweis, der Sie auffordert, eine Wahl zu treffen; `use_proxy: false` hält sie direkt und unterdrückt den Hinweis.

107 107

108Mit `use_proxy: true` löst der Pod den Hostnamen jedes IdP-Endpunkts selbst auf und fordert den Proxy auf, sich mit der aufgelösten IP-Adresse zu `CONNECT`, daher muss der Proxy `CONNECT` zur IP-Adresse jedes Hosts akzeptieren, den das Discovery-Dokument benennt, nicht nur den Aussteller. Verwenden Sie eine `http://`-Proxy-URL. `ca_cert_pem` und der [SSRF-Schutz](/docs/de/claude-apps-gateway-deploy#threat-model-summary) gelten auch auf dem Proxy-Pfad.108Mit `use_proxy: true` löst der Pod den Hostnamen jedes IdP-Endpunkts selbst auf und fordert den Proxy auf, sich per `CONNECT` mit der aufgelösten IP-Adresse zu verbinden, daher muss der Proxy `CONNECT` zur IP-Adresse jedes Hosts akzeptieren, den das Discovery-Dokument benennt, nicht nur den Aussteller. Verwenden Sie eine `http://`-Proxy-URL. `ca_cert_pem` und der [SSRF-Schutz](/docs/de/claude-apps-gateway-deploy#threat-model-summary) gelten auch auf dem Proxy-Pfad.

109 109

110[Proxy-only Egress](#proxy-only-egress) ändert beide: Während es aktiv ist, folgen IdP-Anfragen dem Proxy, sofern Sie nicht `use_proxy: false` setzen, und das Gateway übergibt dem Proxy jeden IdP-Hostnamen, ohne ihn zuerst aufzulösen.110[Proxy-only Egress](#proxy-only-egress) ändert beide: Während es aktiv ist, folgen IdP-Anfragen dem Proxy, sofern Sie nicht `use_proxy: false` setzen, und das Gateway übergibt dem Proxy jeden IdP-Hostnamen, ohne ihn zuerst aufzulösen.

111 111

113 Proxy-only Egress113 Proxy-only Egress

114</h4>114</h4>

115 115

116Setzen Sie `CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1` in der Umgebung des Gateways, neben `HTTPS_PROXY`, wenn der Pod andere Hosts nur durch diesen Forward-Proxy erreicht und öffentliche DNS-Namen nicht selbst auflösen kann, oder wenn der Proxy `CONNECT` zu einer IP-Adresse ablehnt. Erfordert v2.1.277 oder später. Es ist eine Umgebungsvariable statt eines `gateway.yaml`-Schlüssels, daher kann nichts in der Konfigurationsdatei die Adressprüfung des Gateways lockern.116Setzen Sie `CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1` in der Umgebung des Gateways, neben `HTTPS_PROXY`, wenn der Pod andere Hosts nur durch diesen Forward-Proxy erreicht und öffentliche DNS-Namen nicht selbst auflösen kann, oder wenn der Proxy `CONNECT` zu einer IP-Adresse ablehnt. Erfordert v2.1.277 oder später. Es ist eine Umgebungsvariable statt eines `gateway.yaml`-Schlüssels, damit nichts in der Konfigurationsdatei die Adressprüfung des Gateways lockern kann.

117 117

118```bash theme={null}118```bash theme={null}

119export HTTPS_PROXY=http://proxy.corp.example.com:3128119export HTTPS_PROXY=http://proxy.corp.example.com:3128

124 124

125Das Gateway protokolliert eine `network:`-Zeile beim Start, während Proxy-only Egress aktiv ist.125Das Gateway protokolliert eine `network:`-Zeile beim Start, während Proxy-only Egress aktiv ist.

126 126

127Jede Zeile unten ist eine Klasse von ausgehenden Anfragen auf einem Gateway mit `HTTPS_PROXY` gesetzt, standardmäßig und während Proxy-only Egress aktiv ist.127Jede Zeile unten ist eine Klasse von ausgehenden Anfragen auf einem Gateway mit gesetztem `HTTPS_PROXY`, standardmäßig und während Proxy-only Egress aktiv ist.

128 128

130| - | - | - |130| - | - | - |

131| `provider: anthropic`-Upstreams, Workload Identity Federation-Token-Austausch, `telemetry.forward_to`-Exporte | Lokal aufgelöst und überprüft, dann `CONNECT` zur überprüften IP-Adresse durch den Proxy. Ein in `NO_PROXY` aufgelisteter Telemetrie-Collector wird stattdessen direkt erreicht | Hostname an den Proxy übergeben |131| `provider: anthropic`-Upstreams, Workload Identity Federation-Token-Austausch, `telemetry.forward_to`-Exporte | Lokal aufgelöst und überprüft, dann `CONNECT` zur überprüften IP-Adresse durch den Proxy. Ein in `NO_PROXY` aufgelisteter Telemetrie-Collector wird stattdessen direkt erreicht | Hostname an den Proxy übergeben |

132| IdP-Discovery, JWKS, Token und Userinfo | Direkt, sofern nicht [`oidc.use_proxy: true`](#idp-requests-through-a-forward-proxy), dann `CONNECT` zur überprüften IP-Adresse | Hostname an den Proxy übergeben, sofern nicht `oidc.use_proxy: false` hält einen internen IdP direkt |132| IdP-Discovery, JWKS, Token und Userinfo | Direkt, sofern nicht [`oidc.use_proxy: true`](#idp-requests-through-a-forward-proxy), dann `CONNECT` zur überprüften IP-Adresse | Hostname an den Proxy übergeben, sofern nicht `oidc.use_proxy: false` einen internen IdP direkt hält |

134 134

135Proxy-only Egress bleibt aus, sofern die Umgebung des Gateways nicht alle drei dieser Bedingungen erfüllt:135Proxy-only Egress bleibt aus, sofern die Umgebung des Gateways nicht alle drei dieser Bedingungen erfüllt:

136 136

137* `HTTPS_PROXY` oder `HTTP_PROXY` ist gesetzt.137* `HTTPS_PROXY` oder `HTTP_PROXY` ist gesetzt.

138* `NO_PROXY` und `no_proxy` sind leer. Wenn Ihre Plattform eines in Pods injiziert, setzen Sie beide auf einen leeren Wert auf dem Gateway-Container. Das Auflisten eines Telemetrie-Collectors in `NO_PROXY` hält Proxy-only Egress aus.138* `NO_PROXY` und `no_proxy` sind leer. Wenn Ihre Plattform eines davon in Pods injiziert, setzen Sie beide auf einen leeren Wert auf dem Gateway-Container. Das Auflisten eines Telemetrie-Collectors in `NO_PROXY` hält Proxy-only Egress aus.

139* `CLAUDE_GATEWAY_ALLOW_LOOPBACK` ist nicht aktiviert. Ein Collector oder IdP auf dem eigenen Loopback des Pods kann nicht mit Proxy-only Egress kombiniert werden, da eine an den Proxy übergebene Loopback-Adresse die des Proxy-Hosts selbst wäre, daher geben Sie diesen Services stattdessen eine Adresse, die der Proxy erreichen kann. Aus dem gleichen Grund weigert sich das Gateway, `localhost`-ähnliche Namen direkt zu akzeptieren, während Proxy-only Egress aktiv ist.139* `CLAUDE_GATEWAY_ALLOW_LOOPBACK` ist nicht aktiviert. Ein Collector oder IdP auf dem eigenen Loopback des Pods kann nicht mit Proxy-only Egress kombiniert werden, da eine an den Proxy übergebene Loopback-Adresse die des Proxy-Hosts selbst wäre, daher geben Sie diesen Services stattdessen eine Adresse, die der Proxy erreichen kann. Aus dem gleichen Grund lehnt das Gateway `localhost`-ähnliche Namen grundsätzlich ab, während Proxy-only Egress aktiv ist.

140 140

141Wenn eine dieser Bedingungen nicht erfüllt ist, protokolliert das Gateway beim Start eine Warnung, die die Variable benennt, die es gestoppt hat, und behält das Standardverhalten.141Wenn eine dieser Bedingungen nicht erfüllt ist, protokolliert das Gateway beim Start eine Warnung, die die Variable benennt, die es verhindert hat, und behält das Standardverhalten.

142 142

143Sobald Proxy-only Egress aktiv ist, erlauben Sie jeden Ziel im Proxy, einschließlich eines internen Collectors und jeden Host, der durch IP-Adresse konfiguriert ist. Sie können immer noch einen internen IdP direkt mit [`oidc.use_proxy: false`](#idp-requests-through-a-forward-proxy) halten.143Sobald Proxy-only Egress aktiv ist, erlauben Sie jedes Ziel im Proxy, einschließlich eines internen Collectors und jedes Hosts, der durch IP-Adresse konfiguriert ist. Sie können einen internen IdP weiterhin mit [`oidc.use_proxy: false`](#idp-requests-through-a-forward-proxy) direkt halten.

144 144

145<Warning>145<Warning>

146 Aktivieren Sie dies nur, wenn die Allowlist des Proxys mindestens so streng ist wie die eigene Prüfung des Gateways. Der Proxy muss Cloud-Metadaten-Endpunkte wie `169.254.169.254` und `metadata.google.internal`, Link-Local-Adressen und das eigene Loopback des Proxy-Hosts ablehnen, und er muss sie nach der Adresse ablehnen, zu der ein Name aufgelöst wird, nicht nur nach Name, da das Gateway einen Hostnamen, der zu einem von ihnen aufgelöst wird, nicht mehr abfängt. Ein Proxy, der überall verbunden ist, wo er gefragt wird, entfernt den [SSRF-Schutz](/docs/de/claude-apps-gateway-deploy#threat-model-summary) des Gateways für diese Anfragen.146 Aktivieren Sie dies nur, wenn die Allowlist des Proxys mindestens so streng ist wie die eigene Prüfung des Gateways. Der Proxy muss Cloud-Metadaten-Endpunkte wie `169.254.169.254` und `metadata.google.internal`, Link-Local-Adressen und das eigene Loopback des Proxy-Hosts ablehnen, und er muss sie nach der Adresse ablehnen, zu der ein Name aufgelöst wird, nicht nur nach Name, da das Gateway einen Hostnamen, der zu einem von ihnen aufgelöst wird, nicht mehr abfängt. Ein Proxy, der sich überall hin verbindet, wohin er gebeten wird, entfernt den [SSRF-Schutz](/docs/de/claude-apps-gateway-deploy#threat-model-summary) des Gateways für diese Anfragen.

147</Warning>147</Warning>

148 148

149<h3 id="session">149<h3 id="session">

150 `session`150 `session`

151</h3>151</h3>

152 152

153Der `session`-Block formt die Bearer-Tokens, die das Gateway nach der Anmeldung ausgibt: das Geheimnis, das sie signiert, und wie lange sie leben.153Der `session`-Block formt die Bearer-Tokens, die das Gateway nach der Anmeldung ausgibt: das Geheimnis, das sie signiert, und wie lange sie gültig sind.

154 154

156| - | - | - |156| - | - | - |

157| `jwt_secret` | Ja | Mindestens 32 Bytes Entropie, zum Beispiel von `openssl rand -base64 32`. Signiert die HS256-Bearer-Tokens des Gateways. Akzeptiert eine einzelne Zeichenkette oder ein Array zur Rotation: Index 0 signiert und alle Einträge verifizieren. Zum Rotieren fügen Sie ein neues Geheimnis vorne hinzu, warten `ttl_hours`, dann löschen Sie das alte. |157| `jwt_secret` | Ja | Mindestens 32 Bytes Entropie, zum Beispiel von `openssl rand -base64 32`. Signiert die HS256-Bearer-Tokens des Gateways. Akzeptiert eine einzelne Zeichenkette oder ein Array zur Rotation: Index 0 signiert und alle Einträge verifizieren. Zum Rotieren fügen Sie ein neues Geheimnis vorne hinzu, warten `ttl_hours`, dann löschen Sie das alte. |

158| `ttl_hours` | Nein | Lebensdauer des Gateway-Bearer-Tokens. Standard `1`. Die CLI aktualisiert automatisch vor Ablauf, wenn der IdP Aktualisierungstoken ausgibt. Eine kürzere Lebensdauer hebt die Bereitstellung schneller auf; eine längere macht weniger IdP-Roundtrips. Wenn Ihr IdP keine Aktualisierungstoken ausstellen kann, weil `offline_access` nicht verfügbar ist, gibt es keine automatische Aktualisierung, daher erhöhen Sie dies auf `8` oder `12`, um zu vermeiden, dass Entwickler stündlich zur Browser-Anmeldung zurückkehren. |158| `ttl_hours` | Nein | Lebensdauer des Gateway-Bearer-Tokens. Standard `1`. Die CLI aktualisiert automatisch vor Ablauf, wenn der IdP Aktualisierungstoken ausgibt. Eine kürzere Lebensdauer entzieht den Zugang schneller; eine längere macht weniger IdP-Roundtrips. Wenn Ihr IdP keine Aktualisierungstoken ausstellen kann, weil `offline_access` nicht verfügbar ist, gibt es keine automatische Aktualisierung, daher erhöhen Sie dies auf `8` oder `12`, um zu vermeiden, dass Entwickler stündlich zur Browser-Anmeldung zurückkehren. |

159 159

160<h3 id="store">160<h3 id="store">

161 `store`161 `store`

162</h3>162</h3>

163 163

164Der `store`-Block verweist das Gateway auf seine PostgreSQL-Datenbank, die Gerätezuschüsse und Ratenbegrenzungszähler enthält.164Der `store`-Block verweist das Gateway auf seine PostgreSQL-Datenbank, die Device-Grants und Rate-Limit-Zähler enthält.

165 165

167| - | - | - |167| - | - | - |

168| `postgres_url` | Ja | `postgres://` oder `postgresql://` URL. Erforderlich: das Gerätezuschuss-Rendezvous, wo der Browser-Callback schreibt und die Polling-CLI liest, benötigt Zustand über Replikas hinweg. Das Gateway führt seine eigenen Schema-Migrationen beim Start und bei Upgrades aus, daher benötigt die Rolle Rechte zum Erstellen und Ändern von Tabellen im Zielschema. Siehe [Upgrades](/docs/de/claude-apps-gateway-deploy#upgrades) und [Postgres](/docs/de/claude-apps-gateway-deploy#postgres). |168| `postgres_url` | Ja | `postgres://` oder `postgresql://` URL. Erforderlich: das Device-Grant-Rendezvous, wo der Browser-Callback schreibt und die Polling-CLI liest, benötigt Zustand über Replikate hinweg. Das Gateway führt seine eigenen Schema-Migrationen beim Start und bei Upgrades aus, daher benötigt die Rolle Rechte zum Erstellen und Ändern von Tabellen im Zielschema. Siehe [Upgrades](/docs/de/claude-apps-gateway-deploy#upgrades) und [Postgres](/docs/de/claude-apps-gateway-deploy#postgres). |

170| `password` | Nein | Datenbankberechtigungsnachweis. Setzen Sie ihn hier anstelle von `postgres_url`, damit der Berechtigungsnachweis aus der URL bleibt. Akzeptiert beliebige Zeichen und hat Vorrang vor URL-Berechtigungsnachweisen. |170| `password` | Nein | Datenbank-Anmeldedaten. Setzen Sie sie hier anstelle von `postgres_url`, damit die Anmeldedaten nicht in der URL stehen. Akzeptiert beliebige Zeichen und hat Vorrang vor Anmeldedaten in der URL. |

171| `max_connections` | Nein | Postgres-Verbindungspool-Größe pro Replik. Standard `5`, was konservativ und freundlich zu gemeinsamen Datenbanken ist. Mit [Ausgabenlimits](#admin) aktiviert, führt der Hot-Path einige Operationen pro Inference-Anfrage durch, daher erhöhen Sie ihn für eine dedizierte Datenbank unter Last, und halten Sie Replikas × dies unter dem `max_connections` der Datenbank. |171| `max_connections` | Nein | Postgres-Verbindungspool-Größe pro Replikat. Standard `5`, was konservativ und schonend für gemeinsam genutzte Datenbanken ist. Mit aktivierten [Ausgabenlimits](#admin) führt der Hot-Path einige Operationen pro Inference-Anfrage durch, daher erhöhen Sie den Wert für eine dedizierte Datenbank unter Last, und halten Sie Replikate × diesen Wert unter dem `max_connections` der Datenbank. |

172| `connect_timeout_seconds` | Nein | Sekunden, die das Gateway wartet, wenn es eine Postgres-Verbindung öffnet. Eine ganze Zahl von `1` bis `60`, Standard `5`. Erhöhen Sie, wenn Verbindungsversuche zeitlich überschritten werden, wenn eine neue Gateway-Instanz startet. Erfordert Claude Code v2.1.274 oder später auf dem Gateway-Server. Frühere Versionen weigern sich zu starten, wenn der Schlüssel gesetzt ist. |172| `connect_timeout_seconds` | Nein | Sekunden, die das Gateway wartet, wenn es eine Postgres-Verbindung öffnet. Eine ganze Zahl von `1` bis `60`, Standard `5`. Erhöhen Sie den Wert, wenn Verbindungsversuche beim Start einer neuen Gateway-Instanz in eine Zeitüberschreitung laufen. Erfordert Claude Code v2.1.274 oder später auf dem Gateway-Server. Frühere Versionen weigern sich zu starten, wenn der Schlüssel gesetzt ist. |

173| `readiness_grace_seconds` | Nein | Wie viele Sekunden `/readyz` weiterhin Bereitschaft meldet, nachdem Postgres nicht mehr antwortet. Eine ganze Zahl von `0` bis `3600`, Standard `0`. Siehe [Verhalten bei Ausfällen](/docs/de/claude-apps-gateway-deploy#outage-behavior) zur Wahl eines Werts. Erfordert Claude Code v2.1.282 oder später auf dem Gateway-Server. Frühere Versionen weigern sich zu starten, wenn der Schlüssel gesetzt ist. |

173 174

174Für die lokale Entwicklung verweisen Sie `postgres_url` auf einen Wegwerf-Postgres-Container, zum Beispiel `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`.175Für die lokale Entwicklung verweisen Sie `postgres_url` auf einen Wegwerf-Postgres-Container, zum Beispiel `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`.

175 176

179 180

180`upstreams` ist eine geordnete Liste. Das Gateway leitet Inference an den ersten Upstream weiter, der das angeforderte Modell auflöst.181`upstreams` ist eine geordnete Liste. Das Gateway leitet Inference an den ersten Upstream weiter, der das angeforderte Modell auflöst.

181 182

182Bei `5xx`, `429`, `401`, `403`, `404` oder Timeout schlägt das Gateway zum nächsten Upstream fehl über; andere `4xx` nicht, da diese Fehler dem Request statt dem Upstream zuzuordnen sind. Ein `401` oder `403` bedeutet, dass die eigene Berechtigung des Gateways gegen diesen Upstream fehlgeschlagen ist. Ein `404` bedeutet, dass dieser Upstream das angeforderte Modell nicht bereitstellt, daher kann ein späterer Upstream in der Liste es immer noch tun.183Bei `5xx`, `429`, `401`, `403`, `404` oder Timeout führt das Gateway ein Failover zum nächsten Upstream durch; bei anderen `4xx` nicht, da diese Fehler der Anfrage statt dem Upstream zuzuordnen sind. Ein `401` oder `403` bedeutet, dass die Anmeldedaten, die das Gateway gegenüber diesem Upstream verwendet hat, fehlgeschlagen sind. Ein `404` bedeutet, dass dieser Upstream das angeforderte Modell nicht bereitstellt, daher kann ein späterer Upstream in der Liste es immer noch tun.

183 184

184Wenn Sie `forward_user_identity: true` auf einem Upstream setzen, schlägt ein `429`, das dieser auf eine Anfrage zurückgibt, die die E-Mail des Entwicklers trug, nicht fehl über. Siehe [wie eine Pro-Benutzer-Limit-Ablehnung den Entwickler erreicht](#per-user-identity-headers-for-a-proxy-you-run).185Wenn Sie `forward_user_identity: true` auf einem Upstream setzen, führt ein `429`, das dieser auf eine Anfrage zurückgibt, die die E-Mail des Entwicklers trug, nicht zu einem Failover. Siehe [wie eine Limit-Ablehnung pro Benutzer den Entwickler erreicht](#per-user-identity-headers-for-a-proxy-you-run).

185 186

186Failover bei `404` erfordert Gateway v2.1.198 oder später. Frühere Versionen gaben den ersten `404` an den Client zurück, auch wenn ein späterer Upstream in der Liste das Modell bereitstellte.187Failover bei `404` erfordert Gateway v2.1.198 oder später. Frühere Versionen gaben den ersten `404` an den Client zurück, auch wenn ein späterer Upstream in der Liste das Modell bereitstellte.

187 188

188Mehrere Upstreams desselben Anbieters müssen einen unterschiedlichen `name:` setzen.189Mehrere Upstreams desselben Anbieters müssen einen unterschiedlichen `name:` setzen.

189 190

190Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry-Clients werden beim Start einmal erstellt, und ihre SDKs aktualisieren Berechtigungsnachweise intern, daher erfordert das Rotieren von Cloud-Berechtigungsnachweisen keinen Neustart. Statische Anthropic-API-Schlüssel und Bearer werden beim Start gelesen; siehe [Anthropic API](#anthropic-api).191Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry-Clients werden beim Start einmal erstellt, und ihre SDKs aktualisieren Anmeldedaten intern, daher erfordert das Rotieren von Cloud-Anmeldedaten keinen Neustart. Statische Anthropic-API-Schlüssel und Bearer werden beim Start gelesen; siehe [Anthropic API](#anthropic-api).

191 192

192<h4 id="upstream-error-messages">193<h4 id="upstream-error-messages">

193 Upstream-Fehlermeldungen194 Upstream-Fehlermeldungen

195 196

196Das Gateway gibt die Fehlerantwort eines Upstreams oder sein eigenes `502` zurück, je nachdem, wie die Upstreams antworteten:197Das Gateway gibt die Fehlerantwort eines Upstreams oder sein eigenes `502` zurück, je nachdem, wie die Upstreams antworteten:

197 198

198* **Ein Upstream gab einen Status zurück, bei dem das Gateway nicht [fehlschlägt über](#multiple-upstreams)**: diese Upstream-Antwort. Das Gateway versucht keine weiteren Upstreams.199* **Ein Upstream gab einen Status zurück, bei dem das Gateway kein [Failover](#multiple-upstreams) durchführt**: die Antwort dieses Upstreams. Das Gateway versucht keine weiteren Upstreams.

199* **Jeder Upstream, den das Gateway versuchte, schlug auf eine Weise fehl, bei der es [fehlschlägt über](#multiple-upstreams)**: das letzte `429`. Wenn keiner ein `429` zurückgab, bevorzugt das Gateway in der Reihenfolge das letzte `401` oder `403`, das letzte `404` und das letzte `501`. Wenn keiner von diesen zurückgab, das eigene `502` des Gateways, `all upstreams failed (N attempted)`, wobei N jeden Eintrag in [`upstreams`](#upstreams) zählt, einschließlich Einträge, die das Gateway übersprungen hat, weil sie das angeforderte Modell nicht bereitstellen.200* **Jeder Upstream, den das Gateway versuchte, schlug auf eine Weise fehl, bei der es ein [Failover](#multiple-upstreams) durchführt**: das letzte `429`. Wenn keiner ein `429` zurückgab, bevorzugt das Gateway in der Reihenfolge das letzte `401` oder `403`, das letzte `404` und das letzte `501`. Wenn keiner davon zurückgegeben wurde, das eigene `502` des Gateways, `all upstreams failed (N attempted)`, wobei N jeden Eintrag in [`upstreams`](#upstreams) zählt, einschließlich Einträgen, die das Gateway übersprungen hat, weil sie das angeforderte Modell nicht bereitstellen.

200 201

201Wenn das Gateway eine Upstream-Antwort zurückgibt, behält es den Statuscode des Upstreams. Ob es die Nachricht des Upstreams behält, hängt vom Anbieter ab. Eine Fehlerantwort eines Anthropic-API-Upstreams erreicht den Entwickler unverändert.202Wenn das Gateway eine Upstream-Antwort zurückgibt, behält es den Statuscode des Upstreams. Ob es die Nachricht des Upstreams behält, hängt vom Anbieter ab. Der Fehler-Body eines Anthropic-API-Upstreams erreicht den Entwickler unverändert.

202 203

203Die Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry-Upstreams können Ihre Konto-IDs, Rollen-ARNs und Projekt-IDs in ihrem Fehlertext benennen. Das Gateway zeichnet diesen vollständigen Text im [Betriebsprotokoll](/docs/de/claude-apps-gateway-deploy#logs) auf. Was der Entwickler von diesen Upstreams sieht, hängt von der Ablehnung ab:204Die Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry-Upstreams können Ihre Konto-IDs, Rollen-ARNs und Projekt-IDs in ihrem Fehlertext benennen. Das Gateway zeichnet diesen vollständigen Text im [Betriebs-Log](/docs/de/claude-apps-gateway-deploy#logs) auf. Was der Entwickler von diesen Upstreams sieht, hängt von der Ablehnung ab:

204 205

205* `400` oder `413` in Anthropics Standard-Fehler-Envelope: die eigene Nachricht des Upstreams, wie `prompt is too long`. Claude Platform on AWS, Agent Platform und Microsoft Foundry geben dieses Envelope für Modell-API-Ablehnungen zurück.206* `400` oder `413` in Anthropics Standard-Fehler-Envelope: die eigene Nachricht des Upstreams, wie `prompt is too long`. Claude Platform on AWS, Agent Platform und Microsoft Foundry geben dieses Envelope für Modell-API-Ablehnungen zurück.

206* `400` oder `413` in der eigenen Form des Anbieters: ein `capability_rejected:`-Token. Wenn das Gateway die Ablehnung nicht klassifizieren kann, `upstream rejected the request` bei einem `400` oder `request too large for this upstream` bei einem `413`.207* `400` oder `413` in der eigenen Form des Anbieters: ein `capability_rejected:`-Token. Wenn das Gateway die Ablehnung nicht klassifizieren kann, `upstream rejected the request` bei einem `400` oder `request too large for this upstream` bei einem `413`.

207* Jeder andere Status: generischer Pro-Status-Text, wie `upstream rate limit exceeded` bei einem `429`.208* Jeder andere Status: generischer Text pro Status, wie `upstream rate limit exceeded` bei einem `429`.

208 209

209Zum Beispiel ersetzt das Gateway Amazon Bedrocks `Input is too long for requested model.` durch `capability_rejected: prompt_too_long`. Claude Code [komprimiert automatisch](/docs/de/errors#prompt-is-too-long) auf dieses Token, wie es auf `prompt is too long` tut.210Zum Beispiel ersetzt das Gateway Amazon Bedrocks `Input is too long for requested model.` durch `capability_rejected: prompt_too_long`. Claude Code [komprimiert automatisch](/docs/de/errors#prompt-is-too-long) bei diesem Token, wie es bei `prompt is too long` tut.

210 211

211Das Beibehalten einer Cloud-Upstream-Nachricht von `400` oder `413` oder das Ersetzen durch ein `capability_rejected:`-Token erfordert Gateway v2.1.233 oder später.212Das Beibehalten einer Cloud-Upstream-Nachricht von `400` oder `413` oder das Ersetzen durch ein `capability_rejected:`-Token erfordert Gateway v2.1.233 oder später.

212 213

226 # base_url: https://api.anthropic.com # default; override for a forward proxy227 # base_url: https://api.anthropic.com # default; override for a forward proxy

227```228```

228 229

229Die zwei Berechtigungsnachweis-Formen unterscheiden sich im Header, den sie senden:230Die zwei Formen von Anmeldedaten unterscheiden sich im Header, den sie senden:

230 231

231* **`api_key`**: sendet `x-api-key`. Rotieren Sie ihn in der Claude Console und aktualisieren Sie die Umgebungsvariable.232* **`api_key`**: sendet `x-api-key`. Rotieren Sie ihn in der Claude Console und aktualisieren Sie die Umgebungsvariable.

232* **`oauth_token`**: sendet `Authorization: Bearer`. Verwenden Sie die Bearer-Form, wenn Ihre Organisation kurzlebige Tokens statt langlebiger API-Schlüssel ausgibt. Der Bearer wird einmal beim Start gelesen, daher aktualisieren Sie durch Remounten des Geheimnisses und Neustart.233* **`oauth_token`**: sendet `Authorization: Bearer`. Verwenden Sie die Bearer-Form, wenn Ihre Organisation kurzlebige Tokens statt langlebiger API-Schlüssel ausgibt. Der Bearer wird einmal beim Start gelesen, daher aktualisieren Sie durch erneutes Mounten des Geheimnisses und Neustart.

233 234

234Anstelle eines statischen Schlüssels oder Bearers können Sie Workload Identity Federation verwenden. Erstellen Sie eine Verbindungsregel, indem Sie dem [Workload Identity Federation-Leitfaden](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) folgen, dann mounten Sie das OIDC-JWT Ihrer Workload als Datei, wie ein Kubernetes-projiziertes Service-Account-Token oder ein ID-Token einer CI-Plattform. Das Gateway tauscht das JWT gegen einen kurzlebigen Bearer aus und aktualisiert ihn automatisch. Die Token-Datei wird bei jedem Austausch erneut gelesen, daher werden rotierte projizierte Tokens ohne Neustart aufgegriffen.235Anstelle eines statischen Schlüssels oder Bearers können Sie Workload Identity Federation verwenden. Erstellen Sie eine Federation-Regel, indem Sie dem [Workload Identity Federation-Leitfaden](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) folgen, dann mounten Sie das OIDC-JWT Ihrer Workload als Datei, wie ein Kubernetes-projiziertes Service-Account-Token oder ein ID-Token einer CI-Plattform. Das Gateway tauscht das JWT gegen einen kurzlebigen Bearer aus und aktualisiert ihn automatisch. Die Token-Datei wird bei jedem Austausch erneut gelesen, daher werden rotierte projizierte Tokens ohne Neustart übernommen.

235 236

236```yaml theme={null}237```yaml theme={null}

237upstreams:238upstreams:

247<a id="per-user-identity-headers-for-a-proxy-you-run" />248<a id="per-user-identity-headers-for-a-proxy-you-run" />

248 249

249<h5 id="per-user-identity-headers-for-a-proxy-you-run">250<h5 id="per-user-identity-headers-for-a-proxy-you-run">

250 Pro-Benutzer-Identitäts-Header für einen Proxy, den Sie betreiben251 Identitäts-Header pro Benutzer für einen Proxy, den Sie betreiben

251</h5>252</h5>

252 253

253Sie können die `base_url` eines `provider: anthropic`-Upstreams auf einen Proxy verweisen, den Sie betreiben, anstatt auf die Anthropic API. Um diesem Proxy mitzuteilen, welcher Entwickler jede Anfrage gesendet hat, setzen Sie `forward_user_identity: true` auf diesem Upstream. Der Proxy kann dann Ausgaben pro Entwickler zuordnen. Erfordert ein Gateway, das Claude Code v2.1.233 oder später ausführt.254Sie können die `base_url` eines `provider: anthropic`-Upstreams auf einen Proxy verweisen, den Sie betreiben, anstatt auf die Anthropic API. Um diesem Proxy mitzuteilen, welcher Entwickler jede Anfrage gesendet hat, setzen Sie `forward_user_identity: true` auf diesem Upstream. Der Proxy kann dann Ausgaben pro Entwickler zuordnen. Erfordert ein Gateway, das Claude Code v2.1.233 oder später ausführt.

273 274

274Wenn das IdP-Token keine E-Mail trägt, sendet das Gateway nur `x-claude-gateway-user-id` und lässt die zwei E-Mail-Header weg. Wenn Ihr IdP die E-Mail in einem anderen Anspruch ablegt, setzen Sie [`oidc.email_claim`](#oidc) auf diesen Anspruch.275Wenn das IdP-Token keine E-Mail trägt, sendet das Gateway nur `x-claude-gateway-user-id` und lässt die zwei E-Mail-Header weg. Wenn Ihr IdP die E-Mail in einem anderen Anspruch ablegt, setzen Sie [`oidc.email_claim`](#oidc) auf diesen Anspruch.

275 276

276Wenn Ihr Proxy `429` auf eine Anfrage antwortet, die die E-Mail des Entwicklers trug, gibt das Gateway diese Antwort unverändert an den Entwickler zurück, anstatt zum nächsten Upstream fehlzuschlagen, daher hält das Budget oder die Ratenbegrenzung pro Benutzer Ihres Proxys. Die anderen Antworten des Proxys folgen den gewöhnlichen [Failover-Regeln](#upstreams). Wenn das IdP-Token eines Entwicklers keine E-Mail trägt, leitet das Gateway seine Anfragen ohne die E-Mail-Header weiter, daher zählt ein `429` auf eine dieser Anfragen als Upstream-Kapazität und schlägt fehl über. Vor v2.1.267 auf dem Gateway-Server schlug jedes `429` fehl über.277Wenn Ihr Proxy `429` auf eine Anfrage antwortet, die die E-Mail des Entwicklers trug, gibt das Gateway diese Antwort unverändert an den Entwickler zurück, anstatt ein Failover zum nächsten Upstream durchzuführen, sodass das Budget oder Rate-Limit pro Benutzer Ihres Proxys greift. Die anderen Antworten des Proxys folgen den gewöhnlichen [Failover-Regeln](#upstreams). Wenn das IdP-Token eines Entwicklers keine E-Mail trägt, leitet das Gateway seine Anfragen ohne die E-Mail-Header weiter, daher zählt ein `429` auf eine dieser Anfragen als Upstream-Kapazität und führt zu einem Failover. Vor v2.1.267 auf dem Gateway-Server führte jedes `429` zu einem Failover.

277 278

278Setzen Sie `forward_user_identity` nur auf einem Upstream, dessen `base_url` ein Proxy ist, den Sie betreiben. Das Gateway sendet Entwickler-E-Mails an jeden Server, den diese `base_url` benennt. Wenn die `base_url` die Anthropic API ist, die Standard ist, weigert sich das Gateway zu starten.279Setzen Sie `forward_user_identity` nur auf einem Upstream, dessen `base_url` ein Proxy ist, den Sie betreiben. Das Gateway sendet Entwickler-E-Mails an jeden Server, den diese `base_url` benennt. Wenn die `base_url` die Anthropic API ist, was der Standard ist, weigert sich das Gateway zu starten.

279 280

280<h4 id="amazon-bedrock">281<h4 id="amazon-bedrock">

281 Amazon Bedrock282 Amazon Bedrock

282</h4>283</h4>

283 284

284Für die Client-seitige Amazon Bedrock-Bereitstellung, die das Gateway ersetzt oder frontet, siehe [Claude Code on Amazon Bedrock](/docs/de/amazon-bedrock). Der Gateway-seitige Upstream:285Für die clientseitige Amazon Bedrock-Bereitstellung, die das Gateway ersetzt oder der es vorgeschaltet ist, siehe [Claude Code on Amazon Bedrock](/docs/de/amazon-bedrock). Der gatewayseitige Upstream:

285 286

286```yaml theme={null}287```yaml theme={null}

287upstreams:288upstreams:

300 # base_url: https://bedrock-runtime-fips.us-east-1.amazonaws.com301 # base_url: https://bedrock-runtime-fips.us-east-1.amazonaws.com

301```302```

302 303

303Ein leerer `auth`-Block verwendet die Standard-Berechtigungskette des AWS SDK: Umgebungsvariablen, `~/.aws/credentials`, ECS-Task-Rolle, EC2-Instanz-Metadaten oder IRSA auf EKS. Geben Sie in der Produktion dem Gateway-Pod eine IAM-Rolle, anstatt statische Schlüssel in ein Container-Image einzubetten.304Ein leerer `auth`-Block verwendet die Standard-Anmeldedatenkette des AWS SDK: Umgebungsvariablen, `~/.aws/credentials`, ECS-Task-Rolle, EC2-Instanz-Metadaten oder IRSA auf EKS. Geben Sie in der Produktion dem Gateway-Pod eine IAM-Rolle, anstatt statische Schlüssel in ein Container-Image einzubetten.

304 305

305Explizite Berechtigungsnachweise müssen vollständig sein: Das Gateway schlägt beim Start fehl, wenn `aws_access_key_id` und `aws_secret_access_key` nicht zusammen gesetzt sind, oder wenn `aws_session_token` ohne sie gesetzt ist. Vor v2.1.207 bestand ein partieller `auth:`-Block die Validierung.306Explizite Anmeldedaten müssen vollständig sein: Das Gateway schlägt beim Start fehl, wenn `aws_access_key_id` und `aws_secret_access_key` nicht zusammen gesetzt sind, oder wenn `aws_session_token` ohne sie gesetzt ist. Vor v2.1.207 bestand ein unvollständiger `auth:`-Block die Validierung.

306 307

307| Setup | Wie |308| Setup | Wie |

308| - | - |309| - | - |

309| IAM-Berechtigungen | Gewähren Sie dem Principal des Gateways `bedrock:InvokeModel` und `bedrock:InvokeModelWithResponseStream` auf sowohl den Inference-Profil-ARNs als auch den zugrunde liegenden Foundation-Modell-ARNs. Für den integrierten Katalog in US-Regionen: `arn:aws:bedrock:<region>:<account>:inference-profile/us.anthropic.*` und `arn:aws:bedrock:*::foundation-model/anthropic.*`. Gewähren Sie auch `bedrock:CountTokens` auf den Foundation-Modell-ARNs. Das Gateway verwendet es, kostenlos, um die Eingabe-Tokens einer Anfrage zu zählen, die der Client abgebrochen hat, daher bleiben [Ausgabenlimits](#admin) genau. Ohne es fällt das Gateway auf eine Ein-Token-Bedrock-Anfrage für diese Zählung zurück. |310| IAM-Berechtigungen | Gewähren Sie dem Principal des Gateways `bedrock:InvokeModel` und `bedrock:InvokeModelWithResponseStream` sowohl auf den Inference-Profil-ARNs als auch auf den zugrunde liegenden Foundation-Modell-ARNs. Für den integrierten Katalog in US-Regionen: `arn:aws:bedrock:<region>:<account>:inference-profile/us.anthropic.*` und `arn:aws:bedrock:*::foundation-model/anthropic.*`. Gewähren Sie auch `bedrock:CountTokens` auf den Foundation-Modell-ARNs. Das Gateway verwendet es kostenlos, um die Eingabe-Token einer Anfrage zu zählen, die der Client abgebrochen hat, damit [Ausgabenlimits](#admin) genau bleiben. Ohne es fällt das Gateway für diese Zählung auf eine Ein-Token-Bedrock-Anfrage zurück. |

310| Modellzugriff | Amazon Bedrock aktiviert Modellzugriff standardmäßig in kommerziellen Regionen. Das verbleibende Konto-Level-Gate ist Anthropics einmaliges Anwendungsformular: Wenn niemand in Ihrem AWS-Konto es eingereicht hat, öffnen Sie die Amazon Bedrock-Konsole, wählen Sie ein Anthropic-Modell aus dem Modellkatalog und füllen Sie das Formular aus. Siehe [Anwendungsdetails einreichen](/docs/de/amazon-bedrock#1-submit-use-case-details) für das AWS Organizations-Formular und die Berechtigungen, die der Einreicher benötigt. |311| Modellzugriff | Amazon Bedrock aktiviert Modellzugriff standardmäßig in kommerziellen Regionen. Die verbleibende Hürde auf Kontoebene ist Anthropics einmaliges Anwendungsfall-Formular: Wenn niemand in Ihrem AWS-Konto es eingereicht hat, öffnen Sie die Amazon Bedrock-Konsole, wählen Sie ein Anthropic-Modell aus dem Modellkatalog und füllen Sie das Formular aus. Siehe [Anwendungsfall-Details einreichen](/docs/de/amazon-bedrock#1-submit-use-case-details) für das AWS Organizations-Formular und die Berechtigungen, die der Einreicher benötigt. |

311| EKS (IRSA) | Erstellen Sie eine IAM-Rolle mit der obigen Richtlinie und einer Vertrauensrichtlinie für den OIDC-Provider Ihres Clusters, der auf das Service-Account des Gateways beschränkt ist. Kommentieren Sie das Service-Account mit `eks.amazonaws.com/role-arn: arn:aws:iam::<acct>:role/claude-gateway`. `auth: {}` nimmt es auf. |312| EKS (IRSA) | Erstellen Sie eine IAM-Rolle mit der obigen Richtlinie und einer Vertrauensrichtlinie für den OIDC-Provider Ihres Clusters, die auf den Service-Account des Gateways beschränkt ist. Annotieren Sie den Service-Account mit `eks.amazonaws.com/role-arn: arn:aws:iam::<acct>:role/claude-gateway`. `auth: {}` übernimmt sie. |

312| ECS / EC2 | Fügen Sie die IAM-Rolle an die Task-Definition oder das Instance-Profil an. `auth: {}` nimmt es auf. |313| ECS / EC2 | Hängen Sie die IAM-Rolle an die Task-Definition oder das Instance-Profil an. `auth: {}` übernimmt sie. |

313| Überall sonst | Übergeben Sie Berechtigungsnachweise über die Umgebungsvariablen `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` und `AWS_SESSION_TOKEN`, oder setzen Sie sie explizit in `auth:` mit `${VAR}`-Erweiterung |314| Überall sonst | Übergeben Sie Anmeldedaten über die Umgebungsvariablen `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` und `AWS_SESSION_TOKEN`, oder setzen Sie sie explizit in `auth:` mit `${VAR}`-Erweiterung |

314| Region | `region:` ist die API-Endpunkt-Region. Cross-Region-Inference-Profile leiten über die Geo (US, EU, APAC) weiter, unabhängig davon, welche Sie wählen. Für Nicht-US-Regionen oder bereitgestellte Durchsatz-ARNs fügen Sie einen [`models:`](#models)-Block mit den richtigen Pro-Upstream-IDs hinzu. |315| Region | `region:` ist die API-Endpunkt-Region. Cross-Region-Inference-Profile leiten innerhalb der Geo (US, EU, APAC) weiter, unabhängig davon, welche Sie wählen. Für Nicht-US-Regionen oder Provisioned-Throughput-ARNs fügen Sie einen [`models:`](#models)-Block mit den richtigen IDs pro Upstream hinzu. |

316

317<h5 id="apply-an-amazon-bedrock-guardrail">

318 Eine Amazon Bedrock-Guardrail anwenden

319</h5>

320

321Um eine Amazon Bedrock-Guardrail auf jede Inference-Anfrage anzuwenden, die das Gateway über einen Bedrock-Upstream sendet, fügen Sie diesem Upstream einen `guardrail`-Block hinzu. Erfordert Claude Code v2.1.281 oder später auf dem Gateway-Server.

322

323```yaml theme={null}

324upstreams:

325 - provider: bedrock

326 region: us-east-1

327 auth: {}

328 guardrail:

329 id: gr-abc123 # guardrail ID or full ARN

330 version: "1" # a published version number, or DRAFT

331 # keep the quotes: a bare 1 fails at boot

332```

333

334<Warning>

335 Das Gateway unterstützt keine Guardrail-Eingabe-Tags. Es fügt Prompts keine Guard-Content-Tags hinzu, daher wird ein Guardrail-Filter, den Amazon Bedrock nur auf getaggte Eingaben anwendet, bei Traffic über das Gateway nicht ausgeführt. Welche Filter von Eingabe-Tags abhängen, erfahren Sie unter [Eingabe-Tags](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-tagging.html) in der Amazon Bedrock-Dokumentation.

336</Warning>

337

338Gewähren Sie außerdem `bedrock:ApplyGuardrail` auf die Guardrail dem Principal, der die Anfragen dieses Upstreams signiert: dem AWS-Principal des Gateways oder, mit [`assume_role`](#bedrock-in-another-aws-account), der in `role_arn` benannten Rolle.

339

340Setzen Sie `guardrail` auf jedem `bedrock`-Upstream oder auf keinem. Bei einer Mischung weigert sich das Gateway zu starten, da [Failover](#multiple-upstreams) eine Anfrage sonst an einen Bedrock-Upstream ohne Guardrail senden könnte.

341

342Die Guardrail gilt nur für Bedrock-Upstreams. Wenn Sie einen anderen Anbieter in `upstreams` auflisten, sendet das Gateway Anfragen an diesen Anbieter ohne die Guardrail.

343

344Wenn eine `/v1/messages`-Anfrage, deren Body ein `amazon-bedrock-*`-Feld wie `amazon-bedrock-guardrailConfig` enthält, einen Bedrock-Upstream mit gesetztem `guardrail` erreicht, antwortet das Gateway mit 400, statt sie weiterzuleiten.

345

346<a id="bedrock-in-another-aws-account" />

347

348<h5 id="bedrock-in-another-aws-account">

349 Bedrock in einem anderen AWS-Konto

350</h5>

351

352Setzen Sie `assume_role` auf einem Bedrock-Upstream, und das Gateway verwendet seine eigene AWS-Identität nur, um `sts:AssumeRole` für eine von Ihnen benannte Rolle aufzurufen, die sich in einem anderen AWS-Konto als das Gateway befinden kann. Jede Bedrock-Anfrage von diesem Upstream wird mit den einstündigen Anmeldedaten signiert, die STS zurückgibt, sodass kein langlebiger Zugriffsschlüssel Kontogrenzen überschreitet.

353

354Erfordert ein Gateway, das Claude Code v2.1.281 oder später ausführt. Ein früheres Gateway weigert sich zu starten, wenn es den Schlüssel findet.

355

356```yaml theme={null}

357upstreams:

358 - name: bedrock-isolated

359 provider: bedrock

360 region: us-east-1

361 auth: {} # the gateway's own role: it only calls STS

362 assume_role:

363 role_arn: arn:aws:iam::222222222222:role/claude-gateway-bedrock

364 # external_id: ${BEDROCK_ROLE_EXTERNAL_ID} # when the role's trust policy requires one

365```

366

367Der `assume_role`-Block akzeptiert drei Schlüssel:

368

369| Schlüssel | Bedeutung |

370| - | - |

371| `role_arn` | Die IAM-Rolle, die das Gateway annimmt, als `arn:aws:iam::`- oder `arn:aws-us-gov:iam::`-ARN. Geben Sie ihr die [Bedrock-Berechtigungen](#amazon-bedrock), die dieser Upstream benötigt, einschließlich `bedrock:CountTokens`, sowie `bedrock:ApplyGuardrail`, wenn der Upstream `guardrail` setzt. |

372| `external_id` | Optional. Wird bei jedem `sts:AssumeRole`-Aufruf als External ID gesendet. Setzen Sie sie, wenn die Vertrauensrichtlinie der Rolle eine verlangt, und setzen Sie sie in Anführungszeichen, wenn sie nur aus Ziffern besteht. |

373| `session_name` | Optional. `email` oder `sub` gibt jedem Entwickler eine eigene Sitzung: siehe [AWS-Kostenzuordnung pro Entwickler](#per-developer-aws-cost-attribution). Ohne Angabe verwendet jede Anfrage eine Sitzung namens `claude-apps-gateway`. |

374

375Die Vertrauensrichtlinie der Rolle benennt den eigenen Principal des Gateways, etwa seine IRSA- oder ECS-Task-Rolle. Dieser Principal benötigt `sts:AssumeRole` für die Rolle und keine eigene Bedrock-Berechtigung. Entfernen Sie die `Condition`, wenn Sie keine `external_id` setzen.

376

377```json theme={null}

378{

379 "Version": "2012-10-17",

380 "Statement": [{

381 "Effect": "Allow",

382 "Principal": { "AWS": "arn:aws:iam::111111111111:role/claude-gateway" },

383 "Action": "sts:AssumeRole",

384 "Condition": { "StringEquals": { "sts:ExternalId": "your-external-id" } }

385 }]

386}

387```

388

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

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

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

392* Jeder Entwickler, den das Gateway zulässt, kann diesen Upstream verwenden; [`managed`](#managed) regelt, welche Entwickler welche Modelle verwenden dürfen. Damit ein über die Rolle bereitgestelltes Modell nicht auch aus einem anderen Konto bereitgestellt wird, geben Sie ihm eine benutzerdefinierte ID, deren `upstream_model`-Zuordnung nur den Namen dieses Upstreams enthält. Für eine solche ID überspringt das Gateway jeden anderen Upstream, sodass weder die Anfrage noch die Token-Zählung für eine abgebrochene Anfrage per Failover an ein anderes Konto gehen kann. Integrierte Modellnamen werden weiterhin der Reihe nach auf jedem Upstream versucht, einschließlich diesem, und eine Anfrage, die ihn erreicht, wird mit derselben Rolle signiert; listen Sie diesen Upstream daher zuletzt auf, sofern sein Konto sie nicht ebenfalls bedienen soll.

393

394Dieses Beispiel gibt einem Modell eine benutzerdefinierte ID, die nur der isolierte Upstream bereitstellt:

395

396```yaml theme={null}

397models:

398 - id: claude-opus-restricted # a custom id, not a built-in model name

399 upstream_model:

400 bedrock-isolated: us.anthropic.claude-opus-4-8 # the only upstream that serves it

401```

402

403<a id="per-developer-aws-cost-attribution" />

404

405<h5 id="per-developer-aws-cost-attribution">

406 AWS-Kostenzuordnung pro Entwickler

407</h5>

408

409Standardmäßig signiert das Gateway jede Bedrock-Anfrage mit denselben Anmeldedaten, sodass AWS die Anfragen aller Entwickler unter einem einzigen IAM-Principal sieht. Fügen Sie `session_name: email` zu [`assume_role`](#bedrock-in-another-aws-account) hinzu, und das Gateway ruft `sts:AssumeRole` einmal pro Entwickler und Stunde auf, wobei der Sitzungsname auf die E-Mail dieses Entwicklers gesetzt ist, und signiert dessen Anfragen mit den zurückgegebenen Anmeldedaten, sodass die Anfragen jedes Entwicklers AWS unter seiner eigenen Assumed-Role-Sitzung erreichen. Die Rolle kann sich im eigenen Konto des Gateways befinden.

410

411Erfordert ein Gateway, das Claude Code v2.1.281 oder später ausführt. [Kostenzuordnung auf AWS](/docs/de/claude-apps-gateway-on-aws#cost-attribution) behandelt die IAM-Rolle und wo die AWS-Abrechnung die Sitzungen anzeigt.

412

413```yaml theme={null}

414upstreams:

415 - provider: bedrock

416 region: us-east-1

417 auth: {} # the gateway's own role: it only calls STS

418 assume_role:

419 role_arn: arn:aws:iam::123456789012:role/claude-gateway-bedrock-user

420 session_name: email # or sub

421```

422

423`session_name` wählt aus, welcher verifizierte Anspruch zum AWS-`RoleSessionName` wird: `email` oder `sub`. Das Gateway schreibt jedes Zeichen außer ASCII-Buchstaben, Ziffern und `_+,.@-` als `=XX`-Hex pro UTF-8-Byte und kürzt ein Ergebnis, das länger als 64 Zeichen ist, auf ein Präfix plus einen Hash, sodass der Sitzungsname jedes Entwicklers gültig und eindeutig bleibt. Eine Anfrage eines Entwicklers, dessen Token den Anspruch nicht enthält, wird nicht über diesen Upstream gesendet, und das Operator-Log weist darauf hin, zu `sub` zu wechseln oder [`oidc.email_claim`](#oidc) zu setzen.

424

425Ein aktiver Entwickler verursacht einen STS-Aufruf pro Stunde pro Gateway-Replikat, und gleichzeitige erste Anfragen teilen sich einen Aufruf.

426

427Das Gateway führt mit dieser Rolle auch einen eigenen Aufruf aus: die Token-Zählung für eine Anfrage, die der Client abgebrochen hat, damit [Ausgabenlimits](/docs/de/claude-apps-gateway-spend-limits) genau bleiben. Diese Zählung und ihre [Ein-Token-Fallback-Anfrage](#amazon-bedrock) werden von der gemeinsamen `claude-apps-gateway`-Sitzung signiert, daher ordnet AWS den Fallback `claude-apps-gateway` statt dem Entwickler zu.

428

429Für eine strikte Zuordnung pro Entwickler setzen Sie `assume_role` mit `session_name` auf jedem aufgelisteten Bedrock-Upstream. Ein Upstream ohne diese Einstellung signiert die Anfragen, die er bedient, mit seinen eigenen Anmeldedaten.

315 430

316<h4 id="claude-platform-on-aws">431<h4 id="claude-platform-on-aws">

317 Claude Platform on AWS432 Claude Platform on AWS

318</h4>433</h4>

319 434

320Claude Platform on AWS bedient die First-Party-Anthropic-API auf AWS-Infrastruktur unter `aws-external-anthropic.<region>.api.aws`. Sie verwendet First-Party-Modell-IDs, beachtet `anthropic-beta`-Header wie gesendet und bedient `count_tokens`, daher gilt keine der Bedrock-spezifischen Übersetzung. Der `anthropicAws`-Provider erfordert Claude Code v2.1.198 oder später; frühere Gateway-Versionen lehnen ihn beim Start ab.435Claude Platform on AWS stellt die First-Party-Anthropic-API auf AWS-Infrastruktur unter `aws-external-anthropic.<region>.api.aws` bereit. Sie verwendet First-Party-Modell-IDs, beachtet `anthropic-beta`-Header wie gesendet und stellt `count_tokens` bereit, daher entfällt jegliche Bedrock-spezifische Übersetzung. Der `anthropicAws`-Provider erfordert Claude Code v2.1.198 oder später; frühere Gateway-Versionen lehnen ihn beim Start ab.

321 436

322Für die Client-seitige Bereitstellung derselben Plattform siehe [Claude Code on Claude Platform on AWS](/docs/de/claude-platform-on-aws). Der Gateway-seitige Upstream:437Für die clientseitige Bereitstellung derselben Plattform siehe [Claude Code on Claude Platform on AWS](/docs/de/claude-platform-on-aws). Der gatewayseitige Upstream:

323 438

324```yaml theme={null}439```yaml theme={null}

325upstreams:440upstreams:

338 # base_url: https://aws-external-anthropic.us-east-1.api.aws453 # base_url: https://aws-external-anthropic.us-east-1.api.aws

339```454```

340 455

341Die Plattform läuft in einem separaten AWS-Konto von Amazon Bedrock und signiert SigV4-Anfragen für seinen eigenen Service-Namen, `aws-external-anthropic`, daher autorisiert eine Bedrock-scoped IAM-Rolle es nicht. Ein API-Schlüssel in `auth.api_key` hat Vorrang, wenn SigV4-Berechtigungsnachweise auch gesetzt sind. Ein leerer `auth`-Block verwendet die Standard-Berechtigungskette des AWS SDK, die gleiche Kette, die der [Amazon Bedrock](#amazon-bedrock)-Upstream verwendet.456Die Plattform läuft in einem von Amazon Bedrock getrennten AWS-Konto und signiert SigV4-Anfragen für ihren eigenen Service-Namen, `aws-external-anthropic`, daher autorisiert eine auf Bedrock beschränkte IAM-Rolle sie nicht. Ein API-Schlüssel in `auth.api_key` hat Vorrang, wenn auch SigV4-Anmeldedaten gesetzt sind. Ein leerer `auth`-Block verwendet die Standard-Anmeldedatenkette des AWS SDK, die gleiche Kette, die der [Amazon Bedrock](#amazon-bedrock)-Upstream verwendet.

342 457

344| - | - | - |459| - | - | - |

345| `region` | Ja | AWS-Region, Kleinbuchstaben, Ziffern und Bindestriche. Das Gateway leitet den Endpunkt davon ab als `https://aws-external-anthropic.<region>.api.aws`. |460| `region` | Ja | AWS-Region, Kleinbuchstaben, Ziffern und Bindestriche. Das Gateway leitet den Endpunkt davon ab als `https://aws-external-anthropic.<region>.api.aws`. |

346| `workspace_id` | Ja | Wird als Header bei jeder Anfrage gesendet; die Plattform erfordert es |461| `workspace_id` | Ja | Wird als Header bei jeder Anfrage gesendet; die Plattform erfordert es |

348| `auth.aws_access_key_id` / `auth.aws_secret_access_key` | Nein | Explizite SigV4-Berechtigungsnachweise. Das Setzen eines ohne das andere schlägt beim Start fehl. `auth.aws_session_token` wird neben ihnen akzeptiert. |463| `auth.aws_access_key_id` / `auth.aws_secret_access_key` | Nein | Explizite SigV4-Anmeldedaten. Das Setzen eines ohne das andere schlägt beim Start fehl. `auth.aws_session_token` wird neben ihnen akzeptiert. |

350 465

351Da die Plattform First-Party-Modell-IDs auflöst, leitet der integrierte Katalog zu ihr ohne [`models:`](#models)-Block weiter. Wenn Sie eine `models:`-Liste kuratieren, schlüsseln Sie den Eintrag `anthropicAws:` mit der First-Party-ID.466Da die Plattform First-Party-Modell-IDs auflöst, leitet der integrierte Katalog ohne [`models:`](#models)-Block an sie weiter. Wenn Sie eine `models:`-Liste kuratieren, verwenden Sie für den Eintrag den Schlüssel `anthropicAws:` mit der First-Party-ID.

352 467

353<h4 id="google-cloud-agent-platform">468<h4 id="google-cloud-agent-platform">

354 Google Cloud Agent Platform469 Google Cloud Agent Platform

355</h4>470</h4>

356 471

357Für das äquivalente Client-seitige Setup siehe [Claude Code on Google Cloud](/docs/de/google-vertex-ai). Der Gateway-seitige Upstream:472Für das äquivalente clientseitige Setup siehe [Claude Code on Google Cloud](/docs/de/google-vertex-ai). Der gatewayseitige Upstream:

358 473

359```yaml theme={null}474```yaml theme={null}

360upstreams:475upstreams:

368 # base_url: https://us-east5-aiplatform.p.googleapis.com483 # base_url: https://us-east5-aiplatform.p.googleapis.com

369```484```

370 485

371Ein leerer `auth`-Block verwendet Application Default Credentials: `GOOGLE_APPLICATION_CREDENTIALS`, GCE-Metadaten oder GKE Workload Identity. Service-Account-JSON-Schlüsseldateien werden unterstützt, aber nicht empfohlen; verwenden Sie Workload Identity oder fügen Sie ein Service-Account an die GCE- oder Cloud Run-Instanz an.486Ein leerer `auth`-Block verwendet Application Default Credentials: `GOOGLE_APPLICATION_CREDENTIALS`, GCE-Metadaten oder GKE Workload Identity. Service-Account-JSON-Schlüsseldateien werden unterstützt, aber nicht empfohlen; verwenden Sie Workload Identity oder hängen Sie einen Service-Account an die GCE- oder Cloud Run-Instanz an.

372 487

373Setzen Sie `region: global`, um den [globalen Endpunkt für Google Cloud's Agent Platform](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations) anstelle eines regionalen zu verwenden. Google leitet dann jede Anfrage an eine verfügbare Region weiter, daher verfolgen Sie keine Pro-Region-Modellverfügbarkeit. Das Setzen einer bestimmten Region heftet jede Anfrage daran.488Setzen Sie `region: global`, um den [globalen Endpunkt für Google Cloud's Agent Platform](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations) anstelle eines regionalen zu verwenden. Google leitet dann jede Anfrage an eine verfügbare Region weiter, sodass Sie die Modellverfügbarkeit pro Region nicht verfolgen müssen. Das Setzen einer bestimmten Region bindet jede Anfrage an diese.

374 489

375| Setup | Wie |490| Setup | Wie |

376| - | - |491| - | - |

377| IAM-Berechtigungen | Gewähren Sie dem Service-Account des Gateways `roles/aiplatform.user` auf dem Projekt, oder eine benutzerdefinierte Rolle mit `aiplatform.endpoints.predict`. Aktivieren Sie Google Cloud's Agent Platform API (`aiplatform.googleapis.com`). |492| IAM-Berechtigungen | Gewähren Sie dem Service-Account des Gateways `roles/aiplatform.user` auf dem Projekt, oder eine benutzerdefinierte Rolle mit `aiplatform.endpoints.predict`. Aktivieren Sie die Google Cloud's Agent Platform API (`aiplatform.googleapis.com`). |

378| Modellzugriff | Aktivieren Sie in Model Garden die Claude-Modelle für Ihr Projekt. Sie veröffentlichen zu bestimmten Regionen; überprüfen Sie die Modellkarte auf unterstützte Regionen. |493| Modellzugriff | Aktivieren Sie in Model Garden die Claude-Modelle für Ihr Projekt. Sie werden in bestimmten Regionen veröffentlicht; prüfen Sie die Modellkarte auf unterstützte Regionen. |

379| GKE (Workload Identity) | Binden Sie ein GCP-Service-Account an das Kubernetes-Service-Account des Gateways und kommentieren Sie das KSA mit `iam.gke.io/gcp-service-account: claude-gateway@<proj>.iam.gserviceaccount.com`. `auth: {}` nimmt es auf. |494| GKE (Workload Identity) | Binden Sie einen GCP-Service-Account an den Kubernetes-Service-Account des Gateways und annotieren Sie den KSA mit `iam.gke.io/gcp-service-account: claude-gateway@<proj>.iam.gserviceaccount.com`. `auth: {}` übernimmt ihn. |

380| Cloud Run / GCE | Setzen Sie das Service-Account des Service auf eines mit `roles/aiplatform.user`. `auth: {}` nimmt es auf. |495| Cloud Run / GCE | Setzen Sie den Service-Account des Service auf einen mit `roles/aiplatform.user`. `auth: {}` übernimmt ihn. |

381| Überall sonst | `auth: { service_account_json: /secrets/sa.json }`, der Pfad zu einer JSON-Schlüsseldatei, die als Geheimnis bereitgestellt wird. Das Feld nimmt einen Dateipfad, nicht den Schlüsselinhalt, daher ist keine `${file:…}`-Erweiterung beteiligt. |496| Überall sonst | `auth: { service_account_json: /secrets/sa.json }`, der Pfad zu einer JSON-Schlüsseldatei, die als Geheimnis gemountet ist. Das Feld nimmt einen Dateipfad, nicht den Schlüsselinhalt, daher ist keine `${file:…}`-Erweiterung beteiligt. |

382 497

383<h4 id="microsoft-foundry">498<h4 id="microsoft-foundry">

384 Microsoft Foundry499 Microsoft Foundry

385</h4>500</h4>

386 501

387Für die Client-seitige Microsoft Foundry-Bereitstellung siehe [Claude Code on Microsoft Foundry](/docs/de/microsoft-foundry). Der Gateway-seitige Upstream:502Für die clientseitige Microsoft Foundry-Bereitstellung siehe [Claude Code on Microsoft Foundry](/docs/de/microsoft-foundry). Der gatewayseitige Upstream:

388 503

389```yaml theme={null}504```yaml theme={null}

390upstreams:505upstreams:

396 # api_key: ${FOUNDRY_API_KEY}511 # api_key: ${FOUNDRY_API_KEY}

397```512```

398 513

399`use_azure_ad: true` löst durch `DefaultAzureCredential` auf: Managed Identity auf AKS, ACI oder App Service; die Azure CLI; oder Umgebungsberechtigungsnachweise. API-Schlüssel funktionieren, sind aber projektumfassend und rotieren nicht automatisch. Der Endpunkt von Microsoft Foundry wird von `resource:` abgeleitet; setzen Sie das optionale `base_url`, um es für souveräne Clouds wie Azure Government zu überschreiben.514`use_azure_ad: true` löst über `DefaultAzureCredential` auf: Managed Identity auf AKS, ACI oder App Service; die Azure CLI; oder Anmeldedaten aus der Umgebung. API-Schlüssel funktionieren, gelten aber projektweit und rotieren nicht automatisch. Der Endpunkt von Microsoft Foundry wird von `resource:` abgeleitet; setzen Sie das optionale `base_url`, um ihn für souveräne Clouds wie Azure Government zu überschreiben.

400 515

401| Setup | Wie |516| Setup | Wie |

402| - | - |517| - | - |

403| RBAC | Gewähren Sie der Identität des Gateways `Azure AI User` oder `Cognitive Services User` auf der Microsoft Foundry-Ressource |518| RBAC | Gewähren Sie der Identität des Gateways `Azure AI User` oder `Cognitive Services User` auf der Microsoft Foundry-Ressource |

404| Bereitstellungen | Microsoft Foundry verwendet von Administratoren gewählte Bereitstellungsnamen, nicht kanonische Modell-IDs. Fügen Sie einen [`models:`](#models)-Block hinzu, der jede kanonische ID Ihrem Bereitstellungsnamen zuordnet. |519| Deployments | Microsoft Foundry verwendet von Administratoren gewählte Deployment-Namen, nicht kanonische Modell-IDs. Fügen Sie einen [`models:`](#models)-Block hinzu, der jede kanonische ID Ihrem Deployment-Namen zuordnet. |

405| AKS (Workload Identity) | Verbinden Sie eine User-Assigned Managed Identity mit dem OIDC-Aussteller des Clusters und binden Sie sie an das Service-Account des Gateways. `use_azure_ad: true` nimmt es über `WorkloadIdentityCredential` auf. |520| AKS (Workload Identity) | Verknüpfen Sie eine User-Assigned Managed Identity per Federation mit dem OIDC-Aussteller des Clusters und binden Sie sie an den Service-Account des Gateways. `use_azure_ad: true` übernimmt sie über `WorkloadIdentityCredential`. |

406| ACI / App Service | Aktivieren Sie system-zugewiesene oder user-zugewiesene Managed Identity auf der Ressource. `use_azure_ad: true` nimmt es auf. |521| ACI / App Service | Aktivieren Sie eine system- oder benutzerzugewiesene Managed Identity auf der Ressource. `use_azure_ad: true` übernimmt sie. |

407| Überall sonst | `auth: { api_key: "${FOUNDRY_API_KEY}" }`. Zitieren Sie `${…}` innerhalb von `{ }`. |522| Überall sonst | `auth: { api_key: "${FOUNDRY_API_KEY}" }`. Setzen Sie `${…}` innerhalb von `{ }` in Anführungszeichen. |

408 523

409<h4 id="static-headers-on-upstream-requests">524<h4 id="static-headers-on-upstream-requests">

410 Statische Header auf Upstream-Anfragen525 Statische Header auf Upstream-Anfragen

411</h4>526</h4>

412 527

413Um feste Header zu den Anfragen hinzuzufügen, die das Gateway an einen Upstream sendet, setzen Sie `headers:` auf diesem Upstream. Verwenden Sie es, wenn ein Proxy, den Sie vor dem Anbieter betreiben, Traffic nach einem Header leitet oder zuordnet.528Um feste Header zu den Anfragen hinzuzufügen, die das Gateway an einen Upstream sendet, setzen Sie `headers:` auf diesem Upstream. Verwenden Sie es, wenn ein Proxy, den Sie vor dem Anbieter betreiben, Traffic anhand eines Headers weiterleitet oder zuordnet.

414 529

415`headers:` erfordert Claude Code v2.1.277 oder später auf dem Gateway-Server. Ein früheres Gateway weigert sich zu starten, wenn es den Schlüssel findet. Aktualisieren Sie jedes Replikat, bevor Sie den Schlüssel hinzufügen, und entfernen Sie den Schlüssel, bevor Sie zu einer früheren Version zurückrollen.530`headers:` erfordert Claude Code v2.1.277 oder später auf dem Gateway-Server. Ein früheres Gateway weigert sich zu starten, wenn es den Schlüssel findet. Aktualisieren Sie jedes Replikat, bevor Sie den Schlüssel hinzufügen, und entfernen Sie den Schlüssel, bevor Sie auf eine frühere Version zurückrollen.

416 531

417Die Header gehen an den Server, den `base_url` benennt, oder an den eigenen Endpunkt des Anbieters, wenn `base_url` nicht gesetzt ist. Der Anbieter erhält sie auch, sofern Ihr Proxy sie nicht entfernt.532Die Header gehen an den Server, den `base_url` benennt, oder an den eigenen Endpunkt des Anbieters, wenn `base_url` nicht gesetzt ist. Der Anbieter erhält sie ebenfalls, sofern Ihr Proxy sie nicht entfernt.

418 533

419Dieses Beispiel erreicht einen `provider: vertex`-Upstream durch einen Proxy unter `upstream-proxy.internal.example.com`. Es setzt den `x-source`-Header, den der Proxy liest, und sendet ein Token aus der `PROXY_TOKEN`-Umgebungsvariable als `x-proxy-token`:534Dieses Beispiel erreicht einen `provider: vertex`-Upstream über einen Proxy unter `upstream-proxy.internal.example.com`. Es setzt den `x-source`-Header, den der Proxy liest, und sendet ein Token aus der Umgebungsvariable `PROXY_TOKEN` als `x-proxy-token`:

420 535

421```yaml theme={null}536```yaml theme={null}

422upstreams:537upstreams:

430 x-proxy-token: ${PROXY_TOKEN}545 x-proxy-token: ${PROXY_TOKEN}

431```546```

432 547

433Werte sind druckbarer ASCII-Text ohne Leerzeichen an beiden Enden. Zitieren Sie eine Zahl, `true` oder `false`, damit YAML sie als Text liest.548Werte sind druckbarer ASCII-Text ohne Leerzeichen an einem der beiden Enden. Setzen Sie eine Zahl, `true` oder `false` in Anführungszeichen, damit YAML sie als Text liest.

434 549

435Um ein Geheimnis aus der Konfigurationsdatei zu halten, verwenden Sie [Geheimnis-Erweiterung](#secret-expansion), um den Wert aus einer Umgebungsvariable mit `${VAR}` oder aus einer Datei mit `${file:/path}` zu laden. Ein `${VAR}`, das zu einem leeren Wert aufgelöst wird, stoppt das Gateway vom Start.550Um ein Geheimnis aus der Konfigurationsdatei herauszuhalten, verwenden Sie [Geheimnis-Erweiterung](#secret-expansion), um den Wert aus einer Umgebungsvariable mit `${VAR}` oder aus einer Datei mit `${file:/path}` zu laden. Ein `${VAR}`, das zu einem leeren Wert aufgelöst wird, verhindert den Start des Gateways.

436 551

437`headers:` funktioniert auf jedem Anbieter, und jeder Upstream sendet nur seine eigenen.552`headers:` funktioniert bei jedem Anbieter, und jeder Upstream sendet nur seine eigenen.

438 553

439Nicht jede Anfrage, die das Gateway an einen Upstream sendet, trägt sie:554Nicht jede Anfrage, die das Gateway an einen Upstream sendet, enthält sie:

440 555

442| - | - |557| - | - |

443| `/v1/messages`, Streaming oder nicht, und `/v1/messages/count_tokens` | Ja |558| `/v1/messages`, mit oder ohne Streaming, und `/v1/messages/count_tokens` | Ja |

446| Der Workload Identity Federation-Token-Austausch | Nein |561| Der Workload Identity Federation-Token-Austausch | Nein |

447 562

448Auf einem Amazon Bedrock oder Claude Platform on AWS-Upstream, der Anfragen mit AWS SigV4 signiert, sind diese Header Teil der Signatur, daher muss Ihr Proxy sie unverändert durchlassen.563Bei einem Amazon Bedrock- oder Claude Platform on AWS-Upstream, der Anfragen mit AWS SigV4 signiert, sind diese Header Teil der Signatur, daher muss Ihr Proxy sie unverändert durchlassen.

449 564

450Wenn Sie einen Namen verwenden, den das Gateway reserviert, weigert es sich zu starten, und der Startup-Fehler benennt den Header. Reservierte Namen umfassen:565Wenn Sie einen Namen verwenden, den das Gateway reserviert, weigert es sich zu starten, und der Startfehler benennt den Header. Reservierte Namen umfassen:

451 566

452* `authorization` und `x-api-key`567* `authorization` und `x-api-key`

453* `host`, `content-type` und `user-agent`568* `host`, `content-type` und `user-agent`

454* Jeder Name, der mit `anthropic-`, `x-goog-`, `x-amz-` oder `x-amzn-` beginnt569* Jeden Namen, der mit `anthropic-`, `x-goog-`, `x-amz-` oder `x-amzn-` beginnt

455 570

456<h4 id="multiple-upstreams">571<h4 id="multiple-upstreams">

457 Mehrere Upstreams572 Mehrere Upstreams

458</h4>573</h4>

459 574

460Der gleiche Provider kann mehr als einmal mit einem unterschiedlichen `name:` erscheinen. Dies deckt verschiedene Regionen, verschiedene Konten über verschiedene Berechtigungsketten, bereitgestellter Durchsatz versus On-Demand und Cross-Provider-Fallback ab.575Derselbe Anbieter kann mehr als einmal mit einem unterschiedlichen `name:` erscheinen. Dies deckt verschiedene Regionen, verschiedene Konten über verschiedene Anmeldedatenketten, Provisioned Throughput versus On-Demand und anbieterübergreifenden Fallback ab.

~~461~~

462Das Gateway versucht Upstreams in Reihenfolge. `5xx`, `429`, `401`, `403`, `404`, Timeouts und fehlender Endpunkt (`501`) schlagen fehl über; andere `4xx` nicht.

463 576

464`429` ist Pro-Upstream-Kapazität, daher schlägt bereitgestellter Durchsatz (PT)-Erschöpfung zu On-Demand fehl über. Wenn Sie [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) auf einem Upstream setzen, ist ein `429` auf eine Anfrage, die die E-Mail des Entwicklers trug, eine Pro-Benutzer-Ablehnung statt und schlägt nicht fehl über.577Das Gateway versucht Upstreams der Reihe nach. Bei `5xx`, `429`, `401`, `403`, `404`, Timeouts und fehlendem Endpunkt (`501`) erfolgt ein Failover; bei anderen `4xx` nicht.

465 578

466`404` ist Pro-Upstream-Modellverfügbarkeit, daher blockiert ein Upstream, der ein Modell nicht aktiviert hat, keinen späteren Upstream, der es bedient. Ein Upstream, der das angeforderte Modell nicht auflösen kann, wird ohne Netzwerk-Roundtrip übersprungen.579`429` ist Kapazität pro Upstream, daher führt die Erschöpfung von Provisioned Throughput (PT) zu einem Failover auf On-Demand. Wenn Sie [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) auf einem Upstream setzen, ist ein `429` auf eine Anfrage, die die E-Mail des Entwicklers trug, stattdessen eine Ablehnung pro Benutzer und führt nicht zu einem Failover.

467 580

468Jede Anfrage startet beim ersten Upstream. Eine Anfrage erreicht einen späteren Upstream nur, wenn jeder Upstream vor ihm fehlgeschlagen ist oder das angeforderte Modell nicht bedient.581Jede Anfrage beginnt beim ersten Upstream. Eine Anfrage erreicht einen späteren Upstream nur, wenn jeder Upstream davor fehlgeschlagen ist oder das angeforderte Modell nicht bereitstellt.

469 582

470Das Gateway führt keine Aufzeichnung fehlgeschlagener Upstreams, daher versucht jede Anfrage, die ihn erreicht, ihn immer noch und wartet, bis er fehlschlägt, bevor es weitergeht, während ein Upstream ausfällt.583Das Gateway führt keine Aufzeichnung über fehlgeschlagene Upstreams, daher versucht, während ein Upstream ausgefallen ist, jede Anfrage, die ihn erreicht, ihn weiterhin und wartet auf sein Fehlschlagen, bevor sie weitergeht.

471 584

472Für einen Anthropic-API-Upstream begrenzt [`timeouts.upstream_ttfb_ms`](#http-tuning) das Warten auf einen ausgefallenen Upstream. Diese Einstellung gilt nicht für die anderen Anbieter, wo das Gateway bis zu eine Stunde wartet, bis ein Upstream anfängt zu antworten.585Für einen Anthropic-API-Upstream begrenzt [`timeouts.upstream_ttfb_ms`](#http-tuning) das Warten auf einen ausgefallenen Upstream. Diese Einstellung gilt nicht für die anderen Anbieter, bei denen das Gateway bis zu eine Stunde wartet, bis ein Upstream zu antworten beginnt.

473 586

474`404` ist Pro-Upstream-Modellverfügbarkeit, daher blockiert ein Upstream, der ein Modell nicht aktiviert hat, keinen späteren Upstream, der es bedient. Ein Upstream, der das angeforderte Modell nicht auflösen kann, wird ohne Netzwerk-Roundtrip übersprungen.587`404` ist Modellverfügbarkeit pro Upstream, daher blockiert ein Upstream, der ein Modell nicht aktiviert hat, keinen späteren Upstream, der es bereitstellt. Ein Upstream, der das angeforderte Modell nicht auflösen kann, wird ohne Netzwerk-Roundtrip übersprungen.

475 588

476Dieses Beispiel leitet eine bereitgestellte Durchsatz-Amazon Bedrock-Zuteilung zuerst weiter, überläuft zu On-Demand und einem zweiten Konto und fällt zuletzt auf die Anthropic API zurück:589Dieses Beispiel leitet zuerst an ein Amazon Bedrock-Provisioned-Throughput-Kontingent weiter, weicht bei Überlauf auf On-Demand und ein zweites Konto aus und fällt zuletzt auf die Anthropic API zurück:

477 590

478```yaml theme={null}591```yaml theme={null}

479upstreams:592upstreams:

487 provider: bedrock600 provider: bedrock

488 region: us-west-2601 region: us-west-2

489 auth: {}602 auth: {}

490 # Different account: a separate Bedrock allotment via assumed-role creds.603 # Different account: a separate Bedrock allotment via static keys.

491 - name: bedrock-acct2604 - name: bedrock-acct2

492 provider: bedrock605 provider: bedrock

493 region: us-east-1606 region: us-east-1

513 626

514| Hebel | Wie |627| Hebel | Wie |

515| - | - |628| - | - |

516| Verschiedene Regionen | Ein Amazon Bedrock-Upstream pro Region, jeder mit seiner eigenen `region:`. Mit [`auto_include_builtin_models: true`](#models) leiten die Cross-Region-Inference-Profile automatisch weiter; für Region-geheftete Bereitstellungen verwenden Sie einen `models:`-Block. |629| Verschiedene Regionen | Ein Amazon Bedrock-Upstream pro Region, jeder mit seiner eigenen `region:`. Mit [`auto_include_builtin_models: true`](#models) leiten die Cross-Region-Inference-Profile automatisch weiter; für an eine Region gebundene Bereitstellungen verwenden Sie einen `models:`-Block. |

517| Verschiedene Konten | Ein Amazon Bedrock-Upstream pro Konto, jeder mit seinen eigenen Berechtigungsnachweisen in `auth:`. Die Standard-Kette (`auth: {}`) verwendet die Identität des Pods; für ein zweites Konto setzen Sie explizite Berechtigungsnachweise oder ein Bearer-Token. |630| Verschiedene Konten | Ein Amazon Bedrock-Upstream pro Konto. Die Standard-Kette (`auth: {}`) verwendet die Identität des Pods; für ein zweites Konto fügen Sie [`assume_role`](#bedrock-in-another-aws-account) hinzu, um es mit kurzlebigen Anmeldedaten zu erreichen, oder setzen explizite Anmeldedaten oder ein Bearer-Token in `auth:`. |

518| Bereitgestellter Durchsatz | Ordnen Sie das Modell der bereitgestellten Durchsatz-ARN in `models:` für den Namen dieses Upstreams zu. Andere Upstreams behalten die On-Demand-ID, daher wird PT-Kapazität vor dem Failover erschöpft. |631| Provisioned Throughput | Ordnen Sie das Modell in `models:` für den Namen dieses Upstreams der Provisioned-Throughput-ARN zu. Andere Upstreams behalten die On-Demand-ID, daher wird die PT-Kapazität vor dem Failover ausgeschöpft. |

520| Modell-scoped Routing | Nur eine benutzerdefinierte Modell-`id`, eine, die kein integriertes Claude-Modell ist, überspringt die Upstreams, die in ihrer `upstream_model:`-Karte fehlen. Das Gateway versucht integrierte Modelle auf jedem Upstream in Reihenfolge und verwendet die Standard-ID des Anbieters, wo die Karte keinen Eintrag hat, daher ändert die Karte für integrierte Modelle, welche ID ein Upstream erhält, statt ob er versucht wird; ein Upstream, der die ID ablehnt, folgt den gleichen [Failover-Regeln](#upstreams) wie jeder andere Upstream-Fehler. |633| Modellbezogenes Routing | Nur eine benutzerdefinierte Modell-`id`, also eine, die kein integriertes Claude-Modell ist, überspringt die Upstreams, die in ihrer `upstream_model:`-Zuordnung fehlen. Das Gateway versucht integrierte Modelle der Reihe nach auf jedem Upstream und verwendet die Standard-ID des Anbieters, wo die Zuordnung keinen Eintrag hat, daher ändert die Zuordnung für integrierte Modelle, welche ID ein Upstream erhält, statt ob er versucht wird; ein Upstream, der die ID ablehnt, folgt den gleichen [Failover-Regeln](#upstreams) wie jeder andere Upstream-Fehler. |

521 634

522Das Failover zwischen Cloud-Anbietern oder zur direkten Anthropic API ändert, welche Vereinbarung, Geographie und andere Bedingungen die Anfrage regeln.635Ein Failover zwischen Cloud-Anbietern oder zur direkten Anthropic API ändert, welche Vereinbarung, Geografie und anderen Bedingungen für die Anfrage gelten.

523 636

524Die CLI wendet die gleiche Feature-Gating auf Gateways an, unabhängig davon, welcher Upstream eine gegebene Anfrage bedient, daher sendet Failover kein Body-Feld, das ein Upstream ablehnen würde.637Die CLI wendet dasselbe Feature-Gating auf Gateways an, unabhängig davon, welcher Upstream eine bestimmte Anfrage bedient, daher sendet ein Failover kein Body-Feld, das ein Upstream ablehnen würde.

525 638

526<h2 id="optional-sections">639<h2 id="optional-sections">

527 Optionale Abschnitte640 Optionale Abschnitte

554| `write_keys` | Nein | Array von `{id, key}`. Ein `x-api-key`, das einem dieser Schlüssel entspricht, kann Ausgabenlimits auflisten, festlegen und löschen. Schlüsselwerte müssen mindestens 32 Zeichen lang sein; `id`s müssen über `read_keys` und `write_keys` hinweg eindeutig sein. |667| `write_keys` | Nein | Array von `{id, key}`. Ein `x-api-key`, das einem dieser Schlüssel entspricht, kann Ausgabenlimits auflisten, festlegen und löschen. Schlüsselwerte müssen mindestens 32 Zeichen lang sein; `id`s müssen über `read_keys` und `write_keys` hinweg eindeutig sein. |

555| `read_keys` | Nein | Array von `{id, key}`. Schreibgeschützt: alle `GET`-Endpunkte, einschließlich Auflisten von Limits, Abrufen nach ID und Lesen von [`/effective`](/docs/de/claude-apps-gateway-spend-limits#%2Feffective) und [`/audit`](/docs/de/claude-apps-gateway-spend-limits#%2Faudit). |668| `read_keys` | Nein | Array von `{id, key}`. Schreibgeschützt: alle `GET`-Endpunkte, einschließlich Auflisten von Limits, Abrufen nach ID und Lesen von [`/effective`](/docs/de/claude-apps-gateway-spend-limits#%2Feffective) und [`/audit`](/docs/de/claude-apps-gateway-spend-limits#%2Faudit). |

556| `admin_groups` | Nein | IdP-Gruppennamen. Ein Gateway-JWT, dessen `groups`-Anspruch einen dieser Namen enthält, hat vollständigen Admin-Zugriff, Lesen und Schreiben, und wird als `oidc:<sub>` geprüft. Verwenden Sie dies für menschliche Administratoren; verwenden Sie API-Schlüssel für Maschinen. Ein leerer Eintrag in dieser Liste stoppt das Gateway beim Start. Siehe [Matcher-Werte, die das Gateway beim Start stoppen](#matcher-values-that-stop-the-gateway-at-boot). |669| `admin_groups` | Nein | IdP-Gruppennamen. Ein Gateway-JWT, dessen `groups`-Anspruch einen dieser Namen enthält, hat vollständigen Admin-Zugriff, Lesen und Schreiben, und wird als `oidc:<sub>` geprüft. Verwenden Sie dies für menschliche Administratoren; verwenden Sie API-Schlüssel für Maschinen. Ein leerer Eintrag in dieser Liste stoppt das Gateway beim Start. Siehe [Matcher-Werte, die das Gateway beim Start stoppen](#matcher-values-that-stop-the-gateway-at-boot). |

557| `blocked_message` | Nein | Wird wörtlich an den `429 billing_error` angehängt, den ein blockierter Entwickler sieht. Schreiben Sie die vollständige Anweisung, z. B. eine URL oder einen Slack-Kanal. Wenn nicht gesetzt, sendet das Gateway nur die Standardmeldung. Siehe [Wie die Durchsetzung funktioniert](/docs/de/claude-apps-gateway-spend-limits#how-enforcement-works). |670| `blocked_message` | Nein | Wird wörtlich an den `429 billing_error` angehängt, den ein blockierter Entwickler sieht. Schreiben Sie die vollständige Anweisung, z. B. eine URL oder einen Slack-Channel. Wenn nicht gesetzt, sendet das Gateway nur die Standardmeldung. Siehe [Wie die Durchsetzung funktioniert](/docs/de/claude-apps-gateway-spend-limits#how-enforcement-works). |

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

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

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

562 675

563<h3 id="enforcement">676<h3 id="enforcement">

598 711

599Wie der Zähler eine Überschreibungszeile abgleicht:712Wie der Zähler eine Überschreibungszeile abgleicht:

600 713

601* Eine Zeile ersetzt den Listenpreis für Anfragen, die `upstream`, ein [`upstreams[].name`](#upstreams), für `model` bedient. Das schließt den höheren [Schnellmodus](/docs/de/fast-mode#understand-the-cost-tradeoff)-Satz ein, sodass Schnell- und Standardanfragen mit denselben vier Sätzen gezählt werden.714* Eine Zeile ersetzt den Listenpreis für Anfragen, die `upstream`, ein [`upstreams[].name`](#upstreams), für `model` bedient. Das schließt den höheren [Fast-Modus](/docs/de/fast-mode#understand-the-cost-tradeoff)-Satz ein, sodass Fast- und Standardanfragen mit denselben vier Sätzen gezählt werden.

602* Eine integrierte ID wie `claude-sonnet-4-6`, abgeglichen wie [`models[].id`](#models), deckt jede datierte Form, regionale Amazon-Bedrock-Form oder Google-Cloud-Agent-Plattformform ab, die der Zähler als dieses Modell bewertet. Jede andere Zeichenkette, z. B. ein Alias oder ein Inferenzprofil-ARN, gleicht die ID ab, die der Client gesendet hat, oder die Zeichenkette, die upstream gesendet wurde, Groß-/Kleinschreibung ignoriert.715* Eine integrierte ID wie `claude-sonnet-4-6`, abgeglichen wie [`models[].id`](#models), deckt jede datierte Form, regionale Amazon-Bedrock-Form oder Google-Cloud-Agent-Plattformform ab, die der Zähler als dieses Modell bewertet. Jede andere Zeichenkette, z. B. ein Alias oder ein Inferenzprofil-ARN, gleicht die ID ab, die der Client gesendet hat, oder die Zeichenkette, die upstream gesendet wurde, Groß-/Kleinschreibung ignoriert.

603* Wenn sich Zeilen überlappen, wählt der Zähler die spezifischste Zeile statt der ersten Zeile: eine Zeile, deren `model` die genaue Modellzeichenkette ist, die upstream gesendet wurde, dann eine Zeile, die die genaue ID abgleicht, die der Client gesendet hat, dann eine Zeile, die das integrierte Modell benennt.716* Wenn sich Zeilen überlappen, wählt der Zähler die spezifischste Zeile statt der ersten Zeile: eine Zeile, deren `model` die genaue Modellzeichenkette ist, die upstream gesendet wurde, dann eine Zeile, die die genaue ID abgleicht, die der Client gesendet hat, dann eine Zeile, die das integrierte Modell benennt.

604* Ein unbekannter Upstream-Name schlägt beim Start fehl, ebenso wie zwei Zeilen für einen Upstream, die dasselbe Modell benennen, einschließlich zwei Schreibweisen eines integrierten Modells. Das Gateway warnt beim Start vor einer Zeile, die kein anforderbares Modell verwenden kann.717* Ein unbekannter Upstream-Name schlägt beim Start fehl, ebenso wie zwei Zeilen für einen Upstream, die dasselbe Modell benennen, einschließlich zwei Schreibweisen eines integrierten Modells. Das Gateway warnt beim Start vor einer Zeile, die kein anforderbares Modell verwenden kann.

605* Web-Such-Anfragen bleiben beim \$0,01-Listenpreis; der Multiplikator wird immer noch auf sie angewendet.718* Web-Such-Anfragen bleiben beim \$0,01-Listenpreis; der Multiplikator wird immer noch auf sie angewendet.

606 719

607Für regionale Sätze geben Sie jeder Region seinen eigenen benannten Upstream und eine Zeile pro Upstream.720Für regionale Sätze geben Sie jeder Region ihren eigenen benannten Upstream und eine Zeile pro Upstream.

608 721

609<h4 id="mark-prices-up">722<h4 id="mark-prices-up">

610 Preise erhöhen723 Preise erhöhen

659 `managed`772 `managed`

660</h3>773</h3>

661 774

662Der `managed`-Block definiert rollenbasierte Zugriffrichtlinien, die nach IdP-Gruppen oder E-Mail-Domäne verschlüsselt sind. Richtlinien werden in Reihenfolge ausgewertet; die erste Übereinstimmung wird ausgewählt und dann mit der unten beschriebenen `match: {}`-Catch-All-Basis zusammengeführt. Sie werden pro Benutzer unter `GET /managed/settings` mit ETag/304-Caching bedient.775Der `managed`-Block definiert rollenbasierte Zugriffsrichtlinien, die nach IdP-Gruppen oder E-Mail-Domäne geschlüsselt sind. Richtlinien werden in Reihenfolge ausgewertet; die erste Übereinstimmung wird ausgewählt und dann mit der `match: {}`-Catch-All-Basis zusammengeführt. Sie werden pro Benutzer unter `GET /managed/settings` mit ETag/304-Caching bedient.

663 776

664```yaml theme={null}777```yaml theme={null}

665managed:778managed:

683 796

684`availableModels` wird auch serverseitig unter `/v1/messages` erzwungen, sodass ein abgelehntes Modell `400` zurückgibt, unabhängig davon, was der Client sendet.797`availableModels` wird auch serverseitig unter `/v1/messages` erzwungen, sodass ein abgelehntes Modell `400` zurückgibt, unabhängig davon, was der Client sendet.

685 798

686Das Gateway validiert den `model`-Wert selbst, bevor es eine Anfrage weitergeleitet, sodass ein fehlerhafter Wert niemals einen Upstream erreicht. Es lehnt die Anfrage in zwei Fällen mit `400` ab:799Das Gateway validiert den `model`-Wert selbst, bevor es eine Anfrage weiterleitet, sodass ein fehlerhafter Wert niemals einen Upstream erreicht. Es lehnt die Anfrage in zwei Fällen mit `400` ab:

687 800

688* Wenn der Wert fehlt oder leer ist, lehnt das Gateway die Anfrage mit der Meldung `model is required` ab. Diese Prüfung erfordert ein Gateway, das Claude Code v2.1.228 oder später ausführt.801* Wenn der Wert fehlt oder leer ist, lehnt das Gateway die Anfrage mit der Meldung `model is required` ab. Diese Prüfung erfordert ein Gateway, das Claude Code v2.1.228 oder später ausführt.

689* Wenn der Wert vorhanden ist, aber keine Zeichenkette ist, lehnt das Gateway die Anfrage mit der Meldung `model must be a string` ab. Erfordert ein Gateway, das Claude Code v2.1.221 oder später ausführt.802* Wenn der Wert vorhanden ist, aber keine Zeichenkette ist, lehnt das Gateway die Anfrage mit der Meldung `model must be a string` ab. Erfordert ein Gateway, das Claude Code v2.1.221 oder später ausführt.

698Ein authentifizierter Benutzer, der keine Richtlinie abgleicht, erhält die Standardwerte des Gateways, was bedeutet, jedes Modell im Katalog und keine verwalteten Einstellungen. Fügen Sie eine `match: {}`-Catch-All zuletzt hinzu, wenn Sie eine garantierte Standardrichtlinie möchten.811Ein authentifizierter Benutzer, der keine Richtlinie abgleicht, erhält die Standardwerte des Gateways, was bedeutet, jedes Modell im Katalog und keine verwalteten Einstellungen. Fügen Sie eine `match: {}`-Catch-All zuletzt hinzu, wenn Sie eine garantierte Standardrichtlinie möchten.

699 812

700<Note>813<Note>

701 Das Gateway führt kein eigenes Benutzerverzeichnis. Es autorisiert jede Anfrage vom IdP-Token des Benutzers, liest die Gruppenmitgliedschaft aus dem `groups`-Anspruch des Tokens und wertet Richtlinien dagegen aus. Es gibt kein Verzeichnis zum Aufzählen und keine Konten zum Vorab-Erstellen, und daher keinen SCIM-Endpunkt, da es nichts gibt, das SCIM synchronisieren könnte.814 Das Gateway führt kein eigenes Benutzerverzeichnis. Es autorisiert jede Anfrage anhand des IdP-Tokens des Benutzers, liest die Gruppenmitgliedschaft aus dem `groups`-Anspruch des Tokens und wertet Richtlinien dagegen aus. Es gibt kein Verzeichnis zum Aufzählen und keine Konten zum Vorab-Erstellen, und daher keinen SCIM-Endpunkt, da es nichts gibt, in das SCIM synchronisieren könnte.

702 815

703 Führen Sie Benutzer- und Gruppenzyklus-Management an der Quelle der Wahrheit durch, die das native SCIM-Provisioning Ihres IdP oder eine dedizierte Identitäts-Governance-Plattform ist. Mitgliedschaft und Deprovisioning, die dort gesteuert werden, fließen automatisch durch den Token in das Gateway. Wenn Sie SCIM-Provisioning von Claude-Konten selbst möchten, ist das eine [Claude for Enterprise](/docs/de/admin-setup)-Fähigkeit.816 Führen Sie das Lebenszyklus-Management von Benutzern und Gruppen an der Quelle der Wahrheit durch, die das native SCIM-Provisioning Ihres IdP oder eine dedizierte Identitäts-Governance-Plattform ist. Mitgliedschaft und Deprovisioning, die dort gesteuert werden, fließen automatisch über das Token in das Gateway. Wenn Sie SCIM-Provisioning von Claude-Konten selbst möchten, ist das eine [Claude for Enterprise](/docs/de/admin-setup)-Fähigkeit.

704 817

705 Zwei Ausbreitungsuhren gelten:818 Zwei Ausbreitungsuhren gelten:

706 819

707 * **Richtlinieninhalt**: Das Bearbeiten einer Richtlinie und das erneute Bereitstellen erreichen verbundene Clients bei ihrer nächsten verwalteten Einstellungsabfrage, innerhalb einer Stunde, abgesehen von den [Änderungen, die nur beim nächsten Start gelten](/docs/de/server-managed-settings#fetch-and-caching-behavior)820 * **Richtlinieninhalt**: Das Bearbeiten einer Richtlinie und das erneute Bereitstellen erreichen verbundene Clients bei ihrer nächsten Abfrage der verwalteten Einstellungen, innerhalb einer Stunde, abgesehen von den [Änderungen, die nur beim nächsten Start gelten](/docs/de/server-managed-settings#fetch-and-caching-behavior)

708 * **Gruppenmitgliedschaft**: Das Ändern der Gruppenmitgliedschaft eines Benutzers ändert, welche Richtlinie ihn abgleicht. Dies tritt beim nächsten Sitzungs-Neuausgabe in Kraft, was die nächste stille Aktualisierung bedeutet, begrenzt durch `session.ttl_hours`.821 * **Gruppenmitgliedschaft**: Das Ändern der Gruppenmitgliedschaft eines Benutzers ändert, welche Richtlinie ihn abgleicht. Dies tritt bei der nächsten Sitzungs-Neuausgabe in Kraft, also bei der nächsten stillen Aktualisierung, begrenzt durch `session.ttl_hours`.

709</Note>822</Note>

710 823

711<h4 id="matcher-values-that-stop-the-gateway-at-boot">824<h4 id="matcher-values-that-stop-the-gateway-at-boot">

721 834

722Vor v2.1.232 startete das Gateway mit diesen Werten. Jeder Wert hatte diese Auswirkung:835Vor v2.1.232 startete das Gateway mit diesen Werten. Jeder Wert hatte diese Auswirkung:

723 836

724* Eine leere `email_domain`: Das Gateway übersprung die Domänenprüfung, sodass eine Richtlinie mit einer leeren `email_domain` und keiner `groups`-Liste jeden authentifizierten Benutzer abglich837* Eine leere `email_domain`: Das Gateway übersprang die Domänenprüfung, sodass eine Richtlinie mit einer leeren `email_domain` und keiner `groups`-Liste jeden authentifizierten Benutzer abglich

725* Eine leere `groups`-Liste: Die Richtlinie gleichte niemanden ab838* Eine leere `groups`-Liste: Die Richtlinie glich niemanden ab

726* Eine `email_domain`, die `@`, Leerzeichen oder ein Komma enthält: Die Richtlinie gleichte niemanden ab839* Eine `email_domain`, die `@`, Leerzeichen oder ein Komma enthält: Die Richtlinie glich niemanden ab

727* Ein leerer Eintrag in `groups` oder in `admin_groups`: Der Eintrag gleichte einen Benutzer nur ab, wenn der `groups`-Anspruch des IdP dieses Benutzers auch einen leeren Eintrag enthielt. In `admin_groups` gewährte diese Übereinstimmung Admin-Zugriff. Wenn Ihre `admin_groups`-Liste niemals einen leeren Eintrag enthielt, erhielt niemand auf diese Weise Admin-Zugriff.840* Ein leerer Eintrag in `groups` oder in `admin_groups`: Der Eintrag glich einen Benutzer nur ab, wenn der `groups`-Anspruch des IdP dieses Benutzers auch einen leeren Eintrag enthielt. In `admin_groups` gewährte diese Übereinstimmung Admin-Zugriff. Wenn Ihre `admin_groups`-Liste niemals einen leeren Eintrag enthielt, erhielt niemand auf diese Weise Admin-Zugriff.

728 841

729<h4 id="what-goes-in-cli">842<h4 id="what-goes-in-cli">

730 Was in `cli` geht843 Was in `cli` geht

732 845

733Jeder `cli`-Wert ist ein vollständiges Claude-Code-`managed-settings.json`-Dokument, das gleiche Schema, das Sie über MDM oder `/etc/claude-code/managed-settings.json` bereitstellen würden, hier als YAML ausgedrückt. Die CLI wendet das bereitgestellte Dokument auf der verwalteten Ebene an, über Benutzer- und Projekteinstellungen, anstelle von serverseitig verwalteten Einstellungen. Sie ignoriert daher die Einstellungen, die [auf OS-Ebenen-Richtlinienquellen beschränkt sind](/docs/de/server-managed-settings#current-limitations), wie `policyHelper` und `wslInheritsWindowsSettings`.846Jeder `cli`-Wert ist ein vollständiges Claude-Code-`managed-settings.json`-Dokument, das gleiche Schema, das Sie über MDM oder `/etc/claude-code/managed-settings.json` bereitstellen würden, hier als YAML ausgedrückt. Die CLI wendet das bereitgestellte Dokument auf der verwalteten Ebene an, über Benutzer- und Projekteinstellungen, anstelle von serverseitig verwalteten Einstellungen. Sie ignoriert daher die Einstellungen, die [auf OS-Ebenen-Richtlinienquellen beschränkt sind](/docs/de/server-managed-settings#current-limitations), wie `policyHelper` und `wslInheritsWindowsSettings`.

734 847

735Das Gateway validiert jedes Dokument beim Start gegen das Einstellungsschema der CLI, sodass ein nicht erkannter Top-Level-Schlüssel beim Start mit einem Fehler fehlschlägt, der jeden fehlerhaften Schlüssel benennt. Absichtlich offene Teile des Schemas akzeptieren immer noch beliebige Werte, da neuere Clients Einträge erkennen können, die das Schema des Gateways nicht erkennt. Diese offenen Schlüssel umfassen `env`, `pluginConfigs` und Schlüssel, die unter `permissions` verschachtelt sind.848Das Gateway validiert jedes Dokument beim Start gegen das Einstellungsschema der CLI, sodass ein nicht erkannter Top-Level-Schlüssel beim Start mit einem Fehler fehlschlägt, der jeden betroffenen Schlüssel benennt. Absichtlich offene Teile des Schemas akzeptieren immer noch beliebige Werte, da neuere Clients Einträge erkennen können, die das Schema des Gateways nicht erkennt. Diese offenen Schlüssel umfassen `env`, `pluginConfigs` und Schlüssel, die unter `permissions` verschachtelt sind.

736 849

737Da die Validierung das Schema verwendet, das mit der installierten Version des Gateways gebündelt ist, erfordert das Einfügen eines Top-Level-Einstellungsschlüssels, der von einer neueren Claude-Code-Version eingeführt wurde, in die verwaltete Konfiguration, das Gateway zuerst zu aktualisieren. Testen Sie eine neue Richtlinie auf einem Client, bevor Sie sie ausrollen.850Da die Validierung das Schema verwendet, das mit der installierten Version des Gateways gebündelt ist, erfordert das Einfügen eines Top-Level-Einstellungsschlüssels, der von einer neueren Claude-Code-Version eingeführt wurde, in die verwaltete Konfiguration, das Gateway zuerst zu aktualisieren. Testen Sie eine neue Richtlinie auf einem Client, bevor Sie sie ausrollen.

738 851

739Die vollständige Schlüsselreferenz befindet sich in [Claude-Code-Einstellungen](/docs/de/settings-reference#all-settings). Die Schlüssel, die Operatoren zuerst erreichen:852Die vollständige Schlüsselreferenz befindet sich in [Claude-Code-Einstellungen](/docs/de/settings-reference#all-settings). Die Schlüssel, zu denen Operatoren zuerst greifen:

740 853

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

742managed:855managed:

774| - | - | - |887| - | - | - |

776| `permissions.allow` / `.deny` | CLI | Tool- und Befehlsregeln. Siehe [Berechtigungen](/docs/de/permissions). |889| `permissions.allow` / `.deny` | CLI | Tool- und Befehlsregeln. Siehe [Berechtigungen](/docs/de/permissions). |

777| `permissions.disableBypassPermissionsMode` | CLI | Setzen Sie auf `disable`, um [`bypassPermissions`](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode), den Modus, der Berechtigungsaufforderungen überspringt, und das Flag `--dangerously-skip-permissions` zu blockieren |890| `permissions.disableBypassPermissionsMode` | CLI | Setzen Sie auf `disable`, um [`bypassPermissions`](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode), den Modus, der Berechtigungsabfragen überspringt, und das Flag `--dangerously-skip-permissions` zu blockieren |

778| `allowManagedPermissionRulesOnly` | CLI | Wenn `true`, werden verwaltete Einstellungen zur einzigen Einstellungsquelle von Berechtigungsregeln. Der Eintrag [`allowManagedPermissionRulesOnly`](/docs/de/settings-reference#allowmanagedpermissionrulesonly) listet jede Quelle auf, die Claude Code dann ignoriert. |891| `allowManagedPermissionRulesOnly` | CLI | Wenn `true`, werden verwaltete Einstellungen zur einzigen Einstellungsquelle von Berechtigungsregeln. Der Eintrag [`allowManagedPermissionRulesOnly`](/docs/de/settings-reference#allowmanagedpermissionrulesonly) listet jede Quelle auf, die Claude Code dann ignoriert. |

779| `env` | CLI | Umgebungsvariablen, die in den CLI-Prozess zusammengeführt werden. Verwenden Sie für Telemetrie, Auto-Update und Modellnamen-Überschreibungen. |892| `env` | CLI | Umgebungsvariablen, die in den CLI-Prozess zusammengeführt werden. Verwenden Sie für Telemetrie, Auto-Update und Modellnamen-Überschreibungen. |

780| `hooks` | CLI | Organisationsweite [Hooks](/docs/de/hooks) |893| `hooks` | CLI | Organisationsweite [Hooks](/docs/de/hooks) |

794 907

795[Umgebungsvariablen und der Genehmigungsdialog](/docs/de/server-managed-settings#environment-variables-and-the-approval-dialog) hat die Details, einschließlich vier Datenschutz-Umschalter, deren bereitgestellter Wert entscheidet, ob sie Genehmigung benötigen. Vor v2.1.218 wendete Claude Code weniger Variablen an, ohne den Entwickler zu fragen, sodass mehr bereitgestellte Variablen den Dialog auslösten.908[Umgebungsvariablen und der Genehmigungsdialog](/docs/de/server-managed-settings#environment-variables-and-the-approval-dialog) hat die Details, einschließlich vier Datenschutz-Umschalter, deren bereitgestellter Wert entscheidet, ob sie Genehmigung benötigen. Vor v2.1.218 wendete Claude Code weniger Variablen an, ohne den Entwickler zu fragen, sodass mehr bereitgestellte Variablen den Dialog auslösten.

796 909

797Die [Telemetrie](#telemetry)-Konfiguration des Gateways drückt `OTEL_EXPORTER_OTLP_ENDPOINT`, sodass das Setzen von `telemetry.forward_to` den Dialog auf jedem interaktiven Client auslöst. Der Dialog schützt die Maschine des Entwicklers vor einem kompromittierten oder feindseligem Gateway, nicht die Organisation vor dem Entwickler.910Die [Telemetrie](#telemetry)-Konfiguration des Gateways pusht `OTEL_EXPORTER_OTLP_ENDPOINT`, sodass das Setzen von `telemetry.forward_to` den Dialog auf jedem interaktiven Client auslöst. Der Dialog schützt die Maschine des Entwicklers vor einem kompromittierten oder feindseligen Gateway, nicht die Organisation vor dem Entwickler.

798 911

799Ein nicht-interaktiver Lauf mit dem Flag `-p` kann den Dialog nicht anzeigen. Er wendet die gepushten Einstellungen nur für diesen Lauf an und speichert sie nicht als genehmigt, sodass die nächste interaktive Sitzung des Entwicklers immer noch den Dialog für sie anzeigt. Vor v2.1.207 speicherte ein nicht-interaktiver Lauf die Einstellungen als genehmigt und keine spätere interaktive Sitzung zeigte den Dialog dafür.912Ein [nicht-interaktiver Lauf](/docs/de/server-managed-settings#security-approval-dialogs), etwa `claude -p` oder eine Agent-SDK-Sitzung, kann den Dialog nicht anzeigen. Er wendet die gepushten Einstellungen nur für diesen Lauf an und speichert sie nicht als genehmigt, sodass die nächste interaktive Sitzung des Entwicklers den Dialog weiterhin anzeigt. Vor v2.1.207 speicherte ein nicht-interaktiver Lauf die Einstellungen als genehmigt und keine spätere interaktive Sitzung zeigte den Dialog dafür.

800 913

801Wenn ein Entwickler ablehnt, beendet Claude Code diese Sitzung, anstatt die Richtlinie anzuwenden. Wenn Sie einen neuen Hook oder eine beliebige Env-Variable, die den Dialog auslöst, an eine breite Richtlinie pushen, zeigt Claude Code daher den Dialog jedem abgleichenden Entwickler. Es zeigt den Dialog in einer laufenden Sitzung bei der nächsten stündlichen Abfrage und ansonsten beim nächsten Start des Entwicklers.914Wenn ein Entwickler ablehnt, beendet Claude Code diese Sitzung, anstatt die Richtlinie anzuwenden. Wenn Sie einen neuen Hook oder eine beliebige Env-Variable, die den Dialog auslöst, an eine breite Richtlinie pushen, sieht daher jeder abgleichende Entwickler den Dialog in seinen interaktiven Sitzungen. Eine laufende interaktive Sitzung zeigt ihn bei der nächsten stündlichen Abfrage an, andernfalls erscheint er beim nächsten interaktiven Start des Entwicklers.

802 915

803Der `cli`-Schlüssel hieß in früheren Versionen `settings`. Diese Schreibweise wird immer noch als Alias akzeptiert, aber neue Bereitstellungen sollten `cli` verwenden.916Der `cli`-Schlüssel hieß in früheren Versionen `settings`. Diese Schreibweise wird immer noch als Alias akzeptiert, aber neue Bereitstellungen sollten `cli` verwenden.

804 917

824 Erfordert Claude Code v2.1.203 oder später auf dem Gateway-Server und ein explizites Opt-In: `/user/bootstrap` gibt 404 zurück, es sei denn, die Richtlinie, die den Benutzer abgleicht, trägt einen `desktop`-Schlüssel. Ein leerer `desktop: {}` meldet eine Richtlinie an, und ein `desktop`-Schlüssel auf der `match: {}`-Basisschicht meldet jede Richtlinie an, die ihn erbt. Das Audit-Log zeichnet jede Anfrage als `desktop_bootstrap.serve` oder `desktop_bootstrap.denied` auf.937 Erfordert Claude Code v2.1.203 oder später auf dem Gateway-Server und ein explizites Opt-In: `/user/bootstrap` gibt 404 zurück, es sei denn, die Richtlinie, die den Benutzer abgleicht, trägt einen `desktop`-Schlüssel. Ein leerer `desktop: {}` meldet eine Richtlinie an, und ein `desktop`-Schlüssel auf der `match: {}`-Basisschicht meldet jede Richtlinie an, die ihn erbt. Das Audit-Log zeichnet jede Anfrage als `desktop_bootstrap.serve` oder `desktop_bootstrap.denied` auf.

825</Note>938</Note>

826 939

827Das Gateway leitet einen Großteil der Antwort von der abgleichenden Richtlinie des `cli`-Blocks und von der Top-Level-Gateway-Konfiguration ab:940Das Gateway leitet einen Großteil der Antwort vom `cli`-Block der abgeglichenen Richtlinie und von der Top-Level-Gateway-Konfiguration ab:

828 941

829* Die Modellliste aus `availableModels`942* Die Modellliste aus `availableModels`

830* Deaktivierte Tools aus Bare-Tool-Namen-`permissions.deny`-Einträgen. Wenn Sie `disabledBuiltinTools` im `desktop`-Block der Richtlinie setzen, bedient das Gateway die Vereinigung Ihres Wertes und der abgeleiteten Liste, sodass Sie auf diese Weise mehr Tools deaktivieren können, aber eines, das Sie durch `permissions.deny` deaktiviert haben, nicht erneut aktivieren können943* Deaktivierte Tools aus `permissions.deny`-Einträgen mit bloßen Tool-Namen. Wenn Sie `disabledBuiltinTools` im `desktop`-Block der Richtlinie setzen, bedient das Gateway die Vereinigung Ihres Wertes und der abgeleiteten Liste, sodass Sie auf diese Weise mehr Tools deaktivieren können, aber eines, das Sie durch `permissions.deny` deaktiviert haben, nicht erneut aktivieren können

831* Die Egress-Zulassungsliste aus `sandbox.network.allowedDomains`. Wenn Sie `coworkEgressAllowedHosts` im `desktop`-Block der Richtlinie setzen, verwendet das Gateway diesen Wert statt der abgeleiteten Liste944* Die Egress-Zulassungsliste aus `sandbox.network.allowedDomains`. Wenn Sie `coworkEgressAllowedHosts` im `desktop`-Block der Richtlinie setzen, verwendet das Gateway diesen Wert statt der abgeleiteten Liste

832* Ein OTLP-Endpunkt, der auf das Gateway selbst zeigt, und die Identitätsattribute des angemeldeten Benutzers. Das Gateway leitet die Exporte, die es an diesem Endpunkt erhält, an Ihre `forward_to`-Ziele weiter. Es enthält den Endpunkt und die Attribute, wenn Sie sowohl [`telemetry.forward_to`](#telemetry) als auch `listen.public_url` setzen.945* Ein OTLP-Endpunkt, der auf das Gateway selbst zeigt, und die Identitätsattribute des angemeldeten Benutzers. Das Gateway leitet die Exporte, die es an diesem Endpunkt erhält, an Ihre `forward_to`-Ziele weiter. Es enthält den Endpunkt und die Attribute, wenn Sie sowohl [`telemetry.forward_to`](#telemetry) als auch `listen.public_url` setzen.

833 946

834 Claude Desktop exportiert jedes Signal mit einer Kodierung: `http/protobuf` oder `http/json`, wenn Sie `OTEL_EXPORTER_OTLP_PROTOCOL` oder eine seiner Pro-Signal-Varianten auf `http/json` im `env` der Richtlinie setzen. Vor Claude Code v2.1.261 auf dem Gateway-Server setzte die Antwort `http/json` unabhängig, sodass ein Collector, der nur Protobuf akzeptiert, Claude Desktops Exporte ablehnte947 Claude Desktop exportiert jedes Signal mit einer Kodierung: `http/protobuf` oder `http/json`, wenn Sie `OTEL_EXPORTER_OTLP_PROTOCOL` oder eine seiner Pro-Signal-Varianten auf `http/json` im `env` der Richtlinie setzen. Vor Claude Code v2.1.261 auf dem Gateway-Server setzte die Antwort `http/json` unabhängig davon, sodass ein Collector, der nur Protobuf akzeptiert, Claude Desktops Exporte ablehnte

835 948

836Um `disabledBuiltinTools`, `coworkEgressAllowedHosts` oder Claude Desktops eigene `managedMcpServers`-Einstellung im `desktop`-Block einer Richtlinie zu setzen, benötigen Sie Claude Code v2.1.232 oder später auf dem Gateway-Server. Claude Desktops `managedMcpServers` nimmt einen Array-Wert statt eines Objekts.949Um `disabledBuiltinTools`, `coworkEgressAllowedHosts` oder Claude Desktops eigene `managedMcpServers`-Einstellung im `desktop`-Block einer Richtlinie zu setzen, benötigen Sie Claude Code v2.1.232 oder später auf dem Gateway-Server. Claude Desktops `managedMcpServers` nimmt einen Array-Wert statt eines Objekts.

837 950

838Das Gateway lässt Schlüssel ohne Claude-Desktop-Äquivalent weg, wie `hooks` und scoped-Berechtigungsregeln wie `Bash(npm *)`, aus der Bootstrap-Antwort.951Das Gateway lässt Schlüssel ohne Claude-Desktop-Äquivalent, wie `hooks` und bereichsbezogene Berechtigungsregeln wie `Bash(npm *)`, aus der Bootstrap-Antwort weg.

839 952

840Fügen Sie den optionalen `desktop`-Block neben `cli` hinzu, um Claude-Desktop-Einstellungen direkt zu setzen. Schreiben Sie Einstellungen aus Claude Desktops [verwalteter Konfigurationsreferenz](https://claude.com/docs/third-party/claude-desktop/configuration) als flache Schlüsselnamen. Lassen Sie Schlüssel weg, die Claude Desktop nur aus MDM oder lokalen Dateien liest, wie `bootstrapUrl`; das Gateway lehnt sie beim Start ab. Vor v2.1.232 akzeptierte das Gateway eine feste Liste von 11 Feature-Gate-Schlüsseln, wie `chatTabEnabled` und `disableAutoUpdates`, und lehnte jeden anderen Schlüssel beim Start ab. Vor v2.1.227 lehnte das Gateway auch `chatTabEnabled` und `chatAdvancedFileAnalysisEnabled` beim Start ab.953Fügen Sie den optionalen `desktop`-Block neben `cli` hinzu, um Claude-Desktop-Einstellungen direkt zu setzen. Schreiben Sie Einstellungen aus Claude Desktops [verwalteter Konfigurationsreferenz](https://claude.com/docs/third-party/claude-desktop/configuration) als flache Schlüsselnamen. Lassen Sie Schlüssel weg, die Claude Desktop nur aus MDM oder lokalen Dateien liest, wie `bootstrapUrl`; das Gateway lehnt sie beim Start ab. Vor v2.1.232 akzeptierte das Gateway eine feste Liste von 11 Feature-Gate-Schlüsseln, wie `chatTabEnabled` und `disableAutoUpdates`, und lehnte jeden anderen Schlüssel beim Start ab. Vor v2.1.227 lehnte das Gateway auch `chatTabEnabled` und `chatAdvancedFileAnalysisEnabled` beim Start ab.

841 954

853 966

854Jeder Schlüssel ist optional; Claude Desktop wendet seinen eigenen Standard für jeden Schlüssel an, den Sie weglassen. Das Gateway validiert jeden `desktop`-Block beim Start gegen das Konfigurationsschema, das Claude Desktop selbst verwendet, sodass ein Fehler beim Gateway-Start als Fehler auftaucht, der den Schlüssel benennt, statt jeden verbundenen Desktop zu erreichen. Das Gateway schlägt beim Start fehl, wenn ein Block Folgendes enthält:967Jeder Schlüssel ist optional; Claude Desktop wendet seinen eigenen Standard für jeden Schlüssel an, den Sie weglassen. Das Gateway validiert jeden `desktop`-Block beim Start gegen das Konfigurationsschema, das Claude Desktop selbst verwendet, sodass ein Fehler beim Gateway-Start als Fehler auftaucht, der den Schlüssel benennt, statt jeden verbundenen Desktop zu erreichen. Das Gateway schlägt beim Start fehl, wenn ein Block Folgendes enthält:

855 968

856* Ein unbekannter Schlüssel969* Einen unbekannten Schlüssel

857* Ein erkannter Schlüssel, dessen Wert Claude Desktop ablehnen oder stillschweigend löschen würde, wie ein leerer Wert oder ein falsch geschriebener Unterschlüssel in einem verschachtelten Eintrag. Vor v2.1.260 ließ das Gateway ein falsch geschriebenes Feld in einem verschachtelten Objekt eines `managedMcpServers`- oder `orgPluginSettings`-Eintrags stillschweigend fallen, anstatt beim Start fehlzuschlagen.970* Einen erkannten Schlüssel, dessen Wert Claude Desktop ablehnen oder stillschweigend verwerfen würde, wie einen leeren Wert oder einen falsch geschriebenen Unterschlüssel in einem verschachtelten Eintrag. Vor v2.1.260 ließ das Gateway ein falsch geschriebenes Feld in einem verschachtelten Objekt eines `managedMcpServers`- oder `orgPluginSettings`-Eintrags stillschweigend fallen, anstatt beim Start fehlzuschlagen.

858* Ein Schlüssel, den das Gateway selbst berechnet: die Inferenzverbindung, die Modellliste und das OTLP-Relay. Konfigurieren Sie diese durch [`upstreams`](#upstreams), [`models`](#models) und den [`telemetry`](#telemetry)-Abschnitt `forward_to`.971* Einen Schlüssel, den das Gateway selbst berechnet: die Inferenzverbindung, die Modellliste und das OTLP-Relay. Konfigurieren Sie diese durch [`upstreams`](#upstreams), [`models`](#models) und `forward_to` im Abschnitt [`telemetry`](#telemetry).

859* Ein Legacy-Alias eines aktuellen Schlüssels. Im Boot-Fehler benennt das Gateway den kanonischen Schlüssel zum Schreiben.972* Einen Legacy-Alias eines aktuellen Schlüssels. Im Boot-Fehler benennt das Gateway den kanonischen Schlüssel, den Sie schreiben sollten.

860 973

861Wenn Sie einen veralteten Wert oder eine Eintragform verwenden, wie einen `managedMcpServers`-Eintrag ohne `transport`, startet das Gateway und protokolliert eine Warnung, die den Ersatz benennt.974Wenn Sie einen veralteten Wert oder eine veraltete Eintragsform verwenden, wie einen `managedMcpServers`-Eintrag ohne `transport`, startet das Gateway und protokolliert eine Warnung, die den Ersatz benennt.

862 975

863Das Gateway validiert einen `desktop`-Block gegen das Schema, das mit seiner installierten Version gebündelt ist, wie es den `cli`-Block tut. Um eine Einstellung bereitzustellen, die von einer neueren Claude-Desktop-Version eingeführt wurde, aktualisieren Sie das Gateway zuerst. Zum Beispiel benötigen `userPluginMarketplacesEnabled` und `userPluginUploadsEnabled` Claude Code v2.1.260 oder später auf dem Gateway-Server und Claude Desktop 1.37937.0 oder später auf den Maschinen der Mitglieder.976Das Gateway validiert einen `desktop`-Block gegen das Schema, das mit seiner installierten Version gebündelt ist, wie es den `cli`-Block tut. Um eine Einstellung bereitzustellen, die von einer neueren Claude-Desktop-Version eingeführt wurde, aktualisieren Sie das Gateway zuerst. Zum Beispiel benötigen `userPluginMarketplacesEnabled` und `userPluginUploadsEnabled` Claude Code v2.1.260 oder später auf dem Gateway-Server und Claude Desktop 1.37937.0 oder später auf den Maschinen der Mitglieder.

864 977

978`blockReadsOutsideWorkingDirectories`, `disableBypassPermissionsMode`, `configRecheckIntervalMinutes` und `sshClientPath` benötigen Claude Code v2.1.281 oder später auf dem Gateway-Server. Dasselbe gilt für den Wert `required` von `microsoftAuthBroker` und das Feld `continuousAccessEvaluation` eines Microsoft-365-`managedMcpServers`-Eintrags. Claude-Desktop-Versionen, die älter als der Wert `required` sind, lesen ihn als `disabled`, setzen Sie `required` daher erst, wenn das Claude Desktop jedes Mitglieds ihn unterstützt. Claude Desktops [verwaltete Konfigurationsreferenz](https://claude.com/docs/third-party/claude-desktop/configuration) listet die Version auf, die jeden Schlüssel zuerst liest.

979

865Wenn Sie `orgPluginSettings` im `desktop`-Block einer Richtlinie setzen, bedient das Gateway es in der Array-Form, die Claude Desktop 1.15200.0 und später liest. Ältere Desktops ignorieren das Array und erzwingen keine Plugin-Tool-Richtlinie, daher aktualisieren Sie Mitglieder auf 1.15200.0 oder später, bevor Sie sich darauf verlassen.980Wenn Sie `orgPluginSettings` im `desktop`-Block einer Richtlinie setzen, bedient das Gateway es in der Array-Form, die Claude Desktop 1.15200.0 und später liest. Ältere Desktops ignorieren das Array und erzwingen keine Plugin-Tool-Richtlinie, daher aktualisieren Sie Mitglieder auf 1.15200.0 oder später, bevor Sie sich darauf verlassen.

866 981

867Das Gateway füllt Schlüssel, die der `desktop`-Block einer Richtlinie nicht setzt, aus dem `match: {}`-Catch-All-`desktop`-Block, auf die gleiche Weise, wie es den `cli`-Block einer Richtlinie ausfüllt. Wenn Sie `disabledBuiltinTools` oder `builtinToolPolicy` sowohl in der Basis als auch in einer Rollen-Richtlinie setzen, behält das Gateway die Einschränkung der Basis:982Das Gateway füllt Schlüssel, die der `desktop`-Block einer Richtlinie nicht setzt, aus dem `desktop`-Block der `match: {}`-Catch-All, auf die gleiche Weise, wie es den `cli`-Block einer Richtlinie aus der Basis ausfüllt. Wenn Sie `disabledBuiltinTools` oder `builtinToolPolicy` sowohl in der Basis als auch in einer Rollen-Richtlinie setzen, behält das Gateway die Einschränkung der Basis:

868 983

869* `disabledBuiltinTools`: Das Gateway verwendet die Vereinigung der Liste der Basis und der Richtlinie984* `disabledBuiltinTools`: Das Gateway verwendet die Vereinigung der Liste der Basis und der Liste der Richtlinie

870* `builtinToolPolicy`: Wenn Sie ein Tool in der Basis auf einen anderen Wert als `allow` setzen, behält das Gateway diesen Wert, auch wenn Sie `allow` für das gleiche Tool in einer Rollen-Richtlinie setzen985* `builtinToolPolicy`: Wenn Sie ein Tool in der Basis auf einen anderen Wert als `allow` setzen, behält das Gateway diesen Wert, auch wenn Sie `allow` für das gleiche Tool in einer Rollen-Richtlinie setzen

871 986

872Für jeden anderen Schlüssel, wenn Sie ihn in der Rollen-Richtlinie setzen, verwendet das Gateway den Wert der Rollen-Richtlinie. Das Gateway ersetzt ein Array oder ein verschachteltes Objekt wie `banner` ganz, sodass wenn Sie `banner.text` in einer Rollen-Richtlinie setzen, das Gateway die `banner.backgroundColor` der Basis löscht.987Für jeden anderen Schlüssel, wenn Sie ihn in der Rollen-Richtlinie setzen, verwendet das Gateway den Wert der Rollen-Richtlinie. Das Gateway ersetzt ein Array oder ein verschachteltes Objekt wie `banner` ganz, sodass wenn Sie `banner.text` in einer Rollen-Richtlinie setzen, das Gateway die `banner.backgroundColor` der Basis verwirft.

873 988

874Wenn Sie Claude Desktop nicht bereitstellen, lassen Sie `desktop` vollständig aus Ihren Richtlinien weg; das Gateway gibt dann 404 von `/user/bootstrap` für jeden Benutzer zurück.989Wenn Sie Claude Desktop nicht bereitstellen, lassen Sie `desktop` vollständig aus Ihren Richtlinien weg; das Gateway gibt dann 404 von `/user/bootstrap` für jeden Benutzer zurück.

875 990

877 Vorrang mit anderen verwalteten Quellen992 Vorrang mit anderen verwalteten Quellen

878</h4>993</h4>

879 994

880Wenn ein Gerät auch eine MDM-bereitgestellte Richtlinie oder eine lokale `managed-settings.json` hat, rangieren Gateway-bereitgestellte Einstellungen zuerst. [Vorrang innerhalb der verwalteten Ebene](/docs/de/managed-settings#precedence-within-the-managed-tier) auf der Seite der verwalteten Einstellungen sagt, wann die lokalen Quellen gelten, und hat die [Schlüssel, die Claude Code aus jeder Admin-Quelle liest](/docs/de/managed-settings#keys-read-from-every-admin-source) unabhängig davon, welche Quelle es ausgewählt hat, wie die Sandbox-Lock-Schlüssel, `forceRemoteSettingsRefresh` und die Pro-Variable `env`-Zusammenführung. Ein [`policyHelper`](/docs/de/settings-reference#policyhelper), der in einem MDM-Profil oder der Datei der verwalteten Einstellungen konfiguriert ist, wird nur ausgeführt, wenn das Gateway keine Einstellungen bereitstellt; der Eintrag sagt, was seine Ausgabe ersetzt.995Wenn ein Gerät auch eine MDM-bereitgestellte Richtlinie oder eine lokale `managed-settings.json` hat, haben Gateway-bereitgestellte Einstellungen Vorrang. [Vorrang innerhalb der verwalteten Ebene](/docs/de/managed-settings#precedence-within-the-managed-tier) auf der Seite der verwalteten Einstellungen sagt, wann die lokalen Quellen gelten, und hat die [Schlüssel, die Claude Code aus jeder Admin-Quelle liest](/docs/de/managed-settings#keys-read-from-every-admin-source) unabhängig davon, welche Quelle es ausgewählt hat, wie die Sandbox-Lock-Schlüssel, `forceRemoteSettingsRefresh` und die `env`-Zusammenführung pro Variable. Ein [`policyHelper`](/docs/de/settings-reference#policyhelper), der in einem MDM-Profil oder der Datei der verwalteten Einstellungen konfiguriert ist, wird nur ausgeführt, wenn das Gateway keine Einstellungen bereitstellt; der Eintrag sagt, was seine Ausgabe ersetzt.

881 996

882Einbettungs-Hosts wie [Claude Desktop](/docs/de/desktop) können Richtlinien durch die SDK-Option `managedSettings` bereitstellen. [Übergeordnete Einstellungen von Einbettungs-Hosts](/docs/de/managed-settings#parent-settings-from-embedding-hosts) sagt, wann Claude Code sie anwendet, und [Übergeordnete Einstellungen einschränken](/docs/de/claude-apps-gateway#restrict-parent-settings) listet auf, welche Zulassungs-Richtungs-Einstellungen immer noch ohne die `allowManaged*Only`-Sperren gelten.997Einbettungs-Hosts wie [Claude Desktop](/docs/de/desktop) können Richtlinien durch die SDK-Option `managedSettings` bereitstellen. [Übergeordnete Einstellungen von Einbettungs-Hosts](/docs/de/managed-settings#parent-settings-from-embedding-hosts) sagt, wann Claude Code sie anwendet, und [Übergeordnete Einstellungen einschränken](/docs/de/claude-apps-gateway#restrict-parent-settings) listet auf, welche Zulassungs-Richtungs-Einstellungen immer noch ohne die `allowManaged*Only`-Sperren gelten.

883 998

887 `telemetry`1002 `telemetry`

888</h3>1003</h3>

889 1004

890Die CLI sendet Metriken, Protokolle und, wenn aktiviert, Traces an das Gateway, das sie wörtlich an jedes konfigurierte Ziel weitergeleitet. Die Exporte verwenden OpenTelemetry Protocol (OTLP) über HTTP. Um das Relay zu überspringen und Sitzungen direkt an Ihren Collector exportieren zu lassen, [benennen Sie den Collector in einer Richtlinie](#export-directly-to-your-collector). Siehe [Überwachung der Nutzung](/docs/de/monitoring-usage) für die Metriken und Ereignisse, die die CLI ausgibt.1005Die CLI sendet Metriken, Logs und, wenn aktiviert, Traces an das Gateway, das sie wörtlich an jedes konfigurierte Ziel weiterleitet. Die Exporte verwenden OpenTelemetry Protocol (OTLP) über HTTP. Um das Relay zu überspringen und Sitzungen direkt an Ihren Collector exportieren zu lassen, [benennen Sie den Collector in einer Richtlinie](#export-directly-to-your-collector). Siehe [Überwachung der Nutzung](/docs/de/monitoring-usage) für die Metriken und Ereignisse, die die CLI ausgibt.

891 1006

892Die CLI stempelt jeden Export mit der Identität des authentifizierten Benutzers, gelesen aus dem vom Gateway ausgegebenen JWT: die Attribute `user.id`, `user.email` und `user.groups`. Die Kostenattribution pro Entwickler und Nutzungsattribution funktioniert daher ohne Konfiguration auf der Entwicklerseite.1007In Sitzungen, die über `/login` angemeldet sind, stempelt die CLI jeden Export mit der Identität des authentifizierten Benutzers, gelesen aus dem vom Gateway ausgegebenen JWT: die Attribute `user.id`, `user.email` und `user.groups`. Die Kosten- und Nutzungsattribution pro Entwickler funktioniert daher ohne Konfiguration auf der Entwicklerseite.

893 1008

894[Claude Desktop](#claude-desktop-overlay) und Cowork-Sitzungen, die sich durch das Gateway anmelden, stempeln ihre Telemetrie mit `user.email` und `user.groups` neben `enduser.id`, sodass Sie Terminal-, Desktop- und Cowork-Nutzung mit einer Abfrage auf `user.email` oder `user.groups` abdecken können. `user.groups` ist die kommagetrennte IdP-Gruppenliste.1009[Claude Desktop](#claude-desktop-overlay) und Cowork-Sitzungen, die sich durch das Gateway anmelden, stempeln ihre Telemetrie mit `user.email` und `user.groups` neben `enduser.id`, sodass Sie Terminal-, Desktop- und Cowork-Nutzung mit einer Abfrage auf `user.email` oder `user.groups` abdecken können. `user.groups` ist die kommagetrennte IdP-Gruppenliste.

895 1010

896Desktop und Cowork-Telemetrie tragen auch `enduser.sub`, den `sub`-Anspruch, den Ihr Identitätsanbieter für den Benutzer ausstellt, der gleich bleibt, wenn sich die E-Mail eines Benutzers ändert. Terminal-Sitzungen stempeln den gleichen Wert unter `user.id`, sodass eine Abfrage, die `enduser.sub` gegen Terminal-`user.id` abgleicht, die Terminal-, Desktop- und Cowork-Nutzung eines Benutzers zusammen abdeckt. Bei Desktop- und Cowork-Exporten ist `user.id` ein anonymer Bezeichner, nicht der Betreff.1011Desktop- und Cowork-Telemetrie tragen auch `enduser.sub`, den `sub`-Anspruch, den Ihr Identitätsanbieter für den Benutzer ausstellt, der gleich bleibt, wenn sich die E-Mail eines Benutzers ändert. Terminal-Sitzungen stempeln den gleichen Wert unter `user.id`, sodass eine Abfrage, die `enduser.sub` gegen Terminal-`user.id` abgleicht, die Terminal-, Desktop- und Cowork-Nutzung eines Benutzers zusammen abdeckt. Bei Desktop- und Cowork-Exporten ist `user.id` ein anonymer Bezeichner, nicht das Subjekt.

897 1012

898Wie alle OpenTelemetry-Daten von Claude Code gehen diese Attribute nur an Ziele, die Ihre Organisation konfiguriert, niemals an Anthropic.1013Wie alle OpenTelemetry-Daten von Claude Code gehen diese Attribute nur an Ziele, die Ihre Organisation konfiguriert, niemals an Anthropic.

899 1014

900Wenn die Gruppenliste eines Benutzers länger als 255 Zeichen ist, sobald sie prozentual kodiert ist, oder ein Gruppenname ein Komma oder Gleichheitszeichen enthält, lässt das Gateway `user.groups` aus der Desktop- und Cowork-Telemetrie dieses Benutzers weg, anstatt es zu kürzen. Die Terminal-Sitzungen dieses Benutzers tragen immer noch die vollständige Liste.1015Wenn die Gruppenliste eines Benutzers länger als 255 Zeichen ist, sobald sie prozentual kodiert ist, oder ein Gruppenname ein Komma oder Gleichheitszeichen enthält, lässt das Gateway `user.groups` aus der Desktop- und Cowork-Telemetrie dieses Benutzers weg, anstatt es zu kürzen. Die Terminal-Sitzungen dieses Benutzers tragen immer noch die vollständige Liste.

901 1016

902Das Gateway lässt `enduser.sub` weg, wenn der Betreff länger als 255 Zeichen ist, sobald er prozentual kodiert ist, oder ein Leerzeichen, ein Zeichen außerhalb des druckbaren ASCII oder eines von `,` `;` `=` `\` `"` `%` enthält. Die Desktop- und Cowork-Telemetrie dieses Benutzers behält seine anderen Attribute.1017Das Gateway lässt `enduser.sub` weg, wenn das Subjekt länger als 255 Zeichen ist, sobald es prozentual kodiert ist, oder ein Leerzeichen, ein Zeichen außerhalb des druckbaren ASCII oder eines von `,` `;` `=` `\` `"` `%` enthält. Die Desktop- und Cowork-Telemetrie dieses Benutzers behält ihre anderen Attribute.

903 1018

904Sie benötigen Claude Code v2.1.265 oder später auf dem Gateway-Server für `user.email` und `user.groups` auf Desktop- und Cowork-Telemetrie, und Claude Desktop 1.24012 oder später auf der Maschine jedes Entwicklers für `user.groups`.1019Sie benötigen Claude Code v2.1.265 oder später auf dem Gateway-Server für `user.email` und `user.groups` auf Desktop- und Cowork-Telemetrie, und Claude Desktop 1.24012 oder später auf der Maschine jedes Entwicklers für `user.groups`.

905 1020

924 Jedes Ziel meldet sich unabhängig für `metrics`, `logs` und `traces` an, und der Standard ist nur Metriken. Die Signale unterscheiden sich in der Empfindlichkeit:1039 Jedes Ziel meldet sich unabhängig für `metrics`, `logs` und `traces` an, und der Standard ist nur Metriken. Die Signale unterscheiden sich in der Empfindlichkeit:

925 1040

926 * **Metriken**: Aggregatzähler wie Token-Zählungen, Anfragezählungen und Latenz1041 * **Metriken**: Aggregatzähler wie Token-Zählungen, Anfragezählungen und Latenz

927 * **Protokolle und Traces**: können vollständige Bash-Befehle, Tool-Eingaben und Dateipfade tragen, die alles abdecken, was Claude Code auf der Maschine eines Entwicklers tut1042 * **Logs und Traces**: können vollständige Bash-Befehle, Tool-Eingaben und Dateipfade tragen, die alles abdecken, was Claude Code auf der Maschine eines Entwicklers tut

928 1043

929 Aktivieren Sie Protokolle und Traces nur auf Zielen mit den Zugriffskontrolle und Aufbewahrungsrichtlinie, die diese Daten rechtfertigen.1044 Aktivieren Sie Logs und Traces nur auf Zielen mit den Zugriffskontrollen und der Aufbewahrungsrichtlinie, die diese Daten erfordern.

930</Warning>1045</Warning>

931 1046

932Jede `forward_to`-URL muss `https://` verwenden, mit einer Ausnahme für einen Collector auf der Loopback-Schnittstelle des Gateways selbst:1047Jede `forward_to`-URL muss `https://` verwenden, mit einer Ausnahme für einen Collector auf der Loopback-Schnittstelle des Gateways selbst:

940 1055

941Um einen internen Collector direkt zu erreichen, fügen Sie ihn zu `NO_PROXY` nach Hostname oder nach einer Domäne mit einem führenden Punkt wie `.internal.example.com` hinzu, was Claude Code v2.1.277 oder später auf dem Gateway-Server erfordert. Stellen Sie sicher, dass das Gateway den Collector ohne den Proxy erreichen kann. Ein Eintrag ohne einen führenden Punkt gleicht nur diesen genauen Namen ab, nicht Namen darunter. CIDR-Bereiche gleichen nicht ab.1056Um einen internen Collector direkt zu erreichen, fügen Sie ihn zu `NO_PROXY` nach Hostname oder nach einer Domäne mit einem führenden Punkt wie `.internal.example.com` hinzu, was Claude Code v2.1.277 oder später auf dem Gateway-Server erfordert. Stellen Sie sicher, dass das Gateway den Collector ohne den Proxy erreichen kann. Ein Eintrag ohne einen führenden Punkt gleicht nur diesen genauen Namen ab, nicht Namen darunter. CIDR-Bereiche gleichen nicht ab.

942 1057

943Mit [Proxy-Only-Egress](#proxy-only-egress) aktiviert, erlauben Sie den Collector stattdessen im Proxy, da jeder `NO_PROXY`-Eintrag Proxy-Only-Egress ausschaltet.1058Mit aktiviertem [Proxy-Only-Egress](#proxy-only-egress) erlauben Sie den Collector stattdessen im Proxy, da jeder `NO_PROXY`-Eintrag Proxy-Only-Egress ausschaltet.

944 1059

945Telemetrie ist in der CLI standardmäßig deaktiviert. Wenn Sie sowohl `telemetry.forward_to` als auch `listen.public_url` setzen, schaltet das Gateway sie für verbundene Clients ein, indem es sechs Umgebungsvariablen durch `/managed/settings` drückt:1060Telemetrie ist in der CLI standardmäßig deaktiviert. Wenn Sie sowohl `telemetry.forward_to` als auch `listen.public_url` setzen, schaltet das Gateway sie für verbundene Clients ein, indem es sechs Umgebungsvariablen durch `/managed/settings` pusht:

946 1061

947* `CLAUDE_CODE_ENABLE_TELEMETRY=1`1062* `CLAUDE_CODE_ENABLE_TELEMETRY=1`

948* `OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER` und `OTEL_TRACES_EXPORTER`, jeweils auf `otlp` gesetzt, wenn mindestens ein `forward_to`-Ziel dieses Signal aktiviert, und auf `none` andernfalls1063* `OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER` und `OTEL_TRACES_EXPORTER`, jeweils auf `otlp` gesetzt, wenn mindestens ein `forward_to`-Ziel dieses Signal aktiviert, und andernfalls auf `none`

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

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

951 1066

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

953 1068

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

955 1070

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

957 1072

958Entwickler, die sich durch `/login` anmelden, können Exporte nicht mit ihrer eigenen OTEL-Konfiguration umleiten:1073Entwickler, die sich durch `/login` anmelden, können Exporte nicht mit ihrer eigenen OTEL-Konfiguration umleiten:

959 1074

960* **Lokal gesetzte Variablen**: Claude Code wendet die gepushten Variablen auf der verwalteten Ebene an, sodass jede den Wert überschreibt, den ein Entwickler lokal dafür setzt.1075* **Lokal gesetzte Variablen**: Claude Code wendet die gepushten Variablen auf der verwalteten Ebene an, sodass jede den Wert überschreibt, den ein Entwickler lokal dafür setzt.

961* **Lokal konfigurierte Endpunkte**: Mit OTLP/HTTP-Export aktiviert ignoriert die CLI jeden lokal konfigurierten Endpunkt, unabhängig davon, ob das Gateway die Telemetrie-Variablen gepusht hat. Seine Exporte gehen an das Gateway, es sei denn, eine Richtlinie [benennt Ihren Collector als Endpunkt](#export-directly-to-your-collector).1076* **Lokal konfigurierte Endpunkte**: Mit aktiviertem OTLP/HTTP-Export ignoriert die CLI jeden lokal konfigurierten Endpunkt, unabhängig davon, ob das Gateway die Telemetrie-Variablen gepusht hat. Ihre Exporte gehen an das Gateway, es sei denn, eine Richtlinie [benennt Ihren Collector als Endpunkt](#export-directly-to-your-collector).

962 1077

963Ohne ein `forward_to`-Ziel für ein Signal akzeptiert das Gateway es und verwirft es. Wenn Entwickler bereits Claude-Code-Telemetrie an einen Ihrer Collector exportieren, fügen Sie ihn als `forward_to`-Ziel hinzu, mit Protokollen oder Traces aktiviert, wenn sie diese exportieren, sodass er ihre Daten weiterhin erhält, nachdem sie sich anmelden. Um das Relay stattdessen zu überspringen, [benennen Sie den Collector in einer Richtlinie](#export-directly-to-your-collector).1078Ohne ein `forward_to`-Ziel für ein Signal akzeptiert das Gateway es und verwirft es. Wenn Entwickler bereits Claude-Code-Telemetrie an einen Ihrer Collector exportieren, fügen Sie ihn als `forward_to`-Ziel hinzu, mit aktivierten Logs oder Traces, wenn sie diese exportieren, sodass er ihre Daten weiterhin erhält, nachdem sie sich anmelden. Um das Relay stattdessen zu überspringen, [benennen Sie den Collector in einer Richtlinie](#export-directly-to-your-collector).

964 1079

965[Traces](/docs/de/monitoring-usage#traces-beta) erfordern auch `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1` auf jedem Client. Setzen Sie es im `env`-Block einer verwalteten Richtlinie, da das Gateway es nicht drückt. Entwickler genehmigen es im gleichen [Sicherheitsgenehmigungsdialog](#managed), den der gepushte Endpunkt bereits auslöst.1080[Traces](/docs/de/monitoring-usage#traces-beta) erfordern auch `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1` auf jedem Client. Setzen Sie es im `env`-Block einer verwalteten Richtlinie, da das Gateway es nicht pusht. Entwickler genehmigen es im gleichen [Sicherheitsgenehmigungsdialog](#managed), den der gepushte Endpunkt bereits auslöst.

966 1081

967Setzen Sie es auf `1` nur in den Richtlinien, deren Gruppen Sie verfolgen möchten. Eine Richtlinie, die es nicht setzt, erbt den Wert von Ihrer `match: {}`-Catch-All-Richtlinie, wenn diese Richtlinie einen setzt, pro den [Zusammenführungsregeln](#managed). Um zu verhindern, dass die Clients einer Gruppe Traces senden, auch wenn ein Entwickler die Variable lokal setzt, setzen Sie sie auf `0` in der Richtlinie dieser Gruppe.1082Setzen Sie es nur in den Richtlinien auf `1`, deren Gruppen Sie tracen möchten. Eine Richtlinie, die es nicht setzt, erbt den Wert von Ihrer `match: {}`-Catch-All-Richtlinie, wenn diese Richtlinie einen setzt, gemäß den [Zusammenführungsregeln](#managed). Um zu verhindern, dass die Clients einer Gruppe Traces senden, auch wenn ein Entwickler die Variable lokal setzt, setzen Sie sie in der Richtlinie dieser Gruppe auf `0`.

968 1083

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

970 1085

985 deployment.environment.name: prod1100 deployment.environment.name: prod

986```1101```

987 1102

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

989 1104

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

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

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

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

994* Werte sind Text, daher zitieren Sie eine Zahl, `true` oder `false`1109* Werte sind Text, setzen Sie daher eine Zahl, `true` oder `false` in Anführungszeichen

995 1110

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

997 1112

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

999 1114

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

1001 1116

1007 1122

1008Um sich beim Collector zu authentifizieren, setzen Sie `OTEL_EXPORTER_OTLP_HEADERS` im gleichen `env`-Block. Sitzungen senden niemals das Gateway-Sitzungstoken des Entwicklers an einen Collector, der auf diese Weise benannt wird.1123Um sich beim Collector zu authentifizieren, setzen Sie `OTEL_EXPORTER_OTLP_HEADERS` im gleichen `env`-Block. Sitzungen senden niemals das Gateway-Sitzungstoken des Entwicklers an einen Collector, der auf diese Weise benannt wird.

1009 1124

1010Wenn Sie diesen Endpunkt in einer Richtlinie hinzufügen oder ändern, fragt Claude Code jeden Entwickler, ihn im [Sicherheitsgenehmigungsdialog](#managed) zu genehmigen, bevor er ihn in einer interaktiven Sitzung anwendet.1125Wenn Sie diesen Endpunkt in einer Richtlinie hinzufügen oder ändern, bittet Claude Code jeden Entwickler, ihn im [Sicherheitsgenehmigungsdialog](#managed) zu genehmigen, bevor es ihn in einer interaktiven Sitzung anwendet.

1011 1126

1012Claude Code prüft den Endpunkt, bevor es ein Signal direkt exportiert, und behält dieses Signal auf dem Relay, wenn eine Prüfung fehlschlägt. Die Prüfungen umfassen:1127Claude Code prüft den Endpunkt, bevor es ein Signal direkt exportiert, und behält dieses Signal auf dem Relay, wenn eine Prüfung fehlschlägt. Die Prüfungen umfassen:

1013 1128

1014* Der Endpunkt kommt vom Gateway selbst. Wenn Sie die gleiche Variable in einem MDM-Profil oder einer lokalen `managed-settings.json` setzen, bleiben Exporte auf dem Relay.1129* Der Endpunkt kommt vom Gateway selbst. Wenn Sie die gleiche Variable in einem MDM-Profil oder einer lokalen `managed-settings.json` setzen, bleiben Exporte auf dem Relay.

1015* Die URL verwendet `https://` oder `http://` zu einer Loopback-Adresse1130* Die URL verwendet `https://` oder `http://` zu einer Loopback-Adresse

1016* Die URL wird zu einem Pfad aufgelöst, der mit `/v1/<signal>` endet, ohne Abfrage oder Fragment. Claude Code erstellt diesen Pfad selbst aus der generischen Variable. Es verwendet eine Pro-Signal-Variable wie `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT` wie geschrieben, daher den vollständigen Pfad dort einschließen.1131* Die URL wird zu einem Pfad aufgelöst, der mit `/v1/<signal>` endet, ohne Abfrage oder Fragment. Claude Code erstellt diesen Pfad selbst aus der generischen Variable. Eine Pro-Signal-Variable wie `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT` verwendet es wie geschrieben, geben Sie dort daher den vollständigen Pfad an.

1017* Die URL ist nicht der eigene Host des Gateways. Ein Endpunkt, der auf das Gateway adressiert ist, behält den Relay-Pfad und sein Sitzungstoken.1132* Die URL ist nicht der eigene Host des Gateways. Ein Endpunkt, der an das Gateway adressiert ist, behält den Relay-Pfad und sein Sitzungstoken.

1018* Weder Sie noch der Entwickler haben [`otelHeadersHelper`](/docs/de/settings-reference#otelheadershelper) in einer Einstellungsquelle konfiguriert. Mit einem konfigurierten Helper bleibt jedes Signal auf dem Relay.1133* Weder Sie noch der Entwickler haben [`otelHeadersHelper`](/docs/de/settings-reference#otelheadershelper) in einer Einstellungsquelle konfiguriert. Mit einem konfigurierten Helper bleibt jedes Signal auf dem Relay.

1019 1134

1020Der Endpunkt, den Sie benennen, ändert nur, wohin Exporte gehen. Sie wählen immer noch, welche Signale überhaupt exportieren, mit den `OTEL_*_EXPORTER`-Selektoren.1135Der Endpunkt, den Sie benennen, ändert nur, wohin Exporte gehen. Welche Signale überhaupt exportiert werden, wählen Sie weiterhin mit den `OTEL_*_EXPORTER`-Selektoren.

1021 1136

1022Der Endpunkt allein schaltet Export nicht ein, daher setzen Sie auch die Variablen, die dies tun, es sei denn, das Gateway drückt sie bereits:1137Der Endpunkt allein schaltet den Export nicht ein, setzen Sie daher auch die Variablen, die dies tun, es sei denn, das Gateway pusht sie bereits:

1023 1138

1024* Wenn das Gateway bereits [die Telemetrie-Variablen drückt](#telemetry), decken sie Aktivierung, Selektoren und Protokoll ab, und Ihr expliziter Endpunkt überschreibt den gepushten `<public_url>`-Wert. Setzen Sie einen `OTEL_*_EXPORTER`-Selektor auf `otlp` selbst nur für ein Signal, das kein `forward_to`-Ziel aktiviert.1139* Wenn das Gateway bereits [die Telemetrie-Variablen pusht](#telemetry), decken sie Aktivierung, Selektoren und Protokoll ab, und Ihr expliziter Endpunkt überschreibt den gepushten `<public_url>`-Wert. Setzen Sie einen `OTEL_*_EXPORTER`-Selektor nur für ein Signal selbst auf `otlp`, das kein `forward_to`-Ziel aktiviert.

1025* Wenn nicht, setzen Sie auch `CLAUDE_CODE_ENABLE_TELEMETRY=1`, die `OTEL_*_EXPORTER`-Selektoren und `OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf`.1140* Wenn nicht, setzen Sie auch `CLAUDE_CODE_ENABLE_TELEMETRY=1`, die `OTEL_*_EXPORTER`-Selektoren und `OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf`.

1026 1141

1027Wenn sich der Entwickler abmeldet oder bei einem anderen Gateway anmeldet, stoppen Exporte an den Collector und Claude Code verwirft jeden verbleibenden Batch, anstatt ihn zu senden.1142Wenn sich der Entwickler abmeldet oder bei einem anderen Gateway anmeldet, stoppen Exporte an den Collector und Claude Code verwirft jeden verbleibenden Batch, anstatt ihn zu senden.

1030 Wenn ein Ziel fehlschlägt1145 Wenn ein Ziel fehlschlägt

1031</h4>1146</h4>

1032 1147

1033Das Gateway puffert, wiederholt oder speichert Telemetrie nicht, daher verwirft es einen Export, der ein Ziel nicht erreicht, anstatt ihn verspätet zu liefern. Jedes Ziel erfolgreich oder schlägt fehl auf eigene Faust, und der exportierende Client erhält eine Erfolgsmeldung auf jeden Fall, sodass eine fehlgeschlagene Lieferung nur im Protokoll des Gateways angezeigt wird.1148Das Gateway puffert, wiederholt oder speichert Telemetrie nicht, daher verwirft es einen Export, der ein Ziel nicht erreicht, anstatt ihn verspätet zu liefern. Jedes Ziel ist für sich erfolgreich oder schlägt fehl, und der exportierende Client erhält in jedem Fall eine Erfolgsantwort, sodass eine fehlgeschlagene Lieferung nur im Log des Gateways erscheint.

1034 1149

1035Nach fünf aufeinanderfolgenden fehlgeschlagenen Lieferungen an ein Ziel pausiert das Gateway die Weiterleitung dorthin in 30-Sekunden-Abständen, protokolliert jede Pause, bis eine Lieferung erfolgreich ist. Jede Fehlerantwort, Timeout oder Verbindungsfehler zählt als fehlgeschlagene Lieferung, außer `400`, `413`, `415`, `422` und `431`, die bedeuten, dass der Collector diese Export-Nutzlast als fehlerhaft oder zu groß ablehnt.1150Nach fünf aufeinanderfolgenden fehlgeschlagenen Lieferungen an ein Ziel pausiert das Gateway die Weiterleitung dorthin in 30-Sekunden-Abschnitten und protokolliert jede Pause, bis eine Lieferung erfolgreich ist. Jede Fehlerantwort, jeder Timeout und jeder Verbindungsfehler zählt als fehlgeschlagene Lieferung, außer `400`, `413`, `415`, `422` und `431`, die bedeuten, dass der Collector die Payload dieses Exports als fehlerhaft oder zu groß abgelehnt hat.

1036 1151

1037Eine abgelehnte Nutzlast weder voranschreitet noch setzt den Fehlerzähler zurück: Das Gateway leitet weiterhin an das Ziel weiter und protokolliert eine Warnung, die es und den Status benennt, bei der ersten Ablehnung des Ziels und alle hundert danach.1152Eine abgelehnte Payload erhöht den Fehlerzähler weder, noch setzt sie ihn zurück: Das Gateway leitet weiterhin an das Ziel weiter und protokolliert eine Warnung, die das Ziel und den Status benennt, bei der ersten Ablehnung des Ziels und bei jeder hundertsten danach.

1038 1153

1039<h3 id="http-tuning">1154<h3 id="http-tuning">

1040 HTTP-Optimierung1155 HTTP-Optimierung

1044 1159

1046| - | - | - | - |1161| - | - | - | - |

1047| `access_control` | `allow_cidrs` / `deny_cidrs` | leer | Eingehende IP-Zulassung/Ablehnung nach Client-Adresse, nach `trusted_proxies`-Auflösung. `deny_cidrs` wird zuerst geprüft; ein Client, den es abgleicht, wird abgelehnt, auch wenn `allow_cidrs` auch abgleicht. Wenn `allow_cidrs` nicht leer ist, ist das Gateway standardmäßig Ablehnung. `/healthz` und `/readyz` sind von `allow_cidrs` ausgenommen. Wenn ein vertrauenswürdiger Proxy einen `X-Forwarded-For`-Eintrag sendet, der keine IP-Adresse ist, ist der echte Client unbekannt und das Gateway protokolliert eine Warnung einmal, die benennt, was zu prüfen ist. Wo eine der Listen auf die Anfrage zutrifft, lehnt sie sie mit `403` und Audit-Grund `xff_unparseable` ab. Wo keine zutrifft, bedient es die Anfrage und verwendet die Adresse des Proxys selbst als Client-IP für Pro-IP-Ratenlimits und Audit. |1162| `access_control` | `allow_cidrs` / `deny_cidrs` | leer | Eingehende IP-Zulassung/Ablehnung nach Client-Adresse, nach `trusted_proxies`-Auflösung. `deny_cidrs` wird zuerst geprüft; ein Client, den es abgleicht, wird abgelehnt, auch wenn `allow_cidrs` ebenfalls abgleicht. Wenn `allow_cidrs` nicht leer ist, lehnt das Gateway standardmäßig ab. `/healthz` und `/readyz` sind von `allow_cidrs` ausgenommen. Wenn ein vertrauenswürdiger Proxy einen `X-Forwarded-For`-Eintrag sendet, der keine IP-Adresse ist, ist der echte Client unbekannt und das Gateway protokolliert einmalig eine Warnung, die benennt, was zu prüfen ist. Wo eine der Listen auf die Anfrage zutrifft, lehnt es sie mit `403` und dem Audit-Grund `xff_unparseable` ab. Wo keine zutrifft, bedient es die Anfrage und verwendet die Adresse des Proxys selbst als Client-IP für Pro-IP-Rate-Limits und Audit. |

1051| `timeouts` | `upstream_ttfb_ms` | 120000 | Max Wartezeit auf die Antwortheader des Upstream (Zeit zum ersten Byte). Der Antwortkörper streamt dann ohne Wall-Clock-Obergrenze. Gilt für den direkten Anthropic-Upstream-Pfad; auf jedem anderen Anbieter wartet das Gateway bis zu eine Stunde auf den Antwortkopf. |1166| `timeouts` | `upstream_ttfb_ms` | 120000 | Maximale Wartezeit auf die Response-Header des Upstream (Zeit bis zum ersten Byte). Der Response-Body streamt dann ohne Wall-Clock-Obergrenze. Gilt für den direkten Anthropic-Upstream-Pfad; bei jedem anderen Anbieter wartet das Gateway bis zu eine Stunde, bis die Antwort beginnt. |

1052| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | Pro-IP-Ratenlimit auf dem nicht authentifizierten Geräteautorisierungs-Endpunkt. Erhöhen Sie für eine große Organisation hinter einer gemeinsamen Egress-IP oder NAT. [Große Rollouts](/docs/de/claude-apps-gateway-deploy#large-rollouts) zeigt, wie weit Sie es erhöhen sollten. Diese Limits gelten nur für den Geräte-Grant-Anmeldungsfluss, nicht für `/v1/messages`-Inferenz. Siehe [Benutzer-Code-Brute-Force-Widerstand](/docs/de/claude-apps-gateway-deploy#user-code-brute-force-resistance). |1167| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | Pro-IP-Rate-Limit auf dem nicht authentifizierten Geräteautorisierungs-Endpunkt. Erhöhen Sie es für eine große Organisation hinter einer gemeinsamen Egress-IP oder NAT. [Große Rollouts](/docs/de/claude-apps-gateway-deploy#large-rollouts) zeigt, wie Sie es dimensionieren. Diese Limits gelten nur für den Geräte-Grant-Anmeldungsfluss, nicht für `/v1/messages`-Inferenz. Siehe [Benutzer-Code-Brute-Force-Widerstand](/docs/de/claude-apps-gateway-deploy#user-code-brute-force-resistance). |

1053| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | Pro-IP-Ratenlimit bei `user_code`-Einreichungen unter `/device`. Es ist das, was jemanden daran hindert, den Code eines anderen Entwicklers zu erraten. [Große Rollouts](/docs/de/claude-apps-gateway-deploy#large-rollouts) zeigt, wie weit Sie es erhöhen sollten. |1168| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | Pro-IP-Rate-Limit für `user_code`-Einreichungen unter `/device`. Es ist das, was jemanden daran hindert, den Code eines anderen Entwicklers zu erraten. [Große Rollouts](/docs/de/claude-apps-gateway-deploy#large-rollouts) zeigt, wie weit Sie es erhöhen sollten. |

1054 1169

1055Wenn Sie beide `access_control`-Listen leer lassen, was der Standard ist, bedient das Gateway jede Client-Adresse, sodass nur Ihr Netzwerk einschränkt, wer es erreichen kann. Das ist wichtig, da ein Gateway [verwaltete Einstellungen](#managed) pushen kann, die Befehle auf Entwicklermaschinen ausführen.1170Wenn Sie beide `access_control`-Listen leer lassen, was der Standard ist, bedient das Gateway jede Client-Adresse, sodass nur Ihr Netzwerk einschränkt, wer es erreichen kann. Das ist wichtig, da ein Gateway [verwaltete Einstellungen](#managed) pushen kann, die Befehle auf Entwicklermaschinen ausführen.

1056 1171

1057Während `allow_cidrs` leer ist, warnt das Gateway an zwei Stellen, ohne zu ändern, wie es auf eine Anfrage antwortet:1172Während `allow_cidrs` leer ist, warnt das Gateway an zwei Stellen, ohne zu ändern, wie es auf eine Anfrage antwortet:

1058 1173

1059* **Beim Start**: eine Warnung im Betriebsprotokoll empfiehlt, nur die privaten Bereiche `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`, `100.64.0.0/10`, `127.0.0.0/8`, `::1/128` und `fc00::/7` zuzulassen, plus alle anderen internen Bereiche, von denen sich Ihre Entwickler verbinden. Wenn Sie das Gateway an eine Loopback-Adresse binden und weder `trusted_proxies` noch `public_url` setzen, wie in der lokalen Entwicklung, erscheint die Warnung nicht.1174* **Beim Start**: eine Warnung im Betriebs-Log empfiehlt, nur die privaten Bereiche `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`, `100.64.0.0/10`, `127.0.0.0/8`, `::1/128` und `fc00::/7` zuzulassen, plus alle anderen internen Bereiche, von denen sich Ihre Entwickler verbinden. Wenn Sie das Gateway an eine Loopback-Adresse binden und weder `trusted_proxies` noch `public_url` setzen, wie in der lokalen Entwicklung, erscheint die Warnung nicht.

1060* **Zur Laufzeit**: Das erste Mal, wenn eine Anfrage von einer Adresse außerhalb dieser privaten Bereiche ankommt, protokolliert das Gateway eine Warnung und gibt ein [`access.public_client`-Audit-Ereignis](/docs/de/claude-apps-gateway-deploy#logs) aus, das die Client-IP trägt. Beide werden einmal pro Prozess ausgelöst. Link-lokale Adressen, `169.254.0.0/16` und `fe80::/10`, zählen nicht als öffentlich. Das Gateway antwortet auf `/healthz` und `/readyz`, bevor diese Prüfung ausgeführt wird, sodass Health-Probes aus öffentlichen Bereichen sie nicht auslösen.1175* **Zur Laufzeit**: Wenn zum ersten Mal eine Anfrage von einer Adresse außerhalb dieser privaten Bereiche ankommt, protokolliert das Gateway eine Warnung und gibt ein [`access.public_client`-Audit-Ereignis](/docs/de/claude-apps-gateway-deploy#logs) aus, das die Client-IP trägt. Beide werden einmal pro Prozess ausgelöst. Link-lokale Adressen, `169.254.0.0/16` und `fe80::/10`, zählen nicht als öffentlich. Das Gateway antwortet auf `/healthz` und `/readyz`, bevor diese Prüfung ausgeführt wird, sodass Health-Probes aus öffentlichen Bereichen sie nicht auslösen.

1061 1176

1062Beide Signale verwenden die Client-Adresse, wie das Gateway sie auflöst. Wenn ein Load Balancer, Port-Forward oder Tunnel Datenverkehr weitergeleitet und nicht in `listen.trusted_proxies` aufgelistet ist, sieht das Gateway die Adresse des Relays, die normalerweise privat ist, sodass weder die Laufzeit-Warnung noch eine private Zulassungsliste Datenverkehr, der durch sie weitergeleitet wird, erfasst.1177Beide Signale verwenden die Client-Adresse, wie das Gateway sie auflöst. Wenn ein Load Balancer, Port-Forward oder Tunnel Datenverkehr weiterleitet und nicht in `listen.trusted_proxies` aufgelistet ist, sieht das Gateway die Adresse des Relays, die normalerweise privat ist, sodass weder die Laufzeit-Warnung noch eine private Zulassungsliste Datenverkehr erfasst, der durch es weitergeleitet wird.

1063 1178

1064Hinter einem solchen Front-End setzen Sie zuerst [`listen.trusted_proxies`](#listen), damit das Gateway echte Client-Adressen sieht, und halten Sie das Gateway und alles davor unabhängig vom öffentlichen Internet unerreichbar.1179Hinter einem solchen Front-End setzen Sie zuerst [`listen.trusted_proxies`](#listen), damit das Gateway echte Client-Adressen sieht, und halten Sie das Gateway und alles davor in jedem Fall vom öffentlichen Internet aus unerreichbar.

1065 1180

1066<h3 id="load_test_mode">1181<h3 id="load_test_mode">

1067 `load_test_mode`1182 `load_test_mode`

1068</h3>1183</h3>

1069 1184

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

1071 1186

1072Erfordert Claude Code v2.1.282 oder später auf dem Gateway-Server. Ein früheres Gateway weigert sich zu starten, wenn es den Schlüssel findet. Aktualisieren Sie jedes Replikat, bevor Sie den Block hinzufügen, und entfernen Sie den Block, bevor Sie zurückrollen.1187Erfordert Claude Code v2.1.282 oder später auf dem Gateway-Server. Ein früheres Gateway weigert sich zu starten, wenn es den Schlüssel findet. Aktualisieren Sie jedes Replikat, bevor Sie den Block hinzufügen, und entfernen Sie den Block, bevor Sie zurückrollen.

1073 1188

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

1075 1190

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

1077load_test_mode:1192load_test_mode:

1082 1197

1084| - | - | - |1199| - | - | - |

1085| `enabled` | Ja | `true` schaltet den Modus ein. `false` behält Ihre Zahlen in der Datei mit dem Modus aus. Das Gateway weigert sich zu starten, wenn der Block vorhanden ist, ohne ihn. |1200| `enabled` | Ja | `true` schaltet den Modus ein. `false` behält Ihre Zahlen in der Datei bei ausgeschaltetem Modus. Das Gateway weigert sich zu starten, wenn der Block ohne dieses Feld vorhanden ist. |

1087| `reply_seconds` | Nein | Standard `9.5`. Wie lange eine gestreamte Antwort dauert, von 0 bis 600. `0` sendet die ganze Antwort auf einmal. Eine Antwort auf eine nicht-gestreamte Anfrage kommt immer auf einmal zurück. |1202| `reply_seconds` | Nein | Standard `9.5`. Wie lange eine gestreamte Antwort dauert, von 0 bis 600. `0` sendet die ganze Antwort auf einmal. Eine Antwort auf eine nicht-streamende Anfrage kommt immer auf einmal zurück. |

1088 1203

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

1090 1205

1091Keine Modell-Anfrage wird an den Anbieter gesendet, daher ist die CPU pro Anfrage eines Replikats eine Schätzung und liest niedriger als Produktion, die auch ihren Datenverkehr zum Anbieter verschlüsselt. Bestätigen Sie eine Replikat-Anzahl mit einem kleinen Piloten gegen den echten Anbieter. Vor v2.1.283 liest die Schätzung viel niedriger.1206Es wird keine Modell-Anfrage an den Anbieter gesendet, daher ist die CPU pro Anfrage eines Replikats eine Schätzung und fällt niedriger aus als in der Produktion, die ihren Datenverkehr zum Anbieter zusätzlich verschlüsselt. Bestätigen Sie eine Replikat-Anzahl mit einem kleinen Pilotversuch gegen den echten Anbieter. Vor v2.1.283 fällt die Schätzung deutlich niedriger aus.

1092 1207

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

1094 1209

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

1096 1211

1097<Warning>1212<Warning>

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

1099</Warning>1214</Warning>

1100 1215

1101<h2 id="complete-example">1216<h2 id="complete-example">

1150 postgres_url: ${GATEWAY_POSTGRES_URL}1265 postgres_url: ${GATEWAY_POSTGRES_URL}

1151 # max_connections: 51266 # max_connections: 5

1152 # connect_timeout_seconds: 51267 # connect_timeout_seconds: 5

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

1153 1269

1154# Aktiviert /v1/organizations/spend_limits (spiegelt die Anthropic Admin API)1270# Aktiviert /v1/organizations/spend_limits (spiegelt die Anthropic Admin API)

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

1271 1387

1272`parentSettingsBehavior: "merge"` behält Claude Desktop's Bereitstellung der Egress-Allowlist für seine eingebetteten Claude Code-Sitzungen bei; [Richtlinie für Claude Desktop-Sitzungen bereitstellen](/docs/de/claude-apps-gateway#deliver-policy-to-claude-desktop-sessions) erklärt den Mechanismus und wo sich die Opt-in befinden muss.1388`parentSettingsBehavior: "merge"` behält Claude Desktop's Bereitstellung der Egress-Allowlist für seine eingebetteten Claude Code-Sitzungen bei; [Richtlinie für Claude Desktop-Sitzungen bereitstellen](/docs/de/claude-apps-gateway#deliver-policy-to-claude-desktop-sessions) erklärt den Mechanismus und wo sich die Opt-in befinden muss.

1273 1389

1390Um zu verhindern, dass Entwickler das Gateway mit einer Cloud-Anbieter-Variable oder einer eigenen `ANTHROPIC_BASE_URL` umgehen, fügen Sie `"allowedProviders": ["gateway"]` zur selben Datei hinzu. Claude Code lehnt dann jede Sitzung auf dem Computer ab, die nicht für ein Cloud-Gateway eingerichtet ist, und lässt ein Gateway nur zu, wenn es dasjenige ist, das `forceLoginGatewayUrl` angibt, oder eines, dessen URL der `env`-Block der Datei als `ANTHROPIC_BASE_URL` setzt. `claude gateway` verweigert die Ausführung auf einem Computer, der die Liste setzt, halten Sie den Schlüssel daher vom Gateway-Host fern. Siehe den Eintrag [`allowedProviders`](/docs/de/settings-reference#allowedproviders) in der Einstellungsreferenz. Erfordert Claude Code v2.1.285 oder höher.

1391

1274Stellen Sie die `managed-settings.json`-Datei auf jedem Gerät bereit, typischerweise über Ihre MDM-Plattform. Der Dateipfad unterscheidet sich je nach Plattform. Siehe [wo jeder Mechanismus die Richtlinie speichert](/docs/de/managed-settings#where-each-mechanism-stores-the-policy).1392Stellen Sie die `managed-settings.json`-Datei auf jedem Gerät bereit, typischerweise über Ihre MDM-Plattform. Der Dateipfad unterscheidet sich je nach Plattform. Siehe [wo jeder Mechanismus die Richtlinie speichert](/docs/de/managed-settings#where-each-mechanism-stores-the-policy).

1275 1393

1276Standardmäßig ersetzt eine Registrierungsrichtlinie unter Windows oder ein verwaltetes Preferences-Plist unter macOS die `managed-settings.json`-Datei, anstatt sie damit zu zusammenzuführen, mit Ausnahme der [Ausnahmeschlüssel und quellenübergreifenden Überprüfungen oben](#precedence-with-other-managed-sources). Alle drei Schlüssel in diesem Snippet folgen der Regel mit der höchsten Prioritätsquelle, daher müssen Flotten, die Richtlinien über Gruppenrichtlinien oder Konfigurationsprofile bereitstellen, alle drei stattdessen in diesem Mechanismus platzieren.1394Standardmäßig ersetzt eine Registrierungsrichtlinie unter Windows oder ein verwaltetes Preferences-Plist unter macOS die `managed-settings.json`-Datei, anstatt sie damit zu zusammenzuführen, mit Ausnahme der [Ausnahmeschlüssel und quellenübergreifenden Überprüfungen oben](#precedence-with-other-managed-sources). Alle drei Schlüssel in diesem Snippet folgen der Regel mit der höchsten Prioritätsquelle, daher müssen Flotten, die Richtlinien über Gruppenrichtlinien oder Konfigurationsprofile bereitstellen, alle drei stattdessen in diesem Mechanismus platzieren.

1277 1395

1278Für Claude Desktop setzen Sie den `bootstrapUrl`-Schlüssel in Claude Desktop's eigene [verwaltete Konfiguration](https://claude.com/docs/third-party/claude-desktop/configuration) auf `<listen.public_url>/user/bootstrap`. Der Anmeldungsfluss und die Pro-Gruppen-Richtlinie entsprechen dann der CLI's, sobald eine Richtlinie sich serverseitig mit einem `desktop`-Schlüssel anmeldet; ohne die Anmeldung gibt `/user/bootstrap` 404 zurück. Siehe [Claude Desktop-Overlay](#claude-desktop-overlay) für die serverseitige Hälfte.1396Für Claude Desktop setzen Sie den `bootstrapUrl`-Schlüssel in Claude Desktop's eigene [verwaltete Konfiguration](https://claude.com/docs/third-party/claude-desktop/configuration) auf `<listen.public_url>/user/bootstrap`. Der Anmeldungsfluss und die Pro-Gruppen-Richtlinie entsprechen dann der CLI's, sobald eine Richtlinie sich serverseitig mit einem `desktop`-Schlüssel anmeldet; ohne die Anmeldung gibt `/user/bootstrap` 404 zurück. Siehe [Claude Desktop-Overlay](#claude-desktop-overlay) für die serverseitige Hälfte.

1279 1397

1280Claude Code ehrt [`forceLoginGatewayUrl`](/docs/de/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/de/settings-reference#gatewayinternalnetworks) und den `"gateway"`-Wert von [`forceLoginMethod`](/docs/de/settings-reference#forceloginmethod) nur von einer verwalteten Quelle auf dem Computer: `managed-settings.json`, das macOS-Plist oder die Windows HKLM-Registrierung, oder ein Richtlinien-Helper. Ein Entwickler, der sie in seiner eigenen `~/.claude/settings.json` setzt, hat keine Auswirkung, und das Setzen im Gateway-Payload auch nicht.1398Claude Code berücksichtigt [`forceLoginGatewayUrl`](/docs/de/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/de/settings-reference#gatewayinternalnetworks) und den `"gateway"`-Wert von [`forceLoginMethod`](/docs/de/settings-reference#forceloginmethod) nur von einer verwalteten Quelle auf dem Computer: `managed-settings.json`, das macOS-Plist oder die Windows HKLM-Registrierung, oder ein Richtlinien-Helper. Das Setzen dieser Schlüssel in der eigenen `~/.claude/settings.json` eines Entwicklers oder in der Gateway-Payload konfiguriert die Gateway-Anmeldung nicht.

1399

1400Lassen Sie `forceLoginMethod` und `forceLoginOrgUUID` aus der Payload heraus. Claude Code liest beide Schlüssel für seine Überprüfung der Anmeldedaten beim Start weiterhin aus der Payload, sodass ein Entwickler, der von Anthropic ausgestellte Anmeldedaten auf dem Computer behält, auch nach der Anmeldung den unter [Administratorrichtlinie erfordert eine Cloud-Gateway-Anmeldung](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in) beschriebenen Abbruch beim Start erhält.

1281 1401

1282<h2 id="related">1402<h2 id="related">

1283 Verwandt1403 Verwandt

cli-reference.md +16 −8

Details

10 CLI-Befehle10 CLI-Befehle

11</h2>11</h2>

12 12

~~13Sie können Sitzungen starten, Inhalte weiterleiten, Gespräche fortsetzen und Updates verwalten mit diesen Befehlen:~~13Sie können Sitzungen starten, Inhalte weiterleiten, Konversationen fortsetzen und Updates verwalten mit diesen Befehlen:

14 14

16| :- | :- | :- |16| :- | :- | :- |

26| `claude install [version]` | Installieren oder neu installieren Sie die native Binärdatei. Akzeptiert eine Version wie `2.1.118`, oder `stable` oder `latest`. Siehe [Installieren Sie eine bestimmte Version](/docs/de/setup#install-a-specific-version) | `claude install stable` |26| `claude install [version]` | Installieren oder neu installieren Sie die native Binärdatei. Akzeptiert eine Version wie `2.1.118`, oder `stable` oder `latest`. Siehe [Installieren Sie eine bestimmte Version](/docs/de/setup#install-a-specific-version) | `claude install stable` |

27| `claude auth login` | Melden Sie sich bei Ihrem Anthropic-Konto an. Verwenden Sie `--email`, um Ihre E-Mail-Adresse vorauszufüllen, `--sso`, um SSO-Authentifizierung zu erzwingen, und `--console`, um sich mit der Anthropic Console für API-Nutzungsabrechnung anstelle eines Claude-Abonnements anzumelden | `claude auth login --console` |27| `claude auth login` | Melden Sie sich bei Ihrem Anthropic-Konto an. Verwenden Sie `--email`, um Ihre E-Mail-Adresse vorauszufüllen, `--sso`, um SSO-Authentifizierung zu erzwingen, und `--console`, um sich mit der Anthropic Console für API-Nutzungsabrechnung anstelle eines Claude-Abonnements anzumelden | `claude auth login --console` |

29| `claude auth status` | Authentifizierungsstatus als JSON anzeigen. Verwenden Sie `--text` für benutzerfreundliche Ausgabe. Beendet mit Code 0, wenn angemeldet, 1, wenn nicht. Die JSON enthält ein `configDirectory` Feld, das das [Konfigurationsverzeichnis](/docs/de/claude-directory) benennt, das die CLI verwendet. Das Feld erfordert Claude Code v2.1.268 oder später | `claude auth status` |29| `claude auth status` | Authentifizierungsstatus als JSON anzeigen. Verwenden Sie `--text` für benutzerfreundliche Ausgabe. Beendet mit Code 0, wenn angemeldet, 1, wenn nicht. Die JSON enthält ein `configDirectory` Feld, das das [Konfigurationsverzeichnis](/docs/de/claude-directory) benennt, das die CLI verwendet. Das Feld erfordert Claude Code v2.1.268 oder später. Das Feld `authMethod` im JSON hat einen der Werte `none`, `claude.ai`, `oauth_token`, `api_key`, `api_key_helper` oder `third_party` | `claude auth status` |

30| `claude agents` | Öffnen Sie die [Agent-Ansicht](/docs/de/agent-view), um parallele Hintergrundsitzungen zu überwachen und zu versenden. Verwenden Sie `--cwd <path>`, um nur Sitzungen anzuzeigen, die in diesem Verzeichnis gestartet wurden, oder `--json`, um Live-Sitzungen als JSON-Array zum Scripting auszugeben (`--json --all` schließt auch abgeschlossene Hintergrundsitzungen ein). Übergeben Sie `--permission-mode`, `--model`, `--effort` oder `--agent`, um [Standardwerte für versendete Sitzungen](/docs/de/agent-view#permission-mode-model-and-effort) festzulegen. Akzeptiert `--settings`, `--add-dir`, `--plugin-dir` und `--mcp-config` wie der oberste `claude`-Befehl. Das Öffnen der Agent-Ansicht erfordert ein interaktives Terminal | `claude agents --json` |30| `claude agents` | Öffnen Sie die [Agent-Ansicht](/docs/de/agent-view), um parallele Hintergrundsitzungen zu überwachen und zu versenden. Verwenden Sie `--cwd <path>`, um nur Sitzungen anzuzeigen, die in diesem Verzeichnis gestartet wurden, oder `--json`, um aktive Sitzungen als JSON-Array zum Scripting auszugeben (`--json --all` schließt auch abgeschlossene Hintergrundsitzungen ein). Übergeben Sie `--permission-mode`, `--model`, `--effort` oder `--agent`, um [Standardwerte für versendete Sitzungen](/docs/de/agent-view#permission-mode-model-and-effort) festzulegen. Akzeptiert `--settings`, `--add-dir`, `--plugin-dir` und `--mcp-config` wie der oberste `claude`-Befehl. Das Öffnen der Agent-Ansicht erfordert ein interaktives Terminal | `claude agents --json` |

32| `claude auto-mode defaults` | Drucken Sie die integrierten [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) Klassifiziererregeln als JSON. Verwenden Sie `claude auto-mode config`, um Ihre effektive Konfiguration mit angewendeten Einstellungen anzuzeigen. `--label <prefix>` druckt nur die Regeln, deren Bezeichnung mit diesem Präfix beginnt, Groß- und Kleinschreibung wird nicht beachtet. Erfordert Claude Code v2.1.208 oder später | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | Drucken Sie die integrierten [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) Klassifikatorregeln als JSON. Verwenden Sie `claude auto-mode config`, um Ihre effektive Konfiguration mit angewendeten Einstellungen anzuzeigen. `--label <prefix>` druckt nur die Regeln, deren Bezeichnung mit diesem Präfix beginnt, Groß- und Kleinschreibung wird nicht beachtet. Erfordert Claude Code v2.1.208 oder später | `claude auto-mode defaults --label 'Git Destructive'` |

33| `claude auto-mode reset` | Stellen Sie die Standard-[Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) Konfiguration wieder her, indem Sie den `autoMode` Abschnitt aus Ihrer Benutzereinstellungsdatei entfernen. Fordert zur Bestätigung auf, bevor geschrieben wird; übergeben Sie `-y`/`--yes`, um die Eingabeaufforderung zu überspringen. Regeln aus [verwalteten Einstellungen](/docs/de/server-managed-settings) oder dem `--settings` Flag gelten weiterhin. Erfordert Claude Code v2.1.212 oder später. Siehe [Überprüfen Sie die Standardwerte und Ihre effektive Konfiguration](/docs/de/auto-mode-config#inspect-the-defaults-and-your-effective-config) | `claude auto-mode reset --yes` |33| `claude auto-mode reset` | Stellen Sie die Standard-[Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) Konfiguration wieder her, indem Sie den `autoMode` Abschnitt aus Ihrer Benutzereinstellungsdatei entfernen. Fordert zur Bestätigung auf, bevor geschrieben wird; übergeben Sie `-y`/`--yes`, um die Eingabeaufforderung zu überspringen. Regeln aus [verwalteten Einstellungen](/docs/de/server-managed-settings) oder dem `--settings` Flag gelten weiterhin. Erfordert Claude Code v2.1.212 oder später. Siehe [Überprüfen Sie die Standardwerte und Ihre effektive Konfiguration](/docs/de/auto-mode-config#inspect-the-defaults-and-your-effective-config) | `claude auto-mode reset --yes` |

34| `claude daemon status` | Drucken Sie den Hintergrund-Sitzungs-[Supervisor](/docs/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 status` | Drucken Sie den Hintergrund-Sitzungs-[Supervisor](/docs/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` |

35| `claude daemon stop --any` | Stoppen Sie den Hintergrund-Sitzungs-[Supervisor](/docs/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](/docs/de/agent-view#agent-view-says-the-background-service-did-not-respond) zu erholen | `claude daemon stop --any --keep-workers` |35| `claude daemon stop --any` | Stoppen Sie den Hintergrund-Sitzungs-[Supervisor](/docs/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](/docs/de/agent-view#agent-view-says-the-background-service-did-not-respond) zu erholen | `claude daemon stop --any --keep-workers` |

37| `claude import [source]` | Starten Sie eine interaktive Sitzung, die [`/import`](/docs/de/commands#all-commands) ausführt, um Konfiguration von anderen Coding-Agenten in Claude Code zu bringen. Akzeptiert die gleichen `--dry-run` und `--yes` Optionen wie der Befehl. Nicht verfügbar auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform auf AWS. Auch nicht verfügbar, wenn Sie [Feature-Flag-Abruf](/docs/de/env-vars#features-that-need-feature-flag-fetching) deaktivieren. Erfordert Claude Code v2.1.213 oder später | `claude import codex --dry-run` |37| `claude import [source]` | Starten Sie eine interaktive Sitzung, die [`/import`](/docs/de/commands#all-commands) ausführt, um Konfiguration von anderen Coding-Agenten in Claude Code zu bringen. Akzeptiert die gleichen `--dry-run` und `--yes` Optionen wie der Befehl. Nicht verfügbar auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform auf AWS. Auch nicht verfügbar, wenn Sie [Feature-Flag-Abruf](/docs/de/env-vars#features-that-need-feature-flag-fetching) deaktivieren. Erfordert Claude Code v2.1.213 oder später | `claude import codex --dry-run` |

40| `claude mcp login <name>` | 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. Siehe [Authentifizierung über die Befehlszeile](/docs/de/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |40| `claude mcp login <name>` | 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-Konnektor-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. Siehe [Authentifizierung über die Befehlszeile](/docs/de/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |

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

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

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

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

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

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

48| `claude setup-token` | Generieren Sie ein langlebiges OAuth-Token für CI und Skripte. Gibt das Token auf dem Terminal aus, ohne es zu speichern. Erfordert ein Claude-Abonnement. Siehe [Generieren Sie ein langlebiges Token](/docs/de/authentication#generate-a-long-lived-token) | `claude setup-token` |48| `claude setup-token` | Generieren Sie ein langlebiges OAuth-Token für CI und Skripte. Gibt das Token auf dem Terminal aus, ohne es zu speichern. Erfordert ein Claude-Abonnement. Siehe [Generieren Sie ein langlebiges Token](/docs/de/authentication#generate-a-long-lived-token) | `claude setup-token` |

50| `claude ultrareview [target]` | Führen Sie [ultrareview](/docs/de/ultrareview#run-ultrareview-non-interactively) nicht interaktiv aus. Gibt Ergebnisse auf stdout aus und beendet sich mit 0 bei Erfolg oder 1 bei Fehler. Verwenden Sie `--json` für die rohe Nutzlast und `--timeout <minutes>`, um das 45-Minuten-Standard zu überschreiben. Verwenden Sie `--post` auf einem `github.com` Pull-Request-Ziel, um die fertigen Ergebnisse als einen einfachen Kommentar von Ihrem GitHub-Konto auf dem PR zu posten. `--no-post` ist die Standardeinstellung. `--post` und `--no-post` erfordern Claude Code v2.1.227 oder später. Siehe [Ergebnisse auf den Pull Request posten](/docs/de/ultrareview#post-findings-to-the-pull-request) | `claude ultrareview 1234 --json` |50| `claude ultrareview [target]` | Führen Sie [ultrareview](/docs/de/ultrareview#run-ultrareview-non-interactively) nicht interaktiv aus. Gibt Ergebnisse auf stdout aus und beendet sich mit 0 bei Erfolg oder 1 bei Fehler. Verwenden Sie `--json` für die rohe Payload und `--timeout <minutes>`, um das 45-Minuten-Standard zu überschreiben. Verwenden Sie `--post` auf einem `github.com` Pull-Request-Ziel, um die fertigen Ergebnisse als einen einfachen Kommentar von Ihrem GitHub-Konto auf dem PR zu posten. `--no-post` ist die Standardeinstellung. `--post` und `--no-post` erfordern Claude Code v2.1.227 oder später. Siehe [Ergebnisse auf den Pull Request posten](/docs/de/ultrareview#post-findings-to-the-pull-request) | `claude ultrareview 1234 --json` |

51 51

52Wenn Sie einen Unterbefehl falsch eingeben, schlägt Claude Code die nächste Übereinstimmung vor und beendet sich, ohne eine Sitzung zu starten. Zum Beispiel gibt `claude udpate` `Did you mean claude update?` aus.52Wenn Sie einen Unterbefehl falsch eingeben, schlägt Claude Code die nächste Übereinstimmung vor und beendet sich, ohne eine Sitzung zu starten. Zum Beispiel gibt `claude udpate` `Did you mean claude update?` aus.

53 53

157| `--system-prompt-snapshot` | Mit `off` wird der Prompt bei jeder Anfrage neu erstellt. Mit `on`, dem Standard, wird ein aufgezeichneter Prompt wiederverwendet, wo [Aufzeichnung anwendbar ist](#system-prompt-flags-in-resumed-conversations) | `claude --append-system-prompt "Draft rules" --system-prompt-snapshot off` |157| `--system-prompt-snapshot` | Mit `off` wird der Prompt bei jeder Anfrage neu erstellt. Mit `on`, dem Standard, wird ein aufgezeichneter Prompt wiederverwendet, wo [Aufzeichnung anwendbar ist](#system-prompt-flags-in-resumed-conversations) | `claude --append-system-prompt "Draft rules" --system-prompt-snapshot off` |

158 158

159`--system-prompt` und `--system-prompt-file` schließen sich gegenseitig aus. Die Append-Flags können mit einem der Ersetzungs-Flags kombiniert werden.159Sie können diese Flags kombinieren. Um den Standard-Prompt zu ersetzen und trotzdem Ihren eigenen Text anzuhängen, übergeben Sie `--append-system-prompt` oder `--append-system-prompt-file` zusammen mit `--system-prompt` oder `--system-prompt-file`. Ab Claude Code v2.1.283 können Sie ein Flag auch zusammen mit seiner eigenen Dateiform übergeben, etwa `--append-system-prompt` mit `--append-system-prompt-file`, und Claude Code verwendet beide.

160

161Führen Sie beispielsweise Folgendes in Ihrer Shell aus, um sowohl einen Styleguide aus einer Datei als auch eine zusätzliche Anweisung anzuhängen:

162

163```bash theme={null}

164claude -p --append-system-prompt-file ./style.md --append-system-prompt "Always reply in French" "Summarize README.md"

165```

166

167Claude erhält den Standard-System-Prompt, gefolgt vom Inhalt von `style.md`, einer Leerzeile und dann `Always reply in French`. Der Dateiinhalt steht zuerst, auch wenn Sie `--append-system-prompt` vor `--append-system-prompt-file` übergeben.

160 168

161Wenn der Ersetzungstext Anweisungen kombiniert, die bei jedem Lauf gleich sind, mit Kontext, der sich pro Lauf ändert, fügen Sie eine Zeile ein, die nur `__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__` enthält, zwischen den Anweisungen und dem Kontext. Claude Code teilt den Prompt an der ersten solchen Zeile und entfernt diese Zeile, sodass der Teil darüber zwischengespeichert bleibt, während der Teil darunter sich ändert. Erfordert Claude Code v2.1.275 oder später. [Zwischenspeichern Sie den statischen Teil eines benutzerdefinierten Prompts](/docs/de/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt) listet die Konfigurationen auf, wo die Aufteilung anwendbar ist.169Wenn der Ersetzungstext Anweisungen kombiniert, die bei jedem Lauf gleich sind, mit Kontext, der sich pro Lauf ändert, fügen Sie eine Zeile ein, die nur `__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__` enthält, zwischen den Anweisungen und dem Kontext. Claude Code teilt den Prompt an der ersten solchen Zeile und entfernt diese Zeile, sodass der Teil darüber zwischengespeichert bleibt, während der Teil darunter sich ändert. Erfordert Claude Code v2.1.275 oder später. [Zwischenspeichern Sie den statischen Teil eines benutzerdefinierten Prompts](/docs/de/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt) listet die Konfigurationen auf, wo die Aufteilung anwendbar ist.

162 170

commands.md +124 −124

Details

36 Alle Befehle36 Alle Befehle

37</h2>37</h2>

38 38

39Die folgende Tabelle listet alle Befehle auf, die in Claude Code enthalten sind. Die meisten sind integrierte Befehle, deren Verhalten in die CLI codiert ist. Zwei Arten von Einträgen sind gekennzeichnet:39Die folgende Tabelle listet alle in Claude Code enthaltenen Befehle auf. Die meisten sind integrierte Befehle, deren Verhalten fest in der CLI programmiert ist. Zwei Arten von Einträgen sind gekennzeichnet:

40 40

~~41* **[Skill](/docs/de/skills#bundled-skills)**: ein gebündelter Skill. Er funktioniert wie Skills, die Sie selbst schreiben: ein Prompt, der an Claude übergeben wird.~~41* **[Skill](/docs/de/skills#bundled-skills)**: ein mitgelieferter Skill. Er funktioniert wie Skills, die Sie selbst schreiben: ein Prompt, der an Claude übergeben wird.

~~42 * `/verify` wird nur ausgeführt, wenn Sie ihn aufrufen. Vor v2.1.215 konnte Claude `/verify` auch von selbst ausführen.~~42 * `/verify` wird nur ausgeführt, wenn Sie ihn aufrufen. Vor v2.1.215 konnte Claude `/verify` auch selbstständig ausführen.

~~43* **[Workflow](/docs/de/workflows#bundled-workflows)**: ein gebündelter [dynamischer Workflow](/docs/de/workflows), der Arbeit über viele Subagenten verteilt und im Hintergrund ausgeführt wird.~~43* **[Workflow](/docs/de/workflows#bundled-workflows)**: ein mitgelieferter [dynamischer Workflow](/docs/de/workflows), der die Arbeit auf viele Subagenten verteilt und im Hintergrund läuft.

~~44 * `/deep-research` wird nur ausgeführt, wenn Sie ihn aufrufen. Vor v2.1.218 konnte Claude ihn auch von selbst starten.~~44 * `/deep-research` wird nur ausgeführt, wenn Sie ihn aufrufen. Vor v2.1.218 konnte Claude ihn auch selbstständig starten.

45 45

~~46Um Ihre eigenen Befehle hinzuzufügen, siehe [Skills](/docs/de/skills).~~46Wie Sie eigene Befehle hinzufügen, erfahren Sie unter [Skills](/docs/de/skills).

47 47

~~48In der folgenden Tabelle zeigt `<arg>` ein erforderliches Argument und `[arg]` ein optionales an.~~48In der folgenden Tabelle kennzeichnet `<arg>` ein erforderliches Argument und `[arg]` ein optionales.

49 49

50<Note>50<Note>

51 Nicht jeder Befehl ist für jeden Benutzer verfügbar. Die Verfügbarkeit hängt von Ihrer Plattform, Ihrem Plan und Ihrer Umgebung ab. Beispielsweise wird `/desktop` nur auf macOS und x64 Windows angezeigt, wenn Sie mit einem Claude-Abonnement angemeldet sind, und `/upgrade` wird nicht in Enterprise-Plänen angezeigt.51 Nicht jeder Befehl wird jedem Benutzer angezeigt. Die Verfügbarkeit hängt von Ihrer Plattform, Ihrem Plan und Ihrer Umgebung ab. Beispielsweise wird `/desktop` nur unter macOS und x64-Windows angezeigt, wenn Sie mit einem Claude-Abonnement angemeldet sind, und `/upgrade` wird in Enterprise-Plänen nicht angezeigt.

52</Note>52</Note>

53 53

54| Befehl | Zweck |54| Befehl | Zweck |

55| :- | :- |55| :- | :- |

56| `/add-dir <path>` | Fügen Sie ein Arbeitsverzeichnis für den Dateizugriff während der aktuellen Sitzung hinzu. Geben Sie einen Teilpfad ein, um passende Verzeichnisvorschläge zu sehen; drücken Sie `Tab`, um einen zu akzeptieren. Die meisten `.claude/`-Konfigurationen werden [nicht erkannt](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) aus dem hinzugefügten Verzeichnis. Sie können die meisten [Netzwerkpfade](/docs/de/errors#working-directory-is-a-network-path) nicht hinzufügen, wie z. B. `\\server\share`. Nach einem erfolgreichen Hinzufügen werden Ihre [`DirectoryAdded` Hooks](/docs/de/hooks#directoryadded) ausgeführt. Wenn Sie ihn ausführen, während Claude antwortet, fordert Claude Code Sie auf, das Verzeichnis sofort zu bestätigen, und sobald Sie bestätigen, kann Claudes nächster Tool-Aufruf in derselben Runde darauf zugreifen. Vor v2.1.234 wartete Claude Code mit dem Befehl, bis die Runde beendet war |56| `/add-dir <path>` | Fügt ein Arbeitsverzeichnis für den Dateizugriff während der aktuellen Sitzung hinzu. Geben Sie einen Teilpfad ein, um passende Verzeichnisvorschläge zu sehen; drücken Sie `Tab`, um einen davon zu übernehmen. Der Großteil der `.claude/`-Konfiguration wird im hinzugefügten Verzeichnis [nicht erkannt](/docs/de/permissions#additional-directories-grant-file-access-not-configuration). Die meisten [Netzwerkpfade](/docs/de/errors#working-directory-is-a-network-path), etwa `\\server\share`, können Sie nicht hinzufügen. Nach erfolgreichem Hinzufügen werden Ihre [`DirectoryAdded`-Hooks](/docs/de/hooks#directoryadded) ausgeführt. Wenn Sie den Befehl ausführen, während Claude antwortet, bittet Claude Code Sie sofort, das Verzeichnis zu bestätigen, und sobald Sie bestätigen, kann Claudes nächster Tool-Aufruf im selben Turn darauf zugreifen. Vor v2.1.234 hat Claude Code den Befehl in die Warteschlange gestellt, bis der Turn beendet war |

57| `/advisor [model\|off]` | Aktivieren oder deaktivieren Sie das [Advisor-Tool](/docs/de/advisor), das ein zweites Modell zu Schlüsselmomenten während einer Aufgabe zu Rate zieht. Akzeptiert `fable`, `opus`, `sonnet` oder eine vollständige Modell-ID. `fable` erfordert [Fable-Zugriff](/docs/de/advisor#choose-an-advisor-model). Ohne Argument öffnet sich eine Auswahl. In einer Sitzung ohne interaktives Terminal oder über [Remote Control](/docs/de/remote-control#limitations) übergeben Sie das Modell oder `off` als Argument; ohne Argument dort gibt der Befehl den aktuellen Advisor als Text aus. Diese Formen erfordern Claude Code v2.1.260 oder später |57| `/advisor [model\|off]` | Aktiviert oder deaktiviert das [Advisor-Tool](/docs/de/advisor), das an entscheidenden Stellen einer Aufgabe ein zweites Modell um Rat fragt. Akzeptiert `fable`, `opus`, `sonnet` oder eine vollständige Modell-ID. `fable` erfordert [Fable-Zugriff](/docs/de/advisor#choose-an-advisor-model). Ohne Argument wird eine Auswahl geöffnet. In einer Sitzung ohne interaktives Terminal oder über [Remote Control](/docs/de/remote-control#limitations) übergeben Sie das Modell oder `off` als Argument; ohne Argument gibt der Befehl dort den aktuellen Advisor als Text aus. Diese Formen erfordern Claude Code v2.1.260 oder höher |

58| `/agents` | Ab v2.1.198 gibt die Ausführung von `/agents` eine Erinnerung aus, Claude zu bitten, [Subagenten](/docs/de/sub-agents) zu erstellen oder zu verwalten, oder `.claude/agents/` oder `~/.claude/agents/` direkt zu bearbeiten. In v2.1.197 und früher öffnet sich eine interaktive Schnittstelle zum Erstellen und Verwalten von Subagenten-Konfigurationen |58| `/agents` | Ab v2.1.198 gibt `/agents` einen Hinweis aus, Claude zu bitten, [Subagenten](/docs/de/sub-agents) zu erstellen oder zu verwalten, oder `.claude/agents/` bzw. `~/.claude/agents/` direkt zu bearbeiten. In v2.1.197 und früher wird eine interaktive Oberfläche zum Erstellen und Verwalten von Subagenten-Konfigurationen geöffnet |

59| `/artifact-capabilities` | **[Skill](/docs/de/skills#bundled-skills).** Laden Sie die Referenz für die Laufzeitfunktionen, die ein veröffentlichtes [Artefakt](/docs/de/artifacts) verwenden kann, wie z. B. [Aufrufen Ihrer Connectors](/docs/de/artifacts#pull-live-data-with-mcp-connectors) oder [Angebot eines Datei-Downloads](/docs/de/artifacts#offer-a-file-download), einschließlich derjenigen, auf die Ihr Konto Zugriff hat. Claude lädt es normalerweise von selbst, bevor eine Seite erstellt wird, die eines verwendet. Verfügbar, wo [Artefakte](/docs/de/artifacts#availability) verfügbar sind |59| `/artifact-capabilities` | **[Skill](/docs/de/skills#bundled-skills).** Lädt die Referenz zu den Laufzeitfunktionen, die ein veröffentlichtes [Artefakt](/docs/de/artifacts) nutzen kann, etwa das [Aufrufen Ihrer Konnektoren](/docs/de/artifacts#pull-live-data-with-mcp-connectors) oder das [Anbieten eines Datei-Downloads](/docs/de/artifacts#offer-a-file-download), einschließlich der Angabe, welche davon Ihr Konto hat. Claude lädt sie normalerweise selbstständig, bevor eine Seite erstellt wird, die eine davon verwendet. Verfügbar, wo [Artefakte](/docs/de/artifacts#availability) verfügbar sind |

60| `/artifact-diagramming` | **[Skill](/docs/de/skills#bundled-skills).** Laden Sie Diagramm-Richtlinien für Claude, um sie in [Artefakten](/docs/de/artifacts) zu befolgen: wann ein Diagramm hilft, was zu zeichnen ist und wie man Inline-SVG schreibt, das in hellen und dunklen Designs lesbar bleibt. Erfordert Claude Code v2.1.221 oder später |60| `/artifact-diagramming` | **[Skill](/docs/de/skills#bundled-skills).** Lädt Richtlinien zum Erstellen von Diagrammen, denen Claude in [Artefakten](/docs/de/artifacts) folgt: wann ein Diagramm hilft, was gezeichnet werden soll und wie Inline-SVG geschrieben wird, das in hellen und dunklen Designs lesbar bleibt. Erfordert Claude Code v2.1.221 oder höher |

61| `/artifacts` | Listen Sie die [Artefakte](/docs/de/artifacts#find-an-artifact-again) auf, die Sie besitzen oder die mit Ihnen geteilt werden, und fügen Sie dann eines an die Sitzung an, öffnen Sie es in Ihrem Browser oder kopieren Sie seinen Link. Verfügbar, wo [Artefakte](/docs/de/artifacts#availability) verfügbar sind. Erfordert Claude Code v2.1.208 oder später; das Anhängen mit `Enter` erfordert v2.1.216 |61| `/artifacts` | Listet die [Artefakte](/docs/de/artifacts#find-an-artifact-again) auf, die Ihnen gehören oder für Sie freigegeben wurden; anschließend können Sie eines an die Sitzung anhängen, im Browser öffnen oder dessen Link kopieren. Verfügbar, wo [Artefakte](/docs/de/artifacts#availability) verfügbar sind. Erfordert Claude Code v2.1.208 oder höher; das Anhängen mit `Enter` erfordert v2.1.216 |

62| `/auto-mode-setup` | [Entwurf `autoMode.environment` Einträge](/docs/de/auto-mode-config#generate-environment-entries) aus Ihrem Projekt und kürzlichen Sitzungen, überprüfen Sie dann den Entwurf und speichern Sie ihn in Ihren Benutzereinstellungen. Erfordert einen Pro-, Max- oder Team-Plan und Claude Code v2.1.228 oder später. Unter nativem Windows erfordert v2.1.233 oder später |62| `/auto-mode-setup` | [Erstellt Entwürfe für `autoMode.environment`-Einträge](/docs/de/auto-mode-config#generate-environment-entries) aus Ihrem Projekt und Ihren letzten Sitzungen; anschließend prüfen Sie den Entwurf und speichern ihn in Ihren Benutzereinstellungen. Erfordert einen Pro-, Max- oder Team-Plan und Claude Code v2.1.228 oder höher. Unter nativem Windows ist v2.1.233 oder höher erforderlich |

63| `/autocompact [auto\|<tokens>]` | Legen Sie das Auto-Compact-Fenster fest: wie voll das Kontextfenster wird, bevor Claude Code automatisch komprimiert. Übergeben Sie eine Größe wie `500k` oder `auto`, um zum für Ihr Modell optimierten Fenster zurückzukehren. Claude Code speichert den Wert in den Benutzereinstellungen und wendet ihn auf die aktuelle Sitzung an. Siehe [Auto-Compact-Fenster einstellen](/docs/de/model-config#set-the-auto-compact-window) für akzeptierte Werte und was es überschreibt. Ohne Argument öffnet sich ein Dialog, der das aktuelle Fenster anzeigt. Erfordert Claude Code v2.1.221 oder später |63| `/autocompact [auto\|<tokens>]` | Legt das Fenster für die automatische Komprimierung fest: wie voll das Kontextfenster werden darf, bevor Claude Code automatisch komprimiert. Übergeben Sie eine Größe wie `500k` oder `auto`, um zu dem für Ihr Modell abgestimmten Fenster zurückzukehren. Claude Code speichert den Wert in den Benutzereinstellungen und wendet ihn auf die aktuelle Sitzung an. Unter [Fenster für die automatische Komprimierung festlegen](/docs/de/model-config#set-the-auto-compact-window) finden Sie die akzeptierten Werte und was sie überschreibt. Ohne Argument wird ein Dialog geöffnet, der das aktuelle Fenster anzeigt. Erfordert Claude Code v2.1.221 oder höher |

64| `/autofix-pr [prompt]` | Starten Sie eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#auto-fix-pull-requests), die den PR des aktuellen Branches überwacht und Fixes pusht, wenn CI fehlschlägt oder Reviewer Kommentare hinterlassen. Erkennt den offenen PR aus Ihrem ausgecheckten Branch mit `gh pr view`; um einen anderen PR zu überwachen, checken Sie zuerst seinen Branch aus. Standardmäßig wird der Cloud-Sitzung mitgeteilt, jeden CI-Fehler und Review-Kommentar zu beheben; übergeben Sie einen Prompt, um ihr andere Anweisungen zu geben, z. B. `/autofix-pr only fix lint and type errors`. Erfordert die `gh` CLI und Zugriff auf [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) |64| `/autofix-pr [prompt]` | Startet eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#auto-fix-pull-requests), die den PR des aktuellen Branches überwacht und Korrekturen pusht, wenn CI fehlschlägt oder Reviewer Kommentare hinterlassen. Erkennt den offenen PR anhand Ihres ausgecheckten Branches mit `gh pr view`; um einen anderen PR zu überwachen, checken Sie zuerst dessen Branch aus. Standardmäßig wird die Cloud-Sitzung angewiesen, jeden CI-Fehler und jeden Review-Kommentar zu beheben; übergeben Sie einen Prompt, um ihr andere Anweisungen zu geben, zum Beispiel `/autofix-pr only fix lint and type errors`. Erfordert die `gh` CLI und Zugriff auf [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) |

65| `/background [prompt]` | Trennen Sie die aktuelle Sitzung, um als [Hintergrund-Agent](/docs/de/agent-view) zu laufen und dieses Terminal freizugeben. Übergeben Sie einen Prompt, um eine weitere Anweisung zu senden, bevor Sie trennen. Überwachen Sie die Sitzung mit `claude agents`. Um die Konversation in eine neue Hintergrund-Sitzung zu kopieren, während diese weiterläuft, verwenden Sie `/fork`. Alias: `/bg` |65| `/background [prompt]` | Trennt die aktuelle Sitzung ab, sodass sie als [Hintergrund-Agent](/docs/de/agent-view) läuft, und gibt dieses Terminal frei. Übergeben Sie einen Prompt, um vor dem Abtrennen noch eine weitere Anweisung zu senden. Überwachen Sie die Sitzung mit `claude agents`. Um die Konversation in eine neue Hintergrundsitzung zu kopieren, während diese weiterläuft, verwenden Sie `/fork`. Alias: `/bg` |

66| `/batch <instruction>` | **[Skill](/docs/de/skills#bundled-skills).** Orchestrieren Sie großflächige Änderungen über eine Codebasis parallel. Recherchiert die Codebasis, zerlegt die Arbeit in 5 bis 30 unabhängige Einheiten und präsentiert einen Plan. Nach Genehmigung startet es einen [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) pro Einheit in einem isolierten [Worktree](/docs/de/worktrees). Jeder Subagent implementiert seine Einheit, führt Tests aus und veröffentlicht seine Änderung. Erfordert ein Git-Repository oder einen [`WorktreeCreate` Hook](/docs/de/worktrees#non-git-version-control), der die Worktrees erstellt. Außerhalb eines Git-Repositories erfordert `/batch` Claude Code v2.1.281 oder später. Beispiel: `/batch migrate src/ from JavaScript to TypeScript` |66| `/batch <instruction>` | **[Skill](/docs/de/skills#bundled-skills).** Orchestriert umfangreiche Änderungen an einer Codebasis parallel. Untersucht die Codebasis, zerlegt die Arbeit in 5 bis 30 unabhängige Einheiten und legt einen Plan vor. Nach der Genehmigung wird pro Einheit ein [Hintergrund-Subagent](/docs/de/sub-agents#run-subagents-in-foreground-or-background) in einem isolierten [Worktree](/docs/de/worktrees) gestartet. Jeder Subagent implementiert seine Einheit, führt Tests aus und veröffentlicht seine Änderung. Erfordert ein Git-Repository oder einen [`WorktreeCreate`-Hook](/docs/de/worktrees#non-git-version-control), der die Worktrees erstellt. Außerhalb eines Git-Repositorys erfordert `/batch` Claude Code v2.1.281 oder höher. Beispiel: `/batch migrate src/ from JavaScript to TypeScript` |

67| `/branch [name]` | Erstellen Sie einen Branch der aktuellen Konversation an diesem Punkt, damit Sie eine andere Richtung versuchen können, ohne die Konversation zu verlieren. Wechselt Sie in den Branch und bewahrt das Original, zu dem Sie mit `/resume` zurückkehren können. Um eine Kopie stattdessen als separate [Hintergrund-Sitzung](/docs/de/agent-view) auszuführen, verwenden Sie `/fork`; um eine Nebenaufgabe an einen [Subagenten](/docs/de/sub-agents) zu übergeben, der in diese Konversation zurückberichtet, verwenden Sie `/subtask` |67| `/branch [name]` | Erstellt an dieser Stelle einen Konversationszweig der aktuellen Konversation, sodass Sie eine andere Richtung ausprobieren können, ohne die Konversation in ihrem aktuellen Stand zu verlieren. Wechselt Sie in den Zweig und bewahrt das Original auf, zu dem Sie mit `/resume` zurückkehren können. Um stattdessen eine Kopie als separate [Hintergrundsitzung](/docs/de/agent-view) auszuführen, ohne in sie zu wechseln, verwenden Sie `/fork`; um eine Nebenaufgabe an einen [Subagenten](/docs/de/sub-agents) zu übergeben, der in diese Konversation zurückberichtet, verwenden Sie `/subtask` |

68| `/btw [question]` | Stellen Sie eine [Nebenfrage](/docs/de/interactive-mode#side-questions-with-%2Fbtw) zur aktuellen Sitzung, ohne sie zur Konversation hinzuzufügen. Wenn Sie `/btw` ohne Frage ausführen, zeigt Claude Code Ihre letzte Nebenfrage an, damit Sie frühere Antworten durchsuchen können; wenn Sie noch keine gestellt haben, gibt Claude Code eine Nutzungszeile aus. Vor v2.1.212 erforderte `/btw` eine Frage |68| `/btw [question]` | Stellt eine [Nebenfrage](/docs/de/interactive-mode#side-questions-with-%2Fbtw) zur aktuellen Sitzung, ohne sie der Konversation hinzuzufügen. Wenn Sie `/btw` ohne Frage ausführen, zeigt Claude Code Ihre letzte Nebenfrage an, damit Sie frühere Antworten durchsehen können; wenn Sie noch keine gestellt haben, gibt Claude Code eine Verwendungszeile aus. Vor v2.1.212 erforderte `/btw` eine Frage |

69| `/bug [report]` | Melden Sie einen Bug oder teilen Sie Ihre Konversation. Sie wählen, wie viel Sitzungsverlauf einzubeziehen ist, und bestätigen auf einem Zustimmungsbildschirm, bevor etwas gesendet wird. Wenn Sie bei einer Anthropic-Verbindung von Anthropic angemeldet sind, geht der Bericht an Anthropic; bei einem Drittanbieter oder ohne Anthropic-Anmeldedaten schreibt Claude Code den Bericht in ein [lokales Archiv unter `~/.claude/feedback-bundles/`](/docs/de/data-usage#telemetry-services), das Sie selbst weiterleiten. In der [VS Code-Erweiterung](/docs/de/vs-code#use-the-prompt-box) öffnet `/bug` stattdessen den eigenen Feedback-Dialog der Erweiterung; erfordert Claude Code v2.1.229 oder später. Wenn Sie ihn ausführen, während Claude antwortet, öffnet Claude Code den Dialog sofort. Vor v2.1.232 wartete Claude Code mit dem Befehl, bis die Runde beendet war. Alias: `/share`. Vor v2.1.212 waren `/bug` und `/share` Aliase von `/feedback` |69| `/bug [report]` | Meldet einen Fehler oder teilt Ihre Konversation. Sie wählen, wie viel des Sitzungsverlaufs einbezogen wird, und bestätigen auf einem Einwilligungsbildschirm, bevor etwas gesendet wird. Wenn Sie über eine First-Party-Verbindung bei Anthropic angemeldet sind, geht der Bericht an Anthropic; bei einem Drittanbieter oder ohne Anthropic-Anmeldedaten schreibt Claude Code den Bericht in ein [lokales Archiv unter `~/.claude/feedback-bundles/`](/docs/de/data-usage#telemetry-services), das Sie selbst weiterleiten. In der [VS Code-Erweiterung](/docs/de/vs-code#use-the-prompt-box) öffnet `/bug` stattdessen den eigenen Feedback-Dialog der Erweiterung; erfordert Claude Code v2.1.229 oder höher. Wenn Sie den Befehl ausführen, während Claude antwortet, öffnet Claude Code den Dialog sofort. Vor v2.1.232 hat Claude Code den Befehl in die Warteschlange gestellt, bis der Turn beendet war. Alias: `/share`. Vor v2.1.212 waren `/bug` und `/share` Aliasse von `/feedback` |

70| `/cd <path>` | Verschieben Sie diese Sitzung in ein neues Arbeitsverzeichnis und behalten Sie die Konversation. Geben Sie einen Teilpfad ein, um passende Verzeichnisvorschläge zu sehen; drücken Sie `Tab`, um einen zu akzeptieren. Die Vorschläge erfordern Claude Code v2.1.206 oder später. Für das, was Claude Code aus dem neuen Verzeichnis sofort anwendet, wenn Sie sich verschieben, und wie sich `/cd` von `/add-dir` unterscheidet, siehe [Sitzung in ein anderes Verzeichnis verschieben](/docs/de/permissions#move-the-session-to-another-directory) |70| `/cd <path>` | Verschiebt diese Sitzung in ein neues Arbeitsverzeichnis und behält die Konversation bei. Geben Sie einen Teilpfad ein, um passende Verzeichnisvorschläge zu sehen; drücken Sie `Tab`, um einen davon zu übernehmen. Die Vorschläge erfordern Claude Code v2.1.206 oder höher. Was Claude Code aus dem neuen Verzeichnis übernimmt, sobald Sie wechseln, und wie sich `/cd` von `/add-dir` unterscheidet, erfahren Sie unter [Sitzung in ein anderes Verzeichnis verschieben](/docs/de/permissions#move-the-session-to-another-directory) |

72| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](/docs/de/skills#bundled-skills).** Laden Sie [Claude API](https://platform.claude.com/docs/en/api/overview) und [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) Referenzmaterial für die Sprache Ihres Projekts. Wird auch automatisch aktiviert, wenn Ihr Code `anthropic` oder `@anthropic-ai/sdk` importiert. Für das, was jeder Unterbefehl tut und welche Version er erfordert, siehe [An Claude API-Projekten arbeiten](/docs/de/skills#work-on-claude-api-projects) |72| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](/docs/de/skills#bundled-skills).** Lädt Referenzmaterial zur [Claude API](https://platform.claude.com/docs/en/api/overview) und zu [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) für die Sprache Ihres Projekts. Wird auch automatisch aktiviert, wenn Ihr Code `anthropic` oder `@anthropic-ai/sdk` importiert. Was jeder Unterbefehl tut und welche Version er erfordert, erfahren Sie unter [An Claude API-Projekten arbeiten](/docs/de/skills#work-on-claude-api-projects) |

73| `/claude-in-chrome [task]` | **[Skill](/docs/de/skills#bundled-skills).** Lassen Sie Claude eine Aufgabe in Ihrem Browser ausführen, wie z. B. das Testen einer Seite, das Ausfüllen eines Formulars oder das Lesen von Konsolenprotokollen, über [Claude in Chrome](/docs/de/chrome). Verfügbar, wenn die Chrome-Integration für die Sitzung aktiviert ist, z. B. mit `claude --chrome`, oder wenn Claude Code anbieten kann, die [Erweiterung zu installieren](/docs/de/chrome#install-the-extension-when-claude-asks) |73| `/claude-in-chrome [task]` | **[Skill](/docs/de/skills#bundled-skills).** Lässt Claude über [Claude in Chrome](/docs/de/chrome) eine Aufgabe in Ihrem Browser ausführen, etwa eine Seite testen, ein Formular ausfüllen oder Konsolen-Logs lesen. Verfügbar, wenn die Chrome-Integration für die Sitzung aktiviert ist, zum Beispiel mit `claude --chrome`, oder wenn Claude Code anbieten kann, [die Erweiterung zu installieren](/docs/de/chrome#install-the-extension-when-claude-asks) |

74| `/clear [name]` | Starten Sie eine neue Konversation mit leerem Kontext. Übergeben Sie einen Namen, um die vorherige Konversation in der `/resume` Auswahl zu kennzeichnen. Um Kontext freizugeben und gleichzeitig die gleiche Konversation fortzusetzen, verwenden Sie stattdessen `/compact`. Setzen Sie die vorherige Konversation mit `/resume` fort, oder stellen Sie sie in demselben Claude Code-Prozess aus [dem Rewind-Menü-Eintrag der vorherigen Sitzung](/docs/de/checkpointing#rewind-past-a-cleared-conversation) wieder her. Aliase: `/reset`, `/new` |74| `/clear [name]` | Startet eine neue Konversation mit leerem Kontext. Übergeben Sie einen Namen, um die vorherige Konversation in der `/resume`-Auswahl zu benennen. Um Kontext freizugeben und dabei dieselbe Konversation fortzusetzen, verwenden Sie stattdessen `/compact`. Setzen Sie die vorherige Konversation mit `/resume` fort oder stellen Sie sie im selben Claude Code-Prozess über [den Eintrag für die vorherige Sitzung im Rewind-Menü](/docs/de/checkpointing#rewind-past-a-cleared-conversation) wieder her. Aliasse: `/reset`, `/new` |

75| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/de/skills#bundled-skills).** Überprüfen Sie den aktuellen Diff oder eine PR-Nummer, einen Branch oder einen Pfad, den Sie übergeben, auf Korrektheitsfehler. Je nach Ihrem Modell und Aufwandsniveau deckt die Überprüfung auch Bereinigungsmöglichkeiten ab. Übergeben Sie `--fix`, um Erkenntnisse anzuwenden, `--comment`, um sie auf dem GitHub PR oder GitLab Merge Request zu posten, oder `ultra`, um eine tiefe [Cloud-Überprüfung](/docs/de/ultrareview) auszuführen. Das Posten auf einem GitLab Merge Request erfordert Claude Code v2.1.257 oder später. Mit `ultra` auf einem `github.com` PR-Ziel übergeben Sie `--post`, um [das Posten der fertigen Erkenntnisse auf dem PR](/docs/de/ultrareview#post-findings-to-the-pull-request) im Startdialog vorzuwählen; `--post` erfordert Claude Code v2.1.227 oder später. Siehe [Diff lokal überprüfen](/docs/de/code-review#review-a-diff-locally) für die Aufwandsstufen, Zielbestimmung und wie es sich auf `/simplify` bezieht. Alias: `/review` |75| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/de/skills#bundled-skills).** Prüft den aktuellen Diff oder eine übergebene PR-Nummer, einen Branch oder Pfad auf Korrektheitsfehler. Je nach Modell und Effort-Stufe umfasst das Review auch Möglichkeiten zur Bereinigung. Übergeben Sie `--fix`, um die Ergebnisse anzuwenden, `--comment`, um sie im GitHub-PR oder GitLab-Merge-Request zu posten, oder `ultra`, um ein tiefgehendes [Cloud-Review](/docs/de/ultrareview) auszuführen. Das Posten in einem GitLab-Merge-Request erfordert Claude Code v2.1.257 oder höher. Übergeben Sie bei `ultra` mit einem `github.com`-PR als Ziel `--post`, um im Startdialog das [Posten der fertigen Ergebnisse im PR](/docs/de/ultrareview#post-findings-to-the-pull-request) vorab auszuwählen; `--post` erfordert Claude Code v2.1.227 oder höher. Unter [Einen Diff lokal prüfen](/docs/de/code-review#review-a-diff-locally) finden Sie die Effort-Stufen, die Zielauswahl und das Verhältnis zu `/simplify`. Alias: `/review` |

76| `/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 zu wählen. Wenn [Remote Control](/docs/de/remote-control) verbunden ist, wird die Farbe mit claude.ai/code synchronisiert. Auch im nicht-interaktiven Modus (`-p`) verfügbar; erfordert Claude Code v2.1.205 oder später |76| `/color [color\|default]` | Legt die Farbe der Eingabeleiste für die aktuelle Sitzung fest. Verfügbare Farben: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Verwenden Sie `default` zum Zurücksetzen oder führen Sie den Befehl ohne Argument aus, um eine zufällige Farbe zu wählen. Wenn [Remote Control](/docs/de/remote-control) verbunden ist, wird die Farbe mit claude.ai/code synchronisiert. Auch im nicht interaktiven Modus (`-p`) verfügbar; erfordert Claude Code v2.1.205 oder höher |

77| `/compact [instructions]` | Geben Sie Kontext frei, indem Sie die bisherige Konversation zusammenfassen. Übergeben Sie optional Fokusanweisungen für die Zusammenfassung. Siehe [wie Komprimierung Regeln, Skills und Memory-Dateien handhabt](/docs/de/context-window#what-survives-compaction) |77| `/compact [instructions]` | Gibt Kontext frei, indem die bisherige Konversation zusammengefasst wird. Optional können Sie Fokusanweisungen für die Zusammenfassung übergeben. Siehe [wie die Komprimierung mit Regeln, Skills und Memory-Dateien umgeht](/docs/de/context-window#what-survives-compaction) |

78| `/config [key=value ...]` | Öffnen Sie die [Einstellungen](/docs/de/settings) Schnittstelle, um Design, Modell, [Ausgabestil](/docs/de/output-styles) und andere Voreinstellungen anzupassen. Übergeben Sie ein oder mehrere `key=value` Paare, um eine Einstellung direkt ohne Öffnen der Schnittstelle zu setzen, z. B. `/config thinking=false`, `/config theme=dark` oder `/config model=sonnet`. Das `key=value` Formular funktioniert auch im nicht-interaktiven Modus (`-p`) und aus der Claude Mobile App über [Remote Control](/docs/de/remote-control). Das `key=value` Formular kann eine Einstellung, die Ihre Bestätigung im Panel benötigt, nicht aktivieren, wie z. B. [`autoContinueAtUsageLimit`](/docs/de/interactive-mode#turn-automatic-continue-off), kann sie aber ausschalten. Führen Sie `/config --help` aus, um die Schlüssel aufzulisten, die es akzeptiert. Alias: `/settings` |78| `/config [key=value ...]` | Öffnet die Oberfläche für [Einstellungen](/docs/de/settings), um Design, Modell, [Ausgabestil](/docs/de/output-styles) und weitere Präferenzen anzupassen. Übergeben Sie ein oder mehrere `key=value`-Paare, um eine Einstellung direkt festzulegen, ohne die Oberfläche zu öffnen, zum Beispiel `/config thinking=false`, `/config theme=dark` oder `/config model=sonnet`. Die `key=value`-Form funktioniert auch im nicht interaktiven Modus (`-p`) und aus der Claude-Mobile-App über [Remote Control](/docs/de/remote-control). Mit der `key=value`-Form können Sie keine Einstellung einschalten, die Ihre Bestätigung im Panel erfordert, etwa [`autoContinueAtUsageLimit`](/docs/de/interactive-mode#turn-automatic-continue-off), wohl aber ausschalten. Führen Sie `/config --help` aus, um die akzeptierten Schlüssel aufzulisten. Alias: `/settings` |

79| `/context [all]` | Visualisieren Sie die aktuelle Kontextnutzung als farbiges Gitter. Zeigt Optimierungsvorschläge für kontextintensive Tools, Memory-Übergewicht und Kapazitätswarnungen. Wenn die Konversation das Kontextfenster überschreitet, enthält die Ausgabe eine [Warnung](/docs/de/errors#context-exceeds-the-token-limit), die zeigt, wie weit über dem Limit Sie sind und welcher Befehl Platz freimacht. Im [Vollbildmodus](/docs/de/fullscreen) bricht `/context` die Aufschlüsselung pro Element zusammen, um das Gitter sichtbar zu halten. Übergeben Sie `all`, um es zu erweitern |79| `/context [all]` | Visualisiert die aktuelle Kontextnutzung als farbiges Raster. Zeigt Optimierungsvorschläge für kontextintensive Tools, aufgeblähtes Memory und Kapazitätswarnungen an. Wenn die Konversation das Kontextfenster überschreitet, enthält die Ausgabe eine [Warnung](/docs/de/errors#context-exceeds-the-token-limit), die anzeigt, wie weit Sie über dem Limit liegen und welcher Befehl Platz freigibt. Im [Vollbildmodus](/docs/de/fullscreen) klappt `/context` die Aufschlüsselung pro Element zusammen, damit das Raster sichtbar bleibt. Übergeben Sie `all`, um sie aufzuklappen |

80| `/copy [N]` | Kopieren Sie die letzte Antwort des Assistenten in die Zwischenablage. Übergeben Sie eine Nummer `N`, um die N-te letzte Antwort zu kopieren: `/copy 2` kopiert die vorletzte. Wenn Code-Blöcke vorhanden sind, zeigt sich eine interaktive Auswahl, um einzelne Blöcke oder die vollständige Antwort auszuwählen. Drücken Sie `w` in der Auswahl, um die Auswahl stattdessen in eine Datei zu schreiben, was über SSH nützlich ist |80| `/copy [N]` | Kopiert die letzte Antwort des Assistenten in die Zwischenablage. Übergeben Sie eine Zahl `N`, um die N-letzte Antwort zu kopieren: `/copy 2` kopiert die vorletzte. Wenn Codeblöcke vorhanden sind, wird eine interaktive Auswahl angezeigt, in der Sie einzelne Blöcke oder die vollständige Antwort auswählen können. Drücken Sie in der Auswahl `w`, um die Auswahl in eine Datei statt in die Zwischenablage zu schreiben, was über SSH nützlich ist |

81| `/cost` | Alias für `/usage` |81| `/cost` | Alias für `/usage` |

82| `/dataviz [request]` | **[Skill](/docs/de/skills#bundled-skills).** Designanleitung für Diagramme, Grafiken und Dashboards. Claude wählt die Diagrammform für die Daten, weist Farbe nach Rolle zu, validiert die Palette auf Farbenblindheit-Sicherheit und Kontrast mit einem gebündelten Skript und wendet Markierungs-, Interaktions- und Barrierefreiheitsregeln an. Verwendet eine markenfreie Platzhalterpalette, die Sie durch Ihre eigene ersetzen. Erfordert Claude Code v2.1.198 oder später |82| `/dataviz [request]` | **[Skill](/docs/de/skills#bundled-skills).** Gestaltungsrichtlinien für Diagramme, Grafiken und Dashboards. Claude wählt die Diagrammform passend zu den Daten, weist Farben nach Rolle zu, prüft die Palette mit einem mitgelieferten Skript auf Farbenblindheitstauglichkeit und Kontrast und wendet Regeln für Markierungen, Interaktion und Barrierefreiheit an. Verwendet eine markenneutrale Platzhalterpalette, die Sie durch Ihre eigene ersetzen. Erfordert Claude Code v2.1.198 oder höher |

83| `/debug [description]` | **[Skill](/docs/de/skills#bundled-skills).** Aktivieren Sie Debug-Protokollierung für die aktuelle Sitzung und beheben Sie Probleme durch Lesen des Sitzungs-Debug-Protokolls. Debug-Protokollierung ist standardmäßig deaktiviert, es sei denn, Sie haben mit `claude --debug` gestartet, daher startet die Ausführung von `/debug` in der Mitte der Sitzung die Erfassung von Protokollen von diesem Punkt an. Beschreiben Sie optional das Problem, um die Analyse zu fokussieren |83| `/debug [description]` | **[Skill](/docs/de/skills#bundled-skills).** Aktiviert das Debug-Logging für die aktuelle Sitzung und behebt Probleme durch Lesen des Debug-Logs der Sitzung. Das Debug-Logging ist standardmäßig deaktiviert, sofern Sie nicht mit `claude --debug` gestartet haben; wenn Sie `/debug` mitten in der Sitzung ausführen, werden Logs also ab diesem Zeitpunkt erfasst. Beschreiben Sie optional das Problem, um die Analyse darauf zu fokussieren |

84| `/deep-research <question>` | **[Workflow](/docs/de/workflows#bundled-workflows).** Verteilen Sie Web-Suchen zu einer Frage, rufen Sie Quellen ab und überprüfen Sie sie, und synthetisieren Sie einen zitierten Bericht |84| `/deep-research <question>` | **[Workflow](/docs/de/workflows#bundled-workflows).** Führt zu einer Frage breit gefächerte Websuchen durch, ruft Quellen ab, gleicht sie ab und fasst sie in einem Bericht mit Quellenangaben zusammen |

85| `/design [brief]` | **[Skill](/docs/de/skills#bundled-skills).** Entwerfen Sie UI-Mockups, Bildschirmabläufe, Landing Pages oder Poster als Artboards auf einer Leinwand, veröffentlicht als Claude Design [Artefakt](/docs/de/artifacts#draft-a-design-canvas), z. B. `/design a settings screen for a mobile banking app`. Sie bearbeiten die Artboards in einem Desktop-Browser und Ihre Änderungen werden automatisch gespeichert. Sie können jedes Artboard als PNG oder PDF exportieren. Erfordert Claude Code v2.1.265 oder später, eine Sitzung, in der [Artefakte verfügbar sind](/docs/de/artifacts#availability), und ein Konto, in dem die [Design-Vorlage verfügbar ist](/docs/de/artifacts#start-from-a-slides-design-or-docs-template); wenn Ihre Organisation diese Vorlage deaktiviert hat, ist `/design` dort nicht verfügbar. Verfügbar auf der Anthropic API. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS sind Artefakte nicht verfügbar, daher ist der Befehl dort nicht verfügbar |85| `/design [brief]` | **[Skill](/docs/de/skills#bundled-skills).** Erstellt Entwürfe für UI-Mockups, Bildschirmabläufe, Landingpages oder Poster als Artboards auf einer Leinwand, veröffentlicht als Claude Design-[Artefakt](/docs/de/artifacts#draft-a-design-canvas), zum Beispiel `/design a settings screen for a mobile banking app`. Sie bearbeiten die Artboards in einem Desktop-Browser, und Ihre Änderungen werden automatisch gespeichert. Sie können jedes Artboard als PNG oder PDF exportieren. Erfordert Claude Code v2.1.265 oder höher, eine Sitzung, in der [Artefakte verfügbar sind](/docs/de/artifacts#availability), und ein Konto, in dem die [Design-Vorlage verfügbar ist](/docs/de/artifacts#start-from-a-slides-design-or-docs-template); wenn Ihre Organisation diese Vorlage deaktiviert hat, erstellt `/design` keine Designentwürfe. Verfügbar über die Anthropic API. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS sind Artefakte nicht verfügbar, daher ist der Befehl dort nicht verfügbar |

87| `/design-sync [hint]` | **[Skill](/docs/de/skills#bundled-skills).** Konvertieren Sie das React-Design-System Ihres Repos und laden Sie es auf [Claude Design](https://claude.ai/design) hoch, damit die Designs, die es produziert, Ihre echten Komponenten verwenden. Benennen Sie optional das Design-System, z. B. `/design-sync Acme DS`. Eine erste Synchronisierung überprüft jede Komponente und kann auf einem großen Repo mehrere Stunden dauern. Verfügbar auf der Anthropic API. Es benötigt claude.ai, das die CLI nicht auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform auf AWS oder über ein [Claude Apps Gateway](/docs/de/claude-apps-gateway#availability-and-limitations) kontaktiert, daher ist der Befehl dort nicht verfügbar |87| `/design-sync [hint]` | **[Skill](/docs/de/skills#bundled-skills).** Konvertiert das React-Designsystem Ihres Repositorys und lädt es in [Claude Design](https://claude.ai/design) hoch, sodass die dort erstellten Designs Ihre echten Komponenten verwenden. Benennen Sie optional das Designsystem, zum Beispiel `/design-sync Acme DS`. Eine erstmalige Synchronisierung prüft jede Komponente und kann bei einem großen Repository einige Stunden dauern. Verfügbar über die Anthropic API. Der Befehl benötigt claude.ai, das die CLI auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform on AWS sowie über ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway#availability-and-limitations) nicht kontaktiert, daher ist der Befehl dort nicht verfügbar |

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

89| `/diff` | Überprüfen Sie die Änderungen in Ihrem Arbeitsbaum, einschließlich der bisherigen Änderungen von Claude. Siehe [Änderungen mit /diff überprüfen](/docs/de/interactive-mode#review-changes-with-%2Fdiff) |89| `/diff` | Prüft die Änderungen in Ihrem Arbeitsbaum, einschließlich der bisherigen Bearbeitungen durch Claude. Siehe [Änderungen mit /diff prüfen](/docs/de/interactive-mode#review-changes-with-%2Fdiff) |

90| `/doctor [prompt-audit [path]]` | **[Skill](/docs/de/skills#bundled-skills).** Führen Sie eine Setup-Überprüfung aus, die Probleme diagnostiziert und beheben kann. Überprüft die Installationsintegrität, einschließlich doppelter oder verbleibender Installationen, `PATH` Probleme und nicht analysierbare Einstellungsdateien. Findet ungenutzte Skills, MCP-Server und Plugins im Vergleich zu ihren Kontextkosten, kennzeichnet langsame [Hooks](/docs/de/hooks) und prüft auf eine neuere Version auf Ihrem [Release-Kanal](/docs/de/setup#configure-release-channel). Dedupliziert lokale `CLAUDE.md` Dateien gegen eingecheckte, trimmt eingecheckte [`CLAUDE.md`](/docs/de/memory#my-claude-md-is-too-large) Dateien durch Schneiden von Inhalten, die Claude aus der Codebasis ableiten könnte, und migriert die immer geladene Anleitung, die bleibt, in [Skills](/docs/de/skills) und verschachtelte `CLAUDE.md` Dateien, die bei Bedarf geladen werden. Bietet auch an, [Auto-Modus](/docs/de/permissions#permission-modes) zu Ihrem Standard zu machen und häufig abgelehnte schreibgeschützte Befehle [vorab zu genehmigen](/docs/de/permissions). Meldet Erkenntnisse zuerst und fragt um Bestätigung, bevor etwas geändert wird. Vom Terminal gibt `claude doctor` schreibgeschützte Installationsdiagnostiken aus, ohne eine Sitzung zu starten. Alias: `/checkup`. Führen Sie `/doctor prompt-audit` aus, um Claude [Ihre `CLAUDE.md` Dateien, Skills und andere Konfiguration](/docs/de/memory#audit-your-instruction-files) auf veraltete oder widersprüchliche Anweisungen zu überprüfen, anstatt die Überprüfung auszuführen. Der `prompt-audit` Unterbefehl erfordert Claude Code v2.1.283 oder später. Die `CLAUDE.md` Trim-Überprüfung erfordert Claude Code v2.1.206 oder später. Vor v2.1.205 öffnete `/doctor` einen schreibgeschützten Diagnosebildschirm und das Drücken von `f` sendete den Bericht an Claude |90| `/doctor [prompt-audit [path]]` | **[Skill](/docs/de/skills#bundled-skills).** Führt einen Setup-Check durch, der Probleme diagnostiziert und beheben kann. Prüft den Zustand der Installation, einschließlich doppelter oder übrig gebliebener Installationen, `PATH`-Problemen und nicht parsbarer Einstellungsdateien. Findet ungenutzte Skills, MCP-Server und Plugins im Verhältnis zu ihren Kontextkosten, kennzeichnet langsame [Hooks](/docs/de/hooks) und prüft, ob auf Ihrem [Release-Kanal](/docs/de/setup#configure-release-channel) eine neuere Version vorliegt. Dedupliziert lokale `CLAUDE.md`-Dateien gegenüber eingecheckten, kürzt eingecheckte [`CLAUDE.md`](/docs/de/memory#my-claude-md-is-too-large)-Dateien, indem Inhalte entfernt werden, die Claude aus der Codebasis ableiten könnte, und verschiebt die verbleibenden, stets geladenen Anweisungen in [Skills](/docs/de/skills) und verschachtelte `CLAUDE.md`-Dateien, die bei Bedarf geladen werden. Bietet außerdem an, den [Auto-Modus](/docs/de/permissions#permission-modes) zu Ihrem Standard zu machen und häufig abgelehnte, nur lesende Befehle [vorab zu genehmigen](/docs/de/permissions). Meldet zuerst die Ergebnisse und bittet um Bestätigung, bevor etwas geändert wird. Im Terminal gibt `claude doctor` schreibgeschützte Installationsdiagnosen aus, ohne eine Sitzung zu starten. Alias: `/checkup`. Führen Sie `/doctor prompt-audit` aus, damit Claude statt des Checks [Ihre `CLAUDE.md`-Dateien, Skills und sonstige Konfiguration](/docs/de/memory#audit-your-instruction-files) auf veraltete oder widersprüchliche Anweisungen prüft. Der Unterbefehl `prompt-audit` erfordert Claude Code v2.1.283 oder höher. Die Kürzungsprüfung für `CLAUDE.md` erfordert Claude Code v2.1.206 oder höher. Vor v2.1.205 öffnete `/doctor` einen schreibgeschützten Diagnosebildschirm, und durch Drücken von `f` wurde der Bericht an Claude gesendet |

91| `/effort [level\|auto\|status\|ultracode [on\|off]]` | Legen Sie die [Aufwandsstufe](/docs/de/model-config#adjust-effort-level) fest: `low` bis `xhigh`, `max` oder `auto`; `status` gibt sie aus. `ultracode` oder `ultracode on` schaltet [ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) für die Sitzung auf der aktuellen Stufe ein, und `ultracode off` schaltet es aus; der [`ultracode`](/docs/de/settings-reference#ultracode) Schlüssel bleibt erhalten. `max` ist nur für die Sitzung. Die `on` und `off` Argumente und das Beibehalten der aktuellen Stufe erfordern Claude Code v2.1.284 oder später. Vor v2.1.284 setzte `/effort ultracode` die Sitzung auf `xhigh` und `/effort ultracode off` schlug mit `Invalid argument` fehl. Führen Sie es aus, während Claude antwortet, und sobald Sie die [Cache-Warnung](/docs/de/prompt-caching#changing-effort-level) bestätigen, wenn Claude Code eine anzeigt, wendet Claude Code die neue Stufe auf die nächste Anfrage in dieser Runde an. Vor v2.1.242 entschied Claude Code anhand eines Feature-Flags, das es von Anthropic abrief, ob der Befehl in der Mitte der Runde oder bis zum Ende der Runde ausgeführt werden sollte, und wartete immer in einer Sitzung, die keine [Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching), wie auf einem [Drittanbieter](/docs/de/third-party-integrations). Funktioniert in `-p` |91| `/effort [level\|auto\|status\|ultracode [on\|off]]` | Legt die [Effort-Stufe](/docs/de/model-config#adjust-effort-level) fest: `low` bis `xhigh`, `max` oder `auto`; `status` gibt sie aus. `ultracode` oder `ultracode on` schaltet [ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) für die Sitzung auf der aktuellen Stufe ein, und `ultracode off` schaltet es aus; der Schlüssel [`ultracode`](/docs/de/settings-reference#ultracode) bleibt dauerhaft erhalten. `max` gilt nur für die Sitzung. Die Argumente `on` und `off` sowie das Beibehalten der aktuellen Stufe erfordern Claude Code v2.1.284 oder höher. Vor v2.1.284 setzte `/effort ultracode` die Sitzung auf `xhigh`, und `/effort ultracode off` schlug mit `Invalid argument` fehl. Führen Sie den Befehl aus, während Claude antwortet, und sobald Sie die [Cache-Warnung](/docs/de/prompt-caching#changing-effort-level) bestätigen, falls Claude Code eine anzeigt, wendet Claude Code die neue Stufe auf die nächste Anfrage in diesem Turn an. Vor v2.1.242 entschied Claude Code anhand eines von Anthropic abgerufenen Feature-Flags, ob der Befehl mitten im Turn ausgeführt oder bis zum Ende des Turns in die Warteschlange gestellt wird, und stellte ihn in einer Sitzung, die [keine Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching), etwa bei einem [Drittanbieter](/docs/de/third-party-integrations), immer in die Warteschlange. Funktioniert in `-p` |

~~92| `/exit` | Beenden Sie die CLI. In einer angehängten [Hintergrund-Sitzung](/docs/de/agent-view#attach-to-a-session) trennt dies ab und die Sitzung läuft weiter. Alias: `/quit` |~~92| `/exit` | Beendet die CLI. In einer angehängten [Hintergrundsitzung](/docs/de/agent-view#attach-to-a-session) wird die Sitzung dadurch abgetrennt und läuft weiter. Alias: `/quit` |

93| `/export [filename]` | Exportieren Sie die aktuelle Konversation als Klartext. Mit einem Dateinamen schreibt direkt in diese Datei. Ohne öffnet einen Dialog zum Kopieren in die Zwischenablage oder Speichern in einer Datei |93| `/export [filename]` | Exportiert die aktuelle Konversation als reinen Text. Mit einem Dateinamen wird direkt in diese Datei geschrieben. Ohne Dateinamen wird ein Dialog geöffnet, um in die Zwischenablage zu kopieren oder in einer Datei zu speichern |

94| `/fast [on\|off]` | Schalten Sie [Fast-Modus](/docs/de/fast-mode) ein oder aus. Führen Sie ihn aus, während Claude antwortet, und Claude Code schaltet den Fast-Modus um, ohne auf das Ende der Runde zu warten, obwohl die laufende Runde mit ihrer ursprünglichen Geschwindigkeit endet. Vor v2.1.242 entschied Claude Code anhand eines Feature-Flags, das es von Anthropic abrief, ob der Befehl in der Mitte der Runde oder bis zum Ende der Runde ausgeführt werden sollte, und wartete immer in einer Sitzung, die keine [Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching). Die Verfügbarkeit im nicht-interaktiven Modus mit `-p` ist begrenzt; siehe [Fast-Modus umschalten](/docs/de/fast-mode#toggle-fast-mode). Erfordert Claude Code v2.1.205 oder später |94| `/fast [on\|off]` | Schaltet den [Fast-Modus](/docs/de/fast-mode) ein oder aus. Führen Sie den Befehl aus, während Claude antwortet, und Claude Code schaltet den Fast-Modus um, ohne auf das Ende des Turns zu warten, wobei der laufende Turn mit seiner ursprünglichen Geschwindigkeit abgeschlossen wird. Vor v2.1.242 entschied Claude Code anhand eines von Anthropic abgerufenen Feature-Flags, ob der Befehl mitten im Turn ausgeführt oder bis zum Ende des Turns in die Warteschlange gestellt wird, und stellte ihn in einer Sitzung, die [keine Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching), immer in die Warteschlange. Die Verfügbarkeit im nicht interaktiven Modus mit `-p` ist eingeschränkt; siehe [Fast-Modus umschalten](/docs/de/fast-mode#toggle-fast-mode). Erfordert Claude Code v2.1.205 oder höher |

95| `/feedback [report]` | Senden Sie Produktfeedback zu Claude Code. Öffnet denselben Dialog wie [`/bug`](#all-commands), mit denselben Zustimmungsschritten, Senderegeln und Verhalten in der Mitte der Runde. In Sitzungen mit [Claude-entworfenes Feedback](/docs/de/tools-reference#sendfeedback-tool-behavior) öffnet `/feedback` ohne Argument stattdessen die Entwurfswarteschlange, in der Sie die Entwürfe überprüfen, bearbeiten, senden oder verwerfen, die Claude in die Warteschlange gestellt hat; die Warteschlange enthält eine Option, einen neuen Bericht im Dialog zu schreiben. Mit einem Argument und für `/bug` immer öffnet sich der Dialog direkt |95| `/feedback [report]` | Sendet Produktfeedback zu Claude Code. Öffnet denselben Dialog wie [`/bug`](#all-commands), mit demselben Einwilligungsschritt, denselben Senderegeln und demselben Verhalten mitten im Turn. In Sitzungen mit [von Claude entworfenem Feedback](/docs/de/tools-reference#sendfeedback-tool-behavior) öffnet `/feedback` ohne Argument stattdessen die Warteschlange der Entwürfe, in der Sie die von Claude eingereihten Entwürfe prüfen, bearbeiten, senden oder verwerfen; die Warteschlange enthält eine Option, im Dialog einen neuen Bericht zu schreiben. Mit einem Argument und bei `/bug` immer wird der Dialog direkt geöffnet |

96| `/fewer-permission-prompts` | **[Skill](/docs/de/skills#bundled-skills).** Scannen Sie Ihre Transkripte auf häufige schreibgeschützte Bash- und MCP-Tool-Aufrufe und fügen Sie dann eine priorisierte Zulassungsliste zu Projekt `.claude/settings.json` hinzu, um Berechtigungsaufforderungen zu reduzieren |96| `/fewer-permission-prompts` | **[Skill](/docs/de/skills#bundled-skills).** Durchsucht Ihre Transkripte nach häufigen nur lesenden Bash- und MCP-Tool-Aufrufen und fügt dann eine priorisierte Allowlist zur Projektdatei `.claude/settings.json` hinzu, um Berechtigungsabfragen zu reduzieren |

97| `/focus` | Schalten Sie die Fokusansicht um, die nur Ihren letzten Prompt, eine einzeilige Tool-Aufruf-Zusammenfassung mit Bearbeitungs-Diffstats und die endgültige Antwort anzeigt. Die Tool-Aufruf-Zusammenfassung zählt auch die in der Runde gestarteten Subagenten und bricht abgeschlossene Hintergrund-Task-Benachrichtigungen in eine einzelne Anzahl zusammen. Die Auswahl bleibt über Sitzungen hinweg erhalten; setzen Sie [`viewMode`](/docs/de/settings-reference#viewmode) in Einstellungen, um sie zu überschreiben. Nur im [Vollbild-Rendering](/docs/de/fullscreen) verfügbar. Von einem [Remote Control](/docs/de/remote-control) Client führen Sie `/focus [on\|off]` aus, um die Fokusansicht für die aktuelle Sitzung nur ein- oder auszuschalten, ohne Ihre gespeicherte Auswahl zu ändern; dies erfordert Claude Code v2.1.281 oder später. Die [VS Code-Erweiterung](/docs/de/vs-code#use-the-prompt-box) bietet ihre eigene Fokusansicht als Befehlsmenü-Umschalter, gespeichert als Erweiterungseinstellung, unabhängig von `viewMode` |97| `/focus` | Schaltet die Fokusansicht um, die nur Ihren letzten Prompt, eine einzeilige Zusammenfassung der Tool-Aufrufe mit Diffstats der Bearbeitungen und die abschließende Antwort anzeigt. Die Zusammenfassung der Tool-Aufrufe zählt außerdem die im Turn gestarteten Subagenten und fasst Benachrichtigungen über abgeschlossene Hintergrundaufgaben zu einer einzigen Anzahl zusammen. Die Auswahl bleibt sitzungsübergreifend erhalten; setzen Sie [`viewMode`](/docs/de/settings-reference#viewmode) in den Einstellungen, um sie zu überschreiben. Nur im [Vollbild-Rendering](/docs/de/fullscreen) verfügbar. Führen Sie von einem [Remote Control](/docs/de/remote-control)-Client aus `/focus [on\|off]` aus, um die Fokusansicht nur für die aktuelle Sitzung ein- oder auszuschalten, ohne Ihre gespeicherte Auswahl zu ändern; dies erfordert Claude Code v2.1.281 oder höher. Die [VS Code-Erweiterung](/docs/de/vs-code#use-the-prompt-box) bietet eine eigene Fokusansicht als Umschalter im Befehlsmenü, die als Erweiterungseinstellung gespeichert wird und unabhängig von `viewMode` ist |

98| `/fork [prompt]` | [Kopieren Sie die aktuelle Konversation](/docs/de/agent-view#copy-the-session-with-%2Ffork) in eine neue Hintergrund-Sitzung und arbeiten Sie hier weiter. Übergeben Sie einen Prompt und die Kopie beginnt sofort damit zu arbeiten; ohne einen wartet sie in der Agent-Ansicht auf ihren ersten Prompt. Außer wenn die Kopie [an Ort und Stelle bearbeitet](/docs/de/agent-view#how-file-edits-are-isolated), weist Claude Code sie an, einen eigenen Worktree zu erstellen, bevor Code-Änderungen vorgenommen werden; die Isolationsanweisung erfordert Claude Code v2.1.221 oder später. Um eine Nebenaufgabe an einen Subagenten zu übergeben, dessen Ergebnis in diese Konversation zurückkommt, verwenden Sie `/subtask`; um selbst in eine Kopie zu wechseln, verwenden Sie `/branch`. Erfordert Claude Code v2.1.212 oder später; auf v2.1.161 bis v2.1.211 und wann immer [Agent-Ansicht ausgeschaltet ist](/docs/de/agent-view#turn-off-agent-view), startet `/fork` stattdessen einen [gegabelten Subagenten](/docs/de/sub-agents#fork-the-current-conversation) |98| `/fork [prompt]` | [Kopiert die aktuelle Konversation](/docs/de/agent-view#copy-the-session-with-%2Ffork) in eine neue Hintergrundsitzung, während Sie hier weiterarbeiten. Übergeben Sie einen Prompt, und die Kopie beginnt sofort mit der Arbeit daran; ohne Prompt wartet sie in der Agentenansicht auf ihren ersten Prompt. Außer wenn die Kopie [direkt vor Ort bearbeitet](/docs/de/agent-view#how-file-edits-are-isolated), weist Claude Code sie an, einen eigenen Worktree zu erstellen, bevor sie Codeänderungen vornimmt; die Isolationsanweisung erfordert Claude Code v2.1.221 oder höher. Um eine Nebenaufgabe an einen Subagenten zu übergeben, dessen Ergebnis in diese Konversation zurückkommt, verwenden Sie `/subtask`; um selbst in eine Kopie zu wechseln, verwenden Sie `/branch`. Erfordert Claude Code v2.1.212 oder höher; in v2.1.161 bis v2.1.211 sowie immer dann, wenn die [Agentenansicht ausgeschaltet ist](/docs/de/agent-view#turn-off-agent-view), startet `/fork` stattdessen einen [geforkten Subagenten](/docs/de/sub-agents#fork-the-current-conversation) |

99| `/goal [condition\|clear]` | Legen Sie ein [Ziel](/docs/de/goal) fest: Claude arbeitet über Runden hinweg, bis die Bedingung erfüllt ist oder das Ziel [aus einem anderen Grund gelöscht wird](/docs/de/goal#how-evaluation-works). Ohne Argument zeigt das aktuelle oder zuletzt erreichte Ziel. `clear`, `stop`, `off`, `reset`, `none` oder `cancel` entfernt ein aktives Ziel früh |99| `/goal [condition\|clear]` | Legt ein [Ziel](/docs/de/goal) fest: Claude arbeitet über mehrere Turns hinweg weiter, bis die Bedingung erfüllt ist oder das Ziel [aus einem anderen Grund aufgehoben wird](/docs/de/goal#how-evaluation-works). Ohne Argument wird das aktuelle oder zuletzt erreichte Ziel angezeigt. `clear`, `stop`, `off`, `reset`, `none` oder `cancel` entfernt ein aktives Ziel vorzeitig |

100| `/heapdump` | Schreiben Sie einen JavaScript-Heap-Snapshot und eine Speicheraufschlüsselung auf `~/Desktop` oder Ihr Home-Verzeichnis unter Linux ohne Desktop-Ordner, um hohe Speichernutzung zu diagnostizieren. Fügen Sie nur die `-diagnostics.json` Datei an, wenn Sie ein Speicherproblem melden; die `.heapsnapshot` enthält Ihre vollständige Konversation und Anmeldedaten, daher teilen Sie sie nicht. [Versteckt vor dem Befehlsmenü](#how-the-command-menu-matches-what-you-type); geben Sie es vollständig ein. Siehe [was mit der Ausgabe zu tun ist](/docs/de/troubleshooting#high-cpu-or-memory-usage) |100| `/heapdump` | Schreibt einen JavaScript-Heap-Snapshot und eine Aufschlüsselung des Arbeitsspeichers nach `~/Desktop` bzw. unter Linux ohne Desktop-Ordner in Ihr Home-Verzeichnis, um hohen Speicherverbrauch zu diagnostizieren. Hängen Sie beim Melden eines Speicherproblems nur die Datei `-diagnostics.json` an; die `.heapsnapshot`-Datei enthält Ihre vollständige Konversation und Ihre Anmeldedaten, teilen Sie sie daher nicht. [Im Befehlsmenü ausgeblendet](#how-the-command-menu-matches-what-you-type); geben Sie ihn vollständig ein. Siehe [was mit der Ausgabe zu tun ist](/docs/de/troubleshooting#high-cpu-or-memory-usage) |

103| `/ide` | Verwalten Sie IDE-Integrationen und zeigen Sie den Status an |103| `/ide` | Verwaltet IDE-Integrationen und zeigt den Status an |

104| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | Bringen Sie Konfiguration von OpenAI Codex, Google Gemini CLI oder Cursor auf Ihrem Computer in Claude Code, einschließlich Anweisungsdateien, MCP-Server, Befehle, Subagenten und Skills. Im [nicht-interaktiven Modus](/docs/de/headless) mit `-p` listet `/import` auf, was es gefunden hat, und gibt Ihnen den Befehl, der den Import bestätigt. Fügen Sie `--dry-run` hinzu, um eine Vorschau ohne Schreiben anzuzeigen, oder `--yes`, um die interaktive Auswahl zu überspringen. Nicht verfügbar auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform auf AWS oder über ein [Claude Apps Gateway](/docs/de/claude-apps-gateway#availability-and-limitations). Auch nicht verfügbar, wenn Sie [Feature-Flag-Abruf](/docs/de/env-vars#features-that-need-feature-flag-fetching) ausschalten. Erfordert Claude Code v2.1.213 oder später. Das Importieren von Cursor erfordert v2.1.265 oder später |104| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | Übernimmt die Konfiguration von OpenAI Codex, Google Gemini CLI oder Cursor auf Ihrem Rechner in Claude Code, einschließlich Anweisungsdateien, MCP-Servern, Befehlen, Subagenten und Skills. Im [nicht interaktiven Modus](/docs/de/headless) mit `-p` listet `/import` auf, was gefunden wurde, und gibt Ihnen den Befehl, der den Import bestätigt. Fügen Sie `--dry-run` hinzu, um eine Vorschau anzuzeigen, ohne etwas zu schreiben, oder `--yes`, um die interaktive Auswahl zu überspringen. Nicht verfügbar auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform on AWS sowie über ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway#availability-and-limitations). Ebenfalls nicht verfügbar, wenn Sie das [Abrufen von Feature-Flags](/docs/de/env-vars#features-that-need-feature-flag-fetching) ausschalten. Erfordert Claude Code v2.1.213 oder höher. Der Import aus Cursor erfordert v2.1.265 oder höher |

105| `/init` | Initialisieren Sie das Projekt mit einer `CLAUDE.md` Anleitung. Setzen Sie `CLAUDE_CODE_NEW_INIT=1` für einen interaktiven Ablauf, der auch Skills, Hooks und persönliche Memory-Dateien durchläuft. Wenn `/init` OpenAI Codex oder Google Gemini CLI Konfiguration findet, bietet es an, sie mit `/import` zu übernehmen |105| `/init` | Initialisiert das Projekt mit einer `CLAUDE.md`-Anleitung. Setzen Sie `CLAUDE_CODE_NEW_INIT=1` für einen interaktiven Ablauf, der auch Skills, Hooks und persönliche Memory-Dateien durchgeht. Wenn `/init` eine Konfiguration von OpenAI Codex oder Google Gemini CLI findet, bietet es an, diese mit `/import` zu übernehmen |

106| `/insights` | Generieren Sie einen HTML-Bericht, der Ihre kürzlichen Sitzungen auf diesem Computer analysiert: in welchen Projekten Sie arbeiten, wie Sie Claude Code verwenden, wo Dinge schiefgehen und Funktionen zum Ausprobieren. Nicht verfügbar in [Cloud-Sitzungen](/docs/de/claude-code-on-the-web). Siehe [Analysieren Sie Ihre Nutzungsmuster](/docs/de/costs#analyze-your-usage-patterns) für den Berichtsspeicherort, die Aufbewahrung und die Kosten |106| `/insights` | Erstellt einen HTML-Bericht, der Ihre letzten Sitzungen auf diesem Rechner analysiert: in welchen Projekten Sie arbeiten, wie Sie Claude Code verwenden, wo Probleme auftreten und welche Funktionen Sie ausprobieren sollten. Nicht verfügbar in [Cloud-Sitzungen](/docs/de/claude-code-on-the-web). Unter [Nutzungsmuster analysieren](/docs/de/costs#analyze-your-usage-patterns) finden Sie Speicherort, Aufbewahrung und Kosten des Berichts |

107| `/install-github-app` | Installieren Sie die Claude GitHub App für ein Repository, mit einem optionalen Schritt zum Einrichten von [GitHub Actions](/docs/de/github-actions) Workflows und Geheimnissen. Führt Sie durch die Auswahl eines Repos und die Konfiguration der Integration. Funktioniert nur mit github.com Repositories. Wenn das Git-Remote Ihres Repositories auf gitlab.com oder bitbucket.org ist, gibt der Befehl eine Benachrichtigung aus und beendet sich, anstatt das Setup zu starten. Um Claude Code aus GitLab-Pipelines auszuführen, siehe [GitLab CI/CD](/docs/de/gitlab-ci-cd) |107| `/install-github-app` | Installiert die Claude GitHub App für ein Repository, mit einem optionalen Schritt zum Einrichten von [GitHub Actions](/docs/de/github-actions)-Workflows und -Secrets. Führt Sie durch die Auswahl eines Repositorys und die Konfiguration der Integration. Funktioniert nur mit github.com-Repositorys. Wenn sich der Git-Remote Ihres Repositorys auf gitlab.com oder bitbucket.org befindet, gibt der Befehl einen Hinweis aus und wird beendet, statt die Einrichtung zu starten. Wie Sie Claude Code aus GitLab-Pipelines ausführen, erfahren Sie unter [GitLab CI/CD](/docs/de/gitlab-ci-cd) |

110| `/list-agents` | Listen Sie die Subagenten, [Agent-Team](/docs/de/agent-teams) Teamkollegen und andere Claude Code Sitzungen auf, die Claude anschreiben kann, mit dem Namen, der für jeden zu verwenden ist. Siehe [Sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging). Auch verfügbar als `/peers`. Erfordert Claude Code v2.1.224 oder später; frühere Versionen melden `Unknown command: /list-agents`. Teamkollegen-Zeilen und die erste Zeile, die den Namen dieser Sitzung anzeigt, erfordern v2.1.239 oder später. Nur in Sitzungen verfügbar, in denen [sitzungsübergreifendes Messaging aktiviert ist](/docs/de/cross-session-messaging#availability) |110| `/list-agents` | Listet die Subagenten, Teammitglieder eines [Agent-Teams](/docs/de/agent-teams) und anderen Claude Code-Sitzungen auf, denen Claude Nachrichten senden kann, jeweils mit dem zu verwendenden Namen. Siehe [sitzungsübergreifendes Messaging](/docs/de/cross-session-messaging). Auch als `/peers` verfügbar. Erfordert Claude Code v2.1.224 oder höher; frühere Versionen melden `Unknown command: /list-agents`. Zeilen für Teammitglieder und die erste Zeile mit dem eigenen Namen dieser Sitzung erfordern v2.1.239 oder höher. Nur in Sitzungen verfügbar, in denen [sitzungsübergreifendes Messaging aktiviert ist](/docs/de/cross-session-messaging#availability) |

113| `/loop [interval] [prompt]` | **[Skill](/docs/de/skills#bundled-skills).** Führen Sie einen Prompt wiederholt aus, während die Sitzung offen bleibt. Lassen Sie das Intervall weg und Claude [bestimmt das Tempo zwischen Iterationen selbst](/docs/de/scheduled-tasks#let-claude-choose-the-interval). Lassen Sie den Prompt weg und Claude führt den [integrierten Wartungs-Prompt](/docs/de/scheduled-tasks#run-the-built-in-maintenance-prompt) oder Ihre [`loop.md`](/docs/de/scheduled-tasks#customize-the-default-prompt-with-loop-md) aus. Beispiel: `/loop 5m check if the deploy finished`. Siehe [Prompts nach Zeitplan ausführen](/docs/de/scheduled-tasks). Alias: `/proactive` |113| `/loop [interval] [prompt]` | **[Skill](/docs/de/skills#bundled-skills).** Führt einen Prompt wiederholt aus, solange die Sitzung geöffnet bleibt. Wenn Sie das Intervall weglassen, [bestimmt Claude das Tempo zwischen den Iterationen selbst](/docs/de/scheduled-tasks#let-claude-choose-the-interval). Wenn Sie den Prompt weglassen, führt Claude den [integrierten Wartungs-Prompt](/docs/de/scheduled-tasks#run-the-built-in-maintenance-prompt) oder Ihre [`loop.md`](/docs/de/scheduled-tasks#customize-the-default-prompt-with-loop-md) aus. Beispiel: `/loop 5m check if the deploy finished`. Siehe [Prompts nach Zeitplan ausführen](/docs/de/scheduled-tasks). Alias: `/proactive` |

114| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Verwalten Sie MCP-Server-Verbindungen und OAuth-Authentifizierung. Führen Sie ohne Argument aus, um die interaktive Liste zu öffnen, übergeben Sie `reconnect <server>`, um einen getrennten Server erneut zu verbinden, oder übergeben Sie `enable`/`disable` mit einem Servernamen oder `all`, um den Verbindungsstatus zu ändern, ohne den Dialog zu öffnen. Auch im nicht-interaktiven Modus (`-p`) verfügbar, wo die Ausführung ohne Argument eine Textzusammenfassung des Serverstatus statt der Liste ausgibt; erfordert Claude Code v2.1.205 oder später |114| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Verwaltet MCP-Serververbindungen und die OAuth-Authentifizierung. Führen Sie den Befehl ohne Argument aus, um die interaktive Liste zu öffnen, übergeben Sie `reconnect <server>`, um einen getrennten Server erneut zu verbinden, oder übergeben Sie `enable`/`disable` mit einem Servernamen oder `all`, um den Verbindungsstatus zu ändern, ohne den Dialog zu öffnen. Auch im nicht interaktiven Modus (`-p`) verfügbar, wo die Ausführung ohne Argument statt der Liste eine Textzusammenfassung des Serverstatus ausgibt; erfordert Claude Code v2.1.205 oder höher |

115| `/memory` | Bearbeiten Sie `CLAUDE.md` Dateien, aktivieren oder deaktivieren Sie [Auto Memory](/docs/de/memory#auto-memory) und zeigen Sie Auto Memory Einträge an |115| `/memory` | Bearbeitet `CLAUDE.md`-Dateien, aktiviert oder deaktiviert [Auto-Memory](/docs/de/memory#auto-memory) und zeigt Auto-Memory-Einträge an |

117| `/model [model]` | Wechseln Sie das KI-Modell und speichern Sie es als Standard für neue Sitzungen. Für Modelle, die es unterstützen, verwenden Sie Pfeile nach links/rechts, um die [Aufwandsstufe](/docs/de/model-config#adjust-effort-level) anzupassen. Ohne Argument öffnet sich eine Auswahl; drücken Sie `s` auf einer Zeile, um nur für die aktuelle Sitzung zu wechseln. Siehe [wann Claude Code Sie auffordert, den Wechsel zu bestätigen](/docs/de/prompt-caching#switching-models). Sobald Sie den Wechsel bestätigen, wenn Claude Code fragt, wendet Claude Code die Änderung an, ohne auf das Ende der aktuellen Antwort zu warten. Vor v2.1.242 entschied Claude Code anhand eines Feature-Flags, das es von Anthropic abrief, ob der Befehl in der Mitte der Runde oder bis zum Ende der Runde ausgeführt werden sollte, und wartete immer in einer Sitzung, die keine [Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching), wie auf einem [Drittanbieter](/docs/de/third-party-integrations). Auch im nicht-interaktiven Modus (`-p`) mit einem Modellargument statt 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 |117| `/model [model]` | Wechselt das KI-Modell und speichert es als Ihren Standard für neue Sitzungen. Bei Modellen, die dies unterstützen, verwenden Sie die Pfeiltasten links/rechts, um [die Effort-Stufe anzupassen](/docs/de/model-config#adjust-effort-level). Ohne Argument wird eine Auswahl geöffnet; drücken Sie `s` in einer Zeile, um nur für die aktuelle Sitzung zu wechseln. Siehe [wann Claude Code Sie bittet, den Wechsel zu bestätigen](/docs/de/prompt-caching#switching-models). Sobald Sie den Wechsel bestätigen, falls Claude Code danach fragt, wendet Claude Code die Änderung an, ohne auf das Ende der aktuellen Antwort zu warten. Vor v2.1.242 entschied Claude Code anhand eines von Anthropic abgerufenen Feature-Flags, ob der Befehl mitten im Turn ausgeführt oder bis zum Ende des Turns in die Warteschlange gestellt wird, und stellte ihn in einer Sitzung, die [keine Feature-Flags abruft](/docs/de/env-vars#features-that-need-feature-flag-fetching), etwa bei einem [Drittanbieter](/docs/de/third-party-integrations), immer in die Warteschlange. Auch im nicht interaktiven Modus (`-p`) mit einem Modellargument statt der Auswahl verfügbar; dort gilt der Wechsel nur für die aktuelle Sitzung und wird nicht als Ihr Standard gespeichert; erfordert Claude Code v2.1.205 oder höher |

118| `/output-style [style]` | Listen Sie [Ausgabestile](/docs/de/output-styles) auf oder wechseln Sie zu einem, z. B. `/output-style concise`. Siehe [Ändern Sie Ihren Ausgabestil](/docs/de/output-styles#change-your-output-style). Erfordert Claude Code v2.1.269 oder später |118| `/output-style [style]` | Listet [Ausgabestile](/docs/de/output-styles) auf oder wechselt zu einem, zum Beispiel `/output-style concise`. Siehe [Ausgabestil ändern](/docs/de/output-styles#change-your-output-style). Erfordert Claude Code v2.1.269 oder höher |

120| `/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](/docs/de/auto-mode-config#review-denials) überprüfen können. Sie können auch [Auto-Modus-Klassifizierer-Regeln](/docs/de/auto-mode-config#edit-rules-from-permissions) aus der Registerkarte **Auto mode** des Dialogs anzeigen und bearbeiten. Wenn Sie ihn ausführen, während Claude antwortet, öffnet Claude Code den Dialog sofort und wendet Ihre Änderungen ab Claudes nächstem Tool-Aufruf in derselben Runde an. Vor v2.1.234 wartete Claude Code mit dem Befehl, bis die Runde beendet war. Alias: `/allowed-tools` |120| `/permissions` | Verwaltet Allow-, Ask- und Deny-Regeln für Tool-Berechtigungen. Öffnet einen interaktiven Dialog, in dem Sie Regeln nach Geltungsbereich anzeigen, Regeln hinzufügen oder entfernen, Arbeitsverzeichnisse verwalten und [kürzliche Ablehnungen im Auto-Modus](/docs/de/auto-mode-config#review-denials) prüfen können. Über den Tab **Auto mode** des Dialogs können Sie außerdem [Regeln des Auto-Modus-Klassifikators](/docs/de/auto-mode-config#edit-rules-from-permissions) anzeigen und bearbeiten. Wenn Sie den Befehl ausführen, während Claude antwortet, öffnet Claude Code den Dialog sofort und wendet Ihre Änderungen ab Claudes nächstem Tool-Aufruf im selben Turn an. Vor v2.1.234 hat Claude Code den Befehl in die Warteschlange gestellt, bis der Turn beendet war. Alias: `/allowed-tools` |

121| `/plan [description]` | Geben Sie den Plan-Modus direkt aus der Eingabeaufforderung ein. Übergeben Sie eine optionale Beschreibung, um den Plan-Modus einzugeben und sofort mit dieser Aufgabe zu beginnen, z. B. `/plan fix the auth bug` |121| `/plan [description]` | Wechselt direkt aus dem Eingabefeld in den Plan-Modus. Übergeben Sie eine optionale Beschreibung, um in den Plan-Modus zu wechseln und sofort mit dieser Aufgabe zu beginnen, zum Beispiel `/plan fix the auth bug` |

122| `/plugin [subcommand]` | Verwalten Sie Claude Code [Plugins](/docs/de/plugins/overview). Führen Sie ohne Argument aus, um das Plugin-Menü zu öffnen, oder übergeben Sie einen Unterbefehl wie `list`, `install`, `enable` oder `disable`, um direkt zu handeln. Claude Code kann ein Plugin während der Installation aktivieren; die [Installationszusammenfassung](/docs/de/plugins/install#install-a-plugin) teilt Ihnen mit, ob es das tat oder ob Sie `/reload-plugins` ausführen sollten |122| `/plugin [subcommand]` | Verwaltet Claude Code-[Plugins](/docs/de/plugins/overview). Führen Sie den Befehl ohne Argument aus, um das Plugin-Menü zu öffnen, oder übergeben Sie einen Unterbefehl wie `list`, `install`, `enable` oder `disable`, um direkt zu handeln. Claude Code kann ein Plugin während der Installation aktivieren; die [Installationszusammenfassung](/docs/de/plugins/install#install-a-plugin) teilt Ihnen mit, ob dies geschehen ist oder ob Sie `/reload-plugins` ausführen müssen |

124| `/pr-comments [PR]` | Entfernt in v2.1.91. Bitten Sie Claude direkt, Pull Request Kommentare anzuzeigen. In früheren Versionen ruft und zeigt Kommentare aus einem GitHub Pull Request ab; erkennt automatisch den PR für den aktuellen Branch oder übergeben Sie eine PR-URL oder Nummer. Erfordert die `gh` CLI |124| `/pr-comments [PR]` | In v2.1.91 entfernt. Bitten Sie Claude stattdessen direkt, Pull-Request-Kommentare anzuzeigen. In früheren Versionen werden Kommentare aus einem GitHub-Pull-Request abgerufen und angezeigt; der PR für den aktuellen Branch wird automatisch erkannt, oder Sie übergeben eine PR-URL oder -Nummer. Erfordert die `gh` CLI |

125| `/privacy-settings` | Zeigen Sie Ihre Datenschutzeinstellungen an und aktualisieren Sie sie. Nur für Pro- und Max-Plan-Abonnenten verfügbar |125| `/privacy-settings` | Zeigt Ihre Datenschutzeinstellungen an und aktualisiert sie. Nur für Abonnenten der Pro- und Max-Pläne verfügbar |

127| `/rate-limit-options` | Zeigen Sie Möglichkeiten, weiterzuarbeiten, wenn ein claude.ai Nutzungslimit eine Anfrage blockiert: warten und [automatisch fortfahren, wenn das Limit zurückgesetzt wird](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset), [Nutzungsguthaben](/docs/de/costs#add-usage-credits-to-your-subscription) hinzufügen oder Ihren Plan upgraden. Claude Code kann dieses Menü auch von selbst öffnen, wenn Sie ein Limit an Ihrem eigenen Terminal erreichen. Siehe [Automatisches Fortfahren ausschalten](/docs/de/interactive-mode#turn-automatic-continue-off). Erfordert ein claude.ai Abonnement. Die Warte- und Fortfahren-Zeilen erfordern Claude Code v2.1.234 oder später |127| `/rate-limit-options` | Zeigt Möglichkeiten, weiterzuarbeiten, wenn ein claude.ai-Nutzungslimit eine Anfrage blockiert: warten und [automatisch fortfahren, wenn das Limit zurückgesetzt wird](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset), [Nutzungsguthaben](/docs/de/costs#add-usage-credits-to-your-subscription) hinzufügen oder Ihren Plan upgraden. Claude Code kann dieses Menü auch selbstständig öffnen, wenn Sie an Ihrem eigenen Terminal ein Limit erreichen. Siehe [Automatisches Fortfahren ausschalten](/docs/de/interactive-mode#turn-automatic-continue-off). Erfordert ein claude.ai-Abonnement. Die Zeilen zum Warten und Fortfahren erfordern Claude Code v2.1.234 oder höher |

128| `/recap` | Generieren Sie auf Anfrage eine einzeilige Zusammenfassung der aktuellen Sitzung. Siehe [Sitzungs-Recap](/docs/de/interactive-mode#session-recap) für das automatische Recap, das angezeigt wird, nachdem Sie weg waren |128| `/recap` | Erstellt bei Bedarf eine einzeilige Zusammenfassung der aktuellen Sitzung. Unter [Sitzungszusammenfassung](/docs/de/interactive-mode#session-recap) erfahren Sie mehr über die automatische Zusammenfassung, die erscheint, nachdem Sie abwesend waren |

129| `/release-notes` | Zeigen Sie das Changelog in einer interaktiven Versions-Auswahl an. Wählen Sie eine bestimmte Version, um ihre Versionshinweise anzuzeigen, oder wählen Sie, um alle Versionen anzuzeigen. Die Hinweise erscheinen in Ihrem Transkript, ohne die Konversation einzugeben, die Claude sieht |129| `/release-notes` | Zeigt das Changelog in einer interaktiven Versionsauswahl an. Wählen Sie eine bestimmte Version, um deren Versionshinweise zu sehen, oder lassen Sie sich alle Versionen anzeigen. Die Hinweise erscheinen in Ihrem Transkript, ohne in die Konversation einzufließen, die Claude sieht |

130| `/reload-plugins [--force]` | Laden Sie alle aktiven [Plugins](/docs/de/plugins/overview) neu, um ausstehende Änderungen anzuwenden, ohne neu zu starten. Meldet Anzahlen für jede neu geladene Komponente und kennzeichnet alle Ladefehler. Wenn das Neuladen ändern würde, welche MCP-Tools geladen sind und den Prompt-Cache ungültig machen würde, warnt der Befehl und überspringt, es sei denn, Sie übergeben `--force`. Auch im nicht-interaktiven Modus (`-p`), dem Agent SDK und der Desktop App verfügbar, wo es nur auf direkt in die Sitzung eingegebene Eingaben läuft und Plugin-MCP-Server-Änderungen nicht anwendet; erfordert Claude Code v2.1.260 oder später. Siehe [Plugin-Änderungen ohne Neustart anwenden](/docs/de/plugins/cli-reference#reload-plugins) |130| `/reload-plugins [--force]` | Lädt alle aktiven [Plugins](/docs/de/plugins/overview) neu, um ausstehende Änderungen ohne Neustart anzuwenden. Meldet die Anzahl für jede neu geladene Komponente und kennzeichnet Ladefehler. Wenn das Neuladen ändern würde, welche MCP-Tools geladen sind, und den Prompt-Cache ungültig machen würde, gibt der Befehl eine Warnung aus und überspringt das Neuladen, sofern Sie nicht `--force` übergeben. Auch im nicht interaktiven Modus (`-p`), im Agent SDK und in der Desktop-App verfügbar, wo der Befehl nur bei direkt in die Sitzung eingegebener Eingabe ausgeführt wird und keine Änderungen an Plugin-MCP-Servern anwendet; erfordert Claude Code v2.1.260 oder höher. Siehe [Plugin-Änderungen ohne Neustart anwenden](/docs/de/plugins/cli-reference#reload-plugins) |

131| `/reload-skills` | Scannen Sie [Skill](/docs/de/skills) und Befehlsverzeichnisse erneut, damit während der Sitzung auf der Festplatte hinzugefügte oder geänderte Skills verfügbar werden, ohne neu zu starten. Meldet, wie viele Skills verfügbar sind und wie viele hinzugefügt oder entfernt wurden |131| `/reload-skills` | Durchsucht [Skill](/docs/de/skills)- und Befehlsverzeichnisse erneut, sodass während der Sitzung auf dem Datenträger hinzugefügte oder geänderte Skills ohne Neustart verfügbar werden. Meldet, wie viele Skills verfügbar sind und wie viele hinzugefügt oder entfernt wurden |

132| `/remote-control` | Machen Sie diese Sitzung für [Remote Control](/docs/de/remote-control) von claude.ai verfügbar. Die Ausführung während der Abmeldung gibt aus, dass Remote Control ein claude.ai Abonnement erfordert, und teilt Ihnen mit, wie Sie sich anmelden; vor v2.1.206 meldete es `Unknown command: /remote-control`. Alias: `/rc` |132| `/remote-control` | Macht diese Sitzung für [Remote Control](/docs/de/remote-control) von claude.ai aus verfügbar. Wenn Sie den Befehl im abgemeldeten Zustand ausführen, wird ausgegeben, dass Remote Control ein claude.ai-Abonnement erfordert, und wie Sie sich anmelden; vor v2.1.206 wurde `Unknown command: /remote-control` gemeldet. Alias: `/rc` |

133| `/remote-env` | Wählen Sie die Standard-[Cloud-Umgebung](/docs/de/cloud-environments#select-an-environment-from-the-cli) für Cloud-Sitzungen, die Sie von der CLI starten |133| `/remote-env` | Wählt die Standard-[Cloud-Umgebung](/docs/de/cloud-environments#select-an-environment-from-the-cli) für Cloud-Sitzungen, die Sie über die CLI starten |

134| `/rename [name]` | Benennen Sie die aktuelle Sitzung um und zeigen Sie den Namen auf der Eingabeaufforderungsleiste an. Ohne Namen wird automatisch einer aus dem Konversationsverlauf generiert. Auch im nicht-interaktiven Modus (`-p`) verfügbar; erfordert Claude Code v2.1.205 oder später. Von jeder Umbenennungsoberfläche, einschließlich claude.ai und der Desktop App, ersetzt Claude Code Steuerzeichen und unsichtbare Zeichen im neuen Namen durch Leerzeichen und begrenzt den Namen auf 200 Zeichen. Wenn der Name leer ist, sobald unsichtbare Zeichen entfernt werden, lehnt Claude Code ihn ab und zeigt `That name is empty once invisible characters are removed. Usage: /rename <name>`. Der Zeichenersatz und die Längenbegrenzung erfordern Claude Code v2.1.221 oder später. Wenn eine andere Live-Sitzung auf diesem Computer bereits einen Namen verwendet, den Sie übergeben, wendet Claude Code stattdessen [eine Variante davon](/docs/de/sessions#name-your-sessions) an |134| `/rename [name]` | Benennt die aktuelle Sitzung um und zeigt den Namen in der Eingabeleiste an. Ohne Namen wird automatisch einer aus dem Konversationsverlauf erzeugt. Auch im nicht interaktiven Modus (`-p`) verfügbar; erfordert Claude Code v2.1.205 oder höher. Auf jeder Oberfläche zum Umbenennen, einschließlich claude.ai und der Desktop-App, ersetzt Claude Code Steuer- und unsichtbare Zeichen im neuen Namen durch Leerzeichen und begrenzt den Namen auf 200 Zeichen. Wenn der Name nach dem Entfernen unsichtbarer Zeichen leer ist, lehnt Claude Code ihn ab und zeigt `That name is empty once invisible characters are removed. Usage: /rename <name>` an. Die Zeichenersetzung und die Längenbegrenzung erfordern Claude Code v2.1.221 oder höher. Wenn eine andere aktive Sitzung auf diesem Rechner bereits einen von Ihnen übergebenen Namen verwendet, wendet Claude Code stattdessen [eine Variante davon](/docs/de/sessions#name-your-sessions) an |

135| `/resume [session]` | Setzen Sie eine Konversation nach ID oder Name fort, oder öffnen Sie die Sitzungsauswahl. [Hintergrund-Sitzungen](/docs/de/agent-view) erscheinen in der Auswahl mit `bg` gekennzeichnet. Das Fortsetzen einer, die noch läuft, aus der Auswahl oder nach ID oder Name, [öffnet diese Sitzung](/docs/de/sessions#resume-a-running-background-session): Ihre aktuelle Konversation wechselt in den Hintergrund und dieses Terminal wird an die laufende angehängt. Drücken Sie `←` auf einer leeren Eingabeaufforderung, um zur Agent-Ansicht zurückzukehren, die auch die Konversation auflistet, die Sie verlassen haben. Vor v2.1.285 weigerte sich Claude Code und sagte Ihnen, die Sitzung mit `claude attach` zu öffnen oder sie zuerst zu stoppen. Alias: `/continue` |135| `/resume [session]` | Setzt eine Konversation anhand von ID oder Namen fort oder öffnet die Sitzungsauswahl. [Hintergrundsitzungen](/docs/de/agent-view) erscheinen in der Auswahl mit `bg` gekennzeichnet. Wenn Sie eine noch laufende Sitzung fortsetzen, ob aus der Auswahl oder per ID oder Namen, [wird diese Sitzung geöffnet](/docs/de/sessions#resume-a-running-background-session): Ihre aktuelle Konversation wechselt in den Hintergrund, und dieses Terminal wird an die laufende Sitzung angehängt. Drücken Sie `←` bei leerem Eingabefeld, um zur Agentenansicht zurückzukehren, die auch die verlassene Konversation auflistet. Vor v2.1.285 hat Claude Code dies abgelehnt und Sie angewiesen, die Sitzung mit `claude attach` zu öffnen oder sie zuerst zu stoppen. Alias: `/continue` |

136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias von [`/code-review`](/docs/de/code-review#review-a-diff-locally): überprüft den aktuellen Diff oder eine PR-Nummer, einen Branch oder einen Pfad, den Sie übergeben, wie z. B. `/review 1234`, und nimmt die gleichen Aufwandsstufen und Flags. Ohne angegebene Stufe verwendet die Überprüfung die letzte `low` bis `max` Stufe, die Sie eingegeben haben; siehe [Diff lokal überprüfen](/docs/de/code-review#review-a-diff-locally) für die genauen Regeln. Für eine tiefe Cloud-Überprüfung verwenden Sie [`/code-review ultra`](/docs/de/ultrareview). Vor v2.1.223 war `/review` ein separater Befehl, der eine einmalige, schreibgeschützte Überprüfung eines GitHub Pull Request nach Nummer durchführte, wobei offene PRs zum Auswählen aufgelistet wurden, wenn ohne Argument ausgeführt; von v2.1.186 bis v2.1.201 führte er die gleiche Multi-Agent-Engine wie `/code-review medium` aus |136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias von [`/code-review`](/docs/de/code-review#review-a-diff-locally): prüft den aktuellen Diff oder eine übergebene PR-Nummer, einen Branch oder Pfad, etwa `/review 1234`, und akzeptiert dieselben Effort-Stufen und Flags. Ohne angegebene Stufe verwendet das Review die zuletzt eingegebene Stufe von `low` bis `max`; die genauen Regeln finden Sie unter [Einen Diff lokal prüfen](/docs/de/code-review#review-a-diff-locally). Für ein tiefgehendes Cloud-Review verwenden Sie [`/code-review ultra`](/docs/de/ultrareview). Vor v2.1.223 war `/review` ein separater Befehl, der ein einstufiges, nur lesendes Review eines GitHub-Pull-Requests anhand seiner Nummer durchführte und bei Ausführung ohne Argument offene PRs zur Auswahl auflistete; von v2.1.186 bis v2.1.201 nutzte er dieselbe Multi-Agenten-Engine wie `/code-review medium` |

137| `/rewind` | Spulen Sie die Konversation und/oder den Code zu einem früheren Punkt zurück, oder fassen Sie von einer ausgewählten Nachricht zusammen. Siehe [Checkpointing](/docs/de/checkpointing). Aliase: `/checkpoint`, `/undo` |137| `/rewind` | Setzt die Konversation und/oder den Code auf einen früheren Punkt zurück oder fasst ab einer ausgewählten Nachricht zusammen. Siehe [Checkpointing](/docs/de/checkpointing). Aliasse: `/checkpoint`, `/undo` |

138| `/run` | **[Skill](/docs/de/skills#bundled-skills).** Starten Sie Ihre Projekt-App und fahren Sie sie, um eine Änderung funktionierend zu sehen, nicht nur Tests zu bestehen. Siehe [Führen Sie Ihre App aus und überprüfen Sie sie](/docs/de/skills#run-and-verify-your-app) |138| `/run` | **[Skill](/docs/de/skills#bundled-skills).** Startet und bedient die App Ihres Projekts, um zu sehen, dass eine Änderung funktioniert, und nicht nur, dass Tests bestehen. Siehe [App ausführen und verifizieren](/docs/de/skills#run-and-verify-your-app) |

139| `/run-skill-generator` | **[Skill](/docs/de/skills#bundled-skills).** Lehren Sie `/run` und `/verify`, wie Sie Ihre Projekt-App aus einer sauberen Umgebung erstellen, starten und fahren, indem Sie einen Pro-Projekt-[Skill](/docs/de/skills#run-and-verify-your-app) schreiben |139| `/run-skill-generator` | **[Skill](/docs/de/skills#bundled-skills).** Bringt `/run` und `/verify` bei, wie die App Ihres Projekts aus einer sauberen Umgebung gebaut, gestartet und bedient wird, indem ein projektspezifischer [Skill](/docs/de/skills#run-and-verify-your-app) geschrieben wird |

141| `/schedule [description]` | Erstellen, aktualisieren, listen oder führen Sie [Routinen](/docs/de/routines) aus, die in der Cloud ausgeführt werden. Claude führt Sie conversationally durch das Setup. Sie können auch nach [kürzlichen Läufen einer Routine](/docs/de/routines#manage-routines-from-the-cli) fragen. Alias: `/routines` |141| `/schedule [description]` | Erstellt, aktualisiert, listet oder führt [Routinen](/docs/de/routines) aus, die in der Cloud laufen. Claude führt Sie im Dialog durch die Einrichtung. Sie können auch nach den [letzten Ausführungen einer Routine](/docs/de/routines#manage-routines-from-the-cli) fragen. Alias: `/routines` |

142| `/scroll-speed` | Passen Sie die [Scroll-Geschwindigkeit](/docs/de/fullscreen#mouse-wheel-scrolling) der Maus interaktiv an, mit einem Lineal, das Sie scrollen können, während der Dialog offen ist, um die Änderung in der Vorschau anzuzeigen. Nur im [Vollbild-Rendering](/docs/de/fullscreen) verfügbar und nicht im JetBrains IDE Terminal |142| `/scroll-speed` | Passt die [Scrollgeschwindigkeit](/docs/de/fullscreen#mouse-wheel-scrolling) des Mausrads interaktiv an, mit einem Lineal, das Sie bei geöffnetem Dialog scrollen können, um die Änderung in der Vorschau zu sehen. Nur im [Vollbild-Rendering](/docs/de/fullscreen) verfügbar und nicht im Terminal der JetBrains-IDE |

143| `/security-review` | Analysieren Sie die Änderungen auf Ihrem aktuellen Branch auf Sicherheitslücken. Überprüft den Diff zwischen Ihrem Branch und dem Standard-Branch des Origin, identifiziert Risiken wie Injection, Auth-Probleme und Datenexposition. Benötigt ein `origin` Remote; wenn die Überprüfung mit einem `ambiguous argument` Fehler fehlschlägt, siehe die [Fehlerreferenz](/docs/de/errors#security-review-fails-without-origin-head) |143| `/security-review` | Analysiert die Änderungen auf Ihrem aktuellen Branch auf Sicherheitslücken. Prüft den Diff zwischen Ihrem Branch und dem Standard-Branch von origin und identifiziert Risiken wie Injection, Authentifizierungsprobleme und Offenlegung von Daten. Benötigt einen `origin`-Remote; wenn das Review mit einem `ambiguous argument`-Fehler fehlschlägt, siehe die [Fehlerreferenz](/docs/de/errors#security-review-fails-without-origin-head) |

144| `/setup-bedrock` | Konfigurieren Sie [Amazon Bedrock](/docs/de/amazon-bedrock) Authentifizierung, Region und Modell-Pins durch einen interaktiven Wizard. [Versteckt vor dem Befehlsmenü](#how-the-command-menu-matches-what-you-type), bis `CLAUDE_CODE_USE_BEDROCK=1` gesetzt ist; geben Sie es vollständig ein. Erstbenutzer von Amazon Bedrock können auch auf diesen Wizard vom Anmeldebildschirm zugreifen |144| `/setup-bedrock` | Konfiguriert die Authentifizierung, Region und Modellfixierungen für [Amazon Bedrock](/docs/de/amazon-bedrock) über einen interaktiven Assistenten. [Im Befehlsmenü ausgeblendet](#how-the-command-menu-matches-what-you-type), bis `CLAUDE_CODE_USE_BEDROCK=1` gesetzt ist; geben Sie ihn vollständig ein. Erstmalige Amazon Bedrock-Benutzer können diesen Assistenten auch über den Anmeldebildschirm aufrufen |

145| `/setup-vertex` | Konfigurieren Sie [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) Authentifizierung, Projekt, Region und Modell-Pins durch einen interaktiven Wizard. [Versteckt vor dem Befehlsmenü](#how-the-command-menu-matches-what-you-type), bis `CLAUDE_CODE_USE_VERTEX=1` gesetzt ist; geben Sie es vollständig ein. Erstbenutzer von Google Cloud's Agent Platform können auch auf diesen Wizard vom Anmeldebildschirm zugreifen |145| `/setup-vertex` | Konfiguriert die Authentifizierung, das Projekt, die Region und Modellfixierungen für [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) über einen interaktiven Assistenten. [Im Befehlsmenü ausgeblendet](#how-the-command-menu-matches-what-you-type), bis `CLAUDE_CODE_USE_VERTEX=1` gesetzt ist; geben Sie ihn vollständig ein. Erstmalige Benutzer von Google Cloud's Agent Platform können diesen Assistenten auch über den Anmeldebildschirm aufrufen |

146| `/simplify [target]` | **[Skill](/docs/de/skills#bundled-skills).** Überprüfen Sie den geänderten Code auf Bereinigungsmöglichkeiten und wenden Sie die Fixes an. Vier Überprüfungs-[Agenten](/docs/de/sub-agents) laufen parallel und decken Wiederverwendung vorhandener Helfer, Vereinfachung, Effizienz und ob die Änderung auf der richtigen Abstraktionsebene ist, ab. Die Überprüfung sucht nicht nach Korrektheitsfehler. Verwenden Sie `/code-review`, um Fehler zu finden. Übergeben Sie einen Pfad oder PR-Referenz, um ein bestimmtes Ziel zu überprüfen |146| `/simplify [target]` | **[Skill](/docs/de/skills#bundled-skills).** Prüft den geänderten Code auf Möglichkeiten zur Bereinigung und wendet die Korrekturen an. Vier Review-[Agenten](/docs/de/sub-agents) laufen parallel und decken die Wiederverwendung vorhandener Hilfsfunktionen, Vereinfachung, Effizienz und die Frage ab, ob die Änderung auf der richtigen Abstraktionsebene liegt. Das Review sucht nicht nach Korrektheitsfehlern. Verwenden Sie `/code-review`, um Fehler zu finden. Übergeben Sie einen Pfad oder eine PR-Referenz, um ein bestimmtes Ziel zu prüfen |

147| `/skill-doctor` | Zeigen Sie, was jeder Ihrer [Skills](/docs/de/skills) im Kontext kostet und wie oft er verwendet wird, damit Sie [Skills finden können, die Sie ausschalten können](/docs/de/skills#find-unused-skills). Erfordert Claude Code v2.1.252 oder später und [Feature-Flag-Abruf](/docs/de/env-vars#features-that-need-feature-flag-fetching) |147| `/skill-doctor` | Zeigt, was jeder Ihrer [Skills](/docs/de/skills) an Kontext kostet und wie oft er verwendet wird, damit Sie [Skills finden können, die Sie ausschalten können](/docs/de/skills#find-unused-skills). Erfordert Claude Code v2.1.252 oder höher und das [Abrufen von Feature-Flags](/docs/de/env-vars#features-that-need-feature-flag-fetching) |

148| `/skills` | Listen Sie verfügbare [Skills](/docs/de/skills) auf. Geben Sie ein, um die Liste nach Name, Beschreibung oder Quelle zu filtern. Drücken Sie `t`, um nach Token-Anzahl zu sortieren, `Space` oder `Enter`, um [die Sichtbarkeit eines Skills für Claude und das `/` Menü zu durchlaufen](/docs/de/skills#override-skill-visibility-from-settings), und `Esc`, um zu speichern und zu schließen. Sie können Plugin-Skills, Skills, deren Frontmatter `disable-model-invocation: true` setzt, oder Skills mit einem `skillOverrides` Eintrag in verwalteten Einstellungen oder dem `--settings` Flag nicht durchlaufen |148| `/skills` | Listet verfügbare [Skills](/docs/de/skills) auf. Tippen Sie, um die Liste nach Name, Beschreibung oder Quelle zu filtern. Drücken Sie `t`, um nach Token-Anzahl zu sortieren, `Space` oder `Enter`, um [die Sichtbarkeit eines Skills für Claude und das `/`-Menü durchzuschalten](/docs/de/skills#override-skill-visibility-from-settings), und `Esc`, um zu speichern und zu schließen. Nicht durchschalten können Sie Plugin-Skills, Skills, deren Frontmatter `disable-model-invocation: true` setzt, oder Skills mit einem `skillOverrides`-Eintrag in verwalteten Einstellungen oder im Flag `--settings` |

149| `/slides [brief]` | **[Skill](/docs/de/skills#bundled-skills).** Erstellen Sie eine neue Präsentation als Claude Slides [Artefakt](/docs/de/artifacts#make-a-slide-deck), gefüllt aus Ihrem Brief, z. B. `/slides a quarterly review of the platform team`. Erfordert Claude Code v2.1.265 oder später, eine Sitzung, in der [Artefakte verfügbar sind](/docs/de/artifacts#availability), und ein Konto, in dem die [Slides-Vorlage verfügbar ist](/docs/de/artifacts#start-from-a-slides-design-or-docs-template); andernfalls wird der Befehl nicht angezeigt. Verfügbar auf der Anthropic API. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS sind Artefakte nicht verfügbar, daher ist der Befehl dort nicht verfügbar |149| `/slides [brief]` | **[Skill](/docs/de/skills#bundled-skills).** Erstellt eine neue Präsentation als Claude Slides-[Artefakt](/docs/de/artifacts#make-a-slide-deck), befüllt anhand Ihrer Vorgaben, zum Beispiel `/slides a quarterly review of the platform team`. Erfordert Claude Code v2.1.265 oder höher, eine Sitzung, in der [Artefakte verfügbar sind](/docs/de/artifacts#availability), und ein Konto, in dem die [Slides-Vorlage verfügbar ist](/docs/de/artifacts#start-from-a-slides-design-or-docs-template); andernfalls wird der Befehl nicht angezeigt. Verfügbar über die Anthropic API. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS sind Artefakte nicht verfügbar, daher ist der Befehl dort nicht verfügbar |

151| `/status` | Öffnen Sie die Einstellungsschnittstelle auf der Registerkarte Status, die Version, Modell, Konto und Konnektivität anzeigt. Eine `Session kind` Zeile liest `background job · attached` oder `background job · unattended` in einer [Hintergrund-Sitzung](/docs/de/agent-view), je nachdem, ob ein Terminal angehängt ist, und `interactive` in jeder anderen Sitzung. Vor v2.1.221 zeigte `/status` diese Zeile nicht. Funktioniert, während Claude antwortet |151| `/status` | Öffnet die Einstellungsoberfläche auf dem Tab „Status“, der Version, Modell, Konto und Konnektivität anzeigt. Eine Zeile `Session kind` lautet in einer [Hintergrundsitzung](/docs/de/agent-view) `background job · attached` oder `background job · unattended`, je nachdem, ob ein Terminal angehängt ist, und in jeder anderen Sitzung `interactive`. Vor v2.1.221 zeigte `/status` diese Zeile nicht an. Funktioniert, während Claude antwortet |

152| `/statusline` | Konfigurieren Sie Claude Code's [Status-Zeile](/docs/de/statusline). Beschreiben Sie, was Sie möchten, oder führen Sie ohne Argumente aus, um automatisch aus Ihrer Shell-Eingabeaufforderung zu konfigurieren |152| `/statusline` | Konfiguriert die [Statuszeile](/docs/de/statusline) von Claude Code. Beschreiben Sie, was Sie möchten, oder führen Sie den Befehl ohne Argumente aus, um die Konfiguration automatisch aus Ihrer Shell-Eingabeaufforderung abzuleiten |

154| `/stop` | Stoppen Sie die aktuelle [Hintergrund-Sitzung](/docs/de/agent-view). Nur verfügbar, während Sie an einer Hintergrund-Sitzung angehängt sind; das Transkript und alle Worktrees werden beibehalten. Um zu trennen, ohne zu stoppen, verwenden Sie `/exit` oder drücken Sie `←` |154| `/stop` | Stoppt die aktuelle [Hintergrundsitzung](/docs/de/agent-view). Nur verfügbar, während Sie an eine Hintergrundsitzung angehängt sind; das Transkript und ein etwaiger Worktree bleiben erhalten. Um die Sitzung abzutrennen, ohne sie zu stoppen, verwenden Sie `/exit` oder drücken Sie `←` |

155| `/subtask <task>` | Starten Sie einen [gegabelten Subagenten](/docs/de/sub-agents#fork-the-current-conversation): einen Hintergrund-Subagenten, der die vollständige Konversation erbt und an der Aufgabe arbeitet, während Sie weiterarbeiten. Sein Ergebnis kehrt zu dieser Konversation zurück, wenn er fertig ist. Um die Konversation stattdessen in eine separate Hintergrund-Sitzung zu kopieren, verwenden Sie `/fork`. Erfordert Claude Code v2.1.212 oder später; auf v2.1.161 bis v2.1.211 ist dieser Befehl `/fork`. Wenn [Agent-Ansicht ausgeschaltet ist](/docs/de/agent-view#turn-off-agent-view), ist `/subtask` nicht verfügbar und `/fork` behält das gegabelte-Subagenten-Verhalten |155| `/subtask <task>` | Startet einen [geforkten Subagenten](/docs/de/sub-agents#fork-the-current-conversation): einen Hintergrund-Subagenten, der die vollständige Konversation erbt und an der Aufgabe arbeitet, während Sie weiterarbeiten. Sein Ergebnis kehrt nach Abschluss in diese Konversation zurück. Um die Konversation stattdessen in eine separate Hintergrundsitzung zu kopieren, verwenden Sie `/fork`. Erfordert Claude Code v2.1.212 oder höher; in v2.1.161 bis v2.1.211 heißt dieser Befehl `/fork`. Wenn die [Agentenansicht ausgeschaltet ist](/docs/de/agent-view#turn-off-agent-view), ist `/subtask` nicht verfügbar, und `/fork` behält das Verhalten des geforkten Subagenten bei |

156| `/tasks` | Zeigen Sie an und verwalten Sie Hintergrundarbeit in der aktuellen Sitzung, einschließlich Subagenten, die fertig sind. Auch verfügbar als `/bashes` |156| `/tasks` | Zeigt die Hintergrundarbeit in der aktuellen Sitzung an und verwaltet sie, einschließlich bereits abgeschlossener Subagenten. Auch als `/bashes` verfügbar |

157| `/team-onboarding` | Generieren Sie einen Team-Onboarding-Leitfaden aus Ihrem Claude Code Nutzungsverlauf. Claude analysiert Ihre Sitzungen, Befehle und MCP-Server-Nutzung der letzten 30 Tage und erstellt einen Markdown-Leitfaden, den ein Teamkollege als erste Nachricht einfügen kann, um schnell eingerichtet zu werden. Für claude.ai Abonnenten in Pro-, Max-, Team- und Enterprise-Plänen gibt es auch einen Share-Link, den Teamkollegen direkt in Claude Code öffnen können |157| `/team-onboarding` | Erstellt aus Ihrem Claude Code-Nutzungsverlauf eine Onboarding-Anleitung für das Team. Claude analysiert Ihre Sitzungen, Befehle und die Nutzung von MCP-Servern der letzten 30 Tage und erstellt eine Markdown-Anleitung, die ein Teammitglied als erste Nachricht einfügen kann, um schnell einsatzbereit zu sein. Für claude.ai-Abonnenten mit Pro-, Max-, Team- und Enterprise-Plänen wird außerdem ein Freigabelink zurückgegeben, den Teammitglieder direkt in Claude Code öffnen können |

158| `/teleport` | Ziehen Sie eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#from-cloud-to-terminal) in dieses Terminal. Öffnet eine Auswahl, dann ruft den Branch und die Konversation ab. Auch verfügbar als `/tp`. Erfordert ein claude.ai Abonnement |158| `/teleport` | Holt eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web#from-cloud-to-terminal) in dieses Terminal. Öffnet eine Auswahl und ruft dann den Branch und die Konversation ab. Auch als `/tp` verfügbar. Erfordert ein claude.ai-Abonnement |

159| `/terminal-setup` | [Installieren Sie eine Shift+Enter Tastenbindung für Zeilenumbrüche](/docs/de/terminal-config#enter-multiline-prompts) in VS Code, Cursor, Devin Desktop, Alacritty oder Zed. In Apple Terminal [aktivieren Sie stattdessen Option+Enter für Zeilenumbrüche und schalten Sie die audible Bell aus](/docs/de/terminal-config#enable-option-key-shortcuts-on-macos). In iTerm2 [schalten Sie Clipboard-Zugriff ein, damit `/copy` funktioniert](/docs/de/terminal-config#enable-option-key-shortcuts-on-macos) |159| `/terminal-setup` | [Installiert eine Shift+Enter-Tastenkombination für Zeilenumbrüche](/docs/de/terminal-config#enter-multiline-prompts) in VS Code, Cursor, Devin Desktop, Alacritty oder Zed. Im Apple Terminal wird stattdessen [Option+Enter für Zeilenumbrüche aktiviert und der akustische Signalton ausgeschaltet](/docs/de/terminal-config#enable-option-key-shortcuts-on-macos). In iTerm2 wird [der Zugriff auf die Zwischenablage eingeschaltet, damit `/copy` funktioniert](/docs/de/terminal-config#enable-option-key-shortcuts-on-macos) |

160| `/theme` | Ändern Sie das Farbschema. Enthält eine `auto` Option, die den hellen oder dunklen Hintergrund Ihres Terminals abgleicht, helle und dunkle Varianten, farbenblind-zugängliche (daltonisierte) Designs, ANSI-Designs, die die Farbpalette Ihres Terminals verwenden, und alle [benutzerdefinierten Designs](/docs/de/terminal-config#create-a-custom-theme) aus `~/.claude/themes/` oder Plugins. Wählen Sie **New custom theme…**, um eines zu erstellen |160| `/theme` | Ändert das Farbdesign. Umfasst eine Option `auto`, die sich an den hellen oder dunklen Hintergrund Ihres Terminals anpasst, helle und dunkle Varianten, farbenblindtaugliche (daltonisierte) Designs, ANSI-Designs, die die Farbpalette Ihres Terminals verwenden, sowie alle [benutzerdefinierten Designs](/docs/de/terminal-config#create-a-custom-theme) aus `~/.claude/themes/` oder aus Plugins. Wählen Sie **New custom theme…**, um eines zu erstellen |

161| `/tui [default\|fullscreen]` | Legen Sie den Terminal-UI-Renderer fest und starten Sie ihn mit Ihrer Konversation intakt neu. `fullscreen` aktiviert den [flimmerfreien Alt-Screen-Renderer](/docs/de/fullscreen). Ohne Argument gibt den aktiven Renderer aus |161| `/tui [default\|fullscreen]` | Legt den Renderer der Terminal-Oberfläche fest und startet mit intakter Konversation neu in diesem Renderer. `fullscreen` aktiviert den [flimmerfreien Alt-Screen-Renderer](/docs/de/fullscreen). Ohne Argument wird der aktive Renderer ausgegeben |

162| `/ultraplan <prompt>` | Entfernt. Verwenden Sie stattdessen [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode). Zuvor sendete eine Planungsaufgabe an eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) zur Überprüfung in Ihrem Browser |162| `/ultraplan <prompt>` | Entfernt. Verwenden Sie stattdessen den [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode). Sendete früher eine Planungsaufgabe an eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) zur Prüfung in Ihrem Browser |

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

164| `/update-config [request]` | **[Skill](/docs/de/skills#bundled-skills).** Beschreiben Sie eine Einstellungsänderung, wie z. B. das Zulassen eines Befehls, das Setzen einer Umgebungsvariablen oder das Hinzufügen eines [Hook](/docs/de/hooks), und Claude bearbeitet die passende [`settings.json`](/docs/de/settings) Datei. Für Optionen wie Design und Modell verwenden Sie stattdessen `/config` |164| `/update-config [request]` | **[Skill](/docs/de/skills#bundled-skills).** Beschreiben Sie eine Einstellungsänderung, etwa das Zulassen eines Befehls, das Setzen einer Umgebungsvariable oder das Hinzufügen eines [Hooks](/docs/de/hooks), und Claude bearbeitet die passende [`settings.json`](/docs/de/settings)-Datei. Für Optionen wie Design und Modell verwenden Sie stattdessen `/config` |

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

166| `/usage` | Zeigen Sie Sitzungskosten, Plan-Nutzungslimits und Aktivitätsstatistiken an. In einem Pro-, Max-, Team- oder Enterprise-Plan enthält eine [Aufschlüsselung, was gegen Ihre Plan-Limits zählt](/docs/de/costs#plan-usage-breakdown). `/cost` und `/stats` sind Aliase |166| `/usage` | Zeigt Sitzungskosten, Nutzungslimits des Plans und Aktivitätsstatistiken an. Bei einem Pro-, Max-, Team- oder Enterprise-Plan ist eine [Aufschlüsselung dessen enthalten, was auf Ihre Planlimits angerechnet wird](/docs/de/costs#plan-usage-breakdown). `/cost` und `/stats` sind Aliasse |

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

168| `/verify` | **[Skill](/docs/de/skills#bundled-skills).** Bestätigen Sie, dass eine Code-Änderung das tut, was sie sollte, indem Sie Ihre Projekt-App erstellen, ausführen und das Ergebnis beobachten, anstatt sich auf Tests oder Typ-Überprüfungen zu verlassen. Siehe [Führen Sie Ihre App aus und überprüfen Sie sie](/docs/de/skills#run-and-verify-your-app) |168| `/verify` | **[Skill](/docs/de/skills#bundled-skills).** Bestätigt, dass eine Codeänderung das tut, was sie soll, indem die App Ihres Projekts gebaut, ausgeführt und das Ergebnis beobachtet wird, statt sich auf Tests oder Typprüfungen zu verlassen. Siehe [App ausführen und verifizieren](/docs/de/skills#run-and-verify-your-app) |

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

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

171| `/web-setup` | Verbinden Sie Ihr GitHub-Konto für [Cloud-Sitzungen](/docs/de/web-quickstart#connect-from-your-terminal) mit Ihren lokalen `gh` CLI-Anmeldedaten |171| `/web-setup` | Verbindet Ihr GitHub-Konto für [Cloud-Sitzungen](/docs/de/web-quickstart#connect-from-your-terminal) mithilfe Ihrer lokalen Anmeldedaten der `gh` CLI |

172| `/workflow-authoring` | **[Skill](/docs/de/skills#bundled-skills).** Laden Sie die Referenz zum Schreiben von [dynamischen Workflow](/docs/de/workflows) Skripten: die Skript-API, Resume-Verhalten, Qualitätsmuster und durchgearbeitete Beispiele. Claude lädt es normalerweise von selbst, bevor ein Skript geschrieben wird; führen Sie es selbst aus, bevor Sie [ein gespeichertes Skript von Hand bearbeiten](/docs/de/workflows#edit-a-saved-script). Verfügbar, wenn dynamische Workflows aktiviert sind, und erfordert Claude Code v2.1.248 oder später |172| `/workflow-authoring` | **[Skill](/docs/de/skills#bundled-skills).** Lädt die Referenz zum Schreiben von Skripten für [dynamische Workflows](/docs/de/workflows): die Skript-API, das Fortsetzungsverhalten, Qualitätsmuster und ausgearbeitete Beispiele. Claude lädt sie normalerweise selbstständig, bevor ein Skript geschrieben wird; führen Sie sie selbst aus, bevor Sie [ein gespeichertes Skript von Hand bearbeiten](/docs/de/workflows#edit-a-saved-script). Verfügbar, wenn dynamische Workflows aktiviert sind, und erfordert Claude Code v2.1.248 oder höher |

173| `/workflows` | Öffnen Sie die [Workflow](/docs/de/workflows#watch-the-run) Fortschrittsansicht, um laufende und abgeschlossene Workflows zu beobachten, zu pausieren, fortzusetzen oder zu speichern |173| `/workflows` | Öffnet die [Workflow](/docs/de/workflows#watch-the-run)-Fortschrittsansicht, um laufende und abgeschlossene Workflows zu beobachten, anzuhalten, fortzusetzen oder zu speichern |

174 174

175<h2 id="how-the-command-menu-matches-what-you-type">175<h2 id="how-the-command-menu-matches-what-you-type">

176 Wie das Befehlsmenü mit Ihrer Eingabe übereinstimmt176 Wie das Befehlsmenü mit Ihrer Eingabe übereinstimmt

debug-your-config.md +4 −2

Details

65 Überprüfen Sie Hooks65 Überprüfen Sie Hooks

66</h2>66</h2>

67 67

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.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, hat Claude Code ihn nicht geladen. Prüfen Sie, ob eine dieser Ursachen vorliegt:

70* Der Hook ist in einer eigenständigen Datei definiert. Hooks gehören unter den Schlüssel `"hooks"` in einer [Einstellungsdatei](/docs/de/settings#settings-files).

71* Der Wert von `matcher` ist ein Array statt einer einzelnen Zeichenkette. Claude Code listet den Eintrag als ungültige Einstellung auf, wenn Sie eine interaktive Sitzung starten, sowie in `claude doctor`. Wenn sich das Array unter `PreToolUse` oder `PermissionRequest` befindet, wird auch keiner der anderen Hooks dieser Datei geladen.

69 72

70Wenn der Hook angezeigt wird, aber nicht ausgelöst wird, ist der Matcher die übliche Ursache. Überprüfen Sie ihn auf diese Fehler:73Wenn der Hook angezeigt wird, aber nicht ausgelöst wird, ist der Matcher die übliche Ursache. Überprüfen Sie ihn auf diese Fehler:

71 74

72* Das Feld `matcher` ist eine einzelne Zeichenkette, die `|` verwendet, um mehrere Tool-Namen zu entsprechen, z. B. `"Edit|Write"`. 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* Das Feld `matcher` ist eine einzelne Zeichenkette, die `|` verwendet, um mehrere Tool-Namen zu entsprechen, z. B. `"Edit|Write"`. 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.

73* Ein falsch geschriebener Tool-Name erzeugt einen Matcher, der nichts entspricht, sodass der Hook stillschweigend fehlschlägt.76* Ein falsch geschriebener Tool-Name erzeugt einen Matcher, der nichts entspricht, sodass der Hook stillschweigend fehlschlägt.

74* 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](/docs/de/managed-settings) löscht Claude Code den gesamten `hooks`-Schlüssel aus der Datei, die das Array enthält, sodass keine Hooks aus dieser Datei gelten. Die anderen Einstellungen der Datei gelten weiterhin, und `claude doctor` listet den gelöschten Schlüssel auf.

75 77

76Wenn Sie `settings.json` bearbeiten, wird die Änderung in der laufenden Sitzung nach einer kurzen Dateistabilitätsverzögerung wirksam, auch wenn Sie die Datei oder den `.claude/`-Ordner des Projekts selbst nach dem Start der Sitzung erstellen. Sie müssen nicht neu starten. Vor v2.1.257 erkannte Claude Code Bearbeitungen in einem `.claude/`-Ordner, der nach dem Start der Sitzung erstellt wurde, nicht.78Wenn Sie `settings.json` bearbeiten, wird die Änderung in der laufenden Sitzung nach einer kurzen Dateistabilitätsverzögerung wirksam, auch wenn Sie die Datei oder den `.claude/`-Ordner des Projekts selbst nach dem Start der Sitzung erstellen. Sie müssen nicht neu starten. Vor v2.1.257 erkannte Claude Code Bearbeitungen in einem `.claude/`-Ordner, der nach dem Start der Sitzung erstellt wurde, nicht.

77 79

env-vars.md +2 −1

Details

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Stall-Timeout in Millisekunden für Subagents. Standard `600000` (10 Minuten); wenn Sie `CLAUDE_STREAM_IDLE_TIMEOUT_MS` erhöhen, während der Stream-Watchdog eingeschaltet ist, steigt der Standard mit ihm, wie [Langsame oder steckengebliebene API-Antworten handhaben](/docs/de/agent-sdk/typescript#handle-slow-or-stalled-api-responses) beschreibt. Der Timer setzt sich bei jedem Streaming-Fortschrittsereignis zurück; wenn kein Fortschritt innerhalb des Fensters ankommt, bricht Claude Code den Subagent ab und meldet den Stall dem übergeordneten |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Stall-Timeout in Millisekunden für Subagents. Standard `600000` (10 Minuten); wenn Sie `CLAUDE_STREAM_IDLE_TIMEOUT_MS` erhöhen, während der Stream-Watchdog eingeschaltet ist, steigt der Standard mit ihm, wie [Langsame oder steckengebliebene API-Antworten handhaben](/docs/de/agent-sdk/typescript#handle-slow-or-stalled-api-responses) beschreibt. Der Timer setzt sich bei jedem Streaming-Fortschrittsereignis zurück; wenn kein Fortschritt innerhalb des Fensters ankommt, bricht Claude Code den Subagent ab und meldet den Stall dem übergeordneten |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Setzen Sie den Prozentsatz (1-100) des Auto-Compact-Fensters, bei dem Auto-Compaction ausgelöst wird. Verwenden Sie niedrigere Werte wie `50`, um früher zu komprimieren; die Variable kann die Schwelle nicht erhöhen, daher werden Werte über dem Standard-Prozentsatz ignoriert. Sie gilt nur in Sitzungen, die [vor dem Kontext-Limit des Modells komprimieren](/docs/de/model-config#context-window-and-auto-compaction). Gilt für Hauptkonversationen und Subagents |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Setzen Sie den Prozentsatz (1-100) des Auto-Compact-Fensters, bei dem Auto-Compaction ausgelöst wird. Verwenden Sie niedrigere Werte wie `50`, um früher zu komprimieren; die Variable kann die Schwelle nicht erhöhen, daher werden Werte über dem Standard-Prozentsatz ignoriert. Sie gilt nur in Sitzungen, die [vor dem Kontext-Limit des Modells komprimieren](/docs/de/model-config#context-window-and-auto-compaction). Gilt für Hauptkonversationen und Subagents |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Setzen Sie auf `1`, um automatisches Backgrounding von lang laufenden Agent-Aufgaben zu erzwingen. Wenn aktiviert, werden Subagents nach etwa zwei Minuten Laufzeit in den Hintergrund verschoben. Aktiviert auch [automatisches Backgrounding von langen MCP-Tool-Aufrufen](/docs/de/mcp#automatic-backgrounding-of-long-tool-calls) im nicht-interaktiven Modus auf Claude Code v2.1.212 oder später |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Setzen Sie auf `1`, um automatisches Backgrounding von lang laufenden Agent-Aufgaben zu erzwingen. Wenn aktiviert, werden Subagents nach etwa zwei Minuten Laufzeit in den Hintergrund verschoben. Aktiviert auch [automatisches Backgrounding von langen MCP-Tool-Aufrufen](/docs/de/mcp#automatic-backgrounding-of-long-tool-calls) im nicht-interaktiven Modus auf Claude Code v2.1.212 oder später |

208| `CLAUDE_AX_PREPARK_MS` | Im [Screen-Reader-Modus](/docs/de/accessibility#what-your-screen-reader-hears) wie viele Millisekunden Claude Code wartet, mit dem Cursor am Anfang der Zeile, bevor es eine neue oder geänderte Zeile schreibt. Standard `50`. Setzen Sie `0`, um sofort zu schreiben. Claude Code begrenzt das Warten auf `5000`. Erfordert Claude Code v2.1.233 oder später |208| `CLAUDE_AX_PREPARK_MS` | Im [Screenreader-Modus](/docs/de/accessibility): wie viele Millisekunden Claude Code wartet, bevor es eine neue oder geänderte Zeile schreibt. Standard `0`, sodass Claude Code nicht wartet. Vor v2.1.287 war der Standard `50`. Claude Code begrenzt die Wartezeit auf `5000`. Erfordert Claude Code v2.1.233 oder neuer |

209| `CLAUDE_AX_SCREEN_READER` | Setzen Sie auf `1`, um Screen-Reader-freundliche Ausgabe zu rendern: flacher Text ohne dekorative Rahmen oder Animationen. Setzen Sie auf `0`, um Screen-Reader-Modus zu erzwingen, auch wenn [`axScreenReader`](/docs/de/settings-reference#axscreenreader) `true` ist. Das [`--ax-screen-reader`](/docs/de/cli-reference#cli-flags)-Flag hat Vorrang. Erfordert Claude Code v2.1.181 oder später |209| `CLAUDE_AX_SCREEN_READER` | Setzen Sie auf `1`, um Screen-Reader-freundliche Ausgabe zu rendern: flacher Text ohne dekorative Rahmen oder Animationen. Setzen Sie auf `0`, um Screen-Reader-Modus zu erzwingen, auch wenn [`axScreenReader`](/docs/de/settings-reference#axscreenreader) `true` ist. Das [`--ax-screen-reader`](/docs/de/cli-reference#cli-flags)-Flag hat Vorrang. Erfordert Claude Code v2.1.181 oder später |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | Im [Screen-Reader-Modus](/docs/de/accessibility) wie viele Millisekunden Claude Code das erste Interface-Rendering nach der Startup-Bestätigungszeile hält, damit Ihr Screen Reader die Zeile vollständig sprechen kann, bevor neue Ausgabe sie unterbricht. Standard `3000`. Setzen Sie `0`, um sofort zu rendern. Claude Code begrenzt das Halten auf `600000` (10 Minuten). Ihr erster Tastendruck beendet das Halten früh. Erfordert Claude Code v2.1.217 oder später |210| `CLAUDE_AX_STARTUP_QUIET_MS` | Im [Screen-Reader-Modus](/docs/de/accessibility) wie viele Millisekunden Claude Code das erste Interface-Rendering nach der Startup-Bestätigungszeile hält, damit Ihr Screen Reader die Zeile vollständig sprechen kann, bevor neue Ausgabe sie unterbricht. Standard `3000`. Setzen Sie `0`, um sofort zu rendern. Claude Code begrenzt das Halten auf `600000` (10 Minuten). Ihr erster Tastendruck beendet das Halten früh. Erfordert Claude Code v2.1.217 oder später |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Kehren Sie nach jedem Bash- oder PowerShell-Befehl in der Hauptsitzung zum ursprünglichen Arbeitsverzeichnis zurück |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Kehren Sie nach jedem Bash- oder PowerShell-Befehl in der Hauptsitzung zum ursprünglichen Arbeitsverzeichnis zurück |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Setzen Sie auf `1`, um [Vollbild-Rendering](/docs/de/fullscreen) zu deaktivieren und den klassischen Main-Screen-Renderer zu verwenden. Die Konversation bleibt in Ihrem Terminal's nativen Scrollback, daher funktionieren `Cmd+f` und tmux Copy-Modus wie gewohnt. Hat Vorrang vor `CLAUDE_CODE_NO_FLICKER` und der [`tui`](/docs/de/settings-reference#tui)-Einstellung. Sie können auch mit `/tui default` wechseln. Gilt nicht für Hintergrund-Sitzungen, die von [Agent-Ansicht](/docs/de/agent-view) geöffnet werden, die immer Vollbild-Rendering verwenden |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Setzen Sie auf `1`, um [Vollbild-Rendering](/docs/de/fullscreen) zu deaktivieren und den klassischen Main-Screen-Renderer zu verwenden. Die Konversation bleibt in Ihrem Terminal's nativen Scrollback, daher funktionieren `Cmd+f` und tmux Copy-Modus wie gewohnt. Hat Vorrang vor `CLAUDE_CODE_NO_FLICKER` und der [`tui`](/docs/de/settings-reference#tui)-Einstellung. Sie können auch mit `/tui default` wechseln. Gilt nicht für Hintergrund-Sitzungen, die von [Agent-Ansicht](/docs/de/agent-view) geöffnet werden, die immer Vollbild-Rendering verwenden |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Setzen Sie auf `1`, um das [Artifact](/docs/de/artifacts)-Tool auszuschalten, das Sitzungsausgabe als private Webseite auf claude.ai veröffentlicht. Sobald Sie es setzen, schaltet keine Einstellungsdatei das Tool wieder ein. Um das Tool stattdessen aus einer Einstellungsdatei auszuschalten, setzen Sie [`enableArtifact`](/docs/de/settings-reference#enableartifact) auf `false`; der veraltete [`disableArtifact`](/docs/de/settings-reference#disableartifact)-Schlüssel schaltet es auch aus |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Setzen Sie auf `1`, um das [Artifact](/docs/de/artifacts)-Tool auszuschalten, das Sitzungsausgabe als private Webseite auf claude.ai veröffentlicht. Sobald Sie es setzen, schaltet keine Einstellungsdatei das Tool wieder ein. Um das Tool stattdessen aus einer Einstellungsdatei auszuschalten, setzen Sie [`enableArtifact`](/docs/de/settings-reference#enableartifact) auf `false`; der veraltete [`disableArtifact`](/docs/de/settings-reference#disableartifact)-Schlüssel schaltet es auch aus |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Setzen Sie auf `1`, um die Anhang-Verarbeitung zu deaktivieren. Datei-Erwähnungen mit `@`-Syntax werden als einfacher Text gesendet, anstatt in Dateiinhalt erweitert zu werden |247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Setzen Sie auf `1`, um die Anhang-Verarbeitung zu deaktivieren. Datei-Erwähnungen mit `@`-Syntax werden als einfacher Text gesendet, anstatt in Dateiinhalt erweitert zu werden |

248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Auf `1` setzen, damit ein Claude-Code-Prozess seinen [`gcpAuthRefresh`](/docs/de/settings-reference#gcpauthrefresh)- oder [`awsAuthRefresh`](/docs/de/settings-reference#awsauthrefresh)-Befehl selbst ausführt, statt zu warten, während ein anderer Prozess ihn ausführt. Erfordert Claude Code v2.1.286 oder neuer |

248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Setzen Sie auf `1`, um [Auto-Memory](/docs/de/memory#auto-memory) zu deaktivieren. Setzen Sie auf `0`, um Auto-Memory zu erzwingen, auch wenn `--bare`-Modus oder [`autoMemoryEnabled: false`](/docs/de/settings-reference#automemoryenabled) es andernfalls deaktivieren würde. Wenn deaktiviert, erstellt oder lädt Claude keine Auto-Memory-Dateien |249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Setzen Sie auf `1`, um [Auto-Memory](/docs/de/memory#auto-memory) zu deaktivieren. Setzen Sie auf `0`, um Auto-Memory zu erzwingen, auch wenn `--bare`-Modus oder [`autoMemoryEnabled: false`](/docs/de/settings-reference#automemoryenabled) es andernfalls deaktivieren würde. Wenn deaktiviert, erstellt oder lädt Claude keine Auto-Memory-Dateien |

249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie auf `1`, um alle Hintergrund-Task-Funktionalität zu deaktivieren, einschließlich des `run_in_background`-Parameters auf Bash- und Subagent-Tools, Auto-Backgrounding und der Ctrl+B-Verknüpfung |250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie auf `1`, um alle Hintergrund-Task-Funktionalität zu deaktivieren, einschließlich des `run_in_background`-Parameters auf Bash- und Subagent-Tools, Auto-Backgrounding und der Ctrl+B-Verknüpfung |

250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Setzen Sie auf `1`, um Claude Code davon abzuhalten, eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort mit fehlender oder leerer `Content-Type`-Header als Amazon Bedrock's binären Event-Stream zu behandeln. Standardmäßig geht Claude Code davon aus, dass ein Gateway den Header aus einer ansonsten unveränderten Antwort gelöscht hat, daher dekodiert es den Body und Streaming funktioniert weiter. Setzen Sie dies nur für ein Gateway, das den Stream auch als Server-Sent-Events erneut ausgibt; Claude Code liest dann den Header-losen Body als Server-Sent-Events statt. Erfordert Claude Code v2.1.239 oder später |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Setzen Sie auf `1`, um Claude Code davon abzuhalten, eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort mit fehlender oder leerer `Content-Type`-Header als Amazon Bedrock's binären Event-Stream zu behandeln. Standardmäßig geht Claude Code davon aus, dass ein Gateway den Header aus einer ansonsten unveränderten Antwort gelöscht hat, daher dekodiert es den Body und Streaming funktioniert weiter. Setzen Sie dies nur für ein Gateway, das den Stream auch als Server-Sent-Events erneut ausgibt; Claude Code liest dann den Header-losen Body als Server-Sent-Events statt. Erfordert Claude Code v2.1.239 oder später |

errors.md +753 −732

Details

186| `The connection dropped while downloading the update` | [Installationsfehler](#the-connection-dropped-while-downloading-the-update) |186| `The connection dropped while downloading the update` | [Installationsfehler](#the-connection-dropped-while-downloading-the-update) |

187| `Download timed out: exceeded the total deadline` | [Installationsfehler](#the-connection-dropped-while-downloading-the-update) |187| `Download timed out: exceeded the total deadline` | [Installationsfehler](#the-connection-dropped-while-downloading-the-update) |

189| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [Befehlszeilenfehler](#conflict-between-a-system-prompt-flag-and-its-file-form) |

189| `Cloud sessions cannot be created from a --restricted session` | [Befehlszeilenfehler](#cloud-sessions-cannot-be-created-from-a-restricted-session) |190| `Cloud sessions cannot be created from a --restricted session` | [Befehlszeilenfehler](#cloud-sessions-cannot-be-created-from-a-restricted-session) |

190| `Cloud sessions are disabled by your organization's policy` | [Befehlszeilenfehler](#cloud-sessions-are-disabled-by-your-organizations-policy) |191| `Cloud sessions are disabled by your organization's policy` | [Befehlszeilenfehler](#cloud-sessions-are-disabled-by-your-organizations-policy) |

191| `Couldn't verify your organization's policy for cloud sessions` | [Befehlszeilenfehler](#cloud-sessions-are-disabled-by-your-organizations-policy) |192| `Couldn't verify your organization's policy for cloud sessions` | [Befehlszeilenfehler](#cloud-sessions-are-disabled-by-your-organizations-policy) |

250| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin-Fehler](#plugin-command-references-user-config) |251| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin-Fehler](#plugin-command-references-user-config) |

251| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin-Fehler](#plugin-command-references-user-config) |252| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin-Fehler](#plugin-command-references-user-config) |

254| `An npm plugin source must name a registry package` | [Plugin-Fehlerbehebung](/docs/de/plugins/troubleshooting#an-npm-plugin-source-must-name-a-registry-package) |

255| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin-Fehler](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |257| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin-Fehler](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |

418 Serverfehler420 Serverfehler

419</h2>421</h2>

420 422

421Die meisten dieser Fehler stammen vom Inferenzanbieter: Anthropic's Service auf der Anthropic API und dem Service hinter dem Endpunkt dieses Anbieters auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem benutzerdefinierten Gateway. [Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen](#auto-mode-cannot-determine-the-safety-of-an-action) und [Agent wurde vorzeitig aufgrund eines API-Fehlers beendet](#agent-terminated-early-due-to-an-api-error) behandeln auch Ursachen auf Ihrer Seite, wie z. B. ein Amazon Bedrock-Konto, das das Klassifizierungsmodell nicht aufrufen kann, oder einen Subagenten, der ein Nutzungslimit erreicht hat.423Die meisten dieser Fehler stammen vom Inferenzanbieter: Anthropic's Service auf der Anthropic API und dem Service hinter dem Endpunkt dieses Anbieters auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem benutzerdefinierten Gateway. [Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen](#auto-mode-cannot-determine-the-safety-of-an-action) und [Agent wurde vorzeitig aufgrund eines API-Fehlers beendet](#agent-terminated-early-due-to-an-api-error) behandeln auch Ursachen auf Ihrer Seite, wie z. B. ein Amazon Bedrock-Konto, das das Klassifikatormodell nicht aufrufen kann, oder einen Subagenten, der ein Nutzungslimit erreicht hat.

422 424

423<h3 id="api-error-500-internal-server-error">425<h3 id="api-error-500-internal-server-error">

424 API-Fehler: 500 Interner Serverfehler426 API-Fehler: 500 Interner Serverfehler

430API 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.432API 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.

431```433```

432 434

433Der abschließende Satz nennt den Ort, an dem die Serviceintegrität überprüft werden kann, und variiert je nach Anbieter. Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry-Konfigurationen nennen die Servicestatuseite dieses Anbieters. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` nennt den Gateway-Host.435Der abschließende Satz nennt den Ort, an dem die Serviceintegrität überprüft werden kann, und variiert je nach Anbieter. Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry-Konfigurationen nennen die Servicestatusseite dieses Anbieters. Eine benutzerdefinierte `ANTHROPIC_BASE_URL` nennt den Gateway-Host.

434 436

435Ein 5xx von der API selbst zeigt einen unerwarteten Fehler innerhalb der API an. Er wird nicht durch Ihren Prompt, Ihre Einstellungen oder Ihr Konto verursacht.437Ein 5xx von der API selbst zeigt einen unerwarteten Fehler innerhalb der API an. Er wird nicht durch Ihren Prompt, Ihre Einstellungen oder Ihr Konto verursacht.

436 438

437Wenn ein Proxy, Load Balancer oder Gateway mit einer HTML-Fehlerseite antwortet, zeigt die Nachricht den Statuscode und den Titel der Seite an, wie z. B. `API Error: 502 Bad Gateway`. Für eine Seite ohne Titel zeigt die Nachricht den Statuscode und seinen Standardnamen stattdessen an. Vor v2.1.281 wurde der Statuscode gelöscht, wenn die Seite einen Titel hatte, und das rohe Markup der Seite wurde gedruckt, wenn sie keinen hatte.439Wenn ein Proxy, Load Balancer oder Gateway mit einer HTML-Fehlerseite antwortet, zeigt die Nachricht den Statuscode und den Titel der Seite an, wie z. B. `API Error: 502 Bad Gateway`. Für eine Seite ohne Titel zeigt die Nachricht stattdessen den Statuscode und seinen Standardnamen an. Vor v2.1.281 wurde der Statuscode weggelassen, wenn die Seite einen Titel hatte, und das rohe Markup der Seite wurde ausgegeben, wenn sie keinen hatte.

438 440

439**Was zu tun ist:**441**Was zu tun ist:**

440 442

441* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die im Fehler genannte Anbieter-Statusseite auf aktive Vorfälle443* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die in der Nachricht genannte Anbieter-Statusseite auf aktive Vorfälle

442* Warten Sie eine Minute und senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht befindet sich noch in der Konversation, sodass Sie bei einem langen Prompt `try again` eingeben können, anstatt alles erneut einzufügen.444* Warten Sie eine Minute und senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht befindet sich noch in der Konversation, sodass Sie bei einem langen Prompt `try again` eingeben können, anstatt alles erneut einzufügen.

443* 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.445* 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.

444 446

446 API-Fehler: Wiederholte 529 Overloaded-Fehler448 API-Fehler: Wiederholte 529 Overloaded-Fehler

447</h3>449</h3>

448 450

449Die API ist vorübergehend über alle Benutzer hinweg ausgelastet. Claude Code hat bereits mehrmals versucht, bevor diese Nachricht angezeigt wird:451Die API ist vorübergehend über alle Benutzer hinweg ausgelastet. Claude Code hat es bereits mehrmals erneut versucht, bevor diese Nachricht angezeigt wird:

450 452

451```text theme={null}453```text theme={null}

452API 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.454API 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.

458 460

459**Was zu tun ist:**461**Was zu tun ist:**

460 462

461* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die im Fehler genannte Anbieter-Statusseite auf Kapazitätsmitteilungen463* Überprüfen Sie [status.claude.com](https://status.claude.com) oder die in der Nachricht genannte Anbieter-Statusseite auf Kapazitätsmitteilungen

462* Versuchen Sie es in ein paar Minuten erneut464* Versuchen Sie es in ein paar Minuten erneut

463* Führen Sie `/model` aus und wechseln Sie zu einem anderen Modell, um weiterarbeiten zu können, da die Kapazität pro Modell verfolgt wird. Claude Code fordert Sie dazu auf, wenn ein Modell unter besonders hoher Last steht, z. B. `Opus is experiencing high load, please use /model to switch to Sonnet`. Bei Fable-Modellen nennt die Nachricht Fable.465* Führen Sie `/model` aus und wechseln Sie zu einem anderen Modell, um weiterarbeiten zu können, da die Kapazität pro Modell verfolgt wird. Claude Code fordert Sie dazu auf, wenn ein Modell unter besonders hoher Last steht, z. B. `Opus is experiencing high load, please use /model to switch to Sonnet`. Bei Fable-Modellen nennt die Nachricht Fable.

464 466

474Request timed out476Request timed out

475```477```

476 478

477Dies 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.479Dies kann während Zeiten hoher Last auftreten oder wenn das Modell eine sehr große Antwort generiert. Der Standard-Timeout für Anfragen beträgt 10 Minuten.

478 480

479**Was zu tun ist:**481**Was zu tun ist:**

480 482

486 Keine Antwort von der API488 Keine Antwort von der API

487</h3>489</h3>

488 490

489Claude Code hat eine Streaming-Anfrage gesendet und die API hat keine Antwortheader innerhalb der Frist für das erste Byte zurückgegeben, sodass Claude Code die Anfrage abgebrochen hat, anstatt auf das vollständige `API_TIMEOUT_MS`-Anfrage-Zeitlimit von standardmäßig 10 Minuten zu warten. Claude Code sendet die Anfrage höchstens einmal erneut, wenn das [Wiederholungsbudget](#tune-retry-behavior) dies zulässt. Wenn die Wiederholung auch unbeantwortet bleibt, endet der Zug mit dieser Nachricht, die anzeigt, wie lange jeder Versuch gewartet hat. Wenn Sie [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/de/env-vars) setzen, gilt die Einfach-Wiederholung nicht und Claude Code versucht es unter dem in [Wiederholungsverhalten abstimmen](#tune-retry-behavior) beschriebenen Budget erneut.491Claude Code hat eine Streaming-Anfrage gesendet und die API hat keine Response-Header innerhalb der Frist für das erste Byte zurückgegeben, sodass Claude Code die Anfrage abgebrochen hat, anstatt auf den vollständigen `API_TIMEOUT_MS`-Anfrage-Timeout von standardmäßig 10 Minuten zu warten. Claude Code sendet die Anfrage höchstens einmal erneut, wenn das [Wiederholungsbudget](#tune-retry-behavior) dies zulässt. Wenn auch der Wiederholungsversuch unbeantwortet bleibt, endet der Turn mit dieser Nachricht, die anzeigt, wie lange jeder Versuch gewartet hat. Wenn Sie [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/de/env-vars) setzen, gilt die Begrenzung auf einen Wiederholungsversuch nicht und Claude Code versucht es unter dem in [Wiederholungsverhalten abstimmen](#tune-retry-behavior) beschriebenen Budget erneut.

490 492

491```text theme={null}493```text theme={null}

492API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.494API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.

493```495```

494 496

495Claude Code setzt die Wartezeit für Antwortheader des ersten Versuchs und die Wiederholung separat:497Claude Code legt die Wartezeit des ersten Versuchs auf Response-Header und die des Wiederholungsversuchs separat fest:

496 498

497* **Erster Versuch**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/de/env-vars), wenn Sie es auf 1 oder mehr setzen, begrenzt auf zwischen 10 Sekunden und 30 Minuten. Andernfalls verwendet Claude Code das Byte-Level-Watchdog-Zeitlimit, das in [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) aufgelistet ist, sodass die Variablen, die dieses Zeitlimit ändern, auch diese Wartezeit ändern. In jedem Fall fügt Claude Code eine Sekunde für alle 32 KB des Anfragekörpers hinzu.499* **Erster Versuch**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/de/env-vars), wenn Sie es auf 1 oder mehr setzen, begrenzt auf zwischen 10 Sekunden und 30 Minuten. Andernfalls verwendet Claude Code den Byte-Level-Watchdog-Timeout, der in [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs) aufgelistet ist, sodass die Variablen, die diesen Timeout ändern, auch diese Wartezeit ändern. In jedem Fall fügt Claude Code eine Sekunde für alle 32 KB des Anfragekörpers hinzu.

498* **Wiederholung**: eine Sekunde weniger als `API_TIMEOUT_MS`, knapp unter 10 Minuten standardmäßig, damit die Wiederholung länger als ein Proxy oder Gateway dauern kann, das die Antwort bis zum Abschluss der Generierung hält. Bei Amazon Bedrock verwendet die Wiederholung die gleiche Frist wie der erste Versuch, und die Nachricht zeigt eine Dauer statt zwei an.500* **Wiederholungsversuch**: eine Sekunde weniger als `API_TIMEOUT_MS`, standardmäßig knapp unter 10 Minuten, damit der Wiederholungsversuch einen Proxy oder ein Gateway überdauern kann, das die Antwort bis zum Abschluss der Generierung zurückhält. Bei Amazon Bedrock verwendet der Wiederholungsversuch die gleiche Frist wie der erste Versuch, und die Nachricht zeigt eine Dauer statt zwei an.

499 501

500Keine Wartezeit überschreitet eine Sekunde weniger als ein positives `API_TIMEOUT_MS`, und ein positives `API_TIMEOUT_MS` unter 11 Sekunden deaktiviert die Frist. Der Byte-Level-Watchdog startet erst, nachdem die Antwortheader ankommen, sodass eine Antwort, die nach diesem Punkt das Senden von Bytes stoppt, stattdessen den [Stalled-Stream-Regeln](#automatic-retries) folgt.502Keine Wartezeit überschreitet eine Sekunde weniger als ein positives `API_TIMEOUT_MS`, und ein positives `API_TIMEOUT_MS` unter 11 Sekunden deaktiviert die Frist. Der Byte-Level-Watchdog startet erst, nachdem die Response-Header ankommen, sodass eine Antwort, die danach das Senden von Bytes einstellt, stattdessen den [Stalled-Stream-Regeln](#automatic-retries) folgt.

501 503

502**Was zu tun ist:**504**Was zu tun ist:**

503 505

504* Senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht befindet sich noch in der Konversation, sodass Sie bei einem langen Prompt `try again` eingeben können, anstatt alles erneut einzufügen.506* Senden Sie Ihre Nachricht erneut. Ihre ursprüngliche Nachricht befindet sich noch in der Konversation, sodass Sie bei einem langen Prompt `try again` eingeben können, anstatt alles erneut einzufügen.

505* Wenn es sich wiederholt, behandeln Sie es als [Netzwerk- oder Proxy-Problem](#unable-to-connect-to-api).507* Wenn es sich wiederholt, behandeln Sie es als [Netzwerk- oder Proxy-Problem](#unable-to-connect-to-api).

506* Wenn ein Proxy oder Gateway in Ihrem Netzwerk Antworten bis zum Abschluss hält, erhöhen Sie `API_TIMEOUT_MS`, damit die Wiederholung länger wartet. Bei Amazon Bedrock erhöhen Sie auch `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`.508* Wenn ein Proxy oder Gateway in Ihrem Netzwerk Antworten bis zum Abschluss zurückhält, erhöhen Sie `API_TIMEOUT_MS`, damit der Wiederholungsversuch länger wartet. Bei Amazon Bedrock erhöhen Sie auch `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`.

507* Wenn der erste Versuch immer das Zeitlimit überschreitet und die Wiederholung dann erfolgreich ist, erhöhen Sie `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`, damit der erste Versuch auch lange genug wartet.509* Wenn beim ersten Versuch immer wieder eine Zeitüberschreitung auftritt und der Wiederholungsversuch dann erfolgreich ist, erhöhen Sie `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`, damit auch der erste Versuch lange genug wartet.

508 510

509Vor v2.1.242 wartete Claude Code auf das vollständige `API_TIMEOUT_MS`-Anfrage-Zeitlimit von standardmäßig 10 Minuten, bevor eine unbeantwortete Streaming-Anfrage fehlschlug. Vor v2.1.261 wartete die Wiederholung auf die gleiche Frist wie der erste Versuch und die Nachricht zeigte keine Dauern an.511Vor v2.1.242 wartete Claude Code auf den vollständigen `API_TIMEOUT_MS`-Anfrage-Timeout von standardmäßig 10 Minuten, bevor eine unbeantwortete Streaming-Anfrage fehlschlug. Vor v2.1.261 wartete der Wiederholungsversuch die gleiche Frist wie der erste Versuch und die Nachricht zeigte keine Dauern an.

510 512

511<h3 id="the-response-above-may-be-incomplete">513<h3 id="the-response-above-may-be-incomplete">

512 Die obige Antwort kann unvollständig sein514 Die obige Antwort kann unvollständig sein

513</h3>515</h3>

514 516

515Eine Streaming-Anfrage ist fehlgeschlagen, während die Antwort noch in Bearbeitung war, nachdem Claude einen Textblock oder einen Toolaufruf abgeschlossen hatte oder einen nach Abschluss des Denkens gestartet hatte. Das erneute Senden der Anfrage könnte die gleichen Toolaufrufe zweimal ausführen, sodass Claude Code die Ausgabe behält, die Claude abgeschlossen hat, und stattdessen diese Mitteilung anfügt, anstatt den Zug zu verwerfen. Welche Variante Sie sehen, nennt die Ursache:517Eine Streaming-Anfrage ist fehlgeschlagen, während die Antwort noch in Bearbeitung war, nachdem Claude einen Textblock oder einen Tool-Aufruf abgeschlossen oder nach Abschluss seines Thinking einen begonnen hatte. Das erneute Senden der Anfrage könnte die gleichen Tool-Aufrufe zweimal ausführen, sodass Claude Code die Ausgabe behält, die Claude abgeschlossen hat, und diese Mitteilung anfügt, anstatt den Turn zu verwerfen. Welche Variante Sie sehen, nennt die Ursache:

516 518

517```text theme={null}519```text theme={null}

518API Error: Server error mid-response. The response above may be incomplete.520API Error: Server error mid-response. The response above may be incomplete.

523API Error: The response stream was malformed. The response above may be incomplete.525API Error: The response stream was malformed. The response above may be incomplete.

524```526```

525 527

526* `Server error mid-response`: ein Mid-Stream-Overload- oder 5xx-Serverfehler. Diese Variante erfordert Claude Code v2.1.199 oder später; davor verwarf dieser Fall die Teilausgabe und meldete den gesamten Zug als Fehler.528* `Server error mid-response`: ein Overload- oder 5xx-Serverfehler mitten im Stream. Diese Variante erfordert Claude Code v2.1.199 oder später; davor verwarf dieser Fall die Teilausgabe und meldete den gesamten Turn als Fehler.

527* `Connection lost mid-response`: die Verbindung wurde unterbrochen. Sie sehen diese Variante auch, wenn ein Proxy oder Gateway die Antworttexte sauber beendet, bevor die Antwort abgeschlossen ist.529* `Connection lost mid-response`: die Verbindung wurde unterbrochen. Sie sehen diese Variante auch, wenn ein Proxy oder Gateway den Response-Body sauber beendet, bevor die Antwort abgeschlossen ist.

528* `Your computer went to sleep mid-response`: Claude Code hat erkannt, dass Ihr Computer in den Ruhezustand gegangen ist, während die Antwort gestreamt wurde. Sobald Ihr Computer aufwacht, behandelt Claude Code die Verbindung als unterbrochen und stoppt das Lesen von ihr.530* `Your computer went to sleep mid-response`: Claude Code hat erkannt, dass Ihr Computer in den Ruhezustand gegangen ist, während die Antwort gestreamt wurde. Sobald Ihr Computer aufwacht, behandelt Claude Code die Verbindung als unterbrochen und liest nicht mehr von ihr.

529* `Part of the response never arrived`: ein Stream-Ereignis wurde zwischen der API und Claude Code gelöscht, sodass ein späteres Ereignis auf Inhalte verwies, die nie ankamen. Vor v2.1.281 endete dieser Fall den Zug mit `API Error: Content block not found`.531* `Part of the response never arrived`: ein Stream-Ereignis ging zwischen der API und Claude Code verloren, sodass ein späteres Ereignis auf Inhalte verwies, die nie ankamen. Vor v2.1.281 beendete dieser Fall den Turn mit `API Error: Content block not found`.

530* `The response stream was malformed`: ein Ereignis kam für einen Inhaltsblock an, der bereits abgeschlossen war, oder ein Ereignis kam beschädigt an. Ein beschädigtes Ereignis ist eines, dessen Daten kein gültiges JSON sind, dessen Inhalt fehlt oder dessen Inhalt nicht dem Ereignistyp entspricht. Vor v2.1.284 erschien der Fehler des Parsers, wie z. B. einer, der mit `API Error: JSON Parse error` beginnt, stattdessen, wenn ein Ereignis mit ungültigem JSON ankam, nachdem Claude sein Denken, einen Textblock oder einen Toolaufruf abgeschlossen hatte.532* `The response stream was malformed`: ein Ereignis kam für einen Inhaltsblock an, der bereits abgeschlossen war, oder ein Ereignis kam beschädigt an. Ein beschädigtes Ereignis ist eines, dessen Daten kein gültiges JSON sind, dessen Inhalt fehlt oder dessen Inhalt nicht dem Ereignistyp entspricht. Vor v2.1.284 erschien stattdessen der rohe Fehler des Parsers, wie z. B. einer, der mit `API Error: JSON Parse error` beginnt, wenn ein Ereignis mit ungültigem JSON ankam, nachdem Claude sein Thinking, einen Textblock oder einen Tool-Aufruf abgeschlossen hatte. Vor v2.1.287 erschien diese Variante anstelle der Nachricht des Guardrails, wenn ein [Amazon Bedrock Guardrail](/docs/de/amazon-bedrock#aws-guardrails) eine Antwort blockierte, die bereits Thinking und etwas Text gestreamt hatte.

531* `The response stopped arriving`: die Verbindung blieb offen, aber stoppte die Datenlieferung, sodass der Streaming-Idle-Watchdog sie abgebrochen hat. Vor v2.1.222 konnte Claude Code diesen Fehler auch auf [Gateway](/docs/de/gateways)-Verbindungen melden, die über `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` erreicht wurden, während die Keep-Alive-Pings des Servers noch ankamen, da es dort nur geparste Antwortereignisse zählte; ein Upgrade stoppt diese falschen Zeitüberschreitungen auf diesen Routen. Gateways, die über eine Anbieter-Basis-URL wie `ANTHROPIC_BEDROCK_BASE_URL` erreicht werden, sind nicht vom Byte-Watchdog umhüllt; siehe [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs).533* `The response stopped arriving`: die Verbindung blieb offen, lieferte aber keine Daten mehr, sodass der Streaming-Idle-Watchdog sie abgebrochen hat. Vor v2.1.222 konnte Claude Code diesen Fehler auch bei [Gateway](/docs/de/gateways)-Verbindungen melden, die über `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AWS_BASE_URL` erreicht wurden, während die Keep-Alive-Pings des Servers noch ankamen, da es dort nur geparste Antwortereignisse zählte; ein Upgrade beseitigt diese falschen Zeitüberschreitungen auf diesen Routen. Gateways, die über eine Anbieter-Basis-URL wie `ANTHROPIC_BEDROCK_BASE_URL` erreicht werden, sind nicht vom Byte-Watchdog umhüllt; siehe [Streaming-Idle-Watchdogs](/docs/de/network-config#streaming-idle-watchdogs).

532 534

533Vor v2.1.227 las `Connection lost mid-response` `Connection closed mid-response` und `The response stopped arriving` las `Response stalled mid-stream`.535Vor v2.1.227 lautete `Connection lost mid-response` noch `Connection closed mid-response` und `The response stopped arriving` noch `Response stalled mid-stream`.

534 536

535Wenn ein gelöschtes, dupliziertes oder beschädigtes Stream-Ereignis ankommt, bevor Claude mit Text oder Toolaufruf begonnen hat, sehen Sie diese Mitteilung nicht:537Wenn ein verlorenes, dupliziertes oder beschädigtes Stream-Ereignis ankommt, bevor Claude mit Text oder einem Tool-Aufruf begonnen hat, sehen Sie diese Mitteilung nicht:

536 538

537* Wenn Claude nur sein Denken abgeschlossen hatte, gibt Claude Code die Anfrage erneut aus. Wenn die erneut ausgegebenen Streams auf die gleiche Weise unterbrochen werden, endet der Zug mit `Part of the response never arrived and no response was produced. Try again.` oder `The response stream was malformed and no response was produced. Try again.`539* Wenn Claude nur sein Thinking abgeschlossen hatte, sendet Claude Code die Anfrage erneut. Wenn die erneut gesendeten Streams auf die gleiche Weise abbrechen, endet der Turn mit `Part of the response never arrived and no response was produced. Try again.` oder `The response stream was malformed and no response was produced. Try again.`

538* Wenn nichts abgeschlossen war, sendet Claude Code die Anfrage stattdessen ohne Streaming erneut. Wenn Sie diesen Fallback mit [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/de/env-vars) deaktiviert haben, endet der Zug mit `API Error: Content block not found` für ein gelöschtes Ereignis oder `API Error: Content block already closed` für ein dupliziertes. Für ein beschädigtes Ereignis mit deaktiviertem Fallback endet der Zug mit `API Error: Stream event unreadable` oder dem Fehler des Parsers.540* Wenn nichts abgeschlossen war, sendet Claude Code die Anfrage stattdessen ohne Streaming erneut. Wenn Sie diesen Fallback mit [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/de/env-vars) deaktiviert haben, endet der Turn mit `API Error: Content block not found` für ein verlorenes Ereignis oder `API Error: Content block already closed` für ein dupliziertes. Für ein beschädigtes Ereignis mit deaktiviertem Fallback endet der Turn mit `API Error: Stream event unreadable` oder dem rohen Fehler des Parsers.

539 541

540In vier Fällen behandelt Claude Code den Fehler, ohne diese Mitteilung sofort anzuzeigen:542In vier Fällen behandelt Claude Code den Fehler, ohne diese Mitteilung sofort anzuzeigen:

541 543

542* Früher in der Antwort versucht Claude Code entweder, den Fehler erneut zu versuchen, oder beendet den Zug mit einem anderen Fehler. Siehe [Automatische Wiederholungen](#automatic-retries).544* Früher in der Antwort versucht Claude Code den Fehler entweder erneut oder beendet den Turn mit einem anderen Fehler. Siehe [Automatische Wiederholungen](#automatic-retries).

543* Wenn einer dieser Fehler ankommt, nachdem Claude die Antwort abgeschlossen hat, behält Claude Code die vollständige Antwort und beendet den Zug normal, ohne diese Mitteilung. Vor v2.1.222 zeigte Claude Code diese Mitteilung an, wenn die Verbindung nach Abschluss der Antwort unterbrochen wurde oder stagnierte, und meldete den Zug als Fehler, obwohl die Antwort vollständig war.545* Wenn einer dieser Fehler ankommt, nachdem Claude die Antwort abgeschlossen hat, behält Claude Code die vollständige Antwort und beendet den Turn normal, ohne diese Mitteilung. Vor v2.1.222 zeigte Claude Code diese Mitteilung an, wenn die Verbindung nach Abschluss der Antwort unterbrochen wurde oder stockte, und meldete den Turn als Fehler, obwohl die Antwort vollständig war.

544* In einer [nicht-interaktiven Sitzung](/docs/de/headless), wie z. B. ein `-p`-Lauf, ein [Agent SDK](/docs/de/agent-sdk/overview)-Lauf oder eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web), müssen Sie nicht selbst `continue` senden, wenn die abgeschnittene Antwort in der Hauptkonversation ist und Text, aber keine Toolaufrufe enthält: Claude Code behält die Teilausgabe und fordert Claude auf, von dort aus fortzufahren, wo es gestoppt hat, bis zu dreimal hintereinander. Sie sehen diese Mitteilung für eine solche Antwort nur, wenn Claude Code diese Fortsetzungen aufgebraucht hat. Vor v2.1.246 beendete Claude Code einen nicht-interaktiven Zug mit dieser Mitteilung beim ersten Abschnitt.546* In einer [nicht interaktiven Sitzung](/docs/de/headless), wie z. B. einem `-p`-Lauf, einem [Agent SDK](/docs/de/agent-sdk/overview)-Lauf oder einer [Cloud-Sitzung](/docs/de/claude-code-on-the-web), müssen Sie nicht selbst `continue` senden, wenn die abgeschnittene Antwort in der Hauptkonversation ist und Text, aber keine Tool-Aufrufe enthält: Claude Code behält die Teilausgabe und fordert Claude auf, dort fortzufahren, wo es aufgehört hat, bis zu dreimal hintereinander. Sie sehen diese Mitteilung für eine solche Antwort erst, wenn Claude Code diese Fortsetzungen aufgebraucht hat. Vor v2.1.246 beendete Claude Code einen nicht interaktiven Turn beim ersten Abbruch mit dieser Mitteilung.

545* In einem [Subagenten](/docs/de/sub-agents#api-errors-in-subagents), unabhängig davon, ob die Sitzung interaktiv ist oder nicht: Wenn seine abgeschnittene Antwort Text, aber keine Toolaufrufe enthält, fordert Claude Code den Subagenten auf, fortzufahren. Die Mitteilung wird zur letzten Nachricht des Subagenten erst, wenn diese Fortsetzungen aufgebraucht sind. Vor v2.1.257 zeigte ein Subagent diese Mitteilung beim ersten Abschnitt an.547* In einem [Subagenten](/docs/de/sub-agents#api-errors-in-subagents), unabhängig davon, ob die Sitzung interaktiv ist oder nicht: Wenn seine abgeschnittene Antwort Text, aber keine Tool-Aufrufe enthält, fordert Claude Code den Subagenten auf, fortzufahren. Die Mitteilung wird erst dann zur letzten Nachricht des Subagenten, wenn diese Fortsetzungen aufgebraucht sind. Vor v2.1.257 zeigte ein Subagent diese Mitteilung beim ersten Abbruch an.

546 548

547**Was zu tun ist:**549**Was zu tun ist:**

548 550

549* Lesen Sie in einer interaktiven Sitzung die Antwort, die auf dem Bildschirm verbleibt: Claude Code behält jeden Block, den Claude vor dem Fehler abgeschlossen hat, aber verwirft einen unterbrochenen letzten Block, wenn der Zug endet, sodass die letzten Sätze oder Toolaufrufe möglicherweise fehlen. Antworten Sie mit `continue`, damit Claude von seinem letzten abgeschlossenen Block aus fortfährt.551* Lesen Sie in einer interaktiven Sitzung die Antwort, die auf dem Bildschirm verbleibt: Claude Code behält jeden Block, den Claude vor dem Fehler abgeschlossen hat, verwirft aber einen unterbrochenen letzten Block, wenn der Turn endet, sodass die letzten Sätze oder Tool-Aufrufe möglicherweise fehlen. Antworten Sie mit `continue`, damit Claude ab seinem letzten abgeschlossenen Block fortfährt.

550* Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`):552* Im [nicht interaktiven Modus](/docs/de/headless) (`-p`):

551 * Mit der Standard-Textausgabe druckt Claude Code den letzten abgeschlossenen Textblock, den es noch von früher im Zug hält, gefolgt von dieser Nachricht. Wenn es keinen hält, druckt Claude Code diese Nachricht allein, z. B. weil Claude Code die Konversation mitten im Zug komprimiert und diesen Text gelöscht hat. Vor v2.1.219 druckte Claude Code nur diese Nachricht in `-p`-Textausgabe und verwarf die bereits erzeugte Antwort.553 * Mit der Standard-Textausgabe gibt Claude Code den letzten abgeschlossenen Textblock aus, den es noch von früher im Turn vorhält, gefolgt von dieser Nachricht. Wenn es keinen vorhält, gibt Claude Code diese Nachricht allein aus, z. B. weil Claude Code die Konversation mitten im Turn komprimiert und diesen Text entfernt hat. Vor v2.1.219 gab Claude Code in der `-p`-Textausgabe nur diese Nachricht aus und verwarf die bereits erzeugte Antwort.

552 * Mit `--output-format json` oder `stream-json` meldet Claude Code diese Nachricht im `result`-Feld.554 * Mit `--output-format json` oder `stream-json` meldet Claude Code diese Nachricht im `result`-Feld.

553 * Um den Zug fortzusetzen, sobald die Verbindung stabil ist, setzen Sie die Sitzung fort und senden Sie `continue` wie in [Konversationen fortsetzen](/docs/de/headless#continue-conversations) beschrieben.555 * Um den Turn fortzusetzen, sobald die Verbindung stabil ist, setzen Sie die Sitzung fort und senden Sie `continue` wie in [Konversationen fortsetzen](/docs/de/headless#continue-conversations) beschrieben.

554 556

555<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">557<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">

556 Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen558 Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen

557</h3>559</h3>

558 560

559Das Modell, das der [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) zum Klassifizieren von Aktionen verwendet, konnte keine Entscheidung treffen, sodass der Auto-Modus die Aktion nicht automatisch genehmigt hat. Die Nachricht, die Sie sehen, hängt davon ab, wie der Klassifizierer fehlgeschlagen ist.561Das Modell, das der [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) zum Klassifizieren von Aktionen verwendet, konnte keine Entscheidung treffen, sodass der Auto-Modus die Aktion nicht automatisch genehmigt hat. Die Nachricht, die Sie sehen, hängt davon ab, wie der Klassifikator fehlgeschlagen ist.

560 562

561Lesevorgänge, Suchen und Bearbeitungen in Ihrem Arbeitsverzeichnis überspringen den Klassifizierer, sodass sie in all diesen Fällen weiterhin funktionieren.563Lesevorgänge, Suchen und Bearbeitungen in Ihrem Arbeitsverzeichnis überspringen den Klassifikator, sodass sie in all diesen Fällen weiterhin funktionieren.

562 564

563Wenn das Klassifizierungsmodell nicht verfügbar ist:565Wenn das Klassifikatormodell nicht verfügbar ist:

564 566

565```text theme={null}567```text theme={null}

566<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.568<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.

567```569```

568 570

569Wenn Claude Code die Fehlerkategorie bestimmen kann, nennt es die Kategorie in Klammern nach `temporarily unavailable`, z. B. `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Die Kategorien sind `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` und `(connection failed)`. Wenn `(timed out)` oder `(connection failed)` sich wiederholt, überprüfen Sie Ihre Verbindung; siehe [Kann keine Verbindung zur API herstellen](#unable-to-connect-to-api). Vor v2.1.229 nannte die Nachricht nie eine Kategorie und las `Wait briefly and then try this action again`.571Wenn Claude Code die Fehlerkategorie bestimmen kann, nennt es die Kategorie in Klammern nach `temporarily unavailable`, z. B. `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Die Kategorien sind `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` und `(connection failed)`. Wenn sich `(timed out)` oder `(connection failed)` wiederholt, überprüfen Sie Ihre Verbindung; siehe [Kann keine Verbindung zur API herstellen](#unable-to-connect-to-api). Vor v2.1.229 nannte die Nachricht nie eine Kategorie und lautete `Wait briefly and then try this action again`.

570 572

571Wenn keine Kategorie passt, wird die Nachricht ohne Kategorie in Klammern angezeigt; mehr als ein Fehler erzeugt diese Form. Bei [Amazon Bedrock](/docs/de/amazon-bedrock), einschließlich des [Mantle-Endpunkts](/docs/de/amazon-bedrock#use-the-mantle-endpoint), wird es auch angezeigt, wenn Ihr AWS-Konto das im Fehler genannte Modell nicht aufrufen kann, und dieser Fehler wiederholt sich bei jedem Wiederholungsversuch, bis Ihrem Konto Zugriff auf das Modell gewährt wird.573Wenn keine Kategorie passt, wird die Nachricht ohne Kategorie in Klammern angezeigt; mehr als ein Fehler erzeugt diese Form. Bei [Amazon Bedrock](/docs/de/amazon-bedrock), einschließlich des [Mantle-Endpunkts](/docs/de/amazon-bedrock#use-the-mantle-endpoint), wird sie auch angezeigt, wenn Ihr AWS-Konto das in der Nachricht genannte Modell nicht aufrufen kann, und dieser Fehler wiederholt sich bei jedem Wiederholungsversuch, bis Ihrem Konto Zugriff auf das Modell gewährt wird.

572 574

573**Was zu tun ist:**575**Was zu tun ist:**

574 576

575* Versuchen Sie es nach ein paar Sekunden erneut; Claude sieht die gleiche Nachricht und versucht normalerweise automatisch erneut. Ein vorübergehender Fehler ist nicht mit der [Auto-Modus-Berechtigung](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) verbunden; Sie müssen die Einstellungen nicht ändern577* Versuchen Sie es nach ein paar Sekunden erneut; Claude sieht die gleiche Nachricht und versucht es normalerweise selbstständig erneut. Ein vorübergehender Fehler hat nichts mit der [Auto-Modus-Berechtigung](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) zu tun; Sie müssen die Einstellungen nicht ändern

576* Wenn Wiederholungsversuche weiterhin fehlschlagen, fahren Sie mit schreibgeschützten Aufgaben fort und kehren Sie später zur blockierten Aktion zurück578* Wenn Wiederholungsversuche weiterhin fehlschlagen, fahren Sie mit nur lesenden Aufgaben fort und kehren Sie später zur blockierten Aktion zurück

577* Bei Amazon Bedrock, wenn die Nachricht bei jedem Wiederholungsversuch zurückkommt, überprüfen Sie, dass Ihr Konto das im Fehler genannte Modell aufrufen kann: Bestätigen Sie für Standard-Amazon Bedrock-Modelle, dass Ihre [IAM-Richtlinie](/docs/de/amazon-bedrock#iam-configuration) das Aufrufen zulässt; für Mantle-Modell-IDs [kontaktieren Sie Ihr AWS-Kontoteam](/docs/de/amazon-bedrock#mantle-endpoint-errors)579* Wenn die Nachricht bei Amazon Bedrock bei jedem Wiederholungsversuch zurückkommt, überprüfen Sie, dass Ihr Konto das darin genannte Modell aufrufen kann: Bestätigen Sie für Standard-Amazon Bedrock-Modelle, dass Ihre [IAM-Richtlinie](/docs/de/amazon-bedrock#iam-configuration) das Aufrufen zulässt; für Mantle-Modell-IDs [kontaktieren Sie Ihr AWS-Kontoteam](/docs/de/amazon-bedrock#mantle-endpoint-errors)

578 580

579Wenn eine Klassifiziereranfrage fehlschlägt, weil Ihr OAuth-Token abgelaufen ist oder von einer anderen Sitzung rotiert wurde, aktualisiert Claude Code das Token und versucht die Anfrage einmal erneut, sodass ein routinemäßiger Token-Ablauf nicht als diese Nachricht angezeigt wird. Vor v2.1.216 fehlte jede Klassifiziereranfrage mit einem abgelaufenen oder rotierten Token, und der Auto-Modus verweigerte jede überprüfte Aktion mit dieser Nachricht, bis das Token aktualisiert wurde.581Wenn eine Klassifikatoranfrage fehlschlägt, weil Ihr OAuth-Token abgelaufen ist oder von einer anderen Sitzung rotiert wurde, aktualisiert Claude Code das Token und versucht die Anfrage einmal erneut, sodass ein regulärer Token-Ablauf nicht als diese Nachricht angezeigt wird. Vor v2.1.216 schlug mit einem abgelaufenen oder rotierten Token jede Klassifikatoranfrage fehl, und der Auto-Modus verweigerte jede überprüfte Aktion mit dieser Nachricht, bis das Token aktualisiert wurde.

580 582

581Wenn der Klassifizierer eine nicht analysierbare Antwort zurückgab:583Wenn der Klassifikator eine nicht analysierbare Antwort zurückgab:

582 584

583```text theme={null}585```text theme={null}

584Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details586Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details

587**Was zu tun ist:**589**Was zu tun ist:**

588 590

589* Versuchen Sie die Aktion erneut; dies ist normalerweise beim nächsten Versuch erfolgreich591* Versuchen Sie die Aktion erneut; dies ist normalerweise beim nächsten Versuch erfolgreich

590* Führen Sie `claude --debug` aus und wiederholen Sie die Aktion für Details im Debug-Protokoll592* Führen Sie `claude --debug` aus und wiederholen Sie die Aktion, um Details im Debug-Log zu erhalten

591 593

592Wenn eine separate API-Sicherheitsprüfung die Klassifiziereranfrage aufgrund früherer Konversationsinhalte blockiert hat:594Wenn eine separate API-Sicherheitsprüfung die Klassifikatoranfrage aufgrund früherer Konversationsinhalte blockiert hat:

593 595

594```text theme={null}596```text theme={null}

595Auto 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 details597Auto 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

596```598```

597 599

598Claude Code verweigert die Aktion, teilt Claude aber mit, dass dies keine Beurteilung ist, dass die Aktion unsicher ist, und fordert auf, mit anderen Aufgaben fortzufahren, anstatt zu wiederholen. Diese Verweigerungen zählen nicht zu den [Auto-Modus-Pausenschwellen](/docs/de/permission-modes#when-auto-mode-falls-back). In einem [nicht-interaktiven](/docs/de/headless) `-p`-Lauf stoppt Claude Code den Lauf nicht. Was Claude erhält, hängt davon ab, wo es die Aktion angefordert hat:600Claude Code verweigert die Aktion, teilt Claude aber mit, dass dies keine Beurteilung ist, dass die Aktion unsicher ist, und dass es mit anderen Aufgaben fortfahren soll, anstatt es erneut zu versuchen. Diese Verweigerungen zählen nicht zu den [Pausenschwellen des Auto-Modus](/docs/de/permission-modes#when-auto-mode-falls-back). In einem [nicht interaktiven](/docs/de/headless) `-p`-Lauf stoppt Claude Code den Lauf nicht. Was Claude erhält, hängt davon ab, wo es die Aktion angefordert hat:

599 601

600* Zu einem [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) in einem `-p`-Lauf ohne `--input-format stream-json` gibt Claude Code ein Fehlerergebnis zurück, das `Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode` enthält602* An einen [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) in einem `-p`-Lauf ohne `--input-format stream-json` gibt Claude Code ein Fehlerergebnis zurück, das `Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode` enthält

601* Überall sonst, einschließlich interaktiver Sitzungen und der Hauptkonversation eines `-p`-Laufs, gibt Claude Code diese Verweigerung an Claude zurück603* Überall sonst, einschließlich interaktiver Sitzungen und der Hauptkonversation eines `-p`-Laufs, gibt Claude Code diese Verweigerung an Claude zurück

602 604

603Vor v2.1.225 zählte Claude Code diese Verweigerungen zu den Pausenschwellen und gab die gleiche Ablehnungsmeldung wie ein echter Klassifiziererblock zurück.605Vor v2.1.225 zählte Claude Code diese Verweigerungen zu den Pausenschwellen und gab die gleiche Ablehnungsmeldung wie bei einer echten Blockierung durch den Klassifikator zurück.

604 606

605**Was zu tun ist:**607**Was zu tun ist:**

606 608

607* Dies ist keine Entscheidung über Ihre Aktion. Inhalte, die bereits in Ihrer Konversation vorhanden sind, haben einen Sicherheitsfilter auf der API ausgelöst, als der Auto-Modus die Konversation an den Klassifizierer sendete609* Dies ist keine Entscheidung über Ihre Aktion. Inhalte, die bereits in Ihrer Konversation vorhanden sind, haben einen Sicherheitsfilter auf der API ausgelöst, als der Auto-Modus die Konversation an den Klassifikator sendete

608* Ein erneuter Versuch hilft nicht; der gleiche Konversationsinhalt wird den Filter erneut auslösen610* Ein erneuter Versuch hilft nicht; der gleiche Konversationsinhalt wird den Filter erneut auslösen

609* Wechseln Sie in einer interaktiven Sitzung zu einem anderen [Berechtigungsmodus](/docs/de/permission-modes), damit Sie die Aktion bei Aufforderung genehmigen können611* Wechseln Sie in einer interaktiven Sitzung zu einem anderen [Berechtigungsmodus](/docs/de/permission-modes), damit Sie die Aktion genehmigen können, wenn Sie gefragt werden

610* Starten Sie eine neue Konversation ohne den auslösenden Inhalt612* Starten Sie eine neue Konversation ohne den auslösenden Inhalt

611 613

612Wenn die Konversation größer als das Kontextfenster des Klassifizierers geworden ist:614Wenn die Konversation größer als das Kontextfenster des Klassifikators geworden ist:

613 615

614```text theme={null}616```text theme={null}

615Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)617Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

617 619

618Was mit der Aktion geschieht, hängt davon ab, wo Claude sie angefordert hat:620Was mit der Aktion geschieht, hängt davon ab, wo Claude sie angefordert hat:

619 621

620* In 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önnen622* In einer interaktiven Sitzung fällt der Auto-Modus für diese Aktion auf eine normale Berechtigungsabfrage zurück, damit Sie sie manuell genehmigen oder ablehnen können

621* Zu einem [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) in einem [nicht-interaktiven](/docs/de/headless) `-p`-Lauf ohne `--input-format stream-json` gibt Claude Code ein Fehlerergebnis zurück, das `Agent aborted: auto mode classifier transcript exceeded context window in headless mode` enthält, und der Lauf wird fortgesetzt623* An einen [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) in einem [nicht interaktiven](/docs/de/headless) `-p`-Lauf ohne `--input-format stream-json` gibt Claude Code ein Fehlerergebnis zurück, das `Agent aborted: auto mode classifier transcript exceeded context window in headless mode` enthält, und der Lauf wird fortgesetzt

622* Anderswo in einem `-p`-Lauf ohne [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) gibt es keine Aufforderung, auf die zurückgegriffen werden kann, sodass die Aktion nicht ausgeführt wird und der Lauf fortgesetzt wird624* Anderswo in einem `-p`-Lauf ohne [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) gibt es keine Abfrage, auf die zurückgefallen werden kann, sodass die Aktion nicht ausgeführt wird und der Lauf fortgesetzt wird

623 625

624**Was zu tun ist:**626**Was zu tun ist:**

625 627

626* Genehmigen oder lehnen Sie die Aktion in der angezeigten Aufforderung ab628* Genehmigen oder lehnen Sie die Aktion in einer interaktiven Sitzung in der angezeigten Abfrage ab

627* Führen Sie in einer interaktiven Sitzung `/compact` aus, um die Konversationsgröße zu reduzieren, damit nachfolgende Aktionen wieder in das Klassifizierer-Fenster passen629* Führen Sie in einer interaktiven Sitzung `/compact` aus, um die Konversationsgröße zu reduzieren, damit nachfolgende Aktionen wieder in das Fenster des Klassifikators passen

628 630

629<h3 id="the-server-returned-no-safety-verdict">631<h3 id="the-server-returned-no-safety-verdict">

630 Der Server hat kein Sicherheitsurteil zurückgegeben632 Der Server hat kein Sicherheitsurteil zurückgegeben

631</h3>633</h3>

632 634

633Unter [serverseitiger Klassifiziererüberprüfung](/docs/de/permission-modes#server-side-classifier-review) verweigert der Auto-Modus eine Aktion, wenn der Server kein Urteil dafür gibt. Die Verweigerung nennt eine Kategorie in Klammern, wenn Claude Code eine bestimmen kann, wie z. B. `(timed out)`:635Bei der [serverseitigen Klassifikatorprüfung](/docs/de/permission-modes#server-side-classifier-review) verweigert der Auto-Modus eine Aktion, wenn der Server kein Urteil dafür liefert. Die Verweigerung nennt eine Kategorie in Klammern, wenn Claude Code eine bestimmen kann, wie z. B. `(timed out)`:

634 636

635```text theme={null}637```text theme={null}

636The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.638The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.

637```639```

638 640

639Der Rest der Nachricht teilt Claude mit, ob ein Wiederholungsversuch helfen kann. Vor einigen dieser Verweigerungen wartet Claude Code, damit Claudes nächster Versuch nicht sofort folgt. Während des Wartens in einer interaktiven Sitzung zeigt der Spinner `Auto mode check unavailable` mit einem Countdown an, und das Drücken von `Esc` unterbricht den Zug.641Der Rest der Nachricht teilt Claude mit, ob ein Wiederholungsversuch helfen kann. Vor einigen dieser Verweigerungen wartet Claude Code, damit Claudes nächster Versuch nicht sofort folgt. Während des Wartens in einer interaktiven Sitzung zeigt der Spinner `Auto mode check unavailable` mit einem Countdown an, und das Drücken von `Esc` unterbricht den Turn.

640 642

641Nach zehn Antworten hintereinander ohne Urteil stoppt der Auto-Modus den Zug:643Nach zehn Antworten hintereinander ohne Urteil stoppt der Auto-Modus den Turn:

642 644

643```text theme={null}645```text theme={null}

644Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.646Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

645```647```

646 648

647Die Stopmeldung wird an einer anderen Stelle in jeder Art von Sitzung angezeigt:649Die Stoppmeldung wird in jeder Art von Sitzung an einer anderen Stelle angezeigt:

648 650

649* In einer interaktiven Sitzung wird die Nachricht als Warnung im Transkript angezeigt und der Zug endet651* In einer interaktiven Sitzung wird die Nachricht als Warnung im Transkript angezeigt und der Turn endet

650* In einem [nicht-interaktiven](/docs/de/headless) `-p`-Lauf endet der Lauf und meldet einen Ausführungsfehler. Mit der Standard-Textausgabe wird die Nachricht auf stderr gedruckt.652* In einem [nicht interaktiven](/docs/de/headless) `-p`-Lauf endet der Lauf und meldet einen Ausführungsfehler. Mit der Standard-Textausgabe wird die Nachricht auf stderr ausgegeben.

651* Wenn ein [Subagent](/docs/de/sub-agents) das Limit erreicht hat, stoppt der Subagent vor Abschluss, und Claude erhält das, was er mit einer Notiz produziert hat, dass der Auto-Modus ihn gestoppt hat653* Wenn ein [Subagent](/docs/de/sub-agents) das Limit erreicht hat, stoppt der Subagent vor Abschluss, und Claude erhält das, was er bis dahin produziert hat, mit einem Hinweis, dass der Auto-Modus ihn gestoppt hat

652 654

653**Was zu tun ist:**655**Was zu tun ist:**

654 656

655* Senden Sie eine weitere Nachricht, damit Claude es erneut versucht. Die Anzahl der Antworten beginnt von vorne.657* Senden Sie eine weitere Nachricht, damit Claude es erneut versucht. Die Zählung der Antworten beginnt von vorne.

656* Wenn der Stopp sich wiederholt und Ihre Anfragen durch ein [LLM-Gateway oder einen Proxy](/docs/de/llm-gateway) gehen, überprüfen Sie, ob dieser Streaming-Antworten kürzt oder umschreibt. [Serverseitige Klassifiziererüberprüfung](/docs/de/permission-modes#server-side-classifier-review) sagt, welches Gateway-Verhalten Verweigerungen verursacht, und der [Gateway-Kompatibilitätsleitfaden](/docs/de/llm-gateway-protocol#feature-pass-through) listet auf, was unverändert durchgeleitet werden muss.658* Wenn sich der Stopp wiederholt und Ihre Anfragen über ein [LLM-Gateway oder einen Proxy](/docs/de/llm-gateway) laufen, überprüfen Sie, ob dieser Streaming-Antworten kürzt oder umschreibt. [Serverseitige Klassifikatorprüfung](/docs/de/permission-modes#server-side-classifier-review) beschreibt, welches Gateway-Verhalten Verweigerungen verursacht, und der [Gateway-Kompatibilitätsleitfaden](/docs/de/llm-gateway-protocol#feature-pass-through) listet auf, was unverändert durchgeleitet werden muss.

657* Setzen Sie `CLAUDE_CODE_AUTO_MODE_SERVER=0`, bevor Sie Claude Code starten, um stattdessen seine eigenen Klassifiziereranfragen zu verwenden. Vor v2.1.281 las Claude Code die Variable nicht bei einer direkten Verbindung zur Anthropic API.659* Setzen Sie `CLAUDE_CODE_AUTO_MODE_SERVER=0`, bevor Sie Claude Code starten, um stattdessen seine eigenen Klassifikatoranfragen zu verwenden. Vor v2.1.281 las Claude Code die Variable bei einer direkten Verbindung zur Anthropic API nicht.

658* Um die Aktionen selbst zu genehmigen, [wechseln Sie aus dem Auto-Modus](/docs/de/permission-modes#switch-permission-modes)660* Um die Aktionen stattdessen selbst zu genehmigen, [wechseln Sie aus dem Auto-Modus](/docs/de/permission-modes#switch-permission-modes)

659 661

660Vor v2.1.280 verweigerte Claude Code jede Aktion aus einer Antwort ohne Urteil sofort und stoppte den Zug nie.662Vor v2.1.280 verweigerte Claude Code jede Aktion aus einer Antwort ohne Urteil sofort und stoppte den Turn nie.

661 663

662<h3 id="agent-terminated-early-due-to-an-api-error">664<h3 id="agent-terminated-early-due-to-an-api-error">

663 Agent wurde vorzeitig aufgrund eines API-Fehlers beendet665 Agent wurde vorzeitig aufgrund eines API-Fehlers beendet

664</h3>666</h3>

665 667

666Eine [Subagenten](/docs/de/sub-agents)-API-Anfrage ist terminal fehlgeschlagen, z. B. weil ein Nutzungslimit erreicht wurde oder Wiederholungsversuche für einen Serverfehler aufgebraucht wurden, sodass der Subagent vor Abschluss seiner Aufgabe gestoppt hat. Diese Nachricht 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.668Die API-Anfrage eines [Subagenten](/docs/de/sub-agents) ist endgültig fehlgeschlagen, z. B. weil ein Nutzungslimit erreicht wurde oder die Wiederholungsversuche für einen Serverfehler aufgebraucht waren, sodass der Subagent vor Abschluss seiner Aufgabe gestoppt hat. Diese Nachricht 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.

667 669

668```text theme={null}670```text theme={null}

669Agent terminated early due to an API error: <error detail>671Agent terminated early due to an API error: <error detail>

671 673

672**Was zu tun ist:**674**Was zu tun ist:**

673 675

674* 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 Abschnitts676* Ordnen Sie die Fehlerdetails nach dem Doppelpunkt dem jeweiligen Abschnitt auf dieser Seite zu, wie z. B. [Nutzungslimits](#usage-limits) oder [Serverfehler](#server-errors), und folgen Sie den Schritten dieses Abschnitts

675* Sobald der zugrunde liegende Fehler behoben ist, bitten Sie Claude, die Aufgabe zu wiederholen oder [den Subagenten fortzusetzen](/docs/de/sub-agents#resume-subagents)677* Sobald der zugrunde liegende Fehler behoben ist, bitten Sie Claude, die Aufgabe erneut zu versuchen oder [den Subagenten fortzusetzen](/docs/de/sub-agents#resume-subagents)

676 678

677Wenn eine Ratenbegrenzung, ein Overload oder ein Serverfehler einen Vordergrund-Subagenten unterbricht, der bereits Textausgabe erzeugt hat, erhält Claude diese Teilausgabe als unvollständig markiert, anstatt diesen Fehler zu erhalten. Ein Subagent, dessen einzige Ausgabe Toolaufrufe waren, erhält auch diesen Fehler; in v2.1.199 gab dies stattdessen ein leeres Teilergebnis zurück. Siehe [API-Fehler in Subagenten](/docs/de/sub-agents#api-errors-in-subagents).679Wenn ein Rate-Limit, ein Overload oder ein Serverfehler einen Vordergrund-Subagenten unterbricht, der bereits Textausgabe erzeugt hat, erhält Claude statt dieses Fehlers diese Teilausgabe als unvollständig markiert. Ein Subagent, dessen einzige Ausgabe Tool-Aufrufe waren, erhält ebenfalls diesen Fehler; in v2.1.199 gab diese Konstellation stattdessen ein leeres Teilergebnis zurück. Siehe [API-Fehler in Subagenten](/docs/de/sub-agents#api-errors-in-subagents).

678 680

679<h2 id="usage-limits">681<h2 id="usage-limits">

680 Nutzungslimits682 Nutzungslimits

885 Authentifizierungsfehler887 Authentifizierungsfehler

886</h2>888</h2>

887 889

888Diese 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.890Diese Fehler bedeuten, dass Claude Code gegenüber der API nicht nachweisen kann, wer Sie sind. Führen Sie jederzeit `/status` aus, um zu sehen, welche Anmeldedaten gerade aktiv sind.

889 891

890<h3 id="not-logged-in">892<h3 id="not-logged-in">

891 Nicht angemeldet893 Nicht angemeldet

892</h3>894</h3>

893 895

894Für diese Sitzung ist keine gültige Anmeldedaten verfügbar.896Für diese Sitzung sind keine gültigen Anmeldedaten verfügbar.

895 897

896```text theme={null}898```text theme={null}

897Not logged in · Please run /login899Not logged in · Please run /login

898```900```

899 901

900In einer Sitzung, die die Claude Desktop-App ausführt, z. B. auf der Registerkarte „Code" oder in Cowork, lautet die Meldung `Authentication required · Sign in again to continue`, und Sie melden sich erneut über die App an.902In einer Sitzung, die die Claude Desktop-App ausführt, etwa im Code-Tab oder in Cowork, lautet die Meldung `Authentication required · Sign in again to continue`, und Sie melden sich in der App erneut an.

901 903

902**Was zu tun ist:**904Wenn Sie sich in einem anderen Claude Code-Fenster, das dasselbe [Konfigurationsverzeichnis](/docs/de/claude-directory) verwendet, mit Ihrem claude.ai-Konto anmelden, verwendet eine interaktive Sitzung, die diese Meldung anzeigt, diese Anmeldung automatisch. Sie müssen sie nicht neu starten.

905

906Vor v2.1.286 konnte die Sitzung unter macOS die Meldung weiterhin anzeigen, nachdem Sie sich in einem anderen Fenster angemeldet hatten. Starten Sie in diesen Versionen die Sitzung, die die Meldung anzeigt, neu.

903 907

904* Führen Sie `/login` aus, um sich mit Ihrem Claude-Abonnement oder Ihrem Console-Konto zu authentifizieren908**Was Sie tun können:**

905* 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

906* Für CI oder Automatisierung, bei der interaktive Anmeldung nicht möglich ist, konfigurieren Sie ein [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skript, das beim Start einen Schlüssel abruft

907* Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence), um zu verstehen, welche Anmeldedaten Claude Code verwendet, wenn mehrere vorhanden sind

908 909

909Wenn Sie wiederholt aufgefordert werden, sich anzumelden, siehe [Nicht angemeldet oder Token abgelaufen](/docs/de/troubleshoot-install#not-logged-in-or-token-expired) für Systemuhr-Überprüfungen und macOS-Wiederherstellungsschritte für die Anmeldedatenverwaltung.910* Führen Sie `/login` aus, um sich mit Ihrem Claude-Abonnement oder Console-Konto zu authentifizieren

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

912* Konfigurieren Sie für CI oder Automatisierung, bei der keine interaktive Anmeldung möglich ist, ein [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skript, das beim Start einen Schlüssel abruft

913* Unter [Rangfolge der Authentifizierung](/docs/de/authentication#authentication-precedence) erfahren Sie, welche Anmeldedaten Claude Code verwendet, wenn mehrere vorhanden sind

914

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

910 916

911<h3 id="could-not-resolve-authentication-method">917<h3 id="could-not-resolve-authentication-method">

912 Authentifizierungsmethode konnte nicht aufgelöst werden918 Authentifizierungsmethode konnte nicht ermittelt werden

913</h3>919</h3>

914 920

915Die Sitzung erreichte den API-Client ohne Anmeldedaten. [Hintergrundsitzungen](/docs/de/agent-view) und Cloud-Sitzungen zeigen diese Meldung an, wenn der Worker ohne Anmeldedaten startet. Interaktive, `-p`- und Agent SDK-Ausführungen melden denselben Zustand wie [Nicht angemeldet](#not-logged-in) und schreiben diese Zeichenkette nur in ihr Debug-Protokoll. Wenn Sie sie dort gefunden haben, folgen Sie stattdessen diesem Eintrag.921Die Sitzung hat den API-Client ohne Anmeldedaten erreicht. [Hintergrundsitzungen](/docs/de/agent-view) und Cloud-Sitzungen zeigen diese Meldung an, wenn der Worker ohne Anmeldedaten startet. Interaktive Ausführungen, `-p`-Ausführungen und Agent SDK-Ausführungen melden denselben Zustand als [Nicht angemeldet](#not-logged-in) und schreiben diese Zeichenfolge nur in ihr Debug-Log. Wenn Sie sie dort gefunden haben, folgen Sie stattdessen jenem Eintrag.

916 922

917```text theme={null}923```text theme={null}

918Could 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 omitted924Could 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

919```925```

920 926

921In aktuellen Versionen bedeutet der Fehler, dass dem Worker-Prozess keine Anmeldedaten zur Verfügung standen. Vor v2.1.174 konnte eine Hintergrundsitzung, die einem untätigen vorinitialisiertem Worker zugewiesen war, auf diese Weise fehlschlagen, selbst wenn gültige Anmeldedaten konfiguriert waren. Vor v2.1.176 konnte auch eine Cloud-Sitzung, die untätig war, bevor sie beansprucht wurde, fehlschlagen. Führen Sie ein Upgrade durch, um dies zu beheben.927In aktuellen Versionen bedeutet der Fehler, dass dem Worker-Prozess keine Anmeldedaten zur Verfügung standen. Vor v2.1.174 konnte eine Hintergrundsitzung, die einem inaktiven, vorinitialisierten Worker zugewiesen wurde, auf diese Weise fehlschlagen, auch wenn gültige Anmeldedaten konfiguriert waren. Vor v2.1.176 konnte dies auch bei einer Cloud-Sitzung passieren, die inaktiv war, bevor sie übernommen wurde. Aktualisieren Sie, um das Problem zu beheben.

922 928

923**Was zu tun ist:**929**Was Sie tun können:**

924 930

925* Führen Sie ein Upgrade auf v2.1.176 oder später durch, wenn dies in einer Hintergrund- oder Cloud-Sitzung angezeigt wird und Ihre Anmeldedaten bereits konfiguriert sind931* Aktualisieren Sie auf v2.1.176 oder höher, wenn dies in einer Hintergrund- oder Cloud-Sitzung auftritt und Ihre Anmeldedaten bereits konfiguriert sind

926* 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 Shell932* Prüfen Sie, ob `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` oder die Anmeldedaten Ihres Cloud-Anbieters in der Umgebung gesetzt sind, die den Worker startet, und nicht nur in Ihrer interaktiven Shell

927* Für das Agent SDK siehe [Authentifizierungseinrichtung in der Schnellstartanleitung](/docs/de/agent-sdk/quickstart#setup)933* Informationen zum Agent SDK finden Sie unter [Einrichtung der Authentifizierung im Schnellstart](/docs/de/agent-sdk/quickstart#setup)

928* Führen Sie `/status` in einer interaktiven Sitzung in derselben Umgebung aus, um zu bestätigen, welche Anmeldedatenquelle aufgelöst wird934* Führen Sie `/status` in einer interaktiven Sitzung in derselben Umgebung aus, um zu prüfen, welche Quelle für Anmeldedaten ermittelt wird

929 935

930<h3 id="invalid-api-key">936<h3 id="invalid-api-key">

931 Ungültiger API-Schlüssel937 Ungültiger API-Schlüssel

932</h3>938</h3>

933 939

934Die Umgebungsvariable `ANTHROPIC_API_KEY` oder das `apiKeyHelper`-Skript hat einen Schlüssel zurückgegeben, den die API abgelehnt hat, oder Claude Code hat einen Schlüssel von `ANTHROPIC_API_KEY` blockiert, bevor er ihn gesendet hat.940Die Umgebungsvariable `ANTHROPIC_API_KEY` oder das `apiKeyHelper`-Skript hat einen Schlüssel geliefert, den die API abgelehnt hat, oder Claude Code hat einen Schlüssel aus `ANTHROPIC_API_KEY` blockiert, bevor er gesendet wurde.

935 941

936```text theme={null}942```text theme={null}

937Invalid API key · Fix external API key943Invalid API key · Fix external API key

938```944```

939 945

940Wenn die Meldung nach `Fix external API key` mit einer Beschreibung wie `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).` fortgesetzt wird, hat die API den Schlüssel nie gesehen. Claude Code hat ein Zeichen gefunden, das HTTP-Header nicht tragen können, und die Anfrage gestoppt, bevor sie gesendet wurde. Siehe [Ungültiger Anforderungs-Header-Wert](#invalid-request-header-value), um zu erfahren, wie Sie die Beschreibung lesen und den Wert korrigieren.946Wenn die Meldung nach `Fix external API key` mit einer Beschreibung wie `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).` weitergeht, hat die API den Schlüssel nie gesehen. Claude Code hat ein Zeichen gefunden, das HTTP-Header nicht übertragen können, und die Anfrage vor dem Senden gestoppt. Unter [Ungültiger Wert im Request-Header](#invalid-request-header-value) erfahren Sie, wie Sie die Beschreibung lesen und den Wert korrigieren.

941 947

942**Was zu tun ist:**948**Was Sie tun können:**

943 949

944* Überprüfen Sie auf Tippfehler und bestätigen Sie, dass der Schlüssel nicht in der [Console](https://platform.claude.com/settings/keys) widerrufen wurde950* Prüfen Sie auf Tippfehler und vergewissern Sie sich, dass der Schlüssel in der [Console](https://platform.claude.com/settings/keys) nicht widerrufen wurde

945* Führen Sie in derselben Shell `env | grep ANTHROPIC` aus, oder in PowerShell `Get-ChildItem Env:ANTHROPIC*`. 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 setzen951* Führen Sie in derselben Shell `env | grep ANTHROPIC` aus, in PowerShell `Get-ChildItem Env:ANTHROPIC*`. 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.

946* Heben Sie `ANTHROPIC_API_KEY` auf und führen Sie `/login` aus, um stattdessen Abonnement-Authentifizierung zu verwenden952* Heben Sie `ANTHROPIC_API_KEY` auf und führen Sie `/login` aus, um stattdessen die Authentifizierung über Ihr Abonnement zu verwenden

947* Wenn der Schlüssel von einem [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skript stammt, führen Sie das Skript direkt aus, um zu bestätigen, dass es einen gültigen Schlüssel auf stdout ausgibt953* Wenn der Schlüssel aus einem [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skript stammt, führen Sie das Skript direkt aus, um zu prüfen, ob es einen gültigen Schlüssel auf stdout ausgibt

948* Führen Sie `/status` aus, um zu bestätigen, welche Anmeldedatenquelle Claude Code tatsächlich verwendet954* Führen Sie `/status` aus, um zu prüfen, welche Quelle für Anmeldedaten Claude Code tatsächlich verwendet

949 955

950<h3 id="your-apikeyhelper-script-is-failing">956<h3 id="your-apikeyhelper-script-is-failing">

951 Ihr apiKeyHelper-Skript schlägt fehl957 Ihr apiKeyHelper-Skript schlägt fehl

952</h3>958</h3>

953 959

954Claude Code hat den Befehl in Ihrer [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Einstellung ausgeführt und keinen Schlüssel zurückbekommen. Ohne einen erreicht die Anfrage die API mit einer Platzhalter-Anmeldedaten, und die API lehnt sie mit `401` ab. Das `Authentication`-Panel im Terminal zeigt, welches dieser Ereignisse passiert ist:960Claude Code hat den Befehl in Ihrer Einstellung [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper) ausgeführt und keinen Schlüssel zurückerhalten. Ohne Schlüssel erreicht die Anfrage die API mit Platzhalter-Anmeldedaten, und die API lehnt sie mit `401` ab. Das `Authentication`-Panel im Terminal zeigt, welcher der folgenden Fälle eingetreten ist:

955 961

956* Der Befehl ist mit einem Fehler beendet worden oder hat das Zeitlimit überschritten962* Der Befehl wurde mit einem Fehler beendet oder hat eine Zeitüberschreitung erreicht

957* Der Befehl hat nichts auf stdout ausgegeben963* Der Befehl hat nichts auf stdout ausgegeben

958* Der Befehl hat etwas anderes als den Schlüssel ausgegeben, z. B. ein Login-Banner oder eine Protokollzeile. Das Panel zeigt `returned output that cannot be used as an API key` und sagt, was falsch ist, ohne die Ausgabe zu wiederholen. Vor v2.1.227 hat Claude Code das gesendet, was der Befehl ausgegeben hat, nach dem Trimmen von umgebender Leerraum.964* Der Befehl hat etwas anderes als den Schlüssel ausgegeben, etwa ein Login-Banner oder eine Log-Zeile. Das Panel zeigt `returned output that cannot be used as an API key` und beschreibt das Problem, ohne die Ausgabe zu wiederholen. Vor v2.1.227 hat Claude Code alles gesendet, was der Befehl ausgegeben hat, nachdem umgebende Leerzeichen entfernt wurden.

959 965

960```text theme={null}966```text theme={null}

961Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output967Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

962```968```

963 969

964Im [nicht-interaktiven Modus](/docs/de/headless) trägt stderr auch den spezifischen Grund, mit dem Präfix `apiKeyHelper failed:`.970Im [nicht interaktiven Modus](/docs/de/headless) enthält stderr zusätzlich den konkreten Grund, mit dem Präfix `apiKeyHelper failed:`.

965 971

966Claude Code führt das Skript erneut aus und versucht die Anfrage bis zu zwei weitere Male, bevor diese Meldung angezeigt wird, sodass der Fehler innerhalb von drei Versuchen auftaucht. Vor v2.1.208 hat Claude Code das vollständige [Wiederholungsbudget](#automatic-retries) aufgewendet, um die Anfrage mit der Platzhalter-Anmeldedaten erneut zu senden, und dann einen generischen `401`-Authentifizierungsfehler statt des Skriptfehlers gemeldet.972Claude Code führt das Skript erneut aus und wiederholt die Anfrage bis zu zwei weitere Male, bevor diese Meldung angezeigt wird, sodass der Fehler innerhalb von drei Versuchen sichtbar wird. Vor v2.1.208 hat Claude Code das gesamte [Kontingent an Wiederholungsversuchen](#automatic-retries) damit verbraucht, die Anfrage mit den Platzhalter-Anmeldedaten erneut zu senden, und dann einen allgemeinen `401`-Authentifizierungsfehler statt des Skriptfehlers gemeldet.

967 973

968Das Ausführen von `/login` hilft hier nicht: die Ausgabe des Helpers [hat Vorrang](/docs/de/authentication#authentication-precedence) vor einer gespeicherten Anmeldung, solange die Einstellung vorhanden ist.974`/login` hilft hier nicht: Die Ausgabe des Helpers [hat Vorrang](/docs/de/authentication#authentication-precedence) vor einer gespeicherten Anmeldung, solange die Einstellung vorhanden ist.

969 975

970**Was zu tun ist:**976**Was Sie tun können:**

971 977

972* Führen Sie den in `apiKeyHelper` konfigurierten Befehl direkt in Ihrer Shell aus, um den Fehler zu reproduzieren978* Führen Sie den in `apiKeyHelper` konfigurierten Befehl direkt in Ihrer Shell aus, um den Fehler zu reproduzieren

973* Wenn der Befehl eine abgelaufene Sitzung meldet, authentifizieren Sie sich erneut bei Ihrem Anmeldedaten-Provider, z. B. durch erneutes Anmelden bei Ihrem SSO oder Ihrem Secrets Vault979* Wenn der Befehl eine abgelaufene Sitzung meldet, authentifizieren Sie sich erneut bei Ihrem Anbieter für Anmeldedaten, zum Beispiel indem Sie sich erneut bei Ihrem SSO oder Secrets-Vault anmelden

974* Korrigieren Sie den Befehl so, dass er nur den Schlüssel auf stdout ausgibt, als ein einzelnes Token aus druckbarem ASCII bis zu 16.384 Zeichen, und mit Code 0 beendet wird. Siehe [Anmeldedaten mit apiKeyHelper rotieren](/docs/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper) für eine funktionierende Einrichtung.980* Korrigieren Sie den Befehl so, dass er nur den Schlüssel auf stdout ausgibt, als einzelnes Token aus druckbaren ASCII-Zeichen mit bis zu 16.384 Zeichen, und mit Exit-Code 0 beendet wird. Eine funktionierende Einrichtung finden Sie unter [Anmeldedaten mit apiKeyHelper rotieren](/docs/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper).

975* Führen Sie `/status` aus, um den Fehler zu sehen und zu bestätigen, dass `apiKeyHelper` die aktive Anmeldedatenquelle ist. Die `apiKeyHelper`-Zeile zeigt `Failing` mit dem Detail des letzten Fehlers, z. B. dem Exit-Code und der Fehlerausgabe des Befehls, und verschwindet nach der nächsten erfolgreichen Ausführung. Vor v2.1.274 zeigte `/status` nur die Anmeldedatenquelle, nicht den Fehler.981* Führen Sie `/status` aus, um den Fehler zu sehen und zu prüfen, ob `apiKeyHelper` die aktive Quelle für Anmeldedaten ist. Die Zeile `apiKeyHelper` zeigt `Failing` mit den Details des letzten Fehlers an, etwa dem Exit-Code und der Fehlerausgabe des Befehls, und verschwindet nach der nächsten erfolgreichen Ausführung. Vor v2.1.274 zeigte `/status` nur die Quelle der Anmeldedaten, nicht den Fehler.

976* Jedes Mal, wenn der Befehl fehlschlägt, erscheinen sein Exit-Code und seine Fehlerausgabe auch in einem `Authentication`-Panel im Terminal. Vor v2.1.212 war das Panel mit `Cloud authentication` betitelt.982* Jedes Mal, wenn der Befehl fehlschlägt, erscheinen sein Exit-Code und seine Fehlerausgabe auch in einem `Authentication`-Panel im Terminal. Vor v2.1.212 hieß das Panel `Cloud authentication`.

977 983

978<h3 id="invalid-request-header-value">984<h3 id="invalid-request-header-value">

979 Ungültiger Anforderungs-Header-Wert985 Ungültiger Wert im Request-Header

980</h3>986</h3>

981 987

982Ein Wert, den Claude Code als Anforderungs-Header senden wollte, enthält ein Zeichen, das HTTP-Header nicht tragen können: einen Zeilenumbruch, ein NUL-Byte oder ein Zeichen über `U+00FF`, z. B. ein gekrümmtes Anführungszeichen oder ein Leerzeichen mit Nullbreite. Claude Code stoppt die Anfrage, bevor etwas gesendet wird, und benennt die Variable oder Einstellung, die korrigiert werden muss. Die übliche Ursache ist eine Anmeldedaten, die aus einem Dokument oder Chat eingefügt wurde und ein unsichtbares Zeichen oder einen Zeilenumbruch trug.988Ein Wert, den Claude Code als Request-Header senden wollte, enthält ein Zeichen, das HTTP-Header nicht übertragen können: einen Zeilenumbruch, ein NUL-Byte oder ein Zeichen oberhalb von `U+00FF`, etwa ein typografisches Anführungszeichen oder ein Leerzeichen mit Nullbreite. Claude Code stoppt die Anfrage, bevor etwas gesendet wird, und nennt die zu korrigierende Variable oder Einstellung. Die übliche Ursache sind Anmeldedaten, die aus einem Dokument oder Chat eingefügt wurden und ein unsichtbares Zeichen oder einen versehentlichen Zeilenumbruch enthielten.

983 989

984Claude Code führt diese Überprüfung durch, wenn es Anfragen direkt an die Claude API oder durch ein [LLM-Gateway](/docs/de/llm-gateway) sendet. Bei einem Cloud-Provider eines Drittanbieters wie [Amazon Bedrock](/docs/de/amazon-bedrock) führt Claude Code dies nicht vor dem Senden durch.990Claude Code führt diese Prüfung durch, wenn es Anfragen direkt oder über ein [LLM-Gateway](/docs/de/llm-gateway) an die Claude API sendet. Bei einem Cloud-Drittanbieter wie [Amazon Bedrock](/docs/de/amazon-bedrock) führt Claude Code sie vor dem Senden nicht durch.

985 991

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

987Invalid auth token · Fix external auth token993Invalid auth token · Fix external auth token

991 997

992Der erste Teil der Meldung hängt davon ab, woher der fehlerhafte Wert stammt:998Der erste Teil der Meldung hängt davon ab, woher der fehlerhafte Wert stammt:

993 999

994* `Invalid auth token`: ein Bearer-Token von [`ANTHROPIC_AUTH_TOKEN`](/docs/de/env-vars) oder [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars)1000* `Invalid auth token`: ein Bearer-Token aus [`ANTHROPIC_AUTH_TOKEN`](/docs/de/env-vars) oder [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars)

995* `Invalid ANTHROPIC_CUSTOM_HEADERS`: ein Header-Name oder -Wert, den Sie in [`ANTHROPIC_CUSTOM_HEADERS`](/docs/de/env-vars) gesetzt haben. Die Beschreibung zählt, welches `Name: Value`-Paar fehlerhaft ist, z. B. `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, ohne den Namen oder Wert zu wiederholen, da Sie beide gewählt haben.1001* `Invalid ANTHROPIC_CUSTOM_HEADERS`: ein Header-Name oder -Wert, den Sie in [`ANTHROPIC_CUSTOM_HEADERS`](/docs/de/env-vars) gesetzt haben. Die Beschreibung gibt an, welches `Name: Value`-Paar fehlerhaft ist, etwa `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, ohne Namen oder Wert zu wiederholen, da Sie beide selbst gewählt haben.

996* `Invalid request header from the environment`: ein Wert, den Claude Code aus einer anderen Umgebungsvariable in einen Anforderungs-Header kopiert, z. B. `CLAUDE_AGENT_SDK_CLIENT_APP`. Die Beschreibung benennt die Variable, die korrigiert werden muss.1002* `Invalid request header from the environment`: ein Wert, den Claude Code aus einer anderen Umgebungsvariable in einen Request-Header kopiert, etwa `CLAUDE_AGENT_SDK_CLIENT_APP`. Die Beschreibung nennt die zu korrigierende Variable.

997 1003

998Claude Code meldet einen fehlerhaften `ANTHROPIC_API_KEY`, der von dieser Überprüfung erfasst wird, als [Ungültiger API-Schlüssel](#invalid-api-key), mit derselben nachfolgenden Beschreibung. Es meldet eine fehlerhafte gespeicherte `/login`-Anmeldedaten als [Nicht angemeldet](#not-logged-in) statt; führen Sie `/login` aus, um eine neue zu speichern. Die Ausgabe eines [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skripts erreicht diese Überprüfung nie: Claude Code validiert sie, wenn das Skript ausgeführt wird, und die Ausgabe, die ein HTTP-Header nicht tragen kann, schlägt mit [Ihr apiKeyHelper-Skript schlägt fehl](#your-apikeyhelper-script-is-failing) fehl.1004Einen fehlerhaften `ANTHROPIC_API_KEY`, den diese Prüfung erkennt, meldet Claude Code als [Ungültiger API-Schlüssel](#invalid-api-key), mit derselben nachgestellten Beschreibung. Fehlerhafte gespeicherte `/login`-Anmeldedaten meldet es stattdessen als [Nicht angemeldet](#not-logged-in); führen Sie `/login` aus, um neue zu speichern. Die Ausgabe eines [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Skripts erreicht diese Prüfung nie: Claude Code validiert sie bei der Ausführung des Skripts, und eine Ausgabe, die ein HTTP-Header nicht übertragen kann, schlägt mit [Ihr apiKeyHelper-Skript schlägt fehl](#your-apikeyhelper-script-is-failing) fehl.

999 1005

1000Nach dem zweiten `·` beschreibt die Meldung das Problem, wie in diesem vollständigen Beispiel:1006Nach dem zweiten `·` beschreibt die Meldung das Problem, wie in diesem vollständigen Beispiel:

1001 1007

1003Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).1009Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).

1004```1010```

1005 1011

1006Positionen zählen Zeichen ab eins. Die Beschreibung wird aus festen Phrasen und Zeichenzählungen erstellt, sodass sie niemals den Wert selbst enthält. Sie benennt das fehlerhafte Zeichen nur, wenn es ein bekanntes unsichtbares oder typografisches Zeichen ist, z. B. eine Byte-Order-Marke, ein Leerzeichen mit Nullbreite oder ein gekrümmtes Anführungszeichen, und meldet alles andere als `a non-ASCII character`.1012Positionen zählen Zeichen beginnend bei eins. Die Beschreibung wird aus festen Formulierungen und Zeichenzahlen zusammengesetzt und enthält daher nie den Wert selbst. Sie nennt das betroffene Zeichen nur, wenn es sich um ein bekanntes unsichtbares oder typografisches Zeichen handelt, etwa eine Byte-Order-Mark, ein Leerzeichen mit Nullbreite oder ein typografisches Anführungszeichen, und meldet alles andere als `a non-ASCII character`.

1007 1013

1008**Was zu tun ist:**1014**Was Sie tun können:**

1009 1015

1010* Setzen Sie die Variable oder Einstellung, die die Meldung benennt, neu, indem Sie die Zeichen um die gemeldete Position neu eingeben, anstatt sie aus derselben Quelle erneut einzufügen1016* Setzen Sie die Variable oder Einstellung, die die Meldung nennt, neu und tippen Sie die Zeichen um die gemeldete Position herum neu ein, statt erneut aus derselben Quelle einzufügen

1011* Für `ANTHROPIC_CUSTOM_HEADERS` behalten Sie ein `Name: Value`-Paar pro Zeile und schreiben Sie das Paar neu, das die Meldung zählt1017* Bei `ANTHROPIC_CUSTOM_HEADERS` verwenden Sie ein `Name: Value`-Paar pro Zeile und schreiben das Paar neu, das die Meldung angibt

1012* Führen Sie `/status` aus, um zu bestätigen, welche Anmeldedatenquelle aktiv ist1018* Führen Sie `/status` aus, um zu prüfen, welche Quelle für Anmeldedaten aktiv ist

1013 1019

1014<h3 id="this-organization-has-been-disabled">1020<h3 id="this-organization-has-been-disabled">

1015 Diese Organisation wurde deaktiviert1021 Diese Organisation wurde deaktiviert

1016</h3>1022</h3>

1017 1023

1018Claude Code verwendet einen veralteten `ANTHROPIC_API_KEY` von einer deaktivierten Console-Organisation. Wenn Sie eine gespeicherte Abonnement-Anmeldung haben, setzt der Schlüssel diese außer Kraft.1024Claude Code verwendet einen veralteten `ANTHROPIC_API_KEY` aus einer deaktivierten Console-Organisation. Wenn Sie eine gespeicherte Anmeldung über Ihr Abonnement haben, überschreibt der Schlüssel diese.

1019 1025

1020```text theme={null}1026```text theme={null}

1021Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead1027Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead

1023API Error: 400 ... This organization has been disabled.1029API Error: 400 ... This organization has been disabled.

1024```1030```

1025 1031

1026Der Hinweis nach dem `·` hängt von Ihren gespeicherten Anmeldedaten ab: die erste Form erscheint, wenn eine gespeicherte `/login` übernehmen kann, nachdem Sie den Schlüssel aufgehoben haben, und die zweite, wenn der Schlüssel Ihre einzige Anmeldedaten ist.1032Der Hinweis nach dem `·` hängt von Ihren gespeicherten Anmeldedaten ab: Die erste Form erscheint, wenn eine gespeicherte `/login`-Anmeldung übernehmen kann, nachdem Sie den Schlüssel aufgehoben haben, und die zweite, wenn der Schlüssel Ihre einzigen Anmeldedaten sind.

1027 1033

1028Umgebungsvariablen haben Vorrang vor `/login`, sodass ein Schlüssel, der in Ihrem Shell-Profil exportiert oder aus einer `.env`-Datei geladen wird, verwendet wird, 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.1034Umgebungsvariablen haben Vorrang vor `/login`, sodass ein in Ihrem Shell-Profil exportierter oder aus einer `.env`-Datei geladener Schlüssel auch dann verwendet wird, wenn Sie ein funktionierendes Pro- oder Max-Abonnement haben. Im nicht interaktiven Modus (`-p`) wird der Schlüssel immer verwendet, wenn er vorhanden ist.

1029 1035

1030**Was zu tun ist:**1036**Was Sie tun können:**

1031 1037

1032* Heben Sie `ANTHROPIC_API_KEY` in der aktuellen Shell auf und entfernen Sie ihn aus Ihrem Shell-Profil, dann starten Sie `claude` neu1038* Heben Sie `ANTHROPIC_API_KEY` in der aktuellen Shell auf, entfernen Sie ihn aus Ihrem Shell-Profil und starten Sie `claude` dann neu

1033* Wenn die Meldung `Update or unset` sagt, haben Sie keine gespeicherte Anmeldung, auf die Sie zurückgreifen können. Heben Sie den Schlüssel auf und führen Sie `/login` aus, oder ersetzen Sie den Schlüssel durch einen von einer aktiven Console-Organisation.1039* Wenn die Meldung `Update or unset` lautet, haben Sie keine gespeicherte Anmeldung, auf die zurückgegriffen werden kann. Heben Sie den Schlüssel auf und führen Sie `/login` aus, oder ersetzen Sie den Schlüssel durch einen aus einer aktiven Console-Organisation.

1034* Führen Sie danach `/status` aus, um zu bestätigen, dass die aktive Anmeldedaten Ihr Abonnement ist1040* Führen Sie anschließend `/status` aus, um zu prüfen, ob Ihr Abonnement die aktiven Anmeldedaten sind

1035* Wenn keine Umgebungsvariable gesetzt ist und der Fehler weiterhin besteht, kontaktieren Sie den Support oder melden Sie sich mit einem anderen Konto an.1041* Wenn keine Umgebungsvariable gesetzt ist und der Fehler weiterhin auftritt, wenden Sie sich an den Support oder melden Sie sich mit einem anderen Konto an.

1036 1042

1037<h3 id="your-organization-has-disabled-api-key-authentication">1043<h3 id="your-organization-has-disabled-api-key-authentication">

1038 Ihre Organisation hat die API-Schlüssel-Authentifizierung deaktiviert1044 Ihre Organisation hat die Authentifizierung per API-Schlüssel deaktiviert

1039</h3>1045</h3>

1040 1046

1041Diese Meldung erfordert Claude Code v2.1.169 oder später. Der Administrator Ihrer Console-Organisation hat die API-Schlüssel-Authentifizierung deaktiviert, sodass die API den Schlüssel ablehnt, den Claude Code sendet. Der Wiederherstellungshinweis nach dem `·` variiert je nachdem, woher der Schlüssel stammt:1047Diese Meldung erfordert Claude Code v2.1.169 oder höher. Der Admin Ihrer Console-Organisation hat die Authentifizierung per API-Schlüssel deaktiviert, daher lehnt die API den Schlüssel ab, den Claude Code sendet. Der Hinweis zur Behebung nach dem `·` hängt davon ab, woher der Schlüssel stammt:

1042 1048

1043```text theme={null}1049```text theme={null}

1044Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account1050Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account

1048Your organization has disabled API key authentication · Sign in again with your claude.ai account1054Your organization has disabled API key authentication · Sign in again with your claude.ai account

1049```1055```

1050 1056

1051Die letzte Form erscheint in einer Sitzung, die die Claude Desktop-App ausführt, z. B. die Registerkarte „Code" oder Cowork, wo Sie sich erneut über die App anmelden.1057Die letzte Form erscheint in einer Sitzung, die die Claude Desktop-App ausführt, etwa im Code-Tab oder in Cowork, wo Sie sich in der App erneut anmelden.

1052 1058

1053Umgebungsvariablen und `apiKeyHelper` haben Vorrang vor `/login`, sodass das alleinige Ausführen von `/login` nicht hilft, während einer von ihnen noch einen Schlüssel liefert. Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence).1059Umgebungsvariablen und `apiKeyHelper` haben Vorrang vor `/login`, daher hilft `/login` allein nicht, solange eines davon noch einen Schlüssel liefert. Siehe [Rangfolge der Authentifizierung](/docs/de/authentication#authentication-precedence).

1054 1060

1055**Was zu tun ist:**1061**Was Sie tun können:**

1056 1062

1057* Wenn die Meldung `ANTHROPIC_API_KEY` benennt, heben Sie es in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil oder `.env`-Datei, dann starten Sie `claude` neu1063* Wenn die Meldung `ANTHROPIC_API_KEY` nennt, heben Sie die Variable in der aktuellen Shell auf, entfernen Sie sie aus Ihrem Shell-Profil oder Ihrer `.env`-Datei und starten Sie `claude` dann neu

1058* Wenn die Meldung `apiKeyHelper` benennt, entfernen Sie die [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper)-Einstellung aus Ihrer `settings.json`1064* Wenn die Meldung `apiKeyHelper` nennt, entfernen Sie die Einstellung [`apiKeyHelper`](/docs/de/settings-reference#apikeyhelper) aus Ihrer `settings.json`

1059* Führen Sie `/login` aus, um sich mit Ihrem claude.ai-Konto anzumelden1065* Führen Sie `/login` aus, um sich mit Ihrem claude.ai-Konto anzumelden

1060* Führen Sie danach `/status` aus, um zu bestätigen, dass die aktive Anmeldedaten Ihr Abonnement statt eines API-Schlüssels ist1066* Führen Sie anschließend `/status` aus, um zu prüfen, ob Ihr Abonnement und nicht ein API-Schlüssel die aktiven Anmeldedaten sind

1061* Wenn Sie die API-Schlüssel-Authentifizierung für die Automatisierung benötigen, bitten Sie Ihren Organisations-Administrator, sie in der Console erneut zu aktivieren1067* Wenn Sie die Authentifizierung per API-Schlüssel für die Automatisierung benötigen, bitten Sie den Admin Ihrer Organisation, sie in der Console wieder zu aktivieren

1062 1068

1063<h3 id="your-organization-has-disabled-claude-subscription-access">1069<h3 id="your-organization-has-disabled-claude-subscription-access">

1064 Ihre Organisation hat den Claude-Abonnement-Zugriff deaktiviert1070 Ihre Organisation hat den Zugriff über Claude-Abonnements deaktiviert

1065</h3>1071</h3>

1066 1072

1067Ihre Claude-Organisation erlaubt nicht, sich mit einer Abonnement-Anmeldung bei Claude Code anzumelden. Das erneute Ausführen von `/login` mit demselben Konto gibt denselben Fehler zurück.1073Ihre Claude-Organisation erlaubt keine Anmeldung bei Claude Code über ein Abonnement. Wenn Sie `/login` mit demselben Konto erneut ausführen, erhalten Sie denselben Fehler.

1068 1074

1069```text theme={null}1075```text theme={null}

1070Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access1076Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

1071```1077```

1072 1078

1073Dies ist eine serverseitige Organisations-Einstellung, sodass sie nicht durch lokale Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden kann.1079Dies ist eine serverseitige Organisationseinstellung und kann daher nicht über lokale Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden.

1074 1080

1075Das Agent SDK und der `-p`-nicht-interaktive Modus zeigen dies als den Fehlercode `oauth_org_not_allowed`.1081Das Agent SDK und der nicht interaktive Modus `-p` melden dies als Fehlercode `oauth_org_not_allowed`.

1076 1082

1077**Was zu tun ist:**1083**Was Sie tun können:**

1078 1084

1079* Bitten Sie Ihren Administrator, den Claude Code-Zugriff für Ihre Organisation zu aktivieren1085* Bitten Sie Ihren Admin, den Zugriff auf Claude Code für Ihre Organisation zu aktivieren

1080* Authentifizieren Sie sich mit einem Console-API-Schlüssel statt mit Ihrem Abonnement. Siehe [Claude Console-Authentifizierung](/docs/de/authentication#claude-console-authentication) für die Einrichtung.1086* Authentifizieren Sie sich mit einem Console-API-Schlüssel statt mit Ihrem Abonnement. Die Einrichtung ist unter [Authentifizierung über die Claude Console](/docs/de/authentication#claude-console-authentication) beschrieben.

1081* Wenn Sie der Administrator sind und keine Option zum Aktivieren des Zugriffs sehen, kontaktieren Sie den [Anthropic-Support](https://support.claude.com)1087* Wenn Sie der Admin sind und keine Option zum Aktivieren des Zugriffs sehen, wenden Sie sich an den [Anthropic-Support](https://support.claude.com)

1082 1088

1083<h3 id="routines-are-disabled-by-your-organizations-policy">1089<h3 id="routines-are-disabled-by-your-organizations-policy">

1084 Routinen sind durch die Richtlinie Ihrer Organisation deaktiviert1090 Routinen sind durch die Richtlinie Ihrer Organisation deaktiviert

1085</h3>1091</h3>

1086 1092

1087Ein Eigentümer in Ihrer Team- oder Enterprise-Organisation hat Routinen auf Organisations-Ebene deaktiviert. Der Fehler erscheint, wenn Sie versuchen, eine Routine zu erstellen oder auszuführen, z. B. über die [Routinen](/docs/de/routines)-Benutzeroberfläche auf claude.ai/code. Auf Claude Code v2.1.227 oder später [verbirgt die gleiche Einstellung auch `/schedule`](/docs/de/routines#troubleshooting) in der CLI.1093Ein Owner in Ihrer Team- oder Enterprise-Organisation hat Routinen auf Organisationsebene deaktiviert. Der Fehler erscheint, wenn Sie versuchen, eine Routine zu erstellen oder auszuführen, zum Beispiel über die [Routinen](/docs/de/routines)-Oberfläche auf claude.ai/code. Ab Claude Code v2.1.227 [blendet](/docs/de/routines#troubleshooting) dieselbe Einstellung auch `/schedule` in der CLI aus.

1088 1094

1089```text theme={null}1095```text theme={null}

1090Routines are disabled by your organization's policy.1096Routines are disabled by your organization's policy.

1091```1097```

1092 1098

1093Dies ist eine serverseitige Einstellung, sodass sie nicht durch lokale Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden kann.1099Dies ist eine serverseitige Einstellung und kann daher nicht über lokale Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden.

1094 1100

1095**Was zu tun ist:**1101**Was Sie tun können:**

1096 1102

1097* Bitten Sie einen Eigentümer in Ihrer Organisation, den **Routines**-Schalter unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) zu aktivieren1103* Bitten Sie einen Owner in Ihrer Organisation, den Schalter **Routines** unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) zu aktivieren

1098* Für einmalige geplante Arbeiten, die keine Organisations-Ebenen-Routinen erfordern, siehe [geplante Aufgaben](/docs/de/scheduled-tasks)1104* Für einmalige geplante Arbeiten, die keine Routinen auf Organisationsebene erfordern, siehe [geplante Aufgaben](/docs/de/scheduled-tasks)

1099 1105

1100<h3 id="remote-control-requires-the-anthropic-api">1106<h3 id="remote-control-requires-the-anthropic-api">

1101 Remote Control erfordert die Anthropic API1107 Remote Control erfordert die Anthropic API

1102</h3>1108</h3>

1103 1109

1104Die Sitzung spricht nicht direkt mit der Anthropic API, was [Remote Control](/docs/de/remote-control) erfordert.1110Die Sitzung kommuniziert nicht direkt mit der Anthropic API, was [Remote Control](/docs/de/remote-control) voraussetzt.

1105 1111

1106```text theme={null}1112```text theme={null}

1107Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.1113Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.

1108```1114```

1109 1115

1110Ein zweiter Satz erklärt, was die Sitzung von der Anthropic API weg geleitet hat; vor v2.1.219 war die Meldung nur der erste Satz. Je nach Ursache benennt die Meldung:1116Ein zweiter Satz erklärt, wodurch die Sitzung von der Anthropic API weggeleitet wurde; vor v2.1.219 bestand die Meldung nur aus dem ersten Satz. Je nach Ursache nennt die Meldung:

1111 1117

1112* Eine `CLAUDE_CODE_USE_*`-Provider-Variable, z. B. `CLAUDE_CODE_USE_BEDROCK` für [Amazon Bedrock](/docs/de/amazon-bedrock) oder `CLAUDE_CODE_USE_VERTEX` für [Google Cloud's Agent Platform](/docs/de/google-vertex-ai)1118* Eine `CLAUDE_CODE_USE_*`-Anbietervariable, etwa `CLAUDE_CODE_USE_BEDROCK` für [Amazon Bedrock](/docs/de/amazon-bedrock) oder `CLAUDE_CODE_USE_VERTEX` für [Google Cloud's Agent Platform](/docs/de/google-vertex-ai)

1113* [`ANTHROPIC_BASE_URL`](/docs/de/env-vars), das auf einen anderen Host als `api.anthropic.com` zeigt, z. B. ein [LLM-Gateway](/docs/de/llm-gateway) oder Proxy, selbst wenn Sie sich mit claude.ai anmelden; vor v2.1.196 blockierte eine benutzerdefinierte Basis-URL Remote Control nicht1119* [`ANTHROPIC_BASE_URL`](/docs/de/env-vars), das auf einen anderen Host als `api.anthropic.com` verweist, etwa ein [LLM-Gateway](/docs/de/llm-gateway) oder einen Proxy, auch wenn Sie sich mit claude.ai anmelden; vor v2.1.196 hat eine benutzerdefinierte Basis-URL Remote Control nicht blockiert

1114* `ANTHROPIC_UNIX_SOCKET` gesetzt, sodass die Sitzung ihre Anfragen durch einen lokalen Socket statt an `api.anthropic.com` sendet1120* `ANTHROPIC_UNIX_SOCKET` ist gesetzt, sodass die Sitzung ihre Anfragen über einen lokalen Socket statt an `api.anthropic.com` sendet

1115* Eine Enterprise-[Cloud-Gateway](/docs/de/claude-apps-gateway)-Anmeldung, die über `/login` erfolgt ist, die Remote Control nicht unterstützt und keine Variable zum Aufheben hat1121* Eine Anmeldung bei einem Enterprise-[Cloud-Gateway](/docs/de/claude-apps-gateway) über `/login`, die Remote Control nicht unterstützt und keine Variable hat, die aufgehoben werden könnte

1116 1122

1117**Was zu tun ist:**1123**Was Sie tun können:**

1118 1124

1119* Heben Sie die Variable auf, die die Meldung benennt, z. B. `CLAUDE_CODE_USE_BEDROCK` oder `ANTHROPIC_BASE_URL`, und starten Sie die Sitzung neu, oder starten Sie Remote Control von einer Sitzung aus, die direkt mit der Anthropic API spricht1125* Heben Sie die Variable auf, die die Meldung nennt, etwa `CLAUDE_CODE_USE_BEDROCK` oder `ANTHROPIC_BASE_URL`, und starten Sie die Sitzung neu, oder starten Sie Remote Control aus einer Sitzung, die direkt mit der Anthropic API kommuniziert

1120* Wenn die Variable nicht in Ihrer Shell gesetzt ist, überprüfen Sie den `env`-Schlüssel in Ihren [Einstellungsdateien](/docs/de/settings#where-settings-live), die Umgebungsvariablen auf jede Sitzung anwenden1126* Wenn die Variable in Ihrer Shell nicht gesetzt ist, prüfen Sie den Schlüssel `env` in Ihren [Einstellungsdateien](/docs/de/settings#where-settings-live), der Umgebungsvariablen auf jede Sitzung anwendet

1121* Für diese und die anderen Remote Control-Startup-Meldungen siehe [Remote Control beheben](/docs/de/remote-control#troubleshooting)1127* Für diese und die anderen Startmeldungen von Remote Control siehe [Fehlerbehebung für Remote Control](/docs/de/remote-control#troubleshooting)

1122 1128

1123<h3 id="remote-control-couldnt-refresh-your-login">1129<h3 id="remote-control-couldnt-refresh-your-login">

1124 Remote Control konnte Ihre Anmeldung nicht aktualisieren1130 Remote Control konnte Ihre Anmeldung nicht erneuern

1125</h3>1131</h3>

1126 1132

1127Claude Code führt eine Live-[Remote Control](/docs/de/remote-control)-Verbindung auf kurzlebigen Anmeldedaten aus, die es mit Ihrer gespeicherten claude.ai-Anmeldung erhält und erneuert. Wenn claude.ai diese Anmeldung nicht mehr akzeptiert oder Claude Code keine gespeicherte Anmeldung mehr hat, stoppt Claude Code Remote Control und benötigt Sie, um sich erneut anzumelden. Jeder Fehler kann auftreten, während Claude Code noch verbunden wird, oder später, wenn es die Anmeldedaten erneuert.1133Claude Code betreibt eine aktive [Remote Control](/docs/de/remote-control)-Verbindung mit kurzlebigen Anmeldedaten, die es mithilfe Ihrer gespeicherten claude.ai-Anmeldung abruft und erneuert. Wenn claude.ai diese Anmeldung nicht mehr akzeptiert oder Claude Code keine gespeicherte Anmeldung mehr hat, beendet Claude Code Remote Control, und Sie müssen sich erneut anmelden. Beide Fehler können auftreten, während Claude Code noch die Verbindung herstellt, oder später, wenn es die Anmeldedaten erneuert.

1128 1134

1129Wenn Claude Code den Login-Service auffordert, Ihre gespeicherte Anmeldung zu aktualisieren, und keine Antwort erhält, behält es Remote Control am Laufen und versucht die Aktualisierung erneut, während die Anmeldedaten der Verbindung noch gültig sind. Eine Aktualisierung erhält keine Antwort, wenn Claude Code den Login-Service nicht erreichen kann, die Anfrage das Zeitlimit überschreitet oder der Service fehlschlägt, ohne Ihre Anmeldung abzulehnen. Wenn der Login-Service immer noch nicht antwortet, wenn diese Anmeldedaten ablaufen, stoppt Claude Code Remote Control und meldet `OAuth token refresh failed`.1135Wenn Claude Code den Anmeldedienst auffordert, Ihre gespeicherte Anmeldung zu erneuern, und keine Antwort erhält, lässt es Remote Control weiterlaufen und versucht die Erneuerung erneut, solange die aktuellen Anmeldedaten der Verbindung noch gültig sind. Eine Erneuerung erhält keine Antwort, wenn Claude Code den Anmeldedienst nicht erreichen kann, die Anfrage eine Zeitüberschreitung erreicht oder der Dienst fehlschlägt, ohne Ihre Anmeldung abzulehnen. Wenn der Anmeldedienst beim Ablauf dieser Anmeldedaten immer noch nicht antwortet, beendet Claude Code Remote Control und meldet `OAuth token refresh failed`.

1130 1136

1131Wenn Claude Code Remote Control stoppt, zeigt es den Grund in einer Warnung und in einer Transkriptzeile an, die mit `Remote Control disconnected` beginnt. Ihre lokale Sitzung läuft ohne Remote Control weiter. Dieser Abschnitt behandelt diese Zeilen:1137Wenn Claude Code Remote Control beendet, zeigt es den Grund in einer Warnung und in einer Transkriptzeile an, die mit `Remote Control disconnected` beginnt. Ihre lokale Sitzung läuft ohne Remote Control weiter. Dieser Abschnitt behandelt diese Zeilen:

1132 1138

1133```text theme={null}1139```text theme={null}

1134Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control1140Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control

1140Remote Control disconnected — Signed out of Claude — run /login, then /remote-control1146Remote Control disconnected — Signed out of Claude — run /login, then /remote-control

1141```1147```

1142 1148

1143Claude Code benennt die Ursache in der Mitte der Meldung:1149Claude Code nennt die Ursache im mittleren Teil der Meldung:

1144 1150

1145* `Claude.ai login expired` und `Claude.ai login was rejected`: claude.ai akzeptiert Ihren gespeicherten Login-Token nicht mehr, weil er abgelaufen oder widerrufen wurde1151* `Claude.ai login expired` und `Claude.ai login was rejected`: claude.ai akzeptiert Ihr gespeichertes Anmelde-Token nicht mehr, weil es abgelaufen ist oder widerrufen wurde

1146* `OAuth token unavailable`: Claude Code hatte keinen gespeicherten Login-Token, als die Anmeldedaten der Verbindung zur Erneuerung fällig wurden1152* `OAuth token unavailable`: Claude Code hatte kein gespeichertes Anmelde-Token, als die Anmeldedaten der Verbindung erneuert werden mussten

1147* `OAuth token refresh failed`: claude.ai lehnte Ihren gespeicherten Login-Token ab, während Claude Code sich erneut verbunden hat, und das Aktualisieren des Tokens hat keinen neuen erzeugt1153* `OAuth token refresh failed`: claude.ai hat Ihr gespeichertes Anmelde-Token abgelehnt, während Claude Code die Verbindung wiederherstellte, und die Erneuerung des Tokens hat kein neues geliefert

1148* `JWT refresh failed: no OAuth token`: Claude Code hat keinen gespeicherten Login-Token zum Erneuern gefunden1154* `JWT refresh failed: no OAuth token`: Claude Code hat kein gespeichertes Anmelde-Token zum Erneuern gefunden

1149* `Signed out of Claude`: Sie haben sich auf dieser Maschine abgemeldet, z. B. durch Ausführung von `/logout` in einem anderen Terminal, sodass Claude Code keine gespeicherte Anmeldung mehr hat, um die Verbindung zu erneuern1155* `Signed out of Claude`: Sie haben sich auf diesem Rechner abgemeldet, zum Beispiel durch Ausführen von `/logout` in einem anderen Terminal, sodass Claude Code keine gespeicherte Anmeldung mehr hat, mit der es die Verbindung erneuern kann

1150 1156

1151**Was zu tun ist:**1157**Was Sie tun können:**

1152 1158

1153* Führen Sie `/login` aus, um sich erneut anzumelden1159* Führen Sie `/login` aus, um sich erneut anzumelden

1154* Führen Sie `/remote-control` aus, um die Sitzung erneut zu verbinden. Meldungen, die mit `run /login to restore Remote Control` enden, benötigen diesen Schritt nicht: Claude Code verbindet sich automatisch erneut, sobald Sie sich anmelden.1160* Führen Sie `/remote-control` aus, um die Sitzung wieder zu verbinden. Meldungen, die mit `run /login to restore Remote Control` enden, benötigen diesen Schritt nicht: Claude Code verbindet sich nach Ihrer Anmeldung automatisch wieder.

1155 1161

1156Vor v2.1.224 las `OAuth token refresh failed — run /login to re-authenticate` `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, und `JWT refresh failed: no OAuth token — run /login` las `no OAuth token available for recovery (code <N>)`. Die Meldungen `Claude.ai login expired`, `Claude.ai login was rejected` und `OAuth token unavailable` wurden in v2.1.225 hinzugefügt.1162Vor v2.1.224 lautete `OAuth token refresh failed — run /login to re-authenticate` noch `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, und `JWT refresh failed: no OAuth token — run /login` lautete `no OAuth token available for recovery (code <N>)`. Die Meldungen `Claude.ai login expired`, `Claude.ai login was rejected` und `OAuth token unavailable` wurden in v2.1.225 hinzugefügt.

1157 1163

1158Vor v2.1.238 meldete Claude Code die Fälle, die jetzt `Signed out of Claude` sagen, als `JWT refresh failed: no OAuth token — run /login`, und stoppt Remote Control mit `Claude.ai login expired — run /login to restore Remote Control`, sobald eine Login-Aktualisierung keine Antwort erhielt.1164Vor v2.1.238 meldete Claude Code die Fälle, die jetzt `Signed out of Claude` lauten, als `JWT refresh failed: no OAuth token — run /login` und beendete Remote Control mit `Claude.ai login expired — run /login to restore Remote Control`, sobald eine Erneuerung der Anmeldung keine Antwort erhielt.

1159 1165

1160<h3 id="remote-control-stopped-because-the-signed-in-account-changed">1166<h3 id="remote-control-stopped-because-the-signed-in-account-changed">

1161 Remote Control wurde gestoppt, weil sich das angemeldete Konto geändert hat1167 Remote Control wurde beendet, weil sich das angemeldete Konto geändert hat

1162</h3>1168</h3>

1163 1169

1164Claude Code zeigt diese Zeile während einer [Remote Control](/docs/de/remote-control)-Sitzung an, wenn Sie sich auf dieser Maschine bei einem anderen claude.ai-Konto oder einer anderen Organisation anmelden. Sie haben den Wechsel außerhalb der Claude Code-Sitzung vorgenommen, z. B. durch Ausführung von `/login` in einem anderen Terminal.1170Claude Code zeigt diese Zeile während einer [Remote Control](/docs/de/remote-control)-Sitzung an, wenn Sie sich auf diesem Rechner bei einem anderen claude.ai-Konto oder einer anderen Organisation anmelden. Sie haben den Wechsel außerhalb der Claude Code-Sitzung vorgenommen, zum Beispiel durch Ausführen von `/login` in einem anderen Terminal.

1165 1171

1166Eine Remote Control-Sitzung, die Sie gestartet haben, während Sie über `/login` angemeldet waren, gehört zum claude.ai-Konto und zur Organisation, die zum Zeitpunkt des Starts angemeldet waren.1172Eine Remote-Control-Sitzung, die Sie gestartet haben, während Sie über `/login` angemeldet waren, gehört zu dem claude.ai-Konto und der Organisation, die zu diesem Zeitpunkt angemeldet waren.

1167 1173

1168```text theme={null}1174```text theme={null}

1169Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control1175Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control

1170```1176```

1171 1177

1172Claude Code stoppt die Remote Control-Sitzung, sobald claude.ai bestätigt, dass sich das Konto oder die Organisation geändert hat. Ihre lokale Sitzung läuft ohne Remote Control weiter.1178Claude Code beendet die Remote-Control-Sitzung, sobald claude.ai bestätigt, dass sich das Konto oder die Organisation geändert hat. Ihre lokale Sitzung läuft ohne Remote Control weiter.

1173 1179

1174**Was zu tun ist:**1180**Was Sie tun können:**

1175 1181

1176* Führen Sie `/remote-control` aus, um eine neue Remote Control-Sitzung unter dem aktuellen Konto oder der aktuellen Organisation zu starten1182* Führen Sie `/remote-control` aus, um eine neue Remote-Control-Sitzung unter dem aktuellen Konto oder der aktuellen Organisation zu starten

1177* Um zurückzuwechseln, führen Sie `/login` aus und melden Sie sich erneut bei dem vorherigen Konto oder der vorherigen Organisation an. Dann führen Sie `/remote-control` aus.1183* Um zurückzuwechseln, führen Sie `/login` aus und melden Sie sich erneut beim vorherigen Konto oder der vorherigen Organisation an. Führen Sie dann `/remote-control` aus.

1178 1184

1179Vor v2.1.234 bemerkte Claude Code nicht, wenn Sie sich außerhalb der Claude Code-Sitzung bei einem anderen Konto oder einer anderen Organisation anmeldeten. Claude Code behielt die Remote Control-Sitzung verbunden, bis eine spätere Anfrage an den Remote Control-Server mit `Remote Control server rejected the request (HTTP 404)` fehlschlug. Dieser Fehler konnte Stunden nach dem Wechsel auftreten.1185Vor v2.1.234 hat Claude Code nicht bemerkt, wenn Sie außerhalb der Claude Code-Sitzung zu einem anderen Konto oder einer anderen Organisation gewechselt sind. Claude Code hielt die Remote-Control-Sitzung verbunden, bis eine spätere Anfrage an den Remote-Control-Server mit `Remote Control server rejected the request (HTTP 404)` fehlschlug. Dieser Fehler konnte Stunden nach dem Wechsel auftreten.

1180 1186

1181<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">1187<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">

1182 Remote Control wurde gestoppt, weil sich die App, die die Sitzung ausführt, abgemeldet oder Konten gewechselt hat1188 Remote Control wurde beendet, weil sich die App, die die Sitzung ausführt, abgemeldet oder das Konto gewechselt hat

1183</h3>1189</h3>

1184 1190

1185Wenn die Claude Desktop-App oder eine IDE Ihre Sitzung hostet, erhält Claude Code seinen Login-Token von dieser App statt von `/login`. Wenn claude.ai diesen Token ablehnt, fragt Claude Code die App nach einem neuen. Wenn die App antwortet, dass sie abgemeldet ist, oder dass sie jetzt bei einem anderen Claude-Konto angemeldet ist, beendet Claude Code die [Remote Control](/docs/de/remote-control)-Sitzung und sendet der App eine dieser Zeilen:1191Wenn die Claude Desktop-App oder eine IDE Ihre Sitzung hostet, erhält Claude Code sein Anmelde-Token von dieser App statt von `/login`. Wenn claude.ai dieses Token ablehnt, fordert Claude Code bei der App ein neues an. Wenn die App antwortet, dass sie abgemeldet ist oder jetzt bei einem anderen Claude-Konto angemeldet ist, beendet Claude Code die [Remote Control](/docs/de/remote-control)-Sitzung und sendet der App eine dieser Zeilen:

1186 1192

1187```text theme={null}1193```text theme={null}

1188Remote Control stopped — the app running this session is now signed in to a different Claude account1194Remote Control stopped — the app running this session is now signed in to a different Claude account

1191 1197

1192Ihre lokale Sitzung läuft ohne Remote Control weiter.1198Ihre lokale Sitzung läuft ohne Remote Control weiter.

1193 1199

1194**Was zu tun ist:**1200**Was Sie tun können:**

1195 1201

1196* Wenn die App abgemeldet ist, melden Sie sich erneut an und schalten Sie Remote Control in der App wieder ein1202* Wenn die App abgemeldet ist, melden Sie sich erneut bei ihr an und schalten Sie Remote Control dann in der App wieder ein

1197* Wenn die App Konten gewechselt hat, kann Claude Code die beendete Sitzung unter dem neuen Konto nicht fortsetzen. Starten Sie eine neue Remote Control-Sitzung unter diesem Konto.1203* Wenn die App das Konto gewechselt hat, kann Claude Code die beendete Sitzung nicht unter dem neuen Konto fortsetzen. Starten Sie eine neue Remote-Control-Sitzung unter diesem Konto.

1198 1204

1199Vor v2.1.238 sendete Claude Code der App die unter [Remote Control konnte Ihre Anmeldung nicht aktualisieren](#remote-control-couldnt-refresh-your-login) aufgelisteten `run /login`-Meldungen in beiden Fällen.1205Vor v2.1.238 hat Claude Code der App in beiden Fällen die `run /login`-Meldungen gesendet, die unter [Remote Control konnte Ihre Anmeldung nicht erneuern](#remote-control-couldnt-refresh-your-login) aufgeführt sind.

1200 1206

1201<h3 id="oauth-token-revoked-or-expired">1207<h3 id="oauth-token-revoked-or-expired">

1202 OAuth-Token widerrufen oder abgelaufen1208 OAuth-Token widerrufen oder abgelaufen

1203</h3>1209</h3>

1204 1210

1205Ihre gespeicherte Anmeldung ist nicht mehr gültig. Ein widerrufener Token bedeutet, dass Sie sich überall abgemeldet haben oder ein Administrator den Zugriff entfernt hat; ein abgelaufener Token bedeutet, dass die automatische Aktualisierung während der Sitzung fehlgeschlagen ist.1211Ihre gespeicherte Anmeldung ist nicht mehr gültig. Ein widerrufenes Token bedeutet, dass Sie sich überall abgemeldet haben oder ein Admin den Zugriff entzogen hat; ein abgelaufenes Token bedeutet, dass die automatische Erneuerung während der Sitzung fehlgeschlagen ist.

1206 1212

1207Beide Meldungen melden eine Ablehnung, die die API für eine Anfrage zurückgegeben hat, die Claude Code gesendet hat. Wenn die gespeicherte Anmeldung nach einer fehlgeschlagenen Aktualisierung bereits gelöscht wurde, sehen Sie stattdessen [Anmeldung abgelaufen](#login-expired). Wenn Sie sich mit einem langlebigen Token in [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) authentifizieren, sehen Sie die gleichen Meldungen, wenn dieser Token abläuft oder widerrufen wird.1213Beide Meldungen melden eine Ablehnung, die die API für eine von Claude Code gesendete Anfrage zurückgegeben hat. Wenn die gespeicherte Anmeldung nach einer fehlgeschlagenen Erneuerung bereits gelöscht wurde, sehen Sie stattdessen [Anmeldung abgelaufen](#login-expired). Wenn Sie sich mit einem langlebigen Token in [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) authentifizieren, sehen Sie dieselben Meldungen, wenn dieses Token abläuft oder widerrufen wird.

1208 1214

1209```text theme={null}1215```text theme={null}

1210OAuth token revoked · Please run /login1216OAuth token revoked · Please run /login

1211Please run /login · API Error: 401 OAuth token has expired ...1217Please run /login · API Error: 401 OAuth token has expired ...

1212```1218```

1213 1219

1214**Was zu tun ist:**1220**Was Sie tun können:**

1215 1221

1216* Führen Sie `/login` aus, um sich erneut anzumelden1222* Führen Sie `/login` aus, um sich erneut anzumelden

1217* Wenn Sie sich mit der Umgebungsvariable `CLAUDE_CODE_OAUTH_TOKEN` authentifizieren, sendet Claude Code weiterhin den Wert, den Sie gesetzt haben, nachdem eine Anfrage mit einem 401 fehlschlägt, anstatt zu einem Token einer gespeicherten Anmeldung zu wechseln. [`/status`](/docs/de/commands) zeigt diese Anmeldedaten als eine `Auth token`-Zeile an, die `CLAUDE_CODE_OAUTH_TOKEN` liest. Generieren Sie einen neuen Token mit [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) und starten Sie damit neu, oder heben Sie die Variable auf und führen Sie `/login` aus. Vor v2.1.225 konnte Claude Code den Wert der Variablen während der Sitzung durch den kurzlebigen Zugriffs-Token aus einer gespeicherten Anmeldung ersetzen, und die Sitzung schlägt erneut mit 401-Fehlern fehl, sobald dieser Token abläuft.1223* Wenn Sie sich mit der Umgebungsvariable `CLAUDE_CODE_OAUTH_TOKEN` authentifizieren, sendet Claude Code nach einer mit 401 fehlgeschlagenen Anfrage weiterhin den von Ihnen gesetzten Wert, statt zum Token einer gespeicherten Anmeldung zu wechseln. [`/status`](/docs/de/commands) zeigt diese Anmeldedaten als Zeile `Auth token` mit dem Wert `CLAUDE_CODE_OAUTH_TOKEN`. Erzeugen Sie mit [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) ein neues Token und starten Sie damit neu, oder heben Sie die Variable auf und führen Sie `/login` aus. Vor v2.1.225 konnte Claude Code den Wert der Variable während der Sitzung durch das kurzlebige Zugriffstoken einer gespeicherten Anmeldung ersetzen, und die Sitzung schlug erneut mit 401-Fehlern fehl, sobald dieses Token abgelaufen war.

1218* Für wiederholte Aufforderungen zum Anmelden über Starts hinweg siehe die Systemuhr-Überprüfungen und macOS-Wiederherstellungsschritte für die Anmeldedatenverwaltung in [Fehlerbehebung](/docs/de/troubleshoot-install#not-logged-in-or-token-expired)1224* Bei wiederholten Aufforderungen zur Anmeldung über mehrere Starts hinweg finden Sie unter [Fehlerbehebung](/docs/de/troubleshoot-install#not-logged-in-or-token-expired) Prüfungen der Systemuhr und Schritte zur Wiederherstellung des Anmeldedatenspeichers unter macOS

1219* Für andere Fehler, einschließlich `403 Forbidden` und OAuth-Browser-Probleme, siehe [Anmeldung und Authentifizierung](/docs/de/troubleshoot-install#login-and-authentication)1225* Für andere Fehler, einschließlich `403 Forbidden` und Problemen mit dem OAuth-Browser, siehe [Anmeldung und Authentifizierung](/docs/de/troubleshoot-install#login-and-authentication)

1220 1226

1221<h3 id="api-error-401-invalid-authentication-credentials">1227<h3 id="api-error-401-invalid-authentication-credentials">

1222 API-Fehler: 401 Ungültige Authentifizierungsanmeldedaten1228 API Error: 401 Invalid authentication credentials

1223</h3>1229</h3>

1224 1230

1225Die API erkannte das Format Ihrer Anmeldedaten, lehnte aber das Konto oder die Organisation dahinter ab. Anthropic gibt diese Meldung zurück, wenn eine Anmeldedaten kürzlich widerrufen wurde, wenn eine Organisation deaktiviert wurde oder Ihren Zugriff entfernt hat, oder wenn das Konto selbst deaktiviert wurde, sodass ein abgelaufener Token nicht die Ursache ist. Die Anmeldedaten können Ihre gespeicherte Anmeldung oder ein genehmigter `ANTHROPIC_API_KEY` sein, und die Behebung unterscheidet sich, also beginnen Sie mit dem Ausführen von `/status`, um zu sehen, welche aktiv ist.1231Die API hat das Format Ihrer Anmeldedaten erkannt, aber das dahinterstehende Konto oder die Organisation abgelehnt. Anthropic gibt diese Meldung zurück, wenn Anmeldedaten kürzlich widerrufen wurden, wenn eine Organisation deaktiviert wurde oder Ihren Zugriff entfernt hat oder wenn das Konto selbst deaktiviert wurde; ein abgelaufenes Token ist also nicht die Ursache. Die Anmeldedaten können Ihre gespeicherte Anmeldung oder ein genehmigter `ANTHROPIC_API_KEY` sein, und die Behebung unterscheidet sich. Führen Sie daher zuerst `/status` aus, um zu sehen, welche davon aktiv sind.

1226 1232

1227```text theme={null}1233```text theme={null}

1228Please run /login · API Error: 401 Invalid authentication credentials1234Please run /login · API Error: 401 Invalid authentication credentials

1229```1235```

1230 1236

1231**Was zu tun ist:**1237**Was Sie tun können:**

1232 1238

1233* Wenn `/status` eine `API key`-Zeile zeigt, die nicht als nicht in Verwendung markiert ist, ist ein genehmigter [`ANTHROPIC_API_KEY`](/docs/de/authentication#authentication-precedence) die aktive Anmeldedaten und hat Vorrang vor Ihrer Anmeldung, sodass `/login` ihn nicht ersetzt. Rotieren Sie den Schlüssel in der Claude Console, oder greifen Sie auf Ihr Abonnement zurück, indem Sie `unset ANTHROPIC_API_KEY` ausführen, oder in PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.1239* Wenn `/status` eine Zeile `API key` anzeigt, die nicht als nicht verwendet markiert ist, ist ein genehmigter [`ANTHROPIC_API_KEY`](/docs/de/authentication#authentication-precedence) die aktive Anmeldedatenquelle und hat Vorrang vor Ihrer Anmeldung, sodass `/login` ihn nicht ersetzt. Rotieren Sie den Schlüssel in der Claude Console oder greifen Sie auf Ihr Abonnement zurück, indem Sie `unset ANTHROPIC_API_KEY` ausführen, in PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.

1234* Wenn `/status` nur Ihre Anmeldung zeigt, führen Sie `/login` einmal aus. Wenn die Anmeldedaten widerrufen wurden, ersetzt eine neue Anmeldung sie.1240* Wenn `/status` nur Ihre Anmeldung anzeigt, führen Sie einmal `/login` aus. Wenn die Anmeldedaten widerrufen wurden, ersetzt eine neue Anmeldung sie.

1235* Wenn die gleiche Meldung für das gleiche Anmeldekonto zurückkommt, ist das Konto oder die Organisation nicht mehr aktiv. Überprüfen Sie das Konto und die Organisation, die `/status` meldet, und bitten Sie Ihren Organisations-Administrator, den Zugriff wiederherzustellen.1241* Wenn dieselbe Meldung für dasselbe Anmeldekonto erneut erscheint, ist das Konto oder die Organisation nicht mehr aktiv. Prüfen Sie das Konto und die Organisation, die `/status` meldet, und bitten Sie den Admin Ihrer Organisation, den Zugriff wiederherzustellen.

1236* Wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf ein [LLM-Gateway](/docs/de/llm-gateway) zeigt, ist der Text nach `401` die Meldung Ihres Gateways statt Anthropic's, und `/login` ändert ihn nicht. Beheben Sie stattdessen die Anmeldedaten, die Ihr Gateway erwartet.1242* Wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf ein [LLM-Gateway](/docs/de/llm-gateway) verweist, ist der Text nach `401` die Meldung Ihres Gateways und nicht die von Anthropic, und `/login` ändert daran nichts. Korrigieren Sie stattdessen die Anmeldedaten, die Ihr Gateway erwartet.

1237 1243

1238<h3 id="login-expired">1244<h3 id="login-expired">

1239 Anmeldung abgelaufen1245 Anmeldung abgelaufen

1240</h3>1246</h3>

1241 1247

1242Claude Code versuchte, Ihre gespeicherte claude.ai-Anmeldung zu erneuern, und der OAuth-Service lehnte den gespeicherten Aktualisierungs-Token ab, sodass Claude Code die gespeicherten Anmeldedaten gelöscht hat. Danach stoppt jede Modellanfrage lokal mit dieser Meldung, bevor sie die API erreicht, weil nur `/login` neue Anmeldedaten erstellen kann.1248Claude Code hat versucht, Ihre gespeicherte claude.ai-Anmeldung zu erneuern, und der OAuth-Dienst hat das gespeicherte Refresh-Token abgelehnt, daher hat Claude Code die gespeicherten Anmeldedaten gelöscht. Danach stoppt jede Modellanfrage lokal mit dieser Meldung, bevor sie die API erreicht, da nur `/login` neue Anmeldedaten erstellen kann.

1243 1249

1244Vor v2.1.206 hat Claude Code die Modellanfrage trotzdem mit allen verbleibenden Anmeldedaten in der Umgebung gesendet, und jedes Modell ist dann mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) oder einem 401 statt einer Aufforderung zum Anmelden fehlgeschlagen.1250Vor v2.1.206 hat Claude Code die Modellanfrage trotzdem mit den in der Umgebung verbliebenen Anmeldedaten gesendet, und jedes Modell schlug dann mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) oder einem 401 fehl, statt zur Anmeldung aufzufordern.

1245 1251

1246```text theme={null}1252```text theme={null}

1247Login expired · Please run /login1253Login expired · Please run /login

1248```1254```

1249 1255

1250Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`) und dem [Agent SDK](/docs/de/agent-sdk/overview) lautet die Meldung wie folgt, und der strukturierte Fehlercode ist `authentication_failed`:1256Im [nicht interaktiven Modus](/docs/de/headless) (`-p`) und im [Agent SDK](/docs/de/agent-sdk/overview) lautet die Meldung wie folgt, und der strukturierte Fehlercode ist `authentication_failed`:

1251 1257

1252```text theme={null}1258```text theme={null}

1253Failed to authenticate: OAuth session expired and could not be refreshed1259Failed to authenticate: OAuth session expired and could not be refreshed

1254```1260```

1255 1261

1256Dies ist nicht der gleiche Zustand wie [OAuth-Token widerrufen oder abgelaufen](#oauth-token-revoked-or-expired). Diese Meldungen melden eine Ablehnung, die die API zurückgegeben hat. Claude Code selbst erzeugt `Login expired` für eine Anmeldung, die es bereits nicht erneuern konnte, sodass es keine Anfrage sendet. Wenn die Erneuerung fehlschlägt, weil das Konto selbst ausgesetzt ist, statt dass die Anmeldung veraltet ist, zeigt Claude Code stattdessen [Ihr Konto ist gesperrt](#your-account-is-on-hold).1262Dies ist nicht derselbe Zustand wie [OAuth-Token widerrufen oder abgelaufen](#oauth-token-revoked-or-expired). Jene Meldungen melden eine Ablehnung, die die API zurückgegeben hat. `Login expired` erzeugt Claude Code selbst für eine Anmeldung, deren Erneuerung bereits fehlgeschlagen ist, daher sendet es keine Anfrage. Wenn die Erneuerung fehlschlägt, weil das Konto selbst gesperrt ist und nicht die Anmeldung veraltet ist, zeigt Claude Code stattdessen [Ihr Konto ist gesperrt](#your-account-is-on-hold) an.

1257 1263

1258Sitzungen, die mit einem API-Schlüssel, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) oder einem Drittanbieter-Provider authentifiziert sind, verwenden die gespeicherte Anmeldung nicht und sehen diese Meldung nie.1264Sitzungen, die mit einem API-Schlüssel, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) oder einem Drittanbieter authentifiziert sind, verwenden die gespeicherte Anmeldung nicht und sehen diese Meldung nie.

1259 1265

1260Sie können diesen Zustand vor einem Anfragefehler überprüfen: [`/status`](/docs/de/commands) zeigt eine `Login`-Zeile an, die `Expired — log in again` liest, plus die Organisation und E-Mail, die sie für die abgelaufene Anmeldung gespeichert hat. Die Zeile erscheint nur, wenn die gespeicherte Anmeldung Ihre aktive Anmeldedaten ist und nicht mehr erneuert werden kann. Sitzungen, die sich auf andere Weise authentifizieren, zeigen die Zeile nicht, selbst wenn eine abgelaufene Anmeldung gespeichert bleibt. Vor v2.1.210 gab `/status` in diesem Zustand keinen Hinweis darauf, dass eine Anmeldung jemals existiert hatte, weil die gelöschte Anmeldedaten ihr nichts zum Melden ließ.1266Sie können diesen Zustand prüfen, bevor eine Anfrage fehlschlägt: [`/status`](/docs/de/commands) zeigt eine Zeile `Login` mit dem Wert `Expired — log in again` sowie die Organisation und E-Mail-Adresse, die für die abgelaufene Anmeldung gespeichert sind. Die Zeile erscheint nur, wenn die gespeicherte Anmeldung Ihre aktiven Anmeldedaten sind und nicht mehr erneuert werden kann. Auf andere Weise authentifizierte Sitzungen zeigen die Zeile nicht an, auch wenn eine abgelaufene Anmeldung gespeichert bleibt. Vor v2.1.210 gab `/status` in diesem Zustand keinen Hinweis darauf, dass jemals eine Anmeldung existiert hatte, da die gelöschten Anmeldedaten nichts zu melden hinterließen.

1261 1267

1262**Was zu tun ist:**1268**Was Sie tun können:**

1263 1269

1264* Führen Sie `/login` aus, um sich erneut anzumelden. Das Wiederholen ohne Anmeldung zeigt die gleiche Meldung bei jeder Anfrage.1270* Führen Sie `/login` aus, um sich erneut anzumelden. Erneute Versuche ohne Anmeldung zeigen bei jeder Anfrage dieselbe Meldung.

1265* Im nicht-interaktiven Modus führen Sie `claude` in der gleichen Umgebung aus, führen Sie `/login` aus, dann führen Sie Ihren Befehl erneut aus. Für die Automatisierung, die sich nicht interaktiv anmelden kann, authentifizieren Sie sich mit `ANTHROPIC_API_KEY` oder [generieren Sie einen langlebigen Token mit `claude setup-token`](/docs/de/authentication#generate-a-long-lived-token).1271* Wenn Sie sich in einem anderen Claude Code-Fenster mit Ihrem claude.ai-Konto anmelden, erfahren Sie unter [Nicht angemeldet](#not-logged-in), wann diese Sitzung diese Anmeldung automatisch verwendet.

1266* Wenn das Anmelden weiterhin fehlschlägt, siehe [Anmeldung und Authentifizierung](/docs/de/troubleshoot-install#login-and-authentication)1272* Führen Sie im nicht interaktiven Modus `claude` in derselben Umgebung aus, schließen Sie `/login` ab und führen Sie dann Ihren Befehl erneut aus. Für Automatisierung, die sich nicht interaktiv anmelden kann, authentifizieren Sie sich mit `ANTHROPIC_API_KEY` oder [erzeugen Sie ein langlebiges Token mit `claude setup-token`](/docs/de/authentication#generate-a-long-lived-token).

1273* Wenn die Anmeldung weiterhin fehlschlägt, siehe [Anmeldung und Authentifizierung](/docs/de/troubleshoot-install#login-and-authentication)

1267 1274

1268<h3 id="could-not-refresh-your-login">1275<h3 id="could-not-refresh-your-login">

1269 Ihre Anmeldung konnte nicht aktualisiert werden, weil ein anderer Claude Code-Prozess sie aktualisiert1276 Ihre Anmeldung konnte nicht erneuert werden, weil ein anderer Claude Code-Prozess sie erneuert

1270</h3>1277</h3>

1271 1278

1272Diese Meldung bedeutet nicht, dass Ihre Anmeldung abgelehnt wurde. Ihre gespeicherte claude.ai-Anmeldung war abgelaufen und musste erneuert werden. Ein anderer Claude Code-Prozess auf der gleichen Maschine hielt die gemeinsame Aktualisierungs-Sperre, oder verließ sie und ließ sie zurück, und die Aktualisierung machte keinen Fortschritt, während diese Sitzung wartete. Claude Code stoppt die Anfrage, bevor sie gesendet wird:1279Diese Meldung bedeutet nicht, dass Ihre Anmeldung abgelehnt wurde. Ihre gespeicherte claude.ai-Anmeldung war abgelaufen und musste erneuert werden. Ein anderer Claude Code-Prozess auf demselben Rechner hielt die gemeinsame Erneuerungssperre oder wurde beendet und hat sie zurückgelassen, und die Erneuerung machte keinen Fortschritt, während diese Sitzung wartete. Claude Code stoppt die Anfrage vor dem Senden:

1273 1280

1274```text theme={null}1281```text theme={null}

1275Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login1282Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login

1276```1283```

1277 1284

1278Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`) und dem [Agent SDK](/docs/de/agent-sdk/overview) lautet die Meldung wie folgt, und der strukturierte Fehlercode ist `server_error`:1285Im [nicht interaktiven Modus](/docs/de/headless) (`-p`) und im [Agent SDK](/docs/de/agent-sdk/overview) lautet die Meldung wie folgt, und der strukturierte Fehlercode ist `server_error`:

1279 1286

1280```text theme={null}1287```text theme={null}

1281Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again1288Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again

1282```1289```

1283 1290

1284Sitzungen, die mit einem API-Schlüssel, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) oder einem Drittanbieter-Provider authentifiziert sind, verwenden die gespeicherte Anmeldung nicht und sehen diese Meldung nie.1291Sitzungen, die mit einem API-Schlüssel, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) oder einem Drittanbieter authentifiziert sind, verwenden die gespeicherte Anmeldung nicht und sehen diese Meldung nie.

1285 1292

1286**Was zu tun ist:**1293**Was Sie tun können:**

1287 1294

1288* Versuchen Sie es in einer Minute erneut. Wenn ein anderer Prozess die Aktualisierung zuerst abschließt, verwendet diese Sitzung die erneuerte Anmeldung.1295* Versuchen Sie es in einer Minute erneut. Wenn ein anderer Prozess die Erneuerung zuerst abschließt, verwendet diese Sitzung die erneuerte Anmeldung.

1289* Wenn die Meldung weiterhin zurückkommt, schließen Sie andere Claude Code-Fenster und -Prozesse, dann versuchen Sie es erneut.1296* Wenn die Meldung immer wieder erscheint, schließen Sie andere Claude Code-Fenster und -Prozesse und versuchen Sie es dann erneut.

1290* Wenn es mit keinem anderen Claude Code-Prozess zurückkommt, führen Sie `/login` aus. Das erneute Anmelden wartet nicht auf die Aktualisierungs-Sperre.1297* Wenn sie erscheint, obwohl kein anderer Claude Code-Prozess läuft, führen Sie `/login` aus. Eine erneute Anmeldung wartet nicht auf die Erneuerungssperre.

1291 1298

1292<h3 id="couldnt-save-your-login">1299<h3 id="couldnt-save-your-login">

1293 Ihre Anmeldung konnte nicht gespeichert werden1300 Ihre Anmeldung konnte nicht gespeichert werden

1294</h3>1301</h3>

1295 1302

1296Sie haben sich mit claude.ai angemeldet, aber Claude Code konnte die Anmeldung nicht in seinem Anmeldedaten-Speicher speichern, sodass die Anmeldung nicht abgeschlossen wurde. Auf macOS kann dies passieren, wenn der Anmeldungs-Schlüsselbund sperrt, z. B. beim Ruhezustand oder bei Untätigkeit, nachdem Claude Code bereits Anmeldedaten darin während der gleichen Sitzung gelesen oder gespeichert hat.1303Sie haben sich mit claude.ai angemeldet, aber Claude Code konnte die Anmeldung nicht in seinem Anmeldedatenspeicher speichern, daher wurde die Anmeldung nicht abgeschlossen. Unter macOS kann dies passieren, wenn der Anmeldeschlüsselbund gesperrt wird, zum Beispiel im Ruhezustand oder bei Inaktivität, nachdem Claude Code während derselben Sitzung bereits Anmeldedaten darin gelesen oder gespeichert hat.

1297 1304

1298```text theme={null}1305```text theme={null}

1299Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.1306Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.

1300Couldn't save your login. Try logging in again.1307Couldn't save your login. Try logging in again.

1301```1308```

1302 1309

1303Die erste Form erscheint auf macOS und die zweite überall sonst. Ein vorübergehender Anmeldedaten-Speicher-Fehler, z. B. ein Timeout oder ein unlesbarer Speicher, erzeugt die gleiche Meldung.1310Die erste Form erscheint unter macOS, die zweite überall sonst. Ein vorübergehender Fehler des Anmeldedatenspeichers, etwa eine Zeitüberschreitung oder ein nicht lesbarer Speicher, erzeugt dieselbe Meldung.

1304 1311

1305**Was zu tun ist:**1312**Was Sie tun können:**

1306 1313

1307* Auf macOS entsperren Sie den Anmeldungs-Schlüsselbund, dann führen Sie `/login` erneut aus1314* Entsperren Sie unter macOS den Anmeldeschlüsselbund und führen Sie dann `/login` erneut aus

1308* Auf anderen Plattformen führen Sie `/login` erneut aus1315* Führen Sie auf anderen Plattformen `/login` erneut aus

1309* Wenn die Anmeldung immer noch nicht gespeichert wird, siehe [Nicht angemeldet oder Token abgelaufen](/docs/de/troubleshoot-install#not-logged-in-or-token-expired) für den Schlüsselbund-Entsperr-Befehl und andere Wiederherstellungsschritte für die Anmeldedaten-Verwaltung1316* Wenn die Anmeldung weiterhin nicht gespeichert wird, finden Sie unter [Nicht angemeldet oder Token abgelaufen](/docs/de/troubleshoot-install#not-logged-in-or-token-expired) den Befehl zum Entsperren des Schlüsselbunds und weitere Schritte zur Wiederherstellung des Anmeldedatenspeichers

1310 1317

1311<h3 id="failed-to-start-oauth-callback-server">1318<h3 id="failed-to-start-oauth-callback-server">

1312 OAuth-Callback-Server konnte nicht gestartet werden1319 OAuth-Callback-Server konnte nicht gestartet werden

1313</h3>1320</h3>

1314 1321

1315Wenn `/login`, `claude auth login` oder `claude setup-token` Sie durch den Browser anmeldet, öffnet Claude Code einen Listening-Port auf `127.0.0.1`, damit Ihr Browser das Anmeldeergebnis dorthin zurückgeben kann. Diese Meldung bedeutet, dass Claude Code diesen Port nicht öffnen konnte, und die Anmeldung stoppt, bevor ein Browser-Fenster oder eine Anmelde-URL erscheint:1322Wenn `/login`, `claude auth login` oder `claude setup-token` Sie über den Browser anmeldet, öffnet Claude Code einen Port auf `127.0.0.1`, damit Ihr Browser das Anmeldeergebnis an Claude Code zurückgeben kann. Diese Meldung bedeutet, dass Claude Code diesen Port nicht öffnen konnte, und die Anmeldung stoppt, bevor ein Browserfenster oder eine Anmelde-URL erscheint:

1316 1323

1317```text theme={null}1324```text theme={null}

1318Failed to start OAuth callback server: Failed to start server. Is port 0 in use?1325Failed to start OAuth callback server: Failed to start server. Is port 0 in use?

1319```1326```

1320 1327

1321Wenn Ihre Meldung mit `Is port 0 in use?` endet, ist der Versuch, auf der IPv4-Loopback-Adresse `127.0.0.1` zu lauschen, sofort fehlgeschlagen. Weil der Fehler passiert, bevor eine Anmelde-URL existiert, ist der `Paste code here if prompted`-Fluss nicht als Workaround verfügbar.1328Wenn Ihre Meldung mit `Is port 0 in use?` endet, ist der Versuch, auf der IPv4-Loopback-Adresse `127.0.0.1` zu lauschen, vollständig fehlgeschlagen. Da der Fehler auftritt, bevor eine Anmelde-URL existiert, steht der Ablauf `Paste code here if prompted` als Umgehung nicht zur Verfügung.

1322 1329

1323**Was zu tun ist:**1330**Was Sie tun können:**

1324 1331

1325* Um sich sofort ohne den lokalen Listener anzumelden: Wenn Sie ein claude.ai-Abonnement verwenden, führen Sie [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) auf einer Maschine aus, wo die Anmeldung funktioniert, und setzen Sie den Token, den es ausgibt, als `CLAUDE_CODE_OAUTH_TOKEN` auf dieser Maschine. Andernfalls setzen Sie `ANTHROPIC_API_KEY` auf einen Schlüssel aus der [Claude Console](https://platform.claude.com/settings/keys). [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence) erklärt, wie Claude Code zwischen Anmeldedaten wählt.1332* Um sich sofort ohne den lokalen Listener anzumelden: Wenn Sie ein claude.ai-Abonnement verwenden, führen Sie [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) auf einem Rechner aus, auf dem die Anmeldung funktioniert, und setzen Sie das ausgegebene Token auf diesem Rechner als `CLAUDE_CODE_OAUTH_TOKEN`. Andernfalls setzen Sie `ANTHROPIC_API_KEY` auf einen Schlüssel aus der [Claude Console](https://platform.claude.com/settings/keys). [Rangfolge der Authentifizierung](/docs/de/authentication#authentication-precedence) erklärt, wie Claude Code zwischen Anmeldedaten wählt.

1326* Um stattdessen Browser-Anmeldung auf dieser Maschine zu verwenden, muss Claude Code auf `127.0.0.1` lauschen können. Wenn es in einer Sandbox läuft, überprüfen Sie, dass die Sandbox-Richtlinie das Lauschen auf lokalen Ports erlaubt, dann führen Sie `/login` erneut aus. Wenn es sollte und immer noch fehlschlägt, führen Sie `/feedback` aus, damit der Bericht Ihre Umgebungsdetails enthält.1333* Um stattdessen auf diesem Rechner die Anmeldung über den Browser zu verwenden, muss Claude Code auf `127.0.0.1` lauschen können. Wenn es in einer Sandbox läuft, prüfen Sie, ob die Richtlinie der Sandbox das Lauschen auf lokalen Ports erlaubt, und führen Sie dann `/login` erneut aus. Wenn es lauschen können sollte und trotzdem fehlschlägt, führen Sie `/feedback` aus, damit der Bericht Ihre Umgebungsdetails enthält.

1327 1334

1328<h3 id="claude-login-not-accepted">1335<h3 id="claude-login-not-accepted">

1329 Claude-Anmeldung nicht akzeptiert1336 Claude-Anmeldung nicht akzeptiert

1330</h3>1337</h3>

1331 1338

1332Sie versuchten, eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) zu starten, und der Server weigerte sich, sie mit einem 401 zu erstellen: er akzeptierte die Claude-Anmeldung, die diese Maschine gesendet hat, nicht, normalerweise weil die Anmeldung abgelaufen oder widerrufen wurde.1339Sie haben versucht, eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) zu starten, und der Server hat die Erstellung mit einem 401 verweigert: Er hat die Claude-Anmeldung, die dieser Rechner gesendet hat, nicht akzeptiert, meist weil die Anmeldung abgelaufen ist oder widerrufen wurde.

1333 1340

1334Der erste Teil der Zeile ist der eigene Grund des Servers, wenn er einen gibt. Andernfalls lautet die Zeile:1341Der erste Teil der Zeile ist der eigene Grund des Servers, sofern er einen angibt. Andernfalls lautet die Zeile:

1335 1342

1336```text theme={null}1343```text theme={null}

1337Claude login not accepted · Run /login, then try again1344Claude login not accepted · Run /login, then try again

1338```1345```

1339 1346

1340**Was zu tun ist:**1347**Was Sie tun können:**

1341 1348

1342* Führen Sie `/login` aus, schließen Sie die Anmeldung ab, dann starten Sie die Sitzung erneut1349* Führen Sie `/login` aus, schließen Sie die Anmeldung ab und starten Sie die Sitzung dann erneut

1343 1350

1344<h3 id="artifacts-need-a-claude-ai-login">1351<h3 id="artifacts-need-a-claude-ai-login">

1345 Artefakte benötigen eine claude.ai-Anmeldung1352 Artefakte erfordern eine claude.ai-Anmeldung

1346</h3>1353</h3>

1347 1354

1348Claude Code weigerte sich, ein [Artefakt](/docs/de/artifacts) zu veröffentlichen oder zu lesen, weil die Sitzung keine claude.ai-Anmeldung hat, die sie für Artefakte verwenden kann.1355Claude Code hat das Veröffentlichen oder Lesen eines [Artefakts](/docs/de/artifacts) verweigert, weil die Sitzung keine claude.ai-Anmeldung hat, die sie für Artefakte verwenden kann.

1349 1356

1350Jede Form der Meldung beginnt mit den gleichen Worten, gefolgt von einem Mittel, das davon abhängt, wie sich Ihre Sitzung authentifiziert. Ohne konkurrierende Anmeldedaten lautet sie:1357Jede Form der Meldung beginnt mit denselben Worten, gefolgt von einer Abhilfe, die davon abhängt, wie sich Ihre Sitzung authentifiziert. Ohne konkurrierende Anmeldedaten lautet sie:

1351 1358

1352```text theme={null}1359```text theme={null}

1353Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.1360Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.

1354```1361```

1355 1362

1356**Was zu tun ist:**1363**Was Sie tun können:**

1357 1364

1358* Führen Sie `/login` aus und wählen Sie **Claude account with subscription**. Die Option **Anthropic Console account** bietet keine claude.ai-Anmeldedaten.1365* Führen Sie `/login` aus und wählen Sie **Claude account with subscription**. Die Option **Anthropic Console account** stellt keine claude.ai-Anmeldedaten bereit.

1359* Wenn die Meldung eine Anmeldedaten benennt, die Vorrang hat, z. B. `ANTHROPIC_API_KEY`, eine `apiKeyHelper`-Einstellung oder einen Console-Schlüssel, der von einem vorherigen `/login` gespeichert wurde, entfernen Sie ihn wie die Meldung sagt, dann führen Sie `/login` aus1366* Wenn die Meldung Anmeldedaten nennt, die Vorrang haben, etwa `ANTHROPIC_API_KEY`, eine `apiKeyHelper`-Einstellung oder einen durch ein früheres `/login` gespeicherten Console-Schlüssel, entfernen Sie diese wie in der Meldung beschrieben und führen Sie dann `/login` aus

1360* Wenn die Meldung sagt, dass sich diese Remote-Sitzung durch die Maschine authentifiziert, die sie gestartet hat, melden Sie sich auf dieser Maschine bei claude.ai an, dann verbinden Sie die Sitzung erneut1367* Wenn die Meldung besagt, dass sich diese Remote-Sitzung über den Rechner authentifiziert, der sie gestartet hat, melden Sie sich auf diesem Rechner bei claude.ai an und verbinden Sie die Sitzung dann erneut

1361* Wenn die Meldung sagt, dass die Anmeldedaten von der Sitzungs-Host-Umgebung injiziert werden, können Sie sie in dieser Sitzung nicht ändern; starten Sie eine Sitzung, die bei claude.ai angemeldet ist1368* Wenn die Meldung besagt, dass die Anmeldedaten von der Host-Umgebung der Sitzung bereitgestellt werden, können Sie sie in dieser Sitzung nicht ändern; starten Sie eine Sitzung, die bei claude.ai angemeldet ist

1362* Siehe [Verfügbarkeit](/docs/de/artifacts#availability) für die anderen Anforderungen, die Artefakte haben, z. B. Plan, Modell-Provider und Organisations-Richtlinie1369* Unter [Verfügbarkeit](/docs/de/artifacts#availability) finden Sie die weiteren Voraussetzungen für Artefakte, etwa Plan, Modellanbieter und Organisationsrichtlinie

1363 1370

1364<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1371<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">

1365 Administrator-Richtlinie erfordert eine Cloud-Gateway-Anmeldung1372 Administratorrichtlinie erfordert eine Cloud-Gateway-Anmeldung

1366</h3>1373</h3>

1367 1374

1368Die [verwalteten Einstellungen](/docs/de/managed-settings) eines Administrators auf dieser Maschine setzen [`forceLoginMethod`](/docs/de/settings-reference#forceloginmethod) auf `"gateway"` oder setzen [`forceLoginGatewayUrl`](/docs/de/settings-reference#forcelogingatewayurl). Sofern Sie keinen Cloud-Provider durch eine Variable wie `CLAUDE_CODE_USE_BEDROCK` auswählen, akzeptiert Claude Code dann nur die [Claude apps gateway](/docs/de/claude-apps-gateway)-Anmeldung. Sie sehen eine von zwei Meldungen:1375Die [verwalteten Einstellungen](/docs/de/managed-settings) eines Administrators auf diesem Rechner setzen [`forceLoginMethod`](/docs/de/settings-reference#forceloginmethod) auf `"gateway"` oder setzen [`forceLoginGatewayUrl`](/docs/de/settings-reference#forcelogingatewayurl). Sofern Sie nicht über eine Variable wie `CLAUDE_CODE_USE_BEDROCK` einen Cloud-Anbieter auswählen, akzeptiert Claude Code dann nur die Anmeldung über das [Claude Apps Gateway](/docs/de/claude-apps-gateway). Sie sehen eine von zwei Meldungen:

1369 1376

1370```text theme={null}1377```text theme={null}

1371Not signed in to the Cloud gateway — run /login.1378Not signed in to the Cloud gateway — run /login.

1372```1379```

1373 1380

1374Modellanfragen schlagen mit dieser Meldung fehl, wenn die Sitzung keine Gateway-Anmeldung hat, z. B. weil Sie `/login` nicht seit der Ankunft der Richtlinie auf der Maschine ausgeführt haben.1381Modellanfragen schlagen mit dieser Meldung fehl, wenn die Sitzung keine Gateway-Anmeldung hat, zum Beispiel weil Sie `/login` nicht ausgeführt haben, seit die Richtlinie den Rechner erreicht hat.

1375 1382

1376Wenn die Maschine auch eine von Anthropic ausgegebene Anmeldedaten hält und die verwalteten Einstellungen `forceLoginMethod` oder `forceLoginOrgUUID` setzen, beendet Claude Code stattdessen beim Start. Diese Anmeldedaten kann eine `ANTHROPIC_API_KEY`- oder `ANTHROPIC_AUTH_TOKEN`-Variable, eine `apiKeyHelper`-Einstellung oder ein API-Schlüssel sein, der von einer früheren Claude Console-Anmeldung gespeichert wurde. Die Meldung beginnt:1383Wenn der Rechner außerdem von Anthropic ausgestellte Anmeldedaten enthält und die verwalteten Einstellungen `forceLoginMethod` oder `forceLoginOrgUUID` setzen, wird Claude Code stattdessen beim Start beendet. Diese Anmeldedaten können eine Variable `ANTHROPIC_API_KEY` oder `ANTHROPIC_AUTH_TOKEN`, eine `apiKeyHelper`-Einstellung oder ein API-Schlüssel sein, der durch eine frühere Anmeldung über die Claude Console gespeichert wurde. Die Meldung beginnt mit:

1377 1384

1378```text theme={null}1385```text theme={null}

1379Administrator policy requires a Cloud gateway sign-in on this machine; the1386Administrator policy requires a Cloud gateway sign-in on this machine; the

1381ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.1388ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.

1382```1389```

1383 1390

1384**Was zu tun ist:**1391**Was Sie tun können:**

1385 1392

1386* Führen Sie `/login` aus und schließen Sie die Anmeldung auf dem **Cloud gateway**-Bildschirm ab1393* Führen Sie `/login` aus und schließen Sie die Anmeldung auf dem Bildschirm **Cloud gateway** ab

1387* Für die Startup-Meldung entfernen Sie die `ANTHROPIC_API_KEY`-, `ANTHROPIC_AUTH_TOKEN`- oder `apiKeyHelper`-Einstellung, die Sie konfiguriert haben. Um einen gespeicherten Console-API-Schlüssel zu entfernen, führen Sie `claude auth logout` aus, das auch eine gespeicherte claude.ai-Anmeldung entfernt. Wenn Sie einen Cloud-Provider mit `CLAUDE_CODE_USE_*` auswählen, startet die Sitzung dann ohne Anmeldung. Andernfalls starten Sie `claude` und führen Sie `/login` aus1394* Bei der Startmeldung entfernen Sie die von Ihnen konfigurierte Einstellung `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper`. Um einen gespeicherten Console-API-Schlüssel zu entfernen, führen Sie `claude auth logout` aus, wodurch auch eine gespeicherte claude.ai-Anmeldung entfernt wird. Wenn Sie mit `CLAUDE_CODE_USE_*` einen Cloud-Anbieter auswählen, startet die Sitzung dann ohne Anmeldung. Andernfalls starten Sie `claude` und führen `/login` aus

1388* Wenn Sie glauben, dass die Maschine das Gateway nicht erfordern sollte, bitten Sie den Administrator, der sie verwaltet, `forceLoginMethod` und `forceLoginGatewayUrl` aus ihren verwalteten Einstellungen zu entfernen1395* Wenn Sie der Meinung sind, dass der Rechner das Gateway nicht erfordern sollte, bitten Sie den Administrator, der ihn verwaltet, `forceLoginMethod` und `forceLoginGatewayUrl` aus seinen verwalteten Einstellungen zu entfernen

1389 1396

1390Auf v2.1.265 zeigte eine Regression auch die erste Meldung in einigen LLM-Gateway- und Proxy-Konfigurationen, die sich mit einem API-Schlüssel, `apiKeyHelper` oder benutzerdefinierten Headern authentifizieren, selbst ohne Administrator-Anforderung auf der Maschine. Aktualisieren Sie auf v2.1.266 oder später. Sie müssen Ihre Konfiguration nicht ändern.1397In v2.1.265 hat eine Regression die erste Meldung auch in einigen LLM-Gateway- und Proxy-Konfigurationen angezeigt, die sich mit einem API-Schlüssel, `apiKeyHelper` oder benutzerdefinierten Headern authentifizieren, selbst ohne Administratorvorgabe auf dem Rechner. Aktualisieren Sie auf v2.1.266 oder höher. Sie müssen Ihre Konfiguration nicht ändern.

1391 1398

1392Vor v2.1.261 verwendete Claude Code auf Maschinen, die `forceLoginMethod` auf `"gateway"` setzen, eine verbleibende gespeicherte Anmeldung statt Modellanfragen fehlschlagen zu lassen, und meldete eine konfigurierte Umgebungs-Anmeldedaten mit `This machine's managed settings require a first-party login` statt der Startup-Meldung. Vor v2.1.265 erforderte eine Maschine, deren verwaltete Einstellungen nur `forceLoginGatewayUrl` setzen, nicht die Gateway-Anmeldung, und Claude Code verwendete eine verbleibende Anmeldedaten dort.1399Vor v2.1.261 hat Claude Code auf Rechnern, die `forceLoginMethod` auf `"gateway"` setzen, eine verbliebene gespeicherte Anmeldung verwendet, statt Modellanfragen fehlschlagen zu lassen, und konfigurierte Anmeldedaten aus der Umgebung mit `This machine's managed settings require a first-party login` statt mit der Startmeldung gemeldet. Vor v2.1.265 hat ein Rechner, dessen verwaltete Einstellungen nur `forceLoginGatewayUrl` setzen, die Gateway-Anmeldung nicht erfordert, und Claude Code hat dort verbliebene Anmeldedaten verwendet.

1393 1400

1394<h3 id="your-account-is-on-hold">1401<h3 id="your-account-is-on-hold">

1395 Ihr Konto ist gesperrt1402 Ihr Konto ist gesperrt

1396</h3>1403</h3>

1397 1404

1398Das Claude-Konto hinter Ihrer Anmeldung wurde ausgesetzt. Claude Code zeigt die erste Meldung, wenn es versucht, Ihre gespeicherte Anmeldung zu erneuern und von der Sperrung erfährt, und die zweite, wenn eine Anmeldung, die Sie im Browser abschließen, sie meldet:1405Das Claude-Konto hinter Ihrer Anmeldung wurde gesperrt. Claude Code zeigt die erste Meldung, wenn es versucht, Ihre gespeicherte Anmeldung zu erneuern, und dabei von der Sperre erfährt, und die zweite, wenn eine im Browser abgeschlossene Anmeldung sie meldet:

1399 1406

1400```text theme={null}1407```text theme={null}

1401Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted1408Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted

1402Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted1409Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted

1403```1410```

1404 1411

1405Das erneute Anmelden mit dem gleichen Konto löscht die Meldung nicht, weil die Sperrung auf dem Konto statt auf der Anmeldung ist. Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`) und dem [Agent SDK](/docs/de/agent-sdk/overview) ist der strukturierte Fehlercode `account_on_hold`. Vor v2.1.235 meldete Claude Code ein gesperrtes Konto als [Anmeldung abgelaufen · Bitte führen Sie /login aus](#login-expired), dessen Wiederherstellungsschritte eine Sperrung nicht löschen können.1412Eine erneute Anmeldung mit demselben Konto beseitigt die Meldung nicht, da die Sperre für das Konto und nicht für die Anmeldung gilt. Im [nicht interaktiven Modus](/docs/de/headless) (`-p`) und im [Agent SDK](/docs/de/agent-sdk/overview) ist der strukturierte Fehlercode `account_on_hold`. Vor v2.1.235 hat Claude Code ein gesperrtes Konto als [Login expired · Please run /login](#login-expired) gemeldet, dessen Schritte zur Behebung eine Sperre nicht aufheben können.

1406 1413

1407**Was zu tun ist:**1414**Was Sie tun können:**

1408 1415

1409* Öffnen Sie den Link in der Meldung, um die Details der Sperrung anzusehen oder dagegen Einspruch zu erheben1416* Öffnen Sie den Link in der Meldung, um die Details der Sperre anzuzeigen oder Einspruch einzulegen

1410* Wenn Sie ein anderes Claude-Konto oder einen API-Schlüssel haben, der von der Sperrung nicht betroffen ist, können Sie weiterarbeiten, während die Sperrung gelöst wird: führen Sie `/login` mit diesem Konto aus, oder setzen Sie den Schlüssel mit `ANTHROPIC_API_KEY`1417* Wenn Sie ein anderes Claude-Konto oder einen API-Schlüssel haben, der nicht von der Sperre betroffen ist, können Sie weiterarbeiten, während die Sperre geklärt wird: Führen Sie `/login` mit diesem Konto aus oder setzen Sie den Schlüssel mit `ANTHROPIC_API_KEY`

1411 1418

1412<h3 id="anthropic-profile-login-expired">1419<h3 id="anthropic-profile-login-expired">

1413 Anthropic-Profil-Anmeldung abgelaufen1420 Anmeldung des Anthropic-Profils abgelaufen

1414</h3>1421</h3>

1415 1422

1416Claude Code authentifiziert sich durch ein Anthropic-Anmeldedaten-Profil, dessen gespeicherte Anmeldungs-Anmeldedaten abgelaufen ist, und das Profil hält keine Aktualisierungs-Anmeldedaten, die Claude Code zum Erneuern verwenden kann. Claude Code stoppt jede Anfrage lokal ohne Wiederholung, weil eine Wiederholung die gleiche abgelaufene Anmeldedaten lesen würde.1423Claude Code authentifiziert sich über ein Anthropic-Anmeldedatenprofil, dessen gespeicherte Anmeldedaten abgelaufen sind, und das Profil enthält keine Refresh-Anmeldedaten, mit denen Claude Code sie erneuern könnte. Claude Code stoppt jede Anfrage lokal, ohne sie erneut zu versuchen, da ein erneuter Versuch dieselben abgelaufenen Anmeldedaten lesen würde.

1417 1424

1418```text theme={null}1425```text theme={null}

1419Anthropic profile login expired · Re-authenticate your Anthropic profile1426Anthropic profile login expired · Re-authenticate your Anthropic profile

1420Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile1427Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile

1421```1428```

1422 1429

1423Dies erscheint nur, wenn die aktive Anmeldedaten von einem Anthropic-Anmeldedaten-Profil stammt, einem, das Sie mit der Umgebungsvariable `ANTHROPIC_PROFILE` auswählen, das Claude Code als das aktive Profil in Ihrem Anthropic-Konfigurationsverzeichnis entdeckt, oder das Claude Code schrieb, als Sie sich [ohne API-Schlüssel anmeldeten](/docs/de/authentication#sign-in-without-an-api-key). Sitzungen, die sich mit einem API-Schlüssel, einem Bearer-Token wie `ANTHROPIC_AUTH_TOKEN` oder einem Drittanbieter-Provider authentifizieren, sehen diese Meldung nie.1430Dies erscheint nur, wenn die aktiven Anmeldedaten aus einem Anthropic-Anmeldedatenprofil stammen, das Sie mit der Umgebungsvariable `ANTHROPIC_PROFILE` auswählen, das Claude Code als aktives Profil in Ihrem Anthropic-Konfigurationsverzeichnis erkennt oder das Claude Code geschrieben hat, als Sie sich [ohne API-Schlüssel angemeldet](/docs/de/authentication#sign-in-without-an-api-key) haben. Sitzungen, die sich mit einem API-Schlüssel, einem Bearer-Token wie `ANTHROPIC_AUTH_TOKEN` oder einem Drittanbieter authentifizieren, sehen diese Meldung nie.

1424 1431

1425Auf einer Maschine, die [die schlüssellose Anmeldung anbietet](/docs/de/authentication#sign-in-without-an-api-key), führen Sie `/login` aus, wählen Sie das Anthropic Console-Konto, und melden Sie sich erneut an, um ein Profil zu erneuern, das die schlüssellose Console-Anmeldung oder die Claude Platform CLI's `ant auth login` schrieb. Claude Code ersetzt die abgelaufene Anmeldedaten in diesem Profil. Für ein Verbund-Profil oder eines, das ein anderes Tool erstellt hat, erneuert `/login` die Anmeldedaten nicht. Welche Form Sie sehen, hängt davon ab, ob Sie das Profil ausgewählt haben oder Claude Code es entdeckt hat:1432Auf einem Rechner, der [die schlüssellose Anmeldung anbietet](/docs/de/authentication#sign-in-without-an-api-key), führen Sie `/login` aus, wählen das Anthropic Console-Konto und melden sich erneut an, um ein Profil zu erneuern, das die schlüssellose Console-Anmeldung oder `ant auth login` der Claude Platform CLI geschrieben hat. Claude Code ersetzt die abgelaufenen Anmeldedaten in diesem Profil. Bei einem Federation-Profil oder einem Profil, das ein anderes Tool erstellt hat, erneuert `/login` die Anmeldedaten nicht. Welche Form Sie sehen, hängt davon ab, ob Sie das Profil ausgewählt haben oder Claude Code es erkannt hat:

1426 1433

1427* Wenn Sie `ANTHROPIC_PROFILE` explizit setzen, endet die Meldung mit `Re-authenticate your Anthropic profile`.1434* Wenn Sie `ANTHROPIC_PROFILE` explizit setzen, endet die Meldung mit `Re-authenticate your Anthropic profile`.

1428* Wenn Claude Code das Profil aus Ihrem Konfigurationsverzeichnis entdeckt hat, bietet die Meldung `/login` an, weil Claude Code einer funktionierenden `/login` Vorrang vor dem entdeckten Profil gibt und sich dann stattdessen mit Ihrem claude.ai- oder Console-Konto authentifiziert. Vor v2.1.234 zeigte Claude Code in diesem Fall auch die `Re-authenticate your Anthropic profile`-Form.1435* Wenn Claude Code das Profil aus Ihrem Konfigurationsverzeichnis erkannt hat, bietet die Meldung `/login` an, da Claude Code einem funktionierenden `/login` Vorrang vor dem erkannten Profil gibt und sich dann stattdessen mit Ihrem claude.ai- oder Console-Konto authentifiziert. Vor v2.1.234 zeigte Claude Code auch in diesem Fall die Form `Re-authenticate your Anthropic profile`.

1429 1436

1430**Was zu tun ist:**1437**Was Sie tun können:**

1431 1438

1432* Melden Sie sich erneut bei dem Profil an, dann versuchen Sie es erneut: auf einer Maschine, die [die schlüssellose Anmeldung anbietet](/docs/de/authentication#sign-in-without-an-api-key), führen Sie `/login` aus und wählen Sie das Anthropic Console-Konto für ein Profil, das die schlüssellose Console-Anmeldung oder die Claude Platform CLI's `ant auth login` schrieb; für andere Profile verwenden Sie das Tool, das sie erstellt hat1439* Melden Sie sich erneut beim Profil an und versuchen Sie es dann erneut: Auf einem Rechner, der [die schlüssellose Anmeldung anbietet](/docs/de/authentication#sign-in-without-an-api-key), führen Sie `/login` aus und wählen das Anthropic Console-Konto für ein Profil, das die schlüssellose Console-Anmeldung oder `ant auth login` der Claude Platform CLI geschrieben hat; für andere Profile verwenden Sie das Tool, das sie erstellt hat

1433* Wenn ein Administrator das Profil-Anmeldedaten bereitgestellt hat, bitten Sie ihn, ein neues auszugeben1440* Wenn ein Administrator die Anmeldedaten des Profils bereitgestellt hat, bitten Sie ihn, neue auszustellen

1434* Führen Sie `/status` aus, um die aktive Anmeldedatenquelle und den Profilnamen zu bestätigen1441* Führen Sie `/status` aus, um die aktive Quelle für Anmeldedaten und den Profilnamen zu prüfen

1435* Um die Verwendung des Profils zu beenden, heben Sie `ANTHROPIC_PROFILE` auf, wenn Sie es setzen, dann authentifizieren Sie sich auf andere Weise, z. B. `/login` oder `ANTHROPIC_API_KEY`1442* Um das Profil nicht mehr zu verwenden, heben Sie `ANTHROPIC_PROFILE` auf, falls Sie es gesetzt haben, und authentifizieren Sie sich dann auf andere Weise, etwa mit `/login` oder `ANTHROPIC_API_KEY`

1436 1443

1437<h3 id="oauth-scope-requirement">1444<h3 id="oauth-scope-requirement">

1438 OAuth-Bereichs-Anforderung1445 OAuth-Scope-Anforderung

1439</h3>1446</h3>

1440 1447

1441Das gespeicherte Token stammt aus einer Zeit vor einem Berechtigungs-Bereich, den ein neueres Feature benötigt:1448Das gespeicherte Token ist älter als ein Berechtigungs-Scope, den eine neuere Funktion benötigt:

1442 1449

1443```text theme={null}1450```text theme={null}

1444OAuth token does not meet scope requirement: user:profile1451OAuth token does not meet scope requirement: user:profile

1445```1452```

1446 1453

1447**Was zu tun ist:**1454**Was Sie tun können:**

1448 1455

1449* Führen Sie `/login` aus, um einen neuen Token mit den aktuellen Bereichen zu erhalten. Sie müssen sich nicht zuerst abmelden.1456* Führen Sie `/login` aus, um ein neues Token mit den aktuellen Scopes zu erhalten. Sie müssen sich vorher nicht abmelden.

1450 1457

1451<h3 id="claude-ai-rejected-the-session-token">1458<h3 id="claude-ai-rejected-the-session-token">

1452 claude.ai lehnte den Sitzungs-Token ab1459 claude.ai hat das Sitzungs-Token abgelehnt

1453</h3>1460</h3>

1454 1461

1455Eine [claude.ai-Connector](/docs/de/mcp#use-mcp-servers-from-claude-ai)-Anfrage schlägt fehl, weil claude.ai den Token von Ihrer Claude Code-Anmeldung ablehnt. Der abgelehnte Token ist Ihre Anmeldung, nicht die eigene Autorisierung des Connectors in claude.ai, sodass das erneute Autorisieren des Connectors es nicht behebt. In `/mcp` zeigt der Connector `session token rejected` an, und seine Detailansicht liest:1462Eine Anfrage eines [claude.ai-Konnektors](/docs/de/mcp#use-mcp-servers-from-claude-ai) ist fehlgeschlagen, weil claude.ai das Token aus Ihrer Claude Code-Anmeldung abgelehnt hat. Das abgelehnte Token ist Ihre Anmeldung, nicht die eigene Autorisierung des Konnektors in claude.ai, daher behebt eine erneute Autorisierung des Konnektors das Problem nicht. In `/mcp` wird der Konnektor als `session token rejected` angezeigt, und seine Detailansicht lautet:

1456 1463

1457```text theme={null}1464```text theme={null}

1458claude.ai rejected the session token. Run /login, then reconnect.1465claude.ai rejected the session token. Run /login, then reconnect.

1459```1466```

1460 1467

1461**Was zu tun ist:**1468**Was Sie tun können:**

1462 1469

1463* Führen Sie `/login` aus, um sich erneut anzumelden1470* Führen Sie `/login` aus, um sich erneut anzumelden

1464* Verbinden Sie den Connector von `/mcp` erneut, oder führen Sie `/mcp reconnect <server>` aus. Das erneute Verbinden, bevor Sie sich erneut anmelden, lässt den Connector im gleichen Zustand. Die **Reconnect**-Option des `/mcp`-Panels meldet `your claude.ai session token was rejected`; die eingegebene `/mcp reconnect <server>`-Form meldet eine erfolgreiche Wiederverbindung, obwohl der Token immer noch abgelehnt wird.1471* Verbinden Sie den Konnektor über `/mcp` erneut oder führen Sie `/mcp reconnect <server>` aus. Eine erneute Verbindung vor der erneuten Anmeldung lässt den Konnektor im selben Zustand. Die Option **Reconnect** im `/mcp`-Panel meldet `your claude.ai session token was rejected`; die eingetippte Form `/mcp reconnect <server>` meldet eine erfolgreiche Wiederverbindung, obwohl das Token weiterhin abgelehnt wird.

1465 1472

1466Vor v2.1.222 markierte Claude Code den Connector als Authentifizierung benötigend statt, was Sie auf den Authentifizierungs-Fluss des Connectors hinwies, obwohl das Abschließen ihn nicht behebt.1473Vor v2.1.222 hat Claude Code den Konnektor stattdessen als authentifizierungsbedürftig markiert, was Sie zum Autorisierungsablauf des Konnektors geführt hat, obwohl dessen Abschluss den Zustand nicht behoben hat.

1467 1474

1468<h3 id="mcp-server-needs-you-to-sign-in-again">1475<h3 id="mcp-server-needs-you-to-sign-in-again">

1469 MCP-Server benötigt Sie, um sich erneut anzumelden1476 MCP-Server erfordert eine erneute Anmeldung

1470</h3>1477</h3>

1471 1478

1472Ein Remote-[MCP-Server](/docs/de/mcp) lehnte die Anmeldedaten bei einem Tool-Aufruf während der Sitzung ab, normalerweise weil eine Anmeldung oder ein Token abgelaufen ist oder weil der Token eine Berechtigung fehlt, die das Tool benötigt. Der Tool-Aufruf schlägt fehl, und `/mcp` markiert den Server als [Authentifizierung benötigend](/docs/de/mcp#authenticate-with-remote-mcp-servers).1479Ein Remote-[MCP-Server](/docs/de/mcp) hat die Anmeldedaten bei einem Tool-Aufruf während der Sitzung abgelehnt, meist weil eine Anmeldung oder ein Token abgelaufen ist oder weil dem Token eine Berechtigung fehlt, die das Tool benötigt. Der Tool-Aufruf schlägt fehl, und `/mcp` markiert den Server als [authentifizierungsbedürftig](/docs/de/mcp#authenticate-with-remote-mcp-servers).

1473 1480

1474Für einen Server, bei dem Sie sich von Claude Code aus anmelden, einschließlich eines claude.ai-Connectors, ist die Anmeldung abgelaufen oder wurde widerrufen:1481Bei einem Server, bei dem Sie sich über Claude Code anmelden, einschließlich eines claude.ai-Konnektors, ist die Anmeldung abgelaufen oder wurde widerrufen:

1475 1482

1476```text theme={null}1483```text theme={null}

1477MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)1484MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)

1478```1485```

1479 1486

1480Führen Sie `/mcp` aus, wählen Sie den Server, und melden Sie sich erneut von seinem Menü an.1487Führen Sie `/mcp` aus, wählen Sie den Server aus und melden Sie sich über sein Menü erneut an.

1481 1488

1482Für einen Server, der mit einem [`headersHelper`](/docs/de/mcp#use-dynamic-headers-for-custom-authentication)-Skript konfiguriert ist, hat Claude Code das Helper bereits erneut ausgeführt und den Aufruf einmal erneut versucht, bevor dies angezeigt wird:1489Bei einem Server, der mit einem [`headersHelper`](/docs/de/mcp#use-dynamic-headers-for-custom-authentication)-Skript konfiguriert ist, hat Claude Code den Helper bereits erneut ausgeführt und den Aufruf einmal wiederholt, bevor diese Meldung angezeigt wird:

1483 1490

1484```text theme={null}1491```text theme={null}

1485MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)1492MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)

1486```1493```

1487 1494

1488Überprüfen Sie, dass der Helper eine Anmeldedaten zurückgibt, die der Server akzeptiert, dann verbinden Sie von `/mcp` erneut, das den Helper erneut ausführt.1495Prüfen Sie, ob der Helper Anmeldedaten zurückgibt, die der Server akzeptiert, und verbinden Sie sich dann über `/mcp` erneut, wodurch der Helper erneut ausgeführt wird.

1489 1496

1490Für einen Server mit einem statischen `Authorization`-Header in seiner Konfiguration:1497Bei einem Server mit einem statischen `Authorization`-Header in seiner Konfiguration:

1491 1498

1492```text theme={null}1499```text theme={null}

1493MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)1500MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)

1494```1501```

1495 1502

1496Aktualisieren Sie den Header-Wert, wo der Server konfiguriert ist, dann verbinden Sie von `/mcp` erneut.1503Aktualisieren Sie den Header-Wert dort, wo der Server konfiguriert ist, und verbinden Sie sich dann über `/mcp` erneut.

1497 1504

1498Vor v2.1.273 zeigten die abgelaufene Anmeldung, `headersHelper` und `Authorization`-Header-Fälle alle `MCP server "<name>" requires re-authorization (token expired)`.1505Vor v2.1.273 zeigten die Fälle mit abgelaufener Anmeldung, `headersHelper` und `Authorization`-Header alle `MCP server "<name>" requires re-authorization (token expired)` an.

1499 1506

1500Ein Server kann auch einen Tool-Aufruf mit HTTP 403 `insufficient_scope` ablehnen, um Sie aufzufordern, einen Bereich zu autorisieren, manchmal einen, den Ihr Token bereits auflistet. Die Meldung benennt diesen Bereich:1507Ein Server kann einen Tool-Aufruf auch mit HTTP 403 `insufficient_scope` ablehnen, um Sie aufzufordern, einen Scope zu autorisieren, manchmal einen, den Ihr Token bereits enthält. Die Meldung nennt diesen Scope:

1501 1508

1502```text theme={null}1509```text theme={null}

1503MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate1510MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate

1504```1511```

1505 1512

1506Führen Sie `/mcp` aus, wählen Sie den Server, und authentifizieren Sie sich erneut von seinem Menü.1513Führen Sie `/mcp` aus, wählen Sie den Server aus und authentifizieren Sie sich über sein Menü erneut.

1507 1514

1508Wenn die Konfiguration des Servers weder [`oauth.scopes`](/docs/de/mcp#restrict-oauth-scopes) noch [`authServerMetadataUrl`](/docs/de/mcp#override-oauth-metadata-discovery) setzt, fordert Claude Code den Bereich an, den der Server benannt hat. Mit einer der beiden Einstellungen fordert Claude Code stattdessen die Bereiche dieser Einstellung an. Wenn Sie `oauth.scopes` angeheftet haben, fügen Sie den fehlenden Bereich zu dieser Liste hinzu, bevor Sie sich erneut authentifizieren.1515Wenn die Konfiguration des Servers weder [`oauth.scopes`](/docs/de/mcp#restrict-oauth-scopes) noch [`authServerMetadataUrl`](/docs/de/mcp#override-oauth-metadata-discovery) setzt, fordert Claude Code den Scope an, den der Server genannt hat. Ist eine dieser Einstellungen gesetzt, fordert Claude Code stattdessen die Scopes dieser Einstellung an. Wenn Sie `oauth.scopes` festgelegt haben, fügen Sie den fehlenden Scope zu dieser Liste hinzu, bevor Sie sich erneut authentifizieren.

1509 1516

1510Vor v2.1.274 zeigte dieser Fall die `needs you to sign in again`-Meldung, und vor v2.1.273 zeigte er `requires re-authorization (token expired)` wie die anderen Fälle.1517Vor v2.1.274 zeigte dieser Fall die Meldung `needs you to sign in again` an, und vor v2.1.273 zeigte er wie die anderen Fälle `requires re-authorization (token expired)` an.

1511 1518

1512<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">1519<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">

1513 MCP-Server-URL fehlt oder ist keine gültige URL1520 MCP-Server-URL fehlt oder ist keine gültige URL

1514</h3>1521</h3>

1515 1522

1516Claude Code weigerte sich, eine OAuth-Anmeldung für einen Remote-MCP-Server zu starten, weil die konfigurierte `url` des Servers nicht als URL analysiert wird. Sofern Claude Code kein spezifischeres Konfigurationsproblem für den Server zu melden hat, gibt das Ausführen von [`claude mcp login <name>`](/docs/de/mcp#authenticate-from-the-command-line) in Ihrer Shell die Ablehnung aus als:1523Claude Code hat es abgelehnt, eine OAuth-Anmeldung für einen Remote-MCP-Server zu starten, weil die konfigurierte `url` des Servers nicht als URL geparst werden kann. Sofern Claude Code für den Server kein spezifischeres Konfigurationsproblem zu melden hat, gibt [`claude mcp login <name>`](/docs/de/mcp#authenticate-from-the-command-line) in Ihrer Shell die Ablehnung wie folgt aus:

1517 1524

1518```text theme={null}1525```text theme={null}

1519Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.1526Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.

1520```1527```

1521 1528

1522**Was zu tun ist:**1529**Was Sie tun können:**

1523 1530

1524* Setzen Sie den Eintrag's `url` auf den echten Endpunkt des Servers, wo der Server konfiguriert ist, oder setzen Sie die Umgebungsvariable, die sein [`${VAR}`-Verweis](/docs/de/mcp#environment-variable-expansion-in-mcp-json) benennt, dann führen Sie die Anmeldung erneut aus.1531* Setzen Sie die `url` des Eintrags dort, wo der Server konfiguriert ist, auf den tatsächlichen Endpunkt des Servers, oder setzen Sie die Umgebungsvariable, die seine [`${VAR}`-Referenz](/docs/de/mcp#environment-variable-expansion-in-mcp-json) nennt, und führen Sie die Anmeldung dann erneut aus.

1525 1532

1526<h3 id="issuer-mismatch-in-authorization-response">1533<h3 id="issuer-mismatch-in-authorization-response">

1527 Aussteller-Nichtübereinstimmung in Autorisierungs-Antwort1534 Issuer stimmt in der Autorisierungsantwort nicht überein

1528</h3>1535</h3>

1529 1536

1530Während einer [MCP OAuth-Anmeldung](/docs/de/mcp#authenticate-with-remote-mcp-servers) leitete der Autorisierungs-Server zu Claude Code mit einem `iss`-Parameter um, der nicht den Aussteller benennt, den Claude Code von den OAuth-Metadaten des Servers erwartet. Ein falscher Aussteller in diesem Schritt ist, wie ein Autorisierungs-Server-Mix-up-Angriff aussieht, sodass Claude Code die Anmeldung fehlschlägt, statt den Autorisierungs-Code auszutauschen. Claude Code zeigt den Fehler im `/mcp`-Server-Menü nach der Browser-Anmeldung:1537Während einer [MCP-OAuth-Anmeldung](/docs/de/mcp#authenticate-with-remote-mcp-servers) hat der Autorisierungsserver mit einem `iss`-Parameter zu Claude Code zurückgeleitet, der nicht den Issuer nennt, den Claude Code aus den OAuth-Metadaten des Servers erwartet hat. Ein falscher Issuer in diesem Schritt ist das Erscheinungsbild eines Mix-up-Angriffs auf den Autorisierungsserver, daher lässt Claude Code die Anmeldung fehlschlagen, statt den Autorisierungscode einzutauschen. Claude Code zeigt den Fehler nach der Browseranmeldung im Servermenü von `/mcp` an:

1531 1538

1532```text theme={null}1539```text theme={null}

1533Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"1540Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"

1534```1541```

1535 1542

1536`expected` ist der Aussteller aus den OAuth-Metadaten des Servers, und `received` ist der `iss`-Wert, den die Umleitung trug. Eine Anmeldung, deren Umleitung keinen `iss`-Parameter trägt, besteht die Überprüfung, es sei denn, die Metadaten des Servers setzen `authorization_response_iss_parameter_supported`, in welchem Fall Claude Code die Anmeldung fehlschlägt.1543`expected` ist der Issuer aus den OAuth-Metadaten des Servers, und `received` ist der `iss`-Wert, den die Weiterleitung enthielt. Eine Anmeldung, deren Weiterleitung keinen `iss`-Parameter enthält, besteht die Prüfung, es sei denn, die Metadaten des Servers setzen `authorization_response_iss_parameter_supported`; in diesem Fall lässt Claude Code die Anmeldung fehlschlagen.

1537 1544

1538**Was zu tun ist:**1545**Was Sie tun können:**

1539 1546

1540* Versuchen Sie die Anmeldung erneut von `/mcp`1547* Versuchen Sie die Anmeldung über `/mcp` erneut

1541* Wenn der Fehler wiederholt wird, melden Sie ihn dem Server-Betreiber. Die Behebung ist serverseitig: der Autorisierungs-Server muss den gleichen Aussteller im `iss`-Parameter zurückgeben, den er in seinen Metadaten bewirbt1548* Wenn der Fehler erneut auftritt, melden Sie ihn dem Betreiber des Servers. Die Behebung erfolgt serverseitig: Der Autorisierungsserver muss im `iss`-Parameter denselben Issuer zurückgeben, den er in seinen Metadaten angibt

1542* Um eine Verbindung herzustellen, während der Server behoben wird, starten Sie Claude Code mit [`MCP_SDK_GENERATION=v1`](/docs/de/env-vars), dessen [Runtime](/docs/de/mcp#mcp-client-runtimes) diese Überprüfung nicht ausführt. Dies entfernt einen Schutz vor Mix-up-Angriffen, daher bevorzugen Sie die serverseitige Behebung1549* Um eine Verbindung herzustellen, während der Server korrigiert wird, starten Sie Claude Code mit [`MCP_SDK_GENERATION=v1`](/docs/de/env-vars), dessen [Runtime](/docs/de/mcp#mcp-client-runtimes) diese Prüfung nicht durchführt. Dadurch entfällt ein Schutz vor Mix-up-Angriffen, daher ist die serverseitige Behebung vorzuziehen

1543 1550

1544Vor v2.1.232 verwendete Claude Code die v2-Runtime nur in einem schrittweisen Rollout oder wenn Sie `MCP_SDK_GENERATION=v2` setzen.1551Vor v2.1.232 hat Claude Code die v2-Runtime nur im Rahmen eines schrittweisen Rollouts oder dann verwendet, wenn Sie `MCP_SDK_GENERATION=v2` gesetzt haben.

1545 1552

1546<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">1553<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">

1547 Weigern, Anmeldedaten an einen nicht-HTTPS-Token-Endpunkt zu senden1554 Senden von Anmeldedaten an Token-Endpunkt ohne HTTPS verweigert

1548</h3>1555</h3>

1549 1556

1550Auf der [v2-Runtime](/docs/de/mcp#mcp-client-runtimes) sendet Claude Code eine [MCP OAuth](/docs/de/mcp#authenticate-with-remote-mcp-servers)-Token-Anfrage nur an einen Token-Endpunkt, der über HTTPS oder bei `localhost`, `127.0.0.1` oder `::1` bereitgestellt wird. Diese Meldung bedeutet, dass der Token-Endpunkt des Servers keiner von beiden ist, sodass Claude Code gestoppt hat, bevor die Anfrage gesendet wurde. Das passiert nach der Browser-Anmeldung, sodass der Browser-Schritt zuerst erfolgreich ist, und erneut, wenn Claude Code das Token des Servers aktualisiert.1557In der [v2-Runtime](/docs/de/mcp#mcp-client-runtimes) sendet Claude Code eine [MCP-OAuth](/docs/de/mcp#authenticate-with-remote-mcp-servers)-Token-Anfrage nur an einen Token-Endpunkt, der über HTTPS oder unter `localhost`, `127.0.0.1` oder `::1` bereitgestellt wird. Diese Meldung bedeutet, dass der Token-Endpunkt des Servers keines von beidem ist, daher hat Claude Code vor dem Senden der Anfrage gestoppt. Das geschieht nach der Browseranmeldung, sodass der Browserschritt zunächst erfolgreich ist, und erneut jedes Mal, wenn Claude Code das Token des Servers erneuert.

1551 1558

1552In seiner vollständigen Form kommt die Meldung vom MCP SDK und zitiert den Token-Endpunkt, den es ablehnte. Im Debug-Protokoll folgt es `Error during auth completion:` für eine Anmeldung oder `Token refresh failed:` für eine Aktualisierung. In Ihrer Shell gibt `claude mcp login <name>` es nach `Couldn't complete authentication for "<name>":` aus, und in einer Sitzung zeigt `/mcp` es unter dem Server-Menü:1559In ihrer vollständigen Form stammt die Meldung aus dem MCP SDK und zitiert den abgelehnten Token-Endpunkt. Im Debug-Log folgt sie bei einer Anmeldung auf `Error during auth completion:` und bei einer Erneuerung auf `Token refresh failed:`. In Ihrer Shell gibt `claude mcp login <name>` sie nach `Couldn't complete authentication for "<name>":` aus, und in einer Sitzung zeigt `/mcp` sie im Menü des Servers an:

1553 1560

1554```text theme={null}1561```text theme={null}

1555Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).1562Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).

1556```1563```

1557 1564

1558Claude Code behandelt eine Server-URL, die eine Abfrage-Zeichenkette oder ein langes zufälliges Pfad-Segment hat, als möglicherweise geheim. Für einen solchen Server redaktioniert es die Anmeldungs-Fehler, die das MCP SDK auslöst, bevor es sie zeigt oder protokolliert. Dieser Fehler liest sich dann als ein kurzer Name, der sich zwischen Versionen ändern kann, z. B. `io`, gefolgt von `from the MCP SDK for` und der redaktionierten Server-URL. Andere Fehler vom MCP SDK nehmen die gleiche Form dort an. Die redaktionierte Meldung kann dieser Fehler nur sein, wenn der Token-Endpunkt des Servers einfaches `http://` bei einer Adresse außer `localhost`, `127.0.0.1` oder `::1` ist.1565Claude Code behandelt eine Server-URL mit Query-String oder einem langen, zufällig aussehenden Pfadsegment als möglicherweise geheim. Bei einem solchen Server schwärzt es die Anmeldefehler, die das MCP SDK auslöst, bevor es sie anzeigt oder protokolliert. Dieser Fehler erscheint dann als kurzer Name, der sich zwischen Releases ändern kann, etwa `io`, gefolgt von `from the MCP SDK for` und der geschwärzten Server-URL. Andere Fehler aus dem MCP SDK haben dort dieselbe Form. Die geschwärzte Meldung kann nur dann dieser Fehler sein, wenn der Token-Endpunkt des Servers ein einfaches `http://` unter einer anderen Adresse als `localhost`, `127.0.0.1` oder `::1` ist.

1559 1566

1560**Was zu tun ist:**1567**Was Sie tun können:**

1561 1568

1562* Stellen Sie diesen Token-Endpunkt über HTTPS bereit, z. B. durch Platzierung des Servers hinter einem Reverse-Proxy oder Tunnel, der TLS beendet, und Konfiguration des Servers, um die `https://`-Adresse zu bewerben1569* Stellen Sie diesen Token-Endpunkt über HTTPS bereit, zum Beispiel indem Sie den Server hinter einen Reverse-Proxy oder Tunnel stellen, der TLS terminiert, und den Server so konfigurieren, dass er die `https://`-Adresse angibt

1563* Um eine Verbindung herzustellen, ohne den Server zu ändern, starten Sie Claude Code mit [`MCP_SDK_GENERATION=v1`](/docs/de/env-vars), dessen [Runtime](/docs/de/mcp#mcp-client-runtimes) diese Regel nicht anwendet und die Token-Anfrage über einfaches HTTP sendet. Diese Wahl dauert bis zum Beenden und gilt für jeden Server. Die v1-Runtime überspringt auch die [Aussteller-Überprüfung](#issuer-mismatch-in-authorization-response), daher bevorzugen Sie die Bereitstellung des Endpunkts über HTTPS1570* Um eine Verbindung herzustellen, ohne den Server zu ändern, starten Sie Claude Code mit [`MCP_SDK_GENERATION=v1`](/docs/de/env-vars), dessen [Runtime](/docs/de/mcp#mcp-client-runtimes) diese Regel nicht anwendet und die Token-Anfrage über einfaches HTTP sendet. Diese Wahl gilt, bis Sie Claude Code beenden, und betrifft jeden Server. Die v1-Runtime überspringt außerdem die [Issuer-Prüfung](#issuer-mismatch-in-authorization-response), daher ist die Bereitstellung des Endpunkts über HTTPS vorzuziehen

1564 1571

1565<h3 id="aws-credentials-expired-or-invalid">1572<h3 id="aws-credentials-expired-or-invalid">

1566 AWS-Anmeldedaten abgelaufen oder ungültig1573 AWS-Anmeldedaten abgelaufen oder ungültig

1567</h3>1574</h3>

1568 1575

1569Ihr AWS-Sitzungs-Token ist abgelaufen oder wurde abgelehnt. Diese Meldung erscheint bei einem 401 von [Claude Platform on AWS](/docs/de/claude-platform-on-aws) oder dem [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint), wie diese Provider ein abgelaufenes Sicherheits-Token melden.1576Ihr AWS-Sitzungs-Token ist abgelaufen oder wurde abgelehnt. Diese Meldung erscheint bei einem 401 von [Claude Platform on AWS](/docs/de/claude-platform-on-aws) oder dem [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint); auf diese Weise melden diese Anbieter ein abgelaufenes Sicherheits-Token.

1570 1577

1571Der Aktions-Hinweis in der Mitte variiert mit Ihrer Einrichtung. Der stabile Teil ist das führende `AWS credentials expired or invalid`:1578Der Handlungshinweis in der Mitte variiert je nach Ihrer Einrichtung. Der feste Teil ist das vorangestellte `AWS credentials expired or invalid`:

1572 1579

1573```text theme={null}1580```text theme={null}

1574AWS 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 ...1581AWS 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 ...

1576 1583

1577Vor v2.1.273 erschien diese Meldung nur, wenn `awsAuthRefresh` konfiguriert war.1584Vor v2.1.273 erschien diese Meldung nur, wenn `awsAuthRefresh` konfiguriert war.

1578 1585

1579**Was zu tun ist:**1586**Was Sie tun können:**

1580 1587

1581* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator1588* Wenn der Hinweis besagt, dass die Anmeldedaten von dieser Umgebung verwaltet werden, verwaltet die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: Versuchen Sie es erneut oder wenden Sie sich an Ihren Administrator

1582* Wenn [`awsAuthRefresh`](/docs/de/amazon-bedrock#advanced-credential-configuration) gesetzt ist, führen Sie den in der Meldung benannten Befehl aus, z. B. `aws sso login --profile myprofile`, in einem anderen Terminal aus und schließen Sie die Browser-Anmeldung ab, dann versuchen Sie es erneut. Andernfalls aktualisieren Sie die AWS-Anmeldedaten, die Sie selbst verwenden: Ihre SSO-Anmeldung, Zugriffs-Schlüssel, API-Schlüssel oder Proxy-Token1589* Wenn [`awsAuthRefresh`](/docs/de/amazon-bedrock#advanced-credential-configuration) gesetzt ist, führen Sie den in der Meldung genannten Befehl, etwa `aws sso login --profile myprofile`, in einem anderen Terminal aus, schließen Sie die Browseranmeldung ab und versuchen Sie es dann erneut. Andernfalls erneuern Sie die von Ihnen verwendeten AWS-Anmeldedaten selbst: Ihre SSO-Anmeldung, Zugriffsschlüssel, Ihren API-Schlüssel oder Ihr Proxy-Token

1583* Mit `awsAuthRefresh` in einer interaktiven Sitzung können Sie stattdessen `/login` ausführen, **3rd-party platform** wählen, dann **Claude Platform on AWS · refresh credentials** unter **Using 3rd-party platforms** wählen, um den gleichen Befehl auszuführen, ohne Claude Code neu zu starten. Siehe [AWS-Anmeldedaten konfigurieren](/docs/de/claude-platform-on-aws#1-configure-aws-credentials)1590* Wenn `awsAuthRefresh` in einer interaktiven Sitzung gesetzt ist, können Sie stattdessen `/login` ausführen, **3rd-party platform** wählen und dann unter **Using 3rd-party platforms** die Option **Claude Platform on AWS · refresh credentials** auswählen, um denselben Befehl auszuführen, ohne Claude Code neu zu starten. Siehe [AWS-Anmeldedaten konfigurieren](/docs/de/claude-platform-on-aws#1-configure-aws-credentials)

1584* Wenn der Fehler nach dem erfolgreichen Aktualisierungs-Befehl wiederholt wird, bestätigen Sie, dass die Identität außerhalb von Claude Code mit `aws sts get-caller-identity` in der gleichen Shell und dem gleichen Profil gültig ist1591* Wenn der Fehler erneut auftritt, nachdem der Erneuerungsbefehl erfolgreich war, prüfen Sie mit `aws sts get-caller-identity` in derselben Shell und mit demselben Profil, ob die Identität außerhalb von Claude Code gültig ist

1585 1592

1586<h3 id="aws-authentication-failed">1593<h3 id="aws-authentication-failed">

1587 AWS-Authentifizierung fehlgeschlagen1594 AWS-Authentifizierung fehlgeschlagen

1588</h3>1595</h3>

1589 1596

1590Ihr AWS-Provider hat einen 403 zurückgegeben, oder [Amazon Bedrock](/docs/de/amazon-bedrock) hat einen 401 zurückgegeben.1597Ihr AWS-Anbieter hat einen 403 zurückgegeben, oder [Amazon Bedrock](/docs/de/amazon-bedrock) hat einen 401 zurückgegeben.

1591 1598

1592Amazon Bedrock meldet ein abgelaufenes Sicherheits-Token als 403, aber ein 403 ist auch, wie es eine Autorisierungs-Ablehnung meldet, z. B. eine `AccessDeniedException` von einer fehlenden IAM-Berechtigung. Claude Code kann diese beiden Ursachen nicht unterscheiden.1599Amazon Bedrock meldet ein abgelaufenes Sicherheits-Token als 403, aber ein 403 ist auch die Art, wie es eine Autorisierungsverweigerung meldet, etwa eine `AccessDeniedException` aufgrund einer fehlenden IAM-Berechtigung. Claude Code kann diese beiden Ursachen nicht unterscheiden.

1593 1600

1594Ein 401 von Amazon Bedrock landet auch hier statt unter [AWS-Anmeldedaten abgelaufen oder ungültig](#aws-credentials-expired-or-invalid), weil Amazon Bedrock ein abgelaufenes Token nicht als 401 meldet. Ein 401 von diesem Endpunkt kommt normalerweise von etwas anderem im Anfrage-Pfad, z. B. einem Unternehmens-Proxy.1601Ein 401 von Amazon Bedrock landet ebenfalls hier und nicht unter [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 stammt in der Regel von etwas anderem im Anfragepfad, etwa einem Unternehmens-Proxy.

1595 1602

1596Eine Anmeldedaten-Aktualisierung behebt ein abgelaufenes Token und kann die anderen Ursachen nicht beheben, sodass die Meldung beide anbietet:1603Eine Erneuerung der Anmeldedaten behebt ein abgelaufenes Token, kann aber die anderen Ursachen nicht beheben, daher bietet die Meldung beides an:

1597 1604

1598```text theme={null}1605```text theme={null}

1599AWS 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 ...1606AWS 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 ...

1600```1607```

1601 1608

1602Der Aktions-Hinweis in der Mitte variiert mit Ihrer Einrichtung. Der stabile Teil ist das führende `AWS authentication failed`.1609Der Handlungshinweis in der Mitte variiert je nach Ihrer Einrichtung. Der feste Teil ist das vorangestellte `AWS authentication failed`.

1603 1610

1604Wenn der 403 Amazon Bedrock's Antwort ist, dass Sie keinen Zugriff auf das Modell mit der angegebenen Modell-ID haben, sagt der Hinweis stattdessen, dass Sie das Modell für Ihr Konto und Ihre Region in der Amazon Bedrock-Konsole aktivieren.1611Wenn der 403 die Antwort von Amazon Bedrock ist, dass Sie keinen Zugriff auf das Modell mit der angegebenen Modell-ID haben, fordert der Hinweis Sie stattdessen auf, das Modell für Ihr Konto und Ihre Region in der Amazon Bedrock-Konsole zu aktivieren.

1605 1612

1606Vor v2.1.273 erschien diese Meldung nur, wenn `awsAuthRefresh` konfiguriert war.1613Vor v2.1.273 erschien diese Meldung nur, wenn `awsAuthRefresh` konfiguriert war.

1607 1614

1608**Was zu tun ist:**1615**Was Sie tun können:**

1609 1616

1610* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator1617* Wenn der Hinweis besagt, dass die Anmeldedaten von dieser Umgebung verwaltet werden, verwaltet die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: Versuchen Sie es erneut oder wenden Sie sich an Ihren Administrator

1611* Aktualisieren Sie Ihre AWS-Anmeldedaten für den Fall, dass ein abgelaufenes Anmeldedaten die Ursache ist: führen Sie den [`awsAuthRefresh`](/docs/de/amazon-bedrock#advanced-credential-configuration)-Befehl aus, der in der Meldung benannt wird, wenn einer gesetzt ist, oder aktualisieren Sie Ihre SSO-Anmeldung, Zugriffs-Schlüssel, API-Schlüssel oder Proxy-Token selbst1618* Erneuern Sie Ihre AWS-Anmeldedaten für den Fall, dass abgelaufene Anmeldedaten die Ursache sind: Führen Sie den in der Meldung genannten [`awsAuthRefresh`](/docs/de/amazon-bedrock#advanced-credential-configuration)-Befehl aus, sofern einer gesetzt ist, oder erneuern Sie Ihre SSO-Anmeldung, Zugriffsschlüssel, Ihren API-Schlüssel oder Ihr Proxy-Token selbst

1612* Wenn Ihre Anmeldedaten aktuell sind, bestätigen Sie die IAM-Berechtigungen in [IAM-Konfiguration](/docs/de/amazon-bedrock#iam-configuration), die an die Identität angehängt sind, die Sie verwenden, und dass das ausgewählte Modell für Ihr Konto und Ihre Region aktiviert ist1619* Wenn Ihre Anmeldedaten aktuell sind, prüfen Sie, ob die IAM-Berechtigungen aus der [IAM-Konfiguration](/docs/de/amazon-bedrock#iam-configuration) der von Ihnen verwendeten Identität zugewiesen sind und ob das ausgewählte Modell für Ihr Konto und Ihre Region aktiviert ist

1613* Führen Sie `aws sts get-caller-identity` aus, um zu bestätigen, welche Identität Ihre Anfragen verwenden1620* Führen Sie `aws sts get-caller-identity` aus, um zu prüfen, welche Identität Ihre Anfragen verwenden

1614 1621

1615<h3 id="google-cloud-credentials-expired-or-invalid">1622<h3 id="google-cloud-credentials-expired-or-invalid">

1616 Google Cloud-Anmeldedaten abgelaufen oder ungültig1623 Google Cloud-Anmeldedaten abgelaufen oder ungültig

1617</h3>1624</h3>

1618 1625

1619Ihre Google Cloud-Anmeldedaten für [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) sind abgelaufen oder wurden abgelehnt: die Anfrage hat einen 401 zurückgegeben, wie Agent Platform Anmeldedaten-Ablauf meldet.1626Ihre Google Cloud-Anmeldedaten für [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) sind abgelaufen oder wurden abgelehnt: Die Anfrage hat einen 401 zurückgegeben; auf diese Weise meldet Agent Platform abgelaufene Anmeldedaten.

1620 1627

1621Der Aktions-Hinweis in der Mitte variiert mit Ihrer Einrichtung. Der stabile Teil ist das führende `Google Cloud credentials expired or invalid`:1628Der Handlungshinweis in der Mitte variiert je nach Ihrer Einrichtung. Der feste Teil ist das vorangestellte `Google Cloud credentials expired or invalid`:

1622 1629

1623```text theme={null}1630```text theme={null}

1624Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...1631Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...

1625```1632```

1626 1633

1627**Was zu tun ist:**1634**Was Sie tun können:**

1628 1635

1629* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator1636* Wenn der Hinweis besagt, dass die Anmeldedaten von dieser Umgebung verwaltet werden, verwaltet die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: Versuchen Sie es erneut oder wenden Sie sich an Ihren Administrator

1630* Wenn Sie sich mit Standard-Anwendungs-Anmeldedaten authentifizieren, führen Sie den [`gcpAuthRefresh`](/docs/de/google-vertex-ai#advanced-credential-configuration)-Befehl aus, der in der Meldung benannt wird, oder `gcloud auth application-default login`, und schließen Sie die Anmeldung ab, dann versuchen Sie es erneut1637* Wenn Sie sich mit Application Default Credentials authentifizieren, führen Sie den in der Meldung genannten [`gcpAuthRefresh`](/docs/de/google-vertex-ai#advanced-credential-configuration)-Befehl oder `gcloud auth application-default login` aus, schließen Sie die Anmeldung ab und versuchen Sie es dann erneut

1631* Wenn Sie durch ein [LLM-Gateway](/docs/de/llm-gateway) mit `CLAUDE_CODE_SKIP_VERTEX_AUTH` gesetzt leiten, aktualisieren Sie das Gateway-Token in `ANTHROPIC_AUTH_TOKEN` oder `ANTHROPIC_CUSTOM_HEADERS`, dann versuchen Sie es erneut1638* Wenn Sie über ein [LLM-Gateway](/docs/de/llm-gateway) mit gesetztem `CLAUDE_CODE_SKIP_VERTEX_AUTH` routen, erneuern Sie das Gateway-Token in `ANTHROPIC_AUTH_TOKEN` oder `ANTHROPIC_CUSTOM_HEADERS` und versuchen Sie es dann erneut

1632* Wenn Sie sich mit einer Service-Account-Schlüsseldatei authentifizieren, bestätigen Sie, dass `GOOGLE_APPLICATION_CREDENTIALS` auf einen gültigen Schlüssel zeigt. Siehe [GCP-Anmeldedaten konfigurieren](/docs/de/google-vertex-ai#3-configure-gcp-credentials)1639* Wenn Sie sich mit einer Schlüsseldatei eines Dienstkontos authentifizieren, prüfen Sie, ob `GOOGLE_APPLICATION_CREDENTIALS` auf einen gültigen Schlüssel verweist. Siehe [GCP-Anmeldedaten konfigurieren](/docs/de/google-vertex-ai#3-configure-gcp-credentials)

1633* Wenn der Fehler nach einer Aktualisierung wiederholt wird, bestätigen Sie, dass die Identität außerhalb von Claude Code mit `gcloud auth application-default print-access-token` in der gleichen Shell funktioniert1640* Wenn der Fehler nach einer Erneuerung erneut auftritt, prüfen Sie mit `gcloud auth application-default print-access-token` in derselben Shell, ob die Identität außerhalb von Claude Code funktioniert

1634 1641

1635Vor v2.1.273 zeigte ein 401 von Agent Platform die generische `Please run /login`- oder `Failed to authenticate`-Meldung statt, die Google Cloud-Anmeldedaten nicht aktualisieren kann.1642Vor v2.1.273 zeigte ein 401 von Agent Platform stattdessen die allgemeine Meldung `Please run /login` oder `Failed to authenticate` an, mit der sich Google Cloud-Anmeldedaten nicht erneuern lassen.

1636 1643

1637<h3 id="google-cloud-authentication-failed">1644<h3 id="google-cloud-authentication-failed">

1638 Google Cloud-Authentifizierung fehlgeschlagen1645 Google Cloud-Authentifizierung fehlgeschlagen

1639</h3>1646</h3>

1640 1647

1641[Google Cloud's Agent Platform](/docs/de/google-vertex-ai) hat einen 403 zurückgegeben, den es für Autorisierungs-Ablehnungen statt abgelaufener Anmeldedaten verwendet. Normalerweise fehlt der Identität, mit der Sie sich authentifizieren, eine IAM-Berechtigung, oder das Modell ist nicht für Ihr Projekt aktiviert.1648[Google Cloud's Agent Platform](/docs/de/google-vertex-ai) hat einen 403 zurückgegeben, den es für Autorisierungsverweigerungen und nicht für abgelaufene Anmeldedaten verwendet. In der Regel fehlt der Identität, mit der Sie sich authentifizieren, eine IAM-Berechtigung, oder das Modell ist für Ihr Projekt nicht aktiviert.

1642 1649

1643Der Aktions-Hinweis in der Mitte variiert mit Ihrer Einrichtung. Der stabile Teil ist das führende `Google Cloud authentication failed`:1650Der Handlungshinweis in der Mitte variiert je nach Ihrer Einrichtung. Der feste Teil ist das vorangestellte `Google Cloud authentication failed`:

1644 1651

1645```text theme={null}1652```text theme={null}

1646Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...1653Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...

1647```1654```

1648 1655

1649**Was zu tun ist:**1656**Was Sie tun können:**

1650 1657

1651* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator1658* Wenn der Hinweis besagt, dass die Anmeldedaten von dieser Umgebung verwaltet werden, verwaltet die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: Versuchen Sie es erneut oder wenden Sie sich an Ihren Administrator

1652* Bestätigen Sie, dass die Rollen in [IAM-Konfiguration](/docs/de/google-vertex-ai#iam-configuration) der Identität gewährt sind, mit der Sie sich authentifizieren1659* Prüfen Sie, ob die Rollen aus der [IAM-Konfiguration](/docs/de/google-vertex-ai#iam-configuration) der Identität zugewiesen sind, mit der Sie sich authentifizieren

1653* Bestätigen Sie, dass das Modell für Ihr Projekt aktiviert ist. Siehe [Modell-Zugriff anfordern](/docs/de/google-vertex-ai#2-request-model-access)1660* Prüfen Sie, ob das Modell für Ihr Projekt aktiviert ist. Siehe [Modellzugriff anfordern](/docs/de/google-vertex-ai#2-request-model-access)

1654 1661

1655Vor v2.1.273 zeigte ein 403 von Agent Platform die generische `Please run /login`- oder `Failed to authenticate`-Meldung statt, die Google Cloud-Anmeldedaten nicht aktualisieren kann.1662Vor v2.1.273 zeigte ein 403 von Agent Platform stattdessen die allgemeine Meldung `Please run /login` oder `Failed to authenticate` an, mit der sich Google Cloud-Anmeldedaten nicht erneuern lassen.

1656 1663

1657<h3 id="microsoft-foundry-authentication-failed">1664<h3 id="microsoft-foundry-authentication-failed">

1658 Microsoft Foundry-Authentifizierung fehlgeschlagen1665 Microsoft Foundry authentication failed

1659</h3>1666</h3>

1660 1667

1661[Microsoft Foundry](/docs/de/microsoft-foundry) hat einen 401 oder 403 zurückgegeben: die Azure-Anmeldedaten in der Anfrage wurden abgelehnt, oder die Identität dahinter hat keinen Zugriff auf die Foundry-Ressource. `/login` kann keine Azure-Anmeldedaten prägen. Der Aktions-Hinweis in der Mitte variiert mit Ihrer Einrichtung. Der stabile Teil ist das führende `Microsoft Foundry authentication failed`:1668[Microsoft Foundry](/docs/de/microsoft-foundry) hat einen 401 oder 403 zurückgegeben: Die Azure-Anmeldedaten in der Anfrage wurden abgelehnt, oder die dahinterstehende Identität hat keinen Zugriff auf die Foundry-Ressource. `/login` kann keine Azure-Anmeldedaten erzeugen. Der Handlungshinweis in der Mitte variiert je nach Ihrer Konfiguration. Der stabile Teil ist das einleitende `Microsoft Foundry authentication failed`:

1662 1669

1663```text theme={null}1670```text theme={null}

1664Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...1671Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...

1666 1673

1667**Was zu tun ist:**1674**Was zu tun ist:**

1668 1675

1669* Wenn der Hinweis sagt, dass Anmeldedaten von dieser Umgebung verwaltet werden, besitzt die App, die Claude Code gestartet hat, die Anmeldedaten, und die anderen Schritte hier gelten nicht: versuchen Sie es erneut, oder kontaktieren Sie Ihren Administrator1676* Wenn der Hinweis besagt, dass die Anmeldedaten von dieser Umgebung verwaltet werden, ist die Anwendung, die Claude Code gestartet hat, für die Anmeldedaten zuständig, und die anderen Schritte hier gelten nicht: Versuchen Sie es erneut, oder wenden Sie sich an Ihren Administrator

1670* Aktualisieren Sie die Anmeldedaten, die Sie in [Azure-Anmeldedaten konfigurieren](/docs/de/microsoft-foundry#2-configure-azure-credentials) konfiguriert haben: rotieren Sie `ANTHROPIC_FOUNDRY_API_KEY`, prägen Sie ein neues `ANTHROPIC_FOUNDRY_AUTH_TOKEN`, oder führen Sie `az login` aus, damit die Standard-Microsoft Entra-Anmeldedaten-Kette sich erneut anmelden kann1677* Aktualisieren Sie die Anmeldedaten, die Sie unter [Azure-Anmeldedaten konfigurieren](/docs/de/microsoft-foundry#2-configure-azure-credentials) eingerichtet haben: Rotieren Sie `ANTHROPIC_FOUNDRY_API_KEY`, erzeugen Sie ein neues `ANTHROPIC_FOUNDRY_AUTH_TOKEN`, oder führen Sie `az login` aus, damit sich die standardmäßige Microsoft-Entra-Anmeldedatenkette erneut anmelden kann

1671* Wenn die Anmeldedaten aktuell sind, bestätigen Sie, dass die Identität Zugriff auf die Foundry-Ressource hat. Siehe [Azure RBAC-Konfiguration](/docs/de/microsoft-foundry#azure-rbac-configuration)1678* Wenn die Anmeldedaten aktuell sind, prüfen Sie, ob die Identität Zugriff auf die Foundry-Ressource hat. Siehe [Azure-RBAC-Konfiguration](/docs/de/microsoft-foundry#azure-rbac-configuration)

1672 1679

1673Vor v2.1.273 zeigte ein 401 oder 403 von Microsoft Foundry die generische `Please run /login`- oder `Failed to authenticate`-Meldung statt, die Azure-Anmeldedaten nicht aktualisieren kann.1680Vor v2.1.273 zeigte ein 401 oder 403 von Microsoft Foundry stattdessen die allgemeine Meldung `Please run /login` oder `Failed to authenticate` an, mit der sich Azure-Anmeldedaten nicht aktualisieren lassen.

1674 1681

1675<h3 id="could-not-load-aws-or-google-cloud-credentials">1682<h3 id="could-not-load-aws-or-google-cloud-credentials">

1676 AWS- oder Google Cloud-Anmeldedaten konnten nicht geladen werden1683 Could not load AWS or Google Cloud credentials

1677</h3>1684</h3>

1678 1685

1679Claude Code konnte keine verwendbaren Anmeldedaten von der AWS-Anmeldedaten-Provider-Kette oder von Ihren Google-Standard-Anwendungs-Anmeldedaten auf der Maschine, auf der es läuft, erhalten, sodass keine Anfrage Ihren Cloud-Provider erreichte. Claude Code löscht seine zwischengespeicherten Anmeldedaten und versucht zweimal erneut, bevor diese Meldung angezeigt wird. Das Detail nach dem `·` benennt die spezifische Ursache, z. B. eine abgelaufene SSO-Sitzung, fehlende Standard-Anwendungs-Anmeldedaten, die als `Could not load the default credentials` gemeldet werden, oder eine widerrufene Anmeldung, die als `invalid_grant` gemeldet wird:1686Claude Code konnte auf dem Rechner, auf dem es läuft, keine verwendbaren Anmeldedaten aus der AWS-Anmeldedaten-Anbieterkette oder aus Ihren Google Application Default Credentials beziehen, sodass keine Anfrage Ihren Cloud-Anbieter erreicht hat. Claude Code leert seine zwischengespeicherten Anmeldedaten und versucht es zweimal erneut, bevor diese Meldung angezeigt wird. Das Detail nach dem `·` nennt die konkrete Ursache, etwa eine abgelaufene SSO-Sitzung, fehlende Application Default Credentials, gemeldet als `Could not load the default credentials`, oder eine widerrufene Anmeldung, gemeldet als `invalid_grant`:

1680 1687

1681```text theme={null}1688```text theme={null}

1682API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.1689API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.

1683API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.1690API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.

1684```1691```

1685 1692

1686Im [nicht-interaktiven Modus](/docs/de/headless) mit `-p` und im [Agent SDK](/docs/de/agent-sdk/overview) ist der strukturierte Fehlercode `cloud_credential_error`. Vor v2.1.267 zeigte die Meldung nur den Detail-Text nach `API Error:`, und der strukturierte Code war `server_error` oder `unknown`.1693Im [nicht interaktiven Modus](/docs/de/headless) mit `-p` und im [Agent SDK](/docs/de/agent-sdk/overview) lautet der strukturierte Fehlercode `cloud_credential_error`. Vor v2.1.267 zeigte die Meldung nur den Detailtext nach `API Error:` an, und der strukturierte Code war `server_error` oder `unknown`.

1687 1694

1688**Was zu tun ist:**1695**Was zu tun ist:**

1689 1696

1690* Führen Sie Ihren Provider-Anmeldungs-Befehl aus, z. B. `aws sso login --profile myprofile` oder `gcloud auth application-default login`, dann versuchen Sie es erneut. [Bedrock-, Agent Platform- oder Foundry-Anmeldedaten werden nicht geladen](/docs/de/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) zeigt, wie Sie die Anmeldedaten außerhalb von Claude Code bestätigen1697* Führen Sie den Anmeldebefehl Ihres Anbieters aus, etwa `aws sso login --profile myprofile` oder `gcloud auth application-default login`, und versuchen Sie es dann erneut. Unter [Bedrock-, Agent-Platform- oder Foundry-Anmeldedaten werden nicht geladen](/docs/de/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) erfahren Sie, wie Sie die Anmeldedaten außerhalb von Claude Code überprüfen

1691* Wenn das Detail `AWS default-chain credential resolve timed out` liest, ist die Kette hängen geblieben statt fehlgeschlagen, also folgen Sie stattdessen [AWS default-chain credential resolve timed out](#aws-default-chain-credential-resolve-timed-out)1698* Wenn das Detail `AWS default-chain credential resolve timed out` lautet, ist die Kette hängen geblieben und nicht fehlgeschlagen; folgen Sie stattdessen [AWS default-chain credential resolve timed out](#aws-default-chain-credential-resolve-timed-out)

1692 1699

1693<h3 id="aws-default-chain-credential-resolve-timed-out">1700<h3 id="aws-default-chain-credential-resolve-timed-out">

1694 AWS default-chain credential resolve timed out1701 AWS default-chain credential resolve timed out

1695</h3>1702</h3>

1696 1703

1697Die AWS-Standard-Anmeldedaten-Provider-Kette hat keine Anmeldedaten innerhalb von 60 Sekunden erzeugt, sodass Claude Code die Auflösung gestoppt und die Anfrage fehlgeschlagen hat. Dieses Timeout ist eine Ursache von [AWS- oder Google Cloud-Anmeldedaten konnten nicht geladen werden](#could-not-load-aws-or-google-cloud-credentials). Der Fehler ist lokale Anmeldedaten-Auflösung: die Anfrage erreichte nie [Amazon Bedrock](/docs/de/amazon-bedrock), [Claude Platform on AWS](/docs/de/claude-platform-on-aws) oder den [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint). Claude Code löscht seinen [Anmeldedaten-Cache](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout) und versucht erneut, bevor dieser Fehler auftaucht, sodass die Kette zu dem Zeitpunkt, an dem Sie ihn sehen, auf wiederholten Versuchen stecken geblieben ist.1704Die standardmäßige AWS-Anmeldedaten-Anbieterkette hat innerhalb von 60 Sekunden keine Anmeldedaten geliefert, daher hat Claude Code die Auflösung abgebrochen und die Anfrage fehlschlagen lassen. Dieser Timeout ist eine Ursache für [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). Der Fehler liegt in der lokalen Auflösung der Anmeldedaten: Die Anfrage hat [Amazon Bedrock](/docs/de/amazon-bedrock), [Claude Platform on AWS](/docs/de/claude-platform-on-aws) oder den [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) nie erreicht. Claude Code leert seinen [Anmeldedaten-Cache](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout) und versucht es erneut, bevor dieser Fehler angezeigt wird; wenn Sie ihn sehen, ist die Kette also bei wiederholten Versuchen hängen geblieben.

1698 1705

1699```text theme={null}1706```text theme={null}

1700API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.1707API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.

1701```1708```

1702 1709

1703Häufige Ursachen sind ein `credential_process`-Befehl in Ihrem AWS-Profil, der auf Eingabe wartet, die er nicht erhalten kann, und ein Container oder eine VM, deren Instance-Metadaten-Service (IMDS) die Probe der Kette nie beantwortet.1710Häufige Ursachen sind ein `credential_process`-Befehl in Ihrem AWS-Profil, der auf eine Eingabe wartet, die er nicht erhalten kann, sowie ein Container oder eine VM, deren Instance Metadata Service (IMDS) nie auf die Abfrage der Kette antwortet.

1704 1711

1705Vor v2.1.267 lautet die Meldung `API Error: AWS default-chain credential resolve timed out`.1712Vor v2.1.267 lautete die Meldung `API Error: AWS default-chain credential resolve timed out`.

1706Vor v2.1.207 ließ eine stecken gebliebene Kette die Anfrage auf unbestimmte Zeit warten statt zu fehlschlagen.1713Vor v2.1.207 ließ eine hängende Kette die Anfrage unbegrenzt warten, anstatt sie fehlschlagen zu lassen.

1707 1714

1708**Was zu tun ist:**1715**Was zu tun ist:**

1709 1716

1710* Führen Sie `aws sts get-caller-identity` in der gleichen Shell mit dem gleichen `AWS_PROFILE` aus. Wenn es auch hängen bleibt, beheben Sie das Profil; ein `credential_process`-Befehl, der interaktiv auffordert, ist eine häufige Ursache.1717* Führen Sie `aws sts get-caller-identity` in derselben Shell mit demselben `AWS_PROFILE` aus. Wenn der Befehl ebenfalls hängt, korrigieren Sie das Profil; ein `credential_process`-Befehl, der interaktiv nachfragt, ist eine häufige Ursache.

1711* Schließen Sie den Anmeldungs-Schritt ab, bevor Sie Claude Code starten, z. B. `aws sso login --profile myprofile`1718* Schließen Sie den Anmeldeschritt ab, bevor Sie Claude Code starten, zum Beispiel mit `aws sso login --profile myprofile`

1712* Wenn Ihre Kette eine interaktive Anmeldung ausführt, die legitim länger als 60 Sekunden benötigt, z. B. SSO mit MFA durch einen Wrapper wie `aws-vault`, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/de/env-vars)1719* Wenn Ihre Kette eine interaktive Anmeldung ausführt, die berechtigterweise mehr als 60 Sekunden benötigt, etwa SSO mit MFA über einen Wrapper wie `aws-vault`, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/de/env-vars)

1713 1720

1714<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">1721<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">

1715 Bedrock-Einrichtungs-Überprüfung timed out beim Warten auf AWS1722 Bedrock setup verification timed out waiting for AWS

1716</h3>1723</h3>

1717 1724

1718Ein Aufruf an AWS während des [Bedrock-Einrichtungs-Assistenten](/docs/de/amazon-bedrock#sign-in-with-bedrock)'s Anmeldedaten-Überprüfung, z. B. die Anmeldedaten-Suche oder die Identitäts-Überprüfung, hat nicht innerhalb des 60-Sekunden-Limits beendet. Der Assistent stoppt das Warten und schlägt den Überprüfungs-Schritt fehl:1725Ein Aufruf an AWS während der Überprüfung der Anmeldedaten im [Bedrock-Einrichtungsassistenten](/docs/de/amazon-bedrock#sign-in-with-bedrock), etwa die Suche nach Anmeldedaten oder die Identitätsprüfung, wurde nicht innerhalb des 60-Sekunden-Limits abgeschlossen. Der Assistent wartet nicht länger und lässt den Überprüfungsschritt fehlschlagen:

1719 1726

1720```text theme={null}1727```text theme={null}

1721Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.1728Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

1722```1729```

1723 1730

1724Die Zahl spiegelt Ihr Limit wider: 60 Sekunden standardmäßig, oder der Wert, den Sie in [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/de/env-vars) setzen.1731Die Zahl entspricht Ihrem Limit: standardmäßig 60 Sekunden oder der Wert, den Sie in [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/de/env-vars) festgelegt haben.

1725 1732

1726Häufige Ursachen sind ein Netzwerk oder Proxy, das Anfragen an AWS staut, einschließlich der SSO-Token-Aktualisierung, und ein Anmeldedaten-Helper, der immer noch auf Eingabe wartet, die Sie nicht sehen können. Erhöhen Sie das Limit nur, wenn der Helper legitim mehr Zeit benötigt.1733Häufige Ursachen sind ein Netzwerk oder Proxy, der Anfragen an AWS blockiert, einschließlich der Aktualisierung des SSO-Tokens, sowie ein Credential Helper, der noch auf eine Eingabe wartet, die Sie nicht sehen können. Erhöhen Sie das Limit nur, wenn der Helper berechtigterweise mehr Zeit benötigt.

1727 1734

1728Ein einzelner stecken gebliebener Aufruf an AWS kann auch auf seinem eigenen Pro-Anfrage-Timeout fehlschlagen, das eine kürzere Meldung auf dem gleichen Schritt zeigt:1735Eine einzelne hängende Anfrage an AWS kann auch an ihrem eigenen Timeout pro Anfrage scheitern, was im selben Schritt eine kürzere Meldung anzeigt:

1729 1736

1730```text theme={null}1737```text theme={null}

1731A request to AWS timed out. Check your network and proxy settings, then try again.1738A request to AWS timed out. Check your network and proxy settings, then try again.

1732```1739```

1733 1740

1734Wenn die gleichen Timeouts auf dem Modell-Pin-Schritt auftreten, markiert der Assistent ein Modell als `unreachable` statt eine der beiden Meldungen zu zeigen.1741Wenn dieselben Timeouts beim Schritt zum Festlegen des Modells auftreten, markiert der Assistent ein Modell als `unreachable`, anstatt eine der beiden Meldungen anzuzeigen.

1735 1742

1736**Was zu tun ist:**1743**Was zu tun ist:**

1737 1744

1738* Führen Sie `aws sts get-caller-identity` in der gleichen Shell aus. Wenn es auch hängen bleibt, ist der Stau außerhalb von Claude Code, in Ihrem Netzwerk, Ihrem Proxy oder dem Anmeldedaten-Helper in Ihrem AWS-Profil; beheben Sie das zuerst.1745* Führen Sie `aws sts get-caller-identity` in derselben Shell aus. Wenn der Befehl ebenfalls hängt, liegt die Blockade außerhalb von Claude Code, in Ihrem Netzwerk, Ihrem Proxy oder dem Credential Helper in Ihrem AWS-Profil; beheben Sie das zuerst.

1739* Schließen Sie jede interaktive Anmeldung ab, bevor Sie den Assistenten öffnen, z. B. `aws sso login --profile myprofile`1746* Schließen Sie jede interaktive Anmeldung ab, bevor Sie den Assistenten öffnen, zum Beispiel mit `aws sso login --profile myprofile`

1740* Wenn ein Anmeldedaten-Helper in Ihrem AWS-Profil legitim länger als 60 Sekunden benötigt, um Sie aufzufordern, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/de/env-vars)1747* Wenn ein Credential Helper in Ihrem AWS-Profil berechtigterweise länger als 60 Sekunden benötigt, um Sie zur Eingabe aufzufordern, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/de/env-vars)

1741 1748

1742<h3 id="cloud-gateway-session-expired">1749<h3 id="cloud-gateway-session-expired">

1743 Cloud-Gateway-Sitzung abgelaufen1750 Cloud gateway session expired

1744</h3>1751</h3>

1745 1752

1746Sie haben sich durch ein [Claude apps gateway](/docs/de/claude-apps-gateway) angemeldet, und die auf dieser Maschine gespeicherte Gateway-Sitzung ist abgelaufen und konnte nicht erneuert werden, oder das Gateway akzeptiert sie nicht mehr, z. B. nachdem das Gateway's [JWT-Geheimnis rotiert wurde](/docs/de/claude-apps-gateway-deploy#jwt-secret-rotation). Wenn Sie diese Zeile sehen, wenn Sie `claude` interaktiv starten, hat die Sitzung ohne Gateway-Anmeldung geöffnet:1753Sie haben sich über ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) angemeldet, und die auf diesem Rechner gespeicherte Gateway-Sitzung ist abgelaufen und konnte nicht erneuert werden, oder das Gateway akzeptiert sie nicht mehr, zum Beispiel nachdem das [JWT-Secret des Gateways ersetzt wurde](/docs/de/claude-apps-gateway-deploy#jwt-secret-rotation). Wenn Sie diese Zeile sehen, wenn Sie `claude` interaktiv starten, wurde die Sitzung ohne Anmeldung am Gateway geöffnet:

1747 1754

1748```text theme={null}1755```text theme={null}

1749Cloud gateway session expired — run /login to reconnect.1756Cloud gateway session expired — run /login to reconnect.

1750```1757```

1751 1758

1752Die gleiche Zeile kann während der Sitzung erscheinen, wenn die Gateway-Anmeldedaten ablaufen und Claude Code sie nicht erneuern kann.1759Dieselbe Zeile kann mitten in einer Sitzung erscheinen, wenn die Gateway-Anmeldedaten ablaufen und Claude Code sie nicht erneuern kann.

1753 1760

1754In einem [nicht-interaktiven](/docs/de/headless) Lauf, einer Hintergrund- oder anderen unbeaufsichtigten Sitzung oder einem `claude`-Unterbefehl außer `claude auth` beendet Claude Code stattdessen mit dieser Meldung, wenn das Gateway die Sitzung nicht mehr akzeptiert:1761In einem [nicht interaktiven](/docs/de/headless) Lauf, einer Hintergrund- oder anderen unbeaufsichtigten Sitzung oder einem anderen `claude`-Unterbefehl als `claude auth` beendet sich Claude Code stattdessen mit dieser Meldung, wenn das Gateway die Sitzung nicht mehr akzeptiert:

1755 1762

1756```text theme={null}1763```text theme={null}

1757Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.1764Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.

1759 1766

1760**Was zu tun ist:**1767**Was zu tun ist:**

1761 1768

1762* Führen Sie `/login` in der Sitzung aus und schließen Sie die Browser-Anmeldung ab1769* Führen Sie `/login` in der Sitzung aus und schließen Sie die Anmeldung im Browser ab

1763* Für einen nicht-interaktiven Start starten Sie `claude` in der gleichen Umgebung, führen Sie `/login` aus, dann führen Sie Ihren Befehl erneut aus1770* Bei einem nicht interaktiven Start starten Sie `claude` in derselben Umgebung, führen `/login` aus und führen dann Ihren Befehl erneut aus

1764 1771

1765<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">1772<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">

1766 Anmeldung timed out beim Warten auf Sie, um fortzufahren1773 Sign-in timed out while waiting for you to continue

1767</h3>1774</h3>

1768 1775

1769Während einer [Claude apps gateway](/docs/de/claude-apps-gateway)-Anmeldung benannte das Gateway das Konto, das sich angemeldet hat, und Claude Code fragte Sie, es zu bestätigen, bevor die Anmeldedaten gespeichert wurden. Sie ließen die Bestätigung offen, nachdem die Anmeldung selbst abgelaufen war, und das Gateway gab keinen Aktualisierungs-Token aus, der sie erneuern konnte, sodass Claude Code nichts speicherte, als Sie fortfuhren:1776Während einer Anmeldung über ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) hat das Gateway das angemeldete Konto genannt, und Claude Code hat Sie gebeten, es zu bestätigen, bevor die Anmeldedaten gespeichert werden. Sie haben die Bestätigung über den Ablauf der Anmeldung hinaus offen gelassen, und das Gateway hat kein Refresh-Token ausgegeben, mit dem sie hätte erneuert werden können, daher hat Claude Code nichts gespeichert, als Sie fortgefahren sind:

1770 1777

1771```text theme={null}1778```text theme={null}

1772Sign-in timed out while waiting for you to continue. Try again.1779Sign-in timed out while waiting for you to continue. Try again.

1777* Führen Sie `/login` erneut aus und bestätigen Sie das Konto, bevor die Anmeldung abläuft1784* Führen Sie `/login` erneut aus und bestätigen Sie das Konto, bevor die Anmeldung abläuft

1778 1785

1779<h3 id="gateway-refused-the-request">1786<h3 id="gateway-refused-the-request">

1780 Gateway lehnte die Anfrage ab1787 Gateway refused the request

1781</h3>1788</h3>

1782 1789

1783Sie sind über ein [Claude apps gateway](/docs/de/claude-apps-gateway) angemeldet, und eine Anfrage hat einen 403 zurückgegeben: das Gateway, oder das Upstream dahinter, lehnte sie ab. Sich erneut anzumelden ändert eine Ablehnung nicht, sodass die Meldung auf Ihren Gateway-Administrator zeigt:1790Sie sind über ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) angemeldet, und eine Anfrage hat einen 403 zurückgegeben: Das Gateway oder der dahinterliegende Upstream hat sie abgelehnt. Eine erneute Anmeldung ändert nichts an einer Ablehnung, daher verweist die Meldung auf Ihren Gateway-Administrator:

1784 1791

1785```text theme={null}1792```text theme={null}

1786Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...1793Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...

1788 1795

1789**Was zu tun ist:**1796**Was zu tun ist:**

1790 1797

1791* Bitten Sie Ihren Gateway-Administrator, die Anfrage nachzuschlagen. Der `API Error:`-Schwanz trägt die Ablehnung, die das Gateway zurückgegeben hat1798* Bitten Sie Ihren Gateway-Administrator, die Anfrage nachzuverfolgen. Der Teil nach `API Error:` enthält die Ablehnung, die das Gateway zurückgegeben hat

1792* Für Administratoren: eine [Zugriffs-Kontroll-Regel](/docs/de/claude-apps-gateway-config#http-tuning) auf dem Gateway gibt einen 403 zurück, den das [Audit-Protokoll](/docs/de/claude-apps-gateway-deploy#logs) mit seinem Grund aufzeichnet, und eine Upstream-Autorisierungs-Ablehnung wird pro [Upstream-Fehler-Meldungen](/docs/de/claude-apps-gateway-config#upstream-error-messages) weitergeleitet1799* Für Administratoren: Eine [Zugriffskontrollregel](/docs/de/claude-apps-gateway-config#http-tuning) auf dem Gateway gibt einen 403 zurück, den das [Audit-Log](/docs/de/claude-apps-gateway-deploy#logs) mit seinem Grund aufzeichnet, und eine Autorisierungsverweigerung eines Upstreams wird gemäß [Upstream-Fehlermeldungen](/docs/de/claude-apps-gateway-config#upstream-error-messages) durchgereicht

1793 1800

1794Vor v2.1.273 zeigte ein 403 auf einer Gateway-Sitzung die generische `Please run /login`- oder `Failed to authenticate`-Meldung statt, und sich erneut anzumelden löscht die Ablehnung nicht.1801Vor v2.1.273 zeigte ein 403 bei einer Gateway-Sitzung stattdessen die allgemeine Meldung `Please run /login` oder `Failed to authenticate` an, und eine erneute Anmeldung hob die Ablehnung nicht auf.

1795 1802

1796<h2 id="network-and-connection-errors">1803<h2 id="network-and-connection-errors">

1797 Netzwerk- und Verbindungsfehler1804 Netzwerk- und Verbindungsfehler

2852 Befehlszeilenfehler2859 Befehlszeilenfehler

2853</h2>2860</h2>

2854 2861

2855Diese Fehler stammen aus dem `claude`-Befehl und seinen Unterbefehlen, aus einem Befehlsnamen, den Sie an der Eingabeaufforderung eingeben, und aus Befehlen wie `/security-review`, die Kontext durch Ausführung von Shell-Befehlen sammeln, bevor ihre Eingabeaufforderung ausgeführt wird. Sie stammen auch von `/tui`, das die CLI neu startet.2862Diese Fehler stammen von der Befehlszeile `claude` und ihren Unterbefehlen, von einem Befehlsnamen, den Sie im Eingabefeld absenden, sowie von Befehlen wie `/security-review`, die Kontext sammeln, indem sie Shell-Befehle ausführen, bevor ihr Prompt ausgeführt wird. Sie stammen auch von `/tui`, das die CLI neu startet.

2856 2863

2857<h3 id="conflict-between-bg-and-print">2864<h3 id="conflict-between-bg-and-print">

2858 Konflikt zwischen `--bg` und `--print`2865 Konflikt zwischen `--bg` und `--print`

2859</h3>2866</h3>

2860 2867

2861Diese Meldung erfordert Claude Code v2.1.198 oder später. Sie haben `--bg` mit `-p` oder `--print` in derselben `claude`-Invokation kombiniert. `--bg` startet eine [Hintergrund-Sitzung](/docs/de/agent-view#from-your-shell), die Sie später mit `claude agents` anfügen, während `--print` [nicht interaktiv](/docs/de/headless) ausgeführt wird und nie die interaktive Sitzung startet, die `claude agents` anfügt. Vor v2.1.198 hat diese Kombination stillschweigend einen Hintergrund-Job erstellt, der nie angefügt werden konnte.2868Diese Meldung erfordert Claude Code v2.1.198 oder höher. Sie haben `--bg` im selben `claude`-Aufruf mit `-p` oder `--print` kombiniert. `--bg` startet eine [Hintergrundsitzung](/docs/de/agent-view#from-your-shell), an die Sie sich später mit `claude agents` anhängen, während `--print` [nicht interaktiv](/docs/de/headless) ausgeführt wird und nie die interaktive Sitzung startet, an die sich `claude agents` anhängt. Vor v2.1.198 erstellte diese Kombination stillschweigend einen Hintergrundjob, an den man sich nie anhängen konnte.

2862 2869

2863```text theme={null}2870```text theme={null}

2864--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>'`.2871--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>'`.

2866 2873

2867**Was zu tun ist:**2874**Was zu tun ist:**

2868 2875

2869* Lassen Sie `-p` oder `--print` weg. `--bg` nimmt die Eingabeaufforderung als sein Positionsargument, also ist `claude --bg "<task>"` der vollständige Befehl. Siehe [Neue Agenten von Ihrer Shell aus versenden](/docs/de/agent-view#from-your-shell).2876* Entfernen Sie `-p` oder `--print`. `--bg` nimmt den Prompt als Positionsargument entgegen, sodass `claude --bg "<task>"` der vollständige Befehl ist. Siehe [Neue Agenten aus Ihrer Shell starten](/docs/de/agent-view#from-your-shell).

2870* Um die Eingabeaufforderung nicht interaktiv auszuführen und das Ergebnis auszudrucken, anstatt eine Hintergrund-Sitzung zu erstellen, lassen Sie `--bg` weg und führen Sie `claude -p "<task>"` aus2877* Um den Prompt nicht interaktiv auszuführen und das Ergebnis auszugeben, anstatt eine Hintergrundsitzung zu erstellen, entfernen Sie `--bg` und führen Sie `claude -p "<task>"` aus

2878

2879<h3 id="conflict-between-a-system-prompt-flag-and-its-file-form">

2880 Konflikt zwischen einem System-Prompt-Flag und seiner Dateiform

2881</h3>

2882

2883Sie haben [`--append-subagent-system-prompt`](/docs/de/cli-reference#cli-flags) zusammen mit `--append-subagent-system-prompt-file` in einem `claude`-Aufruf übergeben, daher beendet sich `claude` mit Exit-Code 1, anstatt die Sitzung zu starten:

2884

2885```text theme={null}

2886Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.

2887```

2888

2889Vor v2.1.283 beendete sich `claude` auf dieselbe Weise, wenn Sie `--system-prompt` mit `--system-prompt-file` oder `--append-system-prompt` mit `--append-system-prompt-file` übergeben haben, da diese Paare in Konflikt standen, anstatt sich zu [kombinieren](/docs/de/cli-reference#system-prompt-flags). In diesen Versionen nennt die Meldung das Paar, das Sie kombiniert haben.

2890

2891**Was zu tun ist:**

2892

2893* Behalten Sie eine Form des Flags bei und entfernen Sie die andere. Um eine feste Prompt-Datei mit Text pro Ausführung zu kombinieren, fügen Sie den Text vor dem Start in die Datei ein, anstatt beide Flags zu übergeben

2871 2894

2872<h3 id="invalid-agents-configuration">2895<h3 id="invalid-agents-configuration">

2873 Ungültige `--agents`-Konfiguration2896 Ungültige `--agents`-Konfiguration

2874</h3>2897</h3>

2875 2898

2876Der Wert, den Sie an `--agents` übergeben haben, ist ungültig, daher beendet `claude` mit Code 1, anstatt die Sitzung zu starten. Wenn Sie `--safe-mode` übergeben oder [`CLAUDE_CODE_SAFE_MODE`](/docs/de/env-vars#variables) setzen, ignoriert Claude Code `--agents` vollständig. Mit `--resume` oder `--continue` wird ein Inline-JSON-Wert nicht überprüft und die Sitzung startet; ein Wert, der aus einer Datei gelesen wird, wird bei jedem Start überprüft. Vor v2.1.242 hat Claude Code die Sitzung trotzdem gestartet.2899Der Wert, den Sie an `--agents` übergeben haben, ist ungültig, daher beendet sich `claude` mit Exit-Code 1, anstatt die Sitzung zu starten. Wenn Sie `--safe-mode` übergeben oder [`CLAUDE_CODE_SAFE_MODE`](/docs/de/env-vars#variables) setzen, ignoriert Claude Code `--agents` vollständig. Mit `--resume` oder `--continue` wird ein Inline-JSON-Wert nicht geprüft und die Sitzung startet; ein aus einer Datei gelesener Wert wird bei jedem Start geprüft. Vor v2.1.242 startete Claude Code die Sitzung trotzdem.

2877 2900

2878```text theme={null}2901```text theme={null}

2879Error: Invalid --agents configuration:2902Error: Invalid --agents configuration:

2880<what failed>2903<what failed>

2881```2904```

2882 2905

2883Was nach der ersten Zeile folgt, hängt davon ab, wie der Wert fehlgeschlagen ist. Claude Code führt diese Überprüfungen der Reihe nach aus und stoppt bei der ersten, die fehlschlägt. Wenn Ihr Wert zwei Arten von Problemen hat, sehen Sie die zweite erst, nachdem Sie die erste behoben haben:2906Was auf die erste Zeile folgt, hängt davon ab, woran der Wert gescheitert ist. Claude Code führt diese Prüfungen der Reihe nach aus und stoppt bei der ersten, die fehlschlägt. Wenn Ihr Wert zwei Arten von Problemen hat, sehen Sie das zweite erst, nachdem Sie das erste behoben haben:

2884 2907

28851. Wenn der Wert mit `{` beginnt, aber nicht als JSON analysiert wird, oder der Inhalt einer `--agents`-Datei nicht analysiert wird, druckt Claude Code eine `invalid JSON:`-Zeile mit der eigenen Meldung des JSON-Parsers29081. Wenn der Wert mit `{` beginnt, aber nicht als JSON geparst werden kann, oder der Inhalt einer `--agents`-Datei nicht geparst werden kann, gibt Claude Code eine `invalid JSON:`-Zeile mit der eigenen Meldung des JSON-Parsers aus

28862. Wenn er analysiert wird, aber eine Agent-Definition nicht dem Schema für [CLI-definierte Subagenten](/docs/de/sub-agents#choose-the-subagent-scope) entspricht, druckt Claude Code eine Zeile pro Problem29092. Wenn er geparst werden kann, aber eine Agentendefinition nicht dem Schema für [per CLI definierte Subagenten](/docs/de/sub-agents#choose-the-subagent-scope) entspricht, gibt Claude Code eine Zeile pro Problem aus

28873. Wenn ein Agent-Name mit `-` beginnt, druckt Claude Code `<name>: agent names must not start with '-'`29103. Wenn ein Agentenname mit `-` beginnt, gibt Claude Code `<name>: agent names must not start with '-'` aus

2888 2911

2889Wenn es mehr als 20 Problemzeilen gibt, druckt Claude Code die ersten 20 und ersetzt den Rest mit `…and N more`.2912Bei mehr als 20 Problemzeilen gibt Claude Code die ersten 20 aus und ersetzt den Rest durch `…and N more`.

2890 2913

2891Mit `--print` akzeptiert `--agents` auch [den Pfad zu einer JSON-Datei](/docs/de/sub-agents#choose-the-subagent-scope) anstelle des Inline-Objekts. Vor v2.1.281 akzeptierte `--agents` nur Inline-JSON und behandelte einen Dateipfad als ungültiges JSON. Die Dateiform hat ihre eigenen Ablehnungen, die anstelle dieser Meldung gedruckt werden, einschließlich dieser:2914Mit `--print` akzeptiert `--agents` anstelle des Inline-Objekts auch [den Pfad zu einer JSON-Datei](/docs/de/sub-agents#choose-the-subagent-scope). Vor v2.1.281 akzeptierte `--agents` nur Inline-JSON und behandelte einen Dateipfad als ungültiges JSON. Die Dateiform hat eigene Ablehnungen, die anstelle dieser Meldung ausgegeben werden, darunter diese:

2892 2915

2893* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code hat den Wert als Dateipfad in einer interaktiven Sitzung gelesen. Übergeben Sie die Definitionen als Inline-JSON, oder fügen Sie `-p` hinzu, um sie aus einer Datei zu lesen.2916* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code hat den Wert in einer interaktiven Sitzung als Dateipfad gelesen. Übergeben Sie die Definitionen als Inline-JSON oder fügen Sie `-p` hinzu, um sie aus einer Datei zu lesen.

2894* **`Error: --agents file not found: <path>`**: Es existiert keine Datei unter diesem Pfad. Ein Wert, der nicht mit `{` beginnt und kein gültiges JSON ist, wird als Pfad gelesen, daher kann Inline-JSON, das Ihre Shell beschädigt hat, auf diese Weise fehlschlagen. Überprüfen Sie den Pfad oder die Anführungszeichen und führen Sie den Befehl erneut aus.2917* **`Error: --agents file not found: <path>`**: Unter diesem Pfad existiert keine Datei. Ein Wert, der nicht mit `{` beginnt und kein gültiges JSON ist, wird als Pfad gelesen, sodass auch Inline-JSON, das Ihre Shell verstümmelt hat, auf diese Weise fehlschlagen kann. Prüfen Sie den Pfad oder die Anführungszeichen und führen Sie den Befehl erneut aus.

2895 2918

2896**Was zu tun ist:**2919**Was zu tun ist:**

2897 2920

2898* Beheben Sie jedes Problem, das die Meldung auflistet, und führen Sie dann den Befehl erneut aus. Siehe [die Felder, die ein CLI-definierter Subagent benötigt](/docs/de/sub-agents#choose-the-subagent-scope).2921* Beheben Sie jedes Problem, das die Meldung auflistet, und führen Sie den Befehl dann erneut aus. Siehe [die Felder, die ein per CLI definierter Subagent akzeptiert](/docs/de/sub-agents#choose-the-subagent-scope).

2899 2922

2900<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">2923<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">

2901 Cloud-Sitzungen können nicht aus einer `--restricted`-Sitzung erstellt werden2924 Cloud-Sitzungen können nicht aus einer `--restricted`-Sitzung erstellt werden

2902</h3>2925</h3>

2903 2926

2904Wenn Sie eine Sitzung mit [`--restricted`](/docs/de/cli-reference#cli-flags) starten, weigert sich Claude Code, [Cloud-Sitzungen](/docs/de/claude-code-on-the-web#from-terminal-to-cloud) daraus zu erstellen, da die neue Sitzung außerhalb des eingeschränkten Prozesses ausgeführt würde und den eingeschränkten Modus nicht erzwingen würde. Claude Code weigert sich auf der Client-Seite, bevor der Server kontaktiert wird, daher wird keine Cloud-Sitzung erstellt:2927Wenn Sie eine Sitzung mit [`--restricted`](/docs/de/cli-reference#cli-flags) starten, verweigert Claude Code das Erstellen von [Cloud-Sitzungen](/docs/de/claude-code-on-the-web#from-terminal-to-cloud) daraus, da die neue Sitzung außerhalb des eingeschränkten Prozesses laufen und den eingeschränkten Modus nicht durchsetzen würde. Claude Code verweigert dies auf dem Client, bevor der Server kontaktiert wird, sodass keine Cloud-Sitzung erstellt wird:

2905 2928

2906```text theme={null}2929```text theme={null}

2907Cloud sessions cannot be created from a --restricted session: they would not enforce it.2930Cloud sessions cannot be created from a --restricted session: they would not enforce it.

2910**Was zu tun ist:**2933**Was zu tun ist:**

2911 2934

2912* Führen Sie die Aufgabe lokal in der eingeschränkten Sitzung aus2935* Führen Sie die Aufgabe lokal in der eingeschränkten Sitzung aus

2913* Wenn Sie kontrollieren, wie die Sitzung gestartet wurde, starten Sie eine neue `claude`-Sitzung ohne `--restricted` und erstellen Sie die Cloud-Sitzung von dort aus2936* Wenn Sie steuern, wie die Sitzung gestartet wurde, starten Sie eine neue `claude`-Sitzung ohne `--restricted` und erstellen Sie die Cloud-Sitzung von dort aus

2914 2937

2915Vor v2.1.248 hatte Claude Code kein `--restricted`-Flag; frühere Versionen lehnen das Flag selbst mit einem Fehler für unbekannte Optionen ab.2938Vor v2.1.248 hatte Claude Code kein `--restricted`-Flag; frühere Versionen lehnen das Flag selbst mit einem Fehler wegen unbekannter Option ab.

2916 2939

2917<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">2940<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">

2918 Cloud-Sitzungen sind durch die Richtlinie Ihrer Organisation deaktiviert2941 Cloud-Sitzungen sind durch die Richtlinie Ihrer Organisation deaktiviert

2919</h3>2942</h3>

2920 2943

2921Die `allow_remote_sessions`-Richtlinie Ihrer Organisation ist deaktiviert, daher sind [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) und die Befehle, die sie verwenden, nicht verfügbar:2944Die Richtlinie `allow_remote_sessions` Ihrer Organisation ist ausgeschaltet, daher sind [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) und die Befehle, die sie verwenden, nicht verfügbar:

2922 2945

2923```text theme={null}2946```text theme={null}

2924Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.2947Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.

2925```2948```

2926 2949

2927Die Meldung wird angezeigt, wenn Sie [eine Cloud-Sitzung vom Terminal aus erstellen](/docs/de/claude-code-on-the-web#from-terminal-to-cloud) und wenn Sie einen Befehl eingeben, der Cloud-Sitzungen benötigt, wie `/teleport`, `/remote-env` oder `/web-setup`. Vor v2.1.268 gab die Eingabe eines dieser Befehle stattdessen [`Unknown command`](#unknown-command) zurück.2950Die Meldung erscheint, wenn Sie [eine Cloud-Sitzung aus dem Terminal erstellen](/docs/de/claude-code-on-the-web#from-terminal-to-cloud), und wenn Sie einen Befehl absenden, der Cloud-Sitzungen benötigt, wie `/teleport`, `/remote-env` oder `/web-setup`. Vor v2.1.268 lieferte das Absenden eines dieser Befehle stattdessen [`Unknown command`](#unknown-command).

2928 2951

2929Dies ist eine serverseitige Organisationsrichtlinie, daher kann sie nicht aus lokalen Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden.2952Dies ist eine serverseitige Organisationsrichtlinie und kann daher nicht durch lokale Einstellungen, Umgebungsvariablen oder CLI-Flags überschrieben werden.

2930 2953

2931Wenn Claude Code die Richtlinie Ihrer Organisation noch nicht geladen hat oder sie nicht abrufen kann, antworten diese Befehle stattdessen mit `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.`2954Wenn Claude Code die Richtlinie Ihrer Organisation noch nicht geladen hat oder sie nicht abrufen kann, antworten diese Befehle stattdessen mit `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.`.

2932 2955

2933**Was zu tun ist:**2956**Was zu tun ist:**

2934 2957

2935* Bitten Sie einen [Besitzer](/docs/de/server-managed-settings#access-control) in Ihrer Organisation, Cloud-Sitzungen in den Claude Code-Administratoreinstellungen unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) zu aktivieren2958* Bitten Sie einen [Owner](/docs/de/server-managed-settings#access-control) Ihrer Organisation, Cloud-Sitzungen in den Claude Code-Admin-Einstellungen unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) zu aktivieren

2936* Wenn die Meldung besagt, dass die Richtlinie nicht überprüft werden konnte, überprüfen Sie Ihre Netzwerkverbindung, starten Sie Claude Code neu und versuchen Sie es erneut2959* Wenn die Meldung besagt, dass die Richtlinie nicht überprüft werden konnte, prüfen Sie Ihre Netzwerkverbindung, starten Sie dann Claude Code neu und versuchen Sie es erneut

2937 2960

2938<h3 id="the-json-schema-value-is-not-a-valid-json-schema">2961<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

2939 Der `--json-schema`-Wert ist kein gültiges JSON-Schema2962 Der `--json-schema`-Wert ist kein gültiges JSON-Schema

2940</h3>2963</h3>

2941 2964

2942Das Schema, das Sie an [`--json-schema`](/docs/de/cli-reference#cli-flags) in [nicht interaktivem Modus](/docs/de/headless#get-structured-output) übergeben haben, ist bei der JSON-Schema-Kompilierung fehlgeschlagen, daher beendet `claude` mit Code 1, anstatt die Eingabeaufforderung auszuführen. Vor v2.1.205 hat ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler erzeugt, und jedes Schema, das das `format`-Schlüsselwort verwendet hat, wurde als ungültig behandelt.2965Das Schema, das Sie im [nicht interaktiven Modus](/docs/de/headless#get-structured-output) an [`--json-schema`](/docs/de/cli-reference#cli-flags) übergeben haben, ist bei der JSON-Schema-Kompilierung fehlgeschlagen, daher beendet sich `claude` mit Exit-Code 1, anstatt den Prompt auszuführen. Vor v2.1.205 erzeugte ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler, und jedes Schema, das das Schlüsselwort `format` verwendete, wurde als ungültig behandelt.

2943 2966

2944```text theme={null}2967```text theme={null}

2945Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values2968Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

2946```2969```

2947 2970

2948Der 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 `"format": "email"`, sind gültig: Claude Code akzeptiert `format` als Anmerkung und erzwingt es nicht.2971Der Text nach dem zweiten Doppelpunkt ist die Diagnose des Validators und nennt das Schlüsselwort oder die Stelle, die fehlgeschlagen ist. Schemas, die das Schlüsselwort `format` verwenden, wie `"format": "email"`, sind gültig: Claude Code akzeptiert `format` als Annotation und erzwingt es nicht.

2949 2972

2950Claude 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`, und gültiges JSON, das kein Objekt ist, mit `Error: --json-schema must be a JSON object`.2973Claude Code führt vor der Schemakompilierung zwei Prüfungen aus: Es lehnt einen Wert, der kein parsebares JSON 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`.

2951 2974

2952**Was zu tun ist:**2975**Was zu tun ist:**

2953 2976

2954* Beheben Sie den Teil des Schemas, den die Diagnose benennt, und führen Sie dann den Befehl erneut aus2977* Beheben Sie den Teil des Schemas, den die Diagnose nennt, und führen Sie den Befehl dann erneut aus

2955* Siehe [Strukturierte Ausgabe abrufen](/docs/de/headless#get-structured-output) für ein funktionierendes Schema und einen Befehl2978* Unter [Strukturierte Ausgabe erhalten](/docs/de/headless#get-structured-output) finden Sie ein funktionierendes Schema und einen Befehl

2956 2979

2957<h3 id="settings-file-exceeds-the-2mib-limit">2980<h3 id="settings-file-exceeds-the-2mib-limit">

2958 Einstellungsdatei überschreitet das 2-MiB-Limit2981 Einstellungsdatei überschreitet das Limit von 2 MiB

2959</h3>2982</h3>

2960 2983

2961Die Datei, die Sie an [`--settings`](/docs/de/cli-reference#cli-flags) übergeben haben, ist größer als 2 MiB, daher beendet `claude` mit Code 1 beim Start, anstatt sie zu laden. Vor v2.1.214 hat Claude Code die Datei ohne Größenprüfung gelesen, und eine mehrere Gigabyte große Datei oder eine Gerätedatei wie `/dev/zero` hat den Speicher unbegrenzt vergrößert.2984Die Datei, die Sie an [`--settings`](/docs/de/cli-reference#cli-flags) übergeben haben, ist größer als 2 MiB, daher beendet sich `claude` beim Start mit Exit-Code 1, anstatt sie zu laden. Vor v2.1.214 las Claude Code die Datei ohne Größenprüfung, und eine mehrere Gigabyte große Datei oder eine Gerätedatei wie `/dev/zero` ließ den Speicherverbrauch unbegrenzt wachsen.

2962 2985

2963```text theme={null}2986```text theme={null}

2964Error: Settings file exceeds the 2MiB limit: /path/to/settings.json2987Error: Settings file exceeds the 2MiB limit: /path/to/settings.json

2965```2988```

2966 2989

2967Claude Code lehnt einen `--settings`-Pfad, der keine reguläre Datei ist, auf die gleiche Weise ab: Ein Gerät, FIFO oder Socket meldet `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` gefolgt vom Pfad, und ein Verzeichnis meldet einen `EISDIR`-Grund.2990Claude Code lehnt einen `--settings`-Pfad, der keine reguläre Datei ist, auf dieselbe Weise ab: Ein Gerät, ein FIFO oder ein Socket meldet `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))`, gefolgt vom Pfad, und ein Verzeichnis meldet einen `EISDIR`-Grund.

2968 2991

2969**Was zu tun ist:**2992**Was zu tun ist:**

2970 2993

2971* Zeigen Sie `--settings` auf eine reguläre JSON-Einstellungsdatei unter 2 MiB. Siehe [Einstellungen](/docs/de/settings) für das Format.2994* Verweisen Sie `--settings` auf eine reguläre JSON-Einstellungsdatei unter 2 MiB. Das Format finden Sie unter [Einstellungen](/docs/de/settings).

2972 2995

2973<h3 id="the-current-directory-no-longer-exists">2996<h3 id="the-current-directory-no-longer-exists">

2974 Das aktuelle Verzeichnis existiert nicht mehr2997 Das aktuelle Verzeichnis existiert nicht mehr

2975</h3>2998</h3>

2976 2999

2977Sie haben `claude` aus einem Verzeichnis gestartet, das nach dem Betreten durch Ihre Shell gelöscht oder verschoben wurde, beispielsweise ein Worktree oder ein temporäres Verzeichnis, das eine andere Shell entfernt hat. Claude Code kann sein Arbeitsverzeichnis nicht lesen, daher beendet es mit Code 1 vor dem Start der Sitzung, sowohl im interaktiven als auch im [nicht interaktiven](/docs/de/headless) Modus. Vor v2.1.239 ist Claude Code mit minifiziertem Bundle-Quellcode und einem rohen `ENOENT ... uv_cwd`-Stack auf stderr abgestürzt, anstatt diese Meldung anzuzeigen.3000Sie haben `claude` aus einem Verzeichnis gestartet, das gelöscht oder verschoben wurde, nachdem Ihre Shell es betreten hatte, zum Beispiel ein Worktree oder ein temporäres Verzeichnis, das eine andere Shell entfernt hat. Claude Code kann sein Arbeitsverzeichnis nicht lesen und beendet sich daher mit Exit-Code 1, bevor die Sitzung startet, sowohl im interaktiven als auch im [nicht interaktiven](/docs/de/headless) Modus. Vor v2.1.239 stürzte Claude Code stattdessen mit minifiziertem Bundle-Quellcode und einem rohen `ENOENT ... uv_cwd`-Stack auf stderr ab.

2978 3001

2979```text theme={null}3002```text theme={null}

2980The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.3003The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.

2981error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.3004error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.

2982```3005```

2983 3006

2984Die Ursache und die Lösung sind für beide Formen gleich.3007Ursache und Lösung sind für beide Formen gleich.

2985 3008

2986Wenn Claude Code das Arbeitsverzeichnis aus einem anderen Grund nicht lesen kann, z. B. aufgrund einer Berechtigungsänderung, benennt die Meldung stattdessen den Fehlercode: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`3009Wenn Claude Code das Arbeitsverzeichnis aus einem anderen Grund nicht lesen kann, etwa wegen einer geänderten Berechtigung, nennt die Meldung stattdessen den Fehlercode: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`

2987 3010

2988Auf macOS bedeutet `EPERM` für ein Verzeichnis in `~/Desktop`, `~/Documents`, `~/Downloads` oder iCloud Drive normalerweise, dass macOS Ihre Terminal-App von diesem Ordner blockiert. Andere Befehle, die diesen Ordner lesen, schlagen auf die gleiche Weise fehl: `ls` dort meldet `Operation not permitted`, auch mit `sudo`.3011Unter macOS bedeutet `EPERM` für ein Verzeichnis in `~/Desktop`, `~/Documents`, `~/Downloads` oder iCloud Drive in der Regel, dass macOS Ihrer Terminal-App den Zugriff auf diesen Ordner verweigert. Andere Befehle, die diesen Ordner lesen, schlagen auf dieselbe Weise fehl: `ls` meldet dort `Operation not permitted`, selbst mit `sudo`.

2989 3012

2990**Was zu tun ist:**3013**Was zu tun ist:**

2991 3014

2992* Wechseln Sie zu einem Verzeichnis, das existiert, z. B. Ihr Home- oder Projektverzeichnis, und führen Sie dann `claude` erneut aus3015* Wechseln Sie in ein existierendes Verzeichnis, etwa Ihr Home-Verzeichnis oder Ihr Projektverzeichnis, und führen Sie dann `claude` erneut aus

2993* Wenn das Verzeichnis unter demselben Pfad neu erstellt wurde, hält Ihre Shell immer noch das gelöschte. Führen Sie `cd "$PWD"` aus oder verlassen Sie das Verzeichnis und betreten Sie es erneut, dann führen Sie `claude` erneut aus3016* Wenn das Verzeichnis unter demselben Pfad neu erstellt wurde, hält Ihre Shell noch das gelöschte fest. Führen Sie `cd "$PWD"` aus oder verlassen Sie das Verzeichnis und betreten Sie es erneut, und führen Sie dann `claude` erneut aus

2994* Für `EPERM` auf macOS beenden Sie Ihre Terminal-App mit Cmd+Q, öffnen Sie sie erneut, kehren Sie zu diesem Ordner zurück und führen Sie `claude` aus. Wenn `ls` in diesem Ordner immer noch fehlschlägt, öffnen Sie **Systemeinstellungen > Datenschutz & Sicherheit > Dateien und Ordner**, aktivieren Sie den Ordner für Ihre Terminal-App und öffnen Sie das Terminal erneut3017* Bei `EPERM` unter macOS beenden Sie Ihre Terminal-App mit Cmd+Q, öffnen Sie sie erneut, kehren Sie zu diesem Ordner zurück und führen Sie `claude` aus. Wenn `ls` in diesem Ordner weiterhin fehlschlägt, öffnen Sie **Systemeinstellungen > Datenschutz & Sicherheit > Dateien und Ordner**, aktivieren Sie den Ordner für Ihre Terminal-App und öffnen Sie das Terminal dann erneut

2995 3018

2996<h3 id="temp-directory-refused-or-cannot-be-created">3019<h3 id="temp-directory-refused-or-cannot-be-created">

2997 Temp-Verzeichnis verweigert oder kann nicht erstellt werden3020 Temporäres Verzeichnis abgelehnt oder kann nicht erstellt werden

2998</h3>3021</h3>

2999 3022

3000Auf macOS und Linux erstellt Claude Code beim Start ein privates Temp-Verzeichnis, `claude-<uid>` unter dem System-Temp-Verzeichnis oder der [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars)-Überschreibung. Wenn das Verzeichnis nicht erstellt werden kann oder ein Eintrag, der bereits unter diesem Pfad existiert, die Sicherheitsprüfungen nicht besteht, druckt Claude Code den Fehler auf stderr und beendet sich mit Code 1, anstatt die Sitzung zu starten:3023Unter macOS und Linux erstellt Claude Code beim Start ein privates temporäres Verzeichnis, `claude-<uid>`, unterhalb des temporären Systemverzeichnisses oder der Überschreibung durch [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars). Wenn das Verzeichnis nicht erstellt werden kann oder ein bereits unter diesem Pfad vorhandener Eintrag die Sicherheitsprüfungen nicht besteht, gibt Claude Code den Fehler auf stderr aus und beendet sich mit Exit-Code 1, anstatt die Sitzung zu starten:

3001 3024

3002```text wrap theme={null}3025```text wrap theme={null}

3003ENOSPC: no space left on device, mkdir '/tmp/claude-501'3026ENOSPC: no space left on device, mkdir '/tmp/claude-501'

3011 3034

3012**Was zu tun ist:**3035**Was zu tun ist:**

3013 3036

3014* Für `ENOSPC` geben Sie Speicherplatz auf dem Volume frei, das das Temp-Verzeichnis enthält3037* Bei `ENOSPC` geben Sie Speicherplatz auf dem Volume frei, das das temporäre Verzeichnis enthält

3015* Für die `Refusing to use it`-Formen entfernen Sie den benannten Eintrag selbst, nicht das, auf das ein Link zeigt, und starten Sie Claude Code erneut; für die `owned by uid`-Form kann nur ein Administrator oder dieser Benutzer ihn entfernen3038* Bei den Formen mit `Refusing to use it` entfernen Sie den genannten Eintrag selbst, nicht das Ziel eines Links, und starten Sie Claude Code erneut; bei der Form `owned by uid` kann nur ein Administrator oder der betreffende Benutzer ihn entfernen

3016* Für `is not readable` führen Sie `chmod 0700` auf dem benannten Verzeichnis aus oder entfernen Sie es und starten Sie erneut3039* Bei `is not readable` führen Sie `chmod 0700` für das genannte Verzeichnis aus oder entfernen Sie es und starten Sie erneut

3017* Setzen Sie in jedem dieser Fälle [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars) auf ein Verzeichnis, das Sie kontrollieren, und starten Sie Claude Code erneut, wobei Sie den abgelehnten Pfad allein lassen3040* In all diesen Fällen können Sie [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars) auf ein Verzeichnis setzen, das Sie kontrollieren, und Claude Code erneut starten, ohne den abgelehnten Pfad anzutasten

3018 3041

3019<h3 id="directory-couldnt-be-resolved-to-a-real-location">3042<h3 id="directory-couldnt-be-resolved-to-a-real-location">

3020 Verzeichnis konnte nicht zu einem echten Ort aufgelöst werden3043 Verzeichnis konnte nicht in einen realen Speicherort aufgelöst werden

3021</h3>3044</h3>

3022 3045

3023Sie haben `/add-dir` für ein Unterverzeichnis Ihres Arbeitsverzeichnisses ausgeführt, und Claude Code konnte das Verzeichnis nicht zu seinem echten Ort auflösen.3046Sie haben `/add-dir` für ein Unterverzeichnis Ihres Arbeitsverzeichnisses ausgeführt, und Claude Code konnte das Verzeichnis nicht in seinen realen Speicherort auflösen.

3024 3047

3025Sie haben bereits Dateizugriff auf ein Unterverzeichnis des Arbeitsverzeichnisses, daher lädt `/add-dir` nur seine Skills, Befehle und Agenten. Bevor sie geladen werden, überprüft Claude Code, dass der echte Ort des Verzeichnisses, mit aufgelösten Symlinks, sich im Arbeitsverzeichnis befindet. Wenn Claude Code diesen Ort nicht auflösen kann, lädt es nichts und zeigt diese Meldung:3048Auf ein Unterverzeichnis des Arbeitsverzeichnisses haben Sie bereits Dateizugriff, daher lädt `/add-dir` nur dessen Skills, Befehle und Agenten. Bevor Claude Code sie lädt, prüft es, ob der reale Speicherort des Verzeichnisses, mit aufgelösten Symlinks, innerhalb des Arbeitsverzeichnisses liegt. Wenn Claude Code diesen Speicherort nicht auflösen kann, lädt es nichts und zeigt diese Meldung an:

3026 3049

3027```text theme={null}3050```text theme={null}

3028packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.3051packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.

3030 3053

3031**Was zu tun ist:**3054**Was zu tun ist:**

3032 3055

3033* Überprüfen Sie, dass der Pfad ein echtes Verzeichnis im Arbeitsverzeichnis benennt, und führen Sie dann `/add-dir` erneut aus3056* Prüfen Sie, ob der Pfad ein reales Verzeichnis innerhalb des Arbeitsverzeichnisses bezeichnet, und führen Sie `/add-dir` dann erneut aus

3034* Die Meldung ändert Ihren Dateizugriff nicht; sie meldet nur, dass der `.claude/`-Inhalt des Verzeichnisses nicht geladen wurde3057* Die Meldung ändert Ihren Dateizugriff nicht; sie meldet nur, dass der `.claude/`-Inhalt des Verzeichnisses nicht geladen wurde

3035 3058

3036Vor v2.1.261 erschien diese Meldung auch für jeden `/add-dir <subdirectory>`, wenn das Arbeitsverzeichnis auf einem `/net/<host>`-Automount war, wo Claude Code sich weigert, Pfade nach Design aufzulösen; das Verzeichnis war in Ordnung und ein erneuter Versuch konnte nicht helfen.3059Vor v2.1.261 erschien diese Meldung auch bei jedem `/add-dir <subdirectory>`, wenn sich das Arbeitsverzeichnis auf einem `/net/<host>`-Automount befand, wo Claude Code das Auflösen von Pfaden absichtlich ablehnt; das Verzeichnis war in Ordnung, und ein erneuter Versuch konnte nicht helfen.

3037 3060

3038<h3 id="workspace-not-trusted-when-starting-remote-control">3061<h3 id="workspace-not-trusted-when-starting-remote-control">

3039 Arbeitsbereich nicht vertraut beim Starten der Remote-Steuerung3062 Workspace nicht vertrauenswürdig beim Start von Remote Control

3040</h3>3063</h3>

3041 3064

3042Sie haben den [Remote-Steuerungs](/docs/de/remote-control)-Servermodus mit `claude remote-control` oder seinem `claude rc`-Alias in einem Verzeichnis gestartet, das Sie nicht vertraut haben, und der Befehl konnte Sie nicht fragen, ob Sie ihm vertrauen. Zum Beispiel ist die Standardeingabe oder Standardausgabe des Befehls kein Terminal, weil eine von ihnen umgeleitet oder gepipet wird. Der Befehl beendet sich mit Code 1:3065Sie haben den Servermodus von [Remote Control](/docs/de/remote-control) mit `claude remote-control` oder dessen Alias `claude rc` in einem Verzeichnis gestartet, dem Sie nicht vertraut haben, und der Befehl konnte Sie nicht fragen, ob Sie ihm vertrauen möchten. Zum Beispiel ist die Standardeingabe oder Standardausgabe des Befehls kein Terminal, weil eine davon umgeleitet oder per Pipe weitergeleitet wird. Der Befehl beendet sich mit Exit-Code 1:

3043 3066

3044```text theme={null}3067```text theme={null}

3045Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.3068Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.

3046```3069```

3047 3070

3048Zwei Varianten, die auch mit `Error: Workspace not trusted.` beginnen, werden auch in einem Terminal angezeigt, das zu klein ist, um anzuzeigen, was das Vertrauen in das Verzeichnis aktiviert, oder eines, das seine Größe nicht gemeldet hat. Vergrößern Sie das Fenster oder wechseln Sie zu einem normalen Terminal-Fenster, dann führen Sie `claude rc` erneut aus.3071Zwei Varianten, die ebenfalls mit `Error: Workspace not trusted.` beginnen, erscheinen in einem Terminal, das zu klein ist, um anzuzeigen, was das Vertrauen in das Verzeichnis aktiviert, oder in einem, das seine Größe nicht gemeldet hat. Vergrößern Sie das Fenster oder wechseln Sie zu einem normalen Terminalfenster und führen Sie dann `claude rc` erneut aus.

3049 3072

3050In Ihrem Home-Verzeichnis ist die Meldung anders, da der Dialog zur Arbeitsbereichsvertrauenswürdigkeit nie Vertrauen für das Home-Verzeichnis speichert, daher kann das Akzeptieren dort diese Überprüfung nicht erfüllen. Vor v2.1.214 zeigte das Home-Verzeichnis die obige Meldung, deren Rat dort nicht erfolgreich sein kann.3073In Ihrem Home-Verzeichnis ist die Meldung eine andere, da der Vertrauensdialog für den Workspace das Vertrauen für das Home-Verzeichnis nie speichert, sodass das Akzeptieren dort diese Prüfung nicht erfüllen kann. Vor v2.1.214 zeigte das Home-Verzeichnis die obige Meldung, deren Rat dort nicht zum Erfolg führen kann.

3051 3074

3052```text theme={null}3075```text theme={null}

3053Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).3076Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).

3054```3077```

3055 3078

3056Wenn Sie `n` antworten oder die Eingabetaste bei der [`Trust <directory>?`-Frage](/docs/de/remote-control#requirements) drücken, druckt der Befehl eine `Remote Control did not start`-Meldung, die das Verzeichnis benennt, und beendet sich mit Code 1. Führen Sie `claude rc` erneut aus, um `y` zu antworten.3079Wenn Sie bei der [Frage `Trust <directory>?`](/docs/de/remote-control#requirements) mit `n` antworten oder Enter drücken, gibt der Befehl eine `Remote Control did not start`-Meldung aus, die das Verzeichnis nennt, und beendet sich mit Exit-Code 1. Führen Sie `claude rc` erneut aus, um mit `y` zu antworten.

3057 3080

3058**Was zu tun ist:**3081**Was zu tun ist:**

3059 3082

3060* Vertrauen Sie dem Verzeichnis zuerst von einem Terminal aus: Führen Sie `claude rc` dort aus und antworten Sie `y`, oder führen Sie `claude` dort aus und akzeptieren Sie den [Dialog zur Arbeitsbereichsvertrauenswürdigkeit](/docs/de/permissions#project-allow-rules-and-workspace-trust), dann führen Sie Ihren ursprünglichen Befehl erneut aus3083* Vertrauen Sie dem Verzeichnis zuerst in einem Terminal: Führen Sie dort `claude rc` aus und antworten Sie mit `y`, oder führen Sie dort `claude` aus und akzeptieren Sie den [Vertrauensdialog für den Workspace](/docs/de/permissions#project-allow-rules-and-workspace-trust), und führen Sie dann Ihren ursprünglichen Befehl erneut aus

3061* Wechseln Sie in Ihrem Home-Verzeichnis zu einem Projektverzeichnis und starten Sie die Remote-Steuerung dort3084* Wechseln Sie in Ihrem Home-Verzeichnis in ein Projektverzeichnis und starten Sie Remote Control dort

3062 3085

3063Vor v2.1.284 fragte der Befehl nie, auch nicht in einem Terminal.3086Vor v2.1.284 fragte der Befehl nie nach, selbst in einem Terminal.

3064 3087

3065<h3 id="not-carried-over-to-the-sessions-remote-control-starts">3088<h3 id="not-carried-over-to-the-sessions-remote-control-starts">

3066 Nicht übertragen auf die Sitzungen, die Remote-Steuerung startet3089 Wird nicht an die von Remote Control gestarteten Sitzungen weitergegeben

3067</h3>3090</h3>

3068 3091

3069Sie haben [Remote-Steuerung](/docs/de/remote-control) mit einem globalen `claude`-Flag vor dem `remote-control`-Verb gestartet, eines, das die Sitzungen einschränken oder konfigurieren würde, die Remote-Steuerung startet, wie `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` oder `--mcp-config`. Ein Flag, das vor dem Verb platziert ist, erreicht diese Sitzungen nie. Claude Code weigert sich zu starten, anstatt es zu starten, und benennt das Flag:3092Sie haben [Remote Control](/docs/de/remote-control) mit einem globalen `claude`-Flag vor dem Verb `remote-control` gestartet, das die von Remote Control gestarteten Sitzungen einschränken oder konfigurieren würde, etwa `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` oder `--mcp-config`. Ein vor dem Verb platziertes Flag erreicht diese Sitzungen nie. Claude Code verweigert stattdessen den Start und nennt das Flag:

3070 3093

3071```text theme={null}3094```text theme={null}

3072Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).3095Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).

3073```3096```

3074 3097

3075Claude Code weigert sich nicht bei globalen Flags, die harmlos zu löschen sind, wie `--verbose`, `--model` oder ein von einem Wrapper injiziertes `--session-id` oder `--plugin-dir`: Es ignoriert sie und Remote-Steuerung startet.3098Claude Code lehnt globale Flags nicht ab, deren Wegfall unbedenklich ist, etwa `--verbose`, `--model` oder ein von einem Wrapper eingefügtes `--session-id` oder `--plugin-dir`: Es ignoriert sie, und Remote Control startet.

3076 3099

3077Claude Code weigert sich auch zu starten für ein globales Flag, das es noch nicht als harmlos erkennt, daher kann ein Flag, das in einer neueren Version hinzugefügt wurde, in dieser Meldung erscheinen, bis eine spätere Version es als harmlos markiert.3100Claude Code verweigert den Start auch bei einem globalen Flag, das es noch nicht als unbedenklich erkennt, sodass ein in einem neueren Release hinzugefügtes Flag in dieser Meldung erscheinen kann, bis ein späteres Release es als unbedenklich kennzeichnet.

3078 3101

3079**Was zu tun ist:**3102**Was zu tun ist:**

3080 3103

3081* Entfernen Sie das Flag vor dem Verb und übergeben Sie [Remote-Steuerungs eigene Optionen](/docs/de/remote-control#start-a-remote-control-session) danach; `claude remote-control --help` listet sie auf3104* Entfernen Sie das Flag vor dem Verb und übergeben Sie [die eigenen Optionen von Remote Control](/docs/de/remote-control#start-a-remote-control-session) danach; `claude remote-control --help` listet sie auf

3082* Wenn das abgelehnte Flag `--permission-mode` ist, führen Sie `claude remote-control --permission-mode <mode>` aus, um den Berechtigungsmodus für die Sitzungen festzulegen, die Remote-Steuerung startet3105* Wenn das abgelehnte Flag `--permission-mode` ist, führen Sie `claude remote-control --permission-mode <mode>` aus, um den Berechtigungsmodus für die von Remote Control gestarteten Sitzungen festzulegen

3083 3106

3084Vor v2.1.248 akzeptierte `claude remote-control` seine eigenen Flags nicht, wenn ein globales Flag zuerst kam, und der Befehl schlug mit einem Fehler für unbekannte Optionen fehl.3107Vor v2.1.248 akzeptierte `claude remote-control` keine eigenen Flags, wenn ein globales Flag voranstand, und der Befehl schlug mit einem `unknown option`-Fehler fehl.

3085 3108

3086<h3 id="claude-import-is-not-yet-available-in-this-build">3109<h3 id="claude-import-is-not-yet-available-in-this-build">

3087 claude import ist in diesem Build noch nicht verfügbar3110 claude import ist in diesem Build noch nicht verfügbar

3088</h3>3111</h3>

3089 3112

3090Sie haben [`claude import`](/docs/de/cli-reference#cli-commands) ausgeführt, und Claude Code hat den Import-Flow ausgeschaltet gefunden, daher beendet der Befehl mit Code 1, anstatt den Import zu starten. Vor v2.1.222 hat ein Build mit ausgeschaltetem Import-Flow `import` als Eingabeaufforderung behandelt und eine interaktive Sitzung gestartet, anstatt diese Meldung zu drucken.3113Sie haben [`claude import`](/docs/de/cli-reference#cli-commands) ausgeführt, und Claude Code hat festgestellt, dass der Importablauf ausgeschaltet ist, daher beendet sich der Befehl mit Exit-Code 1, anstatt den Import zu starten. Vor v2.1.222 behandelte ein Build mit ausgeschaltetem Importablauf `import` als Prompt und startete eine interaktive Sitzung, anstatt diese Meldung auszugeben.

3091 3114

3092```text theme={null}3115```text theme={null}

3093`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.3116`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.

3094```3117```

3095 3118

3096Claude Code schaltet `claude import` durch ein Feature-Flag ein, das es von Anthropic abruft und auf der Festplatte zwischenspeichert. Diese Meldung bedeutet, dass der zwischengespeicherte Wert ausgeschaltet ist. Die Ursache ist normalerweise eine der folgenden:3119Claude Code schaltet `claude import` über ein Feature-Flag ein, das es von Anthropic abruft und auf der Festplatte zwischenspeichert. Diese Meldung bedeutet, dass der zwischengespeicherte Wert ausgeschaltet ist. Die Ursache ist in der Regel eine der folgenden:

3097 3120

3098* Sie haben seit der Installation keine Sitzung gestartet, daher hat Claude Code das Flag noch nicht abgerufen. Der erste `claude import` kann dies drucken, auch wenn die Funktion für Sie verfügbar ist.3121* Sie haben seit der Installation keine Sitzung gestartet, daher hat Claude Code das Flag noch nicht abgerufen. Das erste `claude import` kann dies ausgeben, selbst wenn die Funktion für Sie verfügbar ist.

3099* Sie verwenden Claude Code über Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform auf AWS, oder über ein [Claude-Apps-Gateway](/docs/de/claude-apps-gateway#availability-and-limitations). Claude Code ruft Feature-Flags in diesen Sitzungen nicht ab, daher bleibt `claude import` nicht verfügbar.3122* Sie verwenden Claude Code über Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform on AWS oder über ein [Claude apps gateway](/docs/de/claude-apps-gateway#availability-and-limitations). Claude Code ruft in diesen Sitzungen keine Feature-Flags ab, daher bleibt `claude import` nicht verfügbar.

3100* Sie haben `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` oder [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/de/env-vars) gesetzt, was das Abrufen von Feature-Flags deaktiviert, daher bleibt `claude import` nicht verfügbar.3123* Sie haben `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` oder [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/de/env-vars) gesetzt, die das Abrufen von Feature-Flags ausschalten, daher bleibt `claude import` nicht verfügbar.

3101 3124

3102**Was zu tun ist:**3125**Was zu tun ist:**

3103 3126

3104* Starten Sie bei einer Neuinstallation `claude`, warten Sie, bis die Sitzung geladen ist, beenden Sie sie, und führen Sie `claude import` erneut aus3127* Starten Sie bei einer Neuinstallation `claude`, warten Sie, bis die Sitzung geladen ist, beenden Sie sie und führen Sie `claude import` erneut aus

3105* Wo das Abrufen von Feature-Flags ausgeschaltet bleibt, richten Sie die Konfiguration selbst ein: Fügen Sie MCP-Server mit [`claude mcp add`](/docs/de/mcp#installing-mcp-servers) hinzu, und erstellen Sie die [`CLAUDE.md`-Dateien](/docs/de/memory#how-claude-md-files-load), [Skills und Befehle](/docs/de/skills#where-skills-live) und [Subagenten](/docs/de/sub-agents#choose-the-subagent-scope), die Sie übertragen möchten. Die Meldung benennt auch `~/.claude/settings.json`. Von der Konfiguration, die `claude import` überträgt, enthält diese Datei nur den [Berechtigungsmodus](/docs/de/settings-reference#permission-settings); Claude Code liest MCP-Server nicht daraus.3128* Wo das Abrufen von Feature-Flags ausgeschaltet bleibt, richten Sie die Konfiguration selbst ein: Fügen Sie MCP-Server mit [`claude mcp add`](/docs/de/mcp#installing-mcp-servers) hinzu und erstellen Sie die [`CLAUDE.md`-Dateien](/docs/de/memory#how-claude-md-files-load), [Skills und Befehle](/docs/de/skills#where-skills-live) sowie [Subagenten](/docs/de/sub-agents#choose-the-subagent-scope), die Sie übernehmen möchten. Die Meldung nennt auch `~/.claude/settings.json`. Von der Konfiguration, die `claude import` übernimmt, enthält diese Datei nur den [Berechtigungsmodus](/docs/de/settings-reference#permission-settings); Claude Code liest keine MCP-Server daraus.

3106 3129

3107<h3 id="could-not-read-claude-code-config">3130<h3 id="could-not-read-claude-code-config">

3108 Claude Code-Konfiguration konnte nicht gelesen werden3131 Claude Code-Konfiguration konnte nicht gelesen werden

3109</h3>3132</h3>

3110 3133

3111Sie haben [`claude import`](/docs/de/cli-reference#cli-commands) ausgeführt, während Claude Code `~/.claude.json` nicht analysieren konnte, die Datei, in der es Ihren Login und den projektspezifischen Status speichert. Der Unterbefehl liest diese Datei, um die Verfügbarkeit zu überprüfen, zeigt aber nicht den Wiederherstellungsdialog an, den die interaktive Sitzung zeigt, daher beendet er mit Code 1. Vor v2.1.222 hat `claude import` mit einer nicht lesbaren Konfigurationsdatei eine interaktive Sitzung gestartet, deren Wiederherstellungsdialog die Datei behandelt hat.3134Sie haben [`claude import`](/docs/de/cli-reference#cli-commands) ausgeführt, während Claude Code `~/.claude.json` nicht parsen konnte, die Datei, in der es Ihre Anmeldung und den Zustand pro Projekt speichert. Der Unterbefehl liest diese Datei, um die Verfügbarkeit zu prüfen, zeigt aber nicht den Wiederherstellungsdialog an, den die interaktive Sitzung anzeigt, daher beendet er sich mit Exit-Code 1. Vor v2.1.222 startete `claude import` bei einer nicht lesbaren Konfigurationsdatei eine interaktive Sitzung, deren Wiederherstellungsdialog die Datei behandelte.

3112 3135

3113```text theme={null}3136```text theme={null}

3114Could not read Claude Code config — run `claude` with no arguments to recover it.3137Could not read Claude Code config — run `claude` with no arguments to recover it.

3117**Was zu tun ist:**3140**Was zu tun ist:**

3118 3141

3119* Führen Sie `claude` ohne Argumente aus. Claude Code erkennt die ungültige Datei und bietet an, sie zurückzusetzen. Führen Sie dann `claude import` erneut aus.3142* Führen Sie `claude` ohne Argumente aus. Claude Code erkennt die ungültige Datei und bietet an, sie zurückzusetzen. Führen Sie dann `claude import` erneut aus.

3120* Um manuelle Änderungen zu behalten, die Sie vorgenommen haben, beheben Sie die JSON-Syntax in `~/.claude.json` in einem Editor und führen Sie dann `claude import` erneut aus3143* Um manuelle Änderungen beizubehalten, die Sie vorgenommen haben, beheben Sie stattdessen die JSON-Syntax in `~/.claude.json` in einem Editor und führen Sie `claude import` dann erneut aus

3121 3144

3122<h3 id="could-not-import-a-server-from-claude-desktop">3145<h3 id="could-not-import-a-server-from-claude-desktop">

3123 Server konnte nicht aus Claude Desktop importiert werden3146 Ein Server aus Claude Desktop konnte nicht importiert werden

3124</h3>3147</h3>

3125 3148

3126Claude Code konnte einen der Server, die Sie in `claude mcp add-from-claude-desktop` ausgewählt haben, nicht hinzufügen. Der Befehl importiert immer noch die anderen ausgewählten Server und druckt eine Zeile pro Server, den er nicht hinzufügen konnte. Vor v2.1.205 hat der erste Server, der fehlgeschlagen ist, den Import gestoppt.3149Claude Code konnte einen der Server, die Sie in `claude mcp add-from-claude-desktop` ausgewählt haben, nicht hinzufügen. Der Befehl importiert die anderen ausgewählten Server trotzdem und gibt eine Zeile pro Server aus, den er nicht hinzufügen konnte. Vor v2.1.205 stoppte der erste fehlgeschlagene Server den Import.

3127 3150

3128```text theme={null}3151```text theme={null}

3129Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3152Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

3130```3153```

3131 3154

3132Der 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](/docs/de/managed-mcp) Ihrer Organisation blockiert wird.3155Der Text nach dem Servernamen ist der Grund. Der häufigste ist die Namensprüfung: Claude Desktop erlaubt in Servernamen Zeichen wie Leerzeichen und Punkte, die `claude mcp` auf Buchstaben, Ziffern, Bindestriche und Unterstriche beschränkt. Weitere Gründe sind eine Serverkonfiguration, die die Validierung nicht besteht, und ein Server, der durch die [MCP-Richtlinie](/docs/de/managed-mcp) Ihrer Organisation blockiert wird.

3133 3156

3134**Was zu tun ist:**3157**Was zu tun ist:**

3135 3158

3136* 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 aus3159* Benennen Sie den Server in `claude_desktop_config.json` so um, dass er nur Buchstaben, Ziffern, Bindestriche und Unterstriche verwendet, und führen Sie dann `claude mcp add-from-claude-desktop` erneut aus

3137* Fügen Sie diesen Server direkt mit `claude mcp add` oder `claude mcp add-json` unter einem gültigen Namen hinzu. Siehe [MCP-Server aus Claude Desktop importieren](/docs/de/mcp#import-mcp-servers-from-claude-desktop).3160* Fügen Sie diesen Server direkt mit `claude mcp add` oder `claude mcp add-json` unter einem gültigen Namen hinzu. Siehe [MCP-Server aus Claude Desktop importieren](/docs/de/mcp#import-mcp-servers-from-claude-desktop).

3138 3161

3139<h3 id="cannot-add-mcp-server-to-the-managed-scope">3162<h3 id="cannot-add-mcp-server-to-the-managed-scope">

3140 MCP-Server kann nicht zum verwalteten Bereich hinzugefügt werden3163 MCP-Server kann nicht zum verwalteten Geltungsbereich hinzugefügt werden

3141</h3>3164</h3>

3142 3165

3143Sie haben `claude mcp add` oder `claude mcp add-json` mit `--scope managed` ausgeführt. Dieser Bereich enthält die Server, die Ihre Organisation über die verwaltete Einstellung [`managedMcpServers`](/docs/de/settings-reference#managedmcpservers) bereitstellt. Claude Code liest sie nur aus verwalteten Einstellungen, daher kann der Befehl keinen Server in diesen Bereich schreiben.3166Sie haben `claude mcp add` oder `claude mcp add-json` mit `--scope managed` ausgeführt. Dieser Geltungsbereich enthält die Server, die Ihre Organisation über die verwaltete Einstellung [`managedMcpServers`](/docs/de/settings-reference#managedmcpservers) bereitstellt. Claude Code liest sie nur aus den verwalteten Einstellungen, daher kann der Befehl keinen Server in diesen Geltungsbereich schreiben.

3144 3167

3145```text theme={null}3168```text theme={null}

3146Cannot add MCP server to scope: managed3169Cannot add MCP server to scope: managed

3148 3171

3149**Was zu tun ist:**3172**Was zu tun ist:**

3150 3173

3151* Fügen Sie den Server zu einem Bereich hinzu, in den Sie schreiben können: `local`, `user` oder `project`. Ohne `--scope` verwendet der Befehl `local`. Siehe [MCP-Installationsbereiche](/docs/de/mcp#mcp-installation-scopes)3174* Fügen Sie den Server zu einem Geltungsbereich hinzu, in den Sie schreiben können: `local`, `user` oder `project`. Ohne `--scope` verwendet der Befehl `local`. Siehe [MCP-Installationsgeltungsbereiche](/docs/de/mcp#mcp-installation-scopes)

3152* Um den Server jedem Benutzer in Ihrer Organisation bereitzustellen, fügen Sie ihn zu [`managedMcpServers`](/docs/de/settings-reference#managedmcpservers) in den verwalteten Einstellungen hinzu, die Sie bereitstellen3175* Um den Server allen Benutzern Ihrer Organisation bereitzustellen, fügen Sie ihn zu [`managedMcpServers`](/docs/de/settings-reference#managedmcpservers) in den verwalteten Einstellungen hinzu, die Sie verteilen

3153 3176

3154<h3 id="cant-read-mcp-json">3177<h3 id="cant-read-mcp-json">

3155 .mcp.json kann nicht gelesen werden3178 .mcp.json kann nicht gelesen werden

3156</h3>3179</h3>

3157 3180

3158Ein Befehl, der das Projekt [`.mcp.json`](/docs/de/mcp#project-scope) liest, wie `claude mcp add` oder `claude mcp add-json` mit `--scope project` oder `claude mcp remove`, hat festgestellt, dass die Datei in Ihrem aktuellen Verzeichnis keine reguläre Datei ist oder größer als 2 MiB ist, daher beendet er mit diesem Fehler, anstatt die Datei zu lesen.3181Ein Befehl, der die [`.mcp.json`](/docs/de/mcp#project-scope) des Projekts liest, etwa `claude mcp add` oder `claude mcp add-json` mit `--scope project` oder `claude mcp remove`, hat festgestellt, dass die Datei in Ihrem aktuellen Verzeichnis keine reguläre Datei oder größer als 2 MiB ist, daher beendet er sich mit diesem Fehler, anstatt die Datei zu lesen.

3159 3182

3160```text theme={null}3183```text theme={null}

3161Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.3184Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.

3162```3185```

3163 3186

3164Vor v2.1.257 ließ ein FIFO bei `.mcp.json` den Befehl für immer ohne Ausgabe warten, und ein Symlink zu einer Gerätedatei wie `/dev/zero` vergrößerte den Speicher, bis der Prozess beendet wurde.3187Vor v2.1.257 ließ ein FIFO unter `.mcp.json` den Befehl ohne Ausgabe endlos warten, und ein Symlink auf eine Gerätedatei wie `/dev/zero` ließ den Speicherverbrauch wachsen, bis der Prozess beendet wurde.

3165 3188

3166**Was zu tun ist:**3189**Was zu tun ist:**

3167 3190

3168* Überprüfen Sie, was sich bei `.mcp.json` in Ihrem aktuellen Verzeichnis befindet. Ersetzen Sie es durch eine gewöhnliche JSON-Datei im [Projektbereich-Format](/docs/de/mcp#project-scope) oder löschen Sie es, und führen Sie dann den Befehl erneut aus.3191* Prüfen Sie, was sich unter `.mcp.json` in Ihrem aktuellen Verzeichnis befindet. Ersetzen Sie es durch eine gewöhnliche JSON-Datei im [Format für den Projekt-Geltungsbereich](/docs/de/mcp#project-scope) oder löschen Sie es, und führen Sie den Befehl dann erneut aus.

3169 3192

3170<h3 id="mcp-server-was-not-saved-or-removed">3193<h3 id="mcp-server-was-not-saved-or-removed">

3171 MCP-Server war nicht gespeichert oder entfernt3194 MCP-Server wurde nicht gespeichert oder entfernt

3172</h3>3195</h3>

3173 3196

3174Sie haben `claude mcp add`, `claude mcp add-json` oder `claude mcp remove` für einen Server im `user` oder `local` [Bereich](/docs/de/mcp#mcp-installation-scopes) ausgeführt. Beide Bereiche werden in `~/.claude.json` gespeichert, und die Änderung ist nicht in dieser Datei, wenn Claude Code sie nach dem Schreiben zurückliest. Der Befehl beendet sich mit diesem Fehler, anstatt seine Erfolgsmeldung zu drucken.3197Sie haben `claude mcp add`, `claude mcp add-json` oder `claude mcp remove` für einen Server im [Geltungsbereich](/docs/de/mcp#mcp-installation-scopes) `user` oder `local` ausgeführt. Beide Geltungsbereiche werden in `~/.claude.json` gespeichert, und die Änderung ist nicht in dieser Datei enthalten, wenn Claude Code sie nach dem Schreiben zurückliest. Der Befehl beendet sich mit diesem Fehler anstelle seiner Erfolgszeile.

3175 3198

3176```text theme={null}3199```text theme={null}

3177MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.3200MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.

3178```3201```

3179 3202

3180Nach einem Remove lautet die Meldung `was not removed from` und endet mit `then remove the server again`. Für einen `local`-Bereich-Server wird der Pfad gefolgt vom Projektverzeichnis, zu dem der Eintrag gehört, als `(local scope for /path/to/project)`.3203Nach einem Entfernen lautet die Meldung `was not removed from` und endet mit `then remove the server again`. Bei einem Server im Geltungsbereich `local` folgt auf den Pfad das Projektverzeichnis, zu dem der Eintrag gehört, als `(local scope for /path/to/project)`.

3181 3204

3182Vor v2.1.283 meldeten `claude mcp add`, `claude mcp add-json` und `claude mcp remove` Erfolg, auch wenn die Änderung die Datei nicht erreichte.3205Vor v2.1.283 meldeten `claude mcp add`, `claude mcp add-json` und `claude mcp remove` Erfolg, selbst wenn die Änderung die Datei nicht erreichte.

3183 3206

3184**Was zu tun ist:**3207**Was zu tun ist:**

3185 3208

3186* Machen Sie die Datei, die die Meldung benennt, beschreibbar, oder führen Sie den Befehl außerhalb der Sandbox aus, und führen Sie dann denselben Add- oder Remove-Befehl erneut aus.3209* Machen Sie die in der Meldung genannte Datei beschreibbar oder führen Sie den Befehl außerhalb der Sandbox aus, und führen Sie dann denselben Befehl zum Hinzufügen oder Entfernen erneut aus.

3187 3210

3188<h3 id="mcp-server-may-not-have-been-saved-or-removed">3211<h3 id="mcp-server-may-not-have-been-saved-or-removed">

3189 MCP-Server wurde möglicherweise nicht gespeichert oder entfernt3212 MCP-Server wurde möglicherweise nicht gespeichert oder entfernt

3190</h3>3213</h3>

3191 3214

3192Sie haben `claude mcp add`, `claude mcp add-json` oder `claude mcp remove` für einen Server im `user` oder `local` [Bereich](/docs/de/mcp#mcp-installation-scopes) ausgeführt, und Claude Code konnte `~/.claude.json` nicht zurücklesen, um die Änderung zu bestätigen. Die Änderung kann oder kann nicht auf der Festplatte sein. Der Text in Klammern ist der Fehler aus diesem Lesevorgang.3215Sie haben `claude mcp add`, `claude mcp add-json` oder `claude mcp remove` für einen Server im [Geltungsbereich](/docs/de/mcp#mcp-installation-scopes) `user` oder `local` ausgeführt, und Claude Code konnte `~/.claude.json` nicht zurücklesen, um die Änderung zu bestätigen. Die Änderung befindet sich möglicherweise auf der Festplatte, möglicherweise aber auch nicht. Der Text in Klammern ist der Fehler dieses Lesevorgangs.

3193 3216

3194```text theme={null}3217```text theme={null}

3195MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.3218MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.

3196```3219```

3197 3220

3198Nach einem Remove lautet die Meldung `may not have been removed` und endet mit `then remove the server again if it is still listed`.3221Nach einem Entfernen lautet die Meldung `may not have been removed` und endet mit `then remove the server again if it is still listed`.

3199 3222

3200Vor v2.1.283 meldeten die Befehle Erfolg, auch wenn die Änderung nicht bestätigt werden konnte.3223Vor v2.1.283 meldeten die Befehle Erfolg, selbst wenn die Änderung nicht bestätigt werden konnte.

3201 3224

3202**Was zu tun ist:**3225**Was zu tun ist:**

3203 3226

3204* Führen Sie `claude mcp get <name>` aus, um zu überprüfen, ob die Änderung auf der Festplatte ist. Für einen `local`-Bereich-Server führen Sie es aus dem Projektverzeichnis aus, zu dem der Server gehört, da der lokale Bereich pro Projekt ist.3227* Führen Sie `claude mcp get <name>` aus, um zu prüfen, ob sich die Änderung auf der Festplatte befindet. Bei einem Server im Geltungsbereich `local` führen Sie den Befehl aus dem Projektverzeichnis aus, zu dem der Server gehört, da der lokale Geltungsbereich projektbezogen ist.

3205* Wenn der Server nach einem Add fehlt oder nach einem Remove immer noch aufgelistet ist, führen Sie denselben Add- oder Remove-Befehl erneut aus.3228* Wenn der Server nach einem Hinzufügen fehlt oder nach einem Entfernen noch aufgeführt ist, führen Sie denselben Befehl zum Hinzufügen oder Entfernen erneut aus.

3206 3229

3207<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">3230<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">

3208 Server ist von Anthropic gehostet und unterstützt lokales OAuth nicht3231 Server wird von Anthropic gehostet und unterstützt kein lokales OAuth

3209</h3>3232</h3>

3210 3233

3211Sie haben eine Anmeldung für einen MCP-Server gestartet, dessen URL auf einen von Anthropic gehosteten Connector-Host zeigt, der sich über einen Drittanbieter-Identitätsanbieter authentifiziert. Diese Hosts umfassen `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com` und `gcal.mcp.claude.com`. Claude Code weigert sich, seinen lokalen OAuth-Flow für diese Hosts sowohl vom `/mcp`-Panel als auch von `claude mcp login` zu starten, da [ihre Anmeldung nur über claude.ai funktioniert](/docs/de/mcp#use-mcp-servers-from-claude-ai).3234Sie haben eine Anmeldung für einen MCP-Server gestartet, dessen URL auf einen von Anthropic gehosteten Konnektor-Host verweist, der sich über einen Identitätsanbieter eines Drittanbieters authentifiziert. Zu diesen Hosts gehören `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com` und `gcal.mcp.claude.com`. Claude Code verweigert für diese Hosts den Start seines lokalen OAuth-Ablaufs sowohl im `/mcp`-Panel als auch über `claude mcp login`, da [ihre Anmeldung nur über claude.ai funktioniert](/docs/de/mcp#use-mcp-servers-from-claude-ai).

3212 3235

3213```text theme={null}3236```text theme={null}

3214"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.3237"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.

3215```3238```

3216 3239

3217Claude Code gleicht diese Hosts nach URL ab, daher erscheint die Meldung, wenn ein Server, den Sie mit `claude mcp add` oder in `.mcp.json` hinzugefügt haben, auf einen von ihnen zeigt.

~~3218~~

3219**Was zu tun ist:**3240**Was zu tun ist:**

3220 3241

3221* Entfernen Sie Ihren Eintrag mit `claude mcp remove <name>`, damit er den claude.ai-Connector unter derselben URL nicht verbergen kann3242* Entfernen Sie Ihren Eintrag mit `claude mcp remove <name>`, damit er den claude.ai-Konnektor unter derselben URL nicht verdecken kann

3222* Nachdem Sie ihn entfernt haben, verbinden Sie den Service unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors), während Sie bei dem Konto angemeldet sind, das Sie in Claude Code verwenden. Nach der Verbindung [erscheint der Connector automatisch in Claude Code](/docs/de/mcp#use-mcp-servers-from-claude-ai), wenn Ihre aktive Authentifizierungsmethode eine claude.ai-Abonnement-Anmeldung ist3243* Verbinden Sie den Dienst nach dem Entfernen unter [claude.ai/customize/connectors](https://claude.ai/customize/connectors), während Sie mit dem Konto angemeldet sind, das Sie in Claude Code verwenden. Sobald die Verbindung besteht, [erscheint der Konnektor automatisch in Claude Code](/docs/de/mcp#use-mcp-servers-from-claude-ai), wenn Ihre aktive Authentifizierungsmethode eine Anmeldung mit einem claude.ai-Abonnement ist

3223 3244

3224<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">3245<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">

3225 Server lehnte den vom konfigurierten headersHelper erstellten Authorization-Header ab3246 Server hat den vom konfigurierten headersHelper erzeugten Authorization-Header abgelehnt

3226</h3>3247</h3>

3227 3248

3228Ein MCP-Server, dessen [`headersHelper`](/docs/de/mcp#use-dynamic-headers-for-custom-authentication) den `Authorization`-Header bereitstellt, hat die Verbindung mit HTTP 401 oder 403 beantwortet, daher meldet Claude Code die Verbindung als fehlgeschlagen. Da der Helper den `Authorization`-Header bereitstellt, [fällt Claude Code nicht auf OAuth zurück](/docs/de/mcp#authenticate-with-remote-mcp-servers) für den Server:3249Ein MCP-Server, dessen [`headersHelper`](/docs/de/mcp#use-dynamic-headers-for-custom-authentication) den `Authorization`-Header liefert, hat die Verbindung mit HTTP 401 oder 403 beantwortet, daher meldet Claude Code die Verbindung als fehlgeschlagen. Da der Helper den `Authorization`-Header liefert, [fällt Claude Code für den Server nicht auf OAuth zurück](/docs/de/mcp#authenticate-with-remote-mcp-servers):

3229 3250

3230```text theme={null}3251```text theme={null}

3231Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.3252Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.

3232```3253```

3233 3254

3234Claude Code führt den Helper bei jedem Verbindungsversuch erneut aus, daher kann ein erneuter Versuch nach einer vorübergehenden Ablehnung, wie einer Token-Rotations-Rasse, mit einer frischen Anmeldeinformation erfolgreich sein.3255Claude Code führt den Helper bei jedem Verbindungsversuch erneut aus, sodass ein erneuter Versuch nach einer vorübergehenden Ablehnung, etwa einer Race Condition bei der Token-Rotation, mit neuen Anmeldedaten erfolgreich sein kann.

3235 3256

3236**Was zu tun ist:**3257**Was zu tun ist:**

3237 3258

3238* Führen Sie den `headersHelper`-Befehl selbst so aus, wie Claude Code ihn ausführt: aus dem [Verzeichnis, in dem Claude Code ihn ausführt](/docs/de/mcp#where-the-helper-runs), mit den [Umgebungsvariablen, die Claude Code für ihn setzt](/docs/de/mcp#use-dynamic-headers-for-custom-authentication), und ohne die [Anmeldeinformationsvariablen, die Claude Code entfernt](/docs/de/mcp#which-variables-a-helper-can-read) für einen Server aus einer Projekt `.mcp.json`, einem Plugin oder einer Projekt-Agent-Datei. Überprüfen Sie, dass er einen `Authorization`-Wert druckt, den der Endpunkt des Servers akzeptiert3259* Führen Sie den `headersHelper`-Befehl selbst so aus, wie Claude Code ihn ausführt: aus dem [Verzeichnis, in dem Claude Code ihn ausführt](/docs/de/mcp#where-the-helper-runs), mit den [Umgebungsvariablen, die Claude Code dafür setzt](/docs/de/mcp#use-dynamic-headers-for-custom-authentication), und ohne die [Anmeldedaten-Variablen, die Claude Code entfernt](/docs/de/mcp#which-variables-a-helper-can-read) bei einem Server aus einer Projekt-`.mcp.json`, einem Plugin oder einer Projekt-Agentendatei. Prüfen Sie, ob er einen `Authorization`-Wert ausgibt, den der Endpunkt des Servers akzeptiert

~~3239* Nachdem Sie den Helper oder seine Anmeldeinformationsquelle behoben haben, wählen Sie den Server in `/mcp` aus und wählen Sie **Reconnect**~~3260* Nachdem Sie den Helper oder die Quelle seiner Anmeldedaten korrigiert haben, wählen Sie den Server in `/mcp` aus und wählen Sie **Reconnect**

3240 3261

3241Vor v2.1.248 führte Claude Code OAuth-Erkennung für einen Server durch, dessen Helper den `Authorization`-Header bereitstellte. Diese Erkennung konnte mit `Incompatible auth server: does not support dynamic client registration` fehlschlagen, anstatt die abgelehnte Anmeldeinformation zu melden.3262Vor v2.1.248 führte Claude Code für einen Server, dessen Helper den `Authorization`-Header lieferte, eine OAuth-Erkennung durch. Diese Erkennung konnte mit `Incompatible auth server: does not support dynamic client registration` fehlschlagen, anstatt die abgelehnten Anmeldedaten zu melden.

3242 3263

3243<h3 id="mcp-permission-prompt-tool-not-found">3264<h3 id="mcp-permission-prompt-tool-not-found">

3244 MCP-Berechtigungsaufforderungs-Tool nicht gefunden3265 MCP-Tool für Berechtigungsabfragen nicht gefunden

3245</h3>3266</h3>

3246 3267

3247Das Tool, das Sie an [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) übergeben haben, war nicht unter den verbundenen MCP-Tools, als der Lauf zuerst eine Berechtigungsentscheidung benötigte, entweder weil sein Server nie verbunden wurde oder weil kein verbundener Server ein Tool mit diesem Namen verfügbar macht. Claude Code sendet Ihre Eingabeaufforderung immer noch: Der [nicht interaktive](/docs/de/headless) Lauf beendet sich mit diesem Fehler und Exit-Code 1 beim ersten Tool-Aufruf, daher erzeugt er keine Antwort, obwohl die Anfrage gestellt wurde. Vor dem ersten Prompt wartet Claude Code bis zu dem pro-Server-Verbindungs-Timeout von 30 Sekunden, der durch [`MCP_TIMEOUT`](/docs/de/env-vars) gesetzt ist, damit dieser Server verbunden wird. Vor v2.1.206 wartete der Start nicht, bis der Server die Verbindung beendete, daher erzeugte ein langsam startender, aber gesunder Server auch diesen Fehler.3268Das Tool, das Sie an [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) übergeben haben, gehörte nicht zu den verbundenen MCP-Tools, als die Ausführung zum ersten Mal eine Berechtigungsentscheidung benötigte, entweder weil sein Server nie verbunden wurde oder weil kein verbundener Server ein Tool mit diesem Namen bereitstellt. Claude Code sendet Ihren Prompt trotzdem: Die [nicht interaktive](/docs/de/headless) Ausführung beendet sich beim ersten Tool-Aufruf mit diesem Fehler und Exit-Code 1, sodass sie keine Antwort liefert, obwohl die Anfrage gestellt wurde. Vor dem ersten Prompt wartet Claude Code bis zum Verbindungs-Timeout pro Server von 30 Sekunden, festgelegt durch [`MCP_TIMEOUT`](/docs/de/env-vars), darauf, dass dieser Server sich verbindet. Vor v2.1.206 wartete der Start nicht, bis der Server die Verbindung hergestellt hatte, sodass auch ein langsam startender, aber funktionsfähiger Server diesen Fehler verursachte.

3248 3269

3249```text theme={null}3270```text theme={null}

3250Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3271Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

3251```3272```

3252 3273

3253Die Liste nach `Available MCP tools:` benennt die MCP-Tools, die verbunden waren, als das Warten endete.3274Die Liste nach `Available MCP tools:` nennt die MCP-Tools, die verbunden waren.

3254 3275

3255**Was zu tun ist:**3276**Was zu tun ist:**

3256 3277

3257* Überprüfen Sie, dass der Server startet und verbunden bleibt: Führen Sie `claude mcp list` im selben Verzeichnis aus und bestätigen Sie, dass der Server als verbunden aufgelistet ist3278* Prüfen Sie, ob der Server startet und verbunden bleibt: Führen Sie `claude mcp list` im selben Verzeichnis aus und bestätigen Sie, dass der Server als verbunden aufgeführt ist

3258* Bestätigen Sie, dass der Tool-Name dem `mcp__<server>__<tool>`-Namen entspricht, den der Server verfügbar macht3279* Bestätigen Sie, dass der Tool-Name mit dem `mcp__<server>__<tool>`-Namen übereinstimmt, den der Server bereitstellt

3259* Wenn der Server länger als 30 Sekunden zum Starten benötigt, erhöhen Sie [`MCP_TIMEOUT`](/docs/de/env-vars)3280* Wenn der Server länger als 30 Sekunden zum Starten benötigt, erhöhen Sie [`MCP_TIMEOUT`](/docs/de/env-vars)

3260 3281

3261<h3 id="oauth-callback-port-is-already-in-use">3282<h3 id="oauth-callback-port-is-already-in-use">

3262 OAuth-Callback-Port wird bereits verwendet3283 OAuth-Callback-Port wird bereits verwendet

3263</h3>3284</h3>

3264 3285

3265Wenn Sie sich bei einem Remote-MCP-Server mit OAuth anmelden, startet Claude Code einen lokalen Listener, um den Anmelde-Callback zu empfangen. Wenn der Port, den dieser Listener benötigt, von einem anderen Prozess gehalten wird, schlägt die Anmeldung mit dieser Meldung fehl. Dies geschieht hauptsächlich mit einem [festen Callback-Port](/docs/de/mcp#use-a-fixed-oauth-callback-port), der durch die Variable [`MCP_OAUTH_CALLBACK_PORT`](/docs/de/env-vars) oder `--callback-port` gesetzt ist, da Claude Code ohne einen verfügbaren Port auswählt.3286Wenn Sie sich mit OAuth bei einem entfernten MCP-Server anmelden, startet Claude Code einen lokalen Listener, um den Anmelde-Callback zu empfangen. Wenn der Port, den dieser Listener benötigt, von einem anderen Prozess belegt ist, schlägt die Anmeldung mit dieser Meldung fehl. Das passiert meist bei einem [festen Callback-Port](/docs/de/mcp#use-a-fixed-oauth-callback-port), der über die Variable [`MCP_OAUTH_CALLBACK_PORT`](/docs/de/env-vars) oder `--callback-port` gesetzt wurde, da Claude Code ohne einen solchen einen verfügbaren Port wählt.

3266 3287

3267```text theme={null}3288```text theme={null}

3268OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.3289OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.

3269```3290```

3270 3291

3271Unter Windows ist der vorgeschlagene Befehl stattdessen `netstat -ano | findstr :<port>`.3292Unter Windows lautet der vorgeschlagene Befehl stattdessen `netstat -ano | findstr :<port>`.

3272 3293

3273**Was zu tun ist:**3294**Was zu tun ist:**

3274 3295

3275* Führen Sie den Befehl aus der Meldung aus, um den Prozess zu finden, der den Port hält, und stoppen Sie ihn oder warten Sie, bis er fertig ist3296* Führen Sie den Befehl aus der Meldung aus, um den Prozess zu finden, der den Port belegt, und beenden Sie ihn oder warten Sie, bis er fertig ist

3276* Wenn ein anderes Programm diesen Port dauerhaft benötigt, registrieren Sie einen anderen Redirect-URI beim Server und setzen Sie seinen Port mit `MCP_OAUTH_CALLBACK_PORT` oder `--callback-port`, je nachdem, was Sie verwenden3297* Wenn ein anderes Programm diesen Port dauerhaft benötigt, registrieren Sie beim Server einen anderen Redirect-URI und setzen Sie dessen Port mit `MCP_OAUTH_CALLBACK_PORT` oder `--callback-port`, je nachdem, was Sie verwenden

3277* Starten Sie dann die Anmeldung erneut, z. B. indem Sie den Server in `/mcp` auswählen3298* Starten Sie die Anmeldung dann erneut, zum Beispiel indem Sie den Server in `/mcp` auswählen

3278 3299

3279<h3 id="no-available-ports-for-oauth-redirect">3300<h3 id="no-available-ports-for-oauth-redirect">

3280 Keine verfügbaren Ports für OAuth-Umleitung3301 Keine verfügbaren Ports für die OAuth-Weiterleitung

3281</h3>3302</h3>

3282 3303

3283Wenn Sie sich bei einem Remote-MCP-Server mit [OAuth](/docs/de/mcp#authenticate-with-remote-mcp-servers) anmelden, startet Claude Code einen lokalen Listener, um den Anmelde-Callback zu empfangen. Die Anmeldung schlägt mit dieser Meldung fehl, wenn Claude Code keinen lokalen Port dafür binden kann. Etwas auf der Maschine verhindert, dass es auf `127.0.0.1` lauscht, z. B. Sicherheitssoftware oder eine Sandbox-Richtlinie, die lokale Listener verweigert.3304Wenn Sie sich mit [OAuth](/docs/de/mcp#authenticate-with-remote-mcp-servers) bei einem entfernten MCP-Server anmelden, startet Claude Code einen lokalen Listener, um den Anmelde-Callback zu empfangen. Die Anmeldung schlägt mit dieser Meldung fehl, wenn Claude Code dafür keinen lokalen Port binden kann. Etwas auf dem Rechner hindert es daran, auf `127.0.0.1` zu lauschen, zum Beispiel Sicherheitssoftware oder eine Sandbox-Richtlinie, die lokale Listener verbietet.

3284 3305

3285```text theme={null}3306```text theme={null}

3286No available ports for OAuth redirect3307No available ports for OAuth redirect

3287```3308```

3288 3309

3289Vor v2.1.268 fiel Claude Code nicht auf einen vom Betriebssystem zugewiesenen Port zurück, daher erschien die Meldung auch, wenn nur die selbst ausgewählten Ports nicht gebunden werden konnten. Dies kann auf Windows-Hosts geschehen, wo Hyper-V Port-Bereiche reserviert, die die Ports abdecken, die Claude Code auswählt.3310Vor v2.1.268 fiel Claude Code nicht auf einen vom Betriebssystem zugewiesenen Port zurück, sodass die Meldung auch erschien, wenn nur die selbst gewählten Ports nicht gebunden werden konnten. Das kann auf Windows-Hosts passieren, auf denen Hyper-V Portbereiche reserviert, die die Ports abdecken, aus denen Claude Code wählt.

3290 3311

3291**Was zu tun ist:**3312**Was zu tun ist:**

3292 3313

3293* Überprüfen Sie, ob Sicherheitssoftware oder eine Sandbox-Richtlinie Prozesse daran hindert, auf `127.0.0.1` zu lauschen, und erlauben Sie Claude Code, einen lokalen Port zu binden3314* Prüfen Sie, ob Sicherheitssoftware oder eine Sandbox-Richtlinie Prozesse daran hindert, auf `127.0.0.1` zu lauschen, und erlauben Sie Claude Code, einen lokalen Port zu binden

3294* Starten Sie dann die Anmeldung erneut, z. B. indem Sie den Server in `/mcp` auswählen3315* Starten Sie die Anmeldung dann erneut, zum Beispiel indem Sie den Server in `/mcp` auswählen

3295 3316

3296<h3 id="security-review-fails-without-origin-head">3317<h3 id="security-review-fails-without-origin-head">

3297 /security-review schlägt ohne origin/HEAD fehl3318 /security-review schlägt ohne origin/HEAD fehl

3298</h3>3319</h3>

3299 3320

3300[`/security-review`](/docs/de/commands#all-commands) erstellt seinen Review-Kontext, indem es Ihren Branch gegen `origin/HEAD` vergleicht, die lokale Ref, die aufzeichnet, welcher Branch der Standard auf Ihrem `origin`-Remote ist. Wenn diese Ref nicht existiert, schlagen die Git-Befehle, die den Diff sammeln, fehl und die Review stoppt, bevor sie beginnt.3321[`/security-review`](/docs/de/commands#all-commands) erstellt seinen Review-Kontext, indem es einen Diff Ihres Branches gegen `origin/HEAD` bildet, die lokale Ref, die festhält, welcher Branch auf Ihrem `origin`-Remote der Standard ist. Wenn diese Ref nicht existiert, schlagen die Git-Befehle fehl, die den Diff sammeln, und das Review stoppt, bevor es beginnt.

3301 3322

3302```text theme={null}3323```text theme={null}

3303Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3324Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]

3306'git <command> [<revision>...] -- [<file>...]'3327'git <command> [<revision>...] -- [<file>...]'

3307```3328```

3308 3329

3309Die Meldung kann stattdessen `git log` oder einen anderen `git diff` zitieren. Git erstellt `origin/HEAD` nur, wenn der Remote einen Standard-Branch bewirbt und Ihr Fetch-Refspec ihn abdeckt, was ein vollständiger `git clone` eines Remote mit Commits tut. Die Ref fehlt in diesen Setups:3330Die Meldung kann stattdessen `git log` oder einen anderen `git diff` zitieren. Git erstellt `origin/HEAD` nur, wenn der Remote einen Standard-Branch bekannt gibt und Ihre Fetch-Refspec ihn abdeckt, was bei einem vollständigen `git clone` eines Remotes mit Commits der Fall ist. In diesen Konstellationen fehlt die Ref:

3310 3331

3311* Ein Single-Branch- oder CI-Checkout, der einen zu engen Refspec abruft3332* Ein Single-Branch- oder CI-Checkout, der eine zu enge Refspec abruft

3312* Ein Remote, dessen serverseitige HEAD auf einen Branch zeigt, den niemand gepusht hat3333* Ein Remote, dessen serverseitiger HEAD auf einen Branch verweist, den niemand gepusht hat

3313* Ein Repository ohne `origin`-Remote oder eines, das Sie nie abgerufen haben3334* Ein Repository ohne `origin`-Remote oder eines, das Sie nie abgerufen haben

3314 3335

3315Claude Code zeigt denselben Fehler für jeden Skill, der [dynamischen Kontext injiziert](/docs/de/skills#when-an-injected-command-fails), und ein fehlgeschlagener injizierter Befehl bricht die Invokation dieses Skills ab. Zwei Geschwister-Strings werden vor dem Befehl ausgelöst:3336Claude Code zeigt denselben Fehler für jeden Skill, der [dynamischen Kontext einfügt](/docs/de/skills#when-an-injected-command-fails), und ein fehlgeschlagener eingefügter Befehl bricht den Aufruf dieses Skills ab. Zwei verwandte Meldungen treten auf, bevor der Befehl überhaupt ausgeführt wird:

3316 3337

3317* `Shell command permission check failed for pattern "..."`: Die Berechtigungsprüfung des Befehls hat ihn nicht erlaubt. [Berechtigungsprüfungen auf injizierten Befehlen](/docs/de/skills#permission-checks-on-injected-commands) behandelt, welche Ergebnisse in jedem Berechtigungsmodus abbrechen und wie Sie einen Befehl mit `allowed-tools` vorab genehmigen3338* `Shell command permission check failed for pattern "..."`: Die Berechtigungsprüfung des Befehls hat ihn nicht zugelassen. [Berechtigungsprüfungen für eingefügte Befehle](/docs/de/skills#permission-checks-on-injected-commands) beschreibt, welche Ergebnisse in jedem Berechtigungsmodus zum Abbruch führen und wie Sie einen Befehl mit `allowed-tools` vorab genehmigen

3318* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: Die Frontmatter des Skills verlangt Bash auf einer Maschine ohne ihn. Installieren Sie Git für Windows oder ändern Sie die Frontmatter zu `shell: powershell`. Siehe [Wie injizierte Befehle ausgeführt werden](/docs/de/skills#how-injected-commands-run)3339* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: Das Frontmatter des Skills verlangt bash auf einem Rechner, auf dem es nicht vorhanden ist. Installieren Sie Git for Windows oder ändern Sie das Frontmatter in `shell: powershell`. Siehe [Wie eingefügte Befehle ausgeführt werden](/docs/de/skills#how-injected-commands-run)

3319 3340

3320**Was zu tun ist:**3341**Was zu tun ist:**

3321 3342

3322* Erstellen Sie die Ref, indem Sie den Standard-Branch Ihres Remote benennen: `git remote set-head origin <default-branch>`. Dies funktioniert, wenn die lokale Tracking-Ref `origin/<default-branch>` existiert. Wenn nicht, wie in Single-Branch-Klonen, rufen Sie den Branch zuerst ab: Führen Sie `git remote set-branches --add origin <branch>` aus, dann `git fetch origin`, dann führen Sie den set-head-Befehl erneut aus. Führen Sie `/security-review` erneut aus.3343* Erstellen Sie die Ref, indem Sie den Standard-Branch Ihres Remotes angeben: `git remote set-head origin <default-branch>`. Das funktioniert, sofern die lokale Tracking-Ref `origin/<default-branch>` existiert. Falls nicht, wie bei Single-Branch-Klonen, rufen Sie den Branch zuerst ab: Führen Sie `git remote set-branches --add origin <branch>` aus, dann `git fetch origin`, und führen Sie dann den set-head-Befehl erneut aus. Führen Sie `/security-review` erneut aus.

3323* Wenn Sie den Branch nicht benennen möchten, führen Sie `git fetch origin` aus und dann `git remote set-head origin --auto`, das den Remote fragt, welcher Branch sein Standard ist. Es schlägt mit `error: Cannot determine remote HEAD` fehl, wenn der Remote keinen Standard-Branch bewirbt, weil er leer ist oder seine HEAD auf einen Branch zeigt, den niemand gepusht hat; benennen Sie den Branch stattdessen explizit. Es schlägt mit `error: Not a valid ref` fehl, wenn Ihr Klon diesen Branch nicht abruft; erweitern Sie den Refspec zuerst wie oben.3344* Wenn Sie den Branch lieber nicht angeben möchten, führen Sie `git fetch origin` und dann `git remote set-head origin --auto` aus, das den Remote fragt, welcher Branch sein Standard ist. Es schlägt mit `error: Cannot determine remote HEAD` fehl, wenn der Remote keinen Standard-Branch bekannt gibt, weil er leer ist oder sein HEAD auf einen Branch verweist, den niemand gepusht hat; geben Sie den Branch stattdessen explizit an. Es schlägt mit `error: Not a valid ref` fehl, wenn Ihr Klon diesen Branch nicht abruft; erweitern Sie zuerst die Refspec wie oben beschrieben.

3324* Wenn das Repository keinen Remote hat, fügen Sie einen mit `git remote add origin <url>` hinzu und rufen Sie ab, bevor Sie die Ref erstellen. Wenn der Remote leer ist, pushen Sie Ihren Branch zuerst mit `git push -u origin HEAD` und benennen Sie diesen Branch im set-head-Befehl; `origin/HEAD` zeigt dann auf den Branch, den Sie gerade gepusht haben, daher sieht `/security-review` einen leeren Diff, bis der Branch von ihm abweicht.3345* Wenn das Repository keinen Remote hat, fügen Sie einen mit `git remote add origin <url>` hinzu und rufen Sie ihn ab, bevor Sie die Ref erstellen. Wenn der Remote leer ist, pushen Sie zuerst Ihren Branch mit `git push -u origin HEAD` und geben Sie diesen Branch im set-head-Befehl an; `origin/HEAD` verweist dann auf den Branch, den Sie gerade gepusht haben, sodass `/security-review` einen leeren Diff sieht, bis der Branch davon abweicht.

3325 3346

3326<h3 id="input-must-be-provided-when-using-print">3347<h3 id="input-must-be-provided-when-using-print">

3327 Eingabe muss bereitgestellt werden, wenn `--print` verwendet wird3348 Bei Verwendung von `--print` muss eine Eingabe angegeben werden

3328</h3>3349</h3>

3329 3350

3330Bare `claude` benötigt stdout, um ein Terminal zu sein, um die interaktive UI zu starten. Wenn stdout umgeleitet wird oder die Konsole kein echtes Terminal ist, wie PowerShell ISE und einige IDE-Ausgabebereiche, führt `claude` stattdessen [nicht interaktiv](/docs/de/headless) aus. Das ist derselbe Modus wie `claude -p`, der eine Eingabeaufforderung erfordert, daher benennt die Meldung `--print`, auch wenn Sie das Flag nicht übergeben haben. Das Übergeben von `-p`/`--print` ohne Eingabeaufforderung und nichts auf stdin erzeugt überall denselben Fehler.3351Ein einfaches `claude` benötigt ein Terminal als stdout, um die interaktive Oberfläche zu starten. Wenn stdout umgeleitet wird oder die Konsole kein echtes Terminal ist, etwa PowerShell ISE und einige Ausgabebereiche von IDEs, wird `claude` stattdessen [nicht interaktiv](/docs/de/headless) ausgeführt. Das ist derselbe Modus wie `claude -p`, der einen Prompt erfordert, daher nennt die Meldung `--print`, auch wenn Sie das Flag nicht übergeben haben. Die Übergabe von `-p`/`--print` ohne Prompt und ohne per Pipe übergebene Eingabe auf stdin erzeugt überall denselben Fehler.

3331 3352

3332```text theme={null}3353```text theme={null}

3333Error: Input must be provided either through stdin or as a prompt argument when using --print3354Error: Input must be provided either through stdin or as a prompt argument when using --print

3335 3356

3336**Was zu tun ist:**3357**Was zu tun ist:**

3337 3358

3338* Für interaktive Verwendung führen Sie `claude` in einem echten Terminal aus: Windows Terminal oder die PowerShell-Konsole statt ISE, und das integrierte Terminal Ihrer IDE statt eines Ausgabebereichs3359* Für die interaktive Nutzung führen Sie `claude` in einem echten Terminal aus: Windows Terminal oder der PowerShell-Konsole statt ISE, und im integrierten Terminal Ihrer IDE statt in einem Ausgabebereich

3339* Für einmalige Verwendung übergeben Sie die Eingabeaufforderung: `claude -p "your question"`, oder pipen Sie sie mit `echo "your question" | claude -p`3360* Für die einmalige Nutzung übergeben Sie den Prompt: `claude -p "your question"`, oder leiten Sie ihn per Pipe weiter mit `echo "your question" | claude -p`

3340 3361

3341<h3 id="input-contained-only-whitespace">3362<h3 id="input-contained-only-whitespace">

3342 Eingabe enthielt nur Leerzeichen3363 Eingabe enthielt nur Leerraum

3343</h3>3364</h3>

3344 3365

3345Im [nicht interaktiven Modus](/docs/de/headless) weigert sich Claude Code, eine Eingabeaufforderung zu akzeptieren, die nur aus Leerzeichen, Tabulatoren oder Zeilenumbrüchen besteht, anstatt sie zu senden, da die API Nachrichten ohne sichtbaren Text ablehnt. Welche Meldung Sie sehen, hängt davon ab, woher die leere Eingabeaufforderung kam:3366Im [nicht interaktiven Modus](/docs/de/headless) lehnt Claude Code einen Prompt, der ausschließlich aus Leerzeichen, Tabulatoren oder Zeilenumbrüchen besteht, ab, anstatt ihn zu senden, da die API Nachrichten ohne sichtbaren Text ablehnt. Welche Meldung Sie sehen, hängt davon ab, woher der leere Prompt stammt:

3346 3367

3347* **Eingabeaufforderungs-Argument oder gepipte stdin für `claude -p`**: `claude` beendet sich mit `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`3368* **Prompt-Argument oder per Pipe übergebenes stdin für `claude -p`**: `claude` beendet sich mit `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`

3348* **Nachricht eingereicht an eine laufende `--input-format stream-json` oder [Agent SDK](/docs/de/agent-sdk/overview)-Sitzung**: Claude Code beendet die Runde ohne Aufruf des Modells und die Sitzung bleibt nutzbar. Die Ablehnung kommt als informative Meldung und als Ergebnis-Text der Runde: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`3369* **Nachricht, die an eine laufende `--input-format stream-json`- oder [Agent SDK](/docs/de/agent-sdk/overview)-Sitzung gesendet wurde**: Claude Code beendet den Turn, ohne das Modell aufzurufen, und die Sitzung bleibt nutzbar. Die Ablehnung kommt als informative Nachricht und als Ergebnistext des Turns an: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`

3349 3370

3350Vor v2.1.229 hat Claude Code die Whitespace-only-Nachricht an die API gesendet, die die Anfrage mit einem 400-Fehler abgelehnt hat.3371Vor v2.1.229 sendete Claude Code die Nachricht, die nur Leerraum enthielt, an die API, die die Anfrage mit einem 400-Fehler ablehnte.

3351 3372

3352**Was zu tun ist:**3373**Was zu tun ist:**

3353 3374

3354* Fügen Sie sichtbaren Text in die Eingabeaufforderung ein. Wenn ein Skript die Eingabeaufforderung aus einer Variablen oder Datei erstellt, überprüfen Sie, dass die Quelle nicht leer ist, bevor Sie Claude Code aufrufen.3375* Fügen Sie sichtbaren Text in den Prompt ein. Wenn ein Skript den Prompt aus einer Variablen oder Datei erstellt, prüfen Sie vor dem Aufruf von Claude Code, ob die Quelle nicht leer ist.

3355 3376

3356<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">3377<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">

3357 stream-json-Eingabe trug über 256M Zeichen ohne Zeilenumbruch3378 stream-json-Eingabe enthielt über 256M Zeichen ohne Zeilenumbruch

3358</h3>3379</h3>

3359 3380

3360Ihr Programm hat mehr als 268.435.456 Zeichen auf stdin ohne Zeilenumbruch an einen `claude -p --input-format stream-json`-Lauf gesendet, daher druckt Claude Code diesen Fehler auf stderr und beendet sich mit Code 1, anstatt mehr Eingabe zu puffern. Die Meldung gibt dieses Budget als `256M` an. Vor v2.1.257 hat Claude Code solche Eingaben ohne Limit gepuffert, was den Speicher vergrößert hat, bis der Prozess abstürzte oder beendet wurde.3381Ihr Programm hat mehr als 268.435.456 Zeichen ohne Zeilenumbruch über stdin an eine `claude -p --input-format stream-json`-Ausführung gesendet, daher gibt Claude Code diesen Fehler auf stderr aus und beendet sich mit Exit-Code 1, anstatt weitere Eingaben zu puffern. Die Meldung gibt dieses Budget als `256M` an. Vor v2.1.257 pufferte Claude Code solche Eingaben ohne Begrenzung, wodurch der Speicherverbrauch wuchs, bis der Prozess abstürzte oder beendet wurde.

3361 3382

3362```text theme={null}3383```text theme={null}

3363Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.3384Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.

3364```3385```

3365 3386

3366Eingabe dieser Länge ohne Zeilenumbruch bedeutet normalerweise, dass der Producer überhaupt kein stream-json-Producer ist, wie eine Binärdatei oder einfache Log-Ausgabe, die versehentlich gepipet wird. Eine einzelne Nachricht über dem Budget schlägt dieselbe Überprüfung fehl.3387Eine so lange Eingabe ohne Zeilenumbruch bedeutet in der Regel, dass der Erzeuger überhaupt kein stream-json-Erzeuger ist, etwa eine Binärdatei oder einfache Log-Ausgabe, die versehentlich per Pipe übergeben wurde. Eine einzelne Nachricht über dem Budget scheitert an derselben Prüfung.

3367 3388

3368**Was zu tun ist:**3389**Was zu tun ist:**

3369 3390

3370* Überprüfen Sie, was auf stdin gepipet wird. Mit [`--input-format stream-json`](/docs/de/cli-reference#cli-flags) muss jede Nachricht eine Zeilenumbruch-terminierte JSON-Zeile sein3391* Prüfen Sie, was per Pipe an stdin übergeben wird. Mit [`--input-format stream-json`](/docs/de/cli-reference#cli-flags) muss jede Nachricht eine einzelne, mit Zeilenumbruch abgeschlossene JSON-Zeile sein

3371* Um stattdessen einfachen Text zu senden, lassen Sie `--input-format stream-json` weg; `claude -p` liest standardmäßig eine einfache Text-Eingabeaufforderung von stdin3392* Um stattdessen einfachen Text zu senden, entfernen Sie `--input-format stream-json`; `claude -p` liest standardmäßig einen Klartext-Prompt von stdin

3372 3393

3373<h3 id="unknown-command">3394<h3 id="unknown-command">

3374 Unbekannter Befehl3395 Unknown command

3375</h3>3396</h3>

3376 3397

3377In einer interaktiven Terminal-Sitzung haben Sie einen `/`-Namen eingereicht, der keinem Befehl in dieser Sitzung entspricht, daher meldet Claude Code den Namen, anstatt etwas auszuführen:3398In einer interaktiven Terminalsitzung haben Sie einen `/`-Namen abgesendet, der keinem Befehl in dieser Sitzung entspricht, daher meldet Claude Code den Namen, anstatt etwas auszuführen:

3378 3399

3379```text theme={null}3400```text theme={null}

3380Unknown command: /hepl. Did you mean /help?3401Unknown command: /hepl. Did you mean /help?

3381```3402```

3382 3403

3383Claude Code schlägt den nächsten Befehlsnamen oder Alias vor, den das Menü in dieser Sitzung auflistet. Wenn nichts nah ist, endet die Meldung nach dem Namen. Die Ursache ist normalerweise eine der folgenden:3404Claude Code schlägt den nächstliegenden Befehlsnamen oder Alias vor, den das Menü in dieser Sitzung auflistet. Wenn nichts ähnlich ist, endet die Meldung nach dem Namen. Die Ursache ist in der Regel eine der folgenden:

3384 3405

3385* Ein Tippfehler, wie `/hepl` für `/help`. [Wie das Befehlsmenü das, was Sie eingeben, abgleicht](/docs/de/commands#how-the-command-menu-matches-what-you-type) behandelt das Auswählen einer nahen Übereinstimmung, bevor Sie einreichen3406* Ein Tippfehler, etwa `/hepl` statt `/help`. [Wie das Befehlsmenü Ihre Eingabe abgleicht](/docs/de/commands#how-the-command-menu-matches-what-you-type) beschreibt, wie Sie vor dem Absenden einen ähnlichen Treffer auswählen

3386* Ein Befehl, der existiert, aber in dieser Sitzung nicht verfügbar ist, weil eine Anforderung nicht erfüllt ist, wie Ihre Plattform, Ihr Plan oder Ihre Authentifizierungsmethode. Die Troubleshooting-Einträge für [`/web-setup`](/docs/de/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) und [`/schedule`](/docs/de/routines#schedule-returns-unknown-command) gehen durch zwei häufige Fälle. Einige Befehle antworten mit ihrer eigenen Meldung, wenn die Richtlinie Ihrer Organisation sie deaktiviert, wie [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)3407* Ein Befehl, der existiert, aber in dieser Sitzung nicht verfügbar ist, weil eine Voraussetzung nicht erfüllt ist, etwa Ihre Plattform, Ihr Plan oder Ihre Authentifizierungsmethode. Die Einträge zur Fehlerbehebung für [`/web-setup`](/docs/de/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) und [`/schedule`](/docs/de/routines#schedule-returns-unknown-command) erläutern zwei häufige Fälle. Einige Befehle antworten mit einer eigenen Meldung, wenn die Richtlinie Ihrer Organisation sie deaktiviert, etwa [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)

3387* Ein Befehl aus einem [Plugin](/docs/de/plugins/overview) oder [MCP-Server](/docs/de/mcp#use-mcp-prompts-as-commands), der in dieser Sitzung nicht installiert oder verbunden ist3408* Ein Befehl aus einem [Plugin](/docs/de/plugins/overview) oder [MCP-Server](/docs/de/mcp#use-mcp-prompts-as-commands), das bzw. der in dieser Sitzung nicht installiert oder verbunden ist

3388 3409

3389Claude Code antwortet auf einen nicht übereinstimmenden `/`-Namen auf diese Weise nur in einer interaktiven Terminal-Sitzung. In jeder anderen Sitzung sendet es die Eingabeaufforderung als normale Nachricht an Claude, mit einer Notiz, dass der Befehl nicht ausgeführt wurde, und einer Liste von Befehlen, die Claude in der Sitzung ausführen kann. Diese Sitzungen umfassen:3410Claude Code beantwortet einen nicht übereinstimmenden `/`-Namen nur in einer interaktiven Terminalsitzung auf diese Weise. In jeder anderen Sitzung sendet es den Prompt stattdessen als normale Nachricht an Claude, mit einem Hinweis, dass der Befehl nicht ausgeführt wurde, und einer Liste der Befehle, die Claude in der Sitzung ausführen kann. Zu diesen Sitzungen gehören:

3390 3411

3391* `-p`-Läufe3412* `-p`-Ausführungen

3392* [Agent SDK](/docs/de/agent-sdk/overview)-Anwendungen3413* [Agent SDK](/docs/de/agent-sdk/overview)-Anwendungen

3393* Die Code-Registerkarte der [Desktop-App](/docs/de/desktop)3414* Der Code-Tab der [Desktop-App](/docs/de/desktop)

3394* Das Chat-Panel der [VS Code-Erweiterung](/docs/de/vs-code)3415* Das Chat-Panel der [VS Code-Erweiterung](/docs/de/vs-code)

3395* [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) und [Routinen](/docs/de/routines)3416* [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) und [Routinen](/docs/de/routines)

3396 3417

3397Für einen integrierten Befehl, der in einer dieser Sitzungen nicht ausgeführt werden kann, antwortet Claude Code immer noch, dass der Befehl nicht verfügbar ist, anstatt ihn an Claude zu senden. Vor v2.1.274 sendeten nur Cloud-Sitzungen und Routinen einen nicht übereinstimmenden Namen an Claude. Vor v2.1.273 antworteten sie auch mit `Unknown command`.3418Bei einem integrierten Befehl, der in einer dieser Sitzungen nicht ausgeführt werden kann, antwortet Claude Code weiterhin, dass der Befehl nicht verfügbar ist, anstatt ihn an Claude zu senden. Vor v2.1.274 sendeten nur Cloud-Sitzungen und Routinen einen nicht übereinstimmenden Namen an Claude. Vor v2.1.273 antworteten auch sie mit `Unknown command`.

3398 3419

3399Claude Code behandelt nicht jeden Prompt, der mit `/` beginnt, als Befehl. Es sendet die Eingabeaufforderung als normale Nachricht an Claude, wenn das erste Wort nach dem `/` mit Interpunktion beginnt, wie das `/--`, das einen Lean-Doc-Kommentar öffnet, oder ein Pfad wie `/var/log/syslog`.3420Claude Code behandelt nicht jeden Prompt, der mit `/` beginnt, als Befehl. Es sendet den Prompt als normale Nachricht an Claude, wenn das erste Wort nach dem `/` mit einem Satzzeichen beginnt, etwa das `/--`, das einen Lean-Dokumentationskommentar einleitet, oder ein Pfad wie `/var/log/syslog` ist.

3400 3421

3401Vor v2.1.236 führte Claude Code, wenn Sie die Eingabetaste drückten, während das Befehlsmenü eine nahe Übereinstimmung für den Namen auflistete, den Sie eingegeben haben, diese Übereinstimmung aus, daher führte ein Tippfehler wie `/hepl` `/help` aus, anstatt diese Meldung zu erzeugen.3422Vor v2.1.236 führte Claude Code, wenn Sie `Enter` drückten, während das Befehlsmenü einen ähnlichen Treffer für den eingegebenen Namen auflistete, diesen Treffer aus, sodass ein Tippfehler wie `/hepl` `/help` ausführte, anstatt diese Meldung zu erzeugen.

3402 3423

3403**Was zu tun ist:**3424**Was zu tun ist:**

3404 3425

3405* Führen Sie den vorgeschlagenen Namen aus, oder geben Sie `/` gefolgt von Teil des Namens ein, um zu sehen, was in dieser Sitzung verfügbar ist3426* Führen Sie den vorgeschlagenen Namen aus, oder geben Sie `/` gefolgt von einem Teil des Namens ein, um zu sehen, was in dieser Sitzung verfügbar ist

3406* Wenn Claude Code einen dokumentierten Befehl als unbekannt meldet, überprüfen Sie seine Zeile in der [Befehlsreferenz](/docs/de/commands) auf die Anforderung, die er benennt3427* Wenn Claude Code einen dokumentierten Befehl als unbekannt meldet, prüfen Sie dessen Zeile in der [Befehlsreferenz](/docs/de/commands) auf die dort genannte Voraussetzung

3407 3428

3408<h3 id="diff-is-too-large-for-ultrareview">3429<h3 id="diff-is-too-large-for-ultrareview">

3409 Diff ist zu groß für ultrareview3430 Diff ist zu groß für ultrareview

3410</h3>3431</h3>

3411 3432

3412Der Diff zwischen Ihrem Branch und dem Base-Branch, einschließlich nicht committeter und gestaffelter Änderungen, überschreitet die Größenlimits für eine [ultrareview](/docs/de/ultrareview), daher weigern sich `/code-review ultra` und der `claude ultrareview`-Unterbefehl die Review, bevor die Cloud-Sitzung startet. Eine abgelehnte Review verwendet keinen kostenlosen Lauf und belastet keine Nutzungsguthaben. Die Meldung benennt die geltenden Limits, die Größe Ihres Diff und die Dateien, die die meisten geänderten Zeilen beitragen. Vor v2.1.216 zeigte die Meldung nur die rohen Diff-Statistiken.3433Der Diff zwischen Ihrem Branch und dem Basis-Branch, einschließlich nicht committeter und gestagter Änderungen, überschreitet die Größenlimits für ein [ultrareview](/docs/de/ultrareview), daher verweigern `/code-review ultra` und der Unterbefehl `claude ultrareview` das Review, bevor die Cloud-Sitzung startet. Ein abgelehntes Review verbraucht keine kostenlose Ausführung und verrechnet kein Nutzungsguthaben. Die Meldung nennt die geltenden Limits, die Größe Ihres Diffs und die Dateien, die die meisten geänderten Zeilen beitragen. Vor v2.1.216 zeigte die Meldung nur die rohen Diff-Statistiken.

3413 3434

3414```text theme={null}3435```text theme={null}

3415Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.3436Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.

3416```3437```

3417 3438

3418Das Überprüfen eines Pull Request wendet dieselben Limits an; diese Form der Meldung beginnt mit `PR #<N> is too large for ultrareview` und benennt die Datei und Zeilenzahlen des PR.3439Für das Review eines Pull Requests gelten dieselben Limits; diese Form der Meldung beginnt mit `PR #<N> is too large for ultrareview` und nennt die Datei- und Zeilenanzahl des PR.

3419 3440

3420**Was zu tun ist:**3441**Was zu tun ist:**

3421 3442

3422* Übergeben Sie einen Base-Branch, der näher an Ihrer Arbeit liegt, wie `/code-review ultra develop`, damit die Review nur den Diff gegen diesen Branch abdeckt3443* Übergeben Sie einen Basis-Branch, der näher an Ihrer Arbeit liegt, etwa `/code-review ultra develop`, sodass das Review nur den Diff gegen diesen Branch abdeckt

3423* Teilen Sie die Änderung in kleinere Branches auf und überprüfen Sie jeden. Die Dateien, die die Meldung benennt, tragen die meisten geänderten Zeilen bei, daher beginnen Sie damit, diese in ihren eigenen Branch zu verschieben.3444* Teilen Sie die Änderung in kleinere Branches auf und führen Sie für jeden ein Review durch. Die Dateien, die die Meldung nennt, tragen die meisten geänderten Zeilen bei, also verschieben Sie diese zuerst in einen eigenen Branch.

3424 3445

3425<h3 id="could-not-find-merge-base-with-the-base-branch">3446<h3 id="could-not-find-merge-base-with-the-base-branch">

3426 Merge-Base mit dem Base-Branch konnte nicht gefunden werden3447 Merge-Base mit dem Basis-Branch konnte nicht gefunden werden

3427</h3>3448</h3>

3428 3449

3429`/code-review ultra` und der `claude ultrareview`-Unterbefehl überprüfen den Diff zwischen Ihrem Branch und einem Base-Branch, was einen Commit erfordert, den die beiden teilen. Wenn `git merge-base` keinen findet, weigert sich Claude Code, die Review zu starten, bevor die Cloud-Sitzung startet. Bei einem Klon, den Claude Code als vollständig überprüfen kann, mit mindestens einem Branch, fällt es stattdessen auf [Überprüfung jeder verfolgten Datei](/docs/de/ultrareview#diff-limits-and-fallbacks) zurück. Sie sehen diese Ablehnung, wenn der Base-Branch überhaupt nicht gefunden werden kann, wenn Claude Code nicht überprüfen kann, dass Ihr Klon vollständig ist, oder im seltenen Repository, wo der Whole-Tree-Diff nicht möglich ist, wie das SHA-256-Objektformat.3450`/code-review ultra` und der Unterbefehl `claude ultrareview` prüfen den Diff zwischen Ihrem Branch und einem Basis-Branch, wofür ein Commit benötigt wird, den beide gemeinsam haben. Wenn `git merge-base` keinen findet, verweigert Claude Code das Review, bevor die Cloud-Sitzung startet. Bei einem Klon, dessen Vollständigkeit Claude Code überprüfen kann und der mindestens einen Branch hat, fällt es darauf zurück, [jede verfolgte Datei zu prüfen](/docs/de/ultrareview#diff-limits-and-fallbacks), anstatt abzulehnen. Sie sehen diese Ablehnung, wenn der Basis-Branch überhaupt nicht gefunden werden kann, wenn Claude Code nicht überprüfen kann, ob Ihr Klon vollständig ist, oder in dem seltenen Repository, in dem der Diff über den gesamten Baum nicht möglich ist, etwa beim SHA-256-Objektformat.

3430 3451

3431```text theme={null}3452```text theme={null}

3432Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.3453Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.

3433```3454```

3434 3455

3435Der Hinweis nach dem ersten Satz hängt davon ab, was Claude Code beobachtet hat:3456Der Hinweis nach dem ersten Satz hängt davon ab, was Claude Code festgestellt hat:

3436 3457

3437* **Sie haben keinen Base-Branch übergeben**: Claude Code verglich gegen den Standard-Branch des Repository und schlägt vor, Ihren Base explizit zu übergeben, wie im Beispiel oben3458* **Sie haben keinen Basis-Branch übergeben**: Claude Code hat mit dem Standard-Branch des Repositorys verglichen und schlägt vor, Ihre Basis explizit zu übergeben, wie im obigen Beispiel

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

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

3440 3461

3441**Was zu tun ist:**3462**Was zu tun ist:**

3442 3463

3443* Wenn ein anderer Branch Ihr echter Base ist, übergeben Sie ihn explizit: `/code-review ultra <branch>`3464* Wenn ein anderer Branch Ihre eigentliche Basis ist, übergeben Sie ihn explizit: `/code-review ultra <branch>`

3444* Wenn Ihr Klon möglicherweise keine vollständige Historie hat, führen Sie `git fetch --unshallow origin` aus und führen Sie die Review erneut aus3465* Wenn Ihr Klon möglicherweise nicht die vollständige Historie enthält, führen Sie `git fetch --unshallow origin` aus und starten Sie das Review erneut

3445 3466

3446<h3 id="your-checkout-has-no-branches">3467<h3 id="your-checkout-has-no-branches">

3447 Ihr Checkout hat keine Branches3468 Ihr Checkout hat keine Branches

3448</h3>3469</h3>

3449 3470

3450Ein Checkout kann Commits haben, aber keine Branches: Wenn Sie `git init` gefolgt von `git fetch <url>` und `git checkout FETCH_HEAD` ausführen, erhalten Sie einen detached HEAD ohne Refs. Claude Code packt Ihr Repository als Git-Bundle, um es für eine [ultrareview](/docs/de/ultrareview) hochzuladen, und es kann ein Repository, das keine Branches oder andere Refs hat, nicht bündeln, daher weigern sich `/code-review ultra` und der `claude ultrareview`-Unterbefehl die Review, bevor die Cloud-Sitzung startet.3471Ein Checkout kann Commits, aber keine Branches haben: Wenn Sie `git init` gefolgt von `git fetch <url>` und `git checkout FETCH_HEAD` ausführen, erhalten Sie einen Detached HEAD ohne Refs. Claude Code verpackt Ihr Repository als Git-Bundle, um es für ein [ultrareview](/docs/de/ultrareview) hochzuladen, und kann kein Repository bündeln, das keine Branches oder anderen Refs hat, daher verweigern `/code-review ultra` und der Unterbefehl `claude ultrareview` das Review, bevor die Cloud-Sitzung startet.

3451 3472

3452```text theme={null}3473```text theme={null}

3453Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.3474Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.

3454```3475```

3455 3476

3456Vor v2.1.221 versuchte Claude Code, jede verffolgte Datei in diesem Checkout zu überprüfen, und der Upload schlug fehl.3477Vor v2.1.221 versuchte Claude Code, jede verfolgte Datei in diesem Checkout zu prüfen, und der Upload schlug fehl.

3457 3478

3458**Was zu tun ist:**3479**Was zu tun ist:**

3459 3480

3460* Erstellen Sie einen Branch bei Ihrem aktuellen Commit mit `git checkout -b <name>`, dann führen Sie die Review erneut aus3481* Erstellen Sie mit `git checkout -b <name>` einen Branch bei Ihrem aktuellen Commit und starten Sie das Review dann erneut

3461 3482

3462<h3 id="no-github-account-is-connected-to-your-claude-account">3483<h3 id="no-github-account-is-connected-to-your-claude-account">

3463 Kein GitHub-Konto ist mit Ihrem Claude-Konto verbunden3484 Mit Ihrem Claude-Konto ist kein GitHub-Konto verbunden

3464</h3>3485</h3>

3465 3486

3466Sie haben `/code-review ultra <PR#>` oder `claude ultrareview <PR#>` ausgeführt, und bevor die Cloud-Sitzung erstellt wird, fragt Claude Code den Server, ob [das GitHub-Konto, das mit Ihrem Claude-Konto verbunden ist](/docs/de/ultrareview#review-a-pull-request), das Repository des PR erreichen kann. Kein Konto ist verbunden oder die Verbindung ist abgelaufen, daher würde der Cloud-Klon fehlschlagen und Claude Code weigert sich zu starten. Claude Code gibt keinen kostenlosen Lauf aus und belastet keine Nutzungsguthaben für einen abgelehnten Start.3487Sie haben `/code-review ultra <PR#>` oder `claude ultrareview <PR#>` ausgeführt, und vor dem Erstellen der Cloud-Sitzung fragt Claude Code den Server, ob [das mit Ihrem Claude-Konto verbundene GitHub-Konto](/docs/de/ultrareview#review-a-pull-request) auf das Repository des PR zugreifen kann. Es ist kein Konto verbunden, oder die Verbindung ist abgelaufen, daher würde der Klon in der Cloud fehlschlagen, und Claude Code verweigert den Start. Claude Code verbraucht für einen verweigerten Start keine kostenlose Ausführung und verrechnet kein Nutzungsguthaben.

3467 3488

3468```text theme={null}3489```text theme={null}

3469Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).3490Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).

3470```3491```

3471 3492

3472Wenn [`/web-setup`](/docs/de/web-quickstart#connect-from-your-terminal) in Ihrer Sitzung nicht verfügbar ist, benennt die Meldung nur den claude.ai-Link.3493Wenn [`/web-setup`](/docs/de/web-quickstart#connect-from-your-terminal) in Ihrer Sitzung nicht verfügbar ist, nennt die Meldung nur den claude.ai-Link.

3473 3494

3474**Was zu tun ist:**3495**Was zu tun ist:**

3475 3496

3476* Führen Sie `/web-setup` aus, um Ihre GitHub CLI-Anmeldung mit Ihrem Claude-Konto zu verbinden, oder verbinden Sie ein Konto unter [claude.ai/connect-github](https://claude.ai/connect-github)3497* Führen Sie `/web-setup` aus, um Ihre GitHub CLI-Anmeldung mit Ihrem Claude-Konto zu verbinden, oder verbinden Sie ein Konto unter [claude.ai/connect-github](https://claude.ai/connect-github)

3477* Führen Sie die Review eine Minute nach der Verbindung erneut aus3498* Starten Sie das Review eine Minute nach dem Verbinden erneut

3478 3499

3479Vor v2.1.248 überprüfte Claude Code dies nicht vor dem Start.3500Vor v2.1.248 prüfte Claude Code dies nicht vor dem Start.

3480 3501

3481<h3 id="your-connected-github-account-cant-see-the-repository">3502<h3 id="your-connected-github-account-cant-see-the-repository">

3482 Ihr verbundenes GitHub-Konto kann das Repository nicht sehen3503 Ihr verbundenes GitHub-Konto kann das Repository nicht sehen

3483</h3>3504</h3>

3484 3505

3485Sie haben `/code-review ultra <PR#>` oder `claude ultrareview <PR#>` ausgeführt, und [das GitHub-Konto, das mit Ihrem Claude-Konto verbunden ist](/docs/de/ultrareview#review-a-pull-request), kann das Repository des PR nicht lesen, daher würde der Cloud-Klon fehlschlagen und Claude Code weigert sich zu starten. Claude Code gibt keinen kostenlosen Lauf aus und belastet keine Nutzungsguthaben für einen abgelehnten Start.3506Sie haben `/code-review ultra <PR#>` oder `claude ultrareview <PR#>` ausgeführt, und [das mit Ihrem Claude-Konto verbundene GitHub-Konto](/docs/de/ultrareview#review-a-pull-request) kann das Repository des PR nicht lesen, daher würde der Klon in der Cloud fehlschlagen, und Claude Code verweigert den Start. Claude Code verbraucht für einen verweigerten Start keine kostenlose Ausführung und verrechnet kein Nutzungsguthaben.

3486 3507

3487```text theme={null}3508```text theme={null}

3488Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.3509Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.

3489```3510```

3490 3511

3491Wenn [`/web-setup`](/docs/de/web-quickstart#connect-from-your-terminal) in Ihrer Sitzung nicht verfügbar ist, benennt die Meldung nur die App-Installation.3512Wenn [`/web-setup`](/docs/de/web-quickstart#connect-from-your-terminal) in Ihrer Sitzung nicht verfügbar ist, nennt die Meldung nur die App-Installation.

3492 3513

3493**Was zu tun ist:**3514**Was zu tun ist:**

3494 3515

3495* Wenn Ihre lokale `gh`-CLI das Repository lesen kann, führen Sie `/web-setup` aus, um diese Anmeldung mit Ihrem Claude-Konto zu verbinden3516* Wenn Ihre lokale `gh`-CLI das Repository lesen kann, führen Sie `/web-setup` aus, um diese Anmeldung mit Ihrem Claude-Konto zu verbinden

3496* Führen Sie die Review nach der Änderung erneut aus3517* Starten Sie das Review nach der Änderung erneut

3497 3518

3498Vor v2.1.248 überprüfte Claude Code dies nicht vor dem Start.3519Vor v2.1.248 prüfte Claude Code dies nicht vor dem Start.

3499 3520

3500<h3 id="the-github-app-preflight-failed-transiently">3521<h3 id="the-github-app-preflight-failed-transiently">

3501 Der GitHub-App-Preflight ist vorübergehend fehlgeschlagen3522 Die GitHub-App-Vorabprüfung ist vorübergehend fehlgeschlagen

3502</h3>3523</h3>

3503 3524

3504Sie haben eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) aus einem lokalen Repository gestartet, und zwei Schritte sind zusammen fehlgeschlagen. Claude Code konnte das Bundle Ihres Repository nicht erstellen oder hochladen. Bevor der Upload, überprüfte es, ob der Cloud-Service das Repository von GitHub klonen kann, und anstatt einer definitiven Antwort endete diese Überprüfung in einem Fehler, den ein erneuter Versuch klären könnte, wie ein Netzwerkfehler, ein Timeout oder ein vorübergehender Serverfehler. Die vollständige Meldung beginnt mit dem, was das Bundle gestoppt hat, z. B. `Could not upload repo bundle (<error>)`, und endet mit dem Preflight-Satz:3525Sie haben eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) aus einem lokalen Repository gestartet, und zwei Schritte sind gemeinsam fehlgeschlagen. Claude Code konnte das Bundle Ihres Repositorys nicht erstellen oder hochladen. Vor dem Upload prüfte es, ob der Cloud-Dienst das Repository von GitHub klonen kann, und anstelle einer eindeutigen Antwort endete diese Prüfung mit einem Fehler, den ein erneuter Versuch beheben könnte, etwa einem Netzwerkfehler, einem Timeout oder einem vorübergehenden Serverfehler. Die vollständige Meldung beginnt mit dem, was das Bundle verhindert hat, zum Beispiel `Could not upload repo bundle (<error>)`, und endet mit dem Satz zur Vorabprüfung:

3505 3526

3506```text theme={null}3527```text theme={null}

3507Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead3528Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead

3509 3530

3510**Was zu tun ist:**3531**Was zu tun ist:**

3511 3532

3512* Führen Sie den Befehl nach einem Moment erneut aus. Wenn die GitHub-Überprüfung besteht, kann Claude Code die Sitzung von einem GitHub-Klon starten, daher blockiert der fehlgeschlagene Upload den Start nicht mehr3533* Führen Sie den Befehl nach einem Moment erneut aus. Wenn die GitHub-Prüfung erfolgreich ist, kann Claude Code die Sitzung aus einem GitHub-Klon starten, sodass der fehlgeschlagene Upload den Start nicht mehr blockiert

3513* Wenn erneute Versuche weiterhin fehlschlagen, benennt der Anfang der Meldung, was den Upload gestoppt hat. Wenn diese Ursache etwas ist, das Sie beheben können, beheben Sie es, damit die Sitzung stattdessen von Ihrem lokalen Repository starten kann3534* Wenn die Wiederholungsversuche weiterhin fehlschlagen, nennt der Anfang der Meldung, was den Upload verhindert hat. Wenn Sie diese Ursache beheben können, beheben Sie sie, damit die Sitzung stattdessen aus Ihrem lokalen Repository starten kann

3514 3535

3515Vor v2.1.251 endete Claude Code die Meldung mit `Please set up GitHub on https://claude.ai/code`, auch wenn die GitHub-Überprüfung nur vorübergehend fehlgeschlagen ist, und Setup-Ratschläge können einen vorübergehenden Fehler nicht klären.3536Vor v2.1.251 beendete Claude Code die Meldung mit `Please set up GitHub on https://claude.ai/code`, selbst wenn die GitHub-Prüfung nur vorübergehend fehlschlug, und ein Einrichtungshinweis kann einen vorübergehenden Fehler nicht beheben.

3516 3537

3517<h3 id="the-repository-upload-cant-follow-a-git-setting">3538<h3 id="the-repository-upload-cant-follow-a-git-setting">

3518 Die Repository-Upload kann eine Git-Einstellung nicht befolgen3539 Der Repository-Upload kann einer Git-Einstellung nicht folgen

3519</h3>3540</h3>

3520 3541

3521Sie haben eine [Cloud-Sitzung, die Ihr lokales Repository hochlädt](/docs/de/claude-code-on-the-web#send-local-repositories-without-github), oder eine [ultrareview](/docs/de/ultrareview) eines Branch gestartet, und der Upload kann eine der Git-Einstellungen nicht befolgen, die entscheiden, welche Attribut-Regeln auf Ihre Dateien angewendet werden. Wenn der Upload fortgefahren wäre und eine Regel verpasst hätte, könnte eine Datei, die Git vor dem Speichern transformiert, wie eine, die ein Clean-Filter verschlüsselt, die Cloud als auf der Festplatte erreichen. Claude Code weigert sich, den Upload durchzuführen, und nichts wird hochgeladen:3542Sie haben eine [Cloud-Sitzung gestartet, die Ihr lokales Repository hochlädt](/docs/de/claude-code-on-the-web#send-local-repositories-without-github), oder ein [ultrareview](/docs/de/ultrareview) eines Branches, und der Upload kann einer der Git-Einstellungen nicht folgen, die festlegen, welche Attributregeln für Ihre Dateien gelten. Würde der Upload fortgesetzt und eine Regel übersehen, könnte eine Datei, die Git vor dem Speichern umwandelt, etwa eine, die ein Clean-Filter verschlüsselt, so in die Cloud gelangen, wie sie auf der Festplatte liegt. Claude Code verweigert stattdessen den Upload, und nichts wird hochgeladen:

3522 3543

3523```text theme={null}3544```text theme={null}

3524Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository's .git/config or directly into your ~/.gitconfig, then retry.3545Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.

3525```3546```

3526 3547

3527Die Meldung benennt die Einstellung und wo sie gesetzt ist, und endet mit der Lösung für den Fall, den Sie treffen. Die gleiche Ablehnung erscheint für `core.attributesFile` und `attr.tree`, jeweils mit ihrer eigenen Lösung.3548Die Meldung nennt die Einstellung und wo sie gesetzt ist, und endet mit der Lösung für den aufgetretenen Fall. Dieselbe Ablehnung erscheint für `core.attributesFile` und `attr.tree`, jeweils mit eigener Lösung.

3528 3549

3529Die Meldung kann eine Konfigurationsdatei benennen, die Ihre Git-Konfiguration durch eine `include` oder `includeIf`-Direktive einzieht, auch wenn die Bedingung dieser Direktive nicht auf dieses Repository angewendet wird.3550Die Meldung kann eine Konfigurationsdatei nennen, die Ihre Git-Konfiguration über eine `include`- oder `includeIf`-Direktive einbindet, selbst wenn die Bedingung dieser Direktive für dieses Repository nicht zutrifft.

3530 3551

3531**Was zu tun ist:**3552**Was zu tun ist:**

3532 3553

3533* Wenden Sie die Lösung in der letzten Zeile der Meldung an3554* Wenden Sie die Lösung aus dem letzten Satz der Meldung an

3534 3555

3535<h3 id="github-isnt-connected-to-your-claude-account">3556<h3 id="github-isnt-connected-to-your-claude-account">

3536 GitHub ist nicht mit Ihrem Claude-Konto verbunden3557 GitHub ist nicht mit Ihrem Claude-Konto verbunden

3537</h3>3558</h3>

3538 3559

3539Sie haben eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) aus Ihrem lokalen Repository gestartet, z. B. mit `/autofix-pr`. Kein GitHub-Konto ist mit Ihrem Claude-Konto verbunden oder die Verbindung ist abgelaufen, daher weigert sich Claude Code zu starten:3560Sie haben eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) aus Ihrem lokalen Repository gestartet, zum Beispiel mit `/autofix-pr`. Mit Ihrem Claude-Konto ist kein GitHub-Konto verbunden, oder die Verbindung ist abgelaufen, daher verweigert Claude Code den Start:

3540 3561

3541```text theme={null}3562```text theme={null}

3542GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github3563GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github

3543```3564```

3544 3565

3545Wenn Sie eine Routine mit [`/schedule`](/docs/de/routines) erstellen, erscheint dieselbe Meldung als Setup-Notiz, die das Repository benennt; die Notiz blockiert nicht das Erstellen der Routine.3566Wenn Sie eine Routine mit [`/schedule`](/docs/de/routines) erstellen, erscheint dieselbe Meldung als Einrichtungshinweis, der das Repository nennt; der Hinweis blockiert das Erstellen der Routine nicht.

3546 3567

3547**Was zu tun ist:**3568**Was zu tun ist:**

3548 3569

3549* Führen Sie `/web-setup` aus, um Ihre GitHub CLI-Anmeldung mit Ihrem Claude-Konto zu verbinden, oder verbinden Sie ein Konto unter [claude.ai/connect-github](https://claude.ai/connect-github). Siehe [GitHub-Authentifizierungsoptionen](/docs/de/claude-code-on-the-web#github-authentication-options) für wie die beiden sich unterscheiden.3570* Führen Sie `/web-setup` aus, um Ihre GitHub CLI-Anmeldung mit Ihrem Claude-Konto zu verbinden, oder verbinden Sie ein Konto unter [claude.ai/connect-github](https://claude.ai/connect-github). Unter [GitHub-Authentifizierungsoptionen](/docs/de/claude-code-on-the-web#github-authentication-options) erfahren Sie, wie sich die beiden unterscheiden.

3550* Führen Sie den Befehl eine Minute nach der Verbindung erneut aus3571* Führen Sie den Befehl eine Minute nach dem Verbinden erneut aus

3551 3572

3552Vor v2.1.268 meldete Claude Code dies als vorübergehenden Fehler der Claude GitHub-App-Überprüfung und schlug vor, erneut zu versuchen oder die App zu installieren; keiner verbindet ein GitHub-Konto.3573Vor v2.1.268 meldete Claude Code dies als vorübergehenden Fehler der Claude GitHub App-Prüfung und schlug vor, es erneut zu versuchen oder die App zu installieren; keines von beiden verbindet ein GitHub-Konto.

3553 3574

3554<h3 id="single-sign-on-authorization-needed">3575<h3 id="single-sign-on-authorization-needed">

3555 Single-Sign-On-Autorisierung erforderlich3576 Single-Sign-On-Autorisierung erforderlich

3556</h3>3577</h3>

3557 3578

3558Sie haben [`/install-github-app`](/docs/de/github-actions#quick-setup) ausgeführt und ein Repository ausgewählt, dessen Organisation SAML-Single-Sign-On erzwingt. Bevor das Setup, überprüft Claude Code Ihren Zugriff auf das Repository mit der GitHub CLI, und GitHub lehnte diese Überprüfung ab, weil Ihr `gh`-Token noch nicht für die Organisation autorisiert ist. Der Assistent zeigt die Warnung mit den Schritten zur Autorisierung:3579Sie haben [`/install-github-app`](/docs/de/github-actions#quick-setup) ausgeführt und ein Repository gewählt, dessen Organisation SAML-Single-Sign-On erzwingt. Vor der Einrichtung prüft Claude Code Ihren Zugriff auf das Repository mit der GitHub CLI, und GitHub hat diese Prüfung abgelehnt, weil Ihr `gh`-Token noch nicht für die Organisation autorisiert ist. Der Assistent zeigt die Warnung mit den Schritten zur Autorisierung an:

3559 3580

3560```text theme={null}3581```text theme={null}

3561Single sign-on authorization needed3582Single sign-on authorization needed

3564 3585

3565**Was zu tun ist:**3586**Was zu tun ist:**

3566 3587

3567* Autorisieren Sie Ihre GitHub CLI-Anmeldung mit den `repo`- und `workflow`-Bereichen erneut, indem Sie `gh auth refresh -h github.com -s repo,workflow` ausführen, und autorisieren Sie die Organisation, wenn GitHub zur Single-Sign-On auffordert3588* Autorisieren Sie Ihre GitHub CLI-Anmeldung mit den Scopes `repo` und `workflow` erneut, indem Sie `gh auth refresh -h github.com -s repo,workflow` ausführen, und autorisieren Sie die Organisation, wenn GitHub zur Single-Sign-On-Anmeldung auffordert

3568* Wenn Sie sich mit einem persönlichen Zugangstoken in `GH_TOKEN` authentifizieren, öffnen Sie [github.com/settings/tokens](https://github.com/settings/tokens), wählen Sie **Configure SSO** auf dem Token und autorisieren Sie die Organisation3589* Wenn Sie sich mit einem Personal Access Token in `GH_TOKEN` authentifizieren, öffnen Sie [github.com/settings/tokens](https://github.com/settings/tokens), wählen Sie beim Token **Configure SSO** aus und autorisieren Sie die Organisation

3569* Führen Sie `/install-github-app` erneut aus3590* Führen Sie `/install-github-app` erneut aus

3570 3591

3571Vor v2.1.273 zeigte Claude Code die Warnung `Admin permissions required` für diese Bedingung statt.3592Vor v2.1.273 zeigte Claude Code für diesen Zustand stattdessen die Warnung `Admin permissions required` an.

3572 3593

3573<h3 id="failed-to-resume-the-conversation">3594<h3 id="failed-to-resume-the-conversation">

3574 Konversation konnte nicht fortgesetzt werden3595 Die Konversation konnte nicht fortgesetzt werden

3575</h3>3596</h3>

3576 3597

3577Claude Code konnte das gespeicherte Transkript für die Sitzung, die Sie aus der [`claude --resume`-Auswahl](/docs/de/sessions#use-the-session-picker) ausgewählt haben, nicht lesen oder verarbeiten, daher beendet es den Prozess, anstatt in einem teilweise geladenen Zustand fortzufahren. Die Meldung enthält den Befehl zum erneuten Versuchen:3598Claude Code konnte das gespeicherte Transkript der Sitzung, die Sie in der [`claude --resume`-Auswahl](/docs/de/sessions#use-the-session-picker) ausgewählt haben, nicht lesen oder verarbeiten, daher beendet es den Prozess, anstatt in einem teilweise geladenen Zustand fortzufahren. Die Meldung enthält den Befehl für einen erneuten Versuch:

3578 3599

3579```text theme={null}3600```text theme={null}

3580Failed to resume the conversation.3601Failed to resume the conversation.

3581Run claude --resume <session-id> to retry, or claude to start a new session.3602Run claude --resume <session-id> to retry, or claude to start a new session.

3582```3603```

3583 3604

3584Claude Code beendet sich mit Code 1 nach Anzeige der Meldung. Die `/resume`-Auswahl in einer laufenden Sitzung meldet `Failed to resume conversation` in der Konversation statt, und Ihre aktuelle Sitzung läuft weiter. Vor v2.1.216 blieb ein fehlgeschlagenes Resume aus der `claude --resume`-Auswahl auf dem `Resuming conversation…`-Spinner unbegrenzt, anstatt diese Meldung anzuzeigen.3605Claude Code beendet sich nach der Anzeige der Meldung mit Exit-Code 1. Die `/resume`-Auswahl innerhalb einer laufenden Sitzung meldet stattdessen `Failed to resume conversation` in der Konversation, und Ihre aktuelle Sitzung läuft weiter. Vor v2.1.216 blieb ein fehlgeschlagenes Fortsetzen aus der `claude --resume`-Auswahl unbegrenzt beim Spinner `Resuming conversation…` hängen, anstatt diese Meldung anzuzeigen.

3585 3606

3586**Was zu tun ist:**3607**Was zu tun ist:**

3587 3608

3588* Führen Sie `claude --resume <session-id>` mit der Sitzungs-ID aus der Meldung aus, um erneut zu versuchen3609* Führen Sie `claude --resume <session-id>` mit der Sitzungs-ID aus der Meldung aus, um es erneut zu versuchen

3589* Wenn jeder erneute Versuch auf die gleiche Weise fehlschlägt, führen Sie `claude update` aus und setzen Sie fort. Versionen vor v2.1.275 schlagen das Resume fehl, wenn das gespeicherte Transkript einen Eintrag enthält, den sie nicht lesen können.3610* Wenn jeder erneute Versuch auf dieselbe Weise fehlschlägt, führen Sie `claude update` aus und setzen Sie die Sitzung erneut fort. Versionen vor v2.1.275 lassen das Fortsetzen fehlschlagen, wenn das gespeicherte Transkript einen Eintrag enthält, den sie nicht lesen können.

3590* Wenn der erneute Versuch erneut fehlschlägt, führen Sie `claude` aus, um eine neue Sitzung zu starten3611* Wenn der erneute Versuch wieder fehlschlägt, führen Sie `claude` aus, um eine neue Sitzung zu starten

3591 3612

3592<h3 id="no-conversation-found-with-the-session-id">3613<h3 id="no-conversation-found-with-the-session-id">

3593 Keine Konversation mit der Sitzungs-ID gefunden3614 Keine Konversation mit der Sitzungs-ID gefunden

3594</h3>3615</h3>

3595 3616

3596Sie haben eine Sitzungs-ID an `claude --resume <session-id>` übergeben und kein gespeichertes Transkript stimmte überein:3617Sie haben eine Sitzungs-ID an `claude --resume <session-id>` übergeben, und kein gespeichertes Transkript stimmte damit überein:

3597 3618

3598```text theme={null}3619```text theme={null}

3599No conversation found with session ID: <session-id>3620No conversation found with session ID: <session-id>

3600```3621```

3601 3622

3602Claude Code beendet sich mit Code 1 nach Anzeige der Meldung. Claude Code [durchsucht zuerst das aktuelle Projekt, dann jedes andere Projekt auf dieser Maschine](/docs/de/sessions#resume-a-session) nach der ID. Vor v2.1.223 stoppte die Suche im aktuellen Projektverzeichnis und seinen Git-Worktrees, daher Resume aus dem Verzeichnis, in dem die Sitzung zuletzt funktionierte.3623Claude Code beendet sich nach der Anzeige der Meldung mit Exit-Code 1. Claude Code [durchsucht zuerst das aktuelle Projekt und dann jedes andere Projekt auf diesem Rechner](/docs/de/sessions#resume-a-session) nach der ID. Vor v2.1.223 beschränkte sich die Suche auf das aktuelle Projektverzeichnis und dessen Git-Worktrees, setzen Sie die Sitzung also aus dem Verzeichnis fort, in dem sie zuletzt gearbeitet hat.

3603 3624

3604Häufige Ursachen:3625Häufige Ursachen:

3605 3626

3606* **Falsch eingegebene ID**: Für einen nicht interaktiven Lauf ist die ID das `session_id`-Feld der [`--output-format json`-Ausgabe](/docs/de/headless#get-structured-output)3627* **Falsch eingegebene ID**: Bei einer nicht interaktiven Ausführung ist die ID das Feld `session_id` der [`--output-format json`-Ausgabe](/docs/de/headless#get-structured-output)

3607* **Gelöschtes Transkript**: Claude Code entfernt Transkripte nach der [Aufbewahrungsfrist](/docs/de/sessions#where-transcripts-are-stored), 30 Tage standardmäßig, nach den [Aufbewahrungssweep-Regeln](/docs/de/claude-directory#cleaned-up-automatically)3628* **Gelöschtes Transkript**: Claude Code entfernt Transkripte nach der [Aufbewahrungsfrist](/docs/de/sessions#where-transcripts-are-stored), standardmäßig 30 Tage, gemäß den [Regeln für die Aufbewahrungsbereinigung](/docs/de/claude-directory#cleaned-up-automatically)

3608* **Andere Maschine**: Claude Code speichert Transkripte lokal, daher Resume die Sitzung auf der Maschine, auf der sie ausgeführt wurde3629* **Anderer Rechner**: Claude Code speichert Transkripte lokal, setzen Sie die Sitzung also auf dem Rechner fort, auf dem sie ausgeführt wurde

3609* **Doppelte Kopien**: Wenn Sie ein Projektverzeichnis unter `~/.claude/projects` kopiert haben, so dass zwei Transkripte dieselbe ID tragen, meldet Claude Code diese Meldung, anstatt eine Kopie willkürlich fortzusetzen3630* **Doppelte Kopien**: Wenn Sie ein Projektverzeichnis unter `~/.claude/projects` kopiert haben, sodass zwei Transkripte dieselbe ID tragen, meldet Claude Code diese Meldung, anstatt willkürlich eine Kopie fortzusetzen

3610 3631

3611**Was zu tun ist:**3632**Was zu tun ist:**

3612 3633

3613* Für eine interaktive Sitzung öffnen Sie die [Sitzungsauswahl](/docs/de/sessions#use-the-session-picker) mit `claude --resume` und drücken Sie `Ctrl+A`, um sie auf jedes Projekt auf dieser Maschine zu erweitern, dann wählen Sie die Sitzung3634* Öffnen Sie für eine interaktive Sitzung die [Sitzungsauswahl](/docs/de/sessions#use-the-session-picker) mit `claude --resume` und drücken Sie `Ctrl+A`, um sie auf jedes Projekt auf diesem Rechner zu erweitern, und wählen Sie dann die Sitzung aus

3614* Sitzungen, die mit `claude -p` oder dem [Agent SDK](/docs/de/agent-sdk/overview) erstellt wurden, erscheinen nicht in der Auswahl, daher überprüfen Sie die ID erneut gegen die `session_id`, die Ihr ursprünglicher Lauf gedruckt hat3635* Sitzungen, die mit `claude -p` oder dem [Agent SDK](/docs/de/agent-sdk/overview) erstellt wurden, erscheinen nicht in der Auswahl, gleichen Sie die ID daher erneut mit der `session_id` ab, die Ihre ursprüngliche Ausführung ausgegeben hat

3615 3636

3616<h3 id="windows-reported-an-error-ebadf">3637<h3 id="windows-reported-an-error-ebadf">

3617 Windows meldete einen Fehler (EBADF), als Claude Code diese Sitzungs-Transkriptdatei las3638 Windows hat beim Lesen der Transkriptdatei dieser Sitzung durch Claude Code einen Fehler (EBADF) gemeldet

3618</h3>3639</h3>

3619 3640

3620Sie haben eine Sitzung unter Windows fortgesetzt, ihre gespeicherte [Transkriptdatei](/docs/de/sessions#where-transcripts-are-stored) wurde normal geöffnet, und das Lesen schlug dann mit dem Systemfehler EBADF fehl. Der Systemfehler sagt nicht, warum das Lesen fehlgeschlagen ist, daher schlägt die Meldung wahrscheinliche Ursachen und was zu versuchen ist vor:3641Sie haben unter Windows eine Sitzung fortgesetzt, ihre gespeicherte [Transkriptdatei](/docs/de/sessions#where-transcripts-are-stored) wurde normal geöffnet, und das Lesen schlug anschließend mit dem Systemfehler EBADF fehl. Der Systemfehler gibt keinen Grund an, warum das Lesen fehlgeschlagen ist. Daher nennt die Meldung wahrscheinliche Ursachen und mögliche Lösungsschritte:

3621 3642

3622```text theme={null}3643```text theme={null}

3623Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.3644Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.

3624```3645```

3625 3646

3626Die Meldung folgt der Fehlerleitung des Befehls selbst, wie `Failed to resume session <session-id>`. Ein `claude --resume` oder [`claude -p`](/docs/de/headless)-Befehl beendet sich mit Code 1 nach Anzeige. Nach `/resume` in einer Sitzung läuft Ihre aktuelle Sitzung weiter.3647Die Meldung folgt auf die eigene Fehlerzeile des Befehls, etwa `Failed to resume session <session-id>`. Ein Befehl `claude --resume` oder [`claude -p`](/docs/de/headless) wird nach der Anzeige mit Code 1 beendet. Nach `/resume` innerhalb einer Sitzung läuft Ihre aktuelle Sitzung weiter.

3627 3648

3628**Was zu tun ist:**3649**Vorgehensweise:**

3629 3650

3630* Schließen Sie den Ordner aus, der Ihre Sitzungs-Transkripte enthält, von Software aus, die Dateilesevorgänge scannt oder abfängt, wie Sicherheits-, Verschlüsselungs- oder Endpoint-Management-Tools. Transkripte befinden sich standardmäßig unter `%USERPROFILE%\.claude\projects` oder unter dem Verzeichnis, das [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) benennt3651* Schließen Sie den Ordner mit Ihren Sitzungstranskripten von Software aus, die Dateilesevorgänge scannt oder abfängt, etwa Sicherheits-, Verschlüsselungs- oder Endpoint-Management-Tools. Transkripte liegen standardmäßig unter `%USERPROFILE%\.claude\projects` oder unter dem Verzeichnis, das [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) angibt

3631* Wenn Sie keine Ausschlussmöglichkeit hinzufügen können, fügen Sie Claude Code stattdessen zu den zulässigen Anwendungen dieser Software hinzu3652* Wenn Sie keine Ausnahme hinzufügen können, fügen Sie Claude Code stattdessen zu den zugelassenen Anwendungen dieser Software hinzu

3632* Setzen Sie die Sitzung erneut fort3653* Setzen Sie die Sitzung erneut fort

3633 3654

3634Vor v2.1.282 kam der Fehler ohne Erklärung: `claude --resume <session-id>` endete bei `Failed to resume session <session-id>`, und ein `-p`-Lauf druckte nur den Systemfehlertext, wie `Failed to resume session: EBADF: bad file descriptor, read`.3655Vor v2.1.282 trat der Fehler ohne Erklärung auf: `claude --resume <session-id>` endete mit `Failed to resume session <session-id>`, und ein `-p`-Lauf gab nur den Text des Systemfehlers aus, etwa `Failed to resume session: EBADF: bad file descriptor, read`.

3635 3656

3636<h3 id="cannot-switch-renderers-in-this-session">3657<h3 id="cannot-switch-renderers-in-this-session">

3637 Renderer können in dieser Sitzung nicht gewechselt werden3658 Renderer kann in dieser Sitzung nicht gewechselt werden

3638</h3>3659</h3>

3639 3660

3640Wenn Sie Renderer wechseln, startet Claude Code seinen Prozess neu. Sie haben [`/tui`](/docs/de/fullscreen#enable-fullscreen-rendering) in einer Sitzung ausgeführt, die Claude Code ablehnt neu zu starten, daher wechselt es nicht und speichert nichts. Welche Meldung Sie sehen, sagt Ihnen die Ursache:3661Wenn Sie den Renderer wechseln, startet Claude Code seinen Prozess neu. Sie haben [`/tui`](/docs/de/fullscreen#enable-fullscreen-rendering) in einer Sitzung ausgeführt, die Claude Code nicht neu starten will. Daher findet kein Wechsel statt und nichts wird gespeichert. Welche Meldung Sie sehen, verrät die Ursache:

~~3641~~

3642* `Cannot switch renderers while work is running in the background`: Sie haben Hintergrundarbeit, die ein Neustart aufgeben würde, wie eine Background-Shell oder einen Subagenten. Warten Sie, bis die Arbeit fertig ist, oder stoppen Sie sie mit [`/tasks`](/docs/de/commands), dann führen Sie `/tui fullscreen` oder `/tui default` erneut aus

3643*

3644 3662

3645`Cannot switch renderers in this session`: Die Sitzung hat Einschränkungen, die Claude Code nicht an den neu gestarteten Prozess übergeben kann. Vor v2.1.234 startete Claude Code trotzdem neu und die neu gestartete Sitzung lief ohne sie3663* `Cannot switch renderers while work is running in the background`: Im Hintergrund läuft Arbeit, die ein Neustart abbrechen würde, etwa eine Hintergrund-Shell oder ein Subagent. Warten Sie, bis die Arbeit abgeschlossen ist, oder beenden Sie sie mit [`/tasks`](/docs/de/commands), und führen Sie dann erneut `/tui fullscreen` oder `/tui default` aus

3664* `Cannot switch renderers in this session`: Die Sitzung hat Einschränkungen, die Claude Code nicht an den neu gestarteten Prozess übergeben kann. Vor v2.1.234 startete Claude Code trotzdem neu, und die neu gestartete Sitzung lief ohne diese Einschränkungen

3646 3665

3647In der Einschränkungsmeldung benennt der Teil in Klammern die Einschränkungen, die Claude Code gefunden hat:3666In der Meldung zu den Einschränkungen nennt der Teil in Klammern die Einschränkungen, die Claude Code gefunden hat:

3648 3667

3649```text theme={null}3668```text theme={null}

3650Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.3669Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.

3651```3670```

3652 3671

3653Jeder Grund, den die Meldung in Klammern zeigen kann:3672Jeder Grund, den die Meldung in Klammern anzeigen kann:

3654 3673

3655* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: Sie haben die Sitzung mit einem Flag gestartet, das Claude Code nicht an den neu gestarteten Prozess zurückgibt. Diese Flags umfassen [`--system-prompt`](/docs/de/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, eine [`--tools`](/docs/de/cli-reference#cli-flags)-Allowlist, [`--setting-sources`](/docs/de/cli-reference#cli-flags) und [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags)3674* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: Sie haben die Sitzung mit einem Flag gestartet, das Claude Code nicht an den neu gestarteten Prozess zurückgibt. Zu diesen Flags gehören [`--system-prompt`](/docs/de/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, eine [`--tools`](/docs/de/cli-reference#cli-flags)-Allowlist, [`--setting-sources`](/docs/de/cli-reference#cli-flags) und [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags)

3656* `permission rules set for this session only`: Ein [Berechtigungsupdate](/docs/de/hooks#permission-update-entries) aus einem Hook oder SDK-Aufrufer hat Deny- oder Ask-Regeln mit dem `session`-Ziel hinzugefügt. Sitzungsspezifische Allow-Regeln lösen die Ablehnung nicht aus. Ein Neustart löscht sie, und Claude Code fragt stattdessen erneut3675* `permission rules set for this session only`: Ein [Berechtigungs-Update](/docs/de/hooks#permission-update-entries) von einem Hook oder SDK-Aufrufer hat deny- oder ask-Regeln mit dem Ziel `session` hinzugefügt. Sitzungsbezogene allow-Regeln lösen die Ablehnung nicht aus. Ein Neustart verwirft sie, und Claude Code fragt stattdessen erneut nach

3657* `ask-before-running rules with no command-line form`: Ein Berechtigungsupdate aus einem Hook oder SDK-Aufrufer hat Ask-Regeln neben den Regeln hinzugefügt, die Claude Code als `--allowed-tools` und `--disallowed-tools` zurückgibt. Kein Flag existiert für Ask-Regeln3676* `ask-before-running rules with no command-line form`: Ein Berechtigungs-Update von einem Hook oder SDK-Aufrufer hat ask-Regeln zusätzlich zu den Regeln hinzugefügt, die Claude Code als `--allowed-tools` und `--disallowed-tools` zurückgibt. Für ask-Regeln gibt es kein Flag

3658* `permission rules a command line cannot carry intact` und `added directories a command line cannot carry intact`: Ein Berechtigungsupdate hat eine Regel oder einen Verzeichnispfad mid-session hinzugefügt. Die Befehlszeile des neu gestarteten Prozesses kann seinen Text nicht als denselben Wert tragen3677* `permission rules a command line cannot carry intact` und `added directories a command line cannot carry intact`: Ein Berechtigungs-Update hat während der Sitzung eine Regel oder einen Verzeichnispfad hinzugefügt. Die Befehlszeile des neu gestarteten Prozesses kann deren Text nicht als denselben Wert übernehmen

3659 3678

3660**Was zu tun ist:**3679**Vorgehensweise:**

3661 3680

3662* Führen Sie in einer Sitzung, die ohne diese Einschränkungen gestartet wurde, `/tui fullscreen` oder `/tui default` aus, um zurückzuwechseln. Claude Code speichert die [`tui`-Einstellung](/docs/de/settings-reference#tui) dort3681* Führen Sie in einer Sitzung, die ohne diese Einschränkungen gestartet wurde, `/tui fullscreen` aus bzw. `/tui default`, um zurückzuwechseln. Claude Code speichert dort die [`tui`-Einstellung](/docs/de/settings-reference#tui)

3663 3682

3664<h3 id="couldnt-open-claude-desktop">3683<h3 id="couldnt-open-claude-desktop">

3665 Claude Desktop konnte nicht geöffnet werden3684 Claude Desktop konnte nicht geöffnet werden

3666</h3>3685</h3>

3667 3686

3668Sie haben [`/desktop`](/docs/de/desktop#coming-from-the-cli) oder seinen Alias `/app` in einer Sitzung ausgeführt, oder [`claude --desktop`](/docs/de/cli-reference#cli-flags) in Ihrer Shell, und der System-Befehl, den Claude Code zum Öffnen von Claude Desktop verwendet, ist fehlgeschlagen. Nach `/desktop` bleibt die Sitzung im Terminal; `claude --desktop` druckt die Meldung ohne das `Error:`-Präfix und beendet sich mit Status 1.3687Sie haben [`/desktop`](/docs/de/desktop#coming-from-the-cli) oder dessen Alias `/app` in einer Sitzung oder [`claude --desktop`](/docs/de/cli-reference#cli-flags) in Ihrer Shell ausgeführt, und der Systembefehl, mit dem Claude Code Claude Desktop öffnet, ist fehlgeschlagen. Nach `/desktop` bleibt die Sitzung im Terminal; `claude --desktop` gibt die Meldung ohne das Präfix `Error:` aus und wird mit Status 1 beendet.

3669 3688

3670Der Text in Klammern benennt den Befehl, der fehlgeschlagen ist, mit seinem Exit-Status und der ersten Zeile seiner Fehlerausgabe, wenn er sie erzeugt hat. Auf macOS ist dieser Befehl `open`, wie in diesem Beispiel; unter Windows ist es `rundll32`:3689Der Text in Klammern nennt den fehlgeschlagenen Befehl mit seinem Exit-Status und der ersten Zeile seiner Fehlerausgabe, sofern er diese erzeugt hat. Unter macOS ist dieser Befehl `open`, wie in diesem Beispiel; unter Windows ist es `rundll32`:

3671 3690

3672```text theme={null}3691```text theme={null}

3673Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.3692Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.

3674```3693```

3675 3694

3676**Was zu tun ist:**3695**Vorgehensweise:**

3677 3696

3678* Öffnen Sie Claude Desktop selbst, dann führen Sie `/desktop` oder `claude --desktop` erneut aus3697* Öffnen Sie Claude Desktop selbst und führen Sie dann erneut `/desktop` oder `claude --desktop` aus

3679* Um die vollständige Fehlerausgabe dieses Befehls zu lesen, aktivieren Sie Debug-Protokollierung mit `/debug` und führen Sie `/desktop` erneut aus, oder führen Sie `claude --desktop --debug-file <path>` aus, dann überprüfen Sie das Debug-Protokoll3698* Um die vollständige Fehlerausgabe des fehlgeschlagenen Befehls zu lesen, aktivieren Sie das Debug-Logging mit `/debug` und führen Sie `/desktop` erneut aus, oder führen Sie `claude --desktop --debug-file <path>` aus, und prüfen Sie anschließend das Debug-Log

3680 3699

3681Vor v2.1.285 endete die Meldung mit `Open Claude Desktop and run /desktop again.` Vor v2.1.275 war es `Failed to open Claude Desktop. Please try opening it manually.` und sagte nicht, was fehlgeschlagen ist.3700Vor v2.1.285 endete die Meldung mit `Open Claude Desktop and run /desktop again.` Vor v2.1.275 lautete sie `Failed to open Claude Desktop. Please try opening it manually.` und gab nicht an, was fehlgeschlagen war.

3682 3701

3683<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3702<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3684 /terminal-setup hat Ihre Zed-Tastaturzuordnung unverändert gelassen3703 /terminal-setup hat Ihre Zed-Keymap unverändert gelassen

3685</h3>3704</h3>

3686 3705

3687Sie haben [`/terminal-setup`](/docs/de/terminal-config#enter-multiline-prompts) in Zed ausgeführt, und Claude Code konnte das Update zu Ihrer Zed `keymap.json` nicht abschließen, daher hat es die Datei unverändert gelassen.3706Sie haben [`/terminal-setup`](/docs/de/terminal-config#enter-multiline-prompts) in Zed ausgeführt, und Claude Code konnte die Aktualisierung Ihrer Zed-Datei `keymap.json` nicht abschließen. Daher wurde die Datei unverändert gelassen.

3688 3707

3689Jede Meldung benennt den Pfad zu Ihrer Tastaturzuordnung und endet mit dem Tastaturzuordnungsblock, den Sie selbst hinzufügen:3708Jede Meldung nennt den Pfad zu Ihrer Keymap und endet mit dem Tastenkombinationsblock, den Sie selbst hinzufügen können:

3690 3709

3691```text theme={null}3710```text theme={null}

3692Couldn't update your Zed keymap, so it was left unchanged.3711Couldn't update your Zed keymap, so it was left unchanged.

3694{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }3713{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }

3695```3714```

3696 3715

3697Die erste Zeile der Meldung benennt die Ursache:3716Die erste Zeile der Meldung nennt die Ursache:

3698 3717

3699* `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code konnte die Datei nicht lesen, z. B. wegen Dateiberechtigungen3718* `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code konnte die Datei nicht lesen, zum Beispiel aufgrund von Dateiberechtigungen

3700* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: Die Datei las sich gut, aber analysiert nicht als Array von Tastaturzuordnungsblöcken, auch mit `//`-Kommentaren und nachfolgenden Kommas erlaubt3719* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: Die Datei wurde gelesen, lässt sich aber nicht als Array von Tastenkombinationsblöcken parsen, selbst wenn `//`-Kommentare und nachgestellte Kommas zugelassen werden

3701* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code konnte die Datei nicht zu einer `.bak`-Sicherung daneben kopieren, daher hat es nichts geändert3720* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code konnte die Datei nicht in eine `.bak`-Sicherung daneben kopieren und hat daher nichts geändert

3702* `Couldn't update your Zed keymap, so it was left unchanged.`: Das zusammengeführte Ergebnis überprüfte nicht als gültige Tastaturzuordnung, die die Bindung trägt, daher verwarf Claude Code es, anstatt zu schreiben. Ein Tastaturzuordnungsblock mit einem duplizierten Schlüssel kann dies verursachen3721* `Couldn't update your Zed keymap, so it was left unchanged.`: Das zusammengeführte Ergebnis ließ sich nicht als gültige Keymap mit der Tastenkombination verifizieren, daher hat Claude Code es verworfen, statt es zu schreiben. Ein Tastenkombinationsblock mit einem doppelten Schlüssel kann dies verursachen

3703 3722

3704**Was zu tun ist:**3723**Vorgehensweise:**

3705 3724

3706* Kopieren Sie den Block aus der Meldung in das Top-Level-Array in Ihrer `keymap.json` unter dem Pfad, den die Meldung benennt3725* Kopieren Sie den Block aus der Meldung in das oberste Array Ihrer `keymap.json` unter dem Pfad, den die Meldung nennt

3707* Für `isn't a readable list of keybindings`, beheben Sie den Syntaxfehler oder machen Sie den Top-Level-Wert der Datei ein Array, dann führen Sie `/terminal-setup` erneut aus3726* Bei `isn't a readable list of keybindings` beheben Sie den Syntaxfehler oder machen Sie den obersten Wert der Datei zu einem Array, und führen Sie dann erneut `/terminal-setup` aus

3708 3727

3709Vor v2.1.247 konnte `/terminal-setup` eine Zed-Tastaturzuordnung, die `//`-Kommentare oder nachfolgende Kommas verwendete, nicht analysieren, und es ersetzte die gesamte Datei mit nur seiner eigenen Bindung, während es die Bindung als installiert meldete. Um eine Tastaturzuordnung wiederherzustellen, die eine frühere Version ersetzte, verwenden Sie die `.bak`-Sicherungsdatei, die unter [Mehrzeilige Eingabeaufforderungen eingeben](/docs/de/terminal-config#enter-multiline-prompts) beschrieben ist.3728Vor v2.1.247 konnte `/terminal-setup` eine Zed-Keymap mit `//`-Kommentaren oder nachgestellten Kommas nicht parsen und ersetzte die gesamte Datei nur durch die eigene Tastenkombination, während es die Tastenkombination als installiert meldete. Um eine Keymap wiederherzustellen, die eine frühere Version ersetzt hat, verwenden Sie die `.bak`-Sicherungsdatei, die unter [Mehrzeilige Prompts eingeben](/docs/de/terminal-config#enter-multiline-prompts) beschrieben ist.

3710 3729

3711<h3 id="skill-usage-reports-are-not-available-on-this-connection">3730<h3 id="skill-usage-reports-are-not-available-on-this-connection">

3712 Skill-Nutzungsberichte sind auf dieser Verbindung nicht verfügbar3731 Skill-Nutzungsberichte sind über diese Verbindung nicht verfügbar

3713</h3>3732</h3>

3714 3733

3715Sie haben [`/skill-doctor`](/docs/de/skills#find-unused-skills) über [Remote-Steuerung](/docs/de/remote-control) ausgeführt, von Ihrem Telefon oder Browser. Claude Code sendet den Skill-Nutzungsbericht nicht über Remote-Steuerung und antwortet stattdessen mit dieser Meldung:3734Sie haben [`/skill-doctor`](/docs/de/skills#find-unused-skills) über [Remote Control](/docs/de/remote-control) von Ihrem Smartphone oder Browser aus ausgeführt. Claude Code sendet den Skill-Nutzungsbericht nicht über Remote Control und antwortet stattdessen mit dieser Meldung:

3716 3735

3717```text theme={null}3736```text theme={null}

3718Skill usage reports are not available on this connection.3737Skill usage reports are not available on this connection.

3719```3738```

3720 3739

3721**Was zu tun ist:**3740**Vorgehensweise:**

3722 3741

3723* Führen Sie `/skill-doctor` im Terminal auf der Maschine aus, auf der die Sitzung ausgeführt wird, oder führen Sie `claude -p "/skill-doctor"` dort aus3742* Führen Sie `/skill-doctor` im Terminal auf dem Rechner aus, auf dem die Sitzung läuft, oder führen Sie dort `claude -p "/skill-doctor"` aus

3724 3743

3725<h3 id="custom-output-styles-cant-be-selected-over-remote-control">3744<h3 id="custom-output-styles-cant-be-selected-over-remote-control">

3726 Benutzerdefinierte Ausgabestile können nicht über Remote-Steuerung ausgewählt werden3745 Benutzerdefinierte Ausgabestile können nicht über Remote Control ausgewählt werden

3727</h3>3746</h3>

3728 3747

3729Sie haben [`/output-style`](/docs/de/output-styles#change-your-output-style) von der mobilen App oder dem Web über [Remote-Steuerung](/docs/de/remote-control) ausgeführt, oder der Befehl kam in einer Nachricht an, die in die Sitzung weitergeleitet wurde. Da ein solcher Zug möglicherweise nicht vom Kontoinhaber kommt, listet Claude Code nur [integrierte Stile](/docs/de/output-styles#built-in-output-styles) auf und wählt sie aus, und fügt diese Notiz hinzu, wenn der Befehl die Stile auflistet oder den Namen, den Sie angegeben haben, nicht erkennt. Ein [benutzerdefinierter Stil](/docs/de/output-styles#create-a-custom-output-style)-Name erhält die gleiche Antwort wie ein Name, der nicht existiert:3748Sie haben [`/output-style`](/docs/de/output-styles#change-your-output-style) über [Remote Control](/docs/de/remote-control) aus der mobilen App oder dem Web ausgeführt, oder der Befehl kam in einer Nachricht an, die in die Sitzung weitergeleitet wurde. Da ein solcher Turn möglicherweise nicht vom Kontoinhaber stammt, listet Claude Code darin nur [integrierte Stile](/docs/de/output-styles#built-in-output-styles) auf und lässt nur diese auswählen. Es fügt diesen Hinweis immer dann hinzu, wenn der Befehl die Stile auflistet oder den angegebenen Namen nicht erkennt. Der Name eines [benutzerdefinierten Stils](/docs/de/output-styles#create-a-custom-output-style) erhält dieselbe Antwort wie ein Name, der nicht existiert:

3730 3749

3731```text theme={null}3750```text theme={null}

3732Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.3751Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.

3733```3752```

3734 3753

3735**Was zu tun ist:**3754**Vorgehensweise:**

3736 3755

3737* Wählen Sie einen integrierten Stil, z. B. `/output-style concise`3756* Wählen Sie einen integrierten Stil, zum Beispiel `/output-style concise`

3738* Um einen benutzerdefinierten Stil zu verwenden, setzen Sie [`outputStyle`](/docs/de/settings-reference#outputstyle) in der Datei `.claude/settings.local.json` des Projekts, oder führen Sie `/output-style <style>` im Terminal der Sitzung selbst aus, wenn es eines hat3757* Um einen benutzerdefinierten Stil zu verwenden, setzen Sie [`outputStyle`](/docs/de/settings-reference#outputstyle) in der Datei `.claude/settings.local.json` des Projekts, oder führen Sie `/output-style <style>` im eigenen Terminal der Sitzung aus, falls sie eines hat

3739 3758

3740<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">3759<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">

3741 Ausgabestile werden in lokalen Einstellungen gespeichert, die diese Sitzung nicht lädt3760 Ausgabestile werden in lokalen Einstellungen gespeichert, die diese Sitzung nicht lädt

3742</h3>3761</h3>

3743 3762

3744Sie haben versucht, [Ausgabestile](/docs/de/output-styles) mit `/output-style <style>` oder `/config outputStyle=<style>` in einer Sitzung zu wechseln, deren Einstellungsquellen `local` ausschließen. Beispiele sind eine [Agent SDK](/docs/de/agent-sdk/typescript)-Sitzung, deren [`settingSources`](/docs/de/agent-sdk/typescript#options) `"local"` auslässt, und eine CLI-Sitzung, die mit einem [`--setting-sources`](/docs/de/cli-reference#cli-flags)-Wert gestartet wurde, der `local` auslässt. Beide Befehle speichern den Stil in `.claude/settings.local.json`, eine Datei, die eine solche Sitzung nie zurückliest, daher weigert sich Claude Code, anstatt eine Einstellung zu schreiben, die keine Auswirkung hätte:3763Sie haben versucht, mit `/output-style <style>` oder `/config outputStyle=<style>` den [Ausgabestil](/docs/de/output-styles) in einer Sitzung zu wechseln, deren Einstellungsquellen `local` ausschließen. Beispiele sind eine [Agent SDK](/docs/de/agent-sdk/typescript)-Sitzung, deren [`settingSources`](/docs/de/agent-sdk/typescript#options) `"local"` auslässt, und eine CLI-Sitzung, die mit einem [`--setting-sources`](/docs/de/cli-reference#cli-flags)-Wert gestartet wurde, der `local` auslässt. Beide Befehle speichern den Stil in `.claude/settings.local.json`, einer Datei, die eine solche Sitzung nie wieder einliest. Daher lehnt Claude Code den Wechsel ab, statt eine Einstellung zu schreiben, die keine Wirkung hätte:

3745 3764

3746```text theme={null}3765```text theme={null}

3747Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.3766Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.

3748```3767```

3749 3768

3750**Was zu tun ist:**3769**Vorgehensweise:**

3751 3770

3752* Fügen Sie `local` zu den Einstellungsquellen der Sitzung hinzu und wechseln Sie erneut3771* Fügen Sie `local` zu den Einstellungsquellen der Sitzung hinzu und wechseln Sie erneut

3753* Setzen Sie den [`outputStyle`](/docs/de/settings-reference#outputstyle)-Schlüssel in einer Einstellungsdatei, die die Sitzung lädt, wie `.claude/settings.json` im Projekt oder `~/.claude/settings.json`. Im TypeScript SDK setzen Sie stattdessen `outputStyle` im Inline-`settings`-Objekt; siehe [Aktivieren Sie einen Ausgabestil](/docs/de/agent-sdk/modifying-system-prompts#activate-an-output-style)3772* Setzen Sie den Schlüssel [`outputStyle`](/docs/de/settings-reference#outputstyle) in einer Einstellungsdatei, die die Sitzung lädt, etwa `.claude/settings.json` im Projekt oder `~/.claude/settings.json`. Im TypeScript SDK setzen Sie `outputStyle` stattdessen im Inline-Objekt `settings`; siehe [Einen Ausgabestil aktivieren](/docs/de/agent-sdk/modifying-system-prompts#activate-an-output-style)

3754 3773

3755<h2 id="plugin-errors">3774<h2 id="plugin-errors">

3756 Plugin-Fehler3775 Plugin-Fehler

4478 Fehler in Hintergrund-Sitzungen4497 Fehler in Hintergrund-Sitzungen

4479</h2>4498</h2>

4480 4499

4481[Hintergrund-Sitzungen](/docs/de/agent-view) laufen ohne eigenes interaktives Terminal, daher verhalten sich Befehle, die eines benötigen, dort anders. Diese Meldungen erscheinen im Transkript einer Hintergrund-Sitzung, im Terminal, das sich an eine angehängt, in der Sitzung oder Shell, von der Sie sie entsenden, oder für die [Worktree-Guard-Einträge](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) unten in jeder Sitzung, die in einem Worktree isoliert ist oder einen Worktree-isolierten Subagenten ausführt; wenn eine Meldung spezifisch für eine Oberfläche ist, gibt ihr Eintrag das an.4500[Hintergrund-Sitzungen](/docs/de/agent-view) laufen ohne eigenes interaktives Terminal, daher verhalten sich Befehle, die eines benötigen, dort anders. Diese Meldungen erscheinen im Transkript einer Hintergrund-Sitzung, im Terminal, das sich an eine anhängt, in der Sitzung oder Shell, von der Sie sie entsenden, oder für die [Worktree-Guard-Einträge](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) unten in jeder Sitzung, die in einem Worktree isoliert ist oder einen Worktree-isolierten Subagenten ausführt; wenn eine Meldung spezifisch für eine Oberfläche ist, gibt ihr Eintrag das an.

4482 4501

4483<h3 id="commands-refused-in-a-background-session">4502<h3 id="commands-refused-in-a-background-session">

4484 Befehle, die in einer Hintergrund-Sitzung abgelehnt werden4503 Befehle, die in einer Hintergrund-Sitzung abgelehnt werden

4486 4505

4487Befehle, die einen interaktiven Dialog öffnen, können dies nicht tun, während kein Terminal an eine Hintergrund-Sitzung angehängt ist. `/install-github-app`, die `/mcp`-Einstellungsliste und die Authentifizierungsaktionen im MCP-Server-Menü antworten mit einer Meldung. Für `/install-github-app` und die `/mcp`-Einstellungsliste wird die Sitzung auch unter **Needs input** in der [Agent-Ansicht](/docs/de/agent-view) angezeigt, damit Sie sie finden, anhängen und den Befehl erneut ausführen können. Während ein Terminal angehängt ist, funktionieren diese Befehle normal.4506Befehle, die einen interaktiven Dialog öffnen, können dies nicht tun, während kein Terminal an eine Hintergrund-Sitzung angehängt ist. `/install-github-app`, die `/mcp`-Einstellungsliste und die Authentifizierungsaktionen im MCP-Server-Menü antworten mit einer Meldung. Für `/install-github-app` und die `/mcp`-Einstellungsliste wird die Sitzung auch unter **Needs input** in der [Agent-Ansicht](/docs/de/agent-view) angezeigt, damit Sie sie finden, anhängen und den Befehl erneut ausführen können. Während ein Terminal angehängt ist, funktionieren diese Befehle normal.

4488 4507

4489Vor v2.1.216 wurde die Sitzung nach `/install-github-app` oder der `/mcp`-Einstellungsliste nicht unter **Needs input** angezeigt. In v2.1.213 bis v2.1.215 funktionieren die Befehle weiterhin, während ein Terminal angehängt ist, und die Ablehnungsmeldung sagte Ihnen, dass Sie anhängen und den Befehl erneut ausführen sollen. Von v2.1.208 bis v2.1.212 lehnte Claude Code sie sogar ab, während ein Terminal angehängt war, mit einer Meldung wie `Can't open MCP settings in a background session`; auf diesen Versionen führen Sie den Befehl stattdessen aus einer regulären `claude`-Sitzung aus oder aktualisieren. Vor v2.1.208 öffneten sie ihren Dialog innerhalb der Hintergrund-Sitzung. In v2.1.208 nur lehnte Claude Code auch die `/model`-Auswahl in einer Hintergrund-Sitzung ab, und `/upgrade` druckte die Upgrade-URL aus, anstatt einen Browser zu öffnen.4508Vor v2.1.216 wurde die Sitzung nach `/install-github-app` oder der `/mcp`-Einstellungsliste nicht unter **Needs input** angezeigt. In v2.1.213 bis v2.1.215 funktionierten die Befehle weiterhin, während ein Terminal angehängt war, und die Ablehnungsmeldung sagte Ihnen, dass Sie anhängen und den Befehl erneut ausführen sollen. Von v2.1.208 bis v2.1.212 lehnte Claude Code sie sogar ab, während ein Terminal angehängt war, mit einer Meldung wie `Can't open MCP settings in a background session`; auf diesen Versionen führen Sie den Befehl stattdessen aus einer regulären `claude`-Sitzung aus oder aktualisieren. Vor v2.1.208 öffneten sie ihren Dialog innerhalb der Hintergrund-Sitzung. Nur in v2.1.208 lehnte Claude Code auch die `/model`-Auswahl in einer Hintergrund-Sitzung ab, und `/upgrade` gab die Upgrade-URL aus, anstatt einen Browser zu öffnen.

4490 4509

4491Die Formulierung nennt den Befehl. Die `/mcp`-Einstellungsliste meldet:4510Die Formulierung nennt den Befehl. Die `/mcp`-Einstellungsliste meldet:

4492 4511

4497**Was zu tun ist:**4516**Was zu tun ist:**

4498 4517

4499* Hängen Sie sich von der Agent-Ansicht an die Sitzung an und führen Sie den Befehl erneut aus4518* Hängen Sie sich von der Agent-Ansicht an die Sitzung an und führen Sie den Befehl erneut aus

4500* Oder verwenden Sie das Formular, das die Meldung nennt, wie `/mcp reconnect <server>`, `/mcp enable` oder `/mcp disable`, die ohne Anhängen funktionieren4519* Oder verwenden Sie die Form, die die Meldung nennt, wie `/mcp reconnect <server>`, `/mcp enable` oder `/mcp disable`, die ohne Anhängen funktionieren

4501 4520

4502<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">4521<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">

4503 Schreib- oder Befehlsoperation blockiert, da der Pfad nicht sicher aufgelöst werden kann4522 Schreib- oder Befehlsoperation blockiert, da der Pfad nicht sicher aufgelöst werden kann

4504</h3>4523</h3>

4505 4524

4506Claude hat auf eine Datei oder ein Arbeitsverzeichnis durch eine Schreibweise zugegriffen, die der [Worktree-Isolations-Guard](/docs/de/agent-view#how-file-edits-are-isolated) nicht zu einem verifizierbaren Ort auflösen kann. Der Guard überprüft Schreibvorgänge und Befehlsarbeitsverzeichnisse in [jeder Sitzung, die in einem Worktree isoliert ist](/docs/de/worktrees#how-claude-code-enforces-isolation), interaktiv oder im Hintergrund, und in [Worktree-isolierten Subagenten](/docs/de/worktrees#isolate-subagents-with-worktrees). Er löst Symlinks auf, bevor er überprüft, dass die Operation den gemeinsamen Checkout nicht erreicht, und wenn die Auflösung fehlschlägt, blockiert er die Operation, anstatt sie dort landen zu lassen. Die Meldung nennt die Pfadformen, die er ablehnt, und wie Sie erneut versuchen:4525Claude hat auf eine Datei oder ein Arbeitsverzeichnis durch eine Schreibweise zugegriffen, die der [Worktree-Isolations-Guard](/docs/de/agent-view#how-file-edits-are-isolated) nicht zu einem verifizierbaren Ort auflösen kann. Der Guard überprüft Schreibvorgänge und Befehlsarbeitsverzeichnisse in [jeder Sitzung, die in einem Worktree isoliert ist](/docs/de/worktrees#how-claude-code-enforces-isolation), interaktiv oder im Hintergrund, und in [Worktree-isolierten Subagenten](/docs/de/worktrees#isolate-subagents-with-worktrees). Er löst Symlinks auf, bevor er überprüft, dass die Operation den gemeinsamen Checkout nicht erreicht, und wenn die Auflösung fehlschlägt, blockiert er die Operation, anstatt sie dort landen zu lassen. Die Meldung nennt die Pfadformen, die er ablehnt, und wie Sie es erneut versuchen:

4507 4526

4508```text theme={null}4527```text theme={null}

4509This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.4528This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.

4510```4529```

4511 4530

4512Ein blockierter Befehl meldet die gleiche Ursache für sein Arbeitsverzeichnis und endet mit `re-run the command from its direct symlink-free path`. Vor v2.1.217 verglich der Guard Pfadschreibweisen ohne Symlinks aufzulösen, daher wurden diese Schreibweisen nicht blockiert und ein Schreibvorgang, der durch einen Symlink geleitet wurde, konnte im gemeinsamen Checkout landen.4531Ein blockierter Befehl meldet die gleiche Ursache für sein Arbeitsverzeichnis und endet mit `re-run the command from its direct symlink-free path`. Vor v2.1.217 verglich der Guard Pfadschreibweisen, ohne Symlinks aufzulösen, daher wurden diese Schreibweisen nicht blockiert und ein Schreibvorgang, der durch einen Symlink geleitet wurde, konnte im gemeinsamen Checkout landen.

4513 4532

4514**Was zu tun ist:**4533**Was zu tun ist:**

4515 4534

4516* Normalerweise nichts: Die vollständige Meldung geht an Claude als Werkzeugfehler, und Claude versucht es erneut mit dem direkten Pfad, den sie nennt. Für einen blockierten Datei-Edit zeigt die Gesprächsansicht nur eine kurze `Error editing file`-Zeile; die vollständige Meldung erscheint in der Transkript-Ansicht, die Sie mit `Ctrl+O` öffnen. Ein blockierter Befehl druckt ihn in seiner Befehlsausgabe.4535* Normalerweise nichts: Die vollständige Meldung geht an Claude als Tool-Fehler, und Claude versucht es erneut mit dem direkten Pfad, den sie nennt. Für einen blockierten Datei-Edit zeigt die Konversationsansicht nur eine kurze `Error editing file`-Zeile; die vollständige Meldung erscheint in der Transkript-Ansicht, die Sie mit `Ctrl+O` öffnen. Ein blockierter Befehl gibt sie in seiner Befehlsausgabe aus.

4517* Wenn die Blockierung bei derselben Datei wiederholt wird, läuft der Pfad wahrscheinlich durch einen committeten Symlink, dessen Ziel `..` enthält, wie `docs/current -> ../README.md`; bitten Sie Claude, die Zieldatei stattdessen über ihren echten Pfad zu bearbeiten, anstatt über den Link4536* Wenn die Blockierung bei derselben Datei wiederholt wird, läuft der Pfad wahrscheinlich durch einen committeten Symlink, dessen Ziel `..` enthält, wie `docs/current -> ../README.md`; bitten Sie Claude, die Zieldatei stattdessen über ihren echten Pfad zu bearbeiten, anstatt über den Link

4518 4537

4519<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">4538<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">

4549 4568

4550**Was zu tun ist:**4569**Was zu tun ist:**

4551 4570

4552* Normalerweise nichts: Claude liest die Meldung und schreibt den Befehl so um, wie sein letzter Satz verlangt4571* Normalerweise nichts: Claude liest die Meldung und schreibt den Befehl so um, wie ihr letzter Satz verlangt

4553* Wenn ein Befehl, den Sie angefordert haben, weiterhin abgelehnt wird, schreiben Sie den gekennzeichneten Wert wörtlich: ersetzen Sie die Umleitung oder Substitution durch ihren Wert, und führen Sie git als seinen eigenen einfachen Befehl von innerhalb des Worktree aus4572* Wenn ein Befehl, den Sie angefordert haben, weiterhin abgelehnt wird, schreiben Sie den gekennzeichneten Wert wörtlich: Ersetzen Sie die Umleitung oder Substitution durch ihren Wert, und führen Sie git als eigenen einfachen Befehl von innerhalb des Worktree aus

4554* Um auf den Haupt-Checkout absichtlich zu handeln, führen Sie den Befehl selbst in einem Terminal außerhalb der Sitzung aus4573* Um absichtlich auf den Haupt-Checkout einzuwirken, führen Sie den Befehl selbst in einem Terminal außerhalb der Sitzung aus

4555 4574

4556<h3 id="this-session-has-no-saved-transcript">4575<h3 id="this-session-has-no-saved-transcript">

4557 Diese Sitzung hat kein gespeichertes Transkript4576 Diese Sitzung hat kein gespeichertes Transkript

4558</h3>4577</h3>

4559 4578

4560Sie haben sich an eine gestoppte [Hintergrund-Sitzung](/docs/de/agent-view) angehängt, die mit `←` oder `/background` von einem anderen Gespräch in den Hintergrund verschoben wurde und gestoppt wurde, bevor ihre erste Antwort fertig war. Bis diese erste Antwort fertig ist, lebt das Gespräch noch nur in der Sitzung, von der es in den Hintergrund verschoben wurde, daher lehnt `claude attach` ab, die gestoppte Sitzung zu starten, anstatt ein leeres Gespräch unter derselben Sitzungs-ID zu beginnen. Die Meldung endet mit dem `claude respawn`-Befehl für diese Sitzung:4579Sie haben sich an eine gestoppte [Hintergrund-Sitzung](/docs/de/agent-view) angehängt, die mit `←` oder `/background` aus einer anderen Konversation in den Hintergrund verschoben wurde und gestoppt wurde, bevor ihre erste Antwort fertig war. Bis diese erste Antwort fertig ist, existiert die Konversation noch nur in der Sitzung, aus der sie in den Hintergrund verschoben wurde, daher lehnt `claude attach` ab, die gestoppte Sitzung zu starten, anstatt eine leere Konversation unter derselben Sitzungs-ID zu beginnen. Die Meldung endet mit dem `claude respawn`-Befehl für diese Sitzung:

4561 4580

4562```text theme={null}4581```text theme={null}

4563This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.4582This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.

4564```4583```

4565 4584

4566Das Öffnen der gleichen Sitzungszeile in der [Agent-Ansicht](/docs/de/agent-view) zeigt `Press enter again to restart this session fresh` unter der Liste an, und ein zweites `Enter` auf der Zeile startet die Sitzung mit einem leeren Gespräch neu. Vor v2.1.212 zeigte das Öffnen der gestoppten Sitzung die Ablehnungsmeldung ohne Möglichkeit, sie von der Agent-Ansicht aus neu zu starten. Vor v2.1.211 startete das Öffnen der gestoppten Sitzung stillschweigend dieses leere Gespräch und konnte die ursprüngliche Eingabeaufforderung der Sitzung erneut ausführen.4585Das Öffnen der Zeile derselben Sitzung in der [Agent-Ansicht](/docs/de/agent-view) zeigt stattdessen `Press enter again to restart this session fresh` unter der Liste an, und ein zweites `Enter` auf der Zeile startet die Sitzung mit einer leeren Konversation neu. Vor v2.1.212 zeigte das Öffnen der Zeile die Ablehnungsmeldung ohne Möglichkeit, die Sitzung von der Agent-Ansicht aus neu zu starten. Vor v2.1.211 startete das Öffnen der gestoppten Sitzung stillschweigend diese leere Konversation und konnte den ursprünglichen Prompt der Sitzung erneut ausführen.

4567 4586

4568**Was zu tun ist:**4587**Was zu tun ist:**

4569 4588

4570* Das Gespräch, das Sie in den Hintergrund verschoben haben, ist intakt: setzen Sie es mit [`claude --resume`](/docs/de/sessions) fort oder arbeiten Sie weiterhin darin4589* Die Konversation, aus der Sie in den Hintergrund verschoben haben, ist intakt: Setzen Sie sie mit [`claude --resume`](/docs/de/sessions) fort oder arbeiten Sie weiterhin darin

4571* Um die gestoppte Sitzung trotzdem neu zu starten, führen Sie `claude respawn <id>` mit der ID aus der Meldung aus, oder drücken Sie `Enter` zweimal auf ihrer Zeile in der Agent-Ansicht4590* Um die gestoppte Sitzung trotzdem neu zu starten, führen Sie `claude respawn <id>` mit der ID aus der Meldung aus, oder drücken Sie `Enter` zweimal auf ihrer Zeile in der Agent-Ansicht

4572* Wenn die Sitzung eine Antwort fertig gestellt hat und Sie diese Ablehnung immer noch auf einer Version vor v2.1.214 sehen, könnte ein unlesbarer Ordner in `~/.claude/projects` dazu führen, dass der Transkript-Scan die gespeicherte Konversation verpasst; aktualisieren Sie auf v2.1.214 oder später, das unlesbare Ordner während des Scans toleriert4591* Wenn die Sitzung eine Antwort fertiggestellt hat und Sie diese Ablehnung immer noch auf einer Version vor v2.1.214 sehen, könnte ein unlesbarer Ordner in `~/.claude/projects` dazu führen, dass der Transkript-Scan die gespeicherte Konversation verpasst; aktualisieren Sie auf v2.1.214 oder später, das unlesbare Ordner während des Scans toleriert

4573 4592

4574<h3 id="this-session-is-running-in-another-terminal">4593<h3 id="this-session-is-running-in-another-terminal">

4575 Diese Sitzung läuft in einem anderen Terminal4594 Diese Sitzung läuft in einem anderen Terminal

4576</h3>4595</h3>

4577 4596

4578Sie haben die Zeile einer gestoppten Sitzung in der [Agent-Ansicht](/docs/de/agent-view) geöffnet, und ihr gespeichertes Gespräch ist bereits in einem anderen aktiven Claude Code-Prozess auf diesem Computer offen, daher lehnt Claude Code ab, einen zweiten Prozess zu starten, der in das gleiche Transkript schreiben würde. Welche Meldung Sie sehen, hängt davon ab, [was das Gespräch hält](/docs/de/agent-view#opening-a-session-says-the-conversation-is-already-open):4597Sie haben die Zeile einer gestoppten Sitzung in der [Agent-Ansicht](/docs/de/agent-view) geöffnet, und ihre gespeicherte Konversation ist bereits in einem anderen aktiven Claude Code-Prozess auf diesem Computer offen, daher lehnt Claude Code ab, einen zweiten Prozess zu starten, der in das gleiche Transkript schreiben würde. Welche Meldung Sie sehen, hängt davon ab, [was die Konversation hält](/docs/de/agent-view#opening-a-session-says-the-conversation-is-already-open):

4579 4598

4580```text theme={null}4599```text theme={null}

4581Can't open — this session is running in another terminal4600Can't open — this session is running in another terminal

4582This conversation is already open in another running Claude session — use that one, or close it and try again4601This conversation is already open in another running Claude session — use that one, or close it and try again

4583```4602```

4584 4603

4585* **`running in another terminal`**: Ein Terminal hält das Gespräch, zum Beispiel eines, in dem Sie es mit `claude --resume` oder `/resume` fortgesetzt haben. Die Zeile zeigt auch `Open in a terminal`.4604* **`running in another terminal`**: Ein Terminal hält die Konversation, zum Beispiel eines, in dem Sie sie mit `claude --resume` oder `/resume` fortgesetzt haben. Die Zeile zeigt auch `Open in a terminal`.

4586* **`already open in another running Claude session`**: Ein anderer nicht-interaktiver Claude Code-Prozess hält es, zum Beispiel ein [Hintergrund-Sitzungs](/docs/de/agent-view#the-supervisor-process)-Prozess für das gleiche Gespräch, das noch nicht beendet ist.4605* **`already open in another running Claude session`**: Ein anderer nicht interaktiver Claude Code-Prozess hält sie, zum Beispiel ein [Hintergrund-Sitzungs](/docs/de/agent-view#the-supervisor-process)-Prozess für dieselbe Konversation, der noch nicht beendet ist.

4587 4606

4588Claude Code speichert eine Antwort, die Sie beim Öffnen der Zeile eingegeben haben, und sendet sie als nächste Eingabeaufforderung der Sitzung, wenn die Sitzung das nächste Mal startet.4607Claude Code speichert eine Antwort, die Sie beim Öffnen der Zeile eingegeben haben, und sendet sie als nächsten Prompt der Sitzung, wenn die Sitzung das nächste Mal startet.

4589 4608

4590**Was zu tun ist:**4609**Was zu tun ist:**

4591 4610

4592* Setzen Sie das Gespräch in dem Prozess fort, der es offen hat, oder beenden Sie diesen Prozess und öffnen Sie die Zeile erneut4611* Setzen Sie die Konversation in dem Prozess fort, der sie offen hat, oder beenden Sie diesen Prozess und öffnen Sie die Zeile erneut

4593 4612

4594Vor v2.1.248 existierte nur die `already open in another running Claude session`-Ablehnung: Ein Gespräch, das in einem Terminal fortgesetzt wurde, zählte nicht als offen, und das Öffnen der Zeile startete einen zweiten Claude Code-Prozess, der in das gleiche Gespräch schrieb.4613Vor v2.1.248 existierte nur die `already open in another running Claude session`-Ablehnung: Eine Konversation, die in einem Terminal fortgesetzt wurde, zählte nicht als offen, und das Öffnen der Zeile startete einen zweiten Claude Code-Prozess, der in dieselbe Konversation schrieb.

4595 4614

4596<h3 id="this-sessions-saved-conversation-is-no-longer-on-disk">4615<h3 id="this-sessions-saved-conversation-is-no-longer-on-disk">

4597 Das gespeicherte Gespräch dieser Sitzung ist nicht mehr auf der Festplatte4616 Die gespeicherte Konversation dieser Sitzung ist nicht mehr auf der Festplatte

4598</h3>4617</h3>

4599 4618

4600Sie haben eine [Hintergrund-Sitzung](/docs/de/agent-view) geöffnet, die endete, während der Hintergrund-Service aus war, und die [Transkript-Bereinigung](/docs/de/settings-reference#cleanupperioddays) hat seitdem sein gespeichertes Gespräch entfernt, zum Beispiel nachdem der Computer für Wochen aus war. Das Öffnen einer solchen Zeile [setzt normalerweise sein gespeichertes Gespräch fort](/docs/de/agent-view#sessions-show-as-failed-after-shutdown). Mit nichts zum Fortsetzen lehnt Claude Code ab, anstatt die ursprüngliche Eingabeaufforderung der Sitzung ohne Nachfrage erneut auszuführen:4619Sie haben eine [Hintergrund-Sitzung](/docs/de/agent-view) geöffnet, die endete, während der Hintergrund-Service aus war, und die [Transkript-Bereinigung](/docs/de/settings-reference#cleanupperioddays) hat seitdem ihre gespeicherte Konversation entfernt, zum Beispiel nachdem der Computer für Wochen aus war. Das Öffnen einer solchen Zeile [setzt normalerweise ihre gespeicherte Konversation fort](/docs/de/agent-view#sessions-show-as-failed-after-shutdown). Da nichts zum Fortsetzen übrig ist, lehnt Claude Code ab, anstatt den ursprünglichen Prompt der Sitzung ohne Nachfrage erneut auszuführen:

4601 4620

4602```text theme={null}4621```text theme={null}

4603This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` deletes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.4622This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` deletes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.

4604```4623```

4605 4624

4606`claude attach <id>` druckt diesen Text. In der Agent-Ansicht ist die Fußzeile kürzer und endet mit `ctrl+x deletes the row`.4625`claude attach <id>` gibt diesen Text aus. In der Agent-Ansicht ist die Fußzeile kürzer und endet mit `ctrl+x deletes the row`.

4607 4626

4608**Was zu tun ist:**4627**Was zu tun ist:**

4609 4628

4610* Führen Sie `claude rm <id>` aus, um die Zeile zu löschen. Wenn einer der [beibehaltenen Fälle](/docs/de/agent-view#what-deleting-a-session-removes) zutrifft, behält `claude rm` die Zeile und den Worktree stattdessen bei und nennt den Grund4629* Führen Sie `claude rm <id>` aus, um die Zeile zu löschen. Wenn einer der [beibehaltenen Fälle](/docs/de/agent-view#what-deleting-a-session-removes) zutrifft, behält `claude rm` die Zeile und den Worktree stattdessen bei und nennt den Grund

4611* Um die ursprüngliche Eingabeaufforderung der Sitzung erneut als frisches Gespräch auszuführen, führen Sie `claude respawn <id>` aus4630* Um den ursprünglichen Prompt der Sitzung erneut als frische Konversation auszuführen, führen Sie `claude respawn <id>` aus

4612 4631

4613Vor v2.1.248 führte das Öffnen einer solchen Zeile die ursprüngliche Eingabeaufforderung der Sitzung erneut aus, anstatt abzulehnen, und zog eine Wochen alte Aufgabe in den Vordergrund.4632Vor v2.1.248 führte das Öffnen einer solchen Zeile den ursprünglichen Prompt der Sitzung erneut aus, anstatt abzulehnen, und zog eine Wochen alte Aufgabe zurück in den Vordergrund.

4614 4633

4615<h3 id="worktree-has-commits-that-are-not-pushed-anywhere">4634<h3 id="worktree-has-commits-that-are-not-pushed-anywhere">

4616 Worktree hat Commits, die nirgendwo gepusht werden4635 Worktree hat Commits, die nirgendwo gepusht werden

4617</h3>4636</h3>

4618 4637

4619Sie haben versucht, eine [Hintergrund-Sitzung](/docs/de/agent-view#what-deleting-a-session-removes) zu löschen, deren Worktree Commits enthält, die Claude Code nicht bestätigen kann, dass sie anderswo gespeichert sind. Claude Code behält den Worktree und die Sitzungszeile bei, anstatt die Commits zu zerstören. `claude rm` nennt den Branch und die nicht gepushten Commits und sagt, wie Sie vorgehen:4638Sie haben versucht, eine [Hintergrund-Sitzung](/docs/de/agent-view#what-deleting-a-session-removes) zu löschen, deren Worktree Commits enthält, bei denen Claude Code nicht bestätigen kann, dass sie anderswo gespeichert sind. Claude Code behält den Worktree und die Sitzungszeile bei, anstatt die Commits ungesehen zu zerstören. `claude rm` nennt den Branch und die nicht gepushten Commits und sagt, wie Sie vorgehen:

4620 4639

4621```text theme={null}4640```text theme={null}

4622kept 7c5dcf5d — its worktree is still at "/home/you/project/.claude/worktrees/fix-login"4641kept 7c5dcf5d — its worktree is still at “/home/you/project/.claude/worktrees/fix-login”

4623 2 unpushed commits on "claude/fix-login": a1b2c3d "Fix login flow" and 1 more. They exist on no remote, so deleting the worktree would lose them.4642 2 unpushed commits on “claude/fix-login”: a1b2c3d “Fix login flow” and 1 more. They exist on no remote, so deleting the worktree would lose them.

4624 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef4643 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef

4625```4644```

4626 4645

4627Wenn Claude Code die Commits nicht zusammenfassen kann, liest sich die Detailzeile `The worktree has unpushed commits` stattdessen. In der [Agent-Ansicht](/docs/de/agent-view) zeigt die Sitzungszeile `not deleted` mit dem gleichen Grund.4646Wenn Claude Code die Commits nicht zusammenfassen kann, lautet die Detailzeile stattdessen `The worktree has unpushed commits`. In der [Agent-Ansicht](/docs/de/agent-view) zeigt die Sitzungszeile `not deleted` mit dem gleichen Grund.

4628 4647

4629Commits auf einem Remote blockieren die Löschung nicht. Auch nicht Commits auf der lokalen Kopie des Standard-Branches Ihres `origin`-Remote, solange dieser Branch in Ihrem Haupt-Checkout ausgecheckt ist, dem Repository-Verzeichnis selbst, nicht einem Worktree.4648Commits auf einem Remote blockieren die Löschung nicht. Auch nicht Commits auf der lokalen Kopie des Standard-Branches Ihres `origin`-Remote, solange dieser Branch in Ihrem Haupt-Checkout ausgecheckt ist, dem Repository-Verzeichnis selbst, nicht einem Worktree.

4630 4649

4631**Was zu tun ist:**4650**Was zu tun ist:**

4632 4651

4633* Um die Commits zu behalten, pushen Sie den Branch des Worktree, oder mergen Sie ihn in den Standard-Branch, der in Ihrem Haupt-Checkout ausgecheckt ist, dann löschen Sie die Sitzung erneut4652* Um die Commits zu behalten, pushen Sie den Branch des Worktree, oder mergen Sie ihn in den Standard-Branch, der in Ihrem Haupt-Checkout ausgecheckt ist, dann löschen Sie die Sitzung erneut

4634* Um die Commits zu verwerfen, führen Sie den `claude rm <id> --discard-unpushed`-Befehl aus, den die Meldung druckte, oder drücken Sie `Ctrl+X` zweimal auf der Sitzungszeile in der Agent-Ansicht erneut. Dies entfernt die Sitzung und den Worktree zusammen mit seinem Branch, den nicht gepushten Commits und allen nicht committeten Änderungen. Wenn der Worktree seit der Ablehnung einen Commit gewonnen hat, behält Claude Code ihn erneut und zeigt den aktualisierten Status4653* Um die Commits zu verwerfen, führen Sie den `claude rm <id> --discard-unpushed`-Befehl aus, den die Meldung ausgegeben hat, oder drücken Sie `Ctrl+X` zweimal auf der Sitzungszeile in der Agent-Ansicht erneut. Dies entfernt die Sitzung und den Worktree zusammen mit seinem Branch, den nicht gepushten Commits und allen nicht committeten Änderungen. Wenn der Worktree seit der Ablehnung einen Commit hinzubekommen hat, behält Claude Code ihn erneut und zeigt den aktualisierten Status

4635* Wenn die Meldung sagt, dass der Worktree auch von einer anderen beendeten Sitzung aufgezeichnet wird, blockiert das Löschen erneut nicht, ihn zu verwerfen: pushen Sie die Commits, dann löschen Sie die Sitzung erneut4654* Wenn die Meldung sagt, dass der Worktree auch von einer anderen beendeten Sitzung aufgezeichnet wird, verwirft erneutes Löschen ihn nicht: Pushen Sie die Commits, dann löschen Sie die Sitzung erneut

4636 4655

4637Vor v2.1.268 setzte `claude rm` die Commit-Zusammenfassung auf die `kept`-Zeile selbst. Wenn `claude rm` die Commits nicht zusammenfassen konnte, las sich die `kept`-Zeile `worktree has commits that are not pushed anywhere` anstelle der Zusammenfassung.4656Vor v2.1.268 setzte `claude rm` die Commit-Zusammenfassung auf die `kept`-Zeile selbst. Wenn `claude rm` die Commits nicht zusammenfassen konnte, lautete die `kept`-Zeile `worktree has commits that are not pushed anywhere` anstelle der Zusammenfassung.

4638 4657

4639Vor v2.1.260 nannte die Meldung nicht den Branch oder die Commits, und das Löschen erneut wurde auf die gleiche Weise abgelehnt: das Löschen der Sitzung ohne Pushen bedeutete das Entfernen des Worktree selbst mit `git worktree remove --force <path>`, dann das erneute Ausführen von `claude rm <id>`.4658Vor v2.1.260 nannte die Meldung nicht den Branch oder die Commits, und erneutes Löschen wurde auf die gleiche Weise abgelehnt: Das Löschen der Sitzung ohne Pushen bedeutete, den Worktree selbst mit `git worktree remove --force <path>` zu entfernen und dann `claude rm <id>` erneut auszuführen.

4640 4659

4641Vor v2.1.248 zählte der Standard-Branch, der in Ihrem Haupt-Checkout ausgecheckt ist, nicht: Ein Branch, den Sie bereits dort gemergt haben, löste diese Ablehnung immer noch aus, bis seine Commits einen Remote erreichten.4660Vor v2.1.248 zählte der Standard-Branch, der in Ihrem Haupt-Checkout ausgecheckt ist, nicht: Ein Branch, den Sie bereits dort gemergt hatten, löste diese Ablehnung immer noch aus, bis seine Commits einen Remote erreichten.

4642 4661

4643<h3 id="terminal-host-process-died">4662<h3 id="terminal-host-process-died">

4644 Terminal-Host-Prozess ist gestorben4663 Terminal-Host-Prozess ist gestorben

4645</h3>4664</h3>

4646 4665

4647Jedes [Hintergrund-Sitzungs](/docs/de/agent-view)-Terminal läuft in einem Host-Prozess unter dem Hintergrund-Service, und dieser Prozess ist gestorben, während der Service seine Verbindung noch hielt, daher konnte die Sitzung nicht erreicht werden.4666Das Terminal jeder [Hintergrund-Sitzung](/docs/de/agent-view) läuft in einem Host-Prozess unter dem Hintergrund-Service, und dieser Prozess ist gestorben, während der Service seine Verbindung noch hielt, daher konnte die Sitzung nicht erreicht werden.

4648 4667

4649Unter Linux und WSL überprüft der Hintergrund-Service jeden Host-Prozess alle paar Sekunden, markiert die Sitzung als fehlgeschlagen, wenn der Prozess beendet wurde, aber seine Verbindung zum Service nie geschlossen wurde, und zeigt den Grund auf ihrer Zeile in der [Agent-Ansicht](/docs/de/agent-view#read-session-state):4668Unter Linux und WSL überprüft der Hintergrund-Service jeden Host-Prozess alle paar Sekunden, markiert die Sitzung als fehlgeschlagen, wenn der Prozess beendet wurde, aber seine Verbindung zum Service nie geschlossen wurde, und zeigt den Grund auf ihrer Zeile in der [Agent-Ansicht](/docs/de/agent-view#read-session-state):

4650 4669

4652terminal host process died — press Enter to restart4671terminal host process died — press Enter to restart

4653```4672```

4654 4673

4655Aus der Shell startet `claude attach <id>` eine Sitzung, die bereits als fehlgeschlagen für einen toten Host markiert ist, neu, und druckt ansonsten den Grund und beendet sich:4674Aus der Shell startet `claude attach <id>` eine Sitzung, die bereits wegen eines toten Hosts als fehlgeschlagen markiert ist, neu, und gibt ansonsten die Ursache aus und beendet sich:

4656 4675

4657```text theme={null}4676```text theme={null}

4658Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.4677Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.

4659```4678```

4660 4679

4661Das Gespräch ist in jedem Fall gespeichert.4680Die Konversation ist in jedem Fall gespeichert.

4662 4681

4663Eine Zeile, die einen [Shell-Befehl](/docs/de/agent-view#run-a-shell-command) ausführt, zeigt stattdessen `terminal host process died — its output is gone; the command was not run again`, und `claude attach` druckt `This command's terminal host process died — its output is gone and the command was not run again`. Claude Code führt den Befehl niemals für Sie erneut aus.4682Eine Zeile, die einen [Shell-Befehl](/docs/de/agent-view#run-a-shell-command) ausführt, zeigt stattdessen `terminal host process died — its output is gone; the command was not run again`, und `claude attach` gibt `This command's terminal host process died — its output is gone and the command was not run again` aus. Claude Code führt den Befehl niemals für Sie erneut aus.

4664 4683

4665**Was zu tun ist:**4684**Was zu tun ist:**

4666 4685

4667* Drücken Sie in der Agent-Ansicht `Enter` auf der fehlgeschlagenen Zeile; die Sitzung startet auf einem frischen Host-Prozess neu und das Gespräch wird fortgesetzt4686* Drücken Sie in der Agent-Ansicht `Enter` auf der fehlgeschlagenen Zeile; die Sitzung startet auf einem frischen Host-Prozess neu und die Konversation wird fortgesetzt

4668* Führen Sie aus der Shell `claude attach <id>` erneut aus. Claude Code druckt `Session <id>'s terminal host died — restarting it on a fresh one…` und öffnet die Sitzung erneut4687* Führen Sie aus der Shell `claude attach <id>` erneut aus. Claude Code gibt `Session <id>'s terminal host died — restarting it on a fresh one…` aus und öffnet die Sitzung erneut

4669* Sie können eine Shell-Befehl-Zeile auf diese Weise nicht neu starten; entsenden Sie den Befehl erneut, um ihn erneut auszuführen4688* Sie können eine Shell-Befehl-Zeile auf diese Weise nicht neu starten; entsenden Sie den Befehl erneut, um ihn erneut auszuführen

4670 4689

4671Vor v2.1.247 konnte ein toter Host-Prozess jede Liveness-Überprüfung bestehen, die der Hintergrund-Service ausführte, daher zeigte das Öffnen der Sitzung `opening… · esc to cancel` unbegrenzt und `claude attach <id>` wartete ohne Fehlermeldung.4690Vor v2.1.247 konnte ein toter Host-Prozess jede Liveness-Überprüfung bestehen, die der Hintergrund-Service ausführte, daher zeigte das Öffnen der Sitzung `opening… · esc to cancel` unbegrenzt und `claude attach <id>` wartete ohne Fehlermeldung.

4674 Sitzung antwortet nicht4693 Sitzung antwortet nicht

4675</h3>4694</h3>

4676 4695

4677Sie haben eine [Hintergrund-Sitzung](/docs/de/agent-view) geöffnet und der Hintergrund-Service hat das Öffnen akzeptiert, aber keine Ausgabe kam für etwa zehn Sekunden an, daher schließt Claude Code, dass der Prozess, der das Terminal der Sitzung weiterleitet, keine Ausgabe liefern kann, und beendet den Versuch, anstatt zu warten.4696Sie haben eine [Hintergrund-Sitzung](/docs/de/agent-view) geöffnet und der Hintergrund-Service hat das Öffnen akzeptiert, aber etwa zehn Sekunden lang kam keine Ausgabe an, daher schließt Claude Code, dass der Prozess, der das Terminal der Sitzung weiterleitet, keine Ausgabe liefern kann, und beendet den Versuch, anstatt zu warten.

4678 4697

4679In der Agent-Ansicht bietet Claude Code einen Neustart in der Fußzeile an:4698In der Agent-Ansicht bietet Claude Code einen Neustart in der Fußzeile an:

4680 4699

4682Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).4701Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).

4683```4702```

4684 4703

4685Aus der Shell druckt `claude attach <id>` den Grund und beendet sich:4704Aus der Shell gibt `claude attach <id>` die Ursache aus und beendet sich:

4686 4705

4687```text theme={null}4706```text theme={null}

4688Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).4707Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).

4692 4711

4693**Was zu tun ist:**4712**Was zu tun ist:**

4694 4713

4695* Drücken Sie in der Agent-Ansicht `Enter` auf der gleichen Zeile erneut. Claude Code stoppt den nicht reagierenden Prozess und startet die Sitzung neu, und das Gespräch wird fortgesetzt. Nichts wird ohne diesen zweiten Druck gestoppt4714* Drücken Sie in der Agent-Ansicht `Enter` auf derselben Zeile erneut. Claude Code stoppt den nicht reagierenden Prozess und startet die Sitzung neu, und die Konversation wird fortgesetzt. Nichts wird ohne diesen zweiten Tastendruck gestoppt

4696* Führen Sie aus der Shell `claude stop <id>` aus, dann `claude attach <id>`4715* Führen Sie aus der Shell `claude stop <id>` aus, dann `claude attach <id>`

4697* Drücken Sie für eine Shell-Befehl-Zeile `Ctrl+X` in der Agent-Ansicht oder führen Sie `claude stop <id>` aus, um sie zu stoppen; entsenden Sie den Befehl erneut, um ihn erneut auszuführen4716* Drücken Sie für eine Shell-Befehl-Zeile `Ctrl+X` in der Agent-Ansicht oder führen Sie `claude stop <id>` aus, um sie zu stoppen; entsenden Sie den Befehl erneut, um ihn erneut auszuführen

4698 4717

4699<h3 id="session-was-stopped-while-the-respawn-was-in-flight">4718<h3 id="session-was-stopped-while-the-respawn-was-in-flight">

4700 Sitzung wurde gestoppt, während der Respawn im Flug war4719 Sitzung wurde gestoppt, während der Respawn im Gange war

4701</h3>4720</h3>

4702 4721

4703Sie haben eine [Hintergrund-Sitzung](/docs/de/agent-view) geöffnet, deren Prozess nicht lief, und während Claude Code sie neu startete, stoppte ein anderer Claude Code-Prozess sie, zum Beispiel `claude stop` in einem anderen Terminal. Claude Code hält die Sitzung gestoppt:4722Sie haben eine [Hintergrund-Sitzung](/docs/de/agent-view) geöffnet, deren Prozess nicht lief, und während Claude Code sie neu startete, stoppte ein anderer Claude Code-Prozess sie, zum Beispiel `claude stop` in einem anderen Terminal. Claude Code hält die Sitzung gestoppt:

4706Session <id> was stopped while the respawn was in flight4725Session <id> was stopped while the respawn was in flight

4707```4726```

4708 4727

4709Das Öffnen einer Sitzung, die Sie gerade entsandt haben, während ihr Prozess noch startet, wartet auf den Prozess stattdessen. Vor v2.1.246 konnte das Öffnen zu diesem Zeitpunkt sie stoppen und diese Meldung anzeigen.4728Das Öffnen einer Sitzung, die Sie gerade entsandt haben, während ihr Prozess noch startet, wartet stattdessen auf den Prozess. Vor v2.1.246 konnte das Öffnen zu diesem Zeitpunkt sie stoppen und diese Meldung anzeigen.

4710 4729

4711**Was zu tun ist:**4730**Was zu tun ist:**

4712 4731

4713* Wenn Sie die Sitzung nicht gestoppt haben, öffnen Sie ihre Zeile erneut in der Agent-Ansicht oder führen Sie `claude respawn <id>` aus, um sie neu zu starten4732* Wenn Sie die Sitzung nicht gestoppt haben, öffnen Sie ihre Zeile erneut in der Agent-Ansicht oder führen Sie `claude respawn <id>` aus, um sie neu zu starten

4714* Wenn Sie sie selbst gestoppt haben, bleibt nichts zu tun: die Sitzung bleibt gestoppt4733* Wenn Sie sie selbst gestoppt haben, bleibt nichts zu tun: Die Sitzung bleibt gestoppt

4715 4734

4716<h3 id="session-agent-no-longer-available">4735<h3 id="session-agent-no-longer-available">

4717 Sitzungs-Agent nicht mehr verfügbar4736 Sitzungs-Agent nicht mehr verfügbar

4718</h3>4737</h3>

4719 4738

4720Sie haben eine Sitzung fortgesetzt, die einen [benutzerdefinierten Agent](/docs/de/sub-agents#invoke-subagents-explicitly) ausführte, gestartet mit `--agent` oder der `agent`-Einstellung, und Claude Code hat keinen Agent mit diesem Namen gefunden. Es durchsucht zuerst das ursprüngliche Verzeichnis der Sitzung, wenn Sie [diesen Arbeitsbereich vertraut haben](/docs/de/permissions#project-allow-rules-and-workspace-trust), dann das Verzeichnis, von dem aus Sie fortsetzen. Die Sitzung wird immer noch fortgesetzt, aber mit den Standard-Tools, so dass die Tool-Einschränkungen des Agenten nicht mehr gelten:4739Sie haben eine Sitzung fortgesetzt, die einen [benutzerdefinierten Agenten](/docs/de/sub-agents#invoke-subagents-explicitly) ausführte, gestartet mit `--agent` oder der `agent`-Einstellung, und Claude Code hat keinen Agenten mit diesem Namen gefunden. Es durchsucht zuerst das ursprüngliche Verzeichnis der Sitzung, wenn Sie [diesem Workspace vertraut haben](/docs/de/permissions#project-allow-rules-and-workspace-trust), dann das Verzeichnis, von dem aus Sie fortsetzen. Die Sitzung wird trotzdem fortgesetzt, aber mit den Standard-Tools, sodass die Tool-Einschränkungen des Agenten nicht mehr gelten:

4721 4740

4722```text theme={null}4741```text theme={null}

4723This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.4742This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.

4724```4743```

4725 4744

4726Die Warnung nennt nur die Verzeichnisse, die Claude Code durchsucht hat, und sie erscheint im fortgesetzten Gespräch, ob Sie eine [Hintergrund-Sitzung](/docs/de/agent-view) aufwecken, `/resume` oder `claude --resume` ausführen, oder im [nicht-interaktiven Modus](/docs/de/headless) fortsetzen, wo sie auch zu stderr geht. Sitzungen, die `--input-format stream-json` verwenden, zeigen sie nicht, da das Agent SDK Agenten nach dem Start bereitstellt.4745Die Warnung nennt nur die Verzeichnisse, die Claude Code durchsucht hat, und sie erscheint in der fortgesetzten Konversation, ob Sie eine [Hintergrund-Sitzung](/docs/de/agent-view) aufwecken, `/resume` oder `claude --resume` ausführen oder im [nicht interaktiven Modus](/docs/de/headless) fortsetzen, wo sie auch an stderr geht. Sitzungen, die `--input-format stream-json` verwenden, zeigen sie nicht, da das Agent SDK Agenten nach dem Start bereitstellt.

4727 4746

4728Claude Code speichert den Fallback nicht in der Sitzung, daher wiederholt sich die Warnung bei jedem Fortsetzen, bis Sie handeln. Der eingebaute `claude`-Agent löst die Warnung nicht aus, da das Zurückfallen auf den Standard-Toolset für ihn nichts ändert. Vor v2.1.216 setzte Claude Code stillschweigend als Standard-Agent fort, und die Suche deckte nur das Verzeichnis ab, von dem aus Sie fortgesetzt haben, daher ging ein Projekt-Agent bei jedem Fortsetzen von einem anderen Verzeichnis verloren.4747Claude Code speichert den Fallback nicht in der Sitzung, daher wiederholt sich die Warnung bei jedem Fortsetzen, bis Sie handeln. Der eingebaute `claude`-Agent löst die Warnung nicht aus, da das Zurückfallen auf das Standard-Toolset für ihn nichts ändert. Vor v2.1.216 setzte Claude Code stillschweigend als Standard-Agent fort, und die Suche deckte nur das Verzeichnis ab, von dem aus Sie fortgesetzt haben, daher ging ein projektbezogener Agent bei jedem Fortsetzen aus einem anderen Verzeichnis verloren.

4729 4748

4730**Was zu tun ist:**4749**Was zu tun ist:**

4731 4750

4732* Erstellen Sie die Agent-Datei unter `.claude/agents/<name>.md` im Projekt der Sitzung oder unter `~/.claude/agents/<name>.md` für einen persönlichen Agent neu, dann setzen Sie erneut fort4751* Erstellen Sie die Agent-Datei unter `.claude/agents/<name>.md` im Projekt der Sitzung oder unter `~/.claude/agents/<name>.md` für einen persönlichen Agenten neu, dann setzen Sie erneut fort

4733* Oder setzen Sie mit `--agent <name>` fort, das einen Agent benennt, der existiert, um die Sitzung stattdessen als dieser Agent auszuführen4752* Oder setzen Sie mit `--agent <name>` fort, das einen Agenten benennt, der existiert, um die Sitzung stattdessen als dieser Agent auszuführen

4734* Wenn der Agent Projekt-Agent ist und Sie das ursprüngliche Verzeichnis der Sitzung nicht vertraut haben, führen Sie Claude Code dort einmal aus, akzeptieren Sie den Vertrauensdialog, dann setzen Sie erneut fort4753* Wenn der Agent projektbezogen ist und Sie dem ursprünglichen Verzeichnis der Sitzung nicht vertraut haben, führen Sie Claude Code dort einmal aus, akzeptieren Sie den Vertrauensdialog, dann setzen Sie erneut fort

4735 4754

4736<h3 id="claude_code_process_wrapper-launcher-errors">4755<h3 id="claude_code_process_wrapper-launcher-errors">

4737 CLAUDE\_CODE\_PROCESS\_WRAPPER Launcher-Fehler4756 CLAUDE\_CODE\_PROCESS\_WRAPPER Launcher-Fehler

4743CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file4762CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file

4744```4763```

4745 4764

4746Ein Launcher, der startet, aber beendet wird, ohne sich selbst durch Claude Code zu ersetzen, schlägt die Sitzung fehl, die er startete, und die Sitzungszeile in der Agent-Ansicht meldet, dass der Launcher `must exec, not daemonize`, gefolgt von allem, was der Launcher druckte. Eine Sitzung, die nicht starten oder den Hintergrund-Service nicht erreichen kann, weil des Launchers, meldet das Launcher-Problem als Grund innerhalb von `Couldn't reach the background service (...)`.4765Ein Launcher, der startet, aber beendet wird, ohne sich selbst durch Claude Code zu ersetzen, lässt die Sitzung fehlschlagen, die er startete, und die Sitzungszeile in der Agent-Ansicht meldet, dass der Launcher `must exec, not daemonize`, gefolgt von allem, was der Launcher ausgegeben hat. Eine Sitzung, die wegen des Launchers nicht starten oder den Hintergrund-Service nicht erreichen kann, meldet das Launcher-Problem als Grund innerhalb von `Couldn't reach the background service (...)`.

4747 4766

4748**Was zu tun ist:**4767**Was zu tun ist:**

4749 4768

4750* Setzen Sie die Variable auf den absoluten Pfad einer ausführbaren Datei, die mit `exec "$@"` endet. Siehe [den Launcher-Vertrag](/docs/de/corporate-launcher#the-launcher-contract) für den vollständigen Vertrag4769* Setzen Sie die Variable auf den absoluten Pfad einer ausführbaren Datei, die mit dem Aufruf `exec "$@"` endet. Siehe [den Launcher-Vertrag](/docs/de/corporate-launcher#the-launcher-contract) für den vollständigen Vertrag

4751* Überprüfen Sie `/status`, das den aufgelösten Start-Befehl in seinem Self-exec-Eintrag anzeigt und warnt, wenn der laufende Hintergrund-Service nicht damit übereinstimmt, oder führen Sie `claude daemon status` aus einer Shell aus4770* Überprüfen Sie `/status`, das den aufgelösten Start-Befehl in seinem Self-exec-Eintrag anzeigt und warnt, wenn der laufende Hintergrund-Service nicht damit übereinstimmt, oder führen Sie `claude daemon status` aus einer Shell aus

4752* Nach dem Beheben des Wertes im `env`-Block von [Einstellungen](/docs/de/corporate-launcher#set-up-the-launcher) starten Sie den Hintergrund-Service mit `claude daemon stop --any` neu, damit der nächste Dispatch einen umschlossenen startet4771* Nach dem Beheben des Wertes im `env`-Block der [Einstellungen](/docs/de/corporate-launcher#set-up-the-launcher) starten Sie den Hintergrund-Service mit `claude daemon stop --any` neu, damit der nächste Dispatch einen umschlossenen startet

4753 4772

4754<h3 id="eunknown-when-starting-a-background-session">4773<h3 id="eunknown-when-starting-a-background-session">

4755 EUNKNOWN beim Starten einer Hintergrund-Sitzung4774 EUNKNOWN beim Starten einer Hintergrund-Sitzung

4756</h3>4775</h3>

4757 4776

4758Windows lehnte ab, ein Programm mit einem Fehlercode zu starten, der keinen Standardnamen hat, daher wird der Fehler als `EUNKNOWN` angezeigt. Der übliche Auslöser ist eine Softwarebeschränkungsrichtlinie, wie Gruppenrichtlinie oder AppLocker, die das gestartete Programm blockiert. Der Fehler erscheint, wenn Sie eine [Hintergrund-Sitzung](/docs/de/agent-view) mit `/background` oder `claude --bg` starten:4777Windows lehnte ab, ein Programm zu starten, mit einem Fehlercode, der keinen Standardnamen hat, daher wird der Fehler als `EUNKNOWN` angezeigt. Der übliche Auslöser ist eine Softwarebeschränkungsrichtlinie, wie Gruppenrichtlinie oder AppLocker, die das gestartete Programm blockiert. Der Fehler erscheint, wenn Sie eine [Hintergrund-Sitzung](/docs/de/agent-view) mit `/background` oder `claude --bg` starten:

4759 4778

4760```text theme={null}4779```text theme={null}

4761Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'4780Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'

4763 4782

4764Bei einigen Konten sagt die Meldung `daemon` anstelle von `background service`.4783Bei einigen Konten sagt die Meldung `daemon` anstelle von `background service`.

4765 4784

4766Bei einer npm-Installation hat ein `EUNKNOWN`, das erscheint, während `npm install -g @anthropic-ai/claude-code` die Binärdatei ersetzt, die gleiche Ursache wie [`EACCES` beim Starten einer Hintergrund-Sitzung](#eacces-when-starting-a-background-session) und wird gelöscht, wenn Sie nach Abschluss der Installation erneut versuchen.4785Bei einer npm-Installation hat ein `EUNKNOWN`, das erscheint, während `npm install -g @anthropic-ai/claude-code` die Binärdatei ersetzt, die gleiche Ursache wie [`EACCES` während einer Neuinstallation](#eacces-when-starting-a-background-session) und verschwindet, wenn Sie es nach Abschluss der Installation erneut versuchen.

4767 4786

4768Claude Code startet den Hintergrund-Service über PowerShell, damit der Service das Schließen des Terminals überlebt, wobei PowerShell 7 verwendet wird, wenn es installiert ist, und Windows PowerShell 5.1 ansonsten. Wenn weder PowerShell laufen kann, startet Claude Code den Service stattdessen direkt, daher verursacht eine Richtlinie, die nur PowerShell blockiert, diesen Fehler nicht.4787Claude Code startet den Hintergrund-Service über PowerShell, damit der Service das Schließen des Terminals überlebt, wobei PowerShell 7 verwendet wird, wenn es installiert ist, und ansonsten Windows PowerShell 5.1. Wenn keine der beiden PowerShell-Versionen laufen kann, startet Claude Code den Service stattdessen direkt, daher verursacht eine Richtlinie, die nur PowerShell blockiert, diesen Fehler nicht.

4769 4788

4770Vor v2.1.212 verwendete Claude Code nur Windows PowerShell 5.1, um den Service zu starten, daher schlugen alle Maschinen fehl, auf denen Gruppenrichtlinie PowerShell 5.1 blockierte, mit `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`, sogar mit PowerShell 7 installiert.4789Vor v2.1.212 verwendete Claude Code nur Windows PowerShell 5.1, um den Service zu starten, daher schlug jede Maschine, auf der Gruppenrichtlinie PowerShell 5.1 blockierte, mit `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn` fehl, selbst wenn PowerShell 7 installiert war.

4771 4790

4772**Was zu tun ist:**4791**Was zu tun ist:**

4773 4792

4774* Wenn die Meldung `Couldn't start the session` liest, aktualisieren Sie auf v2.1.212 oder später. Auf früheren Versionen können Sie auch `claude daemon run` in einem separaten Terminal zuerst ausführen, dann die Hintergrund-Sitzung erneut starten. Dieser Befehl führt den Hintergrund-Service im Vordergrund des Terminals aus, daher dauert der Service nur so lange wie dieses Terminal offen bleibt.4793* Wenn die Meldung `Couldn't start the session` lautet, aktualisieren Sie auf v2.1.212 oder später. Auf früheren Versionen können Sie auch zuerst `claude daemon run` in einem separaten Terminal ausführen und dann die Hintergrund-Sitzung erneut starten. Dieser Befehl führt den Hintergrund-Service im Vordergrund des Terminals aus, daher läuft der Service nur so lange, wie dieses Terminal offen bleibt.

4775* Wenn eine npm-Installation die Binärdatei ersetzt, warten Sie, bis sie fertig ist, dann starten Sie die Hintergrund-Sitzung erneut4794* Wenn eine npm-Installation die Binärdatei ersetzt hat, warten Sie, bis sie fertig ist, dann starten Sie die Hintergrund-Sitzung erneut

4776* Wenn der Fehler auf v2.1.212 oder später erscheint, während keine npm-Installation läuft, überprüfen Sie mit Ihrem Windows-Administrator, ob eine Beschränkungsrichtlinie die Claude Code-Ausführungsdatei blockiert4795* Wenn der Fehler auf v2.1.212 oder später erscheint, während keine npm-Installation läuft, klären Sie mit Ihrem Windows-Administrator, ob eine Beschränkungsrichtlinie die Claude Code-Ausführungsdatei blockiert

4777* Wenn der Hintergrund-Service stoppt, wenn Sie das Terminal schließen, startete Claude Code ihn ohne PowerShell. Installieren Sie PowerShell 7, oder bitten Sie Ihren Administrator, PowerShell freizugeben, damit der Service das Terminal überleben kann.4796* Wenn der Hintergrund-Service stoppt, wenn Sie das Terminal schließen, hat Claude Code ihn ohne PowerShell gestartet. Installieren Sie PowerShell 7, oder bitten Sie Ihren Administrator, PowerShell freizugeben, damit der Service das Terminal überleben kann.

4778 4797

4779<h3 id="eacces-when-starting-a-background-session">4798<h3 id="eacces-when-starting-a-background-session">

4780 EACCES beim Starten einer Hintergrund-Sitzung4799 EACCES beim Starten einer Hintergrund-Sitzung

4781</h3>4800</h3>

4782 4801

4783Claude Code konnte seine eigene Binärdatei nicht ausführen, um den [Hintergrund-Service](/docs/de/agent-view#the-supervisor-process) zu starten, der Hintergrund-Sitzungen hostet. Bei einer npm-Installation bedeutet dies normalerweise, dass `npm install -g @anthropic-ai/claude-code` die Binärdatei zu diesem Zeitpunkt ersetzt, ob Sie es ausführten oder der [Auto-Updater](/docs/de/setup#auto-updates) es tat. Der Fehler erscheint, wenn Sie eine Sitzung aus der [Agent-Ansicht](/docs/de/agent-view) öffnen:4802Claude Code konnte seine eigene Binärdatei nicht ausführen, um den [Hintergrund-Service](/docs/de/agent-view#the-supervisor-process) zu starten, der Hintergrund-Sitzungen hostet. Bei einer npm-Installation bedeutet dies normalerweise, dass `npm install -g @anthropic-ai/claude-code` die Binärdatei zu diesem Zeitpunkt ersetzte, ob Sie es ausgeführt haben oder der [Auto-Updater](/docs/de/setup#auto-updates). Der Fehler erscheint, wenn Sie eine Sitzung aus der [Agent-Ansicht](/docs/de/agent-view) öffnen:

4784 4803

4785```text theme={null}4804```text theme={null}

4786Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'4805Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'

4787```4806```

4788 4807

4789Wenn Sie eine Sitzung mit `/background` oder `claude --bg` starten, erscheint der gleiche Grund innerhalb von `Couldn't reach the background service (...)`. Während des gleichen Neuinstallationsfensters kann der Fehler einen anderen Code benennen, wie `ENOENT` oder `ENOEXEC`, oder `EUNKNOWN` oder `EPERM` auf Windows; ein `EUNKNOWN`, das über Wiederholungen hinweg anhält, hat eine [andere Ursache](#eunknown-when-starting-a-background-session).4808Wenn Sie eine Sitzung mit `/background` oder `claude --bg` starten, erscheint der gleiche Grund innerhalb von `Couldn't reach the background service (...)`. Während desselben Neuinstallationsfensters kann der Fehler stattdessen einen anderen Code benennen, wie `ENOENT` oder `ENOEXEC`, oder `EUNKNOWN` oder `EPERM` unter Windows; ein `EUNKNOWN`, das über Wiederholungsversuche hinweg anhält, hat eine [andere Ursache](#eunknown-when-starting-a-background-session).

4790 4809

4791Bei einer npm-Installation wartet Claude Code auf die Neuinstallation und versucht es automatisch erneut: bis zu zehn Sekunden, und bis zu zwei Minuten, während eine npm-Installation von Claude Code auf der Maschine sichtbar noch läuft, was einen anderen Claude Code-Prozess abdeckt, der ein Update herunterlädt. Wenn die Installation länger als diese Wartezeit dauert, benennt der Fehler das Update stattdessen des bloßen Fehlercodes:4810Bei einer npm-Installation wartet Claude Code, bis die Neuinstallation abgeschlossen ist, und versucht es automatisch erneut: bis zu zehn Sekunden, und bis zu zwei Minuten, während eine npm-Installation von Claude Code auf der Maschine sichtbar noch läuft, was einen anderen Claude Code-Prozess abdeckt, der ein Update herunterlädt. Wenn die Installation länger als diese Wartezeit dauert, benennt der Fehler das Update anstelle des bloßen Fehlercodes:

4792 4811

4793```text theme={null}4812```text theme={null}

4794Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes4813Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes

4795```4814```

4796 4815

4797Vor v2.1.257 stoppte die Wartezeit bei zehn Sekunden in jedem Fall, daher erschien dieser Fehler, während ein anderer Claude Code-Prozess noch ein Update herunterlädt. Vor v2.1.246 schlug Claude Code sofort fehl, ohne zu warten.4816Vor v2.1.257 endete die Wartezeit in jedem Fall nach zehn Sekunden, daher erschien dieser Fehler, während ein anderer Claude Code-Prozess noch ein Update herunterlud. Vor v2.1.246 schlug Claude Code sofort fehl, ohne zu warten.

4798 4817

4799**Was zu tun ist:**4818**Was zu tun ist:**

4800 4819

4801* Warten Sie ein paar Sekunden, dann öffnen Sie die Sitzung oder entsenden Sie erneut. Wenn die Meldung sagt, Claude Code wird aktualisiert, versuchen Sie es erneut, nachdem das Update fertig ist.4820* Warten Sie ein paar Sekunden, dann öffnen Sie die Sitzung oder entsenden Sie erneut. Wenn die Meldung sagt, dass Claude Code aktualisiert wird, versuchen Sie es erneut, nachdem das Update fertig ist.

4802* Wenn der Fehler anhält, während keine npm-Installation läuft, kann Ihr Benutzer die installierte Binärdatei nicht ausführen. Überprüfen Sie ihre Berechtigungen und die ihres Verzeichnisses, oder installieren Sie Claude Code neu.4821* Wenn der Fehler anhält, während keine npm-Installation läuft, kann Ihr Benutzer die installierte Binärdatei nicht ausführen. Überprüfen Sie ihre Berechtigungen und die ihres Verzeichnisses, oder installieren Sie Claude Code neu.

4803 4822

4804<h3 id="background-service-exited-before-it-became-reachable">4823<h3 id="background-service-exited-before-it-became-reachable">

4805 Hintergrund-Service beendet, bevor er erreichbar wurde4824 Hintergrund-Service beendet, bevor er erreichbar wurde

4806</h3>4825</h3>

4807 4826

4808Der Prozess, den Claude Code als [Hintergrund-Service](/docs/de/agent-view#the-supervisor-process) startete, beendet sich, bevor er Verbindungen akzeptierte, daher konnte Claude Code Ihre Sitzung nicht öffnen. Wenn der Service einen Fehler druckte, bevor er beendet wurde, gibt der Grund in Klammern den Exit-Code oder das Signal und die erste Zeile an, die der Service druckte, die benennt, was ihn stoppte:4827Der Prozess, den Claude Code als [Hintergrund-Service](/docs/de/agent-view#the-supervisor-process) startete, hat sich beendet, bevor er Verbindungen akzeptierte, daher konnte Claude Code Ihre Sitzung nicht öffnen. Wenn der Service vor dem Beenden einen Fehler ausgegeben hat, gibt der Grund in Klammern den Exit-Code oder das Signal und die erste Zeile an, die der Service ausgegeben hat, die benennt, was ihn gestoppt hat:

4809 4828

4810```text theme={null}4829```text theme={null}

4811Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'4830Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'

4812```4831```

4813 4832

4814Wenn Sie eine Sitzung aus der [Agent-Ansicht](/docs/de/agent-view) öffnen, folgt der gleiche Grund `Couldn't start the background service —`. Wenn der Service nichts druckte, bevor er beendet wurde, sagt die Meldung `nothing on stderr` stattdessen.4833Wenn Sie eine Sitzung aus der [Agent-Ansicht](/docs/de/agent-view) öffnen, folgt der gleiche Grund auf `Couldn't start the background service —`. Wenn der Service vor dem Beenden nichts ausgegeben hat, sagt die Meldung stattdessen `nothing on stderr`.

4815 4834

4816Claude Code meldet den Fehler mit der Fehlerzeile des Service. Vor v2.1.246 wurde der Fehler nur nach einer 45-Sekunden-Wartezeit angezeigt, als `background service did not become reachable within 45s`, ohne die Fehlerzeile des Service.4835Claude Code meldet den Fehler mit der Fehlerzeile des Service. Vor v2.1.246 wurde der Fehler erst nach einer Wartezeit von 45 Sekunden angezeigt, als `background service did not become reachable within 45s`, ohne die Fehlerzeile des Service.

4817 4836

4818Zwei zitierte Gründe haben bekannte Ursachen:4837Zwei zitierte Gründe haben bekannte Ursachen:

4819 4838

4820* `Error: claude native binary not installed.`: eine npm-Installation ersetzt die Claude Code-Binärdatei zu diesem Zeitpunkt, daher führte der Service stattdessen npm-Platzhalter aus. Versuchen Sie es erneut, nachdem die Installation fertig ist; wenn die Zeile mit keiner Installation läuft anhält, [schließen Sie die npm-Installation ab](/docs/de/troubleshoot-install#native-binary-not-found-after-npm-install). Vor v2.1.257 produzierte eine macOS npm-Selbstaktualisierung diesen Fehler bei jedem Start während des Installationsfensters.4839* `Error: claude native binary not installed.`: Eine npm-Installation ersetzte die Claude Code-Binärdatei zu diesem Zeitpunkt, daher führte der Service stattdessen den Platzhalter von npm aus. Versuchen Sie es erneut, nachdem die Installation fertig ist; wenn die Zeile anhält, ohne dass eine Installation läuft, [schließen Sie die npm-Installation ab](/docs/de/troubleshoot-install#native-binary-not-found-after-npm-install). Vor v2.1.257 verursachte eine npm-Selbstaktualisierung unter macOS diesen Fehler bei jedem Start während des Installationsfensters.

4821* `nothing on stderr` mit Exit-Code 1, bei jedem Start, auf Windows: `daemon.lock` benennt einen Prozess, den Claude Code weder signalisieren noch beweisen kann, dass er weg ist, daher schließt jeder neue Service, dass ein anderer die Sperre hält und beendet sich. Eine Sperre, deren Schreiber Claude Code beweisen kann, dass er weg ist, wird von selbst ersetzt und produziert diesen Fehler nicht. Wenn der Fehler bei jedem Start wiederholt wird, löschen Sie `~/.claude/daemon.lock`, dann öffnen Sie die Sitzung oder entsenden Sie erneut. Vor v2.1.257 blockierte eine solche Sperre jeden Start, bis Sie die Datei löschten.4840* `nothing on stderr` mit Exit-Code 1, bei jedem Start, unter Windows: `daemon.lock` benennt einen Prozess, den Claude Code weder signalisieren noch als beendet nachweisen kann, daher schließt jeder neue Service, dass ein anderer die Sperre hält, und beendet sich. Eine Sperre, deren Schreiber Claude Code als beendet nachweisen kann, wird von selbst ersetzt und verursacht diesen Fehler nicht. Wenn der Fehler bei jedem Start wiederholt auftritt, löschen Sie `~/.claude/daemon.lock`, dann öffnen Sie die Sitzung oder entsenden Sie erneut. Vor v2.1.257 blockierte eine solche Sperre jeden Start, bis Sie die Datei löschten.

4822 4841

4823**Was zu tun ist:**4842**Was zu tun ist:**

4824 4843

4825* Wenn die Meldung eine Zeile zitiert, beheben Sie, was sie benennt, dann öffnen Sie die Sitzung oder entsenden Sie erneut. Der nächste Versuch startet den Service erneut4844* Wenn die Meldung eine Zeile zitiert, beheben Sie, was sie benennt, dann öffnen Sie die Sitzung oder entsenden Sie erneut. Der nächste Versuch startet den Service erneut

4826* Führen Sie `claude daemon status` aus, um zu überprüfen, ob ein Service jetzt läuft4845* Führen Sie `claude daemon status` aus, um zu überprüfen, ob jetzt ein Service läuft

4827 4846

4828<h3 id="working-directory-no-longer-exists-when-starting-a-background-session">4847<h3 id="working-directory-no-longer-exists-when-starting-a-background-session">

4829 Arbeitsverzeichnis existiert nicht mehr beim Starten einer Hintergrund-Sitzung4848 Arbeitsverzeichnis existiert nicht mehr beim Starten einer Hintergrund-Sitzung

4835Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4854Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)

4836```4855```

4837 4856

4838Vor v2.1.257 schien die Sitzung zu starten und zeigte sich dann in der Agent-Ansicht als fehlgeschlagene Zeile mit dem gleichen Grund.4857Vor v2.1.257 schien die Sitzung zu starten und erschien dann in der Agent-Ansicht als fehlgeschlagene Zeile mit dem gleichen Grund.

4839 4858

4840Vor v2.1.281 erschien diese Meldung auch, wenn das Verzeichnis bereits weg war, bevor Sie die Sitzung gestartet haben. Dieser Fall meldet [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session).4859Vor v2.1.281 erschien diese Meldung auch, wenn das Verzeichnis bereits weg war, bevor Sie die Sitzung gestartet haben. Dieser Fall meldet [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session).

4841 4860

4844* Erstellen Sie das Verzeichnis neu, das die Meldung nennt, oder entsenden Sie aus einem Verzeichnis, das existiert, dann versuchen Sie es erneut4863* Erstellen Sie das Verzeichnis neu, das die Meldung nennt, oder entsenden Sie aus einem Verzeichnis, das existiert, dann versuchen Sie es erneut

4845 4864

4846<h3 id="workspace-not-trusted-when-dispatching-a-background-session">4865<h3 id="workspace-not-trusted-when-dispatching-a-background-session">

4847 Arbeitsbereich nicht vertraut beim Entsenden einer Hintergrund-Sitzung4866 Workspace nicht vertraut beim Entsenden einer Hintergrund-Sitzung

4848</h3>4867</h3>

4849 4868

4850Sie haben eine [Hintergrund-Sitzung](/docs/de/agent-view) in einem Verzeichnis gestartet oder neu gestartet, das Sie nicht [vertraut haben](/docs/de/permissions#project-allow-rules-and-workspace-trust), und der Arbeitsbereich-Vertrauensdialog konnte nicht erscheinen, um Sie zu fragen. Claude Code startet die Sitzung nicht:4869Sie haben eine [Hintergrund-Sitzung](/docs/de/agent-view) in einem Verzeichnis gestartet oder neu gestartet, dem Sie nicht [vertraut haben](/docs/de/permissions#project-allow-rules-and-workspace-trust), und der Workspace-Vertrauensdialog konnte nicht erscheinen, um Sie zu fragen. Claude Code startet die Sitzung nicht:

4851 4870

4852```text theme={null}4871```text theme={null}

4853Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.4872Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.

4854```4873```

4855 4874

4856Aus einem Terminal im eigenen Verzeichnis der Sitzung zeigt der gleiche Befehl stattdessen den Vertrauensdialog und startet die Sitzung, sobald Sie akzeptieren. Diese Meldung erscheint, wo kein Dialog kann, wie in einem Skript, oder wenn Sie eine Sitzung von einem anderen Verzeichnis als ihrem eigenen neu starten.4875Aus einem Terminal im eigenen Verzeichnis der Sitzung zeigt derselbe Befehl stattdessen den Vertrauensdialog und startet die Sitzung, sobald Sie akzeptieren. Diese Meldung erscheint dort, wo kein Dialog erscheinen kann, etwa in einem Skript, oder wenn Sie eine Sitzung aus einem anderen Verzeichnis als ihrem eigenen neu starten.

4857 4876

4858Zwei Varianten nennen eine andere Ursache:4877Zwei Varianten nennen eine andere Ursache:

4859 4878

4860* **`The home directory is trusted one session at a time`**: Das Verzeichnis der Sitzung ist Ihr Home-Verzeichnis. Claude Code speichert niemals Vertrauen für das Home-Verzeichnis, daher zählt das Akzeptieren des Dialogs dort in einer früheren Sitzung nicht.4879* **`The home directory is trusted one session at a time`**: Das Verzeichnis der Sitzung ist Ihr Home-Verzeichnis. Claude Code speichert niemals Vertrauen für das Home-Verzeichnis, daher zählt das Akzeptieren des Dialogs dort in einer früheren Sitzung nicht.

4861* **`<path> could not be resolved on disk`**: Claude Code konnte das Verzeichnis der Sitzung auf der Festplatte nicht finden.4880* **`<path> could not be resolved on disk`**: Claude Code konnte das Verzeichnis der Sitzung auf der Festplatte nicht finden.

4862 4881

4882Vor v2.1.286 konnte diese Meldung unter Windows auch in einem Verzeichnis erscheinen, dem Sie bereits vertraut hatten, wenn dessen Vertrauenseintrag mit dem Pfad in anderer Groß-/Kleinschreibung gespeichert war. Aktualisieren Sie auf v2.1.286 oder später.

4883

4863**Was zu tun ist:**4884**Was zu tun ist:**

4864 4885

4865* Führen Sie `claude` im Verzeichnis aus, das die Meldung nennt, und akzeptieren Sie den Vertrauensdialog, dann führen Sie den Befehl erneut aus4886* Führen Sie `claude` im Verzeichnis aus, das die Meldung nennt, und akzeptieren Sie den Vertrauensdialog, dann führen Sie den Befehl erneut aus

4866* Für die Home-Verzeichnis-Meldung führen Sie den Befehl aus einem Terminal in Ihrem Home-Verzeichnis aus, damit der Dialog erscheinen kann, oder starten Sie die Sitzung stattdessen von einem Projekt-Verzeichnis4887* Für die Home-Verzeichnis-Meldung führen Sie den Befehl aus einem Terminal in Ihrem Home-Verzeichnis aus, damit der Dialog erscheinen kann, oder starten Sie die Sitzung stattdessen aus einem Projektverzeichnis

4867* Für die `could not be resolved on disk`-Meldung erstellen Sie das Verzeichnis neu, oder starten Sie eine neue Sitzung von einem Verzeichnis, das existiert4888* Für die `could not be resolved on disk`-Meldung erstellen Sie das Verzeichnis neu, oder starten Sie eine neue Sitzung aus einem Verzeichnis, das existiert

4868 4889

4869<h2 id="wrapper-and-ide-errors">4890<h2 id="wrapper-and-ide-errors">

4870 Fehler bei Wrapper und IDE4891 Fehler bei Wrapper und IDE

hooks.md +4 −10

Details

731 Das `/hooks`-Menü731 Das `/hooks`-Menü

732</h3>732</h3>

733 733

734Geben Sie `/hooks` in Claude Code ein, um einen schreibgeschützten Browser für Ihre konfigurierten Hooks zu öffnen. Das Menü zeigt jedes Hook-Ereignis mit einer Anzahl konfigurierter Hooks, lässt Sie in Matcher bohren und zeigt die vollständigen Details jedes Hook-Handlers. Verwenden Sie es, um die Konfiguration zu überprüfen, zu überprüfen, aus welcher Einstellungsdatei ein Hook stammt, oder um einen Hook-Befehl, Prompt oder URL zu überprüfen.734Geben Sie `/hooks` in Claude Code ein, um eine nur lesende Ansicht Ihrer konfigurierten Hooks zu öffnen. Die Liste kennzeichnet jeden Hook mit seiner Herkunft, z. B. Benutzereinstellungen, Projekteinstellungen, lokale Einstellungen, ein Plugin oder die aktuelle Sitzung.

735 735

736Das Menü zeigt alle fünf Hook-Typen: `command`, `prompt`, `agent`, `http` und `mcp_tool`. Jeder Hook ist mit einem `[type]`-Präfix und einer Quelle gekennzeichnet, die angibt, wo er definiert wurde:736Wählen Sie einen Hook aus, um den vollständigen Text dessen zu sehen, was er ausführt, und wo er definiert ist, z. B. den Pfad seiner Einstellungsdatei oder den Namen seines Plugins.

737 737

738* `User Settings`: aus `~/.claude/settings.json`738Um alle Hook-Ereignisse zu durchsuchen, einschließlich solcher ohne konfigurierte Hooks, wählen Sie `All events` am Ende der Liste aus.

739* `Project Settings`: aus `.claude/settings.json`

740* `Local Settings`: aus `.claude/settings.local.json`

741* `Plugin Hooks`: aus der `hooks/hooks.json` eines Plugins

742* `Session Hooks`: in der aktuellen Sitzung im Speicher registriert

~~743~~

744Das Auswählen eines Hooks öffnet eine Detailansicht, die sein Ereignis, Matcher, Typ, Quellendatei und den vollständigen Befehl, Prompt oder URL anzeigt. Das Menü ist schreibgeschützt: Um Hooks hinzuzufügen, zu ändern oder zu entfernen, bearbeiten Sie die Einstellungs-JSON direkt oder bitten Sie Claude, die Änderung vorzunehmen.

745 739

746<h3 id="disable-or-remove-hooks">740<h3 id="disable-or-remove-hooks">

747 Hooks deaktivieren oder entfernen741 Hooks deaktivieren oder entfernen

748</h3>742</h3>

749 743

750Um einen Hook zu entfernen, löschen Sie seinen Eintrag aus der Einstellungs-JSON-Datei.744Um einen in einer Einstellungsdatei definierten Hook zu entfernen, löschen Sie seinen Eintrag aus dieser Datei.

751 745

752Um alle Hooks vorübergehend zu deaktivieren, ohne sie zu entfernen, setzen Sie `"disableAllHooks": true` in Ihrer Einstellungsdatei. Claude Code liest den Wert, der nach [Einstellungspriorität](/docs/de/settings#settings-precedence) bleibt, sodass ein `"disableAllHooks": false` in der `.claude/settings.json` eines Projekts ein `true` in Ihren Benutzereinstellungen überschreibt. Um Hooks für einen Run auszuschalten, unabhängig davon, was die Einstellungen des Projekts sagen, übergeben Sie `--settings '{"disableAllHooks": true}'`, was Vorrang vor Projekt- und lokalen Einstellungen hat. Es gibt keine Möglichkeit, einen einzelnen Hook zu deaktivieren, während er in der Konfiguration bleibt.746Um alle Hooks vorübergehend zu deaktivieren, ohne sie zu entfernen, setzen Sie `"disableAllHooks": true` in Ihrer Einstellungsdatei. Claude Code liest den Wert, der nach [Einstellungspriorität](/docs/de/settings#settings-precedence) bleibt, sodass ein `"disableAllHooks": false` in der `.claude/settings.json` eines Projekts ein `true` in Ihren Benutzereinstellungen überschreibt. Um Hooks für einen Run auszuschalten, unabhängig davon, was die Einstellungen des Projekts sagen, übergeben Sie `--settings '{"disableAllHooks": true}'`, was Vorrang vor Projekt- und lokalen Einstellungen hat. Es gibt keine Möglichkeit, einen einzelnen Hook zu deaktivieren, während er in der Konfiguration bleibt.

753 747

hooks-guide.md +12 −9

Details

69 </Step>69 </Step>

70 70

71 <Step title="Überprüfen Sie die Konfiguration">71 <Step title="Überprüfen Sie die Konfiguration">

72 Geben Sie `/hooks` ein, um den Hooks-Browser zu öffnen. Sie sehen eine Liste aller verfügbaren Hook-Events mit einer Anzahl neben jedem Event, das Hooks konfiguriert hat. Wählen Sie `Notification` aus, um zu bestätigen, dass Ihr neuer Hook in der Liste angezeigt wird. Wenn Sie den Hook auswählen, werden seine Details angezeigt: das Event, der Matcher, der Typ, die Quelldatei und der Befehl.72 Geben Sie `/hooks` in der Eingabeaufforderung von Claude Code ein, um den Hooks-Browser zu öffnen. Ihr neuer Hook erscheint in der Liste unter `Notification`.

73 </Step>73 </Step>

74 74

75 <Step title="Testen Sie den Hook">75 <Step title="Testen Sie den Hook">

77 </Step>77 </Step>

78</Steps>78</Steps>

79 79

~~80<Tip>~~

~~81 Das Menü `/hooks` ist schreibgeschützt. Um Hooks hinzuzufügen, zu ändern oder zu entfernen, bearbeiten Sie Ihre Einstellungs-JSON direkt oder bitten Sie Claude, die Änderung vorzunehmen.~~

~~82</Tip>~~

84<h2 id="what-you-can-automate">80<h2 id="what-you-can-automate">

85 Was Sie automatisieren können81 Was Sie automatisieren können

86</h2>82</h2>

97 93

98Erhalten Sie eine Desktop-Benachrichtigung, wenn Claude die Arbeit beendet und Ihre Eingabe benötigt, damit Sie zu anderen Aufgaben wechseln können, ohne das Terminal zu überprüfen.94Erhalten Sie eine Desktop-Benachrichtigung, wenn Claude die Arbeit beendet und Ihre Eingabe benötigt, damit Sie zu anderen Aufgaben wechseln können, ohne das Terminal zu überprüfen.

99 95

100Dieser Hook verwendet das `Notification`-Event, das ausgelöst wird, wenn Claude auf Eingaben oder Berechtigungen wartet. Siehe [wann jeder Benachrichtigungstyp ausgelöst wird](/docs/de/hooks#notification) für den genauen Zeitpunkt. Jede Registerkarte unten verwendet den nativen Benachrichtigungsbefehl der Plattform. Fügen Sie dies zu `~/.claude/settings.json` hinzu:96Dieser Hook verwendet das `Notification`-Event, das Claude Code auslöst, wenn Claude auf Eingaben oder Berechtigungen wartet. Siehe [wann jeder Benachrichtigungstyp ausgelöst wird](/docs/de/hooks#notification) für den genauen Zeitpunkt.

98Jede Registerkarte unten verwendet den nativen Benachrichtigungsbefehl der Plattform. Fügen Sie dies zu `~/.claude/settings.json` hinzu:

101 99

102<Tabs>100<Tabs>

103 <Tab title="macOS">101 <Tab title="macOS">

120 ```118 ```

121 119

122 <Accordion title="Wenn keine Benachrichtigung angezeigt wird">120 <Accordion title="Wenn keine Benachrichtigung angezeigt wird">

123 `osascript` leitet Benachrichtigungen über die integrierte Script Editor-App weiter. Wenn Script Editor keine Benachrichtigungsberechtigung hat, schlägt der Befehl stillschweigend fehl, und macOS fordert Sie nicht auf, sie zu gewähren. Führen Sie dies einmal im Terminal aus, um Script Editor in Ihren Benachrichtigungseinstellungen angezeigt zu bekommen:121 `osascript` leitet Benachrichtigungen über die integrierte Script Editor-App weiter. Wenn Script Editor keine Benachrichtigungsberechtigung hat, schlägt der Befehl stillschweigend fehl, und macOS fordert Sie nicht auf, sie zu gewähren.

122

123 Führen Sie dies einmal im Terminal aus, um Script Editor in Ihren Benachrichtigungseinstellungen angezeigt zu bekommen:

124 124

125 ```bash theme={null}125 ```bash theme={null}

126 osascript -e 'display notification "test"'126 osascript -e 'display notification "test"'

180 ```180 ```

181 181

182 <Accordion title="Wenn kein Dialog angezeigt wird">182 <Accordion title="Wenn kein Dialog angezeigt wird">

183 Dieser Befehl öffnet ein Dialogfeld statt einer Benachrichtigung in der Ecke Ihres Bildschirms, sodass das Dialogfeld hinter Ihrem Terminal-Fenster öffnen kann. Testen Sie den Befehl zunächst direkt in PowerShell. Wenn Sie Claude Code in WSL ausführen, muss `powershell.exe` über Windows-Interop auf Ihrem `PATH` verfügbar sein.183 Dieser Befehl öffnet ein Dialogfeld statt einer Benachrichtigung in der Ecke Ihres Bildschirms, sodass das Dialogfeld hinter Ihrem Terminal-Fenster öffnen kann. Testen Sie den Befehl zunächst direkt in PowerShell.

184

185 Wenn Sie Claude Code in WSL ausführen, muss `powershell.exe` über Windows-Interop auf Ihrem `PATH` verfügbar sein.

184 </Accordion>186 </Accordion>

185 </Tab>187 </Tab>

186</Tabs>188</Tabs>

212 214

213`agent_needs_input` für eine Teamkollegen-Terminal-Setup-Frage erfordert Claude Code v2.1.248 oder später.215`agent_needs_input` für eine Teamkollegen-Terminal-Setup-Frage erfordert Claude Code v2.1.248 oder später.

214 216

215Geben Sie `/hooks` ein und wählen Sie `Notification` aus, um zu bestätigen, dass der Hook registriert ist. Für das vollständige Event-Schema siehe die [Notification-Referenz](/docs/de/hooks#notification).217Geben Sie `/hooks` im Eingabefeld von Claude Code ein und bestätigen Sie, dass der Hook unter `Notification` angezeigt wird.

216 218

217<h3 id="auto-format-code-after-edits">219<h3 id="auto-format-code-after-edits">

218 Code nach Bearbeitungen automatisch formatieren220 Code nach Bearbeitungen automatisch formatieren

1055* Dateibearbeitungen werden normalerweise automatisch aufgegriffen. Wenn sie nach einigen Sekunden nicht angezeigt werden, hat der Datei-Watcher die Änderung möglicherweise übersehen: Starten Sie Ihre Sitzung neu, um ein Neuladen zu erzwingen.1057* Dateibearbeitungen werden normalerweise automatisch aufgegriffen. Wenn sie nach einigen Sekunden nicht angezeigt werden, hat der Datei-Watcher die Änderung möglicherweise übersehen: Starten Sie Ihre Sitzung neu, um ein Neuladen zu erzwingen.

1056* Überprüfen Sie, dass Ihr JSON gültig ist: Nachfolgende Kommas und Kommentare sind nicht zulässig1058* Überprüfen Sie, dass Ihr JSON gültig ist: Nachfolgende Kommas und Kommentare sind nicht zulässig

1057* Bestätigen Sie, dass sich die Einstellungsdatei am richtigen Ort befindet: `.claude/settings.json` für Projekt-Hooks, `~/.claude/settings.json` für globale Hooks1059* Bestätigen Sie, dass sich die Einstellungsdatei am richtigen Ort befindet: `.claude/settings.json` für Projekt-Hooks, `~/.claude/settings.json` für globale Hooks

1060* Wenn das Menü `Only hooks from managed settings run here` anzeigt, hat Ihre Organisation [`allowManagedHooksOnly`](/docs/de/settings-reference#allowmanagedhooksonly) gesetzt. Hooks in Ihren Benutzer-, Projekt- und lokalen Einstellungsdateien werden nicht ausgeführt und nicht aufgelistet

1058 1061

1059<h3 id="stop-hook-hits-the-block-cap">1062<h3 id="stop-hook-hits-the-block-cap">

1060 Stop Hook trifft die Block-Obergrenze1063 Stop Hook trifft die Block-Obergrenze

llm-gateway-protocol.md +1 −1

Details

73 73

74Streamen Sie Inferenzantworten. Claude Code liest den Stream, während er ankommt, also wenn Ihr Gateway vollständige Antworten puffert, bevor es sie weiterleitet, stellt Claude Code fest.74Streamen Sie Inferenzantworten. Claude Code liest den Stream, während er ankommt, also wenn Ihr Gateway vollständige Antworten puffert, bevor es sie weiterleitet, stellt Claude Code fest.

75 75

76Liefern Sie die vollständige Ereignissequenz jeder Antwort, ohne Ereignisse zu verwerfen, zu duplizieren oder neu zu ordnen. Wenn ein Ereignis auf einen Inhaltsblock verweist, dessen `content_block_start` nie angekommen ist, oder auf einen Block, dessen `content_block_stop` bereits angekommen ist, stoppt Claude Code das Lesen des Streams bei diesem Ereignis, anstatt es anzuwenden, sodass ein dupliziertes `content_block_stop` denselben Tool-Aufruf nicht zweimal ausführen kann. [Die obige Antwort kann unvollständig sein](/docs/de/errors#the-response-above-may-be-incomplete) beschreibt, was der Benutzer sieht, unter den Varianten `Part of the response never arrived` und `The response stream was malformed`.76Liefern Sie die vollständige Ereignissequenz jeder Antwort, ohne Ereignisse zu verwerfen, zu duplizieren oder neu zu ordnen. Wenn eine Amazon Bedrock-Guardrail eine Antwort blockiert, leiten Sie die Ereignisse, die sie sendet, unverändert weiter, auch wenn sie auf einen Inhaltsblock verweisen, dessen `content_block_stop` bereits angekommen ist. [AWS Guardrails](/docs/de/amazon-bedrock#aws-guardrails) beschreibt, wie diese Antwort endet. Wenn ein anderes Ereignis auf einen Inhaltsblock verweist, dessen `content_block_start` nie angekommen ist, oder auf einen Block, dessen `content_block_stop` bereits angekommen ist, stoppt Claude Code das Lesen des Streams bei diesem Ereignis, anstatt es anzuwenden, sodass ein dupliziertes `content_block_stop` denselben Tool-Aufruf nicht zweimal ausführen kann. [Die obige Antwort kann unvollständig sein](/docs/de/errors#the-response-above-may-be-incomplete) beschreibt, was der Benutzer sieht, unter den Varianten `Part of the response never arrived` und `The response stream was malformed`.

77 77

78Leiten Sie jede Antwort durch ihre endgültigen `message_delta` und `message_stop` Ereignisse weiter, bevor Sie den Body beenden. Ein Body, der nach einem `message_delta` mit einem `stop_reason` endet, ohne dass noch ein Inhaltsblock offen ist und kein Inhaltsblock-Ereignis nach diesem Frame folgt, zählt als vollständig, auch wenn `message_stop` fehlt. Ein Body, den Ihr Gateway sauberer beendet, sobald ein Inhaltsblock gestartet hat, wird genauso behandelt wie eine unterbrochene Verbindung: [Automatische Wiederholungen](/docs/de/errors#automatic-retries) sagt, wann Claude Code die Anfrage erneut stellt, und [Die obige Antwort kann unvollständig sein](/docs/de/errors#the-response-above-may-be-incomplete) behandelt, was es behält, sobald sichtbarer Inhalt angekommen ist. Claude Code behält den `stop_reason`, den ein `message_delta` liefert, bei, sodass ein späteres nur-Nutzungs-`message_delta`, dessen `delta` `stop_reason: null` oder keinen `stop_reason` Schlüssel hat, ihn nicht löscht.78Leiten Sie jede Antwort durch ihre endgültigen `message_delta` und `message_stop` Ereignisse weiter, bevor Sie den Body beenden. Ein Body, der nach einem `message_delta` mit einem `stop_reason` endet, ohne dass noch ein Inhaltsblock offen ist und kein Inhaltsblock-Ereignis nach diesem Frame folgt, zählt als vollständig, auch wenn `message_stop` fehlt. Ein Body, den Ihr Gateway sauberer beendet, sobald ein Inhaltsblock gestartet hat, wird genauso behandelt wie eine unterbrochene Verbindung: [Automatische Wiederholungen](/docs/de/errors#automatic-retries) sagt, wann Claude Code die Anfrage erneut stellt, und [Die obige Antwort kann unvollständig sein](/docs/de/errors#the-response-above-may-be-incomplete) behandelt, was es behält, sobald sichtbarer Inhalt angekommen ist. Claude Code behält den `stop_reason`, den ein `message_delta` liefert, bei, sodass ein späteres nur-Nutzungs-`message_delta`, dessen `delta` `stop_reason: null` oder keinen `stop_reason` Schlüssel hat, ihn nicht löscht.

79 79

memory.md +6 −4

Details

50Behandeln Sie CLAUDE.md als den Ort, an dem Sie aufschreiben, was Sie sonst erklären würden. Fügen Sie hinzu, wenn:50Behandeln Sie CLAUDE.md als den Ort, an dem Sie aufschreiben, was Sie sonst erklären würden. Fügen Sie hinzu, wenn:

51 51

52* Claude denselben Fehler ein zweites Mal macht52* Claude denselben Fehler ein zweites Mal macht

~~53* Eine Code-Überprüfung etwas findet, das Claude über diese Codebasis hätte wissen sollen~~53* Ein Code-Review etwas findet, das Claude über diese Codebasis hätte wissen sollen

54* Sie dieselbe Korrektur oder Klarstellung in den Chat eingeben, die Sie in der letzten Sitzung eingegeben haben54* Sie dieselbe Korrektur oder Klarstellung in den Chat eingeben, die Sie in der letzten Sitzung eingegeben haben

55* Ein neuer Teamkollege denselben Kontext benötigen würde, um produktiv zu sein55* Ein neuer Teamkollege denselben Kontext benötigen würde, um produktiv zu sein

56 56

161 161

162Alle entdeckten Dateien werden in den Kontext verkettet, statt sich gegenseitig zu überschreiben. Über den Verzeichnisbaum wird der Inhalt vom Dateisystem-Root bis zu Ihrem Arbeitsverzeichnis geordnet. Für das Beispiel `foo/bar/` erscheint `foo/CLAUDE.md` im Kontext vor `foo/bar/CLAUDE.md`, daher werden Anweisungen näher an dem Ort, an dem Sie Claude gestartet haben, zuletzt gelesen. Innerhalb jedes Verzeichnisses wird `CLAUDE.local.md` nach `CLAUDE.md` angehängt, daher sind Ihre persönlichen Notizen das letzte, was Claude auf dieser Ebene liest.162Alle entdeckten Dateien werden in den Kontext verkettet, statt sich gegenseitig zu überschreiben. Über den Verzeichnisbaum wird der Inhalt vom Dateisystem-Root bis zu Ihrem Arbeitsverzeichnis geordnet. Für das Beispiel `foo/bar/` erscheint `foo/CLAUDE.md` im Kontext vor `foo/bar/CLAUDE.md`, daher werden Anweisungen näher an dem Ort, an dem Sie Claude gestartet haben, zuletzt gelesen. Innerhalb jedes Verzeichnisses wird `CLAUDE.local.md` nach `CLAUDE.md` angehängt, daher sind Ihre persönlichen Notizen das letzte, was Claude auf dieser Ebene liest.

163 163

164Claude entdeckt auch `CLAUDE.md`- und `CLAUDE.local.md`-Dateien in Unterverzeichnissen unter Ihrem aktuellen Arbeitsverzeichnis. Statt sie beim Start zu laden, werden sie eingebunden, wenn Claude Dateien in diesen Unterverzeichnissen liest.164Claude entdeckt auch `CLAUDE.md`- und `CLAUDE.local.md`-Dateien in Unterverzeichnissen unter Ihrem aktuellen Arbeitsverzeichnis. Statt sie beim Start zu laden, werden sie eingebunden, wenn Claude Dateien in diesen Unterverzeichnissen liest. Für Dateien innerhalb eines Worktrees unter `.claude/worktrees/` siehe [Subagenten mit Worktrees isolieren](/docs/de/worktrees#isolate-subagents-with-worktrees).

165 165

166Wenn Sie in einem großen Monorepo arbeiten, in dem CLAUDE.md-Dateien anderer Teams aufgegriffen werden, verwenden Sie [`claudeMdExcludes`](#exclude-specific-claude-md-files), um sie zu überspringen. Für das vollständige Layout von Root- und Pro-Verzeichnis-CLAUDE.md-Dateien und Regeln siehe [Monorepos und große Repos](/docs/de/large-codebases).166Wenn Sie in einem großen Monorepo arbeiten, in dem CLAUDE.md-Dateien anderer Teams aufgegriffen werden, verwenden Sie [`claudeMdExcludes`](#exclude-specific-claude-md-files), um sie zu überspringen. Für das vollständige Layout von Root- und Pro-Verzeichnis-CLAUDE.md-Dateien und Regeln siehe [Monorepos und große Repos](/docs/de/large-codebases).

167 167

232- Include OpenAPI documentation comments232- Include OpenAPI documentation comments

233```233```

234 234

235Regeln ohne ein `paths`-Feld werden bedingungslos geladen und gelten für alle Dateien. Pfadgebundene Regeln werden ausgelöst, wenn Claude Dateien liest, die dem Muster entsprechen, nicht bei jedem Tool-Einsatz. Ab v2.1.198 funktioniert das Matching auch, wenn Claude eine Datei über einen symlinks Pfad zum Projektverzeichnis erreicht, zum Beispiel in einem symlinks Checkout.235Regeln ohne ein `paths`-Feld werden bedingungslos geladen und gelten für alle Dateien. Pfadgebundene Regeln werden ausgelöst, wenn Claude Dateien liest, die dem Muster entsprechen, nicht bei jedem Tool-Einsatz. Das Matching funktioniert auch, wenn Claude eine Datei über einen per Symlink verknüpften Pfad zum Projektverzeichnis erreicht, zum Beispiel in einem per Symlink verknüpften Checkout.

236 236

237Verwenden Sie Glob-Muster im Feld `paths`, um Dateien nach Erweiterung, Verzeichnis oder einer beliebigen Kombination zu vergleichen:237Verwenden Sie Glob-Muster im Feld `paths`, um Dateien nach Erweiterung, Verzeichnis oder einer beliebigen Kombination zu vergleichen:

238 238

538 Aktivieren oder deaktivieren Sie Auto-Memory538 Aktivieren oder deaktivieren Sie Auto-Memory

539</h3>539</h3>

540 540

541Auto-Memory ist standardmäßig aktiviert. Um es umzuschalten, öffnen Sie `/memory` in einer Sitzung und verwenden Sie den Auto-Memory-Schalter, der `autoMemoryEnabled` in Ihren Benutzereinstellungen unter `~/.claude/settings.json` speichert. Um es für ein einzelnes Projekt auszuschalten, setzen Sie `autoMemoryEnabled` in den Einstellungen dieses Projekts:541Auto-Memory ist in lokalen Sitzungen standardmäßig aktiviert. Außerhalb von [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen läuft eine Sitzung in einer [selbst gehosteten Umgebung](/docs/de/self-hosted-environments-configuration#how-each-session’s-config-is-assembled) standardmäßig mit deaktiviertem Auto-Memory.

542

543Um es umzuschalten, öffnen Sie `/memory` in einer Sitzung und verwenden Sie den Auto-Memory-Schalter, der `autoMemoryEnabled` in Ihren Benutzereinstellungen unter `~/.claude/settings.json` speichert. Um es für ein einzelnes Projekt auszuschalten, setzen Sie `autoMemoryEnabled` in den Einstellungen dieses Projekts:

542 544

543```json theme={null}545```json theme={null}

544{546{

plugins/cli-reference.md +19 −1

Details

571* Das Tag existiert bereits571* Das Tag existiert bereits

572* Der Arbeitsbaum ist schmutzig572* Der Arbeitsbaum ist schmutzig

573 573

574<h3 id="plugin-test">

575 plugin test

576</h3>

577

578Führen Sie die Tests für einen [Mod](/docs/de/plugins/mods/overview) aus, ein Plugin, dessen Code Event-Handler registriert. Der Befehl benötigt keine Sitzung, keine Anmeldung und kein Netzwerk. Wie Sie einen Test schreiben, erfahren Sie unter [Einen Mod testen](/docs/de/plugins/mods/test).

579

580```bash theme={null}

581claude plugin test [directory]

582```

583

584Das `[directory]` ist das Verzeichnis des Mods, standardmäßig das aktuelle Verzeichnis. Der Befehl führt jede Datei darunter aus, deren Name auf `.test.ts` oder `.test.tsx` endet, und beendet sich mit Status 1, wenn ein Test fehlschlägt.

585

586Führen Sie die Tests für einen Mod in `./first-mod` aus:

587

588```bash theme={null}

589claude plugin test ./first-mod

590```

591

574<h3 id="plugin-validate">592<h3 id="plugin-validate">

575 plugin validate593 plugin validate

576</h3>594</h3>

804 822

805Ein `<plugin>` ist ein Plugin-`name` oder `name@marketplace`.823Ein `<plugin>` ist ein Plugin-`name` oder `name@marketplace`.

806 824

807Die Tabelle unten listet jede Sitzungsform auf. Die Shell-Unterbefehle `init`, `update`, `details`, `prune`, `eval` und `eval init` haben keine Sitzungsform.825Die Tabelle unten listet jede Sitzungsform auf. Die Shell-Unterbefehle `init`, `update`, `details`, `prune`, `eval`, `eval init` und `test` haben keine Sitzungsform.

808 826

810| :- | :- | :- |828| :- | :- | :- |

plugins/loading.md +20 −14

Details

244 Wenn die Abhängigkeitsinstallation läuft244 Wenn die Abhängigkeitsinstallation läuft

245</h4>245</h4>

246 246

247Claude Code führt die Installation im kopierten Versionsverzeichnis jedes Mal aus, wenn es eines erstellt:247Claude Code installiert die Abhängigkeiten jedes Mal in das kopierte Versionsverzeichnis, wenn es eines erstellt:

248 248

249* Wenn Sie ein Plugin installieren249* Wenn Sie ein Plugin installieren

250* Wenn Claude Code ein Plugin auf eine neue Version aktualisiert250* Wenn Claude Code ein Plugin auf eine neue Version aktualisiert

252 252

253Für ein Relative-Pfad-Plugin, das [an Ort und Stelle geladen wird](#in-place-and-copied-plugins) von einem lokalen Verzeichnis-Marktplatz, installiert Claude Code die Abhängigkeiten nicht in das Quellverzeichnis. Installieren Sie sie dort selbst, oder von einem Hook in [`${CLAUDE_PLUGIN_DATA}`](/docs/de/plugins/components#path-variables-and-persistent-data).253Für ein Relative-Pfad-Plugin, das [an Ort und Stelle geladen wird](#in-place-and-copied-plugins) von einem lokalen Verzeichnis-Marktplatz, installiert Claude Code die Abhängigkeiten nicht in das Quellverzeichnis. Installieren Sie sie dort selbst, oder von einem Hook in [`${CLAUDE_PLUGIN_DATA}`](/docs/de/plugins/components#path-variables-and-persistent-data).

254 254

255Die Installation läuft nur, wenn das Plugin-Root-Verzeichnis sowohl eine `package.json` als auch eine unterstützte Lockdatei enthält. Die Lockdatei entscheidet, welchen Befehl Claude Code ausführt:255Die Installation läuft nur, wenn das Plugin-Root-Verzeichnis sowohl eine `package.json` als auch eine unterstützte Lockdatei enthält.

256 256

257| Lockdatei | Befehl |257Die Lockdatei entscheidet, welchen Paketmanager Claude Code ausführt:

258

259| Lockdatei | Paketmanager |

258| :- | :- |260| :- | :- |

259| `bun.lock` oder `bun.lockb` | `bun install --frozen-lockfile --ignore-scripts` |261| `bun.lock` | Bun |

260| `npm-shrinkwrap.json` oder `package-lock.json` | `npm ci --ignore-scripts` |262| `npm-shrinkwrap.json` oder `package-lock.json` | npm |

261 263

262Wenn ein Plugin mehr als eine dieser Lockdateien enthält, verwendet Claude Code die erste Übereinstimmung, Überprüfung in Reihenfolge: `bun.lock`, `bun.lockb`, `npm-shrinkwrap.json`, `package-lock.json`.264Wenn ein Plugin mehr als eine dieser Lockdateien enthält, verwendet Claude Code die erste Übereinstimmung, Überprüfung in Reihenfolge: `bun.lock`, `npm-shrinkwrap.json`, `package-lock.json`.

263 265

264Claude Code überspringt die Installation für Yarn- und pnpm-Lockdateien und für eine `bunfig.toml` neben der Bun-Lockdatei:266Claude Code überspringt die Installation in diesen Lockdatei-Fällen:

265 267

266* Wenn Ihr Plugin nur eine `yarn.lock` oder `pnpm-lock.yaml` hat, ersetzen Sie sie durch eine npm-Lockdatei268* **`bun.lockb`**: Die binäre Lockdatei von Bun kann nicht überprüft werden. Liefern Sie stattdessen eine Text-`bun.lock` oder eine npm-Lockdatei mit

267* Wenn eine `bunfig.toml` im gleichen Verzeichnis wie die Bun-Lockdatei ist, entfernen Sie die `bunfig.toml`, oder ersetzen Sie die Bun-Lockdatei durch eine npm-Lockdatei269* **`yarn.lock` oder `pnpm-lock.yaml`**: Ersetzen Sie sie durch eine npm-Lockdatei

270* **Eine Lockdatei in einem Format, das Claude Code nicht liest**: Eine npm-Lockdatei benötigt eine `lockfileVersion` von `2` oder `3`, die npm 7 oder höher schreibt, und eine `bun.lock` benötigt eine `lockfileVersion` von höchstens `2`

268 271

269Fügen Sie eine npm-Lockdatei ein, um die meisten Benutzer zu erreichen. Claude Code führt den Paketmanager der übereinstimmenden Lockdatei aus dem PATH des Benutzers aus und versucht nicht den anderen Lockdatei-Paketmanager, wenn dieser fehlt.272Fügen Sie eine npm-Lockdatei ein, um die meisten Benutzer zu erreichen. Claude Code führt den Paketmanager der übereinstimmenden Lockdatei aus dem PATH des Benutzers aus und versucht nicht den anderen Lockdatei-Paketmanager, wenn dieser fehlt.

270 273

276 279

277Claude Code beschränkt diese Abhängigkeitsinstallation so, dass kein Code aus dem Plugin oder seinen Paketen während der Installation ausgeführt wird, und begrenzt, wie lange sie laufen kann:280Claude Code beschränkt diese Abhängigkeitsinstallation so, dass kein Code aus dem Plugin oder seinen Paketen während der Installation ausgeführt wird, und begrenzt, wie lange sie laufen kann:

278 281

279* **Gefrorene Auflösung**: Bun und npm installieren genau das, was die Lockdatei anheftet, und schlagen fehl, anstatt Versionen erneut aufzulösen, wenn `package.json` und die Lockdatei nicht übereinstimmen282* **Nur Registry-Pakete**: Jede Abhängigkeit muss ein Registry-Paket sein, das in der Lockdatei auf eine exakte Version festgelegt ist. Ein Plugin mit einer Git-, GitHub-, Ordner-, Workspace- oder verlinkten Abhängigkeit erhält keine Installation.

283* **`https`-Downloads**: Ein Download-Link in der Lockdatei muss `https` verwenden, es sei denn, er zeigt auf die eigene Standard-npm-Registry des installierenden Benutzers.

284* **Ein separater Installationsordner**: Der Paketmanager läuft in einem eigenen Ordner, der nur eine Kopie der überprüften Abhängigkeitsliste enthält, sodass npm und Bun die `.npmrc`, `.env` oder `bunfig.toml` des Plugins nicht lesen. Wenn die Installation erfolgreich ist, verschiebt Claude Code das resultierende `node_modules` in das Plugin.

285* **Gefrorene Auflösung**: Die Installation verwendet genau die Versionen, die die Lockdatei festlegt, und Claude Code überspringt sie, wenn `package.json` und die Lockdatei nicht dieselben Abhängigkeiten auflisten

280* **Keine Lifecycle-Skripte**: `--ignore-scripts` hält `preinstall`-, `install`- und `postinstall`-Skripte davon ab, zu laufen, daher laden Abhängigkeiten, die native Module in diesen Skripten erstellen, herunter, werden aber während dieser Installation nicht kompiliert286* **Keine Lifecycle-Skripte**: `--ignore-scripts` hält `preinstall`-, `install`- und `postinstall`-Skripte davon ab, zu laufen, daher laden Abhängigkeiten, die native Module in diesen Skripten erstellen, herunter, werden aber während dieser Installation nicht kompiliert

287* **Keine Überschreibungen oder Patches**: Ein Plugin, dessen `package.json` npm-`overrides` setzt, erhält keine Installation aus einer npm-Lockdatei, und ein Plugin, das Bun-`patchedDependencies` setzt, erhält keine Installation aus `bun.lock`

281* **60-Sekunden-Timeout**: Claude Code stoppt eine Installation, die länger läuft, und behandelt sie als fehlgeschlagen288* **60-Sekunden-Timeout**: Claude Code stoppt eine Installation, die länger läuft, und behandelt sie als fehlgeschlagen

282 289

283Claude Code ruft ein npm-Quellen-Plugin vor dieser Abhängigkeitsinstallation ab, und keines der Installationsskripte des Pakets selbst läuft während des Abrufs. Siehe [npm-Plugin-Quelle](/docs/de/plugins/marketplace-reference#npm-plugin-source).290Claude Code ruft ein npm-Quellen-Plugin vor dieser Abhängigkeitsinstallation ab, und keines der Installationsskripte des Pakets selbst läuft während des Abrufs. Siehe [npm-Plugin-Quelle](/docs/de/plugins/marketplace-reference#npm-plugin-source).

290 Wenn die Abhängigkeitsinstallation fehlschlägt oder übersprungen wird297 Wenn die Abhängigkeitsinstallation fehlschlägt oder übersprungen wird

291</h4>298</h4>

292 299

293Eine fehlgeschlagene oder übersprungene Installation blockiert das Plugin nie, und jeder Fall hinterlässt ein anderes Zeichen:300Eine fehlgeschlagene oder übersprungene Installation blockiert das Plugin nie, das dann ohne die Abhängigkeiten geladen wird. Jeder Fall hinterlässt ein anderes Zeichen:

294 301

295* Eine fehlgeschlagene Installation oder eine, die übersprungen wird, weil eine Yarn- oder pnpm-Lockdatei oder eine `bunfig.toml` vorhanden ist, erscheint als Warnung in der `claude --debug`-Ausgabe302* Eine fehlgeschlagene Installation oder eine, die wegen ihrer Lockdatei oder einer der [Grenzen der Installation](#limits-on-the-dependency-install) übersprungen wird, erscheint in der `claude --debug`-Ausgabe als Zeile `Plugin dependency install warning`, die den Grund angibt

296* Ein Plugin mit einer `package.json` und keiner Lockdatei wird ohne Logeintrag übersprungen303* Ein Plugin mit einer `package.json` und keiner Lockdatei wird ohne Logeintrag übersprungen

297* Eine Timeout-Installation kann einen teilweisen `node_modules`-Baum in der zwischengespeicherten Kopie hinterlassen

298 304

299Wenn die automatische Installation eine Abhängigkeit nicht bereitstellen kann, installieren Sie sie von einem Hook in das [persistente Datenverzeichnis](/docs/de/plugins/components#path-variables-and-persistent-data). Dies umfasst Pakete, die ihre Lifecycle-Skripte zum Erstellen benötigen, Python-Abhängigkeiten und Plugins, die mit Yarn oder pnpm gesperrt sind.305Wenn die automatische Installation eine Abhängigkeit nicht bereitstellen kann, installieren Sie sie von einem Hook in das [persistente Datenverzeichnis](/docs/de/plugins/components#path-variables-and-persistent-data). Dies umfasst Pakete, die ihre Lifecycle-Skripte zum Bauen benötigen, Python-Abhängigkeiten, Plugins, die mit Yarn oder pnpm gesperrt sind, und Abhängigkeiten, die keine Registry-Pakete sind, wie Git-Abhängigkeiten.

300 306

301<h2 id="versions-and-updates">307<h2 id="versions-and-updates">

302 Versionen und Updates308 Versionen und Updates

plugins/marketplace-reference.md +11 −3

Details

156| `url` | `url`, `ref`, `sha` | Jedes Git-Repository nach URL |156| `url` | `url`, `ref`, `sha` | Jedes Git-Repository nach URL |

158| `npm` | `package`, `version`, `registry` | npm-Paket, abgerufen mit Ihrem npm-Client und entpackt ohne Ausführung von Installationsskripten |158| `npm` | `package`, `version`, `registry` | npm-Registry-Paket oder Tarball-Link, abgerufen mit Ihrem npm-Client und entpackt ohne Ausführung von Installationsskripten |

160| `command` | `command`, `timeout`, `mode` | Verzeichnis, das von einem Befehl gedruckt wird, den Claude Code auf der Maschine des Benutzers ausführt. Erfordert Claude Code v2.1.229 oder später |160| `command` | `command`, `timeout`, `mode` | Verzeichnis, das von einem Befehl gedruckt wird, den Claude Code auf der Maschine des Benutzers ausführt. Erfordert Claude Code v2.1.229 oder später |

161 161

258 258

259Eine `npm`-Quelle nimmt diese Felder:259Eine `npm`-Quelle nimmt diese Felder:

260 260

261* `package`: ein Paketname oder ein scoped Name wie `@your-org/formatter`261* `package`: ein Registry-Paketname wie `@your-org/formatter`, ein Name mit angehängter Version wie `@your-org/formatter@2.0.0` oder ein `https`-Link zur Tarball-Datei des Pakets

262* `version`: eine Version oder ein Bereich262* `version`: eine Version, ein Semver-Bereich oder ein Dist-Tag, verwendet, wenn `package` ein Paketname ohne angehängte Version ist. Lassen Sie es weg, um `latest` abzurufen

263* `registry`: eine Registry-URL für ein Paket, das nicht in der Standard-Registry ist263* `registry`: eine Registry-URL für ein Paket, das nicht in der Standard-Registry ist

264 264

265Claude Code ruft das Paket mit Ihrem npm-Client ab. Die Installationsskripte des Pakets, wie `preinstall` oder `postinstall`, werden nie ausgeführt, und seine Abhängigkeiten werden während des Abrufs nicht installiert. Wenn das Paket eine unterstützte Lockdatei neben seiner `package.json` hat, installiert Claude Code diese [Node.js-Paketabhängigkeiten](/docs/de/plugins/loading#node-js-package-dependencies) in einem separaten Schritt, auch mit deaktivierten Skripten.265Claude Code ruft das Paket mit Ihrem npm-Client ab. Die Installationsskripte des Pakets, wie `preinstall` oder `postinstall`, werden nie ausgeführt, und seine Abhängigkeiten werden während des Abrufs nicht installiert. Wenn das Paket eine unterstützte Lockdatei neben seiner `package.json` hat, installiert Claude Code diese [Node.js-Paketabhängigkeiten](/docs/de/plugins/loading#node-js-package-dependencies) in einem separaten Schritt, auch mit deaktivierten Skripten.

266 266

267Claude Code prüft den `package`-Wert, bevor etwas abgerufen wird. Ein abgelehnter Wert lässt die Installation mit einer Meldung fehlschlagen, die den Wert und den Grund nennt. Zu den abgelehnten Werten gehören:

268

269* **Eine Git-Adresse, ein Ordner- oder `file:`-Pfad oder ein `npm:`-Alias**: Verwenden Sie eine [`github`-, `url`- oder `git-subdir`-Quelle](#plugin-sources) für ein Git-Repository, einen relativen Pfad für einen Ordner im Marketplace und den eigenen Namen des Pakets für einen Alias

270* **Ein Tarball-Link auf github.com, gist.github.com, gitlab.com, bitbucket.org oder git.sr.ht**: wird auch dann abgelehnt, wenn der Link ein GitHub-Release-Download ist, es sei denn, es handelt sich um einen GitLab-npm-Registry-Link unter `gitlab.com/api/v4/`

271* **Ein Tarball-Link über `http`**: wird abgelehnt, es sei denn, er verweist auf die eigene Standard-npm-Registry des installierenden Benutzers

272

273Die `registry`-URL muss `https` verwenden, es sei denn, es handelt sich um die eigene Standard-npm-Registry des installierenden Benutzers. Bei jeder anderen `http`-Registry schlägt die Installation fehl, bevor npm sie kontaktiert.

274

267```json theme={null}275```json theme={null}

268{276{

269 "name": "formatter",277 "name": "formatter",

plugins/mods/admin.md +51 −0

Details

167 167

168Ein Benutzer, dessen Mod nicht geladen wurde, findet den Grund in seinem Debug-Protokoll. [Verweigerungsmeldungen](/docs/de/plugins/mods/troubleshoot#refusal-messages) listet die Zeilen für `allowManagedHooksOnly` und `disableAllHooks` auf, und [Meldungen vom integrierten Guard](/docs/de/plugins/mods/troubleshoot#messages-from-the-built-in-guard) hat die Zeile für `allowManagedModsOnly`.168Ein Benutzer, dessen Mod nicht geladen wurde, findet den Grund in seinem Debug-Protokoll. [Verweigerungsmeldungen](/docs/de/plugins/mods/troubleshoot#refusal-messages) listet die Zeilen für `allowManagedHooksOnly` und `disableAllHooks` auf, und [Meldungen vom integrierten Guard](/docs/de/plugins/mods/troubleshoot#messages-from-the-built-in-guard) hat die Zeile für `allowManagedModsOnly`.

169 169

170<h3 id="allow-only-your-organization’s-mods">

171 Nur die Mods Ihrer Organisation zulassen

172</h3>

173

174Um die Mods Ihrer Organisation auszuführen und die Mods zu blockieren, die Benutzer mitbringen, stellen Sie die Einstellungen aus der Zeile **Nur die Mods Ihrer Organisation** der [Richtlinientabelle](#choose-how-much-to-allow) sowie `disableSideloadFlags` bereit. Mit dieser vollständigen `managed-settings.json` lehnt Claude Code die eigenen Mods von Benutzern ab, sodass keiner ihrer Hooks ausgeführt wird, und Ihr Richtlinien-Mod wird vor anderen Mods ausgeführt:

175

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

177{

178 "extraKnownMarketplaces": {

179 "acme-tools": {

180 "source": { "source": "directory", "path": "/opt/acme/claude-plugins" }

181 }

182 },

183 "enabledPlugins": { "acme-guard@acme-tools": true },

184 "prependPlugins": ["acme-guard@acme-tools", "sec-default@builtin"],

185 "pluginConfigs": {

186 "cc-plugin-sec-default@builtin": {

187 "options": { "allowManagedModsOnly": true }

188 }

189 },

190 "disableSideloadFlags": true

191}

192```

193

194Jede Gruppe von Schlüsseln erfüllt eine Aufgabe:

195

196* **`extraKnownMarketplaces`, `enabledPlugins` und `prependPlugins`**: installieren Ihren Mod so, dass er als Ihrer zählt, und führen ihn zuerst aus, mit dem Guard danach. [Installieren Sie die Mods Ihrer Organisation und legen Sie die Reihenfolge fest](#install-your-organizations-mods) behandelt das Verzeichnis, auf das diese Schlüssel verweisen.

197* **`pluginConfigs`**: setzt die Option `allowManagedModsOnly` des Guards, sodass Claude Code die eigenen Mods von Benutzern ablehnt. Ihre Einstellungs-Hooks, Statuszeilen und `/goal` funktionieren weiterhin.

198* **`disableSideloadFlags`**: siehe [`disableSideloadFlags`](/docs/de/settings-reference#disablesideloadflags) für die Flags, die es beim Start ablehnt

199

200Um die Richtlinie auf einem Testrechner zu bestätigen, starten Sie in Ihrer Shell eine Sitzung mit `claude --debug` und lesen Sie das Debug-Log:

201

202* **Ihr Mod**: Seine Zeile `hooks module` enthält `tier prepend`

203* **Ein Mod, den der Benutzer installiert hat**: Eine Zeile lautet `refused by cc-plugin-sec-default: mods are limited to your organization's by policy (allowManagedModsOnly)`. Eine frühere Zeile besagt, dass das Hooks-Modul dieses Mods `loaded` ist, suchen Sie also nach der Ablehnung.

204* **Ein Plugin-Verzeichnis**: `claude --plugin-dir ./any-mod` wird mit einer Meldung beendet, die mit `--plugin-dir is disabled by your organization's managed settings (disableSideloadFlags)` beginnt

205

206Um außerdem einzuschränken, welche Marketplaces Benutzer hinzufügen können, kombinieren Sie diese Datei mit Ihren [Marketplace-Einschränkungen](/docs/de/plugins/org#restrict-what-users-can-install).

207

208<h3 id="apply-your-plugin-controls-to-mods">

209 Wenden Sie Ihre Plugin-Steuerungen auf Mods an

210</h3>

211

212Ein Mod ist ein Plugin, daher gelten die Möglichkeiten, mit denen Sie [Plugins für Ihre Organisation verwalten](/docs/de/plugins/org), auch für ein Plugin, das einen Mod enthält:

213

214* **Sehen, welche Plugins in Ihrer gesamten Flotte geladen werden**: [Prüfen und überprüfen](/docs/de/plugins/org#audit-and-review)

215* **Entscheiden, wann ein von Ihnen überprüftes Plugin aktualisiert werden kann**: [Update-Richtlinie festlegen](/docs/de/plugins/org#set-update-policy)

216* **Einer Gruppe eine andere Richtlinie geben, z. B. für ein Pilotprojekt**: [Planen Sie für das, was verwaltete Einstellungen nicht durchsetzen können](/docs/de/plugins/org#plan-for-what-managed-settings-can’t-enforce)

217* **Prüfen, welche Apps und Sitzungsarten die Plugin-Schlüssel anwenden**: [Wann jede Oberfläche die Plugin-Schlüssel anwendet](/docs/de/plugins/org#when-each-surface-applies-the-plugin-keys)

218* **CI und Container einrichten**: [Container und CI vorbefüllen](/docs/de/plugins/org#seed-containers-and-ci)

219* **Mods anbieten, die Ihre Benutzer installieren dürfen**: [Einen Marketplace hosten](/docs/de/plugins/host-marketplace). Ein Mod, den Claude Code aus einer GitHub-, git-, URL- oder npm-Quelle kopiert, zählt als Mod eines Benutzers, nicht als [Mod Ihrer Organisation](#install-your-organizations-mods).

220

170<h3 id="set-options-on-the-built-in-guard">221<h3 id="set-options-on-the-built-in-guard">

171 Setzen Sie Optionen auf dem integrierten Guard222 Setzen Sie Optionen auf dem integrierten Guard

172</h3>223</h3>

plugins/mods/events.md +28 −1

Details

190 190

191Halten Sie das Warten in einem Mods-API-Aufruf wie `$.ui.ask`, da diese Zeit nicht gegen das [10-Sekunden-Zeitlimit](/docs/de/plugins/mods/reference#limits) des Hooks zählt. Zeit, die mit dem Warten auf ein eigenes Promise verbracht wird, zählt. Claude Code überspringt einen Hook, der das Zeitlimit überschreitet, daher würde der gehaltene Befehl ausgeführt.191Halten Sie das Warten in einem Mods-API-Aufruf wie `$.ui.ask`, da diese Zeit nicht gegen das [10-Sekunden-Zeitlimit](/docs/de/plugins/mods/reference#limits) des Hooks zählt. Zeit, die mit dem Warten auf ein eigenes Promise verbracht wird, zählt. Claude Code überspringt einen Hook, der das Zeitlimit überschreitet, daher würde der gehaltene Befehl ausgeführt.

192 192

193<h4 id="approve-or-refuse-a-tool-call-before-the-user-is-asked">

194 Genehmigen oder lehnen Sie einen Tool-Aufruf ab, bevor der Benutzer gefragt wird

195</h4>

196

197Um zu entscheiden, ob ein Tool-Aufruf ausgeführt werden darf, behandeln Sie [`tool.check`](/docs/de/plugins/mods/reference#tools), das Ereignis, bei dem Claude Code diese Entscheidung trifft. Es wird ausgelöst, nachdem die Berechtigungsregeln und die Settings-Hooks entschieden haben, und `next(e)` wird zu ihrer Entscheidung aufgelöst: `allow`, `ask` oder `deny`. Ihr Hook gibt diese Entscheidung oder eine andere zurück. `e.input` enthält die Argumente des Tools, z. B. `command` für Bash.

198

199Für einen festen Befehl oder Pfad verwenden Sie eine [Berechtigungsregel](/docs/de/permissions#permission-rule-syntax) wie `Bash(npm test)`, die keinen Code erfordert. Behandeln Sie `tool.check`, wenn die Entscheidung davon abhängt, was in diesem Moment zutrifft, z. B. vom aktuellen Git-Branch oder von einem Wert, den ein anderer Hook aufgezeichnet hat.

200

201Dieser Hook lehnt `git push` ab, solange der aktuelle Branch `main` ist:

202

203```javascript theme={null}

204on('tool.check', { tool: 'Bash' }, async ($, e, next) => {

205 // Was die Berechtigungsregeln und Settings-Hooks entschieden haben: 'allow', 'ask' oder 'deny'

206 const decided = await next(e)

207 if (!e.input.command.includes('git push')) return decided

208 const branch = await $.process.run(['git', 'branch', '--show-current'])

209 if (branch.stdout.trim() !== 'main') return decided

210 return { decision: 'deny', reason: 'Push from a branch other than main' }

211})

212```

213

214Auf `main` gibt der Hook `deny` zurück, selbst wenn eine Regel `git push` erlaubt. Auf einem anderen Branch und für andere Befehle erhält der Aufruf die Entscheidung, die er ohne den Mod erhalten würde.

215

216Der Hook gleicht den Text des Befehls ab, betrachten Sie ihn daher als Erinnerung für Claude. Um Pushes auf `main` für alle zu blockieren, schützen Sie den Branch auf Ihrem Git-Host.

217

218Ein Hook kann jede der drei Entscheidungen zurückgeben, daher kann er auch einen Aufruf genehmigen, den ein `PreToolUse`-Hook außerhalb der verwalteten Einstellungen blockiert hat. [Berechtigungen mit Hooks erweitern](/docs/de/permissions#extend-permissions-with-hooks) listet auf, welche Entscheidungen gegenüber einem Mod Bestand haben.

219

193<h3 id="rewrite-or-add-to-a-prompt">220<h3 id="rewrite-or-add-to-a-prompt">

194 Schreiben Sie eine Eingabeaufforderung um oder fügen Sie sie hinzu221 Schreiben Sie eine Eingabeaufforderung um oder fügen Sie sie hinzu

195</h3>222</h3>

301* **`PreToolUse`-Hooks aus verwalteten Einstellungen**: werden vor dem Hook `tool.call` des ersten Mods ausgeführt, und ein Block von einem von ihnen ist endgültig, daher sieht kein Mod den Aufruf.328* **`PreToolUse`-Hooks aus verwalteten Einstellungen**: werden vor dem Hook `tool.call` des ersten Mods ausgeführt, und ein Block von einem von ihnen ist endgültig, daher sieht kein Mod den Aufruf.

302* **`PreToolUse`-Hooks aus jeder anderen Einstellungsdatei und aus `hooks/hooks.json` von Plugins**: werden nach dem letzten Aufruf von `next` eines Mods ausgeführt, als Teil von Claude Codes eigenem Verhalten. Ein Mod, der `tool.call` beantwortet, ohne `next` aufzurufen, hindert sie daran, ausgeführt zu werden, und ein Mod, der `next` aufruft, sieht ihre Entscheidung im Ergebnis, das er zurückgibt.329* **`PreToolUse`-Hooks aus jeder anderen Einstellungsdatei und aus `hooks/hooks.json` von Plugins**: werden nach dem letzten Aufruf von `next` eines Mods ausgeführt, als Teil von Claude Codes eigenem Verhalten. Ein Mod, der `tool.call` beantwortet, ohne `next` aufzurufen, hindert sie daran, ausgeführt zu werden, und ein Mod, der `next` aufruft, sieht ihre Entscheidung im Ergebnis, das er zurückgibt.

303 330

304[`tool.check`](/docs/de/plugins/mods/reference#tools) ist das Ereignis, bei dem Claude Code entscheidet, ob ein Tool-Aufruf ausgeführt werden darf. Es wird nach diesen Hooks und den Berechtigungsregeln ausgelöst, und `next(e)` wird zu ihrer Entscheidung aufgelöst. Ein Hook auf `tool.check` kann eine andere Entscheidung zurückgeben, z. B. `{ decision: 'allow' }`, daher kann er einen Aufruf genehmigen, den ein Hook in der zweiten Gruppe blockiert hat. [Erweitern Sie Berechtigungen mit Hooks](/docs/de/permissions#extend-permissions-with-hooks) listet auf, welche Entscheidungen einen Mod überlagern.331[`tool.check`](#approve-or-refuse-a-tool-call-before-the-user-is-asked) wird ausgelöst, nachdem diese Hooks und die Berechtigungsregeln entschieden haben, daher kann ein Hook darauf einen Aufruf genehmigen, den ein Hook in der zweiten Gruppe blockiert hat.

305 332

306<h3 id="handle-a-hook-that-fails">333<h3 id="handle-a-hook-that-fails">

307 Behandeln Sie einen Hook, der fehlschlägt334 Behandeln Sie einen Hook, der fehlschlägt

plugins/mods/interface.md +2 −2

Details

407 ```407 ```

408 408

409 ```text theme={null}409 ```text theme={null}

410 Note: Type a note and press Enter ⏎ add410 Note: Type a note and press Enter

411 ```411 ```

412 </Tab>412 </Tab>

413</Tabs>413</Tabs>

414 414

415Diese Tabelle listet jedes Element auf:415Die [Oberflächengalerie](/docs/de/plugins/mods/gallery) enthält Beispiele und Screenshots der meisten Elemente. Diese Tabelle listet jedes Element auf:

416 416

417| Element | Was es zeichnet | Wo |417| Element | Was es zeichnet | Wo |

418| :- | :- | :- |418| :- | :- | :- |

plugins/mods/overview.md +4 −0

Details

72* **Ohne Sie zu fragen handeln**: Genehmigen Sie einen Tool-Call, bevor Sie gefragt werden72* **Ohne Sie zu fragen handeln**: Genehmigen Sie einen Tool-Call, bevor Sie gefragt werden

73* **Ihre Nutzung ausgeben**: Rufen Sie ein Modell in Ihrem Plan oder API-Schlüssel auf73* **Ihre Nutzung ausgeben**: Rufen Sie ein Modell in Ihrem Plan oder API-Schlüssel auf

74 74

75Mods werden nicht in einer Sandbox ausgeführt. Wenn Sie [Sandboxing](/docs/de/sandboxing) aktivieren, isoliert die Sandbox die Bash-Befehle, die Claude ausführt, und ein Prozess, den ein Mod startet, läuft außerhalb davon.

75Ein Mod, der Tool-Calls genehmigt, kann einen genehmigen, für den eine `ask`-Regel Sie auffordert, oder den einer Ihrer eigenen `PreToolUse`-Hooks blockiert hat. [Berechtigungen mit Hooks erweitern](/docs/de/permissions#extend-permissions-with-hooks) listet auf, was ein solcher Mod genehmigen kann, einschließlich wann er einen Anruf genehmigen kann, den eine `deny`-Regel ablehnt.77Ein Mod, der Tool-Calls genehmigt, kann einen genehmigen, für den eine `ask`-Regel Sie auffordert, oder den einer Ihrer eigenen `PreToolUse`-Hooks blockiert hat. [Berechtigungen mit Hooks erweitern](/docs/de/permissions#extend-permissions-with-hooks) listet auf, was ein solcher Mod genehmigen kann, einschließlich wann er einen Anruf genehmigen kann, den eine `deny`-Regel ablehnt.

76 78

77Ein Mod kann einen Großteil der Claude Code-Benutzeroberfläche umgestalten, aber nicht die Berechtigungsaufforderung. Es kann nicht ändern, was eine Eingabeaufforderung Ihnen zeigt.79Ein Mod kann einen Großteil der Claude Code-Benutzeroberfläche umgestalten, aber nicht die Berechtigungsaufforderung. Es kann nicht ändern, was eine Eingabeaufforderung Ihnen zeigt.

102 104

103Wenn Sie Claude Code über eine Organisation nutzen, kann ein Administrator auch einschränken, welche Mods geladen werden. Administratoren beginnen bei [Stop user-installed mods from loading](/docs/de/plugins/mods/admin#stop-user-installed-mods-from-loading).105Wenn Sie Claude Code über eine Organisation nutzen, kann ein Administrator auch einschränken, welche Mods geladen werden. Administratoren beginnen bei [Stop user-installed mods from loading](/docs/de/plugins/mods/admin#stop-user-installed-mods-from-loading).

104 106

107`disableAllHooks` und das `allowManagedModsOnly` Ihrer Organisation stoppen einen Mod und lassen den Rest seines Plugins bestehen: Das Plugin bleibt installiert, und seine Skills, Befehle, Agenten und MCP-Server werden geladen. Andere Einstellungen und Flags reichen weiter. [`disableAllHooks`](/docs/de/settings-reference#disableallhooks) und [What runs under `allowManagedHooksOnly`](/docs/de/settings-reference#what-runs-under-allowmanagedhooksonly) listen auf, was jede davon mit einem Plugin und seinen Einstellungs-Hooks macht.

108

105Um herauszufinden, ob Mods für Sie geladen werden können, siehe [Check whether mods can load](/docs/de/plugins/mods/troubleshoot#check-whether-mods-can-load).109Um herauszufinden, ob Mods für Sie geladen werden können, siehe [Check whether mods can load](/docs/de/plugins/mods/troubleshoot#check-whether-mods-can-load).

106 110

107<Note>111<Note>

plugins/mods/troubleshoot.md +2 −0

Details

56 56

57Lesen Sie den Grund nach dem Doppelpunkt. Der Abschnitt [Ablehnungsmeldungen](#refusal-messages) listet jeden auf. Wenn das Protokoll keine solche Zeile hat, arbeiten Sie die anderen Einträge in dieser Gruppe durch.57Lesen Sie den Grund nach dem Doppelpunkt. Der Abschnitt [Ablehnungsmeldungen](#refusal-messages) listet jeden auf. Wenn das Protokoll keine solche Zeile hat, arbeiten Sie die anderen Einträge in dieser Gruppe durch.

58 58

59Einige Einstellungen stoppen einen Mod und lassen den Rest seines Plugins weiter funktionieren. [Mods ein- oder ausschalten](/docs/de/plugins/mods/overview#turn-mods-on-or-off) nennt sie.

59<h3 id="a-claude-p-run-prints-hooks-module-not-loaded">61<h3 id="a-claude-p-run-prints-hooks-module-not-loaded">

60 Ein `claude -p` Lauf gibt `hooks module not loaded` aus62 Ein `claude -p` Lauf gibt `hooks module not loaded` aus

61</h3>63</h3>

plugins/security.md +1 −1

Details

37 37

38Claude Codes [Berechtigungsregeln](/docs/de/permissions) und [Sandbox](/docs/de/sandboxing) decken die Tool-Aufrufe ab, die Claude macht, nicht den Code, den ein Plugin selbst ausführt:38Claude Codes [Berechtigungsregeln](/docs/de/permissions) und [Sandbox](/docs/de/sandboxing) decken die Tool-Aufrufe ab, die Claude macht, nicht den Code, den ein Plugin selbst ausführt:

39 39

~~40* **Hooks und Server-Prozesse**: Befehls-Hooks führen Shell-Befehle mit Ihren vollständigen Benutzerberechtigungen aus. Claude Code führt Hooks und MCP-Server außerhalb der Sandbox aus.~~40* **Hooks und Server-Prozesse**: Befehls-Hooks führen Shell-Befehle mit Ihren vollständigen Benutzerberechtigungen aus. Claude Code führt Hooks, MCP-Server und die Prozesse, die ein [Mod](/docs/de/plugins/mods/overview#what-a-mod-can-reach) startet, außerhalb der Sandbox aus.

41* **Claudes Tool-Aufrufe**: ein Aufruf eines der MCP-Tools des Plugins und ein Bash-Befehl, der eine ausführbare Datei aus dem `bin/`-Verzeichnis des Plugins ausführt, sind Tool-Aufrufe, daher gelten Ihre Berechtigungsregeln für sie. Für das, was ein Mod mit einem Tool-Aufruf tun kann, siehe [Entscheiden Sie, ob Sie einem Mod vertrauen](/docs/de/plugins/mods/overview#decide-whether-to-trust-a-mod).41* **Claudes Tool-Aufrufe**: ein Aufruf eines der MCP-Tools des Plugins und ein Bash-Befehl, der eine ausführbare Datei aus dem `bin/`-Verzeichnis des Plugins ausführt, sind Tool-Aufrufe, daher gelten Ihre Berechtigungsregeln für sie. Für das, was ein Mod mit einem Tool-Aufruf tun kann, siehe [Entscheiden Sie, ob Sie einem Mod vertrauen](/docs/de/plugins/mods/overview#decide-whether-to-trust-a-mod).

42 42

43Die Installation eines Plugins aktiviert es auch, es sei denn, sein Manifest oder der Marketplace-Eintrag setzt [`defaultEnabled: false`](/docs/de/plugins/install#choose-an-install-scope) und Sie haben es nicht selbst aktiviert.43Die Installation eines Plugins aktiviert es auch, es sei denn, sein Manifest oder der Marketplace-Eintrag setzt [`defaultEnabled: false`](/docs/de/plugins/install#choose-an-install-scope) und Sie haben es nicht selbst aktiviert.

plugins/troubleshooting.md +15 −0

Details

460* **Sie veröffentlichen das Plugin**: berechnen Sie den Digest der genauen Datei, die die URL bereitstellt, neu und aktualisieren Sie den `sha256` im Marktplatz-Eintrag. Verwenden Sie `shasum -a 256 my-plugin.zip` oder `Get-FileHash -Algorithm SHA256 my-plugin.zip` in PowerShell460* **Sie veröffentlichen das Plugin**: berechnen Sie den Digest der genauen Datei, die die URL bereitstellt, neu und aktualisieren Sie den `sha256` im Marktplatz-Eintrag. Verwenden Sie `shasum -a 256 my-plugin.zip` oder `Get-FileHash -Algorithm SHA256 my-plugin.zip` in PowerShell

461* **Sie installieren das Plugin**: führen Sie `/plugin marketplace update <name>` in einer Sitzung aus, um den Katalog zu aktualisieren, falls der Eintrag korrigiert wurde, und versuchen Sie dann die Installation erneut. Wenn die Digests nach der Aktualisierung immer noch nicht übereinstimmen, fragen Sie den Marktplatz-Besitzer, welche Datei er vor der Installation gepinnt hat461* **Sie installieren das Plugin**: führen Sie `/plugin marketplace update <name>` in einer Sitzung aus, um den Katalog zu aktualisieren, falls der Eintrag korrigiert wurde, und versuchen Sie dann die Installation erneut. Wenn die Digests nach der Aktualisierung immer noch nicht übereinstimmen, fragen Sie den Marktplatz-Besitzer, welche Datei er vor der Installation gepinnt hat

462 462

463<h3 id="an-npm-plugin-source-must-name-a-registry-package">

464 `An npm plugin source must name a registry package`

465</h3>

466

467Ein Plugin, dessen Marktplatz-Eintrag eine [`npm`-Quelle](/docs/de/plugins/marketplace-reference#npm-plugin-source) verwendet, konnte nicht installiert, aktualisiert oder geladen werden, und die Meldung enthält diesen Satz. Claude Code hat den `package`-Wert des Eintrags geprüft, bevor etwas abgerufen wurde, und ihn abgelehnt. Die Meldung nennt den Wert und den Grund:

468

469```text theme={null}

470"github:acme/formatter" was not installed: it is not an http or https link. An npm plugin source must name a registry package (name or name@version) or link to a tarball file. For a plugin in a git repository, use a "github", "url" or "git-subdir" source.

471```

472

473Der Besitzer des Marktplatzes muss den Eintrag ändern:

474

475* **Wenn das Sie sind**: ändern Sie `package` in einen Wert, den die [Referenz zur npm-Plugin-Quelle](/docs/de/plugins/marketplace-reference#npm-plugin-source) akzeptiert, oder stellen Sie den Eintrag auf eine `github`-, `url`- oder `git-subdir`-Quelle um

476* **Wenn das nicht Sie sind**: melden Sie die Meldung dem Marktplatz-Besitzer

477

463<h3 id="marketplace-is-registered-from-an-untrusted-source">478<h3 id="marketplace-is-registered-from-an-untrusted-source">

464 `Marketplace "<name>" is registered from an untrusted source`479 `Marketplace "<name>" is registered from an untrusted source`

465</h3>480</h3>

remote-control.md +1 −1

Details

220 220

221Diese Befehle funktionieren etwa vier Stunden, nachdem der Server gestoppt wurde. Danach führen Sie `claude remote-control` aus, um eine neue Sitzung zu starten. Wenn Sie eine Sitzung in der Zwischenzeit archiviert haben, entarchivieren `--continue` und `--session-id` sie auf Claude Code v2.1.228 oder später.221Diese Befehle funktionieren etwa vier Stunden, nachdem der Server gestoppt wurde. Danach führen Sie `claude remote-control` aus, um eine neue Sitzung zu starten. Wenn Sie eine Sitzung in der Zwischenzeit archiviert haben, entarchivieren `--continue` und `--session-id` sie auf Claude Code v2.1.228 oder später.

222 222

223Um eine Sitzung zurückzubringen, die Sie mit `claude --remote-control` oder `/remote-control` gestartet haben, setzen Sie das Gespräch mit `claude --continue` oder `claude --resume` fort. Wenn Remote Control nicht erneut verbunden wird, siehe [Konnte nicht erneut mit Ihrer Remote Control-Sitzung verbunden werden](#couldnt-reconnect-to-your-remote-control-session).223Um eine Sitzung zurückzubringen, die Sie mit `claude --remote-control` oder `/remote-control` gestartet haben, setzen Sie die Konversation mit `claude --continue` oder `claude --resume` fort. Informationen zum Berechtigungsmodus, in dem die fortgesetzte Konversation startet, finden Sie unter [Berechtigungsmodus beim Fortsetzen](/docs/de/sessions#permission-mode-on-resume). Wenn Remote Control nicht erneut verbunden wird, siehe [Konnte nicht erneut mit Ihrer Remote-Control-Sitzung verbunden werden](#couldnt-reconnect-to-your-remote-control-session).

224 224

225Wenn Sie das Gespräch in einem zweiten Terminal fortsetzen, während das erste noch Remote Control aktiviert hat, druckt Claude Code eine `Remote Control not started here`-Benachrichtigung im zweiten Terminal und lässt Remote Control dort stattdessen aus, anstatt die Sitzung vom ersten zu nehmen. Führen Sie `/remote-control` im zweiten Terminal aus, um Remote Control dorthin zu verschieben.225Wenn Sie das Gespräch in einem zweiten Terminal fortsetzen, während das erste noch Remote Control aktiviert hat, druckt Claude Code eine `Remote Control not started here`-Benachrichtigung im zweiten Terminal und lässt Remote Control dort stattdessen aus, anstatt die Sitzung vom ersten zu nehmen. Führen Sie `/remote-control` im zweiten Terminal aus, um Remote Control dorthin zu verschieben.

226 226

sandbox-environments.md +3 −1

Details

107 107

108* Ihr Projektverzeichnis.108* Ihr Projektverzeichnis.

109* Claude Codes Konfigurationspfade `~/.claude` und `~/.claude.json`.109* Claude Codes Konfigurationspfade `~/.claude` und `~/.claude.json`.

110* `/tmp`, wo Claude Code Runtime-Dateien schreibt.110* Das Verzeichnis, in das Claude Code Runtime-Dateien schreibt. Sofern Sie nicht [`CLAUDE_CODE_TMPDIR`](/docs/de/env-vars) setzen, ist dieses Verzeichnis:

111 * **Linux und WSL2**: `/tmp`

112 * **macOS**: `/private/tmp`. `/tmp` ist ein Symlink auf dieses Verzeichnis, und Seatbelt prüft den aufgelösten Pfad.

111 113

112Erlauben Sie die Netzwerk-Domains, die Ihre Sitzung benötigt:114Erlauben Sie die Netzwerk-Domains, die Ihre Sitzung benötigt:

113 115

sandboxing.md +5 −4

Details

776* **Netzwerk-Filterung**: Die Sandbox schränkt ein, mit welchen Domains Prozesse sich verbinden können. Standardmäßig beendet oder inspiziert der integrierte Proxy TLS auf ausgehenden Datenverkehr nicht, daher werden die Inhalte verschlüsselter Verbindungen nicht untersucht. Die experimentelle Einstellung [`network.tlsTerminate`](/docs/de/settings-reference#sandbox-network-tlsterminate) beendet TLS am Proxy für [`mask`-Anmeldedaten-Substitution](#mask-credentials), fügt aber keine Inhaltsfilterung hinzu. Sie sind verantwortlich dafür, dass nur vertrauenswürdige Domains in Ihrer Richtlinie zulässig sind.776* **Netzwerk-Filterung**: Die Sandbox schränkt ein, mit welchen Domains Prozesse sich verbinden können. Standardmäßig beendet oder inspiziert der integrierte Proxy TLS auf ausgehenden Datenverkehr nicht, daher werden die Inhalte verschlüsselter Verbindungen nicht untersucht. Die experimentelle Einstellung [`network.tlsTerminate`](/docs/de/settings-reference#sandbox-network-tlsterminate) beendet TLS am Proxy für [`mask`-Anmeldedaten-Substitution](#mask-credentials), fügt aber keine Inhaltsfilterung hinzu. Sie sind verantwortlich dafür, dass nur vertrauenswürdige Domains in Ihrer Richtlinie zulässig sind.

777 777

778<Warning>778<Warning>

779 Das Zulassen breiter Domains wie `github.com` kann Pfade für Datenexfiltration schaffen. Da der Proxy seine Zulassungsentscheidung vom Client-bereitgestellten Hostnamen trifft, ohne TLS zu inspizieren, kann Code, der in der Sandbox ausgeführt wird, möglicherweise [Domain Fronting](https://en.wikipedia.org/wiki/Domain_fronting) oder ähnliche Techniken verwenden, um Hosts außerhalb der Zulassungsliste zu erreichen. Wenn Ihr Bedrohungsmodell stärkere Garantien erfordert, konfigurieren Sie einen [benutzerdefinierten Proxy](#custom-proxy-configuration), der TLS beendet und Datenverkehr inspiziert, und installieren Sie sein CA-Zertifikat in der Sandbox. Stärkere TLS-bewusste Netzwerk-Isolation ist ein aktives Entwicklungsgebiet.779 Das Zulassen breiter Domains wie `github.com` kann Pfade für Datenexfiltration schaffen. Da der Proxy seine Zulassungsentscheidung vom Client-bereitgestellten Hostnamen trifft, ohne TLS zu inspizieren, kann Code, der in der Sandbox ausgeführt wird, möglicherweise [Domain Fronting](https://en.wikipedia.org/wiki/Domain_fronting) oder ähnliche Techniken verwenden, um Hosts außerhalb der Allowlist zu erreichen. Wenn Ihr Bedrohungsmodell stärkere Garantien erfordert, konfigurieren Sie einen [benutzerdefinierten Proxy](#custom-proxy-configuration), der TLS beendet und Datenverkehr inspiziert, und installieren Sie sein CA-Zertifikat in der Sandbox. Stärkere TLS-bewusste Netzwerk-Isolation ist ein aktives Entwicklungsgebiet.

780</Warning>780</Warning>

781 781

782* **Privilege Escalation über Unix-Sockets**: Die Konfiguration `allowUnixSockets` kann versehentlich Zugriff auf System-Services gewähren, die zu Sandbox-Umgehungen führen könnten. Wenn Sie beispielsweise Zugriff auf `/var/run/docker.sock` zulassen, würde dies effektiv Zugriff auf das Host-System durch den Docker-Socket gewähren. Überdenken Sie sorgfältig alle Unix-Sockets, die Sie durch die Sandbox zulassen.782* **Privilege Escalation über Unix-Sockets**: Die Konfiguration `allowUnixSockets` kann versehentlich Zugriff auf System-Services gewähren, die zu Sandbox-Umgehungen führen könnten. Wenn Sie beispielsweise Zugriff auf `/var/run/docker.sock` zulassen, würde dies effektiv Zugriff auf das Host-System durch den Docker-Socket gewähren. Überdenken Sie sorgfältig alle Unix-Sockets, die Sie durch die Sandbox zulassen.

783* **Dateisystem-Genehmigungseskalation**: Übermäßig breite Dateisystem-Schreibgenehmigungen können Privilege-Escalation-Angriffe ermöglichen. Das Zulassen von Schreibvorgängen zu Verzeichnissen, die ausführbare Dateien in `$PATH`, System-Konfigurationsverzeichnisse oder Benutzer-Shell-Konfigurationsdateien wie `.bashrc` oder `.zshrc` enthalten, kann zu Code-Ausführung in verschiedenen Sicherheitskontexten führen, wenn andere Benutzer oder System-Prozesse auf diese Dateien zugreifen.783* **Dateisystem-Berechtigungseskalation**: Übermäßig breite Dateisystem-Schreibberechtigungen können Privilege-Escalation-Angriffe ermöglichen. Das Zulassen von Schreibvorgängen zu Verzeichnissen, die ausführbare Dateien in `$PATH`, System-Konfigurationsverzeichnisse oder Benutzer-Shell-Konfigurationsdateien wie `.bashrc` oder `.zshrc` enthalten, kann zu Code-Ausführung in verschiedenen Sicherheitskontexten führen, wenn andere Benutzer oder System-Prozesse auf diese Dateien zugreifen.

784* **Linux-Sandbox-Stärke**: Die Linux-Implementierung bietet starke Dateisystem- und Netzwerk-Isolation, enthält aber einen `enableWeakerNestedSandbox`-Modus, der es ermöglicht, in Docker-Umgebungen ohne privilegierte Namespaces zu funktionieren, oder auf Linux-Hosts, wo unprivilegierte Benutzer-Namespaces durch sysctl deaktiviert sind. Diese Option schwächt die Sicherheit erheblich ab und sollte nur verwendet werden, wenn zusätzliche Isolation anderweitig durchgesetzt wird.784* **Linux-Sandbox-Stärke**: Die Linux-Implementierung bietet starke Dateisystem- und Netzwerk-Isolation, enthält aber einen `enableWeakerNestedSandbox`-Modus, der es ermöglicht, in Docker-Umgebungen ohne privilegierte Namespaces zu funktionieren, oder auf Linux-Hosts, wo unprivilegierte Benutzer-Namespaces durch sysctl deaktiviert sind. Diese Option schwächt die Sicherheit erheblich ab und sollte nur verwendet werden, wenn zusätzliche Isolation anderweitig durchgesetzt wird.

785* **Apple Events auf macOS**: Die macOS-Sandbox blockiert Apple Events standardmäßig. Die Einstellung `allowAppleEvents` hebt diese Einschränkung auf, damit Tools wie `open` und `osascript` funktionieren, aber es entfernt Code-Ausführungs-Isolation: Sandbox-Befehle können andere Anwendungen ohne Sandbox ohne Benutzer-Eingabeaufforderung starten und können AppleScript-Befehle an laufende Anwendungen senden, vorbehaltlich der Pro-App-macOS-Automatisierungs-Zustimmungsaufforderung (TCC). Es wird nur von Benutzer-, verwalteten oder CLI-Einstellungen berücksichtigt. Projekteinstellungen können es nicht aktivieren.785* **Apple Events auf macOS**: Die macOS-Sandbox blockiert Apple Events standardmäßig. Die Einstellung `allowAppleEvents` hebt diese Einschränkung auf, damit Tools wie `open` und `osascript` funktionieren, aber es entfernt Code-Ausführungs-Isolation: Sandbox-Befehle können andere Anwendungen ohne Sandbox ohne Benutzer-Eingabeaufforderung starten und können AppleScript-Befehle an laufende Anwendungen senden, vorbehaltlich der Pro-App-macOS-Automatisierungs-Zustimmungsaufforderung (TCC). Es wird nur von Benutzer-, verwalteten oder CLI-Einstellungen berücksichtigt. Projekteinstellungen können es nicht aktivieren.

786 786

798 798

799Die Sandbox isoliert Bash-Subprozesse. Andere Tools funktionieren unter verschiedenen Grenzen:799Die Sandbox isoliert Bash-Subprozesse. Andere Tools funktionieren unter verschiedenen Grenzen:

800 800

801* **Integrierte Datei-Tools**: Read, Edit und Write verwenden das Genehmigungssystem direkt, anstatt durch die Sandbox zu laufen. Siehe [Genehmigungen](/docs/de/permissions).801* **Integrierte Datei-Tools**: Read, Edit und Write verwenden das Berechtigungssystem direkt, anstatt durch die Sandbox zu laufen. Siehe [Berechtigungen](/docs/de/permissions).

802* **Computer-Nutzung**: Wenn Claude Apps öffnet und Ihren Bildschirm steuert, läuft es auf Ihrem tatsächlichen Desktop, anstatt in einer isolierten Umgebung. Pro-App-Genehmigungseingaben kontrollieren jede Anwendung. Siehe [Computer-Nutzung in der CLI](/docs/de/computer-use) oder [Computer-Nutzung auf Desktop](/docs/de/desktop#let-claude-use-your-computer).802* **Computer-Nutzung**: Wenn Claude Apps öffnet und Ihren Bildschirm steuert, läuft es auf Ihrem tatsächlichen Desktop, anstatt in einer isolierten Umgebung. Berechtigungsabfragen pro App kontrollieren jede Anwendung. Siehe [Computer-Nutzung in der CLI](/docs/de/computer-use) oder [Computer-Nutzung auf Desktop](/docs/de/desktop#let-claude-use-your-computer).

803* **Umgebungsvariablen**: Sandbox-Bash-Befehle erben die Umgebung des übergeordneten Prozesses standardmäßig, einschließlich aller dort gesetzten Anmeldedaten. Verwenden Sie [`sandbox.credentials`](#protect-credentials), um spezifische Variablen für Sandbox-Befehle zu deaktivieren oder zu maskieren, oder setzen Sie [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/de/env-vars), um Anmeldedaten aus allen Subprozessen zu entfernen.803* **Umgebungsvariablen**: Sandbox-Bash-Befehle erben die Umgebung des übergeordneten Prozesses standardmäßig, einschließlich aller dort gesetzten Anmeldedaten. Verwenden Sie [`sandbox.credentials`](#protect-credentials), um spezifische Variablen für Sandbox-Befehle zu deaktivieren oder zu maskieren, oder setzen Sie [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/de/env-vars), um Anmeldedaten aus allen Subprozessen zu entfernen.

804* **Subagenten**: [Subagenten](/docs/de/sub-agents) laufen im gleichen Prozess wie die übergeordnete Sitzung und verwenden die gleiche Sandbox-Konfiguration. Bash-Befehle in einem Subagenten werden in der Sandbox ausgeführt, wenn Sandboxing in der übergeordneten Sitzung aktiviert ist.804* **Subagenten**: [Subagenten](/docs/de/sub-agents) laufen im gleichen Prozess wie die übergeordnete Sitzung und verwenden die gleiche Sandbox-Konfiguration. Bash-Befehle in einem Subagenten werden in der Sandbox ausgeführt, wenn Sandboxing in der übergeordneten Sitzung aktiviert ist.

805* **Mods**: Ein [Mod](/docs/de/plugins/mods/overview) ist ein Plugin, das seinen eigenen Code innerhalb von Claude Code ausführt, und ein Prozess, den ein Mod startet, läuft außerhalb der Sandbox. Siehe [Was ein Mod erreichen kann](/docs/de/plugins/mods/overview#what-a-mod-can-reach).

805 806

806<Warning>807<Warning>

807 Effektives Sandboxing erfordert sowohl Dateisystem- als auch Netzwerk-Isolation. Ohne Netzwerk-Isolation könnte ein kompromittierter Agent sensible Dateien wie SSH-Schlüssel exfiltrieren. Ohne Dateisystem-Isolation, ob durch eine permissive Richtlinie oder durch [Deaktivierung der Dateisystem-Schicht](#disable-filesystem-isolation), könnte ein kompromittierter Agent System-Ressourcen manipulieren, um Netzwerkzugriff zu erlangen. Wenn Sie die Standardwerte erweitern, überprüfen Sie, dass ein `allowWrite`-Pfad, ein breiter `allowedDomains`-Eintrag oder eine `excludedCommands`-Ausnahme keine Einschränkung auf der anderen Seite rückgängig macht.808 Effektives Sandboxing erfordert sowohl Dateisystem- als auch Netzwerk-Isolation. Ohne Netzwerk-Isolation könnte ein kompromittierter Agent sensible Dateien wie SSH-Schlüssel exfiltrieren. Ohne Dateisystem-Isolation, ob durch eine permissive Richtlinie oder durch [Deaktivierung der Dateisystem-Schicht](#disable-filesystem-isolation), könnte ein kompromittierter Agent System-Ressourcen manipulieren, um Netzwerkzugriff zu erlangen. Wenn Sie die Standardwerte erweitern, überprüfen Sie, dass ein `allowWrite`-Pfad, ein breiter `allowedDomains`-Eintrag oder eine `excludedCommands`-Ausnahme keine Einschränkung auf der anderen Seite rückgängig macht.

self-hosted-environments-configuration.md +33 −14

Details

61 61

62Schließen oder verwenden Sie Dateideskriptor 3 im Wrapper nicht erneut. Das Umleiten von stdout und stderr des Kindes ist in Ordnung.62Schließen oder verwenden Sie Dateideskriptor 3 im Wrapper nicht erneut. Das Umleiten von stdout und stderr des Kindes ist in Ordnung.

63 63

64<h3 id="pass-the-system-prompt-flags-through">

65 System-Prompt-Flags durchreichen

66</h3>

68Der System-Prompt und der angehängte System-Prompt, die die Kontrollebene von Anthropic für eine Sitzung sendet, erreichen Ihren Wrapper als Dateipfade, nicht als Inline-Text. Der Runner schreibt jeden Prompt in eine Datei im Konfigurationsverzeichnis der Sitzung, `CLAUDE_CONFIG_DIR`, und übergibt deren Pfad in den Argumenten, die Ihr Wrapper erhält, als [`--system-prompt-file <path>` oder `--append-system-prompt-file <path>`](/docs/de/cli-reference#system-prompt-flags).

70Runner ab Claude Code v2.1.281 liefern die Prompts als Dateien. Vor v2.1.281 übergab der Runner sie als `--system-prompt <text>` und `--append-system-prompt <text>`.

72Behandeln Sie diese Flags in Ihrem Wrapper-Skript oder [`command`-Hook](#command) wie folgt:

74* **Reichen Sie sie durch**: Beenden Sie den Wrapper mit `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@"`, wodurch die Datei-Flags zusammen mit allen anderen Argumenten weitergeleitet werden. Entfernen oder ändern Sie sie nicht. Wenn einer Sitzung ein Prompt-Datei-Flag verloren geht, läuft sie ohne die Anweisungen, die die Kontrollebene für sie gesendet hat.

75* **Auf einem Runner ab v2.1.281 ersetzt ein von Ihnen angehängtes Datei-Flag das des Servers, statt es zu ergänzen**: Jedes Prompt-Datei-Flag nimmt einen einzelnen Wert an, und Claude Code behält das letzte Vorkommen. Wenn Sie also `--append-system-prompt-file <path>` nach `"$@"` anhängen, ersetzt der Inhalt Ihrer Datei die angehängten Anweisungen des Servers. Um Anweisungen zusätzlich zu denen des Servers hinzuzufügen, legen Sie sie in der `CLAUDE.md` des Runner-Images ab, die der Runner [in die Konfiguration auf Benutzerebene jeder Sitzung einspielt](#how-each-session’s-config-is-assembled).

64<h3 id="provision-credentials-scoped-to-the-session-creator">77<h3 id="provision-credentials-scoped-to-the-session-creator">

65 Anmeldedaten mit Bereich auf den Sitzungsersteller bereitstellen78 Anmeldedaten mit Bereich auf den Sitzungsersteller bereitstellen

66</h3>79</h3>

416 Berechtigungen und Tool-Genehmigung429 Berechtigungen und Tool-Genehmigung

417</h2>430</h2>

418 431

419Eine selbstgehostete Sitzung hat kein angehängtes Terminal, daher stellt eine unbeantwortete Berechtigungsaufforderung die Runde stall, bis der Benutzer in der UI antwortet. Anthropics Kontrolleben sendet die Tool-Liste und Berechtigungsregeln jeder Sitzung mit der Workload; die Standardkonfiguration genehmigt Routine-Tool-Aufrufe vor, einschließlich `Bash`, und Cloud-Sitzungen [genehmigen Datei-Edits unabhängig vom Modus vor](/docs/de/permission-modes#switch-permission-modes). Ein Aufruf, den nichts genehmigt, fordert durch die Sitzungs-UI auf.432Eine selbstgehostete Sitzung hat kein angeschlossenes Terminal, daher blockiert eine unbeantwortete Berechtigungsabfrage den Turn, bis der Benutzer in der UI antwortet. Die Steuerungsebene von Anthropic sendet die Tool-Liste und die Berechtigungsregeln jeder Sitzung mit der Arbeits-Payload; die Standardkonfiguration genehmigt alltägliche Tool-Aufrufe vorab, einschließlich `Bash`, und Cloud-Sitzungen [genehmigen Dateibearbeitungen unabhängig vom Modus vorab](/docs/de/permission-modes#switch-permission-modes). Bei einem Aufruf, den nichts vorab genehmigt, wird über die Sitzungs-UI nachgefragt.

420 433

421<Note>434<Note>

422 Pinnen Sie nur Auto-Modus auf einer Umgebung, deren Sitzungs-Container mit [Standard-Deny-Netzwerk-Egress](/docs/de/self-hosted-environments-deploy#default-deny-egress) und dem Rest des [Härtungsabschnitts](/docs/de/self-hosted-environments-deploy#harden-your-deployment) laufen. Routine-Tool-Aufrufe, einschließlich `Bash`-Netzwerk-Anfragen, werden ohne einen Menschen in der Schleife sowohl auf dem Standard-Pre-Approved-Tool-Set als auch im Auto-Modus ausgeführt, daher ist die Netzwerk-Grenze das, was begrenzt, wo diese Aufrufe erreichen können.435 Legen Sie den Auto-Modus nur für eine Umgebung fest, deren Sitzungscontainer mit [standardmäßig gesperrtem ausgehendem Netzwerkverkehr](/docs/de/self-hosted-environments-deploy#default-deny-egress) und den übrigen Maßnahmen aus dem [Abschnitt zur Härtung](/docs/de/self-hosted-environments-deploy#harden-your-deployment) laufen. Alltägliche Tool-Aufrufe, einschließlich `Bash`-Netzwerkanfragen, werden sowohl mit dem standardmäßig vorab genehmigten Tool-Set als auch im Auto-Modus ohne menschliche Kontrolle ausgeführt, daher ist die Netzwerkgrenze das, was einschränkt, wohin diese Aufrufe gelangen können.

423</Note>436</Note>

424 437

425Um Aufforderungen unabhängig davon, was die Kontrolleben sendet, auf ein Minimum zu halten, pinnen Sie [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) von Ihrem Wrapper-Skript oder [`command`-Hook](#command). Auto-Modus lässt Sitzungen ohne Routine-Berechtigungsaufforderungen ausgeführt werden: Ein separates Klassifizierungsmodell überprüft Aktionen, bevor sie ausgeführt werden, und blockiert die, die es ablehnt, und explizite Ask-Regeln erzwingen immer noch eine Aufforderung; die Berechtigungsmodi-Seite behandelt, was der Klassifizierer überprüft. Der Runner hängt serverseitig berechnete Flags an, bevor er den Wrapper aufruft, und für Single-Value-Flags wie `--permission-mode` ehrt der Parser das letzte Vorkommen, daher überschreibt ein Flag, das Sie nach `"$@"` anhängen, den serverseitig gesendeten Wert:438Um Berechtigungsabfragen unabhängig davon, was die Steuerungsebene sendet, auf ein Minimum zu reduzieren, legen Sie den [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) in Ihrem Wrapper-Skript oder [`command`-Hook](#command) fest. Im Auto-Modus laufen Sitzungen ohne alltägliche Berechtigungsabfragen: Ein separates Klassifikatormodell prüft Aktionen, bevor sie ausgeführt werden, und blockiert diejenigen, die es ablehnt, und explizite ask-Regeln erzwingen weiterhin eine Abfrage; die Seite zu den Berechtigungsmodi beschreibt, was der Klassifikator prüft. Der Runner hängt serverseitig berechnete Flags an, bevor er den Wrapper aufruft, und bei Flags mit einem einzelnen Wert wie `--permission-mode` berücksichtigt der Parser das letzte Vorkommen, sodass ein Flag, das Sie nach `"$@"` anhängen, den vom Server gesendeten Wert überschreibt:

426 439

427```bash theme={null}440```bash theme={null}

428#!/bin/bash441#!/bin/bash

429exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --permission-mode auto442exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --permission-mode auto

430```443```

431 444

432Um stattdessen spezifische Tools vorab zu genehmigen, hängen Sie `--allowed-tools` mit Ihren Regeln an, zum Beispiel `--allowed-tools "Bash(bazel *) Bash(yarn *) mcp__internal__*"`. Listen-Flags wie `--allowed-tools` und `--disallowed-tools` sammeln sich über Vorkommen an, anstatt zu überschreiben, daher gelten Ihre Regeln zusätzlich zu allen Regeln, die die Kontrolleben sendet. Um zu verengen, hängen Sie `--disallowed-tools` an, das Tools verweigert, auch wenn eine andere Regel sie zulässt.445Um stattdessen bestimmte Tools vorab zu genehmigen, hängen Sie `--allowed-tools` mit Ihren Regeln an, zum Beispiel `--allowed-tools "Bash(bazel *) Bash(yarn *) mcp__internal__*"`. Listen-Flags wie `--allowed-tools` und `--disallowed-tools` werden über mehrere Vorkommen hinweg kumuliert, statt sich zu überschreiben, sodass Ihre Regeln zusätzlich zu allen Regeln gelten, die die Steuerungsebene sendet. Zum Einschränken hängen Sie `--disallowed-tools` an, das Tools verweigert, auch wenn eine andere Regel sie zulässt.

433 446

434<h3 id="how-each-session’s-config-is-assembled">447<h3 id="how-each-session’s-config-is-assembled">

435 Wie die Konfiguration jeder Sitzung zusammengestellt wird448 Wie die Konfiguration jeder Sitzung zusammengestellt wird

436</h3>449</h3>

437 450

438Der Runner gibt jeder Sitzung sein eigenes Konfigurationsverzeichnis, gekeimed aus einem Snapshot von `~/.claude/` des Hosts, den der Runner einmal beim Startup erfasst: `settings.json`, `CLAUDE.md`, Hooks, Agenten, Befehle und Skills in Ihrem Runner-Image gelten für jede Sitzung als Benutzer-Ebenen-Baseline. Wenn Sie die Konfiguration auf einem laufenden Host ändern, wird die Änderung erst nach einem Runner-Neustart wirksam. Setzen Sie `SELF_HOSTED_RUNNER_HOST_CONFIG_DIR`, um von einem anderen Pfad zu keimen, oder zeigen Sie auf ein leeres Verzeichnis, um das Keimen zu deaktivieren.451Der Runner gibt jeder Sitzung ein eigenes Konfigurationsverzeichnis, das aus einem Snapshot des `~/.claude/` des Hosts befüllt wird, den der Runner einmalig beim Start erstellt: `settings.json`, `CLAUDE.md`, Hooks, Agenten, Befehle und Skills in Ihrem Runner-Image gelten für jede Sitzung als Basis auf Benutzerebene. Wenn Sie die Konfiguration auf einem laufenden Host ändern, wird die Änderung erst wirksam, nachdem Sie den Runner neu gestartet haben.

452

453Setzen Sie `SELF_HOSTED_RUNNER_HOST_CONFIG_DIR`, um von einem anderen Pfad zu befüllen, oder lassen Sie die Variable auf ein leeres Verzeichnis zeigen, um das Befüllen zu deaktivieren.

454

455Eine im Repository committete `.claude/settings.json` wird als Projekteinstellungen darübergelegt. Sitzungen lesen außerdem [`managed-settings.json`](/docs/de/settings#where-settings-live) aus dem standardmäßigen Systempfad in Ihrem Runner-Image. Ob deren Schlüssel neben [serververwalteten Einstellungen](/docs/de/server-managed-settings) gelten, richtet sich danach, [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources): Wenn Ihre Organisation serververwaltete Schlüssel bereitstellt, ignorieren Sitzungen standardmäßig die Datei des Runner-Images, abgesehen von den [Schlüsseln, die Claude Code aus jeder Admin-Quelle liest](/docs/de/managed-settings#keys-read-from-every-admin-source), etwa dem `env`-Block, den Sandbox-Sperren, den Pfaden zu den Sandbox-Binärdateien und `forceRemoteSettingsRefresh`. Siehe [Vorrang der Einstellungen](/docs/de/settings#settings-precedence).

456

457Wenn die Steuerungsebene von Anthropic eine Sitzung mit [Claude Code-Hooks](/docs/de/hooks) versorgt, installiert der Runner diese neben Ihrer eigenen Konfiguration, nicht an deren Stelle. Erfordert Claude Code v2.1.229 oder höher.

439 458

440Repository-committete `.claude/settings.json` schichtet sich als Projekt-Einstellungen oben auf. Sitzungen lesen auch [`managed-settings.json`](/docs/de/settings#where-settings-live) vom Standard-Systempfad in Ihrem Runner-Image. Ob seine Schlüssel neben [serverseitig verwalteten Einstellungen](/docs/de/server-managed-settings) gelten, folgt [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources): Standardmäßig ignorieren Sitzungen, wenn Ihre Organisation serverseitig verwaltete Schlüssel liefert, die Runner-Image-Datei, abgesehen von den [Schlüsseln, die Claude Code von jeder Admin-Quelle liest](/docs/de/managed-settings#keys-read-from-every-admin-source), wie der `env`-Block, die Sandbox-Sperren, die Sandbox-Binärpfade und `forceRemoteSettingsRefresh`. Siehe [Einstellungs-Vorrang](/docs/de/settings#settings-precedence).459* **Wo sie abgelegt werden**: Der Runner schreibt jedes bereitgestellte Hook-Skript in ein reserviertes Unterverzeichnis `hooks/.ccr-launcher/` des Konfigurationsverzeichnisses der Sitzung und registriert die Skripte in einer separaten Einstellungsdatei, die er der Sitzung mit `--settings` übergibt; die befüllte `settings.json` und Ihre eigenen Skripte unter `hooks/<name>` bleiben dabei unberührt. Der Runner erstellt das reservierte Unterverzeichnis für jede Sitzung neu und übernimmt keine Host-Inhalte unter `~/.claude/hooks/.ccr-launcher/` in Sitzungen.

460* **Wer sie erstellt**: Die Steuerungsebene füllt die Skripte aus festen Konstanten in ihrem eigenen Deployment, niemals aus sitzungsspezifischen Eingaben oder Eingaben von Drittanbietern.

461* **Was weiterhin für sie gilt**: Hooks, die über `--settings` bereitgestellt werden, gehen in die gewöhnliche zusammengeführte Hook-Konfiguration ein, nicht in die verwaltete Ebene, sodass Ihre verwalteten Einstellungen weiterhin gelten. `disableAllHooks` deaktiviert sie, und sie gehören nicht zu den Kategorien, die [`allowManagedHooksOnly`](/docs/de/settings-reference#allowmanagedhooksonly) geladen lässt.

441 462

442Wenn Anthropics Kontrolleben eine Sitzung mit [Claude Code-Hooks](/docs/de/hooks) versorgt, installiert der Runner sie neben, nicht über, Ihrer eigenen Konfiguration. Erfordert Claude Code v2.1.229 oder später.463Außerhalb von [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen läuft eine Sitzung in einer selbstgehosteten Umgebung standardmäßig mit ausgeschaltetem [Auto-Memory](/docs/de/memory#auto-memory). Für Anweisungen, die über Sitzungen hinweg erhalten bleiben sollen, verwenden Sie die `CLAUDE.md` in Ihrem Runner-Image oder im Repository.

443 464

444* **Wo sie landen**: Der Runner schreibt jedes bereitgestellte Hook-Skript in ein reserviertes `hooks/.ccr-launcher/`-Unterverzeichnis des Konfigurationsverzeichnisses der Sitzung und registriert die Skripte in einer separaten Einstellungsdatei, die er mit `--settings` an die Sitzung übergibt, wobei die gekeimte `settings.json` und Ihre eigenen Skripte bei `hooks/<name>` unberührt bleiben. Der Runner erstellt das reservierte Unterverzeichnis für jede Sitzung neu und keimed keinen Host-Inhalt bei `~/.claude/hooks/.ccr-launcher/` in Sitzungen.465Der Snapshot, den der Runner vom `~/.claude/` des Hosts erstellt, lässt das Verzeichnis `projects/` aus. Der standardmäßige Speicherort von Auto-Memory liegt unterhalb dieses Verzeichnisses. Wenn Sie dort Memory-Dateien ablegen, übernimmt der Runner sie nicht in Sitzungen, und sie schalten Auto-Memory nicht ein.

445* **Wer sie verfasst**: Die Kontrolleben füllt die Skripte aus festen Konstanten in ihrer eigenen Bereitstellung, niemals aus Pro-Sitzungs- oder Drittanbieter-Input.

446* **Was sie immer noch regiert**: Hooks, die durch `--settings` bereitgestellt werden, treten in die gewöhnliche zusammengeführte Hook-Konfiguration ein, nicht in die verwaltete Ebene, daher gelten Ihre verwalteten Einstellungen immer noch. `disableAllHooks` deaktiviert sie, und sie gehören nicht zu den Kategorien, die [`allowManagedHooksOnly`](/docs/de/settings-reference#allowmanagedhooksonly) geladen hält.

447 466

448<h3 id="repository-committed-permission-rules">467<h3 id="repository-committed-permission-rules">

449 Repository-committete Berechtigungsregeln468 Im Repository committete Berechtigungsregeln

450</h3>469</h3>

451 470

452Legen Sie keinen bloßen `"Edit"`-, `"Write"`- oder `"NotebookEdit"`-Eintrag in eine Repository-committete `permissions.allow`. Eine bloße Datei-Tool-Regel passt das Tool unabhängig vom Pfad, gewährt Schreibvorgänge überall auf dem Host anstelle nur des Arbeitsbereichs, daher flaggt der Schreib-Bereich-Confine-Guard des Runners die Sitzung; mit [`--confine-repo-settings enforce`](/docs/de/self-hosted-environments-reference#runner-cli-flags) weigert er sich, die Sitzung zu spawnen, anstatt zu protokollieren und fortzufahren. Siehe den [Härtungsabschnitt](/docs/de/self-hosted-environments-deploy#harden-your-deployment).471Tragen Sie keinen bloßen `"Edit"`-, `"Write"`- oder `"NotebookEdit"`-Eintrag in eine im Repository committete `permissions.allow` ein. Eine bloße Datei-Tool-Regel greift für das Tool unabhängig vom Pfad und erlaubt Schreibzugriffe überall auf dem Host statt nur im Arbeitsbereich, daher kennzeichnet der Schutzmechanismus des Runners zur Beschränkung des Schreibbereichs die Sitzung; mit [`--confine-repo-settings enforce`](/docs/de/self-hosted-environments-reference#runner-cli-flags) verweigert er den Start der Sitzung, statt nur zu protokollieren und fortzufahren. Siehe den [Abschnitt zur Härtung](/docs/de/self-hosted-environments-deploy#harden-your-deployment).

453 472

454Ein Repository benötigt überhaupt keine Datei-Tool-Regel: Cloud-Sitzungen [genehmigen Datei-Edits unabhängig vom Modus vor](/docs/de/permission-modes#switch-permission-modes). Wenn Sie eine Regel committen, beschränken Sie sie auf den Arbeitsbereich, wie `"Edit(/**)"`; ein einzelner führender Schrägstrich ist relativ zum Projekt-Root, das der Arbeitsbereich der Sitzung ist. Bloße Datei-Tool-Regeln sind in der Operator-Host-Ebenen-`settings.json` in Ordnung, da diese Datei nicht Repository-committiert ist.473Ein Repository benötigt überhaupt keine Datei-Tool-Regel: Cloud-Sitzungen [genehmigen Dateibearbeitungen unabhängig vom Modus vorab](/docs/de/permission-modes#switch-permission-modes). Wenn Sie dennoch eine Regel committen, beschränken Sie sie auf den Arbeitsbereich, etwa `"Edit(/**)"`; ein einzelner führender Schrägstrich ist relativ zum Projektstammverzeichnis, das der Arbeitsbereich der Sitzung ist. Bloße Datei-Tool-Regeln sind in der `settings.json` auf Host-Ebene des Betreibers unproblematisch, da diese Datei nicht im Repository committet ist.

455 474

456Ein `defaultMode` von `auto` wird nur aus der Image-weiten oder Benutzer-Ebenen-Einstellungsdatei geehrt, daher kann ein ausgechecktes Repository sich nicht selbst Auto-Modus gewähren. Für welche Modi Cloud-Sitzungen akzeptieren und die vollständige Regel-Syntax, siehe [Berechtigungsmodi](/docs/de/permission-modes).475Ein `defaultMode` von `auto` wird nur aus der imageweiten Einstellungsdatei oder der Einstellungsdatei auf Benutzerebene berücksichtigt, sodass sich ein ausgechecktes Repository nicht selbst den Auto-Modus gewähren kann. Welche Modi Cloud-Sitzungen akzeptieren und die vollständige Regelsyntax finden Sie unter [Berechtigungsmodi](/docs/de/permission-modes).

457 476

458<h2 id="what’s-next">477<h2 id="what’s-next">

459 Nächste Schritte478 Nächste Schritte

settings-reference.md +969 −646

Details

577 Einstellungsindex577 Einstellungsindex

578</h2>578</h2>

579 579

580Jeder Schlüssel unten verlinkt zu seinem Eintrag. Der Bereich listet die [Dateien](/docs/de/settings#settings-files-and-who-they-affect) auf, in denen er verwendet werden kann: `User` ist `~/.claude/settings.json`, `Project` ist `.claude/settings.json`, `Local` ist `.claude/settings.local.json`, und `Managed` ist [das, was Ihre Organisation bereitstellt](/docs/de/managed-settings). `Any file` bedeutet alle vier, und `Global config` bedeutet [`~/.claude.json`](#global-config-settings).580Jeder Schlüssel unten verlinkt zu seinem Eintrag. Der Geltungsbereich listet die [Dateien](/docs/de/settings#settings-files-and-who-they-affect) auf, in denen er verwendet werden kann: `User` ist `~/.claude/settings.json`, `Project` ist `.claude/settings.json`, `Local` ist `.claude/settings.local.json`, und `Managed` ist [das, was Ihre Organisation bereitstellt](/docs/de/managed-settings). `Any file` bedeutet alle vier, und `Global config` bedeutet [`~/.claude.json`](#global-config-settings).

581 581

582<ReferenceFilter582<ReferenceFilter

583 noun="settings"583 noun="settings"

596| [`agentPushNotifEnabled`](#agentpushnotifenabled) | Lassen Sie Claude eine [Push-Benachrichtigung an Ihr Telefon](/docs/de/remote-control#mobile-push-notifications) senden, wenn es sich dafür entscheidet | Remote, desktop, and notifications | Any file |596| [`agentPushNotifEnabled`](#agentpushnotifenabled) | Lassen Sie Claude eine [Push-Benachrichtigung an Ihr Telefon](/docs/de/remote-control#mobile-push-notifications) senden, wenn es sich dafür entscheidet | Remote, desktop, and notifications | Any file |

597| [`allowAllClaudeAiMcps`](#allowallclaudeaimcps) | Laden Sie die [claude.ai-Konnektoren](/docs/de/mcp), die Claude Code selbst abruft, zusammen mit einem bereitgestellten [`managed-mcp.json`](/docs/de/managed-mcp#exclusive-control-with-managed-mcp-json) | MCP | Managed |597| [`allowAllClaudeAiMcps`](#allowallclaudeaimcps) | Laden Sie die [claude.ai-Konnektoren](/docs/de/mcp), die Claude Code selbst abruft, zusammen mit einem bereitgestellten [`managed-mcp.json`](/docs/de/managed-mcp#exclusive-control-with-managed-mcp-json) | MCP | Managed |

598| [`allowedChannelPlugins`](#allowedchannelplugins) | Ersetzen Sie die Standard-Zulassungsliste der [Channel-Plugins](/docs/de/channels#restrict-which-channel-plugins-can-run), die Nachrichten pushen können | Plugins and skills | Managed |598| [`allowClaudeInChromeWithManagedMcp`](#allowclaudeinchromewithmanagedmcp) | Lassen Sie den integrierten [Claude in Chrome](/docs/de/chrome)-Server zusammen mit einem bereitgestellten [`managed-mcp.json`](/docs/de/managed-mcp#exclusive-control-with-managed-mcp-json) laufen | MCP | Managed |

599| [`allowedChannelPlugins`](#allowedchannelplugins) | Ersetzen Sie die Standard-Allowlist der [Channel-Plugins](/docs/de/channels#restrict-which-channel-plugins-can-run), die Nachrichten pushen können | Plugins and skills | Managed |

603| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Machen Sie [verwaltete Einstellungen](/docs/de/managed-settings) zur einzigen Einstellungsquelle für [Berechtigungsregeln](/docs/de/permissions#managed-settings) | Permission settings | Managed |605| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Machen Sie [verwaltete Einstellungen](/docs/de/managed-settings) zur einzigen Einstellungsquelle für [Berechtigungsregeln](/docs/de/permissions#managed-settings) | Permission settings | Managed |

606| [`askUserQuestionTimeout`](#askuserquestiontimeout) | Lassen Sie eine unbeantwortete Frage [automatisch fortfahren](/docs/de/tools-reference#question-auto-continue-timeout) nach Leerlaufzeit | Interface and terminal | User or managed |608| [`askUserQuestionTimeout`](#askuserquestiontimeout) | Lassen Sie eine unbeantwortete Frage [automatisch fortfahren](/docs/de/tools-reference#question-auto-continue-timeout) nach Leerlaufzeit | Interface and terminal | User or managed |

613| [`autoConnectIde`](#autoconnectide) | Verbinden Sie sich automatisch mit einer laufenden [VS Code](/docs/de/vs-code)- oder [JetBrains](/docs/de/jetbrains#from-external-terminals)-IDE von einem externen Terminal aus | Global config settings | Global config |616| [`autoConnectIde`](#autoconnectide) | Verbinden Sie sich automatisch mit einer laufenden [VS Code](/docs/de/vs-code)- oder [JetBrains](/docs/de/jetbrains#from-external-terminals)-IDE von einem externen Terminal aus | Global config settings | Global config |

614| [`autoContinueAtUsageLimit`](#autocontinueatusagelimit) | Warten Sie in der offenen Sitzung und [fahren Sie die Aufgabe automatisch fort](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset), nachdem ein claude.ai-Nutzungslimit zurückgesetzt wird | Interface and terminal | User or managed |617| [`autoContinueAtUsageLimit`](#autocontinueatusagelimit) | Warten Sie in der offenen Sitzung und [fahren Sie die Aufgabe automatisch fort](/docs/de/interactive-mode#wait-for-a-usage-limit-to-reset), nachdem ein claude.ai-Nutzungslimit zurückgesetzt wird | Interface and terminal | User or managed |

615| [`autoInstallIdeExtension`](#autoinstallideextension) | Schalten Sie die automatische Installation der [IDE-Erweiterung](/docs/de/vs-code#install-the-extension) von einem VS Code-Terminal aus | Global config settings | Global config |618| [`autoInstallIdeExtension`](#autoinstallideextension) | Schalten Sie die automatische Installation der [IDE-Erweiterung](/docs/de/vs-code#install-the-extension) von einem VS Code-Terminal aus | Global config settings | Global config |

618| [`autoMode`](#automode) | Fügen Sie Ihre eigenen Allow- und Deny-Regeln zum [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)-Klassifizierer hinzu | Permission settings | User or managed |621| [`autoMode`](#automode) | Fügen Sie Ihre eigenen Allow- und Deny-Regeln zum [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)-Klassifikator hinzu | Permission settings | User or managed |

619| [`autoMode.classifyAllShell`](#automode-classifyallshell) | Senden Sie jeden Shell-Befehl durch den [Auto-Modus-Klassifizierer](/docs/de/permission-modes#what-the-classifier-blocks-by-default), auch solche, die eine enge Allow-Regel erfüllen | Permission settings | User or managed |622| [`autoMode.classifyAllShell`](#automode-classifyallshell) | Senden Sie jeden Shell-Befehl durch den [Auto-Modus-Klassifikator](/docs/de/permission-modes#what-the-classifier-blocks-by-default), auch solche, die eine enge Allow-Regel erfüllen | Permission settings | User or managed |

626| [`availableModelsMatch`](#availablemodelsmatch) | Sorgen Sie dafür, dass jeder Modell-ID-Eintrag in `availableModels` [nur die darin genannte Version zulässt](/docs/de/model-config#block-specific-models-or-versions) | Model and responses | Managed |

623| [`awaySummaryEnabled`](#awaysummaryenabled) | Schalten Sie die [Sitzungszusammenfassung](/docs/de/interactive-mode#session-recap) aus, die angezeigt wird, wenn Sie zum Terminal zurückkehren | Remote, desktop, and notifications | Any file |627| [`awaySummaryEnabled`](#awaysummaryenabled) | Schalten Sie die [Sitzungszusammenfassung](/docs/de/interactive-mode#session-recap) aus, die angezeigt wird, wenn Sie zum Terminal zurückkehren | Remote, desktop, and notifications | Any file |

624| [`awsAuthRefresh`](#awsauthrefresh) | Aktualisieren Sie abgelaufene [Bedrock-Anmeldedaten](/docs/de/amazon-bedrock#advanced-credential-configuration) in `.aws` mit Ihrem eigenen Befehl | Authentication and providers | Any file |628| [`awsAuthRefresh`](#awsauthrefresh) | Aktualisieren Sie abgelaufene [Bedrock-Anmeldedaten](/docs/de/amazon-bedrock#advanced-credential-configuration) in `.aws` mit Ihrem eigenen Befehl | Authentication and providers | Any file |

625| [`awsCredentialExport`](#awscredentialexport) | Stellen Sie [Bedrock-Anmeldedaten](/docs/de/amazon-bedrock#advanced-credential-configuration) als JSON aus Ihrem eigenen Befehl bereit | Authentication and providers | Any file |629| [`awsCredentialExport`](#awscredentialexport) | Stellen Sie [Bedrock-Anmeldedaten](/docs/de/amazon-bedrock#advanced-credential-configuration) als JSON aus Ihrem eigenen Befehl bereit | Authentication and providers | Any file |

636| [`claudeInChromeDefaultEnabled`](#claudeinchromedefaultenabled) | Schalten Sie die [Chrome-Integration](/docs/de/chrome) in jeder interaktiven CLI-Sitzung ein, ohne `--chrome` zu übergeben | Global config settings | Global config |

636| [`copyOnSelect`](#copyonselect) | Schalten Sie das automatische Kopieren von Text aus, den Sie mit der Maus im [Vollbild-Rendering](/docs/de/fullscreen#use-the-mouse) und in der Agent-Ansicht auswählen | Global config settings | Global config |642| [`copyOnSelect`](#copyonselect) | Schalten Sie das automatische Kopieren von Text aus, den Sie mit der Maus im [Vollbild-Rendering](/docs/de/fullscreen#use-the-mouse) und in der Agent-Ansicht auswählen | Global config settings | Global config |

637| [`crossSessionInbound`](#crosssessioninbound) | Wählen Sie, ob Claude Code [Nachrichten von Ihren anderen Sitzungen](/docs/de/cross-session-messaging#control-inbound-messages) liefert, einen Hinweis anzeigt, ohne sie zu liefern, oder sie ablehnt | Agents, sessions, and worktrees | Any file |643| [`crossSessionInbound`](#crosssessioninbound) | Wählen Sie, ob Claude Code [Nachrichten von Ihren anderen Sitzungen](/docs/de/cross-session-messaging#control-inbound-messages) liefert, einen Hinweis anzeigt, ohne sie zu liefern, oder sie ablehnt | Agents, sessions, and worktrees | Any file |

638| [`defaultShell`](#defaultshell) | Wählen Sie, ob Bash oder PowerShell die Shell-Befehle ausführt, die Sie mit dem [`!`-Präfix](/docs/de/interactive-mode#shell-mode-with-prefix) eingeben | Interface and terminal | Any file |644| [`defaultShell`](#defaultshell) | Wählen Sie, ob Bash oder PowerShell die Shell-Befehle ausführt, die Sie mit dem [`!`-Präfix](/docs/de/interactive-mode#shell-mode-with-prefix) eingeben | Interface and terminal | Any file |

645| [`defaultToAgentsView`](#defaulttoagentsview) | Öffnen Sie die [Agent-Ansicht](/docs/de/agent-view) statt einer neuen Konversation, wenn Sie `claude` ohne Argumente ausführen | Global config settings | Global config |

640| [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | Legen Sie ein Alterslimit in Tagen für [Claude Desktop- und Cowork-Transkripte](/docs/de/claude-directory#cleaned-up-automatically) fest | Privacy and telemetry | User or managed |648| [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | Legen Sie ein Alterslimit in Tagen für [Claude Desktop- und Cowork-Transkripte](/docs/de/claude-directory#cleaned-up-automatically) fest | Privacy and telemetry | User or managed |

641| [`dialogExpiry`](#dialogexpiry) | Legen Sie fest, wie lange Claude Code auf eine Antwort von [Remote Control](/docs/de/remote-control) oder einem SDK-Host auf einen weitergeleitet Dialog wartet, bevor der Dialog abgebrochen wird | Interface and terminal | User or managed |649| [`dialogExpiry`](#dialogexpiry) | Legen Sie fest, wie lange Claude Code auf eine Antwort von [Remote Control](/docs/de/remote-control) oder einem SDK-Host auf einen weitergeleiteten Dialog wartet, bevor der Dialog abgebrochen wird | Interface and terminal | User or managed |

642| [`diffTool`](#difftool) | Wählen Sie, ob Claudes vorgeschlagene Dateiänderungen im [VS Code](/docs/de/vs-code)- oder [JetBrains](/docs/de/jetbrains#features)-Diff-Viewer geöffnet werden oder im Terminal bleiben | Global config settings | Global config |650| [`diffTool`](#difftool) | Wählen Sie, ob Claudes vorgeschlagene Dateiänderungen im [VS Code](/docs/de/vs-code)- oder [JetBrains](/docs/de/jetbrains#features)-Diff-Viewer geöffnet werden oder im Terminal bleiben | Global config settings | Global config |

644| [`disableAllHooks`](#disableallhooks) | Schalten Sie [Hooks](/docs/de/hooks), eine benutzerdefinierte [Statuszeile](/docs/de/statusline) und einen benutzerdefinierten [`@`-Dateivorschlag](/docs/de/interactive-mode#quick-commands)-Befehl auf einmal aus | Hooks and automation | Any file |652| [`disableAllHooks`](#disableallhooks) | Schalten Sie [Hooks](/docs/de/hooks), eine benutzerdefinierte [Statuszeile](/docs/de/statusline) und einen benutzerdefinierten [`@`-Dateivorschlag](/docs/de/interactive-mode#quick-commands)-Befehl auf einmal aus | Hooks and automation | Any file |

661| [`emojiCompletionEnabled`](#emojicompletionenabled) | Schalten Sie [`:shortcode:`-Emoji-Vorschläge und -Ersetzung](/docs/de/interactive-mode#emoji-shortcodes) in der Eingabeaufforderung aus | Interface and terminal | Any file |669| [`emojiCompletionEnabled`](#emojicompletionenabled) | Schalten Sie [`:shortcode:`-Emoji-Vorschläge und -Ersetzung](/docs/de/interactive-mode#emoji-shortcodes) in der Eingabeaufforderung aus | Interface and terminal | Any file |

662| [`enableAllProjectMcpServers`](#enableallprojectmcpservers) | Genehmigen Sie jeden Server in Projekt-[`.mcp.json`](/docs/de/mcp#project-server-approvals-and-workspace-trust)-Dateien ohne Aufforderung | MCP | Any file |670| [`enableAllProjectMcpServers`](#enableallprojectmcpservers) | Genehmigen Sie jeden Server in Projekt-[`.mcp.json`](/docs/de/mcp#project-server-approvals-and-workspace-trust)-Dateien ohne Rückfrage | MCP | Any file |

663| [`enableArtifact`](#enableartifact) | Schalten Sie das [Artifact-Tool](/docs/de/artifacts) mit einem `false` in einer beliebigen Datei aus; keine Datei kann es wieder einschalten | Remote, desktop, and notifications | Any file |671| [`enableArtifact`](#enableartifact) | Schalten Sie das [Artifact-Tool](/docs/de/artifacts) mit einem `false` in einer beliebigen Datei aus; keine Datei kann es wieder einschalten | Remote, desktop, and notifications | Any file |

667| [`enforceAvailableModels`](#enforceavailablemodels) | Halten Sie die [`/model`-Standardauswahl](/docs/de/model-config#enforce-the-allowlist-for-the-default-model) innerhalb Ihrer `availableModels`-Zulassungsliste | Model and responses | Any file |675| [`enforceAvailableModels`](#enforceavailablemodels) | Halten Sie die [`/model`-Standardauswahl](/docs/de/model-config#enforce-the-allowlist-for-the-default-model) innerhalb Ihrer `availableModels`-Allowlist | Model and responses | Any file |

669| [`externalEditorContext`](#externaleditorcontext) | Zeigen Sie Claudes letzte Antwort als Kommentare an, wenn Sie [Strg+G](/docs/de/interactive-mode#general-controls) drücken, um zu bearbeiten | Global config settings | Global config |677| [`externalEditorContext`](#externaleditorcontext) | Zeigen Sie Claudes letzte Antwort als Kommentare an, wenn Sie [Strg+G](/docs/de/interactive-mode#general-controls) drücken, um zu bearbeiten | Global config settings | Global config |

690| [`isolatePeerMachines`](#isolatepeermachines) | Fragen Sie, bevor Claude [eine Ihrer Sitzungen auf einem anderen Computer](/docs/de/cross-session-messaging#require-approval-for-cross-machine-messages) benachrichtigt | Agents, sessions, and worktrees | Any file |698| [`isolatePeerMachines`](#isolatepeermachines) | Fragen Sie, bevor Claude [eine Ihrer Sitzungen auf einem anderen Computer](/docs/de/cross-session-messaging#require-approval-for-cross-machine-messages) benachrichtigt | Agents, sessions, and worktrees | Any file |

691| [`keybindingFlavor`](#keybindingflavor) | Veraltet und hat keine Auswirkung; die Wort-Bearbeitungs-Tastenkombinationen folgen immer [readline-Konventionen](/docs/de/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface and terminal | Any file |699| [`keybindingFlavor`](#keybindingflavor) | Veraltet und hat keine Auswirkung; die Wort-Bearbeitungs-Tastenkombinationen folgen immer [readline-Konventionen](/docs/de/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface and terminal | Any file |

701| [`leftArrowOpensAgents`](#leftarrowopensagents) | Schalten Sie die Tastenkombination `←` aus, die [die Sitzung in den Hintergrund verschiebt und die Agent-Ansicht öffnet](/docs/de/agent-view#switch-sessions-without-leaving-the-terminal) | Global config settings | Global config |

693| [`managedMcpServers`](#managedmcpservers) | Stellen Sie Remote-[MCP-Server](/docs/de/managed-mcp#provide-servers-through-managed-settings) für jeden Benutzer zusammen mit den von ihm hinzugefügten bereit | MCP | Managed |702| [`managedMcpServers`](#managedmcpservers) | Stellen Sie Remote-[MCP-Server](/docs/de/managed-mcp#provide-servers-through-managed-settings) für jeden Benutzer zusammen mit den von ihm hinzugefügten bereit | MCP | Managed |

694| [`managedSourcesBehavior`](#managedsourcesbehavior) | Kombinieren Sie jede [verwaltete Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources), die Sie bereitstellen, anstatt nur die mit der höchsten Priorität zu verwenden | Enterprise and managed settings | Managed |703| [`managedSourcesBehavior`](#managedsourcesbehavior) | Kombinieren Sie jede [verwaltete Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources), die Sie bereitstellen, anstatt nur die mit der höchsten Priorität zu verwenden | Enterprise and managed settings | Managed |

700| [`modelPicker`](#modelpicker) | Wählen Sie, welche Modelle der [`/model`-Picker](/docs/de/model-config#available-models) auflistet, in Ihrer eigenen Reihenfolge und mit Ihren eigenen Labels | Model and responses | User or managed |709| [`modelPicker`](#modelpicker) | Wählen Sie, welche Modelle der [`/model`-Picker](/docs/de/model-config#available-models) auflistet, in Ihrer eigenen Reihenfolge und mit Ihren eigenen Labels | Model and responses | User or managed |

702| [`modelSettings`](#modelsettings) | Behalten Sie eine gespeicherte [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) pro Modell bei, oder begrenzen Sie die Anstrengung eines Modells | Model and responses | Any file |711| [`modelSettings`](#modelsettings) | Behalten Sie eine gespeicherte [Effort-Stufe](/docs/de/model-config#adjust-effort-level) pro Modell bei, oder begrenzen Sie den Effort eines Modells | Model and responses | Any file |

705| [`parentSettingsBehavior`](#parentsettingsbehavior) | Wenden Sie Einschränkungen an oder verwerfen Sie sie, die ein [SDK- oder IDE-Host](/docs/de/managed-settings#let-an-embedding-host-add-policy) übergibt, wenn Sie [verwaltete Einstellungen](/docs/de/managed-settings) bereitstellen | Enterprise and managed settings | Managed |714| [`parentSettingsBehavior`](#parentsettingsbehavior) | Wenden Sie Einschränkungen an oder verwerfen Sie sie, die ein [SDK- oder IDE-Host](/docs/de/managed-settings#let-an-embedding-host-add-policy) übergibt, wenn Sie [verwaltete Einstellungen](/docs/de/managed-settings) bereitstellen | Enterprise and managed settings | Managed |

708| [`permissions.additionalDirectories`](#permissions-additionaldirectories) | Geben Sie Claude Dateizugriff auf [Verzeichnisse außerhalb des aktuellen](/docs/de/permissions#working-directories) | Permission settings | Any file |717| [`permissions.additionalDirectories`](#permissions-additionaldirectories) | Geben Sie Claude Dateizugriff auf [Verzeichnisse außerhalb des aktuellen](/docs/de/permissions#working-directories) | Permission settings | Any file |

711| [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | Machen Sie die Datei-Tools, um Lesevorgänge außerhalb der [Arbeitsverzeichnisse](/docs/de/permissions#working-directories) in jedem Berechtigungsmodus zu verweigern | Permission settings | Any file |720| [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | Lassen Sie die Datei-Tools Lesevorgänge außerhalb der [Arbeitsverzeichnisse](/docs/de/permissions#working-directories) in jedem Berechtigungsmodus verweigern | Permission settings | Any file |

712| [`permissions.defaultMode`](#permissions-defaultmode) | Legen Sie den [Berechtigungsmodus](/docs/de/permission-modes#which-mode-a-session-starts-in) fest, in dem neue Sitzungen starten | Permission settings | Any file |721| [`permissions.defaultMode`](#permissions-defaultmode) | Legen Sie den [Berechtigungsmodus](/docs/de/permission-modes#which-mode-a-session-starts-in) fest, in dem neue Sitzungen starten | Permission settings | Any file |

713| [`permissions.deny`](#permissions-deny) | Blockieren Sie aufgelistete [Tool-Verwendungen](/docs/de/permissions#permission-rule-syntax), einschließlich Lesevorgänge von Dateien, die Geheimnisse enthalten | Permission settings | Any file |722| [`permissions.deny`](#permissions-deny) | Blockieren Sie aufgelistete [Tool-Verwendungen](/docs/de/permissions#permission-rule-syntax), einschließlich Lesevorgänge von Dateien, die Geheimnisse enthalten | Permission settings | Any file |

714| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Verhindern Sie, dass jemand den [bypassPermissions-Modus](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) betritt | Permission settings | Any file |723| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Verhindern Sie, dass jemand den [bypassPermissions-Modus](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) betritt | Permission settings | Any file |

717| [`pluginSuggestionMarketplaces`](#pluginsuggestionmarketplaces) | Wählen Sie, welche [Marketplaces](/docs/de/plugins/overview) Plugin-Installationsvorschläge in `/plugin` anzeigen können | Plugins and skills | Managed |726| [`pluginSuggestionMarketplaces`](#pluginsuggestionmarketplaces) | Wählen Sie, welche [Marketplaces](/docs/de/plugins/org#restrict-what-users-can-install) Plugin-Installationsvorschläge in `/plugin` anzeigen können | Plugins and skills | Managed |

719| [`policyHelper`](#policyhelper) | Führen Sie eine ausführbare Datei aus, die [verwaltete Einstellungen](/docs/de/managed-settings#compute-the-policy-with-a-helper-program) beim Start berechnet | Enterprise and managed settings | Managed |728| [`policyHelper`](#policyhelper) | Führen Sie eine ausführbare Datei aus, die [verwaltete Einstellungen](/docs/de/managed-settings#compute-the-policy-with-a-helper-program) beim Start berechnet | Enterprise and managed settings | Managed |

720| [`policyHelper.path`](#policyhelper-path) | Benennen Sie die [Helper-Ausführungsdatei](/docs/de/managed-settings#compute-the-policy-with-a-helper-program), die Claude Code ausführt | Enterprise and managed settings | Managed |729| [`policyHelper.path`](#policyhelper-path) | Benennen Sie die [Helper-Ausführungsdatei](/docs/de/managed-settings#compute-the-policy-with-a-helper-program), die Claude Code ausführt | Enterprise and managed settings | Managed |

722| [`policyHelper.timeoutMs`](#policyhelper-timeoutms) | Legen Sie fest, wie lange Claude Code auf den [Helper](/docs/de/managed-settings#compute-the-policy-with-a-helper-program) wartet | Enterprise and managed settings | Managed |731| [`policyHelper.timeoutMs`](#policyhelper-timeoutms) | Legen Sie fest, wie lange Claude Code auf den [Helper](/docs/de/managed-settings#compute-the-policy-with-a-helper-program) wartet | Enterprise and managed settings | Managed |

723| [`preferredNotifChannel`](#preferrednotifchannel) | Wählen Sie einen [Terminal-Gong oder Desktop-Benachrichtigung](/docs/de/terminal-config#get-a-terminal-bell-or-notification) für die Aufgabenvollendung | Remote, desktop, and notifications | Any file |732| [`preferredNotifChannel`](#preferrednotifchannel) | Wählen Sie einen [Terminal-Gong oder Desktop-Benachrichtigung](/docs/de/terminal-config#get-a-terminal-bell-or-notification) für die Aufgabenvollendung | Remote, desktop, and notifications | Any file |

724| [`prefersReducedMotion`](#prefersreducedmotion) | [Reduzieren oder schalten Sie](/docs/de/accessibility#accessibility-settings) Spinner-, Shimmer- und Flash-Animationen aus | Interface and terminal | Any file |733| [`prefersReducedMotion`](#prefersreducedmotion) | [Reduzieren oder schalten Sie](/docs/de/accessibility#accessibility-settings) Spinner-, Shimmer- und Flash-Animationen aus | Interface and terminal | Any file |

725| [`processWrapper`](#processwrapper) | Führen Sie die Hintergrundprozesse von Claude Code durch einen [Corporate Launcher](/docs/de/corporate-launcher) auf macOS und Linux aus | Agents, sessions, and worktrees | User or managed |735| [`processWrapper`](#processwrapper) | Führen Sie die Hintergrundprozesse von Claude Code durch einen [Corporate Launcher](/docs/de/corporate-launcher) auf macOS und Linux aus | Agents, sessions, and worktrees | User or managed |

738| [`prStatusFooterEnabled`](#prstatusfooterenabled) | Schalten Sie das Badge für den [PR-Review-Status](/docs/de/interactive-mode#pr-review-status) in der Prompt-Fußzeile und die dahinterliegende Pull-Request-Prüfung aus | Global config settings | Global config |

729| [`remote.defaultEnvironmentId`](#remote-defaultenvironmentid) | Wählen Sie die Standard-[Cloud-Umgebung](/docs/de/cloud-environments) für `claude --cloud`; eine selbstgehostete `ccpool_`-ID wird nur aus Benutzer- und verwalteten Einstellungen und `--settings` gelesen | Remote, desktop, and notifications | Any file |740| [`remote.defaultEnvironmentId`](#remote-defaultenvironmentid) | Wählen Sie die Standard-[Cloud-Umgebung](/docs/de/cloud-environments) für `claude --cloud`; eine selbstgehostete `ccpool_`-ID wird nur aus Benutzer- und verwalteten Einstellungen und `--settings` gelesen | Remote, desktop, and notifications | Any file |

730| [`remoteControlAtStartup`](#remotecontrolatstartup) | Verbinden Sie [Remote Control](/docs/de/remote-control#enable-remote-control-for-all-sessions) automatisch, wenn eine Sitzung startet | Remote, desktop, and notifications | Any file |741| [`remoteControlAtStartup`](#remotecontrolatstartup) | Verbinden Sie [Remote Control](/docs/de/remote-control#enable-remote-control-for-all-sessions) automatisch, wenn eine Sitzung startet | Remote, desktop, and notifications | Any file |

731| [`requiredMaximumVersion`](#requiredmaximumversion) | [Weigern Sie sich zu starten](/docs/de/setup#pin-a-minimum-version) auf einer Version, die Ihre Organisation nicht zulässt | Updates and versioning | Managed |742| [`requiredMaximumVersion`](#requiredmaximumversion) | [Weigern Sie sich zu starten](/docs/de/setup#pin-a-minimum-version) auf einer Version, die neuer ist, als Ihre Organisation zulässt | Updates and versioning | Managed |

732| [`requiredMinimumVersion`](#requiredminimumversion) | [Weigern Sie sich zu starten](/docs/de/setup#pin-a-minimum-version) auf einer Version, die älter ist als Ihre Organisation erfordert | Updates and versioning | Managed |743| [`requiredMinimumVersion`](#requiredminimumversion) | [Weigern Sie sich zu starten](/docs/de/setup#pin-a-minimum-version) auf einer Version, die älter ist als Ihre Organisation erfordert | Updates and versioning | Managed |

737| [`sandbox.allowUnsandboxedCommands`](#sandbox-allowunsandboxedcommands) | Lassen Sie Claude einen blockierten Befehl außerhalb der [Sandbox](/docs/de/sandboxing#the-unsandboxed-retry-escape-hatch) erneut versuchen, oder verbieten Sie ihn | Sandbox settings | Any file |748| [`sandbox.allowUnsandboxedCommands`](#sandbox-allowunsandboxedcommands) | Lassen Sie Claude einen blockierten Befehl außerhalb der [Sandbox](/docs/de/sandboxing#the-unsandboxed-retry-escape-hatch) erneut versuchen, oder verbieten Sie es | Sandbox settings | Any file |

741| [`sandbox.credentials.allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) | Lassen Sie [maskierte Anmeldedaten](/docs/de/sandboxing#mask-credentials) Plain-HTTP-Dienste auf vertrauenswürdigen Test-Netzwerken erreichen | Sandbox settings | User or managed |752| [`sandbox.credentials.allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) | Lassen Sie [maskierte Anmeldedaten](/docs/de/sandboxing#mask-credentials) Plain-HTTP-Dienste auf vertrauenswürdigen Test-Netzwerken erreichen | Sandbox settings | User or managed |

742| [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs) | Verknüpfen Sie benutzerdefiniert benannte AWS-Schlüsselvariablen in eine Anmeldedaten für [Neusignierung](/docs/de/sandboxing#re-sign-aws-requests) | Sandbox settings | User or managed |753| [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs) | Verknüpfen Sie benutzerdefiniert benannte AWS-Schlüsselvariablen zu einem Satz Anmeldedaten für die [Neusignierung](/docs/de/sandboxing#re-sign-aws-requests) | Sandbox settings | User or managed |

743| [`sandbox.credentials.envVars`](#sandbox-credentials-envvars) | Heben Sie die Einstellung auf oder maskieren Sie eine Umgebungsvariable in der [Sandbox](/docs/de/sandboxing#mask-environment-variables) | Sandbox settings | Any file |754| [`sandbox.credentials.envVars`](#sandbox-credentials-envvars) | Heben Sie die Einstellung auf oder maskieren Sie eine Umgebungsvariable in der [Sandbox](/docs/de/sandboxing#mask-environment-variables) | Sandbox settings | Any file |

744| [`sandbox.credentials.files`](#sandbox-credentials-files) | Blockieren oder maskieren Sie Lesevorgänge einer Anmeldedatei in der [Sandbox](/docs/de/sandboxing#mask-credential-files) | Sandbox settings | Any file |755| [`sandbox.credentials.files`](#sandbox-credentials-files) | Blockieren oder maskieren Sie Lesevorgänge einer Anmeldedatei in der [Sandbox](/docs/de/sandboxing#mask-credential-files) | Sandbox settings | Any file |

745| [`sandbox.credentials.sigv4`](#sandbox-credentials-sigv4) | Wählen Sie, ob Streaming-, Presigned- oder [SigV4A-AWS-Anfragen](/docs/de/sandboxing#re-sign-aws-requests) fehlschlagen oder durchgehen | Sandbox settings | User or managed |756| [`sandbox.credentials.sigv4`](#sandbox-credentials-sigv4) | Wählen Sie, ob Streaming-, Presigned- oder [SigV4A-AWS-Anfragen](/docs/de/sandboxing#re-sign-aws-requests) fehlschlagen oder durchgehen | Sandbox settings | User or managed |

748| [`sandbox.enableWeakerNetworkIsolation`](#sandbox-enableweakernetworkisolation) | Lassen Sie `gh`, `gcloud` und `terraform` TLS hinter einem MITM-Proxy in der [Sandbox](/docs/de/sandboxing#troubleshooting) auf macOS überprüfen | Sandbox settings | Any file |759| [`sandbox.enableWeakerNetworkIsolation`](#sandbox-enableweakernetworkisolation) | Lassen Sie `gh`, `gcloud` und `terraform` TLS hinter einem MITM-Proxy in der [Sandbox](/docs/de/sandboxing#troubleshooting) auf macOS überprüfen | Sandbox settings | Any file |

752| [`sandbox.filesystem.allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) | Verhindern Sie, dass Entwickler [Lesepfade, die Ihre Organisation blockiert hat,](/docs/de/sandboxing#keep-developers-from-widening-the-policy) erneut öffnen | Sandbox settings | Managed |763| [`sandbox.filesystem.allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) | Verhindern Sie, dass Entwickler [Lesepfade, die Ihre Organisation blockiert hat,](/docs/de/sandboxing#keep-developers-from-widening-the-policy) erneut öffnen | Sandbox settings | Managed |

757| [`sandbox.filesystem.disabled`](#sandbox-filesystem-disabled) | [Schalten Sie die Dateisystem-Isolation aus](/docs/de/sandboxing#disable-filesystem-isolation), während Sie die Netzwerk-Isolation beibehalten | Sandbox settings | User or managed |768| [`sandbox.filesystem.disabled`](#sandbox-filesystem-disabled) | [Schalten Sie die Dateisystem-Isolation aus](/docs/de/sandboxing#disable-filesystem-isolation), während Sie die Netzwerk-Isolation beibehalten | Sandbox settings | User or managed |

761| [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) | Genehmigen Sie Domänen im Voraus, damit [sandboxed](/docs/de/sandboxing)-Befehle nicht danach fragen | Sandbox settings | Any file |772| [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) | Genehmigen Sie Domänen im Voraus, damit [in der Sandbox](/docs/de/sandboxing) ausgeführte Befehle nicht danach fragen | Sandbox settings | Any file |

763| [`sandbox.network.allowMachLookup`](#sandbox-network-allowmachlookup) | Lassen Sie macOS-[sandboxed](/docs/de/sandboxing)-Tools wie den iOS Simulator oder Playwright ihre XPC-Dienste erreichen | Sandbox settings | Any file |774| [`sandbox.network.allowMachLookup`](#sandbox-network-allowmachlookup) | Lassen Sie macOS-Tools [in der Sandbox](/docs/de/sandboxing) wie den iOS Simulator oder Playwright ihre XPC-Dienste erreichen | Sandbox settings | Any file |

764| [`sandbox.network.allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) | Sperren Sie die Netzwerk-Zulassungsliste auf [verwaltete Einstellungen](/docs/de/sandboxing#keep-developers-from-widening-the-policy) | Sandbox settings | Managed |775| [`sandbox.network.allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) | Sperren Sie die Netzwerk-Allowlist auf [verwaltete Einstellungen](/docs/de/sandboxing#keep-developers-from-widening-the-policy) | Sandbox settings | Managed |

765| [`sandbox.network.allowUnixSockets`](#sandbox-network-allowunixsockets) | Listen Sie Unix-Socket-Pfade auf, die [sandboxed](/docs/de/sandboxing)-Befehle auf macOS verwenden können | Sandbox settings | Any file |776| [`sandbox.network.allowUnixSockets`](#sandbox-network-allowunixsockets) | Listen Sie Unix-Socket-Pfade auf, die [in der Sandbox](/docs/de/sandboxing) ausgeführte Befehle auf macOS verwenden können | Sandbox settings | Any file |

766| [`sandbox.network.deniedDomains`](#sandbox-network-denieddomains) | Blockieren Sie Domänen für [sandboxed](/docs/de/sandboxing)-Befehle, auch innerhalb eines zulässigen Wildcards | Sandbox settings | Any file |777| [`sandbox.network.deniedDomains`](#sandbox-network-denieddomains) | Blockieren Sie Domänen für [in der Sandbox](/docs/de/sandboxing) ausgeführte Befehle, auch innerhalb eines zulässigen Wildcards | Sandbox settings | Any file |

768| [`sandbox.network.socksProxyPort`](#sandbox-network-socksproxyport) | Leiten Sie [Sandbox](/docs/de/sandboxing#custom-proxy-configuration)-SOCKS-Verkehr durch Ihren eigenen Proxy | Sandbox settings | Any file |779| [`sandbox.network.socksProxyPort`](#sandbox-network-socksproxyport) | Leiten Sie [Sandbox](/docs/de/sandboxing#custom-proxy-configuration)-SOCKS-Verkehr durch Ihren eigenen Proxy | Sandbox settings | Any file |

769| [`sandbox.network.strictAllowlist`](#sandbox-network-strictallowlist) | Lehnen Sie Hosts außerhalb der [Zulassungsliste](/docs/de/sandboxing#network-isolation) ab, anstatt zu fragen | Sandbox settings | User or managed |780| [`sandbox.network.strictAllowlist`](#sandbox-network-strictallowlist) | Lehnen Sie Hosts außerhalb der [Allowlist](/docs/de/sandboxing#network-isolation) ab, anstatt zu fragen | Sandbox settings | User or managed |

770| [`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) | Lassen Sie die [Sandbox](/docs/de/sandboxing#network-isolation) TLS beenden, damit sie HTTPS-Anfragen lesen kann | Sandbox settings | User or managed |781| [`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) | Lassen Sie den [Sandbox](/docs/de/sandboxing#network-isolation)-Proxy TLS terminieren, damit er HTTPS-Anfragen lesen kann | Sandbox settings | User or managed |

773| [`showClearContextOnPlanAccept`](#showclearcontextonplanaccept) | Zeigen Sie eine "Kontext löschen"-Option auf dem [Plan-Akzeptanzbildschirm](/docs/de/permission-modes#review-and-approve-a-plan) | Interface and terminal | Any file |784| [`showClearContextOnPlanAccept`](#showclearcontextonplanaccept) | Zeigen Sie eine "Kontext löschen"-Option auf dem [Plan-Akzeptanzbildschirm](/docs/de/permission-modes#review-and-approve-a-plan) | Interface and terminal | Any file |

774| [`showThinkingSummaries`](#showthinkingsummaries) | Sehen Sie Zusammenfassungen von Claudes [Denken](/docs/de/model-config#extended-thinking) statt eines zusammengeklappten Stubs | Model and responses | Any file |785| [`showThinkingSummaries`](#showthinkingsummaries) | Sehen Sie Zusammenfassungen von Claudes [Thinking](/docs/de/model-config#extended-thinking) statt eines zusammengeklappten Stubs | Model and responses | Any file |

776| [`skillListingBudgetFraction`](#skilllistingbudgetfraction) | Reservieren Sie mehr oder weniger Kontext für die [Skill-Auflistung](/docs/de/skills#skill-descriptions-are-cut-short) | Memory and context | Any file |787| [`skillListingBudgetFraction`](#skilllistingbudgetfraction) | Reservieren Sie mehr oder weniger Kontext für die [Skill-Auflistung](/docs/de/skills#skill-descriptions-are-cut-short) | Memory and context | Any file |

777| [`skillListingMaxDescChars`](#skilllistingmaxdescchars) | Begrenzen Sie die Beschreibungslänge jedes Skills in der [Skill-Auflistung](/docs/de/skills#skill-descriptions-are-cut-short) | Memory and context | Any file |788| [`skillListingMaxDescChars`](#skilllistingmaxdescchars) | Begrenzen Sie die Beschreibungslänge jedes Skills in der [Skill-Auflistung](/docs/de/skills#skill-descriptions-are-cut-short) | Memory and context | Any file |

782| [`spellcheck`](#spellcheck) | Unterstreichen Sie falsch geschriebene Wörter in der Eingabeaufforderung mit einem [Rechtschreibprüfer](/docs/de/interactive-mode#check-spelling-as-you-type), den Sie installieren | Interface and terminal | User or managed |793| [`spellcheck`](#spellcheck) | Unterstreichen Sie falsch geschriebene Wörter in der Eingabeaufforderung mit einem [Rechtschreibprüfer](/docs/de/interactive-mode#check-spelling-as-you-type), den Sie installieren | Interface and terminal | User or managed |

786| [`sshConfigs`](#sshconfigs) | Fügen Sie [SSH-Verbindungen](/docs/de/desktop#pre-configure-ssh-connections-for-your-team) zum Desktop-Umgebungs-Dropdown hinzu | Remote, desktop, and notifications | User or managed |797| [`sshConfigs`](#sshconfigs) | Fügen Sie [SSH-Verbindungen](/docs/de/desktop#pre-configure-ssh-connections-for-your-team) zum Desktop-Umgebungs-Dropdown hinzu | Remote, desktop, and notifications | User or managed |

787| [`sshHostAllowlist`](#sshhostallowlist) | Begrenzen Sie, welche Hosts [Desktop-SSH-Sitzungen](/docs/de/desktop#restrict-which-ssh-hosts-users-can-connect-to) erreichen können | Remote, desktop, and notifications | Managed |798| [`sshHostAllowlist`](#sshhostallowlist) | Begrenzen Sie, welche Hosts [Desktop-SSH-Sitzungen](/docs/de/desktop#restrict-which-ssh-hosts-users-can-connect-to) erreichen können | Remote, desktop, and notifications | Managed |

789| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Zulassungsliste der [Marketplace](/docs/de/plugins/overview)-Quellen, die Benutzer hinzufügen und installieren können | Plugins and skills | Managed |800| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Allowlist der [Marketplace](/docs/de/plugins/overview)-Quellen, die Benutzer hinzufügen und aus denen sie installieren können | Plugins and skills | Managed |

790| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Blockieren Sie [Skills](/docs/de/skills), [Agenten](/docs/de/sub-agents), [Hooks](/docs/de/hooks) und [MCP-Server](/docs/de/mcp) aus Benutzer- und Projektquellen | Plugins and skills | Managed |801| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Blockieren Sie [Skills](/docs/de/skills), [Agenten](/docs/de/sub-agents), [Hooks](/docs/de/hooks) und [MCP-Server](/docs/de/mcp) aus Benutzer- und Projektquellen | Plugins and skills | Managed |

795| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Wählen Sie die [Prompt-Cache-Lebensdauer](/docs/de/prompt-caching#cache-lifetime) für Subagenten und andere Anfragen außerhalb der Hauptkonversation | Model and responses | Any file |806| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Wählen Sie die [Prompt-Cache-Lebensdauer](/docs/de/prompt-caching#cache-lifetime) für Subagenten und andere Anfragen außerhalb der Hauptkonversation | Model and responses | Any file |

797| [`switchModelsOnFlag`](#switchmodelsonflag) | Wechseln Sie Modelle automatisch oder pausieren Sie, wenn ein [Sicherheitsklassifizierer](/docs/de/model-config#ask-before-switching) eine Anfrage kennzeichnet | Model and responses | Any file |808| [`switchModelsOnFlag`](#switchmodelsonflag) | Wechseln Sie Modelle automatisch oder pausieren Sie, wenn ein [Sicherheitsklassifikator](/docs/de/model-config#ask-before-switching) eine Anfrage kennzeichnet | Model and responses | Any file |

798| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | Beenden Sie das Laden der [auf Ihrem claude.ai-Konto aktivierten Plugins](/docs/de/plugins/overview) und beenden Sie das Herunterladen neuer | Plugins and skills | User, local, or managed |809| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | Beenden Sie das Laden der [auf Ihrem claude.ai-Konto aktivierten Plugins](/docs/de/plugins/loading#synced-plugins) und beenden Sie das Herunterladen neuer | Plugins and skills | User, local, or managed |

799| [`syncClaudeAiSkills`](#syncclaudeaiskills) | Beenden Sie das Laden der [auf Ihrem claude.ai-Konto aktivierten Skills](/docs/de/skills#how-synced-skills-behave) und beenden Sie das Herunterladen neuer | Plugins and skills | User, local, or managed |810| [`syncClaudeAiSkills`](#syncclaudeaiskills) | Beenden Sie das Laden der [auf Ihrem claude.ai-Konto aktivierten Skills](/docs/de/skills#how-synced-skills-behave) und beenden Sie das Herunterladen neuer | Plugins and skills | User, local, or managed |

810| [`ultracode`](#ultracode) | Lassen Sie Claude einen [Workflow](/docs/de/workflows#let-claude-decide-with-ultracode) für jede wesentliche Aufgabe planen, ohne gefragt zu werden | Model and responses | Any file |821| [`ultracode`](#ultracode) | Lassen Sie Claude einen [Workflow](/docs/de/workflows#let-claude-decide-with-ultracode) für jede wesentliche Aufgabe planen, ohne gefragt zu werden | Model and responses | Any file |

811| [`useAutoModeDuringPlan`](#useautomodeduringplan) | Lassen Sie den [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)-Klassifizierer Shell-Befehle im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) überprüfen; setzen Sie `false`, um stattdessen Aufforderungen zu erhalten | Permission settings | User, local, or managed |822| [`useAutoModeDuringPlan`](#useautomodeduringplan) | Lassen Sie den [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)-Klassifikator Shell-Befehle im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) überprüfen; setzen Sie `false`, um stattdessen Berechtigungsabfragen zu erhalten | Permission settings | User, local, or managed |

812| [`verbose`](#verbose) | Zeigen Sie [vollständige Tool-Ausgabe](/docs/de/cli-reference#cli-flags) statt verkürzter Zusammenfassungen an; `viewMode` hat Vorrang, wenn beide gesetzt sind | Interface and terminal | Any file |823| [`verbose`](#verbose) | Zeigen Sie [vollständige Tool-Ausgabe](/docs/de/cli-reference#cli-flags) statt verkürzter Zusammenfassungen an; `viewMode` hat Vorrang, wenn beide gesetzt sind | Interface and terminal | Any file |

814| [`vimInsertModeRemaps`](#viminsertmoderemaps) | Ordnen Sie eine zwei-Tasten-[INSERT-Modus-Sequenz](/docs/de/interactive-mode#remap-insert-mode-key-sequences) wie `jj` zu Escape | Interface and terminal | User or managed |825| [`vimInsertModeRemaps`](#viminsertmoderemaps) | Ordnen Sie eine zwei-Tasten-[INSERT-Modus-Sequenz](/docs/de/interactive-mode#remap-insert-mode-key-sequences) wie `jj` zu Escape | Interface and terminal | User or managed |

817| [`wheelScrollAccelerationEnabled`](#wheelscrollaccelerationenabled) | Schalten Sie die [Mausrad-Beschleunigung](/docs/de/fullscreen#mouse-wheel-scrolling) beim Vollbild-Rendering aus | Interface and terminal | Any file |828| [`wheelScrollAccelerationEnabled`](#wheelscrollaccelerationenabled) | Schalten Sie die [Mausrad-Beschleunigung](/docs/de/fullscreen#mouse-wheel-scrolling) beim Vollbild-Rendering aus | Interface and terminal | Any file |

818| [`workflowKeywordTriggerEnabled`](#workflowkeywordtriggerenabled) | Lassen Sie das Wort `ultracode` in einer Eingabeaufforderung einen [Workflow](/docs/de/workflows) starten; setzen Sie `false`, um es einzugeben, ohne einen zu starten | Hooks and automation | Any file |829| [`workflowKeywordTriggerEnabled`](#workflowkeywordtriggerenabled) | Lassen Sie das Wort `ultracode` in einem Prompt einen [Workflow](/docs/de/workflows) starten; setzen Sie `false`, um es einzugeben, ohne einen zu starten | Hooks and automation | Any file |

834 `advisorModel`845 `advisorModel`

835</h3>846</h3>

836 847

837Wählen Sie, welches Modell antwortet, wenn Claude das serverseitige [Advisor-Tool](/docs/de/advisor) aufruft. Deaktivieren Sie es, um den Advisor auszuschalten. Der Advisor muss mindestens so leistungsfähig sein wie Ihr Hauptmodell. Informationen zu akzeptierten Kombinationen und was passiert, wenn Sie eine nicht akzeptierte Kombination wählen, finden Sie unter [Wählen Sie ein Advisor-Modell](/docs/de/advisor#choose-an-advisor-model).848Wählen Sie, welches Modell antwortet, wenn Claude das serverseitige [Advisor-Tool](/docs/de/advisor) aufruft. Entfernen Sie den Wert, um den Advisor auszuschalten. Der Advisor muss mindestens so leistungsfähig sein wie Ihr Hauptmodell. Informationen zu akzeptierten Kombinationen und was passiert, wenn Sie eine nicht akzeptierte Kombination wählen, finden Sie unter [Wählen Sie ein Advisor-Modell](/docs/de/advisor#choose-an-advisor-model).

838 849

839Sie bearbeiten diesen Schlüssel normalerweise nicht manuell. Führen Sie `/advisor` aus, um eine Auswahl zu öffnen, die die aktuelle Auswahl, die Modelle, die beraten können, und **Kein Advisor** anzeigt. Claude Code speichert Ihre Auswahl in diesem Schlüssel in `~/.claude/settings.json`. Wenn Sie aus einem [Remote Control](/docs/de/remote-control)-Client oder in einer Sitzung auswählen, die an einen Remote Worker angehängt ist, gilt die Auswahl nur für diese Sitzung und ändert diesen Schlüssel nicht.850Sie bearbeiten diesen Schlüssel normalerweise nicht manuell. Führen Sie `/advisor` aus, um eine Auswahl zu öffnen, die die aktuelle Auswahl, die Modelle, die beraten können, und **Kein Advisor** anzeigt. Claude Code speichert Ihre Auswahl in diesem Schlüssel in `~/.claude/settings.json`. Wenn Sie aus einem [Remote Control](/docs/de/remote-control)-Client oder in einer Sitzung auswählen, die an einen Remote Worker angehängt ist, gilt die Auswahl nur für diese Sitzung und ändert diesen Schlüssel nicht.

840 851

841Wenn Ihr Konto die [Zustimmung zu Nutzungsguthaben](/docs/de/advisor#fable-advisor-and-usage-credits) erfordert, akzeptieren Sie diese zuerst, indem Sie `/model fable` ausführen. Bis dahin speichert die Auswahl von Fable in `/advisor` nichts und Claude Code teilt Ihnen mit, dass Sie zuerst `/model fable` ausführen sollen.852Wenn Ihr Konto die [Zustimmung zu Nutzungsguthaben](/docs/de/advisor#fable-advisor-and-usage-credits) erfordert, akzeptieren Sie diese zuerst, indem Sie `/model fable` ausführen. Bis dahin speichert die Auswahl von Fable in `/advisor` nichts und Claude Code teilt Ihnen mit, dass Sie zuerst `/model fable` ausführen sollen.

842 853

843* **Bereich**: [`Beliebige Datei`](#scopes)854* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

844* **Typ**: String, einer der Aliase `"fable"`, `"opus"` oder `"sonnet"`, die in die aktuelle Standardversion dieser Modellfamilie von Claude Code aufgelöst werden, oder eine vollständige Modell-ID wie `"claude-opus-5-5"`855* **Typ**: String, einer der Aliase `"fable"`, `"opus"` oder `"sonnet"`, die in die aktuelle Standardversion dieser Modellfamilie von Claude Code aufgelöst werden, oder eine vollständige Modell-ID wie `"claude-opus-5-5"`

845* **Standard**: nicht gesetzt, daher ist der Advisor ausgeschaltet856* **Standard**: nicht gesetzt, daher ist der Advisor ausgeschaltet

846* **Sitzungsübergreifende Außerkraftsetzungen**: `--advisor` hat Vorrang vor diesem Schlüssel für eine Sitzung. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/de/env-vars) schaltet den Advisor aus, und dieser Schlüssel kann ihn nicht wieder einschalten857* **Überschreibungen pro Sitzung**: `--advisor` hat für eine Sitzung Vorrang vor diesem Schlüssel. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/de/env-vars) schaltet den Advisor aus, und dieser Schlüssel kann ihn nicht wieder einschalten

847 858

848```json settings.json theme={null}859```json settings.json theme={null}

849{860{

857 `alwaysThinkingEnabled`868 `alwaysThinkingEnabled`

858</h3>869</h3>

859 870

860Deaktivieren Sie [erweitertes Denken](/docs/de/model-config#extended-thinking) für jede Sitzung, indem Sie dies auf `false` setzen. Das Denken ist standardmäßig aktiviert, daher ändert `true` nichts. Die meisten Benutzer stellen dies über `/config` ein, anstatt die Datei zu bearbeiten.871Deaktivieren Sie [Extended Thinking](/docs/de/model-config#extended-thinking) für jede Sitzung, indem Sie dies auf `false` setzen. Thinking ist standardmäßig aktiviert, daher ändert `true` nichts. Die meisten Benutzer stellen dies über `/config` ein, anstatt die Datei zu bearbeiten.

861 872

862Bei Modellen, die immer denken, wie Opus 5.5 und die Fable-Modelle, hat `false` keine Auswirkung. Bei [Drittanbieter-Providern](/docs/de/third-party-integrations) lässt Claude Code den Parameter `thinking` weg, anstatt das Denken auszuschalten, daher können adaptive Reasoning-Modelle möglicherweise noch denken. Wenn das Denken auf der Anthropic API ausgeschaltet ist, sendet Claude Code stattdessen `high` Aufwand an Modelle, die [diese Kombination nicht akzeptieren](/docs/de/errors#effort-isnt-available-with-thinking-turned-off), wie Opus 5.873Bei Modellen, die immer nachdenken, wie Opus 5.5, Sonnet 5.5 und die Fable-Modelle, hat `false` keine Auswirkung. Bei [Drittanbieter-Providern](/docs/de/third-party-integrations) lässt Claude Code den Parameter `thinking` weg, anstatt Thinking auszuschalten, daher können Modelle mit adaptivem Reasoning möglicherweise trotzdem nachdenken. Wenn Thinking auf der Anthropic API ausgeschaltet ist, sendet Claude Code den Effort `high` statt einer höheren Stufe an Modelle, von denen es weiß, dass sie [diese Kombination nicht akzeptieren](/docs/de/errors#effort-isnt-available-with-thinking-turned-off), wie Opus 5.

863 874

864* **Bereich**: [`Beliebige Datei`](#scopes)875* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

865* **Typ**: Boolean876* **Typ**: Boolean

866 * `true`: keine Auswirkung; das Denken ist bereits aktiviert877 * `true`: keine Auswirkung; Thinking ist bereits aktiviert

867 * `false`: Claude Code deaktiviert erweitertes Denken für jede Sitzung878 * `false`: Claude Code deaktiviert Extended Thinking für jede Sitzung

868* **Standard**: nicht gesetzt, daher ist das Denken für Modelle aktiviert, die es unterstützen879* **Standard**: nicht gesetzt, daher ist Thinking für Modelle aktiviert, die es unterstützen

869* **Sitzungsübergreifende Außerkraftsetzungen**: [`MAX_THINKING_TOKENS`](/docs/de/env-vars) hat Vorrang vor diesem Schlüssel für eine Sitzung: `0` deaktiviert das Denken unter den gleichen Modell- und Provider-Einschränkungen wie `false`, und ein positiver Wert aktiviert das Denken auch wenn dieser Schlüssel `false` ist. Bei adaptive-reasoning-Modellen wird die Zahl selbst ignoriert880* **Überschreibungen pro Sitzung**: [`MAX_THINKING_TOKENS`](/docs/de/env-vars) hat für eine Sitzung Vorrang vor diesem Schlüssel: `0` deaktiviert Thinking unter den gleichen Modell- und Provider-Einschränkungen wie `false`, und ein positiver Wert aktiviert Thinking, auch wenn dieser Schlüssel `false` ist. Bei Modellen mit adaptivem Reasoning wird die Zahl selbst ignoriert

870 881

871```json settings.json theme={null}882```json settings.json theme={null}

872{883{

878 `availableModels`889 `availableModels`

879</h3>890</h3>

880 891

881Beschränken Sie, welche Modelle Personen für die Hauptsitzung, [Subagents](/docs/de/sub-agents), [Skills](/docs/de/skills) und den [Advisor](/docs/de/advisor) auswählen können. Eine verwaltete Liste beschränkt `/model`, `--model` und den Schlüssel `model` in den eigenen Dateien eines Entwicklers; ein Modell außerhalb davon kann nicht ausgewählt werden. Dies berührt die Option Standard nicht; kombinieren Sie es mit [`enforceAvailableModels`](#enforceavailablemodels), um das zu tun.892Beschränken Sie, welche Modelle Personen für die Hauptsitzung, [Subagenten](/docs/de/sub-agents), [Skills](/docs/de/skills) und den [Advisor](/docs/de/advisor) auswählen können. Eine verwaltete Liste beschränkt `/model`, `--model` und den Schlüssel `model` in den eigenen Dateien eines Entwicklers; ein Modell außerhalb davon kann nicht ausgewählt werden. Mit dem standardmäßigen Präfixabgleich berührt dies die Option Standard allein nicht; kombinieren Sie es dafür mit [`enforceAvailableModels`](#enforceavailablemodels).

882 893

883* **Bereich**: [`Beliebige Datei`](#scopes). Stellen Sie es in verwalteten Einstellungen bereit, um es für eine Organisation durchzusetzen.894* **Geltungsbereich**: [`Beliebige Datei`](#scopes). Stellen Sie es in verwalteten Einstellungen bereit, um es für eine Organisation durchzusetzen.

884* **Typ**: Array von Modellaliasen oder IDs895* **Typ**: Array von Modellaliasen oder IDs

885* **Standard**: nicht gesetzt, daher sind alle Modelle verfügbar896* **Standard**: nicht gesetzt, daher sind alle Modelle verfügbar

886 897

892}903}

893```904```

894 905

895Siehe [Modellauswahl einschränken](/docs/de/model-config#restrict-model-selection).906Ein Modell-ID-Eintrag wie `"claude-opus-5"` erlaubt auch spätere Versionen, die ihn erweitern, wie Opus 5.5. Um eine dieser Versionen zu blockieren, verwenden Sie [`deniedModels`](#deniedmodels). Damit jeder Modell-ID-Eintrag nur die genannte Version erlaubt, verwenden Sie [`availableModelsMatch`](#availablemodelsmatch). Siehe [Modellauswahl einschränken](/docs/de/model-config#restrict-model-selection).

907

908<h3 id="availablemodelsmatch">

909 `availableModelsMatch`

910</h3>

911

912Legen Sie fest, wie Einträge in [`availableModels`](#availablemodels) mit Modell-IDs abgeglichen werden. Standardmäßig erlaubt ein Modell-ID-Eintrag auch spätere Versionen, die ihn erweitern, sodass `"claude-opus-5"` Opus 5.5 erlaubt. Mit `"exact"` erlaubt jeder Modell-ID-Eintrag nur die genannte Version, sodass eine neuere Version dieses Modells blockiert bleibt, bis Sie sie auflisten. Erfordert Claude Code v2.1.283 oder später.

913

914* **Geltungsbereich**: [`Verwaltet`](#scopes). Claude Code ignoriert den Schlüssel in Benutzer-, Projekt- und lokalen Einstellungen sowie in `--settings` mit einer Warnung

915* **Typ**: String, einer von:

916 * `"prefix"`: ein Modell-ID-Eintrag erlaubt seine Version und jede Modell-ID, die ihn um ein weiteres Segment erweitert

917 * `"exact"`: ein Modell-ID-Eintrag erlaubt nur die genannte Version, einschließlich der datierten IDs dieser Version, sodass `"claude-opus-5"` Opus 5 erlaubt, aber nicht `claude-opus-5-5`. Ein Familienalias wie `"opus"` erlaubt weiterhin die gesamte Familie, und Einträge `best`, `opusplan` und `default` werden ignoriert

918* **Standard**: `"prefix"`

919

920Dieses Beispiel erlaubt Opus 5 und Sonnet 5, aber keine spätere Version eines der beiden:

921

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

923{

924 "availableModels": ["claude-opus-5", "claude-sonnet-5"],

925 "availableModelsMatch": "exact"

926}

927```

928

929Mit `"exact"` ist auch die Option Standard auf die aufgelisteten Modelle beschränkt, sobald die Liste mindestens ein Modell oder eine Familie nennt. Siehe [Bestimmte Modelle oder Versionen blockieren](/docs/de/model-config#block-specific-models-or-versions).

930

931<h3 id="deniedmodels">

932 `deniedModels`

933</h3>

934

935Blockieren Sie bestimmte Modelle, mit oder ohne [`availableModels`](#availablemodels)-Allowlist und selbst dann, wenn diese Liste sie erlaubt. Claude Code blendet ein blockiertes Modell in der Auswahl `/model` aus, und das Modell kann nirgends ausgewählt werden, wo `availableModels` durchgesetzt wird. Eine Sitzung mit der Option Standard führt ein blockiertes Modell ebenfalls nicht aus, wie unter [Bestimmte Modelle oder Versionen blockieren](/docs/de/model-config#block-specific-models-or-versions) beschrieben. Erfordert Claude Code v2.1.283 oder später.

936

937* **Geltungsbereich**: [`Verwaltet`](#scopes). Claude Code ignoriert den Schlüssel in Benutzer-, Projekt- und lokalen Einstellungen sowie in `--settings` mit einer Warnung

938* **Typ**: Array von Modellaliasen oder IDs

939 * Ein Familienalias wie `"opus"` blockiert jedes Modell dieser Familie

940 * Eine Modell-ID wie `"claude-opus-5-5"` blockiert diese Version in jeder Schreibweise, einschließlich datierter und providerspezifischer IDs

941 * Eine Modell-ID ohne Nebenversion, wie `"claude-opus-5"`, blockiert auch spätere Nebenversionen wie Opus 5.5. Schreiben Sie `"claude-opus-5-0"`, um nur Opus 5 zu blockieren

942 * Einträge `best`, `opusplan` und `default` werden ignoriert

943* **Standard**: nicht gesetzt, daher ist kein Modell blockiert

944

945Dieses Beispiel erlaubt Opus- und Sonnet-Modelle und blockiert Opus 5.5:

946

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

948{

949 "availableModels": ["opus", "sonnet"],

950 "deniedModels": ["claude-opus-5-5"]

951}

952```

953

954Siehe [Bestimmte Modelle oder Versionen blockieren](/docs/de/model-config#block-specific-models-or-versions).

896 955

897<h3 id="effortlevel">956<h3 id="effortlevel">

898 `effortLevel`957 `effortLevel`

899</h3>958</h3>

900 959

901Legen Sie eine Standard-[Aufwandsebene](/docs/de/model-config#adjust-effort-level) für Modelle fest, für die Sie noch keine Ebene gespeichert haben. Niedrigere Ebenen sind schneller und günstiger bei einfachen Aufgaben, höhere Ebenen denken tiefer über komplexe Probleme nach.960Legen Sie eine Standard-[Effort-Stufe](/docs/de/model-config#adjust-effort-level) für Modelle fest, für die Sie noch keine Stufe gespeichert haben. Niedrigere Stufen sind bei einfachen Aufgaben schneller und günstiger, höhere Stufen denken bei komplexen Problemen gründlicher nach.

902 961

903Wenn Sie `/effort low`, `medium`, `high` oder `xhigh` in einer interaktiven Sitzung auf Ihrem Computer ausführen, speichert Claude Code die Ebene für das aktive Modell unter [`modelSettings`](#modelsettings) anstatt diesen Schlüssel zu schreiben. Vor v2.1.251 schrieb `/effort` diesen Schlüssel.962Wenn Sie `/effort low`, `medium`, `high` oder `xhigh` in einer interaktiven Sitzung auf Ihrem Computer ausführen, speichert Claude Code die Stufe für das aktive Modell unter [`modelSettings`](#modelsettings), anstatt diesen Schlüssel zu schreiben. Vor v2.1.251 schrieb `/effort` diesen Schlüssel.

904 963

905Innerhalb derselben Einstellungsdatei verwendet Claude Code die gespeicherte Ebene eines Modells anstatt dieses Schlüssels. [`modelSettings`](#modelsettings) gibt die dateiübergreifende Priorität an.964Innerhalb derselben Einstellungsdatei verwendet Claude Code die gespeicherte Stufe eines Modells anstelle dieses Schlüssels. [`modelSettings`](#modelsettings) beschreibt die dateiübergreifende Rangfolge.

906 965

907In einer Sitzung, die an einen Remote Worker angehängt ist, in einem `-p`-Lauf und im Agent SDK gilt `/effort` nur für diese Sitzung. [Aufwandsebene anpassen](/docs/de/model-config#adjust-effort-level) listet die interaktiven Auswahlmöglichkeiten auf, die auch nur für diese Sitzung gelten. Die Nachricht, die `/effort` ausgibt, sagt, was passiert ist.966In einer Sitzung, die an einen Remote Worker angehängt ist, in einem `-p`-Lauf und im Agent SDK gilt `/effort` nur für diese Sitzung. [Effort-Stufe anpassen](/docs/de/model-config#adjust-effort-level) listet die interaktiven Auswahlmöglichkeiten auf, die ebenfalls nur für diese Sitzung gelten. Die Meldung, die `/effort` ausgibt, sagt, was passiert ist.

908 967

909* **Bereich**: [`Beliebige Datei`](#scopes)968* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

910* **Typ**: String, einer von:969* **Typ**: String, einer von:

911 * `"low"`: das geringste Denken, für kurze, begrenzte, latenzempfindliche Aufgaben, die nicht intelligenzempfindlich sind970 * `"low"`: das geringste Reasoning, für kurze, klar umrissene, latenzempfindliche Aufgaben, die keine hohe Intelligenz erfordern

912 * `"medium"`: reduziert die Token-Nutzung für kostensensitive Arbeiten, die etwas Intelligenz opfern können971 * `"medium"`: reduziert die Token-Nutzung für kostensensitive Arbeiten, die etwas Intelligenz opfern können

913 * `"high"`: balanciert Token-Nutzung und Intelligenz972 * `"high"`: balanciert Token-Nutzung und Intelligenz

914 * `"xhigh"`: tieferes Denken bei höheren Token-Ausgaben973 * `"xhigh"`: tieferes Reasoning bei höherem Token-Verbrauch

915* **Standard**: nicht gesetzt974* **Standard**: nicht gesetzt

916* **Sitzungsübergreifende Außerkraftsetzungen**: `--effort` hat Vorrang vor diesem Schlüssel für eine Sitzung, und [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/de/env-vars) hat Vorrang vor beiden975* **Überschreibungen pro Sitzung**: `--effort` hat für eine Sitzung Vorrang vor diesem Schlüssel, und [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/de/env-vars) hat Vorrang vor beiden

917 976

918```json settings.json theme={null}977```json settings.json theme={null}

919{978{

921}980}

922```981```

923 982

924In Ihrer Benutzereinstellungsdatei `~/.claude/settings.json` ist dieser Schlüssel die ältere Form, die `/effort` vor dem Speichern von Ebenen pro Modell schrieb, und er wird weiterhin dort angewendet, wo er zuvor angewendet wurde, auf Opus 5, Fable 5.1 und früheren Modellen. Opus 5.5 und später veröffentlichte Modelle ignorieren ihn und beginnen mit ihrem eigenen Standard, bis Sie eine Ebene für sie speichern, die `/effort` unter [`modelSettings`](#modelsettings) schreibt. In Projekt-, Lokal- und verwalteten Einstellungen sowie mit `--settings` gilt dieser Schlüssel für jedes Modell.983In Ihrer Benutzereinstellungsdatei `~/.claude/settings.json` ist dieser Schlüssel die ältere Form, die `/effort` schrieb, bevor Stufen pro Modell gespeichert wurden, und er gilt weiterhin dort, wo er zuvor galt: für Opus 5, Fable 5.1 und frühere Modelle. Opus 5.5 und später veröffentlichte Modelle ignorieren ihn und beginnen mit ihrem eigenen Standard, bis Sie eine Stufe für sie speichern, die `/effort` unter [`modelSettings`](#modelsettings) schreibt. In Projekt-, lokalen und verwalteten Einstellungen sowie mit `--settings` gilt dieser Schlüssel für jedes Modell.

925 984

926<h3 id="enforceavailablemodels">985<h3 id="enforceavailablemodels">

927 `enforceAvailableModels`986 `enforceAvailableModels`

928</h3>987</h3>

929 988

930Die Auswahl `/model` hat eine Option **Standard**, die sich zu Ihrem [Organisations-Standardmodell](/docs/de/model-config#organization-default-model) auflöst, wenn eine gilt, und ansonsten zu Ihrem Kontotyp-Standard. Eine [`availableModels`](#availablemodels)-Zulassungsliste beschränkt die Modelle, die Sie benennen können, aber sie lässt **Standard** allein, daher kann **Standard** sich immer noch zu einem Modell außerhalb der Liste auflösen. Dieser Schlüssel schließt diese Lücke. Erfordert Claude Code v2.1.175 oder später.989Die Auswahl `/model` hat eine Option **Standard**, und unter [Einstellung des Modells `default`](/docs/de/model-config#default-model-setting) ist beschrieben, zu welchem Modell sie aufgelöst wird. Eine [`availableModels`](#availablemodels)-Allowlist beschränkt die Modelle, die Sie benennen können, aber mit dem standardmäßigen [Präfixabgleich](#availablemodelsmatch) ordnet sie den Standard Ihres Kontotyps nicht neu zu, sodass **Standard** immer noch zu einem Modell außerhalb der Liste aufgelöst werden kann. Dieser Schlüssel schließt diese Lücke. Erfordert Claude Code v2.1.175 oder später.

931 990

932Wenn Ihre Organisation verwaltete Einstellungen bereitstellt, liest Claude Code diesen Schlüssel nur aus der verwalteten Quelle und ignoriert ihn in Ihren anderen Dateien.991Wenn Ihre Organisation verwaltete Einstellungen bereitstellt, liest Claude Code diesen Schlüssel nur aus der verwalteten Quelle und ignoriert ihn in Ihren anderen Dateien.

933 992

934* **Bereich**: [`Beliebige Datei`](#scopes)993* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

935* **Typ**: Boolean994* **Typ**: Boolean

936 * `true`: wenn sich **Standard** zu einem Modell außerhalb von `availableModels` auflösen würde, löst Claude Code es zum ersten verfügbaren Modell in der Liste auf995 * `true`: wenn **Standard** zu einem Modell außerhalb von `availableModels` aufgelöst würde, löst Claude Code es stattdessen zum ersten verfügbaren Modell in der Liste auf

937 * `false`: **Standard** löst sich wie gewohnt auf, auch zu einem Modell außerhalb von `availableModels`996 * `false`: dieser Schlüssel ändert nicht, wie **Standard** aufgelöst wird

938* **Standard**: `false`997* **Standard**: `false`

939 998

940Dieses Beispiel beschränkt benannte Auswahlmöglichkeiten auf Sonnet- und Haiku-Modelle und lässt **Standard** sich zum ersten verfügbaren Modell auflösen:999Dieses Beispiel beschränkt benannte Auswahlmöglichkeiten auf Sonnet- und Haiku-Modelle und lässt **Standard** zum ersten verfügbaren dieser Modelle auflösen:

941 1000

942```json settings.json theme={null}1001```json settings.json theme={null}

943{1002{

946}1005}

947```1006```

948 1007

949Dieser Schlüssel hat keine Auswirkung, wenn `availableModels` nicht gesetzt oder leer ist. Siehe [Zulassungsliste für das Standardmodell durchsetzen](/docs/de/model-config#enforce-the-allowlist-for-the-default-model). Erfordert Claude Code v2.1.175 oder später.1008Dieser Schlüssel hat keine Auswirkung, wenn `availableModels` nicht gesetzt oder leer ist. Siehe [Allowlist für das Standardmodell durchsetzen](/docs/de/model-config#enforce-the-allowlist-for-the-default-model). Erfordert Claude Code v2.1.175 oder später.

950 1009

951<h3 id="fallbackmodel">1010<h3 id="fallbackmodel">

952 `fallbackModel`1011 `fallbackModel`

953</h3>1012</h3>

954 1013

955Benennen Sie Backup-Modelle, die Claude Code der Reihe nach versuchen soll, wenn Ihr primäres Modell überlastet oder nicht verfügbar ist. Claude Code wechselt zum nächsten verfügbaren Modell in der Kette für den Rest des Durchlaufs und zeigt eine Benachrichtigung an. Ohne eine Kette versucht Claude Code das gleiche Modell erneut und zeigt dann den Fehler des Servers an, und Sie versuchen es erneut oder wechseln Modelle selbst.1014Benennen Sie Backup-Modelle, die Claude Code der Reihe nach versuchen soll, wenn Ihr primäres Modell überlastet oder nicht verfügbar ist. Claude Code wechselt für den Rest des Turns zum nächsten verfügbaren Modell in der Kette und zeigt einen Hinweis an. Ohne eine Kette versucht Claude Code dasselbe Modell erneut und zeigt dann den Fehler des Servers an, und Sie versuchen es selbst erneut oder wechseln das Modell.

956 1015

957Ein Wechsel bedeutet einen Durchlauf mit einem kalten [Prompt-Cache](/docs/de/prompt-caching#switching-models) auf dem Fallback-Modell; Ihre nächste Nachricht versucht zuerst das primäre Modell erneut.1016Ein Wechsel bedeutet einen Turn mit einem kalten [Prompt-Cache](/docs/de/prompt-caching#switching-models) auf dem Fallback-Modell; Ihre nächste Nachricht versucht zuerst wieder das primäre Modell.

958 1017

959* **Bereich**: [`Beliebige Datei`](#scopes)1018* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

960* **Typ**: Array von Modellaliasen oder IDs; `"default"` wird zum Standardmodell erweitert1019* **Typ**: Array von Modellaliasen oder IDs; `"default"` wird zum Standardmodell erweitert

961* **Standard**: nicht gesetzt, daher wird eine fehlgeschlagene Anfrage nicht auf einem anderen Modell erneut versucht1020* **Standard**: nicht gesetzt, daher wird eine fehlgeschlagene Anfrage nicht mit einem anderen Modell erneut versucht

962* **Sitzungsübergreifende Außerkraftsetzungen**: `--fallback-model` hat Vorrang vor diesem Schlüssel für eine Sitzung1021* **Überschreibungen pro Sitzung**: `--fallback-model` hat für eine Sitzung Vorrang vor diesem Schlüssel

963 1022

964Dieses Beispiel versucht zuerst Sonnet 5, dann Haiku 4.5, wenn Ihr primäres Modell fehlschlägt:1023Dieses Beispiel versucht zuerst Sonnet 5, dann Haiku 4.5, wenn Ihr primäres Modell fehlschlägt:

965 1024

969}1028}

970```1029```

971 1030

972Im Gegensatz zu den meisten Array-Einstellungen wird dieser Schlüssel nicht über Einstellungsdateien hinweg zusammengeführt: die höchste Prioritätsdatei, die ihn definiert, liefert die ganze Kette. Wenn Ihre Projektdatei `["claude-sonnet-5"]` setzt und Ihre Benutzerdatei `["claude-haiku-4-5"]` setzt, ist die Kette nur `["claude-sonnet-5"]`. Claude Code behält höchstens drei unterschiedliche zulässige Modelle aus der Liste und ignoriert den Rest. Siehe [Fallback-Modellketten](/docs/de/model-config#fallback-model-chains).1031Im Gegensatz zu den meisten Array-Einstellungen wird dieser Schlüssel nicht über Einstellungsdateien hinweg zusammengeführt: Die Datei mit dem höchsten Vorrang, die ihn definiert, liefert die ganze Kette. Wenn Ihre Projektdatei `["claude-sonnet-5"]` setzt und Ihre Benutzerdatei `["claude-haiku-4-5"]` setzt, ist die Kette nur `["claude-sonnet-5"]`. Claude Code behält höchstens drei unterschiedliche zulässige Modelle aus der Liste und ignoriert den Rest. Siehe [Fallback-Modellketten](/docs/de/model-config#fallback-model-chains).

973 1032

974<h3 id="fastmode">1033<h3 id="fastmode">

975 `fastMode`1034 `fastMode`

976</h3>1035</h3>

977 1036

978Aktivieren Sie den [Schnellmodus](/docs/de/fast-mode) für Sitzungen, in denen er verfügbar ist, für interaktive Arbeiten wie schnelle Iteration oder Live-Debugging, bei denen Sie Geschwindigkeit zu höheren Kosten pro Token wünschen. Sie bearbeiten diesen Schlüssel normalerweise nicht manuell: Das Ausführen von `/fast` schreibt `fastMode: true` zu `~/.claude/settings.json`, und das erneute Ausführen zum Ausschalten des Schnellmodus entfernt den Schlüssel. Der Schnellmodus läuft nur auf Opus 5.5, Opus 5 und Opus 4.8: Das Aktivieren von einem anderen Modell wechselt Sie zu Opus, und das Wechseln zu einem nicht unterstützten Modell schaltet ihn aus. Siehe [Modelle wechseln, während der Schnellmodus aktiv ist](/docs/de/fast-mode#switch-models-while-fast-mode-is-on).1037Aktivieren Sie den [Fast-Modus](/docs/de/fast-mode) für Sitzungen, in denen er verfügbar ist, für interaktive Arbeiten wie schnelle Iteration oder Live-Debugging, bei denen Sie Geschwindigkeit zu höheren Kosten pro Token wünschen. Sie bearbeiten diesen Schlüssel normalerweise nicht manuell: Das Ausführen von `/fast` schreibt `fastMode: true` in `~/.claude/settings.json`, und das erneute Ausführen zum Ausschalten des Fast-Modus entfernt den Schlüssel. Der Fast-Modus läuft nur auf Opus 5.5, Opus 5 und Opus 4.8: Wenn Sie ihn von einem anderen Modell aus aktivieren, wechseln Sie zu Opus, und der Wechsel zu einem nicht unterstützten Modell schaltet ihn aus. Siehe [Modelle wechseln, während der Fast-Modus aktiv ist](/docs/de/fast-mode#switch-models-while-fast-mode-is-on).

979 1038

980* **Bereich**: [`Beliebige Datei`](#scopes)1039* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

981* **Typ**: Boolean1040* **Typ**: Boolean

982 * `true`: Claude Code aktiviert den Schnellmodus für Sitzungen, in denen er verfügbar ist1041 * `true`: Claude Code aktiviert den Fast-Modus für Sitzungen, in denen er verfügbar ist

983 * `false`: Der Schnellmodus bleibt ausgeschaltet1042 * `false`: Der Fast-Modus bleibt ausgeschaltet

984* **Standard**: nicht gesetzt, daher ist der Schnellmodus ausgeschaltet1043* **Standard**: nicht gesetzt, daher ist der Fast-Modus ausgeschaltet

985* **Sitzungsübergreifende Außerkraftsetzungen**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](/docs/de/env-vars) schaltet den Schnellmodus für eine Sitzung aus, und dieser Schlüssel kann ihn nicht wieder einschalten1044* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](/docs/de/env-vars) schaltet den Fast-Modus für eine Sitzung aus, und dieser Schlüssel kann ihn nicht wieder einschalten

986 1045

987```json settings.json theme={null}1046```json settings.json theme={null}

988{1047{

994 `fastModePerSessionOptIn`1053 `fastModePerSessionOptIn`

995</h3>1054</h3>

996 1055

997Normalerweise speichert das Ausführen von `/fast` [`fastMode`](#fastmode) in den Benutzereinstellungen einer Person, daher ist der Schnellmodus am Anfang jeder späteren Sitzung aktiviert. Setzen Sie diesen Schlüssel auf `true`, um das zu stoppen: ein gespeichertes `fastMode: true` aktiviert den Schnellmodus nicht mehr beim Sitzungsstart, und jede Person muss `/fast` in jeder Sitzung ausführen, in der sie es möchte. Claude Code lässt den Schlüssel `fastMode` in ihrer Datei, daher stellt das Ausschalten dieses Schlüssels das alte Verhalten wieder her.1056Normalerweise speichert das Ausführen von `/fast` [`fastMode`](#fastmode) in den Benutzereinstellungen einer Person, sodass der Fast-Modus zu Beginn jeder späteren Sitzung aktiviert ist. Setzen Sie diesen Schlüssel auf `true`, um das zu verhindern: Ein gespeichertes `fastMode: true` aktiviert den Fast-Modus nicht mehr beim Sitzungsstart, und jede Person muss `/fast` in jeder Sitzung ausführen, in der sie ihn möchte. Claude Code lässt den Schlüssel `fastMode` in ihrer Datei, daher stellt das Ausschalten dieses Schlüssels das alte Verhalten wieder her.

998 1057

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

1000 1059

1001* **Bereich**: [`Beliebige Datei`](#scopes)1060* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

1002* **Typ**: Boolean1061* **Typ**: Boolean

1003 * `true`: ein gespeichertes `fastMode: true` aktiviert den Schnellmodus nicht mehr beim Sitzungsstart, daher führt jede Person `/fast` in jeder Sitzung aus, in der sie es möchte; ein `fastMode: true` mit `--settings` zählt immer noch für diese Sitzung, es sei denn, verwaltete Einstellungen setzen diesen Schlüssel1062 * `true`: ein gespeichertes `fastMode: true` aktiviert den Fast-Modus nicht mehr beim Sitzungsstart, daher führt jede Person `/fast` in jeder Sitzung aus, in der sie ihn möchte; ein mit `--settings` übergebenes `fastMode: true` zählt weiterhin für diese Sitzung, es sei denn, verwaltete Einstellungen setzen diesen Schlüssel

1004 * `false`: ein gespeichertes `fastMode: true` aktiviert den Schnellmodus am Anfang jeder späteren Sitzung1063 * `false`: ein gespeichertes `fastMode: true` aktiviert den Fast-Modus zu Beginn jeder späteren Sitzung

1005* **Standard**: `false`1064* **Standard**: `false`

1006 1065

1007```json settings.json theme={null}1066```json settings.json theme={null}

1016 `language`1075 `language`

1017</h3>1076</h3>

1018 1077

1019Lassen Sie Claude standardmäßig in einer anderen Sprache als Englisch antworten. Es gibt keine feste Liste für Antworten: Claude Code übergibt den Wert wörtlich an Claude als Anweisung, immer in dieser Sprache zu antworten, daher funktioniert jeder Sprachname, den Claude lesen kann. Claude Code überprüft den Wert nicht, daher erreicht ein falsch geschriebener Name Claude wie geschrieben, anstatt einen Fehler zu erzeugen. Der gleiche Wert setzt die Sprache für [Sprachdiktat](/docs/de/voice-dictation#change-the-dictation-language), das eine feste Liste von [unterstützten Diktiersprachen](/docs/de/voice-dictation#change-the-dictation-language) hat, und für automatisch generierte Sitzungstitel.1078Lassen Sie Claude standardmäßig in einer anderen Sprache als Englisch antworten. Es gibt keine feste Liste für Antworten: Claude Code übergibt den Wert wörtlich an Claude als Anweisung, immer in dieser Sprache zu antworten, daher funktioniert jeder Sprachname, den Claude lesen kann. Claude Code überprüft den Wert nicht, daher erreicht ein falsch geschriebener Name Claude so, wie er geschrieben ist, anstatt einen Fehler zu erzeugen. Derselbe Wert legt die Sprache für das [Sprachdiktat](/docs/de/voice-dictation#change-the-dictation-language) fest, das eine feste Liste von [unterstützten Diktiersprachen](/docs/de/voice-dictation#change-the-dictation-language) hat, sowie für automatisch generierte Sitzungstitel.

1020 1079

1021* **Bereich**: [`Beliebige Datei`](#scopes)1080* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

1022* **Typ**: String, jeder Sprachname, wie `"japanese"`, `"spanish"` oder `"french"`; Claude Code überprüft ihn nicht1081* **Typ**: String, jeder Sprachname, wie `"japanese"`, `"spanish"` oder `"french"`; Claude Code überprüft ihn nicht

1023* **Standard**: nicht gesetzt; Sitzungstitel entsprechen dann der Sprache Ihrer Konversation1082* **Standard**: nicht gesetzt; Sitzungstitel entsprechen dann der Sprache Ihrer Konversation

1024 1083

1032 `maxEffortLevel`1091 `maxEffortLevel`

1033</h3>1092</h3>

1034 1093

1035Begrenzen Sie die [Aufwandsebene](/docs/de/model-config#adjust-effort-level), die eine Sitzung verwenden kann, und lassen Sie niedrigere Ebenen verfügbar. Jede höhere Ebene läuft stattdessen bei der Obergrenze, einschließlich einer von `/effort`, der Auswahl `/model`, `--effort`, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/de/env-vars), der Frontmatter `effort` eines Skills oder Subagents oder dem eigenen Standard des Modells. Claude Code wendet die Obergrenze selbst vor jeder Anfrage an, daher gilt sie auf jedem Provider, einschließlich Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry. Erfordert Claude Code v2.1.267 oder später.1094Begrenzen Sie die [Effort-Stufe](/docs/de/model-config#adjust-effort-level), die eine Sitzung verwenden kann, wobei niedrigere Stufen verfügbar bleiben. Jede höhere Stufe läuft stattdessen mit der Obergrenze, einschließlich einer Stufe aus `/effort`, der Auswahl `/model`, `--effort`, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/de/env-vars), dem Frontmatter-Feld `effort` eines Skills oder Subagenten oder dem eigenen Standard des Modells. Claude Code wendet die Obergrenze vor jeder Anfrage selbst an, daher gilt sie bei jedem Provider, einschließlich Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry. Erfordert Claude Code v2.1.267 oder später.

1036 1095

1037* **Bereich**: [`Beliebige Datei`](#scopes). Stellen Sie es in verwalteten Einstellungen bereit, um es für eine Organisation durchzusetzen. Wenn mehrere Bereiche eine Obergrenze setzen, gilt die niedrigste, daher kann eine in einem Bereich gesetzte Obergrenze nicht von einem anderen erhöht werden1096* **Geltungsbereich**: [`Beliebige Datei`](#scopes). Stellen Sie ihn in verwalteten Einstellungen bereit, um ihn für eine Organisation durchzusetzen. Wenn mehrere Geltungsbereiche eine Obergrenze setzen, gilt die niedrigste, daher kann eine in einem Geltungsbereich gesetzte Obergrenze nicht von einem anderen angehoben werden

1038* **Typ**: String, einer von `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Ein Wert `"max"` setzt keine Obergrenze1097* **Typ**: String, einer von `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Ein Wert `"max"` setzt keine Obergrenze

1039* **Standard**: nicht gesetzt, daher gilt keine Obergrenze1098* **Standard**: nicht gesetzt, daher gilt keine Obergrenze

1040* **Auswirkung auf Ultracode**: eine Obergrenze unter `xhigh` macht [Ultracode](#ultracode) auf den Modellen, auf die die Obergrenze zutrifft, nicht verfügbar1099* **Obergrenzen pro Modell**: Fügen Sie `maxEffortLevel` zum [`modelSettings`](#modelsettings)-Eintrag eines Modells hinzu. Dieser Eintrag ersetzt diesen Schlüssel für das Modell nur innerhalb der Einstellungsquelle, die beide setzt, wie Ihre Benutzereinstellungen oder eine [verwaltete Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources). Setzen Sie dort `"max"`, um das Modell von der Obergrenze dieser Quelle auszunehmen; Claude Code wendet weiterhin Obergrenzen aus anderen Quellen an

1041* **Pro-Modell-Obergrenzen**: fügen Sie `maxEffortLevel` zum Eintrag [`modelSettings`](#modelsettings) eines Modells hinzu. Dieser Eintrag ersetzt diesen Schlüssel nur für das Modell innerhalb der Einstellungsquelle, die beide setzt, wie Ihre Benutzereinstellungen oder eine [verwaltete Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources). Setzen Sie dort `"max"`, um das Modell von der Obergrenze dieser Quelle auszunehmen; Claude Code wendet immer noch Obergrenzen von anderen Quellen an

1042 1100

1043Dieses Beispiel begrenzt jedes Modell auf `medium` und befreit Sonnet 4.6:1101Dieses Beispiel begrenzt jedes Modell auf `medium` und nimmt Sonnet 4.6 aus:

1044 1102

1045```json settings.json theme={null}1103```json settings.json theme={null}

1046{1104{

1053}1111}

1054```1112```

1055 1113

1056Wenn Ihre Organisation auch ein [Aufwandslimit](/docs/de/model-config#organization-effort-limits) für ein Modell setzt, gilt die niedrigere der beiden Obergrenzen.1114Wenn Ihre Organisation zusätzlich ein [Effort-Limit](/docs/de/model-config#organization-effort-limits) für ein Modell setzt, gilt die niedrigere der beiden Obergrenzen.

1057 1115

1058<h3 id="model">1116<h3 id="model">

1059 `model`1117 `model`

1060</h3>1118</h3>

1061 1119

1062Legen Sie das Modell fest, das jede neue Sitzung verwendet, damit Sie nicht jedes Mal mit `/model` eines auswählen müssen. Das Setzen hier hindert Sie nicht daran, die Sitzung zu wechseln. Wenn Ihr Administrator ein [Organisations-Standardmodell](/docs/de/model-config#organization-default-model) gesetzt hat, um die Benutzerauswahl zu überschreiben, erhalten Sie dieses Modell auch wenn Sie diesen Schlüssel in Benutzer-, Projekt- oder Lokaleinstellungen setzen.1120Legen Sie das Modell fest, das jede neue Sitzung verwendet, damit Sie nicht jedes Mal mit `/model` eines auswählen müssen. Das Festlegen hier hindert Sie nicht daran, während der Sitzung zu wechseln. Wenn Ihr Admin ein [Organisations-Standardmodell](/docs/de/model-config#organization-default-model) gesetzt hat, um die Benutzerauswahl zu überschreiben, erhalten Sie dieses Modell, auch wenn Sie diesen Schlüssel in Benutzer-, Projekt- oder lokalen Einstellungen setzen.

1063 1121

1064* **Bereich**: [`Beliebige Datei`](#scopes)1122* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

1065* **Typ**: String, ein Modellalias oder eine vollständige Modell-ID1123* **Typ**: String, ein Modellalias oder eine vollständige Modell-ID

1066* **Standard**: nicht gesetzt, daher verwendet Claude Code das Standardmodell Ihres Kontos1124* **Standard**: nicht gesetzt, daher verwendet Claude Code das Standardmodell Ihres Kontos

1067* **Sitzungsübergreifende Außerkraftsetzungen**: `--model` hat Vorrang vor [`ANTHROPIC_MODEL`](/docs/de/env-vars), und beide haben Vorrang vor diesem Schlüssel für eine Sitzung, einschließlich vor einem verwalteten `model`; eine [`availableModels`](#availablemodels)-Liste gilt immer noch für die Auswahl1125* **Überschreibungen pro Sitzung**: `--model` hat Vorrang vor [`ANTHROPIC_MODEL`](/docs/de/env-vars), und beide haben für eine Sitzung Vorrang vor diesem Schlüssel, auch vor einem verwalteten `model`; eine [`availableModels`](#availablemodels)-Liste gilt weiterhin für die Auswahl

1068 1126

1069```json settings.json theme={null}1127```json settings.json theme={null}

1070{1128{

1072}1130}

1073```1131```

1074 1132

1075Ein Wert hier übertrumpft [`ANTHROPIC_DEFAULT_MODEL`](/docs/de/model-config#set-a-default-model-for-new-sessions), das Claude Code nur verwendet, wenn nichts anderes ein Modell auswählt.1133Ein Wert hier hat Vorrang vor [`ANTHROPIC_DEFAULT_MODEL`](/docs/de/model-config#set-a-default-model-for-new-sessions), das Claude Code nur verwendet, wenn nichts anderes ein Modell auswählt.

1076 1134

1077<h3 id="modeloverrides">1135<h3 id="modeloverrides">

1078 `modelOverrides`1136 `modelOverrides`

1079</h3>1137</h3>

1080 1138

1081Ordnen Sie Anthropic-Modell-IDs Anbieter-spezifischen Modell-IDs zu, wie Amazon Bedrock Inferenz-Profil-ARNs. Jeder Modellauswahl-Eintrag verwendet dann seinen zugeordneten Wert beim Aufrufen der Provider-API. Administratoren verwenden dies auf [Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry](/docs/de/model-config#override-model-ids-per-version), um jede Modellversion zu einem bestimmten Inferenz-Profil, Versionsnamen oder einer Bereitstellung für Governance, Kostenzuteilung oder regionales Routing zu leiten.1139Ordnen Sie Anthropic-Modell-IDs providerspezifischen Modell-IDs zu, wie ARNs von Amazon Bedrock-Inferenzprofilen. Jeder Eintrag der Modellauswahl verwendet dann seinen zugeordneten Wert beim Aufruf der Provider-API. Administratoren verwenden dies auf [Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry](/docs/de/model-config#override-model-ids-per-version), um jede Modellversion für Governance, Kostenzuordnung oder regionales Routing an ein bestimmtes Inferenzprofil, einen Versionsnamen oder eine Bereitstellung zu leiten.

1082 1140

1083* **Bereich**: [`Beliebige Datei`](#scopes)1141* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

1084* **Typ**: Objekt, das Modell-ID zu Anbieter-Modell-ID zuordnet1142* **Typ**: Objekt, das Modell-IDs Provider-Modell-IDs zuordnet

1085* **Standard**: nicht gesetzt1143* **Standard**: nicht gesetzt

1086 1144

1087Dieses Beispiel leitet jeden Aufruf für Opus 4.6 zum benannten Bedrock-Inferenz-Profil:1145Dieses Beispiel leitet jeden Aufruf für Opus 4.6 an das benannte Bedrock-Inferenzprofil:

1088 1146

1089```json settings.json theme={null}1147```json settings.json theme={null}

1090{1148{

1100 `modelPicker`1158 `modelPicker`

1101</h3>1159</h3>

1102 1160

1103Listen Sie die Modelle auf, die die Auswahl `/model` anbietet, in der Reihenfolge, in der Sie sie schreiben, und unter Bezeichnungen, die Sie wählen, damit die Auswahl die Modelle auflistet, die Ihre Organisation ausführt, nach der integrierten Auswahl oder stattdessen. Das `model` jeder Zeile wird wörtlich genommen, daher akzeptiert es alles, was `--model` akzeptiert: ein Alias wie `opus`, eine Anthropic-Modell-ID oder eine Anbieter-Format-ID für Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder ein LLM-Gateway. Erfordert Claude Code v2.1.242 oder später.1161Listen Sie die Modelle auf, die die Auswahl `/model` anbietet, in der Reihenfolge, in der Sie sie schreiben, und unter Bezeichnungen, die Sie wählen, sodass die Auswahl die Modelle aufführt, die Ihre Organisation verwendet, nach der integrierten Auswahl oder an ihrer Stelle. Das `model` jeder Zeile wird wörtlich übernommen, daher akzeptiert es alles, was `--model` akzeptiert: einen Alias wie `opus`, eine Anthropic-Modell-ID oder eine ID im Provider-Format für Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder ein LLM-Gateway. Erfordert Claude Code v2.1.242 oder später.

1104 1162

1105* **Bereich**: [`Benutzer oder verwaltet`](#scopes). Claude Code liest den Schlüssel aus verwalteten Einstellungen, `--settings` und Benutzereinstellungen und ignoriert ihn in Projekt- und Lokaleinstellungen, daher kann ein Repository, das Sie klonen, die Auswahl nicht umbenennen. Die höchste dieser drei, die den Schlüssel setzt, liefert die ganze Auswahl, und Claude Code kombiniert Auswahlmöglichkeiten von zwei Quellen nie.1163* **Geltungsbereich**: [`Benutzer oder verwaltet`](#scopes). Claude Code liest den Schlüssel aus verwalteten Einstellungen, `--settings` und Benutzereinstellungen und ignoriert ihn in Projekt- und lokalen Einstellungen, damit ein Repository, das Sie klonen, die Auswahl nicht umbenennen kann. Die höchste dieser drei Quellen, die den Schlüssel setzt, liefert die gesamte Auswahl, und Claude Code kombiniert nie Auswahllisten aus zwei Quellen.

1106* **Typ**: Objekt mit einem Array `options` von Zeilen und einem optionalen Boolean `replaceBuiltInOptions`1164* **Typ**: Objekt mit einem Array `options` von Zeilen und einem optionalen Boolean `replaceBuiltInOptions`

1107* **Standard**: nicht gesetzt, daher zeigt die Auswahl die integrierte Auswahl1165* **Standard**: nicht gesetzt, daher zeigt die Auswahl die integrierte Auswahl

1108 1166

1109Dieses Beispiel fügt zwei Bedrock-Bereitstellungen nach der integrierten Auswahl hinzu, unter Namen, die Ihr Team erkennt:1167Dieses Beispiel fügt nach der integrierten Auswahl zwei Bedrock-Bereitstellungen unter Namen hinzu, die Ihr Team kennt:

1110 1168

1111```json managed-settings.json theme={null}1169```json managed-settings.json theme={null}

1112{1170{

1131 Felder für `modelPicker`1189 Felder für `modelPicker`

1132</h4>1190</h4>

1133 1191

1134Der Schlüssel nimmt zwei Felder, eines für die Zeilen selbst und eines dafür, ob sie die integrierte Auswahl ersetzen oder zu ihr hinzufügen.1192Der Schlüssel hat zwei Felder: eines für die Zeilen selbst und eines dafür, ob sie die integrierte Auswahl ersetzen oder ergänzen.

1135 1193

1136| Feld | Typ | Was es tut |1194| Feld | Typ | Funktion |

1137| :- | :- | :- |1195| :- | :- | :- |

1138| `options` | Array von Zeilen, jede mit einem erforderlichen `model` und optionalen `label`, `description` und `behavesAs` | Die Zeilen, die die Auswahl zeigt, in dieser Reihenfolge, außer dass eine ausgegraut Zeile nach unten verschoben wird. Ohne `label` betitelt Claude Code die Zeile mit dem integrierten Namen für ein Modell, das es kennt, oder der Modell-ID ansonsten, und ohne `description` schreibt es eine generische zweite Zeile |1196| `options` | Array von Zeilen, jede mit einem erforderlichen `model` und optionalen `label`, `description` und `behavesAs` | Die Zeilen, die die Auswahl anzeigt, in dieser Reihenfolge, außer dass eine ausgegraute Zeile nach unten verschoben wird. Ohne `label` betitelt Claude Code die Zeile mit dem integrierten Namen für ein Modell, das es kennt, andernfalls mit der Modell-ID, und ohne `description` schreibt es eine generische zweite Zeile |

1139| `replaceBuiltInOptions` | Boolean, Standard `false` | Setzen Sie es auf `true`, um nur diese Zeilen, **Standard** und eine Zeile für das Modell anzuzeigen, das die Sitzung bereits verwendet. Lassen Sie es ungesetzt, um diese Zeilen nach der integrierten Auswahl hinzuzufügen |1197| `replaceBuiltInOptions` | Boolean, Standard `false` | Setzen Sie es auf `true`, um nur diese Zeilen, **Standard** und eine Zeile für das Modell anzuzeigen, das die Sitzung bereits verwendet. Lassen Sie es ungesetzt, um diese Zeilen nach der integrierten Auswahl hinzuzufügen |

1140 1198

1141Ein Eintrag in `options` kann auch ein optionales `behavesAs`-String neben seinem `model` tragen, das v2.1.257 oder später erfordert. Setzen Sie es auf die ID eines Modells, das Ihre Claude Code-Version bereits kennt, wie `claude-opus-4-8`, auf einem Eintrag, dessen `model` neuer ist als Ihre Version. Claude Code wendet dann die Fähigkeiten und Aufwands-Standards dieses bekannten Modells auf den Eintrag an, anstatt sein Modell als unbekannt zu behandeln. Die Bezeichnung des Eintrags und die Modell-ID, die Claude Code in Anfragen sendet, ändern sich nicht.1199Ein Eintrag in `options` kann neben seinem `model` auch einen optionalen String `behavesAs` enthalten, was v2.1.257 oder später erfordert. Setzen Sie ihn auf die ID eines Modells, das Ihre Claude Code-Version bereits kennt, wie `claude-opus-4-8`, bei einem Eintrag, dessen `model` neuer als Ihre Version ist. Claude Code wendet dann die Fähigkeiten und Effort-Standards dieses bekannten Modells auf den Eintrag an, anstatt sein Modell als unbekannt zu behandeln. Die Bezeichnung des Eintrags und die Modell-ID, die Claude Code in Anfragen sendet, ändern sich nicht.

1142 1200

1143Mit `replaceBuiltInOptions` an, versteckt Claude Code jede andere Zeile: die integrierte Auswahl, die Zeilen, die es für [`availableModels`](#availablemodels)-Einträge hinzufügt, die Modelle, die [Gateway-Erkennung](/docs/de/llm-gateway-protocol#model-discovery) gefunden hat, und [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/de/model-config#add-a-custom-model-option). Mit ihr aus, überspringt Claude Code ein aufgelistetes Modell, das die integrierte Auswahl bereits abdeckt. Ein Label ändert, was die Auswahl zeigt, nicht welches Modell Claude Code ausführt.1201Wenn `replaceBuiltInOptions` aktiviert ist, blendet Claude Code alle anderen Zeilen aus: die integrierte Auswahl, die Zeilen, die es für [`availableModels`](#availablemodels)-Einträge hinzufügt, die Modelle, die die [Gateway-Erkennung](/docs/de/llm-gateway-protocol#model-discovery) gefunden hat, und [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/de/model-config#add-a-custom-model-option). Wenn es deaktiviert ist, überspringt Claude Code ein aufgelistetes Modell, das die integrierte Auswahl bereits abdeckt. Eine Bezeichnung ändert, was die Auswahl anzeigt, nicht welches Modell Claude Code ausführt.

1144 1202

1145Eine [`availableModels`](#availablemodels)-Zulassungsliste gilt immer noch für diese Zeilen. Bevor Sie ein aufgelistetes Modell zur Zulassungsliste hinzufügen, lesen Sie [Zusammenführungsverhalten](/docs/de/model-config#merge-behavior): eine spezifische Modell-ID verengt den Wildcard-Eintrag ihrer Familie. Claude Code überprüft auch jede Zeile gegen die Sitzung, bevor es die Auswahl zeigt:1203Eine [`availableModels`](#availablemodels)-Allowlist gilt weiterhin für diese Zeilen. Bevor Sie ein aufgelistetes Modell zur Allowlist hinzufügen, lesen Sie [Zusammenführungsverhalten](/docs/de/model-config#merge-behavior): Eine spezifische Modell-ID schränkt den Wildcard-Eintrag ihrer Familie ein. Claude Code prüft außerdem jede Zeile gegen die Sitzung, bevor es die Auswahl anzeigt:

1146 1204

1147* **Gelöscht**: eine Zeile, die Claude Code nicht bedienen kann, wie ein veraltetes Modell oder ein Modell, auf das Ihre Organisation keinen Zugriff hat1205* **Entfernt**: eine Zeile, die Claude Code nicht bedienen kann, wie ein eingestelltes Modell oder ein Modell, auf das Ihre Organisation keinen Zugriff hat

1148* **Ausgegraut**: eine Zeile, die Sie noch nicht auswählen können, mit dem Grund angezeigt1206* **Ausgegraut**: eine Zeile, die Sie noch nicht auswählen können, mit Angabe des Grundes

1149* **Keine Zeile überlebt**: Claude Code behält die integrierte Auswahl, gefiltert durch die Zulassungsliste wie gewohnt1207* **Keine Zeile bleibt übrig**: Claude Code behält die integrierte Auswahl, wie üblich durch die Allowlist gefiltert

1150 1208

1151Claude Code löscht eine Zeile, die es nicht analysieren kann, und behält den Rest. Siehe [Fehlerhafte Einstellungsdatei beheben](/docs/de/settings#fix-a-broken-settings-file).1209Claude Code entfernt eine Zeile, die es nicht parsen kann, und behält den Rest. Siehe [Fehlerhafte Einstellungsdatei beheben](/docs/de/settings#fix-a-broken-settings-file).

1152 1210

1153<h3 id="modelpricing">1211<h3 id="modelpricing">

1154 `modelPricing`1212 `modelPricing`

1155</h3>1213</h3>

1156 1214

1157Melden Sie Ausgaben zu den Sätzen, die Ihre Organisation zahlt, anstatt zum Listenpreis. Setzen Sie es, wenn Ihre Organisation verhandelte Sätze hat, daher entsprechen die Dollar-Zahlen, die Entwickler sehen, Ihrer Rechnung. Claude Code wendet die Sätze in `/usage`, der [Statuszeile](/docs/de/statusline), dem `total_cost_usd` des Agent SDK, dem Limit [`--max-budget-usd`](/docs/de/cli-reference) und der [OpenTelemetry](/docs/de/monitoring-usage)-Kostenmetrik und Ereignissen an. Sie liefern die Sätze: Claude Code liest sie nicht aus Ihrem Vertrag oder der Claude Console. Erfordert Claude Code v2.1.242 oder später.1215Melden Sie Ausgaben zu den Preisen, die Ihre Organisation zahlt, anstatt zum Listenpreis. Setzen Sie den Schlüssel, wenn Ihre Organisation vertraglich vereinbarte Preise hat, damit die Dollarbeträge, die Entwickler sehen, Ihrer Rechnung entsprechen. Claude Code wendet die Preise in `/usage`, der [Statuszeile](/docs/de/statusline), dem `total_cost_usd` des Agent SDK, dem Limit [`--max-budget-usd`](/docs/de/cli-reference) sowie der Kostenmetrik und den Ereignissen von [OpenTelemetry](/docs/de/monitoring-usage) an. Sie liefern die Preise: Claude Code liest sie nicht aus Ihrem Vertrag oder der Claude Console. Erfordert Claude Code v2.1.242 oder später.

1158 1216

1159* **Bereich**: [`Verwaltet`](#scopes). Stellen Sie den Schlüssel durch serverseitig verwaltete Einstellungen, eine MDM-Richtlinie, eine Datei `managed-settings.json` oder einen [Richtlinien-Helfer](/docs/de/managed-settings#compute-the-policy-with-a-helper-program) bereit. Claude Code ignoriert ihn in Benutzer-, Projekt- und Lokaleinstellungen, in `--settings` und unter Windows in der beschreibbaren [HKCU-Registrierung](/docs/de/managed-settings#where-each-mechanism-stores-the-policy). Mit serverseitig verwalteten Einstellungen meldet jede Sitzung Kosten zum Listenpreis, bis die [Einstellungsabruf](/docs/de/server-managed-settings#fetch-and-caching-behavior) dieser Sitzung die Einstellung bestätigt hat. Eine Host-Anwendung, die Claude Code einbettet und [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/de/env-vars) setzt, kann eine Tabelle ihrer eigenen durch die SDK-Option [`managedSettings`](/docs/de/agent-sdk/typescript#options) liefern, die Claude Code nur verwendet, wenn keine verwaltete Quelle den Schlüssel setzt und nur in Claude Code v2.1.246 oder später.1217* **Geltungsbereich**: [`Verwaltet`](#scopes). Stellen Sie den Schlüssel über serverseitig verwaltete Einstellungen, eine MDM-Richtlinie, eine Datei `managed-settings.json` oder ein [Richtlinien-Hilfsprogramm](/docs/de/managed-settings#compute-the-policy-with-a-helper-program) bereit. Claude Code ignoriert ihn in Benutzer-, Projekt- und lokalen Einstellungen, in `--settings` und unter Windows in der vom Benutzer beschreibbaren [HKCU-Registrierung](/docs/de/managed-settings#where-each-mechanism-stores-the-policy). Mit serverseitig verwalteten Einstellungen meldet jede Sitzung Kosten zum Listenpreis, bis der [Einstellungsabruf](/docs/de/server-managed-settings#fetch-and-caching-behavior) dieser Sitzung die Einstellung bestätigt hat. Eine Host-Anwendung, die Claude Code einbettet und [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/de/env-vars) setzt, kann über die SDK-Option [`managedSettings`](/docs/de/agent-sdk/typescript#options) eine eigene Tabelle liefern, die Claude Code nur verwendet, wenn keine verwaltete Quelle den Schlüssel setzt, und nur in Claude Code v2.1.246 oder später.

1160* **Typ**: Objekt mit einem optionalen `multiplier` und einer optionalen Karte `overrides`1218* **Typ**: Objekt mit einem optionalen `multiplier` und einer optionalen Zuordnung `overrides`

1161* **Standard**: nicht gesetzt, daher meldet Claude Code Listenpreis, es sei denn, eine Host-Anwendung liefert eine Tabelle1219* **Standard**: nicht gesetzt, daher meldet Claude Code den Listenpreis, es sei denn, eine Host-Anwendung liefert eine Tabelle

1162 1220

1163Setzen Sie `multiplier` allein für einen pauschalen Rabatt oder Aufschlag, `overrides` allein für Pro-Modell-Sätze oder beide.1221Setzen Sie nur `multiplier` für einen pauschalen Rabatt oder Aufschlag, nur `overrides` für Preise pro Modell oder beides.

1164 1222

1165Dieses Beispiel setzt verhandelte Sätze für Sonnet 4.6 und reduziert dann jede Zahl, die Sonnet-Zeile eingeschlossen, um 15%:1223Dieses Beispiel setzt vertraglich vereinbarte Preise für Sonnet 4.6 und reduziert dann jeden Betrag, einschließlich der Sonnet-Zeile, um 15 %:

1166 1224

1167```json managed-settings.json theme={null}1225```json managed-settings.json theme={null}

1168{1226{

1180}1238}

1181```1239```

1182 1240

1183Setzen Sie `multiplier` über 1, bis zu 10, um jede Zahl zu markieren. Ein Aufschlag erfordert Claude Code v2.1.271 oder später. Frühere Versionen ignorieren einen `multiplier` über 1 mit einer Warnung und behalten den Rest der Einstellung.1241Setzen Sie `multiplier` auf einen Wert über 1, bis maximal 10, um jeden Betrag mit einem Aufschlag zu versehen. Ein Aufschlag erfordert Claude Code v2.1.271 oder später. Frühere Versionen ignorieren einen `multiplier` über 1 mit einer Warnung und behalten den Rest der Einstellung.

1184 1242

1185Für die Schritte, einschließlich wie Sie bestätigen, dass die Sätze in Kraft sind, siehe [Ausgaben zu Ihren verhandelten Sätzen melden](/docs/de/costs#report-spend-at-your-contracted-rates).1243Die Schritte, einschließlich der Bestätigung, dass die Preise wirksam sind, finden Sie unter [Ausgaben zu Ihren vertraglich vereinbarten Preisen melden](/docs/de/costs#report-spend-at-your-contracted-rates).

1186 1244

1187<span id="modelpricing-multiplier" />1245<span id="modelpricing-multiplier" />

1188 1246

1192 Felder für `modelPricing`1250 Felder für `modelPricing`

1193</h4>1251</h4>

1194 1252

1195| Feld | Typ | Was es tut |1253| Feld | Typ | Funktion |

1196| :- | :- | :- |1254| :- | :- | :- |

1197| `multiplier` | Zahl größer als 0 und höchstens 10 | Skaliert jede Kosten, die Claude Code berechnet, ob oder ob nicht eine `overrides`-Zeile sie abdeckt. Unter 1 ist ein Rabatt, über 1 ein Aufschlag |1255| `multiplier` | Zahl größer als 0 und höchstens 10 | Skaliert alle Kosten, die Claude Code berechnet, unabhängig davon, ob eine `overrides`-Zeile sie abdeckt. Unter 1 ist ein Rabatt, über 1 ein Aufschlag |

1198| `overrides` | Karte von Modell-ID zu einem Rateobjekt mit `input`, `output`, `cacheRead` und `cacheWrite`, jeweils 0 bis 10000 | Die USD-pro-Million-Token-Sätze für dieses Modell, alle vier erforderlich. `cacheWrite` deckt sowohl Fünf-Minuten- als auch Einstunden-Cache-Schreibvorgänge ab. Siehe [Welche Modelle eine `modelPricing`-Zeile anwendet](#which-models-a-modelpricing-row-applies-to) |1256| `overrides` | Zuordnung von Modell-ID zu einem Preisobjekt mit `input`, `output`, `cacheRead` und `cacheWrite`, jeweils 0 bis 10000 | Die Preise in USD pro Million Token für dieses Modell, alle vier erforderlich. `cacheWrite` deckt sowohl Cache-Schreibvorgänge mit fünf Minuten als auch mit einer Stunde ab. Siehe [Für welche Modelle eine Zeile gilt](#which-models-a-modelpricing-row-applies-to) |

1199 1257

1200Claude Code verwendet die Sätze einer Zeile genau wie Sie sie schrieben, ohne den Schnellmodus-Aufschlag oder den [nur-US-Inferenz-Satz](https://platform.claude.com/docs/en/about-claude/pricing) hinzuzufügen. Wenn Sie auch `multiplier` setzen, wendet Claude Code ihn auf die Sätze der Zeile an. Claude Code löscht eine Zeile mit einem Satz, den es nicht analysieren kann, oder einen `multiplier`, den es nicht analysieren kann, und behält den Rest; siehe [Fehlerhafte Einstellungsdatei beheben](/docs/de/settings#fix-a-broken-settings-file).1258Claude Code verwendet die Preise einer Zeile genau so, wie Sie sie geschrieben haben, ohne den Fast-Modus-Aufschlag oder den [Preis für reine US-Inferenz](https://platform.claude.com/docs/en/about-claude/pricing) hinzuzufügen. Wenn Sie auch `multiplier` setzen, wendet Claude Code ihn zusätzlich auf die Preise der Zeile an. Claude Code entfernt eine Zeile mit einem Preis, den es nicht parsen kann, oder einen `multiplier`, den es nicht parsen kann, und behält den Rest; siehe [Fehlerhafte Einstellungsdatei beheben](/docs/de/settings#fix-a-broken-settings-file).

1201 1259

1202<h4 id="which-models-a-modelpricing-row-applies-to">1260<h4 id="which-models-a-modelpricing-row-applies-to">

1203 Welche Modelle eine `modelPricing`-Zeile anwendet1261 Für welche Modelle eine `modelPricing`-Zeile gilt

1204</h4>1262</h4>

1205 1263

1206Claude Code entscheidet, welche Modelle eine Zeile anwendet, vom Schlüssel der Zeile:1264Claude Code bestimmt anhand des Schlüssels der Zeile, für welche Modelle eine Zeile gilt:

1207 1265

1208* **Die ID eines integrierten Modells**: ein Schlüssel, den Claude Code selbst für ein integriertes Modell verwendet, ob dieser Schlüssel die eigene ID des Modells ist, wie `claude-sonnet-4-6`, oder seine Bedrock-, Agent Platform- oder Foundry-ID. Claude Code wendet die Zeile auf jede datierte Snapshot-ID und Anbieter-spezifische ID dieses Modells an.1266* **Die ID eines integrierten Modells**: ein Schlüssel, den Claude Code selbst für ein integriertes Modell verwendet, sei es die eigene ID des Modells, wie `claude-sonnet-4-6`, oder seine Bedrock-, Agent Platform- oder Foundry-ID. Claude Code wendet die Zeile auf jede datierte Snapshot-ID und jede providerspezifische ID dieses Modells an.

1209* **Jeder andere Schlüssel**: ein Schlüssel, der nicht die ID eines integrierten Modells ist, wie ein Gateway-Modellalias. Claude Code wendet die Zeile auf diese eine ID nur an. Wenn eine Modell-ID genau einem Ihrer Schlüssel entspricht und auch unter eine Zeile fällt, die von einer integrierten Modell-ID gekennzeichnet ist, verwendet Claude Code die genaue Übereinstimmung.1267* **Jeder andere Schlüssel**: ein Schlüssel, der nicht die ID eines integrierten Modells ist, wie ein Gateway-Modellalias. Claude Code wendet die Zeile nur auf genau diese ID an. Wenn eine Modell-ID genau mit einem Ihrer Schlüssel übereinstimmt und zugleich unter eine Zeile fällt, deren Schlüssel die ID eines integrierten Modells ist, verwendet Claude Code die genaue Übereinstimmung.

1210* **Ein Bedrock-Anwendungs-Inferenz-Profil**: sobald Claude Code das Profil zum Modell aufgelöst hat, zu dem es leitet, durch Ihre Karte [`modelOverrides`](#modeloverrides) oder die Suche [`bedrock:GetInferenceProfile`](/docs/de/amazon-bedrock#iam-configuration), wendet Claude Code die Zeile dieses Modells auf das Profil an.1268* **Ein Bedrock-Anwendungsinferenzprofil**: Sobald Claude Code das Profil über Ihre Zuordnung [`modelOverrides`](#modeloverrides) oder die [Abfrage `bedrock:GetInferenceProfile`](/docs/de/amazon-bedrock#iam-configuration) zu dem Modell aufgelöst hat, an das es weiterleitet, wendet Claude Code die Zeile dieses Modells auf das Profil an.

1211 1269

1212<h3 id="modelsettings">1270<h3 id="modelsettings">

1213 `modelSettings`1271 `modelSettings`

1214</h3>1272</h3>

1215 1273

1216Speichern Sie eine [Aufwandsebene](/docs/de/model-config#adjust-effort-level) für jedes Modell, das Sie verwenden. Erfordert Claude Code v2.1.251 oder später.1274Speichern Sie eine [Effort-Stufe](/docs/de/model-config#adjust-effort-level) für jedes Modell, das Sie verwenden. Erfordert Claude Code v2.1.251 oder später.

1217 1275

1218In einer interaktiven Sitzung auf Ihrem Computer, wenn Sie `low`, `medium`, `high` oder `xhigh` als Ihren Standard mit `/effort` oder dem Aufwands-Schieberegler der Auswahl `/model` speichern, schreibt Claude Code diese Ebene hier unter dem Modell, das Sie verwenden, daher bearbeiten Sie diesen Schlüssel selten selbst. Wenn Sie einen dieser Ebenen in der [Modellauswahl der VS Code-Erweiterung](/docs/de/vs-code#use-the-prompt-box) auswählen, speichert Claude Code ihn auf die gleiche Weise. Der Eintrag [`effortLevel`](#effortlevel) listet die Sitzungen auf, in denen `/effort` nur für diese Sitzung gilt.1276Wenn Sie in einer interaktiven Sitzung auf Ihrem Computer `low`, `medium`, `high` oder `xhigh` mit `/effort` oder dem Effort-Schieberegler der Auswahl `/model` als Ihren Standard speichern, schreibt Claude Code diese Stufe hier unter dem Modell, das Sie verwenden, daher bearbeiten Sie diesen Schlüssel selten selbst. Wenn Sie eine dieser Stufen in der [Modellauswahl der VS Code-Erweiterung](/docs/de/vs-code#use-the-prompt-box) auswählen, speichert Claude Code sie auf dieselbe Weise hier. Der Eintrag [`effortLevel`](#effortlevel) listet die Sitzungen auf, in denen `/effort` nur für diese Sitzung gilt.

1219 1277

1220Bearbeiten Sie den Schlüssel manuell, um eine Ebene zu ändern oder zu entfernen, die Sie gespeichert haben.1278Bearbeiten Sie den Schlüssel manuell, um eine gespeicherte Stufe zu ändern oder zu entfernen.

1221 1279

1222Ein `effortLevel` eines Modells hier hat Vorrang vor dem Top-Level-[`effortLevel`](#effortlevel) in der gleichen Einstellungsdatei. Über Dateien hinweg löst Claude Code jedes Modell separat auf: die höchste Prioritäts-[Einstellungsdatei](/docs/de/settings#settings-precedence), die entweder einen `effortLevel` für dieses Modell oder einen Top-Level-`effortLevel` setzt, der [auf dieses Modell anwendet](#effortlevel), entscheidet, daher übertrumpft ein `effortLevel` in verwalteten Einstellungen eine Ebene, die Sie in Benutzereinstellungen gespeichert haben. [Aufwandsebene anpassen](/docs/de/model-config#adjust-effort-level) listet auf, was sonst noch eine gespeicherte Ebene überschreiben kann, wie `--effort` beim Start.1280Ein `effortLevel` eines Modells hier hat Vorrang vor dem `effortLevel` der obersten Ebene ([`effortLevel`](#effortlevel)) in derselben Einstellungsdatei. Dateiübergreifend löst Claude Code jedes Modell separat auf: Die [Einstellungsdatei](/docs/de/settings#settings-precedence) mit dem höchsten Vorrang, die entweder ein `effortLevel` für dieses Modell oder ein `effortLevel` der obersten Ebene setzt, das [für dieses Modell gilt](#effortlevel), entscheidet, daher hat ein `effortLevel` in verwalteten Einstellungen Vorrang vor einer Stufe, die Sie in Benutzereinstellungen gespeichert haben. [Effort-Stufe anpassen](/docs/de/model-config#adjust-effort-level) listet auf, was eine gespeicherte Stufe sonst noch überschreiben kann, wie `--effort` beim Start.

1223 1281

1224Um ein Modell zu begrenzen, anstatt seine Ebene zu setzen, fügen Sie ein Feld [`maxEffortLevel`](#maxeffortlevel) zum Eintrag dieses Modells hinzu. Das Feld erfordert Claude Code v2.1.267 oder später.1282Um den Effort eines Modells zu begrenzen, anstatt seine Stufe festzulegen, fügen Sie dem Eintrag dieses Modells ein Feld [`maxEffortLevel`](#maxeffortlevel) hinzu. Das Feld erfordert Claude Code v2.1.267 oder später.

1225 1283

1226* **Bereich**: [`Beliebige Datei`](#scopes)1284* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

1227* **Typ**: Objekt, das einen Modellnamen zu einem Objekt mit einem Feld `effortLevel`, einem von `"low"`, `"medium"`, `"high"` oder `"xhigh"`, einem Feld [`maxEffortLevel`](#maxeffortlevel) oder beiden zuordnet1285* **Typ**: Objekt, das einen Modellnamen einem Objekt mit einem Feld `effortLevel` (einer von `"low"`, `"medium"`, `"high"` oder `"xhigh"`), einem Feld [`maxEffortLevel`](#maxeffortlevel) oder beiden zuordnet

1228* **Standard**: nicht gesetzt1286* **Standard**: nicht gesetzt

1229 1287

1230Claude Code schreibt jeden Eintrag unter dem kanonischen Namen des Modells, wie `claude-opus-5-5`, und ordnet den Alias, das Datum-Suffix, `[1m]` und erkannte Anbieter-spezifische IDs dieses Modells dem gleichen Eintrag zu.1288Claude Code schreibt jeden Eintrag unter dem kanonischen Namen des Modells, wie `claude-opus-5-5`, und ordnet den Alias, die IDs mit Datumssuffix, `[1m]` und erkannte providerspezifische IDs dieses Modells demselben Eintrag zu.

1231 1289

1232Dieses Beispiel hält Opus 5.5 auf `high`, während andere Modelle ihre eigenen gespeicherten oder Standard-Ebenen verwenden:1290Dieses Beispiel hält Opus 5.5 auf `high`, während andere Modelle ihre eigenen gespeicherten oder Standardstufen verwenden:

1233 1291

1234```json settings.json theme={null}1292```json settings.json theme={null}

1235{1293{

1241}1299}

1242```1300```

1243 1301

1244Führen Sie `/effort auto` aus, um Ihre gespeicherte Ebene für das Modell zu löschen, das Sie verwenden. Claude Code lässt die anderen Einträge und jeden Top-Level-`effortLevel` in Kraft.1302Führen Sie `/effort auto` aus, um Ihre gespeicherte Stufe für das Modell zu löschen, das Sie verwenden. Claude Code lässt die anderen Einträge und jedes `effortLevel` der obersten Ebene bestehen.

1245 1303

1246<h3 id="outputstyle">1304<h3 id="outputstyle">

1247 `outputStyle`1305 `outputStyle`

1248</h3>1306</h3>

1249 1307

1250Wählen Sie einen [Ausgabestil](/docs/de/output-styles) nach Name. Ein Ausgabestil ist ein gespeicherter Satz von Anweisungen, der Claudes Rolle, Ton und Ausgabeformat ändert, wie die integrierten Explanatory- und Learning-Stile oder einen, den Sie selbst geschrieben haben.1308Wählen Sie einen [Ausgabestil](/docs/de/output-styles) nach Namen aus. Ein Ausgabestil ist ein gespeicherter Satz von Anweisungen, der Claudes Rolle, Ton und Ausgabeformat ändert, wie die integrierten Stile Explanatory und Learning oder ein Stil, den Sie selbst geschrieben haben.

1251 1309

1252Wenn Sie diesen Schlüssel während einer Sitzung ändern, verwendet Claude den neuen Stil ab Ihrer nächsten Nachricht. Für was diese Nachricht im Prompt-Cache kostet, siehe [Ausgabestil ändern](/docs/de/prompt-caching#changing-output-style). Vor v2.1.251 galt die Bearbeitung nur nach dem Ausführen von `/clear` oder dem Starten einer neuen Sitzung.1310Wenn Sie diesen Schlüssel während einer Sitzung ändern, verwendet Claude den neuen Stil ab Ihrer nächsten Nachricht. Was diese Nachricht beim Prompt-Caching kostet, erfahren Sie unter [Ausgabestil ändern](/docs/de/prompt-caching#changing-output-style). Vor v2.1.251 wurde die Änderung erst wirksam, nachdem Sie `/clear` ausgeführt oder eine neue Sitzung gestartet hatten.

1253 1311

1254* **Bereich**: [`Beliebige Datei`](#scopes)1312* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

1255* **Typ**: String, der Name eines [integrierten](/docs/de/output-styles#built-in-output-styles) oder [benutzerdefinierten](/docs/de/output-styles#create-a-custom-output-style) Ausgabestils1313* **Typ**: String, der Name eines [integrierten](/docs/de/output-styles#built-in-output-styles) oder [benutzerdefinierten](/docs/de/output-styles#create-a-custom-output-style) Ausgabestils

1256* **Standard**: nicht gesetzt, daher verwendet Claude Code den Standard-Stil1314* **Standard**: nicht gesetzt, daher verwendet Claude Code den Standardstil

1257 1315

1258Dieses Beispiel wählt den integrierten Explanatory-Stil, der zwischen Aufgaben pädagogische Einblicke hinzufügt:1316Dieses Beispiel wählt den integrierten Stil Explanatory, der zwischen Aufgaben erklärende Einblicke hinzufügt:

1259 1317

1260```json settings.json theme={null}1318```json settings.json theme={null}

1261{1319{

1267 `promptCacheTtl`1325 `promptCacheTtl`

1268</h3>1326</h3>

1269 1327

1270Wählen Sie, wie lange der [Prompt-Cache](/docs/de/prompt-caching) die Hauptkonversation hält. Dieser Schlüssel gilt für Ihre interaktiven, `-p` und Agent SDK-Durchläufe, zusammen mit den Helfern, die Claude Code inline mit ihnen ausführt. Die Einstunden-Lebensdauer hält den Cache über längere Pausen warm, und die API [berechnet jeden Cache-Schreibvorgang zu einem höheren Satz](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) als bei der Fünf-Minuten-Lebensdauer. Erfordert Claude Code v2.1.242 oder später.1328Legen Sie fest, wie lange der [Prompt-Cache](/docs/de/prompt-caching) die Hauptkonversation vorhält. Dieser Schlüssel gilt für Ihre interaktiven, `-p`- und Agent SDK-Turns sowie für die Hilfsanfragen, die Claude Code direkt mit ihnen ausführt. Die einstündige Lebensdauer hält den Cache über längere Pausen warm, und die API [berechnet jeden Cache-Schreibvorgang zu einem höheren Preis](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) als bei der fünfminütigen Lebensdauer. Erfordert Claude Code v2.1.242 oder später.

1271 1329

1272* **Bereich**: [`Beliebige Datei`](#scopes)1330* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

1273* **Typ**: String, einer von:1331* **Typ**: String, einer von:

1274 * `"5m"`: der Cache hält für fünf Minuten1332 * `"5m"`: der Cache hält fünf Minuten

1275 * `"1h"`: der Cache hält für eine Stunde1333 * `"1h"`: der Cache hält eine Stunde

1276* **Standard**: nicht gesetzt, daher erhält jede Hauptkonversations-Anfrage [ihre Standard-Lebensdauer](/docs/de/prompt-caching#which-ttl-each-request-gets)1334* **Standard**: nicht gesetzt, daher erhält jede Anfrage der Hauptkonversation [ihre Standardlebensdauer](/docs/de/prompt-caching#which-ttl-each-request-gets)

1277* **Sitzungsübergreifende Außerkraftsetzungen**: [`FORCE_PROMPT_CACHING_5M`](/docs/de/env-vars) hat Vorrang vor allem anderen, dann [`CLAUDE_CODE_PROMPT_CACHE_TTL`](/docs/de/env-vars), dann dieser Schlüssel, und zuletzt [`ENABLE_PROMPT_CACHING_1H`](/docs/de/env-vars)1335* **Überschreibungen pro Sitzung**: [`FORCE_PROMPT_CACHING_5M`](/docs/de/env-vars) hat Vorrang vor allem anderen, dann [`CLAUDE_CODE_PROMPT_CACHE_TTL`](/docs/de/env-vars), dann dieser Schlüssel und zuletzt [`ENABLE_PROMPT_CACHING_1H`](/docs/de/env-vars)

1278 1336

1279Dieses Beispiel hält die Hauptkonversation auf der Einstunden-Lebensdauer und lässt Subagents auf fünf Minuten:1337Dieses Beispiel hält die Hauptkonversation auf der einstündigen Lebensdauer und lässt Subagenten bei fünf Minuten:

1280 1338

1281```json settings.json theme={null}1339```json settings.json theme={null}

1282{1340{

1285}1343}

1286```1344```

1287 1345

1288Für was jede Lebensdauer kostet, siehe [Cache-Lebensdauer](/docs/de/prompt-caching#cache-lifetime).1346Was jede Lebensdauer kostet, erfahren Sie unter [Cache-Lebensdauer](/docs/de/prompt-caching#cache-lifetime).

1289 1347

1290<h3 id="showthinkingsummaries">1348<h3 id="showthinkingsummaries">

1291 `showThinkingSummaries`1349 `showThinkingSummaries`

1292</h3>1350</h3>

1293 1351

1294Sehen Sie Zusammenfassungen von Claudes [erweitertem Denken](/docs/de/model-config#extended-thinking) in interaktiven Sitzungen. Setzen Sie es, wenn Sie die vollständigen Zusammenfassungen möchten, wenn Sie das Denken mit `Ctrl+O` erweitern. Wenn nicht gesetzt oder `false`, redaktioniert die Anthropic API Denk-Blöcke und Claude Code zeigt einen zusammengefassten Stub; Drittanbieter-Provider redaktionieren nicht.1352Zeigen Sie Zusammenfassungen von Claudes [Extended Thinking](/docs/de/model-config#extended-thinking) in interaktiven Sitzungen an. Setzen Sie den Schlüssel, wenn Sie die vollständigen Zusammenfassungen sehen möchten, wenn Sie Thinking mit `Ctrl+O` aufklappen. Wenn er nicht gesetzt oder `false` ist, schwärzt die Anthropic API Thinking-Blöcke und Claude Code zeigt einen zugeklappten Platzhalter; Drittanbieter-Provider schwärzen nicht.

1295 1353

1296* **Bereich**: [`Beliebige Datei`](#scopes)1354* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

1297* **Typ**: Boolean1355* **Typ**: Boolean

1298 * `true`: Sie sehen vollständige Denk-Zusammenfassungen, wenn Sie das Denken mit `Ctrl+O` erweitern1356 * `true`: Sie sehen vollständige Thinking-Zusammenfassungen, wenn Sie Thinking mit `Ctrl+O` aufklappen

1299 * `false`: die Anthropic API redaktioniert Denk-Blöcke und Claude Code zeigt einen zusammengefassten Stub1357 * `false`: die Anthropic API schwärzt Thinking-Blöcke und Claude Code zeigt einen zugeklappten Platzhalter

1300* **Standard**: `false`1358* **Standard**: `false`

1301 1359

1302```json settings.json theme={null}1360```json settings.json theme={null}

1305}1363}

1306```1364```

1307 1365

1308Redaktion ändert nur, was Sie sehen, nicht was das Modell generiert. Um Denk-Ausgaben zu reduzieren, [senken Sie das Budget oder deaktivieren Sie das Denken](/docs/de/model-config#extended-thinking) stattdessen.1366Die Schwärzung ändert nur, was Sie sehen, nicht was das Modell generiert. Um die Thinking-Kosten zu senken, [verringern Sie stattdessen das Budget oder deaktivieren Sie Thinking](/docs/de/model-config#extended-thinking).

1309 1367

1310<h3 id="subagentpromptcachettl">1368<h3 id="subagentpromptcachettl">

1311 `subagentPromptCacheTtl`1369 `subagentPromptCacheTtl`

1312</h3>1370</h3>

1313 1371

1314Wählen Sie, wie lange der [Prompt-Cache](/docs/de/prompt-caching) die Anfragen hält, die Claude Code außerhalb der Hauptkonversation macht. Dieser Schlüssel gilt für [Subagents](/docs/de/sub-agents), [Workflows](/docs/de/workflows) und Claudes eigene Hintergrund- und Hilfsanfragen, wie Komprimierung und Sitzungstitel. Die Einstunden-Lebensdauer hält den Cache über längere Pausen warm, und die API [berechnet jeden Cache-Schreibvorgang zu einem höheren Satz](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) als bei der Fünf-Minuten-Lebensdauer. Erfordert Claude Code v2.1.242 oder später.1372Legen Sie fest, wie lange der [Prompt-Cache](/docs/de/prompt-caching) die Anfragen vorhält, die Claude Code außerhalb der Hauptkonversation stellt. Dieser Schlüssel gilt für [Subagenten](/docs/de/sub-agents), [Workflows](/docs/de/workflows) und die eigenen Hintergrund- und Hilfsanfragen von Claude Code, wie Komprimierung und Sitzungstitel. Die einstündige Lebensdauer hält den Cache über längere Pausen warm, und die API [berechnet jeden Cache-Schreibvorgang zu einem höheren Preis](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) als bei der fünfminütigen Lebensdauer. Erfordert Claude Code v2.1.242 oder später.

1315 1373

1316* **Bereich**: [`Beliebige Datei`](#scopes)1374* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

1317* **Typ**: String, einer von:1375* **Typ**: String, einer von:

1318 * `"5m"`: der Cache hält für fünf Minuten1376 * `"5m"`: der Cache hält fünf Minuten

1319 * `"1h"`: der Cache hält für eine Stunde1377 * `"1h"`: der Cache hält eine Stunde

1320* **Standard**: nicht gesetzt, daher erhält jede dieser Anfragen [ihre Standard-Lebensdauer](/docs/de/prompt-caching#which-ttl-each-request-gets)1378* **Standard**: nicht gesetzt, daher erhält jede dieser Anfragen [ihre Standardlebensdauer](/docs/de/prompt-caching#which-ttl-each-request-gets)

1321* **Sitzungsübergreifende Außerkraftsetzungen**: [`FORCE_PROMPT_CACHING_5M`](/docs/de/env-vars) hat Vorrang vor allem anderen, dann [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](/docs/de/env-vars), dann dieser Schlüssel, dann [`ENABLE_PROMPT_CACHING_1H`](/docs/de/env-vars), das die Einstunden-Lebensdauer bei jeder Anfrage anfordert. Für wo der Wert der eigenen Frontmatter eines Subagents rangiert, siehe [Wählen Sie die TTL selbst](/docs/de/prompt-caching#choose-the-ttl-yourself)1379* **Überschreibungen pro Sitzung**: [`FORCE_PROMPT_CACHING_5M`](/docs/de/env-vars) hat Vorrang vor allem anderen, dann [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](/docs/de/env-vars), dann dieser Schlüssel, dann [`ENABLE_PROMPT_CACHING_1H`](/docs/de/env-vars), das für jede Anfrage die einstündige Lebensdauer anfordert. Wo der Frontmatter-Wert eines Subagenten selbst in dieser Rangfolge steht, erfahren Sie unter [Die TTL selbst wählen](/docs/de/prompt-caching#choose-the-ttl-yourself)

1322 1380

1323Dieses Beispiel gibt Subagents und den anderen Anfragen außerhalb der Hauptkonversation die Einstunden-Lebensdauer:1381Dieses Beispiel gibt Subagenten und den anderen Anfragen außerhalb der Hauptkonversation die einstündige Lebensdauer:

1324 1382

1325```json settings.json theme={null}1383```json settings.json theme={null}

1326{1384{

1328}1386}

1329```1387```

1330 1388

1331Dieser Schlüssel deckt die Anfragen ab, die [`promptCacheTtl`](#promptcachettl) nicht abdeckt, daher setzen Sie beide, um eine Lebensdauer für jede Anfrage zu wählen, die Claude Code macht. Für wie sich der Cache eines Subagents vom Cache der Hauptkonversation unterscheidet, siehe [Subagents und der Cache](/docs/de/prompt-caching#subagents-and-the-cache).1389Dieser Schlüssel deckt die Anfragen ab, die [`promptCacheTtl`](#promptcachettl) nicht abdeckt, daher setzen Sie beide, um für jede Anfrage von Claude Code eine Lebensdauer festzulegen. Wie sich der Cache eines Subagenten von dem der Hauptkonversation unterscheidet, erfahren Sie unter [Subagenten und der Cache](/docs/de/prompt-caching#subagents-and-the-cache).

1332 1390

1333<h3 id="switchmodelsonflag">1391<h3 id="switchmodelsonflag">

1334 `switchModelsOnFlag`1392 `switchModelsOnFlag`

1335</h3>1393</h3>

1336 1394

1337Wählen Sie, was passiert, wenn ein [Sicherheits-Klassifizierer eine Anfrage kennzeichnet](/docs/de/model-config#automatic-model-fallback): zum Fallback-Modell wechseln und fortfahren, oder pausieren, damit Sie zwischen Wechsel und Bearbeitung der Eingabeaufforderung wählen können.1395Legen Sie fest, was passiert, wenn ein [Sicherheits-Klassifikator eine Anfrage kennzeichnet](/docs/de/model-config#automatic-model-fallback): zum Fallback-Modell wechseln und fortfahren oder pausieren, damit Sie zwischen Wechseln und Bearbeiten des Prompts wählen können.

1338 1396

1339* **Bereich**: [`Beliebige Datei`](#scopes). Erscheint in `/config` als **Modelle wechseln, wenn eine Nachricht gekennzeichnet ist**.1397* **Geltungsbereich**: [`Beliebige Datei`](#scopes). Erscheint in `/config` als **Modelle wechseln, wenn eine Nachricht gekennzeichnet ist**.

1340* **Typ**: Boolean1398* **Typ**: Boolean

1341 * `true`: Claude Code wechselt zum Fallback-Modell und fährt fort1399 * `true`: Claude Code wechselt zum Fallback-Modell und fährt fort

1342 * `false`: in einer interaktiven Sitzung pausiert Claude Code, damit Sie zwischen Wechsel und Bearbeitung der Eingabeaufforderung wählen können; wo kein Dialog angezeigt werden kann, wie ein `-p`-Lauf, endet die gekennzeichnete Anfrage als Fehler1400 * `false`: In einer interaktiven Sitzung pausiert Claude Code, damit Sie zwischen Wechseln und Bearbeiten des Prompts wählen können; wo kein Dialog angezeigt werden kann, wie bei einem `-p`-Lauf, endet die gekennzeichnete Anfrage mit einem Fehler

1343* **Standard**: `true`, automatisch wechseln1401* **Standard**: `true`, automatisch wechseln

1344 1402

1345```json settings.json theme={null}1403```json settings.json theme={null}

1354 `ultracode`1412 `ultracode`

1355</h3>1413</h3>

1356 1414

1357Starten Sie Sitzungen mit [Ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) an. Mit ihm an, plant Claude einen Workflow für jede wesentliche Aufgabe, anstatt auf Sie zu warten, um zu fragen. Claude plant Workflows nur, wenn [dynamische Workflows](/docs/de/workflows) für Sie aktiviert sind, Ihr Modell `xhigh`-Aufwand unterstützt und kein [Aufwandslimit](/docs/de/model-config#organization-effort-limits) unter `xhigh` gilt. Auf jeden Fall läuft `ultracode: true` die Sitzung auf `xhigh`-Aufwand oder bei der Obergrenze, wenn ein Aufwandslimit niedriger ist. Claude Code liest diesen Schlüssel, schreibt ihn aber nie: `/effort ultracode` aktiviert Ultracode nur für die aktuelle Sitzung.1415Starten Sie Sitzungen mit aktiviertem [Ultracode](/docs/de/workflows#let-claude-decide-with-ultracode). Wenn es aktiviert ist, plant Claude für jede substanzielle Aufgabe einen Workflow, anstatt darauf zu warten, dass Sie darum bitten. Claude plant Workflows nur, wenn [dynamische Workflows](/docs/de/workflows) für Sie aktiviert sind und Ihr Modell den Effort `xhigh` unterstützt. Der Schlüssel ändert die Effort-Stufe der Sitzung nicht: Ultracode läuft mit der Stufe, die die Sitzung verwendet. Claude Code liest diesen Schlüssel, schreibt ihn aber nie: `/effort ultracode` aktiviert Ultracode nur für die aktuelle Sitzung.

1358 1416

1359* **Bereich**: [`Beliebige Datei`](#scopes)1417* **Geltungsbereich**: [`Beliebige Datei`](#scopes)

1360* **Typ**: Boolean1418* **Typ**: Boolean

1361 * `true`: Sitzungen starten auf `xhigh`-Aufwand, mit Ultracode an, wenn dynamische Workflows für Sie aktiviert sind, Ihr Modell `xhigh` unterstützt und kein Aufwandslimit unter `xhigh` ist1419 * `true`: Sitzungen starten mit aktiviertem Ultracode, wenn dynamische Workflows für Sie aktiviert sind und Ihr Modell `xhigh` unterstützt

1362 * `false`: Sitzungen starten mit Ultracode aus1420 * `false`: Sitzungen starten mit deaktiviertem Ultracode

1363* **Standard**: nicht gesetzt, daher ist Ultracode aus1421* **Standard**: nicht gesetzt, daher ist Ultracode deaktiviert

1364* **Sitzungsübergreifende Außerkraftsetzungen**: `/effort ultracode` aktiviert Ultracode für eine Sitzung ohne diesen Schlüssel. Das Flag `--effort ultracode` aktiviert es auch für eine Sitzung und erfordert Claude Code v2.1.203 oder später1422* **Überschreibungen pro Sitzung**: `/effort ultracode` aktiviert Ultracode für eine Sitzung ohne diesen Schlüssel, und `/effort ultracode off` deaktiviert es für eine Sitzung, wenn dieser Schlüssel `true` ist. Das Flag `--effort ultracode` aktiviert es ebenfalls für eine Sitzung, mit dem Effort `xhigh`, und erfordert Claude Code v2.1.203 oder später

1365 1423

1366```json settings.json theme={null}1424```json settings.json theme={null}

1367{1425{

1369}1427}

1370```1428```

1371 1429

1372Ultracode läuft die Sitzung auf `xhigh`-Aufwand und hat Vorrang vor `effortLevel` und [`modelSettings`](#modelsettings)-Einträgen. Wenn ein [Aufwandslimit](/docs/de/model-config#organization-effort-limits) unter `xhigh` auf das Modell anwendet, wie eine [`maxEffortLevel`](#maxeffortlevel)-Einstellung, läuft die Sitzung stattdessen bei der Obergrenze und Ultracode bleibt aus. Claude plant dann keine Workflows von selbst, und `/effort` bietet nicht `ultracode` an. Eine Agent SDK `apply_flag_settings`-Kontrollabfrage akzeptiert auch den Schlüssel.1430Die Effort-Stufe der Sitzung ergibt sich aus [`effortLevel`](#effortlevel), [`modelSettings`](#modelsettings) und den anderen [Effort-Quellen](/docs/de/model-config#adjust-effort-level), und eine [Effort-Obergrenze](/docs/de/model-config#organization-effort-limits) wie [`maxEffortLevel`](#maxeffortlevel) senkt diese Stufe, ohne Ultracode auszuschalten. Dies und die Form `/effort ultracode off` erfordern Claude Code v2.1.284 oder später. Vor v2.1.284 ließ `ultracode: true` die Sitzung mit dem Effort `xhigh` laufen, und eine Effort-Obergrenze unter `xhigh` hielt Ultracode ausgeschaltet. Eine Agent SDK-Steuerungsanfrage `apply_flag_settings` akzeptiert den Schlüssel ebenfalls.

1373 1431

1374<h2 id="permission-settings">1432<h2 id="permission-settings">

1375 Berechtigungseinstellungen1433 Berechtigungseinstellungen

1376</h2>1434</h2>

1377 1435

1378Entscheiden Sie, was Claude ohne Nachfrage tun kann, in welchem Berechtigungsmodus eine Sitzung startet, und was der Klassifizierer des Auto-Modus zulässt. Informationen zur Regelsyntax und zum Berechtigungsmodell finden Sie unter [Berechtigungen konfigurieren](/docs/de/permissions).1436Entscheiden Sie, was Claude ohne Nachfrage tun kann, in welchem Berechtigungsmodus eine Sitzung startet, und was der Klassifikator des Auto-Modus zulässt. Informationen zur Regelsyntax und zum Berechtigungsmodell finden Sie unter [Berechtigungen konfigurieren](/docs/de/permissions).

1379 1437

1380<h3 id="allowmanagedpermissionrulesonly">1438<h3 id="allowmanagedpermissionrulesonly">

1381 `allowManagedPermissionRulesOnly`1439 `allowManagedPermissionRulesOnly`

1382</h3>1440</h3>

1383 1441

1384Machen Sie verwaltete Einstellungen zur einzigen Quelle für Berechtigungsregeln. Claude Code ignoriert dann `allow`-, `ask`- und `deny`-Regeln in Benutzer-, Projekt-, lokalen und `--settings`-Dateien, ignoriert `--allowedTools`, blendet die Optionen zum Immer-Zulassen in Berechtigungsaufforderungen aus und speichert keine neuen Regeln.1442Machen Sie verwaltete Einstellungen zur einzigen Quelle für Berechtigungsregeln. Claude Code ignoriert dann `allow`-, `ask`- und `deny`-Regeln in Benutzer-, Projekt-, lokalen und `--settings`-Dateien, ignoriert `--allowedTools`, blendet die Optionen zum Immer-Zulassen in Berechtigungsabfragen aus und speichert keine neuen Regeln.

1385 1443

1386Wenn [übergeordnete Einstellungen von einem Embedding-Host](/docs/de/managed-settings#let-an-embedding-host-add-policy) gelten, behandelt Claude Code diese als Teil der verwalteten Ebene. Es verwirft deren `allow`-Regeln und `additionalDirectories` und behält deren `deny`- und `ask`-Regeln bei, außer `Read`- und `Edit`-Regeln, deren Muster mit `!` beginnt. Ein Host kann Pfade aus den verwalteten Regeln nicht mit einer `!`-Regel ausschneiden, unabhängig davon, ob Sie diesen Schlüssel setzen oder nicht.1444Wenn [übergeordnete Einstellungen von einem Embedding-Host](/docs/de/managed-settings#let-an-embedding-host-add-policy) gelten, behandelt Claude Code diese als Teil der verwalteten Ebene. Es verwirft deren `allow`-Regeln und `additionalDirectories` und behält deren `deny`- und `ask`-Regeln bei, außer `Read`- und `Edit`-Regeln, deren Muster mit `!` beginnt. Ein Host kann Pfade aus den verwalteten Regeln nicht mit einer `!`-Regel ausschneiden, unabhängig davon, ob Sie diesen Schlüssel setzen oder nicht.

1387 1445

1389 1447

1390Informationen dazu, was ein `!`-Muster in einer `--disallowedTools`- oder Sitzungsregel ausschneiden kann, finden Sie unter [Read- und Edit-Regeln](/docs/de/permissions#read-and-edit).1448Informationen dazu, was ein `!`-Muster in einer `--disallowedTools`- oder Sitzungsregel ausschneiden kann, finden Sie unter [Read- und Edit-Regeln](/docs/de/permissions#read-and-edit).

1391 1449

1392* **Bereich**: [`Managed`](#scopes)1450* **Geltungsbereich**: [`Managed`](#scopes)

1393* **Typ**: Boolean1451* **Typ**: Boolean

1394 * `true`: verwaltete Einstellungen werden zur einzigen Quelle für Berechtigungsregeln1452 * `true`: verwaltete Einstellungen werden zur einzigen Quelle für Berechtigungsregeln

1395 * `false`: Claude Code wendet Berechtigungsregeln aus Benutzer-, Projekt-, lokalen und `--settings`-Dateien zusätzlich zu den verwalteten an1453 * `false`: Claude Code wendet Berechtigungsregeln aus Benutzer-, Projekt-, lokalen und `--settings`-Dateien zusätzlich zu den verwalteten an

1401}1459}

1402```1460```

1403 1461

1404Dieser Schlüssel sperrt nicht die MCP-Server-Zulassungsliste; verwenden Sie dazu [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly). Siehe [Nur verwaltete Einstellungen](/docs/de/managed-settings#managed-only-settings).1462Dieser Schlüssel sperrt nicht die MCP-Server-Allowlist; verwenden Sie dazu [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly). Siehe [Nur verwaltete Einstellungen](/docs/de/managed-settings#managed-only-settings).

1405 1463

1406<h3 id="automode">1464<h3 id="automode">

1407 `autoMode`1465 `autoMode`

1408</h3>1466</h3>

1409 1467

1410Fügen Sie Ihre eigenen Regeln zu dem hinzu, was der [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)-Klassifizierer blockiert und zulässt. Verwenden Sie es, um dem Klassifizierer mitzuteilen, welche Repos, Buckets und Domains Ihre Organisation vertraut, damit er routinemäßige interne Operationen nicht mehr blockiert. Der Klassifizierer wird mit [integrierten Allow- und Deny-Regeln](/docs/de/auto-mode-config#inspect-the-defaults-and-your-effective-config) ausgeliefert. Fügen Sie die Literalzeichenfolge `"$defaults"` in einem Array ein, um diese integrierten Regeln an dieser Position zu behalten und Ihre Regeln um sie herum hinzuzufügen; lassen Sie sie weg, um sie durch Ihre zu ersetzen.1468Fügen Sie Ihre eigenen Regeln zu dem hinzu, was der [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)-Klassifikator blockiert und zulässt. Verwenden Sie es, um dem Klassifikator mitzuteilen, welchen Repos, Buckets und Domains Ihre Organisation vertraut, damit er alltägliche interne Vorgänge nicht mehr blockiert. Der Klassifikator wird mit [integrierten Allow- und Deny-Regeln](/docs/de/auto-mode-config#inspect-the-defaults-and-your-effective-config) ausgeliefert. Fügen Sie die Literalzeichenfolge `"$defaults"` in einem Array ein, um diese integrierten Regeln an dieser Position zu behalten und Ihre Regeln um sie herum hinzuzufügen; lassen Sie sie weg, um sie durch Ihre zu ersetzen.

1411 1469

1412* **Bereich**: [`User or managed`](#scopes)1470* **Geltungsbereich**: [`User or managed`](#scopes)

1413* **Typ**: Objekt mit `environment`-, `allow`-, `soft_deny`- und `hard_deny`-Arrays von Prosa-Regeln sowie dem Boolean [`classifyAllShell`](#automode-classifyallshell)1471* **Typ**: Objekt mit `environment`-, `allow`-, `soft_deny`- und `hard_deny`-Arrays von Prosa-Regeln sowie dem Boolean [`classifyAllShell`](#automode-classifyallshell)

1414* **Standard**: nicht gesetzt, daher verwendet der Klassifizierer nur seine [integrierten Regeln](/docs/de/auto-mode-config#inspect-the-defaults-and-your-effective-config)1472* **Standard**: nicht gesetzt, daher verwendet der Klassifikator nur seine [integrierten Regeln](/docs/de/auto-mode-config#inspect-the-defaults-and-your-effective-config)

1415 1473

1416Dieses Beispiel behält die integrierten `soft_deny`-Regeln durch `"$defaults"` und fügt eine weitere hinzu, die `terraform apply` blockiert:1474Dieses Beispiel behält die integrierten `soft_deny`-Regeln durch `"$defaults"` und fügt eine weitere hinzu, die `terraform apply` blockiert:

1417 1475

1429 `autoMode.classifyAllShell`1487 `autoMode.classifyAllShell`

1430</h3>1488</h3>

1431 1489

1432Senden Sie jeden Bash- und PowerShell-Befehl durch den Auto-Modus-Klassifizierer, während der Auto-Modus aktiv ist. Standardmäßig setzt der Auto-Modus nur Allow-Regeln aus, die beliebigen Code ausführen könnten: Tool-weite und Wildcard-Regeln wie `Bash(*)` sowie Interpreter- oder Shell-Wrapper-Präfixe wie `Bash(python *)`. Ein Befehl, der einer anderen Allow-Regel entspricht, wie `Bash(npm test)`, überspringt den Klassifizierer, es sei denn, er trägt [Pro-Befehl zulässige Domains](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode). Wenn er überspringt, kann ein destruktives Argument, das das Präfix der Regel nicht erwartet hat, ungesehen durchkommen. Das Setzen dieses Schlüssels setzt jede Shell-Allow-Regel für die Sitzung aus, damit der Klassifizierer jeden Befehl sieht. Erfordert Claude Code v2.1.193 oder später.1490Senden Sie jeden Bash- und PowerShell-Befehl durch den Auto-Modus-Klassifikator, während der Auto-Modus aktiv ist. Standardmäßig setzt der Auto-Modus nur Allow-Regeln aus, die beliebigen Code ausführen könnten: Tool-weite und Wildcard-Regeln wie `Bash(*)` sowie Interpreter- oder Shell-Wrapper-Präfixe wie `Bash(python *)`. Ein Befehl, der einer anderen Allow-Regel entspricht, wie `Bash(npm test)`, überspringt den Klassifikator, es sei denn, er trägt [Pro-Befehl zulässige Domains](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode). Wenn er überspringt, kann ein destruktives Argument, das das Präfix der Regel nicht erwartet hat, ungesehen durchkommen. Das Setzen dieses Schlüssels setzt jede Shell-Allow-Regel für die Sitzung aus, damit der Klassifikator jeden Befehl sieht. Erfordert Claude Code v2.1.193 oder später.

1433 1491

1434* **Bereich**: [`User or managed`](#scopes). Lesen Sie überall dort, wo [`autoMode`](#automode) gelesen wird.1492* **Geltungsbereich**: [`User or managed`](#scopes). Wird überall dort gelesen, wo [`autoMode`](#automode) gelesen wird.

1435* **Typ**: Boolean1493* **Typ**: Boolean

1436 * `true`: Während der Auto-Modus aktiv ist, sendet Claude Code jeden Bash- und PowerShell-Befehl durch den Klassifizierer und setzt Ihre Shell-Allow-Regeln aus; außerhalb des Auto-Modus gelten die Regeln weiterhin1494 * `true`: Während der Auto-Modus aktiv ist, sendet Claude Code jeden Bash- und PowerShell-Befehl durch den Klassifikator und setzt Ihre Shell-Allow-Regeln aus; außerhalb des Auto-Modus gelten die Regeln weiterhin

1437 * `false`: Der Auto-Modus setzt nur Allow-Regeln aus, die beliebigen Code ausführen könnten, wie `Bash(*)` und `Bash(python *)`; ein Befehl, der einer anderen Allow-Regel entspricht, überspringt den Klassifizierer, es sei denn, er trägt [Pro-Befehl zulässige Domains](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode), und jeder andere Shell-Befehl wird durch ihn geleitet1495 * `false`: Der Auto-Modus setzt nur Allow-Regeln aus, die beliebigen Code ausführen könnten, wie `Bash(*)` und `Bash(python *)`; ein Befehl, der einer anderen Allow-Regel entspricht, überspringt den Klassifikator, es sei denn, er trägt [Pro-Befehl zulässige Domains](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode), und jeder andere Shell-Befehl wird durch ihn geleitet

1438* **Standard**: `false`1496* **Standard**: `false`

1439 1497

1440```json settings.json theme={null}1498```json settings.json theme={null}

1445}1503}

1446```1504```

1447 1505

1448Siehe [Alle Shell-Befehle durch den Klassifizierer leiten](/docs/de/auto-mode-config#route-all-shell-commands-through-the-classifier). Erfordert Claude Code v2.1.193 oder später.1506Siehe [Alle Shell-Befehle durch den Klassifikator leiten](/docs/de/auto-mode-config#route-all-shell-commands-through-the-classifier). Erfordert Claude Code v2.1.193 oder später.

1449 1507

1450<h3 id="disableautomode">1508<h3 id="disableautomode">

1451 `disableAutoMode`1509 `disableAutoMode`

1453 1511

1454Entfernen Sie den [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) aus dem `Shift+Tab`-Zyklus. Jede Sitzung, die sonst [im Auto-Modus starten würde](/docs/de/permission-modes#which-mode-a-session-starts-in), ob von `--permission-mode auto`, einer Einstellungsdatei oder dem integrierten Standard, startet stattdessen im `default`-Modus. Administratoren setzen es in verwalteten Einstellungen, um zu verhindern, dass Entwickler in ihrer Organisation den Auto-Modus verwenden.1512Entfernen Sie den [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) aus dem `Shift+Tab`-Zyklus. Jede Sitzung, die sonst [im Auto-Modus starten würde](/docs/de/permission-modes#which-mode-a-session-starts-in), ob von `--permission-mode auto`, einer Einstellungsdatei oder dem integrierten Standard, startet stattdessen im `default`-Modus. Administratoren setzen es in verwalteten Einstellungen, um zu verhindern, dass Entwickler in ihrer Organisation den Auto-Modus verwenden.

1455 1513

1456* **Bereich**: [`Any file`](#scopes). Am nützlichsten in [verwalteten Einstellungen](/docs/de/managed-settings), wo Benutzer es nicht überschreiben können. Auch unter `permissions` als `permissions.disableAutoMode` akzeptiert.1514* **Geltungsbereich**: [`Any file`](#scopes). Am nützlichsten in [verwalteten Einstellungen](/docs/de/managed-settings), wo Benutzer es nicht überschreiben können. Auch unter `permissions` als `permissions.disableAutoMode` akzeptiert.

1457* **Typ**: die Zeichenfolge `"disable"`1515* **Typ**: die Zeichenfolge `"disable"`

1458* **Standard**: nicht gesetzt1516* **Standard**: nicht gesetzt

1459 1517

1467 `permissions`1525 `permissions`

1468</h3>1526</h3>

1469 1527

1470Steuern Sie, welche Tools Claude ohne Nachfrage verwenden kann, welche immer eine Aufforderung anzeigen, und welche blockiert sind, und legen Sie den [Berechtigungsmodus](/docs/de/permission-modes) fest, in dem eine Sitzung startet. Jeder `permissions.*`-Schlüssel unten verschachtelt sich unter diesem Objekt.1528Steuern Sie, welche Tools Claude ohne Nachfrage verwenden kann, bei welchen immer nachgefragt wird und welche blockiert sind, und legen Sie den [Berechtigungsmodus](/docs/de/permission-modes) fest, in dem eine Sitzung startet. Jeder `permissions.*`-Schlüssel unten verschachtelt sich unter diesem Objekt.

1471 1529

1472* **Bereich**: [`Any file`](#scopes)1530* **Geltungsbereich**: [`Any file`](#scopes)

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

1474* **Standard**: nicht gesetzt1532* **Standard**: nicht gesetzt

1475 1533

1476Dieses Beispiel genehmigt `npm run`-Befehle ohne Nachfrage, fordert vor `git push` auf, blockiert Lesevorgänge von `.env` und startet Sitzungen im `acceptEdits`-Modus:1534Dieses Beispiel genehmigt `npm run`-Befehle ohne Nachfrage, fragt vor `git push` nach, blockiert Lesevorgänge von `.env` und startet Sitzungen im `acceptEdits`-Modus:

1477 1535

1478```json settings.json theme={null}1536```json settings.json theme={null}

1479{1537{

1486}1544}

1487```1545```

1488 1546

1489Die drei Regel-Arrays teilen sich eine Syntax; siehe [Berechtigungsregelsyntax](#permission-rule-syntax) unter `permissions.allow`. Informationen dazu, wie Berechtigungsregeln aus verschiedenen Dateien kombiniert werden, finden Sie unter [Wie Berechtigungsregeln über Bereiche hinweg zusammengeführt werden](/docs/de/permissions#settings-precedence); Informationen dazu, wie Einstellungsschlüssel im Allgemeinen kombiniert werden, finden Sie unter [Einstellungspriorität](/docs/de/settings#settings-precedence) im Einstellungshandbuch.1547Die drei Regel-Arrays teilen sich eine Syntax; siehe [Berechtigungsregelsyntax](#permission-rule-syntax) unter `permissions.allow`. Informationen dazu, wie Berechtigungsregeln aus verschiedenen Dateien kombiniert werden, finden Sie unter [Wie Berechtigungsregeln über Geltungsbereiche hinweg zusammengeführt werden](/docs/de/permissions#settings-precedence); Informationen dazu, wie Einstellungsschlüssel im Allgemeinen kombiniert werden, finden Sie unter [Einstellungspriorität](/docs/de/settings#settings-precedence) im Einstellungshandbuch.

1490 1548

1491<h3 id="useautomodeduringplan">1549<h3 id="useautomodeduringplan">

1492 `useAutoModeDuringPlan`1550 `useAutoModeDuringPlan`

1493</h3>1551</h3>

1494 1552

1495Wählen Sie, ob Claude Code den Auto-Modus-Klassifizierer verwendet, um Shell-Befehle im Plan-Modus zu überprüfen. Mit dem Standard `true` überprüft der Klassifizierer jeden Befehl während der Planung, wenn der Auto-Modus verfügbar ist, und Sie sehen keine Aufforderung. Setzen Sie `false`, um für jeden Befehl außerhalb des integrierten schreibgeschützten Satzes eine Berechtigungsaufforderung zu erhalten. Wird in `/config` als **Auto-Modus während Plan verwenden** angezeigt.1553Wählen Sie, ob Claude Code den Auto-Modus-Klassifikator verwendet, um Shell-Befehle im Plan-Modus zu überprüfen. Mit dem Standard `true` überprüft der Klassifikator jeden Befehl während der Planung, wenn der Auto-Modus verfügbar ist, und Sie sehen keine Abfrage, außer bei [Entfernungen kritischer Pfade](/docs/de/permission-modes#critical-paths). Setzen Sie `false`, um für jeden Befehl außerhalb des integrierten Satzes nur lesender Befehle eine Berechtigungsabfrage zu erhalten. Wird in `/config` als **Auto-Modus während Plan verwenden** angezeigt.

1496 1554

1497* **Bereich**: [`User, local, or managed`](#scopes). Ein Repository kann es nicht für Sie ausschalten.1555* **Geltungsbereich**: [`User, local, or managed`](#scopes). Ein Repository kann es nicht für Sie ausschalten.

1498* **Typ**: Boolean1556* **Typ**: Boolean

1499 * `true`: dasselbe wie nicht gesetzt; wenn der Auto-Modus verfügbar ist, überprüft der Klassifizierer jeden Shell-Befehl während der Planung, anstatt Sie dafür aufzufordern. Ein `false` in einer dieser Dateien schaltet es immer noch aus1557 * `true`: dasselbe wie nicht gesetzt; wenn der Auto-Modus verfügbar ist, überprüft der Klassifikator jeden Shell-Befehl während der Planung, anstatt bei Ihnen nachzufragen, außer bei [Entfernungen kritischer Pfade](/docs/de/permission-modes#critical-paths). Ein `false` in einer dieser Dateien schaltet es immer noch aus

1500 * `false`: Sie erhalten eine Berechtigungsaufforderung für jeden Befehl außerhalb des integrierten schreibgeschützten Satzes1558 * `false`: Sie erhalten eine Berechtigungsabfrage für jeden Befehl außerhalb des integrierten Satzes nur lesender Befehle

1501* **Standard**: `true`1559* **Standard**: `true`

1502 1560

1503```json settings.json theme={null}1561```json settings.json theme={null}

1512 1570

1513Listen Sie die Tool-Verwendungen auf, die Claude Code ohne Nachfrage genehmigt. In einer MCP-Regel kann `*` nur im Tool-Namen nach dem `mcp__<server>__`-Präfix erscheinen, wie `mcp__github__get_*`; es kann nicht im Server-Namen erscheinen.1571Listen Sie die Tool-Verwendungen auf, die Claude Code ohne Nachfrage genehmigt. In einer MCP-Regel kann `*` nur im Tool-Namen nach dem `mcp__<server>__`-Präfix erscheinen, wie `mcp__github__get_*`; es kann nicht im Server-Namen erscheinen.

1514 1572

1515* **Bereich**: [`Any file`](#scopes)1573* **Geltungsbereich**: [`Any file`](#scopes)

1516* **Typ**: Array von Berechtigungsregel-Zeichenfolgen1574* **Typ**: Array von Berechtigungsregel-Zeichenfolgen

1517* **Standard**: nicht gesetzt1575* **Standard**: nicht gesetzt

1518* **Sitzungsspezifische Überschreibungen**: `--allowedTools` fügt Allow-Regeln für eine Sitzung hinzu, und eine Deny-Regel aus einer Einstellungsdatei blockiert immer noch ein Tool, das sie benennt1576* **Sitzungsspezifische Überschreibungen**: `--allowedTools` fügt Allow-Regeln für eine Sitzung hinzu, und eine Deny-Regel aus einer Einstellungsdatei blockiert immer noch ein Tool, das sie benennt

1535 1593

1536Berechtigungsregeln folgen dem Format `Tool` oder `Tool(specifier)`. Claude Code wertet `deny`-Regeln zuerst aus, dann `ask`, dann `allow`, und die erste Übereinstimmung entscheidet, unabhängig davon, wie spezifisch jede Regel ist; siehe die [Berechtigungsregel-Evaluierungsreihenfolge](/docs/de/permissions#manage-permissions).1594Berechtigungsregeln folgen dem Format `Tool` oder `Tool(specifier)`. Claude Code wertet `deny`-Regeln zuerst aus, dann `ask`, dann `allow`, und die erste Übereinstimmung entscheidet, unabhängig davon, wie spezifisch jede Regel ist; siehe die [Berechtigungsregel-Evaluierungsreihenfolge](/docs/de/permissions#manage-permissions).

1537 1595

1538Jede Zeile zeigt eine Regelform und was sie entspricht.1596Jede Zeile zeigt eine Regelform und worauf sie zutrifft.

1539 1597

1540| Regel | Was sie entspricht |1598| Regel | Worauf sie zutrifft |

1541| :- | :- |1599| :- | :- |

1550 `permissions.ask`1608 `permissions.ask`

1551</h3>1609</h3>

1552 1610

1553Listen Sie die Tool-Verwendungen auf, die Sie zur Bestätigung auffordern, auch in einem Berechtigungsmodus, der sie sonst genehmigen würde, wie `acceptEdits` oder `bypassPermissions`. Im `dontAsk`-Modus verweigert Claude Code eine entsprechende Tool-Verwendung, anstatt aufzufordern.1611Listen Sie die Tool-Verwendungen auf, bei denen Sie um Bestätigung gebeten werden, auch in einem Berechtigungsmodus, der sie sonst genehmigen würde, wie `acceptEdits` oder `bypassPermissions`. Im `dontAsk`-Modus verweigert Claude Code eine entsprechende Tool-Verwendung, anstatt nachzufragen.

1554 1612

1555* **Bereich**: [`Any file`](#scopes)1613* **Geltungsbereich**: [`Any file`](#scopes)

1556* **Typ**: Array von Berechtigungsregel-Zeichenfolgen1614* **Typ**: Array von Berechtigungsregel-Zeichenfolgen

1557* **Standard**: nicht gesetzt1615* **Standard**: nicht gesetzt

1558 1616

1572 1630

1573Listen Sie die Tool-Verwendungen auf, die Claude Code blockiert. Verwenden Sie es für Dateien, die API-Schlüssel, Geheimnisse oder Umgebungswerte enthalten: Claude Code schließt entsprechende Dateien aus der Dateiermittlung und Suchergebnissen aus, verweigert Lesevorgänge dafür und blockiert die [Edit- und Write-Tools](/docs/de/permissions#read-and-edit) auf den entsprechenden Pfaden.1631Listen Sie die Tool-Verwendungen auf, die Claude Code blockiert. Verwenden Sie es für Dateien, die API-Schlüssel, Geheimnisse oder Umgebungswerte enthalten: Claude Code schließt entsprechende Dateien aus der Dateiermittlung und Suchergebnissen aus, verweigert Lesevorgänge dafür und blockiert die [Edit- und Write-Tools](/docs/de/permissions#read-and-edit) auf den entsprechenden Pfaden.

1574 1632

1575Read- und Edit-Deny-Regeln gelten für Claude's integrierte Datei-Tools, für Dateibefehle, die Claude Code in Bash erkennt, wie `cat`, `head`, `tail`, `sed` und `tee`, und für die Ziele von Bash-[Umleitungen](/docs/de/permissions#redirections) wie `> file` und `< file`; sie gelten nicht für einen Befehl, der Dateien liest, ohne sie zu benennen, wie `grep -r pattern .`, oder für beliebige Unterprozesse, daher [aktivieren Sie die Sandbox](/docs/de/sandboxing) für OS-Ebenen-Durchsetzung.1633Read- und Edit-Deny-Regeln gelten für die integrierten Datei-Tools von Claude, für Dateibefehle, die Claude Code in Bash erkennt, wie `cat`, `head`, `tail`, `sed` und `tee`, und für die Ziele von Bash-[Umleitungen](/docs/de/permissions#redirections) wie `> file` und `< file`; sie gelten nicht für einen Befehl, der Dateien liest, ohne sie zu benennen, wie `grep -r pattern .`, oder für beliebige Unterprozesse, daher [aktivieren Sie die Sandbox](/docs/de/sandboxing) für eine Durchsetzung auf Betriebssystemebene.

1576 1634

1577* **Bereich**: [`Any file`](#scopes)1635* **Geltungsbereich**: [`Any file`](#scopes)

1578* **Typ**: Array von Berechtigungsregel-Zeichenfolgen1636* **Typ**: Array von Berechtigungsregel-Zeichenfolgen

1579* **Standard**: nicht gesetzt1637* **Standard**: nicht gesetzt

1580* **Sitzungsspezifische Überschreibungen**: `--disallowedTools` fügt Deny-Regeln für eine Sitzung neben diesem Schlüssel hinzu1638* **Sitzungsspezifische Überschreibungen**: `--disallowedTools` fügt Deny-Regeln für eine Sitzung neben diesem Schlüssel hinzu

1581 1639

1582Dieses Beispiel verweigert Lesevorgänge von `.env`-Dateien, dem `secrets`-Verzeichnis und einer Credentials-Datei und blockiert `curl`-Befehle:1640Dieses Beispiel verweigert Lesevorgänge von `.env`-Dateien, dem `secrets`-Verzeichnis und einer Datei mit Anmeldedaten und blockiert `curl`-Befehle:

1583 1641

1584```json settings.json theme={null}1642```json settings.json theme={null}

1585{1643{

1595}1653}

1596```1654```

1597 1655

1598Tool-Namen akzeptieren Glob-Muster, daher verweigert `"*"` jedes Tool und `"mcp__*"` verweigert jedes MCP-Tool. Claude Code ignoriert eine Deny-Regel für das [`EndConversation`](/docs/de/tools-reference#endconversation-tool-behavior)-Tool, solange noch ein anderes Tool für Claude verfügbar ist. Eine `Bash`-Deny-Regel entspricht dem Befehl, wie Claude ihn schreibt, daher stoppt `Bash(curl *)` nicht `/usr/bin/curl` oder `sh -c 'curl …'`; siehe [was eine Bash-Regel nicht entspricht](/docs/de/permissions#bash-rule-limits). Dieser Schlüssel ersetzt die veraltete `ignorePatterns`-Konfiguration.1656Tool-Namen akzeptieren Glob-Muster, daher verweigert `"*"` jedes Tool und `"mcp__*"` verweigert jedes MCP-Tool. Claude Code ignoriert eine Deny-Regel für das [`EndConversation`](/docs/de/tools-reference#endconversation-tool-behavior)-Tool, solange noch ein anderes Tool für Claude verfügbar ist. Eine `Bash`-Deny-Regel gleicht den Befehl so ab, wie Claude ihn schreibt, daher stoppt `Bash(curl *)` nicht `/usr/bin/curl` oder `sh -c 'curl …'`; siehe [worauf eine Bash-Regel nicht zutrifft](/docs/de/permissions#bash-rule-limits). Dieser Schlüssel ersetzt die veraltete `ignorePatterns`-Konfiguration.

1599 1657

1600<h3 id="permissions-additionaldirectories">1658<h3 id="permissions-additionaldirectories">

1601 `permissions.additionalDirectories`1659 `permissions.additionalDirectories`

1602</h3>1660</h3>

1603 1661

1604Geben Sie Claude Dateizugriff auf Verzeichnisse außerhalb desjenigen, in dem Sie gestartet haben, als zusätzliche [Arbeitsverzeichnisse](/docs/de/permissions#working-directories). Die meisten `.claude/`-Konfigurationen werden [nicht ermittelt](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) aus diesen Verzeichnissen.1662Geben Sie Claude Dateizugriff auf Verzeichnisse außerhalb desjenigen, in dem Sie gestartet haben, als zusätzliche [Arbeitsverzeichnisse](/docs/de/permissions#working-directories). Die meisten `.claude/`-Konfigurationen werden aus diesen Verzeichnissen [nicht ermittelt](/docs/de/permissions#additional-directories-grant-file-access-not-configuration).

1605 1663

1606* **Bereich**: [`Any file`](#scopes)1664* **Geltungsbereich**: [`Any file`](#scopes)

1607* **Typ**: Array von Verzeichnispfaden1665* **Typ**: Array von Verzeichnispfaden

1608* **Standard**: nicht gesetzt1666* **Standard**: nicht gesetzt

1609* **Sitzungsspezifische Überschreibungen**: `--add-dir` und `/add-dir` fügen Verzeichnisse für eine Sitzung neben diesem Schlüssel hinzu1667* **Sitzungsspezifische Überschreibungen**: `--add-dir` und `/add-dir` fügen Verzeichnisse für eine Sitzung neben diesem Schlüssel hinzu

1622 `permissions.blockReadsOutsideWorkingDirectories`1680 `permissions.blockReadsOutsideWorkingDirectories`

1623</h3>1681</h3>

1624 1682

1625Verhindern Sie, dass Claude Pfade außerhalb der [Arbeitsverzeichnisse](/docs/de/permissions#working-directories) der Sitzung mit den Read-, Grep-, Glob- und LSP-Tools liest, in jedem Berechtigungsmodus, einschließlich `bypassPermissions`. Ein Bash-Befehl, der einen entsprechenden Pfad durch einen Dateiberfehl liest, den Claude Code erkennt, wie `cat`, fordert Sie auf, auch im Auto-Modus und `bypassPermissions`-Modus. Erfordert Claude Code v2.1.257 oder später.1683Lassen Sie die Datei-Tools von Claude Lesevorgänge außerhalb Ihrer [Arbeitsverzeichnisse](/docs/de/permissions#working-directories) in jedem Berechtigungsmodus verweigern, einschließlich `bypassPermissions`. Claude Code verweigert `Read`-, `Grep`-, `Glob`- und `LSP`-Aufrufe für diese Pfade und weist Claude an, Sie zu bitten, das Verzeichnis mit `/add-dir` hinzuzufügen. Dateien, die Claude Code selbst benötigt, bleiben lesbar, etwa Ihre Skills, Plugins, Regeln, Agenten, Befehle und die Memory-Datei `CLAUDE.md` unter `~/.claude/`. Erfordert Claude Code v2.1.257 oder später.

1626 1684

1627Ein Bash-Befehl, den der Shell-Parser nicht verfolgen kann, wie einer, der das Verzeichnis mehr als einmal wechselt oder eine Subshell ausführt, fordert Sie auf, auch im Auto-Modus und `bypassPermissions`-Modus. Die Aufforderung wird angezeigt, auch wenn der Befehl keinen Pfad außerhalb der Arbeitsverzeichnisse benennt. Diese Aufforderung gilt nicht, wenn der Befehl in der [Sandbox](/docs/de/sandboxing) ausgeführt wird und die Sandbox die Blockierung durchsetzt.1685Shell-Befehle verweigert Claude Code nicht auf dieselbe Weise:

1628 1686

1629Claude Code schreibt auch `true` hier, wenn Sie sich entscheiden, solche Lesevorgänge auf [Auto-Modus-Aufforderung vor dem ersten Lesevorgang außerhalb der Arbeitsverzeichnisse](/docs/de/permission-modes#first-read-outside-the-working-directories) zu blockieren.1687* [Aktionen, die kein Modus automatisch genehmigt](/docs/de/permission-modes#actions-no-mode-auto-approves) beschreibt, wann ein Shell-Befehl, der einen solchen Pfad liest, bei Ihnen nachfragt

1688* [In einer Sandbox ausgeführte Befehle unter der Blockierung](#sandboxed-commands-under-the-block) beschreibt, was ein in einer Sandbox ausgeführter Befehl lesen kann

1630 1689

1631* **Bereich**: [`Any file`](#scopes). Wenn eine Einstellungsquelle `true` setzt, gilt die Blockierung, daher kann die eingecheckte Datei eines Repositorys die Blockierung für ein Projekt aktivieren, kann aber eine Blockierung, die Sie setzen, nicht aufheben.1690Ein Bash-Befehl, den der Shell-Parser nicht nachverfolgen kann, etwa einer, der das Verzeichnis mehr als einmal wechselt oder eine Subshell ausführt, fragt auch im Auto-Modus und im `bypassPermissions`-Modus bei Ihnen nach. Die Abfrage erscheint auch dann, wenn der Befehl keinen Pfad außerhalb der Arbeitsverzeichnisse benennt. Diese Abfrage entfällt, wenn der Befehl in der [Sandbox](/docs/de/sandboxing) ausgeführt wird und die Sandbox die Blockierung durchsetzt.

1691

1692Claude Code schreibt hier außerdem `true`, wenn Sie in der [Abfrage des Auto-Modus vor dem ersten Lesevorgang außerhalb der Arbeitsverzeichnisse](/docs/de/permission-modes#first-read-outside-the-working-directories) festlegen, solche Lesevorgänge zu blockieren.

1693

1694* **Geltungsbereich**: [`Any file`](#scopes). Ein `true` in einer beliebigen Datei gilt, daher kann ein Repository die Blockierung für sich selbst aktivieren, Ihre Blockierung aber nicht aufheben.

1632* **Typ**: Boolean1695* **Typ**: Boolean

1633 * `true`: Dateilesevorgänge außerhalb der Arbeitsverzeichnisse werden blockiert1696 * `true`: Die Datei-Tools von Claude verweigern Lesevorgänge außerhalb der Arbeitsverzeichnisse

1634 * `false`: dasselbe wie nicht gesetzt; ein `true` in einer anderen Einstellungsdatei blockiert immer noch1697 * `false`: dasselbe wie nicht gesetzt; die Blockierung gilt trotzdem, wenn eine andere Datei `true` setzt

1635* **Standard**: nicht gesetzt, daher folgen Lesevorgänge außerhalb der Arbeitsverzeichnisse Ihrem Berechtigungsmodus und Ihren Regeln1698* **Standard**: nicht gesetzt, daher folgen Lesevorgänge außerhalb der Arbeitsverzeichnisse Ihrem [Berechtigungsmodus](/docs/de/permission-modes)

1636 1699

1637```json settings.json theme={null}1700```json settings.json theme={null}

1638{1701{

1642}1705}

1643```1706```

1644 1707

1645Wenn nur die eingecheckte Einstellungsdatei eines Repositorys ein Verzeichnis hinzufügt, gilt die Blockierung immer noch für Lesevorgänge dort. Wenn [`autoMemoryDirectory`](#automemorydirectory) aus der `.claude/settings.json` des Projekts kommt oder aus einer `.claude/settings.local.json` [als Repository-bereitgestellt behandelt](/docs/de/permissions#when-your-local-settings-file-needs-trust), lädt Claude Code kein [Auto-Memory](/docs/de/memory#storage-location) aus diesem Verzeichnis und speichert keines darin. Dateien, die Claude Code selbst benötigt, bleiben lesbar, wie Ihre Skills, Plugins, Regeln, Agents, Befehle und die `CLAUDE.md`-Speicherdatei unter `~/.claude/`.1708Verzeichnisse, die Sie mit `--add-dir`, `/add-dir` oder `additionalDirectories` in Ihren Benutzer- oder verwalteten Einstellungen hinzufügen, zählen für die Blockierung als Arbeitsverzeichnisse. Verzeichnisse, die nur in Repository-Einstellungen hinzugefügt werden, zählen nicht: solche in `.claude/settings.json` und solche in `.claude/settings.local.json`, sofern Git diese Datei nicht als nicht verfolgt meldet. In einem Verzeichnis, das kein Git-Repository ist, oder wenn Git die Datei verfolgt, behandelt Claude Code `.claude/settings.local.json` als Repository-Einstellungen; legen Sie Verzeichnisse, die lesbar bleiben sollen, daher stattdessen in Ihren Benutzereinstellungen fest.

1709

1710Wenn [`autoMemoryDirectory`](#automemorydirectory) aus der `.claude/settings.json` des Projekts kommt oder aus einer `.claude/settings.local.json`, die [als vom Repository bereitgestellt behandelt wird](/docs/de/permissions#when-your-local-settings-file-needs-trust), lädt Claude Code kein [Auto-Memory](/docs/de/memory#storage-location) aus diesem Verzeichnis und speichert keines darin.

1711

1712Um die Blockierung aufzuheben, entfernen Sie den Schlüssel aus jeder Einstellungsdatei, die ihn setzt, und starten Sie dann eine neue Sitzung.

1713

1714<h4 id="sandboxed-commands-under-the-block">

1715 In einer Sandbox ausgeführte Befehle unter der Blockierung

1716</h4>

1717

1718Wenn [Sandboxing](/docs/de/sandboxing) aktiviert ist, umfasst die Blockierung auch in einer Sandbox ausgeführte Befehle. Claude Code verweigert ihnen den Lesezugriff auf Ihr Home-Verzeichnis und auf die anderen Stammverzeichnisse, die Benutzerdateien enthalten: `/Users`, `/home`, `/root`, `/Volumes`, `/mnt`, `/media`, `/run/media` und `/srv`. Anschließend gibt es die Arbeitsverzeichnisse, die [Worktrees](/docs/de/worktrees), die Claude Code in der Sitzung erstellt, das temporäre Verzeichnis der Sitzung und die Teile von `~/.claude`, die Befehle benötigen, etwa Skills und Plugins, wieder frei. Solange die Blockierung gilt, zählen `allowRead`- und `allowWrite`-Einträge aus Repository-Einstellungen nicht.

1719

1720Wenn das Arbeitsverzeichnis der Sitzung ein verknüpfter [Git-Worktree](/docs/de/worktrees) ist, einschließlich eines, den Claude Code während der Sitzung betreten hat, bleibt das gemeinsame `.git`-Verzeichnis des Repositorys für in einer Sandbox ausgeführte Befehle lesbar und beschreibbar, sodass Git dort weiterhin funktioniert.

1721

1722In diesen Fällen erreicht die Blockierung in einer Sandbox ausgeführte Befehle nicht, während die Datei-Tools von Claude sie weiterhin durchsetzen:

1723

1724* Die Dateisystemisolierung ist über [`sandbox.filesystem.disabled`](#sandbox-filesystem-disabled) deaktiviert

1725* [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) ist gesetzt

1726* Der Pfad des Verzeichnisses, in dem Sie Claude Code gestartet haben, enthält ein Glob-Zeichen wie `*`, `?` oder `[`

1727

1728Unter der Blockierung gibt Claude Code Ihre globalen Git-Konfigurationsdateien für in einer Sandbox ausgeführte Befehle wieder frei, damit `git` Ihre Identität und Einstellungen beibehält:

1729

1730* `~/.gitconfig`

1731* Die Dateien `config`, `ignore` und `attributes` unter `$XDG_CONFIG_HOME/git`, standardmäßig `~/.config/git`

1732* Dateien, die Ihre globale Git-Konfiguration über `[include]`, `[includeIf]`, `core.excludesFile` oder `core.attributesFile` angibt

1733

1734Claude Code beurteilt jede Datei einzeln. Wenn eine Datei an einem Ort liegt, an dem ein in einer Sandbox ausgeführter Befehl schreiben kann, direkt oder über einen Symlink, gibt Claude Code die darin angegebenen Dateien nicht wieder frei.

1646 1735

1647Wenn die [Sandbox](/docs/de/sandboxing) aktiviert ist, verweigert die Blockierung auch sandboxierten Befehlen Lesezugriff auf Home-Verzeichnisse und bereitgestellte Volume-Roots außerhalb der Arbeitsverzeichnisse. Ein Wiederholungsversuch, der Genehmigung benötigt, um [außerhalb der Sandbox](/docs/de/sandboxing#the-unsandboxed-retry-escape-hatch) zu laufen, fordert Sie auf, auch im `bypassPermissions`-Modus. Dateien, die ein Tool aus Ihrem Home-Verzeichnis liest, wie `~/.gitconfig`, werden mit dem Rest verweigert; öffnen Sie einen bestimmten Pfad mit [`sandbox.filesystem.allowRead`](#sandbox-filesystem-allowread) erneut, wenn ein Tool ihn benötigt.1736Unter Linux und WSL2 kann eine Konfigurationsdatei, die ein Symlink ist, unter ihrem eigenen Pfad unlesbar bleiben; `git` läuft dann ohne sie. `~/.git-credentials` und `$XDG_CONFIG_HOME/git/credentials` bleiben blockiert.

1648 1737

1649Wenn das Arbeitsverzeichnis der Sitzung ein verknüpftes [Git Worktree](/docs/de/worktrees) ist, einschließlich eines, das Claude Code während der Sitzung eingegeben hat, bleibt das gemeinsame `.git`-Verzeichnis des Repositorys für sandboxierte Befehle lesbar und beschreibbar, damit Git dort funktioniert.1738Wenn eine wieder freigegebene Datei ein Geheimnis enthält, etwa ein `http.extraHeader`-Token, fügen Sie ihren Pfad zu [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread) hinzu. Ein `denyRead`-Eintrag, der eine Datei abdeckt, hat immer Vorrang vor dieser Freigabe.

1650 1739

1651<h3 id="permissions-defaultmode">1740<h3 id="permissions-defaultmode">

1652 `permissions.defaultMode`1741 `permissions.defaultMode`

1653</h3>1742</h3>

1654 1743

1655Legen Sie den [Berechtigungsmodus](/docs/de/permission-modes) fest, in dem neue Sitzungen starten. Wenn Sie ihn nicht gesetzt lassen, starten Sitzungen im [integrierten Standard](/docs/de/permission-modes#which-mode-a-session-starts-in) für Ihren Plan und Ihre Oberfläche.1744Legen Sie den [Berechtigungsmodus](/docs/de/permission-modes) fest, in dem neue Sitzungen starten. Wenn Sie ihn nicht gesetzt lassen, starten Sitzungen im [integrierten Standard](/docs/de/permission-modes#which-mode-a-session-starts-in) für Ihre Oberfläche.

1656 1745

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

1658* **Typ**: Zeichenfolge, eine von:1747* **Typ**: Zeichenfolge, eine von:

1659 * `"default"`: Claude Code führt nur Lesevorgänge ohne Nachfrage aus1748 * `"default"`: Claude Code führt nur Lesevorgänge ohne Nachfrage aus

1660 * `"acceptEdits"`: Claude Code führt auch Dateibearbeitungen und häufige Dateisystem-Befehle wie `mkdir` und `mv` ohne Nachfrage aus1749 * `"acceptEdits"`: Claude Code führt auch Dateibearbeitungen und häufige Dateisystem-Befehle wie `mkdir` und `mv` ohne Nachfrage aus

1661 * `"plan"`: Claude Code liest und plant, blockiert aber Bearbeitungen, bis Sie einen Plan genehmigen1750 * `"plan"`: Claude Code liest und plant, blockiert aber Bearbeitungen, bis Sie einen Plan genehmigen

1662 * `"auto"`: Claude Code führt alles aus, mit Hintergrund-Sicherheitsprüfungen1751 * `"auto"`: Claude Code läuft ohne die üblichen Nachfragen; bevor Aktionen wie Shell-Befehle und Netzwerkanfragen ausgeführt werden, prüft ein Klassifikator im Hintergrund, ob sie mit Ihrer Anfrage übereinstimmen

1663 * `"dontAsk"`: Claude Code verweigert automatisch jeden Aufruf, der sonst auffordern würde; Lesevorgänge, andere Aktionen, die keine Genehmigung benötigen, und vorab genehmigte Tools werden weiterhin ausgeführt1752 * `"dontAsk"`: Claude Code verweigert automatisch jeden Aufruf, bei dem sonst nachgefragt würde; Lesevorgänge, andere Aktionen, die keine Genehmigung benötigen, und vorab genehmigte Tools werden weiterhin ausgeführt

1664 * `"bypassPermissions"`: Claude Code führt alles ohne Nachfrage aus1753 * `"bypassPermissions"`: Claude Code führt alles ohne Nachfrage aus

1665 * `"manual"`: ein Alias für `"default"`, in Claude Code v2.1.200 oder später1754 * `"manual"`: ein Alias für `"default"`, in Claude Code v2.1.200 oder später

1666* **Standard**: nicht gesetzt1755* **Standard**: nicht gesetzt

1674}1763}

1675```1764```

1676 1765

1677Berechtigungsregeln überlagern jeden Modus: `deny`-Regeln blockieren in jedem Modus, einschließlich `bypassPermissions`. Siehe [Berechtigungsmodi](/docs/de/permission-modes). `manual` benennt den Berechtigungsmodus mit der Bezeichnung Manual in der CLI und der VS Code-Erweiterung; der Alias erfordert Claude Code v2.1.200 oder später. In Cloud-Sitzungen ehrt Claude Code nur `acceptEdits`, `plan`, `default` und `auto` aus diesem Schlüssel. Für Konversationen, die die VS Code-Erweiterung startet, siehe [welche Einstellung die Erweiterung für den Startberechtigungsmodus liest](/docs/de/permission-modes#switch-permission-modes).1766Berechtigungsregeln überlagern jeden Modus: `deny`-Regeln blockieren in jedem Modus, einschließlich `bypassPermissions`. Siehe [Berechtigungsmodi](/docs/de/permission-modes). `manual` benennt den Berechtigungsmodus mit der Bezeichnung Manual in der CLI und der VS Code-Erweiterung; der Alias erfordert Claude Code v2.1.200 oder später. In Cloud-Sitzungen berücksichtigt Claude Code nur `acceptEdits`, `plan`, `default` und `auto` aus diesem Schlüssel. Für Konversationen, die die VS Code-Erweiterung startet, siehe [welche Einstellung die Erweiterung für den Start-Berechtigungsmodus liest](/docs/de/permission-modes#switch-permission-modes).

1678 1767

1679<h3 id="permissions-disablebypasspermissionsmode">1768<h3 id="permissions-disablebypasspermissionsmode">

1680 `permissions.disableBypassPermissionsMode`1769 `permissions.disableBypassPermissionsMode`

1681</h3>1770</h3>

1682 1771

1683Verhindern Sie, dass jemand den `bypassPermissions`-Modus betritt. Claude Code lehnt dann das `--dangerously-skip-permissions`-Flag ab und ignoriert eine [Agent-Definition's](/docs/de/sub-agents#permission-modes) `permissionMode: bypassPermissions`, daher wird der Subagent mit dem Berechtigungsmodus der übergeordneten Sitzung ausgeführt.1772Verhindern Sie, dass jemand den `bypassPermissions`-Modus betritt. Claude Code lehnt dann das `--dangerously-skip-permissions`-Flag ab und ignoriert die Angabe `permissionMode: bypassPermissions` in einer [Agent-Definition](/docs/de/sub-agents#permission-modes), daher wird der Subagent mit dem Berechtigungsmodus der übergeordneten Sitzung ausgeführt.

1684 1773

1685* **Bereich**: [`Any file`](#scopes). Typischerweise in [verwalteten Einstellungen](/docs/de/managed-settings) gesetzt, um Organisationsrichtlinien durchzusetzen.1774* **Geltungsbereich**: [`Any file`](#scopes). Typischerweise in [verwalteten Einstellungen](/docs/de/managed-settings) gesetzt, um Organisationsrichtlinien durchzusetzen.

1686* **Typ**: die Zeichenfolge `"disable"`1775* **Typ**: die Zeichenfolge `"disable"`

1687* **Standard**: nicht gesetzt1776* **Standard**: nicht gesetzt

1688* **Sitzungsspezifische Überschreibungen**: Dieser Schlüssel hat Vorrang vor `--dangerously-skip-permissions`, das Claude Code ablehnt, während der Schlüssel gesetzt ist1777* **Sitzungsspezifische Überschreibungen**: Dieser Schlüssel hat Vorrang vor `--dangerously-skip-permissions`, das Claude Code ablehnt, während der Schlüssel gesetzt ist

1703 1792

1704Überspringen Sie die einmalige Mitteilung, die den [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) beschreibt und die Claude Code anzeigt, wenn Sie selbst zum ersten Mal den Auto-Modus betreten, beispielsweise durch Ihre eigenen Einstellungen oder den Modus-Selektor, anstatt wenn der integrierte Standard eine Sitzung darin startet. Claude Code zeigt diese Mitteilung einmal an und zeichnet dann auf, dass sie angezeigt wurde, daher ist dieser Schlüssel nur relevant, wenn die Mitteilung noch nicht angezeigt wurde.1793Überspringen Sie die einmalige Mitteilung, die den [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) beschreibt und die Claude Code anzeigt, wenn Sie selbst zum ersten Mal den Auto-Modus betreten, beispielsweise durch Ihre eigenen Einstellungen oder den Modus-Selektor, anstatt wenn der integrierte Standard eine Sitzung darin startet. Claude Code zeigt diese Mitteilung einmal an und zeichnet dann auf, dass sie angezeigt wurde, daher ist dieser Schlüssel nur relevant, wenn die Mitteilung noch nicht angezeigt wurde.

1705 1794

1706* **Bereich**: [`User or managed`](#scopes). Ein Repository kann es nicht für Sie setzen.1795* **Geltungsbereich**: [`User or managed`](#scopes). Ein Repository kann es nicht für Sie setzen.

1707* **Typ**: Boolean1796* **Typ**: Boolean

1708 * `true`: Claude Code überspringt die Mitteilung1797 * `true`: Claude Code überspringt die Mitteilung

1709 * `false`: dasselbe wie nicht gesetzt; die Mitteilung wird einmal angezeigt, es sei denn, eine andere dieser Dateien setzt `true`1798 * `false`: dasselbe wie nicht gesetzt; die Mitteilung wird einmal angezeigt, es sei denn, eine andere dieser Dateien setzt `true`

1719 `skipDangerousModePermissionPrompt`1808 `skipDangerousModePermissionPrompt`

1720</h3>1809</h3>

1721 1810

1722Überspringen Sie den Bestätigungsdialog, den Claude Code anzeigt, bevor eine Sitzung den `bypassPermissions`-Modus betritt, ob von `--dangerously-skip-permissions` oder von `defaultMode: "bypassPermissions"`. Claude Code schreibt `true` hier in Ihre Benutzereinstellungen, wenn Sie diesen Dialog einmal akzeptieren.1811Überspringen Sie den Bestätigungsdialog, den Claude Code anzeigt, bevor eine Sitzung den `bypassPermissions`-Modus betritt, ob von `--dangerously-skip-permissions` oder von `defaultMode: "bypassPermissions"`. Claude Code schreibt hier `true` in Ihre Benutzereinstellungen, wenn Sie diesen Dialog einmal akzeptieren.

1723 1812

1724* **Bereich**: [`User, local, or managed`](#scopes). Ein nicht vertrauenswürdiges Repository kann den Dialog nicht für Sie überspringen.1813* **Geltungsbereich**: [`User, local, or managed`](#scopes). Ein nicht vertrauenswürdiges Repository kann den Dialog nicht für Sie überspringen.

1725* **Typ**: Boolean1814* **Typ**: Boolean

1726 * `true`: Claude Code überspringt den Bestätigungsdialog, bevor eine Sitzung den `bypassPermissions`-Modus betritt1815 * `true`: Claude Code überspringt den Bestätigungsdialog, bevor eine Sitzung den `bypassPermissions`-Modus betritt

1727 * `false`: dasselbe wie nicht gesetzt; der Dialog wird angezeigt, es sei denn, eine andere dieser Dateien setzt `true`1816 * `false`: dasselbe wie nicht gesetzt; der Dialog wird angezeigt, es sei denn, eine andere dieser Dateien setzt `true`

1869* Eine Befehlsersetzung, eine Subshell oder ein Kontrollfluss-Block wie `if` oder `for`1958* Eine Befehlsersetzung, eine Subshell oder ein Kontrollfluss-Block wie `if` oder `for`

1870* Eine Umleitung, wie `docker build . > build.log`, außer einer, die nur einen Dateideskriptor dupliziert, wie `2>&1` es tut1959* Eine Umleitung, wie `docker build . > build.log`, außer einer, die nur einen Dateideskriptor dupliziert, wie `2>&1` es tut

1871* Ein Befehlsname, der aus einer Variable kommt1960* Ein Befehlsname, der aus einer Variable kommt

1961* Ein `git clone`, `git init`, `git worktree add`, `git worktree move` oder `git bundle create` mit einem Pfadargument, das absolut ist, mit `~` beginnt oder ein `..`-Segment enthält

1872 1962

1873Zum Beispiel bleibt `cd build && docker compose up` unter einem `docker *`-Eintrag sandboxed, und das Hinzufügen eines `cd`-Eintrags ändert das nicht.1963Zum Beispiel bleibt `cd build && docker compose up` unter einem `docker *`-Eintrag sandboxed, und das Hinzufügen eines `cd`-Eintrags ändert das nicht. Unter einem `git *`-Eintrag wird `git clone <url> vendor/lib` außerhalb der Sandbox ausgeführt, aber `git clone <url> ~/tools` bleibt sandboxed. Ein Clone schreibt einen ganzen Baum von Dateien, möglicherweise auch ausführbare, an die Stelle, auf die sein Zielpfad zeigt.

1874 1964

1875Ausgeschlossene Befehle durchlaufen weiterhin den regulären Berechtigungsfluss. Ausschluss ist eine Bequemlichkeit, keine Sicherheitsgrenze: bevorzugen Sie [`filesystem.allowWrite`](#sandbox-filesystem-allowwrite), wenn ein Tool nur an einer bestimmten Stelle schreiben muss. Claude Code führt Einträge über jeden Einstellungsbereich zusammen, den die Sitzung lädt, und es gibt keine verwaltete Sperre für diese Liste, daher halten Sie eine verwaltete Liste eng.1965Ausgeschlossene Befehle durchlaufen weiterhin den regulären Berechtigungsfluss. Ausschluss ist eine Bequemlichkeit, keine Sicherheitsgrenze: bevorzugen Sie [`filesystem.allowWrite`](#sandbox-filesystem-allowwrite), wenn ein Tool nur an einer bestimmten Stelle schreiben muss. Claude Code führt Einträge über jeden Einstellungsbereich zusammen, den die Sitzung lädt, und es gibt keine verwaltete Sperre für diese Liste, daher halten Sie eine verwaltete Liste eng.

1876 1966

1905 `sandbox.filesystem`1995 `sandbox.filesystem`

1906</h3>1996</h3>

1907 1997

1908Kontrollieren Sie, welche Pfade sandboxed Befehle lesen und schreiben können. Standardmäßig können sie in das Arbeitsverzeichnis, das Sitzungs-Temp-Verzeichnis und Verzeichnisse schreiben, die Sie mit `--add-dir`, `/add-dir` oder `permissions.additionalDirectories` hinzufügen, und können den Rest des Dateisystems lesen, einschließlich Anmeldedateien. Erweitern oder verengen Sie dies mit den vier Pfadlisten, oder schalten Sie die Dateisystem-Schicht mit `disabled` aus. Siehe [Filesystem isolation](/docs/de/sandboxing#filesystem-isolation) für die Standardgrenzen.1998Kontrollieren Sie, welche Pfade sandboxed Befehle lesen und schreiben können. Standardmäßig können sie in das Arbeitsverzeichnis, das benutzerspezifische Temp-Verzeichnis und Verzeichnisse schreiben, die Sie mit `--add-dir`, `/add-dir` oder `permissions.additionalDirectories` hinzufügen, und können den Rest des Dateisystems lesen, einschließlich Anmeldedateien. Erweitern oder verengen Sie dies mit den vier Pfadlisten, oder schalten Sie die Dateisystem-Schicht mit `disabled` aus. Siehe [Filesystem isolation](/docs/de/sandboxing#filesystem-isolation) für die Standardgrenzen.

1909 1999

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

1911* **Typ**: Objekt mit `allowWrite`, `denyWrite`, `denyRead` und `allowRead`-Arrays, plus die booleschen Werte `allowManagedReadPathsOnly` und `disabled`2001* **Typ**: Objekt mit `allowWrite`, `denyWrite`, `denyRead` und `allowRead`-Arrays, plus die booleschen Werte `allowManagedReadPathsOnly` und `disabled`

1949Claude Code entfernt auch ein nachgestelltes `/**`, daher decken `~/build/**` und `~/build` das gleiche Verzeichnis ab. Ob ein Wildcard wie `*` funktioniert, hängt davon ab, in welcher Liste sich der Eintrag befindet und von der Plattform:2039Claude Code entfernt auch ein nachgestelltes `/**`, daher decken `~/build/**` und `~/build` das gleiche Verzeichnis ab. Ob ein Wildcard wie `*` funktioniert, hängt davon ab, in welcher Liste sich der Eintrag befindet und von der Plattform:

1950 2040

1951* **`allowWrite` und `denyWrite`**: auf macOS funktionieren Wildcards. Auf Linux und WSL2 mountet die Sandbox konkrete Pfade, daher überspringt Claude Code einen Eintrag, der `*`, `?` oder `[` enthält, sobald das nachgestellte `/**` entfernt ist, und dieser Eintrag hat keine Auswirkung. Claude Code fügt die Pfade aus Ihren `Edit`-Berechtigungsregeln zu diesen Listen hinzu, daher gilt die gleiche Grenze für sie, und die **Config**-Registerkarte von `/sandbox` warnt vor `Edit`- und `Read`-Berechtigungsregeln, die Wildcards enthalten.2041* **`allowWrite` und `denyWrite`**: auf macOS funktionieren Wildcards. Auf Linux und WSL2 mountet die Sandbox konkrete Pfade, daher überspringt Claude Code einen Eintrag, der `*`, `?` oder `[` enthält, sobald das nachgestellte `/**` entfernt ist, und dieser Eintrag hat keine Auswirkung. Claude Code fügt die Pfade aus Ihren `Edit`-Berechtigungsregeln zu diesen Listen hinzu, daher gilt die gleiche Grenze für sie, und die **Config**-Registerkarte von `/sandbox` warnt vor `Edit`- und `Read`-Berechtigungsregeln, die Wildcards enthalten.

1952* **`denyRead` und `allowRead`**: Wildcards funktionieren auf jeder Plattform. Auf Linux und WSL2 erweitert Claude Code einen Leseeintrag auf die konkreten Pfade, die er abgleicht, was es nicht für die Schreibleisten tut.2042* **`denyRead` und `allowRead`**: Wildcards funktionieren auf jeder Plattform. Auf Linux und WSL2 erweitert Claude Code einen Leseeintrag auf die konkreten Pfade, die er abgleicht, was es nicht für die Schreiblisten tut.

1953 2043

1954<h3 id="sandbox-filesystem-allowwrite">2044<h3 id="sandbox-filesystem-allowwrite">

1955 `sandbox.filesystem.allowWrite`2045 `sandbox.filesystem.allowWrite`

1956</h3>2046</h3>

1957 2047

1958Fügen Sie Pfade hinzu, in die sandboxed Befehle schreiben können, über das Arbeitsverzeichnis, das Sitzungs-Temp-Verzeichnis und die Verzeichnisse hinaus, die Sie mit `--add-dir`, `/add-dir` oder `permissions.additionalDirectories` hinzugefügt haben. Verwenden Sie es, wenn ein Unterprozess wie `kubectl` oder ein Build-Tool außerhalb des Projekts schreiben muss.2048Fügen Sie Pfade hinzu, in die sandboxed Befehle schreiben können, über das Arbeitsverzeichnis, das benutzerspezifische Temp-Verzeichnis und die Verzeichnisse hinaus, die Sie mit `--add-dir`, `/add-dir` oder `permissions.additionalDirectories` hinzugefügt haben. Verwenden Sie es, wenn ein Unterprozess wie `kubectl` oder ein Build-Tool außerhalb des Projekts schreiben muss.

1959 2049

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

1961* **Typ**: Array von Pfadzeichenfolgen, unter Verwendung der [Sandbox-Pfadpräfixe](#sandbox-path-prefixes)2051* **Typ**: Array von Pfadzeichenfolgen, unter Verwendung der [Sandbox-Pfadpräfixe](#sandbox-path-prefixes)

1962* **Standard**: nicht gesetzt, daher können sandboxed Befehle in das Arbeitsverzeichnis, das Sitzungs-Temp-Verzeichnis, Verzeichnisse, die Sie mit `--add-dir` oder `/add-dir` hinzugefügt haben, und Verzeichnisse in [`permissions.additionalDirectories`](#permissions-additionaldirectories) schreiben2052* **Standard**: nicht gesetzt, daher können sandboxed Befehle in das Arbeitsverzeichnis, das benutzerspezifische Temp-Verzeichnis, Verzeichnisse, die Sie mit `--add-dir` oder `/add-dir` hinzugefügt haben, und Verzeichnisse in [`permissions.additionalDirectories`](#permissions-additionaldirectories) schreiben

1963 2053

1964Dies lässt einen Build unter `/tmp/build` schreiben und lässt `kubectl` Ihre kubeconfig aktualisieren:2054Dies lässt einen Build unter `/tmp/build` schreiben und lässt `kubectl` Ihre kubeconfig aktualisieren:

1965 2055

1973}2063}

1974```2064```

1975 2065

1976Claude Code führt Einträge über jeden Einstellungsbereich zusammen, den die Sitzung lädt: Benutzer-, Projekt-, lokale und verwaltete Pfade kombinieren sich, anstatt sich gegenseitig zu ersetzen, und Claude Code fügt die Pfade aus Ihren `Edit(...)`-Zulassungsberechtigungsregeln hinzu. Ein `allowWrite`-Eintrag kann einen [geschützten Pfad](/docs/de/sandboxing#protected-paths) nicht aufheben.2066Claude Code führt `allowWrite`-Einträge und die Pfade aus Ihren `Edit(...)`-Zulassungsberechtigungsregeln über jeden Einstellungsbereich zusammen, den die Sitzung lädt, und lässt dabei die aus Repository-Einstellungen weg, solange [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) aktiviert ist. Ein `allowWrite`-Eintrag kann einen [geschützten Pfad](/docs/de/sandboxing#protected-paths) nicht aufheben.

1977 2067

1978<h3 id="sandbox-filesystem-denywrite">2068<h3 id="sandbox-filesystem-denywrite">

1979 `sandbox.filesystem.denyWrite`2069 `sandbox.filesystem.denyWrite`

2044}2134}

2045```2135```

2046 2136

2047Claude Code löst einen `.`-Eintrag zum Projekt-Root in Projekteinstellungen und zu `~/.claude` in Benutzereinstellungen auf. Claude Code führt Einträge über jede Einstellungsdatei zusammen, die die Sitzung lädt, sofern [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) nicht gesetzt ist.2137Claude Code löst einen `.`-Eintrag zum Projekt-Root in Projekteinstellungen und zu `~/.claude` in Benutzereinstellungen auf. Claude Code führt Einträge über jede Einstellungsdatei zusammen, die die Sitzung lädt, sofern [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) nicht gesetzt ist, und lässt Einträge aus Repository-Einstellungen weg, solange [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) aktiviert ist.

2048 2138

2049<h3 id="sandbox-filesystem-allowmanagedreadpathsonly">2139<h3 id="sandbox-filesystem-allowmanagedreadpathsonly">

2050 `sandbox.filesystem.allowManagedReadPathsOnly`2140 `sandbox.filesystem.allowManagedReadPathsOnly`

2197 `sandbox.ripgrep`2287 `sandbox.ripgrep`

2198</h3>2288</h3>

2199 2289

2200Zeigen Sie die Sandbox auf eine ripgrep-Binärdatei Ihrer Wahl, z. B. wenn Ihre Plattform eine anders erstellte `rg` benötigt.2290Zeigen Sie die Sandbox auf eine eigene ripgrep-Binärdatei statt auf die, die Claude Code verwendet, z. B. wenn Ihre Plattform eine anders erstellte `rg` benötigt.

2201 2291

2202* **Bereich**: [`User or managed`](#scopes)2292* **Bereich**: [`User or managed`](#scopes)

2203* **Typ**: Objekt mit `command`, dem Pfad zur ripgrep-Binärdatei, und optional `args`, einem Array von Argumenten zum Voranstellen2293* **Typ**: Objekt mit `command`, dem Pfad zur ripgrep-Binärdatei, und optional `args`, einem Array von Argumenten zum Voranstellen

2702* **Bereich**: [`User or managed`](#scopes). Ein Repository kann es nicht ein- oder ausschalten.2792* **Bereich**: [`User or managed`](#scopes). Ein Repository kann es nicht ein- oder ausschalten.

2703* **Typ**: Boolescher Wert2793* **Typ**: Boolescher Wert

2704 * `true`: Claude Code verweigert sandboxed Befehlen Zugriff auf Hosts außerhalb der Zulassungsliste2794 * `true`: Claude Code verweigert sandboxed Befehlen Zugriff auf Hosts außerhalb der Zulassungsliste

2705 * `false`: sofern nicht eine andere vertrauenswürdige Einstellungsdatei `true` setzt, entscheidet Claude Code einen Host außerhalb der Zulassungsliste nach Berechtigungsmodus, anstatt ihn direkt zu verweigern: es prüft den Host im Auto-Modus gegen die [per-command allowed domains](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode) des Befehls, verweigert im `dontAsk`-Modus, erlaubt im `bypassPermissions`-Modus und im Plan-Modus, wenn Bypass verfügbar ist, und fordert Sie ansonsten auf2795 * `false`: sofern nicht eine andere vertrauenswürdige Einstellungsdatei `true` setzt, entscheidet Claude Code einen Host außerhalb der Zulassungsliste nach Berechtigungsmodus, anstatt ihn direkt zu verweigern: es prüft den Host im Auto-Modus gegen die [per-command allowed domains](/docs/de/sandboxing#per-command-allowed-domains-in-auto-mode) des Befehls, verweigert im `dontAsk`-Modus, erlaubt im `bypassPermissions`-Modus und in interaktiven Terminal-Sitzungen im Plan-Modus, in denen Bypass verfügbar ist, und fordert Sie ansonsten auf

2706* **Standard**: `false`2796* **Standard**: `false`

2707 2797

2708```json settings.json theme={null}2798```json settings.json theme={null}

2813<span id="context-and-memory" />2903<span id="context-and-memory" />

2814 2904

2815<h2 id="memory-and-context">2905<h2 id="memory-and-context">

2816 Speicher und Kontext2906 Memory und Kontext

2817</h2>2907</h2>

2818 2908

2819Steuern Sie, was Claude Code in den Kontext lädt, wie es komprimiert wird und wo es Speicher und Pläne speichert. Siehe [Kontext verwalten](/docs/de/context-window) und [Speicher](/docs/de/memory).2909Steuern Sie, was Claude Code in den Kontext lädt, wie es komprimiert wird und wo es Memory und Pläne ablegt. Siehe [Kontext verwalten](/docs/de/context-window) und [Memory](/docs/de/memory).

2820 2910

2821<h3 id="autocompactenabled">2911<h3 id="autocompactenabled">

2822 `autoCompactEnabled`2912 `autoCompactEnabled`

2824 2914

2825Lassen Sie Claude Code [die Konversation automatisch komprimieren](/docs/de/context-window#when-your-context-fills-up), wenn sich der Kontext dem Limit nähert. Erscheint in `/config` als **Auto-compact**, und das Umschalten dort schreibt diesen Schlüssel in Ihre Benutzereinstellungen.2915Lassen Sie Claude Code [die Konversation automatisch komprimieren](/docs/de/context-window#when-your-context-fills-up), wenn sich der Kontext dem Limit nähert. Erscheint in `/config` als **Auto-compact**, und das Umschalten dort schreibt diesen Schlüssel in Ihre Benutzereinstellungen.

2826 2916

2827* **Bereich**: [`Any file`](#scopes)2917* **Geltungsbereich**: [`Any file`](#scopes)

2828* **Typ**: Boolean2918* **Typ**: Boolean

2829 * `true`: Claude Code komprimiert die Konversation automatisch, wenn sich der Kontext dem Limit nähert2919 * `true`: Claude Code komprimiert die Konversation automatisch, wenn sich der Kontext dem Limit nähert

2830 * `false`: Claude Code komprimiert nicht automatisch2920 * `false`: Claude Code komprimiert nicht automatisch

2831* **Standard**: `true`2921* **Standard**: `true`

2832* **Sitzungsübersteuerungen**: [`DISABLE_AUTO_COMPACT`](/docs/de/env-vars) deaktiviert Auto-Compact für eine Sitzung; welcher der beiden es deaktiviert, der andere kann es nicht wieder aktivieren2922* **Überschreibungen pro Sitzung**: [`DISABLE_AUTO_COMPACT`](/docs/de/env-vars) deaktiviert die automatische Komprimierung für eine Sitzung; welcher der beiden sie auch deaktiviert, der andere kann sie nicht wieder aktivieren

2833 2923

2834```json settings.json theme={null}2924```json settings.json theme={null}

2835{2925{

2837}2927}

2838```2928```

2839 2929

2840Der manuelle `/compact`-Befehl funktioniert weiterhin, während Auto-Compact deaktiviert ist.2930Der manuelle `/compact`-Befehl funktioniert weiterhin, während die automatische Komprimierung deaktiviert ist.

2841 2931

2842<h3 id="autocompactwindow">2932<h3 id="autocompactwindow">

2843 `autoCompactWindow`2933 `autoCompactWindow`

2845 2935

2846Legen Sie fest, wie voll das Kontextfenster wird, bevor Claude Code [automatisch komprimiert](/docs/de/context-window#when-your-context-fills-up).2936Legen Sie fest, wie voll das Kontextfenster wird, bevor Claude Code [automatisch komprimiert](/docs/de/context-window#when-your-context-fills-up).

2847 2937

2848* **Bereich**: [`Any file`](#scopes)2938* **Geltungsbereich**: [`Any file`](#scopes)

2849* **Typ**: Anzahl der Token, von `100000` bis `1000000`. Claude Code begrenzt den Wert auf das Kontextfenster Ihres Modells; die [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview) listet das Fenster jedes Modells auf2939* **Typ**: Anzahl der Token, von `100000` bis `1000000`. Claude Code begrenzt den Wert auf das Kontextfenster Ihres Modells; die [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview) listet das Fenster jedes Modells auf

2850* **Standard**: nicht gesetzt, daher wählt Claude Code ein für Ihr Modell optimiertes Fenster2940* **Standard**: nicht gesetzt, daher wählt Claude Code ein für Ihr Modell optimiertes Fenster

2851* **Sitzungsübersteuerungen**: [`--autocompact`](/docs/de/cli-reference#cli-flags) hat Vorrang vor diesem Schlüssel für eine Sitzung, und [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/de/env-vars) hat Vorrang vor beiden2941* **Überschreibungen pro Sitzung**: [`--autocompact`](/docs/de/cli-reference#cli-flags) hat für eine Sitzung Vorrang vor diesem Schlüssel, und [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/de/env-vars) hat Vorrang vor beiden

2852 2942

2853```json settings.json theme={null}2943```json settings.json theme={null}

2854{2944{

2862 `autoMemoryDirectory`2952 `autoMemoryDirectory`

2863</h3>2953</h3>

2864 2954

2865Speichern Sie [automatischen Speicher](/docs/de/memory#storage-location) in einem Verzeichnis Ihrer Wahl statt in der projektspezifischen Standardeinstellung.2955Speichern Sie [Auto-Memory](/docs/de/memory#storage-location) in einem Verzeichnis Ihrer Wahl statt im projektspezifischen Standardverzeichnis.

2866 2956

2867* **Bereich**: [`Any file`](#scopes)2957* **Geltungsbereich**: [`Any file`](#scopes)

2868* **Typ**: String, ein absoluter oder mit `~/` präfixierter Verzeichnispfad2958* **Typ**: String, ein absoluter oder mit `~/` präfixierter Verzeichnispfad

2869* **Standard**: nicht gesetzt, daher verwendet Claude Code `~/.claude/projects/<project>/memory/`2959* **Standard**: nicht gesetzt, daher verwendet Claude Code `~/.claude/projects/<project>/memory/`

2870 2960

2880 `autoMemoryEnabled`2970 `autoMemoryEnabled`

2881</h3>2971</h3>

2882 2972

2883Schalten Sie [automatischen Speicher](/docs/de/memory#enable-or-disable-auto-memory) ein oder aus. Wenn `false`, liest Claude nicht aus dem automatischen Speicherverzeichnis und schreibt nicht dorthin. Sie können es auch während einer Sitzung mit `/memory` umschalten, was diesen Schlüssel in Ihre Benutzereinstellungen schreibt.2973Schalten Sie [Auto-Memory](/docs/de/memory#enable-or-disable-auto-memory) ein oder aus. Wenn `false`, liest Claude nicht aus dem Auto-Memory-Verzeichnis und schreibt nicht dorthin. Sie können es auch während einer Sitzung mit `/memory` umschalten, was diesen Schlüssel in Ihre Benutzereinstellungen schreibt.

2884 2974

2885* **Bereich**: [`Any file`](#scopes)2975* **Geltungsbereich**: [`Any file`](#scopes)

2886* **Typ**: Boolean2976* **Typ**: Boolean

2887 * `true`: dasselbe wie nicht gesetzt; automatischer Speicher bleibt aktiviert, es sei denn, etwas, das diesen Schlüssel übertrumpft, deaktiviert ihn für die Sitzung, wie `--bare`, sicherer Modus oder `CLAUDE_CODE_DISABLE_AUTO_MEMORY`2977 * `true`: dasselbe wie nicht gesetzt; Auto-Memory bleibt aktiviert, es sei denn, etwas, das Vorrang vor diesem Schlüssel hat, deaktiviert es für die Sitzung, wie `--bare`, der sichere Modus oder `CLAUDE_CODE_DISABLE_AUTO_MEMORY`

2888 * `false`: Claude liest nicht aus dem automatischen Speicherverzeichnis und schreibt nicht dorthin2978 * `false`: Claude liest nicht aus dem Auto-Memory-Verzeichnis und schreibt nicht dorthin

2889* **Standard**: `true`2979* **Standard**: `true`

2890* **Sitzungsübersteuerungen**: [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/docs/de/env-vars) hat Vorrang vor diesem Schlüssel für eine Sitzung, in beide Richtungen2980* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/docs/de/env-vars) hat für eine Sitzung Vorrang vor diesem Schlüssel, in beide Richtungen

2891 2981

2892```json settings.json theme={null}2982```json settings.json theme={null}

2893{2983{

2899 `bashOutputMaxChars`2989 `bashOutputMaxChars`

2900</h3>2990</h3>

2901 2991

2902Legen Sie fest, wie viele Zeichen der [Ausgabe eines erfolgreichen Bash- oder PowerShell-Befehls Claude inline erhält](/docs/de/tools-reference#output-limits). Wenn die Ausgabe das Limit überschreitet, speichert Claude Code sie in einer Datei und Claude erhält eine kurze Vorschau plus den Pfad der Datei. Erhöhen Sie das Limit, wenn die Befehlsausgabe, wie ein ausführlicher Build oder ein vollständiges Test-Suite-Protokoll, routinemäßig das Standard-Limit überschreitet und Sie möchten, dass Claude es liest, ohne die Datei zu öffnen. Erfordert Claude Code v2.1.261 oder später.2992Legen Sie fest, wie viele Zeichen der [Ausgabe eines erfolgreichen Bash- oder PowerShell-Befehls Claude inline erhält](/docs/de/tools-reference#output-limits). Wenn die Ausgabe das Limit überschreitet, speichert Claude Code sie in einer Datei und Claude erhält eine kurze Vorschau plus den Pfad der Datei. Erhöhen Sie das Limit, wenn die Befehlsausgabe, wie ein ausführlicher Build oder ein vollständiges Test-Suite-Log, routinemäßig das Standardlimit überschreitet und Sie möchten, dass Claude sie liest, ohne die Datei zu öffnen. Erfordert Claude Code v2.1.261 oder später.

2903 2993

2904* **Bereich**: [`Any file`](#scopes)2994* **Geltungsbereich**: [`Any file`](#scopes)

2905* **Typ**: Anzahl der Zeichen, eine positive ganze Zahl. Claude Code begrenzt den Wert auf den Bereich `4000` bis `128000`2995* **Typ**: Anzahl der Zeichen, eine positive ganze Zahl. Claude Code begrenzt den Wert auf den Bereich `4000` bis `128000`

2906* **Standard**: nicht gesetzt, daher erhält Claude bis zu 30.000 Zeichen inline2996* **Standard**: nicht gesetzt, daher erhält Claude bis zu 30.000 Zeichen inline

2907 2997

2917 `claudeMd`3007 `claudeMd`

2918</h3>3008</h3>

2919 3009

2920Injizieren Sie CLAUDE.md-ähnliche Anweisungen als von der Organisation verwalteter Speicher, ohne eine separate Datei bereitzustellen. Claude Code lädt den Text als verwalteten Speichereintrag vor Benutzer- und Projekt-CLAUDE.md-Dateien.3010Fügen Sie CLAUDE.md-ähnliche Anweisungen als von der Organisation verwaltetes Memory ein, ohne eine separate Datei bereitzustellen. Claude Code lädt den Text als verwalteten Memory-Eintrag vor Benutzer- und Projekt-CLAUDE.md-Dateien.

2921 3011

2922* **Bereich**: [`Managed`](#scopes)3012* **Geltungsbereich**: [`Managed`](#scopes)

2923* **Typ**: String, der Text einer CLAUDE.md-Datei; schreiben Sie ihn wie die Datei, Markdown eingeschlossen, mit Zeilenumbrüchen als `\n`3013* **Typ**: String, der Text einer CLAUDE.md-Datei; schreiben Sie ihn wie die Datei, Markdown eingeschlossen, mit Zeilenumbrüchen als `\n`

2924* **Standard**: nicht gesetzt3014* **Standard**: nicht gesetzt

2925 3015

2937 `claudeMdExcludes`3027 `claudeMdExcludes`

2938</h3>3028</h3>

2939 3029

2940Überspringen Sie spezifische `CLAUDE.md`-Dateien, wenn Claude Code [Speicher](/docs/de/memory#exclude-specific-claude-md-files) lädt. In einem großen Monorepo verwenden Sie es, um CLAUDE.md-Dateien von anderen Teams zu überspringen, die für Ihre Arbeit nicht relevant sind; [Irrelevante CLAUDE.md-Dateien ausschließen](/docs/de/large-codebases#exclude-irrelevant-claude-md-files) im Leitfaden für große Codebases führt Sie durch diesen Fall. Muster werden gegen absolute Dateipfade abgeglichen.3030Überspringen Sie bestimmte `CLAUDE.md`-Dateien, wenn Claude Code [Memory](/docs/de/memory#exclude-specific-claude-md-files) lädt. In einem großen Monorepo verwenden Sie es, um CLAUDE.md-Dateien anderer Teams zu überspringen, die für Ihre Arbeit nicht relevant sind; [Irrelevante CLAUDE.md-Dateien ausschließen](/docs/de/large-codebases#exclude-irrelevant-claude-md-files) im Leitfaden für große Codebases führt Sie durch diesen Fall. Muster werden gegen absolute Dateipfade abgeglichen.

2941 3031

2942* **Bereich**: [`Any file`](#scopes)3032* **Geltungsbereich**: [`Any file`](#scopes)

2943* **Typ**: Array von Strings, jeweils ein Glob-Muster oder absoluter Pfad3033* **Typ**: Array von Strings, jeweils ein Glob-Muster oder absoluter Pfad

2944* **Standard**: nicht gesetzt, daher lädt Claude Code jede CLAUDE.md, die es findet3034* **Standard**: nicht gesetzt, daher lädt Claude Code jede CLAUDE.md, die es findet

2945 3035

2949}3039}

2950```3040```

2951 3041

2952Ausschlüsse gelten nur für Benutzer-, Projekt- und lokale Speicherdateien; verwaltete Richtlinien-CLAUDE.md-Dateien können nicht ausgeschlossen werden.3042Ausschlüsse gelten nur für Benutzer-, Projekt- und lokale Memory-Dateien; CLAUDE.md-Dateien aus verwalteten Richtlinien können nicht ausgeschlossen werden.

2953 3043

2954<span id="environment-variables" />3044<span id="environment-variables" />

2955 3045

2957 `env`3047 `env`

2958</h3>3048</h3>

2959 3049

2960Legen Sie Umgebungsvariablen für jede Sitzung und für die Unterprozesse fest, die Claude Code von ihr aus startet. Die meisten Variablen in der [Umgebungsvariablenreferenz](/docs/de/env-vars) können hier gehen, was ist, wie Sie eine auf jede Sitzung anwenden oder sie in Ihrem Team verteilen. Projekt- und lokale Einstellungen können [einige davon](#variables-claude-code-ignores-in-env) nicht setzen.3050Legen Sie Umgebungsvariablen für jede Sitzung und für die Unterprozesse fest, die Claude Code von ihr aus startet. Die meisten Variablen in der [Referenz der Umgebungsvariablen](/docs/de/env-vars) können hier eingetragen werden; so wenden Sie eine Variable auf jede Sitzung an oder verteilen sie an Ihr Team. Projekt- und lokale Einstellungen können [einige davon](#variables-claude-code-ignores-in-env) nicht setzen.

2961 3051

2962* **Bereich**: [`Any file`](#scopes)3052* **Geltungsbereich**: [`Any file`](#scopes)

2963* **Typ**: Objekt, das Variablennamen auf String-Werte abbildet3053* **Typ**: Objekt, das Variablennamen auf String-Werte abbildet

2964* **Standard**: nicht gesetzt3054* **Standard**: nicht gesetzt

2965 3055

2966Dieses Beispiel deaktiviert die automatische Komprimierung und leitet API-Anfragen durch einen Proxy:3056Dieses Beispiel deaktiviert die automatische Komprimierung und leitet API-Anfragen über einen Proxy:

2967 3057

2968```json settings.json theme={null}3058```json settings.json theme={null}

2969{3059{

2978 Wie `env`-Werte mit Ihrer Shell interagieren3068 Wie `env`-Werte mit Ihrer Shell interagieren

2979</h4>3069</h4>

2980 3070

2981* Ein Wert hier überschreibt die gleiche Variable, die in Ihrer Shell exportiert wird, und wenn mehr als eine Einstellungsdatei eine Variable setzt, gilt die [höchste Priorität](/docs/de/settings#settings-precedence). [Variablen, die Claude Code in `env` ignoriert](#variables-claude-code-ignores-in-env) listet die Ausnahmen für Projekt- und lokale Einstellungen auf.3071* Ein Wert hier überschreibt dieselbe Variable, die in Ihrer Shell exportiert wird, und wenn mehr als eine Einstellungsdatei eine Variable setzt, gilt die mit dem [höchsten Vorrang](/docs/de/settings#settings-precedence). [Variablen, die Claude Code in `env` ignoriert](#variables-claude-code-ignores-in-env) listet die Ausnahmen für Projekt- und lokale Einstellungen auf.

2982* Um einen Shell-Export zu stornieren, setzen Sie die Variable auf `""`. Claude Code behandelt einen leeren Wert als nicht gesetzt für die Anbieterauswahl, und Unterprozesse erben den leeren Wert.3072* Wenn die Claude Desktop-App oder ein Runner einer [selbst gehosteten Umgebung](/docs/de/self-hosted-environments) die Sitzung startet, hat stattdessen die von ihr bzw. ihm erstellte Start-Umgebung Vorrang: Claude Code ignoriert einen `env`-Wert aus jeder Einstellungsdatei für eine Variable, die die Start-Umgebung bereits setzt. Das [Debug-Log](/docs/de/debug-your-config) nennt jede ignorierte Variable.

3073* Um einen Shell-Export aufzuheben, setzen Sie die Variable auf `""`. Claude Code behandelt einen leeren Wert bei der Anbieterauswahl als nicht gesetzt, und Unterprozesse erben den leeren Wert.

2983* `NO_COLOR` und `FORCE_COLOR`, die hier gesetzt sind, erreichen nur Unterprozesse. Um die Farben der Claude Code-Oberfläche selbst zu ändern, setzen Sie sie in Ihrer Shell, bevor Sie `claude` starten.3074* `NO_COLOR` und `FORCE_COLOR`, die hier gesetzt sind, erreichen nur Unterprozesse. Um die Farben der Claude Code-Oberfläche selbst zu ändern, setzen Sie sie in Ihrer Shell, bevor Sie `claude` starten.

2984* Werte hier sind Klartext in der Einstellungsdatei und erreichen jeden Unterprozess, den Claude Code startet. Für ein OTLP-Bearer-Token, das sich dreht, verwenden Sie [`otelHeadersHelper`](#otelheadershelper); für API-Anmeldedaten verwenden Sie [`apiKeyHelper`](#apikeyhelper).3075* Werte hier stehen im Klartext in der Einstellungsdatei und erreichen jeden Unterprozess, den Claude Code startet. Für ein OTLP-Bearer-Token, das rotiert wird, verwenden Sie [`otelHeadersHelper`](#otelheadershelper); für API-Anmeldedaten verwenden Sie [`apiKeyHelper`](#apikeyhelper).

2985 3076

2986<h4 id="when-claude-code-applies-env-values">3077<h4 id="when-claude-code-applies-env-values">

2987 Wann Claude Code `env`-Werte anwendet3078 Wann Claude Code `env`-Werte anwendet

2989 3080

2990* Aus Benutzereinstellungen, `--settings` und verwalteten Einstellungen: beim Start und erneut in der laufenden Sitzung, wenn eine gespeicherte Änderung die zusammengeführte `env` ändert.3081* Aus Benutzereinstellungen, `--settings` und verwalteten Einstellungen: beim Start und erneut in der laufenden Sitzung, wenn eine gespeicherte Änderung die zusammengeführte `env` ändert.

2991* Aus Projekt- und lokalen Einstellungen: nachdem Sie dem Workspace vertrauen, oder beim Start im `-p`-Modus, der niemals den Vertrauensdialog anzeigt, und erneut, wenn eine gespeicherte Änderung die zusammengeführte `env` ändert.3082* Aus Projekt- und lokalen Einstellungen: nachdem Sie dem Workspace vertrauen, oder beim Start im `-p`-Modus, der niemals den Vertrauensdialog anzeigt, und erneut, wenn eine gespeicherte Änderung die zusammengeführte `env` ändert.

2992* Variablen, die Claude Code als sicher klassifiziert, wie Modellauswahl, Timeouts und Limits, und Feature-Toggles: beim Start aus jeder Einstellungsdatei, außer den [Variablen, die Projekt- und lokale Einstellungen nicht setzen können](#variables-claude-code-ignores-in-env).3083* Variablen, die Claude Code als sicher einstuft, wie Modellauswahl, Timeouts und Limits sowie Feature-Toggles: beim Start aus jeder Einstellungsdatei, außer den [Variablen, die Projekt- und lokale Einstellungen nicht setzen können](#variables-claude-code-ignores-in-env).

2993* Nachdem Sie die Sitzung mit `/cd` [verschieben](/docs/de/permissions#move-the-session-to-another-directory) auf v2.1.246 oder später: die `env`-Werte des neuen Verzeichnisses, zusätzlich zu denen des vorherigen Verzeichnisses.3084* Nachdem Sie die [Sitzung mit `/cd` verschoben haben](/docs/de/permissions#move-the-session-to-another-directory), ab v2.1.246: die Projekt- und lokalen `env`-Werte des neuen Verzeichnisses, zusätzlich zu denen des vorherigen Verzeichnisses.

2994 3085

2995<h4 id="variables-claude-code-ignores-in-env">3086<h4 id="variables-claude-code-ignores-in-env">

2996 Variablen, die Claude Code in `env` ignoriert3087 Variablen, die Claude Code in `env` ignoriert

2997</h4>3088</h4>

2998 3089

2999* Projekt- und lokale Einstellungen können keine Variablen setzen, die ein ausgechecktes Repository nicht kontrollieren sollte; setzen Sie diese stattdessen in Ihrer Shell, Benutzereinstellungen oder verwalteten Einstellungen. Claude Code löscht jede, außer einigen Werten, die Telemetrie ausschalten, und protokolliert eine Warnung, die Sie mit `claude --debug` sehen können. Sie umfassen:3090* Projekt- und lokale Einstellungen können keine Variablen setzen, die ein ausgechecktes Repository nicht steuern sollte; setzen Sie diese stattdessen in Ihrer Shell, in Benutzereinstellungen oder in verwalteten Einstellungen. Claude Code verwirft jede davon, außer einigen Werten, die Telemetrie ausschalten, und protokolliert eine Warnung, die Sie mit `claude --debug` sehen können. Dazu gehören:

3000 3091

3001 * Variablen, die wählen, wo Claude Code seine eigenen Dateien speichert oder schreibt: `CLAUDE_CONFIG_DIR`, `CLAUDE_CODE_TMPDIR` und die Betriebssystem-Verzeichnisvariablen wie `HOME`, `TMPDIR`, `TMP`, `TEMP` und die `XDG_*`-Familie.3092 * Variablen, die festlegen, wo Claude Code seine eigenen Dateien speichert oder schreibt: `CLAUDE_CONFIG_DIR`, `CLAUDE_CODE_TMPDIR` und die Verzeichnisvariablen des Betriebssystems wie `HOME`, `TMPDIR`, `TMP`, `TEMP` und die `XDG_*`-Familie.

3002 * Variablen, die Sitzungsinhalte exportieren: [`OTEL_LOG_RAW_API_BODIES`](/docs/de/env-vars#variables) und das detaillierte Beta-Tracing-Paar `ENABLE_BETA_TRACING_DETAILED` und `BETA_TRACING_ENDPOINT`.3093 * Variablen, die Sitzungsinhalte exportieren: [`OTEL_LOG_RAW_API_BODIES`](/docs/de/env-vars#variables) und das detaillierte Beta-Tracing-Paar `ENABLE_BETA_TRACING_DETAILED` und `BETA_TRACING_ENDPOINT`.

3003 * Die [OpenTelemetry-Exporter](/docs/de/monitoring-usage)-Variablen, die Telemetrie aktivieren, wählen, wohin sie geht, oder wählen, welche Inhalte sie erfasst:3094 * Die Variablen des [OpenTelemetry-Exporters](/docs/de/monitoring-usage), die Telemetrie aktivieren, festlegen, wohin sie gesendet wird, oder festlegen, welche Inhalte sie erfasst:

3004 3095

3005 * `CLAUDE_CODE_ENABLE_TELEMETRY`, plus das erweiterte Telemetrie-Beta-Paar `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` und `ENABLE_ENHANCED_TELEMETRY_BETA`3096 * `CLAUDE_CODE_ENABLE_TELEMETRY`, plus das Beta-Paar für erweiterte Telemetrie `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` und `ENABLE_ENHANCED_TELEMETRY_BETA`

3006 * Die Exporter-Selektoren `OTEL_LOGS_EXPORTER`, `OTEL_METRICS_EXPORTER` und `OTEL_TRACES_EXPORTER`3097 * Die Exporter-Selektoren `OTEL_LOGS_EXPORTER`, `OTEL_METRICS_EXPORTER` und `OTEL_TRACES_EXPORTER`

3007 * Die Inhaltsvariablen `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_ASSISTANT_RESPONSES`, `OTEL_LOG_TOOL_CONTENT` und `OTEL_LOG_TOOL_DETAILS`3098 * Die Inhaltsvariablen `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_ASSISTANT_RESPONSES`, `OTEL_LOG_TOOL_CONTENT` und `OTEL_LOG_TOOL_DETAILS`

3008 * `OTEL_EXPORTER_OTLP_*`-Variablen, deren Namen auf `_ENDPOINT`, `_HEADERS`, `_PROTOCOL`, `_CERTIFICATE`, `_CLIENT_KEY` oder `_INSECURE` enden, in den generischen und pro-Signal-Formen, wie `OTEL_EXPORTER_OTLP_ENDPOINT` und `OTEL_EXPORTER_OTLP_METRICS_HEADERS`3099 * `OTEL_EXPORTER_OTLP_*`-Variablen, deren Namen auf `_ENDPOINT`, `_HEADERS`, `_PROTOCOL`, `_CERTIFICATE`, `_CLIENT_KEY` oder `_INSECURE` enden, in der generischen und der signalspezifischen Form, wie `OTEL_EXPORTER_OTLP_ENDPOINT` und `OTEL_EXPORTER_OTLP_METRICS_HEADERS`

3009 * `OTEL_EXPORTER_PROMETHEUS_HOST` und `OTEL_EXPORTER_PROMETHEUS_PORT`3100 * `OTEL_EXPORTER_PROMETHEUS_HOST` und `OTEL_EXPORTER_PROMETHEUS_PORT`

3010 3101

3011 Nur diese Werte gelten weiterhin aus Projekt- und lokalen Einstellungen, da sie etwas ausschalten: `none` für die drei Exporter-Selektoren und ein Aus-Wert wie `0` für `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_CONTENT` und `OTEL_LOG_TOOL_DETAILS`. Ein solcher Wert überschreibt die gleiche Variable in Ihren Benutzereinstellungen, aber nicht eine, die die Umgebung, von der Sie Claude Code starten, eine `--settings`-Datei oder verwaltete Einstellungen setzen.3102 Nur diese Werte gelten weiterhin aus Projekt- und lokalen Einstellungen, da sie etwas ausschalten: `none` für die drei Exporter-Selektoren und ein Aus-Wert wie `0` für `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_CONTENT` und `OTEL_LOG_TOOL_DETAILS`. Ein solcher Wert überschreibt dieselbe Variable in Ihren Benutzereinstellungen, aber nicht eine, die die Umgebung, aus der Sie Claude Code starten, eine `--settings`-Datei oder verwaltete Einstellungen setzen.

3012 3103

3013 Wenn eine Projekt- oder lokale Einstellungsdatei eine Variable in dieser Gruppe setzt, zeigt eine lokale interaktive Sitzung beim Start einen Hinweis. Führen Sie `/status` oder `claude doctor` aus, um zu sehen, welche Claude Code ignoriert hat und welche Telemetrie ausgeschaltet haben; beide listen Namen auf, niemals Werte. Ein nicht-interaktiver Lauf mit `-p` oder eine Agent SDK-Sitzung zeigt keinen Hinweis, daher überprüfen Sie, ob Ihr Collector nach dem Upgrade noch Daten empfängt. Wenn nicht, setzen Sie die Variablen in Ihren Benutzereinstellungen, verwalteten Einstellungen, der Umgebung des Jobs oder einer Datei, die Sie mit `--settings` übergeben.3104 Wenn eine Projekt- oder lokale Einstellungsdatei eine Variable aus dieser Gruppe setzt, zeigt eine lokale interaktive Sitzung beim Start einen Hinweis. Führen Sie `/status` oder `claude doctor` aus, um zu sehen, welche Claude Code ignoriert hat und welche die Telemetrie ausgeschaltet haben; beide listen Namen auf, niemals Werte. Ein nicht interaktiver Lauf mit `-p` oder eine Agent SDK-Sitzung zeigt keinen Hinweis, überprüfen Sie daher nach dem Upgrade, ob Ihr Collector noch Daten empfängt. Wenn nicht, setzen Sie die Variablen in Ihren Benutzereinstellungen, in verwalteten Einstellungen, in der Umgebung des Jobs oder in einer Datei, die Sie mit `--settings` übergeben.

3014 3105

3015 Das Ignorieren dieser Gruppe in Projekt- und lokalen Einstellungen erfordert Claude Code v2.1.282 oder später.3106 Das Ignorieren dieser Gruppe in Projekt- und lokalen Einstellungen erfordert Claude Code v2.1.282 oder später.

3016 * Variablen, die ändern, wie Claude Code startet oder synchronisiert, wie `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` und `CLAUDE_CODE_PLUGIN_SEED_DIR`.3107 * Variablen, die ändern, wie Claude Code startet oder synchronisiert, wie `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` und `CLAUDE_CODE_PLUGIN_SEED_DIR`.

3017 3108

3018 Vor v2.1.251 konnten Projekt- und lokale Einstellungen auch die Variablen in dieser Liste setzen, die wählen, wo Claude Code seine Dateien schreibt oder die Sitzungsinhalte exportieren, außer `HOME` und `XDG_CONFIG_HOME`.3109 Vor v2.1.251 konnten Projekt- und lokale Einstellungen auch die Variablen in dieser Liste setzen, die festlegen, wo Claude Code seine Dateien schreibt, oder die Sitzungsinhalte exportieren, außer `HOME` und `XDG_CONFIG_HOME`.

3019* Identitätsvariablen, die Claude Codes Hosting-Umgebungen besitzen, wie `CLAUDE_CODE_REMOTE` und `CLAUDE_CODE_ACCOUNT_UUID`, werden aus jeder Datei ignoriert.3110* Identitätsvariablen, die den Hosting-Umgebungen von Claude Code gehören, wie `CLAUDE_CODE_REMOTE` und `CLAUDE_CODE_ACCOUNT_UUID`, werden aus jeder Datei ignoriert.

3020* [`CLAUDE_CODE_MESSAGING_SOCKET` und `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/de/env-vars#variables), die Claude Code selbst exportiert, werden aus jeder Datei ignoriert. Das Ignorieren der Socket-Variable erfordert Claude Code v2.1.224 oder später, und das Ignorieren des Tokens erfordert v2.1.228 oder später.3111* [`CLAUDE_CODE_MESSAGING_SOCKET` und `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/de/env-vars#variables), die Claude Code selbst exportiert, werden aus jeder Datei ignoriert. Das Ignorieren der Socket-Variable erfordert Claude Code v2.1.224 oder später, und das Ignorieren des Tokens erfordert v2.1.228 oder später.

3021* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/de/sessions#name-the-project-directory-yourself), das Claude Code nur aus der Start-Umgebung liest, wird aus jeder Datei ignoriert; erfordert v2.1.234 oder später.3112* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/de/sessions#name-the-project-directory-yourself), das Claude Code nur aus der Start-Umgebung liest, wird aus jeder Datei ignoriert; erfordert v2.1.234 oder später.

3022* [`CLAUDE_CODE_RESTRICTED`](/docs/de/env-vars#variables), das Claude Code nur aus der Start-Umgebung liest, wird aus jeder Datei ignoriert.3113* [`CLAUDE_CODE_RESTRICTED`](/docs/de/env-vars#variables), das Claude Code nur aus der Start-Umgebung liest, wird aus jeder Datei ignoriert.

3114* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/de/env-vars#variables), das Claude Code nur aus der Start-Umgebung liest, wird aus jeder Datei ignoriert. Die Variable erfordert Claude Code v2.1.283 oder später.

3115* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` und `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`](/docs/de/env-vars#variables), die Claude Code nur aus der Start-Umgebung liest, werden aus jeder Datei ignoriert.

3023 3116

3024<h3 id="filecheckpointingenabled">3117<h3 id="filecheckpointingenabled">

3025 `fileCheckpointingEnabled`3118 `fileCheckpointingEnabled`

3026</h3>3119</h3>

3027 3120

3028Lassen Sie Claude Code Dateien vor jeder Bearbeitung als Snapshot erstellen, damit [`/rewind`](/docs/de/checkpointing) sie wiederherstellen kann. Erscheint in `/config` als **Rewind code (checkpoints)**, und das Umschalten dort schreibt diesen Schlüssel in Ihre Benutzereinstellungen.3121Lassen Sie Claude Code vor jeder Bearbeitung Snapshots von Dateien erstellen, damit [`/rewind`](/docs/de/checkpointing) sie wiederherstellen kann. Erscheint in `/config` als **Rewind code (checkpoints)**, und das Umschalten dort schreibt diesen Schlüssel in Ihre Benutzereinstellungen.

3029 3122

3030* **Bereich**: [`Any file`](#scopes)3123* **Geltungsbereich**: [`Any file`](#scopes)

3031* **Typ**: Boolean3124* **Typ**: Boolean

3032 * `true`: Claude Code erstellt Snapshots von Dateien vor jeder Bearbeitung, damit `/rewind` sie wiederherstellen kann3125 * `true`: Claude Code erstellt vor jeder Bearbeitung Snapshots von Dateien, damit `/rewind` sie wiederherstellen kann

3033 * `false`: Claude Code erstellt keine Snapshots von Dateien, daher kann `/rewind` sie nicht wiederherstellen3126 * `false`: Claude Code erstellt keine Snapshots von Dateien, daher kann `/rewind` sie nicht wiederherstellen

3034* **Standard**: `true`3127* **Standard**: `true`

3035* **Sitzungsübersteuerungen**: [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/docs/de/env-vars) deaktiviert Checkpointing für eine Sitzung; welcher der beiden es deaktiviert, der andere kann es nicht wieder aktivieren3128* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/docs/de/env-vars) deaktiviert Checkpointing für eine Sitzung; welcher der beiden es auch deaktiviert, der andere kann es nicht wieder aktivieren

3036 3129

3037```json settings.json theme={null}3130```json settings.json theme={null}

3038{3131{

3040}3133}

3041```3134```

3042 3135

3043In einem `-p`-Lauf oder einer Agent SDK-Sitzung ignoriert Claude Code diesen Schlüssel. Das SDK aktiviert Checkpointing mit seiner `enableFileCheckpointing`-Option, und ein einfacher `-p`-Lauf benötigt `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true`. Siehe [Datei-Checkpointing im Agent SDK](/docs/de/agent-sdk/file-checkpointing).3136In einem `-p`-Lauf oder einer Agent SDK-Sitzung ignoriert Claude Code diesen Schlüssel. Das SDK aktiviert Checkpointing mit seiner Option `enableFileCheckpointing`, und ein einfacher `-p`-Lauf benötigt `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true`. Siehe [Datei-Checkpointing im Agent SDK](/docs/de/agent-sdk/file-checkpointing).

3044 3137

3045<h3 id="plansdirectory">3138<h3 id="plansdirectory">

3046 `plansDirectory`3139 `plansDirectory`

3048 3141

3049Wählen Sie, wo Claude Code die Plandateien speichert, die es im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) schreibt. Claude Code löst den Pfad relativ zum Projektstamm auf und behält den Standard bei, wenn der Pfad außerhalb davon aufgelöst wird.3142Wählen Sie, wo Claude Code die Plandateien speichert, die es im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) schreibt. Claude Code löst den Pfad relativ zum Projektstamm auf und behält den Standard bei, wenn der Pfad außerhalb davon aufgelöst wird.

3050 3143

3051* **Bereich**: [`Any file`](#scopes)3144* **Geltungsbereich**: [`Any file`](#scopes)

3052* **Typ**: String, ein Pfad relativ zum Projektstamm3145* **Typ**: String, ein Pfad relativ zum Projektstamm

3053* **Standard**: nicht gesetzt, daher verwendet Claude Code `~/.claude/plans`3146* **Standard**: nicht gesetzt, daher verwendet Claude Code `~/.claude/plans`

3054 3147

3062 `skillListingBudgetFraction`3155 `skillListingBudgetFraction`

3063</h3>3156</h3>

3064 3157

3065Jede Runde sieht Claude eine [Auflistung Ihrer Skills](/docs/de/skills#skill-descriptions-are-cut-short) mit ihren Beschreibungen, und Claude Code begrenzt diese Auflistung auf einen Anteil des Kontextfensters. Wenn die Auflistung über der Obergrenze liegt, behält Claude Code jeden Skill-Namen, löscht aber die Beschreibungen der am wenigsten verwendeten Skills, damit Claude diese Skills immer noch aufrufen kann, aber weniger wahrscheinlich selbst einen auswählt. Erhöhen Sie diesen Schlüssel, um mehr Beschreibungen sichtbar zu halten, auf Kosten von mehr Kontext pro Runde.3158In jedem Turn sieht Claude eine [Auflistung Ihrer Skills](/docs/de/skills#skill-descriptions-are-cut-short) mit ihren Beschreibungen, und Claude Code begrenzt diese Auflistung auf einen Anteil des Kontextfensters. Wenn die Auflistung die Obergrenze überschreitet, behält Claude Code den Namen jedes Skills bei, entfernt aber die Beschreibungen der am wenigsten verwendeten Skills, sodass Claude diese Skills weiterhin aufrufen kann, aber seltener von sich aus einen davon auswählt. Erhöhen Sie diesen Schlüssel, um mehr Beschreibungen sichtbar zu halten, auf Kosten von mehr Kontext pro Turn.

3066 3159

3067* **Bereich**: [`Any file`](#scopes)3160* **Geltungsbereich**: [`Any file`](#scopes)

3068* **Typ**: Zahl, ein Bruch größer als `0` und höchstens `1`3161* **Typ**: Zahl, ein Bruchteil größer als `0` und höchstens `1`

3069* **Standard**: `0.01`, das 1% des Kontextfensters reserviert3162* **Standard**: `0.01`, was 1 % des Kontextfensters reserviert

3070 3163

3071```json settings.json theme={null}3164```json settings.json theme={null}

3072{3165{

3080 `skillListingMaxDescChars`3173 `skillListingMaxDescChars`

3081</h3>3174</h3>

3082 3175

3083Jede Runde sieht Claude eine [Auflistung Ihrer Skills](/docs/de/skills#skill-descriptions-are-cut-short), die den `description`- und `when_to_use`-Text jedes Skills zeigt. Dieser Schlüssel begrenzt, wie viele Zeichen dieses Textes Claude Code pro Skill anzeigt; längerer Text wird bei der Obergrenze abgeschnitten.3176In jedem Turn sieht Claude eine [Auflistung Ihrer Skills](/docs/de/skills#skill-descriptions-are-cut-short), die den `description`- und `when_to_use`-Text jedes Skills zeigt. Dieser Schlüssel begrenzt, wie viele Zeichen dieses Textes Claude Code pro Skill anzeigt; längerer Text wird an der Obergrenze abgeschnitten.

3084 3177

3085* **Bereich**: [`Any file`](#scopes)3178* **Geltungsbereich**: [`Any file`](#scopes)

3086* **Typ**: Anzahl der Zeichen, eine positive ganze Zahl3179* **Typ**: Anzahl der Zeichen, eine positive ganze Zahl

3087* **Standard**: `1536`3180* **Standard**: `1536`

3088 3181

3092}3185}

3093```3186```

3094 3187

3095Erhöhen Sie es, um lange Beschreibungen intakt zu halten, auf Kosten von mehr Kontext pro Runde; senken Sie es, um mehr Skills unter [`skillListingBudgetFraction`](#skilllistingbudgetfraction) zu passen.3188Erhöhen Sie den Wert, um lange Beschreibungen vollständig zu erhalten, auf Kosten von mehr Kontext pro Turn; senken Sie ihn, um mehr Skills innerhalb von [`skillListingBudgetFraction`](#skilllistingbudgetfraction) unterzubringen.

3096 3189

3097<h3 id="taskoutputmaxchars">3190<h3 id="taskoutputmaxchars">

3098 `taskOutputMaxChars`3191 `taskOutputMaxChars`

3099</h3>3192</h3>

3100 3193

3101<Warning>3194<Warning>

3102 Entfernt in v2.1.277, zusammen mit dem `TaskOutput`-Tool, das es dimensioniert. Das Setzen hat keine Auswirkung auf aktuelle Versionen. Claude liest eine [Ausgabedatei](/docs/de/tools-reference#background-commands) einer Hintergrundaufgabe stattdessen mit `Read`.3195 Entfernt in v2.1.277, zusammen mit dem `TaskOutput`-Tool, dessen Ausgabegröße es festlegte. Das Setzen hat in aktuellen Versionen keine Auswirkung. Claude liest die [Ausgabedatei](/docs/de/tools-reference#background-commands) einer Hintergrundaufgabe stattdessen mit `Read`.

3103</Warning>3196</Warning>

3104 3197

3105Bis v2.1.276 setzen Sie diesen Schlüssel auf die Anzahl der Zeichen einer [Hintergrundaufgabe](/docs/de/tools-reference#background-commands) Ausgabe, die Claude inline erhielt, wenn es die Aufgabe mit dem `TaskOutput`-Tool las.3198Bis v2.1.276 legten Sie mit diesem Schlüssel die Anzahl der Zeichen der Ausgabe einer [Hintergrundaufgabe](/docs/de/tools-reference#background-commands) fest, die Claude inline erhielt, wenn es die Aufgabe mit dem `TaskOutput`-Tool las.

3106 3199

3107<h2 id="interface-and-terminal">3200<h2 id="interface-and-terminal">

3108 Schnittstelle und Terminal3201 Oberfläche und Terminal

3109</h2>3202</h2>

3110 3203

3111Ändern Sie das Aussehen und Verhalten von Claude Code in Ihrem Terminal: Design, Editor-Modus, Statuszeile, Spinner, Benachrichtigungen innerhalb der Sitzung und Barrierefreiheit. Siehe [Terminal-Konfiguration](/docs/de/terminal-config).3204Ändern Sie, wie Claude Code in Ihrem Terminal aussieht und sich verhält: Theme, Editor-Modus, Statuszeile, Spinner, Benachrichtigungen innerhalb der Sitzung und Barrierefreiheit. Siehe [Terminal-Konfiguration](/docs/de/terminal-config).

3112 3205

3113<h3 id="askuserquestiontimeout">3206<h3 id="askuserquestiontimeout">

3114 `askUserQuestionTimeout`3207 `askUserQuestionTimeout`

3115</h3>3208</h3>

3116 3209

3117Lassen Sie einen unbeantworteten [`AskUserQuestion`](/docs/de/tools-reference)-Dialog nach einer Leerlaufzeit automatisch fortfahren und dabei alle bereits ausgewählten Optionen einreichen. Legen Sie dies fest, wenn Sie sich abmelden und möchten, dass Claude ohne Sie fortfährt. Mit der Standardeinstellung warten Fragen, bis Sie sie beantworten. Erfordert Claude Code v2.1.200 oder später.3210Lassen Sie einen unbeantworteten [`AskUserQuestion`](/docs/de/tools-reference)-Dialog nach einer Leerlaufzeit automatisch fortfahren, wobei die bereits ausgewählten Optionen übermittelt werden. Setzen Sie diesen Schlüssel, wenn Sie sich entfernen und möchten, dass Claude ohne Sie weiterarbeitet. Mit dem Standardwert warten Fragen, bis Sie sie beantworten. Erfordert Claude Code v2.1.200 oder höher.

3118 3211

3119* **Bereich**: [`Benutzer oder verwaltet`](#scopes)3212* **Geltungsbereich**: [`User or managed`](#scopes)

3120* **Typ**: String, einer von `"60s"`, `"5m"`, `"10m"` oder `"never"`3213* **Typ**: String, einer von `"60s"`, `"5m"`, `"10m"` oder `"never"`

3121* **Standard**: `"never"`3214* **Standard**: `"never"`

3122* **Sitzungsübergreifende Außerkraftsetzungen**: [`CLAUDE_AFK_TIMEOUT_MS`](/docs/de/env-vars) hat Vorrang vor diesem Schlüssel für eine Sitzung3215* **Überschreibungen pro Sitzung**: [`CLAUDE_AFK_TIMEOUT_MS`](/docs/de/env-vars) hat für eine Sitzung Vorrang vor diesem Schlüssel

3123 3216

3124```json settings.json theme={null}3217```json settings.json theme={null}

3125{3218{

3127}3220}

3128```3221```

3129 3222

3130Erscheint in `/config` als **Frage automatisch fortsetzen Timeout**, das diesen Schlüssel in Benutzereinstellungen schreibt; Claude Code blendet die Zeile aus, während verwaltete Einstellungen oder das Flag `--settings` den Schlüssel setzen. Erfordert Claude Code v2.1.200 oder später.3223Erscheint in `/config` als **Question auto-continue timeout**, das diesen Schlüssel in die Benutzereinstellungen schreibt; Claude Code blendet die Zeile aus, solange verwaltete Einstellungen oder das Flag `--settings` den Schlüssel setzen. Erfordert Claude Code v2.1.200 oder höher.

3131 3224

3132<h3 id="autocontinueatusagelimit">3225<h3 id="autocontinueatusagelimit">

3133 `autoContinueAtUsageLimit`3226 `autoContinueAtUsageLimit`

3134</h3>3227</h3>

3135 3228

3136Nachdem ein claude.ai-Nutzungslimit Ihre Sitzung stoppt, warten Sie in der offenen Sitzung und fahren Sie die Aufgabe nach dem Zurücksetzen automatisch fort. Siehe [Automatisches Fortsetzen ausschalten](/docs/de/interactive-mode#turn-automatic-continue-off). Erfordert Claude Code v2.1.234 oder später.3229Nachdem ein claude.ai-Nutzungslimit Ihre Sitzung angehalten hat, in der geöffneten Sitzung warten und die Aufgabe nach dem Zurücksetzen automatisch fortsetzen. Siehe [Automatisches Fortsetzen ausschalten](/docs/de/interactive-mode#turn-automatic-continue-off). Erfordert Claude Code v2.1.234 oder höher.

3137 3230

3138* **Bereich**: [`Benutzer oder verwaltet`](#scopes). Lesen Sie aus Benutzereinstellungen, `--settings` und verwalteten Einstellungen nur. Wenn keiner dieser Einstellungen den Schlüssel setzt, schaltet eine Projekt- oder lokale Einstellungsdatei, die ihn setzt, die Funktion aus, anstatt ignoriert zu werden.3231* **Geltungsbereich**: [`User or managed`](#scopes). Wird nur aus den Benutzereinstellungen, `--settings` und verwalteten Einstellungen gelesen. Wenn keine davon den Schlüssel setzt, schaltet eine Projekt- oder lokale Einstellungsdatei, die ihn setzt, die Funktion aus, statt ignoriert zu werden.

3139* **Typ**: Boolean3232* **Typ**: Boolean

3140 * `true`: Nachdem ein claude.ai-Nutzungslimit Ihre Sitzung stoppt, wartet Claude Code in der offenen Sitzung und setzt die Aufgabe nach dem Zurücksetzen automatisch fort3233 * `true`: Nachdem ein claude.ai-Nutzungslimit Ihre Sitzung angehalten hat, wartet Claude Code in der geöffneten Sitzung und setzt die Aufgabe nach dem Zurücksetzen automatisch fort

3141 * `false`: Claude Code startet das Warten nicht von selbst. Sie können immer noch [ein Warten selbst starten](/docs/de/interactive-mode#start-a-wait-yourself) aus dem Menü der Nutzungslimit-Optionen3234 * `false`: Claude Code startet das Warten nicht von selbst. Sie können [das Warten weiterhin selbst starten](/docs/de/interactive-mode#start-a-wait-yourself), und zwar über das Optionsmenü für Nutzungslimits

3142* **Standard**: `true`3235* **Standard**: `true`

3143 3236

3144```json settings.json theme={null}3237```json settings.json theme={null}

3147}3240}

3148```3241```

3149 3242

3150Erscheint in `/config` als **Automatisch bei Nutzungslimit fortsetzen**, das diesen Schlüssel in Benutzereinstellungen schreibt; Claude Code blendet die Zeile aus, während verwaltete Einstellungen oder das Flag `--settings` den Schlüssel setzen.3243Erscheint in `/config` als **Continue automatically at usage limit**, das diesen Schlüssel in die Benutzereinstellungen schreibt; Claude Code blendet die Zeile aus, solange verwaltete Einstellungen oder das Flag `--settings` den Schlüssel setzen.

3151 3244

3152<h3 id="autoscrollenabled">3245<h3 id="autoscrollenabled">

3153 `autoScrollEnabled`3246 `autoScrollEnabled`

3154</h3>3247</h3>

3155 3248

3156Folgen Sie neuer Ausgabe zum unteren Ende des Gesprächs in [Vollbilddarstellung](/docs/de/fullscreen). Schalten Sie es aus, um dort zu bleiben, wo Sie gescrollt haben, während Claude weiterarbeitet; Berechtigungsaufforderungen werden immer noch in die Ansicht gescrollt.3249Neuer Ausgabe bis zum Ende der Konversation folgen, im [Vollbild-Rendering](/docs/de/fullscreen). Schalten Sie es aus, um an der Stelle zu bleiben, zu der Sie gescrollt haben, während Claude weiterarbeitet; Berechtigungsabfragen werden weiterhin in den sichtbaren Bereich gescrollt.

3157 3250

3158* **Bereich**: [`Beliebige Datei`](#scopes)3251* **Geltungsbereich**: [`Any file`](#scopes)

3159* **Typ**: Boolean3252* **Typ**: Boolean

3160 * `true`: Das Gespräch folgt neuer Ausgabe zum unteren Ende3253 * `true`: Die Konversation folgt neuer Ausgabe bis zum Ende

3161 * `false`: Sie bleiben dort, wo Sie gescrollt haben, während Claude weiterarbeitet; Berechtigungsaufforderungen werden immer noch unter dem Transkript angezeigt3254 * `false`: Sie bleiben an der Stelle, zu der Sie gescrollt haben, während Claude weiterarbeitet; Berechtigungsabfragen erscheinen weiterhin unterhalb des Transkripts

3162* **Standard**: `true`3255* **Standard**: `true`

3163 3256

3164```json settings.json theme={null}3257```json settings.json theme={null}

3167}3260}

3168```3261```

3169 3262

3170Erscheint in `/config` als **Automatisches Scrollen**, wenn Vollbilddarstellung aktiviert ist, das diesen Schlüssel in Benutzereinstellungen schreibt.3263Erscheint in `/config` als **Auto-scroll**, wenn das Vollbild-Rendering aktiv ist, und schreibt diesen Schlüssel in die Benutzereinstellungen.

3171 3264

3172<h3 id="axscreenreader">3265<h3 id="axscreenreader">

3173 `axScreenReader`3266 `axScreenReader`

3174</h3>3267</h3>

3175 3268

3176Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Der Bildschirmlesermodus verwendet den klassischen Renderer, daher hat die Einstellung `tui` keine Auswirkung, während er aktiv ist; angehängte [Hintergrundsitzungen](/docs/de/agent-view) werden immer noch im Vollbild gerendert.3269Screenreader-freundliche Ausgabe rendern: einfacher Text ohne dekorative Rahmen oder Animationen. Der Screenreader-Modus verwendet den klassischen Renderer, daher hat die Einstellung `tui` keine Wirkung, solange er aktiv ist; angehängte [Hintergrundsitzungen](/docs/de/agent-view) werden weiterhin im Vollbild gerendert.

3177 3270

3178* **Bereich**: [`Beliebige Datei`](#scopes)3271* **Geltungsbereich**: [`Any file`](#scopes)

3179* **Typ**: Boolean3272* **Typ**: Boolean

3180 * `true`: Claude Code rendert flachen Text ohne dekorative Rahmen oder Animationen mit dem klassischen Renderer3273 * `true`: Claude Code rendert einfachen Text ohne dekorative Rahmen oder Animationen und verwendet den klassischen Renderer

3181 * `false`: Claude Code rendert normal3274 * `false`: Claude Code rendert normal

3182* **Standard**: nicht gesetzt, daher ist der Bildschirmlesermodus aus3275* **Standard**: nicht gesetzt, daher ist der Screenreader-Modus aus

3183* **Sitzungsübergreifende Außerkraftsetzungen**: [`--ax-screen-reader`](/docs/de/cli-reference#cli-flags) hat Vorrang vor [`CLAUDE_AX_SCREEN_READER`](/docs/de/env-vars), und beide haben Vorrang vor diesem Schlüssel für eine Sitzung3276* **Überschreibungen pro Sitzung**: [`--ax-screen-reader`](/docs/de/cli-reference#cli-flags) hat Vorrang vor [`CLAUDE_AX_SCREEN_READER`](/docs/de/env-vars), und beide haben für eine Sitzung Vorrang vor diesem Schlüssel

3184 3277

3185```json settings.json theme={null}3278```json settings.json theme={null}

3186{3279{

3192 `bashEditDiffEnabled`3285 `bashEditDiffEnabled`

3193</h3>3286</h3>

3194 3287

3195Wählen Sie, ob Claude Code die Dateien aufzeichnet, die ein Bash-Befehl in einem Git-Repository ändert. Wenn es sie aufzeichnet, sehen Sie ihren Diff im Terminal nach dem Befehl, und Ihre [PostToolUse Bash Hooks](/docs/de/hooks#bash) erhalten die Liste der geänderten Dateien.3288Legen Sie fest, ob Claude Code aufzeichnet, welche Dateien sich in einem Git-Repository geändert haben, während ein Bash-Befehl läuft. Wenn es sie aufzeichnet, sehen Sie nach dem Befehl deren Diff im Terminal, und Ihre [PostToolUse-Bash-Hooks](/docs/de/hooks#bash) erhalten die Liste der geänderten Dateien.

3196 3289

3197Eine aufgelistete Datei ist nicht immer eine, die der Befehl geändert hat. Eine Änderung, die ein anderes Programm oder ein anderer Bash-Aufruf vorgenommen hat, während der Befehl lief, kann dort auch erscheinen.3290Eine aufgeführte Datei ist nicht immer eine, die der Befehl geändert hat. Auch eine Änderung, die ein anderes Programm oder ein anderer Bash-Aufruf vorgenommen hat, während der Befehl lief, kann dort erscheinen.

3198 3291

3199Setzen Sie den Schlüssel auf `true`, um sie in jedem Berechtigungsmodus aufzuzeichnen. Erfordert Claude Code v2.1.269 oder später.3292Setzen Sie den Schlüssel auf `true`, um sie in jedem Berechtigungsmodus aufzuzeichnen. Erfordert Claude Code v2.1.269 oder höher.

3200 3293

3201* **Bereich**: [`Benutzer oder verwaltet`](#scopes). Ein `true` zählt nur aus Ihren Benutzereinstellungen, JSON, das mit `--settings` übergeben wird, oder [verwalteten Einstellungen](/docs/de/managed-settings), daher kann ein `true` in der `.claude/settings.json` oder `.claude/settings.local.json` eines Repositories die Aufzeichnung nicht einschalten. Ein `false` in einer der Repository-Dateien schaltet es immer noch aus, es sei denn, eine [höher priorisierte](/docs/de/settings#settings-precedence) Datei setzt `true`.3294* **Geltungsbereich**: [`User or managed`](#scopes). Ein `true` zählt nur aus Ihren Benutzereinstellungen, aus mit `--settings` übergebenem JSON oder aus [verwalteten Einstellungen](/docs/de/managed-settings), daher kann ein `true` in der `.claude/settings.json` oder `.claude/settings.local.json` eines Repositorys die Aufzeichnung nicht einschalten. Ein `false` in einer der beiden Repository-Dateien schaltet sie dennoch aus, es sei denn, eine Datei mit [höherem Vorrang](/docs/de/settings#settings-precedence) setzt `true`.

3202* **Typ**: Boolean3295* **Typ**: Boolean

3203* **Standard**: nicht gesetzt, daher zeichnet Claude Code Änderungen im Auto-Modus und `bypassPermissions`-Modus auf, wenn es Claude anweist, Dateien über Bash zu bearbeiten3296* **Standard**: nicht gesetzt, daher zeichnet Claude Code Änderungen im Auto-Modus und im Modus `bypassPermissions` auf, wenn es Claude anweist, Dateien über Bash zu bearbeiten

3204* **Sitzungsübergreifende Außerkraftsetzungen**: [`CLAUDE_CODE_BASH_EDIT_DIFF`](/docs/de/env-vars) hat Vorrang vor diesem Schlüssel für eine Sitzung3297* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_BASH_EDIT_DIFF`](/docs/de/env-vars) hat für eine Sitzung Vorrang vor diesem Schlüssel

3205 3298

3206```json settings.json theme={null}3299```json settings.json theme={null}

3207{3300{

3213 `companyAnnouncements`3306 `companyAnnouncements`

3214</h3>3307</h3>

3215 3308

3216Zeigen Sie die Ankündigungen Ihrer Organisation den Benutzern beim Start an. Wenn Sie mehr als eine auflisten, wählt Claude Code für jede Sitzung zufällig eine aus; beim allerersten Start eines Benutzers wird der erste Eintrag angezeigt.3309Den Benutzern beim Start die Ankündigungen Ihrer Organisation anzeigen. Wenn Sie mehr als eine auflisten, wählt Claude Code für jede Sitzung eine zufällig aus; beim allerersten Start einer Person zeigt es den ersten Eintrag.

3217 3310

3218* **Bereich**: [`Beliebige Datei`](#scopes)3311* **Geltungsbereich**: [`Any file`](#scopes)

3219* **Typ**: Array von Strings3312* **Typ**: Array von Strings

3220* **Standard**: nicht gesetzt, daher wird keine Ankündigung angezeigt3313* **Standard**: nicht gesetzt, daher wird keine Ankündigung angezeigt

3221 3314

3231 `defaultShell`3324 `defaultShell`

3232</h3>3325</h3>

3233 3326

3234Wählen Sie, ob Bash oder PowerShell die Shell-Befehle ausführt, die Sie mit dem Präfix [`!`](/docs/de/interactive-mode#shell-mode-with-prefix) im Eingabefeld eingeben, die Claude Code direkt ausführt und zur Sitzung hinzufügt.3327Legen Sie fest, ob Bash oder PowerShell die Shell-Befehle ausführt, die Sie mit dem [`!`-Präfix](/docs/de/interactive-mode#shell-mode-with-prefix) in das Eingabefeld eingeben, also die Befehle, die Claude Code direkt ausführt und der Sitzung hinzufügt.

3235 3328

3236`"powershell"` funktioniert nur, wenn das [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) aktiviert ist. Das Tool ist standardmäßig unter Windows ohne Git Bash aktiviert und unter Windows mit Git Bash für claude.ai- und Console-Konten. In Amazon Bedrock-, Google Cloud Agent Platform- und Microsoft Foundry-Sitzungen sowie unter macOS, Linux und WSL setzen Sie `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`, um das Tool zu aktivieren. Setzen Sie diese Variable auf `0`, um das Tool auszuschalten.3329`"powershell"` funktioniert nur, solange das [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) eingeschaltet ist. Das Tool ist standardmäßig unter Windows ohne Git Bash eingeschaltet sowie unter Windows mit Git Bash für claude.ai- und Console-Konten. In Sitzungen mit Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry sowie unter macOS, Linux und WSL setzen Sie `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`, um das Tool einzuschalten. Setzen Sie diese Variable auf `0`, um das Tool auszuschalten.

3237 3330

3238* **Bereich**: [`Beliebige Datei`](#scopes)3331* **Geltungsbereich**: [`Any file`](#scopes)

3239* **Typ**: String, einer von:3332* **Typ**: String, einer von:

3240 * `"bash"`: Claude Code führt Ihre `!`-Befehle in Bash aus3333 * `"bash"`: Claude Code führt Ihre `!`-Befehle in Bash aus

3241 * `"powershell"`: Claude Code führt Ihre `!`-Befehle in PowerShell aus3334 * `"powershell"`: Claude Code führt Ihre `!`-Befehle in PowerShell aus

3242* **Standard**: `"bash"` oder `"powershell"` unter Windows, wenn Bash nicht verfügbar ist3335* **Standard**: `"bash"`, oder `"powershell"` unter Windows, wenn Bash nicht verfügbar ist

3243 3336

3244```json settings.json theme={null}3337```json settings.json theme={null}

3245{3338{

3247}3340}

3248```3341```

3249 3342

3250Wenn die Shell, die Sie benennen, nicht verfügbar ist, verwendet Claude Code die andere: `"powershell"` fällt auf Bash zurück, wenn das PowerShell-Tool aus ist, und `"bash"` fällt auf PowerShell zurück, wenn Bash nicht installiert ist.3343Wenn die angegebene Shell nicht verfügbar ist, verwendet Claude Code die jeweils andere: `"powershell"` fällt auf Bash zurück, wenn das PowerShell-Tool ausgeschaltet ist, und `"bash"` fällt auf PowerShell zurück, wenn Bash nicht installiert ist.

3251 3344

3252<h3 id="dialogexpiry">3345<h3 id="dialogexpiry">

3253 `dialogExpiry`3346 `dialogExpiry`

3254</h3>3347</h3>

3255 3348

3256Legen Sie die Frist für Dialoge fest, die Claude Code [an einen Remote-Client weiterleitet](/docs/de/remote-control#limitations), wie einen Remote Control oder SDK-Host, und für den Genehmigungsdialog für eine [gehaltene sitzungsübergreifende Nachricht](/docs/de/cross-session-messaging#control-inbound-messages). In Claude Code v2.1.236 oder später begrenzt die gleiche Frist die Aufforderung zur Zustimmung für Fable-Nutzungsguthaben in der Mitte der Sitzung]\(/de/model-config#fable-and-usage-credits) in einer Sitzung, in der möglicherweise niemand am Terminal ist. Wenn vor der Frist keine Antwort eintrifft, bricht Claude Code den Dialog ab und fährt mit seinem Standardwert ohne Aktion fort. Erfordert Claude Code v2.1.224 oder später.3349Legen Sie die Frist für Dialoge fest, die Claude Code [an einen Remote-Client weiterleitet](/docs/de/remote-control#limitations), etwa einen Remote-Control- oder SDK-Host, sowie für den Genehmigungsdialog einer [zurückgehaltenen sitzungsübergreifenden Nachricht](/docs/de/cross-session-messaging#control-inbound-messages). Ab Claude Code v2.1.236 begrenzt dieselbe Frist auch die während der Sitzung erscheinende [Zustimmungsabfrage für Fable-Nutzungsguthaben](/docs/de/model-config#fable-and-usage-credits) in einer Sitzung, in der möglicherweise niemand am Terminal ist. Wenn vor Ablauf der Frist keine Antwort eingeht, bricht Claude Code den Dialog ab und fährt mit seinem Standard ohne Aktion fort. Erfordert Claude Code v2.1.224 oder höher.

3257 3350

3258* **Bereich**: [`Benutzer oder verwaltet`](#scopes)3351* **Geltungsbereich**: [`User or managed`](#scopes)

3259* **Typ**: String, einer von `"60s"`, `"5m"`, `"10m"` oder `"never"`, das die Frist deaktiviert3352* **Typ**: String, einer von `"60s"`, `"5m"`, `"10m"` oder `"never"`, was die Frist deaktiviert

3260* **Standard**: `"5m"`3353* **Standard**: `"5m"`

3261* **Sitzungsübergreifende Außerkraftsetzungen**: [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](/docs/de/env-vars) hat Vorrang vor diesem Schlüssel für eine Sitzung3354* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](/docs/de/env-vars) hat für eine Sitzung Vorrang vor diesem Schlüssel

3262 3355

3263```json settings.json theme={null}3356```json settings.json theme={null}

3264{3357{

3266}3359}

3267```3360```

3268 3361

3269Berechtigungsaufforderungen und [`AskUserQuestion`](/docs/de/tools-reference#askuserquestion-tool-behavior)-Fragen verwenden ihre eigenen Abläufe und werden nicht durch diese Frist geregelt. Erscheint in `/config` als **Dialog-Ablauf**, das diesen Schlüssel in Benutzereinstellungen schreibt; die Zeile erfordert Claude Code v2.1.232 oder später, und Claude Code blendet sie aus, während verwaltete Einstellungen oder das Flag `--settings` den Schlüssel setzen.3362Berechtigungsabfragen und [`AskUserQuestion`](/docs/de/tools-reference#askuserquestion-tool-behavior)-Fragen verwenden eigene Abläufe und unterliegen dieser Frist nicht. Erscheint in `/config` als **Dialog expiry**, das diesen Schlüssel in die Benutzereinstellungen schreibt; die Zeile erfordert Claude Code v2.1.232 oder höher, und Claude Code blendet sie aus, solange verwaltete Einstellungen oder das Flag `--settings` den Schlüssel setzen.

3270 3363

3271<h3 id="editormode">3364<h3 id="editormode">

3272 `editorMode`3365 `editorMode`

3273</h3>3366</h3>

3274 3367

3275Wählen Sie den Tastenbindungsmodus für die Eingabeaufforderung.3368Wählen Sie den Tastenbelegungsmodus für die Eingabeaufforderung.

3276 3369

3277* **Bereich**: [`Beliebige Datei`](#scopes)3370* **Geltungsbereich**: [`Any file`](#scopes)

3278* **Typ**: String, einer von:3371* **Typ**: String, einer von:

3279 * `"normal"`: Standard-Tastenbindungen in der Eingabeaufforderung3372 * `"normal"`: Standard-Tastenbelegungen in der Prompt-Eingabe

3280 * `"vim"`: Vim-ähnliche Bearbeitung mit NORMAL-, INSERT- und VISUAL-Modi3373 * `"vim"`: Bearbeitung im vim-Stil mit den Modi NORMAL, INSERT und VISUAL

3281* **Standard**: `"normal"`3374* **Standard**: `"normal"`

3282 3375

3283```json settings.json theme={null}3376```json settings.json theme={null}

3286}3379}

3287```3380```

3288 3381

3289Erscheint in `/config` als **Editor-Modus**, das diesen Schlüssel in Benutzereinstellungen schreibt.3382Erscheint in `/config` als **Editor mode**, das diesen Schlüssel in die Benutzereinstellungen schreibt.

3290 3383

3291<h3 id="emojicompletionenabled">3384<h3 id="emojicompletionenabled">

3292 `emojiCompletionEnabled`3385 `emojiCompletionEnabled`

3293</h3>3386</h3>

3294 3387

3295Zeigen Sie Emoji-Vorschläge an, wenn Sie `:` plus einen Shortcode in der Eingabeaufforderung eingeben, und ersetzen Sie einen abgeschlossenen Shortcode wie `:heart:` durch sein Emoji. Setzen Sie es auf `false`, um beides auszuschalten.3388Emoji-Vorschläge anzeigen, wenn Sie in der Prompt-Eingabe `:` plus einen Shortcode eingeben, und einen vollständigen Shortcode wie `:heart:` durch sein Emoji ersetzen. Setzen Sie den Schlüssel auf `false`, um beides auszuschalten.

3296 3389

3297* **Bereich**: [`Beliebige Datei`](#scopes)3390* **Geltungsbereich**: [`Any file`](#scopes)

3298* **Typ**: Boolean3391* **Typ**: Boolean

3299 * `true`: Claude Code zeigt Emoji-Vorschläge nach `:` an und ersetzt einen abgeschlossenen Shortcode durch sein Emoji3392 * `true`: Claude Code zeigt nach `:` Emoji-Vorschläge an und ersetzt einen vollständigen Shortcode durch sein Emoji

3300 * `false`: Claude Code schlägt weder Emoji vor noch ersetzt Shortcodes3393 * `false`: Claude Code schlägt weder Emojis vor noch ersetzt es Shortcodes

3301* **Standard**: `true`3394* **Standard**: `true`

3302 3395

3303```json settings.json theme={null}3396```json settings.json theme={null}

3306}3399}

3307```3400```

3308 3401

3309Siehe [Emoji-Shortcodes](/docs/de/interactive-mode#emoji-shortcodes). Erfordert Claude Code v2.1.217 oder später.3402Siehe [Emoji-Shortcodes](/docs/de/interactive-mode#emoji-shortcodes). Erfordert Claude Code v2.1.217 oder höher.

3310 3403

3311<span id="file-suggestion-settings" />3404<span id="file-suggestion-settings" />

3312 3405

3314 `fileSuggestion`3407 `fileSuggestion`

3315</h3>3408</h3>

3316 3409

3317Führen Sie Ihren eigenen Befehl aus, um `@`-Dateipfad-Autovervollständigung anstelle des integrierten Dateivorschlags bereitzustellen. Der integrierte Vorschlag verwendet schnelle Dateisystem-Durchquerung; ein großes Monorepo könnte von projektspezifischer Indizierung wie einem vordefinierten Dateiindex profitieren.3410Einen eigenen Befehl ausführen, um die `@`-Autovervollständigung für Dateipfade anstelle der integrierten Dateivorschläge bereitzustellen. Die integrierten Vorschläge verwenden eine schnelle Dateisystemdurchsuchung; bei einem großen Monorepo kann eine projektspezifische Indizierung, etwa ein vorab erstellter Dateiindex, besser geeignet sein.

3318 3411

3319* **Bereich**: [`Beliebige Datei`](#scopes). Unter den [Statuszeilen- und Dateivorschlag-Gates](#status-line-and-file-suggestion-gates) schaltet Claude Code den Befehl aus oder führt nur einen verwalteten Wert aus und überspringt Ihren ohne Warnung.3412* **Geltungsbereich**: [`Any file`](#scopes). Unter den [Sperren für Statuszeile und Dateivorschläge](#status-line-and-file-suggestion-gates) schaltet Claude Code den Befehl aus oder führt nur einen verwalteten Wert aus und überspringt Ihren ohne Warnung.

3320* **Typ**: Objekt mit `type`, immer `"command"`, und `command`, dem auszuführenden Shell-Befehl3413* **Typ**: Objekt mit `type`, immer `"command"`, und `command`, dem auszuführenden Shell-Befehl

3321* **Standard**: nicht gesetzt, daher verwendet Claude Code den integrierten Dateivorschlag3414* **Standard**: nicht gesetzt, daher verwendet Claude Code die integrierten Dateivorschläge

3322 3415

3323```json settings.json theme={null}3416```json settings.json theme={null}

3324{3417{

3329}3422}

3330```3423```

3331 3424

3332Nachdem Sie dies gespeichert haben, geben Sie `@` gefolgt von Teil eines Pfads in der Eingabeaufforderung ein: Die Vorschläge stammen aus der Ausgabe Ihres Befehls.3425Nachdem Sie dies gespeichert haben, geben Sie im Prompt `@` gefolgt von einem Teil eines Pfads ein: Die Vorschläge stammen aus der Ausgabe Ihres Befehls.

3333 3426

3334<h4 id="command-input-and-output">3427<h4 id="command-input-and-output">

3335 Befehlseingabe und -ausgabe3428 Ein- und Ausgabe des Befehls

3336</h4>3429</h4>

3337 3430

3338Claude Code führt den Befehl mit den gleichen Umgebungsvariablen wie [Hooks](/docs/de/hooks) aus, einschließlich `CLAUDE_PROJECT_DIR`, und stoppt das Warten nach fünf Sekunden. Der Befehl empfängt JSON auf stdin mit einem `query`-Feld, das enthält, was Sie bisher eingegeben haben:3431Claude Code führt den Befehl mit denselben Umgebungsvariablen wie [Hooks](/docs/de/hooks) aus, einschließlich `CLAUDE_PROJECT_DIR`, und hört nach fünf Sekunden auf zu warten. Der Befehl erhält auf stdin JSON mit einem Feld `query`, das enthält, was Sie bisher eingegeben haben:

3339 3432

3340```json theme={null}3433```json theme={null}

3341{"query": "src/comp"}3434{"query": "src/comp"}

3342```3435```

3343 3436

3344Geben Sie zeilengetrennte Dateipfade auf stdout aus. Claude Code zeigt höchstens 15:3437Geben Sie durch Zeilenumbrüche getrennte Dateipfade auf stdout aus. Claude Code zeigt höchstens 15 an:

3345 3438

3346```text theme={null}3439```text theme={null}

3347src/components/Button.tsx3440src/components/Button.tsx

3349src/components/Form.tsx3442src/components/Form.tsx

3350```3443```

3351 3444

3352Das folgende Skript liest die Abfrage und übergibt sie an einen Repository-Dateiindex:3445Das folgende Skript liest die Abfrage und übergibt sie an einen Dateiindex des Repositorys:

3353 3446

3354```bash theme={null}3447```bash theme={null}

3355#!/bin/bash3448#!/bin/bash

3364 `footerLinksRegexes`3457 `footerLinksRegexes`

3365</h3>3458</h3>

3366 3459

3367Rendern Sie zusätzliche anklickbare Abzeichen in der Fußzeile unter dem Eingabefeld, wenn ein Regex die Ausgabe einer Runde abgleicht: Tool-Ergebnisse, einschließlich Dateiinhalte und abgerufene Seiten, und Claudes eigene Antworten. Verwenden Sie es, um IDs, die von Projekt-CLIs wie Review-Tools und Issue-Trackern gedruckt werden, in Sitzungslinks umzuwandeln.3460Zusätzliche anklickbare Badges in der Fußzeile unterhalb des Eingabefelds rendern, wenn ein regulärer Ausdruck auf die Ausgabe eines Turns passt: Tool-Ergebnisse, einschließlich Dateiinhalten und abgerufener Seiten, sowie Claudes eigene Antworten. Verwenden Sie dies, um IDs, die von Projekt-CLIs wie Review-Tools und Issue-Trackern ausgegeben werden, in Sitzungslinks umzuwandeln.

3368 3461

3369* **Bereich**: [`Benutzer oder verwaltet`](#scopes)3462* **Geltungsbereich**: [`User or managed`](#scopes)

3370* **Typ**: Array von Objekten, jedes mit `type` auf `"regex"` gesetzt, einem `pattern`-Regex, einer `url`-Vorlage und einem optionalen `label`; `{name}`-Platzhalter in `url` und `label` werden aus benannten Erfassungsgruppen in `pattern` gefüllt3463* **Typ**: Array von Objekten, jeweils mit `type` auf `"regex"` gesetzt, einem regulären Ausdruck `pattern`, einer `url`-Vorlage und einem optionalen `label`; `{name}`-Platzhalter in `url` und `label` werden aus benannten Erfassungsgruppen in `pattern` befüllt

3371* **Standard**: nicht gesetzt, daher werden keine Abzeichen gerendert3464* **Standard**: nicht gesetzt, daher werden keine Badges gerendert

3372 3465

3373Dieses Beispiel gleicht Issue-Schlüssel wie `PROJ-1234` ab und erstellt jeden Link aus dem erfassten Schlüssel:3466Dieses Beispiel erkennt Issue-Schlüssel wie `PROJ-1234` und erstellt jeden Link aus dem erfassten Schlüssel:

3374 3467

3375```json settings.json theme={null}3468```json settings.json theme={null}

3376{3469{

3385}3478}

3386```3479```

3387 3480

3388Mit dieser Konfiguration wird, wenn `PROJ-1234` in einem Tool-Ergebnis oder in Claudes Antwort erscheint, ein `PROJ-1234`-Abzeichen in der Fußzeile angezeigt, das auf `https://issues.example.com/browse/PROJ-1234` verlinkt.3481Wenn dies konfiguriert ist und `PROJ-1234` in einem Tool-Ergebnis oder in Claudes Antwort erscheint, erscheint in der Fußzeile ein Badge `PROJ-1234`, das auf `https://issues.example.com/browse/PROJ-1234` verlinkt.

3389 3482

3390<h4 id="badge-constraints">3483<h4 id="badge-constraints">

3391 Abzeichen-Einschränkungen3484 Einschränkungen für Badges

3392</h4>3485</h4>

3393 3486

3394Die URL, das Label und die Abzeichen-Anzahl jedes Eintrags sind wie folgt begrenzt:3487URL, Beschriftung und Badge-Anzahl jedes Eintrags sind wie folgt begrenzt:

3395 3488

3396| Einschränkung | Verhalten |3489| Einschränkung | Verhalten |

3397| :- | :- |3490| :- | :- |

3398| URL-Ursprung | Erfasste Werte werden URL-codiert und die konstruierte URL muss den Ursprung der Vorlage teilen. Eine Erfassung kann ein Pfadsegment oder einen Abfragewert ausfüllen, kann aber nicht ändern, wohin der Link verweist |3491| URL-Ursprung | Erfasste Werte werden URL-kodiert, und die erstellte URL muss denselben literalen Ursprung wie die Vorlage haben. Eine Erfassung kann ein Pfadsegment oder einen Abfragewert füllen, aber nicht ändern, wohin der Link verweist |

3399| URL-Länge | Konstruierte URLs länger als 2048 Zeichen werden verworfen |3492| URL-Länge | Erstellte URLs mit mehr als 2048 Zeichen werden verworfen |

3400| URL-Schema | Muss `https`, `http` oder ein erkanntes Editor- oder Workspace-Deep-Link-Schema sein: `vscode`, `vscode-insiders`, `cursor`, `windsurf`, `zed`, `jetbrains`, `idea`, `slack`, `linear`, `notion`, `figma` |3493| URL-Schema | Muss `https`, `http` oder ein anerkanntes Deep-Link-Schema für Editoren oder Workspaces sein: `vscode`, `vscode-insiders`, `cursor`, `windsurf`, `zed`, `jetbrains`, `idea`, `slack`, `linear`, `notion`, `figma` |

3401| Label | Standardmäßig der abgeglichene Text und wird auf 28 Anzeigespalten gekürzt |3494| Beschriftung | Standardmäßig der übereinstimmende Text, gekürzt auf 28 Anzeigespalten |

3402| Abzeichen-Anzahl | Höchstens 5 Abzeichen werden gerendert. Das älteste wird durch neuere Übereinstimmungen verdrängt und `/clear` entfernt sie |3495| Badge-Anzahl | Höchstens 5 Badges werden gerendert. Das älteste wird durch neuere Treffer verdrängt, und `/clear` entfernt sie |

3403 3496

3404Wenn eine Runde abgeschlossen ist, gleicht Claude Code jeden `pattern`-Regex des Eintrags gegen die Ausgabe der Runde im Hauptthread ab, daher blockiert ein langsamer Regex die Benutzeroberfläche, bis er fertig ist. Verschachtelte Quantoren wie `(a+)+$` können gegen bestimmte Eingaben exponentiell lange dauern und die Sitzung einfrieren, daher halten Sie jeden `pattern` linear und vermeiden Sie Verschachtelung von `+` oder `*`.3497Wenn ein Turn abgeschlossen ist, gleicht Claude Code den regulären Ausdruck `pattern` jedes Eintrags im Hauptthread mit der Ausgabe des Turns ab, daher blockiert ein langsamer regulärer Ausdruck die Oberfläche, bis er fertig ist. Verschachtelte Quantifizierer wie `(a+)+$` können bei bestimmten Eingaben exponentiell lange dauern und die Sitzung einfrieren, halten Sie daher jedes `pattern` linear und vermeiden Sie verschachtelte `+` oder `*`.

3405 3498

3406Fußzeilen-Abzeichen werden neben einer [benutzerdefinierten Statuszeile](/docs/de/statusline) gerendert, wenn eine konfiguriert ist; keiner ersetzt den anderen. Verwenden Sie eine Statuszeile für eine skriptgesteuerte Zeile, die ihren eigenen Inhalt aus Sitzungsdaten berechnet, und Fußzeilen-Abzeichen, um IDs aus dem Gespräch in Links umzuwandeln, ohne ein Skript.3499Footer-Badges werden neben einer [benutzerdefinierten Statuszeile](/docs/de/statusline) gerendert, wenn eine konfiguriert ist; keines ersetzt das andere. Verwenden Sie eine Statuszeile für eine skriptgesteuerte Zeile, die ihren Inhalt selbst aus Sitzungsdaten berechnet, und Footer-Badges, um IDs aus der Konversation ohne Skript in Links umzuwandeln.

3407 3500

3408<h3 id="keybindingflavor">3501<h3 id="keybindingflavor">

3409 `keybindingFlavor`3502 `keybindingFlavor`

3410</h3>3503</h3>

3411 3504

3412<Warning>3505<Warning>

3413 Veraltet seit v2.1.261 und hat keine Auswirkung. Die Wort-Bearbeitungstasten der Eingabeaufforderung folgen immer [Readline-Konventionen](/docs/de/interactive-mode#make-ctrl-w-delete-back-to-whitespace), wie in Bash. Claude Code akzeptiert immer noch `keybindingFlavor`, daher bleibt eine Einstellungsdatei, die es setzt, gültig.3506 Seit v2.1.261 veraltet und ohne Wirkung. Die Tasten zur Wortbearbeitung im Prompt [folgen immer den readline-Konventionen](/docs/de/interactive-mode#make-ctrl-w-delete-back-to-whitespace), wie in Bash. Claude Code akzeptiert `keybindingFlavor` weiterhin, sodass eine Einstellungsdatei, die den Schlüssel setzt, gültig bleibt.

3414</Warning>3507</Warning>

3415 3508

3416In v2.1.238 bis v2.1.260 machte das Setzen auf `"readline"` `Ctrl+W` zum Löschen zurück zum vorherigen Leerzeichen anstatt nur zum vorherigen Wort.3509In v2.1.238 bis v2.1.260 bewirkte der Wert `"readline"`, dass `Ctrl+W` bis zum vorherigen Leerraum löschte statt nur das vorherige Wort.

3417 3510

3418* **Bereich**: [`Beliebige Datei`](#scopes)3511* **Geltungsbereich**: [`Any file`](#scopes)

3419* **Typ**: String, `"classic"` oder `"readline"`3512* **Typ**: String, `"classic"` oder `"readline"`

3420* **Standard**: nicht gesetzt3513* **Standard**: nicht gesetzt

3421 3514

3423 `maxProseWidth`3516 `maxProseWidth`

3424</h3>3517</h3>

3425 3518

3426Begrenzen Sie die Breite der Prosa in Claudes Antworten, damit Zeilen in einem breiten Terminal lesbar bleiben. Absätze, Überschriften, Listen und Blockzitate werden in dieser Anzahl von Spalten umgebrochen, während Tabellen und Code-Blöcke die volle Terminal-Breite behalten. Erfordert Claude Code v2.1.282 oder später.3519Die Breite des Fließtexts in Claudes Antworten begrenzen, damit Zeilen in einem breiten Terminal lesbar bleiben. Absätze, Überschriften, Listen und Blockzitate werden innerhalb dieser Anzahl von Spalten umbrochen, während Tabellen und Codeblöcke die volle Terminalbreite behalten. Erfordert Claude Code v2.1.282 oder höher.

3427 3520

3428* **Bereich**: [`Beliebige Datei`](#scopes)3521* **Geltungsbereich**: [`Any file`](#scopes)

3429* **Typ**: Anzahl der Terminal-Spalten, eine ganze Zahl, Minimum `40`. Claude Code ignoriert jeden anderen Wert3522* **Typ**: Anzahl der Terminalspalten, eine ganze Zahl, mindestens `40`. Claude Code ignoriert jeden anderen Wert

3430* **Standard**: nicht gesetzt, daher wird Prosa am Terminal-Rand umgebrochen3523* **Standard**: nicht gesetzt, daher wird Fließtext am Rand des Terminals umbrochen

3431 3524

3432```json settings.json theme={null}3525```json settings.json theme={null}

3433{3526{

3439 `prefersReducedMotion`3532 `prefersReducedMotion`

3440</h3>3533</h3>

3441 3534

3442Reduzieren oder schalten Sie Schnittstellen-Animationen wie den Spinner, Shimmer und Flash-Effekte aus. Erscheint in `/config` als **Bewegung reduzieren**.3535Animationen der Oberfläche wie den Spinner sowie Schimmer- und Blitzeffekte reduzieren oder ausschalten. Erscheint in `/config` als **Reduce motion**.

3443 3536

3444* **Bereich**: [`Beliebige Datei`](#scopes)3537* **Geltungsbereich**: [`Any file`](#scopes)

3445* **Typ**: Boolean3538* **Typ**: Boolean

3446 * `true`: Claude Code reduziert oder schaltet Schnittstellen-Animationen wie den Spinner, Shimmer und Flash-Effekte aus3539 * `true`: Claude Code reduziert Animationen der Oberfläche wie den Spinner sowie Schimmer- und Blitzeffekte oder schaltet sie aus

3447 * `false`: das gleiche wie nicht gesetzt; Claude Code zeigt seine Animationen3540 * `false`: wie nicht gesetzt; Claude Code zeigt seine Animationen

3448* **Standard**: `false`3541* **Standard**: `false`

3449 3542

3450```json settings.json theme={null}3543```json settings.json theme={null}

3457 `promptSuggestionEnabled`3550 `promptSuggestionEnabled`

3458</h3>3551</h3>

3459 3552

3460Zeigen Sie [Eingabeaufforderungs-Vorschläge](/docs/de/interactive-mode#prompt-suggestions) an oder verbergen Sie sie, die ausgegraut Vorhersagen, die in Ihrer Eingabeaufforderung erscheinen. Setzen Sie es auf `false` oder schalten Sie **Eingabeaufforderungs-Vorschläge** in `/config` aus, um sie zu verbergen.3553[Prompt-Vorschläge](/docs/de/interactive-mode#prompt-suggestions) anzeigen oder ausblenden, also die ausgegrauten Vorhersagen, die in Ihrer Prompt-Eingabe erscheinen. Setzen Sie den Schlüssel auf `false` oder schalten Sie **Prompt suggestions** in `/config` aus, um sie auszublenden.

3461 3554

3462* **Bereich**: [`Beliebige Datei`](#scopes)3555* **Geltungsbereich**: [`Any file`](#scopes)

3463* **Typ**: Boolean3556* **Typ**: Boolean

3464 * `true`: Sie sehen Eingabeaufforderungs-Vorschläge in Ihrer Eingabeaufforderung3557 * `true`: Sie sehen Prompt-Vorschläge in Ihrer Prompt-Eingabe

3465 * `false`: Claude Code verbirgt Eingabeaufforderungs-Vorschläge3558 * `false`: Claude Code blendet Prompt-Vorschläge aus

3466* **Standard**: `true`3559* **Standard**: `true`

3467* **Sitzungsübergreifende Außerkraftsetzungen**: [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/de/env-vars) hat Vorrang vor diesem Schlüssel für eine Sitzung3560* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/de/env-vars) hat für eine Sitzung Vorrang vor diesem Schlüssel

3468 3561

3469```json settings.json theme={null}3562```json settings.json theme={null}

3470{3563{

3472}3565}

3473```3566```

3474 3567

3475Eingabeaufforderungs-Vorschläge benötigen ein claude.ai- oder Console-Konto mit aktivierter Telemetrie. In Amazon Bedrock, Google Cloud Agent Platform und Microsoft Foundry oder mit ausgeschalteter Telemetrie, wie durch [`DISABLE_TELEMETRY`](/docs/de/env-vars), hat dieser Schlüssel keine Auswirkung und nur `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1` schaltet sie ein.3568Prompt-Vorschläge erfordern ein claude.ai- oder Console-Konto mit eingeschalteter Telemetrie. Bei Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry oder bei ausgeschalteter Telemetrie, etwa durch [`DISABLE_TELEMETRY`](/docs/de/env-vars), hat dieser Schlüssel keine Wirkung, und nur `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1` schaltet sie ein.

3476 3569

3477<h3 id="respectgitignore">3570<h3 id="respectgitignore">

3478 `respectGitignore`3571 `respectGitignore`

3479</h3>3572</h3>

3480 3573

3481Kontrollieren Sie, ob der `@`-Datei-Picker Dateien auslässt, die `.gitignore`-Muster entsprechen. Erscheint in `/config` als **Respektiere .gitignore im Datei-Picker**.3574Steuern, ob die `@`-Dateiauswahl Dateien auslässt, die auf `.gitignore`-Muster passen. Erscheint in `/config` als **Respect .gitignore in file picker**.

3482 3575

3483* **Bereich**: [`Beliebige Datei`](#scopes). Wenn keine Einstellungsdatei es setzt, fällt Claude Code auf `respectGitignore` in `~/.claude.json` zurück, das der `/config`-Toggle schreibt.3576* **Geltungsbereich**: [`Any file`](#scopes). Wenn keine Einstellungsdatei den Schlüssel setzt, greift Claude Code auf `respectGitignore` in `~/.claude.json` zurück, das vom Schalter in `/config` geschrieben wird.

3484* **Typ**: Boolean3577* **Typ**: Boolean

3485 * `true`: Der `@`-Datei-Picker lässt Dateien aus, die `.gitignore`-Muster entsprechen3578 * `true`: Die `@`-Dateiauswahl lässt Dateien aus, die auf `.gitignore`-Muster passen

3486 * `false`: Der `@`-Datei-Picker enthält Dateien, die `.gitignore`-Muster entsprechen3579 * `false`: Die `@`-Dateiauswahl schließt Dateien ein, die auf `.gitignore`-Muster passen

3487* **Standard**: `true`3580* **Standard**: `true`

3488 3581

3489```json settings.json theme={null}3582```json settings.json theme={null}

3496 `respondToBashCommands`3589 `respondToBashCommands`

3497</h3>3590</h3>

3498 3591

3499Wählen Sie, ob Claude antwortet, nachdem Sie einen Shell-Befehl mit dem Präfix [`!`](/docs/de/interactive-mode#shell-mode-with-prefix) im Eingabefeld ausführen. Standardmäßig fügt Claude Code die Ausgabe des Befehls zum Gespräch hinzu und Claude antwortet darauf. Setzen Sie diesen Schlüssel auf `false`, um die Ausgabe zum Kontext hinzuzufügen, ohne eine Antwort zu geben, damit Sie mehrere Befehle ausführen und zusammen darüber sprechen können.3592Legen Sie fest, ob Claude antwortet, nachdem Sie einen Shell-Befehl mit dem [`!`-Präfix](/docs/de/interactive-mode#shell-mode-with-prefix) im Eingabefeld ausgeführt haben. Standardmäßig fügt Claude Code die Ausgabe des Befehls der Konversation hinzu, und Claude antwortet darauf. Setzen Sie diesen Schlüssel auf `false`, um die Ausgabe ohne Antwort dem Kontext hinzuzufügen, sodass Sie mehrere Befehle ausführen und gemeinsam danach fragen können.

3500 3593

3501* **Bereich**: [`Beliebige Datei`](#scopes)3594* **Geltungsbereich**: [`Any file`](#scopes)

3502* **Typ**: Boolean3595* **Typ**: Boolean

3503 * `true`: Claude Code fügt die Ausgabe des Befehls zum Gespräch hinzu und Claude antwortet darauf3596 * `true`: Claude Code fügt die Ausgabe des Befehls der Konversation hinzu, und Claude antwortet darauf

3504 * `false`: Claude Code fügt die Ausgabe zum Kontext hinzu, ohne eine Antwort zu geben3597 * `false`: Claude Code fügt die Ausgabe ohne Antwort dem Kontext hinzu

3505* **Standard**: `true`3598* **Standard**: `true`

3506 3599

3507```json settings.json theme={null}3600```json settings.json theme={null}

3516 `showClearContextOnPlanAccept`3609 `showClearContextOnPlanAccept`

3517</h3>3610</h3>

3518 3611

3519Wenn Claude einen Plan im [Plan-Modus](/docs/de/permission-modes#review-and-approve-a-plan) abschließt, zeigt es ein Genehmigungsmenü. Die Planung kann viel Kontext verwenden, daher fügt dieser Schlüssel eine erste Option zu diesem Menü hinzu, **Ja, Kontext löschen und …**, die den Plan genehmigt, den Gesprächskontext löscht und die Implementierung nur aus dem Plan startet. Der Rest des Labels benennt den Berechtigungsmodus, in dem die Sitzung fortgesetzt wird, und zeigt, wie viel Ihres Kontexts die Planung verwendet hat.3612Wenn Claude im [Plan-Modus](/docs/de/permission-modes#review-and-approve-a-plan) einen Plan fertigstellt, zeigt es ein Genehmigungsmenü an. Das Planen kann viel Kontext verbrauchen, daher fügt dieser Schlüssel dem Menü eine erste Option hinzu, **Yes, clear context and …**, die den Plan genehmigt, den Konversationskontext leert und die Implementierung allein auf Grundlage des Plans beginnt. Der Rest der Beschriftung nennt den Berechtigungsmodus, in dem die Sitzung fortgesetzt wird, und zeigt, wie viel Ihres Kontexts das Planen verbraucht hat.

3520 3613

3521* **Bereich**: [`Beliebige Datei`](#scopes)3614* **Geltungsbereich**: [`Any file`](#scopes)

3522* **Typ**: Boolean3615* **Typ**: Boolean

3523 * `true`: Das Plan-Genehmigungsmenü erhält eine erste Option, **Ja, Kontext löschen und …**, die den Plan genehmigt und den Gesprächskontext löscht3616 * `true`: Das Menü zur Plan-Genehmigung erhält eine erste Option, **Yes, clear context and …**, die den Plan genehmigt und den Konversationskontext leert

3524 * `false`: Das Plan-Genehmigungsmenü zeigt keine Clear-Context-Option3617 * `false`: Das Menü zur Plan-Genehmigung zeigt keine Option zum Leeren des Kontexts

3525* **Standard**: `false`3618* **Standard**: `false`

3526 3619

3527```json settings.json theme={null}3620```json settings.json theme={null}

3534 `showTurnDuration`3627 `showTurnDuration`

3535</h3>3628</h3>

3536 3629

3537Zeigen Sie die Nachricht zur Rundendauer nach jeder Antwort an oder verbergen Sie sie, wie z. B. „Cooked for 1m 6s · done 6:05 PM". Die Uhr nach „done" zeigt, wann die Runde fertig war; [`timeFormat`](#timeformat) und [`timeZone`](#timezone) kontrollieren ihr Format und ihre Zone. Erscheint in `/config` als **Rundendauer anzeigen**.3630Die Meldung zur Turn-Dauer nach jeder Antwort anzeigen oder ausblenden, etwa „Cooked for 1m 6s · done 6:05 PM“. Die Uhrzeit nach „done“ zeigt, wann der Turn beendet wurde; [`timeFormat`](#timeformat) und [`timeZone`](#timezone) steuern ihr Format und ihre Zeitzone. Erscheint in `/config` als **Show turn duration**.

3538 3631

3539* **Bereich**: [`Beliebige Datei`](#scopes). Ein Wert in `~/.claude.json` aus einer älteren Version gilt, wenn keine Einstellungsdatei es setzt.3632* **Geltungsbereich**: [`Any file`](#scopes). Ein Wert in `~/.claude.json` aus einer älteren Version gilt, wenn keine Einstellungsdatei den Schlüssel setzt.

3540* **Typ**: Boolean3633* **Typ**: Boolean

3541 * `true`: Sie sehen die Nachricht zur Rundendauer nach jeder Antwort3634 * `true`: Sie sehen nach jeder Antwort die Meldung zur Turn-Dauer

3542 * `false`: Claude Code verbirgt die Nachricht zur Rundendauer3635 * `false`: Claude Code blendet die Meldung zur Turn-Dauer aus

3543* **Standard**: `true`3636* **Standard**: `true`

3544 3637

3545```json settings.json theme={null}3638```json settings.json theme={null}

3552 `spellcheck`3645 `spellcheck`

3553</h3>3646</h3>

3554 3647

3555Unterstreichen Sie falsch geschriebene Wörter in der Eingabeaufforderung, während Sie eingeben, mit einem Rechtschreibprüfer, den Sie installieren. Claude Code prüft nur den Text im Eingabefeld. [Rechtschreibung während der Eingabe prüfen](/docs/de/interactive-mode#check-spelling-as-you-type) behandelt die Installation von aspell, hunspell oder ispell und was der Checker abdeckt. Erfordert Claude Code v2.1.235 oder später.3648Falsch geschriebene Wörter in der Prompt-Eingabe während der Eingabe unterstreichen, mithilfe einer von Ihnen installierten Rechtschreibprüfung. Claude Code prüft nur den Text im Eingabefeld. [Rechtschreibung während der Eingabe prüfen](/docs/de/interactive-mode#check-spelling-as-you-type) behandelt die Installation von aspell, hunspell oder ispell und was die Prüfung abdeckt. Erfordert Claude Code v2.1.235 oder höher.

3556 3649

3557* **Bereich**: [`Benutzer oder verwaltet`](#scopes). Der Block aus der höchsten Ebene, die ihn setzt, gilt als Ganzes.3650* **Geltungsbereich**: [`User or managed`](#scopes). Der Block aus der höchsten Ebene, die den Schlüssel setzt, gilt als Ganzes.

3558* **Typ**: Objekt mit `enabled` (Boolean), `checker` (`"aspell"`, `"hunspell"`, `"ispell"` oder `"auto"`), `language` (String, an den Checker als sein Wörterbuchname übergeben) und `color` (String, ein Terminal-Farbname, `#rrggbb`, `rgb(r,g,b)`, `ansi256(n)` oder `ansi:<name>`)3651* **Typ**: Objekt mit `enabled` (Boolean), `checker` (`"aspell"`, `"hunspell"`, `"ispell"` oder `"auto"`), `language` (String, wird an die Prüfung als Name ihres Wörterbuchs übergeben) und `color` (String, ein Terminal-Farbname, `#rrggbb`, `rgb(r,g,b)`, `ansi256(n)` oder `ansi:<name>`)

3559* **Standard**: nicht gesetzt, daher ist die Rechtschreibprüfung aus; `checker` standardmäßig auf `"auto"`, das erste der drei auf `PATH` gefundenen; `language` standardmäßig auf das eigene Wörterbuch des Checkers; `color` standardmäßig auf die Fehlerfarbe des Designs3652* **Standard**: nicht gesetzt, daher ist die Rechtschreibprüfung aus; `checker` ist standardmäßig `"auto"`, also die erste der drei Prüfungen, die auf dem `PATH` gefunden wird; `language` ist standardmäßig das eigene Wörterbuch der Prüfung; `color` ist standardmäßig die Fehlerfarbe des Themes

3560 3653

3561```json settings.json theme={null}3654```json settings.json theme={null}

3562{3655{

3568 `spinnerTipsEnabled`3661 `spinnerTipsEnabled`

3569</h3>3662</h3>

3570 3663

3571Während Claude arbeitet, rotiert die Spinner-Zeile durch kurze Tipps zu Claude Code-Funktionen, wie z. B. „Use Plan Mode to prepare for a complex request before making changes. Press Shift+Tab twice to enable." Setzen Sie diesen Schlüssel auf `false`, um sie zu verbergen. Erscheint in `/config` als **Tipps anzeigen**.3664Während Claude arbeitet, zeigt die Spinner-Zeile abwechselnd kurze Tipps zu Funktionen von Claude Code an, etwa „Use Plan Mode to prepare for a complex request before making changes. Press Shift+Tab twice to enable.“ Setzen Sie diesen Schlüssel auf `false`, um sie auszublenden. Erscheint in `/config` als **Show tips**.

3572 3665

3573* **Bereich**: [`Beliebige Datei`](#scopes)3666* **Geltungsbereich**: [`Any file`](#scopes)

3574* **Typ**: Boolean3667* **Typ**: Boolean

3575 * `true`: Sie sehen Tipps im Spinner, während Claude arbeitet3668 * `true`: Sie sehen Tipps im Spinner, während Claude arbeitet

3576 * `false`: Claude Code verbirgt Spinner-Tipps3669 * `false`: Claude Code blendet Spinner-Tipps aus

3577* **Standard**: `true`3670* **Standard**: `true`

3578 3671

3579```json settings.json theme={null}3672```json settings.json theme={null}

3586 `spinnerTipsOverride`3679 `spinnerTipsOverride`

3587</h3>3680</h3>

3588 3681

3589Fügen Sie Ihre eigenen Tipps zu den [Spinner-Tipps](#spinnertipsenabled) hinzu, die Claude Code zeigt, während Claude arbeitet, oder ersetzen Sie die integrierten Tipps durch Ihre. Claude Code setzt Ihre Tipps in die gleiche Rotation wie die integrierten: Es wählt den Tipp, der am längsten nicht angezeigt wurde, überspringt Tipps, die sich noch in ihrer Abklingzeit befinden, und bricht Unentschieden nach Priorität auf.3682Eigene Tipps zu den [Spinner-Tipps](#spinnertipsenabled) hinzufügen, die Claude Code anzeigt, während Claude arbeitet, oder die integrierten Tipps durch Ihre ersetzen. Claude Code nimmt Ihre Tipps in dieselbe Rotation auf wie die integrierten.

3590 3683

3591Wenn Sie [`spinnerTipsEnabled`](#spinnertipsenabled) auf `false` setzen, verbirgt Claude Code alle Tipps, einschließlich Ihrer.3684Wenn Sie [`spinnerTipsEnabled`](#spinnertipsenabled) auf `false` setzen, blendet Claude Code alle Tipps aus, auch Ihre.

3592 3685

3593* **Bereich**: [`Beliebige Datei`](#scopes). Claude Code berücksichtigt Tipp-Objekte, `tipsFile`, `label` und `excludeDefault` aus Benutzereinstellungen, dem Flag `--settings` und verwalteten Einstellungen; aus Projekt- und lokalen Einstellungen liest es nur einfache String-Tipps.3686* **Geltungsbereich**: [`Any file`](#scopes). Claude Code berücksichtigt Tipp-Objekte, `tipsFile`, `label` und `excludeDefault` aus den Benutzereinstellungen, dem Flag `--settings` und verwalteten Einstellungen; aus Projekt- und lokalen Einstellungen liest es nur einfache String-Tipps.

3594* **Typ**: Objekt mit `tips`, `tipsFile`, `label` und `excludeDefault`-Feldern, jeweils optional3687* **Typ**: Objekt mit den Feldern `tips`, `tipsFile`, `label` und `excludeDefault`, jeweils optional

3595* **Standard**: nicht gesetzt, daher zeigt Claude Code nur die integrierten Tipps3688* **Standard**: nicht gesetzt, daher zeigt Claude Code nur die integrierten Tipps

3596 3689

3597Tipp-Objekte, `tipsFile`, `label` und die Regel in der Bereich-Zeile, dass Projekt- und lokale Einstellungen nur einfache Strings beitragen, erfordern Claude Code v2.1.247 oder später. In früheren Versionen gilt auch `excludeDefault` einer Projekt- oder lokalen Datei.3690Tipp-Objekte, `tipsFile`, `label` und die Regel aus der Zeile zum Geltungsbereich, dass Projekt- und lokale Einstellungen nur einfache Strings beitragen, erfordern Claude Code v2.1.247 oder höher.

3598 3691

3599Jeder `tips`-Eintrag ist ein einfacher String oder ein Objekt mit diesen Feldern:3692Jeder `tips`-Eintrag ist ein einfacher String oder ein Objekt mit diesen Feldern:

3600 3693

3602| :- | :- | :- |3695| :- | :- | :- |

3603| `id` | Ja | Bis zu 64 Buchstaben, Ziffern, `.`, `_` oder `-`. Claude Code schlüsselt die Show-Historie des Tipps darauf auf, daher überlebt die Abklingzeit des Tipps eine Neuordnung der Liste. Von zwei Einträgen mit der gleichen ID verwendet Claude Code den ersten |3696| `id` | Ja | Bis zu 64 Buchstaben, Ziffern, `.`, `_` oder `-`. Claude Code verknüpft den Anzeigeverlauf des Tipps mit diesem Wert, sodass die Wartezeit des Tipps ein Umsortieren der Liste übersteht. Von zwei Einträgen mit derselben ID verwendet Claude Code den ersten |

3604| `text` | Ja | Der Tipp, eine Zeile mit bis zu 500 Zeichen. Claude Code entfernt ANSI-Escapes und Steuerzeichen und reduziert Leerzeichen |3697| `text` | Ja | Der Tipp, eine Zeile mit bis zu 500 Zeichen. Claude Code entfernt ANSI-Escape-Sequenzen und Steuerzeichen und fasst Leerraum zusammen |

3607 3700

3608Claude Code liest einen einfachen String als Tipp mit diesen Standards und einer positionsbasierten ID, daher setzt sich seine Show-Historie zurück, wenn Sie die Liste neu ordnen. Geben Sie einem Tipp eine `id`, um seine Historie über Bearbeitungen hinweg zu behalten.3701Claude Code liest einen einfachen String als Tipp mit diesen Standardwerten und einer positionsbasierten ID, sodass sein Anzeigeverlauf zurückgesetzt wird, wenn Sie die Liste umsortieren. Geben Sie einem Tipp eine `id`, um seinen Verlauf über Bearbeitungen hinweg zu behalten.

3609 3702

3610Claude Code liest höchstens 200 Tipps über `tips` und `tipsFile` und verwirft einen ungültigen Eintrag mit einer Debug-Warnung, anstatt die Einstellungsdatei abzulehnen.3703Claude Code liest höchstens 200 Tipps aus `tips` und `tipsFile` zusammen und verwirft einen ungültigen Eintrag mit einer Debug-Warnung, statt die Einstellungsdatei abzulehnen.

3611 3704

3612Verwenden Sie die verbleibenden Felder, um eine Tipps-Datei zu benennen, das Präfix zu setzen und die integrierten Tipps zu verbergen:3705Verwenden Sie die übrigen Felder, um eine Tipp-Datei anzugeben, das Präfix festzulegen und die integrierten Tipps auszublenden:

3613 3706

3614* `tipsFile`: ein absoluter oder `~/`-Pfad zu einer lokalen JSON-Datei mit einem Array der gleichen Einträge oder ein Objekt mit einem `tips`-Array, bis zu 256 KB. Claude Code liest die Datei einmal pro Prozess, daher lädt es Ihre Bearbeitungen beim nächsten Start. Sie können es nicht durch [server-verwaltete Einstellungen](/docs/de/server-managed-settings) setzen; stellen Sie inline `tips` dort bereit oder stellen Sie den Pfad in einer auf der Festplatte gespeicherten `managed-settings.json` bereit.3707* `tipsFile`: ein absoluter oder mit `~/` beginnender Pfad zu einer lokalen JSON-Datei, die ein Array derselben Einträge oder ein Objekt mit einem `tips`-Array enthält, bis zu 256 KB. Claude Code liest die Datei einmal pro Prozess, daher lädt es Ihre Änderungen beim nächsten Start. Sie können sie nicht über [serververwaltete Einstellungen](/docs/de/server-managed-settings) festlegen; stellen Sie dort Inline-`tips` bereit, oder stellen Sie den Pfad in einer `managed-settings.json` auf dem Datenträger bereit.

3615* `label`: das Präfix, das Claude Code vor Tipps aus Benutzer-, `--settings`- und verwalteten Einstellungen anzeigt, bis zu 40 Zeichen. Der Standard ist `Tip`, das gleiche Präfix wie die integrierten Tipps, und Tipps aus Projekt- und lokalen Einstellungen verwenden es immer.3708* `label`: das Präfix, das Claude Code vor Tipps aus Benutzereinstellungen, `--settings` und verwalteten Einstellungen anzeigt, bis zu 40 Zeichen. Der Standard ist `Tip`, dasselbe Präfix wie bei den integrierten Tipps, und Tipps aus Projekt- und lokalen Einstellungen verwenden es immer.

3616* `excludeDefault`: setzen Sie es auf `true`, um die integrierten Tipps zu verbergen und nur Ihre anzuzeigen. Wenn Claude Code keine Ihrer Tipps laden kann, z. B. weil `tipsFile` nicht existiert oder jeder Eintrag ungültig ist, behält es die integrierte Rotation anstelle einer leeren Spinner bei.3709* `excludeDefault`: Setzen Sie es auf `true`, um die integrierten Tipps auszublenden und nur Ihre anzuzeigen. Wenn Claude Code keinen Ihrer Tipps laden kann, zum Beispiel weil `tipsFile` nicht existiert oder jeder Eintrag ungültig ist, behält es die integrierte Rotation bei, statt einen leeren Spinner anzuzeigen.

3617 3710

3618Wenn mehr als eine Einstellungsdatei den Schlüssel setzt, zeigt Claude Code Tipps aus allen und nimmt `tipsFile`, `label` und `excludeDefault` von welcher der verwalteten Einstellungen, dem Flag `--settings` und den Benutzereinstellungen die höchste Priorität hat, die jeweils setzt.3711Wenn mehr als eine Einstellungsdatei den Schlüssel setzt, zeigt Claude Code Tipps aus allen an und übernimmt `tipsFile`, `label` und `excludeDefault` jeweils aus derjenigen der verwalteten Einstellungen, des Flags `--settings` und der Benutzereinstellungen, die den höchsten Vorrang hat und das jeweilige Feld setzt.

3619 3712

3620Dieses Beispiel in Ihren Benutzereinstellungen fügt einen einfachen String-Tipp und einen Objekt-Tipp zur Rotation unter dem Präfix `Acme tip` hinzu:3713Dieses Beispiel in Ihren Benutzereinstellungen fügt der Rotation einen einfachen String-Tipp und einen Objekt-Tipp unter dem Präfix `Acme tip` hinzu:

3621 3714

3622```json settings.json theme={null}3715```json settings.json theme={null}

3623{3716{

3636}3729}

3637```3730```

3638 3731

3639Jedes Feld im Beispiel ändert eine Sache daran, wie Claude Code die Tipps anzeigt:3732Jedes Feld im Beispiel ändert einen Aspekt daran, wie Claude Code die Tipps anzeigt:

3640 3733

3641* `label`: Claude Code zeigt beide Tipps als `Acme tip: ...` anstelle von `Tip: ...`.3734* `label`: Claude Code zeigt beide Tipps als `Acme tip: ...` statt `Tip: ...` an.

3642* Der einfache String: Claude Code gibt ihm die Standards, daher kann er in der nächsten Sitzung erneut auftauchen.3735* Der einfache String: Claude Code gibt ihm die Standardwerte, daher kann er gleich in der nächsten Sitzung wieder erscheinen.

3643* `id`: Claude Code schlüsselt die Show-Historie des zweiten Tipps auf `gateway-errors` auf, daher gilt seine Abklingzeit immer noch nach dem Hinzufügen oder Neuordnen von Tipps.3736* `id`: Claude Code verknüpft den Anzeigeverlauf des zweiten Tipps mit `gateway-errors`, sodass seine Wartezeit weiterhin gilt, nachdem Sie Tipps hinzufügen oder umsortieren.

3644* `cooldownSessions`: Nachdem Claude Code den `gateway-errors`-Tipp angezeigt hat, zeigt es diesen Tipp nicht erneut an, bis fünf Sitzungen später.3737* `cooldownSessions`: Nachdem Claude Code den Tipp `gateway-errors` angezeigt hat, zeigt es ihn erst fünf Sitzungen später wieder an.

3645* `priority`: Wenn der `gateway-errors`-Tipp und ein anderer Tipp gleich lange nicht angezeigt wurden, z. B. wenn keiner noch angezeigt wurde, zeigt Claude Code `gateway-errors` zuerst. Der einfache String hat die Standard-Priorität, `0`.3738* `priority`: Wenn der Tipp `gateway-errors` und ein anderer Tipp gleich viele Sitzungen lang nicht angezeigt wurden, zum Beispiel wenn noch keiner von beiden angezeigt wurde, zeigt Claude Code `gateway-errors` zuerst an. Der einfache String hat die Standardpriorität `0`.

3646 3739

3647Während Claude arbeitet, zeigt Claude Code Ihre Tipps im Spinner mit Ihrem Präfix an, wie z. B. `Acme tip: Run /review before opening a PR`.3740Während Claude arbeitet, zeigt Claude Code Ihre Tipps im Spinner mit Ihrem Präfix an, etwa `Acme tip: Run /review before opening a PR`.

3648 3741

3649<h3 id="spinnerverbs">3742<h3 id="spinnerverbs">

3650 `spinnerVerbs`3743 `spinnerVerbs`

3651</h3>3744</h3>

3652 3745

3653Während eine Runde läuft, zeigt der Spinner ein rotierendes Verb wie „Accomplishing", „Architecting" oder „Baking". Verwenden Sie diesen Schlüssel, um Ihre eigenen Verben zu dieser Rotation hinzuzufügen oder die integrierte Liste durch Ihre zu ersetzen.3746Während ein Turn läuft, zeigt der Spinner ein wechselndes Verb wie „Accomplishing“, „Architecting“ oder „Baking“. Verwenden Sie diesen Schlüssel, um dieser Rotation eigene Verben hinzuzufügen oder die integrierte Liste durch Ihre zu ersetzen.

3654 3747

3655* **Bereich**: [`Beliebige Datei`](#scopes)3748* **Geltungsbereich**: [`Any file`](#scopes)

3656* **Typ**: Objekt mit einem `verbs`-Array von Strings und `mode`, einer von:3749* **Typ**: Objekt mit einem Array `verbs` aus Strings und `mode`, einer von:

3657 * `"append"`: Claude Code fügt Ihre Verben zum integrierten Satz hinzu3750 * `"append"`: Claude Code fügt Ihre Verben zum integrierten Satz hinzu

3658 * `"replace"`: Claude Code zeigt nur Ihre Verben3751 * `"replace"`: Claude Code zeigt nur Ihre Verben

3659* **Standard**: nicht gesetzt, daher verwendet Claude Code die integrierten Verben3752* **Standard**: nicht gesetzt, daher verwendet Claude Code die integrierten Verben

3660 3753

3661Dieses Beispiel fügt zwei Verben zum integrierten Satz hinzu:3754Dieses Beispiel fügt dem integrierten Satz zwei Verben hinzu:

3662 3755

3663```json settings.json theme={null}3756```json settings.json theme={null}

3664{3757{

3669}3762}

3670```3763```

3671 3764

3672Im `"replace"`-Modus mit einem leeren `verbs`-Array behält Claude Code die integrierten Verben.3765Im Modus `"replace"` mit einem leeren Array `verbs` behält Claude Code die integrierten Verben bei.

3673 3766

3674<h3 id="statusline">3767<h3 id="statusline">

3675 `statusLine`3768 `statusLine`

3676</h3>3769</h3>

3677 3770

3678Führen Sie Ihren eigenen Befehl aus, um eine [Statuszeile](/docs/de/statusline) unter der Eingabeaufforderung mit Kontext wie dem Modell, den Kosten oder dem Git-Branch zu rendern. Optionale Felder passen den Abstand an, fügen periodische Neuausführungen hinzu und verbergen den integrierten Vim-Modus-Indikator, wenn Ihr Skript `vim.mode` selbst rendert.3771Einen eigenen Befehl ausführen, um unterhalb des Prompts eine [Statuszeile](/docs/de/statusline) mit Kontext wie dem Modell, den Kosten oder dem Git-Branch zu rendern. Optionale Felder passen den Abstand an, fügen periodische erneute Ausführungen hinzu und blenden die integrierte vim-Modusanzeige aus, wenn Ihr Skript `vim.mode` selbst rendert.

3679 3772

3680* **Bereich**: [`Beliebige Datei`](#scopes). Wenn [`allowManagedHooksOnly`](#allowmanagedhooksonly) aktiviert ist oder [`disableAllHooks`](#disableallhooks) außerhalb verwalteter Einstellungen gesetzt ist, wird nur der verwaltete Einstellungswert ausgeführt.3773* **Geltungsbereich**: [`Any file`](#scopes). Wenn [`allowManagedHooksOnly`](#allowmanagedhooksonly) eingeschaltet ist oder [`disableAllHooks`](#disableallhooks) außerhalb verwalteter Einstellungen gesetzt ist, wird nur der Wert aus den verwalteten Einstellungen ausgeführt.

3681* **Typ**: Objekt mit `type` auf `"command"` gesetzt und einem `command`-String, plus optionales `padding` als Anzahl von Zeichen, `refreshInterval` als Anzahl von Sekunden, Minimum `1`, und `hideVimModeIndicator` als Boolean3774* **Typ**: Objekt mit `type` auf `"command"` gesetzt und einem String `command`, dazu optional `padding` als Anzahl von Zeichen, `refreshInterval` als Anzahl von Sekunden, mindestens `1`, und `hideVimModeIndicator` als Boolean

3682* **Standard**: nicht gesetzt, daher keine Statuszeile3775* **Standard**: nicht gesetzt, daher keine Statuszeile

3683 3776

3684Dieses Beispiel druckt den Modellnamen und die Kontextnutzung und fügt zwei Zeichen horizontalen Abstand hinzu:3777Dieses Beispiel gibt den Modellnamen und die Kontextnutzung aus und fügt zwei Zeichen horizontalen Abstand hinzu:

3685 3778

3686```json settings.json theme={null}3779```json settings.json theme={null}

3687{3780{

3693}3786}

3694```3787```

3695 3788

3696Das Beispiel benötigt [`jq`](https://jqlang.org/) installiert und läuft in einer Shell. Für PowerShell- und Git Bash-Äquivalente siehe [Windows-Konfiguration](/docs/de/statusline#windows-configuration); für die vollständige Einrichtung siehe [Statuszeile manuell konfigurieren](/docs/de/statusline#manually-configure-a-status-line).3789Das Beispiel erfordert ein installiertes [`jq`](https://jqlang.org/) und läuft in einer Shell. Entsprechungen für PowerShell und Git Bash finden Sie unter [Windows-Konfiguration](/docs/de/statusline#windows-configuration); die vollständige Einrichtung finden Sie unter [Eine Statuszeile manuell konfigurieren](/docs/de/statusline#manually-configure-a-status-line).

3697 3790

3698<h3 id="subagentstatusline">3791<h3 id="subagentstatusline">

3699 `subagentStatusLine`3792 `subagentStatusLine`

3700</h3>3793</h3>

3701 3794

3702Wenn Claude [Subagenten](/docs/de/sub-agents) ausführt, listet Claude Code sie in einer Task-Anzeige unter der Eingabeaufforderung auf, eine Zeile pro Subagent mit `name · description · token count`. Dieser Schlüssel lässt Sie Ihren eigenen Befehl ausführen, um diese Zeilen umzuschreiben, z. B. um die Kontextnutzung jedes Subagenten als Prozentsatz anzuzeigen. Bei jeder Aktualisierung sendet Claude Code die sichtbaren Zeilen als ein JSON-Objekt auf stdin mit einem `tasks`-Array, das die `id`, `name`, `status`, `model`, `tokenCount` und mehr jedes Subagenten trägt, und ersetzt die Zeile für jede `id`, die Sie als `{"id", "content"}`-Zeile zurückschreiben. Zeilen, die Sie nicht zurückschreiben, behalten das Standard-Rendering.3795Wenn Claude [Subagenten](/docs/de/sub-agents) ausführt, listet Claude Code sie in einer Aufgabenanzeige unterhalb des Prompts auf, eine Zeile pro Subagent mit `name · description · token count`. Mit diesem Schlüssel können Sie einen eigenen Befehl ausführen, um diese Zeilen umzuschreiben, zum Beispiel um die Kontextnutzung jedes Subagenten als Prozentsatz anzuzeigen. Bei jeder Aktualisierung sendet Claude Code die sichtbaren Zeilen als ein JSON-Objekt auf stdin, mit einem Array `tasks`, das für jeden Subagenten `id`, `name`, `status`, `model`, `tokenCount` und mehr enthält, und ersetzt die Zeile für jede `id`, die Sie als `{"id", "content"}`-Zeile zurückschreiben. Zeilen, die Sie nicht zurückschreiben, behalten die Standarddarstellung.

3703 3796

3704* **Bereich**: [`Beliebige Datei`](#scopes). Wenn [`allowManagedHooksOnly`](#allowmanagedhooksonly) aktiviert ist oder [`disableAllHooks`](#disableallhooks) außerhalb verwalteter Einstellungen gesetzt ist, wird nur der verwaltete Einstellungswert ausgeführt.3797* **Geltungsbereich**: [`Any file`](#scopes). Wenn [`allowManagedHooksOnly`](#allowmanagedhooksonly) eingeschaltet ist oder [`disableAllHooks`](#disableallhooks) außerhalb verwalteter Einstellungen gesetzt ist, wird nur der Wert aus den verwalteten Einstellungen ausgeführt.

3705* **Typ**: Objekt mit `type` auf `"command"` gesetzt und einem `command`-String3798* **Typ**: Objekt mit `type` auf `"command"` gesetzt und einem String `command`

3706* **Standard**: nicht gesetzt, daher rendert Claude Code die Standard-Zeilen3799* **Standard**: nicht gesetzt, daher rendert Claude Code die Standardzeilen

3707 3800

3708```json settings.json theme={null}3801```json settings.json theme={null}

3709{3802{

3714}3807}

3715```3808```

3716 3809

3717Siehe [Subagent-Statuszeilen](/docs/de/statusline#subagent-status-lines).3810Siehe [Statuszeilen für Subagenten](/docs/de/statusline#subagent-status-lines).

3718 3811

3719<h3 id="syntaxhighlightingdisabled">3812<h3 id="syntaxhighlightingdisabled">

3720 `syntaxHighlightingDisabled`3813 `syntaxHighlightingDisabled`

3721</h3>3814</h3>

3722 3815

3723Claude Code färbt Code nach Sprache in den Diffs, Code-Blöcken und Datei-Vorschauen, die es im Terminal anzeigt, mit seinem integrierten Highlighter; kein Plugin oder Language Server ist beteiligt. Setzen Sie diesen Schlüssel auf `true`, um sie stattdessen als einfachen Text anzuzeigen, z. B. wenn die Farben mit Ihrem Terminal-Design kollidieren oder einen Bildschirmleser verlangsamen.3816Claude Code färbt Code in den Diffs, Codeblöcken und Dateivorschauen, die es im Terminal anzeigt, mit seinem integrierten Highlighter sprachabhängig ein; dabei ist weder ein Plugin noch ein Language Server beteiligt. Setzen Sie diesen Schlüssel auf `true`, um sie stattdessen als einfachen Text anzuzeigen, zum Beispiel wenn die Farben nicht zu Ihrem Terminal-Theme passen oder einen Screenreader verlangsamen.

3724 3817

3725* **Bereich**: [`Beliebige Datei`](#scopes)3818* **Geltungsbereich**: [`Any file`](#scopes)

3726* **Typ**: Boolean3819* **Typ**: Boolean

3727 * `true`: Claude Code schaltet die Syntaxhervorhebung in Diffs, Code-Blöcken und Datei-Vorschauen aus3820 * `true`: Claude Code schaltet die Syntaxhervorhebung in Diffs, Codeblöcken und Dateivorschauen aus

3728 * `false`: Claude Code hebt Syntax hervor3821 * `false`: Claude Code hebt die Syntax hervor

3729* **Standard**: `false`3822* **Standard**: `false`

3730 3823

3731```json settings.json theme={null}3824```json settings.json theme={null}

3738 `terminalProgressBarEnabled`3831 `terminalProgressBarEnabled`

3739</h3>3832</h3>

3740 3833

3741Einige Terminals können einen Fortschrittsindikator auf der Registerkarte oder in der Taskleiste für das darin laufende Programm anzeigen. Während Claude arbeitet, meldet Claude Code einen laufenden Status dem Terminal, damit Sie von einer anderen Registerkarte oder einem anderen Fenster aus sehen können, ob die Sitzung noch beschäftigt ist. Der Indikator bleibt sichtbar, nachdem die Runde endet, während [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) oder [dynamische Workflows](/docs/de/workflows) noch laufen, und wird gelöscht, sobald die Sitzung untätig ist.3834Manche Terminals können für das darin laufende Programm eine Fortschrittsanzeige auf dem Tab oder in der Taskleiste anzeigen. Während Claude arbeitet, meldet Claude Code dem Terminal einen laufenden Zustand, sodass Sie von einem anderen Tab oder Fenster aus sehen können, ob die Sitzung noch beschäftigt ist. Die Anzeige bleibt nach dem Ende des Turns sichtbar, solange [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) oder [dynamische Workflows](/docs/de/workflows) noch laufen, und verschwindet, sobald die Sitzung im Leerlauf ist.

3742 3835

3743Claude Code meldet es nur in Terminals, die den Indikator unterstützen: ConEmu, Ghostty 1.2.0 oder später und iTerm2 3.6.6 oder später. Setzen Sie diesen Schlüssel auf `false`, um Claude Code davon abzuhalten, es zu melden. Erscheint in `/config` als **Terminal-Fortschrittsbalken**.3836Claude Code meldet sie nur in Terminals, die die Anzeige unterstützen: ConEmu, Ghostty 1.2.0 oder höher und iTerm2 3.6.6 oder höher. Setzen Sie diesen Schlüssel auf `false`, damit Claude Code sie nicht mehr meldet. Erscheint in `/config` als **Terminal progress bar**.

3744 3837

3745* **Bereich**: [`Beliebige Datei`](#scopes). Ein Wert in `~/.claude.json` aus einer älteren Version gilt, wenn keine Einstellungsdatei es setzt.3838* **Geltungsbereich**: [`Any file`](#scopes). Ein Wert in `~/.claude.json` aus einer älteren Version gilt, wenn keine Einstellungsdatei den Schlüssel setzt.

3746* **Typ**: Boolean3839* **Typ**: Boolean

3747 * `true`: Sie sehen den Terminal-Fortschrittsbalken in Terminals, die ihn unterstützen3840 * `true`: Sie sehen die Terminal-Fortschrittsanzeige in Terminals, die sie unterstützen

3748 * `false`: Claude Code verbirgt den Terminal-Fortschrittsbalken3841 * `false`: Claude Code blendet die Terminal-Fortschrittsanzeige aus

3749* **Standard**: `true`3842* **Standard**: `true`

3750 3843

3751```json settings.json theme={null}3844```json settings.json theme={null}

3758 `terminalTitleFromRename`3851 `terminalTitleFromRename`

3759</h3>3852</h3>

3760 3853

3761Claude Code setzt den Titel Ihrer Terminal-Registerkarte. Standardmäßig verwendet es einen Titel, den es aus dem Gespräch generiert, und sobald Sie der Sitzung einen [Namen](/docs/de/sessions#name-your-sessions) mit `/rename` oder `--name` geben, zeigt die Registerkarte stattdessen diesen Namen. Setzen Sie diesen Schlüssel auf `false`, um den generierten Titel auf der Registerkarte zu behalten, auch nachdem Sie die Sitzung benannt haben. Der Name selbst gilt immer noch, daher finden `/resume <name>` und der Sitzungs-Picker ihn.3854Claude Code setzt den Titel Ihres Terminal-Tabs. Standardmäßig verwendet es einen Titel, den es aus der Konversation generiert, und sobald Sie der Sitzung mit `/rename` oder `--name` einen [Namen](/docs/de/sessions#name-your-sessions) geben, zeigt der Tab stattdessen diesen Namen. Setzen Sie diesen Schlüssel auf `false`, um den generierten Titel auf dem Tab zu behalten, auch nachdem Sie die Sitzung benannt haben. Der Name selbst gilt weiterhin, sodass `/resume <name>` und die Sitzungsauswahl ihn finden.

3762 3855

3763* **Bereich**: [`Beliebige Datei`](#scopes)3856* **Geltungsbereich**: [`Any file`](#scopes)

3764* **Typ**: Boolean3857* **Typ**: Boolean

3765 * `true`: Der Terminal-Registerkartentitel zeigt den Sitzungsnamen, den Sie setzen3858 * `true`: Der Titel des Terminal-Tabs zeigt den von Ihnen festgelegten Sitzungsnamen

3766 * `false`: Die Registerkarte behält den Titel, den Claude Code aus Ihrem Gespräch generiert3859 * `false`: Der Tab behält den Titel, den Claude Code aus Ihrer Konversation generiert

3767* **Standard**: `true`3860* **Standard**: `true`

3768 3861

3769```json settings.json theme={null}3862```json settings.json theme={null}

3772}3865}

3773```3866```

3774 3867

3775Um Claude Code davon abzuhalten, den Terminal-Titel überhaupt zu aktualisieren, setzen Sie stattdessen [`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`](/docs/de/env-vars) auf `1`.3868Damit Claude Code den Terminaltitel überhaupt nicht mehr aktualisiert, setzen Sie stattdessen [`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`](/docs/de/env-vars) auf `1`.

3776 3869

3777<h3 id="theme">3870<h3 id="theme">

3778 `theme`3871 `theme`

3779</h3>3872</h3>

3780 3873

3781Wählen Sie das Farbdesign für die Schnittstelle. Erscheint in `/config` als **Design**.3874Das Farbschema für die Oberfläche wählen. Erscheint in `/config` als **Theme**.

3782 3875

3783* **Bereich**: [`Beliebige Datei`](#scopes). Ein Wert in `~/.claude.json` aus einer älteren Version gilt, wenn keine Einstellungsdatei es setzt.3876* **Geltungsbereich**: [`Any file`](#scopes). Ein Wert in `~/.claude.json` aus einer älteren Version gilt, wenn keine Einstellungsdatei den Schlüssel setzt.

3784* **Typ**: String, einer von:3877* **Typ**: String, einer von:

3785 * `"auto"`: passt sich dem hellen oder dunklen Hintergrund Ihres Terminals an3878 * `"auto"`: passt sich dem hellen oder dunklen Hintergrund Ihres Terminals an

3786 * `"dark"`: das dunkle Design3879 * `"dark"`: das dunkle Theme

3787 * `"light"`: das helle Design3880 * `"light"`: das helle Theme

3788 * `"dark-daltonized"`: das dunkle Design mit farbenblind-freundlichen Farben3881 * `"dark-daltonized"`: das dunkle Theme mit farbenblindfreundlichen Farben

3789 * `"light-daltonized"`: das helle Design mit farbenblind-freundlichen Farben3882 * `"light-daltonized"`: das helle Theme mit farbenblindfreundlichen Farben

3790 * `"dark-ansi"`: das dunkle Design mit nur Ihrer Terminal-ANSI-Farbpalette3883 * `"dark-ansi"`: das dunkle Theme, das nur die ANSI-Farbpalette Ihres Terminals verwendet

3791 * `"light-ansi"`: das helle Design mit nur Ihrer Terminal-ANSI-Farbpalette3884 * `"light-ansi"`: das helle Theme, das nur die ANSI-Farbpalette Ihres Terminals verwendet

3792 * `"custom:<slug>"` oder `"custom:<plugin-name>:<slug>"`: ein benutzerdefiniertes Design aus `~/.claude/themes/` oder einem Plugin3885 * `"custom:<slug>"` oder `"custom:<plugin-name>:<slug>"`: ein benutzerdefiniertes Theme aus `~/.claude/themes/` oder aus einem Plugin

3793* **Standard**: `"dark"`3886* **Standard**: `"dark"`

3794 3887

3795```json settings.json theme={null}3888```json settings.json theme={null}

3798}3891}

3799```3892```

3800 3893

3801Siehe [Benutzerdefiniertes Design erstellen](/docs/de/terminal-config#create-a-custom-theme).3894Siehe [Ein benutzerdefiniertes Theme erstellen](/docs/de/terminal-config#create-a-custom-theme).

3802 3895

3803<h3 id="timeformat">3896<h3 id="timeformat">

3804 `timeFormat`3897 `timeFormat`

3805</h3>3898</h3>

3806 3899

3807Wählen Sie, wie Claude Code die Zeiten schreibt, die es in der Schnittstelle anzeigt, wie z. B. die `done 6:05 PM` am Ende jeder Rundendauer-Nachricht und die Zeitstempel im [Transkript-Viewer](/docs/de/interactive-mode#transcript-viewer). Um eine Voreinstellung zu wählen, führen Sie `/config` aus und setzen Sie **Zeitformat**. Erfordert Claude Code v2.1.257 oder später.3900Legen Sie fest, wie Claude Code die Uhrzeiten schreibt, die es in der Oberfläche anzeigt, etwa `done 6:05 PM` am Ende jeder Meldung zur Turn-Dauer und die Zeitstempel im [Transkript-Viewer](/docs/de/interactive-mode#transcript-viewer). Um eine Vorgabe auszuwählen, führen Sie `/config` aus und setzen **Time format**. Erfordert Claude Code v2.1.257 oder höher.

3808 3901

3809* **Bereich**: [`Beliebige Datei`](#scopes)3902* **Geltungsbereich**: [`Any file`](#scopes)

3810* **Typ**: String, einer von:3903* **Typ**: String, einer von:

3811 * `"auto"`: das gleiche wie nicht gesetzt; jede Zeit behält ihr integriertes Format, das Ihrem Gebietsschema in der Rundendauer-Nachricht folgt3904 * `"auto"`: wie nicht gesetzt; jede Uhrzeit behält ihr integriertes Format, das bei der Meldung zur Turn-Dauer Ihrem Gebietsschema folgt

3812 * `"12-hour"`: eine 12-Stunden-Uhr3905 * `"12-hour"`: eine 12-Stunden-Uhr

3813 * `"24-hour"`: eine 24-Stunden-Uhr3906 * `"24-hour"`: eine 24-Stunden-Uhr

3814 * `"24-hour-utc"`: eine 24-Stunden-Uhr in UTC mit `Z` nach den Minuten, wie z. B. `18:05Z`; Claude Code ignoriert [`timeZone`](#timezone) für diese Voreinstellung3907 * `"24-hour-utc"`: eine 24-Stunden-Uhr in UTC mit `Z` nach den Minuten, etwa `18:05Z`; Claude Code ignoriert [`timeZone`](#timezone) für diese Vorgabe

3815 * Ein strftime-Muster wie `"%H:%M"`: Claude Code schreibt jede Zeit mit dem Muster. Jeder Wert, der ein `%` enthält, ist ein Muster, und jeder andere Wert außerhalb der Voreinstellungen zählt als `"auto"`3908 * Ein strftime-Muster wie `"%H:%M"`: Claude Code schreibt jede Uhrzeit mit dem Muster. Jeder Wert, der ein `%` enthält, ist ein Muster, und jeder andere Wert außerhalb der Vorgaben zählt als `"auto"`

3816* **Standard**: `"auto"`3909* **Standard**: `"auto"`

3817 3910

3818```json settings.json theme={null}3911```json settings.json theme={null}

3821}3914}

3822```3915```

3823 3916

3824`/config` bietet nur die Voreinstellungen, daher müssen Sie zum Verwenden eines strftime-Musters den Schlüssel zu einer Einstellungsdatei hinzufügen. Dieses Beispiel zeigt jede Zeit als eine zweistellige 24-Stunden-Uhr:3917`/config` bietet nur die Vorgaben an; um ein strftime-Muster zu verwenden, fügen Sie den Schlüssel daher einer Einstellungsdatei hinzu. Dieses Beispiel zeigt jede Uhrzeit als zweistellige 24-Stunden-Uhr:

3825 3918

3826```json settings.json theme={null}3919```json settings.json theme={null}

3827{3920{

3829}3922}

3830```3923```

3831 3924

3832Die Rundendauer-Nachricht und der Transkript-Viewer zeigen dann Zeiten wie `18:05`. Im Transkript-Viewer ist das Muster der gesamte Zeitstempel, daher fügen Sie Datums-Direktiven hinzu, wenn Sie das Datum dort haben möchten. Dieses Beispiel setzt das Datum vor die Uhr:3925Die Meldung zur Turn-Dauer und der Transkript-Viewer zeigen dann Uhrzeiten wie `18:05`. Im Transkript-Viewer bildet das Muster den gesamten Zeitstempel, fügen Sie daher Datumsdirektiven hinzu, wenn Sie dort das Datum sehen möchten. Dieses Beispiel stellt das Datum vor die Uhrzeit:

3833 3926

3834```json settings.json theme={null}3927```json settings.json theme={null}

3835{3928{

3837}3930}

3838```3931```

3839 3932

3840Die gleichen Oberflächen zeigen dann Zeiten wie `2026-09-01 18:05`.3933Dieselben Oberflächen zeigen dann Uhrzeiten wie `2026-09-01 18:05`.

3841 3934

3842<h3 id="timezone">3935<h3 id="timezone">

3843 `timeZone`3936 `timeZone`

3844</h3>3937</h3>

3845 3938

3846Zeigen Sie die Zeiten in der Schnittstelle in einer anderen Zeitzone als Ihrer Systemzeit an. Setzen Sie es auf einen [IANA-Zeitzonennamen](https://www.iana.org/time-zones), wie z. B. `"UTC"` oder `"Europe/Dublin"`. Die Zeiten, die [`timeFormat`](#timeformat) kontrolliert, werden dann in dieser Zone angezeigt. Wenn `timeFormat` `"24-hour-utc"` ist, bleiben Zeiten in UTC und Claude Code ignoriert diesen Schlüssel. `/config` hat keine Zeile für diesen Schlüssel, daher setzen Sie ihn in einer Einstellungsdatei. Erfordert Claude Code v2.1.257 oder später.3939Die Uhrzeiten in der Oberfläche in einer anderen Zeitzone als der Ihres Systems anzeigen. Setzen Sie den Schlüssel auf einen [IANA-Zeitzonennamen](https://www.iana.org/time-zones), etwa `"UTC"` oder `"Europe/Dublin"`. Die Uhrzeiten, die [`timeFormat`](#timeformat) steuert, werden dann in dieser Zone angezeigt. Wenn `timeFormat` auf `"24-hour-utc"` steht, bleiben die Uhrzeiten in UTC, und Claude Code ignoriert diesen Schlüssel. `/config` hat keine Zeile für diesen Schlüssel, setzen Sie ihn daher in einer Einstellungsdatei. Erfordert Claude Code v2.1.257 oder höher.

3847 3940

3848* **Bereich**: [`Beliebige Datei`](#scopes)3941* **Geltungsbereich**: [`Any file`](#scopes)

3849* **Typ**: String, ein IANA-Zeitzonennamen. Wenn Claude Code den Namen nicht erkennt, verwendet es Ihre Systemzeitzone3942* **Typ**: String, ein IANA-Zeitzonenname. Wenn Claude Code den Namen nicht erkennt, verwendet es Ihre Systemzeitzone

3850* **Standard**: nicht gesetzt, daher zeigen Zeiten Ihre Systemzeitzone3943* **Standard**: nicht gesetzt, daher werden Uhrzeiten in Ihrer Systemzeitzone angezeigt

3851 3944

3852```json settings.json theme={null}3945```json settings.json theme={null}

3853{3946{

3859 `tui`3952 `tui`

3860</h3>3953</h3>

3861 3954

3862Wählen Sie den Terminal-UI-Renderer. Verwenden Sie `"fullscreen"` für den flimmerfreien [Alt-Screen-Renderer](/docs/de/fullscreen) mit virtualisiertem Scrollback oder `"default"` für den klassischen Main-Screen-Renderer. Das Ausführen von `/tui fullscreen` oder `/tui default` schreibt diesen Schlüssel für Sie.3955Den Renderer der Terminal-Oberfläche wählen. Verwenden Sie `"fullscreen"` für den flackerfreien [Alt-Screen-Renderer](/docs/de/fullscreen) mit virtualisiertem Scrollback oder `"default"` für den klassischen Main-Screen-Renderer. Wenn Sie `/tui fullscreen` oder `/tui default` ausführen, wird dieser Schlüssel für Sie geschrieben.

3863 3956

3864* **Bereich**: [`Beliebige Datei`](#scopes)3957* **Geltungsbereich**: [`Any file`](#scopes)

3865* **Typ**: String, einer von:3958* **Typ**: String, einer von:

3866 * `"default"`: der klassische Main-Screen-Renderer3959 * `"default"`: der klassische Main-Screen-Renderer

3867 * `"fullscreen"`: der flimmerfreie Alt-Screen-Renderer mit virtualisiertem Scrollback3960 * `"fullscreen"`: der flackerfreie Alt-Screen-Renderer mit virtualisiertem Scrollback

3868* **Standard**: nicht gesetzt, daher [wählt Claude Code den Renderer für Sie](/docs/de/fullscreen#fullscreen-by-default)3961* **Standard**: nicht gesetzt, daher [wählt Claude Code den Renderer für Sie](/docs/de/fullscreen#fullscreen-by-default)

3869* **Sitzungsübergreifende Außerkraftsetzungen**: [`CLAUDE_CODE_NO_FLICKER`](/docs/de/env-vars) und [`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`](/docs/de/env-vars) haben Vorrang vor diesem Schlüssel für eine Sitzung: `CLAUDE_CODE_NO_FLICKER=1` schaltet Vollbild ein, und `CLAUDE_CODE_NO_FLICKER=0` oder `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1` schaltet es aus; wenn beide gesetzt sind, schaltet Claude Code es aus3962* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_NO_FLICKER`](/docs/de/env-vars) und [`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`](/docs/de/env-vars) haben für eine Sitzung Vorrang vor diesem Schlüssel: `CLAUDE_CODE_NO_FLICKER=1` schaltet den Vollbildmodus ein, und `CLAUDE_CODE_NO_FLICKER=0` oder `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1` schaltet ihn aus; wenn beide gesetzt sind, schaltet Claude Code ihn aus

3870 3963

3871```json settings.json theme={null}3964```json settings.json theme={null}

3872{3965{

3874}3967}

3875```3968```

3876 3969

3877Unter tmux `-CC` oder über SSH zu Windows behält Claude Code den klassischen Renderer, es sei denn, Sie setzen `CLAUDE_CODE_NO_FLICKER=1`. Hintergrundsitzungen, die aus der [Agent-Ansicht](/docs/de/agent-view) geöffnet werden, verwenden immer den Vollbild-Renderer, unabhängig von dieser Einstellung.3970Unter tmux `-CC` oder über SSH zu Windows behält Claude Code den klassischen Renderer bei, sofern Sie nicht `CLAUDE_CODE_NO_FLICKER=1` setzen. Hintergrundsitzungen, die aus der [Agentenansicht](/docs/de/agent-view) geöffnet werden, verwenden unabhängig von dieser Einstellung immer den Vollbild-Renderer.

3878 3971

3879<h3 id="verbose">3972<h3 id="verbose">

3880 `verbose`3973 `verbose`

3881</h3>3974</h3>

3882 3975

3883Standardmäßig reduziert das Transkript jeden Tool-Aufruf auf eine kurze Zusammenfassung, wie z. B. den Befehl, den Claude ausgeführt hat, und eine Zeilenanzahl seiner Ausgabe, und Sie drücken `Ctrl+O`, um das gesamte Transkript zur erweiterten Ansicht zu wechseln, wenn Sie die Details möchten. Setzen Sie diesen Schlüssel auf `true`, um die vollständige Eingabe und Ausgabe jedes Tool-Aufrufs inline anzuzeigen, während es passiert, was nützlich ist, wenn Sie einen Hook, einen MCP-Server oder einen langen Shell-Befehl debuggen. Erscheint in `/config` als **Ausführliche Ausgabe**.3976Standardmäßig fasst das Transkript jeden Tool-Aufruf zu einer kurzen Zusammenfassung zusammen, etwa dem Befehl, den Claude ausgeführt hat, und der Zeilenanzahl seiner Ausgabe, und Sie drücken `Ctrl+O`, um das gesamte Transkript in die erweiterte Ansicht umzuschalten, wenn Sie die Details sehen möchten. Setzen Sie diesen Schlüssel auf `true`, um die vollständige Ein- und Ausgabe jedes Tool-Aufrufs direkt beim Auftreten inline anzuzeigen, was beim Debugging eines Hooks, eines MCP-Servers oder eines langen Shell-Befehls nützlich ist. Erscheint in `/config` als **Verbose output**.

3884 3977

3885* **Bereich**: [`Beliebige Datei`](#scopes). Ein Wert in `~/.claude.json` aus einer älteren Version gilt, wenn keine Einstellungsdatei es setzt.3978* **Geltungsbereich**: [`Any file`](#scopes). Ein Wert in `~/.claude.json` aus einer älteren Version gilt, wenn keine Einstellungsdatei den Schlüssel setzt.

3886* **Typ**: Boolean3979* **Typ**: Boolean

3887 * `true`: Sie sehen vollständige Tool-Ausgabe3980 * `true`: Sie sehen die vollständige Tool-Ausgabe

3888 * `false`: Sie sehen gekürzte Zusammenfassungen der Tool-Ausgabe3981 * `false`: Sie sehen gekürzte Zusammenfassungen der Tool-Ausgabe

3889* **Standard**: `false`3982* **Standard**: `false`

3890* **Sitzungsübergreifende Außerkraftsetzungen**: [`--verbose`](/docs/de/cli-reference#cli-flags) hat Vorrang vor diesem Schlüssel für eine Sitzung3983* **Überschreibungen pro Sitzung**: [`--verbose`](/docs/de/cli-reference#cli-flags) hat für eine Sitzung Vorrang vor diesem Schlüssel

3891 3984

3892```json settings.json theme={null}3985```json settings.json theme={null}

3893{3986{

3895}3988}

3896```3989```

3897 3990

3898Ein [`viewMode`](#viewmode)-Wert oder eine klebrige `/focus`-Auswahl überschreibt diesen Schlüssel jede Sitzung.3991Ein [`viewMode`](#viewmode)-Wert oder eine dauerhafte `/focus`-Auswahl überschreibt diesen Schlüssel in jeder Sitzung.

3899 3992

3900<h3 id="viewmode">3993<h3 id="viewmode">

3901 `viewMode`3994 `viewMode`

3902</h3>3995</h3>

3903 3996

3904Legen Sie die Transkript-Ansicht fest, in der Claude Code startet: `"default"`, `"verbose"` oder `"focus"`. Wenn gesetzt, überschreibt es sowohl die klebrige `/focus`-Auswahl als auch die Einstellung [`verbose`](#verbose).3997Die Transkriptansicht festlegen, mit der Claude Code startet: `"default"`, `"verbose"` oder `"focus"`. Wenn gesetzt, überschreibt der Schlüssel sowohl die dauerhafte `/focus`-Auswahl als auch die Einstellung [`verbose`](#verbose).

3905 3998

3906* **Bereich**: [`Beliebige Datei`](#scopes)3999* **Geltungsbereich**: [`Any file`](#scopes)

3907* **Typ**: String, einer von:4000* **Typ**: String, einer von:

3908 * `"default"`: das normale Transkript mit gekürzte Tool-Ausgabe4001 * `"default"`: das normale Transkript mit gekürzter Tool-Ausgabe

3909 * `"verbose"`: das Transkript mit vollständiger Tool-Ausgabe4002 * `"verbose"`: das Transkript mit vollständiger Tool-Ausgabe

3910 * `"focus"`: nur Ihre letzte Eingabeaufforderung, eine einzeilige Zusammenfassung von Tool-Aufrufen mit Edit-Diffstats und die endgültige Antwort. Focus-Ansicht benötigt den [Vollbild-Renderer](#tui)4003 * `"focus"`: nur Ihr letzter Prompt, eine einzeilige Zusammenfassung der Tool-Aufrufe mit Diffstats der Bearbeitungen und die abschließende Antwort. Die Fokusansicht erfordert den [Vollbild-Renderer](#tui)

3911* **Standard**: nicht gesetzt, daher gelten die Einstellung `verbose` und Ihre letzte `/focus`-Auswahl4004* **Standard**: nicht gesetzt, daher gelten die Einstellung `verbose` und Ihre letzte `/focus`-Auswahl

3912* **Sitzungsübergreifende Außerkraftsetzungen**: [`--verbose`](/docs/de/cli-reference#cli-flags) hat Vorrang vor diesem Schlüssel für eine Sitzung4005* **Überschreibungen pro Sitzung**: [`--verbose`](/docs/de/cli-reference#cli-flags) hat für eine Sitzung Vorrang vor diesem Schlüssel

3913 4006

3914```json settings.json theme={null}4007```json settings.json theme={null}

3915{4008{

3921 `vimInsertModeRemaps`4014 `vimInsertModeRemaps`

3922</h3>4015</h3>

3923 4016

3924Ordnen Sie zwei-Tasten-INSERT-Modus-Sequenzen Escape im [Vim-Editor-Modus](/docs/de/interactive-mode#vim-editor-mode) zu. Jeder Schlüssel ist genau zwei druckbare Zeichen, die nacheinander eingegeben werden, und `"<Esc>"` ist das einzige unterstützte Ziel; Claude Code ignoriert andere Einträge. Erfordert Claude Code v2.1.208 oder später.4017Zwei-Tasten-Sequenzen im INSERT-Modus im [vim-Editor-Modus](/docs/de/interactive-mode#vim-editor-mode) auf Escape abbilden. Jeder Schlüssel besteht aus genau zwei druckbaren Zeichen, die nacheinander eingegeben werden, und `"<Esc>"` ist das einzige unterstützte Ziel; Claude Code ignoriert andere Einträge. Erfordert Claude Code v2.1.208 oder höher.

3925 4018

3926* **Bereich**: [`Benutzer oder verwaltet`](#scopes). Ein Repository kann Ihre Tastenanschläge nicht neu zuordnen.4019* **Geltungsbereich**: [`User or managed`](#scopes). Ein Repository kann Ihre Tastenanschläge nicht umbelegen.

3927* **Typ**: Objekt, das eine zwei-Zeichen-Sequenz auf `"<Esc>"` abbildet4020* **Typ**: Objekt, das eine Sequenz aus zwei Zeichen auf `"<Esc>"` abbildet

3928* **Standard**: nicht gesetzt4021* **Standard**: nicht gesetzt

3929 4022

3930```json settings.json theme={null}4023```json settings.json theme={null}

3935}4028}

3936```4029```

3937 4030

3938Hat keine Auswirkung, es sei denn, `editorMode` ist `"vim"`. Siehe [INSERT-Modus-Tastenseqenzen neu zuordnen](/docs/de/interactive-mode#remap-insert-mode-key-sequences). Erfordert Claude Code v2.1.208 oder später.4031Hat keine Wirkung, sofern `editorMode` nicht `"vim"` ist. Siehe [Tastensequenzen im INSERT-Modus umbelegen](/docs/de/interactive-mode#remap-insert-mode-key-sequences). Erfordert Claude Code v2.1.208 oder höher.

3939 4032

3940<h3 id="voice">4033<h3 id="voice">

3941 `voice`4034 `voice`

3942</h3>4035</h3>

3943 4036

3944Schalten Sie [Sprachdiktat](/docs/de/voice-dictation) ein und wählen Sie, wie die Diktat-Taste sich verhält. Claude Code schreibt dieses Objekt für Sie, wenn Sie `/voice` ausführen.4037[Sprachdiktat](/docs/de/voice-dictation) einschalten und festlegen, wie sich die Diktiertaste verhält. Claude Code schreibt dieses Objekt für Sie, wenn Sie `/voice` ausführen.

3945 4038

3946* **Bereich**: [`Beliebige Datei`](#scopes)4039* **Geltungsbereich**: [`Any file`](#scopes)

3947* **Typ**: Objekt mit `enabled` als Boolean, `autoSubmit` als Boolean, das nur im Hold-Modus gilt, und `mode`, einer von:4040* **Typ**: Objekt mit `enabled` als Boolean, `autoSubmit` als Boolean, das nur im Haltemodus gilt, und `mode`, einer von:

3948 * `"hold"`: Sie halten die Diktat-Taste gedrückt, während Sie sprechen, und lassen sie los, um zu stoppen4041 * `"hold"`: Sie halten die Diktiertaste beim Sprechen gedrückt und lassen sie los, um zu stoppen

3949 * `"tap"`: Sie tippen die Taste einmal an, um die Aufzeichnung zu starten, und erneut, um zu senden4042 * `"tap"`: Sie tippen die Taste einmal an, um die Aufnahme zu starten, und erneut, um zu senden

3950* **Standard**: nicht gesetzt, daher ist Diktat aus; wenn `enabled` `true` ist und `mode` nicht gesetzt ist, verwendet Claude Code `"hold"`4043* **Standard**: nicht gesetzt, daher ist das Diktat aus; wenn `enabled` auf `true` steht und `mode` nicht gesetzt ist, verwendet Claude Code `"hold"`

3951 4044

3952Dieses Beispiel schaltet Diktat ein und macht die Taste zu einem Tippen, um die Aufzeichnung zu starten, und erneut zu senden:4045Dieses Beispiel schaltet das Diktat ein und legt fest, dass die Taste einmal angetippt wird, um die Aufnahme zu starten, und erneut, um zu senden:

3953 4046

3954```json settings.json theme={null}4047```json settings.json theme={null}

3955{4048{

3960}4053}

3961```4054```

3962 4055

3963`autoSubmit` sendet die Eingabeaufforderung, wenn Sie die Taste im Hold-Modus loslassen. Sprachdiktat erfordert ein claude.ai-Konto.4056`autoSubmit` sendet den Prompt, wenn Sie die Taste im Haltemodus loslassen. Sprachdiktat erfordert ein claude.ai-Konto.

3964 4057

3965<h3 id="voiceenabled">4058<h3 id="voiceenabled">

3966 `voiceEnabled`4059 `voiceEnabled`

3967</h3>4060</h3>

3968 4061

3969<Warning>4062<Warning>

3970 Veraltet seit v2.1.92, als das Objekt [`voice`](#voice) es ersetzte. Claude Code liest es immer noch, daher funktionieren ältere Einstellungsdateien weiterhin, aber neue Konfigurationen sollten `voice.enabled` setzen.4063 Seit v2.1.92 veraltet, als das Objekt [`voice`](#voice) diesen Schlüssel ersetzt hat. Claude Code liest ihn weiterhin, damit ältere Einstellungsdateien funktionieren, neue Konfigurationen sollten jedoch `voice.enabled` setzen.

3971</Warning>4064</Warning>

3972 4065

3973Schalten Sie Sprachdiktat mit der einzelnen Boolean-Form ein, die dem Objekt `voice` vorausgeht. Wenn beide gesetzt sind, gilt `voice.enabled`.4066Sprachdiktat mit der einfachen Boolean-Form einschalten, die älter ist als das Objekt `voice`. Wenn beide gesetzt sind, gilt `voice.enabled`.

3974 4067

3975* **Bereich**: [`Beliebige Datei`](#scopes)4068* **Geltungsbereich**: [`Any file`](#scopes)

3976* **Typ**: Boolean4069* **Typ**: Boolean

3977 * `true`: Sprachdiktat ist an, wenn Sie mit einem claude.ai-Konto angemeldet sind und die Richtlinie Ihrer Organisation Sprache erlaubt, es sei denn, `voice.enabled` ist gesetzt4070 * `true`: Sprachdiktat ist eingeschaltet, wenn Sie mit einem claude.ai-Konto angemeldet sind und die Richtlinie Ihrer Organisation Sprache zulässt, sofern `voice.enabled` nicht gesetzt ist

3978 * `false`: Sprachdiktat ist aus, es sei denn, `voice.enabled` ist gesetzt4071 * `false`: Sprachdiktat ist ausgeschaltet, sofern `voice.enabled` nicht gesetzt ist

3979* **Standard**: nicht gesetzt4072* **Standard**: nicht gesetzt

3980 4073

3981```json settings.json theme={null}4074```json settings.json theme={null}

3988 `wheelScrollAccelerationEnabled`4081 `wheelScrollAccelerationEnabled`

3989</h3>4082</h3>

3990 4083

3991Beschleunigen Sie die Mausrad-Scroll-Geschwindigkeit während schneller Scrolls in [Vollbilddarstellung](/docs/de/fullscreen#mouse-wheel-scrolling). Setzen Sie es auf `false` für eine konstante Scroll-Rate pro Rad-Kerbe.4084Die Scrollgeschwindigkeit des Mausrads bei schnellem Scrollen im [Vollbild-Rendering](/docs/de/fullscreen#mouse-wheel-scrolling) beschleunigen. Setzen Sie den Schlüssel auf `false` für eine konstante Scrollrate pro Mausradraste.

3992 4085

3993* **Bereich**: [`Beliebige Datei`](#scopes)4086* **Geltungsbereich**: [`Any file`](#scopes)

3994* **Typ**: Boolean4087* **Typ**: Boolean

3995 * `true`: Claude Code beschleunigt die Mausrad-Scroll-Geschwindigkeit während schneller Scrolls4088 * `true`: Claude Code beschleunigt die Scrollgeschwindigkeit des Mausrads bei schnellem Scrollen

3996 * `false`: Claude Code scrollt mit einer konstanten Rate pro Rad-Kerbe4089 * `false`: Claude Code scrollt mit einer konstanten Rate pro Mausradraste

3997* **Standard**: `true`4090* **Standard**: `true`

3998 4091

3999```json settings.json theme={null}4092```json settings.json theme={null}

4109 4202

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

4111* **Typ**: Zeichenkette4204* **Typ**: Zeichenkette

4112* **Standard**: nicht gesetzt, daher fügt Claude Code `Co-Authored-By: <name> <noreply@anthropic.com>` hinzu. Der Name ist das aktive Modell der Sitzung, wie `Claude Sonnet 5`.4205* **Standard**: nicht gesetzt, daher fügt Claude Code `Co-Authored-By: <name> <noreply@anthropic.com>` hinzu. Der Name ist das Modell, das beim Erstellen des Commits verwendet wird, wie `Claude Sonnet 5`. Wenn ein [Subagent](/docs/de/sub-agents) den Commit erstellt, nennt der Trailer das Modell des Subagenten.

4113 * Wenn Claude Code das Modell als Claude-Modell erkennt, aber seine genaue Version nicht bestätigen kann, schreibt es nur `Claude`.4206 * Wenn Claude Code das Modell als Claude-Modell erkennt, aber seine genaue Version nicht bestätigen kann, schreibt es nur `Claude`.

4114 * Wenn es die Modell-ID nicht mit einem Claude-Modell abgleichen kann, wie ein Drittanbieter-Modell, das über eine benutzerdefinierte [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) bereitgestellt wird, schreibt es `Claude Code`.4207 * Wenn es die Modell-ID nicht mit einem Claude-Modell abgleichen kann, wie ein Drittanbieter-Modell, das über eine benutzerdefinierte [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) bereitgestellt wird, schreibt es `Claude Code`.

4115 4208

4145 `attribution.sessionUrl`4238 `attribution.sessionUrl`

4146</h3>4239</h3>

4147 4240

4148Wählen Sie, ob Claude Code den claude.ai-Sitzungslink anhängt, wenn es von einer [Cloud](/docs/de/claude-code-on-the-web)- oder [Remote Control](/docs/de/remote-control)-Sitzung aus committed oder einen Pull Request öffnet. Claude Code fügt den Link als `Claude-Session`-Trailer bei Commits und als Link in Pull-Request-Beschreibungen hinzu. Setzen Sie ihn auf `false`, um den Link auszulassen.4241Wählen Sie, ob Claude Code den claude.ai-Sitzungslink anhängt, wenn es von einer [Cloud](/docs/de/claude-code-on-the-web)- oder [Remote Control](/docs/de/remote-control)-Sitzung aus committet oder einen Pull Request öffnet. Claude Code fügt den Link als `Claude-Session`-Trailer bei Commits und als Link in Pull-Request-Beschreibungen hinzu. Setzen Sie ihn auf `false`, um den Link auszulassen.

4149 4242

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

4151* **Typ**: Boolean4244* **Typ**: Boolean

4152 * `true`: Claude Code hängt den claude.ai-Sitzungslink an, wenn es von einer Cloud- oder Remote-Control-Sitzung aus committed oder einen Pull Request öffnet4245 * `true`: Claude Code hängt den claude.ai-Sitzungslink an, wenn es von einer Cloud- oder Remote-Control-Sitzung aus committet oder einen Pull Request öffnet

4153 * `false`: Claude Code lässt den Link aus4246 * `false`: Claude Code lässt den Link aus

4154* **Standard**: `true`4247* **Standard**: `true`

4155 4248

4216Wenn Sie es auf `true` setzen, ändert Claude Code, welche Hooks und Hook-ähnliche Befehle geladen werden:4309Wenn Sie es auf `true` setzen, ändert Claude Code, welche Hooks und Hook-ähnliche Befehle geladen werden:

4217 4310

4218* **Verwaltete und SDK-Hooks werden ausgeführt**: Hooks aus verwalteten Einstellungen und Hooks, die das [Agent SDK](/docs/de/agent-sdk/overview) im Prozess registriert4311* **Verwaltete und SDK-Hooks werden ausgeführt**: Hooks aus verwalteten Einstellungen und Hooks, die das [Agent SDK](/docs/de/agent-sdk/overview) im Prozess registriert

4219* **Erzwungene Plugin-Hooks werden ausgeführt**: Hooks aus Plugins, die Ihre verwalteten Einstellungen durch [`enabledPlugins`](#enabledplugins) erzwingen. Claude Code gleicht die vollständige `plugin@marketplace`-ID ab, daher bleibt ein Plugin mit demselben Namen aus einem anderen Marketplace blockiert. Dies ermöglicht es Ihnen, überprüfte Hooks über einen Organisations-Marketplace zu verteilen und alles andere zu blockieren4312* **Erzwungene Plugin-Hooks werden ausgeführt**: Hooks aus Plugins, die Ihre verwalteten Einstellungen durch [`enabledPlugins`](#enabledplugins) erzwingen. Claude Code gleicht die vollständige `plugin@marketplace`-ID ab, daher bleibt ein Plugin mit demselben Namen aus einem anderen Marketplace blockiert. Dies ermöglicht es Ihnen, überprüfte Hooks über einen Organisations-Marketplace zu verteilen und alles andere zu blockieren. Ein [Mod](/docs/de/plugins/mods/overview) in einem solchen Plugin wird nur geladen, wenn er [als Mod Ihrer Organisation gilt](/docs/de/plugins/mods/admin#install-your-organizations-mods)

4220* **Alles andere wird blockiert**: Benutzer-, Projekt- und lokale Hooks, Hooks aus anderen Plugins und Hooks, die in Agent-Frontmatter deklariert sind4313* **Alles andere wird blockiert**: Benutzer-, Projekt- und lokale Hooks, Hooks und Mods aus anderen installierten Plugins sowie Hooks, die im Agent-Frontmatter deklariert sind. [In Claude Code integrierte Mods](/docs/de/plugins/mods/overview#mods-built-into-claude-code) werden weiterhin ausgeführt. Um nur die Mods der Benutzer zu blockieren, setzen Sie stattdessen [`allowManagedModsOnly`](/docs/de/plugins/mods/admin#set-options-on-the-built-in-guard).

4221* **Command-sourced Plugins sind deaktiviert**: Claude Code deaktiviert auch Plugins mit einer [`command`-Quelle](/docs/de/plugins/marketplace-reference#command-plugin-source), einschließlich Plugins, die in verwalteten `enabledPlugins` erzwungen werden, es sei denn, Sie setzen [`disableCommandPluginSources`](#disablecommandpluginsources) explizit auf `false`4314* **Command-sourced Plugins sind deaktiviert**: Claude Code deaktiviert auch Plugins mit einer [`command`-Quelle](/docs/de/plugins/marketplace-reference#command-plugin-source), einschließlich Plugins, die in verwalteten `enabledPlugins` erzwungen werden, es sei denn, Sie setzen [`disableCommandPluginSources`](#disablecommandpluginsources) explizit auf `false`

4222* **Marketplace `headersHelper`-Befehle werden blockiert**: Claude Code blockiert auch Marketplace-[`headersHelper`-Befehle](/docs/de/plugins/host-marketplace#authenticate-archive-downloads), es sei denn, [`disableCommandPluginSources`](#disablecommandpluginsources) ist explizit auf `false` gesetzt, außer für einen Marketplace, den die verwalteten Einstellungen selbst deklarieren. Erfordert Claude Code v2.1.238 oder später4315* **Marketplace `headersHelper`-Befehle werden blockiert**: Claude Code blockiert auch Marketplace-[`headersHelper`-Befehle](/docs/de/plugins/host-marketplace#authenticate-archive-downloads), es sei denn, [`disableCommandPluginSources`](#disablecommandpluginsources) ist explizit auf `false` gesetzt, außer für einen Marketplace, den die verwalteten Einstellungen selbst deklarieren. Erfordert Claude Code v2.1.238 oder später

4223* **Statuszeile und Dateivorschlag werden auf verwaltete Einstellungen beschränkt**: Claude Code liest [`statusLine`](/docs/de/statusline), [`fileSuggestion`](#filesuggestion) und [`subagentStatusLine`](/docs/de/statusline#subagent-status-lines) nur aus verwalteten Einstellungen, gemäß den [Statuszeilen- und Dateivorschlag-Gates](#status-line-and-file-suggestion-gates)4316* **Statuszeile und Dateivorschlag werden auf verwaltete Einstellungen beschränkt**: Claude Code liest [`statusLine`](/docs/de/statusline), [`fileSuggestion`](#filesuggestion) und [`subagentStatusLine`](/docs/de/statusline#subagent-status-lines) nur aus verwalteten Einstellungen, gemäß den [Statuszeilen- und Dateivorschlag-Gates](#status-line-and-file-suggestion-gates)

4247* **In verwalteten Einstellungen**: Claude Code deaktiviert jeden konfigurierten Hook, einschließlich verwalteter, und führt weiterhin die Hooks aus, die das [Agent SDK](/docs/de/agent-sdk/overview) im Prozess registriert4340* **In verwalteten Einstellungen**: Claude Code deaktiviert jeden konfigurierten Hook, einschließlich verwalteter, und führt weiterhin die Hooks aus, die das [Agent SDK](/docs/de/agent-sdk/overview) im Prozess registriert

4248* **In jeder anderen Einstellungsdatei**: Claude Code deaktiviert Benutzer-, Projekt-, lokale und Plugin-Hooks; verwaltete Hooks, Agent SDK Hooks und Hooks aus Plugins, die in verwalteten [`enabledPlugins`](#enabledplugins) erzwungen werden, werden weiterhin ausgeführt4341* **In jeder anderen Einstellungsdatei**: Claude Code deaktiviert Benutzer-, Projekt-, lokale und Plugin-Hooks; verwaltete Hooks, Agent SDK Hooks und Hooks aus Plugins, die in verwalteten [`enabledPlugins`](#enabledplugins) erzwungen werden, werden weiterhin ausgeführt

4249 4342

4343Der Schlüssel stoppt auch [Mods](/docs/de/plugins/mods/overview), also Plugins, deren Code Hooks registriert:

4344

4345* **In verwalteten Einstellungen**: Die Mods in jedem installierten Plugin werden gestoppt, einschließlich der Mods Ihrer Organisation

4346* **In jeder anderen Einstellungsdatei**: Die von Ihnen installierten Mods werden gestoppt, und [die Mods Ihrer Organisation](/docs/de/plugins/mods/admin#install-your-organizations-mods) werden weiterhin ausgeführt

4347

4348In Claude Code integrierte Mods werden in beiden Fällen weiterhin ausgeführt. Jeder hat [einen eigenen Schalter](/docs/de/plugins/mods/overview#mods-built-into-claude-code).

4349

4250Das Beibehalten von Agent SDK Hooks, wenn verwaltete Einstellungen diesen Schlüssel setzen, erfordert Claude Code v2.1.242 oder später.4350Das Beibehalten von Agent SDK Hooks, wenn verwaltete Einstellungen diesen Schlüssel setzen, erfordert Claude Code v2.1.242 oder später.

4251 4351

4252Der [`/goal`](/docs/de/goal)-Befehl kann nicht ausgeführt werden, während Hooks deaktiviert sind, und das `/hooks`-Menü zeigt stattdessen einen Hinweis anstelle Ihrer Hooks.4352Der [`/goal`](/docs/de/goal)-Befehl kann nicht ausgeführt werden, während Hooks deaktiviert sind, und das `/hooks`-Menü zeigt stattdessen einen Hinweis anstelle Ihrer Hooks.

4416 * `true`: Claude Code entfernt gebündelte Skills und Workflows und verbirgt integrierte Befehle wie `/init` vor dem Modell4516 * `true`: Claude Code entfernt gebündelte Skills und Workflows und verbirgt integrierte Befehle wie `/init` vor dem Modell

4417 * `false`: gebündelte Skills werden geladen4517 * `false`: gebündelte Skills werden geladen

4418* **Standard**: nicht gesetzt, daher werden gebündelte Skills geladen4518* **Standard**: nicht gesetzt, daher werden gebündelte Skills geladen

4419* **Sitzungsübergreifende Außerkraftsetzungen**: [`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`](/docs/de/env-vars) auf `1` gesetzt deaktiviert gebündelte Skills für eine Sitzung; welcher der beiden sie deaktiviert, der andere kann sie nicht wieder aktivieren4519* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`](/docs/de/env-vars) auf `1` gesetzt deaktiviert gebündelte Skills für eine Sitzung; welcher der beiden sie deaktiviert, der andere kann sie nicht wieder aktivieren

4420 4520

4421```json settings.json theme={null}4521```json settings.json theme={null}

4422{4522{

4432 4532

4433Deaktivieren Sie die Inline-Shell-Ausführung für `` !`...` `` und ` ```! ` Blöcke in [Skills](/de/skills) und benutzerdefinierten Befehlen aus Benutzer-, Projekt-, Plugin- oder zusätzlichen Verzeichnisquellen. Claude Code ersetzt jeden Befehl durch `[shell command execution disabled by policy]` statt ihn auszuführen.4533Deaktivieren Sie die Inline-Shell-Ausführung für `` !`...` `` und ` ```! ` Blöcke in [Skills](/de/skills) und benutzerdefinierten Befehlen aus Benutzer-, Projekt-, Plugin- oder zusätzlichen Verzeichnisquellen. Claude Code ersetzt jeden Befehl durch `[shell command execution disabled by policy]` statt ihn auszuführen.

4434 4534

4435* **Bereich**: [`Any file`](#scopes). Ein `true` in verwalteten Einstellungen kann nicht durch `false` an anderer Stelle außer Kraft gesetzt werden.4535* **Bereich**: [`Any file`](#scopes). Ein `true` in verwalteten Einstellungen kann nicht durch `false` an anderer Stelle überschrieben werden.

4436* **Typ**: Boolean4536* **Typ**: Boolean

4437 * `true`: Claude Code ersetzt jeden Inline-Shell-Befehl durch `[shell command execution disabled by policy]` statt ihn auszuführen4537 * `true`: Claude Code ersetzt jeden Inline-Shell-Befehl durch `[shell command execution disabled by policy]` statt ihn auszuführen

4438 * `false`: Inline-Shell wird ausgeführt4538 * `false`: Inline-Shell wird ausgeführt

4471}4571}

4472```4572```

4473 4573

4474Außerkraftsetzungen gelten nicht für Plugin-Skills, die Sie über `/plugin` verwalten.4574Überschreibungen gelten nicht für Plugin-Skills, die Sie über `/plugin` verwalten.

4475 4575

4476In verwalteten Einstellungen und Dateien, die mit `--settings` übergeben werden, gilt ein Schlüssel auf einem Alias eines gebündelten Skills, wie `checkup` für `/doctor`, auch für den Skill; siehe [wie Alias-Schlüssel mit Schlüsseln auf dem eigenen Namen des Skills kombiniert werden](/docs/de/skills#override-skill-visibility-from-settings).4576In verwalteten Einstellungen und Dateien, die mit `--settings` übergeben werden, gilt ein Schlüssel auf einem Alias eines gebündelten Skills, wie `checkup` für `/doctor`, auch für den Skill; siehe [wie Alias-Schlüssel mit Schlüsseln auf dem eigenen Namen des Skills kombiniert werden](/docs/de/skills#override-skill-visibility-from-settings).

4477 4577

4521 `allowedChannelPlugins`4621 `allowedChannelPlugins`

4522</h3>4622</h3>

4523 4623

4524Wählen Sie, in welche [Kanal](/docs/de/channels)-Plugins Nachrichten in Sitzungen in Ihrer Organisation pushen können. Wenn Sie es festlegen, verwendet Claude Code Ihre Liste anstelle der Standard-Anthropic-Zulassungsliste; jeder Eintrag benennt ein Plugin und den Marketplace, aus dem es stammt.4624Wählen Sie, welche [Kanal](/docs/de/channels)-Plugins Nachrichten in Sitzungen in Ihrer Organisation pushen können. Wenn Sie es festlegen, verwendet Claude Code Ihre Liste anstelle der Standard-Anthropic-Zulassungsliste; jeder Eintrag benennt ein Plugin und den Marketplace, aus dem es stammt.

4525 4625

4526* **Bereich**: [`Managed`](#scopes)4626* **Bereich**: [`Managed`](#scopes)

4527* **Typ**: Array von Objekten, jeweils mit `marketplace` und `plugin` Strings. Ein Eintrag kann stattdessen ein `"plugin@marketplace"` String wie `"telegram@claude-plugins-official"` sein, den Claude Code als das äquivalente Objekt behandelt. Die String-Form erfordert Claude Code v2.1.267 oder später; frühere Versionen lehnen den gesamten `allowedChannelPlugins` Wert ab, wenn er einen enthält4627* **Typ**: Array von Objekten, jeweils mit `marketplace` und `plugin` Strings. Ein Eintrag kann stattdessen ein `"plugin@marketplace"` String wie `"telegram@claude-plugins-official"` sein, den Claude Code als das äquivalente Objekt behandelt. Die String-Form erfordert Claude Code v2.1.267 oder später; frühere Versionen lehnen den gesamten `allowedChannelPlugins` Wert ab, wenn er einen enthält

4753}4853}

4754```4854```

4755 4855

4756Mit diesem Eintrag behält Claude Code einen bereits registrierten offiziellen Marketplace bei und registriert den Marketplace beim ersten interaktiven Start von Claude Code automatisch auf einem neuen Computer. Die automatische Registrierung verpasst am häufigsten:4856Mit diesem Eintrag behält Claude Code einen bereits registrierten offiziellen Marketplace bei und registriert den Marketplace auf einem neuen Computer automatisch, wenn Sie zum ersten Mal eine interaktive Terminalsitzung starten. Die automatische Registrierung verpasst am häufigsten:

4757 4857

4758* Nicht-interaktive Umgebungen, die vor dem ersten interaktiven Start des Computers ausgeführt werden.4858* Nicht-interaktive Umgebungen, die vor der ersten interaktiven Terminalsitzung des Computers ausgeführt werden.

4759* Computer, auf denen Claude Code bereits interaktiv unter einer Richtlinie ausgeführt wurde, die den Marketplace blockierte, wie die leere Array-Sperrung. Claude Code zeichnet den blockierten Versuch auf und versucht nicht erneut, nachdem sich die Richtlinie ändert.4859* Computer, auf denen Claude Code nur über die VS Code-Erweiterung ausgeführt wurde.

4860* Computer, auf denen Claude Code bereits eine interaktive Terminalsitzung unter einer Richtlinie ausgeführt hat, die den Marketplace blockierte, wie die leere Array-Sperrung. Claude Code zeichnet den blockierten Versuch auf und versucht es nicht erneut, nachdem sich die Richtlinie ändert.

4760 4861

4761Fügen Sie auf diesen Computern den Marketplace zu [`extraKnownMarketplaces`](#extraknownmarketplaces) in derselben `managed-settings.json` hinzu, damit Claude Code ihn automatisch registriert, oder führen Sie `claude plugin marketplace add anthropics/claude-plugins-official` aus.4862Fügen Sie auf diesen Computern den Marketplace zu [`extraKnownMarketplaces`](#extraknownmarketplaces) in derselben `managed-settings.json` hinzu, damit Claude Code ihn automatisch registriert, oder führen Sie `claude plugin marketplace add anthropics/claude-plugins-official` aus.

4762 4863

4774| Wann erzwungen | Vor Netzwerk- und Dateisystemoperationen | Sofort aus Benutzer- oder verwalteten Einstellungen; nach dem Workspace-Vertrauensdialog für die Dateien eines Repositories |4875| Wann erzwungen | Vor Netzwerk- und Dateisystemoperationen | Sofort aus Benutzer- oder verwalteten Einstellungen; nach dem Workspace-Vertrauensdialog für die Dateien eines Repositories |

4777 4878

4778Um einen Marketplace sowohl einzuschränken als auch vorab zu registrieren für alle Benutzer, setzen Sie beide in `managed-settings.json`:4879Um einen Marketplace sowohl einzuschränken als auch vorab zu registrieren für alle Benutzer, setzen Sie beide in `managed-settings.json`:

4816 `strictPluginOnlyCustomization.skills`4917 `strictPluginOnlyCustomization.skills`

4817</h3>4918</h3>

4818 4919

4819Sperren Sie die `skills` Oberfläche. Claude Code stoppt das Laden von Skills aus `~/.claude/skills/` und `.claude/skills/`, benutzerdefinierten Befehlen aus `~/.claude/commands/` und `.claude/commands/`, Skills unter `--add-dir` Verzeichnissen und Skills, die von Ihrem claude.ai-Konto synchronisiert werden, und lädt weiterhin Plugin-Skills, gebündelte Skills und Skills im verwalteten Richtlinienverzeichnis.4920Sperren Sie die `skills` Oberfläche. Claude Code stoppt das Laden von Skills aus `~/.claude/skills/` und `.claude/skills/`, benutzerdefinierten Befehlen aus `~/.claude/commands/` und `.claude/commands/`, Skills und Befehlen unter `--add-dir` Verzeichnissen und Skills, die von Ihrem claude.ai-Konto synchronisiert werden. Es lädt weiterhin Plugin-Skills, gebündelte Skills und Skills im verwalteten Richtlinienverzeichnis.

4820 4921

4821* **Bereich**: [`Managed`](#scopes)4922* **Bereich**: [`Managed`](#scopes)

4822* **Typ**: der String `"skills"` im [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) Array4923* **Typ**: der String `"skills"` im [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) Array

4832 `strictPluginOnlyCustomization.agents`4933 `strictPluginOnlyCustomization.agents`

4833</h3>4934</h3>

4834 4935

4835Sperren Sie die `agents` Oberfläche. Claude Code stoppt das Laden von Agents aus `~/.claude/agents/` und `.claude/agents/` und lädt weiterhin Plugin-Agents, integrierte Agents und Agents im verwalteten Richtlinienverzeichnis.4936Sperren Sie die `agents` Oberfläche. Claude Code stoppt das Laden von Agents aus `~/.claude/agents/`, `.claude/agents/` und `--add-dir` Verzeichnissen. Es lädt weiterhin Plugin-Agents, integrierte Agents und Agents im verwalteten Richtlinienverzeichnis.

4836 4937

4837* **Bereich**: [`Managed`](#scopes)4938* **Bereich**: [`Managed`](#scopes)

4838* **Typ**: der String `"agents"` im [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) Array4939* **Typ**: der String `"agents"` im [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) Array

4902 5003

4903* **Benutzereinstellungen**: Ihre persönlichen Plugin-Voreinstellungen5004* **Benutzereinstellungen**: Ihre persönlichen Plugin-Voreinstellungen

4904* **Projekteinstellungen**: Plugins, die mit jedem im Repository geteilt werden5005* **Projekteinstellungen**: Plugins, die mit jedem im Repository geteilt werden

4905* **Lokale Einstellungen**: Pro-Computer-Außerkraftsetzungen, gitignoriert, wenn Claude Code eine Einstellung dort speichert5006* **Lokale Einstellungen**: Überschreibungen pro Computer, gitignoriert, wenn Claude Code eine Einstellung dort speichert

4906* **Verwaltete Einstellungen**: Organisationsrichtlinie. Ein Plugin, das hier auf `false` gesetzt ist, ist von der Installation in jedem Bereich blockiert und im Marketplace verborgen5007* **Verwaltete Einstellungen**: Organisationsrichtlinie. Ein Plugin, das hier auf `false` gesetzt ist, ist von der Installation in jedem Bereich blockiert und im Marketplace verborgen

4907 5008

4908Projekteinstellungen haben Vorrang vor Benutzereinstellungen, daher deaktiviert das Setzen eines Plugins auf `false` in `~/.claude/settings.json` kein Plugin, das die `.claude/settings.json` des Projekts aktiviert. Um sich von einem von Projekt aktivierten Plugin auf Ihrem Computer abzumelden, setzen Sie es stattdessen auf `false` in `.claude/settings.local.json`. Plugins, die von verwalteten Einstellungen erzwungen aktiviert werden, können auf diese Weise nicht deaktiviert werden, da verwaltete Einstellungen lokale Einstellungen außer Kraft setzen.5009Projekteinstellungen haben Vorrang vor Benutzereinstellungen, daher deaktiviert das Setzen eines Plugins auf `false` in `~/.claude/settings.json` kein Plugin, das die `.claude/settings.json` des Projekts aktiviert. Um sich von einem von Projekt aktivierten Plugin auf Ihrem Computer abzumelden, setzen Sie es stattdessen auf `false` in `.claude/settings.local.json`. Plugins, die von verwalteten Einstellungen erzwungen aktiviert werden, können auf diese Weise nicht deaktiviert werden, da verwaltete Einstellungen lokale Einstellungen überschreiben.

4909 5010

4910Das Aktivieren eines Plugins aus einer externen Quelle wie einem GitHub-Repository oder npm-Paket in der `.claude/settings.json` eines Projekts installiert es nicht für andere Personen. Auf jedem Pfad, der Plugins lädt, meldet Claude Code das Plugin als nicht installiert, bis jeder Benutzer es selbst [installiert](/docs/de/plugins/org#require-plugins-per-repository).5011Das Aktivieren eines Plugins aus einer externen Quelle wie einem GitHub-Repository oder npm-Paket in der `.claude/settings.json` eines Projekts installiert es nicht für andere Personen. Auf jedem Pfad, der Plugins lädt, meldet Claude Code das Plugin als nicht installiert, bis jeder Benutzer es selbst [installiert](/docs/de/plugins/org#require-plugins-per-repository).

4911 5012

4956* **`git`**: jede Git-URL, mit `url`5057* **`git`**: jede Git-URL, mit `url`

4957* **`url`**: eine direkte URL zu einer `marketplace.json` Datei, mit `url` und optionalen `headers` und `headersHelper` für authentifizierten Zugriff. `headersHelper` benennt einen Befehl, der Header druckt, deren Werte zu kurzlebig sind, um in `headers` aufzulisten, und erfordert Claude Code v2.1.238 oder später5058* **`url`**: eine direkte URL zu einer `marketplace.json` Datei, mit `url` und optionalen `headers` und `headersHelper` für authentifizierten Zugriff. `headersHelper` benennt einen Befehl, der Header druckt, deren Werte zu kurzlebig sind, um in `headers` aufzulisten, und erfordert Claude Code v2.1.238 oder später

4958* **`file`**: ein lokaler Pfad zu einer `marketplace.json` Datei, mit `path`5059* **`file`**: ein lokaler Pfad zu einer `marketplace.json` Datei, mit `path`

4959* **`directory`**: ein lokaler Dateisystem-Pfad, mit `path`, nur für Entwicklung5060* **`directory`**: ein lokaler Dateisystem-Pfad, mit `path`. Verwenden Sie ihn für die Entwicklung oder für einen Marketplace, den Ihre Organisation [auf jedem Computer bereitstellt](/docs/de/plugins/mods/admin#install-your-organizations-mods).

4960* **`settings`**: ein Inline-Marketplace, der direkt in der Einstellungsdatei ohne ein gehostetes Repository deklariert ist, mit `name` und `plugins`5061* **`settings`**: ein Inline-Marketplace, der direkt in der Einstellungsdatei ohne ein gehostetes Repository deklariert ist, mit `name` und `plugins`

4961 5062

4962Der `git` Quellentyp funktioniert mit jedem Git-Hosting-Service, einschließlich selbst gehosteter GitLab und Bitbucket. Claude Code klont das Repository mit derselben Authentifizierung, die `git clone` auf diesem Computer verwenden würde: konfigurierte Credential-Helper oder SSH-Schlüssel. Ein Provider-Token wie `GITHUB_TOKEN` wird nur durch einen Credential-Helper wirksam, der ihn liest. Siehe [Private Repositories](/docs/de/plugins/host-marketplace#grant-access-to-a-private-marketplace) für Setup-Details.5063Der `git` Quellentyp funktioniert mit jedem Git-Hosting-Service, einschließlich selbst gehosteter GitLab und Bitbucket. Claude Code klont das Repository mit derselben Authentifizierung, die `git clone` auf diesem Computer verwenden würde: konfigurierte Credential-Helper oder SSH-Schlüssel. Ein Provider-Token wie `GITHUB_TOKEN` wird durch einen Credential-Helper wirksam, der ihn liest. Siehe [Private Repositories](/docs/de/plugins/host-marketplace#grant-access-to-a-private-marketplace) für Setup-Details.

4963 5064

4964Für `github` und `git` Quellen lädt Claude Code niemals [Git LFS](https://git-lfs.com) Inhalte herunter, wenn es das Marketplace-Repository klont, um es hinzuzufügen oder zu aktualisieren. LFS-verfolgte Dateien werden als Zeiger-Dateien ausgecheckt, und die Ausgabe zum Hinzufügen oder Aktualisieren meldet, wie viele.5065Für `github` und `git` Quellen lädt Claude Code niemals [Git LFS](https://git-lfs.com) Inhalte herunter, wenn es das Marketplace-Repository klont, um es hinzuzufügen oder zu aktualisieren. LFS-verfolgte Dateien werden als Zeiger-Dateien ausgecheckt, und die Ausgabe zum Hinzufügen oder Aktualisieren meldet, wie viele.

4965 5066

5043 5144

5044Claude Code ignoriert Projekt- und lokale Einträge, weil es diese Werte in Plugin-Hook-, MCP- und LSP-Konfigurationen ersetzt, und ein geklontes Repository darf sie nicht liefern. Vor v2.1.207 wurden auch Projekt- und lokale Einstellungen gelesen.5145Claude Code ignoriert Projekt- und lokale Einträge, weil es diese Werte in Plugin-Hook-, MCP- und LSP-Konfigurationen ersetzt, und ein geklontes Repository darf sie nicht liefern. Vor v2.1.207 wurden auch Projekt- und lokale Einstellungen gelesen.

5045 5146

5147<h3 id="prependplugins">

5148 `prependPlugins`

5149</h3>

5150

5151Listen Sie die verwalteten Plugins auf, deren [Mods](/docs/de/plugins/mods/overview) vor jedem Mod ausgeführt werden, den ein Benutzer installiert, in der aufgeführten Reihenfolge. Wenn Sie diesen Schlüssel in verwalteten Einstellungen setzen, nennen Sie `sec-default@builtin` in der Liste, um den integrierten Schutz beizubehalten. In verwalteten Einstellungen überspringt Claude Code eine ID, deren Plugin nicht als Plugin Ihrer Organisation gilt. Siehe [Mods Ihrer Organisation installieren und die Reihenfolge festlegen](/docs/de/plugins/mods/admin#install-your-organizations-mods) für diese Bedingungen und dafür, wie die beiden Reihenfolge-Schlüssel zusammenwirken.

5152

5153* **Bereich**: [`User or managed`](#scopes). Claude Code liest den Schlüssel aus verwalteten Einstellungen. Aus Benutzereinstellungen liest es den Schlüssel nur auf einem Computer ohne verwaltete Einstellungen und für einen Benutzer, der nicht mit einem Team- oder Enterprise-Plan angemeldet ist. In Projekt- und lokalen Einstellungen sowie in einer `--settings` Datei ignoriert es den Schlüssel.

5154* **Typ**: Array von `plugin-name@marketplace-name` Strings

5155* **Standard**: nicht gesetzt

5156

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

5158{

5159 "extraKnownMarketplaces": {

5160 "acme-tools": {

5161 "source": { "source": "directory", "path": "/opt/acme/claude-plugins" }

5162 }

5163 },

5164 "enabledPlugins": { "acme-guard@acme-tools": true },

5165 "prependPlugins": ["acme-guard@acme-tools", "sec-default@builtin"]

5166}

5167```

5168

5169<h3 id="appendplugins">

5170 `appendPlugins`

5171</h3>

5172

5173Listen Sie die verwalteten Plugins auf, deren [Mods](/docs/de/plugins/mods/overview) nach jedem Mod ausgeführt werden, den ein Benutzer installiert, in der aufgeführten Reihenfolge. Eine ID, die sowohl in `prependPlugins` als auch in `appendPlugins` aufgeführt ist, wird vorangestellt. In verwalteten Einstellungen überspringt Claude Code eine ID, deren Plugin nicht [als Plugin Ihrer Organisation gilt](/docs/de/plugins/mods/admin#install-your-organizations-mods).

5174

5175* **Bereich**: [`User or managed`](#scopes). Claude Code liest den Schlüssel aus verwalteten Einstellungen. Aus Benutzereinstellungen liest es den Schlüssel nur auf einem Computer ohne verwaltete Einstellungen und für einen Benutzer, der nicht mit einem Team- oder Enterprise-Plan angemeldet ist. In Projekt- und lokalen Einstellungen sowie in einer `--settings` Datei ignoriert es den Schlüssel.

5176* **Typ**: Array von `plugin-name@marketplace-name` Strings

5177* **Standard**: nicht gesetzt

5178

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

5180{

5181 "extraKnownMarketplaces": {

5182 "acme-tools": {

5183 "source": { "source": "directory", "path": "/opt/acme/claude-plugins" }

5184 }

5185 },

5186 "enabledPlugins": { "acme-audit@acme-tools": true },

5187 "appendPlugins": ["acme-audit@acme-tools"]

5188}

5189```

5190

5046<h2 id="mcp">5191<h2 id="mcp">

5047 MCP5192 MCP

5048</h2>5193</h2>

5055 5200

5056Laden Sie die [claude.ai-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai), die Claude Code selbst abruft, zusammen mit einer bereitgestellten `managed-mcp.json`. Ohne diesen Schlüssel übernimmt `managed-mcp.json` die ausschließliche Kontrolle über MCP-Server und unterdrückt diese Konnektoren.5201Laden Sie die [claude.ai-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai), die Claude Code selbst abruft, zusammen mit einer bereitgestellten `managed-mcp.json`. Ohne diesen Schlüssel übernimmt `managed-mcp.json` die ausschließliche Kontrolle über MCP-Server und unterdrückt diese Konnektoren.

5057 5202

5058* **Bereich**: [`Managed`](#scopes). Benutzer können Konnektoren, deren ausschließliche Kontrolle unterdrückt hat, nicht erneut aktivieren.5203* **Geltungsbereich**: [`Managed`](#scopes). Benutzer können Konnektoren, die durch die ausschließliche Kontrolle unterdrückt wurden, nicht erneut aktivieren.

5059* **Typ**: Boolean5204* **Typ**: Boolean

5060 * `true`: Claude Code lädt die claude.ai-Konnektoren zusammen mit einer bereitgestellten `managed-mcp.json`5205 * `true`: Claude Code lädt die claude.ai-Konnektoren zusammen mit einer bereitgestellten `managed-mcp.json`

5061 * `false`: eine bereitgestellte `managed-mcp.json` übernimmt die ausschließliche Kontrolle über MCP-Server und unterdrückt die claude.ai-Konnektoren, [die Claude Code selbst abruft](/docs/de/mcp#how-connectors-reach-claude-code)5206 * `false`: eine bereitgestellte `managed-mcp.json` übernimmt die ausschließliche Kontrolle über MCP-Server und unterdrückt die claude.ai-Konnektoren, [die Claude Code selbst abruft](/docs/de/mcp#how-connectors-reach-claude-code)

5069 5214

5070[`allowedMcpServers`](#allowedmcpservers) und [`deniedMcpServers`](#deniedmcpservers) gelten weiterhin für die Konnektoren, die dieser Schlüssel lädt. Konnektoren, die an eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) geliefert werden, deren Host eine `managed-mcp.json` trägt, wie z. B. einen selbstgehosteten Runner, bleiben unterdrückt. Siehe [claude.ai-Konnektoren neben dem verwalteten Satz zulassen](/docs/de/managed-mcp#allow-claude-ai-connectors-alongside-the-managed-set).5215[`allowedMcpServers`](#allowedmcpservers) und [`deniedMcpServers`](#deniedmcpservers) gelten weiterhin für die Konnektoren, die dieser Schlüssel lädt. Konnektoren, die an eine [Cloud-Sitzung](/docs/de/claude-code-on-the-web) geliefert werden, deren Host eine `managed-mcp.json` trägt, wie z. B. einen selbstgehosteten Runner, bleiben unterdrückt. Siehe [claude.ai-Konnektoren neben dem verwalteten Satz zulassen](/docs/de/managed-mcp#allow-claude-ai-connectors-alongside-the-managed-set).

5071 5216

5217<h3 id="allowclaudeinchromewithmanagedmcp">

5218 `allowClaudeInChromeWithManagedMcp`

5219</h3>

5220

5221Lassen Sie den integrierten [Claude in Chrome](/docs/de/chrome)-Server zusammen mit einer bereitgestellten `managed-mcp.json` laufen. Ohne diesen Schlüssel blockiert eine bereitgestellte `managed-mcp.json` Claude in Chrome in Terminal-Sitzungen. Erfordert Claude Code v2.1.282 oder später.

5222

5223* **Geltungsbereich**: [`Managed`](#scopes), nur aus den eigenen verwalteten Einstellungen des Geräts: einer per MDM bereitgestellten plist oder einem HKLM-Registrierungsschlüssel oder einer System-`managed-settings.json`-Datei. Claude Code ignoriert ihn in servergesteuerten Einstellungen, in der vom Benutzer beschreibbaren HKCU-Registrierung sowie in Benutzer- oder Projekteinstellungen.

5224* **Typ**: Boolean

5225 * `true`: der integrierte Claude in Chrome-Server kann zusammen mit einer bereitgestellten `managed-mcp.json` laufen

5226 * `false`: eine bereitgestellte `managed-mcp.json` blockiert Claude in Chrome in Terminal-Sitzungen

5227* **Standard**: `false`, daher blockiert eine bereitgestellte `managed-mcp.json` Claude in Chrome in Terminal-Sitzungen

5228

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

5230{

5231 "allowClaudeInChromeWithManagedMcp": true

5232}

5233```

5234

5235Ein [`deniedMcpServers`](#deniedmcpservers)-Eintrag für `claude-in-chrome` blockiert den Server auch bei aktiviertem Schlüssel weiterhin. Siehe [Claude in Chrome neben dem verwalteten Satz zulassen](/docs/de/managed-mcp#allow-claude-in-chrome-alongside-the-managed-set).

5236

5072<h3 id="allowedmcpservers">5237<h3 id="allowedmcpservers">

5073 `allowedMcpServers`5238 `allowedMcpServers`

5074</h3>5239</h3>

5075 5240

5076Erstellen Sie eine Zulassungsliste der MCP-Server, die Personen hinzufügen können. Claude Code blockiert jeden Server, der nicht mit einem Eintrag übereinstimmt, überall dort, wo er definiert ist, einschließlich Plugin-Server, Server, die mit `--mcp-config` übergeben werden, und Server von claude.ai.5241Erstellen Sie eine Allowlist der MCP-Server, die Personen hinzufügen können. Claude Code blockiert jeden Server, der nicht mit einem Eintrag übereinstimmt, überall dort, wo er definiert ist, einschließlich Plugin-Server, Server, die ein Benutzer mit `--mcp-config` übergibt, und Server von claude.ai.

5077 5242

5078Integrierte Server wie Claude in Chrome, der `ide`-Server, mit dem Claude Code sich in einer laufenden [VS Code](/docs/de/vs-code#the-built-in-ide-mcp-server)- oder [JetBrains](/docs/de/jetbrains#the-built-in-ide-mcp-server)-IDE verbindet, und Server, die die CLI selbst konfiguriert, sind von der Zulassungsliste ausgenommen, und die Ablehnungsliste gilt weiterhin für sie. In-Process-`type: "sdk"`-Server sind von beiden Listen ausgenommen; die [App, die die Sitzung gestartet hat](/docs/de/mcp#how-connectors-reach-claude-code), registriert sie.5243Integrierte Server wie Claude in Chrome, der `ide`-Server, mit dem Claude Code sich in einer laufenden [VS Code](/docs/de/vs-code#the-built-in-ide-mcp-server)- oder [JetBrains](/docs/de/jetbrains#the-built-in-ide-mcp-server)-IDE verbindet, und Server, die die CLI selbst konfiguriert, sind von der Allowlist ausgenommen, und die Denylist gilt weiterhin für sie. Ab Claude Code v2.1.268 sind auch die Slack-Tools einer [Claude Tag](/docs/de/claude-tag)-Sitzung von der Allowlist ausgenommen, und die Denylist gilt weiterhin für sie. In-Process-`type: "sdk"`-Server sind von beiden Listen ausgenommen; die [App, die die Sitzung gestartet hat](/docs/de/mcp#how-connectors-reach-claude-code), registriert sie.

5079 5244

5080Server, die Ihre Organisation bereitstellt, sind auch von der Zulassungsliste ausgenommen, und die Ablehnungsliste gilt weiterhin für sie. Die Ausnahme deckt jeden [`managedMcpServers`](#managedmcpservers)-Eintrag ab, und jeden [`managed-mcp.json`](/docs/de/managed-mcp#exclusive-control-with-managed-mcp-json)-Eintrag, dessen Werte keine `${VAR}`-Erweiterung verwenden. Siehe [Wie ein Server bewertet wird](/docs/de/managed-mcp#how-a-server-is-evaluated) für die vollständige Prüfreihenfolge. Vor v2.1.259 mussten Server aus `managed-mcp.json` auch übereinstimmen.5245Server, die Ihre Organisation bereitstellt, sind auch von der Allowlist ausgenommen, und die Denylist gilt weiterhin für sie. Die Ausnahme deckt jeden [`managedMcpServers`](#managedmcpservers)-Eintrag ab, und jeden [`managed-mcp.json`](/docs/de/managed-mcp#exclusive-control-with-managed-mcp-json)-Eintrag, dessen Werte keine `${VAR}`-Erweiterung verwenden. Siehe [Wie ein Server bewertet wird](/docs/de/managed-mcp#how-a-server-is-evaluated) für die vollständige Prüfreihenfolge. Vor v2.1.259 mussten Server aus `managed-mcp.json` auch übereinstimmen.

5081 5246

5082* **Bereich**: [`Any file`](#scopes). Einträge aus jeder Datei werden in eine Zulassungsliste zusammengeführt, es sei denn, [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) ist gesetzt. Stellen Sie es in verwalteten Einstellungen bereit, um es durchzusetzen.5247* **Geltungsbereich**: [`Any file`](#scopes). Einträge aus jeder Datei werden in eine Allowlist zusammengeführt, es sei denn, [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) ist gesetzt. Stellen Sie es in verwalteten Einstellungen bereit, um es durchzusetzen.

5083* **Typ**: Array von Objekten, jedes mit genau einem Schlüssel: `serverName`, ein String, der auf Buchstaben, Zahlen, Bindestriche und Unterstriche beschränkt ist; `serverCommand`, ein Array des Befehls und seiner Argumente, die genau übereinstimmen; oder `serverUrl`, ein URL-Muster mit `*`-Platzhaltern5248* **Typ**: Array von Objekten, jedes mit genau einem Schlüssel: `serverName`, ein String, der auf Buchstaben, Zahlen, Bindestriche und Unterstriche beschränkt ist; `serverCommand`, ein Array des Befehls und seiner Argumente, die genau übereinstimmen; oder `serverUrl`, ein URL-Muster mit `*`-Platzhaltern

5084* **Standard**: nicht gesetzt, daher ist jeder Server zulässig; ein leeres Array blockiert jeden Server, den Benutzer hinzufügen5249* **Standard**: nicht gesetzt, daher ist jeder Server zulässig; ein leeres Array blockiert jeden Server, den Benutzer hinzufügen

5085 5250

5093}5258}

5094```5259```

5095 5260

5096Ein [`deniedMcpServers`](#deniedmcpservers)-Eintrag hat Vorrang, daher wird ein Server auf beiden Listen blockiert. Sobald die Liste einen `serverCommand`-Eintrag enthält, muss ein stdio-Server mit einem `serverCommand`-Eintrag übereinstimmen, und sobald sie einen `serverUrl`-Eintrag enthält, muss ein Remote-Server mit einem `serverUrl`-Eintrag übereinstimmen: eine `serverName`-Übereinstimmung lässt diese Art von Server nicht mehr zu. Siehe [Richtlinienbasierte Kontrolle mit Zulassungs- und Ablehnungslisten](/docs/de/managed-mcp#policy-based-control-with-allowlists-and-denylists).5261Ein [`deniedMcpServers`](#deniedmcpservers)-Eintrag hat Vorrang, daher wird ein Server auf beiden Listen blockiert. Sobald die Liste einen `serverCommand`-Eintrag enthält, muss ein stdio-Server mit einem `serverCommand`-Eintrag übereinstimmen, und sobald sie einen `serverUrl`-Eintrag enthält, muss ein Remote-Server mit einem `serverUrl`-Eintrag übereinstimmen: eine `serverName`-Übereinstimmung lässt diese Art von Server nicht mehr zu. Siehe [Richtlinienbasierte Kontrolle mit Allowlists und Denylists](/docs/de/managed-mcp#policy-based-control-with-allowlists-and-denylists).

5097 5262

5098<h3 id="allowmanagedmcpserversonly">5263<h3 id="allowmanagedmcpserversonly">

5099 `allowManagedMcpServersOnly`5264 `allowManagedMcpServersOnly`

5100</h3>5265</h3>

5101 5266

5102Machen Sie die verwaltete Zulassungsliste zur einzigen, die gilt. Claude Code liest dann [`allowedMcpServers`](#allowedmcpservers) nur aus verwalteten Einstellungen und ignoriert Zulassungslisten in Benutzer-, Projekt- und lokalen Einstellungen; [`deniedMcpServers`](#deniedmcpservers) wird weiterhin aus jedem Einstellungsbereich zusammengeführt, daher können Benutzer weiterhin Server für sich selbst blockieren. Administratoren setzen es so, dass die eigenen Einstellungen eines Benutzers nicht erweitern können, was die verwaltete Zulassungsliste zulässt.5267Machen Sie die verwaltete Allowlist zur einzigen, die gilt. Claude Code liest dann [`allowedMcpServers`](#allowedmcpservers) nur aus verwalteten Einstellungen und ignoriert Allowlists in Benutzer-, Projekt- und lokalen Einstellungen; [`deniedMcpServers`](#deniedmcpservers) wird weiterhin aus jedem Geltungsbereich der Einstellungen zusammengeführt, daher können Benutzer weiterhin Server für sich selbst blockieren. Administratoren setzen es so, dass die eigenen Einstellungen eines Benutzers nicht erweitern können, was die verwaltete Allowlist zulässt.

5103 5268

5104* **Bereich**: [`Managed`](#scopes)5269* **Geltungsbereich**: [`Managed`](#scopes)

5105* **Typ**: Boolean5270* **Typ**: Boolean

5106 * `true`: Claude Code liest `allowedMcpServers` nur aus verwalteten Einstellungen und ignoriert Zulassungslisten in Benutzer-, Projekt- und lokalen Einstellungen5271 * `true`: Claude Code liest `allowedMcpServers` nur aus verwalteten Einstellungen und ignoriert Allowlists in Benutzer-, Projekt- und lokalen Einstellungen

5107 * `false`: Zulassungslisten aus jedem Einstellungsbereich werden zusammengeführt5272 * `false`: Allowlists aus jedem Geltungsbereich der Einstellungen werden zusammengeführt

5108* **Standard**: `false`, daher werden Zulassungslisten aus jedem Einstellungsbereich zusammengeführt5273* **Standard**: `false`, daher werden Allowlists aus jedem Geltungsbereich der Einstellungen zusammengeführt

5109 5274

5110Dieses Beispiel sperrt die Zulassungsliste auf verwaltete Einstellungen und erlaubt nur den Server namens `github`:5275Dieses Beispiel sperrt die Allowlist auf verwaltete Einstellungen und erlaubt nur den Server namens `github`:

5111 5276

5112```json managed-settings.json theme={null}5277```json managed-settings.json theme={null}

5113{5278{

5118}5283}

5119```5284```

5120 5285

5121Benutzer können weiterhin ihre eigenen MCP-Server hinzufügen; nur Server, die mit der verwalteten Zulassungsliste übereinstimmen, werden geladen. Siehe [Zulassungsliste auf verwaltete Einstellungen beschränken](/docs/de/managed-mcp#restrict-the-allowlist-to-managed-settings-only).5286Benutzer können weiterhin ihre eigenen MCP-Server hinzufügen; nur Server, die mit der verwalteten Allowlist übereinstimmen, werden geladen. Siehe [Allowlist auf verwaltete Einstellungen beschränken](/docs/de/managed-mcp#restrict-the-allowlist-to-managed-settings-only).

5122 5287

5123<h3 id="deniedmcpservers">5288<h3 id="deniedmcpservers">

5124 `deniedMcpServers`5289 `deniedMcpServers`

5126 5291

5127Blockieren Sie bestimmte MCP-Server. Claude Code weigert sich, einen übereinstimmenden Server zu laden, überall dort, wo er definiert ist, einschließlich Plugin-Server, Server, die mit `--mcp-config` übergeben werden, Server aus `managed-mcp.json`, Server aus [`managedMcpServers`](#managedmcpservers), und die claude.ai-Konnektoren, [die es selbst abruft](/docs/de/mcp#how-connectors-reach-claude-code). In-Process-`type: "sdk"`-Server sind ausgenommen; die App, die die Sitzung gestartet hat, registriert sie.5292Blockieren Sie bestimmte MCP-Server. Claude Code weigert sich, einen übereinstimmenden Server zu laden, überall dort, wo er definiert ist, einschließlich Plugin-Server, Server, die mit `--mcp-config` übergeben werden, Server aus `managed-mcp.json`, Server aus [`managedMcpServers`](#managedmcpservers), und die claude.ai-Konnektoren, [die es selbst abruft](/docs/de/mcp#how-connectors-reach-claude-code). In-Process-`type: "sdk"`-Server sind ausgenommen; die App, die die Sitzung gestartet hat, registriert sie.

5128 5293

5129* **Bereich**: [`Any file`](#scopes). Einträge aus jeder Datei werden in eine Ablehnungsliste zusammengeführt, und [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) ändert das nicht. Stellen Sie es in verwalteten Einstellungen bereit, um es durchzusetzen.5294* **Geltungsbereich**: [`Any file`](#scopes). Einträge aus jeder Datei werden in eine Denylist zusammengeführt, und [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) ändert das nicht. Stellen Sie es in verwalteten Einstellungen bereit, um es durchzusetzen.

5130* **Typ**: Array von Objekten, jedes mit genau einem Schlüssel: `serverName`, ein String, daher funktioniert der Anzeigename eines claude.ai-Konnektors wie `"claude.ai Slack"`; `serverCommand`, ein Array des Befehls und seiner Argumente, die genau übereinstimmen; oder `serverUrl`, ein URL-Muster mit `*`-Platzhaltern5295* **Typ**: Array von Objekten, jedes mit genau einem Schlüssel: `serverName`, ein String, daher funktioniert der Anzeigename eines claude.ai-Konnektors wie `"claude.ai Slack"`; `serverCommand`, ein Array des Befehls und seiner Argumente, die genau übereinstimmen; oder `serverUrl`, ein URL-Muster mit `*`-Platzhaltern

5131* **Standard**: nicht gesetzt, daher wird kein Server blockiert; ein leeres Array blockiert auch nichts5296* **Standard**: nicht gesetzt, daher wird kein Server blockiert; ein leeres Array blockiert auch nichts

5132 5297

5138}5303}

5139```5304```

5140 5305

5141Die Ablehnungsliste hat Vorrang vor [`allowedMcpServers`](#allowedmcpservers), daher wird ein Server auf beiden Listen blockiert. Siehe [Richtlinienbasierte Kontrolle mit Zulassungs- und Ablehnungslisten](/docs/de/managed-mcp#policy-based-control-with-allowlists-and-denylists).5306Die Denylist hat Vorrang vor [`allowedMcpServers`](#allowedmcpservers), daher wird ein Server auf beiden Listen blockiert. Siehe [Richtlinienbasierte Kontrolle mit Allowlists und Denylists](/docs/de/managed-mcp#policy-based-control-with-allowlists-and-denylists).

5142 5307

5143<h3 id="disableclaudeaiconnectors">5308<h3 id="disableclaudeaiconnectors">

5144 `disableClaudeAiConnectors`5309 `disableClaudeAiConnectors`

5146 5311

5147Schalten Sie die [claude.ai-MCP-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) aus, [die Claude Code selbst abruft](/docs/de/mcp#how-connectors-reach-claude-code), sodass es sie weder abruft noch verbindet. Ein `true` in einer beliebigen Einstellungsdatei gilt: eine eingecheckte Projekt-`.claude/settings.json` kann ein Repository von diesen Konnektoren abmelden, aber ein Projekt-Level-`false` kann ein Benutzer- oder verwaltetes Level-`true` nicht überschreiben.5312Schalten Sie die [claude.ai-MCP-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) aus, [die Claude Code selbst abruft](/docs/de/mcp#how-connectors-reach-claude-code), sodass es sie weder abruft noch verbindet. Ein `true` in einer beliebigen Einstellungsdatei gilt: eine eingecheckte Projekt-`.claude/settings.json` kann ein Repository von diesen Konnektoren abmelden, aber ein Projekt-Level-`false` kann ein Benutzer- oder verwaltetes Level-`true` nicht überschreiben.

5148 5313

5149* **Bereich**: [`Any file`](#scopes)5314* **Geltungsbereich**: [`Any file`](#scopes)

5150* **Typ**: Boolean5315* **Typ**: Boolean

5151 * `true`: Claude Code ruft diese Konnektoren weder ab noch verbindet sie5316 * `true`: Claude Code ruft diese Konnektoren weder ab noch verbindet sie

5152 * `false`: dasselbe wie nicht gesetzt; Claude Code ruft Ihre Konnektoren ab, es sei denn, eine andere Einstellungsdatei oder `ENABLE_CLAUDEAI_MCP_SERVERS` schaltet sie aus5317 * `false`: dasselbe wie nicht gesetzt; Claude Code ruft Ihre Konnektoren ab, es sei denn, eine andere Einstellungsdatei oder `ENABLE_CLAUDEAI_MCP_SERVERS` schaltet sie aus

5153* **Standard**: `false`, daher ruft Claude Code Ihre Konnektoren ab5318* **Standard**: `false`, daher ruft Claude Code Ihre Konnektoren ab

5154* **Pro-Sitzungs-Überschreibungen**: [`ENABLE_CLAUDEAI_MCP_SERVERS`](/docs/de/env-vars) auf `false` gesetzt schaltet Konnektoren für eine Sitzung aus; welcher der beiden sie ausschaltet, der andere kann sie nicht wieder einschalten5319* **Pro-Sitzungs-Überschreibungen**: [`ENABLE_CLAUDEAI_MCP_SERVERS`](/docs/de/env-vars) auf `false` gesetzt schaltet Konnektoren für eine Sitzung aus; welcher der beiden sie auch ausschaltet, der andere kann sie nicht wieder einschalten

5155 5320

5156```json settings.json theme={null}5321```json settings.json theme={null}

5157{5322{

5167 5332

5168Lehnen Sie bestimmte Server ab, die in der `.mcp.json`-Datei eines Projekts definiert sind, damit Claude Code sich nie mit ihnen verbindet oder Sie auffordert, sie zu genehmigen. Eine Ablehnung in einer beliebigen Einstellungsdatei gilt, einschließlich einer Projekt-`.claude/settings.json`, die in das Repository eingecheckt ist.5333Lehnen Sie bestimmte Server ab, die in der `.mcp.json`-Datei eines Projekts definiert sind, damit Claude Code sich nie mit ihnen verbindet oder Sie auffordert, sie zu genehmigen. Eine Ablehnung in einer beliebigen Einstellungsdatei gilt, einschließlich einer Projekt-`.claude/settings.json`, die in das Repository eingecheckt ist.

5169 5334

5170* **Bereich**: [`Any file`](#scopes)5335* **Geltungsbereich**: [`Any file`](#scopes)

5171* **Typ**: Array von Strings, die Servernamen, wie sie in `.mcp.json` erscheinen5336* **Typ**: Array von Strings, die Servernamen, wie sie in `.mcp.json` erscheinen

5172* **Standard**: nicht gesetzt5337* **Standard**: nicht gesetzt

5173 5338

5183 `enableAllProjectMcpServers`5348 `enableAllProjectMcpServers`

5184</h3>5349</h3>

5185 5350

5186Genehmigen Sie jeden MCP-Server, der in Projekt-`.mcp.json`-Dateien definiert ist, ohne eine Eingabeaufforderung. Claude Code schreibt diesen Schlüssel in `.claude/settings.local.json`, wenn Sie wählen, alle Server im Genehmigungsdialog zu genehmigen.5351Genehmigen Sie jeden MCP-Server, der in Projekt-`.mcp.json`-Dateien definiert ist, ohne Nachfrage. Claude Code schreibt diesen Schlüssel in `.claude/settings.local.json`, wenn Sie wählen, alle Server im Genehmigungsdialog zu genehmigen.

5187 5352

5188* **Bereich**: [`Any file`](#scopes). In einem Ordner, dessen Vertrauensdialog Sie nicht akzeptiert haben, berücksichtigt Claude Code ihn aus Benutzereinstellungen, verwalteten Einstellungen und `--settings` und ignoriert ihn in der gemeinsamen Projektdatei, sowohl in der Sitzung als auch für `claude mcp list` und `claude mcp get`; [Projektserver-Genehmigungen und Workspace-Vertrauen](/docs/de/mcp#project-server-approvals-and-workspace-trust) sagt, wann eine nicht nachverfollte `.claude/settings.local.json` auch zählt.5353* **Geltungsbereich**: [`Any file`](#scopes). In einem Ordner, dessen Vertrauensdialog Sie nicht akzeptiert haben, berücksichtigt Claude Code ihn aus Benutzereinstellungen, verwalteten Einstellungen und `--settings` und ignoriert ihn in der gemeinsamen Projektdatei, sowohl in der Sitzung als auch für `claude mcp list` und `claude mcp get`; [Projektserver-Genehmigungen und Workspace-Vertrauen](/docs/de/mcp#project-server-approvals-and-workspace-trust) beschreibt, wann eine nicht nachverfolgte `.claude/settings.local.json` ebenfalls zählt.

5189* **Typ**: Boolean5354* **Typ**: Boolean

5190 * `true`: Claude Code genehmigt jeden MCP-Server, der in Projekt-`.mcp.json`-Dateien definiert ist, ohne eine Eingabeaufforderung5355 * `true`: Claude Code genehmigt jeden MCP-Server, der in Projekt-`.mcp.json`-Dateien definiert ist, ohne Nachfrage

5191 * `false`: Claude Code fordert Sie auf, jeden Server zu genehmigen. In einem vertrauenswürdigen Ordner überschreibt ein `false` in einer Datei mit höherer Priorität ein `true` in einer niedrigeren; in einem Ordner, dem Sie nicht vertrauen, ist ein `true` in einer beliebigen berücksichtigten Datei ausreichend5356 * `false`: Claude Code fordert Sie auf, jeden Server zu genehmigen. In einem vertrauenswürdigen Ordner überschreibt ein `false` in einer Datei mit höherem Vorrang ein `true` in einer niedrigeren; in einem Ordner, dem Sie nicht vertrauen, ist ein `true` in einer beliebigen berücksichtigten Datei ausreichend

5192* **Standard**: nicht gesetzt, daher fordert Claude Code Sie auf, jeden Server zu genehmigen5357* **Standard**: nicht gesetzt, daher fordert Claude Code Sie auf, jeden Server zu genehmigen

5193 5358

5194```json settings.json theme={null}5359```json settings.json theme={null}

5205 5370

5206Genehmigen Sie bestimmte Server, die in Projekt-`.mcp.json`-Dateien definiert sind, damit Claude Code sich mit ihnen verbindet, ohne zu fragen. Claude Code schreibt diesen Schlüssel in `.claude/settings.local.json`, wenn Sie einen Server im Genehmigungsdialog genehmigen.5371Genehmigen Sie bestimmte Server, die in Projekt-`.mcp.json`-Dateien definiert sind, damit Claude Code sich mit ihnen verbindet, ohne zu fragen. Claude Code schreibt diesen Schlüssel in `.claude/settings.local.json`, wenn Sie einen Server im Genehmigungsdialog genehmigen.

5207 5372

5208* **Bereich**: [`Any file`](#scopes). In einem Ordner, dessen Vertrauensdialog Sie nicht akzeptiert haben, berücksichtigt Claude Code ihn aus Benutzereinstellungen, verwalteten Einstellungen und `--settings` und ignoriert ihn in der gemeinsamen Projektdatei, sowohl in der Sitzung als auch für `claude mcp list` und `claude mcp get`; [Projektserver-Genehmigungen und Workspace-Vertrauen](/docs/de/mcp#project-server-approvals-and-workspace-trust) sagt, wann eine nicht nachverfollte `.claude/settings.local.json` auch zählt.5373* **Geltungsbereich**: [`Any file`](#scopes). In einem Ordner, dessen Vertrauensdialog Sie nicht akzeptiert haben, berücksichtigt Claude Code ihn aus Benutzereinstellungen, verwalteten Einstellungen und `--settings` und ignoriert ihn in der gemeinsamen Projektdatei, sowohl in der Sitzung als auch für `claude mcp list` und `claude mcp get`; [Projektserver-Genehmigungen und Workspace-Vertrauen](/docs/de/mcp#project-server-approvals-and-workspace-trust) beschreibt, wann eine nicht nachverfolgte `.claude/settings.local.json` ebenfalls zählt.

5209* **Typ**: Array von Strings, die Servernamen, wie sie in `.mcp.json` erscheinen5374* **Typ**: Array von Strings, die Servernamen, wie sie in `.mcp.json` erscheinen

5210* **Standard**: nicht gesetzt5375* **Standard**: nicht gesetzt

5211 5376

5225 5390

5226Stellen Sie Remote-MCP-Server aus verwalteten Einstellungen für jeden Benutzer bereit. Benutzer behalten die Server, die sie selbst hinzufügen, und können die Server, die Sie bereitstellen, nicht bearbeiten oder entfernen. Erfordert Claude Code v2.1.259 oder später.5391Stellen Sie Remote-MCP-Server aus verwalteten Einstellungen für jeden Benutzer bereit. Benutzer behalten die Server, die sie selbst hinzufügen, und können die Server, die Sie bereitstellen, nicht bearbeiten oder entfernen. Erfordert Claude Code v2.1.259 oder später.

5227 5392

5228* **Bereich**: [`Managed`](#scopes). Claude Code verwirft den Schlüssel mit einer Warnung in Benutzer-, Projekt- und lokalen Einstellungen und liest ihn nicht in der Code-Registerkarte der Claude Desktop-App bei einer Drittanbieter-Bereitstellung oder in den Cowork-Sitzungen der App, wo Claude Desktop die MCP-Server dieser Sitzungen selbst bereitstellt und sperrt.5393* **Geltungsbereich**: [`Managed`](#scopes). Claude Code verwirft den Schlüssel mit einer Warnung in Benutzer-, Projekt- und lokalen Einstellungen und liest ihn nicht in der Code-Registerkarte der Claude Desktop-App bei einer Drittanbieter-Bereitstellung oder in den Cowork-Sitzungen der App, wo Claude Desktop die MCP-Server dieser Sitzungen selbst bereitstellt und sperrt.

5229* **Typ**: Objekt, das nach Servernamen verschlüsselt ist. Jeder Eintrag hat die `.mcp.json`-Form für einen `http`- oder `sse`-Server: eine erforderliche `https://` `url` und optional `headers`, `oauth` und die anderen HTTP- und SSE-Optionen. Claude Code verwirft Einträge, die die Validierung nicht bestehen, und [Was ein Eintrag enthalten kann](/docs/de/managed-mcp#what-an-entry-can-contain) listet die Bedingungen auf5394* **Typ**: Objekt, das nach Servernamen verschlüsselt ist. Jeder Eintrag hat die `.mcp.json`-Form für einen `http`- oder `sse`-Server: eine erforderliche `https://` `url` und optional `headers`, `oauth` und die anderen HTTP- und SSE-Optionen. Claude Code verwirft Einträge, die die Validierung nicht bestehen, und [Was ein Eintrag enthalten kann](/docs/de/managed-mcp#what-an-entry-can-contain) listet die Bedingungen auf

5230* **Standard**: nicht gesetzt, daher stellen verwaltete Einstellungen keine Server bereit5395* **Standard**: nicht gesetzt, daher stellen verwaltete Einstellungen keine Server bereit

5231 5396

5242}5407}

5243```5408```

5244 5409

5245Für Vorrang, wie bereitgestellte Server mit `managed-mcp.json` und den Zulassungs- und Ablehnungslisten kombiniert werden, und was Benutzer sehen, siehe [Server durch verwaltete Einstellungen bereitstellen](/docs/de/managed-mcp#provide-servers-through-managed-settings).5410Für Vorrang, wie bereitgestellte Server mit `managed-mcp.json` und den Allow- und Denylists kombiniert werden, und was Benutzer sehen, siehe [Server durch verwaltete Einstellungen bereitstellen](/docs/de/managed-mcp#provide-servers-through-managed-settings).

5246 5411

5247<h2 id="agents-sessions-and-worktrees">5412<h2 id="agents-sessions-and-worktrees">

5248 Agenten, Sitzungen und Worktrees5413 Agenten, Sitzungen und Worktrees

5496 5661

5497Erlauben Sie Claude, eine Push-Benachrichtigung an Ihr Telefon zu senden, wenn es entscheidet, dass dies sinnvoll ist, beispielsweise wenn eine lange Aufgabe abgeschlossen ist. Claude Code synchronisiert diese Wahl mit Ihrem Konto, und Push-Benachrichtigungen werden gesendet, während [Remote Control](/docs/de/remote-control) verbunden ist. Wird in `/config` als **Push wenn Claude entscheidet** angezeigt.5662Erlauben Sie Claude, eine Push-Benachrichtigung an Ihr Telefon zu senden, wenn es entscheidet, dass dies sinnvoll ist, beispielsweise wenn eine lange Aufgabe abgeschlossen ist. Claude Code synchronisiert diese Wahl mit Ihrem Konto, und Push-Benachrichtigungen werden gesendet, während [Remote Control](/docs/de/remote-control) verbunden ist. Wird in `/config` als **Push wenn Claude entscheidet** angezeigt.

5498 5663

5499* **Bereich**: [`Any file`](#scopes). Claude Code liest auch einen Wert, der von älteren Versionen in `~/.claude.json` hinterlassen wurde.5664* **Geltungsbereich**: [`Any file`](#scopes). Claude Code liest auch einen Wert, der von älteren Versionen in `~/.claude.json` hinterlassen wurde.

5500* **Typ**: Boolean5665* **Typ**: Boolean

5501 * `true`: Claude kann eine Push-Benachrichtigung an Ihr Telefon senden, wenn es entscheidet, dass dies sinnvoll ist5666 * `true`: Claude kann eine Push-Benachrichtigung an Ihr Telefon senden, wenn es entscheidet, dass dies sinnvoll ist

5502 * `false`: Claude sendet diese Benachrichtigungen nicht5667 * `false`: Claude sendet diese Benachrichtigungen nicht

5516 5681

5517Zeigen Sie eine einzeilige Sitzungszusammenfassung an, wenn Sie nach einigen Minuten Abwesenheit zum Terminal zurückkehren. Setzen Sie es auf `false` oder deaktivieren Sie **Sitzungszusammenfassung** in `/config`, um die Zusammenfassung zu deaktivieren.5682Zeigen Sie eine einzeilige Sitzungszusammenfassung an, wenn Sie nach einigen Minuten Abwesenheit zum Terminal zurückkehren. Setzen Sie es auf `false` oder deaktivieren Sie **Sitzungszusammenfassung** in `/config`, um die Zusammenfassung zu deaktivieren.

5518 5683

5519* **Bereich**: [`Any file`](#scopes)5684* **Geltungsbereich**: [`Any file`](#scopes)

5520* **Typ**: Boolean5685* **Typ**: Boolean

5521 * `true`: Sie sehen eine einzeilige Sitzungszusammenfassung, wenn Sie nach einigen Minuten Abwesenheit zurückkehren5686 * `true`: Sie sehen eine einzeilige Sitzungszusammenfassung, wenn Sie nach einigen Minuten Abwesenheit zurückkehren

5522 * `false`: Claude Code zeigt keine Zusammenfassung an5687 * `false`: Claude Code zeigt keine Zusammenfassung an

5523* **Standard**: nicht gesetzt, daher ist die Zusammenfassung aktiviert5688* **Standard**: nicht gesetzt, daher ist die Zusammenfassung aktiviert

5524* **Sitzungsspezifische Außerkraftsetzungen**: [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/docs/de/env-vars) hat Vorrang vor diesem Schlüssel für eine Sitzung, in beide Richtungen5689* **Sitzungsspezifische Überschreibungen**: [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/docs/de/env-vars) hat Vorrang vor diesem Schlüssel für eine Sitzung, in beide Richtungen

5525 5690

5526```json settings.json theme={null}5691```json settings.json theme={null}

5527{5692{

5529}5694}

5530```5695```

5531 5696

5532Claude Code zeigt die Zusammenfassung niemals im nicht-interaktiven Modus an.5697Claude Code zeigt die Zusammenfassung niemals im nicht interaktiven Modus an.

5533 5698

5534<h3 id="disableartifact">5699<h3 id="disableartifact">

5535 `disableArtifact`5700 `disableArtifact`

5541 5706

5542Verwenden Sie stattdessen [`enableArtifact`](#enableartifact), um das [Artifact](/docs/de/artifacts)-Tool auszuschalten, das Sitzungsausgaben als private Webseite auf claude.ai veröffentlicht. Wenn Sie die Zeile **Artifacts** in `/config` ausschalten, schreibt Claude Code `enableArtifact` in Ihre Benutzereinstellungen und löscht diesen Schlüssel.5707Verwenden Sie stattdessen [`enableArtifact`](#enableartifact), um das [Artifact](/docs/de/artifacts)-Tool auszuschalten, das Sitzungsausgaben als private Webseite auf claude.ai veröffentlicht. Wenn Sie die Zeile **Artifacts** in `/config` ausschalten, schreibt Claude Code `enableArtifact` in Ihre Benutzereinstellungen und löscht diesen Schlüssel.

5543 5708

5544* **Bereich**: [`Any file`](#scopes)5709* **Geltungsbereich**: [`Any file`](#scopes)

5545* **Typ**: Boolean5710* **Typ**: Boolean

5546 * `true`: Claude Code schaltet das Artifact-Tool für jede Sitzung aus, auf die die Datei zutrifft, und keine andere Datei schaltet es wieder ein. Vor v2.1.242 konnte eine Datei mit höherer Priorität eine `true` einer Datei mit niedrigerer Priorität überschreiben, anstatt dass der Schlüssel als Sperre fungiert5711 * `true`: Claude Code schaltet das Artifact-Tool für jede Sitzung aus, auf die die Datei zutrifft, und keine andere Datei schaltet es wieder ein

5547 * `false`: ignoriert; um das Tool eingeschaltet zu lassen, entfernen Sie den Schlüssel5712 * `false`: ignoriert; um das Tool eingeschaltet zu lassen, entfernen Sie den Schlüssel

5548* **Standard**: nicht gesetzt, daher folgt das Tool Ihrer Konto-[Verfügbarkeit](/docs/de/artifacts#availability)5713* **Standard**: nicht gesetzt, daher folgt das Tool Ihrer Konto-[Verfügbarkeit](/docs/de/artifacts#availability)

5549* **Sitzungsspezifische Außerkraftsetzungen**: [`CLAUDE_CODE_DISABLE_ARTIFACT`](/docs/de/env-vars) auf `1` gesetzt schaltet das Tool für eine Sitzung aus5714* **Sitzungsspezifische Überschreibungen**: [`CLAUDE_CODE_DISABLE_ARTIFACT`](/docs/de/env-vars) auf `1` gesetzt schaltet das Tool für eine Sitzung aus

5550 5715

5551```json settings.json theme={null}5716```json settings.json theme={null}

5552{5717{

5562 5727

5563Verhindern Sie, dass Claude Code den `claude-cli://`-Protokoll-Handler beim Betriebssystem registriert, was es ansonsten nach dem ersten Prompt einer interaktiven Sitzung tut. [Deep Links](/docs/de/deep-links) ermöglichen es externen Tools, eine Claude Code-Sitzung mit einem vorausgefüllten Prompt zu öffnen. Setzen Sie dies in Umgebungen, in denen die Registrierung von Protokoll-Handlern eingeschränkt oder separat verwaltet wird.5728Verhindern Sie, dass Claude Code den `claude-cli://`-Protokoll-Handler beim Betriebssystem registriert, was es ansonsten nach dem ersten Prompt einer interaktiven Sitzung tut. [Deep Links](/docs/de/deep-links) ermöglichen es externen Tools, eine Claude Code-Sitzung mit einem vorausgefüllten Prompt zu öffnen. Setzen Sie dies in Umgebungen, in denen die Registrierung von Protokoll-Handlern eingeschränkt oder separat verwaltet wird.

5564 5729

5565* **Bereich**: [`Any file`](#scopes)5730* **Geltungsbereich**: [`Any file`](#scopes)

5566* **Typ**: die Zeichenkette `"disable"`5731* **Typ**: die Zeichenkette `"disable"`

5567* **Standard**: nicht gesetzt, daher registriert Claude Code den Handler5732* **Standard**: nicht gesetzt, daher registriert Claude Code den Handler

5568 5733

5578 5743

5579Schalten Sie Code-Sitzungen aus, die auf dem Gerät in der [Desktop-App](/docs/de/desktop#local-sessions-on-managed-devices) ausgeführt werden, für Bereitstellungen, bei denen Entwickler auf Remote-Maschinen über SSH arbeiten sollten. In der Code-Registerkarte bleibt die **Local**-Umgebung in der Umgebungs-Dropdown-Liste, ist aber ausgegraut und kann nicht ausgewählt werden, mit einem Tooltip, das besagt, dass Ihre Organisation sie deaktiviert hat; unter Windows ist der WSL-Eintrag auf die gleiche Weise ausgegraut, obwohl ob WSL-Sitzungen auf einem verwalteten Gerät überhaupt ausgeführt werden, [separat geregelt wird](/docs/de/admin-setup#wsl-sessions-in-claude-code-desktop). Neue Sitzungen werden standardmäßig auf die erste [SSH-Verbindung](/docs/de/desktop#ssh-sessions) gesetzt, falls eine konfiguriert ist, und die App weigert sich, eine Sitzung auf dem Gerät zu starten oder fortzusetzen, einschließlich einer SSH-Verbindung zurück zur gleichen Maschine. SSH-Sitzungen zu anderen Hosts und Cloud-Sitzungen sind nicht betroffen. Die Desktop-App liest diesen Schlüssel; die Terminal-CLI ignoriert ihn. Erfordert Claude Desktop v1.37937.0 oder später.5744Schalten Sie Code-Sitzungen aus, die auf dem Gerät in der [Desktop-App](/docs/de/desktop#local-sessions-on-managed-devices) ausgeführt werden, für Bereitstellungen, bei denen Entwickler auf Remote-Maschinen über SSH arbeiten sollten. In der Code-Registerkarte bleibt die **Local**-Umgebung in der Umgebungs-Dropdown-Liste, ist aber ausgegraut und kann nicht ausgewählt werden, mit einem Tooltip, das besagt, dass Ihre Organisation sie deaktiviert hat; unter Windows ist der WSL-Eintrag auf die gleiche Weise ausgegraut, obwohl ob WSL-Sitzungen auf einem verwalteten Gerät überhaupt ausgeführt werden, [separat geregelt wird](/docs/de/admin-setup#wsl-sessions-in-claude-code-desktop). Neue Sitzungen werden standardmäßig auf die erste [SSH-Verbindung](/docs/de/desktop#ssh-sessions) gesetzt, falls eine konfiguriert ist, und die App weigert sich, eine Sitzung auf dem Gerät zu starten oder fortzusetzen, einschließlich einer SSH-Verbindung zurück zur gleichen Maschine. SSH-Sitzungen zu anderen Hosts und Cloud-Sitzungen sind nicht betroffen. Die Desktop-App liest diesen Schlüssel; die Terminal-CLI ignoriert ihn. Erfordert Claude Desktop v1.37937.0 oder später.

5580 5745

5581* **Bereich**: [`Managed`](#scopes)5746* **Geltungsbereich**: [`Managed`](#scopes)

5582* **Typ**: Boolean; nur der JSON-Boolean `true` hat Auswirkungen5747* **Typ**: Boolean; nur der JSON-Boolean `true` hat Auswirkungen

5583 * `true`: die Desktop-App bietet keine Code-Sitzungen auf dem Gerät an; vorhandene lokale Sitzungen bleiben aufgelistet, können aber nicht fortgesetzt werden5748 * `true`: die Desktop-App bietet keine Code-Sitzungen auf dem Gerät an; vorhandene lokale Sitzungen bleiben aufgelistet, können aber nicht fortgesetzt werden

5584 * `false`: lokale Sitzungen bleiben verfügbar5749 * `false`: lokale Sitzungen bleiben verfügbar

5600 5765

5601Schalten Sie [Remote Control](/docs/de/remote-control) aus: Claude Code lehnt dann `claude remote-control`, das Flag `--remote-control`, Auto-Start und den In-Session-Toggle ab und meldet, dass die Richtlinie Ihrer Organisation es deaktiviert hat. Platzieren Sie es in [verwalteten Einstellungen](/docs/de/managed-settings) für die MDM-Durchsetzung pro Gerät.5766Schalten Sie [Remote Control](/docs/de/remote-control) aus: Claude Code lehnt dann `claude remote-control`, das Flag `--remote-control`, Auto-Start und den In-Session-Toggle ab und meldet, dass die Richtlinie Ihrer Organisation es deaktiviert hat. Platzieren Sie es in [verwalteten Einstellungen](/docs/de/managed-settings) für die MDM-Durchsetzung pro Gerät.

5602 5767

5603* **Bereich**: [`Any file`](#scopes)5768* **Geltungsbereich**: [`Any file`](#scopes)

5604* **Typ**: Boolean5769* **Typ**: Boolean

5605 * `true`: Claude Code lehnt `claude remote-control`, das Flag `--remote-control`, Auto-Start und den In-Session-Toggle ab5770 * `true`: Claude Code lehnt `claude remote-control`, das Flag `--remote-control`, Auto-Start und den In-Session-Toggle ab

5606 * `false`: Remote Control bleibt verfügbar5771 * `false`: Remote Control bleibt verfügbar

5618 5783

5619Schalten Sie das [Artifact](/docs/de/artifacts)-Tool aus, das Sitzungsausgaben als private Webseite auf claude.ai veröffentlicht. Wenn Sie die Zeile **Artifacts** in `/config` ausschalten, schreibt Claude Code diesen Schlüssel in Ihre Benutzereinstellungen, daher bearbeiten Sie ihn normalerweise nicht von Hand. Erfordert Claude Code v2.1.196 oder später.5784Schalten Sie das [Artifact](/docs/de/artifacts)-Tool aus, das Sitzungsausgaben als private Webseite auf claude.ai veröffentlicht. Wenn Sie die Zeile **Artifacts** in `/config` ausschalten, schreibt Claude Code diesen Schlüssel in Ihre Benutzereinstellungen, daher bearbeiten Sie ihn normalerweise nicht von Hand. Erfordert Claude Code v2.1.196 oder später.

5620 5785

5621* **Bereich**: [`Any file`](#scopes). Jede Datei kann das Tool ausschalten, und keine kann es wieder einschalten.5786* **Geltungsbereich**: [`Any file`](#scopes). Jede Datei kann das Tool ausschalten, und keine kann es wieder einschalten.

5622* **Typ**: Boolean5787* **Typ**: Boolean

5623 * `false`: Claude Code schaltet das Artifact-Tool für jede Sitzung aus, auf die die Datei zutrifft5788 * `false`: Claude Code schaltet das Artifact-Tool für jede Sitzung aus, auf die die Datei zutrifft

5624 * `true`: dasselbe wie das Weglassen des Schlüssels, da es niemals eine `false` aus einer anderen Datei, von [`CLAUDE_CODE_DISABLE_ARTIFACT`](/docs/de/env-vars) oder von der [Admin-Einstellung](/docs/de/artifacts#manage-artifacts-for-your-organization) Ihrer Organisation überschreibt5789 * `true`: dasselbe wie das Weglassen des Schlüssels, da es niemals ein `false` aus einer anderen Datei, von [`CLAUDE_CODE_DISABLE_ARTIFACT`](/docs/de/env-vars) oder von der [Admin-Einstellung](/docs/de/artifacts#manage-artifacts-for-your-organization) Ihrer Organisation überschreibt

5625* **Standard**: nicht gesetzt, daher folgt das Tool Ihrer Konto-[Verfügbarkeit](/docs/de/artifacts#availability)5790* **Standard**: nicht gesetzt, daher folgt das Tool Ihrer Konto-[Verfügbarkeit](/docs/de/artifacts#availability)

5626 5791

5627```json settings.json theme={null}5792```json settings.json theme={null}

5630}5795}

5631```5796```

5632 5797

5633Während eine andere Quelle als Ihre eigenen Benutzereinstellungen das Tool ausgeschaltet hält, versteckt Claude Code die Zeile **Artifacts** in `/config`, da das Einschalten dort nichts ändern würde. [Artifacts deaktivieren](/docs/de/artifacts#disable-artifacts) listet alle Möglichkeiten auf, das Tool auszuschalten. Vor v2.1.242 ignorierte Claude Code diesen Schlüssel in Projekt- und lokalen Einstellungen, und eine Datei höher im [Prioritätsstapel](/docs/de/settings#settings-precedence) konnte das Tool über eine niedrigere Datei mit Aus wieder einschalten.5798Während eine andere Quelle als Ihre eigenen Benutzereinstellungen das Tool ausgeschaltet hält, versteckt Claude Code die Zeile **Artifacts** in `/config`, da das Einschalten dort nichts ändern würde. [Artifacts deaktivieren](/docs/de/artifacts#disable-artifacts) listet alle Möglichkeiten auf, das Tool auszuschalten.

5634 5799

5635<h3 id="inputneedednotifenabled">5800<h3 id="inputneedednotifenabled">

5636 `inputNeededNotifEnabled`5801 `inputNeededNotifEnabled`

5637</h3>5802</h3>

5638 5803

5639Erhalten Sie eine Push-Benachrichtigung auf Ihrem Telefon, wenn eine Berechtigungsaufforderung oder Frage auf Ihre Eingabe wartet. Claude Code sendet diese nur, während [Remote Control](/docs/de/remote-control) verbunden ist. Wird in `/config` als **Push wenn Aktionen erforderlich sind** angezeigt.5804Erhalten Sie eine Push-Benachrichtigung auf Ihrem Telefon, wenn eine Berechtigungsabfrage oder Frage auf Ihre Eingabe wartet. Claude Code sendet diese nur, während [Remote Control](/docs/de/remote-control) verbunden ist. Wird in `/config` als **Push wenn Aktionen erforderlich sind** angezeigt.

5640 5805

5641* **Bereich**: [`Any file`](#scopes). Claude Code liest auch einen Wert, der von älteren Versionen in `~/.claude.json` hinterlassen wurde.5806* **Geltungsbereich**: [`Any file`](#scopes). Claude Code liest auch einen Wert, der von älteren Versionen in `~/.claude.json` hinterlassen wurde.

5642* **Typ**: Boolean5807* **Typ**: Boolean

5643 * `true`: Sie erhalten eine Push-Benachrichtigung auf Ihrem Telefon, wenn eine Berechtigungsaufforderung oder Frage wartet, während Remote Control verbunden ist5808 * `true`: Sie erhalten eine Push-Benachrichtigung auf Ihrem Telefon, wenn eine Berechtigungsabfrage oder Frage wartet, während Remote Control verbunden ist

5644 * `false`: Claude Code sendet keine solchen Benachrichtigungen5809 * `false`: Claude Code sendet keine solchen Benachrichtigungen

5645* **Standard**: `false`5810* **Standard**: `false`

5646 5811

5656 `preferredNotifChannel`5821 `preferredNotifChannel`

5657</h3>5822</h3>

5658 5823

5659Wählen Sie, wie Claude Code Sie benachrichtigt, wenn eine Aufgabe abgeschlossen ist oder eine Berechtigungsaufforderung wartet. Wird in `/config` als **Lokale Benachrichtigungen** angezeigt.5824Wählen Sie, wie Claude Code Sie benachrichtigt, wenn eine Aufgabe abgeschlossen ist oder eine Berechtigungsabfrage wartet. Wird in `/config` als **Lokale Benachrichtigungen** angezeigt.

5660 5825

5661* **Bereich**: [`Any file`](#scopes). Claude Code liest auch einen Wert, der von älteren Versionen in `~/.claude.json` hinterlassen wurde.5826* **Geltungsbereich**: [`Any file`](#scopes). Claude Code liest auch einen Wert, der von älteren Versionen in `~/.claude.json` hinterlassen wurde.

5662* **Typ**: Zeichenkette, eine von:5827* **Typ**: Zeichenkette, eine von:

5663 * `"auto"`: Claude Code sendet eine Desktop-Benachrichtigung in iTerm2, Ghostty und Kitty, läutet die Glocke in Terminal.app nur, wenn die audible Glocke ausgeschaltet ist, und tut nichts anderswo5828 * `"auto"`: Claude Code sendet eine Desktop-Benachrichtigung in iTerm2, Ghostty und Kitty, läutet die Glocke in Terminal.app nur, wenn dessen hörbare Glocke ausgeschaltet ist, und tut anderswo nichts

5664 * `"terminal_bell"`: Claude Code läutet das Glockensignal in jedem Terminal5829 * `"terminal_bell"`: Claude Code läutet das Glockensignal in jedem Terminal

5665 * `"iterm2"`: Claude Code sendet eine iTerm2-Desktop-Benachrichtigung5830 * `"iterm2"`: Claude Code sendet eine iTerm2-Desktop-Benachrichtigung

5666 * `"iterm2_with_bell"`: Claude Code sendet eine iTerm2-Desktop-Benachrichtigung und läutet die Glocke5831 * `"iterm2_with_bell"`: Claude Code sendet eine iTerm2-Desktop-Benachrichtigung und läutet die Glocke

5675}5840}

5676```5841```

5677 5842

5678Mit `"auto"` sendet Claude Code eine Desktop-Benachrichtigung in iTerm2, Ghostty und Kitty. In Terminal.app läutet es das Glockensignal nur, wenn Sie die audible Glocke von Terminal ausgeschaltet haben, und in anderen Terminals tut es nichts. Setzen Sie `"terminal_bell"`, um das Glockensignal in jedem Terminal zu läuten. Siehe [Erhalten Sie eine Terminal-Glocke oder Benachrichtigung](/docs/de/terminal-config#get-a-terminal-bell-or-notification).5843Mit `"auto"` sendet Claude Code eine Desktop-Benachrichtigung in iTerm2, Ghostty und Kitty. In Terminal.app läutet es das Glockensignal nur, wenn Sie die hörbare Glocke von Terminal ausgeschaltet haben, und in anderen Terminals tut es nichts. Setzen Sie `"terminal_bell"`, um das Glockensignal in jedem Terminal zu läuten. Siehe [Erhalten Sie eine Terminal-Glocke oder Benachrichtigung](/docs/de/terminal-config#get-a-terminal-bell-or-notification).

5679 5844

5680<h3 id="remote-defaultenvironmentid">5845<h3 id="remote-defaultenvironmentid">

5681 `remote.defaultEnvironmentId`5846 `remote.defaultEnvironmentId`

5683 5848

5684Wählen Sie die Standard-[Cloud-Umgebung](/docs/de/cloud-environments) für Cloud-Sitzungen, die Sie von der CLI aus erstellen, z. B. mit `claude --cloud`. Claude Code schreibt diesen Schlüssel in Ihre Benutzereinstellungen, wenn Sie eine Umgebung mit [`/remote-env`](/docs/de/cloud-environments#select-an-environment-from-the-cli) auswählen.5849Wählen Sie die Standard-[Cloud-Umgebung](/docs/de/cloud-environments) für Cloud-Sitzungen, die Sie von der CLI aus erstellen, z. B. mit `claude --cloud`. Claude Code schreibt diesen Schlüssel in Ihre Benutzereinstellungen, wenn Sie eine Umgebung mit [`/remote-env`](/docs/de/cloud-environments#select-an-environment-from-the-cli) auswählen.

5685 5850

5686* **Bereich**: [`Any file`](#scopes). Für eine selbstgehostete Umgebungs-ID nur Benutzer- oder verwaltete Einstellungen oder das Flag `--settings`.5851* **Geltungsbereich**: [`Any file`](#scopes). Für eine selbstgehostete Umgebungs-ID nur Benutzer- oder verwaltete Einstellungen oder das Flag `--settings`.

5687* **Typ**: Zeichenkette, eine Umgebungs-ID wie `env_...` oder `ccpool_...`5852* **Typ**: Zeichenkette, eine Umgebungs-ID wie `env_...` oder `ccpool_...`

5688* **Standard**: nicht gesetzt, daher verwendet Claude Code die von Anthropic gehostete Umgebung, wenn Ihre Liste eine hat, und ansonsten die erste Umgebung in Ihrer Liste, die keine [Remote Control Bridge-Umgebung](/docs/de/cloud-environments#the-default-environment) ist, oder die erste Umgebung, wenn jede eine Bridge-Umgebung ist5853* **Standard**: nicht gesetzt, daher verwendet Claude Code die von Anthropic gehostete Umgebung, wenn Ihre Liste eine hat, und ansonsten die erste Umgebung in Ihrer Liste, die keine [Remote-Control-Bridge-Umgebung](/docs/de/cloud-environments#the-default-environment) ist, oder die erste Umgebung, wenn jede eine Bridge-Umgebung ist

5689* **Sitzungsspezifische Außerkraftsetzungen**: `--environment` hat Vorrang vor diesem Schlüssel für die eine Cloud-Sitzung, die es erstellt5854* **Sitzungsspezifische Überschreibungen**: `--environment` hat Vorrang vor diesem Schlüssel für die eine Cloud-Sitzung, die es erstellt

5690 5855

5691```json settings.json theme={null}5856```json settings.json theme={null}

5692{5857{

5696}5861}

5697```5862```

5698 5863

5699Eine von Anthropic gehostete Umgebungs-ID, die mit `env_` beginnt, folgt der Standard-Einstellungspriorität, daher überschreibt ein Wert in den Projekteinstellungen eines Repositorys Ihre Auswahl auf Benutzerebene. Eine [selbstgehostete Umgebungs](/docs/de/self-hosted-environments)-ID, die mit `ccpool_` beginnt, wird nur aus Benutzereinstellungen, verwalteten Einstellungen und dem Flag `--settings` berücksichtigt; Claude Code ignoriert eine in den Projekt- oder lokalen Einstellungen eines Repositorys, und `/remote-env` zeigt, welcher Wert ignoriert wurde, daher kann eine eingecheckte Datei Sitzungen nicht auf eine selbstgehostete Umgebung lenken, die Sie nicht ausgewählt haben.5864Eine von Anthropic gehostete Umgebungs-ID, die mit `env_` beginnt, folgt der Standard-Rangfolge der Einstellungen, daher überschreibt ein Wert in den Projekteinstellungen eines Repositorys Ihre Auswahl auf Benutzerebene. Eine [selbstgehostete Umgebungs](/docs/de/self-hosted-environments)-ID, die mit `ccpool_` beginnt, wird nur aus Benutzereinstellungen, verwalteten Einstellungen und dem Flag `--settings` berücksichtigt; Claude Code ignoriert eine in den Projekt- oder lokalen Einstellungen eines Repositorys, und `/remote-env` zeigt, welcher Wert ignoriert wurde, daher kann eine eingecheckte Datei Sitzungen nicht auf eine selbstgehostete Umgebung lenken, die Sie nicht ausgewählt haben.

5700 5865

5701<h3 id="remotecontrolatstartup">5866<h3 id="remotecontrolatstartup">

5702 `remoteControlAtStartup`5867 `remoteControlAtStartup`

5704 5869

5705Verbinden Sie [Remote Control](/docs/de/remote-control) automatisch, wenn jede interaktive Sitzung startet, anstatt auf `/remote-control` zu warten. Setzen Sie es auf `true`, um Auto-Connect einzuschalten, `false`, um es auszuschalten. Wird in `/config` als **Remote Control für alle Sitzungen aktivieren** angezeigt.5870Verbinden Sie [Remote Control](/docs/de/remote-control) automatisch, wenn jede interaktive Sitzung startet, anstatt auf `/remote-control` zu warten. Setzen Sie es auf `true`, um Auto-Connect einzuschalten, `false`, um es auszuschalten. Wird in `/config` als **Remote Control für alle Sitzungen aktivieren** angezeigt.

5706 5871

5707* **Bereich**: [`Any file`](#scopes). Claude Code liest auch einen Wert, der von älteren Versionen in `~/.claude.json` hinterlassen wurde.5872* **Geltungsbereich**: [`Any file`](#scopes). Claude Code liest auch einen Wert, der von älteren Versionen in `~/.claude.json` hinterlassen wurde.

5708* **Typ**: Boolean5873* **Typ**: Boolean

5709 * `true`: Claude Code verbindet Remote Control automatisch, wenn jede interaktive Sitzung startet5874 * `true`: Claude Code verbindet Remote Control automatisch, wenn jede interaktive Sitzung startet

5710 * `false`: Claude Code wartet auf `/remote-control`5875 * `false`: Claude Code wartet auf `/remote-control`

5711* **Standard**: nicht gesetzt, daher folgt Auto-Connect dem Admin-Standard Ihrer Organisation, wenn einer gesetzt ist, und ansonsten dem aktuellen Standard von Claude Code5876* **Standard**: nicht gesetzt, daher gilt der [Auto-Connect-Standard](/docs/de/remote-control#enable-remote-control-for-all-sessions)

5712* **Sitzungsspezifische Außerkraftsetzungen**: `--remote-control` schaltet Remote Control für eine Sitzung ein, auch wenn dieser Schlüssel `false` ist, und kein Flag schaltet es für eine Sitzung aus5877* **Sitzungsspezifische Überschreibungen**: `--remote-control` schaltet Remote Control für eine Sitzung ein, auch wenn dieser Schlüssel `false` ist, und kein Flag schaltet es für eine Sitzung aus

5713 5878

5714```json settings.json theme={null}5879```json settings.json theme={null}

5715{5880{

5717}5882}

5718```5883```

5719 5884

5720Claude Code ignoriert eine `true` aus Projekt- oder lokalen Einstellungen, daher kann ein Repository Auto-Connect für seinen Checkout ausschalten, aber nicht einschalten. Für das vollständige Pro-Scope-Verhalten siehe [Remote Control für alle Sitzungen aktivieren](/docs/de/remote-control#enable-remote-control-for-all-sessions) und die [Sicherheitsschlüssel, bei denen der strengere Wert gilt](/docs/de/settings#security-keys-where-the-stricter-value-applies).5885Claude Code ignoriert ein `true` aus Projekt- oder lokalen Einstellungen, daher kann ein Repository Auto-Connect für seinen Checkout ausschalten, aber nicht einschalten. Für das vollständige Verhalten pro Geltungsbereich siehe [Remote Control für alle Sitzungen aktivieren](/docs/de/remote-control#enable-remote-control-for-all-sessions) und die [Sicherheitsschlüssel, bei denen der strengere Wert gilt](/docs/de/settings#security-keys-where-the-stricter-value-applies).

5721 5886

5722<h3 id="sshconfigs">5887<h3 id="sshconfigs">

5723 `sshConfigs`5888 `sshConfigs`

5725 5890

5726Fügen Sie SSH-Verbindungen zur [Desktop](/docs/de/desktop#pre-configure-ssh-connections-for-your-team)-Umgebungs-Dropdown hinzu. Administratoren verwenden es, um gemeinsame Verbindungen an ein Team zu verteilen. Verbindungen, die Sie in verwalteten Einstellungen definieren, werden als verwaltet angezeigt, daher können Benutzer sie auswählen, aber nicht bearbeiten oder löschen in der App.5891Fügen Sie SSH-Verbindungen zur [Desktop](/docs/de/desktop#pre-configure-ssh-connections-for-your-team)-Umgebungs-Dropdown hinzu. Administratoren verwenden es, um gemeinsame Verbindungen an ein Team zu verteilen. Verbindungen, die Sie in verwalteten Einstellungen definieren, werden als verwaltet angezeigt, daher können Benutzer sie auswählen, aber nicht bearbeiten oder löschen in der App.

5727 5892

5728* **Bereich**: [`User or managed`](#scopes). Die Desktop-App liest diesen Schlüssel.5893* **Geltungsbereich**: [`User or managed`](#scopes). Die Desktop-App liest diesen Schlüssel.

5729* **Typ**: Array von Objekten, jedes mit erforderlichen `id`, `name` und `sshHost` und optionalen `sshPort` und `sshIdentityFile`5894* **Typ**: Array von Objekten, jedes mit erforderlichen `id`, `name` und `sshHost` und optionalen `sshPort` und `sshIdentityFile`

5730* **Standard**: nicht gesetzt5895* **Standard**: nicht gesetzt

5731 5896

5747 `sshHostAllowlist`5912 `sshHostAllowlist`

5748</h3>5913</h3>

5749 5914

5750Begrenzen Sie die Hosts, mit denen sich eine [Desktop SSH-Sitzung](/docs/de/desktop#restrict-which-ssh-hosts-users-can-connect-to) verbinden kann. Nur die Desktop-App liest diesen Schlüssel; die CLI nicht. Muster sind Groß-/Kleinschreibung-insensitiv: `*` passt auf jeden Host, `*.example.com` passt auf `example.com` und jede Subdomain, und alles andere ist eine genaue Übereinstimmung mit dem Hostnamen nach `~/.ssh/config`-Auflösung. Ein leeres Array schaltet SSH-Sitzungen aus.5915Begrenzen Sie die Hosts, mit denen sich eine [Desktop-SSH-Sitzung](/docs/de/desktop#restrict-which-ssh-hosts-users-can-connect-to) verbinden kann. Nur die Desktop-App liest diesen Schlüssel; die CLI nicht. Bei Mustern wird die Groß-/Kleinschreibung nicht beachtet: `*` passt auf jeden Host, `*.example.com` passt auf `example.com` und jede Subdomain, und alles andere ist eine genaue Übereinstimmung mit dem Hostnamen nach `~/.ssh/config`-Auflösung. Ein leeres Array schaltet SSH-Sitzungen aus.

5751 5916

5752* **Bereich**: [`Managed`](#scopes)5917* **Geltungsbereich**: [`Managed`](#scopes)

5753* **Typ**: Array von Hostnamen-Mustern5918* **Typ**: Array von Hostnamen-Mustern

5754* **Standard**: nicht gesetzt, daher ist jeder Host erlaubt5919* **Standard**: nicht gesetzt, daher ist jeder Host erlaubt

5755 5920

5769 5934

5770Stellen Sie Anmeldedaten über Hilfsskripte bereit und erzwingen Sie für Organisationen eine Anmeldemethode oder Organisation. Siehe [Authentifizierung](/docs/de/authentication).5935Stellen Sie Anmeldedaten über Hilfsskripte bereit und erzwingen Sie für Organisationen eine Anmeldemethode oder Organisation. Siehe [Authentifizierung](/docs/de/authentication).

5771 5936

5937<h3 id="allowedproviders">

5938 `allowedProviders`

5939</h3>

5940

5941Listen Sie die Dienste auf, über die ein Computer Claude erreichen darf, etwa die Anthropic API, Amazon Bedrock oder ein LLM-Gateway. Eine Sitzung bei einem nicht aufgeführten Anbieter wird beim Start, bei der Anmeldung und beim nächsten Kontakt mit der API abgelehnt, sodass auch ein Wechsel zu einem nicht aufgeführten Anbieter während der Sitzung abgelehnt wird. Die [Ablehnungsmeldung](/docs/de/errors#managed-settings-dont-allow-this-api-provider) nennt, wodurch der Anbieter ausgewählt wurde, und die Schritte zum Fortfahren. Erfordert Claude Code v2.1.285 oder später.

5942

5943* **Geltungsbereich**: [`Managed`](#scopes). Eine Liste, die die eigenen Admin-Quellen des Computers festlegen, also MDM-Richtlinien und verwaltete Einstellungsdateien, gilt weiterhin, wenn auch server-verwaltete Einstellungen eine Liste liefern: Eine Sitzung darf dann nur die Anbieter verwenden, die auf beiden Listen stehen, sodass eine server-verwaltete Liste die Zulassungen des Computers einschränken, aber nie erweitern kann. Welches `allowedProviders` einer Quelle auf dem Computer zählt, richtet sich danach, [wie Claude Code verwaltete Quellen kombiniert](/docs/de/managed-settings#how-claude-code-combines-managed-sources). Eine ausschließlich über server-verwaltete Einstellungen gelieferte Liste erreicht nur die Sitzungen, die [server-verwaltete Einstellungen abrufen](/docs/de/server-managed-settings#platform-availability).

5944* **Typ**: Array von Strings, jeweils einer von:

5945 * `"anthropic"`: die Anthropic API auf dem eigenen Host von Anthropic, über eine claude.ai- oder Console-Anmeldung oder einen API-Schlüssel. Kombinieren Sie ihn mit [`forceLoginMethod`](#forceloginmethod) oder [`forceLoginOrgUUID`](#forceloginorguuid), um zusätzlich die Anmeldung einzuschränken

5946 * `"bedrock"`: [Amazon Bedrock](/docs/de/amazon-bedrock)

5947 * `"vertex"`: [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), früher Vertex AI

5948 * `"foundry"`: [Microsoft Foundry](/docs/de/microsoft-foundry)

5949 * `"anthropicAws"`: [Claude Platform on AWS](/docs/de/claude-platform-on-aws)

5950 * `"mantle"`: der Amazon Bedrock [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint). Eine Sitzung, die [Mantle parallel zur Invoke API ausführt](/docs/de/amazon-bedrock#run-mantle-alongside-the-invoke-api), verwendet beide Anbieter; listen Sie dafür `"bedrock"` und `"mantle"` gemeinsam auf

5951 * `"customEndpoint"`: die Anthropic API oder die API eines Cloud-Anbieters, die an einen anderen Host gesendet wird, etwa ein [LLM-Gateway](/docs/de/llm-gateway), das über `ANTHROPIC_BASE_URL` angegeben ist, eine `ANTHROPIC_*_BASE_URL`-Variable eines Anbieters oder ein `ANTHROPIC_FOUNDRY_RESOURCE`-Wert, der kein reiner Ressourcenname ist. Claude Code lässt ihn nur für genau den Wert zu, den ein verwalteter [`env`](#env)-Block festlegt

5952 * `"gateway"`: eine [Cloud-Gateway](/docs/de/claude-apps-gateway)-Anmeldung

5953* **Standard**: nicht gesetzt, daher kann jeder Anbieter verwendet werden

5954

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

5956{

5957 "allowedProviders": ["anthropic", "bedrock"]

5958}

5959```

5960

5961Der Eintrag eines Cloud-Anbieters bezeichnet den eigenen Dienst dieses Anbieters, einschließlich seiner regionalen, FIPS- und privaten Endpunkte.

5962

5963Ein Eintrag, den Claude Code nicht als Anbieternamen erkennt, wird verworfen und gemeldet, und der Rest der Liste bleibt in Kraft. Bei einer leeren Liste oder einer Liste, deren Einträge allesamt nicht erkannt werden, lehnt Claude Code jeden Anbieter ab und startet auf dem Computer nicht.

5964

5965<h4 id="endpoints-that-need-a-pin-in-managed-env">

5966 Endpunkte, die eine Festlegung im verwalteten `env` benötigen

5967</h4>

5968

5969Eine Festlegung ist der Wert einer Endpunktvariable, der in einem verwalteten [`env`](#env)-Block gesetzt ist. Wenn eine Sitzung den Datenverkehr eines Anbieters an ein anderes Ziel als den eigenen Dienst dieses Anbieters sendet, lässt Claude Code dies nur zu, wenn der Wert der Sitzung mit der Festlegung übereinstimmt. Diese Endpunkte benötigen eine Festlegung:

5970

5971* **`"customEndpoint"`-Sitzungen**: die Variable, die den Host angibt, etwa `ANTHROPIC_BASE_URL`

5972* **Amazon Bedrock**: die AWS SDK-Variablen `AWS_ENDPOINT_URL`, `AWS_ENDPOINT_URL_BEDROCK` und `AWS_ENDPOINT_URL_BEDROCK_RUNTIME`, wenn sie außerhalb des eigenen Dienstes von Bedrock zeigen. Die Sitzung bleibt unter `"bedrock"` statt `"customEndpoint"`

5973* **Die URL einer Gateway-Anmeldung**: Die Sitzung bleibt unter `"gateway"`, und [`forceLoginGatewayUrl`](#forcelogingatewayurl) zählt ebenfalls als Festlegung

5974

5975Welche `env`-Blöcke als Festlegungen zählen, hängt davon ab, wo die Liste gesetzt ist:

5976

5977* **Eine Administratorquelle auf dem Computer setzt eine Liste**: Nur die `env`-Blöcke der eigenen Administratorquellen des Computers zählen

5978* **Nur server-verwaltete Einstellungen setzen eine Liste**: Ein `env`-Wert in diesen server-verwalteten Einstellungen zählt ebenfalls

5979

5980Die Liste bewertet weder die Anmeldedaten- und Mandantenvariablen eines Cloud-Anbieters noch den Netzwerkpfad, etwa `HTTPS_PROXY` und Zertifikatseinstellungen. Setzen Sie diese für die gesamte Flotte im verwalteten `env`-Block.

5981

5772<h3 id="apikeyhelper">5982<h3 id="apikeyhelper">

5773 `apiKeyHelper`5983 `apiKeyHelper`

5774</h3>5984</h3>

5775 5985

5776Führen Sie Ihren eigenen Befehl aus, um die Anmeldedaten zu generieren, die Claude Code mit Modellanfragen sendet. Claude Code führt den Befehl über die System-Shell aus, `/bin/sh` auf macOS und Linux und `cmd` auf Windows, und sendet seine Ausgabe als sowohl `X-Api-Key` als auch `Authorization: Bearer` Header. Verwenden Sie es für dynamische oder rotierende Anmeldedaten, wie kurzlebige Token, die aus einem Vault abgerufen werden.5986Führen Sie Ihren eigenen Befehl aus, um die Anmeldedaten zu generieren, die Claude Code mit Modellanfragen sendet. Claude Code führt den Befehl über die System-Shell aus, `/bin/sh` auf macOS und Linux und `cmd` auf Windows, und sendet seine Ausgabe als sowohl `X-Api-Key` als auch `Authorization: Bearer` Header. Verwenden Sie es für dynamische oder rotierende Anmeldedaten, wie kurzlebige Token, die aus einem Vault abgerufen werden.

5777 5987

5778* **Bereich**: [`Any file`](#scopes)5988* **Geltungsbereich**: [`Any file`](#scopes)

5779* **Typ**: string, eine Shell-Befehlszeile5989* **Typ**: string, eine Shell-Befehlszeile

5780* **Standard**: nicht gesetzt, daher führt Claude Code keinen Helfer aus5990* **Standard**: nicht gesetzt, daher führt Claude Code keinen Helfer aus

5781 5991

5793 6003

5794Die letzten beiden Fälle gelten nur, wenn die Ausgabe des Helfers die Anmeldedaten sind, die Claude Code sendet, und `ANTHROPIC_AUTH_TOKEN` nicht gesetzt ist.6004Die letzten beiden Fälle gelten nur, wenn die Ausgabe des Helfers die Anmeldedaten sind, die Claude Code sendet, und `ANTHROPIC_AUTH_TOKEN` nicht gesetzt ist.

5795 6005

5796In interaktiven Sitzungen führt Claude Code den Befehl nicht aus, bis Sie die Eingabeaufforderung zur Workspace-Vertrauenswürdigkeit akzeptieren, wenn der Befehl aus Projekt- oder lokalen Einstellungen stammt. Siehe [Verwaltung von Anmeldedaten](/docs/de/authentication#credential-management).6006In interaktiven Sitzungen führt Claude Code den Befehl nicht aus, bis Sie die Abfrage zur Workspace-Vertrauenswürdigkeit akzeptieren, wenn der Befehl aus Projekt- oder lokalen Einstellungen stammt. Siehe [Verwaltung von Anmeldedaten](/docs/de/authentication#credential-management).

5797 6007

5798<h3 id="awsauthrefresh">6008<h3 id="awsauthrefresh">

5799 `awsAuthRefresh`6009 `awsAuthRefresh`

5801 6011

5802Führen Sie Ihren eigenen Befehl aus, z. B. `aws sso login`, um die Anmeldedaten in Ihrem `.aws`-Verzeichnis zu aktualisieren, wenn die Anmeldedaten, die Claude Code für [Amazon Bedrock](/docs/de/amazon-bedrock) hat, nicht mehr funktionieren. Claude Code überprüft zunächst die aktuellen Anmeldedaten gegen STS und führt den Befehl nur aus, wenn diese Überprüfung fehlschlägt, und liest dann das aktualisierte `.aws`-Verzeichnis.6012Führen Sie Ihren eigenen Befehl aus, z. B. `aws sso login`, um die Anmeldedaten in Ihrem `.aws`-Verzeichnis zu aktualisieren, wenn die Anmeldedaten, die Claude Code für [Amazon Bedrock](/docs/de/amazon-bedrock) hat, nicht mehr funktionieren. Claude Code überprüft zunächst die aktuellen Anmeldedaten gegen STS und führt den Befehl nur aus, wenn diese Überprüfung fehlschlägt, und liest dann das aktualisierte `.aws`-Verzeichnis.

5803 6013

5804* **Bereich**: [`Any file`](#scopes)6014Wenn die Überprüfung gleichzeitig in mehreren Claude Code-Prozessen fehlschlägt, die denselben Befehl und dieselben Anmeldedaten verwenden, etwa in separaten Terminals oder IDE-Fenstern, führt ein Prozess den Befehl aus, und die übrigen warten auf diesen Lauf, statt einen eigenen zu starten. Ein Prozess, der mit einer ausstehenden Anfrage 60 Sekunden gewartet hat, führt den Befehl selbst aus. Um dies zu deaktivieren, setzen Sie [`CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK`](/docs/de/env-vars) auf `1`.

6015

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

5805* **Typ**: string, eine Shell-Befehlszeile6017* **Typ**: string, eine Shell-Befehlszeile

5806* **Standard**: nicht gesetzt, daher aktualisiert Claude Code AWS-Anmeldedaten nicht für Sie6018* **Standard**: nicht gesetzt, daher aktualisiert Claude Code AWS-Anmeldedaten nicht für Sie

5807 6019

5819 6031

5820Führen Sie Ihren eigenen Befehl aus, der AWS-Anmeldedaten als JSON ausgibt, damit Claude Code [Amazon Bedrock](/docs/de/amazon-bedrock) mit Anmeldedaten aufrufen kann, die nicht in Ihrem `.aws`-Verzeichnis vorhanden sind. Claude Code akzeptiert die `aws sts` Ausgabeform und die flache `aws configure export-credentials` Form und beschränkt die Anmeldedaten auf seinen eigenen Bedrock-Client, sodass die Shell-Befehle, die Claude ausführt, immer noch Ihre Umgebungsanmeldedaten sehen.6032Führen Sie Ihren eigenen Befehl aus, der AWS-Anmeldedaten als JSON ausgibt, damit Claude Code [Amazon Bedrock](/docs/de/amazon-bedrock) mit Anmeldedaten aufrufen kann, die nicht in Ihrem `.aws`-Verzeichnis vorhanden sind. Claude Code akzeptiert die `aws sts` Ausgabeform und die flache `aws configure export-credentials` Form und beschränkt die Anmeldedaten auf seinen eigenen Bedrock-Client, sodass die Shell-Befehle, die Claude ausführt, immer noch Ihre Umgebungsanmeldedaten sehen.

5821 6033

5822* **Bereich**: [`Any file`](#scopes)6034* **Geltungsbereich**: [`Any file`](#scopes)

5823* **Typ**: string, eine Shell-Befehlszeile6035* **Typ**: string, eine Shell-Befehlszeile

5824* **Standard**: nicht gesetzt, daher verwendet Claude Code die Umgebungs-AWS-Anmeldedatenkette6036* **Standard**: nicht gesetzt, daher verwendet Claude Code die Umgebungs-AWS-Anmeldedatenkette

5825 6037

5835 `forceLoginMethod`6047 `forceLoginMethod`

5836</h3>6048</h3>

5837 6049

5838Beschränken Sie, welche Art von Konto sich Personen anmelden können. Setzen Sie `"claudeai"`, um nur claude.ai-Konten zuzulassen, `"console"`, um nur Claude Console-Konten zuzulassen, oder `"gateway"`, um Personen zu einem [Cloud-Gateway](/docs/de/claude-apps-gateway) statt zu einer First-Party-Anmeldung zu senden. Administratoren legen es in verwalteten Einstellungen fest und koppeln es mit [`forceLoginOrgUUID`](#forceloginorguuid), um die claude.ai-Anmeldungen von Entwicklern in einer Organisation zu halten. Wenn Sie es in einer beliebigen Einstellungsdatei auf `"claudeai"` oder `"console"` setzen, stoppt Claude Code auch das Angebot der [schlüssellosen Console-Anmeldung](/docs/de/authentication#sign-in-without-an-api-key) in den Sitzungen, auf die diese Datei zutrifft.6050Beschränken Sie, mit welcher Art von Konto sich Personen anmelden können. Setzen Sie `"claudeai"`, um nur claude.ai-Konten zuzulassen, `"console"`, um nur Claude Console-Konten zuzulassen, oder `"gateway"`, um Personen zu einem [Cloud-Gateway](/docs/de/claude-apps-gateway) statt zu einer First-Party-Anmeldung zu senden. Administratoren legen es in verwalteten Einstellungen fest und koppeln es mit [`forceLoginOrgUUID`](#forceloginorguuid), um die claude.ai-Anmeldungen von Entwicklern in einer Organisation zu halten. Wenn Sie es in einer beliebigen Einstellungsdatei auf `"claudeai"` oder `"console"` setzen, stoppt Claude Code auch das Angebot der [schlüssellosen Console-Anmeldung](/docs/de/authentication#sign-in-without-an-api-key) in den Sitzungen, auf die diese Datei zutrifft.

5839 6051

5840* **Bereich**: [`Any file`](#scopes). Claude Code berücksichtigt `"gateway"` nur von einer verwalteten Quelle auf dem Computer: `managed-settings.json`, die macOS plist oder Windows HKLM-Registrierung oder ein Policy-Helfer. Es behandelt `"gateway"` als nicht gesetzt in Benutzer-, Projekt-, lokalen, HKCU- und Server-verwalteten Einstellungen, die gleiche Regel wie [`forceLoginGatewayUrl`](#forcelogingatewayurl).6052* **Geltungsbereich**: [`Any file`](#scopes). Claude Code berücksichtigt `"gateway"` nur von einer verwalteten Quelle auf dem Computer: `managed-settings.json`, die macOS plist oder Windows HKLM-Registrierung oder ein Policy-Helfer. Es behandelt `"gateway"` als nicht gesetzt in Benutzer-, Projekt-, lokalen, HKCU- und Server-verwalteten Einstellungen, die gleiche Regel wie [`forceLoginGatewayUrl`](#forcelogingatewayurl).

5841* **Typ**: string, einer von:6053* **Typ**: string, einer von:

5842 * `"claudeai"`: nur claude.ai-Konten können sich anmelden6054 * `"claudeai"`: nur claude.ai-Konten können sich anmelden

5843 * `"console"`: nur Claude Console-Konten können sich anmelden6055 * `"console"`: nur Claude Console-Konten können sich anmelden

5860 6072

5861Legen Sie die Gateway-URL fest, mit der sich der `/login` Cloud-Gateway-Bildschirm verbindet, damit Personen Ihr [Cloud-Gateway](/docs/de/claude-apps-gateway) erreichen, ohne seine Adresse einzugeben. Der Bildschirm hat kein URL-Feld: Mit diesem Schlüssel gesetzt zeigt er Ihre Gateway-URL an und verbindet sich, wenn die Person die Eingabetaste drückt; ohne ihn teilt er ihnen mit, sich an ihren IT-Administrator zu wenden.6073Legen Sie die Gateway-URL fest, mit der sich der `/login` Cloud-Gateway-Bildschirm verbindet, damit Personen Ihr [Cloud-Gateway](/docs/de/claude-apps-gateway) erreichen, ohne seine Adresse einzugeben. Der Bildschirm hat kein URL-Feld: Mit diesem Schlüssel gesetzt zeigt er Ihre Gateway-URL an und verbindet sich, wenn die Person die Eingabetaste drückt; ohne ihn teilt er ihnen mit, sich an ihren IT-Administrator zu wenden.

5862 6074

5863Entweder dieser Schlüssel oder `forceLoginMethod: "gateway"` macht den Computer nur Gateway-fähig, daher öffnet `/login` auf dem Cloud-Gateway-Bildschirm ohne Anmeldemethoden-Picker. Siehe [Administrator-Richtlinie erfordert eine Cloud-Gateway-Anmeldung](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in), um zu erfahren, was mit einer verbleibenden First-Party-Anmeldung oder einem API-Schlüssel geschieht. Legen Sie beide Schlüssel fest, damit sich der Bildschirm verbindet, statt einen Fehler anzuzeigen.6075Entweder dieser Schlüssel oder `forceLoginMethod: "gateway"` macht den Computer zu einem reinen Gateway-Computer, mit Ausnahme von Sitzungen, die einen Cloud-Anbieter mit `CLAUDE_CODE_USE_*` auswählen. `/login` öffnet dann auf dem Cloud-Gateway-Bildschirm ohne Anmeldemethoden-Picker. Siehe [Administrator-Richtlinie erfordert eine Cloud-Gateway-Anmeldung](/docs/de/errors#administrator-policy-requires-a-cloud-gateway-sign-in), um zu erfahren, was mit einer verbleibenden First-Party-Anmeldung oder einem API-Schlüssel geschieht. Legen Sie beide Schlüssel fest, damit sich der Bildschirm verbindet, statt einen Fehler anzuzeigen.

5864 6076

5865* **Bereich**: [`Managed`](#scopes). Nur von einer Quelle auf dem Computer lesen: `managed-settings.json`, die macOS plist oder Windows HKLM-Registrierung oder ein Policy-Helfer. Claude Code ignoriert es in HKCU- und Server-verwalteten Einstellungen.6077* **Geltungsbereich**: [`Managed`](#scopes). Wird nur von einer Quelle auf dem Computer gelesen: `managed-settings.json`, die macOS plist oder Windows HKLM-Registrierung oder ein Policy-Helfer. Claude Code ignoriert es in HKCU- und Server-verwalteten Einstellungen.

5866* **Typ**: string, eine vollständige URL einschließlich des Schemas6078* **Typ**: string, eine vollständige URL einschließlich des Schemas

5867* **Standard**: nicht gesetzt, daher zeigt der Cloud-Gateway-Bildschirm einen Fehler an, der Personen auffordert, sich an ihren IT-Administrator zu wenden6079* **Standard**: nicht gesetzt, daher zeigt der Cloud-Gateway-Bildschirm einen Fehler an, der Personen auffordert, sich an ihren IT-Administrator zu wenden

5868 6080

5880 6092

5881Verlangen Sie von einer verwalteten Quelle, dass claude.ai-Kontoanmeldungen zu einer Anthropic-Organisation gehören, angegeben als eine einzelne UUID, oder zu einer von mehreren Organisationen, angegeben als Array. Aus einer beliebigen Einstellungsdatei verwendet Claude Code auch eine einzelne UUID, um diese Organisation während einer claude.ai- oder Claude Console-Anmeldung vorzuwählen, und wählt nichts für ein Array vor. Wenn Sie den Schlüssel in einer beliebigen Einstellungsdatei setzen, stoppt Claude Code auch das Angebot der [schlüssellosen Console-Anmeldung](/docs/de/authentication#sign-in-without-an-api-key) in den Sitzungen, auf die diese Datei zutrifft, und erstellt stattdessen einen API-Schlüssel.6093Verlangen Sie von einer verwalteten Quelle, dass claude.ai-Kontoanmeldungen zu einer Anthropic-Organisation gehören, angegeben als eine einzelne UUID, oder zu einer von mehreren Organisationen, angegeben als Array. Aus einer beliebigen Einstellungsdatei verwendet Claude Code auch eine einzelne UUID, um diese Organisation während einer claude.ai- oder Claude Console-Anmeldung vorzuwählen, und wählt nichts für ein Array vor. Wenn Sie den Schlüssel in einer beliebigen Einstellungsdatei setzen, stoppt Claude Code auch das Angebot der [schlüssellosen Console-Anmeldung](/docs/de/authentication#sign-in-without-an-api-key) in den Sitzungen, auf die diese Datei zutrifft, und erstellt stattdessen einen API-Schlüssel.

5882 6094

5883* **Bereich**: [`Any file`](#scopes). Nur eine verwaltete Quelle erzwingt die Einschränkung; eine einzelne UUID in einer beliebigen anderen Einstellungsdatei wählt die Organisation während der Anmeldung vor, ohne sie einzuschränken.6095* **Geltungsbereich**: [`Any file`](#scopes). Nur eine verwaltete Quelle erzwingt die Einschränkung; eine einzelne UUID in einer beliebigen anderen Einstellungsdatei wählt die Organisation während der Anmeldung vor, ohne sie einzuschränken.

5884* **Typ**: string, eine UUID, oder Array von Strings, mehrere UUIDs6096* **Typ**: string, eine UUID, oder Array von Strings, mehrere UUIDs

5885* **Standard**: nicht gesetzt, daher kann sich jede Organisation anmelden6097* **Standard**: nicht gesetzt, daher kann sich jede Organisation anmelden

5886 6098

5904 6116

5905Ohne diesen Schlüssel verbindet sich `/login` mit jedem Gateway auf einer privaten Adresse und nichts anderem. Mit ihm akzeptiert `/login` auch ein Gateway innerhalb eines aufgelisteten Blocks, nur über eine direkte Verbindung. Die eigene Adresse des Computers auf dieser Verbindung muss sich auch innerhalb desselben Blocks befinden.6117Ohne diesen Schlüssel verbindet sich `/login` mit jedem Gateway auf einer privaten Adresse und nichts anderem. Mit ihm akzeptiert `/login` auch ein Gateway innerhalb eines aufgelisteten Blocks, nur über eine direkte Verbindung. Die eigene Adresse des Computers auf dieser Verbindung muss sich auch innerhalb desselben Blocks befinden.

5906 6118

5907* **Bereich**: [`Managed`](#scopes). Nur von einer Quelle auf dem Computer lesen: `managed-settings.json`, die macOS plist oder Windows HKLM-Registrierung oder ein Policy-Helfer. Claude Code ignoriert es in HKCU- und Server-verwalteten Einstellungen.6119* **Geltungsbereich**: [`Managed`](#scopes). Wird nur von einer Quelle auf dem Computer gelesen: `managed-settings.json`, die macOS plist oder Windows HKLM-Registrierung oder ein Policy-Helfer. Claude Code ignoriert es in HKCU- und Server-verwalteten Einstellungen.

5908* **Typ**: Array von Strings, höchstens vier IPv4-CIDR-Blöcke, jeweils `/8` bis `/32`, nicht überlappend miteinander und keine Überlappung mit privatem Raum.6120* **Typ**: Array von Strings, höchstens vier IPv4-CIDR-Blöcke, jeweils `/8` bis `/32`, nicht überlappend miteinander und keine Überlappung mit privatem Raum.

5909* **Standard**: nicht gesetzt, daher akzeptiert `/login` nur Gateways auf privaten Adressen6121* **Standard**: nicht gesetzt, daher akzeptiert `/login` nur Gateways auf privaten Adressen

5910 6122

5922 `gcpAuthRefresh`6134 `gcpAuthRefresh`

5923</h3>6135</h3>

5924 6136

5925Führen Sie Ihren eigenen Befehl aus, um Google Cloud Application Default Credentials zu aktualisieren, wenn Claude Code feststellt, dass sie abgelaufen sind oder nicht geladen werden können, damit [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) Anfragen ohne manuelle Neuzertifizierung funktionieren.6137Führen Sie Ihren eigenen Befehl aus, um Google Cloud Application Default Credentials zu aktualisieren, wenn Claude Code feststellt, dass sie abgelaufen sind oder nicht geladen werden können, damit Anfragen an [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) weiterhin funktionieren, ohne dass Sie sich manuell erneut authentifizieren müssen.

5926 6138

5927* **Bereich**: [`Any file`](#scopes)6139Wenn mehrere Claude Code-Prozesse, die denselben Befehl und dieselben Anmeldedaten verwenden, etwa in separaten Terminals oder IDE-Fenstern, gleichzeitig feststellen, dass diese abgelaufen sind, führt ein Prozess den Befehl aus, und die übrigen warten auf diesen Lauf, statt einen eigenen zu starten. Ein Prozess, der mit einer ausstehenden Anfrage 60 Sekunden gewartet hat, führt den Befehl selbst aus. Um dies zu deaktivieren, setzen Sie [`CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK`](/docs/de/env-vars) auf `1`.

6140

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

5928* **Typ**: string, eine Shell-Befehlszeile6142* **Typ**: string, eine Shell-Befehlszeile

5929* **Standard**: nicht gesetzt, daher teilt Ihnen der Anmeldedatenfehler von Claude Code mit, `gcloud auth application-default login` selbst auszuführen6143* **Standard**: nicht gesetzt, daher teilt Ihnen der Anmeldedatenfehler von Claude Code mit, `gcloud auth application-default login` selbst auszuführen

5930 6144

5942 6156

5943Führen Sie Ihren eigenen Befehl aus, um die Header zu generieren, die Claude Code mit OpenTelemetry-Exporten sendet, für Backends, deren Token rotieren. Claude Code führt ihn beim Start und danach regelmäßig aus und erwartet ein JSON-Objekt von String-Header-Werten auf stdout.6157Führen Sie Ihren eigenen Befehl aus, um die Header zu generieren, die Claude Code mit OpenTelemetry-Exporten sendet, für Backends, deren Token rotieren. Claude Code führt ihn beim Start und danach regelmäßig aus und erwartet ein JSON-Objekt von String-Header-Werten auf stdout.

5944 6158

5945* **Bereich**: [`Any file`](#scopes)6159* **Geltungsbereich**: [`Any file`](#scopes)

5946* **Typ**: string, ein ausführbarer Pfad oder eine Shell-Befehlszeile6160* **Typ**: string, ein ausführbarer Pfad oder eine Shell-Befehlszeile

5947* **Standard**: nicht gesetzt, daher fügt Claude Code keine Helfer-generierten Header hinzu6161* **Standard**: nicht gesetzt, daher fügt Claude Code keine Helfer-generierten Header hinzu

5948 6162

5952}6166}

5953```6167```

5954 6168

5955Legen Sie das Aktualisierungsintervall mit [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/de/env-vars) fest. Siehe [Dynamische Header](/docs/de/monitoring-usage#dynamic-headers) für die Skriptanforderungen und wo Claude Code einen fehlgeschlagenen Helfer meldet.6169Legen Sie das Aktualisierungsintervall mit [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/de/env-vars) fest. Siehe [Dynamische Header](/docs/de/monitoring-usage#dynamic-headers) für die Skriptanforderungen und was passiert, wenn der Helfer fehlschlägt.

5956 6170

5957<h2 id="updates-and-versioning">6171<h2 id="updates-and-versioning">

5958 Aktualisierungen und Versionsverwaltung6172 Aktualisierungen und Versionsverwaltung

6113 `cleanupPeriodDays`6327 `cleanupPeriodDays`

6114</h3>6328</h3>

6115 6329

6116Legen Sie fest, wie viele Tage Claude Code [Sitzungstranskripte und andere Anwendungsdaten](/docs/de/claude-directory#cleaned-up-automatically) speichert, bevor sie gelöscht werden. Claude Code führt die Löschung als Hintergrund-Sweep nach dem Start einer Sitzung durch, solange es die Aufbewahrungsfrist sicher bestimmen kann.6330Legen Sie fest, wie viele Tage Claude Code [Sitzungstranskripte und andere Anwendungsdaten](/docs/de/claude-directory#cleaned-up-automatically) speichert, bevor sie gelöscht werden. Claude Code führt die Löschung als Hintergrund-Sweep nach dem Start einer Sitzung durch, solange es die Aufbewahrungsfrist sicher bestimmen kann. Der Sweep löscht Transkripte, ohne eine Meldung anzuzeigen, sodass eine Sitzung, die Sie länger als die Aufbewahrungsfrist nicht verwendet haben, nicht mehr in der [`/resume`](/docs/de/sessions#resume-a-session)-Auswahl erscheint.

6117 6331

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

6119* **Typ**: Anzahl der Tage, eine ganze Zahl, Minimum `1`6333* **Typ**: Anzahl der Tage, eine ganze Zahl, Minimum `1`

6155 * `"quiet"`: Claude entwirft ohne Karte. Sie sehen die Anzahl der eingereihten Entwürfe in der Eingabeaufforderungs-Fußzeile und überprüfen sie in `/feedback`6369 * `"quiet"`: Claude entwirft ohne Karte. Sie sehen die Anzahl der eingereihten Entwürfe in der Eingabeaufforderungs-Fußzeile und überprüfen sie in `/feedback`

6156 * `"off"`: Claude Code entfernt das SendFeedback-Tool, sodass Claude keine Entwürfe einreihen kann6370 * `"off"`: Claude Code entfernt das SendFeedback-Tool, sodass Claude keine Entwürfe einreihen kann

6157* **Standard**: `"notify"`6371* **Standard**: `"notify"`

6158* **Sitzungsspezifische Außerkraftsetzungen**: [`CLAUDE_CODE_SEND_FEEDBACK`](/docs/de/env-vars) auf `0` gesetzt deaktiviert die Funktion für eine Sitzung6372* **Sitzungsspezifische Überschreibungen**: [`CLAUDE_CODE_SEND_FEEDBACK`](/docs/de/env-vars) auf `0` gesetzt deaktiviert die Funktion für eine Sitzung

6159 6373

6160```json settings.json theme={null}6374```json settings.json theme={null}

6161{6375{

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

6175* **Typ**: Zahl zwischen `0` und `1`6389* **Typ**: Zahl zwischen `0` und `1`

6176* **Standard**: nicht gesetzt, sodass Claude Code die Rate verwendet, die Anthropic remote setzt, oder seine integrierte Rate von `0.005` auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, die keine Remote-Konfiguration erhalten6390* **Standard**: nicht gesetzt, sodass Claude Code die Rate verwendet, die Anthropic remote setzt, oder seine integrierte Rate von `0.005` auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, die keine Remote-Konfiguration erhalten

6177* **Sitzungsspezifische Außerkraftsetzungen**: [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/docs/de/env-vars) auf `1` gesetzt deaktiviert die Umfrage für eine Sitzung, unabhängig davon, welche Rate dieser Schlüssel setzt6391* **Sitzungsspezifische Überschreibungen**: [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/docs/de/env-vars) auf `1` gesetzt deaktiviert die Umfrage für eine Sitzung, unabhängig davon, welche Rate dieser Schlüssel setzt

6178 6392

6179```json settings.json theme={null}6393```json settings.json theme={null}

6180{6394{

6216 `disableSideloadFlags`6430 `disableSideloadFlags`

6217</h3>6431</h3>

6218 6432

6219Lehnen Sie die CLI-Flags `--plugin-dir`, `--plugin-url`, `--agents` und `--mcp-config` beim Start ab, die Benutzer andernfalls übergeben könnten, um [`strictKnownMarketplaces`](#strictknownmarketplaces) für einen einzelnen Durchlauf zu umgehen. Claude Code wird mit einem Fehler beendet, der die abgelehnten Flags benennt, und wendet die gleiche Überprüfung auf Oberflächen an, die die CLI intern mit diesen Flags starten, derzeit [Cowork](/docs/de/desktop)-Lokalsitzungen in der Desktop-App. In [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) verwirft Claude Code die MCP-Server, die der Server über `--mcp-config` bereitgestellt hat, mit Ausnahme von In-Process-Einträgen vom Typ `type: "sdk"`, und startet die Sitzung. Erfordert Claude Code v2.1.193 oder später.6433Lehnen Sie die CLI-Flags `--plugin-dir`, `--plugin-url`, `--agents` und `--mcp-config` beim Start ab, die Benutzer andernfalls übergeben könnten, um [`strictKnownMarketplaces`](#strictknownmarketplaces) für einen einzelnen Durchlauf zu umgehen. Claude Code wird mit einem Fehler beendet, der die abgelehnten Flags benennt. In [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) startet Claude Code stattdessen die Sitzung und verwirft jeden vom Server bereitgestellten `--mcp-config`-Eintrag mit Ausnahme von In-Process-Einträgen vom Typ `type: "sdk"` und der Slack-Tools einer [Claude Tag](/docs/de/claude-tag)-Sitzung. Erfordert Claude Code v2.1.193 oder später.

6220 6434

6221* **Bereich**: [`Managed`](#scopes)6435* **Bereich**: [`Managed`](#scopes)

6222* **Typ**: Boolean6436* **Typ**: Boolean

6223 * `true`: Claude Code lehnt `--plugin-dir`, `--plugin-url`, `--agents` und `--mcp-config` beim Start ab und wird mit einem Fehler beendet, der diese benennt, außer dass es in Cloud-Sitzungen die MCP-Server verwirft, die der Server über `--mcp-config` bereitgestellt hat, mit Ausnahme von In-Process-Einträgen vom Typ `type: "sdk"`, und startet die Sitzung6437 * `true`: Claude Code lehnt `--plugin-dir`, `--plugin-url`, `--agents` und `--mcp-config` beim Start ab und wird mit einem Fehler beendet, der diese benennt. In Cloud-Sitzungen startet es stattdessen die Sitzung und verwirft jeden vom Server bereitgestellten `--mcp-config`-Eintrag mit Ausnahme von In-Process-Einträgen vom Typ `type: "sdk"` und der Slack-Tools einer Claude Tag-Sitzung

6224 * `false`: Claude Code akzeptiert diese Flags6438 * `false`: Claude Code akzeptiert diese Flags

6225* **Standard**: `false`6439* **Standard**: `false`

6226 6440

6234 6448

6235Die gleiche Überprüfung deckt Plugin-Ordner ab, die in der Umgebungsvariablen [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/de/env-vars#variables) benannt sind, was Claude Code v2.1.280 oder später erfordert. Wenn die Variable einen Ordner benennt, wird Claude Code mit dem gleichen Fehler beendet, und der Fehler sagt, die Variable zu deaktivieren.6449Die gleiche Überprüfung deckt Plugin-Ordner ab, die in der Umgebungsvariablen [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/de/env-vars#variables) benannt sind, was Claude Code v2.1.280 oder später erfordert. Wenn die Variable einen Ordner benennt, wird Claude Code mit dem gleichen Fehler beendet, und der Fehler sagt, die Variable zu deaktivieren.

6236 6450

6237In Cloud-Sitzungen ignoriert Claude Code auch vom Server bereitgestellte MCP-Updates während der Sitzung, den Pfad hinter der Cloud-Sitzungskonfiguration und SDK `setMcpServers()`-Aufrufe, die diese Sitzungen erreichen. In-Process-Einträge vom Typ `type: "sdk"` bleiben dort auch ausgenommen. Vor v2.1.239 blockierte ein vom Server bereitgestelltes `--mcp-config` den Start einer Cloud-Sitzung.6451In Cloud-Sitzungen ignoriert Claude Code auch vom Server bereitgestellte MCP-Updates während der Sitzung, den Pfad hinter der Cloud-Sitzungskonfiguration und SDK `setMcpServers()`-Aufrufe, die diese Sitzungen erreichen. In-Process-Einträge vom Typ `type: "sdk"` und die Slack-Tools einer Claude Tag-Sitzung bleiben dort ebenfalls ausgenommen. Vor v2.1.268 entfernten sowohl dieses Verwerfen als auch das Verwerfen beim Start auch die Slack-Tools einer Claude Tag-Sitzung. Vor v2.1.239 blockierte ein vom Server bereitgestelltes `--mcp-config` den Start einer Cloud-Sitzung.

6452

6453Die Desktop-App verwaltet einige Plugins selbst, darunter von claude.ai synchronisierte Plugins und Plugins, die Ihre Organisation über die App bereitstellt. Wenn Sie diesen Schlüssel über MDM, eine Richtlinie auf Betriebssystemebene oder eine verwaltete Einstellungsdatei auf einem Gerät bereitstellen, übergibt die Desktop-App diese Plugins nicht an die folgenden Sitzungen auf diesem Gerät:

6454

6455* **[Code-Sitzungen auf dem Computer des Benutzers](/docs/de/desktop#environment-configuration)**: Sie starten außerdem ohne die Skills, die für das claude.ai-Konto des Benutzers aktiviert sind. Plugins, die Claude Code aus Marketplaces in Ihren verwalteten Einstellungen installiert, werden weiterhin geladen. In [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) bleiben auch MCP-Server aus Plugins verfügbar, die Sie im `org-plugins`-Verzeichnis des Geräts bereitstellen, da die Desktop-App selbst eine Verbindung zu ihnen herstellt. Vor Claude Desktop v1.37937.0 schlugen diese Sitzungen stattdessen beim Start fehl.

6456* **[Cowork-Sitzungen auf dem Computer des Benutzers](/docs/de/managed-settings#where-and-when-a-policy-applies)**: Die Skills in diesen Plugins und die für das claude.ai-Konto des Benutzers aktivierten Skills bleiben verfügbar. In [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) bleiben auch MCP-Server aus Plugins verfügbar, die Sie im `org-plugins`-Verzeichnis des Geräts bereitstellen, da die Desktop-App selbst eine Verbindung zu ihnen herstellt. Vor Claude Desktop v1.44121.0 schlugen diese Sitzungen stattdessen beim Start fehl.

6238 6457

6239<h3 id="forceremotesettingsrefresh">6458<h3 id="forceremotesettingsrefresh">

6240 `forceRemoteSettingsRefresh`6459 `forceRemoteSettingsRefresh`

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

6248* **Typ**: Boolean6467* **Typ**: Boolean

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

6250 * `false`: Claude Code blockiert den Start nicht beim Abruf, obwohl es beim Anmelden des Entwicklers beim Start bis zu fünf Sekunden auf den Abruf wartet6469 * `false`: Claude Code blockiert den Start nicht beim Abruf, obwohl es bei einem Start mit Anmeldung bis zu fünf Sekunden auf den Abruf wartet

6251* **Standard**: `false`6470* **Standard**: `false`

6252 6471

6253```json managed-settings.json theme={null}6472```json managed-settings.json theme={null}

6256}6475}

6257```6476```

6258 6477

6259Setzen Sie dies in einem MDM-Profil oder der verwalteten Einstellungsdatei, um einen Fail-Closed-Start durchzusetzen, bevor die erste Server-Nutzlast ankommt. Claude Code wendet die Überprüfung nur in Sitzungen an, die vom Server verwaltete Einstellungen abrufen, sodass eine Sitzung, die [diese nicht abruft](/docs/de/server-managed-settings#platform-availability), ohne Wartezeit startet. Die `claude auth`-Unterbefehle sind ausgenommen, sodass Benutzer sich erneut authentifizieren können, wenn abgelaufene Anmeldedaten der Grund für den fehlgeschlagenen Abruf sind. Siehe [Fail-Closed-Start durchsetzen](/docs/de/server-managed-settings#enforce-fail-closed-startup).6478Setzen Sie dies in einem MDM-Profil oder der verwalteten Einstellungsdatei, um einen Fail-Closed-Start durchzusetzen, bevor die erste Server-Payload ankommt. Claude Code wendet die Überprüfung nur in Sitzungen an, die vom Server verwaltete Einstellungen abrufen, sodass eine Sitzung, die [diese nicht abruft](/docs/de/server-managed-settings#platform-availability), ohne Wartezeit startet. Die `claude auth`-Unterbefehle sind ausgenommen, sodass Benutzer sich erneut authentifizieren können, wenn abgelaufene Anmeldedaten der Grund für den fehlgeschlagenen Abruf sind. Siehe [Fail-Closed-Start durchsetzen](/docs/de/server-managed-settings#enforce-fail-closed-startup).

6260 6479

6261<h3 id="managedsourcesbehavior">6480<h3 id="managedsourcesbehavior">

6262 `managedSourcesBehavior`6481 `managedSourcesBehavior`

6263</h3>6482</h3>

6264 6483

6265Wählen Sie, ob Claude Code nur die höchste Priorität [verwaltete Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources) anwendet, die Ihre Organisation bereitstellt, oder alle Admin-Quellen kombiniert, die sie bereitstellt. Standardmäßig nimmt Claude Code die höchste Prioritätsquelle, die einen [Richtlinienschlüssel](/docs/de/managed-settings#how-claude-code-combines-managed-sources) trägt, und ignoriert den Rest. Ein Richtlinienschlüssel ist jeder Einstellungsschlüssel außer diesem und `wslInheritsWindowsSettings`. Sobald vom Server verwaltete Einstellungen oder eine MDM-Richtlinie einen Richtlinienschlüssel bereitstellen, trägt eine `managed-settings.json`-Datei nur die [Schlüssel bei, die Claude Code aus jeder Admin-Quelle liest](/docs/de/managed-settings#keys-read-from-every-admin-source). Mit `"merge"` trägt jede Admin-Quelle, die Sie bereitstellen, ihre Schlüssel zu einer kombinierten Richtlinie bei. Erfordert Claude Code v2.1.242 oder später.6484Wählen Sie, ob Claude Code nur die höchste Priorität [verwaltete Quelle](/docs/de/managed-settings#how-claude-code-combines-managed-sources) anwendet, die Ihre Organisation bereitstellt, oder alle Admin-Quellen kombiniert, die sie bereitstellt. Standardmäßig nimmt Claude Code die höchste Prioritätsquelle, die einen [Richtlinienschlüssel](/docs/de/managed-settings#how-claude-code-combines-managed-sources) trägt, und ignoriert den Rest. Ein Richtlinienschlüssel ist jeder Einstellungsschlüssel außer diesem und `wslInheritsWindowsSettings`. Bei diesem Standardverhalten trägt eine `managed-settings.json`-Datei, sobald vom Server verwaltete Einstellungen oder eine MDM-Richtlinie einen Richtlinienschlüssel bereitstellen, nur die [Schlüssel bei, die Claude Code aus jeder Admin-Quelle liest](/docs/de/managed-settings#keys-read-from-every-admin-source). Mit `"merge"` trägt jede Admin-Quelle, die Sie bereitstellen, ihre Schlüssel zu einer kombinierten Richtlinie bei. Erfordert Claude Code v2.1.242 oder später.

6266 6485

6267Setzen Sie `"merge"` nur dort, wo jede Quelle, die [unter Ihrer höchsten eingestuft](/docs/de/managed-settings#how-claude-code-combines-managed-sources) ist, unter der Kontrolle eines Administrators steht, da Claude Code dann Einträge aus einer niedrigeren Quelle, wie z. B. `permissions.allow`-Regeln, zur Richtlinie hinzufügt.6486Setzen Sie `"merge"` nur dort, wo jede Quelle, die [unter Ihrer höchsten eingestuft](/docs/de/managed-settings#how-claude-code-combines-managed-sources) ist, unter der Kontrolle eines Administrators steht, da Claude Code dann Einträge aus einer niedrigeren Quelle, wie z. B. `permissions.allow`-Regeln, zur Richtlinie hinzufügt.

6268 6487

6280}6499}

6281```6500```

6282 6501

6283Unter `"merge"` kombiniert Claude Code jeden Schlüssel nach seiner Art. Diese Tabelle gibt die Regel für jede Art an. Die Zeilen für Einschränkungserlaubnis, Werte-ganz-genommen und nur-höchste-Quelle benennen jeden Schlüssel, den sie abdecken, und die anderen Zeilen geben Beispiele:6502Unter `"merge"` kombiniert Claude Code jeden Schlüssel nach seiner Art. Diese Tabelle gibt die Regel für jede Art an. Die Zeilen für Einschränkungs-Allowlists, Werte-ganz-genommen und nur-höchste-Quelle benennen jeden Schlüssel, den sie abdecken, und die anderen Zeilen geben Beispiele:

6284 6503

6286| :- | :- | :- |6505| :- | :- | :- |

6287| Listen | Kombiniert Einträge aus jeder Quelle | [`permissions.allow`](#permissions-allow), [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) und andere Listenschlüssel |6506| Listen | Kombiniert Einträge aus jeder Quelle | [`permissions.allow`](#permissions-allow), [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) und andere Listenschlüssel |

6288| Sperren | Wendet den strengsten Wert an, den eine Quelle setzt. Wenn keine Quelle einen strengen Wert setzt, wendet einen lockereren Wert nur aus der höchsten Quelle an | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly), [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) und andere Boolean- oder Enum-Sperren |6507| Sperren | Wendet den strengsten Wert an, den eine Quelle setzt. Wenn keine Quelle einen strengen Wert setzt, wendet einen lockereren Wert nur aus der höchsten Quelle an | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly), [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) und andere Boolean- oder Enum-Sperren |

6289| Einschränkungserlaubnisse | Nimmt die Liste ganz aus der höchsten Quelle, die sie setzt, ohne Einträge aus niedrigeren Quellen hinzuzufügen. Wenn die höchste Quelle keine setzt, nimmt sie ganz aus der nächsten Quelle darunter | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) und die [`fallbackModel`](#fallbackmodel)-Kette |6508| Einschränkungs-Allowlists | Nimmt die Liste ganz aus der höchsten Quelle, die sie setzt, ohne Einträge aus niedrigeren Quellen hinzuzufügen. Wenn die höchste Quelle keine setzt, nimmt sie ganz aus der nächsten Quelle darunter | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`allowedProviders`](#allowedproviders), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) und die [`fallbackModel`](#fallbackmodel)-Kette |

6290| Werte ganz genommen | Nimmt den Wert ganz aus der höchsten Quelle, die ihn setzt, ohne Einträge oder Felder aus niedrigeren Quellen zu kombinieren. Wenn die höchste Quelle ihn nicht setzt, nimmt ihn ganz aus der nächsten Quelle darunter | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |6509| Werte ganz genommen | Nimmt den Wert ganz aus der höchsten Quelle, die ihn setzt, ohne Einträge oder Felder aus niedrigeren Quellen zu kombinieren. Wenn die höchste Quelle ihn nicht setzt, nimmt ihn ganz aus der nächsten Quelle darunter | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |

6291| Bereitgestellte MCP-Server | Kombiniert die Servernamen aus jeder Quelle. Wenn zwei Quellen denselben Namen setzen, wendet den ganzen Eintrag der höheren Quelle an | [`managedMcpServers`](#managedmcpservers) |6510| Bereitgestellte MCP-Server | Kombiniert die Servernamen aus jeder Quelle. Wenn zwei Quellen denselben Namen setzen, wendet den ganzen Eintrag der höheren Quelle an | [`managedMcpServers`](#managedmcpservers) |

6292| Nur aus der höchsten Prioritätsquelle lesen | Liest den Schlüssel nur aus der höchsten Prioritätsquelle, die einen Richtlinienschlüssel trägt, sodass der Wert einer niedrigeren Quelle ignoriert wird, auch wenn die höchste Quelle keinen setzt | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`forceLoginOrgUUID`](#forceloginorguuid), die `"claudeai"`- und `"console"`-Werte von [`forceLoginMethod`](#forceloginmethod), [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |6511| Nur aus der höchsten Prioritätsquelle lesen | Liest den Schlüssel nur aus der höchsten Prioritätsquelle, die einen Richtlinienschlüssel trägt, sodass der Wert einer niedrigeren Quelle ignoriert wird, auch wenn die höchste Quelle keinen setzt | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`forceLoginOrgUUID`](#forceloginorguuid), die `"claudeai"`- und `"console"`-Werte von [`forceLoginMethod`](#forceloginmethod), [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |

6300* **[`policyHelper`](#policyhelper)**: Claude Code berücksichtigt ihn nur, wenn die höchste Quelle, die einen Richtlinienschlüssel trägt, eine MDM-Richtlinie oder eine verwaltete Einstellungsdatei ist, sodass unter vom Server verwalteten Einstellungen sie nicht angewendet wird.6519* **[`policyHelper`](#policyhelper)**: Claude Code berücksichtigt ihn nur, wenn die höchste Quelle, die einen Richtlinienschlüssel trägt, eine MDM-Richtlinie oder eine verwaltete Einstellungsdatei ist, sodass unter vom Server verwalteten Einstellungen sie nicht angewendet wird.

6301* **[`modelOverrides`](#modeloverrides)**: Paare mit `availableModels`. Claude Code nimmt `modelOverrides` aus der höchsten Quelle, die ihn setzt, es sei denn, eine höhere Quelle setzt `availableModels` ohne `modelOverrides`. In diesem Fall ignoriert es `modelOverrides` aus jeder Quelle.6520* **[`modelOverrides`](#modeloverrides)**: Paare mit `availableModels`. Claude Code nimmt `modelOverrides` aus der höchsten Quelle, die ihn setzt, es sei denn, eine höhere Quelle setzt `availableModels` ohne `modelOverrides`. In diesem Fall ignoriert es `modelOverrides` aus jeder Quelle.

6302* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) und der `"gateway"`-Wert von [`forceLoginMethod`](#forceloginmethod)**: Claude Code liest sie nie aus vom Server verwalteten Einstellungen, sodass ein Wert dort weder angewendet wird noch einen in einer MDM-Richtlinie oder verwalteten Einstellungsdatei gesetzten Wert verbirgt. Unter den Admin-Quellen auf dem Computer liefert nur die höchste eingestufte, die einen Richtlinienschlüssel trägt, sie, unabhängig davon, ob vom Server verwaltete Einstellungen auch vorhanden sind.6521* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) und der `"gateway"`-Wert von [`forceLoginMethod`](#forceloginmethod)**: Claude Code liest sie nie aus vom Server verwalteten Einstellungen, sodass ein Wert dort weder angewendet wird noch einen in einer MDM-Richtlinie oder verwalteten Einstellungsdatei gesetzten Wert verbirgt. Unter den Admin-Quellen auf dem Computer liefert nur die höchste eingestufte, die einen Richtlinienschlüssel trägt, sie, unabhängig davon, ob vom Server verwaltete Einstellungen auch vorhanden sind.

6522* **[`allowedProviders`](#allowedproviders)**: Nach der Regel der Tabelle begrenzt die eigene Liste des Computers das Ergebnis weiterhin, wie im Hinweis unter „Bereich" seines Eintrags angegeben.

6303 6523

6304Um zu bestätigen, welche Quellen auf einem Computer kombiniert wurden, führen Sie `/status` aus und [lesen Sie die Zeile `Setting sources`](/docs/de/managed-settings#read-the-source-in-/status).6524Um zu bestätigen, welche Quellen auf einem Computer kombiniert wurden, führen Sie `/status` aus und [lesen Sie die Zeile `Setting sources`](/docs/de/managed-settings#read-the-source-in-/status).

6305 6525

6307 `parentSettingsBehavior`6527 `parentSettingsBehavior`

6308</h3>6528</h3>

6309 6529

6310Wählen Sie, ob Claude Code verwaltete Einstellungen anwendet, die von einem Embedding-Host-Prozess bereitgestellt werden, wie z. B. dem Agent SDK oder einer IDE-Erweiterung, wenn auch eine admin-bereitgestellte verwaltete Ebene vorhanden ist. Mit `"first-wins"` verwirft Claude Code die vom Host bereitgestellten Einstellungen; mit `"merge"` wendet es sie unter der Admin-Ebene durch einen restriktiv-nur-Filter an. Setzen Sie `"merge"`, wenn ein Host seine eigenen Einschränkungen an die Sitzungen übergeben muss, die er startet, z. B. Claude Desktop, das die Egress-Erlaubnisliste eines Gateways bereitstellt.6530Wählen Sie, ob Claude Code verwaltete Einstellungen anwendet, die von einem Embedding-Host-Prozess bereitgestellt werden, wie z. B. dem Agent SDK oder einer IDE-Erweiterung, wenn auch eine admin-bereitgestellte verwaltete Ebene vorhanden ist. Mit `"first-wins"` verwirft Claude Code die vom Host bereitgestellten Einstellungen; mit `"merge"` wendet es sie unter der Admin-Ebene durch einen restriktiv-nur-Filter an. Setzen Sie `"merge"`, wenn ein Host seine eigenen Einschränkungen an die Sitzungen übergeben muss, die er startet, z. B. Claude Desktop, das die Egress-Allowlist eines Gateways bereitstellt.

6311 6531

6312* **Bereich**: [`Managed`](#scopes). Claude Code liest ihn aus der höchsten Priorität admin-kontrollierten verwalteten Quelle.6532* **Bereich**: [`Managed`](#scopes). Claude Code liest ihn aus der höchsten Priorität admin-kontrollierten verwalteten Quelle.

6313* **Typ**: string, einer von:6533* **Typ**: string, einer von:

6329 `policyHelper`6549 `policyHelper`

6330</h3>6550</h3>

6331 6551

6332Führen Sie eine ausführbare Datei aus, die Sie bereitstellen, die verwaltete Einstellungen beim Start berechnet, sodass Sie Richtlinien von Geräteposition, Identität oder einem Remote-Service ableiten können, anstatt von einer statischen Datei. Claude Code führt den Helper aus, bevor er die erste Eingabeaufforderung akzeptiert, und behandelt die Einstellungen, die er ausgibt, als die verwalteten Einstellungen für die Sitzung.6552Führen Sie eine ausführbare Datei aus, die Sie bereitstellen, die verwaltete Einstellungen beim Start berechnet, sodass Sie Richtlinien von Geräteposition, Identität oder einem Remote-Service ableiten können, anstatt von einer statischen Datei. Claude Code führt den Helper aus, bevor er den ersten Prompt akzeptiert, und behandelt die Einstellungen, die er ausgibt, als die verwalteten Einstellungen für die Sitzung.

6333 6553

6334* **Bereich**: [`Managed`](#scopes). Lesen Sie aus der macOS plist, der Windows HKLM-Registrierung oder der verwalteten Einstellungsdatei. Claude Code liest den Schlüssel aus der höchsten Priorität verwalteten Quelle, die einen [Richtlinienschlüssel](/docs/de/managed-settings#how-claude-code-combines-managed-sources) trägt, und führt den Helper nur aus, wenn diese Quelle eine dieser drei ist; es ignoriert den Schlüssel in vom Server verwalteten Einstellungen, der HKCU-Registrierung und vom Host bereitgestellten übergeordneten Einstellungen.6554* **Bereich**: [`Managed`](#scopes). Lesen Sie aus der macOS plist, der Windows HKLM-Registrierung oder der verwalteten Einstellungsdatei. Claude Code liest den Schlüssel aus der höchsten Priorität verwalteten Quelle, die einen [Richtlinienschlüssel](/docs/de/managed-settings#how-claude-code-combines-managed-sources) trägt, und führt den Helper nur aus, wenn diese Quelle eine dieser drei ist; es ignoriert den Schlüssel in vom Server verwalteten Einstellungen, der HKCU-Registrierung und vom Host bereitgestellten übergeordneten Einstellungen.

6335* **Typ**: Objekt mit `path`, `timeoutMs` und `refreshIntervalMs`6555* **Typ**: Objekt mit `path`, `timeoutMs` und `refreshIntervalMs`

6389 6609

6390Wenn eine Hintergrund-Aktualisierung fehlschlägt, behält Claude Code die letzte erfolgreiche Richtlinie bei, und `/status` zeigt die fehlgeschlagene Aktualisierung mit ihrem Grund an, bis eine Aktualisierung erfolgreich ist. Jede Aktualisierung wird unter den gleichen `timeoutMs`- und Fehlerregeln wie der Startup-Durchlauf ausgeführt.6610Wenn eine Hintergrund-Aktualisierung fehlschlägt, behält Claude Code die letzte erfolgreiche Richtlinie bei, und `/status` zeigt die fehlgeschlagene Aktualisierung mit ihrem Grund an, bis eine Aktualisierung erfolgreich ist. Jede Aktualisierung wird unter den gleichen `timeoutMs`- und Fehlerregeln wie der Startup-Durchlauf ausgeführt.

6391 6611

6392Mit `--debug` schreibt Claude Code den stderr des Helpers aus jedem Durchlauf in das [Debug-Protokoll](/docs/de/debug-your-config).6612Mit `--debug` schreibt Claude Code den stderr des Helpers aus jedem Durchlauf in das [Debug-Log](/docs/de/debug-your-config).

6393 6613

6394Claude Code meldet einen ungültigen `policyHelper`-Wert als einen [gelöschten Eintrag](/docs/de/managed-settings#find-entries-claude-code-dropped) und startet die Sitzung auf den verbleibenden verwalteten Einstellungen ohne Ausführung eines Helpers. Ungültige Werte umfassen einen bloßen Pfad-String und einen `timeoutMs` unter [seinem Minimum](#policyhelper-timeoutms).6614Claude Code meldet einen ungültigen `policyHelper`-Wert als einen [gelöschten Eintrag](/docs/de/managed-settings#find-entries-claude-code-dropped) und startet die Sitzung auf den verbleibenden verwalteten Einstellungen ohne Ausführung eines Helpers. Ungültige Werte umfassen einen bloßen Pfad-String und einen `timeoutMs` unter [seinem Minimum](#policyhelper-timeoutms).

6395 6615

6457 `wslInheritsWindowsSettings`6677 `wslInheritsWindowsSettings`

6458</h3>6678</h3>

6459 6679

6460Lassen Sie Claude Code auf WSL verwaltete Einstellungen aus der Windows-Richtlinienkette lesen, wobei HKLM und die Windows-verwaltete Einstellungsdatei Vorrang vor `/etc/claude-code` und HKCU darunter haben. Während die Kette aktiv ist, liest Claude Code `/etc/claude-code` nur, wenn keine verwaltete Einstellungsdatei oder Drop-in unter `C:\Program Files\ClaudeCode\` einen [Richtlinienschlüssel](/docs/de/managed-settings#how-claude-code-combines-managed-sources) bereitstellt. Setzen Sie dies, um die Richtlinie, die Sie bereits unter Windows bereitstellen, auf WSL-Sitzungen auf dem gleichen Computer zu erweitern, sodass sie den gleichen Regeln wie Host-Sitzungen folgen. Claude Code berücksichtigt ihn nur, wenn er im HKLM-Registrierungsschlüssel oder in einer verwalteten Einstellungsdatei oder Drop-in unter `C:\Program Files\ClaudeCode\` gesetzt ist, die beide Windows-Admin-Schreibzugriff erfordern.6680Lassen Sie Claude Code auf WSL verwaltete Einstellungen aus der Windows-Richtlinienkette lesen, wobei HKLM und die Windows-verwaltete Einstellungsdatei Vorrang vor `/etc/claude-code` und HKCU darunter haben. Während die Kette aktiv ist, liest Claude Code `/etc/claude-code` nur, wenn [kein Windows-Admin-Dokument vorhanden ist](/docs/de/managed-settings#present-admin-documents), weder im HKLM-Registrierungswert noch im Ordner `C:\Program Files\ClaudeCode\`. Setzen Sie dies, um die Richtlinie, die Sie bereits unter Windows bereitstellen, auf WSL-Sitzungen auf dem gleichen Computer zu erweitern, sodass sie den gleichen Regeln wie Host-Sitzungen folgen. Claude Code berücksichtigt ihn nur, wenn er im HKLM-Registrierungsschlüssel oder in einer verwalteten Einstellungsdatei oder Drop-in unter `C:\Program Files\ClaudeCode\` gesetzt ist, die beide Windows-Admin-Schreibzugriff erfordern.

6461 6681

6462* **Bereich**: [`Managed`](#scopes). In einer admin-kontrollierten Windows-Quelle.6682* **Bereich**: [`Managed`](#scopes). In einer admin-kontrollierten Windows-Quelle.

6463* **Typ**: Boolean6683* **Typ**: Boolean

6464 * `true`: Claude Code auf WSL liest verwaltete Einstellungen aus der Windows-Richtlinienkette und liest `/etc/claude-code` nur, wenn keine verwaltete Einstellungsdatei oder Drop-in unter `C:\Program Files\ClaudeCode\` einen [Richtlinienschlüssel](/docs/de/managed-settings#how-claude-code-combines-managed-sources) bereitstellt6684 * `true`: Claude Code auf WSL liest verwaltete Einstellungen aus der Windows-Richtlinienkette und liest `/etc/claude-code` nur, wenn kein Windows-Admin-Dokument vorhanden ist

6465 * `false`: WSL liest nur `/etc/claude-code`6685 * `false`: WSL liest nur `/etc/claude-code`

6466* **Standard**: `false`, sodass WSL nur `/etc/claude-code` liest6686* **Standard**: `false`, sodass WSL nur `/etc/claude-code` liest

6467 6687

6471}6691}

6472```6692```

6473 6693

6474Sobald eine Admin-Quelle die Kette einschaltet, tritt die HKCU-Richtlinie auf WSL nur bei, wenn HKCU auch den Schlüssel auf `true` setzt. Diese Kopie schaltet die Kette nicht von selbst ein. Eine Windows-Quelle, die nur diesen Schlüssel enthält, zählt nicht als Richtlinienquelle, sodass eine niedrigere Prioritätsquelle immer noch die Richtlinie liefert. Dieser Schlüssel hat keine Auswirkung auf natives Windows.6694Sobald eine Admin-Quelle die Kette einschaltet, tritt die HKCU-Richtlinie auf WSL nur bei, wenn HKCU auch den Schlüssel auf `true` setzt. Diese Kopie schaltet die Kette nicht von selbst ein. Eine Windows-Quelle, die nur diesen Schlüssel enthält, gesetzt auf `true` oder `false`, zählt nicht als Richtlinienquelle, sodass eine niedrigere Prioritätsquelle immer noch die Richtlinie liefert. Dieser Schlüssel hat keine Auswirkung auf natives Windows.

6695

6696Claude Code liest `true` und `false` mit oder ohne Anführungszeichen und liest `null` als Entfernen des Schlüssels. Eine admin-kontrollierte Windows-Quelle, die einen anderen Wert enthält, zählt als [vorhandenes Admin-Dokument](/docs/de/managed-settings#present-admin-documents) mit eingeschalteter Kette: Weder `/etc/claude-code` noch HKCU gelten, und eine Warnung beim Start benennt den Schlüssel. Ein HKLM-Wert oder eine Datei im Windows-Ordner, die existiert, aber nicht gelesen werden kann, verhindert ebenfalls, dass `/etc/claude-code` gilt, unabhängig davon, ob die Kette eingeschaltet ist. Erfordert Claude Code v2.1.282 oder später.

6475 6697

6476<h2 id="global-config-settings">6698<h2 id="global-config-settings">

6477 Globale Konfigurationseinstellungen6699 Globale Konfigurationseinstellungen

6485 6707

6486Verbinden Sie sich automatisch mit einer laufenden IDE, wenn Sie Claude Code von einem externen Terminal aus starten. Erscheint in `/config` als **Auto-Verbindung zur IDE (externes Terminal)**, wenn Sie Claude Code außerhalb eines VS Code- oder JetBrains-Terminals ausführen.6708Verbinden Sie sich automatisch mit einer laufenden IDE, wenn Sie Claude Code von einem externen Terminal aus starten. Erscheint in `/config` als **Auto-Verbindung zur IDE (externes Terminal)**, wenn Sie Claude Code außerhalb eines VS Code- oder JetBrains-Terminals ausführen.

6487 6709

6488* **Bereich**: [`Global config`](#scopes)6710* **Geltungsbereich**: [`Global config`](#scopes)

6489* **Typ**: Boolean6711* **Typ**: Boolean

6490 * `true`: Claude Code verbindet sich automatisch mit einer laufenden IDE, wenn Sie es von einem externen Terminal aus starten6712 * `true`: Claude Code verbindet sich automatisch mit einer laufenden IDE, wenn Sie es von einem externen Terminal aus starten

6491 * `false`: Claude Code verbindet sich nicht automatisch von einem externen Terminal aus; innerhalb eines VS Code- oder JetBrains-Terminals oder mit `--ide` verbindet es sich trotzdem6713 * `false`: Claude Code verbindet sich nicht automatisch von einem externen Terminal aus; innerhalb eines VS Code- oder JetBrains-Terminals oder mit `--ide` verbindet es sich trotzdem

6492* **Standard**: `false`6714* **Standard**: `false`

6493* **Sitzungsübergreifende Überschreibungen**: [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/docs/de/env-vars) hat Vorrang vor diesem Schlüssel für eine Sitzung, in beide Richtungen6715* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/docs/de/env-vars) hat Vorrang vor diesem Schlüssel für eine Sitzung, in beide Richtungen

6494 6716

6495```json ~/.claude.json theme={null}6717```json ~/.claude.json theme={null}

6496{6718{

6506 6728

6507Installieren Sie die Claude Code IDE-Erweiterung automatisch, wenn Sie Claude Code von einem VS Code-Terminal aus ausführen. Erscheint in `/config` als **Auto-Install IDE-Erweiterung**, wenn Sie Claude Code innerhalb eines VS Code- oder JetBrains-Terminals ausführen.6729Installieren Sie die Claude Code IDE-Erweiterung automatisch, wenn Sie Claude Code von einem VS Code-Terminal aus ausführen. Erscheint in `/config` als **Auto-Install IDE-Erweiterung**, wenn Sie Claude Code innerhalb eines VS Code- oder JetBrains-Terminals ausführen.

6508 6730

6509* **Bereich**: [`Global config`](#scopes)6731* **Geltungsbereich**: [`Global config`](#scopes)

6510* **Typ**: Boolean6732* **Typ**: Boolean

6511 * `true`: Claude Code installiert die IDE-Erweiterung automatisch, wenn Sie es von einem VS Code-Terminal aus ausführen6733 * `true`: Claude Code installiert die IDE-Erweiterung automatisch, wenn Sie es von einem VS Code-Terminal aus ausführen

6512 * `false`: Claude Code installiert die Erweiterung nicht automatisch6734 * `false`: Claude Code installiert die Erweiterung nicht automatisch

6513* **Standard**: `true`6735* **Standard**: `true`

6514* **Sitzungsübergreifende Überschreibungen**: [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/de/env-vars) auf `1` gesetzt überspringt die Installation für eine Sitzung, auch wenn dieser Schlüssel `true` ist6736* **Überschreibungen pro Sitzung**: [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/de/env-vars) auf `1` gesetzt überspringt die Installation für eine Sitzung, auch wenn dieser Schlüssel `true` ist

6515 6737

6516```json ~/.claude.json theme={null}6738```json ~/.claude.json theme={null}

6517{6739{

6521 6743

6522Claude Code ignoriert diesen Schlüssel in `settings.json`.6744Claude Code ignoriert diesen Schlüssel in `settings.json`.

6523 6745

6746<h3 id="claudeinchromedefaultenabled">

6747 `claudeInChromeDefaultEnabled`

6748</h3>

6749

6750Starten Sie jede interaktive CLI-Sitzung mit aktivierter [Chrome-Integration](/docs/de/chrome), ohne jedes Mal `--chrome` übergeben zu müssen. Wenn Sie [`claude remote-control`](/docs/de/remote-control) ausführen, folgt auch eine Sitzung, die dadurch für einen Ihrer [Projekt](/docs/de/claude-projects)-Threads gestartet wird, diesem Schlüssel, außer im Modus `bypassPermissions`. Wenn Sie `/chrome` ausführen und **Standardmäßig aktiviert** auswählen, wird dieser Schlüssel für Sie gesetzt, wie in [Chrome standardmäßig aktivieren](/docs/de/chrome#enable-chrome-by-default) beschrieben. Erscheint in `/config` als **Claude in Chrome standardmäßig aktiviert**.

6751

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

6753* **Typ**: Boolean

6754 * `true`: Claude Code aktiviert die Chrome-Integration, wenn eine interaktive CLI-Sitzung startet, so wie beim Übergeben von `--chrome`

6755 * `false`: Interaktive CLI-Sitzungen starten mit deaktivierter Chrome-Integration, und Claude Code [bietet die Einrichtung](/docs/de/chrome#install-the-extension-when-claude-asks) nicht mehr an. Übergeben Sie `--chrome`, um sie für eine interaktive Sitzung zu aktivieren

6756* **Standard**: nicht gesetzt, sodass die Chrome-Integration deaktiviert ist und Claude Code die Einrichtung weiterhin anbieten kann

6757* **Überschreibungen pro Sitzung**: `--chrome` und [`--no-chrome`](/docs/de/cli-reference) haben für eine interaktive Sitzung Vorrang vor diesem Schlüssel

6758

6759```json ~/.claude.json theme={null}

6760{

6761 "claudeInChromeDefaultEnabled": true

6762}

6763```

6764

6765Claude Code ignoriert diesen Schlüssel in `settings.json`.

6766

6767<h3 id="copyfullresponse">

6768 `copyFullResponse`

6769</h3>

6770

6771Lassen Sie [`/copy`](/docs/de/commands) jedes Mal die vollständige Antwort kopieren, ohne die Auswahl, die sonst angezeigt wird, wenn die Antwort Codeblöcke enthält. Wenn Sie in dieser Auswahl **Immer vollständige Antwort kopieren** wählen, wird dieser Schlüssel auf `true` gesetzt. Erscheint in `/config` als **/copy-Auswahl überspringen**.

6772

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

6774* **Typ**: Boolean

6775 * `true`: `/copy` kopiert die vollständige Antwort, ohne die Auswahl anzuzeigen

6776 * `false`: Wenn die Antwort Codeblöcke enthält, zeigt `/copy` eine Auswahl an, in der Sie einen Codeblock oder die vollständige Antwort wählen

6777* **Standard**: `false`

6778

6779```json ~/.claude.json theme={null}

6780{

6781 "copyFullResponse": true

6782}

6783```

6784

6785Claude Code ignoriert diesen Schlüssel in `settings.json`.

6786

6524<h3 id="copyonselect">6787<h3 id="copyonselect">

6525 `copyOnSelect`6788 `copyOnSelect`

6526</h3>6789</h3>

6527 6790

6528Kopieren Sie Text automatisch in Ihre Zwischenablage, wenn Sie die Auswahl mit der Maus in der [Vollbilddarstellung](/docs/de/fullscreen#use-the-mouse) oder [Agent-Ansicht](/docs/de/agent-view) beenden. Erscheint in `/config` als **Beim Auswählen kopieren**, während die Vollbilddarstellung aktiviert ist.6791Kopieren Sie Text automatisch in Ihre Zwischenablage, wenn Sie die Auswahl mit der Maus in der [Vollbilddarstellung](/docs/de/fullscreen#use-the-mouse) oder [Agent-Ansicht](/docs/de/agent-view) beenden. Erscheint in `/config` als **Beim Auswählen kopieren**, während die Vollbilddarstellung aktiviert ist.

6529 6792

6530* **Bereich**: [`Global config`](#scopes)6793* **Geltungsbereich**: [`Global config`](#scopes)

6531* **Typ**: Boolean6794* **Typ**: Boolean

6532 * `true`: Claude Code kopiert Text in Ihre Zwischenablage, wenn Sie die Auswahl beenden6795 * `true`: Claude Code kopiert Text in Ihre Zwischenablage, wenn Sie die Auswahl beenden

6533 * `false`: Das Auswählen von Text lässt Ihre Zwischenablage unverändert, und Sie [kopieren die Auswahl stattdessen mit einer Tastenkombination](/docs/de/fullscreen#use-the-mouse)6796 * `false`: Das Auswählen von Text lässt Ihre Zwischenablage unverändert, und Sie [kopieren die Auswahl stattdessen mit einer Tastenkombination](/docs/de/fullscreen#use-the-mouse)

6541 6804

6542Claude Code ignoriert diesen Schlüssel in `settings.json`.6805Claude Code ignoriert diesen Schlüssel in `settings.json`.

6543 6806

6807<h3 id="defaulttoagentsview">

6808 `defaultToAgentsView`

6809</h3>

6810

6811Öffnen Sie die [Agent-Ansicht](/docs/de/agent-view) statt einer neuen Konversation, wenn Sie `claude` ohne Argumente ausführen. Erscheint in `/config` als **Agent-Ansicht standardmäßig öffnen**, sofern die Agent-Ansicht nicht [ausgeschaltet](#disableagentview) ist.

6812

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

6814* **Typ**: Boolean

6815 * `true`: `claude` ohne Argumente öffnet die Agent-Ansicht, sofern die Agent-Ansicht nicht [ausgeschaltet](#disableagentview) ist

6816 * `false`: `claude` ohne Argumente startet eine neue Konversation

6817* **Standard**: `false`

6818

6819```json ~/.claude.json theme={null}

6820{

6821 "defaultToAgentsView": true

6822}

6823```

6824

6825Claude Code ignoriert diesen Schlüssel in `settings.json`.

6826

6544<h3 id="difftool">6827<h3 id="difftool">

6545 `diffTool`6828 `diffTool`

6546</h3>6829</h3>

6547 6830

6548Wählen Sie, wo Claude Code den Diff einer `Edit`- oder `Write`-Änderung anzeigt, die es vorschlägt, wenn eine [VS Code](/docs/de/vs-code)- oder [JetBrains](/docs/de/jetbrains#features)-IDE verbunden ist: `"auto"` öffnet es im Diff-Viewer der IDE, `"terminal"` behält es im Terminal. Erscheint in `/config` als **Diff-Tool** nur, wenn Claude Code mit einer VS Code- oder JetBrains-IDE verbunden ist.6831Wählen Sie, wo Claude Code den Diff einer `Edit`- oder `Write`-Änderung anzeigt, die es vorschlägt, wenn eine [VS Code](/docs/de/vs-code)- oder [JetBrains](/docs/de/jetbrains#features)-IDE verbunden ist: `"auto"` öffnet es im Diff-Viewer der IDE, `"terminal"` behält es im Terminal. Erscheint in `/config` als **Diff-Tool** nur, wenn Claude Code mit einer VS Code- oder JetBrains-IDE verbunden ist.

6549 6832

6550* **Bereich**: [`Global config`](#scopes)6833* **Geltungsbereich**: [`Global config`](#scopes)

6551* **Typ**: string, einer von:6834* **Typ**: string, einer von:

6552 * `"auto"`: Claude Code öffnet den Diff im Diff-Viewer der IDE, wenn eine VS Code- oder JetBrains-IDE verbunden ist6835 * `"auto"`: Claude Code öffnet den Diff im Diff-Viewer der IDE, wenn eine VS Code- oder JetBrains-IDE verbunden ist

6553 * `"terminal"`: Claude Code behält den Diff im Terminal6836 * `"terminal"`: Claude Code behält den Diff im Terminal

6565 `externalEditorContext`6848 `externalEditorContext`

6566</h3>6849</h3>

6567 6850

6568Wenn Sie `Ctrl+G` drücken, öffnet Claude Code die Eingabeaufforderung, die Sie eingeben, in Ihrem [externen Editor](/docs/de/interactive-mode#general-controls). Mit diesem Schlüssel aktiviert, startet der Editor-Puffer mit Claudes vorheriger Antwort als `#`-Kommentarzeilen, damit Sie sie lesen können, während Sie schreiben, und Claude Code entfernt diese Zeilen, wenn Sie speichern. Erscheint in `/config` als **Letzte Antwort im externen Editor anzeigen**.6851Wenn Sie `Ctrl+G` drücken, öffnet Claude Code den Prompt, den Sie gerade eingeben, in Ihrem [externen Editor](/docs/de/interactive-mode#general-controls). Mit diesem Schlüssel aktiviert, startet der Editor-Puffer mit Claudes vorheriger Antwort als `#`-Kommentarzeilen, damit Sie sie lesen können, während Sie schreiben, und Claude Code entfernt diese Zeilen, wenn Sie speichern. Erscheint in `/config` als **Letzte Antwort im externen Editor anzeigen**.

6569 6852

6570* **Bereich**: [`Global config`](#scopes)6853* **Geltungsbereich**: [`Global config`](#scopes)

6571* **Typ**: Boolean6854* **Typ**: Boolean

6572 * `true`: Der Editor-Puffer startet mit Claudes vorheriger Antwort als `#`-Kommentarzeilen, die Claude Code beim Speichern entfernt6855 * `true`: Der Editor-Puffer startet mit Claudes vorheriger Antwort als `#`-Kommentarzeilen, die Claude Code beim Speichern entfernt

6573 * `false`: Der Editor-Puffer öffnet sich nur mit Ihrer Eingabeaufforderung6856 * `false`: Der Editor-Puffer öffnet sich nur mit Ihrem Prompt

6574* **Standard**: `false`6857* **Standard**: `false`

6575 6858

6576```json ~/.claude.json theme={null}6859```json ~/.claude.json theme={null}

6579}6862}

6580```6863```

6581 6864

6582Mit aktiviertem Schlüssel sieht der Puffer, den Claude Code öffnet, so aus, und nur der Text unter der Markierungszeile wird als Ihre Eingabeaufforderung gesendet:6865Mit aktiviertem Schlüssel sieht der Puffer, den Claude Code öffnet, so aus, und nur der Text unter der Markierungszeile wird als Ihr Prompt gesendet:

6583 6866

6584```text theme={null}6867```text theme={null}

6585# ─── Claudes letzte Antwort (zur Referenz; beim Speichern entfernt) ───6868# ─── Claudes letzte Antwort (zur Referenz; beim Speichern entfernt) ───

6595 6878

6596Claude Code ignoriert diesen Schlüssel in `settings.json`.6879Claude Code ignoriert diesen Schlüssel in `settings.json`.

6597 6880

6881<h3 id="leftarrowopensagents">

6882 `leftArrowOpensAgents`

6883</h3>

6884

6885Drücken Sie `←` in einem leeren Prompt, um [die Sitzung in den Hintergrund zu verschieben und die Agent-Ansicht zu öffnen](/docs/de/agent-view#switch-sessions-without-leaving-the-terminal). Setzen Sie diesen Schlüssel auf `false`, um diese Tastenkombination auszuschalten. Erscheint in `/config` als **← öffnet Agenten**, wenn die Agent-Ansicht verfügbar ist.

6886

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

6888* **Typ**: Boolean

6889 * `true`: Das Drücken von `←` in einem leeren Prompt in einer Sitzung, die Sie im Terminal gestartet haben, verschiebt diese in den Hintergrund und öffnet die Agent-Ansicht

6890 * `false`: Claude Code schaltet die Tastenkombination aus; in einer Sitzung, [mit der Sie sich aus der Agent-Ansicht verbunden haben](/docs/de/agent-view#attach-to-a-session), trennt `←` in einem leeren Prompt die Verbindung weiterhin

6891* **Standard**: `true`

6892

6893```json ~/.claude.json theme={null}

6894{

6895 "leftArrowOpensAgents": false

6896}

6897```

6898

6899Claude Code ignoriert diesen Schlüssel in `settings.json`.

6900

6598<h3 id="permissionexplainerenabled">6901<h3 id="permissionexplainerenabled">

6599 `permissionExplainerEnabled`6902 `permissionExplainerEnabled`

6600</h3>6903</h3>

6601 6904

6602<Warning>6905<Warning>

6603 Entfernt in v2.1.257, zusammen mit der `Ctrl+E`-Befehlserklärung auf Bash- und PowerShell-Berechtigungsaufforderungen. Das Setzen hat keine Auswirkung auf aktuelle Versionen.6906 Entfernt in v2.1.257, zusammen mit der `Ctrl+E`-Befehlserklärung in Bash- und PowerShell-Berechtigungsabfragen. Das Setzen hat keine Auswirkung auf aktuelle Versionen.

6604</Warning>6907</Warning>

6605 6908

6606Bis v2.1.256 konnten Sie `Ctrl+E` auf einer Bash- oder PowerShell-Berechtigungsaufforderung drücken, um eine modellgenerierte Erklärung des Befehls zu sehen, und diesen Schlüssel auf `false` setzen, um diese Tastenkombination auszuschalten.6909Bis v2.1.256 konnten Sie `Ctrl+E` in einer Bash- oder PowerShell-Berechtigungsabfrage drücken, um eine modellgenerierte Erklärung des Befehls zu sehen, und diesen Schlüssel auf `false` setzen, um diese Tastenkombination auszuschalten.

6607 6910

6608* **Bereich**: [`Global config`](#scopes). Auf v2.1.256 und früher.6911* **Geltungsbereich**: [`Global config`](#scopes). Auf v2.1.256 und früher.

6609* **Typ**: Boolean6912* **Typ**: Boolean

6610* **Standard**: `true`6913* **Standard**: `true`

6611 6914

6915<h3 id="prstatusfooterenabled">

6916 `prStatusFooterEnabled`

6917</h3>

6918

6919Zeigen Sie in der Fußzeile des Prompts ein Badge für den offenen Pull Request oder Merge Request des aktuellen Branches an, mit einer farbigen Unterstreichung, die dessen [Status](/docs/de/interactive-mode#pr-review-status) anzeigt. Erscheint in `/config` als **PR-Status in Fußzeile anzeigen**.

6920

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

6922* **Typ**: Boolean

6923 * `true`: Die Fußzeile zeigt das Badge unter den in [PR-Review-Status](/docs/de/interactive-mode#pr-review-status) beschriebenen Bedingungen an

6924 * `false`: Claude Code überspringt die Prüfung von Pull Requests und Merge Requests für die Fußzeile und zeigt dieses Badge nicht an. Eine Sitzung, [mit der Sie sich aus der Agent-Ansicht verbunden haben](/docs/de/agent-view#attach-to-a-session), kann weiterhin einen einfachen Link zu einem [mit ihr verknüpften](/docs/de/agent-view#pull-request-status) Pull Request anzeigen

6925* **Standard**: `true`

6926

6927```json ~/.claude.json theme={null}

6928{

6929 "prStatusFooterEnabled": false

6930}

6931```

6932

6933Claude Code ignoriert diesen Schlüssel in `settings.json`.

6934

6612<h3 id="teammatedefaultmodel">6935<h3 id="teammatedefaultmodel">

6613 `teammateDefaultModel`6936 `teammateDefaultModel`

6614</h3>6937</h3>

6617 Entfernt in v2.1.234, zusammen mit seiner `/config`-Zeile **Standard-Teamkollegen-Modell**. Das Setzen hat keine Auswirkung auf aktuelle Versionen.6940 Entfernt in v2.1.234, zusammen mit seiner `/config`-Zeile **Standard-Teamkollegen-Modell**. Das Setzen hat keine Auswirkung auf aktuelle Versionen.

6618</Warning>6941</Warning>

6619 6942

6620Bis v2.1.233 setzen Sie diesen Schlüssel auf das Modell für [Agent-Team](/docs/de/agent-teams#specify-teammates-and-models)-Teamkollegen, für die Ihre Eingabeaufforderung kein Modell benannt hat: ein Alias wie `"sonnet"` oder `null`, um dem Modell des Leads zu folgen. Für das Modell, das Claude Code für solche Teamkollegen jetzt auswählt, siehe [Teamkollegen und Modelle angeben](/docs/de/agent-teams#specify-teammates-and-models).6943Bis v2.1.233 setzten Sie diesen Schlüssel auf das Modell für [Agent-Team](/docs/de/agent-teams#specify-teammates-and-models)-Teamkollegen, für die Ihr Prompt kein Modell benannt hat: ein Alias wie `"sonnet"` oder `null`, um dem Modell des Leads zu folgen. Für das Modell, das Claude Code für solche Teamkollegen jetzt auswählt, siehe [Teamkollegen und Modelle angeben](/docs/de/agent-teams#specify-teammates-and-models).

6621 6944

6622* **Bereich**: [`Global config`](#scopes). Auf v2.1.233 und früher.6945* **Geltungsbereich**: [`Global config`](#scopes). Auf v2.1.233 und früher.

6623* **Typ**: string, ein Modell-Alias oder vollständige Modell-ID oder `null`6946* **Typ**: string, ein Modell-Alias oder vollständige Modell-ID oder `null`

6624* **Standard**: nicht gesetzt6947* **Standard**: nicht gesetzt

6625 6948

troubleshoot-install.md +18 −4

Details

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 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) |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| `Raw mode is not supported` während der Installation | [Führen Sie das Installationsprogramm erneut aus](#raw-mode-is-not-supported-during-install) |24| `Raw mode is not supported` während der Installation | [Führen Sie das Installationsprogramm erneut aus](#raw-mode-is-not-supported-during-install) |

25| `EACCES: permission denied` während der Installation | [Korrigieren Sie die Berechtigungen des Installationsverzeichnisses](#permission-errors-during-installation) |

25| `TLS connect error` oder `SSL/TLS secure channel` | [Aktualisieren Sie CA-Zertifikate](#tls-or-ssl-connection-errors) |26| `TLS connect error` oder `SSL/TLS secure channel` | [Aktualisieren Sie CA-Zertifikate](#tls-or-ssl-connection-errors) |

26| `Failed to fetch version` oder kann den Download-Server nicht erreichen | [Überprüfen Sie Netzwerk- und Proxy-Einstellungen](#check-network-connectivity) |27| `Failed to fetch version` oder kann den Download-Server nicht erreichen | [Überprüfen Sie Netzwerk- und Proxy-Einstellungen](#check-network-connectivity) |

27| `irm is not recognized` oder `The token '&&' is not a valid statement separator` | [Verwenden Sie den richtigen Befehl für Ihre Shell](#wrong-install-command-on-windows) |28| `irm is not recognized` oder `The token '&&' is not a valid statement separator` | [Verwenden Sie den richtigen Befehl für Ihre Shell](#wrong-install-command-on-windows) |

295 Überprüfen Sie Verzeichnisberechtigungen296 Überprüfen Sie Verzeichnisberechtigungen

296</h3>297</h3>

297 298

298Das Installationsprogramm benötigt Schreibzugriff auf `~/.local/bin/` und `~/.claude/` auf macOS und Linux. Unter Windows befindet sich der Installationsort unter `%USERPROFILE%`, das standardmäßig von Ihrem Benutzer beschreibbar ist, daher gilt dieser Abschnitt dort selten.299Eine Installation, die an fehlenden Berechtigungen scheitert, nennt den Pfad, den sie nicht erstellen oder beschreiben konnte. Unter Windows schreibt die Installation unter `%USERPROFILE%`, das standardmäßig von Ihrem Benutzer beschreibbar ist, daher gilt dieser Abschnitt dort selten.

300

301Auf macOS und Linux schreibt die Installation an folgende Orte:

302

303* `~/.claude/downloads/`: wo der Installationsbefehl die heruntergeladene Binärdatei ablegt

304* `~/.local/bin/`: der `claude`-Launcher

305* `~/.local/share/claude/`: jede Version, die heruntergeladen wird

306* `~/.local/state/claude/`: die zugehörigen Sperrdateien

307* `~/.cache/claude/`: vorbereitete Downloads

308* [`~/.claude.json`](/docs/de/claude-directory): Ihre globale Konfigurationsdatei, in der das Installationsprogramm die Installationsmethode festhält

309

310Wenn Sie `XDG_DATA_HOME`, `XDG_STATE_HOME` oder `XDG_CACHE_HOME` setzen, verwendet die Installation diese anstelle von `~/.local/share`, `~/.local/state` und `~/.cache`. Wenn Sie [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) setzen, befindet sich die globale Konfigurationsdatei in diesem Verzeichnis statt in Ihrem Home-Verzeichnis.

299 311

300Überprüfen Sie, ob die Verzeichnisse beschreibbar sind:312Überprüfen Sie, ob die Verzeichnisse beschreibbar sind:

301 313

1014 1026

1015**Lösungen:**1027**Lösungen:**

1016 1028

1017* Drücken Sie Enter, um zu wiederholen und die Anmeldung schnell nach dem Öffnen des Browsers abzuschließen1029* Drücken Sie Enter, um es erneut zu versuchen, und schließen Sie die Anmeldung schnell nach dem Öffnen des Browsers ab

1018* Geben Sie `c` ein, um die vollständige URL zu kopieren, wenn der Browser nicht automatisch geöffnet wird1030* Geben Sie `c` ein, um die vollständige URL zu kopieren, wenn der Browser nicht automatisch geöffnet wird

1019* Wenn Sie eine Remote-/SSH-Sitzung verwenden, kann der Browser auf der falschen Maschine geöffnet werden. Kopieren Sie die im Terminal angezeigte URL und öffnen Sie sie stattdessen in Ihrem lokalen Browser.1031* Wenn Sie eine Remote-/SSH-Sitzung verwenden, kann der Browser auf der falschen Maschine geöffnet werden. Kopieren Sie die im Terminal angezeigte URL und öffnen Sie sie stattdessen in Ihrem lokalen Browser.

1020 1032

1045 1057

1046Wenn Sie `API Error: 400 ... "This organization has been disabled"` sehen, obwohl Sie ein aktives Claude-Abonnement haben, überschreibt eine `ANTHROPIC_API_KEY` Umgebungsvariable Ihr Abonnement. Dies geschieht häufig, wenn ein alter API-Schlüssel von einem früheren Arbeitgeber oder Projekt noch in Ihrem Shell-Profil gesetzt ist.1058Wenn Sie `API Error: 400 ... "This organization has been disabled"` sehen, obwohl Sie ein aktives Claude-Abonnement haben, überschreibt eine `ANTHROPIC_API_KEY` Umgebungsvariable Ihr Abonnement. Dies geschieht häufig, wenn ein alter API-Schlüssel von einem früheren Arbeitgeber oder Projekt noch in Ihrem Shell-Profil gesetzt ist.

1047 1059

1048Wenn `ANTHROPIC_API_KEY` vorhanden ist und Sie es genehmigt haben, verwendet Claude Code diesen Schlüssel statt der OAuth-Anmeldedaten Ihres Abonnements. Im nicht-interaktiven Modus mit dem `-p` Flag wird der Schlüssel immer verwendet, wenn er vorhanden ist. Siehe [Authentifizierungs-Priorität](/docs/de/authentication#authentication-precedence) für die vollständige Auflösungsreihenfolge.1060Wenn `ANTHROPIC_API_KEY` vorhanden ist und Sie es genehmigt haben, verwendet Claude Code diesen Schlüssel statt der OAuth-Anmeldedaten Ihres Abonnements. Im nicht interaktiven Modus mit dem `-p` Flag wird der Schlüssel immer verwendet, wenn er vorhanden ist. Siehe [Vorrang der Authentifizierung](/docs/de/authentication#authentication-precedence) für die vollständige Auflösungsreihenfolge.

1049 1061

1050Um stattdessen Ihr Abonnement zu verwenden, heben Sie die Umgebungsvariable auf und entfernen Sie sie aus Ihrem Shell-Profil:1062Um stattdessen Ihr Abonnement zu verwenden, heben Sie die Umgebungsvariable auf und entfernen Sie sie aus Ihrem Shell-Profil:

1051 1063

1098 1110

1099Führen Sie `/login` aus, um sich erneut zu authentifizieren. Wenn dies häufig geschieht, überprüfen Sie, dass Ihre Systemuhr genau ist, da die Token-Validierung von korrekten Zeitstempeln abhängt.1111Führen Sie `/login` aus, um sich erneut zu authentifizieren. Wenn dies häufig geschieht, überprüfen Sie, dass Ihre Systemuhr genau ist, da die Token-Validierung von korrekten Zeitstempeln abhängt.

1100 1112

1101Parallele Sitzungen auf einem Rechner teilen sich eine gespeicherte Anmeldung und koordinieren deren Erneuerung, sodass nur ein Prozess das Token gleichzeitig aktualisiert. Vor v2.1.211 konnte das Aufwecken des Rechners aus dem Ruhezustand dazu führen, dass zwei Sitzungen mit demselben Token erneuert werden, was die gespeicherte Anmeldung widerrief und jede offene Sitzung auf einmal erneut zur Anmeldung aufforderte.1113Parallele Sitzungen auf einem Rechner teilen sich eine gespeicherte Anmeldung und koordinieren deren Erneuerung, sodass nur ein Prozess das Token gleichzeitig aktualisiert. Was die anderen Sitzungen tun, nachdem Sie sich in einer davon erneut angemeldet haben, erfahren Sie unter [Nicht angemeldet](/docs/de/errors#not-logged-in).

1114

1115Vor v2.1.211 konnte das Aufwecken des Rechners aus dem Ruhezustand dazu führen, dass zwei Sitzungen mit demselben Token erneuert werden, was die gespeicherte Anmeldung widerrief und jede offene Sitzung auf einmal erneut zur Anmeldung aufforderte.

1102 1116

1103Auf macOS speichert Claude Code Anmeldedaten im Login-Keychain. Wenn der Keychain den Schreibzugriff ablehnt, z. B. wenn er in einer SSH-Sitzung gesperrt ist oder sein Passwort nicht mit Ihrem Kontopasswort synchronisiert ist, speichert Claude Code Ihre Anmeldung stattdessen in der Klartextdatei `~/.claude/.credentials.json`. Eine Console-Anmeldung, die einen API-Schlüssel erstellt, schlägt fehl, bis der Keychain wieder beschreibbar ist.1117Auf macOS speichert Claude Code Anmeldedaten im Login-Keychain. Wenn der Keychain den Schreibzugriff ablehnt, z. B. wenn er in einer SSH-Sitzung gesperrt ist oder sein Passwort nicht mit Ihrem Kontopasswort synchronisiert ist, speichert Claude Code Ihre Anmeldung stattdessen in der Klartextdatei `~/.claude/.credentials.json`. Eine Console-Anmeldung, die einen API-Schlüssel erstellt, schlägt fehl, bis der Keychain wieder beschreibbar ist.

1104 1118

troubleshooting.md +5 −0

Details

803. Verschieben Sie die Arbeit mit großen Dateien zu einem [Subagent](/docs/de/sub-agents), damit sie in einem separaten Kontextfenster ausgeführt wird803. Verschieben Sie die Arbeit mit großen Dateien zu einem [Subagent](/docs/de/sub-agents), damit sie in einem separaten Kontextfenster ausgeführt wird

814. Führen Sie `/clear` aus, wenn die frühere Konversation nicht mehr benötigt wird814. Führen Sie `/clear` aus, wenn die frühere Konversation nicht mehr benötigt wird

82 82

83Wenn der Fehler nach einem `/clear` erneut auftritt, führen Sie [`/context`](/docs/de/debug-your-config) aus und vergleichen Sie die Zeile `Messages` mit den Zeilen darüber:

85* **`Messages` ist die größte Zeile**: Eine Datei oder Toolausgabe in der neuen Konversation füllt das Fenster erneut, gehen Sie daher die Schritte 1 bis 3 noch einmal durch

86* **Die anderen Zeilen sind zusammen größer**: Was beim Sitzungsstart geladen wird, lässt zu wenig Platz zum Arbeiten, daher sollten Sie [reduzieren, was beim Start geladen wird](/docs/de/errors#prompt-is-too-long)

83<h3 id="command-hangs-or-freezes">88<h3 id="command-hangs-or-freezes">

84 Befehl hängt oder friert ein89 Befehl hängt oder friert ein

85</h3>90</h3>

worktrees.md +2 −0

Details

131 131

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

133 133

134Ein Subagent in seinem eigenen Worktree übernimmt die Anweisungsdateien, mit denen er [startet](/docs/de/sub-agents#what-loads-at-startup), aus Ihrer Hauptkonversation, nicht aus seinem Worktree. Wenn sich dieser Worktree am Standardspeicherort unter `.claude/worktrees/` befindet, lädt der Subagent außerdem weder die `CLAUDE.md`-Datei noch das Verzeichnis `.claude/rules/` im Stammverzeichnis des Worktrees, während er dort Dateien liest, selbst wenn sich diese auf dem Branch des Worktrees unterscheiden.

135

134<h3 id="clean-up-subagent-and-background-session-worktrees">136<h3 id="clean-up-subagent-and-background-session-worktrees">

135 Bereinigen Sie Subagent- und Hintergrund-Sitzungs-Worktrees137 Bereinigen Sie Subagent- und Hintergrund-Sitzungs-Worktrees

136</h3>138</h3>

Documentation 2026-10-01 23:59 UTC to 2026-10-02 02:02 UTC