Documentation — Spybara

accessibility.md +18 −18

Details

22 22

23* Für eine Sitzung: Führen Sie `claude --ax-screen-reader` aus.23* Für eine Sitzung: Führen Sie `claude --ax-screen-reader` aus.

24* Für Sitzungen, die von einer Shell aus gestartet werden: Setzen Sie die Umgebungsvariable `CLAUDE_AX_SCREEN_READER` auf `1`. In Bash oder Zsh führen Sie `export CLAUDE_AX_SCREEN_READER=1` aus; in PowerShell führen Sie `$env:CLAUDE_AX_SCREEN_READER = "1"` aus. Fügen Sie die Zeile zu Ihrem Shell-Profil hinzu, um alle Shells abzudecken.24* Für Sitzungen, die von einer Shell aus gestartet werden: Setzen Sie die Umgebungsvariable `CLAUDE_AX_SCREEN_READER` auf `1`. In Bash oder Zsh führen Sie `export CLAUDE_AX_SCREEN_READER=1` aus; in PowerShell führen Sie `$env:CLAUDE_AX_SCREEN_READER = "1"` aus. Fügen Sie die Zeile zu Ihrem Shell-Profil hinzu, um alle Shells abzudecken.

25* Für jede Sitzung auf dem Computer: Fügen Sie `"axScreenReader": true` zu Ihrer Benutzerdatei [Einstellungsdatei](/de/settings) hinzu. Dies deckt jedes Terminal ab, einschließlich des integrierten VS Code-Terminals.25* Für jede Sitzung auf dem Computer: Fügen Sie `"axScreenReader": true` zu Ihrer Benutzerdatei [Einstellungsdatei](/docs/de/settings) hinzu. Dies deckt jedes Terminal ab, einschließlich des integrierten VS Code-Terminals.

26 26

27<Note>27<Note>

28 Die Methoden sind in Prioritätsreihenfolge aufgelistet: Das Flag [`--ax-screen-reader`](/de/cli-reference#cli-flags) überschreibt die Umgebungsvariable [`CLAUDE_AX_SCREEN_READER`](/de/env-vars), die die Einstellung [`axScreenReader`](/de/settings#available-settings) überschreibt.28 Die Methoden sind in Prioritätsreihenfolge aufgelistet: Das Flag [`--ax-screen-reader`](/docs/de/cli-reference#cli-flags) überschreibt die Umgebungsvariable [`CLAUDE_AX_SCREEN_READER`](/docs/de/env-vars), die die Einstellung [`axScreenReader`](/docs/de/settings#available-settings) überschreibt.

29</Note>29</Note>

30 30

31Wenn Sie Claude Code über SSH verwenden, setzen Sie die Umgebungsvariable oder Einstellung auf dem Remote-Computer, auf dem Claude Code ausgeführt wird.31Wenn Sie Claude Code über SSH verwenden, setzen Sie die Umgebungsvariable oder Einstellung auf dem Remote-Computer, auf dem Claude Code ausgeführt wird.

32 32

33Wenn der Modus aktiviert ist, gibt Claude Code zunächst eine Bestätigungszeile aus, die die Methode benennt, die ihn aktiviert hat: `[Screen Reader Mode: on via flag]`, `[Screen Reader Mode: on via env]` oder `[Screen Reader Mode: on via settings]`. Das Methodenbenennungsformat erfordert Claude Code v2.1.206 oder später. Wenn Claude Code sich selbst neu startet, beispielsweise um die Installation eines Updates abzuschließen, erbt der neue Prozess den Modus durch die Umgebungsvariable `CLAUDE_AX_SCREEN_READER`, sodass seine Bestätigungszeile `[Screen Reader Mode: on via env]` lautet, unabhängig davon, welche Methode Sie verwendet haben.33Wenn der Modus aktiviert ist, gibt Claude Code zunächst eine Bestätigungszeile aus, die die Methode benennt, die ihn aktiviert hat: `[Screen Reader Mode: on via flag]`, `[Screen Reader Mode: on via env]` oder `[Screen Reader Mode: on via settings]`. Das Methodenbenennungsformat erfordert Claude Code v2.1.206 oder später. Wenn Claude Code sich selbst neu startet, beispielsweise um die Installation eines Updates abzuschließen, erbt der neue Prozess den Modus durch die Umgebungsvariable `CLAUDE_AX_SCREEN_READER`, sodass seine Bestätigungszeile `[Screen Reader Mode: on via env]` lautet, unabhängig davon, welche Methode Sie verwendet haben.

~~34{/* max-version: 2.1.205 */}Frühere Versionen geben `[Accessible screen reader mode: on]` aus.~~34Frühere Versionen geben `[Accessible screen reader mode: on]` aus.

35 35

36<h2 id="turn-off-screen-reader-mode">36<h2 id="turn-off-screen-reader-mode">

37 Bildschirmleser-Modus deaktivieren37 Bildschirmleser-Modus deaktivieren

48* keine Zeichnungszeichen für die Oberflächenelemente48* keine Zeichnungszeichen für die Oberflächenelemente

49* keine nur farbbasierten Hinweise49* keine nur farbbasierten Hinweise

50* keine Neuzeichnungen von Inhalten, die sich nicht geändert haben; Fortschrittsanzeigen werden als statischer Text dargestellt50* keine Neuzeichnungen von Inhalten, die sich nicht geändert haben; Fortschrittsanzeigen werden als statischer Text dargestellt

51* Tabellen in Claudes Antworten werden als `Header: value`-Sätze statt als Zeichnungsgitter gelesen. {/* min-version: 2.1.198 */}Erfordert Claude Code v2.1.198 oder später; frühere Versionen zeichnen Tabellen auch im Bildschirmleser-Modus als Gitter.51* Tabellen in Claudes Antworten werden als `Header: value`-Sätze statt als Zeichnungsgitter gelesen. Erfordert Claude Code v2.1.198 oder später; frühere Versionen zeichnen Tabellen auch im Bildschirmleser-Modus als Gitter.

52 52

53Die Ausgabe sammelt sich im Scrollback Ihres Terminals an, sodass Sie frühere Züge mit den Überprüfungsbefehlen Ihres Bildschirmlesers oder der Suchfunktion Ihres Terminals erneut lesen können.53Die Ausgabe sammelt sich im Scrollback Ihres Terminals an, sodass Sie frühere Züge mit den Überprüfungsbefehlen Ihres Bildschirmlesers oder der Suchfunktion Ihres Terminals erneut lesen können.

54 54

55Der Bildschirmleser-Modus wird als einfacher scrollender Text dargestellt, auch wenn Sie das [Vollbildrendering](/de/fullscreen) mit der Einstellung [`tui`](/de/settings#available-settings) aktiviert haben; die Einstellung hat keine Auswirkung, während der Modus aktiv ist. Angehängte Hintergrundsitzungen werden weiterhin im Vollbildmodus dargestellt; siehe [Bekannte Einschränkungen](#known-limitations).55Der Bildschirmleser-Modus wird als einfacher scrollender Text dargestellt, auch wenn Sie das [Vollbildrendering](/docs/de/fullscreen) mit der Einstellung [`tui`](/docs/de/settings#available-settings) aktiviert haben; die Einstellung hat keine Auswirkung, während der Modus aktiv ist. Angehängte Hintergrundsitzungen werden weiterhin im Vollbildmodus dargestellt; siehe [Bekannte Einschränkungen](#known-limitations).

56 56

57Jede Nachricht im Transkript beginnt mit einer Beschriftung, die Ihr Bildschirmleser ankündigt und benennt, was es ist: Ihre Nachrichten, Claudes Antworten, Werkzeugaktivität, Fehler und Eingabeaufforderungen. Die Beschriftungen sind auch durchsuchbar, sodass Sie zwischen Abschnitten des Transkripts springen können, indem Sie den Scrollback Ihres Terminals durchsuchen:57Jede Nachricht im Transkript beginnt mit einer Beschriftung, die Ihr Bildschirmleser ankündigt und benennt, was es ist: Ihre Nachrichten, Claudes Antworten, Werkzeugaktivität, Fehler und Eingabeaufforderungen. Die Beschriftungen sind auch durchsuchbar, sodass Sie zwischen Abschnitten des Transkripts springen können, indem Sie den Scrollback Ihres Terminals durchsuchen:

58 58

64| `tool error:` | Ein Werkzeug, das fehlgeschlagen ist |64| `tool error:` | Ein Werkzeug, das fehlgeschlagen ist |

65| `error:` | Ein Fehler in der Konversation, z. B. eine fehlgeschlagene API-Anfrage |65| `error:` | Ein Fehler in der Konversation, z. B. eine fehlgeschlagene API-Anfrage |

66| `Permission Required:` | Eine Berechtigungsaufforderung, die auf Ihre Antwort wartet |66| `Permission Required:` | Eine Berechtigungsaufforderung, die auf Ihre Antwort wartet |

68 68

69Der Terminal-Cursor folgt der Eingabemarke, sodass der Befehl zum Lesen der aktuellen Zeile eines Bildschirmlesers die Frage „Wo bin ich?" mit der Eingabeaufforderung beantwortet, die Sie bearbeiten.69Der Terminal-Cursor folgt der Eingabemarke, sodass der Befehl zum Lesen der aktuellen Zeile eines Bildschirmlesers die Frage „Wo bin ich?" mit der Eingabeaufforderung beantwortet, die Sie bearbeiten.

70 70

102* eine Berechtigungsaufforderung erscheint102* eine Berechtigungsaufforderung erscheint

103* ein Werkzeug, das länger als 5 Sekunden lief, beendet wird103* ein Werkzeug, das länger als 5 Sekunden lief, beendet wird

104 104

105Die Glocke ist die Standard-Warnung Ihres Terminals. Um sie stummzuschalten, ändern Sie die Glockeneinstellung in Ihrer Terminalanwendung. Die Glocke erfordert keinen Bildschirmleser-Modus: Außerhalb des Modus setzen Sie [`preferredNotifChannel`](/de/settings#available-settings) auf `"terminal_bell"` für ähnliche Warnungen, wenn Claude auf Sie wartet. Siehe [Terminal-Glocke oder Benachrichtigung erhalten](/de/terminal-config#get-a-terminal-bell-or-notification).105Die Glocke ist die Standard-Warnung Ihres Terminals. Um sie stummzuschalten, ändern Sie die Glockeneinstellung in Ihrer Terminalanwendung. Die Glocke erfordert keinen Bildschirmleser-Modus: Außerhalb des Modus setzen Sie [`preferredNotifChannel`](/docs/de/settings#available-settings) auf `"terminal_bell"` für ähnliche Warnungen, wenn Claude auf Sie wartet. Siehe [Terminal-Glocke oder Benachrichtigung erhalten](/docs/de/terminal-config#get-a-terminal-bell-or-notification).

106 106

107<h2 id="accessibility-settings-beyond-screen-reader-mode">107<h2 id="accessibility-settings-beyond-screen-reader-mode">

108 Barrierefreiheitseinstellungen außerhalb des Bildschirmleser-Modus108 Barrierefreiheitseinstellungen außerhalb des Bildschirmleser-Modus

110 110

111Diese Optionen behandeln Barrierefreiheitsanforderungen außerhalb des Bildschirmleser-Modus. Alle funktionieren zusammen mit ihm.111Diese Optionen behandeln Barrierefreiheitsanforderungen außerhalb des Bildschirmleser-Modus. Alle funktionieren zusammen mit ihm.

112 112

113* Die Umgebungsvariable `CLAUDE_CODE_ACCESSIBILITY` [environment variable](/de/env-vars) ist für Bildschirmlupe. Setzen Sie `CLAUDE_CODE_ACCESSIBILITY=1`, um den nativen Terminal-Cursor sichtbar zu halten, damit Lupen wie macOS Zoom die Cursor-Position verfolgen können.113* Die Umgebungsvariable `CLAUDE_CODE_ACCESSIBILITY` [environment variable](/docs/de/env-vars) ist für Bildschirmlupe. Setzen Sie `CLAUDE_CODE_ACCESSIBILITY=1`, um den nativen Terminal-Cursor sichtbar zu halten, damit Lupen wie macOS Zoom die Cursor-Position verfolgen können.

114* Die Einstellung `prefersReducedMotion` [setting](/de/settings#available-settings) reduziert oder deaktiviert Spinner, Shimmer und andere Animationen, ohne den Rest der Oberfläche zu ändern.114* Die Einstellung `prefersReducedMotion` [setting](/docs/de/settings#available-settings) reduziert oder deaktiviert Spinner, Shimmer und andere Animationen, ohne den Rest der Oberfläche zu ändern.

115* Die Einstellung `theme` [setting](/de/settings#available-settings) wählt die Oberflächenfarben aus, einschließlich der farbenblindfreundlichen Designs `dark-daltonized` und `light-daltonized`.115* Die Einstellung `theme` [setting](/docs/de/settings#available-settings) wählt die Oberflächenfarben aus, einschließlich der farbenblindfreundlichen Designs `dark-daltonized` und `light-daltonized`.

116 116

117<h2 id="known-limitations">117<h2 id="known-limitations">

118 Bekannte Einschränkungen118 Bekannte Einschränkungen

121Einige Verhaltensweisen sind nicht für den Bildschirmleser-Modus angepasst:121Einige Verhaltensweisen sind nicht für den Bildschirmleser-Modus angepasst:

122 122

123* Der Bildschirmleser-Modus wird nicht automatisch aktiviert, wenn ein Bildschirmleser ausgeführt wird.123* Der Bildschirmleser-Modus wird nicht automatisch aktiviert, wenn ein Bildschirmleser ausgeführt wird.

124* Modusänderungen, z. B. das Eingeben des [Plan-Modus](/de/permission-modes#analyze-before-you-edit-with-plan-mode), werden noch nicht angekündigt.124* Modusänderungen, z. B. das Eingeben des [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode), werden noch nicht angekündigt.

125* Das Anhängen an eine [Hintergrundsitzung](/de/agent-view) mit `claude attach` oder aus der Agent-Ansicht betritt den alternativen Bildschirm des Terminals, der keinen nativen Scrollback hat. Dies ist das [gleiche Verhalten wie bei anderen angehängten Sitzungen](/de/fullscreen). Um herauszukommen, drücken Sie den linken Pfeil bei einer leeren Eingabeaufforderung oder Ctrl+Z, wenn ein Dialog den Fokus hat.125* Das Anhängen an eine [Hintergrundsitzung](/docs/de/agent-view) mit `claude attach` oder aus der Agent-Ansicht betritt den alternativen Bildschirm des Terminals, der keinen nativen Scrollback hat. Dies ist das [gleiche Verhalten wie bei anderen angehängten Sitzungen](/docs/de/fullscreen). Um herauszukommen, drücken Sie den linken Pfeil bei einer leeren Eingabeaufforderung oder Ctrl+Z, wenn ein Dialog den Fokus hat.

126* Claude Code kündigt Kosten in der Zusammenfassung an, die es beim Beenden ausgibt, nicht pro Zug.126* Claude Code kündigt Kosten in der Zusammenfassung an, die es beim Beenden ausgibt, nicht pro Zug.

127* Der Bildschirmleser-Modus ändert den [nicht-interaktiven Modus](/de/headless) mit dem Flag `-p` nicht. Der nicht-interaktive Modus schreibt bereits einfachen Text und bleibt eine Alternative zum Scripting.127* Der Bildschirmleser-Modus ändert den [nicht-interaktiven Modus](/docs/de/headless) mit dem Flag `-p` nicht. Der nicht-interaktive Modus schreibt bereits einfachen Text und bleibt eine Alternative zum Scripting.

128 128

129<h2 id="report-an-issue">129<h2 id="report-an-issue">

130 Problem melden130 Problem melden

138 138

139Diese Seiten enthalten die vollständigen Referenzeinträge und verwandte Einrichtung für das, was diese Seite behandelt:139Diese Seiten enthalten die vollständigen Referenzeinträge und verwandte Einrichtung für das, was diese Seite behandelt:

140 140

141* [Einstellungen](/de/settings#available-settings): die Einträge `axScreenReader`, `prefersReducedMotion`, `theme` und `preferredNotifChannel`141* [Einstellungen](/docs/de/settings#available-settings): die Einträge `axScreenReader`, `prefersReducedMotion`, `theme` und `preferredNotifChannel`

142* [Umgebungsvariablen](/de/env-vars): die Einträge `CLAUDE_AX_SCREEN_READER` und `CLAUDE_CODE_ACCESSIBILITY`142* [Umgebungsvariablen](/docs/de/env-vars): die Einträge `CLAUDE_AX_SCREEN_READER` und `CLAUDE_CODE_ACCESSIBILITY`

143* [CLI-Referenz](/de/cli-reference#cli-flags): das Flag `--ax-screen-reader`143* [CLI-Referenz](/docs/de/cli-reference#cli-flags): das Flag `--ax-screen-reader`

144* [Terminal-Konfiguration](/de/terminal-config): Glocken, Benachrichtigungen und Designs außerhalb des Bildschirmleser-Modus144* [Terminal-Konfiguration](/docs/de/terminal-config): Glocken, Benachrichtigungen und Designs außerhalb des Bildschirmleser-Modus

145* [Nicht-interaktiver Modus](/de/headless): Skriptgesteuerte `claude -p`-Läufe, die einfachen Text ohne Bildschirmleser-Modus schreiben145* [Nicht-interaktiver Modus](/docs/de/headless): Skriptgesteuerte `claude -p`-Läufe, die einfachen Text ohne Bildschirmleser-Modus schreiben

advisor.md +17 −17

Details

22 22

23Der Advisor eignet sich für lange, mehrstufige Aufgaben, bei denen die meisten Schritte Routine sind, aber die Planqualität das Ergebnis bestimmt. Beispiele sind große Umstrukturierungen, Debugging-Sitzungen, bei denen ein Fehler immer wieder auftritt, und Aufgaben, die Sie unabhängig überprüft haben möchten, bevor Claude sie als abgeschlossen erklärt.23Der Advisor eignet sich für lange, mehrstufige Aufgaben, bei denen die meisten Schritte Routine sind, aber die Planqualität das Ergebnis bestimmt. Beispiele sind große Umstrukturierungen, Debugging-Sitzungen, bei denen ein Fehler immer wieder auftritt, und Aufgaben, die Sie unabhängig überprüft haben möchten, bevor Claude sie als abgeschlossen erklärt.

24 24

25Er bietet weniger Wert bei kurzen Aufgaben, bei denen es wenig zu planen gibt, oder bei Arbeiten, bei denen jeder Schritt das stärkste Modell benötigt. Für diese Fälle [wechseln Sie das Hauptmodell](/de/model-config#setting-your-model) oder siehe [wie der Advisor mit opusplan und Subagents verglichen wird](#compare-with-related-features) für andere Möglichkeiten, eine zweite Meinung zu erhalten.25Er bietet weniger Wert bei kurzen Aufgaben, bei denen es wenig zu planen gibt, oder bei Arbeiten, bei denen jeder Schritt das stärkste Modell benötigt. Für diese Fälle [wechseln Sie das Hauptmodell](/docs/de/model-config#setting-your-model) oder siehe [wie der Advisor mit opusplan und Subagents verglichen wird](#compare-with-related-features) für andere Möglichkeiten, eine zweite Meinung zu erhalten.

26 26

27<h2 id="enable-the-advisor">27<h2 id="enable-the-advisor">

28 Aktivieren Sie den Advisor28 Aktivieren Sie den Advisor

31Sie können das Advisor-Modell auf drei Arten festlegen:31Sie können das Advisor-Modell auf drei Arten festlegen:

32 32

33* **`/advisor` Befehl**: Legen Sie den Advisor während einer Sitzung fest oder ändern Sie ihn und speichern Sie ihn als Standard33* **`/advisor` Befehl**: Legen Sie den Advisor während einer Sitzung fest oder ändern Sie ihn und speichern Sie ihn als Standard

~~34* **`advisorModel` Einstellung**: Konfigurieren Sie einen persistenten Standard in Ihrer [Einstellungsdatei](/de/settings)~~34* **`advisorModel` Einstellung**: Konfigurieren Sie einen persistenten Standard in Ihrer [Einstellungsdatei](/docs/de/settings)

35* **`--advisor` Flag**: Legen Sie den Advisor für eine einzelne Sitzung beim Start fest35* **`--advisor` Flag**: Legen Sie den Advisor für eine einzelne Sitzung beim Start fest

36 36

37Wenn eine dieser Optionen ein Advisor-Modell festlegt, ist der Advisor für Sitzungen aktiviert, deren Hauptmodell [es unterstützt](#choose-an-advisor-model). Um die Verwendung zu beenden, siehe [Schalten Sie den Advisor aus](#turn-the-advisor-off).37Wenn eine dieser Optionen ein Advisor-Modell festlegt, ist der Advisor für Sitzungen aktiviert, deren Hauptmodell [es unterstützt](#choose-an-advisor-model). Um die Verwendung zu beenden, siehe [Schalten Sie den Advisor aus](#turn-the-advisor-off).

38 38

39<Note>39<Note>

~~40 Um Fable 5 als Advisor zu verwenden, benötigen Sie Claude Code v2.1.170 oder später und [Fable 5 Zugriff](/de/model-config#work-with-fable-5) für Ihre Organisation.~~40 Um Fable 5 als Advisor zu verwenden, benötigen Sie Claude Code v2.1.170 oder später und [Fable 5 Zugriff](/docs/de/model-config#work-with-fable-5) für Ihre Organisation.

41</Note>41</Note>

42 42

43<h3 id="use-the-/advisor-command">43<h3 id="use-the-/advisor-command">

50/advisor opus50/advisor opus

51```51```

52 52

53Ihre Auswahl wird in `advisorModel` in Ihren Benutzereinstellungen gespeichert und bleibt über Sitzungen hinweg erhalten. Wenn die [`availableModels`](/de/model-config#restrict-model-selection) Allowlist Ihrer Organisation das gespeicherte Advisor-Modell ausschließt, wird der Advisor nicht aufgerufen, bis Sie ein zulässiges Modell mit `/advisor` auswählen. Wenn Ihr aktuelles Hauptmodell den Advisor nicht unterstützt, wird die Auswahl trotzdem gespeichert und aktiviert sich, wenn Sie zu einem [kompatiblen Hauptmodell](#choose-an-advisor-model) mit [`/model`](/de/model-config#setting-your-model) wechseln.53Ihre Auswahl wird in `advisorModel` in Ihren Benutzereinstellungen gespeichert und bleibt über Sitzungen hinweg erhalten. Wenn die [`availableModels`](/docs/de/model-config#restrict-model-selection) Allowlist Ihrer Organisation das gespeicherte Advisor-Modell ausschließt, wird der Advisor nicht aufgerufen, bis Sie ein zulässiges Modell mit `/advisor` auswählen. Wenn Ihr aktuelles Hauptmodell den Advisor nicht unterstützt, wird die Auswahl trotzdem gespeichert und aktiviert sich, wenn Sie zu einem [kompatiblen Hauptmodell](#choose-an-advisor-model) mit [`/model`](/docs/de/model-config#setting-your-model) wechseln.

54 54

55<h3 id="set-advisormodel-in-settings">55<h3 id="set-advisormodel-in-settings">

56 Legen Sie `advisorModel` in den Einstellungen fest56 Legen Sie `advisorModel` in den Einstellungen fest

74claude --advisor opus74claude --advisor opus

75```75```

76 76

77Das Flag hat Vorrang vor der `advisorModel` Einstellung für diese Sitzung. Es beendet sich mit einem Fehler, wenn das Hauptmodell der Sitzung den Advisor nicht unterstützt, oder wenn das angeforderte Advisor-Modell durch die [`availableModels`](/de/model-config#restrict-model-selection) Allowlist Ihrer Organisation ausgeschlossen ist.77Das Flag hat Vorrang vor der `advisorModel` Einstellung für diese Sitzung. Es beendet sich mit einem Fehler, wenn das Hauptmodell der Sitzung den Advisor nicht unterstützt, oder wenn das angeforderte Advisor-Modell durch die [`availableModels`](/docs/de/model-config#restrict-model-selection) Allowlist Ihrer Organisation ausgeschlossen ist.

78 78

79<h2 id="choose-an-advisor-model">79<h2 id="choose-an-advisor-model">

80 Wählen Sie ein Advisor-Modell80 Wählen Sie ein Advisor-Modell

83Der Advisor muss mindestens so leistungsfähig sein wie das Hauptmodell. Die akzeptierten Advisors für jedes Hauptmodell sind:83Der Advisor muss mindestens so leistungsfähig sein wie das Hauptmodell. Die akzeptierten Advisors für jedes Hauptmodell sind:

84 84

86| ----------------------------------------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |86| -------------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

88| Sonnet 4.6 | Fable, Opus, Sonnet | |88| Sonnet 4.6 | Fable, Opus, Sonnet | |

91| Opus 4.7 oder später | Fable, Opus 4.7, Opus 4.8 | Opus 4.7 und Opus 4.8 werden als gleich leistungsfähig eingestuft, daher akzeptiert jedes das andere als Advisor. Ein Opus 4.7 Hauptmodell mit einem Opus 4.6 oder Sonnet 5 Advisor wird abgelehnt |91| Opus 4.7 oder später | Fable, Opus 4.7, Opus 4.8 | Opus 4.7 und Opus 4.8 werden als gleich leistungsfähig eingestuft, daher akzeptiert jedes das andere als Advisor. Ein Opus 4.7 Hauptmodell mit einem Opus 4.6 oder Sonnet 5 Advisor wird abgelehnt |

92| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Ein Opus oder Sonnet Advisor wird abgelehnt |92| Fable 5 (v2.1.170+) | Fable | Ein Opus oder Sonnet Advisor wird abgelehnt |

93 93

94Fable 5 erfordert Claude Code v2.1.170 oder später und Fable 5 Zugriff, unabhängig davon, ob es als Hauptmodell oder als Advisor fungiert.94Fable 5 erfordert Claude Code v2.1.170 oder später und Fable 5 Zugriff, unabhängig davon, ob es als Hauptmodell oder als Advisor fungiert.

95 95

141 141

142Jeder Advisor-Aufruf sendet das Gespräch an das Advisor-Modell, daher verbraucht es Token zu den Sätzen des Advisor-Modells zusätzlich zu Ihrer Hauptmodellnutzung. Bei API-Abrechnung werden Advisor-Token zu den Input- und Output-Sätzen des Advisor-Modells berechnet. Bei Abonnementplänen zählt die Advisor-Nutzung zu den Nutzungsgrenzen Ihres Plans.142Jeder Advisor-Aufruf sendet das Gespräch an das Advisor-Modell, daher verbraucht es Token zu den Sätzen des Advisor-Modells zusätzlich zu Ihrer Hauptmodellnutzung. Bei API-Abrechnung werden Advisor-Token zu den Input- und Output-Sätzen des Advisor-Modells berechnet. Bei Abonnementplänen zählt die Advisor-Nutzung zu den Nutzungsgrenzen Ihres Plans.

143 143

144Claude ruft den Advisor an Entscheidungspunkten auf, nicht bei jedem Schritt, daher kostet die Kopplung eines schnelleren Hauptmodells mit einem stärkeren Advisor typischerweise weniger als das durchgehende Ausführen des stärkeren Modells. Die Advisor-Nutzung zählt zu den Sitzungssummen, die von [`/usage`](/de/costs#track-your-costs) angezeigt werden.144Claude ruft den Advisor an Entscheidungspunkten auf, nicht bei jedem Schritt, daher kostet die Kopplung eines schnelleren Hauptmodells mit einem stärkeren Advisor typischerweise weniger als das durchgehende Ausführen des stärkeren Modells. Die Advisor-Nutzung zählt zu den Sitzungssummen, die von [`/usage`](/docs/de/costs#track-your-costs) angezeigt werden.

145 145

146Für die Berichterstattung von Advisor-Token in API-Antworten siehe [Nutzung und Abrechnung](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#usage-and-billing) in der Claude API-Dokumentation.146Für die Berichterstattung von Advisor-Token in API-Antworten siehe [Nutzung und Abrechnung](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#usage-and-billing) in der Claude API-Dokumentation.

147 147

149 Auswirkung auf Prompt-Caching149 Auswirkung auf Prompt-Caching

150</h2>150</h2>

151 151

152Das Aktivieren oder Deaktivieren des Advisors während einer Sitzung invalidiert nicht den [Prompt-Cache](/de/prompt-caching) Ihres Hauptmodells. Im Gegensatz zum [Ändern von Modell oder Aufwandsstufe](/de/prompt-caching#actions-that-invalidate-the-cache) behält das Umschalten von `/advisor` das zwischengespeicherte Präfix bei, und die vom Advisor zurückgegebene Anleitung wird als Teil des Transkripts bei späteren Schritten zwischengespeichert.152Das Aktivieren oder Deaktivieren des Advisors während einer Sitzung invalidiert nicht den [Prompt-Cache](/docs/de/prompt-caching) Ihres Hauptmodells. Im Gegensatz zum [Ändern von Modell oder Aufwandsstufe](/docs/de/prompt-caching#actions-that-invalidate-the-cache) behält das Umschalten von `/advisor` das zwischengespeicherte Präfix bei, und die vom Advisor zurückgegebene Anleitung wird als Teil des Transkripts bei späteren Schritten zwischengespeichert.

153 153

154Das eigene Lesen des Advisor-Modells des Gesprächs wird nicht zwischengespeichert. Jeder Advisor-Aufruf verarbeitet das gesamte Transkript neu, ohne Wiederverwendung zwischen Aufrufen.154Das eigene Lesen des Advisor-Modells des Gesprächs wird nicht zwischengespeichert. Jeder Advisor-Aufruf verarbeitet das gesamte Transkript neu, ohne Wiederverwendung zwischen Aufrufen.

155 155

159 159

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

161 161

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

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

164 164

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

166 Schalten Sie den Advisor aus166 Schalten Sie den Advisor aus

172/advisor off172/advisor off

173```173```

174 174

175Um das Advisor-Tool vollständig zu deaktivieren, setzen Sie `CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`. Der `/advisor` Befehl wird nicht verfügbar und jedes konfigurierte `advisorModel` wird ignoriert. Das `--advisor` Flag wird akzeptiert, hat aber keine Auswirkung; vorhandene Skripte, die es übergeben, funktionieren weiterhin ohne Fehler. Siehe [Umgebungsvariablen](/de/env-vars).175Um das Advisor-Tool vollständig zu deaktivieren, setzen Sie `CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`. Der `/advisor` Befehl wird nicht verfügbar und jedes konfigurierte `advisorModel` wird ignoriert. Das `--advisor` Flag wird akzeptiert, hat aber keine Auswirkung; vorhandene Skripte, die es übergeben, funktionieren weiterhin ohne Fehler. Siehe [Umgebungsvariablen](/docs/de/env-vars).

176 176

177<h2 id="compare-with-related-features">177<h2 id="compare-with-related-features">

178 Vergleich mit verwandten Funktionen178 Vergleich mit verwandten Funktionen

184| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |184| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |

186| [`opusplan`](/de/model-config#opusplan-model-setting) | Während des Plan-Modus, wenn [erlaubt durch `availableModels`](/de/model-config#restrict-model-selection), dann wechselt zu Sonnet für die Ausführung | Sie treten in den Plan-Modus ein |186| [`opusplan`](/docs/de/model-config#opusplan-model-setting) | Während des Plan-Modus, wenn [erlaubt durch `availableModels`](/docs/de/model-config#restrict-model-selection), dann wechselt zu Sonnet für die Ausführung | Sie treten in den Plan-Modus ein |

189 189

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

191 Siehe auch191 Siehe auch

192</h2>192</h2>

193 193

194* [Modellkonfiguration](/de/model-config): Wechseln Sie Modelle, legen Sie Aufwandsstufen fest und verwenden Sie `opusplan`194* [Modellkonfiguration](/docs/de/model-config): Wechseln Sie Modelle, legen Sie Aufwandsstufen fest und verwenden Sie `opusplan`

195* [Verwalten Sie Kosten effektiv](/de/costs): Verfolgen Sie die Token-Nutzung über Modelle hinweg195* [Verwalten Sie Kosten effektiv](/docs/de/costs): Verfolgen Sie die Token-Nutzung über Modelle hinweg

196* [Advisor-Tool in der Claude API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool): Verstehen Sie das zugrunde liegende Server-Tool oder verwenden Sie es direkt von der Messages API196* [Advisor-Tool in der Claude API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool): Verstehen Sie das zugrunde liegende Server-Tool oder verwenden Sie es direkt von der Messages API

197* [Die Advisor-Strategie](https://claude.com/blog/the-advisor-strategy): Warum die Kopplung eines schnellen Hauptmodells mit einem stärkeren Advisor funktioniert197* [Die Advisor-Strategie](https://claude.com/blog/the-advisor-strategy): Warum die Kopplung eines schnellen Hauptmodells mit einem stärkeren Advisor funktioniert

agent-sdk/hooks.md +21 −21

Details

26 </Step>26 </Step>

27 27

28 <Step title="Das SDK sammelt registrierte Hooks">28 <Step title="Das SDK sammelt registrierte Hooks">

29 Das SDK prüft auf Hooks, die für diesen Ereignistyp registriert sind. Dies umfasst Callback-Hooks, die Sie in `options.hooks` übergeben, und Shell-Befehls-Hooks aus Einstellungsdateien, wenn der entsprechende [`settingSources`](/de/agent-sdk/typescript#settingsource) oder [`setting_sources`](/de/agent-sdk/python#settingsource) Eintrag aktiviert ist, was für Standard-`query()`-Optionen der Fall ist.29 Das SDK prüft auf Hooks, die für diesen Ereignistyp registriert sind. Dies umfasst Callback-Hooks, die Sie in `options.hooks` übergeben, und Shell-Befehls-Hooks aus Einstellungsdateien, wenn der entsprechende [`settingSources`](/docs/de/agent-sdk/typescript#settingsource) oder [`setting_sources`](/docs/de/agent-sdk/python#settingsource) Eintrag aktiviert ist, was für Standard-`query()`-Optionen der Fall ist.

30 </Step>30 </Step>

31 31

32 <Step title="Matcher filtern, welche Hooks ausgeführt werden">32 <Step title="Matcher filtern, welche Hooks ausgeführt werden">

155| `PostToolUseFailure` | Ja | Ja | Tool-Ausführungsfehler | Tool-Fehler behandeln oder protokollieren |155| `PostToolUseFailure` | Ja | Ja | Tool-Ausführungsfehler | Tool-Fehler behandeln oder protokollieren |

157| `UserPromptSubmit` | Ja | Ja | Benutzer-Prompt-Übermittlung | Zusätzlichen Kontext in Prompts einfügen |157| `UserPromptSubmit` | Ja | Ja | Benutzer-Prompt-Übermittlung | Zusätzlichen Kontext in Prompts einfügen |

158| [`UserPromptExpansion`](/de/hooks#userpromptexpansion) | Nein | Ja | Ein von Benutzern eingegebener Befehl wird zu einem Prompt erweitert, bevor er Claude erreicht | Einen Befehl von direkter Aufrufe blockieren oder Kontext hinzufügen, wenn eine Skill eingegeben wird |158| [`UserPromptExpansion`](/docs/de/hooks#userpromptexpansion) | Nein | Ja | Ein von Benutzern eingegebener Befehl wird zu einem Prompt erweitert, bevor er Claude erreicht | Einen Befehl von direkter Aufrufe blockieren oder Kontext hinzufügen, wenn eine Skill eingegeben wird |

160| `Stop` | Ja | Ja | Agent-Ausführung stoppt | Sitzungsstatus vor dem Beenden speichern |160| `Stop` | Ja | Ja | Agent-Ausführung stoppt | Sitzungsstatus vor dem Beenden speichern |

161| `SubagentStart` | Ja | Ja | Subagent-Initialisierung | Parallele Task-Spawning verfolgen |161| `SubagentStart` | Ja | Ja | Subagent-Initialisierung | Parallele Task-Spawning verfolgen |

213 Matcher213 Matcher

214</h3>214</h3>

215 215

216Verwenden Sie Matcher, um zu filtern, wann Ihre Callbacks ausgelöst werden. Das `matcher` Feld wird gegen einen anderen Wert abgeglichen, je nach Hook-Ereignistyp. Beispielsweise werden Tool-basierte Hooks gegen den Tool-Namen abgeglichen, während `Notification` Hooks gegen den Benachrichtigungstyp abgeglichen werden. Siehe die [Claude Code Hooks-Referenz](/de/hooks#matcher-patterns) für die vollständige Liste der Matcher-Werte für jeden Ereignistyp.216Verwenden Sie Matcher, um zu filtern, wann Ihre Callbacks ausgelöst werden. Das `matcher` Feld wird gegen einen anderen Wert abgeglichen, je nach Hook-Ereignistyp. Beispielsweise werden Tool-basierte Hooks gegen den Tool-Namen abgeglichen, während `Notification` Hooks gegen den Benachrichtigungstyp abgeglichen werden. Siehe die [Claude Code Hooks-Referenz](/docs/de/hooks#matcher-patterns) für die vollständige Liste der Matcher-Werte für jeden Ereignistyp.

217 217

218SDK-Matcher folgen den gleichen Regeln wie [Matcher in Einstellungsdateien](/de/hooks#matcher-patterns). Ein Matcher, der nur Buchstaben, Ziffern, `_`, `-`, Leerzeichen, `,` und `|` enthält, wird als exakte Zeichenkette verglichen, wobei Alternativen durch `|` oder `,` und optionales umgebendes Leerzeichen getrennt werden, also `Write|Edit` und `Write, Edit` passen jeweils genau auf diese beiden Tools und `code-reviewer` passt nur auf diesen Agent-Typ. Ein Matcher von `*`, eine leere Zeichenkette oder das Weglassen des Matchers ganz passt auf jedes Vorkommen des Ereignisses.218SDK-Matcher folgen den gleichen Regeln wie [Matcher in Einstellungsdateien](/docs/de/hooks#matcher-patterns). Ein Matcher, der nur Buchstaben, Ziffern, `_`, `-`, Leerzeichen, `,` und `|` enthält, wird als exakte Zeichenkette verglichen, wobei Alternativen durch `|` oder `,` und optionales umgebendes Leerzeichen getrennt werden, also `Write|Edit` und `Write, Edit` passen jeweils genau auf diese beiden Tools und `code-reviewer` passt nur auf diesen Agent-Typ. Ein Matcher von `*`, eine leere Zeichenkette oder das Weglassen des Matchers ganz passt auf jedes Vorkommen des Ereignisses.

219 219

220Ein Matcher, der ein anderes Zeichen enthält, wird als unverankerte reguläre Ausdrücke ausgewertet, also `^mcp__` passt auf jedes MCP-Tool und `Edit.*` passt sowohl auf `Edit` als auch auf `NotebookEdit`. Umgeben Sie einen regulären Ausdruck mit `^` und `$`, wenn Sie eine Ganz-String-Übereinstimmung benötigen.220Ein Matcher, der ein anderes Zeichen enthält, wird als unverankerte reguläre Ausdrücke ausgewertet, also `^mcp__` passt auf jedes MCP-Tool und `Edit.*` passt sowohl auf `Edit` als auch auf `NotebookEdit`. Umgeben Sie einen regulären Ausdruck mit `^` und `$`, wenn Sie eine Ganz-String-Übereinstimmung benötigen.

221 221

225 225

226| Option | Typ | Standard | Beschreibung |226| Option | Typ | Standard | Beschreibung |

227| --------- | ---------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |227| --------- | ---------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

228| `matcher` | `string` | `undefined` | Muster, das gegen das Filterfeld des Ereignisses abgeglichen wird, nach den obigen Vergleichsregeln. Für Tool-Hooks ist dies der Tool-Name. Integrierte Tools umfassen `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` und andere (siehe [Tool-Eingabetypen](/de/agent-sdk/typescript#tool-input-types) für die vollständige Liste). MCP-Tools verwenden das Muster `mcp__<server>__<action>`. |228| `matcher` | `string` | `undefined` | Muster, das gegen das Filterfeld des Ereignisses abgeglichen wird, nach den obigen Vergleichsregeln. Für Tool-Hooks ist dies der Tool-Name. Integrierte Tools umfassen `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` und andere (siehe [Tool-Eingabetypen](/docs/de/agent-sdk/typescript#tool-input-types) für die vollständige Liste). MCP-Tools verwenden das Muster `mcp__<server>__<action>`. |

231 231

234Für Tool-basierte Hooks filtern Matcher nur nach Tool-Namen, nicht nach Dateipfaden oder anderen Argumenten. Um nach Dateipfad zu filtern, prüfen Sie `tool_input.file_path` in Ihrem Callback.234Für Tool-basierte Hooks filtern Matcher nur nach Tool-Namen, nicht nach Dateipfaden oder anderen Argumenten. Um nach Dateipfad zu filtern, prüfen Sie `tool_input.file_path` in Ihrem Callback.

235 235

236<Tip>236<Tip>

237 **Tool-Namen entdecken:** Siehe [Tool-Eingabetypen](/de/agent-sdk/typescript#tool-input-types) für die vollständige Liste der integrierten Tool-Namen, oder fügen Sie einen Hook ohne Matcher hinzu, um alle Tool-Aufrufe Ihrer Sitzung zu protokollieren.237 **Tool-Namen entdecken:** Siehe [Tool-Eingabetypen](/docs/de/agent-sdk/typescript#tool-input-types) für die vollständige Liste der integrierten Tool-Namen, oder fügen Sie einen Hook ohne Matcher hinzu, um alle Tool-Aufrufe Ihrer Sitzung zu protokollieren.

238 238

239 **MCP-Tool-Benennung:** MCP-Tools beginnen immer mit `mcp__` gefolgt vom Servernamen und der Aktion: `mcp__<server>__<action>`. Wenn Sie beispielsweise einen Server namens `playwright` konfigurieren, werden seine Tools `mcp__playwright__browser_screenshot`, `mcp__playwright__browser_click` usw. benannt. Der Servername kommt aus dem Schlüssel, den Sie in der `mcpServers` Konfiguration verwenden.239 **MCP-Tool-Benennung:** MCP-Tools beginnen immer mit `mcp__` gefolgt vom Servernamen und der Aktion: `mcp__<server>__<action>`. Wenn Sie beispielsweise einen Server namens `playwright` konfigurieren, werden seine Tools `mcp__playwright__browser_screenshot`, `mcp__playwright__browser_click` usw. benannt. Der Servername kommt aus dem Schlüssel, den Sie in der `mcpServers` Konfiguration verwenden.

240</Tip>240</Tip>

249 249

250Jeder Hook-Callback erhält drei Argumente:250Jeder Hook-Callback erhält drei Argumente:

251 251

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

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

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

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

262Ihr Callback gibt ein Objekt mit zwei Kategorien von Feldern zurück:262Ihr Callback gibt ein Objekt mit zwei Kategorien von Feldern zurück:

263 263

264* **Top-Level-Felder** funktionieren bei jedem Ereignis gleich: `systemMessage` zeigt eine Nachricht für den Benutzer an, und `continue` (`continue_` in Python) bestimmt, ob der Agent nach diesem Hook weiterläuft.264* **Top-Level-Felder** funktionieren bei jedem Ereignis gleich: `systemMessage` zeigt eine Nachricht für den Benutzer an, und `continue` (`continue_` in Python) bestimmt, ob der Agent nach diesem Hook weiterläuft.

265* **`hookSpecificOutput`** steuert die aktuelle Operation. Die Felder darin hängen vom Hook-Ereignistyp ab. Für `PreToolUse` Hooks ist dies der Ort, an dem Sie `permissionDecision` (`"allow"`, `"deny"`, `"ask"` oder `"defer"`), `permissionDecisionReason` und `updatedInput` setzen. Wenn Sie `"defer"` zurückgeben, endet die Abfrage, damit Sie sie [später fortsetzen](/de/hooks#defer-a-tool-call-for-later) können. Für `PostToolUse` Hooks können Sie `additionalContext` setzen, um Informationen zum Tool-Ergebnis anzuhängen. Um die Ausgabe des Tools vor Claude zu ersetzen, setzen Sie `updatedToolOutput`, das für jedes Tool in beiden SDKs funktioniert. Das ältere `updatedMCPToolOutput` Feld ersetzt nur MCP-Tool-Ausgabe und ist veraltet.265* **`hookSpecificOutput`** steuert die aktuelle Operation. Die Felder darin hängen vom Hook-Ereignistyp ab. Für `PreToolUse` Hooks ist dies der Ort, an dem Sie `permissionDecision` (`"allow"`, `"deny"`, `"ask"` oder `"defer"`), `permissionDecisionReason` und `updatedInput` setzen. Wenn Sie `"defer"` zurückgeben, endet die Abfrage, damit Sie sie [später fortsetzen](/docs/de/hooks#defer-a-tool-call-for-later) können. Für `PostToolUse` Hooks können Sie `additionalContext` setzen, um Informationen zum Tool-Ergebnis anzuhängen. Um die Ausgabe des Tools vor Claude zu ersetzen, setzen Sie `updatedToolOutput`, das für jedes Tool in beiden SDKs funktioniert. Das ältere `updatedMCPToolOutput` Feld ersetzt nur MCP-Tool-Ausgabe und ist veraltet.

266 266

267Geben Sie `{}` zurück, um die Operation ohne Änderungen zuzulassen. SDK-Callback-Hooks verwenden das gleiche JSON-Ausgabeformat wie [Claude Code Shell-Befehls-Hooks](/de/hooks#json-output), das jedes Feld und ereignisspezifische Option dokumentiert. Für die SDK-Typdefinitionen siehe die [TypeScript](/de/agent-sdk/typescript#synchookjsonoutput) und [Python](/de/agent-sdk/python#synchookjsonoutput) SDK-Referenzen.267Geben Sie `{}` zurück, um die Operation ohne Änderungen zuzulassen. SDK-Callback-Hooks verwenden das gleiche JSON-Ausgabeformat wie [Claude Code Shell-Befehls-Hooks](/docs/de/hooks#json-output), das jedes Feld und ereignisspezifische Option dokumentiert. Für die SDK-Typdefinitionen siehe die [TypeScript](/docs/de/agent-sdk/typescript#synchookjsonoutput) und [Python](/docs/de/agent-sdk/python#synchookjsonoutput) SDK-Referenzen.

268 268

269<Note>269<Note>

270 Wenn mehrere Hooks oder Berechtigungsregeln gelten, hat `deny` Vorrang vor `defer`, was Vorrang vor `ask` hat, was Vorrang vor `allow` hat. Wenn ein Hook `deny` zurückgibt, wird die Operation blockiert, unabhängig von anderen Hooks.270 Wenn mehrere Hooks oder Berechtigungsregeln gelten, hat `deny` Vorrang vor `defer`, was Vorrang vor `ask` hat, was Vorrang vor `allow` hat. Wenn ein Hook `deny` zurückgibt, wird die Operation blockiert, unabhängig von anderen Hooks.

539 Subagent-Aktivität verfolgen539 Subagent-Aktivität verfolgen

540</h3>540</h3>

541 541

542Verwenden Sie `SubagentStop` Hooks, um zu überwachen, wenn Subagents ihre Arbeit beenden. Siehe den vollständigen Eingabetyp in den [TypeScript](/de/agent-sdk/typescript#hookinput) und [Python](/de/agent-sdk/python#hookinput) SDK-Referenzen. Dieses Beispiel protokolliert eine Zusammenfassung jedes Mal, wenn ein Subagent abgeschlossen wird:542Verwenden Sie `SubagentStop` Hooks, um zu überwachen, wenn Subagents ihre Arbeit beenden. Siehe den vollständigen Eingabetyp in den [TypeScript](/docs/de/agent-sdk/typescript#hookinput) und [Python](/docs/de/agent-sdk/python#hookinput) SDK-Referenzen. Dieses Beispiel protokolliert eine Zusammenfassung jedes Mal, wenn ein Subagent abgeschlossen wird:

543 543

544<CodeGroup>544<CodeGroup>

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

791* Überprüfen Sie, ob der Hook-Ereignisname korrekt und case-sensitiv ist (`PreToolUse`, nicht `preToolUse`)791* Überprüfen Sie, ob der Hook-Ereignisname korrekt und case-sensitiv ist (`PreToolUse`, nicht `preToolUse`)

792* Überprüfen Sie, ob Ihr Matcher-Muster den Tool-Namen genau abgleicht792* Überprüfen Sie, ob Ihr Matcher-Muster den Tool-Namen genau abgleicht

793* Stellen Sie sicher, dass der Hook unter dem richtigen Ereignistyp in `options.hooks` ist793* Stellen Sie sicher, dass der Hook unter dem richtigen Ereignistyp in `options.hooks` ist

794* Für Nicht-Tool-Hooks, die Matcher unterstützen, wie `Notification` und `SubagentStop`, gleichen Matcher gegen verschiedene Felder ab, und `Stop` ignoriert Matcher vollständig (siehe [Matcher-Muster](/de/hooks#matcher-patterns))794* Für Nicht-Tool-Hooks, die Matcher unterstützen, wie `Notification` und `SubagentStop`, gleichen Matcher gegen verschiedene Felder ab, und `Stop` ignoriert Matcher vollständig (siehe [Matcher-Muster](/docs/de/hooks#matcher-patterns))

795* Hooks werden möglicherweise nicht ausgelöst, wenn der Agent das [`max_turns`](/de/agent-sdk/python#claudeagentoptions) Limit erreicht, da die Sitzung endet, bevor Hooks ausgeführt werden können795* Hooks werden möglicherweise nicht ausgelöst, wenn der Agent das [`max_turns`](/docs/de/agent-sdk/python#claudeagentoptions) Limit erreicht, da die Sitzung endet, bevor Hooks ausgeführt werden können

796 796

797<h3 id="matcher-not-filtering-as-expected">797<h3 id="matcher-not-filtering-as-expected">

798 Matcher filtert nicht wie erwartet798 Matcher filtert nicht wie erwartet

818* Erhöhen Sie den `timeout` Wert in der `HookMatcher` Konfiguration818* Erhöhen Sie den `timeout` Wert in der `HookMatcher` Konfiguration

819* Verwenden Sie das `AbortSignal` aus dem dritten Callback-Argument, um Abbruch elegant in TypeScript zu behandeln819* Verwenden Sie das `AbortSignal` aus dem dritten Callback-Argument, um Abbruch elegant in TypeScript zu behandeln

820 820

821{/* min-version: 2.1.208 */}Ein `UserPromptSubmit` oder [`UserPromptExpansion`](/de/hooks#userpromptexpansion) Callback, das sein Timeout überschreitet, blockiert diese Aufforderung mit einer Timeout-Nachricht und die Sitzung wird fortgesetzt. Das Unterbrechen der Abfrage während ein Callback ausstehend ist, bricht den ausstehenden Tool-Aufruf ab. Vor v2.1.208 endete ein Callback-Timeout bei diesen Ereignissen die Abfrage mit `error_during_execution`, und ein Unterbrechen während eines ausstehenden `PreToolUse` Callbacks konnte den Tool-Aufruf fortfahren lassen.821Ein `UserPromptSubmit` oder [`UserPromptExpansion`](/docs/de/hooks#userpromptexpansion) Callback, das sein Timeout überschreitet, blockiert diese Aufforderung mit einer Timeout-Nachricht und die Sitzung wird fortgesetzt. Das Unterbrechen der Abfrage während ein Callback ausstehend ist, bricht den ausstehenden Tool-Aufruf ab. Vor v2.1.208 endete ein Callback-Timeout bei diesen Ereignissen die Abfrage mit `error_during_execution`, und ein Unterbrechen während eines ausstehenden `PreToolUse` Callbacks konnte den Tool-Aufruf fortfahren lassen.

822 822

823<h3 id="tool-blocked-unexpectedly">823<h3 id="tool-blocked-unexpectedly">

824 Tool wird unerwartet blockiert824 Tool wird unerwartet blockiert

852 Sitzungs-Hooks nicht in Python verfügbar852 Sitzungs-Hooks nicht in Python verfügbar

853</h3>853</h3>

854 854

855`SessionStart` und `SessionEnd` können als SDK-Callback-Hooks in TypeScript registriert werden, sind aber im Python SDK nicht verfügbar, da sein `HookEvent` Typ sie auslässt. In Python sind sie nur als [Shell-Befehls-Hooks](/de/hooks#hook-events) verfügbar, die in Einstellungsdateien wie `.claude/settings.json` definiert sind. Um Shell-Befehls-Hooks aus Ihrer SDK-Anwendung zu laden, schließen Sie die entsprechende Einstellungsquelle mit [`setting_sources`](/de/agent-sdk/python#settingsource) oder [`settingSources`](/de/agent-sdk/typescript#settingsource) ein:855`SessionStart` und `SessionEnd` können als SDK-Callback-Hooks in TypeScript registriert werden, sind aber im Python SDK nicht verfügbar, da sein `HookEvent` Typ sie auslässt. In Python sind sie nur als [Shell-Befehls-Hooks](/docs/de/hooks#hook-events) verfügbar, die in Einstellungsdateien wie `.claude/settings.json` definiert sind. Um Shell-Befehls-Hooks aus Ihrer SDK-Anwendung zu laden, schließen Sie die entsprechende Einstellungsquelle mit [`setting_sources`](/docs/de/agent-sdk/python#settingsource) oder [`settingSources`](/docs/de/agent-sdk/typescript#settingsource) ein:

856 856

857<CodeGroup>857<CodeGroup>

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

890 systemMessage wird nicht in der Ausgabe angezeigt890 systemMessage wird nicht in der Ausgabe angezeigt

891</h3>891</h3>

892 892

893Das `systemMessage` Feld zeigt eine Nachricht für den Benutzer an, nicht für das Modell. Standardmäßig gibt das SDK Hook-Ausgaben im Nachrichtenstrom nur für `SessionStart` und `Setup` Hooks aus, daher wird eine Nachricht von einem anderen Hook-Ereignis nicht angezeigt, es sei denn, Sie setzen `includeHookEvents` (`include_hook_events` in Python). Um stattdessen Kontext an das Modell zu übergeben, geben Sie [`additionalContext`](/de/hooks#add-context-for-claude) zurück.893Das `systemMessage` Feld zeigt eine Nachricht für den Benutzer an, nicht für das Modell. Standardmäßig gibt das SDK Hook-Ausgaben im Nachrichtenstrom nur für `SessionStart` und `Setup` Hooks aus, daher wird eine Nachricht von einem anderen Hook-Ereignis nicht angezeigt, es sei denn, Sie setzen `includeHookEvents` (`include_hook_events` in Python). Um stattdessen Kontext an das Modell zu übergeben, geben Sie [`additionalContext`](/docs/de/hooks#add-context-for-claude) zurück.

894 894

895Wenn Sie Hook-Entscheidungen für Ihre Anwendung zuverlässig sichtbar machen müssen, protokollieren Sie sie separat oder verwenden Sie einen dedizierten Ausgabekanal.895Wenn Sie Hook-Entscheidungen für Ihre Anwendung zuverlässig sichtbar machen müssen, protokollieren Sie sie separat oder verwenden Sie einen dedizierten Ausgabekanal.

896 896

898 Verwandte Ressourcen898 Verwandte Ressourcen

899</h2>899</h2>

900 900

901* [Claude Code Hooks-Referenz](/de/hooks): vollständige JSON-Eingabe-/Ausgabeschemas, Ereignisdokumentation und Matcher-Muster901* [Claude Code Hooks-Referenz](/docs/de/hooks): vollständige JSON-Eingabe-/Ausgabeschemas, Ereignisdokumentation und Matcher-Muster

902* [Claude Code Hooks-Leitfaden](/de/hooks-guide): Shell-Befehls-Hook-Beispiele und Walkthroughs902* [Claude Code Hooks-Leitfaden](/docs/de/hooks-guide): Shell-Befehls-Hook-Beispiele und Walkthroughs

903* [TypeScript SDK-Referenz](/de/agent-sdk/typescript): Hook-Typen, Eingabe-/Ausgabedefinitionen und Konfigurationsoptionen903* [TypeScript SDK-Referenz](/docs/de/agent-sdk/typescript): Hook-Typen, Eingabe-/Ausgabedefinitionen und Konfigurationsoptionen

904* [Python SDK-Referenz](/de/agent-sdk/python): Hook-Typen, Eingabe-/Ausgabedefinitionen und Konfigurationsoptionen904* [Python SDK-Referenz](/docs/de/agent-sdk/python): Hook-Typen, Eingabe-/Ausgabedefinitionen und Konfigurationsoptionen

905* [Berechtigungen](/de/agent-sdk/permissions): Steuern Sie, was Ihr Agent tun kann905* [Berechtigungen](/docs/de/agent-sdk/permissions): Steuern Sie, was Ihr Agent tun kann

906* [Benutzerdefinierte Tools](/de/agent-sdk/custom-tools): Erstellen Sie Tools, um Agent-Funktionen zu erweitern906* [Benutzerdefinierte Tools](/docs/de/agent-sdk/custom-tools): Erstellen Sie Tools, um Agent-Funktionen zu erweitern

agent-sdk/permissions.md +25 −25

Details

6 6

7> Kontrollieren Sie, wie Ihr Agent Tools mit Berechtigungsmodi, Hooks und deklarativen Allow/Deny-Regeln verwendet.7> Kontrollieren Sie, wie Ihr Agent Tools mit Berechtigungsmodi, Hooks und deklarativen Allow/Deny-Regeln verwendet.

8 8

9Das Claude Agent SDK bietet Berechtigungskontrollen zur Verwaltung der Tool-Nutzung durch Claude. Verwenden Sie Berechtigungsmodi und Regeln, um zu definieren, was automatisch zulässig ist, und den [`canUseTool`-Callback](/de/agent-sdk/user-input), um alles andere zur Laufzeit zu handhaben.9Das Claude Agent SDK bietet Berechtigungskontrollen zur Verwaltung der Tool-Nutzung durch Claude. Verwenden Sie Berechtigungsmodi und Regeln, um zu definieren, was automatisch zulässig ist, und den [`canUseTool`-Callback](/docs/de/agent-sdk/user-input), um alles andere zur Laufzeit zu handhaben.

10 10

11<Note>11<Note>

12 Diese Seite behandelt Berechtigungsmodi und Regeln. Um interaktive Genehmigungsabläufe zu erstellen, bei denen Benutzer Tool-Anfragen zur Laufzeit genehmigen oder ablehnen, siehe [Genehmigungen und Benutzereingaben handhaben](/de/agent-sdk/user-input).12 Diese Seite behandelt Berechtigungsmodi und Regeln. Um interaktive Genehmigungsabläufe zu erstellen, bei denen Benutzer Tool-Anfragen zur Laufzeit genehmigen oder ablehnen, siehe [Genehmigungen und Benutzereingaben handhaben](/docs/de/agent-sdk/user-input).

13</Note>13</Note>

14 14

15<h2 id="how-permissions-are-evaluated">15<h2 id="how-permissions-are-evaluated">

20 20

21<Steps>21<Steps>

22 <Step title="Hooks">22 <Step title="Hooks">

23 Führen Sie [Hooks](/de/agent-sdk/hooks) zuerst aus. Ein Hook kann den Aufruf direkt ablehnen oder ihn weitergeben. Ein Hook, der `allow` zurückgibt, überspringt nicht die Deny- und Ask-Regeln unten; diese werden unabhängig vom Hook-Ergebnis ausgewertet.23 Führen Sie [Hooks](/docs/de/agent-sdk/hooks) zuerst aus. Ein Hook kann den Aufruf direkt ablehnen oder ihn weitergeben. Ein Hook, der `allow` zurückgibt, überspringt nicht die Deny- und Ask-Regeln unten; diese werden unabhängig vom Hook-Ergebnis ausgewertet.

24 </Step>24 </Step>

25 25

26 <Step title="Deny-Regeln">26 <Step title="Deny-Regeln">

27 Prüfen Sie `deny`-Regeln (aus `disallowed_tools` und [settings.json](/de/settings#permission-settings)). Wenn eine Deny-Regel zutrifft, wird das Tool blockiert, auch im `bypassPermissions`-Modus. Bare-Name-Deny-Regeln wie `Bash` entfernen das Tool aus Claudes Kontext, bevor diese Auswertung beginnt, daher werden nur scoped-Regeln wie `Bash(rm *)` in diesem Schritt geprüft.27 Prüfen Sie `deny`-Regeln (aus `disallowed_tools` und [settings.json](/docs/de/settings#permission-settings)). Wenn eine Deny-Regel zutrifft, wird das Tool blockiert, auch im `bypassPermissions`-Modus. Bare-Name-Deny-Regeln wie `Bash` entfernen das Tool aus Claudes Kontext, bevor diese Auswertung beginnt, daher werden nur scoped-Regeln wie `Bash(rm *)` in diesem Schritt geprüft.

28 </Step>28 </Step>

29 29

30 <Step title="Ask-Regeln">30 <Step title="Ask-Regeln">

31 Prüfen Sie `ask`-Regeln aus [settings.json](/de/settings#permission-settings). Wenn eine Ask-Regel zutrifft, fällt der Aufruf zu Ihrem [`canUseTool`-Callback](/de/agent-sdk/user-input) zur Bestätigung durch, auch im `bypassPermissions`-Modus.31 Prüfen Sie `ask`-Regeln aus [settings.json](/docs/de/settings#permission-settings). Wenn eine Ask-Regel zutrifft, fällt der Aufruf zu Ihrem [`canUseTool`-Callback](/docs/de/agent-sdk/user-input) zur Bestätigung durch, auch im `bypassPermissions`-Modus.

32 32

33 Tools, die Benutzerinteraktion erfordern, verhalten sich auf die gleiche Weise: `AskUserQuestion` und MCP-Tools, deren Server [`_meta["anthropic/requiresUserInteraction"]`](/de/mcp#require-approval-for-a-specific-tool) setzt, fallen immer zum Callback durch, auch wenn eine Allow-Regel zutrifft. Im `dontAsk`-Modus werden beide Fälle stattdessen abgelehnt, da dieser Modus niemals eine Aufforderung anzeigt. {/* min-version: 2.1.199 */}Die MCP-Anmerkung erfordert Claude Code v2.1.199 oder später.33 Tools, die Benutzerinteraktion erfordern, verhalten sich auf die gleiche Weise: `AskUserQuestion` und MCP-Tools, deren Server [`_meta["anthropic/requiresUserInteraction"]`](/docs/de/mcp#require-approval-for-a-specific-tool) setzt, fallen immer zum Callback durch, auch wenn eine Allow-Regel zutrifft. Im `dontAsk`-Modus werden beide Fälle stattdessen abgelehnt, da dieser Modus niemals eine Aufforderung anzeigt. Die MCP-Anmerkung erfordert Claude Code v2.1.199 oder später.

34 34

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

36 </Step>36 </Step>

37 37

38 <Step title="Berechtigungsmodus">38 <Step title="Berechtigungsmodus">

44 </Step>44 </Step>

45 45

46 <Step title="canUseTool-Callback">46 <Step title="canUseTool-Callback">

47 Wenn nicht durch eines der oben genannten Verfahren gelöst, rufen Sie Ihren [`canUseTool`-Callback](/de/agent-sdk/user-input) für eine Entscheidung auf. Im `dontAsk`-Modus wird dieser Schritt übersprungen und das Tool wird abgelehnt.47 Wenn nicht durch eines der oben genannten Verfahren gelöst, rufen Sie Ihren [`canUseTool`-Callback](/docs/de/agent-sdk/user-input) für eine Entscheidung auf. Im `dontAsk`-Modus wird dieser Schritt übersprungen und das Tool wird abgelehnt.

48 </Step>48 </Step>

49</Steps>49</Steps>

50 50

57 57

58Einträge mit einem Spezifizierer wie `Bash(ls *)` und der `acceptEdits`-Modus lösen ihn nicht aus, und Allow-Regeln aus Einstellungsdateien sind für die Prüfung nicht sichtbar.58Einträge mit einem Spezifizierer wie `Bash(ls *)` und der `acceptEdits`-Modus lösen ihn nicht aus, und Allow-Regeln aus Einstellungsdateien sind für die Prüfung nicht sichtbar.

59 59

60Hören Sie mit `process.on('warning', ...)` zu und gleichen Sie den Code ab, um ihn zu protokollieren oder zu unterdrücken. Um jeden Tool-Aufruf unabhängig von Modus und Regeln zu steuern, verwenden Sie stattdessen einen [`PreToolUse`-Hook](/de/agent-sdk/hooks).60Hören Sie mit `process.on('warning', ...)` zu und gleichen Sie den Code ab, um ihn zu protokollieren oder zu unterdrücken. Um jeden Tool-Aufruf unabhängig von Modus und Regeln zu steuern, verwenden Sie stattdessen einen [`PreToolUse`-Hook](/docs/de/agent-sdk/hooks).

61 61

62Diese Seite konzentriert sich auf **Allow- und Deny-Regeln** sowie **Berechtigungsmodi**. Für die anderen Schritte:62Diese Seite konzentriert sich auf **Allow- und Deny-Regeln** sowie **Berechtigungsmodi**. Für die anderen Schritte:

63 63

~~64* **Hooks:** Führen Sie benutzerdefinierten Code aus, um Tool-Anfragen zu genehmigen, abzulehnen oder zu ändern. Siehe [Ausführung mit Hooks steuern](/de/agent-sdk/hooks).~~64* **Hooks:** Führen Sie benutzerdefinierten Code aus, um Tool-Anfragen zu genehmigen, abzulehnen oder zu ändern. Siehe [Ausführung mit Hooks steuern](/docs/de/agent-sdk/hooks).

65* **canUseTool-Callback:** Fordern Sie Benutzer zur Laufzeit zur Genehmigung auf, wenn kein früherer Schritt den Aufruf löst. Siehe [Genehmigungen und Benutzereingaben handhaben](/de/agent-sdk/user-input).65* **canUseTool-Callback:** Fordern Sie Benutzer zur Laufzeit zur Genehmigung auf, wenn kein früherer Schritt den Aufruf löst. Siehe [Genehmigungen und Benutzereingaben handhaben](/docs/de/agent-sdk/user-input).

66 66

67<h2 id="allow-and-deny-rules">67<h2 id="allow-and-deny-rules">

68 Allow- und Deny-Regeln68 Allow- und Deny-Regeln

81 81

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

83 83

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

85 85

86<Warning>86<Warning>

87 **Auto-genehmigte Tools erreichen `canUseTool` nie.** Ein Tool-Aufruf, der in einem früheren Schritt genehmigt wurde, durch `acceptEdits` oder `bypassPermissions`, oder durch eine Allow-Regel, überspringt Ihren `canUseTool`-Callback, sodass Berechtigungsprüfungen, die Sie dort durchführen, für dieses Tool stillschweigend umgangen werden. `AskUserQuestion`, MCP-Tools, die mit [`_meta["anthropic/requiresUserInteraction"]`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und Connector-Tools, [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools), erreichen den Callback immer noch, auch wenn eine Allow-Regel passt.87 **Auto-genehmigte Tools erreichen `canUseTool` nie.** Ein Tool-Aufruf, der in einem früheren Schritt genehmigt wurde, durch `acceptEdits` oder `bypassPermissions`, oder durch eine Allow-Regel, überspringt Ihren `canUseTool`-Callback, sodass Berechtigungsprüfungen, die Sie dort durchführen, für dieses Tool stillschweigend umgangen werden. `AskUserQuestion`, MCP-Tools, die mit [`_meta["anthropic/requiresUserInteraction"]`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und Connector-Tools, [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), erreichen den Callback immer noch, auch wenn eine Allow-Regel passt.

88 88

89 Die Abdeckung hängt von der Form des Eintrags ab: Ein einfacher Name wie `Read` oder `mcp__github__get_issue` genehmigt jeden Aufruf dieses Tools automatisch, während eine begrenzte Regel wie `Bash(ls *)` nur übereinstimmende Aufrufe automatisch genehmigt und andere `Bash`-Aufrufe immer noch zum Callback fallen. Für Prüfungen, die bei jedem Tool-Aufruf ausgeführt werden müssen, verwenden Sie einen [`PreToolUse`-Hook](/de/agent-sdk/hooks): Hooks werden vor jedem anderen Schritt ausgeführt, und eine Hook-Ablehnung gilt auch im `bypassPermissions`-Modus.89 Die Abdeckung hängt von der Form des Eintrags ab: Ein einfacher Name wie `Read` oder `mcp__github__get_issue` genehmigt jeden Aufruf dieses Tools automatisch, während eine begrenzte Regel wie `Bash(ls *)` nur übereinstimmende Aufrufe automatisch genehmigt und andere `Bash`-Aufrufe immer noch zum Callback fallen. Für Prüfungen, die bei jedem Tool-Aufruf ausgeführt werden müssen, verwenden Sie einen [`PreToolUse`-Hook](/docs/de/agent-sdk/hooks): Hooks werden vor jedem anderen Schritt ausgeführt, und eine Hook-Ablehnung gilt auch im `bypassPermissions`-Modus.

90</Warning>90</Warning>

91 91

92Für einen gesperrten Agent kombinieren Sie `allowedTools` mit `permissionMode: "dontAsk"`. Aufgelistete Tools werden genehmigt, abgesehen von den immer-Prompt-Tools in der obigen Warnung; alles andere wird direkt abgelehnt, anstatt zu fragen:92Für einen gesperrten Agent kombinieren Sie `allowedTools` mit `permissionMode: "dontAsk"`. Aufgelistete Tools werden genehmigt, abgesehen von den immer-Prompt-Tools in der obigen Warnung; alles andere wird direkt abgelehnt, anstatt zu fragen:

102 **`allowed_tools` beschränkt `bypassPermissions` nicht.** `allowed_tools` genehmigt nur die Tools, die Sie aufgelistet haben. Nicht aufgelistete Tools werden von keiner Allow-Regel erfasst und fallen durch zum Berechtigungsmodus, wo `bypassPermissions` sie genehmigt. Das Setzen von `allowed_tools=["Read"]` zusammen mit `permission_mode="bypassPermissions"` genehmigt immer noch jedes Tool, einschließlich `Bash`, `Write` und `Edit`. Wenn Sie `bypassPermissions` benötigen, aber bestimmte Tools blockieren möchten, verwenden Sie `disallowed_tools`.102 **`allowed_tools` beschränkt `bypassPermissions` nicht.** `allowed_tools` genehmigt nur die Tools, die Sie aufgelistet haben. Nicht aufgelistete Tools werden von keiner Allow-Regel erfasst und fallen durch zum Berechtigungsmodus, wo `bypassPermissions` sie genehmigt. Das Setzen von `allowed_tools=["Read"]` zusammen mit `permission_mode="bypassPermissions"` genehmigt immer noch jedes Tool, einschließlich `Bash`, `Write` und `Edit`. Wenn Sie `bypassPermissions` benötigen, aber bestimmte Tools blockieren möchten, verwenden Sie `disallowed_tools`.

103</Warning>103</Warning>

104 104

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

106 106

107<h2 id="permission-modes">107<h2 id="permission-modes">

108 Berechtigungsmodi108 Berechtigungsmodi

120| :------------------ | :----------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |120| :------------------ | :----------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

122| `dontAsk` | Ablehnung statt Nachfrage | Alles, das nicht von `allowed_tools` oder Regeln vorab genehmigt ist, wird abgelehnt; Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und Tools, die Benutzerinteraktion erfordern, werden abgelehnt, auch wenn Sie sie vorab genehmigt haben. `canUseTool` wird nie aufgerufen |122| `dontAsk` | Ablehnung statt Nachfrage | Alles, das nicht von `allowed_tools` oder Regeln vorab genehmigt ist, wird abgelehnt; Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und Tools, die Benutzerinteraktion erfordern, werden abgelehnt, auch wenn Sie sie vorab genehmigt haben. `canUseTool` wird nie aufgerufen |

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

124| `bypassPermissions` | Berechtigungsprüfungen umgehen | Tools werden ohne Berechtigungsaufforderungen ausgeführt, mit Ausnahme von Tools, die einer expliziten [`ask`-Regel](#how-permissions-are-evaluated) entsprechen, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und Tools, die Benutzerinteraktion erfordern (mit Vorsicht verwenden) |124| `bypassPermissions` | Berechtigungsprüfungen umgehen | Tools werden ohne Berechtigungsaufforderungen ausgeführt, mit Ausnahme von Tools, die einer expliziten [`ask`-Regel](#how-permissions-are-evaluated) entsprechen, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und Tools, die Benutzerinteraktion erfordern (mit Vorsicht verwenden) |

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

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

127 127

128<Warning>128<Warning>

129 **Subagent-Vererbung:** Wenn der übergeordnete Agent `bypassPermissions`, `acceptEdits` oder `auto` verwendet, erben alle Subagents diesen Modus und er kann nicht pro Subagent überschrieben werden. Subagents können unterschiedliche Systemaufforderungen und weniger eingeschränktes Verhalten als Ihr Hauptagent haben, daher erbt `bypassPermissions` ihnen vollständigen, autonomen Systemzugriff. Explizite [`ask`-Regeln](#how-permissions-are-evaluated), Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und Tools, die Benutzerinteraktion erfordern, erzwingen weiterhin eine Aufforderung.129 **Subagent-Vererbung:** Wenn der übergeordnete Agent `bypassPermissions`, `acceptEdits` oder `auto` verwendet, erben alle Subagents diesen Modus und er kann nicht pro Subagent überschrieben werden. Subagents können unterschiedliche Systemaufforderungen und weniger eingeschränktes Verhalten als Ihr Hauptagent haben, daher erbt `bypassPermissions` ihnen vollständigen, autonomen Systemzugriff. Explizite [`ask`-Regeln](#how-permissions-are-evaluated), Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und Tools, die Benutzerinteraktion erfordern, erzwingen weiterhin eine Aufforderung.

130</Warning>130</Warning>

131 131

132<h3 id="set-permission-mode">132<h3 id="set-permission-mode">

260 Don't Ask-Modus (`dontAsk`)260 Don't Ask-Modus (`dontAsk`)

261</h4>261</h4>

262 262

263Konvertiert jede Berechtigungsaufforderung in eine Ablehnung. Tools, die von `allowed_tools`, `settings.json`-Allow-Regeln oder einem Hook vorab genehmigt sind, werden normal ausgeführt. Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und Tools, die Benutzerinteraktion erfordern, werden abgelehnt, auch wenn eine Allow-Regel stimmt. Alles andere wird abgelehnt, ohne `canUseTool` aufzurufen.263Konvertiert jede Berechtigungsaufforderung in eine Ablehnung. Tools, die von `allowed_tools`, `settings.json`-Allow-Regeln oder einem Hook vorab genehmigt sind, werden normal ausgeführt. Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und Tools, die Benutzerinteraktion erfordern, werden abgelehnt, auch wenn eine Allow-Regel stimmt. Alles andere wird abgelehnt, ohne `canUseTool` aufzurufen.

264 264

265**Verwenden Sie, wenn:** Sie eine feste, explizite Tool-Oberfläche für einen Headless-Agent wünschen und eine harte Ablehnung gegenüber stiller Abhängigkeit von fehlender `canUseTool` bevorzugen.265**Verwenden Sie, wenn:** Sie eine feste, explizite Tool-Oberfläche für einen Headless-Agent wünschen und eine harte Ablehnung gegenüber stiller Abhängigkeit von fehlender `canUseTool` bevorzugen.

266 266

273<Warning>273<Warning>

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

275 275

276 `allowed_tools` beschränkt diesen Modus nicht. Jedes Tool wird genehmigt, nicht nur die, die Sie aufgelistet haben. Deny-Regeln (`disallowed_tools`), explizite `ask`-Regeln und Hooks werden vor der Modusüberprüfung ausgewertet und können ein Tool immer noch blockieren. Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und Tools, die Benutzerinteraktion erfordern, fallen weiterhin in Ihren `canUseTool`-Callback.276 `allowed_tools` beschränkt diesen Modus nicht. Jedes Tool wird genehmigt, nicht nur die, die Sie aufgelistet haben. Deny-Regeln (`disallowed_tools`), explizite `ask`-Regeln und Hooks werden vor der Modusüberprüfung ausgewertet und können ein Tool immer noch blockieren. Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und Tools, die Benutzerinteraktion erfordern, fallen weiterhin in Ihren `canUseTool`-Callback.

277</Warning>277</Warning>

278 278

279<h4 id="plan-mode-plan">279<h4 id="plan-mode-plan">

280 Plan-Modus (`plan`)280 Plan-Modus (`plan`)

281</h4>281</h4>

282 282

283Claude erkundet die Codebasis und erstellt einen Plan, ohne Ihre Quelldateien zu bearbeiten. Schreibgeschützte Tools werden wie im Standard-Modus ausgeführt. Dateibearbeitungen werden im Plan-Modus nie automatisch genehmigt, auch wenn eine Allow-Regel stimmt. Sie werden stattdessen durch Ihren `canUseTool`-Callback angefordert. Claude kann `AskUserQuestion` verwenden, um Anforderungen zu klären, bevor der Plan abgeschlossen wird. Siehe [Genehmigungen und Benutzereingaben handhaben](/de/agent-sdk/user-input#handle-clarifying-questions) für die Behandlung dieser Aufforderungen.283Claude erkundet die Codebasis und erstellt einen Plan, ohne Ihre Quelldateien zu bearbeiten. Schreibgeschützte Tools werden wie im Standard-Modus ausgeführt. Dateibearbeitungen werden im Plan-Modus nie automatisch genehmigt, auch wenn eine Allow-Regel stimmt. Sie werden stattdessen durch Ihren `canUseTool`-Callback angefordert. Claude kann `AskUserQuestion` verwenden, um Anforderungen zu klären, bevor der Plan abgeschlossen wird. Siehe [Genehmigungen und Benutzereingaben handhaben](/docs/de/agent-sdk/user-input#handle-clarifying-questions) für die Behandlung dieser Aufforderungen.

284 284

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

286 286

290 290

291Für die anderen Schritte im Berechtigungsauswertungsfluss:291Für die anderen Schritte im Berechtigungsauswertungsfluss:

292 292

293* [Genehmigungen und Benutzereingaben handhaben](/de/agent-sdk/user-input): interaktive Genehmigungsaufforderungen und Klärungsfragen293* [Genehmigungen und Benutzereingaben handhaben](/docs/de/agent-sdk/user-input): interaktive Genehmigungsaufforderungen und Klärungsfragen

294* [Hooks-Anleitung](/de/agent-sdk/hooks): Führen Sie benutzerdefinierten Code an Schlüsselpunkten im Agent-Lebenszyklus aus294* [Hooks-Anleitung](/docs/de/agent-sdk/hooks): Führen Sie benutzerdefinierten Code an Schlüsselpunkten im Agent-Lebenszyklus aus

295* [Berechtigungsregeln](/de/settings#permission-settings): deklarative Allow/Deny-Regeln in `settings.json`295* [Berechtigungsregeln](/docs/de/settings#permission-settings): deklarative Allow/Deny-Regeln in `settings.json`

agent-sdk/python.md +37 −37

Details

18pip install claude-agent-sdk18pip install claude-agent-sdk

19```19```

20 20

~~21Für uv, Windows PowerShell und API-Schlüssel-Setup siehe [Erste Schritte in der Agent SDK-Übersicht](/de/agent-sdk/overview#get-started).~~21Für uv, Windows PowerShell und API-Schlüssel-Setup siehe [Erste Schritte in der Agent SDK-Übersicht](/docs/de/agent-sdk/overview#get-started).

22 22

23<h2 id="choosing-between-query-and-claudesdkclient">23<h2 id="choosing-between-query-and-claudesdkclient">

24 Wahl zwischen `query()` und `ClaudeSDKClient`24 Wahl zwischen `query()` und `ClaudeSDKClient`

73 `query()`73 `query()`

74</h3>74</h3>

75 75

76Erstellt für jede Interaktion mit Claude Code standardmäßig eine neue Sitzung. Gibt einen asynchronen Iterator zurück, der Nachrichten bei ihrer Ankunft liefert. Jeder Aufruf von `query()` beginnt neu ohne Erinnerung an vorherige Interaktionen, es sei denn, Sie übergeben `continue_conversation=True` oder `resume` in [`ClaudeAgentOptions`](#claudeagentoptions). Siehe [Sitzungen](/de/agent-sdk/sessions).76Erstellt für jede Interaktion mit Claude Code standardmäßig eine neue Sitzung. Gibt einen asynchronen Iterator zurück, der Nachrichten bei ihrer Ankunft liefert. Jeder Aufruf von `query()` beginnt neu ohne Erinnerung an vorherige Interaktionen, es sei denn, Sie übergeben `continue_conversation=True` oder `resume` in [`ClaudeAgentOptions`](#claudeagentoptions). Siehe [Sitzungen](/docs/de/agent-sdk/sessions).

77 77

78```python theme={null}78```python theme={null}

79async def query(79async def query(

567| `set_model(model)` | Ändern Sie das Modell für die aktuelle Sitzung. Übergeben Sie `None`, um auf Standard zurückzusetzen |567| `set_model(model)` | Ändern Sie das Modell für die aktuelle Sitzung. Übergeben Sie `None`, um auf Standard zurückzusetzen |

568| `rewind_files(user_message_id)` | Stellen Sie Dateien in ihren Zustand bei der angegebenen Benutzernachricht wieder her. Erfordert `enable_file_checkpointing=True`. Siehe [Datei-Checkpointing](/de/agent-sdk/file-checkpointing) |568| `rewind_files(user_message_id)` | Stellen Sie Dateien in ihren Zustand bei der angegebenen Benutzernachricht wieder her. Erfordert `enable_file_checkpointing=True`. Siehe [Datei-Checkpointing](/docs/de/agent-sdk/file-checkpointing) |

569| `get_mcp_status()` | Rufen Sie den Status aller konfigurierten MCP-Server ab. Gibt [`McpStatusResponse`](#mcpstatusresponse) zurück |569| `get_mcp_status()` | Rufen Sie den Status aller konfigurierten MCP-Server ab. Gibt [`McpStatusResponse`](#mcpstatusresponse) zurück |

570| `reconnect_mcp_server(server_name)` | Versuchen Sie, eine Verbindung zu einem MCP-Server herzustellen, der fehlgeschlagen ist oder getrennt wurde |570| `reconnect_mcp_server(server_name)` | Versuchen Sie, eine Verbindung zu einem MCP-Server herzustellen, der fehlgeschlagen ist oder getrennt wurde |

571| `toggle_mcp_server(server_name, enabled)` | Aktivieren oder deaktivieren Sie einen MCP-Server während der Sitzung. Das Deaktivieren entfernt seine Tools |571| `toggle_mcp_server(server_name, enabled)` | Aktivieren oder deaktivieren Sie einen MCP-Server während der Sitzung. Das Deaktivieren entfernt seine Tools |

908| :---------------------------- | :------------------------------------------------------------------------------------ | :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |908| :---------------------------- | :------------------------------------------------------------------------------------ | :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

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

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

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

918| `max_budget_usd` | `float \| None` | `None` | Stoppen Sie die Abfrage, wenn die clientseitige Kostenschätzung diesen USD-Wert erreicht. Verglichen mit der gleichen Schätzung wie `total_cost_usd`; siehe [Kosten und Nutzung verfolgen](/de/agent-sdk/cost-tracking) für Genauigkeitsvorbehalt |918| `max_budget_usd` | `float \| None` | `None` | Stoppen Sie die Abfrage, wenn die clientseitige Kostenschätzung diesen USD-Wert erreicht. Verglichen mit der gleichen Schätzung wie `total_cost_usd`; siehe [Kosten und Nutzung verfolgen](/docs/de/agent-sdk/cost-tracking) für Genauigkeitsvorbehalt |

919| `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`. Siehe [Berechtigungen](/de/agent-sdk/permissions#allow-and-deny-rules) |919| `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`. Siehe [Berechtigungen](/docs/de/agent-sdk/permissions#allow-and-deny-rules) |

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

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

930| `env` | `dict[str, str]` | `{}` | Umgebungsvariablen, die auf der geerbten Prozessumgebung zusammengeführt werden. Siehe [Umgebungsvariablen](/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 |930| `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 |

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

935| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Tool-Berechtigungs-Callback, der nur aufgerufen wird, wenn der [Berechtigungsfluss](/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. `AskUserQuestion`, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und MCP-Tools, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, erreichen ihn auch, wenn Sie sie erlaubt haben; im `dontAsk`-Modus werden diese stattdessen verweigert. Siehe [`CanUseTool`](#canusetool) für Details |935| `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. `AskUserQuestion`, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, erreichen ihn auch, wenn Sie sie erlaubt haben; im `dontAsk`-Modus werden diese stattdessen verweigert. Siehe [`CanUseTool`](#canusetool) für Details |

944| `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. Verwaltete Richtlinieneinstellungen werden unabhängig davon geladen; Server-verwaltete Einstellungen werden abgerufen, wenn sich die Sitzung mit einer Organisationsanmeldedaten auf einer [berechtigten Konfiguration](/de/server-managed-settings#platform-availability) authentifiziert. Siehe [Claude Code-Funktionen verwenden](/de/agent-sdk/claude-code-features#what-settingsources-does-not-control) |944| `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. Verwaltete Richtlinieneinstellungen werden 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. Siehe [Claude Code-Funktionen verwenden](/docs/de/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

945| `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. 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](/de/agent-sdk/skills) |945| `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. 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) |

949| `session_store` | [`SessionStore`](/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](/de/agent-sdk/session-storage) |949| `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) |

950| `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 |950| `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 |

951 951

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

966```966```

967 967

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

969* `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`: Es wiederholt Kapazitätsfehler unbegrenzt, und {/* min-version: 2.1.199 */}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.969* `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`: 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.

970* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: Stall-Watchdog für Subagenten, die mit `run_in_background` gestartet werden. Standard `600000`. Setzt sich bei jedem Stream-Ereignis zurück; bei Stall bricht es den Subagenten ab, markiert die Aufgabe als fehlgeschlagen und zeigt den Fehler dem übergeordneten Element mit jedem Teilergebnis. Gilt nicht für synchrone Subagenten.970* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: Stall-Watchdog für Subagenten, die mit `run_in_background` gestartet werden. Standard `600000`. Setzt sich bei jedem Stream-Ereignis zurück; bei Stall bricht es den Subagenten ab, markiert die Aufgabe als fehlgeschlagen und zeigt den Fehler dem übergeordneten Element mit jedem Teilergebnis. Gilt nicht für synchrone Subagenten.

971* `CLAUDE_ENABLE_STREAM_WATCHDOG` mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: Bricht die Anfrage ab, 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. Die abgebrochene Anfrage durchläuft den normalen Wiederholungspfad.971* `CLAUDE_ENABLE_STREAM_WATCHDOG` mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: Bricht die Anfrage ab, 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. Die abgebrochene Anfrage durchläuft den normalen Wiederholungspfad.

972 972

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

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

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

1012 1012

1013<h3 id="systempromptfile">1013<h3 id="systempromptfile">

1014 `SystemPromptFile`1014 `SystemPromptFile`

1015</h3>1015</h3>

1016 1016

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

1018 1018

1019```python theme={null}1019```python theme={null}

1020class SystemPromptFile(TypedDict):1020class SystemPromptFile(TypedDict):

1047 Standardverhalten1047 Standardverhalten

1048</h4>1048</h4>

1049 1049

1050Wenn `setting_sources` weggelassen oder `None` ist, lädt `query()` die gleichen Dateisystem-Einstellungen wie die Claude Code CLI: Benutzer, Projekt und lokal. Verwaltete Richtlinieneinstellungen werden in allen Fällen geladen; Server-verwaltete Einstellungen werden abgerufen, wenn sich die Sitzung mit einer Organisationsanmeldedaten auf einer [berechtigten Konfiguration](/de/server-managed-settings#platform-availability) authentifiziert. Siehe [Was settingSources nicht kontrolliert](/de/agent-sdk/claude-code-features#what-settingsources-does-not-control) für Eingaben, die unabhängig von dieser Option gelesen werden, und wie man sie deaktiviert.1050Wenn `setting_sources` weggelassen oder `None` ist, lädt `query()` die gleichen Dateisystem-Einstellungen wie die Claude Code CLI: Benutzer, Projekt und lokal. Verwaltete Richtlinieneinstellungen werden 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. Siehe [Was settingSources nicht kontrolliert](/docs/de/agent-sdk/claude-code-features#what-settingsources-does-not-control) für Eingaben, die unabhängig von dieser Option gelesen werden, und wie man sie deaktiviert.

1051 1051

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

1053 Warum setting\_sources verwenden1053 Warum setting\_sources verwenden

1257 1257

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

1259 1259

1260Der Callback ist der SDK-Ersatz für die interaktive Berechtigungsaufforderung: Er wird nur aufgerufen, wenn der [Berechtigungsbewertungsfluss](/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](/de/agent-sdk/hooks). `AskUserQuestion`, MCP-Tools, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) erreichen den Callback auch, wenn eine Allow-Regel übereinstimmt. Im `dontAsk`-Modus werden diese Aufrufe stattdessen verweigert, ohne den Callback aufzurufen.1260Der 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). `AskUserQuestion`, MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) erreichen den Callback auch, wenn eine Allow-Regel übereinstimmt. Im `dontAsk`-Modus werden diese Aufrufe stattdessen verweigert, ohne den Callback aufzurufen.

1261 1261

1262<h3 id="toolpermissioncontext">1262<h3 id="toolpermissioncontext">

1263 `ToolPermissionContext`1263 `ToolPermissionContext`

1604]1604]

1605```1605```

1606 1606

1607Vollständige Informationen zum Erstellen und Verwenden von Plugins finden Sie unter [Plugins](/de/agent-sdk/plugins).1607Vollständige Informationen zum Erstellen und Verwenden von Plugins finden Sie unter [Plugins](/docs/de/agent-sdk/plugins).

1608 1608

1609<h2 id="message-types">1609<h2 id="message-types">

1610 Nachrichtentypen1610 Nachrichtentypen

1747 1747

1748| Schlüssel | Typ | Beschreibung |1748| Schlüssel | Typ | Beschreibung |

1749| ----------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1749| ----------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1750| `input_tokens` | `int` | Eingabe-Token, die von der Agent-Schleife auf oberster Ebene verbraucht werden. [Subagent-Token sind nicht enthalten](/de/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); verwenden Sie `model_usage` für die Gesamtbaum-Abrechnung. |1750| `input_tokens` | `int` | Eingabe-Token, die von der Agent-Schleife auf oberster Ebene verbraucht werden. [Subagent-Token sind nicht enthalten](/docs/de/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); verwenden Sie `model_usage` für die Gesamtbaum-Abrechnung. |

1751| `output_tokens` | `int` | Ausgabe-Token, die von der Agent-Schleife auf oberster Ebene generiert werden. Subagent-Token sind nicht enthalten. |1751| `output_tokens` | `int` | Ausgabe-Token, die von der Agent-Schleife auf oberster Ebene generiert werden. Subagent-Token sind nicht enthalten. |

1752| `cache_creation_input_tokens` | `int` | Token, die zum Erstellen neuer Cache-Einträge verwendet wurden. |1752| `cache_creation_input_tokens` | `int` | Token, die zum Erstellen neuer Cache-Einträge verwendet wurden. |

1753| `cache_read_input_tokens` | `int` | Token, die aus vorhandenen Cache-Einträgen gelesen wurden. |1753| `cache_read_input_tokens` | `int` | Token, die aus vorhandenen Cache-Einträgen gelesen wurden. |

1754 1754

1755Das `model_usage`-Dict ordnet Modellnamen der Nutzung pro Modell zu. Die inneren Dict-Schlüssel verwenden camelCase, da der Wert unverändert vom zugrunde liegenden CLI-Prozess übergeben wird und dem TypeScript [`ModelUsage`](/de/agent-sdk/typescript#modelusage)-Typ entspricht:1755Das `model_usage`-Dict ordnet Modellnamen der Nutzung pro Modell zu. Die inneren Dict-Schlüssel verwenden camelCase, da der Wert unverändert vom zugrunde liegenden CLI-Prozess übergeben wird und dem TypeScript [`ModelUsage`](/docs/de/agent-sdk/typescript#modelusage)-Typ entspricht:

1756 1756

1757| Schlüssel | Typ | Beschreibung |1757| Schlüssel | Typ | Beschreibung |

1758| -------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |1758| -------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1761| `cacheReadInputTokens` | `int` | Cache-Lese-Token für dieses Modell. |1761| `cacheReadInputTokens` | `int` | Cache-Lese-Token für dieses Modell. |

1762| `cacheCreationInputTokens` | `int` | Cache-Erstellungs-Token für dieses Modell. |1762| `cacheCreationInputTokens` | `int` | Cache-Erstellungs-Token für dieses Modell. |

1763| `webSearchRequests` | `int` | Websuch-Anfragen, die von diesem Modell gestellt wurden. |1763| `webSearchRequests` | `int` | Websuch-Anfragen, die von diesem Modell gestellt wurden. |

1764| `costUSD` | `float` | Geschätzte Kosten in USD für dieses Modell, clientseitig berechnet. Siehe [Kosten und Nutzung verfolgen](/de/agent-sdk/cost-tracking) für Abrechnungsvorbehalt. |1764| `costUSD` | `float` | Geschätzte Kosten in USD für dieses Modell, clientseitig berechnet. Siehe [Kosten und Nutzung verfolgen](/docs/de/agent-sdk/cost-tracking) für Abrechnungsvorbehalt. |

1765| `contextWindow` | `int` | Kontextfenstergröße für dieses Modell. |1765| `contextWindow` | `int` | Kontextfenstergröße für dieses Modell. |

1766| `maxOutputTokens` | `int` | Maximale Ausgabe-Token-Grenze für dieses Modell. |1766| `maxOutputTokens` | `int` | Maximale Ausgabe-Token-Grenze für dieses Modell. |

1767 1767

2088 Hook-Typen2088 Hook-Typen

2089</h2>2089</h2>

2090 2090

2091Einen umfassenden Leitfaden zur Verwendung von Hooks mit Beispielen und häufigen Mustern finden Sie im [Hooks-Leitfaden](/de/agent-sdk/hooks).2091Einen umfassenden Leitfaden zur Verwendung von Hooks mit Beispielen und häufigen Mustern finden Sie im [Hooks-Leitfaden](/docs/de/agent-sdk/hooks).

2092 2092

2093<h3 id="hookevent">2093<h3 id="hookevent">

2094 `HookEvent`2094 `HookEvent`

2472 `HookSpecificOutput`2472 `HookSpecificOutput`

2473</h4>2473</h4>

2474 2474

2475Ein `TypedDict`, das den Hook-Ereignisnamen und ereignisspezifische Felder enthält. Die Form hängt vom `hookEventName`-Wert ab. Vollständige Details zu verfügbaren Feldern pro Hook-Ereignis finden Sie unter [Ausführung mit Hooks kontrollieren](/de/agent-sdk/hooks#outputs).2475Ein `TypedDict`, das den Hook-Ereignisnamen und ereignisspezifische Felder enthält. Die Form hängt vom `hookEventName`-Wert ab. Vollständige Details zu verfügbaren Feldern pro Hook-Ereignis finden Sie unter [Ausführung mit Hooks kontrollieren](/docs/de/agent-sdk/hooks#outputs).

2476 2476

2477Eine diskriminierte Union von ereignisspezifischen Ausgabetypen. Das Feld `hookEventName` bestimmt, welche Felder gültig sind.2477Eine diskriminierte Union von ereignisspezifischen Ausgabetypen. Das Feld `hookEventName` bestimmt, welche Felder gültig sind.

2478 2478

2637 2637

2638**Tool-Name:** `AskUserQuestion`2638**Tool-Name:** `AskUserQuestion`

2639 2639

2640Stellt dem Benutzer während der Ausführung Klärungsfragen. Siehe [Genehmigungen und Benutzereingaben handhaben](/de/agent-sdk/user-input#handle-clarifying-questions) für Verwendungsdetails.2640Stellt dem Benutzer während der Ausführung Klärungsfragen. Siehe [Genehmigungen und Benutzereingaben handhaben](/docs/de/agent-sdk/user-input#handle-clarifying-questions) für Verwendungsdetails.

2641 2641

2642**Eingabe:**2642**Eingabe:**

2643 2643

2715 2715

2716Führt eine Background-Quelle aus und liefert jedes Ereignis an Claude, damit es reagieren kann, ohne zu pollen: `command` führt ein Skript aus und gibt ein Ereignis pro stdout-Zeile aus, und `ws` öffnet einen WebSocket und gibt ein Ereignis pro Textframe aus. Geben Sie genau eines von `command` oder `ws` an.2716Führt eine Background-Quelle aus und liefert jedes Ereignis an Claude, damit es reagieren kann, ohne zu pollen: `command` führt ein Skript aus und gibt ein Ereignis pro stdout-Zeile aus, und `ws` öffnet einen WebSocket und gibt ein Ereignis pro Textframe aus. Geben Sie genau eines von `command` oder `ws` an.

2717 2717

2718Wenn Monitor einen Befehl ausführt, folgt es den gleichen Berechtigungsregeln wie Bash; eine WebSocket-Überwachung fordert separat zur Genehmigung auf. {/* min-version: 2.1.195 */}Die `ws`-Quelle erfordert Claude Code v2.1.195 oder später. Siehe die [Monitor-Tool-Referenz](/de/tools-reference#monitor-tool) für Verhalten und Provider-Verfügbarkeit.2718Wenn Monitor einen Befehl ausführt, folgt es den gleichen Berechtigungsregeln wie Bash; eine WebSocket-Überwachung fordert separat zur Genehmigung auf. Die `ws`-Quelle erfordert Claude Code v2.1.195 oder später. Siehe die [Monitor-Tool-Referenz](/docs/de/tools-reference#monitor-tool) für Verhalten und Provider-Verfügbarkeit.

2719 2719

2720**Eingabe:**2720**Eingabe:**

2721 2721

2993**Tool-Name:** `TodoWrite`2993**Tool-Name:** `TodoWrite`

2994 2994

2995<Note>2995<Note>

2996 Ab Claude Code v2.1.142 ist `TodoWrite` standardmäßig deaktiviert. Verwenden Sie stattdessen `TaskCreate`, `TaskGet`, `TaskUpdate` und `TaskList`. Siehe [Zu Task-Tools migrieren](/de/agent-sdk/todo-tracking#migrate-to-task-tools), um Ihren Überwachungscode zu aktualisieren, oder setzen Sie `CLAUDE_CODE_ENABLE_TASKS=0`, um zu `TodoWrite` zurückzukehren.2996 Ab Claude Code v2.1.142 ist `TodoWrite` standardmäßig deaktiviert. Verwenden Sie stattdessen `TaskCreate`, `TaskGet`, `TaskUpdate` und `TaskList`. Siehe [Zu Task-Tools migrieren](/docs/de/agent-sdk/todo-tracking#migrate-to-task-tools), um Ihren Überwachungscode zu aktualisieren, oder setzen Sie `CLAUDE_CODE_ENABLE_TASKS=0`, um zu `TodoWrite` zurückzukehren.

2997</Note>2997</Note>

2998 2998

2999**Eingabe:**2999**Eingabe:**

3697 `SandboxNetworkConfig`3697 `SandboxNetworkConfig`

3698</h3>3698</h3>

3699 3699

3700Netzwerkspezifische Konfiguration für den Sandbox-Modus. Diese Einstellungen gelten für Sandbox-Bash-Befehle, wenn `enabled` in den übergeordneten [`SandboxSettings`](#sandboxsettings) auf `True` gesetzt ist. Sie beschränken das WebFetch-Tool nicht, das stattdessen [Berechtigungsregeln](/de/permissions#webfetch) verwendet.3700Netzwerkspezifische Konfiguration für den Sandbox-Modus. Diese Einstellungen gelten für Sandbox-Bash-Befehle, wenn `enabled` in den übergeordneten [`SandboxSettings`](#sandboxsettings) auf `True` gesetzt ist. Sie beschränken das WebFetch-Tool nicht, das stattdessen [Berechtigungsregeln](/docs/de/permissions#webfetch) verwendet.

3701 3701

3702```python theme={null}3702```python theme={null}

3703class SandboxNetworkConfig(TypedDict, total=False):3703class SandboxNetworkConfig(TypedDict, total=False):

3726 3726

3727<Note>3727<Note>

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

3729</Note>3729</Note>

3730 3730

3731<h3 id="sandboxignoreviolations">3731<h3 id="sandboxignoreviolations">

3829 Siehe auch3829 Siehe auch

3830</h2>3830</h2>

3831 3831

3832* [SDK-Übersicht](/de/agent-sdk/overview) - Allgemeine SDK-Konzepte3832* [SDK-Übersicht](/docs/de/agent-sdk/overview) - Allgemeine SDK-Konzepte

3833* [TypeScript SDK-Referenz](/de/agent-sdk/typescript) - TypeScript SDK-Dokumentation3833* [TypeScript SDK-Referenz](/docs/de/agent-sdk/typescript) - TypeScript SDK-Dokumentation

3834* [CLI-Referenz](/de/cli-reference) - Befehlszeilenschnittstelle3834* [CLI-Referenz](/docs/de/cli-reference) - Befehlszeilenschnittstelle

3835* [Häufige Workflows](/de/common-workflows) - Schritt-für-Schritt-Anleitungen3835* [Häufige Workflows](/docs/de/common-workflows) - Schritt-für-Schritt-Anleitungen

agent-sdk/subagents.md +16 −16

Details

17 17

18Sie können Subagenten auf drei Arten erstellen:18Sie können Subagenten auf drei Arten erstellen:

19 19

20* **Programmatisch**: Verwenden Sie den Parameter `agents` in Ihren `query()`-Optionen. Siehe die [TypeScript](/de/agent-sdk/typescript#agentdefinition)- und [Python](/de/agent-sdk/python#agentdefinition)-Referenzen20* **Programmatisch**: Verwenden Sie den Parameter `agents` in Ihren `query()`-Optionen. Siehe die [TypeScript](/docs/de/agent-sdk/typescript#agentdefinition)- und [Python](/docs/de/agent-sdk/python#agentdefinition)-Referenzen

~~21* **Dateisystem-basiert**: Definieren Sie Agenten als Markdown-Dateien in `.claude/agents/`-Verzeichnissen. Siehe [Subagenten als Dateien definieren](/de/sub-agents)~~21* **Dateisystem-basiert**: Definieren Sie Agenten als Markdown-Dateien in `.claude/agents/`-Verzeichnissen. Siehe [Subagenten als Dateien definieren](/docs/de/sub-agents)

22* **Integriert allgemein einsetzbar**: Claude kann den integrierten `general-purpose`-Subagenten jederzeit über das Agent-Tool aufrufen, ohne dass Sie etwas definieren müssen22* **Integriert allgemein einsetzbar**: Claude kann den integrierten `general-purpose`-Subagenten jederzeit über das Agent-Tool aufrufen, ohne dass Sie etwas definieren müssen

23 23

24Dieser Leitfaden konzentriert sich auf den programmatischen Ansatz, der für SDK-Anwendungen empfohlen wird.24Dieser Leitfaden konzentriert sich auf den programmatischen Ansatz, der für SDK-Anwendungen empfohlen wird.

199 199

200Im Python SDK verwenden Feldnamen mit mehreren Wörtern wie `disallowedTools` und `mcpServers` die camelCase-Schreibweise, um das Wire-Format zu entsprechen, anstatt der Python-Konvention snake\_case zu folgen. Siehe die [`AgentDefinition`-Referenz](/de/agent-sdk/python#agentdefinition) für Details.200Im Python SDK verwenden Feldnamen mit mehreren Wörtern wie `disallowedTools` und `mcpServers` die camelCase-Schreibweise, um das Wire-Format zu entsprechen, anstatt der Python-Konvention snake\_case zu folgen. Siehe die [`AgentDefinition`-Referenz](/docs/de/agent-sdk/python#agentdefinition) für Details.

201 201

202Zwei Subagenten-Verhaltensweisen haben sich in Claude Code v2.1.198 geändert:202Zwei Subagenten-Verhaltensweisen haben sich in Claude Code v2.1.198 geändert:

203 203

204* Subagenten werden standardmäßig im Hintergrund ausgeführt. Ein Agent-Tool-Aufruf, der die [`run_in_background`](/de/agent-sdk/typescript)-Eingabe auslässt, startet einen Hintergrund-Subagenten, und Claude setzt `run_in_background: false`, wenn es das Ergebnis benötigt, bevor es fortfährt. Vor v2.1.198 führte das Auslassen von `run_in_background` den Subagenten synchron aus. Setzen Sie das Feld `background` auf `true`, um die Hintergrund-Ausführung für einen bestimmten Agent zu erzwingen, unabhängig davon, was Claude anfordert.204* Subagenten werden standardmäßig im Hintergrund ausgeführt. Ein Agent-Tool-Aufruf, der die [`run_in_background`](/docs/de/agent-sdk/typescript)-Eingabe auslässt, startet einen Hintergrund-Subagenten, und Claude setzt `run_in_background: false`, wenn es das Ergebnis benötigt, bevor es fortfährt. Vor v2.1.198 führte das Auslassen von `run_in_background` den Subagenten synchron aus. Setzen Sie das Feld `background` auf `true`, um die Hintergrund-Ausführung für einen bestimmten Agent zu erzwingen, unabhängig davon, was Claude anfordert.

205* Ein Subagent erbt die Extended-Thinking-Konfiguration der Hauptsitzung. In früheren Versionen ist Extended Thinking in Subagenten deaktiviert, unabhängig von der Einstellung der Hauptsitzung.205* Ein Subagent erbt die Extended-Thinking-Konfiguration der Hauptsitzung. In früheren Versionen ist Extended Thinking in Subagenten deaktiviert, unabhängig von der Einstellung der Hauptsitzung.

206 206

207<Note>207<Note>

208 {/* min-version: 2.1.172 */}Ab Claude Code v2.1.172 können Subagenten ihre eigenen Subagenten spawnen. Ein Subagent fünf Ebenen unter dem Haupt-Agent kann keine weiteren Subagenten spawnen, unabhängig davon, ob er im Vordergrund oder Hintergrund ausgeführt wird. Um zu verhindern, dass ein Subagent andere spawnt, lassen Sie `Agent` aus seinem `tools`-Array weg oder fügen Sie es zu `disallowedTools` hinzu. Siehe [verschachtelte Subagenten](/de/sub-agents#spawn-nested-subagents) für die vollständigen Tiefenregeln.208 Ab Claude Code v2.1.172 können Subagenten ihre eigenen Subagenten spawnen. Ein Subagent fünf Ebenen unter dem Haupt-Agent kann keine weiteren Subagenten spawnen, unabhängig davon, ob er im Vordergrund oder Hintergrund ausgeführt wird. Um zu verhindern, dass ein Subagent andere spawnt, lassen Sie `Agent` aus seinem `tools`-Array weg oder fügen Sie es zu `disallowedTools` hinzu. Siehe [verschachtelte Subagenten](/docs/de/sub-agents#spawn-nested-subagents) für die vollständigen Tiefenregeln.

209</Note>209</Note>

210 210

211<h3 id="filesystem-based-definition-alternative">211<h3 id="filesystem-based-definition-alternative">

212 Dateisystem-basierte Definition (Alternative)212 Dateisystem-basierte Definition (Alternative)

213</h3>213</h3>

214 214

215Sie können Subagenten auch als Markdown-Dateien in `.claude/agents/`-Verzeichnissen definieren. Siehe die [Claude Code Subagenten-Dokumentation](/de/sub-agents) für Details zu diesem Ansatz. Programmatisch definierte Agenten haben Vorrang vor dateisystem-basierten Agenten mit demselben Namen.215Sie können Subagenten auch als Markdown-Dateien in `.claude/agents/`-Verzeichnissen definieren. Siehe die [Claude Code Subagenten-Dokumentation](/docs/de/sub-agents) für Details zu diesem Ansatz. Programmatisch definierte Agenten haben Vorrang vor dateisystem-basierten Agenten mit demselben Namen.

216 216

217<Note>217<Note>

218 Auch ohne benutzerdefinierte Subagenten zu definieren, kann Claude den integrierten `general-purpose`-Subagenten spawnen. Dies ist nützlich, um Recherche- oder Explorationsaufgaben zu delegieren, ohne spezialisierte Agenten zu erstellen. Fügen Sie `Agent` in `allowedTools` ein, damit diese Aufrufe automatisch genehmigt werden, ohne eine Berechtigungsaufforderung anzuzeigen.218 Auch ohne benutzerdefinierte Subagenten zu definieren, kann Claude den integrierten `general-purpose`-Subagenten spawnen. Dies ist nützlich, um Recherche- oder Explorationsaufgaben zu delegieren, ohne spezialisierte Agenten zu erstellen. Fügen Sie `Agent` in `allowedTools` ein, damit diese Aufrufe automatisch genehmigt werden, ohne eine Berechtigungsaufforderung anzuzeigen.

224 224

225Das Kontextfenster eines Subagenten startet frisch, ohne übergeordnete Konversation, ist aber nicht leer. Der einzige Inhalt, den Sie vom übergeordneten Agent zum Subagenten übergeben, ist der Prompt-String des Agent-Tools, daher fügen Sie alle Dateipfade, Fehlermeldungen oder Entscheidungen, die der Subagent benötigt, direkt in diesen Prompt ein.225Das Kontextfenster eines Subagenten startet frisch, ohne übergeordnete Konversation, ist aber nicht leer. Der einzige Inhalt, den Sie vom übergeordneten Agent zum Subagenten übergeben, ist der Prompt-String des Agent-Tools, daher fügen Sie alle Dateipfade, Fehlermeldungen oder Entscheidungen, die der Subagent benötigt, direkt in diesen Prompt ein.

226 226

227{/* min-version: 2.1.206 */}Ein Subagent, der das [`SendMessage`](/de/tools-reference)-Tool hat, startet mit einer Liste der anderen benannten Agenten, die in der Sitzung ausgeführt werden, sodass er weiß, welche Namen er anschreiben kann. Claude Code fügt die Liste automatisch beim ersten Durchgang des Subagenten hinzu. Ein [Fork](/de/sub-agents#fork-the-current-conversation) erhält die Liste nicht, da er stattdessen die übergeordnete Konversation erbt. Die Liste erfordert Claude Code v2.1.206 oder später.227Ein Subagent, der das [`SendMessage`](/docs/de/tools-reference)-Tool hat, startet mit einer Liste der anderen benannten Agenten, die in der Sitzung ausgeführt werden, sodass er weiß, welche Namen er anschreiben kann. Claude Code fügt die Liste automatisch beim ersten Durchgang des Subagenten hinzu. Ein [Fork](/docs/de/sub-agents#fork-the-current-conversation) erhält die Liste nicht, da er stattdessen die übergeordnete Konversation erbt. Die Liste erfordert Claude Code v2.1.206 oder später.

228 228

229| Der Subagent erhält | Der Subagent erhält nicht |229| Der Subagent erhält | Der Subagent erhält nicht |

230| :-------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------- |230| :-------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------- |

231| Seinen eigenen System-Prompt (`AgentDefinition.prompt`) und den Prompt des Agent-Tools | Die Konversationshistorie oder Tool-Ergebnisse des übergeordneten Agenten |231| Seinen eigenen System-Prompt (`AgentDefinition.prompt`) und den Prompt des Agent-Tools | Die Konversationshistorie oder Tool-Ergebnisse des übergeordneten Agenten |

232| Projekt CLAUDE.md (geladen über [`settingSources`](/de/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources)) | Vorgeladener Skill-Inhalt, es sei denn, er ist in `AgentDefinition.skills` aufgelistet |232| Projekt CLAUDE.md (geladen über [`settingSources`](/docs/de/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources)) | Vorgeladener Skill-Inhalt, es sei denn, er ist in `AgentDefinition.skills` aufgelistet |

233| Tool-Definitionen (geerbt vom übergeordneten Agent oder die Teilmenge in `tools`) | Der System-Prompt des übergeordneten Agenten |233| Tool-Definitionen (geerbt vom übergeordneten Agent oder die Teilmenge in `tools`) | Der System-Prompt des übergeordneten Agenten |

234 234

235<Note>235<Note>

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

237</Note>237</Note>

238 238

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

240 240

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

242 242

441 441

442Sie können einen Subagenten fortsetzen, um dort fortzufahren, wo er aufgehört hat, anstatt von vorne zu beginnen. Ein fortgesetzter Subagent behält seine vollständige Konversationshistorie, einschließlich aller vorherigen Tool-Aufrufe, Ergebnisse und Reasoning.442Sie können einen Subagenten fortsetzen, um dort fortzufahren, wo er aufgehört hat, anstatt von vorne zu beginnen. Ein fortgesetzter Subagent behält seine vollständige Konversationshistorie, einschließlich aller vorherigen Tool-Aufrufe, Ergebnisse und Reasoning.

443 443

444Wenn ein Subagent abgeschlossen ist, enthält das Agent-Tool-Ergebnis einen Textblock mit `agentId: <id>`. Die integrierten [`Explore`- und `Plan`-Agenten](/de/sub-agents#built-in-subagents) sind einmalig und geben keine `agentId` zurück, daher verwenden Sie einen benutzerdefinierten Agent oder `general-purpose`, wenn Sie fortsetzen müssen. Um einen Subagenten programmatisch fortzusetzen:444Wenn ein Subagent abgeschlossen ist, enthält das Agent-Tool-Ergebnis einen Textblock mit `agentId: <id>`. Die integrierten [`Explore`- und `Plan`-Agenten](/docs/de/sub-agents#built-in-subagents) sind einmalig und geben keine `agentId` zurück, daher verwenden Sie einen benutzerdefinierten Agent oder `general-purpose`, wenn Sie fortsetzen müssen. Um einen Subagenten programmatisch fortzusetzen:

445 445

4461. **Erfassen Sie die Session-ID**: Extrahieren Sie `session_id` aus Nachrichten während der ersten Abfrage4461. **Erfassen Sie die Session-ID**: Extrahieren Sie `session_id` aus Nachrichten während der ersten Abfrage

4472. **Extrahieren Sie die Agent-ID**: Analysieren Sie `agentId` aus dem Agent-Tool-Ergebnis-Text4472. **Extrahieren Sie die Agent-ID**: Analysieren Sie `agentId` aus dem Agent-Tool-Ergebnis-Text

661 Skalierung mit dynamischen Workflows661 Skalierung mit dynamischen Workflows

662</h2>662</h2>

663 663

664Subagenten funktionieren gut für einige delegierte Aufgaben pro Turn. Für Läufe, die Dutzende bis Hunderte von Agenten koordinieren, verwenden Sie das `Workflow`-Tool, das die Orchestrierung in ein Skript verlagert, das die Laufzeit außerhalb des Konversationskontexts ausführt. Siehe [dynamische Workflows](/de/workflows) für die Unterschiede zwischen Workflows und Turn-für-Turn-Subagenten-Delegation.664Subagenten funktionieren gut für einige delegierte Aufgaben pro Turn. Für Läufe, die Dutzende bis Hunderte von Agenten koordinieren, verwenden Sie das `Workflow`-Tool, das die Orchestrierung in ein Skript verlagert, das die Laufzeit außerhalb des Konversationskontexts ausführt. Siehe [dynamische Workflows](/docs/de/workflows) für die Unterschiede zwischen Workflows und Turn-für-Turn-Subagenten-Delegation.

665 665

666Das `Workflow`-Tool ist im TypeScript Agent SDK v0.3.149 und später verfügbar. Fügen Sie `Workflow` in `allowedTools` ein, um Workflow-Läufe automatisch zu genehmigen. Die Tool-Input- und Output-Schemas sind in der [TypeScript-Referenz](/de/agent-sdk/typescript#workflow) aufgelistet.666Das `Workflow`-Tool ist im TypeScript Agent SDK v0.3.149 und später verfügbar. Fügen Sie `Workflow` in `allowedTools` ein, um Workflow-Läufe automatisch zu genehmigen. Die Tool-Input- und Output-Schemas sind in der [TypeScript-Referenz](/docs/de/agent-sdk/typescript#workflow) aufgelistet.

667 667

668<h2 id="troubleshooting">668<h2 id="troubleshooting">

669 Fehlerbehebung669 Fehlerbehebung

690* **`--disable-slash-commands`**: Sessions, die mit diesem Flag gestartet wurden, überwachen diese Verzeichnisse nicht und benötigen immer einen Neustart, um neue Dateien zu laden.690* **`--disable-slash-commands`**: Sessions, die mit diesem Flag gestartet wurden, überwachen diese Verzeichnisse nicht und benötigen immer einen Neustart, um neue Dateien zu laden.

691* **Ein programmatischer Agent mit demselben Namen**: `agents`, die an `query()` übergeben werden, überschreiben einen Dateisystem-Agent mit demselben Namen.691* **Ein programmatischer Agent mit demselben Namen**: `agents`, die an `query()` übergeben werden, überschreiben einen Dateisystem-Agent mit demselben Namen.

692 692

693Für das Dateiformat siehe [wie man Subagenten-Dateien schreibt](/de/sub-agents#write-subagent-files).693Für das Dateiformat siehe [wie man Subagenten-Dateien schreibt](/docs/de/sub-agents#write-subagent-files).

694 694

695<h3 id="long-prompt-failures-on-windows">695<h3 id="long-prompt-failures-on-windows">

696 Fehler bei langen Prompts unter Windows696 Fehler bei langen Prompts unter Windows

702 Verwandte Dokumentation702 Verwandte Dokumentation

703</h2>703</h2>

704 704

705* [Claude Code Subagenten](/de/sub-agents): umfassende Subagenten-Dokumentation einschließlich dateisystem-basierter Definitionen705* [Claude Code Subagenten](/docs/de/sub-agents): umfassende Subagenten-Dokumentation einschließlich dateisystem-basierter Definitionen

706* [Dynamische Workflows](/de/workflows): Orchestrieren Sie viele Subagenten aus einem Skript für Jobs, die zu groß für eine Konversation sind706* [Dynamische Workflows](/docs/de/workflows): Orchestrieren Sie viele Subagenten aus einem Skript für Jobs, die zu groß für eine Konversation sind

707* [SDK-Übersicht](/de/agent-sdk/overview): Erste Schritte mit dem Claude Agent SDK707* [SDK-Übersicht](/docs/de/agent-sdk/overview): Erste Schritte mit dem Claude Agent SDK

agent-sdk/todo-tracking.md +7 −7

Details

40 Beispiele40 Beispiele

41</h2>41</h2>

42 42

~~43Bevor Sie diese Beispiele ausführen, installieren Sie das Claude Agent SDK, indem Sie dem [Schnellstart](/de/agent-sdk/quickstart) folgen.~~43Bevor Sie diese Beispiele ausführen, installieren Sie das Claude Agent SDK, indem Sie dem [Schnellstart](/docs/de/agent-sdk/quickstart) folgen.

44 44

45Jedes Beispiel wird ausgeführt, bis der Agent fertig ist und seine endgültige Ergebnismeldung liefert. Wenn eine Sitzung zuerst ihr Turnus-Limit erreicht, hat diese Ergebnismeldung den Subtyp `error_max_turns`. Überprüfen Sie `subtype`, um dieses Ende zu erkennen.45Jedes Beispiel wird ausgeführt, bis der Agent fertig ist und seine endgültige Ergebnismeldung liefert. Wenn eine Sitzung zuerst ihr Turnus-Limit erreicht, hat diese Ergebnismeldung den Subtyp `error_max_turns`. Überprüfen Sie `subtype`, um dieses Ende zu erkennen.

46 46

47Diese Beispiele verwenden Single-Shot-`query()`-Aufrufe. Nach dem Liefern eines `error_max_turns`-Ergebnisses wirft `query()` einen Fehler aus, der `Reached maximum number of turns` enthält. Jedes Beispiel umhüllt seine Schleife in einem Try-Block, um sauber zu beenden, wenn dies geschieht.47Diese Beispiele verwenden Single-Shot-`query()`-Aufrufe. Nach dem Liefern eines `error_max_turns`-Ergebnisses wirft `query()` einen Fehler aus, der `Reached maximum number of turns` enthält. Jedes Beispiel umhüllt seine Schleife in einem Try-Block, um sauber zu beenden, wenn dies geschieht.

48 48

~~49Siehe [Handle the result](/de/agent-sdk/agent-loop#handle-the-result) für die Ergebnis-Subtypen.~~49Siehe [Handle the result](/docs/de/agent-sdk/agent-loop#handle-the-result) für die Ergebnis-Subtypen.

50 50

51<h3 id="monitoring-todo-changes">51<h3 id="monitoring-todo-changes">

52 Überwachung von Todo-Änderungen52 Überwachung von Todo-Änderungen

253 Zu Task-Tools migrieren253 Zu Task-Tools migrieren

254</h2>254</h2>

255 255

256Die Task-Tools teilen den einzelnen `TodoWrite`-Aufruf in `TaskCreate` für jedes neue Element und `TaskUpdate` für jede Statusänderung auf, wobei `TaskList` und `TaskGet` für das Modell verfügbar sind, um die aktuelle Liste zu lesen. Ihr Überwachungscode inspiziert weiterhin `tool_use`-Blöcke im Assistent-Stream, verwaltet aber eine Zuordnung mit Task-ID als Schlüssel, anstatt die gesamte Liste bei jedem Aufruf zu ersetzen. {/* min-version: 2.1.142 */}Die Task-Tools sind ab TypeScript Agent SDK 0.3.142 und Claude Code v2.1.142 die Standardeinstellung, daher ist keine Änderung von `options.env` erforderlich.256Die Task-Tools teilen den einzelnen `TodoWrite`-Aufruf in `TaskCreate` für jedes neue Element und `TaskUpdate` für jede Statusänderung auf, wobei `TaskList` und `TaskGet` für das Modell verfügbar sind, um die aktuelle Liste zu lesen. Ihr Überwachungscode inspiziert weiterhin `tool_use`-Blöcke im Assistent-Stream, verwaltet aber eine Zuordnung mit Task-ID als Schlüssel, anstatt die gesamte Liste bei jedem Aufruf zu ersetzen. Die Task-Tools sind ab TypeScript Agent SDK 0.3.142 und Claude Code v2.1.142 die Standardeinstellung, daher ist keine Änderung von `options.env` erforderlich.

257 257

259| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |259| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

338 Zugehörige Dokumentation338 Zugehörige Dokumentation

339</h2>339</h2>

340 340

341* [TypeScript SDK-Referenz](/de/agent-sdk/typescript)341* [TypeScript SDK-Referenz](/docs/de/agent-sdk/typescript)

342* [Python SDK-Referenz](/de/agent-sdk/python)342* [Python SDK-Referenz](/docs/de/agent-sdk/python)

343* [Streaming vs. Single Mode](/de/agent-sdk/streaming-vs-single-mode)343* [Streaming vs. Single Mode](/docs/de/agent-sdk/streaming-vs-single-mode)

344* [Benutzerdefinierte Tools](/de/agent-sdk/custom-tools)344* [Benutzerdefinierte Tools](/docs/de/agent-sdk/custom-tools)

agent-sdk/typescript.md +69 −71

Details

6 6

7> Vollständige API-Referenz für das TypeScript Agent SDK, einschließlich aller Funktionen, Typen und Schnittstellen.7> Vollständige API-Referenz für das TypeScript Agent SDK, einschließlich aller Funktionen, Typen und Schnittstellen.

8 8

~~9<script src="/components/typescript-sdk-type-links.js" defer />~~9<script src="/docs/components/typescript-sdk-type-links.js" defer />

10 10

11<h2 id="installation">11<h2 id="installation">

12 Installation12 Installation

296</h4>296</h4>

297 297

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

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

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

306 306

307<h4 id="example-3">307<h4 id="example-3">

308 Beispiel308 Beispiel

423| :------------------------------ | :------------------------------------ | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |423| :------------------------------ | :------------------------------------ | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

425| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Alle Quellen | Welche Dateisystemquellen geladen werden sollen. Übergeben Sie `[]`, um Benutzer-, Projekt- und lokale Einstellungen zu überspringen. Verwaltete Richtlinieneinstellungen werden in allen Fällen geladen. Server-verwaltete Einstellungen werden von `serverManagedSettings` übernommen, wenn der Host diese übergibt, oder aus dem On-Disk-Cache der CLI gelesen; der Snapshot ruft sie nicht aus dem Netzwerk ab |425| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Alle Quellen | Welche Dateisystemquellen geladen werden sollen. Übergeben Sie `[]`, um Benutzer-, Projekt- und lokale Einstellungen zu überspringen. Verwaltete Richtlinieneinstellungen werden in allen Fällen geladen. Server-verwaltete Einstellungen werden von `serverManagedSettings` übernommen, wenn der Host diese übergibt, oder aus dem On-Disk-Cache der CLI gelesen; der Snapshot ruft sie nicht aus dem Netzwerk ab |

426| `options.managedSettings` | `Settings` | `undefined` | Restriktive Richtlinien-Tier-Einstellungen, die vom Embedding-Host bereitgestellt werden. Gelöscht standardmäßig, wenn eine vom Administrator bereitgestellte verwaltete Tier vorhanden ist; zusammengeführt unter dieser Tier, wenn [`parentSettingsBehavior`](/de/settings#available-settings) `"merge"` ist. Nicht-restriktive Schlüssel wie `model` werden stillschweigend gelöscht, sodass diese Option verwaltete Richtlinien verschärfen, aber nicht lockern kann |426| `options.managedSettings` | `Settings` | `undefined` | Restriktive Richtlinien-Tier-Einstellungen, die vom Embedding-Host bereitgestellt werden. Gelöscht standardmäßig, wenn eine vom Administrator bereitgestellte verwaltete Tier vorhanden ist; zusammengeführt unter dieser Tier, wenn [`parentSettingsBehavior`](/docs/de/settings#available-settings) `"merge"` ist. Nicht-restriktive Schlüssel wie `model` werden stillschweigend gelöscht, sodass diese Option verwaltete Richtlinien verschärfen, aber nicht lockern kann |

428 428

429<h4 id="return-type-resolvedsettings">429<h4 id="return-type-resolvedsettings">

475| `agentProgressSummaries` | `boolean` | `false` | Wenn `true`, generieren Sie einzeilige Fortschrittsübersichten für Subagenten und leiten Sie diese auf [`task_progress`](#sdktaskprogressmessage)-Ereignissen über das `summary`-Feld weiter. Gilt für Vordergrund- und Hintergrund-Subagenten |475| `agentProgressSummaries` | `boolean` | `false` | Wenn `true`, generieren Sie einzeilige Fortschrittsübersichten für Subagenten und leiten Sie diese auf [`task_progress`](#sdktaskprogressmessage)-Ereignissen über das `summary`-Feld weiter. Gilt für Vordergrund- und Hintergrund-Subagenten |

477| `allowedTools` | `string[]` | `[]` | Tools, die automatisch genehmigt werden, ohne zu fragen. Dies beschränkt Claude nicht nur auf diese Tools; nicht aufgelistete Tools fallen durch `permissionMode` und `canUseTool`. Verwenden Sie `disallowedTools`, um Tools zu blockieren. Siehe [Berechtigungen](/de/agent-sdk/permissions#allow-and-deny-rules) |477| `allowedTools` | `string[]` | `[]` | Tools, die automatisch genehmigt werden, ohne zu fragen. Dies beschränkt Claude nicht nur auf diese Tools; nicht aufgelistete Tools fallen durch `permissionMode` und `canUseTool`. Verwenden Sie `disallowedTools`, um Tools zu blockieren. Siehe [Berechtigungen](/docs/de/agent-sdk/permissions#allow-and-deny-rules) |

479| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Benutzerdefinierte Berechtigungsfunktion, die nur aufgerufen wird, wenn der [Berechtigungsfluss](/de/agent-sdk/permissions#how-permissions-are-evaluated) zu einer Eingabeaufforderung führt. Nicht aufgerufen für Aufrufe, die von `allowedTools`, Allow-Regeln oder `permissionMode` automatisch genehmigt werden. `AskUserQuestion`, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und MCP-Tools, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, erreichen es auch, wenn Sie diese zugelassen haben; im `dontAsk`-Modus werden diese stattdessen verweigert. Siehe [`CanUseTool`](#canusetool) für Details |479| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Benutzerdefinierte Berechtigungsfunktion, die nur aufgerufen wird, wenn der [Berechtigungsfluss](/docs/de/agent-sdk/permissions#how-permissions-are-evaluated) zu einer Eingabeaufforderung führt. Nicht aufgerufen für Aufrufe, die von `allowedTools`, Allow-Regeln oder `permissionMode` automatisch genehmigt werden. `AskUserQuestion`, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, erreichen es auch, wenn Sie diese zugelassen haben; im `dontAsk`-Modus werden diese stattdessen verweigert. Siehe [`CanUseTool`](#canusetool) für Details |

484| `disallowedTools` | `string[]` | `[]` | 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`. Siehe [Berechtigungen](/de/agent-sdk/permissions#allow-and-deny-rules) |484| `disallowedTools` | `string[]` | `[]` | 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`. Siehe [Berechtigungen](/docs/de/agent-sdk/permissions#allow-and-deny-rules) |

487| `env` | `Record<string, string \| undefined>` | `process.env` | Umgebungsvariablen. Wenn gesetzt, ersetzt dies die Subprocess-Umgebung, anstatt sie mit `process.env` zusammenzuführen. Übergeben Sie daher `{ ...process.env, YOUR_VAR: 'value' }`, um geerbte Variablen wie `PATH` beizubehalten. Siehe [Langsame oder steckengebliebene API-Antworten verarbeiten](#handle-slow-or-stalled-api-responses) für ein Beispiel dieses Musters und [Umgebungsvariablen](/de/env-vars) für Variablen, die die zugrunde liegende CLI liest. Setzen Sie `CLAUDE_AGENT_SDK_CLIENT_APP`, um Ihre App im User-Agent-Header zu identifizieren |487| `env` | `Record<string, string \| undefined>` | `process.env` | Umgebungsvariablen. Wenn gesetzt, ersetzt dies die Subprocess-Umgebung, anstatt sie mit `process.env` zusammenzuführen. Übergeben Sie daher `{ ...process.env, YOUR_VAR: 'value' }`, um geerbte Variablen wie `PATH` beizubehalten. Siehe [Langsame oder steckengebliebene API-Antworten verarbeiten](#handle-slow-or-stalled-api-responses) für ein Beispiel dieses Musters und [Umgebungsvariablen](/docs/de/env-vars) für Variablen, die die zugrunde liegende CLI liest. Setzen Sie `CLAUDE_AGENT_SDK_CLIENT_APP`, um Ihre App im User-Agent-Header zu identifizieren |

490| `extraArgs` | `Record<string, string \| null>` | `{}` | Zusätzliche Argumente |490| `extraArgs` | `Record<string, string \| null>` | `{}` | Zusätzliche Argumente |

497| `loadTimeoutMs` | `number` | `60000` | *Alpha.* Timeout in Millisekunden für jeden `sessionStore.load()`- und `sessionStore.listSubkeys()`-Aufruf während der Resume-Materialisierung. Wenn sich der Adapter nicht innerhalb dieses Fensters einigt, schlägt die Abfrage fehl, anstatt zu hängen. Wird ignoriert, wenn `sessionStore` nicht gesetzt ist |497| `loadTimeoutMs` | `number` | `60000` | *Alpha.* Timeout in Millisekunden für jeden `sessionStore.load()`- und `sessionStore.listSubkeys()`-Aufruf während der Resume-Materialisierung. Wenn sich der Adapter nicht innerhalb dieses Fensters einigt, schlägt die Abfrage fehl, anstatt zu hängen. Wird ignoriert, wenn `sessionStore` nicht gesetzt ist |

498| `managedSettings` | `Settings` | `undefined` | Richtlinien-Tier-Einstellungen, die vom spawning Parent-Prozess bereitgestellt werden. Werden gelöscht, wenn bereits ein IT-kontrollierter verwalteter Einstellungs-Tier auf der Maschine vorhanden ist, es sei denn, dieser Administrator entscheidet sich mit `parentSettingsBehavior: 'merge'` dafür. Gefiltert auf restriktive-only-Schlüssel unabhängig |498| `managedSettings` | `Settings` | `undefined` | Richtlinien-Tier-Einstellungen, die vom spawning Parent-Prozess bereitgestellt werden. Werden gelöscht, wenn bereits ein IT-kontrollierter verwalteter Einstellungs-Tier auf der Maschine vorhanden ist, es sei denn, dieser Administrator entscheidet sich mit `parentSettingsBehavior: 'merge'` dafür. Gefiltert auf restriktive-only-Schlüssel unabhängig |

499| `maxBudgetUsd` | `number` | `undefined` | Beenden Sie die Abfrage, wenn die clientseitige Kostenschätzung diesen USD-Wert erreicht. Verglichen mit derselben Schätzung wie `total_cost_usd`; siehe [Kosten und Nutzung verfolgen](/de/agent-sdk/cost-tracking) für Genauigkeitsvorbehalt |499| `maxBudgetUsd` | `number` | `undefined` | Beenden Sie die Abfrage, wenn die clientseitige Kostenschätzung diesen USD-Wert erreicht. Verglichen mit derselben Schätzung wie `total_cost_usd`; siehe [Kosten und Nutzung verfolgen](/docs/de/agent-sdk/cost-tracking) für Genauigkeitsvorbehalt |

502| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | MCP-Server-Konfigurationen |502| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | MCP-Server-Konfigurationen |

504| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | Callback für die Verarbeitung von MCP-Elicitierungsanfragen. Wird aufgerufen, wenn ein MCP-Server Benutzereingaben anfordert und kein Hook dies zuerst verarbeitet. Wenn nicht bereitgestellt, werden unbehandelte Elicitierungsanfragen automatisch abgelehnt |504| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | Callback für die Verarbeitung von MCP-Elicitierungsanfragen. Wird aufgerufen, wenn ein MCP-Server Benutzereingaben anfordert und kein Hook dies zuerst verarbeitet. Wenn nicht bereitgestellt, werden unbehandelte Elicitierungsanfragen automatisch abgelehnt |

505| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Definieren Sie das Ausgabeformat für Agent-Ergebnisse. Siehe [Strukturierte Ausgaben](/de/agent-sdk/structured-outputs) für Details |505| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Definieren Sie das Ausgabeformat für Agent-Ergebnisse. Siehe [Strukturierte Ausgaben](/docs/de/agent-sdk/structured-outputs) für Details |

506| `outputStyle` | `string` | `undefined` | Nicht ein `Options`-Feld. Setzen Sie `outputStyle` im Inline-[`settings`](/de/settings)-Objekt oder einer Einstellungsdatei. Siehe [Aktivieren Sie einen Ausgabestil](/de/agent-sdk/modifying-system-prompts#activate-an-output-style) |506| `outputStyle` | `string` | `undefined` | Nicht ein `Options`-Feld. Setzen Sie `outputStyle` im Inline-[`settings`](/docs/de/settings)-Objekt oder einer Einstellungsdatei. Siehe [Aktivieren Sie einen Ausgabestil](/docs/de/agent-sdk/modifying-system-prompts#activate-an-output-style) |

507| `pathToClaudeCodeExecutable` | `string` | Automatisch aufgelöst aus gebündelter nativer Binärdatei | Pfad zur Claude Code-Ausführungsdatei. Nur erforderlich, wenn optionale Abhängigkeiten während der Installation übersprungen wurden oder Ihre Plattform nicht in der unterstützten Menge enthalten ist |507| `pathToClaudeCodeExecutable` | `string` | Automatisch aufgelöst aus gebündelter nativer Binärdatei | Pfad zur Claude Code-Ausführungsdatei. Nur erforderlich, wenn optionale Abhängigkeiten während der Installation übersprungen wurden oder Ihre Plattform nicht in der unterstützten Menge enthalten ist |

511| `planModeInstructions` | `string` | `undefined` | Benutzerdefinierte Workflow-Anweisungen für den Plan-Modus. Wenn `permissionMode` `'plan'` ist, ersetzt diese Zeichenkette den Standard-Plan-Modus-Workflow-Body. Die CLI umhüllt ihn immer noch mit der schreibgeschützten Durchsetzungspräambel und dem ExitPlanMode-Protokoll-Footer |511| `planModeInstructions` | `string` | `undefined` | Benutzerdefinierte Workflow-Anweisungen für den Plan-Modus. Wenn `permissionMode` `'plan'` ist, ersetzt diese Zeichenkette den Standard-Plan-Modus-Workflow-Body. Die CLI umhüllt ihn immer noch mit der schreibgeschützten Durchsetzungspräambel und dem ExitPlanMode-Protokoll-Footer |

513| `promptSuggestions` | `boolean` | `false` | Aktivieren Sie Eingabeaufforderungsvorschläge. Gibt nach jedem Turn eine `prompt_suggestion`-Nachricht mit einer vorhergesagten nächsten Benutzer-Eingabeaufforderung aus |513| `promptSuggestions` | `boolean` | `false` | Aktivieren Sie Eingabeaufforderungsvorschläge. Gibt nach jedem Turn eine `prompt_suggestion`-Nachricht mit einer vorhergesagten nächsten Benutzer-Eingabeaufforderung aus |

518| `sessionStore` | [`SessionStore`](/de/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Spiegeln Sie Sitzungstranskripte auf einem externen Backend, damit jeder Host sie fortsetzen kann. Siehe [Sitzungen im externen Speicher persistieren](/de/agent-sdk/session-storage) |518| `sessionStore` | [`SessionStore`](/docs/de/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Spiegeln Sie Sitzungstranskripte auf einem externen Backend, damit jeder Host sie fortsetzen kann. Siehe [Sitzungen im externen Speicher persistieren](/docs/de/agent-sdk/session-storage) |

520| `settings` | `string \| Settings` | `undefined` | Inline-[Einstellungen](/de/settings)-Objekt oder Pfad zu einer Einstellungsdatei. Füllt die Flag-Einstellungsebene in der [Prioritätsreihenfolge](/de/settings#settings-precedence) auf. Ändern Sie zur Laufzeit mit [`applyFlagSettings()`](#applyflagsettings) |520| `settings` | `string \| Settings` | `undefined` | Inline-[Einstellungen](/docs/de/settings)-Objekt oder Pfad zu einer Einstellungsdatei. Füllt die Flag-Einstellungsebene in der [Prioritätsreihenfolge](/docs/de/settings#settings-precedence) auf. Ändern Sie zur Laufzeit mit [`applyFlagSettings()`](#applyflagsettings) |

521| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI-Standards (alle Quellen) | Steuern Sie, welche Dateisystem-Einstellungen geladen werden. Übergeben Sie `[]`, um Benutzer-, Projekt- und lokale Einstellungen zu deaktivieren. Verwaltete Richtlinieneinstellungen werden unabhängig davon geladen; Server-verwaltete Einstellungen werden abgerufen, wenn sich die Sitzung mit einer Organisationsanmeldedaten auf einer [berechtigten Konfiguration](/de/server-managed-settings#platform-availability) authentifiziert. Siehe [Claude Code-Funktionen verwenden](/de/agent-sdk/claude-code-features#what-settingsources-does-not-control) |521| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI-Standards (alle Quellen) | Steuern Sie, welche Dateisystem-Einstellungen geladen werden. Übergeben Sie `[]`, um Benutzer-, Projekt- und lokale Einstellungen zu deaktivieren. Verwaltete Richtlinieneinstellungen werden 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. Siehe [Claude Code-Funktionen verwenden](/docs/de/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

522| `skills` | `string[] \| 'all'` | `undefined` | Skills, die der Sitzung zur Verfügung stehen. Übergeben Sie `'all'`, um jeden entdeckten Skill zu aktivieren, oder eine Liste von Skill-Namen. Wenn gesetzt, aktiviert das SDK das Skill-Tool automatisch in `allowedTools`. Wenn Sie auch `tools` übergeben, beziehen Sie `'Skill'` in diese Liste ein. Siehe [Skills](/de/agent-sdk/skills) |522| `skills` | `string[] \| 'all'` | `undefined` | Skills, die der Sitzung zur Verfügung stehen. Übergeben Sie `'all'`, um jeden entdeckten Skill zu aktivieren, oder eine Liste von Skill-Namen. Wenn gesetzt, aktiviert das SDK das Skill-Tool automatisch in `allowedTools`. Wenn Sie auch `tools` übergeben, beziehen Sie `'Skill'` in diese Liste ein. Siehe [Skills](/docs/de/agent-sdk/skills) |

523| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Benutzerdefinierte Funktion zum Spawnen des Claude Code-Prozesses. Verwenden Sie, um Claude Code in VMs, Containern oder Remote-Umgebungen auszuführen |523| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Benutzerdefinierte Funktion zum Spawnen des Claude Code-Prozesses. Verwenden Sie, um Claude Code in VMs, Containern oder Remote-Umgebungen auszuführen |

525| `strictMcpConfig` | `boolean` | `false` | Verwenden Sie nur die Server, die in `mcpServers` übergeben werden, und ignorieren Sie das Projekt `.mcp.json`, Benutzereinstellungen, von Plugins bereitgestellte MCP-Server und [claude.ai-Konnektoren](/de/mcp#use-mcp-servers-from-claude-ai) |525| `strictMcpConfig` | `boolean` | `false` | Verwenden Sie nur die Server, die in `mcpServers` ü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) |

526| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (minimale Eingabeaufforderung) | Konfiguration der Systemeingabeaufforderung. Übergeben Sie eine Zeichenkette für eine benutzerdefinierte Eingabeaufforderung oder `{ type: 'preset', preset: 'claude_code' }`, um die Systemeingabeaufforderung von Claude Code zu verwenden. Bei Verwendung der Preset-Objektform fügen Sie `append` hinzu, um sie mit zusätzlichen Anweisungen zu erweitern, und setzen Sie `excludeDynamicSections: true`, um sitzungsspezifischen Kontext in die erste Benutzer-Nachricht zu verschieben, um [bessere Prompt-Cache-Wiederverwendung über Maschinen hinweg](/de/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |526| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (minimale Eingabeaufforderung) | Konfiguration der Systemeingabeaufforderung. Übergeben Sie eine Zeichenkette für eine benutzerdefinierte Eingabeaufforderung oder `{ type: 'preset', preset: 'claude_code' }`, um die Systemeingabeaufforderung von Claude Code zu verwenden. Bei Verwendung der Preset-Objektform fügen Sie `append` hinzu, um sie mit zusätzlichen Anweisungen zu erweitern, und setzen Sie `excludeDynamicSections: true`, um sitzungsspezifischen Kontext in die erste Benutzer-Nachricht zu verschieben, um [bessere Prompt-Cache-Wiederverwendung über Maschinen hinweg](/docs/de/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

527| `taskBudget` | `{ total: number }` | `undefined` | *Alpha.* API-seitiges Task-Budget in Token. Wenn gesetzt, wird dem Modell sein verbleibendes Token-Budget mitgeteilt, damit es die Tool-Nutzung pacing kann und vor dem Limit abwickelt |527| `taskBudget` | `{ total: number }` | `undefined` | *Alpha.* API-seitiges Task-Budget in Token. Wenn gesetzt, wird dem Modell sein verbleibendes Token-Budget mitgeteilt, damit es die Tool-Nutzung pacing kann und vor dem Limit abwickelt |

528| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` für unterstützte Modelle | Steuert das Denk-/Reasoning-Verhalten von Claude. Siehe [`ThinkingConfig`](#thinkingconfig) für Optionen |528| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` für unterstützte Modelle | Steuert das Denk-/Reasoning-Verhalten von Claude. Siehe [`ThinkingConfig`](#thinkingconfig) für Optionen |

529| `title` | `string` | `undefined` | Anzeigetitel für die Sitzung. Beim Fortsetzen über `resume` oder `continue` hat der persistierte Titel der fortgesetzten Sitzung Vorrang; verwenden Sie [`renameSession()`](#renamesession), um eine vorhandene Sitzung umzubenennen |529| `title` | `string` | `undefined` | Anzeigetitel für die Sitzung. Beim Fortsetzen über `resume` oder `continue` hat der persistierte Titel der fortgesetzten Sitzung Vorrang; verwenden Sie [`renameSession()`](#renamesession), um eine vorhandene Sitzung umzubenennen |

552```552```

553 553

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

555* `CLAUDE_CODE_MAX_RETRIES`: Maximale API-Wiederholungen. Standard `10`, begrenzt auf `15`. Jede Wiederholung erhält sein eigenes `API_TIMEOUT_MS`-Fenster, sodass die schlimmste Wandzeit ungefähr `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` plus Backoff ist. Für unbeaufsichtigte Läufe, die längere Ausfallzeiten abwarten müssen, setzen Sie `CLAUDE_CODE_RETRY_WATCHDOG=1`: Es wiederholt Kapazitätsfehler unbegrenzt, und {/* min-version: 2.1.199 */}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.555* `CLAUDE_CODE_MAX_RETRIES`: Maximale API-Wiederholungen. Standard `10`, begrenzt auf `15`. Jede Wiederholung erhält sein eigenes `API_TIMEOUT_MS`-Fenster, sodass die schlimmste Wandzeit ungefähr `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` plus Backoff ist. Für unbeaufsichtigte Läufe, die längere Ausfallzeiten abwarten müssen, setzen Sie `CLAUDE_CODE_RETRY_WATCHDOG=1`: 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.

556* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: Stall-Watchdog für Subagenten, die mit `run_in_background` gestartet werden. Standard `600000`. Setzt sich bei jedem Stream-Ereignis zurück; bei Stall bricht es den Subagenten ab, markiert die Aufgabe als fehlgeschlagen und zeigt den Fehler dem übergeordneten Element mit jedem Teilergebnis. Gilt nicht für synchrone Subagenten.556* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: Stall-Watchdog für Subagenten, die mit `run_in_background` gestartet werden. Standard `600000`. Setzt sich bei jedem Stream-Ereignis zurück; bei Stall bricht es den Subagenten ab, markiert die Aufgabe als fehlgeschlagen und zeigt den Fehler dem übergeordneten Element mit jedem Teilergebnis. Gilt nicht für synchrone Subagenten.

557* `CLAUDE_ENABLE_STREAM_WATCHDOG` mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: Bricht die Anfrage ab, wenn Header angekommen sind, aber der Antwortkörper nicht mehr streamt. Der Watchdog ist standardmäßig für alle Provider 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. Die abgebrochene Anfrage durchläuft den normalen Wiederholungspfad.557* `CLAUDE_ENABLE_STREAM_WATCHDOG` mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: Bricht die Anfrage ab, wenn Header angekommen sind, aber der Antwortkörper nicht mehr streamt. Der Watchdog ist standardmäßig für alle Provider 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. Die abgebrochene Anfrage durchläuft den normalen Wiederholungspfad.

558 558

594</h4>594</h4>

595 595

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

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

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

602| `setMaxThinkingTokens()` | *Veraltet:* Verwenden Sie stattdessen die `thinking`-Option. Ändert die maximalen Denk-Token |602| `setMaxThinkingTokens()` | *Veraltet:* Verwenden Sie stattdessen die `thinking`-Option. Ändert die maximalen Denk-Token |

603| `applyFlagSettings(settings)` | Führt Einstellungen zur Laufzeit in die Flag-Einstellungsebene der Sitzung zusammen (nur im Streaming-Eingabemodus verfügbar). Siehe [`applyFlagSettings()`](#applyflagsettings) |603| `applyFlagSettings(settings)` | Führt Einstellungen zur Laufzeit in die Flag-Einstellungsebene der Sitzung zusammen (nur im Streaming-Eingabemodus verfügbar). Siehe [`applyFlagSettings()`](#applyflagsettings) |

604| `initializationResult()` | Gibt das vollständige Initialisierungsergebnis zurück, einschließlich unterstützter Befehle, Modelle, Kontoinformationen und Ausgabestil-Konfiguration |604| `initializationResult()` | Gibt das vollständige Initialisierungsergebnis zurück, einschließlich unterstützter Befehle, Modelle, Kontoinformationen und Ausgabestil-Konfiguration |

605| `reinitialize()` | {/* min-version: 2.1.195 */}Sendet die `initialize`-Steueranfrage erneut an die laufende CLI und gibt ein frisches Ergebnis anstelle des zwischengespeicherten First-Connect-Ergebnisses zurück. Verwenden Sie es nach einer Transportlücke, z. B. nach dem Wiederherstellen einer Verbindung zu einer Sitzung nach einer Trennung, damit ausstehende Berechtigungsanfragen Ihren `canUseTool`-Callback erneut erreichen. Machen Sie den Callback idempotent pro Request-ID, da eine Anfrage, deren Antwort verloren ging, erneut versendet wird. Erfordert Claude Code v2.1.195 oder später |605| `reinitialize()` | Sendet die `initialize`-Steueranfrage erneut an die laufende CLI und gibt ein frisches Ergebnis anstelle des zwischengespeicherten First-Connect-Ergebnisses zurück. Verwenden Sie es nach einer Transportlücke, z. B. nach dem Wiederherstellen einer Verbindung zu einer Sitzung nach einer Trennung, damit ausstehende Berechtigungsanfragen Ihren `canUseTool`-Callback erneut erreichen. Machen Sie den Callback idempotent pro Request-ID, da eine Anfrage, deren Antwort verloren ging, erneut versendet wird. Erfordert Claude Code v2.1.195 oder später |

619 `applyFlagSettings()`619 `applyFlagSettings()`

620</h4>620</h4>

621 621

622Ändert [Einstellungen](/de/settings) auf einer laufenden Sitzung, ohne die Abfrage neu zu starten. Verwenden Sie es, wenn eine Einstellung, die keinen dedizierten Setter hat, sich mitten in der Sitzung ändern muss, z. B. um `permissions` zu verschärfen, nachdem der Agent nicht vertrauenswürdige Eingaben liest. `setModel()` und `setPermissionMode()` sind dedizierte Setter für diese beiden Schlüssel; `applyFlagSettings()` ist die allgemeine Form, die jede Teilmenge der Einstellungsschlüssel akzeptiert, und das Übergeben von `model` hier verhält sich genauso wie `setModel()`.622Ändert [Einstellungen](/docs/de/settings) auf einer laufenden Sitzung, ohne die Abfrage neu zu starten. Verwenden Sie es, wenn eine Einstellung, die keinen dedizierten Setter hat, sich mitten in der Sitzung ändern muss, z. B. um `permissions` zu verschärfen, nachdem der Agent nicht vertrauenswürdige Eingaben liest. `setModel()` und `setPermissionMode()` sind dedizierte Setter für diese beiden Schlüssel; `applyFlagSettings()` ist die allgemeine Form, die jede Teilmenge der Einstellungsschlüssel akzeptiert, und das Übergeben von `model` hier verhält sich genauso wie `setModel()`.

623 623

624Nur einige Schlüssel wirken sich mitten in der Sitzung aus:624Nur einige Schlüssel wirken sich mitten in der Sitzung aus:

625 625

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

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

628 628

629`effortLevel` akzeptiert einen [Aufwandsstufen](/de/model-config#adjust-effort-level)-Namen. Es akzeptiert auch `"ultracode"`, das die Sitzung mit `xhigh`-Aufwand ausführt und [ultracode](/de/workflows#let-claude-decide-with-ultracode) aktiviert. Der `Settings`-Typ deklariert `effortLevel` ohne diesen Wert, daher übergeben Sie das Äquivalent `{ ultracode: true }` in TypeScript. {/* min-version: 2.1.203 */}Der `ultracode`-Wert erfordert Claude Code v2.1.203 oder später und wird nur von `applyFlagSettings()` akzeptiert, nicht vom `effortLevel`-Schlüssel in einer Einstellungsdatei.629`effortLevel` akzeptiert einen [Aufwandsstufen](/docs/de/model-config#adjust-effort-level)-Namen. Es akzeptiert auch `"ultracode"`, das die Sitzung mit `xhigh`-Aufwand ausführt und [ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) aktiviert. Der `Settings`-Typ deklariert `effortLevel` ohne diesen Wert, daher übergeben Sie das Äquivalent `{ ultracode: true }` in TypeScript. Der `ultracode`-Wert erfordert Claude Code v2.1.203 oder später und wird nur von `applyFlagSettings()` akzeptiert, nicht vom `effortLevel`-Schlüssel in einer Einstellungsdatei.

630 630

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

632 632

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

634 634

714 714

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

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

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

718 718

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

720 720

792 Standardverhalten792 Standardverhalten

793</h4>793</h4>

794 794

795Wenn `settingSources` weggelassen oder `undefined` ist, lädt `query()` die gleichen Dateisystem-Einstellungen wie die Claude Code CLI: Benutzer, Projekt und lokal. Verwaltete Richtlinieneinstellungen werden in allen Fällen geladen; Server-verwaltete Einstellungen werden abgerufen, wenn sich die Sitzung mit einer Organisationsanmeldedaten auf einer [berechtigten Konfiguration](/de/server-managed-settings#platform-availability) authentifiziert. Siehe [Was settingSources nicht steuert](/de/agent-sdk/claude-code-features#what-settingsources-does-not-control) für Eingaben, die unabhängig von dieser Option gelesen werden, und wie man sie deaktiviert.795Wenn `settingSources` weggelassen oder `undefined` ist, lädt `query()` die gleichen Dateisystem-Einstellungen wie die Claude Code CLI: Benutzer, Projekt und lokal. Verwaltete Richtlinieneinstellungen werden 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. Siehe [Was settingSources nicht steuert](/docs/de/agent-sdk/claude-code-features#what-settingsources-does-not-control) für Eingaben, die unabhängig von dieser Option gelesen werden, und wie man sie deaktiviert.

796 796

797<h4 id="why-use-settingsources">797<h4 id="why-use-settingsources">

798 Warum settingSources verwenden798 Warum settingSources verwenden

913 913

914Benutzerdefinierte Berechtigungsfunktionstyp zur Steuerung der Tool-Nutzung.914Benutzerdefinierte Berechtigungsfunktionstyp zur Steuerung der Tool-Nutzung.

915 915

916Die Funktion ist der SDK-Ersatz für die interaktive Berechtigungsaufforderung: Sie wird nur aufgerufen, wenn der [Berechtigungsbewertungsfluss](/de/agent-sdk/permissions#how-permissions-are-evaluated) zu einer Eingabeaufforderung führt. Tool-Aufrufe, die bereits von einem `allowedTools`-Eintrag, einer Settings-Allow-Regel oder dem Berechtigungsmodus wie `acceptEdits` oder `bypassPermissions` genehmigt wurden, rufen ihn nie auf. `AskUserQuestion`, MCP-Tools, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) erreichen die Funktion auch, wenn eine Allow-Regel passt. Im `dontAsk`-Modus werden diese Aufrufe stattdessen verweigert, ohne sie aufzurufen. Um jeden Tool-Aufruf zu gaten, verwenden Sie stattdessen einen [`PreToolUse`-Hook](/de/agent-sdk/hooks).916Die Funktion ist der SDK-Ersatz für die interaktive Berechtigungsaufforderung: Sie wird nur aufgerufen, wenn der [Berechtigungsbewertungsfluss](/docs/de/agent-sdk/permissions#how-permissions-are-evaluated) zu einer Eingabeaufforderung führt. Tool-Aufrufe, die bereits von einem `allowedTools`-Eintrag, einer Settings-Allow-Regel oder dem Berechtigungsmodus wie `acceptEdits` oder `bypassPermissions` genehmigt wurden, rufen ihn nie auf. `AskUserQuestion`, MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) erreichen die Funktion auch, wenn eine Allow-Regel passt. Im `dontAsk`-Modus werden diese Aufrufe stattdessen verweigert, ohne sie aufzurufen. Um jeden Tool-Aufruf zu gaten, verwenden Sie stattdessen einen [`PreToolUse`-Hook](/docs/de/agent-sdk/hooks).

917 917

918```typescript theme={null}918```typescript theme={null}

919type CanUseTool = (919type CanUseTool = (

983 983

984| Feld | Typ | Beschreibung |984| Feld | Typ | Beschreibung |

985| :------------------------------ | :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |985| :------------------------------ | :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

986| `askUserQuestion.previewFormat` | `'markdown' \| 'html'` | Aktiviert das `preview`-Feld auf [`AskUserQuestion`](/de/agent-sdk/user-input#question-format)-Optionen und legt sein Inhaltsformat fest. Wenn nicht gesetzt, gibt Claude keine Vorschau aus |986| `askUserQuestion.previewFormat` | `'markdown' \| 'html'` | Aktiviert das `preview`-Feld auf [`AskUserQuestion`](/docs/de/agent-sdk/user-input#question-format)-Optionen und legt sein Inhaltsformat fest. Wenn nicht gesetzt, gibt Claude keine Vorschau aus |

987 987

988<h3 id="mcpserverconfig">988<h3 id="mcpserverconfig">

989 `McpServerConfig`989 `McpServerConfig`

1089];1089];

1090```1090```

1091 1091

1092Vollständige Informationen zum Erstellen und Verwenden von Plugins finden Sie unter [Plugins](/de/agent-sdk/plugins).1092Vollständige Informationen zum Erstellen und Verwenden von Plugins finden Sie unter [Plugins](/docs/de/agent-sdk/plugins).

1093 1093

1094<h2 id="message-types">1094<h2 id="message-types">

1095 Nachrichtentypen1095 Nachrichtentypen

1208};1208};

1209```1209```

1210 1210

1211Ein Benutzer-Turn, der von außerhalb der Sitzung eingefügt wird, dessen [`origin`](#sdkmessageorigin)-Art `peer` oder `channel` ist, erreicht den Stream als Wiedergabe, unabhängig davon, ob er während eines aktiven Turns geliefert wurde oder einen neuen Turn gestartet hat, während die Sitzung untätig war. {/* min-version: 2.1.207 */}Vor v2.1.207 erzeugte ein eingefügter Turn, der geliefert wurde, während die Sitzung untätig war, keine Nachricht im Stream und erschien nur, wenn Sie das Transkript erneut lasen.1211Ein Benutzer-Turn, der von außerhalb der Sitzung eingefügt wird, dessen [`origin`](#sdkmessageorigin)-Art `peer` oder `channel` ist, erreicht den Stream als Wiedergabe, unabhängig davon, ob er während eines aktiven Turns geliefert wurde oder einen neuen Turn gestartet hat, während die Sitzung untätig war. Vor v2.1.207 erzeugte ein eingefügter Turn, der geliefert wurde, während die Sitzung untätig war, keine Nachricht im Stream und erschien nur, wenn Sie das Transkript erneut lasen.

1212 1212

1213<h3 id="sdkresultmessage">1213<h3 id="sdkresultmessage">

1214 `SDKResultMessage`1214 `SDKResultMessage`

1277 1277

1278Das `origin`-Feld leitet die [`SDKMessageOrigin`](#sdkmessageorigin) der Benutzer-Nachricht weiter, die dieses Ergebnis ausgelöst hat. Wenn eine Hintergrund-Aufgabe beendet wird und das SDK einen synthetischen Follow-up-Turn einfügt, trägt die resultierende `SDKResultMessage` `origin: { kind: "task-notification" }`. Überprüfen Sie dieses Feld, um Ergebnisse zu unterscheiden, die Ihre Eingabeaufforderung beantworten, von Ergebnissen, die für Hintergrund-Aufgaben-Follow-ups ausgegeben werden, damit Sie letztere weiterleiten oder unterdrücken können. Das Feld fehlt bei Ergebnissen, die vor einem Benutzer-Turn ausgegeben werden, z. B. Startfehler.1278Das `origin`-Feld leitet die [`SDKMessageOrigin`](#sdkmessageorigin) der Benutzer-Nachricht weiter, die dieses Ergebnis ausgelöst hat. Wenn eine Hintergrund-Aufgabe beendet wird und das SDK einen synthetischen Follow-up-Turn einfügt, trägt die resultierende `SDKResultMessage` `origin: { kind: "task-notification" }`. Überprüfen Sie dieses Feld, um Ergebnisse zu unterscheiden, die Ihre Eingabeaufforderung beantworten, von Ergebnissen, die für Hintergrund-Aufgaben-Follow-ups ausgegeben werden, damit Sie letztere weiterleiten oder unterdrücken können. Das Feld fehlt bei Ergebnissen, die vor einem Benutzer-Turn ausgegeben werden, z. B. Startfehler.

1279 1279

1280Wenn ein `PreToolUse`-Hook `permissionDecision: "defer"` zurückgibt, hat das Ergebnis `stop_reason: "tool_deferred"` und `deferred_tool_use` enthält die `id`, den `name` und die `input` des ausstehenden Tools. Lesen Sie dieses Feld, um die Anfrage in Ihrer eigenen Benutzeroberfläche anzuzeigen, und setzen Sie dann mit derselben `session_id` fort, um fortzufahren. Siehe [Einen Tool-Aufruf für später aufschieben](/de/hooks#defer-a-tool-call-for-later) für die vollständige Runde.1280Wenn ein `PreToolUse`-Hook `permissionDecision: "defer"` zurückgibt, hat das Ergebnis `stop_reason: "tool_deferred"` und `deferred_tool_use` enthält die `id`, den `name` und die `input` des ausstehenden Tools. Lesen Sie dieses Feld, um die Anfrage in Ihrer eigenen Benutzeroberfläche anzuzeigen, und setzen Sie dann mit derselben `session_id` fort, um fortzufahren. Siehe [Einen Tool-Aufruf für später aufschieben](/docs/de/hooks#defer-a-tool-call-for-later) für die vollständige Runde.

1281 1281

1282<h3 id="sdksystemmessage">1282<h3 id="sdksystemmessage">

1283 `SDKSystemMessage`1283 `SDKSystemMessage`

1311};1311};

1312```1312```

1313 1313

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

~~1315~~

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

1317 1315

1318| Fähigkeit | Bedeutung |1316| Fähigkeit | Bedeutung |

1394 `SDKPluginInstallMessage`1392 `SDKPluginInstallMessage`

1395</h3>1393</h3>

1396 1394

1397Plugin-Installationsfortschritt-Ereignis. Wird ausgegeben, wenn [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/de/env-vars) gesetzt ist, damit Ihre Agent SDK-Anwendung die Marketplace-Plugin-Installation vor dem ersten Turn verfolgen kann. Die `started`- und `completed`-Status klammern die Gesamtinstallation. Die `installed`- und `failed`-Status melden einzelne Marketplaces und enthalten `name`.1395Plugin-Installationsfortschritt-Ereignis. Wird ausgegeben, wenn [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/de/env-vars) gesetzt ist, damit Ihre Agent SDK-Anwendung die Marketplace-Plugin-Installation vor dem ersten Turn verfolgen kann. Die `started`- und `completed`-Status klammern die Gesamtinstallation. Die `installed`- und `failed`-Status melden einzelne Marketplaces und enthalten `name`.

1398 1396

1399```typescript theme={null}1397```typescript theme={null}

1400type SDKPluginInstallMessage = {1398type SDKPluginInstallMessage = {

1477```1475```

1478 1476

1480| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1478| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

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

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

1487 1485

1488<h2 id="hook-types">1486<h2 id="hook-types">

1489 Hook-Typen1487 Hook-Typen

1490</h2>1488</h2>

1491 1489

1492Einen umfassenden Leitfaden zur Verwendung von Hooks mit Beispielen und häufigen Mustern finden Sie im [Hooks-Leitfaden](/de/agent-sdk/hooks).1490Einen umfassenden Leitfaden zur Verwendung von Hooks mit Beispielen und häufigen Mustern finden Sie im [Hooks-Leitfaden](/docs/de/agent-sdk/hooks).

1493 1491

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

1495 `HookEvent`1493 `HookEvent`

1598};1596};

1599```1597```

1600 1598

1601Das Feld `prompt_id` ist eine UUID, die die derzeit verarbeitete Benutzereingabe identifiziert. Sie entspricht dem [`prompt.id`-Attribut bei OpenTelemetry-Ereignissen](/de/monitoring-usage#event-correlation-attributes) und ist bis zur ersten Benutzereingabe nicht vorhanden. Erfordert Claude Code v2.1.196 oder später.1599Das Feld `prompt_id` ist eine UUID, die die derzeit verarbeitete Benutzereingabe identifiziert. Sie entspricht dem [`prompt.id`-Attribut bei OpenTelemetry-Ereignissen](/docs/de/monitoring-usage#event-correlation-attributes) und ist bis zur ersten Benutzereingabe nicht vorhanden. Erfordert Claude Code v2.1.196 oder später.

1602 1600

1603<h4 id="pretoolusehookinput">1601<h4 id="pretoolusehookinput">

1604 `PreToolUseHookInput`1602 `PreToolUseHookInput`

2069};2067};

2070```2068```

2071 2069

2072Stellt dem Benutzer während der Ausführung Klärungsfragen. Siehe [Genehmigungen und Benutzereingaben verarbeiten](/de/agent-sdk/user-input#handle-clarifying-questions) für Verwendungsdetails.2070Stellt dem Benutzer während der Ausführung Klärungsfragen. Siehe [Genehmigungen und Benutzereingaben verarbeiten](/docs/de/agent-sdk/user-input#handle-clarifying-questions) für Verwendungsdetails.

2073 2071

2074<h3 id="bash">2072<h3 id="bash">

2075 Bash2073 Bash

2108};2106};

2109```2107```

2110 2108

2111Führt eine Hintergrundquelle aus und liefert jedes Ereignis an Claude, damit es reagieren kann, ohne zu pollen: `command` führt ein Skript aus und gibt ein Ereignis pro Stdout-Zeile aus, und `ws` öffnet einen WebSocket und gibt ein Ereignis pro Textframe aus. Geben Sie genau eines von `command` oder `ws` an. {/* min-version: 2.1.195 */}Die `ws`-Quelle erfordert Claude Code v2.1.195 oder später.2109Führt eine Hintergrundquelle aus und liefert jedes Ereignis an Claude, damit es reagieren kann, ohne zu pollen: `command` führt ein Skript aus und gibt ein Ereignis pro Stdout-Zeile aus, und `ws` öffnet einen WebSocket und gibt ein Ereignis pro Textframe aus. Geben Sie genau eines von `command` oder `ws` an. Die `ws`-Quelle erfordert Claude Code v2.1.195 oder später.

2112 2110

2113Setzen Sie `persistent: true` für Sitzungslängen-Watches wie Log-Tails. Wenn Monitor einen Befehl ausführt, folgt es den gleichen Berechtigungsregeln wie Bash; ein WebSocket-Watch fordert separat zur Genehmigung auf. Siehe die [Monitor-Tool-Referenz](/de/tools-reference#monitor-tool) für Verhalten und Anbieter-Verfügbarkeit.2111Setzen Sie `persistent: true` für Sitzungslängen-Watches wie Log-Tails. Wenn Monitor einen Befehl ausführt, folgt es den gleichen Berechtigungsregeln wie Bash; ein WebSocket-Watch fordert separat zur Genehmigung auf. Siehe die [Monitor-Tool-Referenz](/docs/de/tools-reference#monitor-tool) für Verhalten und Anbieter-Verfügbarkeit.

2114 2112

2115<h3 id="taskoutput">2113<h3 id="taskoutput">

2116 TaskOutput2114 TaskOutput

2232};2230};

2233```2231```

2234 2232

2235Beendet eine laufende Hintergrund-Aufgabe oder Shell nach ID. {/* min-version: 2.1.198 */}Ab v2.1.198 akzeptiert `task_id` auch einen Agent-Team-Teamkollegen oder einen benannten Hintergrund-Agenten nach Agent-ID oder Name.2233Beendet eine laufende Hintergrund-Aufgabe oder Shell nach ID. Ab v2.1.198 akzeptiert `task_id` auch einen Agent-Team-Teamkollegen oder einen benannten Hintergrund-Agenten nach Agent-ID oder Name.

2236 2234

2237<h3 id="notebookedit">2235<h3 id="notebookedit">

2238 NotebookEdit2236 NotebookEdit

2299};2297};

2300```2298```

2301 2299

2302Führt einen [dynamischen Workflow](/de/workflows) aus: ein Skript, das viele Subagenten im Hintergrund orchestriert und ein konsolidiertes Ergebnis zurückgibt. Das `Workflow`-Tool ist in Agent SDK v0.3.149 und später verfügbar. Mindestens eines von `script`, `name` oder `scriptPath` ist erforderlich.2300Führt einen [dynamischen Workflow](/docs/de/workflows) aus: ein Skript, das viele Subagenten im Hintergrund orchestriert und ein konsolidiertes Ergebnis zurückgibt. Das `Workflow`-Tool ist in Agent SDK v0.3.149 und später verfügbar. Mindestens eines von `script`, `name` oder `scriptPath` ist erforderlich.

2303 2301

2304| Feld | Typ | Beschreibung |2302| Feld | Typ | Beschreibung |

2305| ----------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2303| ----------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

2328Erstellt und verwaltet eine strukturierte Aufgabenliste zum Verfolgen des Fortschritts.2326Erstellt und verwaltet eine strukturierte Aufgabenliste zum Verfolgen des Fortschritts.

2329 2327

2330<Note>2328<Note>

2331 Ab TypeScript Agent SDK 0.3.142 ist `TodoWrite` standardmäßig deaktiviert. Verwenden Sie stattdessen `TaskCreate`, `TaskGet`, `TaskUpdate` und `TaskList`. Siehe [Zu Task-Tools migrieren](/de/agent-sdk/todo-tracking#migrate-to-task-tools), um Ihren Überwachungscode zu aktualisieren, oder setzen Sie `CLAUDE_CODE_ENABLE_TASKS=0`, um zu `TodoWrite` zurückzukehren.2329 Ab TypeScript Agent SDK 0.3.142 ist `TodoWrite` standardmäßig deaktiviert. Verwenden Sie stattdessen `TaskCreate`, `TaskGet`, `TaskUpdate` und `TaskList`. Siehe [Zu Task-Tools migrieren](/docs/de/agent-sdk/todo-tracking#migrate-to-task-tools), um Ihren Überwachungscode zu aktualisieren, oder setzen Sie `CLAUDE_CODE_ENABLE_TASKS=0`, um zu `TodoWrite` zurückzukehren.

2332</Note>2330</Note>

2333 2331

2334<h3 id="taskcreate">2332<h3 id="taskcreate">

2568 2566

2569Gibt das Ergebnis vom Subagenten zurück. Diskriminiert nach dem `status`-Feld: `"completed"` für abgeschlossene Aufgaben, `"async_launched"` für Hintergrund-Aufgaben und `"remote_launched"` für Aufgaben, die Claude Code an eine Remote-Cloud-Sitzung versendet hat, wobei `sessionUrl` auf diese Sitzung verweist und `taskId` sie identifiziert.2567Gibt das Ergebnis vom Subagenten zurück. Diskriminiert nach dem `status`-Feld: `"completed"` für abgeschlossene Aufgaben, `"async_launched"` für Hintergrund-Aufgaben und `"remote_launched"` für Aufgaben, die Claude Code an eine Remote-Cloud-Sitzung versendet hat, wobei `sessionUrl` auf diese Sitzung verweist und `taskId` sie identifiziert.

2570 2568

2571Das Feld `resolvedModel` in den Varianten `completed` und `async_launched` benennt das Modell, auf dem der Subagent tatsächlich ausgeführt wurde, das sich vom angeforderten `model`-Input unterscheiden kann, wenn [`availableModels`](/de/model-config#restrict-model-selection) oder eine andere Überschreibung gilt. {/* min-version: 2.1.174 */}Dieses Feld erfordert Claude Code v2.1.174 oder später.2569Das Feld `resolvedModel` in den Varianten `completed` und `async_launched` benennt das Modell, auf dem der Subagent tatsächlich ausgeführt wurde, das sich vom angeforderten `model`-Input unterscheiden kann, wenn [`availableModels`](/docs/de/model-config#restrict-model-selection) oder eine andere Überschreibung gilt. Dieses Feld erfordert Claude Code v2.1.174 oder später.

2572 2570

2573In der Variante `completed` wird `worktreePath` gesetzt, wenn der Subagent in einem isolierten Git-Worktree ausgeführt wurde, und `worktreeBranch` benennt den Branch dieses Worktrees, wenn Claude Code ihn erstellt hat. `usage.service_tier` enthält die Service-Tier-Zeichenkette, die die API für die Anfragen des Subagenten gemeldet hat.2571In der Variante `completed` wird `worktreePath` gesetzt, wenn der Subagent in einem isolierten Git-Worktree ausgeführt wurde, und `worktreeBranch` benennt den Branch dieses Worktrees, wenn Claude Code ihn erstellt hat. `usage.service_tier` enthält die Service-Tier-Zeichenkette, die die API für die Anfragen des Subagenten gemeldet hat.

2574 2572

2934Gibt die vorherigen und aktualisierten Aufgabenlisten zurück.2932Gibt die vorherigen und aktualisierten Aufgabenlisten zurück.

2935 2933

2936<Note>2934<Note>

2937 Ab TypeScript Agent SDK 0.3.142 ist `TodoWrite` standardmäßig deaktiviert. Verwenden Sie stattdessen `TaskCreate`, `TaskGet`, `TaskUpdate` und `TaskList`. Siehe [Zu Task-Tools migrieren](/de/agent-sdk/todo-tracking#migrate-to-task-tools), um Ihren Überwachungscode zu aktualisieren, oder setzen Sie `CLAUDE_CODE_ENABLE_TASKS=0`, um zu `TodoWrite` zurückzukehren.2935 Ab TypeScript Agent SDK 0.3.142 ist `TodoWrite` standardmäßig deaktiviert. Verwenden Sie stattdessen `TaskCreate`, `TaskGet`, `TaskUpdate` und `TaskList`. Siehe [Zu Task-Tools migrieren](/docs/de/agent-sdk/todo-tracking#migrate-to-task-tools), um Ihren Überwachungscode zu aktualisieren, oder setzen Sie `CLAUDE_CODE_ENABLE_TASKS=0`, um zu `TodoWrite` zurückzukehren.

2938</Note>2936</Note>

2939 2937

2940<h3 id="taskcreate-2">2938<h3 id="taskcreate-2">

3228```3226```

3229 3227

3230| Feld | Typ | Beschreibung |3228| Feld | Typ | Beschreibung |

3231| :------------------------- | :----------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3229| :------------------------- | :----------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3233| `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. {/* min-version: 2.1.197 */}Erfordert Claude Code v2.1.197 oder später. |3231| `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. |

3325 `ModelUsage`3323 `ModelUsage`

3326</h3>3324</h3>

3327 3325

3328Pro-Modell-Nutzungsstatistiken, die in Ergebnis-Nachrichten zurückgegeben werden. Der `costUSD`-Wert ist eine clientseitige Schätzung. Siehe [Kosten und Nutzung verfolgen](/de/agent-sdk/cost-tracking) für Abrechnungsvorbehalt.3326Pro-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.

3329 3327

3330```typescript theme={null}3328```typescript theme={null}

3331type ModelUsage = {3329type ModelUsage = {

3390 `CallToolResult`3388 `CallToolResult`

3391</h3>3389</h3>

3392 3390

3393MCP-Tool-Ergebnistyp (aus `@modelcontextprotocol/sdk/types.js`). `structuredContent` ist ein JSON-Objekt, das zusammen mit `content` zurückgegeben werden kann, einschließlich Bildblöcke. Siehe [Strukturierte Daten zurückgeben](/de/agent-sdk/custom-tools#return-structured-data).3391MCP-Tool-Ergebnistyp (aus `@modelcontextprotocol/sdk/types.js`). `structuredContent` ist ein JSON-Objekt, das zusammen mit `content` zurückgegeben werden kann, einschließlich Bildblöcke. Siehe [Strukturierte Daten zurückgeben](/docs/de/agent-sdk/custom-tools#return-structured-data).

3394 3392

3395```typescript theme={null}3393```typescript theme={null}

3396type CallToolResult = {3394type CallToolResult = {

3740 3738

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

3742 3740

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

3744 3742

3745```typescript theme={null}3743```typescript theme={null}

3746type SDKBackgroundTasksChangedMessage = {3744type SDKBackgroundTasksChangedMessage = {

3760 `SDKThinkingTokensMessage`3758 `SDKThinkingTokensMessage`

3761</h3>3759</h3>

3762 3760

3763Wird ausgegeben, während Claude einen Denk-Block produziert, einschließlich eines redigierten, mit einer laufenden Schätzung der bisher generierten Denk-Token. `estimated_tokens` ist die laufende Summe für den aktuellen Denk-Block und `estimated_tokens_delta` ist das Inkrement, das von diesem Frame getragen wird. Verwenden Sie es für die Fortschrittsanzeige. Die endgültige Anzahl für die Top-Level-Agent-Schleife ist die `usage.output_tokens` der Ergebnis-Nachricht, die [keine Subagenten-Token enthält](/de/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); verwenden Sie [`modelUsage`](#modelusage) für die Gesamtbaum-Buchhaltung.3761Wird ausgegeben, während Claude einen Denk-Block produziert, einschließlich eines redigierten, mit einer laufenden Schätzung der bisher generierten Denk-Token. `estimated_tokens` ist die laufende Summe für den aktuellen Denk-Block und `estimated_tokens_delta` ist das Inkrement, das von diesem Frame getragen wird. Verwenden Sie es für die Fortschrittsanzeige. Die endgültige Anzahl für die Top-Level-Agent-Schleife ist die `usage.output_tokens` der Ergebnis-Nachricht, die [keine Subagenten-Token enthält](/docs/de/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); verwenden Sie [`modelUsage`](#modelusage) für die Gesamtbaum-Buchhaltung.

3764 3762

3765{/* min-version: 2.1.153 */}Erfordert Claude Code v2.1.153 oder später.3763Erfordert Claude Code v2.1.153 oder später.

3766 3764

3767```typescript theme={null}3765```typescript theme={null}

3768type SDKThinkingTokensMessage = {3766type SDKThinkingTokensMessage = {

3815};3813};

3816```3814```

3817 3815

3818{/* min-version: 2.1.181 */}Wenn `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.3816Wenn `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.

3819 3817

3820<h3 id="sdklocalcommandoutputmessage">3818<h3 id="sdklocalcommandoutputmessage">

3821 `SDKLocalCommandOutputMessage`3819 `SDKLocalCommandOutputMessage`

3879};3877};

3880```3878```

3881 3879

3882{/* min-version: 2.1.203 */}Die veröffentlichten Typings des SDK deklarieren `SDKConversationResetMessage` in Claude Code v2.1.203 und später. Vor v2.1.203 referenzierte `SDKMessage` den Typ, ohne ihn zu deklarieren, daher schlug die Eingrenzung auf `type === "conversation_reset"` fehl, wenn `skipLibCheck` deaktiviert war.3880Die 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.

3883 3881

3884<h3 id="aborterror">3882<h3 id="aborterror">

3885 `AbortError`3883 `AbortError`

3930| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | Benutzerdefinierte ripgrep-Binärkonfiguration für Sandbox-Umgebungen |3928| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | Benutzerdefinierte ripgrep-Binärkonfiguration für Sandbox-Umgebungen |

3931 3929

3932<Note>3930<Note>

3933 Die Sandbox hängt von der Plattformunterstützung ab und benötigt unter Linux Tools wie `bubblewrap` und `socat`. Wenn `enabled` auf `true` gesetzt ist und die Sandbox nicht gestartet werden kann, meldet `query()` eine `result`-Nachricht mit `subtype: "error_during_execution"` und den Grund in `errors`. Für einen einzelnen `query()`-Aufruf wirft das SDK nach dem Liefern dieses Fehler-Ergebnisses, daher wickeln Sie die Schleife in einen try-Block ein, um über ihn hinwegzugehen. Siehe [Handle the result](/de/agent-sdk/agent-loop#handle-the-result) für den Fehlervertrag.3931 Die Sandbox hängt von der Plattformunterstützung ab und benötigt unter Linux Tools wie `bubblewrap` und `socat`. Wenn `enabled` auf `true` gesetzt ist und die Sandbox nicht gestartet werden kann, meldet `query()` eine `result`-Nachricht mit `subtype: "error_during_execution"` und den Grund in `errors`. Für einen einzelnen `query()`-Aufruf wirft das SDK nach dem Liefern dieses Fehler-Ergebnisses, daher wickeln Sie die Schleife in einen try-Block ein, um über ihn hinwegzugehen. Siehe [Handle the result](/docs/de/agent-sdk/agent-loop#handle-the-result) für den Fehlervertrag.

3934 3932

3935 Um stattdessen unsandboxed auszuführen, setzen Sie `failIfUnavailable: false`.3933 Um stattdessen unsandboxed auszuführen, setzen Sie `failIfUnavailable: false`.

3936</Note>3934</Note>

3972 `SandboxNetworkConfig`3970 `SandboxNetworkConfig`

3973</h3>3971</h3>

3974 3972

3975Netzwerkspezifische Konfiguration für den Sandbox-Modus. Diese Einstellungen gelten für sandboxed Bash-Befehle, wenn `enabled` in den übergeordneten [`SandboxSettings`](#sandboxsettings) auf `true` gesetzt ist. Sie beschränken das WebFetch-Tool nicht, das stattdessen [Berechtigungsregeln](/de/permissions#webfetch) verwendet.3973Netzwerkspezifische Konfiguration für den Sandbox-Modus. Diese Einstellungen gelten für sandboxed Bash-Befehle, wenn `enabled` in den übergeordneten [`SandboxSettings`](#sandboxsettings) auf `true` gesetzt ist. Sie beschränken das WebFetch-Tool nicht, das stattdessen [Berechtigungsregeln](/docs/de/permissions#webfetch) verwendet.

3976 3974

3977```typescript theme={null}3975```typescript theme={null}

3978type SandboxNetworkConfig = {3976type SandboxNetworkConfig = {

3991| :------------------------ | :--------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |3989| :------------------------ | :--------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

3994| `allowManagedDomainsOnly` | `boolean` | `false` | Nur verwaltete Einstellungen. Wenn in [verwalteten Einstellungen](/de/permissions#managed-settings) gesetzt, werden nur `allowedDomains`-Einträge aus verwalteten Einstellungen berücksichtigt und Einträge aus Benutzer-, Projekt- oder lokalen Einstellungen werden ignoriert. Hat keine Auswirkung, wenn über SDK-Optionen gesetzt |3992| `allowManagedDomainsOnly` | `boolean` | `false` | Nur verwaltete Einstellungen. Wenn in [verwalteten Einstellungen](/docs/de/permissions#managed-settings) gesetzt, werden nur `allowedDomains`-Einträge aus verwalteten Einstellungen berücksichtigt und Einträge aus Benutzer-, Projekt- oder lokalen Einstellungen werden ignoriert. Hat keine Auswirkung, wenn über SDK-Optionen gesetzt |

4000 3998

4001<Note>3999<Note>

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

4003</Note>4001</Note>

4004 4002

4005<h3 id="sandboxfilesystemconfig">4003<h3 id="sandboxfilesystemconfig">

4077<Warning>4075<Warning>

4078 Befehle, die mit `dangerouslyDisableSandbox: true` ausgeführt werden, haben vollständigen Systemzugriff. Stellen Sie sicher, dass Ihr `canUseTool`-Handler diese Anfragen sorgfältig validiert.4076 Befehle, die mit `dangerouslyDisableSandbox: true` ausgeführt werden, haben vollständigen Systemzugriff. Stellen Sie sicher, dass Ihr `canUseTool`-Handler diese Anfragen sorgfältig validiert.

4079 4077

4080 Wenn `permissionMode` auf `bypassPermissions` gesetzt ist und `allowUnsandboxedCommands` aktiviert ist, kann das Modell autonom Befehle außerhalb der Sandbox ausführen, ohne dass Genehmigungsaufforderungen erforderlich sind (eine explizite [`ask`-Regel](/de/agent-sdk/permissions#how-permissions-are-evaluated) erzwingt immer noch eine). Diese Kombination ermöglicht dem Modell effektiv, die Sandbox-Isolierung stillschweigend zu verlassen.4078 Wenn `permissionMode` auf `bypassPermissions` gesetzt ist und `allowUnsandboxedCommands` aktiviert ist, kann das Modell autonom Befehle außerhalb der Sandbox ausführen, ohne dass Genehmigungsaufforderungen erforderlich sind (eine explizite [`ask`-Regel](/docs/de/agent-sdk/permissions#how-permissions-are-evaluated) erzwingt immer noch eine). Diese Kombination ermöglicht dem Modell effektiv, die Sandbox-Isolierung stillschweigend zu verlassen.

4081</Warning>4079</Warning>

4082 4080

4083<h2 id="see-also">4081<h2 id="see-also">

4084 Siehe auch4082 Siehe auch

4085</h2>4083</h2>

4086 4084

4087* [SDK-Übersicht](/de/agent-sdk/overview) - Allgemeine SDK-Konzepte4085* [SDK-Übersicht](/docs/de/agent-sdk/overview) - Allgemeine SDK-Konzepte

4088* [Python SDK-Referenz](/de/agent-sdk/python) - Python SDK-Dokumentation4086* [Python SDK-Referenz](/docs/de/agent-sdk/python) - Python SDK-Dokumentation

4089* [CLI-Referenz](/de/cli-reference) - Befehlszeilenschnittstelle4087* [CLI-Referenz](/docs/de/cli-reference) - Befehlszeilenschnittstelle

4090* [Häufige Workflows](/de/common-workflows) - Schritt-für-Schritt-Anleitungen4088* [Häufige Workflows](/docs/de/common-workflows) - Schritt-für-Schritt-Anleitungen

agent-sdk/user-input.md +18 −18

Details

12 12

13Bei Klärungsfragen generiert Claude die Fragen und Optionen. Ihre Aufgabe besteht darin, sie den Benutzern zu präsentieren und ihre Auswahl zurückzugeben. Sie können diesem Ablauf keine eigenen Fragen hinzufügen; wenn Sie Benutzer selbst etwas fragen müssen, tun Sie dies separat in Ihrer Anwendungslogik.13Bei Klärungsfragen generiert Claude die Fragen und Optionen. Ihre Aufgabe besteht darin, sie den Benutzern zu präsentieren und ihre Auswahl zurückzugeben. Sie können diesem Ablauf keine eigenen Fragen hinzufügen; wenn Sie Benutzer selbst etwas fragen müssen, tun Sie dies separat in Ihrer Anwendungslogik.

14 14

15Der Callback kann unbegrenzt ausstehend bleiben. Die Ausführung bleibt pausiert, bis Ihr Callback zurückkommt, und das SDK bricht das Warten nur ab, wenn die Abfrage selbst abgebrochen wird. Wenn ein Benutzer länger braucht, um zu antworten, als Ihr Prozess vernünftigerweise laufen kann, geben Sie die [`defer`-Hook-Entscheidung](/de/hooks#defer-a-tool-call-for-later) zurück, mit der der Prozess beendet und später aus der persistierten Sitzung fortgesetzt werden kann.15Der Callback kann unbegrenzt ausstehend bleiben. Die Ausführung bleibt pausiert, bis Ihr Callback zurückkommt, und das SDK bricht das Warten nur ab, wenn die Abfrage selbst abgebrochen wird. Wenn ein Benutzer länger braucht, um zu antworten, als Ihr Prozess vernünftigerweise laufen kann, geben Sie die [`defer`-Hook-Entscheidung](/docs/de/hooks#defer-a-tool-call-for-later) zurück, mit der der Prozess beendet und später aus der persistierten Sitzung fortgesetzt werden kann.

16 16

17Diese Anleitung zeigt Ihnen, wie Sie jeden Anforderungstyp erkennen und angemessen reagieren.17Diese Anleitung zeigt Ihnen, wie Sie jeden Anforderungstyp erkennen und angemessen reagieren.

18 18

44 44

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

46 46

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

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

49 49

50<Warning>50<Warning>

51 **Der Callback wird nie für automatisch genehmigte Tools ausgelöst.** Jede Genehmigung früher im [Berechtigungsevaluierungsfluss](/de/agent-sdk/permissions#how-permissions-are-evaluated), eine Zulassungsregel oder ein Modus wie `acceptEdits` oder `bypassPermissions`, löst den Aufruf auf, bevor `canUseTool` konsultiert wird. Wenn Sie ein Tool einfach in `allowed_tools` auflisten, wird eine `canUseTool`-Überprüfung für dieses Tool nie ausgeführt, es sei denn, eine Abfrage-Regel oder der `plan`-Modus leitet den Aufruf zurück zu einer Eingabeaufforderung. Für Logik, die auf jeden Tool-Aufruf angewendet werden muss, verwenden Sie einen [`PreToolUse`-Hook](/de/agent-sdk/hooks), der vor dem Rest des Flusses ausgeführt wird und Anfragen zulassen, ablehnen oder ändern kann.51 **Der Callback wird nie für automatisch genehmigte Tools ausgelöst.** Jede Genehmigung früher im [Berechtigungsevaluierungsfluss](/docs/de/agent-sdk/permissions#how-permissions-are-evaluated), eine Zulassungsregel oder ein Modus wie `acceptEdits` oder `bypassPermissions`, löst den Aufruf auf, bevor `canUseTool` konsultiert wird. Wenn Sie ein Tool einfach in `allowed_tools` auflisten, wird eine `canUseTool`-Überprüfung für dieses Tool nie ausgeführt, es sei denn, eine Abfrage-Regel oder der `plan`-Modus leitet den Aufruf zurück zu einer Eingabeaufforderung. Für Logik, die auf jeden Tool-Aufruf angewendet werden muss, verwenden Sie einen [`PreToolUse`-Hook](/docs/de/agent-sdk/hooks), der vor dem Rest des Flusses ausgeführt wird und Anfragen zulassen, ablehnen oder ändern kann.

52 52

53 `AskUserQuestion`, MCP-Tools, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und Connector-Tools, [die Ihre Organisation auf `ask`](/de/mcp#organization-controls-on-connector-tools) gesetzt hat, erreichen den Callback auch dann, wenn eine Zulassungsregel zutrifft. Im `dontAsk`-Modus werden diese Aufrufe stattdessen abgelehnt, ohne den Callback aufzurufen.53 `AskUserQuestion`, MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und Connector-Tools, [die Ihre Organisation auf `ask`](/docs/de/mcp#organization-controls-on-connector-tools) gesetzt hat, erreichen den Callback auch dann, wenn eine Zulassungsregel zutrifft. Im `dontAsk`-Modus werden diese Aufrufe stattdessen abgelehnt, ohne den Callback aufzurufen.

54</Warning>54</Warning>

55 55

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

57 57

58<h2 id="handle-tool-approval-requests">58<h2 id="handle-tool-approval-requests">

59 Tool-Genehmigungsanfragen verarbeiten59 Tool-Genehmigungsanfragen verarbeiten

65| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |65| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

68| `options` (TS) / `context` (Python) | Zusätzlicher Kontext, einschließlich optionaler `suggestions` (vorgeschlagene `PermissionUpdate`-Einträge, um erneute Aufforderungen zu vermeiden) und eines Abbruchsignals. In TypeScript ist `signal` ein `AbortSignal`; in Python ist das Signalfeld für zukünftige Verwendung reserviert. Siehe [`ToolPermissionContext`](/de/agent-sdk/python#toolpermissioncontext) für Python. |68| `options` (TS) / `context` (Python) | Zusätzlicher Kontext, einschließlich optionaler `suggestions` (vorgeschlagene `PermissionUpdate`-Einträge, um erneute Aufforderungen zu vermeiden) und eines Abbruchsignals. In TypeScript ist `signal` ein `AbortSignal`; in Python ist das Signalfeld für zukünftige Verwendung reserviert. Siehe [`ToolPermissionContext`](/docs/de/agent-sdk/python#toolpermissioncontext) für Python. |

69 69

70Das `input`-Objekt enthält Tool-spezifische Parameter. Häufige Beispiele:70Das `input`-Objekt enthält Tool-spezifische Parameter. Häufige Beispiele:

71 71

76| `Edit` | `file_path`, `old_string`, `new_string` |76| `Edit` | `file_path`, `old_string`, `new_string` |

77| `Read` | `file_path`, `offset`, `limit` |77| `Read` | `file_path`, `offset`, `limit` |

78 78

~~79Siehe die SDK-Referenz für vollständige Eingabeschemas: [Python](/de/agent-sdk/python#tool-input%2Foutput-types) | [TypeScript](/de/agent-sdk/typescript#tool-input-types).~~79Siehe die SDK-Referenz für vollständige Eingabeschemas: [Python](/docs/de/agent-sdk/python#tool-input%2Foutput-types) | [TypeScript](/docs/de/agent-sdk/typescript#tool-input-types).

80 80

81Sie können diese Informationen dem Benutzer anzeigen, damit er entscheiden kann, ob er die Aktion zulässt oder ablehnt, und dann die entsprechende Antwort zurückgeben.81Sie können diese Informationen dem Benutzer anzeigen, damit er entscheiden kann, ob er die Aktion zulässt oder ablehnt, und dann die entsprechende Antwort zurückgeben.

82 82

200</CodeGroup>200</CodeGroup>

201 201

202<Note>202<Note>

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

204</Note>204</Note>

205 205

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

216| **Zulassen** | `PermissionResultAllow(updated_input=...)` | `{ behavior: "allow", updatedInput }` |216| **Zulassen** | `PermissionResultAllow(updated_input=...)` | `{ behavior: "allow", updatedInput }` |

217| **Ablehnen** | `PermissionResultDeny(message=...)` | `{ behavior: "deny", message }` |217| **Ablehnen** | `PermissionResultDeny(message=...)` | `{ behavior: "deny", message }` |

218 218

219Beim Zulassen wird das Tool mit der von Claude angeforderten Eingabe ausgeführt, es sei denn, Sie geben eine geänderte Eingabe zurück, `updatedInput` in TypeScript oder `updated_input` in Python. {/* min-version: 2.1.207 */}Vor v2.1.207 lehnte Claude Code ein Zulassungsergebnis ab, das `updatedInput` auslies, und lehnte den Tool-Aufruf mit einem Validierungsfehler ab.219Beim Zulassen wird das Tool mit der von Claude angeforderten Eingabe ausgeführt, es sei denn, Sie geben eine geänderte Eingabe zurück, `updatedInput` in TypeScript oder `updated_input` in Python. Vor v2.1.207 lehnte Claude Code ein Zulassungsergebnis ab, das `updatedInput` auslies, und lehnte den Tool-Aufruf mit einem Validierungsfehler ab.

220 220

221Beim Ablehnen geben Sie eine Nachricht an, die erklärt, warum. Claude sieht diese Nachricht und kann seinen Ansatz anpassen.221Beim Ablehnen geben Sie eine Nachricht an, die erklärt, warum. Claude sieht diese Nachricht und kann seinen Ansatz anpassen.

222 222

247* **Genehmigen und merken**: Geben Sie eine vorgeschlagene Berechtigungsregel zurück, damit übereinstimmende Aufrufe das nächste Mal die Aufforderung überspringen247* **Genehmigen und merken**: Geben Sie eine vorgeschlagene Berechtigungsregel zurück, damit übereinstimmende Aufrufe das nächste Mal die Aufforderung überspringen

248* **Ablehnen**: Blockieren Sie das Tool und teilen Sie Claude mit, warum248* **Ablehnen**: Blockieren Sie das Tool und teilen Sie Claude mit, warum

249* **Alternative vorschlagen**: Blockieren Sie, aber leiten Sie Claude zu dem hin, was der Benutzer stattdessen möchte249* **Alternative vorschlagen**: Blockieren Sie, aber leiten Sie Claude zu dem hin, was der Benutzer stattdessen möchte

250* **Vollständig umleiten**: Verwenden Sie [Streaming-Eingabe](/de/agent-sdk/streaming-vs-single-mode), um Claude eine völlig neue Anweisung zu senden250* **Vollständig umleiten**: Verwenden Sie [Streaming-Eingabe](/docs/de/agent-sdk/streaming-vs-single-mode), um Claude eine völlig neue Anweisung zu senden

251 251

252<Tabs>252<Tabs>

253 <Tab title="Genehmigen">253 <Tab title="Genehmigen">

311 </Tab>311 </Tab>

312 312

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

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

315 315

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

317 317

415 </Tab>415 </Tab>

416 416

417 <Tab title="Vollständig umleiten">417 <Tab title="Vollständig umleiten">

418 Für eine vollständige Richtungsänderung (nicht nur einen Anstoß) verwenden Sie [Streaming-Eingabe](/de/agent-sdk/streaming-vs-single-mode), um Claude eine neue Anweisung direkt zu senden. Dies umgeht die aktuelle Tool-Anfrage und gibt Claude völlig neue Anweisungen zum Befolgen.418 Für eine vollständige Richtungsänderung (nicht nur einen Anstoß) verwenden Sie [Streaming-Eingabe](/docs/de/agent-sdk/streaming-vs-single-mode), um Claude eine neue Anweisung direkt zu senden. Dies umgeht die aktuelle Tool-Anfrage und gibt Claude völlig neue Anweisungen zum Befolgen.

419 </Tab>419 </Tab>

420</Tabs>420</Tabs>

421 421

426Wenn Claude mehr Anleitung zu einer Aufgabe mit mehreren gültigen Ansätzen benötigt, ruft es das `AskUserQuestion`-Tool auf. Dies löst Ihren `canUseTool`-Callback mit `toolName` auf `AskUserQuestion` aus. Die Eingabe enthält Claudes Fragen als Multiple-Choice-Optionen, die Sie dem Benutzer anzeigen und deren Auswahl zurückgeben.426Wenn Claude mehr Anleitung zu einer Aufgabe mit mehreren gültigen Ansätzen benötigt, ruft es das `AskUserQuestion`-Tool auf. Dies löst Ihren `canUseTool`-Callback mit `toolName` auf `AskUserQuestion` aus. Die Eingabe enthält Claudes Fragen als Multiple-Choice-Optionen, die Sie dem Benutzer anzeigen und deren Auswahl zurückgeben.

427 427

428<Tip>428<Tip>

429 Klärungsfragen sind besonders häufig im [`plan`-Modus](/de/agent-sdk/permissions#plan-mode-plan), in dem Claude die Codebasis erkundet und Fragen stellt, bevor er einen Plan vorschlägt. Dies macht den Plan-Modus ideal für interaktive Workflows, bei denen Claude Anforderungen sammeln soll, bevor Änderungen vorgenommen werden.429 Klärungsfragen sind besonders häufig im [`plan`-Modus](/docs/de/agent-sdk/permissions#plan-mode-plan), in dem Claude die Codebasis erkundet und Fragen stellt, bevor er einen Plan vorschlägt. Dies macht den Plan-Modus ideal für interaktive Workflows, bei denen Claude Anforderungen sammeln soll, bevor Änderungen vorgenommen werden.

430</Tip>430</Tip>

431 431

432Die folgenden Schritte zeigen, wie Sie Klärungsfragen verarbeiten:432Die folgenden Schritte zeigen, wie Sie Klärungsfragen verarbeiten:

864 Streaming-Eingabe864 Streaming-Eingabe

865</h3>865</h3>

866 866

867Verwenden Sie [Streaming-Eingabe](/de/agent-sdk/streaming-vs-single-mode), wenn Sie:867Verwenden Sie [Streaming-Eingabe](/docs/de/agent-sdk/streaming-vs-single-mode), wenn Sie:

868 868

869* **Den Agent mitten in der Aufgabe unterbrechen**: Senden Sie ein Abbruchsignal oder ändern Sie die Richtung, während Claude arbeitet869* **Den Agent mitten in der Aufgabe unterbrechen**: Senden Sie ein Abbruchsignal oder ändern Sie die Richtung, während Claude arbeitet

870* **Zusätzlichen Kontext bereitstellen**: Fügen Sie Informationen hinzu, die Claude benötigt, ohne darauf zu warten, dass es fragt870* **Zusätzlichen Kontext bereitstellen**: Fügen Sie Informationen hinzu, die Claude benötigt, ohne darauf zu warten, dass es fragt

876 Benutzerdefinierte Tools876 Benutzerdefinierte Tools

877</h3>877</h3>

878 878

879Verwenden Sie [benutzerdefinierte Tools](/de/agent-sdk/custom-tools), wenn Sie:879Verwenden Sie [benutzerdefinierte Tools](/docs/de/agent-sdk/custom-tools), wenn Sie:

880 880

881* **Strukturierte Eingaben sammeln**: Erstellen Sie Formulare, Assistenten oder mehrstufige Workflows, die über das Multiple-Choice-Format von `AskUserQuestion` hinausgehen881* **Strukturierte Eingaben sammeln**: Erstellen Sie Formulare, Assistenten oder mehrstufige Workflows, die über das Multiple-Choice-Format von `AskUserQuestion` hinausgehen

882* **Externe Genehmigungssysteme integrieren**: Verbinden Sie sich mit bestehenden Ticketing-, Workflow- oder Genehmigungsplattformen882* **Externe Genehmigungssysteme integrieren**: Verbinden Sie sich mit bestehenden Ticketing-, Workflow- oder Genehmigungsplattformen

888 Verwandte Ressourcen888 Verwandte Ressourcen

889</h2>889</h2>

890 890

891* [Berechtigungen konfigurieren](/de/agent-sdk/permissions): Richten Sie Berechtigungsmodi und -regeln ein891* [Berechtigungen konfigurieren](/docs/de/agent-sdk/permissions): Richten Sie Berechtigungsmodi und -regeln ein

892* [Ausführung mit Hooks steuern](/de/agent-sdk/hooks): Führen Sie benutzerdefinierten Code an Schlüsselpunkten im Agent-Lebenszyklus aus892* [Ausführung mit Hooks steuern](/docs/de/agent-sdk/hooks): Führen Sie benutzerdefinierten Code an Schlüsselpunkten im Agent-Lebenszyklus aus

893* [TypeScript SDK-Referenz](/de/agent-sdk/typescript#canusetool): Vollständige canUseTool-API-Dokumentation893* [TypeScript SDK-Referenz](/docs/de/agent-sdk/typescript#canusetool): Vollständige canUseTool-API-Dokumentation

agent-teams.md +30 −30

Details

7> Koordinieren Sie mehrere Claude Code-Instanzen, die zusammen als Team arbeiten, mit gemeinsamen Aufgaben, Messaging zwischen Agenten und zentraler Verwaltung.7> Koordinieren Sie mehrere Claude Code-Instanzen, die zusammen als Team arbeiten, mit gemeinsamen Aufgaben, Messaging zwischen Agenten und zentraler Verwaltung.

8 8

9<Warning>9<Warning>

10 Agent-Teams sind experimentell und standardmäßig deaktiviert. Aktivieren Sie sie, indem Sie `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` zu Ihrer [settings.json](/de/settings) oder Umgebung hinzufügen. Ohne diese Variable wird kein Team beim Sitzungsstart eingerichtet, keine Team-Verzeichnisse werden geschrieben, und Claude spawnt oder schlägt keine Teammates vor. Agent-Teams haben [bekannte Einschränkungen](#limitations) bezüglich Sitzungswiederaufnahme, Aufgabenkoordination und Abschaltungsverhalten.10 Agent-Teams sind experimentell und standardmäßig deaktiviert. Aktivieren Sie sie, indem Sie `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` zu Ihrer [settings.json](/docs/de/settings) oder Umgebung hinzufügen. Ohne diese Variable wird kein Team beim Sitzungsstart eingerichtet, keine Team-Verzeichnisse werden geschrieben, und Claude spawnt oder schlägt keine Teammates vor. Agent-Teams haben [bekannte Einschränkungen](#limitations) bezüglich Sitzungswiederaufnahme, Aufgabenkoordination und Abschaltungsverhalten.

11</Warning>11</Warning>

12 12

13Agent-Teams ermöglichen es Ihnen, mehrere Claude Code-Instanzen zu koordinieren, die zusammenarbeiten. Eine Sitzung fungiert als Team-Lead und koordiniert die Arbeit, weist Aufgaben zu und synthetisiert Ergebnisse. Teammates arbeiten unabhängig, jeder in seinem eigenen Kontextfenster, und kommunizieren direkt miteinander.13Agent-Teams ermöglichen es Ihnen, mehrere Claude Code-Instanzen zu koordinieren, die zusammenarbeiten. Eine Sitzung fungiert als Team-Lead und koordiniert die Arbeit, weist Aufgaben zu und synthetisiert Ergebnisse. Teammates arbeiten unabhängig, jeder in seinem eigenen Kontextfenster, und kommunizieren direkt miteinander.

14 14

15Im Gegensatz zu [subagents](/de/sub-agents), die innerhalb einer einzelnen Sitzung ausgeführt werden und nur an den Hauptagenten berichten können, können Sie auch direkt mit einzelnen Teammates interagieren, ohne den Lead einzubeziehen.15Im Gegensatz zu [subagents](/docs/de/sub-agents), die innerhalb einer einzelnen Sitzung ausgeführt werden und nur an den Hauptagenten berichten können, können Sie auch direkt mit einzelnen Teammates interagieren, ohne den Lead einzubeziehen.

16 16

17<Note>17<Note>

18 Diese Seite beschreibt Agent-Teams ab v2.1.178. Mit `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` gesetzt, benötigt das Spawnen eines Teammates keinen Setup-Schritt mehr, und die Bereinigung erfolgt automatisch, wenn die Sitzung beendet wird. Vor v2.1.178 haben Sie Claude gebeten, ein Team zu erstellen und zu benennen, und Claude hat die Tools `TeamCreate` und `TeamDelete` verwendet, um es einzurichten und zu entfernen. Beide Tools existieren nicht mehr. Die `team_name`-Eingabe im Agent-Tool wird akzeptiert, aber ignoriert, und das `team_name`-Feld in `TaskCreated`, `TaskCompleted` und `TeammateIdle` [Hook-Payloads](/de/hooks#taskcreated) trägt den sitzungsabgeleiteten Namen und ist veraltet.18 Diese Seite beschreibt Agent-Teams ab v2.1.178. Mit `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` gesetzt, benötigt das Spawnen eines Teammates keinen Setup-Schritt mehr, und die Bereinigung erfolgt automatisch, wenn die Sitzung beendet wird. Vor v2.1.178 haben Sie Claude gebeten, ein Team zu erstellen und zu benennen, und Claude hat die Tools `TeamCreate` und `TeamDelete` verwendet, um es einzurichten und zu entfernen. Beide Tools existieren nicht mehr. Die `team_name`-Eingabe im Agent-Tool wird akzeptiert, aber ignoriert, und das `team_name`-Feld in `TaskCreated`, `TaskCompleted` und `TeammateIdle` [Hook-Payloads](/docs/de/hooks#taskcreated) trägt den sitzungsabgeleiteten Namen und ist veraltet.

19</Note>19</Note>

20 20

21<h2 id="when-to-use-agent-teams">21<h2 id="when-to-use-agent-teams">

29* **Debugging mit konkurrierenden Hypothesen**: Teammates testen verschiedene Theorien parallel und konvergieren schneller zur Antwort29* **Debugging mit konkurrierenden Hypothesen**: Teammates testen verschiedene Theorien parallel und konvergieren schneller zur Antwort

30* **Schichtenübergreifende Koordination**: Änderungen, die Frontend, Backend und Tests umfassen, jeweils von einem anderen Teammate verwaltet30* **Schichtenübergreifende Koordination**: Änderungen, die Frontend, Backend und Tests umfassen, jeweils von einem anderen Teammate verwaltet

31 31

32Agent-Teams fügen Koordinationsaufwand hinzu und verwenden deutlich mehr Tokens als eine einzelne Sitzung. Sie funktionieren am besten, wenn Teammates unabhängig arbeiten können. Für sequenzielle Aufgaben, Bearbeitungen in derselben Datei oder Arbeit mit vielen Abhängigkeiten sind eine einzelne Sitzung oder [subagents](/de/sub-agents) effektiver.32Agent-Teams fügen Koordinationsaufwand hinzu und verwenden deutlich mehr Tokens als eine einzelne Sitzung. Sie funktionieren am besten, wenn Teammates unabhängig arbeiten können. Für sequenzielle Aufgaben, Bearbeitungen in derselben Datei oder Arbeit mit vielen Abhängigkeiten sind eine einzelne Sitzung oder [subagents](/docs/de/sub-agents) effektiver.

33 33

34<h3 id="compare-with-subagents">34<h3 id="compare-with-subagents">

35 Vergleich mit subagents35 Vergleich mit subagents

36</h3>36</h3>

37 37

38Sowohl Agent-Teams als auch [subagents](/de/sub-agents) ermöglichen es Ihnen, Arbeit zu parallelisieren, aber sie funktionieren unterschiedlich. Wählen Sie basierend darauf, ob Ihre Worker miteinander kommunizieren müssen:38Sowohl Agent-Teams als auch [subagents](/docs/de/sub-agents) ermöglichen es Ihnen, Arbeit zu parallelisieren, aber sie funktionieren unterschiedlich. Wählen Sie basierend darauf, ob Ihre Worker miteinander kommunizieren müssen:

39 39

40<Frame caption="Subagents berichten Ergebnisse nur an den Hauptagenten zurück und sprechen nie miteinander. Bei Agent-Teams teilen sich Teammates eine Aufgabenliste, beanspruchen Arbeit und kommunizieren direkt miteinander.">40<Frame caption="Subagents berichten Ergebnisse nur an den Hauptagenten zurück und sprechen nie miteinander. Bei Agent-Teams teilen sich Teammates eine Aufgabenliste, beanspruchen Arbeit und kommunizieren direkt miteinander.">

41 <img src="https://mintcdn.com/claude-code/nsvRFSDNfpSU5nT7/images/subagents-vs-agent-teams-light.png?fit=max&auto=format&n=nsvRFSDNfpSU5nT7&q=85&s=2f8db9b4f3705dd3ab931fbe2d96e42a" className="dark:hidden" alt="Diagramm zum Vergleich von Subagent- und Agent-Team-Architekturen. Subagents werden vom Hauptagenten erzeugt, führen Arbeit aus und berichten Ergebnisse zurück. Agent-Teams koordinieren sich über eine gemeinsame Aufgabenliste, wobei Teammates direkt miteinander kommunizieren." width="4245" height="1615" data-path="images/subagents-vs-agent-teams-light.png" />41 <img src="https://mintcdn.com/claude-code/nsvRFSDNfpSU5nT7/images/subagents-vs-agent-teams-light.png?fit=max&auto=format&n=nsvRFSDNfpSU5nT7&q=85&s=2f8db9b4f3705dd3ab931fbe2d96e42a" className="dark:hidden" alt="Diagramm zum Vergleich von Subagent- und Agent-Team-Architekturen. Subagents werden vom Hauptagenten erzeugt, führen Arbeit aus und berichten Ergebnisse zurück. Agent-Teams koordinieren sich über eine gemeinsame Aufgabenliste, wobei Teammates direkt miteinander kommunizieren." width="4245" height="1615" data-path="images/subagents-vs-agent-teams-light.png" />

57 Agent-Teams aktivieren57 Agent-Teams aktivieren

58</h2>58</h2>

59 59

60Agent-Teams sind standardmäßig deaktiviert. Aktivieren Sie sie, indem Sie die Umgebungsvariable `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` auf `1` setzen, entweder in Ihrer Shell-Umgebung oder über [settings.json](/de/settings):60Agent-Teams sind standardmäßig deaktiviert. Aktivieren Sie sie, indem Sie die Umgebungsvariable `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` auf `1` setzen, entweder in Ihrer Shell-Umgebung oder über [settings.json](/docs/de/settings):

61 61

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

63{63{

81one on UX, one on technical architecture, one playing devil's advocate.81one on UX, one on technical architecture, one playing devil's advocate.

82```82```

83 83

84Von dort aus füllt Claude eine [gemeinsame Aufgabenliste](/de/interactive-mode#task-list), erzeugt Teammates für jede Perspektive, lässt sie das Problem erkunden und synthetisiert Erkenntnisse, wenn fertig.84Von dort aus füllt Claude eine [gemeinsame Aufgabenliste](/docs/de/interactive-mode#task-list), erzeugt Teammates für jede Perspektive, lässt sie das Problem erkunden und synthetisiert Erkenntnisse, wenn fertig.

85 85

86Das Terminal des Leads listet Teammates im Agent-Panel unterhalb der Prompt-Eingabe auf. Aus dem Panel:86Das Terminal des Leads listet Teammates im Agent-Panel unterhalb der Prompt-Eingabe auf. Aus dem Panel:

87 87

89* **Eingabe**: Öffnen Sie das Transkript des ausgewählten Teammates und senden Sie ihm direkt eine Nachricht89* **Eingabe**: Öffnen Sie das Transkript des ausgewählten Teammates und senden Sie ihm direkt eine Nachricht

90* **Escape**: Unterbrechen Sie den aktuellen Zug des ausgewählten Teammates90* **Escape**: Unterbrechen Sie den aktuellen Zug des ausgewählten Teammates

91 91

92{/* min-version: 2.1.199 */}Ab v2.1.199 bleibt die Zeile eines untätigen Teammates im Panel, während noch ein Teammate oder Subagent arbeitet, sodass Sie sie auswählen können, um sein Transkript zu überprüfen oder ihm mehr Arbeit zu geben. Sobald jeder Agent im Panel untätig ist, werden untätige Zeilen nach 30 Sekunden ausgeblendet und erscheinen beim nächsten Zug des Teammates wieder; der Teammate läuft weiter und ist adressierbar, während er ausgeblendet ist. In v2.1.181 bis v2.1.198 wurde eine untätige Zeile 30 Sekunden nach ihrem eigenen Zug ausgeblendet, auch während andere Teammates noch arbeiteten; untätige Zeilen werden in Versionen vor v2.1.181 nicht ausgeblendet.92Ab v2.1.199 bleibt die Zeile eines untätigen Teammates im Panel, während noch ein Teammate oder Subagent arbeitet, sodass Sie sie auswählen können, um sein Transkript zu überprüfen oder ihm mehr Arbeit zu geben. Sobald jeder Agent im Panel untätig ist, werden untätige Zeilen nach 30 Sekunden ausgeblendet und erscheinen beim nächsten Zug des Teammates wieder; der Teammate läuft weiter und ist adressierbar, während er ausgeblendet ist. In v2.1.181 bis v2.1.198 wurde eine untätige Zeile 30 Sekunden nach ihrem eigenen Zug ausgeblendet, auch während andere Teammates noch arbeiteten; untätige Zeilen werden in Versionen vor v2.1.181 nicht ausgeblendet.

93 93

94Wenn mehr als drei Teammates gleichzeitig untätig sind, werden die Zeilen über die ersten drei hinaus in einer einzelnen Zeile zusammengefasst, die die zusammengefassten Teammates zählt, z. B. `2 idle agents`, wenn fünf untätig sind. Wählen Sie sie aus und drücken Sie die Eingabetaste, um die zusammengefassten Zeilen zu erweitern, oder drücken Sie Esc, um sie wieder zusammenzufassen. Arbeitende Teammates, fehlgeschlagene Teammates und der Teammate, den Sie gerade anschauen, behalten immer ihre eigenen Zeilen.94Wenn mehr als drei Teammates gleichzeitig untätig sind, werden die Zeilen über die ersten drei hinaus in einer einzelnen Zeile zusammengefasst, die die zusammengefassten Teammates zählt, z. B. `2 idle agents`, wenn fünf untätig sind. Wählen Sie sie aus und drücken Sie die Eingabetaste, um die zusammengefassten Zeilen zu erweitern, oder drücken Sie Esc, um sie wieder zusammenzufassen. Arbeitende Teammates, fehlgeschlagene Teammates und der Teammate, den Sie gerade anschauen, behalten immer ihre eigenen Zeilen.

95 95

116 116

117Der Standard ist `"in-process"`. Vor v2.1.179 war der Standard `"auto"`, daher öffnen aktualisierte Sitzungen, die zuvor Split Panes öffneten, jetzt ein Terminal, es sei denn, Sie legen den Modus explizit fest. Setzen Sie `"auto"`, um Split Panes zu aktivieren, wenn Sie bereits in einer tmux-Sitzung ausgeführt werden oder Ihr Terminal iTerm2 ist, und fallen Sie ansonsten auf In-Process zurück. Die Einstellung `"tmux"` aktiviert den Split-Pane-Modus und erkennt automatisch, ob tmux oder iTerm2 basierend auf Ihrem Terminal verwendet werden soll.117Der Standard ist `"in-process"`. Vor v2.1.179 war der Standard `"auto"`, daher öffnen aktualisierte Sitzungen, die zuvor Split Panes öffneten, jetzt ein Terminal, es sei denn, Sie legen den Modus explizit fest. Setzen Sie `"auto"`, um Split Panes zu aktivieren, wenn Sie bereits in einer tmux-Sitzung ausgeführt werden oder Ihr Terminal iTerm2 ist, und fallen Sie ansonsten auf In-Process zurück. Die Einstellung `"tmux"` aktiviert den Split-Pane-Modus und erkennt automatisch, ob tmux oder iTerm2 basierend auf Ihrem Terminal verwendet werden soll.

118 118

119{/* min-version: 2.1.186 */}Ab v2.1.186 setzen Sie `"iterm2"`, um native Split Panes von iTerm2 explizit zu verwenden. Dieser Modus erfordert die [`it2` CLI](https://github.com/mkusaka/it2) und zeigt einen Fehler mit dem Installationsbefehl an, wenn `it2` fehlt. Die Setup-Eingabeaufforderung, die angeboten wird, `it2` zu installieren oder zu tmux zu wechseln, wird unter `"auto"` oder `"tmux"` angezeigt, wenn Ihr Terminal iTerm2 ist und tmux als Fallback verfügbar ist.119Ab v2.1.186 setzen Sie `"iterm2"`, um native Split Panes von iTerm2 explizit zu verwenden. Dieser Modus erfordert die [`it2` CLI](https://github.com/mkusaka/it2) und zeigt einen Fehler mit dem Installationsbefehl an, wenn `it2` fehlt. Die Setup-Eingabeaufforderung, die angeboten wird, `it2` zu installieren oder zu tmux zu wechseln, wird unter `"auto"` oder `"tmux"` angezeigt, wenn Ihr Terminal iTerm2 ist und tmux als Fallback verfügbar ist.

120 120

121Um den Standard zu überschreiben, setzen Sie [`teammateMode`](/de/settings#available-settings) in `~/.claude/settings.json`:121Um den Standard zu überschreiben, setzen Sie [`teammateMode`](/docs/de/settings#available-settings) in `~/.claude/settings.json`:

122 122

123```json theme={null}123```json theme={null}

124{124{

150 150

151Teammates erben standardmäßig nicht die `/model`-Auswahl des Leads. Um das Modell zu ändern, das verwendet wird, wenn der Prompt keines angibt, setzen Sie **Standard-Teammate-Modell** in `/config`. Wählen Sie **Standard (Modell des Leaders)**, damit Teammates dem aktuellen Modell des Leads folgen.151Teammates erben standardmäßig nicht die `/model`-Auswahl des Leads. Um das Modell zu ändern, das verwendet wird, wenn der Prompt keines angibt, setzen Sie **Standard-Teammate-Modell** in `/config`. Wählen Sie **Standard (Modell des Leaders)**, damit Teammates dem aktuellen Modell des Leads folgen.

152 152

153{/* min-version: 2.1.186 */}Teammates erben die [Anstrengungsstufe](/de/model-config#adjust-effort-level) des Leads. Im Split-Pane-Modus gilt dies ab v2.1.186; frühere Versionen haben die Anstrengungsstufe der Lead-Sitzung nicht an Split-Pane-Teammates weitergegeben.153Teammates erben die [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) des Leads. Im Split-Pane-Modus gilt dies ab v2.1.186; frühere Versionen haben die Anstrengungsstufe der Lead-Sitzung nicht an Split-Pane-Teammates weitergegeben.

154 154

155<h3 id="require-plan-approval-for-teammates">155<h3 id="require-plan-approval-for-teammates">

156 Genehmigung von Plänen für Teammates erforderlich156 Genehmigung von Plänen für Teammates erforderlich

176* **In-Process-Modus**: verwenden Sie die Pfeiltasten nach oben und unten im Agent-Panel, um einen Teammate auszuwählen, drücken Sie dann die Eingabetaste, um seine Sitzung anzuzeigen und geben Sie ein, um ihm eine Nachricht zu senden. Drücken Sie `x` auf einem ausgewählten Teammate, um ihn zu stoppen. Drücken Sie Ctrl+T, um die Aufgabenliste umzuschalten.176* **In-Process-Modus**: verwenden Sie die Pfeiltasten nach oben und unten im Agent-Panel, um einen Teammate auszuwählen, drücken Sie dann die Eingabetaste, um seine Sitzung anzuzeigen und geben Sie ein, um ihm eine Nachricht zu senden. Drücken Sie `x` auf einem ausgewählten Teammate, um ihn zu stoppen. Drücken Sie Ctrl+T, um die Aufgabenliste umzuschalten.

177* **Split-Pane-Modus**: klicken Sie in den Pane eines Teammates, um direkt mit seiner Sitzung zu interagieren. Jeder Teammate hat eine vollständige Ansicht seines eigenen Terminals.177* **Split-Pane-Modus**: klicken Sie in den Pane eines Teammates, um direkt mit seiner Sitzung zu interagieren. Jeder Teammate hat eine vollständige Ansicht seines eigenen Terminals.

178 178

179Während Sie einen In-Process-Teammate anzeigen, gehen einfacher Text und [Skills](/de/skills) an diesen Teammate, aber integrierte Befehle werden weiterhin in der Sitzung des Leads ausgeführt.179Während Sie einen In-Process-Teammate anzeigen, gehen einfacher Text und [Skills](/docs/de/skills) an diesen Teammate, aber integrierte Befehle werden weiterhin in der Sitzung des Leads ausgeführt.

180 180

181Das Modell und der schnelle Modus eines Teammates sind festgelegt, wenn er spawnt, daher ändern `/model` und `/fast` nur die Einstellungen des Leads. {/* min-version: 2.1.199 */}Ab v2.1.199 zeigt die Eingabe eines dieser Befehle während der Anzeige eines Teammates einen Hinweis an, dass die Änderung für den Lead gilt; frühere Versionen haben sie auf den Lead angewendet, ohne Hinweis. `/effort` gilt weiterhin für die späteren Züge des angezeigten Teammates, da Teammates die [Anstrengungsstufe](/de/model-config#adjust-effort-level) des Leads befolgen.181Das Modell und der schnelle Modus eines Teammates sind festgelegt, wenn er spawnt, daher ändern `/model` und `/fast` nur die Einstellungen des Leads. Ab v2.1.199 zeigt die Eingabe eines dieser Befehle während der Anzeige eines Teammates einen Hinweis an, dass die Änderung für den Lead gilt; frühere Versionen haben sie auf den Lead angewendet, ohne Hinweis. `/effort` gilt weiterhin für die späteren Züge des angezeigten Teammates, da Teammates die [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) des Leads befolgen.

182 182

183<h3 id="assign-and-claim-tasks">183<h3 id="assign-and-claim-tasks">

184 Aufgaben zuweisen und beanspruchen184 Aufgaben zuweisen und beanspruchen

211 Erzwingen Sie Qualitätsgates mit Hooks211 Erzwingen Sie Qualitätsgates mit Hooks

212</h3>212</h3>

213 213

214Verwenden Sie [Hooks](/de/hooks), um Regeln durchzusetzen, wenn Teammates ihre Arbeit abschließen oder Aufgaben erstellt oder abgeschlossen werden:214Verwenden Sie [Hooks](/docs/de/hooks), um Regeln durchzusetzen, wenn Teammates ihre Arbeit abschließen oder Aufgaben erstellt oder abgeschlossen werden:

215 215

216* [`TeammateIdle`](/de/hooks#teammateidle): wird ausgeführt, wenn ein Teammate im Begriff ist, untätig zu werden. Beenden Sie mit Code 2, um Feedback zu senden und den Teammate weiterarbeiten zu lassen.216* [`TeammateIdle`](/docs/de/hooks#teammateidle): wird ausgeführt, wenn ein Teammate im Begriff ist, untätig zu werden. Beenden Sie mit Code 2, um Feedback zu senden und den Teammate weiterarbeiten zu lassen.

217* [`TaskCreated`](/de/hooks#taskcreated): wird ausgeführt, wenn eine Aufgabe erstellt wird. Beenden Sie mit Code 2, um die Erstellung zu verhindern und Feedback zu senden.217* [`TaskCreated`](/docs/de/hooks#taskcreated): wird ausgeführt, wenn eine Aufgabe erstellt wird. Beenden Sie mit Code 2, um die Erstellung zu verhindern und Feedback zu senden.

218* [`TaskCompleted`](/de/hooks#taskcompleted): wird ausgeführt, wenn eine Aufgabe als abgeschlossen markiert wird. Beenden Sie mit Code 2, um die Fertigstellung zu verhindern und Feedback zu senden.218* [`TaskCompleted`](/docs/de/hooks#taskcompleted): wird ausgeführt, wenn eine Aufgabe als abgeschlossen markiert wird. Beenden Sie mit Code 2, um die Fertigstellung zu verhindern und Feedback zu senden.

219 219

220<h2 id="how-agent-teams-work">220<h2 id="how-agent-teams-work">

221 Wie Agent-Teams funktionieren221 Wie Agent-Teams funktionieren

258* **Team-Konfiguration**: `~/.claude/teams/{team-name}/config.json`258* **Team-Konfiguration**: `~/.claude/teams/{team-name}/config.json`

259* **Aufgabenliste**: `~/.claude/tasks/{team-name}/`259* **Aufgabenliste**: `~/.claude/tasks/{team-name}/`

260 260

261Claude Code generiert beide automatisch beim Sitzungsstart und aktualisiert sie, wenn Teammates beitreten, untätig werden oder gehen. Das Team-Konfigurationsverzeichnis wird entfernt, wenn die Sitzung endet. Das Aufgabenlisten-Verzeichnis bleibt lokal bestehen und wird nie hochgeladen, sodass fortgesetzte Sitzungen ihre Aufgaben behalten. Die Aufbewahrung wird durch die gleiche [`cleanupPeriodDays`](/de/settings#available-settings) gesteuert, die Sie bereits für Sitzungstranskripte kontrollieren.261Claude Code generiert beide automatisch beim Sitzungsstart und aktualisiert sie, wenn Teammates beitreten, untätig werden oder gehen. Das Team-Konfigurationsverzeichnis wird entfernt, wenn die Sitzung endet. Das Aufgabenlisten-Verzeichnis bleibt lokal bestehen und wird nie hochgeladen, sodass fortgesetzte Sitzungen ihre Aufgaben behalten. Die Aufbewahrung wird durch die gleiche [`cleanupPeriodDays`](/docs/de/settings#available-settings) gesteuert, die Sie bereits für Sitzungstranskripte kontrollieren.

262 262

263Die Team-Konfiguration enthält Laufzeitzustand wie Sitzungs-IDs und tmux-Pane-IDs, also bearbeiten Sie sie nicht von Hand oder verfassen Sie sie nicht im Voraus: Ihre Änderungen werden beim nächsten Zustandsupdate überschrieben.263Die Team-Konfiguration enthält Laufzeitzustand wie Sitzungs-IDs und tmux-Pane-IDs, also bearbeiten Sie sie nicht von Hand oder verfassen Sie sie nicht im Voraus: Ihre Änderungen werden beim nächsten Zustandsupdate überschrieben.

264 264

272 Verwenden Sie Subagent-Definitionen für Teammates272 Verwenden Sie Subagent-Definitionen für Teammates

273</h3>273</h3>

274 274

275Beim Erzeugen eines Teammates können Sie einen [Subagent](/de/sub-agents)-Typ aus jedem [Subagent-Bereich](/de/sub-agents#choose-the-subagent-scope) referenzieren: Projekt, Benutzer, Plugin oder CLI-definiert. Dies ermöglicht es Ihnen, eine Rolle einmal zu definieren, wie z. B. einen Security-Reviewer oder Test-Runner, und sie sowohl als delegierter Subagent als auch als Agent-Team-Teammate wiederzuverwenden.275Beim Erzeugen eines Teammates können Sie einen [Subagent](/docs/de/sub-agents)-Typ aus jedem [Subagent-Bereich](/docs/de/sub-agents#choose-the-subagent-scope) referenzieren: Projekt, Benutzer, Plugin oder CLI-definiert. Dies ermöglicht es Ihnen, eine Rolle einmal zu definieren, wie z. B. einen Security-Reviewer oder Test-Runner, und sie sowohl als delegierter Subagent als auch als Agent-Team-Teammate wiederzuverwenden.

276 276

277Um eine Subagent-Definition zu verwenden, erwähnen Sie sie nach Name, wenn Sie Claude auffordern, den Teammate zu erzeugen:277Um eine Subagent-Definition zu verwenden, erwähnen Sie sie nach Name, wenn Sie Claude auffordern, den Teammate zu erzeugen:

278 278

292 292

293Teammates starten mit den Berechtigungseinstellungen des Leads. Wenn der Lead mit `--dangerously-skip-permissions` ausgeführt wird, tun dies auch alle Teammates. Nach dem Erzeugen können Sie einzelne Teammate-Modi ändern, aber Sie können keine Pro-Teammate-Modi zum Zeitpunkt des Erzeugung setzen.293Teammates starten mit den Berechtigungseinstellungen des Leads. Wenn der Lead mit `--dangerously-skip-permissions` ausgeführt wird, tun dies auch alle Teammates. Nach dem Erzeugen können Sie einzelne Teammate-Modi ändern, aber Sie können keine Pro-Teammate-Modi zum Zeitpunkt des Erzeugung setzen.

294 294

295Wenn ein Agent einem anderen eine Nachricht über `SendMessage` sendet, wird dem empfangenden Agent mitgeteilt, dass sie von einer anderen Claude-Sitzung stammt, nicht von Ihnen. Ein Teammate kann eine Berechtigungsaufforderung nicht genehmigen oder Zustimmung in Ihrem Namen erteilen, und ein Teammate, dem eine Aktion verweigert wurde, kann sie nicht an einen anderen Teammate weitergeben, um die Überprüfung zu umgehen. Im [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) behandelt der Klassifizierer einen Genehmigungsanspruch, der von einem anderen Agenten weitergeleitet wird, als nicht vertrauenswürdige Eingabe statt als Bestätigung von Ihnen.295Wenn ein Agent einem anderen eine Nachricht über `SendMessage` sendet, wird dem empfangenden Agent mitgeteilt, dass sie von einer anderen Claude-Sitzung stammt, nicht von Ihnen. Ein Teammate kann eine Berechtigungsaufforderung nicht genehmigen oder Zustimmung in Ihrem Namen erteilen, und ein Teammate, dem eine Aktion verweigert wurde, kann sie nicht an einen anderen Teammate weitergeben, um die Überprüfung zu umgehen. Im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) behandelt der Klassifizierer einen Genehmigungsanspruch, der von einem anderen Agenten weitergeleitet wird, als nicht vertrauenswürdige Eingabe statt als Bestätigung von Ihnen.

296 296

297Teammate-Berechtigungsaufforderungen werden an die Lead-Sitzung weitergeleitet, also genehmigen Sie sie dort selbst. [Plan-Genehmigung](#require-plan-approval-for-teammates) ist die konzipierte Ausnahme: die Lead-Sitzung gewährt Teammate-Plan-Genehmigungen ohne eine separate Aufforderung an Sie.297Teammate-Berechtigungsaufforderungen werden an die Lead-Sitzung weitergeleitet, also genehmigen Sie sie dort selbst. [Plan-Genehmigung](#require-plan-approval-for-teammates) ist die konzipierte Ausnahme: die Lead-Sitzung gewährt Teammate-Plan-Genehmigungen ohne eine separate Aufforderung an Sie.

298 298

305**Wie Teammates Informationen teilen:**305**Wie Teammates Informationen teilen:**

306 306

307* **Automatische Nachrichtenlieferung**: wenn Teammates Nachrichten senden, werden sie automatisch an Empfänger geliefert. Der Lead muss nicht auf Updates abfragen.307* **Automatische Nachrichtenlieferung**: wenn Teammates Nachrichten senden, werden sie automatisch an Empfänger geliefert. Der Lead muss nicht auf Updates abfragen.

308* **Untätigkeitsbenachrichtigungen**: wenn ein Teammate fertig ist und stoppt, benachrichtigt er automatisch den Lead. {/* min-version: 2.1.198 */}Ab v2.1.198 benachrichtigt ein Teammate, dessen Zug bei einem API-Fehler endet, den Lead, dass es fehlgeschlagen ist, und enthält den Fehlertext, anstatt normal beendet zu erscheinen.308* **Untätigkeitsbenachrichtigungen**: wenn ein Teammate fertig ist und stoppt, benachrichtigt er automatisch den Lead. Ab v2.1.198 benachrichtigt ein Teammate, dessen Zug bei einem API-Fehler endet, den Lead, dass es fehlgeschlagen ist, und enthält den Fehlertext, anstatt normal beendet zu erscheinen.

309* **Gemeinsame Aufgabenliste**: alle Agenten können den Aufgabenstatus sehen und verfügbare Arbeit beanspruchen.309* **Gemeinsame Aufgabenliste**: alle Agenten können den Aufgabenstatus sehen und verfügbare Arbeit beanspruchen.

310* **Teammate-Messaging**: senden Sie eine Nachricht an einen bestimmten Teammate nach Name. Um alle zu erreichen, senden Sie eine Nachricht pro Empfänger.310* **Teammate-Messaging**: senden Sie eine Nachricht an einen bestimmten Teammate nach Name. Um alle zu erreichen, senden Sie eine Nachricht pro Empfänger.

311 311

315 Token-Nutzung315 Token-Nutzung

316</h3>316</h3>

317 317

318Agent-Teams verwenden deutlich mehr Tokens als eine einzelne Sitzung. Jeder Teammate hat sein eigenes Kontextfenster, und die Token-Nutzung skaliert mit der Anzahl der aktiven Teammates. Für Recherche, Überprüfung und neue Feature-Arbeit sind die zusätzlichen Tokens normalerweise lohnenswert. Für Routineaufgaben ist eine einzelne Sitzung kostengünstiger. Siehe [Agent-Team-Token-Kosten](/de/costs#agent-team-token-costs) für Nutzungsleitfäden.318Agent-Teams verwenden deutlich mehr Tokens als eine einzelne Sitzung. Jeder Teammate hat sein eigenes Kontextfenster, und die Token-Nutzung skaliert mit der Anzahl der aktiven Teammates. Für Recherche, Überprüfung und neue Feature-Arbeit sind die zusätzlichen Tokens normalerweise lohnenswert. Für Routineaufgaben ist eine einzelne Sitzung kostengünstiger. Siehe [Agent-Team-Token-Kosten](/docs/de/costs#agent-team-token-costs) für Nutzungsleitfäden.

319 319

320<h2 id="use-case-examples">320<h2 id="use-case-examples">

321 Anwendungsbeispiele321 Anwendungsbeispiele

379 379

380Es gibt keine harte Grenze für die Anzahl der Teammates, aber praktische Einschränkungen gelten:380Es gibt keine harte Grenze für die Anzahl der Teammates, aber praktische Einschränkungen gelten:

381 381

382* **Token-Kosten skalieren linear**: jeder Teammate hat sein eigenes Kontextfenster und verbraucht Tokens unabhängig. Siehe [Agent-Team-Token-Kosten](/de/costs#agent-team-token-costs) für Details.382* **Token-Kosten skalieren linear**: jeder Teammate hat sein eigenes Kontextfenster und verbraucht Tokens unabhängig. Siehe [Agent-Team-Token-Kosten](/docs/de/costs#agent-team-token-costs) für Details.

383* **Koordinationsaufwand nimmt zu**: mehr Teammates bedeutet mehr Kommunikation, Aufgabenkoordination und Konfliktpotenzial383* **Koordinationsaufwand nimmt zu**: mehr Teammates bedeutet mehr Kommunikation, Aufgabenkoordination und Konfliktpotenzial

384* **Sinkende Erträge**: über einen bestimmten Punkt hinaus beschleunigen zusätzliche Teammates die Arbeit nicht proportional384* **Sinkende Erträge**: über einen bestimmten Punkt hinaus beschleunigen zusätzliche Teammates die Arbeit nicht proportional

385 385

386Beginnen Sie mit 3-5 Teammates für die meisten Workflows. Dies balanciert parallele Arbeit mit verwaltbarer Koordination. Die Beispiele in diesem Leitfaden verwenden 3-5 Teammates, weil dieser Bereich über verschiedene Aufgabentypen hinweg gut funktioniert.386Beginnen Sie mit 3-5 Teammates für die meisten Workflows. Dies balanciert parallele Arbeit mit verwaltbarer Koordination. Die Beispiele in diesem Leitfaden verwenden 3-5 Teammates, weil dieser Bereich über verschiedene Aufgabentypen hinweg gut funktioniert.

387 387

388Mit 5-6 [Aufgaben](/de/agent-teams#architecture) pro Teammate bleibt jeder produktiv, ohne übermäßiges Kontextwechsel. Wenn Sie 15 unabhängige Aufgaben haben, sind 3 Teammates ein guter Ausgangspunkt.388Mit 5-6 [Aufgaben](/docs/de/agent-teams#architecture) pro Teammate bleibt jeder produktiv, ohne übermäßiges Kontextwechsel. Wenn Sie 15 unabhängige Aufgaben haben, sind 3 Teammates ein guter Ausgangspunkt.

389 389

390Skalieren Sie nur auf, wenn die Arbeit wirklich davon profitiert, dass Teammates gleichzeitig arbeiten. Drei fokussierte Teammates übertreffen oft fünf verstreute.390Skalieren Sie nur auf, wenn die Arbeit wirklich davon profitiert, dass Teammates gleichzeitig arbeiten. Drei fokussierte Teammates übertreffen oft fünf verstreute.

391 391

452 Zu viele Berechtigungsaufforderungen452 Zu viele Berechtigungsaufforderungen

453</h3>453</h3>

454 454

455Teammate-Berechtigungsanfragen sprudeln zum Lead auf, was zu Reibung führen kann. Genehmigen Sie häufige Operationen in Ihren [Berechtigungseinstellungen](/de/permissions) vor dem Erzeugen von Teammates, um Unterbrechungen zu reduzieren.455Teammate-Berechtigungsanfragen sprudeln zum Lead auf, was zu Reibung führen kann. Genehmigen Sie häufige Operationen in Ihren [Berechtigungseinstellungen](/docs/de/permissions) vor dem Erzeugen von Teammates, um Unterbrechungen zu reduzieren.

456 456

457<h3 id="teammates-stopping-on-errors">457<h3 id="teammates-stopping-on-errors">

458 Teammates stoppen bei Fehlern458 Teammates stoppen bei Fehlern

463* Geben Sie ihnen zusätzliche Anweisungen direkt463* Geben Sie ihnen zusätzliche Anweisungen direkt

464* Erzeugen Sie einen Ersatz-Teammate, um die Arbeit fortzusetzen464* Erzeugen Sie einen Ersatz-Teammate, um die Arbeit fortzusetzen

465 465

466{/* min-version: 2.1.198 */}Ab v2.1.198 weckt eine Nachricht vom Lead oder einem anderen Teammate einen In-Process-Teammate auf, der darauf wartet, eine fehlgeschlagene API-Anfrage erneut zu versuchen, sodass er sofort erneut versucht wird, anstatt auf die vollständige Wiederholungsverzögerung zu warten.466Ab v2.1.198 weckt eine Nachricht vom Lead oder einem anderen Teammate einen In-Process-Teammate auf, der darauf wartet, eine fehlgeschlagene API-Anfrage erneut zu versuchen, sodass er sofort erneut versucht wird, anstatt auf die vollständige Wiederholungsverzögerung zu warten.

467 467

468<h3 id="lead-shuts-down-before-work-is-done">468<h3 id="lead-shuts-down-before-work-is-done">

469 Lead fährt herunter, bevor die Arbeit erledigt ist469 Lead fährt herunter, bevor die Arbeit erledigt ist

493* **Abschaltung kann langsam sein**: Teammates beenden ihre aktuelle Anfrage oder ihren Werkzeugaufruf, bevor sie herunterfahren, was Zeit in Anspruch nehmen kann.493* **Abschaltung kann langsam sein**: Teammates beenden ihre aktuelle Anfrage oder ihren Werkzeugaufruf, bevor sie herunterfahren, was Zeit in Anspruch nehmen kann.

494* **Ein Team pro Sitzung**: eine Sitzung hat genau ein Team, das auf diese Sitzung beschränkt ist. Sie können keine zusätzlichen benannten Teams erstellen oder ein Team über Sitzungen hinweg freigeben.494* **Ein Team pro Sitzung**: eine Sitzung hat genau ein Team, das auf diese Sitzung beschränkt ist. Sie können keine zusätzlichen benannten Teams erstellen oder ein Team über Sitzungen hinweg freigeben.

495* **Keine verschachtelten Teams**: Teammates können ihre eigenen Teammates nicht erzeugen. Nur der Lead kann das Team verwalten.495* **Keine verschachtelten Teams**: Teammates können ihre eigenen Teammates nicht erzeugen. Nur der Lead kann das Team verwalten.

496* **Keine Hintergrund-Subagenten von In-Process-Teammates**: die eigenen Subagenten eines In-Process-Teammates laufen im Vordergrund. Das Anfordern eines Hintergrund-Subagenten, ob mit `run_in_background` oder einer Subagenten-Definition, die `background: true` setzt, gibt einen Fehler zurück, da die Hintergrundarbeit eines Teammates nicht länger als der Prozess des Leads bestehen kann. Subagenten, die aus der Hauptkonversation gestartet werden, folgen dem [Hintergrund-Standard](/de/sub-agents#run-subagents-in-foreground-or-background).496* **Keine Hintergrund-Subagenten von In-Process-Teammates**: die eigenen Subagenten eines In-Process-Teammates laufen im Vordergrund. Das Anfordern eines Hintergrund-Subagenten, ob mit `run_in_background` oder einer Subagenten-Definition, die `background: true` setzt, gibt einen Fehler zurück, da die Hintergrundarbeit eines Teammates nicht länger als der Prozess des Leads bestehen kann. Subagenten, die aus der Hauptkonversation gestartet werden, folgen dem [Hintergrund-Standard](/docs/de/sub-agents#run-subagents-in-foreground-or-background).

497* **Lead ist fest**: die Hauptsitzung ist der Lead für seine Lebensdauer. Sie können einen Teammate nicht zum Lead befördern oder die Führung übertragen.497* **Lead ist fest**: die Hauptsitzung ist der Lead für seine Lebensdauer. Sie können einen Teammate nicht zum Lead befördern oder die Führung übertragen.

498* **Berechtigungen beim Erzeugen gesetzt**: alle Teammates starten mit dem Berechtigungsmodus des Leads. Sie können einzelne Teammate-Modi nach dem Erzeugen ändern, aber Sie können keine Pro-Teammate-Modi zum Zeitpunkt des Erzeugung setzen.498* **Berechtigungen beim Erzeugen gesetzt**: alle Teammates starten mit dem Berechtigungsmodus des Leads. Sie können einzelne Teammate-Modi nach dem Erzeugen ändern, aber Sie können keine Pro-Teammate-Modi zum Zeitpunkt des Erzeugung setzen.

499* **Split Panes erfordern tmux oder iTerm2**: der Standard-In-Process-Modus funktioniert in jedem Terminal. Der Split-Pane-Modus wird in VS Code's integriertem Terminal, Windows Terminal oder Ghostty nicht unterstützt.499* **Split Panes erfordern tmux oder iTerm2**: der Standard-In-Process-Modus funktioniert in jedem Terminal. Der Split-Pane-Modus wird in VS Code's integriertem Terminal, Windows Terminal oder Ghostty nicht unterstützt.

508 508

509Erkunden Sie verwandte Ansätze für parallele Arbeit und Delegation:509Erkunden Sie verwandte Ansätze für parallele Arbeit und Delegation:

510 510

511* **Leichte Delegation**: [subagents](/de/sub-agents) erzeugen Helper-Agenten für Recherche oder Überprüfung innerhalb Ihrer Sitzung, besser für Aufgaben, die keine Inter-Agent-Koordination benötigen511* **Leichte Delegation**: [subagents](/docs/de/sub-agents) erzeugen Helper-Agenten für Recherche oder Überprüfung innerhalb Ihrer Sitzung, besser für Aufgaben, die keine Inter-Agent-Koordination benötigen

512* **Manuelle parallele Sitzungen**: [Git worktrees](/de/worktrees) ermöglichen es Ihnen, mehrere Claude Code-Sitzungen selbst ohne automatisierte Teamkoordination auszuführen512* **Manuelle parallele Sitzungen**: [Git worktrees](/docs/de/worktrees) ermöglichen es Ihnen, mehrere Claude Code-Sitzungen selbst ohne automatisierte Teamkoordination auszuführen

513* **Vergleichen Sie Ansätze**: siehe den [Subagent vs Agent-Team](/de/features-overview#compare-similar-features) Vergleich für eine Seite-an-Seite-Aufschlüsselung513* **Vergleichen Sie Ansätze**: siehe den [Subagent vs Agent-Team](/docs/de/features-overview#compare-similar-features) Vergleich für eine Seite-an-Seite-Aufschlüsselung

agent-view.md +87 −87

Details

16 16

17Wenn Sie direkter in einer Agenten-Sitzung arbeiten möchten, hängen Sie sich an die Zeile an, um die vollständige Konversation zu betreten.17Wenn Sie direkter in einer Agenten-Sitzung arbeiten möchten, hängen Sie sich an die Zeile an, um die vollständige Konversation zu betreten.

18 18

~~19Um die Agenten-Ansicht mit Subagenten, Agent-Teams und Worktrees zu vergleichen, siehe [Agenten parallel ausführen](/de/agents).~~19Um die Agenten-Ansicht mit Subagenten, Agent-Teams und Worktrees zu vergleichen, siehe [Agenten parallel ausführen](/docs/de/agents).

20 20

21<Note>21<Note>

22 Die Agenten-Ansicht ist eine Forschungsvorschau und erfordert Claude Code v2.1.139 oder später. Überprüfen Sie Ihre Version mit `claude --version`. Die Benutzeroberfläche und Tastaturkürzel können sich ändern, wenn sich die Funktion weiterentwickelt.22 Die Agenten-Ansicht ist eine Forschungsvorschau und erfordert Claude Code v2.1.139 oder später. Überprüfen Sie Ihre Version mit `claude --version`. Die Benutzeroberfläche und Tastaturkürzel können sich ändern, wenn sich die Funktion weiterentwickelt.

70 70

71Sie können `claude agents` als Ihren primären Einstiegspunkt anstelle von `claude` verwenden: versenden Sie jede Aufgabe aus der Agenten-Ansicht, hängen Sie sich an, wenn Sie das vollständige Gespräch möchten, und drücken Sie `←`, um zur Tabelle zurückzukehren.71Sie können `claude agents` als Ihren primären Einstiegspunkt anstelle von `claude` verwenden: versenden Sie jede Aufgabe aus der Agenten-Ansicht, hängen Sie sich an, wenn Sie das vollständige Gespräch möchten, und drücken Sie `←`, um zur Tabelle zurückzukehren.

72 72

73{/* min-version: 2.1.205 */}Innerhalb einer regulären `claude`-Sitzung zählt der Hinweis `←` in der Eingabeaufforderungs-Fußzeile die Hintergrund-Agenten, die auf Sie warten, wie z. B. `← 2 agents`, und kehrt zu `← for agents` zurück, wenn keiner Eingaben benötigt. Zählungen über 99 werden als `99+` angezeigt. Die Zählung wird etwa alle zehn Sekunden aktualisiert, während das Terminal fokussiert ist, und sofort, wenn der Fokus zurückkehrt. Sie ändert kurzzeitig die Farbe, wenn sie sich bewegt und wenn ein Agent abgeschlossen wird, es sei denn, die Einstellung [`prefersReducedMotion`](/de/settings#available-settings) ist aktiviert, und sie ist im [Bildschirmlesemodus](/de/accessibility) verborgen. Auf [Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry](/de/third-party-integrations) bleibt der Hinweis in seiner einfachen Form `← for agents` ohne die Zählung. Erfordert Claude Code v2.1.205 oder später.73Innerhalb einer regulären `claude`-Sitzung zählt der Hinweis `←` in der Eingabeaufforderungs-Fußzeile die Hintergrund-Agenten, die auf Sie warten, wie z. B. `← 2 agents`, und kehrt zu `← for agents` zurück, wenn keiner Eingaben benötigt. Zählungen über 99 werden als `99+` angezeigt. Die Zählung wird etwa alle zehn Sekunden aktualisiert, während das Terminal fokussiert ist, und sofort, wenn der Fokus zurückkehrt. Sie ändert kurzzeitig die Farbe, wenn sie sich bewegt und wenn ein Agent abgeschlossen wird, es sei denn, die Einstellung [`prefersReducedMotion`](/docs/de/settings#available-settings) ist aktiviert, und sie ist im [Bildschirmlesemodus](/docs/de/accessibility) verborgen. Auf [Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry](/docs/de/third-party-integrations) bleibt der Hinweis in seiner einfachen Form `← for agents` ohne die Zählung. Erfordert Claude Code v2.1.205 oder später.

74 74

75<h2 id="monitor-sessions-with-agent-view">75<h2 id="monitor-sessions-with-agent-view">

76 Sitzungen mit der Agenten-Ansicht überwachen76 Sitzungen mit der Agenten-Ansicht überwachen

78 78

79Führen Sie `claude agents` aus, um die Agenten-Ansicht zu öffnen. Sie übernimmt das gesamte Terminal und listet jede Sitzung nach Status gruppiert auf, mit angehefteten Sitzungen und denjenigen, die Sie benötigen, oben. Jede Zeile zeigt den Namen der Sitzung, die aktuelle Aktivität und ihr Alter, gezählt von der Erstellung der Sitzung; das Alter einer abgeschlossenen Sitzung friert bei der Dauer der Ausführung ein.79Führen Sie `claude agents` aus, um die Agenten-Ansicht zu öffnen. Sie übernimmt das gesamte Terminal und listet jede Sitzung nach Status gruppiert auf, mit angehefteten Sitzungen und denjenigen, die Sie benötigen, oben. Jede Zeile zeigt den Namen der Sitzung, die aktuelle Aktivität und ihr Alter, gezählt von der Erstellung der Sitzung; das Alter einer abgeschlossenen Sitzung friert bei der Dauer der Ausführung ein.

80 80

81Der Name ist mit der Farbe getönt, die durch [`/color`](/de/commands) in dieser Sitzung festgelegt wurde. {/* min-version: 2.1.199 */}Ab v2.1.199 wird die Farbe beibehalten, wenn Sie eine Sitzung [in den Hintergrund verschieben](#from-inside-a-session) mit `←` oder `/background`.81Der Name ist mit der Farbe getönt, die durch [`/color`](/docs/de/commands) in dieser Sitzung festgelegt wurde. Ab v2.1.199 wird die Farbe beibehalten, wenn Sie eine Sitzung [in den Hintergrund verschieben](#from-inside-a-session) mit `←` oder `/background`.

82 82

83Standardmäßig zeigt die Liste jede Hintergrund-Sitzung, die Sie gestartet haben, über alle Ihre Projekte hinweg. Eine Sitzung, die in einem Repository funktioniert, und eine andere in einem anderen Worktree erscheinen beide hier, unabhängig davon, aus welchem Verzeichnis Sie die Agenten-Ansicht geöffnet haben. Um die Liste auf ein Projekt zu beschränken, übergeben Sie `--cwd`:83Standardmäßig zeigt die Liste jede Hintergrund-Sitzung, die Sie gestartet haben, über alle Ihre Projekte hinweg. Eine Sitzung, die in einem Repository funktioniert, und eine andere in einem anderen Worktree erscheinen beide hier, unabhängig davon, aus welchem Verzeichnis Sie die Agenten-Ansicht geöffnet haben. Um die Liste auf ein Projekt zu beschränken, übergeben Sie `--cwd`:

84 84

88 88

89Dies zeigt nur Sitzungen an, die unter diesem Verzeichnis gestartet wurden. Eine Sitzung, die [in einen Worktree verschoben wurde](#how-file-edits-are-isolated) unter `~/projects/my-app/.claude/worktrees/`, zählt immer noch als zu `~/projects/my-app` gehörend.89Dies zeigt nur Sitzungen an, die unter diesem Verzeichnis gestartet wurden. Eine Sitzung, die [in einen Worktree verschoben wurde](#how-file-edits-are-isolated) unter `~/projects/my-app/.claude/worktrees/`, zählt immer noch als zu `~/projects/my-app` gehörend.

90 90

91Interaktive Sitzungen, die Sie in anderen Terminals offen haben, werden nicht angezeigt, bis Sie sie [in den Hintergrund verschieben](#from-inside-a-session). [Subagenten](/de/sub-agents) und [Teamkollegen](/de/agent-teams), die eine Sitzung startet, werden nicht als separate Zeilen aufgelistet.91Interaktive Sitzungen, die Sie in anderen Terminals offen haben, werden nicht angezeigt, bis Sie sie [in den Hintergrund verschieben](#from-inside-a-session). [Subagenten](/docs/de/sub-agents) und [Teamkollegen](/docs/de/agent-teams), die eine Sitzung startet, werden nicht als separate Zeilen aufgelistet.

92 92

93```text theme={null}93```text theme={null}

94Angeheftet94Angeheftet

131| :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------- |131| :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

135 135

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

137 137

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

139 139

140Ab v2.1.198 sendet Claude Code auch eine Benachrichtigung über Ihren konfigurierten [Terminal-Benachrichtigungskanal](/de/terminal-config#get-a-terminal-bell-or-notification), während die Agenten-Ansicht offen ist, wenn eine lokale Hintergrund-Sitzung Ihre Eingabe benötigt, fertig wird oder fehlschlägt. Sitzungen, die nach einem Zeitplan ausgeführt werden, wie z. B. [`/loop`](/de/scheduled-tasks)-Sitzungen, benachrichtigen nur, wenn sie Ihre Eingabe benötigen. Benachrichtigungen verwenden die gleiche [`preferredNotifChannel`-Einstellung](/de/settings#available-settings) wie der Rest von Claude Code und lösen den [`Notification`-Hook](/de/hooks#notification) mit dem Typ `agent_needs_input` oder `agent_completed` aus.140Ab v2.1.198 sendet Claude Code auch eine Benachrichtigung über Ihren konfigurierten [Terminal-Benachrichtigungskanal](/docs/de/terminal-config#get-a-terminal-bell-or-notification), während die Agenten-Ansicht offen ist, wenn eine lokale Hintergrund-Sitzung Ihre Eingabe benötigt, fertig wird oder fehlschlägt. Sitzungen, die nach einem Zeitplan ausgeführt werden, wie z. B. [`/loop`](/docs/de/scheduled-tasks)-Sitzungen, benachrichtigen nur, wenn sie Ihre Eingabe benötigen. Benachrichtigungen verwenden die gleiche [`preferredNotifChannel`-Einstellung](/docs/de/settings#available-settings) wie der Rest von Claude Code und lösen den [`Notification`-Hook](/docs/de/hooks#notification) mit dem Typ `agent_needs_input` oder `agent_completed` aus.

141 141

142Hintergrund-Sitzungen benötigen kein offenes Terminal, um weiter zu funktionieren. Ein separater [Supervisor-Prozess](#the-supervisor-process) führt sie aus, sodass Sie die Agenten-Ansicht schließen, Ihre Shell schließen oder eine neue interaktive Sitzung starten können und Ihre versendete Arbeit läuft weiter.142Hintergrund-Sitzungen benötigen kein offenes Terminal, um weiter zu funktionieren. Ein separater [Supervisor-Prozess](#the-supervisor-process) führt sie aus, sodass Sie die Agenten-Ansicht schließen, Ihre Shell schließen oder eine neue interaktive Sitzung starten können und Ihre versendete Arbeit läuft weiter.

143 143

149 Zeilenzusammenfassungen149 Zeilenzusammenfassungen

150</h3>150</h3>

151 151

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

153 153

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

155 155

157 157

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

159 159

160Eine Runde, deren gesamte Ausgabe keine Buchstaben oder Ziffern enthält, wie z. B. eine [`/loop`](/de/scheduled-tasks)-Sitzung, die bei einer ruhigen Iteration ein einzelnes Symbol druckt, behält die vorherige Zusammenfassung und den Status der Zeile bei. Vor v2.1.205 wurde diese Runde neu klassifiziert und konnte eine Sitzung, die auf Ihre Eingabe wartete, zurück zu `Funktioniert` umschalten.160Eine Runde, deren gesamte Ausgabe keine Buchstaben oder Ziffern enthält, wie z. B. eine [`/loop`](/docs/de/scheduled-tasks)-Sitzung, die bei einer ruhigen Iteration ein einzelnes Symbol druckt, behält die vorherige Zusammenfassung und den Status der Zeile bei. Vor v2.1.205 wurde diese Runde neu klassifiziert und konnte eine Sitzung, die auf Ihre Eingabe wartete, zurück zu `Funktioniert` umschalten.

161 161

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

163 163

164<h3 id="pull-request-status">164<h3 id="pull-request-status">

165 Pull-Request-Status165 Pull-Request-Status

204 204

205Eine Antwort, die nicht zugestellt werden kann, weil der Hintergrund-Service nicht erreichbar ist oder der Versand fehlschlägt, wird gespeichert und an die Sitzung als nächster Prompt gesendet, wenn ihr Prozess wieder startet, und die Fehlermeldung besagt, dass die Antwort gespeichert wurde. Eine Antwort mit dem Präfix `!` wird nicht gespeichert, da der gespeicherte Text die Sitzung als einfacher Prompt erreichen würde, anstatt als Bash-Befehl ausgeführt zu werden.205Eine Antwort, die nicht zugestellt werden kann, weil der Hintergrund-Service nicht erreichbar ist oder der Versand fehlschlägt, wird gespeichert und an die Sitzung als nächster Prompt gesendet, wenn ihr Prozess wieder startet, und die Fehlermeldung besagt, dass die Antwort gespeichert wurde. Eine Antwort mit dem Präfix `!` wird nicht gespeichert, da der gespeicherte Text die Sitzung als einfacher Prompt erreichen würde, anstatt als Bash-Befehl ausgeführt zu werden.

206 206

207Mit [Sprachdiktat](/de/voice-dictation) aktiviert können Sie Ihre Push-to-Talk-Taste halten oder tippen, während die Antwort-Eingabe fokussiert ist, um eine Antwort zu diktieren, anstatt sie einzugeben. Das Gleiche funktioniert in der Versand-Eingabe am unteren Rand der Agenten-Ansicht.207Mit [Sprachdiktat](/docs/de/voice-dictation) aktiviert können Sie Ihre Push-to-Talk-Taste halten oder tippen, während die Antwort-Eingabe fokussiert ist, um eine Antwort zu diktieren, anstatt sie einzugeben. Das Gleiche funktioniert in der Versand-Eingabe am unteren Rand der Agenten-Ansicht.

208 208

209Verwenden Sie `↑` und `↓`, um benachbarte Sitzungen in der Vorschau anzuzeigen, ohne das Panel zu schließen, oder `→`, um sich anzuhängen.209Verwenden Sie `↑` und `↓`, um benachbarte Sitzungen in der Vorschau anzuzeigen, ohne das Panel zu schließen, oder `→`, um sich anzuhängen.

210 210

214 214

215Drücken Sie `Enter` oder `→` auf einer ausgewählten Zeile, um sich anzuhängen. Die Agenten-Ansicht wird durch die vollständige interaktive Sitzung ersetzt. Wenn Sie sich anhängen, sendet Claude eine kurze Zusammenfassung dessen, was passiert ist, während Sie weg waren.215Drücken Sie `Enter` oder `→` auf einer ausgewählten Zeile, um sich anzuhängen. Die Agenten-Ansicht wird durch die vollständige interaktive Sitzung ersetzt. Wenn Sie sich anhängen, sendet Claude eine kurze Zusammenfassung dessen, was passiert ist, während Sie weg waren.

216 216

217Während Sie angehängt sind, verhält sich die Sitzung wie jede andere Claude Code-Sitzung: [Befehle](/de/commands), Tastaturkürzel und Funktionen funktionieren alle, mit den folgenden Ausnahmen.217Während Sie angehängt sind, verhält sich die Sitzung wie jede andere Claude Code-Sitzung: [Befehle](/docs/de/commands), Tastaturkürzel und Funktionen funktionieren alle, mit den folgenden Ausnahmen.

218 218

219Eine Hintergrund-Sitzung lehnt `/install-github-app` und die [`/mcp`](/de/mcp)-Einstellungsliste, einschließlich ihrer Authentifizierungsaktionen, ab, ob Sie angehängt sind oder vom Vorschau-Panel aus antworten. Die Nachricht leitet Sie zu einer regulären `claude`-Sitzung, und `/mcp reconnect <server>`, `/mcp enable` und `/mcp disable` funktionieren immer noch.219Eine Hintergrund-Sitzung lehnt `/install-github-app` und die [`/mcp`](/docs/de/mcp)-Einstellungsliste, einschließlich ihrer Authentifizierungsaktionen, ab, ob Sie angehängt sind oder vom Vorschau-Panel aus antworten. Die Nachricht leitet Sie zu einer regulären `claude`-Sitzung, und `/mcp reconnect <server>`, `/mcp enable` und `/mcp disable` funktionieren immer noch.

220 220

221Angehängte Sitzungen werden immer im [Vollbildmodus](/de/fullscreen) gerendert, unabhängig von Ihrer `tui`-Einstellung, da eine Hintergrund-Sitzung keinen Terminal-Scrollback zum Anhängen hat. Scrollen Sie mit `PgUp`, `PgDn` oder dem Mausrad, und drücken Sie `Ctrl+O` für den Transkript-Modus. Ihr natives Terminal-Scroll und tmux-Kopiermodus zeigen nur den aktuellen Viewport, genau wie wenn Sie eine beliebige Vollbildanwendung ausführen.221Angehängte Sitzungen werden immer im [Vollbildmodus](/docs/de/fullscreen) gerendert, unabhängig von Ihrer `tui`-Einstellung, da eine Hintergrund-Sitzung keinen Terminal-Scrollback zum Anhängen hat. Scrollen Sie mit `PgUp`, `PgDn` oder dem Mausrad, und drücken Sie `Ctrl+O` für den Transkript-Modus. Ihr natives Terminal-Scroll und tmux-Kopiermodus zeigen nur den aktuellen Viewport, genau wie wenn Sie eine beliebige Vollbildanwendung ausführen.

222 222

223Drücken Sie `←` auf einer leeren Eingabeaufforderung, oder führen Sie `/exit` aus, um sich abzuhängen und zur Agenten-Ansicht zurückzukehren. Ab v2.1.198 funktioniert dies auf die gleiche Weise, ob Sie die Sitzung von der Agenten-Ansicht aus geöffnet haben oder mit `claude attach <id>` von Ihrer Shell aus.223Drücken Sie `←` auf einer leeren Eingabeaufforderung, oder führen Sie `/exit` aus, um sich abzuhängen und zur Agenten-Ansicht zurückzukehren. Ab v2.1.198 funktioniert dies auf die gleiche Weise, ob Sie die Sitzung von der Agenten-Ansicht aus geöffnet haben oder mit `claude attach <id>` von Ihrer Shell aus.

224 224

232 232

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

234 234

235Die Zehn-Sekunden-Grenze gilt nicht, während [Subagenten](/de/sub-agents) laufen. Claude Code wartet weiter, damit ihre Arbeit übertragen wird, und zeigt eine `Still backgrounding after the current tool`-Benachrichtigung an, während es wartet; drücken Sie `←` erneut, um ohne Warten in den Hintergrund zu gehen, was die Subagenten von vorne neu startet. Vor v2.1.203 endete das Warten nach zehn Sekunden und die laufenden Subagenten wurden ohne Warnung von vorne neu gestartet.235Die Zehn-Sekunden-Grenze gilt nicht, während [Subagenten](/docs/de/sub-agents) laufen. Claude Code wartet weiter, damit ihre Arbeit übertragen wird, und zeigt eine `Still backgrounding after the current tool`-Benachrichtigung an, während es wartet; drücken Sie `←` erneut, um ohne Warten in den Hintergrund zu gehen, was die Subagenten von vorne neu startet. Vor v2.1.203 endete das Warten nach zehn Sekunden und die laufenden Subagenten wurden ohne Warnung von vorne neu gestartet.

236 236

237Die Zeile wird auch aus einer neuen Sitzung ohne Gesprächsverlauf erstellt, sodass `→` zu ihr zurückkehrt. {/* max-version: 2.1.202 */}Vor v2.1.203 zeigte die Agenten-Ansicht einen Onboarding-Hinweis unter dieser Zeile an, wenn sie die einzige war.237Die Zeile wird auch aus einer neuen Sitzung ohne Gesprächsverlauf erstellt, sodass `→` zu ihr zurückkehrt. Vor v2.1.203 zeigte die Agenten-Ansicht einen Onboarding-Hinweis unter dieser Zeile an, wenn sie die einzige war.

238 238

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

240 240

313 313

314Geben Sie eine Eingabeaufforderung in die Eingabe am unteren Rand der Agenten-Ansicht ein und drücken Sie `Enter`, um eine neue Hintergrund-Sitzung zu starten. Die Sitzung wird automatisch aus der Eingabeaufforderung benannt. Sie können sie später mit `Ctrl+R` umbenennen.314Geben Sie eine Eingabeaufforderung in die Eingabe am unteren Rand der Agenten-Ansicht ein und drücken Sie `Enter`, um eine neue Hintergrund-Sitzung zu starten. Die Sitzung wird automatisch aus der Eingabeaufforderung benannt. Sie können sie später mit `Ctrl+R` umbenennen.

315 315

316Ein Name, den die Sitzung später erhält, wird auch auf ihrer Zeile angezeigt, einschließlich des Namens, den Claude ableitet, wenn Sie [einen Plan akzeptieren](/de/permission-modes#review-and-approve-a-plan) in dieser Sitzung. Vor v2.1.207 zeigte eine Hintergrund-Sitzung, die durch Akzeptieren eines Plans benannt wurde, diesen Namen in `/status` an, aber nicht auf ihrer Agenten-Ansicht-Zeile, bis Sie sie selbst umbenannten.316Ein Name, den die Sitzung später erhält, wird auch auf ihrer Zeile angezeigt, einschließlich des Namens, den Claude ableitet, wenn Sie [einen Plan akzeptieren](/docs/de/permission-modes#review-and-approve-a-plan) in dieser Sitzung. Vor v2.1.207 zeigte eine Hintergrund-Sitzung, die durch Akzeptieren eines Plans benannt wurde, diesen Namen in `/status` an, aber nicht auf ihrer Agenten-Ansicht-Zeile, bis Sie sie selbst umbenannten.

317 317

318Fügen Sie ein Bild in die Eingabeaufforderung ein, um einen Screenshot oder ein Diagramm mit der Aufgabe einzubeziehen.318Fügen Sie ein Bild in die Eingabeaufforderung ein, um einen Screenshot oder ein Diagramm mit der Aufgabe einzubeziehen.

319 319

320Eingefügter Text, der länger als 800 Zeichen ist oder mehr als zwei Zeilen umfasst, wird zu einem `[Pasted text #N]`-Platzhalter zusammengefasst, sodass die Eingabe auf einer Zeile bleibt; der vollständige Text wird beim Versenden gesendet. {/* min-version: 2.1.207 */}Um den zusammengefassten Text vor dem Versenden zu überprüfen oder zu bearbeiten, fügen Sie denselben Text erneut ein und der Platzhalter wird wieder in die Eingabe erweitert. Eine `paste again to expand`-Erinnerung wird für einige Sekunden unter der Eingabe angezeigt, auf Terminals mit mindestens 90 Spalten Breite. Vor v2.1.207 hat das erneute Einfügen desselben Textes einen zweiten Platzhalter hinzugefügt, anstatt den ersten zu erweitern.320Eingefügter Text, der länger als 800 Zeichen ist oder mehr als zwei Zeilen umfasst, wird zu einem `[Pasted text #N]`-Platzhalter zusammengefasst, sodass die Eingabe auf einer Zeile bleibt; der vollständige Text wird beim Versenden gesendet. Um den zusammengefassten Text vor dem Versenden zu überprüfen oder zu bearbeiten, fügen Sie denselben Text erneut ein und der Platzhalter wird wieder in die Eingabe erweitert. Eine `paste again to expand`-Erinnerung wird für einige Sekunden unter der Eingabe angezeigt, auf Terminals mit mindestens 90 Spalten Breite. Vor v2.1.207 hat das erneute Einfügen desselben Textes einen zweiten Platzhalter hinzugefügt, anstatt den ersten zu erweitern.

321 321

322Präfixieren oder erwähnen Sie Teile der Eingabeaufforderung, um zu steuern, wie die Sitzung startet:322Präfixieren oder erwähnen Sie Teile der Eingabeaufforderung, um zu steuern, wie die Sitzung startet:

323 323

324| Eingabe | Effekt |324| Eingabe | Effekt |

325| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |325| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

326| `<agent-name> <prompt>` | Wenn das erste Wort einem benutzerdefinierten [Subagenten](/de/sub-agents)-Namen entspricht, wird dieser Subagent als Hauptagent der Sitzung mit der Konfiguration aus seinem Frontmatter ausgeführt |326| `<agent-name> <prompt>` | Wenn das erste Wort einem benutzerdefinierten [Subagenten](/docs/de/sub-agents)-Namen entspricht, wird dieser Subagent als Hauptagent der Sitzung mit der Konfiguration aus seinem Frontmatter ausgeführt |

327| `@<agent-name>` | Erwähnen Sie einen benutzerdefinierten Subagenten überall in der Eingabeaufforderung, um ihn als Hauptagent auszuführen |327| `@<agent-name>` | Erwähnen Sie einen benutzerdefinierten Subagenten überall in der Eingabeaufforderung, um ihn als Hauptagent auszuführen |

328| `@<repo>` | Erwähnen Sie ein Repository, um die Sitzung dort auszuführen. Siehe [In ein bestimmtes Verzeichnis versenden](#dispatch-to-a-specific-directory), um zu erfahren, welche Repositories aufgelistet sind |328| `@<repo>` | Erwähnen Sie ein Repository, um die Sitzung dort auszuführen. Siehe [In ein bestimmtes Verzeichnis versenden](#dispatch-to-a-specific-directory), um zu erfahren, welche Repositories aufgelistet sind |

329| `/<command>` | Schlagen Sie [Skills](/de/skills) und [Befehle](/de/commands) vor, um als Eingabeaufforderung zu versenden |329| `/<command>` | Schlagen Sie [Skills](/docs/de/skills) und [Befehle](/docs/de/commands) vor, um als Eingabeaufforderung zu versenden |

330| `! <command>` | Führen Sie einen Shell-Befehl als Hintergrund-Job aus, anstatt eine Claude-Sitzung zu starten. Der Job wird als Zeile angezeigt, die Sie anhängen, beobachten und trennen können |330| `! <command>` | Führen Sie einen Shell-Befehl als Hintergrund-Job aus, anstatt eine Claude-Sitzung zu starten. Der Job wird als Zeile angezeigt, die Sie anhängen, beobachten und trennen können |

331| `#<number>` oder eine Pull Request-URL | Wenn eine Sitzung bereits an diesem PR funktioniert, wählen Sie sie aus, anstatt zu versenden |331| `#<number>` oder eine Pull Request-URL | Wenn eine Sitzung bereits an diesem PR funktioniert, wählen Sie sie aus, anstatt zu versenden |

336* `/exit` und `/quit` schließen die Agenten-Ansicht336* `/exit` und `/quit` schließen die Agenten-Ansicht

337* `/logout` meldet Sie ab337* `/logout` meldet Sie ab

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

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

340 340

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

342 342

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

344 344

345Wenn derselbe `@name` sowohl einem Subagenten als auch einem gleichgeordneten Repository entspricht, hat der Subagent Vorrang. Die Übereinstimmung mit dem ersten Wort gilt auch, sodass eine Eingabeaufforderung, die mit einem Ihrer Subagenten-Namen beginnt, diesen Subagenten versendet, anstatt das Wort als einfachen Text zu behandeln. Verwenden Sie die `@`-Form, wenn Sie explizit sein möchten, oder beginnen Sie die Eingabeaufforderung mit einem anderen Wort, um die Übereinstimmung zu vermeiden.345Wenn derselbe `@name` sowohl einem Subagenten als auch einem gleichgeordneten Repository entspricht, hat der Subagent Vorrang. Die Übereinstimmung mit dem ersten Wort gilt auch, sodass eine Eingabeaufforderung, die mit einem Ihrer Subagenten-Namen beginnt, diesen Subagenten versendet, anstatt das Wort als einfachen Text zu behandeln. Verwenden Sie die `@`-Form, wenn Sie explizit sein möchten, oder beginnen Sie die Eingabeaufforderung mit einem anderen Wort, um die Übereinstimmung zu vermeiden.

346 346

354* Öffnen Sie `claude agents` in einem übergeordneten Verzeichnis und erwähnen Sie ein untergeordnetes Repository mit `@<repo>` in der Eingabeaufforderung. Wenn Sie `@` eingeben, werden diese Ziele aufgelistet:354* Öffnen Sie `claude agents` in einem übergeordneten Verzeichnis und erwähnen Sie ein untergeordnetes Repository mit `@<repo>` in der Eingabeaufforderung. Wenn Sie `@` eingeben, werden diese Ziele aufgelistet:

355 355

356 * Git-Repositories eine Ebene unter dem Startverzeichnis356 * Git-Repositories eine Ebene unter dem Startverzeichnis

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

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

359 359

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

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

362 362

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

368 368

369Führen Sie `/background` oder seinen Alias `/bg` aus, um das aktuelle Gespräch in eine Hintergrund-Sitzung zu verschieben. Übergeben Sie eine Eingabeaufforderung wie `/bg run the test suite and fix any failures`, um eine weitere Anweisung zu senden, bevor Sie verschieben. Wenn Claude antwortet, wenn Sie `/bg` ausführen, wird die Antwort in der Hintergrund-Sitzung fortgesetzt.369Führen Sie `/background` oder seinen Alias `/bg` aus, um das aktuelle Gespräch in eine Hintergrund-Sitzung zu verschieben. Übergeben Sie eine Eingabeaufforderung wie `/bg run the test suite and fix any failures`, um eine weitere Anweisung zu senden, bevor Sie verschieben. Wenn Claude antwortet, wenn Sie `/bg` ausführen, wird die Antwort in der Hintergrund-Sitzung fortgesetzt.

370 370

371Das Beenden einer interaktiven Sitzung, die noch Hintergrund-Arbeit ausführt, wie z. B. Subagenten, Hintergrund-Shell-Befehle, Workflows oder [Monitore](/de/tools-reference#monitor-tool), zeigt einen Dialog `Background work is running` an, anstatt sofort zu beenden. {/* min-version: 2.1.198 */}Ab v2.1.198 bietet der Dialog `Move to background and exit` neben `Exit anyway` und `Stay` an. Wenn Sie diese Option wählen, wird die Sitzung auf die gleiche Weise wie `/background` in den Hintergrund verschoben und Sie werden dann zu Ihrer Shell zurückgebracht, sodass Arbeit, die fortgesetzt werden kann, weiterläuft und die Sitzung in der Agenten-Ansicht angezeigt wird. Die Option wird nicht angezeigt, wenn die Agenten-Ansicht [ausgeschaltet](#turn-off-agent-view) ist.371Das Beenden einer interaktiven Sitzung, die noch Hintergrund-Arbeit ausführt, wie z. B. Subagenten, Hintergrund-Shell-Befehle, Workflows oder [Monitore](/docs/de/tools-reference#monitor-tool), zeigt einen Dialog `Background work is running` an, anstatt sofort zu beenden. Ab v2.1.198 bietet der Dialog `Move to background and exit` neben `Exit anyway` und `Stay` an. Wenn Sie diese Option wählen, wird die Sitzung auf die gleiche Weise wie `/background` in den Hintergrund verschoben und Sie werden dann zu Ihrer Shell zurückgebracht, sodass Arbeit, die fortgesetzt werden kann, weiterläuft und die Sitzung in der Agenten-Ansicht angezeigt wird. Die Option wird nicht angezeigt, wenn die Agenten-Ansicht [ausgeschaltet](#turn-off-agent-view) ist.

372 372

373Das Verschieben aus einer interaktiven Sitzung startet einen neuen Prozess, der aus dem gespeicherten Gespräch fortgesetzt wird, und laufende Arbeit wird übertragen: Ausführen von Hintergrund-Shell-Befehlen, Hintergrund-Subagenten, dynamische Workflows und geplante Aufgaben, die Sie mit [`/loop`](/de/scheduled-tasks) erstellt haben, werden zur Hintergrund-Sitzung übertragen und laufen dort weiter. Ein Subagent wird zusammen mit allem übertragen, das er gestartet hat, daher wird er nur übertragen, wenn all diese Arbeit auch übertragen werden kann, einschließlich unter Windows. Um laufende Arbeit stattdessen zu stoppen, anstatt sie zu übertragen, setzen Sie die Umgebungsvariable [`CLAUDE_DISABLE_ADOPT=1`](/de/env-vars#variables); Claude Code fordert Sie dann auf, zu bestätigen, bevor Sie verschieben.373Das Verschieben aus einer interaktiven Sitzung startet einen neuen Prozess, der aus dem gespeicherten Gespräch fortgesetzt wird, und laufende Arbeit wird übertragen: Ausführen von Hintergrund-Shell-Befehlen, Hintergrund-Subagenten, dynamische Workflows und geplante Aufgaben, die Sie mit [`/loop`](/docs/de/scheduled-tasks) erstellt haben, werden zur Hintergrund-Sitzung übertragen und laufen dort weiter. Ein Subagent wird zusammen mit allem übertragen, das er gestartet hat, daher wird er nur übertragen, wenn all diese Arbeit auch übertragen werden kann, einschließlich unter Windows. Um laufende Arbeit stattdessen zu stoppen, anstatt sie zu übertragen, setzen Sie die Umgebungsvariable [`CLAUDE_DISABLE_ADOPT=1`](/docs/de/env-vars#variables); Claude Code fordert Sie dann auf, zu bestätigen, bevor Sie verschieben.

374 374

375Arbeit, die nicht übertragen werden kann, wie z. B. ein laufender [Monitor](/de/tools-reference#monitor-tool), wird gestoppt. Ein Hintergrund-Subagent, der einen Monitor besitzt, wird zusammen mit ihm gestoppt. Wenn eine solche Arbeit läuft, zeigt Claude Code ein Dialog `Background this session?`, damit Sie bestätigen können, bevor es gestoppt wird.375Arbeit, die nicht übertragen werden kann, wie z. B. ein laufender [Monitor](/docs/de/tools-reference#monitor-tool), wird gestoppt. Ein Hintergrund-Subagent, der einen Monitor besitzt, wird zusammen mit ihm gestoppt. Wenn eine solche Arbeit läuft, zeigt Claude Code ein Dialog `Background this session?`, damit Sie bestätigen können, bevor es gestoppt wird.

376 376

377Sobald sich die Sitzung im Hintergrund befindet, kann sie neue Subagenten, Monitore und Hintergrund-Befehle starten, und diese laufen bei späteren Trennungen und Wiederverbindungen weiter.377Sobald sich die Sitzung im Hintergrund befindet, kann sie neue Subagenten, Monitore und Hintergrund-Befehle starten, und diese laufen bei späteren Trennungen und Wiederverbindungen weiter.

378 378

385* `--fallback-model`385* `--fallback-model`

386* `--allow-dangerously-skip-permissions`386* `--allow-dangerously-skip-permissions`

387 387

388Verzeichnisse, die Sie während der Sitzung mit [`/add-dir`](/de/permissions#additional-directories-grant-file-access-not-configuration) hinzugefügt haben, werden ebenfalls übertragen.388Verzeichnisse, die Sie während der Sitzung mit [`/add-dir`](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) hinzugefügt haben, werden ebenfalls übertragen.

389 389

390Das Übertragen von `--allow-dangerously-skip-permissions` hält `bypassPermissions` in der versendeten Sitzung erreichbar, gewährt aber nichts Neues. Der Modus erfordert immer noch die gleiche einmalige interaktive Akzeptanz, die in [Berechtigungsmodus, Modell und Aufwand](#permission-mode-model-and-effort) beschrieben ist, bevor eine Sitzung ihn verwenden kann.390Das Übertragen von `--allow-dangerously-skip-permissions` hält `bypassPermissions` in der versendeten Sitzung erreichbar, gewährt aber nichts Neues. Der Modus erfordert immer noch die gleiche einmalige interaktive Akzeptanz, die in [Berechtigungsmodus, Modell und Aufwand](#permission-mode-model-and-effort) beschrieben ist, bevor eine Sitzung ihn verwenden kann.

391 391

399claude --bg "investigate the flaky SettingsChangeDetector test"399claude --bg "investigate the flaky SettingsChangeDetector test"

400```400```

401 401

402Die Eingabeaufforderung ist das Positionsargument, nicht ein `-p`-Wert. {/* min-version: 2.1.198 */}Ab v2.1.198 wird das Kombinieren von `--bg` mit `-p` oder `--print` mit einem Fehler abgelehnt, bevor eine Sitzung erstellt wird, da `--print` niemals die interaktive Sitzung startet, an die `claude agents` anhängt.402Die Eingabeaufforderung ist das Positionsargument, nicht ein `-p`-Wert. Ab v2.1.198 wird das Kombinieren von `--bg` mit `-p` oder `--print` mit einem Fehler abgelehnt, bevor eine Sitzung erstellt wird, da `--print` niemals die interaktive Sitzung startet, an die `claude agents` anhängt.

403 403

404Um einen bestimmten Subagenten als Hauptagent der Sitzung auszuführen, kombinieren Sie `--bg` mit `--agent`:404Um einen bestimmten Subagenten als Hauptagent der Sitzung auszuführen, kombinieren Sie `--bg` mit `--agent`:

405 405

447 Wie Dateibearbeitungen isoliert werden447 Wie Dateibearbeitungen isoliert werden

448</h3>448</h3>

449 449

450Jede Hintergrund-Sitzung, ob aus der Agenten-Ansicht, `/bg` oder `claude --bg` gestartet, beginnt in Ihrem Arbeitsverzeichnis. Bevor Dateien bearbeitet werden, verschiebt Claude die Sitzung in einen isolierten [Git-Worktree](/de/worktrees) unter `.claude/worktrees/`, sodass parallele Sitzungen denselben Checkout lesen können, aber jede in ihren eigenen schreibt.450Jede Hintergrund-Sitzung, ob aus der Agenten-Ansicht, `/bg` oder `claude --bg` gestartet, beginnt in Ihrem Arbeitsverzeichnis. Bevor Dateien bearbeitet werden, verschiebt Claude die Sitzung in einen isolierten [Git-Worktree](/docs/de/worktrees) unter `.claude/worktrees/`, sodass parallele Sitzungen denselben Checkout lesen können, aber jede in ihren eigenen schreibt.

451 451

452Claude überspringt den Worktree, wenn:452Claude überspringt den Worktree, wenn:

453 453

454* Die Sitzung bereits in einem verknüpften Git-Worktree läuft, ob Claude ihn unter `.claude/worktrees/` erstellt hat oder Sie ihn mit `git worktree add` anderswo erstellt haben454* Die Sitzung bereits in einem verknüpften Git-Worktree läuft, ob Claude ihn unter `.claude/worktrees/` erstellt hat oder Sie ihn mit `git worktree add` anderswo erstellt haben

455* Das Arbeitsverzeichnis kein Git-Repository ist und kein [`WorktreeCreate`-Hook](/de/hooks#worktreecreate) konfiguriert ist455* Das Arbeitsverzeichnis kein Git-Repository ist und kein [`WorktreeCreate`-Hook](/docs/de/hooks#worktreecreate) konfiguriert ist

456* Der Schreibvorgang außerhalb des Arbeitsverzeichnisses liegt456* Der Schreibvorgang außerhalb des Arbeitsverzeichnisses liegt

457 457

458Um die Worktree-Isolation für ein Repository auszuschalten, in dem Git-Worktrees unpraktisch sind, setzen Sie [`worktree.bgIsolation`](/de/settings#worktree-settings) auf `"none"`. Hintergrund-Sitzungen bearbeiten dann Ihre Arbeitskopie direkt, ohne zuerst in einen Worktree zu wechseln. Fügen Sie die Einstellung zur `.claude/settings.json` des Projekts hinzu:458Um die Worktree-Isolation für ein Repository auszuschalten, in dem Git-Worktrees unpraktisch sind, setzen Sie [`worktree.bgIsolation`](/docs/de/settings#worktree-settings) auf `"none"`. Hintergrund-Sitzungen bearbeiten dann Ihre Arbeitskopie direkt, ohne zuerst in einen Worktree zu wechseln. Fügen Sie die Einstellung zur `.claude/settings.json` des Projekts hinzu:

459 459

460```json theme={null}460```json theme={null}

461{461{

465}465}

466```466```

467 467

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

469 469

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

471 471

478 478

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

480 480

481Ein [Subagent](/de/sub-agents), den die Hintergrund-Sitzung erzeugt, erbt das Arbeitsverzeichnis der Sitzung, sodass seine Dateibearbeitungen im Worktree der Sitzung landen, anstatt in Ihrer Arbeitskopie. Um einem Subagenten stattdessen seinen eigenen separaten Worktree zu geben, setzen Sie [`isolation: worktree`](/de/sub-agents#supported-frontmatter-fields) in seinem Frontmatter oder übergeben Sie `isolation: "worktree"` beim Erzeugen.481Ein [Subagent](/docs/de/sub-agents), den die Hintergrund-Sitzung erzeugt, erbt das Arbeitsverzeichnis der Sitzung, sodass seine Dateibearbeitungen im Worktree der Sitzung landen, anstatt in Ihrer Arbeitskopie. Um einem Subagenten stattdessen seinen eigenen separaten Worktree zu geben, setzen Sie [`isolation: worktree`](/docs/de/sub-agents#supported-frontmatter-fields) in seinem Frontmatter oder übergeben Sie `isolation: "worktree"` beim Erzeugen.

482 482

483Ab v2.1.198 committed eine Hintergrund-Sitzung, die ihre Code-Änderungen in einem Worktree isoliert hat, auch, pusht ihren eigenen Branch und öffnet einen Entwurf-Pull-Request, ohne zu fragen. Das [`#N`-Label](#pull-request-status) wird auf ihrer Zeile angezeigt, wenn der Pull-Request geöffnet wird. Es pusht niemals zu `main` oder `master`, force-pusht oder merged niemals, und es überspringt den Pull-Request, wenn Sie ihm gesagt haben, keinen zu öffnen, oder das Repository hat kein Remote.483Ab v2.1.198 committed eine Hintergrund-Sitzung, die ihre Code-Änderungen in einem Worktree isoliert hat, auch, pusht ihren eigenen Branch und öffnet einen Entwurf-Pull-Request, ohne zu fragen. Das [`#N`-Label](#pull-request-status) wird auf ihrer Zeile angezeigt, wenn der Pull-Request geöffnet wird. Es pusht niemals zu `main` oder `master`, force-pusht oder merged niemals, und es überspringt den Pull-Request, wenn Sie ihm gesagt haben, keinen zu öffnen, oder das Repository hat kein Remote.

484 484

488 Das Modell festlegen488 Das Modell festlegen

489</h3>489</h3>

490 490

491Der im Header der Agenten-Ansicht angezeigte Modellname ist der Versand-Standard. Neue Sitzungen, die Sie aus der Eingabe starten, verwenden dieses Modell, das aus der [`model`-Einstellung](/de/settings#available-settings) in Ihren Benutzereinstellungen stammt. Legen Sie es fest, indem Sie ein Modell in der [`/model`-Auswahl](/de/model-config) auswählen, oder bearbeiten Sie die Einstellung direkt.491Der im Header der Agenten-Ansicht angezeigte Modellname ist der Versand-Standard. Neue Sitzungen, die Sie aus der Eingabe starten, verwenden dieses Modell, das aus der [`model`-Einstellung](/docs/de/settings#available-settings) in Ihren Benutzereinstellungen stammt. Legen Sie es fest, indem Sie ein Modell in der [`/model`-Auswahl](/docs/de/model-config) auswählen, oder bearbeiten Sie die Einstellung direkt.

492 492

493Um es für die gesamte Agenten-Ansicht-Sitzung zu überschreiben, übergeben Sie `--model` beim Öffnen der Agenten-Ansicht. Siehe [Berechtigungsmodus, Modell und Aufwand](#permission-mode-model-and-effort).493Um es für die gesamte Agenten-Ansicht-Sitzung zu überschreiben, übergeben Sie `--model` beim Öffnen der Agenten-Ansicht. Siehe [Berechtigungsmodus, Modell und Aufwand](#permission-mode-model-and-effort).

494 494

505 505

506* Übergeben Sie in der Shell `--model` mit `claude --bg`.506* Übergeben Sie in der Shell `--model` mit `claude --bg`.

507* Hängen Sie an eine laufende Sitzung an und führen Sie `/model` aus, um zu wechseln: Eine Auswahl aus der Auswahl oder ein eingegebenes `/model <name>` wird als Standard für neue Sitzungen gespeichert, es sei denn, Sie drücken `s` in der Auswahl für einen Wechsel nur für diese Sitzung. Ein Wechsel nur für diese Sitzung bleibt bestehen, wenn die Sitzung neu gestartet wird.507* Hängen Sie an eine laufende Sitzung an und führen Sie `/model` aus, um zu wechseln: Eine Auswahl aus der Auswahl oder ein eingegebenes `/model <name>` wird als Standard für neue Sitzungen gespeichert, es sei denn, Sie drücken `s` in der Auswahl für einen Wechsel nur für diese Sitzung. Ein Wechsel nur für diese Sitzung bleibt bestehen, wenn die Sitzung neu gestartet wird.

508* Versenden Sie einen [Subagenten](/de/sub-agents), dessen Frontmatter ein `model`-Feld setzt.508* Versenden Sie einen [Subagenten](/docs/de/sub-agents), dessen Frontmatter ein `model`-Feld setzt.

509 509

510<h3 id="permission-mode-model-and-effort">510<h3 id="permission-mode-model-and-effort">

511 Berechtigungsmodus, Modell und Aufwand511 Berechtigungsmodus, Modell und Aufwand

512</h3>512</h3>

513 513

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

515 515

516Die Cloud-Provider-Auswahl, wie `CLAUDE_CODE_USE_BEDROCK` oder `CLAUDE_CODE_USE_VERTEX`, und `ANTHROPIC_DEFAULT_*_MODEL`-Aliase folgen der Shell, die die Sitzung versendet hat. {/* min-version: 2.1.206 */}Wenn Sie eine [`CLAUDE_CODE_EXTRA_BODY`](/de/env-vars)-Anfragekörper-Überschreibung in dieser Shell exportieren, erreicht sie die Sitzung auf die gleiche Weise. Vor v2.1.206 ignorierten Hintergrund-Worker ein Shell-exportiertes `CLAUDE_CODE_EXTRA_BODY`.516Die Cloud-Provider-Auswahl, wie `CLAUDE_CODE_USE_BEDROCK` oder `CLAUDE_CODE_USE_VERTEX`, und `ANTHROPIC_DEFAULT_*_MODEL`-Aliase folgen der Shell, die die Sitzung versendet hat. Wenn Sie eine [`CLAUDE_CODE_EXTRA_BODY`](/docs/de/env-vars)-Anfragekörper-Überschreibung in dieser Shell exportieren, erreicht sie die Sitzung auf die gleiche Weise. Vor v2.1.206 ignorierten Hintergrund-Worker ein Shell-exportiertes `CLAUDE_CODE_EXTRA_BODY`.

517 517

518Wenn Sie ein Gateway-`ANTHROPIC_BASE_URL` in der versendenden Shell exportieren, erreicht es die Sitzung auch, zusammen mit `ANTHROPIC_CUSTOM_HEADERS`, wenn der Supervisor mit der gleichen Gateway-Umgebung läuft und die Sitzung in dem Verzeichnis läuft, von dem Sie versenden, oder Ihre eigene Sitzung ist, die mit `←` oder `/background` in den Hintergrund verschoben wurde. Das ist der normale Fall, wenn die erste Shell, die die Agenten-Ansicht öffnet oder eine Hintergrund-Sitzung versendet, die Gateway-Shell ist. Das Versenden in ein anderes Verzeichnis mit `@repo` oder `--cwd` trägt das Gateway der Shell nicht mit sich; die [Einstellungen](/de/settings) dieses Projekts liefern den Endpunkt. Siehe [der Supervisor-Prozess](#the-supervisor-process), um zu erfahren, wie Hintergrund-Sitzungen Provider-Einstellungen und Anmeldedaten beziehen.518Wenn Sie ein Gateway-`ANTHROPIC_BASE_URL` in der versendenden Shell exportieren, erreicht es die Sitzung auch, zusammen mit `ANTHROPIC_CUSTOM_HEADERS`, wenn der Supervisor mit der gleichen Gateway-Umgebung läuft und die Sitzung in dem Verzeichnis läuft, von dem Sie versenden, oder Ihre eigene Sitzung ist, die mit `←` oder `/background` in den Hintergrund verschoben wurde. Das ist der normale Fall, wenn die erste Shell, die die Agenten-Ansicht öffnet oder eine Hintergrund-Sitzung versendet, die Gateway-Shell ist. Das Versenden in ein anderes Verzeichnis mit `@repo` oder `--cwd` trägt das Gateway der Shell nicht mit sich; die [Einstellungen](/docs/de/settings) dieses Projekts liefern den Endpunkt. Siehe [der Supervisor-Prozess](#the-supervisor-process), um zu erfahren, wie Hintergrund-Sitzungen Provider-Einstellungen und Anmeldedaten beziehen.

519 519

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

521 521

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

523 523

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

525 525

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

527 527

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

529 529

531claude agents --permission-mode plan --model opus --effort high531claude agents --permission-mode plan --model opus --effort high

532```532```

533 533

534`--agent` setzt den [Subagenten](/de/sub-agents), der verwendet wird, wenn eine Versand-Eingabeaufforderung keinen benennt, entweder mit `@name` oder als erstes Wort. Es wird standardmäßig auf die [`agent`-Einstellung](/de/settings#available-settings) gesetzt, wenn eine gesetzt ist, ansonsten auf den integrierten Catch-All-`claude`-Agent. Das Benennen eines Subagenten in der Versand-Eingabe überschreibt beide.534`--agent` setzt den [Subagenten](/docs/de/sub-agents), der verwendet wird, wenn eine Versand-Eingabeaufforderung keinen benennt, entweder mit `@name` oder als erstes Wort. Es wird standardmäßig auf die [`agent`-Einstellung](/docs/de/settings#available-settings) gesetzt, wenn eine gesetzt ist, ansonsten auf den integrierten Catch-All-`claude`-Agent. Das Benennen eines Subagenten in der Versand-Eingabe überschreibt beide.

535 535

536`claude agents` akzeptiert auch `--dangerously-skip-permissions` als Kurzform für `--permission-mode bypassPermissions` und `--allow-dangerously-skip-permissions`, um `bypassPermissions` in jedem versendeten Sitzungs-`Shift+Tab`-Zyklus verfügbar zu machen, ohne in diesem Modus zu starten. Beide entsprechen den [Top-Level-CLI-Flags](/de/cli-reference).536`claude agents` akzeptiert auch `--dangerously-skip-permissions` als Kurzform für `--permission-mode bypassPermissions` und `--allow-dangerously-skip-permissions`, um `bypassPermissions` in jedem versendeten Sitzungs-`Shift+Tab`-Zyklus verfügbar zu machen, ohne in diesem Modus zu starten. Beide entsprechen den [Top-Level-CLI-Flags](/docs/de/cli-reference).

537 537

538Die aktiven Standardwerte werden in der Fußzeile unter der Versand-Eingabe angezeigt.538Die aktiven Standardwerte werden in der Fußzeile unter der Versand-Eingabe angezeigt.

539 539

540Ohne diese Flags verwendet die Sitzung den `defaultMode` aus den Einstellungen dieses Verzeichnisses oder den `permissionMode` aus dem Frontmatter des versendeten [Subagenten](/de/sub-agents#supported-frontmatter-fields), und das im Header der Agenten-Ansicht angezeigte Modell.540Ohne diese Flags verwendet die Sitzung den `defaultMode` aus den Einstellungen dieses Verzeichnisses oder den `permissionMode` aus dem Frontmatter des versendeten [Subagenten](/docs/de/sub-agents#supported-frontmatter-fields), und das im Header der Agenten-Ansicht angezeigte Modell.

541 541

542Die Verwendung von `bypassPermissions` mit `claude --bg --permission-mode` wird abgelehnt, bis Sie den Bypass-Haftungsausschluss akzeptiert haben, indem Sie `claude --dangerously-skip-permissions` einmal interaktiv ausführen, da dieser Modus einer Sitzung, die Sie nicht beobachten, erlaubt, ohne Genehmigung zu handeln. Das Übergeben von `--dangerously-skip-permissions` oder `--permission-mode bypassPermissions` an `claude agents` zeigt denselben Haftungsausschluss an, wenn Sie ihn noch nicht akzeptiert haben, und das Akzeptieren wendet `bypassPermissions` auf die Sitzungen an, die Sie aus der Ansicht starten. Das Übergeben von `--allow-dangerously-skip-permissions` zeigt denselben Haftungsausschluss auch an, und das Akzeptieren macht `bypassPermissions` im `Shift+Tab`-Zyklus dieser Sitzungen verfügbar, ohne sie darin zu starten.542Die Verwendung von `bypassPermissions` mit `claude --bg --permission-mode` wird abgelehnt, bis Sie den Bypass-Haftungsausschluss akzeptiert haben, indem Sie `claude --dangerously-skip-permissions` einmal interaktiv ausführen, da dieser Modus einer Sitzung, die Sie nicht beobachten, erlaubt, ohne Genehmigung zu handeln. Das Übergeben von `--dangerously-skip-permissions` oder `--permission-mode bypassPermissions` an `claude agents` zeigt denselben Haftungsausschluss an, wenn Sie ihn noch nicht akzeptiert haben, und das Akzeptieren wendet `bypassPermissions` auf die Sitzungen an, die Sie aus der Ansicht starten. Das Übergeben von `--allow-dangerously-skip-permissions` zeigt denselben Haftungsausschluss auch an, und das Akzeptieren macht `bypassPermissions` im `Shift+Tab`-Zyklus dieser Sitzungen verfügbar, ohne sie darin zu starten.

543 543

549 549

550| Flag | Effekt |550| Flag | Effekt |

551| :----------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------- |551| :----------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------- |

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

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

557 557

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

603 603

604Der `PATH` der Dispatch-Shell wird auf den Worker auf die gleiche Weise angewendet, daher finden Shell-Befehle, die die Sitzung ausführt, die gleichen Tools wie Ihr Terminal. Vor v2.1.203 behielt eine Hintergrund-Sitzung den `PATH` der Shell, die den Supervisor zuerst gestartet hat, daher konnten Tools, die Sie Ihrem `PATH` hinzugefügt haben, seitdem fehlen, am häufigsten unter Windows.604Der `PATH` der Dispatch-Shell wird auf den Worker auf die gleiche Weise angewendet, daher finden Shell-Befehle, die die Sitzung ausführt, die gleichen Tools wie Ihr Terminal. Vor v2.1.203 behielt eine Hintergrund-Sitzung den `PATH` der Shell, die den Supervisor zuerst gestartet hat, daher konnten Tools, die Sie Ihrem `PATH` hinzugefügt haben, seitdem fehlen, am häufigsten unter Windows.

605 605

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

607 607

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

609 609

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

611 611

617 617

618* Ein Hintergrund-Shell-Befehl, der inzwischen fertig ist, wird als abgeschlossen mit seiner Ausgabe gemeldet618* Ein Hintergrund-Shell-Befehl, der inzwischen fertig ist, wird als abgeschlossen mit seiner Ausgabe gemeldet

619* Ein dynamischer Workflow wird von dort fortgesetzt, wo er aufgehört hat619* Ein dynamischer Workflow wird von dort fortgesetzt, wo er aufgehört hat

620* Ein [Hintergrund-Subagent](/de/sub-agents#run-subagents-in-foreground-or-background) wird von seinem eigenen Transkript fortgesetzt620* Ein [Hintergrund-Subagent](/docs/de/sub-agents#run-subagents-in-foreground-or-background) wird von seinem eigenen Transkript fortgesetzt

621 621

622{/* min-version: 2.1.198 */}Ab v2.1.198 deckt die Übergabe alle drei ab. Vor v2.1.198 deckte sie nur Shell-Befehle und Workflows ab, daher wurde ein Hintergrund-Subagent mit dem Prozess gestoppt und beim nächsten Aufwachen als fehlgeschlagen gemeldet.622Ab v2.1.198 deckt die Übergabe alle drei ab. Vor v2.1.198 deckte sie nur Shell-Befehle und Workflows ab, daher wurde ein Hintergrund-Subagent mit dem Prozess gestoppt und beim nächsten Aufwachen als fehlgeschlagen gemeldet.

623 623

624Arbeit, deren Status nur innerhalb des Prozesses selbst lebt, stoppt damit, anstatt übergeben zu werden. Das sind Shell-Befehle, die ein Subagent gestartet hat, die der fortgesetzte Subagent erneut starten kann, und laufende [Monitore](/de/tools-reference#monitor-tool), deren Ereignisstrom nicht auf einen anderen Prozess verschoben werden kann.624Arbeit, deren Status nur innerhalb des Prozesses selbst lebt, stoppt damit, anstatt übergeben zu werden. Das sind Shell-Befehle, die ein Subagent gestartet hat, die der fortgesetzte Subagent erneut starten kann, und laufende [Monitore](/docs/de/tools-reference#monitor-tool), deren Ereignisstrom nicht auf einen anderen Prozess verschoben werden kann.

625 625

626Das Löschen der Sitzung stoppt alles, das sie übergeben hat. Um alle Hintergrund-Arbeiten der Sitzung mit dem Prozess zu stoppen, anstatt sie zu übergeben, setzen Sie die Umgebungsvariable [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/de/env-vars#variables) auf `1`.626Das Löschen der Sitzung stoppt alles, das sie übergeben hat. Um alle Hintergrund-Arbeiten der Sitzung mit dem Prozess zu stoppen, anstatt sie zu übergeben, setzen Sie die Umgebungsvariable [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/de/env-vars#variables) auf `1`.

627 627

628Ein neu gestarteter Prozess findet die Konversation einer Sitzung, die [während einer Aufgabe in einen Worktree verschoben wurde](#how-file-edits-are-isolated): Wenn sich das Transkript nicht dort befindet, wo die Sitzung gestartet wurde, sucht Claude Code auch unter den registrierten Worktrees des Repositorys. Vor v2.1.207 konnte das erneute Öffnen dieser Sitzung aus der Agenten-Ansicht, nachdem ihr Prozess gestoppt worden war, eine leere Konversation mit nur ihrem ursprünglichen Prompt anzeigen, wobei das Transkript noch intakt auf der Festplatte war; das erneute Öffnen der Sitzung auf v2.1.207 oder später stellt sie wieder her.628Ein neu gestarteter Prozess findet die Konversation einer Sitzung, die [während einer Aufgabe in einen Worktree verschoben wurde](#how-file-edits-are-isolated): Wenn sich das Transkript nicht dort befindet, wo die Sitzung gestartet wurde, sucht Claude Code auch unter den registrierten Worktrees des Repositorys. Vor v2.1.207 konnte das erneute Öffnen dieser Sitzung aus der Agenten-Ansicht, nachdem ihr Prozess gestoppt worden war, eine leere Konversation mit nur ihrem ursprünglichen Prompt anzeigen, wobei das Transkript noch intakt auf der Festplatte war; das erneute Öffnen der Sitzung auf v2.1.207 oder später stellt sie wieder her.

629 629

633 633

634Wenn der Host wenig Speicher hat, stoppt der Supervisor zuerst untätige nicht angeheftete Sitzungen und stoppt untätige angeheftete Sitzungen nur, wenn dies nichts freigegeben hat.634Wenn der Host wenig Speicher hat, stoppt der Supervisor zuerst untätige nicht angeheftete Sitzungen und stoppt untätige angeheftete Sitzungen nur, wenn dies nichts freigegeben hat.

635 635

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

637 637

638Sobald der neue Supervisor die Kontrolle übernimmt, startet er auch die verbleibenden untätigen Sitzungen auf die neue Version neu, einige auf einmal im Hintergrund, nach einer kurzen Verzögerung, die es Terminals ermöglicht, die über den Neustart hinweg angehängt sind, sich zuerst erneut zu verbinden. Eine Sitzung, die funktioniert, auf Ihre Eingabe wartet oder ein Terminal angehängt hat, wird nicht unterbrochen; sie wird auf die neue Version verschoben, wenn ihr Prozess das nächste Mal neu gestartet wird. Vor v2.1.206 verschob der Supervisor nur wenige untätige Sitzungen pro Minute auf eine neue Version, daher konnten Sitzungen die alte Version eine Weile nach einem Update weiter ausführen.638Sobald der neue Supervisor die Kontrolle übernimmt, startet er auch die verbleibenden untätigen Sitzungen auf die neue Version neu, einige auf einmal im Hintergrund, nach einer kurzen Verzögerung, die es Terminals ermöglicht, die über den Neustart hinweg angehängt sind, sich zuerst erneut zu verbinden. Eine Sitzung, die funktioniert, auf Ihre Eingabe wartet oder ein Terminal angehängt hat, wird nicht unterbrochen; sie wird auf die neue Version verschoben, wenn ihr Prozess das nächste Mal neu gestartet wird. Vor v2.1.206 verschob der Supervisor nur wenige untätige Sitzungen pro Minute auf eine neue Version, daher konnten Sitzungen die alte Version eine Weile nach einem Update weiter ausführen.

639 639

645 Wo der Status gespeichert ist645 Wo der Status gespeichert ist

646</h3>646</h3>

647 647

648Der Sitzungsstatus wird unter Ihrem Claude Code-Konfigurationsverzeichnis gespeichert. Wenn Sie [`CLAUDE_CONFIG_DIR`](/de/env-vars) setzen, verwendet der Supervisor stattdessen dieses Verzeichnis und läuft als separate Instanz mit ihren eigenen Sitzungen.648Der Sitzungsstatus wird unter Ihrem Claude Code-Konfigurationsverzeichnis gespeichert. Wenn Sie [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) setzen, verwendet der Supervisor stattdessen dieses Verzeichnis und läuft als separate Instanz mit ihren eigenen Sitzungen.

649 649

650| Pfad | Inhalt |650| Pfad | Inhalt |

651| :------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- |651| :------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- |

660 660

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

662 662

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

664 664

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

666 666

668 Agenten-Ansicht ausschalten668 Agenten-Ansicht ausschalten

669</h3>669</h3>

670 670

671Um Hintergrund-Agenten und die Agenten-Ansicht vollständig auszuschalten, setzen Sie die Einstellung `disableAgentView` [setting](/de/settings) auf `true` oder setzen Sie die Umgebungsvariable `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Administratoren können dies durch [verwaltete Einstellungen](/de/permissions#managed-settings) erzwingen.671Um Hintergrund-Agenten und die Agenten-Ansicht vollständig auszuschalten, setzen Sie die Einstellung `disableAgentView` [setting](/docs/de/settings) auf `true` oder setzen Sie die Umgebungsvariable `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Administratoren können dies durch [verwaltete Einstellungen](/docs/de/permissions#managed-settings) erzwingen.

672 672

673<h2 id="troubleshooting">673<h2 id="troubleshooting">

674 Fehlerbehebung674 Fehlerbehebung

692 Backgrounding zeigt einen `Background this session?`-Dialog692 Backgrounding zeigt einen `Background this session?`-Dialog

693</h3>693</h3>

694 694

695Wenn das Drücken von `←` zum Hintergrund der aktuellen Sitzung einen `Background this session?`-Dialog zeigt, hat die Sitzung laufende Arbeit, die nicht zur Hintergrund-Sitzung übertragen werden kann, wie z. B. ein laufender [Monitor](/de/tools-reference#monitor-tool), und Claude Code wird sie nicht stillschweigend stoppen. Das Dialog benennt die Arbeit, die gestoppt wird, und zählt separat die Aufgaben, die übertragen werden. Führen Sie `/tasks` aus, um zu sehen, was läuft, dann bestätigen Sie, um trotzdem in den Hintergrund zu gehen, oder wählen Sie `Stay`, um die Arbeit zuerst fertig zu stellen. Siehe [Aus einer Sitzung heraus](#from-inside-a-session), um zu sehen, welche Aufgabentypen übertragen werden und welche gestoppt werden.695Wenn das Drücken von `←` zum Hintergrund der aktuellen Sitzung einen `Background this session?`-Dialog zeigt, hat die Sitzung laufende Arbeit, die nicht zur Hintergrund-Sitzung übertragen werden kann, wie z. B. ein laufender [Monitor](/docs/de/tools-reference#monitor-tool), und Claude Code wird sie nicht stillschweigend stoppen. Das Dialog benennt die Arbeit, die gestoppt wird, und zählt separat die Aufgaben, die übertragen werden. Führen Sie `/tasks` aus, um zu sehen, was läuft, dann bestätigen Sie, um trotzdem in den Hintergrund zu gehen, oder wählen Sie `Stay`, um die Arbeit zuerst fertig zu stellen. Siehe [Aus einer Sitzung heraus](#from-inside-a-session), um zu sehen, welche Aufgabentypen übertragen werden und welche gestoppt werden.

696 696

697<h3 id="prompt-rejected-as-too-short">697<h3 id="prompt-rejected-as-too-short">

698 Eingabeaufforderung als zu kurz abgelehnt698 Eingabeaufforderung als zu kurz abgelehnt

754 754

755Der nächste `claude agents` oder `claude --bg` startet einen neuen Supervisor, der Ihre gespeicherten Anmeldedaten liest. Wenn Sie sich mit einer Umgebungsvariable wie `ANTHROPIC_API_KEY` authentifizieren, anstatt `/login` zu verwenden, führen Sie diesen nächsten Befehl aus einer Shell aus, in der die Variable gesetzt ist.755Der nächste `claude agents` oder `claude --bg` startet einen neuen Supervisor, der Ihre gespeicherten Anmeldedaten liest. Wenn Sie sich mit einer Umgebungsvariable wie `ANTHROPIC_API_KEY` authentifizieren, anstatt `/login` zu verwenden, führen Sie diesen nächsten Befehl aus einer Shell aus, in der die Variable gesetzt ist.

756 756

757Siehe die [Fehlerreferenz](/de/errors#could-not-resolve-authentication-method) für die vollständige Liste der Ursachen und Behebungen.757Siehe die [Fehlerreferenz](/docs/de/errors#could-not-resolve-authentication-method) für die vollständige Liste der Ursachen und Behebungen.

758 758

759<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">759<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">

760 Hintergrund-Sitzungen können Desktop, Dokumente oder Downloads auf macOS nicht lesen760 Hintergrund-Sitzungen können Desktop, Dokumente oder Downloads auf macOS nicht lesen

768 Hintergrund-Sitzungen können auf macOS keine lokalen Netzwerk-Hosts erreichen768 Hintergrund-Sitzungen können auf macOS keine lokalen Netzwerk-Hosts erreichen

769</h3>769</h3>

770 770

771Unter macOS 15 und später blockiert das System einen Prozess daran, Geräte in Ihrem lokalen Netzwerk zu erreichen, bis Sie die Berechtigung für lokales Netzwerk gewähren. Vor v2.1.198 forderte der Hintergrund-Sitzungs-Host diese Berechtigung nie an, daher schlugen Befehle, die auf eine LAN-Adresse abzielten, mit `connect: no route to host` fehl, obwohl derselbe Befehl in einem Vordergrund-Terminal funktionierte. {/* min-version: 2.1.198 */}Ab v2.1.198 löst der erste Befehl in einer Hintergrund-Sitzung, der sich mit einer lokalen Netzwerk-Adresse verbindet, die macOS-Berechtigung für lokales Netzwerk für Claude Code aus. Gewähren Sie sie einmal und diese Befehle erreichen LAN-Hosts auf die gleiche Weise wie in einem Vordergrund-Terminal.771Unter macOS 15 und später blockiert das System einen Prozess daran, Geräte in Ihrem lokalen Netzwerk zu erreichen, bis Sie die Berechtigung für lokales Netzwerk gewähren. Vor v2.1.198 forderte der Hintergrund-Sitzungs-Host diese Berechtigung nie an, daher schlugen Befehle, die auf eine LAN-Adresse abzielten, mit `connect: no route to host` fehl, obwohl derselbe Befehl in einem Vordergrund-Terminal funktionierte. Ab v2.1.198 löst der erste Befehl in einer Hintergrund-Sitzung, der sich mit einer lokalen Netzwerk-Adresse verbindet, die macOS-Berechtigung für lokales Netzwerk für Claude Code aus. Gewähren Sie sie einmal und diese Befehle erreichen LAN-Hosts auf die gleiche Weise wie in einem Vordergrund-Terminal.

772 772

773<h3 id="a-session-is-slow-to-respond-after-attaching">773<h3 id="a-session-is-slow-to-respond-after-attaching">

774 Eine Sitzung reagiert langsam nach dem Anhängen774 Eine Sitzung reagiert langsam nach dem Anhängen

782 `.claude/worktrees/` füllt sich auf782 `.claude/worktrees/` füllt sich auf

783</h3>783</h3>

784 784

785Das Löschen einer Sitzung in der Agenten-Ansicht entfernt den Worktree, den Claude dafür erstellt hat, und ein Worktree, der nicht sicher entfernt werden kann, [behält seine Sitzungszeile](#organize-the-list), damit er nicht verwaist wird. `claude rm` behält einen Worktree mit nicht committeten Änderungen und gibt seinen Pfad aus. Listen Sie verbleibende Einträge mit `git worktree list` im Projektverzeichnis auf und entfernen Sie jeden mit `git worktree remove <path>`. Siehe [Worktrees bereinigen](/de/worktrees#clean-up-worktrees).785Das Löschen einer Sitzung in der Agenten-Ansicht entfernt den Worktree, den Claude dafür erstellt hat, und ein Worktree, der nicht sicher entfernt werden kann, [behält seine Sitzungszeile](#organize-the-list), damit er nicht verwaist wird. `claude rm` behält einen Worktree mit nicht committeten Änderungen und gibt seinen Pfad aus. Listen Sie verbleibende Einträge mit `git worktree list` im Projektverzeichnis auf und entfernen Sie jeden mit `git worktree remove <path>`. Siehe [Worktrees bereinigen](/docs/de/worktrees#clean-up-worktrees).

786 786

787<h2 id="limitations">787<h2 id="limitations">

788 Einschränkungen788 Einschränkungen

800 800

801Weitere Möglichkeiten zum parallelen Ausführen von Claude finden Sie unter:801Weitere Möglichkeiten zum parallelen Ausführen von Claude finden Sie unter:

802 802

803* [Agenten parallel ausführen](/de/agents): Vergleichen Sie die Agenten-Ansicht mit Subagenten, Agenten-Teams und Worktrees803* [Agenten parallel ausführen](/docs/de/agents): Vergleichen Sie die Agenten-Ansicht mit Subagenten, Agenten-Teams und Worktrees

804* [Agenten-Teams](/de/agent-teams): Koordinieren Sie mehrere Sitzungen, die sich gegenseitig Nachrichten senden804* [Agenten-Teams](/docs/de/agent-teams): Koordinieren Sie mehrere Sitzungen, die sich gegenseitig Nachrichten senden

805* [Claude Code im Web](/de/claude-code-on-the-web): Führen Sie Sitzungen in einer verwalteten Cloud-Umgebung aus, anstatt lokal805* [Claude Code im Web](/docs/de/claude-code-on-the-web): Führen Sie Sitzungen in einer verwalteten Cloud-Umgebung aus, anstatt lokal

806 806

807<h2 id="version-history">807<h2 id="version-history">

808 Versionsverlauf808 Versionsverlauf

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

812 812

814| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |814| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

815| v2.1.208 | {/* min-version: 2.1.208 */}Das Anhängen an eine Sitzung, deren Prozess gestoppt wurde, zeigt den letzten Bildschirmvoll ihres Transkripts an, während der Prozess startet, anstatt nur eine `Session is starting`-Notiz. Eine Antwort, die nicht zugestellt werden kann, weil der Hintergrunddienst nicht erreichbar ist oder das Senden fehlschlägt, wird gespeichert und als nächste Eingabeaufforderung der Sitzung gesendet, wenn ihr Prozess wieder startet; vor dieser Version ging eine Antwort, die verloren ging, während der Hintergrunddienst nicht erreichbar war, verloren. Ein Prozess, dessen eigene Binärdatei durch ein Update ersetzt wurde, kann den Supervisor immer noch starten, vom installierten `claude`-Launcher oder der neuesten Version auf der Festplatte, anstatt fehlzuschlagen, bis Claude Code neu gestartet wurde. Ein Supervisor, der eine ältere Version ausführt, startet eine untätige Sitzung, die von einer neueren Version gestartet wurde, niemals auf seiner eigenen älteren Binärdatei neu. Das Löschen einer Sitzung entfernt ihren Worktree auch nachdem die Sitzung den Worktree auf einen anderen Branch verschoben hat, und behält den Worktree zusammen mit der Sitzungszeile, wenn der Worktree Commits hat, die nirgendwo gepusht werden, oder eine andere Sitzung ihn beansprucht, anstatt die Commits zu zerstören oder den Worktree verwaist zu lassen. `/install-github-app` und die `/mcp`-Einstellungsliste und ihre Authentifizierungsaktionen werden in einer Hintergrund-Sitzung mit einer Nachricht abgelehnt, die die Alternative benennt; in v2.1.208 nur wurde die `/model`-Auswahl auf die gleiche Weise abgelehnt und ein eingegebenes `/model <name>` schaltete nur diese Sitzung um, anstatt auch Ihr Standard-Modell zu speichern. |815| v2.1.208 | Das Anhängen an eine Sitzung, deren Prozess gestoppt wurde, zeigt den letzten Bildschirmvoll ihres Transkripts an, während der Prozess startet, anstatt nur eine `Session is starting`-Notiz. Eine Antwort, die nicht zugestellt werden kann, weil der Hintergrunddienst nicht erreichbar ist oder das Senden fehlschlägt, wird gespeichert und als nächste Eingabeaufforderung der Sitzung gesendet, wenn ihr Prozess wieder startet; vor dieser Version ging eine Antwort, die verloren ging, während der Hintergrunddienst nicht erreichbar war, verloren. Ein Prozess, dessen eigene Binärdatei durch ein Update ersetzt wurde, kann den Supervisor immer noch starten, vom installierten `claude`-Launcher oder der neuesten Version auf der Festplatte, anstatt fehlzuschlagen, bis Claude Code neu gestartet wurde. Ein Supervisor, der eine ältere Version ausführt, startet eine untätige Sitzung, die von einer neueren Version gestartet wurde, niemals auf seiner eigenen älteren Binärdatei neu. Das Löschen einer Sitzung entfernt ihren Worktree auch nachdem die Sitzung den Worktree auf einen anderen Branch verschoben hat, und behält den Worktree zusammen mit der Sitzungszeile, wenn der Worktree Commits hat, die nirgendwo gepusht werden, oder eine andere Sitzung ihn beansprucht, anstatt die Commits zu zerstören oder den Worktree verwaist zu lassen. `/install-github-app` und die `/mcp`-Einstellungsliste und ihre Authentifizierungsaktionen werden in einer Hintergrund-Sitzung mit einer Nachricht abgelehnt, die die Alternative benennt; in v2.1.208 nur wurde die `/model`-Auswahl auf die gleiche Weise abgelehnt und ein eingegebenes `/model <name>` schaltete nur diese Sitzung um, anstatt auch Ihr Standard-Modell zu speichern. |

816| v2.1.207 | {/* min-version: 2.1.207 */}Das Vorschau-Panel öffnet sich mit dem Satz, den die Zeile abschneidet, wie z. B. die genaue Frage für eine Sitzung, die auf Sie wartet, und zeigt, wie lange eine blockierte Sitzung wartet, als eine einzelne `waiting 3m`-Zeile, anstatt denselben Zeitstempel dem Statussatz und der Frage voranzustellen. Das Einfügen desselben Textes erneut in die Versand-Eingabe erweitert den zusammengeklappten `[Pasted text #N]`-Platzhalter, anstatt einen zweiten hinzuzufügen. Eine Hintergrund-Sitzung, die durch Akzeptieren eines Plans benannt wird, zeigt diesen Namen auf ihrer Zeile an. Eine Hintergrund-Sitzung, die in einen Worktree verschoben wurde, behält ihre Unterhaltung, wenn ihr Prozess aus der Agenten-Ansicht neu gestartet wird. |816| v2.1.207 | Das Vorschau-Panel öffnet sich mit dem Satz, den die Zeile abschneidet, wie z. B. die genaue Frage für eine Sitzung, die auf Sie wartet, und zeigt, wie lange eine blockierte Sitzung wartet, als eine einzelne `waiting 3m`-Zeile, anstatt denselben Zeitstempel dem Statussatz und der Frage voranzustellen. Das Einfügen desselben Textes erneut in die Versand-Eingabe erweitert den zusammengeklappten `[Pasted text #N]`-Platzhalter, anstatt einen zweiten hinzuzufügen. Eine Hintergrund-Sitzung, die durch Akzeptieren eines Plans benannt wird, zeigt diesen Namen auf ihrer Zeile an. Eine Hintergrund-Sitzung, die in einen Worktree verschoben wurde, behält ihre Unterhaltung, wenn ihr Prozess aus der Agenten-Ansicht neu gestartet wird. |

817| v2.1.206 | {/* min-version: 2.1.206 */}Zeilenzusammenfassungen füllen die verbleibende Breite der Zeile und schneiden nur am rechten Rand des Terminals ab, anstatt bei 64 Spalten. Nachdem der Supervisor in eine neue Claude Code-Version neu startet, startet er die verbleibenden untätigen Hintergrund-Sitzungen im Hintergrund auf diese Version neu, anstatt einige pro Minute. Das Löschen einer Sitzung mit `Ctrl+X` oder `claude rm` löscht sie auch aus der Sitzungsliste des Supervisors, sodass die Zeile nach einem Supervisor-Neustart nicht mehr erneut angezeigt wird. |817| v2.1.206 | Zeilenzusammenfassungen füllen die verbleibende Breite der Zeile und schneiden nur am rechten Rand des Terminals ab, anstatt bei 64 Spalten. Nachdem der Supervisor in eine neue Claude Code-Version neu startet, startet er die verbleibenden untätigen Hintergrund-Sitzungen im Hintergrund auf diese Version neu, anstatt einige pro Minute. Das Löschen einer Sitzung mit `Ctrl+X` oder `claude rm` löscht sie auch aus der Sitzungsliste des Supervisors, sodass die Zeile nach einem Supervisor-Neustart nicht mehr erneut angezeigt wird. |

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

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

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

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

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

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

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

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

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

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

828| v2.1.161 | {/* min-version: 2.1.161 */}Zeilenzusammenfassungen zeigen eine `done/total`-Anzahl für parallele Arbeitselemente; das Vorschau-Panel benennt das am längsten laufende parallele Arbeitselement. |828| v2.1.161 | Zeilenzusammenfassungen zeigen eine `done/total`-Anzahl für parallele Arbeitselemente; das Vorschau-Panel benennt das am längsten laufende parallele Arbeitselement. |

829| v2.1.157 | {/* min-version: 2.1.157 */}`claude agents` akzeptiert `--agent`; versendete Sitzungen beachten die `agent`-Einstellung. |829| v2.1.157 | `claude agents` akzeptiert `--agent`; versendete Sitzungen beachten die `agent`-Einstellung. |

830| v2.1.145 | {/* min-version: 2.1.145 */}Sprachdiktat wird in der Vorschau-Panel-Antwort-Eingabe und der Versand-Eingabe unterstützt. |830| v2.1.145 | Sprachdiktat wird in der Vorschau-Panel-Antwort-Eingabe und der Versand-Eingabe unterstützt. |

831| v2.1.143 | {/* min-version: 2.1.143 */}`worktree.bgIsolation`-Einstellung hinzugefügt; `claude agents` akzeptiert `--allow-dangerously-skip-permissions`. |831| v2.1.143 | `worktree.bgIsolation`-Einstellung hinzugefügt; `claude agents` akzeptiert `--allow-dangerously-skip-permissions`. |

832| v2.1.142 | {/* min-version: 2.1.142 */}`claude agents` akzeptiert `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config` und `--strict-mcp-config`. |832| v2.1.142 | `claude agents` akzeptiert `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config` und `--strict-mcp-config`. |

833| v2.1.141 | {/* min-version: 2.1.141 */}`claude agents` akzeptiert `--cwd`, um die Liste auf ein Projekt zu beschränken. |833| v2.1.141 | `claude agents` akzeptiert `--cwd`, um die Liste auf ein Projekt zu beschränken. |

834| v2.1.139 | {/* min-version: 2.1.139 */}Agenten-Ansicht als Forschungsvorschau eingeführt. |834| v2.1.139 | Agenten-Ansicht als Forschungsvorschau eingeführt. |

agents.md +25 −25

Details

6 6

7> Vergleichen Sie die Möglichkeiten, wie Claude Code mehrere Aufgaben gleichzeitig bewältigen kann: Subagenten, Agent-Ansicht, Agent-Teams und dynamische Workflows.7> Vergleichen Sie die Möglichkeiten, wie Claude Code mehrere Aufgaben gleichzeitig bewältigen kann: Subagenten, Agent-Ansicht, Agent-Teams und dynamische Workflows.

8 8

9[Subagenten](/de/sub-agents), [Agent-Ansicht](/de/agent-view), [Agent-Teams](/de/agent-teams) und [dynamische Workflows](/de/workflows) parallelisieren die Arbeit jeweils auf unterschiedliche Weise. Die richtige Wahl hängt davon ab, ob Sie in jeder Konversation selbst bleiben möchten, Aufgaben delegieren und später überprüfen möchten, oder ob Claude eine Gruppe von Mitarbeitern für Sie koordinieren soll.9[Subagenten](/docs/de/sub-agents), [Agent-Ansicht](/docs/de/agent-view), [Agent-Teams](/docs/de/agent-teams) und [dynamische Workflows](/docs/de/workflows) parallelisieren die Arbeit jeweils auf unterschiedliche Weise. Die richtige Wahl hängt davon ab, ob Sie in jeder Konversation selbst bleiben möchten, Aufgaben delegieren und später überprüfen möchten, oder ob Claude eine Gruppe von Mitarbeitern für Sie koordinieren soll.

10 10

12| :------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |12| :------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

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

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

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

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

17 17

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

19 19

20Zwei weitere Tools unterstützen diese Arbeit, ohne selbst eine Möglichkeit zu sein, Agenten auszuführen:20Zwei weitere Tools unterstützen diese Arbeit, ohne selbst eine Möglichkeit zu sein, Agenten auszuführen:

21 21

22* [Worktrees](/de/worktrees) geben jeder Sitzung einen separaten Git-Checkout, sodass parallele Sitzungen niemals dieselben Dateien bearbeiten. Verwenden Sie sie für Sitzungen, die Sie selbst ausführen. Die Agent-Ansicht verschiebt jede versendete Sitzung automatisch in ihren eigenen Worktree, und Subagenten, die Sie spawnen, können jeweils einen erhalten.22* [Worktrees](/docs/de/worktrees) geben jeder Sitzung einen separaten Git-Checkout, sodass parallele Sitzungen niemals dieselben Dateien bearbeiten. Verwenden Sie sie für Sitzungen, die Sie selbst ausführen. Die Agent-Ansicht verschiebt jede versendete Sitzung automatisch in ihren eigenen Worktree, und Subagenten, die Sie spawnen, können jeweils einen erhalten.

23* [`/batch`](/de/commands) ist ein [Skill](/de/skills), der Claude eine große Änderung in 5 bis 30 Worktree-isolierte Subagenten aufteilt, die jeweils einen Pull Request öffnen. Es ist eine gepackte Verwendung von Subagenten und Worktrees, keine separate Koordinationsstil.23* [`/batch`](/docs/de/commands) ist ein [Skill](/docs/de/skills), der Claude eine große Änderung in 5 bis 30 Worktree-isolierte Subagenten aufteilt, die jeweils einen Pull Request öffnen. Es ist eine gepackte Verwendung von Subagenten und Worktrees, keine separate Koordinationsstil.

24 24

25Einige andere Funktionen führen Claude aus, ohne dass Sie jeden Schritt steuern, aber sie lösen ein anderes Problem als die Aufteilung der Arbeit auf Agenten:25Einige andere Funktionen führen Claude aus, ohne dass Sie jeden Schritt steuern, aber sie lösen ein anderes Problem als die Aufteilung der Arbeit auf Agenten:

26 26

~~27* Ein [Bash-Befehl im Hintergrund](/de/interactive-mode#background-bash-commands) führt einen Shell-Befehl aus, ohne die Konversation zu blockieren. Es spawnt keinen Agenten.~~27* Ein [Bash-Befehl im Hintergrund](/docs/de/interactive-mode#background-bash-commands) führt einen Shell-Befehl aus, ohne die Konversation zu blockieren. Es spawnt keinen Agenten.

28* Ein [abgezweigter Subagent](/de/sub-agents#fork-the-current-conversation) ist ein Subagent, der Ihren vollständigen Konversationskontext erbt, anstatt neu zu beginnen. Es ist eine Möglichkeit, einen Subagenten zu spawnen, keine separate Oberfläche.28* Ein [abgezweigter Subagent](/docs/de/sub-agents#fork-the-current-conversation) ist ein Subagent, der Ihren vollständigen Konversationskontext erbt, anstatt neu zu beginnen. Es ist eine Möglichkeit, einen Subagenten zu spawnen, keine separate Oberfläche.

~~29* Eine [Routine](/de/routines) führt eine Sitzung nach einem Zeitplan in Anthropics Cloud aus, nicht parallel auf Ihrem Computer.~~29* Eine [Routine](/docs/de/routines) führt eine Sitzung nach einem Zeitplan in Anthropics Cloud aus, nicht parallel auf Ihrem Computer.

30 30

31<Note>31<Note>

~~32 Das gleichzeitige Ausführen mehrerer Sitzungen oder Subagenten vervielfacht die Token-Nutzung. Siehe [Kosten](/de/costs) für Details zur Nutzung und Rate-Limit-Details.~~32 Das gleichzeitige Ausführen mehrerer Sitzungen oder Subagenten vervielfacht die Token-Nutzung. Siehe [Kosten](/docs/de/costs) für Details zur Nutzung und Rate-Limit-Details.

33</Note>33</Note>

34 34

35<h2 id="choose-an-approach">35<h2 id="choose-an-approach">

39Der richtige Ansatz hängt davon ab, wer die Arbeit koordiniert, ob die Mitarbeiter kommunizieren müssen und ob sie dieselben Dateien bearbeiten:39Der richtige Ansatz hängt davon ab, wer die Arbeit koordiniert, ob die Mitarbeiter kommunizieren müssen und ob sie dieselben Dateien bearbeiten:

40 40

41* **Wer koordiniert die Arbeit?**41* **Wer koordiniert die Arbeit?**

~~42 * Claude delegiert und sammelt Ergebnisse in einer Konversation: [Subagenten](/de/sub-agents)~~42 * Claude delegiert und sammelt Ergebnisse in einer Konversation: [Subagenten](/docs/de/sub-agents)

~~43 * Sie übergeben unabhängige Aufgaben und überprüfen später: [Agent-Ansicht](/de/agent-view)~~43 * Sie übergeben unabhängige Aufgaben und überprüfen später: [Agent-Ansicht](/docs/de/agent-view)

~~44 * Claude plant, weist zu und beaufsichtigt eine Gruppe von Mitarbeitern: [Agent-Teams](/de/agent-teams), experimentell und standardmäßig deaktiviert~~44 * Claude plant, weist zu und beaufsichtigt eine Gruppe von Mitarbeitern: [Agent-Teams](/docs/de/agent-teams), experimentell und standardmäßig deaktiviert

45 * Ein Skript hält den Plan statt Claudes schrittweiser Beurteilung: [dynamische Workflows](/de/workflows). Siehe [wie Workflows mit Subagenten und Skills verglichen werden](/de/workflows#when-to-use-a-workflow)45 * Ein Skript hält den Plan statt Claudes schrittweiser Beurteilung: [dynamische Workflows](/docs/de/workflows). Siehe [wie Workflows mit Subagenten und Skills verglichen werden](/docs/de/workflows#when-to-use-a-workflow)

46* **Müssen die Mitarbeiter miteinander kommunizieren?** Subagenten berichten Ergebnisse an die Konversation, die sie spawned hat, und Agent-Ansicht-Sitzungen berichten nur an Sie. Teammates in einem Agent-Team teilen eine Aufgabenliste und senden sich gegenseitig direkt Nachrichten.46* **Müssen die Mitarbeiter miteinander kommunizieren?** Subagenten berichten Ergebnisse an die Konversation, die sie spawned hat, und Agent-Ansicht-Sitzungen berichten nur an Sie. Teammates in einem Agent-Team teilen eine Aufgabenliste und senden sich gegenseitig direkt Nachrichten.

47* **Betreffen die Aufgaben dieselben Dateien?** Isolieren Sie die Arbeit mit [Worktrees](/de/worktrees). Subagenten und Sitzungen, die Sie selbst ausführen, können jeweils einen separaten Worktree verwenden. Agent-Teams isolieren Teammates nicht in Worktrees, daher [partitionieren Sie die Arbeit](/de/agent-teams#avoid-file-conflicts), damit jeder Teammate einen anderen Satz von Dateien besitzt.47* **Betreffen die Aufgaben dieselben Dateien?** Isolieren Sie die Arbeit mit [Worktrees](/docs/de/worktrees). Subagenten und Sitzungen, die Sie selbst ausführen, können jeweils einen separaten Worktree verwenden. Agent-Teams isolieren Teammates nicht in Worktrees, daher [partitionieren Sie die Arbeit](/docs/de/agent-teams#avoid-file-conflicts), damit jeder Teammate einen anderen Satz von Dateien besitzt.

48 48

49<h2 id="check-on-running-work">49<h2 id="check-on-running-work">

50 Überprüfen Sie laufende Arbeiten50 Überprüfen Sie laufende Arbeiten

52 52

53Der Befehl zum Überprüfen laufender Arbeiten hängt davon ab, welchen Ansatz Sie verwendet haben:53Der Befehl zum Überprüfen laufender Arbeiten hängt davon ab, welchen Ansatz Sie verwendet haben:

54 54

~~55* Für Hintergrund-Sitzungen öffnet `claude agents` die [Agent-Ansicht](/de/agent-view): ein Bildschirm, der jede Sitzung, ihren Status und die Sitzungen anzeigt, die Ihre Eingabe benötigen.~~55* Für Hintergrund-Sitzungen öffnet `claude agents` die [Agent-Ansicht](/docs/de/agent-view): ein Bildschirm, der jede Sitzung, ihren Status und die Sitzungen anzeigt, die Ihre Eingabe benötigen.

56* Für Subagenten in der aktuellen Sitzung erscheinen benannte Hintergrund-Subagenten in der @-Mention-Typeahead mit ihrem Status. {/* min-version: 2.1.198 */}Ab v2.1.198 öffnet `/agents` kein Panel mehr; es gibt einen Hinweis aus, der auf die Speicherorte der Subagenten-Dateien verweist. Um [benutzerdefinierte Subagenten zu erstellen und zu bearbeiten](/de/sub-agents#configure-subagents), fragen Sie Claude oder bearbeiten Sie die Dateien direkt. Trotz des ähnlichen Namens ist `/agents` getrennt von `claude agents`.56* Für Subagenten in der aktuellen Sitzung erscheinen benannte Hintergrund-Subagenten in der @-Mention-Typeahead mit ihrem Status. Ab v2.1.198 öffnet `/agents` kein Panel mehr; es gibt einen Hinweis aus, der auf die Speicherorte der Subagenten-Dateien verweist. Um [benutzerdefinierte Subagenten zu erstellen und zu bearbeiten](/docs/de/sub-agents#configure-subagents), fragen Sie Claude oder bearbeiten Sie die Dateien direkt. Trotz des ähnlichen Namens ist `/agents` getrennt von `claude agents`.

57* Für alles, das im Hintergrund der aktuellen Sitzung ausgeführt wird, listet `/tasks` jedes Element auf und ermöglicht es Ihnen, es zu überprüfen, sich daran anzuhängen oder es zu stoppen. Die Liste enthält auch Subagenten, die fertig sind.57* Für alles, das im Hintergrund der aktuellen Sitzung ausgeführt wird, listet `/tasks` jedes Element auf und ermöglicht es Ihnen, es zu überprüfen, sich daran anzuhängen oder es zu stoppen. Die Liste enthält auch Subagenten, die fertig sind.

58* Für dynamische Workflows listet `/workflows` laufende und abgeschlossene Ausführungen, die Phase, in der sich jede befindet, und wie viele Agenten fertig sind, auf.58* Für dynamische Workflows listet `/workflows` laufende und abgeschlossene Ausführungen, die Phase, in der sich jede befindet, und wie viele Agenten fertig sind, auf.

59 59

~~60Für eine Desktop-Ansicht aller Ihrer Sitzungen siehe [parallele Sitzungen in der Desktop-App](/de/desktop#work-in-parallel-with-sessions).~~60Für eine Desktop-Ansicht aller Ihrer Sitzungen siehe [parallele Sitzungen in der Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions).

61 61

62<h2 id="learn-more">62<h2 id="learn-more">

63 Weitere Informationen63 Weitere Informationen

65 65

66Jeder Leitfaden unten behandelt Setup und Konfiguration für einen Ansatz:66Jeder Leitfaden unten behandelt Setup und Konfiguration für einen Ansatz:

67 67

~~68* [Erstellen Sie benutzerdefinierte Subagenten](/de/sub-agents): definieren Sie wiederverwendbare Spezialisten und kontrollieren Sie, welche Tools sie verwenden können.~~68* [Erstellen Sie benutzerdefinierte Subagenten](/docs/de/sub-agents): definieren Sie wiederverwendbare Spezialisten und kontrollieren Sie, welche Tools sie verwenden können.

~~69* [Verwalten Sie Agenten mit Agent-Ansicht](/de/agent-view): versenden Sie Sitzungen, beobachten Sie ihren Status und hängen Sie sich an, wenn eine Sitzung Sie benötigt.~~69* [Verwalten Sie Agenten mit Agent-Ansicht](/docs/de/agent-view): versenden Sie Sitzungen, beobachten Sie ihren Status und hängen Sie sich an, wenn eine Sitzung Sie benötigt.

~~70* [Orchestrieren Sie Agent-Teams](/de/agent-teams): richten Sie einen Lead und Teammates ein, weisen Sie Aufgaben zu und überprüfen Sie ihre Arbeit.~~70* [Orchestrieren Sie Agent-Teams](/docs/de/agent-teams): richten Sie einen Lead und Teammates ein, weisen Sie Aufgaben zu und überprüfen Sie ihre Arbeit.

71* [Orchestrieren Sie dynamische Workflows](/de/workflows): führen Sie einen gebündelten Workflow aus oder lassen Sie Claude einen schreiben, der viele Subagenten ausführt und ihre Ergebnisse gegeneinander überprüft.71* [Orchestrieren Sie dynamische Workflows](/docs/de/workflows): führen Sie einen gebündelten Workflow aus oder lassen Sie Claude einen schreiben, der viele Subagenten ausführt und ihre Ergebnisse gegeneinander überprüft.

~~72* [Führen Sie parallele Sitzungen mit Worktrees aus](/de/worktrees): starten Sie Claude in einem isolierten Checkout, kontrollieren Sie, was kopiert wird, und bereinigen Sie danach.~~72* [Führen Sie parallele Sitzungen mit Worktrees aus](/docs/de/worktrees): starten Sie Claude in einem isolierten Checkout, kontrollieren Sie, was kopiert wird, und bereinigen Sie danach.

amazon-bedrock.md +28 −28

Details

107 </Step>107 </Step>

108 108

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

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

111 </Step>111 </Step>

112</Steps>112</Steps>

113 113

114Nachdem Sie sich angemeldet haben, führen Sie `/setup-bedrock` jederzeit aus, um den Assistenten erneut zu öffnen und Ihre Anmeldedaten, Region oder Modellpins zu ändern. Der Modellpin-Schritt beginnt mit Ihren aktuell fixierten Modellen. Der Assistent schreibt in `~/.claude/settings.json` oder in `$CLAUDE_CONFIG_DIR/settings.json`, wenn [`CLAUDE_CONFIG_DIR`](/de/env-vars#variables) gesetzt ist.114Nachdem Sie sich angemeldet haben, führen Sie `/setup-bedrock` jederzeit aus, um den Assistenten erneut zu öffnen und Ihre Anmeldedaten, Region oder Modellpins zu ändern. Der Modellpin-Schritt beginnt mit Ihren aktuell fixierten Modellen. Der Assistent schreibt in `~/.claude/settings.json` oder in `$CLAUDE_CONFIG_DIR/settings.json`, wenn [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars#variables) gesetzt ist.

115 115

116<h2 id="set-up-manually">116<h2 id="set-up-manually">

117 Manuelles Setup117 Manuelles Setup

162export AWS_PROFILE=your-profile-name162export AWS_PROFILE=your-profile-name

163```163```

164 164

165Claude Code fordert Rollenanmeldedaten aus der IAM Identity Center-Region an, die durch das Profil `sso_region` benannt wird, die nicht mit der Region übereinstimmen muss, in der Sie Amazon Bedrock ausführen. {/* min-version: 2.1.208 */}In v2.1.207 überschrieb die Amazon Bedrock-Region `sso_region`, daher schlug ein Profil, dessen IAM Identity Center-Instanz sich in einer anderen Region befindet, mit einem `Session token not found or invalid`-Fehler fehl.165Claude Code fordert Rollenanmeldedaten aus der IAM Identity Center-Region an, die durch das Profil `sso_region` benannt wird, die nicht mit der Region übereinstimmen muss, in der Sie Amazon Bedrock ausführen. In v2.1.207 überschrieb die Amazon Bedrock-Region `sso_region`, daher schlug ein Profil, dessen IAM Identity Center-Instanz sich in einer anderen Region befindet, mit einem `Session token not found or invalid`-Fehler fehl.

166 166

167**Option D: AWS Management Console-Anmeldedaten**167**Option D: AWS Management Console-Anmeldedaten**

168 168

188 188

189Vor v2.1.207 löste Claude Code die Kette bei jeder API-Anfrage auf, sodass ein SSO-gestütztes Profil jedes Mal frische Anmeldedaten von IAM Identity Center anforderte und in großen Bereitstellungen gedrosselt werden konnte.189Vor v2.1.207 löste Claude Code die Kette bei jeder API-Anfrage auf, sodass ein SSO-gestütztes Profil jedes Mal frische Anmeldedaten von IAM Identity Center anforderte und in großen Bereitstellungen gedrosselt werden konnte.

190 190

191Der Cache deckt alle oben genannten Anmeldedaten-Optionen ab, außer einem Amazon Bedrock API-Schlüssel, der die Provider-Kette nicht verwendet. Um die Kette bei jeder Anfrage aufzulösen, setzen Sie stattdessen [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/de/env-vars).191Der Cache deckt alle oben genannten Anmeldedaten-Optionen ab, außer einem Amazon Bedrock API-Schlüssel, der die Provider-Kette nicht verwendet. Um die Kette bei jeder Anfrage aufzulösen, setzen Sie stattdessen [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/docs/de/env-vars).

192 192

193Jede Auflösung der Kette läuft nach 60 Sekunden ab. Wenn ein Schritt in der Kette steckenbleibt, z. B. ein `credential_process`-Helfer, der auf Eingaben wartet, die er nicht erhalten kann, schlägt die Anfrage mit [`AWS default-chain credential resolve timed out`](/de/errors#aws-default-chain-credential-resolve-timed-out) fehl. Wenn Ihre Kette eine interaktive Anmeldung ausführt, die legitim länger dauert, z. B. browserbasierte SSO mit MFA über einen Wrapper wie `aws-vault`, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/de/env-vars). Vor v2.1.207 ließ eine steckengebliebene Anmeldedaten-Auflösung die Anfrage unbegrenzt warten.193Jede Auflösung der Kette läuft nach 60 Sekunden ab. Wenn ein Schritt in der Kette steckenbleibt, z. B. ein `credential_process`-Helfer, der auf Eingaben wartet, die er nicht erhalten kann, schlägt die Anfrage mit [`AWS default-chain credential resolve timed out`](/docs/de/errors#aws-default-chain-credential-resolve-timed-out) fehl. Wenn Ihre Kette eine interaktive Anmeldung ausführt, die legitim länger dauert, z. B. browserbasierte 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). Vor v2.1.207 ließ eine steckengebliebene Anmeldedaten-Auflösung die Anfrage unbegrenzt warten.

194 194

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

196 Erweiterte Anmeldedatenkonfiguration196 Erweiterte Anmeldedatenkonfiguration

197</h4>197</h4>

198 198

199Claude Code unterstützt die automatische Aktualisierung von Anmeldedaten für AWS SSO und Unternehmensidentitätsanbieter. Fügen Sie diese Einstellungen zu Ihrer Claude Code-Einstellungsdatei hinzu (siehe [Einstellungen](/de/settings) für Dateispeicherorte).199Claude Code unterstützt die automatische Aktualisierung von Anmeldedaten für AWS SSO und Unternehmensidentitätsanbieter. Fügen Sie diese Einstellungen zu Ihrer Claude Code-Einstellungsdatei hinzu (siehe [Einstellungen](/docs/de/settings) für Dateispeicherorte).

200 200

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

202 202

235}235}

236```236```

237 237

238{/* min-version: 2.1.181 */}Ab Claude Code v2.1.181 wird auch die flache Ausgabe von `aws configure export-credentials --format process` akzeptiert, mit denselben Schlüsseln auf der obersten Ebene statt verschachtelt unter `Credentials`.238Ab Claude Code v2.1.181 wird auch die flache Ausgabe von `aws configure export-credentials --format process` akzeptiert, mit denselben Schlüsseln auf der obersten Ebene statt verschachtelt unter `Credentials`.

239 239

240`Expiration` ist optional. {/* min-version: 2.1.176 */}Ab Claude Code v2.1.176 speichert Claude Code die Anmeldedaten im Cache, wenn der Befehl einen gültigen ISO 8601 `Expiration` zurückgibt, bis fünf Minuten vor dieser Zeit. Ohne ihn oder in früheren Versionen werden Anmeldedaten eine Stunde lang im Cache gespeichert.240`Expiration` ist optional. Ab Claude Code v2.1.176 speichert Claude Code die Anmeldedaten im Cache, wenn der Befehl einen gültigen ISO 8601 `Expiration` zurückgibt, bis fünf Minuten vor dieser Zeit. Ohne ihn oder in früheren Versionen werden Anmeldedaten eine Stunde lang im Cache gespeichert.

241 241

242Wenn Sie `awsCredentialExport` ohne `awsAuthRefresh` konfigurieren, verwendet Claude Code die exportierten Anmeldedaten direkt und löst die AWS-Standard-Anmeldedaten-Provider-Kette beim Start nicht erneut auf. Vor v2.1.206 löste der Start auch die Standard-Provider-Kette erneut auf, was einen Live-SSO- oder STS-Aufruf außerhalb Ihrer Proxy-Konfiguration durchführte und die erste Eingabeaufforderung in Netzwerken mit eingeschränktem Ausgang um mehrere Minuten blockieren konnte.242Wenn Sie `awsCredentialExport` ohne `awsAuthRefresh` konfigurieren, verwendet Claude Code die exportierten Anmeldedaten direkt und löst die AWS-Standard-Anmeldedaten-Provider-Kette beim Start nicht erneut auf. Vor v2.1.206 löste der Start auch die Standard-Provider-Kette erneut auf, was einen Live-SSO- oder STS-Aufruf außerhalb Ihrer Proxy-Konfiguration durchführte und die erste Eingabeaufforderung in Netzwerken mit eingeschränktem Ausgang um mehrere Minuten blockieren konnte.

243 243

263 263

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

265 265

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

267 267

268 * `AWS_REGION`268 * `AWS_REGION`

269 * `AWS_DEFAULT_REGION`269 * `AWS_DEFAULT_REGION`

272 272

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

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

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

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

277 277

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

279 4. Modellversionen fixieren279 4. Modellversionen fixieren

293export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'293export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

294```294```

295 295

296Diese Variablen verwenden Cross-Region-Inferenzprofil-IDs (mit dem `us.`-Präfix). Wenn Sie ein anderes Regionspräfix oder Anwendungsinferenzprofile verwenden, passen Sie entsprechend an. In AWS GovCloud-Regionen verwenden Sie das `us-gov.`-Präfix. Aktuelle und ältere Modell-IDs finden Sie unter [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Siehe [Modellkonfiguration](/de/model-config#pin-models-for-third-party-deployments) für die vollständige Liste der Umgebungsvariablen.296Diese Variablen verwenden Cross-Region-Inferenzprofil-IDs (mit dem `us.`-Präfix). Wenn Sie ein anderes Regionspräfix oder Anwendungsinferenzprofile verwenden, passen Sie entsprechend an. In AWS GovCloud-Regionen verwenden Sie das `us-gov.`-Präfix. Aktuelle und ältere Modell-IDs finden Sie unter [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Siehe [Modellkonfiguration](/docs/de/model-config#pin-models-for-third-party-deployments) für die vollständige Liste der Umgebungsvariablen.

297 297

298Claude Code verwendet diese Standardmodelle, wenn keine Fixierungsvariablen gesetzt sind:298Claude Code verwendet diese Standardmodelle, wenn keine Fixierungsvariablen gesetzt sind:

299 299

311 Opus-Modelle haben einen höheren Pro-Token-Preis als Sonnet-Modelle, daher wird eine Bereitstellung, die kein primäres Modell fixiert, ab v2.1.207 oder später zum Opus-Satz abgerechnet. Um Sonnet 4.5 als primäres Modell zu behalten, setzen Sie `ANTHROPIC_MODEL` auf seine vollständige Modell-ID. Eine Bereitstellung, die den Standard mit `ANTHROPIC_DEFAULT_SONNET_MODEL` steuert und `ANTHROPIC_DEFAULT_OPUS_MODEL` nicht setzt, behält ihr gesteuertes Sonnet-Modell als Standard.311 Opus-Modelle haben einen höheren Pro-Token-Preis als Sonnet-Modelle, daher wird eine Bereitstellung, die kein primäres Modell fixiert, ab v2.1.207 oder später zum Opus-Satz abgerechnet. Um Sonnet 4.5 als primäres Modell zu behalten, setzen Sie `ANTHROPIC_MODEL` auf seine vollständige Modell-ID. Eine Bereitstellung, die den Standard mit `ANTHROPIC_DEFAULT_SONNET_MODEL` steuert und `ANTHROPIC_DEFAULT_OPUS_MODEL` nicht setzt, behält ihr gesteuertes Sonnet-Modell als Standard.

312</Warning>312</Warning>

313 313

314{/* min-version: 2.1.207 */}Vor v2.1.207 war das primäre Modell auf Amazon Bedrock standardmäßig Sonnet 4.5, der `opus`-Alias wurde zu Opus 4.6 aufgelöst, und Hintergrundaufgaben verwendeten immer das primäre Modell.314Vor v2.1.207 war das primäre Modell auf Amazon Bedrock standardmäßig Sonnet 4.5, der `opus`-Alias wurde zu Opus 4.6 aufgelöst, und Hintergrundaufgaben verwendeten immer das primäre Modell.

315 315

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

317 317

330export ENABLE_PROMPT_CACHING_1H=1330export ENABLE_PROMPT_CACHING_1H=1

331```331```

332 332

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

334 334

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

336 336

338 Jede Modellversion einem Inferenzprofil zuordnen338 Jede Modellversion einem Inferenzprofil zuordnen

339</h4>339</h4>

340 340

341Die Umgebungsvariablen `ANTHROPIC_DEFAULT_*_MODEL` konfigurieren ein Inferenzprofil pro Modellfamilie. Wenn Ihre Organisation mehrere Versionen derselben Familie in der `/model`-Auswahl verfügbar machen muss, die jeweils zu ihrem eigenen Anwendungsinferenzprofil-ARN weitergeleitet werden, verwenden Sie stattdessen die `modelOverrides`-Einstellung in Ihrer [Einstellungsdatei](/de/settings#settings-files).341Die Umgebungsvariablen `ANTHROPIC_DEFAULT_*_MODEL` konfigurieren ein Inferenzprofil pro Modellfamilie. Wenn Ihre Organisation mehrere Versionen derselben Familie in der `/model`-Auswahl verfügbar machen muss, die jeweils zu ihrem eigenen Anwendungsinferenzprofil-ARN weitergeleitet werden, verwenden Sie stattdessen die `modelOverrides`-Einstellung in Ihrer [Einstellungsdatei](/docs/de/settings#settings-files).

342 342

343Dieses Beispiel ordnet vier Opus-Versionen unterschiedlichen ARNs zu, damit Benutzer zwischen ihnen wechseln können, ohne die Inferenzprofile Ihrer Organisation zu umgehen:343Dieses Beispiel ordnet vier Opus-Versionen unterschiedlichen ARNs zu, damit Benutzer zwischen ihnen wechseln können, ohne die Inferenzprofile Ihrer Organisation zu umgehen:

344 344

353}353}

354```354```

355 355

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

357 357

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

359 Startup-Modellprüfungen359 Startup-Modellprüfungen

361 361

362Wenn Claude Code mit konfiguriertem Amazon Bedrock startet, überprüft es, dass die Modelle, die es verwenden möchte, in Ihrem Konto zugänglich sind.362Wenn Claude Code mit konfiguriertem Amazon Bedrock startet, überprüft es, dass die Modelle, die es verwenden möchte, in Ihrem Konto zugänglich sind.

363 363

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

365 365

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

367 367

426 426

427Claude Sonnet 5, Opus 4.6 und später sowie Sonnet 4.6 unterstützen das [1M Token-Kontextfenster](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) auf Amazon Bedrock. Sonnet 5 wird über den [Mantle-Endpunkt](#use-the-mantle-endpoint) bereitgestellt und läuft immer mit dem 1M-Fenster, ohne dass eine `[1m]`-Variante ausgewählt werden kann. Bei den anderen Modellen aktiviert Claude Code automatisch das erweiterte Kontextfenster, wenn Sie eine 1M-Modellvariante auswählen.427Claude Sonnet 5, Opus 4.6 und später sowie Sonnet 4.6 unterstützen das [1M Token-Kontextfenster](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) auf Amazon Bedrock. Sonnet 5 wird über den [Mantle-Endpunkt](#use-the-mantle-endpoint) bereitgestellt und läuft immer mit dem 1M-Fenster, ohne dass eine `[1m]`-Variante ausgewählt werden kann. Bei den anderen Modellen aktiviert Claude Code automatisch das erweiterte Kontextfenster, wenn Sie eine 1M-Modellvariante auswählen.

428 428

429Der [Setup-Assistent](#sign-in-with-bedrock) bietet eine 1M-Kontextoption, wenn er Modelle fixiert. Um es stattdessen für ein manuell fixiertes Modell zu aktivieren, hängen Sie `[1m]` an die Modell-ID an. Siehe [Modelle für Drittanbieter-Bereitstellungen fixieren](/de/model-config#pin-models-for-third-party-deployments) für Details.429Der [Setup-Assistent](#sign-in-with-bedrock) bietet eine 1M-Kontextoption, wenn er Modelle fixiert. Um es stattdessen für ein manuell fixiertes Modell zu aktivieren, hängen Sie `[1m]` an die Modell-ID an. Siehe [Modelle für Drittanbieter-Bereitstellungen fixieren](/docs/de/model-config#pin-models-for-third-party-deployments) für Details.

430 430

431<h2 id="service-tiers">431<h2 id="service-tiers">

432 Service-Tiers432 Service-Tiers

444 AWS Guardrails444 AWS Guardrails

445</h2>445</h2>

446 446

447[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) ermöglichen es Ihnen, Inhaltsfilterung für Claude Code zu implementieren. Erstellen Sie einen Guardrail in der [Amazon Bedrock-Konsole](https://console.aws.amazon.com/bedrock/), veröffentlichen Sie eine Version, und fügen Sie dann die Guardrail-Header zu Ihrer [Einstellungsdatei](/de/settings) hinzu. Aktivieren Sie Cross-Region-Inferenz auf Ihrem Guardrail, wenn Sie Cross-Region-Inferenzprofile verwenden.447[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) ermöglichen es Ihnen, Inhaltsfilterung für Claude Code zu implementieren. Erstellen Sie einen Guardrail in der [Amazon Bedrock-Konsole](https://console.aws.amazon.com/bedrock/), veröffentlichen Sie eine Version, und fügen Sie dann die Guardrail-Header zu Ihrer [Einstellungsdatei](/docs/de/settings) hinzu. Aktivieren Sie Cross-Region-Inferenz auf Ihrem Guardrail, wenn Sie Cross-Region-Inferenzprofile verwenden.

448 448

449Beispielkonfiguration:449Beispielkonfiguration:

450 450

473export AWS_REGION=us-east-1473export AWS_REGION=us-east-1

474```474```

475 475

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

477 477

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

479 479

500export CLAUDE_CODE_USE_MANTLE=1500export CLAUDE_CODE_USE_MANTLE=1

501```501```

502 502

503Um ein Mantle-Modell in der `/model`-Auswahl anzuzeigen, listen Sie seine ID in `availableModels` in Ihrer [Einstellungsdatei](/de/settings) auf. Diese Einstellung beschränkt die Auswahl auch auf die aufgelisteten Einträge. Das Auflisten von `anthropic.claude-haiku-4-5` entfernt den bloßen `haiku`-Alias aus der Auswahl, daher sollten Sie auch Versionspräfixe oder vollständige IDs für die Versionen auflisten, die Sie auswählbar halten möchten. Die Mantle-ID und der `haiku`-Alias werden zum gleichen Modell-Familie aufgelöst, daher behält die Zusammenführung nur den spezifischeren Eintrag. Siehe [Merge-Verhalten](/de/model-config#merge-behavior):503Um ein Mantle-Modell in der `/model`-Auswahl anzuzeigen, listen Sie seine ID in `availableModels` in Ihrer [Einstellungsdatei](/docs/de/settings) auf. Diese Einstellung beschränkt die Auswahl auch auf die aufgelisteten Einträge. Das Auflisten von `anthropic.claude-haiku-4-5` entfernt den bloßen `haiku`-Alias aus der Auswahl, daher sollten Sie auch Versionspräfixe oder vollständige IDs für die Versionen auflisten, die Sie auswählbar halten möchten. Die Mantle-ID und der `haiku`-Alias werden zum gleichen Modell-Familie aufgelöst, daher behält die Zusammenführung nur den spezifischeren Eintrag. Siehe [Merge-Verhalten](/docs/de/model-config#merge-behavior):

504 504

505```json theme={null}505```json theme={null}

506{506{

508}508}

509```509```

510 510

511Einträge mit dem `anthropic.`-Präfix werden als benutzerdefinierte Auswahl-Optionen hinzugefügt und zu Mantle weitergeleitet. Ersetzen Sie `anthropic.claude-haiku-4-5` durch die Modell-ID, die Ihr Konto erhalten hat. Siehe [Modellauswahl einschränken](/de/model-config#restrict-model-selection) für Details, wie `availableModels` mit anderen Modelleinstellungen interagiert.511Einträge mit dem `anthropic.`-Präfix werden als benutzerdefinierte Auswahl-Optionen hinzugefügt und zu Mantle weitergeleitet. Ersetzen Sie `anthropic.claude-haiku-4-5` durch die Modell-ID, die Ihr Konto erhalten hat. Siehe [Modellauswahl einschränken](/docs/de/model-config#restrict-model-selection) für Details, wie `availableModels` mit anderen Modelleinstellungen interagiert.

512 512

513Wenn beide Provider aktiv sind, zeigt `/status` `Amazon Bedrock + Amazon Bedrock (Mantle)` an.513Wenn beide Provider aktiv sind, zeigt `/status` `Amazon Bedrock + Amazon Bedrock (Mantle)` an.

514 514

516 Leiten Sie Mantle durch ein Gateway weiter516 Leiten Sie Mantle durch ein Gateway weiter

517</h3>517</h3>

518 518

519Wenn Ihre Organisation Modellverkehr durch ein zentralisiertes [LLM-Gateway](/de/llm-gateway) leitet, das AWS-Anmeldedaten serverseitig injiziert, deaktivieren Sie die clientseitige Authentifizierung, damit Claude Code Anfragen ohne SigV4-Signaturen oder `x-api-key`-Header sendet:519Wenn Ihre Organisation Modellverkehr durch ein zentralisiertes [LLM-Gateway](/docs/de/llm-gateway) leitet, das AWS-Anmeldedaten serverseitig injiziert, deaktivieren Sie die clientseitige Authentifizierung, damit Claude Code Anfragen ohne SigV4-Signaturen oder `x-api-key`-Header sendet:

520 520

521```bash theme={null}521```bash theme={null}

522export CLAUDE_CODE_USE_MANTLE=1522export CLAUDE_CODE_USE_MANTLE=1

528 Mantle-Umgebungsvariablen528 Mantle-Umgebungsvariablen

529</h3>529</h3>

530 530

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

532 532

533| Variable | Zweck |533| Variable | Zweck |

534| :-------------------------------------- | :------------------------------------------------------------------------------------------ |534| :-------------------------------------- | :------------------------------------------------------------------------------------------ |

545 Authentifizierungsschleife mit SSO und Unternehmens-Proxys545 Authentifizierungsschleife mit SSO und Unternehmens-Proxys

546</h3>546</h3>

547 547

548Wenn Browser-Registerkarten wiederholt geöffnet werden, wenn Sie AWS SSO verwenden, entfernen Sie die `awsAuthRefresh`-Einstellung aus Ihrer [Einstellungsdatei](/de/settings). Dies kann auftreten, wenn Unternehmens-VPNs oder TLS-Inspektions-Proxys den SSO-Browser-Flow unterbrechen. Claude Code behandelt die unterbrochene Verbindung als Authentifizierungsfehler, führt `awsAuthRefresh` erneut aus und schleift sich endlos.548Wenn Browser-Registerkarten wiederholt geöffnet werden, wenn Sie AWS SSO verwenden, entfernen Sie die `awsAuthRefresh`-Einstellung aus Ihrer [Einstellungsdatei](/docs/de/settings). Dies kann auftreten, wenn Unternehmens-VPNs oder TLS-Inspektions-Proxys den SSO-Browser-Flow unterbrechen. Claude Code behandelt die unterbrochene Verbindung als Authentifizierungsfehler, führt `awsAuthRefresh` erneut aus und schleift sich endlos.

549 549

550Wenn Ihre Netzwerkumgebung automatische browserbasierte SSO-Flows beeinträchtigt, verwenden Sie `aws sso login` manuell, bevor Sie Claude Code starten, anstatt sich auf `awsAuthRefresh` zu verlassen.550Wenn Ihre Netzwerkumgebung automatische browserbasierte SSO-Flows beeinträchtigt, verwenden Sie `aws sso login` manuell, bevor Sie Claude Code starten, anstatt sich auf `awsAuthRefresh` zu verlassen.

551 551

573 573

574Vor v2.1.208 zeigte sich die gleiche Fehlkonfiguration als `API Error: Truncated event message received`, nachdem die gesamte Antwort gepuffert worden war.574Vor v2.1.208 zeigte sich die gleiche Fehlkonfiguration als `API Error: Truncated event message received`, nachdem die gesamte Antwort gepuffert worden war.

575 575

576Um dies zu beheben, konfigurieren Sie das Gateway so, dass es den `InvokeModelWithResponseStream`-Antwortkörper und seinen `Content-Type`-Header unverändert durchleitet. Wenn das Gateway nur den Header umschreibt und den binären Body intakt durchleitet, setzen Sie [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/de/env-vars), um die Überprüfung zu überspringen, bis das Gateway repariert ist. Mit deaktivierter Überprüfung schlägt ein Antwortkörper, der transformiert wurde, erneut mit `Truncated event message received` fehl.576Um dies zu beheben, konfigurieren Sie das Gateway so, dass es den `InvokeModelWithResponseStream`-Antwortkörper und seinen `Content-Type`-Header unverändert durchleitet. Wenn das Gateway nur den Header umschreibt und den binären Body intakt durchleitet, setzen Sie [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/de/env-vars), um die Überprüfung zu überspringen, bis das Gateway repariert ist. Mit deaktivierter Überprüfung schlägt ein Antwortkörper, der transformiert wurde, erneut mit `Truncated event message received` fehl.

577 577

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

579 Null-Token-Zählungen in /context579 Null-Token-Zählungen in /context

580</h3>580</h3>

581 581

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

583 583

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

585 585

587 Mantle-Endpunkt-Fehler587 Mantle-Endpunkt-Fehler

588</h3>588</h3>

589 589

590Wenn `/status` nach dem Setzen von `CLAUDE_CODE_USE_MANTLE` nicht `Amazon Bedrock (Mantle)` anzeigt, erreicht die Variable den Prozess nicht. Bestätigen Sie, dass sie in der Shell exportiert wird, in der Sie `claude` gestartet haben, oder legen Sie sie im `env`-Block Ihrer [Einstellungsdatei](/de/settings) fest.590Wenn `/status` nach dem Setzen von `CLAUDE_CODE_USE_MANTLE` nicht `Amazon Bedrock (Mantle)` anzeigt, erreicht die Variable den Prozess nicht. Bestätigen Sie, dass sie in der Shell exportiert wird, in der Sie `claude` gestartet haben, oder legen Sie sie im `env`-Block Ihrer [Einstellungsdatei](/docs/de/settings) fest.

591 591

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

593 593

artifacts.md +15 −19

Details

6 6

7> Artefakte verwandeln die Arbeit von Claude Code in Live-Seiten, die interaktiv sind und auf claude.ai verfügbar sind. Sie können diese privat halten, mit Ihrer Organisation teilen oder über einen öffentlichen Link veröffentlichen.7> Artefakte verwandeln die Arbeit von Claude Code in Live-Seiten, die interaktiv sind und auf claude.ai verfügbar sind. Sie können diese privat halten, mit Ihrer Organisation teilen oder über einen öffentlichen Link veröffentlichen.

8 8

~~9{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}~~

11<Note>9<Note>

12 Artefakte sind auf Pro-, Max-, Team- und Enterprise-Plänen verfügbar und erfordern eine Sitzung, die mit [`/login`](/de/setup#authenticate) angemeldet ist. Siehe [Verfügbarkeit](#availability) für die vollständige Liste der Anforderungen.10 Artefakte sind auf Pro-, Max-, Team- und Enterprise-Plänen verfügbar und erfordern eine Sitzung, die mit [`/login`](/docs/de/setup#authenticate) angemeldet ist. Siehe [Verfügbarkeit](#availability) für die vollständige Liste der Anforderungen.

13</Note>11</Note>

14 12

15Ein Artefakt ist eine Live-, interaktive Webseite, die Claude Code aus Ihrer Sitzung auf einer privaten URL auf claude.ai veröffentlicht. Sie öffnen sie in einem Browser, und sie wird aktualisiert, während die Sitzung fortgesetzt wird. Teilen Sie sie über die Kopfzeile der Seite, wenn jemand anderes sie auch sehen soll. Verwenden Sie beispielsweise ein Artefakt, um einen Reviewer durch einen Pull Request mit kommentierten Diffs zu führen, ein Dashboard aus Sitzungsdaten zu erstellen oder eine Untersuchungs-Timeline zu führen, die sich füllt, während Claude arbeitet.13Ein Artefakt ist eine Live-, interaktive Webseite, die Claude Code aus Ihrer Sitzung auf einer privaten URL auf claude.ai veröffentlicht. Sie öffnen sie in einem Browser, und sie wird aktualisiert, während die Sitzung fortgesetzt wird. Teilen Sie sie über die Kopfzeile der Seite, wenn jemand anderes sie auch sehen soll. Verwenden Sie beispielsweise ein Artefakt, um einen Reviewer durch einen Pull Request mit kommentierten Diffs zu führen, ein Dashboard aus Sitzungsdaten zu erstellen oder eine Untersuchungs-Timeline zu führen, die sich füllt, während Claude arbeitet.

22 Wann Sie ein Artefakt verwenden sollten20 Wann Sie ein Artefakt verwenden sollten

23</h2>21</h2>

24 22

25Verwenden Sie ein Artefakt, wenn Terminaltext das falsche Medium für das ist, was Claude produziert hat: Ausgabe, die leichter anzusehen und zu interagieren ist als zeilenweise zu lesen. Claude erstellt die Seite aus allem, das Ihre Sitzung erreichen kann, einschließlich Ihrer Codebasis und Daten, die es durch Ihre [verbundenen Tools](/de/mcp) abruft, sodass die Seite Dinge anzeigen kann, die Absätze zu beschreiben erfordern würden. Bitten Sie Claude beispielsweise um:23Verwenden Sie ein Artefakt, wenn Terminaltext das falsche Medium für das ist, was Claude produziert hat: Ausgabe, die leichter anzusehen und zu interagieren ist als zeilenweise zu lesen. Claude erstellt die Seite aus allem, das Ihre Sitzung erreichen kann, einschließlich Ihrer Codebasis und Daten, die es durch Ihre [verbundenen Tools](/docs/de/mcp) abruft, sodass die Seite Dinge anzeigen kann, die Absätze zu beschreiben erfordern würden. Bitten Sie Claude beispielsweise um:

26 24

27* Einen Reviewer durch einen Pull Request mit kommentierten Diffs zu führen25* Einen Reviewer durch einen Pull Request mit kommentierten Diffs zu führen

28* Ein Dashboard aus Daten zu rendern, die die Sitzung bereits abgerufen hat26* Ein Dashboard aus Daten zu rendern, die die Sitzung bereits abgerufen hat

104 Live-Daten mit MCP-Konnektoren abrufen102 Live-Daten mit MCP-Konnektoren abrufen

105</h2>103</h2>

106 104

107{/* plan-availability: feature=artifact-mcp plans=pro,max,team,enterprise providers=anthropic */}105Ein Artefakt kann [MCP-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) jedes Mal aufrufen, wenn jemand es anzeigt, sodass die Seite aktuelle Daten anstelle eines Snapshots aus der Sitzung anzeigt, in der sie erstellt wurde. Konnektoraufrufe aus Artefakten sind in den Plänen Pro, Max, Team und Enterprise verfügbar und erfordern Claude Code v2.1.209 oder später. In früheren Versionen veröffentlicht Claude die Seite mit den Daten, die die Sitzung während der Erstellung gesammelt hat.

~~108~~

109Ein Artefakt kann [MCP-Konnektoren](/de/mcp#use-mcp-servers-from-claude-ai) jedes Mal aufrufen, wenn jemand es anzeigt, sodass die Seite aktuelle Daten anstelle eines Snapshots aus der Sitzung anzeigt, in der sie erstellt wurde. Konnektoraufrufe aus Artefakten sind in den Plänen Pro, Max, Team und Enterprise verfügbar und erfordern Claude Code v2.1.209 oder später. In früheren Versionen veröffentlicht Claude die Seite mit den Daten, die die Sitzung während der Erstellung gesammelt hat.

110 106

111Um eine Konnektoren-gestützte Seite zu erstellen, nennen Sie den Konnektor und die gewünschten Daten in Ihrer Eingabeaufforderung:107Um eine Konnektoren-gestützte Seite zu erstellen, nennen Sie den Konnektor und die gewünschten Daten in Ihrer Eingabeaufforderung:

112 108

202 Verbessern Sie das visuelle Design198 Verbessern Sie das visuelle Design

203</h2>199</h2>

204 200

205Ab Claude Code v2.1.183 wendet Claude eine integrierte Design-Fähigkeit an, wenn es ein Artefakt erstellt, sodass Seiten eine absichtliche Palette, Typografie und Layout ohne zusätzliche Aufforderung erhalten. Diese Fähigkeit sucht auch nach einem vorhandenen Design-System in Ihrem Projekt, bevor es sein eigenes auswählt. Um Artefakte konsistent mit dem Branding Ihres Produkts zu halten, notieren Sie Ihre Design-Token dort, wo Claude sie finden kann, wie in der [CLAUDE.md](/de/memory) des Projekts oder einer Theme-Datei in Ihrem Repository:201Ab Claude Code v2.1.183 wendet Claude eine integrierte Design-Fähigkeit an, wenn es ein Artefakt erstellt, sodass Seiten eine absichtliche Palette, Typografie und Layout ohne zusätzliche Aufforderung erhalten. Diese Fähigkeit sucht auch nach einem vorhandenen Design-System in Ihrem Projekt, bevor es sein eigenes auswählt. Um Artefakte konsistent mit dem Branding Ihres Produkts zu halten, notieren Sie Ihre Design-Token dort, wo Claude sie finden kann, wie in der [CLAUDE.md](/docs/de/memory) des Projekts oder einer Theme-Datei in Ihrem Repository:

206 202

207```markdown theme={null}203```markdown theme={null}

208## Design system204## Design system

243| Anforderung | Verfügbar wenn |239| Anforderung | Verfügbar wenn |

244| :---------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |240| :---------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

245| Plan | Pro, Max, Team oder Enterprise. Bei Pro- und Max-Plänen sind Artefakte privat für Sie, bis Sie sie freigeben, und es gilt keine Admin-Verwaltung. Bei Team-Plänen sind Artefakte standardmäßig aktiviert. Bei Enterprise-Plänen aktiviert ein Owner sie [](#manage-artifacts-for-your-organization) in den claude.ai-Admin-Einstellungen. |241| Plan | Pro, Max, Team oder Enterprise. Bei Pro- und Max-Plänen sind Artefakte privat für Sie, bis Sie sie freigeben, und es gilt keine Admin-Verwaltung. Bei Team-Plänen sind Artefakte standardmäßig aktiviert. Bei Enterprise-Plänen aktiviert ein Owner sie [](#manage-artifacts-for-your-organization) in den claude.ai-Admin-Einstellungen. |

246| Authentifizierung | Die Sitzung wird durch ein claude.ai-Konto unterstützt: Melden Sie sich mit `/login` in der CLI oder Desktop-App an. Claude Tag-Sitzungen sind durch die Identität des Agenten angemeldet, daher ist kein Schritt erforderlich. Sitzungen, die einen API-Schlüssel, [Gateway-Token](/de/llm-gateway) oder Cloud-Provider-Anmeldedaten verwenden, können nicht veröffentlichen. |242| Authentifizierung | Die Sitzung wird durch ein claude.ai-Konto unterstützt: Melden Sie sich mit `/login` in der CLI oder Desktop-App an. Claude Tag-Sitzungen sind durch die Identität des Agenten angemeldet, daher ist kein Schritt erforderlich. Sitzungen, die einen API-Schlüssel, [Gateway-Token](/docs/de/llm-gateway) oder Cloud-Provider-Anmeldedaten verwenden, können nicht veröffentlichen. |

247| Modell-Provider | Anthropic API. Nicht verfügbar auf [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry). |243| Modell-Provider | Anthropic API. Nicht verfügbar auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) oder [Microsoft Foundry](/docs/de/microsoft-foundry). |

248| Organisationsrichtlinie | Customer-managed encryption keys (CMEK), HIPAA und [Zero Data Retention](/de/zero-data-retention) sind nicht für die Organisation aktiviert. |244| Organisationsrichtlinie | Customer-managed encryption keys (CMEK), HIPAA und [Zero Data Retention](/docs/de/zero-data-retention) sind nicht für die Organisation aktiviert. |

249| Oberfläche | Claude Code CLI Version 2.1.183 oder später oder die Claude Desktop-App Version 1.13576.0 oder später. [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen können auch Artefakte veröffentlichen, wenn sowohl Claude Tag als auch Artefakte für die Organisation aktiviert sind. Standardmäßig aus in [Agent SDK](/de/agent-sdk/overview), GitHub Action und MCP-Server-Kontexten und wenn [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/de/env-vars) gesetzt ist. |245| Oberfläche | Claude Code CLI Version 2.1.183 oder später oder die Claude Desktop-App Version 1.13576.0 oder später. [Claude Tag](https://claude.com/docs/claude-tag/overview)-Sitzungen können auch Artefakte veröffentlichen, wenn sowohl Claude Tag als auch Artefakte für die Organisation aktiviert sind. Standardmäßig aus in [Agent SDK](/docs/de/agent-sdk/overview), GitHub Action und MCP-Server-Kontexten und wenn [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/de/env-vars) gesetzt ist. |

250 246

251<h2 id="disable-artifacts">247<h2 id="disable-artifacts">

252 Deaktivieren Sie Artefakte248 Deaktivieren Sie Artefakte

256 252

257| Methode | Einstellung |253| Methode | Einstellung |

258| :------------------------------------ | :----------------------------------------------- |254| :------------------------------------ | :----------------------------------------------- |

262 258

263<h2 id="manage-artifacts-for-your-organization">259<h2 id="manage-artifacts-for-your-organization">

264 Verwalten Sie Artefakte für Ihre Organisation260 Verwalten Sie Artefakte für Ihre Organisation

300 Allowlist die Viewer-Domain296 Allowlist die Viewer-Domain

301</h3>297</h3>

302 298

303Der Viewer auf claude.ai lädt jedes Artefakt aus einer Sandbox-`*.claudeusercontent.com`-Origin. Wenn Ihre Organisation den ausgehenden Netzwerkzugriff einschränkt, fügen Sie diese Domain zu Ihrer Allowlist neben `claude.ai` hinzu. Siehe [Netzwerkzugriffsanforderungen](/de/network-config#network-access-requirements) für die vollständige Liste.299Der Viewer auf claude.ai lädt jedes Artefakt aus einer Sandbox-`*.claudeusercontent.com`-Origin. Wenn Ihre Organisation den ausgehenden Netzwerkzugriff einschränkt, fügen Sie diese Domain zu Ihrer Allowlist neben `claude.ai` hinzu. Siehe [Netzwerkzugriffsanforderungen](/docs/de/network-config#network-access-requirements) für die vollständige Liste.

304 300

305<h3 id="list-and-delete-artifacts-with-the-compliance-api">301<h3 id="list-and-delete-artifacts-with-the-compliance-api">

306 Listen Sie Artefakte mit der Compliance API auf und löschen Sie sie302 Listen Sie Artefakte mit der Compliance API auf und löschen Sie sie

320 Verwandte Ressourcen316 Verwandte Ressourcen

321</h2>317</h2>

322 318

323* Durchsuchen Sie [Prompting-Muster und Workflows](/de/prompt-library), die mit Artefakten gepaart sind319* Durchsuchen Sie [Prompting-Muster und Workflows](/docs/de/prompt-library), die mit Artefakten gepaart sind

324* Verwandeln Sie einen Artefakt-Prompt, den Sie wiederverwenden, in einen [Skill](/de/skills), damit Sie ihn als Befehl aufrufen können320* Verwandeln Sie einen Artefakt-Prompt, den Sie wiederverwenden, in einen [Skill](/docs/de/skills), damit Sie ihn als Befehl aufrufen können

325* [Verbinden Sie MCP-Server](/de/mcp), damit Claude Daten in ein Artefakt abrufen kann, während es die Seite erstellt321* [Verbinden Sie MCP-Server](/docs/de/mcp), damit Claude Daten in ein Artefakt abrufen kann, während es die Seite erstellt

authentication.md +28 −28

Details

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

13</h2>13</h2>

14 14

15Nach dem [Installieren von Claude Code](/de/setup#install-claude-code) führen Sie `claude` in Ihrem Terminal aus. Beim ersten Start öffnet Claude Code ein Browserfenster, in dem Sie sich anmelden können.15Nach dem [Installieren von Claude Code](/docs/de/setup#install-claude-code) führen Sie `claude` in Ihrem Terminal aus. Beim ersten Start öffnet Claude Code ein Browserfenster, in dem Sie sich anmelden können.

16 16

17Wenn der Browser nicht automatisch geöffnet wird, drücken Sie `c`, um die Anmelde-URL in Ihre Zwischenablage zu kopieren, und fügen Sie sie dann in Ihren Browser ein.17Wenn der Browser nicht automatisch geöffnet wird, drücken Sie `c`, um die Anmelde-URL in Ihre Zwischenablage zu kopieren, und fügen Sie sie dann in Ihren Browser ein.

18 18

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

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

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

28* **Cloud-Anbieter**: Wenn Ihre Organisation [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) verwendet, legen Sie die erforderlichen Umgebungsvariablen fest, bevor Sie `claude` ausführen, oder wählen Sie **3rd-party platform** bei der Anmeldeeingabeaufforderung aus, die einen interaktiven Setup-Assistenten für Bedrock und Vertex AI startet. Es ist keine Browser-Anmeldung erforderlich.28* **Cloud-Anbieter**: Wenn Ihre Organisation [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) oder [Microsoft Foundry](/docs/de/microsoft-foundry) verwendet, legen Sie die erforderlichen Umgebungsvariablen fest, bevor Sie `claude` ausführen, oder wählen Sie **3rd-party platform** bei der Anmeldeeingabeaufforderung aus, die einen interaktiven Setup-Assistenten für Bedrock und Vertex AI startet. Es ist keine Browser-Anmeldung erforderlich.

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

30 30

31Administratoren können die interaktive Anmeldung mit den verwalteten Einstellungen [`forceLoginMethod` und `forceLoginOrgUUID`](/de/settings#available-settings) einschränken. Wenn eine dieser Einstellungen gesetzt ist, werden Sitzungen, die von `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert werden, beim Start blockiert; Cloud-Provider-Sitzungen sind nicht betroffen.31Administratoren können die interaktive Anmeldung mit den verwalteten Einstellungen [`forceLoginMethod` und `forceLoginOrgUUID`](/docs/de/settings#available-settings) einschränken. Wenn eine dieser Einstellungen gesetzt ist, werden Sitzungen, die von `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert werden, beim Start blockiert; Cloud-Provider-Sitzungen sind nicht betroffen.

32 32

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

34 34

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

36 36

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

38 Richten Sie die Team-Authentifizierung ein38 Richten Sie die Team-Authentifizierung ein

42 42

43* [Claude for Teams oder Enterprise](#claude-for-teams-or-enterprise), empfohlen für die meisten Teams43* [Claude for Teams oder Enterprise](#claude-for-teams-or-enterprise), empfohlen für die meisten Teams

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

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

~~46* [Amazon Bedrock](/de/amazon-bedrock)~~46* [Amazon Bedrock](/docs/de/amazon-bedrock)

~~47* [Google Cloud's Agent Platform](/de/google-vertex-ai)~~47* [Google Cloud's Agent Platform](/docs/de/google-vertex-ai)

~~48* [Microsoft Foundry](/de/microsoft-foundry)~~48* [Microsoft Foundry](/docs/de/microsoft-foundry)

49 49

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

51 Claude for Teams oder Enterprise51 Claude for Teams oder Enterprise

99 Jeder eingeladene Benutzer muss:99 Jeder eingeladene Benutzer muss:

100 100

101 * Die Console-Einladung akzeptieren101 * Die Console-Einladung akzeptieren

102 * [Systemanforderungen überprüfen](/de/setup#system-requirements)102 * [Systemanforderungen überprüfen](/docs/de/setup#system-requirements)

103 * [Claude Code installieren](/de/setup#install-claude-code)103 * [Claude Code installieren](/docs/de/setup#install-claude-code)

104 * Sich mit Console-Kontoanmeldedaten anmelden104 * Sich mit Console-Kontoanmeldedaten anmelden

105 </Step>105 </Step>

106</Steps>106</Steps>

113 113

114<Steps>114<Steps>

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

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

117 </Step>117 </Step>

118 118

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

120 Verteilen Sie die Umgebungsvariablen und Anweisungen zum Generieren von Cloud-Anmeldedaten an Ihre Benutzer. Lesen Sie mehr darüber, wie Sie [die Konfiguration hier verwalten](/de/settings).120 Verteilen Sie die Umgebungsvariablen und Anweisungen zum Generieren von Cloud-Anmeldedaten an Ihre Benutzer. Lesen Sie mehr darüber, wie Sie [die Konfiguration hier verwalten](/docs/de/settings).

121 </Step>121 </Step>

122 122

123 <Step title="Installieren Sie Claude Code">123 <Step title="Installieren Sie Claude Code">

124 Benutzer können [Claude Code installieren](/de/setup#install-claude-code).124 Benutzer können [Claude Code installieren](/docs/de/setup#install-claude-code).

125 </Step>125 </Step>

126</Steps>126</Steps>

127 127

136 * Auf Linux werden Anmeldedaten in `~/.claude/.credentials.json` mit Dateimodus `0600` gespeichert.136 * Auf Linux werden Anmeldedaten in `~/.claude/.credentials.json` mit Dateimodus `0600` gespeichert.

137 * Unter Windows werden Anmeldedaten in `%USERPROFILE%\.claude\.credentials.json` gespeichert und erben die Zugriffskontrolle Ihres Benutzerprofilverzeichnisses, das die Datei standardmäßig auf Ihr Benutzerkonto beschränkt.137 * Unter Windows werden Anmeldedaten in `%USERPROFILE%\.claude\.credentials.json` gespeichert und erben die Zugriffskontrolle Ihres Benutzerprofilverzeichnisses, das die Datei standardmäßig auf Ihr Benutzerkonto beschränkt.

138 * Wenn Sie die Umgebungsvariable `CLAUDE_CONFIG_DIR` unter Linux oder Windows gesetzt haben, befindet sich die Datei `.credentials.json` stattdessen in diesem Verzeichnis.138 * Wenn Sie die Umgebungsvariable `CLAUDE_CONFIG_DIR` unter Linux oder Windows gesetzt haben, befindet sich die Datei `.credentials.json` stattdessen in diesem Verzeichnis.

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

140* **Unterstützte Authentifizierungstypen**: Claude.ai-Anmeldedaten, Claude API-Anmeldedaten, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth und [Claude Apps Gateway](/de/claude-apps-gateway) Sitzungs-Tokens.140* **Unterstützte Authentifizierungstypen**: Claude.ai-Anmeldedaten, Claude API-Anmeldedaten, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth und [Claude Apps Gateway](/docs/de/claude-apps-gateway) Sitzungs-Tokens.

141* **Benutzerdefinierte Anmeldedaten-Skripte**: Die Einstellung [`apiKeyHelper`](/de/settings#available-settings) kann so konfiguriert werden, dass ein Shell-Skript ausgeführt wird, das einen API-Schlüssel zurückgibt.141* **Benutzerdefinierte Anmeldedaten-Skripte**: Die Einstellung [`apiKeyHelper`](/docs/de/settings#available-settings) kann so konfiguriert werden, dass ein Shell-Skript ausgeführt wird, das einen API-Schlüssel zurückgibt.

142* **Aktualisierungsintervalle**: Standardmäßig wird `apiKeyHelper` nach 5 Minuten oder bei HTTP 401-Antwort aufgerufen. Legen Sie die Umgebungsvariable `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` für benutzerdefinierte Aktualisierungsintervalle fest.142* **Aktualisierungsintervalle**: Standardmäßig wird `apiKeyHelper` nach 5 Minuten oder bei HTTP 401-Antwort aufgerufen. Legen Sie die Umgebungsvariable `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` für benutzerdefinierte Aktualisierungsintervalle fest.

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

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

145 145

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

147 147

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

149 Ablauf einer Anmeldung erneuern149 Ablauf einer Anmeldung erneuern

153 153

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

155 155

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

157 157

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

159 159

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

161 161

162<h3 id="authentication-precedence">162<h3 id="authentication-precedence">

163 Authentifizierungspriorität163 Authentifizierungspriorität

165 165

166Wenn mehrere Anmeldedaten vorhanden sind, wählt Claude Code eines in dieser Reihenfolge:166Wenn mehrere Anmeldedaten vorhanden sind, wählt Claude Code eines in dieser Reihenfolge:

167 167

1681. Cloud-Anbieter-Anmeldedaten, wenn `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` oder `CLAUDE_CODE_USE_FOUNDRY` gesetzt ist. Siehe [Integrationen von Drittanbietern](/de/third-party-integrations) für die Einrichtung.1681. Cloud-Anbieter-Anmeldedaten, wenn `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` oder `CLAUDE_CODE_USE_FOUNDRY` gesetzt ist. Siehe [Integrationen von Drittanbietern](/docs/de/third-party-integrations) für die Einrichtung.

1692. `ANTHROPIC_AUTH_TOKEN` Umgebungsvariable. Wird als `Authorization: Bearer` Header gesendet. Verwenden Sie dies, wenn Sie durch ein [LLM-Gateway oder einen Proxy](/de/llm-gateway) leiten, das sich mit Bearer-Tokens anstelle von Anthropic API-Schlüsseln authentifiziert.1692. `ANTHROPIC_AUTH_TOKEN` Umgebungsvariable. Wird als `Authorization: Bearer` Header gesendet. Verwenden Sie dies, wenn Sie durch ein [LLM-Gateway oder einen Proxy](/docs/de/llm-gateway) leiten, das sich mit Bearer-Tokens anstelle von Anthropic API-Schlüsseln authentifiziert.

1703. `ANTHROPIC_API_KEY` Umgebungsvariable. Wird als `X-Api-Key` Header gesendet. Verwenden Sie dies für direkten Anthropic API-Zugriff mit einem Schlüssel aus der [Claude Console](https://platform.claude.com). Im interaktiven Modus werden Sie einmal aufgefordert, den Schlüssel zu genehmigen oder abzulehnen, und Ihre Wahl wird gespeichert. Um dies später zu ändern, verwenden Sie den Umschalter „Use custom API key" in `/config`. Der Umschalter wird nur angezeigt, während `ANTHROPIC_API_KEY` in Ihrer Umgebung gesetzt ist. Im nicht-interaktiven Modus (`-p`) wird der Schlüssel immer verwendet, wenn er vorhanden ist.1703. `ANTHROPIC_API_KEY` Umgebungsvariable. Wird als `X-Api-Key` Header gesendet. Verwenden Sie dies für direkten Anthropic API-Zugriff mit einem Schlüssel aus der [Claude Console](https://platform.claude.com). Im interaktiven Modus werden Sie einmal aufgefordert, den Schlüssel zu genehmigen oder abzulehnen, und Ihre Wahl wird gespeichert. Um dies später zu ändern, verwenden Sie den Umschalter „Use custom API key" in `/config`. Der Umschalter wird nur angezeigt, während `ANTHROPIC_API_KEY` in Ihrer Umgebung gesetzt ist. Im nicht-interaktiven Modus (`-p`) wird der Schlüssel immer verwendet, wenn er vorhanden ist.

1714. [`apiKeyHelper`](/de/settings#available-settings) Skriptausgabe. Verwenden Sie dies für dynamische oder rotierende Anmeldedaten, wie kurzlebige Tokens, die aus einem Vault abgerufen werden.1714. [`apiKeyHelper`](/docs/de/settings#available-settings) Skriptausgabe. Verwenden Sie dies für dynamische oder rotierende Anmeldedaten, wie kurzlebige Tokens, die aus einem Vault abgerufen werden.

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

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

174 174

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

176 176

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

178 178

179[Claude Code im Web](/de/claude-code-on-the-web) verwendet immer Ihre Abonnement-Anmeldedaten. Wenn Sie `ANTHROPIC_API_KEY` oder `ANTHROPIC_AUTH_TOKEN` in der Sandbox-Umgebung gesetzt haben, überschreiben diese nicht Ihre Abonnement-Anmeldedaten.179[Claude Code im Web](/docs/de/claude-code-on-the-web) verwendet immer Ihre Abonnement-Anmeldedaten. Wenn Sie `ANTHROPIC_API_KEY` oder `ANTHROPIC_AUTH_TOKEN` in der Sandbox-Umgebung gesetzt haben, überschreiben diese nicht Ihre Abonnement-Anmeldedaten.

180 180

181<h3 id="generate-a-long-lived-token">181<h3 id="generate-a-long-lived-token">

182 Generieren Sie ein langlebiges Token182 Generieren Sie ein langlebiges Token

194export CLAUDE_CODE_OAUTH_TOKEN=your-token194export CLAUDE_CODE_OAUTH_TOKEN=your-token

195```195```

196 196

197Dieses Token authentifiziert sich mit Ihrem Claude-Abonnement und erfordert einen Pro-, Max-, Team- oder Enterprise-Plan. Es ist auf Inferenz beschränkt und kann keine [Remote Control](/de/remote-control) Sitzungen einrichten.197Dieses Token authentifiziert sich mit Ihrem Claude-Abonnement und erfordert einen Pro-, Max-, Team- oder Enterprise-Plan. Es ist auf Inferenz beschränkt und kann keine [Remote Control](/docs/de/remote-control) Sitzungen einrichten.

198 198

199[Bare Mode](/de/headless#start-faster-with-bare-mode) liest `CLAUDE_CODE_OAUTH_TOKEN` nicht. Wenn Ihr Skript `--bare` übergibt, authentifizieren Sie sich stattdessen mit `ANTHROPIC_API_KEY` oder einem `apiKeyHelper`.199[Bare Mode](/docs/de/headless#start-faster-with-bare-mode) liest `CLAUDE_CODE_OAUTH_TOKEN` nicht. Wenn Ihr Skript `--bare` übergibt, authentifizieren Sie sich stattdessen mit `ANTHROPIC_API_KEY` oder einem `apiKeyHelper`.

auto-mode-config.md +18 −18

Details

6 6

7> Teilen Sie dem Auto-Modus-Klassifizierer mit, welche Repos, Buckets und Domains Ihre Organisation vertraut. Legen Sie den Umgebungskontext fest, überschreiben Sie die Standard-Block- und Allow-Regeln, und überprüfen Sie Ihre effektive Konfiguration mit den Auto-Modus-CLI-Unterbefehlen.7> Teilen Sie dem Auto-Modus-Klassifizierer mit, welche Repos, Buckets und Domains Ihre Organisation vertraut. Legen Sie den Umgebungskontext fest, überschreiben Sie die Standard-Block- und Allow-Regeln, und überprüfen Sie Ihre effektive Konfiguration mit den Auto-Modus-CLI-Unterbefehlen.

8 8

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

10 10

11<Note>11<Note>

12 Auto-Modus ist für alle Benutzer auf jedem Anbieter verfügbar, einschließlich der Anthropic API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeter [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzungen. Wenn Claude Code Auto-Modus als nicht verfügbar für Ihr Konto meldet, überprüfen Sie die [vollständigen Anforderungen](/de/permission-modes#eliminate-prompts-with-auto-mode), die auch die unterstützten Modelle und die Owner-Aktivierung in Team- und Enterprise-Plänen abdecken. {/* min-version: 2.1.207 */}In v2.1.158 bis v2.1.206 erforderte Auto-Modus auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Apps Gateway-Sitzungen das Setzen von `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 entfernte die Anforderung.12 Auto-Modus ist für alle Benutzer auf jedem Anbieter verfügbar, einschließlich der Anthropic API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeter [Claude Apps Gateway](/docs/de/claude-apps-gateway)-Sitzungen. Wenn Claude Code Auto-Modus als nicht verfügbar für Ihr Konto meldet, überprüfen Sie die [vollständigen Anforderungen](/docs/de/permission-modes#eliminate-prompts-with-auto-mode), die auch die unterstützten Modelle und die Owner-Aktivierung in Team- und Enterprise-Plänen abdecken. In v2.1.158 bis v2.1.206 erforderte Auto-Modus auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Apps Gateway-Sitzungen das Setzen von `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 entfernte die Anforderung.

13</Note>13</Note>

14 14

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

16 16

17Informationen zum Aktivieren des Auto-Modus und was er standardmäßig blockiert, finden Sie unter [Berechtigungsmodi](/de/permission-modes#eliminate-prompts-with-auto-mode). Diese Seite ist die Konfigurationsreferenz.17Informationen zum Aktivieren des Auto-Modus und was er standardmäßig blockiert, finden Sie unter [Berechtigungsmodi](/docs/de/permission-modes#eliminate-prompts-with-auto-mode). Diese Seite ist die Konfigurationsreferenz.

18 18

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

20 20

32 32

33Der Auto-Modus ermöglicht standardmäßig Pushes zu Ihrem Arbeitszweig, regelmäßige Pushes zum Standard-Repository-Zweig und die Erstellung von Pull Requests. Der Klassifizierer blockiert einen Push nur, wenn dieser ein Risiko birgt, z. B. ein Force Push oder Inhalte, die eine von Ihnen eingerichtete Überprüfung umgehen. Wenn Sie vor jedem Push oder Pull Request einen menschlichen Checkpoint wünschen, fügen Sie Berechtigungsregeln hinzu: Die folgenden Rezepte halten den Auto-Modus für alles andere aktiviert.33Der Auto-Modus ermöglicht standardmäßig Pushes zu Ihrem Arbeitszweig, regelmäßige Pushes zum Standard-Repository-Zweig und die Erstellung von Pull Requests. Der Klassifizierer blockiert einen Push nur, wenn dieser ein Risiko birgt, z. B. ein Force Push oder Inhalte, die eine von Ihnen eingerichtete Überprüfung umgehen. Wenn Sie vor jedem Push oder Pull Request einen menschlichen Checkpoint wünschen, fügen Sie Berechtigungsregeln hinzu: Die folgenden Rezepte halten den Auto-Modus für alles andere aktiviert.

34 34

35Der direkteste Mechanismus ist [`permissions.ask`](/de/permissions#permission-rule-syntax). Inhaltsgebundene Ask-Regeln wie die folgenden werden vor dem Klassifizierer ausgewertet und erzwingen immer eine Berechtigungsaufforderung, auch im Auto-Modus, da eine explizite Ask-Regel Ihre ausdrückliche Absicht ist, für diese Aktion aufgefordert zu werden. Fügen Sie die Regeln in Ihren [Einstellungen](/de/settings#settings-files) hinzu:35Der direkteste Mechanismus ist [`permissions.ask`](/docs/de/permissions#permission-rule-syntax). Inhaltsgebundene Ask-Regeln wie die folgenden werden vor dem Klassifizierer ausgewertet und erzwingen immer eine Berechtigungsaufforderung, auch im Auto-Modus, da eine explizite Ask-Regel Ihre ausdrückliche Absicht ist, für diese Aktion aufgefordert zu werden. Fügen Sie die Regeln in Ihren [Einstellungen](/docs/de/settings#settings-files) hinzu:

36 36

37```json theme={null}37```json theme={null}

38{38{

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

52| Aufforderung vor der Aktion | `permissions.ask` | Fordert immer für inhaltsgebundene Regeln wie das obige Rezept auf. Der Klassifizierer kann eine übereinstimmende Aktion nicht automatisch genehmigen. |52| Aufforderung vor der Aktion | `permissions.ask` | Fordert immer für inhaltsgebundene Regeln wie das obige Rezept auf. Der Klassifizierer kann eine übereinstimmende Aktion nicht automatisch genehmigen. |

53| Aktion niemals ausführen | `permissions.deny` | Blockiert, bevor der Klassifizierer konsultiert wird. Weder der Klassifizierer noch die Benutzerabsicht können dies überschreiben. |53| Aktion niemals ausführen | `permissions.deny` | Blockiert, bevor der Klassifizierer konsultiert wird. Weder der Klassifizierer noch die Benutzerabsicht können dies überschreiben. |

54| Einmalige Grenze für diese Sitzung | Geben Sie es im Gespräch an, z. B. „nicht pushen, bis ich überprüft habe" | Der Klassifizierer blockiert übereinstimmende Aktionen, aber die Grenze kann verloren gehen, wenn die [Kontext-Komprimierung](/de/costs#reduce-token-usage) die Nachricht entfernt, die sie angegeben hat. Verwenden Sie eine Ask- oder Deny-Regel für eine dauerhafte Garantie. |54| Einmalige Grenze für diese Sitzung | Geben Sie es im Gespräch an, z. B. „nicht pushen, bis ich überprüft habe" | Der Klassifizierer blockiert übereinstimmende Aktionen, aber die Grenze kann verloren gehen, wenn die [Kontext-Komprimierung](/docs/de/costs#reduce-token-usage) die Nachricht entfernt, die sie angegeben hat. Verwenden Sie eine Ask- oder Deny-Regel für eine dauerhafte Garantie. |

55 55

56<h2 id="where-the-classifier-reads-configuration">56<h2 id="where-the-classifier-reads-configuration">

57 Wo der Klassifizierer die Konfiguration liest57 Wo der Klassifizierer die Konfiguration liest

58</h2>58</h2>

59 59

60Der Klassifizierer liest denselben [CLAUDE.md](/de/memory)-Inhalt, den Claude selbst lädt, sodass eine Anweisung wie „niemals force push" in der CLAUDE.md deines Projekts sowohl Claude als auch den Klassifizierer gleichzeitig steuert. Beginne dort mit Projektkonventionen und Verhaltensregeln.60Der Klassifizierer liest denselben [CLAUDE.md](/docs/de/memory)-Inhalt, den Claude selbst lädt, sodass eine Anweisung wie „niemals force push" in der CLAUDE.md deines Projekts sowohl Claude als auch den Klassifizierer gleichzeitig steuert. Beginne dort mit Projektkonventionen und Verhaltensregeln.

61 61

62Für Regeln, die projektübergreifend gelten, wie vertrauenswürdige Infrastruktur oder organisationsweite Ablehnungsregeln, verwende den `autoMode`-Einstellungsblock. Der Klassifizierer liest `autoMode` aus den folgenden Bereichen:62Für Regeln, die projektübergreifend gelten, wie vertrauenswürdige Infrastruktur oder organisationsweite Ablehnungsregeln, verwende den `autoMode`-Einstellungsblock. Der Klassifizierer liest `autoMode` aus den folgenden Bereichen:

63 63

65| :------------------------------- | :------------------------------------------------------ | :-------------------------------------------------------------------- |65| :------------------------------- | :------------------------------------------------------ | :-------------------------------------------------------------------- |

69 69

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

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

73 73

74<Note>74<Note>

75 Der Klassifizierer ist ein zweites Gate, das nach dem [Berechtigungssystem](/de/permissions) ausgeführt wird. Für Aktionen, die unabhängig von Benutzerabsicht oder Klassifizierer-Konfiguration niemals ausgeführt werden dürfen, verwende `permissions.deny` in verwalteten Einstellungen, das die Aktion blockiert, bevor der Klassifizierer konsultiert wird, und kann nicht überschrieben werden.75 Der Klassifizierer ist ein zweites Gate, das nach dem [Berechtigungssystem](/docs/de/permissions) ausgeführt wird. Für Aktionen, die unabhängig von Benutzerabsicht oder Klassifizierer-Konfiguration niemals ausgeführt werden dürfen, verwende `permissions.deny` in verwalteten Einstellungen, das die Aktion blockiert, bevor der Klassifizierer konsultiert wird, und kann nicht überschrieben werden.

76</Note>76</Note>

77 77

78<h2 id="define-trusted-infrastructure">78<h2 id="define-trusted-infrastructure">

87 * **Organisation**87 * **Organisation**

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

89 * **Cloud-Anbieter**89 * **Cloud-Anbieter**

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

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

92 * **Organisationsspezifische CLIs**92 * **Organisationsspezifische CLIs**

93 * **Secrets-Verwaltung**93 * **Secrets-Verwaltung**

96 * **Netzwerk-Lage**96 * **Netzwerk-Lage**

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

98 * **Datenspeicherung / Klassifizierungsaufhebung**98 * **Datenspeicherung / Klassifizierungsaufhebung**

99* **Vertrauens-Slots**: benennen, was der Klassifizierer als innerhalb Ihrer Grenze behandelt. Die Slots sind Vertrauenswürdiges Repo, Quellcode-Verwaltung, Vertrauenswürdige interne Domains, Vertrauenswürdige Cloud-Buckets, Wichtige interne Services und Interne Paket-Registry. Die Repo- und Quellcode-Verwaltungseinträge werden standardmäßig auf das Arbeits-Repo und seine konfigurierten Remotes gesetzt. Jeder andere Vertrauens-Slot wird standardmäßig auf `Keine konfiguriert` gesetzt, daher wird nichts anderes vertraut, bis Sie es hinzufügen. {/* min-version: 2.1.203 */}Die Sichtbarkeit eines Repositorys bezieht sich nur auf vertrauliches Material: Ein privates Repository ist ein akzeptables Ziel für vertrauliches Material, aber das Privatmachen eines Repositorys löscht niemals Geheimnisse oder persönliche oder anvertraute Daten darin, und der Klassifizierer behandelt Inhalte, die von außerhalb des Arbeits-Repositorys portiert, umgeleitet oder zuerst gelesen werden, als nicht die eigene Arbeit dieses Repositorys. Diese Scoping-Anforderung erfordert Claude Code v2.1.203 oder später.99* **Vertrauens-Slots**: benennen, was der Klassifizierer als innerhalb Ihrer Grenze behandelt. Die Slots sind Vertrauenswürdiges Repo, Quellcode-Verwaltung, Vertrauenswürdige interne Domains, Vertrauenswürdige Cloud-Buckets, Wichtige interne Services und Interne Paket-Registry. Die Repo- und Quellcode-Verwaltungseinträge werden standardmäßig auf das Arbeits-Repo und seine konfigurierten Remotes gesetzt. Jeder andere Vertrauens-Slot wird standardmäßig auf `Keine konfiguriert` gesetzt, daher wird nichts anderes vertraut, bis Sie es hinzufügen. Die Sichtbarkeit eines Repositorys bezieht sich nur auf vertrauliches Material: Ein privates Repository ist ein akzeptables Ziel für vertrauliches Material, aber das Privatmachen eines Repositorys löscht niemals Geheimnisse oder persönliche oder anvertraute Daten darin, und der Klassifizierer behandelt Inhalte, die von außerhalb des Arbeits-Repositorys portiert, umgeleitet oder zuerst gelesen werden, als nicht die eigene Arbeit dieses Repositorys. Diese Scoping-Anforderung erfordert Claude Code v2.1.203 oder später.

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

101 101

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

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

126* **Wichtige interne Services**: CI, Artifact-Registries, interne Paketindizes, Incident-Tools126* **Wichtige interne Services**: CI, Artifact-Registries, interne Paketindizes, Incident-Tools

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

128* **Sensible Datenspeicherorte & Zielgruppen**: die Buckets, Datenbanken oder Pfade, die persönliche Daten, vertrauliche Geschäftsdaten, Anmeldedaten, regulierte Daten oder ähnlich sensibles Material enthalten, und die Zielgruppen, mit denen Daten an jedem Speicherort geteilt werden können, damit der Klassifizierer diese Speicherorte schützt, anstatt aus dem Inhalt zu erraten. {/* min-version: 2.1.195 */}{/* max-version: 2.1.197 */}Claude Code v2.1.195 bis v2.1.197 nennt diesen Eintrag PII / Standorte mit regulierten Daten und deckt nur Speicherorte ab, die persönliche oder regulierte Daten enthalten, ohne die Zielgruppen-Dimension128* **Sensible Datenspeicherorte & Zielgruppen**: die Buckets, Datenbanken oder Pfade, die persönliche Daten, vertrauliche Geschäftsdaten, Anmeldedaten, regulierte Daten oder ähnlich sensibles Material enthalten, und die Zielgruppen, mit denen Daten an jedem Speicherort geteilt werden können, damit der Klassifizierer diese Speicherorte schützt, anstatt aus dem Inhalt zu erraten. Claude Code v2.1.195 bis v2.1.197 nennt diesen Eintrag PII / Standorte mit regulierten Daten und deckt nur Speicherorte ab, die persönliche oder regulierte Daten enthalten, ohne die Zielgruppen-Dimension

129* **Sensible Remote-Ziele**: die Namespaces, Hosts oder Container, die als Produktion zählen, damit Remote-Shells und Port-Forwards in sie Ihre explizite Genehmigung benötigen129* **Sensible Remote-Ziele**: die Namespaces, Hosts oder Container, die als Produktion zählen, damit Remote-Shells und Port-Forwards in sie Ihre explizite Genehmigung benötigen

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

131* **Zusätzlicher Kontext**: Einschränkungen in regulierten Branchen, Multi-Tenant-Infrastruktur oder Compliance-Anforderungen, die beeinflussen, was der Klassifizierer als riskant behandeln sollte131* **Zusätzlicher Kontext**: Einschränkungen in regulierten Branchen, Multi-Tenant-Infrastruktur oder Compliance-Anforderungen, die beeinflussen, was der Klassifizierer als riskant behandeln sollte

165* `autoMode.soft_deny`: destruktive Aktionen, die Benutzerabsicht aufheben kann165* `autoMode.soft_deny`: destruktive Aktionen, die Benutzerabsicht aufheben kann

166* `autoMode.allow`: Ausnahmen zu Soft-Block-Regeln166* `autoMode.allow`: Ausnahmen zu Soft-Block-Regeln

167 167

168Jedes ist ein Array von Prosabeschreibungen, das als natürlichsprachige Regeln gelesen wird. Für werkzeugmuster-basierte harte Blöcke, die vor dem Klassifizierer ausgeführt werden, verwenden Sie [`permissions.deny`](/de/permissions).168Jedes ist ein Array von Prosabeschreibungen, das als natürlichsprachige Regeln gelesen wird. Für werkzeugmuster-basierte harte Blöcke, die vor dem Klassifizierer ausgeführt werden, verwenden Sie [`permissions.deny`](/docs/de/permissions).

169 169

170Innerhalb des Klassifizierers funktioniert die Vorrangigkeit in vier Ebenen:170Innerhalb des Klassifizierers funktioniert die Vorrangigkeit in vier Ebenen:

171 171

254claude auto-mode defaults254claude auto-mode defaults

255```255```

256 256

257{/* min-version: 2.1.208 */}Um die vollständige Formulierung einer Regel ohne Piping durch `jq` zu lesen, übergeben Sie `--label` mit dem Anfang des Regelbezeichners, z. B. `claude auto-mode defaults --label 'Git Destructive'`. Der Abgleich ist ein Präfix ohne Berücksichtigung der Groß-/Kleinschreibung für jeden Regelbezeichner, und Abschnitte ohne Übereinstimmung werden als leere Listen gedruckt. Erfordert Claude Code v2.1.208 oder später.257Um die vollständige Formulierung einer Regel ohne Piping durch `jq` zu lesen, übergeben Sie `--label` mit dem Anfang des Regelbezeichners, z. B. `claude auto-mode defaults --label 'Git Destructive'`. Der Abgleich ist ein Präfix ohne Berücksichtigung der Groß-/Kleinschreibung für jeden Regelbezeichner, und Abschnitte ohne Übereinstimmung werden als leere Listen gedruckt. Erfordert Claude Code v2.1.208 oder später.

258 258

259Drucken Sie, was der Klassifizierer tatsächlich als JSON verwendet, mit Ihren Einstellungen angewendet, wo festgelegt, und Standardwerte andernfalls:259Drucken Sie, was der Klassifizierer tatsächlich als JSON verwendet, mit Ihren Einstellungen angewendet, wo festgelegt, und Standardwerte andernfalls:

260 260

282 282

283Wiederholte Ablehnungen für dasselbe Ziel bedeuten normalerweise, dass dem Klassifizierer der Kontext fehlt. Fügen Sie dieses Ziel zu `autoMode.environment` hinzu, führen Sie dann `claude auto-mode config` aus, um zu bestätigen, dass es wirksam wurde.283Wiederholte Ablehnungen für dasselbe Ziel bedeuten normalerweise, dass dem Klassifizierer der Kontext fehlt. Fügen Sie dieses Ziel zu `autoMode.environment` hinzu, führen Sie dann `claude auto-mode config` aus, um zu bestätigen, dass es wirksam wurde.

284 284

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

286 286

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

288 See also288 See also

289</h2>289</h2>

290 290

291* [Berechtigungsmodi](/de/permission-modes#eliminate-prompts-with-auto-mode): Was Auto-Modus ist, was er standardmäßig blockiert, und wie man ihn aktiviert291* [Berechtigungsmodi](/docs/de/permission-modes#eliminate-prompts-with-auto-mode): Was Auto-Modus ist, was er standardmäßig blockiert, und wie man ihn aktiviert

292* [Verwaltete Einstellungen](/de/server-managed-settings): Stellen Sie die `autoMode`-Konfiguration in Ihrer Organisation bereit292* [Verwaltete Einstellungen](/docs/de/server-managed-settings): Stellen Sie die `autoMode`-Konfiguration in Ihrer Organisation bereit

293* [Berechtigungen](/de/permissions): Allow-, Ask- und Deny-Regeln, die vor dem Klassifizierer gelten293* [Berechtigungen](/docs/de/permissions): Allow-, Ask- und Deny-Regeln, die vor dem Klassifizierer gelten

294* [Einstellungen](/de/settings): Die vollständige Einstellungsreferenz, einschließlich des `autoMode`-Schlüssels294* [Einstellungen](/docs/de/settings): Die vollständige Einstellungsreferenz, einschließlich des `autoMode`-Schlüssels

checkpointing.md +5 −5

Details

21Claude Code verfolgt alle Änderungen, die von seinen Datei-Bearbeitungswerkzeugen vorgenommen werden:21Claude Code verfolgt alle Änderungen, die von seinen Datei-Bearbeitungswerkzeugen vorgenommen werden:

22 22

23* Jede Benutzereingabe erstellt einen neuen Checkpoint23* Jede Benutzereingabe erstellt einen neuen Checkpoint

24* Claude Code behält Datei-Snapshots für die 100 neuesten Checkpoints in einer Sitzung. Das Verwerfen eines älteren Checkpoints löscht die Snapshot-Dateien, auf die kein verbleibender Checkpoint verweist, mit Ausnahme des ersten Snapshots jeder Datei, den die VS Code-Erweiterung als Grundlage für ihre Sitzungs-Diffs verwendet. {/* min-version: 2.1.208 */}Vor v2.1.208 blieben diese ersetzten Snapshot-Dateien auf der Festplatte, bis die Sitzung bereinigt wurde.24* Claude Code behält Datei-Snapshots für die 100 neuesten Checkpoints in einer Sitzung. Das Verwerfen eines älteren Checkpoints löscht die Snapshot-Dateien, auf die kein verbleibender Checkpoint verweist, mit Ausnahme des ersten Snapshots jeder Datei, den die VS Code-Erweiterung als Grundlage für ihre Sitzungs-Diffs verwendet. Vor v2.1.208 blieben diese ersetzten Snapshot-Dateien auf der Festplatte, bis die Sitzung bereinigt wurde.

25* Checkpoints werden mit der Konversation gespeichert, sodass eine fortgesetzte Sitzung immer noch zu ihnen `/rewind` kann25* Checkpoints werden mit der Konversation gespeichert, sodass eine fortgesetzte Sitzung immer noch zu ihnen `/rewind` kann

26* Werden automatisch zusammen mit Sitzungen nach 30 Tagen bereinigt (konfigurierbar)26* Werden automatisch zusammen mit Sitzungen nach 30 Tagen bereinigt (konfigurierbar)

27 27

66In beiden Fällen werden die ursprünglichen Nachrichten im Sitzungstranskript beibehalten, sodass Claude die Details bei Bedarf referenzieren kann. Sie können optionale Anweisungen eingeben, um zu lenken, worauf sich die Zusammenfassung konzentriert. Dies ähnelt `/compact`, ist aber gezielt: Anstatt die gesamte Konversation zusammenzufassen, wählen Sie, welche Seite der ausgewählten Nachricht komprimiert werden soll.66In beiden Fällen werden die ursprünglichen Nachrichten im Sitzungstranskript beibehalten, sodass Claude die Details bei Bedarf referenzieren kann. Sie können optionale Anweisungen eingeben, um zu lenken, worauf sich die Zusammenfassung konzentriert. Dies ähnelt `/compact`, ist aber gezielt: Anstatt die gesamte Konversation zusammenzufassen, wählen Sie, welche Seite der ausgewählten Nachricht komprimiert werden soll.

67 67

68<Note>68<Note>

69 Zusammenfassen hält Sie in derselben Sitzung und komprimiert Kontext. Wenn Sie abzweigen und einen anderen Ansatz versuchen möchten, während Sie die ursprüngliche Sitzung intakt bewahren, verwenden Sie stattdessen [fork](/de/sessions#branch-a-session) (`claude --continue --fork-session`).69 Zusammenfassen hält Sie in derselben Sitzung und komprimiert Kontext. Wenn Sie abzweigen und einen anderen Ansatz versuchen möchten, während Sie die ursprüngliche Sitzung intakt bewahren, verwenden Sie stattdessen [fork](/docs/de/sessions#branch-a-session) (`claude --continue --fork-session`).

70</Note>70</Note>

71 71

72<h2 id="common-use-cases">72<h2 id="common-use-cases">

118 Siehe auch118 Siehe auch

119</h2>119</h2>

120 120

121* [Interaktiver Modus](/de/interactive-mode) - Tastaturkürzel und Sitzungssteuerungen121* [Interaktiver Modus](/docs/de/interactive-mode) - Tastaturkürzel und Sitzungssteuerungen

122* [Befehle](/de/commands) - Zugriff auf Checkpoints mit `/rewind`122* [Befehle](/docs/de/commands) - Zugriff auf Checkpoints mit `/rewind`

123* [CLI-Referenz](/de/cli-reference) - Befehlszeilenoptionen123* [CLI-Referenz](/docs/de/cli-reference) - Befehlszeilenoptionen

claude-apps-gateway.md +5 −5

Details

64<Note>64<Note>

65 **Bereitstellung in Ihrem privaten Netzwerk.** Claude Code verbindet sich nur mit einem Gateway, dessen Adresse privat ist. Dies ist eine Sicherheitsmaßnahme, da ein vertrauenswürdiges Gateway Einstellungen pushen kann, die Befehle auf Entwicklermaschinen ausführen. Platzieren Sie das Gateway hinter einem internen Load Balancer oder VPN und geben Sie ihm einen Hostnamen, der nur zu privaten IPs aufgelöst wird.65 **Bereitstellung in Ihrem privaten Netzwerk.** Claude Code verbindet sich nur mit einem Gateway, dessen Adresse privat ist. Dies ist eine Sicherheitsmaßnahme, da ein vertrauenswürdiges Gateway Einstellungen pushen kann, die Befehle auf Entwicklermaschinen ausführen. Platzieren Sie das Gateway hinter einem internen Load Balancer oder VPN und geben Sie ihm einen Hostnamen, der nur zu privaten IPs aufgelöst wird.

66 66

67 Anthropic-betriebene öffentliche Gateway-Endpunkte sind die Ausnahme: `/login` akzeptiert sie über `https://`. Dies ist eine kleine feste Menge von Gateways, die Anthropic selbst betreibt; sie sind keine Bereitstellungsoption, die Sie auswählen oder konfigurieren können. Die Liste ist in Claude Code kompiliert, daher kann keine Konfiguration einen Hostnamen hinzufügen und kein von Ihnen gehostetes Gateway qualifiziert sich für die Ausnahme. {/* min-version: 2.1.206 */}Vor v2.1.206 lehnte `/login` diese Endpunkte wie jede andere öffentliche Adresse ab.67 Anthropic-betriebene öffentliche Gateway-Endpunkte sind die Ausnahme: `/login` akzeptiert sie über `https://`. Dies ist eine kleine feste Menge von Gateways, die Anthropic selbst betreibt; sie sind keine Bereitstellungsoption, die Sie auswählen oder konfigurieren können. Die Liste ist in Claude Code kompiliert, daher kann keine Konfiguration einen Hostnamen hinzufügen und kein von Ihnen gehostetes Gateway qualifiziert sich für die Ausnahme. Vor v2.1.206 lehnte `/login` diese Endpunkte wie jede andere öffentliche Adresse ab.

68</Note>68</Note>

69 69

70<h3 id="prerequisites">70<h3 id="prerequisites">

74Haben Sie diese vor dem Start bereit:74Haben Sie diese vor dem Start bereit:

75 75

77| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |77| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

78| Claude Code v2.1.195 oder später | Der `claude gateway`-Unterbefehl und der Gateway-Anmeldungsfluss werden in v2.1.195 ausgeliefert. Frühere öffentliche Builds enthalten sie nicht. Sowohl die Maschine, auf der der Gateway-Server läuft, als auch die Maschine jedes Entwicklers müssen v2.1.195 oder später sein; führen Sie `claude update` aus, um die neueste Version zu erhalten. {/* min-version: 2.1.198 */}Die [Claude Platform auf AWS Upstream](/docs/de/claude-apps-gateway-config#claude-platform-on-aws) erfordert Claude Code v2.1.198 oder später auf dem Gateway-Server. |78| Claude Code v2.1.195 oder später | Der `claude gateway`-Unterbefehl und der Gateway-Anmeldungsfluss werden in v2.1.195 ausgeliefert. Frühere öffentliche Builds enthalten sie nicht. Sowohl die Maschine, auf der der Gateway-Server läuft, als auch die Maschine jedes Entwicklers müssen v2.1.195 oder später sein; führen Sie `claude update` aus, um die neueste Version zu erhalten. Die [Claude Platform auf AWS Upstream](/docs/de/claude-apps-gateway-config#claude-platform-on-aws) erfordert Claude Code v2.1.198 oder später auf dem Gateway-Server. |

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

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

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

82| HTTPS | Das Gateway muss über `https://` von Entwickler-Laptops und von jedem Browser, der für die Anmeldung verwendet wird, erreichbar sein; das Gateway bedient die Geräteüberprüfungsseite auf dem gleichen Listener. Stellen Sie entweder ein TLS-Zertifikat über `listen.tls` bereit, oder führen Sie hinter einem TLS-terminierenden Ingress aus und setzen Sie `listen.public_url`. Ein einfacher `http://`-Ursprung wird nur auf Loopback für lokale Entwicklung akzeptiert. |82| HTTPS | Das Gateway muss über `https://` von Entwickler-Laptops und von jedem Browser, der für die Anmeldung verwendet wird, erreichbar sein; das Gateway bedient die Geräteüberprüfungsseite auf dem gleichen Listener. Stellen Sie entweder ein TLS-Zertifikat über `listen.tls` bereit, oder führen Sie hinter einem TLS-terminierenden Ingress aus und setzen Sie `listen.public_url`. Ein einfacher `http://`-Ursprung wird nur auf Loopback für lokale Entwicklung akzeptiert. |

83| Private-Netzwerk-Adresse | Bei `/login` erfordert Claude Code, dass der Hostname oder die IP-Adresse des Gateways nur zu privaten Adressen aufgelöst wird: RFC 1918, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` oder Loopback für lokale Entwicklung. Die Überprüfung wird auf jeder aufgelösten IP ausgeführt, daher lehnt `/login` die URL ab, wenn eine Adresse, zu der der Name aufgelöst wird, öffentlich ist. Wenn Entwicklermaschinen HTTPS über einen Unternehmens-Proxy leiten, erfordert die Anmeldung auch, dass der Proxy-Host zu privaten Adressen aufgelöst wird; wenn nicht, fügen Sie den Gateway-Host zu `NO_PROXY` hinzu, damit die CLI direkt verbunden wird. {/* min-version: 2.1.206 */}Anthropic-betriebene öffentliche Gateway-Endpunkte sind von den Überprüfungen für private Adressen und Proxys ausgenommen: `/login` akzeptiert sie über `https://` durch exakte Hostname-Übereinstimmung, daher gilt die Private-Netzwerk-Anforderung nur für ein von Ihnen selbst gehostetes Gateway. Vor v2.1.206 lehnte `/login` einen Anthropic-betriebenen Endpunkt wie jede andere öffentliche Adresse ab. |83| Private-Netzwerk-Adresse | Bei `/login` erfordert Claude Code, dass der Hostname oder die IP-Adresse des Gateways nur zu privaten Adressen aufgelöst wird: RFC 1918, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` oder Loopback für lokale Entwicklung. Die Überprüfung wird auf jeder aufgelösten IP ausgeführt, daher lehnt `/login` die URL ab, wenn eine Adresse, zu der der Name aufgelöst wird, öffentlich ist. Wenn Entwicklermaschinen HTTPS über einen Unternehmens-Proxy leiten, erfordert die Anmeldung auch, dass der Proxy-Host zu privaten Adressen aufgelöst wird; wenn nicht, fügen Sie den Gateway-Host zu `NO_PROXY` hinzu, damit die CLI direkt verbunden wird. Anthropic-betriebene öffentliche Gateway-Endpunkte sind von den Überprüfungen für private Adressen und Proxys ausgenommen: `/login` akzeptiert sie über `https://` durch exakte Hostname-Übereinstimmung, daher gilt die Private-Netzwerk-Anforderung nur für ein von Ihnen selbst gehostetes Gateway. Vor v2.1.206 lehnte `/login` einen Anthropic-betriebenen Endpunkt wie jede andere öffentliche Adresse ab. |

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

85 85

86Der Gateway-Server erfordert die native `claude`-Binärdatei; laden Sie eine angeheftete Version wie in [Claude Code installieren](/docs/de/setup) beschrieben herunter. Der Server verwendet Laufzeitfunktionen, die nicht verfügbar sind, wenn Claude Code unter Node ausgeführt wird. Wenn Sie `requires the native binary` beim Start sehen, wechseln Sie zu einer der eigenständigen Installationsmethoden.86Der Gateway-Server erfordert die native `claude`-Binärdatei; laden Sie eine angeheftete Version wie in [Claude Code installieren](/docs/de/setup) beschrieben herunter. Der Server verwendet Laufzeitfunktionen, die nicht verfügbar sind, wenn Claude Code unter Node ausgeführt wird. Wenn Sie `requires the native binary` beim Start sehen, wechseln Sie zu einer der eigenständigen Installationsmethoden.

330| Serverseitige Websuche | Nicht verfügbar | Die CLI kann nicht sehen, welchen Upstream-Anbieter das Gateway leitet, daher kann sie Websuche-Unterstützung nicht überprüfen und deaktiviert WebSearch auf Gateway-Sitzungen |330| Serverseitige Websuche | Nicht verfügbar | Die CLI kann nicht sehen, welchen Upstream-Anbieter das Gateway leitet, daher kann sie Websuche-Unterstützung nicht überprüfen und deaktiviert WebSearch auf Gateway-Sitzungen |

332| 1-Stunden-Cache-TTL | Nicht verfügbar | Die CLI lässt die Extended-Cache-TTL-Beta auf Gateway-Sitzungen aus, da nicht jeder Upstream, zu dem das Gateway leiten kann, die 1-Stunden-TTL unterstützt, daher verwendet Prompt-Caching über das Gateway die 5-Minuten-TTL; siehe die Beta-Header-Notiz oben |332| 1-Stunden-Cache-TTL | Nicht verfügbar | Die CLI lässt die Extended-Cache-TTL-Beta auf Gateway-Sitzungen aus, da nicht jeder Upstream, zu dem das Gateway leiten kann, die 1-Stunden-TTL unterstützt, daher verwendet Prompt-Caching über das Gateway die 5-Minuten-TTL; siehe die Beta-Header-Notiz oben |

333| Auto-Modus | Verfügbar | Folgt den [Regeln für Drittanbieter-Anbieter](/docs/de/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry): Nur die Modelle, die auf Drittanbieter-Anbietern berechtigt sind, können es verwenden. {/* min-version: 2.1.207 */}Vor v2.1.207 erforderte Auto-Modus auf Gateway-Sitzungen das Setzen von `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, lieferbar über den verwalteten Richtlinien-`env`-Block |333| Auto-Modus | Verfügbar | Folgt den [Regeln für Drittanbieter-Anbieter](/docs/de/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry): Nur die Modelle, die auf Drittanbieter-Anbietern berechtigt sind, können es verwenden. Vor v2.1.207 erforderte Auto-Modus auf Gateway-Sitzungen das Setzen von `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, lieferbar über den verwalteten Richtlinien-`env`-Block |

334| First-Party-Only-Optimierungen wie globaler Cache-Umfang und Token-effiziente Tools | Nicht verfügbar | Die CLI aktiviert sie nicht auf Gateway-Sitzungen; siehe die Beta-Header-Notiz oben |334| First-Party-Only-Optimierungen wie globaler Cache-Umfang und Token-effiziente Tools | Nicht verfügbar | Die CLI aktiviert sie nicht auf Gateway-Sitzungen; siehe die Beta-Header-Notiz oben |

claude-apps-gateway-deploy.md +3 −3

Details

20<Note>20<Note>

21 **Stellen Sie auf Ihrem privaten Netzwerk bereit.** Claude Code stellt nur eine Verbindung zu einem Gateway her, dessen Adresse privat ist. Dies ist eine Sicherheitsmaßnahme, da ein vertrauenswürdiges Gateway Einstellungen pushen kann, die Befehle auf Entwicklermaschinen ausführen. Platzieren Sie das Gateway hinter einem internen Load Balancer oder VPN und geben Sie ihm einen Hostnamen, der nur zu privaten IPs aufgelöst wird.21 **Stellen Sie auf Ihrem privaten Netzwerk bereit.** Claude Code stellt nur eine Verbindung zu einem Gateway her, dessen Adresse privat ist. Dies ist eine Sicherheitsmaßnahme, da ein vertrauenswürdiges Gateway Einstellungen pushen kann, die Befehle auf Entwicklermaschinen ausführen. Platzieren Sie das Gateway hinter einem internen Load Balancer oder VPN und geben Sie ihm einen Hostnamen, der nur zu privaten IPs aufgelöst wird.

22 22

23 Anthropic-betriebene öffentliche Gateway-Endpunkte sind die Ausnahme: `/login` akzeptiert sie über `https://`. Dies ist eine kleine feste Menge von Gateways, die Anthropic selbst betreibt; sie sind keine Bereitstellungsoption, die Sie auswählen oder konfigurieren können. Die Liste ist in Claude Code kompiliert, daher kann keine Konfiguration einen Hostnamen hinzufügen und kein von Ihnen gehostetes Gateway qualifiziert sich für die Ausnahme. {/* min-version: 2.1.206 */}Vor v2.1.206 lehnte `/login` diese Endpunkte wie jede andere öffentliche Adresse ab.23 Anthropic-betriebene öffentliche Gateway-Endpunkte sind die Ausnahme: `/login` akzeptiert sie über `https://`. Dies ist eine kleine feste Menge von Gateways, die Anthropic selbst betreibt; sie sind keine Bereitstellungsoption, die Sie auswählen oder konfigurieren können. Die Liste ist in Claude Code kompiliert, daher kann keine Konfiguration einen Hostnamen hinzufügen und kein von Ihnen gehostetes Gateway qualifiziert sich für die Ausnahme. Vor v2.1.206 lehnte `/login` diese Endpunkte wie jede andere öffentliche Adresse ab.

24</Note>24</Note>

25 25

26<h2 id="identity-provider-setup">26<h2 id="identity-provider-setup">

275Die Standardfehlerausgabe des Gateways enthält den Audit-Ereignisstrom, das Audit-Protokoll zeichnet Entwickleridentitäten auf, und die Debug-Datei zeichnet Hook- und MCP-Serverausgaben von der Maschine des Entwicklers auf. Überprüfen und redigieren Sie diese, bevor Sie sie in einem öffentlichen Problem posten.275Die Standardfehlerausgabe des Gateways enthält den Audit-Ereignisstrom, das Audit-Protokoll zeichnet Entwickleridentitäten auf, und die Debug-Datei zeichnet Hook- und MCP-Serverausgaben von der Maschine des Entwicklers auf. Überprüfen und redigieren Sie diese, bevor Sie sie in einem öffentlichen Problem posten.

276 276

278| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |278| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

279| Das `/login` eines Entwicklers zeigt den Standard-Account-Picker statt des **Cloud-Gateway**-Bildschirms | `forceLoginMethod` oder `forceLoginGatewayUrl` ist nicht in verwalteten Einstellungen auf dieser Maschine gesetzt | Stellen Sie die [verwaltete Einstellungsdatei](/docs/de/claude-apps-gateway#set-the-gateway-url) auf dem Gerät bereit; `/login` liest die Gateway-URL von dort |279| Das `/login` eines Entwicklers zeigt den Standard-Account-Picker statt des **Cloud-Gateway**-Bildschirms | `forceLoginMethod` oder `forceLoginGatewayUrl` ist nicht in verwalteten Einstellungen auf dieser Maschine gesetzt | Stellen Sie die [verwaltete Einstellungsdatei](/docs/de/claude-apps-gateway#set-the-gateway-url) auf dem Gerät bereit; `/login` liest die Gateway-URL von dort |

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

281| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Der Gateway-Hostname wird zu mindestens einer öffentlichen IP-Adresse aufgelöst. Claude Code überprüft jede aufgelöste Adresse und erfordert, dass jede privat ist. Eine häufige Ursache ist ein Dual-Stack-Name, bei dem eine Familie zu einer öffentlichen Adresse aufgelöst wird, einschließlich AWS-interner Dual-Stack-Load-Balancer, die öffentliche AAAA-Adressen zurückgeben. {/* min-version: 2.1.206 */}Anthropic-betriebene öffentliche Gateway-Endpunkte sind von der Überprüfung ausgenommen, und `/login` akzeptiert sie über `https://`. Vor v2.1.206 lehnte `/login` sie wie jede andere öffentliche Adresse ab | Lassen Sie den Gateway-Namen nur zu privaten Adressen auf Entwicklermaschinen auflösen. Für einen Dual-Stack-Namen löschen Sie den öffentlichen Datensatz oder bedienen Sie einen separaten internen DNS-Namen. Siehe die [Private-Network-Voraussetzung](/docs/de/claude-apps-gateway#prerequisites). |281| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Der Gateway-Hostname wird zu mindestens einer öffentlichen IP-Adresse aufgelöst. Claude Code überprüft jede aufgelöste Adresse und erfordert, dass jede privat ist. Eine häufige Ursache ist ein Dual-Stack-Name, bei dem eine Familie zu einer öffentlichen Adresse aufgelöst wird, einschließlich AWS-interner Dual-Stack-Load-Balancer, die öffentliche AAAA-Adressen zurückgeben. Anthropic-betriebene öffentliche Gateway-Endpunkte sind von der Überprüfung ausgenommen, und `/login` akzeptiert sie über `https://`. Vor v2.1.206 lehnte `/login` sie wie jede andere öffentliche Adresse ab | Lassen Sie den Gateway-Namen nur zu privaten Adressen auf Entwicklermaschinen auflösen. Für einen Dual-Stack-Namen löschen Sie den öffentlichen Datensatz oder bedienen Sie einen separaten internen DNS-Namen. Siehe die [Private-Network-Voraussetzung](/docs/de/claude-apps-gateway#prerequisites). |

282| CLI `/login`: `Gateway login requires a direct connection and does not support connecting through an HTTP proxy` | Ein `HTTPS_PROXY` oder `HTTP_PROXY` gilt für den Gateway-Host und der Proxy-Hostname wird zu einer öffentlichen Adresse aufgelöst. Ein Proxy, dessen Host nur zu privaten Adressen aufgelöst wird, ist erlaubt und löst diesen Fehler nicht aus | Fügen Sie den Gateway-Host zu `NO_PROXY` auf der Entwicklermaschine hinzu, damit die Verbindung direkt ist, oder verwenden Sie einen Proxy, dessen Hostname zu privaten Adressen aufgelöst wird |282| CLI `/login`: `Gateway login requires a direct connection and does not support connecting through an HTTP proxy` | Ein `HTTPS_PROXY` oder `HTTP_PROXY` gilt für den Gateway-Host und der Proxy-Hostname wird zu einer öffentlichen Adresse aufgelöst. Ein Proxy, dessen Host nur zu privaten Adressen aufgelöst wird, ist erlaubt und löst diesen Fehler nicht aus | Fügen Sie den Gateway-Host zu `NO_PROXY` auf der Entwicklermaschine hinzu, damit die Verbindung direkt ist, oder verwenden Sie einen Proxy, dessen Hostname zu privaten Adressen aufgelöst wird |

283| CLI `/login`: `Could not resolve gateway host <host>` | Die Maschine kann den internen DNS-Namen des Gateways nicht auflösen, typischerweise weil sie nicht im Unternehmens-Netzwerk ist | Lassen Sie den Entwickler sich mit Ihrem Netzwerk oder VPN verbinden und versuchen Sie dann `/login` erneut |283| CLI `/login`: `Could not resolve gateway host <host>` | Die Maschine kann den internen DNS-Namen des Gateways nicht auflösen, typischerweise weil sie nicht im Unternehmens-Netzwerk ist | Lassen Sie den Entwickler sich mit Ihrem Netzwerk oder VPN verbinden und versuchen Sie dann `/login` erneut |

284| Boot beendet mit einem Konfigurationsvalidierungsfehler, der `store.postgres_url` benennt | Kein Postgres konfiguriert; das Gateway erfordert Postgres | Setzen Sie `store.postgres_url`. Für lokale Entwicklung verwenden Sie einen Wegwerf-Container: `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`. |284| Boot beendet mit einem Konfigurationsvalidierungsfehler, der `store.postgres_url` benennt | Kein Postgres konfiguriert; das Gateway erfordert Postgres | Setzen Sie `store.postgres_url`. Für lokale Entwicklung verwenden Sie einen Wegwerf-Container: `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`. |

claude-code-on-the-web.md +5 −5

Details

140 140

141Jede Cloud-Sitzung hat eine Transkript-URL auf claude.ai, und die Sitzung kann ihre eigene ID aus der Umgebungsvariablen `CLAUDE_CODE_REMOTE_SESSION_ID` lesen. Verwenden Sie dies, um einen nachverfolgbaren Link in PR-Bodies, Commit-Nachrichten, Slack-Posts oder generierten Berichten zu platzieren, damit ein Reviewer den Lauf öffnen kann, der sie produziert hat.141Jede Cloud-Sitzung hat eine Transkript-URL auf claude.ai, und die Sitzung kann ihre eigene ID aus der Umgebungsvariablen `CLAUDE_CODE_REMOTE_SESSION_ID` lesen. Verwenden Sie dies, um einen nachverfolgbaren Link in PR-Bodies, Commit-Nachrichten, Slack-Posts oder generierten Berichten zu platzieren, damit ein Reviewer den Lauf öffnen kann, der sie produziert hat.

142 142

143Ab v2.1.179 enthalten Commits, die Claude in einer Web-Sitzung erstellt, einen `Claude-Session: <url>` Git-Trailer, und PR-Bodies enthalten die Sitzungs-URL auf einer eigenen Zeile. {/* min-version: 2.1.182 */}Ab v2.1.182 können Sie [`attribution.sessionUrl`](/docs/de/settings#attribution-settings) auf `false` setzen, um den Trailer und den PR-Body-Link wegzulassen.143Ab v2.1.179 enthalten Commits, die Claude in einer Web-Sitzung erstellt, einen `Claude-Session: <url>` Git-Trailer, und PR-Bodies enthalten die Sitzungs-URL auf einer eigenen Zeile. Ab v2.1.182 können Sie [`attribution.sessionUrl`](/docs/de/settings#attribution-settings) auf `false` setzen, um den Trailer und den PR-Body-Link wegzulassen.

144 144

145Um den Sitzungs-Link in etwas anderem als einem Commit oder PR einzufügen, wie z. B. eine Slack-Nachricht, die Claude postet, oder eine Berichtsdatei, die es schreibt, lassen Sie Claude den folgenden Befehl ausführen und verwenden Sie seine Ausgabe. Der Befehl konvertiert das `cse_`-Präfix im Wert der Umgebungsvariablen in das `session_`-Präfix, das die Transkript-URL erwartet:145Um den Sitzungs-Link in etwas anderem als einem Commit oder PR einzufügen, wie z. B. eine Slack-Nachricht, die Claude postet, oder eine Berichtsdatei, die es schreibt, lassen Sie Claude den folgenden Befehl ausführen und verwenden Sie seine Ausgabe. Der Befehl konvertiert das `cse_`-Präfix im Wert der Umgebungsvariablen in das `session_`-Präfix, das die Transkript-URL erwartet:

146 146

669 669

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

671 671

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

673 673

674<Note>674<Note>

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

748Teleport überprüft diese Anforderungen, bevor eine Sitzung fortgesetzt wird. Wenn eine Anforderung nicht erfüllt ist, sehen Sie einen Fehler oder werden aufgefordert, das Problem zu beheben.748Teleport überprüft diese Anforderungen, bevor eine Sitzung fortgesetzt wird. Wenn eine Anforderung nicht erfüllt ist, sehen Sie einen Fehler oder werden aufgefordert, das Problem zu beheben.

749 749

751| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |751| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

752| Sauberer Git-Status | Ihr Arbeitsverzeichnis darf keine nicht committeten Änderungen haben. Teleport fordert Sie auf, Änderungen zu stashen, falls erforderlich. |752| Sauberer Git-Status | Ihr Arbeitsverzeichnis darf keine nicht committeten Änderungen haben. Teleport fordert Sie auf, Änderungen zu stashen, falls erforderlich. |

753| Korrektes Repository | Sie müssen `--teleport` aus einem Checkout desselben Repositories ausführen, nicht aus einem Fork. {/* min-version: 2.1.199 */}Ab v2.1.199 akzeptiert Claude Code einen Checkout auch dann, wenn es das Remote nicht in einen Hostnamen analysieren kann, wie z. B. einen SSH-Host-Alias wie `git@work:owner/repo.git` oder eine `insteadOf`-umgeschriebene Kurzform. Es zeigt zuerst eine Bestätigungsaufforderung an und nur, wenn der Owner und der Repository-Name des Remote mit dem Repository der Sitzung übereinstimmen. |753| Korrektes Repository | Sie müssen `--teleport` aus einem Checkout desselben Repositories ausführen, nicht aus einem Fork. Ab v2.1.199 akzeptiert Claude Code einen Checkout auch dann, wenn es das Remote nicht in einen Hostnamen analysieren kann, wie z. B. einen SSH-Host-Alias wie `git@work:owner/repo.git` oder eine `insteadOf`-umgeschriebene Kurzform. Es zeigt zuerst eine Bestätigungsaufforderung an und nur, wenn der Owner und der Repository-Name des Remote mit dem Repository der Sitzung übereinstimmen. |

754| Branch verfügbar | Der Branch aus der Cloud-Sitzung muss in das Remote gepusht worden sein. Teleport ruft ihn automatisch ab und checkt ihn aus. |754| Branch verfügbar | Der Branch aus der Cloud-Sitzung muss in das Remote gepusht worden sein. Teleport ruft ihn automatisch ab und checkt ihn aus. |

755| Gleiches Konto | Sie müssen sich bei demselben claude.ai-Konto authentifizieren, das in der Cloud-Sitzung verwendet wurde. |755| Gleiches Konto | Sie müssen sich bei demselben claude.ai-Konto authentifizieren, das in der Cloud-Sitzung verwendet wurde. |

756 756

772 772

773Cloud-Sitzungen unterstützen [integrierte Befehle](/docs/de/commands), die Textausgabe erzeugen. Befehle, die nur in der Terminal-Schnittstelle ausgeführt werden, wie `/plugin` oder `/resume`, sind nicht verfügbar. Befehle, die eine Auswahl oder ein Panel in der Terminal-Schnittstelle öffnen, verhalten sich in Cloud-Sitzungen unterschiedlich:773Cloud-Sitzungen unterstützen [integrierte Befehle](/docs/de/commands), die Textausgabe erzeugen. Befehle, die nur in der Terminal-Schnittstelle ausgeführt werden, wie `/plugin` oder `/resume`, sind nicht verfügbar. Befehle, die eine Auswahl oder ein Panel in der Terminal-Schnittstelle öffnen, verhalten sich in Cloud-Sitzungen unterschiedlich:

774 774

775* {/* min-version: 2.1.205 */}**`/model`, `/effort`, `/fast`, `/color` und `/rename`**: Übergeben Sie den Wert als Argument, zum Beispiel `/model sonnet`, anstatt die Terminal-Auswahl oder den Schieberegler zu öffnen. Die Argumentformen erfordern Claude Code v2.1.205 oder später in der Umgebung der Sitzung und folgen den [Verfügbarkeitshinweisen](/docs/de/commands#all-commands) jedes Befehls: `/effort` meldet `Not applied`, während ein [Launch-Standard-Effort-Hold](/docs/de/model-config#adjust-effort-level) eines Modells in Kraft ist, und `/fast` funktioniert nur in einer Sitzung, die mit aktiviertem Fast-Modus gestartet wurde.775* **`/model`, `/effort`, `/fast`, `/color` und `/rename`**: Übergeben Sie den Wert als Argument, zum Beispiel `/model sonnet`, anstatt die Terminal-Auswahl oder den Schieberegler zu öffnen. Die Argumentformen erfordern Claude Code v2.1.205 oder später in der Umgebung der Sitzung und folgen den [Verfügbarkeitshinweisen](/docs/de/commands#all-commands) jedes Befehls: `/effort` meldet `Not applied`, während ein [Launch-Standard-Effort-Hold](/docs/de/model-config#adjust-effort-level) eines Modells in Kraft ist, und `/fast` funktioniert nur in einer Sitzung, die mit aktiviertem Fast-Modus gestartet wurde.

776* **`/config`**: Im Web öffnet dies den Claude Code-Bereich Ihrer Einstellungen, anstatt einen Wert zu setzen, und Text nach dem Befehl, einschließlich `key=value`, wird ignoriert. Um Einstellungen für eine Cloud-Sitzung zu ändern, verwenden Sie [Umgebungsvariablen](#configure-your-environment) oder committen Sie [Einstellungsdateien](/docs/de/settings) in das Repository.776* **`/config`**: Im Web öffnet dies den Claude Code-Bereich Ihrer Einstellungen, anstatt einen Wert zu setzen, und Text nach dem Befehl, einschließlich `key=value`, wird ignoriert. Um Einstellungen für eine Cloud-Sitzung zu ändern, verwenden Sie [Umgebungsvariablen](#configure-your-environment) oder committen Sie [Einstellungsdateien](/docs/de/settings) in das Repository.

777 777

778Für Kontextverwaltung speziell:778Für Kontextverwaltung speziell:

claude-platform-on-aws.md +9 −9

Details

188 188

189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />

190 190

191Claude Platform on AWS ist die von Anthropic betriebene Claude API mit AWS-Authentifizierung, IAM-Zugriffskontrolle und AWS Marketplace-Abrechnung. Anfragen erreichen die API von Anthropic direkt, sodass Sie die gleichen Modelle und API-Funktionen wie die [Claude API](https://platform.claude.com/docs) nach dem gleichen Veröffentlichungsplan erhalten. Client-seitige Funktionen, die Claude Code durch den Feature-Flag-Service von Anthropic aktiviert, wie z. B. [`/loop` Selbststeuerung](/de/scheduled-tasks#let-claude-choose-the-interval), sind standardmäßig deaktiviert, und das [Advisor-Tool](/de/advisor) ist nicht verfügbar. Siehe die [Feature-Verfügbarkeitsmatrix](/de/feature-availability#summary-by-provider) für die vollständige Liste. Sie authentifizieren sich mit AWS-Anmeldedaten oder einem Workspace-API-Schlüssel und zahlen über AWS Marketplace.191Claude Platform on AWS ist die von Anthropic betriebene Claude API mit AWS-Authentifizierung, IAM-Zugriffskontrolle und AWS Marketplace-Abrechnung. Anfragen erreichen die API von Anthropic direkt, sodass Sie die gleichen Modelle und API-Funktionen wie die [Claude API](https://platform.claude.com/docs) nach dem gleichen Veröffentlichungsplan erhalten. Client-seitige Funktionen, die Claude Code durch den Feature-Flag-Service von Anthropic aktiviert, wie z. B. [`/loop` Selbststeuerung](/docs/de/scheduled-tasks#let-claude-choose-the-interval), sind standardmäßig deaktiviert, und das [Advisor-Tool](/docs/de/advisor) ist nicht verfügbar. Siehe die [Feature-Verfügbarkeitsmatrix](/docs/de/feature-availability#summary-by-provider) für die vollständige Liste. Sie authentifizieren sich mit AWS-Anmeldedaten oder einem Workspace-API-Schlüssel und zahlen über AWS Marketplace.

192 192

193Verwenden Sie diese Anleitung, um Claude Code auf einen Workspace zu verweisen, den Sie bereits über Claude Platform on AWS bereitgestellt haben. Für das AWS-Abonnement und die Workspace-Einrichtung, die davor kommt, siehe die [Claude Platform on AWS-Dokumentation](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).193Verwenden Sie diese Anleitung, um Claude Code auf einen Workspace zu verweisen, den Sie bereits über Claude Platform on AWS bereitgestellt haben. Für das AWS-Abonnement und die Workspace-Einrichtung, die davor kommt, siehe die [Claude Platform on AWS-Dokumentation](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).

194 194

230 230

231Für CI und Automatisierung geben Sie dem Runner eine IAM-Rolle mit Berechtigung zum Aufrufen des Anthropic-Dienstes und setzen Sie `AWS_REGION`. Die Anmeldekette nimmt die Rolle automatisch auf.231Für CI und Automatisierung geben Sie dem Runner eine IAM-Rolle mit Berechtigung zum Aufrufen des Anthropic-Dienstes und setzen Sie `AWS_REGION`. Die Anmeldekette nimmt die Rolle automatisch auf.

232 232

233Wenn Ihre SSO-Anmeldedaten während einer Sitzung ablaufen, konfigurieren Sie [`awsAuthRefresh`](/de/amazon-bedrock#advanced-credential-configuration), damit Claude Code Ihren Anmeldungsbefehl erneut ausführt und erneut versucht, anstatt fehlzuschlagen. Automatische Aktualisierung auf Claude Platform on AWS erfordert Claude Code v2.1.198 oder später; frühere Versionen stoppen mit einer Aufforderung, `/login` auszuführen, was AWS-Anmeldedaten nicht aktualisieren kann. Fügen Sie den Befehl zu Ihrer `settings.json` hinzu:233Wenn Ihre SSO-Anmeldedaten während einer Sitzung ablaufen, konfigurieren Sie [`awsAuthRefresh`](/docs/de/amazon-bedrock#advanced-credential-configuration), damit Claude Code Ihren Anmeldungsbefehl erneut ausführt und erneut versucht, anstatt fehlzuschlagen. Automatische Aktualisierung auf Claude Platform on AWS erfordert Claude Code v2.1.198 oder später; frühere Versionen stoppen mit einer Aufforderung, `/login` auszuführen, was AWS-Anmeldedaten nicht aktualisieren kann. Fügen Sie den Befehl zu Ihrer `settings.json` hinzu:

234 234

235```json theme={null}235```json theme={null}

236{236{

250 250

251Der Schlüssel wird als `x-api-key` gesendet und hat Vorrang vor SigV4, sodass alle AWS-Anmeldedaten in Ihrer Umgebung ignoriert werden. API-Schlüssel aus einer separaten Claude Console-Organisation funktionieren hier nicht.251Der Schlüssel wird als `x-api-key` gesendet und hat Vorrang vor SigV4, sodass alle AWS-Anmeldedaten in Ihrer Umgebung ignoriert werden. API-Schlüssel aus einer separaten Claude Console-Organisation funktionieren hier nicht.

252 252

253Behandeln Sie Workspace-API-Schlüssel wie jede andere Produktionsanmeldedaten. Der [Benutzereinstellungsdatei](/de/settings) `env`-Block ist eine praktische Möglichkeit, den Schlüssel auf Ihrem Computer zu beschränken, ohne ihn global zu exportieren.253Behandeln Sie Workspace-API-Schlüssel wie jede andere Produktionsanmeldedaten. Der [Benutzereinstellungsdatei](/docs/de/settings) `env`-Block ist eine praktische Möglichkeit, den Schlüssel auf Ihrem Computer zu beschränken, ohne ihn global zu exportieren.

254 254

255<Note>255<Note>

256 Die Befehle `/login` und `/logout` melden Sie nicht bei einem Claude.ai-Abonnement für Claude Platform on AWS an. Die Authentifizierung erfolgt über Ihre AWS-Anmeldedaten oder Ihren Workspace-API-Schlüssel. Die Ausnahme ist die Option **Anmeldedaten aktualisieren**, die `/login` anzeigt, wenn `awsAuthRefresh` konfiguriert ist. Diese liest Ihre AWS-Anmeldedaten wie oben beschrieben erneut.256 Die Befehle `/login` und `/logout` melden Sie nicht bei einem Claude.ai-Abonnement für Claude Platform on AWS an. Die Authentifizierung erfolgt über Ihre AWS-Anmeldedaten oder Ihren Workspace-API-Schlüssel. Die Ausnahme ist die Option **Anmeldedaten aktualisieren**, die `/login` anzeigt, wenn `awsAuthRefresh` konfiguriert ist. Diese liest Ihre AWS-Anmeldedaten wie oben beschrieben erneut.

278 278

279Claude Platform on AWS verwendet die gleichen Modell-IDs wie die direkte Claude API.279Claude Platform on AWS verwendet die gleichen Modell-IDs wie die direkte Claude API.

280 280

281Die Standard-Aliase `fable`, `opus`, `sonnet` und `haiku` werden zu Claude Codes integrierten Standardwerten für Claude Platform on AWS aufgelöst, die hinter der neuesten Version zurückbleiben können. Ohne `ANTHROPIC_DEFAULT_OPUS_MODEL` wird der `opus`-Alias zu Opus 4.8 aufgelöst. {/* min-version: 2.1.207 */}Vor v2.1.207 wurde er zu Opus 4.7 aufgelöst.281Die Standard-Aliase `fable`, `opus`, `sonnet` und `haiku` werden zu Claude Codes integrierten Standardwerten für Claude Platform on AWS aufgelöst, die hinter der neuesten Version zurückbleiben können. Ohne `ANTHROPIC_DEFAULT_OPUS_MODEL` wird der `opus`-Alias zu Opus 4.8 aufgelöst. Vor v2.1.207 wurde er zu Opus 4.7 aufgelöst.

282 282

283Wenn Sie Claude Code für ein Team bereitstellen, heften Sie die Modell-IDs explizit an, damit eine neue Version nicht alle auf einmal verschiebt:283Wenn Sie Claude Code für ein Team bereitstellen, heften Sie die Modell-IDs explizit an, damit eine neue Version nicht alle auf einmal verschiebt:

284 284

289export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5289export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

290```290```

291 291

292Die vollständige Liste der Modell-IDs und Aliase finden Sie unter [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Für andere modellbezogene Variablen siehe [Modellkonfiguration](/de/model-config).292Die vollständige Liste der Modell-IDs und Aliase finden Sie unter [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Für andere modellbezogene Variablen siehe [Modellkonfiguration](/docs/de/model-config).

293 293

294[Prompt Caching](/de/prompt-caching) ist automatisch aktiviert. Um statt des 5-Minuten-Standards eine 1-Stunden-Cache-TTL anzufordern, setzen Sie `ENABLE_PROMPT_CACHING_1H=1`. Die API berechnet 1-Stunden-Cache-Schreibvorgänge mit einer höheren Rate ab. Siehe [Prompt Caching-Preisgestaltung](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) für die Tarife.294[Prompt Caching](/docs/de/prompt-caching) ist automatisch aktiviert. Um statt des 5-Minuten-Standards eine 1-Stunden-Cache-TTL anzufordern, setzen Sie `ENABLE_PROMPT_CACHING_1H=1`. Die API berechnet 1-Stunden-Cache-Schreibvorgänge mit einer höheren Rate ab. Siehe [Prompt Caching-Preisgestaltung](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) für die Tarife.

295 295

296<h2 id="use-the-agent-sdk">296<h2 id="use-the-agent-sdk">

297 Agent SDK verwenden297 Agent SDK verwenden

298</h2>298</h2>

299 299

300Das [Agent SDK](/de/agent-sdk/overview) liest die gleichen Umgebungsvariablen wie die CLI, sodass jedes Programm, das den Claude Code-Unterprozess erzeugt, Claude Platform on AWS anvisieren kann, indem es `CLAUDE_CODE_USE_ANTHROPIC_AWS`, `ANTHROPIC_AWS_WORKSPACE_ID` und entweder `ANTHROPIC_AWS_API_KEY` oder AWS-Anmeldedaten vor dem Aufruf exportiert.300Das [Agent SDK](/docs/de/agent-sdk/overview) liest die gleichen Umgebungsvariablen wie die CLI, sodass jedes Programm, das den Claude Code-Unterprozess erzeugt, Claude Platform on AWS anvisieren kann, indem es `CLAUDE_CODE_USE_ANTHROPIC_AWS`, `ANTHROPIC_AWS_WORKSPACE_ID` und entweder `ANTHROPIC_AWS_API_KEY` oder AWS-Anmeldedaten vor dem Aufruf exportiert.

301 301

302```typescript theme={null}302```typescript theme={null}

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

311}311}

312```312```

313 313

314Dieses Beispiel basiert auf der Umgebungs-AWS-Anmeldekette für SigV4. Um sich stattdessen mit einem Workspace-API-Schlüssel zu authentifizieren, setzen Sie `ANTHROPIC_AWS_API_KEY` auf die gleiche Weise. Für die breitere Agent SDK-Oberfläche siehe [Agent SDK-Übersicht](/de/agent-sdk/overview).314Dieses Beispiel basiert auf der Umgebungs-AWS-Anmeldekette für SigV4. Um sich stattdessen mit einem Workspace-API-Schlüssel zu authentifizieren, setzen Sie `ANTHROPIC_AWS_API_KEY` auf die gleiche Weise. Für die breitere Agent SDK-Oberfläche siehe [Agent SDK-Übersicht](/docs/de/agent-sdk/overview).

315 315

316<h2 id="route-through-a-corporate-proxy">316<h2 id="route-through-a-corporate-proxy">

317 Durch einen Unternehmens-Proxy leiten317 Durch einen Unternehmens-Proxy leiten

318</h2>318</h2>

319 319

320Um Datenverkehr durch einen Proxy oder [LLM-Gateway](/de/llm-gateway) zu leiten, setzen Sie `ANTHROPIC_AWS_BASE_URL` auf die Adresse des Proxys. Claude Code sendet Anfragen an diese URL mit den gleichen Workspace- und Authentifizierungsheadern, sodass jedes Gateway, das sie unverändert weiterleitet, funktioniert.320Um Datenverkehr durch einen Proxy oder [LLM-Gateway](/docs/de/llm-gateway) zu leiten, setzen Sie `ANTHROPIC_AWS_BASE_URL` auf die Adresse des Proxys. Claude Code sendet Anfragen an diese URL mit den gleichen Workspace- und Authentifizierungsheadern, sodass jedes Gateway, das sie unverändert weiterleitet, funktioniert.

321 321

322```bash theme={null}322```bash theme={null}

323export CLAUDE_CODE_USE_ANTHROPIC_AWS=1323export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

cli-reference.md +68 −68

Details

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

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

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

29| `claude auth status` | Authentifizierungsstatus als JSON anzeigen. Verwenden Sie `--text` für benutzerfreundliche Ausgabe. Beendet mit Code 0, wenn angemeldet, 1, wenn nicht | `claude auth status` |29| `claude auth status` | Authentifizierungsstatus als JSON anzeigen. Verwenden Sie `--text` für benutzerfreundliche Ausgabe. Beendet mit Code 0, wenn angemeldet, 1, wenn nicht | `claude auth status` |

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

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

33| `claude daemon status` | Drucken Sie den Hintergrund-Sitzungs-[Supervisor](/de/agent-view#the-supervisor-process) Status, Version, Socket-Verzeichnis und Worker-Anzahl für Diagnosen. Beendet mit 1, wenn der Supervisor nicht läuft | `claude daemon status` |33| `claude daemon status` | Drucken Sie den Hintergrund-Sitzungs-[Supervisor](/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 stop --any` | Stoppen Sie den Hintergrund-Sitzungs-[Supervisor](/de/agent-view#the-supervisor-process) und die Sitzungen, die er hostet. Übergeben Sie `--keep-workers`, um Hintergrundsitzungen laufen zu lassen, damit sich der nächste Supervisor mit ihnen verbindet. `--any` bestätigt das Stoppen eines On-Demand-Supervisors, was die Standardeinstellung ist. Verwenden Sie dies, um sich von einem [nicht reagierenden Supervisor](/de/agent-view#agent-view-says-the-background-service-did-not-respond) zu erholen | `claude daemon stop --any --keep-workers` |34| `claude daemon stop --any` | Stoppen Sie den Hintergrund-Sitzungs-[Supervisor](/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 doctor` | Drucken Sie schreibgeschützte Installations- und Einstellungsdiagnosen vom Terminal aus, ohne eine Sitzung zu starten, einschließlich Installationsintegrität, Validierungsfehlern in der Einstellungsdatei und Remote Control-Berechtigung. Für die In-Session-Setup-Überprüfung, die auch Fixes anwenden kann, führen Sie [`/doctor`](/de/commands#all-commands) aus | `claude doctor` |35| `claude doctor` | Drucken Sie schreibgeschützte Installations- und Einstellungsdiagnosen vom Terminal aus, ohne eine Sitzung zu starten, einschließlich Installationsintegrität, Validierungsfehlern in der Einstellungsdatei und Remote Control-Berechtigung. Für die In-Session-Setup-Überprüfung, die auch Fixes anwenden kann, führen Sie [`/doctor`](/docs/de/commands#all-commands) aus | `claude doctor` |

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

39| `claude mcp logout <name>` | {/* min-version: 2.1.186 */}Löschen Sie gespeicherte OAuth-Anmeldedaten für einen MCP-Server. Erfordert Claude Code v2.1.186 oder später | `claude mcp logout sentry` |39| `claude mcp logout <name>` | Löschen Sie gespeicherte OAuth-Anmeldedaten für einen MCP-Server. Erfordert Claude Code v2.1.186 oder später | `claude mcp logout sentry` |

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

41| `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](/de/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |41| `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` |

42| `claude remote-control` | Starten Sie einen [Remote Control](/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](/de/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |42| `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) | `claude remote-control --name "My Project"` |

43| `claude respawn <id>` | Starten Sie eine [Hintergrundsitzung](/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` |43| `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` |

44| `claude rm <id>` | Entfernen Sie eine [Hintergrundsitzung](/de/agent-view#manage-sessions-from-the-shell) aus der Liste. Das Konversationstranskript bleibt auf Ihrem lokalen Computer erhalten und ist über `claude --resume` verfügbar | `claude rm 7c5dcf5d` |44| `claude rm <id>` | Entfernen Sie eine [Hintergrundsitzung](/docs/de/agent-view#manage-sessions-from-the-shell) aus der Liste. Das Konversationstranskript bleibt auf Ihrem lokalen Computer erhalten und ist über `claude --resume` verfügbar | `claude rm 7c5dcf5d` |

45| `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](/de/authentication#generate-a-long-lived-token) | `claude setup-token` |45| `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` |

47| `claude ultrareview [target]` | Führen Sie [ultrareview](/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 30-Minuten-Standard zu überschreiben | `claude ultrareview 1234 --json` |47| `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 30-Minuten-Standard zu überschreiben | `claude ultrareview 1234 --json` |

48 48

49Wenn 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.49Wenn 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.

50 50

51{/* min-version: 2.1.199 */}Ab v2.1.199 führt `claude --dangerously-skip-permissions daemon <subcommand>` den `daemon` Unterbefehl aus. Frühere Versionen behandelten `daemon <subcommand>` als den Prompt für eine neue interaktive Sitzung, sodass der Unterbefehl nie ausgeführt wurde, wenn das Flag zuerst kam, ein häufiges Setup, wenn `claude` mit dem Flag aliasiert ist. Nur ein führendes `--dangerously-skip-permissions` oder `--allow-dangerously-skip-permissions` leitet auf diese Weise zu `daemon` weiter; jedes andere führende Flag startet immer noch eine interaktive Sitzung.51Ab v2.1.199 führt `claude --dangerously-skip-permissions daemon <subcommand>` den `daemon` Unterbefehl aus. Frühere Versionen behandelten `daemon <subcommand>` als den Prompt für eine neue interaktive Sitzung, sodass der Unterbefehl nie ausgeführt wurde, wenn das Flag zuerst kam, ein häufiges Setup, wenn `claude` mit dem Flag aliasiert ist. Nur ein führendes `--dangerously-skip-permissions` oder `--allow-dangerously-skip-permissions` leitet auf diese Weise zu `daemon` weiter; jedes andere führende Flag startet immer noch eine interaktive Sitzung.

52 52

53<h2 id="cli-flags">53<h2 id="cli-flags">

54 CLI-Flags54 CLI-Flags

57Passen Sie das Verhalten von Claude Code mit diesen Befehlszeilenflags an. `claude --help` listet nicht jedes Flag auf, daher bedeutet das Fehlen eines Flags in `--help` nicht, dass es nicht verfügbar ist.57Passen Sie das Verhalten von Claude Code mit diesen Befehlszeilenflags an. `claude --help` listet nicht jedes Flag auf, daher bedeutet das Fehlen eines Flags in `--help` nicht, dass es nicht verfügbar ist.

58 58

60| :---------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |60| :---------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |

61| `--add-dir` | Zusätzliche Arbeitsverzeichnisse hinzufügen, auf die Claude Dateien lesen und bearbeiten kann. Gewährt Dateizugriff; die meisten `.claude/` Konfigurationen werden [nicht erkannt](/de/permissions#additional-directories-grant-file-access-not-configuration) aus diesen Verzeichnissen. Validiert, dass jeder Pfad als Verzeichnis existiert. Um diese Verzeichnisse über Sitzungen hinweg beizubehalten, setzen Sie [`permissions.additionalDirectories`](/de/settings#permission-settings) in den Einstellungen | `claude --add-dir ../apps ../lib` |61| `--add-dir` | Zusätzliche Arbeitsverzeichnisse hinzufügen, auf die Claude Dateien lesen und bearbeiten kann. Gewährt Dateizugriff; die meisten `.claude/` Konfigurationen werden [nicht erkannt](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) aus diesen Verzeichnissen. Validiert, dass jeder Pfad als Verzeichnis existiert. Um diese Verzeichnisse über Sitzungen hinweg beizubehalten, setzen Sie [`permissions.additionalDirectories`](/docs/de/settings#permission-settings) in den Einstellungen | `claude --add-dir ../apps ../lib` |

62| `--advisor <model>` | Aktivieren Sie das serverseitige [Advisor-Tool](/de/advisor) für diese Sitzung mit einem Modell-Alias: `opus`, `sonnet` oder `fable` ({/* min-version: 2.1.170 */}v2.1.170+), oder eine vollständige Modell-ID. Hat Vorrang vor der `advisorModel`-Einstellung für die Sitzung | `claude --advisor opus` |62| `--advisor <model>` | Aktivieren Sie das serverseitige [Advisor-Tool](/docs/de/advisor) für diese Sitzung mit einem Modell-Alias: `opus`, `sonnet` oder `fable` (v2.1.170+), oder eine vollständige Modell-ID. Hat Vorrang vor der `advisorModel`-Einstellung für die Sitzung | `claude --advisor opus` |

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

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

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

67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Fügen Sie benutzerdefinierten Text am Ende des Systemprompts jedes [Subagenten](/de/sub-agents) an, einschließlich verschachtelter Subagenten. Gilt nur im nicht-interaktiven Modus mit `-p`. Erfordert Claude Code v2.1.205 oder später | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |67| `--append-subagent-system-prompt` | Fügen Sie benutzerdefinierten Text am Ende des Systemprompts jedes [Subagenten](/docs/de/sub-agents) an, einschließlich verschachtelter Subagenten. Gilt nur im nicht-interaktiven Modus mit `-p`. Erfordert Claude Code v2.1.205 oder später | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

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

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

71| `--bare` | Minimaler Modus: Überspringen Sie die automatische Erkennung von Hooks, Skills, Plugins, MCP-Servern, automatischem Speicher und CLAUDE.md, damit Skriptaufrufe schneller starten. Claude hat Zugriff auf Bash-, Dateilesungs- und Dateibearbeitungstools. Setzt [`CLAUDE_CODE_SIMPLE`](/de/env-vars). Siehe [Bare-Modus](/de/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |71| `--bare` | Minimaler Modus: Überspringen Sie die automatische Erkennung von Hooks, Skills, Plugins, MCP-Servern, automatischem Speicher und CLAUDE.md, damit Skriptaufrufe schneller starten. Claude hat Zugriff auf Bash-, Dateilesungs- und Dateibearbeitungstools. Setzt [`CLAUDE_CODE_SIMPLE`](/docs/de/env-vars). Siehe [Bare-Modus](/docs/de/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

73| `--bg`, `--background` | Starten Sie die Sitzung als [Hintergrund-Agent](/de/agent-view) und kehren Sie sofort zurück. Gibt die Sitzungs-ID und Verwaltungsbefehle aus. Kombinieren Sie mit `--exec`, um einen Shell-Befehl als Hintergrund-Job anstelle einer Claude-Sitzung auszuführen, oder mit `--agent`, um einen bestimmten Subagenten auszuführen. {/* min-version: 2.1.198 */}Kann nicht mit `-p`/`--print` kombiniert werden; siehe die [Fehlerreferenz](/de/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |73| `--bg`, `--background` | Starten Sie die Sitzung als [Hintergrund-Agent](/docs/de/agent-view) und kehren Sie sofort zurück. Gibt die Sitzungs-ID und Verwaltungsbefehle aus. Kombinieren Sie mit `--exec`, um einen Shell-Befehl als Hintergrund-Job anstelle einer Claude-Sitzung auszuführen, oder mit `--agent`, um einen bestimmten Subagenten auszuführen. Kann nicht mit `-p`/`--print` kombiniert werden; siehe die [Fehlerreferenz](/docs/de/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

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

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

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

78| `--dangerously-load-development-channels` | Aktivieren Sie [Kanäle](/de/channels-reference#test-during-the-research-preview), die sich nicht auf der genehmigten Zulassungsliste befinden, für die lokale Entwicklung. Akzeptiert `plugin:<name>@<marketplace>` und `server:<name>` Einträge. Fordert zur Bestätigung auf | `claude --dangerously-load-development-channels server:webhook` |78| `--dangerously-load-development-channels` | Aktivieren Sie [Kanäle](/docs/de/channels-reference#test-during-the-research-preview), die sich nicht auf der genehmigten Zulassungsliste befinden, für die lokale Entwicklung. Akzeptiert `plugin:<name>@<marketplace>` und `server:<name>` Einträge. Fordert zur Bestätigung auf | `claude --dangerously-load-development-channels server:webhook` |

79| `--dangerously-skip-permissions` | Überspringen Sie Berechtigungsaufforderungen. Entspricht `--permission-mode bypassPermissions`. Siehe [Berechtigungsmodi](/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) für das, was dies überspringt und nicht überspringt. Für Sitzungen, die mit `--bg` gestartet wurden, wird der Modus [beibehalten, wenn der Supervisor die Sitzung neu startet](/de/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |79| `--dangerously-skip-permissions` | Überspringen Sie Berechtigungsaufforderungen. Entspricht `--permission-mode bypassPermissions`. Siehe [Berechtigungsmodi](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) für das, was dies überspringt und nicht überspringt. Für Sitzungen, die mit `--bg` gestartet wurden, wird der Modus [beibehalten, wenn der Supervisor die Sitzung neu startet](/docs/de/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

81| `--debug-file <path>` | Schreiben Sie Debug-Protokolle in einen bestimmten Dateipfad. Aktiviert implizit den Debug-Modus. Hat Vorrang vor `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |81| `--debug-file <path>` | Schreiben Sie Debug-Protokolle in einen bestimmten Dateipfad. Aktiviert implizit den Debug-Modus. Hat Vorrang vor `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |

83| `--disallowedTools`, `--disallowed-tools` | Ablehnungsregeln. Ein bloßer Tool-Name entfernt die entsprechenden Tools aus dem Kontext des Modells: `"Edit"` entfernt Edit, `"*"` entfernt jedes Tool und `"mcp__*"` entfernt jedes MCP-Tool. Eine scoped Regel wie `Bash(rm *)` lässt das Tool verfügbar und lehnt nur übereinstimmende Aufrufe ab | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |83| `--disallowedTools`, `--disallowed-tools` | Ablehnungsregeln. Ein bloßer Tool-Name entfernt die entsprechenden Tools aus dem Kontext des Modells: `"Edit"` entfernt Edit, `"*"` entfernt jedes Tool und `"mcp__*"` entfernt jedes MCP-Tool. Eine scoped Regel wie `Bash(rm *)` lässt das Tool verfügbar und lehnt nur übereinstimmende Aufrufe ab | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

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

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

86| `--exclude-dynamic-system-prompt-sections` | Verschieben Sie maschinenspezifische Abschnitte aus dem Systemprompt (Arbeitsverzeichnis, Umgebungsinformationen, Speicherpfade, Git-Repo-Flag) in die erste Benutzernachricht. Verbessert die Prompt-Cache-Wiederverwendung über verschiedene Benutzer und Maschinen hinweg, die die gleiche Aufgabe ausführen. Gilt nur mit dem Standard-Systemprompt; wird ignoriert, wenn `--system-prompt` oder `--system-prompt-file` gesetzt ist. Verwenden Sie mit `-p` für Skript-, Multi-Benutzer-Workloads | `claude -p --exclude-dynamic-system-prompt-sections "query"` |86| `--exclude-dynamic-system-prompt-sections` | Verschieben Sie maschinenspezifische Abschnitte aus dem Systemprompt (Arbeitsverzeichnis, Umgebungsinformationen, Speicherpfade, Git-Repo-Flag) in die erste Benutzernachricht. Verbessert die Prompt-Cache-Wiederverwendung über verschiedene Benutzer und Maschinen hinweg, die die gleiche Aufgabe ausführen. Gilt nur mit dem Standard-Systemprompt; wird ignoriert, wenn `--system-prompt` oder `--system-prompt-file` gesetzt ist. Verwenden Sie mit `-p` für Skript-, Multi-Benutzer-Workloads | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

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

88| `--fallback-model` | Aktivieren Sie automatisches Fallback auf das angegebene Modell oder die angegebenen Modelle, wenn das primäre Modell überlastet ist oder nicht verfügbar ist, zum Beispiel ein veraltetes Modell. Akzeptiert eine durch Kommas getrennte Liste, die der Reihe nach versucht wird. Siehe [Fallback-Modellketten](/de/model-config#fallback-model-chains). Um eine Kette über Sitzungen hinweg beizubehalten, verwenden Sie die [`fallbackModel`-Einstellung](/de/settings#available-settings), die dieses Flag überschreibt | `claude --fallback-model sonnet,haiku` |88| `--fallback-model` | Aktivieren Sie automatisches Fallback auf das angegebene Modell oder die angegebenen Modelle, wenn das primäre Modell überlastet ist oder nicht verfügbar ist, zum Beispiel ein veraltetes Modell. Akzeptiert eine durch Kommas getrennte Liste, die der Reihe nach versucht wird. Siehe [Fallback-Modellketten](/docs/de/model-config#fallback-model-chains). Um eine Kette über Sitzungen hinweg beizubehalten, verwenden Sie die [`fallbackModel`-Einstellung](/docs/de/settings#available-settings), die dieses Flag überschreibt | `claude --fallback-model sonnet,haiku` |

89| `--fork-session` | Erstellen Sie beim Fortsetzen eine neue Sitzungs-ID, anstatt die ursprüngliche wiederzuverwenden (verwenden Sie mit `--resume` oder `--continue`) | `claude --resume abc123 --fork-session` |89| `--fork-session` | Erstellen Sie beim Fortsetzen eine neue Sitzungs-ID, anstatt die ursprüngliche wiederzuverwenden (verwenden Sie mit `--resume` oder `--continue`) | `claude --resume abc123 --fork-session` |

90| `--from-pr` | Setzen Sie Sitzungen fort, die mit einem bestimmten Pull Request verknüpft sind. Akzeptiert eine PR-Nummer, eine GitHub oder GitHub Enterprise PR URL, eine GitLab Merge Request URL oder eine Bitbucket Pull Request URL. Sitzungen werden automatisch verknüpft, wenn Claude den Pull Request erstellt | `claude --from-pr 123` |90| `--from-pr` | Setzen Sie Sitzungen fort, die mit einem bestimmten Pull Request verknüpft sind. Akzeptiert eine PR-Nummer, eine GitHub oder GitHub Enterprise PR URL, eine GitLab Merge Request URL oder eine Bitbucket Pull Request URL. Sitzungen werden automatisch verknüpft, wenn Claude den Pull Request erstellt | `claude --from-pr 123` |

91| `--ide` | Verbinden Sie sich automatisch beim Start mit der IDE, wenn genau eine gültige IDE verfügbar ist | `claude --ide` |91| `--ide` | Verbinden Sie sich automatisch beim Start mit der IDE, wenn genau eine gültige IDE verfügbar ist | `claude --ide` |

94| `--include-hook-events` | Schließen Sie Hook-Lebenszyklusereignisse von jedem Hook-Ereignis in den Ausgabestrom ein. `SessionStart` und `Setup` Hook-Ereignisse sind immer enthalten und benötigen dieses Flag nicht. Erfordert `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |94| `--include-hook-events` | Schließen Sie Hook-Lebenszyklusereignisse von jedem Hook-Ereignis in den Ausgabestrom ein. `SessionStart` und `Setup` Hook-Ereignisse sind immer enthalten und benötigen dieses Flag nicht. Erfordert `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |

95| `--include-partial-messages` | Schließen Sie partielle Streaming-Ereignisse in die Ausgabe ein. Erfordert `--print` und `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |95| `--include-partial-messages` | Schließen Sie partielle Streaming-Ereignisse in die Ausgabe ein. Erfordert `--print` und `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |

97| `--json-schema` | Erhalten Sie validierte JSON-Ausgabe, die einem JSON-Schema entspricht, nachdem der Agent seinen Workflow abgeschlossen hat (nur Print-Modus). Siehe [strukturierte Ausgaben](/de/agent-sdk/structured-outputs). {/* min-version: 2.1.205 */}Claude Code beendet sich mit einem Fehler bei einem ungültigen Schema und akzeptiert das `format` Schlüsselwort als Anmerkung ohne clientseitige Validierung. Vor v2.1.205 erzeugte ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler, und Schemas mit `format` wurden als ungültig behandelt | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |97| `--json-schema` | Erhalten Sie validierte JSON-Ausgabe, die einem JSON-Schema entspricht, nachdem der Agent seinen Workflow abgeschlossen hat (nur Print-Modus). Siehe [strukturierte Ausgaben](/docs/de/agent-sdk/structured-outputs). Claude Code beendet sich mit einem Fehler bei einem ungültigen Schema und akzeptiert das `format` Schlüsselwort als Anmerkung ohne clientseitige Validierung. Vor v2.1.205 erzeugte ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler, und Schemas mit `format` wurden als ungültig behandelt | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

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

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

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

103| `--name`, `-n` | Legen Sie einen Anzeigenamen für die Sitzung fest, der in `/resume` und der Terminalleiste angezeigt wird. Sie können eine benannte Sitzung mit `claude --resume <name>` fortsetzen. <br /><br />[`/rename`](/de/commands) ändert den Namen während der Sitzung und zeigt ihn auch in der Eingabeaufforderungsleiste an | `claude -n "my-feature-work"` |103| `--name`, `-n` | Legen Sie einen Anzeigenamen für die Sitzung fest, der in `/resume` und der Terminalleiste angezeigt wird. Sie können eine benannte Sitzung mit `claude --resume <name>` fortsetzen. <br /><br />[`/rename`](/docs/de/commands) ändert den Namen während der Sitzung und zeigt ihn auch in der Eingabeaufforderungsleiste an | `claude -n "my-feature-work"` |

105| `--no-session-persistence` | Deaktivieren Sie die Sitzungspersistenz, sodass Sitzungen nicht auf der Festplatte gespeichert werden und nicht fortgesetzt werden können. Nur Print-Modus. Die [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/de/env-vars) Umgebungsvariable bewirkt das Gleiche in jedem Modus | `claude -p --no-session-persistence "query"` |105| `--no-session-persistence` | Deaktivieren Sie die Sitzungspersistenz, sodass Sitzungen nicht auf der Festplatte gespeichert werden und nicht fortgesetzt werden können. Nur Print-Modus. Die [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/de/env-vars) Umgebungsvariable bewirkt das Gleiche in jedem Modus | `claude -p --no-session-persistence "query"` |

107| `--permission-mode` | Beginnen Sie in einem angegebenen [Berechtigungsmodus](/de/permission-modes). Akzeptiert `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` oder {/* min-version: 2.1.200 */}}`manual` als Alias für `default`. Der `manual` Alias wählt den Modus aus, den die Benutzeroberfläche als Manuell kennzeichnet und erfordert Claude Code v2.1.200 oder später; `claude --help` listet ihn anstelle von `default` auf, und beide Werte funktionieren. Überschreibt `defaultMode` aus Einstellungsdateien | `claude --permission-mode plan` |107| `--permission-mode` | Beginnen Sie in einem angegebenen [Berechtigungsmodus](/docs/de/permission-modes). Akzeptiert `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` oder }`manual` als Alias für `default`. Der `manual` Alias wählt den Modus aus, den die Benutzeroberfläche als Manuell kennzeichnet und erfordert Claude Code v2.1.200 oder später; `claude --help` listet ihn anstelle von `default` auf, und beide Werte funktionieren. Überschreibt `defaultMode` aus Einstellungsdateien | `claude --permission-mode plan` |

108| `--permission-prompt-tool` | Geben Sie ein MCP-Tool an, um Berechtigungsaufforderungen im nicht-interaktiven Modus zu verarbeiten. {/* min-version: 2.1.206 */}Claude Code wartet darauf, dass sich der MCP-Server dieses Tools verbindet, bevor der erste Turn ausgeführt wird, bis zum [`MCP_TIMEOUT`](/de/env-vars) Startup-Timeout von 30 Sekunden. Vor v2.1.206 konnte ein langsam startender Server dazu führen, dass die Ausführung [mit einem Fehler beendet wird, dass das MCP-Tool nicht gefunden wurde](/de/errors#mcp-permission-prompt-tool-not-found). <br /><br />{/* min-version: 2.1.199 */}Das Prompt-Tool kann ein MCP-Tool, das als [Benutzerinteraktion erforderlich](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet ist, nicht genehmigen: Claude Code konvertiert ein `allow` Ergebnis für eines in eine Ablehnung. Diese Einschränkung erfordert Claude Code v2.1.199 oder später | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |108| `--permission-prompt-tool` | Geben Sie ein MCP-Tool an, um Berechtigungsaufforderungen im nicht-interaktiven Modus zu verarbeiten. Claude Code wartet darauf, dass sich der MCP-Server dieses Tools verbindet, bevor der erste Turn ausgeführt wird, bis zum [`MCP_TIMEOUT`](/docs/de/env-vars) Startup-Timeout von 30 Sekunden. Vor v2.1.206 konnte ein langsam startender Server dazu führen, dass die Ausführung [mit einem Fehler beendet wird, dass das MCP-Tool nicht gefunden wurde](/docs/de/errors#mcp-permission-prompt-tool-not-found). <br /><br />Das Prompt-Tool kann ein MCP-Tool, das als [Benutzerinteraktion erforderlich](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet ist, nicht genehmigen: Claude Code konvertiert ein `allow` Ergebnis für eines in eine Ablehnung. Diese Einschränkung erfordert Claude Code v2.1.199 oder später | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

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

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

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

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

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

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

116| `--replay-user-messages` | Geben Sie Benutzernachrichten von stdin auf stdout zurück zur Bestätigung aus. Erfordert `--input-format stream-json` und `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |116| `--replay-user-messages` | Geben Sie Benutzernachrichten von stdin auf stdout zurück zur Bestätigung aus. Erfordert `--input-format stream-json` und `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |

117| `--resume`, `-r` | Setzen Sie eine bestimmte Sitzung nach ID oder Name fort, oder zeigen Sie eine interaktive Auswahl an, um eine Sitzung auszuwählen. Die Auswahl und Namenssuche schließen Sitzungen ein, die dieses Verzeichnis mit `/add-dir` hinzugefügt haben; das Übergeben einer Sitzungs-ID durchsucht nur das aktuelle Projektverzeichnis und seine Git Worktrees. Ab v2.1.144 erscheinen [Hintergrund-Sitzungen](/de/agent-view) in der Auswahl mit `bg` gekennzeichnet | `claude --resume auth-refactor` |117| `--resume`, `-r` | Setzen Sie eine bestimmte Sitzung nach ID oder Name fort, oder zeigen Sie eine interaktive Auswahl an, um eine Sitzung auszuwählen. Die Auswahl und Namenssuche schließen Sitzungen ein, die dieses Verzeichnis mit `/add-dir` hinzugefügt haben; das Übergeben einer Sitzungs-ID durchsucht nur das aktuelle Projektverzeichnis und seine Git Worktrees. Ab v2.1.144 erscheinen [Hintergrund-Sitzungen](/docs/de/agent-view) in der Auswahl mit `bg` gekennzeichnet | `claude --resume auth-refactor` |

118| `--safe-mode` | {/* min-version: 2.1.169 */}Starten Sie mit allen Anpassungen deaktiviert, um eine fehlerhafte Konfiguration zu beheben: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Designs, benutzerdefinierte Tastenkombinationen, Statusleiste und Dateivorschlag-Befehle, LSP-Server und Auto-Memory werden nicht geladen. Authentifizierung, Modellauswahl, integrierte Tools und Berechtigungen funktionieren normal, was sich von [`--bare`](/de/headless#start-faster-with-bare-mode) unterscheidet. Die verwaltete Einstellungsrichtlinie gilt weiterhin, einschließlich richtliniengesteuerter Hooks, Statusleiste und Dateivorschlag-Befehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und richtliniengesteuerter MCP-Server nicht. Nützlich, um zu überprüfen, ob eine Anpassung das [automatische Fallback von Fable 5](/de/model-config#automatic-model-fallback) auslöst. Setzt [`CLAUDE_CODE_SAFE_MODE`](/de/env-vars) | `claude --safe-mode` |118| `--safe-mode` | Starten Sie mit allen Anpassungen deaktiviert, um eine fehlerhafte Konfiguration zu beheben: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Designs, benutzerdefinierte Tastenkombinationen, Statusleiste und Dateivorschlag-Befehle, LSP-Server und Auto-Memory werden nicht geladen. Authentifizierung, Modellauswahl, integrierte Tools und Berechtigungen funktionieren normal, was sich von [`--bare`](/docs/de/headless#start-faster-with-bare-mode) unterscheidet. Die verwaltete Einstellungsrichtlinie gilt weiterhin, einschließlich richtliniengesteuerter Hooks, Statusleiste und Dateivorschlag-Befehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und richtliniengesteuerter MCP-Server nicht. Nützlich, um zu überprüfen, ob eine Anpassung das [automatische Fallback von Fable 5](/docs/de/model-config#automatic-model-fallback) auslöst. Setzt [`CLAUDE_CODE_SAFE_MODE`](/docs/de/env-vars) | `claude --safe-mode` |

119| `--session-id` | Verwenden Sie eine bestimmte Sitzungs-ID für die Konversation (muss eine gültige UUID sein) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |119| `--session-id` | Verwenden Sie eine bestimmte Sitzungs-ID für die Konversation (muss eine gültige UUID sein) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

121| `--settings` | Pfad zu einer Einstellungs-JSON-Datei oder eine JSON-Zeichenkette. Werte, die Sie hier setzen, überschreiben die gleichen Schlüssel in Ihren `settings.json` Dateien für diese Sitzung. Schlüssel, die Sie weglassen, behalten ihre dateigestützten Werte. Siehe [Einstellungspriorität](/de/settings#settings-precedence) | `claude --settings ./settings.json` |121| `--settings` | Pfad zu einer Einstellungs-JSON-Datei oder eine JSON-Zeichenkette. Werte, die Sie hier setzen, überschreiben die gleichen Schlüssel in Ihren `settings.json` Dateien für diese Sitzung. Schlüssel, die Sie weglassen, behalten ihre dateigestützten Werte. Siehe [Einstellungspriorität](/docs/de/settings#settings-precedence) | `claude --settings ./settings.json` |

122| `--strict-mcp-config` | Verwenden Sie nur MCP-Server aus `--mcp-config`, ignorieren Sie alle anderen MCP-Konfigurationen | `claude --strict-mcp-config --mcp-config ./mcp.json` |122| `--strict-mcp-config` | Verwenden Sie nur MCP-Server aus `--mcp-config`, ignorieren Sie alle anderen MCP-Konfigurationen | `claude --strict-mcp-config --mcp-config ./mcp.json` |

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

127| `--tmux` | Erstellen Sie eine tmux-Sitzung für den Worktree. Erfordert `--worktree`. Verwendet native iTerm2-Bereiche, wenn verfügbar; übergeben Sie `--tmux=classic` für traditionelles tmux | `claude -w feature-auth --tmux` |127| `--tmux` | Erstellen Sie eine tmux-Sitzung für den Worktree. Erfordert `--worktree`. Verwendet native iTerm2-Bereiche, wenn verfügbar; übergeben Sie `--tmux=classic` für traditionelles tmux | `claude -w feature-auth --tmux` |

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

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

131| `--worktree`, `-w` | Starten Sie Claude in einem isolierten [Git Worktree](/de/worktrees) bei `<repo>/.claude/worktrees/<name>`. Wenn kein Name angegeben wird, wird einer automatisch generiert. Übergeben Sie `#<number>` oder eine GitHub Pull Request URL, um diesen PR von `origin` abzurufen und den Worktree davon zu verzweigen | `claude -w feature-auth` |131| `--worktree`, `-w` | Starten Sie Claude in einem isolierten [Git Worktree](/docs/de/worktrees) bei `<repo>/.claude/worktrees/<name>`. Wenn kein Name angegeben wird, wird einer automatisch generiert. Übergeben Sie `#<number>` oder eine GitHub Pull Request URL, um diesen PR von `origin` abzurufen und den Worktree davon zu verzweigen | `claude -w feature-auth` |

132 132

133<h3 id="system-prompt-flags">133<h3 id="system-prompt-flags">

134 System-Prompt-Flags134 System-Prompt-Flags

147 147

148Wählen Sie basierend darauf, ob Claude Codes Standard-Identität noch zu Ihrer Aufgabe passt. Verwenden Sie ein Append-Flag, wenn Claude ein Coding-Assistent bleiben sollte, der auch Ihre zusätzlichen Regeln befolgt: Pro-Aufruf-Anweisungen, Ausgabeformatierung oder Domänenkontext für ein `-p` Skript. Das Anhängen bewahrt die Standard-Tool-Anleitung, Sicherheitsanweisungen und Coding-Konventionen, sodass Sie nur das liefern, was sich unterscheidet. Verwenden Sie ein Ersetzungs-Flag, wenn sich die Oberfläche, Identität oder das Berechtigungsmodell von Claude Code unterscheidet, wie ein Nicht-Coding-Agent in einer Pipeline, die kein Mensch überwacht. Das Ersetzen verwirft den gesamten Standard-Prompt, einschließlich Tool-Anleitung und Sicherheitsanweisungen, sodass Sie die Verantwortung für das übernehmen, was Ihre Aufgabe noch benötigt.148Wählen Sie basierend darauf, ob Claude Codes Standard-Identität noch zu Ihrer Aufgabe passt. Verwenden Sie ein Append-Flag, wenn Claude ein Coding-Assistent bleiben sollte, der auch Ihre zusätzlichen Regeln befolgt: Pro-Aufruf-Anweisungen, Ausgabeformatierung oder Domänenkontext für ein `-p` Skript. Das Anhängen bewahrt die Standard-Tool-Anleitung, Sicherheitsanweisungen und Coding-Konventionen, sodass Sie nur das liefern, was sich unterscheidet. Verwenden Sie ein Ersetzungs-Flag, wenn sich die Oberfläche, Identität oder das Berechtigungsmodell von Claude Code unterscheidet, wie ein Nicht-Coding-Agent in einer Pipeline, die kein Mensch überwacht. Das Ersetzen verwirft den gesamten Standard-Prompt, einschließlich Tool-Anleitung und Sicherheitsanweisungen, sodass Sie die Verantwortung für das übernehmen, was Ihre Aufgabe noch benötigt.

149 149

150Diese Flags gelten nur für den aktuellen Aufruf. Für persistente Personas, die Sie zwischen verschiedenen Projekten wechseln und teilen können, verwenden Sie [Ausgabestile](/de/output-styles). Für Projektkonventionen, die Claude immer befolgen sollte, verwenden Sie [CLAUDE.md](/de/memory). Der [Agent SDK-Leitfaden zu Systemprompts](/de/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) behandelt die gleiche Entscheidung ausführlicher.150Diese Flags gelten nur für den aktuellen Aufruf. Für persistente Personas, die Sie zwischen verschiedenen Projekten wechseln und teilen können, verwenden Sie [Ausgabestile](/docs/de/output-styles). Für Projektkonventionen, die Claude immer befolgen sollte, verwenden Sie [CLAUDE.md](/docs/de/memory). Der [Agent SDK-Leitfaden zu Systemprompts](/docs/de/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) behandelt die gleiche Entscheidung ausführlicher.

151 151

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

153 Siehe auch153 Siehe auch

154</h2>154</h2>

155 155

156* [Chrome-Erweiterung](/de/chrome) - Browser-Automatisierung und Web-Tests156* [Chrome-Erweiterung](/docs/de/chrome) - Browser-Automatisierung und Web-Tests

157* [Interaktiver Modus](/de/interactive-mode) - Tastenkombinationen, Eingabemodi und interaktive Funktionen157* [Interaktiver Modus](/docs/de/interactive-mode) - Tastenkombinationen, Eingabemodi und interaktive Funktionen

158* [Schnellstart-Anleitung](/de/quickstart) - Erste Schritte mit Claude Code158* [Schnellstart-Anleitung](/docs/de/quickstart) - Erste Schritte mit Claude Code

159* [Häufige Workflows](/de/common-workflows) - Erweiterte Workflows und Muster159* [Häufige Workflows](/docs/de/common-workflows) - Erweiterte Workflows und Muster

160* [Einstellungen](/de/settings) - Konfigurationsoptionen160* [Einstellungen](/docs/de/settings) - Konfigurationsoptionen

161* [Agent SDK-Dokumentation](/de/agent-sdk/overview) - Programmatische Verwendung und Integrationen161* [Agent SDK-Dokumentation](/docs/de/agent-sdk/overview) - Programmatische Verwendung und Integrationen

code-review.md +14 −14

Details

7> Richten Sie automatisierte PR-Reviews ein, die Logikfehler, Sicherheitslücken und Regressionen durch Multi-Agent-Analyse Ihrer vollständigen Codebasis erkennen7> Richten Sie automatisierte PR-Reviews ein, die Logikfehler, Sicherheitslücken und Regressionen durch Multi-Agent-Analyse Ihrer vollständigen Codebasis erkennen

8 8

9<Note>9<Note>

10 Code Review befindet sich in der Forschungsvorschau und ist für [Teams und Enterprise](https://claude.ai/admin-settings/claude-code) Abonnements verfügbar. Es ist nicht verfügbar für Organisationen mit [Zero Data Retention](/de/zero-data-retention) aktiviert.10 Code Review befindet sich in der Forschungsvorschau und ist für [Teams und Enterprise](https://claude.ai/admin-settings/claude-code) Abonnements verfügbar. Es ist nicht verfügbar für Organisationen mit [Zero Data Retention](/docs/de/zero-data-retention) aktiviert.

11</Note>11</Note>

12 12

13Code Review analysiert Ihre GitHub Pull Requests und veröffentlicht Erkenntnisse als Inline-Kommentare auf den Codezeilen, auf denen Probleme gefunden wurden. Eine Flotte spezialisierter Agenten untersucht die Codeänderungen im Kontext Ihrer vollständigen Codebasis und sucht nach Logikfehlern, Sicherheitslücken, fehlerhaften Grenzfällen und subtilen Regressionen.13Code Review analysiert Ihre GitHub Pull Requests und veröffentlicht Erkenntnisse als Inline-Kommentare auf den Codezeilen, auf denen Probleme gefunden wurden. Eine Flotte spezialisierter Agenten untersucht die Codeänderungen im Kontext Ihrer vollständigen Codebasis und sucht nach Logikfehlern, Sicherheitslücken, fehlerhaften Grenzfällen und subtilen Regressionen.

14 14

15Erkenntnisse werden nach Schweregrad gekennzeichnet und genehmigen oder blockieren Ihren PR nicht, sodass bestehende Review-Workflows intakt bleiben. Sie können anpassen, was Claude kennzeichnet, indem Sie eine `CLAUDE.md` oder `REVIEW.md` Datei zu Ihrem Repository hinzufügen.15Erkenntnisse werden nach Schweregrad gekennzeichnet und genehmigen oder blockieren Ihren PR nicht, sodass bestehende Review-Workflows intakt bleiben. Sie können anpassen, was Claude kennzeichnet, indem Sie eine `CLAUDE.md` oder `REVIEW.md` Datei zu Ihrem Repository hinzufügen.

16 16

17Um Claude in Ihrer eigenen CI-Infrastruktur statt dieses verwalteten Dienstes auszuführen, siehe [GitHub Actions](/de/github-actions) oder [GitLab CI/CD](/de/gitlab-ci-cd). Für Repositorys auf einer selbst gehosteten GitHub-Instanz siehe [GitHub Enterprise Server](/de/github-enterprise-server).17Um Claude in Ihrer eigenen CI-Infrastruktur statt dieses verwalteten Dienstes auszuführen, siehe [GitHub Actions](/docs/de/github-actions) oder [GitLab CI/CD](/docs/de/gitlab-ci-cd). Für Repositorys auf einer selbst gehosteten GitHub-Instanz siehe [GitHub Enterprise Server](/docs/de/github-enterprise-server).

18 18

19Diese Seite behandelt:19Diese Seite behandelt:

20 20

112 * **Issues**: Lesen und Schreiben112 * **Issues**: Lesen und Schreiben

113 * **Pull requests**: Lesen und Schreiben113 * **Pull requests**: Lesen und Schreiben

114 114

115 Code Review verwendet Lesezugriff auf Inhalte und Schreibzugriff auf Pull Requests. Der breitere Berechtigungssatz unterstützt auch [GitHub Actions](/de/github-actions), wenn Sie diese später aktivieren.115 Code Review verwendet Lesezugriff auf Inhalte und Schreibzugriff auf Pull Requests. Der breitere Berechtigungssatz unterstützt auch [GitHub Actions](/docs/de/github-actions), wenn Sie diese später aktivieren.

116 </Step>116 </Step>

117 117

118 <Step title="Wählen Sie Repositorys aus">118 <Step title="Wählen Sie Repositorys aus">

173 173

174Code Review liest Ihre Repository-`CLAUDE.md` Dateien und behandelt neu eingeführte Verstöße als [Nit-Level](#severity-levels) Erkenntnisse. Dies funktioniert bidirektional: Wenn Ihr PR Code auf eine Weise ändert, die eine `CLAUDE.md` Aussage veraltet macht, kennzeichnet Claude, dass die Dokumentation aktualisiert werden muss.174Code Review liest Ihre Repository-`CLAUDE.md` Dateien und behandelt neu eingeführte Verstöße als [Nit-Level](#severity-levels) Erkenntnisse. Dies funktioniert bidirektional: Wenn Ihr PR Code auf eine Weise ändert, die eine `CLAUDE.md` Aussage veraltet macht, kennzeichnet Claude, dass die Dokumentation aktualisiert werden muss.

175 175

176Claude liest `CLAUDE.md` Dateien auf jeder Ebene Ihrer Verzeichnishierarchie, sodass Regeln in einer Unterverzeichnis-`CLAUDE.md` nur auf Dateien unter diesem Pfad angewendet werden. Weitere Informationen zur Funktionsweise von `CLAUDE.md` finden Sie in der [Memory-Dokumentation](/de/memory).176Claude liest `CLAUDE.md` Dateien auf jeder Ebene Ihrer Verzeichnishierarchie, sodass Regeln in einer Unterverzeichnis-`CLAUDE.md` nur auf Dateien unter diesem Pfad angewendet werden. Weitere Informationen zur Funktionsweise von `CLAUDE.md` finden Sie in der [Memory-Dokumentation](/docs/de/memory).

177 177

178Für Review-spezifische Anleitungen, die Sie nicht auf allgemeine Claude Code Sitzungen angewendet haben möchten, verwenden Sie stattdessen [`REVIEW.md`](#review-md).178Für Review-spezifische Anleitungen, die Sie nicht auf allgemeine Claude Code Sitzungen angewendet haben möchten, verwenden Sie stattdessen [`REVIEW.md`](#review-md).

179 179

183 183

184`REVIEW.md` ist eine Datei in Ihrem Repository-Root, die überschreibt, wie Code Review auf Ihrem Repo verhält. Sein Inhalt wird in den System-Prompt jedes Agenten in der Review-Pipeline als höchste Prioritäts-Anweisungsblock eingefügt und hat Vorrang vor der Standard-Review-Anleitung.184`REVIEW.md` ist eine Datei in Ihrem Repository-Root, die überschreibt, wie Code Review auf Ihrem Repo verhält. Sein Inhalt wird in den System-Prompt jedes Agenten in der Review-Pipeline als höchste Prioritäts-Anweisungsblock eingefügt und hat Vorrang vor der Standard-Review-Anleitung.

185 185

186Da es wörtlich eingefügt wird, ist `REVIEW.md` einfache Anweisungen: [`@` Import-Syntax](/de/memory#import-additional-files) wird nicht erweitert, und referenzierte Dateien werden nicht in den Prompt gelesen. Setzen Sie die Regeln, die Sie durchgesetzt haben möchten, direkt in die Datei.186Da es wörtlich eingefügt wird, ist `REVIEW.md` einfache Anweisungen: [`@` Import-Syntax](/docs/de/memory#import-additional-files) wird nicht erweitert, und referenzierte Dateien werden nicht in den Prompt gelesen. Setzen Sie die Regeln, die Sie durchgesetzt haben möchten, direkt in die Datei.

187 187

188<h4 id="what-you-can-tune">188<h4 id="what-you-can-tune">

189 Was Sie optimieren können189 Was Sie optimieren können

315 Überprüfung eines Diffs lokal315 Überprüfung eines Diffs lokal

316</h2>316</h2>

317 317

318Der [`/code-review` Befehl](/de/commands) überprüft einen Diff in Ihrem Terminal ohne Installation der GitHub App. Führen Sie ihn in einer beliebigen Claude Code Sitzung aus: er meldet Korrektheitsfehler und {/* min-version: 2.1.151 */}Wiederverwendung, Vereinfachung und Effizienz-Bereinigungen. Standardmäßig deckt die lokale Überprüfung die Commits Ihres Branches vor seinem Upstream plus alle nicht committeten Änderungen im Arbeitsbaum ab. Übergeben Sie `--comment`, um Erkenntnisse als Inline-PR-Kommentare zu veröffentlichen, oder `--fix`, um die Erkenntnisse auf Ihren Arbeitsbaum anzuwenden, nachdem die Überprüfung abgeschlossen ist.318Der [`/code-review` Befehl](/docs/de/commands) überprüft einen Diff in Ihrem Terminal ohne Installation der GitHub App. Führen Sie ihn in einer beliebigen Claude Code Sitzung aus: er meldet Korrektheitsfehler und Wiederverwendung, Vereinfachung und Effizienz-Bereinigungen. Standardmäßig deckt die lokale Überprüfung die Commits Ihres Branches vor seinem Upstream plus alle nicht committeten Änderungen im Arbeitsbaum ab. Übergeben Sie `--comment`, um Erkenntnisse als Inline-PR-Kommentare zu veröffentlichen, oder `--fix`, um die Erkenntnisse auf Ihren Arbeitsbaum anzuwenden, nachdem die Überprüfung abgeschlossen ist.

319 319

320Niedrigere [Aufwandsebenen](/de/model-config#adjust-effort-level) geben weniger, höher vertrauenswürdige Erkenntnisse zurück, während `high` bis `max` breitere Abdeckung geben und unsichere Erkenntnisse einschließen können. Ohne ein Aufwandsargument verwendet die Überprüfung die aktuelle Aufwandsebene der Sitzung. Um etwas anderes als den Standard-Diff zu überprüfen, übergeben Sie ein Ziel: einen Dateipfad, eine PR-Nummer, einen Branch-Namen oder einen Ref-Bereich wie `main...my-feature`. Die Ref-Bereichsform überprüft den committeten Diff, den ein Pull Request von `my-feature` in `main` enthalten würde, unabhängig davon, wie der Upstream des Branches konfiguriert ist.320Niedrigere [Aufwandsebenen](/docs/de/model-config#adjust-effort-level) geben weniger, höher vertrauenswürdige Erkenntnisse zurück, während `high` bis `max` breitere Abdeckung geben und unsichere Erkenntnisse einschließen können. Ohne ein Aufwandsargument verwendet die Überprüfung die aktuelle Aufwandsebene der Sitzung. Um etwas anderes als den Standard-Diff zu überprüfen, übergeben Sie ein Ziel: einen Dateipfad, eine PR-Nummer, einen Branch-Namen oder einen Ref-Bereich wie `main...my-feature`. Die Ref-Bereichsform überprüft den committeten Diff, den ein Pull Request von `my-feature` in `main` enthalten würde, unabhängig davon, wie der Upstream des Branches konfiguriert ist.

321 321

322`/code-review ultra --fix` führt die tiefere [ultrareview](/de/ultrareview) in der Cloud aus, dann wendet ihre Erkenntnisse auf Ihren Arbeitsbaum an, wenn sie in Ihrer Sitzung zurückkommen. Ultrareview verwendet seinen eigenen Umfang: Ihren aktuellen Branch gegen den Standard-Branch des Repositorys, plus alle nicht committeten und gestaged Änderungen im Arbeitsbaum.322`/code-review ultra --fix` führt die tiefere [ultrareview](/docs/de/ultrareview) in der Cloud aus, dann wendet ihre Erkenntnisse auf Ihren Arbeitsbaum an, wenn sie in Ihrer Sitzung zurückkommen. Ultrareview verwendet seinen eigenen Umfang: Ihren aktuellen Branch gegen den Standard-Branch des Repositorys, plus alle nicht committeten und gestaged Änderungen im Arbeitsbaum.

323 323

324Der Befehl hieß vor v2.1.147 `/simplify`, als er Fixes standardmäßig anwendete. {/* min-version: 2.1.154 */}Ab v2.1.154 führt `/simplify` eine separate Bereinigung-nur-Überprüfung durch, die Fixes anwendet, ohne nach Fehlern zu suchen. Wenn Sie `/simplify` für die Fehlersuche skriptet haben, wechseln Sie zu `/code-review --fix`, das unverändert ist.324Der Befehl hieß vor v2.1.147 `/simplify`, als er Fixes standardmäßig anwendete. Ab v2.1.154 führt `/simplify` eine separate Bereinigung-nur-Überprüfung durch, die Fixes anwendet, ohne nach Fehlern zu suchen. Wenn Sie `/simplify` für die Fehlersuche skriptet haben, wechseln Sie zu `/code-review --fix`, das unverändert ist.

325 325

326<h2 id="related-resources">326<h2 id="related-resources">

327 Verwandte Ressourcen327 Verwandte Ressourcen

329 329

330Code Review ist so konzipiert, dass es neben dem Rest von Claude Code funktioniert. Wenn Sie Reviews lokal ausführen möchten, bevor Sie einen PR öffnen, eine selbst gehostete Einrichtung benötigen oder tiefer verstehen möchten, wie `CLAUDE.md` Claudes Verhalten über Tools hinweg prägt, sind diese Seiten gute nächste Schritte:330Code Review ist so konzipiert, dass es neben dem Rest von Claude Code funktioniert. Wenn Sie Reviews lokal ausführen möchten, bevor Sie einen PR öffnen, eine selbst gehostete Einrichtung benötigen oder tiefer verstehen möchten, wie `CLAUDE.md` Claudes Verhalten über Tools hinweg prägt, sind diese Seiten gute nächste Schritte:

331 331

332* [Befehle](/de/commands): führen Sie `/code-review` in einer lokalen Claude Code Sitzung aus, um einen Diff vor dem Pushen zu überprüfen332* [Befehle](/docs/de/commands): führen Sie `/code-review` in einer lokalen Claude Code Sitzung aus, um einen Diff vor dem Pushen zu überprüfen

333* [GitHub Actions](/de/github-actions): führen Sie Claude in Ihren eigenen GitHub Actions Workflows aus für benutzerdefinierte Automatisierung über Code Review hinaus333* [GitHub Actions](/docs/de/github-actions): führen Sie Claude in Ihren eigenen GitHub Actions Workflows aus für benutzerdefinierte Automatisierung über Code Review hinaus

334* [GitLab CI/CD](/de/gitlab-ci-cd): selbst gehostete Claude-Integration für GitLab-Pipelines334* [GitLab CI/CD](/docs/de/gitlab-ci-cd): selbst gehostete Claude-Integration für GitLab-Pipelines

335* [Memory](/de/memory): wie `CLAUDE.md` Dateien über Claude Code funktionieren335* [Memory](/docs/de/memory): wie `CLAUDE.md` Dateien über Claude Code funktionieren

336* [Analytics](/de/analytics): verfolgen Sie Claude Code Nutzung über Code Review hinaus336* [Analytics](/docs/de/analytics): verfolgen Sie Claude Code Nutzung über Code Review hinaus

commands.md +85 −85

Details

10 10

11Geben Sie `/` ein, um jeden verfügbaren Befehl anzuzeigen, oder geben Sie `/` gefolgt von Buchstaben ein, um zu filtern.11Geben Sie `/` ein, um jeden verfügbaren Befehl anzuzeigen, oder geben Sie `/` gefolgt von Buchstaben ein, um zu filtern.

12 12

13Ein Befehl wird nur am Anfang Ihrer Nachricht erkannt. Text, der dem Befehlsnamen folgt, wird als Argumente an ihn übergeben. {/* min-version: 2.1.199 */}Ab v2.1.199 sind [Skills](/de/skills#pass-arguments-to-skills) die Ausnahme: Ein Skill-Aufruf gefolgt von weiteren Skills, wie z. B. `/skill-a /skill-b do XYZ`, lädt jeden Skill am Anfang und übergibt den nachfolgenden Text als Argumente an jeden. Bis zu sechs Skills können verkettet werden.13Ein Befehl wird nur am Anfang Ihrer Nachricht erkannt. Text, der dem Befehlsnamen folgt, wird als Argumente an ihn übergeben. Ab v2.1.199 sind [Skills](/docs/de/skills#pass-arguments-to-skills) die Ausnahme: Ein Skill-Aufruf gefolgt von weiteren Skills, wie z. B. `/skill-a /skill-b do XYZ`, lädt jeden Skill am Anfang und übergibt den nachfolgenden Text als Argumente an jeden. Bis zu sechs Skills können verkettet werden.

14 14

15Wenn Sie einen Befehl senden, während Claude antwortet, wird er in die Warteschlange eingereiht und nach Abschluss des aktuellen Durchgangs ausgeführt. Einige Befehle, wie z. B. `/status`, `/tasks` und `/usage`, werden sofort ausgeführt, ohne die Antwort zu unterbrechen.15Wenn Sie einen Befehl senden, während Claude antwortet, wird er in die Warteschlange eingereiht und nach Abschluss des aktuellen Durchgangs ausgeführt. Einige Befehle, wie z. B. `/status`, `/tasks` und `/usage`, werden sofort ausgeführt, ohne die Antwort zu unterbrechen.

16 16

20 20

21Die meisten Befehle sind an einem bestimmten Punkt in einer Sitzung nützlich, vom Einrichten eines Projekts bis zum Versand einer Änderung.21Die meisten Befehle sind an einem bestimmten Punkt in einer Sitzung nützlich, vom Einrichten eines Projekts bis zum Versand einer Änderung.

22 22

23**Erste Sitzung in einem Repository.** Führen Sie `/init` aus, um eine Starter-`CLAUDE.md` zu generieren, dann `/memory`, um sie zu verfeinern. Verwenden Sie `/mcp`, um alle Server einzurichten, die das Projekt benötigt, bitten Sie Claude, alle [Subagenten](/de/sub-agents) zu erstellen, die Sie möchten, und führen Sie `/permissions` aus, um Ihre Genehmigungsregeln festzulegen.23**Erste Sitzung in einem Repository.** Führen Sie `/init` aus, um eine Starter-`CLAUDE.md` zu generieren, dann `/memory`, um sie zu verfeinern. Verwenden Sie `/mcp`, um alle Server einzurichten, die das Projekt benötigt, bitten Sie Claude, alle [Subagenten](/docs/de/sub-agents) zu erstellen, die Sie möchten, und führen Sie `/permissions` aus, um Ihre Genehmigungsregeln festzulegen.

24 24

25**Während einer Aufgabe.** `/plan` wechselt vor einer großen Änderung in den Plan-Modus. `/model` und `/effort` passen an, welches Modell Sie verwenden, und wie viel Reasoning es anwendet. Wenn das Gespräch lang wird, zeigt `/context`, was das Fenster ausfüllt, und `/compact` fasst es zusammen, um Platz freizugeben. Verwenden Sie `/btw` für eine schnelle Nebenbemerkung, die die Gesprächshistorie nicht aufblähen sollte.25**Während einer Aufgabe.** `/plan` wechselt vor einer großen Änderung in den Plan-Modus. `/model` und `/effort` passen an, welches Modell Sie verwenden, und wie viel Reasoning es anwendet. Wenn das Gespräch lang wird, zeigt `/context`, was das Fenster ausfüllt, und `/compact` fasst es zusammen, um Platz freizugeben. Verwenden Sie `/btw` für eine schnelle Nebenbemerkung, die die Gesprächshistorie nicht aufblähen sollte.

26 26

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

28 28

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

30 30

38 38

39Die folgende Tabelle listet alle in Claude Code enthaltenen Befehle auf. 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 in die CLI codiert ist. Zwei Arten von Einträgen sind gekennzeichnet:

40 40

41* **[Skill](/de/skills#bundled-skills)**: ein gebündelter Skill. Er funktioniert wie Skills, die Sie selbst schreiben: eine Eingabeaufforderung, die Claude übergeben wird und die Claude auch automatisch aufrufen kann, wenn relevant.41* **[Skill](/docs/de/skills#bundled-skills)**: ein gebündelter Skill. Er funktioniert wie Skills, die Sie selbst schreiben: eine Eingabeaufforderung, die Claude übergeben wird und die Claude auch automatisch aufrufen kann, wenn relevant.

~~42* **[Workflow](/de/workflows#bundled-workflows)**: ein gebündelter [dynamischer Workflow](/de/workflows), der Arbeit über viele Subagenten verteilt und im Hintergrund läuft.~~42* **[Workflow](/docs/de/workflows#bundled-workflows)**: ein gebündelter [dynamischer Workflow](/docs/de/workflows), der Arbeit über viele Subagenten verteilt und im Hintergrund läuft.

43 43

~~44Um Ihre eigenen Befehle hinzuzufügen, siehe [Skills](/de/skills).~~44Um Ihre eigenen Befehle hinzuzufügen, siehe [Skills](/docs/de/skills).

45 45

46In der folgenden Tabelle gibt `<arg>` ein erforderliches Argument an und `[arg]` ein optionales.46In der folgenden Tabelle gibt `<arg>` ein erforderliches Argument an und `[arg]` ein optionales.

47 47

50</Note>50</Note>

51 51

53| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |53| :--------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

54| `/add-dir <path>` | Fügen Sie ein Arbeitsverzeichnis für den Dateizugriff während der aktuellen Sitzung hinzu. Wenn Sie einen Teilpfad eingeben, werden passende Verzeichnisvorschläge angezeigt; drücken Sie `Tab`, um einen zu akzeptieren. Die meisten `.claude/`-Konfigurationen werden [nicht erkannt](/de/permissions#additional-directories-grant-file-access-not-configuration) aus dem hinzugefügten Verzeichnis. Sie können die Sitzung später aus dem hinzugefügten Verzeichnis mit `--continue` oder `--resume` fortsetzen |54| `/add-dir <path>` | Fügen Sie ein Arbeitsverzeichnis für den Dateizugriff während der aktuellen Sitzung hinzu. Wenn Sie einen Teilpfad eingeben, werden passende Verzeichnisvorschläge angezeigt; 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 Sitzung später aus dem hinzugefügten Verzeichnis mit `--continue` oder `--resume` fortsetzen |

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

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

57| `/autofix-pr [prompt]` | Starten Sie eine [Claude Code im Web](/de/claude-code-on-the-web#auto-fix-pull-requests)-Sitzung, die den aktuellen Branch-PR ü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 eine Eingabeaufforderung, um ihr andere Anweisungen zu geben, zum Beispiel `/autofix-pr only fix lint and type errors`. Erfordert die `gh` CLI und Zugriff auf [Claude Code im Web](/de/claude-code-on-the-web) |57| `/autofix-pr [prompt]` | Starten Sie eine [Claude Code im Web](/docs/de/claude-code-on-the-web#auto-fix-pull-requests)-Sitzung, die den aktuellen Branch-PR ü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 eine Eingabeaufforderung, um ihr andere Anweisungen zu geben, zum Beispiel `/autofix-pr only fix lint and type errors`. Erfordert die `gh` CLI und Zugriff auf [Claude Code im Web](/docs/de/claude-code-on-the-web) |

58| `/background [prompt]` | Trennen Sie die aktuelle Sitzung, um als [Hintergrund-Agent](/de/agent-view) zu laufen und dieses Terminal freizugeben. Übergeben Sie eine Eingabeaufforderung, um eine weitere Anweisung vor dem Trennen zu senden. Überwachen Sie die Sitzung mit `claude agents`. Alias: `/bg` |58| `/background [prompt]` | Trennen Sie die aktuelle Sitzung, um als [Hintergrund-Agent](/docs/de/agent-view) zu laufen und dieses Terminal freizugeben. Übergeben Sie eine Eingabeaufforderung, um eine weitere Anweisung vor dem Trennen zu senden. Überwachen Sie die Sitzung mit `claude agents`. Alias: `/bg` |

59| `/batch <instruction>` | **[Skill](/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](/de/sub-agents#run-subagents-in-foreground-or-background) pro Einheit in einem isolierten [Git-Worktree](/de/worktrees). Jeder Subagent implementiert seine Einheit, führt Tests aus und öffnet einen Pull Request. Erfordert ein Git-Repository. Beispiel: `/batch migrate src/ from Solid to React` |59| `/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 [Git-Worktree](/docs/de/worktrees). Jeder Subagent implementiert seine Einheit, führt Tests aus und öffnet einen Pull Request. Erfordert ein Git-Repository. Beispiel: `/batch migrate src/ from Solid to React` |

60| `/branch [name]` | Erstellen Sie einen Branch des aktuellen Gesprächs an dieser Stelle, um eine andere Richtung zu versuchen, ohne das Gespräch zu verlieren, wie es ist. Wechselt Sie in den Branch und bewahrt das Original, zu dem Sie mit `/resume` zurückkehren können. Um eine Nebenaufgabe stattdessen an einen Hintergrund-Subagenten zu übergeben, anstatt selbst in eine Kopie zu wechseln, verwenden Sie `/fork` |60| `/branch [name]` | Erstellen Sie einen Branch des aktuellen Gesprächs an dieser Stelle, um eine andere Richtung zu versuchen, ohne das Gespräch zu verlieren, wie es ist. Wechselt Sie in den Branch und bewahrt das Original, zu dem Sie mit `/resume` zurückkehren können. Um eine Nebenaufgabe stattdessen an einen Hintergrund-Subagenten zu übergeben, anstatt selbst in eine Kopie zu wechseln, verwenden Sie `/fork` |

61| `/btw <question>` | Stellen Sie eine schnelle [Nebenfrage](/de/interactive-mode#side-questions-with-%2Fbtw) ohne Hinzufügen zum Gespräch |61| `/btw <question>` | Stellen Sie eine schnelle [Nebenfrage](/docs/de/interactive-mode#side-questions-with-%2Fbtw) ohne Hinzufügen zum Gespräch |

62| `/cd <path>` | {/* min-version: 2.1.169 */}Verschieben Sie diese Sitzung in ein neues Arbeitsverzeichnis. Der Prompt-Cache des Gesprächs wird beibehalten: die [`CLAUDE.md`](/de/memory) des neuen Verzeichnisses wird als Nachricht angehängt, anstatt das Systemprompt neu zu erstellen. Die Sitzung wird in den Projektspeicher des neuen Verzeichnisses verschoben, sodass `--resume` und `--continue` sie von dort aus finden. Fordert Sie auf, das Verzeichnis zu vertrauen, wenn Sie noch nicht darin gearbeitet haben. {/* min-version: 2.1.206 */}Wenn Sie einen Teilpfad eingeben, werden passende Verzeichnisvorschläge angezeigt; drücken Sie `Tab`, um einen zu akzeptieren. Die Vorschläge erfordern Claude Code v2.1.206 oder später. Um Zugriff auf ein zusätzliches Verzeichnis zu gewähren, ohne die Sitzung zu verschieben, verwenden Sie `/add-dir`. Beschränken oder deaktivieren Sie `/cd`-Ziele mit [`Cd`-Berechtigungsregeln](/de/permissions#cd). Erfordert Claude Code v2.1.169 oder später; frühere Versionen melden `Unknown command: /cd` |62| `/cd <path>` | Verschieben Sie diese Sitzung in ein neues Arbeitsverzeichnis. Der Prompt-Cache des Gesprächs wird beibehalten: die [`CLAUDE.md`](/docs/de/memory) des neuen Verzeichnisses wird als Nachricht angehängt, anstatt das Systemprompt neu zu erstellen. Die Sitzung wird in den Projektspeicher des neuen Verzeichnisses verschoben, sodass `--resume` und `--continue` sie von dort aus finden. Fordert Sie auf, das Verzeichnis zu vertrauen, wenn Sie noch nicht darin gearbeitet haben. Wenn Sie einen Teilpfad eingeben, werden passende Verzeichnisvorschläge angezeigt; drücken Sie `Tab`, um einen zu akzeptieren. Die Vorschläge erfordern Claude Code v2.1.206 oder später. Um Zugriff auf ein zusätzliches Verzeichnis zu gewähren, ohne die Sitzung zu verschieben, verwenden Sie `/add-dir`. Beschränken oder deaktivieren Sie `/cd`-Ziele mit [`Cd`-Berechtigungsregeln](/docs/de/permissions#cd). Erfordert Claude Code v2.1.169 oder später; frühere Versionen melden `Unknown command: /cd` |

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

65| `/clear [name]` | Starten Sie ein neues Gespräch mit leerem Kontext. Übergeben Sie einen Namen, um das vorherige Gespräch in der `/resume`-Auswahl zu kennzeichnen. Um Kontext freizugeben und gleichzeitig das gleiche Gespräch fortzusetzen, verwenden Sie stattdessen `/compact`. Setzen Sie das vorherige Gespräch mit `/resume` fort, oder stellen Sie es in demselben Claude Code-Prozess {/* min-version: 2.1.191 */}aus [dem Rewind-Menü-Eintrag für vorherige Sitzung](/de/checkpointing#rewind-past-a-cleared-conversation) wieder her. Aliase: `/reset`, `/new` |65| `/clear [name]` | Starten Sie ein neues Gespräch mit leerem Kontext. Übergeben Sie einen Namen, um das vorherige Gespräch in der `/resume`-Auswahl zu kennzeichnen. Um Kontext freizugeben und gleichzeitig das gleiche Gespräch fortzusetzen, verwenden Sie stattdessen `/compact`. Setzen Sie das vorherige Gespräch mit `/resume` fort, oder stellen Sie es in demselben Claude Code-Prozess aus [dem Rewind-Menü-Eintrag für vorherige Sitzung](/docs/de/checkpointing#rewind-past-a-cleared-conversation) wieder her. Aliase: `/reset`, `/new` |

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

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

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

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

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

71| `/copy [N]` | Kopieren Sie die letzte Antwort des Assistenten in die Zwischenablage. Übergeben Sie eine Zahl `N`, um die N-te letzte Antwort zu kopieren: `/copy 2` kopiert die vorletzte. Wenn Codeblöcke vorhanden sind, wird eine interaktive Auswahl angezeigt, 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, anstatt sie in die Zwischenablage zu kopieren, was über SSH nützlich ist |71| `/copy [N]` | Kopieren Sie die letzte Antwort des Assistenten in die Zwischenablage. Übergeben Sie eine Zahl `N`, um die N-te letzte Antwort zu kopieren: `/copy 2` kopiert die vorletzte. Wenn Codeblöcke vorhanden sind, wird eine interaktive Auswahl angezeigt, 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, anstatt sie in die Zwischenablage zu kopieren, was über SSH nützlich ist |

73| `/dataviz [request]` | **[Skill](/de/skills#bundled-skills).** Designanleitung für Diagramme, Grafiken und Dashboards. Claude wählt die Diagrammform für die Daten, weist Farbe nach Rolle zu, validiert die Palette auf Farbenblindheit-Sicherheit und Kontrast mit einem gebündelten Skript und wendet Mark-, Interaktions- und Barrierefreiheitsregeln an. Verwendet eine markenunabhängige Platzhalterpalette, die Sie durch Ihre eigene ersetzen. {/* min-version: 2.1.198 */}Erfordert Claude Code v2.1.198 oder später |73| `/dataviz [request]` | **[Skill](/docs/de/skills#bundled-skills).** Designanleitung für Diagramme, Grafiken und Dashboards. Claude wählt die Diagrammform für die Daten, weist Farbe nach Rolle zu, validiert die Palette auf Farbenblindheit-Sicherheit und Kontrast mit einem gebündelten Skript und wendet Mark-, Interaktions- und Barrierefreiheitsregeln an. Verwendet eine markenunabhängige Platzhalterpalette, die Sie durch Ihre eigene ersetzen. Erfordert Claude Code v2.1.198 oder später |

74| `/debug [description]` | **[Skill](/de/skills#bundled-skills).** Aktivieren Sie Debug-Protokollierung für die aktuelle Sitzung und beheben Sie Probleme durch Lesen des Sitzungs-Debug-Protokolls. Debug-Protokollierung ist standardmäßig deaktiviert, es sei denn, Sie haben mit `claude --debug` gestartet, daher startet die Ausführung von `/debug` während der Sitzung die Erfassung von Protokollen ab diesem Punkt. Beschreiben Sie optional das Problem, um die Analyse zu fokussieren |74| `/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` während der Sitzung die Erfassung von Protokollen ab diesem Punkt. Beschreiben Sie optional das Problem, um die Analyse zu fokussieren |

75| `/deep-research <question>` | **[Workflow](/de/workflows#bundled-workflows).** Verteilen Sie Web-Suchen zu einer Frage, rufen Sie Quellen ab und überprüfen Sie sie, und synthetisieren Sie einen zitierten Bericht |75| `/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 |

77| `/design-sync [hint]` | **[Skill](/de/skills#bundled-skills).** Konvertieren Sie das React-Design-System Ihres Repos und laden Sie es zu [Claude Design](https://claude.ai/design) hoch, damit die von ihm erstellten Designs Ihre echten Komponenten verwenden. Benennen Sie optional das Design-System, zum Beispiel `/design-sync Acme DS`. Eine erste Synchronisierung überprüft jede Komponente und kann bei einem großen Repo mehrere Stunden dauern. Verfügbar auf der Anthropic API; auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS kann das zugrunde liegende Tool nicht auf claude.ai zugreifen, daher ist der Befehl nicht verfügbar |77| `/design-sync [hint]` | **[Skill](/docs/de/skills#bundled-skills).** Konvertieren Sie das React-Design-System Ihres Repos und laden Sie es zu [Claude Design](https://claude.ai/design) hoch, damit die von ihm erstellten Designs Ihre echten Komponenten verwenden. Benennen Sie optional das Design-System, zum Beispiel `/design-sync Acme DS`. Eine erste Synchronisierung überprüft jede Komponente und kann bei einem großen Repo mehrere Stunden dauern. Verfügbar auf der Anthropic API; auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS kann das zugrunde liegende Tool nicht auf claude.ai zugreifen, daher ist der Befehl nicht verfügbar |

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

79| `/diff` | Öffnen Sie einen interaktiven Diff-Viewer, der nicht committete Änderungen und Pro-Turn-Diffs anzeigt. Verwenden Sie Links-/Rechtspfeile, um zwischen dem aktuellen Git-Diff und einzelnen Claude-Turns zu wechseln, und Auf-/Abwärtspfeile zum Durchsuchen von Dateien. Drücken Sie Enter, um den Diff der ausgewählten Datei zu öffnen, scrollen Sie ihn mit Auf-/Abwärtspfeilen oder Bild-Auf/Bild-Ab, und drücken Sie Esc, um zur Dateiliste zurückzukehren. {/* min-version: 2.1.198 */}Ab v2.1.198 wird der offene Viewer auch automatisch aktualisiert, wenn sich der Git-Status des Repositorys außerhalb der Sitzung ändert, z. B. bei einem Branch-Wechsel oder Commit in einem anderen Terminal |79| `/diff` | Öffnen Sie einen interaktiven Diff-Viewer, der nicht committete Änderungen und Pro-Turn-Diffs anzeigt. Verwenden Sie Links-/Rechtspfeile, um zwischen dem aktuellen Git-Diff und einzelnen Claude-Turns zu wechseln, und Auf-/Abwärtspfeile zum Durchsuchen von Dateien. Drücken Sie Enter, um den Diff der ausgewählten Datei zu öffnen, scrollen Sie ihn mit Auf-/Abwärtspfeilen oder Bild-Auf/Bild-Ab, und drücken Sie Esc, um zur Dateiliste zurückzukehren. Ab v2.1.198 wird der offene Viewer auch automatisch aktualisiert, wenn sich der Git-Status des Repositorys außerhalb der Sitzung ändert, z. B. bei einem Branch-Wechsel oder Commit in einem anderen Terminal |

80| `/doctor` | **[Skill](/de/skills#bundled-skills).** Führen Sie eine Setup-Überprüfung durch, die Probleme diagnostiziert und beheben kann. Überprüft die Installationsintegrität, einschließlich doppelter oder verbleibender Installationen, `PATH`-Problemen und nicht analysierbaren Einstellungsdateien. Findet ungenutzte Skills, MCP-Server und Plugins im Vergleich zu ihren Kontextkosten, kennzeichnet langsame [Hooks](/de/hooks) und prüft auf eine neuere Version auf Ihrem Release-Kanal. Dedupliziert lokale `CLAUDE.md`-Dateien gegen eingecheckte, kürzt eingecheckte [`CLAUDE.md`](/de/memory)-Dateien, indem Inhalte entfernt werden, die Claude aus der Codebasis ableiten könnte, und migriert die immer geladene Anleitung, die bleibt, in [Skills](/de/skills) und verschachtelte `CLAUDE.md`-Dateien, die bei Bedarf geladen werden. Die Kürzung entfernt Abschnitte wie Verzeichnislayouts, Abhängigkeitslisten und Architekturübersichten und behält Fallstricke, Rationale und Konventionen, die sich von Tool-Standardwerten unterscheiden. Bietet auch an, [Auto-Modus](/de/permissions#permission-modes) zu Ihrem Standard zu machen und häufig abgelehnte schreibgeschützte Befehle [vorab zu genehmigen](/de/permissions). Meldet Erkenntnisse zuerst und fragt um Bestätigung, bevor etwas geändert wird. Vom Terminal aus druckt `claude doctor` schreibgeschützte Installationsdiagnostiken, ohne eine Sitzung zu starten. Alias: `/checkup`. {/* min-version: 2.1.206 */}Die `CLAUDE.md`-Kürzungsprüfung erfordert Claude Code v2.1.206 oder später. Vor v2.1.206 verglich die Versionsprüfung Homebrew-Installationen gegen die `autoUpdatesChannel`-Einstellung anstelle des [installierten Cask-Kanals](/de/setup#configure-release-channel). {/* min-version: 2.1.205 */}Vor v2.1.205 öffnete `/doctor` einen schreibgeschützten Diagnose-Bildschirm und das Drücken von `f` sendete den Bericht an Claude |80| `/doctor` | **[Skill](/docs/de/skills#bundled-skills).** Führen Sie eine Setup-Überprüfung durch, die Probleme diagnostiziert und beheben kann. Überprüft die Installationsintegrität, einschließlich doppelter oder verbleibender Installationen, `PATH`-Problemen und nicht analysierbaren Einstellungsdateien. Findet ungenutzte Skills, MCP-Server und Plugins im Vergleich zu ihren Kontextkosten, kennzeichnet langsame [Hooks](/docs/de/hooks) und prüft auf eine neuere Version auf Ihrem Release-Kanal. Dedupliziert lokale `CLAUDE.md`-Dateien gegen eingecheckte, kürzt eingecheckte [`CLAUDE.md`](/docs/de/memory)-Dateien, indem Inhalte entfernt werden, die Claude aus der Codebasis ableiten könnte, und migriert die immer geladene Anleitung, die bleibt, in [Skills](/docs/de/skills) und verschachtelte `CLAUDE.md`-Dateien, die bei Bedarf geladen werden. Die Kürzung entfernt Abschnitte wie Verzeichnislayouts, Abhängigkeitslisten und Architekturübersichten und behält Fallstricke, Rationale und Konventionen, die sich von Tool-Standardwerten unterscheiden. Bietet auch an, [Auto-Modus](/docs/de/permissions#permission-modes) zu Ihrem Standard zu machen und häufig abgelehnte schreibgeschützte Befehle [vorab zu genehmigen](/docs/de/permissions). Meldet Erkenntnisse zuerst und fragt um Bestätigung, bevor etwas geändert wird. Vom Terminal aus druckt `claude doctor` schreibgeschützte Installationsdiagnostiken, ohne eine Sitzung zu starten. Alias: `/checkup`. Die `CLAUDE.md`-Kürzungsprüfung erfordert Claude Code v2.1.206 oder später. Vor v2.1.206 verglich die Versionsprüfung Homebrew-Installationen gegen die `autoUpdatesChannel`-Einstellung anstelle des [installierten Cask-Kanals](/docs/de/setup#configure-release-channel). Vor v2.1.205 öffnete `/doctor` einen schreibgeschützten Diagnose-Bildschirm und das Drücken von `f` sendete den Bericht an Claude |

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

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

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

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

85| `/feedback [report]` | Geben Sie Feedback, melden Sie einen Fehler, oder teilen Sie Ihr Gespräch. Das Senden an Anthropic erfordert [Authentifizierung](/de/authentication). Aliase: `/bug`, `/share` |85| `/feedback [report]` | Geben Sie Feedback, melden Sie einen Fehler, oder teilen Sie Ihr Gespräch. Das Senden an Anthropic erfordert [Authentifizierung](/docs/de/authentication). Aliase: `/bug`, `/share` |

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

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

88| `/fork <directive>` | {/* min-version: 2.1.161 */}Starten Sie einen [verzweigten Subagenten](/de/sub-agents#fork-the-current-conversation): einen Hintergrund-Subagenten, der das vollständige Gespräch erbt und an der Direktive arbeitet, während Sie weitermachen. Sein Ergebnis kehrt zu Ihrem Gespräch zurück, wenn es fertig ist. Um selbst in eine Kopie des Gesprächs zu wechseln, verwenden Sie `/branch`. Vor v2.1.161 ist `/fork` ein Alias für `/branch` |88| `/fork <directive>` | Starten Sie einen [verzweigten Subagenten](/docs/de/sub-agents#fork-the-current-conversation): einen Hintergrund-Subagenten, der das vollständige Gespräch erbt und an der Direktive arbeitet, während Sie weitermachen. Sein Ergebnis kehrt zu Ihrem Gespräch zurück, wenn es fertig ist. Um selbst in eine Kopie des Gesprächs zu wechseln, verwenden Sie `/branch`. Vor v2.1.161 ist `/fork` ein Alias für `/branch` |

89| `/goal [condition\|clear]` | Legen Sie ein [Ziel](/de/goal) fest: Claude arbeitet über Turns hinweg weiter, bis die Bedingung erfüllt ist. Ohne Argument wird das aktuelle oder zuletzt erreichte Ziel angezeigt. `clear`, `stop`, `off`, `reset`, `none` oder `cancel` entfernt ein aktives Ziel frühzeitig |89| `/goal [condition\|clear]` | Legen Sie ein [Ziel](/docs/de/goal) fest: Claude arbeitet über Turns hinweg weiter, bis die Bedingung erfüllt ist. Ohne Argument wird das aktuelle oder zuletzt erreichte Ziel angezeigt. `clear`, `stop`, `off`, `reset`, `none` oder `cancel` entfernt ein aktives Ziel frühzeitig |

90| `/heapdump` | Schreiben Sie einen JavaScript-Heap-Snapshot und eine Speicheraufschlüsselung nach `~/Desktop`, oder Ihr Home-Verzeichnis unter Linux ohne Desktop-Ordner, um hohe Speichernutzung zu diagnostizieren. Die `.heapsnapshot`-Datei enthält Ihre vollständige Konversation und Anmeldedaten, daher teilen Sie sie nicht. Siehe [Troubleshooting](/de/troubleshooting#high-cpu-or-memory-usage) |90| `/heapdump` | Schreiben Sie einen JavaScript-Heap-Snapshot und eine Speicheraufschlüsselung nach `~/Desktop`, oder Ihr Home-Verzeichnis unter Linux ohne Desktop-Ordner, um hohe Speichernutzung zu diagnostizieren. Die `.heapsnapshot`-Datei enthält Ihre vollständige Konversation und Anmeldedaten, daher teilen Sie sie nicht. Siehe [Troubleshooting](/docs/de/troubleshooting#high-cpu-or-memory-usage) |

93| `/ide` | Verwalten Sie IDE-Integrationen und zeigen Sie den Status an |93| `/ide` | Verwalten Sie IDE-Integrationen und zeigen Sie den Status an |

94| `/init` | Initialisieren Sie das Projekt mit einer `CLAUDE.md`-Anleitung. Setzen Sie `CLAUDE_CODE_NEW_INIT=1` für einen interaktiven Flow, der Sie auch durch Skills, Hooks und persönliche Speicherdateien führt |94| `/init` | Initialisieren Sie das Projekt mit einer `CLAUDE.md`-Anleitung. Setzen Sie `CLAUDE_CODE_NEW_INIT=1` für einen interaktiven Flow, der Sie auch durch Skills, Hooks und persönliche Speicherdateien führt |

95| `/insights` | Generieren Sie einen Bericht, der Ihre Claude Code-Sitzungen analysiert, einschließlich Projektbereiche, Interaktionsmuster und Reibungspunkte |95| `/insights` | Generieren Sie einen Bericht, der Ihre Claude Code-Sitzungen analysiert, einschließlich Projektbereiche, Interaktionsmuster und Reibungspunkte |

96| `/install-github-app` | Installieren Sie die Claude GitHub App für ein Repository, mit einem optionalen Schritt zum Einrichten von [GitHub Actions](/de/github-actions)-Workflows und Secrets. Führt Sie durch die Auswahl eines Repos und die Konfiguration der Integration |96| `/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 Secrets. Führt Sie durch die Auswahl eines Repos und die Konfiguration der Integration |

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

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

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

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

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

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

109| `/plugin [subcommand]` | Verwalten Sie Claude Code [Plugins](/de/plugins). 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 |109| `/plugin [subcommand]` | Verwalten Sie Claude Code [Plugins](/docs/de/plugins). 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 |

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

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

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

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

115| `/release-notes` | Zeigen Sie das Änderungsprotokoll in einer interaktiven Versionswahl an. Wählen Sie eine bestimmte Version, um ihre Versionshinweise anzuzeigen, oder wählen Sie, um alle Versionen anzuzeigen. {/* min-version: 2.1.208 */}Die Hinweise werden in Ihrem Transkript angezeigt, ohne dass Sie das Gespräch eingeben, das Claude sieht. Vor v2.1.208 wurden die angezeigten Hinweise in das Gespräch eingegeben, einschließlich des gesamten Änderungsprotokolls beim Anzeigen aller Versionen |115| `/release-notes` | Zeigen Sie das Änderungsprotokoll in einer interaktiven Versionswahl an. Wählen Sie eine bestimmte Version, um ihre Versionshinweise anzuzeigen, oder wählen Sie, um alle Versionen anzuzeigen. Die Hinweise werden in Ihrem Transkript angezeigt, ohne dass Sie das Gespräch eingeben, das Claude sieht. Vor v2.1.208 wurden die angezeigten Hinweise in das Gespräch eingegeben, einschließlich des gesamten Änderungsprotokolls beim Anzeigen aller Versionen |

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

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

118| `/remote-control` | Machen Sie diese Sitzung für [Fernsteuerung](/de/remote-control) von claude.ai verfügbar. {/* min-version: 2.1.206 */}Die Ausführung während der Abmeldung druckt, dass Fernsteuerung ein claude.ai-Abonnement erfordert und zeigt Ihnen, wie Sie sich anmelden; vor v2.1.206 meldete es `Unknown command: /remote-control`. Alias: `/rc` |118| `/remote-control` | Machen Sie diese Sitzung für [Fernsteuerung](/docs/de/remote-control) von claude.ai verfügbar. Die Ausführung während der Abmeldung druckt, dass Fernsteuerung ein claude.ai-Abonnement erfordert und zeigt Ihnen, wie Sie sich anmelden; vor v2.1.206 meldete es `Unknown command: /remote-control`. Alias: `/rc` |

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

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

121| `/resume [session]` | Setzen Sie ein Gespräch nach ID oder Name fort, oder öffnen Sie die Sitzungsauswahl. Ab v2.1.144 werden [Hintergrund-Sitzungen](/de/agent-view) in der Auswahl mit `bg` gekennzeichnet angezeigt; eine, die noch läuft, kann hier nicht fortgesetzt werden, daher hängen Sie sie von `claude agents` an oder stoppen Sie sie dort zuerst. Alias: `/continue` |121| `/resume [session]` | Setzen Sie ein Gespräch nach ID oder Name fort, oder öffnen Sie die Sitzungsauswahl. Ab v2.1.144 werden [Hintergrund-Sitzungen](/docs/de/agent-view) in der Auswahl mit `bg` gekennzeichnet angezeigt; eine, die noch läuft, kann hier nicht fortgesetzt werden, daher hängen Sie sie von `claude agents` an oder stoppen Sie sie dort zuerst. Alias: `/continue` |

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

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

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

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

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

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

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

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

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

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

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

135| `/status` | Öffnen Sie die Einstellungsschnittstelle (Registerkarte Status) mit Version, Modell, Konto und Konnektivität. Funktioniert, während Claude antwortet |135| `/status` | Öffnen Sie die Einstellungsschnittstelle (Registerkarte Status) mit Version, Modell, Konto und Konnektivität. Funktioniert, während Claude antwortet |

136| `/statusline` | Konfigurieren Sie Claude Codes [Statuszeile](/de/statusline). Beschreiben Sie, was Sie möchten, oder führen Sie ohne Argumente aus, um automatisch von Ihrer Shell-Eingabeaufforderung zu konfigurieren |136| `/statusline` | Konfigurieren Sie Claude Codes [Statuszeile](/docs/de/statusline). Beschreiben Sie, was Sie möchten, oder führen Sie ohne Argumente aus, um automatisch von Ihrer Shell-Eingabeaufforderung zu konfigurieren |

138| `/stop` | Stoppen Sie die aktuelle [Hintergrund-Sitzung](/de/agent-view). Nur verfügbar, wenn Sie an eine 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 `←` |138| `/stop` | Stoppen Sie die aktuelle [Hintergrund-Sitzung](/docs/de/agent-view). Nur verfügbar, wenn Sie an eine 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 `←` |

139| `/tasks` | Zeigen Sie und verwalten Sie Hintergrundarbeit in der aktuellen Sitzung, einschließlich Subagenten, die fertig sind. Auch verfügbar als `/bashes` |139| `/tasks` | Zeigen Sie und verwalten Sie Hintergrundarbeit in der aktuellen Sitzung, einschließlich Subagenten, die fertig sind. Auch verfügbar als `/bashes` |

140| `/team-onboarding` | Generieren Sie einen Team-Onboarding-Leitfaden aus Ihrer Claude Code-Nutzungshistorie. 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 sich schnell einzurichten. Für claude.ai-Abonnenten in Pro-, Max-, Team- und Enterprise-Plänen wird auch ein Share-Link zurückgegeben, den Teamkollegen direkt in Claude Code öffnen können |140| `/team-onboarding` | Generieren Sie einen Team-Onboarding-Leitfaden aus Ihrer Claude Code-Nutzungshistorie. 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 sich schnell einzurichten. Für claude.ai-Abonnenten in Pro-, Max-, Team- und Enterprise-Plänen wird auch ein Share-Link zurückgegeben, den Teamkollegen direkt in Claude Code öffnen können |

141| `/teleport` | Ziehen Sie eine [Claude Code im Web](/de/claude-code-on-the-web#from-web-to-terminal)-Sitzung in dieses Terminal: öffnet eine Auswahl, dann ruft den Branch und das Gespräch ab. Auch verfügbar als `/tp`. Erfordert ein claude.ai-Abonnement |141| `/teleport` | Ziehen Sie eine [Claude Code im Web](/docs/de/claude-code-on-the-web#from-web-to-terminal)-Sitzung in dieses Terminal: öffnet eine Auswahl, dann ruft den Branch und das Gespräch ab. Auch verfügbar als `/tp`. Erfordert ein claude.ai-Abonnement |

142| `/terminal-setup` | Konfigurieren Sie Terminal-Tastenkombinationen für Shift+Enter und andere Verknüpfungen. Nur in Terminals sichtbar, die dies benötigen, wie VS Code, Cursor, Devin Desktop, Alacritty oder Zed |142| `/terminal-setup` | Konfigurieren Sie Terminal-Tastenkombinationen für Shift+Enter und andere Verknüpfungen. Nur in Terminals sichtbar, die dies benötigen, wie VS Code, Cursor, Devin Desktop, Alacritty oder Zed |

143| `/theme` | Ändern Sie das Farbschema. Enthält eine `auto`-Option, die dem dunklen oder hellen Modus Ihres Terminals folgt, helle und dunkle Varianten, farbenblindgerechte (daltonisierte) Designs, ANSI-Designs, die die Farbpalette Ihres Terminals verwenden, und alle [benutzerdefinierten Designs](/de/terminal-config#create-a-custom-theme) aus `~/.claude/themes/` oder Plugins. Wählen Sie **Neues benutzerdefiniertes Design…**, um eines zu erstellen |143| `/theme` | Ändern Sie das Farbschema. Enthält eine `auto`-Option, die dem dunklen oder hellen Modus Ihres Terminals folgt, helle und dunkle Varianten, farbenblindgerechte (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 **Neues benutzerdefiniertes Design…**, um eines zu erstellen |

144| `/tui [default\|fullscreen]` | Legen Sie den Terminal-UI-Renderer fest und starten Sie ihn mit Ihrem Gespräch intakt neu. `fullscreen` aktiviert den [flimmerfreien Alt-Screen-Renderer](/de/fullscreen). Ohne Argument wird der aktive Renderer gedruckt |144| `/tui [default\|fullscreen]` | Legen Sie den Terminal-UI-Renderer fest und starten Sie ihn mit Ihrem Gespräch intakt neu. `fullscreen` aktiviert den [flimmerfreien Alt-Screen-Renderer](/docs/de/fullscreen). Ohne Argument wird der aktive Renderer gedruckt |

145| `/ultraplan <prompt>` | Entwerfen Sie einen Plan in einer [Ultraplan](/de/ultraplan)-Sitzung, überprüfen Sie ihn in Ihrem Browser, dann führen Sie ihn remote aus oder senden Sie ihn zurück zu Ihrem Terminal |145| `/ultraplan <prompt>` | Entwerfen Sie einen Plan in einer [Ultraplan](/docs/de/ultraplan)-Sitzung, überprüfen Sie ihn in Ihrem Browser, dann führen Sie ihn remote aus oder senden Sie ihn zurück zu Ihrem Terminal |

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

147| `/upgrade` | Öffnen Sie die Upgrade-Seite in Ihrem Browser, um zu einem höheren Plan-Tier zu wechseln. Wenn der Browser nicht geöffnet werden kann, zeigt der Befehl eine Anmeldungsaufforderung an, ohne die URL zu drucken |147| `/upgrade` | Öffnen Sie die Upgrade-Seite in Ihrem Browser, um zu einem höheren Plan-Tier zu wechseln. Wenn der Browser nicht geöffnet werden kann, zeigt der Befehl eine Anmeldungsaufforderung an, ohne die URL zu drucken |

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

149| `/usage-credits` | Konfigurieren Sie Nutzungsguthaben, um weiterzuarbeiten, wenn Sie ein Limit erreichen. Auf Pro- und Max-Plänen öffnet sich ein [In-CLI-Dialog](/de/costs#set-a-spend-limit-on-pro-and-max), um Nutzungsguthaben zu kaufen, ein monatliches Ausgabenlimit festzulegen und Auto-Reload zu konfigurieren; auf Claude Code-Versionen vor v2.1.207 und auf anderen Plänen öffnet sich die Nutzungsguthaben-Abrechnungsseite in Ihrem Browser, außer dass Team- und Enterprise-Mitglieder ohne Abrechnungszugriff stattdessen eine Nutzungsguthaben-Anfrage von der CLI an ihren Admin senden. {/* min-version: 2.1.205 */}Wenn kein Browser die Abrechnungsseite öffnen kann, zum Beispiel über SSH, druckt der Befehl stattdessen die URL zum Besuchen; dies erfordert Claude Code v2.1.205 oder später, und frühere Versionen zeigten in diesem Fall nichts. Zuvor `/extra-usage` |149| `/usage-credits` | Konfigurieren Sie Nutzungsguthaben, um weiterzuarbeiten, wenn Sie ein Limit erreichen. Auf Pro- und Max-Plänen öffnet sich ein [In-CLI-Dialog](/docs/de/costs#set-a-spend-limit-on-pro-and-max), um Nutzungsguthaben zu kaufen, ein monatliches Ausgabenlimit festzulegen und Auto-Reload zu konfigurieren; auf Claude Code-Versionen vor v2.1.207 und auf anderen Plänen öffnet sich die Nutzungsguthaben-Abrechnungsseite in Ihrem Browser, außer dass Team- und Enterprise-Mitglieder ohne Abrechnungszugriff stattdessen eine Nutzungsguthaben-Anfrage von der CLI an ihren Admin senden. Wenn kein Browser die Abrechnungsseite öffnen kann, zum Beispiel über SSH, druckt der Befehl stattdessen die URL zum Besuchen; dies erfordert Claude Code v2.1.205 oder später, und frühere Versionen zeigten in diesem Fall nichts. Zuvor `/extra-usage` |

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

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

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

153| `/web-setup` | Verbinden Sie Ihr GitHub-Konto mit [Claude Code im Web](/de/web-quickstart#connect-from-your-terminal) mit Ihren lokalen `gh` CLI-Anmeldedaten. `/schedule` fordert dies automatisch auf, wenn GitHub nicht verbunden ist |153| `/web-setup` | Verbinden Sie Ihr GitHub-Konto mit [Claude Code im Web](/docs/de/web-quickstart#connect-from-your-terminal) mit Ihren lokalen `gh` CLI-Anmeldedaten. `/schedule` fordert dies automatisch auf, wenn GitHub nicht verbunden ist |

154| `/workflows` | Öffnen Sie die [Workflow](/de/workflows#watch-the-run)-Fortschrittsansicht, um laufende und abgeschlossene Workflows zu beobachten, zu pausieren, fortzusetzen oder zu speichern |154| `/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 |

155 155

156<h2 id="mcp-prompts">156<h2 id="mcp-prompts">

157 MCP-Eingabeaufforderungen157 MCP-Eingabeaufforderungen

158</h2>158</h2>

159 159

160MCP-Server können Eingabeaufforderungen verfügbar machen, die als Befehle angezeigt werden. Diese verwenden das Format `/mcp__<server>__<prompt>` und werden dynamisch von verbundenen Servern erkannt. Siehe [MCP-Eingabeaufforderungen](/de/mcp#use-mcp-prompts-as-commands) für Details.160MCP-Server können Eingabeaufforderungen verfügbar machen, die als Befehle angezeigt werden. Diese verwenden das Format `/mcp__<server>__<prompt>` und werden dynamisch von verbundenen Servern erkannt. Siehe [MCP-Eingabeaufforderungen](/docs/de/mcp#use-mcp-prompts-as-commands) für Details.

161 161

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

163 Siehe auch163 Siehe auch

164</h2>164</h2>

165 165

166* [Skills](/de/skills): Erstellen Sie Ihre eigenen Befehle166* [Skills](/docs/de/skills): Erstellen Sie Ihre eigenen Befehle

167* [Interaktiver Modus](/de/interactive-mode): Tastenkombinationen, Vim-Modus und Befehlsverlauf167* [Interaktiver Modus](/docs/de/interactive-mode): Tastenkombinationen, Vim-Modus und Befehlsverlauf

168* [CLI-Referenz](/de/cli-reference): Start-Flags168* [CLI-Referenz](/docs/de/cli-reference): Start-Flags

computer-use.md +11 −11

Details

12 12

13Die Computernutzung ermöglicht es Claude, Apps zu öffnen, Ihren Bildschirm zu steuern und auf Ihrem Computer so zu arbeiten, wie Sie es tun würden. Von der CLI aus kann Claude eine Swift-App kompilieren, sie starten, jeden Button durchklicken und das Ergebnis screenshooten – alles in derselben Konversation, in der es den Code geschrieben hat.13Die Computernutzung ermöglicht es Claude, Apps zu öffnen, Ihren Bildschirm zu steuern und auf Ihrem Computer so zu arbeiten, wie Sie es tun würden. Von der CLI aus kann Claude eine Swift-App kompilieren, sie starten, jeden Button durchklicken und das Ergebnis screenshooten – alles in derselben Konversation, in der es den Code geschrieben hat.

14 14

~~15Diese Seite behandelt, wie die Computernutzung in der CLI funktioniert. Für die Desktop-App auf macOS oder Windows siehe [Computernutzung in Desktop](/de/desktop#let-claude-use-your-computer).~~15Diese Seite behandelt, wie die Computernutzung in der CLI funktioniert. Für die Desktop-App auf macOS oder Windows siehe [Computernutzung in Desktop](/docs/de/desktop#let-claude-use-your-computer).

16 16

17<h2 id="what-you-can-do-with-computer-use">17<h2 id="what-you-can-do-with-computer-use">

18 Was Sie mit der Computernutzung tun können18 Was Sie mit der Computernutzung tun können

31 31

32Claude hat mehrere Möglichkeiten, mit einer App oder einem Service zu interagieren. Die Computernutzung ist die breiteste und langsamste, daher versucht Claude zuerst das präziseste Tool:32Claude hat mehrere Möglichkeiten, mit einer App oder einem Service zu interagieren. Die Computernutzung ist die breiteste und langsamste, daher versucht Claude zuerst das präziseste Tool:

33 33

~~34* Wenn Sie einen [MCP-Server](/de/mcp) für den Service haben, verwendet Claude diesen.~~34* Wenn Sie einen [MCP-Server](/docs/de/mcp) für den Service haben, verwendet Claude diesen.

35* Wenn die Aufgabe ein Shell-Befehl ist, verwendet Claude Bash.35* Wenn die Aufgabe ein Shell-Befehl ist, verwendet Claude Bash.

~~36* Wenn die Aufgabe Browser-Arbeit ist und Sie [Claude in Chrome](/de/chrome) eingerichtet haben, verwendet Claude das.~~36* Wenn die Aufgabe Browser-Arbeit ist und Sie [Claude in Chrome](/docs/de/chrome) eingerichtet haben, verwendet Claude das.

37* Wenn keine dieser Optionen zutrifft, verwendet Claude die Computernutzung.37* Wenn keine dieser Optionen zutrifft, verwendet Claude die Computernutzung.

38 38

39Die Bildschirmsteuerung ist für Dinge reserviert, die nichts anderes erreichen kann: native Apps, Simulatoren und Tools ohne API.39Die Bildschirmsteuerung ist für Dinge reserviert, die nichts anderes erreichen kann: native Apps, Simulatoren und Tools ohne API.

98 98

99Diese Apps sind nicht blockiert. Die Warnung hilft Ihnen zu entscheiden, ob die Aufgabe dieses Zugriffsniveau rechtfertigt.99Diese Apps sind nicht blockiert. Die Warnung hilft Ihnen zu entscheiden, ob die Aufgabe dieses Zugriffsniveau rechtfertigt.

100 100

101Claudes Kontrollebene variiert auch je nach App-Kategorie: Browser und Handelsplattformen sind nur zum Anschauen, Terminals und IDEs sind nur zum Klicken und alles andere erhält vollständige Kontrolle. Siehe [App-Berechtigungen in Desktop](/de/desktop#app-permissions) für die vollständige Tier-Aufschlüsselung.101Claudes Kontrollebene variiert auch je nach App-Kategorie: Browser und Handelsplattformen sind nur zum Anschauen, Terminals und IDEs sind nur zum Klicken und alles andere erhält vollständige Kontrolle. Siehe [App-Berechtigungen in Desktop](/docs/de/desktop#app-permissions) für die vollständige Tier-Aufschlüsselung.

102 102

103<h2 id="how-claude-works-on-your-screen">103<h2 id="how-claude-works-on-your-screen">

104 Wie Claude auf Ihrem Bildschirm arbeitet104 Wie Claude auf Ihrem Bildschirm arbeitet

110 Eine Sitzung auf einmal110 Eine Sitzung auf einmal

111</h3>111</h3>

112 112

113Die Computernutzung hält eine maschinenweite Sperre vom ersten Computernutzungs-Aktion bis die Sitzung, die sie erworben hat, beendet wird. {/* min-version: 2.1.195 */}Ab v2.1.195 gibt das Beenden der Aufgabe die Sperre nicht frei; nur das Beenden der Sitzung tut dies. Wenn eine andere Claude Code-Sitzung bereits Ihren Computer nutzt, schlagen neue Versuche mit einer Nachricht fehl, die Ihnen mitteilt, welche Sitzung die Sperre hält. Beenden Sie diese Sitzung zuerst.113Die Computernutzung hält eine maschinenweite Sperre vom ersten Computernutzungs-Aktion bis die Sitzung, die sie erworben hat, beendet wird. Ab v2.1.195 gibt das Beenden der Aufgabe die Sperre nicht frei; nur das Beenden der Sitzung tut dies. Wenn eine andere Claude Code-Sitzung bereits Ihren Computer nutzt, schlagen neue Versuche mit einer Nachricht fehl, die Ihnen mitteilt, welche Sitzung die Sperre hält. Beenden Sie diese Sitzung zuerst.

114 114

115<h3 id="apps-are-hidden-while-claude-works">115<h3 id="apps-are-hidden-while-claude-works">

116 Apps werden ausgeblendet, während Claude arbeitet116 Apps werden ausgeblendet, während Claude arbeitet

141</h2>141</h2>

142 142

143<Warning>143<Warning>

144 Im Gegensatz zum [isolierten Bash-Tool](/de/sandboxing) läuft die Computernutzung auf Ihrem tatsächlichen Desktop mit Zugriff auf die Apps, die Sie genehmigen. Claude überprüft jede Aktion und kennzeichnet potenzielle Prompt-Injection aus Inhalten auf dem Bildschirm, aber die Vertrauensgrenze ist unterschiedlich. Siehe den [Sicherheitsleitfaden für Computernutzung](https://support.claude.com/en/articles/14128542) für Best Practices.144 Im Gegensatz zum [isolierten Bash-Tool](/docs/de/sandboxing) läuft die Computernutzung auf Ihrem tatsächlichen Desktop mit Zugriff auf die Apps, die Sie genehmigen. Claude überprüft jede Aktion und kennzeichnet potenzielle Prompt-Injection aus Inhalten auf dem Bildschirm, aber die Vertrauensgrenze ist unterschiedlich. Siehe den [Sicherheitsleitfaden für Computernutzung](https://support.claude.com/en/articles/14128542) für Best Practices.

145</Warning>145</Warning>

146 146

147Die integrierten Schutzvorrichtungen reduzieren das Risiko ohne Konfiguration:147Die integrierten Schutzvorrichtungen reduzieren das Risiko ohne Konfiguration:

235 235

236Der Server erscheint nur auf berechtigten Setups. Überprüfen Sie, dass:236Der Server erscheint nur auf berechtigten Setups. Überprüfen Sie, dass:

237 237

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

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

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

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

244 Siehe auch244 Siehe auch

245</h2>245</h2>

246 246

247* [Computernutzung in Desktop](/de/desktop#let-claude-use-your-computer): die gleiche Funktion mit einer grafischen Einstellungsseite247* [Computernutzung in Desktop](/docs/de/desktop#let-claude-use-your-computer): die gleiche Funktion mit einer grafischen Einstellungsseite

248* [Claude in Chrome](/de/chrome): Browser-Automatisierung für webbasierte Aufgaben248* [Claude in Chrome](/docs/de/chrome): Browser-Automatisierung für webbasierte Aufgaben

249* [MCP](/de/mcp): Verbinden Sie Claude mit strukturierten Tools und APIs249* [MCP](/docs/de/mcp): Verbinden Sie Claude mit strukturierten Tools und APIs

250* [Sandboxing](/de/sandboxing): wie Claudes Bash-Tool Dateisystem- und Netzwerkzugriff isoliert250* [Sandboxing](/docs/de/sandboxing): wie Claudes Bash-Tool Dateisystem- und Netzwerkzugriff isoliert

251* [Sicherheitsleitfaden für Computernutzung](https://support.claude.com/en/articles/14128542): Best Practices für sichere Computernutzung251* [Sicherheitsleitfaden für Computernutzung](https://support.claude.com/en/articles/14128542): Best Practices für sichere Computernutzung

context-window.md +13 −13

Details

1578 1578

1579Die Sitzung durchläuft einen realistischen Ablauf mit repräsentativen Token-Zählungen:1579Die Sitzung durchläuft einen realistischen Ablauf mit repräsentativen Token-Zählungen:

1580 1580

1581* **Bevor Sie etwas eingeben**: CLAUDE.md, automatisches Gedächtnis, MCP-Tool-Namen und Skill-Beschreibungen werden alle in den Kontext geladen. Ihr eigenes Setup kann hier mehr hinzufügen, wie ein [Ausgabestil](/de/output-styles) oder Text aus [`--append-system-prompt`](/de/cli-reference), die beide auf die gleiche Weise in die System-Eingabeaufforderung gehen.1581* **Bevor Sie etwas eingeben**: CLAUDE.md, automatisches Gedächtnis, MCP-Tool-Namen und Skill-Beschreibungen werden alle in den Kontext geladen. Ihr eigenes Setup kann hier mehr hinzufügen, wie ein [Ausgabestil](/docs/de/output-styles) oder Text aus [`--append-system-prompt`](/docs/de/cli-reference), die beide auf die gleiche Weise in die System-Eingabeaufforderung gehen.

1582* **Während Claude arbeitet**: Jeder Dateilesevorgang fügt zum Kontext hinzu, [pfadgebundene Regeln](/de/memory#path-specific-rules) werden automatisch zusammen mit übereinstimmenden Dateien geladen, und ein [PostToolUse Hook](/de/hooks-guide) wird nach jeder Bearbeitung ausgelöst.1582* **Während Claude arbeitet**: Jeder Dateilesevorgang fügt zum Kontext hinzu, [pfadgebundene Regeln](/docs/de/memory#path-specific-rules) werden automatisch zusammen mit übereinstimmenden Dateien geladen, und ein [PostToolUse Hook](/docs/de/hooks-guide) wird nach jeder Bearbeitung ausgelöst.

1583* **Die Folgeeingabeaufforderung**: Ein [Subagent](/de/sub-agents) verarbeitet die Recherche in seinem eigenen separaten Kontextfenster, sodass die großen Dateilesevorgang außerhalb des Ihren bleiben. Nur die Zusammenfassung und ein kleiner Metadaten-Trailer kommen zurück.1583* **Die Folgeeingabeaufforderung**: Ein [Subagent](/docs/de/sub-agents) verarbeitet die Recherche in seinem eigenen separaten Kontextfenster, sodass die großen Dateilesevorgang außerhalb des Ihren bleiben. Nur die Zusammenfassung und ein kleiner Metadaten-Trailer kommen zurück.

1584* **Am Ende**: `/compact` ersetzt die Konversation durch eine strukturierte Zusammenfassung. Der meiste Startuinhalt wird automatisch neu geladen; die folgende Tabelle zeigt, was mit jedem Mechanismus geschieht.1584* **Am Ende**: `/compact` ersetzt die Konversation durch eine strukturierte Zusammenfassung. Der meiste Startuinhalt wird automatisch neu geladen; die folgende Tabelle zeigt, was mit jedem Mechanismus geschieht.

1585 1585

1586<h2 id="what-survives-compaction">1586<h2 id="what-survives-compaction">

1587 Was die Komprimierung übersteht1587 Was die Komprimierung übersteht

1588</h2>1588</h2>

1589 1589

1590Wenn eine lange Sitzung komprimiert wird, fasst Claude Code die Konversationshistorie zusammen, um in das Kontextfenster zu passen. {/* min-version: 2.1.198 */}Ab v2.1.198 erbt die Zusammenfassungsanfrage die [erweiterte Überlegung](/de/model-config#extended-thinking) Konfiguration Ihrer Sitzung, sodass sie mit aktiviertem Denken argumentiert, wenn Ihre Sitzung dies aktiviert hat, und ansonsten deaktiviert bleibt. Das Denken beeinflusst nur, wie die Zusammenfassung erstellt wird; Ihre Sitzungseinstellungen bleiben danach unverändert. Was mit Ihren Anweisungen geschieht, hängt davon ab, wie sie geladen wurden:1590Wenn eine lange Sitzung komprimiert wird, fasst Claude Code die Konversationshistorie zusammen, um in das Kontextfenster zu passen. Ab v2.1.198 erbt die Zusammenfassungsanfrage die [erweiterte Überlegung](/docs/de/model-config#extended-thinking) Konfiguration Ihrer Sitzung, sodass sie mit aktiviertem Denken argumentiert, wenn Ihre Sitzung dies aktiviert hat, und ansonsten deaktiviert bleibt. Das Denken beeinflusst nur, wie die Zusammenfassung erstellt wird; Ihre Sitzungseinstellungen bleiben danach unverändert. Was mit Ihren Anweisungen geschieht, hängt davon ab, wie sie geladen wurden:

1591 1591

1592| Mechanismus | Nach der Komprimierung |1592| Mechanismus | Nach der Komprimierung |

1593| :---------------------------------------------- | :----------------------------------------------------------------------------------------------------------- |1593| :---------------------------------------------- | :----------------------------------------------------------------------------------------------------------- |

1607 Wenn sich Ihr Kontext füllt1607 Wenn sich Ihr Kontext füllt

1608</h2>1608</h2>

1609 1609

1610Claude Code komprimiert automatisch, wenn Sie sich dem Limit nähern, sodass ein volles Kontextfenster Ihre Sitzung nicht beendet. Der automatische Durchgang funktioniert genauso wie der `/compact`-Schritt in der Zeitleiste. Siehe [Wenn sich der Kontext füllt](/de/how-claude-code-works#when-context-fills-up) für das, was er bewahrt.1610Claude Code komprimiert automatisch, wenn Sie sich dem Limit nähern, sodass ein volles Kontextfenster Ihre Sitzung nicht beendet. Der automatische Durchgang funktioniert genauso wie der `/compact`-Schritt in der Zeitleiste. Siehe [Wenn sich der Kontext füllt](/docs/de/how-claude-code-works#when-context-fills-up) für das, was er bewahrt.

1611 1611

1612Sie können auch handeln, bevor der automatische Durchgang ausgeführt wird:1612Sie können auch handeln, bevor der automatische Durchgang ausgeführt wird:

1613 1613

1614* **Mit Fokus komprimieren**: Führen Sie `/compact` mit Anweisungen aus, wie `/compact focus on the auth bug fix`, bevor Sie eine lange neue Aufgabe starten. Die Zusammenfassung behält das, was Sie wählen, anstelle dessen, was der automatische Durchgang als wichtig erachtet.1614* **Mit Fokus komprimieren**: Führen Sie `/compact` mit Anweisungen aus, wie `/compact focus on the auth bug fix`, bevor Sie eine lange neue Aufgabe starten. Die Zusammenfassung behält das, was Sie wählen, anstelle dessen, was der automatische Durchgang als wichtig erachtet.

1615* **Zwischen Aufgaben löschen**: Führen Sie `/clear` aus, wenn Sie zu nicht verwandter Arbeit wechseln. Alte Konversationen verdrängen die Dateien, die Sie als nächstes benötigen, und kosten Token bei jeder Nachricht.1615* **Zwischen Aufgaben löschen**: Führen Sie `/clear` aus, wenn Sie zu nicht verwandter Arbeit wechseln. Alte Konversationen verdrängen die Dateien, die Sie als nächstes benötigen, und kosten Token bei jeder Nachricht.

1616* **Große Lesevorgänge delegieren**: Senden Sie Recherche an einen [Subagent](/de/sub-agents), sodass die Dateiinhalte in seinem Kontextfenster bleiben, nicht in Ihrem.1616* **Große Lesevorgänge delegieren**: Senden Sie Recherche an einen [Subagent](/docs/de/sub-agents), sodass die Dateiinhalte in seinem Kontextfenster bleiben, nicht in Ihrem.

1617 1617

1618Wenn Sie ein größeres Fenster benötigen, anstatt ein kleineres Gespräch zu führen, unterstützen Fable 5, Sonnet 5, Opus 4.6 und später sowie Sonnet 4.6 ein Kontextfenster mit 1 Million Token. Siehe [Erweiterter Kontext](/de/model-config#extended-context) für die Verfügbarkeit nach Plan und wie Sie eine `[1m]` Modellvariante auswählen. Sonnet 5 läuft mit 1M ohne `[1m]` Variante zur Auswahl; siehe [Sonnet 5 Kontextfenster](/de/model-config#sonnet-5-context-window) für seine automatischen Kompressionsschwellen und die LLM-Gateway-Ausnahme. Die Komprimierung funktioniert auf die gleiche Weise bei der größeren Grenze.1618Wenn Sie ein größeres Fenster benötigen, anstatt ein kleineres Gespräch zu führen, unterstützen Fable 5, Sonnet 5, Opus 4.6 und später sowie Sonnet 4.6 ein Kontextfenster mit 1 Million Token. Siehe [Erweiterter Kontext](/docs/de/model-config#extended-context) für die Verfügbarkeit nach Plan und wie Sie eine `[1m]` Modellvariante auswählen. Sonnet 5 läuft mit 1M ohne `[1m]` Variante zur Auswahl; siehe [Sonnet 5 Kontextfenster](/docs/de/model-config#sonnet-5-context-window) für seine automatischen Kompressionsschwellen und die LLM-Gateway-Ausnahme. Die Komprimierung funktioniert auf die gleiche Weise bei der größeren Grenze.

1619 1619

1620<h2 id="check-your-own-session">1620<h2 id="check-your-own-session">

1621 Überprüfen Sie Ihre eigene Sitzung1621 Überprüfen Sie Ihre eigene Sitzung

1629 1629

1630Für eine tiefere Abdeckung der in der Zeitleiste gezeigten Funktionen siehe diese Seiten:1630Für eine tiefere Abdeckung der in der Zeitleiste gezeigten Funktionen siehe diese Seiten:

1631 1631

1632* [Claude Code erweitern](/de/features-overview): wann CLAUDE.md vs Skills vs Regeln vs Hooks vs MCP verwendet werden1632* [Claude Code erweitern](/docs/de/features-overview): wann CLAUDE.md vs Skills vs Regeln vs Hooks vs MCP verwendet werden

1633* [Anweisungen und Erinnerungen speichern](/de/memory): CLAUDE.md-Hierarchie und automatisches Gedächtnis1633* [Anweisungen und Erinnerungen speichern](/docs/de/memory): CLAUDE.md-Hierarchie und automatisches Gedächtnis

1634* [Subagents](/de/sub-agents): Recherche an ein separates Kontextfenster delegieren1634* [Subagents](/docs/de/sub-agents): Recherche an ein separates Kontextfenster delegieren

1635* [Best Practices](/de/best-practices): Verwaltung des Kontexts als Ihre primäre Einschränkung1635* [Best Practices](/docs/de/best-practices): Verwaltung des Kontexts als Ihre primäre Einschränkung

1636* [Prompt Caching](/de/prompt-caching): welche Aktionen den zwischengespeicherten Präfix ungültig machen1636* [Prompt Caching](/docs/de/prompt-caching): welche Aktionen den zwischengespeicherten Präfix ungültig machen

1637* [Token-Nutzung reduzieren](/de/costs#reduce-token-usage): Strategien zur Senkung der Kontextnutzung1637* [Token-Nutzung reduzieren](/docs/de/costs#reduce-token-usage): Strategien zur Senkung der Kontextnutzung

debug-your-config.md +32 −32

Details

8 8

9Wenn Claude eine Anweisung ignoriert oder eine konfigurierte Funktion nicht angezeigt wird, liegt die Ursache normalerweise darin, dass die Datei nicht geladen wurde, sie von einem anderen Ort als erwartet geladen wurde oder eine andere Datei sie überschrieben hat. Diese Anleitung zeigt, wie Sie überprüfen, was Claude Code tatsächlich geladen hat, damit Sie eingrenzen können, welcher Fall zutrifft.9Wenn Claude eine Anweisung ignoriert oder eine konfigurierte Funktion nicht angezeigt wird, liegt die Ursache normalerweise darin, dass die Datei nicht geladen wurde, sie von einem anderen Ort als erwartet geladen wurde oder eine andere Datei sie überschrieben hat. Diese Anleitung zeigt, wie Sie überprüfen, was Claude Code tatsächlich geladen hat, damit Sie eingrenzen können, welcher Fall zutrifft.

10 10

~~11Für Installations-, Authentifizierungs- und Konnektivitätsprobleme siehe stattdessen [Troubleshooting bei Installation und Anmeldung](/de/troubleshoot-install).~~11Für Installations-, Authentifizierungs- und Konnektivitätsprobleme siehe stattdessen [Troubleshooting bei Installation und Anmeldung](/docs/de/troubleshoot-install).

12 12

13<h2 id="see-what-loaded-into-context">13<h2 id="see-what-loaded-into-context">

14 Sehen Sie, was in den Kontext geladen wurde14 Sehen Sie, was in den Kontext geladen wurde

26| `/mcp` | Verbundene MCP-Server und ihr Status |26| `/mcp` | Verbundene MCP-Server und ihr Status |

28| `/doctor` | Konfigurationsdiagnose: Installationsintegrität, ungültige Einstellungsdateien, ungenutzte Erweiterungen, doppelte [Subagenten](/de/sub-agents)-Namen im gleichen Verzeichnis und eingecheckte `CLAUDE.md`-Inhalte, die Claude aus der Codebasis ableiten kann, mit vorgeschlagenen Fixes |28| `/doctor` | Konfigurationsdiagnose: Installationsintegrität, ungültige Einstellungsdateien, ungenutzte Erweiterungen, doppelte [Subagenten](/docs/de/sub-agents)-Namen im gleichen Verzeichnis und eingecheckte `CLAUDE.md`-Inhalte, die Claude aus der Codebasis ableiten kann, mit vorgeschlagenen Fixes |

29| `/debug [issue]` | Aktiviert Debug-Protokollierung für die Sitzung und fordert Claude auf, die Diagnose mithilfe der Protokollausgabe und Einstellungspfade durchzuführen |29| `/debug [issue]` | Aktiviert Debug-Protokollierung für die Sitzung und fordert Claude auf, die Diagnose mithilfe der Protokollausgabe und Einstellungspfade durchzuführen |

31 31

32Wenn eine Speicherdatei in `/memory` fehlt, überprüfen Sie ihren Speicherort anhand von [wie CLAUDE.md-Dateien geladen werden](/de/memory#how-claude-md-files-load). Unterverzeichnis-`CLAUDE.md`-Dateien werden bei Bedarf geladen, wenn Claude eine Datei in diesem Verzeichnis mit dem Read-Tool liest, nicht beim Sitzungsstart.32Wenn eine Speicherdatei in `/memory` fehlt, überprüfen Sie ihren Speicherort anhand von [wie CLAUDE.md-Dateien geladen werden](/docs/de/memory#how-claude-md-files-load). Unterverzeichnis-`CLAUDE.md`-Dateien werden bei Bedarf geladen, wenn Claude eine Datei in diesem Verzeichnis mit dem Read-Tool liest, nicht beim Sitzungsstart.

33 33

34Wenn `/memory` bestätigt, dass die Datei geladen wurde, Claude aber immer noch einer bestimmten Anweisung nicht folgt, liegt das Problem wahrscheinlich darin, wie die Anweisung geschrieben ist, nicht darin, ob sie geladen wurde. CLAUDE.md funktioniert gut für die Art von Anleitung, die Sie einem neuen Teamkollegen geben würden, wie z. B. Projektkonventionen, Build-Befehle und wo Dateien hingehören.34Wenn `/memory` bestätigt, dass die Datei geladen wurde, Claude aber immer noch einer bestimmten Anweisung nicht folgt, liegt das Problem wahrscheinlich darin, wie die Anweisung geschrieben ist, nicht darin, ob sie geladen wurde. CLAUDE.md funktioniert gut für die Art von Anleitung, die Sie einem neuen Teamkollegen geben würden, wie z. B. Projektkonventionen, Build-Befehle und wo Dateien hingehören.

35 35

36Die Einhaltung sinkt, wenn eine Anweisung mehrdeutig genug ist, um mehrere Interpretationen zuzulassen, wenn zwei Dateien widersprüchliche Anweisungen geben, oder wenn die Datei so lang geworden ist, dass einzelne Regeln weniger Aufmerksamkeit erhalten. [Schreiben Sie effektive Anweisungen](/de/memory#write-effective-instructions) behandelt die Spezifität, Größe und Strukturmuster, die die Einhaltung hoch halten.36Die Einhaltung sinkt, wenn eine Anweisung mehrdeutig genug ist, um mehrere Interpretationen zuzulassen, wenn zwei Dateien widersprüchliche Anweisungen geben, oder wenn die Datei so lang geworden ist, dass einzelne Regeln weniger Aufmerksamkeit erhalten. [Schreiben Sie effektive Anweisungen](/docs/de/memory#write-effective-instructions) behandelt die Spezifität, Größe und Strukturmuster, die die Einhaltung hoch halten.

37 37

38<Note>38<Note>

39 CLAUDE.md und Berechtigungen lösen unterschiedliche Probleme. CLAUDE.md teilt Claude mit, wie Ihr Projekt funktioniert, damit es gute Entscheidungen trifft. [Berechtigungen](/de/permissions) und [Hooks](/de/hooks) erzwingen Grenzen unabhängig davon, was Claude entscheidet. Verwenden Sie CLAUDE.md für „wir machen es hier so". Verwenden Sie Berechtigungen oder Hooks für Sicherheitsgrenzen und alles, das niemals passieren darf, wenn Sie eine Garantie statt einer Anleitung benötigen.39 CLAUDE.md und Berechtigungen lösen unterschiedliche Probleme. CLAUDE.md teilt Claude mit, wie Ihr Projekt funktioniert, damit es gute Entscheidungen trifft. [Berechtigungen](/docs/de/permissions) und [Hooks](/docs/de/hooks) erzwingen Grenzen unabhängig davon, was Claude entscheidet. Verwenden Sie CLAUDE.md für „wir machen es hier so". Verwenden Sie Berechtigungen oder Hooks für Sicherheitsgrenzen und alles, das niemals passieren darf, wenn Sie eine Garantie statt einer Anleitung benötigen.

40</Note>40</Note>

41 41

42<h2 id="check-resolved-settings">42<h2 id="check-resolved-settings">

43 Überprüfen Sie aufgelöste Einstellungen43 Überprüfen Sie aufgelöste Einstellungen

44</h2>44</h2>

45 45

46Einstellungen werden über verwaltete, Benutzer-, Projekt- und lokale Bereiche zusammengeführt. Verwaltete Einstellungen gewinnen immer, wenn sie vorhanden sind. Bei den übrigen überschreibt der nähere Bereich den breiteren in der Reihenfolge lokal, dann Projekt, dann Benutzer. Einige Einstellungen können auch durch Befehlszeilenflaggen oder [Umgebungsvariablen](/de/env-vars) festgelegt werden, die als eine weitere Überschreibungsebene fungieren. Wenn eine Einstellung nicht angewendet zu werden scheint, wird der von Ihnen festgelegte Wert normalerweise durch einen anderen Bereich oder eine Umgebungsvariable überschrieben.46Einstellungen werden über verwaltete, Benutzer-, Projekt- und lokale Bereiche zusammengeführt. Verwaltete Einstellungen gewinnen immer, wenn sie vorhanden sind. Bei den übrigen überschreibt der nähere Bereich den breiteren in der Reihenfolge lokal, dann Projekt, dann Benutzer. Einige Einstellungen können auch durch Befehlszeilenflaggen oder [Umgebungsvariablen](/docs/de/env-vars) festgelegt werden, die als eine weitere Überschreibungsebene fungieren. Wenn eine Einstellung nicht angewendet zu werden scheint, wird der von Ihnen festgelegte Wert normalerweise durch einen anderen Bereich oder eine Umgebungsvariable überschrieben.

47 47

48Führen Sie `/doctor` aus, um Ihre Konfiguration und Installation zu überprüfen. Es meldet, was es findet, einschließlich ungültiger Einstellungsdateien, doppelter Installationen, ungenutzter Erweiterungen und {/* min-version: 2.1.206 */}eingecheckter `CLAUDE.md`-Inhalte, die Claude aus der Codebasis ableiten kann, und schlägt dann Fixes vor, die es nur nach Ihrer Bestätigung anwendet. Die `CLAUDE.md`-Kürzungsprü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 zur Behebung.48Führen Sie `/doctor` aus, um Ihre Konfiguration und Installation zu überprüfen. Es meldet, was es findet, einschließlich ungültiger Einstellungsdateien, doppelter Installationen, ungenutzter Erweiterungen und eingecheckter `CLAUDE.md`-Inhalte, die Claude aus der Codebasis ableiten kann, und schlägt dann Fixes vor, die es nur nach Ihrer Bestätigung anwendet. Die `CLAUDE.md`-Kürzungsprü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 zur Behebung.

49 49

50Aus dem Terminal druckt `claude doctor` schreibgeschützte Installations- und Einstellungsdiagnosen, ohne eine Sitzung zu starten.50Aus dem Terminal druckt `claude doctor` schreibgeschützte Installations- und Einstellungsdiagnosen, ohne eine Sitzung zu starten.

51 51

52Führen Sie `/status` aus, um zu sehen, welche Einstellungsquellen aktiv sind, einschließlich ob verwaltete Einstellungen wirksam sind. Um zu verstehen, welcher Bereich für einen bestimmten Schlüssel gewinnt, siehe [Wie Bereiche interagieren](/de/settings#how-scopes-interact).52Führen Sie `/status` aus, um zu sehen, welche Einstellungsquellen aktiv sind, einschließlich ob verwaltete Einstellungen wirksam sind. Um zu verstehen, welcher Bereich für einen bestimmten Schlüssel gewinnt, siehe [Wie Bereiche interagieren](/docs/de/settings#how-scopes-interact).

53 53

54<h2 id="check-mcp-servers">54<h2 id="check-mcp-servers">

55 Überprüfen Sie MCP-Server55 Überprüfen Sie MCP-Server

61* Ein Server, der nicht startet, wird in `/mcp` als fehlgeschlagen angezeigt. Relative Dateipfade in `command` oder `args` sind eine häufige Ursache, da sie gegen das Verzeichnis aufgelöst werden, von dem aus Sie Claude Code gestartet haben, nicht gegen den Speicherort von `.mcp.json`.61* Ein Server, der nicht startet, wird in `/mcp` als fehlgeschlagen angezeigt. Relative Dateipfade in `command` oder `args` sind eine häufige Ursache, da sie gegen das Verzeichnis aufgelöst werden, von dem aus Sie Claude Code gestartet haben, nicht gegen den Speicherort von `.mcp.json`.

62* Ein Server, der als verbunden angezeigt wird, aber null Tools auflistet, hat erfolgreich gestartet, gibt aber keine Toolliste zurück. Wählen Sie **Reconnect** von `/mcp`. Wenn die Anzahl bei null bleibt, führen Sie `claude --debug mcp` aus, um die Stderr-Ausgabe des Servers zu sehen.62* Ein Server, der als verbunden angezeigt wird, aber null Tools auflistet, hat erfolgreich gestartet, gibt aber keine Toolliste zurück. Wählen Sie **Reconnect** von `/mcp`. Wenn die Anzahl bei null bleibt, führen Sie `claude --debug mcp` aus, um die Stderr-Ausgabe des Servers zu sehen.

63 63

~~64Für Konfigurationsspeicherorte und Bereichsregeln siehe [MCP](/de/mcp).~~64Für Konfigurationsspeicherorte und Bereichsregeln siehe [MCP](/docs/de/mcp).

65 65

66<h2 id="check-hooks">66<h2 id="check-hooks">

67 Überprüfen Sie Hooks67 Überprüfen Sie Hooks

71 71

72Wenn der Hook angezeigt wird, aber nicht ausgelöst wird, ist der Matcher die übliche Ursache. Überprüfen Sie ihn auf diese Fehler:72Wenn der Hook angezeigt wird, aber nicht ausgelöst wird, ist der Matcher die übliche Ursache. Überprüfen Sie ihn auf diese Fehler:

73 73

74* Das Feld `matcher` ist eine einzelne Zeichenkette, die `|` verwendet, um mehrere Tool-Namen zu entsprechen, z. B. `"Edit|Write"`. {/* min-version: 2.1.191 */}Ein `,`-Trennzeichen ist gleichwertig, sodass `"Edit,Write"` dieselben Tools entspricht. Vor v2.1.191 wurde ein Komma zur Regex-Auswertung durchgeleitet und der Matcher stimmte nie überein, daher verwenden Sie `|`, wenn Sie nicht auf v2.1.191 sind.74* 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* Ein falsch geschriebener Tool-Name erzeugt einen Matcher, der nichts entspricht, sodass der Hook stillschweigend fehlschlägt.75* Ein falsch geschriebener Tool-Name erzeugt einen Matcher, der nichts entspricht, sodass der Hook stillschweigend fehlschlägt.

76* Ein Array-Wert ist ein Schemafehler: Claude Code zeigt einen Einstellungsfehler an und lehnt die gesamte Benutzer-, Projekt- oder lokale Einstellungsdatei ab, `claude doctor` meldet den Validierungsfehler, und kein Hook aus dieser Datei wird in `/hooks` angezeigt. In [verwalteten Einstellungen](/de/settings#settings-files) wird nur der ungültige Eintrag entfernt und die anderen Hooks der Datei gelten weiterhin.76* Ein Array-Wert ist ein Schemafehler: Claude Code zeigt einen Einstellungsfehler an und lehnt die gesamte Benutzer-, Projekt- oder lokale Einstellungsdatei ab, `claude doctor` meldet den Validierungsfehler, und kein Hook aus dieser Datei wird in `/hooks` angezeigt. In [verwalteten Einstellungen](/docs/de/settings#settings-files) wird nur der ungültige Eintrag entfernt und die anderen Hooks der Datei gelten weiterhin.

77 77

78Änderungen an `settings.json` werden in der laufenden Sitzung nach einer kurzen Dateistabilitätsverzögerung wirksam. Sie müssen nicht neu starten. Wenn `/hooks` einige Sekunden nach dem Speichern immer noch die alte Definition anzeigt, führen Sie `/hooks` erneut aus, um die Ansicht zu aktualisieren.78Änderungen an `settings.json` werden in der laufenden Sitzung nach einer kurzen Dateistabilitätsverzögerung wirksam. Sie müssen nicht neu starten. Wenn `/hooks` einige Sekunden nach dem Speichern immer noch die alte Definition anzeigt, führen Sie `/hooks` erneut aus, um die Ansicht zu aktualisieren.

79 79

80Wenn `/hooks` den Hook anzeigt, aber er wird immer noch nicht ausgelöst, besteht der nächste Schritt darin, die Hook-Auswertung live zu beobachten. Starten Sie eine Sitzung mit `claude --debug hooks` und lösen Sie den Tool-Aufruf aus. Das Debug-Protokoll zeichnet jedes Ereignis, welche Matcher überprüft wurden, und den Exit-Code und die Ausgabe des Hooks auf. Siehe [Debug Hooks](/de/hooks#debug-hooks) für das Protokollformat und [Hooks Troubleshooting](/de/hooks-guide#limitations-and-troubleshooting) für häufige Fehlermuster.80Wenn `/hooks` den Hook anzeigt, aber er wird immer noch nicht ausgelöst, besteht der nächste Schritt darin, die Hook-Auswertung live zu beobachten. Starten Sie eine Sitzung mit `claude --debug hooks` und lösen Sie den Tool-Aufruf aus. Das Debug-Protokoll zeichnet jedes Ereignis, welche Matcher überprüft wurden, und den Exit-Code und die Ausgabe des Hooks auf. Siehe [Debug Hooks](/docs/de/hooks#debug-hooks) für das Protokollformat und [Hooks Troubleshooting](/docs/de/hooks-guide#limitations-and-troubleshooting) für häufige Fehlermuster.

81 81

82<h2 id="test-against-a-clean-configuration">82<h2 id="test-against-a-clean-configuration">

83 Testen Sie gegen eine saubere Konfiguration83 Testen Sie gegen eine saubere Konfiguration

84</h2>84</h2>

85 85

86{/* min-version: 2.1.169 */}Beginnen Sie mit [`claude --safe-mode`](/de/cli-reference#cli-flags), das eine Sitzung mit allen deaktivierten Anpassungen startet, einschließlich `CLAUDE.md`, Skills, Plugins, Hooks, MCP-Servern und benutzerdefinierten Befehlen und Agenten. Authentifizierung, Modellauswahl, integrierte Tools und Berechtigungen funktionieren normal. Wenn das Problem im abgesicherten Modus verschwindet, ist eine dieser Oberflächen die Ursache; verwenden Sie die gezielten Überprüfungen oben, um herauszufinden, welche. Der abgesicherte Modus wendet immer noch verwaltete Hooks und die Einstellungsrichtlinie Ihrer Organisation an. Verwaltete Plugins, Skills, `CLAUDE.md` und MCP-Server sind ausgeschaltet.86Beginnen Sie mit [`claude --safe-mode`](/docs/de/cli-reference#cli-flags), das eine Sitzung mit allen deaktivierten Anpassungen startet, einschließlich `CLAUDE.md`, Skills, Plugins, Hooks, MCP-Servern und benutzerdefinierten Befehlen und Agenten. Authentifizierung, Modellauswahl, integrierte Tools und Berechtigungen funktionieren normal. Wenn das Problem im abgesicherten Modus verschwindet, ist eine dieser Oberflächen die Ursache; verwenden Sie die gezielten Überprüfungen oben, um herauszufinden, welche. Der abgesicherte Modus wendet immer noch verwaltete Hooks und die Einstellungsrichtlinie Ihrer Organisation an. Verwaltete Plugins, Skills, `CLAUDE.md` und MCP-Server sind ausgeschaltet.

87 87

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

89 89

90```bash theme={null}90```bash theme={null}

91cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude91cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude

97* Unter Linux und Windows werden Sie aufgefordert, sich erneut anzumelden, da Anmeldedaten unter dem Konfigurationsverzeichnis gespeichert sind97* Unter Linux und Windows werden Sie aufgefordert, sich erneut anzumelden, da Anmeldedaten unter dem Konfigurationsverzeichnis gespeichert sind

98* Unter macOS befinden sich Anmeldedaten im Keychain und werden in die saubere Sitzung übernommen98* Unter macOS befinden sich Anmeldedaten im Keychain und werden in die saubere Sitzung übernommen

99 99

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

101 101

102<h2 id="check-common-causes">102<h2 id="check-common-causes">

103 Überprüfen Sie häufige Ursachen103 Überprüfen Sie häufige Ursachen

107 107

109| :-------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |109| :-------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

111| Hook wird nie ausgelöst | `matcher` verwendet `,` als Trennzeichen in einer Version vor v2.1.191 | {/* min-version: 2.1.191 */}Claude Code v2.1.191 oder später behandelt `,` als Listentrennzeichen wie `\|`. Frühere Versionen bewerten ein Komma als Literalzeichen, daher entspricht `"Edit,Write"` nichts. Verwenden Sie stattdessen `\|`, oder aktualisieren Sie Claude Code. |111| Hook wird nie ausgelöst | `matcher` verwendet `,` als Trennzeichen in einer Version vor v2.1.191 | Claude Code v2.1.191 oder später behandelt `,` als Listentrennzeichen wie `\|`. Frühere Versionen bewerten ein Komma als Literalzeichen, daher entspricht `"Edit,Write"` nichts. Verwenden Sie stattdessen `\|`, oder aktualisieren Sie Claude Code. |

112| Hook wird nie ausgelöst | `matcher`-Wert ist Kleinbuchstaben, z. B. `"bash"` | Matching ist Groß-/Kleinschreibung-empfindlich. Tool-Namen werden großgeschrieben: `Bash`, `Edit`, `Write`, `Read`. |112| Hook wird nie ausgelöst | `matcher`-Wert ist Kleinbuchstaben, z. B. `"bash"` | Matching ist Groß-/Kleinschreibung-empfindlich. Tool-Namen werden großgeschrieben: `Bash`, `Edit`, `Write`, `Read`. |

113| Hook wird nie ausgelöst | Hooks befinden sich in einer eigenständigen Datei statt in `settings.json` | Es gibt keine eigenständige Hooks-Datei für Projekt- oder Benutzerkonfiguration. Definieren Sie Hooks unter dem Schlüssel `"hooks"` in `settings.json`. Nur [Plugins](/de/plugins-reference#hooks) laden eine separate `hooks/hooks.json`. Siehe [Hook-Konfiguration](/de/hooks). |113| Hook wird nie ausgelöst | Hooks befinden sich in einer eigenständigen Datei statt in `settings.json` | Es gibt keine eigenständige Hooks-Datei für Projekt- oder Benutzerkonfiguration. Definieren Sie Hooks unter dem Schlüssel `"hooks"` in `settings.json`. Nur [Plugins](/docs/de/plugins-reference#hooks) laden eine separate `hooks/hooks.json`. Siehe [Hook-Konfiguration](/docs/de/hooks). |

114| Berechtigungen, Hooks oder global gesetzte Umgebungsvariablen werden ignoriert | Konfiguration wurde zu `~/.claude.json` hinzugefügt | `~/.claude.json` enthält App-Status und UI-Umschalter. `permissions`, `hooks` und `env` gehören zu `~/.claude/settings.json`. Dies sind zwei verschiedene Dateien. |114| Berechtigungen, Hooks oder global gesetzte Umgebungsvariablen werden ignoriert | Konfiguration wurde zu `~/.claude.json` hinzugefügt | `~/.claude.json` enthält App-Status und UI-Umschalter. `permissions`, `hooks` und `env` gehören zu `~/.claude/settings.json`. Dies sind zwei verschiedene Dateien. |

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

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

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

118| Anweisungen im Unterverzeichnis `CLAUDE.md` scheinen ignoriert zu werden | Unterverzeichnisdateien werden bei Bedarf geladen, nicht beim Sitzungsstart | Sie werden geladen, wenn Claude eine Datei in diesem Verzeichnis mit dem Read-Tool liest, nicht beim Start und nicht beim Schreiben oder Erstellen von Dateien dort. Siehe [wie CLAUDE.md-Dateien geladen werden](/de/memory#how-claude-md-files-load). |118| Anweisungen im Unterverzeichnis `CLAUDE.md` scheinen ignoriert zu werden | Unterverzeichnisdateien werden bei Bedarf geladen, nicht beim Sitzungsstart | Sie werden geladen, wenn Claude eine Datei in diesem Verzeichnis mit dem Read-Tool liest, nicht beim Start und nicht beim Schreiben oder Erstellen von Dateien dort. Siehe [wie CLAUDE.md-Dateien geladen werden](/docs/de/memory#how-claude-md-files-load). |

119| Subagent ignoriert `CLAUDE.md`-Anweisungen | Die integrierten Explore- und Plan-Agenten überspringen `CLAUDE.md`. Benutzerdefinierte Subagenten laden es auf die gleiche Weise wie die Hauptkonversation | Für Explore oder Plan wiederholen Sie die Anweisung in Ihrer delegierenden Aufforderung. Für einen benutzerdefinierten Subagenten setzen Sie kritische Anweisungen in den Agent-Dateitext, der zur Systemaufforderung des Agenten wird. Siehe [was beim Start geladen wird](/de/sub-agents#what-loads-at-startup). |119| Subagent ignoriert `CLAUDE.md`-Anweisungen | Die integrierten Explore- und Plan-Agenten überspringen `CLAUDE.md`. Benutzerdefinierte Subagenten laden es auf die gleiche Weise wie die Hauptkonversation | Für Explore oder Plan wiederholen Sie die Anweisung in Ihrer delegierenden Aufforderung. Für einen benutzerdefinierten Subagenten setzen Sie kritische Anweisungen in den Agent-Dateitext, der zur Systemaufforderung des Agenten wird. Siehe [was beim Start geladen wird](/docs/de/sub-agents#what-loads-at-startup). |

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

121| MCP-Server in `.mcp.json` werden nie geladen | Datei befindet sich unter `.claude/` oder verwendet das Konfigurationsformat von Claude Desktop | Projekt-MCP-Konfiguration geht an die Repository-Root als `.mcp.json`, nicht in `.claude/`. Siehe [MCP-Konfiguration](/de/mcp). |121| MCP-Server in `.mcp.json` werden nie geladen | Datei befindet sich unter `.claude/` oder verwendet das Konfigurationsformat von Claude Desktop | Projekt-MCP-Konfiguration geht an die Repository-Root als `.mcp.json`, nicht in `.claude/`. Siehe [MCP-Konfiguration](/docs/de/mcp). |

122| MCP-Server unter `mcpServers` in `settings.json` hinzugefügt, aber erscheinen nie | `settings.json` liest keinen `mcpServers`-Schlüssel | Definieren Sie Projekt-Server in `.mcp.json` an der Repository-Root, oder führen Sie `claude mcp add --scope user` für benutzergesteuerte Server aus. Siehe [MCP-Konfiguration](/de/mcp). |122| MCP-Server unter `mcpServers` in `settings.json` hinzugefügt, aber erscheinen nie | `settings.json` liest keinen `mcpServers`-Schlüssel | Definieren Sie Projekt-Server in `.mcp.json` an der Repository-Root, oder führen Sie `claude mcp add --scope user` für benutzergesteuerte Server aus. Siehe [MCP-Konfiguration](/docs/de/mcp). |

123| Projekt-MCP-Server hinzugefügt, aber erscheint nicht | Die einmalige Genehmigungsaufforderung wurde verworfen | Projektbezogene Server erfordern Genehmigung. Führen Sie `/mcp` aus, um den Status zu sehen und zu genehmigen. |123| Projekt-MCP-Server hinzugefügt, aber erscheint nicht | Die einmalige Genehmigungsaufforderung wurde verworfen | Projektbezogene Server erfordern Genehmigung. Führen Sie `/mcp` aus, um den Status zu sehen und zu genehmigen. |

124| MCP-Server kann nicht von einigen Verzeichnissen aus gestartet werden | `command` oder `args` verwendet einen relativen Dateipfad | Verwenden Sie absolute Pfade für lokale Skripte. Ausführbare Dateien auf Ihrem `PATH` wie `npx` oder `uvx` funktionieren wie gewohnt. |124| MCP-Server kann nicht von einigen Verzeichnissen aus gestartet werden | `command` oder `args` verwendet einen relativen Dateipfad | Verwenden Sie absolute Pfade für lokale Skripte. Ausführbare Dateien auf Ihrem `PATH` wie `npx` oder `uvx` funktionieren wie gewohnt. |

125| MCP-Server startet ohne erwartete Umgebungsvariablen | Variablen befinden sich in `settings.json` `env`, die nicht an MCP-Kindprozesse weitergegeben werden | Setzen Sie stattdessen pro-Server `env` in `.mcp.json`. |125| MCP-Server startet ohne erwartete Umgebungsvariablen | Variablen befinden sich in `settings.json` `env`, die nicht an MCP-Kindprozesse weitergegeben werden | Setzen Sie stattdessen pro-Server `env` in `.mcp.json`. |

126| `Bash(rm *)`-Deny-Regel blockiert nicht `/bin/rm` oder `find -delete` | Präfix-Regeln entsprechen der wörtlichen Befehlszeichenkette, nicht der zugrunde liegenden ausführbaren Datei | Fügen Sie explizite Muster für jede Variante hinzu, oder verwenden Sie einen [PreToolUse-Hook](/de/hooks-guide) oder die [Sandbox](/de/sandboxing) für eine harte Garantie. |126| `Bash(rm *)`-Deny-Regel blockiert nicht `/bin/rm` oder `find -delete` | Präfix-Regeln entsprechen der wörtlichen Befehlszeichenkette, nicht der zugrunde liegenden ausführbaren Datei | Fügen Sie explizite Muster für jede Variante hinzu, oder verwenden Sie einen [PreToolUse-Hook](/docs/de/hooks-guide) oder die [Sandbox](/docs/de/sandboxing) für eine harte Garantie. |

127 127

128<h2 id="related-resources">128<h2 id="related-resources">

129 Verwandte Ressourcen129 Verwandte Ressourcen

131 131

132Für vollständige Referenzen zu jeder Konfigurationsoberfläche siehe die dedizierte Seite:132Für vollständige Referenzen zu jeder Konfigurationsoberfläche siehe die dedizierte Seite:

133 133

134* **[`.claude`-Verzeichnisreferenz](/de/claude-directory)**: jeder Konfigurationsdateispeicherort und wer ihn liest134* **[`.claude`-Verzeichnisreferenz](/docs/de/claude-directory)**: jeder Konfigurationsdateispeicherort und wer ihn liest

135* **[Einstellungen](/de/settings)**: Prioritätsreihenfolge und die vollständige Schlüsselliste135* **[Einstellungen](/docs/de/settings)**: Prioritätsreihenfolge und die vollständige Schlüsselliste

136* **[Hooks-Referenz](/de/hooks)**: Ereignisnamen, Payloads und `--debug hooks`-Ausgabeformat136* **[Hooks-Referenz](/docs/de/hooks)**: Ereignisnamen, Payloads und `--debug hooks`-Ausgabeformat

137* **[MCP](/de/mcp)**: Server-Konfiguration, Genehmigung und `/mcp`-Ausgabe137* **[MCP](/docs/de/mcp)**: Server-Konfiguration, Genehmigung und `/mcp`-Ausgabe

138* **[Troubleshooting bei Installation und Anmeldung](/de/troubleshoot-install)**: `command not found`, PATH und Authentifizierungsprobleme138* **[Troubleshooting bei Installation und Anmeldung](/docs/de/troubleshoot-install)**: `command not found`, PATH und Authentifizierungsprobleme

139* **[Troubleshooting](/de/troubleshooting)**: Leistung, Hängen und Suchprobleme139* **[Troubleshooting](/docs/de/troubleshooting)**: Leistung, Hängen und Suchprobleme

desktop.md +72 −72

Details

17 For x64 processors17 For x64 processors

18 </Card>18 </Card>

19 19

~~20 <Card title="Get Claude for Linux (beta)" icon="linux" href="/en/desktop-linux">~~20 <Card title="Get Claude for Linux (beta)" icon="linux" href="/docs/en/desktop-linux">

21 apt or .deb for Ubuntu and Debian21 apt or .deb for Ubuntu and Debian

22 </Card>22 </Card>

23</CardGroup>23</CardGroup>

24 24

25For Windows ARM64, download the [ARM64 installer](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). On Linux, install with apt; see [Claude Desktop on Linux](/en/desktop-linux).25For Windows ARM64, download the [ARM64 installer](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). On Linux, install with apt; see [Claude Desktop on Linux](/docs/en/desktop-linux).

26 26

27Nach der Installation starten Sie Claude, melden sich an und klicken auf die Registerkarte **Code**. Beim ersten Öffnen unter Windows benötigen Sie [Git für Windows](https://git-scm.com/downloads/win) installiert; starten Sie die App nach der Installation neu. Eine Anleitung für Ihre erste Sitzung finden Sie im [Leitfaden „Erste Schritte"](/de/desktop-quickstart).27Nach der Installation starten Sie Claude, melden sich an und klicken auf die Registerkarte **Code**. Beim ersten Öffnen unter Windows benötigen Sie [Git für Windows](https://git-scm.com/downloads/win) installiert; starten Sie die App nach der Installation neu. Eine Anleitung für Ihre erste Sitzung finden Sie im [Leitfaden „Erste Schritte"](/docs/de/desktop-quickstart).

28 28

29In der Registerkarte Code ist jedes Gespräch eine **Sitzung**: Es hat seinen eigenen Chat-Verlauf, Projektordner und Code-Änderungen, unabhängig von jeder anderen Sitzung. Die Seitenleiste listet Ihre Sitzungen auf und ermöglicht es Ihnen, mehrere parallel auszuführen. Innerhalb einer Sitzung können Sie:29In der Registerkarte Code ist jedes Gespräch eine **Sitzung**: Es hat seinen eigenen Chat-Verlauf, Projektordner und Code-Änderungen, unabhängig von jeder anderen Sitzung. Die Seitenleiste listet Ihre Sitzungen auf und ermöglicht es Ihnen, mehrere parallel auszuführen. Innerhalb einer Sitzung können Sie:

30 30

36* Claude [Apps öffnen und Ihren Bildschirm steuern lassen](#let-claude-use-your-computer)36* Claude [Apps öffnen und Ihren Bildschirm steuern lassen](#let-claude-use-your-computer)

37* Auf Ihrem Computer, in der [Cloud](#run-long-running-tasks-remotely) oder über [SSH](#ssh-sessions) ausführen37* Auf Ihrem Computer, in der [Cloud](#run-long-running-tasks-remotely) oder über [SSH](#ssh-sessions) ausführen

38 38

39Für [geplante wiederkehrende Arbeiten](/de/desktop-scheduled-tasks), [Tastaturkürzel](#keyboard-shortcuts) oder [Aufgaben von Ihrem Telefon senden](#sessions-from-dispatch) siehe die verlinkten Seiten und Abschnitte. Wenn Sie bereits die Terminal-basierte CLI verwenden, siehe den [CLI-Vergleich](#coming-from-the-cli) für das, was übertragen wird.39Für [geplante wiederkehrende Arbeiten](/docs/de/desktop-scheduled-tasks), [Tastaturkürzel](#keyboard-shortcuts) oder [Aufgaben von Ihrem Telefon senden](#sessions-from-dispatch) siehe die verlinkten Seiten und Abschnitte. Wenn Sie bereits die Terminal-basierte CLI verwenden, siehe den [CLI-Vergleich](#coming-from-the-cli) für das, was übertragen wird.

40 40

41<h2 id="start-a-session">41<h2 id="start-a-session">

42 Sitzung starten42 Sitzung starten

44 44

45Bevor Sie Ihre erste Nachricht senden, konfigurieren Sie vier Dinge im Eingabebereich:45Bevor Sie Ihre erste Nachricht senden, konfigurieren Sie vier Dinge im Eingabebereich:

46 46

47* **Umgebung**: Wählen Sie, wo Claude ausgeführt wird. Wählen Sie **Lokal** für Ihren Computer, **Remote** für von Anthropic gehostete Cloud-Sitzungen, eine [**SSH-Verbindung**](#ssh-sessions) für einen von Ihnen verwalteten Remote-Computer oder unter Windows eine [**WSL-Distribution**](/de/desktop-wsl). Siehe [Umgebungskonfiguration](#environment-configuration).47* **Umgebung**: Wählen Sie, wo Claude ausgeführt wird. Wählen Sie **Lokal** für Ihren Computer, **Remote** für von Anthropic gehostete Cloud-Sitzungen, eine [**SSH-Verbindung**](#ssh-sessions) für einen von Ihnen verwalteten Remote-Computer oder unter Windows eine [**WSL-Distribution**](/docs/de/desktop-wsl). Siehe [Umgebungskonfiguration](#environment-configuration).

48* **Projektordner**: Wählen Sie den Ordner oder das Repository aus, in dem Claude arbeitet. Für Cloud-Sitzungen können Sie [mehrere Repositories](#run-long-running-tasks-remotely) hinzufügen.48* **Projektordner**: Wählen Sie den Ordner oder das Repository aus, in dem Claude arbeitet. Für Cloud-Sitzungen können Sie [mehrere Repositories](#run-long-running-tasks-remotely) hinzufügen.

~~49* **Modell**: Wählen Sie ein [Modell](/de/model-config#available-models) aus dem Dropdown neben der Schaltfläche „Senden". Sie können dies während der Sitzung ändern.~~49* **Modell**: Wählen Sie ein [Modell](/docs/de/model-config#available-models) aus dem Dropdown neben der Schaltfläche „Senden". Sie können dies während der Sitzung ändern.

50* **Berechtigungsmodus**: Wählen Sie, wie viel Autonomie Claude aus dem [Moduswahlschalter](#choose-a-permission-mode) hat. Sie können dies während der Sitzung ändern.50* **Berechtigungsmodus**: Wählen Sie, wie viel Autonomie Claude aus dem [Moduswahlschalter](#choose-a-permission-mode) hat. Sie können dies während der Sitzung ändern.

51 51

52Geben Sie Ihre Aufgabe ein und drücken Sie **Eingabe**, um zu starten. Jede Sitzung verfolgt ihren eigenen Kontext und Änderungen unabhängig.52Geben Sie Ihre Aufgabe ein und drücken Sie **Eingabe**, um zu starten. Jede Sitzung verfolgt ihren eigenen Kontext und Änderungen unabhängig.

80 80

81Berechtigungsmodi kontrollieren, wie viel Autonomie Claude während einer Sitzung hat: ob es vor dem Bearbeiten von Dateien, dem Ausführen von Befehlen oder beidem fragt. Sie können Modi jederzeit mit dem Moduswahlschalter neben der Schaltfläche „Senden" wechseln. Beginnen Sie mit Manual, um genau zu sehen, was Claude tut, und wechseln Sie dann zu Accept edits oder Plan, wenn Sie sich wohler fühlen.81Berechtigungsmodi kontrollieren, wie viel Autonomie Claude während einer Sitzung hat: ob es vor dem Bearbeiten von Dateien, dem Ausführen von Befehlen oder beidem fragt. Sie können Modi jederzeit mit dem Moduswahlschalter neben der Schaltfläche „Senden" wechseln. Beginnen Sie mit Manual, um genau zu sehen, was Claude tut, und wechseln Sie dann zu Accept edits oder Plan, wenn Sie sich wohler fühlen.

82 82

83Um einen Standardmodus für neue lokale Sitzungen festzulegen, fügen Sie `permissions.defaultMode` zu Ihrer [Einstellungsdatei](/de/settings#settings-files) hinzu. Die Desktop-App liest die gleichen Einstellungsdateien wie die CLI. Ein Modus, den Sie im Wahlschalter auswählen, wird pro Ordner gespeichert und hat Vorrang vor `defaultMode` für diesen Ordner, außer Plan, das nur für die aktuelle Sitzung gilt.83Um einen Standardmodus für neue lokale Sitzungen festzulegen, fügen Sie `permissions.defaultMode` zu Ihrer [Einstellungsdatei](/docs/de/settings#settings-files) hinzu. Die Desktop-App liest die gleichen Einstellungsdateien wie die CLI. Ein Modus, den Sie im Wahlschalter auswählen, wird pro Ordner gespeichert und hat Vorrang vor `defaultMode` für diesen Ordner, außer Plan, das nur für die aktuelle Sitzung gilt.

84 84

86| ---------------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |86| ---------------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

88| **Accept edits** | `acceptEdits` | Claude akzeptiert Dateibearbeitungen automatisch und häufige Dateisystem-Befehle wie `mkdir`, `touch` und `mv`, fragt aber immer noch vor dem Ausführen anderer Terminal-Befehle. Verwenden Sie dies, wenn Sie Dateiänderungen vertrauen und schnellere Iterationen wünschen. |88| **Accept edits** | `acceptEdits` | Claude akzeptiert Dateibearbeitungen automatisch und häufige Dateisystem-Befehle wie `mkdir`, `touch` und `mv`, fragt aber immer noch vor dem Ausführen anderer Terminal-Befehle. Verwenden Sie dies, wenn Sie Dateiänderungen vertrauen und schnellere Iterationen wünschen. |

89| **Plan** | `plan` | Claude liest Dateien und führt Befehle aus, um zu erkunden, schlägt dann einen Plan vor, ohne Ihren Quellcode zu bearbeiten. Gut für komplexe Aufgaben, bei denen Sie den Ansatz zuerst überprüfen möchten. |89| **Plan** | `plan` | Claude liest Dateien und führt Befehle aus, um zu erkunden, schlägt dann einen Plan vor, ohne Ihren Quellcode zu bearbeiten. Gut für komplexe Aufgaben, bei denen Sie den Ansatz zuerst überprüfen möchten. |

90| **Auto** | `auto` | Claude führt alle Aktionen mit Hintergrund-Sicherheitsprüfungen aus, die die Ausrichtung mit Ihrer Anfrage überprüfen. Reduziert Berechtigungsaufforderungen bei Beibehaltung der Überwachung. Wird angezeigt, wenn Ihr Konto die [Verfügbarkeitsanforderungen](#auto-mode-availability) unten erfüllt; es gibt keinen separaten Settings-Umschalter dafür. |90| **Auto** | `auto` | Claude führt alle Aktionen mit Hintergrund-Sicherheitsprüfungen aus, die die Ausrichtung mit Ihrer Anfrage überprüfen. Reduziert Berechtigungsaufforderungen bei Beibehaltung der Überwachung. Wird angezeigt, wenn Ihr Konto die [Verfügbarkeitsanforderungen](#auto-mode-availability) unten erfüllt; es gibt keinen separaten Settings-Umschalter dafür. |

91| **Bypass permissions** | `bypassPermissions` | Claude läuft ohne Berechtigungsaufforderungen, außer denen, die durch explizite [ask rules](/de/permissions#manage-permissions) erzwungen werden, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools), MCP-Tools mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) oder Sicherheitsklassifizierer, wenn Claude [auf externen Websites agiert](#browse-external-sites); äquivalent zu `--dangerously-skip-permissions` in der CLI. Aktivieren Sie dies auf Pro- und Max-Plänen in Ihren Einstellungen → Claude Code unter „Allow bypass permissions mode"; auf Team- und Enterprise-Plänen gibt es keinen Settings-Umschalter, und die Organisationsrichtlinie kontrolliert es stattdessen. Verwenden Sie dies nur in sandboxierten Containern oder VMs. |91| **Bypass permissions** | `bypassPermissions` | Claude läuft ohne Berechtigungsaufforderungen, außer denen, die durch explizite [ask rules](/docs/de/permissions#manage-permissions) erzwungen werden, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), MCP-Tools mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) oder Sicherheitsklassifizierer, wenn Claude [auf externen Websites agiert](#browse-external-sites); äquivalent zu `--dangerously-skip-permissions` in der CLI. Aktivieren Sie dies auf Pro- und Max-Plänen in Ihren Einstellungen → Claude Code unter „Allow bypass permissions mode"; auf Team- und Enterprise-Plänen gibt es keinen Settings-Umschalter, und die Organisationsrichtlinie kontrolliert es stattdessen. Verwenden Sie dies nur in sandboxierten Containern oder VMs. |

92 92

93Frühere Versionen der Code-Registerkarte bezeichneten diese Modi als Ask permissions, Auto accept edits und Plan mode.93Frühere Versionen der Code-Registerkarte bezeichneten diese Modi als Ask permissions, Auto accept edits und Plan mode.

94 94

~~95Der Berechtigungsmodus `dontAsk` ist nur in der [CLI](/de/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) verfügbar.~~95Der Berechtigungsmodus `dontAsk` ist nur in der [CLI](/docs/de/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) verfügbar.

96 96

97<span id="auto-mode-availability" />97<span id="auto-mode-availability" />

98 98

99Auto mode ist für alle Benutzer auf der Anthropic API verfügbar und erfordert Claude Opus 4.6 oder später oder Sonnet 4.6 oder später. Organisationsadministratoren können Auto mode mit dem Schlüssel `disableAutoMode` in [verwalteten Einstellungen](#managed-settings) ausschalten.99Auto mode ist für alle Benutzer auf der Anthropic API verfügbar und erfordert Claude Opus 4.6 oder später oder Sonnet 4.6 oder später. Organisationsadministratoren können Auto mode mit dem Schlüssel `disableAutoMode` in [verwalteten Einstellungen](#managed-settings) ausschalten.

100 100

101Bei Enterprise-Bereitstellungen, die Desktop zu Google Cloud's Agent Platform weiterleiten, ist Auto mode [standardmäßig verfügbar](/de/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), und nur Claude Sonnet 5, Opus 4.7 und Opus 4.8 werden dort unterstützt. {/* min-version: 2.1.207 */}Vor Claude Code v2.1.207 mussten Enterprise-Bereitstellungen auf Google Cloud's Agent Platform `CLAUDE_CODE_ENABLE_AUTO_MODE` setzen, um Auto mode zu aktivieren.101Bei Enterprise-Bereitstellungen, die Desktop zu Google Cloud's Agent Platform weiterleiten, ist Auto mode [standardmäßig verfügbar](/docs/de/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), und nur Claude Sonnet 5, Opus 4.7 und Opus 4.8 werden dort unterstützt. Vor Claude Code v2.1.207 mussten Enterprise-Bereitstellungen auf Google Cloud's Agent Platform `CLAUDE_CODE_ENABLE_AUTO_MODE` setzen, um Auto mode zu aktivieren.

102 102

103<Tip title="Best practice">103<Tip title="Best practice">

104 Beginnen Sie komplexe Aufgaben im Plan, damit Claude einen Ansatz abbildet, bevor Änderungen vorgenommen werden. Sobald Sie den Plan genehmigen, wechseln Sie zu Accept edits oder Manual, um ihn auszuführen. Siehe [explore first, then plan, then code](/de/best-practices#explore-first-then-plan-then-code) für mehr zu diesem Workflow.104 Beginnen Sie komplexe Aufgaben im Plan, damit Claude einen Ansatz abbildet, bevor Änderungen vorgenommen werden. Sobald Sie den Plan genehmigen, wechseln Sie zu Accept edits oder Manual, um ihn auszuführen. Siehe [explore first, then plan, then code](/docs/de/best-practices#explore-first-then-plan-then-code) für mehr zu diesem Workflow.

105</Tip>105</Tip>

106 106

107Cloud-Sitzungen unterstützen Accept edits, Plan und Auto. Accept edits entspricht dem `default`-Modus: Cloud-Sitzungen genehmigen Dateibearbeitungen vorab, daher zeigt der Wahlschalter Accept edits statt Manual an. Bypass permissions ist nicht verfügbar, da die Cloud-Umgebung bereits sandboxed ist.107Cloud-Sitzungen unterstützen Accept edits, Plan und Auto. Accept edits entspricht dem `default`-Modus: Cloud-Sitzungen genehmigen Dateibearbeitungen vorab, daher zeigt der Wahlschalter Accept edits statt Manual an. Bypass permissions ist nicht verfügbar, da die Cloud-Umgebung bereits sandboxed ist.

145 145

146Wenn Claude zum ersten Mal auf einer externen Website agiert, wird eine Berechtigungskarte angezeigt und Claude wartet auf Ihre Wahl: **Allow once**, **Always allow** oder **Deny**. **Allow once** genehmigt die Aktion, ohne etwas zu speichern. **Always allow** speichert die Genehmigung für diese Website auf Ihrem Gerät, und Sie können sie in Einstellungen widerrufen. Jede Website benötigt ihre eigene Genehmigung, einschließlich Subdomains. Ihre lokalen Dev-Server und Projektdateien benötigen keine Genehmigung, daher funktioniert [auto-verify](#auto-verify-changes) ohne Aufforderungen.146Wenn Claude zum ersten Mal auf einer externen Website agiert, wird eine Berechtigungskarte angezeigt und Claude wartet auf Ihre Wahl: **Allow once**, **Always allow** oder **Deny**. **Allow once** genehmigt die Aktion, ohne etwas zu speichern. **Always allow** speichert die Genehmigung für diese Website auf Ihrem Gerät, und Sie können sie in Einstellungen widerrufen. Jede Website benötigt ihre eigene Genehmigung, einschließlich Subdomains. Ihre lokalen Dev-Server und Projektdateien benötigen keine Genehmigung, daher funktioniert [auto-verify](#auto-verify-changes) ohne Aufforderungen.

147 147

148Auch auf einer genehmigten Website wird Claude keine Artikel kaufen, Konten erstellen oder CAPTCHAs umgehen, ohne Ihre Eingabe. Das Durchsuchen im Browser-Pane verwendet das gleiche Sicherheitsmodell wie die [Claude in Chrome-Erweiterung](/de/chrome). Siehe [Using Claude in Chrome safely](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) für die Behandlung sensibler Websites und riskanter Aktionen durch Claude.148Auch auf einer genehmigten Website wird Claude keine Artikel kaufen, Konten erstellen oder CAPTCHAs umgehen, ohne Ihre Eingabe. Das Durchsuchen im Browser-Pane verwendet das gleiche Sicherheitsmodell wie die [Claude in Chrome-Erweiterung](/docs/de/chrome). Siehe [Using Claude in Chrome safely](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) für die Behandlung sensibler Websites und riskanter Aktionen durch Claude.

149 149

150<h4 id="choose-between-the-browser-and-the-chrome-extension">150<h4 id="choose-between-the-browser-and-the-chrome-extension">

151 Wählen Sie zwischen dem Browser-Pane und der Chrome-Erweiterung151 Wählen Sie zwischen dem Browser-Pane und der Chrome-Erweiterung

152</h4>152</h4>

153 153

154Das Browser-Pane verwendet ein sauberes Browser-Profil, getrennt von Ihrem persönlichen Browser, ohne Ihre gespeicherten Anmeldungen oder Verlauf. Verwenden Sie es zum Erstellen und Testen Ihrer App und für Websites, die Ihre Identität nicht benötigen. Wenn Sie möchten, dass Claude als Sie in Ihren angemeldeten Sitzungen agiert, verwenden Sie stattdessen die [Claude in Chrome-Erweiterung](/de/chrome), die den Anmeldestatus Ihres Browsers teilt.154Das Browser-Pane verwendet ein sauberes Browser-Profil, getrennt von Ihrem persönlichen Browser, ohne Ihre gespeicherten Anmeldungen oder Verlauf. Verwenden Sie es zum Erstellen und Testen Ihrer App und für Websites, die Ihre Identität nicht benötigen. Wenn Sie möchten, dass Claude als Sie in Ihren angemeldeten Sitzungen agiert, verwenden Sie stattdessen die [Claude in Chrome-Erweiterung](/docs/de/chrome), die den Anmeldestatus Ihres Browsers teilt.

155 155

156<h4 id="restrict-external-browsing-for-your-organization">156<h4 id="restrict-external-browsing-for-your-organization">

157 Beschränken Sie das externe Durchsuchen für Ihre Organisation157 Beschränken Sie das externe Durchsuchen für Ihre Organisation

275| `1`–`9` | Element in einem offenen Menü auswählen |275| `1`–`9` | Element in einem offenen Menü auswählen |

276 276

277Diese Kürzel gelten nur für den Code-Tab. Die Terminal-basierten [Kürzel des interaktiven Modus](/de/interactive-mode#keyboard-shortcuts), wie `Shift+Tab` zum Zyklisieren von Modi, gelten nicht in Desktop.277Diese Kürzel gelten nur für den Code-Tab. Die Terminal-basierten [Kürzel des interaktiven Modus](/docs/de/interactive-mode#keyboard-shortcuts), wie `Shift+Tab` zum Zyklisieren von Modi, gelten nicht in Desktop.

278 278

279<h3 id="check-usage">279<h3 id="check-usage">

280 Überprüfen Sie die Nutzung280 Überprüfen Sie die Nutzung

295Computernutzung ist standardmäßig deaktiviert. [Aktivieren Sie sie in Einstellungen](#enable-computer-use), bevor Claude Ihren Bildschirm steuern kann. Auf macOS müssen Sie auch Barrierefreiheits- und Bildschirmaufzeichnungsberechtigungen gewähren.295Computernutzung ist standardmäßig deaktiviert. [Aktivieren Sie sie in Einstellungen](#enable-computer-use), bevor Claude Ihren Bildschirm steuern kann. Auf macOS müssen Sie auch Barrierefreiheits- und Bildschirmaufzeichnungsberechtigungen gewähren.

296 296

297<Warning>297<Warning>

298 Im Gegensatz zum [sandboxierten Bash-Tool](/de/sandboxing) läuft Computernutzung auf Ihrem tatsächlichen Desktop mit Zugriff auf das, was Sie genehmigen. Claude überprüft jede Aktion und kennzeichnet potenzielle Prompt-Injection von Bildschirminhalten, aber die Vertrauensgrenze ist unterschiedlich. Siehe den [Sicherheitsleitfaden für Computernutzung](https://support.claude.com/en/articles/14128542) für Best Practices.298 Im Gegensatz zum [sandboxierten Bash-Tool](/docs/de/sandboxing) läuft Computernutzung auf Ihrem tatsächlichen Desktop mit Zugriff auf das, was Sie genehmigen. Claude überprüft jede Aktion und kennzeichnet potenzielle Prompt-Injection von Bildschirminhalten, aber die Vertrauensgrenze ist unterschiedlich. Siehe den [Sicherheitsleitfaden für Computernutzung](https://support.claude.com/en/articles/14128542) für Best Practices.

299</Warning>299</Warning>

300 300

301<h3 id="when-computer-use-applies">301<h3 id="when-computer-use-applies">

306 306

307* Wenn Sie einen [Konnektor](#connect-external-tools) für einen Dienst haben, verwendet Claude den Konnektor.307* Wenn Sie einen [Konnektor](#connect-external-tools) für einen Dienst haben, verwendet Claude den Konnektor.

308* Wenn die Aufgabe ein Shell-Befehl ist, verwendet Claude Bash.308* Wenn die Aufgabe ein Shell-Befehl ist, verwendet Claude Bash.

309* Wenn die Aufgabe Browser-Arbeit ist und Sie [Claude in Chrome](/de/chrome) eingerichtet haben, verwendet Claude das.309* Wenn die Aufgabe Browser-Arbeit ist und Sie [Claude in Chrome](/docs/de/chrome) eingerichtet haben, verwendet Claude das.

310* Wenn keine dieser Optionen zutrifft, verwendet Claude Computernutzung.310* Wenn keine dieser Optionen zutrifft, verwendet Claude Computernutzung.

311 311

312Die [Pro-App-Zugriffsstufen](#app-permissions) verstärken dies: Browser sind auf Nur-Ansicht begrenzt, und Terminals und IDEs auf Nur-Klick, was Claude zum dedizierten Tool lenkt, auch wenn Computernutzung aktiv ist. Bildschirmsteuerung ist für Dinge reserviert, die nichts anderes erreichen kann, wie native Apps, Hardware-Steuerfelder, mobile Simulatoren oder proprietäre Tools ohne API.312Die [Pro-App-Zugriffsstufen](#app-permissions) verstärken dies: Browser sind auf Nur-Ansicht begrenzt, und Terminals und IDEs auf Nur-Klick, was Claude zum dedizierten Tool lenkt, auch wenn Computernutzung aktiv ist. Bildschirmsteuerung ist für Dinge reserviert, die nichts anderes erreichen kann, wie native Apps, Hardware-Steuerfelder, mobile Simulatoren oder proprietäre Tools ohne API.

319 319

320<Steps>320<Steps>

321 <Step title="Aktualisieren Sie die Desktop-App">321 <Step title="Aktualisieren Sie die Desktop-App">

322 Stellen Sie sicher, dass Sie die neueste Version von Claude Desktop haben. Auf macOS und Windows laden Sie herunter oder aktualisieren Sie unter [claude.com/download](https://claude.com/download); unter Linux aktualisieren Sie über Ihren Paketmanager ([Anweisungen](/de/desktop-linux)). Starten Sie dann die App neu.322 Stellen Sie sicher, dass Sie die neueste Version von Claude Desktop haben. Auf macOS und Windows laden Sie herunter oder aktualisieren Sie unter [claude.com/download](https://claude.com/download); unter Linux aktualisieren Sie über Ihren Paketmanager ([Anweisungen](/docs/de/desktop-linux)). Starten Sie dann die App neu.

323 </Step>323 </Step>

324 324

325 <Step title="Schalten Sie den Umschalter ein">325 <Step title="Schalten Sie den Umschalter ein">

369 Arbeiten Sie parallel mit Sitzungen369 Arbeiten Sie parallel mit Sitzungen

370</h3>370</h3>

371 371

372Klicken Sie auf **+ Neue Sitzung** in der Seitenleiste, oder drücken Sie **Cmd+N** auf macOS oder **Ctrl+N** auf Windows, um an mehreren Aufgaben parallel zu arbeiten. Drücken Sie **Ctrl+Tab** und **Ctrl+Shift+Tab**, um durch Sitzungen in der Seitenleiste zu zyklisieren. Für Git-Repositories erhält jede Sitzung ihre eigene isolierte Kopie Ihres Projekts mit [Git Worktrees](/de/worktrees), sodass Änderungen in einer Sitzung andere Sitzungen nicht beeinflussen, bis Sie sie committen.372Klicken Sie auf **+ Neue Sitzung** in der Seitenleiste, oder drücken Sie **Cmd+N** auf macOS oder **Ctrl+N** auf Windows, um an mehreren Aufgaben parallel zu arbeiten. Drücken Sie **Ctrl+Tab** und **Ctrl+Shift+Tab**, um durch Sitzungen in der Seitenleiste zu zyklisieren. Für Git-Repositories erhält jede Sitzung ihre eigene isolierte Kopie Ihres Projekts mit [Git Worktrees](/docs/de/worktrees), sodass Änderungen in einer Sitzung andere Sitzungen nicht beeinflussen, bis Sie sie committen.

373 373

374Um zwei Sitzungen gleichzeitig anzuzeigen, halten Sie **Cmd** auf macOS oder **Ctrl** auf Windows gedrückt und klicken Sie auf eine Sitzung in der Seitenleiste. Die Sitzung wird in einem zweiten Bereich neben dem bereits geöffneten angezeigt. Während die Aufteilung aktiv ist, ersetzt das Klicken auf eine andere Sitzung in der Seitenleiste denjenigen Bereich, der den Fokus hat. Drücken Sie **Cmd+\\** auf macOS oder **Ctrl+\\** auf Windows, um den fokussierten Bereich zu schließen und zu einer einzelnen Sitzung zurückzukehren.374Um zwei Sitzungen gleichzeitig anzuzeigen, halten Sie **Cmd** auf macOS oder **Ctrl** auf Windows gedrückt und klicken Sie auf eine Sitzung in der Seitenleiste. Die Sitzung wird in einem zweiten Bereich neben dem bereits geöffneten angezeigt. Während die Aufteilung aktiv ist, ersetzt das Klicken auf eine andere Sitzung in der Seitenleiste denjenigen Bereich, der den Fokus hat. Drücken Sie **Cmd+\\** auf macOS oder **Ctrl+\\** auf Windows, um den fokussierten Bereich zu schließen und zu einer einzelnen Sitzung zurückzukehren.

375 375

376Worktrees werden standardmäßig in `<project-root>/.claude/worktrees/` gespeichert. Sie können dies in Einstellungen → Claude Code unter 'Worktree-Speicherort" in ein benutzerdefiniertes Verzeichnis ändern. Sie können auch ein Branch-Präfix festlegen, das jedem Worktree-Branch-Namen vorangestellt wird, was nützlich ist, um von Claude erstellte Branches organisiert zu halten. Um einen Worktree zu entfernen, wenn Sie fertig sind, fahren Sie mit der Maus über die Sitzung in der Seitenleiste und klicken Sie auf das Archiv-Symbol. Um Sitzungen automatisch zu archivieren, wenn ihr Pull Request zusammengeführt oder geschlossen wird, schalten Sie **Auto-Archivieren nach PR-Merge oder -Schließung** in Einstellungen → Claude Code ein. Auto-Archivieren gilt nur für lokale Sitzungen, die beendet wurden.376Worktrees werden standardmäßig in `<project-root>/.claude/worktrees/` gespeichert. Sie können dies in Einstellungen → Claude Code unter 'Worktree-Speicherort" in ein benutzerdefiniertes Verzeichnis ändern. Sie können auch ein Branch-Präfix festlegen, das jedem Worktree-Branch-Namen vorangestellt wird, was nützlich ist, um von Claude erstellte Branches organisiert zu halten. Um einen Worktree zu entfernen, wenn Sie fertig sind, fahren Sie mit der Maus über die Sitzung in der Seitenleiste und klicken Sie auf das Archiv-Symbol. Um Sitzungen automatisch zu archivieren, wenn ihr Pull Request zusammengeführt oder geschlossen wird, schalten Sie **Auto-Archivieren nach PR-Merge oder -Schließung** in Einstellungen → Claude Code ein. Auto-Archivieren gilt nur für lokale Sitzungen, die beendet wurden.

377 377

378Um gitignorierte Dateien wie `.env` in neue Worktrees einzubeziehen, erstellen Sie eine [`.worktreeinclude`-Datei](/de/worktrees#copy-gitignored-files-into-worktrees) in Ihrem Projektstammverzeichnis.378Um gitignorierte Dateien wie `.env` in neue Worktrees einzubeziehen, erstellen Sie eine [`.worktreeinclude`-Datei](/docs/de/worktrees#copy-gitignored-files-into-worktrees) in Ihrem Projektstammverzeichnis.

379 379

380<Note>380<Note>

381 Die Sitzungsisolation erfordert [Git](https://git-scm.com/downloads). Die meisten Macs enthalten Git standardmäßig. Führen Sie `git --version` im Terminal aus, um zu überprüfen. Unter Windows ist Git erforderlich, damit die Registerkarte „Code" funktioniert: [Laden Sie Git für Windows herunter](https://git-scm.com/downloads/win), installieren Sie es und starten Sie die App neu. Wenn Sie auf Git-Fehler stoßen, bitten Sie Claude im [Cowork-Tab](https://claude.com/product/cowork), Ihnen bei der Behebung Ihres Setups zu helfen.381 Die Sitzungsisolation erfordert [Git](https://git-scm.com/downloads). Die meisten Macs enthalten Git standardmäßig. Führen Sie `git --version` im Terminal aus, um zu überprüfen. Unter Windows ist Git erforderlich, damit die Registerkarte „Code" funktioniert: [Laden Sie Git für Windows herunter](https://git-scm.com/downloads/win), installieren Sie es und starten Sie die App neu. Wenn Sie auf Git-Fehler stoßen, bitten Sie Claude im [Cowork-Tab](https://claude.com/product/cowork), Ihnen bei der Behebung Ihres Setups zu helfen.

382</Note>382</Note>

383 383

384Verwenden Sie die Steuerelemente oben in der Seitenleiste, um Sitzungen nach Status, Projekt oder Umgebung zu filtern, und um Sitzungen nach Projekt zu gruppieren. Um eine Sitzung umzubenennen, klicken Sie auf den Sitzungstitel in der Symbolleiste oben in der aktiven Sitzung. Um die Kontext-Nutzung zu überprüfen, siehe [Überprüfen Sie die Nutzung](#check-usage). Wenn der Kontext voll wird, fasst Claude das Gespräch automatisch zusammen und arbeitet weiter. Sie können auch `/compact` eingeben, um die Zusammenfassung früher auszulösen und Kontextraum freizugeben. Siehe [das Kontextfenster](/de/how-claude-code-works#the-context-window) für Details, wie die Komprimierung funktioniert.384Verwenden Sie die Steuerelemente oben in der Seitenleiste, um Sitzungen nach Status, Projekt oder Umgebung zu filtern, und um Sitzungen nach Projekt zu gruppieren. Um eine Sitzung umzubenennen, klicken Sie auf den Sitzungstitel in der Symbolleiste oben in der aktiven Sitzung. Um die Kontext-Nutzung zu überprüfen, siehe [Überprüfen Sie die Nutzung](#check-usage). Wenn der Kontext voll wird, fasst Claude das Gespräch automatisch zusammen und arbeitet weiter. Sie können auch `/compact` eingeben, um die Zusammenfassung früher auszulösen und Kontextraum freizugeben. Siehe [das Kontextfenster](/docs/de/how-claude-code-works#the-context-window) für Details, wie die Komprimierung funktioniert.

385 385

386Die Desktop-App sendet eine Betriebssystem-Benachrichtigung, wenn eine Code-Sitzung eine Aufgabe abschließt und Sie diese Sitzung gerade nicht anzeigen.386Die Desktop-App sendet eine Betriebssystem-Benachrichtigung, wenn eine Code-Sitzung eine Aufgabe abschließt und Sie diese Sitzung gerade nicht anzeigen.

387 387

397 Beobachten Sie Hintergrund-Aufgaben397 Beobachten Sie Hintergrund-Aufgaben

398</h3>398</h3>

399 399

400Das Aufgaben-Pane zeigt die Hintergrundarbeit, die in der aktuellen Sitzung läuft: Subagents, Hintergrund-Shell-Befehle und [dynamische Workflows](/de/workflows). Öffnen Sie es aus dem Menü **Ansichten** oder ziehen Sie es in Ihr Layout.400Das Aufgaben-Pane zeigt die Hintergrundarbeit, die in der aktuellen Sitzung läuft: Subagents, Hintergrund-Shell-Befehle und [dynamische Workflows](/docs/de/workflows). Öffnen Sie es aus dem Menü **Ansichten** oder ziehen Sie es in Ihr Layout.

401 401

402Klicken Sie auf einen beliebigen Eintrag, um seine Ausgabe im Subagent-Pane zu sehen oder ihn zu stoppen. Um zu sehen, was andere Sitzungen tun, verwenden Sie die [Seitenleiste](#work-in-parallel-with-sessions).402Klicken Sie auf einen beliebigen Eintrag, um seine Ausgabe im Subagent-Pane zu sehen oder ihn zu stoppen. Um zu sehen, was andere Sitzungen tun, verwenden Sie die [Seitenleiste](#work-in-parallel-with-sessions).

403 403

409 409

410Cloud-Sitzungen unterstützen auch mehrere Repositories. Nach Auswahl einer Cloud-Umgebung klicken Sie auf die Schaltfläche **+** neben dem Repo-Pill, um zusätzliche Repositories zur Sitzung hinzuzufügen. Jedes Repo erhält seinen eigenen Branch-Wahlschalter. Dies ist nützlich für Aufgaben, die mehrere Codebases umfassen, z. B. das Aktualisieren einer gemeinsamen Bibliothek und ihrer Consumer.410Cloud-Sitzungen unterstützen auch mehrere Repositories. Nach Auswahl einer Cloud-Umgebung klicken Sie auf die Schaltfläche **+** neben dem Repo-Pill, um zusätzliche Repositories zur Sitzung hinzuzufügen. Jedes Repo erhält seinen eigenen Branch-Wahlschalter. Dies ist nützlich für Aufgaben, die mehrere Codebases umfassen, z. B. das Aktualisieren einer gemeinsamen Bibliothek und ihrer Consumer.

411 411

412Siehe [Claude Code im Web](/de/claude-code-on-the-web) für mehr darüber, wie Cloud-Sitzungen funktionieren.412Siehe [Claude Code im Web](/docs/de/claude-code-on-the-web) für mehr darüber, wie Cloud-Sitzungen funktionieren.

413 413

414<h3 id="continue-in-another-surface">414<h3 id="continue-in-another-surface">

415 Fortsetzen auf einer anderen Oberfläche415 Fortsetzen auf einer anderen Oberfläche

434 434

435Für Setup, Pairing und Dispatch-Einstellungen siehe den [Dispatch-Hilfeartikel](https://support.claude.com/en/articles/13947068). Dispatch erfordert einen Pro- oder Max-Plan und ist nicht für Team- oder Enterprise-Pläne verfügbar.435Für Setup, Pairing und Dispatch-Einstellungen siehe den [Dispatch-Hilfeartikel](https://support.claude.com/en/articles/13947068). Dispatch erfordert einen Pro- oder Max-Plan und ist nicht für Team- oder Enterprise-Pläne verfügbar.

436 436

437Dispatch ist eine von mehreren Möglichkeiten, mit Claude zu arbeiten, wenn Sie weg von Ihrem Terminal sind. Siehe [Plattformen und Integrationen](/de/platforms#work-when-you-are-away-from-your-terminal), um es mit Remote Control, Channels, Slack und geplanten Aufgaben zu vergleichen.437Dispatch ist eine von mehreren Möglichkeiten, mit Claude zu arbeiten, wenn Sie weg von Ihrem Terminal sind. Siehe [Plattformen und Integrationen](/docs/de/platforms#work-when-you-are-away-from-your-terminal), um es mit Remote Control, Channels, Slack und geplanten Aufgaben zu vergleichen.

438 438

439<h2 id="extend-claude-code">439<h2 id="extend-claude-code">

440 Erweitern Sie Claude Code440 Erweitern Sie Claude Code

446 Verbinden Sie externe Tools446 Verbinden Sie externe Tools

447</h3>447</h3>

448 448

449Für lokale und [SSH](#ssh-sessions)-Sitzungen klicken Sie auf die Schaltfläche **+** neben dem Eingabefeld und wählen Sie **Konnektoren**, um Integrationen wie Google Calendar, Slack, GitHub, Linear, Notion und mehr hinzuzufügen. Sie können Konnektoren vor oder während einer Sitzung hinzufügen. Die Schaltfläche **+** ist nicht in Cloud-Sitzungen verfügbar, aber [Routinen](/de/routines) konfigurieren Konnektoren zum Zeitpunkt der Routine-Erstellung.449Für lokale und [SSH](#ssh-sessions)-Sitzungen klicken Sie auf die Schaltfläche **+** neben dem Eingabefeld und wählen Sie **Konnektoren**, um Integrationen wie Google Calendar, Slack, GitHub, Linear, Notion und mehr hinzuzufügen. Sie können Konnektoren vor oder während einer Sitzung hinzufügen. Die Schaltfläche **+** ist nicht in Cloud-Sitzungen verfügbar, aber [Routinen](/docs/de/routines) konfigurieren Konnektoren zum Zeitpunkt der Routine-Erstellung.

450 450

451Um Konnektoren zu verwalten oder zu trennen, gehen Sie zu Einstellungen → Konnektoren in der Desktop-App oder wählen Sie **Konnektoren verwalten** aus dem Konnektoren-Menü im Eingabefeld.451Um Konnektoren zu verwalten oder zu trennen, gehen Sie zu Einstellungen → Konnektoren in der Desktop-App oder wählen Sie **Konnektoren verwalten** aus dem Konnektoren-Menü im Eingabefeld.

452 452

453Nach der Verbindung kann Claude Ihren Kalender lesen, Nachrichten senden, Probleme erstellen und direkt mit Ihren Tools interagieren. Sie können Claude fragen, welche Konnektoren in Ihrer Sitzung konfiguriert sind.453Nach der Verbindung kann Claude Ihren Kalender lesen, Nachrichten senden, Probleme erstellen und direkt mit Ihren Tools interagieren. Sie können Claude fragen, welche Konnektoren in Ihrer Sitzung konfiguriert sind.

454 454

455Konnektoren sind [MCP-Server](/de/mcp) mit einem grafischen Setup-Ablauf. Verwenden Sie sie für schnelle Integration mit unterstützten Diensten. Für Integrationen, die nicht in Konnektoren aufgelistet sind, fügen Sie MCP-Server manuell über [Einstellungsdateien](/de/mcp#installing-mcp-servers) hinzu. Sie können auch [benutzerdefinierte Konnektoren erstellen](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).455Konnektoren sind [MCP-Server](/docs/de/mcp) mit einem grafischen Setup-Ablauf. Verwenden Sie sie für schnelle Integration mit unterstützten Diensten. Für Integrationen, die nicht in Konnektoren aufgelistet sind, fügen Sie MCP-Server manuell über [Einstellungsdateien](/docs/de/mcp#installing-mcp-servers) hinzu. Sie können auch [benutzerdefinierte Konnektoren erstellen](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).

456 456

457<h3 id="use-skills">457<h3 id="use-skills">

458 Verwenden Sie Skills458 Verwenden Sie Skills

459</h3>459</h3>

460 460

461[Skills](/de/skills) erweitern, was Claude tun kann. Claude lädt sie automatisch, wenn relevant, oder Sie können eine direkt aufrufen: Geben Sie `/` im Eingabefeld ein oder klicken Sie auf die Schaltfläche **+** und wählen Sie **Slash-Befehle**, um zu sehen, was verfügbar ist. Dies umfasst [integrierte Befehle](/de/commands), Ihre [benutzerdefinierten Skills](/de/skills#create-your-first-skill), Projekt-Skills aus Ihrer Codebasis und Skills aus allen [installierten Plugins](/de/plugins). Wählen Sie einen aus und er wird im Eingabefeld hervorgehoben angezeigt. Geben Sie Ihre Aufgabe danach ein und senden Sie wie gewohnt.461[Skills](/docs/de/skills) erweitern, was Claude tun kann. Claude lädt sie automatisch, wenn relevant, oder Sie können eine direkt aufrufen: Geben Sie `/` im Eingabefeld ein oder klicken Sie auf die Schaltfläche **+** und wählen Sie **Slash-Befehle**, um zu sehen, was verfügbar ist. Dies umfasst [integrierte Befehle](/docs/de/commands), Ihre [benutzerdefinierten Skills](/docs/de/skills#create-your-first-skill), Projekt-Skills aus Ihrer Codebasis und Skills aus allen [installierten Plugins](/docs/de/plugins). Wählen Sie einen aus und er wird im Eingabefeld hervorgehoben angezeigt. Geben Sie Ihre Aufgabe danach ein und senden Sie wie gewohnt.

462 462

463Sie können einen Befehl senden, während Claude arbeitet, genauso wie jede andere Nachricht, und die Sitzung kehrt zum Leerlauf zurück, sobald der Zug beendet ist. Vor v2.1.206 konnte ein Befehl, der während eines Zuges gesendet wurde, dazu führen, dass die Sitzung weiterhin als laufend angezeigt wurde und Nachrichten, die Sie danach sendeten, nicht zugestellt wurden.463Sie können einen Befehl senden, während Claude arbeitet, genauso wie jede andere Nachricht, und die Sitzung kehrt zum Leerlauf zurück, sobald der Zug beendet ist. Vor v2.1.206 konnte ein Befehl, der während eines Zuges gesendet wurde, dazu führen, dass die Sitzung weiterhin als laufend angezeigt wurde und Nachrichten, die Sie danach sendeten, nicht zugestellt wurden.

464 464

466 Installieren Sie Plugins466 Installieren Sie Plugins

467</h3>467</h3>

468 468

469[Plugins](/de/plugins) sind wiederverwendbare Pakete, die Skills, Agents, hooks, MCP-Server und LSP-Konfigurationen zu Claude Code hinzufügen. Sie können Plugins aus der Desktop-App installieren, ohne das Terminal zu verwenden.469[Plugins](/docs/de/plugins) sind wiederverwendbare Pakete, die Skills, Agents, hooks, MCP-Server und LSP-Konfigurationen zu Claude Code hinzufügen. Sie können Plugins aus der Desktop-App installieren, ohne das Terminal zu verwenden.

470 470

471Für lokale und [SSH](#ssh-sessions)-Sitzungen klicken Sie auf die Schaltfläche **+** neben dem Eingabefeld und wählen Sie **Plugins**, um Ihre installierten Plugins und deren Skills zu sehen. Um ein Plugin hinzuzufügen, wählen Sie **Plugin hinzufügen** aus dem Untermenü, um den Plugin-Browser zu öffnen, der verfügbare Plugins aus Ihren konfigurierten [Marketplaces](/de/plugin-marketplaces) einschließlich des offiziellen Anthropic-Marketplace anzeigt. Wählen Sie **Plugins verwalten**, um Plugins zu aktivieren, zu deaktivieren oder zu deinstallieren.471Für lokale und [SSH](#ssh-sessions)-Sitzungen klicken Sie auf die Schaltfläche **+** neben dem Eingabefeld und wählen Sie **Plugins**, um Ihre installierten Plugins und deren Skills zu sehen. Um ein Plugin hinzuzufügen, wählen Sie **Plugin hinzufügen** aus dem Untermenü, um den Plugin-Browser zu öffnen, der verfügbare Plugins aus Ihren konfigurierten [Marketplaces](/docs/de/plugin-marketplaces) einschließlich des offiziellen Anthropic-Marketplace anzeigt. Wählen Sie **Plugins verwalten**, um Plugins zu aktivieren, zu deaktivieren oder zu deinstallieren.

472 472

473Plugins können auf Ihr Benutzerkonto, ein bestimmtes Projekt oder nur lokal beschränkt sein. Wenn Ihre Organisation Plugins zentral verwaltet, sind diese Plugins in Desktop-Sitzungen auf die gleiche Weise verfügbar wie in der CLI. Plugins sind nicht für Cloud-Sitzungen verfügbar. Für die vollständige Plugin-Referenz einschließlich der Erstellung eigener Plugins siehe [Plugins](/de/plugins).473Plugins können auf Ihr Benutzerkonto, ein bestimmtes Projekt oder nur lokal beschränkt sein. Wenn Ihre Organisation Plugins zentral verwaltet, sind diese Plugins in Desktop-Sitzungen auf die gleiche Weise verfügbar wie in der CLI. Plugins sind nicht für Cloud-Sitzungen verfügbar. Für die vollständige Plugin-Referenz einschließlich der Erstellung eigener Plugins siehe [Plugins](/docs/de/plugins).

474 474

475<h3 id="configure-preview-servers">475<h3 id="configure-preview-servers">

476 Konfigurieren Sie Vorschau-Server476 Konfigurieren Sie Vorschau-Server

636* **Lokal**: läuft auf Ihrem Computer mit direktem Zugriff auf Ihre Dateien636* **Lokal**: läuft auf Ihrem Computer mit direktem Zugriff auf Ihre Dateien

637* **Remote**: läuft auf Anthropics Cloud-Infrastruktur. Sitzungen werden fortgesetzt, auch wenn Sie die App schließen.637* **Remote**: läuft auf Anthropics Cloud-Infrastruktur. Sitzungen werden fortgesetzt, auch wenn Sie die App schließen.

638* **SSH**: läuft auf einem Remote-Computer, mit dem Sie sich über SSH verbinden, z. B. Ihre eigenen Server, Cloud-VMs oder Dev-Container638* **SSH**: läuft auf einem Remote-Computer, mit dem Sie sich über SSH verbinden, z. B. Ihre eigenen Server, Cloud-VMs oder Dev-Container

639* **WSL** (Windows): läuft in einer [WSL 2-Distribution](/de/desktop-wsl) auf Ihrem Computer und verwendet deren Linux-Toolchain und native Pfade639* **WSL** (Windows): läuft in einer [WSL 2-Distribution](/docs/de/desktop-wsl) auf Ihrem Computer und verwendet deren Linux-Toolchain und native Pfade

640 640

641<h3 id="local-sessions">641<h3 id="local-sessions">

642 Lokale Sitzungen642 Lokale Sitzungen

644 644

645Die Desktop-App erbt nicht immer Ihre vollständige Shell-Umgebung. Auf macOS liest die App beim Starten aus dem Dock oder Finder Ihr Shell-Profil, z. B. `~/.zshrc` oder `~/.bashrc`, um `PATH` und einen festen Satz von Claude Code-Variablen zu extrahieren, aber andere Variablen, die Sie dort exportieren, werden nicht übernommen. Unter Windows erbt die App Benutzer- und Systemumgebungsvariablen, liest aber keine PowerShell-Profile.645Die Desktop-App erbt nicht immer Ihre vollständige Shell-Umgebung. Auf macOS liest die App beim Starten aus dem Dock oder Finder Ihr Shell-Profil, z. B. `~/.zshrc` oder `~/.bashrc`, um `PATH` und einen festen Satz von Claude Code-Variablen zu extrahieren, aber andere Variablen, die Sie dort exportieren, werden nicht übernommen. Unter Windows erbt die App Benutzer- und Systemumgebungsvariablen, liest aber keine PowerShell-Profile.

646 646

647Um Umgebungsvariablen für lokale Sitzungen und Dev-Server auf jeder Plattform festzulegen, öffnen Sie das Umgebungs-Dropdown im Eingabefeld, fahren Sie mit der Maus über **Lokal** und klicken Sie auf das Zahnrad-Symbol, um den lokalen Umgebungs-Editor zu öffnen. Variablen, die Sie hier speichern, werden verschlüsselt auf Ihrem Computer gespeichert und gelten für jede lokale Sitzung und jeden Vorschau-Server, den Sie starten. Sie können auch Variablen zum Schlüssel `env` in Ihrer Datei `~/.claude/settings.json` hinzufügen, obwohl diese nur Claude-Sitzungen erreichen und nicht Dev-Server. Siehe [Umgebungsvariablen](/de/env-vars) für die vollständige Liste der unterstützten Variablen.647Um Umgebungsvariablen für lokale Sitzungen und Dev-Server auf jeder Plattform festzulegen, öffnen Sie das Umgebungs-Dropdown im Eingabefeld, fahren Sie mit der Maus über **Lokal** und klicken Sie auf das Zahnrad-Symbol, um den lokalen Umgebungs-Editor zu öffnen. Variablen, die Sie hier speichern, werden verschlüsselt auf Ihrem Computer gespeichert und gelten für jede lokale Sitzung und jeden Vorschau-Server, den Sie starten. Sie können auch Variablen zum Schlüssel `env` in Ihrer Datei `~/.claude/settings.json` hinzufügen, obwohl diese nur Claude-Sitzungen erreichen und nicht Dev-Server. Siehe [Umgebungsvariablen](/docs/de/env-vars) für die vollständige Liste der unterstützten Variablen.

648 648

649[Erweitertes Denken](/de/model-config#extended-thinking) ist standardmäßig aktiviert, was die Leistung bei komplexen Denkaufgaben verbessert, aber zusätzliche Token verwendet. Um das Denken zu deaktivieren, setzen Sie `MAX_THINKING_TOKENS` auf `0` im lokalen Umgebungs-Editor; dies hat keine Auswirkung auf Fable 5, das immer erweitertes Denken verwendet. Bei [Drittanbieter-Providern](/de/third-party-integrations) wird stattdessen der Parameter `thinking` weggelassen, und Adaptive-Reasoning-Modelle können dennoch denken. Bei Modellen mit [adaptiver Argumentation](/de/model-config#adjust-effort-level) wird jeder andere `MAX_THINKING_TOKENS`-Wert ignoriert, da adaptive Argumentation die Denktiefe steuert. Bei Opus 4.6 und Sonnet 4.6 setzen Sie `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` auf `1`, um ein festes Denk-Budget zu verwenden; Fable 5, Sonnet 5 und Opus 4.7 und später verwenden immer adaptive Argumentation und haben keinen Modus mit festem Budget.649[Erweitertes Denken](/docs/de/model-config#extended-thinking) ist standardmäßig aktiviert, was die Leistung bei komplexen Denkaufgaben verbessert, aber zusätzliche Token verwendet. Um das Denken zu deaktivieren, setzen Sie `MAX_THINKING_TOKENS` auf `0` im lokalen Umgebungs-Editor; dies hat keine Auswirkung auf Fable 5, das immer erweitertes Denken verwendet. Bei [Drittanbieter-Providern](/docs/de/third-party-integrations) wird stattdessen der Parameter `thinking` weggelassen, und Adaptive-Reasoning-Modelle können dennoch denken. Bei Modellen mit [adaptiver Argumentation](/docs/de/model-config#adjust-effort-level) wird jeder andere `MAX_THINKING_TOKENS`-Wert ignoriert, da adaptive Argumentation die Denktiefe steuert. Bei Opus 4.6 und Sonnet 4.6 setzen Sie `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` auf `1`, um ein festes Denk-Budget zu verwenden; Fable 5, Sonnet 5 und Opus 4.7 und später verwenden immer adaptive Argumentation und haben keinen Modus mit festem Budget.

650 650

651<h3 id="cloud-sessions">651<h3 id="cloud-sessions">

652 Remote-Sitzungen652 Remote-Sitzungen

653</h3>653</h3>

654 654

655Remote-Sitzungen werden im Hintergrund fortgesetzt, auch wenn Sie die App schließen. Die Nutzung wird auf Ihre [Abonnementplanlimits](/de/costs) angerechnet, ohne separate Compute-Gebühren.655Remote-Sitzungen werden im Hintergrund fortgesetzt, auch wenn Sie die App schließen. Die Nutzung wird auf Ihre [Abonnementplanlimits](/docs/de/costs) angerechnet, ohne separate Compute-Gebühren.

656 656

657Sie können benutzerdefinierte Cloud-Umgebungen mit verschiedenen Netzwerkzugriffsstufen und Umgebungsvariablen erstellen. Wählen Sie das Umgebungs-Dropdown beim Starten einer Cloud-Sitzung und wählen Sie **Umgebung hinzufügen**. Siehe [die Cloud-Umgebung](/de/claude-code-on-the-web#the-cloud-environment) für Details zur Konfiguration von Netzwerkzugriff und Umgebungsvariablen.657Sie können benutzerdefinierte Cloud-Umgebungen mit verschiedenen Netzwerkzugriffsstufen und Umgebungsvariablen erstellen. Wählen Sie das Umgebungs-Dropdown beim Starten einer Cloud-Sitzung und wählen Sie **Umgebung hinzufügen**. Siehe [die Cloud-Umgebung](/docs/de/claude-code-on-the-web#the-cloud-environment) für Details zur Konfiguration von Netzwerkzugriff und Umgebungsvariablen.

658 658

659<h3 id="ssh-sessions">659<h3 id="ssh-sessions">

660 SSH-Sitzungen660 SSH-Sitzungen

677 SSH-Verbindungen für Ihr Team vorkonfigurieren677 SSH-Verbindungen für Ihr Team vorkonfigurieren

678</h4>678</h4>

679 679

680Administratoren können SSH-Verbindungen an Teammitglieder verteilen, indem sie `sshConfigs` zu einer [verwalteten Einstellungsdatei](/de/settings#settings-precedence) hinzufügen. Auf diese Weise definierte Verbindungen werden in der Umgebungs-Dropdown-Liste jedes Benutzers automatisch angezeigt und sind als verwaltet gekennzeichnet, sodass Benutzer sie auswählen, aber nicht bearbeiten oder löschen können.680Administratoren können SSH-Verbindungen an Teammitglieder verteilen, indem sie `sshConfigs` zu einer [verwalteten Einstellungsdatei](/docs/de/settings#settings-precedence) hinzufügen. Auf diese Weise definierte Verbindungen werden in der Umgebungs-Dropdown-Liste jedes Benutzers automatisch angezeigt und sind als verwaltet gekennzeichnet, sodass Benutzer sie auswählen, aber nicht bearbeiten oder löschen können.

681 681

682Das folgende Beispiel konfiguriert eine einzelne Verbindung vor, die sich in `~/projects` auf dem Remote-Host öffnet:682Das folgende Beispiel konfiguriert eine einzelne Verbindung vor, die sich in `~/projects` auf dem Remote-Host öffnet:

683 683

702 SSH-Hosts einschränken, mit denen Benutzer sich verbinden können702 SSH-Hosts einschränken, mit denen Benutzer sich verbinden können

703</h4>703</h4>

704 704

705Administratoren können Desktop-SSH-Sitzungen auf einen genehmigten Satz von Hosts beschränken, indem sie `sshHostAllowlist` zu einer [verwalteten Einstellungsdatei](/de/settings#settings-precedence) hinzufügen. Wenn diese festgelegt ist, können Benutzer sich nur mit Hosts verbinden, deren aufgelöster Hostname einem der Muster entspricht. Setzen Sie es auf ein leeres Array, um SSH-Sitzungen vollständig zu deaktivieren.705Administratoren können Desktop-SSH-Sitzungen auf einen genehmigten Satz von Hosts beschränken, indem sie `sshHostAllowlist` zu einer [verwalteten Einstellungsdatei](/docs/de/settings#settings-precedence) hinzufügen. Wenn diese festgelegt ist, können Benutzer sich nur mit Hosts verbinden, deren aufgelöster Hostname einem der Muster entspricht. Setzen Sie es auf ein leeres Array, um SSH-Sitzungen vollständig zu deaktivieren.

706 706

707Das folgende Beispiel erlaubt Verbindungen zu jedem Host unter `devboxes.example.com` und zu einem einzelnen benannten Bastion-Host:707Das folgende Beispiel erlaubt Verbindungen zu jedem Host unter `devboxes.example.com` und zu einem einzelnen benannten Bastion-Host:

708 708

729Diese Einstellungen werden über die [Admin-Einstellungskonsole](https://claude.ai/admin-settings/claude-code) konfiguriert:729Diese Einstellungen werden über die [Admin-Einstellungskonsole](https://claude.ai/admin-settings/claude-code) konfiguriert:

730 730

731* **Code in der Desktop**: Kontrollieren Sie, ob Benutzer in Ihrer Organisation auf Claude Code in der Desktop-App zugreifen können731* **Code in der Desktop**: Kontrollieren Sie, ob Benutzer in Ihrer Organisation auf Claude Code in der Desktop-App zugreifen können

732* **Code im Web**: Aktivieren oder deaktivieren Sie [Web-Sitzungen](/de/claude-code-on-the-web) für Ihre Organisation732* **Code im Web**: Aktivieren oder deaktivieren Sie [Web-Sitzungen](/docs/de/claude-code-on-the-web) für Ihre Organisation

733* **Remote Control**: Aktivieren oder deaktivieren Sie [Remote Control](/de/remote-control) für Ihre Organisation733* **Remote Control**: Aktivieren oder deaktivieren Sie [Remote Control](/docs/de/remote-control) für Ihre Organisation

734* **Bypass-Berechtigungsmodus deaktivieren**: Verhindern Sie, dass Benutzer in Ihrer Organisation den Bypass-Berechtigungsmodus aktivieren734* **Bypass-Berechtigungsmodus deaktivieren**: Verhindern Sie, dass Benutzer in Ihrer Organisation den Bypass-Berechtigungsmodus aktivieren

735 735

736<h3 id="managed-settings">736<h3 id="managed-settings">

737 Verwaltete Einstellungen737 Verwaltete Einstellungen

738</h3>738</h3>

739 739

740Verwaltete Einstellungen überschreiben Projekt- und Benutzereinstellungen und gelten für Claude-Code-Sitzungen in Desktop. Sie können diese Schlüssel in der [verwalteten Einstellungsdatei](/de/settings#settings-precedence) Ihrer Organisation oder remote über die Admin-Konsole festlegen.740Verwaltete Einstellungen überschreiben Projekt- und Benutzereinstellungen und gelten für Claude-Code-Sitzungen in Desktop. Sie können diese Schlüssel in der [verwalteten Einstellungsdatei](/docs/de/settings#settings-precedence) Ihrer Organisation oder remote über die Admin-Konsole festlegen.

741 741

743| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |743| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

744| `permissions.disableBypassPermissionsMode` | auf `"disable"` setzen, um Benutzer daran zu hindern, den Bypass-Berechtigungsmodus zu aktivieren. |744| `permissions.disableBypassPermissionsMode` | auf `"disable"` setzen, um Benutzer daran zu hindern, den Bypass-Berechtigungsmodus zu aktivieren. |

745| `disableAutoMode` | auf `"disable"` setzen, um Benutzer daran zu hindern, den [Auto](/de/permission-modes#eliminate-prompts-with-auto-mode)-Modus zu aktivieren. Entfernt Auto aus dem Moduswahlschalter. Auch unter `permissions` akzeptiert. |745| `disableAutoMode` | auf `"disable"` setzen, um Benutzer daran zu hindern, den [Auto](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)-Modus zu aktivieren. Entfernt Auto aus dem Moduswahlschalter. Auch unter `permissions` akzeptiert. |

746| `autoMode` | passen Sie an, was der Auto-Modus-Klassifizierer über Ihre Organisation vertraut und blockiert. Siehe [Auto-Modus konfigurieren](/de/auto-mode-config). |746| `autoMode` | passen Sie an, was der Auto-Modus-Klassifizierer über Ihre Organisation vertraut und blockiert. Siehe [Auto-Modus konfigurieren](/docs/de/auto-mode-config). |

747| `browserExternalPageTools` | auf `"disabled"` setzen, um zu verhindern, dass Claude Tools verwendet, um externe Seiten im [Browser-Bereich](#browse-external-sites) zu lesen oder zu bearbeiten. Benutzer können externe Websites weiterhin selbst navigieren, und lokale Dev-Server-Vorschauen sind nicht betroffen. |747| `browserExternalPageTools` | auf `"disabled"` setzen, um zu verhindern, dass Claude Tools verwendet, um externe Seiten im [Browser-Bereich](#browse-external-sites) zu lesen oder zu bearbeiten. Benutzer können externe Websites weiterhin selbst navigieren, und lokale Dev-Server-Vorschauen sind nicht betroffen. |

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

749| `sshConfigs` | vorkonfigurieren Sie [SSH-Verbindungen](#pre-configure-ssh-connections-for-your-team), die in der Umgebungs-Dropdown angezeigt werden. Benutzer können verwaltete Verbindungen nicht bearbeiten oder löschen. |749| `sshConfigs` | vorkonfigurieren Sie [SSH-Verbindungen](#pre-configure-ssh-connections-for-your-team), die in der Umgebungs-Dropdown angezeigt werden. Benutzer können verwaltete Verbindungen nicht bearbeiten oder löschen. |

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

751| `managedMcpServers` | übertragen Sie MCP-Serverkonfigurationen an alle Benutzer in einer Drittanbieter-Bereitstellung. Jeder Eintrag gibt einen Transport von `"http"`, `"sse"` oder `"stdio"`, Verbindungsdetails und optional eine `toolPolicy`-Zuordnung an, die einschränkt, welche Tools in diesem Server Benutzer aufrufen können. Nur in Drittanbieter-Desktop-Bereitstellungen (3P) verfügbar. Stellen Sie diesen Schlüssel über die verwaltete Einstellungsdatei oder MDM bereit, da Drittanbieter-Bereitstellungen keine Admin-Konsolen-Einstellungen erhalten. |751| `managedMcpServers` | übertragen Sie MCP-Serverkonfigurationen an alle Benutzer in einer Drittanbieter-Bereitstellung. Jeder Eintrag gibt einen Transport von `"http"`, `"sse"` oder `"stdio"`, Verbindungsdetails und optional eine `toolPolicy`-Zuordnung an, die einschränkt, welche Tools in diesem Server Benutzer aufrufen können. Nur in Drittanbieter-Desktop-Bereitstellungen (3P) verfügbar. Stellen Sie diesen Schlüssel über die verwaltete Einstellungsdatei oder MDM bereit, da Drittanbieter-Bereitstellungen keine Admin-Konsolen-Einstellungen erhalten. |

752 752

753Welche verwalteten Einstellungen eine Desktop-Sitzung erreichen, hängt davon ab, wo diese Sitzung ausgeführt wird. Modellbeschränkungen wie [`availableModels`](/de/model-config#restrict-model-selection) werden in Desktop-Claude-Code-Sitzungen auf die gleiche Weise durchgesetzt wie in der Terminal-CLI; siehe [Oberflächenabdeckung](/de/model-config#surface-coverage).753Welche verwalteten Einstellungen eine Desktop-Sitzung erreichen, hängt davon ab, wo diese Sitzung ausgeführt wird. Modellbeschränkungen wie [`availableModels`](/docs/de/model-config#restrict-model-selection) werden in Desktop-Claude-Code-Sitzungen auf die gleiche Weise durchgesetzt wie in der Terminal-CLI; siehe [Oberflächenabdeckung](/docs/de/model-config#surface-coverage).

754 754

755* **Lokale Sitzungen auf diesem Computer**: Eine verwaltete Einstellungsdatei, die auf der Festplatte bereitgestellt wird, gilt. Verwaltete Einstellungen, die remote über die Admin-Konsole hochgeladen werden, erreichen diese Sitzungen auch auf Anthropics API, wenn sich die Sitzung mit einer Organisationsanmeldung oder einem direkt konfigurierten API-Schlüssel authentifiziert, und folgen dabei der gleichen [Einstellungspriorität](/de/settings#settings-precedence) wie die Terminal-CLI.755* **Lokale Sitzungen auf diesem Computer**: Eine verwaltete Einstellungsdatei, die auf der Festplatte bereitgestellt wird, gilt. Verwaltete Einstellungen, die remote über die Admin-Konsole hochgeladen werden, erreichen diese Sitzungen auch auf Anthropics API, wenn sich die Sitzung mit einer Organisationsanmeldung oder einem direkt konfigurierten API-Schlüssel authentifiziert, und folgen dabei der gleichen [Einstellungspriorität](/docs/de/settings#settings-precedence) wie die Terminal-CLI.

756* **[Cloud-Sitzungen](#cloud-sessions)**: Werden auf von Anthropic verwalteten VMs ausgeführt und erhalten nur [Server-verwaltete Einstellungen](/de/server-managed-settings).756* **[Cloud-Sitzungen](#cloud-sessions)**: Werden auf von Anthropic verwalteten VMs ausgeführt und erhalten nur [Server-verwaltete Einstellungen](/docs/de/server-managed-settings).

757* **[SSH-Sitzungen](#ssh-sessions)**: Die Sitzung liest die verwaltete Einstellungsdatei vom Remote-Host. Desktop selbst liest `sshConfigs` und `sshHostAllowlist` aus den verwalteten Einstellungen des lokalen Computers beim Erstellen der Verbindung.757* **[SSH-Sitzungen](#ssh-sessions)**: Die Sitzung liest die verwaltete Einstellungsdatei vom Remote-Host. Desktop selbst liest `sshConfigs` und `sshHostAllowlist` aus den verwalteten Einstellungen des lokalen Computers beim Erstellen der Verbindung.

758 758

759`permissions.disableBypassPermissionsMode` und `disableAutoMode` funktionieren auch in Benutzer- und Projekteinstellungen, aber das Platzieren in verwalteten Einstellungen verhindert, dass Benutzer sie überschreiben.759`permissions.disableBypassPermissionsMode` und `disableAutoMode` funktionieren auch in Benutzer- und Projekteinstellungen, aber das Platzieren in verwalteten Einstellungen verhindert, dass Benutzer sie überschreiben.

760 760

761{/* min-version: 2.1.207 */}Claude Code liest `autoMode` aus Benutzereinstellungen, dem `--settings`-Flag und verwalteten Einstellungen, aber nicht aus `.claude/settings.json` oder `.claude/settings.local.json`: beide Dateien befinden sich im Repo-Verzeichnis, daher kann ein geklontes Repo oder Build-Schritt seine eigenen Klassifiziererregeln nicht injizieren. Vor v2.1.207 las Claude Code auch `.claude/settings.local.json`.761Claude Code liest `autoMode` aus Benutzereinstellungen, dem `--settings`-Flag und verwalteten Einstellungen, aber nicht aus `.claude/settings.json` oder `.claude/settings.local.json`: beide Dateien befinden sich im Repo-Verzeichnis, daher kann ein geklontes Repo oder Build-Schritt seine eigenen Klassifiziererregeln nicht injizieren. Vor v2.1.207 las Claude Code auch `.claude/settings.local.json`.

762 762

763Für die vollständige Liste der verwalteten Einstellungen einschließlich `allowManagedPermissionRulesOnly` und `allowManagedHooksOnly` siehe [verwaltete Einstellungen](/de/permissions#managed-only-settings).763Für die vollständige Liste der verwalteten Einstellungen einschließlich `allowManagedPermissionRulesOnly` und `allowManagedHooksOnly` siehe [verwaltete Einstellungen](/docs/de/permissions#managed-only-settings).

764 764

765<h3 id="device-management-policies">765<h3 id="device-management-policies">

766 Geräteverwaltungsrichtlinien766 Geräteverwaltungsrichtlinien

790*.claudemcpcontent.com790*.claudemcpcontent.com

791```791```

792 792

793Der Datenverkehr erfolgt über HTTPS auf Port 443, es sei denn, Sie konfigurieren einen benutzerdefinierten Port für [OTLP](/de/monitoring-usage), ein LLM-Gateway oder einen MCP-Server.793Der Datenverkehr erfolgt über HTTPS auf Port 443, es sei denn, Sie konfigurieren einen benutzerdefinierten Port für [OTLP](/docs/de/monitoring-usage), ein LLM-Gateway oder einen MCP-Server.

794 794

795Für Proxy-Server, benutzerdefinierte Zertifizierungsstellen, mTLS und die Domänen, die die eigenständige CLI benötigt, siehe [Netzwerkkonfiguration](/de/network-config).795Für Proxy-Server, benutzerdefinierte Zertifizierungsstellen, mTLS und die Domänen, die die eigenständige CLI benötigt, siehe [Netzwerkkonfiguration](/docs/de/network-config).

796 796

797Um die Anzahl der Firewall-Wildcards zu reduzieren, erlauben Sie stattdessen diese Anthropic-Hosts. Bestimmte Subdomänen werden dynamisch generiert und müssen Wildcards bleiben.797Um die Anzahl der Firewall-Wildcards zu reduzieren, erlauben Sie stattdessen diese Anthropic-Hosts. Bestimmte Subdomänen werden dynamisch generiert und müssen Wildcards bleiben.

798 798

820 Authentifizierung und SSO820 Authentifizierung und SSO

821</h3>821</h3>

822 822

823Enterprise-Organisationen können SSO für alle Benutzer verlangen. Siehe [Authentifizierung](/de/authentication) für Plan-Level-Details und [Einrichten von SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) für SAML-Konfiguration; OIDC-Setup wird im [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide) behandelt.823Enterprise-Organisationen können SSO für alle Benutzer verlangen. Siehe [Authentifizierung](/docs/de/authentication) für Plan-Level-Details und [Einrichten von SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) für SAML-Konfiguration; OIDC-Setup wird im [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide) behandelt.

824 824

825<h3 id="data-handling">825<h3 id="data-handling">

826 Datenbehandlung826 Datenbehandlung

827</h3>827</h3>

828 828

829Claude Code verarbeitet Ihren Code lokal in lokalen Sitzungen oder auf Anthropics Cloud-Infrastruktur in Cloud-Sitzungen. Gespräche und Code-Kontext werden an Anthropics API zur Verarbeitung gesendet. Siehe [Datenbehandlung](/de/data-usage) für Details zu Datenspeicherung, Datenschutz und Compliance.829Claude Code verarbeitet Ihren Code lokal in lokalen Sitzungen oder auf Anthropics Cloud-Infrastruktur in Cloud-Sitzungen. Gespräche und Code-Kontext werden an Anthropics API zur Verarbeitung gesendet. Siehe [Datenbehandlung](/docs/de/data-usage) für Details zu Datenspeicherung, Datenschutz und Compliance.

830 830

831<h3 id="deployment">831<h3 id="deployment">

832 Bereitstellung832 Bereitstellung

837* **macOS**: Verteilen Sie über MDM wie Jamf oder Kandji mit dem `.dmg`-Installer837* **macOS**: Verteilen Sie über MDM wie Jamf oder Kandji mit dem `.dmg`-Installer

838* **Windows**: Stellen Sie über das MSIX-Paket bereit. Siehe [Claude Desktop für Windows bereitstellen](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) für Enterprise-Bereitstellungsoptionen einschließlich stiller Installation838* **Windows**: Stellen Sie über das MSIX-Paket bereit. Siehe [Claude Desktop für Windows bereitstellen](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) für Enterprise-Bereitstellungsoptionen einschließlich stiller Installation

839 839

840Für die Domänen, die Sie in Ihrer Firewall auf die Allowlist setzen müssen, siehe [Netzwerkzugriffsanforderungen](#network-access-requirements) oben. Für Proxy-Einstellungen, benutzerdefinierte Zertifizierungsstellen und LLM-Gateways siehe [Netzwerkkonfiguration](/de/network-config).840Für die Domänen, die Sie in Ihrer Firewall auf die Allowlist setzen müssen, siehe [Netzwerkzugriffsanforderungen](#network-access-requirements) oben. Für Proxy-Einstellungen, benutzerdefinierte Zertifizierungsstellen und LLM-Gateways siehe [Netzwerkkonfiguration](/docs/de/network-config).

841 841

842Für die vollständige Enterprise-Konfigurationsreferenz siehe das [Enterprise-Konfigurationshandbuch](https://support.claude.com/en/articles/12622667-enterprise-configuration).842Für die vollständige Enterprise-Konfigurationsreferenz siehe das [Enterprise-Konfigurationshandbuch](https://support.claude.com/en/articles/12622667-enterprise-configuration).

843 843

867| `--dangerously-skip-permissions` | Bypass-Berechtigungsmodus. Aktivieren Sie auf Pro- und Max-Plänen in Einstellungen → Claude Code → „Bypass-Berechtigungsmodus zulassen"; auf Team- und Enterprise-Plänen wird es durch die Organisationsrichtlinie gesteuert |867| `--dangerously-skip-permissions` | Bypass-Berechtigungsmodus. Aktivieren Sie auf Pro- und Max-Plänen in Einstellungen → Claude Code → „Bypass-Berechtigungsmodus zulassen"; auf Team- und Enterprise-Plänen wird es durch die Organisationsrichtlinie gesteuert |

869| `--allowedTools`, `--disallowedTools` | Kein Pro-Sitzungs-Äquivalent. Berechtigungsregeln in [Einstellungsdateien](/de/settings) gelten weiterhin. |869| `--allowedTools`, `--disallowedTools` | Kein Pro-Sitzungs-Äquivalent. Berechtigungsregeln in [Einstellungsdateien](/docs/de/settings) gelten weiterhin. |

878 878

879Desktop und CLI lesen dieselben Konfigurationsdateien, daher wird Ihr Setup übertragen:879Desktop und CLI lesen dieselben Konfigurationsdateien, daher wird Ihr Setup übertragen:

880 880

881* **[CLAUDE.md](/de/memory)** und `CLAUDE.local.md`-Dateien in Ihrem Projekt werden von beiden verwendet881* **[CLAUDE.md](/docs/de/memory)** und `CLAUDE.local.md`-Dateien in Ihrem Projekt werden von beiden verwendet

882* **[MCP-Server](/de/mcp)**, die in `~/.claude.json` oder `.mcp.json` konfiguriert sind, funktionieren in beiden882* **[MCP-Server](/docs/de/mcp)**, die in `~/.claude.json` oder `.mcp.json` konfiguriert sind, funktionieren in beiden

883* **[Hooks](/de/hooks)** und **[Skills](/de/skills)**, die in Einstellungen definiert sind, gelten für beide883* **[Hooks](/docs/de/hooks)** und **[Skills](/docs/de/skills)**, die in Einstellungen definiert sind, gelten für beide

884* **[Einstellungen](/de/settings)** in `~/.claude.json` und `~/.claude/settings.json` werden geteilt. Berechtigungsregeln, erlaubte Tools und andere Einstellungen in `settings.json` gelten für Desktop-Sitzungen.884* **[Einstellungen](/docs/de/settings)** in `~/.claude.json` und `~/.claude/settings.json` werden geteilt. Berechtigungsregeln, erlaubte Tools und andere Einstellungen in `settings.json` gelten für Desktop-Sitzungen.

885* **Modelle**: die gleichen [Modelle](/de/model-config#available-models) sind in beiden verfügbar. Wählen Sie in Desktop das Modell aus dem Dropdown neben der Schaltfläche „Senden". Sie können das Modell während der Sitzung ändern.885* **Modelle**: die gleichen [Modelle](/docs/de/model-config#available-models) sind in beiden verfügbar. Wählen Sie in Desktop das Modell aus dem Dropdown neben der Schaltfläche „Senden". Sie können das Modell während der Sitzung ändern.

886 886

887<Note>887<Note>

888 **MCP-Server aus der Claude Desktop Chat-App**: Die Desktop-App lädt MCP-Server aus `claude_desktop_config.json` in Code-Tab-Sitzungen, zusammen mit Servern aus `~/.claude.json` und `.mcp.json`. Ein Server, der in `claude_desktop_config.json` definiert ist, ist sowohl auf der Desktop-Chat-Oberfläche als auch auf der Registerkarte „Code" verfügbar.888 **MCP-Server aus der Claude Desktop Chat-App**: Die Desktop-App lädt MCP-Server aus `claude_desktop_config.json` in Code-Tab-Sitzungen, zusammen mit Servern aus `~/.claude.json` und `.mcp.json`. Ein Server, der in `claude_desktop_config.json` definiert ist, ist sowohl auf der Desktop-Chat-Oberfläche als auch auf der Registerkarte „Code" verfügbar.

889 889

890 Die eigenständige CLI liest `claude_desktop_config.json` nicht. Führen Sie auf macOS und WSL `claude mcp add-from-claude-desktop` aus, um diese Server in `~/.claude.json` zu kopieren. Siehe [MCP-Server aus Claude Desktop importieren](/de/mcp#import-mcp-servers-from-claude-desktop) für den Importablauf und Bereichsoptionen.890 Die eigenständige CLI liest `claude_desktop_config.json` nicht. Führen Sie auf macOS und WSL `claude mcp add-from-claude-desktop` aus, um diese Server in `~/.claude.json` zu kopieren. Siehe [MCP-Server aus Claude Desktop importieren](/docs/de/mcp#import-mcp-servers-from-claude-desktop) für den Importablauf und Bereichsoptionen.

891</Note>891</Note>

892 892

893<h3 id="feature-comparison">893<h3 id="feature-comparison">

894 Funktionsvergleich894 Funktionsvergleich

895</h3>895</h3>

896 896

897Diese Tabelle vergleicht Kernfunktionen zwischen CLI und Desktop. Für eine vollständige Liste der CLI-Flags siehe die [CLI-Referenz](/de/cli-reference).897Diese Tabelle vergleicht Kernfunktionen zwischen CLI und Desktop. Für eine vollständige Liste der CLI-Flags siehe die [CLI-Referenz](/docs/de/cli-reference).

898 898

899| Funktion | CLI | Desktop |899| Funktion | CLI | Desktop |

900| ------------------------------------------------------ | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |900| ------------------------------------------------------ | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

901| Berechtigungsmodi | Alle Modi einschließlich `dontAsk` | Manuell, Bearbeitungen akzeptieren, Plan und Auto. Bypass-Berechtigungen erscheinen im Moduswahlschalter, sobald aktiviert: über den Einstellungsschalter auf Pro- und Max-Plänen oder über die Organisationsrichtlinie auf Team- und Enterprise-Plänen |901| Berechtigungsmodi | Alle Modi einschließlich `dontAsk` | Manuell, Bearbeitungen akzeptieren, Plan und Auto. Bypass-Berechtigungen erscheinen im Moduswahlschalter, sobald aktiviert: über den Einstellungsschalter auf Pro- und Max-Plänen oder über die Organisationsrichtlinie auf Team- und Enterprise-Plänen |

902| `--dangerously-skip-permissions` | CLI-Flag | Bypass-Berechtigungsmodus. Aktivieren Sie auf Pro- und Max-Plänen in Einstellungen → Claude Code → „Bypass-Berechtigungsmodus zulassen"; auf Team- und Enterprise-Plänen wird es durch die Organisationsrichtlinie gesteuert |902| `--dangerously-skip-permissions` | CLI-Flag | Bypass-Berechtigungsmodus. Aktivieren Sie auf Pro- und Max-Plänen in Einstellungen → Claude Code → „Bypass-Berechtigungsmodus zulassen"; auf Team- und Enterprise-Plänen wird es durch die Organisationsrichtlinie gesteuert |

903| [Drittanbieter-Provider](/de/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | Anthropic's API standardmäßig. Für Gateway-Routing siehe [Desktop-App mit einem Gateway verbinden](/de/llm-gateway-connect#desktop-app). Um die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway auszuführen, siehe [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |903| [Drittanbieter-Provider](/docs/de/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | Anthropic's API standardmäßig. Für Gateway-Routing siehe [Desktop-App mit einem Gateway verbinden](/docs/de/llm-gateway-connect#desktop-app). Um die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway auszuführen, siehe [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |

914 914

915<h3 id="what’s-not-available-in-desktop">915<h3 id="what’s-not-available-in-desktop">

916 Was ist nicht in Desktop verfügbar916 Was ist nicht in Desktop verfügbar

918 918

919Die folgenden Funktionen sind nur in der CLI oder VS Code-Erweiterung verfügbar, außer wo anders angegeben:919Die folgenden Funktionen sind nur in der CLI oder VS Code-Erweiterung verfügbar, außer wo anders angegeben:

920 920

921* **Drittanbieter-Provider**: Desktop verbindet sich mit Anthropic's API standardmäßig. Um Desktop durch ein Gateway zu leiten, siehe [Desktop-App mit einem Gateway verbinden](/de/llm-gateway-connect#desktop-app). Enterprise-Bereitstellungen können Google Cloud's Agent Platform und Gateway-Provider über [verwaltete Einstellungen](https://claude.com/docs/third-party/claude-desktop/configuration) konfigurieren. Für Amazon Bedrock oder Microsoft Foundry in der CLI siehe [Schnellstart](/de/quickstart). Als Ausnahme zum obigen Abschnitt führt [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway aus.921* **Drittanbieter-Provider**: Desktop verbindet sich mit Anthropic's API standardmäßig. Um Desktop durch ein Gateway zu leiten, siehe [Desktop-App mit einem Gateway verbinden](/docs/de/llm-gateway-connect#desktop-app). Enterprise-Bereitstellungen können Google Cloud's Agent Platform und Gateway-Provider über [verwaltete Einstellungen](https://claude.com/docs/third-party/claude-desktop/configuration) konfigurieren. Für Amazon Bedrock oder Microsoft Foundry in der CLI siehe [Schnellstart](/docs/de/quickstart). Als Ausnahme zum obigen Abschnitt führt [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway aus.

922* **Linux (Beta)**: Computernutzung ist noch nicht in der Linux-Desktop-App verfügbar. Siehe [Claude Desktop auf Linux](/de/desktop-linux).922* **Linux (Beta)**: Computernutzung ist noch nicht in der Linux-Desktop-App verfügbar. Siehe [Claude Desktop auf Linux](/docs/de/desktop-linux).

923* **Inline-Code-Vorschläge**: Desktop bietet keine Autovervollständigungs-ähnlichen Vorschläge. Es funktioniert durch Gesprächseingaben und explizite Code-Änderungen.923* **Inline-Code-Vorschläge**: Desktop bietet keine Autovervollständigungs-ähnlichen Vorschläge. Es funktioniert durch Gesprächseingaben und explizite Code-Änderungen.

924* **Agent-Teams**: Parallele Claude Code-Sitzungen, die sich gegenseitig Nachrichten senden, sind in der [CLI](/de/agent-teams) verfügbar, nicht in Desktop. Für Multi-Agent-Arbeit innerhalb einer Sitzung verwenden Sie [dynamische Workflows](/de/workflows), die in Desktop ausgeführt werden.924* **Agent-Teams**: Parallele Claude Code-Sitzungen, die sich gegenseitig Nachrichten senden, sind in der [CLI](/docs/de/agent-teams) verfügbar, nicht in Desktop. Für Multi-Agent-Arbeit innerhalb einer Sitzung verwenden Sie [dynamische Workflows](/docs/de/workflows), die in Desktop ausgeführt werden.

925* **Terminal-Dialog-Befehle**: Integrierte Befehle, die ein interaktives Panel im Terminal öffnen, verhalten sich in der Code-Registerkarte anders. Bearbeiten Sie [Einstellungsdateien](/de/settings) direkt, um Berechtigungsregeln und Konfiguration zu verwalten, oder führen Sie die Befehle aus der eigenständigen CLI aus.925* **Terminal-Dialog-Befehle**: Integrierte Befehle, die ein interaktives Panel im Terminal öffnen, verhalten sich in der Code-Registerkarte anders. Bearbeiten Sie [Einstellungsdateien](/docs/de/settings) direkt, um Berechtigungsregeln und Konfiguration zu verwalten, oder führen Sie die Befehle aus der eigenständigen CLI aus.

926 * Befehle ohne Argumentform, wie `/permissions`, antworten mit `isn't available in this environment`.926 * Befehle ohne Argumentform, wie `/permissions`, antworten mit `isn't available in this environment`.

927 * `/config` öffnet Einstellungen → Claude Code. Text nach dem Befehl wird ignoriert, daher setzt `/config theme=dark` das Design nicht.927 * `/config` öffnet Einstellungen → Claude Code. Text nach dem Befehl wird ignoriert, daher setzt `/config theme=dark` das Design nicht.

928 928

930 Fehlerbehebung930 Fehlerbehebung

931</h2>931</h2>

932 932

933Die folgenden Abschnitte behandeln Probleme, die spezifisch für die Desktop-App sind. Für Runtime-API-Fehler, die im Chat angezeigt werden, wie `API Error: 500`, `529 Overloaded`, `429` oder `Prompt is too long`, siehe die [Fehlerreferenz](/de/errors). Diese Fehler und ihre Lösungen sind gleich über CLI, Desktop und Web.933Die folgenden Abschnitte behandeln Probleme, die spezifisch für die Desktop-App sind. Für Runtime-API-Fehler, die im Chat angezeigt werden, wie `API Error: 500`, `529 Overloaded`, `429` oder `Prompt is too long`, siehe die [Fehlerreferenz](/docs/de/errors). Diese Fehler und ihre Lösungen sind gleich über CLI, Desktop und Web.

934 934

935<h3 id="check-your-version">935<h3 id="check-your-version">

936 Überprüfen Sie Ihre Version936 Überprüfen Sie Ihre Version

961Wenn die App öffnet, aber einen leeren oder nicht reagierenden Bildschirm anzeigt:961Wenn die App öffnet, aber einen leeren oder nicht reagierenden Bildschirm anzeigt:

962 962

9631. Starten Sie die App neu.9631. Starten Sie die App neu.

9642. Überprüfen Sie auf ausstehende Updates. Auf macOS und Windows wird die App beim Start automatisch aktualisiert; unter Linux aktualisieren Sie über apt wie in [Claude Desktop unter Linux](/de/desktop-linux) beschrieben.9642. Überprüfen Sie auf ausstehende Updates. Auf macOS und Windows wird die App beim Start automatisch aktualisiert; unter Linux aktualisieren Sie über apt wie in [Claude Desktop unter Linux](/docs/de/desktop-linux) beschrieben.

9653. Überprüfen Sie auf einem verwalteten Netzwerk, dass Ihre Firewall die CDN-Hosts in [Netzwerkzugriffsanforderungen](#network-access-requirements) zulässt.9653. Überprüfen Sie auf einem verwalteten Netzwerk, dass Ihre Firewall die CDN-Hosts in [Netzwerkzugriffsanforderungen](#network-access-requirements) zulässt.

9664. Überprüfen Sie unter Windows den Event Viewer auf Absturzprotokolle unter **Windows Logs → Application**.9664. Überprüfen Sie unter Windows den Event Viewer auf Absturzprotokolle unter **Windows Logs → Application**.

967 967

discover-plugins.md +28 −28

Details

8 8

9Plugins erweitern Claude Code mit Befähigungen, Agenten, Hooks und MCP-Servern. Plugin-Marktplätze sind Kataloge, die Ihnen helfen, diese Erweiterungen zu entdecken und zu installieren, ohne sie selbst zu erstellen.9Plugins erweitern Claude Code mit Befähigungen, Agenten, Hooks und MCP-Servern. Plugin-Marktplätze sind Kataloge, die Ihnen helfen, diese Erweiterungen zu entdecken und zu installieren, ohne sie selbst zu erstellen.

10 10

~~11Möchten Sie Ihren eigenen Marktplatz erstellen und verteilen? Siehe [Erstellen und verteilen Sie einen Plugin-Marktplatz](/de/plugin-marketplaces).~~11Möchten Sie Ihren eigenen Marktplatz erstellen und verteilen? Siehe [Erstellen und verteilen Sie einen Plugin-Marktplatz](/docs/de/plugin-marketplaces).

12 12

13<h2 id="how-marketplaces-work">13<h2 id="how-marketplaces-work">

14 Wie Marktplätze funktionieren14 Wie Marktplätze funktionieren

43Wenn Claude Code meldet, dass das Plugin in keinem Marktplatz gefunden wird, fehlt Ihnen entweder der Marktplatz oder er ist veraltet. Führen Sie `/plugin marketplace update claude-plugins-official` aus, um ihn zu aktualisieren, oder `/plugin marketplace add anthropics/claude-plugins-official`, wenn Sie ihn noch nicht hinzugefügt haben. Versuchen Sie dann die Installation erneut.43Wenn Claude Code meldet, dass das Plugin in keinem Marktplatz gefunden wird, fehlt Ihnen entweder der Marktplatz oder er ist veraltet. Führen Sie `/plugin marketplace update claude-plugins-official` aus, um ihn zu aktualisieren, oder `/plugin marketplace add anthropics/claude-plugins-official`, wenn Sie ihn noch nicht hinzugefügt haben. Versuchen Sie dann die Installation erneut.

44 44

45<Note>45<Note>

46 Der offizielle Marktplatz wird von Anthropic kuratiert, und die Aufnahme liegt im Ermessen von Anthropic. Die In-App-Einreichungsformulare fügen Plugins zum [Community-Marktplatz](#community-marketplace) hinzu, nicht zum offiziellen. Um Plugins unabhängig zu verteilen, [erstellen Sie Ihren eigenen Marktplatz](/de/plugin-marketplaces) und teilen Sie ihn mit Benutzern.46 Der offizielle Marktplatz wird von Anthropic kuratiert, und die Aufnahme liegt im Ermessen von Anthropic. Die In-App-Einreichungsformulare fügen Plugins zum [Community-Marktplatz](#community-marketplace) hinzu, nicht zum offiziellen. Um Plugins unabhängig zu verteilen, [erstellen Sie Ihren eigenen Marktplatz](/docs/de/plugin-marketplaces) und teilen Sie ihn mit Benutzern.

47</Note>47</Note>

48 48

49Der offizielle Marktplatz umfasst mehrere Kategorien von Plugins:49Der offizielle Marktplatz umfasst mehrere Kategorien von Plugins:

72 72

~~73Sie können auch [Ihr eigenes LSP-Plugin erstellen](/de/plugins-reference#lsp-servers) für andere Sprachen.~~73Sie können auch [Ihr eigenes LSP-Plugin erstellen](/docs/de/plugins-reference#lsp-servers) für andere Sprachen.

74 74

75<Note>75<Note>

76 Wenn Sie nach der Installation eines Plugins `Executable not found in $PATH` in der Registerkarte `/plugin` Errors sehen, installieren Sie die erforderliche Binärdatei aus der obigen Tabelle.76 Wenn Sie nach der Installation eines Plugins `Executable not found in $PATH` in der Registerkarte `/plugin` Errors sehen, installieren Sie die erforderliche Binärdatei aus der obigen Tabelle.

91 Externe Integrationen91 Externe Integrationen

92</h3>92</h3>

93 93

~~94Diese Plugins bündeln vorkonfigurierte [MCP-Server](/de/mcp), damit Sie Claude mit externen Diensten verbinden können, ohne manuelle Einrichtung:~~94Diese Plugins bündeln vorkonfigurierte [MCP-Server](/docs/de/mcp), damit Sie Claude mit externen Diensten verbinden können, ohne manuelle Einrichtung:

95 95

96* **Quellcodeverwaltung**: `github`, `gitlab`96* **Quellcodeverwaltung**: `github`, `gitlab`

97* **Projektmanagement**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`97* **Projektmanagement**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`

104 Automatische Sicherheitsüberprüfung104 Automatische Sicherheitsüberprüfung

105</h3>105</h3>

106 106

107Das Plugin `security-guidance` überprüft jede Änderung, die Claude vornimmt, auf häufige Sicherheitslücken und weist Claude an, das Gefundene in derselben Sitzung zu beheben. Siehe [Sicherheitsprobleme erfassen, während Claude Code schreibt](/de/security-guidance), um zu sehen, was es überprüft und wie Sie projektspezifische Regeln hinzufügen.107Das Plugin `security-guidance` überprüft jede Änderung, die Claude vornimmt, auf häufige Sicherheitslücken und weist Claude an, das Gefundene in derselben Sitzung zu beheben. Siehe [Sicherheitsprobleme erfassen, während Claude Code schreibt](/docs/de/security-guidance), um zu sehen, was es überprüft und wie Sie projektspezifische Regeln hinzufügen.

108 108

109<h3 id="development-workflows">109<h3 id="development-workflows">

110 Entwicklungs-Workflows110 Entwicklungs-Workflows

142/plugin install <plugin-name>@claude-community142/plugin install <plugin-name>@claude-community

143```143```

144 144

145Um Ihr eigenes Plugin zum Community-Marktplatz einzureichen, siehe [Reichen Sie Ihr Plugin beim Community-Marktplatz ein](/de/plugins#submit-your-plugin-to-the-community-marketplace) im Leitfaden zum Erstellen von Plugins.145Um Ihr eigenes Plugin zum Community-Marktplatz einzureichen, siehe [Reichen Sie Ihr Plugin beim Community-Marktplatz ein](/docs/de/plugins#submit-your-plugin-to-the-community-marketplace) im Leitfaden zum Erstellen von Plugins.

146 146

147<h2 id="try-it-add-the-demo-marketplace">147<h2 id="try-it-add-the-demo-marketplace">

148 Probieren Sie es aus: Fügen Sie den Demo-Marktplatz hinzu148 Probieren Sie es aus: Fügen Sie den Demo-Marktplatz hinzu

169 * **Marketplaces**: Fügen Sie Marktplätze hinzu, entfernen Sie sie oder aktualisieren Sie sie169 * **Marketplaces**: Fügen Sie Marktplätze hinzu, entfernen Sie sie oder aktualisieren Sie sie

170 * **Errors**: Zeigen Sie alle Plugin-Ladefehler an170 * **Errors**: Zeigen Sie alle Plugin-Ladefehler an

171 171

172 Gehen Sie zur Registerkarte **Discover**, um Plugins aus dem Marktplatz zu sehen, den Sie gerade hinzugefügt haben. {/* min-version: 2.1.154 */}Wenn Ihr Administrator den Marktplatz über die verwaltete Einstellung [`pluginSuggestionMarketplaces`](/de/settings#available-settings) auf die Whitelist gesetzt hat, werden Plugins, die für Ihr aktuelles Arbeitsverzeichnis relevant sind, oben mit einer Bezeichnung **suggested for this directory** angeheftet.172 Gehen Sie zur Registerkarte **Discover**, um Plugins aus dem Marktplatz zu sehen, den Sie gerade hinzugefügt haben. Wenn Ihr Administrator den Marktplatz über die verwaltete Einstellung [`pluginSuggestionMarketplaces`](/docs/de/settings#available-settings) auf die Whitelist gesetzt hat, werden Plugins, die für Ihr aktuelles Arbeitsverzeichnis relevant sind, oben mit einer Bezeichnung **suggested for this directory** angeheftet.

173 </Step>173 </Step>

174 174

175 <Step title="Installieren Sie ein Plugin">175 <Step title="Installieren Sie ein Plugin">

176 Wählen Sie ein Plugin aus, um seine Details anzuzeigen. Der Detailbereich zeigt, was das Plugin enthält und was es kostet:176 Wählen Sie ein Plugin aus, um seine Details anzuzeigen. Der Detailbereich zeigt, was das Plugin enthält und was es kostet:

177 177

178 * {/* min-version: 2.1.143 */}Eine **Context cost**-Schätzung, damit Sie sehen können, wie viele Token das Plugin zu Ihrem [Kontextfenster](/de/features-overview#understand-context-costs) bei jedem Durchgang hinzufügt (Claude Code v2.1.143 und später)178 * Eine **Context cost**-Schätzung, damit Sie sehen können, wie viele Token das Plugin zu Ihrem [Kontextfenster](/docs/de/features-overview#understand-context-costs) bei jedem Durchgang hinzufügt (Claude Code v2.1.143 und später)

179 * {/* min-version: 2.1.144 */}Das **Last updated**-Datum des Plugins (v2.1.144 und später)179 * Das **Last updated**-Datum des Plugins (v2.1.144 und später)

180 * {/* min-version: 2.1.145 */}Ein **Will install**-Bereich, der die Befehle, Agenten, Skills, Hooks und MCP- und LSP-Server des Plugins auflistet, damit Sie genau überprüfen können, was es hinzufügt, bevor Sie es installieren (v2.1.145 und später)180 * Ein **Will install**-Bereich, der die Befehle, Agenten, Skills, Hooks und MCP- und LSP-Server des Plugins auflistet, damit Sie genau überprüfen können, was es hinzufügt, bevor Sie es installieren (v2.1.145 und später)

181 181

182 Wählen Sie einen Installationsbereich:182 Wählen Sie einen Installationsbereich:

183 183

193 /plugin install commit-commands@claude-code-plugins193 /plugin install commit-commands@claude-code-plugins

194 ```194 ```

195 195

196 Siehe [Konfigurationsbereiche](/de/settings#configuration-scopes), um mehr über Bereiche zu erfahren.196 Siehe [Konfigurationsbereiche](/docs/de/settings#configuration-scopes), um mehr über Bereiche zu erfahren.

197 </Step>197 </Step>

198 198

199 <Step title="Verwenden Sie Ihr neues Plugin">199 <Step title="Verwenden Sie Ihr neues Plugin">

293```293```

294 294

295<Note>295<Note>

296 URL-basierte Marktplätze haben einige Einschränkungen im Vergleich zu Git-basierten Marktplätzen. Wenn beim Installieren von Plugins Fehler „Pfad nicht gefunden" auftreten, siehe [Fehlerbehebung](/de/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).296 URL-basierte Marktplätze haben einige Einschränkungen im Vergleich zu Git-basierten Marktplätzen. Wenn beim Installieren von Plugins Fehler „Pfad nicht gefunden" auftreten, siehe [Fehlerbehebung](/docs/de/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).

297</Note>297</Note>

298 298

299<h2 id="install-plugins">299<h2 id="install-plugins">

306/plugin install plugin-name@marketplace-name306/plugin install plugin-name@marketplace-name

307```307```

308 308

309Der Befehl öffnet die Details dieses Plugins, wo Sie einen [Installationsbereich](/de/settings#configuration-scopes) wählen. Sie sehen die gleichen Optionen, wenn Sie `/plugin` ausführen, zur Registerkarte **Discover** gehen und **Enter** auf einem Plugin drücken:309Der Befehl öffnet die Details dieses Plugins, wo Sie einen [Installationsbereich](/docs/de/settings#configuration-scopes) wählen. Sie sehen die gleichen Optionen, wenn Sie `/plugin` ausführen, zur Registerkarte **Discover** gehen und **Enter** auf einem Plugin drücken:

310 310

311* **User scope** (Standard): Installieren Sie für sich selbst in allen Projekten311* **User scope** (Standard): Installieren Sie für sich selbst in allen Projekten

312* **Project scope**: Installieren Sie für alle Mitarbeiter in diesem Repository, was das Plugin zu `.claude/settings.json` hinzufügt312* **Project scope**: Installieren Sie für alle Mitarbeiter in diesem Repository, was das Plugin zu `.claude/settings.json` hinzufügt

313* **Local scope**: Installieren Sie für sich selbst nur in diesem Repository, nicht mit Mitarbeitern geteilt313* **Local scope**: Installieren Sie für sich selbst nur in diesem Repository, nicht mit Mitarbeitern geteilt

314 314

315Um ohne einen interaktiven Schritt zu installieren, verwenden Sie den [`claude plugin install`](/de/plugins-reference#plugin-install) Shell-Befehl, der im Benutzerbereich installiert, es sei denn, Sie übergeben `--scope`.315Um ohne einen interaktiven Schritt zu installieren, verwenden Sie den [`claude plugin install`](/docs/de/plugins-reference#plugin-install) Shell-Befehl, der im Benutzerbereich installiert, es sei denn, Sie übergeben `--scope`.

316 316

317Sie können auch Plugins mit **managed**-Bereich sehen. Diese werden von Administratoren über [verwaltete Einstellungen](/de/settings#settings-files) installiert und können nicht geändert werden.317Sie können auch Plugins mit **managed**-Bereich sehen. Diese werden von Administratoren über [verwaltete Einstellungen](/docs/de/settings#settings-files) installiert und können nicht geändert werden.

318 318

319<Warning>319<Warning>

320 Stellen Sie sicher, dass Sie einem Plugin vertrauen, bevor Sie es installieren. Anthropic kontrolliert nicht, welche MCP-Server, Dateien oder andere Software in Plugins enthalten sind, und kann nicht überprüfen, dass sie wie beabsichtigt funktionieren. Überprüfen Sie die Homepage jedes Plugins für weitere Informationen.320 Stellen Sie sicher, dass Sie einem Plugin vertrauen, bevor Sie es installieren. Anthropic kontrolliert nicht, welche MCP-Server, Dateien oder andere Software in Plugins enthalten sind, und kann nicht überprüfen, dass sie wie beabsichtigt funktionieren. Überprüfen Sie die Homepage jedes Plugins für weitere Informationen.

343* Plugins, die Ihre Organisation verwaltet oder die Sie mit `--plugin-dir` laden343* Plugins, die Ihre Organisation verwaltet oder die Sie mit `--plugin-dir` laden

344* Plugins, die ein Theme, einen Output-Stil, einen Monitor oder einen Workflow bereitstellen, da diese Wert ohne eine zu verfolgbare Invocation liefern344* Plugins, die ein Theme, einen Output-Stil, einen Monitor oder einen Workflow bereitstellen, da diese Wert ohne eine zu verfolgbare Invocation liefern

345 345

346Der Header **Not used recently** und die Zeile **Last used** sind beide verborgen, wenn Ihre Organisation Marketplaces mit [`strictKnownMarketplaces`](/de/settings#strictknownmarketplaces) einschränkt.346Der Header **Not used recently** und die Zeile **Last used** sind beide verborgen, wenn Ihre Organisation Marketplaces mit [`strictKnownMarketplaces`](/docs/de/settings#strictknownmarketplaces) einschränkt.

347 347

348Ein [Language Server](/de/plugins#add-lsp-servers-to-your-plugin) eines Plugins zählt als verwendet, wenn er Diagnostiken liefert oder eine Code-Navigationsanfrage beantwortet, sodass ein LSP-Plugin, dessen Server in Ihren Sitzungen aktiv ist, nicht als ungenutzt aufgelistet wird. Vor v2.1.203 konnte die Language-Server-Aktivität nicht als Verwendung gezählt werden, sodass Plugins, die einen LSP-Server bereitstellen, vollständig von der Gruppe ausgenommen waren, genauso wie Theme- und Output-Style-Plugins es immer noch sind.348Ein [Language Server](/docs/de/plugins#add-lsp-servers-to-your-plugin) eines Plugins zählt als verwendet, wenn er Diagnostiken liefert oder eine Code-Navigationsanfrage beantwortet, sodass ein LSP-Plugin, dessen Server in Ihren Sitzungen aktiv ist, nicht als ungenutzt aufgelistet wird. Vor v2.1.203 konnte die Language-Server-Aktivität nicht als Verwendung gezählt werden, sodass Plugins, die einen LSP-Server bereitstellen, vollständig von der Gruppe ausgenommen waren, genauso wie Theme- und Output-Style-Plugins es immer noch sind.

349 349

350Die erste Sitzung in einer Version, die Language-Server-Aktivität zählt, setzt auch den Verwendungsdatensatz jedes LSP-Plugins zurück, das noch keine Verwendung aufgezeichnet hatte, sodass Claude Code ein Plugin, das Sie früher installiert haben, nicht als ungenutzt beurteilt, basierend auf Daten, die aufgezeichnet wurden, bevor seine Server-Aktivität verfolgt wurde. Vor v2.1.206 konnte diese erste Sitzung ein aktiv genutztes LSP-Plugin unter **Not used recently** auflisten und vorschlagen, es zu überprüfen.350Die erste Sitzung in einer Version, die Language-Server-Aktivität zählt, setzt auch den Verwendungsdatensatz jedes LSP-Plugins zurück, das noch keine Verwendung aufgezeichnet hatte, sodass Claude Code ein Plugin, das Sie früher installiert haben, nicht als ungenutzt beurteilt, basierend auf Daten, die aufgezeichnet wurden, bevor seine Server-Aktivität verfolgt wurde. Vor v2.1.206 konnte diese erste Sitzung ein aktiv genutztes LSP-Plugin unter **Not used recently** auflisten und vorschlagen, es zu überprüfen.

351 351

373/plugin enable plugin-name@marketplace-name373/plugin enable plugin-name@marketplace-name

374```374```

375 375

376In diesen Bezeichnern ist `plugin-name` der `name` des Plugins im [Marketplace-Eintrag](/de/plugin-marketplaces#plugin-entries), der sich vom `name` in der eigenen `plugin.json` des Plugins unterscheiden kann.376In diesen Bezeichnern ist `plugin-name` der `name` des Plugins im [Marketplace-Eintrag](/docs/de/plugin-marketplaces#plugin-entries), der sich vom `name` in der eigenen `plugin.json` des Plugins unterscheiden kann.

377 377

378Ab Claude Code v2.1.195 funktionieren **Enable** und **Disable** in der `/plugin`-Schnittstelle für Plugins, deren zwei Namen unterschiedlich sind, und `/plugin enable` und `/plugin disable` akzeptieren beide Namen. Wenn Sie ein solches Plugin in einer früheren Version deaktivieren, meldet Claude Code `already disabled` und lässt es aktiviert.378Ab Claude Code v2.1.195 funktionieren **Enable** und **Disable** in der `/plugin`-Schnittstelle für Plugins, deren zwei Namen unterschiedlich sind, und `/plugin enable` und `/plugin disable` akzeptieren beide Namen. Wenn Sie ein solches Plugin in einer früheren Version deaktivieren, meldet Claude Code `already disabled` und lässt es aktiviert.

379 379

402 402

403Claude Code lädt alle aktiven Plugins neu und zeigt Zählungen für Plugins, Skills, Agenten, Hooks, Plugin-MCP-Server und Plugin-LSP-Server an.403Claude Code lädt alle aktiven Plugins neu und zeigt Zählungen für Plugins, Skills, Agenten, Hooks, Plugin-MCP-Server und Plugin-LSP-Server an.

404 404

405Das Neuladen hat Tokenkosten bei der nächsten Anfrage: Neu geladene Komponenten kündigen sich in Inhalten an, die zum Gespräch hinzugefügt werden, während der vorhandene Verlauf weiterhin aus dem Prompt-Cache gelesen wird. Ein Plugin, das MCP-Server bereitstellt, kostet mehr, wenn seine Tools nicht durch [Tool-Suche](/de/mcp#scale-with-mcp-tool-search) aufgeschoben werden: Die Änderung invalidiert den Cache und die nächste Anfrage liest das gesamte Gespräch erneut. {/* min-version: 2.1.163 */}In diesem Fall zeigt `/reload-plugins` eine Warnung an und wendet das Neuladen nicht an; übergeben Sie `--force`, um es trotzdem anzuwenden. Weitere Informationen finden Sie unter [Aktivieren oder Deaktivieren eines Plugins](/de/prompt-caching#enabling-or-disabling-a-plugin).405Das Neuladen hat Tokenkosten bei der nächsten Anfrage: Neu geladene Komponenten kündigen sich in Inhalten an, die zum Gespräch hinzugefügt werden, während der vorhandene Verlauf weiterhin aus dem Prompt-Cache gelesen wird. Ein Plugin, das MCP-Server bereitstellt, kostet mehr, wenn seine Tools nicht durch [Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) aufgeschoben werden: Die Änderung invalidiert den Cache und die nächste Anfrage liest das gesamte Gespräch erneut. In diesem Fall zeigt `/reload-plugins` eine Warnung an und wendet das Neuladen nicht an; übergeben Sie `--force`, um es trotzdem anzuwenden. Weitere Informationen finden Sie unter [Aktivieren oder Deaktivieren eines Plugins](/docs/de/prompt-caching#enabling-or-disabling-a-plugin).

406 406

407<h2 id="manage-marketplaces">407<h2 id="manage-marketplaces">

408 Marktplätze verwalten408 Marktplätze verwalten

466 466

467Offizielle Anthropic-Marktplätze haben die automatische Aktualisierung standardmäßig aktiviert. Marktplätze von Drittanbietern und lokale Entwicklungsmarktplätze haben die automatische Aktualisierung standardmäßig deaktiviert.467Offizielle Anthropic-Marktplätze haben die automatische Aktualisierung standardmäßig aktiviert. Marktplätze von Drittanbietern und lokale Entwicklungsmarktplätze haben die automatische Aktualisierung standardmäßig deaktiviert.

468 468

469Administratoren können auch `"autoUpdate": true` für jeden [`extraKnownMarketplaces`](/de/settings#extraknownmarketplaces)-Eintrag in verwalteten Einstellungen festlegen, um die automatische Aktualisierung für einen Organisationsmarktplatz zu aktivieren, ohne dass jeder Benutzer diese umschalten muss.469Administratoren können auch `"autoUpdate": true` für jeden [`extraKnownMarketplaces`](/docs/de/settings#extraknownmarketplaces)-Eintrag in verwalteten Einstellungen festlegen, um die automatische Aktualisierung für einen Organisationsmarktplatz zu aktivieren, ohne dass jeder Benutzer diese umschalten muss.

470 470

471Um alle automatischen Updates vollständig für Claude Code und alle Plugins zu deaktivieren, setzen Sie die Umgebungsvariable `DISABLE_AUTOUPDATER`. Siehe [Auto-Updates](/de/setup#auto-updates) für Details.471Um alle automatischen Updates vollständig für Claude Code und alle Plugins zu deaktivieren, setzen Sie die Umgebungsvariable `DISABLE_AUTOUPDATER`. Siehe [Auto-Updates](/docs/de/setup#auto-updates) für Details.

472 472

473Um Plugin-Auto-Updates aktiviert zu halten und gleichzeitig Claude Code-Auto-Updates zu deaktivieren, setzen Sie `FORCE_AUTOUPDATE_PLUGINS=1` zusammen mit `DISABLE_AUTOUPDATER`:473Um Plugin-Auto-Updates aktiviert zu halten und gleichzeitig Claude Code-Auto-Updates zu deaktivieren, setzen Sie `FORCE_AUTOUPDATE_PLUGINS=1` zusammen mit `DISABLE_AUTOUPDATER`:

474 474

502}502}

503```503```

504 504

505Für vollständige Konfigurationsoptionen einschließlich `extraKnownMarketplaces` und `enabledPlugins` siehe [Plugin-Einstellungen](/de/settings#plugin-settings).505Für vollständige Konfigurationsoptionen einschließlich `extraKnownMarketplaces` und `enabledPlugins` siehe [Plugin-Einstellungen](/docs/de/settings#plugin-settings).

506 506

507<h2 id="security">507<h2 id="security">

508 Sicherheit508 Sicherheit

509</h2>509</h2>

510 510

511Plugins und Marktplätze sind hochgradig vertrauenswürdige Komponenten, die beliebigen Code auf Ihrem Computer mit Ihren Benutzerrechten ausführen können. Installieren Sie nur Plugins und fügen Sie Marktplätze aus Quellen hinzu, denen Sie vertrauen. Organisationen können einschränken, welche Marktplätze Benutzer hinzufügen dürfen, indem sie [verwaltete Marktplatz-Einschränkungen](/de/plugin-marketplaces#managed-marketplace-restrictions) verwenden.511Plugins und Marktplätze sind hochgradig vertrauenswürdige Komponenten, die beliebigen Code auf Ihrem Computer mit Ihren Benutzerrechten ausführen können. Installieren Sie nur Plugins und fügen Sie Marktplätze aus Quellen hinzu, denen Sie vertrauen. Organisationen können einschränken, welche Marktplätze Benutzer hinzufügen dürfen, indem sie [verwaltete Marktplatz-Einschränkungen](/docs/de/plugin-marketplaces#managed-marketplace-restrictions) verwenden.

512 512

513<h2 id="troubleshooting">513<h2 id="troubleshooting">

514 Fehlerbehebung514 Fehlerbehebung

5242. **Aktualisieren Sie Claude Code**:5242. **Aktualisieren Sie Claude Code**:

525 * **Homebrew**: `brew upgrade claude-code` oder `brew upgrade claude-code@latest`, wenn Sie diesen Cask installiert haben525 * **Homebrew**: `brew upgrade claude-code` oder `brew upgrade claude-code@latest`, wenn Sie diesen Cask installiert haben

526 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`526 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`

527 * **Native Installer**: Führen Sie den Installationsbefehl von [Setup](/de/setup) erneut aus527 * **Native Installer**: Führen Sie den Installationsbefehl von [Setup](/docs/de/setup) erneut aus

5283. **Starten Sie Claude Code neu**: Starten Sie nach dem Update Ihr Terminal neu und führen Sie `claude` erneut aus.5283. **Starten Sie Claude Code neu**: Starten Sie nach dem Update Ihr Terminal neu und führen Sie `claude` erneut aus.

529 529

530<h3 id="common-issues">530<h3 id="common-issues">

536* **Dateien nach der Installation nicht gefunden**: Plugins werden in einen Cache kopiert, daher funktionieren Pfade, die auf Dateien außerhalb des Plugin-Verzeichnisses verweisen, nicht536* **Dateien nach der Installation nicht gefunden**: Plugins werden in einen Cache kopiert, daher funktionieren Pfade, die auf Dateien außerhalb des Plugin-Verzeichnisses verweisen, nicht

537* **Plugin-Befähigungen werden nicht angezeigt**: Löschen Sie den Cache mit `rm -rf ~/.claude/plugins/cache`, starten Sie Claude Code neu und installieren Sie das Plugin erneut.537* **Plugin-Befähigungen werden nicht angezeigt**: Löschen Sie den Cache mit `rm -rf ~/.claude/plugins/cache`, starten Sie Claude Code neu und installieren Sie das Plugin erneut.

538 538

539Für detaillierte Fehlerbehebung mit Lösungen siehe [Fehlerbehebung](/de/plugin-marketplaces#troubleshooting) im Marktplatz-Leitfaden. Für Debugging-Tools siehe [Debugging- und Entwicklungstools](/de/plugins-reference#debugging-and-development-tools).539Für detaillierte Fehlerbehebung mit Lösungen siehe [Fehlerbehebung](/docs/de/plugin-marketplaces#troubleshooting) im Marktplatz-Leitfaden. Für Debugging-Tools siehe [Debugging- und Entwicklungstools](/docs/de/plugins-reference#debugging-and-development-tools).

540 540

541<h3 id="code-intelligence-issues">541<h3 id="code-intelligence-issues">

542 Code-Intelligenz-Probleme542 Code-Intelligenz-Probleme

550 Nächste Schritte550 Nächste Schritte

551</h2>551</h2>

552 552

553* **Erstellen Sie Ihre eigenen Plugins**: Siehe [Plugins](/de/plugins), um Befähigungen, Agenten und Hooks zu erstellen553* **Erstellen Sie Ihre eigenen Plugins**: Siehe [Plugins](/docs/de/plugins), um Befähigungen, Agenten und Hooks zu erstellen

554* **Erstellen Sie einen Marktplatz**: Siehe [Erstellen Sie einen Plugin-Marktplatz](/de/plugin-marketplaces), um Plugins an Ihr Team oder Ihre Community zu verteilen554* **Erstellen Sie einen Marktplatz**: Siehe [Erstellen Sie einen Plugin-Marktplatz](/docs/de/plugin-marketplaces), um Plugins an Ihr Team oder Ihre Community zu verteilen

555* **Technische Referenz**: Siehe [Plugins-Referenz](/de/plugins-reference) für vollständige Spezifikationen555* **Technische Referenz**: Siehe [Plugins-Referenz](/docs/de/plugins-reference) für vollständige Spezifikationen

env-vars.md +197 −197

Details

6 6

7> Referenz für Umgebungsvariablen, die das Verhalten von Claude Code steuern.7> Referenz für Umgebungsvariablen, die das Verhalten von Claude Code steuern.

8 8

9Umgebungsvariablen können das Verhalten von Claude Code steuern, z. B. Modellauswahl, Authentifizierung, Request-Routing und Feature-Toggles. Viele der gleichen Verhaltensweisen können auch über ein [Einstellungsfeld](/de/settings) konfiguriert werden, ein [CLI-Flag](/de/cli-reference) oder einen In-Session-Befehl wie `/model`.9Umgebungsvariablen können das Verhalten von Claude Code steuern, z. B. Modellauswahl, Authentifizierung, Request-Routing und Feature-Toggles. Viele der gleichen Verhaltensweisen können auch über ein [Einstellungsfeld](/docs/de/settings) konfiguriert werden, ein [CLI-Flag](/docs/de/cli-reference) oder einen In-Session-Befehl wie `/model`.

10 10

11Diese Seite behandelt folgende Themen:11Diese Seite behandelt folgende Themen:

12 12

79| `.claude/settings.local.json` | Sie, nur in diesem Projekt (fügen Sie es zu Ihrer gitignore hinzu, wenn Sie es manuell erstellen) |79| `.claude/settings.local.json` | Sie, nur in diesem Projekt (fügen Sie es zu Ihrer gitignore hinzu, wenn Sie es manuell erstellen) |

80| Verwaltete Einstellungen | Alle in Ihrer Organisation, bereitgestellt von einem Administrator |80| Verwaltete Einstellungen | Alle in Ihrer Organisation, bereitgestellt von einem Administrator |

81 81

82Siehe [Einstellungsdateien](/de/settings#settings-files) für den Speicherort jeder Datei und [Einstellungs-Vorrang](/de/settings#settings-precedence) für die Kombination, wenn mehr als eine die gleiche Variable setzt.82Siehe [Einstellungsdateien](/docs/de/settings#settings-files) für den Speicherort jeder Datei und [Einstellungs-Vorrang](/docs/de/settings#settings-precedence) für die Kombination, wenn mehr als eine die gleiche Variable setzt.

83 83

84<h2 id="precedence">84<h2 id="precedence">

85 Vorrang85 Vorrang

87 87

88Wenn das gleiche Verhalten sowohl eine Umgebungsvariable als auch ein Einstellungsfeld hat, hat die Umgebungsvariable Vorrang. Zum Beispiel überschreibt `ANTHROPIC_MODEL` die Einstellung `model`, und `CLAUDE_CODE_AUTO_CONNECT_IDE` überschreibt `autoConnectIde`. Das Einstellungsfeld gilt, wenn die Umgebungsvariable nicht gesetzt ist.88Wenn das gleiche Verhalten sowohl eine Umgebungsvariable als auch ein Einstellungsfeld hat, hat die Umgebungsvariable Vorrang. Zum Beispiel überschreibt `ANTHROPIC_MODEL` die Einstellung `model`, und `CLAUDE_CODE_AUTO_CONNECT_IDE` überschreibt `autoConnectIde`. Das Einstellungsfeld gilt, wenn die Umgebungsvariable nicht gesetzt ist.

89 89

90Wenn die gleiche Variable sowohl in Ihrer Shell als auch in einer Einstellungsdatei im `env`-Block gesetzt ist, gilt der Wert der Einstellungsdatei. Claude Code schreibt jeden `env`-Eintrag beim Start in die Prozessumgebung und ersetzt dabei den Wert, der von der Shell geerbt wurde. Einige Variablen werden speziell behandelt; die [`env`-Einstellung](/de/settings#available-settings) listet die Ausnahmen auf.90Wenn die gleiche Variable sowohl in Ihrer Shell als auch in einer Einstellungsdatei im `env`-Block gesetzt ist, gilt der Wert der Einstellungsdatei. Claude Code schreibt jeden `env`-Eintrag beim Start in die Prozessumgebung und ersetzt dabei den Wert, der von der Shell geerbt wurde. Einige Variablen werden speziell behandelt; die [`env`-Einstellung](/docs/de/settings#available-settings) listet die Ausnahmen auf.

91 91

92Zwischen Einstellungsdateien folgen `env`-Werte dem [Einstellungsvorrang](/de/settings#settings-precedence), sodass ein verwalteter Einstellungseintrag die gleiche Variable in Benutzer- oder Projekteinstellungen überschreibt.92Zwischen Einstellungsdateien folgen `env`-Werte dem [Einstellungsvorrang](/docs/de/settings#settings-precedence), sodass ein verwalteter Einstellungseintrag die gleiche Variable in Benutzer- oder Projekteinstellungen überschreibt.

93 93

94Wie eine Umgebungsvariable mit CLI-Flags und In-Session-Befehlen interagiert, variiert je nach Feature: `--model` und `/model` überschreiben `ANTHROPIC_MODEL`, während `CLAUDE_CODE_EFFORT_LEVEL` `/effort` überschreibt. Wenn eine Variable mit einer anderen Konfigurationsquelle interagiert, gibt ihre Zeile in der [Variablen](#variables)-Liste den Vorrang an oder verlinkt auf die Seite, die ihn dokumentiert.94Wie eine Umgebungsvariable mit CLI-Flags und In-Session-Befehlen interagiert, variiert je nach Feature: `--model` und `/model` überschreiben `ANTHROPIC_MODEL`, während `CLAUDE_CODE_EFFORT_LEVEL` `/effort` überschreibt. Wenn eine Variable mit einer anderen Konfigurationsquelle interagiert, gibt ihre Zeile in der [Variablen](#variables)-Liste den Vorrang an oder verlinkt auf die Seite, die ihn dokumentiert.

95 95

100</h2>100</h2>

101 101

103| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |103| :------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

104| `ANTHROPIC_API_KEY` | API-Schlüssel, der als `X-Api-Key`-Header gesendet wird. Wenn gesetzt, wird dieser Schlüssel anstelle Ihres Claude Pro-, Max-, Team- oder Enterprise-Abonnements verwendet, auch wenn Sie angemeldet sind. Im nicht-interaktiven Modus (`-p`) wird der Schlüssel immer verwendet, wenn er vorhanden ist. Im interaktiven Modus werden Sie aufgefordert, den Schlüssel einmalig zu genehmigen, bevor er Ihr Abonnement überschreibt. Um stattdessen Ihr Abonnement zu verwenden, führen Sie `unset ANTHROPIC_API_KEY` aus |104| `ANTHROPIC_API_KEY` | API-Schlüssel, der als `X-Api-Key`-Header gesendet wird. Wenn gesetzt, wird dieser Schlüssel anstelle Ihres Claude Pro-, Max-, Team- oder Enterprise-Abonnements verwendet, auch wenn Sie angemeldet sind. Im nicht-interaktiven Modus (`-p`) wird der Schlüssel immer verwendet, wenn er vorhanden ist. Im interaktiven Modus werden Sie aufgefordert, den Schlüssel einmalig zu genehmigen, bevor er Ihr Abonnement überschreibt. Um stattdessen Ihr Abonnement zu verwenden, führen Sie `unset ANTHROPIC_API_KEY` aus |

105| `ANTHROPIC_AUTH_TOKEN` | Benutzerdefinierter Wert für den `Authorization`-Header (der hier gesetzte Wert wird mit `Bearer ` vorangestellt) |105| `ANTHROPIC_AUTH_TOKEN` | Benutzerdefinierter Wert für den `Authorization`-Header (der hier gesetzte Wert wird mit `Bearer ` vorangestellt) |

106| `ANTHROPIC_AWS_API_KEY` | Workspace API-Schlüssel für [Claude Platform on AWS](/de/claude-platform-on-aws), generiert in der AWS-Konsole. Wird als `x-api-key` gesendet und hat Vorrang vor AWS SigV4 |106| `ANTHROPIC_AWS_API_KEY` | Workspace API-Schlüssel für [Claude Platform on AWS](/docs/de/claude-platform-on-aws), generiert in der AWS-Konsole. Wird als `x-api-key` gesendet und hat Vorrang vor AWS SigV4 |

107| `ANTHROPIC_AWS_BASE_URL` | Überschreiben Sie die [Claude Platform on AWS](/de/claude-platform-on-aws)-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Regionen oder beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Standardmäßig `https://aws-external-anthropic.{AWS_REGION}.api.aws` |107| `ANTHROPIC_AWS_BASE_URL` | Überschreiben Sie die [Claude Platform on AWS](/docs/de/claude-platform-on-aws)-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Regionen oder beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway). Standardmäßig `https://aws-external-anthropic.{AWS_REGION}.api.aws` |

108| `ANTHROPIC_AWS_WORKSPACE_ID` | Erforderlich für [Claude Platform on AWS](/de/claude-platform-on-aws). Wird bei jeder Anfrage als `anthropic-workspace-id`-Header gesendet |108| `ANTHROPIC_AWS_WORKSPACE_ID` | Erforderlich für [Claude Platform on AWS](/docs/de/claude-platform-on-aws). Wird bei jeder Anfrage als `anthropic-workspace-id`-Header gesendet |

109| `ANTHROPIC_BASE_URL` | Überschreiben Sie den API-Endpunkt, um Anfragen durch einen Proxy oder ein Gateway zu leiten. Wenn auf einen Nicht-First-Party-Host gesetzt, ist die [MCP-Tool-Suche](/de/mcp#scale-with-mcp-tool-search) standardmäßig deaktiviert. Setzen Sie `ENABLE_TOOL_SEARCH=true`, wenn Ihr Proxy `tool_reference`-Blöcke weiterleitet. {/* min-version: 2.1.196 */}Ab v2.1.196 ist die [Remote Control](/de/remote-control#requirements) deaktiviert, wenn dies auf einen anderen Host als `api.anthropic.com` verweist, was seinem Verhalten auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry entspricht |109| `ANTHROPIC_BASE_URL` | Überschreiben Sie den API-Endpunkt, um Anfragen durch einen Proxy oder ein Gateway zu leiten. Wenn auf einen Nicht-First-Party-Host gesetzt, ist die [MCP-Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) standardmäßig deaktiviert. Setzen Sie `ENABLE_TOOL_SEARCH=true`, wenn Ihr Proxy `tool_reference`-Blöcke weiterleitet. Ab v2.1.196 ist die [Remote Control](/docs/de/remote-control#requirements) deaktiviert, wenn dies auf einen anderen Host als `api.anthropic.com` verweist, was seinem Verhalten auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry entspricht |

110| `ANTHROPIC_BEDROCK_BASE_URL` | Überschreiben Sie die Amazon Bedrock-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Amazon Bedrock-Endpunkte oder beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Siehe [Amazon Bedrock](/de/amazon-bedrock) |110| `ANTHROPIC_BEDROCK_BASE_URL` | Überschreiben Sie die Amazon Bedrock-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Amazon Bedrock-Endpunkte oder beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway). Siehe [Amazon Bedrock](/docs/de/amazon-bedrock) |

111| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreiben Sie die Amazon Bedrock Mantle-Endpunkt-URL. Siehe [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) |111| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Überschreiben Sie die Amazon Bedrock Mantle-Endpunkt-URL. Siehe [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) |

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

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

114| `ANTHROPIC_CUSTOM_HEADERS` | Benutzerdefinierte Header, die zu Anfragen hinzugefügt werden (Format `Name: Value`, durch Zeilenumbruch getrennt für mehrere Header) |114| `ANTHROPIC_CUSTOM_HEADERS` | Benutzerdefinierte Header, die zu Anfragen hinzugefügt werden (Format `Name: Value`, durch Zeilenumbruch getrennt für mehrere Header) |

115| `ANTHROPIC_CUSTOM_MODEL_OPTION` | Modell-ID, die als benutzerdefinierter Eintrag in der `/model`-Auswahl hinzugefügt werden soll. Verwenden Sie dies, um ein nicht standardisiertes oder Gateway-spezifisches Modell auswählbar zu machen, ohne integrierte Aliase zu ersetzen. Siehe [Modellkonfiguration](/de/model-config#add-a-custom-model-option) |115| `ANTHROPIC_CUSTOM_MODEL_OPTION` | Modell-ID, die als benutzerdefinierter Eintrag in der `/model`-Auswahl hinzugefügt werden soll. Verwenden Sie dies, um ein nicht standardisiertes oder Gateway-spezifisches Modell auswählbar zu machen, ohne integrierte Aliase zu ersetzen. Siehe [Modellkonfiguration](/docs/de/model-config#add-a-custom-model-option) |

116| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Anzeigenbeschreibung für den benutzerdefinierten Modelleintrag in der `/model`-Auswahl. Standardmäßig `Custom model (<model-id>)`, wenn nicht gesetzt |116| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Anzeigenbeschreibung für den benutzerdefinierten Modelleintrag in der `/model`-Auswahl. Standardmäßig `Custom model (<model-id>)`, wenn nicht gesetzt |

117| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Anzeigename für den benutzerdefinierten Modelleintrag in der `/model`-Auswahl. Standardmäßig die Modell-ID, wenn nicht gesetzt |117| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Anzeigename für den benutzerdefinierten Modelleintrag in der `/model`-Auswahl. Standardmäßig die Modell-ID, wenn nicht gesetzt |

118| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |118| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

120| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |120| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

121| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |121| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

122| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |122| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

124| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |124| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

125| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |125| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

126| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |126| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

128| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |128| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

129| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |129| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

130| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |130| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

132| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |132| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

133| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |133| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

134| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/de/model-config#customize-pinned-model-display-and-capabilities) |134| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Siehe [Modellkonfiguration](/docs/de/model-config#customize-pinned-model-display-and-capabilities) |

135| `ANTHROPIC_FOUNDRY_API_KEY` | API-Schlüssel für Microsoft Foundry-Authentifizierung (siehe [Microsoft Foundry](/de/microsoft-foundry)) |135| `ANTHROPIC_FOUNDRY_API_KEY` | API-Schlüssel für Microsoft Foundry-Authentifizierung (siehe [Microsoft Foundry](/docs/de/microsoft-foundry)) |

136| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | {/* min-version: 2.1.203 */}Bearer-Token für Microsoft Foundry-Authentifizierung, z. B. ein Microsoft Entra-Zugriffstoken. Claude Code sendet es als `Authorization: Bearer`-Header. Hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY` und vor der Azure-Standard-Anmeldedatenkette. Siehe [Microsoft Foundry](/de/microsoft-foundry). Erfordert Claude Code v2.1.203 oder später |136| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Bearer-Token für Microsoft Foundry-Authentifizierung, z. B. ein Microsoft Entra-Zugriffstoken. Claude Code sendet es als `Authorization: Bearer`-Header. Hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY` und vor der Azure-Standard-Anmeldedatenkette. Siehe [Microsoft Foundry](/docs/de/microsoft-foundry). Erfordert Claude Code v2.1.203 oder später |

137| `ANTHROPIC_FOUNDRY_BASE_URL` | Vollständige Basis-URL für die Microsoft Foundry-Ressource (z. B. `https://my-resource.services.ai.azure.com/anthropic`). Alternative zu `ANTHROPIC_FOUNDRY_RESOURCE` (siehe [Microsoft Foundry](/de/microsoft-foundry)) |137| `ANTHROPIC_FOUNDRY_BASE_URL` | Vollständige Basis-URL für die Microsoft Foundry-Ressource (z. B. `https://my-resource.services.ai.azure.com/anthropic`). Alternative zu `ANTHROPIC_FOUNDRY_RESOURCE` (siehe [Microsoft Foundry](/docs/de/microsoft-foundry)) |

138| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry-Ressourcenname (z. B. `my-resource`). Erforderlich, wenn `ANTHROPIC_FOUNDRY_BASE_URL` nicht gesetzt ist (siehe [Microsoft Foundry](/de/microsoft-foundry)) |138| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry-Ressourcenname (z. B. `my-resource`). Erforderlich, wenn `ANTHROPIC_FOUNDRY_BASE_URL` nicht gesetzt ist (siehe [Microsoft Foundry](/docs/de/microsoft-foundry)) |

139| `ANTHROPIC_MODEL` | Name der zu verwendenden Modelleinstellung (siehe [Modellkonfiguration](/de/model-config#environment-variables)) |139| `ANTHROPIC_MODEL` | Name der zu verwendenden Modelleinstellung (siehe [Modellkonfiguration](/docs/de/model-config#environment-variables)) |

141| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | AWS-Region für das Haiku-Klasse-Modell bei Verwendung von Amazon Bedrock oder Amazon Bedrock Mantle überschreiben. Auf Amazon Bedrock wirkt sich dies nur aus, wenn `ANTHROPIC_DEFAULT_HAIKU_MODEL` oder das veraltete `ANTHROPIC_SMALL_FAST_MODEL` auch gesetzt ist, da Amazon Bedrock ansonsten das [Standard-Sonnet-Modell oder das primäre Modell](/de/amazon-bedrock#4-pin-model-versions) in der Sitzungsregion für Hintergrundaufgaben verwendet |141| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | AWS-Region für das Haiku-Klasse-Modell bei Verwendung von Amazon Bedrock oder Amazon Bedrock Mantle überschreiben. Auf Amazon Bedrock wirkt sich dies nur aus, wenn `ANTHROPIC_DEFAULT_HAIKU_MODEL` oder das veraltete `ANTHROPIC_SMALL_FAST_MODEL` auch gesetzt ist, da Amazon Bedrock ansonsten das [Standard-Sonnet-Modell oder das primäre Modell](/docs/de/amazon-bedrock#4-pin-model-versions) in der Sitzungsregion für Hintergrundaufgaben verwendet |

142| `ANTHROPIC_VERTEX_BASE_URL` | Überschreiben Sie die Google Cloud's Agent Platform-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Google Cloud's Agent Platform-Endpunkte oder beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Siehe [Google Cloud's Agent Platform](/de/google-vertex-ai) |142| `ANTHROPIC_VERTEX_BASE_URL` | Überschreiben Sie die Google Cloud's Agent Platform-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Google Cloud's Agent Platform-Endpunkte oder beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway). Siehe [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) |

143| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP-Projekt-ID für Google Cloud's Agent Platform-Anfragen. Wird überschrieben durch `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` oder das Projekt in Ihrer `GOOGLE_APPLICATION_CREDENTIALS`-Anmeldedatei. Siehe [Google Cloud's Agent Platform](/de/google-vertex-ai) |143| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP-Projekt-ID für Google Cloud's Agent Platform-Anfragen. Wird überschrieben durch `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` oder das Projekt in Ihrer `GOOGLE_APPLICATION_CREDENTIALS`-Anmeldedatei. Siehe [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) |

144| `ANTHROPIC_WORKSPACE_ID` | Workspace-ID für [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Setzen Sie dies, wenn Ihre Verbundungsregel auf mehr als einen Workspace beschränkt ist, damit der Token-Austausch weiß, welcher Workspace das Ziel ist |144| `ANTHROPIC_WORKSPACE_ID` | Workspace-ID für [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Setzen Sie dies, wenn Ihre Verbundungsregel auf mehr als einen Workspace beschränkt ist, damit der Token-Austausch weiß, welcher Workspace das Ziel ist |

145| `API_FORCE_IDLE_TIMEOUT` | {/* min-version: 2.1.169 */}Überschreiben Sie das 5-Minuten-Idle-Timeout, das eine Streaming-Modell-Antwort abbricht, wenn keine Bytes ankommen. Setzen Sie auf `0`, um das Timeout zu deaktivieren, z. B. wenn ein langsames [Gateway](/de/llm-gateway) oder lokales Modell länger als 5 Minuten zwischen Chunks pausiert. Setzen Sie auf `1`, um das Timeout bei jedem Provider zu behalten. Wenn nicht gesetzt, ist das Timeout bei direkten Anthropic API- und [Claude Platform on AWS](/de/claude-platform-on-aws)-Verbindungen inaktiv, wo Claude Codes eigener Byte-Level-Stream-Watchdog läuft, und aktiv bei jedem anderen Provider, einschließlich [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry), [Mantle](/de/amazon-bedrock#use-the-mantle-endpoint), [Amazon Bedrock](/de/amazon-bedrock) und Gateway-Verbindungen, sodass ein stillgelegter Stream abbricht, anstatt zu hängen. Ab v2.1.169 |145| `API_FORCE_IDLE_TIMEOUT` | Überschreiben Sie das 5-Minuten-Idle-Timeout, das eine Streaming-Modell-Antwort abbricht, wenn keine Bytes ankommen. Setzen Sie auf `0`, um das Timeout zu deaktivieren, z. B. wenn ein langsames [Gateway](/docs/de/llm-gateway) oder lokales Modell länger als 5 Minuten zwischen Chunks pausiert. Setzen Sie auf `1`, um das Timeout bei jedem Provider zu behalten. Wenn nicht gesetzt, ist das Timeout bei direkten Anthropic API- und [Claude Platform on AWS](/docs/de/claude-platform-on-aws)-Verbindungen inaktiv, wo Claude Codes eigener Byte-Level-Stream-Watchdog läuft, und aktiv bei jedem anderen Provider, einschließlich [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), [Microsoft Foundry](/docs/de/microsoft-foundry), [Mantle](/docs/de/amazon-bedrock#use-the-mantle-endpoint), [Amazon Bedrock](/docs/de/amazon-bedrock) und Gateway-Verbindungen, sodass ein stillgelegter Stream abbricht, anstatt zu hängen. Ab v2.1.169 |

146| `API_TIMEOUT_MS` | Timeout für API-Anfragen in Millisekunden (Standard: 600000 oder 10 Minuten; Maximum: 2147483647). Erhöhen Sie dies, wenn Anfragen bei langsamen Netzwerken oder beim Routing durch einen Proxy Timeout-Fehler verursachen. Werte über dem Maximum führen zu Überläufen des zugrunde liegenden Timers und verursachen, dass Anfragen sofort fehlschlagen |146| `API_TIMEOUT_MS` | Timeout für API-Anfragen in Millisekunden (Standard: 600000 oder 10 Minuten; Maximum: 2147483647). Erhöhen Sie dies, wenn Anfragen bei langsamen Netzwerken oder beim Routing durch einen Proxy Timeout-Fehler verursachen. Werte über dem Maximum führen zu Überläufen des zugrunde liegenden Timers und verursachen, dass Anfragen sofort fehlschlagen |

147| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock API-Schlüssel für Authentifizierung (siehe [Amazon Bedrock API-Schlüssel](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |147| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock API-Schlüssel für Authentifizierung (siehe [Amazon Bedrock API-Schlüssel](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

149| `BASH_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen in Bash-Ausgaben, bevor die vollständige Ausgabe in einer Datei gespeichert wird und Claude den Pfad plus eine kurze Vorschau erhält. Siehe [Bash-Tool-Verhalten](/de/tools-reference#bash-tool-behavior) |149| `BASH_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen in Bash-Ausgaben, bevor die vollständige Ausgabe in einer Datei gespeichert wird und Claude den Pfad plus eine kurze Vorschau erhält. Siehe [Bash-Tool-Verhalten](/docs/de/tools-reference#bash-tool-behavior) |

150| `BASH_MAX_TIMEOUT_MS` | Maximales Timeout, das das Modell für lang laufende Bash-Befehle setzen kann (Standard: 600000 oder 10 Minuten) |150| `BASH_MAX_TIMEOUT_MS` | Maximales Timeout, das das Modell für lang laufende Bash-Befehle setzen kann (Standard: 600000 oder 10 Minuten) |

151| `CCR_FORCE_BUNDLE` | Setzen Sie auf `1`, um [`claude --cloud`](/de/claude-code-on-the-web#send-local-repositories-without-github) zu erzwingen, Ihr lokales Repository zu bündeln und hochzuladen, auch wenn GitHub-Zugriff verfügbar ist |151| `CCR_FORCE_BUNDLE` | Setzen Sie auf `1`, um [`claude --cloud`](/docs/de/claude-code-on-the-web#send-local-repositories-without-github) zu erzwingen, Ihr lokales Repository zu bündeln und hochzuladen, auch wenn GitHub-Zugriff verfügbar ist |

152| `CLAUDECODE` | Auf `1` in Subprozessen gesetzt, die Claude Code spawnt (Bash- und PowerShell-Tools, tmux-Sitzungen, [Hook](/de/hooks)-Befehle, [Statuszeilen](/de/statusline)-Befehle, stdio [MCP-Server](/de/mcp)-Subprozesse). IDE-Erweiterungen setzen dies auch in ihren integrierten Terminals. Verwenden Sie, um zu erkennen, wenn ein Skript in einem Subprozess ausgeführt wird, der von Claude Code gespawnt wurde. Um zu überprüfen, ob der aktuelle Prozess direkt von einem Tool-Aufruf oder Hook gespawnt wurde, anstatt in einem stdio [MCP-Server](/de/mcp), den Claude Code gestartet hat, verwenden Sie stattdessen `CLAUDE_CODE_CHILD_SESSION` |152| `CLAUDECODE` | Auf `1` in Subprozessen gesetzt, die Claude Code spawnt (Bash- und PowerShell-Tools, tmux-Sitzungen, [Hook](/docs/de/hooks)-Befehle, [Statuszeilen](/docs/de/statusline)-Befehle, stdio [MCP-Server](/docs/de/mcp)-Subprozesse). IDE-Erweiterungen setzen dies auch in ihren integrierten Terminals. Verwenden Sie, um zu erkennen, wenn ein Skript in einem Subprozess ausgeführt wird, der von Claude Code gespawnt wurde. Um zu überprüfen, ob der aktuelle Prozess direkt von einem Tool-Aufruf oder Hook gespawnt wurde, anstatt in einem stdio [MCP-Server](/docs/de/mcp), den Claude Code gestartet hat, verwenden Sie stattdessen `CLAUDE_CODE_CHILD_SESSION` |

153| `CLAUDE_AFK_COUNTDOWN_MS` | {/* min-version: 2.1.198 */}Wie viele Millisekunden vor dem Auto-Fortfahren der Countdown auf dem Bildschirm auf einem unbeantworteten [`AskUserQuestion`](/de/tools-reference)-Dialog angezeigt wird. Standard `20000` (20 Sekunden), begrenzt durch das Auto-Fortfahren-Timeout. Hat keine Auswirkung, es sei denn, Auto-Fortfahren ist aktiviert; siehe die Einstellung [`askUserQuestionTimeout`](/de/settings#available-settings) und `CLAUDE_AFK_TIMEOUT_MS`. Erfordert Claude Code v2.1.198 oder später |153| `CLAUDE_AFK_COUNTDOWN_MS` | Wie viele Millisekunden vor dem Auto-Fortfahren der Countdown auf dem Bildschirm auf einem unbeantworteten [`AskUserQuestion`](/docs/de/tools-reference)-Dialog angezeigt wird. Standard `20000` (20 Sekunden), begrenzt durch das Auto-Fortfahren-Timeout. Hat keine Auswirkung, es sei denn, Auto-Fortfahren ist aktiviert; siehe die Einstellung [`askUserQuestionTimeout`](/docs/de/settings#available-settings) und `CLAUDE_AFK_TIMEOUT_MS`. Erfordert Claude Code v2.1.198 oder später |

154| `CLAUDE_AFK_TIMEOUT_MS` | {/* min-version: 2.1.198 */}Wie viele Millisekunden Leerlaufzeit, bevor ein unbeantworteter [`AskUserQuestion`](/de/tools-reference)-Dialog automatisch fortfährt, ohne Sie. {/* min-version: 2.1.200 */}Auto-Fortfahren ist standardmäßig aus; melden Sie sich mit der Einstellung [`askUserQuestionTimeout`](/de/settings#available-settings) an. Diese Variable ist eine Überschreibung für Demos und automatisierte Tests: Wenn gesetzt, hat sie Vorrang vor dieser Einstellung und schaltet Auto-Fortfahren ein, auch wenn die Einstellung nicht gesetzt oder `never` ist. Das Setzen von `0` schaltet das Timeout nicht aus; es schließt den Dialog sofort. In v2.1.198 und v2.1.199 war Auto-Fortfahren standardmäßig mit einem `60000` (60 Sekunden)-Timeout aktiviert. Erfordert Claude Code v2.1.198 oder später |154| `CLAUDE_AFK_TIMEOUT_MS` | Wie viele Millisekunden Leerlaufzeit, bevor ein unbeantworteter [`AskUserQuestion`](/docs/de/tools-reference)-Dialog automatisch fortfährt, ohne Sie. Auto-Fortfahren ist standardmäßig aus; melden Sie sich mit der Einstellung [`askUserQuestionTimeout`](/docs/de/settings#available-settings) an. Diese Variable ist eine Überschreibung für Demos und automatisierte Tests: Wenn gesetzt, hat sie Vorrang vor dieser Einstellung und schaltet Auto-Fortfahren ein, auch wenn die Einstellung nicht gesetzt oder `never` ist. Das Setzen von `0` schaltet das Timeout nicht aus; es schließt den Dialog sofort. In v2.1.198 und v2.1.199 war Auto-Fortfahren standardmäßig mit einem `60000` (60 Sekunden)-Timeout aktiviert. Erfordert Claude Code v2.1.198 oder später |

155| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Setzen Sie auf `1`, um alle integrierten [Subagenten](/de/sub-agents)-Typen wie Explore und Plan zu deaktivieren. Gilt nur im nicht-interaktiven Modus (das Flag `-p`). Nützlich für SDK-Benutzer, die eine leere Grundlage wünschen |155| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Setzen Sie auf `1`, um alle integrierten [Subagenten](/docs/de/sub-agents)-Typen wie Explore und Plan zu deaktivieren. Gilt nur im nicht-interaktiven Modus (das Flag `-p`). Nützlich für SDK-Benutzer, die eine leere Grundlage wünschen |

156| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Setzen Sie auf `1`, um das Präfix `mcp__<server>__` bei Tool-Namen von SDK-erstellten MCP-Servern zu überspringen. Tools verwenden ihre ursprünglichen Namen. Nur SDK-Verwendung |156| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Setzen Sie auf `1`, um das Präfix `mcp__<server>__` bei Tool-Namen von SDK-erstellten MCP-Servern zu überspringen. Tools verwenden ihre ursprünglichen Namen. Nur SDK-Verwendung |

157| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Stall-Timeout in Millisekunden für Hintergrund-Subagenten. Standard `600000` (10 Minuten). Der Timer wird bei jedem Streaming-Fortschrittsereignis zurückgesetzt; wenn kein Fortschritt innerhalb des Fensters ankommt, wird der Subagent abgebrochen und die Aufgabe als fehlgeschlagen markiert, wobei alle Teilergebnisse dem übergeordneten Element angezeigt werden |157| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Stall-Timeout in Millisekunden für Hintergrund-Subagenten. Standard `600000` (10 Minuten). Der Timer wird bei jedem Streaming-Fortschrittsereignis zurückgesetzt; wenn kein Fortschritt innerhalb des Fensters ankommt, wird der Subagent abgebrochen und die Aufgabe als fehlgeschlagen markiert, wobei alle Teilergebnisse dem übergeordneten Element angezeigt werden |

158| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Legen Sie den Prozentsatz (1-100) des Auto-Komprimierungsfensters fest, bei dem die Auto-Komprimierung ausgelöst wird. Verwenden Sie niedrigere Werte wie `50`, um früher zu komprimieren. Diese Variable verursacht nur frühere Komprimierung, wenn Claude Code proaktiv komprimiert: wenn `CLAUDE_CODE_AUTO_COMPACT_WINDOW` gesetzt ist, in [Cloud-Sitzungen](/de/claude-code-on-the-web) und auf Sonnet 4.6 und Opus 4.6 ohne [erweiterten Kontext](/de/model-config#extended-context), die standardmäßig bei der 200K-Grenze komprimieren. Auf Sonnet 5 gilt proaktive Komprimierung beim [Standard-Schwellenwert](/de/model-config#sonnet-5-context-window) des Modells. In anderen Fällen, wie z. B. einer lokalen Sitzung auf Opus 4.8, wird die Auto-Komprimierung ausgelöst, wenn die Konversation das Kontextlimit des Modells erreicht. Die Überschreibung kann nur den Schwellenwert senken, daher haben Werte über dem Standard keine Auswirkung. Gilt für Hauptkonversationen und Subagenten |158| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Legen Sie den Prozentsatz (1-100) des Auto-Komprimierungsfensters fest, bei dem die Auto-Komprimierung ausgelöst wird. Verwenden Sie niedrigere Werte wie `50`, um früher zu komprimieren. Diese Variable verursacht nur frühere Komprimierung, wenn Claude Code proaktiv komprimiert: wenn `CLAUDE_CODE_AUTO_COMPACT_WINDOW` gesetzt ist, in [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) und auf Sonnet 4.6 und Opus 4.6 ohne [erweiterten Kontext](/docs/de/model-config#extended-context), die standardmäßig bei der 200K-Grenze komprimieren. Auf Sonnet 5 gilt proaktive Komprimierung beim [Standard-Schwellenwert](/docs/de/model-config#sonnet-5-context-window) des Modells. In anderen Fällen, wie z. B. einer lokalen Sitzung auf Opus 4.8, wird die Auto-Komprimierung ausgelöst, wenn die Konversation das Kontextlimit des Modells erreicht. Die Überschreibung kann nur den Schwellenwert senken, daher haben Werte über dem Standard keine Auswirkung. Gilt für Hauptkonversationen und Subagenten |

159| `CLAUDE_AUTO_BACKGROUND_TASKS` | Setzen Sie auf `1`, um die automatische Hintergrund-Ausführung von lang laufenden Agent-Aufgaben zu erzwingen. Wenn aktiviert, werden Subagenten nach etwa zwei Minuten Laufzeit in den Hintergrund verschoben |159| `CLAUDE_AUTO_BACKGROUND_TASKS` | Setzen Sie auf `1`, um die automatische Hintergrund-Ausführung von lang laufenden Agent-Aufgaben zu erzwingen. Wenn aktiviert, werden Subagenten nach etwa zwei Minuten Laufzeit in den Hintergrund verschoben |

160| `CLAUDE_AX_SCREEN_READER` | {/* min-version: 2.1.181 */}Setzen Sie auf `1`, um bildschirmleserfreundliche Ausgabe zu rendern: flacher Text ohne dekorative Rahmen oder Animationen. Setzen Sie auf `0`, um den Bildschirmlesermodus zu deaktivieren, auch wenn [`axScreenReader`](/de/settings#available-settings) `true` ist. Das Flag [`--ax-screen-reader`](/de/cli-reference#cli-flags) hat Vorrang. Erfordert Claude Code v2.1.181 oder später |160| `CLAUDE_AX_SCREEN_READER` | Setzen Sie auf `1`, um bildschirmleserfreundliche Ausgabe zu rendern: flacher Text ohne dekorative Rahmen oder Animationen. Setzen Sie auf `0`, um den Bildschirmlesermodus zu deaktivieren, auch wenn [`axScreenReader`](/docs/de/settings#available-settings) `true` ist. Das Flag [`--ax-screen-reader`](/docs/de/cli-reference#cli-flags) hat Vorrang. Erfordert Claude Code v2.1.181 oder später |

161| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Kehren Sie nach jedem Bash- oder PowerShell-Befehl in der Hauptsitzung zum ursprünglichen Arbeitsverzeichnis zurück |161| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Kehren Sie nach jedem Bash- oder PowerShell-Befehl in der Hauptsitzung zum ursprünglichen Arbeitsverzeichnis zurück |

162| `CLAUDE_CLIENT_PRESENCE_FILE` | {/* min-version: 2.1.181 */}Pfad zu einer Datei, die ein externes Tool, wie z. B. ein Bildschirmsperr-Listener, erstellt, wenn Sie Ihren Bildschirm entsperren, und löscht, wenn Sie ihn sperren. Während die Datei vorhanden ist, überspringt Claude Code [Remote Control Mobile Push-Benachrichtigungen](/de/remote-control#mobile-push-notifications), sodass Sie keine Pushes mehr erhalten, während Sie den Computer aktiv nutzen. Wenn die Datei fehlt oder nicht lesbar ist, werden Benachrichtigungen normal gesendet. Claude Code überprüft die Datei einmal pro Push-auslösendem Ereignis, anstatt sie abzufragen. Erfordert Claude Code v2.1.181 oder später |162| `CLAUDE_CLIENT_PRESENCE_FILE` | Pfad zu einer Datei, die ein externes Tool, wie z. B. ein Bildschirmsperr-Listener, erstellt, wenn Sie Ihren Bildschirm entsperren, und löscht, wenn Sie ihn sperren. Während die Datei vorhanden ist, überspringt Claude Code [Remote Control Mobile Push-Benachrichtigungen](/docs/de/remote-control#mobile-push-notifications), sodass Sie keine Pushes mehr erhalten, während Sie den Computer aktiv nutzen. Wenn die Datei fehlt oder nicht lesbar ist, werden Benachrichtigungen normal gesendet. Claude Code überprüft die Datei einmal pro Push-auslösendem Ereignis, anstatt sie abzufragen. Erfordert Claude Code v2.1.181 oder später |

163| `CLAUDE_CODE_ACCESSIBILITY` | Setzen Sie auf `1`, um den nativen Terminal-Cursor sichtbar zu halten und den invertierten Text-Cursor-Indikator zu deaktivieren. Ermöglicht Bildschirmlupenfunktionen wie macOS Zoom, die Cursor-Position zu verfolgen |163| `CLAUDE_CODE_ACCESSIBILITY` | Setzen Sie auf `1`, um den nativen Terminal-Cursor sichtbar zu halten und den invertierten Text-Cursor-Indikator zu deaktivieren. Ermöglicht Bildschirmlupenfunktionen wie macOS Zoom, die Cursor-Position zu verfolgen |

164| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Setzen Sie auf `1`, um Speicherdateien aus Verzeichnissen zu laden, die mit `--add-dir` angegeben sind. Lädt `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` und `CLAUDE.local.md`. Standardmäßig laden zusätzliche Verzeichnisse keine Speicherdateien |164| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Setzen Sie auf `1`, um Speicherdateien aus Verzeichnissen zu laden, die mit `--add-dir` angegeben sind. Lädt `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` und `CLAUDE.local.md`. Standardmäßig laden zusätzliche Verzeichnisse keine Speicherdateien |

165| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Setzen Sie auf `1`, um den gesamten Bildschirm bei jedem Frame in der [Vollbilddarstellung](/de/fullscreen) neu zu zeichnen, anstatt inkrementelle Updates zu senden. Verwenden Sie dies, wenn der Vollbildmodus veraltete oder falsch platzierte Textfragmente anzeigt. Claude Code aktiviert dies automatisch für Hintergrund-Sitzungen und [Agent-Ansicht](/de/agent-view) unter Windows |165| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Setzen Sie auf `1`, um den gesamten Bildschirm bei jedem Frame in der [Vollbilddarstellung](/docs/de/fullscreen) neu zu zeichnen, anstatt inkrementelle Updates zu senden. Verwenden Sie dies, wenn der Vollbildmodus veraltete oder falsch platzierte Textfragmente anzeigt. Claude Code aktiviert dies automatisch für Hintergrund-Sitzungen und [Agent-Ansicht](/docs/de/agent-view) unter Windows |

166| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Setzen Sie auf `1`, um den [Effort](/de/model-config#adjust-effort-level)-Parameter mit jeder Anfrage zu senden, auch wenn Claude Code die Modell-ID nicht als Effort-fähig erkennt. Verwenden Sie dies beim Routing durch ein [LLM-Gateway](/de/llm-gateway) oder Drittanbieter-Provider, der Modelle unter benutzerdefinierten Bezeichnern bereitstellt. Modelle, die den Effort-Parameter bei der API ablehnen, einschließlich Claude 3-Modelle, Sonnet 4.0 und 4.5, Opus 4.0 und 4.1 sowie Haiku 4.5, sind weiterhin ausgeschlossen, sodass Anfragen nicht fehlschlagen |166| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Setzen Sie auf `1`, um den [Effort](/docs/de/model-config#adjust-effort-level)-Parameter mit jeder Anfrage zu senden, auch wenn Claude Code die Modell-ID nicht als Effort-fähig erkennt. Verwenden Sie dies beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway) oder Drittanbieter-Provider, der Modelle unter benutzerdefinierten Bezeichnern bereitstellt. Modelle, die den Effort-Parameter bei der API ablehnen, einschließlich Claude 3-Modelle, Sonnet 4.0 und 4.5, Opus 4.0 und 4.1 sowie Haiku 4.5, sind weiterhin ausgeschlossen, sodass Anfragen nicht fehlschlagen |

167| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervall in Millisekunden, in dem Anmeldedaten aktualisiert werden sollten (bei Verwendung von [`apiKeyHelper`](/de/settings#available-settings)) |167| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervall in Millisekunden, in dem Anmeldedaten aktualisiert werden sollten (bei Verwendung von [`apiKeyHelper`](/docs/de/settings#available-settings)) |

168| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Setzen Sie auf `0`, um Claude Code davon abzuhalten, den Browser automatisch zu öffnen, wenn ein neues [Artefakt](/de/artifacts) veröffentlicht wird. Das erneute Veröffentlichen eines vorhandenen Artefakts öffnet den Browser unabhängig von dieser Einstellung nicht |168| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Setzen Sie auf `0`, um Claude Code davon abzuhalten, den Browser automatisch zu öffnen, wenn ein neues [Artefakt](/docs/de/artifacts) veröffentlicht wird. Das erneute Veröffentlichen eines vorhandenen Artefakts öffnet den Browser unabhängig von dieser Einstellung nicht |

169| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Setzen Sie auf `0`, um den Attributionsblock (Client-Version und Prompt-Fingerabdruck) vom Anfang des System-Prompts wegzulassen. Das Deaktivieren verbessert die Prompt-Cache-Hit-Raten beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Anthropic API-Caching ist nicht betroffen |169| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Setzen Sie auf `0`, um den Attributionsblock (Client-Version und Prompt-Fingerabdruck) vom Anfang des System-Prompts wegzulassen. Das Deaktivieren verbessert die Prompt-Cache-Hit-Raten beim Routing durch ein [LLM-Gateway](/docs/de/llm-gateway). Anthropic API-Caching ist nicht betroffen |

170| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Legen Sie die Kontextkapazität in Token fest, die für Berechnungen der automatischen Komprimierung verwendet wird. Standardmäßig das Kontextfenster des Modells: 200K für Standard-Modelle oder 1M für [erweiterte Kontext](/de/model-config#extended-context)-Modelle, außer auf Sonnet 5, das seinen eigenen [Standard-Schwellenwert](/de/model-config#sonnet-5-context-window) hat. Verwenden Sie einen niedrigeren Wert wie `500000` auf einem 1M-Modell, um das Fenster für Komprimierungszwecke als 500K zu behandeln. Der Wert ist auf das tatsächliche Kontextfenster des Modells begrenzt. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` wird als Prozentsatz dieses Wertes angewendet. Das Setzen dieser Variablen entkoppelt den Komprimierungsschwellenwert von der `used_percentage` der Statuszeile, die immer das vollständige Kontextfenster des Modells verwendet |170| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Legen Sie die Kontextkapazität in Token fest, die für Berechnungen der automatischen Komprimierung verwendet wird. Standardmäßig das Kontextfenster des Modells: 200K für Standard-Modelle oder 1M für [erweiterte Kontext](/docs/de/model-config#extended-context)-Modelle, außer auf Sonnet 5, das seinen eigenen [Standard-Schwellenwert](/docs/de/model-config#sonnet-5-context-window) hat. Verwenden Sie einen niedrigeren Wert wie `500000` auf einem 1M-Modell, um das Fenster für Komprimierungszwecke als 500K zu behandeln. Der Wert ist auf das tatsächliche Kontextfenster des Modells begrenzt. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` wird als Prozentsatz dieses Wertes angewendet. Das Setzen dieser Variablen entkoppelt den Komprimierungsschwellenwert von der `used_percentage` der Statuszeile, die immer das vollständige Kontextfenster des Modells verwendet |

171| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Überschreiben Sie die automatische [IDE-Verbindung](/de/vs-code). Standardmäßig verbindet sich Claude Code automatisch, wenn es im integrierten Terminal einer unterstützten IDE gestartet wird. Setzen Sie auf `false`, um dies zu verhindern. Setzen Sie auf `true`, um eine Verbindung zu erzwingen, wenn die automatische Erkennung fehlschlägt, z. B. wenn tmux das übergeordnete Terminal verdeckt. Hat Vorrang vor der Einstellung [`autoConnectIde`](/de/settings#global-config-settings) |171| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Überschreiben Sie die automatische [IDE-Verbindung](/docs/de/vs-code). Standardmäßig verbindet sich Claude Code automatisch, wenn es im integrierten Terminal einer unterstützten IDE gestartet wird. Setzen Sie auf `false`, um dies zu verhindern. Setzen Sie auf `true`, um eine Verbindung zu erzwingen, wenn die automatische Erkennung fehlschlägt, z. B. wenn tmux das übergeordnete Terminal verdeckt. Hat Vorrang vor der Einstellung [`autoConnectIde`](/docs/de/settings#global-config-settings) |

172| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | {/* min-version: 2.1.207 */}Zeit in Millisekunden, die Claude Code auf die AWS-Standard-Anmeldedatenkette wartet, um Anmeldedaten zu produzieren, bevor die Anfrage mit [`AWS default-chain credential resolve timed out`](/de/errors#aws-default-chain-credential-resolve-timed-out) fehlschlägt (Standard: `60000`). Erhöhen Sie dies, wenn ein Schritt in Ihrer Kette legitim länger benötigt, z. B. eine Browser-basierte SSO-Anmeldung mit MFA über einen Wrapper wie `aws-vault`. Gilt überall dort, wo Claude Code mit der Standard-Kette signiert: [Amazon Bedrock](/de/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/de/claude-platform-on-aws) und der [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint). Erfordert Claude Code v2.1.207 oder später |172| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Zeit in Millisekunden, die Claude Code auf die AWS-Standard-Anmeldedatenkette wartet, um Anmeldedaten zu produzieren, bevor die Anfrage mit [`AWS default-chain credential resolve timed out`](/docs/de/errors#aws-default-chain-credential-resolve-timed-out) fehlschlägt (Standard: `60000`). Erhöhen Sie dies, wenn ein Schritt in Ihrer Kette legitim länger benötigt, z. B. eine Browser-basierte SSO-Anmeldung mit MFA über einen Wrapper wie `aws-vault`. Gilt überall dort, wo Claude Code mit der Standard-Kette signiert: [Amazon Bedrock](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und der [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint). Erfordert Claude Code v2.1.207 oder später |

173| `CLAUDE_CODE_BRIDGE_SESSION_ID` | {/* min-version: 2.1.199 */}Wird automatisch in Bash-Tool- und [Hook-Befehls](/de/hooks)-Subprozessen gesetzt, während die Sitzung eine aktive [Remote Control](/de/remote-control)-Verbindung hat, und entfernt, wenn die Verbindung endet. Der Wert ist die Sitzungs-ID in `session_`-Form, der gleiche Bezeichner, der in der `claude.ai/code`-URL der Sitzung angezeigt wird, sodass ein Skript zurück zur Sitzung, die es ausgeführt hat, verlinken kann. Erfordert Claude Code v2.1.199 oder später. Lesen Sie in [Cloud-Sitzungen](/de/claude-code-on-the-web) stattdessen `CLAUDE_CODE_REMOTE_SESSION_ID` |173| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Wird automatisch in Bash-Tool- und [Hook-Befehls](/docs/de/hooks)-Subprozessen gesetzt, während die Sitzung eine aktive [Remote Control](/docs/de/remote-control)-Verbindung hat, und entfernt, wenn die Verbindung endet. Der Wert ist die Sitzungs-ID in `session_`-Form, der gleiche Bezeichner, der in der `claude.ai/code`-URL der Sitzung angezeigt wird, sodass ein Skript zurück zur Sitzung, die es ausgeführt hat, verlinken kann. Erfordert Claude Code v2.1.199 oder später. Lesen Sie in [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) stattdessen `CLAUDE_CODE_REMOTE_SESSION_ID` |

174| `CLAUDE_CODE_CERT_STORE` | Kommagetrennte Liste von CA-Zertifikatquellen für TLS-Verbindungen. `bundled` ist der Mozilla CA-Satz, der mit Claude Code ausgeliefert wird. `system` ist der Betriebssystem-Vertrauensspeicher, schreibgeschützt auf Runtimes mit `tls.getCACertificates`: die native Binärdatei oder Node 22.15 oder später für npm-Installationen. Siehe [CA-Zertifikatsspeicher](/de/network-config#ca-certificate-store). Standard ist `bundled,system` |174| `CLAUDE_CODE_CERT_STORE` | Kommagetrennte Liste von CA-Zertifikatquellen für TLS-Verbindungen. `bundled` ist der Mozilla CA-Satz, der mit Claude Code ausgeliefert wird. `system` ist der Betriebssystem-Vertrauensspeicher, schreibgeschützt auf Runtimes mit `tls.getCACertificates`: die native Binärdatei oder Node 22.15 oder später für npm-Installationen. Siehe [CA-Zertifikatsspeicher](/docs/de/network-config#ca-certificate-store). Standard ist `bundled,system` |

175| `CLAUDE_CODE_CHILD_SESSION` | {/* min-version: 2.1.172 */}Auf `1` in Subprozessen gesetzt, die Claude Code über die Bash-, PowerShell- und Monitor-Tools, [Hook](/de/hooks)-Befehle und [Statuszeilen](/de/statusline)-Befehle spawnt. Nicht gesetzt für stdio [MCP-Server](/de/mcp)-Subprozesse, die langlebig sind und die Sitzung, die sie gespawnt hat, überdauern. Im Gegensatz zu `CLAUDECODE` wird dies nur von Claude Codes eigenem Spawn-Pfad gesetzt und nicht von IDE-Erweiterungen, daher unterscheidet es zuverlässig eine verschachtelte Sitzung von einem Top-Level-`claude`, das in einem IDE-integrierten Terminal gestartet wird. Eine verschachtelte interaktive `claude` TUI, die auf diese Weise gestartet wird, wird automatisch von `--resume`, `--continue`, Up-Arrow-Verlauf und der `claude agents`-Liste ausgeschlossen. Nicht-interaktive `claude -p`-Sitzungen bleiben weiterhin bestehen. Setzen Sie `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, um diese Ausschließung zu überschreiben. Erfordert Claude Code v2.1.172 oder später |175| `CLAUDE_CODE_CHILD_SESSION` | Auf `1` in Subprozessen gesetzt, die Claude Code über die Bash-, PowerShell- und Monitor-Tools, [Hook](/docs/de/hooks)-Befehle und [Statuszeilen](/docs/de/statusline)-Befehle spawnt. Nicht gesetzt für stdio [MCP-Server](/docs/de/mcp)-Subprozesse, die langlebig sind und die Sitzung, die sie gespawnt hat, überdauern. Im Gegensatz zu `CLAUDECODE` wird dies nur von Claude Codes eigenem Spawn-Pfad gesetzt und nicht von IDE-Erweiterungen, daher unterscheidet es zuverlässig eine verschachtelte Sitzung von einem Top-Level-`claude`, das in einem IDE-integrierten Terminal gestartet wird. Eine verschachtelte interaktive `claude` TUI, die auf diese Weise gestartet wird, wird automatisch von `--resume`, `--continue`, Up-Arrow-Verlauf und der `claude agents`-Liste ausgeschlossen. Nicht-interaktive `claude -p`-Sitzungen bleiben weiterhin bestehen. Setzen Sie `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, um diese Ausschließung zu überschreiben. Erfordert Claude Code v2.1.172 oder später |

179| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | {/* max-version: 2.1.185 */}Entfernt in v2.1.186 und jetzt ein No-Op. Früher wurde ein separates Timeout für die Connect-, TLS- und Response-Header-Phase einer Streaming-API-Anfrage gesetzt. Verwenden Sie `API_TIMEOUT_MS` für das Pro-Request-Timeout |179| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Entfernt in v2.1.186 und jetzt ein No-Op. Früher wurde ein separates Timeout für die Connect-, TLS- und Response-Header-Phase einer Streaming-API-Anfrage gesetzt. Verwenden Sie `API_TIMEOUT_MS` für das Pro-Request-Timeout |

180| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Überschreiben Sie den Pfad der Debug-Protokolldatei. Trotz des Namens ist dies ein Dateipfad, kein Verzeichnis. Erfordert, dass der Debug-Modus separat über `--debug`, `/debug` oder die `DEBUG`-Umgebungsvariable aktiviert wird: Das Setzen dieser Variablen allein aktiviert keine Protokollierung. Das Flag [`--debug-file`](/de/cli-reference#cli-flags) macht beides auf einmal. Standardmäßig `~/.claude/debug/<session-id>.txt` |180| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Überschreiben Sie den Pfad der Debug-Protokolldatei. Trotz des Namens ist dies ein Dateipfad, kein Verzeichnis. Erfordert, dass der Debug-Modus separat über `--debug`, `/debug` oder die `DEBUG`-Umgebungsvariable aktiviert wird: Das Setzen dieser Variablen allein aktiviert keine Protokollierung. Das Flag [`--debug-file`](/docs/de/cli-reference#cli-flags) macht beides auf einmal. Standardmäßig `~/.claude/debug/<session-id>.txt` |

181| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Minimale Protokollierungsstufe, die in die Debug-Protokolldatei geschrieben wird. Werte: `verbose`, `debug` (Standard), `info`, `warn`, `error`. Setzen Sie auf `verbose`, um hochvolumige Diagnosen wie vollständige Statuszeilen-Befehlsausgabe einzubeziehen, oder erhöhen Sie auf `error`, um Rauschen zu reduzieren |181| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Minimale Protokollierungsstufe, die in die Debug-Protokolldatei geschrieben wird. Werte: `verbose`, `debug` (Standard), `info`, `warn`, `error`. Setzen Sie auf `verbose`, um hochvolumige Diagnosen wie vollständige Statuszeilen-Befehlsausgabe einzubeziehen, oder erhöhen Sie auf `error`, um Rauschen zu reduzieren |

182| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Setzen Sie auf `1`, um die Unterstützung des [1M-Kontextfensters](/de/model-config#extended-context) zu deaktivieren. Wenn gesetzt, sind 1M-Modellvarianten in der Modellauswahl nicht verfügbar, und [Sonnet 5](/de/model-config#sonnet-5-context-window)-Sitzungen werden als 200K-Fenster behandelt. Nützlich für Unternehmensumgebungen mit Compliance-Anforderungen |182| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Setzen Sie auf `1`, um die Unterstützung des [1M-Kontextfensters](/docs/de/model-config#extended-context) zu deaktivieren. Wenn gesetzt, sind 1M-Modellvarianten in der Modellauswahl nicht verfügbar, und [Sonnet 5](/docs/de/model-config#sonnet-5-context-window)-Sitzungen werden als 200K-Fenster behandelt. Nützlich für Unternehmensumgebungen mit Compliance-Anforderungen |

183| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Setzen Sie auf `1`, um [adaptives Denken](/de/model-config#adjust-effort-level) auf Opus 4.6 und Sonnet 4.6 zu deaktivieren und auf das feste Denk-Budget zurückzufallen, das von `MAX_THINKING_TOKENS` gesteuert wird. {/* min-version: 2.1.111 */}Ab v2.1.111 hat dies keine Auswirkung auf Fable 5, Sonnet 5 oder Opus 4.7 und später, die immer adaptives Denken verwenden |183| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Setzen Sie auf `1`, um [adaptives Denken](/docs/de/model-config#adjust-effort-level) auf Opus 4.6 und Sonnet 4.6 zu deaktivieren und auf das feste Denk-Budget zurückzufallen, das von `MAX_THINKING_TOKENS` gesteuert wird. Ab v2.1.111 hat dies keine Auswirkung auf Fable 5, Sonnet 5 oder Opus 4.7 und später, die immer adaptives Denken verwenden |

184| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Setzen Sie auf `1`, um das [Advisor-Tool](/de/advisor) zu deaktivieren. Der `/advisor`-Befehl wird nicht verfügbar, jedes konfigurierte `advisorModel` wird ignoriert, und das `--advisor`-Flag wird akzeptiert, hat aber keine Auswirkung, sodass vorhandene Skripte, die es übergeben, ohne Fehler weiterhin funktionieren |184| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Setzen Sie auf `1`, um das [Advisor-Tool](/docs/de/advisor) zu deaktivieren. Der `/advisor`-Befehl wird nicht verfügbar, jedes konfigurierte `advisorModel` wird ignoriert, und das `--advisor`-Flag wird akzeptiert, hat aber keine Auswirkung, sodass vorhandene Skripte, die es übergeben, ohne Fehler weiterhin funktionieren |

185| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Setzen Sie auf `1`, um [Hintergrund-Agenten und Agent-Ansicht](/de/agent-view) auszuschalten: `claude agents`, `--bg`, `/background` und den On-Demand-Supervisor. Äquivalent zur Einstellung [`disableAgentView`](/de/settings#available-settings) |185| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Setzen Sie auf `1`, um [Hintergrund-Agenten und Agent-Ansicht](/docs/de/agent-view) auszuschalten: `claude agents`, `--bg`, `/background` und den On-Demand-Supervisor. Äquivalent zur Einstellung [`disableAgentView`](/docs/de/settings#available-settings) |

186| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Setzen Sie auf `1`, um die [Vollbilddarstellung](/de/fullscreen) zu deaktivieren und den klassischen Hauptbildschirm-Renderer zu verwenden. Die Konversation bleibt in Ihrem nativen Terminal-Scrollback, sodass `Cmd+f` und tmux-Kopiermodus wie gewohnt funktionieren. Hat Vorrang vor `CLAUDE_CODE_NO_FLICKER` und der [`tui`](/de/settings#available-settings)-Einstellung. Sie können auch mit `/tui default` wechseln. Gilt nicht für Hintergrund-Sitzungen, die aus der [Agent-Ansicht](/de/agent-view) geöffnet werden, die immer Vollbilddarstellung verwenden |186| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Setzen Sie auf `1`, um die [Vollbilddarstellung](/docs/de/fullscreen) zu deaktivieren und den klassischen Hauptbildschirm-Renderer zu verwenden. Die Konversation bleibt in Ihrem nativen Terminal-Scrollback, sodass `Cmd+f` und tmux-Kopiermodus wie gewohnt funktionieren. Hat Vorrang vor `CLAUDE_CODE_NO_FLICKER` und der [`tui`](/docs/de/settings#available-settings)-Einstellung. Sie können auch mit `/tui default` wechseln. Gilt nicht für Hintergrund-Sitzungen, die aus der [Agent-Ansicht](/docs/de/agent-view) geöffnet werden, die immer Vollbilddarstellung verwenden |

187| `CLAUDE_CODE_DISABLE_ARTIFACT` | Setzen Sie auf `1`, um das [Artefakt](/de/artifacts)-Tool zu deaktivieren, das Sitzungsausgaben als private Webseite auf claude.ai veröffentlicht. Äquivalent zur Einstellung [`disableArtifact`](/de/settings#available-settings) |187| `CLAUDE_CODE_DISABLE_ARTIFACT` | Setzen Sie auf `1`, um das [Artefakt](/docs/de/artifacts)-Tool zu deaktivieren, das Sitzungsausgaben als private Webseite auf claude.ai veröffentlicht. Äquivalent zur Einstellung [`disableArtifact`](/docs/de/settings#available-settings) |

188| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Setzen Sie auf `1`, um die Verarbeitung von Anhängen zu deaktivieren. Dateierweiterungen mit `@`-Syntax werden als Klartext gesendet, anstatt in Dateiinhalte erweitert zu werden |188| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Setzen Sie auf `1`, um die Verarbeitung von Anhängen zu deaktivieren. Dateierweiterungen mit `@`-Syntax werden als Klartext gesendet, anstatt in Dateiinhalte erweitert zu werden |

189| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Setzen Sie auf `1`, um [automatisches Speichern](/de/memory#auto-memory) zu deaktivieren. Setzen Sie auf `0`, um automatisches Speichern zu erzwingen, auch wenn `--bare`-Modus oder [`autoMemoryEnabled: false`](/de/settings#available-settings) es ansonsten deaktivieren würde. Wenn deaktiviert, erstellt oder lädt Claude keine automatischen Speicherdateien |189| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Setzen Sie auf `1`, um [automatisches Speichern](/docs/de/memory#auto-memory) zu deaktivieren. Setzen Sie auf `0`, um automatisches Speichern zu erzwingen, auch wenn `--bare`-Modus oder [`autoMemoryEnabled: false`](/docs/de/settings#available-settings) es ansonsten deaktivieren würde. Wenn deaktiviert, erstellt oder lädt Claude keine automatischen Speicherdateien |

190| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie auf `1`, um alle Hintergrundaufgaben-Funktionalität zu deaktivieren, einschließlich des Parameters `run_in_background` auf Bash- und Subagenten-Tools, automatisches Hintergrund-Ausführen und die Strg+B-Verknüpfung |190| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Setzen Sie auf `1`, um alle Hintergrundaufgaben-Funktionalität zu deaktivieren, einschließlich des Parameters `run_in_background` auf Bash- und Subagenten-Tools, automatisches Hintergrund-Ausführen und die Strg+B-Verknüpfung |

191| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | {/* min-version: 2.1.208 */}Setzen Sie auf `1`, um die Überprüfung zu überspringen, dass eine [Amazon Bedrock](/de/amazon-bedrock)-Streaming-Antwort den `application/vnd.amazon.eventstream`-Content-Type trägt. Ohne diese Variable schlägt eine Antwort mit einem anderen Content-Type mit einem Fehler fehl, der diesen Content-Type benennt, was bedeutet, dass ein [Gateway oder Proxy die Antwort transformiert](/de/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Setzen Sie es nur, wenn das Gateway den `Content-Type`-Header umschreibt, aber den binären Event-Stream-Body unverändert durchleitet; wenn der Body selbst transformiert wurde, schlagen Anfragen stattdessen mit `Truncated event message received` fehl. Erfordert Claude Code v2.1.208 oder später |191| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Setzen Sie auf `1`, um die Überprüfung zu überspringen, dass eine [Amazon Bedrock](/docs/de/amazon-bedrock)-Streaming-Antwort den `application/vnd.amazon.eventstream`-Content-Type trägt. Ohne diese Variable schlägt eine Antwort mit einem anderen Content-Type mit einem Fehler fehl, der diesen Content-Type benennt, was bedeutet, dass ein [Gateway oder Proxy die Antwort transformiert](/docs/de/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Setzen Sie es nur, wenn das Gateway den `Content-Type`-Header umschreibt, aber den binären Event-Stream-Body unverändert durchleitet; wenn der Body selbst transformiert wurde, schlagen Anfragen stattdessen mit `Truncated event message received` fehl. Erfordert Claude Code v2.1.208 oder später |

192| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}Setzen Sie auf `1`, um in-flight Hintergrundarbeit zu stoppen, anstatt sie zu übernehmen, wenn der [Supervisor](/de/agent-view#the-supervisor-process) eine [Hintergrund-Sitzung](/de/agent-view) stoppt, neu startet oder den Prozess dieser Sitzung aktualisiert, anstatt sie an den nächsten Prozess der Sitzung zu übergeben. Betrifft nur diese Übergabe: Das Verschieben einer Sitzung mit `←` oder [`/background`](/de/agent-view#from-inside-a-session) trägt weiterhin in-flight-Arbeit über, und `CLAUDE_DISABLE_ADOPT` schaltet beide aus. Erfordert Claude Code v2.1.196 oder später |192| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Setzen Sie auf `1`, um in-flight Hintergrundarbeit zu stoppen, anstatt sie zu übernehmen, wenn der [Supervisor](/docs/de/agent-view#the-supervisor-process) eine [Hintergrund-Sitzung](/docs/de/agent-view) stoppt, neu startet oder den Prozess dieser Sitzung aktualisiert, anstatt sie an den nächsten Prozess der Sitzung zu übergeben. Betrifft nur diese Übergabe: Das Verschieben einer Sitzung mit `←` oder [`/background`](/docs/de/agent-view#from-inside-a-session) trägt weiterhin in-flight-Arbeit über, und `CLAUDE_DISABLE_ADOPT` schaltet beide aus. Erfordert Claude Code v2.1.196 oder später |

193| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}Setzen Sie auf `1`, um Claude Code davon abzuhalten, [Hintergrund-Shell-Befehle](/de/interactive-mode#background-bash-commands) zu beenden, wenn das Betriebssystem Speicherdruck meldet. Standardmäßig beendet Claude Code auf macOS und Linux eine im Hauptsitzung gestartete Hintergrund-Shell bei einem Speicherdruck-Signal, sobald die Sitzung 30 Minuten untätig war und kein Turn oder Subagent ausgeführt wird. Windows hat kein Speicherdruck-Signal, daher hat diese Variable dort keine Auswirkung. Erfordert Claude Code v2.1.193 oder später |193| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Setzen Sie auf `1`, um Claude Code davon abzuhalten, [Hintergrund-Shell-Befehle](/docs/de/interactive-mode#background-bash-commands) zu beenden, wenn das Betriebssystem Speicherdruck meldet. Standardmäßig beendet Claude Code auf macOS und Linux eine im Hauptsitzung gestartete Hintergrund-Shell bei einem Speicherdruck-Signal, sobald die Sitzung 30 Minuten untätig war und kein Turn oder Subagent ausgeführt wird. Windows hat kein Speicherdruck-Signal, daher hat diese Variable dort keine Auswirkung. Erfordert Claude Code v2.1.193 oder später |

194| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Setzen Sie auf `1`, um die [Skills](/de/skills) und Workflows zu deaktivieren, die mit Claude Code ausgeliefert werden: Gebündelte Skills und Workflows werden vollständig entfernt, während integrierte Slash-Befehle wie `/init` tippbar bleiben, aber vom Modell ausgeblendet werden. Skills von Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Äquivalent zur Einstellung [`disableBundledSkills`](/de/settings#available-settings); `0` überschreibt sie nicht |194| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Setzen Sie auf `1`, um die [Skills](/docs/de/skills) und Workflows zu deaktivieren, die mit Claude Code ausgeliefert werden: Gebündelte Skills und Workflows werden vollständig entfernt, während integrierte Slash-Befehle wie `/init` tippbar bleiben, aber vom Modell ausgeblendet werden. Skills von Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Äquivalent zur Einstellung [`disableBundledSkills`](/docs/de/settings#available-settings); `0` überschreibt sie nicht |

195| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Setzen Sie auf `1`, um das Laden von CLAUDE.md-Speicherdateien in den Kontext zu verhindern, einschließlich Benutzer-, Projekt- und automatischen Speicherdateien |195| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Setzen Sie auf `1`, um das Laden von CLAUDE.md-Speicherdateien in den Kontext zu verhindern, einschließlich Benutzer-, Projekt- und automatischen Speicherdateien |

196| `CLAUDE_CODE_DISABLE_CRON` | Setzen Sie auf `1`, um [geplante Aufgaben](/de/scheduled-tasks) zu deaktivieren. Der `/loop`-Skill und Cron-Tools werden nicht verfügbar und alle bereits geplanten Aufgaben werden nicht mehr ausgelöst, einschließlich Aufgaben, die bereits während der Sitzung ausgeführt werden |196| `CLAUDE_CODE_DISABLE_CRON` | Setzen Sie auf `1`, um [geplante Aufgaben](/docs/de/scheduled-tasks) zu deaktivieren. Der `/loop`-Skill und Cron-Tools werden nicht verfügbar und alle bereits geplanten Aufgaben werden nicht mehr ausgelöst, einschließlich Aufgaben, die bereits während der Sitzung ausgeführt werden |

197| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Setzen Sie auf `1`, um Anthropic-spezifische `anthropic-beta`-Request-Header und Beta-Tool-Schema-Felder (wie `defer_loading` und `eager_input_streaming`) aus API-Anfragen zu entfernen. Verwenden Sie dies, wenn ein Proxy-Gateway Anfragen mit Fehlern wie „Unexpected value(s) for the `anthropic-beta` header" oder „Extra inputs are not permitted" ablehnt. Standard-Felder (`name`, `description`, `input_schema`, `cache_control`) werden beibehalten. [MCP-Tool-Suche](/de/mcp#scale-with-mcp-tool-search) ist deaktiviert und alle MCP-Tools werden upfront geladen, auch wenn `ENABLE_TOOL_SEARCH` gesetzt ist |197| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Setzen Sie auf `1`, um Anthropic-spezifische `anthropic-beta`-Request-Header und Beta-Tool-Schema-Felder (wie `defer_loading` und `eager_input_streaming`) aus API-Anfragen zu entfernen. Verwenden Sie dies, wenn ein Proxy-Gateway Anfragen mit Fehlern wie „Unexpected value(s) for the `anthropic-beta` header" oder „Extra inputs are not permitted" ablehnt. Standard-Felder (`name`, `description`, `input_schema`, `cache_control`) werden beibehalten. [MCP-Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) ist deaktiviert und alle MCP-Tools werden upfront geladen, auch wenn `ENABLE_TOOL_SEARCH` gesetzt ist |

198| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | {/* min-version: 2.1.198 */}Setzen Sie auf `1`, um die integrierten [Explore und Plan Subagenten](/de/sub-agents#built-in-subagents) zu deaktivieren. Claude erkundet mit seinen Such-Tools oder dem allgemeinen Subagenten, und [Plan-Modus](/de/permission-modes#analyze-before-you-edit-with-plan-mode) liest Dateien direkt, anstatt Explore und Plan Agenten zu starten. Benutzerdefinierte Subagenten mit dem Namen `Explore` oder `Plan` sind nicht betroffen. Um jeden integrierten Subagenten-Typ im Agent SDK oder nicht-interaktiven Modus zu entfernen, verwenden Sie stattdessen `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Erfordert Claude Code v2.1.198 oder später |198| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Setzen Sie auf `1`, um die integrierten [Explore und Plan Subagenten](/docs/de/sub-agents#built-in-subagents) zu deaktivieren. Claude erkundet mit seinen Such-Tools oder dem allgemeinen Subagenten, und [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) liest Dateien direkt, anstatt Explore und Plan Agenten zu starten. Benutzerdefinierte Subagenten mit dem Namen `Explore` oder `Plan` sind nicht betroffen. Um jeden integrierten Subagenten-Typ im Agent SDK oder nicht-interaktiven Modus zu entfernen, verwenden Sie stattdessen `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Erfordert Claude Code v2.1.198 oder später |

200| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Setzen Sie auf `1`, um die Umfragen zur Sitzungsqualität „Wie läuft es mit Claude?" zu deaktivieren. Umfragen werden auch deaktiviert, wenn `DISABLE_TELEMETRY`, `DO_NOT_TRACK` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` gesetzt ist, es sei denn, `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` meldet sich wieder an. Um stattdessen eine Stichprobenquote festzulegen, verwenden Sie die Einstellung [`feedbackSurveyRate`](/de/settings#available-settings). Siehe [Umfragen zur Sitzungsqualität](/de/data-usage#session-quality-surveys) |200| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Setzen Sie auf `1`, um die Umfragen zur Sitzungsqualität „Wie läuft es mit Claude?" zu deaktivieren. Umfragen werden auch deaktiviert, wenn `DISABLE_TELEMETRY`, `DO_NOT_TRACK` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` gesetzt ist, es sei denn, `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` meldet sich wieder an. Um stattdessen eine Stichprobenquote festzulegen, verwenden Sie die Einstellung [`feedbackSurveyRate`](/docs/de/settings#available-settings). Siehe [Umfragen zur Sitzungsqualität](/docs/de/data-usage#session-quality-surveys) |

201| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Setzen Sie auf `1`, um Datei-[Checkpointing](/de/checkpointing) zu deaktivieren. Der `/rewind`-Befehl kann keine Code-Änderungen wiederherstellen |201| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Setzen Sie auf `1`, um Datei-[Checkpointing](/docs/de/checkpointing) zu deaktivieren. Der `/rewind`-Befehl kann keine Code-Änderungen wiederherstellen |

202| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Setzen Sie auf `1`, um integrierte Commit- und PR-Workflow-Anweisungen und den Git-Status-Snapshot aus Claudes System-Prompt zu entfernen. Nützlich bei Verwendung eigener Git-Workflow-Skills. Hat Vorrang vor der Einstellung [`includeGitInstructions`](/de/settings#available-settings), wenn gesetzt |202| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Setzen Sie auf `1`, um integrierte Commit- und PR-Workflow-Anweisungen und den Git-Status-Snapshot aus Claudes System-Prompt zu entfernen. Nützlich bei Verwendung eigener Git-Workflow-Skills. Hat Vorrang vor der Einstellung [`includeGitInstructions`](/docs/de/settings#available-settings), wenn gesetzt |

203| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Setzen Sie auf `1`, um die automatische Umleitung von Opus 4.0 und 4.1 zur aktuellen Opus-Version auf der Anthropic API zu verhindern. Verwenden Sie, wenn Sie absichtlich ein älteres Modell fixieren möchten. Die Umleitung wird nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry ausgeführt |203| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Setzen Sie auf `1`, um die automatische Umleitung von Opus 4.0 und 4.1 zur aktuellen Opus-Version auf der Anthropic API zu verhindern. Verwenden Sie, wenn Sie absichtlich ein älteres Modell fixieren möchten. Die Umleitung wird nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry ausgeführt |

204| `CLAUDE_CODE_DISABLE_MOUSE` | Setzen Sie auf `1`, um die Mausverfolgung in der [Vollbilddarstellung](/de/fullscreen) zu deaktivieren. Tastaturscrolling mit `PgUp` und `PgDn` funktioniert weiterhin. Verwenden Sie dies, um das native Kopieren-beim-Auswählen-Verhalten Ihres Terminals beizubehalten |204| `CLAUDE_CODE_DISABLE_MOUSE` | Setzen Sie auf `1`, um die Mausverfolgung in der [Vollbilddarstellung](/docs/de/fullscreen) zu deaktivieren. Tastaturscrolling mit `PgUp` und `PgDn` funktioniert weiterhin. Verwenden Sie dies, um das native Kopieren-beim-Auswählen-Verhalten Ihres Terminals beizubehalten |

205| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | {/* min-version: 2.1.195 */}Setzen Sie auf `1`, um Click-, Drag- und Hover-Handling in der [Vollbilddarstellung](/de/fullscreen) zu deaktivieren, während Sie das Mausrad-Scrolling behalten. Verwenden Sie dies, wenn Sie möchten, dass das Rad-Scroll in Claude Code funktioniert, aber Sie nicht möchten, dass Klicks den Cursor positionieren, Tool-Ausgabe erweitern oder Links öffnen. `CLAUDE_CODE_DISABLE_MOUSE` hat Vorrang, wenn beide gesetzt sind. Erfordert Claude Code v2.1.195 oder später |205| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Setzen Sie auf `1`, um Click-, Drag- und Hover-Handling in der [Vollbilddarstellung](/docs/de/fullscreen) zu deaktivieren, während Sie das Mausrad-Scrolling behalten. Verwenden Sie dies, wenn Sie möchten, dass das Rad-Scroll in Claude Code funktioniert, aber Sie nicht möchten, dass Klicks den Cursor positionieren, Tool-Ausgabe erweitern oder Links öffnen. `CLAUDE_CODE_DISABLE_MOUSE` hat Vorrang, wenn beide gesetzt sind. Erfordert Claude Code v2.1.195 oder später |

206| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Äquivalent zum Setzen von `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` und `DISABLE_TELEMETRY` |206| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Äquivalent zum Setzen von `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` und `DISABLE_TELEMETRY` |

207| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Setzen Sie auf `1`, um das Fallback ohne Streaming zu deaktivieren, wenn eine Streaming-Anfrage mitten im Stream fehlschlägt. Streaming-Fehler werden stattdessen an die Wiederholungsebene weitergeleitet. Nützlich, wenn ein Proxy oder Gateway das Fallback dazu führt, dass doppelte Tool-Ausführungen entstehen |207| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Setzen Sie auf `1`, um das Fallback ohne Streaming zu deaktivieren, wenn eine Streaming-Anfrage mitten im Stream fehlschlägt. Streaming-Fehler werden stattdessen an die Wiederholungsebene weitergeleitet. Nützlich, wenn ein Proxy oder Gateway das Fallback dazu führt, dass doppelte Tool-Ausführungen entstehen |

208| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | {/* min-version: 2.1.193 */}Setzen Sie auf `1`, um die Desktop-Benachrichtigung des `PushNotification`-Tools zu senden, auch während Sie im Terminal tippen oder es fokussieren. Standardmäßig überspringt das Tool sowohl die Desktop-Benachrichtigung als auch den [Mobile Push](/de/remote-control#mobile-push-notifications), wenn es kürzliche Tastaturaktivität oder Terminal-Fokus erkennt. Diese Variable deaktiviert nur diese lokale Überprüfung, sodass der Server den Mobile Push weiterhin unterdrücken kann, wenn er erkennt, dass Sie aktiv sind. Erfordert Claude Code v2.1.193 oder später |208| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Setzen Sie auf `1`, um die Desktop-Benachrichtigung des `PushNotification`-Tools zu senden, auch während Sie im Terminal tippen oder es fokussieren. Standardmäßig überspringt das Tool sowohl die Desktop-Benachrichtigung als auch den [Mobile Push](/docs/de/remote-control#mobile-push-notifications), wenn es kürzliche Tastaturaktivität oder Terminal-Fokus erkennt. Diese Variable deaktiviert nur diese lokale Überprüfung, sodass der Server den Mobile Push weiterhin unterdrücken kann, wenn er erkennt, dass Sie aktiv sind. Erfordert Claude Code v2.1.193 oder später |

209| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Setzen Sie auf `1`, um die automatische Hinzufügung des offiziellen Plugin-Marketplace beim ersten Start zu überspringen |209| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Setzen Sie auf `1`, um die automatische Hinzufügung des offiziellen Plugin-Marketplace beim ersten Start zu überspringen |

210| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Setzen Sie auf `1`, um das Laden von Skills aus dem systemweiten verwalteten Skills-Verzeichnis zu überspringen. Nützlich für Container- oder CI-Sitzungen, die keine von Operatoren bereitgestellten Skills laden sollten |210| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Setzen Sie auf `1`, um das Laden von Skills aus dem systemweiten verwalteten Skills-Verzeichnis zu überspringen. Nützlich für Container- oder CI-Sitzungen, die keine von Operatoren bereitgestellten Skills laden sollten |

211| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Setzen Sie auf `1`, um automatische Aktualisierungen des Terminal-Titels basierend auf Konversationskontext zu deaktivieren. In Agent SDK und `claude -p`-Sitzungen überspringt dies auch die Hintergrund-Haiku-Anfrage, die den Sitzungstitel generiert |211| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Setzen Sie auf `1`, um automatische Aktualisierungen des Terminal-Titels basierend auf Konversationskontext zu deaktivieren. In Agent SDK und `claude -p`-Sitzungen überspringt dies auch die Hintergrund-Haiku-Anfrage, die den Sitzungstitel generiert |

212| `CLAUDE_CODE_DISABLE_THINKING` | Setzen Sie auf `1`, um den `thinking`-Parameter vollständig aus API-Anfragen wegzulassen. Dies ist eine Kompatibilitätsoption für Proxies und Gateways, die den Parameter ablehnen. Das Verhalten der Variablen ist unverändert von früheren Versionen; bei Modellen, die standardmäßig denken, bedeutet das Weglassen des Parameters, dass das Modell möglicherweise trotzdem denkt. Um [erweitertes Denken](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) auf der Anthropic API explizit zu deaktivieren, verwenden Sie stattdessen `MAX_THINKING_TOKENS=0`, was auch auf Fable 5 unwirksam ist, da es das Denken nicht ausschalten kann. Auf [Drittanbieter-Providern](/de/third-party-integrations) lässt `0` ebenfalls den Parameter weg, sodass die beiden Variablen dort gleich verhalten |212| `CLAUDE_CODE_DISABLE_THINKING` | Setzen Sie auf `1`, um den `thinking`-Parameter vollständig aus API-Anfragen wegzulassen. Dies ist eine Kompatibilitätsoption für Proxies und Gateways, die den Parameter ablehnen. Das Verhalten der Variablen ist unverändert von früheren Versionen; bei Modellen, die standardmäßig denken, bedeutet das Weglassen des Parameters, dass das Modell möglicherweise trotzdem denkt. Um [erweitertes Denken](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) auf der Anthropic API explizit zu deaktivieren, verwenden Sie stattdessen `MAX_THINKING_TOKENS=0`, was auch auf Fable 5 unwirksam ist, da es das Denken nicht ausschalten kann. Auf [Drittanbieter-Providern](/docs/de/third-party-integrations) lässt `0` ebenfalls den Parameter weg, sodass die beiden Variablen dort gleich verhalten |

213| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Setzen Sie auf `1`, um virtuelles Scrollen in der [Vollbilddarstellung](/de/fullscreen) zu deaktivieren und jede Nachricht im Transkript zu rendern. Verwenden Sie dies, wenn das Scrollen im Vollbildmodus leere Bereiche anzeigt, in denen Nachrichten erscheinen sollten |213| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Setzen Sie auf `1`, um virtuelles Scrollen in der [Vollbilddarstellung](/docs/de/fullscreen) zu deaktivieren und jede Nachricht im Transkript zu rendern. Verwenden Sie dies, wenn das Scrollen im Vollbildmodus leere Bereiche anzeigt, in denen Nachrichten erscheinen sollten |

214| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Setzen Sie auf `1`, um [Workflows](/de/workflows#turn-workflows-off) zu deaktivieren. Äquivalent zur Einstellung [`disableWorkflows`](/de/settings#available-settings) |214| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Setzen Sie auf `1`, um [Workflows](/docs/de/workflows#turn-workflows-off) zu deaktivieren. Äquivalent zur Einstellung [`disableWorkflows`](/docs/de/settings#available-settings) |

215| `CLAUDE_CODE_EFFORT_LEVEL` | Legen Sie die Anstrengungsstufe für unterstützte Modelle fest. Werte: `low`, `medium`, `high`, `xhigh`, `max` oder `auto` für den Modellstandard. Verfügbare Stufen hängen vom Modell ab. Hat Vorrang vor `/effort` und der `effortLevel`-Einstellung. Siehe [Anstrengungsstufe anpassen](/de/model-config#adjust-effort-level) |215| `CLAUDE_CODE_EFFORT_LEVEL` | Legen Sie die Anstrengungsstufe für unterstützte Modelle fest. Werte: `low`, `medium`, `high`, `xhigh`, `max` oder `auto` für den Modellstandard. Verfügbare Stufen hängen vom Modell ab. Hat Vorrang vor `/effort` und der `effortLevel`-Einstellung. Siehe [Anstrengungsstufe anpassen](/docs/de/model-config#adjust-effort-level) |

216| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | {/* min-version: 2.1.205 */}Setzen Sie auf `1`, um das Anhängen von zusätzlichem Text an das Ende des System-Prompts jedes [Subagenten](/de/sub-agents) zu aktivieren. Das Flag [`--append-subagent-system-prompt`](/de/cli-reference#cli-flags) liefert den angehängten Text und setzt diese Variable automatisch, daher müssen Sie sie nicht selbst setzen. Erfordert Claude Code v2.1.205 oder später |216| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | Setzen Sie auf `1`, um das Anhängen von zusätzlichem Text an das Ende des System-Prompts jedes [Subagenten](/docs/de/sub-agents) zu aktivieren. Das Flag [`--append-subagent-system-prompt`](/docs/de/cli-reference#cli-flags) liefert den angehängten Text und setzt diese Variable automatisch, daher müssen Sie sie nicht selbst setzen. Erfordert Claude Code v2.1.205 oder später |

217| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.207 */}Wird für Kompatibilität mit älteren Versionen akzeptiert und hat keine Auswirkung. Auto-Modus ist standardmäßig auf jedem Provider verfügbar, einschließlich Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldete [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzungen. In v2.1.158 bis v2.1.206 war das Setzen auf `1` erforderlich, um [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) auf diesen Providern verfügbar zu machen |217| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Wird für Kompatibilität mit älteren Versionen akzeptiert und hat keine Auswirkung. Auto-Modus ist standardmäßig auf jedem Provider verfügbar, einschließlich Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldete [Claude Apps Gateway](/docs/de/claude-apps-gateway)-Sitzungen. In v2.1.158 bis v2.1.206 war das Setzen auf `1` erforderlich, um [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) auf diesen Providern verfügbar zu machen |

218| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Überschreiben Sie die Verfügbarkeit von [Sitzungs-Zusammenfassung](/de/interactive-mode#session-recap). Setzen Sie auf `0`, um Zusammenfassungen unabhängig vom `/config`-Umschalter auszuschalten. Setzen Sie auf `1`, um Zusammenfassungen zu erzwingen, wenn [`awaySummaryEnabled`](/de/settings#available-settings) `false` ist. Hat Vorrang vor der Einstellung und dem `/config`-Umschalter |218| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Überschreiben Sie die Verfügbarkeit von [Sitzungs-Zusammenfassung](/docs/de/interactive-mode#session-recap). Setzen Sie auf `0`, um Zusammenfassungen unabhängig vom `/config`-Umschalter auszuschalten. Setzen Sie auf `1`, um Zusammenfassungen zu erzwingen, wenn [`awaySummaryEnabled`](/docs/de/settings#available-settings) `false` ist. Hat Vorrang vor der Einstellung und dem `/config`-Umschalter |

219| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Setzen Sie auf `1`, um den Plugin-Status an Turn-Grenzen im [nicht-interaktiven Modus](/de/headless) zu aktualisieren, nachdem eine Hintergrund-Installation abgeschlossen ist. Standardmäßig aus, da die Aktualisierung den System-Prompt mitten in der Sitzung ändert, was [Prompt-Caching](/de/prompt-caching) für diesen Turn ungültig macht |219| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Setzen Sie auf `1`, um den Plugin-Status an Turn-Grenzen im [nicht-interaktiven Modus](/docs/de/headless) zu aktualisieren, nachdem eine Hintergrund-Installation abgeschlossen ist. Standardmäßig aus, da die Aktualisierung den System-Prompt mitten in der Sitzung ändert, was [Prompt-Caching](/docs/de/prompt-caching) für diesen Turn ungültig macht |

220| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Setzen Sie auf `1`, um die Umfrage zur Sitzungsqualität „Wie läuft es mit Claude?" an Ihren eigenen [OpenTelemetry-Collector](/de/monitoring-usage) zu leiten, wenn Anthropic-gebundener nicht wesentlicher Traffic blockiert wird. Umfragebewertungen werden nur als OTEL-Ereignisse an Ihren konfigurierten Collector ausgegeben. Keine Umfragedaten werden in diesem Modus an Anthropic gesendet. Gilt, wenn `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist, und hat ansonsten keine Auswirkung. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` und die Produktfeedback-Richtlinie der Organisation haben Vorrang |220| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Setzen Sie auf `1`, um die Umfrage zur Sitzungsqualität „Wie läuft es mit Claude?" an Ihren eigenen [OpenTelemetry-Collector](/docs/de/monitoring-usage) zu leiten, wenn Anthropic-gebundener nicht wesentlicher Traffic blockiert wird. Umfragebewertungen werden nur als OTEL-Ereignisse an Ihren konfigurierten Collector ausgegeben. Keine Umfragedaten werden in diesem Modus an Anthropic gesendet. Gilt, wenn `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` oder `DO_NOT_TRACK` gesetzt ist, und hat ansonsten keine Auswirkung. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` und die Produktfeedback-Richtlinie der Organisation haben Vorrang |

221| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Steuert, ob Tool-Call-Eingaben von der API streamen, während Claude sie generiert. Wenn dies aus ist, kommt eine große Tool-Eingabe wie ein langer Datei-Schreibvorgang erst an, nachdem Claude die Generierung abgeschlossen hat, was aussehen kann, als würde es hängen. Standardmäßig für direkte Anthropic API-Verbindungen aktiviert. Auf Amazon Bedrock und Google Cloud's Agent Platform, aktiviert pro Modell, wo der bereitgestellte Container es unterstützt. Setzen Sie auf `0`, um sich abzumelden. Setzen Sie auf `1`, um zu erzwingen, wenn Sie durch einen Proxy über `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` oder `ANTHROPIC_BEDROCK_BASE_URL` routen. Standardmäßig aus auf Microsoft Foundry und [Gateway](/de/llm-gateway)-Verbindungen |221| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Steuert, ob Tool-Call-Eingaben von der API streamen, während Claude sie generiert. Wenn dies aus ist, kommt eine große Tool-Eingabe wie ein langer Datei-Schreibvorgang erst an, nachdem Claude die Generierung abgeschlossen hat, was aussehen kann, als würde es hängen. Standardmäßig für direkte Anthropic API-Verbindungen aktiviert. Auf Amazon Bedrock und Google Cloud's Agent Platform, aktiviert pro Modell, wo der bereitgestellte Container es unterstützt. Setzen Sie auf `0`, um sich abzumelden. Setzen Sie auf `1`, um zu erzwingen, wenn Sie durch einen Proxy über `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` oder `ANTHROPIC_BEDROCK_BASE_URL` routen. Standardmäßig aus auf Microsoft Foundry und [Gateway](/docs/de/llm-gateway)-Verbindungen |

222| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Setzen Sie auf `1`, um die `/model`-Auswahl aus dem `/v1/models`-Endpunkt Ihres Gateways zu füllen, wenn `ANTHROPIC_BASE_URL` auf ein Anthropic-kompatibles Gateway wie LiteLLM, Kong oder einen internen Proxy verweist. Standardmäßig aus, da Gateways, die von einem gemeinsamen API-Schlüssel unterstützt werden, ansonsten jedem Benutzer jedes Modell anzeigen würden, auf das der Schlüssel zugreifen kann. Erkannte Modelle werden weiterhin durch die [`availableModels`](/de/settings#available-settings)-Zulassungsliste gefiltert, die die Sitzung erhält; liefern Sie die Liste über [MDM oder eine verwaltete Einstellungsdatei](/de/settings#settings-files), da [Server-verwaltete Bereitstellung auf Gateway-Konfigurationen nicht verfügbar ist](/de/server-managed-settings#platform-availability) |222| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Setzen Sie auf `1`, um die `/model`-Auswahl aus dem `/v1/models`-Endpunkt Ihres Gateways zu füllen, wenn `ANTHROPIC_BASE_URL` auf ein Anthropic-kompatibles Gateway wie LiteLLM, Kong oder einen internen Proxy verweist. Standardmäßig aus, da Gateways, die von einem gemeinsamen API-Schlüssel unterstützt werden, ansonsten jedem Benutzer jedes Modell anzeigen würden, auf das der Schlüssel zugreifen kann. Erkannte Modelle werden weiterhin durch die [`availableModels`](/docs/de/settings#available-settings)-Zulassungsliste gefiltert, die die Sitzung erhält; liefern Sie die Liste über [MDM oder eine verwaltete Einstellungsdatei](/docs/de/settings#settings-files), da [Server-verwaltete Bereitstellung auf Gateway-Konfigurationen nicht verfügbar ist](/docs/de/server-managed-settings#platform-availability) |

223| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Entfernt in v2.1.142, wenn der [Schnellmodus](/de/fast-mode) standardmäßig von Opus 4.6 zu Opus 4.7 wechselte |223| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Entfernt in v2.1.142, wenn der [Schnellmodus](/docs/de/fast-mode) standardmäßig von Opus 4.6 zu Opus 4.7 wechselte |

224| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Setzen Sie auf `false`, um Prompt-Vorschläge zu deaktivieren (der Umschalter „Prompt-Vorschläge" in `/config`). Dies sind die ausgegraut angezeigten Vorhersagen, die in Ihrer Prompt-Eingabe nach Claudes Antwort erscheinen. Siehe [Prompt-Vorschläge](/de/interactive-mode#prompt-suggestions) |224| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Setzen Sie auf `false`, um Prompt-Vorschläge zu deaktivieren (der Umschalter „Prompt-Vorschläge" in `/config`). Dies sind die ausgegraut angezeigten Vorhersagen, die in Ihrer Prompt-Eingabe nach Claudes Antwort erscheinen. Siehe [Prompt-Vorschläge](/docs/de/interactive-mode#prompt-suggestions) |

225| `CLAUDE_CODE_ENABLE_TASKS` | Steuert, ob Sitzungen die strukturierten Task-Tools (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) oder das veraltete `TodoWrite`-Tool verwenden. {/* min-version: 2.1.142 */}Ab Claude Code v2.1.142 sind Task-Tools standardmäßig in allen Modi. Setzen Sie auf `0`, um zu `TodoWrite` zurückzukehren. Siehe [Aufgabenliste](/de/interactive-mode#task-list) und [Zu Task-Tools migrieren](/de/agent-sdk/todo-tracking#migrate-to-task-tools) |225| `CLAUDE_CODE_ENABLE_TASKS` | Steuert, ob Sitzungen die strukturierten Task-Tools (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) oder das veraltete `TodoWrite`-Tool verwenden. Ab Claude Code v2.1.142 sind Task-Tools standardmäßig in allen Modi. Setzen Sie auf `0`, um zu `TodoWrite` zurückzukehren. Siehe [Aufgabenliste](/docs/de/interactive-mode#task-list) und [Zu Task-Tools migrieren](/docs/de/agent-sdk/todo-tracking#migrate-to-task-tools) |

226| `CLAUDE_CODE_ENABLE_TELEMETRY` | Setzen Sie auf `1`, um OpenTelemetry-Datenerfassung für Metriken und Protokollierung zu aktivieren. Erforderlich, bevor OTel-Exporter konfiguriert werden. Siehe [Überwachung](/de/monitoring-usage) |226| `CLAUDE_CODE_ENABLE_TELEMETRY` | Setzen Sie auf `1`, um OpenTelemetry-Datenerfassung für Metriken und Protokollierung zu aktivieren. Erforderlich, bevor OTel-Exporter konfiguriert werden. Siehe [Überwachung](/docs/de/monitoring-usage) |

227| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Zeit in Millisekunden, die nach dem Leerlaufen der Abfrageschleife gewartet werden soll, bevor automatisch beendet wird. Nützlich für automatisierte Workflows und Skripte mit SDK-Modus |227| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Zeit in Millisekunden, die nach dem Leerlaufen der Abfrageschleife gewartet werden soll, bevor automatisch beendet wird. Nützlich für automatisierte Workflows und Skripte mit SDK-Modus |

228| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Setzen Sie auf `1`, um [Agent-Teams](/de/agent-teams) zu aktivieren. Agent-Teams sind experimentell und standardmäßig deaktiviert |228| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Setzen Sie auf `1`, um [Agent-Teams](/docs/de/agent-teams) zu aktivieren. Agent-Teams sind experimentell und standardmäßig deaktiviert |

229| `CLAUDE_CODE_EXTRA_BODY` | JSON-Objekt, das in die oberste Ebene jedes API-Request-Body zusammengeführt werden soll. Nützlich für die Übergabe von Provider-spezifischen Parametern, die Claude Code nicht direkt verfügbar macht. {/* min-version: 2.1.206 */}Ein in Ihrer Shell exportierter Wert gilt auch für die [Hintergrund-Sitzungen](/de/agent-view), die Sie mit `claude agents` oder `--bg` dispatchen. Vor v2.1.206 ignorierten Hintergrund-Sitzungen einen Shell-exportierten Wert und verwendeten, was die Hintergrund-Supervisor-Prozess geerbt hatte |229| `CLAUDE_CODE_EXTRA_BODY` | JSON-Objekt, das in die oberste Ebene jedes API-Request-Body zusammengeführt werden soll. Nützlich für die Übergabe von Provider-spezifischen Parametern, die Claude Code nicht direkt verfügbar macht. Ein in Ihrer Shell exportierter Wert gilt auch für die [Hintergrund-Sitzungen](/docs/de/agent-view), die Sie mit `claude agents` oder `--bg` dispatchen. Vor v2.1.206 ignorierten Hintergrund-Sitzungen einen Shell-exportierten Wert und verwendeten, was die Hintergrund-Supervisor-Prozess geerbt hatte |

230| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Überschreiben Sie das Standard-Token-Limit für Dateileser. Nützlich, wenn Sie größere Dateien vollständig lesen müssen |230| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Überschreiben Sie das Standard-Token-Limit für Dateileser. Nützlich, wenn Sie größere Dateien vollständig lesen müssen |

231| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}Setzen Sie auf `1`, um Transkript-Persistenz, Prompt-Verlauf und `claude agents`-Registrierung zu erzwingen, auch wenn dieser `claude` von innen in einer anderen Claude Code-Sitzung gestartet wurde. Verwenden Sie, wenn ein vererbter `CLAUDE_CODE_CHILD_SESSION`-Wert, z. B. von einem `screen`-Sitzung oder einem Hintergrund-Launcher, der zuerst von Claude Codes Bash-Tool gestartet wurde, dazu führt, dass eine echte Top-Level-Sitzung als verschachtelt fehlklassifiziert wird. {/* min-version: 2.1.178 */}Ab v2.1.178 erkennt Claude Code den tmux-Fall automatisch und ignoriert den vererbten Marker, sodass tmux diese Variable nicht mehr benötigt. Wird auch auf v2.1.169 und früher berücksichtigt; hat keine Auswirkung auf v2.1.170 und v2.1.171, wo die verschachtelte Sitzungserkennung, die es überschreibt, entfernt wurde |231| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Setzen Sie auf `1`, um Transkript-Persistenz, Prompt-Verlauf und `claude agents`-Registrierung zu erzwingen, auch wenn dieser `claude` von innen in einer anderen Claude Code-Sitzung gestartet wurde. Verwenden Sie, wenn ein vererbter `CLAUDE_CODE_CHILD_SESSION`-Wert, z. B. von einem `screen`-Sitzung oder einem Hintergrund-Launcher, der zuerst von Claude Codes Bash-Tool gestartet wurde, dazu führt, dass eine echte Top-Level-Sitzung als verschachtelt fehlklassifiziert wird. Ab v2.1.178 erkennt Claude Code den tmux-Fall automatisch und ignoriert den vererbten Marker, sodass tmux diese Variable nicht mehr benötigt. Wird auch auf v2.1.169 und früher berücksichtigt; hat keine Auswirkung auf v2.1.170 und v2.1.171, wo die verschachtelte Sitzungserkennung, die es überschreibt, entfernt wurde |

232| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | {/* min-version: 2.1.186 */}Setzen Sie auf `1`, um Durchstreichungs-Rendering für `~~text~~` in Claudes Antworten zu erzwingen, wenn Ihr Terminal es unterstützt, aber nicht automatisch erkannt wird, z. B. über SSH ohne `TERM_PROGRAM` weitergeleitet. Ohne dies zeigen nicht erkannte Terminals die wörtlichen `~~`-Marker an, anstatt den Text als Durchstreichung zu rendern. Erfordert Claude Code v2.1.186 oder später |232| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Setzen Sie auf `1`, um Durchstreichungs-Rendering für `~~text~~` in Claudes Antworten zu erzwingen, wenn Ihr Terminal es unterstützt, aber nicht automatisch erkannt wird, z. B. über SSH ohne `TERM_PROGRAM` weitergeleitet. Ohne dies zeigen nicht erkannte Terminals die wörtlichen `~~`-Marker an, anstatt den Text als Durchstreichung zu rendern. Erfordert Claude Code v2.1.186 oder später |

233| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Setzen Sie auf `1`, um DEC Private Mode 2026 [synchronisierte Ausgabe](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) zu erzwingen, wenn Ihr Terminal sie unterstützt, aber nicht automatisch erkannt wird. Nützlich für Emulatoren wie Emacs `eat`, die BSU/ESU implementieren, aber nicht auf die Capability-Abfrage antworten. Hat keine Auswirkung unter tmux. Im Gegensatz zu `CLAUDE_CODE_NO_FLICKER`, das zur [Vollbilddarstellung](/de/fullscreen) wechselt, ändert dies nicht den Renderer |233| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Setzen Sie auf `1`, um DEC Private Mode 2026 [synchronisierte Ausgabe](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) zu erzwingen, wenn Ihr Terminal sie unterstützt, aber nicht automatisch erkannt wird. Nützlich für Emulatoren wie Emacs `eat`, die BSU/ESU implementieren, aber nicht auf die Capability-Abfrage antworten. Hat keine Auswirkung unter tmux. Im Gegensatz zu `CLAUDE_CODE_NO_FLICKER`, das zur [Vollbilddarstellung](/docs/de/fullscreen) wechselt, ändert dies nicht den Renderer |

234| `CLAUDE_CODE_FORK_SUBAGENT` | Setzen Sie auf `1`, um Claude [abgespaltete Subagenten](/de/sub-agents#fork-the-current-conversation) zu spawnen, oder `0`, um sie zu deaktivieren, wobei jede Server-seitige Einführung überschrieben wird. Wenn aktiviert, kann Claude den `fork`-Subagenten-Typ anfordern, um einen Fork zu spawnen, einen Subagenten, der den vollständigen Konversationskontext erbt, anstatt neu zu beginnen. Spawns ohne einen Subagenten-Typ verwenden weiterhin den allgemeinen Subagenten, und alle Subagenten-Spawns werden im Hintergrund ausgeführt. Der explizite [`/fork`](/de/commands)-Befehl funktioniert ohne diese Variable. Funktioniert im interaktiven Modus und über das SDK oder `claude -p` |234| `CLAUDE_CODE_FORK_SUBAGENT` | Setzen Sie auf `1`, um Claude [abgespaltete Subagenten](/docs/de/sub-agents#fork-the-current-conversation) zu spawnen, oder `0`, um sie zu deaktivieren, wobei jede Server-seitige Einführung überschrieben wird. Wenn aktiviert, kann Claude den `fork`-Subagenten-Typ anfordern, um einen Fork zu spawnen, einen Subagenten, der den vollständigen Konversationskontext erbt, anstatt neu zu beginnen. Spawns ohne einen Subagenten-Typ verwenden weiterhin den allgemeinen Subagenten, und alle Subagenten-Spawns werden im Hintergrund ausgeführt. Der explizite [`/fork`](/docs/de/commands)-Befehl funktioniert ohne diese Variable. Funktioniert im interaktiven Modus und über das SDK oder `claude -p` |

235| `CLAUDE_CODE_GIT_BASH_PATH` | Nur Windows: Pfad zur Git Bash-Ausführungsdatei (`bash.exe`). Verwenden Sie, wenn Git Bash installiert ist, aber nicht in Ihrem PATH. Siehe [Windows-Setup](/de/setup#set-up-on-windows) |235| `CLAUDE_CODE_GIT_BASH_PATH` | Nur Windows: Pfad zur Git Bash-Ausführungsdatei (`bash.exe`). Verwenden Sie, wenn Git Bash installiert ist, aber nicht in Ihrem PATH. Siehe [Windows-Setup](/docs/de/setup#set-up-on-windows) |

236| `CLAUDE_CODE_GLOB_HIDDEN` | Setzen Sie auf `false`, um versteckte Dateien aus Ergebnissen auszuschließen, wenn Claude das [Glob-Tool](/de/tools-reference#glob-tool-behavior) aufruft. Standardmäßig enthalten. Beeinflusst nicht `@`-Datei-Autovervollständigung, `ls`, Grep oder Read |236| `CLAUDE_CODE_GLOB_HIDDEN` | Setzen Sie auf `false`, um versteckte Dateien aus Ergebnissen auszuschließen, wenn Claude das [Glob-Tool](/docs/de/tools-reference#glob-tool-behavior) aufruft. Standardmäßig enthalten. Beeinflusst nicht `@`-Datei-Autovervollständigung, `ls`, Grep oder Read |

237| `CLAUDE_CODE_GLOB_NO_IGNORE` | Setzen Sie auf `false`, um das [Glob-Tool](/de/tools-reference#glob-tool-behavior) `.gitignore`-Muster respektieren zu lassen. Standardmäßig gibt Glob alle übereinstimmenden Dateien zurück, einschließlich gitignorierter. Beeinflusst nicht `@`-Datei-Autovervollständigung, die ihre eigene [`respectGitignore`-Einstellung](/de/settings#available-settings) hat |237| `CLAUDE_CODE_GLOB_NO_IGNORE` | Setzen Sie auf `false`, um das [Glob-Tool](/docs/de/tools-reference#glob-tool-behavior) `.gitignore`-Muster respektieren zu lassen. Standardmäßig gibt Glob alle übereinstimmenden Dateien zurück, einschließlich gitignorierter. Beeinflusst nicht `@`-Datei-Autovervollständigung, die ihre eigene [`respectGitignore`-Einstellung](/docs/de/settings#available-settings) hat |

238| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in Sekunden für die Glob-Tool-Dateiermittlung. Standardmäßig 20 Sekunden auf den meisten Plattformen und 60 Sekunden auf WSL |238| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in Sekunden für die Glob-Tool-Dateiermittlung. Standardmäßig 20 Sekunden auf den meisten Plattformen und 60 Sekunden auf WSL |

239| `CLAUDE_CODE_HIDE_CWD` | Setzen Sie auf `1`, um das Arbeitsverzeichnis im Startup-Logo auszublenden. Nützlich für Bildschirmfreigaben oder Aufzeichnungen, bei denen der Pfad Ihren OS-Benutzernamen offenlegt |239| `CLAUDE_CODE_HIDE_CWD` | Setzen Sie auf `1`, um das Arbeitsverzeichnis im Startup-Logo auszublenden. Nützlich für Bildschirmfreigaben oder Aufzeichnungen, bei denen der Pfad Ihren OS-Benutzernamen offenlegt |

240| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Überschreiben Sie die Host-Adresse, die zum Verbinden mit der IDE-Erweiterung verwendet wird. Standardmäßig erkennt Claude Code die richtige Adresse automatisch, einschließlich WSL-zu-Windows-Routing |240| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Überschreiben Sie die Host-Adresse, die zum Verbinden mit der IDE-Erweiterung verwendet wird. Standardmäßig erkennt Claude Code die richtige Adresse automatisch, einschließlich WSL-zu-Windows-Routing |

241| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Setzen Sie auf `1`, um die automatische Installation von IDE-Erweiterungen zu überspringen. Äquivalent zum Setzen von [`autoInstallIdeExtension`](/de/settings#global-config-settings) auf `false` |241| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Setzen Sie auf `1`, um die automatische Installation von IDE-Erweiterungen zu überspringen. Äquivalent zum Setzen von [`autoInstallIdeExtension`](/docs/de/settings#global-config-settings) auf `false` |

242| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Setzen Sie auf `1`, um die Validierung von IDE-Lockfile-Einträgen während der Verbindung zu überspringen. Verwenden Sie, wenn die automatische Verbindung Ihre IDE nicht findet, obwohl sie ausgeführt wird |242| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Setzen Sie auf `1`, um die Validierung von IDE-Lockfile-Einträgen während der Verbindung zu überspringen. Verwenden Sie, wenn die automatische Verbindung Ihre IDE nicht findet, obwohl sie ausgeführt wird |

243| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Überschreiben Sie die Kontextfenstergröße, die Claude Code für das aktive Modell annimmt. {/* min-version: 2.1.193 */}Ab v2.1.193 direkt angewendet für Modellnamen, die Claude Code nicht als Claude-Modell erkennt; für erkannte Claude-Modelle wirkt sich dies nur aus, wenn `DISABLE_COMPACT` auch gesetzt ist. Verwenden Sie dies, wenn Sie zu einem Modell durch `ANTHROPIC_BASE_URL` routen, dessen Kontextfenster nicht der integrierten Größe für seinen Namen entspricht |243| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Überschreiben Sie die Kontextfenstergröße, die Claude Code für das aktive Modell annimmt. Ab v2.1.193 direkt angewendet für Modellnamen, die Claude Code nicht als Claude-Modell erkennt; für erkannte Claude-Modelle wirkt sich dies nur aus, wenn `DISABLE_COMPACT` auch gesetzt ist. Verwenden Sie dies, wenn Sie zu einem Modell durch `ANTHROPIC_BASE_URL` routen, dessen Kontextfenster nicht der integrierten Größe für seinen Namen entspricht |

244| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Legen Sie die maximale Anzahl von Ausgabe-Token für die meisten Anfragen fest. Standard und Obergrenzen variieren je nach Modell; siehe [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Das Erhöhen dieses Wertes reduziert das verfügbare effektive Kontextfenster, bevor die [automatische Komprimierung](/de/costs#reduce-token-usage) ausgelöst wird |244| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Legen Sie die maximale Anzahl von Ausgabe-Token für die meisten Anfragen fest. Standard und Obergrenzen variieren je nach Modell; siehe [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Das Erhöhen dieses Wertes reduziert das verfügbare effektive Kontextfenster, bevor die [automatische Komprimierung](/docs/de/costs#reduce-token-usage) ausgelöst wird |

245| `CLAUDE_CODE_MAX_RETRIES` | Überschreiben Sie die Anzahl der Wiederholungen fehlgeschlagener API-Anfragen (Standard: 10). {/* min-version: 2.1.186 */}Begrenzt auf 15 ab v2.1.186; {/* min-version: 2.1.199 */}ab v2.1.199 hebt `CLAUDE_CODE_RETRY_WATCHDOG` die Standardanzahl an und entfernt die Obergrenze. Für unbeaufsichtigte Sitzungen, die längere Ausfallzeiten abwarten müssen, setzen Sie stattdessen `CLAUDE_CODE_RETRY_WATCHDOG` |245| `CLAUDE_CODE_MAX_RETRIES` | Überschreiben Sie die Anzahl der Wiederholungen fehlgeschlagener API-Anfragen (Standard: 10). Begrenzt auf 15 ab v2.1.186; ab v2.1.199 hebt `CLAUDE_CODE_RETRY_WATCHDOG` die Standardanzahl an und entfernt die Obergrenze. Für unbeaufsichtigte Sitzungen, die längere Ausfallzeiten abwarten müssen, setzen Sie stattdessen `CLAUDE_CODE_RETRY_WATCHDOG` |

246| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Maximale Anzahl von schreibgeschützten Tools und Subagenten, die parallel ausgeführt werden können (Standard: 10). Höhere Werte erhöhen die Parallelität, verbrauchen aber mehr Ressourcen |246| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Maximale Anzahl von schreibgeschützten Tools und Subagenten, die parallel ausgeführt werden können (Standard: 10). Höhere Werte erhöhen die Parallelität, verbrauchen aber mehr Ressourcen |

247| `CLAUDE_CODE_MAX_TURNS` | Begrenzen Sie die Anzahl der agentic Turns, wenn kein explizites Limit übergeben wird. Äquivalent zum Übergeben von [`--max-turns`](/de/cli-reference#cli-flags), das Vorrang hat, wenn beide gesetzt sind. Ein Wert, der keine positive Ganzzahl ist, wird beim Start mit einem Fehler abgelehnt, anstatt als kein Limit behandelt zu werden |247| `CLAUDE_CODE_MAX_TURNS` | Begrenzen Sie die Anzahl der agentic Turns, wenn kein explizites Limit übergeben wird. Äquivalent zum Übergeben von [`--max-turns`](/docs/de/cli-reference#cli-flags), das Vorrang hat, wenn beide gesetzt sind. Ein Wert, der keine positive Ganzzahl ist, wird beim Start mit einem Fehler abgelehnt, anstatt als kein Limit behandelt zu werden |

248| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Setzen Sie auf `1`, um stdio MCP-Server nur mit einer sicheren Baseline-Umgebung plus der konfigurierten `env` des Servers zu spawnen, anstatt Ihre Shell-Umgebung zu erben |248| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Setzen Sie auf `1`, um stdio MCP-Server nur mit einer sicheren Baseline-Umgebung plus der konfigurierten `env` des Servers zu spawnen, anstatt Ihre Shell-Umgebung zu erben |

249| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}Idle-Timeout in Millisekunden für MCP-Tool-Aufrufe. Wenn ein stdio-, HTTP-, SSE-, WebSocket- oder [claude.ai-Connector](/de/mcp#use-mcp-servers-from-claude-ai) MCP-Server für diese lange keine Antwort und keine Fortschrittsbenachrichtigung sendet, bricht der Tool-Aufruf mit einem Fehler ab, anstatt auf das Gesamt-`MCP_TOOL_TIMEOUT` zu warten. Überschreibt die Pro-Transport-Standards von 300000 (5 Minuten) für Netzwerk-Server und 1800000 (30 Minuten) für stdio-Server. Setzen Sie auf `0`, um die Idle-Überprüfung zu deaktivieren. Werte unter 1000 werden auf eine Sekunde erhöht, und der Wert ist auf das effektive `MCP_TOOL_TIMEOUT` begrenzt. Ein Pro-Server-`timeout` in `.mcp.json` von mindestens 1000 erhöht das Idle-Fenster dieses Servers auf mindestens den `timeout`-Wert. Gilt nicht für IDE-Server oder SDK-In-Process-Server. Erfordert Claude Code v2.1.187 oder später. {/* min-version: 2.1.203 */}Vor v2.1.203 waren stdio-Server vom Idle-Timeout ausgenommen |249| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Idle-Timeout in Millisekunden für MCP-Tool-Aufrufe. Wenn ein stdio-, HTTP-, SSE-, WebSocket- oder [claude.ai-Connector](/docs/de/mcp#use-mcp-servers-from-claude-ai) MCP-Server für diese lange keine Antwort und keine Fortschrittsbenachrichtigung sendet, bricht der Tool-Aufruf mit einem Fehler ab, anstatt auf das Gesamt-`MCP_TOOL_TIMEOUT` zu warten. Überschreibt die Pro-Transport-Standards von 300000 (5 Minuten) für Netzwerk-Server und 1800000 (30 Minuten) für stdio-Server. Setzen Sie auf `0`, um die Idle-Überprüfung zu deaktivieren. Werte unter 1000 werden auf eine Sekunde erhöht, und der Wert ist auf das effektive `MCP_TOOL_TIMEOUT` begrenzt. Ein Pro-Server-`timeout` in `.mcp.json` von mindestens 1000 erhöht das Idle-Fenster dieses Servers auf mindestens den `timeout`-Wert. Gilt nicht für IDE-Server oder SDK-In-Process-Server. Erfordert Claude Code v2.1.187 oder später. Vor v2.1.203 waren stdio-Server vom Idle-Timeout ausgenommen |

250| `CLAUDE_CODE_NATIVE_CURSOR` | Setzen Sie auf `1`, um den eigenen Cursor des Terminals an der Eingabeeinfügemarke anzuzeigen, anstatt eines gezeichneten Blocks. Der Cursor respektiert die Blink-, Form- und Fokuseinstellungen des Terminals |250| `CLAUDE_CODE_NATIVE_CURSOR` | Setzen Sie auf `1`, um den eigenen Cursor des Terminals an der Eingabeeinfügemarke anzuzeigen, anstatt eines gezeichneten Blocks. Der Cursor respektiert die Blink-, Form- und Fokuseinstellungen des Terminals |

251| `CLAUDE_CODE_NEW_INIT` | Setzen Sie auf `1`, um `/init` einen interaktiven Setup-Flow ausführen zu lassen. Der Flow fragt, welche Dateien generiert werden sollen, einschließlich CLAUDE.md, Skills und Hooks, bevor die Codebasis erkundet und geschrieben wird. Ohne diese Variable generiert `/init` automatisch eine CLAUDE.md ohne Aufforderung |251| `CLAUDE_CODE_NEW_INIT` | Setzen Sie auf `1`, um `/init` einen interaktiven Setup-Flow ausführen zu lassen. Der Flow fragt, welche Dateien generiert werden sollen, einschließlich CLAUDE.md, Skills und Hooks, bevor die Codebasis erkundet und geschrieben wird. Ohne diese Variable generiert `/init` automatisch eine CLAUDE.md ohne Aufforderung |

252| `CLAUDE_CODE_NO_FLICKER` | Setzen Sie auf `1`, um die [Vollbilddarstellung](/de/fullscreen) zu aktivieren, eine Forschungsvorschau, die Flimmern reduziert und den Speicher in langen Konversationen flach hält. Äquivalent zur [`tui`](/de/settings#available-settings)-Einstellung; Sie können auch mit `/tui fullscreen` wechseln |252| `CLAUDE_CODE_NO_FLICKER` | Setzen Sie auf `1`, um die [Vollbilddarstellung](/docs/de/fullscreen) zu aktivieren, eine Forschungsvorschau, die Flimmern reduziert und den Speicher in langen Konversationen flach hält. Äquivalent zur [`tui`](/docs/de/settings#available-settings)-Einstellung; Sie können auch mit `/tui fullscreen` wechseln |

253| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | OAuth-Aktualisierungstoken für Claude.ai-Authentifizierung. Wenn gesetzt, tauscht `claude auth login` dieses Token direkt aus, anstatt einen Browser zu öffnen. Erfordert `CLAUDE_CODE_OAUTH_SCOPES`. Nützlich für die Bereitstellung von Authentifizierung in automatisierten Umgebungen |253| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | OAuth-Aktualisierungstoken für Claude.ai-Authentifizierung. Wenn gesetzt, tauscht `claude auth login` dieses Token direkt aus, anstatt einen Browser zu öffnen. Erfordert `CLAUDE_CODE_OAUTH_SCOPES`. Nützlich für die Bereitstellung von Authentifizierung in automatisierten Umgebungen |

254| `CLAUDE_CODE_OAUTH_SCOPES` | Durch Leerzeichen getrennte OAuth-Bereiche, mit denen das Aktualisierungstoken ausgestellt wurde, z. B. `"user:profile user:inference user:sessions:claude_code"`. Erforderlich, wenn `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` gesetzt ist |254| `CLAUDE_CODE_OAUTH_SCOPES` | Durch Leerzeichen getrennte OAuth-Bereiche, mit denen das Aktualisierungstoken ausgestellt wurde, z. B. `"user:profile user:inference user:sessions:claude_code"`. Erforderlich, wenn `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` gesetzt ist |

255| `CLAUDE_CODE_OAUTH_TOKEN` | OAuth-Zugriffstoken für Claude.ai-Authentifizierung. Alternative zu `/login` für SDK und automatisierte Umgebungen. Hat Vorrang vor in der Keychain gespeicherten Anmeldedaten. Generieren Sie eines mit [`claude setup-token`](/de/authentication#generate-a-long-lived-token) |255| `CLAUDE_CODE_OAUTH_TOKEN` | OAuth-Zugriffstoken für Claude.ai-Authentifizierung. Alternative zu `/login` für SDK und automatisierte Umgebungen. Hat Vorrang vor in der Keychain gespeicherten Anmeldedaten. Generieren Sie eines mit [`claude setup-token`](/docs/de/authentication#generate-a-long-lived-token) |

256| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}Entfernt in v2.1.160 und jetzt ein No-Op. Früher fixierte [Schnellmodus](/de/fast-mode) auf Claude Opus 4.6 anstelle des aktuellen Standards. Opus 4.6 unterstützt Schnellmodus nicht mehr |256| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Entfernt in v2.1.160 und jetzt ein No-Op. Früher fixierte [Schnellmodus](/docs/de/fast-mode) auf Claude Opus 4.6 anstelle des aktuellen Standards. Opus 4.6 unterstützt Schnellmodus nicht mehr |

257| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {/* min-version: 2.1.179 */}Setzen Sie auf `1`, um OpenTelemetry-Exporter-Diagnosefehler auf stderr zu schreiben. Standardmäßig erscheinen diese Fehler nur mit `--debug`, sodass ein fehlkonfigurierter Exporter wie eine Prometheus-Port-Kollision ansonsten stillschweigend fehlschlägt. Erfordert Claude Code v2.1.179 oder später. Siehe [Überwachung](/de/monitoring-usage) |257| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Setzen Sie auf `1`, um OpenTelemetry-Exporter-Diagnosefehler auf stderr zu schreiben. Standardmäßig erscheinen diese Fehler nur mit `--debug`, sodass ein fehlkonfigurierter Exporter wie eine Prometheus-Port-Kollision ansonsten stillschweigend fehlschlägt. Erfordert Claude Code v2.1.179 oder später. Siehe [Überwachung](/docs/de/monitoring-usage) |

258| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in Millisekunden zum Leeren ausstehender OpenTelemetry-Spans (Standard: 5000). Siehe [Überwachung](/de/monitoring-usage) |258| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in Millisekunden zum Leeren ausstehender OpenTelemetry-Spans (Standard: 5000). Siehe [Überwachung](/docs/de/monitoring-usage) |

259| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervall zum Aktualisieren dynamischer OpenTelemetry-Header in Millisekunden (Standard: 1740000 / 29 Minuten). Siehe [Dynamische Header](/de/monitoring-usage#dynamic-headers) |259| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervall zum Aktualisieren dynamischer OpenTelemetry-Header in Millisekunden (Standard: 1740000 / 29 Minuten). Siehe [Dynamische Header](/docs/de/monitoring-usage#dynamic-headers) |

260| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in Millisekunden für den OpenTelemetry-Exporter zum Beenden beim Herunterfahren (Standard: 2000). Erhöhen Sie, wenn Metriken beim Beenden gelöscht werden. Siehe [Überwachung](/de/monitoring-usage) |260| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in Millisekunden für den OpenTelemetry-Exporter zum Beenden beim Herunterfahren (Standard: 2000). Erhöhen Sie, wenn Metriken beim Beenden gelöscht werden. Siehe [Überwachung](/docs/de/monitoring-usage) |

261| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Setzen Sie auf `1`, um Claude Code Ihren Package Manager-Upgrade-Befehl im Hintergrund ausführen zu lassen, wenn eine neue Version verfügbar ist. Gilt für Homebrew und WinGet-Installationen. Andere Package Manager zeigen weiterhin den Upgrade-Befehl an, ohne ihn auszuführen. Siehe [Auto-Updates](/de/setup#auto-updates) |261| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Setzen Sie auf `1`, um Claude Code Ihren Package Manager-Upgrade-Befehl im Hintergrund ausführen zu lassen, wenn eine neue Version verfügbar ist. Gilt für Homebrew und WinGet-Installationen. Andere Package Manager zeigen weiterhin den Upgrade-Befehl an, ohne ihn auszuführen. Siehe [Auto-Updates](/docs/de/setup#auto-updates) |

262| `CLAUDE_CODE_PERFORCE_MODE` | Setzen Sie auf `1`, um Perforce-bewussten Schreibschutz zu aktivieren. Wenn gesetzt, schlagen Edit, Write und NotebookEdit fehl mit einem `p4 edit <file>`-Hinweis, wenn die Zieldatei das Owner-Write-Bit nicht hat, das Perforce bei synchronisierten Dateien löscht, bis `p4 edit` sie öffnet. Dies verhindert, dass Claude Code die Perforce-Änderungsverfolgung umgeht |262| `CLAUDE_CODE_PERFORCE_MODE` | Setzen Sie auf `1`, um Perforce-bewussten Schreibschutz zu aktivieren. Wenn gesetzt, schlagen Edit, Write und NotebookEdit fehl mit einem `p4 edit <file>`-Hinweis, wenn die Zieldatei das Owner-Write-Bit nicht hat, das Perforce bei synchronisierten Dateien löscht, bis `p4 edit` sie öffnet. Dies verhindert, dass Claude Code die Perforce-Änderungsverfolgung umgeht |

263| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Überschreiben Sie das Plugin-Stammverzeichnis. Trotz des Namens setzt dies das übergeordnete Verzeichnis, nicht den Cache selbst: Marketplaces und der Plugin-Cache befinden sich in Unterverzeichnissen unter diesem Pfad. Standardmäßig `~/.claude/plugins` |263| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Überschreiben Sie das Plugin-Stammverzeichnis. Trotz des Namens setzt dies das übergeordnete Verzeichnis, nicht den Cache selbst: Marketplaces und der Plugin-Cache befinden sich in Unterverzeichnissen unter diesem Pfad. Standardmäßig `~/.claude/plugins` |

264| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in Millisekunden für Git-Operationen beim Installieren oder Aktualisieren von Plugins (Standard: 120000). Erhöhen Sie diesen Wert für große Repositories oder langsame Netzwerkverbindungen. Siehe [Git-Operationen Timeout](/de/plugin-marketplaces#git-operations-time-out) |264| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in Millisekunden für Git-Operationen beim Installieren oder Aktualisieren von Plugins (Standard: 120000). Erhöhen Sie diesen Wert für große Repositories oder langsame Netzwerkverbindungen. Siehe [Git-Operationen Timeout](/docs/de/plugin-marketplaces#git-operations-time-out) |

265| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Setzen Sie auf `1`, um den vorhandenen Marketplace-Cache beizubehalten, wenn ein `git pull` fehlschlägt, anstatt ihn zu löschen und erneut zu klonen. Nützlich in Offline- oder Airgap-Umgebungen, in denen das erneute Klonen auf die gleiche Weise fehlschlagen würde. Siehe [Marketplace-Updates schlagen in Offline-Umgebungen fehl](/de/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |265| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Setzen Sie auf `1`, um den vorhandenen Marketplace-Cache beizubehalten, wenn ein `git pull` fehlschlägt, anstatt ihn zu löschen und erneut zu klonen. Nützlich in Offline- oder Airgap-Umgebungen, in denen das erneute Klonen auf die gleiche Weise fehlschlagen würde. Siehe [Marketplace-Updates schlagen in Offline-Umgebungen fehl](/docs/de/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |

266| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Setzen Sie auf `1`, um GitHub `owner/repo` Plugin-Quellen über HTTPS anstelle von SSH zu klonen. Nützlich in CI-Runnern, Containern oder einer beliebigen Umgebung ohne konfigurierten SSH-Schlüssel für `github.com` |266| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Setzen Sie auf `1`, um GitHub `owner/repo` Plugin-Quellen über HTTPS anstelle von SSH zu klonen. Nützlich in CI-Runnern, Containern oder einer beliebigen Umgebung ohne konfigurierten SSH-Schlüssel für `github.com` |

267| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Pfad zu einem oder mehreren schreibgeschützten Plugin-Seed-Verzeichnissen, getrennt durch `:` auf Unix oder `;` auf Windows. Verwenden Sie dies, um ein vorausgefülltes Plugins-Verzeichnis in ein Container-Image zu bündeln. Claude Code registriert Marketplaces aus diesen Verzeichnissen beim Start und verwendet vorgecachte Plugins ohne erneutes Klonen. Siehe [Plugins für Container vorausfüllen](/de/plugin-marketplaces#pre-populate-plugins-for-containers) |267| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Pfad zu einem oder mehreren schreibgeschützten Plugin-Seed-Verzeichnissen, getrennt durch `:` auf Unix oder `;` auf Windows. Verwenden Sie dies, um ein vorausgefülltes Plugins-Verzeichnis in ein Container-Image zu bündeln. Claude Code registriert Marketplaces aus diesen Verzeichnissen beim Start und verwendet vorgecachte Plugins ohne erneutes Klonen. Siehe [Plugins für Container vorausfüllen](/docs/de/plugin-marketplaces#pre-populate-plugins-for-containers) |

268| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Setzen Sie auf `1`, um Claude Code davon abzuhalten, `-ExecutionPolicy Bypass` beim Spawnen von PowerShell für Tool-Aufrufe, Hooks und Statuszeilen-Befehle zu übergeben, und respektieren Sie stattdessen die effektive Ausführungsrichtlinie des Computers. Standardmäßig umgeht Claude Code die Ausführungsrichtlinie im Prozessbereich, sodass `.ps1`-Skripte und Modul-Importe auf Standard-Restricted Windows-Installationen funktionieren. Prozessbereich-Bypass überschreibt niemals Group Policy `MachinePolicy` oder `UserPolicy`, unabhängig von dieser Einstellung |268| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Setzen Sie auf `1`, um Claude Code davon abzuhalten, `-ExecutionPolicy Bypass` beim Spawnen von PowerShell für Tool-Aufrufe, Hooks und Statuszeilen-Befehle zu übergeben, und respektieren Sie stattdessen die effektive Ausführungsrichtlinie des Computers. Standardmäßig umgeht Claude Code die Ausführungsrichtlinie im Prozessbereich, sodass `.ps1`-Skripte und Modul-Importe auf Standard-Restricted Windows-Installationen funktionieren. Prozessbereich-Bypass überschreibt niemals Group Policy `MachinePolicy` oder `UserPolicy`, unabhängig von dieser Einstellung |

269| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}Maximale Zeit in Millisekunden, die der [nicht-interaktive Modus](/de/headless#background-tasks-at-exit) mit dem Flag `-p` nach dem letzten Turn auf Hintergrund-Subagenten und Workflows wartet, deren Ergebnis Teil der Ausgabe ist. Standard: `600000` oder 10 Minuten. Wenn die Obergrenze überschritten wird, werden verbleibende Hintergrundaufgaben beendet und der Prozess beendet. Setzen Sie auf `0`, um unbegrenzt zu warten. Diese Obergrenze ist separat von der fünfsekündigen Kulanzfrist, die für einfache Hintergrund-Shells gilt |269| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Maximale Zeit in Millisekunden, die der [nicht-interaktive Modus](/docs/de/headless#background-tasks-at-exit) mit dem Flag `-p` nach dem letzten Turn auf Hintergrund-Subagenten und Workflows wartet, deren Ergebnis Teil der Ausgabe ist. Standard: `600000` oder 10 Minuten. Wenn die Obergrenze überschritten wird, werden verbleibende Hintergrundaufgaben beendet und der Prozess beendet. Setzen Sie auf `0`, um unbegrenzt zu warten. Diese Obergrenze ist separat von der fünfsekündigen Kulanzfrist, die für einfache Hintergrund-Shells gilt |

270| `CLAUDE_CODE_PROCESS_WRAPPER` | {/* min-version: 2.1.208 */}Starten Sie die Prozesse, die Claude Code von seiner eigenen Binärdatei aus startet, durch einen Wrapper-Executable, angegeben als argv-Präfix wie `/opt/corp/launcher`. Umfasst den Hintergrund-Service, der [Agent-Ansicht](/de/agent-view)-Sitzungen hostet, jede Sitzung, die er spawnt, und den Neustart, den Claude Code durchführt, um eine Aktualisierung zu beenden. Das erste Token muss der absolute Pfad einer ausführbaren Datei sein, die mit `exec "$@"` endet, und die meisten Launcher sind genau dieser einzelne Pfad. Der Wert ist eine Argumentliste, keine Shell-Befehl: Leerzeichen trennen Token, doppelte Anführungszeichen gruppieren einen Pfad, der Leerzeichen enthält, und ein Wert, der mit `[` beginnt, wird als JSON-String-Array gelesen. Setzen Sie es im `env`-Block von Benutzer- oder [verwalteten Einstellungen](/de/permissions#managed-settings), nicht als Shell-Export, damit der abgelöste Hintergrund-Service es erbt; Projekt- und lokale Einstellungen können es nicht setzen. Die VS Code-Erweiterung konfiguriert ihren eigenen Launcher separat über ihre `claudeProcessWrapper`-Einstellung. Wird unter Windows ignoriert. `CLAUDE_CODE_SHELL_PREFIX` ist eine separate Kontrolle: Sie umhüllt die Shell-Befehle, die Claude Code als einzelne zitierte Zeichenkette ausführt, während diese Variable Claude Codes eigene Prozesse als argv-Präfix umhüllt. Siehe [Claude Code hinter einem Corporate Launcher ausführen](/de/corporate-launcher) |270| `CLAUDE_CODE_PROCESS_WRAPPER` | Starten Sie die Prozesse, die Claude Code von seiner eigenen Binärdatei aus startet, durch einen Wrapper-Executable, angegeben als argv-Präfix wie `/opt/corp/launcher`. Umfasst den Hintergrund-Service, der [Agent-Ansicht](/docs/de/agent-view)-Sitzungen hostet, jede Sitzung, die er spawnt, und den Neustart, den Claude Code durchführt, um eine Aktualisierung zu beenden. Das erste Token muss der absolute Pfad einer ausführbaren Datei sein, die mit `exec "$@"` endet, und die meisten Launcher sind genau dieser einzelne Pfad. Der Wert ist eine Argumentliste, keine Shell-Befehl: Leerzeichen trennen Token, doppelte Anführungszeichen gruppieren einen Pfad, der Leerzeichen enthält, und ein Wert, der mit `[` beginnt, wird als JSON-String-Array gelesen. Setzen Sie es im `env`-Block von Benutzer- oder [verwalteten Einstellungen](/docs/de/permissions#managed-settings), nicht als Shell-Export, damit der abgelöste Hintergrund-Service es erbt; Projekt- und lokale Einstellungen können es nicht setzen. Die VS Code-Erweiterung konfiguriert ihren eigenen Launcher separat über ihre `claudeProcessWrapper`-Einstellung. Wird unter Windows ignoriert. `CLAUDE_CODE_SHELL_PREFIX` ist eine separate Kontrolle: Sie umhüllt die Shell-Befehle, die Claude Code als einzelne zitierte Zeichenkette ausführt, während diese Variable Claude Codes eigene Prozesse als argv-Präfix umhüllt. Siehe [Claude Code hinter einem Corporate Launcher ausführen](/docs/de/corporate-launcher) |

271| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Setzen Sie auf `1`, um W3C-Trace-Kontext zu propagieren, wenn `ANTHROPIC_BASE_URL` auf einen benutzerdefinierten Proxy verweist. Die Propagation umfasst den `traceparent`-Header auf Modell- und HTTP-MCP-Anfragen sowie die `TRACEPARENT`-Umgebungsvariable für Bash-, PowerShell- und Hook-Subprozesse. Standardmäßig ist die Propagation nur bei direkter Verbindung zur Anthropic API aktiviert. Hinzugefügt in v2.1.152. Siehe [Traces (Beta)](/de/monitoring-usage#traces-beta) |271| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Setzen Sie auf `1`, um W3C-Trace-Kontext zu propagieren, wenn `ANTHROPIC_BASE_URL` auf einen benutzerdefinierten Proxy verweist. Die Propagation umfasst den `traceparent`-Header auf Modell- und HTTP-MCP-Anfragen sowie die `TRACEPARENT`-Umgebungsvariable für Bash-, PowerShell- und Hook-Subprozesse. Standardmäßig ist die Propagation nur bei direkter Verbindung zur Anthropic API aktiviert. Hinzugefügt in v2.1.152. Siehe [Traces (Beta)](/docs/de/monitoring-usage#traces-beta) |

272| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Wird von Host-Plattformen gesetzt, die Claude Code einbetten und das Modell-Provider-Routing in ihrem Namen verwalten. Wenn gesetzt, werden Provider-Auswahl-, Endpunkt- und Authentifizierungsvariablen wie `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` und `ANTHROPIC_API_KEY` in Einstellungsdateien ignoriert, sodass Benutzereinstellungen das Routing des Hosts nicht überschreiben können. Die automatische Telemetrie-Abmeldung für Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry wird ebenfalls übersprungen, sodass die Telemetrie der Standard-`DISABLE_TELEMETRY`-Abmeldung folgt. Siehe [Standardverhalten nach API-Provider](/de/data-usage#default-behaviors-by-api-provider) |272| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Wird von Host-Plattformen gesetzt, die Claude Code einbetten und das Modell-Provider-Routing in ihrem Namen verwalten. Wenn gesetzt, werden Provider-Auswahl-, Endpunkt- und Authentifizierungsvariablen wie `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` und `ANTHROPIC_API_KEY` in Einstellungsdateien ignoriert, sodass Benutzereinstellungen das Routing des Hosts nicht überschreiben können. Die automatische Telemetrie-Abmeldung für Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry wird ebenfalls übersprungen, sodass die Telemetrie der Standard-`DISABLE_TELEMETRY`-Abmeldung folgt. Siehe [Standardverhalten nach API-Provider](/docs/de/data-usage#default-behaviors-by-api-provider) |

273| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Setzen Sie auf `1`, um dem Proxy zu ermöglichen, DNS-Auflösung durchzuführen, anstatt des Aufrufers. Opt-in für Umgebungen, in denen der Proxy die Hostname-Auflösung durchführen sollte |273| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Setzen Sie auf `1`, um dem Proxy zu ermöglichen, DNS-Auflösung durchzuführen, anstatt des Aufrufers. Opt-in für Umgebungen, in denen der Proxy die Hostname-Auflösung durchführen sollte |

274| `CLAUDE_CODE_REMOTE` | Wird automatisch auf `true` gesetzt, wenn Claude Code als [Cloud-Sitzung](/de/claude-code-on-the-web) ausgeführt wird. Lesen Sie dies aus einem Hook oder Setup-Skript, um zu erkennen, ob Sie sich in einer Cloud-Umgebung befinden |274| `CLAUDE_CODE_REMOTE` | Wird automatisch auf `true` gesetzt, wenn Claude Code als [Cloud-Sitzung](/docs/de/claude-code-on-the-web) ausgeführt wird. Lesen Sie dies aus einem Hook oder Setup-Skript, um zu erkennen, ob Sie sich in einer Cloud-Umgebung befinden |

275| `CLAUDE_CODE_REMOTE_SESSION_ID` | Wird automatisch in [Cloud-Sitzungen](/de/claude-code-on-the-web) auf die ID der aktuellen Sitzung gesetzt. Lesen Sie dies, um einen Link zurück zur Sitzungs-Abschrift zu erstellen. Siehe [Ausgabe zurück zur Sitzung verlinken](/de/claude-code-on-the-web#link-output-back-to-the-session) |275| `CLAUDE_CODE_REMOTE_SESSION_ID` | Wird automatisch in [Cloud-Sitzungen](/docs/de/claude-code-on-the-web) auf die ID der aktuellen Sitzung gesetzt. Lesen Sie dies, um einen Link zurück zur Sitzungs-Abschrift zu erstellen. Siehe [Ausgabe zurück zur Sitzung verlinken](/docs/de/claude-code-on-the-web#link-output-back-to-the-session) |

276| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Setzen Sie auf `1`, um automatisch fortzufahren, wenn die vorherige Sitzung mitten in einem Turn endete. Wird im SDK-Modus verwendet, damit das Modell fortfährt, ohne dass das SDK den Prompt erneut senden muss |276| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Setzen Sie auf `1`, um automatisch fortzufahren, wenn die vorherige Sitzung mitten in einem Turn endete. Wird im SDK-Modus verwendet, damit das Modell fortfährt, ohne dass das SDK den Prompt erneut senden muss |

277| `CLAUDE_CODE_RESUME_PROMPT` | Überschreiben Sie die Fortsetzungsmeldung, die eingefügt wird, wenn eine Sitzung fortgesetzt wird, die mitten in einem Turn endete. Standardmäßig `Continue from where you left off.`. Spawn-Skripte für lang laufende Agenten können dies auf eine direktere Boot-Nachricht setzen. Eine leere Zeichenkette verwendet den Standard |277| `CLAUDE_CODE_RESUME_PROMPT` | Überschreiben Sie die Fortsetzungsmeldung, die eingefügt wird, wenn eine Sitzung fortgesetzt wird, die mitten in einem Turn endete. Standardmäßig `Continue from where you left off.`. Spawn-Skripte für lang laufende Agenten können dies auf eine direktere Boot-Nachricht setzen. Eine leere Zeichenkette verwendet den Standard |

278| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}Setzen Sie auf `1` für unbeaufsichtigte Sitzungen wie Eval-Harnesses, CI-Jobs oder Remote-Worker. Wiederholt `429` und `529` Kapazitätsfehler unbegrenzt, anstatt nach `CLAUDE_CODE_MAX_RETRIES`-Versuchen zu fehlschlagen. Der Watchdog sichert sich bis zu 5 Minuten zwischen Versuchen ab, oder bis das Limit zurückgesetzt wird, wenn die Antwort eine Rate-Limit-Reset-Zeit trägt, sodass eine Sitzung, die ein Nutzungslimit trifft, das verbleibende Fenster abwartet. {/* min-version: 2.1.199 */}Ab v2.1.199 erhöht es auch die Standard-Wiederholungsanzahl für andere vorübergehende Fehler, wie z. B. Server-Fehler, Timeouts und gelöschte Verbindungen, auf 300, ungefähr drei Stunden Backoff, und entfernt die Obergrenze von 15 auf `CLAUDE_CODE_MAX_RETRIES`, wenn Sie diese Variable explizit setzen. Erfordert Claude Code v2.1.186 oder später |278| `CLAUDE_CODE_RETRY_WATCHDOG` | Setzen Sie auf `1` für unbeaufsichtigte Sitzungen wie Eval-Harnesses, CI-Jobs oder Remote-Worker. Wiederholt `429` und `529` Kapazitätsfehler unbegrenzt, anstatt nach `CLAUDE_CODE_MAX_RETRIES`-Versuchen zu fehlschlagen. Der Watchdog sichert sich bis zu 5 Minuten zwischen Versuchen ab, oder bis das Limit zurückgesetzt wird, wenn die Antwort eine Rate-Limit-Reset-Zeit trägt, sodass eine Sitzung, die ein Nutzungslimit trifft, das verbleibende Fenster abwartet. Ab v2.1.199 erhöht es auch die Standard-Wiederholungsanzahl für andere vorübergehende Fehler, wie z. B. Server-Fehler, Timeouts und gelöschte Verbindungen, auf 300, ungefähr drei Stunden Backoff, und entfernt die Obergrenze von 15 auf `CLAUDE_CODE_MAX_RETRIES`, wenn Sie diese Variable explizit setzen. Erfordert Claude Code v2.1.186 oder später |

279| `CLAUDE_CODE_SAFE_MODE` | Setzen Sie auf `1`, um im sicheren Modus zu starten: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Designs, benutzerdefinierte Tastenbindungen, Statuszeilen- und Datei-Vorschlag-Befehle, LSP-Server und automatisches Speichern werden nicht geladen, um eine fehlerhafte Konfiguration zu beheben. Verwaltete Einstellungsrichtlinie gilt weiterhin, einschließlich richtlinien-konfigurierter Hooks, Statuszeilen und Datei-Vorschlag-Befehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und richtlinien-konfigurierte MCP-Server nicht. Äquivalent zum Übergeben von [`--safe-mode`](/de/cli-reference#cli-flags). Direkt gespawnte untergeordnete Prozesse erben die Variable |279| `CLAUDE_CODE_SAFE_MODE` | Setzen Sie auf `1`, um im sicheren Modus zu starten: CLAUDE.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Designs, benutzerdefinierte Tastenbindungen, Statuszeilen- und Datei-Vorschlag-Befehle, LSP-Server und automatisches Speichern werden nicht geladen, um eine fehlerhafte Konfiguration zu beheben. Verwaltete Einstellungsrichtlinie gilt weiterhin, einschließlich richtlinien-konfigurierter Hooks, Statuszeilen und Datei-Vorschlag-Befehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und richtlinien-konfigurierte MCP-Server nicht. Äquivalent zum Übergeben von [`--safe-mode`](/docs/de/cli-reference#cli-flags). Direkt gespawnte untergeordnete Prozesse erben die Variable |

280| `CLAUDE_CODE_SCRIPT_CAPS` | JSON-Objekt, das begrenzt, wie oft bestimmte Skripte pro Sitzung aufgerufen werden können, wenn `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` gesetzt ist. Schlüssel sind Substrings, die gegen den Befehlstext abgeglichen werden; Werte sind ganzzahlige Aufruflimits. Zum Beispiel `{"deploy.sh": 2}` erlaubt `deploy.sh`, höchstens zweimal aufgerufen zu werden. Der Abgleich ist substring-basiert, daher zählen Shell-Erweiterungstricks wie `./scripts/deploy.sh $(evil)` weiterhin gegen das Limit. Runtime-Fan-out über `xargs` oder `find -exec` wird nicht erkannt; dies ist eine Defense-in-Depth-Kontrolle |280| `CLAUDE_CODE_SCRIPT_CAPS` | JSON-Objekt, das begrenzt, wie oft bestimmte Skripte pro Sitzung aufgerufen werden können, wenn `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` gesetzt ist. Schlüssel sind Substrings, die gegen den Befehlstext abgeglichen werden; Werte sind ganzzahlige Aufruflimits. Zum Beispiel `{"deploy.sh": 2}` erlaubt `deploy.sh`, höchstens zweimal aufgerufen zu werden. Der Abgleich ist substring-basiert, daher zählen Shell-Erweiterungstricks wie `./scripts/deploy.sh $(evil)` weiterhin gegen das Limit. Runtime-Fan-out über `xargs` oder `find -exec` wird nicht erkannt; dies ist eine Defense-in-Depth-Kontrolle |

281| `CLAUDE_CODE_SCROLL_SPEED` | Legen Sie den Mausrad-Scroll-Multiplikator in der [Vollbilddarstellung](/de/fullscreen#mouse-wheel-scrolling) fest. Akzeptiert Werte von 1 bis 20 und Bruchteile unter 1 wie `0,5`, um beschleunigtes Trackpad- und Mausrad-Scrolling in Terminals zu verlangsamen. Setzen Sie auf `3`, um `vim` zu entsprechen, wenn Ihr Terminal ein Mausrad-Ereignis pro Kerbe ohne Verstärkung sendet. Wird im JetBrains IDE-Terminal ignoriert, wo Claude Code sein eigenes Scroll-Handling verwendet |281| `CLAUDE_CODE_SCROLL_SPEED` | Legen Sie den Mausrad-Scroll-Multiplikator in der [Vollbilddarstellung](/docs/de/fullscreen#mouse-wheel-scrolling) fest. Akzeptiert Werte von 1 bis 20 und Bruchteile unter 1 wie `0,5`, um beschleunigtes Trackpad- und Mausrad-Scrolling in Terminals zu verlangsamen. Setzen Sie auf `3`, um `vim` zu entsprechen, wenn Ihr Terminal ein Mausrad-Ereignis pro Kerbe ohne Verstärkung sendet. Wird im JetBrains IDE-Terminal ignoriert, wo Claude Code sein eigenes Scroll-Handling verwendet |

282| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Überschreiben Sie das Zeitbudget in Millisekunden für [SessionEnd](/de/hooks#sessionend)-Hooks. Gilt für Sitzungsbeendigung, `/clear` und Wechsel von Sitzungen über interaktives `/resume`. Standardmäßig ist das Budget 1,5 Sekunden, automatisch erhöht auf das höchste pro-Hook `timeout`, das in Einstellungsdateien konfiguriert ist, bis zu 60 Sekunden. Timeouts auf Plugin-bereitgestellten Hooks erhöhen das Budget nicht |282| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Überschreiben Sie das Zeitbudget in Millisekunden für [SessionEnd](/docs/de/hooks#sessionend)-Hooks. Gilt für Sitzungsbeendigung, `/clear` und Wechsel von Sitzungen über interaktives `/resume`. Standardmäßig ist das Budget 1,5 Sekunden, automatisch erhöht auf das höchste pro-Hook `timeout`, das in Einstellungsdateien konfiguriert ist, bis zu 60 Sekunden. Timeouts auf Plugin-bereitgestellten Hooks erhöhen das Budget nicht |

283| `CLAUDE_CODE_SESSION_ID` | Wird automatisch in Bash- und PowerShell-Tool-Subprozessen, [Hook-Befehls](/de/hooks)-Subprozessen und stdio [MCP-Server](/de/mcp)-Subprozessen auf die aktuelle Sitzungs-ID gesetzt. Für Bash, PowerShell und Hooks entspricht dies dem Feld `session_id`, das in der Hook-JSON-Eingabe übergeben wird, und wird bei `/clear` aktualisiert. Ein MCP-Server-Subprozess behält die ID, mit der er gespawnt wurde. Bei `--resume <session-id>` erhält er die fortgesetzte ID, die Hooks und Bash entspricht. Bei `--continue` oder `--resume` ohne explizite ID kann er stattdessen die anfängliche Startup-ID erhalten. Verwenden Sie, um Skripte und externe Tools mit der Claude Code-Sitzung zu korrelieren, die sie gestartet hat |283| `CLAUDE_CODE_SESSION_ID` | Wird automatisch in Bash- und PowerShell-Tool-Subprozessen, [Hook-Befehls](/docs/de/hooks)-Subprozessen und stdio [MCP-Server](/docs/de/mcp)-Subprozessen auf die aktuelle Sitzungs-ID gesetzt. Für Bash, PowerShell und Hooks entspricht dies dem Feld `session_id`, das in der Hook-JSON-Eingabe übergeben wird, und wird bei `/clear` aktualisiert. Ein MCP-Server-Subprozess behält die ID, mit der er gespawnt wurde. Bei `--resume <session-id>` erhält er die fortgesetzte ID, die Hooks und Bash entspricht. Bei `--continue` oder `--resume` ohne explizite ID kann er stattdessen die anfängliche Startup-ID erhalten. Verwenden Sie, um Skripte und externe Tools mit der Claude Code-Sitzung zu korrelieren, die sie gestartet hat |

284| `CLAUDE_CODE_SHELL` | Legen Sie die Shell fest, die Claude Code zum Ausführen von Bash-Tool-Befehlen verwendet. Akzeptiert einen Pfad zu einer `bash` oder `zsh` Binärdatei, z. B. `/opt/homebrew/bin/bash`. Andere Shells wie `fish` werden nicht unterstützt. Wenn der Wert kein funktionierender `bash` oder `zsh` Pfad ist, ignoriert Claude Code ihn und fällt auf die automatische Erkennung zurück. Die automatische Erkennung verwendet Ihre `$SHELL`, wenn sie auf `bash` oder `zsh` verweist, ansonsten wählt sie die erste funktionierende `zsh` dann `bash` aus, die auf Ihrem `PATH` und in Standard-Installationsorten gefunden wird |284| `CLAUDE_CODE_SHELL` | Legen Sie die Shell fest, die Claude Code zum Ausführen von Bash-Tool-Befehlen verwendet. Akzeptiert einen Pfad zu einer `bash` oder `zsh` Binärdatei, z. B. `/opt/homebrew/bin/bash`. Andere Shells wie `fish` werden nicht unterstützt. Wenn der Wert kein funktionierender `bash` oder `zsh` Pfad ist, ignoriert Claude Code ihn und fällt auf die automatische Erkennung zurück. Die automatische Erkennung verwendet Ihre `$SHELL`, wenn sie auf `bash` oder `zsh` verweist, ansonsten wählt sie die erste funktionierende `zsh` dann `bash` aus, die auf Ihrem `PATH` und in Standard-Installationsorten gefunden wird |

285| `CLAUDE_CODE_SHELL_PREFIX` | Befehlspräfix zum Umhüllen von Shell-Befehlen, die Claude Code spawnt: Bash-Tool-Aufrufe, [Hook](/de/hooks)-Befehle, [Statuszeilen](/de/statusline)-Befehle und stdio [MCP-Server](/de/mcp)-Startup-Befehle. PowerShell-Hooks und Exec-Form-Hooks werden ohne das Präfix ausgeführt. Nützlich für Protokollierung oder Auditing. Das Setzen eines bloßen ausführbaren Dateipfads wie `/path/to/logger.sh` führt jeden Befehl als `/path/to/logger.sh '<command>'` aus. Der Wrapper erhält die Befehlszeile als einzelnes Shell-zitiertes Argument in `$1`, daher muss der Wrapper `$1` mit einer Shell neu auswerten, z. B. `exec bash -c "$1"`. Das Behandeln von `$1` als bloßer ausführbarer Dateipfad bricht stdio MCP-Server, die Argumente wie `npx -y <package>` übergeben. Für Bash-Tool-Aufrufe enthält `$1` die vollständige Shell-Invokation, die Claude Code zusammenstellt, einschließlich Umgebungssetup, nicht nur den Befehl, den Claude ausgeführt hat |285| `CLAUDE_CODE_SHELL_PREFIX` | Befehlspräfix zum Umhüllen von Shell-Befehlen, die Claude Code spawnt: Bash-Tool-Aufrufe, [Hook](/docs/de/hooks)-Befehle, [Statuszeilen](/docs/de/statusline)-Befehle und stdio [MCP-Server](/docs/de/mcp)-Startup-Befehle. PowerShell-Hooks und Exec-Form-Hooks werden ohne das Präfix ausgeführt. Nützlich für Protokollierung oder Auditing. Das Setzen eines bloßen ausführbaren Dateipfads wie `/path/to/logger.sh` führt jeden Befehl als `/path/to/logger.sh '<command>'` aus. Der Wrapper erhält die Befehlszeile als einzelnes Shell-zitiertes Argument in `$1`, daher muss der Wrapper `$1` mit einer Shell neu auswerten, z. B. `exec bash -c "$1"`. Das Behandeln von `$1` als bloßer ausführbarer Dateipfad bricht stdio MCP-Server, die Argumente wie `npx -y <package>` übergeben. Für Bash-Tool-Aufrufe enthält `$1` die vollständige Shell-Invokation, die Claude Code zusammenstellt, einschließlich Umgebungssetup, nicht nur den Befehl, den Claude ausgeführt hat |

286| `CLAUDE_CODE_SIMPLE` | Setzen Sie auf `1`, um mit einem minimalen System-Prompt und nur den Tools Bash, Datei lesen und Datei bearbeiten auszuführen. MCP-Tools aus `--mcp-config` sind weiterhin verfügbar. Deaktiviert die automatische Erkennung von Hooks, Skills, Plugins, MCP-Servern, automatisches Speichern und CLAUDE.md. OAuth-Token und Keychain-Anmeldedaten werden nicht gelesen, daher muss die Anthropic-Authentifizierung von `ANTHROPIC_API_KEY` oder einem `apiKeyHelper` in `--settings` stammen. Äquivalent zum Übergeben von [`--bare`](/de/headless#start-faster-with-bare-mode) |286| `CLAUDE_CODE_SIMPLE` | Setzen Sie auf `1`, um mit einem minimalen System-Prompt und nur den Tools Bash, Datei lesen und Datei bearbeiten auszuführen. MCP-Tools aus `--mcp-config` sind weiterhin verfügbar. Deaktiviert die automatische Erkennung von Hooks, Skills, Plugins, MCP-Servern, automatisches Speichern und CLAUDE.md. OAuth-Token und Keychain-Anmeldedaten werden nicht gelesen, daher muss die Anthropic-Authentifizierung von `ANTHROPIC_API_KEY` oder einem `apiKeyHelper` in `--settings` stammen. Äquivalent zum Übergeben von [`--bare`](/docs/de/headless#start-faster-with-bare-mode) |

287| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Setzen Sie auf `1`, um einen kürzeren System-Prompt und zusammengefasste Tool-Beschreibungen auf jedem Modell zu verwenden. Setzen Sie auf `0`, `false`, `no` oder `off`, um sich abzumelden, auch wenn das Experiment oder die Server-Konfiguration es ansonsten aktivieren würde. Der vollständige Tool-Satz, Hooks, MCP-Server und CLAUDE.md-Erkennung bleiben aktiviert |287| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Setzen Sie auf `1`, um einen kürzeren System-Prompt und zusammengefasste Tool-Beschreibungen auf jedem Modell zu verwenden. Setzen Sie auf `0`, `false`, `no` oder `off`, um sich abzumelden, auch wenn das Experiment oder die Server-Konfiguration es ansonsten aktivieren würde. Der vollständige Tool-Satz, Hooks, MCP-Server und CLAUDE.md-Erkennung bleiben aktiviert |

288| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Überspringen Sie die clientseitige Authentifizierung für [Claude Platform on AWS](/de/claude-platform-on-aws), für Gateways, die Anfragen selbst signieren |288| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Überspringen Sie die clientseitige Authentifizierung für [Claude Platform on AWS](/docs/de/claude-platform-on-aws), für Gateways, die Anfragen selbst signieren |

289| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | {/* min-version: 2.1.207 */}Setzen Sie auf `1`, um den In-Process-Cache von Anmeldedaten zu deaktivieren, die aus der AWS-Standard-Anmeldedatenkette aufgelöst werden, sodass Claude Code die Kette bei jeder API-Anfrage auflöst. Mit dem Cache aus fordert ein SSO-gestütztes Profil Anmeldedaten von IAM Identity Center bei jeder Anfrage an. Siehe [Anmeldedaten-Caching und Auflösungs-Timeout](/de/amazon-bedrock#credential-caching-and-resolution-timeout). Erfordert Claude Code v2.1.207 oder später |289| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Setzen Sie auf `1`, um den In-Process-Cache von Anmeldedaten zu deaktivieren, die aus der AWS-Standard-Anmeldedatenkette aufgelöst werden, sodass Claude Code die Kette bei jeder API-Anfrage auflöst. Mit dem Cache aus fordert ein SSO-gestütztes Profil Anmeldedaten von IAM Identity Center bei jeder Anfrage an. Siehe [Anmeldedaten-Caching und Auflösungs-Timeout](/docs/de/amazon-bedrock#credential-caching-and-resolution-timeout). Erfordert Claude Code v2.1.207 oder später |

290| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Überspringen Sie die AWS-Authentifizierung für Amazon Bedrock (z. B. bei Verwendung eines LLM-Gateways) |290| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Überspringen Sie die AWS-Authentifizierung für Amazon Bedrock (z. B. bei Verwendung eines LLM-Gateways) |

291| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Überspringen Sie die Azure-Authentifizierung für Microsoft Foundry, für einen Proxy oder ein Gateway, das seinen eigenen `Authorization`-Header injiziert. Claude Code sendet Anfragen ohne Azure-Anmeldedaten und behält den `Authorization`-Header, den Sie bereitstellen, z. B. durch `ANTHROPIC_CUSTOM_HEADERS`. Wird ignoriert, wenn `ANTHROPIC_FOUNDRY_API_KEY` oder `ANTHROPIC_FOUNDRY_AUTH_TOKEN` gesetzt ist. {/* min-version: 2.1.203 */}Vor v2.1.203 ließ diese Variable den Microsoft Foundry-Client nicht in der Lage, Anfragen zu senden, es sei denn, ein API-Schlüssel war auch gesetzt |291| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Überspringen Sie die Azure-Authentifizierung für Microsoft Foundry, für einen Proxy oder ein Gateway, das seinen eigenen `Authorization`-Header injiziert. Claude Code sendet Anfragen ohne Azure-Anmeldedaten und behält den `Authorization`-Header, den Sie bereitstellen, z. B. durch `ANTHROPIC_CUSTOM_HEADERS`. Wird ignoriert, wenn `ANTHROPIC_FOUNDRY_API_KEY` oder `ANTHROPIC_FOUNDRY_AUTH_TOKEN` gesetzt ist. Vor v2.1.203 ließ diese Variable den Microsoft Foundry-Client nicht in der Lage, Anfragen zu senden, es sei denn, ein API-Schlüssel war auch gesetzt |

292| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Überspringen Sie die AWS-Authentifizierung für Amazon Bedrock Mantle (z. B. bei Verwendung eines LLM-Gateways) |292| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Überspringen Sie die AWS-Authentifizierung für Amazon Bedrock Mantle (z. B. bei Verwendung eines LLM-Gateways) |

293| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Setzen Sie auf `1`, um das Schreiben von Prompt-Verlauf und Sitzungs-Abschriften auf die Festplatte zu überspringen. Sitzungen, die mit dieser Variablen gestartet werden, erscheinen nicht in `--resume`, `--continue` oder Up-Arrow-Verlauf. Nützlich für kurzlebige Skript-Sitzungen |293| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Setzen Sie auf `1`, um das Schreiben von Prompt-Verlauf und Sitzungs-Abschriften auf die Festplatte zu überspringen. Sitzungen, die mit dieser Variablen gestartet werden, erscheinen nicht in `--resume`, `--continue` oder Up-Arrow-Verlauf. Nützlich für kurzlebige Skript-Sitzungen |

294| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Überspringen Sie die Google-Authentifizierung für Google Cloud's Agent Platform (z. B. bei Verwendung eines LLM-Gateways) |294| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Überspringen Sie die Google-Authentifizierung für Google Cloud's Agent Platform (z. B. bei Verwendung eines LLM-Gateways) |

295| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Maximale Anzahl von aufeinanderfolgenden Malen, die ein [Stop](/de/hooks#stop) oder [SubagentStop](/de/hooks#subagentstop)-Hook den Turn vom Beenden blockieren kann, bevor Claude Code es überschreibt und den Turn trotzdem beendet (Standard: 8). Setzen Sie auf `0`, um die Obergrenze zu deaktivieren. Erhöhen Sie dies, wenn Ihr Hook legitim mehr Iterationen benötigt, um sich zu beheben |295| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Maximale Anzahl von aufeinanderfolgenden Malen, die ein [Stop](/docs/de/hooks#stop) oder [SubagentStop](/docs/de/hooks#subagentstop)-Hook den Turn vom Beenden blockieren kann, bevor Claude Code es überschreibt und den Turn trotzdem beendet (Standard: 8). Setzen Sie auf `0`, um die Obergrenze zu deaktivieren. Erhöhen Sie dies, wenn Ihr Hook legitim mehr Iterationen benötigt, um sich zu beheben |

296| `CLAUDE_CODE_SUBAGENT_MODEL` | Siehe [Modellkonfiguration](/de/model-config). {/* min-version: 2.1.196 */}Ab v2.1.196 ist das Setzen auf `inherit` dasselbe wie das Nichtsetzen; frühere Versionen behandelten `inherit` als eine Überschreibung, die jeden Subagenten auf das Modell der Hauptkonversation zwang |296| `CLAUDE_CODE_SUBAGENT_MODEL` | Siehe [Modellkonfiguration](/docs/de/model-config). Ab v2.1.196 ist das Setzen auf `inherit` dasselbe wie das Nichtsetzen; frühere Versionen behandelten `inherit` als eine Überschreibung, die jeden Subagenten auf das Modell der Hauptkonversation zwang |

297| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Setzen Sie auf `1`, um Anthropic- und Cloud-Provider-Anmeldedaten aus Subprocess-Umgebungen zu entfernen (Bash-Tool, Hooks, MCP-Stdio-Server). Der übergeordnete Claude-Prozess behält diese Anmeldedaten für API-Aufrufe, aber untergeordnete Prozesse können sie nicht lesen, was die Exposition gegenüber Prompt-Injection-Angriffen reduziert, die versuchen, Geheimnisse über Shell-Erweiterung zu exfiltrieren. Unter Linux führt dies auch Bash-Subprozesse in einem isolierten PID-Namespace aus, sodass sie Host-Prozessumgebungen über `/proc` nicht lesen können; als Nebeneffekt können `ps`, `pgrep` und `kill` Host-Prozesse nicht sehen oder signalisieren. `claude-code-action` setzt dies automatisch, wenn `allowed_non_write_users` konfiguriert ist |297| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Setzen Sie auf `1`, um Anthropic- und Cloud-Provider-Anmeldedaten aus Subprocess-Umgebungen zu entfernen (Bash-Tool, Hooks, MCP-Stdio-Server). Der übergeordnete Claude-Prozess behält diese Anmeldedaten für API-Aufrufe, aber untergeordnete Prozesse können sie nicht lesen, was die Exposition gegenüber Prompt-Injection-Angriffen reduziert, die versuchen, Geheimnisse über Shell-Erweiterung zu exfiltrieren. Unter Linux führt dies auch Bash-Subprozesse in einem isolierten PID-Namespace aus, sodass sie Host-Prozessumgebungen über `/proc` nicht lesen können; als Nebeneffekt können `ps`, `pgrep` und `kill` Host-Prozesse nicht sehen oder signalisieren. `claude-code-action` setzt dies automatisch, wenn `allowed_non_write_users` konfiguriert ist |

298| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Setzen Sie auf `1` im nicht-interaktiven Modus (das Flag `-p`), um auf den Abschluss der Plugin-Installation zu warten, bevor die erste Abfrage. Ohne dies werden Plugins im Hintergrund installiert und sind möglicherweise beim ersten Turn nicht verfügbar. Kombinieren Sie mit `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`, um die Wartezeit zu begrenzen |298| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Setzen Sie auf `1` im nicht-interaktiven Modus (das Flag `-p`), um auf den Abschluss der Plugin-Installation zu warten, bevor die erste Abfrage. Ohne dies werden Plugins im Hintergrund installiert und sind möglicherweise beim ersten Turn nicht verfügbar. Kombinieren Sie mit `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`, um die Wartezeit zu begrenzen |

299| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in Millisekunden für synchrone Plugin-Installation. Wenn überschritten, fährt Claude Code ohne Plugins fort und protokolliert einen Fehler. Kein Standard: Ohne diese Variable wartet die synchrone Installation bis zum Abschluss |299| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in Millisekunden für synchrone Plugin-Installation. Wenn überschritten, fährt Claude Code ohne Plugins fort und protokolliert einen Fehler. Kein Standard: Ohne diese Variable wartet die synchrone Installation bis zum Abschluss |

300| `CLAUDE_CODE_SYNC_SKILLS` | Setzen Sie auf `1`, um Ihre aktivierten claude.ai-Skills in `~/.claude/skills/` vor der ersten Abfrage herunterzuladen und alle 10 Minuten erneut zu synchronisieren. Gilt nur im nicht-interaktiven Modus mit dem Flag `-p`. Erfordert claude.ai-Authentifizierung. [Claude Code on the web](/de/claude-code-on-the-web)-Sitzungen erhalten Ihre aktivierten claude.ai-Skills automatisch; Sie müssen dies dort nicht setzen |300| `CLAUDE_CODE_SYNC_SKILLS` | Setzen Sie auf `1`, um Ihre aktivierten claude.ai-Skills in `~/.claude/skills/` vor der ersten Abfrage herunterzuladen und alle 10 Minuten erneut zu synchronisieren. Gilt nur im nicht-interaktiven Modus mit dem Flag `-p`. Erfordert claude.ai-Authentifizierung. [Claude Code on the web](/docs/de/claude-code-on-the-web)-Sitzungen erhalten Ihre aktivierten claude.ai-Skills automatisch; Sie müssen dies dort nicht setzen |

301| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout in Millisekunden für eine Mid-Session-Skills-Resynchronisierung, wenn `CLAUDE_CODE_SYNC_SKILLS` gesetzt ist (Standard: 30000). Begrenzt den Download, der ausgelöst wird, wenn der Host während der Sitzung ein Skill-Reload anfordert. Wenn überschritten, stoppt die Resynchronisierung und die verbleibenden Downloads werden im Hintergrund fortgesetzt |301| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout in Millisekunden für eine Mid-Session-Skills-Resynchronisierung, wenn `CLAUDE_CODE_SYNC_SKILLS` gesetzt ist (Standard: 30000). Begrenzt den Download, der ausgelöst wird, wenn der Host während der Sitzung ein Skill-Reload anfordert. Wenn überschritten, stoppt die Resynchronisierung und die verbleibenden Downloads werden im Hintergrund fortgesetzt |

302| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in Millisekunden für die erste Abfrage, um auf die anfängliche Skills-Synchronisierung zu warten, wenn `CLAUDE_CODE_SYNC_SKILLS` gesetzt ist (Standard: 5000). Wenn überschritten, wird die Abfrage fortgesetzt und die verbleibenden Skill-Downloads werden im Hintergrund fortgesetzt |302| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in Millisekunden für die erste Abfrage, um auf die anfängliche Skills-Synchronisierung zu warten, wenn `CLAUDE_CODE_SYNC_SKILLS` gesetzt ist (Standard: 5000). Wenn überschritten, wird die Abfrage fortgesetzt und die verbleibenden Skill-Downloads werden im Hintergrund fortgesetzt |

303| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Setzen Sie auf `false`, um Syntax-Hervorhebung in Diff-Ausgabe zu deaktivieren. Nützlich, wenn Farben Ihr Terminal-Setup beeinträchtigen. Um auch die Hervorhebung in Code-Blöcken und Datei-Vorschauen zu deaktivieren, verwenden Sie die Einstellung [`syntaxHighlightingDisabled`](/de/settings) |303| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Setzen Sie auf `false`, um Syntax-Hervorhebung in Diff-Ausgabe zu deaktivieren. Nützlich, wenn Farben Ihr Terminal-Setup beeinträchtigen. Um auch die Hervorhebung in Code-Blöcken und Datei-Vorschauen zu deaktivieren, verwenden Sie die Einstellung [`syntaxHighlightingDisabled`](/docs/de/settings) |

304| `CLAUDE_CODE_TASK_LIST_ID` | Teilen Sie eine Aufgabenliste über Sitzungen hinweg. Setzen Sie dieselbe ID in mehreren Claude Code-Instanzen, um an einer gemeinsamen Aufgabenliste zu koordinieren. Siehe [Aufgabenliste](/de/interactive-mode#task-list) |304| `CLAUDE_CODE_TASK_LIST_ID` | Teilen Sie eine Aufgabenliste über Sitzungen hinweg. Setzen Sie dieselbe ID in mehreren Claude Code-Instanzen, um an einer gemeinsamen Aufgabenliste zu koordinieren. Siehe [Aufgabenliste](/docs/de/interactive-mode#task-list) |

305| `CLAUDE_CODE_TEAM_NAME` | Name des Agent-Teams, zu dem dieser Teamkollege gehört. Automatisch auf [Agent-Team](/de/agent-teams)-Mitgliedern gesetzt |305| `CLAUDE_CODE_TEAM_NAME` | Name des Agent-Teams, zu dem dieser Teamkollege gehört. Automatisch auf [Agent-Team](/docs/de/agent-teams)-Mitgliedern gesetzt |

306| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | {/* min-version: 2.1.206 */}Überschreiben Sie, in Millisekunden, wie lange eine nicht-interaktive Sitzung beim Beenden auf das Abbau ihres [Agent-Teams](/de/agent-teams) wartet. Akzeptiert 1000 bis 60000; ein Wert außerhalb des Bereichs wird ignoriert und der Standard von 10000 gilt. Erfordert Claude Code v2.1.206 oder später |306| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Überschreiben Sie, in Millisekunden, wie lange eine nicht-interaktive Sitzung beim Beenden auf das Abbau ihres [Agent-Teams](/docs/de/agent-teams) wartet. Akzeptiert 1000 bis 60000; ein Wert außerhalb des Bereichs wird ignoriert und der Standard von 10000 gilt. Erfordert Claude Code v2.1.206 oder später |

307| `CLAUDE_CODE_TMPDIR` | Überschreiben Sie das Temp-Verzeichnis, das für interne Temp-Dateien verwendet wird. Claude Code hängt `/claude-{uid}/` (Unix) oder `/claude/` (Windows) an diesen Pfad an. Standard: `/tmp` auf macOS, `os.tmpdir()` auf Linux und Windows. {/* min-version: 2.1.161 */}Ab v2.1.161 erhalten [Sandboxed](/de/sandboxing) Bash-Subprozesse auf macOS und Linux einen kurzen Fallback-`$TMPDIR` unter dem Systemstandard, wenn Ihr Override ein langer Pfad ist, da einige Tools fehlschlagen, wenn Temp-Pfade zu lang werden. Nicht-Sandboxed Bash-Befehle erben Ihren Shell-`$TMPDIR` unverändert. Claude Codes eigene Temp-Dateien verwenden immer Ihren Override |307| `CLAUDE_CODE_TMPDIR` | Überschreiben Sie das Temp-Verzeichnis, das für interne Temp-Dateien verwendet wird. Claude Code hängt `/claude-{uid}/` (Unix) oder `/claude/` (Windows) an diesen Pfad an. Standard: `/tmp` auf macOS, `os.tmpdir()` auf Linux und Windows. Ab v2.1.161 erhalten [Sandboxed](/docs/de/sandboxing) Bash-Subprozesse auf macOS und Linux einen kurzen Fallback-`$TMPDIR` unter dem Systemstandard, wenn Ihr Override ein langer Pfad ist, da einige Tools fehlschlagen, wenn Temp-Pfade zu lang werden. Nicht-Sandboxed Bash-Befehle erben Ihren Shell-`$TMPDIR` unverändert. Claude Codes eigene Temp-Dateien verwenden immer Ihren Override |

308| `CLAUDE_CODE_TMUX_TRUECOLOR` | Setzen Sie auf `1`, um 24-Bit-Truecolor-Ausgabe in tmux zu ermöglichen. Standardmäßig begrenzt Claude Code auf 256 Farben, wenn `$TMUX` gesetzt ist, da tmux Truecolor-Escape-Sequenzen nicht durchleitet, es sei denn, es ist konfiguriert. Setzen Sie dies nach dem Hinzufügen von `set -ga terminal-overrides ',*:Tc'` zu Ihrer `~/.tmux.conf`. Siehe [Terminal-Konfiguration](/de/terminal-config) für andere tmux-Einstellungen |308| `CLAUDE_CODE_TMUX_TRUECOLOR` | Setzen Sie auf `1`, um 24-Bit-Truecolor-Ausgabe in tmux zu ermöglichen. Standardmäßig begrenzt Claude Code auf 256 Farben, wenn `$TMUX` gesetzt ist, da tmux Truecolor-Escape-Sequenzen nicht durchleitet, es sei denn, es ist konfiguriert. Setzen Sie dies nach dem Hinzufügen von `set -ga terminal-overrides ',*:Tc'` zu Ihrer `~/.tmux.conf`. Siehe [Terminal-Konfiguration](/docs/de/terminal-config) für andere tmux-Einstellungen |

312| `CLAUDE_CODE_USE_MANTLE` | Verwenden Sie den Amazon Bedrock-[Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) |312| `CLAUDE_CODE_USE_MANTLE` | Verwenden Sie den Amazon Bedrock-[Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) |

313| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Setzen Sie auf `1`, um benutzerdefinierte Befehle, Subagenten und Ausgabestile mit Node.js-Datei-APIs anstelle von ripgrep zu ermitteln. Setzen Sie dies, wenn die gebündelte ripgrep-Binärdatei in Ihrer Umgebung nicht verfügbar oder blockiert ist. Beeinflusst nicht die Grep- oder Datei-Such-Tools |313| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Setzen Sie auf `1`, um benutzerdefinierte Befehle, Subagenten und Ausgabestile mit Node.js-Datei-APIs anstelle von ripgrep zu ermitteln. Setzen Sie dies, wenn die gebündelte ripgrep-Binärdatei in Ihrer Umgebung nicht verfügbar oder blockiert ist. Beeinflusst nicht die Grep- oder Datei-Such-Tools |

314| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Steuert das PowerShell-Tool. Unter Windows ohne Git Bash ist das Tool automatisch aktiviert; setzen Sie auf `0`, um es zu deaktivieren. Unter Windows mit installiertem Git Bash wird das Tool schrittweise eingeführt: Setzen Sie auf `1`, um sich anzumelden, oder auf `0`, um sich abzumelden. Unter Linux, macOS und WSL setzen Sie auf `1`, um es zu aktivieren, was `pwsh` auf Ihrem `PATH` erfordert. Wenn unter Windows aktiviert, kann Claude PowerShell-Befehle nativ ausführen, anstatt sie durch Git Bash zu leiten. Siehe [PowerShell-Tool](/de/tools-reference#powershell-tool) |314| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Steuert das PowerShell-Tool. Unter Windows ohne Git Bash ist das Tool automatisch aktiviert; setzen Sie auf `0`, um es zu deaktivieren. Unter Windows mit installiertem Git Bash wird das Tool schrittweise eingeführt: Setzen Sie auf `1`, um sich anzumelden, oder auf `0`, um sich abzumelden. Unter Linux, macOS und WSL setzen Sie auf `1`, um es zu aktivieren, was `pwsh` auf Ihrem `PATH` erfordert. Wenn unter Windows aktiviert, kann Claude PowerShell-Befehle nativ ausführen, anstatt sie durch Git Bash zu leiten. Siehe [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) |

316| `CLAUDE_CONFIG_DIR` | Überschreiben Sie das Konfigurationsverzeichnis (Standard: `~/.claude`). Alle Einstellungen, Sitzungsverlauf und Plugins werden unter diesem Pfad gespeichert, ebenso wie Anmeldedaten unter Linux und Windows; auf macOS befinden sich Anmeldedaten im System Keychain. Nützlich zum Ausführen mehrerer Konten nebeneinander: z. B. `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |316| `CLAUDE_CONFIG_DIR` | Überschreiben Sie das Konfigurationsverzeichnis (Standard: `~/.claude`). Alle Einstellungen, Sitzungsverlauf und Plugins werden unter diesem Pfad gespeichert, ebenso wie Anmeldedaten unter Linux und Windows; auf macOS befinden sich Anmeldedaten im System Keychain. Nützlich zum Ausführen mehrerer Konten nebeneinander: z. B. `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

317| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}Setzen Sie auf `1`, um in-flight Hintergrundarbeit zu stoppen, anstatt sie zu übernehmen, wenn Sie eine Sitzung durch Drücken von `←` oder mit [`/background`](/de/agent-view#from-inside-a-session) in den Hintergrund verschieben. Claude Code fragt Sie zur Bestätigung auf, bevor Sie in den Hintergrund verschieben, und stoppt dann die Aufgaben, die ansonsten übernommen würden. Erfordert Claude Code v2.1.195 oder später |317| `CLAUDE_DISABLE_ADOPT` | Setzen Sie auf `1`, um in-flight Hintergrundarbeit zu stoppen, anstatt sie zu übernehmen, wenn Sie eine Sitzung durch Drücken von `←` oder mit [`/background`](/docs/de/agent-view#from-inside-a-session) in den Hintergrund verschieben. Claude Code fragt Sie zur Bestätigung auf, bevor Sie in den Hintergrund verschieben, und stoppt dann die Aufgaben, die ansonsten übernommen würden. Erfordert Claude Code v2.1.195 oder später |

318| `CLAUDE_EFFORT` | Wird automatisch in Bash-Tool-Subprozessen und Hook-Befehlen auf die aktive [Anstrengungsstufe](/de/model-config#adjust-effort-level) für den Turn gesetzt: `low`, `medium`, `high`, `xhigh` oder `max`. Ultracode ist keine separate Stufe und wird als `xhigh` gemeldet. Entspricht dem Feld `effort.level`, das an [Hooks](/de/hooks) übergeben wird. Wird nur gesetzt, wenn das aktuelle Modell den Effort-Parameter unterstützt |318| `CLAUDE_EFFORT` | Wird automatisch in Bash-Tool-Subprozessen und Hook-Befehlen auf die aktive [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) für den Turn gesetzt: `low`, `medium`, `high`, `xhigh` oder `max`. Ultracode ist keine separate Stufe und wird als `xhigh` gemeldet. Entspricht dem Feld `effort.level`, das an [Hooks](/docs/de/hooks) übergeben wird. Wird nur gesetzt, wenn das aktuelle Modell den Effort-Parameter unterstützt |

319| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Setzen Sie auf `1`, um den Byte-Level-Streaming-Idle-Watchdog zu erzwingen, oder auf `0`, um ihn zu deaktivieren. Wenn nicht gesetzt, ist der Watchdog standardmäßig für direkte Anthropic API- und [Claude Platform on AWS](/de/claude-platform-on-aws)-Verbindungen aktiviert. Der Byte-Watchdog bricht eine Verbindung ab, wenn für 180 Sekunden standardmäßig bei direkten Anthropic API-Verbindungen, 300 Sekunden bei Claude Platform on AWS und bei Aktivierung auf Amazon Bedrock oder für den Wert von `CLAUDE_STREAM_IDLE_TIMEOUT_MS` keine Bytes auf dem Draht ankommen, wenn dieser gesetzt ist, was auf ein Minimum von 5 Minuten begrenzt ist, unabhängig vom Event-Level-Watchdog |319| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Setzen Sie auf `1`, um den Byte-Level-Streaming-Idle-Watchdog zu erzwingen, oder auf `0`, um ihn zu deaktivieren. Wenn nicht gesetzt, ist der Watchdog standardmäßig für direkte Anthropic API- und [Claude Platform on AWS](/docs/de/claude-platform-on-aws)-Verbindungen aktiviert. Der Byte-Watchdog bricht eine Verbindung ab, wenn für 180 Sekunden standardmäßig bei direkten Anthropic API-Verbindungen, 300 Sekunden bei Claude Platform on AWS und bei Aktivierung auf Amazon Bedrock oder für den Wert von `CLAUDE_STREAM_IDLE_TIMEOUT_MS` keine Bytes auf dem Draht ankommen, wenn dieser gesetzt ist, was auf ein Minimum von 5 Minuten begrenzt ist, unabhängig vom Event-Level-Watchdog |

320| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Setzen Sie auf `1`, um den Byte-Level-Streaming-Idle-Watchdog auf Amazon Bedrock `vnd.amazon.eventstream`-Antworten zu aktivieren. Standardmäßig aus. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |320| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Setzen Sie auf `1`, um den Byte-Level-Streaming-Idle-Watchdog auf Amazon Bedrock `vnd.amazon.eventstream`-Antworten zu aktivieren. Standardmäßig aus. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

321| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Setzen Sie auf `0`, um den Event-Level-Streaming-Idle-Watchdog zu deaktivieren, oder auf `1`, um ihn zu erzwingen. {/* min-version: 2.1.196 */}Wenn nicht gesetzt, ist der Watchdog standardmäßig für alle Provider aktiviert. Vor v2.1.196 war der nicht gesetzte Standard Server-gesteuert auf der direkten Anthropic API und aus auf anderen Providern. {/* min-version: 2.1.169 */}Ab v2.1.169 haben Provider außer der direkten Anthropic API und Claude Platform on AWS auch ein Standard-On 5-Minuten-Body-Idle-Timeout unabhängig von dieser Variablen; siehe `API_FORCE_IDLE_TIMEOUT`. Auf Amazon Bedrock können Sie auch den unabhängigen Byte-Level-Watchdog mit `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` aktivieren; die beiden laufen zusammen, wenn beide gesetzt sind. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |321| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Setzen Sie auf `0`, um den Event-Level-Streaming-Idle-Watchdog zu deaktivieren, oder auf `1`, um ihn zu erzwingen. Wenn nicht gesetzt, ist der Watchdog standardmäßig für alle Provider aktiviert. Vor v2.1.196 war der nicht gesetzte Standard Server-gesteuert auf der direkten Anthropic API und aus auf anderen Providern. Ab v2.1.169 haben Provider außer der direkten Anthropic API und Claude Platform on AWS auch ein Standard-On 5-Minuten-Body-Idle-Timeout unabhängig von dieser Variablen; siehe `API_FORCE_IDLE_TIMEOUT`. Auf Amazon Bedrock können Sie auch den unabhängigen Byte-Level-Watchdog mit `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` aktivieren; die beiden laufen zusammen, wenn beide gesetzt sind. Konfigurieren Sie das Timeout mit `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

322| `CLAUDE_ENV_FILE` | Pfad zu einem Shell-Skript, dessen Inhalte Claude Code vor jedem Bash-Befehl im gleichen Shell-Prozess ausführt, sodass Exporte in der Datei für den Befehl sichtbar sind. Verwenden Sie, um virtualenv- oder Conda-Aktivierung über Befehle hinweg beizubehalten. Wird auch dynamisch von [SessionStart](/de/hooks#persist-environment-variables), [Setup](/de/hooks#setup), [CwdChanged](/de/hooks#cwdchanged) und [FileChanged](/de/hooks#filechanged)-Hooks gefüllt |322| `CLAUDE_ENV_FILE` | Pfad zu einem Shell-Skript, dessen Inhalte Claude Code vor jedem Bash-Befehl im gleichen Shell-Prozess ausführt, sodass Exporte in der Datei für den Befehl sichtbar sind. Verwenden Sie, um virtualenv- oder Conda-Aktivierung über Befehle hinweg beizubehalten. Wird auch dynamisch von [SessionStart](/docs/de/hooks#persist-environment-variables), [Setup](/docs/de/hooks#setup), [CwdChanged](/docs/de/hooks#cwdchanged) und [FileChanged](/docs/de/hooks#filechanged)-Hooks gefüllt |

323| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Präfix für automatisch generierte [Remote Control](/de/remote-control)-Sitzungsnamen, wenn kein expliziter Name angegeben ist. Standardmäßig der Hostname Ihres Computers, was Namen wie `myhost-graceful-unicorn` erzeugt. Das CLI-Flag `--remote-control-session-name-prefix` setzt denselben Wert für einen einzelnen Aufruf |323| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Präfix für automatisch generierte [Remote Control](/docs/de/remote-control)-Sitzungsnamen, wenn kein expliziter Name angegeben ist. Standardmäßig der Hostname Ihres Computers, was Namen wie `myhost-graceful-unicorn` erzeugt. Das CLI-Flag `--remote-control-session-name-prefix` setzt denselben Wert für einen einzelnen Aufruf |

324| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in Millisekunden, bevor der Streaming-Idle-Watchdog eine stillgelegte Verbindung schließt. Wenn Sie diese Variable explizit setzen, ist das Minimum `300000` (5 Minuten); niedrigere Werte werden stillschweigend auf die Obergrenze begrenzt, um erweiterte Denk-Pausen und Proxy-Pufferung zu absorbieren. Wenn nicht gesetzt, beträgt der Event-Level-Watchdog-Standard 300 Sekunden und der Byte-Level-Watchdog-Standard 180 Sekunden bei direkten Anthropic API-Verbindungen (300 Sekunden bei Claude Platform on AWS und anderen Providern). Das nicht gesetzte 180-Sekunden-Byte-Watchdog-Standard ist ein separater Wert und unterliegt nicht der 5-Minuten-Obergrenze. Das Body-Idle-Timeout, das unter `API_FORCE_IDLE_TIMEOUT` beschrieben wird, gilt unabhängig. Auf Amazon Bedrock gilt auch, wenn `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |324| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in Millisekunden, bevor der Streaming-Idle-Watchdog eine stillgelegte Verbindung schließt. Wenn Sie diese Variable explizit setzen, ist das Minimum `300000` (5 Minuten); niedrigere Werte werden stillschweigend auf die Obergrenze begrenzt, um erweiterte Denk-Pausen und Proxy-Pufferung zu absorbieren. Wenn nicht gesetzt, beträgt der Event-Level-Watchdog-Standard 300 Sekunden und der Byte-Level-Watchdog-Standard 180 Sekunden bei direkten Anthropic API-Verbindungen (300 Sekunden bei Claude Platform on AWS und anderen Providern). Das nicht gesetzte 180-Sekunden-Byte-Watchdog-Standard ist ein separater Wert und unterliegt nicht der 5-Minuten-Obergrenze. Das Body-Idle-Timeout, das unter `API_FORCE_IDLE_TIMEOUT` beschrieben wird, gilt unabhängig. Auf Amazon Bedrock gilt auch, wenn `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |

325| `DEBUG` | Setzen Sie auf `1`, um Debug-Modus zu aktivieren, äquivalent zum Starten mit [`--debug`](/de/cli-reference#cli-flags). Debug-Protokolle werden in `~/.claude/debug/<session-id>.txt` geschrieben, oder in den Pfad, der von `CLAUDE_CODE_DEBUG_LOGS_DIR` gesetzt ist. Nur die wahren Werte `1`, `true`, `yes` und `on` aktivieren Debug-Modus, daher triggern Namespace-Muster wie `DEBUG=express:*`, die für andere Tools gesetzt sind, es nicht |325| `DEBUG` | Setzen Sie auf `1`, um Debug-Modus zu aktivieren, äquivalent zum Starten mit [`--debug`](/docs/de/cli-reference#cli-flags). Debug-Protokolle werden in `~/.claude/debug/<session-id>.txt` geschrieben, oder in den Pfad, der von `CLAUDE_CODE_DEBUG_LOGS_DIR` gesetzt ist. Nur die wahren Werte `1`, `true`, `yes` und `on` aktivieren Debug-Modus, daher triggern Namespace-Muster wie `DEBUG=express:*`, die für andere Tools gesetzt sind, es nicht |

326| `DISABLE_AUTOUPDATER` | Setzen Sie auf `1`, um automatische Hintergrund-Updates zu deaktivieren. Manuelles `claude update` funktioniert weiterhin. Verwenden Sie `DISABLE_UPDATES`, um beide zu blockieren |326| `DISABLE_AUTOUPDATER` | Setzen Sie auf `1`, um automatische Hintergrund-Updates zu deaktivieren. Manuelles `claude update` funktioniert weiterhin. Verwenden Sie `DISABLE_UPDATES`, um beide zu blockieren |

327| `DISABLE_AUTO_COMPACT` | Setzen Sie auf `1`, um die automatische Komprimierung bei Annäherung an das Kontextlimit zu deaktivieren. Der manuelle `/compact`-Befehl bleibt verfügbar. Verwenden Sie, wenn Sie explizite Kontrolle darüber wünschen, wann Komprimierung auftritt |327| `DISABLE_AUTO_COMPACT` | Setzen Sie auf `1`, um die automatische Komprimierung bei Annäherung an das Kontextlimit zu deaktivieren. Der manuelle `/compact`-Befehl bleibt verfügbar. Verwenden Sie, wenn Sie explizite Kontrolle darüber wünschen, wann Komprimierung auftritt |

328| `DISABLE_COMPACT` | Setzen Sie auf `1`, um alle Komprimierung zu deaktivieren: sowohl automatische Komprimierung als auch den manuellen `/compact`-Befehl |328| `DISABLE_COMPACT` | Setzen Sie auf `1`, um alle Komprimierung zu deaktivieren: sowohl automatische Komprimierung als auch den manuellen `/compact`-Befehl |

337| `DISABLE_INTERLEAVED_THINKING` | Setzen Sie auf `1`, um das Senden des interleaved-thinking Beta-Headers zu verhindern. Nützlich, wenn Ihr LLM-Gateway oder Provider [interleaved thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) nicht unterstützt |337| `DISABLE_INTERLEAVED_THINKING` | Setzen Sie auf `1`, um das Senden des interleaved-thinking Beta-Headers zu verhindern. Nützlich, wenn Ihr LLM-Gateway oder Provider [interleaved thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) nicht unterstützt |

338| `DISABLE_LOGIN_COMMAND` | Setzen Sie auf `1`, um den `/login`-Befehl auszublenden. Nützlich, wenn die Authentifizierung extern über API-Schlüssel oder `apiKeyHelper` erfolgt |338| `DISABLE_LOGIN_COMMAND` | Setzen Sie auf `1`, um den `/login`-Befehl auszublenden. Nützlich, wenn die Authentifizierung extern über API-Schlüssel oder `apiKeyHelper` erfolgt |

340| `DISABLE_PROMPT_CACHING` | Setzen Sie auf `1`, um [Prompt-Caching](/de/prompt-caching#disable-prompt-caching) für alle Modelle zu deaktivieren (hat Vorrang vor modellspezifischen Einstellungen) |340| `DISABLE_PROMPT_CACHING` | Setzen Sie auf `1`, um [Prompt-Caching](/docs/de/prompt-caching#disable-prompt-caching) für alle Modelle zu deaktivieren (hat Vorrang vor modellspezifischen Einstellungen) |

346| `DISABLE_UPDATES` | Setzen Sie auf `1`, um alle Updates zu blockieren, einschließlich manuelles `claude update` und `claude install`. Strenger als `DISABLE_AUTOUPDATER`. Verwenden Sie, wenn Sie Claude Code über Ihre eigenen Kanäle verteilen und Benutzer sich nicht selbst aktualisieren sollten |346| `DISABLE_UPDATES` | Setzen Sie auf `1`, um alle Updates zu blockieren, einschließlich manuelles `claude update` und `claude install`. Strenger als `DISABLE_AUTOUPDATER`. Verwenden Sie, wenn Sie Claude Code über Ihre eigenen Kanäle verteilen und Benutzer sich nicht selbst aktualisieren sollten |

348| `DO_NOT_TRACK` | Setzen Sie auf `1`, um sich von Telemetrie abzumelden. Äquivalent zum Setzen von `DISABLE_TELEMETRY`. Claude Code ehrt dies als die Cross-Tool-Konvention, die von vielen Entwickler-CLIs anerkannt wird |348| `DO_NOT_TRACK` | Setzen Sie auf `1`, um sich von Telemetrie abzumelden. Äquivalent zum Setzen von `DISABLE_TELEMETRY`. Claude Code ehrt dies als die Cross-Tool-Konvention, die von vielen Entwickler-CLIs anerkannt wird |

349| `ENABLE_CLAUDEAI_MCP_SERVERS` | Setzen Sie auf `false`, um [claude.ai MCP-Server](/de/mcp#use-mcp-servers-from-claude-ai) in Claude Code zu deaktivieren. Standardmäßig für angemeldete Benutzer aktiviert. Um pro-Projekt oder pro-Org zu deaktivieren, setzen Sie stattdessen [`disableClaudeAiConnectors`](/de/settings#available-settings) in Einstellungen |349| `ENABLE_CLAUDEAI_MCP_SERVERS` | Setzen Sie auf `false`, um [claude.ai MCP-Server](/docs/de/mcp#use-mcp-servers-from-claude-ai) in Claude Code zu deaktivieren. Standardmäßig für angemeldete Benutzer aktiviert. Um pro-Projekt oder pro-Org zu deaktivieren, setzen Sie stattdessen [`disableClaudeAiConnectors`](/docs/de/settings#available-settings) in Einstellungen |

350| `ENABLE_PROMPT_CACHING_1H` | Setzen Sie auf `1`, um eine 1-Stunden-[Prompt-Cache-TTL](/de/prompt-caching#cache-lifetime) anstelle der Standard-5-Minuten anzufordern. Vorgesehen für API-Schlüssel-, [Amazon Bedrock](/de/amazon-bedrock)-, [Google Cloud's Agent Platform](/de/google-vertex-ai)-, [Microsoft Foundry](/de/microsoft-foundry)- und [Claude Platform on AWS](/de/claude-platform-on-aws)-Benutzer. Abonnement-Benutzer erhalten automatisch 1-Stunden-TTL. 1-Stunden-Cache-Schreibvorgänge werden mit einer höheren Rate abgerechnet |350| `ENABLE_PROMPT_CACHING_1H` | Setzen Sie auf `1`, um eine 1-Stunden-[Prompt-Cache-TTL](/docs/de/prompt-caching#cache-lifetime) anstelle der Standard-5-Minuten anzufordern. Vorgesehen für API-Schlüssel-, [Amazon Bedrock](/docs/de/amazon-bedrock)-, [Google Cloud's Agent Platform](/docs/de/google-vertex-ai)-, [Microsoft Foundry](/docs/de/microsoft-foundry)- und [Claude Platform on AWS](/docs/de/claude-platform-on-aws)-Benutzer. Abonnement-Benutzer erhalten automatisch 1-Stunden-TTL. 1-Stunden-Cache-Schreibvorgänge werden mit einer höheren Rate abgerechnet |

352| `ENABLE_TOOL_SEARCH` | Steuert [MCP-Tool-Suche](/de/mcp#scale-with-mcp-tool-search). Nicht gesetzt: alle MCP-Tools standardmäßig aufgeschoben, aber upfront geladen auf Google Cloud's Agent Platform oder wenn `ANTHROPIC_BASE_URL` auf einen Nicht-First-Party-Host verweist. Werte: `true` (immer aufgeschoben und Beta-Header senden, Anfragen schlagen auf Google Cloud's Agent Platform-Modellen älter als Sonnet 4.5 oder Opus 4.5 fehl, oder auf Proxies, die `tool_reference` nicht unterstützen), `auto` (Schwellenwertmodus: upfront laden, wenn Tools in 10 % des Kontexts passen), `auto:N` (benutzerdefinierter Schwellenwert, z. B. `auto:5` für 5 %), `false` (alle upfront laden). Ignoriert, wenn `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` gesetzt ist, was alle Tools upfront laden erzwingt |352| `ENABLE_TOOL_SEARCH` | Steuert [MCP-Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search). Nicht gesetzt: alle MCP-Tools standardmäßig aufgeschoben, aber upfront geladen auf Google Cloud's Agent Platform oder wenn `ANTHROPIC_BASE_URL` auf einen Nicht-First-Party-Host verweist. Werte: `true` (immer aufgeschoben und Beta-Header senden, Anfragen schlagen auf Google Cloud's Agent Platform-Modellen älter als Sonnet 4.5 oder Opus 4.5 fehl, oder auf Proxies, die `tool_reference` nicht unterstützen), `auto` (Schwellenwertmodus: upfront laden, wenn Tools in 10 % des Kontexts passen), `auto:N` (benutzerdefinierter Schwellenwert, z. B. `auto:5` für 5 %), `false` (alle upfront laden). Ignoriert, wenn `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` gesetzt ist, was alle Tools upfront laden erzwingt |

353| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Setzen Sie auf einen beliebigen Nicht-Leer-Wert, um alle Modelle, nicht nur Opus, zu veranlassen, bei wiederholten Überladungsfehlern nicht mehr zu versuchen, wenn kein Fallback-Modell konfiguriert ist. {/* min-version: 2.1.160 */}Ab v2.1.160 löst eine konfigurierte [Fallback-Modellkette](/de/model-config#fallback-model-chains) bei wiederholten Überladungsfehlern für jedes primäre Modell aus, sodass diese Variable das Wechseln zu einem Fallback-Modell nicht beeinflusst |353| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Setzen Sie auf einen beliebigen Nicht-Leer-Wert, um alle Modelle, nicht nur Opus, zu veranlassen, bei wiederholten Überladungsfehlern nicht mehr zu versuchen, wenn kein Fallback-Modell konfiguriert ist. Ab v2.1.160 löst eine konfigurierte [Fallback-Modellkette](/docs/de/model-config#fallback-model-chains) bei wiederholten Überladungsfehlern für jedes primäre Modell aus, sodass diese Variable das Wechseln zu einem Fallback-Modell nicht beeinflusst |

354| `FORCE_AUTOUPDATE_PLUGINS` | Setzen Sie auf `1`, um Plugin-Auto-Updates zu erzwingen, auch wenn der Haupt-Auto-Updater über `DISABLE_AUTOUPDATER` deaktiviert ist |354| `FORCE_AUTOUPDATE_PLUGINS` | Setzen Sie auf `1`, um Plugin-Auto-Updates zu erzwingen, auch wenn der Haupt-Auto-Updater über `DISABLE_AUTOUPDATER` deaktiviert ist |

355| `FORCE_HYPERLINK` | Setzen Sie auf `1`, um clickable OSC 8 Hyperlinks zu aktivieren, wenn Ihr Terminal sie unterstützt, aber nicht automatisch erkannt wird, oder `0`, um sie zu deaktivieren |355| `FORCE_HYPERLINK` | Setzen Sie auf `1`, um clickable OSC 8 Hyperlinks zu aktivieren, wenn Ihr Terminal sie unterstützt, aber nicht automatisch erkannt wird, oder `0`, um sie zu deaktivieren |

356| `FORCE_PROMPT_CACHING_5M` | Setzen Sie auf `1`, um die 5-Minuten-Prompt-Cache-TTL zu erzwingen, auch wenn 1-Stunden-TTL ansonsten gelten würde. Überschreibt `ENABLE_PROMPT_CACHING_1H` |356| `FORCE_PROMPT_CACHING_5M` | Setzen Sie auf `1`, um die 5-Minuten-Prompt-Cache-TTL zu erzwingen, auch wenn 1-Stunden-TTL ansonsten gelten würde. Überschreibt `ENABLE_PROMPT_CACHING_1H` |

359| `IS_DEMO` | Setzen Sie auf `1`, um Demo-Modus zu aktivieren: verbirgt Ihre E-Mail und Organisationsnamen aus der Kopfzeile und `/status`-Ausgabe und überspringt Onboarding. Nützlich zum Streamen oder Aufzeichnen einer Sitzung |359| `IS_DEMO` | Setzen Sie auf `1`, um Demo-Modus zu aktivieren: verbirgt Ihre E-Mail und Organisationsnamen aus der Kopfzeile und `/status`-Ausgabe und überspringt Onboarding. Nützlich zum Streamen oder Aufzeichnen einer Sitzung |

360| `MAX_MCP_OUTPUT_TOKENS` | Maximale Anzahl von Token, die in MCP-Tool-Antworten zulässig sind. Claude Code zeigt eine Warnung an, wenn die Ausgabe 10.000 Token überschreitet. Tools, die [`anthropic/maxResultSizeChars`](/de/mcp#raise-the-limit-for-a-specific-tool) deklarieren, verwenden dieses Zeichenlimit für Textinhalte stattdessen, aber Bildinhalte von diesen Tools unterliegen weiterhin dieser Variablen (Standard: 25000) |360| `MAX_MCP_OUTPUT_TOKENS` | Maximale Anzahl von Token, die in MCP-Tool-Antworten zulässig sind. Claude Code zeigt eine Warnung an, wenn die Ausgabe 10.000 Token überschreitet. Tools, die [`anthropic/maxResultSizeChars`](/docs/de/mcp#raise-the-limit-for-a-specific-tool) deklarieren, verwenden dieses Zeichenlimit für Textinhalte stattdessen, aber Bildinhalte von diesen Tools unterliegen weiterhin dieser Variablen (Standard: 25000) |

361| `MAX_STRUCTURED_OUTPUT_RETRIES` | Anzahl der Wiederholungen, wenn die Antwort des Modells die Validierung gegen das [`--json-schema`](/de/cli-reference#cli-flags) im nicht-interaktiven Modus (das Flag `-p`) fehlschlägt. Standardmäßig 5 |361| `MAX_STRUCTURED_OUTPUT_RETRIES` | Anzahl der Wiederholungen, wenn die Antwort des Modells die Validierung gegen das [`--json-schema`](/docs/de/cli-reference#cli-flags) im nicht-interaktiven Modus (das Flag `-p`) fehlschlägt. Standardmäßig 5 |

362| `MAX_THINKING_TOKENS` | Überschreiben Sie das [erweitertes Denken](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)-Token-Budget. Die Obergrenze ist die [maximale Ausgabe-Token](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) des Modells minus eins. Setzen Sie auf `0`, um Denken auf der Anthropic API zu deaktivieren, außer auf Fable 5, das Denken nicht ausschalten kann. Auf [Drittanbieter-Providern](/de/third-party-integrations) lässt `0` ebenfalls den Parameter weg, und Modelle mit [adaptivem Denken](/de/model-config#adjust-effort-level) können trotzdem denken. Für Nicht-Null-Werte auf Modellen mit adaptivem Denken wird das Budget ignoriert, es sei denn, adaptives Denken ist über `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` deaktiviert |362| `MAX_THINKING_TOKENS` | Überschreiben Sie das [erweitertes Denken](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)-Token-Budget. Die Obergrenze ist die [maximale Ausgabe-Token](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) des Modells minus eins. Setzen Sie auf `0`, um Denken auf der Anthropic API zu deaktivieren, außer auf Fable 5, das Denken nicht ausschalten kann. Auf [Drittanbieter-Providern](/docs/de/third-party-integrations) lässt `0` ebenfalls den Parameter weg, und Modelle mit [adaptivem Denken](/docs/de/model-config#adjust-effort-level) können trotzdem denken. Für Nicht-Null-Werte auf Modellen mit adaptivem Denken wird das Budget ignoriert, es sei denn, adaptives Denken ist über `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` deaktiviert |

363| `MCP_CLIENT_SECRET` | OAuth-Client-Secret für MCP-Server, die [vorkonfigurierte Anmeldedaten](/de/mcp#use-pre-configured-oauth-credentials) erfordern. Vermeidet die interaktive Eingabeaufforderung beim Hinzufügen eines Servers mit `--client-secret` |363| `MCP_CLIENT_SECRET` | OAuth-Client-Secret für MCP-Server, die [vorkonfigurierte Anmeldedaten](/docs/de/mcp#use-pre-configured-oauth-credentials) erfordern. Vermeidet die interaktive Eingabeaufforderung beim Hinzufügen eines Servers mit `--client-secret` |

364| `MCP_CONNECTION_NONBLOCKING` | Steuert, ob der Start auf MCP-Server-Verbindungen wartet, bevor die erste Abfrage. {/* min-version: 2.1.142 */}Ab Claude Code v2.1.142 ist MCP-Start standardmäßig nicht-blockierend: Server verbinden sich im Hintergrund und ihre Tools werden verfügbar, wenn sie fertig sind. Setzen Sie auf `0`, um das blockierende 5-Sekunden-Verbindungswarten wiederherzustellen. Server, die mit [`alwaysLoad: true`](/de/mcp#exempt-a-server-from-deferral) konfiguriert sind, blockieren den Start immer, unabhängig davon, da ihre Tools vorhanden sein müssen, wenn der erste Prompt erstellt wird |364| `MCP_CONNECTION_NONBLOCKING` | Steuert, ob der Start auf MCP-Server-Verbindungen wartet, bevor die erste Abfrage. Ab Claude Code v2.1.142 ist MCP-Start standardmäßig nicht-blockierend: Server verbinden sich im Hintergrund und ihre Tools werden verfügbar, wenn sie fertig sind. Setzen Sie auf `0`, um das blockierende 5-Sekunden-Verbindungswarten wiederherzustellen. Server, die mit [`alwaysLoad: true`](/docs/de/mcp#exempt-a-server-from-deferral) konfiguriert sind, blockieren den Start immer, unabhängig davon, da ihre Tools vorhanden sein müssen, wenn der erste Prompt erstellt wird |

365| `MCP_CONNECT_TIMEOUT_MS` | Wie lange das blockierende MCP-Start wartet, in Millisekunden, auf den Verbindungs-Batch, bevor die Tool-Liste fotografiert wird (Standard: 5000). Gilt, wenn `MCP_CONNECTION_NONBLOCKING=0` oder für Server, die mit [`alwaysLoad: true`](/de/mcp#exempt-a-server-from-deferral) markiert sind. Server, die noch ausstehend sind, verbinden sich weiterhin im Hintergrund, erscheinen aber erst bei der nächsten Abfrage. Unterscheidet sich von `MCP_TIMEOUT`, das einen einzelnen Server-Verbindungsversuch begrenzt |365| `MCP_CONNECT_TIMEOUT_MS` | Wie lange das blockierende MCP-Start wartet, in Millisekunden, auf den Verbindungs-Batch, bevor die Tool-Liste fotografiert wird (Standard: 5000). Gilt, wenn `MCP_CONNECTION_NONBLOCKING=0` oder für Server, die mit [`alwaysLoad: true`](/docs/de/mcp#exempt-a-server-from-deferral) markiert sind. Server, die noch ausstehend sind, verbinden sich weiterhin im Hintergrund, erscheinen aber erst bei der nächsten Abfrage. Unterscheidet sich von `MCP_TIMEOUT`, das einen einzelnen Server-Verbindungsversuch begrenzt |

366| `MCP_OAUTH_CALLBACK_PORT` | Fester Port für den OAuth-Redirect-Callback als Alternative zu `--callback-port` beim Hinzufügen eines MCP-Servers mit [vorkonfigurierten Anmeldedaten](/de/mcp#use-pre-configured-oauth-credentials) |366| `MCP_OAUTH_CALLBACK_PORT` | Fester Port für den OAuth-Redirect-Callback als Alternative zu `--callback-port` beim Hinzufügen eines MCP-Servers mit [vorkonfigurierten Anmeldedaten](/docs/de/mcp#use-pre-configured-oauth-credentials) |

367| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von Remote-MCP-Servern (HTTP/SSE), die während des Starts parallel verbunden werden (Standard: 20) |367| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von Remote-MCP-Servern (HTTP/SSE), die während des Starts parallel verbunden werden (Standard: 20) |

368| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von lokalen MCP-Servern (stdio), die während des Starts parallel verbunden werden (Standard: 3) |368| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Maximale Anzahl von lokalen MCP-Servern (stdio), die während des Starts parallel verbunden werden (Standard: 3) |

370| `MCP_TOOL_TIMEOUT` | Timeout in Millisekunden für MCP-Tool-Ausführung (Standard: 100000000, etwa 28 Stunden). Für einen HTTP-, SSE-, oder claude.ai-Connector-Server wird jede Anfrage auch nach 60 Sekunden standardmäßig mit Timeout versehen; setzen Sie diese Variable oder das Pro-Server-`timeout` über 60000, um dieses Pro-Request-Limit zu erhöhen. Ein niedrigerer Wert verkürzt immer noch das Gesamt-Tool-Ausführungs-Timeout, lässt aber das Pro-Request-Limit bei 60 Sekunden. Stdio- und WebSocket-Server haben keinen Pro-Request-Timer. Ein Pro-Server-`timeout`-Feld in `.mcp.json` überschreibt dies für diesen Server. {/* min-version: 2.1.203 */}Ein Pro-Server-`timeout` von mindestens 1000 setzt auch das Mindest-Idle-Fenster für die Tool-Aufrufe dieses Servers, sodass `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` sie nie früher abbricht; dieser Floor erfordert Claude Code v2.1.203 oder später. Für die Env-Variable werden Werte unter 1000 auf eine Sekunde begrenzt; für das pro-Server-Feld werden Werte unter 1000 ignoriert |370| `MCP_TOOL_TIMEOUT` | Timeout in Millisekunden für MCP-Tool-Ausführung (Standard: 100000000, etwa 28 Stunden). Für einen HTTP-, SSE-, oder claude.ai-Connector-Server wird jede Anfrage auch nach 60 Sekunden standardmäßig mit Timeout versehen; setzen Sie diese Variable oder das Pro-Server-`timeout` über 60000, um dieses Pro-Request-Limit zu erhöhen. Ein niedrigerer Wert verkürzt immer noch das Gesamt-Tool-Ausführungs-Timeout, lässt aber das Pro-Request-Limit bei 60 Sekunden. Stdio- und WebSocket-Server haben keinen Pro-Request-Timer. Ein Pro-Server-`timeout`-Feld in `.mcp.json` überschreibt dies für diesen Server. Ein Pro-Server-`timeout` von mindestens 1000 setzt auch das Mindest-Idle-Fenster für die Tool-Aufrufe dieses Servers, sodass `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` sie nie früher abbricht; dieser Floor erfordert Claude Code v2.1.203 oder später. Für die Env-Variable werden Werte unter 1000 auf eine Sekunde begrenzt; für das pro-Server-Feld werden Werte unter 1000 ignoriert |

372| `OTEL_LOG_ASSISTANT_RESPONSES` | {/* min-version: 2.1.193 */}Setzen Sie auf `1`, um den Text der Modell-Antwort auf `assistant_response` OpenTelemetry-Protokollereignissen einzubeziehen. Wenn nicht gesetzt, wird der Wert von `OTEL_LOG_USER_PROMPTS` verwendet. Setzen Sie auf `0`, um Antworten redigiert zu halten, auch wenn `OTEL_LOG_USER_PROMPTS` gesetzt ist. Erfordert Claude Code v2.1.193 oder später. Siehe [Überwachung](/de/monitoring-usage#assistant-response-event) |372| `OTEL_LOG_ASSISTANT_RESPONSES` | Setzen Sie auf `1`, um den Text der Modell-Antwort auf `assistant_response` OpenTelemetry-Protokollereignissen einzubeziehen. Wenn nicht gesetzt, wird der Wert von `OTEL_LOG_USER_PROMPTS` verwendet. Setzen Sie auf `0`, um Antworten redigiert zu halten, auch wenn `OTEL_LOG_USER_PROMPTS` gesetzt ist. Erfordert Claude Code v2.1.193 oder später. Siehe [Überwachung](/docs/de/monitoring-usage#assistant-response-event) |

373| `OTEL_LOG_RAW_API_BODIES` | Geben Sie Anthropic Messages API-Anfrage- und Antwort-JSON als `api_request_body` / `api_response_body`-Protokollereignisse aus. Setzen Sie auf `1` für Inline-Texte, die auf 60 KB gekürzt sind, oder `file:<dir>`, um ungekürzte Texte auf die Festplatte zu schreiben und stattdessen einen `body_ref`-Pfad auszugeben. Standardmäßig deaktiviert; Texte enthalten die gesamte Konversationshistorie. Siehe [Überwachung](/de/monitoring-usage#api-request-body-event) |373| `OTEL_LOG_RAW_API_BODIES` | Geben Sie Anthropic Messages API-Anfrage- und Antwort-JSON als `api_request_body` / `api_response_body`-Protokollereignisse aus. Setzen Sie auf `1` für Inline-Texte, die auf 60 KB gekürzt sind, oder `file:<dir>`, um ungekürzte Texte auf die Festplatte zu schreiben und stattdessen einen `body_ref`-Pfad auszugeben. Standardmäßig deaktiviert; Texte enthalten die gesamte Konversationshistorie. Siehe [Überwachung](/docs/de/monitoring-usage#api-request-body-event) |

374| `OTEL_LOG_TOOL_CONTENT` | Setzen Sie auf `1`, um Tool-Input- und Output-Inhalte in OpenTelemetry-Span-Ereignisse einzubeziehen. Standardmäßig deaktiviert, um sensible Daten zu schützen. Siehe [Überwachung](/de/monitoring-usage) |374| `OTEL_LOG_TOOL_CONTENT` | Setzen Sie auf `1`, um Tool-Input- und Output-Inhalte in OpenTelemetry-Span-Ereignisse einzubeziehen. Standardmäßig deaktiviert, um sensible Daten zu schützen. Siehe [Überwachung](/docs/de/monitoring-usage) |

375| `OTEL_LOG_TOOL_DETAILS` | Setzen Sie auf `1`, um Tool-Input-Argumente, MCP-Servernamen, Benutzer-erstellte Workflow-Namen, rohe Fehlerstrings bei Tool-Fehlern, die Verweigerungskategorie bei `api_refusal`-Ereignissen und andere Tool-Details in OpenTelemetry-Traces und Protokollen einzubeziehen. Standardmäßig deaktiviert, um PII zu schützen. Siehe [Überwachung](/de/monitoring-usage) |375| `OTEL_LOG_TOOL_DETAILS` | Setzen Sie auf `1`, um Tool-Input-Argumente, MCP-Servernamen, Benutzer-erstellte Workflow-Namen, rohe Fehlerstrings bei Tool-Fehlern, die Verweigerungskategorie bei `api_refusal`-Ereignissen und andere Tool-Details in OpenTelemetry-Traces und Protokollen einzubeziehen. Standardmäßig deaktiviert, um PII zu schützen. Siehe [Überwachung](/docs/de/monitoring-usage) |

376| `OTEL_LOG_USER_PROMPTS` | Setzen Sie auf `1`, um Benutzer-Prompt-Text in OpenTelemetry-Traces und Protokollen einzubeziehen. Standardmäßig deaktiviert (Prompts werden redigiert). Siehe [Überwachung](/de/monitoring-usage) |376| `OTEL_LOG_USER_PROMPTS` | Setzen Sie auf `1`, um Benutzer-Prompt-Text in OpenTelemetry-Traces und Protokollen einzubeziehen. Standardmäßig deaktiviert (Prompts werden redigiert). Siehe [Überwachung](/docs/de/monitoring-usage) |

377| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Setzen Sie auf `false`, um Account UUID aus Metrik-Attributen auszuschließen (Standard: enthalten). Siehe [Überwachung](/de/monitoring-usage) |377| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Setzen Sie auf `false`, um Account UUID aus Metrik-Attributen auszuschließen (Standard: enthalten). Siehe [Überwachung](/docs/de/monitoring-usage) |

378| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}Setzen Sie auf `true`, um den Session-Einstiegspunkt in Metrik-Attributen einzubeziehen (Standard: ausgeschlossen). Hinzugefügt in v2.1.152. Siehe [Überwachung](/de/monitoring-usage) |378| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Setzen Sie auf `true`, um den Session-Einstiegspunkt in Metrik-Attributen einzubeziehen (Standard: ausgeschlossen). Hinzugefügt in v2.1.152. Siehe [Überwachung](/docs/de/monitoring-usage) |

379| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | {/* min-version: 2.1.161 */}Ab v2.1.161 hängt Claude Code `OTEL_RESOURCE_ATTRIBUTES`-Schlüssel an Metrik-Datenpunkt-Labels an. Setzen Sie auf `false`, um sie auszuschließen (Standard: enthalten). Siehe [Überwachung](/de/monitoring-usage#multi-team-organization-support) |379| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Ab v2.1.161 hängt Claude Code `OTEL_RESOURCE_ATTRIBUTES`-Schlüssel an Metrik-Datenpunkt-Labels an. Setzen Sie auf `false`, um sie auszuschließen (Standard: enthalten). Siehe [Überwachung](/docs/de/monitoring-usage#multi-team-organization-support) |

380| `OTEL_METRICS_INCLUDE_SESSION_ID` | Setzen Sie auf `false`, um Sitzungs-ID aus Metrik-Attributen auszuschließen (Standard: enthalten). Siehe [Überwachung](/de/monitoring-usage) |380| `OTEL_METRICS_INCLUDE_SESSION_ID` | Setzen Sie auf `false`, um Sitzungs-ID aus Metrik-Attributen auszuschließen (Standard: enthalten). Siehe [Überwachung](/docs/de/monitoring-usage) |

381| `OTEL_METRICS_INCLUDE_VERSION` | Setzen Sie auf `true`, um Claude Code-Version in Metrik-Attributen einzubeziehen (Standard: ausgeschlossen). Siehe [Überwachung](/de/monitoring-usage) |381| `OTEL_METRICS_INCLUDE_VERSION` | Setzen Sie auf `true`, um Claude Code-Version in Metrik-Attributen einzubeziehen (Standard: ausgeschlossen). Siehe [Überwachung](/docs/de/monitoring-usage) |

382| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Überschreiben Sie das Zeichenbudget für Skill-Metadaten, die dem [Skill-Tool](/de/skills#control-who-invokes-a-skill) angezeigt werden. Das Budget skaliert dynamisch bei 1 % des Kontextfensters, mit einem Fallback von 8.000 Zeichen. Legacy-Name für Rückwärtskompatibilität beibehalten |382| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Überschreiben Sie das Zeichenbudget für Skill-Metadaten, die dem [Skill-Tool](/docs/de/skills#control-who-invokes-a-skill) angezeigt werden. Das Budget skaliert dynamisch bei 1 % des Kontextfensters, mit einem Fallback von 8.000 Zeichen. Legacy-Name für Rückwärtskompatibilität beibehalten |

383| `TASK_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen in [Subagenten](/de/sub-agents)-Ausgabe vor Kürzung (Standard: 32000, Maximum: 160000). Bei Kürzung wird die vollständige Ausgabe auf der Festplatte gespeichert und der Pfad ist in der gekürzten Antwort enthalten |383| `TASK_MAX_OUTPUT_LENGTH` | Maximale Anzahl von Zeichen in [Subagenten](/docs/de/sub-agents)-Ausgabe vor Kürzung (Standard: 32000, Maximum: 160000). Bei Kürzung wird die vollständige Ausgabe auf der Festplatte gespeichert und der Pfad ist in der gekürzten Antwort enthalten |

384| `USE_BUILTIN_RIPGREP` | Setzen Sie auf `0`, um das systeminstallierte `rg` anstelle des in Claude Code enthaltenen `rg` zu verwenden |384| `USE_BUILTIN_RIPGREP` | Setzen Sie auf `0`, um das systeminstallierte `rg` anstelle des in Claude Code enthaltenen `rg` zu verwenden |

385| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Überschreiben Sie die Region für Claude 3.5 Haiku bei Verwendung von Google Cloud's Agent Platform |385| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Überschreiben Sie die Region für Claude 3.5 Haiku bei Verwendung von Google Cloud's Agent Platform |

386| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Überschreiben Sie die Region für Claude 3.5 Sonnet bei Verwendung von Google Cloud's Agent Platform |386| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Überschreiben Sie die Region für Claude 3.5 Sonnet bei Verwendung von Google Cloud's Agent Platform |

392| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Überschreiben Sie die Region für Claude Sonnet 4.5 bei Verwendung von Google Cloud's Agent Platform |392| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Überschreiben Sie die Region für Claude Sonnet 4.5 bei Verwendung von Google Cloud's Agent Platform |

393| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Überschreiben Sie die Region für Claude Opus 4.6 bei Verwendung von Google Cloud's Agent Platform |393| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Überschreiben Sie die Region für Claude Opus 4.6 bei Verwendung von Google Cloud's Agent Platform |

394| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Überschreiben Sie die Region für Claude Sonnet 4.6 bei Verwendung von Google Cloud's Agent Platform |394| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Überschreiben Sie die Region für Claude Sonnet 4.6 bei Verwendung von Google Cloud's Agent Platform |

395| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Überschreiben Sie die Region für Claude Opus 4.7 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.111 |395| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Überschreiben Sie die Region für Claude Opus 4.7 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.111 |

396| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Überschreiben Sie die Region für Claude Opus 4.8 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.154 |396| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Überschreiben Sie die Region für Claude Opus 4.8 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.154 |

397| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Überschreiben Sie die Region für Claude Sonnet 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.197 |397| `VERTEX_REGION_CLAUDE_5_SONNET` | Überschreiben Sie die Region für Claude Sonnet 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.197 |

398| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Überschreiben Sie die Region für Claude Fable 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.170 |398| `VERTEX_REGION_CLAUDE_FABLE_5` | Überschreiben Sie die Region für Claude Fable 5 bei Verwendung von Google Cloud's Agent Platform. Hinzugefügt in v2.1.170 |

399| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Überschreiben Sie die Region für Claude Haiku 4.5 bei Verwendung von Google Cloud's Agent Platform |399| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Überschreiben Sie die Region für Claude Haiku 4.5 bei Verwendung von Google Cloud's Agent Platform |

400 400

401Standard-OpenTelemetry-Exporter-Variablen (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` und signalspezifische Varianten) werden ebenfalls unterstützt. Siehe [Überwachung](/de/monitoring-usage) für Konfigurationsdetails.401Standard-OpenTelemetry-Exporter-Variablen (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` und signalspezifische Varianten) werden ebenfalls unterstützt. Siehe [Überwachung](/docs/de/monitoring-usage) für Konfigurationsdetails.

402 402

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

404 Siehe auch404 Siehe auch

405</h2>405</h2>

406 406

407* [Einstellungen](/de/settings): Alle `settings.json`-Konfiguration, einschließlich des `env`-Schlüssels407* [Einstellungen](/docs/de/settings): Alle `settings.json`-Konfiguration, einschließlich des `env`-Schlüssels

408* [CLI-Referenz](/de/cli-reference): Startzeit-Flags408* [CLI-Referenz](/docs/de/cli-reference): Startzeit-Flags

409* [Netzwerkkonfiguration](/de/network-config): Proxy- und TLS-Setup409* [Netzwerkkonfiguration](/docs/de/network-config): Proxy- und TLS-Setup

410* [Überwachung](/de/monitoring-usage): OpenTelemetry-Konfiguration410* [Überwachung](/docs/de/monitoring-usage): OpenTelemetry-Konfiguration

errors.md +148 −148

Details

6 6

7> Schlagen Sie Claude Code-Laufzeitfehlermeldungen nach und erfahren Sie, was jede bedeutet und wie Sie sie beheben.7> Schlagen Sie Claude Code-Laufzeitfehlermeldungen nach und erfahren Sie, was jede bedeutet und wie Sie sie beheben.

8 8

9Diese Seite listet Laufzeitfehler auf, die Claude Code anzeigt, und wie Sie sich von jedem erholen können, sowie was Sie überprüfen sollten, wenn Antworten ohne Fehler seltsam wirken. Für Installationsfehler wie `command not found` oder TLS-Fehler während der Einrichtung siehe [Fehlerbehebung bei Installation und Anmeldung](/de/troubleshoot-install).9Diese Seite listet Laufzeitfehler auf, die Claude Code anzeigt, und wie Sie sich von jedem erholen können, sowie was Sie überprüfen sollten, wenn Antworten ohne Fehler seltsam wirken. Für Installationsfehler wie `command not found` oder TLS-Fehler während der Einrichtung siehe [Fehlerbehebung bei Installation und Anmeldung](/docs/de/troubleshoot-install).

10 10

11Diese Fehler und Wiederherstellungsbefehle gelten für die CLI, die [Desktop-App](/de/desktop) und [Claude Code im Web](/de/claude-code-on-the-web), da alle drei die gleiche Claude Code CLI verwenden. Für oberflächenspezifische Probleme siehe den Abschnitt zur Fehlerbehebung auf der Seite dieser Oberfläche.11Diese Fehler und Wiederherstellungsbefehle gelten für die CLI, die [Desktop-App](/docs/de/desktop) und [Claude Code im Web](/docs/de/claude-code-on-the-web), da alle drei die gleiche Claude Code CLI verwenden. Für oberflächenspezifische Probleme siehe den Abschnitt zur Fehlerbehebung auf der Seite dieser Oberfläche.

12 12

13<Note>13<Note>

14 Claude Code ruft die Claude API für Modellantworten auf, daher werden die meisten Laufzeitfehler einem zugrunde liegenden API-Fehlercode zugeordnet. Diese Seite behandelt, was jeder Fehler in Claude Code bedeutet und wie Sie sich davon erholen. Für die rohen HTTP-Statuscode-Definitionen siehe die [Claude Platform-Fehlerreferenz](https://platform.claude.com/docs/en/api/errors).14 Claude Code ruft die Claude API für Modellantworten auf, daher werden die meisten Laufzeitfehler einem zugrunde liegenden API-Fehlercode zugeordnet. Diese Seite behandelt, was jeder Fehler in Claude Code bedeutet und wie Sie sich davon erholen. Für die rohen HTTP-Statuscode-Definitionen siehe die [Claude Platform-Fehlerreferenz](https://platform.claude.com/docs/en/api/errors).

97 Automatische Wiederholungen97 Automatische Wiederholungen

98</h2>98</h2>

99 99

100Claude Code wiederholt vorübergehende Fehler, bevor ein Fehler angezeigt wird. Serverfehler, Überlastungsantworten, Anfrage-Timeouts, vorübergehende 429-Drosselungen und unterbrochene Verbindungen werden alle bis zu 10-mal mit exponentiellem Backoff wiederholt. {/* min-version: 2.1.198 */}Ab v2.1.198 umfasst dies Verbindungen, die in der Mitte einer Antwort abbrechen, bevor sichtbare Ausgabe gestreamt wurde: Claude Code sendet die Anfrage mit dem gleichen Backoff erneut aus und der Turn wird fortgesetzt, anstatt mit einem Verbindungsfehler zu stoppen. {/* min-version: 2.1.199 */}Ab v2.1.199 werden auch vorübergehende 429-Drosselungen, die nicht die Quota-Header Ihres Plans tragen, wiederholt, wenn Sie mit einem claude.ai-Abonnement angemeldet sind; frühere Versionen wiederholten sie nur für API-Schlüssel- und Enterprise-Anmeldungen.100Claude Code wiederholt vorübergehende Fehler, bevor ein Fehler angezeigt wird. Serverfehler, Überlastungsantworten, Anfrage-Timeouts, vorübergehende 429-Drosselungen und unterbrochene Verbindungen werden alle bis zu 10-mal mit exponentiellem Backoff wiederholt. Ab v2.1.198 umfasst dies Verbindungen, die in der Mitte einer Antwort abbrechen, bevor sichtbare Ausgabe gestreamt wurde: Claude Code sendet die Anfrage mit dem gleichen Backoff erneut aus und der Turn wird fortgesetzt, anstatt mit einem Verbindungsfehler zu stoppen. Ab v2.1.199 werden auch vorübergehende 429-Drosselungen, die nicht die Quota-Header Ihres Plans tragen, wiederholt, wenn Sie mit einem claude.ai-Abonnement angemeldet sind; frühere Versionen wiederholten sie nur für API-Schlüssel- und Enterprise-Anmeldungen.

101 101

102Einige Fehlerklassen werden nicht wiederholt, da eine Wiederholung nicht erfolgreich sein kann:102Einige Fehlerklassen werden nicht wiederholt, da eine Wiederholung nicht erfolgreich sein kann:

103 103

104* {/* min-version: 2.1.199 */}Ab v2.1.199 schlägt ein TLS-Zertifikatvalidierungsfehler, wie ein TLS-inspizierender Proxy, ein fehlender `NODE_EXTRA_CA_CERTS` Bundle oder ein abgelaufenes Zertifikat, beim ersten Versuch fehl, daher wird die Behebung sofort angezeigt, anstatt nach dem vollständigen Wiederholungsbudget. Siehe [SSL-Zertifikatsfehler](#ssl-certificate-errors). Vorübergehende TLS-Bedingungen wie ein Handshake-Timeout werden weiterhin wiederholt.104* Ab v2.1.199 schlägt ein TLS-Zertifikatvalidierungsfehler, wie ein TLS-inspizierender Proxy, ein fehlender `NODE_EXTRA_CA_CERTS` Bundle oder ein abgelaufenes Zertifikat, beim ersten Versuch fehl, daher wird die Behebung sofort angezeigt, anstatt nach dem vollständigen Wiederholungsbudget. Siehe [SSL-Zertifikatsfehler](#ssl-certificate-errors). Vorübergehende TLS-Bedingungen wie ein Handshake-Timeout werden weiterhin wiederholt.

105* {/* min-version: 2.1.199 */}Ab v2.1.199 behält ein Serverfehler, der ankommt, nachdem Claude bereits sichtbare Ausgabe gestreamt hat, die Teilantwort und fügt stattdessen eine [Benachrichtigung über unvollständige Antwort](#the-response-above-may-be-incomplete) an, anstatt zu wiederholen, da das erneute Ausführen der Anfrage die gleichen Tools zweimal ausführen könnte. Frühere Versionen verwarfen die Teilausgabe und meldeten den Turn als Fehler.105* Ab v2.1.199 behält ein Serverfehler, der ankommt, nachdem Claude bereits sichtbare Ausgabe gestreamt hat, die Teilantwort und fügt stattdessen eine [Benachrichtigung über unvollständige Antwort](#the-response-above-may-be-incomplete) an, anstatt zu wiederholen, da das erneute Ausführen der Anfrage die gleichen Tools zweimal ausführen könnte. Frühere Versionen verwarfen die Teilausgabe und meldeten den Turn als Fehler.

106* {/* min-version: 2.1.208 */}Eine [Amazon Bedrock Streaming-Antwort mit einem unerwarteten Content-Type](#bedrock-streaming-response-has-an-unexpected-content-type) schlägt beim ersten Versuch fehl, da das Gateway oder der Proxy, der die Antwort umschreibt, die Wiederholung auf die gleiche Weise umschreiben würde. Erfordert Claude Code v2.1.208 oder später.106* Eine [Amazon Bedrock Streaming-Antwort mit einem unerwarteten Content-Type](#bedrock-streaming-response-has-an-unexpected-content-type) schlägt beim ersten Versuch fehl, da das Gateway oder der Proxy, der die Antwort umschreibt, die Wiederholung auf die gleiche Weise umschreiben würde. Erfordert Claude Code v2.1.208 oder später.

107 107

108Während der Wiederholung zeigt der Spinner einen `Retrying in Ns · attempt x/y` Countdown nach einem Fehler-Label an. Das Label benennt den spezifischen Grund aus dem ersten Versuch für Fehler, auf die Sie sofort reagieren können: Das Netzwerk ist ausgefallen, ein TLS-Handshake ist fehlgeschlagen, oder Sie haben ein Ratenlimit erreicht. Für andere Fehler lautet es zunächst `API error`. {/* min-version: 2.1.198 */}Ab v2.1.198 wechselt es zum spezifischen Grund aus dem dritten Versuch, oder beim letzten Versuch, wenn `CLAUDE_CODE_MAX_RETRIES` weniger als drei erlaubt; frühere Versionen wechseln nur beim letzten Versuch.108Während der Wiederholung zeigt der Spinner einen `Retrying in Ns · attempt x/y` Countdown nach einem Fehler-Label an. Das Label benennt den spezifischen Grund aus dem ersten Versuch für Fehler, auf die Sie sofort reagieren können: Das Netzwerk ist ausgefallen, ein TLS-Handshake ist fehlgeschlagen, oder Sie haben ein Ratenlimit erreicht. Für andere Fehler lautet es zunächst `API error`. Ab v2.1.198 wechselt es zum spezifischen Grund aus dem dritten Versuch, oder beim letzten Versuch, wenn `CLAUDE_CODE_MAX_RETRIES` weniger als drei erlaubt; frühere Versionen wechseln nur beim letzten Versuch.

109 109

110{/* min-version: 2.1.198 */}Ab v2.1.198 wird der übliche Spinner-Tipp während Wiederholungen unterdrückt. Sobald der Fehlergrund offenbart wird, wenn der Fehler eine 529-Überlastung ist, benennt die Zeile unter dem Countdown auch, wo der Dienststatus überprüft werden kann: `status.claude.com` auf der Anthropic API, oder der in der Nachricht genannte Provider- oder Gateway-Host bei anderen Konfigurationen.110Ab v2.1.198 wird der übliche Spinner-Tipp während Wiederholungen unterdrückt. Sobald der Fehlergrund offenbart wird, wenn der Fehler eine 529-Überlastung ist, benennt die Zeile unter dem Countdown auch, wo der Dienststatus überprüft werden kann: `status.claude.com` auf der Anthropic API, oder der in der Nachricht genannte Provider- oder Gateway-Host bei anderen Konfigurationen.

111 111

112{/* min-version: 2.1.185 */}Wenn 20 Sekunden lang keine Daten im Antwortstrom ankommen, während eine Anfrage noch ausstehend ist, zeigt der Spinner `Waiting for API response · will retry in … · check your network` an, bevor ein Wiederholungsversuch gestartet wurde. Die Anfrage ist noch nicht fehlgeschlagen: Der Countdown läuft bis zu dem Punkt, an dem Claude Code die stillgelegte Verbindung abbricht und wiederholt, sodass das Banner von selbst verschwindet, sobald Daten wieder ankommen oder die Wiederholung erfolgreich ist. Ab v2.1.185 beträgt der Schwellenwert 20 Sekunden; frühere Versionen zeigen das Banner nach 10 Sekunden mit unterschiedlicher Formulierung an. Wenn es bei jedem Versuch erneut angezeigt wird, behandeln Sie es als [Netzwerkproblem](#unable-to-connect-to-api).112Wenn 20 Sekunden lang keine Daten im Antwortstrom ankommen, während eine Anfrage noch ausstehend ist, zeigt der Spinner `Waiting for API response · will retry in … · check your network` an, bevor ein Wiederholungsversuch gestartet wurde. Die Anfrage ist noch nicht fehlgeschlagen: Der Countdown läuft bis zu dem Punkt, an dem Claude Code die stillgelegte Verbindung abbricht und wiederholt, sodass das Banner von selbst verschwindet, sobald Daten wieder ankommen oder die Wiederholung erfolgreich ist. Ab v2.1.185 beträgt der Schwellenwert 20 Sekunden; frühere Versionen zeigen das Banner nach 10 Sekunden mit unterschiedlicher Formulierung an. Wenn es bei jedem Versuch erneut angezeigt wird, behandeln Sie es als [Netzwerkproblem](#unable-to-connect-to-api).

113 113

114Wenn Sie einen der Fehler auf dieser Seite sehen, wurden diese Wiederholungen bereits erschöpft, es sei denn, er gehört zu einer Klasse, die nicht wiederholt wird, wie ein Zertifikatvalidierungsfehler. Sie können das Verhalten mit diesen Umgebungsvariablen anpassen:114Wenn Sie einen der Fehler auf dieser Seite sehen, wurden diese Wiederholungen bereits erschöpft, es sei denn, er gehört zu einer Klasse, die nicht wiederholt wird, wie ein Zertifikatvalidierungsfehler. Sie können das Verhalten mit diesen Umgebungsvariablen anpassen:

115 115

117| :------------------------------------------- | :------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |117| :------------------------------------------- | :------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

118| [`CLAUDE_CODE_MAX_RETRIES`](/de/env-vars) | 10 | Anzahl der Wiederholungsversuche. {/* min-version: 2.1.186 */}Ab v2.1.186 auf 15 begrenzt; {/* min-version: 2.1.199 */}ab v2.1.199 hebt `CLAUDE_CODE_RETRY_WATCHDOG` den Standard an und entfernt die Obergrenze. Senken Sie den Wert, um Fehler in Skripten schneller anzuzeigen. |118| [`CLAUDE_CODE_MAX_RETRIES`](/docs/de/env-vars) | 10 | Anzahl der Wiederholungsversuche. Ab v2.1.186 auf 15 begrenzt; ab v2.1.199 hebt `CLAUDE_CODE_RETRY_WATCHDOG` den Standard an und entfernt die Obergrenze. Senken Sie den Wert, um Fehler in Skripten schneller anzuzeigen. |

119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/de/env-vars) | nicht gesetzt | Setzen Sie auf `1` in unbeaufsichtigten Sitzungen wie CI-Jobs, um `429`- und `529`-Kapazitätsfehler unbegrenzt zu wiederholen, anstatt nach `CLAUDE_CODE_MAX_RETRIES`-Versuchen fehlzuschlagen. {/* min-version: 2.1.199 */}Ab v2.1.199 erhöht es auch die Standard-Wiederholungsanzahl für andere vorübergehende Fehler, wie Serverfehler, Timeouts und unterbrochene Verbindungen, auf 300, ungefähr drei Stunden Backoff, und entfernt die Obergrenze von 15 auf `CLAUDE_CODE_MAX_RETRIES`, wenn Sie diese Variable explizit setzen. |119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/de/env-vars) | nicht gesetzt | Setzen Sie auf `1` in unbeaufsichtigten Sitzungen wie CI-Jobs, um `429`- und `529`-Kapazitätsfehler unbegrenzt zu wiederholen, anstatt nach `CLAUDE_CODE_MAX_RETRIES`-Versuchen fehlzuschlagen. Ab v2.1.199 erhöht es auch die Standard-Wiederholungsanzahl für andere vorübergehende Fehler, wie Serverfehler, Timeouts und unterbrochene Verbindungen, auf 300, ungefähr drei Stunden Backoff, und entfernt die Obergrenze von 15 auf `CLAUDE_CODE_MAX_RETRIES`, wenn Sie diese Variable explizit setzen. |

120| [`API_TIMEOUT_MS`](/de/env-vars) | 600000 | Pro-Anfrage-Timeout in Millisekunden. Erhöhen Sie es für langsame Netzwerke oder Proxys. |120| [`API_TIMEOUT_MS`](/docs/de/env-vars) | 600000 | Pro-Anfrage-Timeout in Millisekunden. Erhöhen Sie es für langsame Netzwerke oder Proxys. |

121 121

122<h2 id="server-errors">122<h2 id="server-errors">

123 Serverfehler123 Serverfehler

196API Error: Response stalled mid-stream. The response above may be incomplete.196API Error: Response stalled mid-stream. The response above may be incomplete.

197```197```

198 198

199* {/* min-version: 2.1.199 */}`Server error mid-response`: ein Mid-Stream-Overloaded- oder 5xx-Serverfehler. Diese Variante erfordert Claude Code v2.1.199 oder später; davor verwarf dieser Fall die teilweise Ausgabe und meldete den gesamten Zug als Fehler.199* `Server error mid-response`: ein Mid-Stream-Overloaded- oder 5xx-Serverfehler. Diese Variante erfordert Claude Code v2.1.199 oder später; davor verwarf dieser Fall die teilweise Ausgabe und meldete den gesamten Zug als Fehler.

200* `Connection closed mid-response`: die Verbindung wurde unterbrochen.200* `Connection closed mid-response`: die Verbindung wurde unterbrochen.

201* `Response stalled mid-stream`: der Stream hat das Senden von Daten gestoppt.201* `Response stalled mid-stream`: der Stream hat das Senden von Daten gestoppt.

202 202

210 Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen210 Auto-Modus kann die Sicherheit einer Aktion nicht bestimmen

211</h3>211</h3>

212 212

213Das Modell, das der [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) zur Klassifizierung von Aktionen verwendet, konnte keine Entscheidung treffen, daher genehmigte der Auto-Modus die Aktion nicht automatisch. Die Meldung, die Sie sehen, hängt davon ab, warum der Klassifizierer fehlgeschlagen ist.213Das Modell, das der [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) zur Klassifizierung von Aktionen verwendet, konnte keine Entscheidung treffen, daher genehmigte der Auto-Modus die Aktion nicht automatisch. Die Meldung, die Sie sehen, hängt davon ab, warum der Klassifizierer fehlgeschlagen ist.

214 214

215Lesevorgänge, Suchen und Bearbeitungen in Ihrem Arbeitsverzeichnis überspringen den Klassifizierer, daher funktionieren sie in all diesen Fällen weiterhin.215Lesevorgänge, Suchen und Bearbeitungen in Ihrem Arbeitsverzeichnis überspringen den Klassifizierer, daher funktionieren sie in all diesen Fällen weiterhin.

216 216

224 224

225* Wiederholen Sie nach ein paar Sekunden; Claude sieht die gleiche Meldung und wiederholt normalerweise automatisch225* Wiederholen Sie nach ein paar Sekunden; Claude sieht die gleiche Meldung und wiederholt normalerweise automatisch

226* Wenn Wiederholungen weiterhin fehlschlagen, fahren Sie mit schreibgeschützten Aufgaben fort und kehren Sie später zur blockierten Aktion zurück226* Wenn Wiederholungen weiterhin fehlschlagen, fahren Sie mit schreibgeschützten Aufgaben fort und kehren Sie später zur blockierten Aktion zurück

227* Dies ist vorübergehend und hängt nicht mit der [Auto-Modus-Berechtigung](/de/permission-modes#eliminate-prompts-with-auto-mode) zusammen; Sie müssen die Einstellungen nicht ändern227* Dies ist vorübergehend und hängt nicht mit der [Auto-Modus-Berechtigung](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) zusammen; Sie müssen die Einstellungen nicht ändern

228 228

229Wenn der Klassifizierer eine nicht analysierbare Antwort zurückgegeben hat:229Wenn der Klassifizierer eine nicht analysierbare Antwort zurückgegeben hat:

230 230

247 247

248* Dies ist keine Entscheidung über Ihre Aktion. Inhalte, die bereits in Ihrem Gespräch vorhanden sind, haben einen Sicherheitsfilter auf der API ausgelöst, als der Auto-Modus das Gespräch an den Klassifizierer sendete248* Dies ist keine Entscheidung über Ihre Aktion. Inhalte, die bereits in Ihrem Gespräch vorhanden sind, haben einen Sicherheitsfilter auf der API ausgelöst, als der Auto-Modus das Gespräch an den Klassifizierer sendete

249* Eine Wiederholung hilft nicht; der gleiche Gesprächsinhalt löst den Filter erneut aus249* Eine Wiederholung hilft nicht; der gleiche Gesprächsinhalt löst den Filter erneut aus

250* Wechseln Sie zu einem anderen [Berechtigungsmodus](/de/permission-modes), damit Sie die Aktion bei Aufforderung genehmigen können, oder starten Sie ein neues Gespräch ohne den auslösenden Inhalt250* Wechseln Sie zu einem anderen [Berechtigungsmodus](/docs/de/permission-modes), damit Sie die Aktion bei Aufforderung genehmigen können, oder starten Sie ein neues Gespräch ohne den auslösenden Inhalt

251 251

252Wenn das Gespräch größer als das Kontextfenster des Klassifizierers geworden ist:252Wenn das Gespräch größer als das Kontextfenster des Klassifizierers geworden ist:

253 253

255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

256```256```

257 257

258In einer interaktiven Sitzung fällt der Auto-Modus auf eine normale Berechtigungsaufforderung für diese Aktion zurück, damit Sie sie manuell genehmigen oder ablehnen können. Im [nicht-interaktiven Modus](/de/headless) wird die Ausführung abgebrochen, da das Transkript nur wächst und eine Wiederholung nicht erfolgreich sein kann.258In einer interaktiven Sitzung fällt der Auto-Modus auf eine normale Berechtigungsaufforderung für diese Aktion zurück, damit Sie sie manuell genehmigen oder ablehnen können. Im [nicht-interaktiven Modus](/docs/de/headless) wird die Ausführung abgebrochen, da das Transkript nur wächst und eine Wiederholung nicht erfolgreich sein kann.

259 259

260**Was zu tun ist:**260**Was zu tun ist:**

261 261

266 Agent wurde aufgrund eines API-Fehlers vorzeitig beendet266 Agent wurde aufgrund eines API-Fehlers vorzeitig beendet

267</h3>267</h3>

268 268

269{/* min-version: 2.1.199 */}Eine [Subagent](/de/sub-agents)-API-Anfrage ist terminal fehlgeschlagen, zum Beispiel weil ein Nutzungslimit erreicht wurde oder Wiederholungen für einen Serverfehler aufgebraucht wurden, daher stoppte der Subagent, bevor er seine Aufgabe beendete. Diese Meldung erfordert Claude Code v2.1.199 oder später; davor wurde der API-Fehlertext an Claude zurückgegeben, als wäre er das Ergebnis des Subagenten.269Eine [Subagent](/docs/de/sub-agents)-API-Anfrage ist terminal fehlgeschlagen, zum Beispiel weil ein Nutzungslimit erreicht wurde oder Wiederholungen für einen Serverfehler aufgebraucht wurden, daher stoppte der Subagent, bevor er seine Aufgabe beendete. Diese Meldung erfordert Claude Code v2.1.199 oder später; davor wurde der API-Fehlertext an Claude zurückgegeben, als wäre er das Ergebnis des Subagenten.

270 270

271```text theme={null}271```text theme={null}

272Agent terminated early due to an API error: <error detail>272Agent terminated early due to an API error: <error detail>

275**Was zu tun ist:**275**Was zu tun ist:**

276 276

277* 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 Abschnitts277* Ordnen Sie die Fehlerdetails nach dem Doppelpunkt einem eigenen Abschnitt auf dieser Seite zu, wie z. B. [Nutzungslimits](#usage-limits) oder [Serverfehler](#server-errors), und folgen Sie den Schritten dieses Abschnitts

278* Sobald der zugrunde liegende Fehler behoben ist, bitten Sie Claude, die Aufgabe zu wiederholen oder den [Subagenten fortzusetzen](/de/sub-agents#resume-subagents)278* Sobald der zugrunde liegende Fehler behoben ist, bitten Sie Claude, die Aufgabe zu wiederholen oder den [Subagenten fortzusetzen](/docs/de/sub-agents#resume-subagents)

279 279

280Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Vordergrund-Subagenten unterbricht, der bereits Textausgabe produziert hat, erhält Claude diese teilweise Ausgabe als unvollständig markiert, anstatt diesen Fehler. {/* min-version: 2.1.200 */}Ein Subagent, dessen einzige Ausgabe Tool-Aufrufe waren, erhält auch diesen Fehler; in v2.1.199 gab dies stattdessen ein leeres Teilergebnis zurück. Siehe [API-Fehler in Subagenten](/de/sub-agents#api-errors-in-subagents).280Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Vordergrund-Subagenten unterbricht, der bereits Textausgabe produziert hat, erhält Claude diese teilweise Ausgabe als unvollständig markiert, anstatt diesen Fehler. Ein Subagent, dessen einzige Ausgabe Tool-Aufrufe waren, erhält auch diesen Fehler; in v2.1.199 gab dies stattdessen ein leeres Teilergebnis zurück. Siehe [API-Fehler in Subagenten](/docs/de/sub-agents#api-errors-in-subagents).

281 281

282<h2 id="usage-limits">282<h2 id="usage-limits">

283 Nutzungslimits283 Nutzungslimits

309* Führen Sie `/usage-credits` aus, um zusätzliche Nutzung auf Pro und Max zu kaufen, oder fordern Sie diese von Ihrem Administrator auf Team und Enterprise an. Siehe [Nutzungsguthaben für bezahlte Pläne](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) für Informationen zur Abrechnung.309* Führen Sie `/usage-credits` aus, um zusätzliche Nutzung auf Pro und Max zu kaufen, oder fordern Sie diese von Ihrem Administrator auf Team und Enterprise an. Siehe [Nutzungsguthaben für bezahlte Pläne](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) für Informationen zur Abrechnung.

310* Um Ihren Plan für höhere Basislimits zu aktualisieren, siehe [claude.com/pricing](https://claude.com/pricing)310* Um Ihren Plan für höhere Basislimits zu aktualisieren, siehe [claude.com/pricing](https://claude.com/pricing)

311 311

312Um Ihre verbleibende Zuteilung zu überwachen, bevor Sie das Limit erreichen, fügen Sie die `rate_limits`-Felder zu einer [benutzerdefinierten Statuszeile](/de/statusline#rate-limit-usage) hinzu, oder klicken Sie in der Desktop-App auf den [Nutzungsring](/de/desktop#check-usage) neben dem Modellwähler.312Um Ihre verbleibende Zuteilung zu überwachen, bevor Sie das Limit erreichen, fügen Sie die `rate_limits`-Felder zu einer [benutzerdefinierten Statuszeile](/docs/de/statusline#rate-limit-usage) hinzu, oder klicken Sie in der Desktop-App auf den [Nutzungsring](/docs/de/desktop#check-usage) neben dem Modellwähler.

313 313

314<h3 id="usage-credits-required-for-1m-context">314<h3 id="usage-credits-required-for-1m-context">

315 Nutzungsguthaben erforderlich für 1M-Kontext315 Nutzungsguthaben erforderlich für 1M-Kontext

321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

322```322```

323 323

324Dies ist eine Berechtigungsprüfung, keine Kontingenterschöpfung. Sie wird auch dann ausgelöst, wenn Ihre Sitzungs- und Wochenzuteilungen noch Kapazität haben. Siehe [Erweiterter Kontext](/de/model-config#extended-context) für Informationen darüber, welche Pläne 1M-Kontext direkt enthalten und welche Nutzungsguthaben erfordern.324Dies ist eine Berechtigungsprüfung, keine Kontingenterschöpfung. Sie wird auch dann ausgelöst, wenn Ihre Sitzungs- und Wochenzuteilungen noch Kapazität haben. Siehe [Erweiterter Kontext](/docs/de/model-config#extended-context) für Informationen darüber, welche Pläne 1M-Kontext direkt enthalten und welche Nutzungsguthaben erfordern.

325 325

326{/* min-version: 2.1.172 */}Wenn dieser Fehler während eines Gesprächs auftritt, weil der Kontext über 200K Token gewachsen ist, komprimiert Claude Code das Gespräch automatisch zurück unter das Standard-Kontextlimit und behält die Sitzung danach auf diesem Limit, sodass keine Aktion erforderlich ist. In Versionen vor v2.1.172 wiederholte sich der Fehler bei jeder nachfolgenden Anfrage einschließlich `/compact`; führen Sie `/clear` in diesen Versionen aus, um die Funktion wiederherzustellen. Die folgenden Schritte gelten, wenn Sie explizit ein `[1m]`-Modell ausgewählt haben.326Wenn dieser Fehler während eines Gesprächs auftritt, weil der Kontext über 200K Token gewachsen ist, komprimiert Claude Code das Gespräch automatisch zurück unter das Standard-Kontextlimit und behält die Sitzung danach auf diesem Limit, sodass keine Aktion erforderlich ist. In Versionen vor v2.1.172 wiederholte sich der Fehler bei jeder nachfolgenden Anfrage einschließlich `/compact`; führen Sie `/clear` in diesen Versionen aus, um die Funktion wiederherzustellen. Die folgenden Schritte gelten, wenn Sie explizit ein `[1m]`-Modell ausgewählt haben.

327 327

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

329 329

330* Führen Sie `/model` aus und wählen Sie die Variante ohne das `[1m]`-Suffix, um auf das Standard-Kontextfenster zurückzufallen330* Führen Sie `/model` aus und wählen Sie die Variante ohne das `[1m]`-Suffix, um auf das Standard-Kontextfenster zurückzufallen

331* Führen Sie `/usage-credits` aus, um die getaktete Abrechnung für die 1M-Variante auf Pro und Max zu aktivieren, oder fordern Sie diese von Ihrem Administrator auf Team und Enterprise an331* Führen Sie `/usage-credits` aus, um die getaktete Abrechnung für die 1M-Variante auf Pro und Max zu aktivieren, oder fordern Sie diese von Ihrem Administrator auf Team und Enterprise an

332* Wenn der Fehler nach `/model` weiterhin besteht, kann eine 1M-Modell-ID an anderer Stelle festgelegt sein. Siehe [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) für die Konfigurationsorte, die in Prioritätsreihenfolge zu überprüfen sind.332* Wenn der Fehler nach `/model` weiterhin besteht, kann eine 1M-Modell-ID an anderer Stelle festgelegt sein. Siehe [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) für die Konfigurationsorte, die in Prioritätsreihenfolge zu überprüfen sind.

333* Um 1M-Varianten vollständig aus dem Modellwähler zu entfernen, setzen Sie [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/de/env-vars)333* Um 1M-Varianten vollständig aus dem Modellwähler zu entfernen, setzen Sie [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/de/env-vars)

334 334

335<h3 id="server-is-temporarily-limiting-requests">335<h3 id="server-is-temporarily-limiting-requests">

336 Server drosselt Anfragen vorübergehend336 Server drosselt Anfragen vorübergehend

342API Error: Server is temporarily limiting requests (not your usage limit)342API Error: Server is temporarily limiting requests (not your usage limit)

343```343```

344 344

345Claude Code unterscheidet diese von Ihrem Planlimit durch das Fehlen der einheitlichen Kontingent-Header, die eine echte Limit-Antwort trägt. {/* min-version: 2.1.199 */}Ab v2.1.199 wird dies [automatisch erneut versucht](#automatic-retries) mit Backoff, bevor es angezeigt wird, unabhängig davon, wie Sie sich authentifizieren. In früheren Versionen schlug eine Sitzung, die mit einem claude.ai-Abonnement angemeldet war, beim ersten Auftreten fehl; nur API-Schlüssel und Enterprise-Anmeldungen wiederholten den Versuch.345Claude Code unterscheidet diese von Ihrem Planlimit durch das Fehlen der einheitlichen Kontingent-Header, die eine echte Limit-Antwort trägt. Ab v2.1.199 wird dies [automatisch erneut versucht](#automatic-retries) mit Backoff, bevor es angezeigt wird, unabhängig davon, wie Sie sich authentifizieren. In früheren Versionen schlug eine Sitzung, die mit einem claude.ai-Abonnement angemeldet war, beim ersten Auftreten fehl; nur API-Schlüssel und Enterprise-Anmeldungen wiederholten den Versuch.

346 346

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

348 348

366* Führen Sie `/status` aus und bestätigen Sie, dass die aktive Anmeldeinformation die ist, die Sie erwarten. Ein verwaister `ANTHROPIC_API_KEY` in Ihrer Umgebung kann Anfragen über einen Low-Tier-Schlüssel statt über Ihr Abonnement leiten.366* Führen Sie `/status` aus und bestätigen Sie, dass die aktive Anmeldeinformation die ist, die Sie erwarten. Ein verwaister `ANTHROPIC_API_KEY` in Ihrer Umgebung kann Anfragen über einen Low-Tier-Schlüssel statt über Ihr Abonnement leiten.

367* Überprüfen Sie Ihre Anbieter-Konsole auf die aktiven Limits und fordern Sie einen höheren Tier an, falls erforderlich367* Überprüfen Sie Ihre Anbieter-Konsole auf die aktiven Limits und fordern Sie einen höheren Tier an, falls erforderlich

368* Für Anthropic API-Schlüssel siehe die [Ratenlimit-Referenz](https://platform.claude.com/docs/en/api/rate-limits) für Informationen zur Funktionsweise von Tiers und zum Festlegen von Pro-Workspace-Limits368* Für Anthropic API-Schlüssel siehe die [Ratenlimit-Referenz](https://platform.claude.com/docs/en/api/rate-limits) für Informationen zur Funktionsweise von Tiers und zum Festlegen von Pro-Workspace-Limits

369* Reduzieren Sie die Parallelität: senken Sie [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/de/env-vars), vermeiden Sie die Ausführung vieler paralleler Subagenten, oder wechseln Sie mit `/model` zu einem kleineren Modell für Läufe mit hohem Volumen369* Reduzieren Sie die Parallelität: senken Sie [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/de/env-vars), vermeiden Sie die Ausführung vieler paralleler Subagenten, oder wechseln Sie mit `/model` zu einem kleineren Modell für Läufe mit hohem Volumen

370 370

371<h3 id="credit-balance-is-too-low">371<h3 id="credit-balance-is-too-low">

372 Guthabensaldo ist zu niedrig372 Guthabensaldo ist zu niedrig

382 382

383* Fügen Sie Guthaben unter [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) hinzu, und erwägen Sie, dort das automatische Nachladen zu aktivieren, damit der Saldo aufgefüllt wird, bevor er null erreicht383* Fügen Sie Guthaben unter [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) hinzu, und erwägen Sie, dort das automatische Nachladen zu aktivieren, damit der Saldo aufgefüllt wird, bevor er null erreicht

384* Wechseln Sie mit `/login` zur Abonnement-Authentifizierung, wenn Sie einen Pro-, Max-, Team- oder Enterprise-Plan haben384* Wechseln Sie mit `/login` zur Abonnement-Authentifizierung, wenn Sie einen Pro-, Max-, Team- oder Enterprise-Plan haben

385* Legen Sie Pro-Workspace-Ausgabenlimits in der Console fest, um zu verhindern, dass ein einzelnes Projekt das Organisationsguthaben aufbraucht. Siehe [Kosten effektiv verwalten](/de/costs).385* Legen Sie Pro-Workspace-Ausgabenlimits in der Console fest, um zu verhindern, dass ein einzelnes Projekt das Organisationsguthaben aufbraucht. Siehe [Kosten effektiv verwalten](/docs/de/costs).

386 386

387<h2 id="authentication-errors">387<h2 id="authentication-errors">

388 Authentifizierungsfehler388 Authentifizierungsfehler

404 404

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

406* 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 ist406* 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

407* Für CI oder Automatisierung, bei der interaktive Anmeldung nicht möglich ist, konfigurieren Sie ein [`apiKeyHelper`](/de/settings#available-settings)-Skript, das beim Start einen Schlüssel abruft407* Für CI oder Automatisierung, bei der interaktive Anmeldung nicht möglich ist, konfigurieren Sie ein [`apiKeyHelper`](/docs/de/settings#available-settings)-Skript, das beim Start einen Schlüssel abruft

408* Siehe [Authentifizierungspriorität](/de/authentication#authentication-precedence), um zu verstehen, welche Anmeldedaten Claude Code verwendet, wenn mehrere vorhanden sind408* Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence), um zu verstehen, welche Anmeldedaten Claude Code verwendet, wenn mehrere vorhanden sind

409 409

410Wenn Sie wiederholt zur Anmeldung aufgefordert werden, siehe [Nicht angemeldet oder Token abgelaufen](/de/troubleshoot-install#not-logged-in-or-token-expired) für Systemuhr- und macOS-Keychain-Korrektionen.410Wenn Sie wiederholt zur Anmeldung aufgefordert werden, siehe [Nicht angemeldet oder Token abgelaufen](/docs/de/troubleshoot-install#not-logged-in-or-token-expired) für Systemuhr- und macOS-Keychain-Korrektionen.

411 411

412<h3 id="could-not-resolve-authentication-method">412<h3 id="could-not-resolve-authentication-method">

413 Authentifizierungsmethode konnte nicht aufgelöst werden413 Authentifizierungsmethode konnte nicht aufgelöst werden

414</h3>414</h3>

415 415

416Die Sitzung erreichte den API-Client ohne Anmeldedaten. Dies erscheint in [Hintergrundsitzungen](/de/agent-view), Cloud-Sitzungen und Agent-SDK-Kontexten, bei denen die interaktive Anmeldungsprüfung nicht vor der ersten Anfrage ausgeführt wird.416Die Sitzung erreichte den API-Client ohne Anmeldedaten. Dies erscheint in [Hintergrundsitzungen](/docs/de/agent-view), Cloud-Sitzungen und Agent-SDK-Kontexten, bei denen die interaktive Anmeldungsprüfung nicht vor der ersten Anfrage ausgeführt wird.

417 417

418```text theme={null}418```text theme={null}

419Could 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 omitted419Could 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

420```420```

421 421

422{/* min-version: 2.1.174 */}Vor v2.1.174 konnte eine Hintergrund- oder Cloud-Sitzung, die einem untätigen vorinitialisiertem Worker zugewiesen war, auf diese Weise fehlschlagen, selbst wenn gültige Anmeldedaten konfiguriert waren. Führen Sie ein Upgrade durch, um die Funktion wiederherzustellen. In aktuellen Versionen bedeutet der Fehler, dass dem Worker-Prozess keine Anmeldedaten verfügbar waren.422Vor v2.1.174 konnte eine Hintergrund- oder Cloud-Sitzung, die einem untätigen vorinitialisiertem Worker zugewiesen war, auf diese Weise fehlschlagen, selbst wenn gültige Anmeldedaten konfiguriert waren. Führen Sie ein Upgrade durch, um die Funktion wiederherzustellen. In aktuellen Versionen bedeutet der Fehler, dass dem Worker-Prozess keine Anmeldedaten verfügbar waren.

423 423

424**Was zu tun ist:**424**Was zu tun ist:**

425 425

426* Führen Sie ein Upgrade auf v2.1.174 oder später durch, wenn dies in einer Hintergrund- oder Cloud-Sitzung angezeigt wird und Ihre Anmeldedaten bereits konfiguriert sind426* Führen Sie ein Upgrade auf v2.1.174 oder später durch, wenn dies in einer Hintergrund- oder Cloud-Sitzung angezeigt wird und Ihre Anmeldedaten bereits konfiguriert sind

427* 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 Shell427* Bestätigen Sie, dass `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` oder Ihre Cloud-Provider-Anmeldedaten in der Umgebung gesetzt sind, die den Worker startet, nicht nur in Ihrer interaktiven Shell

428* Für das Agent SDK siehe [Authentifizierungseinrichtung](/de/agent-sdk/overview#get-started)428* Für das Agent SDK siehe [Authentifizierungseinrichtung](/docs/de/agent-sdk/overview#get-started)

429* Führen Sie `/status` in einer interaktiven Sitzung in derselben Umgebung aus, um zu bestätigen, welche Anmeldedatenquelle aufgelöst wird429* Führen Sie `/status` in einer interaktiven Sitzung in derselben Umgebung aus, um zu bestätigen, welche Anmeldedatenquelle aufgelöst wird

430 430

431<h3 id="invalid-api-key">431<h3 id="invalid-api-key">

443* Überprüfen Sie auf Tippfehler und bestätigen Sie, dass der Schlüssel nicht in der [Console](https://platform.claude.com/settings/keys) widerrufen wurde443* Überprüfen Sie auf Tippfehler und bestätigen Sie, dass der Schlüssel nicht in der [Console](https://platform.claude.com/settings/keys) widerrufen wurde

444* Führen Sie `env | grep ANTHROPIC` in derselben Shell aus. Tools wie direnv, dotenv-Shell-Plugins und IDE-Terminals können einen veralteten Schlüssel aus einer `.env`-Datei in Ihrem Projekt laden, ohne dass Sie ihn explizit setzen444* Führen Sie `env | grep ANTHROPIC` in derselben Shell aus. Tools wie direnv, dotenv-Shell-Plugins und IDE-Terminals können einen veralteten Schlüssel aus einer `.env`-Datei in Ihrem Projekt laden, ohne dass Sie ihn explizit setzen

445* Heben Sie `ANTHROPIC_API_KEY` auf und führen Sie `/login` aus, um stattdessen Abonnement-Authentifizierung zu verwenden445* Heben Sie `ANTHROPIC_API_KEY` auf und führen Sie `/login` aus, um stattdessen Abonnement-Authentifizierung zu verwenden

446* Wenn der Schlüssel von einem [`apiKeyHelper`](/de/settings#available-settings)-Skript stammt, führen Sie das Skript direkt aus, um zu bestätigen, dass es einen gültigen Schlüssel auf stdout ausgibt446* Wenn der Schlüssel von einem [`apiKeyHelper`](/docs/de/settings#available-settings)-Skript stammt, führen Sie das Skript direkt aus, um zu bestätigen, dass es einen gültigen Schlüssel auf stdout ausgibt

447* Führen Sie `/status` aus, um zu bestätigen, welche Anmeldedatenquelle Claude Code tatsächlich verwendet447* Führen Sie `/status` aus, um zu bestätigen, welche Anmeldedatenquelle Claude Code tatsächlich verwendet

448 448

449<h3 id="your-apikeyhelper-script-is-failing">449<h3 id="your-apikeyhelper-script-is-failing">

450 Ihr apiKeyHelper-Skript schlägt fehl450 Ihr apiKeyHelper-Skript schlägt fehl

451</h3>451</h3>

452 452

453Der in der [`apiKeyHelper`](/de/settings#available-settings)-Einstellung konfigurierte Befehl ist mit einem Fehler beendet worden, hat das Zeitlimit überschritten oder hat nichts auf stdout ausgegeben. Ohne einen Schlüssel vom Skript erreicht die Anfrage die API mit einer Platzhalter-Anmeldedaten, und die API lehnt sie mit `401` ab.453Der in der [`apiKeyHelper`](/docs/de/settings#available-settings)-Einstellung konfigurierte Befehl ist mit einem Fehler beendet worden, hat das Zeitlimit überschritten oder hat nichts auf stdout ausgegeben. Ohne einen Schlüssel vom Skript erreicht die Anfrage die API mit einer Platzhalter-Anmeldedaten, und die API lehnt sie mit `401` ab.

454 454

455```text theme={null}455```text theme={null}

456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

457```457```

458 458

459Claude Code führt das Skript erneut aus und versucht die Anfrage bis zu zwei weitere Male, bevor diese Meldung angezeigt wird, daher wird der Fehler innerhalb von drei Versuchen angezeigt. {/* min-version: 2.1.208 */}Vor v2.1.208 verbrauchte Claude Code das gesamte [Wiederholungsbudget](#automatic-retries) beim erneuten Senden der Anfrage mit der Platzhalter-Anmeldedaten und meldete dann einen generischen `401`-Authentifizierungsfehler anstelle des Skriptfehlers.459Claude Code führt das Skript erneut aus und versucht die Anfrage bis zu zwei weitere Male, bevor diese Meldung angezeigt wird, daher wird der Fehler innerhalb von drei Versuchen angezeigt. Vor v2.1.208 verbrauchte Claude Code das gesamte [Wiederholungsbudget](#automatic-retries) beim erneuten Senden der Anfrage mit der Platzhalter-Anmeldedaten und meldete dann einen generischen `401`-Authentifizierungsfehler anstelle des Skriptfehlers.

460 460

461Das Ausführen von `/login` hilft hier nicht: die Ausgabe des Helfers [hat Vorrang](/de/authentication#authentication-precedence) vor einer gespeicherten Anmeldung, solange die Einstellung vorhanden ist.461Das Ausführen von `/login` hilft hier nicht: die Ausgabe des Helfers [hat Vorrang](/docs/de/authentication#authentication-precedence) vor einer gespeicherten Anmeldung, solange die Einstellung vorhanden ist.

462 462

463**Was zu tun ist:**463**Was zu tun ist:**

464 464

465* Führen Sie den in `apiKeyHelper` konfigurierten Befehl direkt in Ihrer Shell aus, um den Fehler zu reproduzieren465* Führen Sie den in `apiKeyHelper` konfigurierten Befehl direkt in Ihrer Shell aus, um den Fehler zu reproduzieren

466* Wenn der Befehl eine abgelaufene Sitzung meldet, authentifizieren Sie sich erneut bei Ihrem Anmeldedaten-Anbieter, z. B. indem Sie sich erneut bei Ihrem SSO oder Ihrem Secrets-Tresor anmelden466* Wenn der Befehl eine abgelaufene Sitzung meldet, authentifizieren Sie sich erneut bei Ihrem Anmeldedaten-Anbieter, z. B. indem Sie sich erneut bei Ihrem SSO oder Ihrem Secrets-Tresor anmelden

467* Beheben Sie den Befehl so, dass er den Schlüssel auf stdout ausgibt und mit Code 0 beendet wird. Siehe [Anmeldedaten mit apiKeyHelper rotieren](/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper) für ein funktionierendes Setup.467* Beheben Sie den Befehl so, dass er den Schlüssel auf stdout ausgibt und mit Code 0 beendet wird. Siehe [Anmeldedaten mit apiKeyHelper rotieren](/docs/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper) für ein funktionierendes Setup.

468* Führen Sie `/status` aus, um zu bestätigen, dass `apiKeyHelper` die aktive Anmeldedatenquelle ist. Jedes Mal, wenn der Befehl fehlschlägt, erscheinen sein Exit-Code und die Fehlerausgabe in einem `Cloud authentication`-Panel im Terminal.468* Führen Sie `/status` aus, um zu bestätigen, dass `apiKeyHelper` die aktive Anmeldedatenquelle ist. Jedes Mal, wenn der Befehl fehlschlägt, erscheinen sein Exit-Code und die Fehlerausgabe in einem `Cloud authentication`-Panel im Terminal.

469 469

470<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">

499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

500```500```

501 501

502Umgebungsvariablen und `apiKeyHelper` haben Vorrang vor `/login`, daher hilft das alleinige Ausführen von `/login` nicht, während einer von ihnen noch einen Schlüssel bereitstellt. Siehe [Authentifizierungspriorität](/de/authentication#authentication-precedence).502Umgebungsvariablen und `apiKeyHelper` haben Vorrang vor `/login`, daher hilft das alleinige Ausführen von `/login` nicht, während einer von ihnen noch einen Schlüssel bereitstellt. Siehe [Authentifizierungspriorität](/docs/de/authentication#authentication-precedence).

503 503

504**Was zu tun ist:**504**Was zu tun ist:**

505 505

506* Wenn die Meldung `ANTHROPIC_API_KEY` nennt, heben Sie es in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil oder `.env`-Datei, dann starten Sie `claude` neu506* Wenn die Meldung `ANTHROPIC_API_KEY` nennt, heben Sie es in der aktuellen Shell auf und entfernen Sie es aus Ihrem Shell-Profil oder `.env`-Datei, dann starten Sie `claude` neu

507* Wenn die Meldung `apiKeyHelper` nennt, entfernen Sie die [`apiKeyHelper`](/de/settings#available-settings)-Einstellung aus Ihrer `settings.json`507* Wenn die Meldung `apiKeyHelper` nennt, entfernen Sie die [`apiKeyHelper`](/docs/de/settings#available-settings)-Einstellung aus Ihrer `settings.json`

508* Führen Sie `/login` aus, um sich mit Ihrem claude.ai-Konto anzumelden508* Führen Sie `/login` aus, um sich mit Ihrem claude.ai-Konto anzumelden

509* Führen Sie danach `/status` aus, um zu bestätigen, dass die aktive Anmeldedaten Ihr Abonnement und nicht ein API-Schlüssel sind509* Führen Sie danach `/status` aus, um zu bestätigen, dass die aktive Anmeldedaten Ihr Abonnement und nicht ein API-Schlüssel sind

510* Wenn Sie API-Schlüssel-Authentifizierung für Automatisierung benötigen, bitten Sie Ihren Organisations-Administrator, sie in der Console erneut zu aktivieren510* Wenn Sie API-Schlüssel-Authentifizierung für Automatisierung benötigen, bitten Sie Ihren Organisations-Administrator, sie in der Console erneut zu aktivieren

526**Was zu tun ist:**526**Was zu tun ist:**

527 527

528* Bitten Sie Ihren Administrator, den Claude-Code-Zugriff für Ihre Organisation zu aktivieren528* Bitten Sie Ihren Administrator, den Claude-Code-Zugriff für Ihre Organisation zu aktivieren

529* Authentifizieren Sie sich stattdessen mit einem Console-API-Schlüssel anstelle Ihres Abonnements. Siehe [Claude-Console-Authentifizierung](/de/authentication#claude-console-authentication) für die Einrichtung.529* Authentifizieren Sie sich stattdessen mit einem Console-API-Schlüssel anstelle Ihres Abonnements. Siehe [Claude-Console-Authentifizierung](/docs/de/authentication#claude-console-authentication) für die Einrichtung.

530* Wenn Sie der Administrator sind und keine Option zum Aktivieren des Zugriffs sehen, kontaktieren Sie den [Anthropic-Support](https://support.claude.com)530* Wenn Sie der Administrator sind und keine Option zum Aktivieren des Zugriffs sehen, kontaktieren Sie den [Anthropic-Support](https://support.claude.com)

531 531

532<h3 id="routines-are-disabled-by-your-organizations-policy">532<h3 id="routines-are-disabled-by-your-organizations-policy">

533 Routinen sind durch die Richtlinie Ihrer Organisation deaktiviert533 Routinen sind durch die Richtlinie Ihrer Organisation deaktiviert

534</h3>534</h3>

535 535

536Ein Eigentümer in Ihrer Team- oder Enterprise-Organisation hat Routinen auf Organisationsebene deaktiviert. Der Fehler erscheint, wenn Sie versuchen, eine Routine zu erstellen oder auszuführen, einschließlich von `/schedule` und der [Routinen](/de/routines)-Benutzeroberfläche auf claude.ai/code.536Ein Eigentümer in Ihrer Team- oder Enterprise-Organisation hat Routinen auf Organisationsebene deaktiviert. Der Fehler erscheint, wenn Sie versuchen, eine Routine zu erstellen oder auszuführen, einschließlich von `/schedule` und der [Routinen](/docs/de/routines)-Benutzeroberfläche auf claude.ai/code.

537 537

538```text theme={null}538```text theme={null}

539Routines are disabled by your organization's policy.539Routines are disabled by your organization's policy.

544**Was zu tun ist:**544**Was zu tun ist:**

545 545

546* Bitten Sie einen Eigentümer in Ihrer Organisation, den **Routinen**-Schalter unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) zu aktivieren546* Bitten Sie einen Eigentümer in Ihrer Organisation, den **Routinen**-Schalter unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) zu aktivieren

547* Für einmalige geplante Arbeiten, die keine Routinen auf Organisationsebene erfordern, siehe [geplante Aufgaben](/de/scheduled-tasks)547* Für einmalige geplante Arbeiten, die keine Routinen auf Organisationsebene erfordern, siehe [geplante Aufgaben](/docs/de/scheduled-tasks)

548 548

549<h3 id="remote-control-requires-the-anthropic-api">549<h3 id="remote-control-requires-the-anthropic-api">

550 Remote Control erfordert die Anthropic API550 Remote Control erfordert die Anthropic API

551</h3>551</h3>

552 552

553Die Sitzung spricht nicht direkt mit der Anthropic API, daher gibt es kein claude.ai-Backend für [Remote Control](/de/remote-control) zum Koppeln.553Die Sitzung spricht nicht direkt mit der Anthropic API, daher gibt es kein claude.ai-Backend für [Remote Control](/docs/de/remote-control) zum Koppeln.

554 554

555```text theme={null}555```text theme={null}

556Remote Control is only available when using Claude via api.anthropic.com.556Remote Control is only available when using Claude via api.anthropic.com.

557```557```

558 558

559Dies erscheint auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry. {/* min-version: 2.1.196 */}Ab v2.1.196 erscheint es auch, wenn [`ANTHROPIC_BASE_URL`](/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. ein [LLM-Gateway](/de/llm-gateway) oder Proxy, selbst wenn Sie sich mit claude.ai anmelden.559Dies erscheint auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry. Ab v2.1.196 erscheint es auch, wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. ein [LLM-Gateway](/docs/de/llm-gateway) oder Proxy, selbst wenn Sie sich mit claude.ai anmelden.

560 560

561**Was zu tun ist:**561**Was zu tun ist:**

562 562

563* Heben Sie `ANTHROPIC_BASE_URL` auf und starten Sie die Sitzung neu, oder starten Sie Remote Control von einer Sitzung aus, die direkt mit der Anthropic API spricht563* Heben Sie `ANTHROPIC_BASE_URL` auf und starten Sie die Sitzung neu, oder starten Sie Remote Control von einer Sitzung aus, die direkt mit der Anthropic API spricht

564* Für diese und die anderen Remote-Control-Startmeldungen siehe [Remote Control beheben](/de/remote-control#troubleshooting)564* Für diese und die anderen Remote-Control-Startmeldungen siehe [Remote Control beheben](/docs/de/remote-control#troubleshooting)

565 565

566<h3 id="oauth-token-revoked-or-expired">566<h3 id="oauth-token-revoked-or-expired">

567 OAuth-Token widerrufen oder abgelaufen567 OAuth-Token widerrufen oder abgelaufen

581 581

582* Führen Sie `/login` aus, um sich erneut anzumelden582* Führen Sie `/login` aus, um sich erneut anzumelden

583* Wenn der Fehler nach der erneuten Authentifizierung innerhalb derselben Sitzung zurückkommt, führen Sie zuerst `/logout` aus, um das gespeicherte Token vollständig zu löschen, dann `/login`583* Wenn der Fehler nach der erneuten Authentifizierung innerhalb derselben Sitzung zurückkommt, führen Sie zuerst `/logout` aus, um das gespeicherte Token vollständig zu löschen, dann `/login`

584* Für wiederholte Anmeldungsaufforderungen über Starts hinweg siehe die Systemuhr- und macOS-Keychain-Prüfungen in [Fehlerbehebung](/de/troubleshoot-install#not-logged-in-or-token-expired)584* Für wiederholte Anmeldungsaufforderungen über Starts hinweg siehe die Systemuhr- und macOS-Keychain-Prüfungen in [Fehlerbehebung](/docs/de/troubleshoot-install#not-logged-in-or-token-expired)

585* Für andere Fehler einschließlich `403 Forbidden` und OAuth-Browser-Probleme siehe [Anmeldung und Authentifizierung](/de/troubleshoot-install#login-and-authentication)585* Für andere Fehler einschließlich `403 Forbidden` und OAuth-Browser-Probleme siehe [Anmeldung und Authentifizierung](/docs/de/troubleshoot-install#login-and-authentication)

586 586

587<h3 id="login-expired">587<h3 id="login-expired">

588 Anmeldung abgelaufen588 Anmeldung abgelaufen

589</h3>589</h3>

590 590

591Claude Code versuchte, Ihre gespeicherte claude.ai- oder Claude-Console-Anmeldung zu erneuern, und der OAuth-Dienst lehnte das gespeicherte Aktualisierungs-Token ab, daher löschte Claude Code die gespeicherten Anmeldedaten. Danach stoppt jede Anfrage lokal, bevor sie die API erreicht, da nur `/login` neue Anmeldedaten erstellen kann. {/* min-version: 2.1.206 */}Vor v2.1.206 sendete Claude Code die Anfrage trotzdem mit allen verbleibenden Anmeldedaten in der Umgebung, und dann schlugen alle Modelle mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) oder einem 401 anstelle einer Aufforderung zur Anmeldung fehl.591Claude Code versuchte, Ihre gespeicherte claude.ai- oder Claude-Console-Anmeldung zu erneuern, und der OAuth-Dienst lehnte das gespeicherte Aktualisierungs-Token ab, daher löschte Claude Code die gespeicherten Anmeldedaten. Danach stoppt jede Anfrage lokal, bevor sie die API erreicht, da nur `/login` neue Anmeldedaten erstellen kann. Vor v2.1.206 sendete Claude Code die Anfrage trotzdem mit allen verbleibenden Anmeldedaten in der Umgebung, und dann schlugen alle Modelle mit [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) oder einem 401 anstelle einer Aufforderung zur Anmeldung fehl.

592 592

593```text theme={null}593```text theme={null}

594Login expired · Please run /login594Login expired · Please run /login

595```595```

596 596

597Im [nicht-interaktiven Modus](/de/headless) (`-p`) und dem [Agent SDK](/de/agent-sdk/overview) lautet die Meldung wie folgt, und der strukturierte Fehlercode ist `authentication_failed`:597Im [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`:

598 598

599```text theme={null}599```text theme={null}

600Failed to authenticate: OAuth session expired and could not be refreshed600Failed to authenticate: OAuth session expired and could not be refreshed

602 602

603Dies ist nicht derselbe Zustand wie [OAuth-Token widerrufen oder abgelaufen](#oauth-token-revoked-or-expired). Diese Meldungen melden einen 401, den die API zurückgegeben hat. Claude Code selbst erzeugt `Login expired` für eine Anmeldung, die es bereits nicht erneuern konnte, daher sendet es keine Anfrage.603Dies ist nicht derselbe Zustand wie [OAuth-Token widerrufen oder abgelaufen](#oauth-token-revoked-or-expired). Diese Meldungen melden einen 401, den die API zurückgegeben hat. Claude Code selbst erzeugt `Login expired` für eine Anmeldung, die es bereits nicht erneuern konnte, daher sendet es keine Anfrage.

604 604

605Sitzungen, die mit einem API-Schlüssel, [`CLAUDE_CODE_OAUTH_TOKEN`](/de/env-vars) oder einem Drittanbieter authentifiziert sind, verwenden nicht die gespeicherte Anmeldung und sehen diese Meldung nie.605Sitzungen, die mit einem API-Schlüssel, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/de/env-vars) oder einem Drittanbieter authentifiziert sind, verwenden nicht die gespeicherte Anmeldung und sehen diese Meldung nie.

606 606

607**Was zu tun ist:**607**Was zu tun ist:**

608 608

609* Führen Sie `/login` aus, um sich erneut anzumelden. Das erneute Versuchen ohne Anmeldung zeigt dieselbe Meldung bei jeder Anfrage.609* Führen Sie `/login` aus, um sich erneut anzumelden. Das erneute Versuchen ohne Anmeldung zeigt dieselbe Meldung bei jeder Anfrage.

610* Im nicht-interaktiven Modus führen Sie `claude` in derselben Umgebung aus, schließen Sie `/login` ab, dann führen Sie Ihren Befehl erneut aus. Für Automatisierung, die sich nicht interaktiv anmelden kann, authentifizieren Sie sich mit `ANTHROPIC_API_KEY` oder [generieren Sie ein langlebiges Token mit `claude setup-token`](/de/authentication#generate-a-long-lived-token).610* Im nicht-interaktiven Modus führen Sie `claude` in derselben Umgebung aus, schließen Sie `/login` ab, dann führen Sie Ihren Befehl erneut aus. Für Automatisierung, die sich nicht interaktiv anmelden kann, authentifizieren Sie sich mit `ANTHROPIC_API_KEY` oder [generieren Sie ein langlebiges Token mit `claude setup-token`](/docs/de/authentication#generate-a-long-lived-token).

611* Wenn die Anmeldung weiterhin fehlschlägt, siehe [Anmeldung und Authentifizierung](/de/troubleshoot-install#login-and-authentication)611* Wenn die Anmeldung weiterhin fehlschlägt, siehe [Anmeldung und Authentifizierung](/docs/de/troubleshoot-install#login-and-authentication)

612 612

613<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">

614 OAuth-Bereichsanforderung614 OAuth-Bereichsanforderung

628 AWS-Anmeldedaten abgelaufen oder ungültig628 AWS-Anmeldedaten abgelaufen oder ungültig

629</h3>629</h3>

630 630

631{/* min-version: 2.1.198 */}Diese Meldung erfordert Claude Code v2.1.198 oder später und erscheint nur, wenn [`awsAuthRefresh`](/de/amazon-bedrock#advanced-credential-configuration) in Ihrer Einstellungsdatei gesetzt ist. Ihr AWS-Sitzungs-Token ist abgelaufen oder wurde abgelehnt, und die automatische Aktualisierung, die Claude Code bereits ausgeführt hat, hat keine Anmeldedaten erzeugt, die die API akzeptiert. Es erscheint bei einem 401 von [Claude Platform on AWS](/de/claude-platform-on-aws) oder dem [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint), wie diese Anbieter ein abgelaufenes Sicherheits-Token melden.631Diese Meldung erfordert Claude Code v2.1.198 oder später und erscheint nur, wenn [`awsAuthRefresh`](/docs/de/amazon-bedrock#advanced-credential-configuration) in Ihrer Einstellungsdatei gesetzt ist. Ihr AWS-Sitzungs-Token ist abgelaufen oder wurde abgelehnt, und die automatische Aktualisierung, die Claude Code bereits ausgeführt hat, hat keine Anmeldedaten erzeugt, die die API akzeptiert. Es erscheint bei einem 401 von [Claude Platform on AWS](/docs/de/claude-platform-on-aws) oder dem [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint), wie diese Anbieter ein abgelaufenes Sicherheits-Token melden.

632 632

633Der Aktionshinweis in der Mitte nennt den `awsAuthRefresh`-Befehl aus Ihren Einstellungen, daher variiert er. Der stabile Teil ist der führende `AWS credentials expired or invalid`:633Der Aktionshinweis in der Mitte nennt den `awsAuthRefresh`-Befehl aus Ihren Einstellungen, daher variiert er. Der stabile Teil ist der führende `AWS credentials expired or invalid`:

634 634

641**Was zu tun ist:**641**Was zu tun ist:**

642 642

643* Führen Sie den in der Meldung genannten `awsAuthRefresh`-Befehl aus, z. B. `aws sso login --profile myprofile`, in einem anderen Terminal aus und schließen Sie die Browser-Anmeldung ab, dann versuchen Sie es erneut643* Führen Sie den in der Meldung genannten `awsAuthRefresh`-Befehl aus, z. B. `aws sso login --profile myprofile`, in einem anderen Terminal aus und schließen Sie die Browser-Anmeldung ab, dann versuchen Sie es erneut

644* Führen Sie in einer interaktiven Sitzung `/login` aus, wählen Sie **3rd-party platform**, dann wählen Sie **Claude Platform on AWS · refresh credentials** unter **Using 3rd-party platforms**, um denselben Befehl auszuführen, ohne Claude Code neu zu starten. Siehe [AWS-Anmeldedaten konfigurieren](/de/claude-platform-on-aws#1-configure-aws-credentials)644* Führen Sie in einer interaktiven Sitzung `/login` aus, wählen Sie **3rd-party platform**, dann wählen Sie **Claude Platform on AWS · refresh credentials** unter **Using 3rd-party platforms**, um denselben Befehl auszuführen, ohne Claude Code neu zu starten. Siehe [AWS-Anmeldedaten konfigurieren](/docs/de/claude-platform-on-aws#1-configure-aws-credentials)

645* Wenn der Fehler nach dem erfolgreichen Aktualisierungsbefehl wiederholt wird, bestätigen Sie, dass die Identität außerhalb von Claude Code mit `aws sts get-caller-identity` in derselben Shell und demselben Profil gültig ist645* Wenn der Fehler nach dem erfolgreichen Aktualisierungsbefehl wiederholt wird, bestätigen Sie, dass die Identität außerhalb von Claude Code mit `aws sts get-caller-identity` in derselben Shell und demselben Profil gültig ist

646 646

647<h3 id="aws-authentication-failed">647<h3 id="aws-authentication-failed">

648 AWS-Authentifizierung fehlgeschlagen648 AWS-Authentifizierung fehlgeschlagen

649</h3>649</h3>

650 650

651{/* min-version: 2.1.198 */}Diese Meldung erfordert Claude Code v2.1.198 oder später und erscheint nur, wenn [`awsAuthRefresh`](/de/amazon-bedrock#advanced-credential-configuration) in Ihrer Einstellungsdatei gesetzt ist. Ihr AWS-Anbieter hat einen 403 zurückgegeben, oder [Amazon Bedrock](/de/amazon-bedrock) hat einen 401 zurückgegeben.651Diese Meldung erfordert Claude Code v2.1.198 oder später und erscheint nur, wenn [`awsAuthRefresh`](/docs/de/amazon-bedrock#advanced-credential-configuration) in Ihrer Einstellungsdatei gesetzt ist. Ihr AWS-Anbieter hat einen 403 zurückgegeben, oder [Amazon Bedrock](/docs/de/amazon-bedrock) hat einen 401 zurückgegeben.

652 652

653Claude Code kann nicht sagen, welche Ursache Sie getroffen haben. Amazon Bedrock meldet ein abgelaufenes Sicherheits-Token als 403, aber ein 403 ist auch, wie es eine Autorisierungsverweigerung meldet, z. B. eine `AccessDeniedException` von einer fehlenden IAM-Berechtigung oder ein Modell, das nicht für Ihr Konto aktiviert ist.653Claude Code kann nicht sagen, welche Ursache Sie getroffen haben. Amazon Bedrock meldet ein abgelaufenes Sicherheits-Token als 403, aber ein 403 ist auch, wie es eine Autorisierungsverweigerung meldet, z. B. eine `AccessDeniedException` von einer fehlenden IAM-Berechtigung oder ein Modell, das nicht für Ihr Konto aktiviert ist.

654 654

665**Was zu tun ist:**665**Was zu tun ist:**

666 666

667* Führen Sie den in der Meldung genannten `awsAuthRefresh`-Befehl oder `aws sso login` aus, falls ein abgelaufenes Anmeldedaten die Ursache ist667* Führen Sie den in der Meldung genannten `awsAuthRefresh`-Befehl oder `aws sso login` aus, falls ein abgelaufenes Anmeldedaten die Ursache ist

668* Wenn Ihre Anmeldedaten aktuell sind, bestätigen Sie, dass die IAM-Berechtigungen in [IAM-Konfiguration](/de/amazon-bedrock#iam-configuration) an die Identität angehängt sind, die Sie verwenden, und dass das ausgewählte Modell für Ihr Konto und Ihre Region aktiviert ist668* Wenn Ihre Anmeldedaten aktuell sind, bestätigen Sie, dass die IAM-Berechtigungen in [IAM-Konfiguration](/docs/de/amazon-bedrock#iam-configuration) an die Identität angehängt sind, die Sie verwenden, und dass das ausgewählte Modell für Ihr Konto und Ihre Region aktiviert ist

669* Führen Sie `aws sts get-caller-identity` aus, um zu bestätigen, welche Identität Ihre Anfragen verwenden; ein veraltetes `AWS_PROFILE` oder Standardprofil ist eine häufige Ursache für einen Berechtigungskonflikt669* Führen Sie `aws sts get-caller-identity` aus, um zu bestätigen, welche Identität Ihre Anfragen verwenden; ein veraltetes `AWS_PROFILE` oder Standardprofil ist eine häufige Ursache für einen Berechtigungskonflikt

670 670

671<h3 id="aws-default-chain-credential-resolve-timed-out">671<h3 id="aws-default-chain-credential-resolve-timed-out">

672 AWS-Standard-Chain-Anmeldedaten-Auflösung hat das Zeitlimit überschritten672 AWS-Standard-Chain-Anmeldedaten-Auflösung hat das Zeitlimit überschritten

673</h3>673</h3>

674 674

675Der AWS-Standard-Anmeldedaten-Provider-Chain hat keine Anmeldedaten innerhalb von 60 Sekunden erzeugt, daher stoppte Claude Code die Auflösung und schlugen die Anfrage fehl. Der Fehler ist lokale Anmeldedaten-Auflösung: die Anfrage erreichte nie [Amazon Bedrock](/de/amazon-bedrock), [Claude Platform on AWS](/de/claude-platform-on-aws) oder den [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint). Claude Code löscht seinen [Anmeldedaten-Cache](/de/amazon-bedrock#credential-caching-and-resolution-timeout) und versucht erneut, bevor dieser Fehler angezeigt wird, daher hat die Chain bei wiederholten Versuchen stagniert, wenn Sie ihn sehen.675Der AWS-Standard-Anmeldedaten-Provider-Chain hat keine Anmeldedaten innerhalb von 60 Sekunden erzeugt, daher stoppte Claude Code die Auflösung und schlugen die Anfrage fehl. 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 angezeigt wird, daher hat die Chain bei wiederholten Versuchen stagniert, wenn Sie ihn sehen.

676 676

677```text theme={null}677```text theme={null}

678API Error: AWS default-chain credential resolve timed out678API Error: AWS default-chain credential resolve timed out

679```679```

680 680

681Häufige Ursachen sind ein `credential_process`-Befehl in Ihrem AWS-Profil, der auf Eingaben wartet, die er nicht erhalten kann, und ein Container oder eine VM, deren Instance-Metadaten-Dienst (IMDS) nie auf die Sonde der Chain antwortet. {/* min-version: 2.1.207 */}Vor v2.1.207 ließ eine stagnierte Chain die Anfrage auf unbestimmte Zeit warten, anstatt mit dieser Meldung fehlzuschlagen.681Häufige Ursachen sind ein `credential_process`-Befehl in Ihrem AWS-Profil, der auf Eingaben wartet, die er nicht erhalten kann, und ein Container oder eine VM, deren Instance-Metadaten-Dienst (IMDS) nie auf die Sonde der Chain antwortet. Vor v2.1.207 ließ eine stagnierte Chain die Anfrage auf unbestimmte Zeit warten, anstatt mit dieser Meldung fehlzuschlagen.

682 682

683**Was zu tun ist:**683**Was zu tun ist:**

684 684

685* Führen Sie `aws sts get-caller-identity` in derselben Shell mit demselben `AWS_PROFILE` aus. Wenn es auch hängt, beheben Sie das Profil; ein `credential_process`-Befehl, der interaktiv auffordert, ist eine häufige Ursache.685* Führen Sie `aws sts get-caller-identity` in derselben Shell mit demselben `AWS_PROFILE` aus. Wenn es auch hängt, beheben Sie das Profil; ein `credential_process`-Befehl, der interaktiv auffordert, ist eine häufige Ursache.

686* Schließen Sie den Anmeldeschritt ab, bevor Sie Claude Code starten, z. B. `aws sso login --profile myprofile`, damit die Chain aus dem lokalen SSO-Cache aufgelöst wird, anstatt auf einen Browser-Flow zu warten686* Schließen Sie den Anmeldeschritt ab, bevor Sie Claude Code starten, z. B. `aws sso login --profile myprofile`, damit die Chain aus dem lokalen SSO-Cache aufgelöst wird, anstatt auf einen Browser-Flow zu warten

687* Wenn Ihre Chain eine interaktive Anmeldung ausführt, die legitim mehr als 60 Sekunden benötigt, z. B. SSO mit MFA durch einen Wrapper wie `aws-vault`, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/de/env-vars)687* Wenn Ihre Chain eine interaktive Anmeldung ausführt, die legitim mehr als 60 Sekunden benötigt, z. B. SSO mit MFA durch einen Wrapper wie `aws-vault`, erhöhen Sie das Limit in Millisekunden mit [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/de/env-vars)

688 688

689<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">

690 Netzwerk- und Verbindungsfehler690 Netzwerk- und Verbindungsfehler

712**Was zu tun ist:**712**Was zu tun ist:**

713 713

714* Bestätigen Sie, dass Sie den API-Host aus derselben Shell erreichen können, indem Sie `curl -I https://api.anthropic.com` ausführen. Verwenden Sie unter Windows PowerShell `curl.exe -I https://api.anthropic.com`, damit der integrierte `Invoke-WebRequest`-Alias nicht verwendet wird.714* Bestätigen Sie, dass Sie den API-Host aus derselben Shell erreichen können, indem Sie `curl -I https://api.anthropic.com` ausführen. Verwenden Sie unter Windows PowerShell `curl.exe -I https://api.anthropic.com`, damit der integrierte `Invoke-WebRequest`-Alias nicht verwendet wird.

715* Wenn Sie sich hinter einem Unternehmens-Proxy befinden, setzen Sie `HTTPS_PROXY` vor dem Starten von Claude Code und siehe [Netzwerkkonfiguration](/de/network-config)715* Wenn Sie sich hinter einem Unternehmens-Proxy befinden, setzen Sie `HTTPS_PROXY` vor dem Starten von Claude Code und siehe [Netzwerkkonfiguration](/docs/de/network-config)

716* Wenn Sie über ein LLM-Gateway oder Relay weiterleiten, setzen Sie [`ANTHROPIC_BASE_URL`](/de/env-vars) auf dessen Adresse. Siehe [Claude Code mit einem LLM-Gateway verbinden](/de/llm-gateway-connect) für die Einrichtung.716* Wenn Sie über ein LLM-Gateway oder Relay weiterleiten, setzen Sie [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf dessen Adresse. Siehe [Claude Code mit einem LLM-Gateway verbinden](/docs/de/llm-gateway-connect) für die Einrichtung.

717* Stellen Sie sicher, dass Ihre Firewall die in [Netzwerkzugriffsanforderungen](/de/network-config#network-access-requirements) aufgelisteten Hosts zulässt717* Stellen Sie sicher, dass Ihre Firewall die in [Netzwerkzugriffsanforderungen](/docs/de/network-config#network-access-requirements) aufgelisteten Hosts zulässt

718* Vorübergehende Fehler werden [automatisch wiederholt](#automatic-retries); anhaltende Fehler deuten auf ein lokales Netzwerkproblem hin718* Vorübergehende Fehler werden [automatisch wiederholt](#automatic-retries); anhaltende Fehler deuten auf ein lokales Netzwerkproblem hin

719 719

720Wenn `curl` erfolgreich ist, aber Claude Code immer noch fehlschlägt, liegt die Ursache normalerweise bei etwas zwischen der Laufzeit und dem Netzwerk und nicht beim Netzwerk selbst:720Wenn `curl` erfolgreich ist, aber Claude Code immer noch fehlschlägt, liegt die Ursache normalerweise bei etwas zwischen der Laufzeit und dem Netzwerk und nicht beim Netzwerk selbst:

727 Bedrock-Streaming-Antwort hat einen unerwarteten Content-Type727 Bedrock-Streaming-Antwort hat einen unerwarteten Content-Type

728</h3>728</h3>

729 729

730Ein Gateway oder Proxy zwischen Claude Code und [Amazon Bedrock](/de/amazon-bedrock) transformiert den Streaming-Antwortkörper oder seinen `Content-Type`-Header. Amazon Bedrock streamt Antworten als `application/vnd.amazon.eventstream`, und Claude Code lehnt eine erfolgreiche Streaming-Antwort ab, die einen anderen Content-Type meldet, anstatt einen Körper zu dekodieren, den es nicht lesen kann. Die Anfrage wird nicht wiederholt.730Ein Gateway oder Proxy zwischen Claude Code und [Amazon Bedrock](/docs/de/amazon-bedrock) transformiert den Streaming-Antwortkörper oder seinen `Content-Type`-Header. Amazon Bedrock streamt Antworten als `application/vnd.amazon.eventstream`, und Claude Code lehnt eine erfolgreiche Streaming-Antwort ab, die einen anderen Content-Type meldet, anstatt einen Körper zu dekodieren, den es nicht lesen kann. Die Anfrage wird nicht wiederholt.

731 731

732```text theme={null}732```text theme={null}

733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.

734```734```

735 735

736{/* min-version: 2.1.208 */}Vor v2.1.208 zeigte sich dieselbe Fehlkonfiguration als `API Error: Truncated event message received`, nachdem die gesamte Antwort gepuffert worden war.736Vor v2.1.208 zeigte sich dieselbe Fehlkonfiguration als `API Error: Truncated event message received`, nachdem die gesamte Antwort gepuffert worden war.

737 737

738**Was zu tun ist:**738**Was zu tun ist:**

739 739

740* Konfigurieren Sie das Gateway so, dass der `InvokeModelWithResponseStream`-Antwortkörper und sein `Content-Type`-Header unverändert weitergeleitet werden. Ein Vermittler, der den Stream als Server-Sent Events erneut aussendet, ist eine häufige Ursache.740* Konfigurieren Sie das Gateway so, dass der `InvokeModelWithResponseStream`-Antwortkörper und sein `Content-Type`-Header unverändert weitergeleitet werden. Ein Vermittler, der den Stream als Server-Sent Events erneut aussendet, ist eine häufige Ursache.

741* Wenn das Gateway nur den Header umschreibt und den binären Körper intakt weitergeleitet, setzen Sie [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/de/env-vars), um die Überprüfung zu überspringen, bis das Gateway behoben ist. Siehe [Streaming-Fehler hinter einem Gateway oder Proxy](/de/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).741* Wenn das Gateway nur den Header umschreibt und den binären Körper intakt weitergeleitet, setzen Sie [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/de/env-vars), um die Überprüfung zu überspringen, bis das Gateway behoben ist. Siehe [Streaming-Fehler hinter einem Gateway oder Proxy](/docs/de/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).

742 742

743<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">

744 SSL-Zertifikatsfehler744 SSL-Zertifikatsfehler

751Unable to connect to API: Self-signed certificate detected751Unable to connect to API: Self-signed certificate detected

752```752```

753 753

754{/* min-version: 2.1.199 */}Ab v2.1.199 wird ein Zertifikatvalidierungsfehler nicht wiederholt, daher wird dieser Fehler beim ersten Versuch angezeigt, anstatt nach dem vollständigen [Wiederholungsbudget](#automatic-retries). Frühere Versionen verbrachten einige Minuten mit Wiederholungen, bevor sie angezeigt wurden. Vorübergehende TLS-Bedingungen, wie z. B. ein Handshake-Timeout, werden weiterhin wiederholt.754Ab v2.1.199 wird ein Zertifikatvalidierungsfehler nicht wiederholt, daher wird dieser Fehler beim ersten Versuch angezeigt, anstatt nach dem vollständigen [Wiederholungsbudget](#automatic-retries). Frühere Versionen verbrachten einige Minuten mit Wiederholungen, bevor sie angezeigt wurden. Vorübergehende TLS-Bedingungen, wie z. B. ein Handshake-Timeout, werden weiterhin wiederholt.

755 755

756Während `/login` und der Startup-Konnektivitätsprüfung wird derselbe Fehler mit dem OpenSSL-Code und der Behebung inline gemeldet:756Während `/login` und der Startup-Konnektivitätsprüfung wird derselbe Fehler mit dem OpenSSL-Code und der Behebung inline gemeldet:

757 757

762**Was zu tun ist:**762**Was zu tun ist:**

763 763

764* Exportieren Sie das CA-Bundle Ihrer Organisation und verweisen Sie Claude Code darauf mit `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`764* Exportieren Sie das CA-Bundle Ihrer Organisation und verweisen Sie Claude Code darauf mit `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`

765* Siehe [Netzwerkkonfiguration](/de/network-config#custom-ca-certificates) für vollständige Einrichtungsanweisungen765* Siehe [Netzwerkkonfiguration](/docs/de/network-config#custom-ca-certificates) für vollständige Einrichtungsanweisungen

766* Setzen Sie nicht `NODE_TLS_REJECT_UNAUTHORIZED=0`, was die Zertifikatvalidierung vollständig deaktiviert766* Setzen Sie nicht `NODE_TLS_REJECT_UNAUTHORIZED=0`, was die Zertifikatvalidierung vollständig deaktiviert

767 767

768<h3 id="host-not-allowed-in-a-cloud-session">768<h3 id="host-not-allowed-in-a-cloud-session">

778 778

779Möglicherweise wird auch ein TLS-Zertifikat angezeigt, das nicht dem echten Zertifikat des Ziels entspricht. Die Cloud-Umgebung leitet ausgehenden Datenverkehr durch einen Proxy weiter, der die Netzwerkrichtlinie durchsetzt, daher bedeutet ein nicht übereinstimmendes Zertifikat, dass der Proxy die Verbindung beendet hat, nicht das Ziel.779Möglicherweise wird auch ein TLS-Zertifikat angezeigt, das nicht dem echten Zertifikat des Ziels entspricht. Die Cloud-Umgebung leitet ausgehenden Datenverkehr durch einen Proxy weiter, der die Netzwerkrichtlinie durchsetzt, daher bedeutet ein nicht übereinstimmendes Zertifikat, dass der Proxy die Verbindung beendet hat, nicht das Ziel.

780 780

781Dies ist kein clientseitiges Netzwerkproblem. Cloud-Sitzungen und [Routinen](/de/routines) werden in einer Sandbox-Umgebung ausgeführt, deren ausgehender Datenverkehr auf die Zulassungsliste der Umgebung gefiltert wird. Die **Standard**-Umgebung verwendet **Vertrauenswürdigen** Zugriff, der die [Standard-Zulassungsliste](/de/claude-code-on-the-web#default-allowed-domains) von Paketregistern, Cloud-Provider-APIs, Container-Registern und häufigen Entwicklungsdomänen zulässt, aber alles andere blockiert.781Dies ist kein clientseitiges Netzwerkproblem. Cloud-Sitzungen und [Routinen](/docs/de/routines) werden in einer Sandbox-Umgebung ausgeführt, deren ausgehender Datenverkehr auf die Zulassungsliste der Umgebung gefiltert wird. Die **Standard**-Umgebung verwendet **Vertrauenswürdigen** Zugriff, der die [Standard-Zulassungsliste](/docs/de/claude-code-on-the-web#default-allowed-domains) von Paketregistern, Cloud-Provider-APIs, Container-Registern und häufigen Entwicklungsdomänen zulässt, aber alles andere blockiert.

782 782

783**Was zu tun ist:**783**Was zu tun ist:**

784 784

785* Öffnen Sie die Routine zum Bearbeiten oder starten Sie eine Cloud-Sitzung. Wählen Sie das Cloud-Symbol mit dem Namen Ihrer Umgebung, z. B. **Standard**, um die Auswahl zu öffnen. Bewegen Sie den Mauszeiger über Ihre Umgebung und klicken Sie auf das Einstellungssymbol.785* Öffnen Sie die Routine zum Bearbeiten oder starten Sie eine Cloud-Sitzung. Wählen Sie das Cloud-Symbol mit dem Namen Ihrer Umgebung, z. B. **Standard**, um die Auswahl zu öffnen. Bewegen Sie den Mauszeiger über Ihre Umgebung und klicken Sie auf das Einstellungssymbol.

786* Ändern Sie im Dialog **Cloud-Umgebung aktualisieren** den **Netzwerkzugriff** von **Vertrauenswürdig** zu **Benutzerdefiniert**, und fügen Sie dann die blockierte Domain zu **Zulässige Domains** hinzu. Geben Sie eine Domain pro Zeile ein. Aktivieren Sie **Auch Standard-Liste häufiger Paketmanager einschließen**, um die [Standard-Zulassungsliste](/de/claude-code-on-the-web#default-allowed-domains) neben Ihren benutzerdefinierten Domains zu behalten. Wählen Sie stattdessen **Vollständig**, wenn Sie uneingeschränkten Zugriff möchten.786* Ändern Sie im Dialog **Cloud-Umgebung aktualisieren** den **Netzwerkzugriff** von **Vertrauenswürdig** zu **Benutzerdefiniert**, und fügen Sie dann die blockierte Domain zu **Zulässige Domains** hinzu. Geben Sie eine Domain pro Zeile ein. Aktivieren Sie **Auch Standard-Liste häufiger Paketmanager einschließen**, um die [Standard-Zulassungsliste](/docs/de/claude-code-on-the-web#default-allowed-domains) neben Ihren benutzerdefinierten Domains zu behalten. Wählen Sie stattdessen **Vollständig**, wenn Sie uneingeschränkten Zugriff möchten.

787* Klicken Sie auf **Änderungen speichern**. Die nächste Ausführung verwendet die aktualisierte Zulassungsliste.787* Klicken Sie auf **Änderungen speichern**. Die nächste Ausführung verwendet die aktualisierte Zulassungsliste.

788 788

789Siehe [Netzwerkzugriff](/de/claude-code-on-the-web#network-access) für Zugriffsstufen und die Standard-Zulassungsliste. Lokale CLI-Sitzungen sind von dieser Richtlinie nicht betroffen.789Siehe [Netzwerkzugriff](/docs/de/claude-code-on-the-web#network-access) für Zugriffsstufen und die Standard-Zulassungsliste. Lokale CLI-Sitzungen sind von dieser Richtlinie nicht betroffen.

790 790

791<h3 id="couldnt-reconnect-to-your-remote-control-session">791<h3 id="couldnt-reconnect-to-your-remote-control-session">

792 Verbindung zu Ihrer Remote-Control-Sitzung konnte nicht wiederhergestellt werden792 Verbindung zu Ihrer Remote-Control-Sitzung konnte nicht wiederhergestellt werden

796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

797```797```

798 798

799Das Fortsetzen mit `claude --resume` oder `claude --continue` stellt die Verbindung zur [Remote Control](/de/remote-control)-Sitzung wieder her, die in diesem Gespräch aufgezeichnet wurde. Diese Meldung bedeutet, dass die Wiederverbindung aus einem Grund fehlgeschlagen ist, der vorübergehend sein kann, z. B. eine Netzwerkunterbrechung oder ein Serverfehler, daher kann Claude Code nicht bestätigen, ob die Remote-Sitzung noch vorhanden ist. Ihre lokale Sitzung wird ohne Remote Control weiterhin ausgeführt.799Das Fortsetzen mit `claude --resume` oder `claude --continue` stellt die Verbindung zur [Remote Control](/docs/de/remote-control)-Sitzung wieder her, die in diesem Gespräch aufgezeichnet wurde. Diese Meldung bedeutet, dass die Wiederverbindung aus einem Grund fehlgeschlagen ist, der vorübergehend sein kann, z. B. eine Netzwerkunterbrechung oder ein Serverfehler, daher kann Claude Code nicht bestätigen, ob die Remote-Sitzung noch vorhanden ist. Ihre lokale Sitzung wird ohne Remote Control weiterhin ausgeführt.

800 800

801**Was zu tun ist:**801**Was zu tun ist:**

802 802

803* Führen Sie `/remote-control` aus, um die Verbindung erneut zu versuchen803* Führen Sie `/remote-control` aus, um die Verbindung erneut zu versuchen

804* Starten Sie Claude Code ohne `--resume`, um eine neue Remote-Control-Sitzung zu erstellen804* Starten Sie Claude Code ohne `--resume`, um eine neue Remote-Control-Sitzung zu erstellen

805* Weitere Remote-Control-Startmeldungen finden Sie unter [Remote Control beheben](/de/remote-control#troubleshooting)805* Weitere Remote-Control-Startmeldungen finden Sie unter [Remote Control beheben](/docs/de/remote-control#troubleshooting)

806 806

807Diese Meldung wird nicht angezeigt, wenn der Server bestätigt, dass die vorherige Sitzung nicht mehr vorhanden ist. Claude Code erstellt in diesem Fall eine neue. {/* min-version: 2.1.200 */}Vor v2.1.200 hat jeder Wiederverbindungsfehler eine neue Remote-Control-Sitzung erstellt, was zusätzliche Sitzungen in der Sitzungsliste unter claude.ai/code hinterlassen hat.807Diese Meldung wird nicht angezeigt, wenn der Server bestätigt, dass die vorherige Sitzung nicht mehr vorhanden ist. Claude Code erstellt in diesem Fall eine neue. Vor v2.1.200 hat jeder Wiederverbindungsfehler eine neue Remote-Control-Sitzung erstellt, was zusätzliche Sitzungen in der Sitzungsliste unter claude.ai/code hinterlassen hat.

808 808

809<h2 id="request-errors">809<h2 id="request-errors">

810 Anfragefehler810 Anfragefehler

827* Führen Sie `/compact` aus, um frühere Turns zusammenzufassen und Platz freizugeben, oder `/clear`, um neu zu beginnen827* Führen Sie `/compact` aus, um frühere Turns zusammenzufassen und Platz freizugeben, oder `/clear`, um neu zu beginnen

828* Führen Sie `/context` aus, um eine Aufschlüsselung zu sehen, was das Fenster verbraucht: Systemaufforderung, Tools, Speicherdateien und Nachrichten828* Führen Sie `/context` aus, um eine Aufschlüsselung zu sehen, was das Fenster verbraucht: Systemaufforderung, Tools, Speicherdateien und Nachrichten

829* Deaktivieren Sie MCP-Server, die Sie nicht verwenden, mit `/mcp disable <name>`, um ihre Tool-Definitionen aus dem Kontext zu entfernen829* Deaktivieren Sie MCP-Server, die Sie nicht verwenden, mit `/mcp disable <name>`, um ihre Tool-Definitionen aus dem Kontext zu entfernen

830* Trimmen Sie große `CLAUDE.md`-Speicherdateien, oder verschieben Sie Anweisungen in [pfadgebundene Regeln](/de/memory#path-specific-rules), die nur bei Bedarf geladen werden830* Trimmen Sie große `CLAUDE.md`-Speicherdateien, oder verschieben Sie Anweisungen in [pfadgebundene Regeln](/docs/de/memory#path-specific-rules), die nur bei Bedarf geladen werden

831* Subagenten erben jede MCP-Tool-Definition von der übergeordneten Sitzung, was ihr Kontextfenster füllen kann, bevor der erste Turn stattfindet. Deaktivieren Sie MCP-Server, die Sie nicht verwenden, bevor Sie Subagenten spawnen.831* Subagenten erben jede MCP-Tool-Definition von der übergeordneten Sitzung, was ihr Kontextfenster füllen kann, bevor der erste Turn stattfindet. Deaktivieren Sie MCP-Server, die Sie nicht verwenden, bevor Sie Subagenten spawnen.

832* Auto-Compact ist standardmäßig aktiviert und verhindert normalerweise diesen Fehler. Wenn Sie [`DISABLE_AUTO_COMPACT`](/de/env-vars) gesetzt haben, aktivieren Sie es erneut oder führen Sie `/compact` manuell aus, bevor das Fenster voll wird.832* Auto-Compact ist standardmäßig aktiviert und verhindert normalerweise diesen Fehler. Wenn Sie [`DISABLE_AUTO_COMPACT`](/docs/de/env-vars) gesetzt haben, aktivieren Sie es erneut oder führen Sie `/compact` manuell aus, bevor das Fenster voll wird.

833 833

834Siehe [Erkunden Sie das Kontextfenster](/de/context-window) für eine interaktive Ansicht, wie sich der Kontext füllt.834Siehe [Erkunden Sie das Kontextfenster](/docs/de/context-window) für eine interaktive Ansicht, wie sich der Kontext füllt.

835 835

836<h3 id="error-during-compaction-conversation-too-long">836<h3 id="error-during-compaction-conversation-too-long">

837 Fehler während der Komprimierung: Gespräch zu lang837 Fehler während der Komprimierung: Gespräch zu lang

879API Error: 400 ... image dimensions exceed max allowed size879API Error: 400 ... image dimensions exceed max allowed size

880```880```

881 881

882{/* min-version: 2.1.142 */}Claude Code ersetzt das nicht verarbeitbare Bild durch einen Textplatzhalter und versucht es erneut, sodass nachfolgende Nachrichten erfolgreich sind. In Versionen vor 2.1.142 konnte ein eingefügtes Bild im Gespräch bleiben und denselben Fehler bei jeder nachfolgenden Nachricht wiederholen. Um sich in diesen Versionen zu erholen, drücken Sie Esc zweimal und gehen Sie zurück zum Turn, in dem das Bild hinzugefügt wurde.882Claude Code ersetzt das nicht verarbeitbare Bild durch einen Textplatzhalter und versucht es erneut, sodass nachfolgende Nachrichten erfolgreich sind. In Versionen vor 2.1.142 konnte ein eingefügtes Bild im Gespräch bleiben und denselben Fehler bei jeder nachfolgenden Nachricht wiederholen. Um sich in diesen Versionen zu erholen, drücken Sie Esc zweimal und gehen Sie zurück zum Turn, in dem das Bild hinzugefügt wurde.

883 883

884**Was zu tun ist:**884**Was zu tun ist:**

885 885

939 939

940**Was zu tun ist:**940**Was zu tun ist:**

941 941

942* Konfigurieren Sie Ihr Gateway, um den `anthropic-beta`-Header weiterzuleiten. Siehe [Feature-Durchleitung](/de/llm-gateway-protocol#feature-pass-through) für das, was Gateways weiterleiten müssen.942* Konfigurieren Sie Ihr Gateway, um den `anthropic-beta`-Header weiterzuleiten. Siehe [Feature-Durchleitung](/docs/de/llm-gateway-protocol#feature-pass-through) für das, was Gateways weiterleiten müssen.

943* Setzen Sie als Fallback [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/de/env-vars) vor dem Start. Dies deaktiviert Funktionen, die den Beta-Header erfordern, sodass Anfragen durch ein Gateway erfolgreich sind, das ihn nicht weiterleiten kann.943* Setzen Sie als Fallback [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/de/env-vars) vor dem Start. Dies deaktiviert Funktionen, die den Beta-Header erfordern, sodass Anfragen durch ein Gateway erfolgreich sind, das ihn nicht weiterleiten kann.

944 944

945<h3 id="theres-an-issue-with-the-selected-model">945<h3 id="theres-an-issue-with-the-selected-model">

946 Es gibt ein Problem mit dem ausgewählten Modell946 Es gibt ein Problem mit dem ausgewählten Modell

955**Was zu tun ist:**955**Was zu tun ist:**

956 956

957* **Interaktive CLI**: Führen Sie `/model` aus, um aus Modellen auszuwählen, die für Ihr Konto verfügbar sind.957* **Interaktive CLI**: Führen Sie `/model` aus, um aus Modellen auszuwählen, die für Ihr Konto verfügbar sind.

958* **Nicht-interaktiver Modus (`-p`)**: Übergeben Sie `--model` mit einem gültigen Alias oder einer ID, oder setzen Sie [`ANTHROPIC_MODEL`](/de/env-vars). Der Fehlertext zeigt `Run --model` auf dieser Oberfläche.958* **Nicht-interaktiver Modus (`-p`)**: Übergeben Sie `--model` mit einem gültigen Alias oder einer ID, oder setzen Sie [`ANTHROPIC_MODEL`](/docs/de/env-vars). Der Fehlertext zeigt `Run --model` auf dieser Oberfläche.

959* **Agent SDK**: Der Fehlertext lässt den Hinweis weg, da das Modell programmgesteuert gesetzt wird. Setzen Sie [`model` auf `Options`](/de/agent-sdk/typescript#options) in TypeScript oder [`ClaudeAgentOptions(model=...)`](/de/agent-sdk/python#claudeagentoptions) in Python, und behandeln Sie den strukturierten `model_not_found`-Fehler, um Ihren eigenen Wiederholungs- oder Modellwähler anzuzeigen.959* **Agent SDK**: Der Fehlertext lässt den Hinweis weg, da das Modell programmgesteuert gesetzt wird. Setzen Sie [`model` auf `Options`](/docs/de/agent-sdk/typescript#options) in TypeScript oder [`ClaudeAgentOptions(model=...)`](/docs/de/agent-sdk/python#claudeagentoptions) in Python, und behandeln Sie den strukturierten `model_not_found`-Fehler, um Ihren eigenen Wiederholungs- oder Modellwähler anzuzeigen.

960* Verwenden Sie einen Alias wie `sonnet` oder `opus` anstelle einer vollständigen versionierten ID. Aliase werden zu einem verwalteten Standard aufgelöst, sodass sie nicht veralten. Siehe [Modellkonfiguration](/de/model-config).960* Verwenden Sie einen Alias wie `sonnet` oder `opus` anstelle einer vollständigen versionierten ID. Aliase werden zu einem verwalteten Standard aufgelöst, sodass sie nicht veralten. Siehe [Modellkonfiguration](/docs/de/model-config).

961* Wenn die falsche Modell immer wieder in der CLI zurückkommt, ist eine veraltete ID irgendwo gesetzt. Überprüfen Sie in [Prioritätsreihenfolge](/de/model-config#setting-your-model): das `--model`-Flag, die `ANTHROPIC_MODEL`-Umgebungsvariable, dann das `model`-Feld in `.claude/settings.local.json`, die `.claude/settings.json` Ihres Projekts und `~/.claude/settings.json`. Entfernen Sie den veralteten Wert und Claude Code fällt auf Ihren Kontostandardwert zurück.961* Wenn die falsche Modell immer wieder in der CLI zurückkommt, ist eine veraltete ID irgendwo gesetzt. Überprüfen Sie in [Prioritätsreihenfolge](/docs/de/model-config#setting-your-model): das `--model`-Flag, die `ANTHROPIC_MODEL`-Umgebungsvariable, dann das `model`-Feld in `.claude/settings.local.json`, die `.claude/settings.json` Ihres Projekts und `~/.claude/settings.json`. Entfernen Sie den veralteten Wert und Claude Code fällt auf Ihren Kontostandardwert zurück.

962* {/* min-version: 2.1.206 */}Claude Code meldet einen abgelaufenen claude.ai-Login als [Login abgelaufen](#login-expired), nicht als dieser Fehler. Vor v2.1.206 schlug ein abgelaufener Login, der nicht mehr aktualisiert werden konnte, bei jedem Modell mit diesem Fehler fehl; führen Sie `/login` aus, wenn Sie das auf einer älteren Version sehen.962* Claude Code meldet einen abgelaufenen claude.ai-Login als [Login abgelaufen](#login-expired), nicht als dieser Fehler. Vor v2.1.206 schlug ein abgelaufener Login, der nicht mehr aktualisiert werden konnte, bei jedem Modell mit diesem Fehler fehl; führen Sie `/login` aus, wenn Sie das auf einer älteren Version sehen.

963* Für Google Cloud's Agent Platform-Bereitstellungen siehe [Google Cloud's Agent Platform-Fehlerbehebung](/de/google-vertex-ai#troubleshooting).963* Für Google Cloud's Agent Platform-Bereitstellungen siehe [Google Cloud's Agent Platform-Fehlerbehebung](/docs/de/google-vertex-ai#troubleshooting).

964 964

965<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">

966 Modell ist keine erkannte Modell-ID966 Modell ist keine erkannte Modell-ID

974 974

975Der nachfolgende Hinweis nennt den nächsten passenden Alias oder die Modell-ID. Wenn nichts nah genug ist, lautet es stattdessen `Run /model to see available models.`975Der nachfolgende Hinweis nennt den nächsten passenden Alias oder die Modell-ID. Wenn nichts nah genug ist, lautet es stattdessen `Run /model to see available models.`

976 976

977Claude Code erzeugt diesen Fehler lokal in dem Moment, in dem der Wechsel angefordert wird, bevor eine API-Anfrage gestellt wird. Er gilt, wenn ein Modell durch die [Agent SDK](/de/agent-sdk/typescript) `setModel()`-Methode oder durch eine App wie die [Desktop-App](/de/desktop) gesetzt wird, die die Claude Code CLI für Sie ausführt.977Claude Code erzeugt diesen Fehler lokal in dem Moment, in dem der Wechsel angefordert wird, bevor eine API-Anfrage gestellt wird. Er gilt, wenn ein Modell durch die [Agent SDK](/docs/de/agent-sdk/typescript) `setModel()`-Methode oder durch eine App wie die [Desktop-App](/docs/de/desktop) gesetzt wird, die die Claude Code CLI für Sie ausführt.

978 978

979**Was zu tun ist:**979**Was zu tun ist:**

980 980

981* Führen Sie `/model` ohne Argument aus, um den Wähler zu öffnen und aus den Modellen auszuwählen, die für Ihr Konto verfügbar sind, dann übergeben Sie den dort angezeigten Alias oder die ID981* Führen Sie `/model` ohne Argument aus, um den Wähler zu öffnen und aus den Modellen auszuwählen, die für Ihr Konto verfügbar sind, dann übergeben Sie den dort angezeigten Alias oder die ID

982* Wenn Sie einen Alias verwendet haben, den eine neuere Claude Code-Version unterstützt, führen Sie `claude update` aus. Eine vollständige ID, die mit `claude-` beginnt, besteht diese Überprüfung, auch wenn das Modell neuer ist als Ihre Claude Code-Version, sodass ein Upgrade nicht erforderlich ist.982* Wenn Sie einen Alias verwendet haben, den eine neuere Claude Code-Version unterstützt, führen Sie `claude update` aus. Eine vollständige ID, die mit `claude-` beginnt, besteht diese Überprüfung, auch wenn das Modell neuer ist als Ihre Claude Code-Version, sodass ein Upgrade nicht erforderlich ist.

983* Ein Modell, das vor v2.1.200 gespeichert wurde, wird durch diese Überprüfung nicht repariert. Wenn ein veralteter Wert immer wieder zurückkommt, entfernen Sie ihn aus den unter [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) aufgelisteten Speicherorten.983* Ein Modell, das vor v2.1.200 gespeichert wurde, wird durch diese Überprüfung nicht repariert. Wenn ein veralteter Wert immer wieder zurückkommt, entfernen Sie ihn aus den unter [Es gibt ein Problem mit dem ausgewählten Modell](#theres-an-issue-with-the-selected-model) aufgelisteten Speicherorten.

984* Die Überprüfung wird nur auf der Anthropic API ausgeführt. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/de/claude-platform-on-aws) und hinter einem [LLM-Gateway](/de/llm-gateway) oder einer benutzerdefinierten `ANTHROPIC_BASE_URL` definiert Ihr Anbieter oder Gateway die Modellnamen, sodass Claude Code jede Zeichenkette akzeptiert und durchleitet.984* Die Überprüfung wird nur auf der Anthropic API ausgeführt. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und hinter einem [LLM-Gateway](/docs/de/llm-gateway) oder einer benutzerdefinierten `ANTHROPIC_BASE_URL` definiert Ihr Anbieter oder Gateway die Modellnamen, sodass Claude Code jede Zeichenkette akzeptiert und durchleitet.

985 985

986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

987 Claude Opus ist nicht mit dem Claude Pro-Plan verfügbar987 Claude Opus ist nicht mit dem Claude Pro-Plan verfügbar

1003 Modell ist durch die Einstellungen Ihrer Organisation eingeschränkt1003 Modell ist durch die Einstellungen Ihrer Organisation eingeschränkt

1004</h3>1004</h3>

1005 1005

1006Ihr Organisationsadministrator hat dieses Modell in der claude.ai-Administratorkonsole deaktiviert, oder es ist durch eine [`availableModels`](/de/model-config#restrict-model-selection)-Zulassungsliste in verwalteten Einstellungen ausgeschlossen. Wenn das eingeschränkte Modell mit `--model`, `ANTHROPIC_MODEL` oder der `model`-Einstellung gesetzt wurde, ersetzt Claude Code ein zulässiges Modell und fährt fort. Das Eingeben von `/model <name>` für ein eingeschränktes Modell wird mit `Run /model to choose a different model.` abgelehnt und die Sitzung behält ihr aktuelles Modell.1006Ihr Organisationsadministrator hat dieses Modell in der claude.ai-Administratorkonsole deaktiviert, oder es ist durch eine [`availableModels`](/docs/de/model-config#restrict-model-selection)-Zulassungsliste in verwalteten Einstellungen ausgeschlossen. Wenn das eingeschränkte Modell mit `--model`, `ANTHROPIC_MODEL` oder der `model`-Einstellung gesetzt wurde, ersetzt Claude Code ein zulässiges Modell und fährt fort. Das Eingeben von `/model <name>` für ein eingeschränktes Modell wird mit `Run /model to choose a different model.` abgelehnt und die Sitzung behält ihr aktuelles Modell.

1007 1007

1008```text theme={null}1008```text theme={null}

1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

1010```1010```

1011 1011

1012Claude Code behandelt einen Modellgruppen-Alias, einen von `opus`, `sonnet`, `haiku` oder `fable`, als Anfrage für diese Gruppe statt für ihre neueste Version. Auf der Anthropic API und auf [Claude Platform on AWS](/de/claude-platform-on-aws) wird ein eingeschränkter Gruppen-Alias zur neuesten Version der Gruppe aufgelöst, die Ihre Organisation und die `availableModels`-Zulassungsliste zulassen, und die Ersetzungsmitteilung nennt diese Version. Claude Code lehnt `/model <alias>` nur ab, wenn jede Version der Gruppe eingeschränkt ist. Vor v2.1.205 wurde ein Gruppen-Alias basierend auf seiner neuesten Version allein ersetzt oder abgelehnt, auch wenn eine ältere Version derselben Gruppe zulässig war.1012Claude Code behandelt einen Modellgruppen-Alias, einen von `opus`, `sonnet`, `haiku` oder `fable`, als Anfrage für diese Gruppe statt für ihre neueste Version. Auf der Anthropic API und auf [Claude Platform on AWS](/docs/de/claude-platform-on-aws) wird ein eingeschränkter Gruppen-Alias zur neuesten Version der Gruppe aufgelöst, die Ihre Organisation und die `availableModels`-Zulassungsliste zulassen, und die Ersetzungsmitteilung nennt diese Version. Claude Code lehnt `/model <alias>` nur ab, wenn jede Version der Gruppe eingeschränkt ist. Vor v2.1.205 wurde ein Gruppen-Alias basierend auf seiner neuesten Version allein ersetzt oder abgelehnt, auch wenn eine ältere Version derselben Gruppe zulässig war.

1013 1013

1014**Was zu tun ist:**1014**Was zu tun ist:**

1015 1015

1016* Führen Sie `/model` aus, um aus den Modellen auszuwählen, die Ihre Organisation zulässt. Eingeschränkte Modelle sind im Wähler verborgen.1016* Führen Sie `/model` aus, um aus den Modellen auszuwählen, die Ihre Organisation zulässt. Eingeschränkte Modelle sind im Wähler verborgen.

1017* Wenn das eingeschränkte Modell in `--model`, `ANTHROPIC_MODEL` oder dem `model`-Feld einer Einstellungsdatei gesetzt wurde, entfernen oder aktualisieren Sie diesen Wert, sodass die Mitteilung nicht bei jedem Start erneut angezeigt wird1017* Wenn das eingeschränkte Modell in `--model`, `ANTHROPIC_MODEL` oder dem `model`-Feld einer Einstellungsdatei gesetzt wurde, entfernen oder aktualisieren Sie diesen Wert, sodass die Mitteilung nicht bei jedem Start erneut angezeigt wird

1018* Wenn Sie Zugriff auf das eingeschränkte Modell benötigen, bitten Sie Ihren Organisationsadministrator, es zu aktivieren. Siehe [Organisationsmodell-Einschränkungen](/de/model-config#organization-model-restrictions).1018* Wenn Sie Zugriff auf das eingeschränkte Modell benötigen, bitten Sie Ihren Organisationsadministrator, es zu aktivieren. Siehe [Organisationsmodell-Einschränkungen](/docs/de/model-config#organization-model-restrictions).

1019 1019

1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

1021 thinking.type.enabled wird für dieses Modell nicht unterstützt1021 thinking.type.enabled wird für dieses Modell nicht unterstützt

1031 1031

1032* Führen Sie `claude update` aus und starten Sie Claude Code neu. Opus 4.7 benötigt v2.1.111 oder später. Opus 4.8 benötigt v2.1.154 oder später. Sonnet 5 benötigt v2.1.197 oder später1032* Führen Sie `claude update` aus und starten Sie Claude Code neu. Opus 4.7 benötigt v2.1.111 oder später. Opus 4.8 benötigt v2.1.154 oder später. Sonnet 5 benötigt v2.1.197 oder später

1033* Wenn Sie nicht aktualisieren können, führen Sie `/model` aus und wählen Sie stattdessen Opus 4.6 oder Sonnet 4.61033* Wenn Sie nicht aktualisieren können, führen Sie `/model` aus und wählen Sie stattdessen Opus 4.6 oder Sonnet 4.6

1034* {/* min-version: agent-sdk@0.3.197 */}Wenn Sie dies im [Agent SDK](/de/agent-sdk/overview) treffen, aktualisieren Sie stattdessen das SDK-Paket. Opus 4.8 benötigt TypeScript SDK v0.3.154 oder später und Python SDK v0.2.88 oder später. Sonnet 5 benötigt TypeScript SDK v0.3.197 oder später1034* Wenn Sie dies im [Agent SDK](/docs/de/agent-sdk/overview) treffen, aktualisieren Sie stattdessen das SDK-Paket. Opus 4.8 benötigt TypeScript SDK v0.3.154 oder später und Python SDK v0.2.88 oder später. Sonnet 5 benötigt TypeScript SDK v0.3.197 oder später

1035 1035

1036<h3 id="thinking-budget-exceeds-output-limit">1036<h3 id="thinking-budget-exceeds-output-limit">

1037 Thinking-Budget überschreitet Ausgabelimit1037 Thinking-Budget überschreitet Ausgabelimit

1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

1044```1044```

1045 1045

1046Claude Code passt diese Werte auf der Anthropic API automatisch an. Sie sehen diesen Fehler normalerweise auf Amazon Bedrock oder Google Cloud's Agent Platform, wenn [`MAX_THINKING_TOKENS`](/de/env-vars) höher als das Ausgabelimit des Anbieters gesetzt ist, oder wenn Plan Mode das Thinking-Budget erhöht.1046Claude Code passt diese Werte auf der Anthropic API automatisch an. Sie sehen diesen Fehler normalerweise auf Amazon Bedrock oder Google Cloud's Agent Platform, wenn [`MAX_THINKING_TOKENS`](/docs/de/env-vars) höher als das Ausgabelimit des Anbieters gesetzt ist, oder wenn Plan Mode das Thinking-Budget erhöht.

1047 1047

1048**Was zu tun ist:**1048**Was zu tun ist:**

1049 1049

1050* Senken Sie `MAX_THINKING_TOKENS`, oder erhöhen Sie [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/de/env-vars) über das Thinking-Budget1050* Senken Sie `MAX_THINKING_TOKENS`, oder erhöhen Sie [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/de/env-vars) über das Thinking-Budget

1051* Siehe [Extended Thinking](/de/model-config#extended-thinking) für die Interaktion des Budgets mit der Ausgabelänge1051* Siehe [Extended Thinking](/docs/de/model-config#extended-thinking) für die Interaktion des Budgets mit der Ausgabelänge

1052 1052

1053<h3 id="tool-use-or-thinking-block-mismatch">1053<h3 id="tool-use-or-thinking-block-mismatch">

1054 Tool-Verwendung oder Thinking-Block-Nichtübereinstimmung1054 Tool-Verwendung oder Thinking-Block-Nichtübereinstimmung

1066 1066

1067**Was zu tun ist:**1067**Was zu tun ist:**

1068 1068

1069* {/* max-version: 2.1.155 */}Wenn Sie Opus 4.7 oder Opus 4.8 verwenden, führen Sie zuerst `claude update` aus. Versionen vor v2.1.156 können diesen Fehler während normaler Tool-Verwendung auslösen, und `/rewind` löscht ihn nicht.1069* Wenn Sie Opus 4.7 oder Opus 4.8 verwenden, führen Sie zuerst `claude update` aus. Versionen vor v2.1.156 können diesen Fehler während normaler Tool-Verwendung auslösen, und `/rewind` löscht ihn nicht.

1070* Führen Sie `/rewind` aus, oder drücken Sie Esc zweimal, um zu einem Checkpoint vor dem beschädigten Turn zurückzugehen und von dort aus fortzufahren. Siehe [Checkpointing](/de/checkpointing) für die Erstellung und Wiederherstellung von Checkpoints.1070* Führen Sie `/rewind` aus, oder drücken Sie Esc zweimal, um zu einem Checkpoint vor dem beschädigten Turn zurückzugehen und von dort aus fortzufahren. Siehe [Checkpointing](/docs/de/checkpointing) für die Erstellung und Wiederherstellung von Checkpoints.

1071 1071

1072<h3 id="usage-policy-refusal">1072<h3 id="usage-policy-refusal">

1073 Richtlinienverletzung bei Nutzung1073 Richtlinienverletzung bei Nutzung

1079API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.1079API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

1080```1080```

1081 1081

1082Die Überprüfung bewertet das gesamte Gespräch, nicht nur Ihre neueste Eingabeaufforderung, sodass das Senden einer neuen Nachricht in derselben Sitzung normalerweise dieselbe Ablehnung erneut auslöst. Dasselbe gilt nach dem Beenden und erneuten Öffnen der Sitzung mit `--continue` oder `--resume`, da das Transkript auf der Festplatte immer noch den auslösenden Inhalt enthält. Auf [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) und [Microsoft Foundry](/de/microsoft-foundry) deckt diese Nachricht auch Anfragen ab, die die Sicherheitsmaßnahmen des Modells als Cybersicherheitsthema gekennzeichnet haben. Siehe [Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet](#safety-measures-flagged-a-cybersecurity-topic).1082Die Überprüfung bewertet das gesamte Gespräch, nicht nur Ihre neueste Eingabeaufforderung, sodass das Senden einer neuen Nachricht in derselben Sitzung normalerweise dieselbe Ablehnung erneut auslöst. Dasselbe gilt nach dem Beenden und erneuten Öffnen der Sitzung mit `--continue` oder `--resume`, da das Transkript auf der Festplatte immer noch den auslösenden Inhalt enthält. Auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) und [Microsoft Foundry](/docs/de/microsoft-foundry) deckt diese Nachricht auch Anfragen ab, die die Sicherheitsmaßnahmen des Modells als Cybersicherheitsthema gekennzeichnet haben. Siehe [Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet](#safety-measures-flagged-a-cybersecurity-topic).

1083 1083

1084**Was zu tun ist:**1084**Was zu tun ist:**

1085 1085

1086* Drücken Sie Esc zweimal oder führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der die Ablehnung auslöste, und formulieren Sie dann neu oder versuchen Sie einen anderen Ansatz. Siehe [Checkpointing](/de/checkpointing).1086* Drücken Sie Esc zweimal oder führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der die Ablehnung auslöste, und formulieren Sie dann neu oder versuchen Sie einen anderen Ansatz. Siehe [Checkpointing](/docs/de/checkpointing).

1087* Wenn Sie nicht identifizieren können, welcher Turn es verursacht hat, führen Sie `/clear` aus, um ein neues Gespräch im selben Projekt zu starten. Ihr vorheriges Gespräch bleibt auf der Festplatte erhalten und ist in `/resume` verfügbar.1087* Wenn Sie nicht identifizieren können, welcher Turn es verursacht hat, führen Sie `/clear` aus, um ein neues Gespräch im selben Projekt zu starten. Ihr vorheriges Gespräch bleibt auf der Festplatte erhalten und ist in `/resume` verfügbar.

1088* Im [nicht-interaktiven Modus](/de/headless) (`-p`), wo Rewind nicht verfügbar ist, versuchen Sie es erneut mit einer umformulierten Eingabeaufforderung in einer neuen Sitzung ohne `--continue`. Richtlinienüberprüfungen variieren je nach Modell, sodass der Wechsel zu einem anderen Modell mit `--model` die Ablehnung in einigen Fällen auch beheben kann.1088* Im [nicht-interaktiven Modus](/docs/de/headless) (`-p`), wo Rewind nicht verfügbar ist, versuchen Sie es erneut mit einer umformulierten Eingabeaufforderung in einer neuen Sitzung ohne `--continue`. Richtlinienüberprüfungen variieren je nach Modell, sodass der Wechsel zu einem anderen Modell mit `--model` die Ablehnung in einigen Fällen auch beheben kann.

1089 1089

1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">

1091 Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet1091 Sicherheitsmaßnahmen haben ein Cybersicherheitsthema gekennzeichnet

1103 1103

1104Was Sie sehen, hängt von Ihrem Anbieter und Modus ab:1104Was Sie sehen, hängt von Ihrem Anbieter und Modus ab:

1105 1105

1106* Auf [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) und [Microsoft Foundry](/de/microsoft-foundry) erzeugt eine Cybersicherheits-Kennzeichnung stattdessen die [Richtlinienverletzung bei Nutzung](#usage-policy-refusal)-Nachricht.1106* Auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) und [Microsoft Foundry](/docs/de/microsoft-foundry) erzeugt eine Cybersicherheits-Kennzeichnung stattdessen die [Richtlinienverletzung bei Nutzung](#usage-policy-refusal)-Nachricht.

1107* Der [nicht-interaktive Modus](/de/headless) lässt den `/feedback`-Satz weg.1107* Der [nicht-interaktive Modus](/docs/de/headless) lässt den `/feedback`-Satz weg.

1108 1108

1109{/* max-version: 2.1.202 */}Vor v2.1.203 lautete die Nachricht `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` gefolgt von einem Ausnahmeantragsformular-Link.1109Vor v2.1.203 lautete die Nachricht `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` gefolgt von einem Ausnahmeantragsformular-Link.

1110 1110

1111**Was zu tun ist:**1111**Was zu tun ist:**

1112 1112

1113* Wenn Ihre Arbeit diesen Inhalt erfordert, beantragen Sie Zugriff durch das [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)1113* Wenn Ihre Arbeit diesen Inhalt erfordert, beantragen Sie Zugriff durch das [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)

1114* Wenn Ihre Anfrage nicht über ein Cybersicherheitsthema war, führen Sie `/feedback` aus, um das falsch positive Ergebnis zu melden1114* Wenn Ihre Anfrage nicht über ein Cybersicherheitsthema war, führen Sie `/feedback` aus, um das falsch positive Ergebnis zu melden

1115* Um in derselben Sitzung weiterzuarbeiten, drücken Sie Esc zweimal oder führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der die Kennzeichnung auslöste, und versuchen Sie dann einen anderen Ansatz. Siehe [Checkpointing](/de/checkpointing).1115* Um in derselben Sitzung weiterzuarbeiten, drücken Sie Esc zweimal oder führen Sie `/rewind` aus, um zu einem Checkpoint vor dem Turn zurückzugehen, der die Kennzeichnung auslöste, und versuchen Sie dann einen anderen Ansatz. Siehe [Checkpointing](/docs/de/checkpointing).

1116 1116

1117<h2 id="installation-errors">1117<h2 id="installation-errors">

1118 Installationsfehler1118 Installationsfehler

1119</h2>1119</h2>

1120 1120

1121Diese Fehler treten bei der Installation oder Aktualisierung von Claude Code auf, entweder vom [Installationsskript](/de/setup#install-claude-code), von `claude install` oder von `claude update`. Für `command not found`, PATH-, Berechtigungs- und TLS-Probleme während der Einrichtung siehe [Installationen und Anmeldung beheben](/de/troubleshoot-install).1121Diese Fehler treten bei der Installation oder Aktualisierung von Claude Code auf, entweder vom [Installationsskript](/docs/de/setup#install-claude-code), von `claude install` oder von `claude update`. Für `command not found`, PATH-, Berechtigungs- und TLS-Probleme während der Einrichtung siehe [Installationen und Anmeldung beheben](/docs/de/troubleshoot-install).

1122 1122

1123<h3 id="installation-was-killed-before-it-could-finish">1123<h3 id="installation-was-killed-before-it-could-finish">

1124 Installation wurde beendet, bevor sie abgeschlossen werden konnte1124 Installation wurde beendet, bevor sie abgeschlossen werden konnte

1136**Was zu tun ist:**1136**Was zu tun ist:**

1137 1137

1138* Beenden Sie andere Prozesse, um Speicher freizugeben, und führen Sie dann das Installationsprogramm erneut aus1138* Beenden Sie andere Prozesse, um Speicher freizugeben, und führen Sie dann das Installationsprogramm erneut aus

1139* Fügen Sie Swap-Speicher hinzu oder wechseln Sie zu einer größeren Instanz. Siehe [Installation auf Linux-Servern mit wenig Speicher beendet](/de/troubleshoot-install#install-killed-on-low-memory-linux-servers) für die Swap-Datei-Befehle.1139* Fügen Sie Swap-Speicher hinzu oder wechseln Sie zu einer größeren Instanz. Siehe [Installation auf Linux-Servern mit wenig Speicher beendet](/docs/de/troubleshoot-install#install-killed-on-low-memory-linux-servers) für die Swap-Datei-Befehle.

1140 1140

1141<h3 id="the-connection-dropped-while-downloading-the-update">1141<h3 id="the-connection-dropped-while-downloading-the-update">

1142 Die Verbindung wurde während des Download der Aktualisierung unterbrochen1142 Die Verbindung wurde während des Download der Aktualisierung unterbrochen

1143</h3>1143</h3>

1144 1144

1145Die Verbindung zum Download-Server wurde geschlossen, während `claude install`, `claude update` oder das [automatische Update-Programm](/de/setup#auto-updates) die Claude Code-Binärdatei abrief, und die Wiederholungen konnten sich nicht erholen. Claude Code wiederholt den Download, wenn die Verbindung abbricht, die Übertragung steckenbleibt oder die heruntergeladene Datei ihre Prüfsumme nicht besteht, insgesamt bis zu drei Versuche. Ein abgeschlossener HTTP-Fehler, wie z. B. ein 404, wird nicht wiederholt, da der Server bereits geantwortet hat. {/* min-version: 2.1.202 */}Vor v2.1.202 führte eine einzelne unterbrochene Verbindung sofort zum Fehlschlag des Downloads mit dem bloßen Fehler `aborted` statt zu wiederholen.1145Die Verbindung zum Download-Server wurde geschlossen, während `claude install`, `claude update` oder das [automatische Update-Programm](/docs/de/setup#auto-updates) die Claude Code-Binärdatei abrief, und die Wiederholungen konnten sich nicht erholen. Claude Code wiederholt den Download, wenn die Verbindung abbricht, die Übertragung steckenbleibt oder die heruntergeladene Datei ihre Prüfsumme nicht besteht, insgesamt bis zu drei Versuche. Ein abgeschlossener HTTP-Fehler, wie z. B. ein 404, wird nicht wiederholt, da der Server bereits geantwortet hat. Vor v2.1.202 führte eine einzelne unterbrochene Verbindung sofort zum Fehlschlag des Downloads mit dem bloßen Fehler `aborted` statt zu wiederholen.

1146 1146

1147```text theme={null}1147```text theme={null}

1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

1157**Was zu tun ist:**1157**Was zu tun ist:**

1158 1158

1159* Führen Sie `claude update` erneut aus. Bei einem ansonsten gesunden Netzwerk ist der Download normalerweise beim nächsten Durchlauf erfolgreich. Für die Timeout-Meldung führen Sie es erneut aus einem schnelleren oder weniger gedrosselten Netzwerk aus.1159* Führen Sie `claude update` erneut aus. Bei einem ansonsten gesunden Netzwerk ist der Download normalerweise beim nächsten Durchlauf erfolgreich. Für die Timeout-Meldung führen Sie es erneut aus einem schnelleren oder weniger gedrosselten Netzwerk aus.

1160* Wenn Ihr Netzwerk einen Proxy erfordert, setzen Sie `HTTPS_PROXY` vor dem Ausführen des Installationsprogramms oder `claude update`. Siehe [Netzwerkkonnektivität überprüfen](/de/troubleshoot-install#check-network-connectivity).1160* Wenn Ihr Netzwerk einen Proxy erfordert, setzen Sie `HTTPS_PROXY` vor dem Ausführen des Installationsprogramms oder `claude update`. Siehe [Netzwerkkonnektivität überprüfen](/docs/de/troubleshoot-install#check-network-connectivity).

1161* Wenn ein Unternehmens-Proxy die Übertragung immer wieder beendet, bitten Sie Ihr Netzwerk-Team, den vollständigen Download von `downloads.claude.ai` zuzulassen. Siehe [Netzwerkzugriffsanforderungen](/de/network-config#network-access-requirements).1161* Wenn ein Unternehmens-Proxy die Übertragung immer wieder beendet, bitten Sie Ihr Netzwerk-Team, den vollständigen Download von `downloads.claude.ai` zuzulassen. Siehe [Netzwerkzugriffsanforderungen](/docs/de/network-config#network-access-requirements).

1162* Führen Sie `claude doctor` aus Ihrer Shell aus, um Installationsdiagnosen durchzuführen1162* Führen Sie `claude doctor` aus Ihrer Shell aus, um Installationsdiagnosen durchzuführen

1163 1163

1164<h2 id="command-line-errors">1164<h2 id="command-line-errors">

1171 Konflikt zwischen --bg und --print1171 Konflikt zwischen --bg und --print

1172</h3>1172</h3>

1173 1173

1174Diese 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 [Hintergrundsitzung](/de/agent-view#from-your-shell), die Sie später mit `claude agents` anfügen, während `--print` [nicht interaktiv](/de/headless) ausgeführt wird und niemals die interaktive Sitzung startet, die `claude agents` anfügt. Vor v2.1.198 hat diese Kombination stillschweigend einen Hintergrund-Job erstellt, der niemals angefügt werden konnte.1174Diese 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 [Hintergrundsitzung](/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 niemals die interaktive Sitzung startet, die `claude agents` anfügt. Vor v2.1.198 hat diese Kombination stillschweigend einen Hintergrund-Job erstellt, der niemals angefügt werden konnte.

1175 1175

1176```text theme={null}1176```text theme={null}

1177--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>'`.1177--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>'`.

1179 1179

1180**Was zu tun ist:**1180**Was zu tun ist:**

1181 1181

1182* Lassen Sie `-p` oder `--print` weg. `--bg` nimmt den Prompt als sein Positionsargument, also ist `claude --bg "<task>"` der vollständige Befehl. Siehe [Neue Agenten von Ihrer Shell aus versenden](/de/agent-view#from-your-shell).1182* Lassen Sie `-p` oder `--print` weg. `--bg` nimmt den Prompt 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).

1183* Um den Prompt nicht interaktiv auszuführen und das Ergebnis auszudrucken, anstatt eine Hintergrundsitzung zu erstellen, lassen Sie `--bg` weg und führen Sie `claude -p "<task>"` aus1183* Um den Prompt nicht interaktiv auszuführen und das Ergebnis auszudrucken, anstatt eine Hintergrundsitzung zu erstellen, lassen Sie `--bg` weg und führen Sie `claude -p "<task>"` aus

1184 1184

1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

1186 Der --json-schema Wert ist kein gültiges JSON Schema1186 Der --json-schema Wert ist kein gültiges JSON Schema

1187</h3>1187</h3>

1188 1188

1189Das Schema, das Sie an [`--json-schema`](/de/cli-reference#cli-flags) im [nicht interaktiven Modus](/de/headless#get-structured-output) übergeben haben, ist bei der JSON Schema Kompilierung fehlgeschlagen, daher beendet sich `claude` mit Code 1, anstatt den Prompt auszuführen. Vor v2.1.205 hat ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler erzeugt, und jedes Schema, das das `format` Schlüsselwort verwendete, wurde als ungültig behandelt.1189Das Schema, das Sie an [`--json-schema`](/docs/de/cli-reference#cli-flags) im [nicht interaktiven Modus](/docs/de/headless#get-structured-output) übergeben haben, ist bei der JSON Schema Kompilierung fehlgeschlagen, daher beendet sich `claude` mit Code 1, anstatt den Prompt auszuführen. Vor v2.1.205 hat ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler erzeugt, und jedes Schema, das das `format` Schlüsselwort verwendete, wurde als ungültig behandelt.

1190 1190

1191```text theme={null}1191```text theme={null}

1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

1200 1200

1201* Beheben Sie den Teil des Schemas, den die Diagnose benennt, und führen Sie dann den Befehl erneut aus1201* Beheben Sie den Teil des Schemas, den die Diagnose benennt, und führen Sie dann den Befehl erneut aus

1202* Wenn die Diagnose `schema too large` ist, reduzieren Sie die Verschachtelung des Schemas und die `$ref` Wiederverwendung1202* Wenn die Diagnose `schema too large` ist, reduzieren Sie die Verschachtelung des Schemas und die `$ref` Wiederverwendung

1203* Siehe [Strukturierte Ausgabe abrufen](/de/headless#get-structured-output) für ein funktionierendes Schema und einen Befehl1203* Siehe [Strukturierte Ausgabe abrufen](/docs/de/headless#get-structured-output) für ein funktionierendes Schema und einen Befehl

1204 1204

1205<h3 id="could-not-import-a-server-from-claude-desktop">1205<h3 id="could-not-import-a-server-from-claude-desktop">

1206 Konnte keinen Server aus Claude Desktop importieren1206 Konnte keinen Server aus Claude Desktop importieren

1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

1213```1213```

1214 1214

1215Der Text nach dem Servernamen ist der Grund. Der häufigste ist die Namensüberprüfung: Claude Desktop erlaubt Zeichen in Servernamen, wie Leerzeichen und Punkte, die `claude mcp` auf Buchstaben, Zahlen, Bindestriche und Unterstriche beschränkt. Andere Gründe sind eine Serverkonfiguration, die die Validierung nicht besteht, und ein Server, der durch die [MCP-Richtlinie](/de/managed-mcp) Ihrer Organisation blockiert wird.1215Der 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.

1216 1216

1217**Was zu tun ist:**1217**Was zu tun ist:**

1218 1218

1219* 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 aus1219* Benennen Sie den Server in `claude_desktop_config.json` um, um nur Buchstaben, Zahlen, Bindestriche und Unterstriche zu verwenden, und führen Sie dann `claude mcp add-from-claude-desktop` erneut aus

1220* 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](/de/mcp#import-mcp-servers-from-claude-desktop).1220* 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).

1221 1221

1222<h3 id="mcp-permission-prompt-tool-not-found">1222<h3 id="mcp-permission-prompt-tool-not-found">

1223 MCP-Berechtigungsprompt-Tool nicht gefunden1223 MCP-Berechtigungsprompt-Tool nicht gefunden

1224</h3>1224</h3>

1225 1225

1226Das Tool, das Sie an [`--permission-prompt-tool`](/de/cli-reference#cli-flags) übergeben haben, war nicht unter den verbundenen MCP-Tools, als der Lauf zum ersten Mal eine Berechtigungsentscheidung benötigte, entweder weil sein Server sich nie verbunden hat oder weil kein verbundener Server ein Tool mit diesem Namen verfügbar macht. Claude Code sendet Ihren Prompt weiterhin: Der [nicht interaktive](/de/headless) Lauf beendet sich mit diesem Fehler und Exit-Code 1 beim ersten Tool-Aufruf, der Genehmigung benötigt, daher wird keine Antwort erzeugt, obwohl die Anfrage gestellt wurde. Vor dem ersten Prompt wartet Claude Code bis zu 30 Sekunden auf das pro-Server-Verbindungs-Timeout, das durch [`MCP_TIMEOUT`](/de/env-vars) festgelegt ist, damit sich dieser Server verbindet. {/* min-version: 2.1.206 */}Vor v2.1.206 hat der Start nicht auf das Beenden der Serververbindung gewartet, daher hat ein langsam startender, aber funktionierender Server auch diesen Fehler erzeugt.1226Das 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 zum ersten Mal eine Berechtigungsentscheidung benötigte, entweder weil sein Server sich nie verbunden hat oder weil kein verbundener Server ein Tool mit diesem Namen verfügbar macht. Claude Code sendet Ihren Prompt weiterhin: Der [nicht interaktive](/docs/de/headless) Lauf beendet sich mit diesem Fehler und Exit-Code 1 beim ersten Tool-Aufruf, der Genehmigung benötigt, daher wird keine Antwort erzeugt, obwohl die Anfrage gestellt wurde. Vor dem ersten Prompt wartet Claude Code bis zu 30 Sekunden auf das pro-Server-Verbindungs-Timeout, das durch [`MCP_TIMEOUT`](/docs/de/env-vars) festgelegt ist, damit sich dieser Server verbindet. Vor v2.1.206 hat der Start nicht auf das Beenden der Serververbindung gewartet, daher hat ein langsam startender, aber funktionierender Server auch diesen Fehler erzeugt.

1227 1227

1228```text theme={null}1228```text theme={null}

1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

1235 1235

1236* Ü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 ist1236* Ü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 ist

1237* Bestätigen Sie, dass der Tool-Name dem `mcp__<server>__<tool>` Namen entspricht, den der Server verfügbar macht1237* Bestätigen Sie, dass der Tool-Name dem `mcp__<server>__<tool>` Namen entspricht, den der Server verfügbar macht

1238* Wenn der Server länger als 30 Sekunden zum Starten benötigt, erhöhen Sie [`MCP_TIMEOUT`](/de/env-vars)1238* Wenn der Server länger als 30 Sekunden zum Starten benötigt, erhöhen Sie [`MCP_TIMEOUT`](/docs/de/env-vars)

1239 1239

1240<h2 id="plugin-errors">1240<h2 id="plugin-errors">

1241 Plugin-Fehler1241 Plugin-Fehler

1242</h2>1242</h2>

1243 1243

1244Diese Fehler stammen aus der [Plugin](/de/plugins)- und [Marketplace](/de/plugin-marketplaces)-Konfiguration. Bei Plugin-Problemen, die keine der Meldungen auf dieser Seite erzeugen, wie z. B. eine Marketplace-URL, die nicht geladen wird, oder ein Plugin, das installiert wird, aber nicht angezeigt wird, siehe [Plugin-Fehlerbehebung](/de/discover-plugins#troubleshooting).1244Diese Fehler stammen aus der [Plugin](/docs/de/plugins)- und [Marketplace](/docs/de/plugin-marketplaces)-Konfiguration. Bei Plugin-Problemen, die keine der Meldungen auf dieser Seite erzeugen, wie z. B. eine Marketplace-URL, die nicht geladen wird, oder ein Plugin, das installiert wird, aber nicht angezeigt wird, siehe [Plugin-Fehlerbehebung](/docs/de/discover-plugins#troubleshooting).

1245 1245

1246<h3 id="marketplace-is-registered-from-an-untrusted-source">1246<h3 id="marketplace-is-registered-from-an-untrusted-source">

1247 Marketplace ist von einer nicht vertrauenswürdigen Quelle registriert1247 Marketplace ist von einer nicht vertrauenswürdigen Quelle registriert

1248</h3>1248</h3>

1249 1249

1250Der Marketplace ist unter einem Namen registriert, der [für offizielle Anthropic-Marketplaces reserviert ist](/de/plugin-marketplaces#marketplace-schema), aber seine registrierte Quelle ist kein `anthropics` GitHub-Repository. Claude Code überprüft reservierte Namen jedes Mal, wenn es einen Marketplace lädt oder aktualisiert, sodass der Marketplace und die von ihm installierten Plugins nicht mehr geladen werden. Vor v2.1.205 wurde der Name nur überprüft, wenn der Marketplace hinzugefügt wurde, sodass ein Eintrag, der registriert wurde, bevor sein Name reserviert wurde, weiterhin geladen wurde.1250Der Marketplace ist unter einem Namen registriert, der [für offizielle Anthropic-Marketplaces reserviert ist](/docs/de/plugin-marketplaces#marketplace-schema), aber seine registrierte Quelle ist kein `anthropics` GitHub-Repository. Claude Code überprüft reservierte Namen jedes Mal, wenn es einen Marketplace lädt oder aktualisiert, sodass der Marketplace und die von ihm installierten Plugins nicht mehr geladen werden. Vor v2.1.205 wurde der Name nur überprüft, wenn der Marketplace hinzugefügt wurde, sodass ein Eintrag, der registriert wurde, bevor sein Name reserviert wurde, weiterhin geladen wurde.

1251 1251

1252```text theme={null}1252```text theme={null}

1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

1257 1257

1258* Führen Sie `claude plugin marketplace remove <name>` aus und fügen Sie den Marketplace dann erneut aus dem offiziellen `github.com/anthropics`-Repository hinzu1258* Führen Sie `claude plugin marketplace remove <name>` aus und fügen Sie den Marketplace dann erneut aus dem offiziellen `github.com/anthropics`-Repository hinzu

1259* Wenn Sie einen Drittanbieter-Marketplace veröffentlichen, der den Namen verwendet hat, bevor er reserviert wurde, benennen Sie ihn um und bitten Sie Benutzer, ihn von Ihrer Quelle erneut hinzuzufügen1259* Wenn Sie einen Drittanbieter-Marketplace veröffentlichen, der den Namen verwendet hat, bevor er reserviert wurde, benennen Sie ihn um und bitten Sie Benutzer, ihn von Ihrer Quelle erneut hinzuzufügen

1260* Siehe die Liste der reservierten Namen unter [Marketplace-Schema](/de/plugin-marketplaces#marketplace-schema)1260* Siehe die Liste der reservierten Namen unter [Marketplace-Schema](/docs/de/plugin-marketplaces#marketplace-schema)

1261 1261

1262<h3 id="plugin-command-references-user-config">1262<h3 id="plugin-command-references-user-config">

1263 Plugin-Befehl referenziert user\_config in einem Shell-Befehl1263 Plugin-Befehl referenziert user\_config in einem Shell-Befehl

1264</h3>1264</h3>

1265 1265

1266Ein Plugin-Hook, [monitor](/de/plugins-reference#monitors), oder MCP [`headersHelper`](/de/mcp#use-dynamic-headers-for-custom-authentication)-Befehl referenziert eine `${user_config.KEY}` [Plugin-Option](/de/plugins-reference#user-configuration), und die ersetzte Zeichenkette würde an eine Shell übergeben. Ein konfigurierter Wert, der `$(...)`, Backticks oder `;` enthält, würde dort als Code ausgeführt, daher weigert sich Claude Code, die Komponente zu starten, anstatt den Wert zu ersetzen. Die Überprüfung wird auf der Befehlsvorlage ausgeführt, daher wird der Fehler angezeigt, auch wenn noch kein Wert konfiguriert ist. Vor v2.1.207 wurde der Wert in den Shell-Befehl eingesetzt.1266Ein Plugin-Hook, [monitor](/docs/de/plugins-reference#monitors), oder MCP [`headersHelper`](/docs/de/mcp#use-dynamic-headers-for-custom-authentication)-Befehl referenziert eine `${user_config.KEY}` [Plugin-Option](/docs/de/plugins-reference#user-configuration), und die ersetzte Zeichenkette würde an eine Shell übergeben. Ein konfigurierter Wert, der `$(...)`, Backticks oder `;` enthält, würde dort als Code ausgeführt, daher weigert sich Claude Code, die Komponente zu starten, anstatt den Wert zu ersetzen. Die Überprüfung wird auf der Befehlsvorlage ausgeführt, daher wird der Fehler angezeigt, auch wenn noch kein Wert konfiguriert ist. Vor v2.1.207 wurde der Wert in den Shell-Befehl eingesetzt.

1267 1267

1268Die Formulierung hängt davon ab, welche Oberfläche die Option referenziert hat. Ein Shell-Form-Hook meldet:1268Die Formulierung hängt davon ab, welche Oberfläche die Option referenziert hat. Ein Shell-Form-Hook meldet:

1269 1269

1285 1285

1286**Was zu tun ist:**1286**Was zu tun ist:**

1287 1287

1288* Für einen Hook fügen Sie ein `args`-Array hinzu, damit es in [Exec-Form](/de/hooks#exec-form-and-shell-form) ausgeführt wird, wobei jedes `${user_config.KEY}` zu einem Argument wird, ohne dass eine Shell dazwischen liegt. Oder lassen Sie die Referenz weg und lesen Sie die `$CLAUDE_PLUGIN_OPTION_<KEY>`-Umgebungsvariable innerhalb des Skripts1288* Für einen Hook fügen Sie ein `args`-Array hinzu, damit es in [Exec-Form](/docs/de/hooks#exec-form-and-shell-form) ausgeführt wird, wobei jedes `${user_config.KEY}` zu einem Argument wird, ohne dass eine Shell dazwischen liegt. Oder lassen Sie die Referenz weg und lesen Sie die `$CLAUDE_PLUGIN_OPTION_<KEY>`-Umgebungsvariable innerhalb des Skripts

1289* Für einen Monitor lassen Sie die Referenz weg und lassen Sie das Monitor-Skript den Wert aus einer Konfigurationsdatei lesen1289* Für einen Monitor lassen Sie die Referenz weg und lassen Sie das Monitor-Skript den Wert aus einer Konfigurationsdatei lesen

1290* Für einen `headersHelper` verschieben Sie `${user_config.KEY}` in das `headers`-Feld des Servers, das nicht shell-geparst wird, oder lesen Sie den Wert innerhalb des Helper-Skripts1290* Für einen `headersHelper` verschieben Sie `${user_config.KEY}` in das `headers`-Feld des Servers, das nicht shell-geparst wird, oder lesen Sie den Wert innerhalb des Helper-Skripts

1291 1291

1299 Agent würde mit null Werkzeugen erzeugt1299 Agent würde mit null Werkzeugen erzeugt

1300</h3>1300</h3>

1301 1301

1302Nichts in der [Werkzeugliste eines Subagent's](/de/sub-agents#supported-frontmatter-fields) wurde zu einem Werkzeug aufgelöst, daher weigert sich Claude Code, den Subagent zu starten, anstatt einen zu starten, der nicht handeln kann. Die Meldung gruppiert die Einträge danach, warum sie nicht aufgelöst wurden: kein erkanntes Werkzeug, ein Werkzeug, das für Subagents nicht verfügbar ist, oder erkannt, aber kein Werkzeug in der aktuellen Sitzung entsprechend. Das Weglassen des `tools`-Feldes löst diese Ablehnung niemals aus. Ein MCP-Servermuster wie `mcp__github__*` ist nicht ausgenommen: Wenn kein verbundenes Werkzeug von diesem Server stammt, wird der Start mit dem Muster in der Gruppe „nichts gefunden" abgelehnt. Vor v2.1.208 wurde der Subagent mit null Werkzeugen gestartet und gab ein leeres oder verwirrendes Ergebnis zurück.1302Nichts in der [Werkzeugliste eines Subagent's](/docs/de/sub-agents#supported-frontmatter-fields) wurde zu einem Werkzeug aufgelöst, daher weigert sich Claude Code, den Subagent zu starten, anstatt einen zu starten, der nicht handeln kann. Die Meldung gruppiert die Einträge danach, warum sie nicht aufgelöst wurden: kein erkanntes Werkzeug, ein Werkzeug, das für Subagents nicht verfügbar ist, oder erkannt, aber kein Werkzeug in der aktuellen Sitzung entsprechend. Das Weglassen des `tools`-Feldes löst diese Ablehnung niemals aus. Ein MCP-Servermuster wie `mcp__github__*` ist nicht ausgenommen: Wenn kein verbundenes Werkzeug von diesem Server stammt, wird der Start mit dem Muster in der Gruppe „nichts gefunden" abgelehnt. Vor v2.1.208 wurde der Subagent mit null Werkzeugen gestartet und gab ein leeres oder verwirrendes Ergebnis zurück.

1303 1303

1304```text theme={null}1304```text theme={null}

1305Agent 'code-reviewer' würde mit null Werkzeugen erzeugt — Ablehnung. Seine Werkzeugliste wurde zu nichts aufgelöst: unerkannt [Grpe]. Korrigieren Sie die Werkzeuge-Frontmatter des Agenten oder übergeben Sie einen anderen subagent_type.1305Agent 'code-reviewer' würde mit null Werkzeugen erzeugt — Ablehnung. Seine Werkzeugliste wurde zu nichts aufgelöst: unerkannt [Grpe]. Korrigieren Sie die Werkzeuge-Frontmatter des Agenten oder übergeben Sie einen anderen subagent_type.

1307 1307

1308**Was zu tun ist:**1308**Was zu tun ist:**

1309 1309

1310* Korrigieren Sie jeden Eintrag, den der Fehler gegen die [für Subagents verfügbaren Werkzeuge](/de/sub-agents#available-tools) benennt1310* Korrigieren Sie jeden Eintrag, den der Fehler gegen die [für Subagents verfügbaren Werkzeuge](/docs/de/sub-agents#available-tools) benennt

1311* Entfernen Sie Einträge für Werkzeuge, die die Sitzung nicht hat, wie MCP-Werkzeuge von einem Server, der nicht verbunden ist1311* Entfernen Sie Einträge für Werkzeuge, die die Sitzung nicht hat, wie MCP-Werkzeuge von einem Server, der nicht verbunden ist

1312* Um dem Subagent jedes Werkzeug zu geben, das der übergeordnete Agent hat, löschen Sie stattdessen das `tools`-Feld, anstatt Werkzeuge aufzulisten1312* Um dem Subagent jedes Werkzeug zu geben, das der übergeordnete Agent hat, löschen Sie stattdessen das `tools`-Feld, anstatt Werkzeuge aufzulisten

1313 1313

1315 Datei wird durch eine Read-Ablehnungsregel abgedeckt1315 Datei wird durch eine Read-Ablehnungsregel abgedeckt

1316</h3>1316</h3>

1317 1317

1318Das Edit-Werkzeug wurde auf einem Pfad aufgerufen, der einer [`Read`-Ablehnungsregel](/de/permissions#read-and-edit) entspricht, einschließlich der Erstellung einer neuen Datei in diesem Pfad. Das Bearbeiten schreibt Inhalte um, die Claude zurücklesen können muss, daher wird der Aufruf vor jedem Dateizugriff abgelehnt. Die Regel blockiert nur das Edit-Werkzeug: Write und NotebookEdit werden nicht durch `Read`-Ablehnungsregeln abgedeckt. Vor v2.1.208 blockierten nur eine `Edit`-Ablehnungsregel Bearbeitungen, und eine `Read`-Ablehnungsregel allein tat dies nicht.1318Das Edit-Werkzeug wurde auf einem Pfad aufgerufen, der einer [`Read`-Ablehnungsregel](/docs/de/permissions#read-and-edit) entspricht, einschließlich der Erstellung einer neuen Datei in diesem Pfad. Das Bearbeiten schreibt Inhalte um, die Claude zurücklesen können muss, daher wird der Aufruf vor jedem Dateizugriff abgelehnt. Die Regel blockiert nur das Edit-Werkzeug: Write und NotebookEdit werden nicht durch `Read`-Ablehnungsregeln abgedeckt. Vor v2.1.208 blockierten nur eine `Edit`-Ablehnungsregel Bearbeitungen, und eine `Read`-Ablehnungsregel allein tat dies nicht.

1319 1319

1320```text theme={null}1320```text theme={null}

1321Die Datei wird durch eine Read-Ablehnungsregel in Ihren Berechtigungseinstellungen abgedeckt und kann nicht bearbeitet werden.1321Die Datei wird durch eine Read-Ablehnungsregel in Ihren Berechtigungseinstellungen abgedeckt und kann nicht bearbeitet werden.

1323 1323

1324**Was zu tun ist:**1324**Was zu tun ist:**

1325 1325

1326* Wenn Claude die Datei bearbeiten können soll, entfernen oder verengen Sie die `Read`-Ablehnungsregel in `/permissions` oder in [Einstellungen](/de/settings#permission-settings)1326* Wenn Claude die Datei bearbeiten können soll, entfernen oder verengen Sie die `Read`-Ablehnungsregel in `/permissions` oder in [Einstellungen](/docs/de/settings#permission-settings)

1327* Wenn die Datei unverändert bleiben muss, behalten Sie die Regel und fügen Sie eine `Edit`-Ablehnungsregel für denselben Pfad hinzu, damit die Write- und NotebookEdit-Werkzeuge ebenfalls blockiert werden1327* Wenn die Datei unverändert bleiben muss, behalten Sie die Regel und fügen Sie eine `Edit`-Ablehnungsregel für denselben Pfad hinzu, damit die Write- und NotebookEdit-Werkzeuge ebenfalls blockiert werden

1328 1328

1329<h2 id="background-session-errors">1329<h2 id="background-session-errors">

1330 Fehler in Hintergrund-Sitzungen1330 Fehler in Hintergrund-Sitzungen

1331</h2>1331</h2>

1332 1332

1333[Hintergrund-Sitzungen](/de/agent-view) laufen ohne ein eigenes interaktives Terminal, daher verhalten sich Befehle, die eines benötigen, dort anders. Diese Meldungen erscheinen im Transkript einer Hintergrund-Sitzung, in der Agent-Ansicht oder nach dem Anhängen.1333[Hintergrund-Sitzungen](/docs/de/agent-view) laufen ohne ein eigenes interaktives Terminal, daher verhalten sich Befehle, die eines benötigen, dort anders. Diese Meldungen erscheinen im Transkript einer Hintergrund-Sitzung, in der Agent-Ansicht oder nach dem Anhängen.

1334 1334

1335<h3 id="commands-refused-in-a-background-session">1335<h3 id="commands-refused-in-a-background-session">

1336 Befehle, die in einer Hintergrund-Sitzung abgelehnt werden1336 Befehle, die in einer Hintergrund-Sitzung abgelehnt werden

1337</h3>1337</h3>

1338 1338

1339Befehle, die einen interaktiven Dialog öffnen, werden in einer Hintergrund-Sitzung mit einer Meldung abgelehnt, die entweder ein dort funktionierendes Formular benennt oder Ihnen mitteilt, den Befehl von einem regulären Terminal aus auszuführen. `/install-github-app`, die `/mcp`-Einstellungsliste und die Authentifizierungsaktionen im MCP-Server-Menü werden alle auf diese Weise abgelehnt. Vor v2.1.208 öffneten sie ihren Dialog innerhalb der Hintergrund-Sitzung.1339Befehle, die einen interaktiven Dialog öffnen, werden in einer Hintergrund-Sitzung mit einer Meldung abgelehnt, die entweder ein dort funktionierendes Formular benennt oder Ihnen mitteilt, den Befehl von einem regulären Terminal aus auszuführen. `/install-github-app`, die `/mcp`-Einstellungsliste und die Authentifizierungsaktionen im MCP-Server-Menü werden alle auf diese Weise abgelehnt. Vor v2.1.208 öffneten sie ihren Dialog innerhalb der Hintergrund-Sitzung.

1340{/* max-version: 2.1.208 */}In v2.1.208 nur wurde die `/model`-Auswahl auch in einer Hintergrund-Sitzung abgelehnt, und `/upgrade` gab die Upgrade-URL aus, anstatt einen Browser zu öffnen.1340In v2.1.208 nur wurde die `/model`-Auswahl auch in einer Hintergrund-Sitzung abgelehnt, und `/upgrade` gab die Upgrade-URL aus, anstatt einen Browser zu öffnen.

1341 1341

1342Die Formulierung benennt den Befehl, der abgelehnt wurde. Die `/mcp`-Einstellungsliste meldet:1342Die Formulierung benennt den Befehl, der abgelehnt wurde. Die `/mcp`-Einstellungsliste meldet:

1343 1343

1354 CLAUDE\_CODE\_PROCESS\_WRAPPER Launcher-Fehler1354 CLAUDE\_CODE\_PROCESS\_WRAPPER Launcher-Fehler

1355</h3>1355</h3>

1356 1356

1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/de/corporate-launcher) ist gesetzt, und sein Wert kann nicht verwendet werden, daher weigert sich Claude Code, den betroffenen Prozess zu starten, anstatt ihn ohne den Launcher auszuführen. Konfigurationsprobleme werden mit einer Meldung gemeldet, die mit dem Variablennamen beginnt und den Grund angibt, zum Beispiel:1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/de/corporate-launcher) ist gesetzt, und sein Wert kann nicht verwendet werden, daher weigert sich Claude Code, den betroffenen Prozess zu starten, anstatt ihn ohne den Launcher auszuführen. Konfigurationsprobleme werden mit einer Meldung gemeldet, die mit dem Variablennamen beginnt und den Grund angibt, zum Beispiel:

1358 1358

1359```text theme={null}1359```text theme={null}

1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file

1364 1364

1365**Was zu tun ist:**1365**Was zu tun ist:**

1366 1366

1367* Setzen Sie die Variable auf den absoluten Pfad einer ausführbaren Datei, die mit dem Aufruf von `exec "$@"` endet. Siehe [den Launcher-Vertrag](/de/corporate-launcher#the-launcher-contract) für den vollständigen Vertrag1367* Setzen Sie die Variable auf den absoluten Pfad einer ausführbaren Datei, die mit dem Aufruf von `exec "$@"` endet. Siehe [den Launcher-Vertrag](/docs/de/corporate-launcher#the-launcher-contract) für den vollständigen Vertrag

1368* Überprüfen Sie `/status`, das den aufgelösten Startbefehl in seinem Self-exec-Eintrag anzeigt und warnt, wenn der laufende Hintergrund-Service nicht damit übereinstimmt, oder führen Sie `claude daemon status` von einer Shell aus1368* Überprüfen Sie `/status`, das den aufgelösten Startbefehl in seinem Self-exec-Eintrag anzeigt und warnt, wenn der laufende Hintergrund-Service nicht damit übereinstimmt, oder führen Sie `claude daemon status` von einer Shell aus

1369* Nach dem Beheben des Werts im `env`-Block von [Einstellungen](/de/corporate-launcher#set-up-the-launcher) starten Sie den Hintergrund-Service mit `claude daemon stop --any` neu, damit die nächste Verteilung einen umschlossenen startet1369* Nach dem Beheben des Werts 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 die nächste Verteilung einen umschlossenen startet

1370 1370

1371<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">

1372 Konfigurationswarnungen1372 Konfigurationswarnungen

1378 Arbeitsbereich wurde nicht vertraut1378 Arbeitsbereich wurde nicht vertraut

1379</h3>1379</h3>

1380 1380

1381Claude Code fand `permissions.allow`-Regeln oder `permissions.additionalDirectories`-Einträge in der Datei `.claude/settings.json` oder `.claude/settings.local.json` des Projekts und wendete sie nicht an, da [Allow-Regeln aus Projekteinstellungen Arbeitsbereichsvertrauen erfordern](/de/permissions#project-allow-rules-and-workspace-trust). Die Anzahl, der Einstellungsname und die in der Meldung genannte Datei variieren je nach Ihrer Konfiguration. `deny`- und `ask`-Regeln sind nicht betroffen.1381Claude Code fand `permissions.allow`-Regeln oder `permissions.additionalDirectories`-Einträge in der Datei `.claude/settings.json` oder `.claude/settings.local.json` des Projekts und wendete sie nicht an, da [Allow-Regeln aus Projekteinstellungen Arbeitsbereichsvertrauen erfordern](/docs/de/permissions#project-allow-rules-and-workspace-trust). Die Anzahl, der Einstellungsname und die in der Meldung genannte Datei variieren je nach Ihrer Konfiguration. `deny`- und `ask`-Regeln sind nicht betroffen.

1382 1382

1383```text theme={null}1383```text theme={null}

1384Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.1384Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.

1386 1386

1387**Was zu tun ist:**1387**Was zu tun ist:**

1388 1388

1389* Führen Sie `claude` im Verzeichnis aus und akzeptieren Sie den Vertrauensdialog. {/* min-version: 2.1.200 */}Der Dialog wird angezeigt, auch wenn ein übergeordnetes Verzeichnis bereits vertraut ist, listet die zurückgehaltenen Regeln auf und ermöglicht es Ihnen, abzulehnen und ohne diese weiterzuarbeiten. Vor v2.1.200 wurde in dieser Situation kein Dialog angezeigt, daher konnte dieser Schritt dort nicht abgeschlossen werden.1389* Führen Sie `claude` im Verzeichnis aus und akzeptieren Sie den Vertrauensdialog. Der Dialog wird angezeigt, auch wenn ein übergeordnetes Verzeichnis bereits vertraut ist, listet die zurückgehaltenen Regeln auf und ermöglicht es Ihnen, abzulehnen und ohne diese weiterzuarbeiten. Vor v2.1.200 wurde in dieser Situation kein Dialog angezeigt, daher konnte dieser Schritt dort nicht abgeschlossen werden.

1390* Im [nicht-interaktiven Modus](/de/headless) mit `-p` wird kein Dialog angezeigt. Legen Sie den `hasTrustDialogAccepted`-Eintrag in `~/.claude.json` mit dem genauen `projects`-Schlüssel fest, den die Meldung ausgibt.1390* Im [nicht-interaktiven Modus](/docs/de/headless) mit `-p` wird kein Dialog angezeigt. Legen Sie den `hasTrustDialogAccepted`-Eintrag in `~/.claude.json` mit dem genauen `projects`-Schlüssel fest, den die Meldung ausgibt.

1391* {/* min-version: 2.1.200 */}Wenn die Meldung `.claude/settings.local.json` nennt und Sie Claude Code außerhalb eines Git-Repositorys oder in Ihrem Home-Verzeichnis gestartet haben, aktualisieren Sie auf v2.1.200 oder später. Die Versionen 2.1.196 bis 2.1.199 behandelten Ihre eigene `.claude/settings.local.json` in diesen Arbeitsbereichen als vom Repository bereitgestellt. {/* min-version: 2.1.207 */}Auf v2.1.207 und später ist eine Aktualisierung außerhalb eines Git-Repositorys nicht ausreichend, wenn Sie den Ordner nicht vertraut haben: Die Feststellung, dass sich ein Ordner nicht in einem Repository befindet, führt Git aus, und Claude Code führt diese Überprüfung nur durch, nachdem Sie den Vertrauensdialog akzeptiert haben. Verwenden Sie daher den ersten Schritt. Ihr Home-Verzeichnis und alle anderen [Konfigurationshome](/de/permissions#project-allow-rules-and-workspace-trust) sind ausgenommen und warten nicht auf den Dialog. Siehe [Projektallow-Regeln und Arbeitsbereichsvertrauen](/de/permissions#project-allow-rules-and-workspace-trust).1391* Wenn die Meldung `.claude/settings.local.json` nennt und Sie Claude Code außerhalb eines Git-Repositorys oder in Ihrem Home-Verzeichnis gestartet haben, aktualisieren Sie auf v2.1.200 oder später. Die Versionen 2.1.196 bis 2.1.199 behandelten Ihre eigene `.claude/settings.local.json` in diesen Arbeitsbereichen als vom Repository bereitgestellt. Auf v2.1.207 und später ist eine Aktualisierung außerhalb eines Git-Repositorys nicht ausreichend, wenn Sie den Ordner nicht vertraut haben: Die Feststellung, dass sich ein Ordner nicht in einem Repository befindet, führt Git aus, und Claude Code führt diese Überprüfung nur durch, nachdem Sie den Vertrauensdialog akzeptiert haben. Verwenden Sie daher den ersten Schritt. Ihr Home-Verzeichnis und alle anderen [Konfigurationshome](/docs/de/permissions#project-allow-rules-and-workspace-trust) sind ausgenommen und warten nicht auf den Dialog. Siehe [Projektallow-Regeln und Arbeitsbereichsvertrauen](/docs/de/permissions#project-allow-rules-and-workspace-trust).

1392 1392

1393<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">

1394 Antworten scheinen von geringerer Qualität als üblich1394 Antworten scheinen von geringerer Qualität als üblich

1396 1396

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

1398 1398

1399* Ein konfiguriertes [`--fallback-model`](/de/cli-reference#cli-flags) übernimmt nach einem Verfügbarkeitsfehler für diesen Zug nur mit einer Notiz im Transkript1399* Ein konfiguriertes [`--fallback-model`](/docs/de/cli-reference#cli-flags) übernimmt nach einem Verfügbarkeitsfehler für diesen Zug nur mit einer Notiz im Transkript

1400* Eine Amazon Bedrock oder Google Cloud Agent Platform Startprüfung stellt fest, dass Ihr Standardmodell nicht verfügbar ist1400* Eine Amazon Bedrock oder Google Cloud Agent Platform Startprüfung stellt fest, dass Ihr Standardmodell nicht verfügbar ist

1401* [Automatisches Modell-Fallback](/de/model-config#automatic-model-fallback) auf Fable 5 verschiebt die Sitzung zum Standard-Opus-Modell und zeigt eine Notiz im Transkript an1401* [Automatisches Modell-Fallback](/docs/de/model-config#automatic-model-fallback) auf Fable 5 verschiebt die Sitzung zum Standard-Opus-Modell und zeigt eine Notiz im Transkript an

1402 1402

1403Die Modellauswahlprüfung unten erfasst den zweiten und dritten Fall; der erste erscheint als Transkriptnotiz statt als `/model`-Änderung. [Modellkonfiguration](/de/model-config) erklärt, wann jedes Fallback angewendet wird.1403Die Modellauswahlprüfung unten erfasst den zweiten und dritten Fall; der erste erscheint als Transkriptnotiz statt als `/model`-Änderung. [Modellkonfiguration](/docs/de/model-config) erklärt, wann jedes Fallback angewendet wird.

1404 1404

1405Überprüfen Sie diese zuerst:1405Überprüfen Sie diese zuerst:

1406 1406

1407* **Modellauswahl**: Führen Sie `/model` aus, um zu bestätigen, dass Sie das erwartete Modell verwenden. Eine vorherige `/model`-Auswahl oder eine `ANTHROPIC_MODEL`-Umgebungsvariable kann Sie auf einem kleineren Modell als beabsichtigt platzieren.1407* **Modellauswahl**: Führen Sie `/model` aus, um zu bestätigen, dass Sie das erwartete Modell verwenden. Eine vorherige `/model`-Auswahl oder eine `ANTHROPIC_MODEL`-Umgebungsvariable kann Sie auf einem kleineren Modell als beabsichtigt platzieren.

1408* **Anstrengungsgrad**: Führen Sie `/effort` aus, um die aktuelle Reasoning-Stufe zu überprüfen und sie für schwieriges Debugging oder Design-Arbeit zu erhöhen. Die Standardwerte variieren je nach Modell, daher überprüfen Sie, bevor Sie davon ausgehen, dass Sie unter dem Maximum liegen. Siehe [Anstrengungsgrad anpassen](/de/model-config#adjust-effort-level) für modellspezifische Standardwerte und die `ultrathink`-Verknüpfung.1408* **Anstrengungsgrad**: Führen Sie `/effort` aus, um die aktuelle Reasoning-Stufe zu überprüfen und sie für schwieriges Debugging oder Design-Arbeit zu erhöhen. Die Standardwerte variieren je nach Modell, daher überprüfen Sie, bevor Sie davon ausgehen, dass Sie unter dem Maximum liegen. Siehe [Anstrengungsgrad anpassen](/docs/de/model-config#adjust-effort-level) für modellspezifische Standardwerte und die `ultrathink`-Verknüpfung.

1409* **Kontextdruck**: Führen Sie `/context` aus, um zu sehen, wie voll das Fenster ist. Wenn es sich der Kapazität nähert, führen Sie `/compact` an einem natürlichen Haltepunkt oder `/clear` aus, um neu zu beginnen. Siehe [Erkunden Sie das Kontextfenster](/de/context-window), um zu erfahren, wie Auto-Compact frühere Züge beeinflusst.1409* **Kontextdruck**: Führen Sie `/context` aus, um zu sehen, wie voll das Fenster ist. Wenn es sich der Kapazität nähert, führen Sie `/compact` an einem natürlichen Haltepunkt oder `/clear` aus, um neu zu beginnen. Siehe [Erkunden Sie das Kontextfenster](/docs/de/context-window), um zu erfahren, wie Auto-Compact frühere Züge beeinflusst.

1410* **Veraltete Anweisungen**: Große oder veraltete `CLAUDE.md`-Dateien und MCP-Tool-Definitionen verbrauchen Kontext und können Antworten lenken. {/* min-version: 2.1.205 */}Die `/doctor`-Überprüfung kennzeichnet übergroße Speicherdateien und ungenutzte Erweiterungen, und `/context` zeigt die MCP-Tool-Token-Nutzung an. Vor v2.1.205 öffnete `/doctor` einen Diagnose-Bildschirm, der übergroße Speicherdateien und Subagent-Definitionen kennzeichnete.1410* **Veraltete Anweisungen**: Große oder veraltete `CLAUDE.md`-Dateien und MCP-Tool-Definitionen verbrauchen Kontext und können Antworten lenken. Die `/doctor`-Überprüfung kennzeichnet übergroße Speicherdateien und ungenutzte Erweiterungen, und `/context` zeigt die MCP-Tool-Token-Nutzung an. Vor v2.1.205 öffnete `/doctor` einen Diagnose-Bildschirm, der übergroße Speicherdateien und Subagent-Definitionen kennzeichnete.

1411 1411

1412Wenn eine Antwort schiefgeht, funktioniert das Zurückspulen normalerweise besser als das Antworten mit Korrektionen. Drücken Sie zweimal Esc oder führen Sie `/rewind` aus, um vor den fehlerhaften Zug zurückzugehen, und formulieren Sie dann die Eingabeaufforderung mit mehr Spezifika um. Korrigieren im Thread behält den falschen Versuch im Kontext, was später Antworten daran verankern kann. Siehe [Checkpointing](/de/checkpointing).1412Wenn eine Antwort schiefgeht, funktioniert das Zurückspulen normalerweise besser als das Antworten mit Korrektionen. Drücken Sie zweimal Esc oder führen Sie `/rewind` aus, um vor den fehlerhaften Zug zurückzugehen, und formulieren Sie dann die Eingabeaufforderung mit mehr Spezifika um. Korrigieren im Thread behält den falschen Versuch im Kontext, was später Antworten daran verankern kann. Siehe [Checkpointing](/docs/de/checkpointing).

1413 1413

1414Wenn die Qualität nach Überprüfung der obigen Punkte immer noch schlecht erscheint, führen Sie `/feedback` aus und beschreiben Sie, was Sie erwartet haben im Vergleich zu dem, was Sie erhalten haben. Auf diese Weise eingereichte Rückmeldungen enthalten das Gesprächstranskript, das die schnellste Möglichkeit für Anthropic ist, eine echte Regression zu diagnostizieren. Siehe [Fehler melden](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist.1414Wenn die Qualität nach Überprüfung der obigen Punkte immer noch schlecht erscheint, führen Sie `/feedback` aus und beschreiben Sie, was Sie erwartet haben im Vergleich zu dem, was Sie erhalten haben. Auf diese Weise eingereichte Rückmeldungen enthalten das Gesprächstranskript, das die schnellste Möglichkeit für Anthropic ist, eine echte Regression zu diagnostizieren. Siehe [Fehler melden](#report-an-error), wenn `/feedback` in Ihrer Umgebung nicht verfügbar ist.

1415 1415

1416Wenn Claude vor einer vermuteten Prompt-Injection warnt oder eine Anfrage wegen einer vermuteten Injection ablehnt, und der Text, den die Warnung benennt, Kontext ist, den Claude Code automatisch zum Gespräch hinzufügt, anstatt Datei- oder Webinhalte, führen Sie `claude update` aus und versuchen Sie es erneut. Wenn die Warnung nach dem Update wiederholt wird, [melden Sie es](#report-an-error), anstatt den gekennzeichneten Inhalt zurück in die Eingabeaufforderung einzufügen. {/* min-version: 2.1.201 */}Vor v2.1.201 lehnten Sonnet 5 einige Anfragen auf die gleiche Weise ab.1416Wenn Claude vor einer vermuteten Prompt-Injection warnt oder eine Anfrage wegen einer vermuteten Injection ablehnt, und der Text, den die Warnung benennt, Kontext ist, den Claude Code automatisch zum Gespräch hinzufügt, anstatt Datei- oder Webinhalte, führen Sie `claude update` aus und versuchen Sie es erneut. Wenn die Warnung nach dem Update wiederholt wird, [melden Sie es](#report-an-error), anstatt den gekennzeichneten Inhalt zurück in die Eingabeaufforderung einzufügen. Vor v2.1.201 lehnten Sonnet 5 einige Anfragen auf die gleiche Weise ab.

1417 1417

1418<h2 id="report-an-error">1418<h2 id="report-an-error">

1419 Fehler melden1419 Fehler melden

1421 1421

1422Für Fehler von Komponenten, die auf dieser Seite nicht behandelt werden, siehe die relevanten Anleitungen:1422Für Fehler von Komponenten, die auf dieser Seite nicht behandelt werden, siehe die relevanten Anleitungen:

1423 1423

1424* MCP-Server konnte sich nicht verbinden oder authentifizieren: [MCP](/de/mcp)1424* MCP-Server konnte sich nicht verbinden oder authentifizieren: [MCP](/docs/de/mcp)

1425* Hook-Skript ist fehlgeschlagen oder hat ein Tool blockiert: [Debug-Hooks](/de/hooks#debug-hooks)1425* Hook-Skript ist fehlgeschlagen oder hat ein Tool blockiert: [Debug-Hooks](/docs/de/hooks#debug-hooks)

1426* Berechtigung verweigert oder Dateisystemfehler während der Installation: [Troubleshoot-Installation und -Anmeldung](/de/troubleshoot-install)1426* Berechtigung verweigert oder Dateisystemfehler während der Installation: [Troubleshoot-Installation und -Anmeldung](/docs/de/troubleshoot-install)

1427 1427

1428Wenn ein Fehler hier nicht aufgeführt ist oder die vorgeschlagene Lösung nicht hilft:1428Wenn ein Fehler hier nicht aufgeführt ist oder die vorgeschlagene Lösung nicht hilft:

1429 1429

1430* Führen Sie `/feedback` in Claude Code aus, um das Transkript und eine Beschreibung an Anthropic zu senden. Der Befehl bietet auch an, ein vorausgefülltes GitHub-Issue zu öffnen. Das Senden an Anthropic erfordert [Authentifizierung](/de/authentication). Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und anderen Drittanbieter-Plattformen oder wenn keine Anthropic-Anmeldedaten konfiguriert sind, speichert `/feedback` ein lokales Archiv, das Sie stattdessen an Ihren Anthropic-Kontorepräsentanten senden können.1430* Führen Sie `/feedback` in Claude Code aus, um das Transkript und eine Beschreibung an Anthropic zu senden. Der Befehl bietet auch an, ein vorausgefülltes GitHub-Issue zu öffnen. Das Senden an Anthropic erfordert [Authentifizierung](/docs/de/authentication). Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und anderen Drittanbieter-Plattformen oder wenn keine Anthropic-Anmeldedaten konfiguriert sind, speichert `/feedback` ein lokales Archiv, das Sie stattdessen an Ihren Anthropic-Kontorepräsentanten senden können.

1431* Führen Sie `claude doctor` aus Ihrer Shell aus, um eine schreibgeschützte Diagnose Ihrer Installation zu erhalten, oder führen Sie die `/doctor`-Überprüfung in Claude Code aus, um Setup-Probleme zu finden und zu beheben1431* Führen Sie `claude doctor` aus Ihrer Shell aus, um eine schreibgeschützte Diagnose Ihrer Installation zu erhalten, oder führen Sie die `/doctor`-Überprüfung in Claude Code aus, um Setup-Probleme zu finden und zu beheben

1432* Überprüfen Sie [status.claude.com](https://status.claude.com) auf aktive Vorfälle1432* Überprüfen Sie [status.claude.com](https://status.claude.com) auf aktive Vorfälle

1433* Suchen Sie nach [bestehenden Issues](https://github.com/anthropics/claude-code/issues) auf GitHub1433* Suchen Sie nach [bestehenden Issues](https://github.com/anthropics/claude-code/issues) auf GitHub

fast-mode.md +11 −11

Details

32Aktivieren Sie den Schnellmodus auf eine dieser Weisen:32Aktivieren Sie den Schnellmodus auf eine dieser Weisen:

33 33

34* Geben Sie `/fast` ein und drücken Sie Tab, um ihn ein- oder auszuschalten34* Geben Sie `/fast` ein und drücken Sie Tab, um ihn ein- oder auszuschalten

~~35* Setzen Sie `"fastMode": true` in Ihrer [Benutzereinstellungsdatei](/de/settings)~~35* Setzen Sie `"fastMode": true` in Ihrer [Benutzereinstellungsdatei](/docs/de/settings)

36 36

37Standardmäßig bleibt der Schnellmodus, den Sie in einer interaktiven Sitzung aktivieren, über Sitzungen hinweg erhalten. {/* min-version: 2.1.205 */}Im [nicht-interaktiven Modus](/de/headless) mit dem `-p`-Flag funktioniert `/fast` nur in einer Sitzung, die mit dem Schnellmodus in ihrem [`--settings`](/de/cli-reference#cli-flags)-Wert gestartet wurde, zum Beispiel `claude -p --settings '{"fastMode": true}'`; der Toggle gilt dann nur für diese Sitzung und wird nicht als Ihr Standard gespeichert, und in jeder anderen nicht-interaktiven Sitzung meldet der Befehl, dass der Schnellmodus nicht verfügbar ist. Sie können den Schnellmodus so konfigurieren, dass er sich bei jeder Sitzung zurückgesetzt wird. Weitere Informationen finden Sie unter [Opt-in pro Sitzung erforderlich](#require-per-session-opt-in).37Standardmäßig bleibt der Schnellmodus, den Sie in einer interaktiven Sitzung aktivieren, über Sitzungen hinweg erhalten. Im [nicht-interaktiven Modus](/docs/de/headless) mit dem `-p`-Flag funktioniert `/fast` nur in einer Sitzung, die mit dem Schnellmodus in ihrem [`--settings`](/docs/de/cli-reference#cli-flags)-Wert gestartet wurde, zum Beispiel `claude -p --settings '{"fastMode": true}'`; der Toggle gilt dann nur für diese Sitzung und wird nicht als Ihr Standard gespeichert, und in jeder anderen nicht-interaktiven Sitzung meldet der Befehl, dass der Schnellmodus nicht verfügbar ist. Sie können den Schnellmodus so konfigurieren, dass er sich bei jeder Sitzung zurückgesetzt wird. Weitere Informationen finden Sie unter [Opt-in pro Sitzung erforderlich](#require-per-session-opt-in).

38 38

39Für die beste Kosteneffizienz aktivieren Sie den Schnellmodus am Anfang einer Sitzung, anstatt ihn mitten in einem Gespräch zu wechseln. Weitere Informationen finden Sie unter [Kostenabwägung verstehen](#understand-the-cost-tradeoff).39Für die beste Kosteneffizienz aktivieren Sie den Schnellmodus am Anfang einer Sitzung, anstatt ihn mitten in einem Gespräch zu wechseln. Weitere Informationen finden Sie unter [Kostenabwägung verstehen](#understand-the-cost-tradeoff).

40 40

47 47

48Wenn Sie den Schnellmodus mit `/fast` erneut deaktivieren, bleiben Sie auf Opus. Das Modell wird nicht auf Ihr vorheriges Modell zurückgesetzt. Um zu einem anderen Modell zu wechseln, verwenden Sie `/model`.48Wenn Sie den Schnellmodus mit `/fast` erneut deaktivieren, bleiben Sie auf Opus. Das Modell wird nicht auf Ihr vorheriges Modell zurückgesetzt. Um zu einem anderen Modell zu wechseln, verwenden Sie `/model`.

49 49

50Wenn Sie zu einem Modell wechseln, das den Schnellmodus nicht unterstützt, wird der Schnellmodus deaktiviert. {/* min-version: 2.1.208 */}Wenn Sie zu einem unterstützten Opus-Modell zurückwechseln, wird es wieder aktiviert, wenn Ihre gespeicherte Schnellmodus-Einstellung aktiviert ist, die gleiche Einstellung, mit der eine neue Sitzung standardmäßig beginnt. Mit [Opt-in pro Sitzung](#require-per-session-opt-in) konfiguriert, wird der Schnellmodus beim Zurückwechseln nicht wieder aktiviert; führen Sie `/fast` aus, um ihn erneut zu aktivieren. Der Schnellmodus wird niemals für eine Sitzung aktiviert, deren gespeicherte Einstellung deaktiviert ist, und das `↯`-Symbol und die Bestätigung „Fast mode ON" werden angezeigt, wenn er aktiviert wird. Vor v2.1.208 blieb der Schnellmodus deaktiviert, nachdem Sie zurückgewechselt hatten, bis Sie `/fast` erneut ausführten.50Wenn Sie zu einem Modell wechseln, das den Schnellmodus nicht unterstützt, wird der Schnellmodus deaktiviert. Wenn Sie zu einem unterstützten Opus-Modell zurückwechseln, wird es wieder aktiviert, wenn Ihre gespeicherte Schnellmodus-Einstellung aktiviert ist, die gleiche Einstellung, mit der eine neue Sitzung standardmäßig beginnt. Mit [Opt-in pro Sitzung](#require-per-session-opt-in) konfiguriert, wird der Schnellmodus beim Zurückwechseln nicht wieder aktiviert; führen Sie `/fast` aus, um ihn erneut zu aktivieren. Der Schnellmodus wird niemals für eine Sitzung aktiviert, deren gespeicherte Einstellung deaktiviert ist, und das `↯`-Symbol und die Bestätigung „Fast mode ON" werden angezeigt, wenn er aktiviert wird. Vor v2.1.208 blieb der Schnellmodus deaktiviert, nachdem Sie zurückgewechselt hatten, bis Sie `/fast` erneut ausführten.

51 51

52Opus 4.8 ist der Standard für den Schnellmodus in Claude Code v2.1.154 und später. In v2.1.142 bis v2.1.153 wird der Schnellmodus standardmäßig auf Opus 4.7 gesetzt.52Opus 4.8 ist der Standard für den Schnellmodus in Claude Code v2.1.154 und später. In v2.1.142 bis v2.1.153 wird der Schnellmodus standardmäßig auf Opus 4.7 gesetzt.

53 53

64 64

65Die Preisgestaltung für den Schnellmodus ist über das gesamte 1M-Token-Kontextfenster einheitlich. Für den Standard-Opus-Satz zum Vergleich siehe die [Claude-Preisreferenz](https://platform.claude.com/docs/de/about-claude/pricing).65Die Preisgestaltung für den Schnellmodus ist über das gesamte 1M-Token-Kontextfenster einheitlich. Für den Standard-Opus-Satz zum Vergleich siehe die [Claude-Preisreferenz](https://platform.claude.com/docs/de/about-claude/pricing).

66 66

67Wenn Sie den Schnellmodus zum ersten Mal in einem Gespräch aktivieren, zahlen Sie den vollständigen Schnellmodus-Preis für nicht zwischengespeicherte Eingabe-Token für den gesamten Gesprächskontext. Je tiefer Sie sich in einem Gespräch befinden, desto mehr kostet dies, daher ist die Aktivierung des Schnellmodus von Anfang an günstiger. Die Kosten fallen einmal pro Gespräch an, daher führt das spätere Ausschalten und erneute Einschalten des Schnellmodus nicht zu einer Wiederholung. Für den Mechanismus siehe [wie der Schnellmodus mit dem Prompt-Cache interagiert](/de/prompt-caching#turning-on-fast-mode).67Wenn Sie den Schnellmodus zum ersten Mal in einem Gespräch aktivieren, zahlen Sie den vollständigen Schnellmodus-Preis für nicht zwischengespeicherte Eingabe-Token für den gesamten Gesprächskontext. Je tiefer Sie sich in einem Gespräch befinden, desto mehr kostet dies, daher ist die Aktivierung des Schnellmodus von Anfang an günstiger. Die Kosten fallen einmal pro Gespräch an, daher führt das spätere Ausschalten und erneute Einschalten des Schnellmodus nicht zu einer Wiederholung. Für den Mechanismus siehe [wie der Schnellmodus mit dem Prompt-Cache interagiert](/docs/de/prompt-caching#turning-on-fast-mode).

68 68

69<h2 id="decide-when-to-use-fast-mode">69<h2 id="decide-when-to-use-fast-mode">

70 Entscheiden Sie, wann Sie den Schnellmodus verwenden70 Entscheiden Sie, wann Sie den Schnellmodus verwenden

93| **Schnellmodus** | Gleiche Modellqualität, niedrigere Latenz, höhere Kosten |93| **Schnellmodus** | Gleiche Modellqualität, niedrigere Latenz, höhere Kosten |

94| **Niedrigere Anstrengungsstufe** | Weniger Denkzeit, schnellere Antworten, möglicherweise niedrigere Qualität bei komplexen Aufgaben |94| **Niedrigere Anstrengungsstufe** | Weniger Denkzeit, schnellere Antworten, möglicherweise niedrigere Qualität bei komplexen Aufgaben |

95 95

~~96Sie können beide kombinieren: Verwenden Sie den Schnellmodus mit einer niedrigeren [Anstrengungsstufe](/de/model-config#adjust-effort-level) für maximale Geschwindigkeit bei einfachen Aufgaben.~~96Sie können beide kombinieren: Verwenden Sie den Schnellmodus mit einer niedrigeren [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) für maximale Geschwindigkeit bei einfachen Aufgaben.

97 97

98<h2 id="requirements">98<h2 id="requirements">

99 Anforderungen99 Anforderungen

111* **Owner-Aktivierung für Teams und Enterprise**: Der Schnellmodus ist standardmäßig für Teams- und Enterprise-Organisationen deaktiviert. Ein Owner muss den Schnellmodus explizit [aktivieren](#enable-fast-mode-for-your-organization), bevor Benutzer darauf zugreifen können.111* **Owner-Aktivierung für Teams und Enterprise**: Der Schnellmodus ist standardmäßig für Teams- und Enterprise-Organisationen deaktiviert. Ein Owner muss den Schnellmodus explizit [aktivieren](#enable-fast-mode-for-your-organization), bevor Benutzer darauf zugreifen können.

112 112

113<Note>113<Note>

114 Wenn der Schnellmodus für Ihre Organisation nicht aktiviert wurde, zeigt der Befehl `/fast` „Fast mode has been disabled by your organization." an. Wenn die [`availableModels`](/de/model-config#restrict-model-selection)-Zulassungsliste Ihrer Organisation das Schnellmodus-Opus-Modell ausschließt, wird `/fast` mit „is not in your organization's allowed models" abgelehnt. Die Ausnahme ist eine Sitzung, die bereits auf einem zulässigen Opus-Modell ausgeführt wird, das den Schnellmodus unterstützt: `/fast` aktiviert den Schnellmodus auf Ihrem aktuellen Modell, anstatt Modelle zu wechseln.114 Wenn der Schnellmodus für Ihre Organisation nicht aktiviert wurde, zeigt der Befehl `/fast` „Fast mode has been disabled by your organization." an. Wenn die [`availableModels`](/docs/de/model-config#restrict-model-selection)-Zulassungsliste Ihrer Organisation das Schnellmodus-Opus-Modell ausschließt, wird `/fast` mit „is not in your organization's allowed models" abgelehnt. Die Ausnahme ist eine Sitzung, die bereits auf einem zulässigen Opus-Modell ausgeführt wird, das den Schnellmodus unterstützt: `/fast` aktiviert den Schnellmodus auf Ihrem aktuellen Modell, anstatt Modelle zu wechseln.

115</Note>115</Note>

116 116

117<h3 id="enable-fast-mode-for-your-organization">117<h3 id="enable-fast-mode-for-your-organization">

123* **Console** (API-Kunden): Ein Administrator aktiviert ihn in [Claude Code-Einstellungen](https://platform.claude.com/claude-code/preferences)123* **Console** (API-Kunden): Ein Administrator aktiviert ihn in [Claude Code-Einstellungen](https://platform.claude.com/claude-code/preferences)

124* **Claude AI** (Teams und Enterprise): Ein Owner aktiviert ihn unter [Admin-Einstellungen > Claude Code](https://claude.ai/admin-settings/claude-code)124* **Claude AI** (Teams und Enterprise): Ein Owner aktiviert ihn unter [Admin-Einstellungen > Claude Code](https://claude.ai/admin-settings/claude-code)

125 125

126Eine weitere Option zum vollständigen Deaktivieren des Schnellmodus ist das Setzen von `CLAUDE_CODE_DISABLE_FAST_MODE=1`. Siehe [Umgebungsvariablen](/de/env-vars).126Eine weitere Option zum vollständigen Deaktivieren des Schnellmodus ist das Setzen von `CLAUDE_CODE_DISABLE_FAST_MODE=1`. Siehe [Umgebungsvariablen](/docs/de/env-vars).

127 127

128<h3 id="require-per-session-opt-in">128<h3 id="require-per-session-opt-in">

129 Opt-in pro Sitzung erforderlich129 Opt-in pro Sitzung erforderlich

130</h3>130</h3>

131 131

132Standardmäßig bleibt der Schnellmodus, den ein Benutzer in einer interaktiven Sitzung aktiviert, über Sitzungen hinweg erhalten: Er bleibt in zukünftigen Sitzungen aktiviert. Um dies zu ändern, setzen Sie `fastModePerSessionOptIn` in einer beliebigen [Einstellungsdatei](/de/settings#settings-files) auf `true`, was dazu führt, dass jede Sitzung mit deaktiviertem Schnellmodus beginnt und Benutzer ihn explizit mit `/fast` aktivieren müssen. Owners in [Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise)- oder [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise)-Plänen können dies organisationsweit über [servergesteuerte Einstellungen](/de/server-managed-settings) bereitstellen.132Standardmäßig bleibt der Schnellmodus, den ein Benutzer in einer interaktiven Sitzung aktiviert, über Sitzungen hinweg erhalten: Er bleibt in zukünftigen Sitzungen aktiviert. Um dies zu ändern, setzen Sie `fastModePerSessionOptIn` in einer beliebigen [Einstellungsdatei](/docs/de/settings#settings-files) auf `true`, was dazu führt, dass jede Sitzung mit deaktiviertem Schnellmodus beginnt und Benutzer ihn explizit mit `/fast` aktivieren müssen. Owners in [Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise)- oder [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise)-Plänen können dies organisationsweit über [servergesteuerte Einstellungen](/docs/de/server-managed-settings) bereitstellen.

133 133

134```json theme={null}134```json theme={null}

135{135{

168 Siehe auch168 Siehe auch

169</h2>169</h2>

170 170

171* [Modellkonfiguration](/de/model-config): Wechseln Sie Modelle und passen Sie Anstrengungsstufen an171* [Modellkonfiguration](/docs/de/model-config): Wechseln Sie Modelle und passen Sie Anstrengungsstufen an

172* [Kosten effektiv verwalten](/de/costs): Verfolgen Sie die Token-Nutzung und reduzieren Sie Kosten172* [Kosten effektiv verwalten](/docs/de/costs): Verfolgen Sie die Token-Nutzung und reduzieren Sie Kosten

173* [Statuszeilen-Konfiguration](/de/statusline): Zeigen Sie Modell- und Kontextinformationen an173* [Statuszeilen-Konfiguration](/docs/de/statusline): Zeigen Sie Modell- und Kontextinformationen an

feature-availability.md +79 −79

Details

6 6

7> Vergleichen Sie, welche Claude Code-Funktionen in Anthropic-Abonnementplänen, der Anthropic Console, Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry verfügbar sind.7> Vergleichen Sie, welche Claude Code-Funktionen in Anthropic-Abonnementplänen, der Anthropic Console, Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry verfügbar sind.

8 8

9Die Claude Code CLI und alles, was lokal ausgeführt wird, funktioniert auf jedem Anbieter identisch. Anweisungen zur Einrichtung pro Anbieter finden Sie in der [Übersicht zur Enterprise-Bereitstellung](/de/third-party-integrations). Um direkt zu sehen, was auf Ihrem Anbieter fehlt, siehe die Registerkarten [Zusammenfassung nach Anbieter](#summary-by-provider).9Die Claude Code CLI und alles, was lokal ausgeführt wird, funktioniert auf jedem Anbieter identisch. Anweisungen zur Einrichtung pro Anbieter finden Sie in der [Übersicht zur Enterprise-Bereitstellung](/docs/de/third-party-integrations). Um direkt zu sehen, was auf Ihrem Anbieter fehlt, siehe die Registerkarten [Zusammenfassung nach Anbieter](#summary-by-provider).

10 10

11In den Tabellen unten bedeutet ✓ verfügbar, ✗ nicht verfügbar, und „Siehe Hinweis" verlinkt auf eine Fußnote für teilweise Unterstützung. Ein Qualifizierer nach ✓ grenzt die Verfügbarkeit auf diese Teilmenge ein, und „Admin-aktiviert" bedeutet, dass die Funktion deaktiviert ist, bis ein Organisations-Admin sie aktiviert.11In den Tabellen unten bedeutet ✓ verfügbar, ✗ nicht verfügbar, und „Siehe Hinweis" verlinkt auf eine Fußnote für teilweise Unterstützung. Ein Qualifizierer nach ✓ grenzt die Verfügbarkeit auf diese Teilmenge ein, und „Admin-aktiviert" bedeutet, dass die Funktion deaktiviert ist, bis ein Organisations-Admin sie aktiviert.

12 12

18 18

19* **Claude-Abonnement**: Sie melden sich mit einem claude.ai-Konto im Pro-, Max-, Team- oder Enterprise-Plan an19* **Claude-Abonnement**: Sie melden sich mit einem claude.ai-Konto im Pro-, Max-, Team- oder Enterprise-Plan an

20* **Anthropic Console**: Sie authentifizieren sich mit einem Anthropic API-Schlüssel20* **Anthropic Console**: Sie authentifizieren sich mit einem Anthropic API-Schlüssel

21* **Amazon Bedrock**: Sie verwenden Claude-Modelle aus dem Amazon Bedrock-Modellkatalog und setzen `CLAUDE_CODE_USE_BEDROCK`. Der [Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) wird von dieser Spalte abgedeckt21* **Amazon Bedrock**: Sie verwenden Claude-Modelle aus dem Amazon Bedrock-Modellkatalog und setzen `CLAUDE_CODE_USE_BEDROCK`. Der [Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) wird von dieser Spalte abgedeckt

22* **Claude Platform on AWS**: Sie haben Claude über AWS Marketplace gekauft, rufen aber die Anthropic API auf und setzen `CLAUDE_CODE_USE_ANTHROPIC_AWS`22* **Claude Platform on AWS**: Sie haben Claude über AWS Marketplace gekauft, rufen aber die Anthropic API auf und setzen `CLAUDE_CODE_USE_ANTHROPIC_AWS`

23* **Google Cloud's Agent Platform**: Von Google betrieben; Sie setzen `CLAUDE_CODE_USE_VERTEX`23* **Google Cloud's Agent Platform**: Von Google betrieben; Sie setzen `CLAUDE_CODE_USE_VERTEX`

24* **Microsoft Foundry**: Von Anthropic auf Azure betrieben; Sie setzen `CLAUDE_CODE_USE_FOUNDRY`24* **Microsoft Foundry**: Von Anthropic auf Azure betrieben; Sie setzen `CLAUDE_CODE_USE_FOUNDRY`

29 29

30Diese funktionieren auf jedem Anbieter:30Diese funktionieren auf jedem Anbieter:

31 31

~~32* [CLI](/de/quickstart) und [Agent SDK](/de/agent-sdk/overview)~~32* [CLI](/docs/de/quickstart) und [Agent SDK](/docs/de/agent-sdk/overview)

~~33* [VS Code](/de/vs-code) und [JetBrains](/de/jetbrains) Erweiterungen~~33* [VS Code](/docs/de/vs-code) und [JetBrains](/docs/de/jetbrains) Erweiterungen

~~34* [Subagents](/de/sub-agents), [hooks](/de/hooks-guide), [commands](/de/commands) und [skills](/de/skills)~~34* [Subagents](/docs/de/sub-agents), [hooks](/docs/de/hooks-guide), [commands](/docs/de/commands) und [skills](/docs/de/skills)

~~35* [CLAUDE.md memory](/de/memory), [plugins](/de/plugins) und [MCP servers](/de/mcp)~~35* [CLAUDE.md memory](/docs/de/memory), [plugins](/docs/de/plugins) und [MCP servers](/docs/de/mcp)

~~36* [Checkpoints](/de/checkpointing), [sandboxing](/de/sandboxing) und [Workflows](/de/workflows)~~36* [Checkpoints](/docs/de/checkpointing), [sandboxing](/docs/de/sandboxing) und [Workflows](/docs/de/workflows)

~~37* [OpenTelemetry metrics](/de/monitoring-usage) und die [verwaltete Einstellungsdatei](/de/settings#settings-files)~~37* [OpenTelemetry metrics](/docs/de/monitoring-usage) und die [verwaltete Einstellungsdatei](/docs/de/settings#settings-files)

38 38

39Drei davon haben anbieter-spezifische Unterschiede:39Drei davon haben anbieter-spezifische Unterschiede:

40 40

41* **MCP servers**: [Konnektoren von claude.ai](/de/mcp#use-mcp-servers-from-claude-ai) werden nur geladen, wenn Ihr claude.ai-Abonnement die aktive Authentifizierungsmethode ist, und [Tool-Suche](/de/mcp#configure-tool-search) ist standardmäßig auf Google Cloud's Agent Platform und deaktiviert, wenn `ANTHROPIC_BASE_URL` auf einen Nicht-First-Party-Host verweist41* **MCP servers**: [Konnektoren von claude.ai](/docs/de/mcp#use-mcp-servers-from-claude-ai) werden nur geladen, wenn Ihr claude.ai-Abonnement die aktive Authentifizierungsmethode ist, und [Tool-Suche](/docs/de/mcp#configure-tool-search) ist standardmäßig auf Google Cloud's Agent Platform und deaktiviert, wenn `ANTHROPIC_BASE_URL` auf einen Nicht-First-Party-Host verweist

42* **Subagents**: der integrierte [Explore Subagent](/de/sub-agents#built-in-subagents) begrenzt sein vererbtes Modell auf Opus auf der Claude API und erbt das Modell der Hauptkonversation direkt auf jedem anderen Anbieter, einschließlich Claude Platform on AWS42* **Subagents**: der integrierte [Explore Subagent](/docs/de/sub-agents#built-in-subagents) begrenzt sein vererbtes Modell auf Opus auf der Claude API und erbt das Modell der Hauptkonversation direkt auf jedem anderen Anbieter, einschließlich Claude Platform on AWS

43* **[Commands](/de/commands#all-commands)**: `/design-sync` und `/radio` sind auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS nicht verfügbar, und `/voice` erfordert ein claude.ai-Konto43* **[Commands](/docs/de/commands#all-commands)**: `/design-sync` und `/radio` sind auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS nicht verfügbar, und `/voice` erfordert ein claude.ai-Konto

44 44

45<h3 id="features-that-require-a-claude-subscription">45<h3 id="features-that-require-a-claude-subscription">

46 Funktionen, die ein Claude-Abonnement erfordern46 Funktionen, die ein Claude-Abonnement erfordern

48 48

49Diese erfordern die Anmeldung mit einem claude.ai-Konto und sind nicht mit einem Anthropic Console API-Schlüssel oder von einem Drittanbieter erreichbar:49Diese erfordern die Anmeldung mit einem claude.ai-Konto und sind nicht mit einem Anthropic Console API-Schlüssel oder von einem Drittanbieter erreichbar:

50 50

~~51* [Claude Code im Web](/de/claude-code-on-the-web), Claude Code auf Mobilgeräten und [Claude Code in Slack](/de/slack)~~51* [Claude Code im Web](/docs/de/claude-code-on-the-web), Claude Code auf Mobilgeräten und [Claude Code in Slack](/docs/de/slack)

~~52* [Claude Code Desktop](/de/desktop)~~52* [Claude Code Desktop](/docs/de/desktop)

~~53* [Routines](/de/routines) (`/schedule`)~~53* [Routines](/docs/de/routines) (`/schedule`)

~~54* [Ultraplan](/de/ultraplan) und [Ultrareview](/de/ultrareview)~~54* [Ultraplan](/docs/de/ultraplan) und [Ultrareview](/docs/de/ultrareview)

~~55* [Code Review](/de/code-review): Team- und Enterprise-Pläne~~55* [Code Review](/docs/de/code-review): Team- und Enterprise-Pläne

~~56* [Remote Control](/de/remote-control)~~56* [Remote Control](/docs/de/remote-control)

~~57* [Chrome-Erweiterung](/de/chrome)~~57* [Chrome-Erweiterung](/docs/de/chrome)

~~58* [Computer use](/de/computer-use): Pro- und Max-Pläne~~58* [Computer use](/docs/de/computer-use): Pro- und Max-Pläne

~~59* [Artifacts](/de/artifacts): Pro-, Max-, Team- und Enterprise-Pläne~~59* [Artifacts](/docs/de/artifacts): Pro-, Max-, Team- und Enterprise-Pläne

~~60* [Voice dictation](/de/voice-dictation)~~60* [Voice dictation](/docs/de/voice-dictation)

61 61

62Desktop ist die teilweise Ausnahme: [Gateway-Routing kann in der App oder von einem Administrator konfiguriert werden](/de/llm-gateway-connect#desktop-app), Enterprise-Bereitstellungen können Desktop über [verwaltete Einstellungen](https://claude.com/docs/third-party/claude-desktop/configuration) an Google Cloud's Agent Platform oder einen Gateway-Anbieter weiterleiten, und [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) führt die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway aus. Für die Verfügbarkeit dieser Funktionen pro Plan siehe [Verfügbarkeit nach Abonnementplan](#availability-by-subscription-plan).62Desktop ist die teilweise Ausnahme: [Gateway-Routing kann in der App oder von einem Administrator konfiguriert werden](/docs/de/llm-gateway-connect#desktop-app), Enterprise-Bereitstellungen können Desktop über [verwaltete Einstellungen](https://claude.com/docs/third-party/claude-desktop/configuration) an Google Cloud's Agent Platform oder einen Gateway-Anbieter weiterleiten, und [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) führt die Code-Registerkarte auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder einem selbstgehosteten LLM-Gateway aus. Für die Verfügbarkeit dieser Funktionen pro Plan siehe [Verfügbarkeit nach Abonnementplan](#availability-by-subscription-plan).

63 63

64<h3 id="cli-capabilities-that-vary-by-provider">64<h3 id="cli-capabilities-that-vary-by-provider">

65 CLI-Funktionen, die je nach Anbieter unterschiedlich sind65 CLI-Funktionen, die je nach Anbieter unterschiedlich sind

82 82

83 <tbody>83 <tbody>

84 <tr>84 <tr>

~~85 <td>[Web search](/de/tools-reference#websearch-tool-behavior)</td>~~85 <td>[Web search](/docs/de/tools-reference#websearch-tool-behavior)</td>

86 <td>✓</td>86 <td>✓</td>

87 <td>✓</td>87 <td>✓</td>

88 <td>✗</td>88 <td>✗</td>

92 </tr>92 </tr>

93 93

94 <tr>94 <tr>

~~95 <td>[Fast mode](/de/fast-mode)</td>~~95 <td>[Fast mode](/docs/de/fast-mode)</td>

96 <td>✓</td>96 <td>✓</td>

97 <td>✓</td>97 <td>✓</td>

98 <td>✗</td>98 <td>✗</td>

102 </tr>102 </tr>

103 103

104 <tr>104 <tr>

105 <td>[Auto mode](/de/auto-mode-config)</td>105 <td>[Auto mode](/docs/de/auto-mode-config)</td>

106 <td>✓</td>106 <td>✓</td>

107 <td>✓</td>107 <td>✓</td>

108 <td>Siehe Hinweis <sup><a href="#fn2">2</a></sup></td>108 <td>Siehe Hinweis <sup><a href="#fn2">2</a></sup></td>

112 </tr>112 </tr>

113 113

114 <tr>114 <tr>

115 <td>[Advisor](/de/advisor)</td>115 <td>[Advisor](/docs/de/advisor)</td>

116 <td>✓</td>116 <td>✓</td>

117 <td>✓</td>117 <td>✓</td>

118 <td>✗</td>118 <td>✗</td>

122 </tr>122 </tr>

123 123

124 <tr>124 <tr>

125 <td>[Channels](/de/channels)</td>125 <td>[Channels](/docs/de/channels)</td>

126 <td>✓</td>126 <td>✓</td>

127 <td>✓</td>127 <td>✓</td>

128 <td>✗</td>128 <td>✗</td>

132 </tr>132 </tr>

133 133

134 <tr>134 <tr>

135 <td>[`/loop` scheduled tasks](/de/scheduled-tasks)</td>135 <td>[`/loop` scheduled tasks](/docs/de/scheduled-tasks)</td>

136 <td>✓</td>136 <td>✓</td>

137 <td>✓</td>137 <td>✓</td>

138 <td>Siehe Hinweis <sup><a href="#fn3">3</a></sup></td>138 <td>Siehe Hinweis <sup><a href="#fn3">3</a></sup></td>

142 </tr>142 </tr>

143 143

144 <tr>144 <tr>

145 <td>[GitHub Actions](/de/github-actions) und [GitLab CI/CD](/de/gitlab-ci-cd)</td>145 <td>[GitHub Actions](/docs/de/github-actions) und [GitLab CI/CD](/docs/de/gitlab-ci-cd)</td>

146 <td>✓</td>146 <td>✓</td>

147 <td>✓</td>147 <td>✓</td>

148 <td>✓</td>148 <td>✓</td>

174 174

175 <tbody>175 <tbody>

176 <tr>176 <tr>

177 <td>[Analytics dashboard and API](/de/analytics)</td>177 <td>[Analytics dashboard and API](/docs/de/analytics)</td>

178 <td>✓ (Dashboard: Team und Enterprise; API: Enterprise)</td>178 <td>✓ (Dashboard: Team und Enterprise; API: Enterprise)</td>

179 <td>✓ <sup><a href="#fn5">5</a></sup></td>179 <td>✓ <sup><a href="#fn5">5</a></sup></td>

180 <td>✗</td>180 <td>✗</td>

184 </tr>184 </tr>

185 185

186 <tr>186 <tr>

187 <td>[Server-managed settings](/de/server-managed-settings)</td>187 <td>[Server-managed settings](/docs/de/server-managed-settings)</td>

188 <td>✓ (Team und Enterprise)</td>188 <td>✓ (Team und Enterprise)</td>

189 <td>✓ (Team und Enterprise)</td>189 <td>✓ (Team und Enterprise)</td>

190 <td>✗</td>190 <td>✗</td>

194 </tr>194 </tr>

195 195

196 <tr>196 <tr>

197 <td>[Zero Data Retention](/de/zero-data-retention)</td>197 <td>[Zero Data Retention](/docs/de/zero-data-retention)</td>

198 <td>✓ (qualified Enterprise accounts)</td>198 <td>✓ (qualified Enterprise accounts)</td>

199 <td>✓ (qualified accounts)</td>199 <td>✓ (qualified accounts)</td>

200 <td>Siehe Hinweis <sup><a href="#fn4">4</a></sup></td>200 <td>Siehe Hinweis <sup><a href="#fn4">4</a></sup></td>

206</table>206</table>

207 207

208<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Auf Google Cloud's Agent Platform ist Web search für Claude 4-Modelle und später verfügbar.<br />208<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Auf Google Cloud's Agent Platform ist Web search für Claude 4-Modelle und später verfügbar.<br />

209<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Auf diesen Anbietern unterstützt Auto mode nur Claude Sonnet 5, Opus 4.7 und Opus 4.8. Siehe [Auto mode configuration](/de/auto-mode-config). {/* min-version: 2.1.207 */}In v2.1.158 bis v2.1.206 erforderte Auto mode auf diesen Anbietern auch das Setzen von `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 entfernte die Anforderung.<br />209<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Auf diesen Anbietern unterstützt Auto mode nur Claude Sonnet 5, Opus 4.7 und Opus 4.8. Siehe [Auto mode configuration](/docs/de/auto-mode-config). In v2.1.158 bis v2.1.206 erforderte Auto mode auf diesen Anbietern auch das Setzen von `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 entfernte die Anforderung.<br />

210<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Explizite Intervalle wie `/loop every 2 hours` funktionieren auf jedem Anbieter. Auf Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry kann `/loop` sein eigenes Intervall nicht auswählen oder die Standard-Wartungsaufforderung bereitstellen, daher wird eine Aufforderung ohne Intervall alle 10 Minuten ausgeführt, und `/loop` ohne Argumente zeigt die Nutzungsmeldung. Siehe [Scheduled tasks](/de/scheduled-tasks).<br />210<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Explizite Intervalle wie `/loop every 2 hours` funktionieren auf jedem Anbieter. Auf Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform und Microsoft Foundry kann `/loop` sein eigenes Intervall nicht auswählen oder die Standard-Wartungsaufforderung bereitstellen, daher wird eine Aufforderung ohne Intervall alle 10 Minuten ausgeführt, und `/loop` ohne Argumente zeigt die Nutzungsmeldung. Siehe [Scheduled tasks](/docs/de/scheduled-tasks).<br />

211<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Unterliegt Ihrer Vereinbarung mit dem Cloud-Anbieter.<br />211<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Unterliegt Ihrer Vereinbarung mit dem Cloud-Anbieter.<br />

212<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Dashboard und API nur. [Contribution metrics](/de/analytics#enable-contribution-metrics) erfordert eine claude.ai Team- oder Enterprise-Organisation.212<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Dashboard und API nur. [Contribution metrics](/docs/de/analytics#enable-contribution-metrics) erfordert eine claude.ai Team- oder Enterprise-Organisation.

213 213

214<Note>214<Note>

215 Wenn Sie sich über ein [LLM gateway](/de/llm-gateway) authentifizieren, entspricht die Verfügbarkeit von Funktionen dem zugrunde liegenden Anbieter, an den das Gateway weiterleitet. Einige Anthropic-exklusive Funktionen wie der [Advisor](/de/advisor) funktionieren nur, wenn das Gateway Anfragen intakt an die Anthropic API weiterleitet.215 Wenn Sie sich über ein [LLM gateway](/docs/de/llm-gateway) authentifizieren, entspricht die Verfügbarkeit von Funktionen dem zugrunde liegenden Anbieter, an den das Gateway weiterleitet. Einige Anthropic-exklusive Funktionen wie der [Advisor](/docs/de/advisor) funktionieren nur, wenn das Gateway Anfragen intakt an die Anthropic API weiterleitet.

216</Note>216</Note>

217 217

218<h3 id="summary-by-provider">218<h3 id="summary-by-provider">

219 Zusammenfassung nach Anbieter219 Zusammenfassung nach Anbieter

220</h3>220</h3>

221 221

222Jede Registerkarte listet auf, was auf diesem Anbieter nicht verfügbar oder teilweise unterstützt wird, mit Alternativen, wo vorhanden. Alles, was nicht aufgelistet ist, funktioniert genauso wie bei einem Claude-Abonnement, abgesehen von den [anbieter-spezifischen Unterschieden](#features-available-on-every-provider), die oben erwähnt werden. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS sind Fehlerberichterstattung und Telemetrie an Anthropic standardmäßig deaktiviert. Siehe [Standardverhalten nach API-Anbieter](/de/data-usage#default-behaviors-by-api-provider) für welcher Datenverkehr noch Anthropic erreicht und wie Sie sich abmelden.222Jede Registerkarte listet auf, was auf diesem Anbieter nicht verfügbar oder teilweise unterstützt wird, mit Alternativen, wo vorhanden. Alles, was nicht aufgelistet ist, funktioniert genauso wie bei einem Claude-Abonnement, abgesehen von den [anbieter-spezifischen Unterschieden](#features-available-on-every-provider), die oben erwähnt werden. Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform on AWS sind Fehlerberichterstattung und Telemetrie an Anthropic standardmäßig deaktiviert. Siehe [Standardverhalten nach API-Anbieter](/docs/de/data-usage#default-behaviors-by-api-provider) für welcher Datenverkehr noch Anthropic erreicht und wie Sie sich abmelden.

223 223

224<Tabs>224<Tabs>

225 <Tab title="Amazon Bedrock">225 <Tab title="Amazon Bedrock">

226 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [Web search](/de/tools-reference#websearch-tool-behavior), [fast mode](/de/fast-mode), [Advisor](/de/advisor), [Channels](/de/channels), das [analytics dashboard](/de/analytics), [server-managed settings](/de/server-managed-settings) und die [`/design-sync` und `/radio` commands](/de/commands#all-commands).226 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [Web search](/docs/de/tools-reference#websearch-tool-behavior), [fast mode](/docs/de/fast-mode), [Advisor](/docs/de/advisor), [Channels](/docs/de/channels), das [analytics dashboard](/docs/de/analytics), [server-managed settings](/docs/de/server-managed-settings) und die [`/design-sync` und `/radio` commands](/docs/de/commands#all-commands).

227 227

228 **Teilweise Unterstützung:**228 **Teilweise Unterstützung:**

229 229

230 * [Desktop](/de/desktop): nur über [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)230 * [Desktop](/docs/de/desktop): nur über [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

231 * [Auto mode](/de/auto-mode-config): Sonnet 5, Opus 4.7 und Opus 4.8 nur231 * [Auto mode](/docs/de/auto-mode-config): Sonnet 5, Opus 4.7 und Opus 4.8 nur

232 * [`/loop`](/de/scheduled-tasks): nur explizite Intervalle232 * [`/loop`](/docs/de/scheduled-tasks): nur explizite Intervalle

233 * [Zero Data Retention](/de/zero-data-retention): unterliegt Ihrer AWS-Vereinbarung233 * [Zero Data Retention](/docs/de/zero-data-retention): unterliegt Ihrer AWS-Vereinbarung

234 234

235 **Alternativen:** Verwenden Sie für die Planung [`/loop`](/de/scheduled-tasks) mit einem expliziten Intervall statt `/schedule`. Für Cloud-Sitzungen verwenden Sie [GitHub Actions](/de/github-actions) oder [GitLab CI/CD](/de/gitlab-ci-cd). Für Web-Lookups verwenden Sie das [WebFetch tool](/de/tools-reference#webfetch-tool-behavior) mit einer bestimmten URL.235 **Alternativen:** Verwenden Sie für die Planung [`/loop`](/docs/de/scheduled-tasks) mit einem expliziten Intervall statt `/schedule`. Für Cloud-Sitzungen verwenden Sie [GitHub Actions](/docs/de/github-actions) oder [GitLab CI/CD](/docs/de/gitlab-ci-cd). Für Web-Lookups verwenden Sie das [WebFetch tool](/docs/de/tools-reference#webfetch-tool-behavior) mit einer bestimmten URL.

236 </Tab>236 </Tab>

237 237

238 <Tab title="Claude Platform on AWS">238 <Tab title="Claude Platform on AWS">

239 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [fast mode](/de/fast-mode), [Advisor](/de/advisor), [Channels](/de/channels), das [analytics dashboard](/de/analytics), [server-managed settings](/de/server-managed-settings) und die [`/design-sync` und `/radio` commands](/de/commands#all-commands).239 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [fast mode](/docs/de/fast-mode), [Advisor](/docs/de/advisor), [Channels](/docs/de/channels), das [analytics dashboard](/docs/de/analytics), [server-managed settings](/docs/de/server-managed-settings) und die [`/design-sync` und `/radio` commands](/docs/de/commands#all-commands).

240 240

241 **Verfügbar wo Amazon Bedrock nicht ist:** [Web search](/de/tools-reference#websearch-tool-behavior).241 **Verfügbar wo Amazon Bedrock nicht ist:** [Web search](/docs/de/tools-reference#websearch-tool-behavior).

242 242

243 **Teilweise Unterstützung:**243 **Teilweise Unterstützung:**

244 244

245 * [`/loop`](/de/scheduled-tasks): nur explizite Intervalle245 * [`/loop`](/docs/de/scheduled-tasks): nur explizite Intervalle

246 246

247 **Alternativen:** Verwenden Sie für die Planung [`/loop`](/de/scheduled-tasks) mit einem expliziten Intervall statt `/schedule`. Für Cloud-Sitzungen verwenden Sie [GitHub Actions](/de/github-actions) oder [GitLab CI/CD](/de/gitlab-ci-cd).247 **Alternativen:** Verwenden Sie für die Planung [`/loop`](/docs/de/scheduled-tasks) mit einem expliziten Intervall statt `/schedule`. Für Cloud-Sitzungen verwenden Sie [GitHub Actions](/docs/de/github-actions) oder [GitLab CI/CD](/docs/de/gitlab-ci-cd).

248 </Tab>248 </Tab>

249 249

250 <Tab title="Google Cloud's Agent Platform">250 <Tab title="Google Cloud's Agent Platform">

251 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [fast mode](/de/fast-mode), [Advisor](/de/advisor), [Channels](/de/channels), das [analytics dashboard](/de/analytics), [server-managed settings](/de/server-managed-settings) und die [`/design-sync` und `/radio` commands](/de/commands#all-commands).251 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [fast mode](/docs/de/fast-mode), [Advisor](/docs/de/advisor), [Channels](/docs/de/channels), das [analytics dashboard](/docs/de/analytics), [server-managed settings](/docs/de/server-managed-settings) und die [`/design-sync` und `/radio` commands](/docs/de/commands#all-commands).

252 252

253 **Teilweise Unterstützung:**253 **Teilweise Unterstützung:**

254 254

255 * [Desktop](/de/desktop): über [verwaltete Einstellungen](https://claude.com/docs/third-party/claude-desktop/configuration) oder [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)255 * [Desktop](/docs/de/desktop): über [verwaltete Einstellungen](https://claude.com/docs/third-party/claude-desktop/configuration) oder [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

256 * [Web search](/de/tools-reference#websearch-tool-behavior): Claude 4-Modelle und später256 * [Web search](/docs/de/tools-reference#websearch-tool-behavior): Claude 4-Modelle und später

257 * [Auto mode](/de/auto-mode-config): Sonnet 5, Opus 4.7 und Opus 4.8 nur257 * [Auto mode](/docs/de/auto-mode-config): Sonnet 5, Opus 4.7 und Opus 4.8 nur

258 * [`/loop`](/de/scheduled-tasks): nur explizite Intervalle258 * [`/loop`](/docs/de/scheduled-tasks): nur explizite Intervalle

259 * [Zero Data Retention](/de/zero-data-retention): unterliegt Ihrer Google Cloud-Vereinbarung259 * [Zero Data Retention](/docs/de/zero-data-retention): unterliegt Ihrer Google Cloud-Vereinbarung

260 260

261 **Alternativen:** Verwenden Sie für die Planung [`/loop`](/de/scheduled-tasks) mit einem expliziten Intervall statt `/schedule`. Für Cloud-Sitzungen verwenden Sie [GitHub Actions](/de/github-actions) oder [GitLab CI/CD](/de/gitlab-ci-cd).261 **Alternativen:** Verwenden Sie für die Planung [`/loop`](/docs/de/scheduled-tasks) mit einem expliziten Intervall statt `/schedule`. Für Cloud-Sitzungen verwenden Sie [GitHub Actions](/docs/de/github-actions) oder [GitLab CI/CD](/docs/de/gitlab-ci-cd).

262 </Tab>262 </Tab>

263 263

264 <Tab title="Microsoft Foundry">264 <Tab title="Microsoft Foundry">

265 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [fast mode](/de/fast-mode), [Advisor](/de/advisor), [Channels](/de/channels), [GitHub Actions](/de/github-actions) und [GitLab CI/CD](/de/gitlab-ci-cd), das [analytics dashboard](/de/analytics), [server-managed settings](/de/server-managed-settings) und die [`/design-sync` und `/radio` commands](/de/commands#all-commands).265 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription), plus [fast mode](/docs/de/fast-mode), [Advisor](/docs/de/advisor), [Channels](/docs/de/channels), [GitHub Actions](/docs/de/github-actions) und [GitLab CI/CD](/docs/de/gitlab-ci-cd), das [analytics dashboard](/docs/de/analytics), [server-managed settings](/docs/de/server-managed-settings) und die [`/design-sync` und `/radio` commands](/docs/de/commands#all-commands).

266 266

267 **Teilweise Unterstützung:**267 **Teilweise Unterstützung:**

268 268

269 * [Desktop](/de/desktop): nur über [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)269 * [Desktop](/docs/de/desktop): nur über [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

270 * [Auto mode](/de/auto-mode-config): Sonnet 5, Opus 4.7 und Opus 4.8 nur270 * [Auto mode](/docs/de/auto-mode-config): Sonnet 5, Opus 4.7 und Opus 4.8 nur

271 * [`/loop`](/de/scheduled-tasks): nur explizite Intervalle271 * [`/loop`](/docs/de/scheduled-tasks): nur explizite Intervalle

272 * [Zero Data Retention](/de/zero-data-retention): unterliegt Ihrer Azure-Vereinbarung272 * [Zero Data Retention](/docs/de/zero-data-retention): unterliegt Ihrer Azure-Vereinbarung

273 273

274 **Alternativen:** Verwenden Sie für die Planung [`/loop`](/de/scheduled-tasks) mit einem expliziten Intervall statt `/schedule`.274 **Alternativen:** Verwenden Sie für die Planung [`/loop`](/docs/de/scheduled-tasks) mit einem expliziten Intervall statt `/schedule`.

275 </Tab>275 </Tab>

276 276

277 <Tab title="Anthropic Console">277 <Tab title="Anthropic Console">

278 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription).278 **Nicht verfügbar:** alle [Funktionen, die ein Claude-Abonnement erfordern](#features-that-require-a-claude-subscription).

279 279

280 Alles in [CLI capabilities that vary by provider](#cli-capabilities-that-vary-by-provider) ist verfügbar, ebenso wie [server-managed settings](/de/server-managed-settings), wenn der API-Schlüssel einer Team- oder Enterprise-Organisation gehört.280 Alles in [CLI capabilities that vary by provider](#cli-capabilities-that-vary-by-provider) ist verfügbar, ebenso wie [server-managed settings](/docs/de/server-managed-settings), wenn der API-Schlüssel einer Team- oder Enterprise-Organisation gehört.

281 </Tab>281 </Tab>

282</Tabs>282</Tabs>

283 283

289 289

290| Funktion | Pro | Max | Team | Enterprise |290| Funktion | Pro | Max | Team | Enterprise |

291| :-------------------------------------------------------------------------- | :-- | :-- | :-------------- | :-------------------------------- |291| :-------------------------------------------------------------------------- | :-- | :-- | :-------------- | :-------------------------------- |

292| [Claude Code on the web](/de/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |292| [Claude Code on the web](/docs/de/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |

293| [Routines](/de/routines) | ✓ | ✓ | ✓ | ✓ |293| [Routines](/docs/de/routines) | ✓ | ✓ | ✓ | ✓ |

294| [Remote Control](/de/remote-control) | ✓ | ✓ | Admin-aktiviert | Admin-aktiviert |294| [Remote Control](/docs/de/remote-control) | ✓ | ✓ | Admin-aktiviert | Admin-aktiviert |

295| [Channels](/de/channels) | ✓ | ✓ | Admin-aktiviert | Admin-aktiviert |295| [Channels](/docs/de/channels) | ✓ | ✓ | Admin-aktiviert | Admin-aktiviert |

296| [Computer use](/de/computer-use) | ✓ | ✓ | ✗ | ✗ |296| [Computer use](/docs/de/computer-use) | ✓ | ✓ | ✗ | ✗ |

297| Dispatch ([Desktop](/de/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |297| Dispatch ([Desktop](/docs/de/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |

298| [Code Review](/de/code-review) | ✗ | ✗ | ✓ | ✓ |298| [Code Review](/docs/de/code-review) | ✗ | ✗ | ✓ | ✓ |

299| [Artifacts](/de/artifacts) | ✓ | ✓ | ✓ | Admin-aktiviert |299| [Artifacts](/docs/de/artifacts) | ✓ | ✓ | ✓ | Admin-aktiviert |

300| [Analytics-Dashboard und Beitragskennzahlen](/de/analytics) | ✗ | ✗ | ✓ | ✓ |300| [Analytics-Dashboard und Beitragskennzahlen](/docs/de/analytics) | ✗ | ✗ | ✓ | ✓ |

301| [Enterprise Analytics API](/de/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |301| [Enterprise Analytics API](/docs/de/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |

302| [Server-managed settings](/de/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |302| [Server-managed settings](/docs/de/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

303| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |303| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |

304| SCIM | ✗ | ✗ | ✗ | ✓ |304| SCIM | ✗ | ✗ | ✗ | ✓ |

305| [Compliance API](https://platform.claude.com/docs/en/api/compliance) | ✗ | ✗ | ✗ | ✓ |305| [Compliance API](https://platform.claude.com/docs/en/api/compliance) | ✗ | ✗ | ✗ | ✓ |

306| [Zero Data Retention](/de/zero-data-retention) | ✗ | ✗ | ✗ | ✓ <sup><a href="#fn7">7</a></sup> |306| [Zero Data Retention](/docs/de/zero-data-retention) | ✗ | ✗ | ✗ | ✓ <sup><a href="#fn7">7</a></sup> |

307 307

308<span id="fn6" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>6</sup> Auf Enterprise erfordert einen Premium-Sitz oder einen Chat + Claude Code-Sitz. Siehe [Claude Code on the web](/de/claude-code-on-the-web).<br />308<span id="fn6" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>6</sup> Auf Enterprise erfordert einen Premium-Sitz oder einen Chat + Claude Code-Sitz. Siehe [Claude Code on the web](/docs/de/claude-code-on-the-web).<br />

309<span id="fn7" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>7</sup> Nicht im Standard-Enterprise-Plan enthalten. Erfordert separate Aktivierung durch Anthropic für qualifizierte Konten. Siehe [Zero Data Retention](/de/zero-data-retention).309<span id="fn7" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>7</sup> Nicht im Standard-Enterprise-Plan enthalten. Erfordert separate Aktivierung durch Anthropic für qualifizierte Konten. Siehe [Zero Data Retention](/docs/de/zero-data-retention).

310 310

311Für Preise und den vollständigen Planvergleich siehe [Team plans](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) und [Enterprise plans](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).311Für Preise und den vollständigen Planvergleich siehe [Team plans](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) und [Enterprise plans](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).

312 312

314 Modellverfügbarkeit314 Modellverfügbarkeit

315</h2>315</h2>

316 316

317Für welche Claude-Modelle und Kontextfenstergrößen pro Anbieter und Region verfügbar sind, siehe [Model configuration](/de/model-config) und die [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, PDF-Eingabe und erweitertes Denken sind Modellfunktionen und keine Claude Code-Funktionen und funktionieren auf jedem Anbieter, der das Modell anbietet. [Prompt caching](/de/prompt-caching) funktioniert auf den meisten Anbietern gleich; auf Amazon Bedrock variiert die Unterstützung je nach Modell.317Für welche Claude-Modelle und Kontextfenstergrößen pro Anbieter und Region verfügbar sind, siehe [Model configuration](/docs/de/model-config) und die [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, PDF-Eingabe und erweitertes Denken sind Modellfunktionen und keine Claude Code-Funktionen und funktionieren auf jedem Anbieter, der das Modell anbietet. [Prompt caching](/docs/de/prompt-caching) funktioniert auf den meisten Anbietern gleich; auf Amazon Bedrock variiert die Unterstützung je nach Modell.

318 318

319<h2 id="related-resources">319<h2 id="related-resources">

320 Verwandte Ressourcen320 Verwandte Ressourcen

321</h2>321</h2>

322 322

323* [Enterprise deployment overview](/de/third-party-integrations): Vergleichen Sie Authentifizierung, Abrechnung und Regionen über Anbieter hinweg323* [Enterprise deployment overview](/docs/de/third-party-integrations): Vergleichen Sie Authentifizierung, Abrechnung und Regionen über Anbieter hinweg

324* Provider-Einrichtungsleitfäden: [Amazon Bedrock](/de/amazon-bedrock), [Claude Platform on AWS](/de/claude-platform-on-aws), [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry)324* Provider-Einrichtungsleitfäden: [Amazon Bedrock](/docs/de/amazon-bedrock), [Claude Platform on AWS](/docs/de/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), [Microsoft Foundry](/docs/de/microsoft-foundry)

325* [Platforms and integrations](/de/platforms): wo Claude Code ausgeführt wird, einschließlich CLI, Desktop, IDE-Erweiterungen, Web, Mobilgeräte und CI/CD325* [Platforms and integrations](/docs/de/platforms): wo Claude Code ausgeführt wird, einschließlich CLI, Desktop, IDE-Erweiterungen, Web, Mobilgeräte und CI/CD

fullscreen.md +10 −10

Details

22 Vollbildrendering aktivieren22 Vollbildrendering aktivieren

23</h2>23</h2>

24 24

25Führen Sie `/tui fullscreen` in einem beliebigen Claude Code Gespräch aus. Die CLI speichert die [`tui` Einstellung](/de/settings#available-settings) und startet mit Ihrem Gespräch intakt in den Vollbildmodus neu, sodass Sie die Sitzung wechseln können, ohne den Kontext zu verlieren. Führen Sie `/tui default` aus, um zum klassischen Renderer zurückzuwechseln, oder `/tui` ohne Argument, um zu drucken, welcher Renderer aktiv ist.25Führen Sie `/tui fullscreen` in einem beliebigen Claude Code Gespräch aus. Die CLI speichert die [`tui` Einstellung](/docs/de/settings#available-settings) und startet mit Ihrem Gespräch intakt in den Vollbildmodus neu, sodass Sie die Sitzung wechseln können, ohne den Kontext zu verlieren. Führen Sie `/tui default` aus, um zum klassischen Renderer zurückzuwechseln, oder `/tui` ohne Argument, um zu drucken, welcher Renderer aktiv ist.

26 26

27Die neu gestartete Sitzung behält das Gespräch so bei, wie es auf dem Bildschirm angezeigt wird. Wenn Sie [`/rewind`](/de/checkpointing#rewind-and-summarize) früher in der Sitzung ausgeführt haben, wird der Neustart vom zurückgespulten Punkt aus fortgesetzt, anstatt vom längeren Transkript, das auf der Festplatte gespeichert ist. Vor v2.1.207 stellte das Wechseln von Renderern nach einem Rewind das Gespräch wieder her, das der Rewind entfernt hatte.27Die neu gestartete Sitzung behält das Gespräch so bei, wie es auf dem Bildschirm angezeigt wird. Wenn Sie [`/rewind`](/docs/de/checkpointing#rewind-and-summarize) früher in der Sitzung ausgeführt haben, wird der Neustart vom zurückgespulten Punkt aus fortgesetzt, anstatt vom längeren Transkript, das auf der Festplatte gespeichert ist. Vor v2.1.207 stellte das Wechseln von Renderern nach einem Rewind das Gespräch wieder her, das der Rewind entfernt hatte.

28 28

29Sie können auch die Umgebungsvariable `CLAUDE_CODE_NO_FLICKER` vor dem Starten von Claude Code setzen:29Sie können auch die Umgebungsvariable `CLAUDE_CODE_NO_FLICKER` vor dem Starten von Claude Code setzen:

30 30

90* Scrollen Sie mit dem Mausrad nach unten, um das Folgen fortzusetzen.90* Scrollen Sie mit dem Mausrad nach unten, um das Folgen fortzusetzen.

91* Binden Sie `scroll:bottom` an eine Verknüpfung neu, die Ihre Tastatur senden kann.91* Binden Sie `scroll:bottom` an eine Verknüpfung neu, die Ihre Tastatur senden kann.

92 92

93Diese Aktionen sind neu bindbar. Siehe [Scroll-Aktionen](/de/keybindings#scroll-actions) für die vollständige Liste der Aktionsnamen, einschließlich Varianten für halbe Seiten und ganze Seiten, die keine Standardbindung haben.93Diese Aktionen sind neu bindbar. Siehe [Scroll-Aktionen](/docs/de/keybindings#scroll-actions) für die vollständige Liste der Aktionsnamen, einschließlich Varianten für halbe Seiten und ganze Seiten, die keine Standardbindung haben.

94 94

95<h3 id="auto-follow">95<h3 id="auto-follow">

96 Automatisches Folgen96 Automatisches Folgen

100 100

101Während das automatische Folgen pausiert ist, bleibt die Ansicht auch dort, wo Sie sie gescrollt haben, wenn eine Antwort das Streaming beendet. Vor v2.1.207 konnte die Ansicht über den Anfang der Antwort springen, wenn eine lange Antwort das Streaming beendete.101Während das automatische Folgen pausiert ist, bleibt die Ansicht auch dort, wo Sie sie gescrollt haben, wenn eine Antwort das Streaming beendet. Vor v2.1.207 konnte die Ansicht über den Anfang der Antwort springen, wenn eine lange Antwort das Streaming beendete.

102 102

103Der Tastatur-Hinweis der Schaltfläche spiegelt wider, was Ihre Tastatur senden kann. Auf macOS schlägt sie vor, zu klicken oder `Fn+↓` zum Scrollen zu verwenden, da `Ctrl+End` Claude Code von einer Mac-Tastatur nicht erreicht. Binden Sie [`scroll:bottom`](/de/keybindings#scroll-actions) neu und die Schaltfläche zeigt Ihre Verknüpfung auf jeder Plattform an. Vor v2.1.206 schlug die Schaltfläche `Ctrl+End` auf macOS vor.103Der Tastatur-Hinweis der Schaltfläche spiegelt wider, was Ihre Tastatur senden kann. Auf macOS schlägt sie vor, zu klicken oder `Fn+↓` zum Scrollen zu verwenden, da `Ctrl+End` Claude Code von einer Mac-Tastatur nicht erreicht. Binden Sie [`scroll:bottom`](/docs/de/keybindings#scroll-actions) neu und die Schaltfläche zeigt Ihre Verknüpfung auf jeder Plattform an. Vor v2.1.206 schlug die Schaltfläche `Ctrl+End` auf macOS vor.

104 104

105Auf einem Terminal, das zu schmal für die vollständige Beschriftung ist, verkürzt die Schaltfläche den Hinweis, anstatt auf die Transkriptzeile darunter umzubrechen. Vor v2.1.206 konnte eine lange Beschriftung über das Transkript umgebrochen werden.105Auf einem Terminal, das zu schmal für die vollständige Beschriftung ist, verkürzt die Schaltfläche den Hinweis, anstatt auf die Transkriptzeile darunter umzubrechen. Vor v2.1.206 konnte eine lange Beschriftung über das Transkript umgebrochen werden.

106 106

126 126

127Der Befehl schreibt denselben Wert, den die Umgebungsvariable `CLAUDE_CODE_SCROLL_SPEED` setzt, persistent in `~/.claude/settings.json`. Der Befehl ist im JetBrains IDE-Terminal nicht verfügbar.127Der Befehl schreibt denselben Wert, den die Umgebungsvariable `CLAUDE_CODE_SCROLL_SPEED` setzt, persistent in `~/.claude/settings.json`. Der Befehl ist im JetBrains IDE-Terminal nicht verfügbar.

128 128

129Unabhängig von der Basisgeschwindigkeit beschleunigt Claude Code die Scroll-Rate, wenn Sie das Rad schnell drehen, sodass eine schnelle Drehung eine größere Distanz abdeckt als die gleiche Anzahl langsamer Kerben. Um die Beschleunigung auszuschalten und eine konstante Rate pro Kerbe beizubehalten, setzen Sie `wheelScrollAccelerationEnabled` auf `false` in [`settings.json`](/de/settings#available-settings). Diese Einstellung erfordert Claude Code v2.1.174 oder später.129Unabhängig von der Basisgeschwindigkeit beschleunigt Claude Code die Scroll-Rate, wenn Sie das Rad schnell drehen, sodass eine schnelle Drehung eine größere Distanz abdeckt als die gleiche Anzahl langsamer Kerben. Um die Beschleunigung auszuschalten und eine konstante Rate pro Kerbe beizubehalten, setzen Sie `wheelScrollAccelerationEnabled` auf `false` in [`settings.json`](/docs/de/settings#available-settings). Diese Einstellung erfordert Claude Code v2.1.174 oder später.

130 130

131<h3 id="scroll-in-the-jetbrains-ide-terminal">131<h3 id="scroll-in-the-jetbrains-ide-terminal">

132 Scrollen im JetBrains IDE-Terminal132 Scrollen im JetBrains IDE-Terminal

187 187

188Nicht jede tmux-Version wendet synchronisierte Ausgabe von Anwendungen an, daher können Sie während Neuzeichnungen unter tmux mehr Flimmern sehen als beim direkten Ausführen von Claude Code in Ihrem Terminal. Wenn das Flimmern auffällig ist, besonders über SSH, führen Sie ein Upgrade auf die neueste tmux-Version durch oder führen Sie Claude Code in seiner eigenen Terminal-Registerkarte außerhalb von tmux aus. Überprüfen Sie Ihre tmux-Version mit `tmux -V`.188Nicht jede tmux-Version wendet synchronisierte Ausgabe von Anwendungen an, daher können Sie während Neuzeichnungen unter tmux mehr Flimmern sehen als beim direkten Ausführen von Claude Code in Ihrem Terminal. Wenn das Flimmern auffällig ist, besonders über SSH, führen Sie ein Upgrade auf die neueste tmux-Version durch oder führen Sie Claude Code in seiner eigenen Terminal-Registerkarte außerhalb von tmux aus. Überprüfen Sie Ihre tmux-Version mit `tmux -V`.

189 189

190{/* min-version: 2.1.200 */}Claude Code aktiviert synchronisierte Ausgabe automatisch, wenn es tmux 3.4 oder später aus der `TERM_PROGRAM_VERSION`-Variable erkennt, und greift auf direkte Abfragen des Terminals nach Unterstützung für synchronisierte Ausgabe zurück, wenn die Version nicht bestimmt werden kann. Ob Neuzeichnungen tatsächlich atomar werden, hängt davon ab, ob Ihre tmux-Version synchronisierte Ausgabe berücksichtigt; wenn Sie unter tmux 3.4 oder später immer noch Flimmern sehen, führen Sie ein Upgrade auf die neueste tmux-Version durch. Diese Erkennung erfordert Claude Code v2.1.200 oder später.190Claude Code aktiviert synchronisierte Ausgabe automatisch, wenn es tmux 3.4 oder später aus der `TERM_PROGRAM_VERSION`-Variable erkennt, und greift auf direkte Abfragen des Terminals nach Unterstützung für synchronisierte Ausgabe zurück, wenn die Version nicht bestimmt werden kann. Ob Neuzeichnungen tatsächlich atomar werden, hängt davon ab, ob Ihre tmux-Version synchronisierte Ausgabe berücksichtigt; wenn Sie unter tmux 3.4 oder später immer noch Flimmern sehen, führen Sie ein Upgrade auf die neueste tmux-Version durch. Diese Erkennung erfordert Claude Code v2.1.200 oder später.

191 191

192<h2 id="keep-native-text-selection">192<h2 id="keep-native-text-selection">

193 Native Textauswahl beibehalten193 Native Textauswahl beibehalten

203 203

204In tmux schreibt es auch in den tmux-Paste-Puffer. Über SSH fällt es auf OSC 52 Escape-Sequenzen zurück. Claude Code druckt nach jeder Kopie einen Toast, der Ihnen mitteilt, welchen Pfad es verwendet hat.204In tmux schreibt es auch in den tmux-Paste-Puffer. Über SSH fällt es auf OSC 52 Escape-Sequenzen zurück. Claude Code druckt nach jeder Kopie einen Toast, der Ihnen mitteilt, welchen Pfad es verwendet hat.

205 205

206Einige Terminals blockieren OSC 52 standardmäßig. iTerm2 blockiert es, bis Sie Einstellungen → Allgemein → Auswahl → Anwendungen im Terminal dürfen auf Zwischenablage zugreifen aktivieren. Wenn Sie [`/terminal-setup`](/de/terminal-config) in iTerm2 ausführen, wird dies für Sie aktiviert.206Einige Terminals blockieren OSC 52 standardmäßig. iTerm2 blockiert es, bis Sie Einstellungen → Allgemein → Auswahl → Anwendungen im Terminal dürfen auf Zwischenablage zugreifen aktivieren. Wenn Sie [`/terminal-setup`](/docs/de/terminal-config) in iTerm2 ausführen, wird dies für Sie aktiviert.

207 207

208Für eine einmalige native Auswahl hängt die zu verwendende Taste von Ihrem Terminal ab:208Für eine einmalige native Auswahl hängt die zu verwendende Taste von Ihrem Terminal ab:

209 209

238 238

239Das Vollbild-Rendering sendet nur die Zellen, die sich zwischen den Frames geändert haben. Einige Terminals, am häufigsten Windows Terminal und andere ConPTY-gestützte Hosts, führen diese positionierten Schreibvorgänge falsch zusammen und hinterlassen Fragmente der früheren Ausgabe auf dem Bildschirm, bis Sie das Fenster vergrößern.239Das Vollbild-Rendering sendet nur die Zellen, die sich zwischen den Frames geändert haben. Einige Terminals, am häufigsten Windows Terminal und andere ConPTY-gestützte Hosts, führen diese positionierten Schreibvorgänge falsch zusammen und hinterlassen Fragmente der früheren Ausgabe auf dem Bildschirm, bis Sie das Fenster vergrößern.

240 240

241Setzen Sie [`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1`](/de/env-vars), um jede Zelle bei jedem Frame neu zu zeichnen, anstatt inkrementelle Updates zu senden.241Setzen Sie [`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1`](/docs/de/env-vars), um jede Zelle bei jedem Frame neu zu zeichnen, anstatt inkrementelle Updates zu senden.

242 242

243Unter Windows PowerShell:243Unter Windows PowerShell:

244 244

253CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude253CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude

254```254```

255 255

256Unter Windows aktiviert Claude Code bereits automatisch das vollständige Neuzeichnen für Hintergrund-Sitzungen und [Agent-Ansicht](/de/agent-view), daher müssen Sie die Variable nur für eine interaktive Vollbild-Sitzung setzen, die Sie direkt gestartet haben.256Unter Windows aktiviert Claude Code bereits automatisch das vollständige Neuzeichnen für Hintergrund-Sitzungen und [Agent-Ansicht](/docs/de/agent-view), daher müssen Sie die Variable nur für eine interaktive Vollbild-Sitzung setzen, die Sie direkt gestartet haben.

257 257

258<h2 id="research-preview">258<h2 id="research-preview">

259 Forschungsvorschau259 Forschungsvorschau

265 265

266Um Vollbildrendering auszuschalten, führen Sie `/tui default` aus, oder heben Sie `CLAUDE_CODE_NO_FLICKER` auf, wenn Sie es auf diese Weise aktiviert haben. Um den klassischen Renderer unabhängig von der gespeicherten `tui`-Einstellung zu erzwingen, setzen Sie `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1`. Der klassische Renderer behält die Konversation im nativen Scrollback Ihres Terminals bei, sodass `Cmd+f` und der tmux-Kopiermodus wie gewohnt funktionieren.266Um Vollbildrendering auszuschalten, führen Sie `/tui default` aus, oder heben Sie `CLAUDE_CODE_NO_FLICKER` auf, wenn Sie es auf diese Weise aktiviert haben. Um den klassischen Renderer unabhängig von der gespeicherten `tui`-Einstellung zu erzwingen, setzen Sie `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1`. Der klassische Renderer behält die Konversation im nativen Scrollback Ihres Terminals bei, sodass `Cmd+f` und der tmux-Kopiermodus wie gewohnt funktionieren.

267 267

268Hintergrund-Sitzungen, die aus der [Agent-Ansicht](/de/agent-view) oder `claude attach` geöffnet werden, verwenden immer Vollbildrendering. Das angehängte Terminal wechselt in den alternativen Bildschirmpuffer, um die Sitzung anzuzeigen, und der klassische Renderer hat dort keinen Scrollback oder Maushandling, daher gelten die `tui`-Einstellung und `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` nicht für diese.268Hintergrund-Sitzungen, die aus der [Agent-Ansicht](/docs/de/agent-view) oder `claude attach` geöffnet werden, verwenden immer Vollbildrendering. Das angehängte Terminal wechselt in den alternativen Bildschirmpuffer, um die Sitzung anzuzeigen, und der klassische Renderer hat dort keinen Scrollback oder Maushandling, daher gelten die `tui`-Einstellung und `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` nicht für diese.

google-vertex-ai.md +9 −9

Details

108 </Step>108 </Step>

109 109

110 <Step title="Folgen Sie den Eingabeaufforderungen des Assistenten">110 <Step title="Folgen Sie den Eingabeaufforderungen des Assistenten">

111 Wählen Sie, wie Sie sich bei Google Cloud authentifizieren: Application Default Credentials von `gcloud`, eine Service-Account-Schlüsseldatei oder Anmeldedaten, die bereits in Ihrer Umgebung vorhanden sind. Der Assistent erkennt Ihr Projekt und Ihre Region, überprüft, welche Claude-Modelle Ihr Projekt aufrufen kann, und ermöglicht es Ihnen, diese zu fixieren. Das Ergebnis wird im `env`-Block Ihrer [Benutzereinstellungsdatei](/de/settings) gespeichert, sodass Sie Umgebungsvariablen nicht selbst exportieren müssen.111 Wählen Sie, wie Sie sich bei Google Cloud authentifizieren: Application Default Credentials von `gcloud`, eine Service-Account-Schlüsseldatei oder Anmeldedaten, die bereits in Ihrer Umgebung vorhanden sind. Der Assistent erkennt Ihr Projekt und Ihre Region, überprüft, welche Claude-Modelle Ihr Projekt aufrufen kann, und ermöglicht es Ihnen, diese zu fixieren. Das Ergebnis wird im `env`-Block Ihrer [Benutzereinstellungsdatei](/docs/de/settings) gespeichert, sodass Sie Umgebungsvariablen nicht selbst exportieren müssen.

112 </Step>112 </Step>

113</Steps>113</Steps>

114 114

115Nachdem Sie sich angemeldet haben, führen Sie `/setup-vertex` jederzeit aus, um den Assistenten erneut zu öffnen und Ihre Anmeldedaten, Ihr Projekt, Ihre Region oder Ihre Modellpins zu ändern. Der Modellpin-Schritt beginnt mit Ihren aktuell fixierten Modellen. Der Assistent schreibt in `~/.claude/settings.json` oder in `$CLAUDE_CONFIG_DIR/settings.json`, wenn [`CLAUDE_CONFIG_DIR`](/de/env-vars#variables) gesetzt ist.115Nachdem Sie sich angemeldet haben, führen Sie `/setup-vertex` jederzeit aus, um den Assistenten erneut zu öffnen und Ihre Anmeldedaten, Ihr Projekt, Ihre Region oder Ihre Modellpins zu ändern. Der Modellpin-Schritt beginnt mit Ihren aktuell fixierten Modellen. Der Assistent schreibt in `~/.claude/settings.json` oder in `$CLAUDE_CONFIG_DIR/settings.json`, wenn [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars#variables) gesetzt ist.

116 116

117<h2 id="region-configuration">117<h2 id="region-configuration">

118 Regionskonfiguration118 Regionskonfiguration

212export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1212export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

213```213```

214 214

215Die meisten Modellversionen haben eine entsprechende `VERTEX_REGION_CLAUDE_*`-Variable. Siehe die [Referenz für Umgebungsvariablen](/de/env-vars) für die vollständige Liste. Überprüfen Sie [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), um zu bestimmen, welche Modelle globale Endpunkte versus nur regionale Endpunkte unterstützen.215Die meisten Modellversionen haben eine entsprechende `VERTEX_REGION_CLAUDE_*`-Variable. Siehe die [Referenz für Umgebungsvariablen](/docs/de/env-vars) für die vollständige Liste. Überprüfen Sie [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), um zu bestimmen, welche Modelle globale Endpunkte versus nur regionale Endpunkte unterstützen.

216 216

217[Prompt Caching](/de/prompt-caching) wird automatisch aktiviert. Um es zu deaktivieren, legen Sie `DISABLE_PROMPT_CACHING=1` fest. Um eine 1-Stunden-Cache-TTL statt des 5-Minuten-Standards anzufordern, legen Sie `ENABLE_PROMPT_CACHING_1H=1` fest; Cache-Schreibvorgänge mit einer 1-Stunden-TTL werden mit einem höheren Satz abgerechnet. Für erhöhte Ratenlimits wenden Sie sich an den Google Cloud-Support. Bei Verwendung von Google Cloud's Agent Platform ist der Befehl `/logout` nicht verfügbar, da die Authentifizierung über Google Cloud-Anmeldedaten erfolgt.217[Prompt Caching](/docs/de/prompt-caching) wird automatisch aktiviert. Um es zu deaktivieren, legen Sie `DISABLE_PROMPT_CACHING=1` fest. Um eine 1-Stunden-Cache-TTL statt des 5-Minuten-Standards anzufordern, legen Sie `ENABLE_PROMPT_CACHING_1H=1` fest; Cache-Schreibvorgänge mit einer 1-Stunden-TTL werden mit einem höheren Satz abgerechnet. Für erhöhte Ratenlimits wenden Sie sich an den Google Cloud-Support. Bei Verwendung von Google Cloud's Agent Platform ist der Befehl `/logout` nicht verfügbar, da die Authentifizierung über Google Cloud-Anmeldedaten erfolgt.

218 218

219Claude Code deaktiviert [MCP-Toolsuche](/de/mcp#scale-with-mcp-tool-search) standardmäßig auf Google Cloud's Agent Platform, sodass MCP-Tool-Definitionen beim Start geladen werden. Google Cloud's Agent Platform unterstützt Toolsuche für Claude Sonnet 4.5 und später sowie Claude Opus 4.5 und später. Legen Sie `ENABLE_TOOL_SEARCH=true` fest, um sie auf diesen Modellen zu aktivieren. Frühere Modelle auf Google Cloud's Agent Platform akzeptieren den erforderlichen Beta-Header nicht, und Anfragen schlagen fehl, wenn Sie die Toolsuche mit ihnen aktivieren.219Claude Code deaktiviert [MCP-Toolsuche](/docs/de/mcp#scale-with-mcp-tool-search) standardmäßig auf Google Cloud's Agent Platform, sodass MCP-Tool-Definitionen beim Start geladen werden. Google Cloud's Agent Platform unterstützt Toolsuche für Claude Sonnet 4.5 und später sowie Claude Opus 4.5 und später. Legen Sie `ENABLE_TOOL_SEARCH=true` fest, um sie auf diesen Modellen zu aktivieren. Frühere Modelle auf Google Cloud's Agent Platform akzeptieren den erforderlichen Beta-Header nicht, und Anfragen schlagen fehl, wenn Sie die Toolsuche mit ihnen aktivieren.

220 220

221<h3 id="5-pin-model-versions">221<h3 id="5-pin-model-versions">

222 5. Fixieren Sie Modellversionen222 5. Fixieren Sie Modellversionen

236export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'236export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

237```237```

238 238

239Aktuelle und ältere Modell-IDs finden Sie unter [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Siehe [Modellkonfiguration](/de/model-config#pin-models-for-third-party-deployments) für die vollständige Liste der Umgebungsvariablen.239Aktuelle und ältere Modell-IDs finden Sie unter [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Siehe [Modellkonfiguration](/docs/de/model-config#pin-models-for-third-party-deployments) für die vollständige Liste der Umgebungsvariablen.

240 240

241Claude Code verwendet diese Standardmodelle, wenn keine Fixierungsvariablen gesetzt sind:241Claude Code verwendet diese Standardmodelle, wenn keine Fixierungsvariablen gesetzt sind:

242 242

254 Opus-Modelle haben einen höheren Pro-Token-Preis als Sonnet-Modelle, daher wird eine Bereitstellung, die kein primäres Modell fixiert, mit dem Opus-Satz abgerechnet, sobald sie auf v2.1.207 oder später aktualisiert wird. Um Sonnet 4.5 als primäres Modell beizubehalten, legen Sie `ANTHROPIC_MODEL` auf seine vollständige Modell-ID fest. Eine Bereitstellung, die den Standard mit `ANTHROPIC_DEFAULT_SONNET_MODEL` steuert und `ANTHROPIC_DEFAULT_OPUS_MODEL` nicht setzt, behält ihr gesteuertes Sonnet-Modell als Standard.254 Opus-Modelle haben einen höheren Pro-Token-Preis als Sonnet-Modelle, daher wird eine Bereitstellung, die kein primäres Modell fixiert, mit dem Opus-Satz abgerechnet, sobald sie auf v2.1.207 oder später aktualisiert wird. Um Sonnet 4.5 als primäres Modell beizubehalten, legen Sie `ANTHROPIC_MODEL` auf seine vollständige Modell-ID fest. Eine Bereitstellung, die den Standard mit `ANTHROPIC_DEFAULT_SONNET_MODEL` steuert und `ANTHROPIC_DEFAULT_OPUS_MODEL` nicht setzt, behält ihr gesteuertes Sonnet-Modell als Standard.

255</Warning>255</Warning>

256 256

257{/* min-version: 2.1.207 */}Vor v2.1.207 war das primäre Modell auf Google Cloud's Agent Platform standardmäßig Sonnet 4.5, der `opus`-Alias wurde zu Opus 4.6 aufgelöst, und Hintergrundaufgaben verwendeten immer das primäre Modell.257Vor v2.1.207 war das primäre Modell auf Google Cloud's Agent Platform standardmäßig Sonnet 4.5, der `opus`-Alias wurde zu Opus 4.6 aufgelöst, und Hintergrundaufgaben verwendeten immer das primäre Modell.

258 258

259Um Modelle weiter anzupassen:259Um Modelle weiter anzupassen:

260 260

269 269

270Wenn Claude Code mit Google Cloud's Agent Platform konfiguriert startet, überprüft es, dass die Modelle, die es verwenden möchte, in Ihrem Projekt zugänglich sind.270Wenn Claude Code mit Google Cloud's Agent Platform konfiguriert startet, überprüft es, dass die Modelle, die es verwenden möchte, in Ihrem Projekt zugänglich sind.

271 271

272Wenn Sie eine Modellversion fixiert haben, die älter als der aktuelle Claude Code-Standard ist, und Ihr Projekt die neuere Version aufrufen kann, fordert Claude Code Sie auf, die Fixierung zu aktualisieren. Das Akzeptieren schreibt die neue Modell-ID in Ihre [Benutzereinstellungsdatei](/de/settings) und startet Claude Code neu. Das Ablehnen wird bis zur nächsten Standardversionänderung beibehalten.272Wenn Sie eine Modellversion fixiert haben, die älter als der aktuelle Claude Code-Standard ist, und Ihr Projekt die neuere Version aufrufen kann, fordert Claude Code Sie auf, die Fixierung zu aktualisieren. Das Akzeptieren schreibt die neue Modell-ID in Ihre [Benutzereinstellungsdatei](/docs/de/settings) und startet Claude Code neu. Das Ablehnen wird bis zur nächsten Standardversionänderung beibehalten.

273 273

274Wenn Sie ein Modell nicht fixiert haben und der aktuelle Standard in Ihrem Projekt nicht verfügbar ist, fällt Claude Code für die aktuelle Sitzung zur vorherigen Version zurück und zeigt einen Hinweis an. Es versucht zuerst frühere Versionen des Standardmodells und fällt, wenn der Standard ein Opus-Modell ist und keine Opus-Version verfügbar ist, auf das Standard-Sonnet-Modell zurück. Das Fallback wird nicht beibehalten. Aktivieren Sie das neuere Modell im [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) oder [fixieren Sie eine Version](#5-pin-model-versions), um die Auswahl dauerhaft zu machen.274Wenn Sie ein Modell nicht fixiert haben und der aktuelle Standard in Ihrem Projekt nicht verfügbar ist, fällt Claude Code für die aktuelle Sitzung zur vorherigen Version zurück und zeigt einen Hinweis an. Es versucht zuerst frühere Versionen des Standardmodells und fällt, wenn der Standard ein Opus-Modell ist und keine Opus-Version verfügbar ist, auf das Standard-Sonnet-Modell zurück. Das Fallback wird nicht beibehalten. Aktivieren Sie das neuere Modell im [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) oder [fixieren Sie eine Version](#5-pin-model-versions), um die Auswahl dauerhaft zu machen.

275 275

297 297

298Claude Sonnet 5, Opus 4.6 und später sowie Sonnet 4.6 unterstützen das [1M-Token-Kontextfenster](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) auf Google Cloud's Agent Platform. Sonnet 5 läuft immer mit dem 1M-Fenster, ohne dass eine `[1m]`-Variante zum Auswählen vorhanden ist. Bei den anderen Modellen aktiviert Claude Code automatisch das erweiterte Kontextfenster, wenn Sie eine 1M-Modellvariante auswählen.298Claude Sonnet 5, Opus 4.6 und später sowie Sonnet 4.6 unterstützen das [1M-Token-Kontextfenster](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) auf Google Cloud's Agent Platform. Sonnet 5 läuft immer mit dem 1M-Fenster, ohne dass eine `[1m]`-Variante zum Auswählen vorhanden ist. Bei den anderen Modellen aktiviert Claude Code automatisch das erweiterte Kontextfenster, wenn Sie eine 1M-Modellvariante auswählen.

299 299

300Der [Setup-Assistent](#sign-in-with-agent-platform) bietet eine 1M-Kontextoption an, wenn er Modelle fixiert. Um es stattdessen für ein manuell fixiertes Modell zu aktivieren, hängen Sie `[1m]` an die Modell-ID an. Siehe [Modelle für Drittanbieter-Bereitstellungen fixieren](/de/model-config#pin-models-for-third-party-deployments) für Details.300Der [Setup-Assistent](#sign-in-with-agent-platform) bietet eine 1M-Kontextoption an, wenn er Modelle fixiert. Um es stattdessen für ein manuell fixiertes Modell zu aktivieren, hängen Sie `[1m]` an die Modell-ID an. Siehe [Modelle für Drittanbieter-Bereitstellungen fixieren](/docs/de/model-config#pin-models-for-third-party-deployments) für Details.

301 301

302<h2 id="troubleshooting">302<h2 id="troubleshooting">

303 Fehlerbehebung303 Fehlerbehebung

headless.md +23 −23

Details

6 6

7> Verwenden Sie das Agent SDK, um Claude Code programmgesteuert über die CLI, Python oder TypeScript auszuführen.7> Verwenden Sie das Agent SDK, um Claude Code programmgesteuert über die CLI, Python oder TypeScript auszuführen.

8 8

9Das [Agent SDK](/de/agent-sdk/overview) bietet Ihnen die gleichen Tools, die Agent-Schleife und das Kontextmanagement, die Claude Code antreiben. Es ist als CLI für Skripte und CI/CD verfügbar oder als [Python](/de/agent-sdk/python)- und [TypeScript](/de/agent-sdk/typescript)-Pakete für vollständige programmgesteuerte Kontrolle.9Das [Agent SDK](/docs/de/agent-sdk/overview) bietet Ihnen die gleichen Tools, die Agent-Schleife und das Kontextmanagement, die Claude Code antreiben. Es ist als CLI für Skripte und CI/CD verfügbar oder als [Python](/docs/de/agent-sdk/python)- und [TypeScript](/docs/de/agent-sdk/typescript)-Pakete für vollständige programmgesteuerte Kontrolle.

10 10

~~11Um Claude Code im nicht-interaktiven Modus auszuführen, übergeben Sie `-p` mit Ihrer Eingabeaufforderung und allen [CLI-Optionen](/de/cli-reference):~~11Um Claude Code im nicht-interaktiven Modus auszuführen, übergeben Sie `-p` mit Ihrer Eingabeaufforderung und allen [CLI-Optionen](/docs/de/cli-reference):

12 12

13```bash theme={null}13```bash theme={null}

14claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"14claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"

15```15```

16 16

17Diese Seite behandelt die Verwendung des Agent SDK über die CLI (`claude -p`). Für die Python- und TypeScript-SDK-Pakete mit strukturierten Ausgaben, Tool-Genehmigungsrückrufen und nativen Nachrichtenobjekten siehe die [vollständige Agent SDK-Dokumentation](/de/agent-sdk/overview).17Diese Seite behandelt die Verwendung des Agent SDK über die CLI (`claude -p`). Für die Python- und TypeScript-SDK-Pakete mit strukturierten Ausgaben, Tool-Genehmigungsrückrufen und nativen Nachrichtenobjekten siehe die [vollständige Agent SDK-Dokumentation](/docs/de/agent-sdk/overview).

18 18

19<h2 id="basic-usage">19<h2 id="basic-usage">

20 Grundlegende Verwendung20 Grundlegende Verwendung

21</h2>21</h2>

22 22

~~23Fügen Sie das Flag `-p` (oder `--print`) zu jedem `claude`-Befehl hinzu, um ihn nicht interaktiv auszuführen. Alle [CLI-Optionen](/de/cli-reference) funktionieren mit `-p`, einschließlich:~~23Fügen Sie das Flag `-p` (oder `--print`) zu jedem `claude`-Befehl hinzu, um ihn nicht interaktiv auszuführen. Alle [CLI-Optionen](/docs/de/cli-reference) funktionieren mit `-p`, einschließlich:

24 24

25* `--continue` zum [Fortsetzen von Gesprächen](#continue-conversations)25* `--continue` zum [Fortsetzen von Gesprächen](#continue-conversations)

26* `--allowedTools` zum [automatischen Genehmigen von Tools](#auto-approve-tools)26* `--allowedTools` zum [automatischen Genehmigen von Tools](#auto-approve-tools)

36 Schneller starten mit Bare-Modus36 Schneller starten mit Bare-Modus

37</h3>37</h3>

38 38

39Fügen Sie `--bare` hinzu, um die Startzeit zu verkürzen, indem Sie die automatische Erkennung von hooks, skills, plugins, MCP-Servern, automatischem Speicher und CLAUDE.md überspringen. Ohne diese Option lädt `claude -p` den gleichen [Kontext](/de/how-claude-code-works#the-context-window), den eine interaktive Sitzung hätte, einschließlich alles, was im Arbeitsverzeichnis oder in `~/.claude` konfiguriert ist.39Fügen Sie `--bare` hinzu, um die Startzeit zu verkürzen, indem Sie die automatische Erkennung von hooks, skills, plugins, MCP-Servern, automatischem Speicher und CLAUDE.md überspringen. Ohne diese Option lädt `claude -p` den gleichen [Kontext](/docs/de/how-claude-code-works#the-context-window), den eine interaktive Sitzung hätte, einschließlich alles, was im Arbeitsverzeichnis oder in `~/.claude` konfiguriert ist.

40 40

41Der Bare-Modus ist nützlich für CI und Skripte, bei denen Sie auf jedem Computer das gleiche Ergebnis benötigen. Ein hook in der `~/.claude` eines Teamkollegen oder ein MCP-Server in der `.mcp.json` des Projekts werden nicht ausgeführt, da der Bare-Modus diese nie liest. Nur Flags, die Sie explizit übergeben, haben Auswirkungen.41Der Bare-Modus ist nützlich für CI und Skripte, bei denen Sie auf jedem Computer das gleiche Ergebnis benötigen. Ein hook in der `~/.claude` eines Teamkollegen oder ein MCP-Server in der `.mcp.json` des Projekts werden nicht ausgeführt, da der Bare-Modus diese nie liest. Nur Flags, die Sie explizit übergeben, haben Auswirkungen.

42 42

66 Hintergrundaufgaben beim Beenden66 Hintergrundaufgaben beim Beenden

67</h3>67</h3>

68 68

69Wenn Claude während einer `claude -p`-Ausführung eine [Hintergrund-Bash-Aufgabe](/de/tools-reference#bash-tool-behavior) startet, beispielsweise einen Entwicklungsserver oder einen Watch-Build, wird diese Aufgabe etwa fünf Sekunden nach der Rückgabe des endgültigen Ergebnisses durch Claude und dem Schließen von stdin beendet. Die Kulanzfrist ermöglicht es einer Aufgabe, die direkt nach dem Ergebnis endet, ihre Ausgabe noch zu liefern. Vor v2.1.163 würde ein nie endender Hintergrundprozess die `claude -p`-Invokation auf unbestimmte Zeit offen halten.69Wenn Claude während einer `claude -p`-Ausführung eine [Hintergrund-Bash-Aufgabe](/docs/de/tools-reference#bash-tool-behavior) startet, beispielsweise einen Entwicklungsserver oder einen Watch-Build, wird diese Aufgabe etwa fünf Sekunden nach der Rückgabe des endgültigen Ergebnisses durch Claude und dem Schließen von stdin beendet. Die Kulanzfrist ermöglicht es einer Aufgabe, die direkt nach dem Ergebnis endet, ihre Ausgabe noch zu liefern. Vor v2.1.163 würde ein nie endender Hintergrundprozess die `claude -p`-Invokation auf unbestimmte Zeit offen halten.

70 70

71Hintergrund-[Subagenten](/de/sub-agents) und Workflows sind von der fünfsekündigen Kulanzfrist ausgenommen, da ihr Ergebnis Teil der endgültigen Ausgabe ist, daher wartet `claude -p` auf deren Abschluss. Ab v2.1.182 ist dieses Warten standardmäßig auf zehn Minuten begrenzt, damit ein feststeckender Hintergrund-Agent den Prozess nicht auf unbestimmte Zeit offen halten kann. Passen Sie die Obergrenze mit [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/de/env-vars) an, oder setzen Sie sie auf `0`, um unbegrenzt zu warten.71Hintergrund-[Subagenten](/docs/de/sub-agents) und Workflows sind von der fünfsekündigen Kulanzfrist ausgenommen, da ihr Ergebnis Teil der endgültigen Ausgabe ist, daher wartet `claude -p` auf deren Abschluss. Ab v2.1.182 ist dieses Warten standardmäßig auf zehn Minuten begrenzt, damit ein feststeckender Hintergrund-Agent den Prozess nicht auf unbestimmte Zeit offen halten kann. Passen Sie die Obergrenze mit [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/docs/de/env-vars) an, oder setzen Sie sie auf `0`, um unbegrenzt zu warten.

72 72

73<h2 id="examples">73<h2 id="examples">

74 Beispiele74 Beispiele

88cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt88cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

89```89```

90 90

91Mit `--output-format json` enthält die Antwort-Payload `total_cost_usd` und eine Kostenaufschlüsselung pro Modell, sodass skriptgesteuerte Aufrufer die Ausgaben pro Aufruf verfolgen können, ohne das [Nutzungs-Dashboard](/de/costs) zu konsultieren.91Mit `--output-format json` enthält die Antwort-Payload `total_cost_usd` und eine Kostenaufschlüsselung pro Modell, sodass skriptgesteuerte Aufrufer die Ausgaben pro Aufruf verfolgen können, ohne das [Nutzungs-Dashboard](/docs/de/costs) zu konsultieren.

92 92

93<Note>93<Note>

94 Ab Claude Code v2.1.128 ist eingeleiter stdin auf 10 MB begrenzt. Wenn Sie die Grenze überschreiten, beendet sich Claude Code mit einer klaren Fehlermeldung und einem Nicht-Null-Status. Um mit größeren Eingaben zu arbeiten, schreiben Sie den Inhalt in eine Datei und verweisen Sie auf den Dateipfad in Ihrer Eingabeaufforderung, anstatt ihn einzuleiten.94 Ab Claude Code v2.1.128 ist eingeleiter stdin auf 10 MB begrenzt. Wenn Sie die Grenze überschreiten, beendet sich Claude Code mit einer klaren Fehlermeldung und einem Nicht-Null-Status. Um mit größeren Eingaben zu arbeiten, schreiben Sie den Inhalt in eine Datei und verweisen Sie auf den Dateipfad in Ihrer Eingabeaufforderung, anstatt ihn einzuleiten.

163claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages163claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages

164```164```

165 165

166Die letzte Zeile des Streams ist eine `result`-Nachricht mit dem endgültigen Antworttext, den Kosten und den Sitzungsmetadaten. {/* min-version: 2.1.208 */}Vor v2.1.208 konnte das Piping einer großen Antwort die letzte Zeile abschneiden und die `result`-Nachricht weglassen.166Die letzte Zeile des Streams ist eine `result`-Nachricht mit dem endgültigen Antworttext, den Kosten und den Sitzungsmetadaten. Vor v2.1.208 konnte das Piping einer großen Antwort die letzte Zeile abschneiden und die `result`-Nachricht weglassen.

167 167

168Das folgende Beispiel verwendet [jq](https://jqlang.github.io/jq/), um nach Text-Deltas zu filtern und nur den Streaming-Text anzuzeigen. Das Flag `-r` gibt Rohzeichenketten aus (keine Anführungszeichen) und `-j` verbindet ohne Zeilenumbrüche, sodass Token kontinuierlich gestreamt werden:168Das folgende Beispiel verwendet [jq](https://jqlang.github.io/jq/), um nach Text-Deltas zu filtern und nur den Streaming-Text anzuzeigen. Das Flag `-r` gibt Rohzeichenketten aus (keine Anführungszeichen) und `-j` verbindet ohne Zeilenumbrüche, sodass Token kontinuierlich gestreamt werden:

169 169

188 188

189Das `system/init`-Ereignis meldet Sitzungsmetadaten einschließlich des Modells, Tools, MCP-Server und geladener Plugins. Es ist das erste Ereignis im Stream, es sei denn, Startereignisse gehen ihm voraus:189Das `system/init`-Ereignis meldet Sitzungsmetadaten einschließlich des Modells, Tools, MCP-Server und geladener Plugins. Es ist das erste Ereignis im Stream, es sei denn, Startereignisse gehen ihm voraus:

190 190

191* `plugin_install`-Ereignisse, wenn [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/de/env-vars) gesetzt ist.191* `plugin_install`-Ereignisse, wenn [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/de/env-vars) gesetzt ist.

192* {/* min-version: 2.1.204 */}[`hook_started`-, `hook_progress`- und `hook_response`-Ereignisse](/de/agent-sdk/typescript#sdkhookstartedmessage), während ein konfigurierter [`SessionStart`](/de/hooks#sessionstart)- oder [`Setup`](/de/hooks#setup)-Hook ausgeführt wird. Diese werden gestreamt, während der Hook sie erzeugt. Claude Code v2.1.169 bis v2.1.203 lieferte sie in einem Batch nach Abschluss des Hooks, immer noch vor `system/init`; v2.1.204 stellte die Live-Lieferung wieder her.192* [`hook_started`-, `hook_progress`- und `hook_response`-Ereignisse](/docs/de/agent-sdk/typescript#sdkhookstartedmessage), während ein konfigurierter [`SessionStart`](/docs/de/hooks#sessionstart)- oder [`Setup`](/docs/de/hooks#setup)-Hook ausgeführt wird. Diese werden gestreamt, während der Hook sie erzeugt. Claude Code v2.1.169 bis v2.1.203 lieferte sie in einem Batch nach Abschluss des Hooks, immer noch vor `system/init`; v2.1.204 stellte die Live-Lieferung wieder her.

193 193

194Das Ereignis enthält auch ein optionales Array `capabilities` von Zeichenketten, das die Protokollverhalten benennt, die diese Claude Code-Version implementiert, wie `interrupt_receipt_v1`. Überprüfen Sie es, um Funktionen zu erkennen, anstatt Versionsnummern zu vergleichen, und ignorieren Sie Werte, die Sie nicht erkennen. Das Feld erfordert Claude Code v2.1.205 oder später und fehlt in früheren Versionen. Siehe [`SDKSystemMessage`](/de/agent-sdk/typescript#sdksystemmessage) für die Funktionsliste.194Das Ereignis enthält auch ein optionales Array `capabilities` von Zeichenketten, das die Protokollverhalten benennt, die diese Claude Code-Version implementiert, wie `interrupt_receipt_v1`. Überprüfen Sie es, um Funktionen zu erkennen, anstatt Versionsnummern zu vergleichen, und ignorieren Sie Werte, die Sie nicht erkennen. Das Feld erfordert Claude Code v2.1.205 oder später und fehlt in früheren Versionen. Siehe [`SDKSystemMessage`](/docs/de/agent-sdk/typescript#sdksystemmessage) für die Funktionsliste.

195 195

196Verwenden Sie die Plugin-Felder, um CI fehlschlagen zu lassen, wenn ein Plugin nicht geladen wurde:196Verwenden Sie die Plugin-Felder, um CI fehlschlagen zu lassen, wenn ein Plugin nicht geladen wurde:

197 197

201| `plugin_errors` | Array | Plugin-Ladefehler, jeweils mit `plugin`, `type` und `message`. Umfasst nicht erfüllte Abhängigkeitsversionen und `--plugin-dir`-Ladefehler wie einen fehlenden Pfad oder ein ungültiges Archiv. Betroffene Plugins werden herabgestuft und fehlen in `plugins`. Der Schlüssel wird weggelassen, wenn es keine Fehler gibt |201| `plugin_errors` | Array | Plugin-Ladefehler, jeweils mit `plugin`, `type` und `message`. Umfasst nicht erfüllte Abhängigkeitsversionen und `--plugin-dir`-Ladefehler wie einen fehlenden Pfad oder ein ungültiges Archiv. Betroffene Plugins werden herabgestuft und fehlen in `plugins`. Der Schlüssel wird weggelassen, wenn es keine Fehler gibt |

202 202

203Wenn [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/de/env-vars) gesetzt ist, gibt Claude Code `system/plugin_install`-Ereignisse aus, während Marketplace-Plugins vor dem ersten Zug installiert werden. Verwenden Sie diese, um Installationsfortschritt in Ihrer eigenen Benutzeroberfläche anzuzeigen.203Wenn [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/de/env-vars) gesetzt ist, gibt Claude Code `system/plugin_install`-Ereignisse aus, während Marketplace-Plugins vor dem ersten Zug installiert werden. Verwenden Sie diese, um Installationsfortschritt in Ihrer eigenen Benutzeroberfläche anzuzeigen.

204 204

205| Feld | Typ | Beschreibung |205| Feld | Typ | Beschreibung |

206| ------------ | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |206| ------------ | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |

214 214

215Für programmgesteuertes Streaming mit Rückrufen und Nachrichtenobjekten siehe [Antworten in Echtzeit streamen](/de/agent-sdk/streaming-output) in der Agent SDK-Dokumentation.215Für programmgesteuertes Streaming mit Rückrufen und Nachrichtenobjekten siehe [Antworten in Echtzeit streamen](/docs/de/agent-sdk/streaming-output) in der Agent SDK-Dokumentation.

216 216

217<h3 id="auto-approve-tools">217<h3 id="auto-approve-tools">

218 Tools automatisch genehmigen218 Tools automatisch genehmigen

225 --allowedTools "Bash,Read,Edit"225 --allowedTools "Bash,Read,Edit"

226```226```

227 227

228Um einen Baseline für die gesamte Sitzung festzulegen, anstatt einzelne Tools aufzulisten, übergeben Sie einen [Berechtigungsmodus](/de/permission-modes). `dontAsk` verweigert alles, das nicht in Ihren `permissions.allow`-Regeln oder dem [schreibgeschützten Befehlssatz](/de/permissions#read-only-commands) enthalten ist, was für gesperrte CI-Läufe nützlich ist. `AskUserQuestion`, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und MCP-Tools, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, werden verweigert, auch wenn eine Allow-Regel passt.228Um einen Baseline für die gesamte Sitzung festzulegen, anstatt einzelne Tools aufzulisten, übergeben Sie einen [Berechtigungsmodus](/docs/de/permission-modes). `dontAsk` verweigert alles, das nicht in Ihren `permissions.allow`-Regeln oder dem [schreibgeschützten Befehlssatz](/docs/de/permissions#read-only-commands) enthalten ist, was für gesperrte CI-Läufe nützlich ist. `AskUserQuestion`, Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, werden verweigert, auch wenn eine Allow-Regel passt.

229 229

230`acceptEdits` ermöglicht Claude, Dateien ohne Aufforderung zu schreiben, und genehmigt auch automatisch häufige Dateisystembefehle wie `mkdir`, `touch`, `mv` und `cp`. Andere Shell-Befehle und Netzwerkanfragen benötigen immer noch einen `--allowedTools`-Eintrag oder eine `permissions.allow`-Regel, andernfalls wird der Lauf abgebrochen, wenn einer versucht wird:230`acceptEdits` ermöglicht Claude, Dateien ohne Aufforderung zu schreiben, und genehmigt auch automatisch häufige Dateisystembefehle wie `mkdir`, `touch`, `mv` und `cp`. Andere Shell-Befehle und Netzwerkanfragen benötigen immer noch einen `--allowedTools`-Eintrag oder eine `permissions.allow`-Regel, andernfalls wird der Lauf abgebrochen, wenn einer versucht wird:

231 231

244 --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"244 --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"

245```245```

246 246

247Das Flag `--allowedTools` verwendet [Berechtigungsregelsyntax](/de/settings#permission-rule-syntax). Das nachfolgende ` *` ermöglicht Präfix-Matching, sodass `Bash(git diff *)` jeden Befehl erlaubt, der mit `git diff` beginnt. Das Leerzeichen vor `*` ist wichtig: ohne es würde `Bash(git diff*)` auch `git diff-index` entsprechen.247Das Flag `--allowedTools` verwendet [Berechtigungsregelsyntax](/docs/de/settings#permission-rule-syntax). Das nachfolgende ` *` ermöglicht Präfix-Matching, sodass `Bash(git diff *)` jeden Befehl erlaubt, der mit `git diff` beginnt. Das Leerzeichen vor `*` ist wichtig: ohne es würde `Bash(git diff*)` auch `git diff-index` entsprechen.

248 248

249<Note>249<Note>

250 Benutzer-aufgerufene [skills](/de/skills) und benutzerdefinierte Befehle funktionieren im `-p`-Modus: Fügen Sie `/skill-name` in die Eingabeaufforderungszeichenkette ein und Claude Code erweitert sie vor dem Ausführen. Integrierte Befehle, die nur in der Terminalschnittstelle ausgeführt werden, wie `/login`, sind im `-p`-Modus nicht verfügbar. {/* min-version: 2.1.205 */}`/model`, `/effort`, `/fast`, `/color` und `/rename` akzeptieren den Wert als Argument, zum Beispiel `/model sonnet`, und `/mcp` ohne Argument gibt eine Textzusammenfassung des Serverstatus aus; diese Formen erfordern Claude Code v2.1.205 oder später und folgen den [Verfügbarkeitshinweisen](/de/commands#all-commands) jedes Befehls. {/* min-version: 2.1.181 */}Um eine Einstellung von einer `-p`-Aufruf zu ändern, übergeben Sie `key=value` an `/config`, zum Beispiel `/config thinking=false`.250 Benutzer-aufgerufene [skills](/docs/de/skills) und benutzerdefinierte Befehle funktionieren im `-p`-Modus: Fügen Sie `/skill-name` in die Eingabeaufforderungszeichenkette ein und Claude Code erweitert sie vor dem Ausführen. Integrierte Befehle, die nur in der Terminalschnittstelle ausgeführt werden, wie `/login`, sind im `-p`-Modus nicht verfügbar. `/model`, `/effort`, `/fast`, `/color` und `/rename` akzeptieren den Wert als Argument, zum Beispiel `/model sonnet`, und `/mcp` ohne Argument gibt eine Textzusammenfassung des Serverstatus aus; diese Formen erfordern Claude Code v2.1.205 oder später und folgen den [Verfügbarkeitshinweisen](/docs/de/commands#all-commands) jedes Befehls. Um eine Einstellung von einer `-p`-Aufruf zu ändern, übergeben Sie `key=value` an `/config`, zum Beispiel `/config thinking=false`.

251</Note>251</Note>

252 252

253<h3 id="customize-the-system-prompt">253<h3 id="customize-the-system-prompt">

262 --output-format json262 --output-format json

263```263```

264 264

265Siehe [System-Eingabeaufforderungs-Flags](/de/cli-reference#system-prompt-flags) für weitere Optionen, einschließlich `--system-prompt`, um die Standardeingabeaufforderung vollständig zu ersetzen.265Siehe [System-Eingabeaufforderungs-Flags](/docs/de/cli-reference#system-prompt-flags) für weitere Optionen, einschließlich `--system-prompt`, um die Standardeingabeaufforderung vollständig zu ersetzen.

266 266

267<h3 id="continue-conversations">267<h3 id="continue-conversations">

268 Gespräche fortsetzen268 Gespräche fortsetzen

286claude -p "Continue that review" --resume "$session_id"286claude -p "Continue that review" --resume "$session_id"

287```287```

288 288

289Führen Sie beide Befehle aus demselben Verzeichnis aus: Die Sitzungs-ID-Suche ist auf das aktuelle Projektverzeichnis und seine Git-Worktrees beschränkt. Siehe [Eine Sitzung fortsetzen](/de/sessions#resume-a-session) für die vollständigen Bereichsregeln.289Führen Sie beide Befehle aus demselben Verzeichnis aus: Die Sitzungs-ID-Suche ist auf das aktuelle Projektverzeichnis und seine Git-Worktrees beschränkt. Siehe [Eine Sitzung fortsetzen](/docs/de/sessions#resume-a-session) für die vollständigen Bereichsregeln.

290 290

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

292 Nächste Schritte292 Nächste Schritte

293</h2>293</h2>

294 294

295* [Agent SDK Schnellstart](/de/agent-sdk/quickstart): Erstellen Sie Ihren ersten Agent mit Python oder TypeScript295* [Agent SDK Schnellstart](/docs/de/agent-sdk/quickstart): Erstellen Sie Ihren ersten Agent mit Python oder TypeScript

296* [CLI-Referenz](/de/cli-reference): alle CLI-Flags und Optionen296* [CLI-Referenz](/docs/de/cli-reference): alle CLI-Flags und Optionen

297* [GitHub Actions](/de/github-actions): Verwenden Sie das Agent SDK in GitHub-Workflows297* [GitHub Actions](/docs/de/github-actions): Verwenden Sie das Agent SDK in GitHub-Workflows

298* [GitLab CI/CD](/de/gitlab-ci-cd): Verwenden Sie das Agent SDK in GitLab-Pipelines298* [GitLab CI/CD](/docs/de/gitlab-ci-cd): Verwenden Sie das Agent SDK in GitLab-Pipelines

hooks.md +7 −7

Details

326 326

327Alle passenden Hooks werden parallel ausgeführt, und identische Handler werden automatisch dedupliziert. Command-Hooks werden nach Befehlszeichenkette und `args` dedupliziert, und HTTP-Hooks werden nach URL dedupliziert.327Alle passenden Hooks werden parallel ausgeführt, und identische Handler werden automatisch dedupliziert. Command-Hooks werden nach Befehlszeichenkette und `args` dedupliziert, und HTTP-Hooks werden nach URL dedupliziert.

328 328

329Handler werden im aktuellen Verzeichnis mit der Umgebung von Claude Code ausgeführt. Die Umgebungsvariable `$CLAUDE_CODE_REMOTE` wird in Remote-Web-Umgebungen auf `"true"` gesetzt und ist in der lokalen CLI nicht gesetzt. {/* min-version: 2.1.199 */}Ab v2.1.199 wird [`$CLAUDE_CODE_BRIDGE_SESSION_ID`](/docs/de/env-vars) auf die [Remote Control](/docs/de/remote-control) Sitzungs-ID gesetzt, während die lokale Sitzung eine aktive Remote Control-Verbindung hat.329Handler werden im aktuellen Verzeichnis mit der Umgebung von Claude Code ausgeführt. Die Umgebungsvariable `$CLAUDE_CODE_REMOTE` wird in Remote-Web-Umgebungen auf `"true"` gesetzt und ist in der lokalen CLI nicht gesetzt. Ab v2.1.199 wird [`$CLAUDE_CODE_BRIDGE_SESSION_ID`](/docs/de/env-vars) auf die [Remote Control](/docs/de/remote-control) Sitzungs-ID gesetzt, während die lokale Sitzung eine aktive Remote Control-Verbindung hat.

330 330

331<h4 id="common-fields">331<h4 id="common-fields">

332 Gemeinsame Felder332 Gemeinsame Felder

645| :---------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |645| :---------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

647| `prompt_id` | UUID, die die aktuell verarbeitete Benutzereingabeaufforderung identifiziert. Entspricht dem [`prompt.id`-Attribut bei OpenTelemetry-Ereignissen](/docs/de/monitoring-usage#event-correlation-attributes), sodass Sie Hook-Ausgabe mit Telemetrie für eine einzelne Eingabeaufforderung korrelieren können. Nicht vorhanden, bis zur ersten Benutzereingabe. {/* min-version: 2.1.196 */}Erfordert Claude Code v2.1.196 oder später |647| `prompt_id` | UUID, die die aktuell verarbeitete Benutzereingabeaufforderung identifiziert. Entspricht dem [`prompt.id`-Attribut bei OpenTelemetry-Ereignissen](/docs/de/monitoring-usage#event-correlation-attributes), sodass Sie Hook-Ausgabe mit Telemetrie für eine einzelne Eingabeaufforderung korrelieren können. Nicht vorhanden, bis zur ersten Benutzereingabe. Erfordert Claude Code v2.1.196 oder später |

648| `transcript_path` | Pfad zur Gesprächs-JSON. Die Transkriptdatei wird asynchron geschrieben und kann der In-Memory-Konversation hinterherhinken, sodass sie möglicherweise noch nicht die neuesten Nachrichten des aktuellen Zugs enthält, wenn ein Hook ausgelöst wird. Hooks, die den endgültigen Assistententext des aktuellen Zugs benötigen, sollten `last_assistant_message` auf [Stop](#stop) und [SubagentStop](#subagentstop) verwenden, anstatt das Transkript zu lesen |648| `transcript_path` | Pfad zur Gesprächs-JSON. Die Transkriptdatei wird asynchron geschrieben und kann der In-Memory-Konversation hinterherhinken, sodass sie möglicherweise noch nicht die neuesten Nachrichten des aktuellen Zugs enthält, wenn ein Hook ausgelöst wird. Hooks, die den endgültigen Assistententext des aktuellen Zugs benötigen, sollten `last_assistant_message` auf [Stop](#stop) und [SubagentStop](#subagentstop) verwenden, anstatt das Transkript zu lesen |

649| `cwd` | Aktuelles Arbeitsverzeichnis, wenn der Hook aufgerufen wird |649| `cwd` | Aktuelles Arbeitsverzeichnis, wenn der Hook aufgerufen wird |

650| `permission_mode` | Aktueller [Berechtigungsmodus](/docs/de/permissions#permission-modes): `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` oder `"bypassPermissions"`. Der als **Manuell** bezeichnete Modus kommt als `"default"` an, nie als `"manual"`, sodass Skripte, die `"default"` abgleichen, weiterhin funktionieren. Nicht alle Ereignisse erhalten dieses Feld. Überprüfen Sie das JSON-Beispiel in jedem Abschnitt [Hook-Ereignis](#hook-events) |650| `permission_mode` | Aktueller [Berechtigungsmodus](/docs/de/permissions#permission-modes): `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` oder `"bypassPermissions"`. Der als **Manuell** bezeichnete Modus kommt als `"default"` an, nie als `"manual"`, sodass Skripte, die `"default"` abgleichen, weiterhin funktionieren. Nicht alle Ereignisse erhalten dieses Feld. Überprüfen Sie das JSON-Beispiel in jedem Abschnitt [Hook-Ereignis](#hook-events) |

1569In `PostToolUse` trägt `tool_response` für einen abgeschlossenen Agent-Aufruf den abschließenden Text des Subagenten zusammen mit Nutzungstelemetrie. Lesen Sie diese Felder, um Pro-Subagent-Kosten aus einem Hook zu erfassen:1569In `PostToolUse` trägt `tool_response` für einen abgeschlossenen Agent-Aufruf den abschließenden Text des Subagenten zusammen mit Nutzungstelemetrie. Lesen Sie diese Felder, um Pro-Subagent-Kosten aus einem Hook zu erfassen:

1570 1570

1571| Feld | Typ | Beispiel | Beschreibung |1571| Feld | Typ | Beispiel | Beschreibung |

1572| :------------------ | :----------- | :---------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1572| :------------------ | :----------- | :---------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

1573| `status` | Zeichenkette | `"completed"` | `"completed"` für Vordergrund-Subagenten, `"async_launched"` für Hintergrund-Subagenten. {/* min-version: 2.1.198 */}Ab v2.1.198 werden Subagenten standardmäßig im Hintergrund ausgeführt, daher erzeugt ein weggelassenes `run_in_background` auch `"async_launched"` |1573| `status` | Zeichenkette | `"completed"` | `"completed"` für Vordergrund-Subagenten, `"async_launched"` für Hintergrund-Subagenten. Ab v2.1.198 werden Subagenten standardmäßig im Hintergrund ausgeführt, daher erzeugt ein weggelassenes `run_in_background` auch `"async_launched"` |

1575| `content` | Array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Die abschließenden Textblöcke des Subagenten |1575| `content` | Array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Die abschließenden Textblöcke des Subagenten |

1576| `resolvedModel` | Zeichenkette | `"claude-sonnet-4-5"` | Modell, auf dem der Subagent ausgeführt wurde, das sich vom angeforderten Modell unterscheiden kann. {/* min-version: 2.1.174 */}Erfordert Claude Code v2.1.174 oder später |1576| `resolvedModel` | Zeichenkette | `"claude-sonnet-4-5"` | Modell, auf dem der Subagent ausgeführt wurde, das sich vom angeforderten Modell unterscheiden kann. Erfordert Claude Code v2.1.174 oder später |

1764Das Ausgabefeld `updatedPermissions` und das [`permission_suggestions`-Eingabefeld](#permissionrequest-input) verwenden beide das gleiche Array von Einträgen. Jeder Eintrag hat einen `type`, der seine anderen Felder bestimmt, und ein `destination`, das steuert, wo die Änderung geschrieben wird.1764Das Ausgabefeld `updatedPermissions` und das [`permission_suggestions`-Eingabefeld](#permissionrequest-input) verwenden beide das gleiche Array von Einträgen. Jeder Eintrag hat einen `type`, der seine anderen Felder bestimmt, und ein `destination`, das steuert, wo die Änderung geschrieben wird.

1765 1765

1767| :------------------ | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1767| :------------------ | :--------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1768| `addRules` | `rules`, `behavior`, `destination` | Fügt Berechtigungsregeln hinzu. `rules` ist ein Array von `{toolName, ruleContent?}` Objekten. Lassen Sie `ruleContent` weg, um das ganze Tool zu treffen. `behavior` ist `"allow"`, `"deny"` oder `"ask"` |1768| `addRules` | `rules`, `behavior`, `destination` | Fügt Berechtigungsregeln hinzu. `rules` ist ein Array von `{toolName, ruleContent?}` Objekten. Lassen Sie `ruleContent` weg, um das ganze Tool zu treffen. `behavior` ist `"allow"`, `"deny"` oder `"ask"` |

1771| `setMode` | `mode`, `destination` | Ändert den Berechtigungsmodus. Gültige Modi sind `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` und {/* min-version: 2.1.200 */}`manual` als Alias für `default`. Der Alias `manual` erfordert Claude Code v2.1.200 oder später |1771| `setMode` | `mode`, `destination` | Ändert den Berechtigungsmodus. Gültige Modi sind `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` und `manual` als Alias für `default`. Der Alias `manual` erfordert Claude Code v2.1.200 oder später |

1774 1774

hooks-guide.md +1 −1

Details

654}654}

655```655```

656 656

657Der `"Edit|Write"`-Matcher wird ausgelöst, wenn Claude das `Edit`- oder `Write`-Tool verwendet, nicht wenn es `Bash`, `Read` oder ein anderes Tool verwendet. {/* min-version: 2.1.191 */}In Claude Code v2.1.191 oder später trennt ein Komma Alternativen auf die gleiche Weise, sodass `"Edit, Write"` gleichwertig ist. Siehe [Matcher-Muster](/docs/de/hooks#matcher-patterns) für die Auswertung von einfachen Namen und regulären Ausdrücken.657Der `"Edit|Write"`-Matcher wird ausgelöst, wenn Claude das `Edit`- oder `Write`-Tool verwendet, nicht wenn es `Bash`, `Read` oder ein anderes Tool verwendet. In Claude Code v2.1.191 oder später trennt ein Komma Alternativen auf die gleiche Weise, sodass `"Edit, Write"` gleichwertig ist. Siehe [Matcher-Muster](/docs/de/hooks#matcher-patterns) für die Auswertung von einfachen Namen und regulären Ausdrücken.

658 658

659<Note>659<Note>

660 Claude kann auch Dateien erstellen oder ändern, indem er Shell-Befehle über das `Bash`-Tool ausführt. Wenn Ihr Hook jede Dateiänderung sehen muss, z. B. für Compliance-Scanning oder Audit-Protokollierung, fügen Sie einen [`Stop`](/docs/de/hooks#stop)-Hook hinzu, der den Arbeitsbaum einmal pro Runde scannt. Für Pro-Aufruf-Abdeckung stattdessen auch `Bash` abgleichen und Ihr Skript geänderte und nicht verfolgte Dateien mit `git status --porcelain` auflisten.660 Claude kann auch Dateien erstellen oder ändern, indem er Shell-Befehle über das `Bash`-Tool ausführt. Wenn Ihr Hook jede Dateiänderung sehen muss, z. B. für Compliance-Scanning oder Audit-Protokollierung, fügen Sie einen [`Stop`](/docs/de/hooks#stop)-Hook hinzu, der den Arbeitsbaum einmal pro Runde scannt. Für Pro-Aufruf-Abdeckung stattdessen auch `Bash` abgleichen und Ihr Skript geänderte und nicht verfolgte Dateien mit `git status --porcelain` auflisten.

interactive-mode.md +42 −42

Details

11</h2>11</h2>

12 12

13<Note>13<Note>

~~14 Tastaturkürzel können je nach Plattform und Terminal variieren. Im [Vollbildrendering](/de/fullscreen) drücken Sie `?` im Transkript-Viewer, um die verfügbaren Kürzel dort anzuzeigen.~~14 Tastaturkürzel können je nach Plattform und Terminal variieren. Im [Vollbildrendering](/docs/de/fullscreen) drücken Sie `?` im Transkript-Viewer, um die verfügbaren Kürzel dort anzuzeigen.

15 15

16 **macOS-Benutzer**: Option/Alt-Tastenkürzel (`Alt+B`, `Alt+F`, `Alt+Y`, `Alt+M`, `Alt+P`) erfordern die Konfiguration von Option als Meta in Ihrem Terminal:16 **macOS-Benutzer**: Option/Alt-Tastenkürzel (`Alt+B`, `Alt+F`, `Alt+Y`, `Alt+M`, `Alt+P`) erfordern die Konfiguration von Option als Meta in Ihrem Terminal:

17 17

19 * **Apple Terminal**: Einstellungen → Profile → Keyboard → „Use Option as Meta Key" aktivieren19 * **Apple Terminal**: Einstellungen → Profile → Keyboard → „Use Option as Meta Key" aktivieren

20 * **VS Code**: `"terminal.integrated.macOptionIsMeta": true` in VS Code-Einstellungen setzen20 * **VS Code**: `"terminal.integrated.macOptionIsMeta": true` in VS Code-Einstellungen setzen

21 21

~~22 Weitere Informationen finden Sie unter [Terminal-Konfiguration](/de/terminal-config).~~22 Weitere Informationen finden Sie unter [Terminal-Konfiguration](/docs/de/terminal-config).

23</Note>23</Note>

24 24

25<h3 id="general-controls">25<h3 id="general-controls">

27</h3>27</h3>

28 28

30| :------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |30| :------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

31| `Ctrl+C` | Unterbrechen oder Eingabe löschen | Unterbricht einen laufenden Vorgang. Wenn nichts läuft, löscht der erste Tastendruck die Eingabeaufforderung und ein zweiter Tastendruck beendet Claude Code |31| `Ctrl+C` | Unterbrechen oder Eingabe löschen | Unterbricht einen laufenden Vorgang. Wenn nichts läuft, löscht der erste Tastendruck die Eingabeaufforderung und ein zweiter Tastendruck beendet Claude Code |

32| `Ctrl+X Ctrl+K` | Alle laufenden [Hintergrund-Subagenten](/de/sub-agents#run-subagents-in-foreground-or-background) in dieser Sitzung beenden. Zweimal innerhalb von 3 Sekunden drücken, um zu bestätigen | Subagenten-Steuerung |32| `Ctrl+X Ctrl+K` | Alle laufenden [Hintergrund-Subagenten](/docs/de/sub-agents#run-subagents-in-foreground-or-background) in dieser Sitzung beenden. Zweimal innerhalb von 3 Sekunden drücken, um zu bestätigen | Subagenten-Steuerung |

34| `Ctrl+G` oder `Ctrl+X Ctrl+E` | Im Standard-Texteditor öffnen | Bearbeiten Sie Ihren Prompt oder benutzerdefinierte Antwort in Ihrem Standard-Texteditor. `Ctrl+X Ctrl+E` ist die readline-native Bindung. Aktivieren Sie „Show last response in external editor" in `/config`, um Claudes vorherige Antwort als `#`-kommentierter Kontext über Ihrem Prompt einzufügen; der Kommentarblock wird beim Speichern entfernt |34| `Ctrl+G` oder `Ctrl+X Ctrl+E` | Im Standard-Texteditor öffnen | Bearbeiten Sie Ihren Prompt oder benutzerdefinierte Antwort in Ihrem Standard-Texteditor. `Ctrl+X Ctrl+E` ist die readline-native Bindung. Aktivieren Sie „Show last response in external editor" in `/config`, um Claudes vorherige Antwort als `#`-kommentierter Kontext über Ihrem Prompt einzufügen; der Kommentarblock wird beim Speichern entfernt |

35| `Ctrl+L` | Bildschirm neu zeichnen | Erzwingt eine vollständige Terminal-Neuzeichnung. Eingabe und Gesprächsverlauf werden beibehalten. Verwenden Sie dies, um die Anzeige wiederherzustellen, wenn sie verzerrt oder teilweise leer wird |35| `Ctrl+L` | Bildschirm neu zeichnen | Erzwingt eine vollständige Terminal-Neuzeichnung. Eingabe und Gesprächsverlauf werden beibehalten. Verwenden Sie dies, um die Anzeige wiederherzustellen, wenn sie verzerrt oder teilweise leer wird |

38| `Ctrl+V` oder `Cmd+V` (iTerm2) oder `Alt+V` (Windows und WSL) | Bild aus Zwischenablage einfügen | Fügt einen `[Image #N]`-Chip an der Cursor-Position ein, sodass Sie ihn positionell in Ihrem Prompt referenzieren können. Unter WSL sind sowohl `Ctrl+V` als auch `Alt+V` gebunden; verwenden Sie `Alt+V`, wenn Ihr Terminal `Ctrl+V` abfängt |38| `Ctrl+V` oder `Cmd+V` (iTerm2) oder `Alt+V` (Windows und WSL) | Bild aus Zwischenablage einfügen | Fügt einen `[Image #N]`-Chip an der Cursor-Position ein, sodass Sie ihn positionell in Ihrem Prompt referenzieren können. Unter WSL sind sowohl `Ctrl+V` als auch `Alt+V` gebunden; verwenden Sie `Alt+V`, wenn Ihr Terminal `Ctrl+V` abfängt |

40| `Ctrl+T` | Task-Liste umschalten | Zeigen oder verbergen Sie [Claudes Task-Liste](#task-list) im Statusbereich. Dies ist nicht die Hintergrund-Task-Ansicht; verwenden Sie [`/tasks`](/de/commands), um laufende Shells und Subagenten anzuzeigen |40| `Ctrl+T` | Task-Liste umschalten | Zeigen oder verbergen Sie [Claudes Task-Liste](#task-list) im Statusbereich. Dies ist nicht die Hintergrund-Task-Ansicht; verwenden Sie [`/tasks`](/docs/de/commands), um laufende Shells und Subagenten anzuzeigen |

42| `Up/Down arrows` oder `Ctrl+P`/`Ctrl+N` | Cursor bewegen oder Befehlsverlauf navigieren | Wenn die Eingabe mehr als eine visuelle Zeile umfasst, ob umgebrochen oder mehrzeilig, bewegt sich der Cursor zunächst innerhalb der Eingabeaufforderung. Sobald sich der Cursor bereits am oberen oder unteren Rand befindet, navigiert das erneute Drücken durch den Befehlsverlauf. {/* min-version: 2.1.169 */}Ab v2.1.169 verhält sich umgebrochene einzeilige Eingabe genauso wie mehrzeilige Eingabe |42| `Up/Down arrows` oder `Ctrl+P`/`Ctrl+N` | Cursor bewegen oder Befehlsverlauf navigieren | Wenn die Eingabe mehr als eine visuelle Zeile umfasst, ob umgebrochen oder mehrzeilig, bewegt sich der Cursor zunächst innerhalb der Eingabeaufforderung. Sobald sich der Cursor bereits am oberen oder unteren Rand befindet, navigiert das erneute Drücken durch den Befehlsverlauf. Ab v2.1.169 verhält sich umgebrochene einzeilige Eingabe genauso wie mehrzeilige Eingabe |

43| `Esc` | Claude unterbrechen oder einen Dialog schließen | Stoppen Sie die aktuelle Antwort oder den Tool-Aufruf in der Mitte des Zuges, um umzuleiten. Claude behält die bisherige Arbeit bei. Wenn ein Dialog wie eine Berechtigungsaufforderung offen ist, schließt `Esc` den Dialog, anstatt Claude zu unterbrechen. {/* min-version: 2.1.202 */}Vor v2.1.202 unterbrach `Esc` bei einigen Dialogen Claude und ließ den Dialog offen |43| `Esc` | Claude unterbrechen oder einen Dialog schließen | Stoppen Sie die aktuelle Antwort oder den Tool-Aufruf in der Mitte des Zuges, um umzuleiten. Claude behält die bisherige Arbeit bei. Wenn ein Dialog wie eine Berechtigungsaufforderung offen ist, schließt `Esc` den Dialog, anstatt Claude zu unterbrechen. Vor v2.1.202 unterbrach `Esc` bei einigen Dialogen Claude und ließ den Dialog offen |

44| `Esc` + `Esc` | Eingabeentwurf löschen oder zurückspulen | Wenn die Eingabeaufforderung Text enthält, löscht doppeltes `Esc` sie und speichert den Entwurf im Verlauf, sodass `Up` ihn abruft. Wenn die Eingabe leer ist, öffnet doppeltes `Esc` das [Zurückspul-Menü](/de/checkpointing), um Code und Gespräch von einem vorherigen Punkt wiederherzustellen oder zusammenzufassen |44| `Esc` + `Esc` | Eingabeentwurf löschen oder zurückspulen | Wenn die Eingabeaufforderung Text enthält, löscht doppeltes `Esc` sie und speichert den Entwurf im Verlauf, sodass `Up` ihn abruft. Wenn die Eingabe leer ist, öffnet doppeltes `Esc` das [Zurückspul-Menü](/docs/de/checkpointing), um Code und Gespräch von einem vorherigen Punkt wiederherzustellen oder zusammenzufassen |

45| `Shift+Tab` oder `Alt+M` (einige Konfigurationen) | Berechtigungsmodi umschalten | Wechseln Sie zwischen `default` (mit „Manual" im Modus-Indikator gekennzeichnet), `acceptEdits`, `plan` und allen Modi, die Sie aktiviert haben, z. B. `auto` oder `bypassPermissions`. Siehe [Berechtigungsmodi](/de/permission-modes). |45| `Shift+Tab` oder `Alt+M` (einige Konfigurationen) | Berechtigungsmodi umschalten | Wechseln Sie zwischen `default` (mit „Manual" im Modus-Indikator gekennzeichnet), `acceptEdits`, `plan` und allen Modi, die Sie aktiviert haben, z. B. `auto` oder `bypassPermissions`. Siehe [Berechtigungsmodi](/docs/de/permission-modes). |

47| `Option+T` (macOS) oder `Alt+T` (Windows/Linux) | Extended Thinking umschalten | Aktivieren oder deaktivieren Sie den Extended Thinking-Modus. Hat keine Auswirkung auf Fable 5, das immer Extended Thinking verwendet. {/* min-version: 2.1.132 */}Ab v2.1.132 funktioniert dieses Kürzel auf macOS ohne Konfiguration von Option als Meta |47| `Option+T` (macOS) oder `Alt+T` (Windows/Linux) | Extended Thinking umschalten | Aktivieren oder deaktivieren Sie den Extended Thinking-Modus. Hat keine Auswirkung auf Fable 5, das immer Extended Thinking verwendet. Ab v2.1.132 funktioniert dieses Kürzel auf macOS ohne Konfiguration von Option als Meta |

49 49

50<h3 id="text-editing">50<h3 id="text-editing">

51 Textbearbeitung51 Textbearbeitung

79| :--------------- | :-------------- | :--------------------------------------------------------------------------------------------------------- |79| :--------------- | :-------------- | :--------------------------------------------------------------------------------------------------------- |

93 93

95| :------------ | :------------------ | :------------------------------------------------------------------------------------------------------------------- |95| :------------ | :------------------ | :------------------------------------------------------------------------------------------------------------------- |

98| `@` | Dateipfad-Erwähnung | Trigger für Dateipfad-Autovervollständigung |98| `@` | Dateipfad-Erwähnung | Trigger für Dateipfad-Autovervollständigung |

99 99

101 Transkript-Viewer101 Transkript-Viewer

102</h3>102</h3>

103 103

104Wenn der Transkript-Viewer offen ist (umgeschaltet mit `Ctrl+O`), sind diese Kürzel verfügbar. Im [Vollbildrendering](/de/fullscreen) drücken Sie `?`, um das vollständige Kürzel-Referenzpanel im Viewer anzuzeigen. `Ctrl+E` kann über [`transcript:toggleShowAll`](/de/keybindings) neu zugewiesen werden.104Wenn der Transkript-Viewer offen ist (umgeschaltet mit `Ctrl+O`), sind diese Kürzel verfügbar. Im [Vollbildrendering](/docs/de/fullscreen) drücken Sie `?`, um das vollständige Kürzel-Referenzpanel im Viewer anzuzeigen. `Ctrl+E` kann über [`transcript:toggleShowAll`](/docs/de/keybindings) neu zugewiesen werden.

105 105

106| Kürzel | Beschreibung |106| Kürzel | Beschreibung |

107| :------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |107| :------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

108| `?` | Tastaturkürzel-Hilfepanel umschalten. Erfordert [Vollbildrendering](/de/fullscreen) |108| `?` | Tastaturkürzel-Hilfepanel umschalten. Erfordert [Vollbildrendering](/docs/de/fullscreen) |

109| `{` / `}` | Zur vorherigen oder nächsten Benutzereingabe springen, wie vim-Absatzbewegung. Erfordert [Vollbildrendering](/de/fullscreen) |109| `{` / `}` | Zur vorherigen oder nächsten Benutzereingabe springen, wie vim-Absatzbewegung. Erfordert [Vollbildrendering](/docs/de/fullscreen) |

111| `[` | Schreiben Sie das vollständige Gespräch in den nativen Scrollback Ihres Terminals, sodass `Cmd+F`, tmux-Kopiermodus und andere native Tools es durchsuchen können. Erfordert [Vollbildrendering](/de/fullscreen#search-and-review-the-conversation) |111| `[` | Schreiben Sie das vollständige Gespräch in den nativen Scrollback Ihres Terminals, sodass `Cmd+F`, tmux-Kopiermodus und andere native Tools es durchsuchen können. Erfordert [Vollbildrendering](/docs/de/fullscreen#search-and-review-the-conversation) |

112| `v` | Schreiben Sie das Gespräch in eine temporäre Datei und öffnen Sie es in `$VISUAL` oder `$EDITOR`. Erfordert [Vollbildrendering](/de/fullscreen) |112| `v` | Schreiben Sie das Gespräch in eine temporäre Datei und öffnen Sie es in `$VISUAL` oder `$EDITOR`. Erfordert [Vollbildrendering](/docs/de/fullscreen) |

113| `q`, `Ctrl+C`, `Esc` | Transkript-Ansicht beenden. Alle drei können über [`transcript:exit`](/de/keybindings) neu zugewiesen werden |113| `q`, `Ctrl+C`, `Esc` | Transkript-Ansicht beenden. Alle drei können über [`transcript:exit`](/docs/de/keybindings) neu zugewiesen werden |

114 114

115<h3 id="voice-input">115<h3 id="voice-input">

116 Spracheingabe116 Spracheingabe

118 118

120| :------------------------- | :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |120| :------------------------- | :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

121| `Space` halten oder tippen | Sprach-Diktieren | Erfordert, dass [Sprach-Diktieren](/de/voice-dictation) aktiviert ist. Halten Sie gedrückt zum Aufnehmen, oder führen Sie `/voice tap` aus für Tap-zum-Umschalten. [Neu zuweisbar](/de/voice-dictation#rebind-the-dictation-key) |121| `Space` halten oder tippen | Sprach-Diktieren | Erfordert, dass [Sprach-Diktieren](/docs/de/voice-dictation) aktiviert ist. Halten Sie gedrückt zum Aufnehmen, oder führen Sie `/voice tap` aus für Tap-zum-Umschalten. [Neu zuweisbar](/docs/de/voice-dictation#rebind-the-dictation-key) |

122 122

123<h2 id="commands">123<h2 id="commands">

124 Befehle124 Befehle

125</h2>125</h2>

126 126

127Geben Sie `/` in Claude Code ein, um alle verfügbaren Befehle anzuzeigen, oder geben Sie `/` gefolgt von beliebigen Buchstaben ein, um zu filtern. Das `/`-Menü zeigt alles, was Sie aufrufen können: integrierte Befehle, gebündelte und von Benutzern erstellte [Skills](/de/skills) sowie Befehle, die von [Plugins](/de/plugins) und [MCP-Servern](/de/mcp#use-mcp-prompts-as-commands) beigetragen werden. Nicht alle integrierten Befehle sind für jeden Benutzer sichtbar, da einige von Ihrer Plattform oder Ihrem Plan abhängen.127Geben Sie `/` in Claude Code ein, um alle verfügbaren Befehle anzuzeigen, oder geben Sie `/` gefolgt von beliebigen Buchstaben ein, um zu filtern. Das `/`-Menü zeigt alles, was Sie aufrufen können: integrierte Befehle, gebündelte und von Benutzern erstellte [Skills](/docs/de/skills) sowie Befehle, die von [Plugins](/docs/de/plugins) und [MCP-Servern](/docs/de/mcp#use-mcp-prompts-as-commands) beigetragen werden. Nicht alle integrierten Befehle sind für jeden Benutzer sichtbar, da einige von Ihrer Plattform oder Ihrem Plan abhängen.

128 128

129In der [Vollbildwiedergabe](/de/fullscreen#use-the-mouse) reagieren die `/`-Befehlsliste und die `@`-Dateivorschlagsliste auch auf die Maus: Das Überfahren mit der Maus hebt eine Zeile hervor und das Anklicken akzeptiert sie.129In der [Vollbildwiedergabe](/docs/de/fullscreen#use-the-mouse) reagieren die `/`-Befehlsliste und die `@`-Dateivorschlagsliste auch auf die Maus: Das Überfahren mit der Maus hebt eine Zeile hervor und das Anklicken akzeptiert sie.

130 130

131Siehe die [Befehls-Referenz](/de/commands) für die vollständige Liste der in Claude Code enthaltenen Befehle.131Siehe die [Befehls-Referenz](/docs/de/commands) für die vollständige Liste der in Claude Code enthaltenen Befehle.

132 132

133<h2 id="vim-editor-mode">133<h2 id="vim-editor-mode">

134 Vim-Editor-Modus134 Vim-Editor-Modus

156 INSERT-Modus-Tastenfolgen neu zuordnen156 INSERT-Modus-Tastenfolgen neu zuordnen

157</h3>157</h3>

158 158

159Die [`vimInsertModeRemaps`](/de/settings#available-settings) Einstellung ordnet eine zweitastige INSERT-Modus-Sequenz Escape zu, sodass eine Zuordnung wie `jj` Sie in den NORMAL-Modus zurückbringt. {/* min-version: 2.1.208 */}Erfordert Claude Code v2.1.208 oder später.159Die [`vimInsertModeRemaps`](/docs/de/settings#available-settings) Einstellung ordnet eine zweitastige INSERT-Modus-Sequenz Escape zu, sodass eine Zuordnung wie `jj` Sie in den NORMAL-Modus zurückbringt. Erfordert Claude Code v2.1.208 oder später.

160 160

161Das folgende `~/.claude/settings.json` Beispiel aktiviert den Vim-Modus und ordnet `jj` Escape zu:161Das folgende `~/.claude/settings.json` Beispiel aktiviert den Vim-Modus und ordnet `jj` Escape zu:

162 162

171 171

172Das Eingeben des ersten Zeichens einer Sequenz fügt es normal ein. Das Drücken des zweiten Zeichens innerhalb einer Sekunde entfernt das ausstehende Zeichen und wechselt in den NORMAL-Modus, wobei keines der beiden Zeichen in Ihrer Eingabe verbleibt. Nach dem Einsekundenfenster oder wenn ein anderes Zeichen folgt, bleiben beide Zeichen als Literaltext erhalten, sodass Sie ein Wort mit der Sequenz immer noch eingeben können, indem Sie zwischen den beiden Zeichen eine Pause machen.172Das Eingeben des ersten Zeichens einer Sequenz fügt es normal ein. Das Drücken des zweiten Zeichens innerhalb einer Sekunde entfernt das ausstehende Zeichen und wechselt in den NORMAL-Modus, wobei keines der beiden Zeichen in Ihrer Eingabe verbleibt. Nach dem Einsekundenfenster oder wenn ein anderes Zeichen folgt, bleiben beide Zeichen als Literaltext erhalten, sodass Sie ein Wort mit der Sequenz immer noch eingeben können, indem Sie zwischen den beiden Zeichen eine Pause machen.

173 173

174Claude Code liest diese Einstellung aus Ihrer Benutzereinstellungsdatei, dem `--settings` Flag und [verwalteten Einstellungen](/de/permissions#managed-settings) nur. Einträge in der `.claude/settings.json` oder `.claude/settings.local.json` eines Projekts werden ignoriert, sodass ein ausgechecktes Repository Ihre Tastenanschläge nicht neu zuordnen kann.174Claude Code liest diese Einstellung aus Ihrer Benutzereinstellungsdatei, dem `--settings` Flag und [verwalteten Einstellungen](/docs/de/permissions#managed-settings) nur. Einträge in der `.claude/settings.json` oder `.claude/settings.local.json` eines Projekts werden ignoriert, sodass ein ausgechecktes Repository Ihre Tastenanschläge nicht neu zuordnen kann.

175 175

176<h3 id="navigation-normal-mode">176<h3 id="navigation-normal-mode">

177 Navigation (NORMAL-Modus)177 Navigation (NORMAL-Modus)

178</h3>178</h3>

179 179

180| Befehl | Aktion |180| Befehl | Aktion |

181| :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |181| :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

184| `w` | Nächstes Wort |184| `w` | Nächstes Wort |

195| `T{char}` | Direkt nach das vorherige Vorkommen des Zeichens springen |195| `T{char}` | Direkt nach das vorherige Vorkommen des Zeichens springen |

196| `;` | Letzte f/F/t/T-Bewegung wiederholen |196| `;` | Letzte f/F/t/T-Bewegung wiederholen |

197| `,` | Letzte f/F/t/T-Bewegung in umgekehrter Reihenfolge wiederholen |197| `,` | Letzte f/F/t/T-Bewegung in umgekehrter Reihenfolge wiederholen |

198| `/` | Umgekehrte Verlaufssuche öffnen, gleich wie `Ctrl+R`. {/* min-version: 2.1.191 */}Ab v2.1.191 zeigt die leere Suchleiste einen Hinweis an: Drücken Sie `Esc` dann `i` dann `/`, um stattdessen das Befehlsmenü zu öffnen |198| `/` | Umgekehrte Verlaufssuche öffnen, gleich wie `Ctrl+R`. Ab v2.1.191 zeigt die leere Suchleiste einen Hinweis an: Drücken Sie `Esc` dann `i` dann `/`, um stattdessen das Befehlsmenü zu öffnen |

199 199

200<Note>200<Note>

201 Im Vim-Normal-Modus navigieren `j`/`k` und die Pfeiltasten den Befehlsverlauf, wenn sich der Cursor am Anfang oder Ende der Eingabe befindet und nicht weiter bewegt werden kann.201 Im Vim-Normal-Modus navigieren `j`/`k` und die Pfeiltasten den Befehlsverlauf, wenn sich der Cursor am Anfang oder Ende der Eingabe befindet und nicht weiter bewegt werden kann.

316 316

317* Die Ausgabe wird in eine Datei geschrieben und Claude kann sie mit dem Read-Tool abrufen317* Die Ausgabe wird in eine Datei geschrieben und Claude kann sie mit dem Read-Tool abrufen

318* Hintergrund-Tasks haben eindeutige IDs zum Tracking und zur Ausgabebeschaffung318* Hintergrund-Tasks haben eindeutige IDs zum Tracking und zur Ausgabebeschaffung

319* Hintergrund-Tasks werden automatisch bereinigt, wenn Claude Code beendet wird. Das Hintergrund-Ausführen der Sitzung anstelle des Beendens übergibt sie an die Hintergrund-Sitzung, wo sie weiterhin ausgeführt werden. Siehe [eine laufende Sitzung in den Hintergrund verschieben](/de/agent-view#from-inside-a-session)319* Hintergrund-Tasks werden automatisch bereinigt, wenn Claude Code beendet wird. Das Hintergrund-Ausführen der Sitzung anstelle des Beendens übergibt sie an die Hintergrund-Sitzung, wo sie weiterhin ausgeführt werden. Siehe [eine laufende Sitzung in den Hintergrund verschieben](/docs/de/agent-view#from-inside-a-session)

320* Hintergrund-Tasks werden automatisch beendet, wenn die Ausgabe 5 GB überschreitet, mit einem Hinweis in stderr, der erklärt, warum320* Hintergrund-Tasks werden automatisch beendet, wenn die Ausgabe 5 GB überschreitet, mit einem Hinweis in stderr, der erklärt, warum

321* {/* min-version: 2.1.193 */}Ab v2.1.193 werden auf macOS und Linux laufende Hintergrund-Tasks beendet, wenn das Betriebssystem ein Speicherdrucksignal sendet, sofern die Sitzung mindestens 30 Minuten untätig war, ohne dass ein Turn oder Subagent ausgeführt wird. Setzen Sie [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/de/env-vars) auf `1`, um dies auszuschalten321* Ab v2.1.193 werden auf macOS und Linux laufende Hintergrund-Tasks beendet, wenn das Betriebssystem ein Speicherdrucksignal sendet, sofern die Sitzung mindestens 30 Minuten untätig war, ohne dass ein Turn oder Subagent ausgeführt wird. Setzen Sie [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/de/env-vars) auf `1`, um dies auszuschalten

322 322

323Um alle Hintergrund-Task-Funktionen zu deaktivieren, setzen Sie die Umgebungsvariable `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` auf `1`. Siehe [Umgebungsvariablen](/de/env-vars) für Details.323Um alle Hintergrund-Task-Funktionen zu deaktivieren, setzen Sie die Umgebungsvariable `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` auf `1`. Siehe [Umgebungsvariablen](/docs/de/env-vars) für Details.

324 324

325**Häufig im Hintergrund ausgeführte Befehle:**325**Häufig im Hintergrund ausgeführte Befehle:**

326 326

349* Unterstützt die gleiche `Ctrl+B`-Hintergrund-Ausführung für lange laufende Befehle349* Unterstützt die gleiche `Ctrl+B`-Hintergrund-Ausführung für lange laufende Befehle

350* Erfordert nicht, dass Claude den Befehl interpretiert oder genehmigt350* Erfordert nicht, dass Claude den Befehl interpretiert oder genehmigt

351* Unterstützt verlaufsbasierte Autovervollständigung: Geben Sie einen Teilbefehl ein und drücken Sie `Tab`, um aus vorherigen `!`-Befehlen im aktuellen Projekt zu vervollständigen351* Unterstützt verlaufsbasierte Autovervollständigung: Geben Sie einen Teilbefehl ein und drücken Sie `Tab`, um aus vorherigen `!`-Befehlen im aktuellen Projekt zu vervollständigen

352* {/* min-version: 2.1.193 */}Unterstützt Live-Dateipfad-Autovervollständigung ab v2.1.193 auf allen Plattformen: Geben Sie ein Token mit einem Schrägstrich ein, z. B. `./src/` oder `~/`, um ein Dropdown-Menü mit übereinstimmenden Dateien und Verzeichnissen anzuzeigen, und drücken Sie dann `Tab`, um zu akzeptieren. Verwenden Sie auch unter Windows Schrägstriche; das Dropdown-Menü wird durch `/` ausgelöst, nicht durch `\`352* Unterstützt Live-Dateipfad-Autovervollständigung ab v2.1.193 auf allen Plattformen: Geben Sie ein Token mit einem Schrägstrich ein, z. B. `./src/` oder `~/`, um ein Dropdown-Menü mit übereinstimmenden Dateien und Verzeichnissen anzuzeigen, und drücken Sie dann `Tab`, um zu akzeptieren. Verwenden Sie auch unter Windows Schrägstriche; das Dropdown-Menü wird durch `/` ausgelöst, nicht durch `\`

353* Beenden Sie mit `Escape`, `Backspace` oder `Ctrl+U` bei einer leeren Eingabeaufforderung353* Beenden Sie mit `Escape`, `Backspace` oder `Ctrl+U` bei einer leeren Eingabeaufforderung

354* Das Einfügen von Text, der mit `!` beginnt, in eine leere Eingabeaufforderung aktiviert automatisch den Bash-Modus und entspricht dem eingegebenen `!`-Verhalten354* Das Einfügen von Text, der mit `!` beginnt, in eine leere Eingabeaufforderung aktiviert automatisch den Bash-Modus und entspricht dem eingegebenen `!`-Verhalten

355 355

356Ab v2.1.186 antwortet Claude automatisch auf die Befehlsausgabe, sobald sie im Transkript angezeigt wird, sodass Sie `! npm test` ausführen und eine Erklärung der Fehler ohne eine zweite Eingabeaufforderung erhalten können. Die Antwort kostet das Gleiche wie das Senden einer normalen Eingabeaufforderung. Um das frühere Verhalten wiederherzustellen, bei dem die Ausgabe zum Kontext hinzugefügt wird, ohne eine Antwort zu geben, setzen Sie [`respondToBashCommands`](/de/settings#available-settings) auf `false` in `settings.json`. Vor v2.1.186 hat der Bash-Modus die Ausgabe immer zum Kontext hinzugefügt, ohne eine Antwort zu geben.356Ab v2.1.186 antwortet Claude automatisch auf die Befehlsausgabe, sobald sie im Transkript angezeigt wird, sodass Sie `! npm test` ausführen und eine Erklärung der Fehler ohne eine zweite Eingabeaufforderung erhalten können. Die Antwort kostet das Gleiche wie das Senden einer normalen Eingabeaufforderung. Um das frühere Verhalten wiederherzustellen, bei dem die Ausgabe zum Kontext hinzugefügt wird, ohne eine Antwort zu geben, setzen Sie [`respondToBashCommands`](/docs/de/settings#available-settings) auf `false` in `settings.json`. Vor v2.1.186 hat der Bash-Modus die Ausgabe immer zum Kontext hinzugefügt, ohne eine Antwort zu geben.

357 357

358Dies ist nützlich für schnelle Shell-Operationen bei Beibehaltung des Gesprächskontexts.358Dies ist nützlich für schnelle Shell-Operationen bei Beibehaltung des Gesprächskontexts.

359 359

370 370

371Der Vorschlag wird als Hintergrund-Anfrage ausgeführt, die den Prompt-Cache des übergeordneten Gesprächs wiederverwenden, sodass die zusätzlichen Kosten minimal sind. Claude Code überspringt die Vorschlagsgenerierung, wenn der Cache kalt ist, um unnötige Kosten zu vermeiden.371Der Vorschlag wird als Hintergrund-Anfrage ausgeführt, die den Prompt-Cache des übergeordneten Gesprächs wiederverwenden, sodass die zusätzlichen Kosten minimal sind. Claude Code überspringt die Vorschlagsgenerierung, wenn der Cache kalt ist, um unnötige Kosten zu vermeiden.

372 372

373Vorschläge werden automatisch nach dem ersten Turn eines Gesprächs und im Plan Mode übersprungen. Im Print Mode sind sie standardmäßig deaktiviert. Übergeben Sie [`--prompt-suggestions`](/de/cli-reference#cli-flags) mit `--output-format stream-json --verbose`, um stattdessen nach jedem Turn eine `prompt_suggestion`-Nachricht auszugeben.373Vorschläge werden automatisch nach dem ersten Turn eines Gesprächs und im Plan Mode übersprungen. Im Print Mode sind sie standardmäßig deaktiviert. Übergeben Sie [`--prompt-suggestions`](/docs/de/cli-reference#cli-flags) mit `--output-format stream-json --verbose`, um stattdessen nach jedem Turn eine `prompt_suggestion`-Nachricht auszugeben.

374 374

375Um Prompt-Vorschläge vollständig zu deaktivieren, setzen Sie die Umgebungsvariable oder schalten Sie die Einstellung in `/config` um:375Um Prompt-Vorschläge vollständig zu deaktivieren, setzen Sie die Umgebungsvariable oder schalten Sie die Einstellung in `/config` um:

376 376

403| :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |403| :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

406| `Left` / `Right` | {/* min-version: 2.1.187 */}Wechseln Sie zwischen dieser Antwort und Ihren früheren `/btw`-Antworten aus der Sitzung. `Left` wechselt zu älteren Antworten und `Right` kehrt zur aktuellen zurück. Erfordert Claude Code v2.1.187 oder später |406| `Left` / `Right` | Wechseln Sie zwischen dieser Antwort und Ihren früheren `/btw`-Antworten aus der Sitzung. `Left` wechselt zu älteren Antworten und `Right` kehrt zur aktuellen zurück. Erfordert Claude Code v2.1.187 oder später |

407| `c` | Kopieren Sie die Antwort als Raw Markdown in Ihre Zwischenablage. Verwenden Sie dies anstelle der Mausauswahl, die das hart umgebrochene Terminal-Rendering anstelle des Quelltexts erfasst |407| `c` | Kopieren Sie die Antwort als Raw Markdown in Ihre Zwischenablage. Verwenden Sie dies anstelle der Mausauswahl, die das hart umgebrochene Terminal-Rendering anstelle des Quelltexts erfasst |

408| `f` | In eine neue Sitzung aufteilen. Die Aufteilung erbt das übergeordnete Gespräch plus diese Frage und Antwort als echte Transkript-Turns, sodass Sie mit vollständigem Tool-Zugriff fortfahren können. Die ursprüngliche Sitzung wird unter [`/resume`](/de/commands) beibehalten. Nur in lokalen Sitzungen verfügbar |408| `f` | In eine neue Sitzung aufteilen. Die Aufteilung erbt das übergeordnete Gespräch plus diese Frage und Antwort als echte Transkript-Turns, sodass Sie mit vollständigem Tool-Zugriff fortfahren können. Die ursprüngliche Sitzung wird unter [`/resume`](/docs/de/commands) beibehalten. Nur in lokalen Sitzungen verfügbar |

409| `x` | Löschen Sie die Liste der früheren `/btw`-Austausche, die über der aktuellen Antwort angezeigt werden |409| `x` | Löschen Sie die Liste der früheren `/btw`-Austausche, die über der aktuellen Antwort angezeigt werden |

410 410

411`/btw` ist das Gegenteil eines [Subagenten](/de/sub-agents): Es sieht Ihr vollständiges Gespräch, hat aber keine Tools, während ein Subagent vollständige Tools hat, aber mit einem leeren Kontext beginnt. Verwenden Sie `/btw`, um zu fragen, was Claude bereits aus dieser Sitzung weiß; verwenden Sie einen Subagenten, um etwas Neues herauszufinden.411`/btw` ist das Gegenteil eines [Subagenten](/docs/de/sub-agents): Es sieht Ihr vollständiges Gespräch, hat aber keine Tools, während ein Subagent vollständige Tools hat, aber mit einem leeren Kontext beginnt. Verwenden Sie `/btw`, um zu fragen, was Claude bereits aus dieser Sitzung weiß; verwenden Sie einen Subagenten, um etwas Neues herauszufinden.

412 412

413<h2 id="task-list">413<h2 id="task-list">

414 Task-Liste414 Task-Liste

415</h2>415</h2>

416 416

417Die Task-Liste ist Claudes Aufgabenliste: Elemente, die Claude erstellt hat, um mehrstufige Arbeiten zu planen, mit Indikatoren, die zeigen, was ausstehend, in Bearbeitung oder abgeschlossen ist. Sie ist separat von der Hintergrund-Task-Ansicht. Um laufende Shells und Subagenten zu sehen, verwenden Sie stattdessen [`/tasks`](/de/commands).417Die Task-Liste ist Claudes Aufgabenliste: Elemente, die Claude erstellt hat, um mehrstufige Arbeiten zu planen, mit Indikatoren, die zeigen, was ausstehend, in Bearbeitung oder abgeschlossen ist. Sie ist separat von der Hintergrund-Task-Ansicht. Um laufende Shells und Subagenten zu sehen, verwenden Sie stattdessen [`/tasks`](/docs/de/commands).

418 418

419* Drücken Sie `Ctrl+T`, um die Task-Listen-Ansicht umzuschalten. Die Anzeige zeigt bis zu fünf Tasks gleichzeitig. Wenn Claude noch keine Checklistenelemente erstellt hat, hat der Umschalter keine sichtbare Auswirkung, da es nichts anzuzeigen gibt419* Drücken Sie `Ctrl+T`, um die Task-Listen-Ansicht umzuschalten. Die Anzeige zeigt bis zu fünf Tasks gleichzeitig. Wenn Claude noch keine Checklistenelemente erstellt hat, hat der Umschalter keine sichtbare Auswirkung, da es nichts anzuzeigen gibt

420* Um alle Tasks anzuzeigen oder zu löschen, fragen Sie Claude direkt: "show me all tasks" oder "clear all tasks"420* Um alle Tasks anzuzeigen oder zu löschen, fragen Sie Claude direkt: "show me all tasks" oder "clear all tasks"

452 Siehe auch452 Siehe auch

453</h2>453</h2>

454 454

455* [Skills](/de/skills) - Benutzerdefinierte Prompts und Workflows455* [Skills](/docs/de/skills) - Benutzerdefinierte Prompts und Workflows

456* [Checkpointing](/de/checkpointing) - Spulen Sie Claudes Änderungen zurück und stellen Sie vorherige Zustände wieder her456* [Checkpointing](/docs/de/checkpointing) - Spulen Sie Claudes Änderungen zurück und stellen Sie vorherige Zustände wieder her

457* [CLI-Referenz](/de/cli-reference) - Befehlszeilenflags und Optionen457* [CLI-Referenz](/docs/de/cli-reference) - Befehlszeilenflags und Optionen

458* [Einstellungen](/de/settings) - Konfigurationsoptionen458* [Einstellungen](/docs/de/settings) - Konfigurationsoptionen

459* [Speicherverwaltung](/de/memory) - Verwalten von CLAUDE.md-Dateien459* [Speicherverwaltung](/docs/de/memory) - Verwalten von CLAUDE.md-Dateien

keybindings.md +12 −12

Details

68| `Plugin` | Plugin-Dialog (durchsuchen, entdecken, verwalten) |68| `Plugin` | Plugin-Dialog (durchsuchen, entdecken, verwalten) |

69| `Scroll` | Konversations-Scrolling und Textauswahl im Vollbildmodus |69| `Scroll` | Konversations-Scrolling und Textauswahl im Vollbildmodus |

70 70

~~71{/* max-version: 2.1.204 */}Vor v2.1.205 existierten ein `Doctor`-Kontext und eine `doctor:fix`-Aktion für den `/doctor`-Diagnose-Bildschirm.~~71Vor v2.1.205 existierten ein `Doctor`-Kontext und eine `doctor:fix`-Aktion für den `/doctor`-Diagnose-Bildschirm.

72 72

73<h2 id="available-actions">73<h2 id="available-actions">

74 Verfügbare Aktionen74 Verfügbare Aktionen

92 92

93<h3 id="history-actions">93<h3 id="history-actions">

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

114| `chat:clearInput` | Ctrl+L | Vollständiges Bildschirm-Neuzeichnen erzwingen, Eingabe beibehalten. Im [Vollbildrendering](/de/fullscreen#clear-the-conversation) zweimal innerhalb von zwei Sekunden drücken, um `/clear` auszuführen |114| `chat:clearInput` | Ctrl+L | Vollständiges Bildschirm-Neuzeichnen erzwingen, Eingabe beibehalten. Im [Vollbildrendering](/docs/de/fullscreen#clear-the-conversation) zweimal innerhalb von zwei Sekunden drücken, um `/clear` auszuführen |

159| `confirm:toggleExplanation` | Ctrl+E | Modellgenerierte [Erklärung des Befehls](/de/permissions#permission-system) auf Bash- und PowerShell-Berechtigungsaufforderungen umschalten |159| `confirm:toggleExplanation` | Ctrl+E | Modellgenerierte [Erklärung des Befehls](/docs/de/permissions#permission-system) auf Bash- und PowerShell-Berechtigungsaufforderungen umschalten |

160 160

161<h3 id="permission-actions">161<h3 id="permission-actions">

162 Berechtigungsaktionen162 Berechtigungsaktionen

200Aktionen verfügbar im `Task`-Kontext:200Aktionen verfügbar im `Task`-Kontext:

201 201

203| :---------------- | :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |203| :---------------- | :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- |

204| `task:background` | Ctrl+B, Ctrl+X Ctrl+B | Aktuelle Aufgabe in den Hintergrund verschieben. {/* min-version: 2.1.169 */}Die Ctrl+X Ctrl+B-Kombination erfordert v2.1.169 oder später und vermeidet den tmux-Präfix-Konflikt |204| `task:background` | Ctrl+B, Ctrl+X Ctrl+B | Aktuelle Aufgabe in den Hintergrund verschieben. Die Ctrl+X Ctrl+B-Kombination erfordert v2.1.169 oder später und vermeidet den tmux-Präfix-Konflikt |

205 205

206<h3 id="theme-actions">206<h3 id="theme-actions">

207 Design-Aktionen207 Design-Aktionen

357 Sprach-Aktionen357 Sprach-Aktionen

358</h3>358</h3>

359 359

360Aktionen verfügbar im `Chat`-Kontext, wenn [Sprachdiktat](/de/voice-dictation) aktiviert ist:360Aktionen verfügbar im `Chat`-Kontext, wenn [Sprachdiktat](/docs/de/voice-dictation) aktiviert ist:

361 361

363| :----------------- | :-------- | :----------------------------------------------------------------------- |363| :----------------- | :-------- | :----------------------------------------------------------------------- |

367 Scroll-Aktionen367 Scroll-Aktionen

368</h3>368</h3>

369 369

370Aktionen verfügbar im `Scroll`-Kontext, wenn [Vollbildrendering](/de/fullscreen) aktiviert ist:370Aktionen verfügbar im `Scroll`-Kontext, wenn [Vollbildrendering](/docs/de/fullscreen) aktiviert ist:

371 371

373| :-------------------------- | :------------------- | :----------------------------------------------------------------------------------------------------------------------------- |373| :-------------------------- | :------------------- | :----------------------------------------------------------------------------------------------------------------------------- |

526* **Keybindings** verarbeiten Aktionen auf der Komponentenebene (Aufgaben umschalten, senden usw.)526* **Keybindings** verarbeiten Aktionen auf der Komponentenebene (Aufgaben umschalten, senden usw.)

527* Die Escape-Taste im Vim-Modus wechselt von INSERT zu NORMAL-Modus; sie löst nicht `chat:cancel` aus527* Die Escape-Taste im Vim-Modus wechselt von INSERT zu NORMAL-Modus; sie löst nicht `chat:cancel` aus

528* Die meisten Ctrl+Taste-Kürzel werden durch den Vim-Modus zum Keybinding-System weitergeleitet528* Die meisten Ctrl+Taste-Kürzel werden durch den Vim-Modus zum Keybinding-System weitergeleitet

529* Vim-Tasten können nicht über die Keybindings-Datei neu zugeordnet werden. Um eine zwei-Tasten-INSERT-Modus-Sequenz wie `jj` auf Escape abzubilden, verwenden Sie die Einstellung [`vimInsertModeRemaps`](/de/interactive-mode#remap-insert-mode-key-sequences)529* Vim-Tasten können nicht über die Keybindings-Datei neu zugeordnet werden. Um eine zwei-Tasten-INSERT-Modus-Sequenz wie `jj` auf Escape abzubilden, verwenden Sie die Einstellung [`vimInsertModeRemaps`](/docs/de/interactive-mode#remap-insert-mode-key-sequences)

530* Im Vim-NORMAL-Modus zeigt `?` das Hilfemenü an (Vim-Verhalten)530* Im Vim-NORMAL-Modus zeigt `?` das Hilfemenü an (Vim-Verhalten)

531* Im Vim-NORMAL-Modus öffnet `/` die Verlaufssuche, dasselbe wie Ctrl+R im Standardmodus531* Im Vim-NORMAL-Modus öffnet `/` die Verlaufssuche, dasselbe wie Ctrl+R im Standardmodus

532 532

542* Terminal-Multiplexer-Konflikte542* Terminal-Multiplexer-Konflikte

543* Doppelte Bindings im selben Kontext543* Doppelte Bindings im selben Kontext

544 544

545Claude Code meldet Warnungen, wenn die Datei geladen wird, und schreibt jede einzelne in das Debug-Protokoll. Starten Sie Claude Code mit [`--debug`](/de/cli-reference#cli-flags), um die Details zu sehen.545Claude Code meldet Warnungen, wenn die Datei geladen wird, und schreibt jede einzelne in das Debug-Protokoll. Starten Sie Claude Code mit [`--debug`](/docs/de/cli-reference#cli-flags), um die Details zu sehen.

llm-gateway-connect.md +36 −36

Details

6 6

7> Richten Sie Claude Code auf das LLM-Gateway Ihrer Organisation aus. Überprüfen Sie, ob Ihr Administrator es bereits konfiguriert hat, oder legen Sie die Basis-URL und die Anmeldedaten selbst fest, überprüfen Sie dann die Verbindung und beheben Sie Gateway-Fehler.7> Richten Sie Claude Code auf das LLM-Gateway Ihrer Organisation aus. Überprüfen Sie, ob Ihr Administrator es bereits konfiguriert hat, oder legen Sie die Basis-URL und die Anmeldedaten selbst fest, überprüfen Sie dann die Verbindung und beheben Sie Gateway-Fehler.

8 8

9Ein [LLM-Gateway](/de/llm-gateway) ist ein Proxy, den Ihre Organisation zwischen Claude Code und dem Modell-Anbieter betreibt. Wenn Ihre Organisation einen verwendet, authentifiziert sich Claude Code beim Gateway mit einer Anmeldedaten, die Ihre Organisation ausstellt, anstelle Ihres persönlichen claude.ai-Logins.9Ein [LLM-Gateway](/docs/de/llm-gateway) ist ein Proxy, den Ihre Organisation zwischen Claude Code und dem Modell-Anbieter betreibt. Wenn Ihre Organisation einen verwendet, authentifiziert sich Claude Code beim Gateway mit einer Anmeldedaten, die Ihre Organisation ausstellt, anstelle Ihres persönlichen claude.ai-Logins.

10 10

11Diese Seite ist für Entwickler, die Claude Code über ein Gateway ausführen, das ihre Organisation betreibt. Sie behandelt zwei Pfade: [Überprüfung, ob Ihr Administrator es bereits für Sie konfiguriert hat](#check-for-an-existing-configuration), und [Konfiguration selbst](#configure-claude-code-yourself), wenn dies nicht der Fall ist.11Diese Seite ist für Entwickler, die Claude Code über ein Gateway ausführen, das ihre Organisation betreibt. Sie behandelt zwei Pfade: [Überprüfung, ob Ihr Administrator es bereits für Sie konfiguriert hat](#check-for-an-existing-configuration), und [Konfiguration selbst](#configure-claude-code-yourself), wenn dies nicht der Fall ist.

12 12

13<Note>13<Note>

~~14 * Um ein Gateway für Ihre Organisation bereitzustellen, siehe [Rollout eines LLM-Gateways](/de/llm-gateway-rollout)~~14 * Um ein Gateway für Ihre Organisation bereitzustellen, siehe [Rollout eines LLM-Gateways](/docs/de/llm-gateway-rollout)

~~15 * Für das, was Claude Code an ein Gateway sendet, siehe die [Gateway-Protokoll-Referenz](/de/llm-gateway-protocol)~~15 * Für das, was Claude Code an ein Gateway sendet, siehe die [Gateway-Protokoll-Referenz](/docs/de/llm-gateway-protocol)

16</Note>16</Note>

17 17

18<h2 id="check-for-an-existing-configuration">18<h2 id="check-for-an-existing-configuration">

19 Überprüfung einer vorhandenen Konfiguration19 Überprüfung einer vorhandenen Konfiguration

20</h2>20</h2>

21 21

22Administratoren können die Gateway-Adresse und die Anmeldedaten über [verwaltete Einstellungen](/de/settings#settings-files), Geräteverwaltung oder einen [`apiKeyHelper`](#rotate-credentials-with-apikeyhelper) verteilen, sodass Claude Code sie beim Start ohne weitere Konfiguration aufgreift. Um zu überprüfen, ob Ihre Organisation dies bereits getan hat:22Administratoren können die Gateway-Adresse und die Anmeldedaten über [verwaltete Einstellungen](/docs/de/settings#settings-files), Geräteverwaltung oder einen [`apiKeyHelper`](#rotate-credentials-with-apikeyhelper) verteilen, sodass Claude Code sie beim Start ohne weitere Konfiguration aufgreift. Um zu überprüfen, ob Ihre Organisation dies bereits getan hat:

23 23

24<Steps>24<Steps>

25 <Step title="Claude Code starten">25 <Step title="Claude Code starten">

107 Legen Sie in einer Einstellungsdatei fest107 Legen Sie in einer Einstellungsdatei fest

108</h4>108</h4>

109 109

110Um die Konfiguration überall dort anzuwenden, wo Claude Code ausgeführt wird, ohne von Ihrer Shell abhängig zu sein, legen Sie die Variablen im `env`-Block einer [Einstellungsdatei](/de/settings) fest. Einstellungsdateien haben unterschiedliche Bereiche:110Um die Konfiguration überall dort anzuwenden, wo Claude Code ausgeführt wird, ohne von Ihrer Shell abhängig zu sein, legen Sie die Variablen im `env`-Block einer [Einstellungsdatei](/docs/de/settings) fest. Einstellungsdateien haben unterschiedliche Bereiche:

111 111

112* `~/.claude/settings.json` gilt für alle Ihre Projekte. Unter Windows ist der Pfad `%USERPROFILE%\.claude\settings.json`112* `~/.claude/settings.json` gilt für alle Ihre Projekte. Unter Windows ist der Pfad `%USERPROFILE%\.claude\settings.json`

113* `.claude/settings.local.json` gilt für ein Projekt. Claude Code fügt es zu Ihrem gitignore hinzu, wenn es die Datei erstellt; wenn Sie sie selbst erstellen, fügen Sie sie zuerst manuell zu Ihrem gitignore hinzu, damit Sie Ihre Anmeldedaten nicht versehentlich committen113* `.claude/settings.local.json` gilt für ein Projekt. Claude Code fügt es zu Ihrem gitignore hinzu, wenn es die Datei erstellt; wenn Sie sie selbst erstellen, fügen Sie sie zuerst manuell zu Ihrem gitignore hinzu, damit Sie Ihre Anmeldedaten nicht versehentlich committen

194 VS Code-Erweiterung194 VS Code-Erweiterung

195</h3>195</h3>

196 196

197Legen Sie die Gateway-Variablen für die [VS Code-Erweiterung](/de/vs-code) in `claudeCode.environmentVariables` in VS Codes eigenen Benutzereinstellungen fest, die mit dem Befehl **Preferences: Open User Settings (JSON)** geöffnet werden. Die Erweiterung überprüft Anmeldedaten aus dieser Einstellung vor dem Start, daher ist es der zuverlässige Ort für die Gateway-Anmeldedaten; Werte in `~/.claude/settings.json` erreichen den erzeugten Prozess, aber nicht die Anmeldungsprüfung der Erweiterung selbst.197Legen Sie die Gateway-Variablen für die [VS Code-Erweiterung](/docs/de/vs-code) in `claudeCode.environmentVariables` in VS Codes eigenen Benutzereinstellungen fest, die mit dem Befehl **Preferences: Open User Settings (JSON)** geöffnet werden. Die Erweiterung überprüft Anmeldedaten aus dieser Einstellung vor dem Start, daher ist es der zuverlässige Ort für die Gateway-Anmeldedaten; Werte in `~/.claude/settings.json` erreichen den erzeugten Prozess, aber nicht die Anmeldungsprüfung der Erweiterung selbst.

198 198

199```json theme={null}199```json theme={null}

200{200{

211 211

212Die Desktop-App liest Gateway-Routing aus ihrer [Konfiguration für Drittanbieter-Inferenz](https://claude.com/docs/third-party/claude-desktop/gateway), nicht aus `ANTHROPIC_BASE_URL` oder `settings.json`. Diese Konfiguration kann von Ihrer Organisation oder von einem Formular in der App selbst stammen:212Die Desktop-App liest Gateway-Routing aus ihrer [Konfiguration für Drittanbieter-Inferenz](https://claude.com/docs/third-party/claude-desktop/gateway), nicht aus `ANTHROPIC_BASE_URL` oder `settings.json`. Diese Konfiguration kann von Ihrer Organisation oder von einem Formular in der App selbst stammen:

213 213

214* **Von einem Administrator verteilt**: Wenn Ihre Organisation die [Konfiguration bereitgestellt hat](/de/llm-gateway-rollout#distribute-through-managed-settings), leitet die Desktop-App ohne Einrichtung auf Ihrer Seite durch das Gateway214* **Von einem Administrator verteilt**: Wenn Ihre Organisation die [Konfiguration bereitgestellt hat](/docs/de/llm-gateway-rollout#distribute-through-managed-settings), leitet die Desktop-App ohne Einrichtung auf Ihrer Seite durch das Gateway

215* **Lokal konfiguriert**: Für Geräte ohne eine von einem Administrator verteilte Konfiguration öffnen Sie Help → Troubleshooting → Enable Developer Mode, wodurch die App mit einem Developer-Menü neu gestartet wird. Öffnen Sie dann Developer → Configure Third-Party Inference und geben Sie Ihre Gateway-Basis-URL ein. Eine von einem Administrator verteilte Konfiguration hat Vorrang und macht dieses Formular schreibgeschützt215* **Lokal konfiguriert**: Für Geräte ohne eine von einem Administrator verteilte Konfiguration öffnen Sie Help → Troubleshooting → Enable Developer Mode, wodurch die App mit einem Developer-Menü neu gestartet wird. Öffnen Sie dann Developer → Configure Third-Party Inference und geben Sie Ihre Gateway-Basis-URL ein. Eine von einem Administrator verteilte Konfiguration hat Vorrang und macht dieses Formular schreibgeschützt

216 216

217Mit der aktiven Gateway-Konfiguration führt die Desktop-App Sitzungen nur auf Ihrem lokalen Computer aus: Der Umgebungswähler bietet keine SSH-Sitzungen oder von Anthropic gehostete Cloud-Umgebungen an, und [Remote Control](/de/remote-control) ist nicht verfügbar. Um Claude Code auf einem Remote-Host über das Gateway zu verwenden, führen Sie die CLI auf diesem Host mit [`ANTHROPIC_BASE_URL` und der Gateway-Anmeldedaten](#set-the-base-url-and-credential) aus, die dort festgelegt sind.217Mit der aktiven Gateway-Konfiguration führt die Desktop-App Sitzungen nur auf Ihrem lokalen Computer aus: Der Umgebungswähler bietet keine SSH-Sitzungen oder von Anthropic gehostete Cloud-Umgebungen an, und [Remote Control](/docs/de/remote-control) ist nicht verfügbar. Um Claude Code auf einem Remote-Host über das Gateway zu verwenden, führen Sie die CLI auf diesem Host mit [`ANTHROPIC_BASE_URL` und der Gateway-Anmeldedaten](#set-the-base-url-and-credential) aus, die dort festgelegt sind.

218 218

219Wenn die Desktop-App `Gateway was unreachable` anzeigt, konnte die App die konfigurierte Basis-URL beim Start nicht erreichen; überprüfen Sie die URL und den Netzwerkpfad mit dem [curl-Test oben](#verify-the-connection).219Wenn die Desktop-App `Gateway was unreachable` anzeigt, konnte die App die konfigurierte Basis-URL beim Start nicht erreichen; überprüfen Sie die URL und den Netzwerkpfad mit dem [curl-Test oben](#verify-the-connection).

220 220

222 GitHub Actions222 GitHub Actions

223</h3>223</h3>

224 224

225[Claude Code GitHub Actions](/de/github-actions) liest `ANTHROPIC_BASE_URL` und `ANTHROPIC_CUSTOM_HEADERS` aus dem `env`-Block des Workflows. Übergeben Sie die Anmeldedaten als die `anthropic_api_key`-Eingabe der Aktion; die Aktion legt sie als `ANTHROPIC_API_KEY` fest, sodass sie das Gateway im `x-api-key`-Header erreichen.225[Claude Code GitHub Actions](/docs/de/github-actions) liest `ANTHROPIC_BASE_URL` und `ANTHROPIC_CUSTOM_HEADERS` aus dem `env`-Block des Workflows. Übergeben Sie die Anmeldedaten als die `anthropic_api_key`-Eingabe der Aktion; die Aktion legt sie als `ANTHROPIC_API_KEY` fest, sodass sie das Gateway im `x-api-key`-Header erreichen.

226 226

227Für ein `x-api-key`-Gateway legen Sie die Basis-URL in `env` fest und übergeben Sie den Gateway-Schlüssel als Eingabe:227Für ein `x-api-key`-Gateway legen Sie die Basis-URL in `env` fest und übergeben Sie den Gateway-Schlüssel als Eingabe:

228 228

249 anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}249 anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

250```250```

251 251

252Für die anderen Authentifizierungsoptionen der Aktion, einschließlich `CLAUDE_CODE_OAUTH_TOKEN` und Workload-Identitäts-Verbund, siehe [Claude Code GitHub Actions](/de/github-actions) und die [README](https://github.com/anthropics/claude-code-action#readme) der Aktion.252Für die anderen Authentifizierungsoptionen der Aktion, einschließlich `CLAUDE_CODE_OAUTH_TOKEN` und Workload-Identitäts-Verbund, siehe [Claude Code GitHub Actions](/docs/de/github-actions) und die [README](https://github.com/anthropics/claude-code-action#readme) der Aktion.

253 253

254<h3 id="agent-sdk">254<h3 id="agent-sdk">

255 Agent SDK255 Agent SDK

256</h3>256</h3>

257 257

258Das [Agent SDK](/de/agent-sdk/overview) hat keine Gateway-spezifischen Optionen; es übergibt Umgebungsvariablen an den Claude Code-Prozess, den es erzeugt. Jedes SDK akzeptiert eine `env`-Option, die die Umgebung des erzeugten Prozesses festlegt, und die TypeScript- und Python-SDKs behandeln sie unterschiedlich:258Das [Agent SDK](/docs/de/agent-sdk/overview) hat keine Gateway-spezifischen Optionen; es übergibt Umgebungsvariablen an den Claude Code-Prozess, den es erzeugt. Jedes SDK akzeptiert eine `env`-Option, die die Umgebung des erzeugten Prozesses festlegt, und die TypeScript- und Python-SDKs behandeln sie unterschiedlich:

259 259

260* TypeScript: Der erzeugte Prozess erbt standardmäßig die übergeordnete Umgebung, aber das Festlegen von `options.env` ersetzt die Umgebung vollständig. Verteilen Sie `process.env` darin, um Ihre Gateway-Variablen zu behalten.260* TypeScript: Der erzeugte Prozess erbt standardmäßig die übergeordnete Umgebung, aber das Festlegen von `options.env` ersetzt die Umgebung vollständig. Verteilen Sie `process.env` darin, um Ihre Gateway-Variablen zu behalten.

261* Python: `ClaudeAgentOptions(env=...)` wird auf der geerbten Umgebung zusammengeführt, daher werden Gateway-Variablen, die im übergeordneten Prozess festgelegt sind, ohne Verteilung durchgeleitet.261* Python: `ClaudeAgentOptions(env=...)` wird auf der geerbten Umgebung zusammengeführt, daher werden Gateway-Variablen, die im übergeordneten Prozess festgelegt sind, ohne Verteilung durchgeleitet.

288 Slack, Web und Remote Control288 Slack, Web und Remote Control

289</h3>289</h3>

290 290

291[Claude Code in Slack](/de/slack) und [Claude Code im Web](/de/claude-code-on-the-web) sind von Anthropic gehostete Produkte, die immer die Anthropic-API verwenden; sie sind nicht Teil einer Gateway-Bereitstellung. Gateway-Variablen, die in der Umgebungskonfiguration einer Cloud-Sitzung festgelegt sind, werden nicht angewendet. Wenn Ihr Datenverkehr auf dem Gateway bleiben muss, aktivieren Sie diese Oberflächen nicht für diese Benutzer.291[Claude Code in Slack](/docs/de/slack) und [Claude Code im Web](/docs/de/claude-code-on-the-web) sind von Anthropic gehostete Produkte, die immer die Anthropic-API verwenden; sie sind nicht Teil einer Gateway-Bereitstellung. Gateway-Variablen, die in der Umgebungskonfiguration einer Cloud-Sitzung festgelegt sind, werden nicht angewendet. Wenn Ihr Datenverkehr auf dem Gateway bleiben muss, aktivieren Sie diese Oberflächen nicht für diese Benutzer.

292 292

293[Remote Control](/de/remote-control) und [Sprachdiktat](/de/voice-dictation) verlassen sich beide auf eine claude.ai-Identität: Remote Control, um eine Live-Sitzung mit Ihrem Konto zu koppeln, und Sprachdiktat, um den claude.ai-Transkriptions-Endpunkt zu erreichen. Sie sind nicht verfügbar, während `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder ein `apiKeyHelper` aktiv ist. {/* min-version: 2.1.196 */}Ab v2.1.196 ist Remote Control auch deaktiviert, während `ANTHROPIC_BASE_URL` auf einen Nicht-Anthropic-Host verweist, daher ist die Anmeldung mit claude.ai allein nicht ausreichend.293[Remote Control](/docs/de/remote-control) und [Sprachdiktat](/docs/de/voice-dictation) verlassen sich beide auf eine claude.ai-Identität: Remote Control, um eine Live-Sitzung mit Ihrem Konto zu koppeln, und Sprachdiktat, um den claude.ai-Transkriptions-Endpunkt zu erreichen. Sie sind nicht verfügbar, während `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder ein `apiKeyHelper` aktiv ist. Ab v2.1.196 ist Remote Control auch deaktiviert, während `ANTHROPIC_BASE_URL` auf einen Nicht-Anthropic-Host verweist, daher ist die Anmeldung mit claude.ai allein nicht ausreichend.

294 294

295Um eines dieser Features wiederherzustellen, melden Sie sich mit claude.ai an und heben Sie die Festlegung der Gateway-Variablen auf, die es überprüft. Der Remote Control-Abschnitt von `claude doctor` benennt die Anmeldedaten-Variable, die aufgehoben werden soll.295Um eines dieser Features wiederherzustellen, melden Sie sich mit claude.ai an und heben Sie die Festlegung der Gateway-Variablen auf, die es überprüft. Der Remote Control-Abschnitt von `claude doctor` benennt die Anmeldedaten-Variable, die aufgehoben werden soll.

296 296

307 Senden Sie zusätzliche Header307 Senden Sie zusätzliche Header

308</h3>308</h3>

309 309

310Einige Gateways leiten oder kennzeichnen Anfragen mit einem benutzerdefinierten Header zusätzlich zur Anmeldedaten, z. B. eine Mandanten-ID oder einen Routing-Schlüssel. Um einen zu senden, legen Sie [`ANTHROPIC_CUSTOM_HEADERS`](/de/env-vars) mit einem `Name: Value`-Paar pro Zeile fest. Das Beispiel unten fügt einen Routing-Header namens `X-Org-Route` hinzu:310Einige Gateways leiten oder kennzeichnen Anfragen mit einem benutzerdefinierten Header zusätzlich zur Anmeldedaten, z. B. eine Mandanten-ID oder einen Routing-Schlüssel. Um einen zu senden, legen Sie [`ANTHROPIC_CUSTOM_HEADERS`](/docs/de/env-vars) mit einem `Name: Value`-Paar pro Zeile fest. Das Beispiel unten fügt einen Routing-Header namens `X-Org-Route` hinzu:

311 311

312<Tabs>312<Tabs>

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

341 341

342Aktivieren Sie es, wenn Ihr Gateway Modellnamen bereitstellt, die nicht in der integrierten Liste von Claude Code enthalten sind, und Sie diese aus dem Wähler auswählen möchten. Wenn die integrierten Modelle das sind, was Sie verwenden, benötigen Sie keine Ermittlung; Ihr Administrator hat sie möglicherweise auch bereits über verwaltete Einstellungen aktiviert.342Aktivieren Sie es, wenn Ihr Gateway Modellnamen bereitstellt, die nicht in der integrierten Liste von Claude Code enthalten sind, und Sie diese aus dem Wähler auswählen möchten. Wenn die integrierten Modelle das sind, was Sie verwenden, benötigen Sie keine Ermittlung; Ihr Administrator hat sie möglicherweise auch bereits über verwaltete Einstellungen aktiviert.

343 343

344Um sie zu aktivieren, legen Sie `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` in Ihrer Shell oder im `env`-Block von `~/.claude/settings.json` fest. Die Ermittlung erfordert Claude Code v2.1.129 oder später. {/* min-version: 2.1.129 */}344Um sie zu aktivieren, legen Sie `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` in Ihrer Shell oder im `env`-Block von `~/.claude/settings.json` fest. Die Ermittlung erfordert Claude Code v2.1.129 oder später. 

345 345

346Ermittelte Modelle werden als zusätzliche `/model`-Einträge mit der Bezeichnung `From gateway` angezeigt. Um zu bestätigen, dass die Ermittlung ausgeführt wurde, starten Sie `claude --debug` und suchen Sie nach den `[gatewayDiscovery]`-Zeilen: Ein Erfolg protokolliert, wie viele Modelle zwischengespeichert wurden, und ein `404`, Timeout oder Umleitung wird dort ebenfalls aufgezeichnet. Für den Zeitpunkt der Ermittlung, was sie filtert, und das Antwortformat, das Gateways bereitstellen, siehe die [Modellermittlungs-Referenz](/de/llm-gateway-protocol#model-discovery).346Ermittelte Modelle werden als zusätzliche `/model`-Einträge mit der Bezeichnung `From gateway` angezeigt. Um zu bestätigen, dass die Ermittlung ausgeführt wurde, starten Sie `claude --debug` und suchen Sie nach den `[gatewayDiscovery]`-Zeilen: Ein Erfolg protokolliert, wie viele Modelle zwischengespeichert wurden, und ein `404`, Timeout oder Umleitung wird dort ebenfalls aufgezeichnet. Für den Zeitpunkt der Ermittlung, was sie filtert, und das Antwortformat, das Gateways bereitstellen, siehe die [Modellermittlungs-Referenz](/docs/de/llm-gateway-protocol#model-discovery).

347 347

348<h3 id="rotate-credentials-with-apikeyhelper">348<h3 id="rotate-credentials-with-apikeyhelper">

349 Rotieren Sie Anmeldedaten mit apiKeyHelper349 Rotieren Sie Anmeldedaten mit apiKeyHelper

353 353

354Verwenden Sie einen Helper, wenn die Anmeldedaten nach einem Zeitplan ablaufen, aus einem Tresor oder SSO-Befehl stammen, oder Ihr Administrator Ihnen mitgeteilt hat, einen zu konfigurieren. Wenn Ihre Anmeldedaten eine feste Zeichenkette sind, die Sie einmal festlegen, ist die [Anmeldedaten-Variable](#set-the-credential-variable) alles, was Sie benötigen, und Sie können diesen Abschnitt überspringen.354Verwenden Sie einen Helper, wenn die Anmeldedaten nach einem Zeitplan ablaufen, aus einem Tresor oder SSO-Befehl stammen, oder Ihr Administrator Ihnen mitgeteilt hat, einen zu konfigurieren. Wenn Ihre Anmeldedaten eine feste Zeichenkette sind, die Sie einmal festlegen, ist die [Anmeldedaten-Variable](#set-the-credential-variable) alles, was Sie benötigen, und Sie können diesen Abschnitt überspringen.

355 355

356Der Helper ist ein beliebiger Shell-Befehl, der die aktuelle Anmeldedaten auf stdout ausgibt. Claude Code führt ihn durch Ihre System-Shell aus, daher kann er unter Windows eine ausführbare Datei oder eine PowerShell-Invokation sein. Schreiben Sie das Skript, machen Sie es ausführbar, und verweisen Sie darauf von `apiKeyHelper` in Ihrer [Einstellungsdatei](/de/settings):356Der Helper ist ein beliebiger Shell-Befehl, der die aktuelle Anmeldedaten auf stdout ausgibt. Claude Code führt ihn durch Ihre System-Shell aus, daher kann er unter Windows eine ausführbare Datei oder eine PowerShell-Invokation sein. Schreiben Sie das Skript, machen Sie es ausführbar, und verweisen Sie darauf von `apiKeyHelper` in Ihrer [Einstellungsdatei](/docs/de/settings):

357 357

358<Tabs>358<Tabs>

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

419Das Festlegen der Variablen hat diese Auswirkungen und Einschränkungen:419Das Festlegen der Variablen hat diese Auswirkungen und Einschränkungen:

420 420

421* Es deaktiviert automatische Updates, daher planen Sie einen anderen Update-Pfad, z. B. Ihren Paketmanager oder verwaltete Verteilung.421* Es deaktiviert automatische Updates, daher planen Sie einen anderen Update-Pfad, z. B. Ihren Paketmanager oder verwaltete Verteilung.

422* Es unterdrückt die [Schnellmodus](/de/fast-mode)-Verfügbarkeitsprüfung. Sofern eine vorherige Prüfung den Schnellmodus auf dem Computer nicht bereits aktiviert hat, meldet `/fast`, dass der Schnellmodus nicht verfügbar ist.422* Es unterdrückt die [Schnellmodus](/docs/de/fast-mode)-Verfügbarkeitsprüfung. Sofern eine vorherige Prüfung den Schnellmodus auf dem Computer nicht bereits aktiviert hat, meldet `/fast`, dass der Schnellmodus nicht verfügbar ist.

423* Es schaltet die [Gateway-Modellermittlung](#add-gateway-models-to-the-model-picker) aus, obwohl die Ermittlung das Gateway selbst abfragt. Zuvor ermittelte Modelle bleiben aus dem lokalen Cache verfügbar, aber die Liste wird nicht aktualisiert.423* Es schaltet die [Gateway-Modellermittlung](#add-gateway-models-to-the-model-picker) aus, obwohl die Ermittlung das Gateway selbst abfragt. Zuvor ermittelte Modelle bleiben aus dem lokalen Cache verfügbar, aber die Liste wird nicht aktualisiert.

424* Die [Domain-Sicherheitsprüfung](/de/data-usage#webfetch-domain-safety-check) des WebFetch-Tools ist nicht betroffen und ruft weiterhin `api.anthropic.com` auf. Schalten Sie sie separat mit `skipWebFetchPreflight: true` in [Einstellungen](/de/settings) aus, wenn Ihr Netzwerk diesen Host blockiert.424* Die [Domain-Sicherheitsprüfung](/docs/de/data-usage#webfetch-domain-safety-check) des WebFetch-Tools ist nicht betroffen und ruft weiterhin `api.anthropic.com` auf. Schalten Sie sie separat mit `skipWebFetchPreflight: true` in [Einstellungen](/docs/de/settings) aus, wenn Ihr Netzwerk diesen Host blockiert.

425* Für jeden Telemetrie-Stream und die Variable, die ihn steuert, siehe [Telemetrie-Services](/de/data-usage#telemetry-services).425* Für jeden Telemetrie-Stream und die Variable, die ihn steuert, siehe [Telemetrie-Services](/docs/de/data-usage#telemetry-services).

426 426

427<h3 id="route-to-a-cloud-provider-through-a-gateway">427<h3 id="route-to-a-cloud-provider-through-a-gateway">

428 Leiten Sie zu einem Cloud-Anbieter über ein Gateway weiter428 Leiten Sie zu einem Cloud-Anbieter über ein Gateway weiter

432 432

433Verwenden Sie eine nur, wenn Ihr Gateway-Team speziell Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder die Claude Platform on AWS benannt hat. Wenn die [Überprüfungsanfrage](#verify-the-connection) oben JSON zurückgegeben hat, können Sie diesen Abschnitt überspringen.433Verwenden Sie eine nur, wenn Ihr Gateway-Team speziell Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder die Claude Platform on AWS benannt hat. Wenn die [Überprüfungsanfrage](#verify-the-connection) oben JSON zurückgegeben hat, können Sie diesen Abschnitt überspringen.

434 434

435Legen Sie den Block für den Anbieter fest, den Ihr Gateway-Team benannt hat. Die Skip-Auth-Variablen teilen Claude Code mit, dass Anfragen nicht mit Anbieter-Anmeldedaten signiert werden sollen, da das Gateway diese hält. Wenn das Gateway sein eigenes Token benötigt, fügen Sie `ANTHROPIC_AUTH_TOKEN` nach dem Block hinzu, außer für Microsoft Foundry, das `ANTHROPIC_FOUNDRY_API_KEY` wie gezeigt verwendet. {/* min-version: 2.1.203 */}Ein Microsoft Foundry-Gateway, das einen Bearer-Token erwartet, kann stattdessen [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/de/env-vars) verwenden; es hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY`, wenn beide gesetzt sind. `ANTHROPIC_FOUNDRY_AUTH_TOKEN` erfordert Claude Code v2.1.203 oder später.435Legen Sie den Block für den Anbieter fest, den Ihr Gateway-Team benannt hat. Die Skip-Auth-Variablen teilen Claude Code mit, dass Anfragen nicht mit Anbieter-Anmeldedaten signiert werden sollen, da das Gateway diese hält. Wenn das Gateway sein eigenes Token benötigt, fügen Sie `ANTHROPIC_AUTH_TOKEN` nach dem Block hinzu, außer für Microsoft Foundry, das `ANTHROPIC_FOUNDRY_API_KEY` wie gezeigt verwendet. Ein Microsoft Foundry-Gateway, das einen Bearer-Token erwartet, kann stattdessen [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/docs/de/env-vars) verwenden; es hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY`, wenn beide gesetzt sind. `ANTHROPIC_FOUNDRY_AUTH_TOKEN` erfordert Claude Code v2.1.203 oder später.

436 436

437<h4 id="amazon-bedrock">437<h4 id="amazon-bedrock">

438 Amazon Bedrock438 Amazon Bedrock

486 Microsoft Foundry486 Microsoft Foundry

487</h4>487</h4>

488 488

489Legen Sie die Anmeldedaten des Gateways in `ANTHROPIC_FOUNDRY_API_KEY` fest; sie werden an das Gateway als `x-api-key`-Header gesendet. {/* min-version: 2.1.203 */}Ein Gateway, das einen Bearer-Token erwartet, kann stattdessen [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/de/env-vars) verwenden. Claude Code sendet diesen Wert als `Authorization: Bearer`-Header, und er hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY`, wenn beide gesetzt sind. Erfordert Claude Code v2.1.203 oder später.489Legen Sie die Anmeldedaten des Gateways in `ANTHROPIC_FOUNDRY_API_KEY` fest; sie werden an das Gateway als `x-api-key`-Header gesendet. Ein Gateway, das einen Bearer-Token erwartet, kann stattdessen [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/docs/de/env-vars) verwenden. Claude Code sendet diesen Wert als `Authorization: Bearer`-Header, und er hat Vorrang vor `ANTHROPIC_FOUNDRY_API_KEY`, wenn beide gesetzt sind. Erfordert Claude Code v2.1.203 oder später.

490 490

491Für ein Gateway, das seinen eigenen `Authorization`-Header injiziert, legen Sie `CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` fest und lassen Sie beide Anmeldedaten-Variablen ungesetzt. Claude Code sendet dann Anfragen ohne eine Azure-Anmeldedaten und bewahrt den `Authorization`-Header, den Sie bereitstellen, z. B. durch `ANTHROPIC_CUSTOM_HEADERS`. {/* min-version: 2.1.203 */}Vor v2.1.203 ließ `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` ohne einen API-Schlüssel den Microsoft Foundry-Client unfähig, Anfragen zu senden.491Für ein Gateway, das seinen eigenen `Authorization`-Header injiziert, legen Sie `CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` fest und lassen Sie beide Anmeldedaten-Variablen ungesetzt. Claude Code sendet dann Anfragen ohne eine Azure-Anmeldedaten und bewahrt den `Authorization`-Header, den Sie bereitstellen, z. B. durch `ANTHROPIC_CUSTOM_HEADERS`. Vor v2.1.203 ließ `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` ohne einen API-Schlüssel den Microsoft Foundry-Client unfähig, Anfragen zu senden.

492 492

493<Tabs>493<Tabs>

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

512 Claude Platform on AWS512 Claude Platform on AWS

513</h4>513</h4>

514 514

515Siehe [Claude Platform on AWS](/de/claude-platform-on-aws) für die Workspace-ID.515Siehe [Claude Platform on AWS](/docs/de/claude-platform-on-aws) für die Workspace-ID.

516 516

517<Tabs>517<Tabs>

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

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

545| Eine Start-Warnung, die zwei Anmeldedaten-Quellen benennt und mit `auth may not work as expected` endet. Ältere Versionen zeigen stattdessen `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` an. | Eine Gateway-Anmeldedaten und ein gespeicherter Login sind beide aktiv; die Variable wird für Anfragen verwendet, aber der veraltete Login kann zu unerwartetem Auth-Verhalten führen | Heben Sie die Festlegung der Variable auf, um den gespeicherten Login zu verwenden, oder führen Sie `/logout` aus, um die Gateway-Anmeldedaten zu verwenden |545| Eine Start-Warnung, die zwei Anmeldedaten-Quellen benennt und mit `auth may not work as expected` endet. Ältere Versionen zeigen stattdessen `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` an. | Eine Gateway-Anmeldedaten und ein gespeicherter Login sind beide aktiv; die Variable wird für Anfragen verwendet, aber der veraltete Login kann zu unerwartetem Auth-Verhalten führen | Heben Sie die Festlegung der Variable auf, um den gespeicherten Login zu verwenden, oder führen Sie `/logout` aus, um die Gateway-Anmeldedaten zu verwenden |

546| `401`-Fehler, die ein ungültiges oder nicht erkanntes Token benennen | Die Anmeldedaten sind nicht eine, die das Gateway ausgestellt hat, oder sie sind in einem Header, den das Gateway nicht liest | Bestätigen Sie, dass die Variable Ihrer Anmeldedaten-Art in der [Anmeldedaten-Tabelle](#set-the-credential-variable) entspricht, und generieren Sie den Schlüssel beim Gateway neu, wenn er widerrufen wurde |546| `401`-Fehler, die ein ungültiges oder nicht erkanntes Token benennen | Die Anmeldedaten sind nicht eine, die das Gateway ausgestellt hat, oder sie sind in einem Header, den das Gateway nicht liest | Bestätigen Sie, dass die Variable Ihrer Anmeldedaten-Art in der [Anmeldedaten-Tabelle](#set-the-credential-variable) entspricht, und generieren Sie den Schlüssel beim Gateway neu, wenn er widerrufen wurde |

547| `Your apiKeyHelper script is failing` | Der Befehl in der [`apiKeyHelper`](/de/settings#available-settings)-Einstellung ist mit einem Fehler beendet worden, hat das Zeitlimit überschritten oder nichts ausgegeben, daher enthalten Anfragen einen Platzhalter-Schlüssel | Führen Sie den Befehl direkt aus, um zu sehen, warum er fehlschlägt, und authentifizieren Sie sich erneut bei Ihrem Anmeldedaten-Anbieter, wenn dieser eine abgelaufene Sitzung meldet; siehe [die Fehlerreferenz](/de/errors#your-apikeyhelper-script-is-failing) |547| `Your apiKeyHelper script is failing` | Der Befehl in der [`apiKeyHelper`](/docs/de/settings#available-settings)-Einstellung ist mit einem Fehler beendet worden, hat das Zeitlimit überschritten oder nichts ausgegeben, daher enthalten Anfragen einen Platzhalter-Schlüssel | Führen Sie den Befehl direkt aus, um zu sehen, warum er fehlschlägt, und authentifizieren Sie sich erneut bei Ihrem Anmeldedaten-Anbieter, wenn dieser eine abgelaufene Sitzung meldet; siehe [die Fehlerreferenz](/docs/de/errors#your-apikeyhelper-script-is-failing) |

548| `Unable to connect to API (ConnectionRefused)`, oder `(ECONNREFUSED)` von npm-Installationen, oft nach einer stillen Pause, während Claude Code [mit Backoff erneut versucht](/de/errors#automatic-retries) | Nichts antwortete unter der Basis-URL: Die Adresse ist falsch, oder ein VPN oder eine Firewall blockiert den Pfad zum Gateway | Führen Sie den [curl-Test oben](#verify-the-connection) aus, der sofort mit der gleichen Ursache fehlschlägt, und bestätigen Sie die URL und den Netzwerkpfad mit Ihrem Gateway-Team |548| `Unable to connect to API (ConnectionRefused)`, oder `(ECONNREFUSED)` von npm-Installationen, oft nach einer stillen Pause, während Claude Code [mit Backoff erneut versucht](/docs/de/errors#automatic-retries) | Nichts antwortete unter der Basis-URL: Die Adresse ist falsch, oder ein VPN oder eine Firewall blockiert den Pfad zum Gateway | Führen Sie den [curl-Test oben](#verify-the-connection) aus, der sofort mit der gleichen Ursache fehlschlägt, und bestätigen Sie die URL und den Netzwerkpfad mit Ihrem Gateway-Team |

549| `API returned an empty or malformed response (HTTP 200)` | Das Gateway oder ein zwischengelagerter Proxy gab eine Nicht-API-Antwort zurück, oft eine HTML-Fehler oder Anmeldeseite | Testen Sie mit der [curl-Anfrage oben](#verify-the-connection); beheben Sie die Gateway-Route, die Nicht-JSON zurückgibt |549| `API returned an empty or malformed response (HTTP 200)` | Das Gateway oder ein zwischengelagerter Proxy gab eine Nicht-API-Antwort zurück, oft eine HTML-Fehler oder Anmeldeseite | Testen Sie mit der [curl-Anfrage oben](#verify-the-connection); beheben Sie die Gateway-Route, die Nicht-JSON zurückgibt |

550| `400`-Fehler, die `context_management`, `Extra inputs are not permitted` oder andere nicht erkannte Felder benennen | Das Gateway leitet Anfragen an einen Upstream weiter, der Felder ablehnt, die Claude Code an Anthropic-Format-Endpunkte sendet | Legen Sie `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` fest, das die meisten Pre-Release-Felder unterdrückt; siehe [Feature-Durchleitung](/de/llm-gateway-protocol#feature-pass-through). Einige Betas werden nicht durch dieses Flag gated; für diese legen Sie die passende `CLAUDE_CODE_USE_*`-Anbieter-Variable fest, damit Claude Code nur das sendet, das dieser Anbieter akzeptiert |550| `400`-Fehler, die `context_management`, `Extra inputs are not permitted` oder andere nicht erkannte Felder benennen | Das Gateway leitet Anfragen an einen Upstream weiter, der Felder ablehnt, die Claude Code an Anthropic-Format-Endpunkte sendet | Legen Sie `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` fest, das die meisten Pre-Release-Felder unterdrückt; siehe [Feature-Durchleitung](/docs/de/llm-gateway-protocol#feature-pass-through). Einige Betas werden nicht durch dieses Flag gated; für diese legen Sie die passende `CLAUDE_CODE_USE_*`-Anbieter-Variable fest, damit Claude Code nur das sendet, das dieser Anbieter akzeptiert |

551| `400`-Fehler, die `thinking` oder `adaptive` benennen, z. B. `Input tag 'adaptive' found` | Der Upstream-Modell-Build akzeptiert keine adaptive Überlegung, die Claude Code für Claude 4.6 und neuere Modelle anfordert | Aktualisieren Sie den Upstream des Gateways. Auf Opus 4.6 und Sonnet 4.6 funktioniert stattdessen `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`. Die [Modellkonfiguration](/de/model-config)-Fähigkeitsvariablen gelten nur für die Anbieter-Konfigurationen, z. B. `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_VERTEX`, nicht hinter einem `ANTHROPIC_BASE_URL`-Gateway |551| `400`-Fehler, die `thinking` oder `adaptive` benennen, z. B. `Input tag 'adaptive' found` | Der Upstream-Modell-Build akzeptiert keine adaptive Überlegung, die Claude Code für Claude 4.6 und neuere Modelle anfordert | Aktualisieren Sie den Upstream des Gateways. Auf Opus 4.6 und Sonnet 4.6 funktioniert stattdessen `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`. Die [Modellkonfiguration](/docs/de/model-config)-Fähigkeitsvariablen gelten nur für die Anbieter-Konfigurationen, z. B. `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_VERTEX`, nicht hinter einem `ANTHROPIC_BASE_URL`-Gateway |

552| `400`-Fehler, die einen Kontext- oder Token-Limit in den eigenen Worten des Gateways angeben, z. B. `ContextWindowExceededError` oder `prompt token count of N exceeds the limit of M` | Das Gateway erzwingt ein kleineres Kontext als das native Fenster des Modells und schreibt den Upstream-Fehler um, daher wird die automatische Komprimierung und Wiederholung, die Anthropics `prompt is too long`-Wortlaut entspricht, nicht ausgelöst | Führen Sie `/compact` aus, um die Sitzung wiederherzustellen. Um dies zu verhindern, legen Sie `CLAUDE_CODE_AUTO_COMPACT_WINDOW` auf das Limit des Gateways fest; der Wert wird auf mindestens 100.000 Token und höchstens das Kontext-Fenster des Modells begrenzt, daher kann ein Gateway-Limit unter 100.000 nicht abgeglichen werden und `/compact` bleibt die Wiederherstellung dort. Legen Sie auch `CLAUDE_CODE_MAX_OUTPUT_TOKENS` unter das Output-Limit des Gateway-Modells fest |552| `400`-Fehler, die einen Kontext- oder Token-Limit in den eigenen Worten des Gateways angeben, z. B. `ContextWindowExceededError` oder `prompt token count of N exceeds the limit of M` | Das Gateway erzwingt ein kleineres Kontext als das native Fenster des Modells und schreibt den Upstream-Fehler um, daher wird die automatische Komprimierung und Wiederholung, die Anthropics `prompt is too long`-Wortlaut entspricht, nicht ausgelöst | Führen Sie `/compact` aus, um die Sitzung wiederherzustellen. Um dies zu verhindern, legen Sie `CLAUDE_CODE_AUTO_COMPACT_WINDOW` auf das Limit des Gateways fest; der Wert wird auf mindestens 100.000 Token und höchstens das Kontext-Fenster des Modells begrenzt, daher kann ein Gateway-Limit unter 100.000 nicht abgeglichen werden und `/compact` bleibt die Wiederherstellung dort. Legen Sie auch `CLAUDE_CODE_MAX_OUTPUT_TOKENS` unter das Output-Limit des Gateway-Modells fest |

553| Modelle fehlen im `/model`-Wähler | Gateway-Modellnamen sind nicht in der integrierten Liste von Claude Code enthalten | Aktivieren Sie die [Gateway-Modellermittlung](#add-gateway-models-to-the-model-picker) oder fügen Sie Namen mit den [Modellkonfiguration](/de/model-config)-Variablen hinzu |553| Modelle fehlen im `/model`-Wähler | Gateway-Modellnamen sind nicht in der integrierten Liste von Claude Code enthalten | Aktivieren Sie die [Gateway-Modellermittlung](#add-gateway-models-to-the-model-picker) oder fügen Sie Namen mit den [Modellkonfiguration](/docs/de/model-config)-Variablen hinzu |

554| Claude Code fordert Sie auf, sich anzumelden, obwohl der [curl-Test](#verify-the-connection) erfolgreich ist | Die CLI hat keine eigene Anmeldedaten: Eine erreichbare Basis-URL ist keine, und ein `env`-Block in einer Projekt-`.claude/settings.json` oder `.claude/settings.local.json` gilt nur nach dem First-Run-Wizard und der Vertrauensaufforderung | Legen Sie `ANTHROPIC_AUTH_TOKEN` irgendwo fest, wo Claude Code vor dem First-Run-Setup liest: ein Shell-Export, der `env`-Block in `~/.claude/settings.json` oder verwaltete Einstellungen |554| Claude Code fordert Sie auf, sich anzumelden, obwohl der [curl-Test](#verify-the-connection) erfolgreich ist | Die CLI hat keine eigene Anmeldedaten: Eine erreichbare Basis-URL ist keine, und ein `env`-Block in einer Projekt-`.claude/settings.json` oder `.claude/settings.local.json` gilt nur nach dem First-Run-Wizard und der Vertrauensaufforderung | Legen Sie `ANTHROPIC_AUTH_TOKEN` irgendwo fest, wo Claude Code vor dem First-Run-Setup liest: ein Shell-Export, der `env`-Block in `~/.claude/settings.json` oder verwaltete Einstellungen |

555| `ANTHROPIC_API_KEY` ist festgelegt, wird aber ignoriert, ohne Aufforderung | Der Schlüssel benötigt eine einmalige Genehmigung in interaktiven Sitzungen, und ein zuvor abgelehnter Schlüssel wird ohne erneute Frage ignoriert | Aktivieren Sie ihn unter `/config` mit der Option `Use custom API key` |555| `ANTHROPIC_API_KEY` ist festgelegt, wird aber ignoriert, ohne Aufforderung | Der Schlüssel benötigt eine einmalige Genehmigung in interaktiven Sitzungen, und ein zuvor abgelehnter Schlüssel wird ohne erneute Frage ignoriert | Aktivieren Sie ihn unter `/config` mit der Option `Use custom API key` |

556| `This machine's managed settings require a first-party login` | Verwaltete Einstellungen enthalten `forceLoginMethod` oder `forceLoginOrgUUID`, die auf Claude Code v2.1.146 und später nicht mit `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` koexistieren können | Ihr Administrator muss `forceLoginMethod` und `forceLoginOrgUUID` aus verwalteten Einstellungen entfernen, um Gateway-Anmeldedaten zu verwenden, oder die Gateway-Anmeldedaten entfernen, um First-Party-Login zu verwenden. Die beiden können nicht kombiniert werden |556| `This machine's managed settings require a first-party login` | Verwaltete Einstellungen enthalten `forceLoginMethod` oder `forceLoginOrgUUID`, die auf Claude Code v2.1.146 und später nicht mit `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` koexistieren können | Ihr Administrator muss `forceLoginMethod` und `forceLoginOrgUUID` aus verwalteten Einstellungen entfernen, um Gateway-Anmeldedaten zu verwenden, oder die Gateway-Anmeldedaten entfernen, um First-Party-Login zu verwenden. Die beiden können nicht kombiniert werden |

557| `403` mit einem HTML-Body wie `403 Forbidden`, wenn die eigenen Logs des Gateways zeigen, dass keine Anfrage empfangen wurde | Eine Web-Anwendungs-Firewall oder ein Reverse-Proxy vor dem Gateway blockierte den Anfrage-Body, bevor er das Gateway erreichte. Claude Code-Eingabeaufforderungen enthalten XML-ähnliche Tags und Quellcode, die Cross-Site-Scripting-Body-Regeln entsprechen, daher besteht ein kurzer curl-Test, während eine echte Sitzung nicht besteht | Befreien Sie den `/v1/messages`-Pfad des Gateways von der Anfrage-Body-Inspektion. Auf AWS WAF ist dies die verwaltete Regel `CrossSiteScripting_Body`; auf nginx mit ModSecurity sind dies die äquivalenten OWASP CRS-Body-Regeln |557| `403` mit einem HTML-Body wie `403 Forbidden`, wenn die eigenen Logs des Gateways zeigen, dass keine Anfrage empfangen wurde | Eine Web-Anwendungs-Firewall oder ein Reverse-Proxy vor dem Gateway blockierte den Anfrage-Body, bevor er das Gateway erreichte. Claude Code-Eingabeaufforderungen enthalten XML-ähnliche Tags und Quellcode, die Cross-Site-Scripting-Body-Regeln entsprechen, daher besteht ein kurzer curl-Test, während eine echte Sitzung nicht besteht | Befreien Sie den `/v1/messages`-Pfad des Gateways von der Anfrage-Body-Inspektion. Auf AWS WAF ist dies die verwaltete Regel `CrossSiteScripting_Body`; auf nginx mit ModSecurity sind dies die äquivalenten OWASP CRS-Body-Regeln |

558| Zertifikat- oder TLS-Fehler wie `SSL certificate verification failed` oder `Self-signed certificate detected`, wenn der [curl-Test](#verify-the-connection) erfolgreich ist | Die Runtime von Claude Code vertraut nicht der gleichen Zertifizierungsstelle, die `curl` verwendet. Häufig hinter Unternehmens-TLS-Inspektions-Proxys | Legen Sie `NODE_EXTRA_CA_CERTS` auf den CA-Bundle-Pfad fest; siehe [CA-Zertifikat-Speicher](/de/network-config#ca-certificate-store) |558| Zertifikat- oder TLS-Fehler wie `SSL certificate verification failed` oder `Self-signed certificate detected`, wenn der [curl-Test](#verify-the-connection) erfolgreich ist | Die Runtime von Claude Code vertraut nicht der gleichen Zertifizierungsstelle, die `curl` verwendet. Häufig hinter Unternehmens-TLS-Inspektions-Proxys | Legen Sie `NODE_EXTRA_CA_CERTS` auf den CA-Bundle-Pfad fest; siehe [CA-Zertifikat-Speicher](/docs/de/network-config#ca-certificate-store) |

559 559

560Wenn Claude Code Sie nach dem Entfernen der Gateway-Konfiguration wiederholt auffordert, sich anzumelden, ist die Ursache normalerweise Anmeldedaten-Speicherung statt des Gateways; siehe [Authentifizierungsfehler](/de/errors#authentication-errors).560Wenn Claude Code Sie nach dem Entfernen der Gateway-Konfiguration wiederholt auffordert, sich anzumelden, ist die Ursache normalerweise Anmeldedaten-Speicherung statt des Gateways; siehe [Authentifizierungsfehler](/docs/de/errors#authentication-errors).

561 561

562<h2 id="related-resources">562<h2 id="related-resources">

563 Verwandte Ressourcen563 Verwandte Ressourcen

564</h2>564</h2>

565 565

566* [LLM-Gateways-Übersicht](/de/llm-gateway): Was ein Gateway ist und wie es mit claude.ai-Abonnements interagiert566* [LLM-Gateways-Übersicht](/docs/de/llm-gateway): Was ein Gateway ist und wie es mit claude.ai-Abonnements interagiert

567* [Rollout eines LLM-Gateways für Ihre Organisation](/de/llm-gateway-rollout): Die Admin-seitige Checkliste für die Bereitstellung und Verteilung der Gateway-Konfiguration567* [Rollout eines LLM-Gateways für Ihre Organisation](/docs/de/llm-gateway-rollout): Die Admin-seitige Checkliste für die Bereitstellung und Verteilung der Gateway-Konfiguration

568* [Gateway-Protokoll-Referenz](/de/llm-gateway-protocol): Was Claude Code an ein Gateway sendet, einschließlich der Header und Felder, die das Gateway weiterleiten muss568* [Gateway-Protokoll-Referenz](/docs/de/llm-gateway-protocol): Was Claude Code an ein Gateway sendet, einschließlich der Header und Felder, die das Gateway weiterleiten muss

569* [Einstellungen](/de/settings): Wo Einstellungsdateien leben und wie der `env`-Block gelesen wird569* [Einstellungen](/docs/de/settings): Wo Einstellungsdateien leben und wie der `env`-Block gelesen wird

570* [Authentifizierung](/de/authentication): Wie Anmeldedaten-Variablen, `apiKeyHelper` und OAuth-Login interagieren570* [Authentifizierung](/docs/de/authentication): Wie Anmeldedaten-Variablen, `apiKeyHelper` und OAuth-Login interagieren

llm-gateway-protocol.md +24 −24

Details

8 8

9Diese Seite dokumentiert die Anfragen, die Claude Code an ein Gateway sendet, einschließlich der Endpunkte, die es aufruft, der Header und Body-Felder, die das Gateway weiterleiten muss, und welche Funktionen nicht mehr funktionieren, wenn dies nicht der Fall ist. Sie ist für Operatoren geschrieben, die ein Gateway-Produkt für die Zusammenarbeit mit Claude Code konfigurieren.9Diese Seite dokumentiert die Anfragen, die Claude Code an ein Gateway sendet, einschließlich der Endpunkte, die es aufruft, der Header und Body-Felder, die das Gateway weiterleiten muss, und welche Funktionen nicht mehr funktionieren, wenn dies nicht der Fall ist. Sie ist für Operatoren geschrieben, die ein Gateway-Produkt für die Zusammenarbeit mit Claude Code konfigurieren.

10 10

11Ein laufendes [Claude-Apps-Gateway](/de/claude-apps-gateway) stellt eine maschinenlesbare Version dieses Vertrags unter `GET /protocol` bereit, die dieselben Weiterleitungsanforderungen sowie die Claude-Apps-Gateway-spezifischen Endpunkte für SSO-Anmeldung, verwaltete Einstellungsbereitstellung und Telemetrie abdeckt. Claude-Apps-Gateway wird aus derselben `claude`-Binärdatei wie die CLI ausgeführt, daher ist der [Claude-Apps-Gateway-Schnellstart](/de/claude-apps-gateway#quickstart) der kürzeste Weg zu einer laufenden Instanz, von der Sie die Spezifikation abrufen können.11Ein laufendes [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) stellt eine maschinenlesbare Version dieses Vertrags unter `GET /protocol` bereit, die dieselben Weiterleitungsanforderungen sowie die Claude-Apps-Gateway-spezifischen Endpunkte für SSO-Anmeldung, verwaltete Einstellungsbereitstellung und Telemetrie abdeckt. Claude-Apps-Gateway wird aus derselben `claude`-Binärdatei wie die CLI ausgeführt, daher ist der [Claude-Apps-Gateway-Schnellstart](/docs/de/claude-apps-gateway#quickstart) der kürzeste Weg zu einer laufenden Instanz, von der Sie die Spezifikation abrufen können.

12 12

13<Note>13<Note>

~~14 * Um ein vorhandenes oder Gateway eines Drittanbieters für Ihre Organisation bereitzustellen, siehe [LLM-Gateway bereitstellen](/de/llm-gateway-rollout)~~14 * Um ein vorhandenes oder Gateway eines Drittanbieters für Ihre Organisation bereitzustellen, siehe [LLM-Gateway bereitstellen](/docs/de/llm-gateway-rollout)

15 * Wenn Sie ein einzelner Entwickler sind, der Claude Code mit einer Anmeldedaten, die Sie erhalten haben, bei einem Gateway authentifiziert, siehe [Claude Code mit einem LLM-Gateway verbinden](/de/llm-gateway-connect)15 * Wenn Sie ein einzelner Entwickler sind, der Claude Code mit einer Anmeldedaten, die Sie erhalten haben, bei einem Gateway authentifiziert, siehe [Claude Code mit einem LLM-Gateway verbinden](/docs/de/llm-gateway-connect)

16</Note>16</Note>

17 17

18Diese Seite behandelt:18Diese Seite behandelt:

46 Foundry und Claude Platform on AWS46 Foundry und Claude Platform on AWS

47</h3>47</h3>

48 48

49Microsoft Foundry und die [Claude Platform on AWS](/de/claude-platform-on-aws) implementieren das Anthropic Messages-Format. Claude Code leitet sie über ihre eigenen Variablen weiter, `ANTHROPIC_FOUNDRY_BASE_URL` und `ANTHROPIC_AWS_BASE_URL`, aber ein Gateway, das eines von beiden frontet, implementiert die Anthropic Messages-Zeile oben. Ein Gateway, das die Claude Platform on AWS frontet, muss auch den `anthropic-workspace-id`-Header weiterleiten, den [diese Plattform bei jeder Anfrage benötigt](/de/claude-platform-on-aws).49Microsoft Foundry und die [Claude Platform on AWS](/docs/de/claude-platform-on-aws) implementieren das Anthropic Messages-Format. Claude Code leitet sie über ihre eigenen Variablen weiter, `ANTHROPIC_FOUNDRY_BASE_URL` und `ANTHROPIC_AWS_BASE_URL`, aber ein Gateway, das eines von beiden frontet, implementiert die Anthropic Messages-Zeile oben. Ein Gateway, das die Claude Platform on AWS frontet, muss auch den `anthropic-workspace-id`-Header weiterleiten, den [diese Plattform bei jeder Anfrage benötigt](/docs/de/claude-platform-on-aws).

50 50

51<h3 id="optional-endpoints-and-startup-traffic">51<h3 id="optional-endpoints-and-startup-traffic">

52 Optionale Endpunkte und Startup-Traffic52 Optionale Endpunkte und Startup-Traffic

77 Request-Header77 Request-Header

78</h2>78</h2>

79 79

80Claude Code enthält diese Header bei API-Anfragen. Header-Namen sind auf dem Draht case-insensitiv. Leiten Sie `anthropic-version` und `anthropic-beta` unverändert weiter, plus `anthropic-workspace-id`, wenn das Upstream die [Claude Platform on AWS](/de/claude-platform-on-aws) ist; der Rest kann vom Gateway zum Routing, zur Zuordnung und zum Tracing verbraucht werden und muss nicht weitergeleitet werden.80Claude Code enthält diese Header bei API-Anfragen. Header-Namen sind auf dem Draht case-insensitiv. Leiten Sie `anthropic-version` und `anthropic-beta` unverändert weiter, plus `anthropic-workspace-id`, wenn das Upstream die [Claude Platform on AWS](/docs/de/claude-platform-on-aws) ist; der Rest kann vom Gateway zum Routing, zur Zuordnung und zum Tracing verbraucht werden und muss nicht weitergeleitet werden.

81 81

83| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |83| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

84| `Authorization`, `x-api-key` | Die Gateway-Anmeldedaten des Entwicklers, in einem oder beiden Headern, je nachdem, welche [Anmeldedaten-Variable](/de/llm-gateway-connect#set-the-credential-variable) sie setzen |84| `Authorization`, `x-api-key` | Die Gateway-Anmeldedaten des Entwicklers, in einem oder beiden Headern, je nachdem, welche [Anmeldedaten-Variable](/docs/de/llm-gateway-connect#set-the-credential-variable) sie setzen |

85| `anthropic-version` | API-Version, derzeit `2023-06-01`. Amazon Bedrock- und Google Cloud Agent Platform-Format-Anfragen enthalten auch das `anthropic_version` Body-Feld, dessen Wert die Provider-Dialekt-Zeichenkette ist, nicht der Wert dieses Headers |85| `anthropic-version` | API-Version, derzeit `2023-06-01`. Amazon Bedrock- und Google Cloud Agent Platform-Format-Anfragen enthalten auch das `anthropic_version` Body-Feld, dessen Wert die Provider-Dialekt-Zeichenkette ist, nicht der Wert dieses Headers |

86| `anthropic-beta` | Komma-getrennte Funktionswerte für die Anfrage. Leiten Sie den Header wörtlich weiter; erstellen Sie keine Allowlist einzelner Werte, da sich die Menge mit Claude Code-Versionen ändert. Wenn sich der Entwickler mit einer claude.ai-Anmeldung authentifiziert, was möglich ist, wenn `ANTHROPIC_BASE_URL` ohne eine Gateway-Anmeldedaten-Variable gesetzt ist, trägt dieser Header auch eine OAuth-Funktion, die das Upstream benötigt, und das Löschen führt zu `401` Fehlern bei diesen Anfragen |86| `anthropic-beta` | Komma-getrennte Funktionswerte für die Anfrage. Leiten Sie den Header wörtlich weiter; erstellen Sie keine Allowlist einzelner Werte, da sich die Menge mit Claude Code-Versionen ändert. Wenn sich der Entwickler mit einer claude.ai-Anmeldung authentifiziert, was möglich ist, wenn `ANTHROPIC_BASE_URL` ohne eine Gateway-Anmeldedaten-Variable gesetzt ist, trägt dieser Header auch eine OAuth-Funktion, die das Upstream benötigt, und das Löschen führt zu `401` Fehlern bei diesen Anfragen |

87| `x-claude-code-session-id` | Ein eindeutiger Bezeichner für die aktuelle Claude Code-Sitzung. Verwenden Sie ihn, um alle Anfragen aus einer Sitzung zu aggregieren, ohne Request-Bodies zu analysieren |87| `x-claude-code-session-id` | Ein eindeutiger Bezeichner für die aktuelle Claude Code-Sitzung. Verwenden Sie ihn, um alle Anfragen aus einer Sitzung zu aggregieren, ohne Request-Bodies zu analysieren |

88| `x-claude-code-agent-id` | Bezeichner des [Subagenten](/de/sub-agents), der die Anfrage gestellt hat, vorhanden nur bei Anfragen von einem Agenten, den Claude Code in der Sitzung spawnt. Verwenden Sie ihn mit der Sitzungs-ID, um Kosten parallelen Agenten zuzuordnen |88| `x-claude-code-agent-id` | Bezeichner des [Subagenten](/docs/de/sub-agents), der die Anfrage gestellt hat, vorhanden nur bei Anfragen von einem Agenten, den Claude Code in der Sitzung spawnt. Verwenden Sie ihn mit der Sitzungs-ID, um Kosten parallelen Agenten zuzuordnen |

89| `x-claude-code-parent-agent-id` | Bezeichner des Agenten, der den anfragenden Agenten spawnt, vorhanden nur für verschachtelte Agenten |89| `x-claude-code-parent-agent-id` | Bezeichner des Agenten, der den anfragenden Agenten spawnt, vorhanden nur für verschachtelte Agenten |

90 90

91Subagenten-IDs werden bei jedem Spawn neu generiert. Teamkollegen-Agenten, die benannten Mitglieder eines [Agenten-Teams](/de/agent-teams), verwenden eine stabile namensbasierte ID über Wiederverbindungen hinweg. In beiden Fällen identifiziert die ID einen Agenten, keine Person oder ein Gerät, daher behandeln Sie den Agenten-ID-Header nicht als Benutzerkennung.91Subagenten-IDs werden bei jedem Spawn neu generiert. Teamkollegen-Agenten, die benannten Mitglieder eines [Agenten-Teams](/docs/de/agent-teams), verwenden eine stabile namensbasierte ID über Wiederverbindungen hinweg. In beiden Fällen identifiziert die ID einen Agenten, keine Person oder ein Gerät, daher behandeln Sie den Agenten-ID-Header nicht als Benutzerkennung.

92 92

93Wenn Ihre Entwickler `ANTHROPIC_CUSTOM_HEADERS` setzen, erscheinen diese Header auch bei Anfragen.93Wenn Ihre Entwickler `ANTHROPIC_CUSTOM_HEADERS` setzen, erscheinen diese Header auch bei Anfragen.

94 94

112 112

113* Leiten Sie das `system` Array genau wie empfangen weiter, wobei Sie den Block an erster Stelle halten: Das Voranstellen eines weiteren System-Blocks, das Neuordnen des Arrays oder das Konvertieren in einen einzelnen String besiegt das Löschen, und der Block erreicht dann das Modell und den Prompt-Cache-Schlüssel.113* Leiten Sie das `system` Array genau wie empfangen weiter, wobei Sie den Block an erster Stelle halten: Das Voranstellen eines weiteren System-Blocks, das Neuordnen des Arrays oder das Konvertieren in einen einzelnen String besiegt das Löschen, und der Block erreicht dann das Modell und den Prompt-Cache-Schlüssel.

114* Halten Sie den Block in seinem eigenen Array-Eintrag: Der Endpunkt behandelt einen zusammengeführten Block, der mit dem Attributions-Header beginnt, als Attribution in ihrer Gesamtheit und löscht alles, das darin zusammengeführt wurde, einschließlich des restlichen System-Prompts.114* Halten Sie den Block in seinem eigenen Array-Eintrag: Der Endpunkt behandelt einen zusammengeführten Block, der mit dem Attributions-Header beginnt, als Attribution in ihrer Gesamtheit und löscht alles, das darin zusammengeführt wurde, einschließlich des restlichen System-Prompts.

115* Wenn Ihr Gateway System-Inhalte umgestalten muss, setzen Sie [`CLAUDE_CODE_ATTRIBUTION_HEADER=0`](/de/env-vars), damit Claude Code den Block auslässt. Anthropic und die Claude-Endpunkte der Cloud-Provider lesen den Block zur Zuordnung, daher lassen Sie ihn auf der Client-Seite aus, anstatt ihn im Gateway zu löschen oder zu verschieben.115* Wenn Ihr Gateway System-Inhalte umgestalten muss, setzen Sie [`CLAUDE_CODE_ATTRIBUTION_HEADER=0`](/docs/de/env-vars), damit Claude Code den Block auslässt. Anthropic und die Claude-Endpunkte der Cloud-Provider lesen den Block zur Zuordnung, daher lassen Sie ihn auf der Client-Seite aus, anstatt ihn im Gateway zu löschen oder zu verschieben.

116 116

117Anfragen, die unverändert den Endpunkt erreichen, sind nicht betroffen.117Anfragen, die unverändert den Endpunkt erreichen, sind nicht betroffen.

118 118

119{/* min-version: 2.1.181 */}Ab Claude Code v2.1.181 ist der Block für die Lebensdauer eines Gesprächs stabil, wenn Anfragen durch eine benutzerdefinierte Basis-URL geleitet werden, daher funktioniert ein Gateway-seitiger Prompt-Cache, der auf dem vollständigen Request-Body basiert, ohne ihn zu deaktivieren. Vor v2.1.181 enthielt der Block ein Pro-Request-Token; setzen Sie auf diesen Versionen `CLAUDE_CODE_ATTRIBUTION_HEADER=0`, wenn Ihr Gateway einen solchen Cache implementiert.119Ab Claude Code v2.1.181 ist der Block für die Lebensdauer eines Gesprächs stabil, wenn Anfragen durch eine benutzerdefinierte Basis-URL geleitet werden, daher funktioniert ein Gateway-seitiger Prompt-Cache, der auf dem vollständigen Request-Body basiert, ohne ihn zu deaktivieren. Vor v2.1.181 enthielt der Block ein Pro-Request-Token; setzen Sie auf diesen Versionen `CLAUDE_CODE_ATTRIBUTION_HEADER=0`, wenn Ihr Gateway einen solchen Cache implementiert.

120 120

121<h2 id="feature-pass-through">121<h2 id="feature-pass-through">

122 Funktionsdurchleitung122 Funktionsdurchleitung

126 126

127Funktionen, die Body-Felder hinzufügen, paaren sie mit einem Beta-Header, und das Paar reist zusammen. Ein Gateway, das den Header löscht, während es den Body durchleitet, oder ein Anthropic-Format-Body an ein Upstream mit einem anderen Schema weiterleitet, erzeugt harte `400` Fehler; nur wenn beide Hälften zusammen fehlen, schaltet sich die Funktion stillschweigend aus. Ein Gateway, das Request-Bodies zur Inhaltsüberprüfung umschreibt oder redigiert, bricht die Paarung auf die gleiche Weise wie das Löschen, daher überprüfen Sie ohne Änderung. Die Tabelle vermerkt, wo eine Funktion von der Paarung abweicht.127Funktionen, die Body-Felder hinzufügen, paaren sie mit einem Beta-Header, und das Paar reist zusammen. Ein Gateway, das den Header löscht, während es den Body durchleitet, oder ein Anthropic-Format-Body an ein Upstream mit einem anderen Schema weiterleitet, erzeugt harte `400` Fehler; nur wenn beide Hälften zusammen fehlen, schaltet sich die Funktion stillschweigend aus. Ein Gateway, das Request-Bodies zur Inhaltsüberprüfung umschreibt oder redigiert, bricht die Paarung auf die gleiche Weise wie das Löschen, daher überprüfen Sie ohne Änderung. Die Tabelle vermerkt, wo eine Funktion von der Paarung abweicht.

128 128

129Fine-Grained Tool Streaming ist einer der Direct-Connection-Standardwerte: Es ist standardmäßig aus, wenn Anfragen durch eine benutzerdefinierte Basis-URL geleitet werden, und ein Gateway empfängt es, wenn Entwickler [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/de/env-vars) setzen.129Fine-Grained Tool Streaming ist einer der Direct-Connection-Standardwerte: Es ist standardmäßig aus, wenn Anfragen durch eine benutzerdefinierte Basis-URL geleitet werden, und ein Gateway empfängt es, wenn Entwickler [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/docs/de/env-vars) setzen.

130 130

132| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |132| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |

133| [Adaptive Reasoning](/de/model-config#adjust-effort-level) | Kein Beta-Header. Claude Code sendet `thinking: {"type": "adaptive"}` für Claude 4.6 und später und behandelt Modellnamen, die es nicht erkennt, wie Gateway-Aliase, als aktuelle Modelle, die das Feld erhalten | `400` mit Nennung des `thinking` Feldes oder des `adaptive` Tags, wenn der Upstream-Modell-Build es nicht akzeptiert | Aktualisieren Sie das Upstream. Auf Opus 4.6 und Sonnet 4.6 können Entwickler stattdessen `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` setzen |133| [Adaptive Reasoning](/docs/de/model-config#adjust-effort-level) | Kein Beta-Header. Claude Code sendet `thinking: {"type": "adaptive"}` für Claude 4.6 und später und behandelt Modellnamen, die es nicht erkennt, wie Gateway-Aliase, als aktuelle Modelle, die das Feld erhalten | `400` mit Nennung des `thinking` Feldes oder des `adaptive` Tags, wenn der Upstream-Modell-Build es nicht akzeptiert | Aktualisieren Sie das Upstream. Auf Opus 4.6 und Sonnet 4.6 können Entwickler stattdessen `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` setzen |

134| [Kontextverwaltung](https://platform.claude.com/docs/de/build-with-claude/context-editing) | Kontextverwaltungs-Beta-Header paart sich mit dem `context_management` Body-Feld | `400` mit `Extra inputs are not permitted`. Häufig, wenn ein Gateway Anthropic-Format-Anfragen akzeptiert, aber an Amazon Bedrock weiterleitet | Leiten Sie beide weiter, oder [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/de/env-vars) |134| [Kontextverwaltung](https://platform.claude.com/docs/de/build-with-claude/context-editing) | Kontextverwaltungs-Beta-Header paart sich mit dem `context_management` Body-Feld | `400` mit `Extra inputs are not permitted`. Häufig, wenn ein Gateway Anthropic-Format-Anfragen akzeptiert, aber an Amazon Bedrock weiterleitet | Leiten Sie beide weiter, oder [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/de/env-vars) |

135| [Erweiterter Kontext](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) und [verschachteltes Denken](https://platform.claude.com/docs/de/build-with-claude/extended-thinking#interleaved-thinking) | Nur Beta-Header, kein Body-Feld | Stillschweigend nicht verfügbar, wenn der Header gelöscht wird; das Upstream sieht die Funktionsanfrage nie | Leiten Sie `anthropic-beta` wörtlich weiter |135| [Erweiterter Kontext](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) und [verschachteltes Denken](https://platform.claude.com/docs/de/build-with-claude/extended-thinking#interleaved-thinking) | Nur Beta-Header, kein Body-Feld | Stillschweigend nicht verfügbar, wenn der Header gelöscht wird; das Upstream sieht die Funktionsanfrage nie | Leiten Sie `anthropic-beta` wörtlich weiter |

136| Beta [Tool-Felder](https://platform.claude.com/docs/de/agents-and-tools/tool-use/overview) | Tool-bezogene Beta-Header paaren sich mit Tool-Schema-Feldern wie `strict` und `defer_loading` | `400` mit Nennung des nicht erkannten Tool-Schema-Feldes, wenn der Body ohne seinen Header durchgeht | Leiten Sie beide weiter, oder `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |136| Beta [Tool-Felder](https://platform.claude.com/docs/de/agents-and-tools/tool-use/overview) | Tool-bezogene Beta-Header paaren sich mit Tool-Schema-Feldern wie `strict` und `defer_loading` | `400` mit Nennung des nicht erkannten Tool-Schema-Feldes, wenn der Body ohne seinen Header durchgeht | Leiten Sie beide weiter, oder `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |

137| [Aufwand](https://platform.claude.com/docs/de/build-with-claude/effort) und [strukturierte Ausgaben](https://platform.claude.com/docs/de/build-with-claude/structured-outputs) | Das `output_config` Body-Feld trägt Aufwand, strukturierte Ausgabeformat und Task-Budget-Einstellungen; jedes paart sich mit seinem eigenen Beta-Header | `400` mit Nennung von `output_config`, oft `Extra inputs are not permitted`, auf Bedrock- und Agent-Platform-Upstreams | Leiten Sie das Feld und seine Header zusammen weiter |137| [Aufwand](https://platform.claude.com/docs/de/build-with-claude/effort) und [strukturierte Ausgaben](https://platform.claude.com/docs/de/build-with-claude/structured-outputs) | Das `output_config` Body-Feld trägt Aufwand, strukturierte Ausgabeformat und Task-Budget-Einstellungen; jedes paart sich mit seinem eigenen Beta-Header | `400` mit Nennung von `output_config`, oft `Extra inputs are not permitted`, auf Bedrock- und Agent-Platform-Upstreams | Leiten Sie das Feld und seine Header zusammen weiter |

138| [Token-Counting](https://platform.claude.com/docs/de/build-with-claude/token-counting) | Keine Beta-Paarung; verwendet den `count_tokens` Endpunkt | Claude Code fällt auf lokale Kontextnutzungsschätzung zurück | Stellen Sie den Endpunkt bereit, wenn Sie genaue Zählungen möchten |138| [Token-Counting](https://platform.claude.com/docs/de/build-with-claude/token-counting) | Keine Beta-Paarung; verwendet den `count_tokens` Endpunkt | Claude Code fällt auf lokale Kontextnutzungsschätzung zurück | Stellen Sie den Endpunkt bereit, wenn Sie genaue Zählungen möchten |

139 139

140Die `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` [Variablen](/de/model-config) deklarieren Modellkapazitäten nur in den Provider-Konfigurationen: `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY` und [`CLAUDE_CODE_USE_MANTLE`](/de/amazon-bedrock#use-the-mantle-endpoint). Sie haben keine Auswirkung hinter einem `ANTHROPIC_BASE_URL` Gateway.140Die `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` [Variablen](/docs/de/model-config) deklarieren Modellkapazitäten nur in den Provider-Konfigurationen: `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY` und [`CLAUDE_CODE_USE_MANTLE`](/docs/de/amazon-bedrock#use-the-mantle-endpoint). Sie haben keine Auswirkung hinter einem `ANTHROPIC_BASE_URL` Gateway.

141 141

142<h3 id="automatic-retry-and-error-forwarding">142<h3 id="automatic-retry-and-error-forwarding">

143 Automatische Wiederholung und Fehlerweiterleitung143 Automatische Wiederholung und Fehlerweiterleitung

161 161

162Wenn `ANTHROPIC_BASE_URL` auf ein Gateway verweist, das das Anthropic Messages-Format bereitstellt, kann Claude Code beim Startup den `/v1/models` Endpunkt des Gateways abfragen und die zurückgegebenen Modelle zur `/model` Auswahl hinzufügen.162Wenn `ANTHROPIC_BASE_URL` auf ein Gateway verweist, das das Anthropic Messages-Format bereitstellt, kann Claude Code beim Startup den `/v1/models` Endpunkt des Gateways abfragen und die zurückgegebenen Modelle zur `/model` Auswahl hinzufügen.

163 163

164Entwickler aktivieren dies durch Setzen von [`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`](/de/env-vars), in ihrer eigenen Umgebung oder durch verwaltete Einstellungen. Die Ermittlung ist standardmäßig aus, damit Gateways, die von einem gemeinsamen API-Schlüssel unterstützt werden, nicht jedes Modell, auf das der Schlüssel zugreifen kann, jedem Benutzer anzeigen. Dies erfordert Claude Code v2.1.129 oder später.164Entwickler aktivieren dies durch Setzen von [`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`](/docs/de/env-vars), in ihrer eigenen Umgebung oder durch verwaltete Einstellungen. Die Ermittlung ist standardmäßig aus, damit Gateways, die von einem gemeinsamen API-Schlüssel unterstützt werden, nicht jedes Modell, auf das der Schlüssel zugreifen kann, jedem Benutzer anzeigen. Dies erfordert Claude Code v2.1.129 oder später.

165 165

166<h3 id="when-discovery-runs">166<h3 id="when-discovery-runs">

167 Wenn die Ermittlung läuft167 Wenn die Ermittlung läuft

171 171

172* Eine beliebige `CLAUDE_CODE_USE_*` Provider-Variable gesetzt ist, auch wenn `ANTHROPIC_BASE_URL` auch gesetzt ist172* Eine beliebige `CLAUDE_CODE_USE_*` Provider-Variable gesetzt ist, auch wenn `ANTHROPIC_BASE_URL` auch gesetzt ist

173* `ANTHROPIC_BASE_URL` nicht gesetzt ist oder auf `api.anthropic.com` verweist173* `ANTHROPIC_BASE_URL` nicht gesetzt ist oder auf `api.anthropic.com` verweist

174* Nicht wesentlicher Traffic ist deaktiviert, durch [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/de/env-vars) oder Organisationsrichtlinie174* Nicht wesentlicher Traffic ist deaktiviert, durch [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/de/env-vars) oder Organisationsrichtlinie

175 175

176<h3 id="request-and-response">176<h3 id="request-and-response">

177 Request und Response177 Request und Response

182Die Ermittlungsanfrage sendet genau einen Anmeldedaten-Header:182Die Ermittlungsanfrage sendet genau einen Anmeldedaten-Header:

183 183

184* `ANTHROPIC_AUTH_TOKEN` als Bearer-Token, wenn gesetzt184* `ANTHROPIC_AUTH_TOKEN` als Bearer-Token, wenn gesetzt

185* Andernfalls der aufgelöste API-Schlüssel, einschließlich eines [`apiKeyHelper`](/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper) Wertes, im `x-api-key` Header185* Andernfalls der aufgelöste API-Schlüssel, einschließlich eines [`apiKeyHelper`](/docs/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper) Wertes, im `x-api-key` Header

186 186

187Dies unterscheidet sich von Inferenzanfragen, die einen Helper-Wert in beiden Headern senden. Ein Gateway, das `/v1/models` authentifiziert, muss `x-api-key` für Helper-Bereitstellungen akzeptieren. Alle Header von `ANTHROPIC_CUSTOM_HEADERS` sind ebenfalls enthalten.187Dies unterscheidet sich von Inferenzanfragen, die einen Helper-Wert in beiden Headern senden. Ein Gateway, das `/v1/models` authentifiziert, muss `x-api-key` für Helper-Bereitstellungen akzeptieren. Alle Header von `ANTHROPIC_CUSTOM_HEADERS` sind ebenfalls enthalten.

188 188

201 Auswahl-Einträge und Caching201 Auswahl-Einträge und Caching

202</h3>202</h3>

203 203

204Die Auswahl ist die interaktive Modelliste, die sich öffnet, wenn ein Entwickler `/model` in Claude Code ausführt. Jeder ermittelte Eintrag ist mit „Aus Gateway" gekennzeichnet und verwendet `display_name`, wenn bereitgestellt. Die [`availableModels` verwaltete Einstellung](/de/settings#available-settings) begrenzt, was die Ermittlung hinzufügen kann.204Die Auswahl ist die interaktive Modelliste, die sich öffnet, wenn ein Entwickler `/model` in Claude Code ausführt. Jeder ermittelte Eintrag ist mit „Aus Gateway" gekennzeichnet und verwendet `display_name`, wenn bereitgestellt. Die [`availableModels` verwaltete Einstellung](/docs/de/settings#available-settings) begrenzt, was die Ermittlung hinzufügen kann.

205 205

206Eine ermittelte ID wird übersprungen, wenn sie genau einer Zeile in der Auswahl entspricht, oder wenn sowohl die ermittelte als auch die vorhandene ID zu [Fable](/de/model-config#work-with-fable-5) aufgelöst werden. {/* min-version: 2.1.197 */}Ab Claude Code v2.1.197 wird eine ermittelte explizite ID auch in einen eingebauten Eintrag zusammengefasst, wenn beide zum gleichen Modell aufgelöst werden. Eingebaute Zeilen werden nach Aliasen wie `sonnet` verschlüsselt, daher wird eine ermittelte explizite ID des Modells, zu dem der Alias derzeit aufgelöst wird, wie `claude-sonnet-5`, in die `sonnet` Zeile zusammengefasst, während eine ID, zu der der Alias nicht aufgelöst wird, wie `claude-sonnet-4-6`, immer noch ihre eigene „Aus Gateway" Zeile neben dem eingebauten Eintrag hinzufügt.206Eine ermittelte ID wird übersprungen, wenn sie genau einer Zeile in der Auswahl entspricht, oder wenn sowohl die ermittelte als auch die vorhandene ID zu [Fable](/docs/de/model-config#work-with-fable-5) aufgelöst werden. Ab Claude Code v2.1.197 wird eine ermittelte explizite ID auch in einen eingebauten Eintrag zusammengefasst, wenn beide zum gleichen Modell aufgelöst werden. Eingebaute Zeilen werden nach Aliasen wie `sonnet` verschlüsselt, daher wird eine ermittelte explizite ID des Modells, zu dem der Alias derzeit aufgelöst wird, wie `claude-sonnet-5`, in die `sonnet` Zeile zusammengefasst, während eine ID, zu der der Alias nicht aufgelöst wird, wie `claude-sonnet-4-6`, immer noch ihre eigene „Aus Gateway" Zeile neben dem eingebauten Eintrag hinzufügt.

207 207

208Ergebnisse werden in `~/.claude/cache/gateway-models.json` oder `%USERPROFILE%\.claude\cache\gateway-models.json` unter Windows zwischengespeichert und bei jedem Startup aktualisiert. Wenn die Anfrage fehlschlägt oder das Gateway `/v1/models` nicht implementiert, fällt die Auswahl auf die zwischengespeicherte Liste aus dem vorherigen Startup oder auf die eingebaute Modelliste zurück. Wenn Ihr Gateway Claude-Modelle unter Aliasen bereitstellt, die nicht dem Ermittlungsfilter entsprechen, können Entwickler diese Aliase manuell mit den [Modellkonfigurationsvariablen](/de/model-config) hinzufügen.208Ergebnisse werden in `~/.claude/cache/gateway-models.json` oder `%USERPROFILE%\.claude\cache\gateway-models.json` unter Windows zwischengespeichert und bei jedem Startup aktualisiert. Wenn die Anfrage fehlschlägt oder das Gateway `/v1/models` nicht implementiert, fällt die Auswahl auf die zwischengespeicherte Liste aus dem vorherigen Startup oder auf die eingebaute Modelliste zurück. Wenn Ihr Gateway Claude-Modelle unter Aliasen bereitstellt, die nicht dem Ermittlungsfilter entsprechen, können Entwickler diese Aliase manuell mit den [Modellkonfigurationsvariablen](/docs/de/model-config) hinzufügen.

209 209

210<h2 id="related-resources">210<h2 id="related-resources">

211 Verwandte Ressourcen211 Verwandte Ressourcen

213 213

214Für den Rest der Gateway-Dokumentationsserie und die zugrunde liegenden API-Referenzen:214Für den Rest der Gateway-Dokumentationsserie und die zugrunde liegenden API-Referenzen:

215 215

216* [Gateway-Übersicht](/de/gateways): was ein Gateway ist und wie Sie zwischen Claude Apps Gateway und einem anderen Produkt wählen216* [Gateway-Übersicht](/docs/de/gateways): was ein Gateway ist und wie Sie zwischen Claude Apps Gateway und einem anderen Produkt wählen

217* [Andere LLM-Gateways](/de/llm-gateway): wie Sie ein Gateway bereitstellen, das Ihre Organisation betreibt, und wie es mit claude.ai-Abonnements interagiert217* [Andere LLM-Gateways](/docs/de/llm-gateway): wie Sie ein Gateway bereitstellen, das Ihre Organisation betreibt, und wie es mit claude.ai-Abonnements interagiert

218* [LLM-Gateway für Ihre Organisation bereitstellen](/de/llm-gateway-rollout): die Admin-Checkliste, die diesen Vertrag verwendet218* [LLM-Gateway für Ihre Organisation bereitstellen](/docs/de/llm-gateway-rollout): die Admin-Checkliste, die diesen Vertrag verwendet

219* [Claude Code mit einem LLM-Gateway verbinden](/de/llm-gateway-connect): Pro-Entwickler-Konfiguration und die Fehlerbehebungstabelle219* [Claude Code mit einem LLM-Gateway verbinden](/docs/de/llm-gateway-connect): Pro-Entwickler-Konfiguration und die Fehlerbehebungstabelle

220* [Beta-Headers-Referenz](https://platform.claude.com/docs/de/api/beta-headers): der aktuelle Satz von `anthropic-beta` Werten220* [Beta-Headers-Referenz](https://platform.claude.com/docs/de/api/beta-headers): der aktuelle Satz von `anthropic-beta` Werten

221* [Messages API](https://platform.claude.com/docs/de/api/messages): das API-Format, das ein Anthropic-Format-Gateway implementiert221* [Messages API](https://platform.claude.com/docs/de/api/messages): das API-Format, das ein Anthropic-Format-Gateway implementiert

llm-gateway-rollout.md +30 −30

Details

9Diese Seite führt einen Administrator durch die Bereitstellung eines LLM-Gateways für Claude Code. Sie setzt voraus, dass Sie ein Gateway-Produkt bereitgestellt haben, das die [Gateway-Anforderungen](#gateway-requirements) erfüllt. Die Bereitstellung oder der Betrieb eines bestimmten Produkts wird hier nicht behandelt; stellen Sie Ihres gemäß der Dokumentation des Herstellers bereit.9Diese Seite führt einen Administrator durch die Bereitstellung eines LLM-Gateways für Claude Code. Sie setzt voraus, dass Sie ein Gateway-Produkt bereitgestellt haben, das die [Gateway-Anforderungen](#gateway-requirements) erfüllt. Die Bereitstellung oder der Betrieb eines bestimmten Produkts wird hier nicht behandelt; stellen Sie Ihres gemäß der Dokumentation des Herstellers bereit.

10 10

11<Note>11<Note>

~~12 * Um Claude Code auf Ihrem eigenen Computer mit einem vorhandenen Gateway zu verbinden, siehe [Claude Code mit einem LLM-Gateway verbinden](/de/llm-gateway-connect)~~12 * Um Claude Code auf Ihrem eigenen Computer mit einem vorhandenen Gateway zu verbinden, siehe [Claude Code mit einem LLM-Gateway verbinden](/docs/de/llm-gateway-connect)

~~13 * Für das, was Claude Code an ein Gateway sendet und was weitergeleitet werden soll, siehe die [Gateway-Protokollreferenz](/de/llm-gateway-protocol)~~13 * Für das, was Claude Code an ein Gateway sendet und was weitergeleitet werden soll, siehe die [Gateway-Protokollreferenz](/docs/de/llm-gateway-protocol)

14</Note>14</Note>

15 15

16<h2 id="prerequisites">16<h2 id="prerequisites">

22* Ein Gateway, das auf Ihrer Infrastruktur bereitgestellt ist, HTTPS auf der genauen Adresse bereitstellt, die Sie an Entwickler verteilen werden, nicht auf einer Adresse, die zu ihr umleitet, und so konfiguriert ist, dass Claude-Modellnamen zu Ihrem Anbieter weitergeleitet werden22* Ein Gateway, das auf Ihrer Infrastruktur bereitgestellt ist, HTTPS auf der genauen Adresse bereitstellt, die Sie an Entwickler verteilen werden, nicht auf einer Adresse, die zu ihr umleitet, und so konfiguriert ist, dass Claude-Modellnamen zu Ihrem Anbieter weitergeleitet werden

23* Eine Anbieteranmeldedaten für das Gateway zum Weiterleiten mit:23* Eine Anbieteranmeldedaten für das Gateway zum Weiterleiten mit:

24 * Für die Anthropic API: einen API-Schlüssel aus der [Claude-Konsole](https://platform.claude.com/settings/keys)24 * Für die Anthropic API: einen API-Schlüssel aus der [Claude-Konsole](https://platform.claude.com/settings/keys)

25 * Für einen Cloud-Anbieter: Cloud-Anmeldedaten mit Modellzugriff. Siehe die Voraussetzungen auf der Seite [Amazon Bedrock](/de/amazon-bedrock#prerequisites), [Google Cloud's Agent Platform](/de/google-vertex-ai#prerequisites) oder [Microsoft Foundry](/de/microsoft-foundry#prerequisites)25 * Für einen Cloud-Anbieter: Cloud-Anmeldedaten mit Modellzugriff. Siehe die Voraussetzungen auf der Seite [Amazon Bedrock](/docs/de/amazon-bedrock#prerequisites), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai#prerequisites) oder [Microsoft Foundry](/docs/de/microsoft-foundry#prerequisites)

26* Eine Möglichkeit, Einstellungsdateien auf Entwicklermaschinen bereitzustellen, z. B. MDM oder Konfigurationsverwaltung26* Eine Möglichkeit, Einstellungsdateien auf Entwicklermaschinen bereitzustellen, z. B. MDM oder Konfigurationsverwaltung

~~27 * Wenn Sie noch keine haben, vergleicht [wie Einstellungen Geräte erreichen](/de/admin-setup#decide-how-settings-reach-devices) die Optionen~~27 * Wenn Sie noch keine haben, vergleicht [wie Einstellungen Geräte erreichen](/docs/de/admin-setup#decide-how-settings-reach-devices) die Optionen

28 28

29<h3 id="gateway-requirements">29<h3 id="gateway-requirements">

30 Gateway-Anforderungen30 Gateway-Anforderungen

32 32

33Welches Produkt auch immer das Gateway bereitstellt, es muss:33Welches Produkt auch immer das Gateway bereitstellt, es muss:

34 34

35* **Ein unterstütztes API-Format akzeptieren**: eines der Formate in der [API-Formattabelle](/de/llm-gateway-protocol#api-formats). Die Rollout-Schritte unten setzen die Anthropic Messages API unter `POST /v1/messages` voraus, die die meisten Gateways bereitstellen35* **Ein unterstütztes API-Format akzeptieren**: eines der Formate in der [API-Formattabelle](/docs/de/llm-gateway-protocol#api-formats). Die Rollout-Schritte unten setzen die Anthropic Messages API unter `POST /v1/messages` voraus, die die meisten Gateways bereitstellen

36* **Antworten streamen**: Server-Sent-Events durchleiten, während sie ankommen, anstatt die gesamte Antwort zu puffern36* **Antworten streamen**: Server-Sent-Events durchleiten, während sie ankommen, anstatt die gesamte Antwort zu puffern

37* **Claude-Modellnamen weiterleiten**: jeden Namen, den Entwickler verwenden, einem Upstream-Modell zuordnen. Claude Code sendet einen Modellnamen wie `claude-sonnet-4-6` in jeder Anfrage; in den meisten Gateway-Produkten ist die Zuordnung eine Modellliste oder Routing-Tabelle in der eigenen Konfiguration des Gateways37* **Claude-Modellnamen weiterleiten**: jeden Namen, den Entwickler verwenden, einem Upstream-Modell zuordnen. Claude Code sendet einen Modellnamen wie `claude-sonnet-4-6` in jeder Anfrage; in den meisten Gateway-Produkten ist die Zuordnung eine Modellliste oder Routing-Tabelle in der eigenen Konfiguration des Gateways

38* **Header und Body unverändert weiterleiten**: `anthropic-beta`, `anthropic-version` und den Request-Body in beide Richtungen durchleiten; die [Feature-Pass-Through-Tabelle](/de/llm-gateway-protocol#feature-pass-through) ordnet jede dem Feature zu, das ohne sie bricht38* **Header und Body unverändert weiterleiten**: `anthropic-beta`, `anthropic-version` und den Request-Body in beide Richtungen durchleiten; die [Feature-Pass-Through-Tabelle](/docs/de/llm-gateway-protocol#feature-pass-through) ordnet jede dem Feature zu, das ohne sie bricht

39* **Upstream-Fehler unverändert zurückgeben**: Claude Codes automatische Wiederherstellung basiert auf Fehlerformulierungen, daher bricht das Einwickeln von Fehlern in die eigene Hülle des Gateways es39* **Upstream-Fehler unverändert zurückgeben**: Claude Codes automatische Wiederherstellung basiert auf Fehlerformulierungen, daher bricht das Einwickeln von Fehlern in die eigene Hülle des Gateways es

40* **Den Pfad von der WAF-Inspektion des Request-Body ausnehmen**: Claude Code-Prompts enthalten Quellcode und XML-ähnliche Tags, die Cross-Site-Scripting-Body-Regeln entsprechen; eine WAF vor dem Gateway gibt `403` bei echten Sitzungen zurück, während kurze Test-Anfragen durchgehen40* **Den Pfad von der WAF-Inspektion des Request-Body ausnehmen**: Claude Code-Prompts enthalten Quellcode und XML-ähnliche Tags, die Cross-Site-Scripting-Body-Regeln entsprechen; eine WAF vor dem Gateway gibt `403` bei echten Sitzungen zurück, während kurze Test-Anfragen durchgehen

41 41

42Optional können Sie `GET /v1/models` bereitstellen, damit Claude Code die Modellauswahl von Ihrem Gateway mit [Modellermittlung](/de/llm-gateway-protocol#model-discovery) füllen kann. {/* min-version: 2.1.129 */}42Optional können Sie `GET /v1/models` bereitstellen, damit Claude Code die Modellauswahl von Ihrem Gateway mit [Modellermittlung](/docs/de/llm-gateway-protocol#model-discovery) füllen kann. 

43 43

44<h2 id="rollout-steps">44<h2 id="rollout-steps">

45 Rollout-Schritte45 Rollout-Schritte

96Wiederholen Sie die Anfrage einmal pro Claude-Modellname in der Routing-Konfiguration Ihres Gateways. Ein Name, den das Gateway nicht weiterleitet, gibt `404` an jeden Entwickler zurück, der ihn auswählt, daher testen Sie jeden Namen vor dem Rollout.96Wiederholen Sie die Anfrage einmal pro Claude-Modellname in der Routing-Konfiguration Ihres Gateways. Ein Name, den das Gateway nicht weiterleitet, gibt `404` an jeden Entwickler zurück, der ihn auswählt, daher testen Sie jeden Namen vor dem Rollout.

97 97

98<Note>98<Note>

99 Vermeiden Sie, das Gateway hinter einer Umleitung bereitzustellen. Eine Umleitung kann den Request-Body ablegen oder den Anmeldedaten-Header bei Inferenzanfragen entfernen, und [Modellermittlung](/de/llm-gateway-protocol#model-discovery) behandelt jede Umleitung als Fehler, daher können die Anmeldedaten nicht zu einem Umleitungsziel durchsickern.99 Vermeiden Sie, das Gateway hinter einer Umleitung bereitzustellen. Eine Umleitung kann den Request-Body ablegen oder den Anmeldedaten-Header bei Inferenzanfragen entfernen, und [Modellermittlung](/docs/de/llm-gateway-protocol#model-discovery) behandelt jede Umleitung als Fehler, daher können die Anmeldedaten nicht zu einem Umleitungsziel durchsickern.

100</Note>100</Note>

101 101

102<h3 id="issue-developer-credentials">102<h3 id="issue-developer-credentials">

130 130

131**Checkpoint**: ein `200` mit einem `content`-Feld bedeutet, dass der Entwicklerschlüssel das Gateway erreicht und das Gateway ihn weiterleitet. Ein `401` hier, wenn [der vorherige Schritt](#confirm-the-gateway-routes-your-models) erfolgreich war, bedeutet, dass der Entwicklerschlüssel falsch ist oder noch nicht am Gateway wirksam geworden ist.131**Checkpoint**: ein `200` mit einem `content`-Feld bedeutet, dass der Entwicklerschlüssel das Gateway erreicht und das Gateway ihn weiterleitet. Ein `401` hier, wenn [der vorherige Schritt](#confirm-the-gateway-routes-your-models) erfolgreich war, bedeutet, dass der Entwicklerschlüssel falsch ist oder noch nicht am Gateway wirksam geworden ist.

132 132

133Das Ausstellen eines Schlüssels pro Entwickler anstelle eines gemeinsamen Schlüssels ist das, was die Zuordnung der Nutzung pro Entwickler und das individuelle Offboarding ermöglicht. Die Umgebungsvariable, die den Schlüssel hält, hängt davon ab, welcher Header das Gateway liest. Für ein Gateway, das Anmeldedaten im `Authorization: Bearer`-Header überprüft, setzen Entwickler ihren Schlüssel in `ANTHROPIC_AUTH_TOKEN`. Für ein Gateway, das Schlüssel aus dem `x-api-key`-Header liest, setzen Entwickler stattdessen `ANTHROPIC_API_KEY`; die [Anmeldedatentabelle](/de/llm-gateway-connect#set-the-credential-variable) behandelt die Zuordnung.133Das Ausstellen eines Schlüssels pro Entwickler anstelle eines gemeinsamen Schlüssels ist das, was die Zuordnung der Nutzung pro Entwickler und das individuelle Offboarding ermöglicht. Die Umgebungsvariable, die den Schlüssel hält, hängt davon ab, welcher Header das Gateway liest. Für ein Gateway, das Anmeldedaten im `Authorization: Bearer`-Header überprüft, setzen Entwickler ihren Schlüssel in `ANTHROPIC_AUTH_TOKEN`. Für ein Gateway, das Schlüssel aus dem `x-api-key`-Header liest, setzen Entwickler stattdessen `ANTHROPIC_API_KEY`; die [Anmeldedatentabelle](/docs/de/llm-gateway-connect#set-the-credential-variable) behandelt die Zuordnung.

134 134

135<h3 id="test-claude-code-against-the-gateway">135<h3 id="test-claude-code-against-the-gateway">

136 Testen Sie Claude Code gegen das Gateway136 Testen Sie Claude Code gegen das Gateway

165* `Not logged in`: überprüfen Sie das Gateway-Log, um die beiden Ursachen auseinanderzuhalten. Wenn es leer ist, hat keine Anmeldedaten die Sitzung erreicht und keine Anfrage hat die Maschine verlassen; führen Sie die Exporte in der Shell aus, die Sie testen. Wenn es eine abgelehnte Anfrage mit `x-api-key` im `401`-Body zeigt, erwartet das Gateway Schlüssel in diesem Header stattdessen; wechseln Sie zu `ANTHROPIC_API_KEY`165* `Not logged in`: überprüfen Sie das Gateway-Log, um die beiden Ursachen auseinanderzuhalten. Wenn es leer ist, hat keine Anmeldedaten die Sitzung erreicht und keine Anfrage hat die Maschine verlassen; führen Sie die Exporte in der Shell aus, die Sie testen. Wenn es eine abgelehnte Anfrage mit `x-api-key` im `401`-Body zeigt, erwartet das Gateway Schlüssel in diesem Header stattdessen; wechseln Sie zu `ANTHROPIC_API_KEY`

166* `Failed to authenticate. API Error: 401` bedeutet, dass eine Anmeldedaten gesendet und abgelehnt wurde, und das Gateway-Log sagt, wo: ein `401`, das `api.anthropic.com` oder Ihren Anbieter-Endpunkt benennt, bedeutet, dass das Gateway den Upstream erreicht hat, aber seine Anbieteranmeldedaten, die es hält, abgelehnt wurden, daher funktionierte der Entwicklerschlüssel und die Anbieteranmeldedaten, die das Gateway hält, sind falsch oder ein Platzhalter166* `Failed to authenticate. API Error: 401` bedeutet, dass eine Anmeldedaten gesendet und abgelehnt wurde, und das Gateway-Log sagt, wo: ein `401`, das `api.anthropic.com` oder Ihren Anbieter-Endpunkt benennt, bedeutet, dass das Gateway den Upstream erreicht hat, aber seine Anbieteranmeldedaten, die es hält, abgelehnt wurden, daher funktionierte der Entwicklerschlüssel und die Anbieteranmeldedaten, die das Gateway hält, sind falsch oder ein Platzhalter

167 167

168Eine falsche oder unerreichbare Basis-URL erzeugt ein anderes Symptom: Claude Code [versucht die Verbindung mit Backoff erneut](/de/errors#automatic-retries) und kann mehrere Minuten ohne Ausgabe sitzen, bevor es einen Fehler meldet. Wenn der Befehl zu hängen scheint, überprüfen Sie stattdessen das Gateway-Log, anstatt zu warten; keine ankommende Anfrage bedeutet, dass `ANTHROPIC_BASE_URL` nicht auf das Gateway zeigt.168Eine falsche oder unerreichbare Basis-URL erzeugt ein anderes Symptom: Claude Code [versucht die Verbindung mit Backoff erneut](/docs/de/errors#automatic-retries) und kann mehrere Minuten ohne Ausgabe sitzen, bevor es einen Fehler meldet. Wenn der Befehl zu hängen scheint, überprüfen Sie stattdessen das Gateway-Log, anstatt zu warten; keine ankommende Anfrage bedeutet, dass `ANTHROPIC_BASE_URL` nicht auf das Gateway zeigt.

169 169

170<h3 id="distribute-the-configuration">170<h3 id="distribute-the-configuration">

171 Verteilen Sie die Konfiguration171 Verteilen Sie die Konfiguration

172</h3>172</h3>

173 173

174Jede Entwicklermaschine benötigt die Gateway-Adresse und eine Anmeldedaten. Sie können sie zentral über [verwaltete Einstellungen](/de/settings#settings-files) verteilen, damit Entwickler nichts konfigurieren, oder Entwickler die Werte selbst setzen lassen.174Jede Entwicklermaschine benötigt die Gateway-Adresse und eine Anmeldedaten. Sie können sie zentral über [verwaltete Einstellungen](/docs/de/settings#settings-files) verteilen, damit Entwickler nichts konfigurieren, oder Entwickler die Werte selbst setzen lassen.

175 175

176<h4 id="what-to-distribute">176<h4 id="what-to-distribute">

177 Was zu verteilen ist177 Was zu verteilen ist

186| `ANTHROPIC_CUSTOM_HEADERS` | Fügt zusätzliche HTTP-Header zu jeder API-Anfrage hinzu | Ihr Gateway erfordert einen Mandanten- oder Routing-Header bei jeder Anfrage |186| `ANTHROPIC_CUSTOM_HEADERS` | Fügt zusätzliche HTTP-Header zu jeder API-Anfrage hinzu | Ihr Gateway erfordert einen Mandanten- oder Routing-Header bei jeder Anfrage |

187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Fragt das `/v1/models` des Gateways beim Start ab und fügt die zurückgegebenen Namen zur `/model`-Auswahl hinzu | Ihr Gateway stellt `/v1/models` bereit und Sie möchten, dass die Auswahl der Entwickler von ihm gefüllt wird |187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Fragt das `/v1/models` des Gateways beim Start ab und fügt die zurückgegebenen Namen zur `/model`-Auswahl hinzu | Ihr Gateway stellt `/v1/models` bereit und Sie möchten, dass die Auswahl der Entwickler von ihm gefüllt wird |

188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Stoppt Claude Code beim Senden von Pre-Release-Capability-Headern und Body-Feldern | Ihr Gateway leitet zu einem Amazon Bedrock- oder Google Cloud Agent Platform-Upstream weiter, der Beta-Felder ablehnt; siehe [Gateway-Anforderungen](#gateway-requirements) |188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Stoppt Claude Code beim Senden von Pre-Release-Capability-Headern und Body-Feldern | Ihr Gateway leitet zu einem Amazon Bedrock- oder Google Cloud Agent Platform-Upstream weiter, der Beta-Felder ablehnt; siehe [Gateway-Anforderungen](#gateway-requirements) |

189| `ANTHROPIC_MODEL` oder [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/de/model-config) | Legen Sie fest, welchen Modellnamen Claude Code für die Hauptsitzung und für Hintergrund-Traffic anfordert | Ihr Gateway leitet Modellnamen weiter, die nicht Claude Codes Standardwerte entsprechen, oder Sie leiten [Hintergrund-Funktionalität](/de/costs#background-token-usage) an ein anderes Modell weiter. Leiten Sie sowohl die Override-Namen als auch die integrierten Modell-IDs weiter, die Claude Code anfordert, wenn kein Override gesetzt ist, da einige Unter-Aufrufe unabhängig vom Override eine integrierte ID anfordern; [Modellkonfiguration](/de/model-config) behandelt, welches Modell jeder Teil einer Sitzung verwendet |189| `ANTHROPIC_MODEL` oder [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/de/model-config) | Legen Sie fest, welchen Modellnamen Claude Code für die Hauptsitzung und für Hintergrund-Traffic anfordert | Ihr Gateway leitet Modellnamen weiter, die nicht Claude Codes Standardwerte entsprechen, oder Sie leiten [Hintergrund-Funktionalität](/docs/de/costs#background-token-usage) an ein anderes Modell weiter. Leiten Sie sowohl die Override-Namen als auch die integrierten Modell-IDs weiter, die Claude Code anfordert, wenn kein Override gesetzt ist, da einige Unter-Aufrufe unabhängig vom Override eine integrierte ID anfordern; [Modellkonfiguration](/docs/de/model-config) behandelt, welches Modell jeder Teil einer Sitzung verwendet |

190| `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, `ANTHROPIC_FOUNDRY_BASE_URL`, oder `ANTHROPIC_AWS_BASE_URL` mit den [Variablen für diesen Anbieter](/de/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) | Zeigen Sie Claude Code auf das Gateway durch eine anbieter-spezifische Basis-URL. Amazon Bedrock und Google Cloud Agent Platform wechseln auch zu den nativen Request-Formaten dieser Anbieter | Ihr Gateway frontet Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry oder die Claude Platform auf AWS; siehe [API-Formate](/de/llm-gateway-protocol#api-formats) |190| `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, `ANTHROPIC_FOUNDRY_BASE_URL`, oder `ANTHROPIC_AWS_BASE_URL` mit den [Variablen für diesen Anbieter](/docs/de/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) | Zeigen Sie Claude Code auf das Gateway durch eine anbieter-spezifische Basis-URL. Amazon Bedrock und Google Cloud Agent Platform wechseln auch zu den nativen Request-Formaten dieser Anbieter | Ihr Gateway frontet Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry oder die Claude Platform auf AWS; siehe [API-Formate](/docs/de/llm-gateway-protocol#api-formats) |

191 191

192<h4 id="distribute-through-managed-settings">192<h4 id="distribute-through-managed-settings">

193 Verteilen Sie über verwaltete Einstellungen193 Verteilen Sie über verwaltete Einstellungen

194</h4>194</h4>

195 195

196Liefern Sie die Variablen über den `env`-Block einer [verwalteten Einstellungsdatei](/de/settings#settings-files), die von MDM, Registry-Richtlinie oder Konfigurationsverwaltung gepusht wird:196Liefern Sie die Variablen über den `env`-Block einer [verwalteten Einstellungsdatei](/docs/de/settings#settings-files), die von MDM, Registry-Richtlinie oder Konfigurationsverwaltung gepusht wird:

197 197

198```json theme={null}198```json theme={null}

199{199{

206 206

207Fügen Sie die bedingten Variablen aus der Tabelle zum gleichen `env`-Block hinzu. Ein verwalteter `ANTHROPIC_BASE_URL` wird erzwungen und kann nicht durch einen Shell-Export eines Entwicklers überschrieben werden, da Claude Code ihn über die Prozessumgebung und niedrigere Prioritätseinstellungen anwendet.207Fügen Sie die bedingten Variablen aus der Tabelle zum gleichen `env`-Block hinzu. Ein verwalteter `ANTHROPIC_BASE_URL` wird erzwungen und kann nicht durch einen Shell-Export eines Entwicklers überschrieben werden, da Claude Code ihn über die Prozessumgebung und niedrigere Prioritätseinstellungen anwendet.

208 208

209Fügen Sie `forceLoginMethod` oder `forceLoginOrgUUID` nicht in verwalteten Einstellungen neben einer Gateway-Anmeldedaten ein. Auf Claude Code v2.1.146 und später blockiert jeder Schlüssel `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` und `apiKeyHelper` beim Start, daher sehen Entwickler `This machine's managed settings require a first-party login` und können nicht fortfahren. {/* min-version: 2.1.146 */}209Fügen Sie `forceLoginMethod` oder `forceLoginOrgUUID` nicht in verwalteten Einstellungen neben einer Gateway-Anmeldedaten ein. Auf Claude Code v2.1.146 und später blockiert jeder Schlüssel `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` und `apiKeyHelper` beim Start, daher sehen Entwickler `This machine's managed settings require a first-party login` und können nicht fortfahren. 

210 210

211[Server-verwaltete Einstellungen](/de/server-managed-settings#platform-availability) Lieferung erfordert eine direkte Verbindung zu `api.anthropic.com`, daher erreicht sie keine Gateway-gerouteten Sitzungen. Gateway-Bereitstellungen verwenden diesen dateigestützten verwalteten Einstellungspfad, der die gleichen Schlüssel erzwingt.211[Server-verwaltete Einstellungen](/docs/de/server-managed-settings#platform-availability) Lieferung erfordert eine direkte Verbindung zu `api.anthropic.com`, daher erreicht sie keine Gateway-gerouteten Sitzungen. Gateway-Bereitstellungen verwenden diesen dateigestützten verwalteten Einstellungspfad, der die gleichen Schlüssel erzwingt.

212 212

213Für die Anmeldedaten verteilen Sie einen [`apiKeyHelper`](/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper)-Befehl in der verwalteten Einstellungsdatei wie oben gezeigt; der Befehl authentifiziert sich bei Ihrem Secrets-Store als lokaler Entwickler, daher erhält jede Maschine ihren eigenen Schlüssel. Alternativ liefern Sie jedem Entwickler seinen Schlüssel über Ihren bestehenden Secrets-Prozess und lassen ihn `ANTHROPIC_AUTH_TOKEN` selbst setzen.213Für die Anmeldedaten verteilen Sie einen [`apiKeyHelper`](/docs/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper)-Befehl in der verwalteten Einstellungsdatei wie oben gezeigt; der Befehl authentifiziert sich bei Ihrem Secrets-Store als lokaler Entwickler, daher erhält jede Maschine ihren eigenen Schlüssel. Alternativ liefern Sie jedem Entwickler seinen Schlüssel über Ihren bestehenden Secrets-Prozess und lassen ihn `ANTHROPIC_AUTH_TOKEN` selbst setzen.

214 214

215Einige Umgebungen benötigen separate Lieferung:215Einige Umgebungen benötigen separate Lieferung:

216 216

217* Die Desktop-App liest Gateway-Routing nur aus ihrer MDM-bereitgestellten Drittanbieter-Inferenzkonfiguration; stellen Sie diese Datei neben verwalteten Einstellungen bereit, damit Desktop-Sitzungen auch durch das Gateway geleitet werden. Siehe die [Desktop-Drittanbieter-Konfigurationsdocs](https://claude.com/docs/third-party/claude-desktop/configuration) und die [Desktop-Gateway-Docs](https://claude.com/docs/third-party/claude-desktop/gateway)217* Die Desktop-App liest Gateway-Routing nur aus ihrer MDM-bereitgestellten Drittanbieter-Inferenzkonfiguration; stellen Sie diese Datei neben verwalteten Einstellungen bereit, damit Desktop-Sitzungen auch durch das Gateway geleitet werden. Siehe die [Desktop-Drittanbieter-Konfigurationsdocs](https://claude.com/docs/third-party/claude-desktop/configuration) und die [Desktop-Gateway-Docs](https://claude.com/docs/third-party/claude-desktop/gateway)

218* CI-Runner benötigen `ANTHROPIC_BASE_URL` und die Anmeldedaten in der [Umgebung des Runners](/de/llm-gateway-connect#configure-each-surface) gesetzt218* CI-Runner benötigen `ANTHROPIC_BASE_URL` und die Anmeldedaten in der [Umgebung des Runners](/docs/de/llm-gateway-connect#configure-each-surface) gesetzt

219* WSL auf verwalteten Windows-Maschinen liest die Windows-verwalteten Einstellungen nur, wenn [`wslInheritsWindowsSettings`](/de/settings#available-settings) `true` ist219* WSL auf verwalteten Windows-Maschinen liest die Windows-verwalteten Einstellungen nur, wenn [`wslInheritsWindowsSettings`](/docs/de/settings#available-settings) `true` ist

220 220

221<h4 id="hand-developers-the-values-to-set-themselves">221<h4 id="hand-developers-the-values-to-set-themselves">

222 Geben Sie Entwicklern die Werte, um sie selbst zu setzen222 Geben Sie Entwicklern die Werte, um sie selbst zu setzen

223</h4>223</h4>

224 224

225Wenn Sie keine verwaltete Einstellungsverteilung eingerichtet haben, senden Sie jedem Entwickler, was er benötigt, um die [Verbindungsseite](/de/llm-gateway-connect#configure-claude-code-yourself) zu befolgen:225Wenn Sie keine verwaltete Einstellungsverteilung eingerichtet haben, senden Sie jedem Entwickler, was er benötigt, um die [Verbindungsseite](/docs/de/llm-gateway-connect#configure-claude-code-yourself) zu befolgen:

226 226

227* Die Gateway-URL227* Die Gateway-URL

228* Ihre persönliche Anmeldedaten228* Ihre persönliche Anmeldedaten

229* **Welche Variable die Anmeldedaten einzufügen ist**: `ANTHROPIC_AUTH_TOKEN` für ein Bearer-Token-Gateway, oder `ANTHROPIC_API_KEY` für ein `x-api-key`-Gateway. Entwicklern zu sagen, welche spart ihnen das Trial-and-Error, das auf der [Verbindungsseite](/de/llm-gateway-connect#set-the-credential-variable) beschrieben ist229* **Welche Variable die Anmeldedaten einzufügen ist**: `ANTHROPIC_AUTH_TOKEN` für ein Bearer-Token-Gateway, oder `ANTHROPIC_API_KEY` für ein `x-api-key`-Gateway. Entwicklern zu sagen, welche spart ihnen das Trial-and-Error, das auf der [Verbindungsseite](/docs/de/llm-gateway-connect#set-the-credential-variable) beschrieben ist

230* Alle bedingten Variablen aus der [Was zu verteilen ist-Tabelle](#what-to-distribute), mit ihren Werten230* Alle bedingten Variablen aus der [Was zu verteilen ist-Tabelle](#what-to-distribute), mit ihren Werten

231 231

232Die [Verbindungsseite](/de/llm-gateway-connect#configure-claude-code-yourself) führt Entwickler durch das Setzen jeder einzelnen.232Die [Verbindungsseite](/docs/de/llm-gateway-connect#configure-claude-code-yourself) führt Entwickler durch das Setzen jeder einzelnen.

233 233

234**Checkpoint**: auf einer Entwicklermaschine startet `claude` eine Sitzung ohne den Login-Bildschirm anzuzeigen, da die verteilte Anmeldedaten die Authentifizierung erfüllt. Führen Sie dann `/status` aus und öffnen Sie die **Status**-Registerkarte: die `Anthropic base URL`-Zeile zeigt die Gateway-Adresse, und für verwaltete Verteilung enthält die `Setting sources`-Zeile verwaltete Einstellungen. Ein Login-Bildschirm oder eine fehlende `Anthropic base URL`-Zeile bedeutet, dass die Konfiguration die Maschine nicht erreicht hat.234**Checkpoint**: auf einer Entwicklermaschine startet `claude` eine Sitzung ohne den Login-Bildschirm anzuzeigen, da die verteilte Anmeldedaten die Authentifizierung erfüllt. Führen Sie dann `/status` aus und öffnen Sie die **Status**-Registerkarte: die `Anthropic base URL`-Zeile zeigt die Gateway-Adresse, und für verwaltete Verteilung enthält die `Setting sources`-Zeile verwaltete Einstellungen. Ein Login-Bildschirm oder eine fehlende `Anthropic base URL`-Zeile bedeutet, dass die Konfiguration die Maschine nicht erreicht hat.

235 235

270* `Failed to authenticate`-Fehler bedeuten, dass das Gateway Anfragen ablehnt; sein Log sagt, welche Anmeldedaten fehlgeschlagen ist. Eine Ablehnung, die das Gateway selbst protokolliert, benennt den Entwicklerschlüssel, während ein `401` von `api.anthropic.com` oder Ihrem Anbieter-Endpunkt bedeutet, dass die Anbieteranmeldedaten, die das Gateway hält, abgelehnt wurden270* `Failed to authenticate`-Fehler bedeuten, dass das Gateway Anfragen ablehnt; sein Log sagt, welche Anmeldedaten fehlgeschlagen ist. Eine Ablehnung, die das Gateway selbst protokolliert, benennt den Entwicklerschlüssel, während ein `401` von `api.anthropic.com` oder Ihrem Anbieter-Endpunkt bedeutet, dass die Anbieteranmeldedaten, die das Gateway hält, abgelehnt wurden

271* Eine einmalige Genehmigungsaufforderung für den Schlüssel ist beim ersten Gebrauch erwartet, wenn das Gateway Schlüssel im `x-api-key`-Header erwartet, gesetzt als `ANTHROPIC_API_KEY`. Mit `ANTHROPIC_AUTH_TOKEN` erscheint keine Aufforderung und die Variable übernimmt stillschweigend; ein zuvor gespeicherter claude.ai-Login ist für diese Sitzung inaktiv271* Eine einmalige Genehmigungsaufforderung für den Schlüssel ist beim ersten Gebrauch erwartet, wenn das Gateway Schlüssel im `x-api-key`-Header erwartet, gesetzt als `ANTHROPIC_API_KEY`. Mit `ANTHROPIC_AUTH_TOKEN` erscheint keine Aufforderung und die Variable übernimmt stillschweigend; ein zuvor gespeicherter claude.ai-Login ist für diese Sitzung inaktiv

272 272

273Überprüfen Sie abschließend die Logs des Gateways auf die Nachricht, die Sie gesendet haben: die Anmeldedaten identifiziert den Entwickler, und der [`x-claude-code-session-id`-Header](/de/llm-gateway-protocol#request-headers) gruppiert Anfragen nach Sitzung. Wenn Features mit den [Fehlerbehebungssymptomen](/de/llm-gateway-connect#troubleshoot-gateway-errors) fehlschlagen, entfernt das Gateway Header oder schreibt Fehler um; siehe die [Gateway-Anforderungen](#gateway-requirements) oben.273Überprüfen Sie abschließend die Logs des Gateways auf die Nachricht, die Sie gesendet haben: die Anmeldedaten identifiziert den Entwickler, und der [`x-claude-code-session-id`-Header](/docs/de/llm-gateway-protocol#request-headers) gruppiert Anfragen nach Sitzung. Wenn Features mit den [Fehlerbehebungssymptomen](/docs/de/llm-gateway-connect#troubleshoot-gateway-errors) fehlschlagen, entfernt das Gateway Header oder schreibt Fehler um; siehe die [Gateway-Anforderungen](#gateway-requirements) oben.

274 274

275<h2 id="maintain-the-gateway">275<h2 id="maintain-the-gateway">

276 Verwalten Sie das Gateway276 Verwalten Sie das Gateway

280 280

282| :------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |282| :------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

283| Neue Claude Code-Versionen fügen `anthropic-beta`-Werte und Request-Body-Felder hinzu | Entwickler berichten `400`-Fehler, die ein neues Feld nach der Aktualisierung von Claude Code benennen; siehe [Feature-Pass-Through](/de/llm-gateway-protocol#feature-pass-through) | Leiten Sie `anthropic-*`-Header und Request-Bodies wörtlich weiter, anstatt eine Allowlist zu verwenden; testen Sie neue Claude Code-Versionen gegen das Gateway, bevor sie Entwickler erreichen |283| Neue Claude Code-Versionen fügen `anthropic-beta`-Werte und Request-Body-Felder hinzu | Entwickler berichten `400`-Fehler, die ein neues Feld nach der Aktualisierung von Claude Code benennen; siehe [Feature-Pass-Through](/docs/de/llm-gateway-protocol#feature-pass-through) | Leiten Sie `anthropic-*`-Header und Request-Bodies wörtlich weiter, anstatt eine Allowlist zu verwenden; testen Sie neue Claude Code-Versionen gegen das Gateway, bevor sie Entwickler erreichen |

284| Neue Claude-Modelle werden verfügbar | Entwickler, die einen neuen Modellnamen auswählen, erhalten `404`; die `/model`-Auswahl listet ihn nicht auf | Fügen Sie den Modellnamen zur Routing-Konfiguration des Gateways hinzu, führen Sie dann die [Routing-Überprüfung](#confirm-the-gateway-routes-your-models) erneut aus. Wenn Sie `ANTHROPIC_MODEL` oder die Standard-Modell-Variablen verteilen, aktualisieren Sie die verwalteten Einstellungen |284| Neue Claude-Modelle werden verfügbar | Entwickler, die einen neuen Modellnamen auswählen, erhalten `404`; die `/model`-Auswahl listet ihn nicht auf | Fügen Sie den Modellnamen zur Routing-Konfiguration des Gateways hinzu, führen Sie dann die [Routing-Überprüfung](#confirm-the-gateway-routes-your-models) erneut aus. Wenn Sie `ANTHROPIC_MODEL` oder die Standard-Modell-Variablen verteilen, aktualisieren Sie die verwalteten Einstellungen |

285| Anmeldedaten verfallen oder müssen rotiert werden | Alle Entwickleranfragen beginnen mit `401` vom Upstream zu fehlschlagen | Rotieren Sie die Anbieteranmeldedaten des Gateways nach eigenem Zeitplan; Entwicklerschlüssel rotieren am Gateway, und ein [`apiKeyHelper`](/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper) handhabt die Rotation pro Entwickler, ohne Einstellungen neu zu verteilen |285| Anmeldedaten verfallen oder müssen rotiert werden | Alle Entwickleranfragen beginnen mit `401` vom Upstream zu fehlschlagen | Rotieren Sie die Anbieteranmeldedaten des Gateways nach eigenem Zeitplan; Entwicklerschlüssel rotieren am Gateway, und ein [`apiKeyHelper`](/docs/de/llm-gateway-connect#rotate-credentials-with-apikeyhelper) handhabt die Rotation pro Entwickler, ohne Einstellungen neu zu verteilen |

286 286

287Berücksichtigen Sie bei der Dimensionierung von Pro-Schlüssel-Ratenlimits den Client [Wiederholung von transienten Fehlern](/de/errors#automatic-retries), einschließlich `429`-Antworten, bis zu 10 Mal mit Backoff, unter Beachtung von `Retry-After`. Behalten Sie die [Protokollreferenz](/de/llm-gateway-protocol) als Vertrag für das, was jede Claude Code-Version sendet.287Berücksichtigen Sie bei der Dimensionierung von Pro-Schlüssel-Ratenlimits den Client [Wiederholung von transienten Fehlern](/docs/de/errors#automatic-retries), einschließlich `429`-Antworten, bis zu 10 Mal mit Backoff, unter Beachtung von `Retry-After`. Behalten Sie die [Protokollreferenz](/docs/de/llm-gateway-protocol) als Vertrag für das, was jede Claude Code-Version sendet.

288 288

289<h2 id="related-resources">289<h2 id="related-resources">

290 Verwandte Ressourcen290 Verwandte Ressourcen

291</h2>291</h2>

292 292

293* [Claude Code mit einem LLM-Gateway verbinden](/de/llm-gateway-connect): die Einrichtungsschritte für Entwickler, mit Pro-Surface-Konfiguration und einer Fehlerbehebungstabelle, die Sie Entwicklern geben können293* [Claude Code mit einem LLM-Gateway verbinden](/docs/de/llm-gateway-connect): die Einrichtungsschritte für Entwickler, mit Pro-Surface-Konfiguration und einer Fehlerbehebungstabelle, die Sie Entwicklern geben können

294* [Gateway-Protokollreferenz](/de/llm-gateway-protocol): der Wire-Vertrag für Gateway-Betreiber, der Endpunkte, weiterzuleitende Header und die Feature-Pass-Through-Tabelle abdeckt294* [Gateway-Protokollreferenz](/docs/de/llm-gateway-protocol): der Wire-Vertrag für Gateway-Betreiber, der Endpunkte, weiterzuleitende Header und die Feature-Pass-Through-Tabelle abdeckt

295* [Einstellungsdateien und Priorität](/de/settings#settings-files): wie verwaltete, Projekt- und Benutzereinstellungen kombiniert werden, und wo die verwaltete Datei auf jeder Plattform geht295* [Einstellungsdateien und Priorität](/docs/de/settings#settings-files): wie verwaltete, Projekt- und Benutzereinstellungen kombiniert werden, und wo die verwaltete Datei auf jeder Plattform geht

296* [Richten Sie Claude Code für Ihre Organisation ein](/de/admin-setup): der breitere Rollout, von dem dieses Gateway ein Teil ist, einschließlich Richtliniendurchsetzung, Nutzungssichtbarkeit und Datenbehandlung296* [Richten Sie Claude Code für Ihre Organisation ein](/docs/de/admin-setup): der breitere Rollout, von dem dieses Gateway ein Teil ist, einschließlich Richtliniendurchsetzung, Nutzungssichtbarkeit und Datenbehandlung

managed-mcp.md +24 −24

Details

6 6

7> Beschränken Sie, welche MCP-Server Benutzer hinzufügen oder mit verwalteten Konfigurationsdateien, Zulassungslisten und Sperrlisten verbinden können.7> Beschränken Sie, welche MCP-Server Benutzer hinzufügen oder mit verwalteten Konfigurationsdateien, Zulassungslisten und Sperrlisten verbinden können.

8 8

9Standardmäßig kann jeder, der Claude Code ausführt, jeden beliebigen [MCP-Server](/de/mcp) verbinden. Anthropic überprüft Konnektoren anhand seiner [Auflistungskriterien](https://claude.com/docs/connectors/building/review-criteria), bevor sie zum [Anthropic-Verzeichnis](https://claude.ai/directory) hinzugefügt werden, führt aber keine Sicherheitsprüfung durch und verwaltet keinen MCP-Server. Als Administrator können Sie einschränken, welche Server in Ihrer Organisation ausgeführt werden – von der Bereitstellung eines festen genehmigten Satzes bis zur vollständigen Deaktivierung von MCP.9Standardmäßig kann jeder, der Claude Code ausführt, jeden beliebigen [MCP-Server](/docs/de/mcp) verbinden. Anthropic überprüft Konnektoren anhand seiner [Auflistungskriterien](https://claude.com/docs/connectors/building/review-criteria), bevor sie zum [Anthropic-Verzeichnis](https://claude.ai/directory) hinzugefügt werden, führt aber keine Sicherheitsprüfung durch und verwaltet keinen MCP-Server. Als Administrator können Sie einschränken, welche Server in Ihrer Organisation ausgeführt werden – von der Bereitstellung eines festen genehmigten Satzes bis zur vollständigen Deaktivierung von MCP.

10 10

11Diese Seite behandelt folgende Themen:11Diese Seite behandelt folgende Themen:

12 12

17* [Überwachen Sie, welche Server Ihre Organisation tatsächlich nutzt](#monitor-mcp-usage)17* [Überwachen Sie, welche Server Ihre Organisation tatsächlich nutzt](#monitor-mcp-usage)

18 18

19<Note>19<Note>

20 Die Seite [Sicherheit](/de/security) behandelt das MCP-Bedrohungsmodell und wie Sie einen Server vor der Genehmigung bewerten. [Entscheiden Sie, was Sie durchsetzen möchten](/de/admin-setup#decide-what-to-enforce) behandelt MCP-Einschränkungen zusammen mit den anderen administrativen Kontrollen.20 Die Seite [Sicherheit](/docs/de/security) behandelt das MCP-Bedrohungsmodell und wie Sie einen Server vor der Genehmigung bewerten. [Entscheiden Sie, was Sie durchsetzen möchten](/docs/de/admin-setup#decide-what-to-enforce) behandelt MCP-Einschränkungen zusammen mit den anderen administrativen Kontrollen.

21</Note>21</Note>

22 22

23<h2 id="choose-a-pattern">23<h2 id="choose-a-pattern">

33| **Genehmigter Katalog** | Veröffentlichen Sie eine Liste genehmigter Server; Benutzer fügen die gewünschten hinzu, alles andere wird blockiert | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |33| **Genehmigter Katalog** | Veröffentlichen Sie eine Liste genehmigter Server; Benutzer fügen die gewünschten hinzu, alles andere wird blockiert | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |

34| **Nur Plugin-Server** | Server können nur aus Plugins stammen; Benutzer können keine eigenen hinzufügen | [`strictPluginOnlyCustomization`](/de/settings#strictpluginonlycustomization) mit `mcp` in der Liste |34| **Nur Plugin-Server** | Server können nur aus Plugins stammen; Benutzer können keine eigenen hinzufügen | [`strictPluginOnlyCustomization`](/docs/de/settings#strictpluginonlycustomization) mit `mcp` in der Liste |

35| **Soft-Zulassungsliste** | Erzwingen Sie eine Zulassungsliste, die Benutzer in ihren eigenen Einstellungen erweitern können | `allowedMcpServers` ohne `allowManagedMcpServersOnly` |35| **Soft-Zulassungsliste** | Erzwingen Sie eine Zulassungsliste, die Benutzer in ihren eigenen Einstellungen erweitern können | `allowedMcpServers` ohne `allowManagedMcpServersOnly` |

38 38

39<Note>39<Note>

40 Claude Code hat keine integrierte MCP-Serverregistrierung, die Benutzer durchsuchen und installieren können. Für das Muster des genehmigten Katalogs teilen Sie die genehmigte Liste und ihre `claude mcp add`-Befehle an einem Ort, den Ihre Benutzer finden, z. B. einem internen Wiki, oder verteilen Sie die Server als Plugins über einen [verwalteten Plugin-Marketplace](/de/plugin-marketplaces#managed-marketplace-restrictions), damit Benutzer sie von `/plugin` durchsuchen und installieren können.40 Claude Code hat keine integrierte MCP-Serverregistrierung, die Benutzer durchsuchen und installieren können. Für das Muster des genehmigten Katalogs teilen Sie die genehmigte Liste und ihre `claude mcp add`-Befehle an einem Ort, den Ihre Benutzer finden, z. B. einem internen Wiki, oder verteilen Sie die Server als Plugins über einen [verwalteten Plugin-Marketplace](/docs/de/plugin-marketplaces#managed-marketplace-restrictions), damit Benutzer sie von `/plugin` durchsuchen und installieren können.

41</Note>41</Note>

42 42

43<h2 id="exclusive-control-with-managed-mcp-json">43<h2 id="exclusive-control-with-managed-mcp-json">

53 53

54Siehe [Wie ein Server bewertet wird](#how-a-server-is-evaluated) für die vollständige Reihenfolge der Überprüfungen.54Siehe [Wie ein Server bewertet wird](#how-a-server-is-evaluated) für die vollständige Reihenfolge der Überprüfungen.

55 55

56`managed-mcp.json` ist eine eigenständige Datei und kann nicht über [serververwaltete Einstellungen](/de/server-managed-settings) bereitgestellt werden. Jeder Prozess, der in einen Systempfad mit Administratorrechten schreiben kann, kann ihn bereitstellen. In großem Maßstab geschieht dies normalerweise über Geräteverwaltungstools wie Jamf oder ein Konfigurationsprofil auf macOS, Gruppenrichtlinie oder Intune unter Windows oder Ihre Fleet-Verwaltung Ihrer Wahl unter Linux. Claude Code sucht die Datei unter einem dieser Pfade:56`managed-mcp.json` ist eine eigenständige Datei und kann nicht über [serververwaltete Einstellungen](/docs/de/server-managed-settings) bereitgestellt werden. Jeder Prozess, der in einen Systempfad mit Administratorrechten schreiben kann, kann ihn bereitstellen. In großem Maßstab geschieht dies normalerweise über Geräteverwaltungstools wie Jamf oder ein Konfigurationsprofil auf macOS, Gruppenrichtlinie oder Intune unter Windows oder Ihre Fleet-Verwaltung Ihrer Wahl unter Linux. Claude Code sucht die Datei unter einem dieser Pfade:

57 57

58| Plattform | Pfad |58| Plattform | Pfad |

59| :------------ | :--------------------------------------------------------- |59| :------------ | :--------------------------------------------------------- |

61| Linux und WSL | `/etc/claude-code/managed-mcp.json` |61| Linux und WSL | `/etc/claude-code/managed-mcp.json` |

62| Windows | `C:\Program Files\ClaudeCode\managed-mcp.json` |62| Windows | `C:\Program Files\ClaudeCode\managed-mcp.json` |

63 63

~~64Die Datei verwendet das gleiche Format wie eine Projekt-[`.mcp.json`](/de/mcp#project-scope)-Datei:~~64Die Datei verwendet das gleiche Format wie eine Projekt-[`.mcp.json`](/docs/de/mcp#project-scope)-Datei:

65 65

66```json theme={null}66```json theme={null}

67{67{

92 92

93Jeder Benutzer auf dem Computer kann diese Datei lesen, daher speichern Sie keine API-Schlüssel oder andere Anmeldedaten in `env`-Blöcken. Übergeben Sie benutzerspezifische Anmeldedaten stattdessen mit einem dieser:93Jeder Benutzer auf dem Computer kann diese Datei lesen, daher speichern Sie keine API-Schlüssel oder andere Anmeldedaten in `env`-Blöcken. Übergeben Sie benutzerspezifische Anmeldedaten stattdessen mit einem dieser:

94 94

~~95* [`${VAR}`-Erweiterung](/de/mcp#environment-variable-expansion-in-mcp-json) zum Lesen von Geheimnissen aus der Umgebung jedes Benutzers.~~95* [`${VAR}`-Erweiterung](/docs/de/mcp#environment-variable-expansion-in-mcp-json) zum Lesen von Geheimnissen aus der Umgebung jedes Benutzers.

~~96* [OAuth oder benutzerspezifische Header](/de/mcp#authenticate-with-remote-mcp-servers), damit sich jeder Benutzer selbst authentifiziert.~~96* [OAuth oder benutzerspezifische Header](/docs/de/mcp#authenticate-with-remote-mcp-servers), damit sich jeder Benutzer selbst authentifiziert.

~~97* [`headersHelper`](/de/mcp#use-dynamic-headers-for-custom-authentication) zum Generieren von Anmeldedaten zum Verbindungszeitpunkt.~~97* [`headersHelper`](/docs/de/mcp#use-dynamic-headers-for-custom-authentication) zum Generieren von Anmeldedaten zum Verbindungszeitpunkt.

98 98

99<h3 id="validate-the-configuration">99<h3 id="validate-the-configuration">

100 Validieren Sie die Konfiguration100 Validieren Sie die Konfiguration

123 Erlauben Sie claude.ai-Konnektoren neben dem verwalteten Satz123 Erlauben Sie claude.ai-Konnektoren neben dem verwalteten Satz

124</h3>124</h3>

125 125

126Die Bereitstellung von `managed-mcp.json` unterdrückt [claude.ai-Konnektoren](/de/mcp#use-mcp-servers-from-claude-ai) standardmäßig, einschließlich Konnektoren, die ein Administrator für die Organisation in der claude.ai-Verwaltungskonsole konfiguriert hat. Um diese Konnektoren neben den Servern in `managed-mcp.json` zu laden, setzen Sie `"allowAllClaudeAiMcps": true` in einer [verwalteten Einstellungsquelle](/de/admin-setup#decide-how-settings-reach-devices). Erfordert Claude Code v2.1.149 oder später.126Die Bereitstellung von `managed-mcp.json` unterdrückt [claude.ai-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) standardmäßig, einschließlich Konnektoren, die ein Administrator für die Organisation in der claude.ai-Verwaltungskonsole konfiguriert hat. Um diese Konnektoren neben den Servern in `managed-mcp.json` zu laden, setzen Sie `"allowAllClaudeAiMcps": true` in einer [verwalteten Einstellungsquelle](/docs/de/admin-setup#decide-how-settings-reach-devices). Erfordert Claude Code v2.1.149 oder später.

127 127

128Mit der aktivierten Einstellung lädt Claude Code die gleichen claude.ai-Konnektoren, die es laden würde, wenn `managed-mcp.json` nicht bereitgestellt würde. [Zulassungslisten und Ablehnungslisten](#policy-based-control-with-allowlists-and-denylists) gelten weiterhin für diese Konnektoren, daher können Sie bestimmte mit `deniedMcpServers` blockieren. Die Einstellung betrifft nur claude.ai-Konnektoren; Plugin-bereitgestellte Server bleiben unterdrückt.128Mit der aktivierten Einstellung lädt Claude Code die gleichen claude.ai-Konnektoren, die es laden würde, wenn `managed-mcp.json` nicht bereitgestellt würde. [Zulassungslisten und Ablehnungslisten](#policy-based-control-with-allowlists-and-denylists) gelten weiterhin für diese Konnektoren, daher können Sie bestimmte mit `deniedMcpServers` blockieren. Die Einstellung betrifft nur claude.ai-Konnektoren; Plugin-bereitgestellte Server bleiben unterdrückt.

129 129

133 Richtlinienbasierte Kontrolle mit Zulassungslisten und Sperrlisten133 Richtlinienbasierte Kontrolle mit Zulassungslisten und Sperrlisten

134</h2>134</h2>

135 135

136Zulassungslisten und Sperrlisten filtern, welche konfigurierten Server geladen werden dürfen. Sie sind keine Registrierung: Ein Server muss immer noch von einem Benutzer, einem Plugin oder `managed-mcp.json` hinzugefügt werden, bevor die Zulassungsliste oder Sperrliste darauf angewendet wird. Um Server für Benutzer bereitzustellen, verwenden Sie [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json). Beide Listen filtern auch Server, die mit dem [`--mcp-config` CLI-Flag](/de/cli-reference#cli-flags) übergeben werden; `--strict-mcp-config` begrenzt, welche Konfigurationsdateien geladen werden, und umgeht keine der beiden Listen.136Zulassungslisten und Sperrlisten filtern, welche konfigurierten Server geladen werden dürfen. Sie sind keine Registrierung: Ein Server muss immer noch von einem Benutzer, einem Plugin oder `managed-mcp.json` hinzugefügt werden, bevor die Zulassungsliste oder Sperrliste darauf angewendet wird. Um Server für Benutzer bereitzustellen, verwenden Sie [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json). Beide Listen filtern auch Server, die mit dem [`--mcp-config` CLI-Flag](/docs/de/cli-reference#cli-flags) übergeben werden; `--strict-mcp-config` begrenzt, welche Konfigurationsdateien geladen werden, und umgeht keine der beiden Listen.

137 137

138Um die Zulassungsliste verbindlich zu machen, setzen Sie `allowedMcpServers` und `allowManagedMcpServersOnly: true` zusammen in einer [verwalteten Einstellungsquelle](/de/admin-setup#decide-how-settings-reach-devices), z. B. serververwaltete Einstellungen oder eine bereitgestellte `managed-settings.json`-Datei. [Beschränken Sie die Zulassungsliste auf verwaltete Einstellungen nur](#restrict-the-allowlist-to-managed-settings-only) zeigt die Konfiguration. Ohne `allowManagedMcpServersOnly` werden Zulassungslisten aus jeder Einstellungsquelle zusammengeführt, einschließlich der eigenen `~/.claude/settings.json` eines Benutzers, daher kann ein Benutzer erweitern, was Ihre Zulassungsliste erlaubt. Sperrlisten werden unabhängig davon aus jeder Quelle zusammengeführt.138Um die Zulassungsliste verbindlich zu machen, setzen Sie `allowedMcpServers` und `allowManagedMcpServersOnly: true` zusammen in einer [verwalteten Einstellungsquelle](/docs/de/admin-setup#decide-how-settings-reach-devices), z. B. serververwaltete Einstellungen oder eine bereitgestellte `managed-settings.json`-Datei. [Beschränken Sie die Zulassungsliste auf verwaltete Einstellungen nur](#restrict-the-allowlist-to-managed-settings-only) zeigt die Konfiguration. Ohne `allowManagedMcpServersOnly` werden Zulassungslisten aus jeder Einstellungsquelle zusammengeführt, einschließlich der eigenen `~/.claude/settings.json` eines Benutzers, daher kann ein Benutzer erweitern, was Ihre Zulassungsliste erlaubt. Sperrlisten werden unabhängig davon aus jeder Quelle zusammengeführt.

139 139

140<Note>140<Note>

141 `allowManagedMcpServersOnly` ist getrennt von `allowManagedPermissionRulesOnly`, das [Berechtigungsregeln](/de/permissions#managed-settings) nur sperrt. Das Setzen dieses Flags erzwingt nicht die MCP-Zulassungsliste.141 `allowManagedMcpServersOnly` ist getrennt von `allowManagedPermissionRulesOnly`, das [Berechtigungsregeln](/docs/de/permissions#managed-settings) nur sperrt. Das Setzen dieses Flags erzwingt nicht die MCP-Zulassungsliste.

142</Note>142</Note>

143 143

144<h3 id="match-servers-by-url-command-or-name">144<h3 id="match-servers-by-url-command-or-name">

162 162

163Siehe [Ungültige Einträge in verwalteten Einstellungen](/de/settings#invalid-entries-in-managed-settings) für das, was passiert, wenn ein Eintrag die Schemavalidierung nicht besteht.163Siehe [Ungültige Einträge in verwalteten Einstellungen](/docs/de/settings#invalid-entries-in-managed-settings) für das, was passiert, wenn ein Eintrag die Schemavalidierung nicht besteht.

164 164

165<Warning>165<Warning>

166 Ein `serverName`-Eintrag in einer der beiden Listen ist keine Sicherheitskontrolle. Der Name ist das Label, das ein Benutzer beim Ausführen von `claude mcp add` oder beim Bearbeiten einer Konfigurationsdatei zuweist, nicht der zugrunde liegende Server, daher kann ein Benutzer jeden Server `github` nennen. Für claude.ai-Konnektoren ist der Name der von claude.ai zurückgegebene Anzeigename, der sich ändern kann. Um zu erzwingen, welche Server tatsächlich ausgeführt werden, fügen Sie `serverCommand`- oder `serverUrl`-Einträge hinzu.166 Ein `serverName`-Eintrag in einer der beiden Listen ist keine Sicherheitskontrolle. Der Name ist das Label, das ein Benutzer beim Ausführen von `claude mcp add` oder beim Bearbeiten einer Konfigurationsdatei zuweist, nicht der zugrunde liegende Server, daher kann ein Benutzer jeden Server `github` nennen. Für claude.ai-Konnektoren ist der Name der von claude.ai zurückgegebene Anzeigename, der sich ändern kann. Um zu erzwingen, welche Server tatsächlich ausgeführt werden, fügen Sie `serverCommand`- oder `serverUrl`-Einträge hinzu.

168 168

169Die `serverName`-Validierung unterscheidet sich zwischen den beiden Listen:169Die `serverName`-Validierung unterscheidet sich zwischen den beiden Listen:

170 170

171* {/* min-version: 2.1.182 */}In `deniedMcpServers` akzeptiert `serverName` jede nicht leere Zeichenkette, daher können Sie [claude.ai-Konnektoren](/de/mcp#use-mcp-servers-from-claude-ai) nach ihrem Anzeigenamen blockieren. Beispielsweise blockiert `{ "serverName": "claude.ai Slack" }` den Slack-Konnektor. Bevorzugen Sie einen `serverUrl`-Eintrag, wenn die Sperrung robust gegen Umbenennungen sein muss, oder wenn ein Konnektor-Name kollidiert und ein ` (N)`-Suffix erhält.171* In `deniedMcpServers` akzeptiert `serverName` jede nicht leere Zeichenkette, daher können Sie [claude.ai-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai) nach ihrem Anzeigenamen blockieren. Beispielsweise blockiert `{ "serverName": "claude.ai Slack" }` den Slack-Konnektor. Bevorzugen Sie einen `serverUrl`-Eintrag, wenn die Sperrung robust gegen Umbenennungen sein muss, oder wenn ein Konnektor-Name kollidiert und ein ` (N)`-Suffix erhält.

172* In `allowedMcpServers` ist `serverName` auf Buchstaben, Zahlen, Bindestriche und Unterstriche beschränkt. Verwenden Sie `serverUrl`, um einen claude.ai-Konnektor in die Zulassungsliste aufzunehmen.172* In `allowedMcpServers` ist `serverName` auf Buchstaben, Zahlen, Bindestriche und Unterstriche beschränkt. Verwenden Sie `serverUrl`, um einen claude.ai-Konnektor in die Zulassungsliste aufzunehmen.

173 173

174Um alle claude.ai-Konnektoren auszuschalten, siehe [`disableClaudeAiConnectors`](/de/mcp#disable-claude-ai-connectors).174Um alle claude.ai-Konnektoren auszuschalten, siehe [`disableClaudeAiConnectors`](/docs/de/mcp#disable-claude-ai-connectors).

175 175

176<h3 id="how-a-server-is-evaluated">176<h3 id="how-a-server-is-evaluated">

177 Wie ein Server bewertet wird177 Wie ein Server bewertet wird

191Drei Matching-Regeln gelten innerhalb dieser Überprüfungen:191Drei Matching-Regeln gelten innerhalb dieser Überprüfungen:

192 192

193* **Befehle stimmen genau überein.** Jedes Argument, in Reihenfolge. `["npx", "-y", "server"]` stimmt nicht mit `["npx", "server"]` oder `["npx", "-y", "server", "--flag"]` überein.193* **Befehle stimmen genau überein.** Jedes Argument, in Reihenfolge. `["npx", "-y", "server"]` stimmt nicht mit `["npx", "server"]` oder `["npx", "-y", "server", "--flag"]` überein.

194* **`serverCommand`- und `serverUrl`-Werte werden vor dem Matching erweitert.** Sowohl der Richtlinieneintrag als auch der konfigurierte Wert des Servers durchlaufen die gleiche [`${VAR}`- und `${VAR:-default}`-Erweiterung](/de/mcp#environment-variable-expansion-in-mcp-json) wie `.mcp.json`, daher passt ein Eintrag, der als `["${HOME}/bin/server"]` geschrieben ist, zu einer Serverkonfiguration, die entweder die gleiche Referenz oder den erweiterten Pfad verwendet. Unter Windows verweisen Sie auf eine Umgebungsvariable, die dort gesetzt ist, z. B. `${USERPROFILE}` statt `${HOME}`. `serverName`-Werte stimmen wörtlich überein und werden nie erweitert.194* **`serverCommand`- und `serverUrl`-Werte werden vor dem Matching erweitert.** Sowohl der Richtlinieneintrag als auch der konfigurierte Wert des Servers durchlaufen die gleiche [`${VAR}`- und `${VAR:-default}`-Erweiterung](/docs/de/mcp#environment-variable-expansion-in-mcp-json) wie `.mcp.json`, daher passt ein Eintrag, der als `["${HOME}/bin/server"]` geschrieben ist, zu einer Serverkonfiguration, die entweder die gleiche Referenz oder den erweiterten Pfad verwendet. Unter Windows verweisen Sie auf eine Umgebungsvariable, die dort gesetzt ist, z. B. `${USERPROFILE}` statt `${HOME}`. `serverName`-Werte stimmen wörtlich überein und werden nie erweitert.

195* **URLs unterstützen `*`-Platzhalter** überall im Muster, einschließlich des Schemas. Hostname-Matching ist case-insensitiv und ignoriert einen nachgestellten FQDN-Punkt, daher passt `https://Mcp.Example.com/*` zu `https://mcp.example.com/api`. Pfade bleiben case-sensitiv.195* **URLs unterstützen `*`-Platzhalter** überall im Muster, einschließlich des Schemas. Hostname-Matching ist case-insensitiv und ignoriert einen nachgestellten FQDN-Punkt, daher passt `https://Mcp.Example.com/*` zu `https://mcp.example.com/api`. Pfade bleiben case-sensitiv.

196 196

197| Muster | Erlaubt |197| Muster | Erlaubt |

363 Überwachen Sie die MCP-Nutzung363 Überwachen Sie die MCP-Nutzung

364</h2>364</h2>

365 365

366Wenn [OpenTelemetry-Export](/de/monitoring-usage) konfiguriert ist, kann Claude Code aufzeichnen, welche MCP-Server und Tools Benutzer aufrufen. Setzen Sie `OTEL_LOG_TOOL_DETAILS=1`, um MCP-Server- und Tool-Namen in Tool-Events einzubeziehen, und aggregieren Sie sie dann in Ihrem Collector, um zu sehen, welche Server Ihre Benutzer tatsächlich verbinden. Siehe [Überwachung](/de/monitoring-usage), um den Exporter einzurichten und das vollständige Event-Schema zu erhalten.366Wenn [OpenTelemetry-Export](/docs/de/monitoring-usage) konfiguriert ist, kann Claude Code aufzeichnen, welche MCP-Server und Tools Benutzer aufrufen. Setzen Sie `OTEL_LOG_TOOL_DETAILS=1`, um MCP-Server- und Tool-Namen in Tool-Events einzubeziehen, und aggregieren Sie sie dann in Ihrem Collector, um zu sehen, welche Server Ihre Benutzer tatsächlich verbinden. Siehe [Überwachung](/docs/de/monitoring-usage), um den Exporter einzurichten und das vollständige Event-Schema zu erhalten.

367 367

368<h2 id="configuration-summary">368<h2 id="configuration-summary">

369 Konfigurationszusammenfassung369 Konfigurationszusammenfassung

375| :--------------------------- | :---------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |375| :--------------------------- | :---------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

376| `managed-mcp.json` | Fester Serversatz, exklusive Kontrolle | Systempfad: `/Library/Application Support/ClaudeCode/`, `/etc/claude-code/` oder `C:\Program Files\ClaudeCode\` | MDM, GPO, Fleet-Verwaltung oder jeder Prozess mit Administratorrechten. Kann nicht über serververwaltete Einstellungen gesetzt werden |376| `managed-mcp.json` | Fester Serversatz, exklusive Kontrolle | Systempfad: `/Library/Application Support/ClaudeCode/`, `/etc/claude-code/` oder `C:\Program Files\ClaudeCode\` | MDM, GPO, Fleet-Verwaltung oder jeder Prozess mit Administratorrechten. Kann nicht über serververwaltete Einstellungen gesetzt werden |

377| `allowedMcpServers` | Zulassungsliste zulässiger Server | Jede [Einstellungsdatei](/de/settings#settings-files); Einträge aus jeder Quelle werden zusammengeführt, es sei denn, `allowManagedMcpServersOnly` ist gesetzt | Zur Durchsetzung eine [verwaltete Einstellungsquelle](/de/admin-setup#decide-how-settings-reach-devices): serververwaltete Einstellungen, `managed-settings.json`, MDM-Profil oder Registrierung |377| `allowedMcpServers` | Zulassungsliste zulässiger Server | Jede [Einstellungsdatei](/docs/de/settings#settings-files); Einträge aus jeder Quelle werden zusammengeführt, es sei denn, `allowManagedMcpServersOnly` ist gesetzt | Zur Durchsetzung eine [verwaltete Einstellungsquelle](/docs/de/admin-setup#decide-how-settings-reach-devices): serververwaltete Einstellungen, `managed-settings.json`, MDM-Profil oder Registrierung |

380| `allowAllClaudeAiMcps` | Lädt claude.ai-Konnektoren neben `managed-mcp.json` statt sie zu unterdrücken | Nur verwaltete Einstellungsquellen; die Einstellung hat keine Auswirkung anderswo | Gleich wie `allowedMcpServers` |380| `allowAllClaudeAiMcps` | Lädt claude.ai-Konnektoren neben `managed-mcp.json` statt sie zu unterdrücken | Nur verwaltete Einstellungsquellen; die Einstellung hat keine Auswirkung anderswo | Gleich wie `allowedMcpServers` |

383 Verwandte Ressourcen383 Verwandte Ressourcen

384</h2>384</h2>

385 385

386* [Entscheiden Sie, was Sie durchsetzen möchten](/de/admin-setup#decide-what-to-enforce): MCP-Einschränkungen zusammen mit Berechtigungsregeln, Sandboxing und den anderen Admin-Kontrollen386* [Entscheiden Sie, was Sie durchsetzen möchten](/docs/de/admin-setup#decide-what-to-enforce): MCP-Einschränkungen zusammen mit Berechtigungsregeln, Sandboxing und den anderen Admin-Kontrollen

387* [Verbinden Sie Claude Code mit Tools über MCP](/de/mcp): die vollständige MCP-Referenz, einschließlich Transporte, Bereiche und Authentifizierung387* [Verbinden Sie Claude Code mit Tools über MCP](/docs/de/mcp): die vollständige MCP-Referenz, einschließlich Transporte, Bereiche und Authentifizierung

388* [Einstellungen](/de/settings): die Einstellungshierarchie und wie verwaltete Einstellungen Vorrang haben388* [Einstellungen](/docs/de/settings): die Einstellungshierarchie und wie verwaltete Einstellungen Vorrang haben

389* [Serververwaltete Einstellungen](/de/server-managed-settings): Stellen Sie `allowedMcpServers` und `deniedMcpServers` aus der Claude.ai-Admin-Konsole bereit389* [Serververwaltete Einstellungen](/docs/de/server-managed-settings): Stellen Sie `allowedMcpServers` und `deniedMcpServers` aus der Claude.ai-Admin-Konsole bereit

390* [Sicherheit](/de/security): das Bedrohungsmodell, das diese Kontrollen schützen390* [Sicherheit](/docs/de/security): das Bedrohungsmodell, das diese Kontrollen schützen

391* [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO, SCIM, Seat-Verwaltung und Rollout-Playbook391* [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO, SCIM, Seat-Verwaltung und Rollout-Playbook

mcp.md +36 −36

Details

10 10

11Verbinden Sie einen Server, wenn Sie feststellen, dass Sie Daten aus einem anderen Tool wie einem Issue-Tracker oder einem Überwachungs-Dashboard in den Chat kopieren. Nach der Verbindung kann Claude direkt auf dieses System zugreifen und handeln, anstatt mit dem zu arbeiten, was Sie einfügen.11Verbinden Sie einen Server, wenn Sie feststellen, dass Sie Daten aus einem anderen Tool wie einem Issue-Tracker oder einem Überwachungs-Dashboard in den Chat kopieren. Nach der Verbindung kann Claude direkt auf dieses System zugreifen und handeln, anstatt mit dem zu arbeiten, was Sie einfügen.

12 12

~~13Wenn Sie Ihren ersten Server verbinden, beginnen Sie mit der [MCP-Schnellstartanleitung](/de/mcp-quickstart) für eine Schritt-für-Schritt-Anleitung. Diese Seite ist die vollständige Referenz.~~13Wenn Sie Ihren ersten Server verbinden, beginnen Sie mit der [MCP-Schnellstartanleitung](/docs/de/mcp-quickstart) für eine Schritt-für-Schritt-Anleitung. Diese Seite ist die vollständige Referenz.

14 14

15<h2 id="what-you-can-do-with-mcp">15<h2 id="what-you-can-do-with-mcp">

16 Was Sie mit MCP tun können16 Was Sie mit MCP tun können

23* **Datenbanken abfragen**: „Finde E-Mail-Adressen von 10 zufälligen Benutzern, die die Funktion ENG-4521 verwendet haben, basierend auf unserer PostgreSQL-Datenbank."23* **Datenbanken abfragen**: „Finde E-Mail-Adressen von 10 zufälligen Benutzern, die die Funktion ENG-4521 verwendet haben, basierend auf unserer PostgreSQL-Datenbank."

24* **Designs integrieren**: „Aktualisiere unsere Standard-E-Mail-Vorlage basierend auf den neuen Figma-Designs, die in Slack gepostet wurden"24* **Designs integrieren**: „Aktualisiere unsere Standard-E-Mail-Vorlage basierend auf den neuen Figma-Designs, die in Slack gepostet wurden"

25* **Workflows automatisieren**: „Erstelle Gmail-Entwürfe, die diese 10 Benutzer zu einer Feedback-Sitzung zur neuen Funktion einladen."25* **Workflows automatisieren**: „Erstelle Gmail-Entwürfe, die diese 10 Benutzer zu einer Feedback-Sitzung zur neuen Funktion einladen."

26* **Auf externe Ereignisse reagieren**: Ein MCP-Server kann auch als [Kanal](/de/channels) fungieren, der Nachrichten in Ihre Sitzung pusht, sodass Claude auf Telegram-Nachrichten, Discord-Chats oder Webhook-Ereignisse reagiert, während Sie weg sind.26* **Auf externe Ereignisse reagieren**: Ein MCP-Server kann auch als [Kanal](/docs/de/channels) fungieren, der Nachrichten in Ihre Sitzung pusht, sodass Claude auf Telegram-Nachrichten, Discord-Chats oder Webhook-Ereignisse reagiert, während Sie weg sind.

27 27

28<h2 id="find-and-build-mcp-servers">28<h2 id="find-and-build-mcp-servers">

29 MCP-Server finden und erstellen29 MCP-Server finden und erstellen

32Durchsuchen Sie überprüfte Konnektoren im [Anthropic Directory](https://claude.ai/directory). Directory-Konnektoren verwenden die gleiche MCP-Infrastruktur wie Claude Code, sodass Sie jeden dort aufgelisteten Remote-Server mit `claude mcp add` hinzufügen können.32Durchsuchen Sie überprüfte Konnektoren im [Anthropic Directory](https://claude.ai/directory). Directory-Konnektoren verwenden die gleiche MCP-Infrastruktur wie Claude Code, sodass Sie jeden dort aufgelisteten Remote-Server mit `claude mcp add` hinzufügen können.

33 33

34<Warning>34<Warning>

35 Überprüfen Sie, dass Sie jedem Server vertrauen, bevor Sie ihn verbinden. Server, die externe Inhalte abrufen, können Sie dem [Risiko von Prompt-Injection aussetzen](/de/security#protect-against-prompt-injection).35 Überprüfen Sie, dass Sie jedem Server vertrauen, bevor Sie ihn verbinden. Server, die externe Inhalte abrufen, können Sie dem [Risiko von Prompt-Injection aussetzen](/docs/de/security#protect-against-prompt-injection).

36</Warning>36</Warning>

37 37

38Um Ihren eigenen Server zu erstellen, lesen Sie das [MCP-Server-Handbuch](https://modelcontextprotocol.io/docs/develop/build-server) für Protokoll-Grundlagen und die [Claude-Konnektoren-Dokumentation zum Erstellen](https://claude.com/docs/connectors/building) für Authentifizierung, Tests und Directory-Einreichung.38Um Ihren eigenen Server zu erstellen, lesen Sie das [MCP-Server-Handbuch](https://modelcontextprotocol.io/docs/develop/build-server) für Protokoll-Grundlagen und die [Claude-Konnektoren-Dokumentation zum Erstellen](https://claude.com/docs/connectors/building) für Authentifizierung, Tests und Directory-Einreichung.

115 115

116Claude Code setzt `CLAUDE_PROJECT_DIR` in der Umgebung des erzeugten Servers auf das Projektstammverzeichnis, sodass Ihr Server projektrelative Pfade auflösen kann, ohne vom Arbeitsverzeichnis abhängig zu sein. Dies ist das gleiche Verzeichnis, das Hooks in ihrer `CLAUDE_PROJECT_DIR`-Variable erhalten. Lesen Sie es aus Ihrem Serverprozess, zum Beispiel `process.env.CLAUDE_PROJECT_DIR` in Node oder `os.environ["CLAUDE_PROJECT_DIR"]` in Python.116Claude Code setzt `CLAUDE_PROJECT_DIR` in der Umgebung des erzeugten Servers auf das Projektstammverzeichnis, sodass Ihr Server projektrelative Pfade auflösen kann, ohne vom Arbeitsverzeichnis abhängig zu sein. Dies ist das gleiche Verzeichnis, das Hooks in ihrer `CLAUDE_PROJECT_DIR`-Variable erhalten. Lesen Sie es aus Ihrem Serverprozess, zum Beispiel `process.env.CLAUDE_PROJECT_DIR` in Node oder `os.environ["CLAUDE_PROJECT_DIR"]` in Python.

117 117

118`CLAUDE_PROJECT_DIR` ist das stabile Projektstammverzeichnis und ändert sich nicht, wenn Sie während einer Sitzung Arbeitsverzeichnisse hinzufügen oder entfernen. Ein Server, der seinen eigenen Dateisystemzugriff auf einen Satz zulässiger Verzeichnisse beschränkt, sollte stattdessen die MCP-Anfrage `roots/list` implementieren. Claude Code antwortet auf `roots/list` mit dem Startverzeichnis der Sitzung plus jedem [zusätzlichen Arbeitsverzeichnis](/de/permissions#working-directories), das Sie mit `--add-dir`, `/add-dir` oder der Einstellung `additionalDirectories` gewährt haben. Claude Code sendet `notifications/roots/list_changed`, wenn sich dieser Satz ändert. Vor v2.1.203 gab `roots/list` nur das Startverzeichnis zurück und Claude Code sendete `notifications/roots/list_changed` nicht.118`CLAUDE_PROJECT_DIR` ist das stabile Projektstammverzeichnis und ändert sich nicht, wenn Sie während einer Sitzung Arbeitsverzeichnisse hinzufügen oder entfernen. Ein Server, der seinen eigenen Dateisystemzugriff auf einen Satz zulässiger Verzeichnisse beschränkt, sollte stattdessen die MCP-Anfrage `roots/list` implementieren. Claude Code antwortet auf `roots/list` mit dem Startverzeichnis der Sitzung plus jedem [zusätzlichen Arbeitsverzeichnis](/docs/de/permissions#working-directories), das Sie mit `--add-dir`, `/add-dir` oder der Einstellung `additionalDirectories` gewährt haben. Claude Code sendet `notifications/roots/list_changed`, wenn sich dieser Satz ändert. Vor v2.1.203 gab `roots/list` nur das Startverzeichnis zurück und Claude Code sendete `notifications/roots/list_changed` nicht.

119 119

120Diese Variable wird in der Umgebung des Servers gesetzt, nicht in der Umgebung von Claude Code selbst, daher erfordert das Referenzieren über `${VAR}`-Erweiterung in einer projekt- oder benutzergesteuerten `.mcp.json` `command` oder `args` einen Standard wie `${CLAUDE_PROJECT_DIR:-.}`. Von Plugins bereitgestellte MCP-Konfigurationen ersetzen `${CLAUDE_PROJECT_DIR}` direkt und benötigen keinen Standard.120Diese Variable wird in der Umgebung des Servers gesetzt, nicht in der Umgebung von Claude Code selbst, daher erfordert das Referenzieren über `${VAR}`-Erweiterung in einer projekt- oder benutzergesteuerten `.mcp.json` `command` oder `args` einen Standard wie `${CLAUDE_PROJECT_DIR:-.}`. Von Plugins bereitgestellte MCP-Konfigurationen ersetzen `${CLAUDE_PROJECT_DIR}` direkt und benötigen keinen Standard.

121 121

180 180

181Projekt-gesteuerte Server aus `.mcp.json`, die auf Ihre Genehmigung warten, erscheinen in `claude mcp list` als `⏸ Genehmigung ausstehend`. Führen Sie `claude` interaktiv aus, um sie zu überprüfen und zu genehmigen. `claude mcp get <name>` zeigt ausstehende Server als `⏸ Genehmigung ausstehend` und abgelehnte Server als `✗ Abgelehnt` an.181Projekt-gesteuerte Server aus `.mcp.json`, die auf Ihre Genehmigung warten, erscheinen in `claude mcp list` als `⏸ Genehmigung ausstehend`. Führen Sie `claude` interaktiv aus, um sie zu überprüfen und zu genehmigen. `claude mcp get <name>` zeigt ausstehende Server als `⏸ Genehmigung ausstehend` und abgelehnte Server als `✗ Abgelehnt` an.

182 182

183Ab v2.1.196 lesen `claude mcp list` und `claude mcp get` `.mcp.json`-Genehmigungen nur aus Einstellungsdateien, die nicht in das Repository eingecheckt werden, bis Sie dem Arbeitsbereich vertrauen, indem Sie `claude` darin ausführen und den Arbeitsbereich-Vertrauensdialog akzeptieren. Ein geklontes Repository kann seine eigenen Server nicht genehmigen: [`enableAllProjectMcpServers` oder `enabledMcpjsonServers`](/de/settings#available-settings), die in die `.claude/settings.json` des Projekts eingecheckt werden, werden in einem nicht vertrauenswürdigen Ordner ignoriert, und der Server bleibt bei `⏸ Genehmigung ausstehend` statt verbunden und Health-Check zu sein.183Ab v2.1.196 lesen `claude mcp list` und `claude mcp get` `.mcp.json`-Genehmigungen nur aus Einstellungsdateien, die nicht in das Repository eingecheckt werden, bis Sie dem Arbeitsbereich vertrauen, indem Sie `claude` darin ausführen und den Arbeitsbereich-Vertrauensdialog akzeptieren. Ein geklontes Repository kann seine eigenen Server nicht genehmigen: [`enableAllProjectMcpServers` oder `enabledMcpjsonServers`](/docs/de/settings#available-settings), die in die `.claude/settings.json` des Projekts eingecheckt werden, werden in einem nicht vertrauenswürdigen Ordner ignoriert, und der Server bleibt bei `⏸ Genehmigung ausstehend` statt verbunden und Health-Check zu sein.

184 184

185Genehmigungen aus diesen Quellen gelten weiterhin in einem nicht vertrauenswürdigen Ordner:185Genehmigungen aus diesen Quellen gelten weiterhin in einem nicht vertrauenswürdigen Ordner:

186 186

188* Verwaltete Einstellungen188* Verwaltete Einstellungen

189* Einstellungen, die mit `--settings` übergeben werden189* Einstellungen, die mit `--settings` übergeben werden

190 190

191Genehmigungen in einer nicht verfolgten `.claude/settings.local.json` gelten ebenfalls, aber nur, nachdem Sie einen Vertrauensdialog für diesen Ordner oder eines seiner übergeordneten Verzeichnisse akzeptieren: Claude Code führt Git aus, um zu überprüfen, ob die Datei verfolgt wird, und führt diese Überprüfung nur in einem vertrauenswürdigen Ordner durch. In einem Ordner, dem Sie noch nie vertraut haben, warten die Genehmigungen der Datei auf den Vertrauensdialog, es sei denn, der Ordner ist Ihr eigenes Konfigurationsheim: Ihr Home-Verzeichnis oder ein Verzeichnis, dessen `.claude` Sie als [`CLAUDE_CONFIG_DIR`](/de/env-vars) festgelegt haben. Vor v2.1.207 genehmigte eine nicht verfolgte `.claude/settings.local.json` Server in einem Ordner, dem Sie noch nie vertraut haben.191Genehmigungen in einer nicht verfolgten `.claude/settings.local.json` gelten ebenfalls, aber nur, nachdem Sie einen Vertrauensdialog für diesen Ordner oder eines seiner übergeordneten Verzeichnisse akzeptieren: Claude Code führt Git aus, um zu überprüfen, ob die Datei verfolgt wird, und führt diese Überprüfung nur in einem vertrauenswürdigen Ordner durch. In einem Ordner, dem Sie noch nie vertraut haben, warten die Genehmigungen der Datei auf den Vertrauensdialog, es sei denn, der Ordner ist Ihr eigenes Konfigurationsheim: Ihr Home-Verzeichnis oder ein Verzeichnis, dessen `.claude` Sie als [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) festgelegt haben. Vor v2.1.207 genehmigte eine nicht verfolgte `.claude/settings.local.json` Server in einem Ordner, dem Sie noch nie vertraut haben.

192 192

193Ein `disabledMcpjsonServers`-Eintrag in einer beliebigen Einstellungsdatei lehnt den Server weiterhin ab.193Ein `disabledMcpjsonServers`-Eintrag in einer beliebigen Einstellungsdatei lehnt den Server weiterhin ab.

194 194

195Das `/mcp`-Panel zeigt die Tool-Anzahl neben jedem verbundenen Server an und kennzeichnet Server, die die Tools-Funktion ankündigen, aber keine Tools bereitstellen.195Das `/mcp`-Panel zeigt die Tool-Anzahl neben jedem verbundenen Server an und kennzeichnet Server, die die Tools-Funktion ankündigen, aber keine Tools bereitstellen.

196 196

197Ein Remote-Server, dessen Konfiguration eine leere `url` hat, wird in `/mcp`, in `claude mcp list` und im [`/plugin`](/de/plugins)-Manager als `not configured` angezeigt, und Claude Code versucht nicht, sich damit zu verbinden. Ein Plugin kann einen Platzhalter-Eintrag wie diesen für einen Connector enthalten, den Sie später konfigurieren, sodass Claude Code ihn nicht als Fehler oder Setup-Problem meldet. Die Detailansicht des Servers in `/mcp` liest `No URL configured for this server`; setzen Sie die `url` des Eintrags, um sich zu verbinden. Vor v2.1.208 meldete Claude Code eine leere `url` als Konfigurationsproblem mit einer Aufforderung zur Wiederverbindung.197Ein Remote-Server, dessen Konfiguration eine leere `url` hat, wird in `/mcp`, in `claude mcp list` und im [`/plugin`](/docs/de/plugins)-Manager als `not configured` angezeigt, und Claude Code versucht nicht, sich damit zu verbinden. Ein Plugin kann einen Platzhalter-Eintrag wie diesen für einen Connector enthalten, den Sie später konfigurieren, sodass Claude Code ihn nicht als Fehler oder Setup-Problem meldet. Die Detailansicht des Servers in `/mcp` liest `No URL configured for this server`; setzen Sie die `url` des Eintrags, um sich zu verbinden. Vor v2.1.208 meldete Claude Code eine leere `url` als Konfigurationsproblem mit einer Aufforderung zur Wiederverbindung.

198 198

199Wenn Ihre Anfrage Tools von einem Server benötigt, der sich noch im Hintergrund verbindet, wartet Claude auf diesen Server, bevor er fortfährt. Mit [Tool-Suche](#scale-with-mcp-tool-search) aktiviert, was die Standardeinstellung ist, erfolgt das Warten innerhalb des `ToolSearch`-Aufrufs. In Konfigurationen ohne Tool-Suche, wie Google Cloud's Agent Platform, eine benutzerdefinierte `ANTHROPIC_BASE_URL` oder `ENABLE_TOOL_SEARCH=false`, verwendet Claude stattdessen das `WaitForMcpServers`-Tool.199Wenn Ihre Anfrage Tools von einem Server benötigt, der sich noch im Hintergrund verbindet, wartet Claude auf diesen Server, bevor er fortfährt. Mit [Tool-Suche](#scale-with-mcp-tool-search) aktiviert, was die Standardeinstellung ist, erfolgt das Warten innerhalb des `ToolSearch`-Aufrufs. In Konfigurationen ohne Tool-Suche, wie Google Cloud's Agent Platform, eine benutzerdefinierte `ANTHROPIC_BASE_URL` oder `ENABLE_TOOL_SEARCH=false`, verwendet Claude stattdessen das `WaitForMcpServers`-Tool.

200 200

201Einige Servernamen sind für Claude Codes integrierte Server reserviert: `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` und `Claude Browser`. Wenn Ihre Konfiguration einen Server mit einem reservierten Namen definiert, überspringt Claude Code ihn beim Laden und zeigt eine Warnung an, die Sie auffordert, ihn umzubenennen. `claude mcp add` lehnt einen reservierten Namen mit einem Fehler ab.201Einige Servernamen sind für Claude Codes integrierte Server reserviert: `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` und `Claude Browser`. Wenn Ihre Konfiguration einen Server mit einem reservierten Namen definiert, überspringt Claude Code ihn beim Laden und zeigt eine Warnung an, die Sie auffordert, ihn umzubenennen. `claude mcp add` lehnt einen reservierten Namen mit einem Fehler ab.

202 202

203`Claude Preview` und `Claude Browser` benennen beide den integrierten Server, den der [Claude Code Desktop-App-Vorschaubereich](/de/desktop#preview-your-app) verwendet. Vor v2.1.205 war `Claude Browser` nicht reserviert, daher konnte ein benutzerkonfigurierter Server sich unter diesem Namen registrieren.203`Claude Preview` und `Claude Browser` benennen beide den integrierten Server, den der [Claude Code Desktop-App-Vorschaubereich](/docs/de/desktop#preview-your-app) verwendet. Vor v2.1.205 war `Claude Browser` nicht reserviert, daher konnte ein benutzerkonfigurierter Server sich unter diesem Namen registrieren.

204 204

205<h3 id="dynamic-tool-updates">205<h3 id="dynamic-tool-updates">

206 Dynamische Tool-Updates206 Dynamische Tool-Updates

224 Push-Nachrichten mit Kanälen224 Push-Nachrichten mit Kanälen

225</h3>225</h3>

226 226

227Ein MCP-Server kann auch Nachrichten direkt in Ihre Sitzung pushen, sodass Claude auf externe Ereignisse wie CI-Ergebnisse, Überwachungswarnungen oder Chat-Nachrichten reagieren kann. Um dies zu aktivieren, deklariert Ihr Server die Funktion `claude/channel` und Sie aktivieren sie mit dem Flag `--channels` beim Start. Siehe [Kanäle](/de/channels), um einen offiziell unterstützten Kanal zu verwenden, oder [Kanäle-Referenz](/de/channels-reference), um Ihren eigenen zu erstellen.227Ein MCP-Server kann auch Nachrichten direkt in Ihre Sitzung pushen, sodass Claude auf externe Ereignisse wie CI-Ergebnisse, Überwachungswarnungen oder Chat-Nachrichten reagieren kann. Um dies zu aktivieren, deklariert Ihr Server die Funktion `claude/channel` und Sie aktivieren sie mit dem Flag `--channels` beim Start. Siehe [Kanäle](/docs/de/channels), um einen offiziell unterstützten Kanal zu verwenden, oder [Kanäle-Referenz](/docs/de/channels-reference), um Ihren eigenen zu erstellen.

228 228

229<Tip>229<Tip>

230 Tipps:230 Tipps:

241 * Verwenden Sie `/mcp`, um sich bei Remote-Servern zu authentifizieren, die OAuth 2.0-Authentifizierung erfordern241 * Verwenden Sie `/mcp`, um sich bei Remote-Servern zu authentifizieren, die OAuth 2.0-Authentifizierung erfordern

242</Tip>242</Tip>

243 243

244Das Pro-Server-`timeout` ist eine harte Wanduhr-Grenze pro Tool-Aufruf, und Fortschrittsbenachrichtigungen vom Server verlängern sie nicht. Werte unter 1000 werden ignoriert und fallen auf `MCP_TOOL_TIMEOUT` zurück, oder auf seinen Standard von etwa 28 Stunden, wenn diese Variable nicht gesetzt ist. Für einen HTTP-, SSE- oder [claude.ai-Connector](/de/mcp#use-mcp-servers-from-claude-ai)-Server gibt es auch einen zweiten, Pro-Request-Timer, der jeden Request bis zur ersten Antwort-Byte des Servers abdeckt. Dieser Timer beträgt 60 Sekunden, es sei denn, Sie setzen das Pro-Server-`timeout` oder `MCP_TOOL_TIMEOUT`; das Setzen eines dieser auf 60 Sekunden oder höher erhöht den Pro-Request-Timer auf diesen Wert, ein niedrigerer Wert verkürzt ihn nicht, und der 28-Stunden-Standard eines nicht gesetzten `MCP_TOOL_TIMEOUT` speist ihn nie. Stdio- und WebSocket-Server haben keinen Pro-Request-Timer. {/* min-version: 2.1.162 */}Vor v2.1.162 wurden Werte unter 1000 stattdessen auf eine Sekunde begrenzt.244Das Pro-Server-`timeout` ist eine harte Wanduhr-Grenze pro Tool-Aufruf, und Fortschrittsbenachrichtigungen vom Server verlängern sie nicht. Werte unter 1000 werden ignoriert und fallen auf `MCP_TOOL_TIMEOUT` zurück, oder auf seinen Standard von etwa 28 Stunden, wenn diese Variable nicht gesetzt ist. Für einen HTTP-, SSE- oder [claude.ai-Connector](/docs/de/mcp#use-mcp-servers-from-claude-ai)-Server gibt es auch einen zweiten, Pro-Request-Timer, der jeden Request bis zur ersten Antwort-Byte des Servers abdeckt. Dieser Timer beträgt 60 Sekunden, es sei denn, Sie setzen das Pro-Server-`timeout` oder `MCP_TOOL_TIMEOUT`; das Setzen eines dieser auf 60 Sekunden oder höher erhöht den Pro-Request-Timer auf diesen Wert, ein niedrigerer Wert verkürzt ihn nicht, und der 28-Stunden-Standard eines nicht gesetzten `MCP_TOOL_TIMEOUT` speist ihn nie. Stdio- und WebSocket-Server haben keinen Pro-Request-Timer. Vor v2.1.162 wurden Werte unter 1000 stattdessen auf eine Sekunde begrenzt.

245 245

246Ein Pro-Server-`timeout` von mindestens 1000 fungiert auch als Untergrenze für das unten beschriebene Idle-Timeout: Claude Code bricht die Tool-Aufrufe dieses Servers niemals wegen Untätigkeit früher ab als das Pro-Server-`timeout`. Erfordert Claude Code v2.1.203 oder später.246Ein Pro-Server-`timeout` von mindestens 1000 fungiert auch als Untergrenze für das unten beschriebene Idle-Timeout: Claude Code bricht die Tool-Aufrufe dieses Servers niemals wegen Untätigkeit früher ab als das Pro-Server-`timeout`. Erfordert Claude Code v2.1.203 oder später.

247 247

248Ein Tool-Aufruf an einen MCP-Server, der für das Idle-Fenster keine Antwort und keine Fortschrittsbenachrichtigung sendet, bricht mit einem Fehler ab, anstatt auf die Wanduhr-Grenze zu warten. Das Idle-Timeout erfordert Claude Code v2.1.187 oder später. {/* min-version: 2.1.203 */}Es gilt für jeden Server-Typ außer IDE-Servern und SDK-In-Process-Servern. Das Idle-Fenster beträgt standardmäßig fünf Minuten für HTTP-, SSE-, WebSocket- und [claude.ai-Connector](#use-mcp-servers-from-claude-ai)-Server und 30 Minuten für Stdio-Server. Vor v2.1.203 waren Stdio-Server vom Idle-Timeout ausgenommen.248Ein Tool-Aufruf an einen MCP-Server, der für das Idle-Fenster keine Antwort und keine Fortschrittsbenachrichtigung sendet, bricht mit einem Fehler ab, anstatt auf die Wanduhr-Grenze zu warten. Das Idle-Timeout erfordert Claude Code v2.1.187 oder später. Es gilt für jeden Server-Typ außer IDE-Servern und SDK-In-Process-Servern. Das Idle-Fenster beträgt standardmäßig fünf Minuten für HTTP-, SSE-, WebSocket- und [claude.ai-Connector](#use-mcp-servers-from-claude-ai)-Server und 30 Minuten für Stdio-Server. Vor v2.1.203 waren Stdio-Server vom Idle-Timeout ausgenommen.

249 249

250Setzen Sie die Umgebungsvariable [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/de/env-vars) in Millisekunden, um das Idle-Fenster zu ändern, oder setzen Sie sie auf `0`, um die Überprüfung zu deaktivieren.250Setzen Sie die Umgebungsvariable [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/docs/de/env-vars) in Millisekunden, um das Idle-Fenster zu ändern, oder setzen Sie sie auf `0`, um die Überprüfung zu deaktivieren.

251 251

252<h3 id="plugin-provided-mcp-servers">252<h3 id="plugin-provided-mcp-servers">

253 Von Plugins bereitgestellte MCP-Server253 Von Plugins bereitgestellte MCP-Server

254</h3>254</h3>

255 255

256[Plugins](/de/plugins) können MCP-Server bündeln und automatisch Tools und Integrationen bereitstellen, wenn das Plugin aktiviert ist. Plugin-MCP-Server funktionieren identisch mit benutzerkonfigurierten Servern.256[Plugins](/docs/de/plugins) können MCP-Server bündeln und automatisch Tools und Integrationen bereitstellen, wenn das Plugin aktiviert ist. Plugin-MCP-Server funktionieren identisch mit benutzerkonfigurierten Servern.

257 257

258**Wie Plugin-MCP-Server funktionieren**:258**Wie Plugin-MCP-Server funktionieren**:

259 259

297**Plugin-MCP-Funktionen**:297**Plugin-MCP-Funktionen**:

298 298

299* **Automatischer Lebenszyklus**: Bei Sitzungsstart verbinden sich Server für aktivierte Plugins automatisch. Wenn Sie ein Plugin während einer Sitzung aktivieren oder deaktivieren, führen Sie `/reload-plugins` aus, um seine MCP-Server zu verbinden oder zu trennen299* **Automatischer Lebenszyklus**: Bei Sitzungsstart verbinden sich Server für aktivierte Plugins automatisch. Wenn Sie ein Plugin während einer Sitzung aktivieren oder deaktivieren, führen Sie `/reload-plugins` aus, um seine MCP-Server zu verbinden oder zu trennen

300* **Pfad-Platzhalter**: `${CLAUDE_PLUGIN_ROOT}` wird in das Installationsverzeichnis des Plugins aufgelöst, `${CLAUDE_PLUGIN_DATA}` in sein [persistentes Zustandsverzeichnis](/de/plugins-reference#persistent-data-directory), und `${CLAUDE_PROJECT_DIR}` in das stabile Projektstammverzeichnis. Die Substitution gilt für:300* **Pfad-Platzhalter**: `${CLAUDE_PLUGIN_ROOT}` wird in das Installationsverzeichnis des Plugins aufgelöst, `${CLAUDE_PLUGIN_DATA}` in sein [persistentes Zustandsverzeichnis](/docs/de/plugins-reference#persistent-data-directory), und `${CLAUDE_PROJECT_DIR}` in das stabile Projektstammverzeichnis. Die Substitution gilt für:

301 * `stdio`-Server: `command`, `args`, `env`301 * `stdio`-Server: `command`, `args`, `env`

302 * `http`-, `sse`- und `ws`-Server: `url`, `headers` und `headersHelper`. {/* min-version: 2.1.195 */}Vor v2.1.195 übergab `headersHelper` den Platzhalter als Literal-String302 * `http`-, `sse`- und `ws`-Server: `url`, `headers` und `headersHelper`. Vor v2.1.195 übergab `headersHelper` den Platzhalter als Literal-String

303* **Zugriff auf Benutzerumgebung**: Zugriff auf die gleichen Umgebungsvariablen wie manuell konfigurierte Server303* **Zugriff auf Benutzerumgebung**: Zugriff auf die gleichen Umgebungsvariablen wie manuell konfigurierte Server

304* **Mehrere Transporttypen**: Unterstützung für Stdio-, SSE-, HTTP- und WebSocket-Transporte, wobei die Transportunterstützung je nach Server variieren kann304* **Mehrere Transporttypen**: Unterstützung für Stdio-, SSE-, HTTP- und WebSocket-Transporte, wobei die Transportunterstützung je nach Server variieren kann

305 305

320mcp__plugin_my-plugin_database-tools__query320mcp__plugin_my-plugin_database-tools__query

321```321```

322 322

323Verwenden Sie diesen vollständigen Namen, wenn Sie auf das Tool in [Berechtigungsregeln](/de/permissions), der `allowed-tools`-Liste eines Skills, dem [`tools`-Feld eines Subagenten](/de/sub-agents#available-tools) oder einem [Hook-Matcher](/de/hooks#match-mcp-tools) verweisen. Ein Hook-Matcher, der gegen den bloßen Server-Schlüssel geschrieben wurde, wie `mcp__database-tools__.*`, wird niemals für einen Plugin-gebündelten Server ausgelöst.323Verwenden Sie diesen vollständigen Namen, wenn Sie auf das Tool in [Berechtigungsregeln](/docs/de/permissions), der `allowed-tools`-Liste eines Skills, dem [`tools`-Feld eines Subagenten](/docs/de/sub-agents#available-tools) oder einem [Hook-Matcher](/docs/de/hooks#match-mcp-tools) verweisen. Ein Hook-Matcher, der gegen den bloßen Server-Schlüssel geschrieben wurde, wie `mcp__database-tools__.*`, wird niemals für einen Plugin-gebündelten Server ausgelöst.

324 324

325Der Server selbst registriert sich unter dem scoped Namen `plugin:<plugin-name>:<server-name>`, wie `plugin:my-plugin:database-tools`. Verwenden Sie diesen Namen, wo ein konfigurierter Server-Name erwartet wird, wie das [`server`-Feld eines `mcp_tool`-Hooks](/de/hooks#mcp-tool-hook-fields).325Der Server selbst registriert sich unter dem scoped Namen `plugin:<plugin-name>:<server-name>`, wie `plugin:my-plugin:database-tools`. Verwenden Sie diesen Namen, wo ein konfigurierter Server-Name erwartet wird, wie das [`server`-Feld eines `mcp_tool`-Hooks](/docs/de/hooks#mcp-tool-hook-fields).

326 326

327**Vorteile von Plugin-MCP-Servern**:327**Vorteile von Plugin-MCP-Servern**:

328 328

330* **Automatische Einrichtung**: Keine manuelle MCP-Konfiguration erforderlich330* **Automatische Einrichtung**: Keine manuelle MCP-Konfiguration erforderlich

331* **Team-Konsistenz**: Alle erhalten die gleichen Tools, wenn das Plugin installiert ist331* **Team-Konsistenz**: Alle erhalten die gleichen Tools, wenn das Plugin installiert ist

332 332

333Siehe die [Plugin-Komponenten-Referenz](/de/plugins-reference#mcp-servers) für Details zum Bündeln von MCP-Servern mit Plugins.333Siehe die [Plugin-Komponenten-Referenz](/docs/de/plugins-reference#mcp-servers) für Details zum Bündeln von MCP-Servern mit Plugins.

334 334

335<h2 id="mcp-installation-scopes">335<h2 id="mcp-installation-scopes">

336 MCP-Installationsbereiche336 MCP-Installationsbereiche

351Der lokale Bereich ist der Standard. Ein lokal begrenzter Server wird nur in dem Projekt geladen, in dem Sie ihn hinzugefügt haben, und bleibt privat für Sie. Claude Code speichert ihn in `~/.claude.json` unter dem Pfad dieses Projekts, daher wird derselbe Server nicht in Ihren anderen Projekten angezeigt. Verwenden Sie den lokalen Bereich für persönliche Entwicklungsserver, experimentelle Konfigurationen oder Server mit Anmeldedaten, die Sie nicht in der Versionskontrolle haben möchten.351Der lokale Bereich ist der Standard. Ein lokal begrenzter Server wird nur in dem Projekt geladen, in dem Sie ihn hinzugefügt haben, und bleibt privat für Sie. Claude Code speichert ihn in `~/.claude.json` unter dem Pfad dieses Projekts, daher wird derselbe Server nicht in Ihren anderen Projekten angezeigt. Verwenden Sie den lokalen Bereich für persönliche Entwicklungsserver, experimentelle Konfigurationen oder Server mit Anmeldedaten, die Sie nicht in der Versionskontrolle haben möchten.

352 352

353<Note>353<Note>

354 Der Begriff „lokaler Bereich" für MCP-Server unterscheidet sich von allgemeinen lokalen Einstellungen. Lokal begrenzte MCP-Server werden in `~/.claude.json` (Ihr Home-Verzeichnis) gespeichert, während allgemeine lokale Einstellungen `.claude/settings.local.json` (im Projektverzeichnis) verwenden. Siehe [Einstellungen](/de/settings#settings-files) für Details zu Einstellungsdatei-Speicherorten.354 Der Begriff „lokaler Bereich" für MCP-Server unterscheidet sich von allgemeinen lokalen Einstellungen. Lokal begrenzte MCP-Server werden in `~/.claude.json` (Ihr Home-Verzeichnis) gespeichert, während allgemeine lokale Einstellungen `.claude/settings.local.json` (im Projektverzeichnis) verwenden. Siehe [Einstellungen](/docs/de/settings#settings-files) für Details zu Einstellungsdatei-Speicherorten.

355</Note>355</Note>

356 356

357```bash theme={null}357```bash theme={null}

4261. Lokaler Bereich4261. Lokaler Bereich

4272. Projektbereich4272. Projektbereich

4283. Benutzerbereich4283. Benutzerbereich

4294. [Von Plugins bereitgestellte Server](/de/plugins)4294. [Von Plugins bereitgestellte Server](/docs/de/plugins)

4305. [Claude.ai-Connectoren](#use-mcp-servers-from-claude-ai)4305. [Claude.ai-Connectoren](#use-mcp-servers-from-claude-ai)

431 431

432Die drei Bereiche stimmen Duplikate nach Name ab. Plugins und Connectoren stimmen nach Endpunkt ab, daher wird einer, der auf die gleiche URL oder den gleichen Befehl wie ein Server oben verweist, als Duplikat behandelt.432Die drei Bereiche stimmen Duplikate nach Name ab. Plugins und Connectoren stimmen nach Endpunkt ab, daher wird einer, der auf die gleiche URL oder den gleichen Befehl wie ein Server oben verweist, als Duplikat behandelt.

805| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |805| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

808| `CLAUDE_PLUGIN_ROOT` | das Root-Verzeichnis des Plugins. Wird nur gesetzt, wenn ein [Plugin](/de/plugins-reference#mcp-servers) den Server bereitstellt |808| `CLAUDE_PLUGIN_ROOT` | das Root-Verzeichnis des Plugins. Wird nur gesetzt, wenn ein [Plugin](/docs/de/plugins-reference#mcp-servers) den Server bereitstellt |

809 809

810Verwenden Sie diese, um ein einzelnes Helper-Skript zu schreiben, das mehrere MCP-Server bedient.810Verwenden Sie diese, um ein einzelnes Helper-Skript zu schreiben, das mehrere MCP-Server bedient.

811 811

812Für einen von einem Plugin bereitgestellten Server wird der Helper auch mit seinem Arbeitsverzeichnis auf das Plugin-Root gesetzt ausgeführt, sodass ein relativer `headersHelper`-Pfad im Plugin-Verzeichnis aufgelöst wird, anstatt gegen das Arbeitsverzeichnis der Sitzung. Erfordert Claude Code v2.1.195 oder später.812Für einen von einem Plugin bereitgestellten Server wird der Helper auch mit seinem Arbeitsverzeichnis auf das Plugin-Root gesetzt ausgeführt, sodass ein relativer `headersHelper`-Pfad im Plugin-Verzeichnis aufgelöst wird, anstatt gegen das Arbeitsverzeichnis der Sitzung. Erfordert Claude Code v2.1.195 oder später.

813 813

814Ein von einem Plugin bereitgestellter `headersHelper` kann nicht auf die [`${user_config.*}`](/de/plugins-reference#user-configuration)-Werte des Plugins verweisen, da der Befehl durch eine Shell ausgeführt wird. Claude Code meldet den Server als fehlkonfiguriert mit einem [Fehler](/de/errors#plugin-command-references-user-config) und ersetzt den Wert nicht. Setzen Sie `${user_config.KEY}` stattdessen in das Feld `headers` des Servers, das nicht shell-geparst wird, oder lassen Sie das Helper-Skript den Wert aus seiner eigenen Umgebung oder einer Konfigurationsdatei lesen. Vor v2.1.207 ersetzte `headersHelper` `${user_config.*}`-Werte.814Ein von einem Plugin bereitgestellter `headersHelper` kann nicht auf die [`${user_config.*}`](/docs/de/plugins-reference#user-configuration)-Werte des Plugins verweisen, da der Befehl durch eine Shell ausgeführt wird. Claude Code meldet den Server als fehlkonfiguriert mit einem [Fehler](/docs/de/errors#plugin-command-references-user-config) und ersetzt den Wert nicht. Setzen Sie `${user_config.KEY}` stattdessen in das Feld `headers` des Servers, das nicht shell-geparst wird, oder lassen Sie das Helper-Skript den Wert aus seiner eigenen Umgebung oder einer Konfigurationsdatei lesen. Vor v2.1.207 ersetzte `headersHelper` `${user_config.*}`-Werte.

815 815

816<Note>816<Note>

817 `headersHelper` führt beliebige Shell-Befehle aus. Wenn es auf Projekt- oder lokalem Bereich definiert ist, wird es nur nach Ihrer Zustimmung zum Workspace-Trust-Dialog ausgeführt.817 `headersHelper` führt beliebige Shell-Befehle aus. Wenn es auf Projekt- oder lokalem Bereich definiert ist, wird es nur nach Ihrer Zustimmung zum Workspace-Trust-Dialog ausgeführt.

920 920

921Ab v2.1.161 werden Connectoren, bei denen Sie sich noch nie angemeldet haben, hinter einer Zeile `Show unused connectors` am Ende des Claude.ai-Abschnitts eingeklappt, sodass eine von der Organisation bereitgestellte Liste das Panel nicht ausfüllt. Wählen Sie die Zeile aus, um sie zu erweitern. Ein Connector, bei dem Sie sich zuvor angemeldet haben, bleibt sichtbar, auch wenn er derzeit eine erneute Authentifizierung benötigt.921Ab v2.1.161 werden Connectoren, bei denen Sie sich noch nie angemeldet haben, hinter einer Zeile `Show unused connectors` am Ende des Claude.ai-Abschnitts eingeklappt, sodass eine von der Organisation bereitgestellte Liste das Panel nicht ausfüllt. Wählen Sie die Zeile aus, um sie zu erweitern. Ein Connector, bei dem Sie sich zuvor angemeldet haben, bleibt sichtbar, auch wenn er derzeit eine erneute Authentifizierung benötigt.

922 922

923Claude.ai-Connectoren werden nur abgerufen, wenn Ihre aktive [Authentifizierungsmethode](/de/authentication#authentication-precedence) Ihr Claude.ai-Abonnement ist. Sie werden nicht geladen, wenn `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper` oder ein Drittanbieter wie Amazon Bedrock oder Google Cloud's Agent Platform aktiv ist, auch wenn Sie zuvor `/login` ausgeführt haben.923Claude.ai-Connectoren werden nur abgerufen, wenn Ihre aktive [Authentifizierungsmethode](/docs/de/authentication#authentication-precedence) Ihr Claude.ai-Abonnement ist. Sie werden nicht geladen, wenn `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper` oder ein Drittanbieter wie Amazon Bedrock oder Google Cloud's Agent Platform aktiv ist, auch wenn Sie zuvor `/login` ausgeführt haben.

924 924

925Wenn `/mcp` einen Connector, den Sie hinzugefügt haben, nicht auflistet, führen Sie `/status` aus, um zu bestätigen, welche Authentifizierungsmethode aktiv ist, heben Sie diese Umgebungsvariable auf oder entfernen Sie die `apiKeyHelper`-Einstellung, und führen Sie dann `/login` aus, um Ihr Claude.ai-Konto auszuwählen.925Wenn `/mcp` einen Connector, den Sie hinzugefügt haben, nicht auflistet, führen Sie `/status` aus, um zu bestätigen, welche Authentifizierungsmethode aktiv ist, heben Sie diese Umgebungsvariable auf oder entfernen Sie die `apiKeyHelper`-Einstellung, und führen Sie dann `/login` aus, um Ihr Claude.ai-Konto auszuwählen.

926 926

934 934

935Ihre Organisation kann Pro-Tool-Steuerungen auf [claude.ai-Connectoren](https://claude.com/docs/connectors) festlegen. Claude Code liest diese Einstellungen beim Start und erzwingt sie lokal. Führen Sie `/mcp` aus, um zu sehen, welche Einstellung für jedes Tool auf einem Connector gilt.935Ihre Organisation kann Pro-Tool-Steuerungen auf [claude.ai-Connectoren](https://claude.com/docs/connectors) festlegen. Claude Code liest diese Einstellungen beim Start und erzwingt sie lokal. Führen Sie `/mcp` aus, um zu sehen, welche Einstellung für jedes Tool auf einem Connector gilt.

936 936

937* **Tool auf `ask` gesetzt**: Claude Code fordert bei jedem Aufruf mit dem Grund `Your organization requires approval for this tool` auf. Die Aufforderung erscheint auch in den [Berechtigungsmodi](/de/permissions#permission-modes) `acceptEdits`, `auto` und `bypassPermissions` und bietet niemals eine Option, Ihre Wahl zu speichern. [Zulassungsregeln](/de/permissions), die dem Tool entsprechen, überspringen die Aufforderung auch nicht. Im Modus `dontAsk`, der niemals auffordert, lehnt Claude Code den Aufruf stattdessen ab.937* **Tool auf `ask` gesetzt**: Claude Code fordert bei jedem Aufruf mit dem Grund `Your organization requires approval for this tool` auf. Die Aufforderung erscheint auch in den [Berechtigungsmodi](/docs/de/permissions#permission-modes) `acceptEdits`, `auto` und `bypassPermissions` und bietet niemals eine Option, Ihre Wahl zu speichern. [Zulassungsregeln](/docs/de/permissions), die dem Tool entsprechen, überspringen die Aufforderung auch nicht. Im Modus `dontAsk`, der niemals auffordert, lehnt Claude Code den Aufruf stattdessen ab.

938* **Tool auf `blocked` gesetzt**: Claude Code filtert das Tool heraus, bevor Claude es sieht, sodass es niemals in der Tool-Liste erscheint.938* **Tool auf `blocked` gesetzt**: Claude Code filtert das Tool heraus, bevor Claude es sieht, sodass es niemals in der Tool-Liste erscheint.

939 939

940Das Erzwingen dieser Steuerungen erfordert Claude Code v2.1.129 oder später. Frühere Versionen ignorieren die Einstellungen und wenden den Standard-Berechtigungsfluss an.940Das Erzwingen dieser Steuerungen erfordert Claude Code v2.1.129 oder später. Frühere Versionen ignorieren die Einstellungen und wenden den Standard-Berechtigungsfluss an.

943 Claude.ai-Connectoren deaktivieren943 Claude.ai-Connectoren deaktivieren

944</h3>944</h3>

945 945

946Um Claude.ai-MCP-Server in Claude Code zu deaktivieren, setzen Sie [`disableClaudeAiConnectors`](/de/settings#available-settings) auf `true` in einem beliebigen Einstellungsbereich:946Um Claude.ai-MCP-Server in Claude Code zu deaktivieren, setzen Sie [`disableClaudeAiConnectors`](/docs/de/settings#available-settings) auf `true` in einem beliebigen Einstellungsbereich:

947 947

948```json theme={null}948```json theme={null}

949{949{

959ENABLE_CLAUDEAI_MCP_SERVERS=false claude959ENABLE_CLAUDEAI_MCP_SERVERS=false claude

960```960```

961 961

962Um einzelne Claude.ai-Connectoren zu blockieren, anstatt alle zu blockieren, fügen Sie sie zu [`deniedMcpServers`](/de/managed-mcp) nach Name oder nach URL-Muster hinzu. Beispielsweise blockiert ein `serverName`-Eintrag von `"claude.ai Slack"` den Slack-Connector. Um einen Connector nur für das aktuelle Projekt ein- oder auszuschalten, verwenden Sie das `/mcp`-Panel.962Um einzelne Claude.ai-Connectoren zu blockieren, anstatt alle zu blockieren, fügen Sie sie zu [`deniedMcpServers`](/docs/de/managed-mcp) nach Name oder nach URL-Muster hinzu. Beispielsweise blockiert ein `serverName`-Eintrag von `"claude.ai Slack"` den Slack-Connector. Um einen Connector nur für das aktuelle Projekt ein- oder auszuschalten, verwenden Sie das `/mcp`-Panel.

963 963

964<Note>964<Note>

965 Diese clientseitigen Einstellungen regeln lokale Claude Code-Sitzungen. In [Claude Code im Web](/de/claude-code-on-the-web)-Sitzungen werden Claude.ai-Connectoren vom Remote-Host bereitgestellt und kommen als explizite `--mcp-config`-Einträge an, daher gilt `disableClaudeAiConnectors` dort nicht. Connector-URLs werden auch durch den Sitzungs-Proxy umgeschrieben, daher passt ein `deniedMcpServers`-`serverUrl`-Muster, das auf die Anbieter-URL abzielt, nicht. Verwalten Sie, welche Connectoren eine Cloud-Sitzung verwenden kann, über Ihre Claude.ai-Organisationseinstellungen.965 Diese clientseitigen Einstellungen regeln lokale Claude Code-Sitzungen. In [Claude Code im Web](/docs/de/claude-code-on-the-web)-Sitzungen werden Claude.ai-Connectoren vom Remote-Host bereitgestellt und kommen als explizite `--mcp-config`-Einträge an, daher gilt `disableClaudeAiConnectors` dort nicht. Connector-URLs werden auch durch den Sitzungs-Proxy umgeschrieben, daher passt ein `deniedMcpServers`-`serverUrl`-Muster, das auf die Anbieter-URL abzielt, nicht. Verwalten Sie, welche Connectoren eine Cloud-Sitzung verwenden kann, über Ihre Claude.ai-Organisationseinstellungen.

966</Note>966</Note>

967 967

968<h2 id="use-claude-code-as-an-mcp-server">968<h2 id="use-claude-code-as-an-mcp-server">

1095 1095

1096Wenn Sie einen MCP-Server erstellen, können Sie ein Tool als Genehmigung bei jedem Aufruf erforderlich markieren, indem Sie `_meta["anthropic/requiresUserInteraction"]` auf `true` in der Tool-Antwort des `tools/list` einstellen. Der Wert muss das JSON-Boolean `true` sein; jeder andere Wert wird ignoriert.1096Wenn Sie einen MCP-Server erstellen, können Sie ein Tool als Genehmigung bei jedem Aufruf erforderlich markieren, indem Sie `_meta["anthropic/requiresUserInteraction"]` auf `true` in der Tool-Antwort des `tools/list` einstellen. Der Wert muss das JSON-Boolean `true` sein; jeder andere Wert wird ignoriert.

1097 1097

1098Claude Code zeigt die Genehmigungsaufforderung dieses Tools bei jedem Aufruf an, auch in `acceptEdits`, `auto` und `bypassPermissions` [Genehmigungsmodi](/de/permissions#permission-modes), und bietet keine Option „Nicht erneut fragen" dafür an. [Allow-Regeln](/de/permissions#permission-rule-syntax), die das Tool abgleichen, überspringen die Aufforderung auch nicht. Im `dontAsk`-Modus, der niemals auffordert, lehnt Claude Code den Aufruf stattdessen ab.1098Claude Code zeigt die Genehmigungsaufforderung dieses Tools bei jedem Aufruf an, auch in `acceptEdits`, `auto` und `bypassPermissions` [Genehmigungsmodi](/docs/de/permissions#permission-modes), und bietet keine Option „Nicht erneut fragen" dafür an. [Allow-Regeln](/docs/de/permissions#permission-rule-syntax), die das Tool abgleichen, überspringen die Aufforderung auch nicht. Im `dontAsk`-Modus, der niemals auffordert, lehnt Claude Code den Aufruf stattdessen ab.

1099 1099

1100Die Aufforderung muss eine Person erreichen. Im nicht-interaktiven Modus mit [`--permission-prompt-tool`](/de/cli-reference#cli-flags) wird ein `allow`-Ergebnis aus dem Genehmigungstool für ein gekennzeichnetes Tool in eine Ablehnung mit der Nachricht `MCP tool requires user interaction; not supported via --permission-prompt-tool` umgewandelt. Der [`canUseTool`-Callback](/de/agent-sdk/permissions) des Agent SDK empfängt diese Aufrufe und kann sie genehmigen, da der SDK-Host diese dem Benutzer zeigen soll.1100Die Aufforderung muss eine Person erreichen. Im nicht-interaktiven Modus mit [`--permission-prompt-tool`](/docs/de/cli-reference#cli-flags) wird ein `allow`-Ergebnis aus dem Genehmigungstool für ein gekennzeichnetes Tool in eine Ablehnung mit der Nachricht `MCP tool requires user interaction; not supported via --permission-prompt-tool` umgewandelt. Der [`canUseTool`-Callback](/docs/de/agent-sdk/permissions) des Agent SDK empfängt diese Aufrufe und kann sie genehmigen, da der SDK-Host diese dem Benutzer zeigen soll.

1101 1101

1102Verwenden Sie dies für Tools, deren Genehmigungsaufforderung selbst der Punkt ist, wie ein Zustimmungs- oder Zugriffsgenehmigungsschritt, bei dem Auto-Genehmigung bedeuten würde, dass kein Mensch jemals zugestimmt hat. Andere Tools vom gleichen Server behalten ihr normales Genehmigungsverhalten.1102Verwenden Sie dies für Tools, deren Genehmigungsaufforderung selbst der Punkt ist, wie ein Zustimmungs- oder Zugriffsgenehmigungsschritt, bei dem Auto-Genehmigung bedeuten würde, dass kein Mensch jemals zugestimmt hat. Andere Tools vom gleichen Server behalten ihr normales Genehmigungsverhalten.

1103 1103

1115 1115

1116Die Anmerkung `anthropic/requiresUserInteraction` erfordert Claude Code v2.1.199 oder später. Frühere Versionen ignorieren sie und wenden den Standard-Genehmigungsfluss an.1116Die Anmerkung `anthropic/requiresUserInteraction` erfordert Claude Code v2.1.199 oder später. Frühere Versionen ignorieren sie und wenden den Standard-Genehmigungsfluss an.

1117 1117

1118Wenn eine Sitzung mit [Remote Control](/de/remote-control) oder einem SDK-Host verbunden ist, markiert Claude Code die Genehmigungsanfrage als Benutzerinteraktion erforderlich, daher zeigt der Client die Genehmigungsaufforderung des Tools für Sie an, anstatt einer One-Tap-Genehmigungsaktion.1118Wenn eine Sitzung mit [Remote Control](/docs/de/remote-control) oder einem SDK-Host verbunden ist, markiert Claude Code die Genehmigungsanfrage als Benutzerinteraktion erforderlich, daher zeigt der Client die Genehmigungsaufforderung des Tools für Sie an, anstatt einer One-Tap-Genehmigungsaktion.

1119 1119

1120<h2 id="respond-to-mcp-elicitation-requests">1120<h2 id="respond-to-mcp-elicitation-requests">

1121 Reagieren Sie auf MCP-Elicitierungsanfragen1121 Reagieren Sie auf MCP-Elicitierungsanfragen

1128* **Formularmodus**: Claude Code zeigt einen Dialog mit Formularfeldern an, die vom Server definiert werden (zum Beispiel eine Eingabeaufforderung für Benutzername und Passwort). Füllen Sie die Felder aus und senden Sie sie ab.1128* **Formularmodus**: Claude Code zeigt einen Dialog mit Formularfeldern an, die vom Server definiert werden (zum Beispiel eine Eingabeaufforderung für Benutzername und Passwort). Füllen Sie die Felder aus und senden Sie sie ab.

1129* **URL-Modus**: Claude Code öffnet eine Browser-URL für Authentifizierung oder Genehmigung. Führen Sie den Ablauf im Browser durch und bestätigen Sie dann in der CLI.1129* **URL-Modus**: Claude Code öffnet eine Browser-URL für Authentifizierung oder Genehmigung. Führen Sie den Ablauf im Browser durch und bestätigen Sie dann in der CLI.

1130 1130

1131Um automatisch auf Elicitierungsanfragen ohne Dialog zu reagieren, verwenden Sie den [`Elicitation`-Hook](/de/hooks#elicitation).1131Um automatisch auf Elicitierungsanfragen ohne Dialog zu reagieren, verwenden Sie den [`Elicitation`-Hook](/docs/de/hooks#elicitation).

1132 1132

1133Wenn Sie einen MCP-Server erstellen, der Elicitierung verwendet, siehe die [MCP-Elicitierungs-Spezifikation](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) für Protokolldetails und Schema-Beispiele.1133Wenn Sie einen MCP-Server erstellen, der Elicitierung verwendet, siehe die [MCP-Elicitierungs-Spezifikation](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) für Protokolldetails und Schema-Beispiele.

1134 1134

1195 Für MCP-Server-Autoren1195 Für MCP-Server-Autoren

1196</h3>1196</h3>

1197 1197

1198Wenn Sie einen MCP-Server erstellen, wird das Feld für Server-Anweisungen mit aktivierter Tool-Suche nützlicher. Server-Anweisungen helfen Claude zu verstehen, wann nach Ihren Tools gesucht werden soll, ähnlich wie [Skills](/de/skills) funktionieren.1198Wenn Sie einen MCP-Server erstellen, wird das Feld für Server-Anweisungen mit aktivierter Tool-Suche nützlicher. Server-Anweisungen helfen Claude zu verstehen, wann nach Ihren Tools gesucht werden soll, ähnlich wie [Skills](/docs/de/skills) funktionieren.

1199 1199

1200Fügen Sie klare, aussagekräftige Server-Anweisungen hinzu, die erklären:1200Fügen Sie klare, aussagekräftige Server-Anweisungen hinzu, die erklären:

1201 1201

1211 1211

1212Die Tool-Suche ist standardmäßig aktiviert: MCP-Tools werden aufgeschoben und bei Bedarf entdeckt. Claude Code deaktiviert sie standardmäßig auf Google Cloud's Agent Platform. Sie ist auch deaktiviert, wenn `ANTHROPIC_BASE_URL` auf einen Host von Drittanbietern verweist, da die meisten Proxys `tool_reference`-Blöcke nicht weiterleiten. Setzen Sie `ENABLE_TOOL_SEARCH` explizit fest, um eine der beiden Fallback-Einstellungen zu überschreiben.1212Die Tool-Suche ist standardmäßig aktiviert: MCP-Tools werden aufgeschoben und bei Bedarf entdeckt. Claude Code deaktiviert sie standardmäßig auf Google Cloud's Agent Platform. Sie ist auch deaktiviert, wenn `ANTHROPIC_BASE_URL` auf einen Host von Drittanbietern verweist, da die meisten Proxys `tool_reference`-Blöcke nicht weiterleiten. Setzen Sie `ENABLE_TOOL_SEARCH` explizit fest, um eine der beiden Fallback-Einstellungen zu überschreiben.

1213 1213

1214Setting [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/de/env-vars) hält die Tool-Suche aus, und `ENABLE_TOOL_SEARCH` kann dies nicht überschreiben. Die Variable entfernt den Beta-Header, den `defer_loading`-Tool-Definitionen und `tool_reference`-Inhaltsblöcke erfordern.1214Setting [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/de/env-vars) hält die Tool-Suche aus, und `ENABLE_TOOL_SEARCH` kann dies nicht überschreiben. Die Variable entfernt den Beta-Header, den `defer_loading`-Tool-Definitionen und `tool_reference`-Inhaltsblöcke erfordern.

1215 1215

1216Die Tool-Suche erfordert ein Modell, das `tool_reference`-Blöcke unterstützt: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 und neuere Modelle. Siehe [Modellkompatibilität in der API-Dokumentation](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool#model-compatibility) für die aktuelle Liste. Auf Google Cloud's Agent Platform wird die Tool-Suche für Claude Sonnet 4.5 und später sowie Claude Opus 4.5 und später unterstützt.1216Die Tool-Suche erfordert ein Modell, das `tool_reference`-Blöcke unterstützt: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 und neuere Modelle. Siehe [Modellkompatibilität in der API-Dokumentation](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool#model-compatibility) für die aktuelle Liste. Auf Google Cloud's Agent Platform wird die Tool-Suche für Claude Sonnet 4.5 und später sowie Claude Opus 4.5 und später unterstützt.

1217 1217

1233ENABLE_TOOL_SEARCH=false claude1233ENABLE_TOOL_SEARCH=false claude

1234```1234```

1235 1235

1236Oder legen Sie den Wert im Feld `env` Ihrer [settings.json](/de/settings#available-settings) fest.1236Oder legen Sie den Wert im Feld `env` Ihrer [settings.json](/docs/de/settings#available-settings) fest.

1237 1237

1238Sie können das `ToolSearch`-Tool auch spezifisch deaktivieren:1238Sie können das `ToolSearch`-Tool auch spezifisch deaktivieren:

1239 1239

1267 1267

1268Das Feld `alwaysLoad` ist auf allen Server-Typen verfügbar und erfordert Claude Code v2.1.121 oder später. Ein MCP-Server kann auch einzelne Tools als immer geladen markieren, indem `"anthropic/alwaysLoad": true` im `_meta`-Objekt des Tools enthalten ist, was denselben Effekt nur für dieses Tool hat.1268Das Feld `alwaysLoad` ist auf allen Server-Typen verfügbar und erfordert Claude Code v2.1.121 oder später. Ein MCP-Server kann auch einzelne Tools als immer geladen markieren, indem `"anthropic/alwaysLoad": true` im `_meta`-Objekt des Tools enthalten ist, was denselben Effekt nur für dieses Tool hat.

1269 1269

1270Das Setzen von `alwaysLoad: true` blockiert auch den Start, bis sich der Server verbindet, begrenzt auf das Standard-Verbindungs-Timeout von 5 Sekunden. Dies gilt auch, obwohl MCP-Startup ansonsten [standardmäßig nicht blockierend ist](/de/env-vars), da die Tools vorhanden sein müssen, wenn der erste Prompt erstellt wird. Andere Server verbinden sich weiterhin im Hintergrund.1270Das Setzen von `alwaysLoad: true` blockiert auch den Start, bis sich der Server verbindet, begrenzt auf das Standard-Verbindungs-Timeout von 5 Sekunden. Dies gilt auch, obwohl MCP-Startup ansonsten [standardmäßig nicht blockierend ist](/docs/de/env-vars), da die Tools vorhanden sein müssen, wenn der erste Prompt erstellt wird. Andere Server verbinden sich weiterhin im Hintergrund.

1271 1271

1272<h2 id="use-mcp-prompts-as-commands">1272<h2 id="use-mcp-prompts-as-commands">

1273 MCP-Prompts als Befehle verwenden1273 MCP-Prompts als Befehle verwenden

1316 Verwaltete MCP-Konfiguration1316 Verwaltete MCP-Konfiguration

1317</h2>1317</h2>

1318 1318

1319Für Organisationen, die eine zentralisierte Kontrolle über MCP-Server benötigen, die Benutzer verbinden können, siehe [Verwaltete MCP-Konfiguration](/de/managed-mcp). Sie behandelt die Bereitstellung eines festen Serversatzes mit `managed-mcp.json`, die Einschränkung von Servern mit `allowedMcpServers` und `deniedMcpServers` sowie das, was Benutzer sehen, wenn ein Server blockiert ist.1319Für Organisationen, die eine zentralisierte Kontrolle über MCP-Server benötigen, die Benutzer verbinden können, siehe [Verwaltete MCP-Konfiguration](/docs/de/managed-mcp). Sie behandelt die Bereitstellung eines festen Serversatzes mit `managed-mcp.json`, die Einschränkung von Servern mit `allowedMcpServers` und `deniedMcpServers` sowie das, was Benutzer sehen, wenn ein Server blockiert ist.

memory.md +21 −21

Details

22 CLAUDE.md vs. Auto-Memory22 CLAUDE.md vs. Auto-Memory

23</h2>23</h2>

24 24

25Claude Code hat zwei komplementäre Memory-Systeme. Beide werden zu Beginn jeder Konversation geladen. Claude behandelt sie als Kontext, nicht als erzwungene Konfiguration. Um eine Aktion unabhängig davon zu blockieren, was Claude entscheidet, verwenden Sie stattdessen einen [PreToolUse Hook](/de/hooks-guide). Je spezifischer und prägnanter Ihre Anweisungen sind, desto konsistenter folgt Claude ihnen.25Claude Code hat zwei komplementäre Memory-Systeme. Beide werden zu Beginn jeder Konversation geladen. Claude behandelt sie als Kontext, nicht als erzwungene Konfiguration. Um eine Aktion unabhängig davon zu blockieren, was Claude entscheidet, verwenden Sie stattdessen einen [PreToolUse Hook](/docs/de/hooks-guide). Je spezifischer und prägnanter Ihre Anweisungen sind, desto konsistenter folgt Claude ihnen.

26 26

27| | CLAUDE.md-Dateien | Auto-Memory |27| | CLAUDE.md-Dateien | Auto-Memory |

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

34 34

35Verwenden Sie CLAUDE.md-Dateien, wenn Sie Claudes Verhalten lenken möchten. Auto-Memory lässt Claude aus Ihren Korrektionen lernen, ohne manuelle Anstrengung.35Verwenden Sie CLAUDE.md-Dateien, wenn Sie Claudes Verhalten lenken möchten. Auto-Memory lässt Claude aus Ihren Korrektionen lernen, ohne manuelle Anstrengung.

36 36

~~37Subagents können auch ihre eigene Auto-Memory pflegen. Weitere Informationen finden Sie unter [Subagent-Konfiguration](/de/sub-agents#enable-persistent-memory).~~37Subagents können auch ihre eigene Auto-Memory pflegen. Weitere Informationen finden Sie unter [Subagent-Konfiguration](/docs/de/sub-agents#enable-persistent-memory).

38 38

39<h2 id="claude-md-files">39<h2 id="claude-md-files">

40 CLAUDE.md-Dateien40 CLAUDE.md-Dateien

53* Sie tippen die gleiche Korrektur oder Klarstellung in den Chat, die Sie letzte Sitzung eingegeben haben53* Sie tippen die gleiche Korrektur oder Klarstellung in den Chat, die Sie letzte Sitzung eingegeben haben

54* Ein neuer Teamkollege den gleichen Kontext benötigen würde, um produktiv zu sein54* Ein neuer Teamkollege den gleichen Kontext benötigen würde, um produktiv zu sein

55 55

56Halten Sie es bei Fakten, die Claude in jeder Sitzung behalten sollte: Build-Befehle, Konventionen, Projektlayout, „immer X machen"-Regeln. Wenn ein Eintrag ein mehrstufiges Verfahren ist oder nur für einen Teil der Codebasis wichtig ist, verschieben Sie ihn stattdessen zu einem [Skill](/de/skills) oder einer [pfadgebundenen Regel](#organize-rules-with-claude/rules/). Die [Funktionsübersicht](/de/features-overview#build-your-setup-over-time) behandelt, wann Sie jeden Mechanismus verwenden.56Halten Sie es bei Fakten, die Claude in jeder Sitzung behalten sollte: Build-Befehle, Konventionen, Projektlayout, „immer X machen"-Regeln. Wenn ein Eintrag ein mehrstufiges Verfahren ist oder nur für einen Teil der Codebasis wichtig ist, verschieben Sie ihn stattdessen zu einem [Skill](/docs/de/skills) oder einer [pfadgebundenen Regel](#organize-rules-with-claude/rules/). Die [Funktionsübersicht](/docs/de/features-overview#build-your-setup-over-time) behandelt, wann Sie jeden Mechanismus verwenden.

57 57

58<h3 id="choose-where-to-put-claude-md-files">58<h3 id="choose-where-to-put-claude-md-files">

59 Wählen Sie, wo Sie CLAUDE.md-Dateien ablegen59 Wählen Sie, wo Sie CLAUDE.md-Dateien ablegen

88 Schreiben Sie effektive Anweisungen88 Schreiben Sie effektive Anweisungen

89</h3>89</h3>

90 90

91CLAUDE.md-Dateien werden zu Beginn jeder Sitzung in das Context Window geladen und verbrauchen Token zusammen mit Ihrer Konversation. Die [Context Window-Visualisierung](/de/context-window) zeigt, wo CLAUDE.md relativ zum Rest des Startup-Kontexts geladen wird. Da sie Kontext statt erzwungene Konfiguration sind, beeinflusst die Art, wie Sie Anweisungen schreiben, wie zuverlässig Claude ihnen folgt. Spezifische, prägnante, gut strukturierte Anweisungen funktionieren am besten.91CLAUDE.md-Dateien werden zu Beginn jeder Sitzung in das Context Window geladen und verbrauchen Token zusammen mit Ihrer Konversation. Die [Context Window-Visualisierung](/docs/de/context-window) zeigt, wo CLAUDE.md relativ zum Rest des Startup-Kontexts geladen wird. Da sie Kontext statt erzwungene Konfiguration sind, beeinflusst die Art, wie Sie Anweisungen schreiben, wie zuverlässig Claude ihnen folgt. Spezifische, prägnante, gut strukturierte Anweisungen funktionieren am besten.

92 92

93**Größe**: Ziel unter 200 Zeilen pro CLAUDE.md-Datei. Längere Dateien verbrauchen mehr Kontext und reduzieren die Einhaltung. Wenn Ihre Anweisungen zu groß werden, verwenden Sie [pfadgebundene Regeln](#path-specific-rules), damit Anweisungen nur geladen werden, wenn Claude mit übereinstimmenden Dateien arbeitet, um Rauschen zu reduzieren und Kontextraum zu sparen. Sie können auch Inhalte in [Importe](#import-additional-files) aufteilen, um sie zu organisieren, obwohl importierte Dateien immer noch geladen werden und beim Start in das Context Window eingehen.93**Größe**: Ziel unter 200 Zeilen pro CLAUDE.md-Datei. Längere Dateien verbrauchen mehr Kontext und reduzieren die Einhaltung. Wenn Ihre Anweisungen zu groß werden, verwenden Sie [pfadgebundene Regeln](#path-specific-rules), damit Anweisungen nur geladen werden, wenn Claude mit übereinstimmenden Dateien arbeitet, um Rauschen zu reduzieren und Kontextraum zu sparen. Sie können auch Inhalte in [Importe](#import-additional-files) aufteilen, um sie zu organisieren, obwohl importierte Dateien immer noch geladen werden und beim Start in das Context Window eingehen.

94 94

158 158

159Unter Windows erfordert das Erstellen eines Symlinks Administratorrechte oder Developer Mode, daher verwenden Sie stattdessen den Import `@AGENTS.md`.159Unter Windows erfordert das Erstellen eines Symlinks Administratorrechte oder Developer Mode, daher verwenden Sie stattdessen den Import `@AGENTS.md`.

160 160

161Das Ausführen von [`/init`](/de/commands) in einem Repo, das bereits eine `AGENTS.md` hat, liest diese und integriert die relevanten Teile in die generierte `CLAUDE.md`. Es liest auch andere Tool-Konfigurationen wie `.cursorrules`, `.devin/rules/` und `.windsurfrules`.161Das Ausführen von [`/init`](/docs/de/commands) in einem Repo, das bereits eine `AGENTS.md` hat, liest diese und integriert die relevanten Teile in die generierte `CLAUDE.md`. Es liest auch andere Tool-Konfigurationen wie `.cursorrules`, `.devin/rules/` und `.windsurfrules`.

162 162

163<h3 id="how-claude-md-files-load">163<h3 id="how-claude-md-files-load">

164 Wie CLAUDE.md-Dateien geladen werden164 Wie CLAUDE.md-Dateien geladen werden

170 170

171Claude 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.171Claude 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.

172 172

173Wenn 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](/de/large-codebases).173Wenn 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).

174 174

175Block-Level-HTML-Kommentare (``) in CLAUDE.md-Dateien werden vor der Injektion in Claudes Kontext entfernt. Verwenden Sie sie, um Notizen für menschliche Betreuer zu hinterlassen, ohne Kontext-Token darauf zu verschwenden. Kommentare innerhalb von Code-Blöcken werden beibehalten. Wenn Sie eine CLAUDE.md-Datei direkt mit dem Read-Tool öffnen, bleiben Kommentare sichtbar.175Block-Level-HTML-Kommentare (``) in CLAUDE.md-Dateien werden vor der Injektion in Claudes Kontext entfernt. Verwenden Sie sie, um Notizen für menschliche Betreuer zu hinterlassen, ohne Kontext-Token darauf zu verschwenden. Kommentare innerhalb von Code-Blöcken werden beibehalten. Wenn Sie eine CLAUDE.md-Datei direkt mit dem Read-Tool öffnen, bleiben Kommentare sichtbar.

176 176

186CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config186CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

187```187```

188 188

189Dies lädt `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` und `CLAUDE.local.md` aus dem zusätzlichen Verzeichnis. `CLAUDE.local.md` wird übersprungen, wenn Sie `local` aus [`--setting-sources`](/de/cli-reference) ausschließen.189Dies lädt `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` und `CLAUDE.local.md` aus dem zusätzlichen Verzeichnis. `CLAUDE.local.md` wird übersprungen, wenn Sie `local` aus [`--setting-sources`](/docs/de/cli-reference) ausschließen.

190 190

191<h3 id="organize-rules-with-claude/rules/">191<h3 id="organize-rules-with-claude/rules/">

192 Organisieren Sie Regeln mit `.claude/rules/`192 Organisieren Sie Regeln mit `.claude/rules/`

195Für größere Projekte können Sie Anweisungen in mehrere Dateien mit dem Verzeichnis `.claude/rules/` organisieren. Dies hält Anweisungen modular und leichter für Teams zu pflegen. Regeln können auch [auf bestimmte Dateipfade beschränkt werden](#path-specific-rules), sodass sie nur in den Kontext geladen werden, wenn Claude mit übereinstimmenden Dateien arbeitet, was Rauschen reduziert und Kontextraum spart.195Für größere Projekte können Sie Anweisungen in mehrere Dateien mit dem Verzeichnis `.claude/rules/` organisieren. Dies hält Anweisungen modular und leichter für Teams zu pflegen. Regeln können auch [auf bestimmte Dateipfade beschränkt werden](#path-specific-rules), sodass sie nur in den Kontext geladen werden, wenn Claude mit übereinstimmenden Dateien arbeitet, was Rauschen reduziert und Kontextraum spart.

196 196

197<Note>197<Note>

198 Regeln werden in jeder Sitzung oder beim Öffnen übereinstimmender Dateien in den Kontext geladen. Für aufgabenspezifische Anweisungen, die nicht ständig im Kontext sein müssen, verwenden Sie stattdessen [Skills](/de/skills), die nur geladen werden, wenn Sie sie aufrufen oder wenn Claude bestimmt, dass sie für Ihren Prompt relevant sind.198 Regeln werden in jeder Sitzung oder beim Öffnen übereinstimmender Dateien in den Kontext geladen. Für aufgabenspezifische Anweisungen, die nicht ständig im Kontext sein müssen, verwenden Sie stattdessen [Skills](/docs/de/skills), die nur geladen werden, wenn Sie sie aufrufen oder wenn Claude bestimmt, dass sie für Ihren Prompt relevant sind.

199</Note>199</Note>

200 200

201<h4 id="set-up-rules">201<h4 id="set-up-rules">

306 </Step>306 </Step>

307 307

308 <Step title="Stellen Sie mit Ihrem Konfigurationsverwaltungssystem bereit">308 <Step title="Stellen Sie mit Ihrem Konfigurationsverwaltungssystem bereit">

309 Verwenden Sie MDM, Group Policy, Ansible oder ähnliche Tools, um die Datei über Entwicklermaschinen zu verteilen. Weitere Informationen finden Sie unter [verwaltete Einstellungen](/de/permissions#managed-settings) für andere organisationsweite Konfigurationsoptionen.309 Verwenden Sie MDM, Group Policy, Ansible oder ähnliche Tools, um die Datei über Entwicklermaschinen zu verteilen. Weitere Informationen finden Sie unter [verwaltete Einstellungen](/docs/de/permissions#managed-settings) für andere organisationsweite Konfigurationsoptionen.

310 </Step>310 </Step>

311</Steps>311</Steps>

312 312

326}326}

327```327```

328 328

329Eine verwaltete CLAUDE.md und [verwaltete Einstellungen](/de/settings#settings-files) dienen unterschiedlichen Zwecken. Verwenden Sie Einstellungen für technische Durchsetzung und CLAUDE.md für Verhaltensanleitung:329Eine verwaltete CLAUDE.md und [verwaltete Einstellungen](/docs/de/settings#settings-files) dienen unterschiedlichen Zwecken. Verwenden Sie Einstellungen für technische Durchsetzung und CLAUDE.md für Verhaltensanleitung:

330 330

331| Anliegen | Konfigurieren in |331| Anliegen | Konfigurieren in |

332| :------------------------------------------------------ | :---------------------------------------------------------------- |332| :------------------------------------------------------ | :---------------------------------------------------------------- |

357}357}

358```358```

359 359

360Muster werden mit Glob-Syntax gegen absolute Dateipfade abgeglichen. Sie können `claudeMdExcludes` auf jeder [Einstellungsebene](/de/settings#settings-files) konfigurieren: Benutzer, Projekt, lokal oder verwaltete Richtlinie. Arrays werden über Ebenen hinweg zusammengeführt.360Muster werden mit Glob-Syntax gegen absolute Dateipfade abgeglichen. Sie können `claudeMdExcludes` auf jeder [Einstellungsebene](/docs/de/settings#settings-files) konfigurieren: Benutzer, Projekt, lokal oder verwaltete Richtlinie. Arrays werden über Ebenen hinweg zusammengeführt.

361 361

362CLAUDE.md-Dateien mit verwalteter Richtlinie können nicht ausgeschlossen werden. Dies stellt sicher, dass organisationsweite Anweisungen unabhängig von individuellen Einstellungen immer gelten.362CLAUDE.md-Dateien mit verwalteter Richtlinie können nicht ausgeschlossen werden. Dies stellt sicher, dass organisationsweite Anweisungen unabhängig von individuellen Einstellungen immer gelten.

363 363

387 387

388Jedes Projekt erhält sein eigenes Memory-Verzeichnis unter `~/.claude/projects/<project>/memory/`. Der Pfad `<project>` wird aus dem Git-Repository abgeleitet, sodass alle Worktrees und Unterverzeichnisse innerhalb desselben Repos ein Auto-Memory-Verzeichnis teilen. Außerhalb eines Git-Repos wird stattdessen das Projektstammverzeichnis verwendet.388Jedes Projekt erhält sein eigenes Memory-Verzeichnis unter `~/.claude/projects/<project>/memory/`. Der Pfad `<project>` wird aus dem Git-Repository abgeleitet, sodass alle Worktrees und Unterverzeichnisse innerhalb desselben Repos ein Auto-Memory-Verzeichnis teilen. Außerhalb eines Git-Repos wird stattdessen das Projektstammverzeichnis verwendet.

389 389

390Um Auto-Memory an einem anderen Ort zu speichern, setzen Sie `autoMemoryDirectory` in Ihrer `settings.json`. Es wird aus jedem [Einstellungsbereich](/de/settings#settings-precedence) gelesen: Benutzer, Projekt, lokal, Richtlinie oder `--settings`.390Um Auto-Memory an einem anderen Ort zu speichern, setzen Sie `autoMemoryDirectory` in Ihrer `settings.json`. Es wird aus jedem [Einstellungsbereich](/docs/de/settings#settings-precedence) gelesen: Benutzer, Projekt, lokal, Richtlinie oder `--settings`.

391 391

392```json theme={null}392```json theme={null}

393{393{

456* Machen Sie Anweisungen spezifischer. „Verwenden Sie 2-Leerzeichen-Einrückung" funktioniert besser als „formatieren Sie Code schön".456* Machen Sie Anweisungen spezifischer. „Verwenden Sie 2-Leerzeichen-Einrückung" funktioniert besser als „formatieren Sie Code schön".

457* Suchen Sie nach widersprüchlichen Anweisungen über CLAUDE.md-Dateien hinweg. Wenn zwei Dateien unterschiedliche Anleitungen für das gleiche Verhalten geben, kann Claude eine willkürlich auswählen.457* Suchen Sie nach widersprüchlichen Anweisungen über CLAUDE.md-Dateien hinweg. Wenn zwei Dateien unterschiedliche Anleitungen für das gleiche Verhalten geben, kann Claude eine willkürlich auswählen.

458 458

459Wenn die Anweisung etwas ist, das an einem bestimmten Punkt ausgeführt werden muss, z. B. vor jedem Commit oder nach jeder Dateibearbeitung, schreiben Sie sie stattdessen als [Hook](/de/hooks-guide). Hooks werden als Shell-Befehle bei festen Lebenszyklusereignissen ausgeführt und gelten unabhängig davon, was Claude entscheidet zu tun.459Wenn die Anweisung etwas ist, das an einem bestimmten Punkt ausgeführt werden muss, z. B. vor jedem Commit oder nach jeder Dateibearbeitung, schreiben Sie sie stattdessen als [Hook](/docs/de/hooks-guide). Hooks werden als Shell-Befehle bei festen Lebenszyklusereignissen ausgeführt und gelten unabhängig davon, was Claude entscheidet zu tun.

460 460

461Für Anweisungen, die Sie auf System-Prompt-Ebene haben möchten, verwenden Sie [`--append-system-prompt`](/de/cli-reference#system-prompt-flags). Dies muss bei jeder Invokation übergeben werden, daher ist es besser für Skripte und Automatisierung als für interaktive Nutzung geeignet.461Für Anweisungen, die Sie auf System-Prompt-Ebene haben möchten, verwenden Sie [`--append-system-prompt`](/docs/de/cli-reference#system-prompt-flags). Dies muss bei jeder Invokation übergeben werden, daher ist es besser für Skripte und Automatisierung als für interaktive Nutzung geeignet.

462 462

463<Tip>463<Tip>

464 Verwenden Sie den [`InstructionsLoaded`-Hook](/de/hooks#instructionsloaded), um genau zu protokollieren, welche Anweisungsdateien geladen sind, wann sie geladen werden und warum. Dies ist nützlich zum Debuggen von pfadspezifischen Regeln oder Lazy-Loading-Dateien in Unterverzeichnissen.464 Verwenden Sie den [`InstructionsLoaded`-Hook](/docs/de/hooks#instructionsloaded), um genau zu protokollieren, welche Anweisungsdateien geladen sind, wann sie geladen werden und warum. Dies ist nützlich zum Debuggen von pfadspezifischen Regeln oder Lazy-Loading-Dateien in Unterverzeichnissen.

465</Tip>465</Tip>

466 466

467<h3 id="i-don’t-know-what-auto-memory-saved">467<h3 id="i-don’t-know-what-auto-memory-saved">

476 476

477Dateien über 200 Zeilen verbrauchen mehr Kontext und können die Einhaltung reduzieren. Verwenden Sie [pfadgebundene Regeln](#path-specific-rules), um Anweisungen nur zu laden, wenn Claude mit übereinstimmenden Dateien arbeitet, oder trimmen Sie Inhalte, die nicht in jeder Sitzung benötigt werden. Das Aufteilen in [`@path`-Importe](#import-additional-files) hilft bei der Organisation, reduziert aber nicht den Kontext, da importierte Dateien beim Start geladen werden.477Dateien über 200 Zeilen verbrauchen mehr Kontext und können die Einhaltung reduzieren. Verwenden Sie [pfadgebundene Regeln](#path-specific-rules), um Anweisungen nur zu laden, wenn Claude mit übereinstimmenden Dateien arbeitet, oder trimmen Sie Inhalte, die nicht in jeder Sitzung benötigt werden. Das Aufteilen in [`@path`-Importe](#import-additional-files) hilft bei der Organisation, reduziert aber nicht den Kontext, da importierte Dateien beim Start geladen werden.

478 478

479{/* min-version: 2.1.206 */}Die [`/doctor`](/de/commands#all-commands)-Überprüfung schlägt Kürzungen für eine eingecheckte CLAUDE.md vor: Sie entfernt Inhalte, die Claude aus der Codebasis ableiten kann, wie Verzeichnislayouts, Abhängigkeitslisten und Architekturübersichten, und behält Fallstricke, Begründungen und Konventionen, die sich von Tool-Standardwerten unterscheiden. Die Trim-Überprüfung erfordert Claude Code v2.1.206 oder später.479Die [`/doctor`](/docs/de/commands#all-commands)-Überprüfung schlägt Kürzungen für eine eingecheckte CLAUDE.md vor: Sie entfernt Inhalte, die Claude aus der Codebasis ableiten kann, wie Verzeichnislayouts, Abhängigkeitslisten und Architekturübersichten, und behält Fallstricke, Begründungen und Konventionen, die sich von Tool-Standardwerten unterscheiden. Die Trim-Überprüfung erfordert Claude Code v2.1.206 oder später.

480 480

481<h3 id="instructions-seem-lost-after-/compact">481<h3 id="instructions-seem-lost-after-/compact">

482 Anweisungen scheinen nach `/compact` verloren zu gehen482 Anweisungen scheinen nach `/compact` verloren zu gehen

484 484

485Projekt-Root-CLAUDE.md übersteht Komprimierung: Nach `/compact` liest Claude sie neu von der Festplatte und injiziert sie frisch in die Sitzung. Verschachtelte CLAUDE.md-Dateien in Unterverzeichnissen werden nicht automatisch erneut injiziert; sie werden neu geladen, wenn Claude das nächste Mal eine Datei in diesem Unterverzeichnis liest.485Projekt-Root-CLAUDE.md übersteht Komprimierung: Nach `/compact` liest Claude sie neu von der Festplatte und injiziert sie frisch in die Sitzung. Verschachtelte CLAUDE.md-Dateien in Unterverzeichnissen werden nicht automatisch erneut injiziert; sie werden neu geladen, wenn Claude das nächste Mal eine Datei in diesem Unterverzeichnis liest.

486 486

487Wenn eine Anweisung nach der Komprimierung verschwunden ist, wurde sie entweder nur in der Konversation gegeben oder befindet sich in einer verschachtelten CLAUDE.md, die noch nicht neu geladen wurde. Fügen Sie Anweisungen, die nur in der Konversation gegeben wurden, zu CLAUDE.md hinzu, um sie über Sitzungen hinweg zu erhalten. Weitere Informationen finden Sie unter [Was übersteht Komprimierung](/de/context-window#what-survives-compaction) für die vollständige Aufschlüsselung.487Wenn eine Anweisung nach der Komprimierung verschwunden ist, wurde sie entweder nur in der Konversation gegeben oder befindet sich in einer verschachtelten CLAUDE.md, die noch nicht neu geladen wurde. Fügen Sie Anweisungen, die nur in der Konversation gegeben wurden, zu CLAUDE.md hinzu, um sie über Sitzungen hinweg zu erhalten. Weitere Informationen finden Sie unter [Was übersteht Komprimierung](/docs/de/context-window#what-survives-compaction) für die vollständige Aufschlüsselung.

488 488

489Weitere Informationen finden Sie unter [Schreiben Sie effektive Anweisungen](#write-effective-instructions) für Anleitungen zu Größe, Struktur und Spezifität.489Weitere Informationen finden Sie unter [Schreiben Sie effektive Anweisungen](#write-effective-instructions) für Anleitungen zu Größe, Struktur und Spezifität.

490 490

492 Verwandte Ressourcen492 Verwandte Ressourcen

493</h2>493</h2>

494 494

495* [Debuggen Sie Ihre Konfiguration](/de/debug-your-config): Diagnostizieren Sie, warum CLAUDE.md oder Einstellungen nicht wirksam werden495* [Debuggen Sie Ihre Konfiguration](/docs/de/debug-your-config): Diagnostizieren Sie, warum CLAUDE.md oder Einstellungen nicht wirksam werden

496* [Skills](/de/skills): Verpacken Sie wiederholbare Workflows, die bei Bedarf geladen werden496* [Skills](/docs/de/skills): Verpacken Sie wiederholbare Workflows, die bei Bedarf geladen werden

497* [Einstellungen](/de/settings): Konfigurieren Sie Claude Code-Verhalten mit Einstellungsdateien497* [Einstellungen](/docs/de/settings): Konfigurieren Sie Claude Code-Verhalten mit Einstellungsdateien

498* [Subagent-Memory](/de/sub-agents#enable-persistent-memory): Lassen Sie Subagents ihre eigene Auto-Memory pflegen498* [Subagent-Memory](/docs/de/sub-agents#enable-persistent-memory): Lassen Sie Subagents ihre eigene Auto-Memory pflegen

microsoft-foundry.md +3 −3

Details

139 139

140**Option C: Bearer-Token-Authentifizierung**140**Option C: Bearer-Token-Authentifizierung**

141 141

142{/* min-version: 2.1.203 */}Claude Code sendet den Wert von `ANTHROPIC_FOUNDRY_AUTH_TOKEN` bei jeder Anfrage als `Authorization: Bearer`-Header. Verwenden Sie diese Option, wenn ein anderer Prozess, z. B. eine Host-Anwendung oder ein Anmeldeskript, bereits ein Zugriffstoken für Sie erhalten hat. Erfordert Claude Code v2.1.203 oder später.142Claude Code sendet den Wert von `ANTHROPIC_FOUNDRY_AUTH_TOKEN` bei jeder Anfrage als `Authorization: Bearer`-Header. Verwenden Sie diese Option, wenn ein anderer Prozess, z. B. eine Host-Anwendung oder ein Anmeldeskript, bereits ein Zugriffstoken für Sie erhalten hat. Erfordert Claude Code v2.1.203 oder später.

143 143

144Legen Sie die Variable auf ein Bearer-Token fest, das Microsoft Entra ID für Ihre Ressource ausgestellt hat:144Legen Sie die Variable auf ein Bearer-Token fest, das Microsoft Entra ID für Ihre Ressource ausgestellt hat:

145 145

189 189

190Hintergrundaufgaben wie die Generierung von Sitzungstiteln verwenden das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Bei Microsoft Foundry setzt Claude Code dies standardmäßig auf das primäre Modell, da nicht jedes Konto eine Haiku-Bereitstellung hat. Um Haiku für Hintergrundaufgaben zu verwenden, legen Sie `ANTHROPIC_DEFAULT_HAIKU_MODEL` auf eine Haiku-Bereitstellung fest, die in Ihrem Konto verfügbar ist, wie oben gezeigt.190Hintergrundaufgaben wie die Generierung von Sitzungstiteln verwenden das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Bei Microsoft Foundry setzt Claude Code dies standardmäßig auf das primäre Modell, da nicht jedes Konto eine Haiku-Bereitstellung hat. Um Haiku für Hintergrundaufgaben zu verwenden, legen Sie `ANTHROPIC_DEFAULT_HAIKU_MODEL` auf eine Haiku-Bereitstellung fest, die in Ihrem Konto verfügbar ist, wie oben gezeigt.

191 191

192Aktuelle und ältere Modell-IDs finden Sie unter [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Siehe [Modellkonfiguration](/de/model-config#pin-models-for-third-party-deployments) für die vollständige Liste der Umgebungsvariablen.192Aktuelle und ältere Modell-IDs finden Sie unter [Modellübersicht](https://platform.claude.com/docs/en/about-claude/models/overview). Siehe [Modellkonfiguration](/docs/de/model-config#pin-models-for-third-party-deployments) für die vollständige Liste der Umgebungsvariablen.

193 193

194[Prompt Caching](/de/prompt-caching) ist automatisch aktiviert. Um stattdessen eine 1-Stunden-Cache-TTL anstelle des 5-Minuten-Standards anzufordern, legen Sie die folgende Variable fest; Cache-Schreibvorgänge mit einer 1-Stunden-TTL werden mit einem höheren Satz abgerechnet:194[Prompt Caching](/docs/de/prompt-caching) ist automatisch aktiviert. Um stattdessen eine 1-Stunden-Cache-TTL anstelle des 5-Minuten-Standards anzufordern, legen Sie die folgende Variable fest; Cache-Schreibvorgänge mit einer 1-Stunden-TTL werden mit einem höheren Satz abgerechnet:

195 195

196```bash theme={null}196```bash theme={null}

197export ENABLE_PROMPT_CACHING_1H=1197export ENABLE_PROMPT_CACHING_1H=1

model-config.md +72 −76

Details

22Hinweise zur Auswahl des Modells und der Aufwandsstufe, die für verschiedene Arten von Arbeit geeignet sind, finden Sie unter [Choosing a Claude model and effort level in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) im Blog.22Hinweise zur Auswahl des Modells und der Aufwandsstufe, die für verschiedene Arten von Arbeit geeignet sind, finden Sie unter [Choosing a Claude model and effort level in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) im Blog.

23 23

24<Note>24<Note>

~~25 `ANTHROPIC_BASE_URL` ändert, wohin Anfragen gesendet werden, nicht welches Modell sie beantwortet. Um Claude durch ein LLM-Gateway zu leiten, siehe [LLM-Gateways](/de/llm-gateway).~~25 `ANTHROPIC_BASE_URL` ändert, wohin Anfragen gesendet werden, nicht welches Modell sie beantwortet. Um Claude durch ein LLM-Gateway zu leiten, siehe [LLM-Gateways](/docs/de/llm-gateway).

26</Note>26</Note>

27 27

28<h3 id="model-aliases">28<h3 id="model-aliases">

42| **`sonnet[1m]`** | Verwendet Sonnet mit einem [1-Million-Token-Kontextfenster](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) für lange Sitzungen. Hat keine Auswirkung, wenn `sonnet` bereits zu Sonnet 5 mit seinem nativen 1M-Fenster aufgelöst wird; hinter einem [LLM-Gateway](/de/llm-gateway) wählt es das 1M-Fenster für Sonnet 5 aus |42| **`sonnet[1m]`** | Verwendet Sonnet mit einem [1-Million-Token-Kontextfenster](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) für lange Sitzungen. Hat keine Auswirkung, wenn `sonnet` bereits zu Sonnet 5 mit seinem nativen 1M-Fenster aufgelöst wird; hinter einem [LLM-Gateway](/docs/de/llm-gateway) wählt es das 1M-Fenster für Sonnet 5 aus |

43| **`opus[1m]`** | Verwendet Opus mit einem [1-Million-Token-Kontextfenster](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) für lange Sitzungen |43| **`opus[1m]`** | Verwendet Opus mit einem [1-Million-Token-Kontextfenster](https://platform.claude.com/docs/de/build-with-claude/context-windows#context-window-sizes-by-model) für lange Sitzungen |

44| **`opusplan`** | Spezieller Modus, der `opus` während des Plan Mode verwendet und dann zu `sonnet` für die Ausführung wechselt |44| **`opusplan`** | Spezieller Modus, der `opus` während des Plan Mode verwendet und dann zu `sonnet` für die Ausführung wechselt |

45 45

49| :--------------------------------------------------- | :------- | :--------- |49| :--------------------------------------------------- | :------- | :--------- |

54 54

55Wenn ein Alias zu einem älteren Modell aufgelöst wird, sind neuere Modelle verfügbar, indem Sie den vollständigen Modellnamen explizit auswählen oder `ANTHROPIC_DEFAULT_OPUS_MODEL` oder `ANTHROPIC_DEFAULT_SONNET_MODEL` setzen.55Wenn ein Alias zu einem älteren Modell aufgelöst wird, sind neuere Modelle verfügbar, indem Sie den vollständigen Modellnamen explizit auswählen oder `ANTHROPIC_DEFAULT_OPUS_MODEL` oder `ANTHROPIC_DEFAULT_SONNET_MODEL` setzen.

56 56

~~57{/* min-version: 2.1.207 */}Vor v2.1.207 wurde `opus` zu Opus 4.7 auf Claude Platform on AWS und zu Opus 4.6 auf Amazon Bedrock und Google Cloud's Agent Platform aufgelöst.~~57Vor v2.1.207 wurde `opus` zu Opus 4.7 auf Claude Platform on AWS und zu Opus 4.6 auf Amazon Bedrock und Google Cloud's Agent Platform aufgelöst.

58 58

59Aliase verweisen auf die empfohlene Version für Ihren Anbieter und werden im Laufe der Zeit aktualisiert. Um eine bestimmte Version zu fixieren, verwenden Sie den vollständigen Modellnamen, z. B. `claude-opus-4-8`, oder setzen Sie die entsprechende Umgebungsvariable wie `ANTHROPIC_DEFAULT_OPUS_MODEL`.59Aliase verweisen auf die empfohlene Version für Ihren Anbieter und werden im Laufe der Zeit aktualisiert. Um eine bestimmte Version zu fixieren, verwenden Sie den vollständigen Modellnamen, z. B. `claude-opus-4-8`, oder setzen Sie die entsprechende Umgebungsvariable wie `ANTHROPIC_DEFAULT_OPUS_MODEL`.

60 60

72 72

73Um das Beste aus Fable 5 herauszuholen:73Um das Beste aus Fable 5 herauszuholen:

74 74

75* **Beschreiben Sie das Ergebnis, nicht die Schritte**: Geben Sie ihm das Ergebnis, das Sie möchten, und lassen Sie es den Weg planen. Um es arbeiten zu lassen, bis dieses Ergebnis eintritt, [setzen Sie ein Ziel](/de/goal).75* **Beschreiben Sie das Ergebnis, nicht die Schritte**: Geben Sie ihm das Ergebnis, das Sie möchten, und lassen Sie es den Weg planen. Um es arbeiten zu lassen, bis dieses Ergebnis eintritt, [setzen Sie ein Ziel](/docs/de/goal).

76* **Geben Sie ihm mehrdeutige Probleme**: Root-Cause-Untersuchungen, Ausfalldebugging und Architekturentscheidungen sind Bereiche, in denen die zusätzliche Untersuchung und Überprüfung sich auszahlt.76* **Geben Sie ihm mehrdeutige Probleme**: Root-Cause-Untersuchungen, Ausfalldebugging und Architekturentscheidungen sind Bereiche, in denen die zusätzliche Untersuchung und Überprüfung sich auszahlt.

77* **Überspringen Sie die Überprüfungserinnerungen**: Es überprüft seine eigene Arbeit mit weniger Aufforderungen, daher sind Erinnerungen zum Testen oder Überprüfen normalerweise unnötig.77* **Überspringen Sie die Überprüfungserinnerungen**: Es überprüft seine eigene Arbeit mit weniger Aufforderungen, daher sind Erinnerungen zum Testen oder Überprüfen normalerweise unnötig.

78* **Größere Aufgaben einschätzen**: Geben Sie ihm Arbeit, die Sie normalerweise in Teile aufteilen würden. Es hält lange Sitzungen, ohne den Faden zu verlieren.78* **Größere Aufgaben einschätzen**: Geben Sie ihm Arbeit, die Sie normalerweise in Teile aufteilen würden. Es hält lange Sitzungen, ohne den Faden zu verlieren.

79 79

80<Note>80<Note>

81 Fable 5 erfordert Claude Code v2.1.170 oder später. Ältere Versionen zeigen Fable 5 nicht in der Modellauswahl an und können es nicht auswählen. Führen Sie `claude update` aus, um zu aktualisieren. Fable 5 ist nicht unter [Zero Data Retention](/de/zero-data-retention) verfügbar, wo die `/model`-Auswahl es entweder auslässt oder deaktiviert anzeigt.81 Fable 5 erfordert Claude Code v2.1.170 oder später. Ältere Versionen zeigen Fable 5 nicht in der Modellauswahl an und können es nicht auswählen. Führen Sie `claude update` aus, um zu aktualisieren. Fable 5 ist nicht unter [Zero Data Retention](/docs/de/zero-data-retention) verfügbar, wo die `/model`-Auswahl es entweder auslässt oder deaktiviert anzeigt.

82</Note>82</Note>

83 83

84<h3 id="setting-your-model">84<h3 id="setting-your-model">

97* `Enter`: Modell wechseln und als Standard speichern97* `Enter`: Modell wechseln und als Standard speichern

98* `s`: Modell nur für diese Sitzung wechseln98* `s`: Modell nur für diese Sitzung wechseln

99 99

100Die direkte Eingabe von `/model <name>` verhält sich wie `Enter`. {/* min-version: 2.1.205 */}Ein Modell, das mit `/model` im [nicht-interaktiven Modus](/de/headless) mit dem `-p`-Flag gesetzt wird, gilt nur für die aktuelle Sitzung und wird nicht als Standard gespeichert. Projekt- und verwaltete Einstellungen haben weiterhin Vorrang und werden beim nächsten Start erneut angewendet. {/* min-version: 2.1.196 */}Ein [Organisationsstandardmodell](#organization-default-model), das Ihr Administrator konfiguriert hat, um die Benutzerauswahl zu überschreiben, wird auch beim nächsten Start erneut angewendet.100Die direkte Eingabe von `/model <name>` verhält sich wie `Enter`. Ein Modell, das mit `/model` im [nicht-interaktiven Modus](/docs/de/headless) mit dem `-p`-Flag gesetzt wird, gilt nur für die aktuelle Sitzung und wird nicht als Standard gespeichert. Projekt- und verwaltete Einstellungen haben weiterhin Vorrang und werden beim nächsten Start erneut angewendet. Ein [Organisationsstandardmodell](#organization-default-model), das Ihr Administrator konfiguriert hat, um die Benutzerauswahl zu überschreiben, wird auch beim nächsten Start erneut angewendet.

101 101

102In v2.1.144 bis v2.1.152 galt `/model` nur für die aktuelle Sitzung und `d` in der Auswahl speicherte einen Standard.102In v2.1.144 bis v2.1.152 galt `/model` nur für die aktuelle Sitzung und `d` in der Auswahl speicherte einen Standard.

103 103

104Das `--model`-Flag und die `ANTHROPIC_MODEL`-Umgebungsvariable gelten nur für die Sitzung, mit der Sie sie starten. Um verschiedene Modelle in verschiedenen Terminals gleichzeitig auszuführen, starten Sie jedes mit seinem eigenen `--model`-Flag, anstatt mit `/model` zu wechseln.104Das `--model`-Flag und die `ANTHROPIC_MODEL`-Umgebungsvariable gelten nur für die Sitzung, mit der Sie sie starten. Um verschiedene Modelle in verschiedenen Terminals gleichzeitig auszuführen, starten Sie jedes mit seinem eigenen `--model`-Flag, anstatt mit `/model` zu wechseln.

105 105

106Preise in der `/model`-Auswahl werden angezeigt, wenn Claude Code mit der Anthropic API spricht, direkt oder über ein [LLM-Gateway](/de/llm-gateway), das es vermittelt, und der Preis in einer Zeile ist der Preis des Modells, das diese Zeile auswählt. Bei [Drittanbieter-Anbietern](/de/third-party-integrations) wie Amazon Bedrock und beim [Claude-Apps-Gateway](/de/claude-apps-gateway) bestimmt Ihr Anbieter oder Gateway, was Sie zahlen, daher zeigen Auswahlzeilen keinen Preis. Der Preis ist nur ein Anzeigelabel; er beeinflusst nicht, welches Modell eine Zeile auswählt oder was Ihr Anbieter abrechnet. Vor v2.1.206 zeigten [Claude Platform on AWS](/de/claude-platform-on-aws) und Gateway-Sitzungen Anthropic-Listenpreise an, und eine Zeile konnte den Preis eines anderen Modells anzeigen als das, das sie auswählte.106Preise in der `/model`-Auswahl werden angezeigt, wenn Claude Code mit der Anthropic API spricht, direkt oder über ein [LLM-Gateway](/docs/de/llm-gateway), das es vermittelt, und der Preis in einer Zeile ist der Preis des Modells, das diese Zeile auswählt. Bei [Drittanbieter-Anbietern](/docs/de/third-party-integrations) wie Amazon Bedrock und beim [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) bestimmt Ihr Anbieter oder Gateway, was Sie zahlen, daher zeigen Auswahlzeilen keinen Preis. Der Preis ist nur ein Anzeigelabel; er beeinflusst nicht, welches Modell eine Zeile auswählt oder was Ihr Anbieter abrechnet. Vor v2.1.206 zeigten [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und Gateway-Sitzungen Anthropic-Listenpreise an, und eine Zeile konnte den Preis eines anderen Modells anzeigen als das, das sie auswählte.

107 107

108Fortgesetzte Sitzungen, die mit `claude --resume`, `--continue` oder der `/resume`-Auswahl gestartet werden, behalten das Modell bei, das sie verwendeten, als das Transkript gespeichert wurde, unabhängig von der aktuellen `model`-Einstellung. Wenn das angeforderte Modell eingestellt wurde oder durch [`availableModels`](#restrict-model-selection) ausgeschlossen ist, fällt die Sitzung auf die normale Prioritätsreihenfolge zurück. Dies verhindert, dass die `/model`-Auswahl einer anderen Sitzung das Modell beim Fortsetzen ändert.108Fortgesetzte Sitzungen, die mit `claude --resume`, `--continue` oder der `/resume`-Auswahl gestartet werden, behalten das Modell bei, das sie verwendeten, als das Transkript gespeichert wurde, unabhängig von der aktuellen `model`-Einstellung. Wenn das angeforderte Modell eingestellt wurde oder durch [`availableModels`](#restrict-model-selection) ausgeschlossen ist, fällt die Sitzung auf die normale Prioritätsreihenfolge zurück. Dies verhindert, dass die `/model`-Auswahl einer anderen Sitzung das Modell beim Fortsetzen ändert.

109 109

110Ein Modell, das Sie für den neuen Start mit `--model` oder `ANTHROPIC_MODEL` auswählen, hat weiterhin Vorrang vor dem wiederhergestellten Modell. {/* min-version: 2.1.195 */}Ab v2.1.195 gilt dies auch für eine [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables)-Familienvariable.110Ein Modell, das Sie für den neuen Start mit `--model` oder `ANTHROPIC_MODEL` auswählen, hat weiterhin Vorrang vor dem wiederhergestellten Modell. Ab v2.1.195 gilt dies auch für eine [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables)-Familienvariable.

111 111

112Wenn das aktive Modell beim Start aus Projekt- oder verwalteten Einstellungen stammt und nicht aus Ihrer eigenen Auswahl, zeigt der Startheader an, welche Einstellungsdatei es festgelegt hat. Führen Sie `/model` aus, um es zu überschreiben; die Projekt- oder verwaltete Einstellung wird beim nächsten Start erneut angewendet.112Wenn das aktive Modell beim Start aus Projekt- oder verwalteten Einstellungen stammt und nicht aus Ihrer eigenen Auswahl, zeigt der Startheader an, welche Einstellungsdatei es festgelegt hat. Führen Sie `/model` aus, um es zu überschreiben; die Projekt- oder verwaltete Einstellung wird beim nächsten Start erneut angewendet.

113 113

114Wenn ein Modellwechsel durch die [Agent SDK](/de/agent-sdk/overview) `setModel()`-Methode oder durch eine App wie die [Desktop-App](/de/desktop), die die Claude Code CLI für Sie ausführt, angefordert wird, überprüft Claude Code, dass die Zeichenkette eine ist, die es erkennt, bevor es sie speichert. Diese Überprüfung erfordert Claude Code v2.1.200 oder später. Bei der Anthropic API erkennt Claude Code:114Wenn ein Modellwechsel durch die [Agent SDK](/docs/de/agent-sdk/overview) `setModel()`-Methode oder durch eine App wie die [Desktop-App](/docs/de/desktop), die die Claude Code CLI für Sie ausführt, angefordert wird, überprüft Claude Code, dass die Zeichenkette eine ist, die es erkennt, bevor es sie speichert. Diese Überprüfung erfordert Claude Code v2.1.200 oder später. Bei der Anthropic API erkennt Claude Code:

115 115

116* einen Modellalias116* einen Modellalias

117* einen Eintrag aus der `/model`-Auswahl117* einen Eintrag aus der `/model`-Auswahl

118* jeden Namen, der mit `claude-` beginnt118* jeden Namen, der mit `claude-` beginnt

119* einen Wert, den Sie selbst als [benutzerdefinierte Modelloption](#add-a-custom-model-option) oder in [`modelOverrides`](#override-model-ids-per-version) konfiguriert haben119* einen Wert, den Sie selbst als [benutzerdefinierte Modelloption](#add-a-custom-model-option) oder in [`modelOverrides`](#override-model-ids-per-version) konfiguriert haben

120 120

121Claude Code lehnt eine unbekannte Zeichenkette mit `Model "<name>" is not a recognized model id.` ab und die Sitzung behält ihr aktuelles Modell bei, anstatt die Zeichenkette zu speichern und beim nächsten Request zu fehlschlagen. Siehe [die Fehlerreferenz](/de/errors#model-is-not-a-recognized-model-id) für Wiederherstellungsschritte.121Claude Code lehnt eine unbekannte Zeichenkette mit `Model "<name>" is not a recognized model id.` ab und die Sitzung behält ihr aktuelles Modell bei, anstatt die Zeichenkette zu speichern und beim nächsten Request zu fehlschlagen. Siehe [die Fehlerreferenz](/docs/de/errors#model-is-not-a-recognized-model-id) für Wiederherstellungsschritte.

122 122

123Die Überprüfung wird nur bei der Anthropic API durchgeführt. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/de/claude-platform-on-aws) und hinter einem [LLM-Gateway](/de/llm-gateway) oder einem benutzerdefinierten `ANTHROPIC_BASE_URL` definiert Ihr Anbieter oder Gateway die Modellnamen, daher leitet Claude Code jede Zeichenkette ohne Überprüfung durch. Die Überprüfung deckt auch nicht das `--model`-Flag, die `ANTHROPIC_MODEL`-Umgebungsvariable oder die `model`-Einstellung ab; ein Tippfehler dort erzeugt [There's an issue with the selected model](/de/errors#theres-an-issue-with-the-selected-model) beim ersten Request statt.123Die Überprüfung wird nur bei der Anthropic API durchgeführt. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und hinter einem [LLM-Gateway](/docs/de/llm-gateway) oder einem benutzerdefinierten `ANTHROPIC_BASE_URL` definiert Ihr Anbieter oder Gateway die Modellnamen, daher leitet Claude Code jede Zeichenkette ohne Überprüfung durch. Die Überprüfung deckt auch nicht das `--model`-Flag, die `ANTHROPIC_MODEL`-Umgebungsvariable oder die `model`-Einstellung ab; ein Tippfehler dort erzeugt [There's an issue with the selected model](/docs/de/errors#theres-an-issue-with-the-selected-model) beim ersten Request statt.

124 124

125Wenn das angeforderte Modell ein geplantes Ruhestandsdatum hat oder automatisch auf eine neuere Version neu zugeordnet wird, zeigt Claude Code eine Warnung an, die das angeforderte Modell benennt. Interaktive Sitzungen zeigen es als Startnachricht an. Ab v2.1.182 wird die gleiche Warnung in [nicht-interaktivem Modus](/de/headless) auf stderr geschrieben, wenn das Standard-Textausgabeformat verwendet wird. Die Überprüfung deckt auch ein `model` ab, das in [Subagent-Frontmatter](/de/sub-agents) festgelegt ist. Die stderr-Warnung wird für `--output-format json` und `stream-json` unterdrückt; lesen Sie das tatsächliche Modell stattdessen aus dem `modelUsage`-Feld der [Ergebnisnachricht](/de/headless#get-structured-output).125Wenn das angeforderte Modell ein geplantes Ruhestandsdatum hat oder automatisch auf eine neuere Version neu zugeordnet wird, zeigt Claude Code eine Warnung an, die das angeforderte Modell benennt. Interaktive Sitzungen zeigen es als Startnachricht an. Ab v2.1.182 wird die gleiche Warnung in [nicht-interaktivem Modus](/docs/de/headless) auf stderr geschrieben, wenn das Standard-Textausgabeformat verwendet wird. Die Überprüfung deckt auch ein `model` ab, das in [Subagent-Frontmatter](/docs/de/sub-agents) festgelegt ist. Die stderr-Warnung wird für `--output-format json` und `stream-json` unterdrückt; lesen Sie das tatsächliche Modell stattdessen aus dem `modelUsage`-Feld der [Ergebnisnachricht](/docs/de/headless#get-structured-output).

126 126

127Beispielverwendung:127Beispielverwendung:

128 128

149 Modellauswahl einschränken149 Modellauswahl einschränken

150</h2>150</h2>

151 151

152Enterprise-Administratoren können `availableModels` in [verwalteten oder Richtlinieneinstellungen](/de/settings#settings-files) verwenden, um einzuschränken, welche Modelle Benutzer auswählen können. Einträge entsprechen einer Modellfamilie wie `sonnet`, einem Versionspräfix wie `claude-sonnet-4-5` oder einer vollständigen Modell-ID wie `claude-sonnet-4-5-20250929`.152Enterprise-Administratoren können `availableModels` in [verwalteten oder Richtlinieneinstellungen](/docs/de/settings#settings-files) verwenden, um einzuschränken, welche Modelle Benutzer auswählen können. Einträge entsprechen einer Modellfamilie wie `sonnet`, einem Versionspräfix wie `claude-sonnet-4-5` oder einer vollständigen Modell-ID wie `claude-sonnet-4-5-20250929`.

153 153

154Wenn `availableModels` gesetzt ist, gilt die Zulassungsliste überall dort, wo ein Benutzer ein Modell angeben kann:154Wenn `availableModels` gesetzt ist, gilt die Zulassungsliste überall dort, wo ein Benutzer ein Modell angeben kann:

155 155

156* **Hauptsitzungsmodell**: `/model`, das `--model`-Flag, die `ANTHROPIC_MODEL`-Umgebungsvariable, die `model`-Einstellung und das Modell, das beim [Fortsetzen einer Sitzung](#setting-your-model) wiederhergestellt wird156* **Hauptsitzungsmodell**: `/model`, das `--model`-Flag, die `ANTHROPIC_MODEL`-Umgebungsvariable, die `model`-Einstellung und das Modell, das beim [Fortsetzen einer Sitzung](#setting-your-model) wiederhergestellt wird

157* **Alias-Auflösung**: {/* min-version: 2.1.176 */}die Umgebungsvariablen `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` und `ANTHROPIC_DEFAULT_FABLE_MODEL` können einen zulässigen Alias nicht zu einem Modell außerhalb der Liste umleiten157* **Alias-Auflösung**: die Umgebungsvariablen `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` und `ANTHROPIC_DEFAULT_FABLE_MODEL` können einen zulässigen Alias nicht zu einem Modell außerhalb der Liste umleiten

158* **Schnellmodus**: {/* min-version: 2.1.176 */}`/fast` weigert sich umzuschalten, wenn dies implizit zu einem Opus-Modell außerhalb der Liste führen würde, mit der Meldung „is not in your organization's allowed models"158* **Schnellmodus**: `/fast` weigert sich umzuschalten, wenn dies implizit zu einem Opus-Modell außerhalb der Liste führen würde, mit der Meldung „is not in your organization's allowed models"

159* **Subagent-Modelle**: das `model`-Feld in [Subagent](/de/sub-agents#choose-a-model)-Frontmatter, der `model`-Parameter des Agent-Tools, `CLAUDE_CODE_SUBAGENT_MODEL` und, auf v2.1.197 und früher, die Modellauswahl im `/agents`-Assistent {/* max-version: 2.1.197 */}159* **Subagent-Modelle**: das `model`-Feld in [Subagent](/docs/de/sub-agents#choose-a-model)-Frontmatter, der `model`-Parameter des Agent-Tools, `CLAUDE_CODE_SUBAGENT_MODEL` und, auf v2.1.197 und früher, die Modellauswahl im `/agents`-Assistent 

160* **Skill- und Befehlsmodelle**: das `model`-Frontmatter in [Skills und Befehlen](/de/skills)160* **Skill- und Befehlsmodelle**: das `model`-Frontmatter in [Skills und Befehlen](/docs/de/skills)

161* **Advisor-Modell**: die konfigurierte [`advisorModel`](/de/advisor)-Einstellung und das `--advisor`-Flag161* **Advisor-Modell**: die konfigurierte [`advisorModel`](/docs/de/advisor)-Einstellung und das `--advisor`-Flag

162* **Hintergrund-Agent-Modell**: das Modell, das in der [Dispatch-Auswahl](/de/agent-view) ausgewählt ist162* **Hintergrund-Agent-Modell**: das Modell, das in der [Dispatch-Auswahl](/docs/de/agent-view) ausgewählt ist

163 163

164Auf der Anthropic API und [Claude Platform auf AWS](/de/claude-platform-on-aws) wird ein Modellfamilien-Alias, `opus`, `sonnet`, `haiku` oder `fable`, zur neuesten Version seiner Familie aufgelöst, die die Zulassungsliste zulässt. Wenn die Zulassungsliste bestimmte Versionen fixiert, beispielsweise `["sonnet", "claude-opus-4-6"]`, wählen sowohl `/model opus` als auch `--model opus` Claude Opus 4.6, die neueste zulässige Opus-Version, und zeigen eine Mitteilung an, die sowohl das angeforderte als auch das ersetzte Modell benennt. Vor v2.1.205 wurde ein Alias, dessen neueste veröffentlichte Version außerhalb der Liste lag, wie jede andere blockierte Auswahl abgelehnt oder ersetzt, auch wenn die Liste eine ältere Version zulässig machte.164Auf der Anthropic API und [Claude Platform auf AWS](/docs/de/claude-platform-on-aws) wird ein Modellfamilien-Alias, `opus`, `sonnet`, `haiku` oder `fable`, zur neuesten Version seiner Familie aufgelöst, die die Zulassungsliste zulässt. Wenn die Zulassungsliste bestimmte Versionen fixiert, beispielsweise `["sonnet", "claude-opus-4-6"]`, wählen sowohl `/model opus` als auch `--model opus` Claude Opus 4.6, die neueste zulässige Opus-Version, und zeigen eine Mitteilung an, die sowohl das angeforderte als auch das ersetzte Modell benennt. Vor v2.1.205 wurde ein Alias, dessen neueste veröffentlichte Version außerhalb der Liste lag, wie jede andere blockierte Auswahl abgelehnt oder ersetzt, auch wenn die Liste eine ältere Version zulässig machte.

165 165

166Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und [Mantle](/de/amazon-bedrock#use-the-mantle-endpoint) verwenden anbieterspezifische Bereitstellungs-IDs anstelle von Anthropic-Modell-IDs, daher folgt ein blockierter Alias dort dem Ablehnungs- und Ersetzungsverhalten unten.166Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und [Mantle](/docs/de/amazon-bedrock#use-the-mantle-endpoint) verwenden anbieterspezifische Bereitstellungs-IDs anstelle von Anthropic-Modell-IDs, daher folgt ein blockierter Alias dort dem Ablehnungs- und Ersetzungsverhalten unten.

167 167

168Claude Code behandelt jede andere blockierte Auswahl je nachdem, wo das Modell gesetzt wurde:168Claude Code behandelt jede andere blockierte Auswahl je nachdem, wo das Modell gesetzt wurde:

169 169

173* **`advisorModel`-Einstellung**: der Advisor wird für die Sitzung deaktiviert173* **`advisorModel`-Einstellung**: der Advisor wird für die Sitzung deaktiviert

174* **`--advisor`-Flag**: Claude Code beendet sich beim Start mit einem Fehler174* **`--advisor`-Flag**: Claude Code beendet sich beim Start mit einem Fehler

175 175

176Ausgeschlossene Modelle sind in der `/model`-Auswahl verborgen. {/* min-version: 2.1.199 */}Eine vollständige Modell-ID in der Liste, die keine integrierte Picker-Zeile hat, wie eine ältere Version, die die Liste fixiert, erscheint in der `/model`-Auswahl als eigene beschriftete Zeile. Vor v2.1.199 war eine solche ID nur durch Eingabe von `/model <id>` auswählbar.176Ausgeschlossene Modelle sind in der `/model`-Auswahl verborgen. Eine vollständige Modell-ID in der Liste, die keine integrierte Picker-Zeile hat, wie eine ältere Version, die die Liste fixiert, erscheint in der `/model`-Auswahl als eigene beschriftete Zeile. Vor v2.1.199 war eine solche ID nur durch Eingabe von `/model <id>` auswählbar.

177 177

178Modellwechsel, die Claude Code in Ihrem Namen vornimmt, werden auf die gleiche Weise überprüft:178Modellwechsel, die Claude Code in Ihrem Namen vornimmt, werden auf die gleiche Weise überprüft:

179 179

180* **[Fallback-Modellketten](#fallback-model-chains)**: Elemente außerhalb der Zulassungsliste werden gelöscht180* **[Fallback-Modellketten](#fallback-model-chains)**: Elemente außerhalb der Zulassungsliste werden gelöscht

181* **Plan-Modus-Upgrades**: auf der Anthropic API und Claude Platform auf AWS verwendet ein Upgrade wie [`opusplan`](#opusplan-model-setting) zu einem ausgeschlossenen Modell die neueste zulässige Version der Upgrade-Familie. Bei Anbietern mit anbieterspezifischen Modell-IDs und wenn keine Version zulässig ist, wird das Upgrade übersprungen und die Planung wird auf dem Sitzungsmodell fortgesetzt181* **Plan-Modus-Upgrades**: auf der Anthropic API und Claude Platform auf AWS verwendet ein Upgrade wie [`opusplan`](#opusplan-model-setting) zu einem ausgeschlossenen Modell die neueste zulässige Version der Upgrade-Familie. Bei Anbietern mit anbieterspezifischen Modell-IDs und wenn keine Version zulässig ist, wird das Upgrade übersprungen und die Planung wird auf dem Sitzungsmodell fortgesetzt

182* **[Automatisches Modell-Fallback](#automatic-model-fallback)**: ein Fallback, dessen Ziel ausgeschlossen ist, wird nicht ausgeführt, daher endet die gekennzeichnete Anfrage mit einer Ablehnung statt182* **[Automatisches Modell-Fallback](#automatic-model-fallback)**: ein Fallback, dessen Ziel ausgeschlossen ist, wird nicht ausgeführt, daher endet die gekennzeichnete Anfrage mit einer Ablehnung statt

183* **[Schnellmodus](/de/fast-mode)**: das Aktivieren des Schnellmodus wird abgelehnt, wenn das Modell, auf dem die Sitzung danach ausgeführt würde, außerhalb der Zulassungsliste liegt183* **[Schnellmodus](/docs/de/fast-mode)**: das Aktivieren des Schnellmodus wird abgelehnt, wenn das Modell, auf dem die Sitzung danach ausgeführt würde, außerhalb der Zulassungsliste liegt

184 184

185```json theme={null}185```json theme={null}

186{186{

196 196

198| :---------------------------------------------------------------------------------- | :---------- | :--------------------- | :------------------------------- | :----------------------------- | :--------------------------- |198| :---------------------------------------------------------------------------------- | :---------- | :--------------------- | :------------------------------- | :----------------------------- | :--------------------------- |

201 201

202* Cloud-Sitzungen auf [Claude Code im Web](/de/claude-code-on-the-web) oder in der Desktop-App werden auf von Anthropic verwalteten VMs ausgeführt: Einstellungen, die auf Ihrem Gerät bereitgestellt werden, erreichen sie nicht, daher stellen Sie die Zulassungsliste über serververwaltete Einstellungen bereit. Ein Modellwechsel während einer Sitzung in einer Cloud-Sitzung wird abgelehnt, wenn das angeforderte Modell durch die Zulassungsliste ausgeschlossen ist. Die serverseitige Ablehnung bei der Sitzungserstellung gilt für [Organisationsmodellbeschränkungen](#organization-model-restrictions), nicht für den `availableModels`-Einstellungsschlüssel.202* Cloud-Sitzungen auf [Claude Code im Web](/docs/de/claude-code-on-the-web) oder in der Desktop-App werden auf von Anthropic verwalteten VMs ausgeführt: Einstellungen, die auf Ihrem Gerät bereitgestellt werden, erreichen sie nicht, daher stellen Sie die Zulassungsliste über serververwaltete Einstellungen bereit. Ein Modellwechsel während einer Sitzung in einer Cloud-Sitzung wird abgelehnt, wenn das angeforderte Modell durch die Zulassungsliste ausgeschlossen ist. Die serverseitige Ablehnung bei der Sitzungserstellung gilt für [Organisationsmodellbeschränkungen](#organization-model-restrictions), nicht für den `availableModels`-Einstellungsschlüssel.

203* Cowork, die agentengesteuerte Arbeitsregisterkarte in der Claude Desktop-App, ist keine Claude Code-Oberfläche und erhält serververwaltete Einstellungen nicht absichtlich. Eine verwaltete Einstellungsdatei gilt für Cowork-Sitzungen, wenn sie dort vorhanden ist, wo die Sitzung ausgeführt wird; Remote-Cowork-Sitzungen werden auf von Anthropic verwalteten VMs ausgeführt, wo eine gerätebereits bereitgestellte Datei nicht vorhanden ist.203* Cowork, die agentengesteuerte Arbeitsregisterkarte in der Claude Desktop-App, ist keine Claude Code-Oberfläche und erhält serververwaltete Einstellungen nicht absichtlich. Eine verwaltete Einstellungsdatei gilt für Cowork-Sitzungen, wenn sie dort vorhanden ist, wo die Sitzung ausgeführt wird; Remote-Cowork-Sitzungen werden auf von Anthropic verwalteten VMs ausgeführt, wo eine gerätebereits bereitgestellte Datei nicht vorhanden ist.

204* Sitzungen auf [Drittanbieter-Anbietern](/de/server-managed-settings#platform-availability) wie Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und [Claude Platform auf AWS](/de/claude-platform-on-aws) erhalten keine serververwalteten Einstellungen, daher stellen Sie die Zulassungsliste dort über MDM oder verwaltete Einstellungsdateien bereit.204* Sitzungen auf [Drittanbieter-Anbietern](/docs/de/server-managed-settings#platform-availability) wie Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und [Claude Platform auf AWS](/docs/de/claude-platform-on-aws) erhalten keine serververwalteten Einstellungen, daher stellen Sie die Zulassungsliste dort über MDM oder verwaltete Einstellungsdateien bereit.

205* Die serververwaltete Bereitstellung erfordert auch, dass sich die Sitzung mit einem Organisationslogin oder einem direkt konfigurierten API-Schlüssel authentifiziert. Flotten, die Schlüssel nur über ein [`apiKeyHelper`](/de/settings#available-settings)-Skript generieren, sollten die Zulassungsliste über MDM oder verwaltete Einstellungsdateien bereitstellen.205* Die serververwaltete Bereitstellung erfordert auch, dass sich die Sitzung mit einem Organisationslogin oder einem direkt konfigurierten API-Schlüssel authentifiziert. Flotten, die Schlüssel nur über ein [`apiKeyHelper`](/docs/de/settings#available-settings)-Skript generieren, sollten die Zulassungsliste über MDM oder verwaltete Einstellungsdateien bereitstellen.

206* Die Desktop Code-Registerkarte hostet auch [SSH-Sitzungen](/de/desktop#ssh-sessions), die die verwaltete Einstellungsdatei vom Remote-Host lesen, auf dem sie ausgeführt werden. Siehe [Desktop-verwaltete Einstellungen](/de/desktop#managed-settings).206* Die Desktop Code-Registerkarte hostet auch [SSH-Sitzungen](/docs/de/desktop#ssh-sessions), die die verwaltete Einstellungsdatei vom Remote-Host lesen, auf dem sie ausgeführt werden. Siehe [Desktop-verwaltete Einstellungen](/docs/de/desktop#managed-settings).

207* Die Modellauswahl auf claude.ai und in der Desktop-App verbergen oder graut Modelle aus, die durch die Zulassungsliste Ihrer Organisation ausgeschlossen sind. Der Auswahlzustand ist eine Annehmlichkeit für Benutzer; die Erzwingung erfolgt in der Sitzung.207* Die Modellauswahl auf claude.ai und in der Desktop-App verbergen oder graut Modelle aus, die durch die Zulassungsliste Ihrer Organisation ausgeschlossen sind. Der Auswahlzustand ist eine Annehmlichkeit für Benutzer; die Erzwingung erfolgt in der Sitzung.

208 208

209<h3 id="default-model-behavior">209<h3 id="default-model-behavior">

231 231

232`enforceAvailableModels` hat keine Auswirkung, wenn `availableModels` nicht gesetzt oder leer ist: Mit `availableModels: []` bleibt das Standardmodell für den Kontotyp nutzbar, sodass die Einstellung Benutzer nicht aus jedem Modell sperren kann. Wenn `availableModels` nicht leer ist, aber kein Eintrag zu einem zulässigen und verfügbaren Modell aufgelöst wird, wird die Erzwingung herabgestuft und „Standard" fällt auf den Kontotyp-Standard zurück, mit einer Warnung, die nur unter `--debug` sichtbar ist. Behalten Sie mindestens einen garantiert verfügbaren Eintrag in der Liste, um dies zu vermeiden.232`enforceAvailableModels` hat keine Auswirkung, wenn `availableModels` nicht gesetzt oder leer ist: Mit `availableModels: []` bleibt das Standardmodell für den Kontotyp nutzbar, sodass die Einstellung Benutzer nicht aus jedem Modell sperren kann. Wenn `availableModels` nicht leer ist, aber kein Eintrag zu einem zulässigen und verfügbaren Modell aufgelöst wird, wird die Erzwingung herabgestuft und „Standard" fällt auf den Kontotyp-Standard zurück, mit einer Warnung, die nur unter `--debug` sichtbar ist. Behalten Sie mindestens einen garantiert verfügbaren Eintrag in der Liste, um dies zu vermeiden.

233 233

234Stellen Sie beide Schlüssel in der [höchsten Prioritäts-verwalteten Quelle](/de/settings#settings-precedence) bereit: Von Administratoren bereitgestellte verwaltete Quellen werden nicht zusammengeführt, daher wird ein Paar, das in einer verwalteten Einstellungsdatei platziert ist, ignoriert, wenn die Admin-Konsole Einstellungen bereitstellt.234Stellen Sie beide Schlüssel in der [höchsten Prioritäts-verwalteten Quelle](/docs/de/settings#settings-precedence) bereit: Von Administratoren bereitgestellte verwaltete Quellen werden nicht zusammengeführt, daher wird ein Paar, das in einer verwalteten Einstellungsdatei platziert ist, ignoriert, wenn die Admin-Konsole Einstellungen bereitstellt.

235 235

236<h3 id="control-the-model-users-run-on">236<h3 id="control-the-model-users-run-on">

237 Kontrollieren Sie das Modell, auf dem Benutzer ausgeführt werden237 Kontrollieren Sie das Modell, auf dem Benutzer ausgeführt werden

265 Merge-Verhalten265 Merge-Verhalten

266</h3>266</h3>

267 267

268Wenn die [höchste Prioritäts-verwaltete Einstellungsquelle](/de/server-managed-settings#settings-precedence) `availableModels` definiert, gilt diese Liste allein: Einträge in Benutzer-, Projekt- oder lokalen Einstellungen können sie nicht erweitern, und von Administratoren bereitgestellte verwaltete Quellen werden nicht miteinander zusammengeführt, daher wird eine Liste, die in einer verwalteten Einstellungsdatei bereitgestellt wird, ignoriert, wenn serververwaltete Einstellungen Schlüssel bereitstellen. Andernfalls werden Listen aus Benutzer-, Projekt- und lokalen Einstellungen wie andere Array-Einstellungen [verkettet und dedupliziert](/de/settings#settings-precedence). {/* min-version: 2.1.175 */}Ab Claude Code v2.1.175 ersetzt die verwaltete Liste Einträge mit niedrigerer Priorität; frühere Versionen führen sie zusammen.268Wenn die [höchste Prioritäts-verwaltete Einstellungsquelle](/docs/de/server-managed-settings#settings-precedence) `availableModels` definiert, gilt diese Liste allein: Einträge in Benutzer-, Projekt- oder lokalen Einstellungen können sie nicht erweitern, und von Administratoren bereitgestellte verwaltete Quellen werden nicht miteinander zusammengeführt, daher wird eine Liste, die in einer verwalteten Einstellungsdatei bereitgestellt wird, ignoriert, wenn serververwaltete Einstellungen Schlüssel bereitstellen. Andernfalls werden Listen aus Benutzer-, Projekt- und lokalen Einstellungen wie andere Array-Einstellungen [verkettet und dedupliziert](/docs/de/settings#settings-precedence). Ab Claude Code v2.1.175 ersetzt die verwaltete Liste Einträge mit niedrigerer Priorität; frühere Versionen führen sie zusammen.

269 269

270Innerhalb der effektiven Liste deaktiviert ein Eintrag, der ein bestimmtes Modell in einer Familie benennt, ob ein Versionspräfix oder eine vollständige Modell-ID, den Wildcard-Eintrag dieser Familie: `["sonnet", "claude-sonnet-4-5"]` erlaubt nur Sonnet 4.5-Versionen, nicht jedes Sonnet-Modell.270Innerhalb der effektiven Liste deaktiviert ein Eintrag, der ein bestimmtes Modell in einer Familie benennt, ob ein Versionspräfix oder eine vollständige Modell-ID, den Wildcard-Eintrag dieser Familie: `["sonnet", "claude-sonnet-4-5"]` erlaubt nur Sonnet 4.5-Versionen, nicht jedes Sonnet-Modell.

271 271

273 Mantle-Modell-IDs273 Mantle-Modell-IDs

274</h3>274</h3>

275 275

276Wenn der [Amazon Bedrock Mantle-Endpunkt](/de/amazon-bedrock#use-the-mantle-endpoint) aktiviert ist, werden Einträge in `availableModels`, die mit `anthropic.` beginnen, als benutzerdefinierte Optionen zur `/model`-Auswahl hinzugefügt und zum Mantle-Endpunkt weitergeleitet. Dies ist eine Ausnahme zu der in [Modelle für Drittanbieter-Bereitstellungen fixieren](#pin-models-for-third-party-deployments) beschriebenen Alias-Zuordnung. Die Einstellung schränkt die Auswahl weiterhin auf aufgelistete Einträge ein, und eine Mantle-ID enthält einen Familiennamen, daher zählt sie als spezifischer Eintrag und deaktiviert den Wildcard dieser Familie: Führen Sie zusammen mit allen Mantle-IDs die Versionspräfixe oder vollständigen IDs auf, die Sie selektierbar halten möchten. Siehe [Merge-Verhalten](#merge-behavior).276Wenn der [Amazon Bedrock Mantle-Endpunkt](/docs/de/amazon-bedrock#use-the-mantle-endpoint) aktiviert ist, werden Einträge in `availableModels`, die mit `anthropic.` beginnen, als benutzerdefinierte Optionen zur `/model`-Auswahl hinzugefügt und zum Mantle-Endpunkt weitergeleitet. Dies ist eine Ausnahme zu der in [Modelle für Drittanbieter-Bereitstellungen fixieren](#pin-models-for-third-party-deployments) beschriebenen Alias-Zuordnung. Die Einstellung schränkt die Auswahl weiterhin auf aufgelistete Einträge ein, und eine Mantle-ID enthält einen Familiennamen, daher zählt sie als spezifischer Eintrag und deaktiviert den Wildcard dieser Familie: Führen Sie zusammen mit allen Mantle-IDs die Versionspräfixe oder vollständigen IDs auf, die Sie selektierbar halten möchten. Siehe [Merge-Verhalten](#merge-behavior).

277 277

278<h3 id="organization-model-restrictions">278<h3 id="organization-model-restrictions">

279 Organisationsmodellbeschränkungen279 Organisationsmodellbeschränkungen

283 283

284Die Beschränkung gilt, wenn sich ein Mitglied anmeldet oder seinen eigenen API-Schlüssel verwendet. Organisationsbezogene Anmeldedaten, wie Organisationsservice-Schlüssel, sind nicht an einen Benutzer gebunden, daher gilt die Beschränkung nicht für sie.284Die Beschränkung gilt, wenn sich ein Mitglied anmeldet oder seinen eigenen API-Schlüssel verwendet. Organisationsbezogene Anmeldedaten, wie Organisationsservice-Schlüssel, sind nicht an einen Benutzer gebunden, daher gilt die Beschränkung nicht für sie.

285 285

286Die Claude Console hat keine Modellbeschränkungskontrolle. Organisationen ohne Claude Enterprise-Plan, einschließlich derjenigen, deren Mitglieder sich über die Anthropic API authentifizieren, schränken Modelle mit [`availableModels`](#restrict-model-selection) in [verwalteten Einstellungen](/de/settings#settings-files) ein, wobei [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) hinzugefügt wird, um die Option „Standard" abzudecken. Diese Einstellungen werden von Claude Code selbst erzwungen, nicht vom Server.286Die Claude Console hat keine Modellbeschränkungskontrolle. Organisationen ohne Claude Enterprise-Plan, einschließlich derjenigen, deren Mitglieder sich über die Anthropic API authentifizieren, schränken Modelle mit [`availableModels`](#restrict-model-selection) in [verwalteten Einstellungen](/docs/de/settings#settings-files) ein, wobei [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) hinzugefügt wird, um die Option „Standard" abzudecken. Diese Einstellungen werden von Claude Code selbst erzwungen, nicht vom Server.

287 287

288Ein eingeschränktes Modell ist in der `/model`-Auswahl verborgen. Die Auswahl nach Name mit `--model`, der `ANTHROPIC_MODEL`-Umgebungsvariable oder der `model`-Einstellung zeigt die Mitteilung `Model "<name>" is restricted by your organization's settings. Using <model> instead.` und die Sitzung startet auf einem zulässigen Modell. Die Eingabe von `/model <name>` für ein eingeschränktes Modell wird mit `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` abgelehnt und die Sitzung behält ihr aktuelles Modell.288Ein eingeschränktes Modell ist in der `/model`-Auswahl verborgen. Die Auswahl nach Name mit `--model`, der `ANTHROPIC_MODEL`-Umgebungsvariable oder der `model`-Einstellung zeigt die Mitteilung `Model "<name>" is restricted by your organization's settings. Using <model> instead.` und die Sitzung startet auf einem zulässigen Modell. Die Eingabe von `/model <name>` für ein eingeschränktes Modell wird mit `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` abgelehnt und die Sitzung behält ihr aktuelles Modell.

289 289

296* Haiku-Modelle sind immer verfügbar und können nicht deaktiviert werden, daher behält jedes Mitglied mindestens ein nutzbares Modell.296* Haiku-Modelle sind immer verfügbar und können nicht deaktiviert werden, daher behält jedes Mitglied mindestens ein nutzbares Modell.

297* Eine Zugriffänderung wird innerhalb von etwa einer Minute bei neuen Anfragen wirksam; die `/model`-Auswahl spiegelt dies wider, wenn eine Sitzung das nächste Mal startet.297* Eine Zugriffänderung wird innerhalb von etwa einer Minute bei neuen Anfragen wirksam; die `/model`-Auswahl spiegelt dies wider, wenn eine Sitzung das nächste Mal startet.

298 298

299Beide Beschränkungen gelten zusammen: Ein Modell ist nur selektierbar, wenn es durch `availableModels` zulässig ist und nicht durch die Organisation eingeschränkt ist. Organisationsbeschränkungen werden an Sitzungen auf der Anthropic API und [LLM Gateway](/de/llm-gateway)-Bereitstellungen bereitgestellt. Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS erhalten sie nicht, daher verwenden Sie stattdessen `availableModels` auf diesen Anbietern.299Beide Beschränkungen gelten zusammen: Ein Modell ist nur selektierbar, wenn es durch `availableModels` zulässig ist und nicht durch die Organisation eingeschränkt ist. Organisationsbeschränkungen werden an Sitzungen auf der Anthropic API und [LLM Gateway](/docs/de/llm-gateway)-Bereitstellungen bereitgestellt. Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS erhalten sie nicht, daher verwenden Sie stattdessen `availableModels` auf diesen Anbietern.

300 300

301<h2 id="organization-default-model">301<h2 id="organization-default-model">

302 Organisationsstandardmodell302 Organisationsstandardmodell

303</h2>303</h2>

304 304

305{/* plan-availability: feature=org-default-model plans=enterprise */}

~~306~~

307Organisationsadministratoren auf Claude Enterprise-Plänen können ein Standardmodell für Claude Code-Mitglieder aus der claude.ai Admin-Konsole festlegen, für die gesamte Organisation oder pro benutzerdefinierte Rolle. Wenn eines festgelegt ist, wird die Option „Standard" zu diesem Modell aufgelöst, anstatt zum [Kontotyp-Standard](#default-model-setting). Erfordert Claude Code v2.1.196 oder später.305Organisationsadministratoren auf Claude Enterprise-Plänen können ein Standardmodell für Claude Code-Mitglieder aus der claude.ai Admin-Konsole festlegen, für die gesamte Organisation oder pro benutzerdefinierte Rolle. Wenn eines festgelegt ist, wird die Option „Standard" zu diesem Modell aufgelöst, anstatt zum [Kontotyp-Standard](#default-model-setting). Erfordert Claude Code v2.1.196 oder später.

308 306

309Die Zeile „Standard" in der `/model`-Auswahl zeigt den Namen des Organisationsstandardmodells mit der Bezeichnung „Org default". Die Bezeichnung lautet „Org default", ob der Administrator den Standard für die gesamte Organisation oder für Ihre Rolle festgelegt hat. Ein Rollen-Standard deckt Mitglieder dieser benutzerdefinierten Rolle ab und hat Vorrang vor dem organisationsweiten Standard; wenn mehrere Ihrer Rollen unterschiedliche Standards festlegen, gilt das leistungsfähigste Modell.307Die Zeile „Standard" in der `/model`-Auswahl zeigt den Namen des Organisationsstandardmodells mit der Bezeichnung „Org default". Die Bezeichnung lautet „Org default", ob der Administrator den Standard für die gesamte Organisation oder für Ihre Rolle festgelegt hat. Ein Rollen-Standard deckt Mitglieder dieser benutzerdefinierten Rolle ab und hat Vorrang vor dem organisationsweiten Standard; wenn mehrere Ihrer Rollen unterschiedliche Standards festlegen, gilt das leistungsfähigste Modell.

311Das Organisationsstandardmodell ist ein Ausgangspunkt, keine Beschränkung, und jede andere Modellauswahl hat Vorrang vor ihm:309Das Organisationsstandardmodell ist ein Ausgangspunkt, keine Beschränkung, und jede andere Modellauswahl hat Vorrang vor ihm:

312 310

313* das `--model`-Flag und die `ANTHROPIC_MODEL`-Umgebungsvariable311* das `--model`-Flag und die `ANTHROPIC_MODEL`-Umgebungsvariable

314* ein `model`-Wert in [verwalteten Einstellungen](/de/settings#settings-files) oder bereitgestellt über `--settings`312* ein `model`-Wert in [verwalteten Einstellungen](/docs/de/settings#settings-files) oder bereitgestellt über `--settings`

315* ein `model`-Wert in Ihren Benutzer-, Projekt- oder lokalen Einstellungen, einschließlich eines Modells, das Sie mit `/model` speichern313* ein `model`-Wert in Ihren Benutzer-, Projekt- oder lokalen Einstellungen, einschließlich eines Modells, das Sie mit `/model` speichern

316 314

317Administratoren können auch das Organisationsstandardmodell konfigurieren, um die Benutzerauswahl zu überschreiben. Mit Überschreibung aktiviert hat es Vorrang vor dem `model`-Wert in Benutzer-, Projekt- und lokalen Einstellungen, daher gilt ein Modell, das Sie mit `/model` speichern, für die aktuelle Sitzung und das Organisationsstandardmodell kehrt beim nächsten Start zurück. Wenn sich Ihre Auswahl unterscheidet, zeigt `/model` `Your organization's default (<model>) applies on restart`. Das `--model`-Flag, `ANTHROPIC_MODEL`, verwaltete Einstellungen und `--settings` haben weiterhin Vorrang, auch wenn die Überschreibung aktiviert ist. Die Überschreibung ist für eine begrenzte Anzahl von Organisationen verfügbar; fragen Sie Ihr Anthropic-Kontoteam nach der Verfügbarkeit.315Administratoren können auch das Organisationsstandardmodell konfigurieren, um die Benutzerauswahl zu überschreiben. Mit Überschreibung aktiviert hat es Vorrang vor dem `model`-Wert in Benutzer-, Projekt- und lokalen Einstellungen, daher gilt ein Modell, das Sie mit `/model` speichern, für die aktuelle Sitzung und das Organisationsstandardmodell kehrt beim nächsten Start zurück. Wenn sich Ihre Auswahl unterscheidet, zeigt `/model` `Your organization's default (<model>) applies on restart`. Das `--model`-Flag, `ANTHROPIC_MODEL`, verwaltete Einstellungen und `--settings` haben weiterhin Vorrang, auch wenn die Überschreibung aktiviert ist. Die Überschreibung ist für eine begrenzte Anzahl von Organisationen verfügbar; fragen Sie Ihr Anthropic-Kontoteam nach der Verfügbarkeit.

326 324

327* [`availableModels`](#restrict-model-selection) allein schränkt die Option „Standard" niemals ein, daher gilt ein Organisationsstandardmodell außerhalb der Zulassungsliste weiterhin. Wenn [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) auch gesetzt ist, wird ein Organisationsstandardmodell außerhalb der Zulassungsliste zum ersten Zulassungslisten-Eintrag neu zugeordnet, wie jedes andere Standard325* [`availableModels`](#restrict-model-selection) allein schränkt die Option „Standard" niemals ein, daher gilt ein Organisationsstandardmodell außerhalb der Zulassungsliste weiterhin. Wenn [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) auch gesetzt ist, wird ein Organisationsstandardmodell außerhalb der Zulassungsliste zum ersten Zulassungslisten-Eintrag neu zugeordnet, wie jedes andere Standard

328* ein Organisationsstandardmodell, das [Organisationsmodellbeschränkungen](#organization-model-restrictions) für Ihr Konto verweigern, wird durch das neueste zulässige Modell in seiner Familie oder eine kostengünstigere Familie ersetzt, wenn jede Version davon eingeschränkt ist326* ein Organisationsstandardmodell, das [Organisationsmodellbeschränkungen](#organization-model-restrictions) für Ihr Konto verweigern, wird durch das neueste zulässige Modell in seiner Familie oder eine kostengünstigere Familie ersetzt, wenn jede Version davon eingeschränkt ist

329* ein Organisationsstandardmodell, das Ihrem Konto überhaupt nicht verfügbar ist, wie Fable 5 unter [Zero Data Retention](/de/zero-data-retention), wird übersprungen, und die Option „Standard" wird zum Kontotyp-Standard aufgelöst327* ein Organisationsstandardmodell, das Ihrem Konto überhaupt nicht verfügbar ist, wie Fable 5 unter [Zero Data Retention](/docs/de/zero-data-retention), wird übersprungen, und die Option „Standard" wird zum Kontotyp-Standard aufgelöst

330 328

331Ab v2.1.199 behält die `/model`-Auswahl eine separate Zeile für die übliche Familie Ihres Kontotyps, wenn das Organisationsstandardmodell eine andere Modellfamilie ist, damit Sie für eine Sitzung noch zu ihr wechseln können. In v2.1.196 bis v2.1.198 fehlt diese Zeile in der Auswahl.329Ab v2.1.199 behält die `/model`-Auswahl eine separate Zeile für die übliche Familie Ihres Kontotyps, wenn das Organisationsstandardmodell eine andere Modellfamilie ist, damit Sie für eine Sitzung noch zu ihr wechseln können. In v2.1.196 bis v2.1.198 fehlt diese Zeile in der Auswahl.

332 330

333Das Organisationsstandardmodell wird an Sitzungen bereitgestellt, die sich mit der Anthropic API authentifizieren. Sitzungen auf [LLM Gateway](/de/llm-gateway)-Bereitstellungen, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS erhalten es nicht. Um einen Standard auf diesen Bereitstellungen zu setzen, verwenden Sie stattdessen den `model`-Schlüssel in [verwalteten Einstellungen](/de/settings#settings-files).331Das Organisationsstandardmodell wird an Sitzungen bereitgestellt, die sich mit der Anthropic API authentifizieren. Sitzungen auf [LLM Gateway](/docs/de/llm-gateway)-Bereitstellungen, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS erhalten es nicht. Um einen Standard auf diesen Bereitstellungen zu setzen, verwenden Sie stattdessen den `model`-Schlüssel in [verwalteten Einstellungen](/docs/de/settings#settings-files).

334 332

335<h2 id="organization-effort-limits">333<h2 id="organization-effort-limits">

336 Organisationsaufwandsgrenzen334 Organisationsaufwandsgrenzen

337</h2>335</h2>

338 336

339{/* plan-availability: feature=org-effort-limits plans=enterprise */}

~~340~~

341Organisationsadministratoren auf Claude Enterprise-Plänen können ein maximales [Aufwandsniveau](#adjust-effort-level) pro Modell für jede benutzerdefinierte Rolle neben [Organisationsmodellbeschränkungen](#organization-model-restrictions) auf Rollenebene festlegen. Ebenen über der Obergrenze werden nicht in der `/effort`-Auswahl angeboten, und die Benennung einer höheren Ebene mit `--effort` oder `/effort` wird stattdessen mit der Obergrenze ausgeführt. In interaktiven Sitzungen und einfachen Text-`--print`-Läufen wird eine Warnung angezeigt, die die angeforderten und angewendeten Ebenen benennt; bei `json`- oder `stream-json`-Ausgabe oder in Hintergrund-Agenten wird die Begrenzung stillschweigend angewendet. Obergrenzen sind pro Modell, daher kann der Wechsel von Modellen ändern, welche Ebenen verfügbar sind. Wenn mehrere Ihrer Rollen das gleiche Modell gewähren, gilt die am wenigsten restriktive Obergrenze. Erfordert Claude Code v2.1.195 oder später.337Organisationsadministratoren auf Claude Enterprise-Plänen können ein maximales [Aufwandsniveau](#adjust-effort-level) pro Modell für jede benutzerdefinierte Rolle neben [Organisationsmodellbeschränkungen](#organization-model-restrictions) auf Rollenebene festlegen. Ebenen über der Obergrenze werden nicht in der `/effort`-Auswahl angeboten, und die Benennung einer höheren Ebene mit `--effort` oder `/effort` wird stattdessen mit der Obergrenze ausgeführt. In interaktiven Sitzungen und einfachen Text-`--print`-Läufen wird eine Warnung angezeigt, die die angeforderten und angewendeten Ebenen benennt; bei `json`- oder `stream-json`-Ausgabe oder in Hintergrund-Agenten wird die Begrenzung stillschweigend angewendet. Obergrenzen sind pro Modell, daher kann der Wechsel von Modellen ändern, welche Ebenen verfügbar sind. Wenn mehrere Ihrer Rollen das gleiche Modell gewähren, gilt die am wenigsten restriktive Obergrenze. Erfordert Claude Code v2.1.195 oder später.

342 338

343Aufwandsgrenzen werden zusammen mit [Organisationsmodellbeschränkungen](#organization-model-restrictions) bereitgestellt und folgen der gleichen Anbieter-Verfügbarkeit: Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS erhalten sie nicht.339Aufwandsgrenzen werden zusammen mit [Organisationsmodellbeschränkungen](#organization-model-restrictions) bereitgestellt und folgen der gleichen Anbieter-Verfügbarkeit: Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Claude Platform auf AWS erhalten sie nicht.

359 355

360Enterprise Pay-as-you-go bedeutet eine Enterprise-Organisation, die nach Nutzung statt nach Abonnementplatz abgerechnet wird.356Enterprise Pay-as-you-go bedeutet eine Enterprise-Organisation, die nach Nutzung statt nach Abonnementplatz abgerechnet wird.

361 357

362{/* min-version: 2.1.207 */}Vor v2.1.207 wurde `default` auf Claude Platform auf AWS zu Opus 4.7 aufgelöst und auf Amazon Bedrock und Google Cloud's Agent Platform zu Sonnet 4.5.358Vor v2.1.207 wurde `default` auf Claude Platform auf AWS zu Opus 4.7 aufgelöst und auf Amazon Bedrock und Google Cloud's Agent Platform zu Sonnet 4.5.

363 359

364Wenn ein Administrator ein [Organisationsstandardmodell](#organization-default-model) festgelegt hat, wird `default` zu diesem Modell aufgelöst, anstatt zum Kontotyp-Standard oben. Erfordert Claude Code v2.1.196 oder später.360Wenn ein Administrator ein [Organisationsstandardmodell](#organization-default-model) festgelegt hat, wird `default` zu diesem Modell aufgelöst, anstatt zum Kontotyp-Standard oben. Erfordert Claude Code v2.1.196 oder später.

365 361

382 378

383Wenn [`availableModels`](#restrict-model-selection) das neueste Opus ausschließt, aber eine ältere Version erlaubt, z. B. `["sonnet", "claude-opus-4-6"]`, verwendet `opusplan` das neueste erlaubte Opus für die Planung und bleibt nur auf Sonnet, wenn jedes Opus ausgeschlossen ist. Eine Haiku-Sitzung, die normalerweise im Plan-Modus zu Sonnet aktualisiert würde, verwendet ebenfalls das neueste erlaubte Sonnet und bleibt nur auf Haiku, wenn jedes Sonnet ausgeschlossen ist. Vor v2.1.205 blieb der Plan-Modus auf dem Modell der Sitzung, wenn die neueste Version der Upgrade-Familie ausgeschlossen war, auch wenn die Zulassungsliste eine ältere erlaubte.379Wenn [`availableModels`](#restrict-model-selection) das neueste Opus ausschließt, aber eine ältere Version erlaubt, z. B. `["sonnet", "claude-opus-4-6"]`, verwendet `opusplan` das neueste erlaubte Opus für die Planung und bleibt nur auf Sonnet, wenn jedes Opus ausgeschlossen ist. Eine Haiku-Sitzung, die normalerweise im Plan-Modus zu Sonnet aktualisiert würde, verwendet ebenfalls das neueste erlaubte Sonnet und bleibt nur auf Haiku, wenn jedes Sonnet ausgeschlossen ist. Vor v2.1.205 blieb der Plan-Modus auf dem Modell der Sitzung, wenn die neueste Version der Upgrade-Familie ausgeschlossen war, auch wenn die Zulassungsliste eine ältere erlaubte.

384 380

385Die Substitution einer älteren erlaubten Version gilt auf der Anthropic API und [Claude Platform auf AWS](/de/claude-platform-on-aws). Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Mantle, deren Bereitstellungen anbieter-spezifische Modell-IDs verwenden, bleibt der Plan-Modus auf dem Modell der Sitzung, wenn das Upgrade-Modell ausgeschlossen ist.381Die Substitution einer älteren erlaubten Version gilt auf der Anthropic API und [Claude Platform auf AWS](/docs/de/claude-platform-on-aws). Auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und Mantle, deren Bereitstellungen anbieter-spezifische Modell-IDs verwenden, bleibt der Plan-Modus auf dem Modell der Sitzung, wenn das Upgrade-Modell ausgeschlossen ist.

386 382

387Für einen Hybrid-Ansatz, bei dem Claude während einer Aufgabe entscheidet, wann ein zweites Modell konsultiert werden soll, anstatt an der Plan-Grenze zu wechseln, siehe das [Advisor-Tool](/de/advisor).383Für einen Hybrid-Ansatz, bei dem Claude während einer Aufgabe entscheidet, wann ein zweites Modell konsultiert werden soll, anstatt an der Plan-Grenze zu wechseln, siehe das [Advisor-Tool](/docs/de/advisor).

388 384

389<h3 id="fallback-model-chains">385<h3 id="fallback-model-chains">

390 Fallback-Modellketten386 Fallback-Modellketten

400claude --fallback-model sonnet,haiku396claude --fallback-model sonnet,haiku

401```397```

402 398

403Um eine Kette über Sitzungen hinweg beizubehalten, setzen Sie `fallbackModel` in [Einstellungen](/de/settings) als Array:399Um eine Kette über Sitzungen hinweg beizubehalten, setzen Sie `fallbackModel` in [Einstellungen](/docs/de/settings) als Array:

404 400

405```json theme={null}401```json theme={null}

406{402{

421 417

422Dieser Abschnitt behandelt inhaltsbasiertes Fallback von Fable 5. Für verfügbarkeitsbasiertes Fallback, wenn ein Modell überlastet oder nicht verfügbar ist, siehe [Fallback-Modellketten](#fallback-model-chains).418Dieser Abschnitt behandelt inhaltsbasiertes Fallback von Fable 5. Für verfügbarkeitsbasiertes Fallback, wenn ein Modell überlastet oder nicht verfügbar ist, siehe [Fallback-Modellketten](#fallback-model-chains).

423 419

424Fable 5 wird mit Sicherheitsklassifizierern für Cybersicherheits- und Biologie-Inhalte ausgeführt. Wenn ein Klassifizierer eine Anfrage kennzeichnet, führt Claude Code diese Anfrage auf dem Standard-Opus-Modell Ihres Anbieters erneut aus und zeigt eine Benachrichtigung im Transkript an. Auf der Anthropic API, [LLM-Gateway](/de/llm-gateway)-Bereitstellungen und [Claude Platform auf AWS](/de/claude-platform-on-aws) ist dieses Modell Opus 4.8. Auf dem [Claude-Apps-Gateway](/de/claude-apps-gateway) ist es Opus 4.7, es sei denn, Sie verweisen den [`opus`-Alias](#environment-variables) auf ein anderes Modell.420Fable 5 wird mit Sicherheitsklassifizierern für Cybersicherheits- und Biologie-Inhalte ausgeführt. Wenn ein Klassifizierer eine Anfrage kennzeichnet, führt Claude Code diese Anfrage auf dem Standard-Opus-Modell Ihres Anbieters erneut aus und zeigt eine Benachrichtigung im Transkript an. Auf der Anthropic API, [LLM-Gateway](/docs/de/llm-gateway)-Bereitstellungen und [Claude Platform auf AWS](/docs/de/claude-platform-on-aws) ist dieses Modell Opus 4.8. Auf dem [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) ist es Opus 4.7, es sei denn, Sie verweisen den [`opus`-Alias](#environment-variables) auf ein anderes Modell.

425 421

426Die Sitzung wird dann auf diesem Opus-Modell fortgesetzt. Um zu Fable 5 zurückzukehren, führen Sie `/model fable` aus.422Die Sitzung wird dann auf diesem Opus-Modell fortgesetzt. Um zu Fable 5 zurückzukehren, führen Sie `/model fable` aus.

427 423

444Einige Fälle verhalten sich unterschiedlich:440Einige Fälle verhalten sich unterschiedlich:

445 441

446* Wenn beide Modelle die gleiche Anfrage kennzeichnen, können Sie den Prompt bearbeiten und erneut versuchen oder eine neue Sitzung starten.442* Wenn beide Modelle die gleiche Anfrage kennzeichnen, können Sie den Prompt bearbeiten und erneut versuchen oder eine neue Sitzung starten.

447* Bei mobilen [Claude Code im Web](/de/claude-code-on-the-web)-Sitzungen wird das Bearbeiten und erneute Versuchen nicht unterstützt. Wechseln Sie Modelle oder setzen Sie die Sitzung in einem Desktop-Browser oder der Desktop-App fort.443* Bei mobilen [Claude Code im Web](/docs/de/claude-code-on-the-web)-Sitzungen wird das Bearbeiten und erneute Versuchen nicht unterstützt. Wechseln Sie Modelle oder setzen Sie die Sitzung in einem Desktop-Browser oder der Desktop-App fort.

448* Im [nicht-interaktiven Modus](/de/cli-reference#cli-flags) und SDK-Integrationen, die den Prompt nicht anzeigen können, endet eine gekennzeichnete Anfrage den Durchgang mit einer Ablehnung.444* Im [nicht-interaktiven Modus](/docs/de/cli-reference#cli-flags) und SDK-Integrationen, die den Prompt nicht anzeigen können, endet eine gekennzeichnete Anfrage den Durchgang mit einer Ablehnung.

449* Wenn das Fallback-Ziel durch [`availableModels`](#restrict-model-selection) blockiert ist, wird der Prompt nicht angezeigt. Die gekennzeichnete Anfrage endet mit der Ablehnung, genauso wie automatisches Fallback, wenn das Ziel blockiert ist.445* Wenn das Fallback-Ziel durch [`availableModels`](#restrict-model-selection) blockiert ist, wird der Prompt nicht angezeigt. Die gekennzeichnete Anfrage endet mit der Ablehnung, genauso wie automatisches Fallback, wenn das Ziel blockiert ist.

450 446

451<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">447<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

452 Aktivieren Sie Fallback auf Bedrock, Agent Platform und Foundry448 Aktivieren Sie Fallback auf Bedrock, Agent Platform und Foundry

453</h4>449</h4>

454 450

455Auf [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) und [Microsoft Foundry](/de/microsoft-foundry) sind Modell-IDs anbieter-spezifisch, daher funktioniert automatisches Fallback nur, wenn Claude Code beide beteiligten Modelle identifizieren kann:451Auf [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) und [Microsoft Foundry](/docs/de/microsoft-foundry) sind Modell-IDs anbieter-spezifisch, daher funktioniert automatisches Fallback nur, wenn Claude Code beide beteiligten Modelle identifizieren kann:

456 452

457* Claude Code muss das aktuelle Modell als Fable 5 erkennen: Die Modell-ID enthält `claude-fable-5`, stimmt mit dem Wert von `ANTHROPIC_DEFAULT_FABLE_MODEL` überein oder ist mit [`modelOverrides`](#override-model-ids-per-version) zugeordnet.453* Claude Code muss das aktuelle Modell als Fable 5 erkennen: Die Modell-ID enthält `claude-fable-5`, stimmt mit dem Wert von `ANTHROPIC_DEFAULT_FABLE_MODEL` überein oder ist mit [`modelOverrides`](#override-model-ids-per-version) zugeordnet.

458* Das Fallback-Ziel muss zu einem Opus-Modell aufgelöst werden: Der Wert von `ANTHROPIC_DEFAULT_OPUS_MODEL`, falls gesetzt, andernfalls ein Opus 4.8-Eintrag in der Modellliste des Anbieters.454* Das Fallback-Ziel muss zu einem Opus-Modell aufgelöst werden: Der Wert von `ANTHROPIC_DEFAULT_OPUS_MODEL`, falls gesetzt, andernfalls ein Opus 4.8-Eintrag in der Modellliste des Anbieters.

487 483

488Wenn Sie Fable 5, Opus 4.8 oder Opus 4.7 zum ersten Mal ausführen, wendet Claude Code das Standard-Aufwandsniveau dieses Modells an, auch wenn Sie zuvor ein anderes Niveau für ein anderes Modell gesetzt haben: `high` auf Fable 5 und Opus 4.8 und `xhigh` auf Opus 4.7. Führen Sie `/effort` erneut aus, um nach dem Wechsel ein anderes Niveau zu wählen. Dieser Standard wird über Sitzungen hinweg beibehalten, bis Sie eine explizite Aufwandsauswahl treffen, z. B. durch Ausführen von `/effort` in einer interaktiven Sitzung oder Starten mit `--effort`.484Wenn Sie Fable 5, Opus 4.8 oder Opus 4.7 zum ersten Mal ausführen, wendet Claude Code das Standard-Aufwandsniveau dieses Modells an, auch wenn Sie zuvor ein anderes Niveau für ein anderes Modell gesetzt haben: `high` auf Fable 5 und Opus 4.8 und `xhigh` auf Opus 4.7. Führen Sie `/effort` erneut aus, um nach dem Wechsel ein anderes Niveau zu wählen. Dieser Standard wird über Sitzungen hinweg beibehalten, bis Sie eine explizite Aufwandsauswahl treffen, z. B. durch Ausführen von `/effort` in einer interaktiven Sitzung oder Starten mit `--effort`.

489 485

490`low`, `medium`, `high` und `xhigh` bleiben über Sitzungen hinweg erhalten, wenn Sie sie in einer interaktiven Sitzung setzen. {/* min-version: 2.1.205 */}Ein Niveau, das mit `/effort` im [nicht-interaktiven Modus](/de/headless) mit dem `-p`-Flag gesetzt wird, gilt nur für die aktuelle Sitzung und wird nicht als Ihr Standard gespeichert. Ein nicht-interaktives `/effort` kann auch die Modell-Standard-Sperre oben nicht freigeben: Bei Fable 5, Opus 4.8 und Opus 4.7 meldet es `Not applied` und die Sitzung bleibt beim Standard-Aufwand des Modells, daher übergeben Sie stattdessen `--effort` beim Start. `max` bietet das tiefste Reasoning ohne Einschränkung bei der Token-Ausgabe und gilt nur für die aktuelle Sitzung, außer wenn es über die `CLAUDE_CODE_EFFORT_LEVEL`-Umgebungsvariable gesetzt wird.486`low`, `medium`, `high` und `xhigh` bleiben über Sitzungen hinweg erhalten, wenn Sie sie in einer interaktiven Sitzung setzen. Ein Niveau, das mit `/effort` im [nicht-interaktiven Modus](/docs/de/headless) mit dem `-p`-Flag gesetzt wird, gilt nur für die aktuelle Sitzung und wird nicht als Ihr Standard gespeichert. Ein nicht-interaktives `/effort` kann auch die Modell-Standard-Sperre oben nicht freigeben: Bei Fable 5, Opus 4.8 und Opus 4.7 meldet es `Not applied` und die Sitzung bleibt beim Standard-Aufwand des Modells, daher übergeben Sie stattdessen `--effort` beim Start. `max` bietet das tiefste Reasoning ohne Einschränkung bei der Token-Ausgabe und gilt nur für die aktuelle Sitzung, außer wenn es über die `CLAUDE_CODE_EFFORT_LEVEL`-Umgebungsvariable gesetzt wird.

491 487

492Das `/effort`-Menü bietet auch `ultracode`. Ultracode ist eine Claude Code-Einstellung und keine Modell-Aufwandsebene: Es sendet `xhigh` an das Modell und lässt Claude zusätzlich [dynamische Workflows](/de/workflows) für substantielle Aufgaben orchestrieren. Es gilt nur für die aktuelle Sitzung.488Das `/effort`-Menü bietet auch `ultracode`. Ultracode ist eine Claude Code-Einstellung und keine Modell-Aufwandsebene: Es sendet `xhigh` an das Modell und lässt Claude zusätzlich [dynamische Workflows](/docs/de/workflows) für substantielle Aufgaben orchestrieren. Es gilt nur für die aktuelle Sitzung.

493 489

494Sie können Ultracode durch eine der folgenden Methoden aktivieren:490Sie können Ultracode durch eine der folgenden Methoden aktivieren:

495 491

496* **`/effort`**: Führen Sie `/effort ultracode` aus oder wählen Sie es aus dem Menü492* **`/effort`**: Führen Sie `/effort ultracode` aus oder wählen Sie es aus dem Menü

497* **`--effort`-Flag**: Starten Sie mit `claude --effort ultracode`, das die Sitzung mit `xhigh`-Aufwand und aktiviertem Ultracode startet493* **`--effort`-Flag**: Starten Sie mit `claude --effort ultracode`, das die Sitzung mit `xhigh`-Aufwand und aktiviertem Ultracode startet

498* **`--settings` oder eine Agent SDK-Steueranforderung**: Übergeben Sie `"ultracode": true`. Eine [`applyFlagSettings()`](/de/agent-sdk/typescript#applyflagsettings)-Anforderung akzeptiert auch `effortLevel: "ultracode"`494* **`--settings` oder eine Agent SDK-Steueranforderung**: Übergeben Sie `"ultracode": true`. Eine [`applyFlagSettings()`](/docs/de/agent-sdk/typescript#applyflagsettings)-Anforderung akzeptiert auch `effortLevel: "ultracode"`

499 495

500Das Übergeben von `ultracode` an das `--effort`-Flag oder den Agent SDK `effortLevel`-Wert erfordert Claude Code v2.1.203 oder später. Vor v2.1.203 gab `--effort ultracode` `Unknown --effort value 'ultracode'` aus und die Sitzung startete mit dem Standard-Aufwand.496Das Übergeben von `ultracode` an das `--effort`-Flag oder den Agent SDK `effortLevel`-Wert erfordert Claude Code v2.1.203 oder später. Vor v2.1.203 gab `--effort ultracode` `Unknown --effort value 'ultracode'` aus und die Sitzung startete mit dem Standard-Aufwand.

501 497

502Die persistierte `effortLevel`-Einstellung und die `CLAUDE_CODE_EFFORT_LEVEL`-Umgebungsvariable akzeptieren nicht `ultracode`.498Die persistierte `effortLevel`-Einstellung und die `CLAUDE_CODE_EFFORT_LEVEL`-Umgebungsvariable akzeptieren nicht `ultracode`.

503 499

504Wenn Ultracode nicht verfügbar ist, z. B. wenn [Workflows ausgeschaltet sind](/de/workflows#turn-workflows-off), setzt `--effort ultracode` nur `xhigh`-Aufwand.500Wenn Ultracode nicht verfügbar ist, z. B. wenn [Workflows ausgeschaltet sind](/docs/de/workflows#turn-workflows-off), setzt `--effort ultracode` nur `xhigh`-Aufwand.

505 501

506<h4 id="choose-an-effort-level">502<h4 id="choose-an-effort-level">

507 Wählen Sie ein Aufwandsniveau503 Wählen Sie ein Aufwandsniveau

518| `max` | Kann die Leistung bei anspruchsvollen Aufgaben verbessern, kann aber abnehmende Erträge zeigen und ist anfällig für Überdenken. Testen Sie vor breiter Übernahme |514| `max` | Kann die Leistung bei anspruchsvollen Aufgaben verbessern, kann aber abnehmende Erträge zeigen und ist anfällig für Überdenken. Testen Sie vor breiter Übernahme |

519| `ultracode` | Eine Claude Code-Einstellung, die einen [dynamischen Workflow](/de/workflows) für jede substantielle Aufgabe mit `xhigh`-Pro-Nachricht-Reasoning plant. Nur für Sitzungen |515| `ultracode` | Eine Claude Code-Einstellung, die einen [dynamischen Workflow](/docs/de/workflows) für jede substantielle Aufgabe mit `xhigh`-Pro-Nachricht-Reasoning plant. Nur für Sitzungen |

520 516

521Die Aufwandsskala ist pro Modell kalibriert, daher stellt der gleiche Ebenenname nicht den gleichen zugrunde liegenden Wert über Modelle hinweg dar.517Die Aufwandsskala ist pro Modell kalibriert, daher stellt der gleiche Ebenenname nicht den gleichen zugrunde liegenden Wert über Modelle hinweg dar.

522 518

537* **`--effort`-Flag**: Übergeben Sie einen Ebenennamen, um ihn für eine einzelne Sitzung beim Starten von Claude Code zu setzen533* **`--effort`-Flag**: Übergeben Sie einen Ebenennamen, um ihn für eine einzelne Sitzung beim Starten von Claude Code zu setzen

538* **Umgebungsvariable**: Setzen Sie `CLAUDE_CODE_EFFORT_LEVEL` auf einen Ebenennamen oder `auto`534* **Umgebungsvariable**: Setzen Sie `CLAUDE_CODE_EFFORT_LEVEL` auf einen Ebenennamen oder `auto`

539* **Einstellungen**: Setzen Sie `effortLevel` auf `low`, `medium`, `high` oder `xhigh` in Ihrer Einstellungsdatei. `max` und `ultracode` sind [nur für Sitzungen](#adjust-effort-level) und werden hier nicht akzeptiert535* **Einstellungen**: Setzen Sie `effortLevel` auf `low`, `medium`, `high` oder `xhigh` in Ihrer Einstellungsdatei. `max` und `ultracode` sind [nur für Sitzungen](#adjust-effort-level) und werden hier nicht akzeptiert

540* **Skill- und Subagent-Frontmatter**: Setzen Sie `effort` in einer [Skill](/de/skills#frontmatter-reference)- oder [Subagent](/de/sub-agents#supported-frontmatter-fields)-Markdown-Datei, um das Aufwandsniveau zu überschreiben, wenn dieser Skill oder Subagent ausgeführt wird536* **Skill- und Subagent-Frontmatter**: Setzen Sie `effort` in einer [Skill](/docs/de/skills#frontmatter-reference)- oder [Subagent](/docs/de/sub-agents#supported-frontmatter-fields)-Markdown-Datei, um das Aufwandsniveau zu überschreiben, wenn dieser Skill oder Subagent ausgeführt wird

541 537

542Die Umgebungsvariable hat Vorrang vor allen anderen Methoden, dann Ihre konfigurierte Ebene, dann der Modellstandard. Frontmatter-Aufwand gilt, wenn dieser Skill oder Subagent aktiv ist, und überschreibt die Sitzungsebene, aber nicht die Umgebungsvariable.538Die Umgebungsvariable hat Vorrang vor allen anderen Methoden, dann Ihre konfigurierte Ebene, dann der Modellstandard. Frontmatter-Aufwand gilt, wenn dieser Skill oder Subagent aktiv ist, und überschreibt die Sitzungsebene, aber nicht die Umgebungsvariable.

543 539

551 547

552Fable 5, Sonnet 5 sowie Opus 4.7 und später verwenden immer adaptives Reasoning. Der Modus mit festem Thinking-Budget und `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` gelten nicht dafür.548Fable 5, Sonnet 5 sowie Opus 4.7 und später verwenden immer adaptives Reasoning. Der Modus mit festem Thinking-Budget und `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` gelten nicht dafür.

553 549

554Bei Opus 4.6 und Sonnet 4.6 können Sie `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` setzen, um zum vorherigen festen Thinking-Budget zurückzukehren, das von `MAX_THINKING_TOKENS` gesteuert wird. Siehe [Umgebungsvariablen](/de/env-vars).550Bei Opus 4.6 und Sonnet 4.6 können Sie `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` setzen, um zum vorherigen festen Thinking-Budget zurückzukehren, das von `MAX_THINKING_TOKENS` gesteuert wird. Siehe [Umgebungsvariablen](/docs/de/env-vars).

555 551

556<h3 id="extended-thinking">552<h3 id="extended-thinking">

557 Erweitertes Thinking553 Erweitertes Thinking

563| :-------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |559| :-------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

565| Setzen Sie den globalen Standard | Führen Sie `/config` aus und schalten Sie den Thinking-Modus um. Gespeichert als `alwaysThinkingEnabled` in `~/.claude/settings.json` |561| Setzen Sie den globalen Standard | Führen Sie `/config` aus und schalten Sie den Thinking-Modus um. Gespeichert als `alwaysThinkingEnabled` in `~/.claude/settings.json` |

566| Deaktivieren Sie unabhängig vom Aufwand | Setzen Sie [`MAX_THINKING_TOKENS=0`](/de/env-vars), das Thinking auf der Anthropic API außer auf Fable 5 ausschaltet. Auf [Drittanbieter-Anbietern](/de/third-party-integrations) wird stattdessen der `thinking`-Parameter weggelassen, und adaptive-Reasoning-Modelle können immer noch denken. Andere Werte gelten nur mit einem [festen Thinking-Budget](#adaptive-reasoning-and-fixed-thinking-budgets) |562| Deaktivieren Sie unabhängig vom Aufwand | Setzen Sie [`MAX_THINKING_TOKENS=0`](/docs/de/env-vars), das Thinking auf der Anthropic API außer auf Fable 5 ausschaltet. Auf [Drittanbieter-Anbietern](/docs/de/third-party-integrations) wird stattdessen der `thinking`-Parameter weggelassen, und adaptive-Reasoning-Modelle können immer noch denken. Andere Werte gelten nur mit einem [festen Thinking-Budget](#adaptive-reasoning-and-fixed-thinking-budgets) |

567 563

568Thinking kann auf Fable 5 nicht ausgeschaltet werden. Der Sitzungsumschalter, `alwaysThinkingEnabled` und `MAX_THINKING_TOKENS=0` haben dort keine Auswirkung, und Fable 5 entscheidet pro Schritt, wie viel zu denken ist, basierend auf dem Aufwandsniveau.564Thinking kann auf Fable 5 nicht ausgeschaltet werden. Der Sitzungsumschalter, `alwaysThinkingEnabled` und `MAX_THINKING_TOKENS=0` haben dort keine Auswirkung, und Fable 5 entscheidet pro Schritt, wie viel zu denken ist, basierend auf dem Aufwandsniveau.

569 565

570Die Thinking-Ausgabe ist standardmäßig zusammengeklappt. Drücken Sie `Ctrl+O`, um den ausführlichen Modus umzuschalten und das Reasoning als grauer kursiver Text zu sehen. Interaktive Sitzungen auf der Anthropic API erhalten standardmäßig redigierte Thinking-Blöcke, daher setzen Sie `showThinkingSummaries: true` in [Einstellungen](/de/settings), wenn Sie die vollständigen Zusammenfassungen verfügbar haben möchten, wenn Sie erweitern. Ihnen werden alle generierten Thinking-Token berechnet, auch wenn sie zusammengeklappt oder redigiert sind.566Die Thinking-Ausgabe ist standardmäßig zusammengeklappt. Drücken Sie `Ctrl+O`, um den ausführlichen Modus umzuschalten und das Reasoning als grauer kursiver Text zu sehen. Interaktive Sitzungen auf der Anthropic API erhalten standardmäßig redigierte Thinking-Blöcke, daher setzen Sie `showThinkingSummaries: true` in [Einstellungen](/docs/de/settings), wenn Sie die vollständigen Zusammenfassungen verfügbar haben möchten, wenn Sie erweitern. Ihnen werden alle generierten Thinking-Token berechnet, auch wenn sie zusammengeklappt oder redigiert sind.

571 567

572<h3 id="extended-context">568<h3 id="extended-context">

573 Erweiterter Kontext569 Erweiterter Kontext

583| Pro | Erfordert [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Erfordert [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |579| Pro | Erfordert [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Erfordert [Nutzungsguthaben](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

585 581

586Um 1M-Kontext vollständig zu deaktivieren, setzen Sie `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Dies entfernt 1M-Modellvarianten aus der Modellauswahl. Siehe [Umgebungsvariablen](/de/env-vars).582Um 1M-Kontext vollständig zu deaktivieren, setzen Sie `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Dies entfernt 1M-Modellvarianten aus der Modellauswahl. Siehe [Umgebungsvariablen](/docs/de/env-vars).

587 583

588Das 1M-Kontextfenster verwendet Standard-Modellpreise ohne Aufschlag für Token über 200K. Für Pläne, bei denen erweiterter Kontext in Ihrem Abonnement enthalten ist, bleibt die Nutzung von Ihrem Abonnement abgedeckt. Für Pläne, die über Nutzungsguthaben auf erweiterten Kontext zugreifen, werden Token zu Nutzungsguthaben abgerechnet.584Das 1M-Kontextfenster verwendet Standard-Modellpreise ohne Aufschlag für Token über 200K. Für Pläne, bei denen erweiterter Kontext in Ihrem Abonnement enthalten ist, bleibt die Nutzung von Ihrem Abonnement abgedeckt. Für Pläne, die über Nutzungsguthaben auf erweiterten Kontext zugreifen, werden Token zu Nutzungsguthaben abgerechnet.

589 585

604 Sonnet 5-Kontextfenster600 Sonnet 5-Kontextfenster

605</h4>601</h4>

606 602

607Auf der Anthropic API wird Sonnet 5 immer mit dem 1M-Kontextfenster ausgeführt. Es gibt keine 200K-Variante, kein `[1m]`-Suffix zur Auswahl und keine erforderlichen Nutzungsguthaben bei irgendeinem Plan. Sitzungen werden automatisch komprimiert, bevor das Fenster voll ist, standardmäßig bei etwa 967K Token; setzen Sie [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/de/env-vars), um einen anderen Schwellenwert zu wählen.603Auf der Anthropic API wird Sonnet 5 immer mit dem 1M-Kontextfenster ausgeführt. Es gibt keine 200K-Variante, kein `[1m]`-Suffix zur Auswahl und keine erforderlichen Nutzungsguthaben bei irgendeinem Plan. Sitzungen werden automatisch komprimiert, bevor das Fenster voll ist, standardmäßig bei etwa 967K Token; setzen Sie [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/de/env-vars), um einen anderen Schwellenwert zu wählen.

608 604

609Zwei Konfigurationen budgetieren das Fenster stattdessen auf 200K und komprimieren automatisch an dieser Grenze:605Zwei Konfigurationen budgetieren das Fenster stattdessen auf 200K und komprimieren automatisch an dieser Grenze:

610 606

611* **LLM-Gateway**: Wenn `ANTHROPIC_BASE_URL` auf ein [Gateway](/de/llm-gateway) verweist, kann Claude Code die 1M-Unterstützung nicht überprüfen. Um das vollständige Fenster zu verwenden, wählen Sie Sonnet 5 (1M context) in der Modellauswahl aus, was `sonnet[1m]` zugeordnet wird.607* **LLM-Gateway**: Wenn `ANTHROPIC_BASE_URL` auf ein [Gateway](/docs/de/llm-gateway) verweist, kann Claude Code die 1M-Unterstützung nicht überprüfen. Um das vollständige Fenster zu verwenden, wählen Sie Sonnet 5 (1M context) in der Modellauswahl aus, was `sonnet[1m]` zugeordnet wird.

612* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: Behandelt Sonnet 5-Sitzungen so, als hätten sie ein 200K-Fenster, für Bereitstellungen, die den Kontext begrenzen müssen.608* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: Behandelt Sonnet 5-Sitzungen so, als hätten sie ein 200K-Fenster, für Bereitstellungen, die den Kontext begrenzen müssen.

613 609

614<h2 id="checking-your-current-model">610<h2 id="checking-your-current-model">

617 613

618Sie können sehen, welches Modell Sie derzeit verwenden, an zwei Stellen:614Sie können sehen, welches Modell Sie derzeit verwenden, an zwei Stellen:

619 615

620* In der [Statuszeile](/de/statusline), falls Sie eine konfiguriert haben616* In der [Statuszeile](/docs/de/statusline), falls Sie eine konfiguriert haben

621* In `/status`, das auch Ihre Kontoinformationen anzeigt617* In `/status`, das auch Ihre Kontoinformationen anzeigt

622 618

623<h2 id="add-a-custom-model-option">619<h2 id="add-a-custom-model-option">

624 Benutzerdefinierte Modelloption hinzufügen620 Benutzerdefinierte Modelloption hinzufügen

625</h2>621</h2>

626 622

627Verwenden Sie `ANTHROPIC_CUSTOM_MODEL_OPTION`, um einen einzelnen benutzerdefinierten Eintrag zur `/model`-Auswahl hinzuzufügen, ohne die integrierten Aliase zu ersetzen. Dies ist nützlich zum Testen von Modell-IDs, die Claude Code standardmäßig nicht auflistet. Für LLM-Gateway-Bereitstellungen kann Claude Code die Auswahl vom `/v1/models`-Endpunkt des Gateways auffüllen, wenn `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` gesetzt ist. Daher ist diese Variable nur erforderlich, wenn die Erkennung deaktiviert ist oder das gewünschte Modell nicht zurückgibt. Siehe [Gateway-Modellauswahl](/de/llm-gateway-protocol#model-discovery).623Verwenden Sie `ANTHROPIC_CUSTOM_MODEL_OPTION`, um einen einzelnen benutzerdefinierten Eintrag zur `/model`-Auswahl hinzuzufügen, ohne die integrierten Aliase zu ersetzen. Dies ist nützlich zum Testen von Modell-IDs, die Claude Code standardmäßig nicht auflistet. Für LLM-Gateway-Bereitstellungen kann Claude Code die Auswahl vom `/v1/models`-Endpunkt des Gateways auffüllen, wenn `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` gesetzt ist. Daher ist diese Variable nur erforderlich, wenn die Erkennung deaktiviert ist oder das gewünschte Modell nicht zurückgibt. Siehe [Gateway-Modellauswahl](/docs/de/llm-gateway-protocol#model-discovery).

628 624

629Dieses Beispiel setzt alle drei Variablen, um eine Gateway-gesteuerte Opus-Bereitstellung auswählbar zu machen:625Dieses Beispiel setzt alle drei Variablen, um eine Gateway-gesteuerte Opus-Bereitstellung auswählbar zu machen:

630 626

649| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Das Modell, das für `fable` verwendet werden soll, und die Modell-ID, die Claude Code als Fable 5 für [automatisches Modell-Fallback](#automatic-model-fallback) bei Drittanbieter-Anbietern erkennt |645| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Das Modell, das für `fable` verwendet werden soll, und die Modell-ID, die Claude Code als Fable 5 für [automatisches Modell-Fallback](#automatic-model-fallback) bei Drittanbieter-Anbietern erkennt |

650| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Das Modell, das für `opus` verwendet werden soll, oder für `opusplan`, wenn Plan Mode aktiv ist. |646| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Das Modell, das für `opus` verwendet werden soll, oder für `opusplan`, wenn Plan Mode aktiv ist. |

651| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Das Modell, das für `sonnet` verwendet werden soll, oder für `opusplan`, wenn Plan Mode nicht aktiv ist. |647| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Das Modell, das für `sonnet` verwendet werden soll, oder für `opusplan`, wenn Plan Mode nicht aktiv ist. |

652| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Das Modell, das für `haiku` verwendet werden soll, oder [Hintergrundfunktionalität](/de/costs#background-token-usage) |648| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Das Modell, das für `haiku` verwendet werden soll, oder [Hintergrundfunktionalität](/docs/de/costs#background-token-usage) |

653| `CLAUDE_CODE_SUBAGENT_MODEL` | Das Modell, das für alle [Subagents](/de/sub-agents#choose-a-model), [Agent-Teams](/de/agent-teams) und die Agenten verwendet werden soll, die ein [Workflow](/de/workflows) ausführt. Akzeptiert einen Alias wie `haiku` oder einen vollständigen Modellnamen und überschreibt den `model`-Parameter pro Aufruf und die `model`-Frontmatter der Subagent-Definition. Setzen Sie auf `inherit`, um stattdessen die normale Modellauflösung zu verwenden |649| `CLAUDE_CODE_SUBAGENT_MODEL` | Das Modell, das für alle [Subagents](/docs/de/sub-agents#choose-a-model), [Agent-Teams](/docs/de/agent-teams) und die Agenten verwendet werden soll, die ein [Workflow](/docs/de/workflows) ausführt. Akzeptiert einen Alias wie `haiku` oder einen vollständigen Modellnamen und überschreibt den `model`-Parameter pro Aufruf und die `model`-Frontmatter der Subagent-Definition. Setzen Sie auf `inherit`, um stattdessen die normale Modellauflösung zu verwenden |

654 650

655Hinweis: `ANTHROPIC_SMALL_FAST_MODEL` ist veraltet zugunsten von `ANTHROPIC_DEFAULT_HAIKU_MODEL`.651Hinweis: `ANTHROPIC_SMALL_FAST_MODEL` ist veraltet zugunsten von `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

656 652

658 Modelle für Drittanbieter-Bereitstellungen fixieren654 Modelle für Drittanbieter-Bereitstellungen fixieren

659</h3>655</h3>

660 656

661Beim Bereitstellen von Claude Code über [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry) oder [Claude Platform on AWS](/de/claude-platform-on-aws) sollten Sie Modellversionen vor dem Rollout für Benutzer fixieren.657Beim Bereitstellen von Claude Code über [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), [Microsoft Foundry](/docs/de/microsoft-foundry) oder [Claude Platform on AWS](/docs/de/claude-platform-on-aws) sollten Sie Modellversionen vor dem Rollout für Benutzer fixieren.

662 658

663Ohne Fixierung verwendet Claude Code Modellaliase wie `fable`, `opus`, `sonnet` und `haiku`, die zur integrierten Standard-Modell-ID für jeden Anbieter aufgelöst werden. Dieser Standard kann hinter der neuesten Anthropic-Veröffentlichung zurückbleiben, und das Modell, auf das er verweist, ist möglicherweise noch nicht in einem Benutzerkonto aktiviert. Wenn der Standard nicht verfügbar ist, sehen Amazon Bedrock- und Google Cloud's Agent Platform-Benutzer einen Hinweis und die Sitzung greift auf eine frühere Version des Standard-Modells zurück, oder auf das Standard-Sonnet-Modell, wenn der Standard ein Opus-Modell ist und keine Opus-Version verfügbar ist. Microsoft Foundry-Benutzer sehen stattdessen Fehler, da Microsoft Foundry keine entsprechende Startprüfung hat.659Ohne Fixierung verwendet Claude Code Modellaliase wie `fable`, `opus`, `sonnet` und `haiku`, die zur integrierten Standard-Modell-ID für jeden Anbieter aufgelöst werden. Dieser Standard kann hinter der neuesten Anthropic-Veröffentlichung zurückbleiben, und das Modell, auf das er verweist, ist möglicherweise noch nicht in einem Benutzerkonto aktiviert. Wenn der Standard nicht verfügbar ist, sehen Amazon Bedrock- und Google Cloud's Agent Platform-Benutzer einen Hinweis und die Sitzung greift auf eine frühere Version des Standard-Modells zurück, oder auf das Standard-Sonnet-Modell, wenn der Standard ein Opus-Modell ist und keine Opus-Version verfügbar ist. Microsoft Foundry-Benutzer sehen stattdessen Fehler, da Microsoft Foundry keine entsprechende Startprüfung hat.

664 660

689* Das Suffix wird pro Variable gelesen, nicht pro Modell. Bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry verwendet eine Modell-ID ohne `[1m]` in einer Variable 200K-Kontext, auch wenn eine andere Variable das gleiche Modell mit dem Suffix setzt. Sonnet 5 wird auf diesen Anbietern immer mit dem 1M-Fenster ausgeführt und benötigt niemals das Suffix.685* Das Suffix wird pro Variable gelesen, nicht pro Modell. Bei Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry verwendet eine Modell-ID ohne `[1m]` in einer Variable 200K-Kontext, auch wenn eine andere Variable das gleiche Modell mit dem Suffix setzt. Sonnet 5 wird auf diesen Anbietern immer mit dem 1M-Fenster ausgeführt und benötigt niemals das Suffix.

690 686

691<Note>687<Note>

692 Eine `availableModels`-Zulassungsliste, die über [MDM oder eine verwaltete Einstellungsdatei](/de/settings#settings-files) bereitgestellt wird, gilt weiterhin bei Verwendung von Drittanbieter-Anbietern; [server-verwaltete Einstellungen werden dort nicht bereitgestellt](/de/server-managed-settings#platform-availability). Die Filterung stimmt mit einem Modellalias wie `opus`, einem Versionspräfix wie `claude-opus-4-8` oder der vollständigen Modell-ID in Anbieterform überein. Anbieterspezifische Präfixe wie `us.anthropic.` werden nicht entfernt, daher müssen Sie zum Zulassen eines bestimmten Modells die gleiche Anbieterform-ID auflisten, die die Auswahl anzeigt, oder sie durch [`modelOverrides`](#override-model-ids-per-version) zuordnen. Alle `[1m]`-Suffixe werden sowohl aus dem Zulassungslisten-Eintrag als auch aus dem angeforderten Modell vor dem Abgleich entfernt.688 Eine `availableModels`-Zulassungsliste, die über [MDM oder eine verwaltete Einstellungsdatei](/docs/de/settings#settings-files) bereitgestellt wird, gilt weiterhin bei Verwendung von Drittanbieter-Anbietern; [server-verwaltete Einstellungen werden dort nicht bereitgestellt](/docs/de/server-managed-settings#platform-availability). Die Filterung stimmt mit einem Modellalias wie `opus`, einem Versionspräfix wie `claude-opus-4-8` oder der vollständigen Modell-ID in Anbieterform überein. Anbieterspezifische Präfixe wie `us.anthropic.` werden nicht entfernt, daher müssen Sie zum Zulassen eines bestimmten Modells die gleiche Anbieterform-ID auflisten, die die Auswahl anzeigt, oder sie durch [`modelOverrides`](#override-model-ids-per-version) zuordnen. Alle `[1m]`-Suffixe werden sowohl aus dem Zulassungslisten-Eintrag als auch aus dem angeforderten Modell vor dem Abgleich entfernt.

693</Note>689</Note>

694 690

695<h3 id="customize-pinned-model-display-and-capabilities">691<h3 id="customize-pinned-model-display-and-capabilities">

698 694

699Wenn Sie ein Modell bei einem Drittanbieter fixieren, erscheint die anbieterspezifische ID in der `/model`-Auswahl und Claude Code erkennt möglicherweise nicht, welche Funktionen das Modell unterstützt. Sie können den Anzeigenamen und die deklarierten Funktionen mit Begleit-Umgebungsvariablen für jedes fixierte Modell überschreiben.695Wenn Sie ein Modell bei einem Drittanbieter fixieren, erscheint die anbieterspezifische ID in der `/model`-Auswahl und Claude Code erkennt möglicherweise nicht, welche Funktionen das Modell unterstützt. Sie können den Anzeigenamen und die deklarierten Funktionen mit Begleit-Umgebungsvariablen für jedes fixierte Modell überschreiben.

700 696

701Diese Variablen wirken sich auf Drittanbieter wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry aus. Die Variablen `_NAME` und `_DESCRIPTION` wirken sich auch aus, wenn `ANTHROPIC_BASE_URL` auf ein [LLM-Gateway](/de/llm-gateway) verweist. Sie haben keine Auswirkung bei direkter Verbindung zu `api.anthropic.com`.697Diese Variablen wirken sich auf Drittanbieter wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry aus. Die Variablen `_NAME` und `_DESCRIPTION` wirken sich auch aus, wenn `ANTHROPIC_BASE_URL` auf ein [LLM-Gateway](/docs/de/llm-gateway) verweist. Sie haben keine Auswirkung bei direkter Verbindung zu `api.anthropic.com`.

702 698

703| Umgebungsvariable | Beschreibung |699| Umgebungsvariable | Beschreibung |

704| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |700| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |

713| Funktionswert | Aktiviert |709| Funktionswert | Aktiviert |

714| ---------------------- | -------------------------------------------------------------------------------------------- |710| ---------------------- | -------------------------------------------------------------------------------------------- |

716| `xhigh_effort` | {/* min-version: 2.1.111 */}Das `xhigh`-Aufwandsniveau |712| `xhigh_effort` | Das `xhigh`-Aufwandsniveau |

740 736

741Dies ermöglicht es Enterprise-Administratoren, jede Modellversion zu einem bestimmten Amazon Bedrock-Inference-Profil-ARN, Google Cloud's Agent Platform-Versionsnamen oder Microsoft Foundry-Bereitstellungsnamen für Governance, Kostenzuteilung oder regionales Routing zu leiten.737Dies ermöglicht es Enterprise-Administratoren, jede Modellversion zu einem bestimmten Amazon Bedrock-Inference-Profil-ARN, Google Cloud's Agent Platform-Versionsnamen oder Microsoft Foundry-Bereitstellungsnamen für Governance, Kostenzuteilung oder regionales Routing zu leiten.

742 738

743Setzen Sie `modelOverrides` in Ihrer [Einstellungsdatei](/de/settings#settings-files):739Setzen Sie `modelOverrides` in Ihrer [Einstellungsdatei](/docs/de/settings#settings-files):

744 740

745```json theme={null}741```json theme={null}

746{742{

756 752

757Überschreibungen ersetzen die integrierten Modell-IDs, die jeden Eintrag in der `/model`-Auswahl unterstützen. Bei Amazon Bedrock haben Überschreibungen Vorrang vor allen Inference-Profilen, die Claude Code beim Start automatisch erkennt. Claude Code übergibt Werte, die bereits anbieterspezifisch sind, wie Amazon Bedrock-Inference-Profil-ARNs oder Microsoft Foundry-Bereitstellungsnamen, unverändert an den Anbieter.753Überschreibungen ersetzen die integrierten Modell-IDs, die jeden Eintrag in der `/model`-Auswahl unterstützen. Bei Amazon Bedrock haben Überschreibungen Vorrang vor allen Inference-Profilen, die Claude Code beim Start automatisch erkennt. Claude Code übergibt Werte, die bereits anbieterspezifisch sind, wie Amazon Bedrock-Inference-Profil-ARNs oder Microsoft Foundry-Bereitstellungsnamen, unverändert an den Anbieter.

758 754

759{/* min-version: 2.1.200 */}Überschreibungen gelten auch, wenn Sie eine Anthropic-Modell-ID direkt über `--model`, die `ANTHROPIC_MODEL`-Umgebungsvariable oder eine `ANTHROPIC_DEFAULT_*_MODEL`-Umgebungsvariable übergeben. Bei Amazon Bedrock, Google Cloud's Agent Platform und [Mantle](/de/amazon-bedrock#use-the-mantle-endpoint) wird eine Anthropic-Modell-ID ohne `modelOverrides`-Eintrag zur gleichen anbieterspezifischen ID aufgelöst wie die `/model`-Auswahl-Zeile für diese Version, wenn der Anbieter diese Version unterstützt. Mantle unterstützt eine Teilmenge von Versionen. Für eine Anthropic-Modell-ID außerhalb dieser Teilmenge sendet Claude Code die rohe ID an Mantle ohne Zuordnung, es sei denn, ein `modelOverrides`-Eintrag deckt sie ab. Vor v2.1.200 erreichten `--model` und die Umgebungsvariablenwerte den Anbieter unverändert, ohne die Überschreibungskarte zu durchlaufen.755Überschreibungen gelten auch, wenn Sie eine Anthropic-Modell-ID direkt über `--model`, die `ANTHROPIC_MODEL`-Umgebungsvariable oder eine `ANTHROPIC_DEFAULT_*_MODEL`-Umgebungsvariable übergeben. Bei Amazon Bedrock, Google Cloud's Agent Platform und [Mantle](/docs/de/amazon-bedrock#use-the-mantle-endpoint) wird eine Anthropic-Modell-ID ohne `modelOverrides`-Eintrag zur gleichen anbieterspezifischen ID aufgelöst wie die `/model`-Auswahl-Zeile für diese Version, wenn der Anbieter diese Version unterstützt. Mantle unterstützt eine Teilmenge von Versionen. Für eine Anthropic-Modell-ID außerhalb dieser Teilmenge sendet Claude Code die rohe ID an Mantle ohne Zuordnung, es sei denn, ein `modelOverrides`-Eintrag deckt sie ab. Vor v2.1.200 erreichten `--model` und die Umgebungsvariablenwerte den Anbieter unverändert, ohne die Überschreibungskarte zu durchlaufen.

760 756

761`modelOverrides` funktioniert zusammen mit `availableModels`. Die Zulassungsliste wird gegen die Anthropic-Modell-ID ausgewertet, nicht gegen den Überschreibungswert, daher ein Eintrag wie `"opus"` in `availableModels` stimmt weiterhin überein, auch wenn Opus-Versionen ARNs zugeordnet sind. Wenn `enforceAvailableModels` in verwalteten Einstellungen gesetzt ist, wird der erzwungene Standard durch `modelOverrides` aus der [höchsten Prioritätsquelle für verwaltete Einstellungen](/de/server-managed-settings#settings-precedence) aufgelöst. Die Zuordnung eines Administrators, wie eine Version, die an ein Inference-Profil-ARN fixiert ist, wird im erzwungenen Standard berücksichtigt. Überschreibungen aus Benutzer- oder Projekteinstellungen beeinflussen ihn nicht.757`modelOverrides` funktioniert zusammen mit `availableModels`. Die Zulassungsliste wird gegen die Anthropic-Modell-ID ausgewertet, nicht gegen den Überschreibungswert, daher ein Eintrag wie `"opus"` in `availableModels` stimmt weiterhin überein, auch wenn Opus-Versionen ARNs zugeordnet sind. Wenn `enforceAvailableModels` in verwalteten Einstellungen gesetzt ist, wird der erzwungene Standard durch `modelOverrides` aus der [höchsten Prioritätsquelle für verwaltete Einstellungen](/docs/de/server-managed-settings#settings-precedence) aufgelöst. Die Zuordnung eines Administrators, wie eine Version, die an ein Inference-Profil-ARN fixiert ist, wird im erzwungenen Standard berücksichtigt. Überschreibungen aus Benutzer- oder Projekteinstellungen beeinflussen ihn nicht.

762 758

763{/* min-version: 2.1.200 */}Wenn `availableModels` in [verwalteten Einstellungen](/de/settings#settings-files) gesetzt ist, gelten nur `modelOverrides` aus dieser verwalteten Quelle für eine Anthropic-Modell-ID, die direkt über `--model` oder die oben genannten Umgebungsvariablen übergeben wird. Claude Code ignoriert Überschreibungen in Benutzer- oder Projekteinstellungen für diese IDs und löst niemals eine ID auf, die die verwaltete Liste ausschließt, durch `modelOverrides` aus einer beliebigen Einstellungsquelle. Diese Einschränkung der verwalteten Quelle erfordert Claude Code v2.1.200 oder später. Siehe [Modellauswahl einschränken](#restrict-model-selection), um zu erfahren, wie blockierte IDs behandelt werden.759Wenn `availableModels` in [verwalteten Einstellungen](/docs/de/settings#settings-files) gesetzt ist, gelten nur `modelOverrides` aus dieser verwalteten Quelle für eine Anthropic-Modell-ID, die direkt über `--model` oder die oben genannten Umgebungsvariablen übergeben wird. Claude Code ignoriert Überschreibungen in Benutzer- oder Projekteinstellungen für diese IDs und löst niemals eine ID auf, die die verwaltete Liste ausschließt, durch `modelOverrides` aus einer beliebigen Einstellungsquelle. Diese Einschränkung der verwalteten Quelle erfordert Claude Code v2.1.200 oder später. Siehe [Modellauswahl einschränken](#restrict-model-selection), um zu erfahren, wie blockierte IDs behandelt werden.

764 760

765<h3 id="prompt-caching-configuration">761<h3 id="prompt-caching-configuration">

766 Prompt-Caching-Konfiguration762 Prompt-Caching-Konfiguration

767</h3>763</h3>

768 764

769Claude Code verwendet automatisch [Prompt-Caching](/de/prompt-caching), um die Leistung zu optimieren und Kosten zu senken. Sie können Prompt-Caching global oder für bestimmte Modell-Tiers deaktivieren:765Claude Code verwendet automatisch [Prompt-Caching](/docs/de/prompt-caching), um die Leistung zu optimieren und Kosten zu senken. Sie können Prompt-Caching global oder für bestimmte Modell-Tiers deaktivieren:

770 766

771| Umgebungsvariable | Beschreibung |767| Umgebungsvariable | Beschreibung |

772| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |768| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |

778 774

779Um die Cache-TTL zu ändern oder zu erfahren, was einen Cache-Miss auslöst, siehe [Wie Claude Code Prompt-Caching verwendet](/de/prompt-caching).775Um die Cache-TTL zu ändern oder zu erfahren, was einen Cache-Miss auslöst, siehe [Wie Claude Code Prompt-Caching verwendet](/docs/de/prompt-caching).

monitoring-usage.md +28 −28

Details

47 Administratorkonfiguration47 Administratorkonfiguration

48</h2>48</h2>

49 49

50Administratoren können OpenTelemetry-Einstellungen für alle Benutzer über die [verwaltete Einstellungsdatei](/de/settings#settings-files) konfigurieren. Dies ermöglicht eine zentrale Kontrolle der Telemetrie-Einstellungen in einer Organisation. Weitere Informationen zur Anwendung von Einstellungen finden Sie unter [Einstellungspriorität](/de/settings#settings-precedence).50Administratoren können OpenTelemetry-Einstellungen für alle Benutzer über die [verwaltete Einstellungsdatei](/docs/de/settings#settings-files) konfigurieren. Dies ermöglicht eine zentrale Kontrolle der Telemetrie-Einstellungen in einer Organisation. Weitere Informationen zur Anwendung von Einstellungen finden Sie unter [Einstellungspriorität](/docs/de/settings#settings-precedence).

51 51

52Beispiel für verwaltete Einstellungskonfiguration:52Beispiel für verwaltete Einstellungskonfiguration:

53 53

93| `OTEL_METRIC_EXPORT_INTERVAL` | Exportintervall in Millisekunden (Standard: 60000) | `5000`, `60000` |93| `OTEL_METRIC_EXPORT_INTERVAL` | Exportintervall in Millisekunden (Standard: 60000) | `5000`, `60000` |

94| `OTEL_LOGS_EXPORT_INTERVAL` | Logs-Exportintervall in Millisekunden (Standard: 5000) | `1000`, `10000` |94| `OTEL_LOGS_EXPORT_INTERVAL` | Logs-Exportintervall in Millisekunden (Standard: 5000) | `1000`, `10000` |

96| `OTEL_LOG_ASSISTANT_RESPONSES` | Aktiviert die Protokollierung von Assistent-Antworttext bei `assistant_response`-Ereignissen (Standard: deaktiviert). Wenn nicht gesetzt, wird auf den Wert von `OTEL_LOG_USER_PROMPTS` zurückgegriffen. {/* min-version: 2.1.193 */}Erfordert Claude Code v2.1.193 oder später | `1` zum Aktivieren, `0` zum Beibehalten von Redaktionen |96| `OTEL_LOG_ASSISTANT_RESPONSES` | Aktiviert die Protokollierung von Assistent-Antworttext bei `assistant_response`-Ereignissen (Standard: deaktiviert). Wenn nicht gesetzt, wird auf den Wert von `OTEL_LOG_USER_PROMPTS` zurückgegriffen. Erfordert Claude Code v2.1.193 oder später | `1` zum Aktivieren, `0` zum Beibehalten von Redaktionen |

97| `OTEL_LOG_TOOL_DETAILS` | Aktiviert die Protokollierung von Tool-Parametern und Eingabeargumenten in Tool-Ereignissen und Trace-Span-Attributen: Bash-Befehle, MCP-Server- und Tool-Namen, Skill-Namen, benutzerdefinierte Workflow-Namen und Tool-Eingabe. Aktiviert auch benutzerdefinierte, Plugin- und MCP-Befehlsnamen bei `user_prompt`-Ereignissen (Standard: deaktiviert) | `1` zum Aktivieren |97| `OTEL_LOG_TOOL_DETAILS` | Aktiviert die Protokollierung von Tool-Parametern und Eingabeargumenten in Tool-Ereignissen und Trace-Span-Attributen: Bash-Befehle, MCP-Server- und Tool-Namen, Skill-Namen, benutzerdefinierte Workflow-Namen und Tool-Eingabe. Aktiviert auch benutzerdefinierte, Plugin- und MCP-Befehlsnamen bei `user_prompt`-Ereignissen (Standard: deaktiviert) | `1` zum Aktivieren |

98| `OTEL_LOG_TOOL_CONTENT` | Aktiviert die Protokollierung von Tool-Eingabe- und Ausgabeinhalten in Span-Ereignissen (Standard: deaktiviert). Erfordert [Tracing](#traces-beta). Der Inhalt wird bei 60 KB gekürzt | `1` zum Aktivieren |98| `OTEL_LOG_TOOL_CONTENT` | Aktiviert die Protokollierung von Tool-Eingabe- und Ausgabeinhalten in Span-Ereignissen (Standard: deaktiviert). Erfordert [Tracing](#traces-beta). Der Inhalt wird bei 60 KB gekürzt | `1` zum Aktivieren |

99| `OTEL_LOG_RAW_API_BODIES` | Gibt die vollständige Anthropic Messages API-Anfrage und Antwort JSON als `api_request_body` / `api_response_body` Log-Ereignisse aus (Standard: deaktiviert). Texte enthalten die gesamte Konversationshistorie. Das Aktivieren impliziert Zustimmung zu allem, was `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` und `OTEL_LOG_TOOL_CONTENT` offenbaren würden | `1` für Inline-Texte gekürzt bei 60 KB, oder `file:<dir>` für ungekürzte Texte auf der Festplatte mit einem `body_ref`-Zeiger im Ereignis |99| `OTEL_LOG_RAW_API_BODIES` | Gibt die vollständige Anthropic Messages API-Anfrage und Antwort JSON als `api_request_body` / `api_response_body` Log-Ereignisse aus (Standard: deaktiviert). Texte enthalten die gesamte Konversationshistorie. Das Aktivieren impliziert Zustimmung zu allem, was `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` und `OTEL_LOG_TOOL_CONTENT` offenbaren würden | `1` für Inline-Texte gekürzt bei 60 KB, oder `file:<dir>` für ungekürzte Texte auf der Festplatte mit einem `body_ref`-Zeiger im Ereignis |

108 108

110| :--------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------- |110| :--------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------- |

111| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` und optional `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Siehe [Netzwerkkonfiguration](/de/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |111| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` und optional `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Siehe [Netzwerkkonfiguration](/docs/de/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |

112| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` und `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, oder die Pro-Signal-Varianten wie `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY`, um ein anderes Zertifikat pro Signal zu verwenden | `OTEL_EXPORTER_OTLP_CERTIFICATE` |112| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` und `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, oder die Pro-Signal-Varianten wie `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY`, um ein anderes Zertifikat pro Signal zu verwenden | `OTEL_EXPORTER_OTLP_CERTIFICATE` |

113 113

114Für `grpc` liest das OpenTelemetry SDK die Standard-OTLP-Variablen direkt, daher funktionieren bestehende Konfigurationen, die die Pro-Signal-Metriken-Variablen setzen, weiterhin.114Für `grpc` liest das OpenTelemetry SDK die Standard-OTLP-Variablen direkt, daher funktionieren bestehende Konfigurationen, die die Pro-Signal-Metriken-Variablen setzen, weiterhin.

200| `parent_agent_id` | Kennung des Agenten, der diesen erzeugt hat. Fehlt für die Hauptsitzung und für Agenten, die direkt von ihr erzeugt wurden | |200| `parent_agent_id` | Kennung des Agenten, der diesen erzeugt hat. Fehlt für die Hauptsitzung und für Agenten, die direkt von ihr erzeugt wurden | |

201| `workflow.run_id` | Run-Kennung des [Workflow](/de/workflows) Tool-Durchlaufs, der diesen Agenten erzeugt hat, mit dem Präfix `wf_`. Fehlt für Agenten, die nicht durch einen Workflow erzeugt wurden | |201| `workflow.run_id` | Run-Kennung des [Workflow](/docs/de/workflows) Tool-Durchlaufs, der diesen Agenten erzeugt hat, mit dem Präfix `wf_`. Fehlt für Agenten, die nicht durch einen Workflow erzeugt wurden | |

202| `workflow.name` | Name des Workflows, der diesen Agenten erzeugt hat. Benutzerdefinierte Namen werden durch `custom` ersetzt, es sei denn, das Gate ist gesetzt | `OTEL_LOG_TOOL_DETAILS` |202| `workflow.name` | Name des Workflows, der diesen Agenten erzeugt hat. Benutzerdefinierte Namen werden durch `custom` ersetzt, es sei denn, das Gate ist gesetzt | `OTEL_LOG_TOOL_DETAILS` |

314Wenn das Helper-Skript fehlschlägt oder eine Ausgabe druckt, die diese Anforderungen nicht erfüllt, meldet Claude Code den Fehler in:314Wenn das Helper-Skript fehlschlägt oder eine Ausgabe druckt, die diese Anforderungen nicht erfüllt, meldet Claude Code den Fehler in:

315 315

316* `/status` Ausgabe316* `/status` Ausgabe

317* Das Debug-Log, wenn Sie mit [`--debug`](/de/cli-reference#cli-flags) ausführen oder nach dem Ausführen von `/debug` in der Sitzung317* Das Debug-Log, wenn Sie mit [`--debug`](/docs/de/cli-reference#cli-flags) ausführen oder nach dem Ausführen von `/debug` in der Sitzung

318* stderr, in nicht-interaktiven Sitzungen, die mit `-p` gestartet werden318* stderr, in nicht-interaktiven Sitzungen, die mit `-p` gestartet werden

319 319

320<h4 id="refresh-behavior">320<h4 id="refresh-behavior">

442| Schlüssel aus `OTEL_RESOURCE_ATTRIBUTES` | Benutzerdefinierte Attribute, die Sie festlegen, z. B. `department` oder `team.id`. Siehe [Multi-Team-Organisationsunterstützung](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (Standard: true) |442| Schlüssel aus `OTEL_RESOURCE_ATTRIBUTES` | Benutzerdefinierte Attribute, die Sie festlegen, z. B. `department` oder `team.id`. Siehe [Multi-Team-Organisationsunterstützung](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (Standard: true) |

443 443

444Wenn Claude Code bei einem [Claude-Apps-Gateway](/de/claude-apps-gateway) angemeldet ist, versieht die CLI Exporte mit der authentifizierten Identität aus der Gateway-Sitzung: `user.id` ist das IdP-Subjekt statt einer anonymen Installationskennung, `user.email` ist die angemeldete E-Mail, und `user.groups` enthält die IdP-Gruppenmitgliedschaft als kommagetrennte Zeichenkette. Jeder Export trägt auch `identity.source: gateway-oidc`. Die Gateway-Identität wird zuletzt angewendet, daher werden `user.*` und `identity.*` Schlüssel, die über `OTEL_RESOURCE_ATTRIBUTES` gesetzt werden, bei Gateway-Sitzungen ignoriert.444Wenn Claude Code bei einem [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) angemeldet ist, versieht die CLI Exporte mit der authentifizierten Identität aus der Gateway-Sitzung: `user.id` ist das IdP-Subjekt statt einer anonymen Installationskennung, `user.email` ist die angemeldete E-Mail, und `user.groups` enthält die IdP-Gruppenmitgliedschaft als kommagetrennte Zeichenkette. Jeder Export trägt auch `identity.source: gateway-oidc`. Die Gateway-Identität wird zuletzt angewendet, daher werden `user.*` und `identity.*` Schlüssel, die über `OTEL_RESOURCE_ATTRIBUTES` gesetzt werden, bei Gateway-Sitzungen ignoriert.

445 445

446Ereignisse enthalten zusätzlich die folgenden Attribute. Diese werden niemals an Metriken angehängt, da sie zu unbegrenzter Kardinalität führen würden:446Ereignisse enthalten zusätzlich die folgenden Attribute. Diese werden niemals an Metriken angehängt, da sie zu unbegrenzter Kardinalität führen würden:

447 447

448* `prompt.id`: UUID, die einen Benutzer-Prompt mit allen nachfolgenden Ereignissen bis zum nächsten Prompt korreliert. Siehe [Ereigniskorrelationsattribute](#event-correlation-attributes).448* `prompt.id`: UUID, die einen Benutzer-Prompt mit allen nachfolgenden Ereignissen bis zum nächsten Prompt korreliert. Siehe [Ereigniskorrelationsattribute](#event-correlation-attributes).

449* `workspace.host_paths`: Host-Workspace-Verzeichnisse, die in der Desktop-App ausgewählt wurden, als String-Array449* `workspace.host_paths`: Host-Workspace-Verzeichnisse, die in der Desktop-App ausgewählt wurden, als String-Array

450* `workflow.run_id`: Lauf-Kennung mit dem Präfix `wf_` auf der API und Tool-Ereignisse, die von Agents ausgegeben werden, die zu einem [Workflow](/de/workflows) Tool-Lauf gehören. Das Filtern von Ereignissen nach einer `workflow.run_id` rekonstruiert die API-Anfragen und Tool-Ergebnisse dieses Laufs. Die Kennung umfasst die Agents, die das Workflow-Skript erzeugt, und alle Agents, die diese wiederum erzeugen, z. B. Skill-Aufrufe. Sie entspricht der Lauf-Kennung, die im Workflow-Tool-Ergebnis gemeldet wird. Nicht vorhanden bei allen anderen Ereignissen. {/* min-version: 2.1.202 */}Erfordert Claude Code v2.1.202 oder später450* `workflow.run_id`: Lauf-Kennung mit dem Präfix `wf_` auf der API und Tool-Ereignisse, die von Agents ausgegeben werden, die zu einem [Workflow](/docs/de/workflows) Tool-Lauf gehören. Das Filtern von Ereignissen nach einer `workflow.run_id` rekonstruiert die API-Anfragen und Tool-Ergebnisse dieses Laufs. Die Kennung umfasst die Agents, die das Workflow-Skript erzeugt, und alle Agents, die diese wiederum erzeugen, z. B. Skill-Aufrufe. Sie entspricht der Lauf-Kennung, die im Workflow-Tool-Ergebnis gemeldet wird. Nicht vorhanden bei allen anderen Ereignissen. Erfordert Claude Code v2.1.202 oder später

451* `workflow.name`: Name des Workflows, das `meta.name` des Skripts, ausgegeben zusammen mit `workflow.run_id`. Integrierte Workflow-Namen erscheinen wörtlich, wenn der Lauf das unmodifizierte integrierte Skript ausführt. Benutzerdefinierte Namen, einschließlich bearbeiteter Kopien integrierter Skripte, werden durch `custom` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt. {/* min-version: 2.1.202 */}Erfordert Claude Code v2.1.202 oder später451* `workflow.name`: Name des Workflows, das `meta.name` des Skripts, ausgegeben zusammen mit `workflow.run_id`. Integrierte Workflow-Namen erscheinen wörtlich, wenn der Lauf das unmodifizierte integrierte Skript ausführt. Benutzerdefinierte Namen, einschließlich bearbeiteter Kopien integrierter Skripte, werden durch `custom` ersetzt, es sei denn, `OTEL_LOG_TOOL_DETAILS=1` ist gesetzt. Erfordert Claude Code v2.1.202 oder später

452 452

453<h3 id="metrics">453<h3 id="metrics">

454 Metriken454 Metriken

528* `model`: Modellkennung (z. B. "claude-sonnet-5")528* `model`: Modellkennung (z. B. "claude-sonnet-5")

529* `query_source`: Kategorie des Subsystems, das die Anfrage gestellt hat. Einer von `"main"`, `"subagent"` oder `"auxiliary"`529* `query_source`: Kategorie des Subsystems, das die Anfrage gestellt hat. Einer von `"main"`, `"subagent"` oder `"auxiliary"`

530* `speed`: `"fast"`, wenn die Anfrage den schnellen Modus verwendet hat. Andernfalls nicht vorhanden530* `speed`: `"fast"`, wenn die Anfrage den schnellen Modus verwendet hat. Andernfalls nicht vorhanden

531* `effort`: [Anstrengungsstufe](/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.531* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.

532* `agent.name`: Subagent-Typ, der die Anfrage gestellt hat. Integrierte Agent-Namen und Agents aus offiziellen Marketplace-Plugins werden wörtlich angezeigt. Andere benutzerdefinierte Agent-Namen werden durch `"custom"` ersetzt. Nicht vorhanden, wenn die Anfrage nicht von einem benannten Subagent-Typ gestellt wurde.532* `agent.name`: Subagent-Typ, der die Anfrage gestellt hat. Integrierte Agent-Namen und Agents aus offiziellen Marketplace-Plugins werden wörtlich angezeigt. Andere benutzerdefinierte Agent-Namen werden durch `"custom"` ersetzt. Nicht vorhanden, wenn die Anfrage nicht von einem benannten Subagent-Typ gestellt wurde.

533* `skill.name`: Skill, der für die Anfrage aktiv ist, gesetzt durch das Skill-Tool, einen `/` Befehl oder geerbt von einem erzeugten Subagent. Integrierte, gebündelte, benutzerdefinierte und offizielle Marketplace-Plugin-Skill-Namen werden wörtlich angezeigt. Drittanbieter-Plugin-Skill-Namen werden durch `"third-party"` ersetzt. Nicht vorhanden, wenn kein Skill aktiv ist.533* `skill.name`: Skill, der für die Anfrage aktiv ist, gesetzt durch das Skill-Tool, einen `/` Befehl oder geerbt von einem erzeugten Subagent. Integrierte, gebündelte, benutzerdefinierte und offizielle Marketplace-Plugin-Skill-Namen werden wörtlich angezeigt. Drittanbieter-Plugin-Skill-Namen werden durch `"third-party"` ersetzt. Nicht vorhanden, wenn kein Skill aktiv ist.

534* `plugin.name`: Besitzendes Plugin, wenn der aktive Skill oder Subagent von einem Plugin bereitgestellt wird. Offizielle Marketplace-Plugin-Namen werden wörtlich angezeigt. Drittanbieter-Plugin-Namen werden durch `"third-party"` ersetzt. Nicht vorhanden, wenn weder der Skill noch der Subagent ein besitzendes Plugin hat.534* `plugin.name`: Besitzendes Plugin, wenn der aktive Skill oder Subagent von einem Plugin bereitgestellt wird. Offizielle Marketplace-Plugin-Namen werden wörtlich angezeigt. Drittanbieter-Plugin-Namen werden durch `"third-party"` ersetzt. Nicht vorhanden, wenn weder der Skill noch der Subagent ein besitzendes Plugin hat.

549* `model`: Modellkennung (z. B. "claude-sonnet-5")549* `model`: Modellkennung (z. B. "claude-sonnet-5")

550* `query_source`: Kategorie des Subsystems, das die Anfrage gestellt hat. Einer von `"main"`, `"subagent"` oder `"auxiliary"`550* `query_source`: Kategorie des Subsystems, das die Anfrage gestellt hat. Einer von `"main"`, `"subagent"` oder `"auxiliary"`

551* `speed`: `"fast"`, wenn die Anfrage den schnellen Modus verwendet hat. Andernfalls nicht vorhanden551* `speed`: `"fast"`, wenn die Anfrage den schnellen Modus verwendet hat. Andernfalls nicht vorhanden

552* `effort`: [Anstrengungsstufe](/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Siehe [Kostenzähler](#cost-counter) für Details.552* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Siehe [Kostenzähler](#cost-counter) für Details.

553* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Skill-, Plugin-, Agent- und MCP-Zuordnung für die Anfrage. Siehe [Kostenzähler](#cost-counter) für Definitionen und Schwärzungsverhalten.553* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Skill-, Plugin-, Agent- und MCP-Zuordnung für die Anfrage. Siehe [Kostenzähler](#cost-counter) für Definitionen und Schwärzungsverhalten.

554 554

555<h4 id="code-edit-tool-decision-counter">555<h4 id="code-edit-tool-decision-counter">

622 Assistent-Antwort-Ereignis622 Assistent-Antwort-Ereignis

623</h4>623</h4>

624 624

625Protokolliert nach jeder API-Anfrage, die Textinhalte vom Modell zurückgibt. Nur die Textblöcke der Antwort sind enthalten; Thinking-Blöcke und Tool-Use-Blöcke sind ausgeschlossen. {/* min-version: 2.1.193 */}Erfordert Claude Code v2.1.193 oder später.625Protokolliert nach jeder API-Anfrage, die Textinhalte vom Modell zurückgibt. Nur die Textblöcke der Antwort sind enthalten; Thinking-Blöcke und Tool-Use-Blöcke sind ausgeschlossen. Erfordert Claude Code v2.1.193 oder später.

626 626

627**Ereignisname**: `claude_code.assistant_response`627**Ereignisname**: `claude_code.assistant_response`

628 628

695* `request_id`: Anthropic API-Anfrage-ID aus dem Response-Header `request-id`, z. B. `"req_011..."`. Nur vorhanden, wenn die API eine zurückgibt.695* `request_id`: Anthropic API-Anfrage-ID aus dem Response-Header `request-id`, z. B. `"req_011..."`. Nur vorhanden, wenn die API eine zurückgibt.

696* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war696* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war

697* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name697* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name

698* `effort`: [Anstrengungsstufe](/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.698* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird: `"low"`, `"medium"`, `"high"`, `"xhigh"` oder `"max"`. Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.

699* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Skill-, Plugin-, Agent- und MCP-Zuordnung für die Anfrage. Siehe [Kostenzähler](#cost-counter) für Definitionen und Schwärzungsverhalten.699* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Skill-, Plugin-, Agent- und MCP-Zuordnung für die Anfrage. Siehe [Kostenzähler](#cost-counter) für Definitionen und Schwärzungsverhalten.

700 700

701<h4 id="api-error-event">701<h4 id="api-error-event">

720* `request_id`: Anthropic API-Anfrage-ID aus dem Response-Header `request-id`, z. B. `"req_011..."`. Nur vorhanden, wenn die API eine zurückgibt.720* `request_id`: Anthropic API-Anfrage-ID aus dem Response-Header `request-id`, z. B. `"req_011..."`. Nur vorhanden, wenn die API eine zurückgibt.

721* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war721* `speed`: `"fast"` oder `"normal"`, was angibt, ob der schnelle Modus aktiv war

722* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name722* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name

723* `effort`: [Anstrengungsstufe](/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.723* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.

724* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Skill-, Plugin-, Agent- und MCP-Zuordnung für die Anfrage. Siehe [Kostenzähler](#cost-counter) für Definitionen und Schwärzungsverhalten.724* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Skill-, Plugin-, Agent- und MCP-Zuordnung für die Anfrage. Siehe [Kostenzähler](#cost-counter) für Definitionen und Schwärzungsverhalten.

725 725

726<h4 id="api-refusal-event">726<h4 id="api-refusal-event">

740* `model`: Modellkennung aus der Anfrage740* `model`: Modellkennung aus der Anfrage

741* `request_id`: Anthropic API-Anfrage-ID aus dem Response-Header `request-id`, z. B. `"req_011..."`. Nur vorhanden, wenn die API eine zurückgibt.741* `request_id`: Anthropic API-Anfrage-ID aus dem Response-Header `request-id`, z. B. `"req_011..."`. Nur vorhanden, wenn die API eine zurückgibt.

742* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name. Siehe [`api_request`](#api-request-event) für Definitionen.742* `query_source`: Subsystem, das die Anfrage gestellt hat, z. B. `"repl_main_thread"`, `"compact"` oder ein Subagent-Name. Siehe [`api_request`](#api-request-event) für Definitionen.

743* `speed`: Entweder `"fast"`, wenn [Schneller Modus](/de/fast-mode) aktiv ist, oder `"normal"`743* `speed`: Entweder `"fast"`, wenn [Schneller Modus](/docs/de/fast-mode) aktiv ist, oder `"normal"`

744* `attempt`: Wiederholungsversuch-Nummer. Der erste Versuch ist `1`.744* `attempt`: Wiederholungsversuch-Nummer. Der erste Versuch ist `1`.

745* `effort`: [Anstrengungsstufe](/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.745* `effort`: [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level), die auf die Anfrage angewendet wird. Nicht vorhanden, wenn das Modell Anstrengung nicht unterstützt.

746* `server_fallback_hop`: `true`, wenn das Server-seitige Modell-Fallback der API diesen Verweigerung bereits auf einem anderen Modell erneut versucht hat, sodass der Benutzer diese bestimmte Verweigerung nicht sah. `false`, wenn die Anfrage in einer Verweigerung endete. Eine einzelne Runde kann sowohl ein `true` Hop-Ereignis als auch ein späteres `false` Finales Ereignis ausgeben, wenn das Fallback-Modell auch verweigert.746* `server_fallback_hop`: `true`, wenn das Server-seitige Modell-Fallback der API diesen Verweigerung bereits auf einem anderen Modell erneut versucht hat, sodass der Benutzer diese bestimmte Verweigerung nicht sah. `false`, wenn die Anfrage in einer Verweigerung endete. Eine einzelne Runde kann sowohl ein `true` Hop-Ereignis als auch ein späteres `false` Finales Ereignis ausgeben, wenn das Fallback-Modell auch verweigert.

747* `has_category`: `true`, wenn die API-Antwort eine `stop_details.category` von `"cyber"`, `"bio"`, `"frontier_llm"` oder `"reasoning_extraction"` trug. `false`, wenn die Antwort keine Kategorie oder einen Wert außerhalb dieses Satzes trug. Nicht vorhanden, wenn `server_fallback_hop` `true` ist, da Hop-Blöcke keine `stop_details` tragen.747* `has_category`: `true`, wenn die API-Antwort eine `stop_details.category` von `"cyber"`, `"bio"`, `"frontier_llm"` oder `"reasoning_extraction"` trug. `false`, wenn die Antwort keine Kategorie oder einen Wert außerhalb dieses Satzes trug. Nicht vorhanden, wenn `server_fallback_hop` `true` ist, da Hop-Blöcke keine `stop_details` tragen.

748* `has_explanation`: `true`, wenn die API-Antwort eine `stop_details.explanation` trug, andernfalls `false`. Nicht vorhanden, wenn `server_fallback_hop` `true` ist.748* `has_explanation`: `true`, wenn die API-Antwort eine `stop_details.explanation` trug, andernfalls `false`. Nicht vorhanden, wenn `server_fallback_hop` `true` ist.

945* `plugin_id_hash`: Deterministische Hash des Plugin-Namens und des Marketplace, nur an Ihren konfigurierten Exporter gesendet. Ermöglicht es Ihnen, zu zählen, wie viele unterschiedliche Drittanbieter-Plugins über Ihre gesamte Flotte hinweg geladen sind, ohne ihre Namen aufzuzeichnen945* `plugin_id_hash`: Deterministische Hash des Plugin-Namens und des Marketplace, nur an Ihren konfigurierten Exporter gesendet. Ermöglicht es Ihnen, zu zählen, wie viele unterschiedliche Drittanbieter-Plugins über Ihre gesamte Flotte hinweg geladen sind, ohne ihre Namen aufzuzeichnen

946* `has_hooks`: Ob das Plugin Hooks beiträgt946* `has_hooks`: Ob das Plugin Hooks beiträgt

947* `has_mcp`: Ob das Plugin MCP-Server beiträgt947* `has_mcp`: Ob das Plugin MCP-Server beiträgt

948* `host_owned_mcp`: `true`, wenn der SDK-Host die MCP-Verbindungen dieses Plugins verwaltet und Claude Code das Lesen der MCP-Server-Konfiguration des Plugins übersprungen hat, `false` andernfalls. {/* min-version: 2.1.172 */}Erfordert Claude Code v2.1.172 oder später948* `host_owned_mcp`: `true`, wenn der SDK-Host die MCP-Verbindungen dieses Plugins verwaltet und Claude Code das Lesen der MCP-Server-Konfiguration des Plugins übersprungen hat, `false` andernfalls. Erfordert Claude Code v2.1.172 oder später

949* `skill_path_count`: Anzahl der Skill-Verzeichnisse, die das Plugin deklariert949* `skill_path_count`: Anzahl der Skill-Verzeichnisse, die das Plugin deklariert

950* `command_path_count`: Anzahl der Befehlsverzeichnisse, die das Plugin deklariert950* `command_path_count`: Anzahl der Befehlsverzeichnisse, die das Plugin deklariert

951* `agent_path_count`: Anzahl der Agent-Verzeichnisse, die das Plugin deklariert951* `agent_path_count`: Anzahl der Agent-Verzeichnisse, die das Plugin deklariert

952* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/de/cli-reference) gestartet wurde, `"false"` andernfalls. Im sicheren Modus meldet dieses Ereignis nur die konfigurierte Inventur; die Befehle, Skills, Hooks und MCP-Server des Plugins werden nicht geladen. {/* min-version: 2.1.169 */}Erfordert Claude Code v2.1.169 oder später952* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Im sicheren Modus meldet dieses Ereignis nur die konfigurierte Inventur; die Befehle, Skills, Hooks und MCP-Server des Plugins werden nicht geladen. Erfordert Claude Code v2.1.169 oder später

953 953

954<h4 id="skill-activated-event">954<h4 id="skill-activated-event">

955 Skill-Aktiviert-Ereignis955 Skill-Aktiviert-Ereignis

1027* `hook_event`: Hook-Ereignistyp, z. B. `"PreToolUse"` oder `"PostToolUse"`1027* `hook_event`: Hook-Ereignistyp, z. B. `"PreToolUse"` oder `"PostToolUse"`

1028* `hook_type`: Hook-Implementierungstyp: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` oder `"agent"`1028* `hook_type`: Hook-Implementierungstyp: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` oder `"agent"`

1029* `hook_source`: Wo der Hook definiert ist: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` oder `"pluginHook"`1029* `hook_source`: Wo der Hook definiert ist: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` oder `"pluginHook"`

1030* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/de/cli-reference) gestartet wurde, `"false"` andernfalls. {/* min-version: 2.1.169 */}Erfordert Claude Code v2.1.169 oder später1030* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Erfordert Claude Code v2.1.169 oder später

1031* `hook_matcher` (wenn `OTEL_LOG_TOOL_DETAILS=1`): Die Matcher-Zeichenkette aus der Hook-Konfiguration, wenn eine gesetzt ist1031* `hook_matcher` (wenn `OTEL_LOG_TOOL_DETAILS=1`): Die Matcher-Zeichenkette aus der Hook-Konfiguration, wenn eine gesetzt ist

1032* `plugin.name` (wenn `hook_source` `"pluginHook"` ist): Name des beitragenden Plugins. Für Plugins außerhalb des offiziellen Marketplace und des integrierten Bundles ist der Wert `"third-party"`, es sei denn, `OTEL_LOG_TOOL_DETAILS=1`1032* `plugin.name` (wenn `hook_source` `"pluginHook"` ist): Name des beitragenden Plugins. Für Plugins außerhalb des offiziellen Marketplace und des integrierten Bundles ist der Wert `"third-party"`, es sei denn, `OTEL_LOG_TOOL_DETAILS=1`

1033* `plugin_id_hash` (wenn `hook_source` `"pluginHook"` ist): Deterministische Hash des Plugin-Namens und des Marketplace, nur an Ihren konfigurierten Exporter gesendet. Ermöglicht es Ihnen, unterschiedliche beitragende Plugins zu zählen, ohne ihre Namen aufzuzeichnen1033* `plugin_id_hash` (wenn `hook_source` `"pluginHook"` ist): Deterministische Hash des Plugin-Namens und des Marketplace, nur an Ihren konfigurierten Exporter gesendet. Ermöglicht es Ihnen, unterschiedliche beitragende Plugins zu zählen, ohne ihre Namen aufzuzeichnen

1051* `num_hooks`: Anzahl der übereinstimmenden Hook-Befehle1051* `num_hooks`: Anzahl der übereinstimmenden Hook-Befehle

1052* `managed_only`: `"true"`, wenn nur verwaltete Richtlinien-Hooks zulässig sind1052* `managed_only`: `"true"`, wenn nur verwaltete Richtlinien-Hooks zulässig sind

1053* `hook_source`: `"policySettings"` oder `"merged"`1053* `hook_source`: `"policySettings"` oder `"merged"`

1054* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/de/cli-reference) gestartet wurde, `"false"` andernfalls. {/* min-version: 2.1.169 */}Erfordert Claude Code v2.1.169 oder später1054* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Erfordert Claude Code v2.1.169 oder später

1055* `hook_definitions`: JSON-serialisierte Hook-Konfiguration. Nur enthalten, wenn sowohl detailliertes Beta-Tracing als auch `OTEL_LOG_TOOL_DETAILS=1` aktiviert sind1055* `hook_definitions`: JSON-serialisierte Hook-Konfiguration. Nur enthalten, wenn sowohl detailliertes Beta-Tracing als auch `OTEL_LOG_TOOL_DETAILS=1` aktiviert sind

1056 1056

1057<h4 id="hook-execution-complete-event">1057<h4 id="hook-execution-complete-event">

1078* `total_duration_ms`: Wanduhr-Dauer aller übereinstimmenden Hooks1078* `total_duration_ms`: Wanduhr-Dauer aller übereinstimmenden Hooks

1079* `managed_only`: `"true"`, wenn nur verwaltete Richtlinien-Hooks zulässig sind1079* `managed_only`: `"true"`, wenn nur verwaltete Richtlinien-Hooks zulässig sind

1080* `hook_source`: `"policySettings"` oder `"merged"`1080* `hook_source`: `"policySettings"` oder `"merged"`

1081* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/de/cli-reference) gestartet wurde, `"false"` andernfalls. {/* min-version: 2.1.169 */}Erfordert Claude Code v2.1.169 oder später1081* `safe_mode`: `"true"`, wenn die Sitzung mit [`--safe-mode`](/docs/de/cli-reference) gestartet wurde, `"false"` andernfalls. Erfordert Claude Code v2.1.169 oder später

1082* `hook_definitions`: JSON-serialisierte Hook-Konfiguration. Nur enthalten, wenn sowohl detailliertes Beta-Tracing als auch `OTEL_LOG_TOOL_DETAILS=1` aktiviert sind1082* `hook_definitions`: JSON-serialisierte Hook-Konfiguration. Nur enthalten, wenn sowohl detailliertes Beta-Tracing als auch `OTEL_LOG_TOOL_DETAILS=1` aktiviert sind

1083 1083

1084<h4 id="hook-plugin-metrics-event">1084<h4 id="hook-plugin-metrics-event">

1119* `pre_tokens`: Ungefähre Token-Anzahl vor Kompaktierung1119* `pre_tokens`: Ungefähre Token-Anzahl vor Kompaktierung

1120* `post_tokens`: Ungefähre Token-Anzahl nach Kompaktierung1120* `post_tokens`: Ungefähre Token-Anzahl nach Kompaktierung

1121* `error`: Fehlermeldung, wenn Kompaktierung fehlgeschlagen ist1121* `error`: Fehlermeldung, wenn Kompaktierung fehlgeschlagen ist

1122* `precompute_reuse`: Nur gesetzt, wenn `trigger` `"manual"` ist. Auto-Kompaktierung kann eine Zusammenfassung im Hintergrund vorbereiten, bevor das Kontextfenster voll wird, und dieses Attribut zeichnet auf, ob `/compact` diese vorbereitete Zusammenfassung wiederverwendet hat. `"hit"` bedeutet, dass sie wiederverwendet wurde; `"miss_custom_instructions"`, `"miss_hook"` und `"miss_not_ready"` geben den Grund an, warum stattdessen eine neue Zusammenfassung berechnet wurde. {/* min-version: 2.1.153 */}Erfordert Claude Code v2.1.153 oder später1122* `precompute_reuse`: Nur gesetzt, wenn `trigger` `"manual"` ist. Auto-Kompaktierung kann eine Zusammenfassung im Hintergrund vorbereiten, bevor das Kontextfenster voll wird, und dieses Attribut zeichnet auf, ob `/compact` diese vorbereitete Zusammenfassung wiederverwendet hat. `"hit"` bedeutet, dass sie wiederverwendet wurde; `"miss_custom_instructions"`, `"miss_hook"` und `"miss_not_ready"` geben den Grund an, warum stattdessen eine neue Zusammenfassung berechnet wurde. Erfordert Claude Code v2.1.153 oder später

1123 1123

1124<h4 id="feedback-survey-event">1124<h4 id="feedback-survey-event">

1125 Feedback-Umfrage-Ereignis1125 Feedback-Umfrage-Ereignis

1126</h4>1126</h4>

1127 1127

1128Protokolliert, wenn eine Sitzungsqualitäts-Umfrage angezeigt oder beantwortet wird. Siehe [Sitzungsqualitäts-Umfragen](/de/data-usage#session-quality-surveys) für das, was die Umfragen erfassen und wie Sie sie steuern.1128Protokolliert, wenn eine Sitzungsqualitäts-Umfrage angezeigt oder beantwortet wird. Siehe [Sitzungsqualitäts-Umfragen](/docs/de/data-usage#session-quality-surveys) für das, was die Umfragen erfassen und wie Sie sie steuern.

1129 1129

1130**Ereignisname**: `claude_code.feedback_survey`1130**Ereignisname**: `claude_code.feedback_survey`

1131 1131

1139* `appearance_id`: Eindeutige ID, die die Ereignisse verknüpft, die für eine Umfrage-Instanz ausgegeben werden1139* `appearance_id`: Eindeutige ID, die die Ereignisse verknüpft, die für eine Umfrage-Instanz ausgegeben werden

1140* `survey_type`: Welche Umfrage das Ereignis erzeugt hat. `"session"` ist die Aufforderung "Wie macht sich Claude?" Bewertung1140* `survey_type`: Welche Umfrage das Ereignis erzeugt hat. `"session"` ist die Aufforderung "Wie macht sich Claude?" Bewertung

1141* `response`: Die Auswahl des Benutzers bei `responded` Ereignissen1141* `response`: Die Auswahl des Benutzers bei `responded` Ereignissen

1142* `enabled_via_override`: `true`, wenn [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/de/env-vars) gesetzt ist. Wird als boolescher Wert ausgegeben, nicht als Zeichenkette. Vorhanden bei `session` Umfrage-Ereignissen. Filtern Sie nach diesem Attribut, um zu bestätigen, dass die Überschreibung über eine Flotte angewendet wird1142* `enabled_via_override`: `true`, wenn [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/de/env-vars) gesetzt ist. Wird als boolescher Wert ausgegeben, nicht als Zeichenkette. Vorhanden bei `session` Umfrage-Ereignissen. Filtern Sie nach diesem Attribut, um zu bestätigen, dass die Überschreibung über eine Flotte angewendet wird

1143 1143

1144<h2 id="interpret-metrics-and-events-data">1144<h2 id="interpret-metrics-and-events-data">

1145 Interpretation von Metriken- und Ereignisdaten1145 Interpretation von Metriken- und Ereignisdaten

1182* Ungewöhnlicher Token-Verbrauch1182* Ungewöhnlicher Token-Verbrauch

1183* Hohes Sitzungsvolumen von bestimmten Benutzern1183* Hohes Sitzungsvolumen von bestimmten Benutzern

1184 1184

1185Alle Metriken können nach den [Standard-Attributen](#standard-attributes) segmentiert werden. Das Attribut `model` ist auf `claude_code.token.usage`, `claude_code.cost.usage` und {/* min-version: 2.1.172 */}ab v2.1.172 auf `claude_code.lines_of_code.count` verfügbar.1185Alle Metriken können nach den [Standard-Attributen](#standard-attributes) segmentiert werden. Das Attribut `model` ist auf `claude_code.token.usage`, `claude_code.cost.usage` und ab v2.1.172 auf `claude_code.lines_of_code.count` verfügbar.

1186 1186

1187Aufschlüsselungen pro Modell von Commits können nur durch Verknüpfung mit den Token- oder Kostenmetriken auf `session.id` angenähert werden, da eine Sitzung mehrere Modelle umfassen kann. Filtern Sie die Token- oder Kostenseite auf Zeilen, bei denen `query_source` `"main"` ist, damit Hilfs- und Subagent-Anfragen die Commits der Sitzung nicht einem Modell zuordnen, das sie nicht erstellt hat.1187Aufschlüsselungen pro Modell von Commits können nur durch Verknüpfung mit den Token- oder Kostenmetriken auf `session.id` angenähert werden, da eine Sitzung mehrere Modelle umfassen kann. Filtern Sie die Token- oder Kostenseite auf Zeilen, bei denen `query_source` `"main"` ist, damit Hilfs- und Subagent-Anfragen die Commits der Sitzung nicht einem Modell zuordnen, das sie nicht erstellt hat.

1188 1188

1192 1192

1193Claude Code wiederholt fehlgeschlagene API-Anfragen intern und gibt nur nach dem Aufgeben ein einzelnes `claude_code.api_error` Ereignis aus, daher ist das Ereignis selbst das Endsignal für diese Anfrage. Zwischenzeitliche Wiederholungsversuche werden nicht als separate Ereignisse protokolliert.1193Claude Code wiederholt fehlgeschlagene API-Anfragen intern und gibt nur nach dem Aufgeben ein einzelnes `claude_code.api_error` Ereignis aus, daher ist das Ereignis selbst das Endsignal für diese Anfrage. Zwischenzeitliche Wiederholungsversuche werden nicht als separate Ereignisse protokolliert.

1194 1194

1195Das Attribut `attempt` auf dem Ereignis zeichnet auf, wie viele Versuche insgesamt unternommen wurden. `CLAUDE_CODE_MAX_RETRIES` hat einen Standardwert von 10 und ist auf 15 begrenzt; {/* min-version: 2.1.199 */}ab v2.1.199 erhöht `CLAUDE_CODE_RETRY_WATCHDOG` den Standardwert und entfernt die Obergrenze. Wenn die Anfrage alle Wiederholungen bei einem vorübergehenden Fehler erschöpft, ist `attempt` um eins höher als dieses effektive Limit: 11 standardmäßig und nie mehr als 16, es sei denn, der Watchdog ist gesetzt. Ein niedrigerer Wert zeigt einen nicht wiederholbaren Fehler wie eine `400` Antwort an.1195Das Attribut `attempt` auf dem Ereignis zeichnet auf, wie viele Versuche insgesamt unternommen wurden. `CLAUDE_CODE_MAX_RETRIES` hat einen Standardwert von 10 und ist auf 15 begrenzt; ab v2.1.199 erhöht `CLAUDE_CODE_RETRY_WATCHDOG` den Standardwert und entfernt die Obergrenze. Wenn die Anfrage alle Wiederholungen bei einem vorübergehenden Fehler erschöpft, ist `attempt` um eins höher als dieses effektive Limit: 11 standardmäßig und nie mehr als 16, es sei denn, der Watchdog ist gesetzt. Ein niedrigerer Wert zeigt einen nicht wiederholbaren Fehler wie eine `400` Antwort an.

1196 1196

1197Um eine Sitzung zu unterscheiden, die sich von einer, die steckengeblieben ist, erholt hat, gruppieren Sie Ereignisse nach `session.id` und prüfen Sie, ob ein späteres `api_request` Ereignis nach dem Fehler vorhanden ist.1197Um eine Sitzung zu unterscheiden, die sich von einer, die steckengeblieben ist, erholt hat, gruppieren Sie Ereignisse nach `session.id` und prüfen Sie, ob ein späteres `api_request` Ereignis nach dem Fehler vorhanden ist.

1198 1198

1221 Attribut-Aktionen an Benutzer1221 Attribut-Aktionen an Benutzer

1222</h3>1222</h3>

1223 1223

1224Die [Standardattribute](#standard-attributes) auf jedem Ereignis enthalten die Identität des authentifizierten Benutzers: `user.email`, `user.account_uuid`, `user.account_id` und `organization.id`, wenn mit einem Claude-Konto angemeldet, plus `user.id` und die pro-Sitzung `session.id`. `user.id` ist ein installationsbegrenzter Bezeichner, außer bei [Claude apps gateway](/de/claude-apps-gateway)-Sitzungen, wo es das IdP-Subjekt aus dem vom Gateway ausgegebenen Token ist.1224Die [Standardattribute](#standard-attributes) auf jedem Ereignis enthalten die Identität des authentifizierten Benutzers: `user.email`, `user.account_uuid`, `user.account_id` und `organization.id`, wenn mit einem Claude-Konto angemeldet, plus `user.id` und die pro-Sitzung `session.id`. `user.id` ist ein installationsbegrenzter Bezeichner, außer bei [Claude apps gateway](/docs/de/claude-apps-gateway)-Sitzungen, wo es das IdP-Subjekt aus dem vom Gateway ausgegebenen Token ist.

1225 1225

1226MCP-Tool-Aufrufe, Bash-Befehle und Dateibearbeitungen werden daher dem Entwickler zugeordnet, der die Sitzung gestartet hat. Claude Code handelt nicht unter einem separaten Service-Konto; die Identität, die auf jedem Ereignis aufgezeichnet wird, ist das Claude-Konto des Entwicklers selbst, oder die IdP-Identität des Entwicklers bei einer [Claude apps gateway](/de/claude-apps-gateway)-Sitzung.1226MCP-Tool-Aufrufe, Bash-Befehle und Dateibearbeitungen werden daher dem Entwickler zugeordnet, der die Sitzung gestartet hat. Claude Code handelt nicht unter einem separaten Service-Konto; die Identität, die auf jedem Ereignis aufgezeichnet wird, ist das Claude-Konto des Entwicklers selbst, oder die IdP-Identität des Entwicklers bei einer [Claude apps gateway](/docs/de/claude-apps-gateway)-Sitzung.

1227 1227

1228Wenn Claude Code sich mit einem direkten API-Schlüssel authentifiziert oder gegen Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry, gibt es kein Claude-Konto in der Sitzung und nur `user.id` und `session.id` werden gefüllt. In diesen Bereitstellungen fügen Sie die Benutzeridentität selbst mit `OTEL_RESOURCE_ATTRIBUTES` hinzu, die pro Benutzer über die [verwaltete Einstellungsdatei](#administrator-configuration) oder einen Launch-Wrapper gesetzt wird. Claude apps gateway-Sitzungen benötigen nichts davon: Die CLI stempelt die IdP-Identität automatisch ab, wie in [Standardattribute](#standard-attributes) beschrieben.1228Wenn Claude Code sich mit einem direkten API-Schlüssel authentifiziert oder gegen Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry, gibt es kein Claude-Konto in der Sitzung und nur `user.id` und `session.id` werden gefüllt. In diesen Bereitstellungen fügen Sie die Benutzeridentität selbst mit `OTEL_RESOURCE_ATTRIBUTES` hinzu, die pro Benutzer über die [verwaltete Einstellungsdatei](#administrator-configuration) oder einen Launch-Wrapper gesetzt wird. Claude apps gateway-Sitzungen benötigen nichts davon: Die CLI stempelt die IdP-Identität automatisch ab, wie in [Standardattribute](#standard-attributes) beschrieben.

1229 1229

1343 Sicherheit und Datenschutz1343 Sicherheit und Datenschutz

1344</h2>1344</h2>

1345 1345

1346* OpenTelemetry-Export zu Ihrem Backend ist opt-in und erfordert explizite Konfiguration. Informationen zu Anthropics separater operativer Telemetrie und wie Sie diese deaktivieren, finden Sie unter [Datennutzung](/de/data-usage#telemetry-services)1346* OpenTelemetry-Export zu Ihrem Backend ist opt-in und erfordert explizite Konfiguration. Informationen zu Anthropics separater operativer Telemetrie und wie Sie diese deaktivieren, finden Sie unter [Datennutzung](/docs/de/data-usage#telemetry-services)

1347* Rohe Dateiinhalte und Code-Snippets sind nicht in Metriken oder Ereignissen enthalten. Trace-Spans sind ein separater Datenpfad: siehe die Aufzählung `OTEL_LOG_TOOL_CONTENT` unten1347* Rohe Dateiinhalte und Code-Snippets sind nicht in Metriken oder Ereignissen enthalten. Trace-Spans sind ein separater Datenpfad: siehe die Aufzählung `OTEL_LOG_TOOL_CONTENT` unten

1348* Wenn über OAuth authentifiziert, ist `user.email` in Telemetrie-Attributen enthalten. Wenn dies ein Problem für Ihre Organisation darstellt, arbeiten Sie mit Ihrem Telemetrie-Backend zusammen, um dieses Feld zu filtern oder zu schwärzen1348* Wenn über OAuth authentifiziert, ist `user.email` in Telemetrie-Attributen enthalten. Wenn dies ein Problem für Ihre Organisation darstellt, arbeiten Sie mit Ihrem Telemetrie-Backend zusammen, um dieses Feld zu filtern oder zu schwärzen

1349* Benutzer-Prompt-Inhalte werden standardmäßig nicht erfasst. Nur die Prompt-Länge wird aufgezeichnet. Um Benutzer-Prompt-Inhalte einzubeziehen, setzen Sie `OTEL_LOG_USER_PROMPTS=1`1349* Benutzer-Prompt-Inhalte werden standardmäßig nicht erfasst. Nur die Prompt-Länge wird aufgezeichnet. Um Benutzer-Prompt-Inhalte einzubeziehen, setzen Sie `OTEL_LOG_USER_PROMPTS=1`

network-config.md +15 −15

Details

9Claude Code unterstützt verschiedene Enterprise-Netzwerk- und Sicherheitskonfigurationen über Umgebungsvariablen. Dies umfasst das Routing von Datenverkehr über unternehmenseigene Proxy-Server, das Vertrauen in benutzerdefinierte Zertifizierungsstellen (CA) und die Authentifizierung mit gegenseitigen Transport Layer Security (mTLS)-Zertifikaten für erhöhte Sicherheit.9Claude Code unterstützt verschiedene Enterprise-Netzwerk- und Sicherheitskonfigurationen über Umgebungsvariablen. Dies umfasst das Routing von Datenverkehr über unternehmenseigene Proxy-Server, das Vertrauen in benutzerdefinierte Zertifizierungsstellen (CA) und die Authentifizierung mit gegenseitigen Transport Layer Security (mTLS)-Zertifikaten für erhöhte Sicherheit.

10 10

11<Note>11<Note>

~~12 Alle auf dieser Seite gezeigten Umgebungsvariablen können auch in [`settings.json`](/de/settings) konfiguriert werden.~~12 Alle auf dieser Seite gezeigten Umgebungsvariablen können auch in [`settings.json`](/docs/de/settings) konfiguriert werden.

13</Note>13</Note>

14 14

15<h2 id="proxy-configuration">15<h2 id="proxy-configuration">

126| `mcp-proxy.anthropic.com` | [MCP-Konnektoren von claude.ai](/de/mcp#use-mcp-servers-from-claude-ai), einschließlich Konnektoren, die ein Organisationsadministrator konfiguriert. Der Konnektordatenverkehr wird über diesen Proxy weitergeleitet; Konnektoren sind standardmäßig für claude.ai-authentifizierte Benutzer aktiviert. Zum Deaktivieren setzen Sie [`ENABLE_CLAUDEAI_MCP_SERVERS=false`](/de/env-vars) oder die Einstellung [`disableClaudeAiConnectors`](/de/settings#available-settings) |126| `mcp-proxy.anthropic.com` | [MCP-Konnektoren von claude.ai](/docs/de/mcp#use-mcp-servers-from-claude-ai), einschließlich Konnektoren, die ein Organisationsadministrator konfiguriert. Der Konnektordatenverkehr wird über diesen Proxy weitergeleitet; Konnektoren sind standardmäßig für claude.ai-authentifizierte Benutzer aktiviert. Zum Deaktivieren setzen Sie [`ENABLE_CLAUDEAI_MCP_SERVERS=false`](/docs/de/env-vars) oder die Einstellung [`disableClaudeAiConnectors`](/docs/de/settings#available-settings) |

128| `storage.googleapis.com` | Installationszähler und Plugin-Metadaten, die in `/plugin` angezeigt werden. Signierte [Artifact](/de/artifacts)-Uploads versuchen zuerst diesen Host; die Veröffentlichung fällt auf `api.anthropic.com` zurück, wenn dieser blockiert ist |128| `storage.googleapis.com` | Installationszähler und Plugin-Metadaten, die in `/plugin` angezeigt werden. Signierte [Artifact](/docs/de/artifacts)-Uploads versuchen zuerst diesen Host; die Veröffentlichung fällt auf `api.anthropic.com` zurück, wenn dieser blockiert ist |

129| `storage.googleapis.com` | {/* max-version: 2.1.115 */}Nativer Installer und nativer Auto-Updater in Versionen vor 2.1.116 |129| `storage.googleapis.com` | Nativer Installer und nativer Auto-Updater in Versionen vor 2.1.116 |

131| `*.claudeusercontent.com` | Anzeige von [Artifacts](/de/artifacts) auf claude.ai. Der Viewer lädt den Inhalt jedes Artifacts aus einer isolierten Subdomain dieses Ursprungs. Erforderlich im Browser des Viewers, nicht von der CLI selbst |131| `*.claudeusercontent.com` | Anzeige von [Artifacts](/docs/de/artifacts) auf claude.ai. Der Viewer lädt den Inhalt jedes Artifacts aus einer isolierten Subdomain dieses Ursprungs. Erforderlich im Browser des Viewers, nicht von der CLI selbst |

132| `raw.githubusercontent.com` | Changelog-Feed für [`/release-notes`](/de/commands) und die Release Notes, die nach dem Update angezeigt werden |132| `raw.githubusercontent.com` | Changelog-Feed für [`/release-notes`](/docs/de/commands) und die Release Notes, die nach dem Update angezeigt werden |

133 133

134Wenn Sie Claude Code über npm installieren oder Ihre eigene Binärverteilung verwalten, benötigen Endbenutzer nicht den nativen Installer und der Auto-Updater-Einsatz von `downloads.claude.ai`. Die anderen Verwendungen in der Tabelle gelten unabhängig von der Installationsmethode.134Wenn Sie Claude Code über npm installieren oder Ihre eigene Binärverteilung verwalten, benötigen Endbenutzer nicht den nativen Installer und der Auto-Updater-Einsatz von `downloads.claude.ai`. Die anderen Verwendungen in der Tabelle gelten unabhängig von der Installationsmethode.

135 135

136Claude Code sendet standardmäßig optionale operative Telemetrie, die Sie mit Umgebungsvariablen deaktivieren können. Siehe [Telemetrie-Dienste](/de/data-usage#telemetry-services), um zu erfahren, wie Sie diese deaktivieren, bevor Sie Ihre Allowlist finalisieren.136Claude Code sendet standardmäßig optionale operative Telemetrie, die Sie mit Umgebungsvariablen deaktivieren können. Siehe [Telemetrie-Dienste](/docs/de/data-usage#telemetry-services), um zu erfahren, wie Sie diese deaktivieren, bevor Sie Ihre Allowlist finalisieren.

137 137

138Bei Verwendung von [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry) oder einer angemeldeten [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzung geht der Modell-Datenverkehr und die Authentifizierung zu Ihrem Anbieter oder Gateway statt zu `api.anthropic.com`, `claude.ai` oder `platform.claude.com`. Das WebFetch-Tool ruft weiterhin `api.anthropic.com` für seine [Domain-Sicherheitsprüfung](/de/data-usage#webfetch-domain-safety-check) auf, es sei denn, Sie setzen `skipWebFetchPreflight: true` in [Einstellungen](/de/settings).138Bei Verwendung von [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), [Microsoft Foundry](/docs/de/microsoft-foundry) oder einer angemeldeten [Claude Apps Gateway](/docs/de/claude-apps-gateway)-Sitzung geht der Modell-Datenverkehr und die Authentifizierung zu Ihrem Anbieter oder Gateway statt zu `api.anthropic.com`, `claude.ai` oder `platform.claude.com`. Das WebFetch-Tool ruft weiterhin `api.anthropic.com` für seine [Domain-Sicherheitsprüfung](/docs/de/data-usage#webfetch-domain-safety-check) auf, es sei denn, Sie setzen `skipWebFetchPreflight: true` in [Einstellungen](/docs/de/settings).

139 139

140[Claude Code im Web](/de/claude-code-on-the-web) und [Code Review](/de/code-review) verbinden sich von der von Anthropic verwalteten Infrastruktur aus mit Ihren Repositories. Wenn Ihre GitHub Enterprise Cloud-Organisation den Zugriff nach IP-Adresse einschränkt, aktivieren Sie [IP-Allowlist-Vererbung für installierte GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). Die Claude GitHub App registriert ihre IP-Bereiche, sodass die Aktivierung dieser Einstellung den Zugriff ohne manuelle Konfiguration ermöglicht. Um [die Bereiche stattdessen manuell zu Ihrer Allowlist hinzuzufügen](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) oder um andere Firewalls zu konfigurieren, siehe [Anthropic API IP-Adressen](https://platform.claude.com/docs/en/api/ip-addresses).140[Claude Code im Web](/docs/de/claude-code-on-the-web) und [Code Review](/docs/de/code-review) verbinden sich von der von Anthropic verwalteten Infrastruktur aus mit Ihren Repositories. Wenn Ihre GitHub Enterprise Cloud-Organisation den Zugriff nach IP-Adresse einschränkt, aktivieren Sie [IP-Allowlist-Vererbung für installierte GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). Die Claude GitHub App registriert ihre IP-Bereiche, sodass die Aktivierung dieser Einstellung den Zugriff ohne manuelle Konfiguration ermöglicht. Um [die Bereiche stattdessen manuell zu Ihrer Allowlist hinzuzufügen](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) oder um andere Firewalls zu konfigurieren, siehe [Anthropic API IP-Adressen](https://platform.claude.com/docs/en/api/ip-addresses).

141 141

142Für selbstgehostete [GitHub Enterprise Server](/de/github-enterprise-server)-Instanzen hinter einer Firewall müssen Sie die gleichen [Anthropic API IP-Adressen](https://platform.claude.com/docs/en/api/ip-addresses) auf die Allowlist setzen, damit die Anthropic-Infrastruktur Ihren GHES-Host erreichen kann, um Repositories zu klonen und Review-Kommentare zu posten.142Für selbstgehostete [GitHub Enterprise Server](/docs/de/github-enterprise-server)-Instanzen hinter einer Firewall müssen Sie die gleichen [Anthropic API IP-Adressen](https://platform.claude.com/docs/en/api/ip-addresses) auf die Allowlist setzen, damit die Anthropic-Infrastruktur Ihren GHES-Host erreichen kann, um Repositories zu klonen und Review-Kommentare zu posten.

143 143

144<h3 id="desktop-and-claude-ai">144<h3 id="desktop-and-claude-ai">

145 Desktop und claude.ai145 Desktop und claude.ai

146</h3>146</h3>

147 147

148Die vorherige Tabelle behandelt hauptsächlich die eigenständige CLI. Die Claude Desktop-App und claude.ai in einem Browser laden ihren Anwendungscode von zusätzlichen Anthropic CDN-Hosts, einschließlich `assets-proxy.anthropic.com`. Das Zulassen von `claude.ai` bei gleichzeitiger Blockierung dieser Hosts führt zu einer leeren Seite statt zu einem Fehler. Siehe [Netzwerkzugriffanforderungen](/de/desktop#network-access-requirements) auf der Desktop-Seite.148Die vorherige Tabelle behandelt hauptsächlich die eigenständige CLI. Die Claude Desktop-App und claude.ai in einem Browser laden ihren Anwendungscode von zusätzlichen Anthropic CDN-Hosts, einschließlich `assets-proxy.anthropic.com`. Das Zulassen von `claude.ai` bei gleichzeitiger Blockierung dieser Hosts führt zu einer leeren Seite statt zu einem Fehler. Siehe [Netzwerkzugriffanforderungen](/docs/de/desktop#network-access-requirements) auf der Desktop-Seite.

149 149

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

151 Zusätzliche Ressourcen151 Zusätzliche Ressourcen

152</h2>152</h2>

153 153

154* [Claude Code-Einstellungen](/de/settings)154* [Claude Code-Einstellungen](/docs/de/settings)

155* [Referenz für Umgebungsvariablen](/de/env-vars)155* [Referenz für Umgebungsvariablen](/docs/de/env-vars)

156* [Leitfaden zur Fehlerbehebung](/de/troubleshooting)156* [Leitfaden zur Fehlerbehebung](/docs/de/troubleshooting)

output-styles.md +15 −15

Details

10 10

11Ein benutzerdefinierter Ausgabestil fügt Ihre Anweisungen zur Systemaufforderung hinzu und lässt Sie wählen, ob Sie die integrierten Softwareentwicklungsanweisungen von Claude Code beibehalten möchten. Behalten Sie sie, wenn Sie ändern, wie Claude kommuniziert, aber immer noch codiert, z. B. immer mit einem Diagramm antwortet. Lassen Sie sie weg, wenn Claude überhaupt keine Softwareentwicklung durchführt, z. B. als Schreib-Assistent oder Datenanalyst.11Ein benutzerdefinierter Ausgabestil fügt Ihre Anweisungen zur Systemaufforderung hinzu und lässt Sie wählen, ob Sie die integrierten Softwareentwicklungsanweisungen von Claude Code beibehalten möchten. Behalten Sie sie, wenn Sie ändern, wie Claude kommuniziert, aber immer noch codiert, z. B. immer mit einem Diagramm antwortet. Lassen Sie sie weg, wenn Claude überhaupt keine Softwareentwicklung durchführt, z. B. als Schreib-Assistent oder Datenanalyst.

12 12

~~13Für Anweisungen zu Ihrem Projekt, Konventionen oder Ihrer Codebasis verwenden Sie stattdessen [CLAUDE.md](/de/memory).~~13Für Anweisungen zu Ihrem Projekt, Konventionen oder Ihrer Codebasis verwenden Sie stattdessen [CLAUDE.md](/docs/de/memory).

14 14

15<h2 id="built-in-output-styles">15<h2 id="built-in-output-styles">

16 Integrierte Ausgabestile16 Integrierte Ausgabestile

20 20

21Es gibt drei zusätzliche integrierte Ausgabestile:21Es gibt drei zusätzliche integrierte Ausgabestile:

22 22

23* **Proaktiv**: Claude führt sofort aus, trifft vernünftige Annahmen statt bei Routineentscheidungen zu pausieren, und bevorzugt Handeln gegenüber Planung. Dies ist eine stärkere Anleitung zur autonomen Ausführung als [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) bietet, und es funktioniert ohne Änderung Ihres Berechtigungsmodus, sodass Sie vor der Ausführung von Tools weiterhin Berechtigungsaufforderungen sehen.23* **Proaktiv**: Claude führt sofort aus, trifft vernünftige Annahmen statt bei Routineentscheidungen zu pausieren, und bevorzugt Handeln gegenüber Planung. Dies ist eine stärkere Anleitung zur autonomen Ausführung als [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) bietet, und es funktioniert ohne Änderung Ihres Berechtigungsmodus, sodass Sie vor der Ausführung von Tools weiterhin Berechtigungsaufforderungen sehen.

24 24

25* **Explanatory**: Bietet pädagogische „Insights" zwischen der Unterstützung bei Softwareentwicklungsaufgaben. Hilft Ihnen, Implementierungsentscheidungen und Codebase-Muster zu verstehen.25* **Explanatory**: Bietet pädagogische „Insights" zwischen der Unterstützung bei Softwareentwicklungsaufgaben. Hilft Ihnen, Implementierungsentscheidungen und Codebase-Muster zu verstehen.

26 26

30 Ändern Sie Ihren Ausgabestil30 Ändern Sie Ihren Ausgabestil

31</h2>31</h2>

32 32

33Führen Sie `/config` aus und wählen Sie **Output style**, um einen Stil aus einem Menü auszuwählen. Ihre Auswahl wird in `.claude/settings.local.json` auf der [lokalen Projektebene](/de/settings) gespeichert.33Führen Sie `/config` aus und wählen Sie **Output style**, um einen Stil aus einem Menü auszuwählen. Ihre Auswahl wird in `.claude/settings.local.json` auf der [lokalen Projektebene](/docs/de/settings) gespeichert.

34 34

35<Note>{/* max-version: 2.1.90 */}Der eigenständige Befehl `/output-style` wurde in v2.1.73 veraltet und in v2.1.91 entfernt. Verwenden Sie `/config` oder bearbeiten Sie die Einstellung `outputStyle` direkt.</Note>35<Note>Der eigenständige Befehl `/output-style` wurde in v2.1.73 veraltet und in v2.1.91 entfernt. Verwenden Sie `/config` oder bearbeiten Sie die Einstellung `outputStyle` direkt.</Note>

36 36

37Um einen Stil ohne Menü festzulegen, bearbeiten Sie das Feld `outputStyle` direkt in einer Einstellungsdatei:37Um einen Stil ohne Menü festzulegen, bearbeiten Sie das Feld `outputStyle` direkt in einer Einstellungsdatei:

38 38

42}42}

43```43```

44 44

45Der Ausgabestil ist Teil der Systemaufforderung, die Claude Code einmal beim Sitzungsstart liest. Änderungen werden nach `/clear` oder einer neuen Sitzung wirksam. Siehe [Wie Claude Code Prompt Caching nutzt](/de/prompt-caching#changing-output-style), um zu erfahren, was eine Änderung des Ausgabestils für den Cache bewirkt.45Der Ausgabestil ist Teil der Systemaufforderung, die Claude Code einmal beim Sitzungsstart liest. Änderungen werden nach `/clear` oder einer neuen Sitzung wirksam. Siehe [Wie Claude Code Prompt Caching nutzt](/docs/de/prompt-caching#changing-output-style), um zu erfahren, was eine Änderung des Ausgabestils für den Cache bewirkt.

46 46

47<h2 id="create-a-custom-output-style">47<h2 id="create-a-custom-output-style">

48 Erstellen Sie einen benutzerdefinierten Ausgabestil48 Erstellen Sie einen benutzerdefinierten Ausgabestil

56 56

57 * Benutzer: `~/.claude/output-styles`57 * Benutzer: `~/.claude/output-styles`

58 * Projekt: `.claude/output-styles`58 * Projekt: `.claude/output-styles`

~~59 * Verwaltete Richtlinie: `.claude/output-styles` im [Verzeichnis für verwaltete Einstellungen](/de/settings#settings-files)~~59 * Verwaltete Richtlinie: `.claude/output-styles` im [Verzeichnis für verwaltete Einstellungen](/docs/de/settings#settings-files)

60 60

61 Projekt-Ausgabestile werden aus jedem `.claude/output-styles/` zwischen dem Arbeitsverzeichnis und dem Repository-Root geladen. {/* min-version: 2.1.178 */}Ab v2.1.178 verwendet Claude Code, wenn mehr als eines dieser verschachtelten Verzeichnisse einen Stil mit demselben Namen definiert, denjenigen, der dem Arbeitsverzeichnis am nächsten ist.61 Projekt-Ausgabestile werden aus jedem `.claude/output-styles/` zwischen dem Arbeitsverzeichnis und dem Repository-Root geladen. Ab v2.1.178 verwendet Claude Code, wenn mehr als eines dieser verschachtelten Verzeichnisse einen Stil mit demselben Namen definiert, denjenigen, der dem Arbeitsverzeichnis am nächsten ist.

62 </Step>62 </Step>

63 63

64 <Step title="Fügen Sie Frontmatter und Anweisungen hinzu">64 <Step title="Fügen Sie Frontmatter und Anweisungen hinzu">

86 </Step>86 </Step>

87</Steps>87</Steps>

88 88

~~89[Plugins](/de/plugins-reference) können auch Ausgabestile in einem `output-styles/`-Verzeichnis bereitstellen.~~89[Plugins](/docs/de/plugins-reference) können auch Ausgabestile in einem `output-styles/`-Verzeichnis bereitstellen.

90 90

91<h3 id="frontmatter">91<h3 id="frontmatter">

92 Frontmatter92 Frontmatter

123| :----------------------- | :--------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- |123| :----------------------- | :--------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- |

127| [Agents](/de/sub-agents) | Führt einen Subagent mit seiner eigenen Systemaufforderung, seinem Modell und seinen Tools aus | Sie möchten einen separat definierten Helper für eine fokussierte Aufgabe |127| [Agents](/docs/de/sub-agents) | Führt einen Subagent mit seiner eigenen Systemaufforderung, seinem Modell und seinen Tools aus | Sie möchten einen separat definierten Helper für eine fokussierte Aufgabe |

129 129

130<h2 id="related-resources">130<h2 id="related-resources">

131 Verwandte Ressourcen131 Verwandte Ressourcen

132</h2>132</h2>

133 133

134* [Settings](/de/settings): wo das Feld `outputStyle` lebt und wie die Einstellungspriorität funktioniert134* [Settings](/docs/de/settings): wo das Feld `outputStyle` lebt und wie die Einstellungspriorität funktioniert

135* [Permission modes](/de/permission-modes): wie der Proactive-Stil den Auto-Modus vergleicht135* [Permission modes](/docs/de/permission-modes): wie der Proactive-Stil den Auto-Modus vergleicht

136* [Plugins](/de/plugins): Verpacken und verteilen Sie Ausgabestile zusammen mit Skills, Hooks und Agents136* [Plugins](/docs/de/plugins): Verpacken und verteilen Sie Ausgabestile zusammen mit Skills, Hooks und Agents

137* [Debug your configuration](/de/debug-your-config): Diagnostizieren Sie, warum ein Ausgabestil nicht wirksam wird137* [Debug your configuration](/docs/de/debug-your-config): Diagnostizieren Sie, warum ein Ausgabestil nicht wirksam wird

permission-modes.md +61 −61

Details

27 27

28In jedem Modus außer `bypassPermissions` werden Schreibvorgänge in [geschützte Pfade](#protected-paths) niemals automatisch genehmigt, um den Repository-Status und die Claude-Konfiguration vor versehentlicher Beschädigung zu schützen.28In jedem Modus außer `bypassPermissions` werden Schreibvorgänge in [geschützte Pfade](#protected-paths) niemals automatisch genehmigt, um den Repository-Status und die Claude-Konfiguration vor versehentlicher Beschädigung zu schützen.

29 29

30Modi legen die Grundlage fest. Überlagern Sie [Berechtigungsregeln](/de/permissions#manage-permissions) darauf, um bestimmte Tools vorab zu genehmigen oder zu blockieren. Ablehnungsregeln, explizite Aufforderungsregeln, die [Organisationseinstellung `ask` für Connector-Tools](/de/mcp#organization-controls-on-connector-tools) und der [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool)-Marker gelten in jedem Modus, einschließlich `bypassPermissions`. Genehmigungsregeln haben keine Auswirkung in diesem Modus, da alles andere bereits genehmigt ist.30Modi legen die Grundlage fest. Überlagern Sie [Berechtigungsregeln](/docs/de/permissions#manage-permissions) darauf, um bestimmte Tools vorab zu genehmigen oder zu blockieren. Ablehnungsregeln, explizite Aufforderungsregeln, die [Organisationseinstellung `ask` für Connector-Tools](/docs/de/mcp#organization-controls-on-connector-tools) und der [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool)-Marker gelten in jedem Modus, einschließlich `bypassPermissions`. Genehmigungsregeln haben keine Auswirkung in diesem Modus, da alles andere bereits genehmigt ist.

31 31

32<h2 id="switch-permission-modes">32<h2 id="switch-permission-modes">

33 Berechtigungsmodi wechseln33 Berechtigungsmodi wechseln

37 37

38<Tabs>38<Tabs>

39 <Tab title="CLI">39 <Tab title="CLI">

40 **Während einer Sitzung**: Drücken Sie `Shift+Tab`, um zwischen `default` → `acceptEdits` → `plan` zu wechseln. Der aktuelle Modus wird in der Statusleiste angezeigt. {/* min-version: 2.1.203 */}Der manuelle Modus, `default` in diesem Zyklus, zeigt ein graues `⏸ manual mode on` Badge. Vor v2.1.203 zeigte die Statusleiste im manuellen Modus kein Badge an.40 **Während einer Sitzung**: Drücken Sie `Shift+Tab`, um zwischen `default` → `acceptEdits` → `plan` zu wechseln. Der aktuelle Modus wird in der Statusleiste angezeigt. Der manuelle Modus, `default` in diesem Zyklus, zeigt ein graues `⏸ manual mode on` Badge. Vor v2.1.203 zeigte die Statusleiste im manuellen Modus kein Badge an.

41 41

42 Nicht jeder Modus ist im Standard-Zyklus enthalten:42 Nicht jeder Modus ist im Standard-Zyklus enthalten:

43 43

53 claude --permission-mode plan53 claude --permission-mode plan

54 ```54 ```

55 55

~~56 **Als Standard**: Legen Sie `defaultMode` in [Einstellungen](/de/settings#settings-files) fest.~~56 **Als Standard**: Legen Sie `defaultMode` in [Einstellungen](/docs/de/settings#settings-files) fest.

57 57

58 ```json theme={null}58 ```json theme={null}

59 {59 {

63 }63 }

64 ```64 ```

65 65

~~66 Das gleiche `--permission-mode` Flag funktioniert mit `-p` für [nicht-interaktive Ausführungen](/de/headless).~~66 Das gleiche `--permission-mode` Flag funktioniert mit `-p` für [nicht-interaktive Ausführungen](/docs/de/headless).

67 </Tab>67 </Tab>

68 68

69 <Tab title="VS Code">69 <Tab title="VS Code">

83 83

84 Vor v2.1.205 bezeichnete die Erweiterung `plan` als Plan mode und `auto` als Auto mode.84 Vor v2.1.205 bezeichnete die Erweiterung `plan` als Plan mode und `auto` als Auto mode.

85 85

86 Der Auto-Modus wird im Modusindikator angezeigt, wenn Ihr Konto alle Anforderungen erfüllt, die im [Auto-Modus-Abschnitt](#eliminate-prompts-with-auto-mode) aufgelistet sind. Die Einstellung `claudeCode.initialPermissionMode` akzeptiert nicht `auto`. Um standardmäßig im Auto-Modus zu starten, legen Sie stattdessen `defaultMode` in Ihren [Benutzereinstellungen](/de/settings#settings-files) fest. Claude Code ignoriert `defaultMode: "auto"` in Projekt- und lokalen Einstellungen.86 Der Auto-Modus wird im Modusindikator angezeigt, wenn Ihr Konto alle Anforderungen erfüllt, die im [Auto-Modus-Abschnitt](#eliminate-prompts-with-auto-mode) aufgelistet sind. Die Einstellung `claudeCode.initialPermissionMode` akzeptiert nicht `auto`. Um standardmäßig im Auto-Modus zu starten, legen Sie stattdessen `defaultMode` in Ihren [Benutzereinstellungen](/docs/de/settings#settings-files) fest. Claude Code ignoriert `defaultMode: "auto"` in Projekt- und lokalen Einstellungen.

87 87

88 Bypass permissions erfordert den Schalter **Allow dangerously skip permissions** in den Erweiterungseinstellungen, bevor er im Modusindikator angezeigt wird.88 Bypass permissions erfordert den Schalter **Allow dangerously skip permissions** in den Erweiterungseinstellungen, bevor er im Modusindikator angezeigt wird.

89 89

~~90 Weitere Informationen finden Sie im [VS Code-Leitfaden](/de/vs-code).~~90 Weitere Informationen finden Sie im [VS Code-Leitfaden](/docs/de/vs-code).

91 </Tab>91 </Tab>

92 92

93 <Tab title="JetBrains">93 <Tab title="JetBrains">

100 * **Auto**: wird angezeigt, wenn Ihr Konto die [Anforderungen für den Auto-Modus](#eliminate-prompts-with-auto-mode) erfüllt100 * **Auto**: wird angezeigt, wenn Ihr Konto die [Anforderungen für den Auto-Modus](#eliminate-prompts-with-auto-mode) erfüllt

101 * **Bypass permissions**: erfordert den Schalter **Allow bypass permissions mode** in den Desktop-Einstellungen für Pro- und Max-Pläne; bei Team- und Enterprise-Plänen wird dies stattdessen durch die Organisationsrichtlinie gesteuert101 * **Bypass permissions**: erfordert den Schalter **Allow bypass permissions mode** in den Desktop-Einstellungen für Pro- und Max-Pläne; bei Team- und Enterprise-Plänen wird dies stattdessen durch die Organisationsrichtlinie gesteuert

102 102

103 Weitere Desktop-spezifische Details finden Sie unter [Berechtigungsmodus wählen](/de/desktop#choose-a-permission-mode) im Desktop-Leitfaden.103 Weitere Desktop-spezifische Details finden Sie unter [Berechtigungsmodus wählen](/docs/de/desktop#choose-a-permission-mode) im Desktop-Leitfaden.

104 104

105 **Als Standard**: Legen Sie `defaultMode` in [Einstellungen](/de/settings#settings-files) fest. Die Desktop-App liest die gleichen Einstellungsdateien wie die CLI und wendet den Modus auf neue lokale Sitzungen an.105 **Als Standard**: Legen Sie `defaultMode` in [Einstellungen](/docs/de/settings#settings-files) fest. Die Desktop-App liest die gleichen Einstellungsdateien wie die CLI und wendet den Modus auf neue lokale Sitzungen an.

106 106

107 Ein Modus, den Sie im Moduswahlschalter auswählen, wird pro Ordner gespeichert und hat Vorrang vor `defaultMode` für diesen Ordner. Plan ist die Ausnahme: Das Auswählen gilt nur für die aktuelle Sitzung.107 Ein Modus, den Sie im Moduswahlschalter auswählen, wird pro Ordner gespeichert und hat Vorrang vor `defaultMode` für diesen Ordner. Plan ist die Ausnahme: Das Auswählen gilt nur für die aktuelle Sitzung.

108 108

120 <Tab title="Web and mobile">120 <Tab title="Web and mobile">

121 Verwenden Sie das Modusmenü neben dem Eingabefeld auf [claude.ai/code](https://claude.ai/code) oder in der mobilen App. Berechtigungsaufforderungen werden in claude.ai zur Genehmigung angezeigt. Welche Modi angezeigt werden, hängt davon ab, wo die Sitzung ausgeführt wird:121 Verwenden Sie das Modusmenü neben dem Eingabefeld auf [claude.ai/code](https://claude.ai/code) oder in der mobilen App. Berechtigungsaufforderungen werden in claude.ai zur Genehmigung angezeigt. Welche Modi angezeigt werden, hängt davon ab, wo die Sitzung ausgeführt wird:

122 122

123 * **Cloud-Sitzungen** auf [Claude Code im Web](/de/claude-code-on-the-web): Bearbeitungen akzeptieren, Plan und Auto. Bearbeitungen akzeptieren entspricht dem `default` Modus: Die Cloud-Umgebung genehmigt Dateibearbeitungen vorab, unabhängig vom Modus, daher zeigt das Menü Bearbeitungen akzeptieren statt Manuell an. Cloud-Sitzungen respektieren weiterhin `defaultMode: "acceptEdits"` aus den Einstellungen. Der Auto-Modus wird nur angezeigt, wenn Ihre Organisation ihn zulässt und das ausgewählte Modell ihn unterstützt. Bypass permissions ist nicht verfügbar.123 * **Cloud-Sitzungen** auf [Claude Code im Web](/docs/de/claude-code-on-the-web): Bearbeitungen akzeptieren, Plan und Auto. Bearbeitungen akzeptieren entspricht dem `default` Modus: Die Cloud-Umgebung genehmigt Dateibearbeitungen vorab, unabhängig vom Modus, daher zeigt das Menü Bearbeitungen akzeptieren statt Manuell an. Cloud-Sitzungen respektieren weiterhin `defaultMode: "acceptEdits"` aus den Einstellungen. Der Auto-Modus wird nur angezeigt, wenn Ihre Organisation ihn zulässt und das ausgewählte Modell ihn unterstützt. Bypass permissions ist nicht verfügbar.

124 * **[Remote Control](/de/remote-control) Sitzungen** auf Ihrem lokalen Computer: Manuell, Bearbeitungen akzeptieren und Plan. Sie können Auto oder Bypass permissions nicht aus der App auswählen. {/* min-version: 2.1.202 */}Das Menü zeigt den Modus an, in dem sich die lokale Sitzung befindet, einschließlich eines Modus, der vom Terminal aus festgelegt wurde, und wird aktualisiert, wenn sich der Modus in der App oder im Terminal ändert. Die einzige Ausnahme ist Bypass permissions: Die Sitzung meldet diesen Modus nie an claude.ai, daher ändert das Wechseln vom Terminal aus nicht, was das Menü anzeigt. Vor v2.1.202 meldeten Sitzungen, die mit `/remote-control` oder `claude --remote-control` verbunden waren, ihren Modus überhaupt nicht, daher konnten claude.ai und die mobile App einen Modus anzeigen, in dem sich die Sitzung nicht befand. Die Nichtübereinstimmung betraf nur die Beschriftung: Claude Code generierte Berechtigungsaufforderungen aus dem tatsächlichen Modus der Sitzung, und sie wurden weiterhin in der App zur Genehmigung angezeigt.124 * **[Remote Control](/docs/de/remote-control) Sitzungen** auf Ihrem lokalen Computer: Manuell, Bearbeitungen akzeptieren und Plan. Sie können Auto oder Bypass permissions nicht aus der App auswählen. Das Menü zeigt den Modus an, in dem sich die lokale Sitzung befindet, einschließlich eines Modus, der vom Terminal aus festgelegt wurde, und wird aktualisiert, wenn sich der Modus in der App oder im Terminal ändert. Die einzige Ausnahme ist Bypass permissions: Die Sitzung meldet diesen Modus nie an claude.ai, daher ändert das Wechseln vom Terminal aus nicht, was das Menü anzeigt. Vor v2.1.202 meldeten Sitzungen, die mit `/remote-control` oder `claude --remote-control` verbunden waren, ihren Modus überhaupt nicht, daher konnten claude.ai und die mobile App einen Modus anzeigen, in dem sich die Sitzung nicht befand. Die Nichtübereinstimmung betraf nur die Beschriftung: Claude Code generierte Berechtigungsaufforderungen aus dem tatsächlichen Modus der Sitzung, und sie wurden weiterhin in der App zur Genehmigung angezeigt.

125 125

126 Für Remote Control können Sie auch den Startmodus beim Starten des Hosts festlegen:126 Für Remote Control können Sie auch den Startmodus beim Starten des Hosts festlegen:

127 127

137 137

138Der `acceptEdits`-Modus ermöglicht es Claude, Dateien in Ihrem Arbeitsverzeichnis zu erstellen und zu bearbeiten, ohne Sie zu fragen. Die Statusleiste zeigt `⏵⏵ accept edits on` an, während dieser Modus aktiv ist.138Der `acceptEdits`-Modus ermöglicht es Claude, Dateien in Ihrem Arbeitsverzeichnis zu erstellen und zu bearbeiten, ohne Sie zu fragen. Die Statusleiste zeigt `⏵⏵ accept edits on` an, während dieser Modus aktiv ist.

139 139

140Zusätzlich zu Dateibearbeitungen genehmigt der `acceptEdits`-Modus automatisch häufige Bash-Befehle im Dateisystem: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` und `sed`. Diese Befehle werden auch automatisch genehmigt, wenn sie mit sicheren Umgebungsvariablen wie `LANG=C` oder `NO_COLOR=1` oder Prozess-Wrappern wie `timeout`, `nice` oder `nohup` vorangestellt sind. Wie bei Dateibearbeitungen gilt die automatische Genehmigung nur für Pfade in Ihrem Arbeitsverzeichnis oder `additionalDirectories`. Pfade außerhalb dieses Bereichs, Schreibvorgänge auf [geschützte Pfade](#protected-paths) und alle anderen Bash-Befehle außer dem [integrierten schreibgeschützten Satz](/de/permissions#read-only-commands) erfordern weiterhin eine Genehmigung.140Zusätzlich zu Dateibearbeitungen genehmigt der `acceptEdits`-Modus automatisch häufige Bash-Befehle im Dateisystem: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` und `sed`. Diese Befehle werden auch automatisch genehmigt, wenn sie mit sicheren Umgebungsvariablen wie `LANG=C` oder `NO_COLOR=1` oder Prozess-Wrappern wie `timeout`, `nice` oder `nohup` vorangestellt sind. Wie bei Dateibearbeitungen gilt die automatische Genehmigung nur für Pfade in Ihrem Arbeitsverzeichnis oder `additionalDirectories`. Pfade außerhalb dieses Bereichs, Schreibvorgänge auf [geschützte Pfade](#protected-paths) und alle anderen Bash-Befehle außer dem [integrierten schreibgeschützten Satz](/docs/de/permissions#read-only-commands) erfordern weiterhin eine Genehmigung.

141 141

142Wenn das [PowerShell-Tool](/de/tools-reference#powershell-tool) aktiviert ist, genehmigt der `acceptEdits`-Modus auch automatisch `Set-Content`, `Add-Content`, `Clear-Content` und `Remove-Item` auf Pfaden im Gültigkeitsbereich, zusammen mit ihren häufigen Aliasen. Die gleichen Bereichs- und Schutzpfad-Regeln gelten.142Wenn das [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) aktiviert ist, genehmigt der `acceptEdits`-Modus auch automatisch `Set-Content`, `Add-Content`, `Clear-Content` und `Remove-Item` auf Pfaden im Gültigkeitsbereich, zusammen mit ihren häufigen Aliasen. Die gleichen Bereichs- und Schutzpfad-Regeln gelten.

143 143

144Verwenden Sie `acceptEdits`, wenn Sie Änderungen in Ihrem Editor oder über `git diff` im Nachhinein überprüfen möchten, anstatt jede Bearbeitung inline zu genehmigen.144Verwenden Sie `acceptEdits`, wenn Sie Änderungen in Ihrem Editor oder über `git diff` im Nachhinein überprüfen möchten, anstatt jede Bearbeitung inline zu genehmigen.

145 145

153 Analysieren Sie vor dem Bearbeiten mit dem Plan-Modus153 Analysieren Sie vor dem Bearbeiten mit dem Plan-Modus

154</h2>154</h2>

155 155

156Der Plan-Modus weist Claude an, Änderungen zu recherchieren und vorzuschlagen, ohne sie vorzunehmen. Claude liest Dateien, führt Shell-Befehle aus, um zu erkunden, und schreibt einen Plan, bearbeitet aber nicht Ihre Quelle. Genehmigungsaufforderungen gelten wie im manuellen Modus, es sei denn, der [Auto-Modus](/de/auto-mode-config) ist verfügbar und `useAutoModeDuringPlan` ist aktiviert, was die Standardeinstellung ist. Mit aktiviertem Auto-Modus genehmigt der Klassifizierer schreibgeschützte Befehle wie Suchen und Dateileser ohne Aufforderung. Bearbeitungen bleiben in jedem Fall blockiert, bis Sie den Plan genehmigen.156Der Plan-Modus weist Claude an, Änderungen zu recherchieren und vorzuschlagen, ohne sie vorzunehmen. Claude liest Dateien, führt Shell-Befehle aus, um zu erkunden, und schreibt einen Plan, bearbeitet aber nicht Ihre Quelle. Genehmigungsaufforderungen gelten wie im manuellen Modus, es sei denn, der [Auto-Modus](/docs/de/auto-mode-config) ist verfügbar und `useAutoModeDuringPlan` ist aktiviert, was die Standardeinstellung ist. Mit aktiviertem Auto-Modus genehmigt der Klassifizierer schreibgeschützte Befehle wie Suchen und Dateileser ohne Aufforderung. Bearbeitungen bleiben in jedem Fall blockiert, bis Sie den Plan genehmigen.

157 157

158Geben Sie den Plan-Modus ein, indem Sie `Shift+Tab` drücken oder einem einzelnen Prompt `/plan` voranstellen. Sie können auch vom CLI aus im Plan-Modus starten:158Geben Sie den Plan-Modus ein, indem Sie `Shift+Tab` drücken oder einem einzelnen Prompt `/plan` voranstellen. Sie können auch vom CLI aus im Plan-Modus starten:

159 159

173* Genehmigen und Bearbeitungen akzeptieren173* Genehmigen und Bearbeitungen akzeptieren

174* Genehmigen und jede Bearbeitung manuell überprüfen174* Genehmigen und jede Bearbeitung manuell überprüfen

175* Mit Feedback weiter planen175* Mit Feedback weiter planen

176* Mit [Ultraplan](/de/ultraplan) für browsergestützte Überprüfung verfeinern176* Mit [Ultraplan](/docs/de/ultraplan) für browsergestützte Überprüfung verfeinern

177 177

178Das Genehmigen eines Plans beendet den Plan-Modus und wechselt die Sitzung zum Genehmigungsmodus, den jede Genehmigungsoption beschreibt, sodass Claude mit der Bearbeitung beginnt. Um erneut zu planen, wechseln Sie mit `Shift+Tab` zurück zum Plan-Modus oder stellen Sie Ihrem nächsten Prompt `/plan` voran.178Das Genehmigen eines Plans beendet den Plan-Modus und wechselt die Sitzung zum Genehmigungsmodus, den jede Genehmigungsoption beschreibt, sodass Claude mit der Bearbeitung beginnt. Um erneut zu planen, wechseln Sie mit `Shift+Tab` zurück zum Plan-Modus oder stellen Sie Ihrem nächsten Prompt `/plan` voran.

179 179

180Drücken Sie `Ctrl+G`, um den vorgeschlagenen Plan in Ihrem Standard-Texteditor zu öffnen und ihn direkt zu bearbeiten, bevor Claude fortfährt. Wenn [`showClearContextOnPlanAccept`](/de/settings#available-settings) aktiviert ist, bietet jede Genehmigungsoption auch an, den Planungskontext zuerst zu löschen.180Drücken Sie `Ctrl+G`, um den vorgeschlagenen Plan in Ihrem Standard-Texteditor zu öffnen und ihn direkt zu bearbeiten, bevor Claude fortfährt. Wenn [`showClearContextOnPlanAccept`](/docs/de/settings#available-settings) aktiviert ist, bietet jede Genehmigungsoption auch an, den Planungskontext zuerst zu löschen.

181 181

182Das Akzeptieren eines Plans benennt die Sitzung auch automatisch aus dem Planinhalt, es sei denn, Sie haben bereits einen Namen mit `--name` oder `/rename` festgelegt.182Das Akzeptieren eines Plans benennt die Sitzung auch automatisch aus dem Planinhalt, es sei denn, Sie haben bereits einen Namen mit `--name` oder `/rename` festgelegt.

183 183

199 Berechtigungsaufforderungen mit Auto-Modus eliminieren199 Berechtigungsaufforderungen mit Auto-Modus eliminieren

200</h2>200</h2>

201 201

202Der Auto-Modus ermöglicht es Claude, ohne routinemäßige Berechtigungsaufforderungen auszuführen. Ein separates Klassifizierungsmodell überprüft Aktionen vor ihrer Ausführung und blockiert alles, das über Ihre Anfrage hinausgeht, auf nicht erkannte Infrastruktur abzielt oder von feindseligem Inhalt angetrieben zu sein scheint, den Claude gelesen hat. Explizite [Ask-Regeln](/de/permissions#manage-permissions) erzwingen weiterhin eine Aufforderung.202Der Auto-Modus ermöglicht es Claude, ohne routinemäßige Berechtigungsaufforderungen auszuführen. Ein separates Klassifizierungsmodell überprüft Aktionen vor ihrer Ausführung und blockiert alles, das über Ihre Anfrage hinausgeht, auf nicht erkannte Infrastruktur abzielt oder von feindseligem Inhalt angetrieben zu sein scheint, den Claude gelesen hat. Explizite [Ask-Regeln](/docs/de/permissions#manage-permissions) erzwingen weiterhin eine Aufforderung.

203 203

204Löschungen, die das Dateisystem-Root oder das Home-Verzeichnis anvisieren, wie `rm -rf /` und `rm -rf ~`, fordern zur Genehmigung auf, statt zum Klassifizierer zu gehen. {/* min-version: 2.1.208 */}Diese Aufforderung wird auch ausgelöst, wenn der Befehl Befehlsersetzung mit `$(...)` oder Backticks oder Prozessersetzung mit `<(...)` enthält, unabhängig davon, ob die Löschung innerhalb der Ersetzung liegt, wie in `echo "$(rm -rf ~)"`, oder anderswo im gleichen Befehl. Vor v2.1.208 wurden Befehle, die diese Formen enthielten, zum Klassifizierer geleitet, statt eine Aufforderung auszulösen.204Löschungen, die das Dateisystem-Root oder das Home-Verzeichnis anvisieren, wie `rm -rf /` und `rm -rf ~`, fordern zur Genehmigung auf, statt zum Klassifizierer zu gehen. Diese Aufforderung wird auch ausgelöst, wenn der Befehl Befehlsersetzung mit `$(...)` oder Backticks oder Prozessersetzung mit `<(...)` enthält, unabhängig davon, ob die Löschung innerhalb der Ersetzung liegt, wie in `echo "$(rm -rf ~)"`, oder anderswo im gleichen Befehl. Vor v2.1.208 wurden Befehle, die diese Formen enthielten, zum Klassifizierer geleitet, statt eine Aufforderung auszulösen.

205 205

206Der Auto-Modus ermutigt Claude auch, ohne Unterbrechung für Klärungsfragen weiterzuarbeiten, obwohl Claude immer noch fragt, wenn Ihre Eingabeaufforderung oder eine Fähigkeit dies explizit erfordert. Für stärkeres autonomes Verhalten bei Beibehaltung von Berechtigungsaufforderungen stellen Sie stattdessen den [Proaktiven Ausgabestil](/de/output-styles) ein.206Der Auto-Modus ermutigt Claude auch, ohne Unterbrechung für Klärungsfragen weiterzuarbeiten, obwohl Claude immer noch fragt, wenn Ihre Eingabeaufforderung oder eine Fähigkeit dies explizit erfordert. Für stärkeres autonomes Verhalten bei Beibehaltung von Berechtigungsaufforderungen stellen Sie stattdessen den [Proaktiven Ausgabestil](/docs/de/output-styles) ein.

207 207

208<Warning>208<Warning>

209 Der Auto-Modus reduziert Berechtigungsaufforderungen, garantiert aber keine Sicherheit. Verwenden Sie ihn für Aufgaben, bei denen Sie der allgemeinen Richtung vertrauen, nicht als Ersatz für die Überprüfung bei sensiblen Operationen.209 Der Auto-Modus reduziert Berechtigungsaufforderungen, garantiert aber keine Sicherheit. Verwenden Sie ihn für Aufgaben, bei denen Sie der allgemeinen Richtung vertrauen, nicht als Ersatz für die Überprüfung bei sensiblen Operationen.

212Der Auto-Modus ist nur verfügbar, wenn Ihr Konto alle diese Anforderungen erfüllt:212Der Auto-Modus ist nur verfügbar, wenn Ihr Konto alle diese Anforderungen erfüllt:

213 213

214* **Plan**: Alle Pläne.214* **Plan**: Alle Pläne.

215* **Besitzer**: Bei Team und Enterprise muss ein Besitzer ihn in den [Claude Code Admin-Einstellungen](https://claude.ai/admin-settings/claude-code) aktivieren, bevor Benutzer ihn einschalten können. Administratoren können den Auto-Modus auch ausschalten, indem sie `permissions.disableAutoMode` in den [verwalteten Einstellungen](/de/permissions#managed-settings) auf `"disable"` setzen. Für die Registerkarte „Code" der Desktop-App ist `disableAutoMode` die Kontrolle auf Organisationsebene, und der Admin-Einstellungen-Schalter gilt nicht.215* **Besitzer**: Bei Team und Enterprise muss ein Besitzer ihn in den [Claude Code Admin-Einstellungen](https://claude.ai/admin-settings/claude-code) aktivieren, bevor Benutzer ihn einschalten können. Administratoren können den Auto-Modus auch ausschalten, indem sie `permissions.disableAutoMode` in den [verwalteten Einstellungen](/docs/de/permissions#managed-settings) auf `"disable"` setzen. Für die Registerkarte „Code" der Desktop-App ist `disableAutoMode` die Kontrolle auf Organisationsebene, und der Admin-Einstellungen-Schalter gilt nicht.

216* **Modell**: In der Anthropic API Claude Opus 4.6 oder später oder Sonnet 4.6 oder später. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzungen nur Claude Sonnet 5, Opus 4.7 und Opus 4.8. Ältere Modelle, einschließlich Sonnet 4.5, Opus 4.5, Haiku und claude-3-Modelle, werden auf keinem Anbieter unterstützt.216* **Modell**: In der Anthropic API Claude Opus 4.6 oder später oder Sonnet 4.6 oder später. Bei Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten [Claude Apps Gateway](/docs/de/claude-apps-gateway)-Sitzungen nur Claude Sonnet 5, Opus 4.7 und Opus 4.8. Ältere Modelle, einschließlich Sonnet 4.5, Opus 4.5, Haiku und claude-3-Modelle, werden auf keinem Anbieter unterstützt.

217* **Anbieter**: Standardmäßig verfügbar in der Anthropic API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten Claude Apps Gateway-Sitzungen. {/* min-version: 2.1.207 */}In v2.1.158 bis v2.1.206 war der Auto-Modus auf allen diesen Anbietern außer der Anthropic API deaktiviert, bis Sie `CLAUDE_CODE_ENABLE_AUTO_MODE=1` setzten; v2.1.207 entfernte die Anforderung.217* **Anbieter**: Standardmäßig verfügbar in der Anthropic API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry und angemeldeten Claude Apps Gateway-Sitzungen. In v2.1.158 bis v2.1.206 war der Auto-Modus auf allen diesen Anbietern außer der Anthropic API deaktiviert, bis Sie `CLAUDE_CODE_ENABLE_AUTO_MODE=1` setzten; v2.1.207 entfernte die Anforderung.

218 218

219Wenn Claude Code den Auto-Modus als nicht verfügbar meldet, ist eine dieser Anforderungen nicht erfüllt; dies ist kein vorübergehender Ausfall. Eine separate Nachricht, die ein Modell benennt und sagt, dass der Auto-Modus die Sicherheit einer Aktion „nicht bestimmen kann", ist ein vorübergehender Klassifizierungsausfall; siehe die [Fehlerreferenz](/de/errors#auto-mode-cannot-determine-the-safety-of-an-action).219Wenn Claude Code den Auto-Modus als nicht verfügbar meldet, ist eine dieser Anforderungen nicht erfüllt; dies ist kein vorübergehender Ausfall. Eine separate Nachricht, die ein Modell benennt und sagt, dass der Auto-Modus die Sicherheit einer Aktion „nicht bestimmen kann", ist ein vorübergehender Klassifizierungsausfall; siehe die [Fehlerreferenz](/docs/de/errors#auto-mode-cannot-determine-the-safety-of-an-action).

220 220

221Wenn Sie `defaultMode: "auto"` in den [Einstellungen](/de/settings#available-settings) setzen und die Sitzung im `default`-Modus ohne Fehler startet, befindet sich die Einstellung wahrscheinlich in `.claude/settings.json` oder `.claude/settings.local.json`. Claude Code v2.1.142 und später ignorieren `auto` aus diesen Dateien, sodass ein Repository sich nicht selbst den Auto-Modus gewähren kann. Verschieben Sie es zu `~/.claude/settings.json`.221Wenn Sie `defaultMode: "auto"` in den [Einstellungen](/docs/de/settings#available-settings) setzen und die Sitzung im `default`-Modus ohne Fehler startet, befindet sich die Einstellung wahrscheinlich in `.claude/settings.json` oder `.claude/settings.local.json`. Claude Code v2.1.142 und später ignorieren `auto` aus diesen Dateien, sodass ein Repository sich nicht selbst den Auto-Modus gewähren kann. Verschieben Sie es zu `~/.claude/settings.json`.

222 222

223<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">223<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">

224 Auto-Modus auf Bedrock, Agent Platform oder Foundry224 Auto-Modus auf Bedrock, Agent Platform oder Foundry

225</h3>225</h3>

226 226

227Bei [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai), [Microsoft Foundry](/de/microsoft-foundry) und angemeldeten [Claude Apps Gateway](/de/claude-apps-gateway)-Sitzungen wird der Auto-Modus standardmäßig im `Shift+Tab`-Zyklus angezeigt. Das Erscheinen im Zyklus ändert nicht den Modus, in dem eine Sitzung startet: Sitzungen starten immer noch in Ihrem [`defaultMode`](/de/settings#available-settings), der Manual ist, es sei denn, Sie ändern ihn. Nur Claude Sonnet 5, Opus 4.7 und Opus 4.8 werden auf diesen Anbietern unterstützt.227Bei [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai), [Microsoft Foundry](/docs/de/microsoft-foundry) und angemeldeten [Claude Apps Gateway](/docs/de/claude-apps-gateway)-Sitzungen wird der Auto-Modus standardmäßig im `Shift+Tab`-Zyklus angezeigt. Das Erscheinen im Zyklus ändert nicht den Modus, in dem eine Sitzung startet: Sitzungen starten immer noch in Ihrem [`defaultMode`](/docs/de/settings#available-settings), der Manual ist, es sei denn, Sie ändern ihn. Nur Claude Sonnet 5, Opus 4.7 und Opus 4.8 werden auf diesen Anbietern unterstützt.

228 228

229Um den Auto-Modus zum Standard-Startmodus zu machen, setzen Sie `"permissions": {"defaultMode": "auto"}` in Benutzer- oder verwalteten Einstellungen.229Um den Auto-Modus zum Standard-Startmodus zu machen, setzen Sie `"permissions": {"defaultMode": "auto"}` in Benutzer- oder verwalteten Einstellungen.

230 230

231Um Entwickler daran zu hindern, den Auto-Modus zu verwenden, setzen Sie `disableAutoMode` in den [verwalteten Einstellungen](/de/permissions#managed-settings) auf `"disable"`. Dies entfernt `auto` aus dem `Shift+Tab`-Zyklus und lehnt `--permission-mode auto` beim Start ab.231Um Entwickler daran zu hindern, den Auto-Modus zu verwenden, setzen Sie `disableAutoMode` in den [verwalteten Einstellungen](/docs/de/permissions#managed-settings) auf `"disable"`. Dies entfernt `auto` aus dem `Shift+Tab`-Zyklus und lehnt `--permission-mode auto` beim Start ab.

232 232

233In v2.1.158 bis v2.1.206 war der Auto-Modus auf diesen Anbietern deaktiviert, bis Sie `CLAUDE_CODE_ENABLE_AUTO_MODE=1` setzten, und Claude Code ignorierte `defaultMode: "auto"` auf diesen Anbietern, es sei denn, die Variable war auch gesetzt. Die Variable wird weiterhin aus Kompatibilitätsgründen akzeptiert und hat ab v2.1.207 keine Auswirkung.233In v2.1.158 bis v2.1.206 war der Auto-Modus auf diesen Anbietern deaktiviert, bis Sie `CLAUDE_CODE_ENABLE_AUTO_MODE=1` setzten, und Claude Code ignorierte `defaultMode: "auto"` auf diesen Anbietern, es sei denn, die Variable war auch gesetzt. Die Variable wird weiterhin aus Kompatibilitätsgründen akzeptiert und hat ab v2.1.207 keine Auswirkung.

234 234

236 Was der Klassifizierer standardmäßig blockiert236 Was der Klassifizierer standardmäßig blockiert

237</h3>237</h3>

238 238

239Der Klassifizierer vertraut Ihrem Arbeitsverzeichnis und den Remotes, die dafür konfiguriert wurden, als die Sitzung begann. {/* min-version: 2.1.200 */}Ein Remote, das während der Sitzung mit `git remote add` oder `git remote set-url` hinzugefügt oder umgeleitet wird, wird nicht vertraut, und alles andere wird als extern behandelt, bis Sie [vertrauenswürdige Infrastruktur konfigurieren](/de/auto-mode-config). Vor v2.1.200 wurden Remotes, die während der Sitzung hinzugefügt wurden, ebenfalls vertraut.239Der Klassifizierer vertraut Ihrem Arbeitsverzeichnis und den Remotes, die dafür konfiguriert wurden, als die Sitzung begann. Ein Remote, das während der Sitzung mit `git remote add` oder `git remote set-url` hinzugefügt oder umgeleitet wird, wird nicht vertraut, und alles andere wird als extern behandelt, bis Sie [vertrauenswürdige Infrastruktur konfigurieren](/docs/de/auto-mode-config). Vor v2.1.200 wurden Remotes, die während der Sitzung hinzugefügt wurden, ebenfalls vertraut.

240 240

241**Standardmäßig blockiert**:241**Standardmäßig blockiert**:

242 242

248* Änderung gemeinsamer Infrastruktur248* Änderung gemeinsamer Infrastruktur

249* Irreversibles Löschen von Dateien, die vor der Sitzung vorhanden waren249* Irreversibles Löschen von Dateien, die vor der Sitzung vorhanden waren

250* Force Push250* Force Push

251* {/* min-version: 2.1.203 */}Pushing zum Standard-Branch des Repositorys, wenn der Push sensible Inhalte wie Geheimnisse oder persönliche oder anvertraute Daten enthält, Änderungen enthält, die verborgen oder falsch beschrieben sind im Vergleich zu dem, worum Sie gebeten haben, Inhalte enthält, die von außerhalb des Repositorys portiert oder zuerst gelesen wurden, oder um einen Pull Request, eine Überprüfung oder eine Prüfung herumleitet, um die Sie gebeten haben. Ein einfacher Push zum Standard-Branch wird nicht allein blockiert, und das Aufheben der Blockierung eines gekennzeichneten Push erfordert das Benennen des gekennzeichneten Inhalts oder der umgangenen Überprüfung, nicht nur des Push. Der Klassifizierer ist eine Schicht: [`permissions.deny`-Regeln](/de/permissions#manage-permissions) gelten in jedem Modus und können Pushes zum Standard-Branch vollständig blockieren, und der Branch-Schutz des Remote gilt immer noch. Vor v2.1.203 wurde jeder direkte Push zum Standard-Branch blockiert251* Pushing zum Standard-Branch des Repositorys, wenn der Push sensible Inhalte wie Geheimnisse oder persönliche oder anvertraute Daten enthält, Änderungen enthält, die verborgen oder falsch beschrieben sind im Vergleich zu dem, worum Sie gebeten haben, Inhalte enthält, die von außerhalb des Repositorys portiert oder zuerst gelesen wurden, oder um einen Pull Request, eine Überprüfung oder eine Prüfung herumleitet, um die Sie gebeten haben. Ein einfacher Push zum Standard-Branch wird nicht allein blockiert, und das Aufheben der Blockierung eines gekennzeichneten Push erfordert das Benennen des gekennzeichneten Inhalts oder der umgangenen Überprüfung, nicht nur des Push. Der Klassifizierer ist eine Schicht: [`permissions.deny`-Regeln](/docs/de/permissions#manage-permissions) gelten in jedem Modus und können Pushes zum Standard-Branch vollständig blockieren, und der Branch-Schutz des Remote gilt immer noch. Vor v2.1.203 wurde jeder direkte Push zum Standard-Branch blockiert

252* {/* min-version: 2.1.182 */}`git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` oder `git stash clear`, von denen der Klassifizierer annimmt, dass sie nicht committete Änderungen verwerfen würden252* `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` oder `git stash clear`, von denen der Klassifizierer annimmt, dass sie nicht committete Änderungen verwerfen würden

253* `git commit --amend`, wenn der Commit am HEAD nicht in dieser Sitzung erstellt wurde253* `git commit --amend`, wenn der Commit am HEAD nicht in dieser Sitzung erstellt wurde

254* {/* min-version: 2.1.198 */}Ab v2.1.198 `git commit --amend`, wenn der Commit am HEAD bereits gepusht wurde. Eine reine Umformulierung der Nachricht wird nicht blockiert: `--amend -m` ohne neu bereitgestellte Inhalte, bei einem Commit, den Claude während dieser Sitzung erstellt hat254* Ab v2.1.198 `git commit --amend`, wenn der Commit am HEAD bereits gepusht wurde. Eine reine Umformulierung der Nachricht wird nicht blockiert: `--amend -m` ohne neu bereitgestellte Inhalte, bei einem Commit, den Claude während dieser Sitzung erstellt hat

255* `terraform destroy`, `pulumi destroy`, `cdk destroy` oder `terragrunt destroy`, und Anwendung eines Plans, der Ressourcen zerstört255* `terraform destroy`, `pulumi destroy`, `cdk destroy` oder `terragrunt destroy`, und Anwendung eines Plans, der Ressourcen zerstört

256 256

257Claude Code v2.1.195 und später blockieren standardmäßig mehr Kategorien. Mehrere hängen von [Umgebungs](/de/auto-mode-config#define-trusted-infrastructure)-Einträgen ab, wie sensible Remote-Ziele und geschützte IaC-Bereiche, die Sie auf konkrete Namen eingrenzen können.257Claude Code v2.1.195 und später blockieren standardmäßig mehr Kategorien. Mehrere hängen von [Umgebungs](/docs/de/auto-mode-config#define-trusted-infrastructure)-Einträgen ab, wie sensible Remote-Ziele und geschützte IaC-Bereiche, die Sie auf konkrete Namen eingrenzen können.

258 258

259* Schreiben in einen Secret Manager oder Ändern von DNS-Einträgen oder TLS-Zertifikaten259* Schreiben in einen Secret Manager oder Ändern von DNS-Einträgen oder TLS-Zertifikaten

260* Zusammenführen eines Pull Requests, den kein Mensch genehmigt hat, Genehmigung von Claudes eigenem Pull Request oder Deaktivierung von CI-Prüfungen260* Zusammenführen eines Pull Requests, den kein Mensch genehmigt hat, Genehmigung von Claudes eigenem Pull Request oder Deaktivierung von CI-Prüfungen

266* Interaktive Shells oder Port-Forwards in ein sensibles Remote-Ziel266* Interaktive Shells oder Port-Forwards in ein sensibles Remote-Ziel

267* Öffnen eines Tunnels oder einer Reverse Shell, die einen lokalen Service vom öffentlichen Internet erreichbar macht267* Öffnen eines Tunnels oder einer Reverse Shell, die einen lokalen Service vom öffentlichen Internet erreichbar macht

268* Drucken eines Live-Credentials oder Tokens in das Transkript oder eine Datei268* Drucken eines Live-Credentials oder Tokens in das Transkript oder eine Datei

269* Zugriff auf einen Ort, der in Ihrer [Umgebung](/de/auto-mode-config#define-trusted-infrastructure) als sensible Datenlocation aufgelistet ist, oder Kopieren von Daten daraus. {/* min-version: 2.1.198 */}Ab v2.1.198 blockiert dies auch das Senden von Daten von einem zu einer Zielgruppe, die der Eintrag ausschließt269* Zugriff auf einen Ort, der in Ihrer [Umgebung](/docs/de/auto-mode-config#define-trusted-infrastructure) als sensible Datenlocation aufgelistet ist, oder Kopieren von Daten daraus. Ab v2.1.198 blockiert dies auch das Senden von Daten von einem zu einer Zielgruppe, die der Eintrag ausschließt

270* Umleitung einer Paketinstallation um Ihre interne Paketregistrierung zu einer öffentlichen Registrierung. {/* min-version: 2.1.198 */}Ab v2.1.198 gilt dies auch, wenn Sie Claude in der Konversation mitgeteilt haben, dass eine interne Registrierung oder ein Mirror vorhanden ist, nicht nur wenn eine in Ihrer Umgebung aufgelistet ist270* Umleitung einer Paketinstallation um Ihre interne Paketregistrierung zu einer öffentlichen Registrierung. Ab v2.1.198 gilt dies auch, wenn Sie Claude in der Konversation mitgeteilt haben, dass eine interne Registrierung oder ein Mirror vorhanden ist, nicht nur wenn eine in Ihrer Umgebung aufgelistet ist

271* Ausführung eines Befehls mit einem Flag, das einen Sicherheitsschutz deaktiviert, wie `--insecure`271* Ausführung eines Befehls mit einem Flag, das einen Sicherheitsschutz deaktiviert, wie `--insecure`

272* Starten einer autonomen Agent-Schleife, die ohne menschliche Genehmigung oder Sandbox ausgeführt wird, wie eine mit `--dangerously-skip-permissions` oder `--no-sandbox` gestartete. {/* min-version: 2.1.198 */}Ab v2.1.198 deckt dies auch das Ausführen eines Third-Party-Agenten oder Eval-Harness mit deaktivierter Isolation und Pro-Aktion-Genehmigung ab, wie ein mit `--yes-always` gestarteter Runner272* Starten einer autonomen Agent-Schleife, die ohne menschliche Genehmigung oder Sandbox ausgeführt wird, wie eine mit `--dangerously-skip-permissions` oder `--no-sandbox` gestartete. Ab v2.1.198 deckt dies auch das Ausführen eines Third-Party-Agenten oder Eval-Harness mit deaktivierter Isolation und Pro-Aktion-Genehmigung ab, wie ein mit `--yes-always` gestarteter Runner

273* [Claude in Chrome](/de/chrome) Browser-Aktionen, die Seiteninhalte, Cookies oder Credentials off-origin senden könnten273* [Claude in Chrome](/docs/de/chrome) Browser-Aktionen, die Seiteninhalte, Cookies oder Credentials off-origin senden könnten

274 274

275Claude Code v2.1.198 und später blockieren diese auch standardmäßig:275Claude Code v2.1.198 und später blockieren diese auch standardmäßig:

276 276

318* Löschen der genauen Jobs, die Claude früher in derselben Sitzung erstellt hat318* Löschen der genauen Jobs, die Claude früher in derselben Sitzung erstellt hat

319* Lesen, Überprüfung oder Schreiben von sicherheitsbezogenem Code, Configs und Bedrohungsmodellen als Teil Ihrer Aufgabe319* Lesen, Überprüfung oder Schreiben von sicherheitsbezogenem Code, Configs und Bedrohungsmodellen als Teil Ihrer Aufgabe

320* Nachrichten zwischen Agenten, die zusammen in derselben Multi-Agent-Sitzung arbeiten320* Nachrichten zwischen Agenten, die zusammen in derselben Multi-Agent-Sitzung arbeiten

321* Senden von Daten an die vertrauenswürdigen Domains, Buckets und Services, die Sie in [`environment`](/de/auto-mode-config#define-trusted-infrastructure) auflisten. Dies deckt nur Datenfluss ab, nicht destruktive oder Credential-Operationen auf derselben Infrastruktur321* Senden von Daten an die vertrauenswürdigen Domains, Buckets und Services, die Sie in [`environment`](/docs/de/auto-mode-config#define-trusted-infrastructure) auflisten. Dies deckt nur Datenfluss ab, nicht destruktive oder Credential-Operationen auf derselben Infrastruktur

322* [Claude in Chrome](/de/chrome) Navigation zu einer vertrauenswürdigen internen Domain, localhost oder einer URL, die Sie benannt haben322* [Claude in Chrome](/docs/de/chrome) Navigation zu einer vertrauenswürdigen internen Domain, localhost oder einer URL, die Sie benannt haben

323 323

324Sandbox-Netzwerkzugriff-Anfragen werden durch den Klassifizierer geleitet, statt standardmäßig erlaubt zu werden. {{/* min-version: 2.1.198 */}}Ab v2.1.198 verwendet der Klassifizierer sein Urteil für einen Netzwerk-Host und Port wieder, statt bei jeder Verbindung erneut auszuführen:324Sandbox-Netzwerkzugriff-Anfragen werden durch den Klassifizierer geleitet, statt standardmäßig erlaubt zu werden. {{/* min-version: 2.1.198 */}}Ab v2.1.198 verwendet der Klassifizierer sein Urteil für einen Netzwerk-Host und Port wieder, statt bei jeder Verbindung erneut auszuführen:

325 325

326* Ein Allow wird wiederverwendet, bis neuer Inhalt in die Konversation eintritt, an welchem Punkt dieser Host erneut überprüft wird326* Ein Allow wird wiederverwendet, bis neuer Inhalt in die Konversation eintritt, an welchem Punkt dieser Host erneut überprüft wird

327* In der interaktiven CLI wird ein Deny gelöscht, wenn die Runde endet327* In der interaktiven CLI wird ein Deny gelöscht, wenn die Runde endet

328* Im [nicht-interaktiven Modus](/de/headless) und Agent SDK-Sitzungen gibt es keine Rundenbegrenzung, sodass ein Deny für den Rest des Laufs wiederverwendet wird328* Im [nicht-interaktiven Modus](/docs/de/headless) und Agent SDK-Sitzungen gibt es keine Rundenbegrenzung, sodass ein Deny für den Rest des Laufs wiederverwendet wird

329* Das Ändern Ihres Berechtigungsmodus oder Ihrer Regeln löscht alle zwischengespeicherten Urteile329* Das Ändern Ihres Berechtigungsmodus oder Ihrer Regeln löscht alle zwischengespeicherten Urteile

330 330

331Führen Sie `claude auto-mode defaults` aus, um die vollständigen Regellisten zu sehen. Wenn routinemäßige Aktionen blockiert werden, kann ein Administrator vertrauenswürdige Repos, Buckets und Services über die `autoMode.environment`-Einstellung hinzufügen: siehe [Auto-Modus konfigurieren](/de/auto-mode-config).331Führen Sie `claude auto-mode defaults` aus, um die vollständigen Regellisten zu sehen. Wenn routinemäßige Aktionen blockiert werden, kann ein Administrator vertrauenswürdige Repos, Buckets und Services über die `autoMode.environment`-Einstellung hinzufügen: siehe [Auto-Modus konfigurieren](/docs/de/auto-mode-config).

332 332

333Pushing zum Arbeits-Branch, Durchführung eines routinemäßigen Push zum Repository Standard-Branch und Erstellen eines Pull Requests, der Ihrer Anfrage entspricht, werden alle ohne Aufforderung ausgeführt. Der Klassifizierer blockiert einen Push nur, wenn er Risiken birgt, wie ein Force Push oder Inhalte, die um eine Überprüfung herumleiten, die Sie eingerichtet haben. Um einen menschlichen Checkpoint vor diesen Aktionen zu erzwingen, während Sie im Auto-Modus bleiben, fügen Sie `permissions.ask`-Regeln hinzu: siehe [Häufige Grenzen](/de/auto-mode-config#common-boundaries).333Pushing zum Arbeits-Branch, Durchführung eines routinemäßigen Push zum Repository Standard-Branch und Erstellen eines Pull Requests, der Ihrer Anfrage entspricht, werden alle ohne Aufforderung ausgeführt. Der Klassifizierer blockiert einen Push nur, wenn er Risiken birgt, wie ein Force Push oder Inhalte, die um eine Überprüfung herumleiten, die Sie eingerichtet haben. Um einen menschlichen Checkpoint vor diesen Aktionen zu erzwingen, während Sie im Auto-Modus bleiben, fügen Sie `permissions.ask`-Regeln hinzu: siehe [Häufige Grenzen](/docs/de/auto-mode-config#common-boundaries).

334 334

335<h3 id="boundaries-you-state-in-conversation">335<h3 id="boundaries-you-state-in-conversation">

336 Grenzen, die Sie in der Konversation angeben336 Grenzen, die Sie in der Konversation angeben

338 338

339Der Klassifizierer behandelt Grenzen, die Sie in der Konversation angeben, als Blocksignal. Wenn Sie Claude sagen „nicht pushen" oder „warten Sie, bis ich überprüfe, bevor Sie bereitstellen", blockiert der Klassifizierer entsprechende Aktionen, auch wenn die Standardregeln sie erlauben würden. Eine Grenze bleibt in Kraft, bis Sie sie in einer späteren Nachricht aufheben. Claudes eigenes Urteil, dass eine Bedingung erfüllt wurde, hebt sie nicht auf.339Der Klassifizierer behandelt Grenzen, die Sie in der Konversation angeben, als Blocksignal. Wenn Sie Claude sagen „nicht pushen" oder „warten Sie, bis ich überprüfe, bevor Sie bereitstellen", blockiert der Klassifizierer entsprechende Aktionen, auch wenn die Standardregeln sie erlauben würden. Eine Grenze bleibt in Kraft, bis Sie sie in einer späteren Nachricht aufheben. Claudes eigenes Urteil, dass eine Bedingung erfüllt wurde, hebt sie nicht auf.

340 340

341Grenzen werden nicht als Regeln gespeichert. Der Klassifizierer liest sie bei jeder Prüfung aus dem Transkript erneut, sodass eine Grenze verloren gehen kann, wenn [Kontext-Komprimierung](/de/costs#reduce-token-usage) die Nachricht entfernt, die sie angegeben hat. Für eine harte Garantie fügen Sie stattdessen eine [Deny-Regel](/de/permissions#permission-rule-syntax) hinzu.341Grenzen werden nicht als Regeln gespeichert. Der Klassifizierer liest sie bei jeder Prüfung aus dem Transkript erneut, sodass eine Grenze verloren gehen kann, wenn [Kontext-Komprimierung](/docs/de/costs#reduce-token-usage) die Nachricht entfernt, die sie angegeben hat. Für eine harte Garantie fügen Sie stattdessen eine [Deny-Regel](/docs/de/permissions#permission-rule-syntax) hinzu.

342 342

343<h3 id="when-auto-mode-falls-back">343<h3 id="when-auto-mode-falls-back">

344 Wenn der Auto-Modus zurückfällt344 Wenn der Auto-Modus zurückfällt

348 348

349Wenn der Klassifizierer eine Aktion 3-mal hintereinander oder insgesamt 20-mal blockiert, pausiert der Auto-Modus und Claude Code setzt das Prompting fort. Das Genehmigen der aufgeforderten Aktion setzt den Auto-Modus fort. Diese Schwellwerte sind nicht konfigurierbar. Jede erlaubte Aktion setzt den aufeinanderfolgenden Zähler zurück, während der Gesamtzähler für die Sitzung bestehen bleibt und nur zurückgesetzt wird, wenn sein eigenes Limit einen Fallback auslöst.349Wenn der Klassifizierer eine Aktion 3-mal hintereinander oder insgesamt 20-mal blockiert, pausiert der Auto-Modus und Claude Code setzt das Prompting fort. Das Genehmigen der aufgeforderten Aktion setzt den Auto-Modus fort. Diese Schwellwerte sind nicht konfigurierbar. Jede erlaubte Aktion setzt den aufeinanderfolgenden Zähler zurück, während der Gesamtzähler für die Sitzung bestehen bleibt und nur zurückgesetzt wird, wenn sein eigenes Limit einen Fallback auslöst.

350 350

351Im [nicht-interaktiven Modus](/de/headless) mit dem `-p`-Flag wird die Sitzung abgebrochen, wenn wiederholte Blockierungen auftreten, da es keinen Benutzer zum Prompting gibt.351Im [nicht-interaktiven Modus](/docs/de/headless) mit dem `-p`-Flag wird die Sitzung abgebrochen, wenn wiederholte Blockierungen auftreten, da es keinen Benutzer zum Prompting gibt.

352 352

353Wiederholte Blöcke bedeuten normalerweise, dass dem Klassifizierer Kontext über Ihre Infrastruktur fehlt. Verwenden Sie `/feedback`, um falsch positive Ergebnisse zu melden, oder lassen Sie einen Administrator [vertrauenswürdige Infrastruktur konfigurieren](/de/auto-mode-config).353Wiederholte Blöcke bedeuten normalerweise, dass dem Klassifizierer Kontext über Ihre Infrastruktur fehlt. Verwenden Sie `/feedback`, um falsch positive Ergebnisse zu melden, oder lassen Sie einen Administrator [vertrauenswürdige Infrastruktur konfigurieren](/docs/de/auto-mode-config).

354 354

355<AccordionGroup>355<AccordionGroup>

356 <Accordion title="Wie der Klassifizierer Aktionen bewertet">356 <Accordion title="Wie der Klassifizierer Aktionen bewertet">

357 Jede Aktion durchläuft eine feste Entscheidungsreihenfolge. Der erste übereinstimmende Schritt gewinnt:357 Jede Aktion durchläuft eine feste Entscheidungsreihenfolge. Der erste übereinstimmende Schritt gewinnt:

358 358

359 1. Aktionen, die Ihren [Allow-, Ask- oder Deny-Regeln](/de/permissions#manage-permissions) entsprechen, werden sofort aufgelöst. Schreibvorgänge zu [geschützten Pfaden](#protected-paths) werden zum Klassifizierer geleitet, auch wenn eine Allow-Regel übereinstimmt. Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und MCP-Tools, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, fordern Sie direkt auf, auch wenn eine Allow-Regel übereinstimmt. Inhalts-bezogene Ask-Regeln fallen auf eine Berechtigungsaufforderung zurück359 1. Aktionen, die Ihren [Allow-, Ask- oder Deny-Regeln](/docs/de/permissions#manage-permissions) entsprechen, werden sofort aufgelöst. Schreibvorgänge zu [geschützten Pfaden](#protected-paths) werden zum Klassifizierer geleitet, auch wenn eine Allow-Regel übereinstimmt. Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, fordern Sie direkt auf, auch wenn eine Allow-Regel übereinstimmt. Inhalts-bezogene Ask-Regeln fallen auf eine Berechtigungsaufforderung zurück

360 2. Read-Only-Aktionen und Dateibearbeitungen in Ihrem Arbeitsverzeichnis werden automatisch genehmigt, außer Schreibvorgänge zu [geschützten Pfaden](#protected-paths)360 2. Read-Only-Aktionen und Dateibearbeitungen in Ihrem Arbeitsverzeichnis werden automatisch genehmigt, außer Schreibvorgänge zu [geschützten Pfaden](#protected-paths)

361 3. Alles andere geht zum Klassifizierer. Ein Connector-Tool [das Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) überspringt den Klassifizierer und fordert Sie direkt auf, sodass eine organisatorisch erforderliche Genehmigung niemals automatisch genehmigt wird. {{/* min-version: 2.1.199 */}}Ab v2.1.199 überspringt auch ein MCP-Tool, das mit [`_meta["anthropic/requiresUserInteraction"]`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet ist, den Klassifizierer und fordert Sie direkt auf, sodass ein Zustimmungsschritt niemals im Namen des Tool-Autors automatisch genehmigt wird361 3. Alles andere geht zum Klassifizierer. Ein Connector-Tool [das Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) überspringt den Klassifizierer und fordert Sie direkt auf, sodass eine organisatorisch erforderliche Genehmigung niemals automatisch genehmigt wird. {{/* min-version: 2.1.199 */}}Ab v2.1.199 überspringt auch ein MCP-Tool, das mit [`_meta["anthropic/requiresUserInteraction"]`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet ist, den Klassifizierer und fordert Sie direkt auf, sodass ein Zustimmungsschritt niemals im Namen des Tool-Autors automatisch genehmigt wird

362 4. Wenn der Klassifizierer blockiert, erhält Claude den Grund und versucht eine Alternative362 4. Wenn der Klassifizierer blockiert, erhält Claude den Grund und versucht eine Alternative

363 363

364 Beim Eintritt in den Auto-Modus werden breite Allow-Regeln, die willkürliche Code-Ausführung gewähren, gelöscht:364 Beim Eintritt in den Auto-Modus werden breite Allow-Regeln, die willkürliche Code-Ausführung gewähren, gelöscht:

374 </Accordion>374 </Accordion>

375 375

376 <Accordion title="Wie der Auto-Modus Subagenten handhabt">376 <Accordion title="Wie der Auto-Modus Subagenten handhabt">

377 Der Klassifizierer überprüft [Subagenten](/de/sub-agents)-Arbeit an drei Punkten:377 Der Klassifizierer überprüft [Subagenten](/docs/de/sub-agents)-Arbeit an drei Punkten:

378 378

379 1. Bevor ein Subagent startet, wird die delegierte Aufgabenbeschreibung bewertet, sodass eine gefährlich aussehende Aufgabe beim Spawn blockiert wird.379 1. Bevor ein Subagent startet, wird die delegierte Aufgabenbeschreibung bewertet, sodass eine gefährlich aussehende Aufgabe beim Spawn blockiert wird.

380 2. Während der Subagent läuft, durchläuft jede seiner Aktionen den Klassifizierer mit den gleichen Regeln wie die übergeordnete Sitzung, und jeder `permissionMode` in der Frontmatter des Subagenten wird ignoriert.380 2. Während der Subagent läuft, durchläuft jede seiner Aktionen den Klassifizierer mit den gleichen Regeln wie die übergeordnete Sitzung, und jeder `permissionMode` in der Frontmatter des Subagenten wird ignoriert.

394 Nur vorab genehmigte Tools mit dontAsk-Modus zulassen394 Nur vorab genehmigte Tools mit dontAsk-Modus zulassen

395</h2>395</h2>

396 396

397Wenn Sie den `dontAsk`-Modus einstellen, lehnt Claude Code automatisch jeden Tool-Aufruf ab, der sonst zu einer Eingabeaufforderung führen würde. Claude führt nur Aktionen aus, die Ihren `permissions.allow`-Regeln, [schreibgeschützten Bash-Befehlen](/de/permissions#read-only-commands) und Aufrufen entsprechen, die von einem [PreToolUse Hook](/de/permissions#extend-permissions-with-hooks) genehmigt wurden. Verwenden Sie diesen Modus für CI-Pipelines oder eingeschränkte Umgebungen, in denen Sie genau vordefinieren, was Claude tun darf; die Sitzung wartet nie auf Eingaben. Die Statusleiste zeigt `⏵⏵ don't ask on`, während dieser Modus aktiv ist.397Wenn Sie den `dontAsk`-Modus einstellen, lehnt Claude Code automatisch jeden Tool-Aufruf ab, der sonst zu einer Eingabeaufforderung führen würde. Claude führt nur Aktionen aus, die Ihren `permissions.allow`-Regeln, [schreibgeschützten Bash-Befehlen](/docs/de/permissions#read-only-commands) und Aufrufen entsprechen, die von einem [PreToolUse Hook](/docs/de/permissions#extend-permissions-with-hooks) genehmigt wurden. Verwenden Sie diesen Modus für CI-Pipelines oder eingeschränkte Umgebungen, in denen Sie genau vordefinieren, was Claude tun darf; die Sitzung wartet nie auf Eingaben. Die Statusleiste zeigt `⏵⏵ don't ask on`, während dieser Modus aktiv ist.

398 398

399Claude Code lehnt Aufrufe ab, die Ihren expliziten [`ask`-Regeln](/de/permissions#manage-permissions) entsprechen, anstatt zu einer Eingabeaufforderung zu führen. Es lehnt auch das integrierte `AskUserQuestion`-Tool und Connector-Tools ab, [die Ihre Organisation auf `ask` eingestellt hat](/de/mcp#organization-controls-on-connector-tools), auch wenn Ihre Allow-Regeln damit übereinstimmen. {/* min-version: 2.1.199 */}Es lehnt MCP-Tools, die mit [`_meta["anthropic/requiresUserInteraction"]`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, auf die gleiche Weise ab, da ihre Genehmigungskarte eine Antwort benötigt, die dieser Modus nie erfasst; dies erfordert Claude Code v2.1.199 oder später.399Claude Code lehnt Aufrufe ab, die Ihren expliziten [`ask`-Regeln](/docs/de/permissions#manage-permissions) entsprechen, anstatt zu einer Eingabeaufforderung zu führen. Es lehnt auch das integrierte `AskUserQuestion`-Tool und Connector-Tools ab, [die Ihre Organisation auf `ask` eingestellt hat](/docs/de/mcp#organization-controls-on-connector-tools), auch wenn Ihre Allow-Regeln damit übereinstimmen. Es lehnt MCP-Tools, die mit [`_meta["anthropic/requiresUserInteraction"]`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, auf die gleiche Weise ab, da ihre Genehmigungskarte eine Antwort benötigt, die dieser Modus nie erfasst; dies erfordert Claude Code v2.1.199 oder später.

400 400

401Cloud-Sitzungen auf [Claude Code im Web](/de/claude-code-on-the-web) ignorieren `defaultMode: "dontAsk"`; siehe [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) für Details.401Cloud-Sitzungen auf [Claude Code im Web](/docs/de/claude-code-on-the-web) ignorieren `defaultMode: "dontAsk"`; siehe [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) für Details.

402 402

403Legen Sie es beim Start mit dem Flag fest:403Legen Sie es beim Start mit dem Flag fest:

404 404

412 412

413Der Modus `bypassPermissions` deaktiviert Berechtigungsaufforderungen und Sicherheitsüberprüfungen, sodass Werkzeugaufrufe sofort ausgeführt werden, einschließlich Schreibvorgänge in [geschützte Pfade](#protected-paths). Vor v2.1.126 haben geschützte Pfade in diesem Modus noch Aufforderungen angezeigt.413Der Modus `bypassPermissions` deaktiviert Berechtigungsaufforderungen und Sicherheitsüberprüfungen, sodass Werkzeugaufrufe sofort ausgeführt werden, einschließlich Schreibvorgänge in [geschützte Pfade](#protected-paths). Vor v2.1.126 haben geschützte Pfade in diesem Modus noch Aufforderungen angezeigt.

414 414

415Explizite [ask-Regeln](/de/permissions#manage-permissions) und Connector-Werkzeuge, [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools), erzwingen in diesem Modus weiterhin eine Aufforderung. {/* min-version: 2.1.199 */}MCP-Werkzeuge, die mit [`_meta["anthropic/requiresUserInteraction"]`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, lösen ebenfalls weiterhin eine Aufforderung aus; dies erfordert Claude Code v2.1.199 oder später.415Explizite [ask-Regeln](/docs/de/permissions#manage-permissions) und Connector-Werkzeuge, [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), erzwingen in diesem Modus weiterhin eine Aufforderung. MCP-Werkzeuge, die mit [`_meta["anthropic/requiresUserInteraction"]`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, lösen ebenfalls weiterhin eine Aufforderung aus; dies erfordert Claude Code v2.1.199 oder später.

416 416

417Löschvorgänge, die das Dateisystem-Stammverzeichnis oder das Home-Verzeichnis betreffen, wie `rm -rf /` und `rm -rf ~`, lösen weiterhin als Schutzmaßnahme gegen Modellfehler eine Aufforderung aus. {/* min-version: 2.1.208 */}Die Schutzmaßnahme wird auch ausgelöst, wenn der Befehl Befehlsersetzung mit `$(...)` oder Backticks oder Prozessersetzung mit `<(...)` enthält, unabhängig davon, ob sich der Löschvorgang in der Ersetzung befindet, wie in `echo "$(rm -rf ~)"`, oder an anderer Stelle im selben Befehl. Die einfache Form, eingegeben als eigenständiger Befehl, hat in diesem Modus seit der Einführung der Schutzmaßnahme eine Aufforderung ausgelöst; vor v2.1.208 haben Befehle, die diese Formen enthielten, keine Aufforderung ausgelöst.417Löschvorgänge, die das Dateisystem-Stammverzeichnis oder das Home-Verzeichnis betreffen, wie `rm -rf /` und `rm -rf ~`, lösen weiterhin als Schutzmaßnahme gegen Modellfehler eine Aufforderung aus. Die Schutzmaßnahme wird auch ausgelöst, wenn der Befehl Befehlsersetzung mit `$(...)` oder Backticks oder Prozessersetzung mit `<(...)` enthält, unabhängig davon, ob sich der Löschvorgang in der Ersetzung befindet, wie in `echo "$(rm -rf ~)"`, oder an anderer Stelle im selben Befehl. Die einfache Form, eingegeben als eigenständiger Befehl, hat in diesem Modus seit der Einführung der Schutzmaßnahme eine Aufforderung ausgelöst; vor v2.1.208 haben Befehle, die diese Formen enthielten, keine Aufforderung ausgelöst.

418 418

419<Warning>419<Warning>

420 Verwenden Sie diesen Modus nur in isolierten Umgebungen wie Containern, VMs oder Dev-Containern ohne Internetzugang, in denen Claude Code Ihr Host-System nicht beschädigen kann.420 Verwenden Sie diesen Modus nur in isolierten Umgebungen wie Containern, VMs oder Dev-Containern ohne Internetzugang, in denen Claude Code Ihr Host-System nicht beschädigen kann.

434--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons434--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

435```435```

436 436

437Die Überprüfung wird automatisch in einer erkannten Sandbox übersprungen. Um autonom in einem Container zu laufen, verwenden Sie die [Dev-Container](/de/devcontainer)-Konfiguration, die Claude Code als Nicht-Root-Benutzer ausführt.437Die Überprüfung wird automatisch in einer erkannten Sandbox übersprungen. Um autonom in einem Container zu laufen, verwenden Sie die [Dev-Container](/docs/de/devcontainer)-Konfiguration, die Claude Code als Nicht-Root-Benutzer ausführt.

438 438

439[Claude Code im Web](/de/claude-code-on-the-web) berücksichtigt `defaultMode: "bypassPermissions"` oder `"dontAsk"` aus Ihren Einstellungsdateien nicht, daher können die eingecheckten Einstellungen eines Repositorys keine Cloud-Sitzung im Bypass-Permissions-Modus starten. Die Einstellung wird stillschweigend ignoriert und die Sitzung startet im Modus, der in der Modus-Dropdown angezeigt wird. Siehe [Berechtigungsmodi wechseln](#switch-permission-modes), welche Modi Cloud-Sitzungen bieten.439[Claude Code im Web](/docs/de/claude-code-on-the-web) berücksichtigt `defaultMode: "bypassPermissions"` oder `"dontAsk"` aus Ihren Einstellungsdateien nicht, daher können die eingecheckten Einstellungen eines Repositorys keine Cloud-Sitzung im Bypass-Permissions-Modus starten. Die Einstellung wird stillschweigend ignoriert und die Sitzung startet im Modus, der in der Modus-Dropdown angezeigt wird. Siehe [Berechtigungsmodi wechseln](#switch-permission-modes), welche Modi Cloud-Sitzungen bieten.

440 440

441<Warning>441<Warning>

442 `bypassPermissions` bietet keinen Schutz vor Prompt-Injection oder unbeabsichtigten Aktionen. Verwenden Sie stattdessen den [Auto-Modus](#eliminate-prompts-with-auto-mode) für Hintergrund-Sicherheitsüberprüfungen mit deutlich weniger Berechtigungsaufforderungen. Administratoren können diesen Modus blockieren, indem sie `permissions.disableBypassPermissionsMode` in [verwalteten Einstellungen](/de/permissions#managed-settings) auf `"disable"` setzen.442 `bypassPermissions` bietet keinen Schutz vor Prompt-Injection oder unbeabsichtigten Aktionen. Verwenden Sie stattdessen den [Auto-Modus](#eliminate-prompts-with-auto-mode) für Hintergrund-Sicherheitsüberprüfungen mit deutlich weniger Berechtigungsaufforderungen. Administratoren können diesen Modus blockieren, indem sie `permissions.disableBypassPermissionsMode` in [verwalteten Einstellungen](/docs/de/permissions#managed-settings) auf `"disable"` setzen.

443</Warning>443</Warning>

444 444

445<h2 id="protected-paths">445<h2 id="protected-paths">

457 457

458[`permissions.allow`](/de/permissions#manage-permissions) Regeln in Einstellungsdateien genehmigen Schreibvorgänge in geschützten Pfaden nicht im Voraus. Die Sicherheitsprüfung wird ausgeführt, bevor Claude Code die Allow-Regeln aus den Einstellungen auswertet, daher ändert ein Eintrag wie `Edit(.claude/**)` in `~/.claude/settings.json` oder `.claude/settings.json` das Ergebnis pro Modus in der obigen Tabelle nicht. In Modi, die abfragen, bietet die Eingabeaufforderung für einen `.claude/` Schreibvorgang **Ja, und Claude darf seine eigenen Einstellungen für diese Sitzung bearbeiten**, was spätere `.claude/` Schreibvorgänge in dieser Sitzung genehmigt, ohne erneut abzufragen.458[`permissions.allow`](/docs/de/permissions#manage-permissions) Regeln in Einstellungsdateien genehmigen Schreibvorgänge in geschützten Pfaden nicht im Voraus. Die Sicherheitsprüfung wird ausgeführt, bevor Claude Code die Allow-Regeln aus den Einstellungen auswertet, daher ändert ein Eintrag wie `Edit(.claude/**)` in `~/.claude/settings.json` oder `.claude/settings.json` das Ergebnis pro Modus in der obigen Tabelle nicht. In Modi, die abfragen, bietet die Eingabeaufforderung für einen `.claude/` Schreibvorgang **Ja, und Claude darf seine eigenen Einstellungen für diese Sitzung bearbeiten**, was spätere `.claude/` Schreibvorgänge in dieser Sitzung genehmigt, ohne erneut abzufragen.

459 459

460Geschützte Verzeichnisse:460Geschützte Verzeichnisse:

461 461

486 Siehe auch486 Siehe auch

487</h2>487</h2>

488 488

489* [Berechtigungen](/de/permissions): allow-, ask- und deny-Regeln; verwaltete Richtlinien489* [Berechtigungen](/docs/de/permissions): allow-, ask- und deny-Regeln; verwaltete Richtlinien

490* [Auto-Modus konfigurieren](/de/auto-mode-config): teilen Sie dem Klassifizierer mit, welche Infrastruktur Ihre Organisation vertraut490* [Auto-Modus konfigurieren](/docs/de/auto-mode-config): teilen Sie dem Klassifizierer mit, welche Infrastruktur Ihre Organisation vertraut

491* [Hooks](/de/hooks): benutzerdefinierte Berechtigungslogik über `PreToolUse` und `PermissionRequest` Hooks491* [Hooks](/docs/de/hooks): benutzerdefinierte Berechtigungslogik über `PreToolUse` und `PermissionRequest` Hooks

492* [Ultraplan](/de/ultraplan): führen Sie Plan Mode in einer Claude Code-Websitzung mit browsergestützter Überprüfung aus492* [Ultraplan](/docs/de/ultraplan): führen Sie Plan Mode in einer Claude Code-Websitzung mit browsergestützter Überprüfung aus

493* [Sicherheit](/de/security): Schutzmaßnahmen und Best Practices493* [Sicherheit](/docs/de/security): Schutzmaßnahmen und Best Practices

494* [Sandboxing](/de/sandboxing): Dateisystem- und Netzwerkisolation für Bash-Befehle494* [Sandboxing](/docs/de/sandboxing): Dateisystem- und Netzwerkisolation für Bash-Befehle

495* [Nicht-interaktiver Modus](/de/headless): führen Sie Claude Code mit dem Flag `-p` aus495* [Nicht-interaktiver Modus](/docs/de/headless): führen Sie Claude Code mit dem Flag `-p` aus

permissions.md +56 −56

Details

22 22

23Bei einer Bash- oder PowerShell-Berechtigungsaufforderung drücken Sie `Ctrl+E`, um eine Erklärung des Befehls anzuzeigen: was er tut, warum Claude ihn ausführt und was schiefgehen könnte, gekennzeichnet als **Niedriges Risiko**, **Mittleres Risiko** oder **Hohes Risiko**. Claude Code sendet den Befehl und Claudes eigene Beschreibung des Aufrufs an das Modell, um die Erklärung nur zu generieren, wenn Sie `Ctrl+E` drücken, nicht bei jeder Aufforderung. Das Anzeigen der Erklärung führt den Befehl nicht aus; drücken Sie `Ctrl+E` erneut, um sie auszublenden.23Bei einer Bash- oder PowerShell-Berechtigungsaufforderung drücken Sie `Ctrl+E`, um eine Erklärung des Befehls anzuzeigen: was er tut, warum Claude ihn ausführt und was schiefgehen könnte, gekennzeichnet als **Niedriges Risiko**, **Mittleres Risiko** oder **Hohes Risiko**. Claude Code sendet den Befehl und Claudes eigene Beschreibung des Aufrufs an das Modell, um die Erklärung nur zu generieren, wenn Sie `Ctrl+E` drücken, nicht bei jeder Aufforderung. Das Anzeigen der Erklärung führt den Befehl nicht aus; drücken Sie `Ctrl+E` erneut, um sie auszublenden.

24 24

~~25Um die Verknüpfung zu deaktivieren, setzen Sie [`permissionExplainerEnabled`](/de/settings#global-config-settings) auf `false` in `~/.claude.json`.~~25Um die Verknüpfung zu deaktivieren, setzen Sie [`permissionExplainerEnabled`](/docs/de/settings#global-config-settings) auf `false` in `~/.claude.json`.

26 26

27<h2 id="manage-permissions">27<h2 id="manage-permissions">

28 Berechtigungen verwalten28 Berechtigungen verwalten

41Deny-Regeln verhalten sich unterschiedlich, je nachdem, ob sie ein Werkzeug benennen oder ein Muster darin eingrenzen. Ein einfacher Werkzeugname wie `Bash` entfernt das Werkzeug vollständig aus Claudes Kontext, sodass Claude es nie sieht. Eine eingegrenzte Regel wie `Bash(rm *)` lässt das Werkzeug verfügbar und blockiert übereinstimmende Aufrufe, wenn Claude sie versucht.41Deny-Regeln verhalten sich unterschiedlich, je nachdem, ob sie ein Werkzeug benennen oder ein Muster darin eingrenzen. Ein einfacher Werkzeugname wie `Bash` entfernt das Werkzeug vollständig aus Claudes Kontext, sodass Claude es nie sieht. Eine eingegrenzte Regel wie `Bash(rm *)` lässt das Werkzeug verfügbar und blockiert übereinstimmende Aufrufe, wenn Claude sie versucht.

42 42

43<Note>43<Note>

44 Berechtigungsregeln werden von Claude Code durchgesetzt, nicht vom Modell. Anweisungen in Ihrem Prompt oder `CLAUDE.md` bestimmen, was Claude versucht zu tun, aber sie ändern nicht, was Claude Code erlaubt. Um Zugriff zu gewähren oder zu widerrufen, verwenden Sie `/permissions`, die hier beschriebenen Regeln, einen [Berechtigungsmodus](/de/permission-modes) oder einen [PreToolUse-Hook](#extend-permissions-with-hooks).44 Berechtigungsregeln werden von Claude Code durchgesetzt, nicht vom Modell. Anweisungen in Ihrem Prompt oder `CLAUDE.md` bestimmen, was Claude versucht zu tun, aber sie ändern nicht, was Claude Code erlaubt. Um Zugriff zu gewähren oder zu widerrufen, verwenden Sie `/permissions`, die hier beschriebenen Regeln, einen [Berechtigungsmodus](/docs/de/permission-modes) oder einen [PreToolUse-Hook](#extend-permissions-with-hooks).

45</Note>45</Note>

46 46

47<h2 id="permission-modes">47<h2 id="permission-modes">

48 Berechtigungsmodi48 Berechtigungsmodi

49</h2>49</h2>

50 50

51Claude Code unterstützt mehrere Berechtigungsmodi, die steuern, wie Werkzeugaufrufe genehmigt werden. Siehe [Berechtigungsmodi](/de/permission-modes) für den Zeitpunkt der Verwendung jedes Modus. Legen Sie den `defaultMode` in Ihren [Einstellungsdateien](/de/settings#settings-files) fest:51Claude Code unterstützt mehrere Berechtigungsmodi, die steuern, wie Werkzeugaufrufe genehmigt werden. Siehe [Berechtigungsmodi](/docs/de/permission-modes) für den Zeitpunkt der Verwendung jedes Modus. Legen Sie den `defaultMode` in Ihren [Einstellungsdateien](/docs/de/settings#settings-files) fest:

52 52

53| Modus | Beschreibung |53| Modus | Beschreibung |

54| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |54| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

55| `default` | Standardverhalten: fordert Genehmigung bei der ersten Verwendung jedes Werkzeugs auf. {/* min-version: 2.1.200 */}Im CLI und in den VS Code- und JetBrains-Erweiterungen sowie in der Desktop-App als „Manual" gekennzeichnet, und Claude Code akzeptiert `manual` als Alias. Die Bezeichnung und der Alias erfordern Claude Code v2.1.200 oder später. Die Bezeichnung der Desktop-App hängt nicht von Ihrer CLI-Version ab |55| `default` | Standardverhalten: fordert Genehmigung bei der ersten Verwendung jedes Werkzeugs auf. Im CLI und in den VS Code- und JetBrains-Erweiterungen sowie in der Desktop-App als „Manual" gekennzeichnet, und Claude Code akzeptiert `manual` als Alias. Die Bezeichnung und der Alias erfordern Claude Code v2.1.200 oder später. Die Bezeichnung der Desktop-App hängt nicht von Ihrer CLI-Version ab |

56| `acceptEdits` | Akzeptiert automatisch Dateiberechtigungen und häufige Dateisystem-Befehle wie `mkdir`, `touch`, `mv` und `cp` für Pfade im Arbeitsverzeichnis oder `additionalDirectories` |56| `acceptEdits` | Akzeptiert automatisch Dateiberechtigungen und häufige Dateisystem-Befehle wie `mkdir`, `touch`, `mv` und `cp` für Pfade im Arbeitsverzeichnis oder `additionalDirectories` |

57| `plan` | Claude liest Dateien und führt schreibgeschützte Shell-Befehle aus, um zu erkunden, bearbeitet aber nicht Ihre Quelldateien. Im CLI und in der VS Code-Erweiterung als Plan gekennzeichnet |57| `plan` | Claude liest Dateien und führt schreibgeschützte Shell-Befehle aus, um zu erkunden, bearbeitet aber nicht Ihre Quelldateien. Im CLI und in der VS Code-Erweiterung als Plan gekennzeichnet |

58| `auto` | Genehmigt Werkzeugaufrufe automatisch mit Hintergrund-Sicherheitsprüfungen, die überprüfen, ob Aktionen mit Ihrer Anfrage übereinstimmen |58| `auto` | Genehmigt Werkzeugaufrufe automatisch mit Hintergrund-Sicherheitsprüfungen, die überprüfen, ob Aktionen mit Ihrer Anfrage übereinstimmen |

59| `dontAsk` | Verweigert Werkzeuge automatisch, es sei denn, sie sind vorab über `/permissions` oder `permissions.allow`-Regeln genehmigt. `AskUserQuestion`, Connector-Werkzeuge [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und MCP-Werkzeuge, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, werden verweigert, auch wenn Sie diese genehmigt haben |59| `dontAsk` | Verweigert Werkzeuge automatisch, es sei denn, sie sind vorab über `/permissions` oder `permissions.allow`-Regeln genehmigt. `AskUserQuestion`, Connector-Werkzeuge [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und MCP-Werkzeuge, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, werden verweigert, auch wenn Sie diese genehmigt haben |

60| `bypassPermissions` | Überspringt Berechtigungsaufforderungen, außer denen, die durch explizite `ask`-Regeln erzwungen werden, Connector-Werkzeuge [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und MCP-Werkzeuge, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind. Entfernungen von Dateisystem-Root oder Home-Verzeichnis wie `rm -rf /` fordern weiterhin auf als Schutzschalter |60| `bypassPermissions` | Überspringt Berechtigungsaufforderungen, außer denen, die durch explizite `ask`-Regeln erzwungen werden, Connector-Werkzeuge [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und MCP-Werkzeuge, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind. Entfernungen von Dateisystem-Root oder Home-Verzeichnis wie `rm -rf /` fordern weiterhin auf als Schutzschalter |

61 61

62<Warning>62<Warning>

63 Der Modus `bypassPermissions` überspringt Berechtigungsaufforderungen, einschließlich Schreibvorgänge in `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` und `.mvn`. Verwenden Sie diesen Modus nur in isolierten Umgebungen wie Containern oder VMs, in denen Claude Code keinen Schaden anrichten kann.63 Der Modus `bypassPermissions` überspringt Berechtigungsaufforderungen, einschließlich Schreibvorgänge in `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` und `.mvn`. Verwenden Sie diesen Modus nur in isolierten Umgebungen wie Containern oder VMs, in denen Claude Code keinen Schaden anrichten kann.

64 64

65 Einige wenige Aufforderungen werden in diesem Modus weiterhin angezeigt. Explizite `ask`-Regeln, Connector-Werkzeuge [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und MCP-Werkzeuge, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, fordern weiterhin auf. Entfernungen, die auf das Dateisystem-Root oder Home-Verzeichnis abzielen, wie `rm -rf /` und `rm -rf ~`, fordern weiterhin auf als Schutzschalter gegen Modellfehler, {/* min-version: 2.1.208 */}einschließlich wenn der Befehl Befehlsersetzung mit `$(...)` oder Backticks oder Prozessersetzung mit `<(...)` enthält. Vor v2.1.208 forderten nur die einfache Form auf, wie `rm -rf ~` als eigenständiger Befehl eingegeben, auf; Befehle, die die Entfernung durch eine Ersetzung erreichten, forderten nicht auf.65 Einige wenige Aufforderungen werden in diesem Modus weiterhin angezeigt. Explizite `ask`-Regeln, Connector-Werkzeuge [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und MCP-Werkzeuge, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, fordern weiterhin auf. Entfernungen, die auf das Dateisystem-Root oder Home-Verzeichnis abzielen, wie `rm -rf /` und `rm -rf ~`, fordern weiterhin auf als Schutzschalter gegen Modellfehler, einschließlich wenn der Befehl Befehlsersetzung mit `$(...)` oder Backticks oder Prozessersetzung mit `<(...)` enthält. Vor v2.1.208 forderten nur die einfache Form auf, wie `rm -rf ~` als eigenständiger Befehl eingegeben, auf; Befehle, die die Entfernung durch eine Ersetzung erreichten, forderten nicht auf.

66</Warning>66</Warning>

67 67

68Um zu verhindern, dass der Modus `bypassPermissions` oder `auto` verwendet wird, setzen Sie `permissions.disableBypassPermissionsMode` oder `permissions.disableAutoMode` auf `"disable"` in einer beliebigen [Einstellungsdatei](/de/settings#settings-files). Diese sind am nützlichsten in [verwalteten Einstellungen](#managed-settings), wo sie nicht überschrieben werden können.68Um zu verhindern, dass der Modus `bypassPermissions` oder `auto` verwendet wird, setzen Sie `permissions.disableBypassPermissionsMode` oder `permissions.disableAutoMode` auf `"disable"` in einer beliebigen [Einstellungsdatei](/docs/de/settings#settings-files). Diese sind am nützlichsten in [verwalteten Einstellungen](#managed-settings), wo sie nicht überschrieben werden können.

69 69

70<h2 id="permission-rule-syntax">70<h2 id="permission-rule-syntax">

71 Berechtigungsregelsyntax71 Berechtigungsregelsyntax

117* Jede Regel benennt einen Parameter. Um sowohl `model` als auch `isolation` zu steuern, schreiben Sie zwei Regeln, `Agent(model:opus)` und `Agent(isolation:worktree)`, anstatt sie in einer Regel zu kombinieren117* Jede Regel benennt einen Parameter. Um sowohl `model` als auch `isolation` zu steuern, schreiben Sie zwei Regeln, `Agent(model:opus)` und `Agent(isolation:worktree)`, anstatt sie in einer Regel zu kombinieren

118* Der Wert unterstützt `*` als Platzhalter, der jede Zeichenfolge abgleicht, daher gleicht `Agent(isolation:*)` jeden expliziten Isolationswert ab. Ohne `*` ist der Abgleich exakt118* Der Wert unterstützt `*` als Platzhalter, der jede Zeichenfolge abgleicht, daher gleicht `Agent(isolation:*)` jeden expliziten Isolationswert ab. Ohne `*` ist der Abgleich exakt

119* Ein Parameter, den das Modell auslässt, wird nie abgeglichen, daher gleicht `Agent(model:*)` einen Aufruf nicht ab, der `model` nicht gesetzt lässt119* Ein Parameter, den das Modell auslässt, wird nie abgeglichen, daher gleicht `Agent(model:*)` einen Aufruf nicht ab, der `model` nicht gesetzt lässt

120* Der Wert wird mit der literalen Eingabe verglichen, die Claude sendet, bevor eine Normalisierung erfolgt. `Agent(model:opus)` gleicht den Alias `opus` ab, aber nicht eine vollständige Modell-ID. Führen Sie mit [`--verbose`](/de/cli-reference) aus, um die genauen Parameternamen und Werte in jedem Werkzeugaufruf zu sehen120* Der Wert wird mit der literalen Eingabe verglichen, die Claude sendet, bevor eine Normalisierung erfolgt. `Agent(model:opus)` gleicht den Alias `opus` ab, aber nicht eine vollständige Modell-ID. Führen Sie mit [`--verbose`](/docs/de/cli-reference) aus, um die genauen Parameternamen und Werte in jedem Werkzeugaufruf zu sehen

121* Leerzeichen um den Doppelpunkt werden ignoriert121* Leerzeichen um den Doppelpunkt werden ignoriert

122 122

123Felder, die ein Werkzeug bereits mit seinen eigenen kanonisierenden Regeln abgleicht, können auf diese Weise nicht abgeglichen werden: `command` für Bash und PowerShell, `file_path` für Read, Edit und Write, `path` für Grep und Glob, `notebook_path` für NotebookEdit und `url` für WebFetch. Eine Regel wie `Bash(command:rm *)` könnte durch einen zusammengesetzten Befehl umgangen werden, daher ignoriert Claude Code sie und gibt eine Startwarnmeldung aus. Verwenden Sie stattdessen `Bash(rm *)`, `Read(./path)` oder `WebFetch(domain:host)`.123Felder, die ein Werkzeug bereits mit seinen eigenen kanonisierenden Regeln abgleicht, können auf diese Weise nicht abgeglichen werden: `command` für Bash und PowerShell, `file_path` für Read, Edit und Write, `path` für Grep und Glob, `notebook_path` für NotebookEdit und `url` für WebFetch. Eine Regel wie `Bash(command:rm *)` könnte durch einen zusammengesetzten Befehl umgangen werden, daher ignoriert Claude Code sie und gibt eine Startwarnmeldung aus. Verwenden Sie stattdessen `Bash(rm *)`, `Read(./path)` oder `WebFetch(domain:host)`.

169 169

170Eine Ablehnungs- oder Anfrage-Regel, deren Werkzeugname mit keinem bekannten Werkzeug übereinstimmt, erzeugt eine Startwarnmeldung, um Tippfehler zu erfassen. Werkzeugnamen, die `_` oder `*` enthalten, sind von der Überprüfung ausgenommen.170Eine Ablehnungs- oder Anfrage-Regel, deren Werkzeugname mit keinem bekannten Werkzeug übereinstimmt, erzeugt eine Startwarnmeldung, um Tippfehler zu erfassen. Werkzeugnamen, die `_` oder `*` enthalten, sind von der Überprüfung ausgenommen.

171 171

172Das Etikett, das für ein Werkzeug im Transkript und im Berechtigungsdialog angezeigt wird, kann sich vom kanonischen Namen unterscheiden. Beispielsweise hat das Werkzeug mit der Bezeichnung `Stop Task` im Transkript den kanonischen Namen `TaskStop`. Berechtigungsregeln und [Hook-Matcher](/de/hooks) gleichen nur den kanonischen Namen ab, daher passt eine Regel, die als `Stop Task` geschrieben ist, nicht. Für Ablehnungs- und Anfrage-Regeln erfasst die obige Startwarnmeldung die Nichtübereinstimmung. Verwenden Sie die kanonischen Namen, die in der [Werkzeugreferenz](/de/tools-reference) aufgelistet sind.172Das Etikett, das für ein Werkzeug im Transkript und im Berechtigungsdialog angezeigt wird, kann sich vom kanonischen Namen unterscheiden. Beispielsweise hat das Werkzeug mit der Bezeichnung `Stop Task` im Transkript den kanonischen Namen `TaskStop`. Berechtigungsregeln und [Hook-Matcher](/docs/de/hooks) gleichen nur den kanonischen Namen ab, daher passt eine Regel, die als `Stop Task` geschrieben ist, nicht. Für Ablehnungs- und Anfrage-Regeln erfasst die obige Startwarnmeldung die Nichtübereinstimmung. Verwenden Sie die kanonischen Namen, die in der [Werkzeugreferenz](/docs/de/tools-reference) aufgelistet sind.

173 173

174<h2 id="tool-specific-permission-rules">174<h2 id="tool-specific-permission-rules">

175 Werkzeugspezifische Berechtigungsregeln175 Werkzeugspezifische Berechtigungsregeln

271 Read und Edit271 Read und Edit

272</h3>272</h3>

273 273

274`Edit`-Regeln gelten für alle integrierten Werkzeuge, die Dateien bearbeiten. Claude versucht nach besten Kräften, `Read`-Regeln auf alle integrierten Werkzeuge anzuwenden, die Dateien lesen, wie Grep und Glob, auf `@file`-Erwähnungen in Ihren Eingabeaufforderungen und auf die Auswahl und offene Datei-Kontexte, die ein verbundener [IDE](/de/vs-code#the-built-in-ide-mcp-server) mit Claude teilt.274`Edit`-Regeln gelten für alle integrierten Werkzeuge, die Dateien bearbeiten. Claude versucht nach besten Kräften, `Read`-Regeln auf alle integrierten Werkzeuge anzuwenden, die Dateien lesen, wie Grep und Glob, auf `@file`-Erwähnungen in Ihren Eingabeaufforderungen und auf die Auswahl und offene Datei-Kontexte, die ein verbundener [IDE](/docs/de/vs-code#the-built-in-ide-mcp-server) mit Claude teilt.

275 275

276Eine `Read`-Deny-Regel blockiert auch das [Edit-Werkzeug](/de/errors#file-is-covered-by-a-read-deny-rule) auf demselben Pfad, einschließlich der Erstellung einer neuen Datei dort. Write und NotebookEdit sind nicht abgedeckt, daher fügen Sie eine `Edit`-Deny-Regel für Pfade hinzu, die kein Werkzeug ändern darf. Erfordert Claude Code v2.1.208 oder später.276Eine `Read`-Deny-Regel blockiert auch das [Edit-Werkzeug](/docs/de/errors#file-is-covered-by-a-read-deny-rule) auf demselben Pfad, einschließlich der Erstellung einer neuen Datei dort. Write und NotebookEdit sind nicht abgedeckt, daher fügen Sie eine `Edit`-Deny-Regel für Pfade hinzu, die kein Werkzeug ändern darf. Erfordert Claude Code v2.1.208 oder später.

277 277

278<Warning>278<Warning>

279 Read- und Edit-Deny-Regeln gelten für Claude's integrierte Dateiwerkzeuge und für Dateibefehle, die Claude Code in Bash erkennt, wie `cat`, `head`, `tail` und `sed`. Sie gelten nicht für beliebige Unterprozesse, die Dateien indirekt lesen oder schreiben, wie ein Python- oder Node-Skript, das Dateien selbst öffnet. Für OS-Ebenen-Durchsetzung, die alle Prozesse daran hindert, auf einen Pfad zuzugreifen, [aktivieren Sie die Sandbox](/de/sandboxing).279 Read- und Edit-Deny-Regeln gelten für Claude's integrierte Dateiwerkzeuge und für Dateibefehle, die Claude Code in Bash erkennt, wie `cat`, `head`, `tail` und `sed`. Sie gelten nicht für beliebige Unterprozesse, die Dateien indirekt lesen oder schreiben, wie ein Python- oder Node-Skript, das Dateien selbst öffnet. Für OS-Ebenen-Durchsetzung, die alle Prozesse daran hindert, auf einen Pfad zuzugreifen, [aktivieren Sie die Sandbox](/docs/de/sandboxing).

280</Warning>280</Warning>

281 281

282Read- und Edit-Regeln folgen beide der [gitignore](https://git-scm.com/docs/gitignore)-Spezifikation mit vier unterschiedlichen Mustertypen:282Read- und Edit-Regeln folgen beide der [gitignore](https://git-scm.com/docs/gitignore)-Spezifikation mit vier unterschiedlichen Mustertypen:

352* `mcp__puppeteer__*` verwendet Wildcard-Syntax und gleicht auch alle Werkzeuge vom `puppeteer`-Server ab352* `mcp__puppeteer__*` verwendet Wildcard-Syntax und gleicht auch alle Werkzeuge vom `puppeteer`-Server ab

353* `mcp__puppeteer__puppeteer_navigate` gleicht das `puppeteer_navigate`-Werkzeug ab, das vom `puppeteer`-Server bereitgestellt wird353* `mcp__puppeteer__puppeteer_navigate` gleicht das `puppeteer_navigate`-Werkzeug ab, das vom `puppeteer`-Server bereitgestellt wird

354 354

355Wenn Ihre Organisation ein [claude.ai-Connector](/de/mcp#organization-controls-on-connector-tools)-Werkzeug auf `ask` gesetzt hat, nehmen Allow-Regeln für dieses Werkzeug keine Wirkung: Claude Code fordert bei jedem Aufruf auf, auch in `auto`- und `bypassPermissions`-Modi. Im `dontAsk`-Modus, der niemals auffordert, verweigert Claude Code den Aufruf stattdessen. Connector-Werkzeuge erscheinen als `mcp__claude_ai_<server>__<tool>`.355Wenn Ihre Organisation ein [claude.ai-Connector](/docs/de/mcp#organization-controls-on-connector-tools)-Werkzeug auf `ask` gesetzt hat, nehmen Allow-Regeln für dieses Werkzeug keine Wirkung: Claude Code fordert bei jedem Aufruf auf, auch in `auto`- und `bypassPermissions`-Modi. Im `dontAsk`-Modus, der niemals auffordert, verweigert Claude Code den Aufruf stattdessen. Connector-Werkzeuge erscheinen als `mcp__claude_ai_<server>__<tool>`.

356 356

357<h3 id="agent-subagents">357<h3 id="agent-subagents">

358 Agent (Subagents)358 Agent (Subagents)

359</h3>359</h3>

360 360

361Verwenden Sie `Agent(AgentName)`-Regeln, um zu steuern, welche [Subagents](/de/sub-agents) Claude verwenden kann:361Verwenden Sie `Agent(AgentName)`-Regeln, um zu steuern, welche [Subagents](/docs/de/sub-agents) Claude verwenden kann:

362 362

363* `Agent(Explore)` gleicht den Explore-Subagent ab363* `Agent(Explore)` gleicht den Explore-Subagent ab

364* `Agent(Plan)` gleicht den Plan-Subagent ab364* `Agent(Plan)` gleicht den Plan-Subagent ab

378 Cd378 Cd

379</h3>379</h3>

380 380

381`Cd`-Regeln steuern, in welche Verzeichnisse der [`/cd`-Befehl](/de/commands) die Sitzung verschieben kann. `Cd` ist kein vom Modell aufzurufendes Werkzeug: Claude kann es nicht aufrufen, und die Regeln gelten nur, wenn Sie `/cd` selbst ausführen.381`Cd`-Regeln steuern, in welche Verzeichnisse der [`/cd`-Befehl](/docs/de/commands) die Sitzung verschieben kann. `Cd` ist kein vom Modell aufzurufendes Werkzeug: Claude kann es nicht aufrufen, und die Regeln gelten nur, wenn Sie `/cd` selbst ausführen.

382 382

383Eine bloße `Cd`-Deny-Regel deaktiviert `/cd` vollständig. Eine `Cd(<path-pattern>)`-Deny-Regel blockiert übereinstimmende Ziele. Deny-Regeln überprüfen jede Schreibweise des Ziels, einschließlich jedes Symlink-Hops, durch den es sich auflöst, daher blockiert eine Regel, die für einen Pfad geschrieben wurde, auch Ziele, die sich darin auflösen.383Eine bloße `Cd`-Deny-Regel deaktiviert `/cd` vollständig. Eine `Cd(<path-pattern>)`-Deny-Regel blockiert übereinstimmende Ziele. Deny-Regeln überprüfen jede Schreibweise des Ziels, einschließlich jedes Symlink-Hops, durch den es sich auflöst, daher blockiert eine Regel, die für einen Pfad geschrieben wurde, auch Ziele, die sich darin auflösen.

384 384

396 Berechtigungen mit Hooks erweitern396 Berechtigungen mit Hooks erweitern

397</h2>397</h2>

398 398

399[Claude Code Hooks](/de/hooks-guide) bieten eine Möglichkeit, benutzerdefinierte Shell-Befehle zu registrieren, um die Berechtigungsevaluierung zur Laufzeit durchzuführen. Wenn Claude Code einen Werkzeugaufruf tätigt, werden PreToolUse-Hooks vor dem Berechtigungssystem ausgeführt. Die Hook-Ausgabe kann den Werkzeugaufruf verweigern, eine Aufforderung erzwingen oder die Aufforderung überspringen, um den Aufruf fortzufahren.399[Claude Code Hooks](/docs/de/hooks-guide) bieten eine Möglichkeit, benutzerdefinierte Shell-Befehle zu registrieren, um die Berechtigungsevaluierung zur Laufzeit durchzuführen. Wenn Claude Code einen Werkzeugaufruf tätigt, werden PreToolUse-Hooks vor dem Berechtigungssystem ausgeführt. Die Hook-Ausgabe kann den Werkzeugaufruf verweigern, eine Aufforderung erzwingen oder die Aufforderung überspringen, um den Aufruf fortzufahren.

400 400

401Hook-Entscheidungen umgehen keine Berechtigungsregeln. Deny- und Ask-Regeln werden unabhängig davon ausgewertet, was ein PreToolUse-Hook zurückgibt, daher blockiert eine übereinstimmende Deny-Regel den Aufruf und eine übereinstimmende Ask-Regel fordert immer noch auf, selbst wenn der Hook `"allow"` oder `"ask"` zurückgegeben hat. Dies bewahrt die Deny-First-Priorität, die in [Berechtigungen verwalten](#manage-permissions) beschrieben ist, einschließlich Deny-Regeln, die in verwalteten Einstellungen festgelegt sind.401Hook-Entscheidungen umgehen keine Berechtigungsregeln. Deny- und Ask-Regeln werden unabhängig davon ausgewertet, was ein PreToolUse-Hook zurückgibt, daher blockiert eine übereinstimmende Deny-Regel den Aufruf und eine übereinstimmende Ask-Regel fordert immer noch auf, selbst wenn der Hook `"allow"` oder `"ask"` zurückgegeben hat. Dies bewahrt die Deny-First-Priorität, die in [Berechtigungen verwalten](#manage-permissions) beschrieben ist, einschließlich Deny-Regeln, die in verwalteten Einstellungen festgelegt sind.

402 402

403Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und MCP-Tools, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, werden auch weiterhin aufgefordert, wenn ein Hook `"allow"` zurückgibt.403Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und MCP-Tools, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, werden auch weiterhin aufgefordert, wenn ein Hook `"allow"` zurückgibt.

404 404

405Ein blockierender Hook hat auch Vorrang vor Allow-Regeln. Ein Hook, der mit Code 2 beendet wird, stoppt den Werkzeugaufruf, bevor Berechtigungsregeln ausgewertet werden, daher gilt die Blockierung auch dann, wenn eine Allow-Regel den Aufruf sonst zulassen würde. Um alle Bash-Befehle ohne Aufforderungen auszuführen, außer für einige, die Sie blockieren möchten, fügen Sie `"Bash"` zu Ihrer Allow-Liste hinzu und registrieren Sie einen PreToolUse-Hook, der diese spezifischen Befehle ablehnt. Siehe [Bearbeitungen geschützter Dateien blockieren](/de/hooks-guide#block-edits-to-protected-files) für ein Hook-Skript, das Sie anpassen können.405Ein blockierender Hook hat auch Vorrang vor Allow-Regeln. Ein Hook, der mit Code 2 beendet wird, stoppt den Werkzeugaufruf, bevor Berechtigungsregeln ausgewertet werden, daher gilt die Blockierung auch dann, wenn eine Allow-Regel den Aufruf sonst zulassen würde. Um alle Bash-Befehle ohne Aufforderungen auszuführen, außer für einige, die Sie blockieren möchten, fügen Sie `"Bash"` zu Ihrer Allow-Liste hinzu und registrieren Sie einen PreToolUse-Hook, der diese spezifischen Befehle ablehnt. Siehe [Bearbeitungen geschützter Dateien blockieren](/docs/de/hooks-guide#block-edits-to-protected-files) für ein Hook-Skript, das Sie anpassen können.

406 406

407<h2 id="working-directories">407<h2 id="working-directories">

408 Arbeitsverzeichnisse408 Arbeitsverzeichnisse

412 412

413* **Beim Start**: Verwenden Sie das CLI-Argument `--add-dir <path>`413* **Beim Start**: Verwenden Sie das CLI-Argument `--add-dir <path>`

414* **Während der Sitzung**: Verwenden Sie den Befehl `/add-dir`414* **Während der Sitzung**: Verwenden Sie den Befehl `/add-dir`

415* **Persistente Konfiguration**: Fügen Sie zu `additionalDirectories` in [Einstellungsdateien](/de/settings#settings-files) hinzu415* **Persistente Konfiguration**: Fügen Sie zu `additionalDirectories` in [Einstellungsdateien](/docs/de/settings#settings-files) hinzu

416 416

417Dateien in zusätzlichen Verzeichnissen folgen den gleichen Berechtigungsregeln wie das ursprüngliche Arbeitsverzeichnis: Sie werden lesbar ohne Aufforderungen, und Dateiberechtigungen folgen dem aktuellen Berechtigungsmodus.417Dateien in zusätzlichen Verzeichnissen folgen den gleichen Berechtigungsregeln wie das ursprüngliche Arbeitsverzeichnis: Sie werden lesbar ohne Aufforderungen, und Dateiberechtigungen folgen dem aktuellen Berechtigungsmodus.

418 418

419In Hintergrund-Sitzungen auf macOS fordert der Sitzungs-Host Zugriff auf geschützte Ordner wie `~/Desktop`, `~/Documents` und `~/Downloads` separat von Ihrem Terminal an, wenn Claude dort Dateien lesen oder schreiben muss; wenn Lesevorgänge dort mit `Operation not permitted` fehlschlagen, siehe [wie man Ordnerzugriff auf Hintergrund-Sitzungen auf macOS gewährt](/de/agent-view#background-sessions-can't-read-desktop-documents-or-downloads-on-macos).419In Hintergrund-Sitzungen auf macOS fordert der Sitzungs-Host Zugriff auf geschützte Ordner wie `~/Desktop`, `~/Documents` und `~/Downloads` separat von Ihrem Terminal an, wenn Claude dort Dateien lesen oder schreiben muss; wenn Lesevorgänge dort mit `Operation not permitted` fehlschlagen, siehe [wie man Ordnerzugriff auf Hintergrund-Sitzungen auf macOS gewährt](/docs/de/agent-view#background-sessions-can't-read-desktop-documents-or-downloads-on-macos).

420 420

421Um das primäre Arbeitsverzeichnis der Sitzung zu ändern, anstatt ein weiteres hinzuzufügen, verwenden Sie [`/cd`](/de/commands). Der Befehl `/cd` erfordert Claude Code v2.1.169 oder später. Im Gegensatz zu `/add-dir` verlagert er die Sitzung: Die `CLAUDE.md` des neuen Verzeichnisses wird geladen und `--resume` findet die Sitzung von dort aus.421Um das primäre Arbeitsverzeichnis der Sitzung zu ändern, anstatt ein weiteres hinzuzufügen, verwenden Sie [`/cd`](/docs/de/commands). Der Befehl `/cd` erfordert Claude Code v2.1.169 oder später. Im Gegensatz zu `/add-dir` verlagert er die Sitzung: Die `CLAUDE.md` des neuen Verzeichnisses wird geladen und `--resume` findet die Sitzung von dort aus.

422 422

423<h3 id="additional-directories-grant-file-access-not-configuration">423<h3 id="additional-directories-grant-file-access-not-configuration">

424 Zusätzliche Verzeichnisse gewähren Dateizugriff, keine Konfiguration424 Zusätzliche Verzeichnisse gewähren Dateizugriff, keine Konfiguration

432 432

434| :----------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |434| :----------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

436| [Subagents](/de/sub-agents) in `.claude/agents/` | Ja |436| [Subagents](/docs/de/sub-agents) in `.claude/agents/` | Ja |

437| [Einstellungen](/de/settings) in `.claude/settings.json` und `.claude/settings.local.json` | Nur `enabledPlugins` und `extraKnownMarketplaces` Schlüssel |437| [Einstellungen](/docs/de/settings) in `.claude/settings.json` und `.claude/settings.local.json` | Nur `enabledPlugins` und `extraKnownMarketplaces` Schlüssel |

438| [CLAUDE.md](/de/memory)-Dateien, `.claude/rules/` und `CLAUDE.local.md` | Nur wenn `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` gesetzt ist. `CLAUDE.local.md` erfordert zusätzlich die `local`-Einstellungsquelle, die standardmäßig aktiviert ist |438| [CLAUDE.md](/docs/de/memory)-Dateien, `.claude/rules/` und `CLAUDE.local.md` | Nur wenn `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` gesetzt ist. `CLAUDE.local.md` erfordert zusätzlich die `local`-Einstellungsquelle, die standardmäßig aktiviert ist |

439 439

440Befehle und Ausgabestile werden aus dem aktuellen Arbeitsverzeichnis und seinen übergeordneten Verzeichnissen, Ihrem Benutzerverzeichnis unter `~/.claude/` und verwalteten Einstellungen erkannt. Hooks und andere `settings.json`-Schlüssel werden aus dem `.claude/`-Ordner des aktuellen Arbeitsverzeichnisses ohne Fallback für übergeordnete Verzeichnisse geladen, zusammen mit Ihren Benutzer-`~/.claude/settings.json` und verwalteten Einstellungen. Um diese Konfiguration über Projekte hinweg zu teilen, verwenden Sie einen dieser Ansätze:440Befehle und Ausgabestile werden aus dem aktuellen Arbeitsverzeichnis und seinen übergeordneten Verzeichnissen, Ihrem Benutzerverzeichnis unter `~/.claude/` und verwalteten Einstellungen erkannt. Hooks und andere `settings.json`-Schlüssel werden aus dem `.claude/`-Ordner des aktuellen Arbeitsverzeichnisses ohne Fallback für übergeordnete Verzeichnisse geladen, zusammen mit Ihren Benutzer-`~/.claude/settings.json` und verwalteten Einstellungen. Um diese Konfiguration über Projekte hinweg zu teilen, verwenden Sie einen dieser Ansätze:

441 441

442* **Benutzergesteuerte Konfiguration**: Platzieren Sie Dateien in `~/.claude/agents/`, `~/.claude/output-styles/` oder `~/.claude/settings.json`, um sie in jedem Projekt verfügbar zu machen442* **Benutzergesteuerte Konfiguration**: Platzieren Sie Dateien in `~/.claude/agents/`, `~/.claude/output-styles/` oder `~/.claude/settings.json`, um sie in jedem Projekt verfügbar zu machen

443* **Plugins**: Verpacken und verteilen Sie Konfiguration als [Plugin](/de/plugins), das Teams installieren können443* **Plugins**: Verpacken und verteilen Sie Konfiguration als [Plugin](/docs/de/plugins), das Teams installieren können

444* **Starten Sie aus dem Konfigurationsverzeichnis**: Führen Sie Claude Code aus dem Verzeichnis aus, das die `.claude/`-Konfiguration enthält, die Sie verwenden möchten444* **Starten Sie aus dem Konfigurationsverzeichnis**: Führen Sie Claude Code aus dem Verzeichnis aus, das die `.claude/`-Konfiguration enthält, die Sie verwenden möchten

445 445

446<h2 id="how-permissions-interact-with-sandboxing">446<h2 id="how-permissions-interact-with-sandboxing">

447 Wie Berechtigungen mit Sandboxing interagieren447 Wie Berechtigungen mit Sandboxing interagieren

448</h2>448</h2>

449 449

450Berechtigungen und [Sandboxing](/de/sandboxing) sind komplementäre Sicherheitsebenen:450Berechtigungen und [Sandboxing](/docs/de/sandboxing) sind komplementäre Sicherheitsebenen:

451 451

452* **Berechtigungen** steuern, welche Werkzeuge Claude Code verwenden kann und auf welche Dateien oder Domänen es zugreifen kann. Sie gelten für alle Werkzeuge, einschließlich Bash, Read, Edit, WebFetch und MCP.452* **Berechtigungen** steuern, welche Werkzeuge Claude Code verwenden kann und auf welche Dateien oder Domänen es zugreifen kann. Sie gelten für alle Werkzeuge, einschließlich Bash, Read, Edit, WebFetch und MCP.

453* **Sandboxing** bietet OS-Ebenen-Durchsetzung, die den Zugriff des Bash-Werkzeugs auf das Dateisystem und das Netzwerk einschränkt. Es gilt nur für Bash-Befehle und ihre untergeordneten Prozesse.453* **Sandboxing** bietet OS-Ebenen-Durchsetzung, die den Zugriff des Bash-Werkzeugs auf das Dateisystem und das Netzwerk einschränkt. Es gilt nur für Bash-Befehle und ihre untergeordneten Prozesse.

456 456

457* Berechtigungs-Deny-Regeln blockieren Claude daran, überhaupt zu versuchen, auf eingeschränkte Ressourcen zuzugreifen457* Berechtigungs-Deny-Regeln blockieren Claude daran, überhaupt zu versuchen, auf eingeschränkte Ressourcen zuzugreifen

458* Sandbox-Einschränkungen verhindern, dass Bash-Befehle Ressourcen außerhalb definierter Grenzen erreichen, selbst wenn eine Prompt-Injection Claude's Entscheidungsfindung umgeht458* Sandbox-Einschränkungen verhindern, dass Bash-Befehle Ressourcen außerhalb definierter Grenzen erreichen, selbst wenn eine Prompt-Injection Claude's Entscheidungsfindung umgeht

459* Dateisystem-Einschränkungen in der Sandbox kombinieren die [`sandbox.filesystem`](/de/sandboxing)-Einstellungen mit Read- und Edit-Deny-Regeln; beide werden in die endgültige Sandbox-Grenze zusammengeführt459* Dateisystem-Einschränkungen in der Sandbox kombinieren die [`sandbox.filesystem`](/docs/de/sandboxing)-Einstellungen mit Read- und Edit-Deny-Regeln; beide werden in die endgültige Sandbox-Grenze zusammengeführt

460* Netzwerk-Einschränkungen kombinieren WebFetch-Berechtigungsregeln mit den `allowedDomains`- und `deniedDomains`-Listen der Sandbox460* Netzwerk-Einschränkungen kombinieren WebFetch-Berechtigungsregeln mit den `allowedDomains`- und `deniedDomains`-Listen der Sandbox

461 461

462Wenn Sandboxing mit `autoAllowBashIfSandboxed: true` aktiviert ist, was die Standardeinstellung ist, laufen sandboxed Bash-Befehle ohne Aufforderung, selbst wenn Ihre Berechtigungen eine einfache `Bash` Ask-Regel oder die [äquivalente `Bash(*)` Form](#match-all-uses-of-a-tool) enthalten: die Sandbox-Grenze ersetzt diese Ganz-Werkzeug-Aufforderung. Diese Überprüfungen gelten weiterhin:462Wenn Sandboxing mit `autoAllowBashIfSandboxed: true` aktiviert ist, was die Standardeinstellung ist, laufen sandboxed Bash-Befehle ohne Aufforderung, selbst wenn Ihre Berechtigungen eine einfache `Bash` Ask-Regel oder die [äquivalente `Bash(*)` Form](#match-all-uses-of-a-tool) enthalten: die Sandbox-Grenze ersetzt diese Ganz-Werkzeug-Aufforderung. Diese Überprüfungen gelten weiterhin:

465* Explizite Deny-Regeln gelten weiterhin465* Explizite Deny-Regeln gelten weiterhin

466* `rm`- oder `rmdir`-Befehle, die auf `/`, Ihr Home-Verzeichnis oder andere kritische Systempfade abzielen, lösen weiterhin eine Aufforderung aus466* `rm`- oder `rmdir`-Befehle, die auf `/`, Ihr Home-Verzeichnis oder andere kritische Systempfade abzielen, lösen weiterhin eine Aufforderung aus

467 467

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

469 469

470<h2 id="managed-settings">470<h2 id="managed-settings">

471 Verwaltete Einstellungen471 Verwaltete Einstellungen

472</h2>472</h2>

473 473

474Für Organisationen, die eine zentralisierte Kontrolle über die Claude Code-Konfiguration benötigen, können Administratoren verwaltete Einstellungen bereitstellen, die nicht von Benutzer- oder Projekteinstellungen überschrieben werden können. Diese Richtlinieneinstellungen folgen dem gleichen Format wie reguläre Einstellungsdateien und können über MDM/OS-Ebenen-Richtlinien, verwaltete Einstellungsdateien, [servergesteuerte Einstellungen](/de/server-managed-settings) oder ein selbstgehostetes [Claude Apps Gateway](/de/claude-apps-gateway) bereitgestellt werden. Siehe [Einstellungsdateien](/de/settings#settings-files) für Bereitstellungsmechanismen und Dateispeicherorte.474Für Organisationen, die eine zentralisierte Kontrolle über die Claude Code-Konfiguration benötigen, können Administratoren verwaltete Einstellungen bereitstellen, die nicht von Benutzer- oder Projekteinstellungen überschrieben werden können. Diese Richtlinieneinstellungen folgen dem gleichen Format wie reguläre Einstellungsdateien und können über MDM/OS-Ebenen-Richtlinien, verwaltete Einstellungsdateien, [servergesteuerte Einstellungen](/docs/de/server-managed-settings) oder ein selbstgehostetes [Claude Apps Gateway](/docs/de/claude-apps-gateway) bereitgestellt werden. Siehe [Einstellungsdateien](/docs/de/settings#settings-files) für Bereitstellungsmechanismen und Dateispeicherorte.

475 475

476<h3 id="managed-only-settings">476<h3 id="managed-only-settings">

477 Nur verwaltete Einstellungen477 Nur verwaltete Einstellungen

480Die folgenden Einstellungen sind nur in verwalteten Einstellungen wirksam. Das Platzieren in Benutzer- oder Projekteinstellungsdateien hat keine Auswirkung.480Die folgenden Einstellungen sind nur in verwalteten Einstellungen wirksam. Das Platzieren in Benutzer- oder Projekteinstellungsdateien hat keine Auswirkung.

481 481

482| Einstellung | Beschreibung |482| Einstellung | Beschreibung |

483| :--------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |483| :--------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

484| `allowAllClaudeAiMcps` | Wenn `true`, werden claude.ai-Konnektoren zusammen mit einer bereitgestellten `managed-mcp.json` geladen, anstatt durch ihre exklusive Kontrolle unterdrückt zu werden. Siehe [Verwaltete MCP-Konfiguration](/de/managed-mcp) |484| `allowAllClaudeAiMcps` | Wenn `true`, werden claude.ai-Konnektoren zusammen mit einer bereitgestellten `managed-mcp.json` geladen, anstatt durch ihre exklusive Kontrolle unterdrückt zu werden. Siehe [Verwaltete MCP-Konfiguration](/docs/de/managed-mcp) |

485| `allowedChannelPlugins` | Zulassungsliste von Channel-Plugins, die Nachrichten pushen dürfen. Ersetzt die Standard-Anthropic-Zulassungsliste, wenn gesetzt. Erfordert `channelsEnabled: true`. Siehe [Einschränken Sie, welche Channel-Plugins ausgeführt werden können](/de/channels#restrict-which-channel-plugins-can-run) |485| `allowedChannelPlugins` | Zulassungsliste von Channel-Plugins, die Nachrichten pushen dürfen. Ersetzt die Standard-Anthropic-Zulassungsliste, wenn gesetzt. Erfordert `channelsEnabled: true`. Siehe [Einschränken Sie, welche Channel-Plugins ausgeführt werden können](/docs/de/channels#restrict-which-channel-plugins-can-run) |

486| `allowManagedHooksOnly` | Wenn `true`, werden nur verwaltete Hooks, SDK-Hooks und Hooks aus Plugins, die in verwalteten Einstellungen `enabledPlugins` erzwungen sind, geladen. Benutzer-, Projekt- und alle anderen Plugin-Hooks werden blockiert |486| `allowManagedHooksOnly` | Wenn `true`, werden nur verwaltete Hooks, SDK-Hooks und Hooks aus Plugins, die in verwalteten Einstellungen `enabledPlugins` erzwungen sind, geladen. Benutzer-, Projekt- und alle anderen Plugin-Hooks werden blockiert |

487| `allowManagedMcpServersOnly` | Wenn `true`, werden nur `allowedMcpServers` aus verwalteten Einstellungen berücksichtigt. `deniedMcpServers` wird immer noch aus allen Quellen zusammengeführt. Siehe [Verwaltete MCP-Konfiguration](/de/managed-mcp) |487| `allowManagedMcpServersOnly` | Wenn `true`, werden nur `allowedMcpServers` aus verwalteten Einstellungen berücksichtigt. `deniedMcpServers` wird immer noch aus allen Quellen zusammengeführt. Siehe [Verwaltete MCP-Konfiguration](/docs/de/managed-mcp) |

488| `allowManagedPermissionRulesOnly` | Wenn `true`, verhindert, dass Benutzer- und Projekteinstellungen `allow`-, `ask`- oder `deny`-Berechtigungsregeln definieren. Nur Regeln in verwalteten Einstellungen gelten. Dies wirkt sich nicht auf die MCP-Server-Zulassungsliste aus; dafür setzen Sie `allowManagedMcpServersOnly` |488| `allowManagedPermissionRulesOnly` | Wenn `true`, verhindert, dass Benutzer- und Projekteinstellungen `allow`-, `ask`- oder `deny`-Berechtigungsregeln definieren. Nur Regeln in verwalteten Einstellungen gelten. Dies wirkt sich nicht auf die MCP-Server-Zulassungsliste aus; dafür setzen Sie `allowManagedMcpServersOnly` |

489| `blockedMarketplaces` | Blocklist von Marketplace-Quellen. Blockierte Quellen werden vor dem Download überprüft, sodass sie das Dateisystem nie berühren. Siehe [verwaltete Marketplace-Einschränkungen](/de/plugin-marketplaces#managed-marketplace-restrictions) |489| `blockedMarketplaces` | Blocklist von Marketplace-Quellen. Blockierte Quellen werden vor dem Download überprüft, sodass sie das Dateisystem nie berühren. Siehe [verwaltete Marketplace-Einschränkungen](/docs/de/plugin-marketplaces#managed-marketplace-restrictions) |

490| `channelsEnabled` | Ermöglichen Sie [Channels](/de/channels) für die Organisation. Siehe [Enterprise-Kontrollen](/de/channels#enterprise-controls) für die Standardeinstellung bei jedem Plan |490| `channelsEnabled` | Ermöglichen Sie [Channels](/docs/de/channels) für die Organisation. Siehe [Enterprise-Kontrollen](/docs/de/channels#enterprise-controls) für die Standardeinstellung bei jedem Plan |

491| `disableSideloadFlags` | {/* min-version: 2.1.193 */}Lehnen Sie die CLI-Flags `--plugin-dir`, `--plugin-url`, `--agents` und `--mcp-config` beim Start ab. Ohne dies können Benutzer `strictKnownMarketplaces` für einen einzelnen Durchlauf umgehen, indem sie diese Flags übergeben. Siehe [`disableSideloadFlags`](/de/settings#available-settings). Erfordert Claude Code v2.1.193 oder später |491| `disableSideloadFlags` | Lehnen Sie die CLI-Flags `--plugin-dir`, `--plugin-url`, `--agents` und `--mcp-config` beim Start ab. Ohne dies können Benutzer `strictKnownMarketplaces` für einen einzelnen Durchlauf umgehen, indem sie diese Flags übergeben. Siehe [`disableSideloadFlags`](/docs/de/settings#available-settings). Erfordert Claude Code v2.1.193 oder später |

492| `forceRemoteSettingsRefresh` | Wenn `true`, blockiert CLI-Start, bis remote verwaltete Einstellungen aktuell abgerufen werden, und beendet sich, wenn der Abruf fehlschlägt. Siehe [Fail-Closed-Durchsetzung](/de/server-managed-settings#enforce-fail-closed-startup) |492| `forceRemoteSettingsRefresh` | Wenn `true`, blockiert CLI-Start, bis remote verwaltete Einstellungen aktuell abgerufen werden, und beendet sich, wenn der Abruf fehlschlägt. Siehe [Fail-Closed-Durchsetzung](/docs/de/server-managed-settings#enforce-fail-closed-startup) |

493| `pluginTrustMessage` | Benutzerdefinierte Nachricht, die der vor der Installation angezeigten Plugin-Vertrauenswarnung hinzugefügt wird |493| `pluginTrustMessage` | Benutzerdefinierte Nachricht, die der vor der Installation angezeigten Plugin-Vertrauenswarnung hinzugefügt wird |

494| `sandbox.filesystem.allowManagedReadPathsOnly` | Wenn `true`, werden nur `filesystem.allowRead`-Pfade aus verwalteten Einstellungen berücksichtigt. `denyRead` wird immer noch aus allen Quellen zusammengeführt |494| `sandbox.filesystem.allowManagedReadPathsOnly` | Wenn `true`, werden nur `filesystem.allowRead`-Pfade aus verwalteten Einstellungen berücksichtigt. `denyRead` wird immer noch aus allen Quellen zusammengeführt |

495| `sandbox.network.allowManagedDomainsOnly` | Wenn `true`, werden nur `allowedDomains` und `WebFetch(domain:...)`-Allow-Regeln aus verwalteten Einstellungen berücksichtigt. Nicht zulässige Domänen werden automatisch blockiert, ohne den Benutzer zu fragen. Verweigerte Domänen werden immer noch aus allen Quellen zusammengeführt |495| `sandbox.network.allowManagedDomainsOnly` | Wenn `true`, werden nur `allowedDomains` und `WebFetch(domain:...)`-Allow-Regeln aus verwalteten Einstellungen berücksichtigt. Nicht zulässige Domänen werden automatisch blockiert, ohne den Benutzer zu fragen. Verweigerte Domänen werden immer noch aus allen Quellen zusammengeführt |

496| `strictKnownMarketplaces` | Steuert, welche Plugin-Marketplace-Quellen Benutzer hinzufügen und Plugins installieren können. Siehe [verwaltete Marketplace-Einschränkungen](/de/plugin-marketplaces#managed-marketplace-restrictions) |496| `strictKnownMarketplaces` | Steuert, welche Plugin-Marketplace-Quellen Benutzer hinzufügen und Plugins installieren können. Siehe [verwaltete Marketplace-Einschränkungen](/docs/de/plugin-marketplaces#managed-marketplace-restrictions) |

497| `strictPluginOnlyCustomization` | Blockieren Sie Skills, Agents, Hooks und MCP-Server aus Benutzer- und Projektquellen, sodass sie nur aus Plugins oder verwalteten Einstellungen stammen können. `true` sperrt alle vier Oberflächen; ein Array wie `["skills", "hooks"]` sperrt nur die benannten. Siehe [`strictPluginOnlyCustomization`](/de/settings#strictpluginonlycustomization) |497| `strictPluginOnlyCustomization` | Blockieren Sie Skills, Agents, Hooks und MCP-Server aus Benutzer- und Projektquellen, sodass sie nur aus Plugins oder verwalteten Einstellungen stammen können. `true` sperrt alle vier Oberflächen; ein Array wie `["skills", "hooks"]` sperrt nur die benannten. Siehe [`strictPluginOnlyCustomization`](/docs/de/settings#strictpluginonlycustomization) |

498| `wslInheritsWindowsSettings` | Wenn `true` im Windows HKLM-Registrierungsschlüssel oder in `C:\Program Files\ClaudeCode\managed-settings.json`, liest WSL verwaltete Einstellungen aus der Windows-Richtlinienkette zusätzlich zu `/etc/claude-code`. Siehe [Einstellungsdateien](/de/settings#settings-files) |498| `wslInheritsWindowsSettings` | Wenn `true` im Windows HKLM-Registrierungsschlüssel oder in `C:\Program Files\ClaudeCode\managed-settings.json`, liest WSL verwaltete Einstellungen aus der Windows-Richtlinienkette zusätzlich zu `/etc/claude-code`. Siehe [Einstellungsdateien](/docs/de/settings#settings-files) |

499 499

500`disableBypassPermissionsMode` wird normalerweise in verwalteten Einstellungen platziert, um Organisationsrichtlinien durchzusetzen, funktioniert aber aus jedem Bereich. Ein Benutzer kann es in seinen eigenen Einstellungen festlegen, um sich selbst aus dem Bypass-Modus auszusperren.500`disableBypassPermissionsMode` wird normalerweise in verwalteten Einstellungen platziert, um Organisationsrichtlinien durchzusetzen, funktioniert aber aus jedem Bereich. Ein Benutzer kann es in seinen eigenen Einstellungen festlegen, um sich selbst aus dem Bypass-Modus auszusperren.

501 501

502<Note>502<Note>

503 Bei Team- und Enterprise-Plänen aktiviert oder deaktiviert ein Owner [Remote Control](/de/remote-control) und [Web-Sitzungen](/de/claude-code-on-the-web) organisationsweit in [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code). Remote Control kann zusätzlich pro Gerät mit der Einstellung [`disableRemoteControl`](/de/settings#available-settings) deaktiviert werden. Web-Sitzungen haben keinen verwalteten Einstellungsschlüssel pro Gerät.503 Bei Team- und Enterprise-Plänen aktiviert oder deaktiviert ein Owner [Remote Control](/docs/de/remote-control) und [Web-Sitzungen](/docs/de/claude-code-on-the-web) organisationsweit in [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code). Remote Control kann zusätzlich pro Gerät mit der Einstellung [`disableRemoteControl`](/docs/de/settings#available-settings) deaktiviert werden. Web-Sitzungen haben keinen verwalteten Einstellungsschlüssel pro Gerät.

504</Note>504</Note>

505 505

506<h2 id="settings-precedence">506<h2 id="settings-precedence">

507 Einstellungspriorität507 Einstellungspriorität

508</h2>508</h2>

509 509

510Berechtigungsregeln folgen der gleichen [Einstellungspriorität](/de/settings#settings-precedence) wie alle anderen Claude Code-Einstellungen:510Berechtigungsregeln folgen der gleichen [Einstellungspriorität](/docs/de/settings#settings-precedence) wie alle anderen Claude Code-Einstellungen:

511 511

5121. **Verwaltete Einstellungen**: können von keiner anderen Ebene überschrieben werden, einschließlich Befehlszeilenargumenten5121. **Verwaltete Einstellungen**: können von keiner anderen Ebene überschrieben werden, einschließlich Befehlszeilenargumenten

5132. **Befehlszeilenargumente**: temporäre Sitzungsüberschreibungen5132. **Befehlszeilenargumente**: temporäre Sitzungsüberschreibungen

519 519

520Das Gleiche gilt für Einstellungsbereiche: Wenn Benutzereinstellungen eine Berechtigung zulassen und Projekteinstellungen sie verweigern, blockiert die Deny-Regel sie. Das Gegenteil ist auch wahr: eine Deny-Regel auf Benutzerebene blockiert eine Allow-Regel auf Projektebene, da Deny-Regeln aus jedem Bereich vor Allow-Regeln ausgewertet werden.520Das Gleiche gilt für Einstellungsbereiche: Wenn Benutzereinstellungen eine Berechtigung zulassen und Projekteinstellungen sie verweigern, blockiert die Deny-Regel sie. Das Gegenteil ist auch wahr: eine Deny-Regel auf Benutzerebene blockiert eine Allow-Regel auf Projektebene, da Deny-Regeln aus jedem Bereich vor Allow-Regeln ausgewertet werden.

521 521

522Embedding-Hosts können zusätzliche verwaltete Richtlinien über die SDK-Option `managedSettings` bereitstellen, wenn [`parentSettingsBehavior`](/de/settings#settings-precedence) auf `"merge"` gesetzt ist; Embedder-Werte können die Richtlinie verschärfen, aber nicht lockern.522Embedding-Hosts können zusätzliche verwaltete Richtlinien über die SDK-Option `managedSettings` bereitstellen, wenn [`parentSettingsBehavior`](/docs/de/settings#settings-precedence) auf `"merge"` gesetzt ist; Embedder-Werte können die Richtlinie verschärfen, aber nicht lockern.

523 523

524<h2 id="project-allow-rules-and-workspace-trust">524<h2 id="project-allow-rules-and-workspace-trust">

525 Projekterlaubnisregeln und Workspace-Vertrauen525 Projekterlaubnisregeln und Workspace-Vertrauen

526</h2>526</h2>

527 527

528`permissions.allow`-Regeln und `permissions.additionalDirectories`-Einträge in der `.claude/settings.json` eines Projekts gewähren Funktionen, daher wendet Claude Code sie nur an, nachdem Sie den [Workspace-Vertrauensdialog](/de/security#additional-safeguards) für diesen Workspace akzeptiert haben. Bis dahin liest Claude Code die Regeln, wendet sie aber nicht an. Der Vertrauensdialog listet die Erlaubnisregeln und zusätzlichen Verzeichnisse auf, die der Ordner gewähren würde, damit Sie diese vor dem Akzeptieren überprüfen können. `deny`- und `ask`-Regeln sind nicht betroffen, da sie nur einschränken.528`permissions.allow`-Regeln und `permissions.additionalDirectories`-Einträge in der `.claude/settings.json` eines Projekts gewähren Funktionen, daher wendet Claude Code sie nur an, nachdem Sie den [Workspace-Vertrauensdialog](/docs/de/security#additional-safeguards) für diesen Workspace akzeptiert haben. Bis dahin liest Claude Code die Regeln, wendet sie aber nicht an. Der Vertrauensdialog listet die Erlaubnisregeln und zusätzlichen Verzeichnisse auf, die der Ordner gewähren würde, damit Sie diese vor dem Akzeptieren überprüfen können. `deny`- und `ask`-Regeln sind nicht betroffen, da sie nur einschränken.

529 529

530Claude Code speichert Vertrauen pro Workspace, indiziert nach dem Git-Repository-Root oder außerhalb eines Repositorys nach dem Verzeichnis, von dem aus Sie Claude Code gestartet haben. Wenn Sie in Ihrem Home-Verzeichnis starten, wird das Vertrauen nur für die aktuelle Sitzung gespeichert und nicht auf die Festplatte geschrieben; siehe die Notiz zu [zusätzlichen Schutzmaßnahmen](/de/security#additional-safeguards). Das Vertrauen in ein übergeordnetes Verzeichnis wendet die Erlaubnisregeln eines verschachtelten Projekts nicht an.530Claude Code speichert Vertrauen pro Workspace, indiziert nach dem Git-Repository-Root oder außerhalb eines Repositorys nach dem Verzeichnis, von dem aus Sie Claude Code gestartet haben. Wenn Sie in Ihrem Home-Verzeichnis starten, wird das Vertrauen nur für die aktuelle Sitzung gespeichert und nicht auf die Festplatte geschrieben; siehe die Notiz zu [zusätzlichen Schutzmaßnahmen](/docs/de/security#additional-safeguards). Das Vertrauen in ein übergeordnetes Verzeichnis wendet die Erlaubnisregeln eines verschachtelten Projekts nicht an.

531 531

532`.claude/settings.local.json` ist Ihre eigene Datei, daher gilt die Workspace-Vertrauensprüfung normalerweise nicht dafür. Wenn ein Repository die Datei hätte bereitstellen können, z. B. wenn sie in Git committed ist oder `.claude` ein Symlink ist, durchlaufen ihre Erlaubnisregeln und zusätzlichen Verzeichnisse die Vertrauensprüfung wie Projekteinstellungen.532`.claude/settings.local.json` ist Ihre eigene Datei, daher gilt die Workspace-Vertrauensprüfung normalerweise nicht dafür. Wenn ein Repository die Datei hätte bereitstellen können, z. B. wenn sie in Git committed ist oder `.claude` ein Symlink ist, durchlaufen ihre Erlaubnisregeln und zusätzlichen Verzeichnisse die Vertrauensprüfung wie Projekteinstellungen.

533 533

536Erlaubnisregeln und zusätzliche Verzeichnisse in `.claude/settings.local.json` gelten auch ohne Workspace-Vertrauen in zwei Fällen:536Erlaubnisregeln und zusätzliche Verzeichnisse in `.claude/settings.local.json` gelten auch ohne Workspace-Vertrauen in zwei Fällen:

537 537

538* Das Verzeichnis, von dem aus Sie Claude Code gestartet haben, befindet sich nicht in einem Git-Repository.538* Das Verzeichnis, von dem aus Sie Claude Code gestartet haben, befindet sich nicht in einem Git-Repository.

539* Die Sitzung wird in Ihrem eigenen Konfigurationsheim ausgeführt: Ihr Home-Verzeichnis oder ein beliebiges Verzeichnis, dessen `.claude`-Unterverzeichnis Sie als [`CLAUDE_CONFIG_DIR`](/de/env-vars) festgelegt haben.539* Die Sitzung wird in Ihrem eigenen Konfigurationsheim ausgeführt: Ihr Home-Verzeichnis oder ein beliebiges Verzeichnis, dessen `.claude`-Unterverzeichnis Sie als [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) festgelegt haben.

540 540

541In beiden Fällen ist die Datei eine, die Sie erstellt haben, anstatt eine, die ein Repository hätte bereitstellen können, und ein in das Repository committetes `.claude/settings.local.json` erfordert immer noch Workspace-Vertrauen. Die Versionen 2.1.196 bis 2.1.199 behandelten die Datei in diesen Workspaces als vom Repository bereitgestellt, ignorierten ihre Erlaubnisregeln und gaben eine [`this workspace has not been trusted`](/de/errors#workspace-has-not-been-trusted)-Warnung auf stderr aus. Die beiden oben genannten Ausnahmen entsprechen v2.1.195 und früher und wurden in v2.1.200 wiederhergestellt.541In beiden Fällen ist die Datei eine, die Sie erstellt haben, anstatt eine, die ein Repository hätte bereitstellen können, und ein in das Repository committetes `.claude/settings.local.json` erfordert immer noch Workspace-Vertrauen. Die Versionen 2.1.196 bis 2.1.199 behandelten die Datei in diesen Workspaces als vom Repository bereitgestellt, ignorierten ihre Erlaubnisregeln und gaben eine [`this workspace has not been trusted`](/docs/de/errors#workspace-has-not-been-trusted)-Warnung auf stderr aus. Die beiden oben genannten Ausnahmen entsprechen v2.1.195 und früher und wurden in v2.1.200 wiederhergestellt.

542 542

543Auch ab v2.1.200 zeigt ein Workspace, dessen Erlaubnisregeln oder zusätzliche Verzeichnisse immer noch nicht angewendet werden, aber nie den Vertrauensdialog angezeigt hat, weil ein übergeordnetes Verzeichnis bereits vertraut war, den Dialog beim nächsten interaktiven Start von Claude Code dort an. Der Dialog bietet zwei Optionen:543Auch ab v2.1.200 zeigt ein Workspace, dessen Erlaubnisregeln oder zusätzliche Verzeichnisse immer noch nicht angewendet werden, aber nie den Vertrauensdialog angezeigt hat, weil ein übergeordnetes Verzeichnis bereits vertraut war, den Dialog beim nächsten interaktiven Start von Claude Code dort an. Der Dialog bietet zwei Optionen:

544 544

545* **Ja, ich vertraue diesem Ordner**: speichert Vertrauen für diesen Workspace und wendet die Regeln in derselben Sitzung an.545* **Ja, ich vertraue diesem Ordner**: speichert Vertrauen für diesen Workspace und wendet die Regeln in derselben Sitzung an.

546* **Nein, ohne diese Berechtigungen fortfahren**: funktioniert weiterhin mit diesen Regeln ignoriert. Der Dialog wird in der nächsten Sitzung erneut angezeigt.546* **Nein, ohne diese Berechtigungen fortfahren**: funktioniert weiterhin mit diesen Regeln ignoriert. Der Dialog wird in der nächsten Sitzung erneut angezeigt.

547 547

548Im [nicht-interaktiven Modus](/de/headless) mit `-p` wird kein Dialog angezeigt und die Regeln bleiben ignoriert.548Im [nicht-interaktiven Modus](/docs/de/headless) mit `-p` wird kein Dialog angezeigt und die Regeln bleiben ignoriert.

549 549

550<h2 id="example-configurations">550<h2 id="example-configurations">

551 Beispielkonfigurationen551 Beispielkonfigurationen

557 Siehe auch557 Siehe auch

558</h2>558</h2>

559 559

560* [Einstellungen](/de/settings): vollständige Konfigurationsreferenz einschließlich der Berechtigungseinstellungstabelle560* [Einstellungen](/docs/de/settings): vollständige Konfigurationsreferenz einschließlich der Berechtigungseinstellungstabelle

561* [Konfigurieren Sie den Auto-Mode](/de/auto-mode-config): Teilen Sie dem Auto-Mode-Klassifizierer mit, welche Infrastruktur Ihre Organisation vertraut561* [Konfigurieren Sie den Auto-Mode](/docs/de/auto-mode-config): Teilen Sie dem Auto-Mode-Klassifizierer mit, welche Infrastruktur Ihre Organisation vertraut

562* [Sandboxing](/de/sandboxing): OS-Ebenen-Dateisystem- und Netzwerkisolation für Bash-Befehle562* [Sandboxing](/docs/de/sandboxing): OS-Ebenen-Dateisystem- und Netzwerkisolation für Bash-Befehle

563* [Authentifizierung](/de/authentication): Richten Sie Benutzerzugriff auf Claude Code ein563* [Authentifizierung](/docs/de/authentication): Richten Sie Benutzerzugriff auf Claude Code ein

564* [Sicherheit](/de/security): Sicherheitsvorkehrungen und Best Practices564* [Sicherheit](/docs/de/security): Sicherheitsvorkehrungen und Best Practices

565* [Hooks](/de/hooks-guide): Automatisieren Sie Workflows und erweitern Sie die Berechtigungsevaluierung565* [Hooks](/docs/de/hooks-guide): Automatisieren Sie Workflows und erweitern Sie die Berechtigungsevaluierung

plugin-hints.md +7 −7

Details

10 10

11Claude Code entfernt die Hinweiszeile aus der Befehlsausgabe, bevor sie an das Modell gesendet wird, sodass der Marker nie in der Konversation erscheint und nicht zur Token-Nutzung zählt. Das Protokoll erfordert keine zusätzlichen Befehle und ändert nicht, was Ihre CLI für Benutzer außerhalb von Claude Code ausgibt.11Claude Code entfernt die Hinweiszeile aus der Befehlsausgabe, bevor sie an das Modell gesendet wird, sodass der Marker nie in der Konversation erscheint und nicht zur Token-Nutzung zählt. Das Protokoll erfordert keine zusätzlichen Befehle und ändert nicht, was Ihre CLI für Benutzer außerhalb von Claude Code ausgibt.

12 12

~~13Diese Seite ist für CLI- und SDK-Verwalter. Wenn Sie nach der Installation von Plugins suchen, siehe [Plugins entdecken und installieren](/de/discover-plugins).~~13Diese Seite ist für CLI- und SDK-Verwalter. Wenn Sie nach der Installation von Plugins suchen, siehe [Plugins entdecken und installieren](/docs/de/discover-plugins).

14 14

15<h2 id="how-it-works">15<h2 id="how-it-works">

16 Funktionsweise16 Funktionsweise

17</h2>17</h2>

18 18

19Claude Code setzt die [`CLAUDECODE`](/de/env-vars) Umgebungsvariable auf `1` für jeden Befehl, den es über die Bash- und PowerShell-Tools ausführt, und für [hook](/de/hooks)-Befehle. {/* min-version: 2.1.172 */}Ab v2.1.172 setzt es auch [`CLAUDE_CODE_CHILD_SESSION`](/de/env-vars) auf `1` in denselben Subprozessen. Wenn Ihre CLI eine dieser Variablen sieht, schreibt sie ein selbstschließendes `<claude-code-hint />`-Tag auf stderr. Bei hook-Befehlen wird das Hinweis-Tag entfernt und ignoriert. Nur die Ausgabe von Bash- und PowerShell-Tools löst die Installationsaufforderung aus.19Claude Code setzt die [`CLAUDECODE`](/docs/de/env-vars) Umgebungsvariable auf `1` für jeden Befehl, den es über die Bash- und PowerShell-Tools ausführt, und für [hook](/docs/de/hooks)-Befehle. Ab v2.1.172 setzt es auch [`CLAUDE_CODE_CHILD_SESSION`](/docs/de/env-vars) auf `1` in denselben Subprozessen. Wenn Ihre CLI eine dieser Variablen sieht, schreibt sie ein selbstschließendes `<claude-code-hint />`-Tag auf stderr. Bei hook-Befehlen wird das Hinweis-Tag entfernt und ignoriert. Nur die Ausgabe von Bash- und PowerShell-Tools löst die Installationsaufforderung aus.

20 20

21Wenn Claude Code die Befehlsausgabe empfängt, führt es folgende Schritte aus:21Wenn Claude Code die Befehlsausgabe empfängt, führt es folgende Schritte aus:

22 22

36Geben Sie die Ausgabe an eine Umgebungsvariable ab, damit der Marker wahrscheinlich nicht erscheint, wenn ein Mensch Ihre CLI direkt ausführt, und schreiben Sie dann das Tag auf stderr auf seiner eigenen Zeile. Wählen Sie, welche Variable überprüft werden soll:36Geben Sie die Ausgabe an eine Umgebungsvariable ab, damit der Marker wahrscheinlich nicht erscheint, wenn ein Mensch Ihre CLI direkt ausführt, und schreiben Sie dann das Tag auf stderr auf seiner eigenen Zeile. Wählen Sie, welche Variable überprüft werden soll:

37 37

38* `CLAUDECODE`: wird auf jeder Claude Code-Version gesetzt, daher erreicht es die meisten Sitzungen. Sie wird auch in tmux-Sitzungen und stdio MCP Server-Subprozessen gesetzt, die Claude Code startet. IDE-Erweiterungen setzen sie auch in ihren integrierten Terminals, wo ein Mensch Ihre CLI direkt ausführen kann.38* `CLAUDECODE`: wird auf jeder Claude Code-Version gesetzt, daher erreicht es die meisten Sitzungen. Sie wird auch in tmux-Sitzungen und stdio MCP Server-Subprozessen gesetzt, die Claude Code startet. IDE-Erweiterungen setzen sie auch in ihren integrierten Terminals, wo ein Mensch Ihre CLI direkt ausführen kann.

39* {/* min-version: 2.1.172 */}`CLAUDE_CODE_CHILD_SESSION`: wird nur in Subprozessen gesetzt, die Claude Code selbst startet, wie z. B. Tool-Aufrufe, Hook-Befehle und [Statuszeilen](/de/statusline)-Befehle, daher erreicht das Tag normalerweise kein menschliches Terminal. Ein langlebiger Prozess, der innerhalb einer Sitzung gestartet wurde, wie z. B. ein tmux-Server, erfasst die Variable, daher zeigen Shells, die später von diesem Prozess aus gestartet werden, immer noch das rohe Tag. Erfordert Claude Code v2.1.172 oder später, daher verpassen Sitzungen auf älteren Versionen den Hinweis.39* `CLAUDE_CODE_CHILD_SESSION`: wird nur in Subprozessen gesetzt, die Claude Code selbst startet, wie z. B. Tool-Aufrufe, Hook-Befehle und [Statuszeilen](/docs/de/statusline)-Befehle, daher erreicht das Tag normalerweise kein menschliches Terminal. Ein langlebiger Prozess, der innerhalb einer Sitzung gestartet wurde, wie z. B. ein tmux-Server, erfasst die Variable, daher zeigen Shells, die später von diesem Prozess aus gestartet werden, immer noch das rohe Tag. Erfordert Claude Code v2.1.172 oder später, daher verpassen Sitzungen auf älteren Versionen den Hinweis.

40 40

41Die folgenden Beispiele geben auf `CLAUDECODE` ab, um maximale Reichweite zu erreichen, und geben einen Hinweis für ein Plugin namens `example-cli` im offiziellen Marketplace aus:41Die folgenden Beispiele geben auf `CLAUDECODE` ab, um maximale Reichweite zu erreichen, und geben einen Hinweis für ein Plugin namens `example-cli` im offiziellen Marketplace aus:

42 42

158 Bringen Sie Ihr Plugin in den offiziellen Marketplace158 Bringen Sie Ihr Plugin in den offiziellen Marketplace

159</h2>159</h2>

160 160

161Das Hinweisprotokoll wird nur für Plugins wirksam, die im offiziellen Anthropic-Marketplace aufgelistet sind, `claude-plugins-official`. Anthropic kuratiert diesen Marketplace nach eigenem Ermessen, und die In-App-Einreichungsformulare fügen Plugins stattdessen zum [Community-Marketplace](/de/plugins#submit-your-plugin-to-the-community-marketplace) hinzu, den das Hinweisprotokoll nicht überprüft. Wenn Sie mit einem Anthropic-Partner-Kontakt zusammenarbeiten, wenden Sie sich an ihn, um die Auflistung im offiziellen Marketplace zu koordinieren.161Das Hinweisprotokoll wird nur für Plugins wirksam, die im offiziellen Anthropic-Marketplace aufgelistet sind, `claude-plugins-official`. Anthropic kuratiert diesen Marketplace nach eigenem Ermessen, und die In-App-Einreichungsformulare fügen Plugins stattdessen zum [Community-Marketplace](/docs/de/plugins#submit-your-plugin-to-the-community-marketplace) hinzu, den das Hinweisprotokoll nicht überprüft. Wenn Sie mit einem Anthropic-Partner-Kontakt zusammenarbeiten, wenden Sie sich an ihn, um die Auflistung im offiziellen Marketplace zu koordinieren.

162 162

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

164 Siehe auch164 Siehe auch

165</h2>165</h2>

166 166

167* [Erstellen Sie Plugins](/de/plugins): Erstellen Sie das Plugin, das Ihre CLI empfiehlt167* [Erstellen Sie Plugins](/docs/de/plugins): Erstellen Sie das Plugin, das Ihre CLI empfiehlt

168* [Erstellen und verteilen Sie einen Plugin-Marketplace](/de/plugin-marketplaces): Hosten Sie Plugins außerhalb des offiziellen Marketplace168* [Erstellen und verteilen Sie einen Plugin-Marketplace](/docs/de/plugin-marketplaces): Hosten Sie Plugins außerhalb des offiziellen Marketplace

169* [Umgebungsvariablen](/de/env-vars): Vollständige Referenz für `CLAUDECODE` und verwandte Variablen169* [Umgebungsvariablen](/docs/de/env-vars): Vollständige Referenz für `CLAUDECODE` und verwandte Variablen

plugin-marketplaces.md +36 −36

Details

8 8

9Ein **Plugin-Marktplatz** ist ein Katalog, mit dem Sie Plugins an andere verteilen können. Marktplätze bieten zentrale Entdeckung, Versionsverfolgung, automatische Updates und Unterstützung für mehrere Quellentypen, einschließlich Git-Repositories und lokaler Pfade. Diese Anleitung zeigt Ihnen, wie Sie Ihren eigenen Marktplatz erstellen, um Plugins mit Ihrem Team oder Ihrer Community zu teilen.9Ein **Plugin-Marktplatz** ist ein Katalog, mit dem Sie Plugins an andere verteilen können. Marktplätze bieten zentrale Entdeckung, Versionsverfolgung, automatische Updates und Unterstützung für mehrere Quellentypen, einschließlich Git-Repositories und lokaler Pfade. Diese Anleitung zeigt Ihnen, wie Sie Ihren eigenen Marktplatz erstellen, um Plugins mit Ihrem Team oder Ihrer Community zu teilen.

10 10

~~11Möchten Sie Plugins aus einem vorhandenen Marktplatz installieren? Siehe [Entdecken und Installieren vorgefertigter Plugins](/de/discover-plugins).~~11Möchten Sie Plugins aus einem vorhandenen Marktplatz installieren? Siehe [Entdecken und Installieren vorgefertigter Plugins](/docs/de/discover-plugins).

12 12

13<h2 id="overview">13<h2 id="overview">

14 Übersicht14 Übersicht

16 16

17Das Erstellen und Verteilen eines Marktplatzes umfasst:17Das Erstellen und Verteilen eines Marktplatzes umfasst:

18 18

191. **Plugins erstellen**: Erstellen Sie ein oder mehrere Plugins mit skills, Agents, hooks, MCP servers oder LSP servers. Diese Anleitung setzt voraus, dass Sie bereits Plugins zum Verteilen haben; siehe [Plugins erstellen](/de/plugins) für Details zum Erstellen von Plugins.191. **Plugins erstellen**: Erstellen Sie ein oder mehrere Plugins mit skills, Agents, hooks, MCP servers oder LSP servers. Diese Anleitung setzt voraus, dass Sie bereits Plugins zum Verteilen haben; siehe [Plugins erstellen](/docs/de/plugins) für Details zum Erstellen von Plugins.

202. **Marktplatzdatei erstellen**: Definieren Sie eine `marketplace.json`, die Ihre Plugins und deren Speicherorte auflistet. Siehe [Marktplatzdatei erstellen](#create-the-marketplace-file).202. **Marktplatzdatei erstellen**: Definieren Sie eine `marketplace.json`, die Ihre Plugins und deren Speicherorte auflistet. Siehe [Marktplatzdatei erstellen](#create-the-marketplace-file).

213. **Marktplatz hosten**: Pushen Sie zu GitHub, GitLab oder einem anderen Git-Host. Siehe [Marktplätze hosten und verteilen](#host-and-distribute-marketplaces).213. **Marktplatz hosten**: Pushen Sie zu GitHub, GitLab oder einem anderen Git-Host. Siehe [Marktplätze hosten und verteilen](#host-and-distribute-marketplaces).

~~224. **Mit Benutzern teilen**: Benutzer fügen Ihren Marktplatz mit `/plugin marketplace add` hinzu und installieren einzelne Plugins. Siehe [Plugins entdecken und installieren](/de/discover-plugins).~~224. **Mit Benutzern teilen**: Benutzer fügen Ihren Marktplatz mit `/plugin marketplace add` hinzu und installieren einzelne Plugins. Siehe [Plugins entdecken und installieren](/docs/de/discover-plugins).

23 23

24Sobald Ihr Marktplatz live ist, können Sie ihn aktualisieren, indem Sie Änderungen in Ihr Repository pushen. Benutzer aktualisieren ihre lokale Kopie mit `/plugin marketplace update`.24Sobald Ihr Marktplatz live ist, können Sie ihn aktualisieren, indem Sie Änderungen in Ihr Repository pushen. Benutzer aktualisieren ihre lokale Kopie mit `/plugin marketplace update`.

25 25

110 </Step>110 </Step>

111</Steps>111</Steps>

112 112

113Um mehr über die Möglichkeiten von Plugins zu erfahren, einschließlich hooks, Agents, MCP servers und LSP servers, siehe [Plugins](/de/plugins).113Um mehr über die Möglichkeiten von Plugins zu erfahren, einschließlich hooks, Agents, MCP servers und LSP servers, siehe [Plugins](/docs/de/plugins).

114 114

115<Note>115<Note>

116 **Wie Plugins installiert werden**: Wenn Benutzer ein Plugin installieren, kopiert Claude Code das Plugin-Verzeichnis an einen Cache-Speicherort. Das bedeutet, dass Plugins keine Dateien außerhalb ihres Verzeichnisses mit Pfaden wie `../shared-utils` referenzieren können, da diese Dateien nicht kopiert werden.116 **Wie Plugins installiert werden**: Wenn Benutzer ein Plugin installieren, kopiert Claude Code das Plugin-Verzeichnis an einen Cache-Speicherort. Das bedeutet, dass Plugins keine Dateien außerhalb ihres Verzeichnisses mit Pfaden wie `../shared-utils` referenzieren können, da diese Dateien nicht kopiert werden.

117 117

118 Wenn Sie Dateien über Plugins hinweg teilen müssen, verwenden Sie Symlinks. Siehe [Plugin-Caching und Dateiauflösung](/de/plugins-reference#plugin-caching-and-file-resolution) für Details.118 Wenn Sie Dateien über Plugins hinweg teilen müssen, verwenden Sie Symlinks. Siehe [Plugin-Caching und Dateiauflösung](/docs/de/plugins-reference#plugin-caching-and-file-resolution) für Details.

119</Note>119</Note>

120 120

121<h2 id="create-the-marketplace-file">121<h2 id="create-the-marketplace-file">

172<Note>172<Note>

173 **Reservierte Namen**: Die folgenden Marktplatznamen sind für die offizielle Nutzung durch Anthropic reserviert und können nicht von Drittanbieter-Marktplätzen verwendet werden: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins`, `healthcare`. Namen, die offizielle Marktplätze imitieren, wie `official-claude-plugins` oder `anthropic-plugins-v2`, sind ebenfalls blockiert. Das Reservieren dieser Namen verhindert, dass sich ein Drittanbieter-Marktplatz als von Anthropic veröffentlichte Quelle darstellt.173 **Reservierte Namen**: Die folgenden Marktplatznamen sind für die offizielle Nutzung durch Anthropic reserviert und können nicht von Drittanbieter-Marktplätzen verwendet werden: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins`, `healthcare`. Namen, die offizielle Marktplätze imitieren, wie `official-claude-plugins` oder `anthropic-plugins-v2`, sind ebenfalls blockiert. Das Reservieren dieser Namen verhindert, dass sich ein Drittanbieter-Marktplatz als von Anthropic veröffentlichte Quelle darstellt.

174 174

175 Claude Code überprüft reservierte Namen jedes Mal, wenn es einen Marktplatz lädt, nicht nur wenn Sie einen hinzufügen. Ein Marktplatz, der unter einem dieser Namen registriert wurde, bevor der Name reserviert wurde, wird nicht mehr geladen und meldet, dass er [von einer nicht vertrauenswürdigen Quelle registriert ist](/de/errors#marketplace-is-registered-from-an-untrusted-source). Entfernen Sie diesen Marktplatz und fügen Sie ihn erneut aus der offiziellen Anthropic-Quelle hinzu. Ein Drittanbieter-Marktplatz, der von einem neu reservierten Namen betroffen ist, wird erneut geladen, sobald Sie ihn unter einem anderen Namen erneut hinzufügen. Vor v2.1.205 waren `first-party-plugins` und `healthcare` nicht reserviert, und ein Marktplatz, der bereits unter einem reservierten Namen registriert war, wurde weiterhin geladen.175 Claude Code überprüft reservierte Namen jedes Mal, wenn es einen Marktplatz lädt, nicht nur wenn Sie einen hinzufügen. Ein Marktplatz, der unter einem dieser Namen registriert wurde, bevor der Name reserviert wurde, wird nicht mehr geladen und meldet, dass er [von einer nicht vertrauenswürdigen Quelle registriert ist](/docs/de/errors#marketplace-is-registered-from-an-untrusted-source). Entfernen Sie diesen Marktplatz und fügen Sie ihn erneut aus der offiziellen Anthropic-Quelle hinzu. Ein Drittanbieter-Marktplatz, der von einem neu reservierten Namen betroffen ist, wird erneut geladen, sobald Sie ihn unter einem anderen Namen erneut hinzufügen. Vor v2.1.205 waren `first-party-plugins` und `healthcare` nicht reserviert, und ein Marktplatz, der bereits unter einem reservierten Namen registriert war, wurde weiterhin geladen.

176</Note>176</Note>

177 177

178<h3 id="owner-fields">178<h3 id="owner-fields">

189</h3>189</h3>

190 190

191| Feld | Typ | Beschreibung |191| Feld | Typ | Beschreibung |

192| :------------------------------------ | :----- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |192| :------------------------------------ | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

196| `metadata.pluginRoot` | string | Basisverzeichnis, das relativen Plugin-Quellpfaden vorangestellt wird (z. B. `"./plugins"` ermöglicht es Ihnen, `"source": "formatter"` statt `"source": "./plugins/formatter"` zu schreiben) |196| `metadata.pluginRoot` | string | Basisverzeichnis, das relativen Plugin-Quellpfaden vorangestellt wird (z. B. `"./plugins"` ermöglicht es Ihnen, `"source": "formatter"` statt `"source": "./plugins/formatter"` zu schreiben) |

197| `allowCrossMarketplaceDependenciesOn` | array | Andere Marktplätze, von denen Plugins in diesem Marktplatz abhängen können. Abhängigkeiten von einem Marktplatz, der hier nicht aufgelistet ist, werden bei der Installation blockiert. Siehe [Von einem Plugin aus einem anderen Marktplatz abhängen](/de/plugin-dependencies#depend-on-a-plugin-from-another-marketplace). |197| `allowCrossMarketplaceDependenciesOn` | array | Andere Marktplätze, von denen Plugins in diesem Marktplatz abhängen können. Abhängigkeiten von einem Marktplatz, der hier nicht aufgelistet ist, werden bei der Installation blockiert. Siehe [Von einem Plugin aus einem anderen Marktplatz abhängen](/docs/de/plugin-dependencies#depend-on-a-plugin-from-another-marketplace). |

198| `renames` | object | {/* min-version: 2.1.193 */}Zuordnung von einem früheren Plugin-`name` zu seinem aktuellen Namen oder zu `null`, wenn das Plugin entfernt wurde. Ermöglicht es bestehenden Benutzern, automatisch zu migrieren, wenn Sie einen Eintrag in `plugins` umbenennen oder entfernen. Siehe [Plugin umbenennen oder entfernen](#rename-or-remove-a-plugin). Erfordert Claude Code v2.1.193 oder später. |198| `renames` | object | Zuordnung von einem früheren Plugin-`name` zu seinem aktuellen Namen oder zu `null`, wenn das Plugin entfernt wurde. Ermöglicht es bestehenden Benutzern, automatisch zu migrieren, wenn Sie einen Eintrag in `plugins` umbenennen oder entfernen. Siehe [Plugin umbenennen oder entfernen](#rename-or-remove-a-plugin). Erfordert Claude Code v2.1.193 oder später. |

199 199

200`description` und `version` werden auch unter `metadata` für Rückwärtskompatibilität akzeptiert.200`description` und `version` werden auch unter `metadata` für Rückwärtskompatibilität akzeptiert.

201 201

203 Plugin-Einträge203 Plugin-Einträge

204</h2>204</h2>

205 205

206Jeder Plugin-Eintrag im `plugins`-Array beschreibt ein Plugin und wo man es findet. Sie können jedes Feld aus dem [Plugin-Manifest-Schema](/de/plugins-reference#plugin-manifest-schema) einbeziehen, wie `description`, `version`, `author`, `commands` und `hooks`, plus diese Marktplatz-spezifischen Felder: `source`, `category`, `tags`, `strict` und `relevance`.206Jeder Plugin-Eintrag im `plugins`-Array beschreibt ein Plugin und wo man es findet. Sie können jedes Feld aus dem [Plugin-Manifest-Schema](/docs/de/plugins-reference#plugin-manifest-schema) einbeziehen, wie `description`, `version`, `author`, `commands` und `hooks`, plus diese Marktplatz-spezifischen Felder: `source`, `category`, `tags`, `strict` und `relevance`.

207 207

208<h3 id="required-fields-2">208<h3 id="required-fields-2">

209 Erforderliche Felder209 Erforderliche Felder

221**Standard-Metadatenfelder:**221**Standard-Metadatenfelder:**

222 222

223| Feld | Typ | Beschreibung |223| Feld | Typ | Beschreibung |

224| :--------------- | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |224| :--------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

225| `displayName` | string | {/* min-version: 2.1.143 */}Benutzerfreundlicher Name, der in UI-Oberflächen angezeigt wird. Fällt auf `name` zurück, wenn weggelassen. Kann Leerzeichen und beliebige Groß-/Kleinschreibung enthalten. Wird nicht für Namensräume oder Suche verwendet. Erfordert Claude Code v2.1.143 oder später. |225| `displayName` | string | Benutzerfreundlicher Name, der in UI-Oberflächen angezeigt wird. Fällt auf `name` zurück, wenn weggelassen. Kann Leerzeichen und beliebige Groß-/Kleinschreibung enthalten. Wird nicht für Namensräume oder Suche verwendet. Erfordert Claude Code v2.1.143 oder später. |

227| `version` | string | Plugin-Version. Falls gesetzt (hier oder in `plugin.json`), wird das Plugin auf diese Zeichenkette festgelegt und Benutzer erhalten Updates nur, wenn sie sich ändert. Weglassen, um auf den Git-Commit-SHA zurückzugreifen. Siehe [Versionsauflösung](#version-resolution-and-release-channels). |227| `version` | string | Plugin-Version. Falls gesetzt (hier oder in `plugin.json`), wird das Plugin auf diese Zeichenkette festgelegt und Benutzer erhalten Updates nur, wenn sie sich ändert. Weglassen, um auf den Git-Commit-SHA zurückzugreifen. Siehe [Versionsauflösung](#version-resolution-and-release-channels). |

236| `relevance` | object | {/* min-version: 2.1.152 */}Signale, die Claude Code mitteilen, wann dieses Plugin Benutzern empfohlen werden soll. Wirkt sich nur auf Marktplätze aus, die ein Administrator in verwalteten Einstellungen auf die Whitelist setzt. Siehe [Plugins für Ihre Organisation empfehlen](/de/plugin-relevance). Erfordert Claude Code v2.1.152 oder später. |236| `relevance` | object | Signale, die Claude Code mitteilen, wann dieses Plugin Benutzern empfohlen werden soll. Wirkt sich nur auf Marktplätze aus, die ein Administrator in verwalteten Einstellungen auf die Whitelist setzt. Siehe [Plugins für Ihre Organisation empfehlen](/docs/de/plugin-relevance). Erfordert Claude Code v2.1.152 oder später. |

237| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}Ob das Plugin nach der Installation aktiviert ist (Standard: true). Setzen Sie auf `false`, um das Plugin deaktiviert zu installieren, bis sich der Benutzer anmeldet. Hat Vorrang vor dem gleichen Feld in der `plugin.json` des Plugins. Siehe [Standardaktivierung](/de/plugins-reference#default-enablement). Erfordert Claude Code v2.1.154 oder später. |237| `defaultEnabled` | boolean | Ob das Plugin nach der Installation aktiviert ist (Standard: true). Setzen Sie auf `false`, um das Plugin deaktiviert zu installieren, bis sich der Benutzer anmeldet. Hat Vorrang vor dem gleichen Feld in der `plugin.json` des Plugins. Siehe [Standardaktivierung](/docs/de/plugins-reference#default-enablement). Erfordert Claude Code v2.1.154 oder später. |

238 238

239**Komponenten-Konfigurationsfelder:**239**Komponenten-Konfigurationsfelder:**

240 240

510 510

511* **`commands` und `agents`**: Sie können mehrere Verzeichnisse oder einzelne Dateien angeben. Pfade sind relativ zum Plugin-Root.511* **`commands` und `agents`**: Sie können mehrere Verzeichnisse oder einzelne Dateien angeben. Pfade sind relativ zum Plugin-Root.

512* **`${CLAUDE_PLUGIN_ROOT}`**: Verwenden Sie diese Variable in hooks und MCP-Server-Konfigurationen, um auf Dateien im Installationsverzeichnis des Plugins zu verweisen. Dies ist notwendig, da Plugins beim Installieren an einen Cache-Speicherort kopiert werden.512* **`${CLAUDE_PLUGIN_ROOT}`**: Verwenden Sie diese Variable in hooks und MCP-Server-Konfigurationen, um auf Dateien im Installationsverzeichnis des Plugins zu verweisen. Dies ist notwendig, da Plugins beim Installieren an einen Cache-Speicherort kopiert werden.

513 * Siehe die [Substitutionstabelle](/de/plugins-reference#environment-variables) für welche Konfigurationsfelder sie pro Servertyp ersetzen513 * Siehe die [Substitutionstabelle](/docs/de/plugins-reference#environment-variables) für welche Konfigurationsfelder sie pro Servertyp ersetzen

514 * Verwenden Sie für Abhängigkeiten oder Status, die Plugin-Updates überstehen sollten, stattdessen [`${CLAUDE_PLUGIN_DATA}`](/de/plugins-reference#persistent-data-directory)514 * Verwenden Sie für Abhängigkeiten oder Status, die Plugin-Updates überstehen sollten, stattdessen [`${CLAUDE_PLUGIN_DATA}`](/docs/de/plugins-reference#persistent-data-directory)

515* **`strict: false`**: Da dies auf false gesetzt ist, benötigt das Plugin keine eigene `plugin.json`. Der Marktplatz-Eintrag definiert alles. Siehe [Strict Mode](#strict-mode) unten.515* **`strict: false`**: Da dies auf false gesetzt ist, benötigt das Plugin keine eigene `plugin.json`. Der Marktplatz-Eintrag definiert alles. Siehe [Strict Mode](#strict-mode) unten.

516 516

517Standardmäßig werden die Skills eines Plugins aus dem `skills/`-Verzeichnis unter seiner `source` geladen. Pfade, die im `skills`-Feld aufgelistet sind, werden zu diesem Scan hinzugefügt:517Standardmäßig werden die Skills eines Plugins aus dem `skills/`-Verzeichnis unter seiner `source` geladen. Pfade, die im `skills`-Feld aufgelistet sind, werden zu diesem Scan hinzugefügt:

575 Private Repositories575 Private Repositories

576</h3>576</h3>

577 577

578Claude Code unterstützt die Installation von Plugins aus privaten Repositories. Für manuelle Installation und Updates verwendet Claude Code Ihre vorhandenen Git-Credential-Helper, daher funktioniert HTTPS-Zugriff über `gh auth login`, macOS Keychain oder `git-credential-store` genauso wie in Ihrem Terminal. SSH-Zugriff funktioniert, solange der Host bereits in Ihrer `known_hosts`-Datei vorhanden ist und der Schlüssel in `ssh-agent` geladen ist, da Claude Code interaktive SSH-Eingabeaufforderungen für den Host-Fingerprint und die Schlüsselpassphrase unterdrückt. GitHub `owner/repo`-Kurzform-Quellen klonen standardmäßig über SSH; legen Sie [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/de/env-vars#variables) fest, um sie stattdessen über HTTPS zu klonen.578Claude Code unterstützt die Installation von Plugins aus privaten Repositories. Für manuelle Installation und Updates verwendet Claude Code Ihre vorhandenen Git-Credential-Helper, daher funktioniert HTTPS-Zugriff über `gh auth login`, macOS Keychain oder `git-credential-store` genauso wie in Ihrem Terminal. SSH-Zugriff funktioniert, solange der Host bereits in Ihrer `known_hosts`-Datei vorhanden ist und der Schlüssel in `ssh-agent` geladen ist, da Claude Code interaktive SSH-Eingabeaufforderungen für den Host-Fingerprint und die Schlüsselpassphrase unterdrückt. GitHub `owner/repo`-Kurzform-Quellen klonen standardmäßig über SSH; legen Sie [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/de/env-vars#variables) fest, um sie stattdessen über HTTPS zu klonen.

579 579

580Hintergrund-Auto-Updates funktionieren anders. Standardmäßig deaktiviert die Hintergrund-Aktualisierung Git-Credential-Helper für seinen `git pull`, sodass der Pull sich nicht bei privaten Repositories über HTTPS authentifizieren kann, auch wenn ein Helper konfiguriert ist. SSH-Remotes sind nicht betroffen: Ein in `ssh-agent` geladener Schlüssel authentifiziert Hintergrund-Pulls genauso wie manuelle Operationen. Wenn der Hintergrund-Pull fehlschlägt, greift Claude Code auf das erneute Klonen des Marktplatzes von Grund auf zurück. Das erneute Klonen verwendet Ihre gespeicherten Git-Anmeldedaten, kann aber bei großen Repositories [zeitlich überschritten werden](#git-operations-time-out), daher können Auto-Updates für private Marktplätze intermittierend fehlschlagen.580Hintergrund-Auto-Updates funktionieren anders. Standardmäßig deaktiviert die Hintergrund-Aktualisierung Git-Credential-Helper für seinen `git pull`, sodass der Pull sich nicht bei privaten Repositories über HTTPS authentifizieren kann, auch wenn ein Helper konfiguriert ist. SSH-Remotes sind nicht betroffen: Ein in `ssh-agent` geladener Schlüssel authentifiziert Hintergrund-Pulls genauso wie manuelle Operationen. Wenn der Hintergrund-Pull fehlschlägt, greift Claude Code auf das erneute Klonen des Marktplatzes von Grund auf zurück. Das erneute Klonen verwendet Ihre gespeicherten Git-Anmeldedaten, kann aber bei großen Repositories [zeitlich überschritten werden](#git-operations-time-out), daher können Auto-Updates für private Marktplätze intermittierend fehlschlagen.

581 581

619/plugin install quality-review-plugin@my-plugins619/plugin install quality-review-plugin@my-plugins

620```620```

621 621

622Für die vollständige Palette von Add-Befehlen (GitHub, Git-URLs, lokale Pfade, Remote-URLs) siehe [Marktplätze hinzufügen](/de/discover-plugins#add-marketplaces).622Für die vollständige Palette von Add-Befehlen (GitHub, Git-URLs, lokale Pfade, Remote-URLs) siehe [Marktplätze hinzufügen](/docs/de/discover-plugins#add-marketplaces).

623 623

624<h3 id="require-marketplaces-for-your-team">624<h3 id="require-marketplaces-for-your-team">

625 Marktplätze für Ihr Team erforderlich machen625 Marktplätze für Ihr Team erforderlich machen

651}651}

652```652```

653 653

654Für vollständige Konfigurationsoptionen siehe [Plugin-Einstellungen](/de/settings#plugin-settings).654Für vollständige Konfigurationsoptionen siehe [Plugin-Einstellungen](/docs/de/settings#plugin-settings).

655 655

656<Note>656<Note>

657 Wenn Sie eine lokale `directory`- oder `file`-Quelle mit einem relativen Pfad verwenden, wird der Pfad gegen den Haupt-Checkout Ihres Repositories aufgelöst. Wenn Sie Claude Code aus einem Git Worktree ausführen, verweist der Pfad immer noch auf den Haupt-Checkout, sodass alle Worktrees denselben Marktplatz-Speicherort teilen. Der Marktplatz-Status wird einmal pro Benutzer in `~/.claude/plugins/known_marketplaces.json` gespeichert, nicht pro Projekt.657 Wenn Sie eine lokale `directory`- oder `file`-Quelle mit einem relativen Pfad verwenden, wird der Pfad gegen den Haupt-Checkout Ihres Repositories aufgelöst. Wenn Sie Claude Code aus einem Git Worktree ausführen, verweist der Pfad immer noch auf den Haupt-Checkout, sodass alle Worktrees denselben Marktplatz-Speicherort teilen. Der Marktplatz-Status wird einmal pro Benutzer in `~/.claude/plugins/known_marketplaces.json` gespeichert, nicht pro Projekt.

699 Verwaltete Marktplatz-Einschränkungen699 Verwaltete Marktplatz-Einschränkungen

700</h3>700</h3>

701 701

702Für Organisationen, die strikte Kontrolle über Plugin-Quellen benötigen, können Administratoren einschränken, welche Plugin-Marktplätze Benutzer hinzufügen dürfen, indem sie die Einstellung [`strictKnownMarketplaces`](/de/settings#strictknownmarketplaces) in verwalteten Einstellungen verwenden. Um auch die CLI-Flags abzulehnen, die Plugins, Agenten und MCP-Server für einen einzelnen Durchlauf seitenladen, kombinieren Sie es mit [`disableSideloadFlags`](/de/settings#available-settings). Um eine Zulassungsliste zu erstellen, welche Plugins von Marktplätzen als kontextuelle Installationsvorschläge angezeigt werden können, legen Sie [`pluginSuggestionMarketplaces`](/de/settings#available-settings) fest.702Für Organisationen, die strikte Kontrolle über Plugin-Quellen benötigen, können Administratoren einschränken, welche Plugin-Marktplätze Benutzer hinzufügen dürfen, indem sie die Einstellung [`strictKnownMarketplaces`](/docs/de/settings#strictknownmarketplaces) in verwalteten Einstellungen verwenden. Um auch die CLI-Flags abzulehnen, die Plugins, Agenten und MCP-Server für einen einzelnen Durchlauf seitenladen, kombinieren Sie es mit [`disableSideloadFlags`](/docs/de/settings#available-settings). Um eine Zulassungsliste zu erstellen, welche Plugins von Marktplätzen als kontextuelle Installationsvorschläge angezeigt werden können, legen Sie [`pluginSuggestionMarketplaces`](/docs/de/settings#available-settings) fest.

703 703

704Wenn `strictKnownMarketplaces` in verwalteten Einstellungen konfiguriert ist, hängt das Einschränkungsverhalten vom Wert ab:704Wenn `strictKnownMarketplaces` in verwalteten Einstellungen konfiguriert ist, hängt das Einschränkungsverhalten vom Wert ab:

705 705

743}743}

744```744```

745 745

746Alle Marktplätze von einem internen Git-Server mit Regex-Musterabgleich auf dem Host zulassen. Dies ist der empfohlene Ansatz für [GitHub Enterprise Server](/de/github-enterprise-server#plugin-marketplaces-on-ghes) oder selbstgehostete GitLab-Instanzen:746Alle Marktplätze von einem internen Git-Server mit Regex-Musterabgleich auf dem Host zulassen. Dies ist der empfohlene Ansatz für [GitHub Enterprise Server](/docs/de/github-enterprise-server#plugin-marketplaces-on-ghes) oder selbstgehostete GitLab-Instanzen:

747 747

748```json theme={null}748```json theme={null}

749{749{

772Verwenden Sie `".*"` als `pathPattern`, um jeden Dateisystempfad zuzulassen und gleichzeitig Netzwerkquellen mit `hostPattern` zu steuern.772Verwenden Sie `".*"` als `pathPattern`, um jeden Dateisystempfad zuzulassen und gleichzeitig Netzwerkquellen mit `hostPattern` zu steuern.

773 773

774<Note>774<Note>

775 `strictKnownMarketplaces` schränkt ein, was Benutzer hinzufügen können, registriert aber nicht selbst Marktplätze. Um zulässige Marktplätze automatisch verfügbar zu machen, ohne dass Benutzer `/plugin marketplace add` ausführen müssen, kombinieren Sie es mit [`extraKnownMarketplaces`](/de/settings#extraknownmarketplaces) in derselben `managed-settings.json`. Siehe [Beide zusammen verwenden](/de/settings#strictknownmarketplaces).775 `strictKnownMarketplaces` schränkt ein, was Benutzer hinzufügen können, registriert aber nicht selbst Marktplätze. Um zulässige Marktplätze automatisch verfügbar zu machen, ohne dass Benutzer `/plugin marketplace add` ausführen müssen, kombinieren Sie es mit [`extraKnownMarketplaces`](/docs/de/settings#extraknownmarketplaces) in derselben `managed-settings.json`. Siehe [Beide zusammen verwenden](/docs/de/settings#strictknownmarketplaces).

776</Note>776</Note>

777 777

778<h4 id="how-restrictions-work">778<h4 id="how-restrictions-work">

790 790

791Exakter Abgleich normalisiert URLs nicht: Ein nachgestellter Schrägstrich, `.git`-Suffix oder `ssh://` versus `https://`-Form werden als unterschiedliche Werte behandelt. Wenn Ihr Organisations-Marktplatz durch mehr als eine URL-Form geklont werden kann, bevorzugen Sie einen `hostPattern`-Eintrag gegenüber einer literalen URL, damit alle Formen übereinstimmen.791Exakter Abgleich normalisiert URLs nicht: Ein nachgestellter Schrägstrich, `.git`-Suffix oder `ssh://` versus `https://`-Form werden als unterschiedliche Werte behandelt. Wenn Ihr Organisations-Marktplatz durch mehr als eine URL-Form geklont werden kann, bevorzugen Sie einen `hostPattern`-Eintrag gegenüber einer literalen URL, damit alle Formen übereinstimmen.

792 792

793Da `strictKnownMarketplaces` in [verwalteten Einstellungen](/de/settings#settings-files) festgelegt ist, können einzelne Benutzer und Projektkonfigurationen diese Einschränkungen nicht überschreiben.793Da `strictKnownMarketplaces` in [verwalteten Einstellungen](/docs/de/settings#settings-files) festgelegt ist, können einzelne Benutzer und Projektkonfigurationen diese Einschränkungen nicht überschreiben.

794 794

795Für vollständige Konfigurationsdetails einschließlich aller unterstützten Quellentypen und Vergleich mit `extraKnownMarketplaces` siehe die [strictKnownMarketplaces-Referenz](/de/settings#strictknownmarketplaces).795Für vollständige Konfigurationsdetails einschließlich aller unterstützten Quellentypen und Vergleich mit `extraKnownMarketplaces` siehe die [strictKnownMarketplaces-Referenz](/docs/de/settings#strictknownmarketplaces).

796 796

797<h3 id="version-resolution-and-release-channels">797<h3 id="version-resolution-and-release-channels">

798 Versionsauflösung und Release-Kanäle798 Versionsauflösung und Release-Kanäle

818 Richten Sie Release-Kanäle ein818 Richten Sie Release-Kanäle ein

819</h4>819</h4>

820 820

821Um "stabile" und "neueste" Release-Kanäle für Ihre Plugins zu unterstützen, können Sie zwei Marktplätze einrichten, die auf verschiedene Refs oder SHAs desselben Repos verweisen. Sie können dann die beiden Marktplätze verschiedenen Benutzergruppen über [verwaltete Einstellungen](/de/settings#settings-files) zuweisen.821Um "stabile" und "neueste" Release-Kanäle für Ihre Plugins zu unterstützen, können Sie zwei Marktplätze einrichten, die auf verschiedene Refs oder SHAs desselben Repos verweisen. Sie können dann die beiden Marktplätze verschiedenen Benutzergruppen über [verwaltete Einstellungen](/docs/de/settings#settings-files) zuweisen.

822 822

823<Warning>823<Warning>

824 Jeder Kanal muss sich zu einer anderen Version auflösen. Wenn Sie explizite Versionen verwenden, muss `plugin.json` eine andere `version` bei jedem angehefteten Ref deklarieren. Wenn Sie `version` weglassen, unterscheiden die unterschiedlichen Commit-SHAs bereits die Kanäle. Wenn zwei Refs sich zu der gleichen Versionskette auflösen, behandelt Claude Code sie als identisch und überspringt das Update.824 Jeder Kanal muss sich zu einer anderen Version auflösen. Wenn Sie explizite Versionen verwenden, muss `plugin.json` eine andere `version` bei jedem angehefteten Ref deklarieren. Wenn Sie `version` weglassen, unterscheiden die unterschiedlichen Commit-SHAs bereits die Kanäle. Wenn zwei Refs sich zu der gleichen Versionskette auflösen, behandelt Claude Code sie als identisch und überspringt das Update.

898 Abhängigkeitsversionen anheften898 Abhängigkeitsversionen anheften

899</h4>899</h4>

900 900

901Ein Plugin kann seine Abhängigkeiten auf einen Semver-Bereich beschränken, damit Updates einer Abhängigkeit das abhängige Plugin nicht unterbrechen. Siehe [Plugin-Abhängigkeitsversionen einschränken](/de/plugin-dependencies) für die `{plugin-name}--v{version}` Git-Tag-Konvention, Bereichssyntax und wie mehrere Einschränkungen auf die gleiche Abhängigkeit kombiniert werden.901Ein Plugin kann seine Abhängigkeiten auf einen Semver-Bereich beschränken, damit Updates einer Abhängigkeit das abhängige Plugin nicht unterbrechen. Siehe [Plugin-Abhängigkeitsversionen einschränken](/docs/de/plugin-dependencies) für die `{plugin-name}--v{version}` Git-Tag-Konvention, Bereichssyntax und wie mehrere Einschränkungen auf die gleiche Abhängigkeit kombiniert werden.

902 902

903<h3 id="rename-or-remove-a-plugin">903<h3 id="rename-or-remove-a-plugin">

904 Ein Plugin umbenennen oder entfernen904 Ein Plugin umbenennen oder entfernen

968/plugin install test-plugin@marketplace-name968/plugin install test-plugin@marketplace-name

969```969```

970 970

971Für vollständige Plugin-Test-Workflows siehe [Testen Sie Ihre Plugins lokal](/de/plugins#test-your-plugins-locally). Für technische Fehlerbehebung siehe [Plugins-Referenz](/de/plugins-reference).971Für vollständige Plugin-Test-Workflows siehe [Testen Sie Ihre Plugins lokal](/docs/de/plugins#test-your-plugins-locally). Für technische Fehlerbehebung siehe [Plugins-Referenz](/docs/de/plugins-reference).

972 972

973<h2 id="manage-marketplaces-from-the-cli">973<h2 id="manage-marketplaces-from-the-cli">

974 Verwalten Sie Marktplätze über die CLI974 Verwalten Sie Marktplätze über die CLI

996 996

998| :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------- |998| :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------- |

999| `--scope <scope>` | Wo der Marktplatz deklariert werden soll: `user`, `project` oder `local`. Siehe [Plugin-Installationsbereiche](/de/plugins-reference#plugin-installation-scopes) | `user` |999| `--scope <scope>` | Wo der Marktplatz deklariert werden soll: `user`, `project` oder `local`. Siehe [Plugin-Installationsbereiche](/docs/de/plugins-reference#plugin-installation-scopes) | `user` |

1000| `--sparse <paths...>` | Begrenzen Sie den Checkout auf bestimmte Verzeichnisse über git sparse-checkout. Nützlich für Monorepos | |1000| `--sparse <paths...>` | Begrenzen Sie den Checkout auf bestimmte Verzeichnisse über git sparse-checkout. Nützlich für Monorepos | |

1001 1001

1002Fügen Sie einen Marktplatz aus GitHub mit `owner/repo` Kurzform hinzu:1002Fügen Sie einen Marktplatz aus GitHub mit `owner/repo` Kurzform hinzu:

1077 1077

1079| :---------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------- |1079| :---------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------- |

1080| `--scope <scope>` | Beschränken Sie die Entfernung auf einen einzelnen Einstellungsbereich: `user`, `project` oder `local`. Siehe [Plugin-Installationsbereiche](/de/plugins-reference#plugin-installation-scopes). Wenn weggelassen, wird die Deklaration aus jedem bearbeitbaren Bereich entfernt. Wenn angegeben, wird nur die Deklaration dieses Bereichs entfernt; der gemeinsame Status, der Cache und die installierten Plugin-Daten werden beibehalten, wenn der Marktplatz noch in einem anderen Bereich deklariert ist | (alle Bereiche) |1080| `--scope <scope>` | Beschränken Sie die Entfernung auf einen einzelnen Einstellungsbereich: `user`, `project` oder `local`. Siehe [Plugin-Installationsbereiche](/docs/de/plugins-reference#plugin-installation-scopes). Wenn weggelassen, wird die Deklaration aus jedem bearbeitbaren Bereich entfernt. Wenn angegeben, wird nur die Deklaration dieses Bereichs entfernt; der gemeinsame Status, der Cache und die installierten Plugin-Daten werden beibehalten, wenn der Marktplatz noch in einem anderen Bereich deklariert ist | (alle Bereiche) |

1081 1081

1082<Warning>1082<Warning>

1083 Das Entfernen eines Marktplatzes aus seinem letzten verbleibenden Bereich deinstalliert auch alle Plugins, die Sie von ihm installiert haben. Um einen Marktplatz zu aktualisieren, ohne installierte Plugins zu verlieren, verwenden Sie stattdessen `claude plugin marketplace update`.1083 Das Entfernen eines Marktplatzes aus seinem letzten verbleibenden Bereich deinstalliert auch alle Plugins, die Sie von ihm installiert haben. Um einen Marktplatz zu aktualisieren, ohne installierte Plugins zu verlieren, verwenden Sie stattdessen `claude plugin marketplace update`.

1238 1238

1239**Ursache**: Plugins werden in ein Cache-Verzeichnis kopiert, anstatt an Ort und Stelle verwendet zu werden. Pfade, die auf Dateien außerhalb des Plugin-Verzeichnisses verweisen (wie `../shared-utils`), funktionieren nicht, da diese Dateien nicht kopiert werden.1239**Ursache**: Plugins werden in ein Cache-Verzeichnis kopiert, anstatt an Ort und Stelle verwendet zu werden. Pfade, die auf Dateien außerhalb des Plugin-Verzeichnisses verweisen (wie `../shared-utils`), funktionieren nicht, da diese Dateien nicht kopiert werden.

1240 1240

1241**Lösungen**: Siehe [Plugin-Caching und Dateiauflösung](/de/plugins-reference#plugin-caching-and-file-resolution) für Workarounds, einschließlich Symlinks und Verzeichnisumstrukturierung.1241**Lösungen**: Siehe [Plugin-Caching und Dateiauflösung](/docs/de/plugins-reference#plugin-caching-and-file-resolution) für Workarounds, einschließlich Symlinks und Verzeichnisumstrukturierung.

1242 1242

1243Für zusätzliche Debugging-Tools und häufige Probleme siehe [Debugging- und Entwicklungstools](/de/plugins-reference#debugging-and-development-tools).1243Für zusätzliche Debugging-Tools und häufige Probleme siehe [Debugging- und Entwicklungstools](/docs/de/plugins-reference#debugging-and-development-tools).

1244 1244

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

1246 Siehe auch1246 Siehe auch

1247</h2>1247</h2>

1248 1248

1249* [Entdecken und Installieren vorgefertigter Plugins](/de/discover-plugins) - Installieren von Plugins aus vorhandenen Marktplätzen1249* [Entdecken und Installieren vorgefertigter Plugins](/docs/de/discover-plugins) - Installieren von Plugins aus vorhandenen Marktplätzen

1250* [Plugins](/de/plugins) - Erstellen Ihrer eigenen Plugins1250* [Plugins](/docs/de/plugins) - Erstellen Ihrer eigenen Plugins

1251* [Plugins-Referenz](/de/plugins-reference) - Vollständige technische Spezifikationen und Schemas1251* [Plugins-Referenz](/docs/de/plugins-reference) - Vollständige technische Spezifikationen und Schemas

1252* [Plugin-Einstellungen](/de/settings#plugin-settings) - Plugin-Konfigurationsoptionen1252* [Plugin-Einstellungen](/docs/de/settings#plugin-settings) - Plugin-Konfigurationsoptionen

1253* [strictKnownMarketplaces-Referenz](/de/settings#strictknownmarketplaces) - Verwaltete Marktplatz-Einschränkungen1253* [strictKnownMarketplaces-Referenz](/docs/de/settings#strictknownmarketplaces) - Verwaltete Marktplatz-Einschränkungen

plugin-relevance.md +13 −13

Details

8 8

9Wenn Sie einen Plugin-Marketplace für Ihre Organisation betreiben, können Sie Claude Code so konfigurieren, dass bestimmte Plugins Benutzern basierend auf ihrer aktuellen Arbeit vorgeschlagen werden. Fügen Sie einen `relevance`-Block zum Plugin-Eintrag in `marketplace.json` hinzu und genehmigen Sie den Marketplace in verwalteten Einstellungen. Wenn eine Benutzersitzung einem der deklarierten Signale entspricht, zeigt Claude Code einen Installationsvorschlag für dieses Plugin an.9Wenn Sie einen Plugin-Marketplace für Ihre Organisation betreiben, können Sie Claude Code so konfigurieren, dass bestimmte Plugins Benutzern basierend auf ihrer aktuellen Arbeit vorgeschlagen werden. Fügen Sie einen `relevance`-Block zum Plugin-Eintrag in `marketplace.json` hinzu und genehmigen Sie den Marketplace in verwalteten Einstellungen. Wenn eine Benutzersitzung einem der deklarierten Signale entspricht, zeigt Claude Code einen Installationsvorschlag für dieses Plugin an.

10 10

11Marketplace-deklarierte Vorschläge sind pro Marketplace durch [verwaltete Einstellungen](/de/settings#settings-files) optional. Kein `relevance`-Deklaration eines Marketplace erzeugt Vorschläge, bis ein Administrator ihn zur Genehmigungsliste hinzufügt, einschließlich des offiziellen Anthropic-Marketplace. Claude Code enthält auch einen integrierten Vorschlag, der unabhängig von dieser Genehmigungsliste ist; dieser Tipp und alle Marketplace-deklarierten Tipps sind deaktiviert, wenn [`spinnerTipsEnabled`](/de/settings#available-settings) auf `false` gesetzt ist.11Marketplace-deklarierte Vorschläge sind pro Marketplace durch [verwaltete Einstellungen](/docs/de/settings#settings-files) optional. Kein `relevance`-Deklaration eines Marketplace erzeugt Vorschläge, bis ein Administrator ihn zur Genehmigungsliste hinzufügt, einschließlich des offiziellen Anthropic-Marketplace. Claude Code enthält auch einen integrierten Vorschlag, der unabhängig von dieser Genehmigungsliste ist; dieser Tipp und alle Marketplace-deklarierten Tipps sind deaktiviert, wenn [`spinnerTipsEnabled`](/docs/de/settings#available-settings) auf `false` gesetzt ist.

12 12

~~13{/* min-version: 2.1.152 */}Diese Funktion erfordert Claude Code v2.1.152 oder später. Ältere Clients ignorieren das `relevance`-Feld.~~13Diese Funktion erfordert Claude Code v2.1.152 oder später. Ältere Clients ignorieren das `relevance`-Feld.

14 14

~~15Diese Seite ist für Marketplace-Betreiber und Enterprise-Administratoren. Wenn Sie Plugins installieren möchten, siehe [Plugins entdecken und installieren](/de/discover-plugins).~~15Diese Seite ist für Marketplace-Betreiber und Enterprise-Administratoren. Wenn Sie Plugins installieren möchten, siehe [Plugins entdecken und installieren](/docs/de/discover-plugins).

16 16

17<h2 id="how-it-works">17<h2 id="how-it-works">

18 Funktionsweise18 Funktionsweise

25Wenn ein Signal übereinstimmt und das Plugin nicht bereits installiert ist, zeigt Claude Code das Plugin an drei Stellen an:25Wenn ein Signal übereinstimmt und das Plugin nicht bereits installiert ist, zeigt Claude Code das Plugin an drei Stellen an:

26 26

27* **Spinner-Tipp**: Eine Meldung „Arbeiten mit *Thema*? Installieren Sie das *Plugin*-Plugin" mit dem `/plugin install`-Befehl wird unter dem Spinner angezeigt, während Claude antwortet.27* **Spinner-Tipp**: Eine Meldung „Arbeiten mit *Thema*? Installieren Sie das *Plugin*-Plugin" mit dem `/plugin install`-Befehl wird unter dem Spinner angezeigt, während Claude antwortet.

28* **Sitzungsstart-Vorschlag**: {/* min-version: 2.1.153 */}Wenn das `cwd`-Signal dem Arbeitsverzeichnis entspricht, wird eine einzeilige `plugin suggestion: <name>@<marketplace> · /plugin`-Benachrichtigung vor dem ersten Turn angezeigt. Diese Oberfläche erfordert Claude Code v2.1.153 oder später.28* **Sitzungsstart-Vorschlag**: Wenn das `cwd`-Signal dem Arbeitsverzeichnis entspricht, wird eine einzeilige `plugin suggestion: <name>@<marketplace> · /plugin`-Benachrichtigung vor dem ersten Turn angezeigt. Diese Oberfläche erfordert Claude Code v2.1.153 oder später.

29* **`/plugin` Discover-Registerkarte**: {/* min-version: 2.1.154 */}Das Plugin wird oben in der Discover-Liste mit einer Anmerkung wie „für dieses Verzeichnis empfohlen" oder „für Stripe-Befehle empfohlen" angeheftet. Diese Oberfläche erfordert Claude Code v2.1.154 oder später.29* **`/plugin` Discover-Registerkarte**: Das Plugin wird oben in der Discover-Liste mit einer Anmerkung wie „für dieses Verzeichnis empfohlen" oder „für Stripe-Befehle empfohlen" angeheftet. Diese Oberfläche erfordert Claude Code v2.1.154 oder später.

30 30

31Der Spinner-Tipp und die Sitzungsstart-Benachrichtigung sind Teil des Spinner-Tipps-Systems. Beide sind deaktiviert, wenn der Benutzer oder das Projekt `spinnerTipsEnabled` auf `false` setzt oder wenn ein benutzerdefinierter `spinnerTipsOverride` mit `excludeDefault` konfiguriert ist. Das Anheften auf der Discover-Registerkarte ist unabhängig von Tipp-Einstellungen.31Der Spinner-Tipp und die Sitzungsstart-Benachrichtigung sind Teil des Spinner-Tipps-Systems. Beide sind deaktiviert, wenn der Benutzer oder das Projekt `spinnerTipsEnabled` auf `false` setzt oder wenn ein benutzerdefinierter `spinnerTipsOverride` mit `excludeDefault` konfiguriert ist. Das Anheften auf der Discover-Registerkarte ist unabhängig von Tipp-Einstellungen.

32 32

80 80

81| Feld | Typ | Beschreibung |81| Feld | Typ | Beschreibung |

82| :------------- | :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |82| :------------- | :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

83| `cwd` | array of strings | {/* min-version: 2.1.153 */}Glob-Muster, die gegen das Arbeitsverzeichnis der Sitzung abgeglichen werden. Abgeglichen als absoluter Pfad und, wenn sich in einem Git-Repository befindet, als Pfad relativ zum Repository-Root. Schrägstrich-normalisiert und Groß-/Kleinschreibung-insensitiv. Jedes Muster passt zum Verzeichnis selbst und allem darunter, daher verhalten sich `infra`, `infra/` und `infra/**` identisch. Dies ist das einzige Signal, das beim Sitzungsstart vor dem ersten Turn übereinstimmen kann. Maximal 10 Muster mit je 256 Zeichen. |83| `cwd` | array of strings | Glob-Muster, die gegen das Arbeitsverzeichnis der Sitzung abgeglichen werden. Abgeglichen als absoluter Pfad und, wenn sich in einem Git-Repository befindet, als Pfad relativ zum Repository-Root. Schrägstrich-normalisiert und Groß-/Kleinschreibung-insensitiv. Jedes Muster passt zum Verzeichnis selbst und allem darunter, daher verhalten sich `infra`, `infra/` und `infra/**` identisch. Dies ist das einzige Signal, das beim Sitzungsstart vor dem ersten Turn übereinstimmen kann. Maximal 10 Muster mit je 256 Zeichen. |

84| `cli` | array of strings | Befehlsnamen aus Shell-Befehlen, die Claude in dieser Sitzung ausgeführt hat, z. B. `["stripe"]`. Gilt auf jeder Plattform: Befehle, die unter Windows über PowerShell oder Git Bash ausgeführt werden, werden auf die gleiche Weise aufgezeichnet. Claude Code zeichnet einen Befehlsnamen pro Shell-Tool-Aufruf auf: das erste Token nach allen führenden Umgebungsvariablenzuweisungen und `sudo`. Zusammengesetzte Befehle tragen nur ihren führenden Befehl bei, daher zeichnet `cd infra && terraform plan` `cd` auf, nicht `terraform`. Exakte Übereinstimmung. Maximal 10 Einträge mit je 64 Zeichen. |84| `cli` | array of strings | Befehlsnamen aus Shell-Befehlen, die Claude in dieser Sitzung ausgeführt hat, z. B. `["stripe"]`. Gilt auf jeder Plattform: Befehle, die unter Windows über PowerShell oder Git Bash ausgeführt werden, werden auf die gleiche Weise aufgezeichnet. Claude Code zeichnet einen Befehlsnamen pro Shell-Tool-Aufruf auf: das erste Token nach allen führenden Umgebungsvariablenzuweisungen und `sudo`. Zusammengesetzte Befehle tragen nur ihren führenden Befehl bei, daher zeichnet `cd infra && terraform plan` `cd` auf, nicht `terraform`. Exakte Übereinstimmung. Maximal 10 Einträge mit je 64 Zeichen. |

85| `hosts` | array of strings | Hostnamen in `http://`- oder `https://`-URLs in Bash-Befehlen dieser Sitzung, z. B. `["api.stripe.com"]`. Nur reiner Hostname in Kleinbuchstaben: kein Schema, Port oder Pfad. Exakte Groß-/Kleinschreibung-insensitive Übereinstimmung. Maximal 20 Einträge mit je 128 Zeichen. |85| `hosts` | array of strings | Hostnamen in `http://`- oder `https://`-URLs in Bash-Befehlen dieser Sitzung, z. B. `["api.stripe.com"]`. Nur reiner Hostname in Kleinbuchstaben: kein Schema, Port oder Pfad. Exakte Groß-/Kleinschreibung-insensitive Übereinstimmung. Maximal 20 Einträge mit je 128 Zeichen. |

86| `filesRead` | array of strings | {/* min-version: 2.1.153 */}Glob-Muster, die gegen die Pfade von Dateien abgeglichen werden, die Claude in dieser Sitzung gelesen hat, z. B. `["**/*.tf"]`. Schrägstrich-normalisiert und Groß-/Kleinschreibung-insensitiv. Maximal 10 Muster mit je 256 Zeichen. |86| `filesRead` | array of strings | Glob-Muster, die gegen die Pfade von Dateien abgeglichen werden, die Claude in dieser Sitzung gelesen hat, z. B. `["**/*.tf"]`. Schrägstrich-normalisiert und Groß-/Kleinschreibung-insensitiv. Maximal 10 Muster mit je 256 Zeichen. |

87| `manifestDeps` | array of objects | Abhängigkeiten, die in Paketmanifesten deklariert sind, die Claude in dieser Sitzung gelesen hat. Jeder Eintrag ist `{ "file": "...", "pattern": "..." }`, wobei `file` ein regulärer Ausdruck ist, der gegen den Pfad der Manifestdatei abgeglichen wird, wie er im Sitzungszustand aufgezeichnet ist, typischerweise ein absoluter Pfad, und `pattern` ein regulärer Ausdruck ist, der gegen den Inhalt dieser Datei abgeglichen wird. Verankern Sie `file` am Ende, z. B. `[/\\\\]package\\.json$` in JSON-escaped-Form, da ein am Anfang verankertes Muster niemals einen absoluten Pfad passt. Pfade sind nicht Separator-normalisiert für dieses Signal, daher verwenden Windows-Pfade Backslashes. Manifestdateien größer als 512 KB werden übersprungen. Beide Werte sind JavaScript-`RegExp`-Quellzeichenfolgen mit maximal 256 Zeichen. `file` passt Groß-/Kleinschreibung-insensitiv. `pattern` ist Groß-/Kleinschreibung-sensitiv. Maximal 10 Einträge. |87| `manifestDeps` | array of objects | Abhängigkeiten, die in Paketmanifesten deklariert sind, die Claude in dieser Sitzung gelesen hat. Jeder Eintrag ist `{ "file": "...", "pattern": "..." }`, wobei `file` ein regulärer Ausdruck ist, der gegen den Pfad der Manifestdatei abgeglichen wird, wie er im Sitzungszustand aufgezeichnet ist, typischerweise ein absoluter Pfad, und `pattern` ein regulärer Ausdruck ist, der gegen den Inhalt dieser Datei abgeglichen wird. Verankern Sie `file` am Ende, z. B. `[/\\\\]package\\.json$` in JSON-escaped-Form, da ein am Anfang verankertes Muster niemals einen absoluten Pfad passt. Pfade sind nicht Separator-normalisiert für dieses Signal, daher verwenden Windows-Pfade Backslashes. Manifestdateien größer als 512 KB werden übersprungen. Beide Werte sind JavaScript-`RegExp`-Quellzeichenfolgen mit maximal 256 Zeichen. `file` passt Groß-/Kleinschreibung-insensitiv. `pattern` ist Groß-/Kleinschreibung-sensitiv. Maximal 10 Einträge. |

88 88

89Die Signale `cli`, `hosts`, `filesRead` und `manifestDeps` benötigen Sitzungsverlauf, daher können sie nur auf dem Spinner-Tipp und der Discover-Registerkarte übereinstimmen. Nur `cwd` kann beim Sitzungsstart übereinstimmen. Die Signale `filesRead` und `manifestDeps` testen den aufgezeichneten Dateizustand der Sitzung, der auch Dateien enthält, die Claude geschrieben oder bearbeitet hat, und automatisch geladene `CLAUDE.md`-Speicherdateien.89Die Signale `cli`, `hosts`, `filesRead` und `manifestDeps` benötigen Sitzungsverlauf, daher können sie nur auf dem Spinner-Tipp und der Discover-Registerkarte übereinstimmen. Nur `cwd` kann beim Sitzungsstart übereinstimmen. Die Signale `filesRead` und `manifestDeps` testen den aufgezeichneten Dateizustand der Sitzung, der auch Dateien enthält, die Claude geschrieben oder bearbeitet hat, und automatisch geladene `CLAUDE.md`-Speicherdateien.

116 Vorschläge in verwalteten Einstellungen aktivieren116 Vorschläge in verwalteten Einstellungen aktivieren

117</h2>117</h2>

118 118

119Das Deklarieren von `relevance` in `marketplace.json` ist allein nicht ausreichend. Ein Administrator muss den Marketplace in [verwalteten Einstellungen](/de/settings#settings-files) genehmigen, bevor seine Vorschläge Benutzern angezeigt werden.119Das Deklarieren von `relevance` in `marketplace.json` ist allein nicht ausreichend. Ein Administrator muss den Marketplace in [verwalteten Einstellungen](/docs/de/settings#settings-files) genehmigen, bevor seine Vorschläge Benutzern angezeigt werden.

120 120

121Fügen Sie den Marketplace-Namen zu `pluginSuggestionMarketplaces` hinzu. Für jeden Marketplace außer dem offiziellen Anthropic-Marketplace deklarieren Sie auch die Marketplace-Quelle in denselben verwalteten Einstellungen, entweder als Eintrag dieses Namens in `extraKnownMarketplaces` oder als Eintrag in `strictKnownMarketplaces`. Der genehmigte Name wird ignoriert, wenn der auf dem Computer registrierte Marketplace aus einer anderen Quelle stammt. Dies verhindert, dass eine unabhängige Quelle sich unter einem genehmigten Namen registriert, um ihre Plugins in Ihrer Organisation vorgeschlagen zu bekommen.121Fügen Sie den Marketplace-Namen zu `pluginSuggestionMarketplaces` hinzu. Für jeden Marketplace außer dem offiziellen Anthropic-Marketplace deklarieren Sie auch die Marketplace-Quelle in denselben verwalteten Einstellungen, entweder als Eintrag dieses Namens in `extraKnownMarketplaces` oder als Eintrag in `strictKnownMarketplaces`. Der genehmigte Name wird ignoriert, wenn der auf dem Computer registrierte Marketplace aus einer anderen Quelle stammt. Dies verhindert, dass eine unabhängige Quelle sich unter einem genehmigten Namen registriert, um ihre Plugins in Ihrer Organisation vorgeschlagen zu bekommen.

122 122

144}144}

145```145```

146 146

147Siehe die [Einstellungsreferenz](/de/settings) für `pluginSuggestionMarketplaces` und [`extraKnownMarketplaces`](/de/settings#extraknownmarketplaces) für vollständige Konfigurationsdetails.147Siehe die [Einstellungsreferenz](/docs/de/settings) für `pluginSuggestionMarketplaces` und [`extraKnownMarketplaces`](/docs/de/settings#extraknownmarketplaces) für vollständige Konfigurationsdetails.

148 148

149<h2 id="what-the-user-sees">149<h2 id="what-the-user-sees">

150 Was der Benutzer sieht150 Was der Benutzer sieht

165 165

166Der Vorschlag eines bestimmten Plugins wird höchstens einmal alle drei Sitzungen über den Spinner-Tipp und die Sitzungsstart-Benachrichtigung kombiniert angezeigt, und keiner wiederholt sich, sobald das Plugin installiert ist. Die Sitzungsstart-Benachrichtigung stoppt zusätzlich, nachdem der Vorschlag zweimal angezeigt wurde.166Der Vorschlag eines bestimmten Plugins wird höchstens einmal alle drei Sitzungen über den Spinner-Tipp und die Sitzungsstart-Benachrichtigung kombiniert angezeigt, und keiner wiederholt sich, sobald das Plugin installiert ist. Die Sitzungsstart-Benachrichtigung stoppt zusätzlich, nachdem der Vorschlag zweimal angezeigt wurde.

167 167

168{/* min-version: 2.1.154 */}In der `/plugin` Discover-Registerkarte wird das Plugin oben in den anderen Ergebnissen mit einer Anmerkung angeheftet, die das übereinstimmende Signal benennt, z. B. `suggested for this directory` oder `suggested for terraform commands`. Die Discover-Registerkarte heftet ein bestimmtes Plugin einmal an; spätere Besuche listen es in normaler Reihenfolge auf. Das Anheften auf der Discover-Registerkarte erfordert Claude Code v2.1.154 oder später. In v2.1.152 wird nur der Spinner-Tipp angezeigt; die Sitzungsstart-Benachrichtigung wird in v2.1.153 hinzugefügt.168In der `/plugin` Discover-Registerkarte wird das Plugin oben in den anderen Ergebnissen mit einer Anmerkung angeheftet, die das übereinstimmende Signal benennt, z. B. `suggested for this directory` oder `suggested for terraform commands`. Die Discover-Registerkarte heftet ein bestimmtes Plugin einmal an; spätere Besuche listen es in normaler Reihenfolge auf. Das Anheften auf der Discover-Registerkarte erfordert Claude Code v2.1.154 oder später. In v2.1.152 wird nur der Spinner-Tipp angezeigt; die Sitzungsstart-Benachrichtigung wird in v2.1.153 hinzugefügt.

169 169

170<h2 id="validate-your-marketplace">170<h2 id="validate-your-marketplace">

171 Validieren Sie Ihren Marketplace171 Validieren Sie Ihren Marketplace

183 Siehe auch183 Siehe auch

184</h2>184</h2>

185 185

186* [Erstellen und verteilen Sie einen Plugin-Marketplace](/de/plugin-marketplaces): Erstellen Sie den Marketplace, der Ihre Plugins hostet186* [Erstellen und verteilen Sie einen Plugin-Marketplace](/docs/de/plugin-marketplaces): Erstellen Sie den Marketplace, der Ihre Plugins hostet

187* [Empfehlen Sie Ihr Plugin von Ihrer CLI](/de/plugin-hints): Fordern Sie Benutzer von Ihrer eigenen CLI auf, anstatt von Claude Code's Sitzungssignalen187* [Empfehlen Sie Ihr Plugin von Ihrer CLI](/docs/de/plugin-hints): Fordern Sie Benutzer von Ihrer eigenen CLI auf, anstatt von Claude Code's Sitzungssignalen

188* [Einstellungen](/de/settings): Vollständige Referenz für `pluginSuggestionMarketplaces` und `extraKnownMarketplaces`188* [Einstellungen](/docs/de/settings): Vollständige Referenz für `pluginSuggestionMarketplaces` und `extraKnownMarketplaces`

plugins-reference.md +3 −3

Details

516| :--------------- | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |516| :--------------- | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |

518| `displayName` | string | {/* min-version: 2.1.143 */}Benutzerfreundlicher Name, der in der `/plugin` Auswahl und anderen UI-Oberflächen angezeigt wird. Fällt auf `name` zurück, wenn weggelassen. Im Gegensatz zu `name` kann es Leerzeichen und beliebige Groß-/Kleinschreibung enthalten. Wird nicht für Namensgebung oder Suche verwendet. Erfordert Claude Code v2.1.143 oder später. | `"Deployment Tools"` |518| `displayName` | string | Benutzerfreundlicher Name, der in der `/plugin` Auswahl und anderen UI-Oberflächen angezeigt wird. Fällt auf `name` zurück, wenn weggelassen. Im Gegensatz zu `name` kann es Leerzeichen und beliebige Groß-/Kleinschreibung enthalten. Wird nicht für Namensgebung oder Suche verwendet. Erfordert Claude Code v2.1.143 oder später. | `"Deployment Tools"` |

519| `version` | string | Optional. Semantische Version. Das Setzen dieser Version fixiert das Plugin auf diese Versionsnummer, sodass Benutzer nur Updates erhalten, wenn Sie diese erhöhen. Wenn weggelassen, greift Claude Code auf den Git-Commit-SHA zurück, sodass jeder Commit als neue Version behandelt wird. Wenn auch im Marktplatz-Eintrag gesetzt, hat `plugin.json` Vorrang. Siehe [Versionsverwaltung](#version-management). | `"2.1.0"` |519| `version` | string | Optional. Semantische Version. Das Setzen dieser Version fixiert das Plugin auf diese Versionsnummer, sodass Benutzer nur Updates erhalten, wenn Sie diese erhöhen. Wenn weggelassen, greift Claude Code auf den Git-Commit-SHA zurück, sodass jeder Commit als neue Version behandelt wird. Wenn auch im Marktplatz-Eintrag gesetzt, hat `plugin.json` Vorrang. Siehe [Versionsverwaltung](#version-management). | `"2.1.0"` |

521| `author` | object | Autoreninformationen | `{"name": "Dev Team", "email": "dev@company.com"}` |521| `author` | object | Autoreninformationen | `{"name": "Dev Team", "email": "dev@company.com"}` |

526| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}Ob das Plugin in einem aktivierten Zustand startet, wenn der Benutzer keinen gesetzt hat. Standardmäßig `true`. Siehe [Standardaktivierung](#default-enablement). Erfordert Claude Code v2.1.154 oder später. | `false` |526| `defaultEnabled` | boolean | Ob das Plugin in einem aktivierten Zustand startet, wenn der Benutzer keinen gesetzt hat. Standardmäßig `true`. Siehe [Standardaktivierung](#default-enablement). Erfordert Claude Code v2.1.154 oder später. | `false` |

527 527

528<h3 id="default-enablement">528<h3 id="default-enablement">

529 Standardaktivierung529 Standardaktivierung

612 612

613Vor v2.1.207 ersetzten diese Felder `${user_config.KEY}` Werte; aktualisieren Sie Plugins, die sich darauf verlassen haben.613Vor v2.1.207 ersetzten diese Felder `${user_config.KEY}` Werte; aktualisieren Sie Plugins, die sich darauf verlassen haben.

614 614

615Nicht-sensitive Werte werden unter dem [`pluginConfigs`](/docs/de/settings#pluginconfigs) Schlüssel in `settings.json` als `pluginConfigs[<plugin-id>].options` gespeichert. {/* min-version: 2.1.207 */}Claude Code schreibt den Schlüssel in Benutzereinstellungen und liest ihn aus Benutzereinstellungen, dem `--settings` Flag und verwalteten Einstellungen zurück; Einträge in einer Projekt-`.claude/settings.json` oder `.claude/settings.local.json` werden ignoriert. Vor v2.1.207 las Claude Code auch Projekt- und lokale Einstellungen.615Nicht-sensitive Werte werden unter dem [`pluginConfigs`](/docs/de/settings#pluginconfigs) Schlüssel in `settings.json` als `pluginConfigs[<plugin-id>].options` gespeichert. Claude Code schreibt den Schlüssel in Benutzereinstellungen und liest ihn aus Benutzereinstellungen, dem `--settings` Flag und verwalteten Einstellungen zurück; Einträge in einer Projekt-`.claude/settings.json` oder `.claude/settings.local.json` werden ignoriert. Vor v2.1.207 las Claude Code auch Projekt- und lokale Einstellungen.

616 616

617Sensitive Werte gehen zum macOS Keychain oder zu `~/.claude/.credentials.json` auf Plattformen, wo kein unterstützter Keychain verfügbar ist. Keychain-Speicher wird mit OAuth-Tokens geteilt und hat ein ungefähres Gesamtlimit von 2 KB, daher halten Sie sensitive Werte klein.617Sensitive Werte gehen zum macOS Keychain oder zu `~/.claude/.credentials.json` auf Plattformen, wo kein unterstützter Keychain verfügbar ist. Keychain-Speicher wird mit OAuth-Tokens geteilt und hat ein ungefähres Gesamtlimit von 2 KB, daher halten Sie sensitive Werte klein.

618 618

prompt-caching.md +1 −1

Details

116 116

117Die Ausnahme ist ein Plugin, das [MCP-Server](/docs/de/plugins-reference#mcp-servers) bereitstellt. Das Aktivieren oder Deaktivieren eines solchen folgt den gleichen Regeln wie [Verbinden oder Trennen eines MCP-Servers](#connecting-or-disconnecting-an-mcp-server): Der Cache bleibt erhalten, wenn die Tools des Servers aufgeschoben werden, und die nächste Anfrage liest die gesamte Konversation neu, wenn sie in das Präfix geladen werden.117Die Ausnahme ist ein Plugin, das [MCP-Server](/docs/de/plugins-reference#mcp-servers) bereitstellt. Das Aktivieren oder Deaktivieren eines solchen folgt den gleichen Regeln wie [Verbinden oder Trennen eines MCP-Servers](#connecting-or-disconnecting-an-mcp-server): Der Cache bleibt erhalten, wenn die Tools des Servers aufgeschoben werden, und die nächste Anfrage liest die gesamte Konversation neu, wenn sie in das Präfix geladen werden.

118 118

119Plugin-Änderungen werden angewendet, wenn Sie [`/reload-plugins`](/docs/de/discover-plugins#apply-plugin-changes-without-restarting) ausführen oder eine neue Session starten. Die Kosten, ob angehängte Ankündigungen oder ein vollständiges Neueinlesen, zeigen sich beim ersten Turn nach dem Neustart, nicht wenn Sie `/plugin install`, `/plugin enable` oder `/plugin disable` ausführen. {/* min-version: 2.1.163 */}Ab v2.1.163 zeigt `/reload-plugins` eine Warnung an und wendet das Neustart nicht an, wenn ein Neustart das vollständige Neueinlesen auslösen würde. Übergeben Sie `--force`, um es trotzdem anzuwenden.119Plugin-Änderungen werden angewendet, wenn Sie [`/reload-plugins`](/docs/de/discover-plugins#apply-plugin-changes-without-restarting) ausführen oder eine neue Session starten. Die Kosten, ob angehängte Ankündigungen oder ein vollständiges Neueinlesen, zeigen sich beim ersten Turn nach dem Neustart, nicht wenn Sie `/plugin install`, `/plugin enable` oder `/plugin disable` ausführen. Ab v2.1.163 zeigt `/reload-plugins` eine Warnung an und wendet das Neustart nicht an, wenn ein Neustart das vollständige Neueinlesen auslösen würde. Übergeben Sie `--force`, um es trotzdem anzuwenden.

120 120

121Das Deaktivieren eines Plugins, das Sie früher in der Session aktiviert haben, stellt die vorherige Anfragefom wieder her. Wenn dieses Präfix noch innerhalb seiner [Cache-Lebensdauer](#cache-lifetime) liegt, liest die nächste Anfrage stattdessen den älteren Cache-Eintrag, anstatt ihn neu zu erstellen.121Das Deaktivieren eines Plugins, das Sie früher in der Session aktiviert haben, stellt die vorherige Anfragefom wieder her. Wenn dieses Präfix noch innerhalb seiner [Cache-Lebensdauer](#cache-lifetime) liegt, liest die nächste Anfrage stattdessen den älteren Cache-Eintrag, anstatt ihn neu zu erstellen.

122 122

remote-control.md +38 −38

Details

14 14

15Wenn Sie eine Remote Control-Sitzung auf Ihrem Computer starten, wird Claude die ganze Zeit lokal ausgeführt, sodass Ihre Code-Ausführung und Ihr Dateisystem-Zugriff auf Ihrem Computer bleiben. Mit Remote Control können Sie:15Wenn Sie eine Remote Control-Sitzung auf Ihrem Computer starten, wird Claude die ganze Zeit lokal ausgeführt, sodass Ihre Code-Ausführung und Ihr Dateisystem-Zugriff auf Ihrem Computer bleiben. Mit Remote Control können Sie:

16 16

17* **Ihre vollständige lokale Umgebung remote nutzen**: Ihr Dateisystem, [MCP servers](/de/mcp), Tools und Projektkonfiguration bleiben verfügbar, und durch Eingabe von `@` werden Dateipfade aus Ihrem lokalen Projekt automatisch vervollständigt17* **Ihre vollständige lokale Umgebung remote nutzen**: Ihr Dateisystem, [MCP servers](/docs/de/mcp), Tools und Projektkonfiguration bleiben verfügbar, und durch Eingabe von `@` werden Dateipfade aus Ihrem lokalen Projekt automatisch vervollständigt

18* **Von beiden Oberflächen gleichzeitig arbeiten**: Das Gespräch und der Fortschritt von [Subagenten](/de/sub-agents) und [dynamischen Workflows](/de/workflows) bleiben auf allen verbundenen Geräten synchronisiert, sodass Sie Nachrichten von Ihrem Terminal, Browser und Telefon austauschbar senden können. {/* min-version: 2.1.207 */}Vor v2.1.207 sendeten Sitzungen, die von der [Desktop-App](/de/desktop) gehostet wurden, keinen Fortschritt von Subagenten oder Workflows an verbundene Geräte.18* **Von beiden Oberflächen gleichzeitig arbeiten**: Das Gespräch und der Fortschritt von [Subagenten](/docs/de/sub-agents) und [dynamischen Workflows](/docs/de/workflows) bleiben auf allen verbundenen Geräten synchronisiert, sodass Sie Nachrichten von Ihrem Terminal, Browser und Telefon austauschbar senden können. Vor v2.1.207 sendeten Sitzungen, die von der [Desktop-App](/docs/de/desktop) gehostet wurden, keinen Fortschritt von Subagenten oder Workflows an verbundene Geräte.

19* **Bilder und Dateien von Ihrem Telefon oder Browser senden**: Wenn Sie einen Anhang in der Claude-App oder auf claude.ai/code hinzufügen, lädt Claude Code ihn auf Ihren Computer herunter und übergibt ihn Claude als `@`-Dateireferenz mit oder ohne Beschriftung. {/* min-version: 2.1.202 */}Vor v2.1.202 konnte Claude Code einen Anhang, der ohne Beschriftung gesendet wurde, vor Erreichen der Sitzung verwerfen.19* **Bilder und Dateien von Ihrem Telefon oder Browser senden**: Wenn Sie einen Anhang in der Claude-App oder auf claude.ai/code hinzufügen, lädt Claude Code ihn auf Ihren Computer herunter und übergibt ihn Claude als `@`-Dateireferenz mit oder ohne Beschriftung. Vor v2.1.202 konnte Claude Code einen Anhang, der ohne Beschriftung gesendet wurde, vor Erreichen der Sitzung verwerfen.

20* **Unterbrechungen überstehen**: Wenn Ihr Laptop in den Ruhezustand wechselt oder Ihr Netzwerk ausfällt, wird die Sitzung automatisch wiederhergestellt, wenn Ihr Computer wieder online ist. Claude Code stellt Status-Updates von Subagenten und Workflows in die Warteschlange, während die Verbindung wiederhergestellt wird, und liefert sie, sobald sie wiederhergestellt ist. {/* min-version: 2.1.207 */}Vor v2.1.207 konnte ein Update, das während einer Wiederverbindung oder Anmeldedaten-Aktualisierung gesendet wurde, verloren gehen, sodass das verbundene Gerät eine abgeschlossene Aufgabe weiterhin als laufend anzeigte.20* **Unterbrechungen überstehen**: Wenn Ihr Laptop in den Ruhezustand wechselt oder Ihr Netzwerk ausfällt, wird die Sitzung automatisch wiederhergestellt, wenn Ihr Computer wieder online ist. Claude Code stellt Status-Updates von Subagenten und Workflows in die Warteschlange, während die Verbindung wiederhergestellt wird, und liefert sie, sobald sie wiederhergestellt ist. Vor v2.1.207 konnte ein Update, das während einer Wiederverbindung oder Anmeldedaten-Aktualisierung gesendet wurde, verloren gehen, sodass das verbundene Gerät eine abgeschlossene Aufgabe weiterhin als laufend anzeigte.

21 21

22Im Gegensatz zu [Claude Code im Web](/de/claude-code-on-the-web), das auf Cloud-Infrastruktur ausgeführt wird, werden Remote Control-Sitzungen direkt auf Ihrem Computer ausgeführt und interagieren mit Ihrem lokalen Dateisystem. Die Web- und Mobile-Schnittstellen sind nur ein Fenster in diese lokale Sitzung.22Im Gegensatz zu [Claude Code im Web](/docs/de/claude-code-on-the-web), das auf Cloud-Infrastruktur ausgeführt wird, werden Remote Control-Sitzungen direkt auf Ihrem Computer ausgeführt und interagieren mit Ihrem lokalen Dateisystem. Die Web- und Mobile-Schnittstellen sind nur ein Fenster in diese lokale Sitzung.

23 23

24Diese Seite behandelt die Einrichtung, das Starten und Verbinden mit Sitzungen sowie den Vergleich von Remote Control mit Claude Code im Web.24Diese Seite behandelt die Einrichtung, das Starten und Verbinden mit Sitzungen sowie den Vergleich von Remote Control mit Claude Code im Web.

25 25

31 31

32* **Abonnement**: verfügbar in Pro-, Max-, Team- und Enterprise-Plänen. API-Schlüssel werden nicht unterstützt. Bei Team und Enterprise muss ein Owner zunächst den Remote Control-Schalter in den [Claude Code-Admin-Einstellungen](https://claude.ai/admin-settings/claude-code) aktivieren.32* **Abonnement**: verfügbar in Pro-, Max-, Team- und Enterprise-Plänen. API-Schlüssel werden nicht unterstützt. Bei Team und Enterprise muss ein Owner zunächst den Remote Control-Schalter in den [Claude Code-Admin-Einstellungen](https://claude.ai/admin-settings/claude-code) aktivieren.

33* **Authentifizierung**: Führen Sie `claude` aus und verwenden Sie `/login`, um sich über claude.ai anzumelden, falls Sie dies noch nicht getan haben.33* **Authentifizierung**: Führen Sie `claude` aus und verwenden Sie `/login`, um sich über claude.ai anzumelden, falls Sie dies noch nicht getan haben.

34* **API-Endpunkt**: nicht verfügbar auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry. {/* min-version: 2.1.196 */}Ab v2.1.196 ist Remote Control auch deaktiviert, wenn [`ANTHROPIC_BASE_URL`](/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. eine [LLM-Gateway](/de/llm-gateway) oder einen Proxy. Heben Sie die Variablenzuweisung auf, um Remote Control zu verwenden.34* **API-Endpunkt**: nicht verfügbar auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry. Ab v2.1.196 ist Remote Control auch deaktiviert, wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. eine [LLM-Gateway](/docs/de/llm-gateway) oder einen Proxy. Heben Sie die Variablenzuweisung auf, um Remote Control zu verwenden.

35* **Workspace-Vertrauen**: Führen Sie `claude` mindestens einmal in Ihrem Projektverzeichnis aus, um den Workspace-Vertrauensdialog zu akzeptieren.35* **Workspace-Vertrauen**: Führen Sie `claude` mindestens einmal in Ihrem Projektverzeichnis aus, um den Workspace-Vertrauensdialog zu akzeptieren.

36 36

37<h2 id="start-a-remote-control-session">37<h2 id="start-a-remote-control-session">

56 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |56 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

57 | `--name "My Project"` | Legen Sie einen benutzerdefinierten Sitzungstitel fest, der in der Sitzungsliste unter claude.ai/code sichtbar ist. |57 | `--name "My Project"` | Legen Sie einen benutzerdefinierten Sitzungstitel fest, der in der Sitzungsliste unter claude.ai/code sichtbar ist. |

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

59 | `-c`, `--continue` | {/* min-version: 2.1.200 */}Setzen Sie die zuletzt gestartete Remote Control-Sitzung aus diesem Verzeichnis fort, anstatt eine neue zu erstellen. Kann nicht mit `--session-id`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später; frühere Versionen lehnen das Flag als unbekanntes Argument ab. |59 | `-c`, `--continue` | Setzen Sie die zuletzt gestartete Remote Control-Sitzung aus diesem Verzeichnis fort, anstatt eine neue zu erstellen. Kann nicht mit `--session-id`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später; frühere Versionen lehnen das Flag als unbekanntes Argument ab. |

60 | `--session-id <id>` | {/* min-version: 2.1.200 */}Setzen Sie eine bestimmte Remote Control-Sitzung anhand ihrer ID fort. Kann nicht mit `--continue`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später; frühere Versionen lehnen das Flag als unbekanntes Argument ab. |60 | `--session-id <id>` | Setzen Sie eine bestimmte Remote Control-Sitzung anhand ihrer ID fort. Kann nicht mit `--continue`, `--spawn`, `--capacity` oder `--create-session-in-dir` kombiniert werden. Erfordert Claude Code v2.1.200 oder später; frühere Versionen lehnen das Flag als unbekanntes Argument ab. |

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

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

63 | `--[no-]create-session-in-dir` | Erstellen Sie vorab eine Sitzung im aktuellen Verzeichnis, wenn der Server startet, damit Sie sofort einen Ort zum Eingeben haben. Im `worktree`-Modus bleibt diese Sitzung im aktuellen Verzeichnis, während On-Demand-Sitzungen isolierte Worktrees erhalten. Standardmäßig aktiviert; übergeben Sie `--no-create-session-in-dir`, um ohne zu starten. |63 | `--[no-]create-session-in-dir` | Erstellen Sie vorab eine Sitzung im aktuellen Verzeichnis, wenn der Server startet, damit Sie sofort einen Ort zum Eingeben haben. Im `worktree`-Modus bleibt diese Sitzung im aktuellen Verzeichnis, während On-Demand-Sitzungen isolierte Worktrees erhalten. Standardmäßig aktiviert; übergeben Sie `--no-create-session-in-dir`, um ohne zu starten. |

65 | `--sandbox` / `--no-sandbox` | Aktivieren oder deaktivieren Sie [sandboxing](/de/sandboxing) für Dateisystem- und Netzwerkisolation. Standardmäßig deaktiviert. |65 | `--sandbox` / `--no-sandbox` | Aktivieren oder deaktivieren Sie [sandboxing](/docs/de/sandboxing) für Dateisystem- und Netzwerkisolation. Standardmäßig deaktiviert. |

66 </Tab>66 </Tab>

67 67

68 <Tab title="Interaktive Sitzung">68 <Tab title="Interaktive Sitzung">

100 </Tab>100 </Tab>

101 101

102 <Tab title="VS Code">102 <Tab title="VS Code">

103 In der [Claude Code VS Code-Erweiterung](/de/vs-code) geben Sie `/remote-control` oder `/rc` in das Eingabefeld ein, oder öffnen Sie das Befehlsmenü mit `/` und wählen Sie es aus.103 In der [Claude Code VS Code-Erweiterung](/docs/de/vs-code) geben Sie `/remote-control` oder `/rc` in das Eingabefeld ein, oder öffnen Sie das Befehlsmenü mit `/` und wählen Sie es aus.

104 104

105 ```text theme={null}105 ```text theme={null}

106 /remote-control106 /remote-control

132* **Scannen Sie den QR-Code**, der neben der Sitzungs-URL angezeigt wird, um ihn direkt in der Claude-App zu öffnen. Mit `claude remote-control` drücken Sie die Leertaste, um die QR-Code-Anzeige umzuschalten.132* **Scannen Sie den QR-Code**, der neben der Sitzungs-URL angezeigt wird, um ihn direkt in der Claude-App zu öffnen. Mit `claude remote-control` drücken Sie die Leertaste, um die QR-Code-Anzeige umzuschalten.

133* **Öffnen Sie [claude.ai/code](https://claude.ai/code) oder die Claude-App** und finden Sie die Sitzung nach Name in der Sitzungsliste. In der mobilen Claude-App tippen Sie auf **Code** in der Navigation, um die Sitzungsliste zu erreichen. Remote Control-Sitzungen zeigen ein Computersymbol mit einem grünen Statusindikator an, wenn sie online sind.133* **Öffnen Sie [claude.ai/code](https://claude.ai/code) oder die Claude-App** und finden Sie die Sitzung nach Name in der Sitzungsliste. In der mobilen Claude-App tippen Sie auf **Code** in der Navigation, um die Sitzungsliste zu erreichen. Remote Control-Sitzungen zeigen ein Computersymbol mit einem grünen Statusindikator an, wenn sie online sind.

134 134

135Wenn Sie sich verbinden, zeigt das Gerät alle Subagenten und Workflows an, die die Sitzung bereits im Hintergrund ausführt. {/* min-version: 2.1.208 */}Vor v2.1.208 zeigte ein Gerät, das sich mit einer in einem interaktiven Terminal gehosteten Sitzung verbindet, keine Subagenten und Workflows an, die bereits ausgeführt wurden, bis einer von ihnen gestartet oder gestoppt wurde.135Wenn Sie sich verbinden, zeigt das Gerät alle Subagenten und Workflows an, die die Sitzung bereits im Hintergrund ausführt. Vor v2.1.208 zeigte ein Gerät, das sich mit einer in einem interaktiven Terminal gehosteten Sitzung verbindet, keine Subagenten und Workflows an, die bereits ausgeführt wurden, bis einer von ihnen gestartet oder gestoppt wurde.

136 136

137Der Titel der Remote-Sitzung wird in dieser Reihenfolge gewählt:137Der Titel der Remote-Sitzung wird in dieser Reihenfolge gewählt:

138 138

1413. Die letzte aussagekräftige Nachricht im vorhandenen Gesprächsverlauf1413. Die letzte aussagekräftige Nachricht im vorhandenen Gesprächsverlauf

1424. Ein automatisch generierter Name wie `myhost-graceful-unicorn`, wobei `myhost` der Hostname Ihres Computers oder das Präfix ist, das Sie mit `--remote-control-session-name-prefix` festgelegt haben1424. Ein automatisch generierter Name wie `myhost-graceful-unicorn`, wobei `myhost` der Hostname Ihres Computers oder das Präfix ist, das Sie mit `--remote-control-session-name-prefix` festgelegt haben

143 143

144Wenn Sie keinen expliziten Namen festgelegt haben, wird der Titel aktualisiert, um Ihre Eingabeaufforderung widerzuspiegeln, sobald Sie eine senden. {/* min-version: 2.1.176 */}Ab Claude Code v2.1.176 entsprechen automatisch generierte Titel der Sprache Ihres Gesprächs oder der [`language`](/de/settings#available-settings)-Einstellung, falls eine konfiguriert ist. Das Umbenennen einer Sitzung von claude.ai oder der Claude-App aktualisiert auch den lokalen Titel, der in `claude --resume` angezeigt wird.144Wenn Sie keinen expliziten Namen festgelegt haben, wird der Titel aktualisiert, um Ihre Eingabeaufforderung widerzuspiegeln, sobald Sie eine senden. Ab Claude Code v2.1.176 entsprechen automatisch generierte Titel der Sprache Ihres Gesprächs oder der [`language`](/docs/de/settings#available-settings)-Einstellung, falls eine konfiguriert ist. Das Umbenennen einer Sitzung von claude.ai oder der Claude-App aktualisiert auch den lokalen Titel, der in `claude --resume` angezeigt wird.

145 145

146Wenn die Umgebung bereits eine aktive Sitzung hat, werden Sie gefragt, ob Sie diese fortsetzen oder eine neue starten möchten.146Wenn die Umgebung bereits eine aktive Sitzung hat, werden Sie gefragt, ob Sie diese fortsetzen oder eine neue starten möchten.

147 147

151 Aktivieren Sie Remote Control für alle Sitzungen151 Aktivieren Sie Remote Control für alle Sitzungen

152</h3>152</h3>

153 153

154Remote Control wird nur aktiviert, wenn Sie explizit `claude remote-control`, `claude --remote-control` oder `/remote-control` ausführen, es sei denn, die automatische Verbindung ist aktiviert. Um es automatisch für jede interaktive Sitzung zu aktivieren, führen Sie `/config` in Claude Code aus und setzen Sie **Enable Remote Control for all sessions** auf `true`. Setzen Sie es auf `false`, um es nie automatisch zu verbinden, oder lassen Sie es ungesetzt, um dem Standard Ihrer Organisation zu folgen. In der Desktop-App können Sie dies auch unter **Einstellungen → Claude Code → Enable remote control by default** umschalten. {/* min-version: 2.1.203 */}In der [VS Code-Erweiterung](/de/vs-code#use-the-prompt-box) wird derselbe Schalter als **Enable Remote Control for all sessions** im Abschnitt „Einstellungen" des Befehlsmenüs angezeigt; erfordert Claude Code v2.1.203 oder später.154Remote Control wird nur aktiviert, wenn Sie explizit `claude remote-control`, `claude --remote-control` oder `/remote-control` ausführen, es sei denn, die automatische Verbindung ist aktiviert. Um es automatisch für jede interaktive Sitzung zu aktivieren, führen Sie `/config` in Claude Code aus und setzen Sie **Enable Remote Control for all sessions** auf `true`. Setzen Sie es auf `false`, um es nie automatisch zu verbinden, oder lassen Sie es ungesetzt, um dem Standard Ihrer Organisation zu folgen. In der Desktop-App können Sie dies auch unter **Einstellungen → Claude Code → Enable remote control by default** umschalten. In der [VS Code-Erweiterung](/docs/de/vs-code#use-the-prompt-box) wird derselbe Schalter als **Enable Remote Control for all sessions** im Abschnitt „Einstellungen" des Befehlsmenüs angezeigt; erfordert Claude Code v2.1.203 oder später.

155 155

156Mit dieser Einstellung registriert jeder interaktive Claude Code-Prozess eine Remote-Sitzung. Wenn Sie mehrere Instanzen ausführen, erhält jede ihre eigene Umgebung und Sitzung. Um mehrere gleichzeitige Sitzungen aus einem einzelnen Prozess auszuführen, verwenden Sie stattdessen den [Server-Modus](#start-a-remote-control-session).156Mit dieser Einstellung registriert jeder interaktive Claude Code-Prozess eine Remote-Sitzung. Wenn Sie mehrere Instanzen ausführen, erhält jede ihre eigene Umgebung und Sitzung. Um mehrere gleichzeitige Sitzungen aus einem einzelnen Prozess auszuführen, verwenden Sie stattdessen den [Server-Modus](#start-a-remote-control-session).

157 157

163 163

164Der gesamte Datenverkehr verläuft über die Anthropic-API über TLS, die gleiche Transportsicherheit wie jede Claude Code-Sitzung. Die Verbindung verwendet mehrere kurzlebige Anmeldeinformationen, die jeweils auf einen einzelnen Zweck beschränkt sind und unabhängig ablaufen.164Der gesamte Datenverkehr verläuft über die Anthropic-API über TLS, die gleiche Transportsicherheit wie jede Claude Code-Sitzung. Die Verbindung verwendet mehrere kurzlebige Anmeldeinformationen, die jeweils auf einen einzelnen Zweck beschränkt sind und unabhängig ablaufen.

165 165

166Während Remote Control verbunden ist, werden das Sitzungstranskript, einschließlich Ihrer Nachrichten, Claudes Antworten und Werkzeugaktivität, auf Anthropic-Servern gespeichert. Das gespeicherte Transkript hält die Konversation auf Ihren Geräten synchron und ermöglicht es der Sitzung, sich nach einem Netzwerkausfall erneut zu verbinden. Ausführung und Dateisystemzugriff bleiben auf Ihrem Computer, und gespeicherte Transkripte werden gemäß der [Datenutzungsrichtlinie](/de/data-usage) beibehalten.166Während Remote Control verbunden ist, werden das Sitzungstranskript, einschließlich Ihrer Nachrichten, Claudes Antworten und Werkzeugaktivität, auf Anthropic-Servern gespeichert. Das gespeicherte Transkript hält die Konversation auf Ihren Geräten synchron und ermöglicht es der Sitzung, sich nach einem Netzwerkausfall erneut zu verbinden. Ausführung und Dateisystemzugriff bleiben auf Ihrem Computer, und gespeicherte Transkripte werden gemäß der [Datenutzungsrichtlinie](/docs/de/data-usage) beibehalten.

167 167

168Um Remote Control vollständig auszuschalten, verwenden Sie die Einstellung [`disableRemoteControl`](/de/settings#available-settings). Organisationen mit Compliance-Anforderungen wie Zero Data Retention können Remote Control nicht aktivieren.168Um Remote Control vollständig auszuschalten, verwenden Sie die Einstellung [`disableRemoteControl`](/docs/de/settings#available-settings). Organisationen mit Compliance-Anforderungen wie Zero Data Retention können Remote Control nicht aktivieren.

169 169

170<h2 id="trusted-devices">170<h2 id="trusted-devices">

171 Vertrauenswürdige Geräte171 Vertrauenswürdige Geräte

234 Remote Control vs. Claude Code im Web234 Remote Control vs. Claude Code im Web

235</h2>235</h2>

236 236

237Remote Control und [Claude Code im Web](/de/claude-code-on-the-web) verwenden beide die Schnittstelle claude.ai/code. Der Hauptunterschied liegt darin, wo die Sitzung ausgeführt wird: Remote Control wird auf Ihrem Computer ausgeführt, sodass Ihre lokalen MCP servers, Tools und Projektkonfiguration verfügbar bleiben. Claude Code im Web wird in von Anthropic verwalteter Cloud-Infrastruktur ausgeführt.237Remote Control und [Claude Code im Web](/docs/de/claude-code-on-the-web) verwenden beide die Schnittstelle claude.ai/code. Der Hauptunterschied liegt darin, wo die Sitzung ausgeführt wird: Remote Control wird auf Ihrem Computer ausgeführt, sodass Ihre lokalen MCP servers, Tools und Projektkonfiguration verfügbar bleiben. Claude Code im Web wird in von Anthropic verwalteter Cloud-Infrastruktur ausgeführt.

238 238

239Verwenden Sie Remote Control, wenn Sie sich mitten in lokaler Arbeit befinden und von einem anderen Gerät aus weitermachen möchten. Verwenden Sie Claude Code im Web, wenn Sie eine Aufgabe ohne lokale Einrichtung starten möchten, an einem Repository arbeiten, das Sie nicht geklont haben, oder mehrere Aufgaben parallel ausführen möchten.239Verwenden Sie Remote Control, wenn Sie sich mitten in lokaler Arbeit befinden und von einem anderen Gerät aus weitermachen möchten. Verwenden Sie Claude Code im Web, wenn Sie eine Aufgabe ohne lokale Einrichtung starten möchten, an einem Repository arbeiten, das Sie nicht geklont haben, oder mehrere Aufgaben parallel ausführen möchten.

240 240

272* Auf iOS können Focus-Modi und Benachrichtigungszusammenfassungen Push-Benachrichtigungen unterdrücken oder verzögern. Überprüfen Sie Einstellungen → Benachrichtigungen → Claude.272* Auf iOS können Focus-Modi und Benachrichtigungszusammenfassungen Push-Benachrichtigungen unterdrücken oder verzögern. Überprüfen Sie Einstellungen → Benachrichtigungen → Claude.

273* Auf Android kann aggressive Batterieoptimierung die Zustellung verzögern. Befreien Sie die Claude-App von der Batterieoptimierung in den Systemeinstellungen.273* Auf Android kann aggressive Batterieoptimierung die Zustellung verzögern. Befreien Sie die Claude-App von der Batterieoptimierung in den Systemeinstellungen.

274 274

275Claude Code überspringt Mobile Push-Benachrichtigungen, während Sie im verbundenen Terminal tippen oder sich darauf konzentrieren. {/* min-version: 2.1.181 */}Ab v2.1.181 können Sie [`CLAUDE_CLIENT_PRESENCE_FILE`](/de/env-vars) auf einen Markierungsdateipfad setzen, um dies auf jede Zeit auszudehnen, in der Sie sich am Computer befinden, auch in einem anderen Fenster: Benachrichtigungen werden übersprungen, während die Datei vorhanden ist. Konfigurieren Sie einen Bildschirmsperr-Listener oder ein ähnliches Tool, um die Datei zu erstellen, wenn Ihr Bildschirm entsperrt wird, und löschen Sie sie, wenn Ihr Bildschirm gesperrt wird.275Claude Code überspringt Mobile Push-Benachrichtigungen, während Sie im verbundenen Terminal tippen oder sich darauf konzentrieren. Ab v2.1.181 können Sie [`CLAUDE_CLIENT_PRESENCE_FILE`](/docs/de/env-vars) auf einen Markierungsdateipfad setzen, um dies auf jede Zeit auszudehnen, in der Sie sich am Computer befinden, auch in einem anderen Fenster: Benachrichtigungen werden übersprungen, während die Datei vorhanden ist. Konfigurieren Sie einen Bildschirmsperr-Listener oder ein ähnliches Tool, um die Datei zu erstellen, wenn Ihr Bildschirm entsperrt wird, und löschen Sie sie, wenn Ihr Bildschirm gesperrt wird.

276 276

277<h2 id="limitations">277<h2 id="limitations">

278 Einschränkungen278 Einschränkungen

281* **Eine Remote-Sitzung pro interaktivem Prozess**: Außerhalb des Server-Modus unterstützt jede Claude Code-Instanz jeweils eine Remote-Sitzung. Verwenden Sie den [Server-Modus](#start-a-remote-control-session), um mehrere gleichzeitige Sitzungen aus einem einzelnen Prozess auszuführen.281* **Eine Remote-Sitzung pro interaktivem Prozess**: Außerhalb des Server-Modus unterstützt jede Claude Code-Instanz jeweils eine Remote-Sitzung. Verwenden Sie den [Server-Modus](#start-a-remote-control-session), um mehrere gleichzeitige Sitzungen aus einem einzelnen Prozess auszuführen.

282* **Lokaler Prozess muss weiterhin ausgeführt werden**: Remote Control wird als lokaler Prozess ausgeführt. Wenn Sie das Terminal schließen, VS Code beenden oder den `claude`-Prozess anderweitig beenden, endet die Sitzung.282* **Lokaler Prozess muss weiterhin ausgeführt werden**: Remote Control wird als lokaler Prozess ausgeführt. Wenn Sie das Terminal schließen, VS Code beenden oder den `claude`-Prozess anderweitig beenden, endet die Sitzung.

283* **Längerer Netzwerkausfall**: Wenn Ihr Computer aktiv ist, aber länger als etwa 10 Minuten das Netzwerk nicht erreichen kann, läuft die Sitzung ab und der Prozess wird beendet. Führen Sie `claude remote-control` erneut aus, um eine neue Sitzung zu starten.283* **Längerer Netzwerkausfall**: Wenn Ihr Computer aktiv ist, aber länger als etwa 10 Minuten das Netzwerk nicht erreichen kann, läuft die Sitzung ab und der Prozess wird beendet. Führen Sie `claude remote-control` erneut aus, um eine neue Sitzung zu starten.

284* **Ultraplan trennt Remote Control**: Das Starten einer [ultraplan](/de/ultraplan)-Sitzung trennt jede aktive Remote Control-Sitzung, da beide Funktionen die Schnittstelle claude.ai/code belegen und nur eine gleichzeitig verbunden sein kann.284* **Ultraplan trennt Remote Control**: Das Starten einer [ultraplan](/docs/de/ultraplan)-Sitzung trennt jede aktive Remote Control-Sitzung, da beide Funktionen die Schnittstelle claude.ai/code belegen und nur eine gleichzeitig verbunden sein kann.

285* **Einige Befehle sind nur lokal verfügbar**: Befehle, die nur in der Terminal-Schnittstelle ausgeführt werden, wie `/plugin` oder `/resume`, funktionieren nur über die lokale CLI, unabhängig davon, ob Sie ein Argument übergeben oder nicht. Die folgenden funktionieren von mobil und Web aus:285* **Einige Befehle sind nur lokal verfügbar**: Befehle, die nur in der Terminal-Schnittstelle ausgeführt werden, wie `/plugin` oder `/resume`, funktionieren nur über die lokale CLI, unabhängig davon, ob Sie ein Argument übergeben oder nicht. Die folgenden funktionieren von mobil und Web aus:

286 * Textausgabe-Befehle: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits` (führt die Textform aus, anstatt den Dialog in der CLI zu öffnen), `/recap`, `/reload-plugins`286 * Textausgabe-Befehle: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits` (führt die Textform aus, anstatt den Dialog in der CLI zu öffnen), `/recap`, `/reload-plugins`

287 * `/model`, `/effort`, `/fast`, `/color` und `/rename`: übergeben Sie den Wert als Argument, zum Beispiel `/model sonnet` oder `/effort high`. Von mobil und Web aus akzeptieren `/model` und `/effort` das Argument anstelle der Terminal-Auswahl oder des Schiebereglers.287 * `/model`, `/effort`, `/fast`, `/color` und `/rename`: übergeben Sie den Wert als Argument, zum Beispiel `/model sonnet` oder `/effort high`. Von mobil und Web aus akzeptieren `/model` und `/effort` das Argument anstelle der Terminal-Auswahl oder des Schiebereglers.

288 * {/* min-version: 2.1.166 */}`/mcp`, ab v2.1.166: gibt die mobile App eine Textzusammenfassung des Server-Status zurück, anstatt die Auswahl zu öffnen. Im Web öffnet `/mcp` allein ein Verzeichnis von [claude.ai-Konnektoren](/de/mcp#use-mcp-servers-from-claude-ai), anstatt die Zusammenfassung zurückzugeben. Die `reconnect`-, `enable`- und `disable`-[Unterbefehle](/de/commands#all-commands) funktionieren von beiden aus. Im Gegensatz zur lokalen CLI verbindet `/mcp reconnect` ohne Servernamen jeden Server wieder, der fehlgeschlagen ist oder eine Authentifizierung benötigt.288 * `/mcp`, ab v2.1.166: gibt die mobile App eine Textzusammenfassung des Server-Status zurück, anstatt die Auswahl zu öffnen. Im Web öffnet `/mcp` allein ein Verzeichnis von [claude.ai-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai), anstatt die Zusammenfassung zurückzugeben. Die `reconnect`-, `enable`- und `disable`-[Unterbefehle](/docs/de/commands#all-commands) funktionieren von beiden aus. Im Gegensatz zur lokalen CLI verbindet `/mcp reconnect` ohne Servernamen jeden Server wieder, der fehlgeschlagen ist oder eine Authentifizierung benötigt.

289 * {/* min-version: 2.1.181 */}`/config`, ab v2.1.181: übergeben Sie von der mobilen App aus `key=value`, um eine Einstellung festzulegen, oder führen Sie es ohne Argument aus, um die Schlüssel aufzulisten, die Sie festlegen können. Im Web öffnet `/config` stattdessen den Claude Code-Bereich Ihrer Einstellungen und ignoriert Text nach dem Befehl.289 * `/config`, ab v2.1.181: übergeben Sie von der mobilen App aus `key=value`, um eine Einstellung festzulegen, oder führen Sie es ohne Argument aus, um die Schlüssel aufzulisten, die Sie festlegen können. Im Web öffnet `/config` stattdessen den Claude Code-Bereich Ihrer Einstellungen und ignoriert Text nach dem Befehl.

290 290

291<h2 id="troubleshooting">291<h2 id="troubleshooting">

292 Fehlerbehebung292 Fehlerbehebung

298 298

299Sie sind nicht mit einem claude.ai-Konto authentifiziert. Führen Sie `claude auth login` aus und wählen Sie die claude.ai-Option. Wenn `ANTHROPIC_API_KEY` in Ihrer Umgebung festgelegt ist, heben Sie die Festlegung zuerst auf.299Sie sind nicht mit einem claude.ai-Konto authentifiziert. Führen Sie `claude auth login` aus und wählen Sie die claude.ai-Option. Wenn `ANTHROPIC_API_KEY` in Ihrer Umgebung festgelegt ist, heben Sie die Festlegung zuerst auf.

300 300

301{/* min-version: 2.1.206 */}Vor v2.1.206 meldete das Ausführen von `/remote-control` während der Abmeldung `Unknown command: /remote-control` statt dieser Meldung.301Vor v2.1.206 meldete das Ausführen von `/remote-control` während der Abmeldung `Unknown command: /remote-control` statt dieser Meldung.

302 302

303<h3 id="remote-control-requires-a-full-scope-login-token">303<h3 id="remote-control-requires-a-full-scope-login-token">

304 „Remote Control erfordert ein Token mit vollständigem Umfang"304 „Remote Control erfordert ein Token mit vollständigem Umfang"

328 „Remote Control ist nur verfügbar, wenn Sie Claude über api.anthropic.com verwenden"328 „Remote Control ist nur verfügbar, wenn Sie Claude über api.anthropic.com verwenden"

329</h3>329</h3>

330 330

331Die Sitzung kommuniziert nicht direkt mit der Anthropic-API, daher gibt es kein claude.ai-Backend zum Koppeln. Dies geschieht auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry. {/* min-version: 2.1.196 */}Ab v2.1.196 geschieht dies auch, wenn [`ANTHROPIC_BASE_URL`](/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. ein [LLM-Gateway](/de/llm-gateway) oder Proxy, auch wenn Sie sich mit claude.ai anmelden. Heben Sie `ANTHROPIC_BASE_URL` auf und starten Sie die Sitzung neu, um Remote Control zu verwenden.331Die Sitzung kommuniziert nicht direkt mit der Anthropic-API, daher gibt es kein claude.ai-Backend zum Koppeln. Dies geschieht auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry. Ab v2.1.196 geschieht dies auch, wenn [`ANTHROPIC_BASE_URL`](/docs/de/env-vars) auf einen anderen Host als `api.anthropic.com` verweist, z. B. ein [LLM-Gateway](/docs/de/llm-gateway) oder Proxy, auch wenn Sie sich mit claude.ai anmelden. Heben Sie `ANTHROPIC_BASE_URL` auf und starten Sie die Sitzung neu, um Remote Control zu verwenden.

332 332

333<h3 id="remote-control-is-disabled-by-your-organization’s-policy">333<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

334 „Remote Control ist durch die Richtlinie Ihrer Organisation deaktiviert"334 „Remote Control ist durch die Richtlinie Ihrer Organisation deaktiviert"

339* **Sie sind mit einem API-Schlüssel oder Console-Konto authentifiziert**: Remote Control erfordert claude.ai OAuth. Führen Sie `/login` aus und wählen Sie die claude.ai-Option. Wenn `ANTHROPIC_API_KEY` in Ihrer Umgebung festgelegt ist, heben Sie die Festlegung auf.339* **Sie sind mit einem API-Schlüssel oder Console-Konto authentifiziert**: Remote Control erfordert claude.ai OAuth. Führen Sie `/login` aus und wählen Sie die claude.ai-Option. Wenn `ANTHROPIC_API_KEY` in Ihrer Umgebung festgelegt ist, heben Sie die Festlegung auf.

340* **Ein Inhaber hat es für Ihre Organisation nicht aktiviert**: Remote Control ist standardmäßig in Team- und Enterprise-Plänen deaktiviert. Ein Inhaber kann es unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) aktivieren, indem er den Schalter **Remote Control** einschaltet. Dieser Schalter ist eine serverseitige Organisationseinstellung.340* **Ein Inhaber hat es für Ihre Organisation nicht aktiviert**: Remote Control ist standardmäßig in Team- und Enterprise-Plänen deaktiviert. Ein Inhaber kann es unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) aktivieren, indem er den Schalter **Remote Control** einschaltet. Dieser Schalter ist eine serverseitige Organisationseinstellung.

341* **Der Admin-Schalter ist ausgegraut**: Ihre Organisation hat eine Datenspeicherungs- oder Compliance-Konfiguration, die mit Remote Control nicht kompatibel ist. Dies kann nicht über das Admin-Panel geändert werden. Kontaktieren Sie den Anthropic-Support, um Optionen zu besprechen.341* **Der Admin-Schalter ist ausgegraut**: Ihre Organisation hat eine Datenspeicherungs- oder Compliance-Konfiguration, die mit Remote Control nicht kompatibel ist. Dies kann nicht über das Admin-Panel geändert werden. Kontaktieren Sie den Anthropic-Support, um Optionen zu besprechen.

342* **Der Fehler erwähnt `disableRemoteControl`**: Ihr IT-Administrator hat Remote Control auf diesem Gerät über [verwaltete Einstellungen](/de/settings#settings-files) deaktiviert, unabhängig vom organisationsweiten Schalter.342* **Der Fehler erwähnt `disableRemoteControl`**: Ihr IT-Administrator hat Remote Control auf diesem Gerät über [verwaltete Einstellungen](/docs/de/settings#settings-files) deaktiviert, unabhängig vom organisationsweiten Schalter.

343 343

344<h3 id="remote-credentials-fetch-failed">344<h3 id="remote-credentials-fetch-failed">

345 „Remote credentials fetch failed"345 „Remote credentials fetch failed"

365 365

366Ihre lokale Sitzung läuft ohne Remote Control weiter. Führen Sie `/remote-control` aus, um die Verbindung erneut zu versuchen, oder starten Sie Claude Code ohne `--resume`, um eine neue Remote Control-Sitzung zu erstellen.366Ihre lokale Sitzung läuft ohne Remote Control weiter. Führen Sie `/remote-control` aus, um die Verbindung erneut zu versuchen, oder starten Sie Claude Code ohne `--resume`, um eine neue Remote Control-Sitzung zu erstellen.

367 367

368{/* min-version: 2.1.200 */}Vor v2.1.200 hat ein Wiederverbindungsfehler eine neue Remote Control-Sitzung erstellt, anstatt diese Meldung anzuzeigen, was zusätzliche Sitzungen in der Sitzungsliste unter claude.ai/code hinterlassen hat.368Vor v2.1.200 hat ein Wiederverbindungsfehler eine neue Remote Control-Sitzung erstellt, anstatt diese Meldung anzuzeigen, was zusätzliche Sitzungen in der Sitzungsliste unter claude.ai/code hinterlassen hat.

369 369

370<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">370<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">

371 „Ihre Organisation erfordert vertrauenswürdige Geräte für Remote Control, aber dieses Gerät ist nicht registriert"371 „Ihre Organisation erfordert vertrauenswürdige Geräte für Remote Control, aber dieses Gerät ist nicht registriert"

387 387

389| :--------------------------------------------- | :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ |389| :--------------------------------------------- | :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ |

392| [Channels](/en/channels) | Push events from a chat app like Telegram or Discord, or your own server | Your machine (CLI) | [Install a channel plugin](/en/channels#quickstart) or [build your own](/en/channels-reference) | Reacting to external events like CI failures or chat messages |392| [Channels](/docs/en/channels) | Push events from a chat app like Telegram or Discord, or your own server | Your machine (CLI) | [Install a channel plugin](/docs/en/channels#quickstart) or [build your own](/docs/en/channels-reference) | Reacting to external events like CI failures or chat messages |

395 395

396<h2 id="related-resources">396<h2 id="related-resources">

397 Verwandte Ressourcen397 Verwandte Ressourcen

398</h2>398</h2>

399 399

400* [Claude Code im Web](/de/claude-code-on-the-web): Führen Sie Sitzungen in von Anthropic verwalteten Cloud-Umgebungen aus, anstatt auf Ihrem Computer400* [Claude Code im Web](/docs/de/claude-code-on-the-web): Führen Sie Sitzungen in von Anthropic verwalteten Cloud-Umgebungen aus, anstatt auf Ihrem Computer

401* [Ultraplan](/de/ultraplan): Starten Sie eine Cloud-Planungssitzung von Ihrem Terminal aus und überprüfen Sie den Plan in Ihrem Browser401* [Ultraplan](/docs/de/ultraplan): Starten Sie eine Cloud-Planungssitzung von Ihrem Terminal aus und überprüfen Sie den Plan in Ihrem Browser

402* [Kanäle](/de/channels): Leiten Sie Telegram, Discord oder iMessage in eine Sitzung weiter, damit Claude auf Nachrichten reagiert, während Sie weg sind402* [Kanäle](/docs/de/channels): Leiten Sie Telegram, Discord oder iMessage in eine Sitzung weiter, damit Claude auf Nachrichten reagiert, während Sie weg sind

403* [Dispatch](/de/desktop#sessions-from-dispatch): Senden Sie eine Aufgabe von Ihrem Telefon aus, und sie kann eine Desktop-Sitzung spawnen, um sie zu bearbeiten403* [Dispatch](/docs/de/desktop#sessions-from-dispatch): Senden Sie eine Aufgabe von Ihrem Telefon aus, und sie kann eine Desktop-Sitzung spawnen, um sie zu bearbeiten

404* [Authentifizierung](/de/authentication): Richten Sie `/login` ein und verwalten Sie Anmeldeinformationen für claude.ai404* [Authentifizierung](/docs/de/authentication): Richten Sie `/login` ein und verwalten Sie Anmeldeinformationen für claude.ai

405* [CLI-Referenz](/de/cli-reference): Vollständige Liste von Flags und Befehlen einschließlich `claude remote-control`405* [CLI-Referenz](/docs/de/cli-reference): Vollständige Liste von Flags und Befehlen einschließlich `claude remote-control`

406* [Sicherheit](/de/security): Wie Remote Control-Sitzungen in das Claude Code-Sicherheitsmodell passen406* [Sicherheit](/docs/de/security): Wie Remote Control-Sitzungen in das Claude Code-Sicherheitsmodell passen

407* [Datennutzung](/de/data-usage): Welche Daten während lokaler und Remote-Sitzungen durch die Anthropic-API fließen407* [Datennutzung](/docs/de/data-usage): Welche Daten während lokaler und Remote-Sitzungen durch die Anthropic-API fließen

sandboxing.md +44 −44

Details

9Die Bash-Sandbox ermöglicht es Claude, die meisten Shell-Befehle auszuführen, ohne um Genehmigung zu fragen. Anstatt jeden Befehl zu genehmigen, definieren Sie, welche Dateien und Netzwerk-Domains Befehle berühren können, und das Betriebssystem erzwingt diese Grenze für jeden Bash-Befehl und seine Kindprozesse.9Die Bash-Sandbox ermöglicht es Claude, die meisten Shell-Befehle auszuführen, ohne um Genehmigung zu fragen. Anstatt jeden Befehl zu genehmigen, definieren Sie, welche Dateien und Netzwerk-Domains Befehle berühren können, und das Betriebssystem erzwingt diese Grenze für jeden Bash-Befehl und seine Kindprozesse.

10 10

11<Note>11<Note>

12 Um andere Isolationsansätze wie Dev-Container, benutzerdefinierte Container und virtuelle Maschinen zu vergleichen, siehe [Sandbox-Umgebungen](/de/sandbox-environments). Um Genehmigungseingaben für Tools außer Bash zu reduzieren, siehe [Genehmigungsmodi](/de/permission-modes).12 Um andere Isolationsansätze wie Dev-Container, benutzerdefinierte Container und virtuelle Maschinen zu vergleichen, siehe [Sandbox-Umgebungen](/docs/de/sandbox-environments). Um Genehmigungseingaben für Tools außer Bash zu reduzieren, siehe [Genehmigungsmodi](/docs/de/permission-modes).

13</Note>13</Note>

14 14

15<h2 id="get-started">15<h2 id="get-started">

31 Dies öffnet das Sandbox-Panel mit drei Registerkarten:31 Dies öffnet das Sandbox-Panel mit drei Registerkarten:

32 32

33 * **Mode**: Wählen Sie, wie Sandbox-Befehle genehmigt werden, behandelt im nächsten Schritt33 * **Mode**: Wählen Sie, wie Sandbox-Befehle genehmigt werden, behandelt im nächsten Schritt

34 * **Overrides**: Wählen Sie, ob Befehle, die unter der Sandbox fehlschlagen, auf unsandboxed ausweichen können. Dies ist die Einstellung [`allowUnsandboxedCommands`](/de/settings#sandbox-settings)34 * **Overrides**: Wählen Sie, ob Befehle, die unter der Sandbox fehlschlagen, auf unsandboxed ausweichen können. Dies ist die Einstellung [`allowUnsandboxedCommands`](/docs/de/settings#sandbox-settings)

35 * **Config**: Zeigen Sie die aufgelösten Sandbox-Einstellungen an35 * **Config**: Zeigen Sie die aufgelösten Sandbox-Einstellungen an

36 36

37 Wenn das Panel nur eine Registerkarte 'Dependencies" anzeigt, fehlt ein erforderliches Paket. Installieren Sie es wie in [Linux und WSL2 einrichten](#set-up-linux-and-wsl2) beschrieben, starten Sie Claude Code neu und führen Sie `/sandbox` erneut aus.37 Wenn das Panel nur eine Registerkarte 'Dependencies" anzeigt, fehlt ein erforderliches Paket. Installieren Sie es wie in [Linux und WSL2 einrichten](#set-up-linux-and-wsl2) beschrieben, starten Sie Claude Code neu und führen Sie `/sandbox` erneut aus.

48 </Step>48 </Step>

49</Steps>49</Steps>

50 50

51Wenn Sie einen Modus im Panel auswählen, wird in die lokalen Einstellungen Ihres Projekts unter `.claude/settings.local.json` geschrieben, die für das aktuelle Projekt gelten und nicht in Git eingecheckt werden. Um die Sandbox in allen Ihren Projekten zu aktivieren, setzen Sie [`sandbox.enabled`](/de/settings#sandbox-settings) auf `true` in Ihren Benutzereinstellungen unter `~/.claude/settings.json`. Um Sandboxing für jeden Entwickler in einer Organisation zu erzwingen, verwenden Sie [verwaltete Einstellungen](#enforce-sandboxing-with-managed-settings).51Wenn Sie einen Modus im Panel auswählen, wird in die lokalen Einstellungen Ihres Projekts unter `.claude/settings.local.json` geschrieben, die für das aktuelle Projekt gelten und nicht in Git eingecheckt werden. Um die Sandbox in allen Ihren Projekten zu aktivieren, setzen Sie [`sandbox.enabled`](/docs/de/settings#sandbox-settings) auf `true` in Ihren Benutzereinstellungen unter `~/.claude/settings.json`. Um Sandboxing für jeden Entwickler in einer Organisation zu erzwingen, verwenden Sie [verwaltete Einstellungen](#enforce-sandboxing-with-managed-settings).

52 52

53<Warning>53<Warning>

54 Standardmäßig zeigt Claude Code eine Warnung an und führt Befehle ohne Sandboxing aus, wenn die Sandbox nicht gestartet werden kann, da Abhängigkeiten fehlen oder die Plattform nicht unterstützt wird. Um dies stattdessen zu einem Hard Failure zu machen, setzen Sie [`sandbox.failIfUnavailable`](/de/settings#sandbox-settings) auf `true`. Dies ist für verwaltete Bereitstellungen vorgesehen, die Sandboxing als Sicherheits-Gate erfordern.54 Standardmäßig zeigt Claude Code eine Warnung an und führt Befehle ohne Sandboxing aus, wenn die Sandbox nicht gestartet werden kann, da Abhängigkeiten fehlen oder die Plattform nicht unterstützt wird. Um dies stattdessen zu einem Hard Failure zu machen, setzen Sie [`sandbox.failIfUnavailable`](/docs/de/settings#sandbox-settings) auf `true`. Dies ist für verwaltete Bereitstellungen vorgesehen, die Sandboxing als Sicherheits-Gate erfordern.

55</Warning>55</Warning>

56 56

57<h3 id="set-up-linux-and-wsl2">57<h3 id="set-up-linux-and-wsl2">

111 <Accordion title="WSL2-Hinweise">111 <Accordion title="WSL2-Hinweise">

112 Überprüfen Sie Ihre WSL-Version mit `wsl -l -v` aus PowerShell. Wenn Sie `Sandboxing requires WSL2` sehen, läuft Ihre Distribution auf WSL1. Aktualisieren Sie sie auf WSL2 oder führen Sie Claude Code ohne Sandboxing aus.112 Überprüfen Sie Ihre WSL-Version mit `wsl -l -v` aus PowerShell. Wenn Sie `Sandboxing requires WSL2` sehen, läuft Ihre Distribution auf WSL1. Aktualisieren Sie sie auf WSL2 oder führen Sie Claude Code ohne Sandboxing aus.

113 113

114 Auf WSL2 können Sandbox-Befehle keine Windows-Binärdateien wie `cmd.exe`, `powershell.exe` oder etwas unter `/mnt/c/` starten. WSL übergibt diese über einen Unix-Socket an den Windows-Host, den die Sandbox blockiert. Wenn ein Befehl eine Windows-Binärdatei aufrufen muss, fügen Sie ihn zu [`excludedCommands`](/de/settings#sandbox-settings) hinzu, damit er außerhalb der Sandbox ausgeführt wird.114 Auf WSL2 können Sandbox-Befehle keine Windows-Binärdateien wie `cmd.exe`, `powershell.exe` oder etwas unter `/mnt/c/` starten. WSL übergibt diese über einen Unix-Socket an den Windows-Host, den die Sandbox blockiert. Wenn ein Befehl eine Windows-Binärdatei aufrufen muss, fügen Sie ihn zu [`excludedCommands`](/docs/de/settings#sandbox-settings) hinzu, damit er außerhalb der Sandbox ausgeführt wird.

115 </Accordion>115 </Accordion>

116</AccordionGroup>116</AccordionGroup>

117 117

121 121

122Claude Code bietet zwei Sandbox-Modi:122Claude Code bietet zwei Sandbox-Modi:

123 123

124**Auto-Allow-Modus**: Bash-Befehle werden versuchen, in der Sandbox ausgeführt zu werden und sind automatisch zulässig, ohne dass eine Genehmigung erforderlich ist. Befehle, die nicht in der Sandbox ausgeführt werden können, z. B. solche, die Netzwerkzugriff auf nicht zulässige Hosts benötigen, fallen auf den regulären Genehmigungsfluss zurück, bei dem Claude Code Ihre [Genehmigungsregeln](/de/permissions) überprüft und Sie für jeden Befehl auffordert, den diese Regeln nicht bereits zulassen, mit einer Eingabeaufforderung im Standardmodus oder dem Klassifizierer im [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode).124**Auto-Allow-Modus**: Bash-Befehle werden versuchen, in der Sandbox ausgeführt zu werden und sind automatisch zulässig, ohne dass eine Genehmigung erforderlich ist. Befehle, die nicht in der Sandbox ausgeführt werden können, z. B. solche, die Netzwerkzugriff auf nicht zulässige Hosts benötigen, fallen auf den regulären Genehmigungsfluss zurück, bei dem Claude Code Ihre [Genehmigungsregeln](/docs/de/permissions) überprüft und Sie für jeden Befehl auffordert, den diese Regeln nicht bereits zulassen, mit einer Eingabeaufforderung im Standardmodus oder dem Klassifizierer im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode).

125 125

126Selbst im Auto-Allow-Modus gelten folgende Punkte:126Selbst im Auto-Allow-Modus gelten folgende Punkte:

127 127

128* Explizite [Deny-Regeln](/de/permissions) werden immer respektiert128* Explizite [Deny-Regeln](/docs/de/permissions) werden immer respektiert

129* `rm`- oder `rmdir`-Befehle, die auf `/`, Ihr Home-Verzeichnis oder andere kritische Systempfade abzielen, lösen immer noch eine Genehmigungseingabe aus129* `rm`- oder `rmdir`-Befehle, die auf `/`, Ihr Home-Verzeichnis oder andere kritische Systempfade abzielen, lösen immer noch eine Genehmigungseingabe aus

130* Inhaltsgebundene [Ask-Regeln](/de/permissions) wie `Bash(git push *)` erzwingen immer noch eine Eingabeaufforderung, auch für Sandbox-Befehle130* Inhaltsgebundene [Ask-Regeln](/docs/de/permissions) wie `Bash(git push *)` erzwingen immer noch eine Eingabeaufforderung, auch für Sandbox-Befehle

131* Eine einfache `Bash` Ask-Regel oder die entsprechende `Bash(*)` Form wird für Befehle übersprungen, die in der Sandbox ausgeführt werden; sie gilt immer noch für Befehle, die auf den regulären Genehmigungsfluss zurückfallen131* Eine einfache `Bash` Ask-Regel oder die entsprechende `Bash(*)` Form wird für Befehle übersprungen, die in der Sandbox ausgeführt werden; sie gilt immer noch für Befehle, die auf den regulären Genehmigungsfluss zurückfallen

132 132

133**Regulärer Genehmigungsmodus**: Alle Bash-Befehle durchlaufen den regulären Genehmigungsfluss, auch wenn sie in der Sandbox ausgeführt werden. Dies bietet mehr Kontrolle, erfordert aber mehr Genehmigungen.133**Regulärer Genehmigungsmodus**: Alle Bash-Befehle durchlaufen den regulären Genehmigungsfluss, auch wenn sie in der Sandbox ausgeführt werden. Dies bietet mehr Kontrolle, erfordert aber mehr Genehmigungen.

136 136

137Das Sitzungs-Temp-Verzeichnis ist standardmäßig in der Sandbox beschreibbar, zusammen mit dem Arbeitsverzeichnis. Claude Code setzt `$TMPDIR` auf dieses Verzeichnis für Sandbox-Befehle, sodass Tools, die temporäre Dateien schreiben, ohne zusätzliche Konfiguration funktionieren. Unsandboxed-Befehle erben Ihr Shell-`$TMPDIR` unverändert, was bedeutet, dass Sandbox- und Unsandboxed-Befehle `$TMPDIR` in verschiedene Verzeichnisse auflösen. Um temporäre Dateien zwischen den beiden zu übergeben, schreiben Sie sie stattdessen unter das Arbeitsverzeichnis.137Das Sitzungs-Temp-Verzeichnis ist standardmäßig in der Sandbox beschreibbar, zusammen mit dem Arbeitsverzeichnis. Claude Code setzt `$TMPDIR` auf dieses Verzeichnis für Sandbox-Befehle, sodass Tools, die temporäre Dateien schreiben, ohne zusätzliche Konfiguration funktionieren. Unsandboxed-Befehle erben Ihr Shell-`$TMPDIR` unverändert, was bedeutet, dass Sandbox- und Unsandboxed-Befehle `$TMPDIR` in verschiedene Verzeichnisse auflösen. Um temporäre Dateien zwischen den beiden zu übergeben, schreiben Sie sie stattdessen unter das Arbeitsverzeichnis.

138 138

139Einige Befehle können überhaupt nicht in der Sandbox ausgeführt werden, z. B. Tools, die nicht kompatibel sind oder einen Host benötigen, den Sie nicht zulässig gemacht haben. Anstatt die Aufgabe fehlschlagen zu lassen oder Sie zu zwingen, Sandboxing auszuschalten, enthält Claude Code eine Fluchtluke: Wenn ein Befehl aufgrund von Sandbox-Einschränkungen fehlschlägt, analysiert Claude den Fehler und kann den Befehl mit dem Parameter `dangerouslyDisableSandbox` erneut versuchen. Der erneut versuchte Befehl läuft außerhalb der Sandbox, daher durchläuft er den regulären Genehmigungsfluss: Im Standardmodus erhalten Sie eine Bestätigungseingabe; im [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) bewertet der Klassifizierer den zugrunde liegenden Befehl, anstatt Sie aufzufordern. Um auch im Auto-Modus bei jedem unsandboxed-Wiederversuch aufgefordert zu werden, fügen Sie eine [Ask-Regel](/de/permissions#match-by-input-parameter) für `Bash(dangerouslyDisableSandbox:true)` hinzu.139Einige Befehle können überhaupt nicht in der Sandbox ausgeführt werden, z. B. Tools, die nicht kompatibel sind oder einen Host benötigen, den Sie nicht zulässig gemacht haben. Anstatt die Aufgabe fehlschlagen zu lassen oder Sie zu zwingen, Sandboxing auszuschalten, enthält Claude Code eine Fluchtluke: Wenn ein Befehl aufgrund von Sandbox-Einschränkungen fehlschlägt, analysiert Claude den Fehler und kann den Befehl mit dem Parameter `dangerouslyDisableSandbox` erneut versuchen. Der erneut versuchte Befehl läuft außerhalb der Sandbox, daher durchläuft er den regulären Genehmigungsfluss: Im Standardmodus erhalten Sie eine Bestätigungseingabe; im [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) bewertet der Klassifizierer den zugrunde liegenden Befehl, anstatt Sie aufzufordern. Um auch im Auto-Modus bei jedem unsandboxed-Wiederversuch aufgefordert zu werden, fügen Sie eine [Ask-Regel](/docs/de/permissions#match-by-input-parameter) für `Bash(dangerouslyDisableSandbox:true)` hinzu.

140 140

141Sie können diese Fluchtluke deaktivieren, indem Sie `"allowUnsandboxedCommands": false` in Ihren [Sandbox-Einstellungen](/de/settings#sandbox-settings) setzen. Wenn deaktiviert, was die Registerkarte `/sandbox` Overrides als **Strict Sandbox Mode** anzeigt, wird der Parameter `dangerouslyDisableSandbox` vollständig ignoriert und alle Befehle müssen in der Sandbox ausgeführt oder explizit in `excludedCommands` aufgelistet werden.141Sie können diese Fluchtluke deaktivieren, indem Sie `"allowUnsandboxedCommands": false` in Ihren [Sandbox-Einstellungen](/docs/de/settings#sandbox-settings) setzen. Wenn deaktiviert, was die Registerkarte `/sandbox` Overrides als **Strict Sandbox Mode** anzeigt, wird der Parameter `dangerouslyDisableSandbox` vollständig ignoriert und alle Befehle müssen in der Sandbox ausgeführt oder explizit in `excludedCommands` aufgelistet werden.

142 142

143<Info>143<Info>

144 Der Auto-Allow-Modus funktioniert unabhängig von Ihrer Genehmigungsmodus-Einstellung. Selbst wenn Sie sich nicht im „Bearbeitungen akzeptieren"-Modus befinden, werden Sandbox-Bash-Befehle automatisch ausgeführt, wenn Auto-Allow aktiviert ist. Dies bedeutet, dass Bash-Befehle, die Dateien innerhalb der Sandbox-Grenzen ändern, ohne Eingabeaufforderung ausgeführt werden, auch wenn Datei-Bearbeitungs-Tools normalerweise eine Genehmigung erfordern würden.144 Der Auto-Allow-Modus funktioniert unabhängig von Ihrer Genehmigungsmodus-Einstellung. Selbst wenn Sie sich nicht im „Bearbeitungen akzeptieren"-Modus befinden, werden Sandbox-Bash-Befehle automatisch ausgeführt, wenn Auto-Allow aktiviert ist. Dies bedeutet, dass Bash-Befehle, die Dateien innerhalb der Sandbox-Grenzen ändern, ohne Eingabeaufforderung ausgeführt werden, auch wenn Datei-Bearbeitungs-Tools normalerweise eine Genehmigung erfordern würden.

148 Sandboxing konfigurieren148 Sandboxing konfigurieren

149</h2>149</h2>

150 150

151Passen Sie das Sandbox-Verhalten durch Ihre `settings.json`-Datei an. Siehe [Einstellungen](/de/settings#sandbox-settings) für die vollständige Konfigurationsreferenz.151Passen Sie das Sandbox-Verhalten durch Ihre `settings.json`-Datei an. Siehe [Einstellungen](/docs/de/settings#sandbox-settings) für die vollständige Konfigurationsreferenz.

152 152

153Standardmäßig können Sandbox-Befehle nur in das aktuelle Arbeitsverzeichnis und das Sitzungs-Temp-Verzeichnis schreiben. Wenn Subprozess-Befehle wie `kubectl`, `terraform` oder `npm` außerhalb dieser Verzeichnisse schreiben müssen, verwenden Sie `sandbox.filesystem.allowWrite`, um Zugriff auf spezifische Pfade zu gewähren:153Standardmäßig können Sandbox-Befehle nur in das aktuelle Arbeitsverzeichnis und das Sitzungs-Temp-Verzeichnis schreiben. Wenn Subprozess-Befehle wie `kubectl`, `terraform` oder `npm` außerhalb dieser Verzeichnisse schreiben müssen, verwenden Sie `sandbox.filesystem.allowWrite`, um Zugriff auf spezifische Pfade zu gewähren:

154 154

165 165

166Diese Pfade werden auf OS-Ebene durchgesetzt, daher respektieren alle Befehle, die in der Sandbox ausgeführt werden, einschließlich ihrer Kindprozesse, diese. Dies ist der empfohlene Ansatz, wenn ein Tool Schreibzugriff auf einen bestimmten Ort benötigt, anstatt das Tool mit `excludedCommands` vollständig aus der Sandbox auszuschließen.166Diese Pfade werden auf OS-Ebene durchgesetzt, daher respektieren alle Befehle, die in der Sandbox ausgeführt werden, einschließlich ihrer Kindprozesse, diese. Dies ist der empfohlene Ansatz, wenn ein Tool Schreibzugriff auf einen bestimmten Ort benötigt, anstatt das Tool mit `excludedCommands` vollständig aus der Sandbox auszuschließen.

167 167

168Wenn das gleiche Dateisystem-Array in mehreren [Einstellungs-Scopes](/de/settings#settings-precedence) definiert ist, werden die Arrays zusammengeführt: Pfade aus jedem Scope werden kombiniert, nicht ersetzt.168Wenn das gleiche Dateisystem-Array in mehreren [Einstellungs-Scopes](/docs/de/settings#settings-precedence) definiert ist, werden die Arrays zusammengeführt: Pfade aus jedem Scope werden kombiniert, nicht ersetzt.

169 169

170Pfad-Präfixe steuern, wie Pfade aufgelöst werden:170Pfad-Präfixe steuern, wie Pfade aufgelöst werden:

171 171

175| `~/` | Relativ zum Home-Verzeichnis | `~/.kube` wird zu `$HOME/.kube` |175| `~/` | Relativ zum Home-Verzeichnis | `~/.kube` wird zu `$HOME/.kube` |

176| `./` oder kein Präfix | Relativ zum Projekt-Root für Projekt-Einstellungen oder zu `~/.claude` für Benutzer-Einstellungen | `./output` in `.claude/settings.json` wird zu `<project-root>/output` |176| `./` oder kein Präfix | Relativ zum Projekt-Root für Projekt-Einstellungen oder zu `~/.claude` für Benutzer-Einstellungen | `./output` in `.claude/settings.json` wird zu `<project-root>/output` |

177 177

178Diese Syntax unterscheidet sich von [Read- und Edit-Genehmigungsregeln](/de/permissions#read-and-edit), die `//path` für absolut und `/path` für projekt-relativ verwenden. Sandbox-Dateisystem-Pfade verwenden Standard-Konventionen: `/tmp/build` ist absolut.178Diese Syntax unterscheidet sich von [Read- und Edit-Genehmigungsregeln](/docs/de/permissions#read-and-edit), die `//path` für absolut und `/path` für projekt-relativ verwenden. Sandbox-Dateisystem-Pfade verwenden Standard-Konventionen: `/tmp/build` ist absolut.

179 179

180Sie können auch Schreib- oder Lesezugriff mit `sandbox.filesystem.denyWrite` und `sandbox.filesystem.denyRead` blockieren und spezifische Pfade innerhalb einer blockierten Region mit `sandbox.filesystem.allowRead` erneut zulassen. Wenn sich Lesevorgänge überlappen, gewinnt der spezifischere Pfad:180Sie können auch Schreib- oder Lesezugriff mit `sandbox.filesystem.denyWrite` und `sandbox.filesystem.denyRead` blockieren und spezifische Pfade innerhalb einer blockierten Region mit `sandbox.filesystem.allowRead` erneut zulassen. Wenn sich Lesevorgänge überlappen, gewinnt der spezifischere Pfad:

181 181

230 230

231Dateieinträge unterstützen nur `"mode": "deny"`. Umgebungsvariablen-Einträge akzeptieren auch `"mode": "mask"`, das unten beschrieben wird.231Dateieinträge unterstützen nur `"mode": "deny"`. Umgebungsvariablen-Einträge akzeptieren auch `"mode": "mask"`, das unten beschrieben wird.

232 232

233Dateipfade folgen den gleichen [Präfix-Regeln](/de/settings#sandbox-path-prefixes) wie `sandbox.filesystem.*`-Einstellungen, und `deny`-Einträge aus jedem [Einstellungs-Scope](/de/settings#settings-precedence) werden zusammengeführt. Ein `deny`-Eintrag engt den Zugriff nur ein, daher kann jeder Scope einen hinzufügen, aber keiner kann einen entfernen, den ein anderer Scope hinzugefügt hat.233Dateipfade folgen den gleichen [Präfix-Regeln](/docs/de/settings#sandbox-path-prefixes) wie `sandbox.filesystem.*`-Einstellungen, und `deny`-Einträge aus jedem [Einstellungs-Scope](/docs/de/settings#settings-precedence) werden zusammengeführt. Ein `deny`-Eintrag engt den Zugriff nur ein, daher kann jeder Scope einen hinzufügen, aber keiner kann einen entfernen, den ein anderer Scope hinzugefügt hat.

234 234

235Es gibt keine integrierte Anmeldedaten-Ablehnungsliste, daher werden nur die Dateien und Variablen, die Sie auflisten, eingeschränkt. Die Einstellung betrifft nur Sandbox-Bash-Befehle. Um Anthropic- und Cloud-Provider-Anmeldedaten aus allen Subprozessen unabhängig von Sandboxing zu entfernen, setzen Sie [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/de/env-vars).235Es gibt keine integrierte Anmeldedaten-Ablehnungsliste, daher werden nur die Dateien und Variablen, die Sie auflisten, eingeschränkt. Die Einstellung betrifft nur Sandbox-Bash-Befehle. Um Anthropic- und Cloud-Provider-Anmeldedaten aus allen Subprozessen unabhängig von Sandboxing zu entfernen, setzen Sie [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/de/env-vars).

236 236

237<h4 id="mask-environment-variables">237<h4 id="mask-environment-variables">

238 Umgebungsvariablen maskieren238 Umgebungsvariablen maskieren

242 242

243Mit `mask` sieht der Sandbox-Befehl einen pro-Sitzungs-Sentinel-Wert anstelle des echten. Wenn eine Anfrage die Sandbox für einen der `injectHosts` der Anmeldedaten verlässt, ersetzt der [Sandbox-Proxy](#network-isolation) den Sentinel durch den echten Wert. Der Befehl und alles, das er protokolliert, hält niemals die echte Anmeldedaten, aber seine Anfragen authentifizieren sich immer noch.243Mit `mask` sieht der Sandbox-Befehl einen pro-Sitzungs-Sentinel-Wert anstelle des echten. Wenn eine Anfrage die Sandbox für einen der `injectHosts` der Anmeldedaten verlässt, ersetzt der [Sandbox-Proxy](#network-isolation) den Sentinel durch den echten Wert. Der Befehl und alles, das er protokolliert, hält niemals die echte Anmeldedaten, aber seine Anfragen authentifizieren sich immer noch.

244 244

245Der Proxy ersetzt die Anmeldedaten in Anfrageinhalten, daher muss er diese sehen. Setzen Sie [`network.tlsTerminate`](/de/settings#sandbox-settings), damit der Proxy TLS selbst beendet. Ohne ihn schlägt die Maskierung geschlossen fehl: Der Befehl sieht immer noch nur den Sentinel, aber der Sentinel erreicht den Server unverändert und die Authentifizierung schlägt fehl. Claude Code meldet diese Fehlkonfiguration beim Start.245Der Proxy ersetzt die Anmeldedaten in Anfrageinhalten, daher muss er diese sehen. Setzen Sie [`network.tlsTerminate`](/docs/de/settings#sandbox-settings), damit der Proxy TLS selbst beendet. Ohne ihn schlägt die Maskierung geschlossen fehl: Der Befehl sieht immer noch nur den Sentinel, aber der Sentinel erreicht den Server unverändert und die Authentifizierung schlägt fehl. Claude Code meldet diese Fehlkonfiguration beim Start.

246 246

247Das folgende Beispiel maskiert zwei Token. `GH_TOKEN` wird nur bei Anfragen an `api.github.com` ersetzt, während `NPM_TOKEN` keine `injectHosts` hat und bei Anfragen an jeden Host in `network.allowedDomains` ersetzt wird. Jeder `injectHosts`-Eintrag muss selbst von `network.allowedDomains` abgedeckt werden.247Das folgende Beispiel maskiert zwei Token. `GH_TOKEN` wird nur bei Anfragen an `api.github.com` ersetzt, während `NPM_TOKEN` keine `injectHosts` hat und bei Anfragen an jeden Host in `network.allowedDomains` ersetzt wird. Jeder `injectHosts`-Eintrag muss selbst von `network.allowedDomains` abgedeckt werden.

248 248

264}264}

265```265```

266 266

267Im Gegensatz zu `deny` autorisiert die Maskierung den Proxy, Ihre echte Anmeldedaten an die aufgelisteten Hosts zu senden, daher wird sie nur von Einstellungen berücksichtigt, die Sie oder Ihr Administrator kontrollieren: Benutzer-Einstellungen, verwaltete Einstellungen und das `--settings` CLI-Flag. `mask`-Einträge, `network.tlsTerminate` und [`credentials.allowPlaintextInject`](/de/settings#sandbox-settings) in der `.claude/settings.json` oder `.claude/settings.local.json` eines Repositorys werden ignoriert.267Im Gegensatz zu `deny` autorisiert die Maskierung den Proxy, Ihre echte Anmeldedaten an die aufgelisteten Hosts zu senden, daher wird sie nur von Einstellungen berücksichtigt, die Sie oder Ihr Administrator kontrollieren: Benutzer-Einstellungen, verwaltete Einstellungen und das `--settings` CLI-Flag. `mask`-Einträge, `network.tlsTerminate` und [`credentials.allowPlaintextInject`](/docs/de/settings#sandbox-settings) in der `.claude/settings.json` oder `.claude/settings.local.json` eines Repositorys werden ignoriert.

268 268

269Wenn die gleiche Variable mit `deny` in einem beliebigen Scope aufgelistet ist, hat `deny` Vorrang.269Wenn die gleiche Variable mit `deny` in einem beliebigen Scope aufgelistet ist, hat `deny` Vorrang.

270 270

281* **Standard-Schreibverhalten**: Lese- und Schreibzugriff auf das aktuelle Arbeitsverzeichnis und seine Unterverzeichnisse, plus das Session-Temp-Verzeichnis, auf das `$TMPDIR` verweist281* **Standard-Schreibverhalten**: Lese- und Schreibzugriff auf das aktuelle Arbeitsverzeichnis und seine Unterverzeichnisse, plus das Session-Temp-Verzeichnis, auf das `$TMPDIR` verweist

282* **Standard-Leseverhalten**: Lesezugriff auf den gesamten Computer, außer bestimmten blockierten Verzeichnissen. Beachten Sie, dass diese Standard-Einstellung immer noch das Lesen von Anmeldedatendateien wie `~/.aws/credentials` und `~/.ssh/` ermöglicht. Verwenden Sie [`sandbox.credentials`](#protect-credentials), um Lesezugriffe auf diese Dateien zu blockieren und geheime Umgebungsvariablen zu deaktivieren, oder fügen Sie die Pfade zu `denyRead` hinzu.282* **Standard-Leseverhalten**: Lesezugriff auf den gesamten Computer, außer bestimmten blockierten Verzeichnissen. Beachten Sie, dass diese Standard-Einstellung immer noch das Lesen von Anmeldedatendateien wie `~/.aws/credentials` und `~/.ssh/` ermöglicht. Verwenden Sie [`sandbox.credentials`](#protect-credentials), um Lesezugriffe auf diese Dateien zu blockieren und geheime Umgebungsvariablen zu deaktivieren, oder fügen Sie die Pfade zu `denyRead` hinzu.

283* **Blockierter Zugriff**: Kann Dateien außerhalb des aktuellen Arbeitsverzeichnisses und des Session-Temp-Verzeichnisses nicht ohne explizite Genehmigung ändern, einschließlich Shell-Konfigurationsdateien wie `~/.bashrc` und System-Binärdateien in `/bin/`283* **Blockierter Zugriff**: Kann Dateien außerhalb des aktuellen Arbeitsverzeichnisses und des Session-Temp-Verzeichnisses nicht ohne explizite Genehmigung ändern, einschließlich Shell-Konfigurationsdateien wie `~/.bashrc` und System-Binärdateien in `/bin/`

284* **Git Worktrees**: Wenn das Arbeitsverzeichnis ein [verknüpftes Git Worktree](/de/worktrees) ist, erlaubt die Sandbox auch Schreibzugriff auf das gemeinsame `.git`-Verzeichnis des Haupt-Repositorys, damit Befehle wie `git commit` Refs und den Index aktualisieren können. Schreibzugriffe auf `hooks/` und `config` in diesem Verzeichnis bleiben blockiert.284* **Git Worktrees**: Wenn das Arbeitsverzeichnis ein [verknüpftes Git Worktree](/docs/de/worktrees) ist, erlaubt die Sandbox auch Schreibzugriff auf das gemeinsame `.git`-Verzeichnis des Haupt-Repositorys, damit Befehle wie `git commit` Refs und den Index aktualisieren können. Schreibzugriffe auf `hooks/` und `config` in diesem Verzeichnis bleiben blockiert.

285* **Konfigurierbar**: Definieren Sie benutzerdefinierte zulässige und blockierte Pfade durch Einstellungen285* **Konfigurierbar**: Definieren Sie benutzerdefinierte zulässige und blockierte Pfade durch Einstellungen

286 286

287Sie können Schreibzugriff auf zusätzliche Pfade mit `sandbox.filesystem.allowWrite` in Ihren Einstellungen gewähren. Diese Einschränkungen werden auf OS-Ebene durchgesetzt, daher gelten sie für alle Subprozess-Befehle, einschließlich Tools wie `kubectl`, `terraform` und `npm`, nicht nur für Claudes Datei-Tools.287Sie können Schreibzugriff auf zusätzliche Pfade mit `sandbox.filesystem.allowWrite` in Ihren Einstellungen gewähren. Diese Einschränkungen werden auf OS-Ebene durchgesetzt, daher gelten sie für alle Subprozess-Befehle, einschließlich Tools wie `kubectl`, `terraform` und `npm`, nicht nur für Claudes Datei-Tools.

292 292

293Der Netzwerkzugriff wird durch einen Proxy-Server gesteuert, der außerhalb der Sandbox läuft:293Der Netzwerkzugriff wird durch einen Proxy-Server gesteuert, der außerhalb der Sandbox läuft:

294 294

295* **Domain-Einschränkungen**: Keine Domains sind vorab zulässig. Wenn ein Befehl zum ersten Mal eine neue Domain benötigt, fordert Claude Code zur Genehmigung auf. {/* min-version: 2.1.191 */}Ab v2.1.191 ermöglicht die Auswahl von „Ja" den Host für den Rest der aktuellen Sitzung, sodass spätere Verbindungen zum gleichen Host nicht erneut aufgefordert werden. Lassen Sie Domains vorab mit [`allowedDomains`](/de/settings#sandbox-settings) zu, um die Eingabeaufforderung zu vermeiden.295* **Domain-Einschränkungen**: Keine Domains sind vorab zulässig. Wenn ein Befehl zum ersten Mal eine neue Domain benötigt, fordert Claude Code zur Genehmigung auf. Ab v2.1.191 ermöglicht die Auswahl von „Ja" den Host für den Rest der aktuellen Sitzung, sodass spätere Verbindungen zum gleichen Host nicht erneut aufgefordert werden. Lassen Sie Domains vorab mit [`allowedDomains`](/docs/de/settings#sandbox-settings) zu, um die Eingabeaufforderung zu vermeiden.

296* **Verwaltete Sperrung**: Wenn [`allowManagedDomainsOnly`](/de/settings#sandbox-settings) in verwalteten Einstellungen gesetzt ist, werden nicht zulässige Domains automatisch blockiert, anstatt zu fragen, und nur `allowedDomains` aus verwalteten Einstellungen werden berücksichtigt.296* **Verwaltete Sperrung**: Wenn [`allowManagedDomainsOnly`](/docs/de/settings#sandbox-settings) in verwalteten Einstellungen gesetzt ist, werden nicht zulässige Domains automatisch blockiert, anstatt zu fragen, und nur `allowedDomains` aus verwalteten Einstellungen werden berücksichtigt.

297* **Benutzerdefinierte Proxy-Unterstützung**: Fortgeschrittene Benutzer können benutzerdefinierte Regeln für ausgehenden Datenverkehr implementieren297* **Benutzerdefinierte Proxy-Unterstützung**: Fortgeschrittene Benutzer können benutzerdefinierte Regeln für ausgehenden Datenverkehr implementieren

298* **Umfassende Abdeckung**: Einschränkungen gelten für alle Skripte, Programme und Subprozesse, die durch Befehle erzeugt werden298* **Umfassende Abdeckung**: Einschränkungen gelten für alle Skripte, Programme und Subprozesse, die durch Befehle erzeugt werden

299 299

300<Note>300<Note>

301 Der integrierte Proxy erzwingt die Zulassungsliste basierend auf dem angeforderten Hostnamen und beendet oder inspiziert keinen TLS-Datenverkehr. {/* min-version: 2.1.199 */}Die experimentelle Einstellung [`network.tlsTerminate`](/de/settings#sandbox-settings), verfügbar in Claude Code v2.1.199 und später, lässt den integrierten Proxy TLS selbst beenden, was [`mask`-Anmeldedateneinträge](#protect-credentials) erfordern. Siehe [Sicherheitsbeschränkungen](#security-limitations) für die Auswirkungen des Standards und [Benutzerdefinierte Proxy-Konfiguration](#custom-proxy-configuration), wenn Ihr Bedrohungsmodell TLS-Inspektion erfordert.301 Der integrierte Proxy erzwingt die Zulassungsliste basierend auf dem angeforderten Hostnamen und beendet oder inspiziert keinen TLS-Datenverkehr. Die experimentelle Einstellung [`network.tlsTerminate`](/docs/de/settings#sandbox-settings), verfügbar in Claude Code v2.1.199 und später, lässt den integrierten Proxy TLS selbst beenden, was [`mask`-Anmeldedateneinträge](#protect-credentials) erfordern. Siehe [Sicherheitsbeschränkungen](#security-limitations) für die Auswirkungen des Standards und [Benutzerdefinierte Proxy-Konfiguration](#custom-proxy-configuration), wenn Ihr Bedrohungsmodell TLS-Inspektion erfordert.

302</Note>302</Note>

303 303

304<h3 id="os-level-enforcement">304<h3 id="os-level-enforcement">

313 313

314WSL1 wird nicht unterstützt, da bubblewrap Kernel-Features erfordert, die nur in WSL2 verfügbar sind. Diese OS-Level-Einschränkungen stellen sicher, dass alle Kindprozesse, die durch Claude Code-Befehle erzeugt werden, die gleichen Sicherheitsgrenzen erben.314WSL1 wird nicht unterstützt, da bubblewrap Kernel-Features erfordert, die nur in WSL2 verfügbar sind. Diese OS-Level-Einschränkungen stellen sicher, dass alle Kindprozesse, die durch Claude Code-Befehle erzeugt werden, die gleichen Sicherheitsgrenzen erben.

315 315

316Diese gleichen Primitive sind als das eigenständige Paket [`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime) verfügbar, das die Seite [Sandbox-Umgebungen](/de/sandbox-environments#sandbox-runtime) als separaten Ansatz zum Wrapping des gesamten Claude Code-Prozesses behandelt.316Diese gleichen Primitive sind als das eigenständige Paket [`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime) verfügbar, das die Seite [Sandbox-Umgebungen](/docs/de/sandbox-environments#sandbox-runtime) als separaten Ansatz zum Wrapping des gesamten Claude Code-Prozesses behandelt.

317 317

318<h2 id="how-sandboxing-relates-to-permissions-and-permission-modes">318<h2 id="how-sandboxing-relates-to-permissions-and-permission-modes">

319 Wie Sandboxing sich auf Genehmigungen und Genehmigungsmodi bezieht319 Wie Sandboxing sich auf Genehmigungen und Genehmigungsmodi bezieht

320</h2>320</h2>

321 321

322Sandboxing, [Genehmigungsregeln](/de/permissions) und [Genehmigungsmodi](/de/permission-modes) sind komplementäre Schichten. Die folgenden Abschnitte behandeln, wie die Sandbox mit jedem interagiert.322Sandboxing, [Genehmigungsregeln](/docs/de/permissions) und [Genehmigungsmodi](/docs/de/permission-modes) sind komplementäre Schichten. Die folgenden Abschnitte behandeln, wie die Sandbox mit jedem interagiert.

323 323

324<h3 id="permission-rules">324<h3 id="permission-rules">

325 Genehmigungsregeln325 Genehmigungsregeln

353 Genehmigungsmodi353 Genehmigungsmodi

354</h3>354</h3>

355 355

356`/sandbox` ist kein [Genehmigungsmodus](/de/permission-modes). Genehmigungsmodi entscheiden, ob ein Tool-Aufruf ausgeführt wird und ob Sie zuerst aufgefordert werden, während die Sandbox einschränkt, worauf ein Bash-Befehl zugreifen kann, sobald er ausgeführt wird. Sie unterscheiden sich darin, was sie steuern und was die Pro-Aktion-Eingabeaufforderung ersetzt:356`/sandbox` ist kein [Genehmigungsmodus](/docs/de/permission-modes). Genehmigungsmodi entscheiden, ob ein Tool-Aufruf ausgeführt wird und ob Sie zuerst aufgefordert werden, während die Sandbox einschränkt, worauf ein Bash-Befehl zugreifen kann, sobald er ausgeführt wird. Sie unterscheiden sich darin, was sie steuern und was die Pro-Aktion-Eingabeaufforderung ersetzt:

357 357

359| :------------------------------------------------------------------ | :--------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |359| :------------------------------------------------------------------ | :--------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

362| `--dangerously-skip-permissions` | Ob jeder Tool-Aufruf ausgeführt wird | Nichts. [Geschützte Pfad](/de/permission-modes#protected-paths)-Prüfungen werden auch übersprungen; nur explizite [ask-Regeln](/de/permissions#manage-permissions), Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools), MCP-Tools mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) und das Entfernen von `/` oder Ihrem Home-Verzeichnis fordern immer noch auf |362| `--dangerously-skip-permissions` | Ob jeder Tool-Aufruf ausgeführt wird | Nichts. [Geschützte Pfad](/docs/de/permission-modes#protected-paths)-Prüfungen werden auch übersprungen; nur explizite [ask-Regeln](/docs/de/permissions#manage-permissions), Connector-Tools [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), MCP-Tools mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) und das Entfernen von `/` oder Ihrem Home-Verzeichnis fordern immer noch auf |

363 363

364Der [Auto-Allow-Modus](#sandbox-modes) der Sandbox ist separat vom [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode): Auto-Allow genehmigt Bash-Befehle, weil die Sandbox-Grenze sie enthält, während der Auto-Modus einen Klassifizierer verwendet, um Aktionen zu überprüfen. Die beiden funktionieren unabhängig und können kombiniert werden. Um eine Isolationsgrenze für unbeaufsichtigte Läufe zu wählen, siehe [Sandbox-Umgebungen](/de/sandbox-environments#how-isolation-relates-to-permission-modes).364Der [Auto-Allow-Modus](#sandbox-modes) der Sandbox ist separat vom [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode): Auto-Allow genehmigt Bash-Befehle, weil die Sandbox-Grenze sie enthält, während der Auto-Modus einen Klassifizierer verwendet, um Aktionen zu überprüfen. Die beiden funktionieren unabhängig und können kombiniert werden. Um eine Isolationsgrenze für unbeaufsichtigte Läufe zu wählen, siehe [Sandbox-Umgebungen](/docs/de/sandbox-environments#how-isolation-relates-to-permission-modes).

365 365

366<h2 id="configure-the-sandbox-for-your-organization">366<h2 id="configure-the-sandbox-for-your-organization">

367 Konfigurieren Sie die Sandbox für Ihre Organisation367 Konfigurieren Sie die Sandbox für Ihre Organisation

373 Erzwingen Sie Sandboxing mit verwalteten Einstellungen373 Erzwingen Sie Sandboxing mit verwalteten Einstellungen

374</h3>374</h3>

375 375

376Um die Sandbox für jeden Entwickler zu erfordern, liefern Sie die `sandbox`-Schlüssel über [verwaltete Einstellungen](/de/settings#settings-files), entweder als Datei, die von Ihrem MDM verwaltet wird, oder über [server-verwaltete Einstellungen](/de/server-managed-settings) auf Claude.ai.376Um die Sandbox für jeden Entwickler zu erfordern, liefern Sie die `sandbox`-Schlüssel über [verwaltete Einstellungen](/docs/de/settings#settings-files), entweder als Datei, die von Ihrem MDM verwaltet wird, oder über [server-verwaltete Einstellungen](/docs/de/server-managed-settings) auf Claude.ai.

377 377

378Die folgende Konfiguration verwalteter Einstellungen aktiviert die Sandbox, weigert sich, Claude Code zu starten, wenn die Sandbox nicht initialisiert werden kann, und verhindert, dass das Modell Befehle außerhalb der Sandbox erneut versucht:378Die folgende Konfiguration verwalteter Einstellungen aktiviert die Sandbox, weigert sich, Claude Code zu starten, wenn die Sandbox nicht initialisiert werden kann, und verhindert, dass das Modell Befehle außerhalb der Sandbox erneut versucht:

379 379

402 402

403Für boolesche Schlüssel wie `enabled` und `failIfUnavailable` verwendet Claude Code den verwalteten Wert und ignoriert alles, das ein Entwickler lokal setzt. Für Array-Schlüssel wie `excludedCommands` und `allowRead` führt Claude Code Einträge aus jedem Scope zusammen, daher kann ein Entwickler Einträge anhängen, die die Richtlinie erweitern.403Für boolesche Schlüssel wie `enabled` und `failIfUnavailable` verwendet Claude Code den verwalteten Wert und ignoriert alles, das ein Entwickler lokal setzt. Für Array-Schlüssel wie `excludedCommands` und `allowRead` führt Claude Code Einträge aus jedem Scope zusammen, daher kann ein Entwickler Einträge anhängen, die die Richtlinie erweitern.

404 404

405Setzen Sie `allowManagedReadPathsOnly` auf `true` in verwalteten Einstellungen, damit nur `allowRead`-Einträge aus verwalteten Einstellungen berücksichtigt werden. Benutzer-, Projekt- und lokale `allowRead`-Einträge werden ignoriert. Dies verhindert, dass Entwickler den Lesezugriff über die von der Organisation genehmigten Pfade hinaus erweitern. Um Netzwerk-Domains auf die gleiche Weise auf die verwalteten Werte zu sperren, setzen Sie [`allowManagedDomainsOnly`](/de/settings#sandbox-settings).405Setzen Sie `allowManagedReadPathsOnly` auf `true` in verwalteten Einstellungen, damit nur `allowRead`-Einträge aus verwalteten Einstellungen berücksichtigt werden. Benutzer-, Projekt- und lokale `allowRead`-Einträge werden ignoriert. Dies verhindert, dass Entwickler den Lesezugriff über die von der Organisation genehmigten Pfade hinaus erweitern. Um Netzwerk-Domains auf die gleiche Weise auf die verwalteten Werte zu sperren, setzen Sie [`allowManagedDomainsOnly`](/docs/de/settings#sandbox-settings).

406 406

407`excludedCommands` hat keine äquivalente verwaltete Sperrung, daher kann ein Entwickler immer Einträge anhängen, die zusätzliche Befehle außerhalb der Sandbox ausführen. Halten Sie die verwaltete Liste eng.407`excludedCommands` hat keine äquivalente verwaltete Sperrung, daher kann ein Entwickler immer Einträge anhängen, die zusätzliche Befehle außerhalb der Sandbox ausführen. Halten Sie die verwaltete Liste eng.

408 408

417* Alle Netzwerk-Anfragen zu protokollieren417* Alle Netzwerk-Anfragen zu protokollieren

418* Mit bestehender Sicherheitsinfrastruktur zu integrieren418* Mit bestehender Sicherheitsinfrastruktur zu integrieren

419 419

420Um Claude Code auf Ihren Proxy zu verweisen, setzen Sie die Proxy-Ports in [Sandbox-Einstellungen](/de/settings#sandbox-settings):420Um Claude Code auf Ihren Proxy zu verweisen, setzen Sie die Proxy-Ports in [Sandbox-Einstellungen](/docs/de/settings#sandbox-settings):

421 421

422```json theme={null}422```json theme={null}

423{423{

438 438

439* **Befehle schlagen mit einem Host-not-allowed-Fehler fehl**: Viele CLI-Tools müssen bestimmte Hosts erreichen. Das Gewähren der Genehmigung bei Aufforderung fügt den Host zu Ihrer Zulassungsliste hinzu, damit das Tool in Zukunft in der Sandbox ausgeführt wird.439* **Befehle schlagen mit einem Host-not-allowed-Fehler fehl**: Viele CLI-Tools müssen bestimmte Hosts erreichen. Das Gewähren der Genehmigung bei Aufforderung fügt den Host zu Ihrer Zulassungsliste hinzu, damit das Tool in Zukunft in der Sandbox ausgeführt wird.

440* **`jest` hängt oder schlägt fehl**: `watchman` ist nicht kompatibel mit der Sandbox. Führen Sie stattdessen `jest --no-watchman` aus.440* **`jest` hängt oder schlägt fehl**: `watchman` ist nicht kompatibel mit der Sandbox. Führen Sie stattdessen `jest --no-watchman` aus.

441* **Go-basierte CLIs schlagen TLS-Verifizierung auf macOS fehl**: Tools wie `gh`, `gcloud` und `terraform` können unter Seatbelt TLS-Verifizierung fehlschlagen. Listen Sie diese Tools in `excludedCommands` auf, um sie außerhalb der Sandbox auszuführen. Wenn Sie `httpProxyPort` mit einem MITM-Proxy und benutzerdefinierter CA verwenden, setzen Sie stattdessen [`enableWeakerNetworkIsolation`](/de/settings#sandbox-settings) auf `true`.441* **Go-basierte CLIs schlagen TLS-Verifizierung auf macOS fehl**: Tools wie `gh`, `gcloud` und `terraform` können unter Seatbelt TLS-Verifizierung fehlschlagen. Listen Sie diese Tools in `excludedCommands` auf, um sie außerhalb der Sandbox auszuführen. Wenn Sie `httpProxyPort` mit einem MITM-Proxy und benutzerdefinierter CA verwenden, setzen Sie stattdessen [`enableWeakerNetworkIsolation`](/docs/de/settings#sandbox-settings) auf `true`.

442* **`open`, `osascript` oder browserbasierte Authentifizierungsflows schlagen mit Fehler `-600` auf macOS fehl**: Die Sandbox blockiert Apple Events standardmäßig. Setzen Sie [`allowAppleEvents`](/de/settings#sandbox-settings) in Ihren Benutzer-, verwalteten oder CLI-Einstellungen auf `true`, um diese zuzulassen. Projekteinstellungen werden für diesen Schlüssel ignoriert. Das Aktivieren entfernt die Code-Ausführungsisolation, da Sandbox-Befehle dann andere Anwendungen ohne Benutzeraufforderung unsandboxed starten können und AppleScript-Befehle an laufende Anwendungen senden können, unterliegen jedoch der macOS-Automatisierungszustimmungsaufforderung (TCC). Alternativ können Sie den Befehl zu `excludedCommands` hinzufügen, um ihn außerhalb der Sandbox auszuführen.442* **`open`, `osascript` oder browserbasierte Authentifizierungsflows schlagen mit Fehler `-600` auf macOS fehl**: Die Sandbox blockiert Apple Events standardmäßig. Setzen Sie [`allowAppleEvents`](/docs/de/settings#sandbox-settings) in Ihren Benutzer-, verwalteten oder CLI-Einstellungen auf `true`, um diese zuzulassen. Projekteinstellungen werden für diesen Schlüssel ignoriert. Das Aktivieren entfernt die Code-Ausführungsisolation, da Sandbox-Befehle dann andere Anwendungen ohne Benutzeraufforderung unsandboxed starten können und AppleScript-Befehle an laufende Anwendungen senden können, unterliegen jedoch der macOS-Automatisierungszustimmungsaufforderung (TCC). Alternativ können Sie den Befehl zu `excludedCommands` hinzufügen, um ihn außerhalb der Sandbox auszuführen.

443* **`docker`-Befehle schlagen fehl**: `docker` ist nicht kompatibel mit der Sandbox. Fügen Sie `docker *` zu `excludedCommands` hinzu, um es außerhalb der Sandbox auszuführen.443* **`docker`-Befehle schlagen fehl**: `docker` ist nicht kompatibel mit der Sandbox. Fügen Sie `docker *` zu `excludedCommands` hinzu, um es außerhalb der Sandbox auszuführen.

444* **Bubblewrap schlägt beim Start in einem Container fehl**: In einem unprivilegierten Container kann bubblewrap kein frisches `/proc`-Dateisystem mounten. Setzen Sie [`enableWeakerNestedSandbox`](/de/settings#sandbox-settings) auf `true`, damit die innere Sandbox das vorhandene `/proc` des Containers bind-mountet. Verwenden Sie diese Einstellung nur, wenn der äußere Container bereits die Isolationsgrenze bietet, die Sie benötigen, da sie Prozessinformationen für Sandbox-Befehle verfügbar macht, die ein frisches `/proc`-Mount verbergen würde.444* **Bubblewrap schlägt beim Start in einem Container fehl**: In einem unprivilegierten Container kann bubblewrap kein frisches `/proc`-Dateisystem mounten. Setzen Sie [`enableWeakerNestedSandbox`](/docs/de/settings#sandbox-settings) auf `true`, damit die innere Sandbox das vorhandene `/proc` des Containers bind-mountet. Verwenden Sie diese Einstellung nur, wenn der äußere Container bereits die Isolationsgrenze bietet, die Sie benötigen, da sie Prozessinformationen für Sandbox-Befehle verfügbar macht, die ein frisches `/proc`-Mount verbergen würde.

445* **Seccomp-Filter auf Linux**: Der Seccomp-Filter ist erforderlich, um Unix-Domain-Sockets zu blockieren. Die Registerkarte „Dependencies" in `/sandbox` zeigt an, ob er verfügbar ist. Wenn er fehlt, führen Sie `npm install -g @anthropic-ai/sandbox-runtime` aus, um den Helper zu installieren.445* **Seccomp-Filter auf Linux**: Der Seccomp-Filter ist erforderlich, um Unix-Domain-Sockets zu blockieren. Die Registerkarte „Dependencies" in `/sandbox` zeigt an, ob er verfügbar ist. Wenn er fehlt, führen Sie `npm install -g @anthropic-ai/sandbox-runtime` aus, um den Helper zu installieren.

446* **`--dangerously-skip-permissions` schlägt als Root fehl**: Dieses Flag wird blockiert, wenn es als Root oder über sudo auf Linux und macOS ausgeführt wird, da Root-Zugriff kombiniert mit keinen Genehmigungseingaben jede Datei oder jeden Service auf dem System ändern kann. Die Prüfung wird automatisch in einer erkannten Sandbox übersprungen. Um autonom in einem Container auszuführen, verwenden Sie die [Dev-Container](/de/devcontainer)-Konfiguration, die Claude Code als Nicht-Root-Benutzer ausführt.446* **`--dangerously-skip-permissions` schlägt als Root fehl**: Dieses Flag wird blockiert, wenn es als Root oder über sudo auf Linux und macOS ausgeführt wird, da Root-Zugriff kombiniert mit keinen Genehmigungseingaben jede Datei oder jeden Service auf dem System ändern kann. Die Prüfung wird automatisch in einer erkannten Sandbox übersprungen. Um autonom in einem Container auszuführen, verwenden Sie die [Dev-Container](/docs/de/devcontainer)-Konfiguration, die Claude Code als Nicht-Root-Benutzer ausführt.

447 447

448<h2 id="limitations">448<h2 id="limitations">

449 Einschränkungen449 Einschränkungen

455 Sicherheitsbeschränkungen455 Sicherheitsbeschränkungen

456</h3>456</h3>

457 457

458* **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`](/de/settings#sandbox-settings) beendet TLS am Proxy für [`mask`-Anmeldedaten-Substitution](#protect-credentials), fügt aber keine Inhaltsfilterung hinzu. Sie sind verantwortlich dafür, dass nur vertrauenswürdige Domains in Ihrer Richtlinie zulässig sind.458* **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#sandbox-settings) beendet TLS am Proxy für [`mask`-Anmeldedaten-Substitution](#protect-credentials), fügt aber keine Inhaltsfilterung hinzu. Sie sind verantwortlich dafür, dass nur vertrauenswürdige Domains in Ihrer Richtlinie zulässig sind.

459 459

460<Warning>460<Warning>

461 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.461 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.

481 481

482Die Sandbox isoliert Bash-Subprozesse. Andere Tools funktionieren unter verschiedenen Grenzen:482Die Sandbox isoliert Bash-Subprozesse. Andere Tools funktionieren unter verschiedenen Grenzen:

483 483

484* **Integrierte Datei-Tools**: Read, Edit und Write verwenden das Genehmigungssystem direkt, anstatt durch die Sandbox zu laufen. Siehe [Genehmigungen](/de/permissions).484* **Integrierte Datei-Tools**: Read, Edit und Write verwenden das Genehmigungssystem direkt, anstatt durch die Sandbox zu laufen. Siehe [Genehmigungen](/docs/de/permissions).

485* **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](/de/computer-use) oder [Computer-Nutzung auf Desktop](/de/desktop#let-claude-use-your-computer).485* **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).

486* **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 setzen Sie [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/de/env-vars), um Anthropic- und Cloud-Provider-Anmeldedaten aus allen Subprozessen zu entfernen.486* **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 setzen Sie [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/de/env-vars), um Anthropic- und Cloud-Provider-Anmeldedaten aus allen Subprozessen zu entfernen.

487* **Subagenten**: [Subagenten](/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.487* **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.

488 488

489<Warning>489<Warning>

490 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 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.490 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 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.

494 Siehe auch494 Siehe auch

495</h2>495</h2>

496 496

497* [Sandbox-Umgebungen](/de/sandbox-environments): Vergleichen Sie die integrierte Sandbox mit Dev-Containern, Containern und VMs497* [Sandbox-Umgebungen](/docs/de/sandbox-environments): Vergleichen Sie die integrierte Sandbox mit Dev-Containern, Containern und VMs

498* [Sicherheit](/de/security): Umfassende Sicherheitsfeatures und Best Practices498* [Sicherheit](/docs/de/security): Umfassende Sicherheitsfeatures und Best Practices

499* [Genehmigungen](/de/permissions): Genehmigungskonfiguration und Zugriffskontrolle499* [Genehmigungen](/docs/de/permissions): Genehmigungskonfiguration und Zugriffskontrolle

500* [Einstellungen](/de/settings): Vollständige Konfigurationsreferenz500* [Einstellungen](/docs/de/settings): Vollständige Konfigurationsreferenz

501* [CLI-Referenz](/de/cli-reference): Befehlszeilenoptionen501* [CLI-Referenz](/docs/de/cli-reference): Befehlszeilenoptionen

scheduled-tasks.md +17 −17

Details

6 6

7> Verwenden Sie /loop und die Cron-Planungstools, um Prompts wiederholt auszuführen, den Status abzurufen oder einmalige Erinnerungen innerhalb einer Claude Code-Sitzung zu setzen.7> Verwenden Sie /loop und die Cron-Planungstools, um Prompts wiederholt auszuführen, den Status abzurufen oder einmalige Erinnerungen innerhalb einer Claude Code-Sitzung zu setzen.

8 8

9Geplante Aufgaben ermöglichen es Claude, einen Prompt automatisch in regelmäßigen Abständen erneut auszuführen. Verwenden Sie sie, um eine Bereitstellung abzurufen, einen PR zu überwachen, einen langwierigen Build zu überprüfen oder sich später in der Sitzung an etwas zu erinnern. Um auf Ereignisse zu reagieren, während sie geschehen, anstatt abzurufen, siehe [Kanäle](/de/channels): Ihr CI kann den Fehler direkt in die Sitzung übertragen. Um die Sitzung Zug um Zug weiterarbeiten zu lassen, bis eine Bedingung erfüllt ist, anstatt in einem Intervall, siehe [`/goal`](/de/goal).9Geplante Aufgaben ermöglichen es Claude, einen Prompt automatisch in regelmäßigen Abständen erneut auszuführen. Verwenden Sie sie, um eine Bereitstellung abzurufen, einen PR zu überwachen, einen langwierigen Build zu überprüfen oder sich später in der Sitzung an etwas zu erinnern. Um auf Ereignisse zu reagieren, während sie geschehen, anstatt abzurufen, siehe [Kanäle](/docs/de/channels): Ihr CI kann den Fehler direkt in die Sitzung übertragen. Um die Sitzung Zug um Zug weiterarbeiten zu lassen, bis eine Bedingung erfüllt ist, anstatt in einem Intervall, siehe [`/goal`](/docs/de/goal).

10 10

11Aufgaben sind sitzungsbezogen: Sie existieren im aktuellen Gespräch und werden beendet, wenn Sie ein neues starten. Das Fortsetzen mit `--resume` oder `--continue` bringt alle Aufgaben zurück, die nicht [abgelaufen sind](#seven-day-expiry): eine wiederkehrende Aufgabe, die in den letzten 7 Tagen erstellt wurde, oder eine einmalige Aufgabe, deren geplante Zeit noch nicht vergangen ist. Für Planung, die unabhängig von einer Sitzung bestehen bleibt, verwenden Sie [Routinen](/de/routines), um eine Routine auf von Anthropic verwalteter Infrastruktur zu erstellen, richten Sie eine [Desktop-geplante Aufgabe](/de/desktop-scheduled-tasks) ein, oder verwenden Sie [GitHub Actions](/de/github-actions).11Aufgaben sind sitzungsbezogen: Sie existieren im aktuellen Gespräch und werden beendet, wenn Sie ein neues starten. Das Fortsetzen mit `--resume` oder `--continue` bringt alle Aufgaben zurück, die nicht [abgelaufen sind](#seven-day-expiry): eine wiederkehrende Aufgabe, die in den letzten 7 Tagen erstellt wurde, oder eine einmalige Aufgabe, deren geplante Zeit noch nicht vergangen ist. Für Planung, die unabhängig von einer Sitzung bestehen bleibt, verwenden Sie [Routinen](/docs/de/routines), um eine Routine auf von Anthropic verwalteter Infrastruktur zu erstellen, richten Sie eine [Desktop-geplante Aufgabe](/docs/de/desktop-scheduled-tasks) ein, oder verwenden Sie [GitHub Actions](/docs/de/github-actions).

12 12

13<h2 id="compare-scheduling-options">13<h2 id="compare-scheduling-options">

14 Vergleichen Sie Planungsoptionen14 Vergleichen Sie Planungsoptionen

16 16

17Claude Code offers three ways to schedule recurring or one-off work:17Claude Code offers three ways to schedule recurring or one-off work:

18 18

20| :------------------------- | :----------------------------- | :------------------------------------- | :---------------------------------- |20| :------------------------- | :----------------------------- | :------------------------------------- | :---------------------------------- |

22| Requires machine on | No | Yes | Yes |22| Requires machine on | No | Yes | Yes |

23| Requires open session | No | No | Yes |23| Requires open session | No | No | Yes |

24| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |24| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |

25| Access to local files | No (fresh clone) | Yes | Yes |25| Access to local files | No (fresh clone) | Yes | Yes |

28| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |28| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |

36 Führen Sie einen Prompt wiederholt mit /loop aus36 Führen Sie einen Prompt wiederholt mit /loop aus

37</h2>37</h2>

38 38

39Die `/loop` [bundled skill](/de/commands) ist der schnellste Weg, um einen Prompt wiederholt auszuführen, während die Sitzung offen bleibt. Sowohl das Intervall als auch der Prompt sind optional, und das, was Sie bereitstellen, bestimmt, wie sich die Schleife verhält.39Die `/loop` [bundled skill](/docs/de/commands) ist der schnellste Weg, um einen Prompt wiederholt auszuführen, während die Sitzung offen bleibt. Sowohl das Intervall als auch der Prompt sind optional, und das, was Sie bereitstellen, bestimmt, wie sich die Schleife verhält.

40 40

42| :------------------------ | :-------------------------- | :----------------------------------------------------------------------------------------------------------------- |42| :------------------------ | :-------------------------- | :----------------------------------------------------------------------------------------------------------------- |

46 46

47Sie können auch einen Skill als Prompt übergeben, zum Beispiel `/loop 20m /review-pr 1234`, um diesen Skill bei jeder Iteration erneut auszuführen. {/* min-version: 2.1.196 */}Ab v2.1.196 führt ein geplanter Auslöser nur Skills aus, die Claude [selbstständig aufrufen darf](/de/skills#control-who-invokes-a-skill). Die folgenden erreichen Claude als einfacher Text statt auszuführen:47Sie können auch einen Skill als Prompt übergeben, zum Beispiel `/loop 20m /review-pr 1234`, um diesen Skill bei jeder Iteration erneut auszuführen. Ab v2.1.196 führt ein geplanter Auslöser nur Skills aus, die Claude [selbstständig aufrufen darf](/docs/de/skills#control-who-invokes-a-skill). Die folgenden erreichen Claude als einfacher Text statt auszuführen:

48 48

49* integrierte Befehle wie `/permissions`, `/model` oder `/clear`49* integrierte Befehle wie `/permissions`, `/model` oder `/clear`

~~50* Skills, die mit [`disable-model-invocation: true`](/de/skills#frontmatter-reference) gekennzeichnet sind~~50* Skills, die mit [`disable-model-invocation: true`](/docs/de/skills#frontmatter-reference) gekennzeichnet sind

51* Skills, die Claude durch eine [`skillOverrides`](/de/skills#override-skill-visibility-from-settings)-Einstellung oder eine `Skill` [deny rule](/de/skills#restrict-claude’s-skill-access) vorenthalten werden51* Skills, die Claude durch eine [`skillOverrides`](/docs/de/skills#override-skill-visibility-from-settings)-Einstellung oder eine `Skill` [deny rule](/docs/de/skills#restrict-claude’s-skill-access) vorenthalten werden

~~52* [MCP prompts](/de/mcp#use-mcp-prompts-as-commands) wie `/mcp__github__list_prs`; Skills, die ein MCP-Server bereitstellt, laufen weiterhin~~52* [MCP prompts](/docs/de/mcp#use-mcp-prompts-as-commands) wie `/mcp__github__list_prs`; Skills, die ein MCP-Server bereitstellt, laufen weiterhin

53 53

54<h3 id="run-on-a-fixed-interval">54<h3 id="run-on-a-fixed-interval">

55 Führen Sie nach einem festen Intervall aus55 Führen Sie nach einem festen Intervall aus

77/loop check whether CI passed and address any review comments77/loop check whether CI passed and address any review comments

78```78```

79 79

80Wenn Sie einen dynamischen `/loop`-Zeitplan anfordern, kann Claude das [Monitor-Tool](/de/tools-reference#monitor-tool) direkt verwenden. Monitor führt ein Hintergrundskript aus und streamt jede Ausgabezeile zurück, was das Abrufen ganz vermeidet und oft token-effizienter und reaktiver ist als das erneute Ausführen eines Prompts in einem Intervall.80Wenn Sie einen dynamischen `/loop`-Zeitplan anfordern, kann Claude das [Monitor-Tool](/docs/de/tools-reference#monitor-tool) direkt verwenden. Monitor führt ein Hintergrundskript aus und streamt jede Ausgabezeile zurück, was das Abrufen ganz vermeidet und oft token-effizienter und reaktiver ist als das erneute Ausführen eines Prompts in einem Intervall.

81 81

82Eine dynamisch geplante Schleife erscheint in Ihrer [geplanten Aufgabenliste](#manage-scheduled-tasks) wie jede andere Aufgabe, sodass Sie sie auf die gleiche Weise auflisten oder stornieren können. Die [Jitter-Regeln](#jitter) gelten nicht dafür, aber die [sieben-Tage-Ablauf](#seven-day-expiry) tut es: die Schleife endet automatisch sieben Tage nach dem Start.82Eine dynamisch geplante Schleife erscheint in Ihrer [geplanten Aufgabenliste](#manage-scheduled-tasks) wie jede andere Aufgabe, sodass Sie sie auf die gleiche Weise auflisten oder stornieren können. Die [Jitter-Regeln](#jitter) gelten nicht dafür, aber die [sieben-Tage-Ablauf](#seven-day-expiry) tut es: die Schleife endet automatisch sieben Tage nach dem Start.

83 83

141 141

142Um eine `/loop` zu stoppen, während sie auf die nächste Iteration wartet, drücken Sie `Esc`. Dies löscht den ausstehenden Wakeup, sodass die Schleife nicht erneut läuft. Aufgaben, die Sie durch [direktes Fragen an Claude](#manage-scheduled-tasks) geplant haben, sind nicht von `Esc` betroffen und bleiben bestehen, bis Sie sie löschen.142Um eine `/loop` zu stoppen, während sie auf die nächste Iteration wartet, drücken Sie `Esc`. Dies löscht den ausstehenden Wakeup, sodass die Schleife nicht erneut läuft. Aufgaben, die Sie durch [direktes Fragen an Claude](#manage-scheduled-tasks) geplant haben, sind nicht von `Esc` betroffen und bleiben bestehen, bis Sie sie löschen.

143 143

144Im [selbstgesteuertem Modus](#let-claude-choose-the-interval) kann Claude die Schleife auch selbst beenden, sobald die Aufgabe abgeschlossen ist. Claude ruft das [`ScheduleWakeup`-Tool](/de/tools-reference) mit `stop: true` auf, was den ausstehenden Wakeup sofort storniert. Wenn eine Iteration endet, ohne entweder neu zu planen oder zu stoppen, plant Claude Code einen Fallback-Wakeup etwa 20 Minuten später und beendet die Schleife, wenn diese Iteration auch nicht neu plant. Vor v2.1.202 war das Nicht-Neuplanung die einzige Möglichkeit, wie Claude eine Schleife selbst beenden konnte.144Im [selbstgesteuertem Modus](#let-claude-choose-the-interval) kann Claude die Schleife auch selbst beenden, sobald die Aufgabe abgeschlossen ist. Claude ruft das [`ScheduleWakeup`-Tool](/docs/de/tools-reference) mit `stop: true` auf, was den ausstehenden Wakeup sofort storniert. Wenn eine Iteration endet, ohne entweder neu zu planen oder zu stoppen, plant Claude Code einen Fallback-Wakeup etwa 20 Minuten später und beendet die Schleife, wenn diese Iteration auch nicht neu plant. Vor v2.1.202 war das Nicht-Neuplanung die einzige Möglichkeit, wie Claude eine Schleife selbst beenden konnte.

145 145

146Schleifen nach einem festen Intervall laufen weiter, bis Sie sie stoppen oder [sieben Tage vergehen](#seven-day-expiry).146Schleifen nach einem festen Intervall laufen weiter, bis Sie sie stoppen oder [sieben Tage vergehen](#seven-day-expiry).

147 147

208 Ablauf nach sieben Tagen208 Ablauf nach sieben Tagen

209</h3>209</h3>

210 210

211Wiederkehrende Aufgaben verfallen automatisch 7 Tage nach der Erstellung. Die Aufgabe läuft ein letztes Mal, dann löscht sie sich selbst. Dies begrenzt, wie lange eine vergessene Schleife laufen kann. Wenn Sie benötigen, dass eine wiederkehrende Aufgabe länger dauert, stornieren und erstellen Sie sie neu, bevor sie abläuft, oder verwenden Sie [Routinen](/de/routines) oder [Desktop-geplante Aufgaben](/de/desktop-scheduled-tasks) für dauerhafte Planung.211Wiederkehrende Aufgaben verfallen automatisch 7 Tage nach der Erstellung. Die Aufgabe läuft ein letztes Mal, dann löscht sie sich selbst. Dies begrenzt, wie lange eine vergessene Schleife laufen kann. Wenn Sie benötigen, dass eine wiederkehrende Aufgabe länger dauert, stornieren und erstellen Sie sie neu, bevor sie abläuft, oder verwenden Sie [Routinen](/docs/de/routines) oder [Desktop-geplante Aufgaben](/docs/de/desktop-scheduled-tasks) für dauerhafte Planung.

212 212

213<h2 id="cron-expression-reference">213<h2 id="cron-expression-reference">

214 Cron-Ausdrucksreferenz214 Cron-Ausdrucksreferenz

233 Deaktivieren Sie geplante Aufgaben233 Deaktivieren Sie geplante Aufgaben

234</h2>234</h2>

235 235

236Setzen Sie `CLAUDE_CODE_DISABLE_CRON=1` in Ihrer Umgebung, um den Scheduler vollständig zu deaktivieren. Die Cron-Tools und `/loop` werden nicht verfügbar, und alle bereits geplanten Aufgaben stoppen das Laufen. Siehe [Umgebungsvariablen](/de/env-vars) für die vollständige Liste der Deaktivierungsflags.236Setzen Sie `CLAUDE_CODE_DISABLE_CRON=1` in Ihrer Umgebung, um den Scheduler vollständig zu deaktivieren. Die Cron-Tools und `/loop` werden nicht verfügbar, und alle bereits geplanten Aufgaben stoppen das Laufen. Siehe [Umgebungsvariablen](/docs/de/env-vars) für die vollständige Liste der Deaktivierungsflags.

237 237

238<h2 id="limitations">238<h2 id="limitations">

239 Einschränkungen239 Einschränkungen

241 241

242Die sitzungsbezogene Planung hat inhärente Einschränkungen:242Die sitzungsbezogene Planung hat inhärente Einschränkungen:

243 243

244* Aufgaben laufen nur, während Claude Code läuft und untätig ist. Das Schließen des Terminals oder das Beenden der Sitzung stoppt sie. [Backgrounding der Sitzung](/de/agent-view#from-inside-a-session) trägt `/loop`-Aufgaben zu einer Hintergrund-Sitzung über, die ohne Terminal weiterläuft.244* Aufgaben laufen nur, während Claude Code läuft und untätig ist. Das Schließen des Terminals oder das Beenden der Sitzung stoppt sie. [Backgrounding der Sitzung](/docs/de/agent-view#from-inside-a-session) trägt `/loop`-Aufgaben zu einer Hintergrund-Sitzung über, die ohne Terminal weiterläuft.

245* Kein Aufholen für verpasste Läufe. Wenn die geplante Zeit einer Aufgabe verstreicht, während Claude mit einer langwierigen Anfrage beschäftigt ist, läuft sie einmal, wenn Claude untätig wird, nicht einmal pro verpasstem Intervall.245* Kein Aufholen für verpasste Läufe. Wenn die geplante Zeit einer Aufgabe verstreicht, während Claude mit einer langwierigen Anfrage beschäftigt ist, läuft sie einmal, wenn Claude untätig wird, nicht einmal pro verpasstem Intervall.

246* Neues Gespräch löscht alle sitzungsbezogenen Aufgaben. Das Fortsetzen mit `claude --resume` oder `claude --continue` stellt Aufgaben wieder her, die nicht abgelaufen sind: wiederkehrende Aufgaben innerhalb von sieben Tagen nach der Erstellung und einmalige Aufgaben, deren geplante Zeit noch nicht vergangen ist. Hintergrund-Bash- und Monitor-Aufgaben werden bei Fortsetzen nie wiederhergestellt.246* Neues Gespräch löscht alle sitzungsbezogenen Aufgaben. Das Fortsetzen mit `claude --resume` oder `claude --continue` stellt Aufgaben wieder her, die nicht abgelaufen sind: wiederkehrende Aufgaben innerhalb von sieben Tagen nach der Erstellung und einmalige Aufgaben, deren geplante Zeit noch nicht vergangen ist. Hintergrund-Bash- und Monitor-Aufgaben werden bei Fortsetzen nie wiederhergestellt.

247 247

248Für Cron-gesteuerte Automatisierung, die unbeaufsichtigt laufen muss:248Für Cron-gesteuerte Automatisierung, die unbeaufsichtigt laufen muss:

249 249

250* [Routinen](/de/routines): Laufen auf von Anthropic verwalteter Infrastruktur nach Zeitplan, über API-Aufruf oder bei GitHub-Ereignissen250* [Routinen](/docs/de/routines): Laufen auf von Anthropic verwalteter Infrastruktur nach Zeitplan, über API-Aufruf oder bei GitHub-Ereignissen

251* [GitHub Actions](/de/github-actions): Verwenden Sie einen `schedule`-Trigger in CI251* [GitHub Actions](/docs/de/github-actions): Verwenden Sie einen `schedule`-Trigger in CI

252* [Desktop-geplante Aufgaben](/de/desktop-scheduled-tasks): Laufen lokal auf Ihrem Computer252* [Desktop-geplante Aufgaben](/docs/de/desktop-scheduled-tasks): Laufen lokal auf Ihrem Computer

security-guidance.md +13 −13

Details

10 10

11Nach der Installation wird das Plugin automatisch ausgeführt. Es gibt nichts zu aufzurufen und keinen separaten Befehl zu merken.11Nach der Installation wird das Plugin automatisch ausgeführt. Es gibt nichts zu aufzurufen und keinen separaten Befehl zu merken.

12 12

13Das Plugin ist der In-Session-Begleiter zu [Code Review](/de/code-review), das auf Pull Requests ausgeführt wird. Dieses Plugin reduziert, was den PR erreicht. Code Review erfasst, was es tut. Wie das Plugin mit On-Demand-Review und CI-Scanning zusammenarbeitet, finden Sie unter [Wie dies mit anderen Sicherheitstools zusammenpasst](#how-this-fits-with-other-security-tools).13Das Plugin ist der In-Session-Begleiter zu [Code Review](/docs/de/code-review), das auf Pull Requests ausgeführt wird. Dieses Plugin reduziert, was den PR erreicht. Code Review erfasst, was es tut. Wie das Plugin mit On-Demand-Review und CI-Scanning zusammenarbeitet, finden Sie unter [Wie dies mit anderen Sicherheitstools zusammenpasst](#how-this-fits-with-other-security-tools).

14 14

15<h2 id="prerequisites">15<h2 id="prerequisites">

16 Voraussetzungen16 Voraussetzungen

26 Plugin installieren26 Plugin installieren

27</h2>27</h2>

28 28

~~29Installieren Sie in einer Claude Code-Sitzung aus dem [offiziellen Anthropic-Marketplace](/de/discover-plugins#official-anthropic-marketplace):~~29Installieren Sie in einer Claude Code-Sitzung aus dem [offiziellen Anthropic-Marketplace](/docs/de/discover-plugins#official-anthropic-marketplace):

30 30

31```text theme={null}31```text theme={null}

32/plugin install security-guidance@claude-plugins-official32/plugin install security-guidance@claude-plugins-official

44 In Cloud-Sitzungen und gemeinsamen Repositories aktivieren44 In Cloud-Sitzungen und gemeinsamen Repositories aktivieren

45</h3>45</h3>

46 46

47Benutzergebundene Plugins werden nicht in [Claude Code im Web](/de/claude-code-on-the-web) übernommen, da diese Sitzungen auf Anthropic-Infrastruktur statt auf Ihrem Computer ausgeführt werden. Um das Plugin dort zu aktivieren oder es für alle einzuschalten, die ein Repository klonen, deklarieren Sie es in den eingecheckten Einstellungen des Projekts:47Benutzergebundene Plugins werden nicht in [Claude Code im Web](/docs/de/claude-code-on-the-web) übernommen, da diese Sitzungen auf Anthropic-Infrastruktur statt auf Ihrem Computer ausgeführt werden. Um das Plugin dort zu aktivieren oder es für alle einzuschalten, die ein Repository klonen, deklarieren Sie es in den eingecheckten Einstellungen des Projekts:

48 48

49```json .claude/settings.json theme={null}49```json .claude/settings.json theme={null}

50{50{

54}54}

55```55```

56 56

~~57Administratoren können das Plugin organisationsweit aktivieren, indem sie [`enabledPlugins`](/de/settings#plugin-settings) in [verwalteten Einstellungen](/de/admin-setup) festlegen.~~57Administratoren können das Plugin organisationsweit aktivieren, indem sie [`enabledPlugins`](/docs/de/settings#plugin-settings) in [verwalteten Einstellungen](/docs/de/admin-setup) festlegen.

58 58

59<h2 id="what-the-plugin-checks">59<h2 id="what-the-plugin-checks">

60 Was das Plugin überprüft60 Was das Plugin überprüft

139- Verwenden Sie `crypto.timingSafeEqual` für Token-Vergleich statt `===`.139- Verwenden Sie `crypto.timingSafeEqual` für Token-Vergleich statt `===`.

140```140```

141 141

142Diese Regeln sind Guidance für den Reviewer, keine deterministischen Schutzvorrichtungen. Das Plugin zeigt Verstöße als Erkenntnisse für Claude an, um sie zu beheben, blockiert aber keine Schreibvorgänge und garantiert nicht, dass jeder Verstoß erfasst wird. Die Guidance ist nur additiv: Eine Regel, die besagt, dass eine Sicherheitslückenklasse ignoriert werden soll, unterdrückt diese Erkenntnisse nicht. Für harte Durchsetzung kombinieren Sie das Plugin mit einem [Hook, der Bearbeitungen blockiert](/de/hooks-guide#block-edits-to-protected-files) oder einer CI-Überprüfung.142Diese Regeln sind Guidance für den Reviewer, keine deterministischen Schutzvorrichtungen. Das Plugin zeigt Verstöße als Erkenntnisse für Claude an, um sie zu beheben, blockiert aber keine Schreibvorgänge und garantiert nicht, dass jeder Verstoß erfasst wird. Die Guidance ist nur additiv: Eine Regel, die besagt, dass eine Sicherheitslückenklasse ignoriert werden soll, unterdrückt diese Erkenntnisse nicht. Für harte Durchsetzung kombinieren Sie das Plugin mit einem [Hook, der Bearbeitungen blockiert](/docs/de/hooks-guide#block-edits-to-protected-files) oder einer CI-Überprüfung.

143 143

144<h3 id="add-custom-per-edit-patterns">144<h3 id="add-custom-per-edit-patterns">

145 Fügen Sie benutzerdefinierte Per-Edit-Muster hinzu145 Fügen Sie benutzerdefinierte Per-Edit-Muster hinzu

187 Nutzungskosten187 Nutzungskosten

188</h2>188</h2>

189 189

190Die [Per-Edit-Pattern-Überprüfung](#on-each-file-edit) macht keinen Modellaufruf und fügt keine Kosten hinzu. Die [End-of-Turn](#at-the-end-of-each-turn)- und [Commit](#on-each-commit-or-push-claude-makes)-Überprüfungen verbrauchen jeweils zusätzliche Modellnutzung, die wie jede andere Claude-Anfrage zu Ihrer [Nutzung](/de/costs) zählt. Die Commit-Überprüfung ist agentengestützt und kann mehrere Modellrunden pro Commit dauern, begrenzt auf 20 Überprüfungen pro rollende Stunde. Erwarten Sie ungefähr einen Review-Aufruf pro Runde, die Dateien ändert, und einen tieferen Review pro Commit, beide unterliegen den oben genannten Limits.190Die [Per-Edit-Pattern-Überprüfung](#on-each-file-edit) macht keinen Modellaufruf und fügt keine Kosten hinzu. Die [End-of-Turn](#at-the-end-of-each-turn)- und [Commit](#on-each-commit-or-push-claude-makes)-Überprüfungen verbrauchen jeweils zusätzliche Modellnutzung, die wie jede andere Claude-Anfrage zu Ihrer [Nutzung](/docs/de/costs) zählt. Die Commit-Überprüfung ist agentengestützt und kann mehrere Modellrunden pro Commit dauern, begrenzt auf 20 Überprüfungen pro rollende Stunde. Erwarten Sie ungefähr einen Review-Aufruf pro Runde, die Dateien ändert, und einen tieferen Review pro Commit, beide unterliegen den oben genannten Limits.

191 191

192Beide modellgestützten Überprüfungen verwenden standardmäßig Claude Opus 4.7. Setzen Sie `SECURITY_REVIEW_MODEL`, um ein anderes Modell für die End-of-Turn-Überprüfung zu wählen, und `SG_AGENTIC_MODEL` für die Commit-Überprüfung.192Beide modellgestützten Überprüfungen verwenden standardmäßig Claude Opus 4.7. Setzen Sie `SECURITY_REVIEW_MODEL`, um ein anderes Modell für die End-of-Turn-Überprüfung zu wählen, und `SG_AGENTIC_MODEL` für die Commit-Überprüfung.

193 193

219/plugin uninstall security-guidance@claude-plugins-official219/plugin uninstall security-guidance@claude-plugins-official

220```220```

221 221

222Wenn das Plugin durch die `.claude/settings.json` eines Projekts aktiviert wurde, schreibt das Deaktivieren von `/plugin` einen Override in Ihre `.claude/settings.local.json`, anstatt die eingecheckte Datei zu bearbeiten, sodass das Plugin für Sie ausgeschaltet bleibt, während Ihre Teamkollegen nicht betroffen sind. {/* min-version: 2.1.203 */}Derselbe Dialog bietet auch an, das Plugin für alle zu deinstallieren, indem es aus der gemeinsamen `.claude/settings.json` entfernt wird; diese Option erfordert Claude Code v2.1.203 oder später. Wenn es durch [verwaltete Einstellungen](/de/admin-setup) aktiviert wurde, kann nur ein Administrator es deaktivieren.222Wenn das Plugin durch die `.claude/settings.json` eines Projekts aktiviert wurde, schreibt das Deaktivieren von `/plugin` einen Override in Ihre `.claude/settings.local.json`, anstatt die eingecheckte Datei zu bearbeiten, sodass das Plugin für Sie ausgeschaltet bleibt, während Ihre Teamkollegen nicht betroffen sind. Derselbe Dialog bietet auch an, das Plugin für alle zu deinstallieren, indem es aus der gemeinsamen `.claude/settings.json` entfernt wird; diese Option erfordert Claude Code v2.1.203 oder später. Wenn es durch [verwaltete Einstellungen](/docs/de/admin-setup) aktiviert wurde, kann nur ein Administrator es deaktivieren.

223 223

224<h2 id="how-the-plugin-integrates-with-claude-code">224<h2 id="how-the-plugin-integrates-with-claude-code">

225 Wie das Plugin mit Claude Code integriert wird225 Wie das Plugin mit Claude Code integriert wird

226</h2>226</h2>

227 227

228Das Plugin ist vollständig auf [Hooks](/de/hooks) aufgebaut, dem Mechanismus zum Ausführen Ihres eigenen Codes an bestimmten Punkten in Claudes Schleife. Es registriert:228Das Plugin ist vollständig auf [Hooks](/docs/de/hooks) aufgebaut, dem Mechanismus zum Ausführen Ihres eigenen Codes an bestimmten Punkten in Claudes Schleife. Es registriert:

229 229

230| Hook-Ereignis | Zweck |230| Hook-Ereignis | Zweck |

231| :------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------- |231| :------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------- |

247| :--------------- | :------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------- |247| :--------------- | :------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------- |

251| In CI | Ihre vorhandenen statischen Analysen und Abhängigkeitsscanner | Sprachspezifische Regeln, Supply-Chain-Überprüfungen und Richtliniendurchsetzung, die das Plugin nicht versucht |251| In CI | Ihre vorhandenen statischen Analysen und Abhängigkeitsscanner | Sprachspezifische Regeln, Supply-Chain-Überprüfungen und Richtliniendurchsetzung, die das Plugin nicht versucht |

252 252

253Jede spätere Phase erfasst, was frühere übersehen. Der Wert des Plugins liegt darin, das Volumen zu reduzieren, das sie erreicht, nicht darin, die Notwendigkeit für sie zu beseitigen.253Jede spätere Phase erfasst, was frühere übersehen. Der Wert des Plugins liegt darin, das Volumen zu reduzieren, das sie erreicht, nicht darin, die Notwendigkeit für sie zu beseitigen.

270 270

271Um tiefer in die Themen einzusteigen, die diese Seite berührt:271Um tiefer in die Themen einzusteigen, die diese Seite berührt:

272 272

273* [Code Review](/de/code-review): Richten Sie die Multi-Agent-Überprüfung zur PR-Zeit ein273* [Code Review](/docs/de/code-review): Richten Sie die Multi-Agent-Überprüfung zur PR-Zeit ein

274* [Automatisieren Sie Workflows mit Hooks](/de/hooks-guide): Erstellen Sie Ihre eigenen Überprüfungen an den gleichen Lebenszykluspunkten274* [Automatisieren Sie Workflows mit Hooks](/docs/de/hooks-guide): Erstellen Sie Ihre eigenen Überprüfungen an den gleichen Lebenszykluspunkten

275* [Entdecken und installieren Sie Plugins](/de/discover-plugins#official-anthropic-marketplace): Durchsuchen Sie andere offizielle Plugins275* [Entdecken und installieren Sie Plugins](/docs/de/discover-plugins#official-anthropic-marketplace): Durchsuchen Sie andere offizielle Plugins

server-managed-settings.md +29 −29

Details

28 Wählen Sie zwischen serververwalteten und endpunktverwalteten Einstellungen28 Wählen Sie zwischen serververwalteten und endpunktverwalteten Einstellungen

29</h2>29</h2>

30 30

31Claude Code unterstützt zwei Ansätze für zentralisierte Konfiguration. Serververwaltete Einstellungen liefern Konfiguration von Anthropics Servern. [Endpunktverwaltete Einstellungen](/de/settings#settings-files) werden direkt auf Geräten über native Betriebssystemrichtlinien (macOS verwaltete Einstellungen, Windows-Registrierung) oder verwaltete Einstellungsdateien bereitgestellt.31Claude Code unterstützt zwei Ansätze für zentralisierte Konfiguration. Serververwaltete Einstellungen liefern Konfiguration von Anthropics Servern. [Endpunktverwaltete Einstellungen](/docs/de/settings#settings-files) werden direkt auf Geräten über native Betriebssystemrichtlinien (macOS verwaltete Einstellungen, Windows-Registrierung) oder verwaltete Einstellungsdateien bereitgestellt.

32 32

34| :------------------------------------------------------------------ | :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------- |34| :------------------------------------------------------------------ | :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------- |

35| **Serververwaltete Einstellungen** | Organisationen ohne MDM oder Benutzer auf nicht verwalteten Geräten | Einstellungen, die von Anthropics Servern zum Authentifizierungszeitpunkt bereitgestellt werden |35| **Serververwaltete Einstellungen** | Organisationen ohne MDM oder Benutzer auf nicht verwalteten Geräten | Einstellungen, die von Anthropics Servern zum Authentifizierungszeitpunkt bereitgestellt werden |

36| **[Endpunktverwaltete Einstellungen](/de/settings#settings-files)** | Organisationen mit MDM oder Endpunktverwaltung | Einstellungen, die auf Geräten über MDM-Konfigurationsprofile, Registrierungsrichtlinien oder verwaltete Einstellungsdateien bereitgestellt werden |36| **[Endpunktverwaltete Einstellungen](/docs/de/settings#settings-files)** | Organisationen mit MDM oder Endpunktverwaltung | Einstellungen, die auf Geräten über MDM-Konfigurationsprofile, Registrierungsrichtlinien oder verwaltete Einstellungsdateien bereitgestellt werden |

37 37

38Wenn Ihre Geräte in einer MDM- oder Endpunktverwaltungslösung registriert sind, bieten endpunktverwaltete Einstellungen stärkere Sicherheitsgarantien, da die Einstellungsdatei auf Betriebssystemebene vor Benutzermodifikationen geschützt werden kann. Endpunktverwaltete Einstellungen erreichen [Cloud-Sitzungen](/de/model-config#surface-coverage) nicht, daher sollten Organisationen, die Claude Code im Web verwenden, auch serververwaltete Einstellungen konfigurieren.38Wenn Ihre Geräte in einer MDM- oder Endpunktverwaltungslösung registriert sind, bieten endpunktverwaltete Einstellungen stärkere Sicherheitsgarantien, da die Einstellungsdatei auf Betriebssystemebene vor Benutzermodifikationen geschützt werden kann. Endpunktverwaltete Einstellungen erreichen [Cloud-Sitzungen](/docs/de/model-config#surface-coverage) nicht, daher sollten Organisationen, die Claude Code im Web verwenden, auch serververwaltete Einstellungen konfigurieren.

39 39

40<h2 id="configure-server-managed-settings">40<h2 id="configure-server-managed-settings">

41 Serververwaltete Einstellungen konfigurieren41 Serververwaltete Einstellungen konfigurieren

49 </Step>49 </Step>

50 50

51 <Step title="Definieren Sie Ihre Einstellungen">51 <Step title="Definieren Sie Ihre Einstellungen">

52 Fügen Sie Ihre Konfiguration als JSON hinzu. Alle [in `settings.json` verfügbaren Einstellungen](/de/settings#available-settings) werden unterstützt, mit Ausnahme derjenigen, die auf die Bereitstellung auf OS-Ebene beschränkt sind. Siehe [Aktuelle Einschränkungen](#current-limitations) für diese kurze Liste. Dies umfasst [hooks](/de/hooks), [Umgebungsvariablen](/de/env-vars) und [nur verwaltete Einstellungen](/de/permissions#managed-only-settings) wie `allowManagedPermissionRulesOnly`.52 Fügen Sie Ihre Konfiguration als JSON hinzu. Alle [in `settings.json` verfügbaren Einstellungen](/docs/de/settings#available-settings) werden unterstützt, mit Ausnahme derjenigen, die auf die Bereitstellung auf OS-Ebene beschränkt sind. Siehe [Aktuelle Einschränkungen](#current-limitations) für diese kurze Liste. Dies umfasst [hooks](/docs/de/hooks), [Umgebungsvariablen](/docs/de/env-vars) und [nur verwaltete Einstellungen](/docs/de/permissions#managed-only-settings) wie `allowManagedPermissionRulesOnly`.

53 53

54 Dieses Beispiel erzwingt eine Berechtigungsverweigerungsliste, verhindert, dass Benutzer Berechtigungen umgehen, und beschränkt Berechtigungsregeln auf diejenigen, die in verwalteten Einstellungen definiert sind:54 Dieses Beispiel erzwingt eine Berechtigungsverweigerungsliste, verhindert, dass Benutzer Berechtigungen umgehen, und beschränkt Berechtigungsregeln auf diejenigen, die in verwalteten Einstellungen definiert sind:

55 55

87 }87 }

88 ```88 ```

89 89

~~90 Um den [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) Klassifizierer zu konfigurieren, damit er weiß, welche Repos, Buckets und Domains Ihre Organisation vertraut:~~90 Um den [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) Klassifizierer zu konfigurieren, damit er weiß, welche Repos, Buckets und Domains Ihre Organisation vertraut:

91 91

92 ```json theme={null}92 ```json theme={null}

93 {93 {

101 }101 }

102 ```102 ```

103 103

104 Da Hooks Shell-Befehle ausführen, sehen Benutzer einen [Sicherheitsgenehmigungsdialog](#security-approval-dialogs), bevor sie angewendet werden. Siehe [Auto-Modus konfigurieren](/de/auto-mode-config), um zu erfahren, wie die `autoMode` Einträge beeinflussen, was der Klassifizierer blockiert, und wichtige Warnungen zu den Feldern `environment`, `allow`, `soft_deny` und `hard_deny`.104 Da Hooks Shell-Befehle ausführen, sehen Benutzer einen [Sicherheitsgenehmigungsdialog](#security-approval-dialogs), bevor sie angewendet werden. Siehe [Auto-Modus konfigurieren](/docs/de/auto-mode-config), um zu erfahren, wie die `autoMode` Einträge beeinflussen, was der Klassifizierer blockiert, und wichtige Warnungen zu den Feldern `environment`, `allow`, `soft_deny` und `hard_deny`.

105 </Step>105 </Step>

106 106

107 <Step title="Speichern und bereitstellen">107 <Step title="Speichern und bereitstellen">

130 Nur verwaltete Einstellungen130 Nur verwaltete Einstellungen

131</h3>131</h3>

132 132

133Die meisten [Einstellungsschlüssel](/de/settings#available-settings) funktionieren in jedem Bereich. Eine Handvoll Schlüssel werden nur aus verwalteten Einstellungen gelesen und haben keine Auswirkung, wenn sie in Benutzer- oder Projekteinstellungsdateien platziert werden. Siehe [nur verwaltete Einstellungen](/de/permissions#managed-only-settings) für die vollständige Liste. Jede Einstellung, die nicht auf dieser Liste steht, kann immer noch in verwalteten Einstellungen platziert werden und hat die höchste Priorität.133Die meisten [Einstellungsschlüssel](/docs/de/settings#available-settings) funktionieren in jedem Bereich. Eine Handvoll Schlüssel werden nur aus verwalteten Einstellungen gelesen und haben keine Auswirkung, wenn sie in Benutzer- oder Projekteinstellungsdateien platziert werden. Siehe [nur verwaltete Einstellungen](/docs/de/permissions#managed-only-settings) für die vollständige Liste. Jede Einstellung, die nicht auf dieser Liste steht, kann immer noch in verwalteten Einstellungen platziert werden und hat die höchste Priorität.

134 134

135<h3 id="current-limitations">135<h3 id="current-limitations">

136 Aktuelle Einschränkungen136 Aktuelle Einschränkungen

139Serververwaltete Einstellungen haben die folgenden Einschränkungen:139Serververwaltete Einstellungen haben die folgenden Einschränkungen:

140 140

141* Einstellungen gelten einheitlich für alle Benutzer in der Organisation. Konfigurationen pro Gruppe werden noch nicht unterstützt.141* Einstellungen gelten einheitlich für alle Benutzer in der Organisation. Konfigurationen pro Gruppe werden noch nicht unterstützt.

142* Eine [`managed-mcp.json`](/de/managed-mcp) Datei kann nicht über serververwaltete Einstellungen verteilt werden. Stellen Sie stattdessen die Richtlinienschlüssel `allowedMcpServers` und `deniedMcpServers` dort bereit.142* Eine [`managed-mcp.json`](/docs/de/managed-mcp) Datei kann nicht über serververwaltete Einstellungen verteilt werden. Stellen Sie stattdessen die Richtlinienschlüssel `allowedMcpServers` und `deniedMcpServers` dort bereit.

143* Einstellungen, die auf OS-Ebene-Richtlinienquellen beschränkt sind, wie `policyHelper` und `wslInheritsWindowsSettings`, werden nicht berücksichtigt. Stellen Sie sie stattdessen über MDM oder eine System-Datei `managed-settings.json` bereit.143* Einstellungen, die auf OS-Ebene-Richtlinienquellen beschränkt sind, wie `policyHelper` und `wslInheritsWindowsSettings`, werden nicht berücksichtigt. Stellen Sie sie stattdessen über MDM oder eine System-Datei `managed-settings.json` bereit.

144 144

145<h2 id="settings-delivery">145<h2 id="settings-delivery">

150 Einstellungspriorität150 Einstellungspriorität

151</h3>151</h3>

152 152

153Serververwaltete Einstellungen und [endpunktverwaltete Einstellungen](/de/settings#settings-files) nehmen beide die höchste Ebene in der Claude Code [Einstellungshierarchie](/de/settings#settings-precedence) ein. Keine andere Einstellungsebene kann sie überschreiben, einschließlich Befehlszeilenargumenten.153Serververwaltete Einstellungen und [endpunktverwaltete Einstellungen](/docs/de/settings#settings-files) nehmen beide die höchste Ebene in der Claude Code [Einstellungshierarchie](/docs/de/settings#settings-precedence) ein. Keine andere Einstellungsebene kann sie überschreiben, einschließlich Befehlszeilenargumenten.

154 154

155Innerhalb der verwalteten Ebene gewinnt eine konfigurierte [`policyHelper`](/de/settings#compute-managed-settings-with-a-policy-helper) vor jeder anderen verwalteten Quelle, einschließlich serververwalteter Einstellungen: Ihre Ausgabe wird die einzige verwaltete Konfiguration für den Lauf.155Innerhalb der verwalteten Ebene gewinnt eine konfigurierte [`policyHelper`](/docs/de/settings#compute-managed-settings-with-a-policy-helper) vor jeder anderen verwalteten Quelle, einschließlich serververwalteter Einstellungen: Ihre Ausgabe wird die einzige verwaltete Konfiguration für den Lauf.

156 156

157Andernfalls verwendet Claude Code die erste Quelle, die eine nicht leere Konfiguration liefert. Serververwaltete Einstellungen werden zuerst überprüft, dann endpunktverwaltete Einstellungen. Quellen werden nicht zusammengeführt: Wenn serververwaltete Einstellungen überhaupt Schlüssel liefern, werden andere endpunktverwaltete Einstellungen ignoriert. Wenn serververwaltete Einstellungen nichts liefern, gelten endpunktverwaltete Einstellungen.157Andernfalls verwendet Claude Code die erste Quelle, die eine nicht leere Konfiguration liefert. Serververwaltete Einstellungen werden zuerst überprüft, dann endpunktverwaltete Einstellungen. Quellen werden nicht zusammengeführt: Wenn serververwaltete Einstellungen überhaupt Schlüssel liefern, werden andere endpunktverwaltete Einstellungen ignoriert. Wenn serververwaltete Einstellungen nichts liefern, gelten endpunktverwaltete Einstellungen.

158 158

159Eine Ausnahme gilt: Ein kleiner Satz von [quellübergreifenden Sperr-Schlüsseln](/de/settings#settings-precedence), wie die Sandbox-Zulassungslisten-Sperren, wird berücksichtigt, wenn eine beliebige administratorgesteuerte verwaltete Quelle sie setzt; die benutzerbare HKCU-Registrierungsebene ist ausgeschlossen.159Eine Ausnahme gilt: Ein kleiner Satz von [quellübergreifenden Sperr-Schlüsseln](/docs/de/settings#settings-precedence), wie die Sandbox-Zulassungslisten-Sperren, wird berücksichtigt, wenn eine beliebige administratorgesteuerte verwaltete Quelle sie setzt; die benutzerbare HKCU-Registrierungsebene ist ausgeschlossen.

160 160

161Wenn Sie Ihre serververwaltete Konfiguration in der Admin-Konsole mit der Absicht löschen, auf eine endpunktverwaltete plist oder Registrierungsrichtlinie zurückzugreifen, beachten Sie, dass [zwischengespeicherte Einstellungen](#fetch-and-caching-behavior) auf Client-Maschinen bestehen bleiben, bis der nächste erfolgreiche Abruf erfolgt. Führen Sie `/status` aus, um zu sehen, welche verwaltete Quelle aktiv ist.161Wenn Sie Ihre serververwaltete Konfiguration in der Admin-Konsole mit der Absicht löschen, auf eine endpunktverwaltete plist oder Registrierungsrichtlinie zurückzugreifen, beachten Sie, dass [zwischengespeicherte Einstellungen](#fetch-and-caching-behavior) auf Client-Maschinen bestehen bleiben, bis der nächste erfolgreiche Abruf erfolgt. Führen Sie `/status` aus, um zu sehen, welche verwaltete Quelle aktiv ist.

162 162

178* Claude Code ruft frische Einstellungen im Hintergrund ab178* Claude Code ruft frische Einstellungen im Hintergrund ab

179* Zwischengespeicherte Einstellungen bleiben bei Netzwerkfehlern erhalten. Die zurückhaltenden Umgebungsvariablen bleiben zurückhaltend, bis ein Abruf erfolgreich ist179* Zwischengespeicherte Einstellungen bleiben bei Netzwerkfehlern erhalten. Die zurückhaltenden Umgebungsvariablen bleiben zurückhaltend, bis ein Abruf erfolgreich ist

180 180

181Ab v2.1.198 hält Claude Code drei Kategorien von Variablen im zwischengespeicherten `env`-Block zurück, bis der Server die Payload für die Sitzung bestätigt. Dies verhindert, dass ein zwischengespeicherter Proxy-, Zertifizierungsstellen-, Endpunkt- oder Anmeldedatenwert den Einstellungsabruf umleitet, abfängt oder erneut authentifiziert, der die Payload bestätigt. Die Härtung gilt nur für den vom Server abgerufenen Einstellungs-Cache: [endpunktverwaltete Einstellungen](/de/settings#settings-files), die über MDM oder `managed-settings.json` bereitgestellt werden, sind nicht betroffen. Die zurückhaltenden Kategorien sind:181Ab v2.1.198 hält Claude Code drei Kategorien von Variablen im zwischengespeicherten `env`-Block zurück, bis der Server die Payload für die Sitzung bestätigt. Dies verhindert, dass ein zwischengespeicherter Proxy-, Zertifizierungsstellen-, Endpunkt- oder Anmeldedatenwert den Einstellungsabruf umleitet, abfängt oder erneut authentifiziert, der die Payload bestätigt. Die Härtung gilt nur für den vom Server abgerufenen Einstellungs-Cache: [endpunktverwaltete Einstellungen](/docs/de/settings#settings-files), die über MDM oder `managed-settings.json` bereitgestellt werden, sind nicht betroffen. Die zurückhaltenden Kategorien sind:

182 182

183* Proxy- und TLS-Konfiguration, wie `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` und die mTLS-Client-Zertifikatvariablen `CLAUDE_CODE_CLIENT_CERT` und `CLAUDE_CODE_CLIENT_KEY`183* Proxy- und TLS-Konfiguration, wie `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` und die mTLS-Client-Zertifikatvariablen `CLAUDE_CODE_CLIENT_CERT` und `CLAUDE_CODE_CLIENT_KEY`

184* API-Routing und Anbieterauswahl, einschließlich `ANTHROPIC_BASE_URL`, der Anbieterauswahlvariablen wie `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_VERTEX` und der Anbieter-Endpunkt-URLs wie `ANTHROPIC_BEDROCK_BASE_URL`184* API-Routing und Anbieterauswahl, einschließlich `ANTHROPIC_BASE_URL`, der Anbieterauswahlvariablen wie `CLAUDE_CODE_USE_BEDROCK` und `CLAUDE_CODE_USE_VERTEX` und der Anbieter-Endpunkt-URLs wie `ANTHROPIC_BEDROCK_BASE_URL`

186 186

187Jeder andere Schlüssel im zwischengespeicherten `env`-Block, wie Telemetrie- und OpenTelemetry-Konfiguration, wird beim Start wie zuvor angewendet. Sobald der Abruf erfolgreich ist, werden die zurückhaltenden Variablen für den Rest der Sitzung angewendet.187Jeder andere Schlüssel im zwischengespeicherten `env`-Block, wie Telemetrie- und OpenTelemetry-Konfiguration, wird beim Start wie zuvor angewendet. Sobald der Abruf erfolgreich ist, werden die zurückhaltenden Variablen für den Rest der Sitzung angewendet.

188 188

189Wenn Ihre Organisation einen Proxy benötigt, um `api.anthropic.com` zu erreichen, setzen Sie ihn in der Shell-Umgebung oder in [Benutzereinstellungen](/de/settings#settings-files) anstatt nur im verwalteten `env`-Block. Der erste Start hat keinen Cache, daher waren diese Quellen bereits für den anfänglichen Abruf erforderlich.189Wenn Ihre Organisation einen Proxy benötigt, um `api.anthropic.com` zu erreichen, setzen Sie ihn in der Shell-Umgebung oder in [Benutzereinstellungen](/docs/de/settings#settings-files) anstatt nur im verwalteten `env`-Block. Der erste Start hat keinen Cache, daher waren diese Quellen bereits für den anfänglichen Abruf erforderlich.

190 190

191Claude Code wendet Einstellungsaktualisierungen automatisch ohne Neustart an, außer für erweiterte Einstellungen wie OpenTelemetry-Konfiguration, die einen vollständigen Neustart erfordern, um wirksam zu werden.191Claude Code wendet Einstellungsaktualisierungen automatisch ohne Neustart an, außer für erweiterte Einstellungen wie OpenTelemetry-Konfiguration, die einen vollständigen Neustart erfordern, um wirksam zu werden.

192 192

194 Ungültige Einträge in bereitgestellten Einstellungen194 Ungültige Einträge in bereitgestellten Einstellungen

195</h3>195</h3>

196 196

197Bereitgestellte Payloads werden tolerant mit den gleichen Regeln wie die anderen verwalteten Quellen analysiert. Wenn eine Payload einen Eintrag enthält, der die Schemavalidierung nicht besteht, entfernt Claude Code diesen Eintrag, zeigt einen Validierungsfehler an und wendet alle verbleibenden gültigen Einstellungen an. Siehe [Ungültige Einträge in verwalteten Einstellungen](/de/settings#invalid-entries-in-managed-settings) für das Verhalten auf Feldebene, einschließlich der Behandlung von Sicherheitserzwingungsfeldern. Erfordert Claude Code v2.1.169 oder später.197Bereitgestellte Payloads werden tolerant mit den gleichen Regeln wie die anderen verwalteten Quellen analysiert. Wenn eine Payload einen Eintrag enthält, der die Schemavalidierung nicht besteht, entfernt Claude Code diesen Eintrag, zeigt einen Validierungsfehler an und wendet alle verbleibenden gültigen Einstellungen an. Siehe [Ungültige Einträge in verwalteten Einstellungen](/docs/de/settings#invalid-entries-in-managed-settings) für das Verhalten auf Feldebene, einschließlich der Behandlung von Sicherheitserzwingungsfeldern. Erfordert Claude Code v2.1.169 oder später.

198 198

199Die serververwaltete Bereitstellung fügt diese Verhaltensweisen hinzu:199Die serververwaltete Bereitstellung fügt diese Verhaltensweisen hinzu:

200 200

220}220}

221```221```

222 222

223Sie können diesen Schlüssel auch in einem [endpunktverwalteten](/de/settings#settings-files) MDM-Profil oder einer System-Datei `managed-settings.json` setzen, um Fail-Closed-Verhalten beim ersten Start durchzusetzen, bevor eine Server-Payload bereitgestellt wurde. Ab v2.1.191 ist dieses Flag eine Ausnahme von der [Prioritätsregel](#settings-precedence) oben: Es wird berücksichtigt, wenn es in einer beliebigen verwalteten Quelle gesetzt ist, auch wenn eine zwischengespeicherte Server-verwaltete Payload vorhanden ist, sodass ein MDM-bereitgestellter Wert nicht ignoriert wird, wenn serververwaltete Einstellungen vorhanden sind.223Sie können diesen Schlüssel auch in einem [endpunktverwalteten](/docs/de/settings#settings-files) MDM-Profil oder einer System-Datei `managed-settings.json` setzen, um Fail-Closed-Verhalten beim ersten Start durchzusetzen, bevor eine Server-Payload bereitgestellt wurde. Ab v2.1.191 ist dieses Flag eine Ausnahme von der [Prioritätsregel](#settings-precedence) oben: Es wird berücksichtigt, wenn es in einer beliebigen verwalteten Quelle gesetzt ist, auch wenn eine zwischengespeicherte Server-verwaltete Payload vorhanden ist, sodass ein MDM-bereitgestellter Wert nicht ignoriert wird, wenn serververwaltete Einstellungen vorhanden sind.

224 224

225Der Einstellungsabruf sendet auch einen `Cache-Control: no-cache` Header, sodass zwischengeschaltete HTTP-Proxys keine veraltete Antwort bereitstellen.225Der Einstellungsabruf sendet auch einen `Cache-Control: no-cache` Header, sodass zwischengeschaltete HTTP-Proxys keine veraltete Antwort bereitstellen.

226 226

249 Plattformverfügbarkeit249 Plattformverfügbarkeit

250</h2>250</h2>

251 251

252Serververwaltete Einstellungen erfordern eine direkte Verbindung zu `api.anthropic.com`, und die Bereitstellung erfordert, dass sich die Sitzung mit einem Organisations-OAuth-Login oder einem direkt konfigurierten API-Schlüssel authentifiziert. Schlüssel, die von einem [`apiKeyHelper`](/de/settings#available-settings)-Skript zurückgegeben werden, lösen den Abruf der Einstellungen nicht aus.252Serververwaltete Einstellungen erfordern eine direkte Verbindung zu `api.anthropic.com`, und die Bereitstellung erfordert, dass sich die Sitzung mit einem Organisations-OAuth-Login oder einem direkt konfigurierten API-Schlüssel authentifiziert. Schlüssel, die von einem [`apiKeyHelper`](/docs/de/settings#available-settings)-Skript zurückgegeben werden, lösen den Abruf der Einstellungen nicht aus.

253 253

254Serververwaltete Einstellungen sind nicht verfügbar, wenn Drittanbieter-Modellprovider verwendet werden:254Serververwaltete Einstellungen sind nicht verfügbar, wenn Drittanbieter-Modellprovider verwendet werden:

255 255

256* Amazon Bedrock256* Amazon Bedrock

257* Google Cloud's Agent Platform257* Google Cloud's Agent Platform

258* Microsoft Foundry258* Microsoft Foundry

259* [Claude Platform on AWS](/de/claude-platform-on-aws)259* [Claude Platform on AWS](/docs/de/claude-platform-on-aws)

260* Benutzerdefinierte API-Endpunkte über `ANTHROPIC_BASE_URL` oder Drittanbieter-[LLM-Gateways](/de/llm-gateway)260* Benutzerdefinierte API-Endpunkte über `ANTHROPIC_BASE_URL` oder Drittanbieter-[LLM-Gateways](/docs/de/llm-gateway)

261 261

262Wenn Sie eine `CLAUDE_CODE_USE_*`-Providervariable oder eine nicht standardmäßige `ANTHROPIC_BASE_URL` in Ihrer Shell exportieren, überspringt Claude Code den Abruf der Einstellungen für Ihre Sitzungen. Sie können den Export nicht mit einem serververwalteten `env`-Block löschen, da der Block durch den Abruf ankommt, den der Export verhindert. Ein [endpunktverwalteter Einstellungen](/de/settings#settings-files)-`env`-Block stellt den Abruf auch nicht wieder her: Claude Code prüft die Berechtigung, bevor es verwaltete `env`-Blöcke anwendet, sodass die Überschreibung die Providerauswahl der Sitzung ändert, aber der Abruf bleibt übersprungen.262Wenn Sie eine `CLAUDE_CODE_USE_*`-Providervariable oder eine nicht standardmäßige `ANTHROPIC_BASE_URL` in Ihrer Shell exportieren, überspringt Claude Code den Abruf der Einstellungen für Ihre Sitzungen. Sie können den Export nicht mit einem serververwalteten `env`-Block löschen, da der Block durch den Abruf ankommt, den der Export verhindert. Ein [endpunktverwalteter Einstellungen](/docs/de/settings#settings-files)-`env`-Block stellt den Abruf auch nicht wieder her: Claude Code prüft die Berechtigung, bevor es verwaltete `env`-Blöcke anwendet, sodass die Überschreibung die Providerauswahl der Sitzung ändert, aber der Abruf bleibt übersprungen.

263 263

264Um die serververwaltete Bereitstellung wiederherzustellen, entfernen Sie den Export aus Ihrer Shell, oder setzen Sie die Variable auf `""` in Ihrem Benutzereinstellungen-`env`-Block, der vor der Berechtigungsprüfung angewendet wird. Um eine Richtlinie durchzusetzen, ohne sich auf Benutzer zu verlassen, die ihre Shells ändern, stellen Sie die Einstellungen stattdessen über den endpunktverwalteten Kanal bereit.264Um die serververwaltete Bereitstellung wiederherzustellen, entfernen Sie den Export aus Ihrer Shell, oder setzen Sie die Variable auf `""` in Ihrem Benutzereinstellungen-`env`-Block, der vor der Berechtigungsprüfung angewendet wird. Um eine Richtlinie durchzusetzen, ohne sich auf Benutzer zu verlassen, die ihre Shells ändern, stellen Sie die Einstellungen stattdessen über den endpunktverwalteten Kanal bereit.

265 265

266Für Amazon Bedrock-, Google Cloud's Agent Platform- und Microsoft Foundry-Bereitstellungen bietet ein selbstgehostetes [Claude-Apps-Gateway](/de/claude-apps-gateway) die entsprechende Remote-Verwaltung von Einstellungen: Mit dem Gateway angemeldete Clients rufen verwaltete Einstellungen vom Gateway statt von `api.anthropic.com` ab. Die Fehlerbehandlung unterscheidet sich beim Start: Ein Gateway-Client, der das Gateway nicht erreichen kann, beendet sich mit einem Fehler, anstatt auf zwischengespeicherte Einstellungen zurückzugreifen, während die stündliche Hintergrundaktualisierung auf beiden Kanälen fehleroffen ist.266Für Amazon Bedrock-, Google Cloud's Agent Platform- und Microsoft Foundry-Bereitstellungen bietet ein selbstgehostetes [Claude-Apps-Gateway](/docs/de/claude-apps-gateway) die entsprechende Remote-Verwaltung von Einstellungen: Mit dem Gateway angemeldete Clients rufen verwaltete Einstellungen vom Gateway statt von `api.anthropic.com` ab. Die Fehlerbehandlung unterscheidet sich beim Start: Ein Gateway-Client, der das Gateway nicht erreichen kann, beendet sich mit einem Fehler, anstatt auf zwischengespeicherte Einstellungen zurückzugreifen, während die stündliche Hintergrundaktualisierung auf beiden Kanälen fehleroffen ist.

267 267

268<h2 id="audit-logging">268<h2 id="audit-logging">

269 Audit-Protokollierung269 Audit-Protokollierung

280Serververwaltete Einstellungen bieten zentralisierte Richtliniendurchsetzung, funktionieren aber als clientseitige Kontrolle, nicht als Sicherheitsgrenze. Auf nicht verwalteten Geräten benötigt ein Benutzer keinen Admin- oder Sudo-Zugriff, um diese zu umgehen.280Serververwaltete Einstellungen bieten zentralisierte Richtliniendurchsetzung, funktionieren aber als clientseitige Kontrolle, nicht als Sicherheitsgrenze. Auf nicht verwalteten Geräten benötigt ein Benutzer keinen Admin- oder Sudo-Zugriff, um diese zu umgehen.

281 281

283| :--------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |283| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

284| Benutzer bearbeitet die zwischengespeicherte Einstellungsdatei | Manipulierte Datei wird beim Start angewendet, aber korrekte Einstellungen werden beim nächsten Serverfetch wiederhergestellt. {/* min-version: 2.1.198 */}Ab v2.1.198 werden die Transport-, API-Routing- und Authentifizierungs-Umgebungsvariablen im `env`-Block [zurückgehalten, bis der Server die Nutzlast bestätigt](#fetch-and-caching-behavior) |284| Benutzer bearbeitet die zwischengespeicherte Einstellungsdatei | Manipulierte Datei wird beim Start angewendet, aber korrekte Einstellungen werden beim nächsten Serverfetch wiederhergestellt. Ab v2.1.198 werden die Transport-, API-Routing- und Authentifizierungs-Umgebungsvariablen im `env`-Block [zurückgehalten, bis der Server die Nutzlast bestätigt](#fetch-and-caching-behavior) |

285| Benutzer löscht die zwischengespeicherte Einstellungsdatei | Verhalten beim ersten Start tritt auf: Einstellungen werden asynchron abgerufen mit einem kurzen nicht erzwungenen Fenster |285| Benutzer löscht die zwischengespeicherte Einstellungsdatei | Verhalten beim ersten Start tritt auf: Einstellungen werden asynchron abgerufen mit einem kurzen nicht erzwungenen Fenster |

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

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

288| API ist nicht verfügbar | Zwischengespeicherte Einstellungen werden angewendet, falls verfügbar, andernfalls werden verwaltete Einstellungen nicht erzwungen, bis der nächste erfolgreiche Abruf erfolgt. {/* min-version: 2.1.198 */}Ab v2.1.198 werden die Transport-, API-Routing- und Authentifizierungs-Umgebungsvariablen im zwischengespeicherten `env`-Block [bei Abruffehler zurückgehalten](#fetch-and-caching-behavior); der Rest des Caches wird weiterhin angewendet. Mit `forceRemoteSettingsRefresh: true` wird die CLI stattdessen beendet, außer für [`claude auth` Unterbefehle](#enforce-fail-closed-startup) |288| API ist nicht verfügbar | Zwischengespeicherte Einstellungen werden angewendet, falls verfügbar, andernfalls werden verwaltete Einstellungen nicht erzwungen, bis der nächste erfolgreiche Abruf erfolgt. Ab v2.1.198 werden die Transport-, API-Routing- und Authentifizierungs-Umgebungsvariablen im zwischengespeicherten `env`-Block [bei Abruffehler zurückgehalten](#fetch-and-caching-behavior); der Rest des Caches wird weiterhin angewendet. Mit `forceRemoteSettingsRefresh: true` wird die CLI stattdessen beendet, außer für [`claude auth` Unterbefehle](#enforce-fail-closed-startup) |

289| Benutzer authentifiziert sich mit einer anderen Organisation | Einstellungen werden nicht für Konten außerhalb der verwalteten Organisation bereitgestellt |289| Benutzer authentifiziert sich mit einer anderen Organisation | Einstellungen werden nicht für Konten außerhalb der verwalteten Organisation bereitgestellt |

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

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

292 292

293Um Laufzeitkonfigurationsänderungen zu erkennen, verwenden Sie [`ConfigChange` hooks](/de/hooks#configchange), um Änderungen zu protokollieren oder nicht autorisierte Änderungen zu blockieren, bevor sie wirksam werden.293Um Laufzeitkonfigurationsänderungen zu erkennen, verwenden Sie [`ConfigChange` hooks](/docs/de/hooks#configchange), um Änderungen zu protokollieren oder nicht autorisierte Änderungen zu blockieren, bevor sie wirksam werden.

294 294

295Um einzuschränken, auf welche Organisationen Ihre Benutzer mit den vom Client bereitgestellten Anmeldedaten zugreifen können, siehe [Netzwerkzugriffskontrolle mit Tenant Restrictions durchsetzen](https://support.claude.com/en/articles/13198485-enforce-network-level-access-control-with-tenant-restrictions) im Claude Help Center. Für stärkere Durchsetzungsgarantien verwenden Sie [endpunktverwaltete Einstellungen](/de/settings#settings-files) auf Geräten, die in einer MDM-Lösung registriert sind.295Um einzuschränken, auf welche Organisationen Ihre Benutzer mit den vom Client bereitgestellten Anmeldedaten zugreifen können, siehe [Netzwerkzugriffskontrolle mit Tenant Restrictions durchsetzen](https://support.claude.com/en/articles/13198485-enforce-network-level-access-control-with-tenant-restrictions) im Claude Help Center. Für stärkere Durchsetzungsgarantien verwenden Sie [endpunktverwaltete Einstellungen](/docs/de/settings#settings-files) auf Geräten, die in einer MDM-Lösung registriert sind.

296 296

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

298 Siehe auch298 Siehe auch

300 300

301Verwandte Seiten zur Verwaltung der Claude Code-Konfiguration:301Verwandte Seiten zur Verwaltung der Claude Code-Konfiguration:

302 302

303* [Einstellungen](/de/settings): vollständige Konfigurationsreferenz einschließlich aller verfügbaren Einstellungen303* [Einstellungen](/docs/de/settings): vollständige Konfigurationsreferenz einschließlich aller verfügbaren Einstellungen

304* [Endpunktverwaltete Einstellungen](/de/settings#settings-files): verwaltete Einstellungen, die von der IT auf Geräten bereitgestellt werden304* [Endpunktverwaltete Einstellungen](/docs/de/settings#settings-files): verwaltete Einstellungen, die von der IT auf Geräten bereitgestellt werden

305* [Authentifizierung](/de/authentication): Einrichtung des Benutzerzugriffs auf Claude Code305* [Authentifizierung](/docs/de/authentication): Einrichtung des Benutzerzugriffs auf Claude Code

306* [Sicherheit](/de/security): Sicherheitsvorkehrungen und Best Practices306* [Sicherheit](/docs/de/security): Sicherheitsvorkehrungen und Best Practices

sessions.md +21 −21

Details

8 8

9Eine Sitzung ist ein gespeichertes Gespräch, das an ein Projektverzeichnis gebunden ist. Claude Code speichert es lokal während Sie arbeiten, sodass Sie dort weitermachen können, wo Sie aufgehört haben, zu einem anderen Ansatz verzweigen oder zwischen Aufgaben wechseln können.9Eine Sitzung ist ein gespeichertes Gespräch, das an ein Projektverzeichnis gebunden ist. Claude Code speichert es lokal während Sie arbeiten, sodass Sie dort weitermachen können, wo Sie aufgehört haben, zu einem anderen Ansatz verzweigen oder zwischen Aufgaben wechseln können.

10 10

11Die [Desktop-App](/de/desktop#work-in-parallel-with-sessions), [Claude Code im Web](/de/claude-code-on-the-web) und die [VS Code-Erweiterung](/de/vs-code#resume-past-conversations) verwalten jeweils ihre eigene Sitzungsverlauf. Diese Seite behandelt die CLI.11Die [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions), [Claude Code im Web](/docs/de/claude-code-on-the-web) und die [VS Code-Erweiterung](/docs/de/vs-code#resume-past-conversations) verwalten jeweils ihre eigene Sitzungsverlauf. Diese Seite behandelt die CLI.

12 12

13<h2 id="resume-a-session">13<h2 id="resume-a-session">

14 Sitzung fortsetzen14 Sitzung fortsetzen

24| `claude --from-pr <number>` | Setzt die mit diesem Pull Request verknüpfte Sitzung fort |24| `claude --from-pr <number>` | Setzt die mit diesem Pull Request verknüpfte Sitzung fort |

25| `/resume` | Wechselt zu einem anderen Gespräch innerhalb einer aktiven Sitzung |25| `/resume` | Wechselt zu einem anderen Gespräch innerhalb einer aktiven Sitzung |

26 26

27Sitzungen, die mit [`claude -p`](/de/headless) oder dem [Agent SDK](/de/agent-sdk/overview) erstellt wurden, werden nicht in der Sitzungsauswahl angezeigt, aber Sie können eine trotzdem fortsetzen, indem Sie ihre Sitzungs-ID an `claude --resume <session-id>` übergeben. Führen Sie dies aus dem Verzeichnis aus, in dem die Sitzung gestartet wurde: Die Sitzungs-ID-Suche ist auf das aktuelle Projektverzeichnis und seine Git Worktrees beschränkt, daher meldet eine anderswo erstellte Sitzung `No conversation found with session ID: <session-id>`.27Sitzungen, die mit [`claude -p`](/docs/de/headless) oder dem [Agent SDK](/docs/de/agent-sdk/overview) erstellt wurden, werden nicht in der Sitzungsauswahl angezeigt, aber Sie können eine trotzdem fortsetzen, indem Sie ihre Sitzungs-ID an `claude --resume <session-id>` übergeben. Führen Sie dies aus dem Verzeichnis aus, in dem die Sitzung gestartet wurde: Die Sitzungs-ID-Suche ist auf das aktuelle Projektverzeichnis und seine Git Worktrees beschränkt, daher meldet eine anderswo erstellte Sitzung `No conversation found with session ID: <session-id>`.

28 28

29<h3 id="where-the-session-picker-looks">29<h3 id="where-the-session-picker-looks">

30 Wo die Sitzungsauswahl sucht30 Wo die Sitzungsauswahl sucht

32 32

33Sitzungen werden pro Projektverzeichnis gespeichert. Standardmäßig zeigt die Sitzungsauswahl interaktive Sitzungen aus dem aktuellen Worktree sowie Sitzungen, die anderswo gestartet wurden und das aktuelle Verzeichnis mit `/add-dir` hinzugefügt haben. Verwenden Sie `Ctrl+W`, um auf alle Worktrees des Repositorys zu erweitern, oder `Ctrl+A`, um auf jedes Projekt auf dieser Maschine zu erweitern.33Sitzungen werden pro Projektverzeichnis gespeichert. Standardmäßig zeigt die Sitzungsauswahl interaktive Sitzungen aus dem aktuellen Worktree sowie Sitzungen, die anderswo gestartet wurden und das aktuelle Verzeichnis mit `/add-dir` hinzugefügt haben. Verwenden Sie `Ctrl+W`, um auf alle Worktrees des Repositorys zu erweitern, oder `Ctrl+A`, um auf jedes Projekt auf dieser Maschine zu erweitern.

34 34

35{/* min-version: 2.1.169 */}Ab v2.1.169 verschiebt das Verschieben einer Sitzung mit [`/cd`](/de/commands) diese in den Projektspeicher des neuen Verzeichnisses, sodass sie danach in der Auswahl dieses Verzeichnisses angezeigt wird. {/* min-version: 2.1.196 */}Ab v2.1.196 bleibt eine verschobene Sitzung aus der Auswahl des alten Verzeichnisses ausgeschlossen, auch nach einem Absturz oder erzwungenen Beenden. In früheren Versionen konnte sie auch nach einem nicht sauberen Beenden in der Liste des alten Verzeichnisses erneut angezeigt werden, wenn der alte Pfad Sonderzeichen wie Unterstriche enthielt.35Ab v2.1.169 verschiebt das Verschieben einer Sitzung mit [`/cd`](/docs/de/commands) diese in den Projektspeicher des neuen Verzeichnisses, sodass sie danach in der Auswahl dieses Verzeichnisses angezeigt wird. Ab v2.1.196 bleibt eine verschobene Sitzung aus der Auswahl des alten Verzeichnisses ausgeschlossen, auch nach einem Absturz oder erzwungenen Beenden. In früheren Versionen konnte sie auch nach einem nicht sauberen Beenden in der Liste des alten Verzeichnisses erneut angezeigt werden, wenn der alte Pfad Sonderzeichen wie Unterstriche enthielt.

36 36

37Das Auswählen einer Sitzung aus einem anderen Worktree desselben Repositorys setzt sie an Ort und Stelle fort. Das Auswählen einer Sitzung aus einem nicht verwandten Projekt kopiert stattdessen einen `cd`- und Resume-Befehl in Ihre Zwischenablage.37Das Auswählen einer Sitzung aus einem anderen Worktree desselben Repositorys setzt sie an Ort und Stelle fort. Das Auswählen einer Sitzung aus einem nicht verwandten Projekt kopiert stattdessen einen `cd`- und Resume-Befehl in Ihre Zwischenablage.

38 38

57| Bei Plan-Annahme | Das Akzeptieren eines Plans im [Plan-Modus](/de/permission-modes#analyze-before-you-edit-with-plan-mode) benennt die Sitzung aus dem Plan-Inhalt, es sei denn, Sie haben bereits einen Namen festgelegt |57| Bei Plan-Annahme | Das Akzeptieren eines Plans im [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) benennt die Sitzung aus dem Plan-Inhalt, es sei denn, Sie haben bereits einen Namen festgelegt |

58 58

59Sobald eine Sitzung benannt ist, kehren Sie mit `claude --resume <name>` oder `/resume <name>` zu ihr zurück. Siehe [Sitzung fortsetzen](#resume-a-session), um zu erfahren, wie die Namensauflösung über Worktrees hinweg funktioniert.59Sobald eine Sitzung benannt ist, kehren Sie mit `claude --resume <name>` oder `/resume <name>` zu ihr zurück. Siehe [Sitzung fortsetzen](#resume-a-session), um zu erfahren, wie die Namensauflösung über Worktrees hinweg funktioniert.

60 60

61{/* min-version: 2.1.196 */}Interaktive Sitzungen, die Sie nie benennen, erhalten beim Start automatisch einen Standard-Anzeigenamen. Erfordert Claude Code v2.1.196 oder später. Der Standard kombiniert den Namen des Arbeitsverzeichnisses mit einem zweistelligen Suffix, beispielsweise `my-app-3f`, und identifiziert die Sitzung in Auflistungen laufender Sitzungen, wie z. B. [Agent-Ansicht](/de/agent-view) und `claude agents --json` Ausgabe.61Interaktive Sitzungen, die Sie nie benennen, erhalten beim Start automatisch einen Standard-Anzeigenamen. Erfordert Claude Code v2.1.196 oder später. Der Standard kombiniert den Namen des Arbeitsverzeichnisses mit einem zweistelligen Suffix, beispielsweise `my-app-3f`, und identifiziert die Sitzung in Auflistungen laufender Sitzungen, wie z. B. [Agent-Ansicht](/docs/de/agent-view) und `claude agents --json` Ausgabe.

62 62

63Der Standard ist kein Resume-Handle: `claude --resume <name>`, `/resume <name>` und die Sitzungsauswahl stimmen nur mit Namen überein, die Sie festgelegt haben. Das Benennen der Sitzung ersetzt den Standard.63Der Standard ist kein Resume-Handle: `claude --resume <name>`, `/resume <name>` und die Sitzungsauswahl stimmen nur mit Namen überein, die Sie festgelegt haben. Das Benennen der Sitzung ersetzt den Standard.

64 64

97/branch try-streaming-approach97/branch try-streaming-approach

98```98```

99 99

100Wenn Sie den Namen weglassen, benennt Claude Code den neuen Branch nach der ersten Eingabeaufforderung im Gespräch. Ab v2.1.198 gilt dies auch nach [Komprimierung](/de/how-claude-code-works#when-context-fills-up); frühere Versionen fielen auf den wörtlichen Namen `Branched conversation` zurück, anstatt die Komprimierungszusammenfassung zu überschreiten, um die ursprüngliche erste Eingabeaufforderung zu finden.100Wenn Sie den Namen weglassen, benennt Claude Code den neuen Branch nach der ersten Eingabeaufforderung im Gespräch. Ab v2.1.198 gilt dies auch nach [Komprimierung](/docs/de/how-claude-code-works#when-context-fills-up); frühere Versionen fielen auf den wörtlichen Namen `Branched conversation` zurück, anstatt die Komprimierungszusammenfassung zu überschreiten, um die ursprüngliche erste Eingabeaufforderung zu finden.

101 101

102Kombinieren Sie von der Befehlszeile aus `--continue` oder `--resume` mit `--fork-session`:102Kombinieren Sie von der Befehlszeile aus `--continue` oder `--resume` mit `--fork-session`:

103 103

107 107

108Die ursprüngliche Sitzung bleibt unverändert und bleibt in der Sitzungsauswahl verfügbar. Die `/branch`-Bestätigung gibt zwei Sitzungs-IDs aus: den neuen Branch, in dem Sie sich jetzt befinden, und das Original. Um zum Original zurückzukehren, übergeben Sie seine ID an `/resume`, verwenden Sie die Sitzungsauswahl oder führen Sie `/resume <original-name>` aus. Berechtigungen, die Sie mit „für diese Sitzung zulassen" genehmigt haben, werden nicht auf den neuen Branch übertragen. Wenn Sie dieselbe Sitzung in zwei Terminals ohne Verzweigung fortsetzen, werden Nachrichten von beiden in ein Transkript verschachtelt.108Die ursprüngliche Sitzung bleibt unverändert und bleibt in der Sitzungsauswahl verfügbar. Die `/branch`-Bestätigung gibt zwei Sitzungs-IDs aus: den neuen Branch, in dem Sie sich jetzt befinden, und das Original. Um zum Original zurückzukehren, übergeben Sie seine ID an `/resume`, verwenden Sie die Sitzungsauswahl oder führen Sie `/resume <original-name>` aus. Berechtigungen, die Sie mit „für diese Sitzung zulassen" genehmigt haben, werden nicht auf den neuen Branch übertragen. Wenn Sie dieselbe Sitzung in zwei Terminals ohne Verzweigung fortsetzen, werden Nachrichten von beiden in ein Transkript verschachtelt.

109 109

110Für Checkpoint-basiertes Zurückspulen innerhalb einer einzelnen Sitzung siehe [Checkpointing](/de/checkpointing).110Für Checkpoint-basiertes Zurückspulen innerhalb einer einzelnen Sitzung siehe [Checkpointing](/docs/de/checkpointing).

111 111

112<h2 id="manage-context-within-a-session">112<h2 id="manage-context-within-a-session">

113 Verwalten Sie den Kontext innerhalb einer Sitzung113 Verwalten Sie den Kontext innerhalb einer Sitzung

115 115

116Diese Befehle steuern, was sich im Kontextfenster befindet, ohne die Sitzung zu verlassen:116Diese Befehle steuern, was sich im Kontextfenster befindet, ohne die Sitzung zu verlassen:

117 117

118* **`/clear`**: Beginnen Sie mit einem leeren Kontext von vorne. Das vorherige Gespräch wird gespeichert und kann mit `/resume` wiederaufgenommen werden, oder, im selben Claude Code-Prozess, {/* min-version: 2.1.191 */}aus [dem Eintrag der vorherigen Sitzung im Rewind-Menü](/de/checkpointing#rewind-past-a-cleared-conversation)118* **`/clear`**: Beginnen Sie mit einem leeren Kontext von vorne. Das vorherige Gespräch wird gespeichert und kann mit `/resume` wiederaufgenommen werden, oder, im selben Claude Code-Prozess, aus [dem Eintrag der vorherigen Sitzung im Rewind-Menü](/docs/de/checkpointing#rewind-past-a-cleared-conversation)

119* **`/compact [instructions]`**: Ersetzen Sie den Verlauf durch eine Zusammenfassung, optional fokussiert auf das, was Sie angeben119* **`/compact [instructions]`**: Ersetzen Sie den Verlauf durch eine Zusammenfassung, optional fokussiert auf das, was Sie angeben

120* **`/context`**: Zeigen Sie an, was derzeit Kontext verbraucht120* **`/context`**: Zeigen Sie an, was derzeit Kontext verbraucht

121 121

122Wie die Komprimierung mit CLAUDE.md, Skills und Regeln interagiert, finden Sie im [Kontextfenster-Leitfaden](/de/context-window). Strategien, wann Sie löschen oder komprimieren sollten, finden Sie unter [Best Practices](/de/best-practices#manage-your-session).122Wie die Komprimierung mit CLAUDE.md, Skills und Regeln interagiert, finden Sie im [Kontextfenster-Leitfaden](/docs/de/context-window). Strategien, wann Sie löschen oder komprimieren sollten, finden Sie unter [Best Practices](/docs/de/best-practices#manage-your-session).

123 123

124<h2 id="export-and-locate-session-data">124<h2 id="export-and-locate-session-data">

125 Exportieren und lokalisieren Sie Sitzungsdaten125 Exportieren und lokalisieren Sie Sitzungsdaten

133 133

134`/export` erzeugt ein gerendertes Transkript zum Lesen durch eine Person. Die folgenden Schnittstellen erzeugen strukturierte Daten zum Analysieren durch ein Skript: ein JSON-Ergebnis aus einer Ausführung, der Pfad zur Transkriptdatei einer Sitzung oder ein Live-Stream von Ereignissen. Wählen Sie basierend darauf, was das Skript auslöst:134`/export` erzeugt ein gerendertes Transkript zum Lesen durch eine Person. Die folgenden Schnittstellen erzeugen strukturierte Daten zum Analysieren durch ein Skript: ein JSON-Ergebnis aus einer Ausführung, der Pfad zur Transkriptdatei einer Sitzung oder ein Live-Stream von Ereignissen. Wählen Sie basierend darauf, was das Skript auslöst:

135 135

136* **Claude einmal ausführen und das Ergebnis erfassen**: Rufen Sie `claude -p` mit [`--output-format json` oder `stream-json`](/de/headless#get-structured-output) auf, um das Ergebnis, die Sitzungs-ID, die Nutzung und die Kosten einer nicht-interaktiven Ausführung als strukturiertes JSON zu erfassen.136* **Claude einmal ausführen und das Ergebnis erfassen**: Rufen Sie `claude -p` mit [`--output-format json` oder `stream-json`](/docs/de/headless#get-structured-output) auf, um das Ergebnis, die Sitzungs-ID, die Nutzung und die Kosten einer nicht-interaktiven Ausführung als strukturiertes JSON zu erfassen.

137* **Eine vorhandene Sitzung eine Frage stellen**: Übergeben Sie eine Sitzungs-ID an [`claude -p --resume`](/de/headless#continue-conversations), um eine Folgeanfrage zu senden, z. B. eine Zusammenfassungsanfrage, und die strukturierte Antwort zu erfassen.137* **Eine vorhandene Sitzung eine Frage stellen**: Übergeben Sie eine Sitzungs-ID an [`claude -p --resume`](/docs/de/headless#continue-conversations), um eine Folgeanfrage zu senden, z. B. eine Zusammenfassungsanfrage, und die strukturierte Antwort zu erfassen.

138* **Auf Sitzungsereignisse reagieren**: Lesen Sie das Feld `transcript_path`, das [Hooks](/de/hooks#common-input-fields) und [Statuszeilen-Befehle](/de/statusline#available-data) als Eingabe erhalten. Ein `SessionEnd`-Hook kann das Transkript archivieren, wenn eine Sitzung endet.138* **Auf Sitzungsereignisse reagieren**: Lesen Sie das Feld `transcript_path`, das [Hooks](/docs/de/hooks#common-input-fields) und [Statuszeilen-Befehle](/docs/de/statusline#available-data) als Eingabe erhalten. Ein `SessionEnd`-Hook kann das Transkript archivieren, wenn eine Sitzung endet.

139* **Claude in eine TypeScript- oder Python-App einbetten**: Verwenden Sie das [Agent SDK](/de/agent-sdk/overview), um jede Nachricht programmgesteuert zu empfangen.139* **Claude in eine TypeScript- oder Python-App einbetten**: Verwenden Sie das [Agent SDK](/docs/de/agent-sdk/overview), um jede Nachricht programmgesteuert zu empfangen.

140 140

141Das folgende Beispiel verwendet die zweite Schnittstelle. Es sendet eine Folgeanfrage an eine vorhandene Sitzung und liest die Antwort mit `jq`:141Das folgende Beispiel verwendet die zweite Schnittstelle. Es sendet eine Folgeanfrage an eine vorhandene Sitzung und liest die Antwort mit `jq`:

142 142

154 154

155| Zu | Einstellen | Wo |155| Zu | Einstellen | Wo |

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

161 161

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

163 Siehe auch163 Siehe auch

165 165

166Diese Seiten behandeln verwandte Sitzungs- und Parallelisierungsmechaniken:166Diese Seiten behandeln verwandte Sitzungs- und Parallelisierungsmechaniken:

167 167

168* [Worktrees](/de/worktrees): Führen Sie isolierte parallele Sitzungen auf separaten Branches aus168* [Worktrees](/docs/de/worktrees): Führen Sie isolierte parallele Sitzungen auf separaten Branches aus

169* [Checkpointing](/de/checkpointing): Spulen Sie Code und Gespräch zu einem früheren Punkt zurück169* [Checkpointing](/docs/de/checkpointing): Spulen Sie Code und Gespräch zu einem früheren Punkt zurück

170* [Kontextfenster](/de/context-window): Was füllt den Kontext und was überlebt die Komprimierung170* [Kontextfenster](/docs/de/context-window): Was füllt den Kontext und was überlebt die Komprimierung

171* [Nicht-interaktiver Modus](/de/headless): Sitzungsverhalten unter `claude -p`171* [Nicht-interaktiver Modus](/docs/de/headless): Sitzungsverhalten unter `claude -p`

settings.md +155 −155

Details

6 6

7> Konfigurieren Sie Claude Code mit globalen und projektbezogenen Einstellungen sowie Umgebungsvariablen.7> Konfigurieren Sie Claude Code mit globalen und projektbezogenen Einstellungen sowie Umgebungsvariablen.

8 8

9Claude Code bietet eine Vielzahl von Einstellungen, um sein Verhalten an Ihre Anforderungen anzupassen. Sie können Claude Code konfigurieren, indem Sie den Befehl `/config` ausführen, wodurch eine Einstellungsoberfläche mit Registerkarten geöffnet wird, auf der Sie Statusinformationen anzeigen und Konfigurationsoptionen ändern können. {/* min-version: 2.1.181 */}Ab v2.1.181 können Sie eine einzelne Option ändern, ohne die Oberfläche zu öffnen, indem Sie `key=value` an `/config` übergeben, zum Beispiel `/config verbose=true`.9Claude Code bietet eine Vielzahl von Einstellungen, um sein Verhalten an Ihre Anforderungen anzupassen. Sie können Claude Code konfigurieren, indem Sie den Befehl `/config` ausführen, wodurch eine Einstellungsoberfläche mit Registerkarten geöffnet wird, auf der Sie Statusinformationen anzeigen und Konfigurationsoptionen ändern können. Ab v2.1.181 können Sie eine einzelne Option ändern, ohne die Oberfläche zu öffnen, indem Sie `key=value` an `/config` übergeben, zum Beispiel `/config verbose=true`.

10 10

11<h2 id="configuration-scopes">11<h2 id="configuration-scopes">

12 Konfigurationsbereiche12 Konfigurationsbereiche

96 * `.claude/settings.json` für Einstellungen, die in die Versionskontrolle eingecheckt und mit Ihrem Team geteilt werden96 * `.claude/settings.json` für Einstellungen, die in die Versionskontrolle eingecheckt und mit Ihrem Team geteilt werden

97 * `.claude/settings.local.json` für Einstellungen, die nicht eingecheckt werden, nützlich für persönliche Voreinstellungen und Experimente. Wenn Claude Code `.claude/settings.local.json` erstellt, konfiguriert es Git so, dass die Datei ignoriert wird. Wenn Sie die Datei selbst erstellen, fügen Sie sie manuell zu Ihrer gitignore hinzu.97 * `.claude/settings.local.json` für Einstellungen, die nicht eingecheckt werden, nützlich für persönliche Voreinstellungen und Experimente. Wenn Claude Code `.claude/settings.local.json` erstellt, konfiguriert es Git so, dass die Datei ignoriert wird. Wenn Sie die Datei selbst erstellen, fügen Sie sie manuell zu Ihrer gitignore hinzu.

98 98

99 Da diese Datei Ihnen gehört und nicht dem Repository, werden ihre Berechtigungsregeln `allow` ohne den [Workspace-Trust](/de/permissions#project-allow-rules-and-workspace-trust)-Schritt wirksam, den `allow`-Regeln in `.claude/settings.json` erfordern. Wenn das Repository die Datei bereitstellt, z. B. durch Committen, gilt Workspace-Trust weiterhin.99 Da diese Datei Ihnen gehört und nicht dem Repository, werden ihre Berechtigungsregeln `allow` ohne den [Workspace-Trust](/docs/de/permissions#project-allow-rules-and-workspace-trust)-Schritt wirksam, den `allow`-Regeln in `.claude/settings.json` erfordern. Wenn das Repository die Datei bereitstellt, z. B. durch Committen, gilt Workspace-Trust weiterhin.

100* **Verwaltete Einstellungen**: Für Organisationen, die zentrale Kontrolle benötigen, unterstützt Claude Code mehrere Bereitstellungsmechanismen für verwaltete Einstellungen. Alle verwenden das gleiche JSON-Format und können nicht durch Benutzer- oder Projekteinstellungen überschrieben werden:100* **Verwaltete Einstellungen**: Für Organisationen, die zentrale Kontrolle benötigen, unterstützt Claude Code mehrere Bereitstellungsmechanismen für verwaltete Einstellungen. Alle verwenden das gleiche JSON-Format und können nicht durch Benutzer- oder Projekteinstellungen überschrieben werden:

101 101

102 * **Serververwaltete Einstellungen**: von Anthropics Servern über die Claude.ai-Administratorkonsole bereitgestellt oder von einem selbstgehosteten [Claude-Apps-Gateway](/de/claude-apps-gateway). Siehe [Serververwaltete Einstellungen](/de/server-managed-settings).102 * **Serververwaltete Einstellungen**: von Anthropics Servern über die Claude.ai-Administratorkonsole bereitgestellt oder von einem selbstgehosteten [Claude-Apps-Gateway](/docs/de/claude-apps-gateway). Siehe [Serververwaltete Einstellungen](/docs/de/server-managed-settings).

103 * **MDM/OS-Richtlinien**: über native Geräteverwaltung auf macOS und Windows bereitgestellt:103 * **MDM/OS-Richtlinien**: über native Geräteverwaltung auf macOS und Windows bereitgestellt:

104 * macOS: `com.anthropic.claudecode` verwaltete Präferenzdomäne. Die Schlüssel der obersten Ebene der plist spiegeln `managed-settings.json` wider, mit verschachtelten Einstellungen als Wörterbücher und Arrays als plist-Arrays. Bereitstellung über Konfigurationsprofile in Jamf, Iru (Kandji) oder ähnlichen MDM-Tools.104 * macOS: `com.anthropic.claudecode` verwaltete Präferenzdomäne. Die Schlüssel der obersten Ebene der plist spiegeln `managed-settings.json` wider, mit verschachtelten Einstellungen als Wörterbücher und Arrays als plist-Arrays. Bereitstellung über Konfigurationsprofile in Jamf, Iru (Kandji) oder ähnlichen MDM-Tools.

105 * Windows: `HKLM\SOFTWARE\Policies\ClaudeCode` Registrierungsschlüssel mit einem `Settings`-Wert (REG\_SZ oder REG\_EXPAND\_SZ) mit JSON (bereitgestellt über Gruppenrichtlinie oder Intune)105 * Windows: `HKLM\SOFTWARE\Policies\ClaudeCode` Registrierungsschlüssel mit einem `Settings`-Wert (REG\_SZ oder REG\_EXPAND\_SZ) mit JSON (bereitgestellt über Gruppenrichtlinie oder Intune)

120 120

121 Verwenden Sie numerische Präfixe, um die Zusammenführungsreihenfolge zu steuern, z. B. `10-telemetry.json` und `20-security.json`.121 Verwenden Sie numerische Präfixe, um die Zusammenführungsreihenfolge zu steuern, z. B. `10-telemetry.json` und `20-security.json`.

122 122

123 Siehe [Verwaltete Einstellungen](/de/permissions#managed-only-settings) und [Verwaltete MCP-Konfiguration](/de/managed-mcp) für Details.123 Siehe [Verwaltete Einstellungen](/docs/de/permissions#managed-only-settings) und [Verwaltete MCP-Konfiguration](/docs/de/managed-mcp) für Details.

124 124

125 Dieses [Repository](https://github.com/anthropics/claude-code/tree/main/examples/mdm) enthält Starter-Bereitstellungsvorlagen für Jamf, Iru (Kandji), Intune und Gruppenrichtlinie. Verwenden Sie diese als Ausgangspunkte und passen Sie sie an Ihre Anforderungen an.125 Dieses [Repository](https://github.com/anthropics/claude-code/tree/main/examples/mdm) enthält Starter-Bereitstellungsvorlagen für Jamf, Iru (Kandji), Intune und Gruppenrichtlinie. Verwenden Sie diese als Ausgangspunkte und passen Sie sie an Ihre Anforderungen an.

126 126

127 <Note>127 <Note>

128 Verwaltete Bereitstellungen können auch **Plugin-Marketplace-Ergänzungen** mit `strictKnownMarketplaces` einschränken. Weitere Informationen finden Sie unter [Verwaltete Marketplace-Einschränkungen](/de/plugin-marketplaces#managed-marketplace-restrictions).128 Verwaltete Bereitstellungen können auch **Plugin-Marketplace-Ergänzungen** mit `strictKnownMarketplaces` einschränken. Weitere Informationen finden Sie unter [Verwaltete Marketplace-Einschränkungen](/docs/de/plugin-marketplaces#managed-marketplace-restrictions).

129 </Note>129 </Note>

130* **Andere Konfiguration** wird in `~/.claude.json` gespeichert. Diese Datei enthält Ihre OAuth-Sitzung, [MCP-Server](/de/mcp)-Konfigurationen für Benutzer- und lokale Bereiche, projektbezogenen Status (zulässige Tools, Vertrauenseinstellungen) und verschiedene Caches. Projektbezogene MCP-Server werden separat in `.mcp.json` gespeichert.130* **Andere Konfiguration** wird in `~/.claude.json` gespeichert. Diese Datei enthält Ihre OAuth-Sitzung, [MCP-Server](/docs/de/mcp)-Konfigurationen für Benutzer- und lokale Bereiche, projektbezogenen Status (zulässige Tools, Vertrauenseinstellungen) und verschiedene Caches. Projektbezogene MCP-Server werden separat in `.mcp.json` gespeichert.

131 131

132<Note>132<Note>

133 Claude Code erstellt automatisch zeitgestempelte Sicherungen von Konfigurationsdateien und behält die fünf neuesten Sicherungen bei, um Datenverlust zu verhindern.133 Claude Code erstellt automatisch zeitgestempelte Sicherungen von Konfigurationsdateien und behält die fünf neuesten Sicherungen bei, um Datenverlust zu verhindern.

169 Wenn Änderungen wirksam werden169 Wenn Änderungen wirksam werden

170</h3>170</h3>

171 171

172Claude Code überwacht Ihre Einstellungsdateien und lädt sie neu, wenn sie sich ändern, sodass Änderungen an den meisten Schlüsseln ohne Neustart auf die laufende Sitzung angewendet werden. Dies umfasst `permissions`, `hooks` und Anmeldedaten-Helper wie `apiKeyHelper`. Das Neuladen umfasst Benutzer-, Projekt-, lokale und verwaltete Einstellungen, und der [`ConfigChange` Hook](/de/hooks#configchange) wird für jede erkannte Änderung ausgelöst.172Claude Code überwacht Ihre Einstellungsdateien und lädt sie neu, wenn sie sich ändern, sodass Änderungen an den meisten Schlüsseln ohne Neustart auf die laufende Sitzung angewendet werden. Dies umfasst `permissions`, `hooks` und Anmeldedaten-Helper wie `apiKeyHelper`. Das Neuladen umfasst Benutzer-, Projekt-, lokale und verwaltete Einstellungen, und der [`ConfigChange` Hook](/docs/de/hooks#configchange) wird für jede erkannte Änderung ausgelöst.

173 173

174Einige wenige Schlüssel werden einmal beim Sitzungsstart gelesen und gelten stattdessen beim nächsten Neustart:174Einige wenige Schlüssel werden einmal beim Sitzungsstart gelesen und gelten stattdessen beim nächsten Neustart:

175 175

176* `model`: Verwenden Sie [`/model`](/de/model-config#setting-your-model), um während der Sitzung zu wechseln176* `model`: Verwenden Sie [`/model`](/docs/de/model-config#setting-your-model), um während der Sitzung zu wechseln

177* [`outputStyle`](/de/output-styles): Teil der Systemaufforderung, die beim `/clear` oder Neustart neu erstellt wird177* [`outputStyle`](/docs/de/output-styles): Teil der Systemaufforderung, die beim `/clear` oder Neustart neu erstellt wird

178 178

179<h3 id="invalid-entries-in-managed-settings">179<h3 id="invalid-entries-in-managed-settings">

180 Ungültige Einträge in verwalteten Einstellungen180 Ungültige Einträge in verwalteten Einstellungen

181</h3>181</h3>

182 182

183Verwaltete Einstellungen werden tolerant analysiert. Wenn eine verwaltete Konfiguration einen Eintrag enthält, der die Schema-Validierung nicht besteht, entfernt Claude Code diesen Eintrag, zeichnet eine Warnung auf und erzwingt jede verbleibende gültige Richtlinie. Ein einzelner Tippfehler kann nicht die restliche Organisationsrichtlinie deaktivieren. Führen Sie [`/doctor`](/de/debug-your-config#check-resolved-settings) aus, um entfernte Einträge mit ihrer Quelldatei und ihrem Feld aufzulisten.183Verwaltete Einstellungen werden tolerant analysiert. Wenn eine verwaltete Konfiguration einen Eintrag enthält, der die Schema-Validierung nicht besteht, entfernt Claude Code diesen Eintrag, zeichnet eine Warnung auf und erzwingt jede verbleibende gültige Richtlinie. Ein einzelner Tippfehler kann nicht die restliche Organisationsrichtlinie deaktivieren. Führen Sie [`/doctor`](/docs/de/debug-your-config#check-resolved-settings) aus, um entfernte Einträge mit ihrer Quelldatei und ihrem Feld aufzulisten.

184 184

185Dieses Verhalten ist konsistent über alle drei Bereitstellungsmechanismen: [Serververwaltete Einstellungen](/de/server-managed-settings), plist- und Registry-Richtlinien, die über MDM bereitgestellt werden, und `managed-settings.json`-Dateien. Erfordert Claude Code v2.1.169 oder später.185Dieses Verhalten ist konsistent über alle drei Bereitstellungsmechanismen: [Serververwaltete Einstellungen](/docs/de/server-managed-settings), plist- und Registry-Richtlinien, die über MDM bereitgestellt werden, und `managed-settings.json`-Dateien. Erfordert Claude Code v2.1.169 oder später.

186 186

187Sicherheitsdurchsetzungsfelder werden pro Feld behandelt, anstatt vollständig entfernt zu werden, wenn sie vorhanden, aber ungültig sind:187Sicherheitsdurchsetzungsfelder werden pro Feld behandelt, anstatt vollständig entfernt zu werden, wenn sie vorhanden, aber ungültig sind:

188 188

189| Feld | Verhalten, wenn vorhanden, aber ungültig |189| Feld | Verhalten, wenn vorhanden, aber ungültig |

190| :--------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |190| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

191| `allowedMcpServers` | Erzwungen als leere Allowlist, sodass keine MCP-Server zulässig sind, bis der Wert behoben ist. Ein einzelner ungültiger Eintrag wird entfernt und die gültige Teilmenge wird erzwungen. |191| `allowedMcpServers` | Erzwungen als leere Allowlist, sodass keine MCP-Server zulässig sind, bis der Wert behoben ist. Ein einzelner ungültiger Eintrag wird entfernt und die gültige Teilmenge wird erzwungen. |

193| `availableModels` | {/* min-version: 2.1.175 */}Erzwungen als leere Allowlist, sodass nur das Standardmodell verfügbar ist, bis der Wert behoben ist. Ein einzelner Nicht-String-Eintrag wird entfernt und die gültige Teilmenge wird erzwungen. Gilt in v2.1.175 und später. |193| `availableModels` | Erzwungen als leere Allowlist, sodass nur das Standardmodell verfügbar ist, bis der Wert behoben ist. Ein einzelner Nicht-String-Eintrag wird entfernt und die gültige Teilmenge wird erzwungen. Gilt in v2.1.175 und später. |

194| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Behandelt als `true`. Gilt in v2.1.175 und später. |194| `enforceAvailableModels` | Behandelt als `true`. Gilt in v2.1.175 und später. |

196| `deniedMcpServers` | Ein einzelner ungültiger Eintrag wird entfernt und die gültige Teilmenge wird erzwungen. Ein vollständig ungültiger Wert wird mit einer Warnung verworfen, da das Verweigern aller Server Server blockieren würde, die die Richtlinie nie benannt hat. |196| `deniedMcpServers` | Ein einzelner ungültiger Eintrag wird entfernt und die gültige Teilmenge wird erzwungen. Ein vollständig ungültiger Wert wird mit einer Warnung verworfen, da das Verweigern aller Server Server blockieren würde, die die Richtlinie nie benannt hat. |

197| `sandbox.credentials` | {/* min-version: 2.1.191 */}Ein einzelner ungültiger Eintrag in `files` oder `envVars` wird mit einer Warnung entfernt und die gültige Teilmenge wird erzwungen. Ein vollständig ungültiger `credentials`-Wert wird mit einer Warnung verworfen, während der Rest von `sandbox` weiterhin gilt. Gilt in v2.1.191 und später. |197| `sandbox.credentials` | Ein einzelner ungültiger Eintrag in `files` oder `envVars` wird mit einer Warnung entfernt und die gültige Teilmenge wird erzwungen. Ein vollständig ungültiger `credentials`-Wert wird mit einer Warnung verworfen, während der Rest von `sandbox` weiterhin gilt. Gilt in v2.1.191 und später. |

198 198

199`requiredMinimumVersion` und `requiredMaximumVersion` schlagen offen fehl: Ein ungültiger Wert wird entfernt, anstatt erzwungen zu werden, sodass ein schlechter Richtlinien-Push Claude Code nicht am Starten hindern kann.199`requiredMinimumVersion` und `requiredMaximumVersion` schlagen offen fehl: Ein ungültiger Wert wird entfernt, anstatt erzwungen zu werden, sodass ein schlechter Richtlinien-Push Claude Code nicht am Starten hindern kann.

200 200

202 202

203* Interaktive Sitzungen zeigen beim Start einen Dialog mit den ungültigen Einträgen an.203* Interaktive Sitzungen zeigen beim Start einen Dialog mit den ungültigen Einträgen an.

204* Headless-Läufe mit `-p` drucken eine Zusammenfassung zu stderr.204* Headless-Läufe mit `-p` drucken eine Zusammenfassung zu stderr.

205* [`claude doctor`](/de/debug-your-config) listet jeden ungültigen Eintrag mit seiner Quelle und seinem Feld auf.205* [`claude doctor`](/docs/de/debug-your-config) listet jeden ungültigen Eintrag mit seiner Quelle und seinem Feld auf.

206 206

207Validieren Sie Richtlinienänderungen, indem Sie `claude doctor` auf einem Test-Computer ausführen, bevor Sie sie unternehmensweite bereitstellen.207Validieren Sie Richtlinienänderungen, indem Sie `claude doctor` auf einem Test-Computer ausführen, bevor Sie sie unternehmensweite bereitstellen.

208 208

215`settings.json` unterstützt eine Reihe von Optionen:215`settings.json` unterstützt eine Reihe von Optionen:

216 216

218| :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |218| :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

219| `advisorModel` | Modell für das serverseitige [Advisor-Tool](/de/advisor). Akzeptiert einen Modellalias wie `"opus"`, `"sonnet"` oder `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+) oder eine vollständige Modell-ID. Wird automatisch geschrieben, wenn Sie `/advisor` ausführen. Nicht gesetzt, um den Advisor zu deaktivieren | `"opus"` |219| `advisorModel` | Modell für das serverseitige [Advisor-Tool](/docs/de/advisor). Akzeptiert einen Modellalias wie `"opus"`, `"sonnet"` oder `"fable"` (v2.1.170+) oder eine vollständige Modell-ID. Wird automatisch geschrieben, wenn Sie `/advisor` ausführen. Nicht gesetzt, um den Advisor zu deaktivieren | `"opus"` |

220| `agent` | Führen Sie den Haupt-Thread als benannten Subagent aus und legen Sie den Standard-Agent für Sitzungen fest, die von `claude agents` versendet werden. Wendet den Systemaufforderung, die Werkzeugbeschränkungen und das Modell des Subagent an. Siehe [Rufen Sie Subagents explizit auf](/de/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |220| `agent` | Führen Sie den Haupt-Thread als benannten Subagent aus und legen Sie den Standard-Agent für Sitzungen fest, die von `claude agents` versendet werden. Wendet den Systemaufforderung, die Werkzeugbeschränkungen und das Modell des Subagent an. Siehe [Rufen Sie Subagents explizit auf](/docs/de/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

221| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**Standard**: `false`. Wenn [Remote Control](/de/remote-control) verbunden ist, erlauben Sie Claude, proaktive Push-Benachrichtigungen an Ihr Telefon zu senden, z. B. wenn eine lange Aufgabe endet. Wird in `/config` als **Push when Claude decides** angezeigt. Siehe [Mobile Push-Benachrichtigungen](/de/remote-control#mobile-push-notifications). Erfordert Claude Code v2.1.119 oder später | `true` |221| `agentPushNotifEnabled` | **Standard**: `false`. Wenn [Remote Control](/docs/de/remote-control) verbunden ist, erlauben Sie Claude, proaktive Push-Benachrichtigungen an Ihr Telefon zu senden, z. B. wenn eine lange Aufgabe endet. Wird in `/config` als **Push when Claude decides** angezeigt. Siehe [Mobile Push-Benachrichtigungen](/docs/de/remote-control#mobile-push-notifications). Erfordert Claude Code v2.1.119 oder später | `true` |

222| `allowAllClaudeAiMcps` | (Nur verwaltete Einstellungen) Laden Sie claude.ai-Konnektoren neben einer bereitgestellten `managed-mcp.json` auf, die ansonsten exklusive Kontrolle übernimmt und diese unterdrückt. Siehe [Verwaltete MCP-Konfiguration](/de/managed-mcp) | `true` |222| `allowAllClaudeAiMcps` | (Nur verwaltete Einstellungen) Laden Sie claude.ai-Konnektoren neben einer bereitgestellten `managed-mcp.json` auf, die ansonsten exklusive Kontrolle übernimmt und diese unterdrückt. Siehe [Verwaltete MCP-Konfiguration](/docs/de/managed-mcp) | `true` |

223| `allowedChannelPlugins` | (Nur verwaltete Einstellungen) Allowlist von Channel-Plugins, die Nachrichten pushen dürfen. Ersetzt die Standard-Anthropic-Allowlist, wenn gesetzt. Undefined = auf Standard zurückfallen, leeres Array = alle Channel-Plugins blockieren. Erfordert `channelsEnabled: true`. Siehe [Einschränken Sie, welche Channel-Plugins ausgeführt werden können](/de/channels#restrict-which-channel-plugins-can-run) | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |223| `allowedChannelPlugins` | (Nur verwaltete Einstellungen) Allowlist von Channel-Plugins, die Nachrichten pushen dürfen. Ersetzt die Standard-Anthropic-Allowlist, wenn gesetzt. Undefined = auf Standard zurückfallen, leeres Array = alle Channel-Plugins blockieren. Erfordert `channelsEnabled: true`. Siehe [Einschränken Sie, welche Channel-Plugins ausgeführt werden können](/docs/de/channels#restrict-which-channel-plugins-can-run) | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |

224| `allowedHttpHookUrls` | Allowlist von URL-Mustern, auf die HTTP-Hooks abzielen können. Unterstützt `*` als Platzhalter. Wenn gesetzt, werden Hooks mit nicht übereinstimmenden URLs blockiert. Undefined = keine Einschränkung, leeres Array = alle HTTP-Hooks blockieren. Arrays werden über Einstellungsquellen zusammengeführt. Siehe [Hook-Konfiguration](#hook-configuration) | `["https://hooks.example.com/*"]` |224| `allowedHttpHookUrls` | Allowlist von URL-Mustern, auf die HTTP-Hooks abzielen können. Unterstützt `*` als Platzhalter. Wenn gesetzt, werden Hooks mit nicht übereinstimmenden URLs blockiert. Undefined = keine Einschränkung, leeres Array = alle HTTP-Hooks blockieren. Arrays werden über Einstellungsquellen zusammengeführt. Siehe [Hook-Konfiguration](#hook-configuration) | `["https://hooks.example.com/*"]` |

225| `allowedMcpServers` | Wenn in managed-settings.json gesetzt, Allowlist von MCP-Servern, die Benutzer konfigurieren können. Undefined = keine Einschränkungen, leeres Array = Lockdown. Gilt für alle Bereiche. Denylist hat Vorrang. Siehe [Verwaltete MCP-Konfiguration](/de/managed-mcp) | `[{ "serverName": "github" }]` |225| `allowedMcpServers` | Wenn in managed-settings.json gesetzt, Allowlist von MCP-Servern, die Benutzer konfigurieren können. Undefined = keine Einschränkungen, leeres Array = Lockdown. Gilt für alle Bereiche. Denylist hat Vorrang. Siehe [Verwaltete MCP-Konfiguration](/docs/de/managed-mcp) | `[{ "serverName": "github" }]` |

226| `allowManagedHooksOnly` | (Nur verwaltete Einstellungen) Nur verwaltete Hooks, SDK-Hooks und Hooks von Plugins, die in verwalteten Einstellungen `enabledPlugins` erzwungen aktiviert sind, werden geladen. Benutzer-, Projekt- und alle anderen Plugin-Hooks werden blockiert. Siehe [Hook-Konfiguration](#hook-configuration) | `true` |226| `allowManagedHooksOnly` | (Nur verwaltete Einstellungen) Nur verwaltete Hooks, SDK-Hooks und Hooks von Plugins, die in verwalteten Einstellungen `enabledPlugins` erzwungen aktiviert sind, werden geladen. Benutzer-, Projekt- und alle anderen Plugin-Hooks werden blockiert. Siehe [Hook-Konfiguration](#hook-configuration) | `true` |

227| `allowManagedMcpServersOnly` | (Nur verwaltete Einstellungen) Nur `allowedMcpServers` aus verwalteten Einstellungen werden berücksichtigt. `deniedMcpServers` wird weiterhin aus allen Quellen zusammengeführt. Benutzer können weiterhin MCP-Server hinzufügen, aber nur die von Admin definierte Allowlist gilt. Siehe [Verwaltete MCP-Konfiguration](/de/managed-mcp) | `true` |227| `allowManagedMcpServersOnly` | (Nur verwaltete Einstellungen) Nur `allowedMcpServers` aus verwalteten Einstellungen werden berücksichtigt. `deniedMcpServers` wird weiterhin aus allen Quellen zusammengeführt. Benutzer können weiterhin MCP-Server hinzufügen, aber nur die von Admin definierte Allowlist gilt. Siehe [Verwaltete MCP-Konfiguration](/docs/de/managed-mcp) | `true` |

228| `allowManagedPermissionRulesOnly` | (Nur verwaltete Einstellungen) Verhindern Sie, dass Benutzer- und Projekteinstellungen `allow`, `ask` oder `deny` Berechtigungsregeln definieren. Nur Regeln in verwalteten Einstellungen gelten. Siehe [Nur verwaltete Einstellungen](/de/permissions#managed-only-settings) | `true` |228| `allowManagedPermissionRulesOnly` | (Nur verwaltete Einstellungen) Verhindern Sie, dass Benutzer- und Projekteinstellungen `allow`, `ask` oder `deny` Berechtigungsregeln definieren. Nur Regeln in verwalteten Einstellungen gelten. Siehe [Nur verwaltete Einstellungen](/docs/de/permissions#managed-only-settings) | `true` |

229| `alwaysThinkingEnabled` | Aktivieren Sie [erweitertes Denken](/de/model-config#extended-thinking) standardmäßig für alle Sitzungen. Normalerweise über den Befehl `/config` konfiguriert, anstatt direkt zu bearbeiten. Um das Denken unabhängig von dieser Einstellung auszuschalten, setzen Sie [`MAX_THINKING_TOKENS=0`](/de/env-vars) in `env`, was das Denken auf der Anthropic API deaktiviert, außer auf Fable 5, das Denken nicht ausschalten kann. Bei [Drittanbieter-Providern](/de/third-party-integrations) wird stattdessen der `thinking`-Parameter weggelassen, und adaptive-reasoning-Modelle können weiterhin denken | `true` |229| `alwaysThinkingEnabled` | Aktivieren Sie [erweitertes Denken](/docs/de/model-config#extended-thinking) standardmäßig für alle Sitzungen. Normalerweise über den Befehl `/config` konfiguriert, anstatt direkt zu bearbeiten. Um das Denken unabhängig von dieser Einstellung auszuschalten, setzen Sie [`MAX_THINKING_TOKENS=0`](/docs/de/env-vars) in `env`, was das Denken auf der Anthropic API deaktiviert, außer auf Fable 5, das Denken nicht ausschalten kann. Bei [Drittanbieter-Providern](/docs/de/third-party-integrations) wird stattdessen der `thinking`-Parameter weggelassen, und adaptive-reasoning-Modelle können weiterhin denken | `true` |

230| `apiKeyHelper` | Benutzerdefiniertes Skript, das in `/bin/sh` auf macOS und Linux oder `cmd` auf Windows ausgeführt werden soll, um einen Auth-Wert zu generieren. Dieser Wert wird als `X-Api-Key` und `Authorization: Bearer` Header für Modellanfragen gesendet. Setzen Sie das Aktualisierungsintervall mit [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/de/env-vars) | `/bin/generate_temp_api_key.sh` |230| `apiKeyHelper` | Benutzerdefiniertes Skript, das in `/bin/sh` auf macOS und Linux oder `cmd` auf Windows ausgeführt werden soll, um einen Auth-Wert zu generieren. Dieser Wert wird als `X-Api-Key` und `Authorization: Bearer` Header für Modellanfragen gesendet. Setzen Sie das Aktualisierungsintervall mit [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/docs/de/env-vars) | `/bin/generate_temp_api_key.sh` |

231| `askUserQuestionTimeout` | {/* min-version: 2.1.200 */}**Standard**: `"never"`. Leerlaufzeit vor einer unbeantworteten [`AskUserQuestion`](/de/tools-reference) Dialog, der automatisch mit den bereits ausgewählten Optionen fortfährt. Akzeptiert `"60s"`, `"5m"`, `"10m"` oder `"never"`. Mit dem Standard warten Fragen, bis Sie sie beantworten. Wird in `/config` als **Question auto-continue timeout** angezeigt, das diesen Schlüssel in Benutzereinstellungen schreibt. Nicht aus Projekt- oder lokalen Einstellungen gelesen. Erfordert Claude Code v2.1.200 oder später | `"5m"` |231| `askUserQuestionTimeout` | **Standard**: `"never"`. Leerlaufzeit vor einer unbeantworteten [`AskUserQuestion`](/docs/de/tools-reference) Dialog, der automatisch mit den bereits ausgewählten Optionen fortfährt. Akzeptiert `"60s"`, `"5m"`, `"10m"` oder `"never"`. Mit dem Standard warten Fragen, bis Sie sie beantworten. Wird in `/config` als **Question auto-continue timeout** angezeigt, das diesen Schlüssel in Benutzereinstellungen schreibt. Nicht aus Projekt- oder lokalen Einstellungen gelesen. Erfordert Claude Code v2.1.200 oder später | `"5m"` |

232| `attribution` | Passen Sie die Zuschreibung für Git-Commits und Pull Requests an. Siehe [Zuschreibungseinstellungen](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |232| `attribution` | Passen Sie die Zuschreibung für Git-Commits und Pull Requests an. Siehe [Zuschreibungseinstellungen](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |

233| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**Standard**: `true`. Komprimieren Sie das Gespräch automatisch, wenn sich der Kontext dem Limit nähert. Wird in `/config` als **Auto-compact** angezeigt. Um dies über eine Umgebungsvariable zu deaktivieren, setzen Sie [`DISABLE_AUTO_COMPACT`](/de/env-vars) in `env` | `false` |233| `autoCompactEnabled` | **Standard**: `true`. Komprimieren Sie das Gespräch automatisch, wenn sich der Kontext dem Limit nähert. Wird in `/config` als **Auto-compact** angezeigt. Um dies über eine Umgebungsvariable zu deaktivieren, setzen Sie [`DISABLE_AUTO_COMPACT`](/docs/de/env-vars) in `env` | `false` |

234| `autoMemoryDirectory` | Benutzerdefiniertes Verzeichnis für [automatisches Speichern](/de/memory#storage-location). Akzeptiert einen absoluten Pfad oder einen `~/`-erweiterten Pfad. Aus Projekt- oder lokalen Einstellungen wird dies nur berücksichtigt, nachdem Sie den Workspace-Trust-Dialog akzeptieren, da ein geklontes Repository diese Datei bereitstellen kann | `"~/my-memory-dir"` |234| `autoMemoryDirectory` | Benutzerdefiniertes Verzeichnis für [automatisches Speichern](/docs/de/memory#storage-location). Akzeptiert einen absoluten Pfad oder einen `~/`-erweiterten Pfad. Aus Projekt- oder lokalen Einstellungen wird dies nur berücksichtigt, nachdem Sie den Workspace-Trust-Dialog akzeptieren, da ein geklontes Repository diese Datei bereitstellen kann | `"~/my-memory-dir"` |

235| `autoMemoryEnabled` | **Standard**: `true`. Aktivieren Sie [automatisches Speichern](/de/memory#enable-or-disable-auto-memory). Wenn `false`, liest Claude nicht aus dem oder schreibt nicht in das automatische Speicherverzeichnis. Sie können dies auch während einer Sitzung mit `/memory` umschalten. Um dies über eine Umgebungsvariable zu deaktivieren, setzen Sie [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/de/env-vars) in `env` | `false` |235| `autoMemoryEnabled` | **Standard**: `true`. Aktivieren Sie [automatisches Speichern](/docs/de/memory#enable-or-disable-auto-memory). Wenn `false`, liest Claude nicht aus dem oder schreibt nicht in das automatische Speicherverzeichnis. Sie können dies auch während einer Sitzung mit `/memory` umschalten. Um dies über eine Umgebungsvariable zu deaktivieren, setzen Sie [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/docs/de/env-vars) in `env` | `false` |

236| `autoMode` | Passen Sie an, was der [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode)-Klassifizierer blockiert und erlaubt. Enthält `environment`, `allow`, `soft_deny` und `hard_deny` Arrays von Prosa-Regeln. Schließen Sie die Literalzeichenkette `"$defaults"` in ein Array ein, um die integrierten Regeln an dieser Position zu erben. Siehe [Konfigurieren Sie den Auto-Modus](/de/auto-mode-config). Nur aus Benutzereinstellungen, dem Flag `--settings` und verwalteten Einstellungen gelesen. Ignoriert in Projekt `.claude/settings.json` und lokal `.claude/settings.local.json`. {/* min-version: 2.1.207 */}Vor v2.1.207 wurde `.claude/settings.local.json` auch gelesen | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |236| `autoMode` | Passen Sie an, was der [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode)-Klassifizierer blockiert und erlaubt. Enthält `environment`, `allow`, `soft_deny` und `hard_deny` Arrays von Prosa-Regeln. Schließen Sie die Literalzeichenkette `"$defaults"` in ein Array ein, um die integrierten Regeln an dieser Position zu erben. Siehe [Konfigurieren Sie den Auto-Modus](/docs/de/auto-mode-config). Nur aus Benutzereinstellungen, dem Flag `--settings` und verwalteten Einstellungen gelesen. Ignoriert in Projekt `.claude/settings.json` und lokal `.claude/settings.local.json`. Vor v2.1.207 wurde `.claude/settings.local.json` auch gelesen | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |

237| `autoMode.classifyAllShell` | {/* min-version: 2.1.193 */}**Standard**: `false`. Wenn `true`, setzt dies alle Bash- und PowerShell-Allow-Regeln aus, während der Auto-Modus aktiv ist, sodass alle Shell-Befehle durch den Klassifizierer geleitet werden, nicht nur Regeln, die willkürlichen Code-Ausführungsmustern entsprechen. Siehe [Leiten Sie alle Shell-Befehle durch den Klassifizierer](/de/auto-mode-config#route-all-shell-commands-through-the-classifier). Erfordert Claude Code v2.1.193 oder später | `true` |237| `autoMode.classifyAllShell` | **Standard**: `false`. Wenn `true`, setzt dies alle Bash- und PowerShell-Allow-Regeln aus, während der Auto-Modus aktiv ist, sodass alle Shell-Befehle durch den Klassifizierer geleitet werden, nicht nur Regeln, die willkürlichen Code-Ausführungsmustern entsprechen. Siehe [Leiten Sie alle Shell-Befehle durch den Klassifizierer](/docs/de/auto-mode-config#route-all-shell-commands-through-the-classifier). Erfordert Claude Code v2.1.193 oder später | `true` |

238| `autoScrollEnabled` | **Standard**: `true`. Im [Fullscreen-Rendering](/de/fullscreen) folgen Sie neuer Ausgabe zum unteren Ende des Gesprächs. Wird in `/config` als **Auto-scroll** angezeigt. Berechtigungsaufforderungen scrollen weiterhin in die Ansicht, wenn dies ausgeschaltet ist | `false` |238| `autoScrollEnabled` | **Standard**: `true`. Im [Fullscreen-Rendering](/docs/de/fullscreen) folgen Sie neuer Ausgabe zum unteren Ende des Gesprächs. Wird in `/config` als **Auto-scroll** angezeigt. Berechtigungsaufforderungen scrollen weiterhin in die Ansicht, wenn dies ausgeschaltet ist | `false` |

239| `autoUpdatesChannel` | **Standard**: `"latest"`. Release-Kanal zum Folgen von Updates. Verwenden Sie `"stable"` für eine Version, die normalerweise etwa eine Woche alt ist und Versionen mit großen Regressionen überspringt, oder `"latest"` für die neueste Version. Um Auto-Updates vollständig zu deaktivieren, setzen Sie [`DISABLE_AUTOUPDATER`](/de/setup#disable-auto-updates) in `env` | `"stable"` |239| `autoUpdatesChannel` | **Standard**: `"latest"`. Release-Kanal zum Folgen von Updates. Verwenden Sie `"stable"` für eine Version, die normalerweise etwa eine Woche alt ist und Versionen mit großen Regressionen überspringt, oder `"latest"` für die neueste Version. Um Auto-Updates vollständig zu deaktivieren, setzen Sie [`DISABLE_AUTOUPDATER`](/docs/de/setup#disable-auto-updates) in `env` | `"stable"` |

240| `availableModels` | Beschränken Sie, welche Modelle Benutzer für die Hauptsitzung, [Subagents](/de/sub-agents), [Skills](/de/skills) und den [Advisor](/de/advisor) auswählen können. Beeinflusst nicht die Standardoption, es sei denn, `enforceAvailableModels` ist auch gesetzt. Siehe [Modellauswahl einschränken](/de/model-config#restrict-model-selection) | `["sonnet", "haiku"]` |240| `availableModels` | Beschränken Sie, welche Modelle Benutzer für die Hauptsitzung, [Subagents](/docs/de/sub-agents), [Skills](/docs/de/skills) und den [Advisor](/docs/de/advisor) auswählen können. Beeinflusst nicht die Standardoption, es sei denn, `enforceAvailableModels` ist auch gesetzt. Siehe [Modellauswahl einschränken](/docs/de/model-config#restrict-model-selection) | `["sonnet", "haiku"]` |

241| `awaySummaryEnabled` | Zeigen Sie eine einzeilige Sitzungszusammenfassung an, wenn Sie nach einigen Minuten zur Befehlszeile zurückkehren. Setzen Sie auf `false` oder deaktivieren Sie Sitzungszusammenfassung in `/config`, um zu deaktivieren. Gleich wie [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/de/env-vars) | `true` |241| `awaySummaryEnabled` | Zeigen Sie eine einzeilige Sitzungszusammenfassung an, wenn Sie nach einigen Minuten zur Befehlszeile zurückkehren. Setzen Sie auf `false` oder deaktivieren Sie Sitzungszusammenfassung in `/config`, um zu deaktivieren. Gleich wie [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/docs/de/env-vars) | `true` |

242| `awsAuthRefresh` | Benutzerdefiniertes Skript, das das `.aws`-Verzeichnis ändert (siehe [erweiterte Anmeldedatenkonfiguration](/de/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |242| `awsAuthRefresh` | Benutzerdefiniertes Skript, das das `.aws`-Verzeichnis ändert (siehe [erweiterte Anmeldedatenkonfiguration](/docs/de/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |

243| `awsCredentialExport` | Benutzerdefiniertes Skript, das JSON mit AWS-Anmeldedaten ausgibt (siehe [erweiterte Anmeldedatenkonfiguration](/de/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |243| `awsCredentialExport` | Benutzerdefiniertes Skript, das JSON mit AWS-Anmeldedaten ausgibt (siehe [erweiterte Anmeldedatenkonfiguration](/docs/de/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |

244| `axScreenReader` | {/* min-version: 2.1.181 */}Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Der Bildschirmleser-Modus verwendet immer den klassischen Renderer, daher hat die `tui`-Einstellung keine Auswirkung, während er aktiv ist. Angehängte [Hintergrund-Sitzungen](/de/agent-view) werden weiterhin im Vollbildmodus gerendert. Die Umgebungsvariable [`CLAUDE_AX_SCREEN_READER`](/de/env-vars) und das Flag [`--ax-screen-reader`](/de/cli-reference#cli-flags) haben Vorrang. Erfordert Claude Code v2.1.181 oder später | `true` |244| `axScreenReader` | Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Der Bildschirmleser-Modus verwendet immer den klassischen Renderer, daher hat die `tui`-Einstellung keine Auswirkung, während er aktiv ist. Angehängte [Hintergrund-Sitzungen](/docs/de/agent-view) werden weiterhin im Vollbildmodus gerendert. Die Umgebungsvariable [`CLAUDE_AX_SCREEN_READER`](/docs/de/env-vars) und das Flag [`--ax-screen-reader`](/docs/de/cli-reference#cli-flags) haben Vorrang. Erfordert Claude Code v2.1.181 oder später | `true` |

245| `blockedMarketplaces` | (Nur verwaltete Einstellungen) Blocklist von Marketplace-Quellen. Erzwungen bei Marketplace-Hinzufügung und bei Plugin-Installation, Update, Aktualisierung und Auto-Update, sodass ein Marketplace, der vor dem Setzen der Richtlinie hinzugefügt wurde, nicht zum Abrufen von Plugins verwendet werden kann. Blockierte Quellen werden vor dem Download überprüft, sodass sie das Dateisystem nie berühren. Siehe [Verwaltete Marketplace-Einschränkungen](/de/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |245| `blockedMarketplaces` | (Nur verwaltete Einstellungen) Blocklist von Marketplace-Quellen. Erzwungen bei Marketplace-Hinzufügung und bei Plugin-Installation, Update, Aktualisierung und Auto-Update, sodass ein Marketplace, der vor dem Setzen der Richtlinie hinzugefügt wurde, nicht zum Abrufen von Plugins verwendet werden kann. Blockierte Quellen werden vor dem Download überprüft, sodass sie das Dateisystem nie berühren. Siehe [Verwaltete Marketplace-Einschränkungen](/docs/de/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

246| `browserExternalPageTools` | (Nur verwaltete Einstellungen) Setzen Sie auf `"disabled"`, um zu verhindern, dass Claude Tools verwendet, um externe Seiten im [Browser-Bereich](/de/desktop#browse-external-sites) der Desktop-App zu lesen oder zu bearbeiten. Benutzer können weiterhin selbst zu externen Seiten navigieren, und lokale Dev-Server-Vorschau sind nicht betroffen | `"disabled"` |246| `browserExternalPageTools` | (Nur verwaltete Einstellungen) Setzen Sie auf `"disabled"`, um zu verhindern, dass Claude Tools verwendet, um externe Seiten im [Browser-Bereich](/docs/de/desktop#browse-external-sites) der Desktop-App zu lesen oder zu bearbeiten. Benutzer können weiterhin selbst zu externen Seiten navigieren, und lokale Dev-Server-Vorschau sind nicht betroffen | `"disabled"` |

247| `channelsEnabled` | (Nur verwaltete Einstellungen) Erlauben Sie [Kanäle](/de/channels) für die Organisation. Bei Claude.ai Team- und Enterprise-Plänen werden Kanäle blockiert, wenn dies nicht gesetzt oder `false` ist. Für [Anthropic Console](/de/authentication#claude-console-authentication)-Konten mit API-Schlüssel-Authentifizierung sind Kanäle standardmäßig zulässig, es sei denn, Ihre Organisation stellt verwaltete Einstellungen bereit. In diesem Fall muss dieser Schlüssel auf `true` gesetzt werden | `true` |247| `channelsEnabled` | (Nur verwaltete Einstellungen) Erlauben Sie [Kanäle](/docs/de/channels) für die Organisation. Bei Claude.ai Team- und Enterprise-Plänen werden Kanäle blockiert, wenn dies nicht gesetzt oder `false` ist. Für [Anthropic Console](/docs/de/authentication#claude-console-authentication)-Konten mit API-Schlüssel-Authentifizierung sind Kanäle standardmäßig zulässig, es sei denn, Ihre Organisation stellt verwaltete Einstellungen bereit. In diesem Fall muss dieser Schlüssel auf `true` gesetzt werden | `true` |

248| `claudeMd` | (Nur verwaltete Einstellungen) CLAUDE.md-ähnliche Anweisungen, die als organisationsverwalteter Speicher eingespritzt werden. Wird nur berücksichtigt, wenn in verwalteten oder Richtlinieneinstellungen gesetzt, und ignoriert in Benutzer-, Projekt- und lokalen Einstellungen. Siehe [organisationsweite CLAUDE.md](/de/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |248| `claudeMd` | (Nur verwaltete Einstellungen) CLAUDE.md-ähnliche Anweisungen, die als organisationsverwalteter Speicher eingespritzt werden. Wird nur berücksichtigt, wenn in verwalteten oder Richtlinieneinstellungen gesetzt, und ignoriert in Benutzer-, Projekt- und lokalen Einstellungen. Siehe [organisationsweite CLAUDE.md](/docs/de/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |

249| `claudeMdExcludes` | Glob-Muster oder absolute Pfade von `CLAUDE.md`-Dateien, die beim Laden von [Speicher](/de/memory) übersprungen werden sollen. Muster werden gegen absolute Dateipfade abgeglichen. Gilt nur für Benutzer-, Projekt- und lokalen Speicher; verwaltete Richtliniendateien können nicht ausgeschlossen werden | `["**/vendor/**/CLAUDE.md"]` |249| `claudeMdExcludes` | Glob-Muster oder absolute Pfade von `CLAUDE.md`-Dateien, die beim Laden von [Speicher](/docs/de/memory) übersprungen werden sollen. Muster werden gegen absolute Dateipfade abgeglichen. Gilt nur für Benutzer-, Projekt- und lokalen Speicher; verwaltete Richtliniendateien können nicht ausgeschlossen werden | `["**/vendor/**/CLAUDE.md"]` |

250| `cleanupPeriodDays` | **Standard**: `30` Tage, Minimum `1`. Claude Code löscht [Sitzungsdateien und andere Anwendungsdaten](/de/claude-directory#cleaned-up-automatically), die älter als dieser Zeitraum sind, beim Start. Das Setzen auf `0` wird mit einem Validierungsfehler abgelehnt. Der gleiche Altersgrenzwert gilt für die automatische Entfernung von [verwaisten Worktrees](/de/worktrees#clean-up-worktrees) beim Start. {/* min-version: 2.1.203 */}Wenn Claude Code eine Einstellungsdatei nicht lesen oder analysieren kann, pausiert es die Aufbewahrungsbereinigung und zeigt eine Warnung in `/status` an, bis Sie die Datei beheben, es sei denn, [verwaltete Einstellungen](/de/server-managed-settings) stellen `cleanupPeriodDays` bereit. In diesem Fall wird die Bereinigung beim verwalteten Wert ausgeführt. Vor v2.1.203 wurde die Bereinigung beim 30-Tage-Standard ausgeführt und konnte Transkripte löschen, die ein längeres `cleanupPeriodDays` behalten sollte; Dateien, die neuer als 30 Tage waren, wurden nie entfernt. Um Transkriptschreibvorgänge vollständig zu deaktivieren, setzen Sie die Umgebungsvariable [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/de/env-vars). Im nicht-interaktiven Modus übergeben Sie `--no-session-persistence` neben `-p` oder setzen Sie `persistSession: false` im Agent SDK. | `20` |250| `cleanupPeriodDays` | **Standard**: `30` Tage, Minimum `1`. Claude Code löscht [Sitzungsdateien und andere Anwendungsdaten](/docs/de/claude-directory#cleaned-up-automatically), die älter als dieser Zeitraum sind, beim Start. Das Setzen auf `0` wird mit einem Validierungsfehler abgelehnt. Der gleiche Altersgrenzwert gilt für die automatische Entfernung von [verwaisten Worktrees](/docs/de/worktrees#clean-up-worktrees) beim Start. Wenn Claude Code eine Einstellungsdatei nicht lesen oder analysieren kann, pausiert es die Aufbewahrungsbereinigung und zeigt eine Warnung in `/status` an, bis Sie die Datei beheben, es sei denn, [verwaltete Einstellungen](/docs/de/server-managed-settings) stellen `cleanupPeriodDays` bereit. In diesem Fall wird die Bereinigung beim verwalteten Wert ausgeführt. Vor v2.1.203 wurde die Bereinigung beim 30-Tage-Standard ausgeführt und konnte Transkripte löschen, die ein längeres `cleanupPeriodDays` behalten sollte; Dateien, die neuer als 30 Tage waren, wurden nie entfernt. Um Transkriptschreibvorgänge vollständig zu deaktivieren, setzen Sie die Umgebungsvariable [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/de/env-vars). Im nicht-interaktiven Modus übergeben Sie `--no-session-persistence` neben `-p` oder setzen Sie `persistSession: false` im Agent SDK. | `20` |

251| `companyAnnouncements` | Ankündigung, die Benutzern beim Start angezeigt werden soll. Wenn mehrere Ankündigungen bereitgestellt werden, werden sie zufällig durchlaufen. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |251| `companyAnnouncements` | Ankündigung, die Benutzern beim Start angezeigt werden soll. Wenn mehrere Ankündigungen bereitgestellt werden, werden sie zufällig durchlaufen. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |

252| `defaultShell` | **Standard**: `"bash"`, oder `"powershell"` unter Windows, wenn Bash nicht verfügbar ist. Standard-Shell für Input-Box `!` Befehle. Akzeptiert `"bash"` oder `"powershell"`. Das Setzen auf `"powershell"` leitet interaktive `!` Befehle über PowerShell unter Windows. Erfordert `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Siehe [PowerShell-Tool](/de/tools-reference#powershell-tool) | `"powershell"` |252| `defaultShell` | **Standard**: `"bash"`, oder `"powershell"` unter Windows, wenn Bash nicht verfügbar ist. Standard-Shell für Input-Box `!` Befehle. Akzeptiert `"bash"` oder `"powershell"`. Das Setzen auf `"powershell"` leitet interaktive `!` Befehle über PowerShell unter Windows. Erfordert `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Siehe [PowerShell-Tool](/docs/de/tools-reference#powershell-tool) | `"powershell"` |

253| `deniedMcpServers` | Wenn in managed-settings.json gesetzt, Denylist von MCP-Servern, die explizit blockiert sind. Gilt für alle Bereiche einschließlich verwalteter Server. Denylist hat Vorrang vor Allowlist. Siehe [Verwaltete MCP-Konfiguration](/de/managed-mcp) | `[{ "serverName": "filesystem" }]` |253| `deniedMcpServers` | Wenn in managed-settings.json gesetzt, Denylist von MCP-Servern, die explizit blockiert sind. Gilt für alle Bereiche einschließlich verwalteter Server. Denylist hat Vorrang vor Allowlist. Siehe [Verwaltete MCP-Konfiguration](/docs/de/managed-mcp) | `[{ "serverName": "filesystem" }]` |

254| `disableAgentView` | Setzen Sie auf `true`, um [Hintergrund-Agenten und Agent-Ansicht](/de/agent-view) auszuschalten: `claude agents`, `--bg`, `/background` und den On-Demand-Supervisor. Normalerweise in [verwalteten Einstellungen](/de/permissions#managed-settings) gesetzt. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_AGENT_VIEW` auf `1` | `true` |254| `disableAgentView` | Setzen Sie auf `true`, um [Hintergrund-Agenten und Agent-Ansicht](/docs/de/agent-view) auszuschalten: `claude agents`, `--bg`, `/background` und den On-Demand-Supervisor. Normalerweise in [verwalteten Einstellungen](/docs/de/permissions#managed-settings) gesetzt. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_AGENT_VIEW` auf `1` | `true` |

256| `disableArtifact` | Setzen Sie auf `true`, um das [Artifact](/de/artifacts)-Tool zu deaktivieren, das Sitzungsausgabe als private Webseite auf claude.ai veröffentlicht. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_ARTIFACT` auf `1` | `true` |256| `disableArtifact` | Setzen Sie auf `true`, um das [Artifact](/docs/de/artifacts)-Tool zu deaktivieren, das Sitzungsausgabe als private Webseite auf claude.ai veröffentlicht. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_ARTIFACT` auf `1` | `true` |

257| `disableAutoMode` | Setzen Sie auf `"disable"`, um zu verhindern, dass der [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) aktiviert wird. Entfernt `auto` aus dem `Shift+Tab`-Zyklus und lehnt `--permission-mode auto` beim Start ab. Am nützlichsten in [verwalteten Einstellungen](/de/permissions#managed-settings), wo Benutzer es nicht überschreiben können | `"disable"` |257| `disableAutoMode` | Setzen Sie auf `"disable"`, um zu verhindern, dass der [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) aktiviert wird. Entfernt `auto` aus dem `Shift+Tab`-Zyklus und lehnt `--permission-mode auto` beim Start ab. Am nützlichsten in [verwalteten Einstellungen](/docs/de/permissions#managed-settings), wo Benutzer es nicht überschreiben können | `"disable"` |

258| `disableBrowserExternalNavigation` | (Nur verwaltete Einstellungen) Setzen Sie auf `true`, um externes Browsen im [Browser-Bereich](/de/desktop#browse-external-sites) der Desktop-App auszuschalten. Weder Benutzer noch Claude können zu externen Seiten navigieren, und localhost Dev-Server-Vorschau sind nicht betroffen. Der Wert muss der JSON-Boolean `true` sein; die Zeichenkette `"true"` wird ignoriert | `true` |258| `disableBrowserExternalNavigation` | (Nur verwaltete Einstellungen) Setzen Sie auf `true`, um externes Browsen im [Browser-Bereich](/docs/de/desktop#browse-external-sites) der Desktop-App auszuschalten. Weder Benutzer noch Claude können zu externen Seiten navigieren, und localhost Dev-Server-Vorschau sind nicht betroffen. Der Wert muss der JSON-Boolean `true` sein; die Zeichenkette `"true"` wird ignoriert | `true` |

259| `disableBundledSkills` | Setzen Sie auf `true`, um die [Skills](/de/skills) und Workflows zu deaktivieren, die mit Claude Code ausgeliefert werden: Gebündelte Skills und Workflows werden vollständig entfernt, während integrierte Slash-Befehle wie `/init` tippbar bleiben, aber vom Modell ausgeblendet werden. `/doctor` bleibt tippbar wie die integrierten Befehle; blenden Sie ihn mit [`DISABLE_DOCTOR_COMMAND`](/de/env-vars) statt aus. Skills von Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` auf `1` | `true` |259| `disableBundledSkills` | Setzen Sie auf `true`, um die [Skills](/docs/de/skills) und Workflows zu deaktivieren, die mit Claude Code ausgeliefert werden: Gebündelte Skills und Workflows werden vollständig entfernt, während integrierte Slash-Befehle wie `/init` tippbar bleiben, aber vom Modell ausgeblendet werden. `/doctor` bleibt tippbar wie die integrierten Befehle; blenden Sie ihn mit [`DISABLE_DOCTOR_COMMAND`](/docs/de/env-vars) statt aus. Skills von Plugins, `.claude/skills/` und `.claude/commands/` sind nicht betroffen. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` auf `1` | `true` |

260| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Deaktivieren Sie [claude.ai MCP-Konnektoren](/de/mcp#use-mcp-servers-from-claude-ai), sodass sie nicht automatisch abgerufen oder verbunden werden. Setzen Sie in jedem Einstellungsbereich. `true` in jeder Quelle hat Vorrang, daher kann eine eingecheckte Projekt-`.claude/settings.json` ein Repo aus Cloud-Konnektoren ausschließen, aber ein Projekt-Level `false` kann ein Benutzer- oder Richtlinien-Level `true` nicht überschreiben. Server, die explizit über `--mcp-config` übergeben werden, sind nicht betroffen. Um einzelne Konnektoren statt aller zu verweigern, verwenden Sie [`deniedMcpServers`](/de/managed-mcp). Erfordert Claude Code v2.1.182 oder später | `true` |260| `disableClaudeAiConnectors` | Deaktivieren Sie [claude.ai MCP-Konnektoren](/docs/de/mcp#use-mcp-servers-from-claude-ai), sodass sie nicht automatisch abgerufen oder verbunden werden. Setzen Sie in jedem Einstellungsbereich. `true` in jeder Quelle hat Vorrang, daher kann eine eingecheckte Projekt-`.claude/settings.json` ein Repo aus Cloud-Konnektoren ausschließen, aber ein Projekt-Level `false` kann ein Benutzer- oder Richtlinien-Level `true` nicht überschreiben. Server, die explizit über `--mcp-config` übergeben werden, sind nicht betroffen. Um einzelne Konnektoren statt aller zu verweigern, verwenden Sie [`deniedMcpServers`](/docs/de/managed-mcp). Erfordert Claude Code v2.1.182 oder später | `true` |

261| `disableDeepLinkRegistration` | Setzen Sie auf `"disable"`, um zu verhindern, dass Claude Code den `claude-cli://` Protokoll-Handler beim Start mit dem Betriebssystem registriert. [Deep Links](/de/deep-links) ermöglichen es externen Tools, eine Claude Code-Sitzung mit einer vorausgefüllten Aufforderung zu öffnen. Nützlich in Umgebungen, in denen die Protokoll-Handler-Registrierung eingeschränkt oder separat verwaltet wird | `"disable"` |261| `disableDeepLinkRegistration` | Setzen Sie auf `"disable"`, um zu verhindern, dass Claude Code den `claude-cli://` Protokoll-Handler beim Start mit dem Betriebssystem registriert. [Deep Links](/docs/de/deep-links) ermöglichen es externen Tools, eine Claude Code-Sitzung mit einer vorausgefüllten Aufforderung zu öffnen. Nützlich in Umgebungen, in denen die Protokoll-Handler-Registrierung eingeschränkt oder separat verwaltet wird | `"disable"` |

263| `disableRemoteControl` | {/* min-version: 2.1.128 */}Deaktivieren Sie [Remote Control](/de/remote-control): blockiert `claude remote-control`, das Flag `--remote-control`, Auto-Start und den In-Session-Toggle. Normalerweise in [verwalteten Einstellungen](/de/permissions#managed-settings) für die Pro-Gerät-MDM-Durchsetzung platziert, funktioniert aber aus jedem Bereich. Erfordert Claude Code v2.1.128 oder später | `true` |263| `disableRemoteControl` | Deaktivieren Sie [Remote Control](/docs/de/remote-control): blockiert `claude remote-control`, das Flag `--remote-control`, Auto-Start und den In-Session-Toggle. Normalerweise in [verwalteten Einstellungen](/docs/de/permissions#managed-settings) für die Pro-Gerät-MDM-Durchsetzung platziert, funktioniert aber aus jedem Bereich. Erfordert Claude Code v2.1.128 oder später | `true` |

264| `disableSideloadFlags` | {/* min-version: 2.1.193 */}(Nur verwaltete Einstellungen) Lehnen Sie die Flags `--plugin-dir`, `--plugin-url`, `--agents` und `--mcp-config` beim Start ab, die Benutzer ansonsten übergeben könnten, um [`strictKnownMarketplaces`](#strictknownmarketplaces) für einen einzelnen Lauf zu umgehen. Lehnt auch diese Flags von jeder Oberfläche ab, die die CLI intern mit ihnen startet, derzeit [Cowork](/de/desktop) lokale Sitzungen in der Desktop-App. Ein `--mcp-config`, dessen Server alle In-Process-`type: "sdk"`-Einträge sind, wird weiterhin akzeptiert, sodass das Agent SDK und die VS Code-Erweiterung weiterhin funktionieren. Blockiert nicht `claude mcp add`, `.mcp.json` oder SDK `setMcpServers()`; kombinieren Sie mit [`allowedMcpServers`](/de/managed-mcp) für Pro-Server-MCP-Kontrolle. Erfordert Claude Code v2.1.193 oder später | `true` |264| `disableSideloadFlags` | (Nur verwaltete Einstellungen) Lehnen Sie die Flags `--plugin-dir`, `--plugin-url`, `--agents` und `--mcp-config` beim Start ab, die Benutzer ansonsten übergeben könnten, um [`strictKnownMarketplaces`](#strictknownmarketplaces) für einen einzelnen Lauf zu umgehen. Lehnt auch diese Flags von jeder Oberfläche ab, die die CLI intern mit ihnen startet, derzeit [Cowork](/docs/de/desktop) lokale Sitzungen in der Desktop-App. Ein `--mcp-config`, dessen Server alle In-Process-`type: "sdk"`-Einträge sind, wird weiterhin akzeptiert, sodass das Agent SDK und die VS Code-Erweiterung weiterhin funktionieren. Blockiert nicht `claude mcp add`, `.mcp.json` oder SDK `setMcpServers()`; kombinieren Sie mit [`allowedMcpServers`](/docs/de/managed-mcp) für Pro-Server-MCP-Kontrolle. Erfordert Claude Code v2.1.193 oder später | `true` |

265| `disableSkillShellExecution` | Deaktivieren 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. Befehle werden durch `[shell command execution disabled by policy]` ersetzt, anstatt ausgeführt zu werden. Gebündelte und verwaltete Skills sind nicht betroffen. Am nützlichsten in [verwalteten Einstellungen](/de/permissions#managed-settings), wo Benutzer es nicht überschreiben können | `true` |265| `disableSkillShellExecution` | Deaktivieren 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. Befehle werden durch `[shell command execution disabled by policy]` ersetzt, anstatt ausgeführt zu werden. Gebündelte und verwaltete Skills sind nicht betroffen. Am nützlichsten in [verwalteten Einstellungen](/de/permissions#managed-settings), wo Benutzer es nicht überschreiben können | `true` |

266| `disableWorkflows` | **Standard**: `false`. Deaktivieren Sie [dynamische Workflows](/de/workflows#turn-workflows-off) und die gebündelten Workflow-Befehle. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_WORKFLOWS` auf `1` | `true` |266| `disableWorkflows` | **Standard**: `false`. Deaktivieren Sie [dynamische Workflows](/docs/de/workflows#turn-workflows-off) und die gebündelten Workflow-Befehle. Entspricht dem Setzen von `CLAUDE_CODE_DISABLE_WORKFLOWS` auf `1` | `true` |

267| `editorMode` | **Standard**: `"normal"`. Tastaturkürzel-Modus für die Eingabeaufforderung: `"normal"` oder `"vim"`. Wird in `/config` als **Editor mode** angezeigt | `"vim"` |267| `editorMode` | **Standard**: `"normal"`. Tastaturkürzel-Modus für die Eingabeaufforderung: `"normal"` oder `"vim"`. Wird in `/config` als **Editor mode** angezeigt | `"vim"` |

268| `effortLevel` | Persistieren Sie die [Anstrengungsstufe](/de/model-config#adjust-effort-level) über Sitzungen hinweg. Akzeptiert `"low"`, `"medium"`, `"high"` oder `"xhigh"`. Wird automatisch geschrieben, wenn Sie `/effort` mit einem dieser Werte ausführen. `--effort` und [`CLAUDE_CODE_EFFORT_LEVEL`](/de/env-vars) überschreiben dies für eine Sitzung. Siehe [Anstrengungsstufe anpassen](/de/model-config#adjust-effort-level) für unterstützte Modelle | `"xhigh"` |268| `effortLevel` | Persistieren Sie die [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) über Sitzungen hinweg. Akzeptiert `"low"`, `"medium"`, `"high"` oder `"xhigh"`. Wird automatisch geschrieben, wenn Sie `/effort` mit einem dieser Werte ausführen. `--effort` und [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/de/env-vars) überschreiben dies für eine Sitzung. Siehe [Anstrengungsstufe anpassen](/docs/de/model-config#adjust-effort-level) für unterstützte Modelle | `"xhigh"` |

269| `enableAllProjectMcpServers` | Genehmigen Sie automatisch alle MCP-Server, die in Projekt-`.mcp.json`-Dateien definiert sind. {/* min-version: 2.1.196 */}Ab v2.1.196 berücksichtigen `claude mcp list` und `claude mcp get` diesen Schlüssel in einem nicht vertrauenswürdigen Ordner nur aus [Einstellungsdateien, die nicht in das Repository eingecheckt sind](/de/mcp#managing-your-servers) | `true` |269| `enableAllProjectMcpServers` | Genehmigen Sie automatisch alle MCP-Server, die in Projekt-`.mcp.json`-Dateien definiert sind. Ab v2.1.196 berücksichtigen `claude mcp list` und `claude mcp get` diesen Schlüssel in einem nicht vertrauenswürdigen Ordner nur aus [Einstellungsdateien, die nicht in das Repository eingecheckt sind](/docs/de/mcp#managing-your-servers) | `true` |

270| `enableArtifact` | {/* min-version: 2.1.196 */}Aktivieren oder deaktivieren Sie das [Artifact](/de/artifacts)-Tool für diesen Benutzer. Wenn nicht gesetzt, folgt der Standard der [Verfügbarkeit](/de/artifacts#availability) der Funktion für Ihr Konto. Die Zeile **Artifacts** in `/config` schreibt diesen Schlüssel. Ein verwaltetes `disableArtifact` und die [Admin-Einstellung](/de/artifacts#manage-artifacts-for-your-organization) Ihrer Organisation haben Vorrang, und der Schlüssel wird in Projekt- und lokalen Einstellungen (`.claude/settings.json`, `.claude/settings.local.json`) ignoriert, die ein Repository ansonsten committen könnte. Erfordert Claude Code v2.1.196 oder später | `true` |270| `enableArtifact` | Aktivieren oder deaktivieren Sie das [Artifact](/docs/de/artifacts)-Tool für diesen Benutzer. Wenn nicht gesetzt, folgt der Standard der [Verfügbarkeit](/docs/de/artifacts#availability) der Funktion für Ihr Konto. Die Zeile **Artifacts** in `/config` schreibt diesen Schlüssel. Ein verwaltetes `disableArtifact` und die [Admin-Einstellung](/docs/de/artifacts#manage-artifacts-for-your-organization) Ihrer Organisation haben Vorrang, und der Schlüssel wird in Projekt- und lokalen Einstellungen (`.claude/settings.json`, `.claude/settings.local.json`) ignoriert, die ein Repository ansonsten committen könnte. Erfordert Claude Code v2.1.196 oder später | `true` |

271| `enabledMcpjsonServers` | Liste spezifischer MCP-Server aus `.mcp.json`-Dateien zum Genehmigen. {/* min-version: 2.1.196 */}Ab v2.1.196 berücksichtigen `claude mcp list` und `claude mcp get` diesen Schlüssel in einem nicht vertrauenswürdigen Ordner nur aus [Einstellungsdateien, die nicht in das Repository eingecheckt sind](/de/mcp#managing-your-servers) | `["memory", "github"]` |271| `enabledMcpjsonServers` | Liste spezifischer MCP-Server aus `.mcp.json`-Dateien zum Genehmigen. Ab v2.1.196 berücksichtigen `claude mcp list` und `claude mcp get` diesen Schlüssel in einem nicht vertrauenswürdigen Ordner nur aus [Einstellungsdateien, die nicht in das Repository eingecheckt sind](/docs/de/mcp#managing-your-servers) | `["memory", "github"]` |

272| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Erweitern Sie die `availableModels` Allowlist auf das Standardmodell. Wenn `true` in verwalteten Einstellungen und `availableModels` ist ein nicht leeres Array, fällt die Standardoption auf den ersten zulässigen Eintrag zurück, der verfügbar ist, aber nur wenn das Modell, auf das Standard zurückfallen würde (die [Organisationsstandardeinstellung](/de/model-config#organization-default-model), wenn eine gilt, ansonsten die Kontotyp-Standard), nicht in der Allowlist ist; ein zulässiger Standard wird wie es ist beibehalten. Hat keine Auswirkung, wenn `availableModels` nicht gesetzt oder leer ist. Siehe [Erzwingen Sie die Allowlist für das Standardmodell](/de/model-config#enforce-the-allowlist-for-the-default-model). Erfordert Claude Code v2.1.175 oder später | `true` |272| `enforceAvailableModels` | Erweitern Sie die `availableModels` Allowlist auf das Standardmodell. Wenn `true` in verwalteten Einstellungen und `availableModels` ist ein nicht leeres Array, fällt die Standardoption auf den ersten zulässigen Eintrag zurück, der verfügbar ist, aber nur wenn das Modell, auf das Standard zurückfallen würde (die [Organisationsstandardeinstellung](/docs/de/model-config#organization-default-model), wenn eine gilt, ansonsten die Kontotyp-Standard), nicht in der Allowlist ist; ein zulässiger Standard wird wie es ist beibehalten. Hat keine Auswirkung, wenn `availableModels` nicht gesetzt oder leer ist. Siehe [Erzwingen Sie die Allowlist für das Standardmodell](/docs/de/model-config#enforce-the-allowlist-for-the-default-model). Erfordert Claude Code v2.1.175 oder später | `true` |

273| `env` | Umgebungsvariablen, die auf jede Sitzung und auf Subprozesse angewendet werden, die Claude Code von ihr aus startet. Setzen Sie eine Variable auf `""`, um einen Shell-Export mit einer leeren Zeichenkette zu überschreiben, die Claude Code als nicht gesetzt behandelt. Subprozesse erben weiterhin den leeren Wert. `NO_COLOR` und `FORCE_COLOR`, die hier gesetzt sind, erreichen nur Subprozesse; um die Farben der Claude Code-Oberfläche selbst zu ändern, setzen Sie sie in Ihrer Shell, bevor Sie `claude` starten. {/* min-version: 2.1.195 */}Ab v2.1.195 werden Identitätsvariablen, die Claude Code's Hosting-Umgebungen setzen, z. B. `CLAUDE_CODE_REMOTE` und `CLAUDE_CODE_ACCOUNT_UUID`, ignoriert, wenn sie hier gesetzt sind | `{"FOO": "bar"}` |273| `env` | Umgebungsvariablen, die auf jede Sitzung und auf Subprozesse angewendet werden, die Claude Code von ihr aus startet. Setzen Sie eine Variable auf `""`, um einen Shell-Export mit einer leeren Zeichenkette zu überschreiben, die Claude Code als nicht gesetzt behandelt. Subprozesse erben weiterhin den leeren Wert. `NO_COLOR` und `FORCE_COLOR`, die hier gesetzt sind, erreichen nur Subprozesse; um die Farben der Claude Code-Oberfläche selbst zu ändern, setzen Sie sie in Ihrer Shell, bevor Sie `claude` starten. Ab v2.1.195 werden Identitätsvariablen, die Claude Code's Hosting-Umgebungen setzen, z. B. `CLAUDE_CODE_REMOTE` und `CLAUDE_CODE_ACCOUNT_UUID`, ignoriert, wenn sie hier gesetzt sind | `{"FOO": "bar"}` |

274| `fallbackModel` | Fallback-Modell(e) zum Ausprobieren in der Reihenfolge, wenn das primäre Modell überlastet oder nicht verfügbar ist. Claude Code wechselt für den Rest der Runde zum nächsten verfügbaren Modell in der Kette und zeigt einen Hinweis an. `"default"` wird zum Standardmodell erweitert. Ketten sind auf drei Modelle begrenzt; zusätzliche Einträge werden ignoriert. Im Gegensatz zu den meisten Array-Einstellungen wird dieser Schlüssel nicht über Einstellungsdateien zusammengeführt: Die Datei mit der höchsten Priorität, die ihn definiert, liefert die gesamte Kette. Das Flag [`--fallback-model`](/de/cli-reference#cli-flags) überschreibt dies für eine Sitzung. Siehe [Fallback-Modellketten](/de/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |274| `fallbackModel` | Fallback-Modell(e) zum Ausprobieren in der Reihenfolge, wenn das primäre Modell überlastet oder nicht verfügbar ist. Claude Code wechselt für den Rest der Runde zum nächsten verfügbaren Modell in der Kette und zeigt einen Hinweis an. `"default"` wird zum Standardmodell erweitert. Ketten sind auf drei Modelle begrenzt; zusätzliche Einträge werden ignoriert. Im Gegensatz zu den meisten Array-Einstellungen wird dieser Schlüssel nicht über Einstellungsdateien zusammengeführt: Die Datei mit der höchsten Priorität, die ihn definiert, liefert die gesamte Kette. Das Flag [`--fallback-model`](/docs/de/cli-reference#cli-flags) überschreibt dies für eine Sitzung. Siehe [Fallback-Modellketten](/docs/de/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |

275| `fastMode` | Aktivieren Sie [schnellen Modus](/de/fast-mode) für Sitzungen, in denen er verfügbar ist. Das Umschalten mit `/fast` schreibt `true` hier in Benutzereinstellungen und entfernt den Schlüssel, wenn Sie den schnellen Modus ausschalten | `true` |275| `fastMode` | Aktivieren Sie [schnellen Modus](/docs/de/fast-mode) für Sitzungen, in denen er verfügbar ist. Das Umschalten mit `/fast` schreibt `true` hier in Benutzereinstellungen und entfernt den Schlüssel, wenn Sie den schnellen Modus ausschalten | `true` |

276| `fastModePerSessionOptIn` | Wenn `true`, bleibt der schnelle Modus nicht über Sitzungen hinweg bestehen. Jede Sitzung startet mit ausgeschaltetem schnellen Modus und erfordert, dass Benutzer ihn mit `/fast` aktivieren. Die Voreinstellung des Benutzers für den schnellen Modus wird weiterhin gespeichert. Siehe [Opt-in pro Sitzung erforderlich](/de/fast-mode#require-per-session-opt-in) | `true` |276| `fastModePerSessionOptIn` | Wenn `true`, bleibt der schnelle Modus nicht über Sitzungen hinweg bestehen. Jede Sitzung startet mit ausgeschaltetem schnellen Modus und erfordert, dass Benutzer ihn mit `/fast` aktivieren. Die Voreinstellung des Benutzers für den schnellen Modus wird weiterhin gespeichert. Siehe [Opt-in pro Sitzung erforderlich](/docs/de/fast-mode#require-per-session-opt-in) | `true` |

277| `feedbackSurveyRate` | Wahrscheinlichkeit (0–1), dass die [Sitzungsqualitätsumfrage](/de/data-usage#session-quality-surveys) angezeigt wird, wenn berechtigt. Setzen Sie auf `0`, um vollständig zu unterdrücken, oder setzen Sie [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/de/env-vars) in `env`. Nützlich bei Verwendung von Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry, wo die Standard-Stichprobenquote nicht gilt | `0.05` |277| `feedbackSurveyRate` | Wahrscheinlichkeit (0–1), dass die [Sitzungsqualitätsumfrage](/docs/de/data-usage#session-quality-surveys) angezeigt wird, wenn berechtigt. Setzen Sie auf `0`, um vollständig zu unterdrücken, oder setzen Sie [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/docs/de/env-vars) in `env`. Nützlich bei Verwendung von Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry, wo die Standard-Stichprobenquote nicht gilt | `0.05` |

278| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**Standard**: `true`. Erstellen Sie Snapshots von Dateien vor jeder Bearbeitung, damit [`/rewind`](/de/checkpointing) sie wiederherstellen kann. Wird in `/config` als **Rewind code (checkpoints)** angezeigt. Um dies über eine Umgebungsvariable zu deaktivieren, setzen Sie [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/de/env-vars) in `env` | `false` |278| `fileCheckpointingEnabled` | **Standard**: `true`. Erstellen Sie Snapshots von Dateien vor jeder Bearbeitung, damit [`/rewind`](/docs/de/checkpointing) sie wiederherstellen kann. Wird in `/config` als **Rewind code (checkpoints)** angezeigt. Um dies über eine Umgebungsvariable zu deaktivieren, setzen Sie [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/docs/de/env-vars) in `env` | `false` |

279| `fileSuggestion` | Konfigurieren Sie ein benutzerdefiniertes Skript für `@` Datei-Autovervollständigung. Siehe [Dateivorschlag-Einstellungen](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |279| `fileSuggestion` | Konfigurieren Sie ein benutzerdefiniertes Skript für `@` Datei-Autovervollständigung. Siehe [Dateivorschlag-Einstellungen](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |

280| `footerLinksRegexes` | {/* min-version: 2.1.176 */}Rendern Sie zusätzliche anklickbare Badges in der Fußzeile, wenn ein Regex die Ausgabe der Runde abgleicht. Jeder Eintrag hat ein `pattern`, eine URL-Vorlage mit `{name}` Platzhaltern, die aus benannten Erfassungsgruppen gefüllt werden, und ein optionales `label`. Nur aus Benutzereinstellungen, dem Flag `--settings` und verwalteten Einstellungen gelesen. Siehe [Footer-Link-Badges](#footer-link-badges) für URL-Einschränkungen, Scheme-Allowlist und Limits. Erfordert Claude Code v2.1.176 oder später | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |280| `footerLinksRegexes` | Rendern Sie zusätzliche anklickbare Badges in der Fußzeile, wenn ein Regex die Ausgabe der Runde abgleicht. Jeder Eintrag hat ein `pattern`, eine URL-Vorlage mit `{name}` Platzhaltern, die aus benannten Erfassungsgruppen gefüllt werden, und ein optionales `label`. Nur aus Benutzereinstellungen, dem Flag `--settings` und verwalteten Einstellungen gelesen. Siehe [Footer-Link-Badges](#footer-link-badges) für URL-Einschränkungen, Scheme-Allowlist und Limits. Erfordert Claude Code v2.1.176 oder später | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |

281| `forceLoginMethod` | Verwenden Sie `claudeai`, um die Anmeldung auf Claude.ai-Konten zu beschränken, `console`, um die Anmeldung auf Claude Console-Konten zu beschränken, oder `gateway`, um die Anmeldung auf ein Cloud-Gateway zu beschränken; siehe [Claude-Apps-Gateway](/de/claude-apps-gateway). Wenn in verwalteten Einstellungen gesetzt, werden Sitzungen, die durch `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert sind, beim Start blockiert, da eine Umgebungsanmeldedaten die erforderliche Anmeldungsmethode nicht erfüllen kann. Drittanbieter-Provider-Sitzungen wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry werden nicht blockiert: Sie authentifizieren sich gegen Ihren Cloud-Provider statt gegen Anthropic | `claudeai` |281| `forceLoginMethod` | Verwenden Sie `claudeai`, um die Anmeldung auf Claude.ai-Konten zu beschränken, `console`, um die Anmeldung auf Claude Console-Konten zu beschränken, oder `gateway`, um die Anmeldung auf ein Cloud-Gateway zu beschränken; siehe [Claude-Apps-Gateway](/docs/de/claude-apps-gateway). Wenn in verwalteten Einstellungen gesetzt, werden Sitzungen, die durch `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert sind, beim Start blockiert, da eine Umgebungsanmeldedaten die erforderliche Anmeldungsmethode nicht erfüllen kann. Drittanbieter-Provider-Sitzungen wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry werden nicht blockiert: Sie authentifizieren sich gegen Ihren Cloud-Provider statt gegen Anthropic | `claudeai` |

282| `forceLoginGatewayUrl` | Füllt den Gateway-URL auf dem `/login` Cloud-Gateway-Bildschirm aus und sperrt ihn. Entweder dieser Schlüssel oder `forceLoginMethod: "gateway"` zeigt diesen Bildschirm an; setzen Sie beide, damit die URL ausgefüllt ist. Wird nur auf der verwalteten Richtlinienebene berücksichtigt; ignoriert in Benutzer- und Projekteinstellungen. Siehe [Claude-Apps-Gateway](/de/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |282| `forceLoginGatewayUrl` | Füllt den Gateway-URL auf dem `/login` Cloud-Gateway-Bildschirm aus und sperrt ihn. Entweder dieser Schlüssel oder `forceLoginMethod: "gateway"` zeigt diesen Bildschirm an; setzen Sie beide, damit die URL ausgefüllt ist. Wird nur auf der verwalteten Richtlinienebene berücksichtigt; ignoriert in Benutzer- und Projekteinstellungen. Siehe [Claude-Apps-Gateway](/docs/de/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |

283| `forceLoginOrgUUID` | Geben Sie die UUID einer Organisation an, um sie während der Anmeldung automatisch auszuwählen und den Organisationsauswahlschritt zu umgehen, oder akzeptieren Sie ein Array von UUIDs, wobei jede aufgelistete Organisation ohne Vorauswahl akzeptiert wird. Wenn in verwalteten Einstellungen gesetzt, schlägt die Anmeldung fehl, wenn das authentifizierte Konto nicht zu einer aufgelisteten Organisation gehört, und Sitzungen, die durch `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert sind, werden beim Start blockiert, da die Organisationszugehörigkeit für sie nicht überprüft werden kann. Drittanbieter-Provider-Sitzungen wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry werden nicht blockiert: Verwenden Sie Ihre Cloud-IAM, um einzuschränken, welche Cloud-Konten verwendet werden können. Ein leeres Array schlägt geschlossen fehl und blockiert die Anmeldung mit einer Fehlkonfigurationsmeldung | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` oder `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |283| `forceLoginOrgUUID` | Geben Sie die UUID einer Organisation an, um sie während der Anmeldung automatisch auszuwählen und den Organisationsauswahlschritt zu umgehen, oder akzeptieren Sie ein Array von UUIDs, wobei jede aufgelistete Organisation ohne Vorauswahl akzeptiert wird. Wenn in verwalteten Einstellungen gesetzt, schlägt die Anmeldung fehl, wenn das authentifizierte Konto nicht zu einer aufgelisteten Organisation gehört, und Sitzungen, die durch `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` oder `apiKeyHelper` authentifiziert sind, werden beim Start blockiert, da die Organisationszugehörigkeit für sie nicht überprüft werden kann. Drittanbieter-Provider-Sitzungen wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry werden nicht blockiert: Verwenden Sie Ihre Cloud-IAM, um einzuschränken, welche Cloud-Konten verwendet werden können. Ein leeres Array schlägt geschlossen fehl und blockiert die Anmeldung mit einer Fehlkonfigurationsmeldung | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` oder `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |

284| `forceRemoteSettingsRefresh` | (Nur verwaltete Einstellungen) Blockieren Sie den CLI-Start, bis verwaltete Einstellungen aus der Ferne vom Server abgerufen werden. Wenn der Abruf fehlschlägt, wird die CLI beendet, anstatt mit zwischengespeicherten oder keinen Einstellungen fortzufahren. Wenn nicht gesetzt, wird der Start ohne Warten auf Remote-Einstellungen fortgesetzt. Siehe [Fail-Closed-Durchsetzung](/de/server-managed-settings#enforce-fail-closed-startup) | `true` |284| `forceRemoteSettingsRefresh` | (Nur verwaltete Einstellungen) Blockieren Sie den CLI-Start, bis verwaltete Einstellungen aus der Ferne vom Server abgerufen werden. Wenn der Abruf fehlschlägt, wird die CLI beendet, anstatt mit zwischengespeicherten oder keinen Einstellungen fortzufahren. Wenn nicht gesetzt, wird der Start ohne Warten auf Remote-Einstellungen fortgesetzt. Siehe [Fail-Closed-Durchsetzung](/docs/de/server-managed-settings#enforce-fail-closed-startup) | `true` |

285| `gcpAuthRefresh` | Benutzerdefiniertes Skript, das GCP Application Default Credentials aktualisiert, wenn sie ablaufen oder nicht geladen werden können. Siehe [erweiterte Anmeldedatenkonfiguration](/de/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |285| `gcpAuthRefresh` | Benutzerdefiniertes Skript, das GCP Application Default Credentials aktualisiert, wenn sie ablaufen oder nicht geladen werden können. Siehe [erweiterte Anmeldedatenkonfiguration](/docs/de/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |

286| `hooks` | Konfigurieren Sie benutzerdefinierte Befehle, die bei Lebenszyklusereignissen ausgeführt werden. Siehe [Hooks-Dokumentation](/de/hooks) für das Format | Siehe [Hooks](/de/hooks) |286| `hooks` | Konfigurieren Sie benutzerdefinierte Befehle, die bei Lebenszyklusereignissen ausgeführt werden. Siehe [Hooks-Dokumentation](/docs/de/hooks) für das Format | Siehe [Hooks](/docs/de/hooks) |

287| `httpHookAllowedEnvVars` | Allowlist von Umgebungsvariablennamen, die HTTP-Hooks in Header interpolieren können. Wenn gesetzt, ist die effektive `allowedEnvVars` jedes Hooks der Schnittpunkt mit dieser Liste. Undefined = keine Einschränkung. Arrays werden über Einstellungsquellen zusammengeführt. Siehe [Hook-Konfiguration](#hook-configuration) | `["MY_TOKEN", "HOOK_SECRET"]` |287| `httpHookAllowedEnvVars` | Allowlist von Umgebungsvariablennamen, die HTTP-Hooks in Header interpolieren können. Wenn gesetzt, ist die effektive `allowedEnvVars` jedes Hooks der Schnittpunkt mit dieser Liste. Undefined = keine Einschränkung. Arrays werden über Einstellungsquellen zusammengeführt. Siehe [Hook-Konfiguration](#hook-configuration) | `["MY_TOKEN", "HOOK_SECRET"]` |

288| `includeGitInstructions` | **Standard**: `true`. Integrierte Commit- und PR-Workflow-Anweisungen und den Git-Status-Snapshot in Claudes Systemaufforderung einbeziehen. Setzen Sie auf `false`, um beide zu entfernen, z. B. wenn Sie Ihre eigenen Git-Workflow-Skills verwenden. Die Umgebungsvariable `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` hat Vorrang vor dieser Einstellung, wenn sie gesetzt ist | `false` |288| `includeGitInstructions` | **Standard**: `true`. Integrierte Commit- und PR-Workflow-Anweisungen und den Git-Status-Snapshot in Claudes Systemaufforderung einbeziehen. Setzen Sie auf `false`, um beide zu entfernen, z. B. wenn Sie Ihre eigenen Git-Workflow-Skills verwenden. Die Umgebungsvariable `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` hat Vorrang vor dieser Einstellung, wenn sie gesetzt ist | `false` |

289| `inputNeededNotifEnabled` | {/* min-version: 2.1.119 */}**Standard**: `false`. Wenn [Remote Control](/de/remote-control) verbunden ist, senden Sie eine Push-Benachrichtigung an Ihr Telefon, wenn eine Berechtigungsaufforderung oder Frage auf Ihre Eingabe wartet. Wird in `/config` als **Push when actions required** angezeigt. Siehe [Mobile Push-Benachrichtigungen](/de/remote-control#mobile-push-notifications). Erfordert Claude Code v2.1.119 oder später | `true` |289| `inputNeededNotifEnabled` | **Standard**: `false`. Wenn [Remote Control](/docs/de/remote-control) verbunden ist, senden Sie eine Push-Benachrichtigung an Ihr Telefon, wenn eine Berechtigungsaufforderung oder Frage auf Ihre Eingabe wartet. Wird in `/config` als **Push when actions required** angezeigt. Siehe [Mobile Push-Benachrichtigungen](/docs/de/remote-control#mobile-push-notifications). Erfordert Claude Code v2.1.119 oder später | `true` |

290| `language` | Konfigurieren Sie Claudes bevorzugte Antwortsprache (z. B. `"japanese"`, `"spanish"`, `"french"`). Claude wird standardmäßig in dieser Sprache antworten. Legt auch die Sprache für [Sprachdiktieren](/de/voice-dictation#change-the-dictation-language) und automatisch generierte Sitzungstitel fest. {/* min-version: 2.1.176 */}Ab v2.1.176 entsprechen Sitzungstitel, wenn nicht gesetzt, der Sprache Ihres Gesprächs | `"japanese"` |290| `language` | Konfigurieren Sie Claudes bevorzugte Antwortsprache (z. B. `"japanese"`, `"spanish"`, `"french"`). Claude wird standardmäßig in dieser Sprache antworten. Legt auch die Sprache für [Sprachdiktieren](/docs/de/voice-dictation#change-the-dictation-language) und automatisch generierte Sitzungstitel fest. Ab v2.1.176 entsprechen Sitzungstitel, wenn nicht gesetzt, der Sprache Ihres Gesprächs | `"japanese"` |

291| `minimumVersion` | Verhindern Sie, dass der Auto-Updater und `claude update` eine Version unter dieser installieren. Das Wechseln vom `"latest"`-Kanal zu `"stable"` über `/config` fordert Sie auf, auf der aktuellen Version zu bleiben oder das Downgrade zu erlauben. Wenn Sie sich entscheiden zu bleiben, wird dieser Wert gesetzt. Auch nützlich in [verwalteten Einstellungen](/de/permissions#managed-settings) um eine organisationsweite Mindestversion festzulegen. Für einen Hard Floor, der den Start vollständig blockiert, siehe `requiredMinimumVersion` | `"2.1.100"` |291| `minimumVersion` | Verhindern Sie, dass der Auto-Updater und `claude update` eine Version unter dieser installieren. Das Wechseln vom `"latest"`-Kanal zu `"stable"` über `/config` fordert Sie auf, auf der aktuellen Version zu bleiben oder das Downgrade zu erlauben. Wenn Sie sich entscheiden zu bleiben, wird dieser Wert gesetzt. Auch nützlich in [verwalteten Einstellungen](/docs/de/permissions#managed-settings) um eine organisationsweite Mindestversion festzulegen. Für einen Hard Floor, der den Start vollständig blockiert, siehe `requiredMinimumVersion` | `"2.1.100"` |

292| `model` | Überschreiben Sie das Standardmodell für Claude Code. `--model` und [`ANTHROPIC_MODEL`](/de/model-config#environment-variables) überschreiben dies für eine Sitzung | `"claude-sonnet-5"` |292| `model` | Überschreiben Sie das Standardmodell für Claude Code. `--model` und [`ANTHROPIC_MODEL`](/docs/de/model-config#environment-variables) überschreiben dies für eine Sitzung | `"claude-sonnet-5"` |

293| `modelOverrides` | Ordnen Sie Anthropic-Modell-IDs Anbieter-spezifischen Modell-IDs wie Amazon Bedrock-Inferenzprofil-ARNs zu. Jeder Modellwähler-Eintrag verwendet seinen zugeordneten Wert beim Aufrufen der Anbieter-API. Siehe [Modell-IDs pro Version überschreiben](/de/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |293| `modelOverrides` | Ordnen Sie Anthropic-Modell-IDs Anbieter-spezifischen Modell-IDs wie Amazon Bedrock-Inferenzprofil-ARNs zu. Jeder Modellwähler-Eintrag verwendet seinen zugeordneten Wert beim Aufrufen der Anbieter-API. Siehe [Modell-IDs pro Version überschreiben](/docs/de/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |

294| `otelHeadersHelper` | Skript zum Generieren dynamischer OpenTelemetry-Header. Wird beim Start und regelmäßig ausgeführt. Setzen Sie das Aktualisierungsintervall mit [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/de/env-vars). Siehe [Dynamische Header](/de/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |294| `otelHeadersHelper` | Skript zum Generieren dynamischer OpenTelemetry-Header. Wird beim Start und regelmäßig ausgeführt. Setzen Sie das Aktualisierungsintervall mit [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/de/env-vars). Siehe [Dynamische Header](/docs/de/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |

295| `outputStyle` | Konfigurieren Sie einen Ausgabestil, um die Systemaufforderung anzupassen. Siehe [Ausgabestil-Dokumentation](/de/output-styles) | `"Explanatory"` |295| `outputStyle` | Konfigurieren Sie einen Ausgabestil, um die Systemaufforderung anzupassen. Siehe [Ausgabestil-Dokumentation](/docs/de/output-styles) | `"Explanatory"` |

296| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Nur verwaltete Einstellungen) **Standard**: `"first-wins"`. Steuert, ob verwaltete Einstellungen, die programmgesteuert von einem eingebetteten Host-Prozess wie dem Agent SDK oder einer IDE-Erweiterung bereitgestellt werden, gelten, wenn auch eine von Admin bereitgestellte verwaltete Ebene vorhanden ist. `"first-wins"`: die von Parent bereitgestellten Einstellungen werden verworfen und nur die Admin-Ebene gilt. `"merge"`: die von Parent bereitgestellten Einstellungen gelten unter der Admin-Ebene, gefiltert, sodass sie die Richtlinie verschärfen, aber nicht lockern können. Hat keine Auswirkung, wenn keine Admin-Ebene bereitgestellt wird. Erfordert Claude Code v2.1.133 oder später | `"merge"` |296| `parentSettingsBehavior` | (Nur verwaltete Einstellungen) **Standard**: `"first-wins"`. Steuert, ob verwaltete Einstellungen, die programmgesteuert von einem eingebetteten Host-Prozess wie dem Agent SDK oder einer IDE-Erweiterung bereitgestellt werden, gelten, wenn auch eine von Admin bereitgestellte verwaltete Ebene vorhanden ist. `"first-wins"`: die von Parent bereitgestellten Einstellungen werden verworfen und nur die Admin-Ebene gilt. `"merge"`: die von Parent bereitgestellten Einstellungen gelten unter der Admin-Ebene, gefiltert, sodass sie die Richtlinie verschärfen, aber nicht lockern können. Hat keine Auswirkung, wenn keine Admin-Ebene bereitgestellt wird. Erfordert Claude Code v2.1.133 oder später | `"merge"` |

299| `pluginSuggestionMarketplaces` | (Nur verwaltete Einstellungen) Marketplace-Namen, deren Plugins als kontextuelle Installationsvorschläge angezeigt werden können. Keine Marketplace-deklarierten Vorschläge werden ohne diese Allowlist angezeigt; der integrierte First-Party-Frontend-Design-Tipp ist nicht betroffen. Vorschläge stammen aus der `relevance`-Deklaration jedes Plugins in seinem Marketplace-Eintrag. Ein Name wird nur wirksam, wenn der Marketplace auf der Maschine registriert ist und seine registrierte Quelle auch in verwalteten Einstellungen deklariert ist, entweder als `extraKnownMarketplaces`-Eintrag für diesen Namen oder als Eintrag von `strictKnownMarketplaces`. Ein Marketplace, der unter einem zulässigen Namen aus einer anderen Quelle registriert ist, wird ignoriert. Der offizielle Marketplace ist von der Quellanforderung befreit: Das Zulassen seines Namens allein genügt, da dieser Name nur von der offiziellen Anthropic-Quelle registriert werden kann. | `["acme-corp-plugins"]` |299| `pluginSuggestionMarketplaces` | (Nur verwaltete Einstellungen) Marketplace-Namen, deren Plugins als kontextuelle Installationsvorschläge angezeigt werden können. Keine Marketplace-deklarierten Vorschläge werden ohne diese Allowlist angezeigt; der integrierte First-Party-Frontend-Design-Tipp ist nicht betroffen. Vorschläge stammen aus der `relevance`-Deklaration jedes Plugins in seinem Marketplace-Eintrag. Ein Name wird nur wirksam, wenn der Marketplace auf der Maschine registriert ist und seine registrierte Quelle auch in verwalteten Einstellungen deklariert ist, entweder als `extraKnownMarketplaces`-Eintrag für diesen Namen oder als Eintrag von `strictKnownMarketplaces`. Ein Marketplace, der unter einem zulässigen Namen aus einer anderen Quelle registriert ist, wird ignoriert. Der offizielle Marketplace ist von der Quellanforderung befreit: Das Zulassen seines Namens allein genügt, da dieser Name nur von der offiziellen Anthropic-Quelle registriert werden kann. | `["acme-corp-plugins"]` |

300| `pluginTrustMessage` | (Nur verwaltete Einstellungen) Benutzerdefinierte Nachricht, die der vor der Installation angezeigten Plugin-Vertrauenswarnung angehängt wird. Verwenden Sie dies, um organisationsspezifischen Kontext hinzuzufügen, z. B. um zu bestätigen, dass Plugins aus Ihrem internen Marketplace überprüft sind. | `"All plugins from our marketplace are approved by IT"` |300| `pluginTrustMessage` | (Nur verwaltete Einstellungen) Benutzerdefinierte Nachricht, die der vor der Installation angezeigten Plugin-Vertrauenswarnung angehängt wird. Verwenden Sie dies, um organisationsspezifischen Kontext hinzuzufügen, z. B. um zu bestätigen, dass Plugins aus Ihrem internen Marketplace überprüft sind. | `"All plugins from our marketplace are approved by IT"` |

301| `policyHelper` | {/* min-version: 2.1.136 */}Von Admin bereitgestellte ausführbare Datei, die verwaltete Einstellungen dynamisch beim Start berechnet. Wird nur von MDM oder einer System-`managed-settings.json`-Datei berücksichtigt. Siehe [Berechnen Sie verwaltete Einstellungen mit einem Policy Helper](#compute-managed-settings-with-a-policy-helper). Erfordert Claude Code v2.1.136 oder später | `{"path": "/usr/local/bin/claude-policy"}` |301| `policyHelper` | Von Admin bereitgestellte ausführbare Datei, die verwaltete Einstellungen dynamisch beim Start berechnet. Wird nur von MDM oder einer System-`managed-settings.json`-Datei berücksichtigt. Siehe [Berechnen Sie verwaltete Einstellungen mit einem Policy Helper](#compute-managed-settings-with-a-policy-helper). Erfordert Claude Code v2.1.136 oder später | `{"path": "/usr/local/bin/claude-policy"}` |

302| `preferredNotifChannel` | **Standard**: `"auto"`. Methode für Task-Complete- und Berechtigungsaufforderungs-Benachrichtigungen: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"` oder `"notifications_disabled"`. `"auto"` sendet eine Desktop-Benachrichtigung in iTerm2, Ghostty und Kitty und tut nichts in anderen Terminals. Setzen Sie `"terminal_bell"`, um das Glockenzeichen in jedem Terminal zu klingeln. Wird in `/config` als **Notifications** angezeigt. Siehe [Erhalten Sie einen Terminal-Glockenzeichen oder eine Benachrichtigung](/de/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |302| `preferredNotifChannel` | **Standard**: `"auto"`. Methode für Task-Complete- und Berechtigungsaufforderungs-Benachrichtigungen: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"` oder `"notifications_disabled"`. `"auto"` sendet eine Desktop-Benachrichtigung in iTerm2, Ghostty und Kitty und tut nichts in anderen Terminals. Setzen Sie `"terminal_bell"`, um das Glockenzeichen in jedem Terminal zu klingeln. Wird in `/config` als **Notifications** angezeigt. Siehe [Erhalten Sie einen Terminal-Glockenzeichen oder eine Benachrichtigung](/docs/de/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |

304| `prUrlTemplate` | URL-Vorlage für das PR-Badge, das in der Fußzeile und in Tool-Ergebnis-Zusammenfassungen angezeigt wird. Ersetzt `{host}`, `{owner}`, `{repo}`, `{number}` und `{url}` aus der von `gh` gemeldeten PR-URL. Verwenden Sie dies, um PR-Links auf ein internes Code-Review-Tool statt auf `github.com` zu verweisen. Beeinflusst nicht `#123` Autolinks in Claudes Prosa | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |304| `prUrlTemplate` | URL-Vorlage für das PR-Badge, das in der Fußzeile und in Tool-Ergebnis-Zusammenfassungen angezeigt wird. Ersetzt `{host}`, `{owner}`, `{repo}`, `{number}` und `{url}` aus der von `gh` gemeldeten PR-URL. Verwenden Sie dies, um PR-Links auf ein internes Code-Review-Tool statt auf `github.com` zu verweisen. Beeinflusst nicht `#123` Autolinks in Claudes Prosa | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

305| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}Verbinden Sie [Remote Control](/de/remote-control) automatisch, wenn jede interaktive Sitzung startet, anstatt auf `/remote-control` zu warten. Setzen Sie auf `true`, um immer automatisch zu verbinden, `false`, um nie automatisch zu verbinden, oder lassen Sie es ungesetzt, um dem Standard Ihrer Organisation zu folgen. Wird in `/config` als **Enable Remote Control for all sessions** angezeigt. Siehe [Enable Remote Control for all sessions](/de/remote-control#enable-remote-control-for-all-sessions) | `false` |305| `remoteControlAtStartup` | Verbinden Sie [Remote Control](/docs/de/remote-control) automatisch, wenn jede interaktive Sitzung startet, anstatt auf `/remote-control` zu warten. Setzen Sie auf `true`, um immer automatisch zu verbinden, `false`, um nie automatisch zu verbinden, oder lassen Sie es ungesetzt, um dem Standard Ihrer Organisation zu folgen. Wird in `/config` als **Enable Remote Control for all sessions** angezeigt. Siehe [Enable Remote Control for all sessions](/docs/de/remote-control#enable-remote-control-for-all-sessions) | `false` |

306| `requiredMaximumVersion` | Nur verwaltete Einstellungen. Maximale Claude Code-Version, die gestartet werden darf. Wenn die laufende Version neuer ist, wird Claude Code beim Start beendet und der Benutzer wird angewiesen, eine genehmigte Version durch die Methode der Organisation zu installieren; `claude install <version>` kann auch funktionieren. Hintergrund-Auto-Updates und `claude update` überspringen Versionen über der Obergrenze, sodass eine In-Range-Installation in Range bleibt. `claude update`, `claude install` und `claude doctor` funktionieren weiterhin über der Obergrenze, damit Benutzer sich erholen können. Versionen, die diesem Setting vorausgehen, ignorieren es | `"2.1.150"` |306| `requiredMaximumVersion` | Nur verwaltete Einstellungen. Maximale Claude Code-Version, die gestartet werden darf. Wenn die laufende Version neuer ist, wird Claude Code beim Start beendet und der Benutzer wird angewiesen, eine genehmigte Version durch die Methode der Organisation zu installieren; `claude install <version>` kann auch funktionieren. Hintergrund-Auto-Updates und `claude update` überspringen Versionen über der Obergrenze, sodass eine In-Range-Installation in Range bleibt. `claude update`, `claude install` und `claude doctor` funktionieren weiterhin über der Obergrenze, damit Benutzer sich erholen können. Versionen, die diesem Setting vorausgehen, ignorieren es | `"2.1.150"` |

307| `requiredMinimumVersion` | Nur verwaltete Einstellungen. Minimale Claude Code-Version, die zum Start erforderlich ist. Wenn die laufende Version älter ist, wird Claude Code beim Start beendet und der Benutzer wird angewiesen, durch die Methode der Organisation zu aktualisieren. `claude update`, `claude install` und `claude doctor` funktionieren weiterhin unter der Untergrenze, damit Benutzer sich erholen können. Unterscheidet sich von `minimumVersion`, das Downgrades verhindert, aber den Start nie blockiert. Versionen, die diesem Setting vorausgehen, ignorieren es | `"2.1.150"` |307| `requiredMinimumVersion` | Nur verwaltete Einstellungen. Minimale Claude Code-Version, die zum Start erforderlich ist. Wenn die laufende Version älter ist, wird Claude Code beim Start beendet und der Benutzer wird angewiesen, durch die Methode der Organisation zu aktualisieren. `claude update`, `claude install` und `claude doctor` funktionieren weiterhin unter der Untergrenze, damit Benutzer sich erholen können. Unterscheidet sich von `minimumVersion`, das Downgrades verhindert, aber den Start nie blockiert. Versionen, die diesem Setting vorausgehen, ignorieren es | `"2.1.150"` |

308| `respectGitignore` | **Standard**: `true`. Steuern Sie, ob der `@` Datei-Picker `.gitignore`-Muster respektiert. Wenn `true`, werden Dateien, die `.gitignore`-Mustern entsprechen, aus Vorschlägen ausgeschlossen | `false` |308| `respectGitignore` | **Standard**: `true`. Steuern Sie, ob der `@` Datei-Picker `.gitignore`-Muster respektiert. Wenn `true`, werden Dateien, die `.gitignore`-Mustern entsprechen, aus Vorschlägen ausgeschlossen | `false` |

309| `respondToBashCommands` | {/* min-version: 2.1.186 */}**Standard**: `true`. Ob Claude nach einem Input-Box `!` Shell-Befehl antwortet. Setzen Sie auf `false`, um die Befehlsausgabe zum Kontext hinzuzufügen, ohne eine Antwort zu geben. Siehe [Shell-Modus mit `!` Präfix](/de/interactive-mode#shell-mode-with-prefix). Erfordert Claude Code v2.1.186 oder später | `false` |309| `respondToBashCommands` | **Standard**: `true`. Ob Claude nach einem Input-Box `!` Shell-Befehl antwortet. Setzen Sie auf `false`, um die Befehlsausgabe zum Kontext hinzuzufügen, ohne eine Antwort zu geben. Siehe [Shell-Modus mit `!` Präfix](/docs/de/interactive-mode#shell-mode-with-prefix). Erfordert Claude Code v2.1.186 oder später | `false` |

310| `showClearContextOnPlanAccept` | **Standard**: `false`. Zeigen Sie die Option "Kontext löschen" auf dem Plan-Akzeptanz-Bildschirm an. Setzen Sie auf `true`, um die Option wiederherzustellen | `true` |310| `showClearContextOnPlanAccept` | **Standard**: `false`. Zeigen Sie die Option "Kontext löschen" auf dem Plan-Akzeptanz-Bildschirm an. Setzen Sie auf `true`, um die Option wiederherzustellen | `true` |

311| `showThinkingSummaries` | **Standard**: `false`. Zeigen Sie [erweitertes Denken](/de/model-config#extended-thinking) Zusammenfassungen in interaktiven Sitzungen an. Wenn nicht gesetzt oder `false`, werden Denk-Blöcke von der API redigiert und als zusammengeklappter Stub angezeigt. Redaktion ändert nur, was Sie sehen, nicht was das Modell generiert: Um Denk-Ausgaben zu reduzieren, [senken Sie das Budget oder deaktivieren Sie das Denken](/de/model-config#extended-thinking) stattdessen. Dieser Einstellung hat keine Auswirkung im nicht-interaktiven Modus (`-p`), dem Agent SDK oder IDE-Erweiterungen wie VS Code | `true` |311| `showThinkingSummaries` | **Standard**: `false`. Zeigen Sie [erweitertes Denken](/docs/de/model-config#extended-thinking) Zusammenfassungen in interaktiven Sitzungen an. Wenn nicht gesetzt oder `false`, werden Denk-Blöcke von der API redigiert und als zusammengeklappter Stub angezeigt. Redaktion ändert nur, was Sie sehen, nicht was das Modell generiert: Um Denk-Ausgaben zu reduzieren, [senken Sie das Budget oder deaktivieren Sie das Denken](/docs/de/model-config#extended-thinking) stattdessen. Dieser Einstellung hat keine Auswirkung im nicht-interaktiven Modus (`-p`), dem Agent SDK oder IDE-Erweiterungen wie VS Code | `true` |

312| `showTurnDuration` | **Standard**: `true`. Zeigen Sie Nachrichten zur Dauer der Runde nach Antworten an, z. B. "Cooked for 1m 6s". Wird in `/config` als **Show turn duration** angezeigt | `false` |312| `showTurnDuration` | **Standard**: `true`. Zeigen Sie Nachrichten zur Dauer der Runde nach Antworten an, z. B. "Cooked for 1m 6s". Wird in `/config` als **Show turn duration** angezeigt | `false` |

313| `skillListingBudgetFraction` | **Standard**: `0.01`. Anteil des Kontextfensters des Modells, das für die [Skill-Auflistung](/de/skills#skill-descriptions-are-cut-short) reserviert ist, die Claude jede Runde sieht. Wenn die Auflistung das Budget überschreitet, werden Beschreibungen für die am wenigsten verwendeten Skills auf bloße Namen reduziert, sodass Claude sie weiterhin aufrufen kann, aber nicht sieht, warum. Erhöhen Sie, um mehr Beschreibungen sichtbar zu halten, auf Kosten von mehr Kontext pro Runde. `/doctor` zeigt die Auflistungskosten gegen das Budget | `0.02` |313| `skillListingBudgetFraction` | **Standard**: `0.01`. Anteil des Kontextfensters des Modells, das für die [Skill-Auflistung](/docs/de/skills#skill-descriptions-are-cut-short) reserviert ist, die Claude jede Runde sieht. Wenn die Auflistung das Budget überschreitet, werden Beschreibungen für die am wenigsten verwendeten Skills auf bloße Namen reduziert, sodass Claude sie weiterhin aufrufen kann, aber nicht sieht, warum. Erhöhen Sie, um mehr Beschreibungen sichtbar zu halten, auf Kosten von mehr Kontext pro Runde. `/doctor` zeigt die Auflistungskosten gegen das Budget | `0.02` |

314| `skillListingMaxDescChars` | **Standard**: `1536`. Pro-Skill-Zeichenbegrenzung für den kombinierten `description` und `when_to_use` Text in der [Skill-Auflistung](/de/skills#skill-descriptions-are-cut-short), die Claude jede Runde sieht. Text, der länger als dies ist, wird gekürzt. Erhöhen Sie, um lange Beschreibungen intakt zu halten, auf Kosten von mehr Kontext pro Runde; senken Sie, um mehr Skills unter [`skillListingBudgetFraction`](#available-settings) zu passen. | `2048` |314| `skillListingMaxDescChars` | **Standard**: `1536`. Pro-Skill-Zeichenbegrenzung für den kombinierten `description` und `when_to_use` Text in der [Skill-Auflistung](/docs/de/skills#skill-descriptions-are-cut-short), die Claude jede Runde sieht. Text, der länger als dies ist, wird gekürzt. Erhöhen Sie, um lange Beschreibungen intakt zu halten, auf Kosten von mehr Kontext pro Runde; senken Sie, um mehr Skills unter [`skillListingBudgetFraction`](#available-settings) zu passen. | `2048` |

315| `skillOverrides` | {/* min-version: 2.1.129 */}Pro-Skill-Sichtbarkeitsüberschreibungen, die nach Skill-Name verschlüsselt sind. Der Wert ist `"on"`, `"name-only"`, `"user-invocable-only"` oder `"off"`. Ermöglicht es Ihnen, einen Skill auszublenden oder zu reduzieren, ohne seine SKILL.md zu bearbeiten. Gilt nicht für Plugin-Skills, die über `/plugin` verwaltet werden. Das Menü `/skills` schreibt diese in `.claude/settings.local.json`. Siehe [Skill-Sichtbarkeit aus Einstellungen überschreiben](/de/skills#override-skill-visibility-from-settings). Erfordert Claude Code v2.1.129 oder später | `{"legacy-context": "name-only", "deploy": "off"}` |315| `skillOverrides` | Pro-Skill-Sichtbarkeitsüberschreibungen, die nach Skill-Name verschlüsselt sind. Der Wert ist `"on"`, `"name-only"`, `"user-invocable-only"` oder `"off"`. Ermöglicht es Ihnen, einen Skill auszublenden oder zu reduzieren, ohne seine SKILL.md zu bearbeiten. Gilt nicht für Plugin-Skills, die über `/plugin` verwaltet werden. Das Menü `/skills` schreibt diese in `.claude/settings.local.json`. Siehe [Skill-Sichtbarkeit aus Einstellungen überschreiben](/docs/de/skills#override-skill-visibility-from-settings). Erfordert Claude Code v2.1.129 oder später | `{"legacy-context": "name-only", "deploy": "off"}` |

316| `skipWebFetchPreflight` | Überspringen Sie die [WebFetch-Domänensicherheitsprüfung](/de/data-usage#webfetch-domain-safety-check), die jeden angeforderten Hostnamen an `api.anthropic.com` sendet, bevor Sie abrufen. Setzen Sie auf `true` in Umgebungen, die den Datenverkehr zu Anthropic blockieren, wie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry-Bereitstellungen mit restriktivem Ausgang. Wenn übersprungen, versucht WebFetch jede URL, ohne die Blocklist zu konsultieren | `true` |316| `skipWebFetchPreflight` | Überspringen Sie die [WebFetch-Domänensicherheitsprüfung](/docs/de/data-usage#webfetch-domain-safety-check), die jeden angeforderten Hostnamen an `api.anthropic.com` sendet, bevor Sie abrufen. Setzen Sie auf `true` in Umgebungen, die den Datenverkehr zu Anthropic blockieren, wie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry-Bereitstellungen mit restriktivem Ausgang. Wenn übersprungen, versucht WebFetch jede URL, ohne die Blocklist zu konsultieren | `true` |

318| `spinnerTipsOverride` | Überschreiben Sie Spinner-Tipps mit benutzerdefinierten Zeichenketten. `tips`: Array von Tipp-Zeichenketten. `excludeDefault`: wenn `true`, nur benutzerdefinierte Tipps anzeigen; wenn `false` oder nicht vorhanden, werden benutzerdefinierte Tipps mit integrierten Tipps zusammengeführt | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |318| `spinnerTipsOverride` | Überschreiben Sie Spinner-Tipps mit benutzerdefinierten Zeichenketten. `tips`: Array von Tipp-Zeichenketten. `excludeDefault`: wenn `true`, nur benutzerdefinierte Tipps anzeigen; wenn `false` oder nicht vorhanden, werden benutzerdefinierte Tipps mit integrierten Tipps zusammengeführt | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |

319| `spinnerVerbs` | Passen Sie die Aktionsverben an, die im Spinner angezeigt werden, während eine Runde läuft. Setzen Sie `mode` auf `"replace"`, um nur Ihre Verben zu verwenden, oder `"append"`, um sie zu den Standardwerten hinzuzufügen | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |319| `spinnerVerbs` | Passen Sie die Aktionsverben an, die im Spinner angezeigt werden, während eine Runde läuft. Setzen Sie `mode` auf `"replace"`, um nur Ihre Verben zu verwenden, oder `"append"`, um sie zu den Standardwerten hinzuzufügen | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |

320| `sshConfigs` | SSH-Verbindungen, die in der [Desktop](/de/desktop#pre-configure-ssh-connections-for-your-team)-Umgebungs-Dropdown angezeigt werden. Jeder Eintrag erfordert `id`, `name` und `sshHost`; `sshPort`, `sshIdentityFile` und `startDirectory` sind optional. Wenn in verwalteten Einstellungen gesetzt, sind Verbindungen für Benutzer schreibgeschützt. Nur aus verwalteten und Benutzereinstellungen gelesen | `[{"id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com"}]` |320| `sshConfigs` | SSH-Verbindungen, die in der [Desktop](/docs/de/desktop#pre-configure-ssh-connections-for-your-team)-Umgebungs-Dropdown angezeigt werden. Jeder Eintrag erfordert `id`, `name` und `sshHost`; `sshPort`, `sshIdentityFile` und `startDirectory` sind optional. Wenn in verwalteten Einstellungen gesetzt, sind Verbindungen für Benutzer schreibgeschützt. Nur aus verwalteten und Benutzereinstellungen gelesen | `[{"id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com"}]` |

321| `statusLine` | Konfigurieren Sie eine benutzerdefinierte Statuszeile zur Anzeige von Kontext. Das Objekt's optionale Felder `padding`, `refreshInterval` und `hideVimModeIndicator` steuern Abstände, periodische Neuläufe und ob der integrierte Vim-Modus-Indikator unter der Aufforderung ausgeblendet wird. Siehe [`statusLine`-Dokumentation](/de/statusline#manually-configure-a-status-line) | `{"type": "command", "command": "~/.claude/statusline.sh"}` |321| `statusLine` | Konfigurieren Sie eine benutzerdefinierte Statuszeile zur Anzeige von Kontext. Das Objekt's optionale Felder `padding`, `refreshInterval` und `hideVimModeIndicator` steuern Abstände, periodische Neuläufe und ob der integrierte Vim-Modus-Indikator unter der Aufforderung ausgeblendet wird. Siehe [`statusLine`-Dokumentation](/docs/de/statusline#manually-configure-a-status-line) | `{"type": "command", "command": "~/.claude/statusline.sh"}` |

322| `strictKnownMarketplaces` | (Nur verwaltete Einstellungen) Allowlist von Plugin-Marketplace-Quellen. Undefined = keine Einschränkungen, leeres Array = Lockdown. Erzwungen bei Marketplace-Hinzufügung und bei Plugin-Installation, Update, Aktualisierung und Auto-Update, sodass ein Marketplace, der vor dem Setzen der Richtlinie hinzugefügt wurde, nicht zum Abrufen von Plugins verwendet werden kann. Siehe [Verwaltete Marketplace-Einschränkungen](/de/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |322| `strictKnownMarketplaces` | (Nur verwaltete Einstellungen) Allowlist von Plugin-Marketplace-Quellen. Undefined = keine Einschränkungen, leeres Array = Lockdown. Erzwungen bei Marketplace-Hinzufügung und bei Plugin-Installation, Update, Aktualisierung und Auto-Update, sodass ein Marketplace, der vor dem Setzen der Richtlinie hinzugefügt wurde, nicht zum Abrufen von Plugins verwendet werden kann. Siehe [Verwaltete Marketplace-Einschränkungen](/docs/de/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |

323| `strictPluginOnlyCustomization` | (Nur verwaltete Einstellungen) Block Skills, Agenten, Hooks und MCP-Server aus Benutzer- und Projektquellen, sodass sie nur von Plugins oder verwalteten Einstellungen stammen können. `true` sperrt alle vier Oberflächen; ein Array sperrt nur die benannten. Siehe [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |323| `strictPluginOnlyCustomization` | (Nur verwaltete Einstellungen) Block Skills, Agenten, Hooks und MCP-Server aus Benutzer- und Projektquellen, sodass sie nur von Plugins oder verwalteten Einstellungen stammen können. `true` sperrt alle vier Oberflächen; ein Array sperrt nur die benannten. Siehe [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |

325| `teammateMode` | **Standard**: `in-process`. Wie [Agent-Team](/de/agent-teams) Teamkollegen angezeigt werden: `in-process`, `auto` (geteilte Bereiche in tmux oder iTerm2, ansonsten In-Process), `tmux` (geteilte Bereiche mit tmux oder iTerm2, erkannt von Ihrem Terminal) oder {/* min-version: 2.1.186 */}}`iterm2` (iTerm2 native Split Panes über die `it2` CLI, hinzugefügt in v2.1.186). Der Standard hat sich in v2.1.179 von `auto` geändert. `--teammate-mode` überschreibt dies für eine Sitzung. Siehe [Wählen Sie einen Anzeigemodus](/de/agent-teams#choose-a-display-mode) | `"auto"` |325| `teammateMode` | **Standard**: `in-process`. Wie [Agent-Team](/docs/de/agent-teams) Teamkollegen angezeigt werden: `in-process`, `auto` (geteilte Bereiche in tmux oder iTerm2, ansonsten In-Process), `tmux` (geteilte Bereiche mit tmux oder iTerm2, erkannt von Ihrem Terminal) oder }`iterm2` (iTerm2 native Split Panes über die `it2` CLI, hinzugefügt in v2.1.186). Der Standard hat sich in v2.1.179 von `auto` geändert. `--teammate-mode` überschreibt dies für eine Sitzung. Siehe [Wählen Sie einen Anzeigemodus](/docs/de/agent-teams#choose-a-display-mode) | `"auto"` |

326| `terminalProgressBarEnabled` | **Standard**: `true`. Zeigen Sie die Terminal-Fortschrittsleiste in unterstützten Terminals an: ConEmu, Ghostty 1.2.0+ und iTerm2 3.6.6+. Wird in `/config` als **Terminal progress bar** angezeigt | `false` |326| `terminalProgressBarEnabled` | **Standard**: `true`. Zeigen Sie die Terminal-Fortschrittsleiste in unterstützten Terminals an: ConEmu, Ghostty 1.2.0+ und iTerm2 3.6.6+. Wird in `/config` als **Terminal progress bar** angezeigt | `false` |

327| `theme` | {/* min-version: 2.1.119 */}**Standard**: `"dark"`. Farbschema für die Oberfläche: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"` oder eine benutzerdefinierte Theme-Referenz wie `"custom:<slug>"` oder `"custom:<plugin-name>:<slug>"`. Siehe [Erstellen Sie ein benutzerdefiniertes Theme](/de/terminal-config#create-a-custom-theme). Wird in `/config` als **Theme** angezeigt | `"dark"` |327| `theme` | **Standard**: `"dark"`. Farbschema für die Oberfläche: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"` oder eine benutzerdefinierte Theme-Referenz wie `"custom:<slug>"` oder `"custom:<plugin-name>:<slug>"`. Siehe [Erstellen Sie ein benutzerdefiniertes Theme](/docs/de/terminal-config#create-a-custom-theme). Wird in `/config` als **Theme** angezeigt | `"dark"` |

328| `tui` | Terminal-UI-Renderer. Verwenden Sie `"fullscreen"` für den flimmerfreien [Alt-Screen-Renderer](/de/fullscreen) mit virtualisiertem Scrollback. Verwenden Sie `"default"` für den klassischen Main-Screen-Renderer. Setzen Sie über `/tui`. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_NO_FLICKER`](/de/env-vars) setzen. Hintergrund-Sitzungen, die von [Agent-Ansicht](/de/agent-view) geöffnet werden, verwenden immer den Fullscreen-Renderer, unabhängig von dieser Einstellung | `"fullscreen"` |328| `tui` | Terminal-UI-Renderer. Verwenden Sie `"fullscreen"` für den flimmerfreien [Alt-Screen-Renderer](/docs/de/fullscreen) mit virtualisiertem Scrollback. Verwenden Sie `"default"` für den klassischen Main-Screen-Renderer. Setzen Sie über `/tui`. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_NO_FLICKER`](/docs/de/env-vars) setzen. Hintergrund-Sitzungen, die von [Agent-Ansicht](/docs/de/agent-view) geöffnet werden, verwenden immer den Fullscreen-Renderer, unabhängig von dieser Einstellung | `"fullscreen"` |

329| `ultracode` | Aktivieren Sie [ultracode](/de/workflows#let-claude-decide-with-ultracode) für die Sitzung. Dieser Schlüssel wird nicht aus `settings.json` gelesen. Setzen Sie über `/effort ultracode`, `--settings` oder eine Agent SDK-Steueranforderung. {/* min-version: 2.1.203 */}Um eine Sitzung mit ultracode bereits aktiviert zu starten, starten Sie mit `claude --effort ultracode`, was Claude Code v2.1.203 oder später erfordert | `true` |329| `ultracode` | Aktivieren Sie [ultracode](/docs/de/workflows#let-claude-decide-with-ultracode) für die Sitzung. Dieser Schlüssel wird nicht aus `settings.json` gelesen. Setzen Sie über `/effort ultracode`, `--settings` oder eine Agent SDK-Steueranforderung. Um eine Sitzung mit ultracode bereits aktiviert zu starten, starten Sie mit `claude --effort ultracode`, was Claude Code v2.1.203 oder später erfordert | `true` |

330| `useAutoModeDuringPlan` | **Standard**: `true`. Ob Plan Mode Auto-Mode-Semantik verwendet, wenn Auto Mode verfügbar ist. Nicht aus gemeinsamen Projekteinstellungen gelesen. Wird in `/config` als "Use auto mode during plan" angezeigt | `false` |330| `useAutoModeDuringPlan` | **Standard**: `true`. Ob Plan Mode Auto-Mode-Semantik verwendet, wenn Auto Mode verfügbar ist. Nicht aus gemeinsamen Projekteinstellungen gelesen. Wird in `/config` als "Use auto mode during plan" angezeigt | `false` |

331| `verbose` | {/* min-version: 2.1.119 */}**Standard**: `false`. Zeigen Sie vollständige Werkzeugausgabe statt gekürzte Zusammenfassungen an. Wird in `/config` als **Verbose output** angezeigt. Das Flag `--verbose` überschreibt dies für eine Sitzung | `true` |331| `verbose` | **Standard**: `false`. Zeigen Sie vollständige Werkzeugausgabe statt gekürzte Zusammenfassungen an. Wird in `/config` als **Verbose output** angezeigt. Das Flag `--verbose` überschreibt dies für eine Sitzung | `true` |

332| `viewMode` | Standard-Transkript-Ansichtsmodus beim Start: `"default"`, `"verbose"` oder `"focus"`. Überschreibt die klebrige `/focus`-Auswahl, wenn gesetzt. Das Flag `--verbose` überschreibt dies für eine Sitzung | `"verbose"` |332| `viewMode` | Standard-Transkript-Ansichtsmodus beim Start: `"default"`, `"verbose"` oder `"focus"`. Überschreibt die klebrige `/focus`-Auswahl, wenn gesetzt. Das Flag `--verbose` überschreibt dies für eine Sitzung | `"verbose"` |

333| `vimInsertModeRemaps` | {/* min-version: 2.1.208 */}Ordnen Sie zwei-Tasten-INSERT-Modus-Sequenzen Escape in [vim Editor-Modus](/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; andere Einträge werden ignoriert. Nur aus Benutzereinstellungen, dem Flag `--settings` und verwalteten Einstellungen gelesen, sodass die eingecheckte Einstellung eines Repositorys Ihre Tastenanschläge nicht neu zuordnen kann. Hat keine Auswirkung, es sei denn, `editorMode` ist `"vim"`. Siehe [Ordnen Sie INSERT-Modus-Tastatursequenzen neu zu](/de/interactive-mode#remap-insert-mode-key-sequences). Erfordert Claude Code v2.1.208 oder später | `{"jj": "<Esc>"}` |333| `vimInsertModeRemaps` | Ordnen Sie zwei-Tasten-INSERT-Modus-Sequenzen Escape in [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; andere Einträge werden ignoriert. Nur aus Benutzereinstellungen, dem Flag `--settings` und verwalteten Einstellungen gelesen, sodass die eingecheckte Einstellung eines Repositorys Ihre Tastenanschläge nicht neu zuordnen kann. Hat keine Auswirkung, es sei denn, `editorMode` ist `"vim"`. Siehe [Ordnen Sie INSERT-Modus-Tastatursequenzen neu zu](/docs/de/interactive-mode#remap-insert-mode-key-sequences). Erfordert Claude Code v2.1.208 oder später | `{"jj": "<Esc>"}` |

334| `voice` | [Sprachdiktier](/de/voice-dictation)-Einstellungen: `enabled` aktiviert Diktieren, `mode` wählt `"hold"` oder `"tap"`, und `autoSubmit` sendet die Aufforderung bei Tastenfreigabe im Hold-Modus. Wird automatisch geschrieben, wenn Sie `/voice` ausführen. Erfordert ein Claude.ai-Konto | `{ "enabled": true, "mode": "tap" }` |334| `voice` | [Sprachdiktier](/docs/de/voice-dictation)-Einstellungen: `enabled` aktiviert Diktieren, `mode` wählt `"hold"` oder `"tap"`, und `autoSubmit` sendet die Aufforderung bei Tastenfreigabe im Hold-Modus. Wird automatisch geschrieben, wenn Sie `/voice` ausführen. Erfordert ein Claude.ai-Konto | `{ "enabled": true, "mode": "tap" }` |

336| `wheelScrollAccelerationEnabled` | {/* min-version: 2.1.174 */}**Standard**: `true`. Im [Fullscreen-Rendering](/de/fullscreen#mouse-wheel-scrolling) beschleunigen Sie die Mausrad-Scroll-Geschwindigkeit während schneller Scrolls. Setzen Sie auf `false` für eine konstante Scroll-Rate pro Rad-Kerbe. Erfordert Claude Code v2.1.174 oder später | `false` |336| `wheelScrollAccelerationEnabled` | **Standard**: `true`. Im [Fullscreen-Rendering](/docs/de/fullscreen#mouse-wheel-scrolling) beschleunigen Sie die Mausrad-Scroll-Geschwindigkeit während schneller Scrolls. Setzen Sie auf `false` für eine konstante Scroll-Rate pro Rad-Kerbe. Erfordert Claude Code v2.1.174 oder später | `false` |

337| `workflowKeywordTriggerEnabled` | {/* min-version: 2.1.157 */}**Standard**: `true`. Ob das Wort `ultracode` in einer Aufforderung einen [dynamischen Workflow](/de/workflows#ask-for-a-workflow-in-your-prompt) auslöst. Setzen Sie auf `false`, um das Wort zu tippen, ohne einen auszulösen. Ultracode, `/workflows` und gespeicherte Workflow-Befehle sind nicht betroffen. Wird in `/config` als **Ultracode keyword trigger** angezeigt. Hinzugefügt in v2.1.157; vor v2.1.160 war das Trigger-Wort `workflow` | `false` |337| `workflowKeywordTriggerEnabled` | **Standard**: `true`. Ob das Wort `ultracode` in einer Aufforderung einen [dynamischen Workflow](/docs/de/workflows#ask-for-a-workflow-in-your-prompt) auslöst. Setzen Sie auf `false`, um das Wort zu tippen, ohne einen auszulösen. Ultracode, `/workflows` und gespeicherte Workflow-Befehle sind nicht betroffen. Wird in `/config` als **Ultracode keyword trigger** angezeigt. Hinzugefügt in v2.1.157; vor v2.1.160 war das Trigger-Wort `workflow` | `false` |

338| `wslInheritsWindowsSettings` | (Nur Windows verwaltete Einstellungen) Wenn `true`, liest Claude Code auf WSL verwaltete Einstellungen aus der Windows-Richtlinienkette zusätzlich zu `/etc/claude-code`, wobei Windows-Quellen Vorrang haben. Wird nur berücksichtigt, wenn in der HKLM-Registrierungsschlüssel oder `C:\Program Files\ClaudeCode\managed-settings.json` gesetzt, beide erfordern Windows-Admin zum Schreiben. Damit die HKCU-Richtlinie auch auf WSL gilt, muss das Flag zusätzlich in HKCU selbst gesetzt werden. Hat keine Auswirkung auf natives Windows | `true` |338| `wslInheritsWindowsSettings` | (Nur Windows verwaltete Einstellungen) Wenn `true`, liest Claude Code auf WSL verwaltete Einstellungen aus der Windows-Richtlinienkette zusätzlich zu `/etc/claude-code`, wobei Windows-Quellen Vorrang haben. Wird nur berücksichtigt, wenn in der HKLM-Registrierungsschlüssel oder `C:\Program Files\ClaudeCode\managed-settings.json` gesetzt, beide erfordern Windows-Admin zum Schreiben. Damit die HKCU-Richtlinie auch auf WSL gilt, muss das Flag zusätzlich in HKCU selbst gesetzt werden. Hat keine Auswirkung auf natives Windows | `true` |

339 339

340<h3 id="global-config-settings">340<h3 id="global-config-settings">

348</Note>348</Note>

349 349

351| :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |351| :--------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |

352| `autoConnectIde` | **Standard**: `false`. Verbinden Sie sich automatisch mit einer laufenden IDE, wenn Claude Code von einem externen Terminal aus startet. Wird in `/config` als **Auto-connect to IDE (external terminal)** angezeigt, wenn außerhalb eines VS Code oder JetBrains-Terminals ausgeführt wird. Die Umgebungsvariable [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/de/env-vars) überschreibt dies, wenn gesetzt | `true` |352| `autoConnectIde` | **Standard**: `false`. Verbinden Sie sich automatisch mit einer laufenden IDE, wenn Claude Code von einem externen Terminal aus startet. Wird in `/config` als **Auto-connect to IDE (external terminal)** angezeigt, wenn außerhalb eines VS Code oder JetBrains-Terminals ausgeführt wird. Die Umgebungsvariable [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/docs/de/env-vars) überschreibt dies, wenn gesetzt | `true` |

353| `autoInstallIdeExtension` | **Standard**: `true`. Installieren Sie die Claude Code IDE-Erweiterung automatisch, wenn Sie von einem VS Code-Terminal aus ausgeführt werden. Wird in `/config` als **Auto-install IDE extension** angezeigt, wenn Sie in einem VS Code oder JetBrains-Terminal ausgeführt werden. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/de/env-vars) auf `1` setzen | `false` |353| `autoInstallIdeExtension` | **Standard**: `true`. Installieren Sie die Claude Code IDE-Erweiterung automatisch, wenn Sie von einem VS Code-Terminal aus ausgeführt werden. Wird in `/config` als **Auto-install IDE extension** angezeigt, wenn Sie in einem VS Code oder JetBrains-Terminal ausgeführt werden. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/de/env-vars) auf `1` setzen | `false` |

354| `externalEditorContext` | **Standard**: `false`. Stellen Sie Claudes vorherige Antwort als `#`-kommentierter Kontext voran, wenn Sie den externen Editor mit `Ctrl+G` öffnen. Wird in `/config` als **Show last response in external editor** angezeigt | `true` |354| `externalEditorContext` | **Standard**: `false`. Stellen Sie Claudes vorherige Antwort als `#`-kommentierter Kontext voran, wenn Sie den externen Editor mit `Ctrl+G` öffnen. Wird in `/config` als **Show last response in external editor** angezeigt | `true` |

355| `permissionExplainerEnabled` | **Standard**: `true`. Zeigen Sie eine vom Modell generierte [Erklärung des Befehls](/de/permissions#permission-system), wenn Sie `Ctrl+E` auf einer Bash- oder PowerShell-Berechtigungsaufforderung drücken. Setzen Sie auf `false`, um die Verknüpfung auszuschalten | `false` |355| `permissionExplainerEnabled` | **Standard**: `true`. Zeigen Sie eine vom Modell generierte [Erklärung des Befehls](/docs/de/permissions#permission-system), wenn Sie `Ctrl+E` auf einer Bash- oder PowerShell-Berechtigungsaufforderung drücken. Setzen Sie auf `false`, um die Verknüpfung auszuschalten | `false` |

356| `teammateDefaultModel` | Standardmodell für [Agent-Team](/de/agent-teams) Teamkollegen, wenn die Spawn-Aufforderung keinen angibt. Setzen Sie auf einen Modellalias wie `"sonnet"` oder `null`, um das aktuelle `/model`-Modell des Leads zu erben. Wird in `/config` als **Default teammate model** angezeigt | `"sonnet"` |356| `teammateDefaultModel` | Standardmodell für [Agent-Team](/docs/de/agent-teams) Teamkollegen, wenn die Spawn-Aufforderung keinen angibt. Setzen Sie auf einen Modellalias wie `"sonnet"` oder `null`, um das aktuelle `/model`-Modell des Leads zu erben. Wird in `/config` als **Default teammate model** angezeigt | `"sonnet"` |

357| `workflowSizeGuideline` | {/* min-version: 2.1.202 */}**Standard**: `unrestricted`, das keinen Leitfaden sendet. Legt die [Agent-Anzahl fest, auf die Claude abzielt](/de/workflows#set-a-size-guideline) in den dynamischen Workflows, die es schreibt. Claude Code sendet den Wert an Claude als Ratschlag, nicht als erzwungene Obergrenze. Akzeptiert `unrestricted`, `small`, `medium` oder `large`. Wird in `/config` als **Dynamic workflow size** angezeigt. Sie können es auch direkt mit `/config workflowSizeGuideline=small` setzen. Erfordert Claude Code v2.1.202 oder später. {/* min-version: 2.1.203 */}Der Leitfaden der Agent-Anzahl ersetzt auch den Standard-Schwellenwert für die [`Large workflow` Warnung](/de/workflows#cost); dieses Verhalten erfordert Claude Code v2.1.203 oder später | `"small"` |357| `workflowSizeGuideline` | **Standard**: `unrestricted`, das keinen Leitfaden sendet. Legt die [Agent-Anzahl fest, auf die Claude abzielt](/docs/de/workflows#set-a-size-guideline) in den dynamischen Workflows, die es schreibt. Claude Code sendet den Wert an Claude als Ratschlag, nicht als erzwungene Obergrenze. Akzeptiert `unrestricted`, `small`, `medium` oder `large`. Wird in `/config` als **Dynamic workflow size** angezeigt. Sie können es auch direkt mit `/config workflowSizeGuideline=small` setzen. Erfordert Claude Code v2.1.202 oder später. Der Leitfaden der Agent-Anzahl ersetzt auch den Standard-Schwellenwert für die [`Large workflow` Warnung](/docs/de/workflows#cost); dieses Verhalten erfordert Claude Code v2.1.203 oder später | `"small"` |

358 358

359<h3 id="worktree-settings">359<h3 id="worktree-settings">

360 Worktree-Einstellungen360 Worktree-Einstellungen

363Konfigurieren Sie, wie `--worktree` Git-Worktrees erstellt und verwaltet.363Konfigurieren Sie, wie `--worktree` Git-Worktrees erstellt und verwaltet.

364 364

366| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |366| :---------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

367| `worktree.baseRef` | Welcher Ref neue Worktrees branchen von. `"fresh"` (Standard) brancht von `origin/<default-branch>` für einen sauberen Baum, der dem Remote entspricht. `"head"` brancht von Ihrem aktuellen lokalen `HEAD`, sodass nicht gepushte Commits und Feature-Branch-Status im Worktree vorhanden sind. Innerhalb eines verknüpften Worktrees wird `"head"` zu diesem Worktree's `HEAD` aufgelöst, nicht zum Haupt-Checkout's. Gilt für `--worktree`, das `EnterWorktree`-Tool und die Subagent-Isolation | `"head"` |367| `worktree.baseRef` | Welcher Ref neue Worktrees branchen von. `"fresh"` (Standard) brancht von `origin/<default-branch>` für einen sauberen Baum, der dem Remote entspricht. `"head"` brancht von Ihrem aktuellen lokalen `HEAD`, sodass nicht gepushte Commits und Feature-Branch-Status im Worktree vorhanden sind. Innerhalb eines verknüpften Worktrees wird `"head"` zu diesem Worktree's `HEAD` aufgelöst, nicht zum Haupt-Checkout's. Gilt für `--worktree`, das `EnterWorktree`-Tool und die Subagent-Isolation | `"head"` |

368| `worktree.symlinkDirectories` | Verzeichnisse, die vom Haupt-Repository in jeden Worktree symlinkt werden, um große Verzeichnisse auf der Festplatte zu duplizieren. Standardmäßig werden keine Verzeichnisse symlinkt | `["node_modules", ".cache"]` |368| `worktree.symlinkDirectories` | Verzeichnisse, die vom Haupt-Repository in jeden Worktree symlinkt werden, um große Verzeichnisse auf der Festplatte zu duplizieren. Standardmäßig werden keine Verzeichnisse symlinkt | `["node_modules", ".cache"]` |

369| `worktree.sparsePaths` | Verzeichnisse, die in jedem Worktree über Git Sparse-Checkout ausgecheckt werden. Nur die aufgelisteten Verzeichnisse plus Root-Level-Dateien werden auf die Festplatte geschrieben, was in großen Monorepos schneller ist. Während ein spärlicher Worktree existiert, aktiviert Git `extensions.worktreeConfig` in der gemeinsamen `.git/config` des Repositorys; siehe [Checken Sie nur die Verzeichnisse aus, die Sie benötigen](/de/large-codebases#check-out-only-the-directories-you-need) | `["packages/my-app", "shared/utils"]` |369| `worktree.sparsePaths` | Verzeichnisse, die in jedem Worktree über Git Sparse-Checkout ausgecheckt werden. Nur die aufgelisteten Verzeichnisse plus Root-Level-Dateien werden auf die Festplatte geschrieben, was in großen Monorepos schneller ist. Während ein spärlicher Worktree existiert, aktiviert Git `extensions.worktreeConfig` in der gemeinsamen `.git/config` des Repositorys; siehe [Checken Sie nur die Verzeichnisse aus, die Sie benötigen](/docs/de/large-codebases#check-out-only-the-directories-you-need) | `["packages/my-app", "shared/utils"]` |

370| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Isolationsmodus für [Hintergrund-Sitzungen](/de/agent-view#how-file-edits-are-isolated). `"worktree"` (Standard) blockiert `Edit`/`Write` im Haupt-Checkout, bis `EnterWorktree` aufgerufen wird. {/* min-version: 2.1.203 */}Außerhalb eines Git-Repositorys gibt ein [`WorktreeCreate` Hook](/de/worktrees#non-git-version-control), der fehlschlägt, die Sperre frei, sodass die Sitzung das Arbeitsverzeichnis an Ort und Stelle bearbeiten kann; erfordert Claude Code v2.1.203 oder später. `"none"` ermöglicht es Hintergrund-Jobs, die Arbeitskopie direkt zu bearbeiten. Erfordert Claude Code v2.1.143 oder später | `"none"` |370| `worktree.bgIsolation` | Isolationsmodus für [Hintergrund-Sitzungen](/docs/de/agent-view#how-file-edits-are-isolated). `"worktree"` (Standard) blockiert `Edit`/`Write` im Haupt-Checkout, bis `EnterWorktree` aufgerufen wird. Außerhalb eines Git-Repositorys gibt ein [`WorktreeCreate` Hook](/docs/de/worktrees#non-git-version-control), der fehlschlägt, die Sperre frei, sodass die Sitzung das Arbeitsverzeichnis an Ort und Stelle bearbeiten kann; erfordert Claude Code v2.1.203 oder später. `"none"` ermöglicht es Hintergrund-Jobs, die Arbeitskopie direkt zu bearbeiten. Erfordert Claude Code v2.1.143 oder später | `"none"` |

371 371

372Um gitignorierte Dateien wie `.env` in neue Worktrees zu kopieren, verwenden Sie stattdessen eine [`.worktreeinclude`-Datei](/de/worktrees#copy-gitignored-files-into-worktrees) in Ihrem Projektstamm.372Um gitignorierte Dateien wie `.env` in neue Worktrees zu kopieren, verwenden Sie stattdessen eine [`.worktreeinclude`-Datei](/docs/de/worktrees#copy-gitignored-files-into-worktrees) in Ihrem Projektstamm.

373 373

374<h3 id="permission-settings">374<h3 id="permission-settings">

375 Berechtigungseinstellungen375 Berechtigungseinstellungen

379| :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |379| :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |

380| `allow` | Array von Berechtigungsregeln, um die Werkzeugnutzung zu erlauben. Werkzeugname-Globs werden nur in der Werkzeugposition nach einem literalen `mcp__<server>__` Präfix unterstützt, z. B. `mcp__github__get_*`; das Server-Segment muss glob-frei sein. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) unten für Details zur Mustererkennung | `[ "Bash(git diff *)" ]` |380| `allow` | Array von Berechtigungsregeln, um die Werkzeugnutzung zu erlauben. Werkzeugname-Globs werden nur in der Werkzeugposition nach einem literalen `mcp__<server>__` Präfix unterstützt, z. B. `mcp__github__get_*`; das Server-Segment muss glob-frei sein. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) unten für Details zur Mustererkennung | `[ "Bash(git diff *)" ]` |

381| `ask` | Array von Berechtigungsregeln, um bei der Werkzeugnutzung um Bestätigung zu bitten. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) unten | `[ "Bash(git push *)" ]` |381| `ask` | Array von Berechtigungsregeln, um bei der Werkzeugnutzung um Bestätigung zu bitten. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) unten | `[ "Bash(git push *)" ]` |

382| `deny` | Array von Berechtigungsregeln, um die Werkzeugnutzung zu verweigern. Verwenden Sie dies, um sensible Dateien vom Claude Code-Zugriff auszuschließen. Werkzeugnamen akzeptieren Glob-Muster: `"*"` verweigert jedes Werkzeug und `"mcp__*"` verweigert alle MCP-Werkzeuge. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) und [Bash-Berechtigungsbeschränkungen](/de/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |382| `deny` | Array von Berechtigungsregeln, um die Werkzeugnutzung zu verweigern. Verwenden Sie dies, um sensible Dateien vom Claude Code-Zugriff auszuschließen. Werkzeugnamen akzeptieren Glob-Muster: `"*"` verweigert jedes Werkzeug und `"mcp__*"` verweigert alle MCP-Werkzeuge. Siehe [Berechtigungsregelsyntax](#permission-rule-syntax) und [Bash-Berechtigungsbeschränkungen](/docs/de/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

383| `additionalDirectories` | Zusätzliche [Arbeitsverzeichnisse](/de/permissions#working-directories) für Dateizugriff. Die meisten `.claude/`-Konfigurationen werden [nicht erkannt](/de/permissions#additional-directories-grant-file-access-not-configuration) aus diesen Verzeichnissen | `[ "../docs/" ]` |383| `additionalDirectories` | Zusätzliche [Arbeitsverzeichnisse](/docs/de/permissions#working-directories) für Dateizugriff. Die meisten `.claude/`-Konfigurationen werden [nicht erkannt](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) aus diesen Verzeichnissen | `[ "../docs/" ]` |

384| `defaultMode` | Standard-[Berechtigungsmodus](/de/permission-modes) beim Öffnen von Claude Code. Gültige Werte: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` und {{/* min-version: 2.1.200 */}}`manual` als Alias für `default`, der Modus mit der Bezeichnung Manual in der CLI und den VS Code- und JetBrains-Erweiterungen. Der Alias `manual` erfordert Claude Code v2.1.200 oder später. {{/* min-version: 2.1.142 */}}`auto` wird ignoriert, wenn es in Projekt- oder lokalen Einstellungen gesetzt ist, sodass ein Repository sich nicht selbst den Auto-Modus gewähren kann; setzen Sie es stattdessen in `~/.claude/settings.json`. Vor v2.1.142 konnten Projekteinstellungen `auto` setzen. Das CLI-Flag `--permission-mode` überschreibt diese Einstellung für eine einzelne Sitzung | `"acceptEdits"` |384| `defaultMode` | Standard-[Berechtigungsmodus](/docs/de/permission-modes) beim Öffnen von Claude Code. Gültige Werte: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` und {{/* min-version: 2.1.200 */}}`manual` als Alias für `default`, der Modus mit der Bezeichnung Manual in der CLI und den VS Code- und JetBrains-Erweiterungen. Der Alias `manual` erfordert Claude Code v2.1.200 oder später. {{/* min-version: 2.1.142 */}}`auto` wird ignoriert, wenn es in Projekt- oder lokalen Einstellungen gesetzt ist, sodass ein Repository sich nicht selbst den Auto-Modus gewähren kann; setzen Sie es stattdessen in `~/.claude/settings.json`. Vor v2.1.142 konnten Projekteinstellungen `auto` setzen. Das CLI-Flag `--permission-mode` überschreibt diese Einstellung für eine einzelne Sitzung | `"acceptEdits"` |

385| `disableBypassPermissionsMode` | Setzen Sie auf `"disable"`, um zu verhindern, dass der `bypassPermissions`-Modus aktiviert wird. Dies deaktiviert das Befehlszeilenflag `--dangerously-skip-permissions`. Normalerweise in [verwalteten Einstellungen](/de/permissions#managed-settings) platziert, um Organisationsrichtlinien durchzusetzen, funktioniert aber aus jedem Bereich | `"disable"` |385| `disableBypassPermissionsMode` | Setzen Sie auf `"disable"`, um zu verhindern, dass der `bypassPermissions`-Modus aktiviert wird. Dies deaktiviert das Befehlszeilenflag `--dangerously-skip-permissions`. Normalerweise in [verwalteten Einstellungen](/docs/de/permissions#managed-settings) platziert, um Organisationsrichtlinien durchzusetzen, funktioniert aber aus jedem Bereich | `"disable"` |

386| `skipDangerousModePermissionPrompt` | Überspringen Sie die Bestätigungsaufforderung, die vor dem Betreten des Bypass-Berechtigungsmodus über `--dangerously-skip-permissions` oder `defaultMode: "bypassPermissions"` angezeigt wird. Wird ignoriert, wenn in Projekteinstellungen (`.claude/settings.json`) gesetzt, um zu verhindern, dass nicht vertrauenswürdige Repositories die Aufforderung automatisch umgehen | `true` |386| `skipDangerousModePermissionPrompt` | Überspringen Sie die Bestätigungsaufforderung, die vor dem Betreten des Bypass-Berechtigungsmodus über `--dangerously-skip-permissions` oder `defaultMode: "bypassPermissions"` angezeigt wird. Wird ignoriert, wenn in Projekteinstellungen (`.claude/settings.json`) gesetzt, um zu verhindern, dass nicht vertrauenswürdige Repositories die Aufforderung automatisch umgehen | `true` |

387 387

388<h3 id="permission-rule-syntax">388<h3 id="permission-rule-syntax">

389 Berechtigungsregelsyntax389 Berechtigungsregelsyntax

390</h3>390</h3>

391 391

392Berechtigungsregeln folgen dem Format `Tool` oder `Tool(specifier)`. Regeln werden in der Reihenfolge ausgewertet: zuerst Deny-Regeln, dann Ask, dann Allow. Die erste übereinstimmende Regel bestimmt das Ergebnis, unabhängig von der Regelspezifität. Siehe [Berechtigungsregelbewertungsreihenfolge](/de/permissions#manage-permissions) für Details.392Berechtigungsregeln folgen dem Format `Tool` oder `Tool(specifier)`. Regeln werden in der Reihenfolge ausgewertet: zuerst Deny-Regeln, dann Ask, dann Allow. Die erste übereinstimmende Regel bestimmt das Ergebnis, unabhängig von der Regelspezifität. Siehe [Berechtigungsregelbewertungsreihenfolge](/docs/de/permissions#manage-permissions) für Details.

393 393

394Schnelle Beispiele:394Schnelle Beispiele:

395 395

402 402

403Für die vollständige Referenz der Regelsyntax, einschließlich Platzhalterverhalten, werkzeugspezifischer Muster für Read, Edit, WebFetch, MCP und Agent-Regeln sowie Sicherheitsbeschränkungen von Bash-Mustern, siehe [Berechtigungsregelsyntax](/de/permissions#permission-rule-syntax).403Für die vollständige Referenz der Regelsyntax, einschließlich Platzhalterverhalten, werkzeugspezifischer Muster für Read, Edit, WebFetch, MCP und Agent-Regeln sowie Sicherheitsbeschränkungen von Bash-Mustern, siehe [Berechtigungsregelsyntax](/docs/de/permissions#permission-rule-syntax).

404 404

405<h3 id="sandbox-settings">405<h3 id="sandbox-settings">

406 Sandbox-Einstellungen406 Sandbox-Einstellungen

407</h3>407</h3>

408 408

409Konfigurieren Sie erweitertes Sandbox-Verhalten. Sandboxing isoliert Bash-Befehle von Ihrem Dateisystem und Netzwerk. Siehe [Sandboxing](/de/sandboxing) für Details.409Konfigurieren Sie erweitertes Sandbox-Verhalten. Sandboxing isoliert Bash-Befehle von Ihrem Dateisystem und Netzwerk. Siehe [Sandboxing](/docs/de/sandboxing) für Details.

410 410

412| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |412| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

414| `failIfUnavailable` | Beenden Sie mit einem Fehler beim Start, wenn `sandbox.enabled` true ist, aber die Sandbox nicht gestartet werden kann (fehlende Abhängigkeiten oder nicht unterstützte Plattform). Wenn false (Standard), wird eine Warnung angezeigt und Befehle werden unsandboxed ausgeführt. Vorgesehen für verwaltete Einstellungsbereitstellungen, die Sandboxing als Hard Gate erfordern | `true` |414| `failIfUnavailable` | Beenden Sie mit einem Fehler beim Start, wenn `sandbox.enabled` true ist, aber die Sandbox nicht gestartet werden kann (fehlende Abhängigkeiten oder nicht unterstützte Plattform). Wenn false (Standard), wird eine Warnung angezeigt und Befehle werden unsandboxed ausgeführt. Vorgesehen für verwaltete Einstellungsbereitstellungen, die Sandboxing als Hard Gate erfordern | `true` |

418| `filesystem.allowWrite` | Zusätzliche Pfade, in die Sandbox-Befehle schreiben können. Arrays werden über alle Einstellungsbereiche zusammengeführt: Benutzer-, Projekt- und verwaltete Pfade werden kombiniert, nicht ersetzt. Auch zusammengeführt mit Pfaden aus `Edit(...)` Allow-Berechtigungsregeln. Siehe [Pfadpräfixe](#sandbox-path-prefixes) unten. | `["/tmp/build", "~/.kube"]` |418| `filesystem.allowWrite` | Zusätzliche Pfade, in die Sandbox-Befehle schreiben können. Arrays werden über alle Einstellungsbereiche zusammengeführt: Benutzer-, Projekt- und verwaltete Pfade werden kombiniert, nicht ersetzt. Auch zusammengeführt mit Pfaden aus `Edit(...)` Allow-Berechtigungsregeln. Siehe [Pfadpräfixe](#sandbox-path-prefixes) unten. | `["/tmp/build", "~/.kube"]` |

419| `filesystem.denyWrite` | Pfade, in die Sandbox-Befehle nicht schreiben können. Arrays werden über alle Einstellungsbereiche zusammengeführt. Auch zusammengeführt mit Pfaden aus `Edit(...)` Deny-Berechtigungsregeln. | `["/etc", "/usr/local/bin"]` |419| `filesystem.denyWrite` | Pfade, in die Sandbox-Befehle nicht schreiben können. Arrays werden über alle Einstellungsbereiche zusammengeführt. Auch zusammengeführt mit Pfaden aus `Edit(...)` Deny-Berechtigungsregeln. | `["/etc", "/usr/local/bin"]` |

420| `filesystem.denyRead` | Pfade, aus denen Sandbox-Befehle nicht lesen können. Arrays werden über alle Einstellungsbereiche zusammengeführt. Auch zusammengeführt mit Pfaden aus `Read(...)` Deny-Berechtigungsregeln. | `["~/.aws/credentials"]` |420| `filesystem.denyRead` | Pfade, aus denen Sandbox-Befehle nicht lesen können. Arrays werden über alle Einstellungsbereiche zusammengeführt. Auch zusammengeführt mit Pfaden aus `Read(...)` Deny-Berechtigungsregeln. | `["~/.aws/credentials"]` |

421| `filesystem.allowRead` | Pfade zum erneuten Erlauben des Lesens innerhalb von `denyRead`-Regionen. Ein `allowRead` Pfad öffnet das Lesen innerhalb einer breiteren `denyRead` Region erneut, und ein genauer Pfad in `denyRead` bleibt innerhalb einer breiteren `allowRead` blockiert; siehe die [Überlappungstabelle](/de/sandboxing#configure-sandboxing) für Beispiele. Arrays werden über alle Einstellungsbereiche zusammengeführt. Verwenden Sie dies, um Workspace-only-Lesezugriffsmuster zu erstellen. | `["."]` |421| `filesystem.allowRead` | Pfade zum erneuten Erlauben des Lesens innerhalb von `denyRead`-Regionen. Ein `allowRead` Pfad öffnet das Lesen innerhalb einer breiteren `denyRead` Region erneut, und ein genauer Pfad in `denyRead` bleibt innerhalb einer breiteren `allowRead` blockiert; siehe die [Überlappungstabelle](/docs/de/sandboxing#configure-sandboxing) für Beispiele. Arrays werden über alle Einstellungsbereiche zusammengeführt. Verwenden Sie dies, um Workspace-only-Lesezugriffsmuster zu erstellen. | `["."]` |

422| `filesystem.allowManagedReadPathsOnly` | (Nur verwaltete Einstellungen) Nur `filesystem.allowRead` Pfade aus verwalteten Einstellungen werden berücksichtigt. `denyRead` wird weiterhin aus allen Quellen zusammengeführt. Standard: false | `true` |422| `filesystem.allowManagedReadPathsOnly` | (Nur verwaltete Einstellungen) Nur `filesystem.allowRead` Pfade aus verwalteten Einstellungen werden berücksichtigt. `denyRead` wird weiterhin aus allen Quellen zusammengeführt. Standard: false | `true` |

423| `credentials.files` | {/* min-version: 2.1.187 */}Anmeldedatendateien oder Verzeichnisse, die Sandbox-Befehle nicht lesen können. Wendet die gleiche Lesesperre wie `filesystem.denyRead` an; der separate Schlüssel hält Anmeldedatenpfade gruppiert mit `credentials.envVars` und getrennt von allgemeinen Dateisystemregeln. Jeder Eintrag ist `{ "path": "...", "mode": "deny" }`, und `deny` ist der einzige unterstützte Modus für Dateien. Pfade verwenden die gleichen [Präfixe](#sandbox-path-prefixes) wie `filesystem.*`-Einstellungen. Arrays werden über alle Einstellungsbereiche zusammengeführt. Erfordert Claude Code v2.1.187 oder später. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |423| `credentials.files` | Anmeldedatendateien oder Verzeichnisse, die Sandbox-Befehle nicht lesen können. Wendet die gleiche Lesesperre wie `filesystem.denyRead` an; der separate Schlüssel hält Anmeldedatenpfade gruppiert mit `credentials.envVars` und getrennt von allgemeinen Dateisystemregeln. Jeder Eintrag ist `{ "path": "...", "mode": "deny" }`, und `deny` ist der einzige unterstützte Modus für Dateien. Pfade verwenden die gleichen [Präfixe](#sandbox-path-prefixes) wie `filesystem.*`-Einstellungen. Arrays werden über alle Einstellungsbereiche zusammengeführt. Erfordert Claude Code v2.1.187 oder später. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |

424| `credentials.envVars` | {/* min-version: 2.1.187 */}Umgebungsvariablen zum [Schutz vor Sandbox-Befehlen](/de/sandboxing#protect-credentials). Jeder Eintrag hat einen `name` und einen `mode`; der Name muss mit einem Buchstaben oder Unterstrich beginnen und darf nur Buchstaben, Ziffern und Unterstriche enthalten. `deny` entfernt die Variable aus der Umgebung von Sandbox-Befehlen. Erfordert Claude Code v2.1.187 oder später. {{/* min-version: 2.1.199 */}}`mask` ersetzt die Variable mit einem Pro-Sitzungs-Sentinel-Wert innerhalb der Sandbox, während der Sandbox-Proxy den echten Wert bei ausgehenden Anfragen an die `injectHosts` dieses Eintrags ersetzt; es erfordert `network.tlsTerminate` und Claude Code v2.1.199 oder später. `mask` Einträge werden nur aus Benutzer-, verwalteten oder CLI-`--settings` Einstellungen berücksichtigt, nicht aus `.claude/settings.json` oder `.claude/settings.local.json`. Arrays werden über alle Einstellungsbereiche zusammengeführt, und `deny` hat Vorrang, wenn die gleiche Variable mit beiden Modi erscheint. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |424| `credentials.envVars` | Umgebungsvariablen zum [Schutz vor Sandbox-Befehlen](/docs/de/sandboxing#protect-credentials). Jeder Eintrag hat einen `name` und einen `mode`; der Name muss mit einem Buchstaben oder Unterstrich beginnen und darf nur Buchstaben, Ziffern und Unterstriche enthalten. `deny` entfernt die Variable aus der Umgebung von Sandbox-Befehlen. Erfordert Claude Code v2.1.187 oder später. {{/* min-version: 2.1.199 */}}`mask` ersetzt die Variable mit einem Pro-Sitzungs-Sentinel-Wert innerhalb der Sandbox, während der Sandbox-Proxy den echten Wert bei ausgehenden Anfragen an die `injectHosts` dieses Eintrags ersetzt; es erfordert `network.tlsTerminate` und Claude Code v2.1.199 oder später. `mask` Einträge werden nur aus Benutzer-, verwalteten oder CLI-`--settings` Einstellungen berücksichtigt, nicht aus `.claude/settings.json` oder `.claude/settings.local.json`. Arrays werden über alle Einstellungsbereiche zusammengeführt, und `deny` hat Vorrang, wenn die gleiche Variable mit beiden Modi erscheint. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |

425| `credentials.envVars[].injectHosts` | Hosts, wo der Sandbox-Proxy den echten Wert eines `mask` Eintrags ersetzt. Jeder Host muss auch von `network.allowedDomains` abgedeckt sein, entweder genau oder durch einen Platzhalter. Wenn nicht gesetzt, ersetzt der Proxy den Wert bei Anfragen an jeden Host in `network.allowedDomains`. Wird akzeptiert, aber ignoriert, wenn `mode` `deny` ist. Erfordert Claude Code v2.1.199 oder später. {{/* min-version: 2.1.199 */}} | `["api.github.com"]` |425| `credentials.envVars[].injectHosts` | Hosts, wo der Sandbox-Proxy den echten Wert eines `mask` Eintrags ersetzt. Jeder Host muss auch von `network.allowedDomains` abgedeckt sein, entweder genau oder durch einen Platzhalter. Wenn nicht gesetzt, ersetzt der Proxy den Wert bei Anfragen an jeden Host in `network.allowedDomains`. Wird akzeptiert, aber ignoriert, wenn `mode` `deny` ist. Erfordert Claude Code v2.1.199 oder später. {{/* min-version: 2.1.199 */}} | `["api.github.com"]` |

426| `credentials.allowPlaintextInject` | Erlauben Sie `mask` Substitution auf Plain-HTTP-Anfragen sowie TLS-terminiertem HTTPS. Bei Plain-HTTP ist die Upstream-Identität nicht überprüft und die Anmeldedaten werden im Klartext übertragen, daher lassen Sie dies außerhalb vertrauenswürdiger Test-Netzwerke aus. Wird nur aus Benutzer-, verwalteten oder CLI-`--settings` Einstellungen berücksichtigt, nicht aus `.claude/settings.json` oder `.claude/settings.local.json`. Standard: false. Erfordert Claude Code v2.1.199 oder später. {{/* min-version: 2.1.199 */}} | `true` |426| `credentials.allowPlaintextInject` | Erlauben Sie `mask` Substitution auf Plain-HTTP-Anfragen sowie TLS-terminiertem HTTPS. Bei Plain-HTTP ist die Upstream-Identität nicht überprüft und die Anmeldedaten werden im Klartext übertragen, daher lassen Sie dies außerhalb vertrauenswürdiger Test-Netzwerke aus. Wird nur aus Benutzer-, verwalteten oder CLI-`--settings` Einstellungen berücksichtigt, nicht aus `.claude/settings.json` oder `.claude/settings.local.json`. Standard: false. Erfordert Claude Code v2.1.199 oder später. {{/* min-version: 2.1.199 */}} | `true` |

427| `network.allowUnixSockets` | (Nur macOS) Unix-Socket-Pfade, auf die in der Sandbox zugegriffen werden kann. Wird unter Linux und WSL2 ignoriert, wo der Seccomp-Filter `socket(AF_UNIX, ...)` Aufrufe nicht überprüfen kann; verwenden Sie stattdessen `allowAllUnixSockets`. | `["~/.ssh/agent-socket"]` |427| `network.allowUnixSockets` | (Nur macOS) Unix-Socket-Pfade, auf die in der Sandbox zugegriffen werden kann. Wird unter Linux und WSL2 ignoriert, wo der Seccomp-Filter `socket(AF_UNIX, ...)` Aufrufe nicht überprüfen kann; verwenden Sie stattdessen `allowAllUnixSockets`. | `["~/.ssh/agent-socket"]` |

433| `network.allowManagedDomainsOnly` | (Nur verwaltete Einstellungen) Nur `allowedDomains` und `WebFetch(domain:...)` Allow-Regeln aus verwalteten Einstellungen werden berücksichtigt. Domänen aus Benutzer-, Projekt- und lokalen Einstellungen werden ignoriert. Nicht zulässige Domänen werden automatisch blockiert, ohne den Benutzer zu fragen. Verweigerte Domänen werden weiterhin aus allen Quellen berücksichtigt. Standard: false | `true` |433| `network.allowManagedDomainsOnly` | (Nur verwaltete Einstellungen) Nur `allowedDomains` und `WebFetch(domain:...)` Allow-Regeln aus verwalteten Einstellungen werden berücksichtigt. Domänen aus Benutzer-, Projekt- und lokalen Einstellungen werden ignoriert. Nicht zulässige Domänen werden automatisch blockiert, ohne den Benutzer zu fragen. Verweigerte Domänen werden weiterhin aus allen Quellen berücksichtigt. Standard: false | `true` |

434| `network.httpProxyPort` | HTTP-Proxy-Port, der verwendet wird, wenn Sie Ihren eigenen Proxy verwenden möchten. Wenn nicht angegeben, führt Claude seinen eigenen Proxy aus. | `8080` |434| `network.httpProxyPort` | HTTP-Proxy-Port, der verwendet wird, wenn Sie Ihren eigenen Proxy verwenden möchten. Wenn nicht angegeben, führt Claude seinen eigenen Proxy aus. | `8080` |

435| `network.socksProxyPort` | SOCKS5-Proxy-Port, der verwendet wird, wenn Sie Ihren eigenen Proxy verwenden möchten. Wenn nicht angegeben, führt Claude seinen eigenen Proxy aus. | `8081` |435| `network.socksProxyPort` | SOCKS5-Proxy-Port, der verwendet wird, wenn Sie Ihren eigenen Proxy verwenden möchten. Wenn nicht angegeben, führt Claude seinen eigenen Proxy aus. | `8081` |

436| `network.tlsTerminate` | Experimentell. Beenden Sie TLS innerhalb des Sandbox-Proxys, damit er den Inhalt von HTTPS-Anfragen lesen kann. Erforderlich für `mask` [Anmeldedaten-Substitution](/de/sandboxing#protect-credentials). Setzen Sie `{}`, um eine ephemerale Zertifizierungsstelle für die Sitzung zu generieren, oder setzen Sie `caCertPath` und `caKeyPath`, um Ihre eigene zu verwenden. Wird nur aus Benutzer-, verwalteten oder CLI-`--settings` Einstellungen berücksichtigt, nicht aus `.claude/settings.json` oder `.claude/settings.local.json`. Erfordert Claude Code v2.1.199 oder später. {{/* min-version: 2.1.199 */}} | `{}` |436| `network.tlsTerminate` | Experimentell. Beenden Sie TLS innerhalb des Sandbox-Proxys, damit er den Inhalt von HTTPS-Anfragen lesen kann. Erforderlich für `mask` [Anmeldedaten-Substitution](/docs/de/sandboxing#protect-credentials). Setzen Sie `{}`, um eine ephemerale Zertifizierungsstelle für die Sitzung zu generieren, oder setzen Sie `caCertPath` und `caKeyPath`, um Ihre eigene zu verwenden. Wird nur aus Benutzer-, verwalteten oder CLI-`--settings` Einstellungen berücksichtigt, nicht aus `.claude/settings.json` oder `.claude/settings.local.json`. Erfordert Claude Code v2.1.199 oder später. {{/* min-version: 2.1.199 */}} | `{}` |

437| `enableWeakerNestedSandbox` | Aktivieren Sie schwächere Sandbox für unprivilegierte Docker-Umgebungen (nur Linux und WSL2). **Reduziert die Sicherheit.** Standard: false | `true` |437| `enableWeakerNestedSandbox` | Aktivieren Sie schwächere Sandbox für unprivilegierte Docker-Umgebungen (nur Linux und WSL2). **Reduziert die Sicherheit.** Standard: false | `true` |

438| `enableWeakerNetworkIsolation` | (Nur macOS) Erlauben Sie den Zugriff auf den System-TLS-Vertrauensdienst (`com.apple.trustd.agent`) in der Sandbox. Erforderlich für Go-basierte Tools wie `gh`, `gcloud` und `terraform`, um TLS-Zertifikate zu überprüfen, wenn `httpProxyPort` mit einem MITM-Proxy und benutzerdefinierter CA verwendet wird. **Reduziert die Sicherheit** durch Öffnen eines möglichen Datenexfiltrationspfads. Standard: false | `true` |438| `enableWeakerNetworkIsolation` | (Nur macOS) Erlauben Sie den Zugriff auf den System-TLS-Vertrauensdienst (`com.apple.trustd.agent`) in der Sandbox. Erforderlich für Go-basierte Tools wie `gh`, `gcloud` und `terraform`, um TLS-Zertifikate zu überprüfen, wenn `httpProxyPort` mit einem MITM-Proxy und benutzerdefinierter CA verwendet wird. **Reduziert die Sicherheit** durch Öffnen eines möglichen Datenexfiltrationspfads. Standard: false | `true` |

439| `allowAppleEvents` | (Nur macOS) Erlauben Sie Sandbox-Befehlen, Apple Events zu senden. Erforderlich für `open`, `osascript` und Tools, die URLs in einem Browser öffnen, die ansonsten mit Fehler `-600` fehlschlagen. **Entfernt Code-Ausführungs-Isolation.** Sandbox-Befehle können andere Anwendungen unsandboxed ohne Benutzer-Aufforderung starten; sie können auch AppleScript-Befehle an laufende Anwendungen wie Terminal senden, unterliegen aber der Pro-App-macOS-Automatisierungs-Zustimmungs-Aufforderung (TCC). Wird nur aus Benutzer-, verwalteten oder CLI-Einstellungen berücksichtigt, nicht aus Projekteinstellungen. Standard: false | `true` |439| `allowAppleEvents` | (Nur macOS) Erlauben Sie Sandbox-Befehlen, Apple Events zu senden. Erforderlich für `open`, `osascript` und Tools, die URLs in einem Browser öffnen, die ansonsten mit Fehler `-600` fehlschlagen. **Entfernt Code-Ausführungs-Isolation.** Sandbox-Befehle können andere Anwendungen unsandboxed ohne Benutzer-Aufforderung starten; sie können auch AppleScript-Befehle an laufende Anwendungen wie Terminal senden, unterliegen aber der Pro-App-macOS-Automatisierungs-Zustimmungs-Aufforderung (TCC). Wird nur aus Benutzer-, verwalteten oder CLI-Einstellungen berücksichtigt, nicht aus Projekteinstellungen. Standard: false | `true` |

440| `bwrapPath` | (Nur verwaltete Einstellungen, Linux/WSL2) Absoluter Pfad zur bubblewrap (`bwrap`) Binärdatei. Überschreibt automatische Erkennung über `PATH`. Wird nur aus [verwalteten Einstellungen](/de/settings#settings-files) berücksichtigt, nicht aus Benutzer- oder Projekteinstellungen. Nützlich, wenn `bwrap` an einem nicht standardmäßigen Ort in verwalteten Umgebungen installiert ist. | `/opt/admin/bwrap` |440| `bwrapPath` | (Nur verwaltete Einstellungen, Linux/WSL2) Absoluter Pfad zur bubblewrap (`bwrap`) Binärdatei. Überschreibt automatische Erkennung über `PATH`. Wird nur aus [verwalteten Einstellungen](/docs/de/settings#settings-files) berücksichtigt, nicht aus Benutzer- oder Projekteinstellungen. Nützlich, wenn `bwrap` an einem nicht standardmäßigen Ort in verwalteten Umgebungen installiert ist. | `/opt/admin/bwrap` |

441| `socatPath` | (Nur verwaltete Einstellungen, Linux/WSL2) Absoluter Pfad zur `socat` Binärdatei, die für den Sandbox-Netzwerk-Proxy verwendet wird. Überschreibt automatische Erkennung über `PATH`. Wird nur aus verwalteten Einstellungen berücksichtigt. | `/opt/admin/socat` |441| `socatPath` | (Nur verwaltete Einstellungen, Linux/WSL2) Absoluter Pfad zur `socat` Binärdatei, die für den Sandbox-Netzwerk-Proxy verwendet wird. Überschreibt automatische Erkennung über `PATH`. Wird nur aus verwalteten Einstellungen berücksichtigt. | `/opt/admin/socat` |

442 442

443<h4 id="sandbox-path-prefixes">443<h4 id="sandbox-path-prefixes">

452| `~/` | Relativ zum Home-Verzeichnis | `~/.kube` wird zu `$HOME/.kube` |452| `~/` | Relativ zum Home-Verzeichnis | `~/.kube` wird zu `$HOME/.kube` |

453| `./` oder kein Präfix | Relativ zum Projektstamm für Projekteinstellungen oder zu `~/.claude` für Benutzereinstellungen | `./output` in `.claude/settings.json` wird zu `<project-root>/output` |453| `./` oder kein Präfix | Relativ zum Projektstamm für Projekteinstellungen oder zu `~/.claude` für Benutzereinstellungen | `./output` in `.claude/settings.json` wird zu `<project-root>/output` |

454 454

455Das ältere `//path`-Präfix für absolute Pfade funktioniert weiterhin. Wenn Sie zuvor ein einzelnes Schrägstrich `/path` erwartet haben, um projektrelativ aufgelöst zu werden, wechseln Sie zu `./path`. Diese Syntax unterscheidet sich von [Read- und Edit-Berechtigungsregeln](/de/permissions#read-and-edit), die `//path` für absolut und `/path` für projektrelativ verwenden. Sandbox-Dateisystempfade verwenden Standard-Konventionen: `/tmp/build` ist ein absoluter Pfad.455Das ältere `//path`-Präfix für absolute Pfade funktioniert weiterhin. Wenn Sie zuvor ein einzelnes Schrägstrich `/path` erwartet haben, um projektrelativ aufgelöst zu werden, wechseln Sie zu `./path`. Diese Syntax unterscheidet sich von [Read- und Edit-Berechtigungsregeln](/docs/de/permissions#read-and-edit), die `//path` für absolut und `/path` für projektrelativ verwenden. Sandbox-Dateisystempfade verwenden Standard-Konventionen: `/tmp/build` ist ein absoluter Pfad.

456 456

457**Konfigurationsbeispiel:**457**Konfigurationsbeispiel:**

458 458

542}542}

543```543```

544 544

545Der Befehl wird mit den gleichen Umgebungsvariablen wie [Hooks](/de/hooks) ausgeführt, einschließlich `CLAUDE_PROJECT_DIR`. Er empfängt JSON über stdin mit einem `query`-Feld:545Der Befehl wird mit den gleichen Umgebungsvariablen wie [Hooks](/docs/de/hooks) ausgeführt, einschließlich `CLAUDE_PROJECT_DIR`. Er empfängt JSON über stdin mit einem `query`-Feld:

546 546

547```json theme={null}547```json theme={null}

548{"query": "src/comp"}548{"query": "src/comp"}

603 603

604Wenn eine Runde abgeschlossen ist, gleicht Claude Code jeden Eintrag's `pattern` Regex gegen die Ausgabe der Runde im Haupt-Thread ab, daher blockiert ein langsamer Regex die UI, 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 `*`.604Wenn eine Runde abgeschlossen ist, gleicht Claude Code jeden Eintrag's `pattern` Regex gegen die Ausgabe der Runde im Haupt-Thread ab, daher blockiert ein langsamer Regex die UI, 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 `*`.

605 605

606Footer-Badges werden neben einer [benutzerdefinierten Statuszeile](/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 Footer-Badges, um IDs aus dem Gespräch in Links umzuwandeln, ohne ein Skript.606Footer-Badges 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 Footer-Badges, um IDs aus dem Gespräch in Links umzuwandeln, ohne ein Skript.

607 607

608<h3 id="hook-configuration">608<h3 id="hook-configuration">

609 Hook-Konfiguration609 Hook-Konfiguration

641 Berechnen Sie verwaltete Einstellungen mit einem Policy Helper641 Berechnen Sie verwaltete Einstellungen mit einem Policy Helper

642</h3>642</h3>

643 643

644Die Einstellung `policyHelper` verweist auf eine ausführbare Datei, die verwaltete Einstellungen beim Start dynamisch berechnet, sodass Administratoren Richtlinien von Geräteposition, Identität oder einem Remote-Service ableiten können, anstatt eine statische Datei zu verwenden. Konfigurieren Sie sie von MDM oder einer System-`managed-settings.json`-Datei. Claude Code ignoriert `policyHelper`, wenn es in einem anderen Bereich erscheint, einschließlich Benutzereinstellungen, Projekteinstellungen, der HKCU-Registry-Struktur und [Serververwalteten Einstellungen](/de/server-managed-settings).644Die Einstellung `policyHelper` verweist auf eine ausführbare Datei, die verwaltete Einstellungen beim Start dynamisch berechnet, sodass Administratoren Richtlinien von Geräteposition, Identität oder einem Remote-Service ableiten können, anstatt eine statische Datei zu verwenden. Konfigurieren Sie sie von MDM oder einer System-`managed-settings.json`-Datei. Claude Code ignoriert `policyHelper`, wenn es in einem anderen Bereich erscheint, einschließlich Benutzereinstellungen, Projekteinstellungen, der HKCU-Registry-Struktur und [Serververwalteten Einstellungen](/docs/de/server-managed-settings).

645 645

646Die Einstellung akzeptiert diese Schlüssel:646Die Einstellung akzeptiert diese Schlüssel:

647 647

671 671

672Einstellungen werden in Prioritätsreihenfolge angewendet. Von höchster zu niedrigster:672Einstellungen werden in Prioritätsreihenfolge angewendet. Von höchster zu niedrigster:

673 673

6741. **Verwaltete Einstellungen** ([Serververwaltete](/de/server-managed-settings), [MDM/OS-Richtlinien](#configuration-scopes) oder [Verwaltete Einstellungen](/de/settings#settings-files))6741. **Verwaltete Einstellungen** ([Serververwaltete](/docs/de/server-managed-settings), [MDM/OS-Richtlinien](#configuration-scopes) oder [Verwaltete Einstellungen](/docs/de/settings#settings-files))

675 * Richtlinien, die von IT über Server-Bereitstellung, MDM-Konfigurationsprofile, Registry-Richtlinien oder verwaltete Einstellungsdateien bereitgestellt werden675 * Richtlinien, die von IT über Server-Bereitstellung, MDM-Konfigurationsprofile, Registry-Richtlinien oder verwaltete Einstellungsdateien bereitgestellt werden

676 * Können nicht durch andere Ebenen überschrieben werden, einschließlich Befehlszeilenargumenten676 * Können nicht durch andere Ebenen überschrieben werden, einschließlich Befehlszeilenargumenten

677 * Innerhalb der verwalteten Ebene ist die Priorität: [`policyHelper`](#compute-managed-settings-with-a-policy-helper) Ausgabe, die bei Konfiguration die einzige verwaltete Quelle ist > Remote (claude.ai [Serververwaltete](/de/server-managed-settings) oder [Claude-Apps-Gateway](/de/claude-apps-gateway)-bereitgestellt) > MDM/OS-Richtlinien > dateibasierte (`managed-settings.d/*.json` + `managed-settings.json`) > HKCU-Registry (nur Windows). Nur eine verwaltete Quelle wird verwendet; Quellen werden nicht zusammengeführt, mit einer Ausnahme: die Sandbox-Sperr-Schlüssel `sandbox.network.allowManagedDomainsOnly` und `sandbox.filesystem.allowManagedReadPathsOnly`, mit ihren zugehörigen Allowlists, `allowAllClaudeAiMcps` und die Sandbox-Binär-Pfade `sandbox.bwrapPath` und `sandbox.socatPath` werden berücksichtigt, wenn eine Admin-kontrollierte verwaltete Quelle sie setzt; die benutzerbare HKCU-Ebene ist ausgeschlossen. Innerhalb der dateibasierten Ebene werden Drop-in-Dateien und die Basisdatei zusammengeführt.677 * Innerhalb der verwalteten Ebene ist die Priorität: [`policyHelper`](#compute-managed-settings-with-a-policy-helper) Ausgabe, die bei Konfiguration die einzige verwaltete Quelle ist > Remote (claude.ai [Serververwaltete](/docs/de/server-managed-settings) oder [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-bereitgestellt) > MDM/OS-Richtlinien > dateibasierte (`managed-settings.d/*.json` + `managed-settings.json`) > HKCU-Registry (nur Windows). Nur eine verwaltete Quelle wird verwendet; Quellen werden nicht zusammengeführt, mit einer Ausnahme: die Sandbox-Sperr-Schlüssel `sandbox.network.allowManagedDomainsOnly` und `sandbox.filesystem.allowManagedReadPathsOnly`, mit ihren zugehörigen Allowlists, `allowAllClaudeAiMcps` und die Sandbox-Binär-Pfade `sandbox.bwrapPath` und `sandbox.socatPath` werden berücksichtigt, wenn eine Admin-kontrollierte verwaltete Quelle sie setzt; die benutzerbare HKCU-Ebene ist ausgeschlossen. Innerhalb der dateibasierten Ebene werden Drop-in-Dateien und die Basisdatei zusammengeführt.

678 * Eingebettete Hosts wie Claude Desktop können Richtlinien über die SDK `managedSettings` Option bereitstellen. Standardmäßig wird dies ignoriert, wenn eine Admin-bereitgestellte verwaltete Quelle vorhanden ist: Serververwaltete Einstellungen, eine MDM- oder OS-Richtlinie oder eine verwaltete Einstellungsdatei. Der benutzerbare HKCU-Registry-Fallback zählt nicht als Admin-bereitgestellte Quelle. Administratoren können sich anmelden, indem sie [`parentSettingsBehavior`](#available-settings) auf `"merge"` setzen. Die Werte des Embedders werden gefiltert, sodass sie verwaltete Richtlinien verschärfen, aber nicht lockern können.678 * Eingebettete Hosts wie Claude Desktop können Richtlinien über die SDK `managedSettings` Option bereitstellen. Standardmäßig wird dies ignoriert, wenn eine Admin-bereitgestellte verwaltete Quelle vorhanden ist: Serververwaltete Einstellungen, eine MDM- oder OS-Richtlinie oder eine verwaltete Einstellungsdatei. Der benutzerbare HKCU-Registry-Fallback zählt nicht als Admin-bereitgestellte Quelle. Administratoren können sich anmelden, indem sie [`parentSettingsBehavior`](#available-settings) auf `"merge"` setzen. Die Werte des Embedders werden gefiltert, sodass sie verwaltete Richtlinien verschärfen, aber nicht lockern können.

679 679

6802. **Befehlszeilenargumente**6802. **Befehlszeilenargumente**

6895. **Benutzereinstellungen** (`~/.claude/settings.json`)6895. **Benutzereinstellungen** (`~/.claude/settings.json`)

690 * Persönliche globale Einstellungen690 * Persönliche globale Einstellungen

691 691

692Diese Hierarchie stellt sicher, dass Organisationsrichtlinien immer durchgesetzt werden, während Teams und Einzelpersonen ihre Erfahrung weiterhin anpassen können. Die gleiche Priorität gilt, ob Sie Claude Code von der CLI, der [VS Code-Erweiterung](/de/vs-code) oder einer [JetBrains IDE](/de/jetbrains) ausführen.692Diese Hierarchie stellt sicher, dass Organisationsrichtlinien immer durchgesetzt werden, während Teams und Einzelpersonen ihre Erfahrung weiterhin anpassen können. Die gleiche Priorität gilt, ob Sie Claude Code von der CLI, der [VS Code-Erweiterung](/docs/de/vs-code) oder einer [JetBrains IDE](/docs/de/jetbrains) ausführen.

693 693

694Wenn beispielsweise Ihre Benutzereinstellungen `permissions.defaultMode` auf `acceptEdits` setzen und die gemeinsamen Einstellungen eines Projekts es auf `default` setzen, gilt der Projektwert. Das folgende Beispiel zeigt, wie Array-wertige Einstellungen wie Berechtigungsregeln stattdessen kombiniert werden.694Wenn beispielsweise Ihre Benutzereinstellungen `permissions.defaultMode` auf `acceptEdits` setzen und die gemeinsamen Einstellungen eines Projekts es auf `default` setzen, gilt der Projektwert. Das folgende Beispiel zeigt, wie Array-wertige Einstellungen wie Berechtigungsregeln stattdessen kombiniert werden.

695 695

699 Zwei Array-Einstellungen werden nicht auf diese Weise zusammengeführt:699 Zwei Array-Einstellungen werden nicht auf diese Weise zusammengeführt:

700 700

701 * [`fallbackModel`](#available-settings) ist eine geordnete Kette, bei der Position Bedeutung hat: Die Datei mit der höchsten Priorität, die sie definiert, liefert den gesamten Wert.701 * [`fallbackModel`](#available-settings) ist eine geordnete Kette, bei der Position Bedeutung hat: Die Datei mit der höchsten Priorität, die sie definiert, liefert den gesamten Wert.

702 * [`availableModels`](#available-settings): {/* min-version: 2.1.175 */}Wenn die [höchste Priorität verwaltete Quelle](/de/server-managed-settings#settings-precedence) sie definiert, wird diese Liste wie sie ist angewendet und Benutzer-, Projekt- und lokale Einträge können sie nicht erweitern. Über nicht verwaltete Bereiche werden die Arrays wie üblich zusammengeführt. Siehe [Zusammenführungsverhalten](/de/model-config#merge-behavior).702 * [`availableModels`](#available-settings): Wenn die [höchste Priorität verwaltete Quelle](/docs/de/server-managed-settings#settings-precedence) sie definiert, wird diese Liste wie sie ist angewendet und Benutzer-, Projekt- und lokale Einträge können sie nicht erweitern. Über nicht verwaltete Bereiche werden die Arrays wie üblich zusammengeführt. Siehe [Zusammenführungsverhalten](/docs/de/model-config#merge-behavior).

703</Note>703</Note>

704 704

705<h3 id="verify-active-settings">705<h3 id="verify-active-settings">

711* Wenn eine Ebene wie `User settings` oder `Project local settings` angezeigt wird, wird diese Datei gelesen.711* Wenn eine Ebene wie `User settings` oder `Project local settings` angezeigt wird, wird diese Datei gelesen.

712* Wenn eine Ebene fehlt, wurde diese Datei nicht gefunden oder enthält keine Schlüssel.712* Wenn eine Ebene fehlt, wurde diese Datei nicht gefunden oder enthält keine Schlüssel.

713 713

714Wenn [verwaltete Einstellungen](/de/admin-setup#decide-how-settings-reach-devices) wirksam sind, zeigt der Eintrag den Bereitstellungskanal in Klammern an, z. B. `Enterprise managed settings (remote)`, `(plist)`, `(HKLM)`, `(HKCU)` oder `(file)`. Der `remote` Kanal deckt sowohl claude.ai Serververwaltete Einstellungen als auch [Claude-Apps-Gateway](/de/claude-apps-gateway)-bereitgestellte Richtlinien ab.714Wenn [verwaltete Einstellungen](/docs/de/admin-setup#decide-how-settings-reach-devices) wirksam sind, zeigt der Eintrag den Bereitstellungskanal in Klammern an, z. B. `Enterprise managed settings (remote)`, `(plist)`, `(HKLM)`, `(HKCU)` oder `(file)`. Der `remote` Kanal deckt sowohl claude.ai Serververwaltete Einstellungen als auch [Claude-Apps-Gateway](/docs/de/claude-apps-gateway)-bereitgestellte Richtlinien ab.

715 715

716Die Zeile bestätigt, welche Dateien gelesen werden, nicht welche Ebene jeden einzelnen Schlüssel bereitgestellt hat. Die Registerkarte **Config** im gleichen Dialog bearbeitet integrierte Umschalter wie Thema und ausführliche Ausgabe, nicht Ihre `settings.json`-Inhalte.716Die Zeile bestätigt, welche Dateien gelesen werden, nicht welche Ebene jeden einzelnen Schlüssel bereitgestellt hat. Die Registerkarte **Config** im gleichen Dialog bearbeitet integrierte Umschalter wie Thema und ausführliche Ausgabe, nicht Ihre `settings.json`-Inhalte.

717 717

765* **Benutzer-Subagents**: `~/.claude/agents/`, verfügbar über alle Ihre Projekte765* **Benutzer-Subagents**: `~/.claude/agents/`, verfügbar über alle Ihre Projekte

766* **Projekt-Subagents**: `.claude/agents/`, spezifisch für Ihr Projekt und teilbar mit Ihrem Team766* **Projekt-Subagents**: `.claude/agents/`, spezifisch für Ihr Projekt und teilbar mit Ihrem Team

767 767

768Subagent-Dateien definieren spezialisierte KI-Assistenten mit benutzerdefinierten Aufforderungen und Werkzeugberechtigungen. Erfahren Sie mehr über das Erstellen und Verwenden von Subagents in der [Subagents-Dokumentation](/de/sub-agents).768Subagent-Dateien definieren spezialisierte KI-Assistenten mit benutzerdefinierten Aufforderungen und Werkzeugberechtigungen. Erfahren Sie mehr über das Erstellen und Verwenden von Subagents in der [Subagents-Dokumentation](/docs/de/sub-agents).

769 769

770<h2 id="plugin-configuration">770<h2 id="plugin-configuration">

771 Plugin-Konfiguration771 Plugin-Konfiguration

801 `enabledPlugins`801 `enabledPlugins`

802</h4>802</h4>

803 803

804Steuert, welche Plugins aktiviert sind. Format: `"plugin-name@marketplace-name": true/false`. Ein Plugin ohne Eintrag in einem beliebigen Bereich fällt auf seinen [`defaultEnabled`](/de/plugins-reference#default-enablement) Wert zurück.804Steuert, welche Plugins aktiviert sind. Format: `"plugin-name@marketplace-name": true/false`. Ein Plugin ohne Eintrag in einem beliebigen Bereich fällt auf seinen [`defaultEnabled`](/docs/de/plugins-reference#default-enablement) Wert zurück.

805 805

806**Bereiche**:806**Bereiche**:

807 807

815 815

816 Plugins, die durch verwaltete Einstellungen erzwungen aktiviert sind, können auf diese Weise nicht deaktiviert werden, da verwaltete Einstellungen lokale Einstellungen überschreiben.816 Plugins, die durch verwaltete Einstellungen erzwungen aktiviert sind, können auf diese Weise nicht deaktiviert werden, da verwaltete Einstellungen lokale Einstellungen überschreiben.

817 817

818 Das 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. Ab Claude Code v2.1.195 fragt jeder Pfad, der Plugins lädt, jeden Benutzer auf, [das Plugin zu installieren und zu vertrauen](/de/discover-plugins#configure-team-marketplaces), bevor es ausgeführt wird.818 Das 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. Ab Claude Code v2.1.195 fragt jeder Pfad, der Plugins lädt, jeden Benutzer auf, [das Plugin zu installieren und zu vertrauen](/docs/de/discover-plugins#configure-team-marketplaces), bevor es ausgeführt wird.

819</Note>819</Note>

820 820

821**Beispiel**:821**Beispiel**:

834 `pluginConfigs`834 `pluginConfigs`

835</h4>835</h4>

836 836

837Speichert die nicht-sensiblen Optionswerte, die die [`userConfig`](/de/plugins-reference#user-configuration) Eingabeaufforderung eines Plugins sammelt, indiziert nach Plugin-ID. Claude Code schreibt diesen Schlüssel in Benutzereinstellungen, wenn Sie das Konfigurationsdialogfeld des Plugins ausfüllen, sodass Sie ihn nicht manuell bearbeiten müssen. Sensible Optionen werden stattdessen im macOS Keychain gespeichert oder in `~/.claude/.credentials.json` auf Plattformen ohne unterstützten Keychain.837Speichert die nicht-sensiblen Optionswerte, die die [`userConfig`](/docs/de/plugins-reference#user-configuration) Eingabeaufforderung eines Plugins sammelt, indiziert nach Plugin-ID. Claude Code schreibt diesen Schlüssel in Benutzereinstellungen, wenn Sie das Konfigurationsdialogfeld des Plugins ausfüllen, sodass Sie ihn nicht manuell bearbeiten müssen. Sensible Optionen werden stattdessen im macOS Keychain gespeichert oder in `~/.claude/.credentials.json` auf Plattformen ohne unterstützten Keychain.

838 838

839Dieses Beispiel speichert eine Option für ein Plugin, das vom `acme-tools` Marketplace installiert wurde:839Dieses Beispiel speichert eine Option für ein Plugin, das vom `acme-tools` Marketplace installiert wurde:

840 840

894* `hostPattern`: Regex-Muster zum Abgleichen von Marketplace-Hosts (verwendet `hostPattern`)894* `hostPattern`: Regex-Muster zum Abgleichen von Marketplace-Hosts (verwendet `hostPattern`)

895* `settings`: Inline-Marketplace, der direkt in settings.json deklariert wird, ohne ein separates gehostetes Repository (verwendet `name` und `plugins`)895* `settings`: Inline-Marketplace, der direkt in settings.json deklariert wird, ohne ein separates gehostetes Repository (verwendet `name` und `plugins`)

896 896

897Der `git` Quellentyp funktioniert mit jedem Git-Hosting-Service, einschließlich selbstgehosteter GitLab und Bitbucket. Claude Code klont das Repository mit der gleichen Authentifizierung, die `git clone` auf dieser Maschine 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](/de/plugin-marketplaces#private-repositories) für Setup-Details.897Der `git` Quellentyp funktioniert mit jedem Git-Hosting-Service, einschließlich selbstgehosteter GitLab und Bitbucket. Claude Code klont das Repository mit der gleichen Authentifizierung, die `git clone` auf dieser Maschine 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/plugin-marketplaces#private-repositories) für Setup-Details.

898 898

899Für `github` und `git` Quellen setzen Sie `"skipLfs": true` innerhalb des `source` Objekts (neben `repo` oder `url`), um Git LFS-Downloads zu überspringen, wenn Claude Code das Marketplace-Repository klont oder aktualisiert. LFS-Zeigerdateien bleiben als Zeiger erhalten, anstatt ihren Inhalt herunterzuladen. Verwenden Sie dies, wenn das Repository große LFS-Objekte enthält, die nicht mit Plugin-Inhalten zusammenhängen. {/* min-version: 2.1.153 */}Erfordert Claude Code v2.1.153 oder später.899Für `github` und `git` Quellen setzen Sie `"skipLfs": true` innerhalb des `source` Objekts (neben `repo` oder `url`), um Git LFS-Downloads zu überspringen, wenn Claude Code das Marketplace-Repository klont oder aktualisiert. LFS-Zeigerdateien bleiben als Zeiger erhalten, anstatt ihren Inhalt herunterzuladen. Verwenden Sie dies, wenn das Repository große LFS-Objekte enthält, die nicht mit Plugin-Inhalten zusammenhängen. Erfordert Claude Code v2.1.153 oder später.

900 900

901Jeder Marketplace-Eintrag akzeptiert auch einen optionalen `autoUpdate` Boolean. Setzen Sie `"autoUpdate": true` neben `source`, um Claude Code zu veranlassen, diesen Marketplace zu aktualisieren und seine installierten Plugins im Hintergrund nach dem Start zu aktualisieren. Wenn nicht angegeben, verwenden offizielle Anthropic-Marketplaces standardmäßig `true` und alle anderen Marketplaces standardmäßig `false`. Siehe [Automatische Aktualisierungen konfigurieren](/de/discover-plugins#configure-auto-updates).901Jeder Marketplace-Eintrag akzeptiert auch einen optionalen `autoUpdate` Boolean. Setzen Sie `"autoUpdate": true` neben `source`, um Claude Code zu veranlassen, diesen Marketplace zu aktualisieren und seine installierten Plugins im Hintergrund nach dem Start zu aktualisieren. Wenn nicht angegeben, verwenden offizielle Anthropic-Marketplaces standardmäßig `true` und alle anderen Marketplaces standardmäßig `false`. Siehe [Automatische Aktualisierungen konfigurieren](/docs/de/discover-plugins#configure-auto-updates).

902 902

903Verwenden Sie `source: 'settings'`, um einen kleinen Satz von Plugins inline zu deklarieren, ohne ein gehostetes Marketplace-Repository einzurichten. Plugins, die hier aufgelistet sind, müssen externe Quellen wie GitHub oder npm referenzieren. Sie müssen weiterhin jedes Plugin separat in `enabledPlugins` aktivieren.903Verwenden Sie `source: 'settings'`, um einen kleinen Satz von Plugins inline zu deklarieren, ohne ein gehostetes Marketplace-Repository einzurichten. Plugins, die hier aufgelistet sind, müssen externe Quellen wie GitHub oder npm referenzieren. Sie müssen weiterhin jedes Plugin separat in `enabledPlugins` aktivieren.

904 904

928 `strictKnownMarketplaces`928 `strictKnownMarketplaces`

929</h4>929</h4>

930 930

931**Nur verwaltete Einstellungen**: Steuert, welche Plugin-Marketplaces Benutzer hinzufügen und Plugins installieren dürfen. Diese Einstellung kann nur in [verwalteten Einstellungen](/de/settings#settings-files) konfiguriert werden und bietet Administratoren strikte Kontrolle über Marketplace-Quellen.931**Nur verwaltete Einstellungen**: Steuert, welche Plugin-Marketplaces Benutzer hinzufügen und Plugins installieren dürfen. Diese Einstellung kann nur in [verwalteten Einstellungen](/docs/de/settings#settings-files) konfiguriert werden und bietet Administratoren strikte Kontrolle über Marketplace-Quellen.

932 932

933**Verwaltete Einstellungsdatei-Speicherorte**:933**Verwaltete Einstellungsdatei-Speicherorte**:

934 934

983Felder: `url` (erforderlich), `headers` (optional: HTTP-Header für authentifizierten Zugriff)983Felder: `url` (erforderlich), `headers` (optional: HTTP-Header für authentifizierten Zugriff)

984 984

985<Note>985<Note>

986 URL-basierte Marketplaces laden nur die `marketplace.json`-Datei herunter. Sie laden keine Plugin-Dateien vom Server herunter. Plugins in URL-basierten Marketplaces müssen externe Quellen (GitHub, npm oder Git-URLs) verwenden, anstatt relative Pfade. Für Plugins mit relativen Pfaden verwenden Sie stattdessen einen Git-basierten Marketplace. Siehe [Troubleshooting](/de/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces) für Details.986 URL-basierte Marketplaces laden nur die `marketplace.json`-Datei herunter. Sie laden keine Plugin-Dateien vom Server herunter. Plugins in URL-basierten Marketplaces müssen externe Quellen (GitHub, npm oder Git-URLs) verwenden, anstatt relative Pfade. Für Plugins mit relativen Pfaden verwenden Sie stattdessen einen Git-basierten Marketplace. Siehe [Troubleshooting](/docs/de/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces) für Details.

987</Note>987</Note>

988 988

9894. **NPM-Pakete**:9894. **NPM-Pakete**:

1173* Die Einschränkung wird beim Hinzufügen und beim Installieren, Aktualisieren, Aktualisieren und automatischen Aktualisieren von Plugins durchgesetzt. Ein Marketplace, der vor dem Festlegen der Richtlinie hinzugefügt wurde, kann nicht mehr zum Installieren oder Aktualisieren von Plugins verwendet werden, sobald seine Quelle nicht mehr mit der Allowlist übereinstimmt1173* Die Einschränkung wird beim Hinzufügen und beim Installieren, Aktualisieren, Aktualisieren und automatischen Aktualisieren von Plugins durchgesetzt. Ein Marketplace, der vor dem Festlegen der Richtlinie hinzugefügt wurde, kann nicht mehr zum Installieren oder Aktualisieren von Plugins verwendet werden, sobald seine Quelle nicht mehr mit der Allowlist übereinstimmt

1174* Verwaltete Einstellungen haben die höchste Priorität und können nicht überschrieben werden1174* Verwaltete Einstellungen haben die höchste Priorität und können nicht überschrieben werden

1175 1175

1176Siehe [Verwaltete Marketplace-Einschränkungen](/de/plugin-marketplaces#managed-marketplace-restrictions) für Dokumentation für Benutzer.1176Siehe [Verwaltete Marketplace-Einschränkungen](/docs/de/plugin-marketplaces#managed-marketplace-restrictions) für Dokumentation für Benutzer.

1177 1177

1178<h4 id="strictpluginonlycustomization">1178<h4 id="strictpluginonlycustomization">

1179 `strictPluginOnlyCustomization`1179 `strictPluginOnlyCustomization`

1199| `mcp` | Server in `~/.claude.json` und `.mcp.json` | Plugin-MCP-Server, [`managed-mcp.json`](/de/managed-mcp) Server |1199| `mcp` | Server in `~/.claude.json` und `.mcp.json` | Plugin-MCP-Server, [`managed-mcp.json`](/docs/de/managed-mcp) Server |

1200 1200

1201Oberflächennamen, die eine Claude Code-Version nicht erkennt, werden ignoriert, anstatt die Einstellungsdatei fehlschlagen zu lassen, sodass Sie neue Oberflächennamen hinzufügen können, bevor alle Clients aktualisiert wurden.1201Oberflächennamen, die eine Claude Code-Version nicht erkennt, werden ignoriert, anstatt die Einstellungsdatei fehlschlagen zu lassen, sodass Sie neue Oberflächennamen hinzufügen können, bevor alle Clients aktualisiert wurden.

1202 1202

1212* Zeigen Sie Plugin-Details an (bereitgestellte Skills, Agents, Hooks)1212* Zeigen Sie Plugin-Details an (bereitgestellte Skills, Agents, Hooks)

1213* Fügen Sie Marketplaces hinzu/entfernen Sie sie1213* Fügen Sie Marketplaces hinzu/entfernen Sie sie

1214 1214

1215Erfahren Sie mehr über das Plugin-System in der [Plugins-Dokumentation](/de/plugins).1215Erfahren Sie mehr über das Plugin-System in der [Plugins-Dokumentation](/docs/de/plugins).

1216 1216

1217<h2 id="environment-variables">1217<h2 id="environment-variables">

1218 Umgebungsvariablen1218 Umgebungsvariablen

1220 1220

1221Umgebungsvariablen ermöglichen es Ihnen, das Verhalten von Claude Code zu steuern, ohne Einstellungsdateien zu bearbeiten. Jede Variable kann auch in [`settings.json`](#available-settings) unter dem Schlüssel `env` konfiguriert werden, um sie auf jede Sitzung anzuwenden oder für Ihr Team bereitzustellen.1221Umgebungsvariablen ermöglichen es Ihnen, das Verhalten von Claude Code zu steuern, ohne Einstellungsdateien zu bearbeiten. Jede Variable kann auch in [`settings.json`](#available-settings) unter dem Schlüssel `env` konfiguriert werden, um sie auf jede Sitzung anzuwenden oder für Ihr Team bereitzustellen.

1222 1222

1223Siehe die [Umgebungsvariablen-Referenz](/de/env-vars) für die vollständige Liste.1223Siehe die [Umgebungsvariablen-Referenz](/docs/de/env-vars) für die vollständige Liste.

1224 1224

1225<h2 id="tools-available-to-claude">1225<h2 id="tools-available-to-claude">

1226 Tools, die Claude zur Verfügung stehen1226 Tools, die Claude zur Verfügung stehen

1228 1228

1229Claude Code hat Zugriff auf eine Reihe von Tools zum Lesen, Bearbeiten, Suchen, Ausführen von Befehlen und Orchestrieren von Subagents. Tool-Namen sind die genauen Zeichenketten, die Sie in Berechtigungsregeln und Hook-Matchern verwenden.1229Claude Code hat Zugriff auf eine Reihe von Tools zum Lesen, Bearbeiten, Suchen, Ausführen von Befehlen und Orchestrieren von Subagents. Tool-Namen sind die genauen Zeichenketten, die Sie in Berechtigungsregeln und Hook-Matchern verwenden.

1230 1230

1231Siehe die [Tools-Referenz](/de/tools-reference) für die vollständige Liste und Details zum Bash-Tool-Verhalten.1231Siehe die [Tools-Referenz](/docs/de/tools-reference) für die vollständige Liste und Details zum Bash-Tool-Verhalten.

1232 1232

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

1234 Siehe auch1234 Siehe auch

1235</h2>1235</h2>

1236 1236

1237* [Berechtigungen](/de/permissions): Berechtigungssystem, Regelsyntax, werkzeugspezifische Muster und verwaltete Richtlinien1237* [Berechtigungen](/docs/de/permissions): Berechtigungssystem, Regelsyntax, werkzeugspezifische Muster und verwaltete Richtlinien

1238* [Authentifizierung](/de/authentication): Richten Sie Benutzerzugriff auf Claude Code ein1238* [Authentifizierung](/docs/de/authentication): Richten Sie Benutzerzugriff auf Claude Code ein

1239* [Konfiguration debuggen](/de/debug-your-config): Diagnostizieren Sie, warum eine Einstellung, ein Hook oder ein MCP-Server nicht wirksam wird1239* [Konfiguration debuggen](/docs/de/debug-your-config): Diagnostizieren Sie, warum eine Einstellung, ein Hook oder ein MCP-Server nicht wirksam wird

1240* [Troubleshooting bei Installation und Anmeldung](/de/troubleshoot-install): Installations-, Authentifizierungs- und Plattformprobleme1240* [Troubleshooting bei Installation und Anmeldung](/docs/de/troubleshoot-install): Installations-, Authentifizierungs- und Plattformprobleme

skills.md +46 −46

Details

11Erstellen Sie einen Skill, wenn Sie immer wieder die gleichen Anweisungen, eine Checkliste oder ein mehrstufiges Verfahren in den Chat einfügen, oder wenn ein Abschnitt von CLAUDE.md zu einem Verfahren statt zu einer Tatsache geworden ist. Im Gegensatz zu CLAUDE.md-Inhalten wird der Body eines Skills nur geladen, wenn er verwendet wird, sodass lange Referenzmaterialien fast nichts kosten, bis Sie sie benötigen.11Erstellen Sie einen Skill, wenn Sie immer wieder die gleichen Anweisungen, eine Checkliste oder ein mehrstufiges Verfahren in den Chat einfügen, oder wenn ein Abschnitt von CLAUDE.md zu einem Verfahren statt zu einer Tatsache geworden ist. Im Gegensatz zu CLAUDE.md-Inhalten wird der Body eines Skills nur geladen, wenn er verwendet wird, sodass lange Referenzmaterialien fast nichts kosten, bis Sie sie benötigen.

12 12

13<Note>13<Note>

~~14 Für integrierte Befehle wie `/help` und `/compact` sowie gebündelte Skills wie `/debug` und `/code-review` siehe die [Befehlsreferenz](/de/commands).~~14 Für integrierte Befehle wie `/help` und `/compact` sowie gebündelte Skills wie `/debug` und `/code-review` siehe die [Befehlsreferenz](/docs/de/commands).

15 15

16 **Benutzerdefinierte Befehle wurden in Skills zusammengeführt.** Eine Datei unter `.claude/commands/deploy.md` und ein Skill unter `.claude/skills/deploy/SKILL.md` erstellen beide `/deploy` und funktionieren auf die gleiche Weise. Ihre vorhandenen `.claude/commands/`-Dateien funktionieren weiterhin. Skills fügen optionale Funktionen hinzu: ein Verzeichnis für unterstützende Dateien, Frontmatter zum [Steuern, wer einen Skill aufruft](#control-who-invokes-a-skill), und die Möglichkeit für Claude, sie automatisch zu laden, wenn sie relevant sind.16 **Benutzerdefinierte Befehle wurden in Skills zusammengeführt.** Eine Datei unter `.claude/commands/deploy.md` und ein Skill unter `.claude/skills/deploy/SKILL.md` erstellen beide `/deploy` und funktionieren auf die gleiche Weise. Ihre vorhandenen `.claude/commands/`-Dateien funktionieren weiterhin. Skills fügen optionale Funktionen hinzu: ein Verzeichnis für unterstützende Dateien, Frontmatter zum [Steuern, wer einen Skill aufruft](#control-who-invokes-a-skill), und die Möglichkeit für Claude, sie automatisch zu laden, wenn sie relevant sind.

17</Note>17</Note>

22 Gebündelte Skills22 Gebündelte Skills

23</h2>23</h2>

24 24

25Claude Code wird mit einer Reihe von gebündelten Skills ausgeliefert, die in jeder Sitzung verfügbar sind, sofern sie nicht mit der Einstellung [`disableBundledSkills`](/de/settings#available-settings) deaktiviert werden, einschließlich `/doctor`, `/code-review`, `/batch`, `/debug`, `/loop` und `/claude-api`. Im Gegensatz zu den meisten integrierten Befehlen, die direkt feste Logik ausführen, sind gebündelte Skills prompt-basiert: Sie geben Claude detaillierte Anweisungen und lassen es die Arbeit mit seinen Tools orchestrieren. Sie rufen sie auf die gleiche Weise auf wie jeden anderen Skill, indem Sie `/` gefolgt vom Skill-Namen eingeben.25Claude Code wird mit einer Reihe von gebündelten Skills ausgeliefert, die in jeder Sitzung verfügbar sind, sofern sie nicht mit der Einstellung [`disableBundledSkills`](/docs/de/settings#available-settings) deaktiviert werden, einschließlich `/doctor`, `/code-review`, `/batch`, `/debug`, `/loop` und `/claude-api`. Im Gegensatz zu den meisten integrierten Befehlen, die direkt feste Logik ausführen, sind gebündelte Skills prompt-basiert: Sie geben Claude detaillierte Anweisungen und lassen es die Arbeit mit seinen Tools orchestrieren. Sie rufen sie auf die gleiche Weise auf wie jeden anderen Skill, indem Sie `/` gefolgt vom Skill-Namen eingeben.

26 26

27Die [`/doctor`](/de/commands#all-commands) Setup-Überprüfung ist die eine Ausnahme zu `disableBundledSkills` in Claude Code v2.1.205 und später: Sie bleibt eingabbar, wenn die Einstellung aktiviert ist. Um sie auszublenden, setzen Sie die Umgebungsvariable `DISABLE_DOCTOR_COMMAND` oder einen [`skillOverrides`](#override-skill-visibility-from-settings) Eintrag von `"doctor": "off"`. Vor v2.1.205 war `/doctor` ein integrierter Befehl und kein gebündelter Skill.27Die [`/doctor`](/docs/de/commands#all-commands) Setup-Überprüfung ist die eine Ausnahme zu `disableBundledSkills` in Claude Code v2.1.205 und später: Sie bleibt eingabbar, wenn die Einstellung aktiviert ist. Um sie auszublenden, setzen Sie die Umgebungsvariable `DISABLE_DOCTOR_COMMAND` oder einen [`skillOverrides`](#override-skill-visibility-from-settings) Eintrag von `"doctor": "off"`. Vor v2.1.205 war `/doctor` ein integrierter Befehl und kein gebündelter Skill.

28 28

~~29Gebündelte Skills sind in der [Befehlsreferenz](/de/commands) neben integrierten Befehlen aufgelistet und mit **Skill** in der Spalte „Zweck" gekennzeichnet.~~29Gebündelte Skills sind in der [Befehlsreferenz](/docs/de/commands) neben integrierten Befehlen aufgelistet und mit **Skill** in der Spalte „Zweck" gekennzeichnet.

30 30

31<h3 id="run-and-verify-your-app">31<h3 id="run-and-verify-your-app">

32 Ihre App ausführen und überprüfen32 Ihre App ausführen und überprüfen

40| `/verify` | Erstellen und führen Sie Ihre App aus, um zu bestätigen, dass eine Codeänderung das tut, was sie soll, ohne auf Tests oder Typprüfungen zurückzugreifen |40| `/verify` | Erstellen und führen Sie Ihre App aus, um zu bestätigen, dass eine Codeänderung das tut, was sie soll, ohne auf Tests oder Typprüfungen zurückzugreifen |

41| `/run-skill-generator` | Lehren Sie `/run` und `/verify`, wie Sie Ihr Projekt erstellen und starten |41| `/run-skill-generator` | Lehren Sie `/run` und `/verify`, wie Sie Ihr Projekt erstellen und starten |

42 42

~~43{/* min-version: 2.1.145 */}Alle drei Skills erfordern Claude Code v2.1.145 oder später.~~43Alle drei Skills erfordern Claude Code v2.1.145 oder später.

44 44

45`/run` und `/verify` funktionieren ohne Einrichtung. Sie leiten den Start von Ihrem Projekttyp ab (CLI, Server, TUI, browsergesteuert) und von dem, was sich in Ihrer README, `package.json` oder `Makefile` befindet. Diese Ableitung wird unzuverlässig für Projekte, die mehr als einen Standard-Start benötigen: eine Datenbank, eine Env-Datei, eine grafische Sitzung, einen mehrstufigen Build.45`/run` und `/verify` funktionieren ohne Einrichtung. Sie leiten den Start von Ihrem Projekttyp ab (CLI, Server, TUI, browsergesteuert) und von dem, was sich in Ihrer README, `package.json` oder `Makefile` befindet. Diese Ableitung wird unzuverlässig für Projekte, die mehr als einen Standard-Start benötigen: eine Datenbank, eine Env-Datei, eine grafische Sitzung, einen mehrstufigen Build.

46 46

114 114

115| Ort | Pfad | Gilt für |115| Ort | Pfad | Gilt für |

116| :---------- | :------------------------------------------------------------ | :---------------------------------- |116| :---------- | :------------------------------------------------------------ | :---------------------------------- |

133 133

134Wenn Sie oder Claude den unqualifizierten Namen aufrufen, wird der Skill in der Projekt-Root geladen, und Claude Code fügt eine Liste der verzeichnisqualifizierten Varianten zu seinem Inhalt mit einer Anweisung hinzu, auch jede Variante aufzurufen, deren Verzeichnis die Dateien enthält, an denen Claude arbeitet. Ein verschachtelter Skill gilt daher immer noch für die Arbeit in seinem Verzeichnis, wenn nur der unqualifizierte Name aufgerufen wird. Erfordert Claude Code v2.1.203 oder später.134Wenn Sie oder Claude den unqualifizierten Namen aufrufen, wird der Skill in der Projekt-Root geladen, und Claude Code fügt eine Liste der verzeichnisqualifizierten Varianten zu seinem Inhalt mit einer Anweisung hinzu, auch jede Variante aufzurufen, deren Verzeichnis die Dateien enthält, an denen Claude arbeitet. Ein verschachtelter Skill gilt daher immer noch für die Arbeit in seinem Verzeichnis, wenn nur der unqualifizierte Name aufgerufen wird. Erfordert Claude Code v2.1.203 oder später.

135 135

136Ein `<skill-name>`-Eintrag an den Standorten Unternehmen, Persönlich oder Projekt kann ein Symlink zu einem Verzeichnis an anderer Stelle auf der Festplatte sein. Claude Code folgt dem Symlink und liest `SKILL.md` aus dem Zielverzeichnis, und wenn dasselbe Ziel von mehr als einem Ort aus erreichbar ist, lädt Claude Code den Skill einmal. Plugin-Skills handhaben Symlinks anders; siehe [Dateien in einem Marketplace mit Symlinks teilen](/de/plugins-reference#share-files-within-a-marketplace-with-symlinks).136Ein `<skill-name>`-Eintrag an den Standorten Unternehmen, Persönlich oder Projekt kann ein Symlink zu einem Verzeichnis an anderer Stelle auf der Festplatte sein. Claude Code folgt dem Symlink und liest `SKILL.md` aus dem Zielverzeichnis, und wenn dasselbe Ziel von mehr als einem Ort aus erreichbar ist, lädt Claude Code den Skill einmal. Plugin-Skills handhaben Symlinks anders; siehe [Dateien in einem Marketplace mit Symlinks teilen](/docs/de/plugins-reference#share-files-within-a-marketplace-with-symlinks).

137 137

138<Note>138<Note>

139 Fügen Sie eine `.claude-plugin/plugin.json` zu einem Skill-Ordner hinzu und er wird als [Plugin](/de/plugins-reference#skills-directory-plugins) mit dem Namen `<name>@skills-dir` geladen, sodass er Agenten, hooks und MCP-Server bündeln kann. In einem Projekt `.claude/skills/` ist dies erforderlich, um zuerst das Workspace-Trust-Dialogfeld zu akzeptieren.139 Fügen Sie eine `.claude-plugin/plugin.json` zu einem Skill-Ordner hinzu und er wird als [Plugin](/docs/de/plugins-reference#skills-directory-plugins) mit dem Namen `<name>@skills-dir` geladen, sodass er Agenten, hooks und MCP-Server bündeln kann. In einem Projekt `.claude/skills/` ist dies erforderlich, um zuerst das Workspace-Trust-Dialogfeld zu akzeptieren.

140</Note>140</Note>

141 141

142<h4 id="live-change-detection">142<h4 id="live-change-detection">

146Claude Code überwacht Skill-Verzeichnisse auf Dateiänderungen. Das Hinzufügen, Bearbeiten oder Entfernen eines Skills unter `~/.claude/skills/`, dem Projekt `.claude/skills/` oder einem `.claude/skills/` in einem `--add-dir`-Verzeichnis wird in der aktuellen Sitzung wirksam, ohne Claude Code neu zu starten. Das Erstellen eines Skill-Verzeichnisses auf oberster Ebene, das nicht vorhanden war, als die Sitzung gestartet wurde, erfordert einen Neustart von Claude Code, damit das neue Verzeichnis überwacht werden kann.146Claude Code überwacht Skill-Verzeichnisse auf Dateiänderungen. Das Hinzufügen, Bearbeiten oder Entfernen eines Skills unter `~/.claude/skills/`, dem Projekt `.claude/skills/` oder einem `.claude/skills/` in einem `--add-dir`-Verzeichnis wird in der aktuellen Sitzung wirksam, ohne Claude Code neu zu starten. Das Erstellen eines Skill-Verzeichnisses auf oberster Ebene, das nicht vorhanden war, als die Sitzung gestartet wurde, erfordert einen Neustart von Claude Code, damit das neue Verzeichnis überwacht werden kann.

147 147

148<Note>148<Note>

149 Die Live-Änderungserkennung umfasst nur `SKILL.md`-Text. Für einen Skill-Ordner, der auch ein [Plugin](/de/plugins-reference#skills-directory-plugins) ist, benötigen Änderungen an `hooks/`, `.mcp.json`, `agents/` und `output-styles/` `/reload-plugins`, um wirksam zu werden.149 Die Live-Änderungserkennung umfasst nur `SKILL.md`-Text. Für einen Skill-Ordner, der auch ein [Plugin](/docs/de/plugins-reference#skills-directory-plugins) ist, benötigen Änderungen an `hooks/`, `.mcp.json`, `agents/` und `output-styles/` `/reload-plugins`, um wirksam zu werden.

150</Note>150</Note>

151 151

152<h4 id="automatic-discovery-from-parent-and-nested-directories">152<h4 id="automatic-discovery-from-parent-and-nested-directories">

177 Skills aus zusätzlichen Verzeichnissen177 Skills aus zusätzlichen Verzeichnissen

178</h4>178</h4>

179 179

180Das Flag `--add-dir` und der Befehl `/add-dir` [gewähren Dateizugriff](/de/permissions#additional-directories-grant-file-access-not-configuration) statt Konfigurationserkennung, aber Skills sind eine Ausnahme: `.claude/skills/` in einem hinzugefügten Verzeichnis wird automatisch geladen. Diese Ausnahme gilt nur für `--add-dir` und `/add-dir`. Die Einstellung `permissions.additionalDirectories` in `settings.json` gewährt nur Dateizugriff und lädt keine Skills. Siehe [Live-Änderungserkennung](#live-change-detection) für die Aufnahme von Änderungen während einer Sitzung.180Das Flag `--add-dir` und der Befehl `/add-dir` [gewähren Dateizugriff](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) statt Konfigurationserkennung, aber Skills sind eine Ausnahme: `.claude/skills/` in einem hinzugefügten Verzeichnis wird automatisch geladen. Diese Ausnahme gilt nur für `--add-dir` und `/add-dir`. Die Einstellung `permissions.additionalDirectories` in `settings.json` gewährt nur Dateizugriff und lädt keine Skills. Siehe [Live-Änderungserkennung](#live-change-detection) für die Aufnahme von Änderungen während einer Sitzung.

181 181

182Andere `.claude/`-Konfigurationen wie Befehle und Ausgabestile werden nicht aus zusätzlichen Verzeichnissen geladen. Siehe die [Ausnahmetabelle](/de/permissions#additional-directories-grant-file-access-not-configuration) für die vollständige Liste dessen, was geladen wird und was nicht, sowie die empfohlenen Wege zum Teilen von Konfigurationen über Projekte hinweg.182Andere `.claude/`-Konfigurationen wie Befehle und Ausgabestile werden nicht aus zusätzlichen Verzeichnissen geladen. Siehe die [Ausnahmetabelle](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) für die vollständige Liste dessen, was geladen wird und was nicht, sowie die empfohlenen Wege zum Teilen von Konfigurationen über Projekte hinweg.

183 183

184<Note>184<Note>

185 CLAUDE.md-Dateien aus `--add-dir`-Verzeichnissen werden standardmäßig nicht geladen. Um sie zu laden, setzen Sie `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. Siehe [Aus zusätzlichen Verzeichnissen laden](/de/memory#load-from-additional-directories).185 CLAUDE.md-Dateien aus `--add-dir`-Verzeichnissen werden standardmäßig nicht geladen. Um sie zu laden, setzen Sie `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. Siehe [Aus zusätzlichen Verzeichnissen laden](/docs/de/memory#load-from-additional-directories).

186</Note>186</Note>

187 187

188<h2 id="configure-skills">188<h2 id="configure-skills">

229 229

230Ihre `SKILL.md` kann alles enthalten, aber das Nachdenken darüber, wie Sie den Skill aufrufen möchten (von Ihnen, von Claude oder von beiden) und wo Sie ihn ausführen möchten (inline oder in einem Subagent) hilft zu leiten, was Sie einbeziehen. Für komplexe Skills können Sie auch [unterstützende Dateien hinzufügen](#add-supporting-files), um den Hauptskill fokussiert zu halten.230Ihre `SKILL.md` kann alles enthalten, aber das Nachdenken darüber, wie Sie den Skill aufrufen möchten (von Ihnen, von Claude oder von beiden) und wo Sie ihn ausführen möchten (inline oder in einem Subagent) hilft zu leiten, was Sie einbeziehen. Für komplexe Skills können Sie auch [unterstützende Dateien hinzufügen](#add-supporting-files), um den Hauptskill fokussiert zu halten.

231 231

232Halten Sie den Text selbst prägnant. Sobald ein Skill geladen ist, bleibt sein Inhalt [über Züge hinweg im Kontext](#skill-content-lifecycle), sodass jede Zeile eine wiederkehrende Token-Kosten darstellt. Geben Sie an, was zu tun ist, anstatt zu erzählen, wie oder warum, und wenden Sie denselben Prägnanz-Test an, den Sie für [CLAUDE.md-Inhalt](/de/best-practices#write-an-effective-claude-md) verwenden würden.232Halten Sie den Text selbst prägnant. Sobald ein Skill geladen ist, bleibt sein Inhalt [über Züge hinweg im Kontext](#skill-content-lifecycle), sodass jede Zeile eine wiederkehrende Token-Kosten darstellt. Geben Sie an, was zu tun ist, anstatt zu erzählen, wie oder warum, und wenden Sie denselben Prägnanz-Test an, den Sie für [CLAUDE.md-Inhalt](/docs/de/best-practices#write-an-effective-claude-md) verwenden würden.

233 233

234<h3 id="frontmatter-reference">234<h3 id="frontmatter-reference">

235 Frontmatter-Referenz235 Frontmatter-Referenz

257| `when_to_use` | Nein | Zusätzlicher Kontext für den Zeitpunkt, zu dem Claude den Skill aufrufen sollte, z. B. Trigger-Phrasen oder Beispielanfragen. An `description` in der Skill-Auflistung angehängt und zählt zur 1.536-Zeichen-Obergrenze. |257| `when_to_use` | Nein | Zusätzlicher Kontext für den Zeitpunkt, zu dem Claude den Skill aufrufen sollte, z. B. Trigger-Phrasen oder Beispielanfragen. An `description` in der Skill-Auflistung angehängt und zählt zur 1.536-Zeichen-Obergrenze. |

258| `argument-hint` | Nein | Hinweis, der während der Autovervollständigung angezeigt wird, um erwartete Argumente anzuzeigen. Beispiel: `[issue-number]` oder `[filename] [format]`. |258| `argument-hint` | Nein | Hinweis, der während der Autovervollständigung angezeigt wird, um erwartete Argumente anzuzeigen. Beispiel: `[issue-number]` oder `[filename] [format]`. |

259| `arguments` | Nein | Benannte positionelle Argumente für [`$name`-Substitution](#available-string-substitutions) im Skill-Inhalt. Akzeptiert eine durch Leerzeichen getrennte Zeichenkette oder eine YAML-Liste. Namen werden in Reihenfolge auf Argumentpositionen abgebildet. |259| `arguments` | Nein | Benannte positionelle Argumente für [`$name`-Substitution](#available-string-substitutions) im Skill-Inhalt. Akzeptiert eine durch Leerzeichen getrennte Zeichenkette oder eine YAML-Liste. Namen werden in Reihenfolge auf Argumentpositionen abgebildet. |

260| `disable-model-invocation` | Nein | Setzen Sie auf `true`, um zu verhindern, dass Claude diesen Skill automatisch lädt. Verwenden Sie für Workflows, die Sie manuell mit `/name` auslösen möchten. Verhindert auch, dass der Skill [in Subagenten vorgeladen wird](/de/sub-agents#preload-skills-into-subagents). {/* min-version: 2.1.196 */}Ab v2.1.196 verhindert dies auch, dass der Skill ausgeführt wird, wenn eine [geplante Aufgabe](/de/scheduled-tasks) mit dem Skill als Eingabe ausgelöst wird. Standard: `false`. |260| `disable-model-invocation` | Nein | Setzen Sie auf `true`, um zu verhindern, dass Claude diesen Skill automatisch lädt. Verwenden Sie für Workflows, die Sie manuell mit `/name` auslösen möchten. Verhindert auch, dass der Skill [in Subagenten vorgeladen wird](/docs/de/sub-agents#preload-skills-into-subagents). Ab v2.1.196 verhindert dies auch, dass der Skill ausgeführt wird, wenn eine [geplante Aufgabe](/docs/de/scheduled-tasks) mit dem Skill als Eingabe ausgelöst wird. Standard: `false`. |

261| `user-invocable` | Nein | Setzen Sie auf `false`, um aus dem `/`-Menü auszublenden. Verwenden Sie für Hintergrundwissen, das Benutzer nicht direkt aufrufen sollten. Standard: `true`. |261| `user-invocable` | Nein | Setzen Sie auf `false`, um aus dem `/`-Menü auszublenden. Verwenden Sie für Hintergrundwissen, das Benutzer nicht direkt aufrufen sollten. Standard: `true`. |

262| `allowed-tools` | Nein | Tools, die Claude ohne Genehmigung verwenden kann, wenn dieser Skill aktiv ist. Akzeptiert eine durch Leerzeichen oder Komma getrennte Zeichenkette oder eine YAML-Liste. |262| `allowed-tools` | Nein | Tools, die Claude ohne Genehmigung verwenden kann, wenn dieser Skill aktiv ist. Akzeptiert eine durch Leerzeichen oder Komma getrennte Zeichenkette oder eine YAML-Liste. |

263| `disallowed-tools` | Nein | Tools, die aus Claudes verfügbarem Pool entfernt werden, während dieser Skill aktiv ist. Verwenden Sie für autonome Skills, die niemals bestimmte Tools aufrufen sollten, wie `AskUserQuestion` für eine Hintergrund-Schleife. Akzeptiert eine durch Leerzeichen oder Komma getrennte Zeichenkette oder eine YAML-Liste. Die Einschränkung wird gelöscht, wenn Sie Ihre nächste Nachricht senden. |263| `disallowed-tools` | Nein | Tools, die aus Claudes verfügbarem Pool entfernt werden, während dieser Skill aktiv ist. Verwenden Sie für autonome Skills, die niemals bestimmte Tools aufrufen sollten, wie `AskUserQuestion` für eine Hintergrund-Schleife. Akzeptiert eine durch Leerzeichen oder Komma getrennte Zeichenkette oder eine YAML-Liste. Die Einschränkung wird gelöscht, wenn Sie Ihre nächste Nachricht senden. |

264| `model` | Nein | Modell, das verwendet werden soll, wenn dieser Skill aktiv ist. Die Überschreibung gilt für den Rest des aktuellen Zuges und wird nicht in den Einstellungen gespeichert; das Sitzungsmodell wird bei Ihrer nächsten Eingabe fortgesetzt. Akzeptiert die gleichen Werte wie [`/model`](/de/model-config) oder `inherit`, um das aktive Modell beizubehalten. Ein Wert, der durch die [`availableModels`](/de/model-config#restrict-model-selection)-Zulassungsliste Ihrer Organisation ausgeschlossen ist, wird nicht verwendet und die Sitzung behält ihr aktuelles Modell. |264| `model` | Nein | Modell, das verwendet werden soll, wenn dieser Skill aktiv ist. Die Überschreibung gilt für den Rest des aktuellen Zuges und wird nicht in den Einstellungen gespeichert; das Sitzungsmodell wird bei Ihrer nächsten Eingabe fortgesetzt. Akzeptiert die gleichen Werte wie [`/model`](/docs/de/model-config) oder `inherit`, um das aktive Modell beizubehalten. Ein Wert, der durch die [`availableModels`](/docs/de/model-config#restrict-model-selection)-Zulassungsliste Ihrer Organisation ausgeschlossen ist, wird nicht verwendet und die Sitzung behält ihr aktuelles Modell. |

265| `effort` | Nein | [Anstrengungsstufe](/de/model-config#adjust-effort-level) wenn dieser Skill aktiv ist. Überschreibt die Anstrengungsstufe der Sitzung. Standard: erbt von Sitzung. Optionen: `low`, `medium`, `high`, `xhigh`, `max`; verfügbare Stufen hängen vom Modell ab. |265| `effort` | Nein | [Anstrengungsstufe](/docs/de/model-config#adjust-effort-level) wenn dieser Skill aktiv ist. Überschreibt die Anstrengungsstufe der Sitzung. Standard: erbt von Sitzung. Optionen: `low`, `medium`, `high`, `xhigh`, `max`; verfügbare Stufen hängen vom Modell ab. |

268| `hooks` | Nein | Hooks, die auf den Lebenszyklus dieses Skills beschränkt sind. Siehe [Hooks in Skills und Agenten](/de/hooks#hooks-in-skills-and-agents) für das Konfigurationsformat. |268| `hooks` | Nein | Hooks, die auf den Lebenszyklus dieses Skills beschränkt sind. Siehe [Hooks in Skills und Agenten](/docs/de/hooks#hooks-in-skills-and-agents) für das Konfigurationsformat. |

269| `paths` | Nein | Glob-Muster, die begrenzen, wann dieser Skill aktiviert wird. Akzeptiert eine kommagetrennte Zeichenkette oder eine YAML-Liste. Wenn gesetzt, lädt Claude den Skill automatisch nur, wenn mit Dateien arbeitet, die den Mustern entsprechen. Verwendet das gleiche Format wie [pfadspezifische Regeln](/de/memory#path-specific-rules). |269| `paths` | Nein | Glob-Muster, die begrenzen, wann dieser Skill aktiviert wird. Akzeptiert eine kommagetrennte Zeichenkette oder eine YAML-Liste. Wenn gesetzt, lädt Claude den Skill automatisch nur, wenn mit Dateien arbeitet, die den Mustern entsprechen. Verwendet das gleiche Format wie [pfadspezifische Regeln](/docs/de/memory#path-specific-rules). |

270| `shell` | Nein | Shell, die für `` !`command` `` und ` ```! ` Blöcke in diesem Skill verwendet werden soll. Akzeptiert `bash` (Standard) oder `powershell`. Das Setzen von `powershell` führt Inline-Shell-Befehle über PowerShell unter Windows aus. Erfordert `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. |270| `shell` | Nein | Shell, die für `` !`command` `` und ` ```! ` Blöcke in diesem Skill verwendet werden soll. Akzeptiert `bash` (Standard) oder `powershell`. Das Setzen von `powershell` führt Inline-Shell-Befehle über PowerShell unter Windows aus. Erfordert `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. |

271 271

272<h4 id="how-a-skill-gets-its-command-name">272<h4 id="how-a-skill-gets-its-command-name">

283| [Verschachteltes](#where-skills-live) `.claude/skills/`-Verzeichnis, wenn der Name mit einem anderen Skill kollidiert | Unterverzeichnispfad relativ zum Arbeitsverzeichnis, dann der Skill-Verzeichnisname | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |283| [Verschachteltes](#where-skills-live) `.claude/skills/`-Verzeichnis, wenn der Name mit einem anderen Skill kollidiert | Unterverzeichnispfad relativ zum Arbeitsverzeichnis, dann der Skill-Verzeichnisname | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |

286| Plugin-Root-`SKILL.md` | Frontmatter `name`, mit dem Plugin-Verzeichnisnamen als Fallback | `my-plugin/SKILL.md` mit `name: review` → `/my-plugin:review`. Siehe [Pfad-Verhaltensregeln](/de/plugins-reference#path-behavior-rules) |286| Plugin-Root-`SKILL.md` | Frontmatter `name`, mit dem Plugin-Verzeichnisnamen als Fallback | `my-plugin/SKILL.md` mit `name: review` → `/my-plugin:review`. Siehe [Pfad-Verhaltensregeln](/docs/de/plugins-reference#path-behavior-rules) |

287 287

288Der Plugin-Root-Fall ist der einzige Ort, an dem `name` den Befehlsnamen setzt, da es kein Skill-Verzeichnis gibt, das ihn übernehmen könnte. Wenn `name` nicht im Frontmatter gesetzt ist, wird stattdessen der Plugin-Verzeichnisname verwendet.288Der Plugin-Root-Fall ist der einzige Ort, an dem `name` den Befehlsnamen setzt, da es kein Skill-Verzeichnis gibt, das ihn übernehmen könnte. Wenn `name` nicht im Frontmatter gesetzt ist, wird stattdessen der Plugin-Verzeichnisname verwendet.

289 289

302| `${CLAUDE_SESSION_ID}` | Die aktuelle Sitzungs-ID. Nützlich zum Protokollieren, Erstellen sitzungsspezifischer Dateien oder Korrelieren der Skill-Ausgabe mit Sitzungen. |302| `${CLAUDE_SESSION_ID}` | Die aktuelle Sitzungs-ID. Nützlich zum Protokollieren, Erstellen sitzungsspezifischer Dateien oder Korrelieren der Skill-Ausgabe mit Sitzungen. |

303| `${CLAUDE_EFFORT}` | Die aktuelle Anstrengungsstufe: `low`, `medium`, `high`, `xhigh` oder `max`. Ultracode ist keine separate Stufe und wird als `xhigh` gemeldet. Verwenden Sie dies, um Skill-Anweisungen an die aktive Anstrengungseinstellung anzupassen. |303| `${CLAUDE_EFFORT}` | Die aktuelle Anstrengungsstufe: `low`, `medium`, `high`, `xhigh` oder `max`. Ultracode ist keine separate Stufe und wird als `xhigh` gemeldet. Verwenden Sie dies, um Skill-Anweisungen an die aktive Anstrengungseinstellung anzupassen. |

304| `${CLAUDE_SKILL_DIR}` | Das Verzeichnis, das die `SKILL.md`-Datei des Skills enthält. Für Plugin-Skills ist dies das Skill-Unterverzeichnis im Plugin, nicht das Plugin-Root. Verwenden Sie dies in Bash-Injektionsbefehlen, um auf Scripts oder Dateien zu verweisen, die mit dem Skill gebündelt sind, unabhängig vom aktuellen Arbeitsverzeichnis. |304| `${CLAUDE_SKILL_DIR}` | Das Verzeichnis, das die `SKILL.md`-Datei des Skills enthält. Für Plugin-Skills ist dies das Skill-Unterverzeichnis im Plugin, nicht das Plugin-Root. Verwenden Sie dies in Bash-Injektionsbefehlen, um auf Scripts oder Dateien zu verweisen, die mit dem Skill gebündelt sind, unabhängig vom aktuellen Arbeitsverzeichnis. |

305| `${CLAUDE_PROJECT_DIR}` | Das Projekt-Root-Verzeichnis. Dies ist der gleiche Pfad, den [Hooks](/de/hooks#reference-scripts-by-path) und MCP-Server als `CLAUDE_PROJECT_DIR` erhalten. Verwenden Sie dies, um auf projektlokale Scripts oder Dateien zu verweisen, wie `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, unabhängig davon, wo der Skill installiert ist. |305| `${CLAUDE_PROJECT_DIR}` | Das Projekt-Root-Verzeichnis. Dies ist der gleiche Pfad, den [Hooks](/docs/de/hooks#reference-scripts-by-path) und MCP-Server als `CLAUDE_PROJECT_DIR` erhalten. Verwenden Sie dies, um auf projektlokale Scripts oder Dateien zu verweisen, wie `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, unabhängig davon, wo der Skill installiert ist. |

306 306

307Die `${CLAUDE_PROJECT_DIR}`-Substitution erfordert Claude Code v2.1.196 oder später. Sie gilt sowohl für den Skill-Text als auch für das [`allowed-tools`](#frontmatter-reference)-Frontmatter, sodass eine Berechtigungsregel wie `Bash(${CLAUDE_PROJECT_DIR}/scripts/lint.sh *)` zum gleichen Pfad aufgelöst wird, den der Skill-Text verwendet.307Die `${CLAUDE_PROJECT_DIR}`-Substitution erfordert Claude Code v2.1.196 oder später. Sie gilt sowohl für den Skill-Text als auch für das [`allowed-tools`](#frontmatter-reference)-Frontmatter, sodass eine Berechtigungsregel wie `Bash(${CLAUDE_PROJECT_DIR}/scripts/lint.sh *)` zum gleichen Pfad aufgelöst wird, den der Skill-Text verwendet.

308 308

386 386

387<Note>387<Note>

388 In einer regulären Sitzung werden Skill-Beschreibungen in den Kontext geladen, damit Claude weiß, was verfügbar ist, aber vollständiger Skill-Inhalt wird nur beim Aufrufen geladen. [Subagenten mit vorgeladenen Skills](/de/sub-agents#preload-skills-into-subagents) funktionieren anders: Der vollständige Skill-Inhalt wird beim Start eingespritzt.388 In einer regulären Sitzung werden Skill-Beschreibungen in den Kontext geladen, damit Claude weiß, was verfügbar ist, aber vollständiger Skill-Inhalt wird nur beim Aufrufen geladen. [Subagenten mit vorgeladenen Skills](/docs/de/sub-agents#preload-skills-into-subagents) funktionieren anders: Der vollständige Skill-Inhalt wird beim Start eingespritzt.

389</Note>389</Note>

390 390

391<h3 id="skill-content-lifecycle">391<h3 id="skill-content-lifecycle">

396 396

397Wenn Claude einen Skill erneut aufruft, dessen gerenderter Inhalt identisch mit der bereits im Kontext vorhandenen Kopie ist, fügt Claude Code eine kurze Notiz hinzu, dass der Skill bereits geladen ist, anstatt eine zweite Kopie des Inhalts zu erstellen. Wenn sich der gerenderte Inhalt unterscheidet, weil sich die Argumente geändert haben oder ein [dynamischer Kontext](#inject-dynamic-context)-Befehl neue Ausgabe erzeugt hat, hängt Claude Code den vollständigen Inhalt erneut an. Vor v2.1.202 hängte jeder erneute Aufruf eine weitere vollständige Kopie der Skill-Anweisungen an.397Wenn Claude einen Skill erneut aufruft, dessen gerenderter Inhalt identisch mit der bereits im Kontext vorhandenen Kopie ist, fügt Claude Code eine kurze Notiz hinzu, dass der Skill bereits geladen ist, anstatt eine zweite Kopie des Inhalts zu erstellen. Wenn sich der gerenderte Inhalt unterscheidet, weil sich die Argumente geändert haben oder ein [dynamischer Kontext](#inject-dynamic-context)-Befehl neue Ausgabe erzeugt hat, hängt Claude Code den vollständigen Inhalt erneut an. Vor v2.1.202 hängte jeder erneute Aufruf eine weitere vollständige Kopie der Skill-Anweisungen an.

398 398

399[Auto-Komprimierung](/de/how-claude-code-works#when-context-fills-up) trägt aufgerufene Skills innerhalb eines Token-Budgets weiter. Wenn das Gespräch zusammengefasst wird, um Kontext freizugeben, hängt Claude Code die neueste Aufrufe jedes Skills nach der Zusammenfassung wieder an und behält die ersten 5.000 Token jedes Skills. Wieder angehängte Skills teilen sich ein kombiniertes Budget von 25.000 Token. Claude Code füllt dieses Budget ab dem zuletzt aufgerufenen Skill, sodass ältere Skills vollständig gelöscht werden können, wenn Sie viele in einer Sitzung aufgerufen haben.399[Auto-Komprimierung](/docs/de/how-claude-code-works#when-context-fills-up) trägt aufgerufene Skills innerhalb eines Token-Budgets weiter. Wenn das Gespräch zusammengefasst wird, um Kontext freizugeben, hängt Claude Code die neueste Aufrufe jedes Skills nach der Zusammenfassung wieder an und behält die ersten 5.000 Token jedes Skills. Wieder angehängte Skills teilen sich ein kombiniertes Budget von 25.000 Token. Claude Code füllt dieses Budget ab dem zuletzt aufgerufenen Skill, sodass ältere Skills vollständig gelöscht werden können, wenn Sie viele in einer Sitzung aufgerufen haben.

400 400

401Wenn ein Skill das Verhalten nach der ersten Antwort nicht mehr zu beeinflussen scheint, ist der Inhalt normalerweise immer noch vorhanden und das Modell wählt andere Tools oder Ansätze. Stärken Sie die `description` und Anweisungen des Skills, damit das Modell es weiterhin bevorzugt, oder verwenden Sie [Hooks](/de/hooks), um Verhalten deterministisch zu erzwingen. Wenn der Skill groß ist oder Sie mehrere andere danach aufgerufen haben, rufen Sie ihn nach der Komprimierung erneut auf, um den vollständigen Inhalt wiederherzustellen.401Wenn ein Skill das Verhalten nach der ersten Antwort nicht mehr zu beeinflussen scheint, ist der Inhalt normalerweise immer noch vorhanden und das Modell wählt andere Tools oder Ansätze. Stärken Sie die `description` und Anweisungen des Skills, damit das Modell es weiterhin bevorzugt, oder verwenden Sie [Hooks](/docs/de/hooks), um Verhalten deterministisch zu erzwingen. Wenn der Skill groß ist oder Sie mehrere andere danach aufgerufen haben, rufen Sie ihn nach der Komprimierung erneut auf, um den vollständigen Inhalt wiederherzustellen.

402 402

403<h3 id="pre-approve-tools-for-a-skill">403<h3 id="pre-approve-tools-for-a-skill">

404 Tools für einen Skill vorab genehmigen404 Tools für einen Skill vorab genehmigen

405</h3>405</h3>

406 406

407Das `allowed-tools`-Feld gewährt Berechtigung für die aufgelisteten Tools, während der Skill aktiv ist, sodass Claude sie verwenden kann, ohne Sie um Genehmigung zu bitten. Es schränkt nicht ein, welche Tools verfügbar sind: Jedes Tool bleibt aufrufbar, und Ihre [Berechtigungseinstellungen](/de/permissions) regeln weiterhin Tools, die nicht aufgelistet sind.407Das `allowed-tools`-Feld gewährt Berechtigung für die aufgelisteten Tools, während der Skill aktiv ist, sodass Claude sie verwenden kann, ohne Sie um Genehmigung zu bitten. Es schränkt nicht ein, welche Tools verfügbar sind: Jedes Tool bleibt aufrufbar, und Ihre [Berechtigungseinstellungen](/docs/de/permissions) regeln weiterhin Tools, die nicht aufgelistet sind.

408 408

409Für Skills, die in das Verzeichnis `.claude/skills/` eines Projekts eingecheckt werden, tritt `allowed-tools` in Kraft, nachdem Sie den Workspace-Trust-Dialog für diesen Ordner akzeptiert haben, genauso wie Berechtigungsregeln in `.claude/settings.json`. Überprüfen Sie Projekt-Skills vor dem Vertrauen in ein Repository, da ein Skill sich selbst breiten Tool-Zugriff gewähren kann.409Für Skills, die in das Verzeichnis `.claude/skills/` eines Projekts eingecheckt werden, tritt `allowed-tools` in Kraft, nachdem Sie den Workspace-Trust-Dialog für diesen Ordner akzeptiert haben, genauso wie Berechtigungsregeln in `.claude/settings.json`. Überprüfen Sie Projekt-Skills vor dem Vertrauen in ein Repository, da ein Skill sich selbst breiten Tool-Zugriff gewähren kann.

410 410

419---419---

420```420```

421 421

422Um Tools aus Claudes verfügbarem Pool zu entfernen, während ein Skill aktiv ist, listen Sie sie in `disallowed-tools` im Frontmatter des Skills auf. Die Einschränkung wird gelöscht, wenn Sie Ihre nächste Nachricht senden. Um Tools über alle Skills und Eingaben hinweg zu blockieren, fügen Sie Ablehnungsregeln in Ihren [Berechtigungseinstellungen](/de/permissions) hinzu.422Um Tools aus Claudes verfügbarem Pool zu entfernen, während ein Skill aktiv ist, listen Sie sie in `disallowed-tools` im Frontmatter des Skills auf. Die Einschränkung wird gelöscht, wenn Sie Ihre nächste Nachricht senden. Um Tools über alle Skills und Eingaben hinweg zu blockieren, fügen Sie Ablehnungsregeln in Ihren [Berechtigungseinstellungen](/docs/de/permissions) hinzu.

423 423

424<h3 id="pass-arguments-to-skills">424<h3 id="pass-arguments-to-skills">

425 Argumente an Skills übergeben425 Argumente an Skills übergeben

449 449

450Wenn Sie einen Skill mit Argumenten aufrufen, aber der Skill `$ARGUMENTS` nicht enthält, hängt Claude Code `ARGUMENTS: <your input>` am Ende des Skill-Inhalts an, damit Claude immer noch sieht, was Sie eingegeben haben.450Wenn Sie einen Skill mit Argumenten aufrufen, aber der Skill `$ARGUMENTS` nicht enthält, hängt Claude Code `ARGUMENTS: <your input>` am Ende des Skill-Inhalts an, damit Claude immer noch sieht, was Sie eingegeben haben.

451 451

452Sie können auch mehrere Skills am Anfang einer Nachricht stapeln. {/* min-version: 2.1.199 */}Ab v2.1.199 lädt das Eingeben von `/code-review /fix-issue 123` beide Skills und übergibt den nachfolgenden Text `123` als `$ARGUMENTS` an jeden von ihnen. In früheren Versionen wurde nur der erste Skill geladen und erhielt `/fix-issue 123` als wörtlichen Argumenttext.452Sie können auch mehrere Skills am Anfang einer Nachricht stapeln. Ab v2.1.199 lädt das Eingeben von `/code-review /fix-issue 123` beide Skills und übergibt den nachfolgenden Text `123` als `$ARGUMENTS` an jeden von ihnen. In früheren Versionen wurde nur der erste Skill geladen und erhielt `/fix-issue 123` als wörtlichen Argumenttext.

453 453

454Claude Code erweitert den ersten Skill plus bis zu fünf weitere, die danach gestapelt sind. Die Erweiterung stoppt beim ersten Token, das kein Inline-Benutzer-aufgerufener Skill ist, daher endet auch ein Skill, der als [verzweigter Subagent](#run-skills-in-a-subagent) ausgeführt wird, oder einer, dessen Argumente selbst mit einem Schrägstrich-Befehl beginnen können, wie `/loop`, auch dort; dieses Token und alles danach werden zum Argumenttext für jeden erweiterten Skill.454Claude Code erweitert den ersten Skill plus bis zu fünf weitere, die danach gestapelt sind. Die Erweiterung stoppt beim ersten Token, das kein Inline-Benutzer-aufgerufener Skill ist, daher endet auch ein Skill, der als [verzweigter Subagent](#run-skills-in-a-subagent) ausgeführt wird, oder einer, dessen Argumente selbst mit einem Schrägstrich-Befehl beginnen können, wie `/loop`, auch dort; dieses Token und alles danach werden zum Argumenttext für jeden erweiterten Skill.

455 455

530```530```

531````531````

532 532

533Um dieses Verhalten für Skills und benutzerdefinierte Befehle aus Benutzer-, Projekt-, Plugin- oder [zusätzlichen Verzeichnis](#skills-from-additional-directories)-Quellen zu deaktivieren, setzen Sie `"disableSkillShellExecution": true` in [Einstellungen](/de/settings). Jeder Befehl wird stattdessen durch `[shell command execution disabled by policy]` ersetzt. Gebündelte und verwaltete Skills sind nicht betroffen. Diese Einstellung ist am nützlichsten in [verwalteten Einstellungen](/de/permissions#managed-settings), wo Benutzer sie nicht überschreiben können.533Um dieses Verhalten für Skills und benutzerdefinierte Befehle aus Benutzer-, Projekt-, Plugin- oder [zusätzlichen Verzeichnis](#skills-from-additional-directories)-Quellen zu deaktivieren, setzen Sie `"disableSkillShellExecution": true` in [Einstellungen](/docs/de/settings). Jeder Befehl wird stattdessen durch `[shell command execution disabled by policy]` ersetzt. Gebündelte und verwaltete Skills sind nicht betroffen. Diese Einstellung ist am nützlichsten in [verwalteten Einstellungen](/docs/de/permissions#managed-settings), wo Benutzer sie nicht überschreiben können.

534 534

535<Tip>535<Tip>

536 Um tiefere Überlegungen zu anfordern, wenn ein Skill ausgeführt wird, fügen Sie `ultrathink` irgendwo im Skill-Inhalt ein. Siehe [Verwenden Sie ultrathink für einmalige tiefe Überlegungen](/de/model-config#use-ultrathink-for-one-off-deep-reasoning).536 Um tiefere Überlegungen zu anfordern, wenn ein Skill ausgeführt wird, fügen Sie `ultrathink` irgendwo im Skill-Inhalt ein. Siehe [Verwenden Sie ultrathink für einmalige tiefe Überlegungen](/docs/de/model-config#use-ultrathink-for-one-off-deep-reasoning).

537</Tip>537</Tip>

538 538

539<h3 id="run-skills-in-a-subagent">539<h3 id="run-skills-in-a-subagent">

546 `context: fork` macht nur Sinn für Skills mit expliziten Anweisungen. Wenn Ihr Skill Richtlinien wie „verwenden Sie diese API-Konventionen" ohne eine Aufgabe enthält, erhält der Subagent die Richtlinien, aber keinen umsetzbaren Prompt, und gibt ohne aussagekräftige Ausgabe zurück.546 `context: fork` macht nur Sinn für Skills mit expliziten Anweisungen. Wenn Ihr Skill Richtlinien wie „verwenden Sie diese API-Konventionen" ohne eine Aufgabe enthält, erhält der Subagent die Richtlinien, aber keinen umsetzbaren Prompt, und gibt ohne aussagekräftige Ausgabe zurück.

547</Warning>547</Warning>

548 548

549Skills und [Subagenten](/de/sub-agents) funktionieren in zwei Richtungen zusammen:549Skills und [Subagenten](/docs/de/sub-agents) funktionieren in zwei Richtungen zusammen:

550 550

552| :------------------------- | :--------------------- | :--------------------------- | :---------------------------------------------------- |552| :------------------------- | :--------------------- | :--------------------------- | :---------------------------------------------------- |

555 555

556Mit `context: fork` schreiben Sie die Aufgabe in Ihren Skill und wählen einen Agent-Typ aus, um sie auszuführen. Die integrierten Explore- und Plan-Agenten [überspringen CLAUDE.md und Git-Status](/de/sub-agents#what-loads-at-startup), um ihren Kontext klein zu halten, sodass ein verzweigter Skill mit `agent: Explore` nur den SKILL.md-Inhalt und den eigenen System-Prompt des Agenten sieht. Für das Inverse, bei dem Sie einen benutzerdefinierten Subagenten definieren, der Skills als Referenzmaterial verwendet, siehe [Subagenten](/de/sub-agents#preload-skills-into-subagents).556Mit `context: fork` schreiben Sie die Aufgabe in Ihren Skill und wählen einen Agent-Typ aus, um sie auszuführen. Die integrierten Explore- und Plan-Agenten [überspringen CLAUDE.md und Git-Status](/docs/de/sub-agents#what-loads-at-startup), um ihren Kontext klein zu halten, sodass ein verzweigter Skill mit `agent: Explore` nur den SKILL.md-Inhalt und den eigenen System-Prompt des Agenten sieht. Für das Inverse, bei dem Sie einen benutzerdefinierten Subagenten definieren, der Skills als Referenzmaterial verwendet, siehe [Subagenten](/docs/de/sub-agents#preload-skills-into-subagents).

557 557

558<h4 id="example-research-skill-using-explore-agent">558<h4 id="example-research-skill-using-explore-agent">

559 Beispiel: Research-Skill mit Explore-Agent559 Beispiel: Research-Skill mit Explore-Agent

589 Beschränken Sie Claudes Skill-Zugriff589 Beschränken Sie Claudes Skill-Zugriff

590</h3>590</h3>

591 591

592Standardmäßig kann Claude jeden Skill aufrufen, der nicht `disable-model-invocation: true` gesetzt hat. Skills, die `allowed-tools` definieren, gewähren Claude Zugriff auf diese Tools ohne Genehmigung pro Verwendung, wenn der Skill aktiv ist. Ihre [Berechtigungseinstellungen](/de/permissions) regeln weiterhin das Baseline-Genehmigungsverhalten für alle anderen Tools. Einige integrierte Befehle sind auch über das Skill-Tool verfügbar, einschließlich `/init`, `/review` und `/security-review`. Andere integrierte Befehle wie `/compact` sind nicht verfügbar.592Standardmäßig kann Claude jeden Skill aufrufen, der nicht `disable-model-invocation: true` gesetzt hat. Skills, die `allowed-tools` definieren, gewähren Claude Zugriff auf diese Tools ohne Genehmigung pro Verwendung, wenn der Skill aktiv ist. Ihre [Berechtigungseinstellungen](/docs/de/permissions) regeln weiterhin das Baseline-Genehmigungsverhalten für alle anderen Tools. Einige integrierte Befehle sind auch über das Skill-Tool verfügbar, einschließlich `/init`, `/review` und `/security-review`. Andere integrierte Befehle wie `/compact` sind nicht verfügbar.

593 593

594Drei Möglichkeiten, um zu steuern, welche Skills Claude aufrufen kann:594Drei Möglichkeiten, um zu steuern, welche Skills Claude aufrufen kann:

595 595

600Skill600Skill

601```601```

602 602

603**Erlauben oder verweigern Sie bestimmte Skills** mit [Berechtigungsregeln](/de/permissions):603**Erlauben oder verweigern Sie bestimmte Skills** mit [Berechtigungsregeln](/docs/de/permissions):

604 604

605```text theme={null}605```text theme={null}

606# Allow only specific skills606# Allow only specific skills

623 Skill-Sichtbarkeit aus Einstellungen überschreiben623 Skill-Sichtbarkeit aus Einstellungen überschreiben

624</h3>624</h3>

625 625

626Die `skillOverrides`-Einstellung steuert die Skill-Sichtbarkeit aus Ihren [Einstellungen](/de/settings) statt aus dem Frontmatter des Skills selbst. Verwenden Sie sie für Skills, deren SKILL.md Sie nicht bearbeiten möchten, z. B. solche, die in ein gemeinsames Projekt-Repository eingecheckt sind oder von einem MCP-Server bereitgestellt werden. Das `/skills`-Menü schreibt es für Sie: Markieren Sie einen Skill und drücken Sie `Space`, um die Zustände zu durchlaufen, dann `Enter`, um in `.claude/settings.local.json` zu speichern.626Die `skillOverrides`-Einstellung steuert die Skill-Sichtbarkeit aus Ihren [Einstellungen](/docs/de/settings) statt aus dem Frontmatter des Skills selbst. Verwenden Sie sie für Skills, deren SKILL.md Sie nicht bearbeiten möchten, z. B. solche, die in ein gemeinsames Projekt-Repository eingecheckt sind oder von einem MCP-Server bereitgestellt werden. Das `/skills`-Menü schreibt es für Sie: Markieren Sie einen Skill und drücken Sie `Space`, um die Zustände zu durchlaufen, dann `Enter`, um in `.claude/settings.local.json` zu speichern.

627 627

628Jeder Schlüssel ist ein Skill-Name und jeder Wert ist einer von vier Zuständen:628Jeder Schlüssel ist ein Skill-Name und jeder Wert ist einer von vier Zuständen:

629 629

634| `"user-invocable-only"` | Versteckt | Ja |634| `"user-invocable-only"` | Versteckt | Ja |

635| `"off"` | Versteckt | Versteckt |635| `"off"` | Versteckt | Versteckt |

636 636

637Ab v2.1.199 versteckt `"off"` den Skill auch vor den Befehlslisten, die an [Remote Control](/de/remote-control)-Clients und an [Agent SDK](/de/agent-sdk/slash-commands)-Aufrufer angekündigt werden, nicht nur das Terminal-Menü `/`. Das Aufrufen eines versteckten Skills nach seinem vollständigen Namen gibt stattdessen den `skillOverrides`-Fehler zurück, anstatt ihn auszuführen.637Ab v2.1.199 versteckt `"off"` den Skill auch vor den Befehlslisten, die an [Remote Control](/docs/de/remote-control)-Clients und an [Agent SDK](/docs/de/agent-sdk/slash-commands)-Aufrufer angekündigt werden, nicht nur das Terminal-Menü `/`. Das Aufrufen eines versteckten Skills nach seinem vollständigen Namen gibt stattdessen den `skillOverrides`-Fehler zurück, anstatt ihn auszuführen.

638 638

639Ein Skill, der in `skillOverrides` fehlt, wird als `"on"` behandelt. Das folgende Beispiel reduziert einen Skill auf seinen Namen und deaktiviert einen anderen vollständig:639Ein Skill, der in `skillOverrides` fehlt, wird als `"on"` behandelt. Das folgende Beispiel reduziert einen Skill auf seinen Namen und deaktiviert einen anderen vollständig:

640 640

672Nach der Installation führen Sie `/reload-plugins` aus, um die Skills des Plugins in der aktuellen Sitzung verfügbar zu machen. Bitten Sie dann Claude, einen vorhandenen Skill zu evaluieren, zum Beispiel `evaluate my summarize-changes skill with skill-creator`. Das Plugin führt Sie durch das Schreiben von Testfällen und führt die Schleife aus:672Nach der Installation führen Sie `/reload-plugins` aus, um die Skills des Plugins in der aktuellen Sitzung verfügbar zu machen. Bitten Sie dann Claude, einen vorhandenen Skill zu evaluieren, zum Beispiel `evaluate my summarize-changes skill with skill-creator`. Das Plugin führt Sie durch das Schreiben von Testfällen und führt die Schleife aus:

673 673

674* **Testfälle**: speichert Eingaben, Eingabedateien und erwartetes Verhalten in `evals/evals.json` im Skill-Verzeichnis674* **Testfälle**: speichert Eingaben, Eingabedateien und erwartetes Verhalten in `evals/evals.json` im Skill-Verzeichnis

675* **Isolierte Läufe**: spawnt einen [Subagent](/de/sub-agents) pro Testfall, sodass jeder Lauf mit einem sauberen Kontext beginnt, und zeichnet Token-Anzahl und Dauer auf675* **Isolierte Läufe**: spawnt einen [Subagent](/docs/de/sub-agents) pro Testfall, sodass jeder Lauf mit einem sauberen Kontext beginnt, und zeichnet Token-Anzahl und Dauer auf

676* **Bewertung**: überprüft jede Assertion gegen die Ausgabe und schreibt Pass oder Fail mit Beweis in `grading.json`676* **Bewertung**: überprüft jede Assertion gegen die Ausgabe und schreibt Pass oder Fail mit Beweis in `grading.json`

677* **Benchmark**: aggregiert Pass-Rate, Zeit und Token für mit-Skill versus ohne-Skill in `benchmark.json`, sodass Sie die Pass-Rate-Verbesserung gegen den Token- und Zeit-Overhead vergleichen können677* **Benchmark**: aggregiert Pass-Rate, Zeit und Token für mit-Skill versus ohne-Skill in `benchmark.json`, sodass Sie die Pass-Rate-Verbesserung gegen den Token- und Zeit-Overhead vergleichen können

678* **Versionsvergleich**: führt einen blinden A/B zwischen zwei Versionen des Skills durch, sodass Sie bestätigen können, dass eine Bearbeitung eine Verbesserung ist, bevor Sie sie committen678* **Versionsvergleich**: führt einen blinden A/B zwischen zwei Versionen des Skills durch, sodass Sie bestätigen können, dass eine Bearbeitung eine Verbesserung ist, bevor Sie sie committen

688Skills können je nach Ihrer Zielgruppe in verschiedenen Bereichen verteilt werden:688Skills können je nach Ihrer Zielgruppe in verschiedenen Bereichen verteilt werden:

689 689

690* **Projekt-Skills**: Committen Sie `.claude/skills/` zur Versionskontrolle690* **Projekt-Skills**: Committen Sie `.claude/skills/` zur Versionskontrolle

691* **Plugins**: Erstellen Sie ein `skills/`-Verzeichnis in Ihrem [Plugin](/de/plugins)691* **Plugins**: Erstellen Sie ein `skills/`-Verzeichnis in Ihrem [Plugin](/docs/de/plugins)

692* **Verwaltet**: Stellen Sie organisationsweit über [verwaltete Einstellungen](/de/settings#settings-files) bereit692* **Verwaltet**: Stellen Sie organisationsweit über [verwaltete Einstellungen](/docs/de/settings#settings-files) bereit

693 693

694<h3 id="generate-visual-output">694<h3 id="generate-visual-output">

695 Visuelle Ausgabe generieren695 Visuelle Ausgabe generieren

916 916

917Claude Code lädt eine Auflistung von Skill-Namen und Beschreibungen in den Kontext, damit Claude weiß, was verfügbar ist. Die Auflistung enthält immer jeden Skill-Namen, aber wenn Sie viele Skills haben, kürzt Claude Code Beschreibungen, um in das Zeichenbudget der Auflistung zu passen, was die Schlüsselwörter entfernen kann, die Claude benötigt, um Ihre Anfrage zu erfüllen. Das Budget skaliert bei 1% des Kontextfensters des Modells. Wenn die Auflistung überläuft, löscht Claude Code Beschreibungen beginnend mit den Skills, die Sie am wenigsten aufrufen, sodass die Skills, die Sie am meisten verwenden, ihren vollständigen Text behalten.917Claude Code lädt eine Auflistung von Skill-Namen und Beschreibungen in den Kontext, damit Claude weiß, was verfügbar ist. Die Auflistung enthält immer jeden Skill-Namen, aber wenn Sie viele Skills haben, kürzt Claude Code Beschreibungen, um in das Zeichenbudget der Auflistung zu passen, was die Schlüsselwörter entfernen kann, die Claude benötigt, um Ihre Anfrage zu erfüllen. Das Budget skaliert bei 1% des Kontextfensters des Modells. Wenn die Auflistung überläuft, löscht Claude Code Beschreibungen beginnend mit den Skills, die Sie am wenigsten aufrufen, sodass die Skills, die Sie am meisten verwenden, ihren vollständigen Text behalten.

918 918

919Führen Sie `/doctor` aus, um eine Schätzung der Kontextkosten der Auflistung und ihrer größten Beitragenden zu erhalten. Wenn die Auflistung ihr Budget überschreitet, schreibt Claude Code auch eine Warnung in das Debug-Protokoll, sichtbar mit [`--debug`](/de/cli-reference#cli-flags).919Führen Sie `/doctor` aus, um eine Schätzung der Kontextkosten der Auflistung und ihrer größten Beitragenden zu erhalten. Wenn die Auflistung ihr Budget überschreitet, schreibt Claude Code auch eine Warnung in das Debug-Protokoll, sichtbar mit [`--debug`](/docs/de/cli-reference#cli-flags).

920 920

921Die Skills-Zeile in `/context` meldet die Größe der Auflistung nach Anwendung des Budgets, sodass sie dem entspricht, was das Modell erhält. Vor v2.1.196 zählte die Zeile den vollständigen Text jeder Beschreibung und konnte einen Wert anzeigen, der mehrmals größer als das konfigurierte Budget ist.921Die Skills-Zeile in `/context` meldet die Größe der Auflistung nach Anwendung des Budgets, sodass sie dem entspricht, was das Modell erhält. Vor v2.1.196 zählte die Zeile den vollständigen Text jeder Beschreibung und konnte einen Wert anzeigen, der mehrmals größer als das konfigurierte Budget ist.

922 922

923Um das Budget zu erhöhen, setzen Sie die Einstellung [`skillListingBudgetFraction`](/de/settings#available-settings) (z. B. `0.02` = 2%) oder die Umgebungsvariable `SLASH_COMMAND_TOOL_CHAR_BUDGET` auf eine feste Zeichenanzahl. Um Budget für andere Skills freizugeben, setzen Sie Einträge mit niedriger Priorität auf `"name-only"` in [`skillOverrides`](#override-skill-visibility-from-settings), damit sie ohne Beschreibung aufgelistet werden. Sie können auch den Text `description` und `when_to_use` an der Quelle kürzen: Stellen Sie den wichtigsten Anwendungsfall an den Anfang, da der kombinierte Text jedes Eintrags unabhängig vom Budget auf 1.536 Zeichen begrenzt ist. Die Obergrenze ist mit [`skillListingMaxDescChars`](/de/settings#available-settings) konfigurierbar.923Um das Budget zu erhöhen, setzen Sie die Einstellung [`skillListingBudgetFraction`](/docs/de/settings#available-settings) (z. B. `0.02` = 2%) oder die Umgebungsvariable `SLASH_COMMAND_TOOL_CHAR_BUDGET` auf eine feste Zeichenanzahl. Um Budget für andere Skills freizugeben, setzen Sie Einträge mit niedriger Priorität auf `"name-only"` in [`skillOverrides`](#override-skill-visibility-from-settings), damit sie ohne Beschreibung aufgelistet werden. Sie können auch den Text `description` und `when_to_use` an der Quelle kürzen: Stellen Sie den wichtigsten Anwendungsfall an den Anfang, da der kombinierte Text jedes Eintrags unabhängig vom Budget auf 1.536 Zeichen begrenzt ist. Die Obergrenze ist mit [`skillListingMaxDescChars`](/docs/de/settings#available-settings) konfigurierbar.

924 924

925<h2 id="related-resources">925<h2 id="related-resources">

926 Verwandte Ressourcen926 Verwandte Ressourcen

927</h2>927</h2>

928 928

929* **[Debuggen Sie Ihre Konfiguration](/de/debug-your-config)**: Diagnostizieren Sie, warum ein Skill nicht angezeigt oder ausgelöst wird929* **[Debuggen Sie Ihre Konfiguration](/docs/de/debug-your-config)**: Diagnostizieren Sie, warum ein Skill nicht angezeigt oder ausgelöst wird

930* **[Evaluating skill output quality](https://agentskills.io/skill-creation/evaluating-skills)**: das Eval-Dateiformat und Iterations-Workflow auf agentskills.io930* **[Evaluating skill output quality](https://agentskills.io/skill-creation/evaluating-skills)**: das Eval-Dateiformat und Iterations-Workflow auf agentskills.io

931* **[Skill authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**: Schreibanleitung, die über Claude-Produkte hinweg gilt931* **[Skill authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**: Schreibanleitung, die über Claude-Produkte hinweg gilt

932* **[Subagenten](/de/sub-agents)**: Delegieren Sie Aufgaben an spezialisierte Agenten932* **[Subagenten](/docs/de/sub-agents)**: Delegieren Sie Aufgaben an spezialisierte Agenten

933* **[Plugins](/de/plugins)**: Packen und verteilen Sie Skills mit anderen Erweiterungen933* **[Plugins](/docs/de/plugins)**: Packen und verteilen Sie Skills mit anderen Erweiterungen

934* **[Hooks](/de/hooks)**: Automatisieren Sie Workflows um Tool-Ereignisse934* **[Hooks](/docs/de/hooks)**: Automatisieren Sie Workflows um Tool-Ereignisse

935* **[Memory](/de/memory)**: Verwalten Sie CLAUDE.md-Dateien für persistenten Kontext935* **[Memory](/docs/de/memory)**: Verwalten Sie CLAUDE.md-Dateien für persistenten Kontext

936* **[Befehle](/de/commands)**: Referenz für integrierte Befehle und gebündelte Skills936* **[Befehle](/docs/de/commands)**: Referenz für integrierte Befehle und gebündelte Skills

937* **[Berechtigungen](/de/permissions)**: Steuern Sie Tool- und Skill-Zugriff937* **[Berechtigungen](/docs/de/permissions)**: Steuern Sie Tool- und Skill-Zugriff

938* **[Claude Tag Skills](https://claude.com/docs/claude-tag/admins/skills-repo)**: Projekt-Skills, die in ein Repository übernommen wurden, werden auch geladen, wenn dieses Repository in einem Claude Tag-Kanal verwendet wird938* **[Claude Tag Skills](https://claude.com/docs/claude-tag/admins/skills-repo)**: Projekt-Skills, die in ein Repository übernommen wurden, werden auch geladen, wenn dieses Repository in einem Claude Tag-Kanal verwendet wird

statusline.md +9 −9

Details

15* Über mehrere Sitzungen hinweg arbeiten und diese unterscheiden müssen15* Über mehrere Sitzungen hinweg arbeiten und diese unterscheiden müssen

16* Git-Branch und Status immer sichtbar haben möchten16* Git-Branch und Status immer sichtbar haben möchten

17 17

18Die Statuszeile wird in ihrer eigenen Zeile über den integrierten Fußzeilenabzeichen gerendert und ersetzt diese nicht. Um anklickbare Link-Abzeichen in der Fußzeile hinzuzufügen, wenn eine ID im Gespräch angezeigt wird, ohne ein Skript zu schreiben, konfigurieren Sie stattdessen [`footerLinksRegexes`](/de/settings#footer-link-badges).18Die Statuszeile wird in ihrer eigenen Zeile über den integrierten Fußzeilenabzeichen gerendert und ersetzt diese nicht. Um anklickbare Link-Abzeichen in der Fußzeile hinzuzufügen, wenn eine ID im Gespräch angezeigt wird, ohne ein Skript zu schreiben, konfigurieren Sie stattdessen [`footerLinksRegexes`](/docs/de/settings#footer-link-badges).

19 19

20Hier ist ein Beispiel einer [mehrzeiligen Statuszeile](#display-multiple-lines), die Git-Informationen in der ersten Zeile und einen farbcodierten Kontextbalken in der zweiten Zeile anzeigt.20Hier ist ein Beispiel einer [mehrzeiligen Statuszeile](#display-multiple-lines), die Git-Informationen in der ersten Zeile und einen farbcodierten Kontextbalken in der zweiten Zeile anzeigt.

21 21

45 Statuszeile manuell konfigurieren45 Statuszeile manuell konfigurieren

46</h3>46</h3>

47 47

48Fügen Sie ein `statusLine` Feld zu Ihren Benutzereinstellungen (`~/.claude/settings.json`, wobei `~` Ihr Heimatverzeichnis ist) oder [Projekteinstellungen](/de/settings#settings-files) hinzu. Setzen Sie `type` auf `"command"` und verweisen Sie `command` auf einen Skriptpfad oder einen Inline-Shell-Befehl. Eine vollständige Anleitung zum Erstellen eines Skripts finden Sie unter [Erstellen Sie eine Statuszeile Schritt für Schritt](#build-a-status-line-step-by-step).48Fügen Sie ein `statusLine` Feld zu Ihren Benutzereinstellungen (`~/.claude/settings.json`, wobei `~` Ihr Heimatverzeichnis ist) oder [Projekteinstellungen](/docs/de/settings#settings-files) hinzu. Setzen Sie `type` auf `"command"` und verweisen Sie `command` auf einen Skriptpfad oder einen Inline-Shell-Befehl. Eine vollständige Anleitung zum Erstellen eines Skripts finden Sie unter [Erstellen Sie eine Statuszeile Schritt für Schritt](#build-a-status-line-step-by-step).

49 49

50```json theme={null}50```json theme={null}

51{51{

160 160

161**Ausgabe an die Terminalgröße anpassen**161**Ausgabe an die Terminalgröße anpassen**

162 162

163Claude Code erfasst die Ausgabe Ihres Skripts, anstatt sie direkt mit dem Terminal zu verbinden, daher können `tput cols` und sprachgestützte Breitenerkennung die Terminalgröße nicht von innerhalb des Skripts lesen. {/* min-version: 2.1.153 */}Lesen Sie stattdessen die Umgebungsvariablen `COLUMNS` und `LINES`. Claude Code setzt diese auf die aktuellen Terminaldimensionen, bevor Ihr Skript ausgeführt wird. Erfordert Claude Code v2.1.153 oder später.163Claude Code erfasst die Ausgabe Ihres Skripts, anstatt sie direkt mit dem Terminal zu verbinden, daher können `tput cols` und sprachgestützte Breitenerkennung die Terminalgröße nicht von innerhalb des Skripts lesen. Lesen Sie stattdessen die Umgebungsvariablen `COLUMNS` und `LINES`. Claude Code setzt diese auf die aktuellen Terminaldimensionen, bevor Ihr Skript ausgeführt wird. Erfordert Claude Code v2.1.153 oder später.

164 164

165<Note>Die Statuszeile wird lokal ausgeführt und verbraucht keine API-Token. Sie wird vorübergehend während bestimmter UI-Interaktionen ausgeblendet, einschließlich Autovervollständigungsvorschlägen, dem Hilfemenü und Berechtigungsaufforderungen.</Note>165<Note>Die Statuszeile wird lokal ausgeführt und verbraucht keine API-Token. Sie wird vorübergehend während bestimmter UI-Interaktionen ausgeblendet, einschließlich Autovervollständigungsvorschlägen, dem Hilfemenü und Berechtigungsaufforderungen.</Note>

166 166

194| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Unix-Epochensekunden, wenn das 5-Stunden- oder 7-Tage-Ratenlimit-Fenster zurückgesetzt wird |194| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Unix-Epochensekunden, wenn das 5-Stunden- oder 7-Tage-Ratenlimit-Fenster zurückgesetzt wird |

196| `session_name` | Benutzerdefinierter Sitzungsname, der mit dem `--name` Flag oder `/rename` gesetzt wurde. Fehlt, wenn kein benutzerdefinierter Name gesetzt wurde |196| `session_name` | Benutzerdefinierter Sitzungsname, der mit dem `--name` Flag oder `/rename` gesetzt wurde. Fehlt, wenn kein benutzerdefinierter Name gesetzt wurde |

197| `prompt_id` | UUID, die die Benutzereingabe identifiziert, die gerade verarbeitet wird. Entspricht dem [`prompt.id` Attribut auf OpenTelemetry-Ereignissen](/de/monitoring-usage#event-correlation-attributes). Fehlt bis zur ersten Benutzereingabe. Erfordert Claude Code v2.1.196 oder später |197| `prompt_id` | UUID, die die Benutzereingabe identifiziert, die gerade verarbeitet wird. Entspricht dem [`prompt.id` Attribut auf OpenTelemetry-Ereignissen](/docs/de/monitoring-usage#event-correlation-attributes). Fehlt bis zur ersten Benutzereingabe. Erfordert Claude Code v2.1.196 oder später |

201| `vim.mode` | Aktueller Vim-Modus (`NORMAL`, `INSERT`, `VISUAL` oder `VISUAL LINE`), wenn [Vim-Modus](/de/interactive-mode#vim-editor-mode) aktiviert ist |201| `vim.mode` | Aktueller Vim-Modus (`NORMAL`, `INSERT`, `VISUAL` oder `VISUAL LINE`), wenn [Vim-Modus](/docs/de/interactive-mode#vim-editor-mode) aktiviert ist |

203| `pr.number`, `pr.url` | Offener Pull Request für den aktuellen Branch. Spiegelt das PR-Badge in der unteren Statusleiste wider. Fehlt, bis ein PR gefunden wird, wenn nicht in einem Git-Repository, oder sobald der PR zusammengeführt oder geschlossen wird |203| `pr.number`, `pr.url` | Offener Pull Request für den aktuellen Branch. Spiegelt das PR-Badge in der unteren Statusleiste wider. Fehlt, bis ein PR gefunden wird, wenn nicht in einem Git-Repository, oder sobald der PR zusammengeführt oder geschlossen wird |

204| `pr.review_state` | Review-Status des offenen PR: `approved`, `pending`, `changes_requested` oder `draft`. Kann unabhängig fehlen, auch wenn `pr` vorhanden ist |204| `pr.review_state` | Review-Status des offenen PR: `approved`, `pending`, `changes_requested` oder `draft`. Kann unabhängig fehlen, auch wenn `pr` vorhanden ist |

332* `cache_creation_input_tokens`: Token, die in den Cache geschrieben wurden332* `cache_creation_input_tokens`: Token, die in den Cache geschrieben wurden

333* `cache_read_input_tokens`: Token, die aus dem Cache gelesen wurden333* `cache_read_input_tokens`: Token, die aus dem Cache gelesen wurden

334 334

335Für die Bedeutung der Cache-Felder und deren Abrechnung siehe [Cache-Leistung überprüfen](/de/prompt-caching#check-cache-performance).335Für die Bedeutung der Cache-Felder und deren Abrechnung siehe [Cache-Leistung überprüfen](/docs/de/prompt-caching#check-cache-performance).

336 336

337Das `used_percentage` Feld wird nur aus Eingabe-Token berechnet: `input_tokens + cache_creation_input_tokens + cache_read_input_tokens`. Es enthält keine `output_tokens`.337Das `used_percentage` Feld wird nur aus Eingabe-Token berechnet: `input_tokens + cache_creation_input_tokens + cache_read_input_tokens`. Es enthält keine `output_tokens`.

338 338

1033 Subagent-Statuszeilen1033 Subagent-Statuszeilen

1034</h2>1034</h2>

1035 1035

1036Die `subagentStatusLine` Einstellung rendert einen benutzerdefinierten Zeilenkörper für jeden [Subagenten](/de/sub-agents), der im Agent-Panel unterhalb der Eingabeaufforderung angezeigt wird. Verwenden Sie sie, um die Standard-`name · description · token count` Zeile durch Ihre eigene Formatierung zu ersetzen.1036Die `subagentStatusLine` Einstellung rendert einen benutzerdefinierten Zeilenkörper für jeden [Subagenten](/docs/de/sub-agents), der im Agent-Panel unterhalb der Eingabeaufforderung angezeigt wird. Verwenden Sie sie, um die Standard-`name · description · token count` Zeile durch Ihre eigene Formatierung zu ersetzen.

1037 1037

1038```json theme={null}1038```json theme={null}

1039{1039{

1044}1044}

1045```1045```

1046 1046

1047Der Befehl wird einmal pro Aktualisierungstick mit allen sichtbaren Subagenten-Zeilen ausgeführt, die als einzelnes JSON-Objekt auf stdin übergeben werden. Die Eingabe enthält die [Basis-Hook-Felder](/de/hooks#common-input-fields), ein `columns` Feld mit der nutzbaren Zeilenbreite und ein `tasks` Array. Jede Aufgabe hat `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `model`, `contextWindowSize`, `tokenCount`, `tokenSamples` und `cwd`.1047Der Befehl wird einmal pro Aktualisierungstick mit allen sichtbaren Subagenten-Zeilen ausgeführt, die als einzelnes JSON-Objekt auf stdin übergeben werden. Die Eingabe enthält die [Basis-Hook-Felder](/docs/de/hooks#common-input-fields), ein `columns` Feld mit der nutzbaren Zeilenbreite und ein `tasks` Array. Jede Aufgabe hat `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `model`, `contextWindowSize`, `tokenCount`, `tokenSamples` und `cwd`.

1048 1048

1049Das `model` Feld pro Aufgabe ist die aufgelöste Modell-ID, auf der die Aufgabe ausgeführt wird. `contextWindowSize` ist das Kontextfenster dieses Modells in Token, berechnet auf die gleiche Weise wie das `context_window.context_window_size` der Hauptstatuszeile, sodass Sie einen Prozentsatz pro Zeile aus `tokenCount` rendern können. Beide Felder erfordern Claude Code v2.1.205 oder später und werden für eine Aufgabe weggelassen, deren Modell noch nicht aufgelöst ist.1049Das `model` Feld pro Aufgabe ist die aufgelöste Modell-ID, auf der die Aufgabe ausgeführt wird. `contextWindowSize` ist das Kontextfenster dieses Modells in Token, berechnet auf die gleiche Weise wie das `context_window.context_window_size` der Hauptstatuszeile, sodass Sie einen Prozentsatz pro Zeile aus `tokenCount` rendern können. Beide Felder erfordern Claude Code v2.1.205 oder später und werden für eine Aufgabe weggelassen, deren Modell noch nicht aufgelöst ist.

1050 1050

1051Schreiben Sie eine JSON-Zeile auf stdout pro Zeile, die Sie überschreiben möchten, in der Form `{"id": "<task id>", "content": "<row body>"}`. Der `content` String wird wie vorhanden gerendert, einschließlich ANSI-Farben und OSC 8 Hyperlinks. Lassen Sie die `id` einer Aufgabe weg, um die Standard-Rendering für diese Zeile zu behalten; geben Sie einen leeren `content` String aus, um sie auszublenden.1051Schreiben Sie eine JSON-Zeile auf stdout pro Zeile, die Sie überschreiben möchten, in der Form `{"id": "<task id>", "content": "<row body>"}`. Der `content` String wird wie vorhanden gerendert, einschließlich ANSI-Farben und OSC 8 Hyperlinks. Lassen Sie die `id` einer Aufgabe weg, um die Standard-Rendering für diese Zeile zu behalten; geben Sie einen leeren `content` String aus, um sie auszublenden.

1052 1052

1053Die gleichen Vertrauens- und `disableAllHooks` Gates, die für `statusLine` gelten, gelten auch hier. Plugins können eine Standard-`subagentStatusLine` in ihrer [`settings.json`](/de/plugins-reference#standard-plugin-layout) versenden.1053Die gleichen Vertrauens- und `disableAllHooks` Gates, die für `statusLine` gelten, gelten auch hier. Plugins können eine Standard-`subagentStatusLine` in ihrer [`settings.json`](/docs/de/plugins-reference#standard-plugin-layout) versenden.

1054 1054

1055<h2 id="tips">1055<h2 id="tips">

1056 Tipps1056 Tipps

sub-agents.md +87 −87

Details

8 8

9Subagenten sind spezialisierte KI-Assistenten, die bestimmte Arten von Aufgaben bearbeiten. Verwenden Sie einen, wenn eine Nebenaufgabe Ihre Hauptkonversation mit Suchergebnissen, Protokollen oder Dateiinhalten überfluten würde, auf die Sie nicht mehr verweisen werden: Der Subagent führt diese Arbeit in seinem eigenen Kontext durch und gibt nur die Zusammenfassung zurück. Definieren Sie einen benutzerdefinierten Subagenten, wenn Sie wiederholt denselben Typ von Worker mit denselben Anweisungen spawnen.9Subagenten sind spezialisierte KI-Assistenten, die bestimmte Arten von Aufgaben bearbeiten. Verwenden Sie einen, wenn eine Nebenaufgabe Ihre Hauptkonversation mit Suchergebnissen, Protokollen oder Dateiinhalten überfluten würde, auf die Sie nicht mehr verweisen werden: Der Subagent führt diese Arbeit in seinem eigenen Kontext durch und gibt nur die Zusammenfassung zurück. Definieren Sie einen benutzerdefinierten Subagenten, wenn Sie wiederholt denselben Typ von Worker mit denselben Anweisungen spawnen.

10 10

11Jeder Subagent läuft in seinem eigenen Kontextfenster mit einem benutzerdefinierten Systemprompt, spezifischem Werkzeugzugriff und unabhängigen Berechtigungen. Wenn Claude auf eine Aufgabe trifft, die der Beschreibung eines Subagenten entspricht, delegiert es an diesen Subagenten, der unabhängig arbeitet und Ergebnisse zurückgibt. Um die Kontexteinsparungen in der Praxis zu sehen, zeigt die [Kontextfenster-Visualisierung](/de/context-window) eine Sitzung, in der ein Subagent Recherchen in seinem eigenen separaten Fenster durchführt.11Jeder Subagent läuft in seinem eigenen Kontextfenster mit einem benutzerdefinierten Systemprompt, spezifischem Werkzeugzugriff und unabhängigen Berechtigungen. Wenn Claude auf eine Aufgabe trifft, die der Beschreibung eines Subagenten entspricht, delegiert es an diesen Subagenten, der unabhängig arbeitet und Ergebnisse zurückgibt. Um die Kontexteinsparungen in der Praxis zu sehen, zeigt die [Kontextfenster-Visualisierung](/docs/de/context-window) eine Sitzung, in der ein Subagent Recherchen in seinem eigenen separaten Fenster durchführt.

12 12

13<Note>13<Note>

14 Subagenten arbeiten innerhalb einer einzelnen Sitzung. Um viele unabhängige Sitzungen parallel auszuführen und sie von einem Ort aus zu überwachen, siehe [Hintergrund-Agenten](/de/agent-view). Für Sitzungen, die miteinander kommunizieren, siehe [Agent-Teams](/de/agent-teams).14 Subagenten arbeiten innerhalb einer einzelnen Sitzung. Um viele unabhängige Sitzungen parallel auszuführen und sie von einem Ort aus zu überwachen, siehe [Hintergrund-Agenten](/docs/de/agent-view). Für Sitzungen, die miteinander kommunizieren, siehe [Agent-Teams](/docs/de/agent-teams).

15</Note>15</Note>

16 16

17Subagenten helfen Ihnen:17Subagenten helfen Ihnen:

42 * **Werkzeuge**: Schreibgeschützte Werkzeuge; Write und Edit sind nicht zulässig42 * **Werkzeuge**: Schreibgeschützte Werkzeuge; Write und Edit sind nicht zulässig

43 * **Zweck**: Dateiermittlung, Codesuche, Codebase-Exploration43 * **Zweck**: Dateiermittlung, Codesuche, Codebase-Exploration

44 44

45 {/* min-version: 2.1.198 */}Ab v2.1.198 erbt Explore das Modell der Hauptkonversation, anstatt immer auf Haiku ausgeführt zu werden. In der Claude API ist das geerbte Modell auf Opus begrenzt: Eine Hauptkonversation auf einer höheren Stufe führt Explore auf Opus aus, und eine Hauptkonversation auf Sonnet oder Haiku führt Explore auf demselben Modell aus. Bei jedem anderen Anbieter, wie z. B. [Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform on AWS](/de/third-party-integrations), erbt Explore das Modell der Hauptkonversation direkt.45 Ab v2.1.198 erbt Explore das Modell der Hauptkonversation, anstatt immer auf Haiku ausgeführt zu werden. In der Claude API ist das geerbte Modell auf Opus begrenzt: Eine Hauptkonversation auf einer höheren Stufe führt Explore auf Opus aus, und eine Hauptkonversation auf Sonnet oder Haiku führt Explore auf demselben Modell aus. Bei jedem anderen Anbieter, wie z. B. [Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform on AWS](/docs/de/third-party-integrations), erbt Explore das Modell der Hauptkonversation direkt.

46 46

47 Ein [Benutzer- oder Projekt-Subagent](#choose-the-subagent-scope) mit dem Namen `Explore` überschreibt den integrierten und behält sein eigenes `model`-Feld, daher definieren Sie einen mit `model: haiku`, um die Exploration auf einem kostengünstigeren Modell zu halten.47 Ein [Benutzer- oder Projekt-Subagent](#choose-the-subagent-scope) mit dem Namen `Explore` überschreibt den integrierten und behält sein eigenes `model`-Feld, daher definieren Sie einen mit `model: haiku`, um die Exploration auf einem kostengünstigeren Modell zu halten.

48 48

52 </Tab>52 </Tab>

53 53

54 <Tab title="Plan">54 <Tab title="Plan">

~~55 Ein Forschungsagent, der während des [Plan-Modus](/de/permission-modes#analyze-before-you-edit-with-plan-mode) verwendet wird, um Kontext zu sammeln, bevor ein Plan präsentiert wird.~~55 Ein Forschungsagent, der während des [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) verwendet wird, um Kontext zu sammeln, bevor ein Plan präsentiert wird.

56 56

57 * **Modell**: Erbt von der Hauptkonversation57 * **Modell**: Erbt von der Hauptkonversation

58 * **Werkzeuge**: Schreibgeschützte Werkzeuge; Write und Edit sind nicht zulässig58 * **Werkzeuge**: Schreibgeschützte Werkzeuge; Write und Edit sind nicht zulässig

84Integrierte Subagenten sind in interaktiven Sitzungen standardmäßig registriert. Um sie einzuschränken:84Integrierte Subagenten sind in interaktiven Sitzungen standardmäßig registriert. Um sie einzuschränken:

85 85

86* Um einen bestimmten integrierten Typ zu blockieren, fügen Sie ihn zu `permissions.deny` hinzu, wie in [Spezifische Subagenten deaktivieren](#disable-specific-subagents) gezeigt.86* Um einen bestimmten integrierten Typ zu blockieren, fügen Sie ihn zu `permissions.deny` hinzu, wie in [Spezifische Subagenten deaktivieren](#disable-specific-subagents) gezeigt.

~~87* Um zu verhindern, dass Claude an einen Subagenten delegiert, verweigern Sie das `Agent`-Werkzeug selbst mit [`permissions.deny`](/de/permissions#tool-specific-permission-rules).~~87* Um zu verhindern, dass Claude an einen Subagenten delegiert, verweigern Sie das `Agent`-Werkzeug selbst mit [`permissions.deny`](/docs/de/permissions#tool-specific-permission-rules).

88* {/* min-version: 2.1.198 */}Um nur die integrierten `Explore`- und `Plan`-Subagenten zu entfernen, setzen Sie [`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1`](/de/env-vars). Claude liest und erkundet Dateien direkt, anstatt an sie zu delegieren. Erfordert Claude Code v2.1.198 oder später.88* Um nur die integrierten `Explore`- und `Plan`-Subagenten zu entfernen, setzen Sie [`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1`](/docs/de/env-vars). Claude liest und erkundet Dateien direkt, anstatt an sie zu delegieren. Erfordert Claude Code v2.1.198 oder später.

89* Im [nicht-interaktiven Modus](/de/headless) und dem [Agent SDK](/de/agent-sdk/overview) setzen Sie [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/de/env-vars), um alle integrierten Typen zu entfernen und nur Ihre eigenen bereitzustellen.89* Im [nicht-interaktiven Modus](/docs/de/headless) und dem [Agent SDK](/docs/de/agent-sdk/overview) setzen Sie [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/de/env-vars), um alle integrierten Typen zu entfernen und nur Ihre eigenen bereitzustellen.

90 90

91Über diese integrierten Subagenten hinaus können Sie Ihre eigenen mit benutzerdefinierten Prompts, Werkzeugbeschränkungen, Berechtigungsmodi, Hooks und Skills erstellen. Die folgenden Abschnitte zeigen, wie Sie anfangen und Subagenten anpassen.91Über diese integrierten Subagenten hinaus können Sie Ihre eigenen mit benutzerdefinierten Prompts, Werkzeugbeschränkungen, Berechtigungsmodi, Hooks und Skills erstellen. Die folgenden Abschnitte zeigen, wie Sie anfangen und Subagenten anpassen.

92 92

96 96

97Subagenten sind Markdown-Dateien mit YAML-Frontmatter. Um einen zu erstellen, bitten Sie Claude, ihn für Sie zu schreiben, oder [schreiben Sie die Datei selbst](#write-subagent-files).97Subagenten sind Markdown-Dateien mit YAML-Frontmatter. Um einen zu erstellen, bitten Sie Claude, ihn für Sie zu schreiben, oder [schreiben Sie die Datei selbst](#write-subagent-files).

98 98

99{/* min-version: 2.1.198 */}Ab v2.1.198 öffnet der `/agents`-Befehl nicht mehr den interaktiven Erstellungs-Assistenten; das Ausführen gibt eine Erinnerung aus, Claude zu fragen oder `.claude/agents/` direkt zu bearbeiten. Subagenten-Dateien, Frontmatter-Felder und die Speicherorte `.claude/agents/` und `~/.claude/agents/` bleiben unverändert; nur der Terminal-Assistent wird entfernt.99Ab v2.1.198 öffnet der `/agents`-Befehl nicht mehr den interaktiven Erstellungs-Assistenten; das Ausführen gibt eine Erinnerung aus, Claude zu fragen oder `.claude/agents/` direkt zu bearbeiten. Subagenten-Dateien, Frontmatter-Felder und die Speicherorte `.claude/agents/` und `~/.claude/agents/` bleiben unverändert; nur der Terminal-Assistent wird entfernt.

100 100

101Diese Anleitung erstellt einen Subagenten auf Benutzerebene, der Code überprüft und Verbesserungen vorschlägt.101Diese Anleitung erstellt einen Subagenten auf Benutzerebene, der Code überprüft und Verbesserungen vorschlägt.

102 102

150Sie können Subagenten-Dateien auch manuell schreiben, sie über CLI-Flags definieren oder sie über Plugins verteilen. Die folgenden Abschnitte behandeln alle Konfigurationsoptionen.150Sie können Subagenten-Dateien auch manuell schreiben, sie über CLI-Flags definieren oder sie über Plugins verteilen. Die folgenden Abschnitte behandeln alle Konfigurationsoptionen.

151 151

152<Note>152<Note>

153 In Claude Code v2.1.197 und früher öffnet `/agents` einen interaktiven Assistenten mit einer Registerkarte **Running**, die aktive Subagenten auflistet, und einer Registerkarte **Library** zum Erstellen, Bearbeiten und Löschen. {/* max-version: 2.1.197 */}153 In Claude Code v2.1.197 und früher öffnet `/agents` einen interaktiven Assistenten mit einer Registerkarte **Running**, die aktive Subagenten auflistet, und einer Registerkarte **Library** zum Erstellen, Bearbeiten und Löschen. 

154</Note>154</Note>

155 155

156<h2 id="configure-subagents">156<h2 id="configure-subagents">

167 167

168| Ort | Umfang | Priorität | Wie zu erstellen |168| Ort | Umfang | Priorität | Wie zu erstellen |

169| :--------------------------- | :---------------------- | :------------- | :----------------------------------------------------------- |169| :--------------------------- | :---------------------- | :------------- | :----------------------------------------------------------- |

175 175

176**Projekt-Subagenten** (`.claude/agents/`) sind ideal für Subagenten, die spezifisch für eine Codebase sind. Checken Sie sie in die Versionskontrolle ein, damit Ihr Team sie gemeinsam verwenden und verbessern kann.176**Projekt-Subagenten** (`.claude/agents/`) sind ideal für Subagenten, die spezifisch für eine Codebase sind. Checken Sie sie in die Versionskontrolle ein, damit Ihr Team sie gemeinsam verwenden und verbessern kann.

177 177

178Projekt-Subagenten werden durch Aufwärts-Traversierung vom aktuellen Arbeitsverzeichnis entdeckt, sodass jedes `.claude/agents/`-Verzeichnis zwischen dort und dem Repository-Root gescannt wird. {/* min-version: 2.1.178 */}Ab v2.1.178 verwendet Claude Code, wenn mehr als eines dieser verschachtelten Verzeichnisse denselben `name` definiert, die Definition, die dem Arbeitsverzeichnis am nächsten liegt.178Projekt-Subagenten werden durch Aufwärts-Traversierung vom aktuellen Arbeitsverzeichnis entdeckt, sodass jedes `.claude/agents/`-Verzeichnis zwischen dort und dem Repository-Root gescannt wird. Ab v2.1.178 verwendet Claude Code, wenn mehr als eines dieser verschachtelten Verzeichnisse denselben `name` definiert, die Definition, die dem Arbeitsverzeichnis am nächsten liegt.

179 179

180Verzeichnisse, die mit `--add-dir` hinzugefügt werden, werden ebenfalls gescannt: Ein `.claude/agents/`-Ordner in einem hinzugefügten Verzeichnis wird zusammen mit Projekt-Subagenten geladen. Siehe [Zusätzliche Verzeichnisse](/de/permissions#additional-directories-grant-file-access-not-configuration) für welche anderen Konfigurationstypen aus `--add-dir` geladen werden. Um Subagenten über Projekte hinweg zu teilen, ohne `--add-dir` zu verwenden, nutzen Sie `~/.claude/agents/` oder ein [Plugin](/de/plugins).180Verzeichnisse, die mit `--add-dir` hinzugefügt werden, werden ebenfalls gescannt: Ein `.claude/agents/`-Ordner in einem hinzugefügten Verzeichnis wird zusammen mit Projekt-Subagenten geladen. Siehe [Zusätzliche Verzeichnisse](/docs/de/permissions#additional-directories-grant-file-access-not-configuration) für welche anderen Konfigurationstypen aus `--add-dir` geladen werden. Um Subagenten über Projekte hinweg zu teilen, ohne `--add-dir` zu verwenden, nutzen Sie `~/.claude/agents/` oder ein [Plugin](/docs/de/plugins).

181 181

182**Benutzer-Subagenten** (`~/.claude/agents/`) sind persönliche Subagenten, die in allen Ihren Projekten verfügbar sind.182**Benutzer-Subagenten** (`~/.claude/agents/`) sind persönliche Subagenten, die in allen Ihren Projekten verfügbar sind.

183 183

184Claude Code scannt `.claude/agents/` und `~/.claude/agents/` rekursiv, sodass Sie Definitionen in Unterordnern wie `agents/review/` oder `agents/research/` organisieren können. Der Unterverzeichnis-Pfad beeinflusst nicht, wie ein Subagent identifiziert oder aufgerufen wird, da die Identität nur vom `name`-Frontmatter-Feld stammt.184Claude Code scannt `.claude/agents/` und `~/.claude/agents/` rekursiv, sodass Sie Definitionen in Unterordnern wie `agents/review/` oder `agents/research/` organisieren können. Der Unterverzeichnis-Pfad beeinflusst nicht, wie ein Subagent identifiziert oder aufgerufen wird, da die Identität nur vom `name`-Frontmatter-Feld stammt.

185 185

186Halten Sie `name`-Werte über den gesamten Baum eindeutig: Wenn zwei Dateien unter demselben `.claude/agents/`-Verzeichnis, einschließlich seiner Unterordner, denselben Namen deklarieren, lädt Claude Code nur eine von ihnen, ausgewählt nach Dateisystem-Lesereihenfolge statt nach dokumentierter Priorität. Über verschachtelte Projekt-Verzeichnisse hinweg gewinnt die Definition, die dem Arbeitsverzeichnis am nächsten liegt, wie oben beschrieben. {/* min-version: 2.1.205 */}Die [`/doctor`](/de/commands#all-commands)-Setup-Überprüfung meldet Dateien im selben Verzeichnis, die einen Namen teilen, und schlägt vor, alle außer einer umzubenennen oder zu entfernen. Vor v2.1.205 öffnete `/doctor` einen Diagnose-Bildschirm, der Duplikate auflistete und zeigte, welche Definition aktiv war.186Halten Sie `name`-Werte über den gesamten Baum eindeutig: Wenn zwei Dateien unter demselben `.claude/agents/`-Verzeichnis, einschließlich seiner Unterordner, denselben Namen deklarieren, lädt Claude Code nur eine von ihnen, ausgewählt nach Dateisystem-Lesereihenfolge statt nach dokumentierter Priorität. Über verschachtelte Projekt-Verzeichnisse hinweg gewinnt die Definition, die dem Arbeitsverzeichnis am nächsten liegt, wie oben beschrieben. Die [`/doctor`](/docs/de/commands#all-commands)-Setup-Überprüfung meldet Dateien im selben Verzeichnis, die einen Namen teilen, und schlägt vor, alle außer einer umzubenennen oder zu entfernen. Vor v2.1.205 öffnete `/doctor` einen Diagnose-Bildschirm, der Duplikate auflistete und zeigte, welche Definition aktiv war.

187 187

188Plugin-`agents/`-Verzeichnisse werden ebenfalls rekursiv gescannt. Im Gegensatz zu Projekt- und Benutzer-Umfängen wird ein Unterordner in einem Plugin-`agents/`-Verzeichnis Teil des [scoped identifier](#invoke-subagents-explicitly): Eine Datei unter `agents/review/security.md` im Plugin `my-plugin` registriert sich als `my-plugin:review:security`.188Plugin-`agents/`-Verzeichnisse werden ebenfalls rekursiv gescannt. Im Gegensatz zu Projekt- und Benutzer-Umfängen wird ein Unterordner in einem Plugin-`agents/`-Verzeichnis Teil des [scoped identifier](#invoke-subagents-explicitly): Eine Datei unter `agents/review/security.md` im Plugin `my-plugin` registriert sich als `my-plugin:review:security`.

189 189

229 229

230Das `--agents`-Flag akzeptiert JSON mit denselben [Frontmatter](#supported-frontmatter-fields)-Feldern wie dateibasierte Subagenten: `description`, `prompt`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `isolation` und `color`. Verwenden Sie `prompt` für den Systemprompt, äquivalent zum Markdown-Body in dateibasierten Subagenten.230Das `--agents`-Flag akzeptiert JSON mit denselben [Frontmatter](#supported-frontmatter-fields)-Feldern wie dateibasierte Subagenten: `description`, `prompt`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `isolation` und `color`. Verwenden Sie `prompt` für den Systemprompt, äquivalent zum Markdown-Body in dateibasierten Subagenten.

231 231

232**Verwaltete Subagenten** werden von Organisationsadministratoren bereitgestellt. Platzieren Sie Markdown-Dateien in `.claude/agents/` im [Verzeichnis der verwalteten Einstellungen](/de/settings#settings-files), wobei Sie das gleiche Frontmatter-Format wie bei Projekt- und Benutzer-Subagenten verwenden. Verwaltete Definitionen haben Vorrang vor Projekt- und Benutzer-Subagenten mit demselben Namen.232**Verwaltete Subagenten** werden von Organisationsadministratoren bereitgestellt. Platzieren Sie Markdown-Dateien in `.claude/agents/` im [Verzeichnis der verwalteten Einstellungen](/docs/de/settings#settings-files), wobei Sie das gleiche Frontmatter-Format wie bei Projekt- und Benutzer-Subagenten verwenden. Verwaltete Definitionen haben Vorrang vor Projekt- und Benutzer-Subagenten mit demselben Namen.

233 233

234**Plugin-Subagenten** stammen von [Plugins](/de/plugins), die Sie installiert haben. Sie werden zusammen mit Ihren benutzerdefinierten Subagenten geladen und erscheinen in der @-Erwähnung-Typeahead unter ihrem scoped name. Siehe die [Plugin-Komponenten-Referenz](/de/plugins-reference#agents) für Details zum Erstellen von Plugin-Subagenten.234**Plugin-Subagenten** stammen von [Plugins](/docs/de/plugins), die Sie installiert haben. Sie werden zusammen mit Ihren benutzerdefinierten Subagenten geladen und erscheinen in der @-Erwähnung-Typeahead unter ihrem scoped name. Siehe die [Plugin-Komponenten-Referenz](/docs/de/plugins-reference#agents) für Details zum Erstellen von Plugin-Subagenten.

235 235

236<Note>236<Note>

237 Aus Sicherheitsgründen unterstützen Plugin-Subagenten die Frontmatter-Felder `hooks`, `mcpServers` oder `permissionMode` nicht. Diese Felder werden ignoriert, wenn Agenten aus einem Plugin geladen werden. Wenn Sie sie benötigen, kopieren Sie die Agent-Datei in `.claude/agents/` oder `~/.claude/agents/`. Sie können auch Regeln zu [`permissions.allow`](/de/settings#permission-settings) in `settings.json` oder `settings.local.json` hinzufügen, aber diese Regeln gelten für die gesamte Sitzung, nicht nur für den Plugin-Subagenten.237 Aus Sicherheitsgründen unterstützen Plugin-Subagenten die Frontmatter-Felder `hooks`, `mcpServers` oder `permissionMode` nicht. Diese Felder werden ignoriert, wenn Agenten aus einem Plugin geladen werden. Wenn Sie sie benötigen, kopieren Sie die Agent-Datei in `.claude/agents/` oder `~/.claude/agents/`. Sie können auch Regeln zu [`permissions.allow`](/docs/de/settings#permission-settings) in `settings.json` oder `settings.local.json` hinzufügen, aber diese Regeln gelten für die gesamte Sitzung, nicht nur für den Plugin-Subagenten.

238</Note>238</Note>

239 239

240Subagenten-Definitionen aus einem dieser Umfänge sind auch für [Agent-Teams](/de/agent-teams#use-subagent-definitions-for-teammates) verfügbar: Beim Spawnen eines Teammates können Sie auf einen Subagenten-Typ verweisen und der Teammate erbt seine `tools` und sein `model`, wobei der Body der Definition als zusätzliche Anweisungen an den Systemprompt des Teammates angehängt wird. Siehe [Agent-Teams](/de/agent-teams#use-subagent-definitions-for-teammates) für welche Frontmatter-Felder auf diesem Pfad gelten.240Subagenten-Definitionen aus einem dieser Umfänge sind auch für [Agent-Teams](/docs/de/agent-teams#use-subagent-definitions-for-teammates) verfügbar: Beim Spawnen eines Teammates können Sie auf einen Subagenten-Typ verweisen und der Teammate erbt seine `tools` und sein `model`, wobei der Body der Definition als zusätzliche Anweisungen an den Systemprompt des Teammates angehängt wird. Siehe [Agent-Teams](/docs/de/agent-teams#use-subagent-definitions-for-teammates) für welche Frontmatter-Felder auf diesem Pfad gelten.

241 241

242<h3 id="write-subagent-files">242<h3 id="write-subagent-files">

243 Schreiben Sie Subagenten-Dateien243 Schreiben Sie Subagenten-Dateien

268 268

269Das Frontmatter definiert die Metadaten und Konfiguration des Subagenten. Der Body wird zum Systemprompt, der das Verhalten des Subagenten leitet. Subagenten erhalten nur diesen Systemprompt plus grundlegende Umgebungsdetails wie Arbeitsverzeichnis, nicht den vollständigen Claude Code-Systemprompt.269Das Frontmatter definiert die Metadaten und Konfiguration des Subagenten. Der Body wird zum Systemprompt, der das Verhalten des Subagenten leitet. Subagenten erhalten nur diesen Systemprompt plus grundlegende Umgebungsdetails wie Arbeitsverzeichnis, nicht den vollständigen Claude Code-Systemprompt.

270 270

271Im [nicht-interaktiven Modus](/de/headless) hängt das Flag [`--append-subagent-system-prompt`](/de/cli-reference#cli-flags) den von Ihnen bereitgestellten Text an das Ende des Systemprompts jedes Subagenten an, einschließlich verschachtelter Subagenten. Erfordert Claude Code v2.1.205 oder später.271Im [nicht-interaktiven Modus](/docs/de/headless) hängt das Flag [`--append-subagent-system-prompt`](/docs/de/cli-reference#cli-flags) den von Ihnen bereitgestellten Text an das Ende des Systemprompts jedes Subagenten an, einschließlich verschachtelter Subagenten. Erfordert Claude Code v2.1.205 oder später.

272 272

273Ein Subagent startet im aktuellen Arbeitsverzeichnis der Hauptkonversation. Innerhalb eines Subagenten bleiben `cd`-Befehle nicht zwischen Bash- oder PowerShell-Werkzeugaufrufen bestehen und beeinflussen nicht das Arbeitsverzeichnis der Hauptkonversation. Um dem Subagenten stattdessen eine isolierte Kopie des Repositorys zu geben, setzen Sie [`isolation: worktree`](#supported-frontmatter-fields).273Ein Subagent startet im aktuellen Arbeitsverzeichnis der Hauptkonversation. Innerhalb eines Subagenten bleiben `cd`-Befehle nicht zwischen Bash- oder PowerShell-Werkzeugaufrufen bestehen und beeinflussen nicht das Arbeitsverzeichnis der Hauptkonversation. Um dem Subagenten stattdessen eine isolierte Kopie des Repositorys zu geben, setzen Sie [`isolation: worktree`](#supported-frontmatter-fields).

274 274

275{/* min-version: 2.1.203 */}Ein Subagent mit `isolation: worktree` führt seine Bash- und PowerShell-Befehle in seinem Worktree aus. Ein Befehl, dessen Arbeitsverzeichnis sich stattdessen zu Ihrem Haupt-Checkout auflöst, beispielsweise weil das Worktree-Verzeichnis entfernt wurde, während der Subagent lief, schlägt mit einem Fehler fehl. Vor v2.1.203 konnte ein solcher Befehl im Haupt-Checkout ausgeführt werden.275Ein Subagent mit `isolation: worktree` führt seine Bash- und PowerShell-Befehle in seinem Worktree aus. Ein Befehl, dessen Arbeitsverzeichnis sich stattdessen zu Ihrem Haupt-Checkout auflöst, beispielsweise weil das Worktree-Verzeichnis entfernt wurde, während der Subagent lief, schlägt mit einem Fehler fehl. Vor v2.1.203 konnte ein solcher Befehl im Haupt-Checkout ausgeführt werden.

276 276

277<h4 id="supported-frontmatter-fields">277<h4 id="supported-frontmatter-fields">

278 Unterstützte Frontmatter-Felder278 Unterstützte Frontmatter-Felder

282 282

284| :---------------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |284| :---------------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

285| `name` | Ja | Eindeutige Kennung mit Kleinbuchstaben und Bindestrichen. [Hooks](/de/hooks#subagentstart) erhalten diesen Wert als `agent_type`. Der Dateiname muss nicht übereinstimmen |285| `name` | Ja | Eindeutige Kennung mit Kleinbuchstaben und Bindestrichen. [Hooks](/docs/de/hooks#subagentstart) erhalten diesen Wert als `agent_type`. Der Dateiname muss nicht übereinstimmen |

286| `description` | Ja | Wann Claude an diesen Subagenten delegieren sollte |286| `description` | Ja | Wann Claude an diesen Subagenten delegieren sollte |

287| `tools` | Nein | [Werkzeuge](#available-tools), die der Subagent verwenden kann. Erbt alle Werkzeuge, wenn weggelassen. Wenn kein Eintrag in der Liste sich zu einem Werkzeug auflöst, schlägt der Subagent mit einem Fehler fehl, der die Einträge benennt. Um Skills in den Kontext zu laden, verwenden Sie das `skills`-Feld statt `Skill` hier aufzulisten |287| `tools` | Nein | [Werkzeuge](#available-tools), die der Subagent verwenden kann. Erbt alle Werkzeuge, wenn weggelassen. Wenn kein Eintrag in der Liste sich zu einem Werkzeug auflöst, schlägt der Subagent mit einem Fehler fehl, der die Einträge benennt. Um Skills in den Kontext zu laden, verwenden Sie das `skills`-Feld statt `Skill` hier aufzulisten |

289| `model` | Nein | [Modell](#choose-a-model) zu verwenden: `sonnet`, `opus`, `haiku`, `fable`, eine vollständige Modell-ID (z. B. `claude-opus-4-8`) oder `inherit`. Standard ist `inherit` |289| `model` | Nein | [Modell](#choose-a-model) zu verwenden: `sonnet`, `opus`, `haiku`, `fable`, eine vollständige Modell-ID (z. B. `claude-opus-4-8`) oder `inherit`. Standard ist `inherit` |

290| `permissionMode` | Nein | [Berechtigungsmodus](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan` oder {/* min-version: 2.1.200 */}`manual` als Alias für `default`. Der `manual`-Alias erfordert Claude Code v2.1.200 oder später. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |290| `permissionMode` | Nein | [Berechtigungsmodus](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan` oder `manual` als Alias für `default`. Der `manual`-Alias erfordert Claude Code v2.1.200 oder später. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |

292| `skills` | Nein | [Skills](/de/skills) zum Vorausladen in den Kontext des Subagenten beim Start. Der vollständige Skill-Inhalt wird eingespritzt, nicht nur die Beschreibung. Subagenten können weiterhin unlisted Projekt-, Benutzer- und Plugin-Skills durch das Skill-Werkzeug aufrufen |292| `skills` | Nein | [Skills](/docs/de/skills) zum Vorausladen in den Kontext des Subagenten beim Start. Der vollständige Skill-Inhalt wird eingespritzt, nicht nur die Beschreibung. Subagenten können weiterhin unlisted Projekt-, Benutzer- und Plugin-Skills durch das Skill-Werkzeug aufrufen |

293| `mcpServers` | Nein | [MCP-Server](/de/mcp) verfügbar für diesen Subagenten. Jeder Eintrag ist entweder ein Servername, der auf einen bereits konfigurierten Server verweist (z. B. `"slack"`) oder eine Inline-Definition mit dem Servernamen als Schlüssel und einer vollständigen [MCP-Server-Konfiguration](/de/mcp#installing-mcp-servers) als Wert. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |293| `mcpServers` | Nein | [MCP-Server](/docs/de/mcp) verfügbar für diesen Subagenten. Jeder Eintrag ist entweder ein Servername, der auf einen bereits konfigurierten Server verweist (z. B. `"slack"`) oder eine Inline-Definition mit dem Servernamen als Schlüssel und einer vollständigen [MCP-Server-Konfiguration](/docs/de/mcp#installing-mcp-servers) als Wert. Ignoriert für [Plugin-Subagenten](#choose-the-subagent-scope) |

296| `background` | Nein | Auf `true` setzen, um diesen Subagenten immer als [Hintergrundaufgabe](#run-subagents-in-foreground-or-background) auszuführen, auch wenn Claude sein Ergebnis sofort benötigt. Wenn nicht gesetzt, wählt Claude, und {/* min-version: 2.1.198 */}ab v2.1.198 führt es Subagenten standardmäßig im Hintergrund aus |296| `background` | Nein | Auf `true` setzen, um diesen Subagenten immer als [Hintergrundaufgabe](#run-subagents-in-foreground-or-background) auszuführen, auch wenn Claude sein Ergebnis sofort benötigt. Wenn nicht gesetzt, wählt Claude, und ab v2.1.198 führt es Subagenten standardmäßig im Hintergrund aus |

297| `effort` | Nein | Aufwandsstufe, wenn dieser Subagent aktiv ist. Überschreibt die Aufwandsstufe der Sitzung. Standard: erbt von Sitzung. Optionen: `low`, `medium`, `high`, `xhigh`, `max`; verfügbare Stufen hängen vom Modell ab |297| `effort` | Nein | Aufwandsstufe, wenn dieser Subagent aktiv ist. Überschreibt die Aufwandsstufe der Sitzung. Standard: erbt von Sitzung. Optionen: `low`, `medium`, `high`, `xhigh`, `max`; verfügbare Stufen hängen vom Modell ab |

298| `isolation` | Nein | Auf `worktree` setzen, um den Subagenten in einem temporären [Git-Worktree](/de/worktrees) auszuführen, was ihm eine isolierte Kopie des Repositorys gibt, die standardmäßig von Ihrem [Standard-Branch](/de/worktrees#choose-the-base-branch) verzweigt ist, anstatt vom `HEAD` der übergeordneten Sitzung. Der Worktree wird automatisch bereinigt, wenn der Subagent keine Änderungen vornimmt |298| `isolation` | Nein | Auf `worktree` setzen, um den Subagenten in einem temporären [Git-Worktree](/docs/de/worktrees) auszuführen, was ihm eine isolierte Kopie des Repositorys gibt, die standardmäßig von Ihrem [Standard-Branch](/docs/de/worktrees#choose-the-base-branch) verzweigt ist, anstatt vom `HEAD` der übergeordneten Sitzung. Der Worktree wird automatisch bereinigt, wenn der Subagent keine Änderungen vornimmt |

299| `color` | Nein | Anzeigefarbe für den Subagenten in der Aufgabenliste und dem Transkript. Akzeptiert `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink` oder `cyan` |299| `color` | Nein | Anzeigefarbe für den Subagenten in der Aufgabenliste und dem Transkript. Akzeptiert `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink` oder `cyan` |

300| `initialPrompt` | Nein | Auto-eingereicht als der erste Benutzer-Turn, wenn dieser Agent als Hauptsitzungs-Agent läuft (über `--agent` oder die `agent`-Einstellung). [Befehle](/de/commands) und [Skills](/de/skills) werden verarbeitet. Vorangestellt zu jedem vom Benutzer bereitgestellten Prompt |300| `initialPrompt` | Nein | Auto-eingereicht als der erste Benutzer-Turn, wenn dieser Agent als Hauptsitzungs-Agent läuft (über `--agent` oder die `agent`-Einstellung). [Befehle](/docs/de/commands) und [Skills](/docs/de/skills) werden verarbeitet. Vorangestellt zu jedem vom Benutzer bereitgestellten Prompt |

301 301

302<h3 id="choose-a-model">302<h3 id="choose-a-model">

303 Wählen Sie ein Modell303 Wählen Sie ein Modell

304</h3>304</h3>

305 305

306Das `model`-Feld steuert, welches [KI-Modell](/de/model-config) der Subagent verwendet:306Das `model`-Feld steuert, welches [KI-Modell](/docs/de/model-config) der Subagent verwendet:

307 307

308* **Modell-Alias**: Verwenden Sie einen der verfügbaren Aliase: `sonnet`, `opus`, `haiku` oder `fable`308* **Modell-Alias**: Verwenden Sie einen der verfügbaren Aliase: `sonnet`, `opus`, `haiku` oder `fable`

309* **Vollständige Modell-ID**: Verwenden Sie eine vollständige Modell-ID wie `claude-opus-4-8` oder `claude-sonnet-5`. Akzeptiert dieselben Werte wie das `--model`-Flag309* **Vollständige Modell-ID**: Verwenden Sie eine vollständige Modell-ID wie `claude-opus-4-8` oder `claude-sonnet-5`. Akzeptiert dieselben Werte wie das `--model`-Flag

312 312

313Wenn Claude einen Subagenten aufruft, kann es auch einen `model`-Parameter für diese spezifische Invokation übergeben. Claude Code löst das Modell des Subagenten in dieser Reihenfolge auf:313Wenn Claude einen Subagenten aufruft, kann es auch einen `model`-Parameter für diese spezifische Invokation übergeben. Claude Code löst das Modell des Subagenten in dieser Reihenfolge auf:

314 314

3151. Die Umgebungsvariable [`CLAUDE_CODE_SUBAGENT_MODEL`](/de/model-config#environment-variables), wenn gesetzt auf einen Modell-Alias oder eine Modell-ID3151. Die Umgebungsvariable [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/de/model-config#environment-variables), wenn gesetzt auf einen Modell-Alias oder eine Modell-ID

3162. Der `model`-Parameter pro Invokation3162. Der `model`-Parameter pro Invokation

3173. Das `model`-Frontmatter der Subagenten-Definition3173. Das `model`-Frontmatter der Subagenten-Definition

3184. Das Modell der Hauptkonversation3184. Das Modell der Hauptkonversation

319 319

320{/* min-version: 2.1.196 */}Ab v2.1.196 ist das Setzen von `CLAUDE_CODE_SUBAGENT_MODEL` auf `inherit` dasselbe wie das Nichtsetzen: Die Auflösung wird mit dem `model`-Parameter pro Invokation fortgesetzt, dann mit dem Frontmatter. In früheren Versionen zwang `inherit` Subagenten auf das Modell der Hauptkonversation und ignorierte beide dieser Quellen.320Ab v2.1.196 ist das Setzen von `CLAUDE_CODE_SUBAGENT_MODEL` auf `inherit` dasselbe wie das Nichtsetzen: Die Auflösung wird mit dem `model`-Parameter pro Invokation fortgesetzt, dann mit dem Frontmatter. In früheren Versionen zwang `inherit` Subagenten auf das Modell der Hauptkonversation und ignorierte beide dieser Quellen.

321 321

322Claude Code überprüft die Umgebungsvariable, den Parameter pro Invokation und die Frontmatter-Werte gegen die [`availableModels`](/de/model-config#restrict-model-selection)-Allowlist Ihrer Organisation. Ein Wert, der sich zu einem ausgeschlossenen Modell auflöst, wird übersprungen und der Subagent läuft stattdessen auf dem geerbten Modell.322Claude Code überprüft die Umgebungsvariable, den Parameter pro Invokation und die Frontmatter-Werte gegen die [`availableModels`](/docs/de/model-config#restrict-model-selection)-Allowlist Ihrer Organisation. Ein Wert, der sich zu einem ausgeschlossenen Modell auflöst, wird übersprungen und der Subagent läuft stattdessen auf dem geerbten Modell.

323 323

324{/* min-version: 2.1.198 */}Ab v2.1.198 erben Subagenten auch die [Extended Thinking](/de/model-config#extended-thinking)-Konfiguration der Hauptkonversation: Wenn Thinking in Ihrer Sitzung aktiviert ist, ist es für den Subagenten aktiviert, und wenn es deaktiviert ist, bleibt es deaktiviert. Es gibt keine Pro-Subagenten-Thinking-Einstellung. Vor v2.1.198 liefen Subagenten mit deaktiviertem Extended Thinking, unabhängig von der Einstellung der Hauptkonversation.324Ab v2.1.198 erben Subagenten auch die [Extended Thinking](/docs/de/model-config#extended-thinking)-Konfiguration der Hauptkonversation: Wenn Thinking in Ihrer Sitzung aktiviert ist, ist es für den Subagenten aktiviert, und wenn es deaktiviert ist, bleibt es deaktiviert. Es gibt keine Pro-Subagenten-Thinking-Einstellung. Vor v2.1.198 liefen Subagenten mit deaktiviertem Extended Thinking, unabhängig von der Einstellung der Hauptkonversation.

325 325

326<h3 id="control-subagent-capabilities">326<h3 id="control-subagent-capabilities">

327 Kontrollieren Sie Subagenten-Fähigkeiten327 Kontrollieren Sie Subagenten-Fähigkeiten

333 Verfügbare Werkzeuge333 Verfügbare Werkzeuge

334</h4>334</h4>

335 335

336Subagenten erben die [internen Werkzeuge](/de/tools-reference) und MCP-Werkzeuge, die in der Hauptkonversation verfügbar sind, standardmäßig. Die folgenden Werkzeuge hängen von der Benutzeroberfläche oder dem Sitzungszustand der Hauptkonversation ab und sind nicht für Subagenten verfügbar, auch wenn sie im `tools`-Feld aufgelistet sind:336Subagenten erben die [internen Werkzeuge](/docs/de/tools-reference) und MCP-Werkzeuge, die in der Hauptkonversation verfügbar sind, standardmäßig. Die folgenden Werkzeuge hängen von der Benutzeroberfläche oder dem Sitzungszustand der Hauptkonversation ab und sind nicht für Subagenten verfügbar, auch wenn sie im `tools`-Feld aufgelistet sind:

337 337

338* `AskUserQuestion`338* `AskUserQuestion`

339* `EnterPlanMode`339* `EnterPlanMode`

363 363

364Wenn beide gesetzt sind, wird `disallowedTools` zuerst angewendet, dann wird `tools` gegen den verbleibenden Pool aufgelöst. Ein Werkzeug, das in beiden aufgelistet ist, wird entfernt.364Wenn beide gesetzt sind, wird `disallowedTools` zuerst angewendet, dann wird `tools` gegen den verbleibenden Pool aufgelöst. Ein Werkzeug, das in beiden aufgelistet ist, wird entfernt.

365 365

366Wenn nichts in der `tools`-Liste sich zu einem Werkzeug auflöst, beispielsweise weil jeder Eintrag falsch geschrieben ist oder ein Werkzeug benennt, das nicht für Subagenten verfügbar ist, weigert sich Claude Code, den Subagenten zu starten, und das Agent-Werkzeug gibt einen Fehler zurück, der die ungelösten Einträge benennt. {/* min-version: 2.1.208 */}Vor v2.1.208 startete dieser Subagent mit keinen Werkzeugen und konnte ein leeres oder verwirrendes Ergebnis zurückgeben.366Wenn nichts in der `tools`-Liste sich zu einem Werkzeug auflöst, beispielsweise weil jeder Eintrag falsch geschrieben ist oder ein Werkzeug benennt, das nicht für Subagenten verfügbar ist, weigert sich Claude Code, den Subagenten zu starten, und das Agent-Werkzeug gibt einen Fehler zurück, der die ungelösten Einträge benennt. Vor v2.1.208 startete dieser Subagent mit keinen Werkzeugen und konnte ein leeres oder verwirrendes Ergebnis zurückgeben.

367 367

368Beide Felder akzeptieren MCP-Server-Level-Muster zusätzlich zu exakten Werkzeugnamen: `mcp__<server>` oder `mcp__<server>__*` gewährt oder entfernt jedes Werkzeug vom benannten Server. In `disallowedTools` entfernt `mcp__*` auch jedes MCP-Werkzeug von jedem Server. Dieses Beispiel entfernt jedes Werkzeug vom `github` MCP-Server, während Werkzeuge von anderen Servern und jedes integrierte Werkzeug beibehalten werden:368Beide Felder akzeptieren MCP-Server-Level-Muster zusätzlich zu exakten Werkzeugnamen: `mcp__<server>` oder `mcp__<server>__*` gewährt oder entfernt jedes Werkzeug vom benannten Server. In `disallowedTools` entfernt `mcp__*` auch jedes MCP-Werkzeug von jedem Server. Dieses Beispiel entfernt jedes Werkzeug vom `github` MCP-Server, während Werkzeuge von anderen Servern und jedes integrierte Werkzeug beibehalten werden:

369 369

407 Umfang von MCP-Servern auf einen Subagenten407 Umfang von MCP-Servern auf einen Subagenten

408</h4>408</h4>

409 409

410Verwenden Sie das `mcpServers`-Feld, um einem Subagenten Zugriff auf [MCP](/de/mcp)-Server zu geben, die in der Hauptkonversation nicht verfügbar sind. Inline-Server, die hier definiert sind, werden verbunden, wenn der Subagent startet, und getrennt, wenn er endet. String-Verweise teilen die Verbindung der übergeordneten Sitzung.410Verwenden Sie das `mcpServers`-Feld, um einem Subagenten Zugriff auf [MCP](/docs/de/mcp)-Server zu geben, die in der Hauptkonversation nicht verfügbar sind. Inline-Server, die hier definiert sind, werden verbunden, wenn der Subagent startet, und getrennt, wenn er endet. String-Verweise teilen die Verbindung der übergeordneten Sitzung.

411 411

412<Note>412<Note>

413 Das `mcpServers`-Feld gilt in beiden Kontexten, in denen eine Agent-Datei ausgeführt werden kann:413 Das `mcpServers`-Feld gilt in beiden Kontexten, in denen eine Agent-Datei ausgeführt werden kann:

415 * Als Subagent, gespawnt durch das Agent-Werkzeug oder eine @-Erwähnung415 * Als Subagent, gespawnt durch das Agent-Werkzeug oder eine @-Erwähnung

416 * Als Hauptsitzung, gestartet mit [`--agent`](#invoke-subagents-explicitly) oder der `agent`-Einstellung416 * Als Hauptsitzung, gestartet mit [`--agent`](#invoke-subagents-explicitly) oder der `agent`-Einstellung

417 417

418 Wenn der Agent die Hauptsitzung ist, verbinden sich Inline-Server-Definitionen beim Start zusammen mit Servern aus [`.mcp.json`](/de/mcp) und Einstellungsdateien.418 Wenn der Agent die Hauptsitzung ist, verbinden sich Inline-Server-Definitionen beim Start zusammen mit Servern aus [`.mcp.json`](/docs/de/mcp) und Einstellungsdateien.

419</Note>419</Note>

420 420

421Jeder Eintrag in der Liste ist entweder eine Inline-Server-Definition oder ein String, der auf einen bereits konfigurierten MCP-Server in Ihrer Sitzung verweist:421Jeder Eintrag in der Liste ist entweder eine Inline-Server-Definition oder ein String, der auf einen bereits konfigurierten MCP-Server in Ihrer Sitzung verweist:

443 443

444Ab v2.1.153 gelten die MCP-Einschränkungen, die für die Hauptsitzung gelten, auch für Server, die im Subagenten-Frontmatter deklariert sind:444Ab v2.1.153 gelten die MCP-Einschränkungen, die für die Hauptsitzung gelten, auch für Server, die im Subagenten-Frontmatter deklariert sind:

445 445

446* [`--strict-mcp-config`](/de/cli-reference) und [`--bare`](/de/cli-reference)446* [`--strict-mcp-config`](/docs/de/cli-reference) und [`--bare`](/docs/de/cli-reference)

447* [Enterprise verwaltete MCP-Konfiguration](/de/managed-mcp)447* [Enterprise verwaltete MCP-Konfiguration](/docs/de/managed-mcp)

448* [`allowedMcpServers` und `deniedMcpServers` Richtlinien](/de/managed-mcp#policy-based-control-with-allowlists-and-denylists)448* [`allowedMcpServers` und `deniedMcpServers` Richtlinien](/docs/de/managed-mcp#policy-based-control-with-allowlists-and-denylists)

449 449

450Wenn einer dieser Punkte einen Server blockiert, überspringt Claude Code ihn und zeigt eine Warnung mit den Namen der blockierten Server an.450Wenn einer dieser Punkte einen Server blockiert, überspringt Claude Code ihn und zeigt eine Warnung mit den Namen der blockierten Server an.

451 451

461| :------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |461| :------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

463| `acceptEdits` | Automatische Akzeptanz von Dateibearbeitungen und häufigen Dateisystem-Befehlen für Pfade im Arbeitsverzeichnis oder `additionalDirectories` |463| `acceptEdits` | Automatische Akzeptanz von Dateibearbeitungen und häufigen Dateisystem-Befehlen für Pfade im Arbeitsverzeichnis oder `additionalDirectories` |

464| `auto` | [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode): ein KI-Klassifizierer bewertet Befehle und Schreibvorgänge in geschützten Verzeichnissen |464| `auto` | [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode): ein KI-Klassifizierer bewertet Befehle und Schreibvorgänge in geschützten Verzeichnissen |

465| `dontAsk` | Automatische Ablehnung von Berechtigungsaufforderungen. Explizit zulässige Werkzeuge funktionieren weiterhin; `AskUserQuestion`, Connector-Werkzeuge [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools) und MCP-Werkzeuge, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, werden verweigert, auch wenn Sie sie zugelassen haben |465| `dontAsk` | Automatische Ablehnung von Berechtigungsaufforderungen. Explizit zulässige Werkzeuge funktionieren weiterhin; `AskUserQuestion`, Connector-Werkzeuge [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools) und MCP-Werkzeuge, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, werden verweigert, auch wenn Sie sie zugelassen haben |

468 468

469<Warning>469<Warning>

470 Verwenden Sie `bypassPermissions` mit Vorsicht. Es überspringt Berechtigungsaufforderungen und ermöglicht dem Subagenten, Operationen ohne Genehmigung auszuführen, einschließlich Schreibvorgänge in `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` und `.mvn`.470 Verwenden Sie `bypassPermissions` mit Vorsicht. Es überspringt Berechtigungsaufforderungen und ermöglicht dem Subagenten, Operationen ohne Genehmigung auszuführen, einschließlich Schreibvorgänge in `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` und `.mvn`.

471 471

472 Explizite [`ask`-Regeln](/de/permissions#manage-permissions), Connector-Werkzeuge [die Ihre Organisation auf `ask` gesetzt hat](/de/mcp#organization-controls-on-connector-tools), MCP-Werkzeuge, die mit [`requiresUserInteraction`](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und Root- und Home-Verzeichnis-Entfernungen wie `rm -rf /` werden weiterhin aufgefordert. Siehe [Berechtigungsmodi](/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) für Details.472 Explizite [`ask`-Regeln](/docs/de/permissions#manage-permissions), Connector-Werkzeuge [die Ihre Organisation auf `ask` gesetzt hat](/docs/de/mcp#organization-controls-on-connector-tools), MCP-Werkzeuge, die mit [`requiresUserInteraction`](/docs/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet sind, und Root- und Home-Verzeichnis-Entfernungen wie `rm -rf /` werden weiterhin aufgefordert. Siehe [Berechtigungsmodi](/docs/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) für Details.

473</Warning>473</Warning>

474 474

475Wenn das übergeordnete Element `bypassPermissions` oder `acceptEdits` verwendet, hat dies Vorrang und kann nicht überschrieben werden. Wenn das übergeordnete Element den [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) verwendet, erbt der Subagent den Auto-Modus und jedes `permissionMode` in seinem Frontmatter wird ignoriert: der Klassifizierer bewertet die Werkzeugaufrufe des Subagenten mit denselben Block- und Zulassungsregeln wie die übergeordnete Sitzung.475Wenn das übergeordnete Element `bypassPermissions` oder `acceptEdits` verwendet, hat dies Vorrang und kann nicht überschrieben werden. Wenn das übergeordnete Element den [Auto-Modus](/docs/de/permission-modes#eliminate-prompts-with-auto-mode) verwendet, erbt der Subagent den Auto-Modus und jedes `permissionMode` in seinem Frontmatter wird ignoriert: der Klassifizierer bewertet die Werkzeugaufrufe des Subagenten mit denselben Block- und Zulassungsregeln wie die übergeordnete Sitzung.

476 476

477<h4 id="preload-skills-into-subagents">477<h4 id="preload-skills-into-subagents">

478 Laden Sie Skills in Subagenten vor478 Laden Sie Skills in Subagenten vor

494 494

495Der vollständige Inhalt jedes aufgelisteten Skills wird in den Kontext des Subagenten eingespritzt. Dieses Feld steuert, welche Skills vorausgeladen werden, nicht welche Skills der Subagent zugreifen kann: ohne es kann der Subagent weiterhin Projekt-, Benutzer- und Plugin-Skills durch das Skill-Werkzeug während der Ausführung entdecken und aufrufen. Um einen Subagenten daran zu hindern, Skills überhaupt aufzurufen, lassen Sie `Skill` aus der [`tools`](#available-tools)-Liste weg oder fügen Sie es zu `disallowedTools` hinzu.495Der vollständige Inhalt jedes aufgelisteten Skills wird in den Kontext des Subagenten eingespritzt. Dieses Feld steuert, welche Skills vorausgeladen werden, nicht welche Skills der Subagent zugreifen kann: ohne es kann der Subagent weiterhin Projekt-, Benutzer- und Plugin-Skills durch das Skill-Werkzeug während der Ausführung entdecken und aufrufen. Um einen Subagenten daran zu hindern, Skills überhaupt aufzurufen, lassen Sie `Skill` aus der [`tools`](#available-tools)-Liste weg oder fügen Sie es zu `disallowedTools` hinzu.

496 496

497Sie können keine Skills vorausladen, die [`disable-model-invocation: true`](/de/skills#control-who-invokes-a-skill) setzen, da das Vorausladen aus demselben Satz von Skills stammt, die Claude aufrufen kann. Wenn ein aufgelisteter Skill fehlt oder deaktiviert ist, überspringt Claude Code ihn und protokolliert eine Warnung im Debug-Protokoll.497Sie können keine Skills vorausladen, die [`disable-model-invocation: true`](/docs/de/skills#control-who-invokes-a-skill) setzen, da das Vorausladen aus demselben Satz von Skills stammt, die Claude aufrufen kann. Wenn ein aufgelisteter Skill fehlt oder deaktiviert ist, überspringt Claude Code ihn und protokolliert eine Warnung im Debug-Protokoll.

498 498

499<Note>499<Note>

500 Dies ist das Gegenteil von [Ausführen eines Skills in einem Subagenten](/de/skills#run-skills-in-a-subagent). Mit `skills` in einem Subagenten kontrolliert der Subagent den Systemprompt und lädt Skill-Inhalte. Mit `context: fork` in einem Skill wird der Skill-Inhalt in den von Ihnen angegebenen Agent eingespritzt. Beide verwenden dasselbe zugrunde liegende System.500 Dies ist das Gegenteil von [Ausführen eines Skills in einem Subagenten](/docs/de/skills#run-skills-in-a-subagent). Mit `skills` in einem Subagenten kontrolliert der Subagent den Systemprompt und lädt Skill-Inhalte. Mit `context: fork` in einem Skill wird der Skill-Inhalt in den von Ihnen angegebenen Agent eingespritzt. Beide verwenden dasselbe zugrunde liegende System.

501</Note>501</Note>

502 502

503<h4 id="enable-persistent-memory">503<h4 id="enable-persistent-memory">

569---569---

570```570```

571 571

572Claude Code [übergibt Hook-Eingabe als JSON](/de/hooks#pretooluse-input) über stdin an Hook-Befehle. Das Validierungsskript liest dieses JSON, extrahiert den Bash-Befehl und [beendet mit Code 2](/de/hooks#exit-code-2-behavior-per-event), um Schreibvorgänge zu blockieren:572Claude Code [übergibt Hook-Eingabe als JSON](/docs/de/hooks#pretooluse-input) über stdin an Hook-Befehle. Das Validierungsskript liest dieses JSON, extrahiert den Bash-Befehl und [beendet mit Code 2](/docs/de/hooks#exit-code-2-behavior-per-event), um Schreibvorgänge zu blockieren:

573 573

574```bash theme={null}574```bash theme={null}

575#!/bin/bash575#!/bin/bash

587exit 0587exit 0

588```588```

589 589

590Siehe [Hook-Eingabe](/de/hooks#pretooluse-input) für das vollständige Eingabeschema und [Exit-Codes](/de/hooks#exit-code-output) für die Auswirkungen von Exit-Codes auf das Verhalten. Unter Windows schreiben Sie Hook-Skripte in PowerShell und fügen Sie `shell: powershell` zum Hook-Eintrag hinzu, wie in [Ausführen von Hooks in PowerShell](/de/hooks#windows-powershell-tool) gezeigt.590Siehe [Hook-Eingabe](/docs/de/hooks#pretooluse-input) für das vollständige Eingabeschema und [Exit-Codes](/docs/de/hooks#exit-code-output) für die Auswirkungen von Exit-Codes auf das Verhalten. Unter Windows schreiben Sie Hook-Skripte in PowerShell und fügen Sie `shell: powershell` zum Hook-Eintrag hinzu, wie in [Ausführen von Hooks in PowerShell](/docs/de/hooks#windows-powershell-tool) gezeigt.

591 591

592<h4 id="disable-specific-subagents">592<h4 id="disable-specific-subagents">

593 Deaktivieren Sie spezifische Subagenten593 Deaktivieren Sie spezifische Subagenten

594</h4>594</h4>

595 595

596Sie können verhindern, dass Claude bestimmte Subagenten verwendet, indem Sie sie zum `deny`-Array in Ihren [Einstellungen](/de/settings#permission-settings) hinzufügen. Verwenden Sie das Format `Agent(subagent-name)`, wobei `subagent-name` dem `name`-Feld des Subagenten entspricht.596Sie können verhindern, dass Claude bestimmte Subagenten verwendet, indem Sie sie zum `deny`-Array in Ihren [Einstellungen](/docs/de/settings#permission-settings) hinzufügen. Verwenden Sie das Format `Agent(subagent-name)`, wobei `subagent-name` dem `name`-Feld des Subagenten entspricht.

597 597

598```json theme={null}598```json theme={null}

599{599{

609claude --disallowedTools "Agent(Explore)"609claude --disallowedTools "Agent(Explore)"

610```610```

611 611

612Siehe [Berechtigungsdokumentation](/de/permissions#tool-specific-permission-rules) für weitere Details zu Berechtigungsregeln.612Siehe [Berechtigungsdokumentation](/docs/de/permissions#tool-specific-permission-rules) für weitere Details zu Berechtigungsregeln.

613 613

614<h3 id="define-hooks-for-subagents">614<h3 id="define-hooks-for-subagents">

615 Definieren Sie Hooks für Subagenten615 Definieren Sie Hooks für Subagenten

616</h3>616</h3>

617 617

618Subagenten können [Hooks](/de/hooks) definieren, die während des Lebenszyklus des Subagenten ausgeführt werden. Es gibt zwei Möglichkeiten, Hooks zu konfigurieren:618Subagenten können [Hooks](/docs/de/hooks) definieren, die während des Lebenszyklus des Subagenten ausgeführt werden. Es gibt zwei Möglichkeiten, Hooks zu konfigurieren:

619 619

620* **Im Frontmatter des Subagenten**: Definieren Sie Hooks, die nur ausgeführt werden, während dieser Subagent aktiv ist620* **Im Frontmatter des Subagenten**: Definieren Sie Hooks, die nur ausgeführt werden, während dieser Subagent aktiv ist

621* **In `settings.json`**: Definieren Sie Hooks, die in der Hauptsitzung ausgeführt werden, wenn Subagenten starten oder stoppen621* **In `settings.json`**: Definieren Sie Hooks, die in der Hauptsitzung ausgeführt werden, wenn Subagenten starten oder stoppen

627Definieren Sie Hooks direkt in der Markdown-Datei des Subagenten. Diese Hooks werden nur ausgeführt, während dieser spezifische Subagent aktiv ist, und werden bereinigt, wenn er endet.627Definieren Sie Hooks direkt in der Markdown-Datei des Subagenten. Diese Hooks werden nur ausgeführt, während dieser spezifische Subagent aktiv ist, und werden bereinigt, wenn er endet.

628 628

629<Note>629<Note>

630 Frontmatter-Hooks werden ausgelöst, wenn der Agent als Subagent durch das Agent-Werkzeug oder eine @-Erwähnung gespawnt wird, und wenn der Agent als Hauptsitzung über [`--agent`](#invoke-subagents-explicitly) oder die `agent`-Einstellung läuft. Im Hauptsitzungs-Fall werden sie zusammen mit allen Hooks ausgeführt, die in [`settings.json`](/de/hooks) definiert sind.630 Frontmatter-Hooks werden ausgelöst, wenn der Agent als Subagent durch das Agent-Werkzeug oder eine @-Erwähnung gespawnt wird, und wenn der Agent als Hauptsitzung über [`--agent`](#invoke-subagents-explicitly) oder die `agent`-Einstellung läuft. Im Hauptsitzungs-Fall werden sie zusammen mit allen Hooks ausgeführt, die in [`settings.json`](/docs/de/hooks) definiert sind.

631</Note>631</Note>

632 632

633Alle [Hook-Ereignisse](/de/hooks#hook-events) werden unterstützt. Die häufigsten Ereignisse für Subagenten sind:633Alle [Hook-Ereignisse](/docs/de/hooks#hook-events) werden unterstützt. Die häufigsten Ereignisse für Subagenten sind:

634 634

636| :------------ | :-------------- | :------------------------------------------------------------------------ |636| :------------ | :-------------- | :------------------------------------------------------------------------ |

673 673

674Beide Ereignisse unterstützen Matcher, um bestimmte Agent-Typen nach Name zu adressieren. Der Matcher-Wert ist der `name` des Frontmatters des Agenten für Projekt- und Benutzer-Subagenten oder der Plugin-Umfang-Identifier wie `my-plugin:db-agent` für [Plugin-Subagenten](/de/plugins). Ein Umfang-Name enthält einen Doppelpunkt, daher wird er als [unverankerte reguläre Ausdrücke](/de/hooks#matcher-patterns) ausgewertet; verankern Sie ihn mit `^` und `$`, wie in `^my-plugin:db-agent$`, um nur diesen Agent zu treffen.674Beide Ereignisse unterstützen Matcher, um bestimmte Agent-Typen nach Name zu adressieren. Der Matcher-Wert ist der `name` des Frontmatters des Agenten für Projekt- und Benutzer-Subagenten oder der Plugin-Umfang-Identifier wie `my-plugin:db-agent` für [Plugin-Subagenten](/docs/de/plugins). Ein Umfang-Name enthält einen Doppelpunkt, daher wird er als [unverankerte reguläre Ausdrücke](/docs/de/hooks#matcher-patterns) ausgewertet; verankern Sie ihn mit `^` und `$`, wie in `^my-plugin:db-agent$`, um nur diesen Agent zu treffen.

675 675

676Dieses Beispiel führt ein Setup-Skript nur aus, wenn der `db-agent`-Subagent startet, und ein Cleanup-Skript, wenn ein beliebiger Subagent stoppt:676Dieses Beispiel führt ein Setup-Skript nur aus, wenn der `db-agent`-Subagent startet, und ein Cleanup-Skript, wenn ein beliebiger Subagent stoppt:

677 677

699 699

700Ein Matcher mit Bindestrichen wie `db-agent` passt genau auf Claude Code v2.1.195 oder später. In früheren Versionen wird er als unverankerte reguläre Ausdrücke ausgewertet und wird auch für jeden Agent-Typ ausgelöst, der ihn enthält, wie `prod-db-agent`; verankern Sie ihn als `^db-agent$` in diesen Versionen.700Ein Matcher mit Bindestrichen wie `db-agent` passt genau auf Claude Code v2.1.195 oder später. In früheren Versionen wird er als unverankerte reguläre Ausdrücke ausgewertet und wird auch für jeden Agent-Typ ausgelöst, der ihn enthält, wie `prod-db-agent`; verankern Sie ihn als `^db-agent$` in diesen Versionen.

701 701

702Siehe [Hooks](/de/hooks) für das vollständige Hook-Konfigurationsformat.702Siehe [Hooks](/docs/de/hooks) für das vollständige Hook-Konfigurationsformat.

703 703

704<h2 id="work-with-subagents">704<h2 id="work-with-subagents">

705 Arbeiten Sie mit Subagenten705 Arbeiten Sie mit Subagenten

736 736

737Ihre vollständige Nachricht geht immer noch an Claude, das den Task-Prompt des Subagenten basierend auf Ihrer Anfrage schreibt. Die @-Erwähnung steuert, welcher Subagent Claude aufruft, nicht welchen Prompt er erhält.737Ihre vollständige Nachricht geht immer noch an Claude, das den Task-Prompt des Subagenten basierend auf Ihrer Anfrage schreibt. Die @-Erwähnung steuert, welcher Subagent Claude aufruft, nicht welchen Prompt er erhält.

738 738

739Subagenten, die von einem aktivierten [Plugin](/de/plugins) bereitgestellt werden, erscheinen in der Typeahead-Liste unter ihrem scoped Namen, z. B. `my-plugin:code-reviewer` oder `my-plugin:review:security`, wenn das Plugin [Agenten in Unterordnern organisiert](#choose-the-subagent-scope). Benannte Hintergrund-Subagenten, die derzeit in der Sitzung ausgeführt werden, erscheinen auch in der Typeahead-Liste und zeigen ihren Status neben dem Namen an.739Subagenten, die von einem aktivierten [Plugin](/docs/de/plugins) bereitgestellt werden, erscheinen in der Typeahead-Liste unter ihrem scoped Namen, z. B. `my-plugin:code-reviewer` oder `my-plugin:review:security`, wenn das Plugin [Agenten in Unterordnern organisiert](#choose-the-subagent-scope). Benannte Hintergrund-Subagenten, die derzeit in der Sitzung ausgeführt werden, erscheinen auch in der Typeahead-Liste und zeigen ihren Status neben dem Namen an.

740 740

741Sie können die Erwähnung auch manuell eingeben, ohne den Picker zu verwenden: `@agent-<name>` für lokale Subagenten, oder `@agent-` gefolgt vom scoped Namen für Plugin-Subagenten, z. B. `@agent-my-plugin:code-reviewer`.741Sie können die Erwähnung auch manuell eingeben, ohne den Picker zu verwenden: `@agent-<name>` für lokale Subagenten, oder `@agent-` gefolgt vom scoped Namen für Plugin-Subagenten, z. B. `@agent-my-plugin:code-reviewer`.

742 742

743**Führen Sie die gesamte Sitzung als Subagent aus.** Übergeben Sie [`--agent <name>`](/de/cli-reference), um eine Sitzung zu starten, in der der Hauptthread selbst den Systemprompt, die Werkzeugbeschränkungen und das Modell dieses Subagenten annimmt:743**Führen Sie die gesamte Sitzung als Subagent aus.** Übergeben Sie [`--agent <name>`](/docs/de/cli-reference), um eine Sitzung zu starten, in der der Hauptthread selbst den Systemprompt, die Werkzeugbeschränkungen und das Modell dieses Subagenten annimmt:

744 744

745```bash theme={null}745```bash theme={null}

746claude --agent code-reviewer746claude --agent code-reviewer

747```747```

748 748

749Der Systemprompt des Subagenten ersetzt den Standard-Claude Code-Systemprompt vollständig, genauso wie [`--system-prompt`](/de/cli-reference) es tut. `CLAUDE.md`-Dateien und Projekt-Memory werden weiterhin durch den normalen Nachrichtenfluss geladen. Der Agent-Name erscheint als `@<name>` in der Startup-Kopfzeile, damit Sie bestätigen können, dass er aktiv ist.749Der Systemprompt des Subagenten ersetzt den Standard-Claude Code-Systemprompt vollständig, genauso wie [`--system-prompt`](/docs/de/cli-reference) es tut. `CLAUDE.md`-Dateien und Projekt-Memory werden weiterhin durch den normalen Nachrichtenfluss geladen. Der Agent-Name erscheint als `@<name>` in der Startup-Kopfzeile, damit Sie bestätigen können, dass er aktiv ist.

750 750

751Dies funktioniert mit integrierten und benutzerdefinierten Subagenten, und die Wahl bleibt bestehen, wenn Sie die Sitzung fortsetzen.751Dies funktioniert mit integrierten und benutzerdefinierten Subagenten, und die Wahl bleibt bestehen, wenn Sie die Sitzung fortsetzen.

752 752

781Subagenten können im Vordergrund oder im Hintergrund ausgeführt werden:781Subagenten können im Vordergrund oder im Hintergrund ausgeführt werden:

782 782

783* **Vordergrund-Subagenten** blockieren die Hauptkonversation bis zur Fertigstellung. Berechtigungsaufforderungen werden an Sie weitergeleitet, wenn sie auftreten.783* **Vordergrund-Subagenten** blockieren die Hauptkonversation bis zur Fertigstellung. Berechtigungsaufforderungen werden an Sie weitergeleitet, wenn sie auftreten.

784* **Hintergrund-Subagenten** laufen gleichzeitig, während Sie weiterarbeiten. {/* min-version: 2.1.186 */}Ab v2.1.186 wird die Aufforderung in Ihrer Hauptsitzung angezeigt, wenn ein Hintergrund-Subagent einen Werkzeugaufruf erreicht, der Berechtigung benötigt, und nennt den Subagenten, der fragt. Genehmigen Sie, um den Subagenten fortzusetzen, oder drücken Sie Esc, um diesen einen Werkzeugaufruf zu verweigern, ohne den Subagenten zu stoppen. Vor v2.1.186 lehnten Hintergrund-Subagenten automatisch jeden Werkzeugaufruf ab, der eine Aufforderung ausgelöst hätte.784* **Hintergrund-Subagenten** laufen gleichzeitig, während Sie weiterarbeiten. Ab v2.1.186 wird die Aufforderung in Ihrer Hauptsitzung angezeigt, wenn ein Hintergrund-Subagent einen Werkzeugaufruf erreicht, der Berechtigung benötigt, und nennt den Subagenten, der fragt. Genehmigen Sie, um den Subagenten fortzusetzen, oder drücken Sie Esc, um diesen einen Werkzeugaufruf zu verweigern, ohne den Subagenten zu stoppen. Vor v2.1.186 lehnten Hintergrund-Subagenten automatisch jeden Werkzeugaufruf ab, der eine Aufforderung ausgelöst hätte.

785 785

786{/* min-version: 2.1.198 */}Ab v2.1.198 werden Subagenten standardmäßig im Hintergrund ausgeführt. Claude führt einen Subagenten im Vordergrund aus, wenn er das Ergebnis benötigt, bevor er fortfährt. Die Standardeinstellung ändert, wo ein Subagent ausgeführt wird, nicht was ihm erlaubt ist: Hintergrund-Subagenten zeigen immer noch jede Berechtigungsaufforderung in Ihrer Hauptsitzung an. Vor v2.1.198 wählte Claude zwischen Vordergrund und Hintergrund basierend auf der Aufgabe.786Ab v2.1.198 werden Subagenten standardmäßig im Hintergrund ausgeführt. Claude führt einen Subagenten im Vordergrund aus, wenn er das Ergebnis benötigt, bevor er fortfährt. Die Standardeinstellung ändert, wo ein Subagent ausgeführt wird, nicht was ihm erlaubt ist: Hintergrund-Subagenten zeigen immer noch jede Berechtigungsaufforderung in Ihrer Hauptsitzung an. Vor v2.1.198 wählte Claude zwischen Vordergrund und Hintergrund basierend auf der Aufgabe.

787 787

788Sie können auch selbst steuern:788Sie können auch selbst steuern:

789 789

790* Claude bitten, eine Aufgabe im Hintergrund oder im Vordergrund auszuführen790* Claude bitten, eine Aufgabe im Hintergrund oder im Vordergrund auszuführen

791* **Ctrl+B** drücken, um eine laufende Aufgabe in den Hintergrund zu verschieben791* **Ctrl+B** drücken, um eine laufende Aufgabe in den Hintergrund zu verschieben

792 792

793{/* min-version: 2.1.208 */}Ein Hintergrund-Subagent, der abgeschlossen ist, bleibt in [`/tasks`](/de/commands) aufgelistet, als erledigt markiert und unter laufenden Arbeiten sortiert, bis die Sitzung ihre Aufgabenliste bereinigt. Seine Detailansicht bleibt offen, wenn der Subagent fertig ist. Subagenten, die fehlschlagen oder die Sie stoppen, verlassen die Liste. Vor v2.1.208 verließ ein abgeschlossener Subagent die Liste in dem Moment, in dem er fertig war, und seine Detailansicht schloss sich.793Ein Hintergrund-Subagent, der abgeschlossen ist, bleibt in [`/tasks`](/docs/de/commands) aufgelistet, als erledigt markiert und unter laufenden Arbeiten sortiert, bis die Sitzung ihre Aufgabenliste bereinigt. Seine Detailansicht bleibt offen, wenn der Subagent fertig ist. Subagenten, die fehlschlagen oder die Sie stoppen, verlassen die Liste. Vor v2.1.208 verließ ein abgeschlossener Subagent die Liste in dem Moment, in dem er fertig war, und seine Detailansicht schloss sich.

794 794

795Um alle Hintergrund-Aufgaben-Funktionalität zu deaktivieren, setzen Sie die Umgebungsvariable `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` auf `1`. Siehe [Umgebungsvariablen](/de/env-vars).795Um alle Hintergrund-Aufgaben-Funktionalität zu deaktivieren, setzen Sie die Umgebungsvariable `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` auf `1`. Siehe [Umgebungsvariablen](/docs/de/env-vars).

796 796

797Wenn [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) auf `1` gesetzt ist, wird jeder Subagenten-Spawn im Hintergrund ausgeführt, und das Frontmatter-Feld `background` hat keine Auswirkung, da der Fork-Modus den Parameter `run_in_background` aus dem `Agent`-Werkzeug entfernt. `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` hat Vorrang vor dem Fork-Modus und hält Subagenten-Spawns im Vordergrund.797Wenn [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) auf `1` gesetzt ist, wird jeder Subagenten-Spawn im Hintergrund ausgeführt, und das Frontmatter-Feld `background` hat keine Auswirkung, da der Fork-Modus den Parameter `run_in_background` aus dem `Agent`-Werkzeug entfernt. `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` hat Vorrang vor dem Fork-Modus und hält Subagenten-Spawns im Vordergrund.

798 798

800 API-Fehler in Subagenten800 API-Fehler in Subagenten

801</h3>801</h3>

802 802

803{/* min-version: 2.1.199 */}Ab v2.1.199 meldet ein Subagent, dessen Ausführung mit einem API-Fehler endet, z. B. ein Nutzungslimit oder ein wiederholter Serverfehler, diesen Fehler an Claude zurück, anstatt den Fehlertext so zurückzugeben, als wären es die Erkenntnisse des Subagenten. Was Claude erhält, hängt davon ab, wo der Subagent ausgeführt wurde:803Ab v2.1.199 meldet ein Subagent, dessen Ausführung mit einem API-Fehler endet, z. B. ein Nutzungslimit oder ein wiederholter Serverfehler, diesen Fehler an Claude zurück, anstatt den Fehlertext so zurückzugeben, als wären es die Erkenntnisse des Subagenten. Was Claude erhält, hängt davon ab, wo der Subagent ausgeführt wurde:

804 804

805* **Vordergrund**: Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Subagenten unterbricht, der bereits Ausgaben erzeugt hat, gibt das Agent-Werkzeug diese Teilausgabe mit einem Hinweis zurück, dass der Subagent unterbrochen wurde und seine Aufgabe nicht abgeschlossen hat. {/* min-version: 2.1.200 */}Ein Subagent, der nichts erzeugt hat, oder dessen einzige Ausgabe Werkzeugaufrufe waren, schlägt mit [`Agent terminated early due to an API error`](/de/errors#agent-terminated-early-due-to-an-api-error) fehl, gefolgt von der Fehlerdetail. In v2.1.199 gab ein Ratenlimit, eine Überlastung oder ein Serverfehler, der die Form nur mit Werkzeugaufrufen unterbrach, ein leeres Teilergebnis zurück, das nur den Unterbrechungshinweis enthielt.805* **Vordergrund**: Wenn ein Ratenlimit, eine Überlastung oder ein Serverfehler einen Subagenten unterbricht, der bereits Ausgaben erzeugt hat, gibt das Agent-Werkzeug diese Teilausgabe mit einem Hinweis zurück, dass der Subagent unterbrochen wurde und seine Aufgabe nicht abgeschlossen hat. Ein Subagent, der nichts erzeugt hat, oder dessen einzige Ausgabe Werkzeugaufrufe waren, schlägt mit [`Agent terminated early due to an API error`](/docs/de/errors#agent-terminated-early-due-to-an-api-error) fehl, gefolgt von der Fehlerdetail. In v2.1.199 gab ein Ratenlimit, eine Überlastung oder ein Serverfehler, der die Form nur mit Werkzeugaufrufen unterbrach, ein leeres Teilergebnis zurück, das nur den Unterbrechungshinweis enthielt.

806* **Hintergrund**: Der Subagent wird als fehlgeschlagen markiert, und die Nachricht, die Claude erhält, wenn er endet, nennt den API-Fehler und enthält die letzte Ausgabe des Subagenten, sodass Teilarbeit nicht verloren geht.806* **Hintergrund**: Der Subagent wird als fehlgeschlagen markiert, und die Nachricht, die Claude erhält, wenn er endet, nennt den API-Fehler und enthält die letzte Ausgabe des Subagenten, sodass Teilarbeit nicht verloren geht.

807 807

808Sobald der zugrunde liegende API-Fehler behoben ist, bitten Sie Claude, die Aufgabe zu wiederholen oder [setzen Sie den Subagenten fort](#resume-subagents).808Sobald der zugrunde liegende API-Fehler behoben ist, bitten Sie Claude, die Aufgabe zu wiederholen oder [setzen Sie den Subagenten fort](#resume-subagents).

837 Wenn Subagenten abgeschlossen sind, kehren ihre Ergebnisse zu Ihrer Hauptkonversation zurück. Das Ausführen vieler Subagenten, die jeweils detaillierte Ergebnisse zurückgeben, kann erheblichen Kontext verbrauchen.837 Wenn Subagenten abgeschlossen sind, kehren ihre Ergebnisse zu Ihrer Hauptkonversation zurück. Das Ausführen vieler Subagenten, die jeweils detaillierte Ergebnisse zurückgeben, kann erheblichen Kontext verbrauchen.

838</Warning>838</Warning>

839 839

840Für Aufgaben, die anhaltende Parallelität benötigen oder Ihr Kontextfenster überschreiten, geben [Agent-Teams](/de/agent-teams) jedem Worker seinen eigenen unabhängigen Kontext.840Für Aufgaben, die anhaltende Parallelität benötigen oder Ihr Kontextfenster überschreiten, geben [Agent-Teams](/docs/de/agent-teams) jedem Worker seinen eigenen unabhängigen Kontext.

841 841

842<h4 id="chain-subagents">842<h4 id="chain-subagents">

843 Verketten Sie Subagenten843 Verketten Sie Subagenten

866* Sie spezifische Werkzeugbeschränkungen oder Berechtigungen durchsetzen möchten866* Sie spezifische Werkzeugbeschränkungen oder Berechtigungen durchsetzen möchten

867* Die Arbeit in sich geschlossen ist und eine Zusammenfassung zurückgeben kann867* Die Arbeit in sich geschlossen ist und eine Zusammenfassung zurückgeben kann

868 868

869Erwägen Sie stattdessen [Skills](/de/skills), wenn Sie wiederverwendbare Prompts oder Workflows möchten, die im Kontext der Hauptkonversation ausgeführt werden, anstatt in isoliertem Subagenten-Kontext.869Erwägen Sie stattdessen [Skills](/docs/de/skills), wenn Sie wiederverwendbare Prompts oder Workflows möchten, die im Kontext der Hauptkonversation ausgeführt werden, anstatt in isoliertem Subagenten-Kontext.

870 870

871Für eine schnelle Frage zu etwas, das bereits in Ihrer Konversation ist, verwenden Sie stattdessen [`/btw`](/de/interactive-mode#side-questions-with-%2Fbtw). Es sieht Ihren vollständigen Kontext, hat aber keinen Werkzeugzugriff, und die Antwort wird verworfen, anstatt zur Historie hinzugefügt zu werden.871Für eine schnelle Frage zu etwas, das bereits in Ihrer Konversation ist, verwenden Sie stattdessen [`/btw`](/docs/de/interactive-mode#side-questions-with-%2Fbtw). Es sieht Ihren vollständigen Kontext, hat aber keinen Werkzeugzugriff, und die Antwort wird verworfen, anstatt zur Historie hinzugefügt zu werden.

872 872

873<h3 id="spawn-nested-subagents">873<h3 id="spawn-nested-subagents">

874 Spawnen Sie verschachtelte Subagenten874 Spawnen Sie verschachtelte Subagenten

875</h3>875</h3>

876 876

877{/* min-version: 2.1.172 */}Ab Claude Code v2.1.172 kann ein Subagent seine eigenen Subagenten spawnen. Verwenden Sie dies, wenn sich eine delegierte Aufgabe selbst in parallele Unteraufgaben aufteilt, z. B. ein Reviewer-Subagent, der einen Verifier pro Befund versendet, sodass die Zwischenausgabe niemals Ihre Hauptkonversation erreicht. Nur die Zusammenfassung des Top-Level-Subagenten kehrt zu Ihnen zurück.877Ab Claude Code v2.1.172 kann ein Subagent seine eigenen Subagenten spawnen. Verwenden Sie dies, wenn sich eine delegierte Aufgabe selbst in parallele Unteraufgaben aufteilt, z. B. ein Reviewer-Subagent, der einen Verifier pro Befund versendet, sodass die Zwischenausgabe niemals Ihre Hauptkonversation erreicht. Nur die Zusammenfassung des Top-Level-Subagenten kehrt zu Ihnen zurück.

878 878

879Ein verschachtelter Subagent wird genauso konfiguriert wie ein Top-Level-Subagent und wird aus denselben [Scopes](#choose-the-subagent-scope) aufgelöst.879Ein verschachtelter Subagent wird genauso konfiguriert wie ein Top-Level-Subagent und wird aus denselben [Scopes](#choose-the-subagent-scope) aufgelöst.

880 880

881Das Subagenten-Panel unter der Eingabeaufforderung zeigt den vollständigen Baum: Jede Zeile zeigt eine `(+N)`-Anzahl von Nachkommen an, und {/* min-version: 2.1.193 */}ab v2.1.193 zeigt das Öffnen einer Zeile die Geschwister und direkten Kinder dieses Subagenten mit einem Pfad zurück zu `main`.881Das Subagenten-Panel unter der Eingabeaufforderung zeigt den vollständigen Baum: Jede Zeile zeigt eine `(+N)`-Anzahl von Nachkommen an, und ab v2.1.193 zeigt das Öffnen einer Zeile die Geschwister und direkten Kinder dieses Subagenten mit einem Pfad zurück zu `main`.

882 882

883Die Tiefe wird als die Anzahl der Subagenten-Ebenen unter der Hauptkonversation gezählt, unabhängig davon, ob jede Ebene im [Vordergrund oder Hintergrund](#run-subagents-in-foreground-or-background) ausgeführt wird. Ein Subagent in Tiefe fünf erhält das Agent-Werkzeug nicht und kann nicht weiter spawnen. Das Limit ist fest und nicht konfigurierbar.883Die Tiefe wird als die Anzahl der Subagenten-Ebenen unter der Hauptkonversation gezählt, unabhängig davon, ob jede Ebene im [Vordergrund oder Hintergrund](#run-subagents-in-foreground-or-background) ausgeführt wird. Ein Subagent in Tiefe fünf erhält das Agent-Werkzeug nicht und kann nicht weiter spawnen. Das Limit ist fest und nicht konfigurierbar.

884 884

902 902

903* **Systemprompt**: Der eigene Prompt des Agenten plus Umgebungsdetails, die Claude Code anhängt, nicht der vollständige Claude Code-Systemprompt. Benutzerdefinierte Subagenten definieren ihren in der [Markdown-Datei](#write-subagent-files) oder im `prompt`-Feld. Integrierte Agenten haben vordefinierte Prompts.903* **Systemprompt**: Der eigene Prompt des Agenten plus Umgebungsdetails, die Claude Code anhängt, nicht der vollständige Claude Code-Systemprompt. Benutzerdefinierte Subagenten definieren ihren in der [Markdown-Datei](#write-subagent-files) oder im `prompt`-Feld. Integrierte Agenten haben vordefinierte Prompts.

904* **Task-Nachricht**: Der Delegierungsprompt, den Claude schreibt, wenn er die Arbeit übergibt.904* **Task-Nachricht**: Der Delegierungsprompt, den Claude schreibt, wenn er die Arbeit übergibt.

905* **CLAUDE.md und Memory**: Jede Ebene der [Memory-Hierarchie](/de/memory#how-claude-md-files-load), die die Hauptkonversation lädt, einschließlich `~/.claude/CLAUDE.md`, Projektregeln, `CLAUDE.local.md` und verwaltete Richtliniendateien. Die integrierten Explore- und Plan-Agenten überspringen dies.905* **CLAUDE.md und Memory**: Jede Ebene der [Memory-Hierarchie](/docs/de/memory#how-claude-md-files-load), die die Hauptkonversation lädt, einschließlich `~/.claude/CLAUDE.md`, Projektregeln, `CLAUDE.local.md` und verwaltete Richtliniendateien. Die integrierten Explore- und Plan-Agenten überspringen dies.

906* **Git-Status**: Ein Snapshot, der zu Beginn der übergeordneten Sitzung erstellt wurde. Fehlt, wenn das Arbeitsverzeichnis kein Git-Repository ist oder wenn [`includeGitInstructions`](/de/settings#available-settings) `false` ist. Explore und Plan überspringen es unabhängig davon.906* **Git-Status**: Ein Snapshot, der zu Beginn der übergeordneten Sitzung erstellt wurde. Fehlt, wenn das Arbeitsverzeichnis kein Git-Repository ist oder wenn [`includeGitInstructions`](/docs/de/settings#available-settings) `false` ist. Explore und Plan überspringen es unabhängig davon.

907* **Vorgeladene Skills**: Vollständiger Inhalt aller Skills, die im [`skills`-Feld](#preload-skills-into-subagents) des Agenten benannt sind. Integrierte Agenten laden Skills nicht vor.907* **Vorgeladene Skills**: Vollständiger Inhalt aller Skills, die im [`skills`-Feld](#preload-skills-into-subagents) des Agenten benannt sind. Integrierte Agenten laden Skills nicht vor.

908* **Geschwister-Verzeichnis**: Eine Systemerinnerung, die `main` und jeden anderen benannten Agenten in der Sitzung auflistet, jeweils ein gültiger `to`-Wert für [`SendMessage`](#resume-subagents). {/* min-version: 2.1.206 */}Erfordert Claude Code v2.1.206 oder später. Das Verzeichnis erscheint nur, wenn die Tools des Subagenten `SendMessage` enthalten und mindestens ein anderer Agent einen Namen hat, ob Claude ihn beim Spawnen benannt hat oder er als [Agent-Team](/de/agent-teams)-Teamkollege läuft. Es ist ein Snapshot, der erstellt wird, wenn der Subagent startet, daher erscheinen später benannte Agenten nicht.908* **Geschwister-Verzeichnis**: Eine Systemerinnerung, die `main` und jeden anderen benannten Agenten in der Sitzung auflistet, jeweils ein gültiger `to`-Wert für [`SendMessage`](#resume-subagents). Erfordert Claude Code v2.1.206 oder später. Das Verzeichnis erscheint nur, wenn die Tools des Subagenten `SendMessage` enthalten und mindestens ein anderer Agent einen Namen hat, ob Claude ihn beim Spawnen benannt hat oder er als [Agent-Team](/docs/de/agent-teams)-Teamkollege läuft. Es ist ein Snapshot, der erstellt wird, wenn der Subagent startet, daher erscheinen später benannte Agenten nicht.

909 909

910Explore und Plan sind die einzigen Subagenten, die CLAUDE.md und Git-Status auslassen. Es gibt kein Frontmatter-Feld oder eine Pro-Agent-Einstellung, um zu ändern, welche Agenten sie überspringen.910Explore und Plan sind die einzigen Subagenten, die CLAUDE.md und Git-Status auslassen. Es gibt kein Frontmatter-Feld oder eine Pro-Agent-Einstellung, um zu ändern, welche Agenten sie überspringen.

911 911

921 921

922Wenn ein Subagent abgeschlossen ist, erhält Claude seine Agent-ID. Die integrierten Explore- und Plan-Agenten sind einmalig und geben keine Agent-ID zurück, daher können sie nicht fortgesetzt werden; verwenden Sie `general-purpose` oder einen benutzerdefinierten Subagenten, wenn Sie die Arbeit fortsetzen müssen.922Wenn ein Subagent abgeschlossen ist, erhält Claude seine Agent-ID. Die integrierten Explore- und Plan-Agenten sind einmalig und geben keine Agent-ID zurück, daher können sie nicht fortgesetzt werden; verwenden Sie `general-purpose` oder einen benutzerdefinierten Subagenten, wenn Sie die Arbeit fortsetzen müssen.

923 923

924Claude verwendet das `SendMessage`-Werkzeug mit der Agent-ID oder dem Namen des Agenten als `to`-Feld, um ihn fortzusetzen. `SendMessage` erfordert nicht, dass [Agent-Teams](/de/agent-teams) aktiviert sind; nur strukturierte Team-Protokoll-Nachrichten wie `shutdown_request` und `plan_approval_response` erfordern dies.924Claude verwendet das `SendMessage`-Werkzeug mit der Agent-ID oder dem Namen des Agenten als `to`-Feld, um ihn fortzusetzen. `SendMessage` erfordert nicht, dass [Agent-Teams](/docs/de/agent-teams) aktiviert sind; nur strukturierte Team-Protokoll-Nachrichten wie `shutdown_request` und `plan_approval_response` erfordern dies.

925 925

926Um einen Subagenten fortzusetzen, bitten Sie Claude, die vorherige Arbeit fortzusetzen:926Um einen Subagenten fortzusetzen, bitten Sie Claude, die vorherige Arbeit fortzusetzen:

927 927

935 935

936Ein gestoppter Subagent, der eine `SendMessage` erhält, wird automatisch im Hintergrund fortgesetzt, ohne dass eine neue `Agent`-Invokation erforderlich ist. Das Gleiche gilt für einen Subagenten, den Claude mit dem `TaskStop`-Werkzeug gestoppt hat.936Ein gestoppter Subagent, der eine `SendMessage` erhält, wird automatisch im Hintergrund fortgesetzt, ohne dass eine neue `Agent`-Invokation erforderlich ist. Das Gleiche gilt für einen Subagenten, den Claude mit dem `TaskStop`-Werkzeug gestoppt hat.

937 937

938{/* min-version: 2.1.191 */}Ab v2.1.191 wird ein Subagent, den Sie selbst gestoppt haben, mit `x` in `/tasks` oder einer SDK-`stop_task`-Anfrage, nicht automatisch fortgesetzt. Der `SendMessage`-Aufruf gibt eine Ablehnung zurück, die Claude mitteilt, dass der Agent abgebrochen wurde. Geben Sie in das Transkript dieses Subagenten im Subagenten-Panel ein, um ihn selbst fortzusetzen, was den Stop löscht, damit spätere `SendMessage`-Aufrufe ihn wieder automatisch fortsetzen können.938Ab v2.1.191 wird ein Subagent, den Sie selbst gestoppt haben, mit `x` in `/tasks` oder einer SDK-`stop_task`-Anfrage, nicht automatisch fortgesetzt. Der `SendMessage`-Aufruf gibt eine Ablehnung zurück, die Claude mitteilt, dass der Agent abgebrochen wurde. Geben Sie in das Transkript dieses Subagenten im Subagenten-Panel ein, um ihn selbst fortzusetzen, was den Stop löscht, damit spätere `SendMessage`-Aufrufe ihn wieder automatisch fortsetzen können.

939 939

940Das Fortsetzen startet einen neuen Lauf des Agenten unter derselben ID, sodass ein Subagent, der bereits fehlgeschlagen oder abgeschlossen war, in der Aufgabenliste und in den Task-Events des Agent SDK wieder als laufend angezeigt wird. Vor v2.1.205 zeigte er seinen früheren fehlgeschlagenen oder abgeschlossenen Status, während der fortgesetzte Lauf funktionierte.940Das Fortsetzen startet einen neuen Lauf des Agenten unter derselben ID, sodass ein Subagent, der bereits fehlgeschlagen oder abgeschlossen war, in der Aufgabenliste und in den Task-Events des Agent SDK wieder als laufend angezeigt wird. Vor v2.1.205 zeigte er seinen früheren fehlgeschlagenen oder abgeschlossenen Status, während der fortgesetzte Lauf funktionierte.

941 941

942{/* min-version: 2.1.199 */}Ab v2.1.199 überprüft `SendMessage`, dass ein Name immer noch auf denselben Agenten verweist, den er früher in der Konversation erreicht hat. Wenn ein neuerer Agent den Namen übernommen hat, z. B. ein neu gestarteter Hintergrund-Agent, der ihn wiederverwendet hat, weigert sich Claude Code, die Nachricht zu senden, anstatt sie an den falschen Agenten zu liefern, und der Fehler meldet, welchen Agenten der Name jetzt erreicht, damit Claude neu ausrichten kann. Um den früheren Agenten zu erreichen, während er noch läuft, adressiert Claude ihn nach der Agent-ID aus seinem Spawn-Ergebnis. Die Überprüfung ist auf die aktuelle Konversation beschränkt und wird bei `/clear` zurückgesetzt.942Ab v2.1.199 überprüft `SendMessage`, dass ein Name immer noch auf denselben Agenten verweist, den er früher in der Konversation erreicht hat. Wenn ein neuerer Agent den Namen übernommen hat, z. B. ein neu gestarteter Hintergrund-Agent, der ihn wiederverwendet hat, weigert sich Claude Code, die Nachricht zu senden, anstatt sie an den falschen Agenten zu liefern, und der Fehler meldet, welchen Agenten der Name jetzt erreicht, damit Claude neu ausrichten kann. Um den früheren Agenten zu erreichen, während er noch läuft, adressiert Claude ihn nach der Agent-ID aus seinem Spawn-Ergebnis. Die Überprüfung ist auf die aktuelle Konversation beschränkt und wird bei `/clear` zurückgesetzt.

943 943

944{/* min-version: 2.1.198 */}Ab v2.1.198 behandelt ein Subagent Nachrichten vom Agenten, der ihn gestartet hat, als normale Aufgabenrichtung, einschließlich Kurskorrektionen während der Aufgabe, und handelt danach innerhalb seiner eigenen Berechtigungseinstellungen. Zwei Limits gelten immer noch unabhängig davon, wer die Nachricht gesendet hat: Keine Nachricht von einem Agenten zählt als Ihre Genehmigung für eine ausstehende Berechtigungsaufforderung, und keine Agent-Nachricht kann die Berechtigungseinstellungen, `CLAUDE.md` oder Konfiguration eines Subagenten ändern. Nur das Berechtigungssystem oder Ihre eigenen Nachrichten können Genehmigung gewähren.944Ab v2.1.198 behandelt ein Subagent Nachrichten vom Agenten, der ihn gestartet hat, als normale Aufgabenrichtung, einschließlich Kurskorrektionen während der Aufgabe, und handelt danach innerhalb seiner eigenen Berechtigungseinstellungen. Zwei Limits gelten immer noch unabhängig davon, wer die Nachricht gesendet hat: Keine Nachricht von einem Agenten zählt als Ihre Genehmigung für eine ausstehende Berechtigungsaufforderung, und keine Agent-Nachricht kann die Berechtigungseinstellungen, `CLAUDE.md` oder Konfiguration eines Subagenten ändern. Nur das Berechtigungssystem oder Ihre eigenen Nachrichten können Genehmigung gewähren.

945 945

946Sie können auch Claude nach der Agent-ID fragen, wenn Sie sie explizit referenzieren möchten, oder IDs in den Transkriptdateien unter `~/.claude/projects/{project}/{sessionId}/subagents/` finden. Jedes Transkript wird als `agent-{agentId}.jsonl` gespeichert.946Sie können auch Claude nach der Agent-ID fragen, wenn Sie sie explizit referenzieren möchten, oder IDs in den Transkriptdateien unter `~/.claude/projects/{project}/{sessionId}/subagents/` finden. Jedes Transkript wird als `agent-{agentId}.jsonl` gespeichert.

947 947

955 Auto-Komprimierung955 Auto-Komprimierung

956</h4>956</h4>

957 957

958Subagenten unterstützen automatische Komprimierung mit derselben Logik wie die Hauptkonversation. Die Komprimierung wird unter denselben Bedingungen ausgelöst, und `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` gilt auch für Subagenten. Siehe [Umgebungsvariablen](/de/env-vars) für den Zeitpunkt, zu dem die Überschreibung wirksam wird.958Subagenten unterstützen automatische Komprimierung mit derselben Logik wie die Hauptkonversation. Die Komprimierung wird unter denselben Bedingungen ausgelöst, und `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` gilt auch für Subagenten. Siehe [Umgebungsvariablen](/docs/de/env-vars) für den Zeitpunkt, zu dem die Überschreibung wirksam wird.

959 959

960Komprimierungsereignisse werden in Subagenten-Transkriptdateien protokolliert:960Komprimierungsereignisse werden in Subagenten-Transkriptdateien protokolliert:

961 961

977</h2>977</h2>

978 978

979<Note>979<Note>

980 Gegabelte Subagenten erfordern Claude Code v2.1.117 oder später. {/* min-version: 2.1.161 */}Ab v2.1.161 ist der `/fork`-Befehl standardmäßig aktiviert; in früheren Versionen ist die Umgebungsvariable [`CLAUDE_CODE_FORK_SUBAGENT`](/de/env-vars) auf `1` erforderlich. Das Spawning von Forks durch Claude selbst ist experimentell und kann sich in zukünftigen Versionen ändern. Diese Funktion kann auch in interaktiven Sitzungen als Teil eines gestaffelten Rollouts aktiviert werden.980 Gegabelte Subagenten erfordern Claude Code v2.1.117 oder später. Ab v2.1.161 ist der `/fork`-Befehl standardmäßig aktiviert; in früheren Versionen ist die Umgebungsvariable [`CLAUDE_CODE_FORK_SUBAGENT`](/docs/de/env-vars) auf `1` erforderlich. Das Spawning von Forks durch Claude selbst ist experimentell und kann sich in zukünftigen Versionen ändern. Diese Funktion kann auch in interaktiven Sitzungen als Teil eines gestaffelten Rollouts aktiviert werden.

981</Note>981</Note>

982 982

983Ein Fork ist ein Subagent, der die gesamte bisherige Konversation erbt, anstatt von vorne zu beginnen. Dies lässt die Eingabe-Isolierung fallen, die Subagenten ansonsten bieten: Ein Fork sieht denselben Systemprompt, dieselben Werkzeuge, dasselbe Modell und die Nachrichtenhistorie wie die Hauptsitzung, sodass Sie ihm eine Nebenaufgabe übergeben können, ohne die Situation erneut zu erklären. Die eigenen Werkzeugaufrufe des Forks bleiben weiterhin aus Ihrer Konversation heraus und nur sein endgültiges Ergebnis kommt zurück, sodass Ihr Hauptkontextfenster sauber bleibt. Verwenden Sie einen Fork, wenn ein benannter Subagent zu viel Hintergrund benötigen würde, um nützlich zu sein, oder wenn Sie mehrere Ansätze parallel vom gleichen Ausgangspunkt aus versuchen möchten.983Ein Fork ist ein Subagent, der die gesamte bisherige Konversation erbt, anstatt von vorne zu beginnen. Dies lässt die Eingabe-Isolierung fallen, die Subagenten ansonsten bieten: Ein Fork sieht denselben Systemprompt, dieselben Werkzeuge, dasselbe Modell und die Nachrichtenhistorie wie die Hauptsitzung, sodass Sie ihm eine Nebenaufgabe übergeben können, ohne die Situation erneut zu erklären. Die eigenen Werkzeugaufrufe des Forks bleiben weiterhin aus Ihrer Konversation heraus und nur sein endgültiges Ergebnis kommt zurück, sodass Ihr Hauptkontextfenster sauber bleibt. Verwenden Sie einen Fork, wenn ein benannter Subagent zu viel Hintergrund benötigen würde, um nützlich zu sein, oder wenn Sie mehrere Ansätze parallel vom gleichen Ausgangspunkt aus versuchen möchten.

984 984

985Um den Fork-Modus unabhängig vom gestaffelten Rollout zu steuern, setzen Sie [`CLAUDE_CODE_FORK_SUBAGENT`](/de/env-vars) auf `1`, um ihn explizit zu aktivieren, oder auf `0`, um ihn zu deaktivieren. Die Variable wird im interaktiven Modus und über das SDK oder `claude -p` berücksichtigt.985Um den Fork-Modus unabhängig vom gestaffelten Rollout zu steuern, setzen Sie [`CLAUDE_CODE_FORK_SUBAGENT`](/docs/de/env-vars) auf `1`, um ihn explizit zu aktivieren, oder auf `0`, um ihn zu deaktivieren. Die Variable wird im interaktiven Modus und über das SDK oder `claude -p` berücksichtigt.

986 986

987Das Aktivieren des Fork-Modus ändert Claude Code auf zwei Arten:987Das Aktivieren des Fork-Modus ändert Claude Code auf zwei Arten:

988 988

1010| `x` | Schließen Sie einen fertigen Fork oder stoppen Sie einen laufenden |1010| `x` | Schließen Sie einen fertigen Fork oder stoppen Sie einen laufenden |

1011| `Esc` | Fokus zurück zur Eingabeaufforderung |1011| `Esc` | Fokus zurück zur Eingabeaufforderung |

1012 1012

1013Mit einem geöffneten Transkript eines Forks oder Subagenten gehen Folgefragen und [Skills](/de/skills) an diesen Agenten, aber integrierte Befehle werden weiterhin in Ihrer Hauptkonversation ausgeführt. {/* min-version: 2.1.199 */}Ab v2.1.199 zeigt die Eingabe von `/model` oder `/fast` in dieser Ansicht einen Hinweis an, dass dies das Modell oder den Schnellmodus der Hauptkonversation ändert, nicht des angezeigten Agenten, anstatt es stillschweigend auszuführen.1013Mit einem geöffneten Transkript eines Forks oder Subagenten gehen Folgefragen und [Skills](/docs/de/skills) an diesen Agenten, aber integrierte Befehle werden weiterhin in Ihrer Hauptkonversation ausgeführt. Ab v2.1.199 zeigt die Eingabe von `/model` oder `/fast` in dieser Ansicht einen Hinweis an, dass dies das Modell oder den Schnellmodus der Hauptkonversation ändert, nicht des angezeigten Agenten, anstatt es stillschweigend auszuführen.

1014 1014

1015<h3 id="how-forks-differ-from-named-subagents">1015<h3 id="how-forks-differ-from-named-subagents">

1016 Wie sich Forks von benannten Subagenten unterscheiden1016 Wie sich Forks von benannten Subagenten unterscheiden

1026| Berechtigungen | Aufforderungen erscheinen in Ihrem Terminal | [Aufforderungen erscheinen in Ihrer Hauptsitzung](#run-subagents-in-foreground-or-background) bei Ausführung im Hintergrund |1026| Berechtigungen | Aufforderungen erscheinen in Ihrem Terminal | [Aufforderungen erscheinen in Ihrer Hauptsitzung](#run-subagents-in-foreground-or-background) bei Ausführung im Hintergrund |

1028 1028

1029Da der Systemprompt und die Werkzeugdefinitionen eines Forks identisch mit dem übergeordneten Element sind, wird seine erste Anfrage den [Prompt-Cache](/de/prompt-caching#subagents-and-the-cache) des übergeordneten Elements wiederverwenden. Dies macht das Forking billiger als das Spawnen eines frischen Subagenten für Aufgaben, die denselben Kontext benötigen.1029Da der Systemprompt und die Werkzeugdefinitionen eines Forks identisch mit dem übergeordneten Element sind, wird seine erste Anfrage den [Prompt-Cache](/docs/de/prompt-caching#subagents-and-the-cache) des übergeordneten Elements wiederverwenden. Dies macht das Forking billiger als das Spawnen eines frischen Subagenten für Aufgaben, die denselben Kontext benötigen.

1030 1030

1031Wenn Claude einen Fork durch das Agent-Werkzeug spawnt, kann es `isolation: "worktree"` übergeben, sodass die Dateibearbeitungen des Forks in einen separaten Git-Worktree geschrieben werden, anstatt in Ihren Checkout.1031Wenn Claude einen Fork durch das Agent-Werkzeug spawnt, kann es `isolation: "worktree"` übergeben, sodass die Dateibearbeitungen des Forks in einen separaten Git-Worktree geschrieben werden, anstatt in Ihren Checkout.

1032 1032

1034 Einschränkungen1034 Einschränkungen

1035</h3>1035</h3>

1036 1036

1037Das Setzen von `CLAUDE_CODE_FORK_SUBAGENT=1` aktiviert den Fork-Modus in interaktiven Sitzungen, im [nicht-interaktiven Modus](/de/headless) und im Agent SDK; das Setzen auf `0` deaktiviert den Fork-Modus überall, einschließlich jedes serverseitigen Rollouts. Ein Fork kann keine weiteren Forks spawnen.1037Das Setzen von `CLAUDE_CODE_FORK_SUBAGENT=1` aktiviert den Fork-Modus in interaktiven Sitzungen, im [nicht-interaktiven Modus](/docs/de/headless) und im Agent SDK; das Setzen auf `0` deaktiviert den Fork-Modus überall, einschließlich jedes serverseitigen Rollouts. Ein Fork kann keine weiteren Forks spawnen.

1038 1038

1039<h2 id="example-subagents">1039<h2 id="example-subagents">

1040 Beispiel-Subagenten1040 Beispiel-Subagenten

1197You cannot modify data. If asked to INSERT, UPDATE, DELETE, or modify schema, explain that you only have read access.1197You cannot modify data. If asked to INSERT, UPDATE, DELETE, or modify schema, explain that you only have read access.

1198```1198```

1199 1199

1200Claude Code [übergibt Hook-Eingabe als JSON](/de/hooks#pretooluse-input) über stdin an Hook-Befehle. Das Validierungsskript liest dieses JSON, extrahiert den auszuführenden Befehl und prüft ihn gegen eine Liste von SQL-Schreibvorgängen. Wenn ein Schreibvorgang erkannt wird, [beendet das Skript mit Code 2](/de/hooks#exit-code-2-behavior-per-event), um die Ausführung zu blockieren, und gibt eine Fehlermeldung an Claude über stderr zurück.1200Claude Code [übergibt Hook-Eingabe als JSON](/docs/de/hooks#pretooluse-input) über stdin an Hook-Befehle. Das Validierungsskript liest dieses JSON, extrahiert den auszuführenden Befehl und prüft ihn gegen eine Liste von SQL-Schreibvorgängen. Wenn ein Schreibvorgang erkannt wird, [beendet das Skript mit Code 2](/docs/de/hooks#exit-code-2-behavior-per-event), um die Ausführung zu blockieren, und gibt eine Fehlermeldung an Claude über stderr zurück.

1201 1201

1202Erstellen Sie das Validierungsskript überall in Ihrem Projekt. Der Pfad muss dem `command`-Feld in Ihrer Hook-Konfiguration entsprechen:1202Erstellen Sie das Validierungsskript überall in Ihrem Projekt. Der Pfad muss dem `command`-Feld in Ihrer Hook-Konfiguration entsprechen:

1203 1203

1230chmod +x ./scripts/validate-readonly-query.sh1230chmod +x ./scripts/validate-readonly-query.sh

1231```1231```

1232 1232

1233Unter Windows schreiben Sie das Validierungsskript in PowerShell und fügen `shell: powershell` zum Hook-Eintrag hinzu. Siehe [Hooks in PowerShell ausführen](/de/hooks#windows-powershell-tool).1233Unter Windows schreiben Sie das Validierungsskript in PowerShell und fügen `shell: powershell` zum Hook-Eintrag hinzu. Siehe [Hooks in PowerShell ausführen](/docs/de/hooks#windows-powershell-tool).

1234 1234

1235Der Hook empfängt JSON über stdin mit dem Bash-Befehl in `tool_input.command`. Exit-Code 2 blockiert die Operation und leitet die Fehlermeldung an Claude weiter. Siehe [Hooks](/de/hooks#exit-code-output) für Details zu Exit-Codes und [Hook-Eingabe](/de/hooks#pretooluse-input) für das vollständige Eingabeschema.1235Der Hook empfängt JSON über stdin mit dem Bash-Befehl in `tool_input.command`. Exit-Code 2 blockiert die Operation und leitet die Fehlermeldung an Claude weiter. Siehe [Hooks](/docs/de/hooks#exit-code-output) für Details zu Exit-Codes und [Hook-Eingabe](/docs/de/hooks#pretooluse-input) für das vollständige Eingabeschema.

1236 1236

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

1238 Nächste Schritte1238 Nächste Schritte

1240 1240

1241Jetzt, da Sie Subagenten verstehen, erkunden Sie diese verwandten Funktionen:1241Jetzt, da Sie Subagenten verstehen, erkunden Sie diese verwandten Funktionen:

1242 1242

1243* [Verteilen Sie Subagenten mit Plugins](/de/plugins), um Subagenten über Teams oder Projekte hinweg zu teilen1243* [Verteilen Sie Subagenten mit Plugins](/docs/de/plugins), um Subagenten über Teams oder Projekte hinweg zu teilen

1244* [Führen Sie Claude Code programmgesteuert aus](/de/headless) mit dem Agent SDK für CI/CD und Automatisierung1244* [Führen Sie Claude Code programmgesteuert aus](/docs/de/headless) mit dem Agent SDK für CI/CD und Automatisierung

1245* [Verwenden Sie MCP-Server](/de/mcp), um Subagenten Zugriff auf externe Werkzeuge und Daten zu geben1245* [Verwenden Sie MCP-Server](/docs/de/mcp), um Subagenten Zugriff auf externe Werkzeuge und Daten zu geben

tools-reference.md +76 −76

Details

6 6

7> Vollständige Referenz für die Werkzeuge, die Claude Code verwenden kann, einschließlich Berechtigungsanforderungen und Verhalten pro Werkzeug.7> Vollständige Referenz für die Werkzeuge, die Claude Code verwenden kann, einschließlich Berechtigungsanforderungen und Verhalten pro Werkzeug.

8 8

9Claude Code hat Zugriff auf eine Reihe von integrierten Werkzeugen, die ihm helfen, Ihre Codebasis zu verstehen und zu ändern. Die Werkzeugnamen sind die genauen Zeichenketten, die Sie in [Berechtigungsregeln](/de/permissions#tool-specific-permission-rules), [Subagent-Werkzeuglisten](/de/sub-agents) und [Hook-Matchern](/de/hooks) verwenden. Um ein Werkzeug vollständig zu deaktivieren, fügen Sie seinen Namen zum `deny`-Array in Ihren [Berechtigungseinstellungen](/de/permissions#tool-specific-permission-rules) hinzu.9Claude Code hat Zugriff auf eine Reihe von integrierten Werkzeugen, die ihm helfen, Ihre Codebasis zu verstehen und zu ändern. Die Werkzeugnamen sind die genauen Zeichenketten, die Sie in [Berechtigungsregeln](/docs/de/permissions#tool-specific-permission-rules), [Subagent-Werkzeuglisten](/docs/de/sub-agents) und [Hook-Matchern](/docs/de/hooks) verwenden. Um ein Werkzeug vollständig zu deaktivieren, fügen Sie seinen Namen zum `deny`-Array in Ihren [Berechtigungseinstellungen](/docs/de/permissions#tool-specific-permission-rules) hinzu.

10 10

11Um benutzerdefinierte Werkzeuge hinzuzufügen, verbinden Sie einen [MCP-Server](/de/mcp). Um Claude mit wiederverwendbaren Prompt-basierten Workflows zu erweitern, schreiben Sie einen [Skill](/de/skills), der über das vorhandene `Skill`-Werkzeug ausgeführt wird, anstatt einen neuen Werkzeugeintrag hinzuzufügen.11Um benutzerdefinierte Werkzeuge hinzuzufügen, verbinden Sie einen [MCP-Server](/docs/de/mcp). Um Claude mit wiederverwendbaren Prompt-basierten Workflows zu erweitern, schreiben Sie einen [Skill](/docs/de/skills), der über das vorhandene `Skill`-Werkzeug ausgeführt wird, anstatt einen neuen Werkzeugeintrag hinzuzufügen.

12 12

13Die Spalte „Berechtigung erforderlich" zeigt, ob das Werkzeug im Standard-Berechtigungsmodus für Pfade innerhalb des Arbeitsverzeichnisses auffordert. Dateizugriffswerkzeuge, die mit „Nein" gekennzeichnet sind, einschließlich `Read`, `Grep` und `Glob`, fordern weiterhin für Pfade außerhalb des [Arbeitsverzeichnisses und zusätzlicher Verzeichnisse](/de/permissions#working-directories) auf. `Bash` ist mit „Ja" gekennzeichnet, führt aber einen integrierten Satz von [schreibgeschützten Befehlen](/de/permissions#read-only-commands) ohne Aufforderung aus.13Die Spalte „Berechtigung erforderlich" zeigt, ob das Werkzeug im Standard-Berechtigungsmodus für Pfade innerhalb des Arbeitsverzeichnisses auffordert. Dateizugriffswerkzeuge, die mit „Nein" gekennzeichnet sind, einschließlich `Read`, `Grep` und `Glob`, fordern weiterhin für Pfade außerhalb des [Arbeitsverzeichnisses und zusätzlicher Verzeichnisse](/docs/de/permissions#working-directories) auf. `Bash` ist mit „Ja" gekennzeichnet, führt aber einen integrierten Satz von [schreibgeschützten Befehlen](/docs/de/permissions#read-only-commands) ohne Aufforderung aus.

14 14

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

17| `Agent` | Erzeugt einen [Subagenten](/de/sub-agents) mit eigenem Kontextfenster zur Bewältigung einer Aufgabe. Siehe [Agent-Werkzeugverhalten](#agent-tool-behavior) | Nein |17| `Agent` | Erzeugt einen [Subagenten](/docs/de/sub-agents) mit eigenem Kontextfenster zur Bewältigung einer Aufgabe. Siehe [Agent-Werkzeugverhalten](#agent-tool-behavior) | Nein |

18| `Artifact` | Veröffentlicht eine HTML- oder Markdown-Datei als [Artefakt](/de/artifacts): eine private, interaktive Seite auf claude.ai. Sie können diese in Ihrer Organisation freigeben, oder auf Team- und Enterprise-Plänen öffentlich freigeben, wofür ein Eigentümer dies [aktivieren](/de/artifacts#control-public-sharing) muss. {/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Erfordert einen Pro-, Max-, Team- oder Enterprise-Plan und `/login`-Authentifizierung; siehe [Verfügbarkeit](/de/artifacts#availability) | Ja |18| `Artifact` | Veröffentlicht eine HTML- oder Markdown-Datei als [Artefakt](/docs/de/artifacts): eine private, interaktive Seite auf claude.ai. Sie können diese in Ihrer Organisation freigeben, oder auf Team- und Enterprise-Plänen öffentlich freigeben, wofür ein Eigentümer dies [aktivieren](/docs/de/artifacts#control-public-sharing) muss. Erfordert einen Pro-, Max-, Team- oder Enterprise-Plan und `/login`-Authentifizierung; siehe [Verfügbarkeit](/docs/de/artifacts#availability) | Ja |

19| `AskUserQuestion` | Stellt Multiple-Choice-Fragen, um Anforderungen zu sammeln oder Mehrdeutigkeiten zu klären. {/* min-version: 2.1.200 */}Fragen bleiben offen, bis Sie sie beantworten: Es gibt standardmäßig kein Idle-Timeout. Um einen Idle-Dialog stattdessen automatisch fortzusetzen, setzen Sie die Einstellung [`askUserQuestionTimeout`](/de/settings#available-settings) auf `60s`, `5m` oder `10m`, entweder in Ihrer Benutzer-`settings.json` oder in der Zeile **Question auto-continue timeout** in `/config`. Sobald die gewählte Idle-Zeit ohne Eingabe verstrichen ist, schließt sich der Dialog von selbst: Er sendet alle Optionen, die Sie bereits ausgewählt haben, und teilt Claude mit, dass Sie möglicherweise weg von Ihrer Tastatur sind, damit Claude nach eigenem Ermessen fortfährt und später erneut fragen kann. Ein Countdown wird in den letzten 20 Sekunden angezeigt. Jeder Tastendruck setzt den Timer zurück, ebenso wie ein fokussiertes Fenster auf Terminals, die Fokus melden. Das Timeout gilt nur für die Multiple-Choice-Fragen von `AskUserQuestion`; Berechtigungsaufforderungen, einschließlich Planbestätigung, werden bei Untätigkeit nie automatisch aufgelöst. In v2.1.198 und v2.1.199 wurde der Dialog standardmäßig nach 60 Sekunden Untätigkeit automatisch fortgesetzt, und [`CLAUDE_AFK_TIMEOUT_MS`](/de/env-vars#variables) war die einzige Möglichkeit, dies zu ändern | Nein |19| `AskUserQuestion` | Stellt Multiple-Choice-Fragen, um Anforderungen zu sammeln oder Mehrdeutigkeiten zu klären. Fragen bleiben offen, bis Sie sie beantworten: Es gibt standardmäßig kein Idle-Timeout. Um einen Idle-Dialog stattdessen automatisch fortzusetzen, setzen Sie die Einstellung [`askUserQuestionTimeout`](/docs/de/settings#available-settings) auf `60s`, `5m` oder `10m`, entweder in Ihrer Benutzer-`settings.json` oder in der Zeile **Question auto-continue timeout** in `/config`. Sobald die gewählte Idle-Zeit ohne Eingabe verstrichen ist, schließt sich der Dialog von selbst: Er sendet alle Optionen, die Sie bereits ausgewählt haben, und teilt Claude mit, dass Sie möglicherweise weg von Ihrer Tastatur sind, damit Claude nach eigenem Ermessen fortfährt und später erneut fragen kann. Ein Countdown wird in den letzten 20 Sekunden angezeigt. Jeder Tastendruck setzt den Timer zurück, ebenso wie ein fokussiertes Fenster auf Terminals, die Fokus melden. Das Timeout gilt nur für die Multiple-Choice-Fragen von `AskUserQuestion`; Berechtigungsaufforderungen, einschließlich Planbestätigung, werden bei Untätigkeit nie automatisch aufgelöst. In v2.1.198 und v2.1.199 wurde der Dialog standardmäßig nach 60 Sekunden Untätigkeit automatisch fortgesetzt, und [`CLAUDE_AFK_TIMEOUT_MS`](/docs/de/env-vars#variables) war die einzige Möglichkeit, dies zu ändern | Nein |

20| `Bash` | Führt Shell-Befehle in Ihrer Umgebung aus. Siehe [Bash-Werkzeugverhalten](#bash-tool-behavior) | Ja |20| `Bash` | Führt Shell-Befehle in Ihrer Umgebung aus. Siehe [Bash-Werkzeugverhalten](#bash-tool-behavior) | Ja |

21| `CronCreate` | Plant eine wiederkehrende oder einmalige Eingabeaufforderung innerhalb der aktuellen Sitzung. Aufgaben sind sitzungsbezogen und werden bei `--resume` oder `--continue` wiederhergestellt, wenn sie nicht abgelaufen sind. Siehe [geplante Aufgaben](/de/scheduled-tasks) | Nein |21| `CronCreate` | Plant eine wiederkehrende oder einmalige Eingabeaufforderung innerhalb der aktuellen Sitzung. Aufgaben sind sitzungsbezogen und werden bei `--resume` oder `--continue` wiederhergestellt, wenn sie nicht abgelaufen sind. Siehe [geplante Aufgaben](/docs/de/scheduled-tasks) | Nein |

24| `Edit` | Nimmt gezielte Änderungen an bestimmten Dateien vor. Siehe [Edit-Werkzeugverhalten](#edit-tool-behavior) | Ja |24| `Edit` | Nimmt gezielte Änderungen an bestimmten Dateien vor. Siehe [Edit-Werkzeugverhalten](#edit-tool-behavior) | Ja |

26| `EnterWorktree` | Erstellt einen isolierten [Git Worktree](/de/worktrees) und wechselt hinein. Übergeben Sie einen `path`, um stattdessen in einen vorhandenen Worktree zu wechseln. {/* min-version: 2.1.203 */}Beim ersten Eintritt kann das Ziel ein Worktree des aktuellen Repositorys oder in einem Multi-Repo-Workspace ein darin verschachteltes Repository sein. Vor v2.1.203 wurde ein Worktree eines verschachtelten Repositorys abgelehnt. {/* min-version: 2.1.206 */}Ein `path` außerhalb von `.claude/worktrees/` fordert Ihre Genehmigung auf, bevor Sie eintreten, da er das Arbeitsverzeichnis und den Schreibzugriff der Sitzung an diesen Ort verschiebt. Die Erstellung neuer Worktrees und Pfade unter `.claude/worktrees/` fordern nicht auf. Vor v2.1.206 trat Claude in Pfade außerhalb von `.claude/worktrees/` ohne Aufforderung ein. Aus einer Worktree-Sitzung oder von einem Subagenten mit einem angehefteten Arbeitsverzeichnis wie [`isolation: worktree`](/de/sub-agents#supported-frontmatter-fields) ist nur die `path`-Form verfügbar und das Ziel muss unter `.claude/worktrees/` des Repositorys der Sitzung liegen | Ja |26| `EnterWorktree` | Erstellt einen isolierten [Git Worktree](/docs/de/worktrees) und wechselt hinein. Übergeben Sie einen `path`, um stattdessen in einen vorhandenen Worktree zu wechseln. Beim ersten Eintritt kann das Ziel ein Worktree des aktuellen Repositorys oder in einem Multi-Repo-Workspace ein darin verschachteltes Repository sein. Vor v2.1.203 wurde ein Worktree eines verschachtelten Repositorys abgelehnt. Ein `path` außerhalb von `.claude/worktrees/` fordert Ihre Genehmigung auf, bevor Sie eintreten, da er das Arbeitsverzeichnis und den Schreibzugriff der Sitzung an diesen Ort verschiebt. Die Erstellung neuer Worktrees und Pfade unter `.claude/worktrees/` fordern nicht auf. Vor v2.1.206 trat Claude in Pfade außerhalb von `.claude/worktrees/` ohne Aufforderung ein. Aus einer Worktree-Sitzung oder von einem Subagenten mit einem angehefteten Arbeitsverzeichnis wie [`isolation: worktree`](/docs/de/sub-agents#supported-frontmatter-fields) ist nur die `path`-Form verfügbar und das Ziel muss unter `.claude/worktrees/` des Repositorys der Sitzung liegen | Ja |

27| `ExitPlanMode` | Präsentiert einen Plan zur Genehmigung und beendet Plan Mode | Ja |27| `ExitPlanMode` | Präsentiert einen Plan zur Genehmigung und beendet Plan Mode | Ja |

28| `ExitWorktree` | Beendet eine Worktree-Sitzung und kehrt zum ursprünglichen Verzeichnis zurück. Nicht für Subagenten verfügbar, die bereits in ihrem eigenen Arbeitsverzeichnis ausgeführt werden, z. B. mit [`isolation: worktree`](/de/sub-agents#supported-frontmatter-fields) | Nein |28| `ExitWorktree` | Beendet eine Worktree-Sitzung und kehrt zum ursprünglichen Verzeichnis zurück. Nicht für Subagenten verfügbar, die bereits in ihrem eigenen Arbeitsverzeichnis ausgeführt werden, z. B. mit [`isolation: worktree`](/docs/de/sub-agents#supported-frontmatter-fields) | Nein |

32| `LSP` | Code-Intelligenz über Sprachserver: Sprung zu Definitionen, Suche nach Referenzen, Meldung von Typfehlern und Warnungen. Siehe [LSP-Werkzeugverhalten](#lsp-tool-behavior) | Nein |32| `LSP` | Code-Intelligenz über Sprachserver: Sprung zu Definitionen, Suche nach Referenzen, Meldung von Typfehlern und Warnungen. Siehe [LSP-Werkzeugverhalten](#lsp-tool-behavior) | Nein |

33| `Monitor` | Führt einen Befehl im Hintergrund aus und gibt jede Ausgabezeile an Claude zurück, damit er auf Protokolleinträge, Dateiänderungen oder abgerufene Status während des Gesprächs reagieren kann. Kann auch einen WebSocket öffnen und jede eingehende Nachricht als Ereignis behandeln. Siehe [Monitor-Werkzeug](#monitor-tool) | Ja |33| `Monitor` | Führt einen Befehl im Hintergrund aus und gibt jede Ausgabezeile an Claude zurück, damit er auf Protokolleinträge, Dateiänderungen oder abgerufene Status während des Gesprächs reagieren kann. Kann auch einen WebSocket öffnen und jede eingehende Nachricht als Ereignis behandeln. Siehe [Monitor-Werkzeug](#monitor-tool) | Ja |

34| `NotebookEdit` | Ändert Jupyter-Notebook-Zellen. Siehe [NotebookEdit-Werkzeugverhalten](#notebookedit-tool-behavior) | Ja |34| `NotebookEdit` | Ändert Jupyter-Notebook-Zellen. Siehe [NotebookEdit-Werkzeugverhalten](#notebookedit-tool-behavior) | Ja |

35| `PowerShell` | Führt PowerShell-Befehle nativ aus. Siehe [PowerShell-Werkzeug](#powershell-tool) für Verfügbarkeit | Ja |35| `PowerShell` | Führt PowerShell-Befehle nativ aus. Siehe [PowerShell-Werkzeug](#powershell-tool) für Verfügbarkeit | Ja |

36| `PushNotification` | Sendet eine Desktop-Benachrichtigung und eine Telefon-Push-Benachrichtigung, wenn [Remote Control](/de/remote-control) verbunden ist, damit eine langfristige Aufgabe oder [geplante Aufgabe](/de/scheduled-tasks) Sie erreichen kann, wenn Sie weg sind. {/* plan-availability: feature=push-notifications providers=anthropic */}Push-Zustellung läuft über von Anthropic gehostete Infrastruktur, auf die von Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry nicht zugegriffen werden kann | Nein |36| `PushNotification` | Sendet eine Desktop-Benachrichtigung und eine Telefon-Push-Benachrichtigung, wenn [Remote Control](/docs/de/remote-control) verbunden ist, damit eine langfristige Aufgabe oder [geplante Aufgabe](/docs/de/scheduled-tasks) Sie erreichen kann, wenn Sie weg sind. Push-Zustellung läuft über von Anthropic gehostete Infrastruktur, auf die von Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry nicht zugegriffen werden kann | Nein |

39| `RemoteTrigger` | Erstellt, aktualisiert, führt aus und listet [Routinen](/de/routines) auf claude.ai auf. Unterstützt den `/schedule`-Befehl. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routinen befinden sich auf claude.ai und erfordern einen Pro-, Max-, Team- oder Enterprise-Plan, daher ist dieses Werkzeug nicht über Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry zugänglich | Nein |39| `RemoteTrigger` | Erstellt, aktualisiert, führt aus und listet [Routinen](/docs/de/routines) auf claude.ai auf. Unterstützt den `/schedule`-Befehl. Routinen befinden sich auf claude.ai und erfordern einen Pro-, Max-, Team- oder Enterprise-Plan, daher ist dieses Werkzeug nicht über Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry zugänglich | Nein |

40| `ReportFindings` | Meldet Code-Review-Ergebnisse als strukturierte Liste mit einer Datei, Zusammenfassung und Fehlerfall pro Ergebnis, damit Claude Code sie rendern kann, anstatt sie als Text auszudrucken. Claude ruft es auf, wenn aktive Code-Review-Anweisungen dies vorsehen. {/* min-version: 2.1.196 */}Erfordert Claude Code v2.1.196 oder später. {/* min-version: 2.1.199 */}Ab v2.1.199 kann ein Ergebnis auch einen optionalen `category`-Slug tragen, wie `correctness` oder `test-coverage`, der neben dem Dateispeicherort in der gerenderten Liste angezeigt wird | Nein |40| `ReportFindings` | Meldet Code-Review-Ergebnisse als strukturierte Liste mit einer Datei, Zusammenfassung und Fehlerfall pro Ergebnis, damit Claude Code sie rendern kann, anstatt sie als Text auszudrucken. Claude ruft es auf, wenn aktive Code-Review-Anweisungen dies vorsehen. Erfordert Claude Code v2.1.196 oder später. Ab v2.1.199 kann ein Ergebnis auch einen optionalen `category`-Slug tragen, wie `correctness` oder `test-coverage`, der neben dem Dateispeicherort in der gerenderten Liste angezeigt wird | Nein |

41| `ScheduleWakeup` | Plant die nächste Iteration eines [selbstgesteuerten `/loop`](/de/scheduled-tasks#let-claude-choose-the-interval) neu. Claude ruft dies am Ende jeder Iteration auf, um auszuwählen, wann die nächste ausgeführt wird, zwischen einer Minute und einer Stunde später; Sie rufen es nicht direkt auf. Um die Schleife stattdessen zu beenden, ruft Claude es mit `stop: true` auf, was das ausstehende Wakeup abbricht. {/* min-version: 2.1.202 */}Das Feld `stop` erfordert Claude Code v2.1.202 oder später. Das ausstehende Wakeup wird in `session_crons` in [Stop-Hook-Eingabe](/de/hooks#stop-input) angezeigt. {/* plan-availability: feature=loop-dynamic providers=anthropic */}Nicht verfügbar auf Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform oder Microsoft Foundry, wo ein `/loop`-Prompt ohne Intervall stattdessen nach einem festen Zeitplan ausgeführt wird | Nein |41| `ScheduleWakeup` | Plant die nächste Iteration eines [selbstgesteuerten `/loop`](/docs/de/scheduled-tasks#let-claude-choose-the-interval) neu. Claude ruft dies am Ende jeder Iteration auf, um auszuwählen, wann die nächste ausgeführt wird, zwischen einer Minute und einer Stunde später; Sie rufen es nicht direkt auf. Um die Schleife stattdessen zu beenden, ruft Claude es mit `stop: true` auf, was das ausstehende Wakeup abbricht. Das Feld `stop` erfordert Claude Code v2.1.202 oder später. Das ausstehende Wakeup wird in `session_crons` in [Stop-Hook-Eingabe](/docs/de/hooks#stop-input) angezeigt. Nicht verfügbar auf Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform oder Microsoft Foundry, wo ein `/loop`-Prompt ohne Intervall stattdessen nach einem festen Zeitplan ausgeführt wird | Nein |

42| `SendMessage` | Sendet eine Nachricht an einen [Agent-Team](/de/agent-teams)-Mitarbeiter oder [setzt einen Subagenten](/de/sub-agents#resume-subagents) nach seiner Agent-ID oder seinem Namen fort. Ein abgeschlossener Subagent wird automatisch im Hintergrund fortgesetzt; ein Subagent, den Sie von `/tasks` aus gestoppt haben, wird nicht fortgesetzt und der Aufruf gibt eine Ablehnung zurück. Strukturierte Team-Protokoll-Nachrichten erfordern Agent-Teams. Ein Empfänger behandelt eine Nachricht von einem anderen Agenten niemals als Ihre Zustimmung oder Genehmigung. {/* min-version: 2.1.198 */}Ab v2.1.198 behandelt ein Subagent eine Nachricht vom Agent, der ihn gestartet hat, als normale Aufgabenrichtung statt als Peer-Anfrage. {/* min-version: 2.1.199 */}Ab v2.1.199 wird ein Senden an einen Namen, der sich jetzt zu einem anderen Agenten auflöst als früher im Gespräch, abgelehnt statt zugestellt; siehe [Subagenten fortsetzen](/de/sub-agents#resume-subagents) | Nein |42| `SendMessage` | Sendet eine Nachricht an einen [Agent-Team](/docs/de/agent-teams)-Mitarbeiter oder [setzt einen Subagenten](/docs/de/sub-agents#resume-subagents) nach seiner Agent-ID oder seinem Namen fort. Ein abgeschlossener Subagent wird automatisch im Hintergrund fortgesetzt; ein Subagent, den Sie von `/tasks` aus gestoppt haben, wird nicht fortgesetzt und der Aufruf gibt eine Ablehnung zurück. Strukturierte Team-Protokoll-Nachrichten erfordern Agent-Teams. Ein Empfänger behandelt eine Nachricht von einem anderen Agenten niemals als Ihre Zustimmung oder Genehmigung. Ab v2.1.198 behandelt ein Subagent eine Nachricht vom Agent, der ihn gestartet hat, als normale Aufgabenrichtung statt als Peer-Anfrage. Ab v2.1.199 wird ein Senden an einen Namen, der sich jetzt zu einem anderen Agenten auflöst als früher im Gespräch, abgelehnt statt zugestellt; siehe [Subagenten fortsetzen](/docs/de/sub-agents#resume-subagents) | Nein |

43| `SendUserFile` | Sendet Dateien aus der Sitzung an Sie mit einer optionalen Beschriftung, damit ein generierter Bericht, Diagramm, Screenshot oder erstelltes Artefakt Ihr Gerät erreicht, anstatt nur im Transkript erwähnt zu werden. {/* min-version: 2.1.196 */}Ab v2.1.196 steuert die optionale `display`-Eingabe die Präsentation: `render` öffnet die Datei inline im Client, `attach` zeigt nur eine Download-Karte an, und wenn nicht gesetzt, entscheidet der Client nach Dateityp. Verfügbar, wenn ein [Remote Control](/de/remote-control)-Client verbunden ist oder die Sitzung in einer verwalteten Cloud-Umgebung wie [Claude Code im Web](/de/claude-code-on-the-web) ausgeführt wird. Die Zustellung läuft über von Anthropic gehostete Infrastruktur, daher ist das Werkzeug nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar | Nein |43| `SendUserFile` | Sendet Dateien aus der Sitzung an Sie mit einer optionalen Beschriftung, damit ein generierter Bericht, Diagramm, Screenshot oder erstelltes Artefakt Ihr Gerät erreicht, anstatt nur im Transkript erwähnt zu werden. Ab v2.1.196 steuert die optionale `display`-Eingabe die Präsentation: `render` öffnet die Datei inline im Client, `attach` zeigt nur eine Download-Karte an, und wenn nicht gesetzt, entscheidet der Client nach Dateityp. Verfügbar, wenn ein [Remote Control](/docs/de/remote-control)-Client verbunden ist oder die Sitzung in einer verwalteten Cloud-Umgebung wie [Claude Code im Web](/docs/de/claude-code-on-the-web) ausgeführt wird. Die Zustellung läuft über von Anthropic gehostete Infrastruktur, daher ist das Werkzeug nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar | Nein |

44| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Lädt `ONBOARDING.md` hoch und gibt einen Freigabelink zurück, den Mitarbeiter in Claude Code öffnen können. Wird nach dem Schreiben des Leitfadens von `/team-onboarding` aufgerufen. Verfügbar für claude.ai-Abonnenten mit Pro-, Max-, Team- und Enterprise-Plänen | Ja |44| `ShareOnboardingGuide` | Lädt `ONBOARDING.md` hoch und gibt einen Freigabelink zurück, den Mitarbeiter in Claude Code öffnen können. Wird nach dem Schreiben des Leitfadens von `/team-onboarding` aufgerufen. Verfügbar für claude.ai-Abonnenten mit Pro-, Max-, Team- und Enterprise-Plänen | Ja |

45| `Skill` | Führt einen [Skill](/de/skills#control-who-invokes-a-skill) innerhalb des Hauptgesprächs aus | Ja |45| `Skill` | Führt einen [Skill](/docs/de/skills#control-who-invokes-a-skill) innerhalb des Hauptgesprächs aus | Ja |

49| `TaskOutput` | Ruft Ausgabe von einer Hintergrundaufgabe ab. Veraltet zugunsten von `Read` auf dem Ausgabedateipfad der Aufgabe. {/* min-version: 2.1.203 */}Wenn keine Aufgabe der ID entspricht, listet der Fehler die laufenden Hintergrund-Agenten nach ID und Beschreibung auf. Vor v2.1.203 benannte der Fehler nur die fehlende ID | Nein |49| `TaskOutput` | Ruft Ausgabe von einer Hintergrundaufgabe ab. Veraltet zugunsten von `Read` auf dem Ausgabedateipfad der Aufgabe. Wenn keine Aufgabe der ID entspricht, listet der Fehler die laufenden Hintergrund-Agenten nach ID und Beschreibung auf. Vor v2.1.203 benannte der Fehler nur die fehlende ID | Nein |

50| `TaskStop` | Beendet eine laufende Hintergrundaufgabe nach ID. {/* min-version: 2.1.198 */}Es akzeptiert auch einen [Agent-Team-Mitarbeiter](/de/agent-teams) oder einen benannten Hintergrund-Agenten nach Agent-ID oder Name. Vor v2.1.198 akzeptierte es nur eine Hintergrundaufgaben-ID. {/* min-version: 2.1.203 */}Wenn keine Aufgabe der ID entspricht, listet der Fehler die laufenden Hintergrund-Agenten nach ID und Beschreibung auf, einschließlich Agenten, die ein anderer Agent erzeugt hat. Vor v2.1.203 listete der Fehler laufende Mitarbeiter und benannte Agenten auf, aber nicht Hintergrund-Agenten, die ein anderer Agent erzeugt hat, daher konnten diese nicht identifiziert oder aus dem Hauptgespräch gestoppt werden | Nein |50| `TaskStop` | Beendet eine laufende Hintergrundaufgabe nach ID. Es akzeptiert auch einen [Agent-Team-Mitarbeiter](/docs/de/agent-teams) oder einen benannten Hintergrund-Agenten nach Agent-ID oder Name. Vor v2.1.198 akzeptierte es nur eine Hintergrundaufgaben-ID. Wenn keine Aufgabe der ID entspricht, listet der Fehler die laufenden Hintergrund-Agenten nach ID und Beschreibung auf, einschließlich Agenten, die ein anderer Agent erzeugt hat. Vor v2.1.203 listete der Fehler laufende Mitarbeiter und benannte Agenten auf, aber nicht Hintergrund-Agenten, die ein anderer Agent erzeugt hat, daher konnten diese nicht identifiziert oder aus dem Hauptgespräch gestoppt werden | Nein |

52| `TodoWrite` | {/* min-version: 2.1.142 */}Verwaltet die Sitzungs-Aufgabenliste. Standardmäßig ab v2.1.142 deaktiviert zugunsten von `TaskCreate`, `TaskGet`, `TaskList` und `TaskUpdate`. Setzen Sie `CLAUDE_CODE_ENABLE_TASKS=0`, um es erneut zu aktivieren | Nein |52| `TodoWrite` | Verwaltet die Sitzungs-Aufgabenliste. Standardmäßig ab v2.1.142 deaktiviert zugunsten von `TaskCreate`, `TaskGet`, `TaskList` und `TaskUpdate`. Setzen Sie `CLAUDE_CODE_ENABLE_TASKS=0`, um es erneut zu aktivieren | Nein |

54| `WaitForMcpServers` | Wartet auf einen oder mehrere [MCP-Server](/de/mcp), die noch im Hintergrund verbunden werden, damit eine Anfrage ihre Werkzeuge verwenden kann, ohne die Sitzung neu zu starten. Claude ruft es auf, wenn ein benötigter Server noch nicht verbunden ist. Wird nur angezeigt, wenn [Tool-Suche](/de/mcp#scale-with-mcp-tool-search) deaktiviert ist, da `ToolSearch` das Warten handhabt, wenn es aktiviert ist | Nein |54| `WaitForMcpServers` | Wartet auf einen oder mehrere [MCP-Server](/docs/de/mcp), die noch im Hintergrund verbunden werden, damit eine Anfrage ihre Werkzeuge verwenden kann, ohne die Sitzung neu zu starten. Claude ruft es auf, wenn ein benötigter Server noch nicht verbunden ist. Wird nur angezeigt, wenn [Tool-Suche](/docs/de/mcp#scale-with-mcp-tool-search) deaktiviert ist, da `ToolSearch` das Warten handhabt, wenn es aktiviert ist | Nein |

55| `WebFetch` | Ruft Inhalte von einer angegebenen URL ab. Siehe [WebFetch-Werkzeugverhalten](#webfetch-tool-behavior) | Ja |55| `WebFetch` | Ruft Inhalte von einer angegebenen URL ab. Siehe [WebFetch-Werkzeugverhalten](#webfetch-tool-behavior) | Ja |

56| `WebSearch` | Führt Web-Suchen durch. Siehe [WebSearch-Werkzeugverhalten](#websearch-tool-behavior) | Ja |56| `WebSearch` | Führt Web-Suchen durch. Siehe [WebSearch-Werkzeugverhalten](#websearch-tool-behavior) | Ja |

57| `Workflow` | Führt einen [dynamischen Workflow](/de/workflows) aus: ein Skript, das viele Subagenten im Hintergrund orchestriert und ein konsolidiertes Ergebnis zurückgibt | Ja |57| `Workflow` | Führt einen [dynamischen Workflow](/docs/de/workflows) aus: ein Skript, das viele Subagenten im Hintergrund orchestriert und ein konsolidiertes Ergebnis zurückgibt | Ja |

58| `Write` | Erstellt oder überschreibt Dateien. Siehe [Write-Werkzeugverhalten](#write-tool-behavior) | Ja |58| `Write` | Erstellt oder überschreibt Dateien. Siehe [Write-Werkzeugverhalten](#write-tool-behavior) | Ja |

59 59

60<h2 id="configure-tools-with-permission-rules-and-hooks">60<h2 id="configure-tools-with-permission-rules-and-hooks">

63 63

64Größtenteils entscheidet Claude, wann diese Werkzeuge verwendet werden sollen, und Sie müssen sie nicht selbst benennen, wenn Sie mit Claude interagieren. Sie verweisen direkt auf Werkzeugnamen, wenn Sie Berechtigungen und andere Konfigurationen definieren:64Größtenteils entscheidet Claude, wann diese Werkzeuge verwendet werden sollen, und Sie müssen sie nicht selbst benennen, wenn Sie mit Claude interagieren. Sie verweisen direkt auf Werkzeugnamen, wenn Sie Berechtigungen und andere Konfigurationen definieren:

65 65

~~66* in [`permissions.allow` und `permissions.deny`](/de/settings#available-settings) in den Einstellungen und der `/permissions`-Schnittstelle~~66* in [`permissions.allow` und `permissions.deny`](/docs/de/settings#available-settings) in den Einstellungen und der `/permissions`-Schnittstelle

~~67* in den [CLI-Flags](/de/cli-reference) `--allowedTools` und `--disallowedTools`~~67* in den [CLI-Flags](/docs/de/cli-reference) `--allowedTools` und `--disallowedTools`

~~68* in den Optionen [`allowedTools` und `disallowedTools`](/de/agent-sdk/permissions#allow-and-deny-rules) des Agent SDK~~68* in den Optionen [`allowedTools` und `disallowedTools`](/docs/de/agent-sdk/permissions#allow-and-deny-rules) des Agent SDK

~~69* in einem [Subagenten-`tools` oder `disallowedTools`](/de/sub-agents#supported-frontmatter-fields)-Frontmatter~~69* in einem [Subagenten-`tools` oder `disallowedTools`](/docs/de/sub-agents#supported-frontmatter-fields)-Frontmatter

~~70* in einem [Skill-`allowed-tools`](/de/skills#frontmatter-reference)-Frontmatter~~70* in einem [Skill-`allowed-tools`](/docs/de/skills#frontmatter-reference)-Frontmatter

~~71* in der [`if`-Bedingung](/de/hooks-guide#filter-by-tool-name-and-arguments-with-the-if-field) eines Hooks~~71* in der [`if`-Bedingung](/docs/de/hooks-guide#filter-by-tool-name-and-arguments-with-the-if-field) eines Hooks

72 72

73Alle diese akzeptieren das gleiche Regelformat, `ToolName(specifier)`. Der Specifier hängt vom Werkzeug ab, und mehrere Werkzeuge teilen ein Format:73Alle diese akzeptieren das gleiche Regelformat, `ToolName(specifier)`. Der Specifier hängt vom Werkzeug ab, und mehrere Werkzeuge teilen ein Format:

74 74

76| :----------------------------- | :------------------------ | :------------------------------------------------------------------------ |76| :----------------------------- | :------------------------ | :------------------------------------------------------------------------ |

~~79| `Read(~/secrets/**)` | Read, Grep, Glob, LSP | [Pfadmuster-Matching](/de/permissions#read-and-edit) |~~79| `Read(~/secrets/**)` | Read, Grep, Glob, LSP | [Pfadmuster-Matching](/docs/de/permissions#read-and-edit) |

~~80| `Edit(/src/**)` | Edit, Write, NotebookEdit | [Pfadmuster-Matching](/de/permissions#read-and-edit) |~~80| `Edit(/src/**)` | Edit, Write, NotebookEdit | [Pfadmuster-Matching](/docs/de/permissions#read-and-edit) |

85 85

86Werkzeuge, die hier nicht aufgelistet sind, wie `ExitPlanMode` oder `ShareOnboardingGuide`, akzeptieren nur den bloßen Werkzeugnamen ohne Specifier.86Werkzeuge, die hier nicht aufgelistet sind, wie `ExitPlanMode` oder `ShareOnboardingGuide`, akzeptieren nur den bloßen Werkzeugnamen ohne Specifier.

87 87

88Eine `Edit(...)`-Zulassungsregel gewährt auch Lesezugriff auf denselben Pfad, daher benötigen Sie keine entsprechende `Read(...)`-Regel. Eine `Read(...)`-Ablehnungsregel blockiert auch das Edit-Werkzeug auf demselben Pfad, einschließlich der Erstellung einer neuen Datei dort, da das Bearbeiten das Zurücklesen des Ergebnisses erfordert. Die `Read`-Ablehnungsprüfung bei Bearbeitungen erfordert Claude Code v2.1.208 oder später.88Eine `Edit(...)`-Zulassungsregel gewährt auch Lesezugriff auf denselben Pfad, daher benötigen Sie keine entsprechende `Read(...)`-Regel. Eine `Read(...)`-Ablehnungsregel blockiert auch das Edit-Werkzeug auf demselben Pfad, einschließlich der Erstellung einer neuen Datei dort, da das Bearbeiten das Zurücklesen des Ergebnisses erfordert. Die `Read`-Ablehnungsprüfung bei Bearbeitungen erfordert Claude Code v2.1.208 oder später.

89 89

90Hook-`matcher`-Felder verwenden bloße Werkzeugnamen, nicht das geklammerte Regelformat. Siehe [Matcher-Muster](/de/hooks#matcher-patterns) für die Matching-Regeln. Für die Feldnamen, die jedes Werkzeug an `tool_input` in Hooks übergibt, siehe die [PreToolUse-Eingabereferenz](/de/hooks#pretooluse-input).90Hook-`matcher`-Felder verwenden bloße Werkzeugnamen, nicht das geklammerte Regelformat. Siehe [Matcher-Muster](/docs/de/hooks#matcher-patterns) für die Matching-Regeln. Für die Feldnamen, die jedes Werkzeug an `tool_input` in Hooks übergibt, siehe die [PreToolUse-Eingabereferenz](/docs/de/hooks#pretooluse-input).

91 91

92<h2 id="agent-tool-behavior">92<h2 id="agent-tool-behavior">

93 Agent-Werkzeugverhalten93 Agent-Werkzeugverhalten

95 95

96Das Agent-Werkzeug erzeugt einen Subagenten in einem separaten Kontextfenster. Der Subagent arbeitet seine Aufgabe autonom durch und gibt dann ein einzelnes Textergebnis an das übergeordnete Gespräch zurück. Das übergeordnete Gespräch sieht nicht die Zwischenwerkzeugaufrufe oder Ausgaben des Subagenten, sondern nur dieses Endergebnis.96Das Agent-Werkzeug erzeugt einen Subagenten in einem separaten Kontextfenster. Der Subagent arbeitet seine Aufgabe autonom durch und gibt dann ein einzelnes Textergebnis an das übergeordnete Gespräch zurück. Das übergeordnete Gespräch sieht nicht die Zwischenwerkzeugaufrufe oder Ausgaben des Subagenten, sondern nur dieses Endergebnis.

97 97

~~98Um zu begrenzen, wie viele Durchläufe ein Subagent ausführt, setzen Sie `maxTurns` in der [Subagenten-Definition](/de/sub-agents#supported-frontmatter-fields).~~98Um zu begrenzen, wie viele Durchläufe ein Subagent ausführt, setzen Sie `maxTurns` in der [Subagenten-Definition](/docs/de/sub-agents#supported-frontmatter-fields).

99 99

100Das gleiche Agent-Werkzeug startet auch [verzweigte Subagenten](/de/sub-agents#fork-the-current-conversation), wenn der Fork-Modus aktiviert ist. Ein Fork erbt das vollständige übergeordnete Gespräch, anstatt neu zu beginnen, läuft immer im Hintergrund und zeigt dennoch Berechtigungsaufforderungen in Ihrem Terminal. Der Rest dieses Abschnitts beschreibt benannte Subagenten.100Das gleiche Agent-Werkzeug startet auch [verzweigte Subagenten](/docs/de/sub-agents#fork-the-current-conversation), wenn der Fork-Modus aktiviert ist. Ein Fork erbt das vollständige übergeordnete Gespräch, anstatt neu zu beginnen, läuft immer im Hintergrund und zeigt dennoch Berechtigungsaufforderungen in Ihrem Terminal. Der Rest dieses Abschnitts beschreibt benannte Subagenten.

101 101

102Welche Werkzeuge ein benannter Subagent verwenden kann, hängt von den Feldern `tools` und `disallowedTools` in der [Subagenten-Definition](/de/sub-agents) ab:102Welche Werkzeuge ein benannter Subagent verwenden kann, hängt von den Feldern `tools` und `disallowedTools` in der [Subagenten-Definition](/docs/de/sub-agents) ab:

103 103

104* **Keines der Felder gesetzt**: Der Subagent erbt jedes Werkzeug, das dem übergeordneten Agenten zur Verfügung steht.104* **Keines der Felder gesetzt**: Der Subagent erbt jedes Werkzeug, das dem übergeordneten Agenten zur Verfügung steht.

105* **Nur `tools`**: Der Subagent erhält nur die aufgelisteten Werkzeuge.105* **Nur `tools`**: Der Subagent erhält nur die aufgelisteten Werkzeuge.

106* **Nur `disallowedTools`**: Der Subagent erhält jedes übergeordnete Werkzeug außer den aufgelisteten.106* **Nur `disallowedTools`**: Der Subagent erhält jedes übergeordnete Werkzeug außer den aufgelisteten.

107* **Beide gesetzt**: `disallowedTools` hat Vorrang. Ein Werkzeug, das in beiden aufgelistet ist, wird entfernt.107* **Beide gesetzt**: `disallowedTools` hat Vorrang. Ein Werkzeug, das in beiden aufgelistet ist, wird entfernt.

108 108

109Wenn die `tools`-Liste eines Subagenten zu überhaupt keinen Werkzeugen führt, beispielsweise weil jeder Eintrag falsch geschrieben ist oder ein Werkzeug benennt, das für Subagenten nicht verfügbar ist, gibt das Agent-Werkzeug einen Fehler zurück, der diese Einträge auflistet, anstatt den Subagenten zu starten. {/* min-version: 2.1.208 */}Vor v2.1.208 wurde der Subagent ohne Werkzeuge gestartet und konnte ein leeres oder verwirrendes Ergebnis zurückgeben.109Wenn die `tools`-Liste eines Subagenten zu überhaupt keinen Werkzeugen führt, beispielsweise weil jeder Eintrag falsch geschrieben ist oder ein Werkzeug benennt, das für Subagenten nicht verfügbar ist, gibt das Agent-Werkzeug einen Fehler zurück, der diese Einträge auflistet, anstatt den Subagenten zu starten. Vor v2.1.208 wurde der Subagent ohne Werkzeuge gestartet und konnte ein leeres oder verwirrendes Ergebnis zurückgeben.

110 110

111Das Starten des Subagenten fordert nicht selbst zur Berechtigung auf. Claude Code überprüft die eigenen Werkzeugaufrufe des Subagenten während der Ausführung gegen Ihre Berechtigungsregeln.111Das Starten des Subagenten fordert nicht selbst zur Berechtigung auf. Claude Code überprüft die eigenen Werkzeugaufrufe des Subagenten während der Ausführung gegen Ihre Berechtigungsregeln.

112 112

113{/* min-version: 2.1.198 */}Ab v2.1.198 werden Subagenten standardmäßig im Hintergrund ausgeführt; Claude führt einen im Vordergrund aus, wenn es das Ergebnis benötigt, bevor es fortfährt.113Ab v2.1.198 werden Subagenten standardmäßig im Hintergrund ausgeführt; Claude führt einen im Vordergrund aus, wenn es das Ergebnis benötigt, bevor es fortfährt.

114 114

115* **Vordergrund-Subagenten** zeigen die gleichen Berechtigungsaufforderungen, die Sie im Hauptgespräch sehen würden, in dem Moment, in dem jeder Werkzeugaufruf stattfindet.115* **Vordergrund-Subagenten** zeigen die gleichen Berechtigungsaufforderungen, die Sie im Hauptgespräch sehen würden, in dem Moment, in dem jeder Werkzeugaufruf stattfindet.

116* **Hintergrund-Subagenten** {/* min-version: 2.1.186 */}zeigen Berechtigungsaufforderungen in Ihrer Hauptsitzung ab v2.1.186. Die Aufforderung nennt, welcher Subagent fragt, und das Drücken von Esc lehnt diesen einen Werkzeugaufruf ab, ohne den Subagenten zu stoppen. Vor v2.1.186 lehnten Hintergrund-Subagenten automatisch jeden Werkzeugaufruf ab, der sonst eine Aufforderung auslösen würde, und setzten fort ohne dieses Werkzeug.116* **Hintergrund-Subagenten** zeigen Berechtigungsaufforderungen in Ihrer Hauptsitzung ab v2.1.186. Die Aufforderung nennt, welcher Subagent fragt, und das Drücken von Esc lehnt diesen einen Werkzeugaufruf ab, ohne den Subagenten zu stoppen. Vor v2.1.186 lehnten Hintergrund-Subagenten automatisch jeden Werkzeugaufruf ab, der sonst eine Aufforderung auslösen würde, und setzten fort ohne dieses Werkzeug.

117 117

118Um zu begrenzen, was ein Subagent in erster Linie erreichen kann, verengen Sie sein `tools`-Feld, lassen Sie Bash von der Liste weg oder setzen Sie Ablehnungsregeln in Ihren Einstellungen, wie in [Subagenten-Funktionen steuern](/de/sub-agents#control-subagent-capabilities) beschrieben. Weitere Informationen zur Wahl zwischen Vordergrund und Hintergrund finden Sie unter [Subagenten im Vordergrund oder Hintergrund ausführen](/de/sub-agents#run-subagents-in-foreground-or-background).118Um zu begrenzen, was ein Subagent in erster Linie erreichen kann, verengen Sie sein `tools`-Feld, lassen Sie Bash von der Liste weg oder setzen Sie Ablehnungsregeln in Ihren Einstellungen, wie in [Subagenten-Funktionen steuern](/docs/de/sub-agents#control-subagent-capabilities) beschrieben. Weitere Informationen zur Wahl zwischen Vordergrund und Hintergrund finden Sie unter [Subagenten im Vordergrund oder Hintergrund ausführen](/docs/de/sub-agents#run-subagents-in-foreground-or-background).

119 119

120<h2 id="bash-tool-behavior">120<h2 id="bash-tool-behavior">

121 Bash-Werkzeugverhalten121 Bash-Werkzeugverhalten

123 123

124Das Bash-Werkzeug führt jeden Befehl in einem separaten Prozess mit folgendem Persistenzverhalten aus:124Das Bash-Werkzeug führt jeden Befehl in einem separaten Prozess mit folgendem Persistenzverhalten aus:

125 125

126* Wenn Claude `cd` in der Hauptsitzung ausführt, wird das neue Arbeitsverzeichnis zu späteren Bash-Befehlen übertragen, solange es sich im Projektverzeichnis oder einem [zusätzlichen Arbeitsverzeichnis](/de/permissions#working-directories) befindet, das Sie mit `--add-dir`, `/add-dir` oder `additionalDirectories` in den Einstellungen hinzugefügt haben. Subagent-Sitzungen übertragen niemals Arbeitsverzeichnisänderungen.126* Wenn Claude `cd` in der Hauptsitzung ausführt, wird das neue Arbeitsverzeichnis zu späteren Bash-Befehlen übertragen, solange es sich im Projektverzeichnis oder einem [zusätzlichen Arbeitsverzeichnis](/docs/de/permissions#working-directories) befindet, das Sie mit `--add-dir`, `/add-dir` oder `additionalDirectories` in den Einstellungen hinzugefügt haben. Subagent-Sitzungen übertragen niemals Arbeitsverzeichnisänderungen.

127 * Wenn `cd` außerhalb dieser Verzeichnisse landet, setzt Claude Code auf das Projektverzeichnis zurück und fügt `Shell cwd was reset to <dir>` zum Werkzeugergebnis hinzu.127 * Wenn `cd` außerhalb dieser Verzeichnisse landet, setzt Claude Code auf das Projektverzeichnis zurück und fügt `Shell cwd was reset to <dir>` zum Werkzeugergebnis hinzu.

128 * Um diese Übertragung zu deaktivieren, damit jeder Bash-Befehl im Projektverzeichnis startet, setzen Sie `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.128 * Um diese Übertragung zu deaktivieren, damit jeder Bash-Befehl im Projektverzeichnis startet, setzen Sie `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.

129* Umgebungsvariablen bleiben nicht erhalten. Ein `export` in einem Befehl ist im nächsten nicht verfügbar.129* Umgebungsvariablen bleiben nicht erhalten. Ein `export` in einem Befehl ist im nächsten nicht verfügbar.

130* Aliase und Shell-Funktionen, die in Ihrer Shell-Startdatei definiert sind, sind verfügbar. Beim Sitzungsstart sourced Claude Code `~/.zshrc`, `~/.bashrc` oder `~/.profile` je nach Ihrer Shell, erfasst die resultierenden Aliase, Funktionen und Shell-Optionen und wendet sie auf jeden Bash-Befehl an.130* Aliase und Shell-Funktionen, die in Ihrer Shell-Startdatei definiert sind, sind verfügbar. Beim Sitzungsstart sourced Claude Code `~/.zshrc`, `~/.bashrc` oder `~/.profile` je nach Ihrer Shell, erfasst die resultierenden Aliase, Funktionen und Shell-Optionen und wendet sie auf jeden Bash-Befehl an.

131 131

132Aktivieren Sie Ihre virtualenv- oder Conda-Umgebung, bevor Sie Claude Code starten. Um Umgebungsvariablen über Bash-Befehle hinweg persistent zu machen, setzen Sie [`CLAUDE_ENV_FILE`](/de/env-vars) auf ein Shell-Skript, bevor Sie Claude Code starten, oder verwenden Sie einen [SessionStart-Hook](/de/hooks#persist-environment-variables), um ihn dynamisch zu füllen.132Aktivieren Sie Ihre virtualenv- oder Conda-Umgebung, bevor Sie Claude Code starten. Um Umgebungsvariablen über Bash-Befehle hinweg persistent zu machen, setzen Sie [`CLAUDE_ENV_FILE`](/docs/de/env-vars) auf ein Shell-Skript, bevor Sie Claude Code starten, oder verwenden Sie einen [SessionStart-Hook](/docs/de/hooks#persist-environment-variables), um ihn dynamisch zu füllen.

133 133

134Zwei Grenzen begrenzen jeden Befehl:134Zwei Grenzen begrenzen jeden Befehl:

135 135

136* **Timeout**: Standardmäßig zwei Minuten. Claude kann bis zu 10 Minuten pro Befehl mit dem `timeout`-Parameter anfordern. Überschreiben Sie den Standard und die Obergrenze mit [`BASH_DEFAULT_TIMEOUT_MS` und `BASH_MAX_TIMEOUT_MS`](/de/env-vars).136* **Timeout**: Standardmäßig zwei Minuten. Claude kann bis zu 10 Minuten pro Befehl mit dem `timeout`-Parameter anfordern. Überschreiben Sie den Standard und die Obergrenze mit [`BASH_DEFAULT_TIMEOUT_MS` und `BASH_MAX_TIMEOUT_MS`](/docs/de/env-vars).

137* **Ausgabelänge**: Standardmäßig 30.000 Zeichen. Wenn ein Befehl mehr als das produziert, speichert Claude Code die vollständige Ausgabe in einer Datei im Sitzungsverzeichnis und gibt Claude den Dateipfad plus eine kurze Vorschau vom Anfang. Claude liest oder durchsucht diese Datei, wenn er den Rest benötigt. Erhöhen Sie das Limit mit [`BASH_MAX_OUTPUT_LENGTH`](/de/env-vars), bis zu einer harten Obergrenze von 150.000 Zeichen.137* **Ausgabelänge**: Standardmäßig 30.000 Zeichen. Wenn ein Befehl mehr als das produziert, speichert Claude Code die vollständige Ausgabe in einer Datei im Sitzungsverzeichnis und gibt Claude den Dateipfad plus eine kurze Vorschau vom Anfang. Claude liest oder durchsucht diese Datei, wenn er den Rest benötigt. Erhöhen Sie das Limit mit [`BASH_MAX_OUTPUT_LENGTH`](/docs/de/env-vars), bis zu einer harten Obergrenze von 150.000 Zeichen.

138 138

139Für langfristige Prozesse wie Dev-Server oder Watch-Builds kann Claude `run_in_background: true` setzen, um den Befehl als Hintergrundaufgabe zu starten und weiter zu arbeiten, während er läuft. Listen Sie Hintergrundaufgaben auf und beenden Sie sie mit `/tasks`. Im nicht-interaktiven Modus mit dem `-p`-Flag [enden Hintergrundaufgaben kurz nach dem Endergebnis des Laufs](/de/headless#background-tasks-at-exit).139Für langfristige Prozesse wie Dev-Server oder Watch-Builds kann Claude `run_in_background: true` setzen, um den Befehl als Hintergrundaufgabe zu starten und weiter zu arbeiten, während er läuft. Listen Sie Hintergrundaufgaben auf und beenden Sie sie mit `/tasks`. Im nicht-interaktiven Modus mit dem `-p`-Flag [enden Hintergrundaufgaben kurz nach dem Endergebnis des Laufs](/docs/de/headless#background-tasks-at-exit).

140 140

141<h2 id="edit-tool-behavior">141<h2 id="edit-tool-behavior">

142 Edit-Werkzeugverhalten142 Edit-Werkzeugverhalten

144 144

145Das Edit-Werkzeug führt exakte Zeichenkettenersetzung durch. Es nimmt einen `old_string` und einen `new_string` und ersetzt den ersten mit dem zweiten. Es verwendet keine Regex oder Fuzzy-Matching.145Das Edit-Werkzeug führt exakte Zeichenkettenersetzung durch. Es nimmt einen `old_string` und einen `new_string` und ersetzt den ersten mit dem zweiten. Es verwendet keine Regex oder Fuzzy-Matching.

146 146

147Drei Überprüfungen müssen bestanden werden, damit eine Bearbeitung angewendet wird. Vor allen diesen wird ein Pfad, der einer [`Read`-Ablehnungsregel](/de/permissions#tool-specific-permission-rules) entspricht, abgelehnt, einschließlich der Erstellung einer neuen Datei dort. Die Ablehnung erfordert Claude Code v2.1.208 oder später.147Drei Überprüfungen müssen bestanden werden, damit eine Bearbeitung angewendet wird. Vor allen diesen wird ein Pfad, der einer [`Read`-Ablehnungsregel](/docs/de/permissions#tool-specific-permission-rules) entspricht, abgelehnt, einschließlich der Erstellung einer neuen Datei dort. Die Ablehnung erfordert Claude Code v2.1.208 oder später.

148 148

149* **Lesen vor Bearbeitung**: Claude liest die Datei im aktuellen Gespräch vor der Bearbeitung, und ein Lesen, das mit einer [`PARTIAL view`-Benachrichtigung](#read-tool-behavior) unterbrochen wird, zählt nicht. Claude Opus 4.6, Claude Haiku 4.5 und ältere Modelle erfordern immer das Lesen. Neuere Modelle können eine ungelesene Datei bearbeiten, wenn das Lesen keine Berechtigungsaufforderung erfordern würde und das Read-Werkzeug verfügbar ist.149* **Lesen vor Bearbeitung**: Claude liest die Datei im aktuellen Gespräch vor der Bearbeitung, und ein Lesen, das mit einer [`PARTIAL view`-Benachrichtigung](#read-tool-behavior) unterbrochen wird, zählt nicht. Claude Opus 4.6, Claude Haiku 4.5 und ältere Modelle erfordern immer das Lesen. Neuere Modelle können eine ungelesene Datei bearbeiten, wenn das Lesen keine Berechtigungsaufforderung erfordern würde und das Read-Werkzeug verfügbar ist.

150* **Abgleich**: `old_string` muss in der Datei genau wie geschrieben vorkommen. Ein einzelnes Zeichen Unterschied in Leerzeichen oder Einrückung reicht aus, um zu verfehlen.150* **Abgleich**: `old_string` muss in der Datei genau wie geschrieben vorkommen. Ein einzelnes Zeichen Unterschied in Leerzeichen oder Einrückung reicht aus, um zu verfehlen.

154 154

155Das Anzeigen einer Datei mit Bash erfüllt auch die Anforderung zum Lesen vor Bearbeitung, wenn der Befehl `cat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep` oder `fgrep` auf einer einzelnen Datei ohne Pipes oder Umleitungen ist. Gepipte Ausgabe und andere Bash-Befehle zählen nicht zum Lesen-vor-Bearbeitung-Check.155Das Anzeigen einer Datei mit Bash erfüllt auch die Anforderung zum Lesen vor Bearbeitung, wenn der Befehl `cat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep` oder `fgrep` auf einer einzelnen Datei ohne Pipes oder Umleitungen ist. Gepipte Ausgabe und andere Bash-Befehle zählen nicht zum Lesen-vor-Bearbeitung-Check.

156 156

157Dies betrifft nur die Bearbeitungsberechtigung, nicht die Berechtigungen. [Read- und Edit-Ablehnungsregeln](/de/permissions#tool-specific-permission-rules) gelten auch für Dateibefehle, die Claude Code in Bash erkennt, wie `cat`, `head`, `tail`, `sed` und `grep`, aber nicht für beliebige Unterprozesse, die Dateien indirekt lesen oder schreiben, wie ein Python- oder Node-Skript, das Dateien selbst öffnet. Der Satz von Befehlen, die für Ablehnungsregeln erkannt werden, ist nicht derselbe wie die obige Liste zum Lesen vor Bearbeitung: Beispielsweise zählen `egrep` und `fgrep` für Lesen vor Bearbeitung, werden aber nicht gegen Read-Ablehnungsregeln überprüft. Für OS-Ebenen-Durchsetzung, die jeden Prozess abdeckt, [aktivieren Sie die Sandbox](/de/sandboxing).157Dies betrifft nur die Bearbeitungsberechtigung, nicht die Berechtigungen. [Read- und Edit-Ablehnungsregeln](/docs/de/permissions#tool-specific-permission-rules) gelten auch für Dateibefehle, die Claude Code in Bash erkennt, wie `cat`, `head`, `tail`, `sed` und `grep`, aber nicht für beliebige Unterprozesse, die Dateien indirekt lesen oder schreiben, wie ein Python- oder Node-Skript, das Dateien selbst öffnet. Der Satz von Befehlen, die für Ablehnungsregeln erkannt werden, ist nicht derselbe wie die obige Liste zum Lesen vor Bearbeitung: Beispielsweise zählen `egrep` und `fgrep` für Lesen vor Bearbeitung, werden aber nicht gegen Read-Ablehnungsregeln überprüft. Für OS-Ebenen-Durchsetzung, die jeden Prozess abdeckt, [aktivieren Sie die Sandbox](/docs/de/sandboxing).

158 158

159<h2 id="glob-tool-behavior">159<h2 id="glob-tool-behavior">

160 Glob-Werkzeugverhalten160 Glob-Werkzeugverhalten

170 170

171Glob respektiert `.gitignore` standardmäßig nicht, daher findet es gitignorierte Dateien neben verfolgten. Dies unterscheidet sich von [Grep](#grep-tool-behavior), das gitignorierte Dateien überspringt. Um Glob `.gitignore` respektieren zu lassen, setzen Sie `CLAUDE_CODE_GLOB_NO_IGNORE=false`, bevor Sie Claude Code starten.171Glob respektiert `.gitignore` standardmäßig nicht, daher findet es gitignorierte Dateien neben verfolgten. Dies unterscheidet sich von [Grep](#grep-tool-behavior), das gitignorierte Dateien überspringt. Um Glob `.gitignore` respektieren zu lassen, setzen Sie `CLAUDE_CODE_GLOB_NO_IGNORE=false`, bevor Sie Claude Code starten.

172 172

173Ein `pattern`- oder `path`-Wert, der ein Null-Byte enthält, gibt einen Fehler zurück, der Claude auffordert, ihn zu entfernen. {/* min-version: 2.1.208 */}173Ein `pattern`- oder `path`-Wert, der ein Null-Byte enthält, gibt einen Fehler zurück, der Claude auffordert, ihn zu entfernen. 

174 174

175<h2 id="grep-tool-behavior">175<h2 id="grep-tool-behavior">

176 Grep-Werkzeugverhalten176 Grep-Werkzeugverhalten

180 180

181Grep basiert auf [ripgrep](https://github.com/BurntSushi/ripgrep) und verwendet ripgreps Regex-Syntax, nicht POSIX-Grep. Muster, die Regex-Metazeichen enthalten, müssen maskiert werden. Zum Beispiel erfordert das Finden von `interface{}` in Go-Code das Muster `interface\{\}`.181Grep basiert auf [ripgrep](https://github.com/BurntSushi/ripgrep) und verwendet ripgreps Regex-Syntax, nicht POSIX-Grep. Muster, die Regex-Metazeichen enthalten, müssen maskiert werden. Zum Beispiel erfordert das Finden von `interface{}` in Go-Code das Muster `interface\{\}`.

182 182

183Ein Muster, Glob oder Dateityp, den ripgrep ablehnt, gibt einen Fehler zurück, der ripgreps Diagnose enthält, damit Claude die Eingabe korrigieren und erneut suchen kann. {/* min-version: 2.1.208 */}Vor v2.1.208 meldete Claude Code eine abgelehnte Eingabe als `No files found` statt als Fehler, selbst wenn der gesuchte Text in den Zieldateien vorhanden war.183Ein Muster, Glob oder Dateityp, den ripgrep ablehnt, gibt einen Fehler zurück, der ripgreps Diagnose enthält, damit Claude die Eingabe korrigieren und erneut suchen kann. Vor v2.1.208 meldete Claude Code eine abgelehnte Eingabe als `No files found` statt als Fehler, selbst wenn der gesuchte Text in den Zieldateien vorhanden war.

184 184

185Drei Ausgabemodi steuern, was zurückkommt:185Drei Ausgabemodi steuern, was zurückkommt:

186 186

187* `files_with_matches`: nur Dateipfade, kein Zeileninhalt. Dies ist die Standardeinstellung.187* `files_with_matches`: nur Dateipfade, kein Zeileninhalt. Dies ist die Standardeinstellung.

188* `content`: übereinstimmende Zeilen mit Datei und Zeilennummer.188* `content`: übereinstimmende Zeilen mit Datei und Zeilennummer.

189* `count`: Übereinstimmungsanzahl pro Datei, gefolgt von einer Gesamtsumme über alle übereinstimmenden Dateien. {/* min-version: 2.1.208 */}Die Gesamtsumme umfasst jeden Treffer, auch wenn die Parameter `head_limit` oder `offset` des Werkzeugs die aufgelisteten Pro-Datei-Einträge kürzen. Vor v2.1.208 summierte die Gesamtsumme nur die aufgelisteten Einträge.189* `count`: Übereinstimmungsanzahl pro Datei, gefolgt von einer Gesamtsumme über alle übereinstimmenden Dateien. Die Gesamtsumme umfasst jeden Treffer, auch wenn die Parameter `head_limit` oder `offset` des Werkzeugs die aufgelisteten Pro-Datei-Einträge kürzen. Vor v2.1.208 summierte die Gesamtsumme nur die aufgelisteten Einträge.

190 190

191Claude kann Ergebnisse nach Datei mit dem `glob`-Parameter wie `**/*.tsx` oder nach Sprache mit dem `type`-Parameter wie `py` oder `rust` eingrenzen. Standardmäßig passen Muster innerhalb einer einzelnen Zeile. Claude kann `multiline: true` setzen, um über Zeilengrenzen hinweg zu passen.191Claude kann Ergebnisse nach Datei mit dem `glob`-Parameter wie `**/*.tsx` oder nach Sprache mit dem `type`-Parameter wie `py` oder `rust` eingrenzen. Standardmäßig passen Muster innerhalb einer einzelnen Zeile. Claude kann `multiline: true` setzen, um über Zeilengrenzen hinweg zu passen.

192 192

206* Implementierungen einer Schnittstelle finden206* Implementierungen einer Schnittstelle finden

207* Aufrufen-Hierarchien verfolgen207* Aufrufen-Hierarchien verfolgen

208 208

209Das Werkzeug ist inaktiv, bis Sie ein [Code-Intelligence-Plugin](/de/discover-plugins#code-intelligence) für Ihre Sprache installieren. Das Plugin bündelt die Sprachserver-Konfiguration, und Sie installieren die Server-Binärdatei separat.209Das Werkzeug ist inaktiv, bis Sie ein [Code-Intelligence-Plugin](/docs/de/discover-plugins#code-intelligence) für Ihre Sprache installieren. Das Plugin bündelt die Sprachserver-Konfiguration, und Sie installieren die Server-Binärdatei separat.

210 210

211<h2 id="monitor-tool">211<h2 id="monitor-tool">

212 Monitor-Werkzeug212 Monitor-Werkzeug

224 224

225Sie arbeiten weiter in der gleichen Sitzung und Claude interveniert, wenn ein Ereignis eintritt. Beenden Sie eine Überwachung, indem Sie Claude auffordern, sie zu stornieren, oder indem Sie die Sitzung beenden.225Sie arbeiten weiter in der gleichen Sitzung und Claude interveniert, wenn ein Ereignis eintritt. Beenden Sie eine Überwachung, indem Sie Claude auffordern, sie zu stornieren, oder indem Sie die Sitzung beenden.

226 226

227Wenn Monitor einen Befehl ausführt, verwendet es die gleichen [Berechtigungsregeln wie Bash](/de/permissions#tool-specific-permission-rules), daher gelten `allow`- und `deny`-Muster, die Sie für Bash festgelegt haben, auch hier. Die [WebSocket-Quelle](#websocket-source) hat ihre eigene Genehmigungsaufforderung.227Wenn Monitor einen Befehl ausführt, verwendet es die gleichen [Berechtigungsregeln wie Bash](/docs/de/permissions#tool-specific-permission-rules), daher gelten `allow`- und `deny`-Muster, die Sie für Bash festgelegt haben, auch hier. Die [WebSocket-Quelle](#websocket-source) hat ihre eigene Genehmigungsaufforderung.

228 228

229Das Werkzeug ist nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar. Es ist auch nicht verfügbar, wenn `DISABLE_TELEMETRY` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` gesetzt ist.229Das Werkzeug ist nicht auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verfügbar. Es ist auch nicht verfügbar, wenn `DISABLE_TELEMETRY` oder `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` gesetzt ist.

230 230

231Plugins können Monitore deklarieren, die automatisch starten, wenn das Plugin aktiv ist, anstatt Claude zu bitten, sie zu starten. Siehe [Plugin-Monitore](/de/plugins-reference#monitors).231Plugins können Monitore deklarieren, die automatisch starten, wenn das Plugin aktiv ist, anstatt Claude zu bitten, sie zu starten. Siehe [Plugin-Monitore](/docs/de/plugins-reference#monitors).

232 232

233<h3 id="websocket-source">233<h3 id="websocket-source">

234 WebSocket-Quelle234 WebSocket-Quelle

256 256

257Das Öffnen einer WebSocket fordert zur Genehmigung auf, und die Aufforderung bietet keine Option, zukünftige Aufforderungen für denselben Host zu überspringen.257Das Öffnen einer WebSocket fordert zur Genehmigung auf, und die Aufforderung bietet keine Option, zukünftige Aufforderungen für denselben Host zu überspringen.

258 258

259Claude Code lehnt URLs ab, die auf eine private, Link-Local- oder Cloud-Metadaten-Adresse verweisen, einschließlich Hostnamen, die zu einer aufgelöst werden. Es lehnt auch Hosts in `sandbox.network.deniedDomains` ab, und wenn [`allowManagedDomainsOnly`](/de/settings#sandbox-settings) in verwalteten Einstellungen gesetzt ist, jeden Host außerhalb der verwalteten Zulassungsliste.259Claude Code lehnt URLs ab, die auf eine private, Link-Local- oder Cloud-Metadaten-Adresse verweisen, einschließlich Hostnamen, die zu einer aufgelöst werden. Es lehnt auch Hosts in `sandbox.network.deniedDomains` ab, und wenn [`allowManagedDomainsOnly`](/docs/de/settings#sandbox-settings) in verwalteten Einstellungen gesetzt ist, jeden Host außerhalb der verwalteten Zulassungsliste.

260 260

261<h2 id="notebookedit-tool-behavior">261<h2 id="notebookedit-tool-behavior">

262 NotebookEdit-Werkzeugverhalten262 NotebookEdit-Werkzeugverhalten

308 308

309Drei zusätzliche Einstellungen steuern, wo PowerShell verwendet wird:309Drei zusätzliche Einstellungen steuern, wo PowerShell verwendet wird:

310 310

311* `"defaultShell": "powershell"` in [`settings.json`](/de/settings#available-settings): leitet interaktive `!`-Befehle durch PowerShell. Erfordert, dass das PowerShell-Werkzeug aktiviert ist.311* `"defaultShell": "powershell"` in [`settings.json`](/docs/de/settings#available-settings): leitet interaktive `!`-Befehle durch PowerShell. Erfordert, dass das PowerShell-Werkzeug aktiviert ist.

312* `"shell": "powershell"` auf einzelnen [Command-Hooks](/de/hooks#command-hook-fields): führt diesen Hook in PowerShell aus. Hooks starten PowerShell direkt, daher funktioniert dies unabhängig von `CLAUDE_CODE_USE_POWERSHELL_TOOL`.312* `"shell": "powershell"` auf einzelnen [Command-Hooks](/docs/de/hooks#command-hook-fields): führt diesen Hook in PowerShell aus. Hooks starten PowerShell direkt, daher funktioniert dies unabhängig von `CLAUDE_CODE_USE_POWERSHELL_TOOL`.

313* `shell: powershell` in [Skill-Frontmatter](/de/skills#frontmatter-reference): führt `` !`command` ``-Blöcke in PowerShell aus. Erfordert, dass das PowerShell-Werkzeug aktiviert ist.313* `shell: powershell` in [Skill-Frontmatter](/docs/de/skills#frontmatter-reference): führt `` !`command` ``-Blöcke in PowerShell aus. Erfordert, dass das PowerShell-Werkzeug aktiviert ist.

314 314

315Das gleiche Verhalten zum Zurücksetzen des Arbeitsverzeichnisses in der Hauptsitzung, das im Abschnitt zum Bash-Werkzeug beschrieben ist, gilt für PowerShell-Befehle, einschließlich der Umgebungsvariable `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`.315Das gleiche Verhalten zum Zurücksetzen des Arbeitsverzeichnisses in der Hauptsitzung, das im Abschnitt zum Bash-Werkzeug beschrieben ist, gilt für PowerShell-Befehle, einschließlich der Umgebungsvariable `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`.

316 316

317{/* min-version: 2.1.196 */}Ab v2.1.196 entspricht das PowerShell-Werkzeug der Behandlung von Such- und Diff-Exit-Codes durch das Bash-Werkzeug. Exit-Code 1 von `grep`, `egrep`, `fgrep` und `git grep` bedeutet keine Übereinstimmungen, und Exit-Code 1 von `git diff` bedeutet, dass Unterschiede vorhanden sind, daher werden diese Ergebnisse Claude nicht als Befehlsfehler gemeldet.317Ab v2.1.196 entspricht das PowerShell-Werkzeug der Behandlung von Such- und Diff-Exit-Codes durch das Bash-Werkzeug. Exit-Code 1 von `grep`, `egrep`, `fgrep` und `git grep` bedeutet keine Übereinstimmungen, und Exit-Code 1 von `git diff` bedeutet, dass Unterschiede vorhanden sind, daher werden diese Ergebnisse Claude nicht als Befehlsfehler gemeldet.

318 318

319<h3 id="preview-limitations">319<h3 id="preview-limitations">

320 Vorschau-Einschränkungen320 Vorschau-Einschränkungen

333 333

334Standardmäßig gibt Read die Datei vom Anfang zurück. Wenn ein Ganz-Datei-Lesevorgang das Token-Limit überschreitet, gibt Read die erste Seite mit einer `PARTIAL view`-Benachrichtigung zurück, die Claude mitteilt, wie viel der Datei er erhalten hat und wie er mit `offset` und `limit` mehr lesen kann. Ein Lesevorgang, der einen expliziten `offset` oder `limit` übergibt und immer noch das Token-Limit überschreitet, gibt einen Fehler zurück.334Standardmäßig gibt Read die Datei vom Anfang zurück. Wenn ein Ganz-Datei-Lesevorgang das Token-Limit überschreitet, gibt Read die erste Seite mit einer `PARTIAL view`-Benachrichtigung zurück, die Claude mitteilt, wie viel der Datei er erhalten hat und wie er mit `offset` und `limit` mehr lesen kann. Ein Lesevorgang, der einen expliziten `offset` oder `limit` übergibt und immer noch das Token-Limit überschreitet, gibt einen Fehler zurück.

335 335

336Ein Lesevorgang mit einem expliziten `limit` stoppt, sobald die ausgewählten Zeilen das überschreiten, was das Token-Limit jemals passen könnte, und gibt einen Fehler zurück, ohne den Rest des Bereichs zu laden. Der Fehler teilt Claude mit, einen kleineren `limit` zu verwenden, oder stattdessen mit [Grep](#grep-tool-behavior) nach spezifischem Inhalt zu suchen, wenn eine einzelne Zeile so groß ist. {/* min-version: 2.1.208 */}Vor v2.1.208 lud Claude Code den gesamten Bereich in den Speicher, bevor er ihn ablehnte, daher konnte eine Datei mit einer extrem langen einzelnen Zeile den Speicher erschöpfen.336Ein Lesevorgang mit einem expliziten `limit` stoppt, sobald die ausgewählten Zeilen das überschreiten, was das Token-Limit jemals passen könnte, und gibt einen Fehler zurück, ohne den Rest des Bereichs zu laden. Der Fehler teilt Claude mit, einen kleineren `limit` zu verwenden, oder stattdessen mit [Grep](#grep-tool-behavior) nach spezifischem Inhalt zu suchen, wenn eine einzelne Zeile so groß ist. Vor v2.1.208 lud Claude Code den gesamten Bereich in den Speicher, bevor er ihn ablehnte, daher konnte eine Datei mit einer extrem langen einzelnen Zeile den Speicher erschöpfen.

337 337

338Das Lesen einer leeren Datei gibt eine Benachrichtigung zurück, dass die Datei existiert, aber ihr Inhalt leer ist, und ein `offset` nach der letzten Zeile gibt eine Benachrichtigung zurück, die die Zeilenanzahl der Datei angibt. {/* min-version: 2.1.208 */}Vor v2.1.208 gab das Lesen einer leeren Datei stattdessen die Past-the-End-Benachrichtigung zurück.338Das Lesen einer leeren Datei gibt eine Benachrichtigung zurück, dass die Datei existiert, aber ihr Inhalt leer ist, und ein `offset` nach der letzten Zeile gibt eine Benachrichtigung zurück, die die Zeilenanzahl der Datei angibt. Vor v2.1.208 gab das Lesen einer leeren Datei stattdessen die Past-the-End-Benachrichtigung zurück.

339 339

340Read verarbeitet mehrere Dateitypen über einfachen Text hinaus:340Read verarbeitet mehrere Dateitypen über einfachen Text hinaus:

341 341

342* **Bilder**: PNG, JPG und andere Bildformate werden als visueller Inhalt zurückgegeben, den Claude sehen kann, nicht als Rohbytes. Claude Code ändert die Größe großer Bilder und komprimiert sie neu, um sie in die Bildgrößenlimits des Modells zu passen, bevor sie gesendet werden, daher kann Claude eine herunterskalierte Version eines großen Screenshots sehen. {/* min-version: 2.1.196 */}Ab v2.1.196 wird ein Bild, das nach dieser Größenänderung immer noch größer als 500 KB ist, als JPEG mit reduzierter Qualität neu codiert, wobei seine Pixeldimensionen unverändert bleiben. Wenn Claude feines Pixel-Level-Detail in einem großen Bild vermisst, bitten Sie es, die Region von Interesse zuerst zuzuschneiden, zum Beispiel mit ImageMagick über Bash.342* **Bilder**: PNG, JPG und andere Bildformate werden als visueller Inhalt zurückgegeben, den Claude sehen kann, nicht als Rohbytes. Claude Code ändert die Größe großer Bilder und komprimiert sie neu, um sie in die Bildgrößenlimits des Modells zu passen, bevor sie gesendet werden, daher kann Claude eine herunterskalierte Version eines großen Screenshots sehen. Ab v2.1.196 wird ein Bild, das nach dieser Größenänderung immer noch größer als 500 KB ist, als JPEG mit reduzierter Qualität neu codiert, wobei seine Pixeldimensionen unverändert bleiben. Wenn Claude feines Pixel-Level-Detail in einem großen Bild vermisst, bitten Sie es, die Region von Interesse zuerst zuzuschneiden, zum Beispiel mit ImageMagick über Bash.

343* **PDFs**: Claude liest kurze `.pdf`-Dateien ganz. Für PDFs länger als 10 Seiten liest es in Bereichen mit einem `pages`-Parameter wie `"1-5"` bis zu 20 Seiten auf einmal.343* **PDFs**: Claude liest kurze `.pdf`-Dateien ganz. Für PDFs länger als 10 Seiten liest es in Bereichen mit einem `pages`-Parameter wie `"1-5"` bis zu 20 Seiten auf einmal.

344* **Jupyter-Notebooks**: `.ipynb`-Dateien geben alle Zellen mit ihren Ausgaben zurück, einschließlich Code, Markdown und Visualisierungen.344* **Jupyter-Notebooks**: `.ipynb`-Dateien geben alle Zellen mit ihren Ausgaben zurück, einschließlich Code, Markdown und Visualisierungen.

345 345

360* Antworten werden 15 Minuten lang zwischengespeichert, daher geben wiederholte Abrufe derselben URL schnell zurück.360* Antworten werden 15 Minuten lang zwischengespeichert, daher geben wiederholte Abrufe derselben URL schnell zurück.

361* Wenn eine URL zu einem anderen Host umleitet, gibt WebFetch ein Textergebnis zurück, das die ursprüngliche URL und das Umleitungsziel benennt, anstatt es zu folgen. Claude ruft dann die neue URL mit einem zweiten WebFetch-Aufruf ab.361* Wenn eine URL zu einem anderen Host umleitet, gibt WebFetch ein Textergebnis zurück, das die ursprüngliche URL und das Umleitungsziel benennt, anstatt es zu folgen. Claude ruft dann die neue URL mit einem zweiten WebFetch-Aufruf ab.

362 362

363In den Standard- und `acceptEdits`-Berechtigungsmodi fordert WebFetch das erste Mal auf, wenn es eine neue Domain erreicht, mit Ausnahme einer integrierten Gruppe von vorab genehmigten Dokumentationsdomains, die ohne Aufforderung abgerufen werden. Um eine andere Domain im Voraus ohne Aufforderung zuzulassen, fügen Sie eine Berechtigungsregel wie `WebFetch(domain:example.com)` hinzu. Die `auto`- und `bypassPermissions`-[Berechtigungsmodi](/de/permissions#permission-modes) überspringen die Aufforderung vollständig.363In den Standard- und `acceptEdits`-Berechtigungsmodi fordert WebFetch das erste Mal auf, wenn es eine neue Domain erreicht, mit Ausnahme einer integrierten Gruppe von vorab genehmigten Dokumentationsdomains, die ohne Aufforderung abgerufen werden. Um eine andere Domain im Voraus ohne Aufforderung zuzulassen, fügen Sie eine Berechtigungsregel wie `WebFetch(domain:example.com)` hinzu. Die `auto`- und `bypassPermissions`-[Berechtigungsmodi](/docs/de/permissions#permission-modes) überspringen die Aufforderung vollständig.

364 364

365Eine explizite `WebFetch(domain:...)`-Regel in `deny`, `ask` oder `allow` hat Vorrang vor der vorab genehmigten Gruppe, sodass Sie eine vorab genehmigte Domain blockieren oder eine Aufforderung dafür verlangen können.365Eine explizite `WebFetch(domain:...)`-Regel in `deny`, `ask` oder `allow` hat Vorrang vor der vorab genehmigten Gruppe, sodass Sie eine vorab genehmigte Domain blockieren oder eine Aufforderung dafür verlangen können.

366 366

367WebFetch setzt einen `User-Agent`-Header, der mit `Claude-User` beginnt, und einen `Accept`-Header, der Markdown gegenüber HTML bevorzugt, damit Server, die Content-Negotiation unterstützen, Markdown direkt zurückgeben können.367WebFetch setzt einen `User-Agent`-Header, der mit `Claude-User` beginnt, und einen `Accept`-Header, der Markdown gegenüber HTML bevorzugt, damit Server, die Content-Negotiation unterstützen, Markdown direkt zurückgeben können.

368 368

369Sie konfigurieren [Sandbox](/de/sandboxing)-Netzwerkregeln separat, daher benötigt eine Domain, die ein Sandbox-Prozess erreichen soll, immer noch eine explizite Sandbox-Berechtigungsregel.369Sie konfigurieren [Sandbox](/docs/de/sandboxing)-Netzwerkregeln separat, daher benötigt eine Domain, die ein Sandbox-Prozess erreichen soll, immer noch eine explizite Sandbox-Berechtigungsregel.

370 370

371<h2 id="websearch-tool-behavior">371<h2 id="websearch-tool-behavior">

372 WebSearch-Werkzeugverhalten372 WebSearch-Werkzeugverhalten

376 376

377Das Werkzeug kann bis zu acht Backend-Suchen pro Aufruf durchführen und die Suche intern verfeinern, bevor Ergebnisse zurückgegeben werden. Claude kann Ergebnisse mit `allowed_domains` eingrenzen, um nur bestimmte Hosts einzuschließen, oder `blocked_domains`, um sie auszuschließen. Die beiden Listen können nicht in einem einzelnen Aufruf kombiniert werden.377Das Werkzeug kann bis zu acht Backend-Suchen pro Aufruf durchführen und die Suche intern verfeinern, bevor Ergebnisse zurückgegeben werden. Claude kann Ergebnisse mit `allowed_domains` eingrenzen, um nur bestimmte Hosts einzuschließen, oder `blocked_domains`, um sie auszuschließen. Die beiden Listen können nicht in einem einzelnen Aufruf kombiniert werden.

378 378

379Das Such-Backend ist nicht konfigurierbar. Um mit einem anderen Anbieter zu suchen, fügen Sie einen [MCP-Server](/de/mcp) hinzu, der ein Such-Werkzeug bereitstellt.379Das Such-Backend ist nicht konfigurierbar. Um mit einem anderen Anbieter zu suchen, fügen Sie einen [MCP-Server](/docs/de/mcp) hinzu, der ein Such-Werkzeug bereitstellt.

380 380

381WebSearch-Berechtigungsregeln nehmen keinen Specifier. Ein bloßer `WebSearch`-Eintrag in `allow` oder `deny` ist die einzige Form.381WebSearch-Berechtigungsregeln nehmen keinen Specifier. Ein bloßer `WebSearch`-Eintrag in `allow` oder `deny` ist die einzige Form.

382 382

383<Note>383<Note>

384 WebSearch ist auf der Claude API, [Claude Platform on AWS](/de/claude-platform-on-aws) und Microsoft Foundry verfügbar. Auf Google Cloud's Agent Platform funktioniert es mit Claude 4 und späteren Modellen, einschließlich Opus, Sonnet und Haiku. Amazon Bedrock stellt das serverseitige Web-Such-Werkzeug nicht bereit.384 WebSearch ist auf der Claude API, [Claude Platform on AWS](/docs/de/claude-platform-on-aws) und Microsoft Foundry verfügbar. Auf Google Cloud's Agent Platform funktioniert es mit Claude 4 und späteren Modellen, einschließlich Opus, Sonnet und Haiku. Amazon Bedrock stellt das serverseitige Web-Such-Werkzeug nicht bereit.

385</Note>385</Note>

386 386

387<h2 id="write-tool-behavior">387<h2 id="write-tool-behavior">

409Claude gibt eine Zusammenfassung im Gesprächsstil. Für genaue MCP-Werkzeugnamen führen Sie `/mcp` aus.409Claude gibt eine Zusammenfassung im Gesprächsstil. Für genaue MCP-Werkzeugnamen führen Sie `/mcp` aus.

410 410

411<Note>411<Note>

412 Das [Advisor-Tool](/de/advisor) ist ein [Server-Tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool), das die API ausführt, anstatt ein Tool, das Claude Code implementiert. Es hat keinen Namen, auf den Sie in Berechtigungsregeln oder Hook-Matchern verweisen können.412 Das [Advisor-Tool](/docs/de/advisor) ist ein [Server-Tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool), das die API ausführt, anstatt ein Tool, das Claude Code implementiert. Es hat keinen Namen, auf den Sie in Berechtigungsregeln oder Hook-Matchern verweisen können.

413</Note>413</Note>

414 414

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

416 Siehe auch416 Siehe auch

417</h2>417</h2>

418 418

419* [MCP-Server](/de/mcp): Fügen Sie benutzerdefinierte Werkzeuge durch Verbindung externer Server hinzu419* [MCP-Server](/docs/de/mcp): Fügen Sie benutzerdefinierte Werkzeuge durch Verbindung externer Server hinzu

420* [Berechtigungen](/de/permissions): Berechtigungssystem, Regelsyntax und werkzeugspezifische Muster420* [Berechtigungen](/docs/de/permissions): Berechtigungssystem, Regelsyntax und werkzeugspezifische Muster

421* [Subagents](/de/sub-agents): Konfigurieren Sie Werkzeugzugriff für Subagents421* [Subagents](/docs/de/sub-agents): Konfigurieren Sie Werkzeugzugriff für Subagents

422* [Hooks](/de/hooks-guide): Führen Sie benutzerdefinierte Befehle vor oder nach der Werkzeugausführung aus422* [Hooks](/docs/de/hooks-guide): Führen Sie benutzerdefinierte Befehle vor oder nach der Werkzeugausführung aus

troubleshoot-install.md +17 −17

Details

6 6

7> Beheben Sie Fehler wie „Befehl nicht gefunden", PATH, Berechtigungen, Netzwerk und Authentifizierungsfehler bei der Installation oder Anmeldung bei Claude Code.7> Beheben Sie Fehler wie „Befehl nicht gefunden", PATH, Berechtigungen, Netzwerk und Authentifizierungsfehler bei der Installation oder Anmeldung bei Claude Code.

8 8

9Wenn die Installation fehlschlägt oder Sie sich nicht anmelden können, finden Sie Ihren Fehler unten. Für Laufzeitprobleme nach der Installation von Claude Code siehe [Fehlerbehebung](/de/troubleshooting). Für Konfigurationsprobleme wie nicht angewendete Einstellungen oder nicht ausgelöste Hooks siehe [Konfiguration debuggen](/de/debug-your-config).9Wenn die Installation fehlschlägt oder Sie sich nicht anmelden können, finden Sie Ihren Fehler unten. Für Laufzeitprobleme nach der Installation von Claude Code siehe [Fehlerbehebung](/docs/de/troubleshooting). Für Konfigurationsprobleme wie nicht angewendete Einstellungen oder nicht ausgelöste Hooks siehe [Konfiguration debuggen](/docs/de/debug-your-config).

10 10

11<h2 id="find-your-error">11<h2 id="find-your-error">

12 Finden Sie Ihren Fehler12 Finden Sie Ihren Fehler

42| `Could not load the default credentials` oder `Could not load credentials from any providers` | [Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Anmeldedaten](#bedrock-agent-platform-or-foundry-credentials-not-loading) |42| `Could not load the default credentials` oder `Could not load credentials from any providers` | [Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Anmeldedaten](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

43| `ChainedTokenCredential authentication failed` oder `CredentialUnavailableError` | [Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Anmeldedaten](#bedrock-agent-platform-or-foundry-credentials-not-loading) |43| `ChainedTokenCredential authentication failed` oder `CredentialUnavailableError` | [Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Anmeldedaten](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

44| `API Error: 500`, `529 Overloaded`, `429` oder andere 4xx und 5xx Fehler, die oben nicht aufgeführt sind | Siehe die [Fehlerreferenz](/de/errors) |44| `API Error: 500`, `529 Overloaded`, `429` oder andere 4xx und 5xx Fehler, die oben nicht aufgeführt sind | Siehe die [Fehlerreferenz](/docs/de/errors) |

45 45

46Wenn Ihr Problem nicht aufgeführt ist, führen Sie die Diagnoseprüfungen unten durch, um die Ursache einzugrenzen.46Wenn Ihr Problem nicht aufgeführt ist, führen Sie die Diagnoseprüfungen unten durch, um die Ursache einzugrenzen.

47 47

48<Tip>48<Tip>

49 Wenn Sie das Terminal lieber ganz vermeiden möchten, können Sie mit der [Claude Code Desktop-App](/de/desktop-quickstart) Claude Code über eine grafische Benutzeroberfläche installieren und verwenden. Laden Sie sie für [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) oder [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) herunter und beginnen Sie zu programmieren, ohne dass Sie eine Befehlszeileneinrichtung benötigen. Unter Linux installieren Sie die App mit apt, indem Sie die [Linux-Installationsanweisungen](/de/desktop-linux) befolgen.49 Wenn Sie das Terminal lieber ganz vermeiden möchten, können Sie mit der [Claude Code Desktop-App](/docs/de/desktop-quickstart) Claude Code über eine grafische Benutzeroberfläche installieren und verwenden. Laden Sie sie für [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) oder [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) herunter und beginnen Sie zu programmieren, ohne dass Sie eine Befehlszeileneinrichtung benötigen. Unter Linux installieren Sie die App mit apt, indem Sie die [Linux-Installationsanweisungen](/docs/de/desktop-linux) befolgen.

50</Tip>50</Tip>

51 51

52<h2 id="run-diagnostic-checks">52<h2 id="run-diagnostic-checks">

100Wenn die Installation erfolgreich war, aber Sie einen `command not found` oder `not recognized` Fehler beim Ausführen von `claude` erhalten, befindet sich das Installationsverzeichnis nicht in Ihrem PATH. Ihre Shell sucht nach Programmen in Verzeichnissen, die in PATH aufgeführt sind, und das Installationsprogramm platziert `claude` unter `~/.local/bin/claude` auf macOS/Linux oder `%USERPROFILE%\.local\bin\claude.exe` unter Windows.100Wenn die Installation erfolgreich war, aber Sie einen `command not found` oder `not recognized` Fehler beim Ausführen von `claude` erhalten, befindet sich das Installationsverzeichnis nicht in Ihrem PATH. Ihre Shell sucht nach Programmen in Verzeichnissen, die in PATH aufgeführt sind, und das Installationsprogramm platziert `claude` unter `~/.local/bin/claude` auf macOS/Linux oder `%USERPROFILE%\.local\bin\claude.exe` unter Windows.

101 101

102<Note>102<Note>

103 Die [VS Code-Erweiterung](/de/vs-code) platziert `claude` nicht an diesem Ort. Sie bündelt eine private Kopie der CLI im Erweiterungsverzeichnis für ihr eigenes Chat-Panel und fügt sie nicht zu PATH hinzu. Wenn Sie nur die Erweiterung installiert haben, existiert `~/.local/bin/claude` nicht. Führen Sie die [eigenständige Installation](/de/setup) aus, um `claude` von einem Terminal aus zu verwenden, und fahren Sie dann unten fort.103 Die [VS Code-Erweiterung](/docs/de/vs-code) platziert `claude` nicht an diesem Ort. Sie bündelt eine private Kopie der CLI im Erweiterungsverzeichnis für ihr eigenes Chat-Panel und fügt sie nicht zu PATH hinzu. Wenn Sie nur die Erweiterung installiert haben, existiert `~/.local/bin/claude` nicht. Führen Sie die [eigenständige Installation](/docs/de/setup) aus, um `claude` von einem Terminal aus zu verwenden, und fahren Sie dann unten fort.

104</Note>104</Note>

105 105

106Überprüfen Sie, ob sich das Installationsverzeichnis in Ihrem PATH befindet, indem Sie Ihre PATH-Einträge auflisten und nach `local/bin` filtern:106Überprüfen Sie, ob sich das Installationsverzeichnis in Ihrem PATH befindet, indem Sie Ihre PATH-Einträge auflisten und nach `local/bin` filtern:

196 ls -la ~/.local/bin/claude196 ls -la ~/.local/bin/claude

197 ```197 ```

198 198

199 Eine native Installation zeigt einen Symlink in `~/.local/share/claude/versions/`. Ein Skript oder ein Symlink, den Sie selbst an diesem Pfad erstellt haben, ist ein benutzerdefinierter Launcher, den [Auto-Update an Ort und Stelle lässt](/de/setup#auto-updates).199 Eine native Installation zeigt einen Symlink in `~/.local/share/claude/versions/`. Ein Skript oder ein Symlink, den Sie selbst an diesem Pfad erstellt haben, ist ein benutzerdefinierter Launcher, den [Auto-Update an Ort und Stelle lässt](/docs/de/setup#auto-updates).

200 200

201 Wenn einer der `ls` Befehle `No such file or directory` ausgibt, ist das kein Fehler. Das bedeutet, dass an diesem Ort nichts installiert ist, also fahren Sie mit der nächsten Prüfung fort.201 Wenn einer der `ls` Befehle `No such file or directory` ausgibt, ist das kein Fehler. Das bedeutet, dass an diesem Ort nichts installiert ist, also fahren Sie mit der nächsten Prüfung fort.

202 202

294Get-Command claude | Select-Object Source294Get-Command claude | Select-Object Source

295```295```

296 296

297Überprüfen Sie unter Linux auf fehlende gemeinsame Bibliotheken. Wenn `ldd` fehlende Bibliotheken anzeigt, müssen Sie möglicherweise Systempakete installieren. Auf Alpine Linux und anderen musl-basierten Distributionen siehe [Alpine Linux-Setup](/de/setup#alpine-linux-and-musl-based-distributions).297Überprüfen Sie unter Linux auf fehlende gemeinsame Bibliotheken. Wenn `ldd` fehlende Bibliotheken anzeigt, müssen Sie möglicherweise Systempakete installieren. Auf Alpine Linux und anderen musl-basierten Distributionen siehe [Alpine Linux-Setup](/docs/de/setup#alpine-linux-and-musl-based-distributions).

298 298

299```bash theme={null}299```bash theme={null}

300ldd "$(command -v claude)" | grep "not found"300ldd "$(command -v claude)" | grep "not found"

413brew install --cask claude-code413brew install --cask claude-code

414```414```

415 415

416Wenn Homebrew eine ältere Claude Code-Version installiert als erwartet, ist normalerweise der gleiche veraltete Index die Ursache. Der `claude-code` Cask verfolgt den stabilen Kanal und liegt normalerweise etwa eine Woche hinter der neuesten Version; für die neueste Version führen Sie stattdessen `brew install --cask claude-code@latest` aus. Siehe [Konfigurieren Sie den Release-Kanal](/de/setup#configure-release-channel) für den Unterschied zwischen den beiden Casks.416Wenn Homebrew eine ältere Claude Code-Version installiert als erwartet, ist normalerweise der gleiche veraltete Index die Ursache. Der `claude-code` Cask verfolgt den stabilen Kanal und liegt normalerweise etwa eine Woche hinter der neuesten Version; für die neueste Version führen Sie stattdessen `brew install --cask claude-code@latest` aus. Siehe [Konfigurieren Sie den Release-Kanal](/docs/de/setup#configure-release-channel) für den Unterschied zwischen den beiden Casks.

417 417

418<h3 id="tls-or-ssl-connection-errors">418<h3 id="tls-or-ssl-connection-errors">

419 TLS- oder SSL-Verbindungsfehler419 TLS- oder SSL-Verbindungsfehler

468 curl -sI https://downloads.claude.ai/claude-code-releases/latest468 curl -sI https://downloads.claude.ai/claude-code-releases/latest

469 ```469 ```

470 470

4712. **Wenn Sie sich hinter einem Proxy befinden**, setzen Sie `HTTPS_PROXY`, damit das Installationsprogramm es durchleiten kann. Siehe [Proxy-Konfiguration](/de/network-config#proxy-configuration) für Details.4712. **Wenn Sie sich hinter einem Proxy befinden**, setzen Sie `HTTPS_PROXY`, damit das Installationsprogramm es durchleiten kann. Siehe [Proxy-Konfiguration](/docs/de/network-config#proxy-configuration) für Details.

472 ```bash theme={null}472 ```bash theme={null}

473 export HTTPS_PROXY=http://proxy.example.com:8080473 export HTTPS_PROXY=http://proxy.example.com:8080

474 curl -fsSL https://claude.ai/install.sh | bash474 curl -fsSL https://claude.ai/install.sh | bash

551 551

552Vor v2.1.200 beendete sich das Skript nur mit der bloßen `Killed` Zeile der Shell und ohne Erklärung.552Vor v2.1.200 beendete sich das Skript nur mit der bloßen `Killed` Zeile der Shell und ohne Erklärung.

553 553

554Die Installation benötigt ungefähr 512 MB freien Speicher, und das Ausführen von Claude Code benötigt mehr. Siehe die [Systemanforderungen](/de/setup#system-requirements).554Die Installation benötigt ungefähr 512 MB freien Speicher, und das Ausführen von Claude Code benötigt mehr. Siehe die [Systemanforderungen](/docs/de/setup#system-requirements).

555 555

556**Lösungen:**556**Lösungen:**

557 557

607 Claude Code unter Windows benötigt entweder Git für Windows (für Bash) oder PowerShell607 Claude Code unter Windows benötigt entweder Git für Windows (für Bash) oder PowerShell

608</h3>608</h3>

609 609

610Git für Windows ist optional. Claude Code verwendet das [PowerShell-Tool](/de/tools-reference#powershell-tool), wenn Git Bash nicht vorhanden ist, daher bedeutet dieser Fehler, dass keine Shell gefunden wurde.610Git für Windows ist optional. Claude Code verwendet das [PowerShell-Tool](/docs/de/tools-reference#powershell-tool), wenn Git Bash nicht vorhanden ist, daher bedeutet dieser Fehler, dass keine Shell gefunden wurde.

611 611

612**Wenn PowerShell in Ihrem PATH fehlt**, ist sein Standardort `C:\Windows\System32\WindowsPowerShell\v1.0\`. Fügen Sie dieses Verzeichnis zu Ihrem `PATH` hinzu, oder installieren Sie [PowerShell 7](https://aka.ms/powershell), das `pwsh` bereitstellt.612**Wenn PowerShell in Ihrem PATH fehlt**, ist sein Standardort `C:\Windows\System32\WindowsPowerShell\v1.0\`. Fügen Sie dieses Verzeichnis zu Ihrem `PATH` hinzu, oder installieren Sie [PowerShell 7](https://aka.ms/powershell), das `pwsh` bereitstellt.

613 613

614**Um Git für Windows stattdessen zu installieren**, laden Sie es von [git-scm.com/downloads/win](https://git-scm.com/downloads/win) herunter. Wählen Sie während der Einrichtung „Add to PATH" aus. Starten Sie Ihr Terminal nach der Installation neu. Die Installation ermöglicht das Bash-Tool, das beim Arbeiten mit Bash-basierten Skripten und Tools nützlich ist.614**Um Git für Windows stattdessen zu installieren**, laden Sie es von [git-scm.com/downloads/win](https://git-scm.com/downloads/win) herunter. Wählen Sie während der Einrichtung „Add to PATH" aus. Starten Sie Ihr Terminal nach der Installation neu. Die Installation ermöglicht das Bash-Tool, das beim Arbeiten mit Bash-basierten Skripten und Tools nützlich ist.

615 615

616**Wenn Git bereits installiert ist**, aber Claude Code kann es nicht finden, setzen Sie den Pfad in Ihrer [settings.json Datei](/de/settings):616**Wenn Git bereits installiert ist**, aber Claude Code kann es nicht finden, setzen Sie den Pfad in Ihrer [settings.json Datei](/docs/de/settings):

617 617

618```json theme={null}618```json theme={null}

619{619{

641 641

642Wenn dies `True` ausgibt, ist Ihr Betriebssystem in Ordnung. Schließen Sie das Fenster, öffnen Sie `Windows PowerShell` ohne das x86-Suffix und führen Sie den Installationsbefehl erneut aus.642Wenn dies `True` ausgibt, ist Ihr Betriebssystem in Ordnung. Schließen Sie das Fenster, öffnen Sie `Windows PowerShell` ohne das x86-Suffix und führen Sie den Installationsbefehl erneut aus.

643 643

644Wenn dies `False` ausgibt, befinden Sie sich auf einer 32-Bit-Edition von Windows. Claude Code benötigt ein 64-Bit-Betriebssystem. Siehe die [Systemanforderungen](/de/setup#system-requirements).644Wenn dies `False` ausgibt, befinden Sie sich auf einer 32-Bit-Edition von Windows. Claude Code benötigt ein 64-Bit-Betriebssystem. Siehe die [Systemanforderungen](/docs/de/setup#system-requirements).

645 645

646<h3 id="linux-musl-or-glibc-binary-mismatch">646<h3 id="linux-musl-or-glibc-binary-mismatch">

647 Linux musl oder glibc Binärvarianten-Nichtübereinstimmung647 Linux musl oder glibc Binärvarianten-Nichtübereinstimmung

737 npm-Installationsfehler in WSL737 npm-Installationsfehler in WSL

738</h3>738</h3>

739 739

740Diese Probleme gelten, wenn Sie Claude Code mit `npm install -g` in WSL installiert haben. Wenn Sie das [native Installationsprogramm](/de/setup) verwendet haben, überspringen Sie diesen Abschnitt.740Diese Probleme gelten, wenn Sie Claude Code mit `npm install -g` in WSL installiert haben. Wenn Sie das [native Installationsprogramm](/docs/de/setup) verwendet haben, überspringen Sie diesen Abschnitt.

741 741

742**Betriebssystem- oder Plattformerkennung Probleme.** Wenn npm während der Installation einen Plattform-Nichtübereinstimmung meldet, verwendet WSL wahrscheinlich das Windows `npm`. Führen Sie zuerst `npm config set os linux` aus, dann installieren Sie mit `npm install -g @anthropic-ai/claude-code --force`. Verwenden Sie nicht `sudo`.742**Betriebssystem- oder Plattformerkennung Probleme.** Wenn npm während der Installation einen Plattform-Nichtübereinstimmung meldet, verwendet WSL wahrscheinlich das Windows `npm`. Führen Sie zuerst `npm config set os linux` aus, dann installieren Sie mit `npm install -g @anthropic-ai/claude-code --force`. Verwenden Sie nicht `sudo`.

743 743

786Das `@anthropic-ai/claude-code` npm-Paket zieht die native Binärdatei durch eine pro-Plattform optionale Abhängigkeit wie `@anthropic-ai/claude-code-darwin-arm64` ein. Wenn das Ausführen von `claude` nach der Installation `Could not find native binary package "@anthropic-ai/claude-code-<platform>"` ausgibt, überprüfen Sie die folgenden Ursachen:786Das `@anthropic-ai/claude-code` npm-Paket zieht die native Binärdatei durch eine pro-Plattform optionale Abhängigkeit wie `@anthropic-ai/claude-code-darwin-arm64` ein. Wenn das Ausführen von `claude` nach der Installation `Could not find native binary package "@anthropic-ai/claude-code-<platform>"` ausgibt, überprüfen Sie die folgenden Ursachen:

787 787

788* **Optionale Abhängigkeiten sind deaktiviert.** Entfernen Sie `--omit=optional` aus Ihrem npm-Installationsbefehl, `--no-optional` von pnpm oder `--ignore-optional` von yarn, und überprüfen Sie, dass `.npmrc` nicht `optional=false` setzt. Dann installieren Sie erneut. Die native Binärdatei wird nur als optionale Abhängigkeit bereitgestellt, daher gibt es keinen JavaScript-Fallback, wenn sie übersprungen wird.788* **Optionale Abhängigkeiten sind deaktiviert.** Entfernen Sie `--omit=optional` aus Ihrem npm-Installationsbefehl, `--no-optional` von pnpm oder `--ignore-optional` von yarn, und überprüfen Sie, dass `.npmrc` nicht `optional=false` setzt. Dann installieren Sie erneut. Die native Binärdatei wird nur als optionale Abhängigkeit bereitgestellt, daher gibt es keinen JavaScript-Fallback, wenn sie übersprungen wird.

789* **Nicht unterstützte Plattform.** Vorkompilierte Binärdateien werden für `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` und `win32-arm64` veröffentlicht. Claude Code liefert keine Binärdatei für andere Plattformen; siehe die [Systemanforderungen](/de/setup#system-requirements). {/* min-version: 2.1.205 */}Auf FreeBSD meldet das Installationsprogramm die Plattform als nicht unterstützt. Vor v2.1.205 behandelte es FreeBSD als Linux und lud eine Binärdatei herunter, die nicht ausgeführt werden konnte.789* **Nicht unterstützte Plattform.** Vorkompilierte Binärdateien werden für `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` und `win32-arm64` veröffentlicht. Claude Code liefert keine Binärdatei für andere Plattformen; siehe die [Systemanforderungen](/docs/de/setup#system-requirements). Auf FreeBSD meldet das Installationsprogramm die Plattform als nicht unterstützt. Vor v2.1.205 behandelte es FreeBSD als Linux und lud eine Binärdatei herunter, die nicht ausgeführt werden konnte.

790* **Unternehmens-npm-Spiegel fehlen die Plattform-Pakete.** Stellen Sie sicher, dass Ihr Registry alle acht `@anthropic-ai/claude-code-*` Plattform-Pakete zusätzlich zum Meta-Paket spiegelt.790* **Unternehmens-npm-Spiegel fehlen die Plattform-Pakete.** Stellen Sie sicher, dass Ihr Registry alle acht `@anthropic-ai/claude-code-*` Plattform-Pakete zusätzlich zum Meta-Paket spiegelt.

791 791

792Die Installation mit `--ignore-scripts` löst diesen Fehler nicht aus. Der Postinstall-Schritt, der die Binärdatei verknüpft, wird übersprungen, daher fällt Claude Code auf einen Wrapper zurück, der die Plattform-Binärdatei bei jedem Start findet und startet. Dies funktioniert, aber startet langsamer; installieren Sie mit aktivierten Skripten für direkte Ausführung erneut.792Die Installation mit `--ignore-scripts` löst diesen Fehler nicht aus. Der Postinstall-Schritt, der die Binärdatei verknüpft, wird übersprungen, daher fällt Claude Code auf einen Wrapper zurück, der die Plattform-Binärdatei bei jedem Start findet und startet. Dies funktioniert, aber startet langsamer; installieren Sie mit aktivierten Skripten für direkte Ausführung erneut.

829 829

830* **Claude Pro/Max-Benutzer**: Überprüfen Sie, dass Ihr Abonnement unter [claude.ai/settings](https://claude.ai/settings) aktiv ist830* **Claude Pro/Max-Benutzer**: Überprüfen Sie, dass Ihr Abonnement unter [claude.ai/settings](https://claude.ai/settings) aktiv ist

831* **Anthropic Console-Benutzer**: Bestätigen Sie, dass Ihr Konto die Rolle „Claude Code" oder „Developer" hat. Admins weisen dies in der Anthropic Console unter Einstellungen → Mitglieder zu.831* **Anthropic Console-Benutzer**: Bestätigen Sie, dass Ihr Konto die Rolle „Claude Code" oder „Developer" hat. Admins weisen dies in der Anthropic Console unter Einstellungen → Mitglieder zu.

832* **Hinter einem Proxy**: Unternehmens-Proxys können API-Anfragen beeinträchtigen. Siehe [Netzwerkkonfiguration](/de/network-config) für Proxy-Einrichtung.832* **Hinter einem Proxy**: Unternehmens-Proxys können API-Anfragen beeinträchtigen. Siehe [Netzwerkkonfiguration](/docs/de/network-config) für Proxy-Einrichtung.

833 833

834<h3 id="this-organization-has-been-disabled-with-an-active-subscription">834<h3 id="this-organization-has-been-disabled-with-an-active-subscription">

835 Diese Organisation wurde mit einem aktiven Abonnement deaktiviert835 Diese Organisation wurde mit einem aktiven Abonnement deaktiviert

837 837

838Wenn 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.838Wenn 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.

839 839

840Wenn `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](/de/authentication#authentication-precedence) für die vollständige Auflösungsreihenfolge.840Wenn `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.

841 841

842Um stattdessen Ihr Abonnement zu verwenden, heben Sie die Umgebungsvariable auf und entfernen Sie sie aus Ihrem Shell-Profil:842Um stattdessen Ihr Abonnement zu verwenden, heben Sie die Umgebungsvariable auf und entfernen Sie sie aus Ihrem Shell-Profil:

843 843

907 907

908Wenn Anmeldedaten in Ihrem Terminal funktionieren, aber nicht in der VS Code oder JetBrains-Erweiterung, hat der IDE-Prozess wahrscheinlich Ihre Shell-Umgebung nicht geerbt. Setzen Sie die Anbieter-Umgebungsvariablen in den IDE-eigenen Einstellungen, oder starten Sie die IDE von einem Terminal aus, in dem sie bereits exportiert sind.908Wenn Anmeldedaten in Ihrem Terminal funktionieren, aber nicht in der VS Code oder JetBrains-Erweiterung, hat der IDE-Prozess wahrscheinlich Ihre Shell-Umgebung nicht geerbt. Setzen Sie die Anbieter-Umgebungsvariablen in den IDE-eigenen Einstellungen, oder starten Sie die IDE von einem Terminal aus, in dem sie bereits exportiert sind.

909 909

910Siehe [Amazon Bedrock](/de/amazon-bedrock), [Google Cloud's Agent Platform](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) für die vollständige Anbieter-Einrichtung.910Siehe [Amazon Bedrock](/docs/de/amazon-bedrock), [Google Cloud's Agent Platform](/docs/de/google-vertex-ai) oder [Microsoft Foundry](/docs/de/microsoft-foundry) für die vollständige Anbieter-Einrichtung.

911 911

912<h2 id="still-stuck">912<h2 id="still-stuck">

913 Immer noch festgefahren913 Immer noch festgefahren

ultraplan.md +0 −96 deleted

File Deleted View Diff

~~1> ## Documentation Index~~

~~2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt~~

~~3> Use this file to discover all available pages before exploring further.~~

~~5# Mit Ultraplan in der Cloud planen~~

~~7> Starten Sie einen Plan von Ihrer CLI aus, entwerfen Sie ihn auf Claude Code im Web und führen Sie ihn dann remote aus oder zurück in Ihrem Terminal~~

~~9<Note>~~

~~10 Ultraplan befindet sich in der Forschungsvorschau. Verhalten und Funktionen können sich basierend auf Feedback ändern.~~

~~11</Note>~~

13Ultraplan übergibt eine Planungsaufgabe von Ihrer lokalen CLI an eine [Claude Code im Web](/de/claude-code-on-the-web)-Sitzung, die im [Plan Mode](/de/permission-modes#analyze-before-you-edit-with-plan-mode) ausgeführt wird. Claude entwirft den Plan in der Cloud, während Sie weiterhin in Ihrem Terminal arbeiten. Wenn der Plan fertig ist, öffnen Sie ihn in Ihrem Browser, um Kommentare zu bestimmten Abschnitten zu hinterlassen, Überarbeitungen anzufordern und auszuwählen, wo er ausgeführt werden soll.

~~15Dies ist nützlich, wenn Sie eine umfangreichere Überprüfungsoberfläche benötigen, als das Terminal bietet:~~

~~17* **Gezieltes Feedback**: Kommentieren Sie einzelne Abschnitte des Plans, anstatt auf das Ganze zu antworten~~

~~18* **Freihändiger Entwurf**: Der Plan wird remote generiert, sodass Ihr Terminal für andere Arbeiten frei bleibt~~

~~19* **Flexible Ausführung**: Genehmigen Sie den Plan zur Ausführung im Web und öffnen Sie einen Pull Request, oder senden Sie ihn zurück an Ihr Terminal~~

21Ultraplan erfordert ein [Claude Code im Web](/de/claude-code-on-the-web)-Konto und ein GitHub-Repository. Da es auf der Cloud-Infrastruktur von Anthropic ausgeführt wird, ist es nicht verfügbar, wenn Sie Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry verwenden. Die Cloud-Sitzung wird in der Standard-[Cloud-Umgebung](/de/claude-code-on-the-web#the-cloud-environment) Ihres Kontos ausgeführt. Wenn Sie noch keine Cloud-Umgebung haben, erstellt Ultraplan beim ersten Start automatisch eine.

~~23<h2 id="launch-ultraplan-from-the-cli">~~

~~24 Ultraplan von der CLI aus starten~~

~~25</h2>~~

~~27Von Ihrer lokalen CLI-Sitzung aus können Sie Ultraplan auf drei Arten starten:~~

~~29* **Befehl**: Führen Sie `/ultraplan` gefolgt von Ihrer Eingabeaufforderung aus~~

~~30* **Schlüsselwort**: Fügen Sie das Wort `ultraplan` überall in einer normalen Eingabeaufforderung ein~~

31* **Aus einem lokalen Plan**: Wenn Claude einen lokalen Plan fertigstellt und den Genehmigungsdialog anzeigt, wählen Sie **Nein, mit Ultraplan auf Claude Code im Web verfeinern**, um den Entwurf zur Cloud zur weiteren Iteration zu senden

~~33Um beispielsweise eine Service-Migration mit dem Befehl zu planen:~~

~~35```~~

~~36/ultraplan migrate the auth service from sessions to JWTs~~

~~37```~~

39Die Befehls- und Schlüsselwortpfade öffnen einen Bestätigungsdialog vor dem Start. Der lokale Plan-Pfad überspringt diesen Dialog, da diese Auswahl bereits als Bestätigung dient. Wenn [Remote Control](/de/remote-control) aktiv ist, wird die Verbindung getrennt, wenn Ultraplan startet, da beide Funktionen die claude.ai/code-Schnittstelle belegen und nur eine gleichzeitig verbunden sein kann.

~~41Nachdem die Cloud-Sitzung startet, zeigt die Eingabeaufforderung Ihrer CLI einen Statusindikator an, während die Cloud-Sitzung funktioniert:~~

~~43| Status | Bedeutung |~~

~~44| :----------------------------- | :-------------------------------------------------------------------------- |~~

~~45| `◇ ultraplan` | Claude recherchiert Ihre Codebasis und entwirft den Plan |~~

~~46| `◇ ultraplan needs your input` | Claude hat eine Klärungsfrage; öffnen Sie den Sitzungslink, um zu antworten |~~

~~47| `◆ ultraplan ready` | Der Plan ist bereit zur Überprüfung in Ihrem Browser |~~

49Führen Sie `/tasks` aus und wählen Sie den Ultraplan-Eintrag, um eine Detailansicht mit dem Sitzungslink, der Agent-Aktivität und einer **Stop ultraplan**-Aktion zu öffnen. Das Beenden archiviert die Cloud-Sitzung und löscht den Indikator; nichts wird in Ihrem Terminal gespeichert.

~~51<h2 id="review-and-revise-the-plan-in-your-browser">~~

~~52 Überprüfen und überarbeiten Sie den Plan in Ihrem Browser~~

~~53</h2>~~

~~55Wenn sich der Status zu `◆ ultraplan ready` ändert, öffnen Sie den Sitzungslink, um den Plan auf claude.ai anzuzeigen. Der Plan wird in einer dedizierten Überprüfungsansicht angezeigt:~~

~~57* **Inline-Kommentare**: Markieren Sie einen beliebigen Abschnitt und hinterlassen Sie einen Kommentar, damit Claude ihn bearbeitet~~

~~58* **Emoji-Reaktionen**: Reagieren Sie auf einen Abschnitt, um Zustimmung oder Bedenken zu signalisieren, ohne einen vollständigen Kommentar zu schreiben~~

~~59* **Gliederungs-Seitenleiste**: Springen Sie zwischen Abschnitten des Plans~~

61Wenn Sie Claude auffordern, Ihre Kommentare zu bearbeiten, überarbeitet er den Plan und präsentiert einen aktualisierten Entwurf. Sie können so oft iterieren, wie nötig, bevor Sie auswählen, wo Sie ihn ausführen möchten.

~~63<h2 id="choose-where-to-execute">~~

~~64 Wählen Sie aus, wo Sie ausführen möchten~~

~~65</h2>~~

~~67Wenn der Plan richtig aussieht, wählen Sie im Browser aus, ob Claude ihn in derselben Cloud-Sitzung implementiert oder ihn zurück an Ihr wartendes Terminal sendet.~~

~~69<h3 id="execute-on-the-web">~~

~~70 Im Web ausführen~~

~~71</h3>~~

73Wählen Sie **Genehmigen Sie Claudes Plan und starten Sie das Codieren** in Ihrem Browser, damit Claude ihn in derselben Claude Code im Web-Sitzung implementiert. Ihr Terminal zeigt eine Bestätigung an, der Statusindikator wird gelöscht und die Arbeit wird in der Cloud fortgesetzt. Wenn die Implementierung abgeschlossen ist, [überprüfen Sie die Unterschiede](/de/claude-code-on-the-web#review-changes) und erstellen Sie einen Pull Request über die Web-Schnittstelle.

~~75<h3 id="send-the-plan-back-to-your-terminal">~~

~~76 Senden Sie den Plan zurück an Ihr Terminal~~

~~77</h3>~~

79Wählen Sie **Plan genehmigen und zurück zum Terminal teleportieren** in Ihrem Browser, um den Plan lokal mit vollständigem Zugriff auf Ihre Umgebung zu implementieren. Diese Option wird angezeigt, wenn die Sitzung von Ihrer CLI aus gestartet wurde und das Terminal noch abgefragt wird. Die Web-Sitzung wird archiviert, sodass sie nicht parallel weiterarbeitet.

~~81Ihr Terminal zeigt den Plan in einem Dialog mit dem Titel **Ultraplan genehmigt** mit drei Optionen:~~

~~83* **Hier implementieren**: Injizieren Sie den Plan in Ihre aktuelle Konversation und fahren Sie fort, wo Sie aufgehört haben~~

~~84* **Neue Sitzung starten**: Löschen Sie die aktuelle Konversation und beginnen Sie neu mit nur dem Plan als Kontext~~

~~85* **Abbrechen**: Speichern Sie den Plan in einer Datei, ohne ihn auszuführen; Claude gibt den Dateipfad aus, damit Sie später darauf zurückgreifen können~~

~~87Wenn Sie eine neue Sitzung starten, gibt Claude oben einen `claude --resume`-Befehl aus, damit Sie später zu Ihrer vorherigen Konversation zurückkehren können.~~

~~89<h2 id="related-resources">~~

~~90 Verwandte Ressourcen~~

~~91</h2>~~

~~93* [Claude Code im Web](/de/claude-code-on-the-web): die Cloud-Infrastruktur, auf der Ultraplan ausgeführt wird~~

~~94* [Plan Mode](/de/permission-modes#analyze-before-you-edit-with-plan-mode): wie die Planung in einer lokalen Sitzung funktioniert~~

~~95* [Fehler mit Ultrareview finden](/de/ultrareview): das Code-Review-Gegenstück zu Ultraplan zum Abfangen von Problemen vor dem Merge~~

~~96* [Remote Control](/de/remote-control): Verwenden Sie die claude.ai/code-Schnittstelle mit einer Sitzung, die auf Ihrem eigenen Computer ausgeführt wird~~

voice-dictation.md +16 −16

Details

12 Tap-Modus erfordert Claude Code v2.1.116 oder später. Überprüfen Sie Ihre Version mit `claude --version`.12 Tap-Modus erfordert Claude Code v2.1.116 oder später. Überprüfen Sie Ihre Version mit `claude --version`.

13</Note>13</Note>

14 14

15Die Erfassung funktioniert auch in der [Agent-Ansicht](/de/agent-view#peek-and-reply). Halten Sie Ihre Push-to-Talk-Taste gedrückt oder tippen Sie darauf, während die Dispatch-Eingabe oder eine Peek-Panel-Antwort fokussiert ist, um zu einer Hintergrund-Sitzung zu diktieren.15Die Erfassung funktioniert auch in der [Agent-Ansicht](/docs/de/agent-view#peek-and-reply). Halten Sie Ihre Push-to-Talk-Taste gedrückt oder tippen Sie darauf, während die Dispatch-Eingabe oder eine Peek-Panel-Antwort fokussiert ist, um zu einer Hintergrund-Sitzung zu diktieren.

16 16

17<h2 id="requirements">17<h2 id="requirements">

18 Anforderungen18 Anforderungen

22 22

23* **Ein Claude.ai-Konto**: Der Sprache-zu-Text-Dienst ist nur verfügbar, wenn Sie sich mit einem authentifizieren, und ist nicht verfügbar, wenn Claude Code für die Verwendung eines Anthropic API-Schlüssels direkt, Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry konfiguriert ist.23* **Ein Claude.ai-Konto**: Der Sprache-zu-Text-Dienst ist nur verfügbar, wenn Sie sich mit einem authentifizieren, und ist nicht verfügbar, wenn Claude Code für die Verwendung eines Anthropic API-Schlüssels direkt, Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry konfiguriert ist.

24* **Eine Organisation ohne aktivierte HIPAA-Compliance**: `/voice` zeigt `Voice mode is disabled by your organization's policy` an, wenn diese Einschränkung gilt.24* **Eine Organisation ohne aktivierte HIPAA-Compliance**: `/voice` zeigt `Voice mode is disabled by your organization's policy` an, wenn diese Einschränkung gilt.

~~25* **Ein lokales Mikrofon**: Die Spracherfassung funktioniert nicht in Remote-Umgebungen wie [Claude Code im Web](/de/claude-code-on-the-web) oder SSH-Sitzungen.~~25* **Ein lokales Mikrofon**: Die Spracherfassung funktioniert nicht in Remote-Umgebungen wie [Claude Code im Web](/docs/de/claude-code-on-the-web) oder SSH-Sitzungen.

26* **WSLg, wenn Sie Claude Code in WSL ausführen**: WSLg ist in WSL2 enthalten, wenn es unter Windows 10 oder 11 aus dem Microsoft Store installiert wird. Wenn WSLg nicht verfügbar ist, beispielsweise unter WSL1, führen Sie Claude Code stattdessen nativ unter Windows aus.26* **WSLg, wenn Sie Claude Code in WSL ausführen**: WSLg ist in WSL2 enthalten, wenn es unter Windows 10 oder 11 aus dem Microsoft Store installiert wird. Wenn WSLg nicht verfügbar ist, beispielsweise unter WSL1, führen Sie Claude Code stattdessen nativ unter Windows aus.

27 27

28Die Transkription verbraucht keine Claude-Nachrichten oder Token und wird nicht auf die in `/usage` angezeigten Limits angerechnet. Siehe [Datennutzung](/de/data-usage) für Informationen darüber, wie Anthropic Ihre Daten verarbeitet.28Die Transkription verbraucht keine Claude-Nachrichten oder Token und wird nicht auf die in `/usage` angezeigten Limits angerechnet. Siehe [Datennutzung](/docs/de/data-usage) für Informationen darüber, wie Anthropic Ihre Daten verarbeitet.

29 29

30Die Audioaufnahme verwendet ein integriertes natives Modul unter macOS, Linux und Windows. Unter Linux wird Claude Code auf `arecord` aus ALSA-Dienstprogrammen oder `rec` aus SoX zurückgreifen, wenn das native Modul nicht geladen werden kann. Wenn keines verfügbar ist, gibt `/voice` einen Installationsbefehl für Ihren Paketmanager aus.30Die Audioaufnahme verwendet ein integriertes natives Modul unter macOS, Linux und Windows. Unter Linux wird Claude Code auf `arecord` aus ALSA-Dienstprogrammen oder `rec` aus SoX zurückgreifen, wenn das native Modul nicht geladen werden kann. Wenn keines verfügbar ist, gibt `/voice` einen Installationsbefehl für Ihren Paketmanager aus.

31 31

32Die Claude Code [VS Code-Erweiterung](/de/vs-code) unterstützt auch Spracherfassung mit derselben Claude.ai-Kontoanforderung. Sie ist nicht in VS Code Remote-Sitzungen verfügbar, einschließlich SSH, Dev Containers und Codespaces, da sich das Mikrofon auf Ihrem lokalen Computer befindet und die Erweiterung auf dem Remote-Host ausgeführt wird.32Die Claude Code [VS Code-Erweiterung](/docs/de/vs-code) unterstützt auch Spracherfassung mit derselben Claude.ai-Kontoanforderung. Sie ist nicht in VS Code Remote-Sitzungen verfügbar, einschließlich SSH, Dev Containers und Codespaces, da sich das Mikrofon auf Ihrem lokalen Computer befindet und die Erweiterung auf dem Remote-Host ausgeführt wird.

33 33

34<h2 id="enable-voice-dictation">34<h2 id="enable-voice-dictation">

35 Spracherfassung aktivieren35 Spracherfassung aktivieren

51| `/voice tap` | Im [Tippen-Modus](#tap-to-record-and-send) aktivieren |51| `/voice tap` | Im [Tippen-Modus](#tap-to-record-and-send) aktivieren |

52| `/voice off` | Deaktivieren |52| `/voice off` | Deaktivieren |

53 53

~~54Die Spracherfassung bleibt über Sitzungen hinweg erhalten. Legen Sie sie direkt in Ihrer [Benutzereinstellungsdatei](/de/settings) fest, anstatt `/voice` auszuführen:~~54Die Spracherfassung bleibt über Sitzungen hinweg erhalten. Legen Sie sie direkt in Ihrer [Benutzereinstellungsdatei](/docs/de/settings) fest, anstatt `/voice` auszuführen:

55 55

56```json theme={null}56```json theme={null}

57{57{

62}62}

63```63```

64 64

65Während die Spracherfassung aktiviert ist, zeigt die Eingabefußzeile einen `hold space to speak`-Hinweis an, wenn die Eingabeaufforderung leer ist. Der Hinweis spiegelt Ihre aktuelle `voice:pushToTalk`-Bindung wider und wird aktualisiert, wenn Sie [die Erfassungstaste neu zuordnen](#rebind-the-dictation-key). Der Hinweistext ist in beiden Modi gleich und wird nicht angezeigt, wenn Sie eine [benutzerdefinierte Statuszeile](/de/statusline) konfiguriert haben.65Während die Spracherfassung aktiviert ist, zeigt die Eingabefußzeile einen `hold space to speak`-Hinweis an, wenn die Eingabeaufforderung leer ist. Der Hinweis spiegelt Ihre aktuelle `voice:pushToTalk`-Bindung wider und wird aktualisiert, wenn Sie [die Erfassungstaste neu zuordnen](#rebind-the-dictation-key). Der Hinweistext ist in beiden Modi gleich und wird nicht angezeigt, wenn Sie eine [benutzerdefinierte Statuszeile](/docs/de/statusline) konfiguriert haben.

66 66

67Die Transkription ist in beiden Modi auf Codierungsvokabular abgestimmt. Häufige Entwicklungsbegriffe wie `regex`, `OAuth`, `JSON` und `localhost` werden korrekt erkannt, und Ihr aktueller Projektname und Git-Branch-Name werden automatisch als Erkennungshinweise hinzugefügt.67Die Transkription ist in beiden Modi auf Codierungsvokabular abgestimmt. Häufige Entwicklungsbegriffe wie `regex`, `OAuth`, `JSON` und `localhost` werden korrekt erkannt, und Ihr aktueller Projektname und Git-Branch-Name werden automatisch als Erkennungshinweise hinzugefügt.

68 68

108 Ändern Sie die Erfassungssprache108 Ändern Sie die Erfassungssprache

109</h2>109</h2>

110 110

111Die Spracherfassung verwendet die gleiche [`language`-Einstellung](/de/settings), die die Antwortsprache von Claude steuert. Wenn diese Einstellung leer ist, wird die Erfassung standardmäßig auf Englisch eingestellt. In der VS Code-Erweiterung wird die Erfassung, wenn `language` leer ist, die `accessibility.voice.speechLanguage`-Einstellung von VS Code verwenden, bevor sie auf Englisch zurückfällt.111Die Spracherfassung verwendet die gleiche [`language`-Einstellung](/docs/de/settings), die die Antwortsprache von Claude steuert. Wenn diese Einstellung leer ist, wird die Erfassung standardmäßig auf Englisch eingestellt. In der VS Code-Erweiterung wird die Erfassung, wenn `language` leer ist, die `accessibility.voice.speechLanguage`-Einstellung von VS Code verwenden, bevor sie auf Englisch zurückfällt.

112 112

113<Accordion title="Unterstützte Erfassungssprachen">113<Accordion title="Unterstützte Erfassungssprachen">

114 | Sprache | Code |114 | Sprache | Code |

149 Binden Sie die Erfassungstaste neu149 Binden Sie die Erfassungstaste neu

150</h2>150</h2>

151 151

152Die Erfassungstaste ist an `voice:pushToTalk` im `Chat`-Kontext gebunden und wird standardmäßig auf `Space` eingestellt. Die gleiche Bindung steuert sowohl den Halten- als auch den Tippen-Modus. Binden Sie sie in [`~/.claude/keybindings.json`](/de/keybindings) neu:152Die Erfassungstaste ist an `voice:pushToTalk` im `Chat`-Kontext gebunden und wird standardmäßig auf `Space` eingestellt. Die gleiche Bindung steuert sowohl den Halten- als auch den Tippen-Modus. Binden Sie sie in [`~/.claude/keybindings.json`](/docs/de/keybindings) neu:

153 153

154```json theme={null}154```json theme={null}

155{155{

169 169

170Im Halten-Modus vermeiden Sie das Binden einer bloßen Buchstabentaste wie `v`, da die Halten-Erkennung auf Tastenwiederholung angewiesen ist und der Buchstabe während der Aufwärmphase in die Eingabeaufforderung eingegeben wird. Verwenden Sie `Space` oder eine Modifikatorkombination wie `meta+k`, um die Aufnahme beim ersten Tastendruck ohne Aufwärmphase zu starten. Der Tippen-Modus hat keine Aufwärmphase, daher funktioniert jede Taste.170Im Halten-Modus vermeiden Sie das Binden einer bloßen Buchstabentaste wie `v`, da die Halten-Erkennung auf Tastenwiederholung angewiesen ist und der Buchstabe während der Aufwärmphase in die Eingabeaufforderung eingegeben wird. Verwenden Sie `Space` oder eine Modifikatorkombination wie `meta+k`, um die Aufnahme beim ersten Tastendruck ohne Aufwärmphase zu starten. Der Tippen-Modus hat keine Aufwärmphase, daher funktioniert jede Taste.

171 171

172Einige Tasten werden nicht an Terminalanwendungen übermittelt und können überhaupt nicht gebunden werden. Beispielsweise zeigt `Caps Lock` einen Fehler an, wenn Sie versuchen, es zu binden. Siehe [Tastaturkürzel anpassen](/de/keybindings) für die vollständige Tastenbindungssyntax und die Liste der reservierten Tastenkombinationen.172Einige Tasten werden nicht an Terminalanwendungen übermittelt und können überhaupt nicht gebunden werden. Beispielsweise zeigt `Caps Lock` einen Fehler an, wenn Sie versuchen, es zu binden. Siehe [Tastaturkürzel anpassen](/docs/de/keybindings) für die vollständige Tastenbindungssyntax und die Liste der reservierten Tastenkombinationen.

173 173

174<h2 id="troubleshooting">174<h2 id="troubleshooting">

175 Fehlerbehebung175 Fehlerbehebung

181* **`Voice mode is disabled by your organization's policy`**: Die Spracherfassungsfunktion ist durch die Compliance-Konfiguration Ihrer Organisation deaktiviert, wie in [Anforderungen](#requirements) beschrieben. Kontaktieren Sie Ihren Organisationsadministrator, um zu bestätigen, ob die Spracherfassung für Ihre Organisation verfügbar ist.181* **`Voice mode is disabled by your organization's policy`**: Die Spracherfassungsfunktion ist durch die Compliance-Konfiguration Ihrer Organisation deaktiviert, wie in [Anforderungen](#requirements) beschrieben. Kontaktieren Sie Ihren Organisationsadministrator, um zu bestätigen, ob die Spracherfassung für Ihre Organisation verfügbar ist.

182* **`Microphone access is denied`**: Gewähren Sie Ihrem Terminal in den Systemeinstellungen Mikrofonberechtigung. Unter macOS gehen Sie zu Systemeinstellungen → Datenschutz & Sicherheit → Mikrofon und aktivieren Sie Ihre Terminal-App, führen Sie dann `/voice` erneut aus. Unter Windows gehen Sie zu Einstellungen → Datenschutz & Sicherheit → Mikrofon und aktivieren Sie den Mikrofonzugriff für Desktop-Apps, führen Sie dann `/voice` erneut aus. Wenn Ihr Terminal nicht in den macOS-Einstellungen aufgeführt ist, siehe [Terminal nicht in macOS-Mikrofoneinstellungen aufgeführt](#terminal-not-listed-in-macos-microphone-settings).182* **`Microphone access is denied`**: Gewähren Sie Ihrem Terminal in den Systemeinstellungen Mikrofonberechtigung. Unter macOS gehen Sie zu Systemeinstellungen → Datenschutz & Sicherheit → Mikrofon und aktivieren Sie Ihre Terminal-App, führen Sie dann `/voice` erneut aus. Unter Windows gehen Sie zu Einstellungen → Datenschutz & Sicherheit → Mikrofon und aktivieren Sie den Mikrofonzugriff für Desktop-Apps, führen Sie dann `/voice` erneut aus. Wenn Ihr Terminal nicht in den macOS-Einstellungen aufgeführt ist, siehe [Terminal nicht in macOS-Mikrofoneinstellungen aufgeführt](#terminal-not-listed-in-macos-microphone-settings).

183* **`No audio recording tool found` unter Linux**: Das native Audiomodul konnte nicht geladen werden und kein Fallback ist installiert. Installieren Sie SoX mit dem im Fehlermeldung angezeigten Befehl, z. B. `sudo apt-get install sox`.183* **`No audio recording tool found` unter Linux**: Das native Audiomodul konnte nicht geladen werden und kein Fallback ist installiert. Installieren Sie SoX mit dem im Fehlermeldung angezeigten Befehl, z. B. `sudo apt-get install sox`.

184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX ist installiert, aber der Host hat kein Audioaufnahmegerät, z. B. einen Server ohne Kopfhörer oder einen Container. Führen Sie Claude Code auf einem Computer mit einem Mikrofon aus. {/* min-version: 2.1.195 */}Ab v2.1.195 meldet Claude Code unter Linux diese Meldung in dieser Situation; frühere Versionen forderten Sie auf, SoX zu installieren, auch wenn es bereits installiert war.184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX ist installiert, aber der Host hat kein Audioaufnahmegerät, z. B. einen Server ohne Kopfhörer oder einen Container. Führen Sie Claude Code auf einem Computer mit einem Mikrofon aus. Ab v2.1.195 meldet Claude Code unter Linux diese Meldung in dieser Situation; frühere Versionen forderten Sie auf, SoX zu installieren, auch wenn es bereits installiert war.

185* **`Voice mode could not find a working audio recorder in WSL`**: WSLg leitet Audio über PulseAudio statt über ein ALSA-Gerät weiter, daher muss das PulseAudio-Backend von SoX explizit installiert werden. Führen Sie `sudo apt install sox libsox-fmt-pulse` aus. Die Installation von `sox` allein zieht das ALSA-Backend mit sich, das unter WSL nicht aufnehmen kann, da es kein `/dev/snd`-Gerät gibt.185* **`Voice mode could not find a working audio recorder in WSL`**: WSLg leitet Audio über PulseAudio statt über ein ALSA-Gerät weiter, daher muss das PulseAudio-Backend von SoX explizit installiert werden. Führen Sie `sudo apt install sox libsox-fmt-pulse` aus. Die Installation von `sox` allein zieht das ALSA-Backend mit sich, das unter WSL nicht aufnehmen kann, da es kein `/dev/snd`-Gerät gibt.

186* **`Voice input is failing repeatedly and has been paused`**: Die Spracherfassung ist mehrmals hintereinander fehlgeschlagen und hat versucht, neue Sitzungen zu stoppen, bis eine erfolgreich ist. Ein Fehler zählt, ob das Mikrofon nicht startet oder der Rekorder startet und dann stoppt, ohne Audio zu produzieren. Dies bedeutet normalerweise, dass das Mikrofon oder der Audiostapel auf diesem Host keinen Audio erfassen kann, z. B. ein Server ohne Kopfhörer, eine Remote-Shell ohne Audio-Durchleitung oder eine verweigerte Mikrofonberechtigung. Bestätigen Sie ein funktionierendes Eingabegerät, beheben Sie die zugrunde liegende Ursache aus den obigen Einträgen und lösen Sie dann die Spracherfassung erneut aus. {/* min-version: 2.1.202 */}Vor v2.1.202 zählten nur Start-Fehler zur Pause.186* **`Voice input is failing repeatedly and has been paused`**: Die Spracherfassung ist mehrmals hintereinander fehlgeschlagen und hat versucht, neue Sitzungen zu stoppen, bis eine erfolgreich ist. Ein Fehler zählt, ob das Mikrofon nicht startet oder der Rekorder startet und dann stoppt, ohne Audio zu produzieren. Dies bedeutet normalerweise, dass das Mikrofon oder der Audiostapel auf diesem Host keinen Audio erfassen kann, z. B. ein Server ohne Kopfhörer, eine Remote-Shell ohne Audio-Durchleitung oder eine verweigerte Mikrofonberechtigung. Bestätigen Sie ein funktionierendes Eingabegerät, beheben Sie die zugrunde liegende Ursache aus den obigen Einträgen und lösen Sie dann die Spracherfassung erneut aus. Vor v2.1.202 zählten nur Start-Fehler zur Pause.

187* **Nichts passiert, wenn Sie `Space` im Halten-Modus halten**: Beobachten Sie die Eingabeaufforderung, während Sie halten. Wenn sich Leerzeichen weiter ansammeln, ist die Spracherfassung wahrscheinlich aus; führen Sie `/voice hold` aus, um sie zu aktivieren. Wenn nur ein oder zwei Leerzeichen erscheinen und dann nichts, ist die Spracherfassung an, aber die Halten-Erkennung wird nicht ausgelöst. Die Halten-Erkennung erfordert, dass Ihr Terminal Tastenwiederholungsereignisse sendet, daher kann es eine gehaltene Taste nicht erkennen, wenn die Tastenwiederholung auf Betriebssystemebene deaktiviert ist. Wechseln Sie mit `/voice tap` zum Tippen-Modus, um die Tastenwiederholungsanforderung zu vermeiden.187* **Nichts passiert, wenn Sie `Space` im Halten-Modus halten**: Beobachten Sie die Eingabeaufforderung, während Sie halten. Wenn sich Leerzeichen weiter ansammeln, ist die Spracherfassung wahrscheinlich aus; führen Sie `/voice hold` aus, um sie zu aktivieren. Wenn nur ein oder zwei Leerzeichen erscheinen und dann nichts, ist die Spracherfassung an, aber die Halten-Erkennung wird nicht ausgelöst. Die Halten-Erkennung erfordert, dass Ihr Terminal Tastenwiederholungsereignisse sendet, daher kann es eine gehaltene Taste nicht erkennen, wenn die Tastenwiederholung auf Betriebssystemebene deaktiviert ist. Wechseln Sie mit `/voice tap` zum Tippen-Modus, um die Tastenwiederholungsanforderung zu vermeiden.

188* **Das Tippen auf `Space` gibt ein Leerzeichen ein, anstatt im Tippen-Modus aufzunehmen**: Das erste Tippen startet die Aufnahme nur, wenn die Eingabeaufforderung leer ist. Löschen Sie zuerst die Eingabe, oder überprüfen Sie, dass Sie im Tippen-Modus sind, indem Sie `/voice tap` ausführen.188* **Das Tippen auf `Space` gibt ein Leerzeichen ein, anstatt im Tippen-Modus aufzunehmen**: Das erste Tippen startet die Aufnahme nur, wenn die Eingabeaufforderung leer ist. Löschen Sie zuerst die Eingabe, oder überprüfen Sie, dass Sie im Tippen-Modus sind, indem Sie `/voice tap` ausführen.

189* **`No audio detected from microphone`**: Die Aufnahme wurde gestartet, aber es wurde Stille erfasst. Bestätigen Sie, dass das richtige Eingabegerät als Systemstandard eingestellt ist und dass sein Eingabepegel nicht stummgeschaltet oder nahe Null ist. Unter Windows öffnen Sie Einstellungen → System → Sound → Eingabe und wählen Sie Ihr Mikrofon aus. Unter macOS öffnen Sie Systemeinstellungen → Sound → Eingabe.189* **`No audio detected from microphone`**: Die Aufnahme wurde gestartet, aber es wurde Stille erfasst. Bestätigen Sie, dass das richtige Eingabegerät als Systemstandard eingestellt ist und dass sein Eingabepegel nicht stummgeschaltet oder nahe Null ist. Unter Windows öffnen Sie Einstellungen → System → Sound → Eingabe und wählen Sie Ihr Mikrofon aus. Unter macOS öffnen Sie Systemeinstellungen → Sound → Eingabe.

190* **`Voice connection failed`**: Ihre Aufnahme erreichte den Transkriptionsdienst nicht, da die Verbindung fehlgeschlagen ist. Überprüfen Sie Ihr Netzwerk und versuchen Sie es erneut. {/* min-version: 2.1.200 */}Eine Aufnahme, die keinen Audio erfasst, meldet stattdessen `No audio detected from microphone`. Vor v2.1.200 konnte ein stilles Mikrofon einen Verbindungsfehler melden, was auf ein Netzwerkproblem hindeutete, wenn das eigentliche Problem das Eingabegerät war.190* **`Voice connection failed`**: Ihre Aufnahme erreichte den Transkriptionsdienst nicht, da die Verbindung fehlgeschlagen ist. Überprüfen Sie Ihr Netzwerk und versuchen Sie es erneut. Eine Aufnahme, die keinen Audio erfasst, meldet stattdessen `No audio detected from microphone`. Vor v2.1.200 konnte ein stilles Mikrofon einen Verbindungsfehler melden, was auf ein Netzwerkproblem hindeutete, wenn das eigentliche Problem das Eingabegerät war.

191* **`No speech detected`**: Audio erreichte den Transkriptionsdienst, aber es wurden keine Wörter erkannt. Sprechen Sie näher zum Mikrofon, reduzieren Sie Hintergrundgeräusche und bestätigen Sie, dass Ihre [Erfassungssprache](#change-the-dictation-language) der Sprache entspricht, die Sie sprechen.191* **`No speech detected`**: Audio erreichte den Transkriptionsdienst, aber es wurden keine Wörter erkannt. Sprechen Sie näher zum Mikrofon, reduzieren Sie Hintergrundgeräusche und bestätigen Sie, dass Ihre [Erfassungssprache](#change-the-dictation-language) der Sprache entspricht, die Sie sprechen.

192* **Transkription ist verzerrt oder in der falschen Sprache**: Die Erfassung wird standardmäßig auf Englisch eingestellt. Wenn Sie in einer anderen Sprache erfassen, legen Sie sie zuerst in `/config` fest. Siehe [Ändern Sie die Erfassungssprache](#change-the-dictation-language).192* **Transkription ist verzerrt oder in der falschen Sprache**: Die Erfassung wird standardmäßig auf Englisch eingestellt. Wenn Sie in einer anderen Sprache erfassen, legen Sie sie zuerst in `/config` fest. Siehe [Ändern Sie die Erfassungssprache](#change-the-dictation-language).

193 193

219 Siehe auch219 Siehe auch

220</h2>220</h2>

221 221

222* [Tastaturkürzel anpassen](/de/keybindings): Binden Sie `voice:pushToTalk` und andere CLI-Tastaturaktionen neu222* [Tastaturkürzel anpassen](/docs/de/keybindings): Binden Sie `voice:pushToTalk` und andere CLI-Tastaturaktionen neu

223* [Einstellungen konfigurieren](/de/settings): Vollständige Referenz für `voice`, `language` und andere Einstellungsschlüssel223* [Einstellungen konfigurieren](/docs/de/settings): Vollständige Referenz für `voice`, `language` und andere Einstellungsschlüssel

224* [Interaktiver Modus](/de/interactive-mode): Tastaturkürzel, Eingabemodi und Sitzungssteuerungen224* [Interaktiver Modus](/docs/de/interactive-mode): Tastaturkürzel, Eingabemodi und Sitzungssteuerungen

225* [Befehle](/de/commands): Referenz für `/voice`, `/config` und alle anderen Befehle225* [Befehle](/docs/de/commands): Referenz für `/voice`, `/config` und alle anderen Befehle

vs-code.md +35 −35

Details

19Stellen Sie vor der Installation sicher, dass Sie folgende Voraussetzungen erfüllen:19Stellen Sie vor der Installation sicher, dass Sie folgende Voraussetzungen erfüllen:

20 20

21* VS Code 1.98.0 oder höher21* VS Code 1.98.0 oder höher

22* Ein Anthropic-Konto: Jedes bezahlte Claude-Abonnement (Pro, Max, Team oder Enterprise) oder ein Claude Console-Konto funktioniert, und es ist kein API-Schlüssel erforderlich. Sie [melden sich an](/de/authentication#log-in-to-claude-code) mit diesem Konto an, wenn Sie die Erweiterung zum ersten Mal öffnen. Wenn Sie Claude über einen Drittanbieter wie Amazon Bedrock oder Google Cloud's Agent Platform nutzen, siehe [Drittanbieter verwenden](#use-third-party-providers) für Setupanweisungen.22* Ein Anthropic-Konto: Jedes bezahlte Claude-Abonnement (Pro, Max, Team oder Enterprise) oder ein Claude Console-Konto funktioniert, und es ist kein API-Schlüssel erforderlich. Sie [melden sich an](/docs/de/authentication#log-in-to-claude-code) mit diesem Konto an, wenn Sie die Erweiterung zum ersten Mal öffnen. Wenn Sie Claude über einen Drittanbieter wie Amazon Bedrock oder Google Cloud's Agent Platform nutzen, siehe [Drittanbieter verwenden](#use-third-party-providers) für Setupanweisungen.

23 23

24<Tip>24<Tip>

25 Die Erweiterung enthält eine eigene Kopie der CLI (Befehlszeilenschnittstelle) für das Chat-Panel. Um `claude` im integrierten Terminal von VS Code auszuführen, benötigen Sie auch die [eigenständige CLI-Installation](/de/setup). Siehe [VS Code-Erweiterung vs. Claude Code CLI](#vs-code-extension-vs-claude-code-cli) für Details.25 Die Erweiterung enthält eine eigene Kopie der CLI (Befehlszeilenschnittstelle) für das Chat-Panel. Um `claude` im integrierten Terminal von VS Code auszuführen, benötigen Sie auch die [eigenständige CLI-Installation](/docs/de/setup). Siehe [VS Code-Erweiterung vs. Claude Code CLI](#vs-code-extension-vs-claude-code-cli) für Details.

26</Tip>26</Tip>

27 27

28<h2 id="install-the-extension">28<h2 id="install-the-extension">

36 36

37Oder drücken Sie in VS Code `Cmd+Shift+X` (Mac) oder `Ctrl+Shift+X` (Windows/Linux), um die Ansicht „Erweiterungen" zu öffnen, suchen Sie nach „Claude Code" und klicken Sie auf **Installieren**.37Oder drücken Sie in VS Code `Cmd+Shift+X` (Mac) oder `Ctrl+Shift+X` (Windows/Linux), um die Ansicht „Erweiterungen" zu öffnen, suchen Sie nach „Claude Code" und klicken Sie auf **Installieren**.

38 38

39Die Erweiterung wird auch in anderen VS Code-Forks wie Devin Desktop oder Kiro installiert. Suchen Sie nach „Claude Code" in der Ansicht „Erweiterungen" des Editors, oder installieren Sie aus der [Open VSX-Registrierung](https://open-vsx.org/extension/Anthropic/claude-code). Wenn Ihr Editor die Erweiterung nicht installieren kann, [installieren Sie die CLI](/de/quickstart) und führen Sie `claude` in dessen integriertem Terminal aus. Die CLI funktioniert in jedem Terminal.39Die Erweiterung wird auch in anderen VS Code-Forks wie Devin Desktop oder Kiro installiert. Suchen Sie nach „Claude Code" in der Ansicht „Erweiterungen" des Editors, oder installieren Sie aus der [Open VSX-Registrierung](https://open-vsx.org/extension/Anthropic/claude-code). Wenn Ihr Editor die Erweiterung nicht installieren kann, [installieren Sie die CLI](/docs/de/quickstart) und führen Sie `claude` in dessen integriertem Terminal aus. Die CLI funktioniert in jedem Terminal.

40 40

41<Note>Wenn die Erweiterung nach der Installation nicht angezeigt wird, starten Sie VS Code neu oder führen Sie „Developer: Reload Window" aus der Befehlspalette aus.</Note>41<Note>Wenn die Erweiterung nach der Installation nicht angezeigt wird, starten Sie VS Code neu oder führen Sie „Developer: Reload Window" aus der Befehlspalette aus.</Note>

42 42

90 </Step>90 </Step>

91</Steps>91</Steps>

92 92

~~93Weitere Ideen, was Sie mit Claude Code tun können, finden Sie unter [Häufige Workflows](/de/common-workflows).~~93Weitere Ideen, was Sie mit Claude Code tun können, finden Sie unter [Häufige Workflows](/docs/de/common-workflows).

94 94

95<Tip>95<Tip>

96 Führen Sie 'Claude Code: Open Walkthrough" aus der Befehlspalette aus, um eine geführte Tour durch die Grundlagen zu erhalten.96 Führen Sie 'Claude Code: Open Walkthrough" aus der Befehlspalette aus, um eine geführte Tour durch die Grundlagen zu erhalten.

102 102

103Das Eingabefeld unterstützt mehrere Funktionen:103Das Eingabefeld unterstützt mehrere Funktionen:

104 104

105* **Genehmigungsmodi**: Klicken Sie auf den Modusindikator am unteren Rand des Eingabefelds, um Modi zu wechseln, oder legen Sie den Standard in den VS Code-Einstellungen unter `claudeCode.initialPermissionMode` fest. Siehe [Genehmigungsmodi](/de/permission-modes#switch-permission-modes) für jeden Modus, den der Indikator bietet.105* **Genehmigungsmodi**: Klicken Sie auf den Modusindikator am unteren Rand des Eingabefelds, um Modi zu wechseln, oder legen Sie den Standard in den VS Code-Einstellungen unter `claudeCode.initialPermissionMode` fest. Siehe [Genehmigungsmodi](/docs/de/permission-modes#switch-permission-modes) für jeden Modus, den der Indikator bietet.

106 * **Manuell**: Claude fragt vor Dateibearbeitungen und den meisten Shell-Befehlen um Genehmigung.106 * **Manuell**: Claude fragt vor Dateibearbeitungen und den meisten Shell-Befehlen um Genehmigung.

107 * **Plan**: Claude beschreibt, was es tun wird, und wartet auf Genehmigung, bevor es Änderungen vornimmt. VS Code öffnet den Plan automatisch als vollständiges Markdown-Dokument, in dem Sie Inline-Kommentare hinzufügen können, um Feedback zu geben, bevor Claude beginnt.107 * **Plan**: Claude beschreibt, was es tun wird, und wartet auf Genehmigung, bevor es Änderungen vornimmt. VS Code öffnet den Plan automatisch als vollständiges Markdown-Dokument, in dem Sie Inline-Kommentare hinzufügen können, um Feedback zu geben, bevor Claude beginnt.

108 * **Automatisch bearbeiten**: Claude nimmt Bearbeitungen vor, ohne zu fragen.108 * **Automatisch bearbeiten**: Claude nimmt Bearbeitungen vor, ohne zu fragen.

109* **Befehlsmenü**: Klicken Sie auf `/` oder geben Sie `/` ein, um das Befehlsmenü zu öffnen. Zu den Optionen gehören das Anhängen von Dateien, das Wechseln von Modellen, das Umschalten von erweitertem Denken, das Anzeigen der Plannutzung (`/usage`) und das Starten einer [Remote Control](/de/remote-control)-Sitzung (`/remote-control`). Der Abschnitt „Anpassen" bietet Zugriff auf MCP servers, hooks, memory, permissions und plugins. Elemente mit einem Terminal-Symbol werden im integrierten Terminal geöffnet.109* **Befehlsmenü**: Klicken Sie auf `/` oder geben Sie `/` ein, um das Befehlsmenü zu öffnen. Zu den Optionen gehören das Anhängen von Dateien, das Wechseln von Modellen, das Umschalten von erweitertem Denken, das Anzeigen der Plannutzung (`/usage`) und das Starten einer [Remote Control](/docs/de/remote-control)-Sitzung (`/remote-control`). Der Abschnitt „Anpassen" bietet Zugriff auf MCP servers, hooks, memory, permissions und plugins. Elemente mit einem Terminal-Symbol werden im integrierten Terminal geöffnet.

110 * {/* min-version: 2.1.203 */}Der Abschnitt „Einstellungen" enthält **Remote Control für alle Sitzungen aktivieren**, das [`remoteControlAtStartup`](/de/settings#available-settings) setzt, sodass [jede neue interaktive Sitzung automatisch eine Verbindung zu Remote Control herstellt](/de/remote-control#enable-remote-control-for-all-sessions). Erfordert Claude Code v2.1.203 oder später.110 * Der Abschnitt „Einstellungen" enthält **Remote Control für alle Sitzungen aktivieren**, das [`remoteControlAtStartup`](/docs/de/settings#available-settings) setzt, sodass [jede neue interaktive Sitzung automatisch eine Verbindung zu Remote Control herstellt](/docs/de/remote-control#enable-remote-control-for-all-sessions). Erfordert Claude Code v2.1.203 oder später.

111* **Kontextindikator**: Das Eingabefeld zeigt, wie viel von Claudes context window Sie verwenden. Claude komprimiert automatisch bei Bedarf, oder Sie können `/compact` manuell ausführen.111* **Kontextindikator**: Das Eingabefeld zeigt, wie viel von Claudes context window Sie verwenden. Claude komprimiert automatisch bei Bedarf, oder Sie können `/compact` manuell ausführen.

112* **Erweitertes Denken**: Ermöglicht Claude, mehr Zeit für die Überlegung komplexer Probleme aufzuwenden. Aktivieren Sie es über das Befehlsmenü (`/`). Claudes Überlegungen werden im Gespräch als zusammengeklappte Blöcke angezeigt: Klicken Sie auf einen Block, um ihn zu lesen, oder drücken Sie `Ctrl+O`, um jeden Denkblock in der Sitzung zu erweitern oder zu reduzieren. Siehe [Erweitertes Denken](/de/model-config#extended-thinking) für Details.112* **Erweitertes Denken**: Ermöglicht Claude, mehr Zeit für die Überlegung komplexer Probleme aufzuwenden. Aktivieren Sie es über das Befehlsmenü (`/`). Claudes Überlegungen werden im Gespräch als zusammengeklappte Blöcke angezeigt: Klicken Sie auf einen Block, um ihn zu lesen, oder drücken Sie `Ctrl+O`, um jeden Denkblock in der Sitzung zu erweitern oder zu reduzieren. Siehe [Erweitertes Denken](/docs/de/model-config#extended-thinking) für Details.

113* **Mehrzeilige Eingabe**: Drücken Sie `Shift+Enter`, um eine neue Zeile hinzuzufügen, ohne zu senden. Dies funktioniert auch in der Freitexteingabe „Sonstiges" von Frage-Dialogen.113* **Mehrzeilige Eingabe**: Drücken Sie `Shift+Enter`, um eine neue Zeile hinzuzufügen, ohne zu senden. Dies funktioniert auch in der Freitexteingabe „Sonstiges" von Frage-Dialogen.

114 114

115<h3 id="reference-files-and-folders">115<h3 id="reference-files-and-folders">

133 Frühere Gespräche fortsetzen133 Frühere Gespräche fortsetzen

134</h3>134</h3>

135 135

136Klicken Sie auf die Schaltfläche **Sitzungsverlauf** oben im Claude Code-Panel, um auf Ihren Gesprächsverlauf zuzugreifen. Sie können nach Schlüsselwort suchen oder nach Zeit durchsuchen (Heute, Gestern, Letzte 7 Tage usw.). Klicken Sie auf ein beliebiges Gespräch, um es mit dem vollständigen Nachrichtenverlauf fortzusetzen. Neue Sitzungen erhalten KI-generierte Titel basierend auf Ihrer ersten Nachricht. Bewegen Sie den Mauszeiger über eine Sitzung, um Umbenennungs- und Entfernungsaktionen anzuzeigen: Benennen Sie um, um ihr einen beschreibenden Titel zu geben, oder entfernen Sie sie, um sie aus der Liste zu löschen. Weitere Informationen zum Fortsetzen von Sitzungen finden Sie unter [Sitzungen verwalten](/de/sessions).136Klicken Sie auf die Schaltfläche **Sitzungsverlauf** oben im Claude Code-Panel, um auf Ihren Gesprächsverlauf zuzugreifen. Sie können nach Schlüsselwort suchen oder nach Zeit durchsuchen (Heute, Gestern, Letzte 7 Tage usw.). Klicken Sie auf ein beliebiges Gespräch, um es mit dem vollständigen Nachrichtenverlauf fortzusetzen. Neue Sitzungen erhalten KI-generierte Titel basierend auf Ihrer ersten Nachricht. Bewegen Sie den Mauszeiger über eine Sitzung, um Umbenennungs- und Entfernungsaktionen anzuzeigen: Benennen Sie um, um ihr einen beschreibenden Titel zu geben, oder entfernen Sie sie, um sie aus der Liste zu löschen. Weitere Informationen zum Fortsetzen von Sitzungen finden Sie unter [Sitzungen verwalten](/docs/de/sessions).

137 137

138<h3 id="resume-cloud-sessions-from-claude-ai">138<h3 id="resume-cloud-sessions-from-claude-ai">

139 Fortsetzen von Remote-Sitzungen von Claude.ai139 Fortsetzen von Remote-Sitzungen von Claude.ai

140</h3>140</h3>

141 141

142Wenn Sie [Claude Code im Web](/de/claude-code-on-the-web) verwenden, können Sie diese Remote-Sitzungen direkt in VS Code fortsetzen. Dies erfordert die Anmeldung mit **Claude.ai Subscription**, nicht Anthropic Console.142Wenn Sie [Claude Code im Web](/docs/de/claude-code-on-the-web) verwenden, können Sie diese Remote-Sitzungen direkt in VS Code fortsetzen. Dies erfordert die Anmeldung mit **Claude.ai Subscription**, nicht Anthropic Console.

143 143

144<Steps>144<Steps>

145 <Step title="Öffnen Sie den Sitzungsverlauf">145 <Step title="Öffnen Sie den Sitzungsverlauf">

167 167

168Das Dialogfeld zeigt auch auf, was zu Ihren Planlimits beiträgt. Es kennzeichnet Verhaltensweisen, die 10 % oder mehr der letzten Nutzung ausmachen, wie z. B. Cache-Misses, langer Kontext und Subagent-intensive oder hochgradig parallele Sitzungen, jeweils mit einem Tipp zur Reduzierung. Attributionstabellen zeigen, wie viel Nutzung von jedem Skill, Subagent, Plugin und MCP server kam. Erfordert Claude Code v2.1.174 oder später.168Das Dialogfeld zeigt auch auf, was zu Ihren Planlimits beiträgt. Es kennzeichnet Verhaltensweisen, die 10 % oder mehr der letzten Nutzung ausmachen, wie z. B. Cache-Misses, langer Kontext und Subagent-intensive oder hochgradig parallele Sitzungen, jeweils mit einem Tipp zur Reduzierung. Attributionstabellen zeigen, wie viel Nutzung von jedem Skill, Subagent, Plugin und MCP server kam. Erfordert Claude Code v2.1.174 oder später.

169 169

170Verwenden Sie den Umschalter „Tag" und „Woche", um zwischen den letzten 24 Stunden und den letzten 7 Tagen zu wechseln. Die Zahlen sind ungefähr und werden aus lokalen Sitzungen auf diesem Computer berechnet, daher ist die Nutzung von anderen Geräten oder claude.ai nicht enthalten. Weitere Informationen zum Verfolgen und Reduzieren der Nutzung finden Sie unter [Verfolgen Sie Ihre Kosten](/de/costs#track-your-costs).170Verwenden Sie den Umschalter „Tag" und „Woche", um zwischen den letzten 24 Stunden und den letzten 7 Tagen zu wechseln. Die Zahlen sind ungefähr und werden aus lokalen Sitzungen auf diesem Computer berechnet, daher ist die Nutzung von anderen Geräten oder claude.ai nicht enthalten. Weitere Informationen zum Verfolgen und Reduzieren der Nutzung finden Sie unter [Verfolgen Sie Ihre Kosten](/docs/de/costs#track-your-costs).

171 171

172<h2 id="customize-your-workflow">172<h2 id="customize-your-workflow">

173 Passen Sie Ihren Workflow an173 Passen Sie Ihren Workflow an

209 Verwalten Sie Plugins209 Verwalten Sie Plugins

210</h2>210</h2>

211 211

212Die VS Code-Erweiterung enthält eine grafische Benutzeroberfläche zum Installieren und Verwalten von [plugins](/de/plugins). Geben Sie `/plugins` in das Eingabefeld ein, um die Benutzeroberfläche **Plugins verwalten** zu öffnen.212Die VS Code-Erweiterung enthält eine grafische Benutzeroberfläche zum Installieren und Verwalten von [plugins](/docs/de/plugins). Geben Sie `/plugins` in das Eingabefeld ein, um die Benutzeroberfläche **Plugins verwalten** zu öffnen.

213 213

214<h3 id="install-plugins">214<h3 id="install-plugins">

215 Installieren Sie Plugins215 Installieren Sie Plugins

246 Die Plugin-Verwaltung in VS Code verwendet unter der Haube die gleichen CLI-Befehle. Plugins und Marketplaces, die Sie in der Erweiterung konfigurieren, sind auch in der CLI verfügbar, und umgekehrt.246 Die Plugin-Verwaltung in VS Code verwendet unter der Haube die gleichen CLI-Befehle. Plugins und Marketplaces, die Sie in der Erweiterung konfigurieren, sind auch in der CLI verfügbar, und umgekehrt.

247</Note>247</Note>

248 248

249Weitere Informationen zum Plugin-System finden Sie unter [Plugins](/de/plugins) und [Plugin-Marketplaces](/de/plugin-marketplaces).249Weitere Informationen zum Plugin-System finden Sie unter [Plugins](/docs/de/plugins) und [Plugin-Marketplaces](/docs/de/plugin-marketplaces).

250 250

251<h2 id="automate-browser-tasks-with-chrome">251<h2 id="automate-browser-tasks-with-chrome">

252 Automatisieren Sie Browser-Aufgaben mit Chrome252 Automatisieren Sie Browser-Aufgaben mit Chrome

264 264

265Claude öffnet neue Registerkarten für Browser-Aufgaben und teilt den Anmeldestatus Ihres Browsers, sodass es auf jede Website zugreifen kann, bei der Sie bereits angemeldet sind.265Claude öffnet neue Registerkarten für Browser-Aufgaben und teilt den Anmeldestatus Ihres Browsers, sodass es auf jede Website zugreifen kann, bei der Sie bereits angemeldet sind.

266 266

267Anweisungen zum Einrichten, die vollständige Liste der Funktionen und Fehlerbehebung finden Sie unter [Claude Code mit Chrome verwenden](/de/chrome).267Anweisungen zum Einrichten, die vollständige Liste der Funktionen und Fehlerbehebung finden Sie unter [Claude Code mit Chrome verwenden](/docs/de/chrome).

268 268

269<h2 id="vs-code-commands-and-shortcuts">269<h2 id="vs-code-commands-and-shortcuts">

270 VS Code-Befehle und Tastaturkürzel270 VS Code-Befehle und Tastaturkürzel

332| Parameter | Beschreibung |332| Parameter | Beschreibung |

333| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |333| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

334| `prompt` | Text zum Vorausfüllen im Eingabefeld. Muss URL-codiert sein. Das Eingabefeld wird vorausgefüllt, aber nicht automatisch gesendet. |334| `prompt` | Text zum Vorausfüllen im Eingabefeld. Muss URL-codiert sein. Das Eingabefeld wird vorausgefüllt, aber nicht automatisch gesendet. |

335| `session` | Eine Sitzungs-ID zum Fortsetzen statt zum Starten eines neuen Gesprächs. Die Sitzung muss zum derzeit in VS Code geöffneten Arbeitsbereich gehören. Wenn die Sitzung nicht gefunden wird, wird stattdessen ein neues Gespräch gestartet. Wenn die Sitzung bereits in einer Registerkarte geöffnet ist, wird diese Registerkarte fokussiert. Um eine Sitzungs-ID programmgesteuert zu erfassen, siehe [Gespräche fortsetzen](/de/headless#continue-conversations). |335| `session` | Eine Sitzungs-ID zum Fortsetzen statt zum Starten eines neuen Gesprächs. Die Sitzung muss zum derzeit in VS Code geöffneten Arbeitsbereich gehören. Wenn die Sitzung nicht gefunden wird, wird stattdessen ein neues Gespräch gestartet. Wenn die Sitzung bereits in einer Registerkarte geöffnet ist, wird diese Registerkarte fokussiert. Um eine Sitzungs-ID programmgesteuert zu erfassen, siehe [Gespräche fortsetzen](/docs/de/headless#continue-conversations). |

336 336

337Um beispielsweise eine Registerkarte mit „review my changes" vorausgefüllt zu öffnen:337Um beispielsweise eine Registerkarte mit „review my changes" vorausgefüllt zu öffnen:

338 338

340vscode://anthropic.claude-code/open?prompt=review%20my%20changes340vscode://anthropic.claude-code/open?prompt=review%20my%20changes

341```341```

342 342

343Um stattdessen eine Terminal-Sitzung zu starten, verwenden Sie den CLI-Handler `claude-cli://`. Siehe [Sitzungen von Links aus starten](/de/deep-links).343Um stattdessen eine Terminal-Sitzung zu starten, verwenden Sie den CLI-Handler `claude-cli://`. Siehe [Sitzungen von Links aus starten](/docs/de/deep-links).

344 344

345<h2 id="configure-settings">345<h2 id="configure-settings">

346 Einstellungen konfigurieren346 Einstellungen konfigurieren

349Die Erweiterung hat zwei Arten von Einstellungen:349Die Erweiterung hat zwei Arten von Einstellungen:

350 350

351* **Erweiterungseinstellungen** in VS Code: Steuern Sie das Verhalten der Erweiterung in VS Code. Öffnen Sie mit `Cmd+,` (Mac) oder `Ctrl+,` (Windows/Linux), dann gehen Sie zu Erweiterungen → Claude Code. Sie können auch `/` eingeben und **General Config** auswählen, um Einstellungen zu öffnen.351* **Erweiterungseinstellungen** in VS Code: Steuern Sie das Verhalten der Erweiterung in VS Code. Öffnen Sie mit `Cmd+,` (Mac) oder `Ctrl+,` (Windows/Linux), dann gehen Sie zu Erweiterungen → Claude Code. Sie können auch `/` eingeben und **General Config** auswählen, um Einstellungen zu öffnen.

352* **Claude Code-Einstellungen** in `~/.claude/settings.json`: geteilt zwischen der Erweiterung und der CLI. Verwenden Sie für zulässige Befehle, Umgebungsvariablen, hooks und MCP servers. Siehe [Einstellungen](/de/settings) für Details.352* **Claude Code-Einstellungen** in `~/.claude/settings.json`: geteilt zwischen der Erweiterung und der CLI. Verwenden Sie für zulässige Befehle, Umgebungsvariablen, hooks und MCP servers. Siehe [Einstellungen](/docs/de/settings) für Details.

353 353

354<Tip>354<Tip>

355 Fügen Sie `"$schema": "https://json.schemastore.org/claude-code-settings.json"` zu Ihrer `settings.json` hinzu, um Autovervollständigung und Inline-Validierung für alle verfügbaren Einstellungen direkt in VS Code zu erhalten.355 Fügen Sie `"$schema": "https://json.schemastore.org/claude-code-settings.json"` zu Ihrer `settings.json` hinzu, um Autovervollständigung und Inline-Validierung für alle verfügbaren Einstellungen direkt in VS Code zu erhalten.

363| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |363| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

365| `initialPermissionMode` | `default` | Steuert Genehmigungsaufforderungen für neue Gespräche: `default`, `plan`, `acceptEdits` oder `bypassPermissions`. {/* min-version: 2.1.200 */}`manual` ist ein Alias für `default` und wählt den Modus mit der Bezeichnung **Manual** im Modusindikator. Erfordert Claude Code v2.1.200 oder später. Siehe [Genehmigungsmodi](/de/permission-modes). |365| `initialPermissionMode` | `default` | Steuert Genehmigungsaufforderungen für neue Gespräche: `default`, `plan`, `acceptEdits` oder `bypassPermissions`. `manual` ist ein Alias für `default` und wählt den Modus mit der Bezeichnung **Manual** im Modusindikator. Erfordert Claude Code v2.1.200 oder später. Siehe [Genehmigungsmodi](/docs/de/permission-modes). |

374| `environmentVariables` | `[]` | Legen Sie Umgebungsvariablen für den Claude-Prozess fest. Verwenden Sie stattdessen Claude Code-Einstellungen für gemeinsame Konfiguration. |374| `environmentVariables` | `[]` | Legen Sie Umgebungsvariablen für den Claude-Prozess fest. Verwenden Sie stattdessen Claude Code-Einstellungen für gemeinsame Konfiguration. |

377| `claudeProcessWrapper` | - | Ausführbare Datei, die zum Starten des Claude-Prozesses verwendet wird. Der Pfad der gebündelten Binärdatei wird als Argument übergeben, wenn vorhanden. Setzen Sie dies auf eine separat installierte `claude`-Binärdatei, wenn der Erweiterungsbuild keine für Ihre Plattform enthält. Ein Fehler „Unsupported platform" bei der Aktivierung bedeutet, dass keine Binärdatei für Ihre Plattform gebündelt ist; siehe [welche Plattformen vorgefertigte Binärdateien haben](/de/troubleshoot-install#native-binary-not-found-after-npm-install). |377| `claudeProcessWrapper` | - | Ausführbare Datei, die zum Starten des Claude-Prozesses verwendet wird. Der Pfad der gebündelten Binärdatei wird als Argument übergeben, wenn vorhanden. Setzen Sie dies auf eine separat installierte `claude`-Binärdatei, wenn der Erweiterungsbuild keine für Ihre Plattform enthält. Ein Fehler „Unsupported platform" bei der Aktivierung bedeutet, dass keine Binärdatei für Ihre Plattform gebündelt ist; siehe [welche Plattformen vorgefertigte Binärdateien haben](/docs/de/troubleshoot-install#native-binary-not-found-after-npm-install). |

378 378

379<h2 id="vs-code-extension-vs-claude-code-cli">379<h2 id="vs-code-extension-vs-claude-code-cli">

380 VS Code-Erweiterung vs. Claude Code CLI380 VS Code-Erweiterung vs. Claude Code CLI

381</h2>381</h2>

382 382

383Claude Code ist sowohl als VS Code-Erweiterung (grafisches Panel) als auch als CLI (Befehlszeilenschnittstelle im Terminal) verfügbar. Einige Funktionen sind nur in der CLI verfügbar. Wenn Sie eine CLI-only-Funktion benötigen, führen Sie `claude` im integrierten Terminal von VS Code aus. Dies erfordert die [eigenständige CLI-Installation](/de/setup): Die Erweiterung fügt `claude` nicht zu Ihrem PATH hinzu. Siehe [CLI in VS Code ausführen](#run-cli-in-vs-code).383Claude Code ist sowohl als VS Code-Erweiterung (grafisches Panel) als auch als CLI (Befehlszeilenschnittstelle im Terminal) verfügbar. Einige Funktionen sind nur in der CLI verfügbar. Wenn Sie eine CLI-only-Funktion benötigen, führen Sie `claude` im integrierten Terminal von VS Code aus. Dies erfordert die [eigenständige CLI-Installation](/docs/de/setup): Die Erweiterung fügt `claude` nicht zu Ihrem PATH hinzu. Siehe [CLI in VS Code ausführen](#run-cli-in-vs-code).

384 384

385| Funktion | CLI | VS Code-Erweiterung |385| Funktion | CLI | VS Code-Erweiterung |

386| ------------------------ | -------------------- | ----------------------------------------------------------------------------------------------------- |386| ------------------------ | -------------------- | ----------------------------------------------------------------------------------------------------- |

388| MCP-Server-Konfiguration | Ja | Teilweise (fügen Sie Server über CLI hinzu; verwalten Sie vorhandene Server mit `/mcp` im Chat-Panel) |388| MCP-Server-Konfiguration | Ja | Teilweise (fügen Sie Server über CLI hinzu; verwalten Sie vorhandene Server mit `/mcp` im Chat-Panel) |

389| Checkpoints | Ja | Ja |389| Checkpoints | Ja | Ja |

390| `!` Bash-Tastaturkürzel | Ja | Nein |390| `!` Bash-Tastaturkürzel | Ja | Nein |

400* **Code hier zurückspulen**: Revert-Dateiänderungen zu diesem Punkt im Gespräch, während Sie den vollständigen Gesprächsverlauf behalten400* **Code hier zurückspulen**: Revert-Dateiänderungen zu diesem Punkt im Gespräch, während Sie den vollständigen Gesprächsverlauf behalten

401* **Gespräch verzweigen und Code zurückspulen**: Starten Sie einen neuen Gesprächszweig und revert-Dateiänderungen zu diesem Punkt401* **Gespräch verzweigen und Code zurückspulen**: Starten Sie einen neuen Gesprächszweig und revert-Dateiänderungen zu diesem Punkt

402 402

403Vollständige Details zur Funktionsweise von Checkpoints und deren Einschränkungen finden Sie unter [Checkpointing](/de/checkpointing).403Vollständige Details zur Funktionsweise von Checkpoints und deren Einschränkungen finden Sie unter [Checkpointing](/docs/de/checkpointing).

404 404

405<h3 id="run-cli-in-vs-code">405<h3 id="run-cli-in-vs-code">

406 CLI in VS Code ausführen406 CLI in VS Code ausführen

408 408

409Um die CLI zu verwenden und in VS Code zu bleiben, öffnen Sie das integrierte Terminal (`` Ctrl+` `` auf Windows/Linux oder `` Cmd+` `` auf Mac) und führen Sie `claude` aus. Die CLI wird automatisch mit Ihrer IDE für Funktionen wie Diff-Anzeige und Diagnosefreigabe integriert.409Um die CLI zu verwenden und in VS Code zu bleiben, öffnen Sie das integrierte Terminal (`` Ctrl+` `` auf Windows/Linux oder `` Cmd+` `` auf Mac) und führen Sie `claude` aus. Die CLI wird automatisch mit Ihrer IDE für Funktionen wie Diff-Anzeige und Diagnosefreigabe integriert.

410 410

411Die Installation der Erweiterung fügt `claude` nicht zu Ihrem Shell-PATH hinzu. Die Erweiterung enthält eine private Kopie der CLI für ihr Chat-Panel, aber die Eingabe von `claude` in einem Terminal erfordert die [eigenständige CLI-Installation](/de/setup). Führen Sie die Installation einmal aus und die Befehle auf dieser Seite, einschließlich `claude mcp add` und `claude --resume`, funktionieren in jedem Terminal. Wenn `claude` nach der Installation immer noch nicht gefunden wird, [überprüfen Sie Ihren PATH](/de/troubleshoot-install#verify-your-path).411Die Installation der Erweiterung fügt `claude` nicht zu Ihrem Shell-PATH hinzu. Die Erweiterung enthält eine private Kopie der CLI für ihr Chat-Panel, aber die Eingabe von `claude` in einem Terminal erfordert die [eigenständige CLI-Installation](/docs/de/setup). Führen Sie die Installation einmal aus und die Befehle auf dieser Seite, einschließlich `claude mcp add` und `claude --resume`, funktionieren in jedem Terminal. Wenn `claude` nach der Installation immer noch nicht gefunden wird, [überprüfen Sie Ihren PATH](/docs/de/troubleshoot-install#verify-your-path).

412 412

413Wenn Sie ein externes Terminal verwenden, führen Sie `/ide` in Claude Code aus, um es mit VS Code zu verbinden.413Wenn Sie ein externes Terminal verwenden, führen Sie `/ide` in Claude Code aus, um es mit VS Code zu verbinden.

414 414

445 445

446Nach der Konfiguration bitten Sie Claude, die Tools zu verwenden (z. B. „Review PR #456").446Nach der Konfiguration bitten Sie Claude, die Tools zu verwenden (z. B. „Review PR #456").

447 447

448Um MCP-Server zu verwalten, ohne VS Code zu verlassen, geben Sie `/mcp` in das Chat-Panel ein. Der MCP-Verwaltungsdialog ermöglicht es Ihnen, Server zu aktivieren oder zu deaktivieren, sich erneut mit einem Server zu verbinden und OAuth-Authentifizierung zu verwalten. Siehe die [MCP-Dokumentation](/de/mcp) für verfügbare Server.448Um MCP-Server zu verwalten, ohne VS Code zu verlassen, geben Sie `/mcp` in das Chat-Panel ein. Der MCP-Verwaltungsdialog ermöglicht es Ihnen, Server zu aktivieren oder zu deaktivieren, sich erneut mit einem Server zu verbinden und OAuth-Authentifizierung zu verwalten. Siehe die [MCP-Dokumentation](/docs/de/mcp) für verfügbare Server.

449 449

450<h2 id="work-with-git">450<h2 id="work-with-git">

451 Arbeiten Sie mit Git451 Arbeiten Sie mit Git

477claude --worktree feature-auth477claude --worktree feature-auth

478```478```

479 479

480Jeder worktree behält einen unabhängigen Dateizustand bei, während er die Git-Historie teilt. Dies verhindert, dass Claude-Instanzen sich gegenseitig beeinflussen, wenn sie an verschiedenen Aufgaben arbeiten. Weitere Details finden Sie unter [Führen Sie parallele Sitzungen mit Git worktrees aus](/de/worktrees).480Jeder worktree behält einen unabhängigen Dateizustand bei, während er die Git-Historie teilt. Dies verhindert, dass Claude-Instanzen sich gegenseitig beeinflussen, wenn sie an verschiedenen Aufgaben arbeiten. Weitere Details finden Sie unter [Führen Sie parallele Sitzungen mit Git worktrees aus](/docs/de/worktrees).

481 481

482<h2 id="use-third-party-providers">482<h2 id="use-third-party-providers">

483 Verwenden Sie Drittanbieter483 Verwenden Sie Drittanbieter

495 <Step title="Konfigurieren Sie Ihren Anbieter">495 <Step title="Konfigurieren Sie Ihren Anbieter">

496 Folgen Sie dem Setup-Leitfaden für Ihren Anbieter:496 Folgen Sie dem Setup-Leitfaden für Ihren Anbieter:

497 497

498 * [Claude Code auf Amazon Bedrock](/de/amazon-bedrock)498 * [Claude Code auf Amazon Bedrock](/docs/de/amazon-bedrock)

499 * [Claude Code auf Google Cloud's Agent Platform](/de/google-vertex-ai)499 * [Claude Code auf Google Cloud's Agent Platform](/docs/de/google-vertex-ai)

500 * [Claude Code auf Microsoft Foundry](/de/microsoft-foundry)500 * [Claude Code auf Microsoft Foundry](/docs/de/microsoft-foundry)

501 501

502 Diese Leitfäden behandeln die Konfiguration Ihres Anbieters in `~/.claude/settings.json`, was sicherstellt, dass Ihre Einstellungen zwischen der VS Code-Erweiterung und der CLI geteilt werden.502 Diese Leitfäden behandeln die Konfiguration Ihres Anbieters in `~/.claude/settings.json`, was sicherstellt, dass Ihre Einstellungen zwischen der VS Code-Erweiterung und der CLI geteilt werden.

503 </Step>503 </Step>

507 Sicherheit und Datenschutz507 Sicherheit und Datenschutz

508</h2>508</h2>

509 509

510Ihr Code bleibt privat. Claude Code verarbeitet Ihren Code, um Unterstützung zu bieten, verwendet ihn aber nicht zum Trainieren von Modellen. Weitere Informationen zur Datenbehandlung und zum Deaktivieren der Protokollierung finden Sie unter [Daten und Datenschutz](/de/data-usage).510Ihr Code bleibt privat. Claude Code verarbeitet Ihren Code, um Unterstützung zu bieten, verwendet ihn aber nicht zum Trainieren von Modellen. Weitere Informationen zur Datenbehandlung und zum Deaktivieren der Protokollierung finden Sie unter [Daten und Datenschutz](/docs/de/data-usage).

511 511

512Mit aktivierten Auto-Edit-Berechtigungen kann Claude Code VS Code-Konfigurationsdateien (wie `settings.json` oder `tasks.json`) ändern, die VS Code möglicherweise automatisch ausführt. Um das Risiko bei der Arbeit mit nicht vertrauenswürdigem Code zu verringern:512Mit aktivierten Auto-Edit-Berechtigungen kann Claude Code VS Code-Konfigurationsdateien (wie `settings.json` oder `tasks.json`) ändern, die VS Code möglicherweise automatisch ausführt. Um das Risiko bei der Arbeit mit nicht vertrauenswürdigem Code zu verringern:

513 513

523 523

524Der Server heißt `ide` und ist in `/mcp` verborgen, da es nichts zu konfigurieren gibt. Wenn Ihre Organisation jedoch einen `PreToolUse` Hook verwendet, um MCP-Tools auf eine Allowlist zu setzen, müssen Sie wissen, dass er existiert.524Der Server heißt `ide` und ist in `/mcp` verborgen, da es nichts zu konfigurieren gibt. Wenn Ihre Organisation jedoch einen `PreToolUse` Hook verwendet, um MCP-Tools auf eine Allowlist zu setzen, müssen Sie wissen, dass er existiert.

525 525

526**Auswahl und Kontext offener Dateien.** Während der Verbindung bezieht die CLI Ihre aktuelle Editor-Auswahl und den Pfad der aktiven Datei als Kontext in jeden Prompt ein, den Sie senden. Das Transkript zeigt eine `⧉ Selected N lines from <file>`-Zeile, wenn dies geschieht. Um eine sensible Datei wie `.env` auszuschließen, fügen Sie eine [`Read` Deny-Regel](/de/permissions#read-and-edit) für ihren Pfad hinzu. Eine entsprechende Deny-Regel verhindert sowohl, dass der ausgewählte Text als auch die Benachrichtigung über die offene Datei für diese Datei Claude erreichen.526**Auswahl und Kontext offener Dateien.** Während der Verbindung bezieht die CLI Ihre aktuelle Editor-Auswahl und den Pfad der aktiven Datei als Kontext in jeden Prompt ein, den Sie senden. Das Transkript zeigt eine `⧉ Selected N lines from <file>`-Zeile, wenn dies geschieht. Um eine sensible Datei wie `.env` auszuschließen, fügen Sie eine [`Read` Deny-Regel](/docs/de/permissions#read-and-edit) für ihren Pfad hinzu. Eine entsprechende Deny-Regel verhindert sowohl, dass der ausgewählte Text als auch die Benachrichtigung über die offene Datei für diese Datei Claude erreichen.

527 527

528**Transport und Authentifizierung.** Der Server bindet sich an `127.0.0.1` auf einem zufälligen Port im Bereich 10000–65535, und der Port ist nicht konfigurierbar. Der Transport ist unverschlüsseltes `ws://`; da der Socket nur Loopback ist, kann jeder Prozess, der den Datenverkehr erfassen könnte, auch das Token aus der Lock-Datei lesen, daher würde TLS keinen Schutz bieten. Jede Erweiterungsaktivierung generiert ein frisches zufälliges Auth-Token, schreibt es in eine Lock-Datei unter `~/.claude/ide/<port>.lock`, und die CLI muss es als `X-Claude-Code-Ide-Authorization` Header präsentieren, um sich zu verbinden. Die Lock-Datei hat `0600` Berechtigungen in einem `0700` Verzeichnis, daher kann nur der Benutzer, der VS Code ausführt, sie lesen. Wenn `CLAUDE_CONFIG_DIR` gesetzt ist, wird die Lock-Datei stattdessen in `$CLAUDE_CONFIG_DIR/ide/` geschrieben.528**Transport und Authentifizierung.** Der Server bindet sich an `127.0.0.1` auf einem zufälligen Port im Bereich 10000–65535, und der Port ist nicht konfigurierbar. Der Transport ist unverschlüsseltes `ws://`; da der Socket nur Loopback ist, kann jeder Prozess, der den Datenverkehr erfassen könnte, auch das Token aus der Lock-Datei lesen, daher würde TLS keinen Schutz bieten. Jede Erweiterungsaktivierung generiert ein frisches zufälliges Auth-Token, schreibt es in eine Lock-Datei unter `~/.claude/ide/<port>.lock`, und die CLI muss es als `X-Claude-Code-Ide-Authorization` Header präsentieren, um sich zu verbinden. Die Lock-Datei hat `0600` Berechtigungen in einem `0700` Verzeichnis, daher kann nur der Benutzer, der VS Code ausführt, sie lesen. Wenn `CLAUDE_CONFIG_DIR` gesetzt ist, wird die Lock-Datei stattdessen in `$CLAUDE_CONFIG_DIR/ide/` geschrieben.

529 529

6022. Suchen Sie nach „Claude Code"6022. Suchen Sie nach „Claude Code"

6033. Klicken Sie auf **Deinstallieren**6033. Klicken Sie auf **Deinstallieren**

604 604

605Wenn Sie `claude` in einem integrierten VS Code-Terminal ausführen, wird die Erweiterung automatisch neu installiert. Um sie deinstalliert zu halten, deaktivieren Sie **Auto-install IDE extension** in `/config`, oder setzen Sie [`autoInstallIdeExtension`](/de/settings#global-config-settings) auf `false`. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/de/env-vars) auf `1` setzen.605Wenn Sie `claude` in einem integrierten VS Code-Terminal ausführen, wird die Erweiterung automatisch neu installiert. Um sie deinstalliert zu halten, deaktivieren Sie **Auto-install IDE extension** in `/config`, oder setzen Sie [`autoInstallIdeExtension`](/docs/de/settings#global-config-settings) auf `false`. Sie können auch die Umgebungsvariable [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/de/env-vars) auf `1` setzen.

606 606

607Um auch Erweiterungsdaten zu entfernen und alle Einstellungen zurückzusetzen, löschen Sie das Speicherverzeichnis der Erweiterung für Ihre Plattform.607Um auch Erweiterungsdaten zu entfernen und alle Einstellungen zurückzusetzen, löschen Sie das Speicherverzeichnis der Erweiterung für Ihre Plattform.

608 608

624Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"624Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

625```625```

626 626

627Weitere Hilfe finden Sie im [Fehlerbehebungsleitfaden](/de/troubleshooting).627Weitere Hilfe finden Sie im [Fehlerbehebungsleitfaden](/docs/de/troubleshooting).

628 628

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

630 Nächste Schritte630 Nächste Schritte

632 632

633Jetzt, da Sie Claude Code in VS Code eingerichtet haben:633Jetzt, da Sie Claude Code in VS Code eingerichtet haben:

634 634

635* [Erkunden Sie häufige Workflows](/de/common-workflows), um das Beste aus Claude Code herauszuholen635* [Erkunden Sie häufige Workflows](/docs/de/common-workflows), um das Beste aus Claude Code herauszuholen

636* [Richten Sie MCP servers ein](/de/mcp), um Claudes Funktionen mit externen Tools zu erweitern. Fügen Sie Server über die CLI hinzu, verwalten Sie sie dann mit `/mcp` im Chat-Panel.636* [Richten Sie MCP servers ein](/docs/de/mcp), um Claudes Funktionen mit externen Tools zu erweitern. Fügen Sie Server über die CLI hinzu, verwalten Sie sie dann mit `/mcp` im Chat-Panel.

637* [Konfigurieren Sie Claude Code-Einstellungen](/de/settings), um zulässige Befehle, hooks und mehr anzupassen. Diese Einstellungen werden zwischen der Erweiterung und der CLI geteilt.637* [Konfigurieren Sie Claude Code-Einstellungen](/docs/de/settings), um zulässige Befehle, hooks und mehr anzupassen. Diese Einstellungen werden zwischen der Erweiterung und der CLI geteilt.

web-quickstart.md +25 −25

Details

21* **Aufgaben, die keine häufige Steuerung benötigen**: Übermitteln Sie eine gut definierte Aufgabe, machen Sie etwas anderes und überprüfen Sie das Ergebnis, wenn Claude fertig ist21* **Aufgaben, die keine häufige Steuerung benötigen**: Übermitteln Sie eine gut definierte Aufgabe, machen Sie etwas anderes und überprüfen Sie das Ergebnis, wenn Claude fertig ist

22* **Code-Fragen und Erkundung**: Verstehen Sie eine Codebasis oder verfolgen Sie, wie eine Funktion implementiert wird, ohne einen lokalen Checkout22* **Code-Fragen und Erkundung**: Verstehen Sie eine Codebasis oder verfolgen Sie, wie eine Funktion implementiert wird, ohne einen lokalen Checkout

23 23

24Für Arbeiten, die Ihre lokale Konfiguration, Tools oder Umgebung benötigen, ist die lokale Ausführung von Claude Code oder die Verwendung von [Remote Control](/de/remote-control) besser geeignet.24Für Arbeiten, die Ihre lokale Konfiguration, Tools oder Umgebung benötigen, ist die lokale Ausführung von Claude Code oder die Verwendung von [Remote Control](/docs/de/remote-control) besser geeignet.

25 25

26<h2 id="how-sessions-run">26<h2 id="how-sessions-run">

27 Wie Sitzungen ablaufen27 Wie Sitzungen ablaufen

29 29

30Wenn Sie eine Aufgabe übermitteln:30Wenn Sie eine Aufgabe übermitteln:

31 31

321. **Klonen und vorbereiten**: Ihr Repository wird auf eine von Anthropic verwaltete VM geklont und Ihr [Setup-Skript](/de/claude-code-on-the-web#setup-scripts) wird ausgeführt, falls konfiguriert.321. **Klonen und vorbereiten**: Ihr Repository wird auf eine von Anthropic verwaltete VM geklont und Ihr [Setup-Skript](/docs/de/claude-code-on-the-web#setup-scripts) wird ausgeführt, falls konfiguriert.

~~332. **Netzwerk konfigurieren**: Der Internetzugriff wird basierend auf der [Zugriffsstufe](/de/claude-code-on-the-web#access-levels) Ihrer Umgebung festgelegt.~~332. **Netzwerk konfigurieren**: Der Internetzugriff wird basierend auf der [Zugriffsstufe](/docs/de/claude-code-on-the-web#access-levels) Ihrer Umgebung festgelegt.

343. **Arbeit**: Claude analysiert Code, nimmt Änderungen vor, führt Tests aus und überprüft seine Arbeit. Sie können zuschauen und die ganze Zeit über steuern oder weggehen und zurückkommen, wenn es fertig ist.343. **Arbeit**: Claude analysiert Code, nimmt Änderungen vor, führt Tests aus und überprüft seine Arbeit. Sie können zuschauen und die ganze Zeit über steuern oder weggehen und zurückkommen, wenn es fertig ist.

354. **Branch pushen**: Wenn Claude einen Haltepunkt erreicht, pusht es seinen Branch zu GitHub. Sie überprüfen den Diff, hinterlassen Inline-Kommentare, erstellen einen PR oder senden eine weitere Nachricht, um weiterzumachen.354. **Branch pushen**: Wenn Claude einen Haltepunkt erreicht, pusht es seinen Branch zu GitHub. Sie überprüfen den Diff, hinterlassen Inline-Kommentare, erstellen einen PR oder senden eine weitere Nachricht, um weiterzumachen.

36 36

49| **Verwendet Ihre lokale Konfiguration** | Nein, nur Repository | Ja | Ja | Ja für lokal, nein für Cloud |49| **Verwendet Ihre lokale Konfiguration** | Nein, nur Repository | Ja | Ja | Ja für lokal, nein für Cloud |

54 54

~~55Siehe die Dokumentation zu [Terminal-Schnellstart](/de/quickstart), [Desktop-App](/de/desktop) oder [Remote Control](/de/remote-control), um diese einzurichten.~~55Siehe die Dokumentation zu [Terminal-Schnellstart](/docs/de/quickstart), [Desktop-App](/docs/de/desktop) oder [Remote Control](/docs/de/remote-control), um diese einzurichten.

56 56

57<h2 id="connect-github-and-create-an-environment">57<h2 id="connect-github-and-create-an-environment">

58 GitHub verbinden und eine Umgebung erstellen58 GitHub verbinden und eine Umgebung erstellen

70 </Step>70 </Step>

71 71

72 <Step title="Erstellen Sie Ihre Umgebung">72 <Step title="Erstellen Sie Ihre Umgebung">

73 Nach dem Verbinden von GitHub werden Sie aufgefordert, eine Cloud-Umgebung zu erstellen. Die Umgebung steuert, welchen Netzwerkzugriff Claude während Sitzungen hat und was ausgeführt wird, wenn eine neue Sitzung erstellt wird. Siehe [Installierte Tools](/de/claude-code-on-the-web#installed-tools) für das, was ohne Konfiguration verfügbar ist.73 Nach dem Verbinden von GitHub werden Sie aufgefordert, eine Cloud-Umgebung zu erstellen. Die Umgebung steuert, welchen Netzwerkzugriff Claude während Sitzungen hat und was ausgeführt wird, wenn eine neue Sitzung erstellt wird. Siehe [Installierte Tools](/docs/de/claude-code-on-the-web#installed-tools) für das, was ohne Konfiguration verfügbar ist.

74 74

75 Das Formular hat diese Felder:75 Das Formular hat diese Felder:

76 76

77 * **Name**: eine Anzeigebeschriftung. Nützlich, wenn Sie mehrere Umgebungen für verschiedene Projekte oder Zugriffsstufen haben.77 * **Name**: eine Anzeigebeschriftung. Nützlich, wenn Sie mehrere Umgebungen für verschiedene Projekte oder Zugriffsstufen haben.

78 * **Netzwerkzugriff**: steuert, was die Sitzung im Internet erreichen kann. Der Standard, `Trusted`, ermöglicht Verbindungen zu [häufigen Paketregistern](/de/claude-code-on-the-web#default-allowed-domains) wie npm, PyPI und RubyGems, während der allgemeine Internetzugriff blockiert wird.78 * **Netzwerkzugriff**: steuert, was die Sitzung im Internet erreichen kann. Der Standard, `Trusted`, ermöglicht Verbindungen zu [häufigen Paketregistern](/docs/de/claude-code-on-the-web#default-allowed-domains) wie npm, PyPI und RubyGems, während der allgemeine Internetzugriff blockiert wird.

79 * **Umgebungsvariablen**: optionale Variablen, die in jeder Sitzung verfügbar sind, im `.env`-Format. Umschließen Sie Werte nicht mit Anführungszeichen, da Anführungszeichen als Teil des Werts gespeichert werden. Diese sind für jeden sichtbar, der diese Umgebung bearbeiten kann.79 * **Umgebungsvariablen**: optionale Variablen, die in jeder Sitzung verfügbar sind, im `.env`-Format. Umschließen Sie Werte nicht mit Anführungszeichen, da Anführungszeichen als Teil des Werts gespeichert werden. Diese sind für jeden sichtbar, der diese Umgebung bearbeiten kann.

80 * **Setup-Skript**: ein optionales Bash-Skript, das vor dem Start von Claude Code ausgeführt wird. Verwenden Sie es, um System-Tools zu installieren, die die Cloud VM nicht enthält, wie `apt install -y gh`. Das Ergebnis wird [zwischengespeichert](/de/claude-code-on-the-web#environment-caching), sodass das Skript nicht bei jeder Sitzung erneut ausgeführt wird. Siehe [Setup-Skripte](/de/claude-code-on-the-web#setup-scripts) für Beispiele und Debugging-Tipps.80 * **Setup-Skript**: ein optionales Bash-Skript, das vor dem Start von Claude Code ausgeführt wird. Verwenden Sie es, um System-Tools zu installieren, die die Cloud VM nicht enthält, wie `apt install -y gh`. Das Ergebnis wird [zwischengespeichert](/docs/de/claude-code-on-the-web#environment-caching), sodass das Skript nicht bei jeder Sitzung erneut ausgeführt wird. Siehe [Setup-Skripte](/docs/de/claude-code-on-the-web#setup-scripts) für Beispiele und Debugging-Tipps.

81 81

82 Lassen Sie für ein erstes Projekt die Standardeinstellungen und klicken Sie auf **Umgebung erstellen**. Sie können [sie später bearbeiten oder zusätzliche Umgebungen erstellen](/de/claude-code-on-the-web#configure-your-environment) für verschiedene Projekte.82 Lassen Sie für ein erstes Projekt die Standardeinstellungen und klicken Sie auf **Umgebung erstellen**. Sie können [sie später bearbeiten oder zusätzliche Umgebungen erstellen](/docs/de/claude-code-on-the-web#configure-your-environment) für verschiedene Projekte.

83 </Step>83 </Step>

84</Steps>84</Steps>

85 85

87 Von Ihrem Terminal aus verbinden87 Von Ihrem Terminal aus verbinden

88</h3>88</h3>

89 89

90Wenn Sie bereits die GitHub CLI (`gh`) verwenden, können Sie Claude Code im Web ohne das Öffnen eines Browsers einrichten. Dies erfordert die [Claude Code CLI](/de/quickstart). `/web-setup` liest Ihr lokales `gh`-Token, verknüpft es mit Ihrem Claude-Konto und erstellt eine Standard-Cloud-Umgebung, wenn Sie noch keine haben.90Wenn Sie bereits die GitHub CLI (`gh`) verwenden, können Sie Claude Code im Web ohne das Öffnen eines Browsers einrichten. Dies erfordert die [Claude Code CLI](/docs/de/quickstart). `/web-setup` liest Ihr lokales `gh`-Token, verknüpft es mit Ihrem Claude-Konto und erstellt eine Standard-Cloud-Umgebung, wenn Sie noch keine haben.

91 91

92<Note>92<Note>

93 Organisationen mit aktivierter [Zero Data Retention](/de/zero-data-retention) können `/web-setup` oder andere Cloud-Sitzungsfunktionen nicht verwenden. Wenn die GitHub CLI nicht installiert oder authentifiziert ist, öffnet `/web-setup` stattdessen den Browser-Onboarding-Flow.93 Organisationen mit aktivierter [Zero Data Retention](/docs/de/zero-data-retention) können `/web-setup` oder andere Cloud-Sitzungsfunktionen nicht verwenden. Wenn die GitHub CLI nicht installiert oder authentifiziert ist, öffnet `/web-setup` stattdessen den Browser-Onboarding-Flow.

94</Note>94</Note>

95 95

96<Steps>96<Steps>

113 /web-setup113 /web-setup

114 ```114 ```

115 115

116 Dies synchronisiert Ihr `gh`-Token mit Ihrem Claude-Konto. Wenn Sie noch keine Cloud-Umgebung haben, erstellt `/web-setup` eine mit Trusted-Netzwerkzugriff und ohne Setup-Skript. Sie können [die Umgebung bearbeiten oder Variablen hinzufügen](/de/claude-code-on-the-web#configure-your-environment) danach. Sobald `/web-setup` abgeschlossen ist, können Sie Cloud-Sitzungen von Ihrem Terminal aus mit [`--cloud`](/de/claude-code-on-the-web#from-terminal-to-web) starten oder wiederkehrende Aufgaben mit [`/schedule`](/de/routines) einrichten.116 Dies synchronisiert Ihr `gh`-Token mit Ihrem Claude-Konto. Wenn Sie noch keine Cloud-Umgebung haben, erstellt `/web-setup` eine mit Trusted-Netzwerkzugriff und ohne Setup-Skript. Sie können [die Umgebung bearbeiten oder Variablen hinzufügen](/docs/de/claude-code-on-the-web#configure-your-environment) danach. Sobald `/web-setup` abgeschlossen ist, können Sie Cloud-Sitzungen von Ihrem Terminal aus mit [`--cloud`](/docs/de/claude-code-on-the-web#from-terminal-to-web) starten oder wiederkehrende Aufgaben mit [`/schedule`](/docs/de/routines) einrichten.

117 </Step>117 </Step>

118</Steps>118</Steps>

119 119

129 </Step>129 </Step>

130 130

131 <Step title="Wählen Sie einen Berechtigungsmodus">131 <Step title="Wählen Sie einen Berechtigungsmodus">

132 Der Modus-Dropdown neben der Eingabe ist standardmäßig auf **Änderungen automatisch akzeptieren** eingestellt, wobei Claude Änderungen vornimmt und einen Branch pusht, ohne auf Genehmigung zu warten. Wechseln Sie zu **Plan-Modus**, wenn Claude einen Ansatz vorschlagen und auf Ihr Okay warten soll, bevor Dateien bearbeitet werden. Cloud-Sitzungen bieten keine Ask-Berechtigungen oder Bypass-Berechtigungen. Siehe die [vollständige Liste der Berechtigungsmodi](/de/permission-modes#available-modes) für das, was jeder Modus erlaubt.132 Der Modus-Dropdown neben der Eingabe ist standardmäßig auf **Änderungen automatisch akzeptieren** eingestellt, wobei Claude Änderungen vornimmt und einen Branch pusht, ohne auf Genehmigung zu warten. Wechseln Sie zu **Plan-Modus**, wenn Claude einen Ansatz vorschlagen und auf Ihr Okay warten soll, bevor Dateien bearbeitet werden. Cloud-Sitzungen bieten keine Ask-Berechtigungen oder Bypass-Berechtigungen. Siehe die [vollständige Liste der Berechtigungsmodi](/docs/de/permission-modes#available-modes) für das, was jeder Modus erlaubt.

133 </Step>133 </Step>

134 134

135 <Step title="Beschreiben Sie die Aufgabe und übermitteln Sie sie">135 <Step title="Beschreiben Sie die Aufgabe und übermitteln Sie sie">

182 </Step>182 </Step>

183 183

184 <Step title="Fahren Sie nach dem PR mit der Iteration fort">184 <Step title="Fahren Sie nach dem PR mit der Iteration fort">

185 Die Sitzung bleibt nach der Erstellung des PR aktiv. Fügen Sie CI-Fehlerausgabe oder Reviewer-Kommentare in den Chat ein und bitten Sie Claude, sie zu beheben. Um Claude den PR automatisch überwachen zu lassen, siehe [Auto-fix Pull Requests](/de/claude-code-on-the-web#auto-fix-pull-requests).185 Die Sitzung bleibt nach der Erstellung des PR aktiv. Fügen Sie CI-Fehlerausgabe oder Reviewer-Kommentare in den Chat ein und bitten Sie Claude, sie zu beheben. Um Claude den PR automatisch überwachen zu lassen, siehe [Auto-fix Pull Requests](/docs/de/claude-code-on-the-web#auto-fix-pull-requests).

186 </Step>186 </Step>

187</Steps>187</Steps>

188 188

194 Nach dem Verbinden von GitHub werden keine Repositories angezeigt194 Nach dem Verbinden von GitHub werden keine Repositories angezeigt

195</h3>195</h3>

196 196

197Eine Cloud-Sitzung kann jedes Repository verwenden, das das verbundene GitHub-Konto sehen kann, unabhängig davon, auf welchen Repositories die Claude GitHub App installiert ist. Wenn ein Repository fehlt, überprüfen Sie, ob das verbundene GitHub-Konto auf GitHub Zugriff darauf hat. Wenn Sie auch [Auto-fix](/de/claude-code-on-the-web#auto-fix-pull-requests) für ein Repository möchten, installieren Sie die App darauf: Öffnen Sie auf github.com **Einstellungen → Anwendungen → Claude → Konfigurieren** und überprüfen Sie, ob das Repository unter **Repository-Zugriff** aufgeführt ist. Private Repositories benötigen die gleiche Autorisierung wie öffentliche.197Eine Cloud-Sitzung kann jedes Repository verwenden, das das verbundene GitHub-Konto sehen kann, unabhängig davon, auf welchen Repositories die Claude GitHub App installiert ist. Wenn ein Repository fehlt, überprüfen Sie, ob das verbundene GitHub-Konto auf GitHub Zugriff darauf hat. Wenn Sie auch [Auto-fix](/docs/de/claude-code-on-the-web#auto-fix-pull-requests) für ein Repository möchten, installieren Sie die App darauf: Öffnen Sie auf github.com **Einstellungen → Anwendungen → Claude → Konfigurieren** und überprüfen Sie, ob das Repository unter **Repository-Zugriff** aufgeführt ist. Private Repositories benötigen die gleiche Autorisierung wie öffentliche.

198 198

199<h3 id="the-page-only-shows-a-github-login-button">199<h3 id="the-page-only-shows-a-github-login-button">

200 Die Seite zeigt nur eine GitHub-Anmeldeschaltfläche200 Die Seite zeigt nur eine GitHub-Anmeldeschaltfläche

201</h3>201</h3>

202 202

203Cloud-Sitzungen erfordern ein verbundenes GitHub-Konto. Verbinden Sie sich über den oben beschriebenen Browser-Flow oder führen Sie `/web-setup` von Ihrem Terminal aus aus, wenn Sie die GitHub CLI verwenden. Wenn Sie GitHub lieber gar nicht verbinden möchten, siehe [Remote Control](/de/remote-control), um Claude Code auf Ihrem eigenen Computer auszuführen und es vom Web aus zu überwachen.203Cloud-Sitzungen erfordern ein verbundenes GitHub-Konto. Verbinden Sie sich über den oben beschriebenen Browser-Flow oder führen Sie `/web-setup` von Ihrem Terminal aus aus, wenn Sie die GitHub CLI verwenden. Wenn Sie GitHub lieber gar nicht verbinden möchten, siehe [Remote Control](/docs/de/remote-control), um Claude Code auf Ihrem eigenen Computer auszuführen und es vom Web aus zu überwachen.

204 204

205<h3 id="not-available-for-the-selected-organization">205<h3 id="not-available-for-the-selected-organization">

206 „Nicht verfügbar für die ausgewählte Organisation"206 „Nicht verfügbar für die ausgewählte Organisation"

220 „Cloud-Umgebung konnte nicht erstellt werden" oder „Keine Cloud-Umgebung verfügbar" bei Verwendung von `--cloud` oder ultraplan220 „Cloud-Umgebung konnte nicht erstellt werden" oder „Keine Cloud-Umgebung verfügbar" bei Verwendung von `--cloud` oder ultraplan

221</h3>221</h3>

222 222

223Remote-Sitzungsfunktionen erstellen automatisch eine Standard-Cloud-Umgebung, wenn Sie noch keine haben. Wenn Sie „Cloud-Umgebung konnte nicht erstellt werden" sehen, ist die automatische Erstellung fehlgeschlagen. {/* max-version: 2.1.100 */}Wenn Sie „Keine Cloud-Umgebung verfügbar" sehen, ist Ihre CLI älter als die automatische Erstellung. Führen Sie in beiden Fällen `/web-setup` in der Claude Code CLI aus, um eine manuell zu erstellen, oder besuchen Sie [claude.ai/code](https://claude.ai/code) und folgen Sie dem Schritt **Erstellen Sie Ihre Umgebung** oben.223Remote-Sitzungsfunktionen erstellen automatisch eine Standard-Cloud-Umgebung, wenn Sie noch keine haben. Wenn Sie „Cloud-Umgebung konnte nicht erstellt werden" sehen, ist die automatische Erstellung fehlgeschlagen. Wenn Sie „Keine Cloud-Umgebung verfügbar" sehen, ist Ihre CLI älter als die automatische Erstellung. Führen Sie in beiden Fällen `/web-setup` in der Claude Code CLI aus, um eine manuell zu erstellen, oder besuchen Sie [claude.ai/code](https://claude.ai/code) und folgen Sie dem Schritt **Erstellen Sie Ihre Umgebung** oben.

224 224

225<h3 id="setup-script-failed">225<h3 id="setup-script-failed">

226 Setup-Skript fehlgeschlagen226 Setup-Skript fehlgeschlagen

228 228

229Das Setup-Skript wurde mit einem Nicht-Null-Status beendet, was den Start der Sitzung blockiert. Häufige Ursachen:229Das Setup-Skript wurde mit einem Nicht-Null-Status beendet, was den Start der Sitzung blockiert. Häufige Ursachen:

230 230

231* Eine Paketinstallation ist fehlgeschlagen, weil die Registry nicht in Ihrer [Zugriffsstufe](/de/claude-code-on-the-web#access-levels) enthalten ist. `Trusted` deckt die meisten Paketmanager ab; `None` blockiert sie alle.231* Eine Paketinstallation ist fehlgeschlagen, weil die Registry nicht in Ihrer [Zugriffsstufe](/docs/de/claude-code-on-the-web#access-levels) enthalten ist. `Trusted` deckt die meisten Paketmanager ab; `None` blockiert sie alle.

232* Das Skript verweist auf eine Datei oder einen Pfad, der in einem frischen Klon nicht vorhanden ist.232* Das Skript verweist auf eine Datei oder einen Pfad, der in einem frischen Klon nicht vorhanden ist.

233* Ein Befehl, der lokal funktioniert, benötigt einen anderen Aufruf auf Ubuntu.233* Ein Befehl, der lokal funktioniert, benötigt einen anderen Aufruf auf Ubuntu.

234 234

238 Neue Sitzungen hängen oder treten während des Setups in einen Timeout auf238 Neue Sitzungen hängen oder treten während des Setups in einen Timeout auf

239</h3>239</h3>

240 240

241Wenn neue Sitzungen beim Setup-Skript-Schritt steckenbleiben oder mit einem generischen Container-Fehler fehlschlagen, bevor das Skript fertig ist, überschreitet das Skript wahrscheinlich das ungefähre fünfminütige Zeitbudget für die Erstellung des [Umgebungs-Cache](/de/claude-code-on-the-web#environment-caching). Schwere Schritte wie das Abrufen großer Docker-Images, das Synchronisieren vollständiger Abhängigkeitsbäume oder das Herunterladen von Modellgewichten überschreiten oft die Grenze, besonders wenn sie nacheinander ausgeführt werden.241Wenn neue Sitzungen beim Setup-Skript-Schritt steckenbleiben oder mit einem generischen Container-Fehler fehlschlagen, bevor das Skript fertig ist, überschreitet das Skript wahrscheinlich das ungefähre fünfminütige Zeitbudget für die Erstellung des [Umgebungs-Cache](/docs/de/claude-code-on-the-web#environment-caching). Schwere Schritte wie das Abrufen großer Docker-Images, das Synchronisieren vollständiger Abhängigkeitsbäume oder das Herunterladen von Modellgewichten überschreiten oft die Grenze, besonders wenn sie nacheinander ausgeführt werden.

242 242

243Um dies zu beheben, kürzen Sie das Skript, damit es zuverlässig in unter fünf Minuten fertig wird:243Um dies zu beheben, kürzen Sie das Skript, damit es zuverlässig in unter fünf Minuten fertig wird:

244 244

245* Führen Sie unabhängige Installationen parallel mit `&` und einem abschließenden `wait` aus, anstatt sie nacheinander auszuführen.245* Führen Sie unabhängige Installationen parallel mit `&` und einem abschließenden `wait` aus, anstatt sie nacheinander auszuführen.

246* Verschieben Sie die größten Downloads aus dem Setup-Skript in einen [SessionStart Hook](/de/claude-code-on-the-web#setup-scripts-vs-sessionstart-hooks), der sie im Hintergrund startet, damit die Sitzung nutzbar wird, während sie fertig werden.246* Verschieben Sie die größten Downloads aus dem Setup-Skript in einen [SessionStart Hook](/docs/de/claude-code-on-the-web#setup-scripts-vs-sessionstart-hooks), der sie im Hintergrund startet, damit die Sitzung nutzbar wird, während sie fertig werden.

247* Entfernen Sie lange Wiederholungs-Sleeps aus dem Setup-Skript, da eine steckengebliebene Wiederholungsschleife gegen das Budget zählt.247* Entfernen Sie lange Wiederholungs-Sleeps aus dem Setup-Skript, da eine steckengebliebene Wiederholungsschleife gegen das Budget zählt.

248 248

249<h3 id="session-keeps-running-after-closing-the-tab">249<h3 id="session-keeps-running-after-closing-the-tab">

250 Sitzung läuft weiter nach dem Schließen der Registerkarte250 Sitzung läuft weiter nach dem Schließen der Registerkarte

251</h3>251</h3>

252 252

253Dies ist beabsichtigt. Das Schließen der Registerkarte oder das Navigieren weg stoppt die Sitzung nicht. Sie läuft im Hintergrund weiter, bis Claude die aktuelle Aufgabe beendet, dann wird sie untätig. Aus der Seitenleiste können Sie [eine Sitzung archivieren](/de/claude-code-on-the-web#archive-sessions), um sie aus Ihrer Liste auszublenden, oder [sie löschen](/de/claude-code-on-the-web#delete-sessions), um sie dauerhaft zu entfernen.253Dies ist beabsichtigt. Das Schließen der Registerkarte oder das Navigieren weg stoppt die Sitzung nicht. Sie läuft im Hintergrund weiter, bis Claude die aktuelle Aufgabe beendet, dann wird sie untätig. Aus der Seitenleiste können Sie [eine Sitzung archivieren](/docs/de/claude-code-on-the-web#archive-sessions), um sie aus Ihrer Liste auszublenden, oder [sie löschen](/docs/de/claude-code-on-the-web#delete-sessions), um sie dauerhaft zu entfernen.

254 254

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

256 Nächste Schritte256 Nächste Schritte

258 258

259Jetzt, da Sie Aufgaben übermitteln und überprüfen können, behandeln diese Seiten das, was als Nächstes kommt: Cloud-Sitzungen von Ihrem Terminal aus starten, wiederkehrende Arbeiten planen und Claude ständige Anweisungen geben.259Jetzt, da Sie Aufgaben übermitteln und überprüfen können, behandeln diese Seiten das, was als Nächstes kommt: Cloud-Sitzungen von Ihrem Terminal aus starten, wiederkehrende Arbeiten planen und Claude ständige Anweisungen geben.

260 260

261* [Verwenden Sie Claude Code im Web](/de/claude-code-on-the-web): die vollständige Referenz, einschließlich Teleportieren von Sitzungen zu Ihrem Terminal, Setup-Skripte, Umgebungsvariablen und Netzwerkkonfiguration261* [Verwenden Sie Claude Code im Web](/docs/de/claude-code-on-the-web): die vollständige Referenz, einschließlich Teleportieren von Sitzungen zu Ihrem Terminal, Setup-Skripte, Umgebungsvariablen und Netzwerkkonfiguration

262* [Routinen](/de/routines): Automatisieren Sie Arbeiten nach einem Zeitplan, über einen API-Aufruf oder als Reaktion auf GitHub-Ereignisse262* [Routinen](/docs/de/routines): Automatisieren Sie Arbeiten nach einem Zeitplan, über einen API-Aufruf oder als Reaktion auf GitHub-Ereignisse

263* [CLAUDE.md](/de/memory): Geben Sie Claude ständige Anweisungen und Kontext, die zu Beginn jeder Sitzung geladen werden263* [CLAUDE.md](/docs/de/memory): Geben Sie Claude ständige Anweisungen und Kontext, die zu Beginn jeder Sitzung geladen werden

264* Installieren Sie die Claude-Mobilanwendung für [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) oder [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude), um Sitzungen von Ihrem Telefon aus zu überwachen. Aus der Claude Code CLI zeigt `/mobile` einen QR-Code an.264* Installieren Sie die Claude-Mobilanwendung für [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) oder [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude), um Sitzungen von Ihrem Telefon aus zu überwachen. Aus der Claude Code CLI zeigt `/mobile` einen QR-Code an.

workflows.md +19 −21

Details

6 6

7> Dynamische Workflows orchestrieren viele Subagenten aus einem Skript, das Claude schreibt und das Sie erneut ausführen können. Verwenden Sie sie für Codebase-Audits, große Migrationen und überprüfte Recherchen.7> Dynamische Workflows orchestrieren viele Subagenten aus einem Skript, das Claude schreibt und das Sie erneut ausführen können. Verwenden Sie sie für Codebase-Audits, große Migrationen und überprüfte Recherchen.

8 8

~~9{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}~~

11<Note>9<Note>

12 Dynamische Workflows erfordern Claude Code v2.1.154 oder später und sind auf allen bezahlten Plänen, mit Anthropic API-Zugriff und auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry verfügbar. Aktivieren Sie sie auf Pro über die Zeile „Dynamic workflows" in `/config`.10 Dynamische Workflows erfordern Claude Code v2.1.154 oder später und sind auf allen bezahlten Plänen, mit Anthropic API-Zugriff und auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry verfügbar. Aktivieren Sie sie auf Pro über die Zeile „Dynamic workflows" in `/config`.

13</Note>11</Note>

14 12

15Ein dynamischer Workflow ist ein JavaScript-Skript, das [Subagenten](/de/sub-agents) im großen Maßstab orchestriert. Claude schreibt das Skript für die Aufgabe, die Sie beschreiben, und eine Laufzeit führt es im Hintergrund aus, während Ihre Sitzung reaktionsschnell bleibt.13Ein dynamischer Workflow ist ein JavaScript-Skript, das [Subagenten](/docs/de/sub-agents) im großen Maßstab orchestriert. Claude schreibt das Skript für die Aufgabe, die Sie beschreiben, und eine Laufzeit führt es im Hintergrund aus, während Ihre Sitzung reaktionsschnell bleibt.

16 14

17Greifen Sie zu einem Workflow, wenn eine Aufgabe mehr Agenten benötigt, als ein Gespräch koordinieren kann, oder wenn Sie die Orchestrierung als Skript codifizieren möchten, das Sie lesen und erneut ausführen können. Beispiele sind eine codebase-weite Fehlersuche, eine 500-Datei-Migration, eine Forschungsfrage, die Quellen gegeneinander überprüft, und ein schwieriger Plan, der aus mehreren unabhängigen Blickwinkeln entworfen werden sollte, bevor Sie sich auf einen einigen.15Greifen Sie zu einem Workflow, wenn eine Aufgabe mehr Agenten benötigt, als ein Gespräch koordinieren kann, oder wenn Sie die Orchestrierung als Skript codifizieren möchten, das Sie lesen und erneut ausführen können. Beispiele sind eine codebase-weite Fehlersuche, eine 500-Datei-Migration, eine Forschungsfrage, die Quellen gegeneinander überprüft, und ein schwieriger Plan, der aus mehreren unabhängigen Blickwinkeln entworfen werden sollte, bevor Sie sich auf einen einigen.

18 16

20 Wann Sie einen Workflow verwenden18 Wann Sie einen Workflow verwenden

21</h2>19</h2>

22 20

~~23[Subagenten](/de/sub-agents), [Skills](/de/skills), [Agent-Teams](/de/agent-teams) und Workflows können alle eine mehrstufige Aufgabe ausführen. Der Unterschied liegt darin, wer den Plan hält:~~21[Subagenten](/docs/de/sub-agents), [Skills](/docs/de/skills), [Agent-Teams](/docs/de/agent-teams) und Workflows können alle eine mehrstufige Aufgabe ausführen. Der Unterschied liegt darin, wer den Plan hält:

24 22

26| :------------------------------------------------ | :----------------------------------- | :----------------------------------- | :----------------------------------------------- | :----------------------------------------------- |24| :------------------------------------------------ | :----------------------------------- | :----------------------------------- | :----------------------------------------------- | :----------------------------------------------- |

69 <Step title="Lesen Sie den Bericht">67 <Step title="Lesen Sie den Bericht">

70 Wenn die Ausführung abgeschlossen ist, landet der Bericht in Ihrer Sitzung. Er zitiert die Quellen, aus denen jeder Anspruch stammt, wobei Ansprüche, die die Überprüfung nicht überlebt haben, bereits gefiltert sind.68 Wenn die Ausführung abgeschlossen ist, landet der Bericht in Ihrer Sitzung. Er zitiert die Quellen, aus denen jeder Anspruch stammt, wobei Ansprüche, die die Überprüfung nicht überlebt haben, bereits gefiltert sind.

71 69

72 {/* min-version: 2.1.196 */}Ab v2.1.196 listet der Bericht einen Anspruch als unverified auf, wenn die Verifier-Agenten einen Anspruch nicht überprüfen können, z. B. nach einem Rate Limit oder API-Fehler, anstatt ihn als widerlegt zu zählen.70 Ab v2.1.196 listet der Bericht einen Anspruch als unverified auf, wenn die Verifier-Agenten einen Anspruch nicht überprüfen können, z. B. nach einem Rate Limit oder API-Fehler, anstatt ihn als widerlegt zu zählen.

73 </Step>71 </Step>

74</Steps>72</Steps>

75 73

83 81

84| Befehl | Was er tut |82| Befehl | Was er tut |

85| :-------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |83| :-------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

86| `/deep-research <question>` | Verteilt Websuchen zu einer Frage über mehrere Blickwinkel, ruft die gefundenen Quellen ab und überprüft sie gegenseitig, stimmt über jeden Anspruch ab und gibt einen zitierten Bericht mit Ansprüchen zurück, die die Überprüfung nicht überlebt haben, gefiltert. Erfordert, dass das [WebSearch-Tool](/de/tools-reference#websearch-tool-behavior) verfügbar ist |84| `/deep-research <question>` | Verteilt Websuchen zu einer Frage über mehrere Blickwinkel, ruft die gefundenen Quellen ab und überprüft sie gegenseitig, stimmt über jeden Anspruch ab und gibt einen zitierten Bericht mit Ansprüchen zurück, die die Überprüfung nicht überlebt haben, gefiltert. Erfordert, dass das [WebSearch-Tool](/docs/de/tools-reference#websearch-tool-behavior) verfügbar ist |

87 85

88[Workflows, die Sie selbst speichern](#save-the-workflow-for-reuse), werden auf die gleiche Weise zu Befehlen und erscheinen in der `/`-Autovervollständigung neben den gebündelten.86[Workflows, die Sie selbst speichern](#save-the-workflow-for-reuse), werden auf die gleiche Weise zu Befehlen und erscheinen in der `/`-Autovervollständigung neben den gebündelten.

89 87

105| `Enter` oder `→` | Führen Sie einen Drilldown in die ausgewählte Phase durch, dann in einen Agenten, um seine Eingabeaufforderung, aktuelle Toolaufrufe und Ergebnis zu lesen |103| `Enter` oder `→` | Führen Sie einen Drilldown in die ausgewählte Phase durch, dann in einen Agenten, um seine Eingabeaufforderung, aktuelle Toolaufrufe und Ergebnis zu lesen |

106| `Esc` oder `←` | Gehen Sie eine Ebene zurück. In v2.1.203 bis v2.1.205 hat `←` nicht aus einer Phase oder einem Agenten zurückgetreten; verwenden Sie `Esc` auf diesen Versionen |104| `Esc` oder `←` | Gehen Sie eine Ebene zurück. In v2.1.203 bis v2.1.205 hat `←` nicht aus einer Phase oder einem Agenten zurückgetreten; verwenden Sie `Esc` auf diesen Versionen |

107| `j` / `k` | Scrollen Sie innerhalb der Agent-Details, wenn sie überläuft |105| `j` / `k` | Scrollen Sie innerhalb der Agent-Details, wenn sie überläuft |

108| `f` | {/* min-version: 2.1.186 */}Filtern Sie die Agentenliste in der ausgewählten Phase nach Status. Drücken Sie erneut, um zu wechseln |106| `f` | Filtern Sie die Agentenliste in der ausgewählten Phase nach Status. Drücken Sie erneut, um zu wechseln |

109| `p` | Unterbrechen oder fortsetzen Sie die Ausführung |107| `p` | Unterbrechen oder fortsetzen Sie die Ausführung |

110| `x` | Beenden Sie den ausgewählten Agenten, oder beenden Sie den gesamten Workflow, wenn der Fokus auf der Ausführung liegt |108| `x` | Beenden Sie den ausgewählten Agenten, oder beenden Sie den gesamten Workflow, wenn der Fokus auf der Ausführung liegt |

111| `r` | Starten Sie den ausgewählten laufenden Agenten neu |109| `r` | Starten Sie den ausgewählten laufenden Agenten neu |

142 Lassen Sie Claude mit Ultracode entscheiden140 Lassen Sie Claude mit Ultracode entscheiden

143</h3>141</h3>

144 142

145Ultracode ist eine Claude Code-Einstellung, die `xhigh` [Anstrengungsebene](/de/model-config#adjust-effort-level) mit automatischer Workflow-Orchestrierung kombiniert. Wenn es aktiviert ist, plant Claude einen Workflow für jede wesentliche Aufgabe, anstatt auf Sie zu warten.143Ultracode ist eine Claude Code-Einstellung, die `xhigh` [Anstrengungsebene](/docs/de/model-config#adjust-effort-level) mit automatischer Workflow-Orchestrierung kombiniert. Wenn es aktiviert ist, plant Claude einen Workflow für jede wesentliche Aufgabe, anstatt auf Sie zu warten.

146 144

147```text theme={null}145```text theme={null}

148/effort ultracode146/effort ultracode

152 150

153Mit Ultracode aktiviert entscheidet Claude, wann eine Aufgabe einen Workflow rechtfertigt. Eine einzelne Anfrage kann sich in mehrere Workflows hintereinander verwandeln: einen zum Verstehen des Codes, einen zum Vornehmen der Änderung und einen zum Überprüfen. Dies gilt für jede Aufgabe in der Sitzung, sodass jede Anfrage mehr Token verwendet und länger dauert als bei niedrigeren Anstrengungsebenen.151Mit Ultracode aktiviert entscheidet Claude, wann eine Aufgabe einen Workflow rechtfertigt. Eine einzelne Anfrage kann sich in mehrere Workflows hintereinander verwandeln: einen zum Verstehen des Codes, einen zum Vornehmen der Änderung und einen zum Überprüfen. Dies gilt für jede Aufgabe in der Sitzung, sodass jede Anfrage mehr Token verwendet und länger dauert als bei niedrigeren Anstrengungsebenen.

154 152

155Ultracode dauert für die aktuelle Sitzung und wird zurückgesetzt, wenn Sie eine neue starten. Gehen Sie mit `/effort high` zurück, wenn Sie zur Routinearbeit zurückkehren. Es ist auf Modellen verfügbar, die `xhigh` [Anstrengung](/de/model-config#adjust-effort-level) unterstützen; auf anderen Modellen bietet das `/effort`-Menü es nicht an.153Ultracode dauert für die aktuelle Sitzung und wird zurückgesetzt, wenn Sie eine neue starten. Gehen Sie mit `/effort high` zurück, wenn Sie zur Routinearbeit zurückkehren. Es ist auf Modellen verfügbar, die `xhigh` [Anstrengung](/docs/de/model-config#adjust-effort-level) unterstützen; auf anderen Modellen bietet das `/effort`-Menü es nicht an.

156 154

157<h3 id="approve-the-plan-before-it-runs">155<h3 id="approve-the-plan-before-it-runs">

158 Genehmigen Sie den Plan, bevor er ausgeführt wird156 Genehmigen Sie den Plan, bevor er ausgeführt wird

167 165

168`Ctrl+G` öffnet das Skript in Ihrem Editor. `Tab` ermöglicht es Ihnen, die Eingabeaufforderung vor dem Start der Ausführung anzupassen.166`Ctrl+G` öffnet das Skript in Ihrem Editor. `Tab` ermöglicht es Ihnen, die Eingabeaufforderung vor dem Start der Ausführung anzupassen.

169 167

170Ob Sie diese Eingabeaufforderung sehen, hängt von Ihrem [Berechtigungsmodus](/de/permission-modes) ab:168Ob Sie diese Eingabeaufforderung sehen, hängt von Ihrem [Berechtigungsmodus](/docs/de/permission-modes) ab:

171 169

172| Berechtigungsmodus | Wann Sie aufgefordert werden |170| Berechtigungsmodus | Wann Sie aufgefordert werden |

173| :--------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |171| :--------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

177 175

178In der Desktop-App zeigt eine Genehmigungskarte den Workflow-Namen, die Phasenliste und eine Token-Nutzungswarnung mit den Aktionen **Einmal**, **Immer** und **Ablehnen**. Die Fortschrittsansicht wird im Seitenpanel „Hintergrundaufgaben" angezeigt.176In der Desktop-App zeigt eine Genehmigungskarte den Workflow-Namen, die Phasenliste und eine Token-Nutzungswarnung mit den Aktionen **Einmal**, **Immer** und **Ablehnen**. Die Fortschrittsansicht wird im Seitenpanel „Hintergrundaufgaben" angezeigt.

179 177

180Ihr Berechtigungsmodus steuert nur die oben genannte Startaufforderung. Die Subagenten, die der Workflow spawnt, werden immer im `acceptEdits`-Modus ausgeführt und erben Ihre [Tool-Zulassungsliste](/de/settings#permission-settings), unabhängig vom Modus Ihrer Sitzung. Dateibearbeitungen werden automatisch genehmigt.178Ihr Berechtigungsmodus steuert nur die oben genannte Startaufforderung. Die Subagenten, die der Workflow spawnt, werden immer im `acceptEdits`-Modus ausgeführt und erben Ihre [Tool-Zulassungsliste](/docs/de/settings#permission-settings), unabhängig vom Modus Ihrer Sitzung. Dateibearbeitungen werden automatisch genehmigt.

181 179

182Shell-Befehle, Web-Abrufe und MCP-Tools, die nicht in Ihrer Zulassungsliste enthalten sind, können Sie während der Ausführung immer noch auffordern. Um dies bei einer langen Ausführung zu vermeiden, fügen Sie die Befehle, die die Agenten benötigen, vor dem Start zu Ihrer Zulassungsliste hinzu.180Shell-Befehle, Web-Abrufe und MCP-Tools, die nicht in Ihrer Zulassungsliste enthalten sind, können Sie während der Ausführung immer noch auffordern. Um dies bei einer langen Ausführung zu vermeiden, fügen Sie die Befehle, die die Agenten benötigen, vor dem Start zu Ihrer Zulassungsliste hinzu.

183 181

192Führen Sie `/workflows` aus, wählen Sie die Ausführung aus, die Sie behalten möchten, und drücken Sie `s`. Im Speicherdialog wechselt Tab zwischen den beiden Speicherorten:190Führen Sie `/workflows` aus, wählen Sie die Ausführung aus, die Sie behalten möchten, und drücken Sie `s`. Im Speicherdialog wechselt Tab zwischen den beiden Speicherorten:

193 191

194* `.claude/workflows/` in Ihrem Projekt: Geteilt mit jedem, der das Repo klont192* `.claude/workflows/` in Ihrem Projekt: Geteilt mit jedem, der das Repo klont

195* `~/.claude/workflows/` in Ihrem Home-Verzeichnis: Verfügbar in jedem Projekt, nur für Sie sichtbar. Wenn Sie [`CLAUDE_CONFIG_DIR`](/de/env-vars) setzen, ist dieser Speicherort das `workflows/`-Verzeichnis unter diesem Pfad.193* `~/.claude/workflows/` in Ihrem Home-Verzeichnis: Verfügbar in jedem Projekt, nur für Sie sichtbar. Wenn Sie [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) setzen, ist dieser Speicherort das `workflows/`-Verzeichnis unter diesem Pfad.

196 194

197{/* min-version: 2.1.208 */}Der Speicherdialog zeigt den aufgelösten Pfad für den persönlichen Speicherort an. Vor v2.1.208 zeigte er `~/.claude/workflows/` auch dann an, wenn `CLAUDE_CONFIG_DIR` gesetzt war; die Datei wurde trotzdem unter dem konfigurierten Verzeichnis gespeichert.195Der Speicherdialog zeigt den aufgelösten Pfad für den persönlichen Speicherort an. Vor v2.1.208 zeigte er `~/.claude/workflows/` auch dann an, wenn `CLAUDE_CONFIG_DIR` gesetzt war; die Datei wurde trotzdem unter dem konfigurierten Verzeichnis gespeichert.

198 196

199Drücken Sie Enter zum Speichern. Der Workflow wird in zukünftigen Sitzungen von beiden Orten aus als `/<name>` ausgeführt.197Drücken Sie Enter zum Speichern. Der Workflow wird in zukünftigen Sitzungen von beiden Orten aus als `/<name>` ausgeführt.

200 198

201{/* min-version: 2.1.178 */}In einem Monorepo mit mehreren `.claude/`-Verzeichnissen können Sie Workflows neben dem Paket speichern, auf das sie sich beziehen. Ab v2.1.178 schreibt das Speichern am Projektort in das nächste `.claude/workflows/`-Verzeichnis, das bereits zwischen Ihrem Arbeitsverzeichnis und dem Repository-Root vorhanden ist, oder zum Repository-Root, wenn noch keines vorhanden ist. Projekt-Workflows werden auch aus jedem `.claude/workflows/` entlang dieses Pfads geladen, und wenn mehr als einer denselben Namen definiert, führt Claude Code denjenigen aus, der dem Arbeitsverzeichnis am nächsten ist.199In einem Monorepo mit mehreren `.claude/`-Verzeichnissen können Sie Workflows neben dem Paket speichern, auf das sie sich beziehen. Ab v2.1.178 schreibt das Speichern am Projektort in das nächste `.claude/workflows/`-Verzeichnis, das bereits zwischen Ihrem Arbeitsverzeichnis und dem Repository-Root vorhanden ist, oder zum Repository-Root, wenn noch keines vorhanden ist. Projekt-Workflows werden auch aus jedem `.claude/workflows/` entlang dieses Pfads geladen, und wenn mehr als einer denselben Namen definiert, führt Claude Code denjenigen aus, der dem Arbeitsverzeichnis am nächsten ist.

202 200

203Wenn ein Projekt-Workflow und ein persönlicher Workflow denselben Namen teilen, wird der Projekt-Workflow ausgeführt.201Wenn ein Projekt-Workflow und ein persönlicher Workflow denselben Namen teilen, wird der Projekt-Workflow ausgeführt.

204 202

305return audits.filter(Boolean)303return audits.filter(Boolean)

306```304```

307 305

308Der Body ist einfaches JavaScript mit Top-Level-`await`. `agent()` spawnt einen Subagenten und `pipeline()` führt einen pro Element in einer Liste aus. Wenn Sie ein Skript von Hand bearbeiten möchten, bitten Sie Claude, Sie durch die Änderung zu führen, oder siehe den Workflow-Tool-Eintrag in der [Agent SDK-Referenz](/de/agent-sdk/typescript) für den vollständigen Satz von Optionen.306Der Body ist einfaches JavaScript mit Top-Level-`await`. `agent()` spawnt einen Subagenten und `pipeline()` führt einen pro Element in einer Liste aus. Wenn Sie ein Skript von Hand bearbeiten möchten, bitten Sie Claude, Sie durch die Änderung zu führen, oder siehe den Workflow-Tool-Eintrag in der [Agent SDK-Referenz](/docs/de/agent-sdk/typescript) für den vollständigen Satz von Optionen.

309 307

310<h2 id="how-a-workflow-runs">308<h2 id="how-a-workflow-runs">

311 Wie ein Workflow ausgeführt wird309 Wie ein Workflow ausgeführt wird

359* Wenn Sie [eine Größenrichtlinie festlegen](#set-a-size-guideline), ersetzt die Agentenzahl der Richtlinie den Schwellenwert von 25 Agenten.357* Wenn Sie [eine Größenrichtlinie festlegen](#set-a-size-guideline), ersetzt die Agentenzahl der Richtlinie den Schwellenwert von 25 Agenten.

360* Sitzungen mit [ultracode](#let-claude-decide-with-ultracode) aktiviert zeigen die Warnung nicht an, da das Aktivieren von ultracode Sie bereits für große Ausführungen anmeldet.358* Sitzungen mit [ultracode](#let-claude-decide-with-ultracode) aktiviert zeigen die Warnung nicht an, da das Aktivieren von ultracode Sie bereits für große Ausführungen anmeldet.

361 359

362Jeder Agent in einem Workflow verwendet das Modell Ihrer Sitzung, es sei denn, das Skript leitet eine Phase zu einem anderen weiter oder die Umgebungsvariable [`CLAUDE_CODE_SUBAGENT_MODEL`](/de/model-config#environment-variables) ist gesetzt, was beides überschreibt. Um die Modellkosten zu kontrollieren:360Jeder Agent in einem Workflow verwendet das Modell Ihrer Sitzung, es sei denn, das Skript leitet eine Phase zu einem anderen weiter oder die Umgebungsvariable [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/de/model-config#environment-variables) ist gesetzt, was beides überschreibt. Um die Modellkosten zu kontrollieren:

363 361

364* Überprüfen Sie `/model` vor einer großen Ausführung, wenn Sie normalerweise zu einem kleineren Modell für Routinearbeit wechseln362* Überprüfen Sie `/model` vor einer großen Ausführung, wenn Sie normalerweise zu einem kleineren Modell für Routinearbeit wechseln

365* Bitten Sie Claude, ein kleineres Modell für Phasen zu verwenden, die nicht das stärkste benötigen, wenn Sie die Aufgabe beschreiben363* Bitten Sie Claude, ein kleineres Modell für Phasen zu verwenden, die nicht das stärkste benötigen, wenn Sie die Aufgabe beschreiben

385 Schalten Sie Workflows aus383 Schalten Sie Workflows aus

386</h3>384</h3>

387 385

388Workflows sind in der CLI, der Desktop-App, den IDE-Erweiterungen, [nicht-interaktivem Modus](/de/headless) mit `claude -p` und dem [Agent SDK](/de/agent-sdk/overview) verfügbar. Die gleichen Deaktivierungseinstellungen gelten auf jeder Oberfläche.386Workflows sind in der CLI, der Desktop-App, den IDE-Erweiterungen, [nicht-interaktivem Modus](/docs/de/headless) mit `claude -p` und dem [Agent SDK](/docs/de/agent-sdk/overview) verfügbar. Die gleichen Deaktivierungseinstellungen gelten auf jeder Oberfläche.

389 387

390Um Workflows für sich selbst auszuschalten:388Um Workflows für sich selbst auszuschalten:

391 389

393* Setzen Sie `"disableWorkflows": true` in `~/.claude/settings.json`. Bleibt über Sitzungen hinweg erhalten.391* Setzen Sie `"disableWorkflows": true` in `~/.claude/settings.json`. Bleibt über Sitzungen hinweg erhalten.

394* Setzen Sie `CLAUDE_CODE_DISABLE_WORKFLOWS=1`. Wird beim Start gelesen, daher gilt es überall dort, wo Sie es setzen.392* Setzen Sie `CLAUDE_CODE_DISABLE_WORKFLOWS=1`. Wird beim Start gelesen, daher gilt es überall dort, wo Sie es setzen.

395 393

396Um Workflows für Ihre gesamte Organisation auszuschalten, setzen Sie `"disableWorkflows": true` in [verwalteten Einstellungen](/de/server-managed-settings) oder verwenden Sie den Umschalter auf der Seite [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code).394Um Workflows für Ihre gesamte Organisation auszuschalten, setzen Sie `"disableWorkflows": true` in [verwalteten Einstellungen](/docs/de/server-managed-settings) oder verwenden Sie den Umschalter auf der Seite [Claude Code-Administratoreinstellungen](https://claude.ai/admin-settings/claude-code).

397 395

398Wenn Workflows deaktiviert sind, sind die gebündelten Workflow-Befehle nicht verfügbar, das Schlüsselwort `ultracode` löst keine Ausführung mehr aus, und `ultracode` wird aus dem `/effort`-Menü entfernt.396Wenn Workflows deaktiviert sind, sind die gebündelten Workflow-Befehle nicht verfügbar, das Schlüsselwort `ultracode` löst keine Ausführung mehr aus, und `ultracode` wird aus dem `/effort`-Menü entfernt.

399 397

401 Verwandte Ressourcen399 Verwandte Ressourcen

402</h2>400</h2>

403 401

404* [Führen Sie Agenten parallel aus](/de/agents): Vergleichen Sie Subagenten, Agent-Ansicht, Agent-Teams und Workflows402* [Führen Sie Agenten parallel aus](/docs/de/agents): Vergleichen Sie Subagenten, Agent-Ansicht, Agent-Teams und Workflows

405* [Erstellen Sie benutzerdefinierte Subagenten](/de/sub-agents): Der Worker-Primitive, den Workflows orchestrieren403* [Erstellen Sie benutzerdefinierte Subagenten](/docs/de/sub-agents): Der Worker-Primitive, den Workflows orchestrieren

406* [Verwalten Sie Kosten](/de/costs): Wie Multi-Agent-Ausführungen zu Ihren Nutzungslimits zählen404* [Verwalten Sie Kosten](/docs/de/costs): Wie Multi-Agent-Ausführungen zu Ihren Nutzungslimits zählen

worktrees.md +21 −21

Details

8 8

9Ein [Git-Worktree](https://git-scm.com/docs/git-worktree) ist ein separates Arbeitsverzeichnis mit eigenen Dateien und Branch, das die gleiche Repository-Historie und Remote wie Ihr Haupt-Checkout teilt. Das Ausführen jeder Claude Code-Sitzung in ihrem eigenen Worktree bedeutet, dass Änderungen in einer Sitzung niemals Dateien in einer anderen berühren, sodass Claude in einem Terminal ein Feature entwickeln kann, während Sie in einem zweiten einen Bug beheben.9Ein [Git-Worktree](https://git-scm.com/docs/git-worktree) ist ein separates Arbeitsverzeichnis mit eigenen Dateien und Branch, das die gleiche Repository-Historie und Remote wie Ihr Haupt-Checkout teilt. Das Ausführen jeder Claude Code-Sitzung in ihrem eigenen Worktree bedeutet, dass Änderungen in einer Sitzung niemals Dateien in einer anderen berühren, sodass Claude in einem Terminal ein Feature entwickeln kann, während Sie in einem zweiten einen Bug beheben.

10 10

11Diese Seite behandelt die Worktree-Isolation in der CLI. Alles unten setzt ein Git-Repository voraus. Für andere Versionskontrollsysteme siehe [Non-Git-Versionskontrolle](#non-git-version-control). Die [Desktop-App](/de/desktop#work-in-parallel-with-sessions) erstellt für jede neue Sitzung automatisch einen Worktree.11Diese Seite behandelt die Worktree-Isolation in der CLI. Alles unten setzt ein Git-Repository voraus. Für andere Versionskontrollsysteme siehe [Non-Git-Versionskontrolle](#non-git-version-control). Die [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions) erstellt für jede neue Sitzung automatisch einen Worktree.

12 12

13Worktrees sind eine von mehreren Möglichkeiten, Claude parallel auszuführen. Sie isolieren Datei-Änderungen, während [Subagents](/de/sub-agents) und [Agent-Teams](/de/agent-teams) die Arbeit selbst koordinieren. Siehe [Agenten parallel ausführen](/de/agents), um die Ansätze zu vergleichen, oder springen Sie direkt zu [Subagents mit Worktrees isolieren](#isolate-subagents-with-worktrees), um Worktrees und Subagents zusammen zu verwenden.13Worktrees sind eine von mehreren Möglichkeiten, Claude parallel auszuführen. Sie isolieren Datei-Änderungen, während [Subagents](/docs/de/sub-agents) und [Agent-Teams](/docs/de/agent-teams) die Arbeit selbst koordinieren. Siehe [Agenten parallel ausführen](/docs/de/agents), um die Ansätze zu vergleichen, oder springen Sie direkt zu [Subagents mit Worktrees isolieren](#isolate-subagents-with-worktrees), um Worktrees und Subagents zusammen zu verwenden.

14 14

15<h2 id="start-claude-in-a-worktree">15<h2 id="start-claude-in-a-worktree">

16 Starten Sie Claude in einem Worktree16 Starten Sie Claude in einem Worktree

34claude --worktree34claude --worktree

35```35```

36 36

37Sie können Claude auch während einer Sitzung bitten, „in einem Worktree zu arbeiten", und es wird einen mit dem [`EnterWorktree`](/de/tools-reference)-Tool erstellen. Sobald Sie sich in einem Worktree befinden, kann Claude direkt zu einem anderen unter `.claude/worktrees/` wechseln, indem er `EnterWorktree` mit dem Zielpfad aufruft. Der vorherige Worktree bleibt unverändert auf der Festplatte.37Sie können Claude auch während einer Sitzung bitten, „in einem Worktree zu arbeiten", und es wird einen mit dem [`EnterWorktree`](/docs/de/tools-reference)-Tool erstellen. Sobald Sie sich in einem Worktree befinden, kann Claude direkt zu einem anderen unter `.claude/worktrees/` wechseln, indem er `EnterWorktree` mit dem Zielpfad aufruft. Der vorherige Worktree bleibt unverändert auf der Festplatte.

38 38

39Das Betreten eines Pfads außerhalb des Verzeichnisses `.claude/worktrees/` des Repositories erfordert zunächst Ihre Genehmigung, da es das Arbeitsverzeichnis der Sitzung, den Schreibzugriff und die Projektkonfiguration wie `CLAUDE.md` und Einstellungen an diesen Ort verschiebt. Eine [`EnterWorktree`-Berechtigung](/de/permissions) oder die Wahl von „nicht mehr fragen" unterdrückt diese Aufforderung nicht; nur der `bypassPermissions`-Modus überspringt sie. Vor v2.1.206 konnte Claude jeden vorhandenen Worktree-Pfad ohne Nachfrage betreten.39Das Betreten eines Pfads außerhalb des Verzeichnisses `.claude/worktrees/` des Repositories erfordert zunächst Ihre Genehmigung, da es das Arbeitsverzeichnis der Sitzung, den Schreibzugriff und die Projektkonfiguration wie `CLAUDE.md` und Einstellungen an diesen Ort verschiebt. Eine [`EnterWorktree`-Berechtigung](/docs/de/permissions) oder die Wahl von „nicht mehr fragen" unterdrückt diese Aufforderung nicht; nur der `bypassPermissions`-Modus überspringt sie. Vor v2.1.206 konnte Claude jeden vorhandenen Worktree-Pfad ohne Nachfrage betreten.

40 40

41{/* min-version: 2.1.198 */}Ab v2.1.198 werden beim Betreten oder Verlassen eines Worktrees auch das Sitzungstranskript in das Projektverzeichnis dieses Verzeichnisses verschoben, auf die gleiche Weise wie [`/cd`](/de/commands), sodass `/desktop` und `--resume` die Sitzung danach dort finden. Worktrees, die von einem [`WorktreeCreate`-Hook](#non-git-version-control) erstellt wurden, sind ausgeschlossen und behalten das Transkript im Startverzeichnis.41Ab v2.1.198 werden beim Betreten oder Verlassen eines Worktrees auch das Sitzungstranskript in das Projektverzeichnis dieses Verzeichnisses verschoben, auf die gleiche Weise wie [`/cd`](/docs/de/commands), sodass `/desktop` und `--resume` die Sitzung danach dort finden. Worktrees, die von einem [`WorktreeCreate`-Hook](#non-git-version-control) erstellt wurden, sind ausgeschlossen und behalten das Transkript im Startverzeichnis.

42 42

43Worktrees funktionieren mit aktiviertem [Sandboxing](/de/sandboxing#filesystem-isolation): Die Sandbox erlaubt Schreibvorgänge in das gemeinsame `.git`-Verzeichnis des Haupt-Repositories, sodass Befehle wie `git commit` Refs und den Index von innerhalb eines verknüpften Worktrees aktualisieren können.43Worktrees funktionieren mit aktiviertem [Sandboxing](/docs/de/sandboxing#filesystem-isolation): Die Sandbox erlaubt Schreibvorgänge in das gemeinsame `.git`-Verzeichnis des Haupt-Repositories, sodass Befehle wie `git commit` Refs und den Index von innerhalb eines verknüpften Worktrees aktualisieren können.

44 44

45Bevor Sie `--worktree` interaktiv in einem Verzeichnis zum ersten Mal verwenden, akzeptieren Sie den Dialog zum Vertrauen des Arbeitsbereichs, indem Sie `claude` einmal in diesem Verzeichnis ausführen. Wenn das Vertrauen noch nicht akzeptiert wurde, beendet sich `--worktree` mit einem Fehler und fordert Sie auf, zuerst `claude` im Verzeichnis auszuführen. Nicht-interaktive Ausführungen mit `-p` überspringen die [Vertrauensprüfung](/de/security), sodass `claude -p --worktree` ohne diese fortfährt.45Bevor Sie `--worktree` interaktiv in einem Verzeichnis zum ersten Mal verwenden, akzeptieren Sie den Dialog zum Vertrauen des Arbeitsbereichs, indem Sie `claude` einmal in diesem Verzeichnis ausführen. Wenn das Vertrauen noch nicht akzeptiert wurde, beendet sich `--worktree` mit einem Fehler und fordert Sie auf, zuerst `claude` im Verzeichnis auszuführen. Nicht-interaktive Ausführungen mit `-p` überspringen die [Vertrauensprüfung](/docs/de/security), sodass `claude -p --worktree` ohne diese fortfährt.

46 46

47Wenn Claude Code beim Start nicht in das Worktree-Verzeichnis wechseln kann, beispielsweise weil ein [`WorktreeCreate`-Hook](/de/hooks#worktreecreate) etwas anderes als das erstellte Verzeichnis ausgegeben hat oder weil das Verzeichnis nach der Einrichtung gelöscht wurde, gibt Claude Code einen Fehler aus, der den Pfad benennt, und beendet sich mit Code 1. Vor v2.1.205 stürzte dies die Sitzung ab, und mit `-p` stagnierte es etwa 30 Sekunden lang, bevor es mit Code 0 beendet wurde.47Wenn Claude Code beim Start nicht in das Worktree-Verzeichnis wechseln kann, beispielsweise weil ein [`WorktreeCreate`-Hook](/docs/de/hooks#worktreecreate) etwas anderes als das erstellte Verzeichnis ausgegeben hat oder weil das Verzeichnis nach der Einrichtung gelöscht wurde, gibt Claude Code einen Fehler aus, der den Pfad benennt, und beendet sich mit Code 1. Vor v2.1.205 stürzte dies die Sitzung ab, und mit `-p` stagnierte es etwa 30 Sekunden lang, bevor es mit Code 0 beendet wurde.

48 48

49{/* min-version: 2.1.200 */}Plugins, die im [Projektbereich](/de/plugins-reference#plugin-installation-scopes) aus dem Haupt-Checkout installiert sind, werden auch in Worktrees desselben Repositories geladen, sodass Sie sie nicht pro Worktree neu installieren müssen. Dies gilt, ob Sie den Worktree mit `--worktree` oder mit `git worktree add` erstellen. Erfordert Claude Code v2.1.200 oder später.49Plugins, die im [Projektbereich](/docs/de/plugins-reference#plugin-installation-scopes) aus dem Haupt-Checkout installiert sind, werden auch in Worktrees desselben Repositories geladen, sodass Sie sie nicht pro Worktree neu installieren müssen. Dies gilt, ob Sie den Worktree mit `--worktree` oder mit `git worktree add` erstellen. Erfordert Claude Code v2.1.200 oder später.

50 50

51<Tip>51<Tip>

52 Fügen Sie `.claude/worktrees/` zu Ihrer `.gitignore` hinzu, damit Worktree-Inhalte nicht als nicht verfolgte Dateien in Ihrem Haupt-Checkout angezeigt werden.52 Fügen Sie `.claude/worktrees/` zu Ihrer `.gitignore` hinzu, damit Worktree-Inhalte nicht als nicht verfolgte Dateien in Ihrem Haupt-Checkout angezeigt werden.

60 60

61Die Aktualisierung erfordert Claude Code v2.1.208 oder später; davor verwendete ein neuer Worktree, was immer `origin/HEAD` bereits lokal zwischengespeichert war.61Die Aktualisierung erfordert Claude Code v2.1.208 oder später; davor verwendete ein neuer Worktree, was immer `origin/HEAD` bereits lokal zwischengespeichert war.

62 62

63Um immer vom lokalen `HEAD` zu verzweigen, setzen Sie `worktree.baseRef` auf `"head"` in [Einstellungen](/de/settings#worktree-settings). Das Setzen von `baseRef` auf `"head"` führt dazu, dass neue Worktrees Ihre nicht gepushten Commits und den Feature-Branch-Status tragen, was nützlich ist, wenn Sie Subagents isolieren, die an laufenden Arbeiten arbeiten müssen. Wenn die Sitzung in einem verknüpften Worktree ausgeführt wird, wird `"head"` zu diesem Worktrees `HEAD` aufgelöst, nicht zum `HEAD` des Haupt-Checkouts. Die Einstellung akzeptiert nur `"fresh"` oder `"head"`, nicht beliebige Git-Refs:63Um immer vom lokalen `HEAD` zu verzweigen, setzen Sie `worktree.baseRef` auf `"head"` in [Einstellungen](/docs/de/settings#worktree-settings). Das Setzen von `baseRef` auf `"head"` führt dazu, dass neue Worktrees Ihre nicht gepushten Commits und den Feature-Branch-Status tragen, was nützlich ist, wenn Sie Subagents isolieren, die an laufenden Arbeiten arbeiten müssen. Wenn die Sitzung in einem verknüpften Worktree ausgeführt wird, wird `"head"` zu diesem Worktrees `HEAD` aufgelöst, nicht zum `HEAD` des Haupt-Checkouts. Die Einstellung akzeptiert nur `"fresh"` oder `"head"`, nicht beliebige Git-Refs:

64 64

65```json theme={null}65```json theme={null}

66{66{

76claude --worktree "#1234"76claude --worktree "#1234"

77```77```

78 78

~~79Für vollständige Kontrolle über die Erstellung von Worktrees konfigurieren Sie einen [`WorktreeCreate`-Hook](/de/hooks#worktreecreate), der die Standard-`git worktree`-Logik vollständig ersetzt.~~79Für vollständige Kontrolle über die Erstellung von Worktrees konfigurieren Sie einen [`WorktreeCreate`-Hook](/docs/de/hooks#worktreecreate), der die Standard-`git worktree`-Logik vollständig ersetzt.

80 80

81<h3 id="reuse-a-worktree-name">81<h3 id="reuse-a-worktree-name">

82 Worktree-Namen wiederverwenden82 Worktree-Namen wiederverwenden

108config/secrets.json108config/secrets.json

109```109```

110 110

111Dies gilt für Worktrees, die mit `--worktree` erstellt werden, [Subagent-Worktrees](#isolate-subagents-with-worktrees) und parallele Sitzungen in der [Desktop-App](/de/desktop#work-in-parallel-with-sessions).111Dies gilt für Worktrees, die mit `--worktree` erstellt werden, [Subagent-Worktrees](#isolate-subagents-with-worktrees) und parallele Sitzungen in der [Desktop-App](/docs/de/desktop#work-in-parallel-with-sessions).

112 112

113<h2 id="isolate-subagents-with-worktrees">113<h2 id="isolate-subagents-with-worktrees">

114 Isolieren Sie Subagents mit Worktrees114 Isolieren Sie Subagents mit Worktrees

115</h2>115</h2>

116 116

117Subagents können in ihren eigenen Worktrees ausgeführt werden, sodass parallele Änderungen nicht kollidieren. Bitten Sie Claude, „Worktrees für Ihre Agenten zu verwenden", oder setzen Sie es dauerhaft auf einem [benutzerdefinierten Subagent](/de/sub-agents#supported-frontmatter-fields), indem Sie `isolation: worktree` zum Frontmatter hinzufügen. Jeder Subagent erhält einen temporären Worktree, der automatisch entfernt wird, wenn der Subagent ohne Änderungen beendet wird.117Subagents können in ihren eigenen Worktrees ausgeführt werden, sodass parallele Änderungen nicht kollidieren. Bitten Sie Claude, „Worktrees für Ihre Agenten zu verwenden", oder setzen Sie es dauerhaft auf einem [benutzerdefinierten Subagent](/docs/de/sub-agents#supported-frontmatter-fields), indem Sie `isolation: worktree` zum Frontmatter hinzufügen. Jeder Subagent erhält einen temporären Worktree, der automatisch entfernt wird, wenn der Subagent ohne Änderungen beendet wird.

118 118

119Subagent-Worktrees verwenden denselben [Basisbranch](#choose-the-base-branch) wie `--worktree`, sodass sie von dem Standard-Branch Ihres Repositorys verzweigen, es sei denn, `worktree.baseRef` ist auf `"head"` gesetzt.119Subagent-Worktrees verwenden denselben [Basisbranch](#choose-the-base-branch) wie `--worktree`, sodass sie von dem Standard-Branch Ihres Repositorys verzweigen, es sei denn, `worktree.baseRef` ist auf `"head"` gesetzt.

120 120

124 124

125Wenn Sie eine Worktree-Sitzung beenden, hängt die Bereinigung davon ab, ob Sie Änderungen vorgenommen haben:125Wenn Sie eine Worktree-Sitzung beenden, hängt die Bereinigung davon ab, ob Sie Änderungen vorgenommen haben:

126 126

127* **Keine nicht committeten Änderungen, keine nicht verfolgten Dateien und keine neuen Commits**: Der Worktree und sein Branch werden automatisch entfernt. Wenn die Sitzung einen [Namen](/de/sessions#name-your-sessions) hat, fordert Claude Sie stattdessen auf, damit Sie den Worktree später behalten können127* **Keine nicht committeten Änderungen, keine nicht verfolgten Dateien und keine neuen Commits**: Der Worktree und sein Branch werden automatisch entfernt. Wenn die Sitzung einen [Namen](/docs/de/sessions#name-your-sessions) hat, fordert Claude Sie stattdessen auf, damit Sie den Worktree später behalten können

128* **Nicht committete Änderungen, nicht verfolgte Dateien oder neue Commits vorhanden**: Claude fordert Sie auf, den Worktree zu behalten oder zu entfernen. Das Behalten bewahrt das Verzeichnis und den Branch, sodass Sie später zurückkehren können. Das Entfernen löscht das Worktree-Verzeichnis und seinen Branch und verwirft alle nicht committeten Änderungen, nicht verfolgten Dateien und Commits128* **Nicht committete Änderungen, nicht verfolgte Dateien oder neue Commits vorhanden**: Claude fordert Sie auf, den Worktree zu behalten oder zu entfernen. Das Behalten bewahrt das Verzeichnis und den Branch, sodass Sie später zurückkehren können. Das Entfernen löscht das Worktree-Verzeichnis und seinen Branch und verwirft alle nicht committeten Änderungen, nicht verfolgten Dateien und Commits

129* **Nicht-interaktive Ausführungen**: Worktrees, die mit `--worktree` zusammen mit `-p` erstellt werden, werden nicht automatisch bereinigt, da es keine Exit-Eingabeaufforderung gibt. Entfernen Sie sie mit `git worktree remove`129* **Nicht-interaktive Ausführungen**: Worktrees, die mit `--worktree` zusammen mit `-p` erstellt werden, werden nicht automatisch bereinigt, da es keine Exit-Eingabeaufforderung gibt. Entfernen Sie sie mit `git worktree remove`

130 130

131Worktrees, die Claude für Subagenten und [Hintergrundsitzungen](/de/agent-view#how-file-edits-are-isolated) erstellt hat, werden automatisch entfernt, sobald sie älter als Ihre [`cleanupPeriodDays`](/de/settings#available-settings)-Einstellung sind, sofern sie keine nicht committeten Änderungen, keine nicht verfolgten Dateien und keine nicht gepushten Commits haben. Worktrees, die Sie mit `--worktree` erstellen, werden niemals durch diese Bereinigung entfernt.131Worktrees, die Claude für Subagenten und [Hintergrundsitzungen](/docs/de/agent-view#how-file-edits-are-isolated) erstellt hat, werden automatisch entfernt, sobald sie älter als Ihre [`cleanupPeriodDays`](/docs/de/settings#available-settings)-Einstellung sind, sofern sie keine nicht committeten Änderungen, keine nicht verfolgten Dateien und keine nicht gepushten Commits haben. Worktrees, die Sie mit `--worktree` erstellen, werden niemals durch diese Bereinigung entfernt.

132 132

133Während ein Agent ausgeführt wird, führt Claude `git worktree lock` auf seinem Worktree aus, damit eine gleichzeitige Bereinigung ihn nicht entfernen kann. Die Sperre wird freigegeben, wenn der Agent beendet wird. Um einen Worktree zu bereinigen, den die Bereinigung beibehält, führen Sie `git worktree remove` aus und fügen Sie `--force` hinzu, wenn der Worktree nicht committete Änderungen oder nicht verfolgte Dateien hat.133Während ein Agent ausgeführt wird, führt Claude `git worktree lock` auf seinem Worktree aus, damit eine gleichzeitige Bereinigung ihn nicht entfernen kann. Die Sperre wird freigegeben, wenn der Agent beendet wird. Um einen Worktree zu bereinigen, den die Bereinigung beibehält, führen Sie `git worktree remove` aus und fügen Sie `--force` hinzu, wenn der Worktree nicht committete Änderungen oder nicht verfolgte Dateien hat.

134 134

176 Non-Git-Versionskontrolle176 Non-Git-Versionskontrolle

177</h2>177</h2>

178 178

179Die Worktree-Isolation verwendet standardmäßig Git. Für SVN, Perforce, Mercurial oder andere Systeme konfigurieren Sie [`WorktreeCreate`- und `WorktreeRemove`-Hooks](/de/hooks#worktreecreate), um benutzerdefinierte Erstellungs- und Bereinigungslogik bereitzustellen. Da der Hook das Standard-Git-Verhalten ersetzt, wird [`.worktreeinclude`](#copy-gitignored-files-into-worktrees) nicht verarbeitet, wenn Sie `--worktree` verwenden. Kopieren Sie stattdessen alle lokalen Konfigurationsdateien in Ihr Hook-Skript.179Die Worktree-Isolation verwendet standardmäßig Git. Für SVN, Perforce, Mercurial oder andere Systeme konfigurieren Sie [`WorktreeCreate`- und `WorktreeRemove`-Hooks](/docs/de/hooks#worktreecreate), um benutzerdefinierte Erstellungs- und Bereinigungslogik bereitzustellen. Da der Hook das Standard-Git-Verhalten ersetzt, wird [`.worktreeinclude`](#copy-gitignored-files-into-worktrees) nicht verarbeitet, wenn Sie `--worktree` verwenden. Kopieren Sie stattdessen alle lokalen Konfigurationsdateien in Ihr Hook-Skript.

180 180

181Dieser `WorktreeCreate`-Hook liest den Worktree-Namen aus stdin, checkt eine frische SVN-Arbeitskopie aus und gibt den Verzeichnispfad aus, damit Claude Code ihn als Arbeitsverzeichnis der Sitzung verwenden kann:181Dieser `WorktreeCreate`-Hook liest den Worktree-Namen aus stdin, checkt eine frische SVN-Arbeitskopie aus und gibt den Verzeichnispfad aus, damit Claude Code ihn als Arbeitsverzeichnis der Sitzung verwenden kann:

182 182

197}197}

198```198```

199 199

200Kombinieren Sie es mit einem `WorktreeRemove`-Hook, um die Bereinigung durchzuführen, wenn die Sitzung endet. Siehe die [Hooks-Referenz](/de/hooks#worktreecreate) für das Eingabeschema und ein Entfernungsbeispiel.200Kombinieren Sie es mit einem `WorktreeRemove`-Hook, um die Bereinigung durchzuführen, wenn die Sitzung endet. Siehe die [Hooks-Referenz](/docs/de/hooks#worktreecreate) für das Eingabeschema und ein Entfernungsbeispiel.

201 201

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

203 Siehe auch203 Siehe auch

205 205

206Worktrees handhaben die Datei-Isolation. Die verwandten Seiten unten behandeln die Delegierung von Arbeit in diese isolierten Checkouts und das Wechseln zwischen den Sitzungen, die Sie erstellen:206Worktrees handhaben die Datei-Isolation. Die verwandten Seiten unten behandeln die Delegierung von Arbeit in diese isolierten Checkouts und das Wechseln zwischen den Sitzungen, die Sie erstellen:

207 207

208* [Subagents](/de/sub-agents): Delegieren Sie Arbeit an isolierte Agenten innerhalb einer Sitzung208* [Subagents](/docs/de/sub-agents): Delegieren Sie Arbeit an isolierte Agenten innerhalb einer Sitzung

209* [Agent-Teams](/de/agent-teams): Koordinieren Sie mehrere Claude-Sitzungen automatisch209* [Agent-Teams](/docs/de/agent-teams): Koordinieren Sie mehrere Claude-Sitzungen automatisch

210* [Sitzungen verwalten](/de/sessions): Benennen, fortsetzen und wechseln Sie zwischen Gesprächen210* [Sitzungen verwalten](/docs/de/sessions): Benennen, fortsetzen und wechseln Sie zwischen Gesprächen

211* [Desktop-Parallelsitzungen](/de/desktop#work-in-parallel-with-sessions): Worktree-gestützte Sitzungen in der Desktop-App211* [Desktop-Parallelsitzungen](/docs/de/desktop#work-in-parallel-with-sessions): Worktree-gestützte Sitzungen in der Desktop-App

Documentation 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC