SpyBara
Go Premium

Documentation 2026-05-13 23:01 UTC to 2026-05-14 17:02 UTC

22 files changed +542 −141. View all changes and history on the product overview
2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19
Details

235 235 

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

237 237 

238* **Top-Level-Felder** steuern das Gespräch: `systemMessage` fügt eine Nachricht in das Gespräch ein, die für das Modell sichtbar ist, und `continue` (`continue_` in Python) bestimmt, ob der Agent nach diesem Hook weiterläuft.238* **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.

239* **`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, oder `updatedToolOutput`, um die Ausgabe des Tools vollständig zu ersetzen, bevor Claude sie sieht.239* **`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, oder `updatedToolOutput`, um die Ausgabe des Tools vollständig zu ersetzen, bevor Claude sie sieht.

240 240 

241Geben 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.241Geben 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.


331 331 

332### Kontext hinzufügen und ein Tool blockieren332### Kontext hinzufügen und ein Tool blockieren

333 333 

334Dieses Beispiel blockiert jeden Versuch, in das `/etc` Verzeichnis zu schreiben, und verwendet zwei Ausgabefelder zusammen: `permissionDecision: 'deny'` stoppt den Tool-Aufruf, während `systemMessage` eine Erinnerung in das Gespräch einfügt, damit der Agent Kontext darüber erhält, warum die Operation blockiert wurde, und vermeidet, sie erneut zu versuchen:334Dieses Beispiel blockiert Schreibvorgänge in das `/etc` Verzeichnis und erklärt den Grund sowohl dem Modell als auch dem Benutzer:

335 

336* `permissionDecision: 'deny'` stoppt den Tool-Aufruf.

337* `permissionDecisionReason` teilt dem Modell mit, warum, damit es nicht erneut versucht.

338* `systemMessage` zeigt dem Benutzer, was passiert ist.

335 339 

336<CodeGroup>340<CodeGroup>

337 ```python Python theme={null}341 ```python Python theme={null}


340 344 

341 if file_path.startswith("/etc"):345 if file_path.startswith("/etc"):

342 return {346 return {

343 # Top-level field: inject guidance into the conversation347 # Top-level field: message shown to the user

344 "systemMessage": "Remember: system directories like /etc are protected.",348 "systemMessage": "Remember: system directories like /etc are protected.",

345 # hookSpecificOutput: block the operation349 # hookSpecificOutput: block the operation

346 "hookSpecificOutput": {350 "hookSpecificOutput": {


360 364 

361 if (filePath?.startsWith("/etc")) {365 if (filePath?.startsWith("/etc")) {

362 return {366 return {

363 // Top-level field: inject guidance into the conversation367 // Top-level field: message shown to the user

364 systemMessage: "Remember: system directories like /etc are protected.",368 systemMessage: "Remember: system directories like /etc are protected.",

365 // hookSpecificOutput: block the operation369 // hookSpecificOutput: block the operation

366 hookSpecificOutput: {370 hookSpecificOutput: {


807 811 

808### systemMessage wird nicht in der Ausgabe angezeigt812### systemMessage wird nicht in der Ausgabe angezeigt

809 813 

810Das `systemMessage` Feld fügt Kontext zum Gespräch hinzu, das das Modell sieht, aber es wird möglicherweise nicht in allen SDK-Ausgabemodi angezeigt. Wenn Sie Hook-Entscheidungen für Ihre Anwendung sichtbar machen müssen, protokollieren Sie sie separat oder verwenden Sie einen dedizierten Ausgabekanal.814Das `systemMessage` Feld zeigt eine Nachricht für den Benutzer an, nicht für das Modell. Standardmäßig gibt das SDK Hook-Ausgaben nicht im Nachrichtenstrom aus, daher wird die Nachricht möglicherweise 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.

815 

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

811 817 

812## Verwandte Ressourcen818## Verwandte Ressourcen

813 819 

Details

1860Gibt ein [`HookJSONOutput`](#hookjsonoutput) zurück, das enthalten kann:1860Gibt ein [`HookJSONOutput`](#hookjsonoutput) zurück, das enthalten kann:

1861 1861 

1862* `decision`: `"block"`, um die Aktion zu blockieren1862* `decision`: `"block"`, um die Aktion zu blockieren

1863* `systemMessage`: System-Nachricht, die zum Transkript hinzugefügt werden soll1863* `systemMessage`: Warnmeldung, die dem Benutzer angezeigt wird

1864* `hookSpecificOutput`: Hook-spezifische Ausgabedaten1864* `hookSpecificOutput`: Hook-spezifische Ausgabedaten

1865 1865 

1866### `HookContext`1866### `HookContext`


2645 2645 

2646**Tool-Name:** `TodoWrite`2646**Tool-Name:** `TodoWrite`

2647 2647 

2648<Note>

2649 `TodoWrite` ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen `TaskCreate`, `TaskGet`, `TaskUpdate` und `TaskList`. Setzen Sie `CLAUDE_CODE_ENABLE_TASKS=1`, um sich anzumelden. Siehe [Zu Task-Tools migrieren](/de/agent-sdk/todo-tracking#migrate-to-task-tools) für die Überwachung von Code-Änderungen.

2650</Note>

2651 

2648**Eingabe:**2652**Eingabe:**

2649 2653 

2650```python theme={null}2654```python theme={null}


2668}2672}

2669```2673```

2670 2674 

2675### TaskCreate

2676 

2677**Tool-Name:** `TaskCreate`

2678 

2679**Eingabe:**

2680 

2681```python theme={null}

2682{

2683 "subject": str, # Kurzer Aufgabentitel

2684 "description": str, # Detaillierter Aufgabentext

2685 "activeForm": str | None, # Präsens-Label, das während der Ausführung angezeigt wird

2686 "metadata": dict | None, # Beliebige Aufrufer-Metadaten

2687}

2688```

2689 

2690**Ausgabe:**

2691 

2692```python theme={null}

2693{

2694 "task": {"id": str, "subject": str}, # Erstellte Aufgabe mit zugewiesener ID

2695}

2696```

2697 

2698### TaskUpdate

2699 

2700**Tool-Name:** `TaskUpdate`

2701 

2702**Eingabe:**

2703 

2704```python theme={null}

2705{

2706 "taskId": str, # ID der zu patchenden Aufgabe

2707 "status": Literal["pending", "in_progress", "completed", "deleted"] | None,

2708 "subject": str | None,

2709 "description": str | None,

2710 "activeForm": str | None,

2711 "addBlocks": list[str] | None, # Aufgaben-IDs, die diese Aufgabe jetzt blockiert

2712 "addBlockedBy": list[str] | None, # Aufgaben-IDs, die diese Aufgabe jetzt blockieren

2713 "owner": str | None,

2714 "metadata": dict | None,

2715}

2716```

2717 

2718**Ausgabe:**

2719 

2720```python theme={null}

2721{

2722 "success": bool,

2723 "taskId": str,

2724 "updatedFields": list[str], # Namen der Felder, die sich geändert haben

2725 "error": str | None,

2726 "statusChange": {"from": str, "to": str} | None,

2727}

2728```

2729 

2730### TaskGet

2731 

2732**Tool-Name:** `TaskGet`

2733 

2734**Eingabe:**

2735 

2736```python theme={null}

2737{

2738 "taskId": str, # ID der zu lesenden Aufgabe

2739}

2740```

2741 

2742**Ausgabe:**

2743 

2744```python theme={null}

2745{

2746 "task": {

2747 "id": str,

2748 "subject": str,

2749 "description": str,

2750 "status": Literal["pending", "in_progress", "completed"],

2751 "blocks": list[str],

2752 "blockedBy": list[str],

2753 } | None, # None, wenn die ID nicht gefunden wird

2754}

2755```

2756 

2757### TaskList

2758 

2759**Tool-Name:** `TaskList`

2760 

2761**Eingabe:**

2762 

2763```python theme={null}

2764{}

2765```

2766 

2767**Ausgabe:**

2768 

2769```python theme={null}

2770{

2771 "tasks": [

2772 {

2773 "id": str,

2774 "subject": str,

2775 "status": Literal["pending", "in_progress", "completed"],

2776 "owner": str | None,

2777 "blockedBy": list[str],

2778 }

2779 ],

2780}

2781```

2782 

2671### BashOutput2783### BashOutput

2672 2784 

2673**Tool-Name:** `BashOutput`2785**Tool-Name:** `BashOutput`

Details

389| `fallbackModel` | `string` | `undefined` | Modell, das verwendet werden soll, wenn das primäre fehlschlägt |389| `fallbackModel` | `string` | `undefined` | Modell, das verwendet werden soll, wenn das primäre fehlschlägt |

390| `forkSession` | `boolean` | `false` | Beim Fortsetzen mit `resume` zu einer neuen Sitzungs-ID verzweigen, anstatt die ursprüngliche Sitzung fortzusetzen |390| `forkSession` | `boolean` | `false` | Beim Fortsetzen mit `resume` zu einer neuen Sitzungs-ID verzweigen, anstatt die ursprüngliche Sitzung fortzusetzen |

391| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Hook-Callbacks für Ereignisse |391| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Hook-Callbacks für Ereignisse |

392| `includeHookEvents` | `boolean` | `false` | Schließen Sie Hook-Lebenszyklusereignisse im Nachrichtenstrom als [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage) und [`SDKHookResponseMessage`](#sdkhookresponsemessage) ein |

392| `includePartialMessages` | `boolean` | `false` | Teilweise Nachrichtenereignisse einbeziehen |393| `includePartialMessages` | `boolean` | `false` | Teilweise Nachrichtenereignisse einbeziehen |

393| `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 |394| `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 |

394| `maxThinkingTokens` | `number` | `undefined` | *Veraltet:* Verwenden Sie stattdessen `thinking`. Maximale Token für den Denkprozess |395| `maxThinkingTokens` | `number` | `undefined` | *Veraltet:* Verwenden Sie stattdessen `thinking`. Maximale Token für den Denkprozess |


1596 | ReadMcpResourceInput1597 | ReadMcpResourceInput

1597 | SubscribeMcpResourceInput1598 | SubscribeMcpResourceInput

1598 | SubscribePollingInput1599 | SubscribePollingInput

1600 | TaskCreateInput

1601 | TaskGetInput

1602 | TaskListInput

1599 | TaskStopInput1603 | TaskStopInput

1604 | TaskUpdateInput

1600 | TodoWriteInput1605 | TodoWriteInput

1601 | UnsubscribeMcpResourceInput1606 | UnsubscribeMcpResourceInput

1602 | UnsubscribePollingInput1607 | UnsubscribePollingInput


1850**Tool-Name:** `TaskCreate`1855**Tool-Name:** `TaskCreate`

1851 1856 

1852```typescript theme={null}1857```typescript theme={null}

1853// Noch nicht aus dem SDK exportiert; lokal definieren.

1854type TaskCreateInput = {1858type TaskCreateInput = {

1855 subject: string;1859 subject: string;

1856 description: string;1860 description: string;


1866**Tool-Name:** `TaskUpdate`1870**Tool-Name:** `TaskUpdate`

1867 1871 

1868```typescript theme={null}1872```typescript theme={null}

1869// Noch nicht aus dem SDK exportiert; lokal definieren.

1870type TaskUpdateInput = {1873type TaskUpdateInput = {

1871 taskId: string;1874 taskId: string;

1872 status?: "pending" | "in_progress" | "completed" | "deleted";1875 status?: "pending" | "in_progress" | "completed" | "deleted";


1887**Tool-Name:** `TaskGet`1890**Tool-Name:** `TaskGet`

1888 1891 

1889```typescript theme={null}1892```typescript theme={null}

1890// Noch nicht aus dem SDK exportiert; lokal definieren.

1891type TaskGetInput = {1893type TaskGetInput = {

1892 taskId: string;1894 taskId: string;

1893};1895};


1900**Tool-Name:** `TaskList`1902**Tool-Name:** `TaskList`

1901 1903 

1902```typescript theme={null}1904```typescript theme={null}

1903// Noch nicht aus dem SDK exportiert; lokal definieren.

1904type TaskListInput = {};1905type TaskListInput = {};

1905```1906```

1906 1907 


1983 | MonitorOutput1984 | MonitorOutput

1984 | NotebookEditOutput1985 | NotebookEditOutput

1985 | ReadMcpResourceOutput1986 | ReadMcpResourceOutput

1987 | TaskCreateOutput

1988 | TaskGetOutput

1989 | TaskListOutput

1986 | TaskStopOutput1990 | TaskStopOutput

1991 | TaskUpdateOutput

1987 | TodoWriteOutput1992 | TodoWriteOutput

1988 | WebFetchOutput1993 | WebFetchOutput

1989 | WebSearchOutput;1994 | WebSearchOutput;


2347**Tool-Name:** `TaskCreate`2352**Tool-Name:** `TaskCreate`

2348 2353 

2349```typescript theme={null}2354```typescript theme={null}

2350// Noch nicht aus dem SDK exportiert; lokal definieren.

2351type TaskCreateOutput = {2355type TaskCreateOutput = {

2352 task: {2356 task: {

2353 id: string;2357 id: string;


2363**Tool-Name:** `TaskUpdate`2367**Tool-Name:** `TaskUpdate`

2364 2368 

2365```typescript theme={null}2369```typescript theme={null}

2366// Noch nicht aus dem SDK exportiert; lokal definieren.

2367type TaskUpdateOutput = {2370type TaskUpdateOutput = {

2368 success: boolean;2371 success: boolean;

2369 taskId: string;2372 taskId: string;


2383**Tool-Name:** `TaskGet`2386**Tool-Name:** `TaskGet`

2384 2387 

2385```typescript theme={null}2388```typescript theme={null}

2386// Noch nicht aus dem SDK exportiert; lokal definieren.

2387type TaskGetOutput = {2389type TaskGetOutput = {

2388 task: {2390 task: {

2389 id: string;2391 id: string;


2403**Tool-Name:** `TaskList`2405**Tool-Name:** `TaskList`

2404 2406 

2405```typescript theme={null}2407```typescript theme={null}

2406// Noch nicht aus dem SDK exportiert; lokal definieren.

2407type TaskListOutput = {2408type TaskListOutput = {

2408 tasks: Array<{2409 tasks: Array<{

2409 id: string;2410 id: string;

agent-view.md +172 −56

Details

6 6 

7> Versenden und verwalten Sie viele Claude Code-Sitzungen von einem Bildschirm aus. Die Agenten-Ansicht zeigt, was jede Sitzung tut und welche Ihre Eingabe benötigen.7> Versenden und verwalten Sie viele Claude Code-Sitzungen von einem Bildschirm aus. Die Agenten-Ansicht zeigt, was jede Sitzung tut und welche Ihre Eingabe benötigen.

8 8 

9Die Agenten-Ansicht, die mit `claude agents` geöffnet wird, ist ein Bildschirm für alle Ihre Hintergrund-Sitzungen: was läuft, was Ihre Eingabe benötigt und was erledigt ist. Versenden Sie neue Sitzungen, beobachten Sie ihren Status auf einen Blick, anstatt durch Transkripte zu scrollen, und greifen Sie nur ein, wenn eine Sitzung Sie benötigt. Sitzungen laufen im Hintergrund weiter, ohne dass ein Terminal angeschlossen ist.9Die Agenten-Ansicht, die mit `claude agents` geöffnet wird, ist ein Bildschirm für alle Ihre Hintergrund-Sitzungen: was läuft, was Ihre Eingabe benötigt und was erledigt ist. Versenden Sie neue Sitzungen, beobachten Sie ihren Status auf einen Blick, anstatt durch Transkripte zu scrollen, und greifen Sie nur ein, wenn eine Sitzung Sie benötigt. Jede Hintergrund-Sitzung ist eine vollständige Claude Code-Konversation, die ohne angeschlossenes Terminal weiterläuft, sodass Sie sie jederzeit öffnen, antworten und verlassen können.

10 10 

11Verwenden Sie die Agenten-Ansicht, wenn Sie mehrere unabhängige Aufgaben haben, an denen Claude gleichzeitig arbeiten kann, z. B. das Beheben eines Fehlers, das Überprüfen eines Pull Requests oder das Untersuchen eines Protokolls. Wenn Sie ein Problem zusammen durcharbeiten möchten, hängen Sie sich an eine Sitzung an und verwenden Sie Claude Code interaktiv wie gewohnt.11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="Agenten-Ansicht in einem Terminal: Die Kopfzeile zeigt Claude Code v2.1.140, das Modell, das Arbeitsverzeichnis und eine Zusammenfassung der Anzahl. Sitzungen sind unter 'Benötigt Eingabe', 'Wird ausgeführt' und 'Abgeschlossen' gruppiert, mit einer Versand-Eingabe am unteren Rand und einer Fußzeile mit Tastaturhinweisen." width="1772" height="780" data-path="images/agent-view-light.png" />

12 12 

13Sitzungen in der Agenten-Ansicht laufen unabhängig und berichten nur an Sie. Um mit Subagenten, Agent-Teams und Worktrees zu vergleichen, siehe [Agenten parallel ausführen](/de/agents).13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="Agenten-Ansicht in einem Terminal: Die Kopfzeile zeigt Claude Code v2.1.140, das Modell, das Arbeitsverzeichnis und eine Zusammenfassung der Anzahl. Sitzungen sind unter 'Benötigt Eingabe', 'Wird ausgeführt' und 'Abgeschlossen' gruppiert, mit einer Versand-Eingabe am unteren Rand und einer Fußzeile mit Tastaturhinweisen." width="1772" height="780" data-path="images/agent-view-dark.png" />

14 

15Verwenden Sie die Agenten-Ansicht, wenn Sie mehrere unabhängige Aufgaben haben, an denen Claude ohne Ihre ständige Überwachung arbeiten kann. Versenden Sie eine Fehlerbehebung, eine Pull-Request-Überprüfung und eine Untersuchung eines instabilen Tests als drei Zeilen, arbeiten Sie in einem anderen Fenster weiter und überprüfen Sie später, wenn eine Zeile anzeigt, dass sie Sie benötigt oder ein Ergebnis hat.

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.

18 

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

14 20 

15<Note>21<Note>

16 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, und Administratoren können die Agenten-Ansicht für eine Organisation mit der verwalteten Einstellung [`disableAgentView`](#how-background-sessions-are-hosted) deaktivieren.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.

17</Note>23</Note>

18 24 

19Diese Seite behandelt:25Diese Seite behandelt:

20 26 

21* [Schnellstart](#quick-start)27* [Schnellstart](#quick-start): Geben Sie Claude eine Aufgabe, an der sie im Hintergrund arbeiten kann, überprüfen Sie sie und greifen Sie ein, wenn nötig

22* [Sitzungen mit der Agenten-Ansicht überwachen](#monitor-sessions-with-agent-view), einschließlich Statussymbole, Vorschau und Antwort, Anhängen, Organisieren und Tastaturkürzel28* [Sitzungen mit der Agenten-Ansicht überwachen](#monitor-sessions-with-agent-view), einschließlich Statussymbole, Vorschau und Antwort, Anhängen, Organisieren und Tastaturkürzel

23* [Neue Agenten versenden](#dispatch-new-agents) aus der Agenten-Ansicht, aus einer Sitzung heraus oder aus der Shell29* [Neue Agenten versenden](#dispatch-new-agents) aus der Agenten-Ansicht, aus einer Sitzung heraus oder aus Ihrer Shell

24* [Sitzungen aus der Shell verwalten](#manage-sessions-from-the-shell)30* [Sitzungen aus der Shell verwalten](#manage-sessions-from-the-shell)

25* [Wie Hintergrund-Sitzungen gehostet werden](#how-background-sessions-are-hosted) durch den Supervisor-Prozess31* [Wie Hintergrund-Sitzungen gehostet werden](#how-background-sessions-are-hosted) durch den Supervisor-Prozess

26 32 

27## Schnellstart33## Schnellstart

28 34 

29Diese Anleitung öffnet die Agenten-Ansicht, versendet eine Sitzung, antwortet aus dem Vorschau-Panel und hängt sich für das vollständige Gespräch an.35Diese Anleitung behandelt die Kern-Agenten-Ansicht-Schleife: versenden Sie eine Aufgabe, beobachten Sie, wie ihre Zeile aktualisiert wird, während Claude arbeitet, schauen Sie nach, um sie zu überprüfen und zu antworten, und hängen Sie sich für das vollständige Gespräch an. Die Sitzung, die Sie versenden, läuft weiter, nachdem Sie die Agenten-Ansicht schließen, sodass Sie sie verlassen und später zurückkehren können.

30 36 

31<Steps>37<Steps>

32 <Step title="Agenten-Ansicht öffnen">38 <Step title="Agenten-Ansicht öffnen">


36 claude agents42 claude agents

37 ```43 ```

38 44 

39 Die Agenten-Ansicht öffnet sich mit einer Eingabe am unteren Rand und einer Tabelle, die sich füllt, wenn Sitzungen starten. Drücken Sie jederzeit `Esc`, um zu beenden. Ihre Sitzungen laufen weiter.45 Die Agenten-Ansicht öffnet sich mit einer Eingabe am unteren Rand und einer Tabelle, die sich füllt, wenn Sitzungen starten. Drücken Sie jederzeit `Esc`, um zu Ihrer Shell zurückzukehren. Ihre Sitzungen laufen weiter, während Sie weg sind, und erscheinen erneut, wenn Sie die Agenten-Ansicht das nächste Mal öffnen.

40 </Step>46 </Step>

41 47 

42 <Step title="Eine Sitzung versenden">48 <Step title="Eine Sitzung versenden">

43 Geben Sie eine Eingabeaufforderung in die Eingabe ein und drücken Sie `Enter`. Eine neue Sitzung startet und wird als Zeile angezeigt, die zeigt, ob sie funktioniert, auf Sie wartet oder erledigt ist. Wiederholen Sie dies, um mehrere Sitzungen parallel auszuführen. Jede nutzt Ihr Abonnementkontingent unabhängig, daher lesen Sie [Einschränkungen](#limitations), bevor Sie viele auf einmal versenden.49 Geben Sie eine Eingabeaufforderung ein, die eine Aufgabe beschreibt, und drücken Sie `Enter`. Eine neue Hintergrund-Sitzung startet bei dieser Aufgabe und wird als Zeile angezeigt, die zeigt, ob sie funktioniert, auf Sie wartet oder erledigt ist. Die neue Sitzung verwendet das Modell, das in der Agenten-Ansicht-Kopfzeile angezeigt wird, und denselben [Berechtigungsmodus](#permission-mode-model-and-effort), den Sie erhalten würden, wenn Sie `claude` in diesem Verzeichnis ausführen.

50 

51 Jede Eingabeaufforderung, die Sie hier eingeben, startet ihre eigene neue Sitzung. Wenn Sie eine weitere Eingabeaufforderung eingeben und `Enter` drücken, wird eine zweite Sitzung neben der ersten gestartet, anstatt eine Folgefrage daran zu senden. Sie können auf diese Weise mehrere parallel ausführen.

52 

53 Jede Sitzung nutzt Ihr Abonnementkontingent unabhängig, daher lesen Sie [Einschränkungen](#limitations), bevor Sie viele auf einmal versenden.

44 </Step>54 </Step>

45 55 

46 <Step title="Vorschau und Antwort">56 <Step title="Vorschau und Antwort">

47 Wählen Sie eine Zeile mit den Pfeiltasten aus und drücken Sie `Space`, um zu sehen, was die Sitzung tut oder was sie von Ihnen benötigt. Geben Sie eine Antwort ein und drücken Sie `Enter`, um sie zu senden, ohne die Agenten-Ansicht zu verlassen.57 Wählen Sie eine Zeile mit den Pfeiltasten aus und drücken Sie `Space`, um das Vorschau-Panel zu öffnen. Es zeigt die neueste Ausgabe der Sitzung oder die Frage, auf die sie wartet, anstelle des vollständigen Transkripts. Geben Sie eine Antwort ein und drücken Sie `Enter`, um sie zu senden, ohne die Agenten-Ansicht zu verlassen.

48 </Step>58 </Step>

49 59 

50 <Step title="Anhängen und Abhängen">60 <Step title="Anhängen und Abhängen">

51 Drücken Sie `Enter` oder `→` auf einer Zeile, um sich anzuhängen, wenn Sie das vollständige Gespräch möchten. Die Sitzung übernimmt das Terminal genau so, als hätten Sie `claude` ausgeführt. Drücken Sie `←` auf einer leeren Eingabeaufforderung, um sich abzuhängen und zur Tabelle zurückzukehren.61 Drücken Sie `Enter` oder `→` auf einer Zeile, um sich anzuhängen, wenn Sie das vollständige Gespräch möchten. Die Sitzung übernimmt das Terminal genau so, als hätten Sie `claude` ausgeführt. Drücken Sie `←` auf einer leeren Eingabeaufforderung, um sich abzuhängen und zur Tabelle zurückzukehren.

52 </Step>62 </Step>

53</Steps>

54 63 

55Um eine vorhandene interaktive Sitzung in die Agenten-Ansicht zu bringen, führen Sie `/bg` darin aus, oder drücken Sie `←` auf einer leeren Eingabeaufforderung, um die Sitzung in den Hintergrund zu verschieben und die Agenten-Ansicht in einem Schritt zu öffnen. Die Sitzung läuft im Hintergrund weiter und wird als Zeile angezeigt. Um eine neue Hintergrund-Sitzung direkt aus der Shell zu starten, führen Sie `claude --bg "<prompt>"` aus.64 <Step title="Eine vorhandene Sitzung einbringen">

65 Um eine Sitzung, die Sie bereits offen haben, in die Agenten-Ansicht zu verschieben, führen Sie `/bg` darin aus, oder drücken Sie `←` auf einer leeren Eingabeaufforderung, um sie in den Hintergrund zu verschieben und die Agenten-Ansicht in einem Schritt zu öffnen. Die Sitzung läuft weiter und wird als Zeile neben den Sitzungen angezeigt, die Sie versendet haben.

66 </Step>

67</Steps>

56 68 

57Sie 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.69Sie 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.

58 70 


60 72 

61Fü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 wie lange die letzte Änderung her ist.73Fü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 wie lange die letzte Änderung her ist.

62 74 

63Die Liste umfasst jede Hintergrund-Sitzung unter Ihrem [Konfigurationsverzeichnis](#how-background-sessions-are-hosted), unabhängig davon, in welchem Projekt oder Worktree sie funktioniert, sodass eine Sitzung, die in einem Repository gestartet wurde, und eine andere, die in einem anderen Worktree gestartet wurde, zusammen angezeigt werden. Interaktive Sitzungen, die Sie in anderen Terminals offen haben, werden nicht angezeigt, bis Sie sie [in den Hintergrund verschieben](#from-inside-a-session), und [Subagenten](/de/sub-agents), die in einer Sitzung laufen, werden nicht als separate Zeilen aufgelistet.75Die Liste zeigt 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. Interaktive 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.

76 

77Um die Ansicht auf ein Projekt zu beschränken, starten Sie mit `claude agents --cwd <path>`. Nur Sitzungen, die unter diesem Verzeichnis gestartet wurden, werden angezeigt, einschließlich aller, die in einem [Worktree](/de/worktrees) ausgeführt werden, das von dort aus versandt wurde.

64 78 

65```text theme={null}79```text theme={null}

66Angeheftet80Angeheftet

67 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m81 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m

68 82 

69Bereit zur Überprüfung83Bereit zur Überprüfung

70 ∙ jump physics github.com/anthropics/example/pull/2048 ● 2h84 ∙ jump physics github.com/example/game/pull/2048 ● 2h

71 85 

72Benötigt Eingabe86Benötigt Eingabe

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


82 … 6 more96 … 6 more

83```97```

84 98 

85Das Symbol jeder Zeile trägt zwei Signale. Der Indikator zeigt Ihnen den Status der Sitzung, und die Form des Symbols zeigt Ihnen, ob der zugrunde liegende Prozess noch läuft. Die Status sind:99### Sitzungsstatus lesen

100 

101Jede Zeile beginnt mit einem Symbol, dessen Farbe und Animation den Status der Sitzung anzeigen:

102 

103| Status | Symbol zeigt sich als | Was es bedeutet |

104| :--------------- | :-------------------- | :----------------------------------------------------------------------------- |

105| Funktioniert | Animiert | Claude führt aktiv Tools aus oder generiert eine Antwort |

106| Benötigt Eingabe | Gelb | Claude wartet auf eine bestimmte Frage oder Genehmigungsentscheidung von Ihnen |

107| Untätig | Gedimmt | Die Sitzung hat nichts zu tun und ist bereit für Ihren nächsten Prompt |

108| Abgeschlossen | Grün | Die Aufgabe wurde erfolgreich abgeschlossen |

109| Fehlgeschlagen | Rot | Die Aufgabe endete mit einem Fehler |

110| Gestoppt | Grau | Die Sitzung wurde mit `Ctrl+X` oder `claude stop` gestoppt |

111 

112Separat zeigt die Form des Symbols, ob der zugrunde liegende Prozess läuft:

113 

114| Form | Was es bedeutet |

115| :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------- |

116| `✻` oder animiertes `✽` | Der Sitzungsprozess ist aktiv und antwortet sofort |

117| `∙` | 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 |

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

119 

120Hintergrund-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.

86 121 

87| Indikator | Status | Was es bedeutet |122Der Sitzungsstatus wird auf der Festplatte durch automatische Updates und Supervisor-Neustarts beibehalten. Wenn Ihr Computer in den Ruhezustand wechselt oder heruntergefahren wird, werden laufende Sitzungen gestoppt; starten Sie sie mit `claude respawn --all` neu.

88| :-------- | :--------------- | :-------------------------------------------------------------------------------------------- |

89| Animiert | Funktioniert | Claude führt aktiv Tools aus oder generiert eine Antwort |

90| Gelb | Benötigt Eingabe | Claude wartet auf Ihre Eingabe, normalerweise eine Genehmigungsentscheidung oder eine Antwort |

91| Gedimmt | Untätig | Die Sitzung wartet auf Eingabe, ist aber nicht an einer bestimmten Frage blockiert |

92| Grün | Abgeschlossen | Die Aufgabe wurde erfolgreich abgeschlossen |

93| Rot | Fehlgeschlagen | Die Aufgabe endete mit einem Fehler |

94| Grau | Gestoppt | Die Sitzung wurde mit `Ctrl+X` oder `claude stop` gestoppt |

95 123 

96Die Form des Symbols zeigt, ob der zugrunde liegende Prozess noch läuft. Ein `✻` oder ein animiertes `✽`, während Claude funktioniert, bedeutet, dass die Sitzung aktiv ist und Sie sofort darauf antworten können. Ein `∙` bedeutet, dass der Prozess beendet wurde, aber Sie können immer noch Vorschau anzeigen, antworten oder anhängen: Claude startet die Sitzung von dort neu, wo sie aufgehört hat. Ein `✢` ist eine [`/loop`](/de/commands)-Sitzung, die zwischen Iterationen schläft, wobei die Zeile ihre Laufzahl und einen Countdown zur nächsten Iteration anzeigt.124### Zeilenzusammenfassungen

97 125 

98Hintergrund-Sitzungen benötigen kein offenes Terminal, um weiter zu funktionieren. Ein separater [Supervisor-Prozess](#how-background-sessions-are-hosted) 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.126Die einzeilige Zusammenfassung in jeder Zeile wird von einem [Haiku-Klasse-Modell](/de/model-config) generiert, sodass die Zeile Ihnen zeigen kann, was die Sitzung tut, was sie benötigt oder was sie produziert hat, ohne das Transkript zu öffnen. Während eine Sitzung aktiv funktioniert, wird die Zusammenfassung höchstens alle 15 Sekunden aktualisiert, plus einmal, wenn jede Runde endet.

99 127 

100Sitzungen werden auf der Festplatte beibehalten: Das Schließen Ihres Terminals oder ein automatisches Update verliert sie nicht, und das erneute Öffnen von `claude agents` zeigt sie alle. Wenn Ihr Computer in den Ruhezustand wechselt oder heruntergefahren wird, werden laufende Sitzungen gestoppt; starten Sie sie mit `claude respawn --all` neu.128Jede Aktualisierung ist eine kurze Haiku-Klasse-Anfrage durch Ihren normalen Anbieter, abgerechnet und behandelt unter denselben [Datennutzungsbedingungen](/de/data-usage) wie die Sitzung selbst.

101 129 

102Die einzeilige Zusammenfassung in jeder Zeile wird von Ihrem konfigurierten [Haiku-Klasse-Modell](/de/model-config) generiert, sodass die Zeile Ihnen zeigen kann, was die Sitzung tut, was sie benötigt oder was sie produziert hat, ohne das Transkript zu öffnen. Während eine Sitzung aktiv funktioniert, wird die Zusammenfassung höchstens alle 15 Sekunden aktualisiert, plus einmal, wenn jede Runde endet. Jede Aktualisierung ist eine kurze Haiku-Klasse-Anfrage durch Ihren normalen Anbieter, abgerechnet und behandelt unter denselben [Datennutzungsbedingungen](/de/data-usage) wie die Sitzung selbst.130### Pull-Request-Status

103 131 

104Wenn eine Sitzung einen Pull Request öffnet, wird ein Statusindikator am rechten Rand der Zeile angezeigt, verlinkt zum Pull Request in Terminals, die Hyperlinks unterstützen. Wenn die Sitzung mehr als einen Pull Request geöffnet hat, wird die Anzahl vor dem Indikator angezeigt und die Farbe spiegelt denjenigen wider, der am meisten Aufmerksamkeit benötigt.132Wenn eine Sitzung einen Pull Request öffnet, wird ein Statusindikator am rechten Rand der Zeile angezeigt, verlinkt zum Pull Request in Terminals, die Hyperlinks unterstützen. Wenn die Sitzung mehr als einen Pull Request geöffnet hat, wird die Anzahl vor dem Indikator angezeigt und die Farbe spiegelt denjenigen wider, der am meisten Aufmerksamkeit benötigt.

105 133 


122 150 

123### An eine Sitzung anhängen151### An eine Sitzung anhängen

124 152 

125Drücken Sie `Enter` oder `→` auf einer ausgewählten Zeile, um sich anzuhängen, oder drücken Sie `Alt+1` bis `Alt+9`, um sich direkt an die N-te Sitzung in der fokussierten Gruppe anzuhängen. Die Agenten-Ansicht wird durch die vollständige interaktive Sitzung ersetzt, genau so, als hätten Sie `claude` in diesem Verzeichnis ausgeführt. Wenn Sie sich anhängen, sendet Claude eine kurze Zusammenfassung dessen, was passiert ist, während Sie weg waren.153Drücken Sie `Enter` oder `→` auf einer ausgewählten Zeile, um sich anzuhängen. Die Agenten-Ansicht wird durch die vollständige interaktive Sitzung ersetzt, genau so, als hätten Sie `claude` in diesem Verzeichnis ausgeführt. Wenn Sie sich anhängen, sendet Claude eine kurze Zusammenfassung dessen, was passiert ist, während Sie weg waren.

126 154 

127Während Sie angehängt sind, verhält sich die Sitzung wie jede andere Claude Code-Sitzung: jeder [Befehl](/de/commands), Tastaturkürzel und jede Funktion funktioniert.155Während Sie angehängt sind, verhält sich die Sitzung wie jede andere Claude Code-Sitzung: jeder [Befehl](/de/commands), Tastaturkürzel und jede Funktion funktioniert.

128 156 


134 162 

135### Die Liste organisieren163### Die Liste organisieren

136 164 

137Die Agenten-Ansicht gruppiert Sitzungen nach Status, mit Sitzungen, die Eingabe benötigen, über Sitzungen, die funktionieren oder erledigt sind. Drücken Sie `Ctrl+S`, um stattdessen nach Verzeichnis zu gruppieren. Ihre Wahl wird über Läufe hinweg gespeichert. Heften Sie innerhalb einer Gruppe eine Sitzung mit `Ctrl+T` oben an, ordnen Sie mit `Shift+↑` und `Shift+↓` neu an, oder drücken Sie `Enter` auf einem Gruppenkopf, um ihn zu reduzieren. Um eine Sitzung zu entfernen, drücken Sie `Ctrl+X`, um sie zu stoppen, und `Ctrl+X` erneut innerhalb von zwei Sekunden, um sie zu löschen. Das Drücken von `Ctrl+X` auf einem Gruppenkopf löscht jede Sitzung in dieser Gruppe nach Bestätigung.165Die Agenten-Ansicht gruppiert Sitzungen, sodass diejenigen, die Eingabe benötigen, oben sind, mit `Bereit zur Überprüfung` und `Benötigt Eingabe` über `Funktioniert` und `Abgeschlossen`. Diese Gruppennamen entsprechen nicht eins-zu-eins den [Status](#read-session-state) oben: Eine Sitzung wechselt zu `Bereit zur Überprüfung`, wenn sie einen offenen Pull Request hat, und `Abgeschlossen` sammelt beendete, fehlgeschlagene und gestoppte Sitzungen zusammen. Drücken Sie `Ctrl+S`, um stattdessen nach Verzeichnis zu gruppieren. Ihre Wahl wird über Läufe hinweg gespeichert.

138 166 

139Ältere abgeschlossene Sitzungen werden in eine Zeile „… N more" eingeklappt, um die Liste kurz zu halten. Fehler und Sitzungen mit einem offenen Pull Request bleiben immer sichtbar.167Innerhalb einer Gruppe:

140 168 

141### Die Liste filtern169* Drücken Sie `Ctrl+T`, um eine Sitzung oben anzuheften

170* Drücken Sie `Shift+↑` oder `Shift+↓`, um Sitzungen neu anzuordnen

171* Drücken Sie `Ctrl+R`, um eine Sitzung umzubenennen

172* Drücken Sie `Enter` auf einem Gruppenkopf, um ihn zu reduzieren

173 

174Um eine Sitzung aus der Liste zu entfernen, drücken Sie `Ctrl+X`, um sie zu stoppen, und `Ctrl+X` erneut innerhalb von zwei Sekunden, um sie zu löschen. Das Drücken von `Ctrl+X` auf einem Gruppenkopf löscht jede Sitzung in dieser Gruppe nach Bestätigung.

175 

176Das Löschen entfernt die Sitzung aus der Agenten-Ansicht und bereinigt ihren [Worktree](#how-file-edits-are-isolated), einschließlich aller nicht committeten Änderungen darin, sodass Sie Arbeit, die Sie behalten möchten, vor dem Löschen pushen oder committen sollten. Das Gesprächstranskript bleibt auf der Festplatte und bleibt über `claude --resume` verfügbar.

177 

178Ältere abgeschlossene Sitzungen werden in eine Zeile `… N more` eingeklappt, um die Liste kurz zu halten. Fehler und Sitzungen mit einem offenen Pull Request bleiben immer sichtbar.

179 

180### Sitzungen filtern

142 181 

143Geben Sie in die Versand-Eingabe ein, um zu filtern, anstatt zu versenden:182Geben Sie in die Versand-Eingabe ein, um zu filtern, anstatt zu versenden:

144 183 

145| Filter | Zeigt |184| Filter | Zeigt |

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

147| `a:<name>` | Sitzungen, die den benannten Agenten ausführen |186| `a:<name>` | Sitzungen, die den benannten Agenten ausführen |

148| `s:<state>` | Sitzungen im angegebenen Status, z. B. `s:blocked` für Sitzungen, die Sie benötigen |187| `s:<state>` | Sitzungen im angegebenen Status, z. B. `s:working`. Akzeptiert auch `s:blocked` für alles, das auf Sie wartet |

149| `#<number>` oder eine PR-URL | Die Sitzung, die an diesem Pull Request funktioniert |188| `#<number>` oder eine PR-URL | Die Sitzung, die an diesem Pull Request funktioniert |

150 189 

151### Tastaturkürzel190### Tastaturkürzel

152 191 

153Drücken Sie `?` in der Agenten-Ansicht, um jedes Kürzel zu sehen. Die häufigsten:192Drücken Sie `?` in der Agenten-Ansicht, um jedes Kürzel im Kontext zu sehen. Die folgende Tabelle fasst sie zusammen.

154 193 

155| Kürzel | Aktion |194| Kürzel | Aktion |

156| :-------------------- | :----------------------------------------------------------------------------------------- |195| :-------------------- | :------------------------------------------------------------------------------------------------- |

157| `↑` / `↓` | Zwischen Zeilen verschieben |196| `↑` / `↓` | Zwischen Zeilen verschieben |

158| `Enter` | An die ausgewählte Sitzung anhängen oder versenden, wenn Text in der Eingabe vorhanden ist |197| `Enter` | An die ausgewählte Sitzung anhängen oder versenden, wenn Text in der Eingabe vorhanden ist |

159| `Space` | Vorschau-Panel für die ausgewählte Sitzung öffnen oder schließen |198| `Space` | Vorschau-Panel für die ausgewählte Sitzung öffnen oder schließen |

160| `Shift+Enter` | Versenden und sofort anhängen |199| `Shift+Enter` | Versenden und sofort anhängen |

161| `→` | An die ausgewählte Sitzung anhängen |200| `→` | An die ausgewählte Sitzung anhängen |

162| `Alt+1`..`Alt+9` | An die N-te Sitzung in der fokussierten Gruppe anhängen |201| `Alt+1`..`Alt+9` | An Sitzung 1–9 in der aktuellen Gruppe anhängen |

163| `Tab` | Alle Subagenten durchsuchen oder den hervorgehobenen Vorschlag anwenden |202| `Tab` | Bei leerer Eingabe alle Subagenten durchsuchen. Andernfalls den hervorgehobenen Vorschlag anwenden |

164| `Ctrl+S` | Gruppierung zwischen Status und Verzeichnis wechseln |203| `Ctrl+S` | Gruppierung zwischen Status und Verzeichnis wechseln |

165| `Ctrl+T` | Ausgewählte Sitzung anheften oder abheften |204| `Ctrl+T` | Ausgewählte Sitzung anheften oder abheften |

166| `Ctrl+R` | Ausgewählte Sitzung umbenennen |205| `Ctrl+R` | Ausgewählte Sitzung umbenennen |


177 216 

178### Aus der Agenten-Ansicht217### Aus der Agenten-Ansicht

179 218 

180Geben 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. Fügen Sie ein Bild in die Eingabeaufforderung ein, um einen Screenshot oder ein Diagramm mit der Aufgabe einzubeziehen.219Geben 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.

220 

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

181 222 

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

183 224 


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

191| `Shift+Enter` | Versenden und sofort an die neue Sitzung anhängen |232| `Shift+Enter` | Versenden und sofort an die neue Sitzung anhängen |

192 233 

193Geben Sie `/` ein, um einen [Skill](/de/skills) zu versenden. Das Verpacken einer wiederkehrenden Aufgabe als Skill ermöglicht es Ihnen, denselben Workflow viele Male aus der Agenten-Ansicht zu starten, ohne die Eingabeaufforderung erneut einzugeben. Drücken Sie `Tab` auf einer leeren Eingabe, um jeden versandbaren Subagenten zu durchsuchen, oder um den hervorgehobenen Vorschlag anzuwenden, wenn Vorschläge angezeigt werden.234Das 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.

194 235 

195Wenn derselbe `@name` sowohl einem Subagenten als auch einem gleichgeordneten Repository entspricht, hat der Subagent Vorrang. Die Form ohne `@` am Anfang gilt auch für jeden Subagenten-Namen, sodass eine Eingabeaufforderung, die mit einem Wort beginnt, das einem Ihrer Subagenten-Namen entspricht, diesen Subagenten versendet. Verwenden Sie die `@`-Form, wenn Sie explizit sein möchten.236Wenn 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.

196 237 

197#### In ein bestimmtes Verzeichnis versenden238#### In ein bestimmtes Verzeichnis versenden

198 239 


206 247 

207### Aus einer Sitzung heraus248### Aus einer Sitzung heraus

208 249 

209Führen Sie `/background` oder seinen Alias `/bg` aus, um das aktuelle Gespräch zu trennen und es weiter laufen zu lassen. Übergeben Sie eine Eingabeaufforderung wie `/bg run the test suite and fix any failures`, um eine weitere Anweisung zu senden, bevor Sie sich trennen.250Fü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.

251 

252Das Verschieben aus einer interaktiven Sitzung startet einen neuen Prozess, der aus dem gespeicherten Gespräch fortgesetzt wird, sodass das Ausführen von Subagenten, [Monitoren](/de/tools-reference#monitor-tool) und Hintergrund-Befehlen nicht auf die Sitzung übertragen wird. Claude fordert Sie auf, zu bestätigen, bevor Sie verschieben, wenn einer dieser Befehle ausgeführt wird. Sobald sich die Sitzung im Hintergrund befindet, kann sie neue Subagenten, Monitore und Hintergrund-Befehle starten, und diese werden bei späteren Trennungen und Wiederverbindungen weiterhin ausgeführt.

210 253 

211### Aus der Shell254### Aus der Shell

212 255 


234 277 

235### Wie Dateibearbeitungen isoliert werden278### Wie Dateibearbeitungen isoliert werden

236 279 

237Jede Hintergrund-Sitzung, ob aus der Agenten-Ansicht, `/bg` oder `claude --bg` gestartet, beginnt in Ihrem Arbeitsverzeichnis, wird aber vom Schreiben von Dateien dort blockiert. Wenn die Sitzung Dateien bearbeiten muss, verschiebt Claude sie automatisch in einen isolierten [Git-Worktree](/de/worktrees) unter `.claude/worktrees/`, sodass parallele Sitzungen denselben Checkout lesen können, aber jede in ihren eigenen schreibt. Die Blockade gilt nicht, wenn sich die Sitzung bereits in einem Worktree befindet, wenn das Arbeitsverzeichnis kein Git-Repository ist, oder für Schreibvorgänge außerhalb des Arbeitsverzeichnisses.280Jede 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. Claude überspringt dies, wenn sich die Sitzung bereits unter `.claude/worktrees/` befindet, wenn das Arbeitsverzeichnis kein Git-Repository ist, oder für Schreibvorgänge außerhalb des Arbeitsverzeichnisses.

281 

282Auß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.

238 283 

239Der Worktree wird entfernt, wenn Sie die Sitzung löschen, daher führen Sie die Änderungen zusammen oder pushen Sie sie, die Sie behalten möchten, bevor Sie die Sitzung löschen. Um den Worktree-Pfad einer Sitzung zu finden, schauen Sie sich die Sitzung an oder hängen Sie an und überprüfen Sie ihr Arbeitsverzeichnis.284Der Worktree wird entfernt, wenn Sie die Sitzung löschen, daher führen Sie die Änderungen zusammen oder pushen Sie sie, die Sie behalten möchten, bevor Sie die Sitzung löschen. Um den Worktree-Pfad einer Sitzung zu finden, schauen Sie sich die Sitzung an oder hängen Sie an und überprüfen Sie ihr Arbeitsverzeichnis.

240 285 

241Um einen Subagenten immer in seinem eigenen Worktree auszuführen, unabhängig davon, wie er gestartet wurde, setzen Sie [`isolation: worktree`](/de/sub-agents#supported-frontmatter-fields) in seinem Frontmatter.286Um einen Subagenten immer in seinem eigenen Worktree auszuführen, unabhängig davon, wie er gestartet wurde, setzen Sie [`isolation: worktree`](/de/sub-agents#supported-frontmatter-fields) in seinem Frontmatter.

242 287 

243### Berechtigungsmodus und Einstellungen288### Das Modell festlegen

289 

290Der im Header der Agenten-Ansicht angezeigte Modellname ist der Versand-Standard. Neue Sitzungen, die Sie aus der Eingabe starten, verwenden dieses Modell, das dieselbe Einstellung ist, die [`/model`](/de/model-config) in jeder Sitzung steuert. Um 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).

291 

292Jede Hintergrund-Sitzung kann auf einem anderen Modell ausgeführt werden. Um es für eine Sitzung zu überschreiben:

293 

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

295* Hängen Sie an eine laufende Sitzung an und führen Sie dort `/model` aus. Die Änderung bleibt bestehen, wenn die Sitzung neu gestartet wird.

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

297 

298### Berechtigungsmodus, Modell und Aufwand

299 

300Eine versendete Sitzung liest ihre [Einstellungen](/de/settings) aus dem Verzeichnis, in dem sie läuft, genauso wie wenn Sie `claude` dort gestartet hätten.

301 

302Der [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).

303 

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

244 305 

245Eine versendete Sitzung liest ihre [Einstellungen](/de/settings) und ihren [Berechtigungsmodus](/de/permissions) aus dem Verzeichnis, in dem sie läuft, genauso wie wenn Sie `claude` dort gestartet hätten. Das Versenden aus der Agenten-Ansicht-Eingabe übergibt keinen Berechtigungsmodus, daher 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).306```bash theme={null}

307claude agents --permission-mode plan --model opus --effort high

308```

309 

310<Note>

311 Das Übergeben von `--permission-mode`, `--model` oder `--effort` an `claude agents` erfordert Claude Code v2.1.142 oder später. Frühere Versionen lehnen diese Flags mit einem unknown-option-Fehler ab.

312</Note>

313 

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

315 

316Ohne 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.

246 317 

247Um den Modus aus der Shell zu setzen, übergeben Sie `--permission-mode` mit `claude --bg`. Die Verwendung von `bypassPermissions` oder `auto` auf diese Weise wird abgelehnt, bis Sie diesen Modus akzeptiert haben, indem Sie `claude` einmal interaktiv damit ausführen, da diese Modi eine Sitzung, die Sie nicht beobachten, ohne Genehmigung handeln lassen.318Die Verwendung von `bypassPermissions` oder `auto` wird abgelehnt, bis Sie diesen Modus akzeptiert haben, indem Sie `claude` einmal interaktiv damit ausführen, da diese Modi eine Sitzung, die Sie nicht beobachten, ohne Genehmigung handeln lassen. Dasselbe gilt, ob Sie den Modus an `claude agents` oder an `claude --bg --permission-mode` übergeben.

319 

320### Einstellungen, Plugins und MCP-Server

321 

322Die Agenten-Ansicht akzeptiert dieselben Konfigurationsflags wie `claude` zum Laden von Einstellungen, Plugins, MCP-Servern und zusätzlichen Verzeichnissen. Jedes Flag gilt für die Agenten-Ansicht selbst und wird an jede Sitzung weitergeleitet, die Sie daraus versenden, sodass ein Plugin oder MCP-Server, den Sie auf diese Weise laden, auch in diesen Sitzungen verfügbar ist.

323 

324| Flag | Effekt |

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

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

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

328| [`--plugin-dir <path>`](/de/plugins) | Ein Plugin aus einem lokalen Verzeichnis laden |

329| [`--mcp-config <file-or-json>`](/de/mcp) | MCP-Server aus einer Konfigurationsdatei oder JSON-Zeichenkette laden |

330| `--strict-mcp-config` | Nur die MCP-Server aus `--mcp-config` verwenden, andere MCP-Konfigurationen ignorieren |

331 

332Wiederholen 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.

333 

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

335 

336```bash theme={null}

337claude agents --settings ./ci-settings.json --add-dir ../shared-lib

338```

248 339 

249## Sitzungen aus der Shell verwalten340## Sitzungen aus der Shell verwalten

250 341 

251Jede Hintergrund-Sitzung hat eine kurze ID, die Sie aus der Shell verwenden können. Diese Befehle sind nützlich zum Scripting oder wenn Sie die Agenten-Ansicht nicht öffnen möchten.342Jede Hintergrund-Sitzung hat eine kurze ID, die Sie aus der Shell verwenden können. Die ID wird gedruckt, wenn Sie eine Sitzung mit `claude --bg` starten, und die ID jeder Sitzung ist ihr Verzeichnisname unter `~/.claude/jobs/`. Diese Befehle sind nützlich zum Scripting oder wenn Sie die Agenten-Ansicht nicht öffnen möchten.

252 343 

253| Befehl | Zweck |344| Befehl | Zweck |

254| :--------------------- | :----------------------------------------------------------- |345| :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------- |

255| `claude agents` | Agenten-Ansicht öffnen |346| `claude agents` | Agenten-Ansicht öffnen. Übergeben Sie `--cwd <path>`, um nur Sitzungen aufzulisten, die unter diesem Verzeichnis gestartet wurden |

256| `claude attach <id>` | An eine Sitzung in diesem Terminal anhängen |347| `claude attach <id>` | An eine Sitzung in diesem Terminal anhängen |

257| `claude logs <id>` | Neueste Ausgabe der Sitzung drucken |348| `claude logs <id>` | Neueste Ausgabe der Sitzung drucken |

258| `claude stop <id>` | Eine Sitzung stoppen. Akzeptiert auch `claude kill` |349| `claude stop <id>` | Eine Sitzung stoppen. Akzeptiert auch `claude kill` |

259| `claude respawn <id>` | Eine gestoppte Sitzung mit ihrem Gespräch intakt neu starten |350| `claude respawn <id>` | Eine gestoppte Sitzung mit ihrem Gespräch intakt neu starten |

260| `claude respawn --all` | Jede gestoppte Sitzung neu starten |351| `claude respawn --all` | Jede gestoppte Sitzung neu starten |

261| `claude rm <id>` | Eine Sitzung aus der Liste entfernen |352| `claude rm <id>` | Eine Sitzung aus der Liste entfernen. Bereinigt ihr worktree, wenn es keine nicht committeten Änderungen gibt |

262 353 

263## Wie Hintergrund-Sitzungen gehostet werden354## Wie Hintergrund-Sitzungen gehostet werden

264 355 

265Hintergrund-Sitzungen werden von einem Supervisor-Prozess pro Benutzer gehostet, getrennt von Ihrem Terminal und von der Agenten-Ansicht. Es startet automatisch, wenn Sie zum ersten Mal eine Sitzung in den Hintergrund verschieben oder die Agenten-Ansicht öffnen, und Sie verwalten es nicht direkt. Der Supervisor und seine Sitzungen authentifizieren sich mit denselben Anmeldedaten wie Ihre interaktiven Sitzungen und stellen keine zusätzlichen Netzwerkverbindungen über die Modell-API hinaus her.356Jede Sitzung, die in der Agenten-Ansicht aufgelistet ist, wird als Hintergrund-Sitzung betrachtet, unabhängig davon, ob Sie derzeit daran angehängt sind oder nicht. Im Gegensatz dazu ist eine Sitzung, die durch direktes Ausführen von `claude` gestartet wird, an dieses Terminal gebunden und endet, wenn es geschlossen wird, es sei denn, Sie [senden sie in den Hintergrund](#from-inside-a-session).

357 

358### Der Supervisor-Prozess

359 

360Hintergrund-Sitzungen werden von einem Supervisor-Prozess pro Benutzer gehostet, getrennt von Ihrem Terminal und von der Agenten-Ansicht. Der Supervisor startet automatisch, wenn Sie zum ersten Mal eine Sitzung in den Hintergrund verschieben oder die Agenten-Ansicht öffnen, und Sie verwalten ihn nicht direkt.

361 

362Der Supervisor und seine Sitzungen authentifizieren sich mit denselben Anmeldedaten wie Ihre interaktiven Sitzungen und stellen keine zusätzlichen Netzwerkverbindungen über die Modell-API hinaus her.

266 363 

267Jede Hintergrund-Sitzung ist ihr eigener Claude Code-Prozess, übergeordnet zum Supervisor anstelle zu Ihrem Terminal. Eine Sitzung, die aktiv funktioniert, auf Ihre Eingabe wartet oder ein Terminal angehängt hat, behält ihren Prozess am Laufen. Sobald eine Sitzung fertig ist und etwa eine Stunde lang unverbunden sitzt, stoppt der Supervisor seinen Prozess, um Ressourcen freizugeben. Das Transkript und der Status bleiben auf der Festplatte, und das nächste Mal, wenn Sie anhängen, Vorschau anzeigen oder antworten, startet der Supervisor einen frischen Prozess von dort, wo er aufgehört hat. Wenn jede Sitzung fertig ist und kein Terminal verbunden ist, beendet sich der Supervisor selbst und startet erneut, wenn Sie das nächste Mal eine Sitzung in den Hintergrund verschieben oder die Agenten-Ansicht öffnen.364Jede Hintergrund-Sitzung ist ihr eigener Claude Code-Prozess, der vom Supervisor verwaltet wird, anstatt an Ihr Terminal gebunden zu sein. Eine Sitzung, die aktiv funktioniert, auf Ihre Eingabe wartet oder ein Terminal angehängt hat, behält ihren Prozess am Laufen.

365 

366Sobald eine Sitzung fertig ist und etwa eine Stunde lang unverbunden sitzt, stoppt der Supervisor ihren Prozess, um Ressourcen freizugeben. Das Transkript und der Status bleiben auf der Festplatte, und das nächste Mal, wenn Sie anhängen, Vorschau anzeigen oder antworten, startet der Supervisor einen frischen Prozess von dort, wo er aufgehört hat. Wenn jede Sitzung fertig ist und kein Terminal verbunden ist, beendet sich der Supervisor selbst und startet erneut, wenn Sie das nächste Mal eine Sitzung benötigen.

268 367 

269Der 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.368Der 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.

270 369 

370### Wo der Status gespeichert ist

371 

271Der 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.372Der 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.

272 373 

273| Pfad | Inhalt |374| Pfad | Inhalt |


276| `~/.claude/daemon/roster.json` | Liste der laufenden Hintergrund-Sitzungen, verwendet zum Wiederherstellen der Verbindung nach einem Neustart |377| `~/.claude/daemon/roster.json` | Liste der laufenden Hintergrund-Sitzungen, verwendet zum Wiederherstellen der Verbindung nach einem Neustart |

277| `~/.claude/jobs/<id>/state.json` | Pro-Sitzungs-Status in der Agenten-Ansicht angezeigt |378| `~/.claude/jobs/<id>/state.json` | Pro-Sitzungs-Status in der Agenten-Ansicht angezeigt |

278 379 

380### Agenten-Ansicht ausschalten

381 

279Um 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.382Um 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.

280 383 

281## Fehlerbehebung384## Fehlerbehebung

282 385 

386### `claude agents` listet Subagenten auf, anstatt die Agenten-Ansicht zu öffnen

387 

388Wenn `claude agents` eine Anzahl gefolgt von Ihren konfigurierten Subagenten ausgibt und dann beendet wird, ist die Agenten-Ansicht in Ihrer Umgebung nicht verfügbar. Frühere Versionen öffneten die Agenten-Ansicht nicht in jeder Umgebung, einschließlich bei Verbindung über Bedrock, Vertex AI oder Foundry. Führen Sie `claude update` aus, um die neueste Version zu installieren.

389 

390Wenn die Agenten-Ansicht nach dem Update immer noch nicht geöffnet wird, überprüfen Sie, ob sie durch eine Einstellung oder Umgebungsvariable [deaktiviert](#turn-off-agent-view) wurde.

391 

283### Agenten-Ansicht öffnet sich ohne Sitzungen392### Agenten-Ansicht öffnet sich ohne Sitzungen

284 393 

285Die Agenten-Ansicht ist leer, bis Sie Ihre erste Sitzung versenden. Geben Sie eine Eingabeaufforderung in die Eingabe am unteren Rand ein und drücken Sie `Enter`.394Die Agenten-Ansicht ist leer, bis Sie Ihre erste Sitzung versenden. Geben Sie eine Eingabeaufforderung in die Eingabe am unteren Rand ein und drücken Sie `Enter`.

286 395 

396### Agenten können nicht geöffnet werden, da Hintergrundaufgaben ausgeführt werden

397 

398Wenn das Drücken von `←` zum Hintergrund der aktuellen Sitzung `Cannot open agents — N background task(s) running` anzeigt, hat die Sitzung laufende Arbeiten wie einen Subagenten, einen Workflow oder einen Hintergrund-Shell-Befehl, und die Verknüpfung wird sie nicht stillschweigend aufgeben. Führen Sie `/tasks` aus, um zu sehen, was ausgeführt wird, dann `/bg`, um das Aufgeben zu bestätigen. Siehe [Aus einer Sitzung heraus](#from-inside-a-session), um zu sehen, was übertragen wird und was nicht, wenn Sie in den Hintergrund gehen.

399 

400### Eingabeaufforderung als zu kurz abgelehnt

401 

402Die Versand-Eingabe erwartet eine Aufgabenbeschreibung, keine Gesprächseröffnung. Eine Eingabeaufforderung, die kürzer als vier Zeichen ist, wird mit einem `Too short`-Hinweis abgelehnt, damit ein versehentlicher Tastendruck keine Sitzung startet. Beschreiben Sie, was die Sitzung tun soll, z. B. `investigate the flaky checkout test`.

403 

287### Sitzungen werden nach dem Aufwachen Ihres Computers als gestoppt angezeigt404### Sitzungen werden nach dem Aufwachen Ihres Computers als gestoppt angezeigt

288 405 

289Hintergrund-Sitzungen überstehen Ruhezustand oder Herunterfahren nicht. Hängen Sie sich an, zeigen Sie Vorschau an oder antworten Sie auf eine gestoppte Sitzung und sie startet von dort neu, wo sie aufgehört hat. Um alle auf einmal neu zu starten, führen Sie `claude respawn --all` aus.406Hintergrund-Sitzungen überstehen Ruhezustand oder Herunterfahren nicht. Hängen Sie sich an, zeigen Sie Vorschau an oder antworten Sie auf eine gestoppte Sitzung und sie startet von dort neu, wo sie aufgehört hat. Um alle auf einmal neu zu starten, führen Sie `claude respawn --all` aus.


298 415 

299## Einschränkungen416## Einschränkungen

300 417 

301Die Agenten-Ansicht ist eine Forschungsvorschau. Aktuelle Einschränkungen, die Sie beachten sollten:418Die Agenten-Ansicht ist eine Forschungsvorschau mit den folgenden Einschränkungen:

302 419 

303* **Ratenlimits gelten**: Hintergrund-Sitzungen verbrauchen Ihre Abonnementnutzung genauso wie interaktive Sitzungen, daher verwendet das Ausführen von zehn Agenten parallel die Quote zehnmal schneller.420* **Ratenlimits gelten**: Hintergrund-Sitzungen verbrauchen Ihre Abonnementnutzung genauso wie interaktive Sitzungen, daher verwendet das Ausführen von zehn Agenten parallel die Quote ungefähr zehnmal schneller.

304* **Sitzungen sind lokal**: Hintergrund-Sitzungen laufen auf Ihrem Computer und stoppen, wenn er in den Ruhezustand wechselt oder heruntergefahren wird.421* **Sitzungen sind lokal**: Hintergrund-Sitzungen laufen auf Ihrem Computer und stoppen, wenn er in den Ruhezustand wechselt oder heruntergefahren wird.

305* **Worktrees werden mit der Sitzung gelöscht**: Führen Sie Änderungen zusammen oder pushen Sie sie, bevor Sie eine Sitzung löschen, die Dateien in ihrem eigenen Worktree bearbeitet hat.422* **Worktrees werden mit der Sitzung gelöscht**: Führen Sie Änderungen zusammen oder pushen Sie sie, bevor Sie eine Sitzung löschen, die Dateien in ihrem eigenen Worktree bearbeitet hat.

306 423 

307## Nächste Schritte424## Verwandte Ressourcen

308 425 

309Nachdem Sie die Agenten-Ansicht verstanden haben, erkunden Sie diese verwandten Funktionen:426Weitere Möglichkeiten zum parallelen Ausführen von Claude finden Sie unter:

310 427 

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

312* [Subagenten](/de/sub-agents): Definieren Sie wiederverwendbare Agentenkonfigurationen mit benutzerdefinierten Eingabeaufforderungen, Tools und Isolation

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

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

Details

170 170 

171Claude 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).171Claude 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).

172 172 

173Wenn Claude Code erkennt, dass Ihre AWS-Anmeldedaten abgelaufen sind (entweder lokal basierend auf ihrem Zeitstempel oder wenn Bedrock einen Anmeldedatenfehler zurückgibt), führt es automatisch Ihre konfigurierten `awsAuthRefresh`- und/oder `awsCredentialExport`-Befehle aus, um neue Anmeldedaten zu erhalten, bevor die Anfrage erneut versucht wird.173Diese zwei Einstellungen haben unterschiedliche Auslösebedingungen:

174 

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

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

174 177 

175##### Beispielkonfiguration178##### Beispielkonfiguration

176 179 


187 190 

188**`awsAuthRefresh`**: Verwenden Sie dies für Befehle, die das `.aws`-Verzeichnis ändern, z. B. zum Aktualisieren von Anmeldedaten, SSO-Cache oder Konfigurationsdateien. Die Ausgabe des Befehls wird dem Benutzer angezeigt, aber interaktive Eingaben werden nicht unterstützt. Dies funktioniert gut für browserbasierte SSO-Flows, bei denen die CLI eine URL oder einen Code anzeigt und Sie die Authentifizierung im Browser abschließen.191**`awsAuthRefresh`**: Verwenden Sie dies für Befehle, die das `.aws`-Verzeichnis ändern, z. B. zum Aktualisieren von Anmeldedaten, SSO-Cache oder Konfigurationsdateien. Die Ausgabe des Befehls wird dem Benutzer angezeigt, aber interaktive Eingaben werden nicht unterstützt. Dies funktioniert gut für browserbasierte SSO-Flows, bei denen die CLI eine URL oder einen Code anzeigt und Sie die Authentifizierung im Browser abschließen.

189 192 

190**`awsCredentialExport`**: Verwenden Sie dies nur, wenn Sie das `.aws`-Verzeichnis nicht ändern können und Anmeldedaten direkt zurückgeben müssen. Die Ausgabe wird stillschweigend erfasst und nicht dem Benutzer angezeigt. Der Befehl muss JSON in diesem Format ausgeben:193**`awsCredentialExport`**: Verwenden Sie dies nur, wenn Sie das `.aws`-Verzeichnis nicht ändern können und Anmeldedaten direkt zurückgeben müssen. Dieser Befehl wird ausgeführt, wenn Anmeldedaten aktualisiert werden müssen, nicht nur wenn Anmeldedaten abgelaufen sind. Die Ausgabe wird stillschweigend erfasst und nicht dem Benutzer angezeigt. Der Befehl muss JSON in diesem Format ausgeben:

191 194 

192```json theme={null}195```json theme={null}

193{196{

best-practices.md +20 −26

Details

52 Trennen Sie Forschung und Planung von der Implementierung, um zu vermeiden, das falsche Problem zu lösen.52 Trennen Sie Forschung und Planung von der Implementierung, um zu vermeiden, das falsche Problem zu lösen.

53</Tip>53</Tip>

54 54 

55Wenn Claude direkt zum Codieren springt, kann dies zu Code führen, der das falsche Problem löst. Verwenden Sie [Plan Mode](/de/common-workflows#use-plan-mode-for-safe-code-analysis), um Erkundung von Ausführung zu trennen.55Wenn Claude direkt zum Codieren springt, kann dies zu Code führen, der das falsche Problem löst. Verwenden Sie [Plan Mode](/de/permission-modes#analyze-before-you-edit-with-plan-mode), um Erkundung von Ausführung zu trennen.

56 56 

57Der empfohlene Workflow hat vier Phasen:57Der empfohlene Workflow hat vier Phasen:

58 58 


60 <Step title="Erkunden">60 <Step title="Erkunden">

61 Geben Sie Plan Mode ein. Claude liest Dateien und beantwortet Fragen, ohne Änderungen vorzunehmen.61 Geben Sie Plan Mode ein. Claude liest Dateien und beantwortet Fragen, ohne Änderungen vorzunehmen.

62 62 

63 ```txt claude (Plan Mode) theme={null}63 ```txt claude (plan mode) theme={null}

64 read /src/auth and understand how we handle sessions and login.64 read /src/auth and understand how we handle sessions and login.

65 also look at how we manage environment variables for secrets.65 also look at how we manage environment variables for secrets.

66 ```66 ```


69 <Step title="Planen">69 <Step title="Planen">

70 Bitten Sie Claude, einen detaillierten Implementierungsplan zu erstellen.70 Bitten Sie Claude, einen detaillierten Implementierungsplan zu erstellen.

71 71 

72 ```txt claude (Plan Mode) theme={null}72 ```txt claude (plan mode) theme={null}

73 I want to add Google OAuth. What files need to change?73 I want to add Google OAuth. What files need to change?

74 What's the session flow? Create a plan.74 What's the session flow? Create a plan.

75 ```75 ```


78 </Step>78 </Step>

79 79 

80 <Step title="Implementieren">80 <Step title="Implementieren">

81 Wechseln Sie zurück zum Normal Mode und lassen Sie Claude codieren, wobei Sie gegen seinen Plan überprüfen.81 Wechseln Sie aus Plan Mode und lassen Sie Claude codieren, wobei Sie gegen seinen Plan überprüfen.

82 82 

83 ```txt claude (Normal Mode) theme={null}83 ```txt claude (default mode) theme={null}

84 implement the OAuth flow from your plan. write tests for the84 implement the OAuth flow from your plan. write tests for the

85 callback handler, run the test suite and fix any failures.85 callback handler, run the test suite and fix any failures.

86 ```86 ```


89 <Step title="Commit">89 <Step title="Commit">

90 Bitten Sie Claude, mit einer aussagekräftigen Nachricht zu committen und einen PR zu erstellen.90 Bitten Sie Claude, mit einer aussagekräftigen Nachricht zu committen und einen PR zu erstellen.

91 91 

92 ```txt claude (Normal Mode) theme={null}92 ```txt claude (default mode) theme={null}

93 commit with a descriptive message and open a PR93 commit with a descriptive message and open a PR

94 ```94 ```

95 </Step>95 </Step>


396* Verwenden Sie `/clear` häufig zwischen Aufgaben, um das Kontextfenster vollständig zurückzusetzen396* Verwenden Sie `/clear` häufig zwischen Aufgaben, um das Kontextfenster vollständig zurückzusetzen

397* Wenn die automatische Komprimierung ausgelöst wird, fasst Claude zusammen, was am wichtigsten ist, einschließlich Code-Muster, Dateizustände und wichtige Entscheidungen397* Wenn die automatische Komprimierung ausgelöst wird, fasst Claude zusammen, was am wichtigsten ist, einschließlich Code-Muster, Dateizustände und wichtige Entscheidungen

398* Für mehr Kontrolle führen Sie `/compact <instructions>` aus, wie `/compact Focus on the API changes`398* Für mehr Kontrolle führen Sie `/compact <instructions>` aus, wie `/compact Focus on the API changes`

399* Um nur einen Teil der Konversation zu komprimieren, verwenden Sie `Esc + Esc` oder `/rewind`, wählen Sie einen Nachricht-Checkpoint und wählen Sie **Summarize from here**. Dies verdichtet Nachrichten von diesem Punkt an, während der frühere Kontext erhalten bleibt.399* Um nur einen Teil der Konversation zu komprimieren, verwenden Sie `Esc + Esc` oder `/rewind`, wählen Sie einen Nachricht-Checkpoint und wählen Sie **Summarize from here** oder **Summarize up to here**. Das erste verdichtet Nachrichten von diesem Punkt an, während der frühere Kontext erhalten bleibt; das zweite verdichtet frühere Nachrichten, während neuere vollständig erhalten bleiben. Siehe [Restore vs. summarize](/de/checkpointing#restore-vs-summarize).

400* Passen Sie das Komprimierungsverhalten in CLAUDE.md mit Anweisungen wie `When compacting, always preserve the full list of modified files and any test commands"` an, um sicherzustellen, dass kritischer Kontext die Zusammenfassung überlebt400* Passen Sie das Komprimierungsverhalten in CLAUDE.md mit Anweisungen wie `"When compacting, always preserve the full list of modified files and any test commands"` an, um sicherzustellen, dass kritischer Kontext die Zusammenfassung überlebt

401* Für schnelle Fragen, die nicht im Kontext bleiben müssen, verwenden Sie [`/btw`](/de/interactive-mode#side-questions-with-%2Fbtw). Die Antwort erscheint in einer verwerfbaren Überlagerung und gelangt niemals in die Konversationshistorie, sodass Sie ein Detail überprüfen können, ohne den Kontext zu vergrößern.401* Für schnelle Fragen, die nicht im Kontext bleiben müssen, verwenden Sie [`/btw`](/de/interactive-mode#side-questions-with-%2Fbtw). Die Antwort erscheint in einer verwerfbaren Überlagerung und gelangt niemals in die Konversationshistorie, sodass Sie ein Detail überprüfen können, ohne den Kontext zu vergrößern.

402 402 

403### Verwenden Sie Subagents für Untersuchungen403### Verwenden Sie Subagents für Untersuchungen

404 404 

405<Tip>405<Tip>

406 Delegieren Sie Forschung mit `use subagents to investigate X"`. Sie erkunden in einem separaten Kontext und halten Ihre Hauptkonversation sauber für die Implementierung.406 Delegieren Sie Forschung mit `"use subagents to investigate X"`. Sie erkunden in einem separaten Kontext und halten Ihre Hauptkonversation sauber für die Implementierung.

407</Tip>407</Tip>

408 408 

409Da der Kontext Ihre grundlegende Einschränkung ist, sind Subagents eines der mächtigsten verfügbaren Tools. Wenn Claude eine Codebase erforscht, liest er viele Dateien, die alle Ihren Kontext verbrauchen. Subagents laufen in separaten Kontextfenstern und berichten Zusammenfassungen zurück:409Da der Kontext Ihre grundlegende Einschränkung ist, sind Subagents eines der mächtigsten verfügbaren Tools. Wenn Claude eine Codebase erforscht, liest er viele Dateien, die alle Ihren Kontext verbrauchen. Subagents laufen in separaten Kontextfenstern und berichten Zusammenfassungen zurück:


424### Rewind mit Checkpoints424### Rewind mit Checkpoints

425 425 

426<Tip>426<Tip>

427 Jede Aktion, die Claude macht, erstellt einen Checkpoint. Sie können Konversation, Code oder beides zu jedem vorherigen Checkpoint wiederherstellen.427 Jeder Prompt, den Sie senden, erstellt einen Checkpoint. Sie können Konversation, Code oder beides zu jedem vorherigen Checkpoint wiederherstellen.

428</Tip>428</Tip>

429 429 

430Claude erstellt automatisch Checkpoints vor Änderungen. Doppeltippen Sie auf `Escape` oder führen Sie `/rewind` aus, um das Rewind-Menü zu öffnen. Sie können nur Konversation wiederherstellen, nur Code wiederherstellen, beides wiederherstellen oder eine ausgewählte Nachricht zusammenfassen. Siehe [Checkpointing](/de/checkpointing) für Details.430Claude erstellt automatisch Snapshots von Dateien vor jeder Änderung, sodass ein Checkpoint diese wiederherstellen kann. Doppeltippen Sie auf `Escape` oder führen Sie `/rewind` aus, um das Rewind-Menü zu öffnen. Sie können nur Konversation wiederherstellen, nur Code wiederherstellen, beides wiederherstellen oder eine ausgewählte Nachricht zusammenfassen. Siehe [Checkpointing](/de/checkpointing) für Details.

431 431 

432Anstatt jeden Schritt sorgfältig zu planen, können Sie Claude bitten, etwas Riskantes zu versuchen. Wenn es nicht funktioniert, rewind und versuchen Sie einen anderen Ansatz. Checkpoints bleiben über Sessions hinweg erhalten, sodass Sie Ihr Terminal schließen und später immer noch rewind können.432Anstatt jeden Schritt sorgfältig zu planen, können Sie Claude bitten, etwas Riskantes zu versuchen. Wenn es nicht funktioniert, rewind und versuchen Sie einen anderen Ansatz. Checkpoints bleiben über Sessions hinweg erhalten, sodass Sie Ihr Terminal schließen und später immer noch rewind können.

433 433 


438### Setzen Sie Konversationen fort438### Setzen Sie Konversationen fort

439 439 

440<Tip>440<Tip>

441 Führen Sie `claude --continue` aus, um dort weiterzumachen, wo Sie aufgehört haben, oder `--resume`, um aus aktuellen Sessions auszuwählen.441 Benennen Sie Sessions mit `/rename` und behandeln Sie sie wie Branches: jeder Workstream erhält seinen eigenen persistenten Kontext.

442</Tip>442</Tip>

443 443 

444Claude Code speichert Konversationen lokal. Wenn sich eine Aufgabe über mehrere Sessions erstreckt, müssen Sie den Kontext nicht erneut erklären:444Claude Code speichert Konversationen lokal, sodass Sie den Kontext nicht erneut erklären müssen, wenn sich eine Aufgabe über mehrere Sitzungen erstreckt. Führen Sie `claude --continue` aus, um die letzte Session fortzusetzen, oder `claude --resume`, um aus einer Liste auszuwählen. Geben Sie Sessions aussagekräftige Namen wie `oauth-migration`, damit Sie sie später finden können. Siehe [Manage sessions](/de/sessions) für den vollständigen Satz von Resume-, Branch- und Benennungskontrollen.

445 

446```bash theme={null}

447claude --continue # Resume the most recent conversation

448claude --resume # Select from recent conversations

449```

450 

451Verwenden Sie `/rename`, um Sessions aussagekräftige Namen wie `„oauth-migration"` oder `„debugging-memory-leak"` zu geben, damit Sie sie später finden können. Behandeln Sie Sessions wie Branches: verschiedene Workstreams können separate, persistente Kontexte haben.

452 445 

453***446***

454 447 


464 Verwenden Sie `claude -p "prompt"` in CI, Pre-Commit-Hooks oder Skripten. Fügen Sie `--output-format stream-json` für Streaming-JSON-Ausgabe hinzu.457 Verwenden Sie `claude -p "prompt"` in CI, Pre-Commit-Hooks oder Skripten. Fügen Sie `--output-format stream-json` für Streaming-JSON-Ausgabe hinzu.

465</Tip>458</Tip>

466 459 

467Mit `claude -p "your prompt"` können Sie Claude nicht-interaktiv ohne eine Session ausführen. Der nicht-interaktive Modus ist, wie Sie Claude in CI-Pipelines, Pre-Commit-Hooks oder jeden automatisierten Workflow integrieren. Die Ausgabeformate ermöglichen es Ihnen, Ergebnisse programmgesteuert zu analysieren: Klartext, JSON oder Streaming-JSON.460Mit `claude -p "your prompt"` können Sie Claude nicht-interaktiv ohne eine Session ausführen. [Nicht-interaktiver Modus](/de/headless) ist, wie Sie Claude in CI-Pipelines, Pre-Commit-Hooks oder jeden automatisierten Workflow integrieren. Die Ausgabeformate ermöglichen es Ihnen, Ergebnisse programmgesteuert zu analysieren: Klartext, JSON oder Streaming-JSON.

468 461 

469```bash theme={null}462```bash theme={null}

470# One-off queries463# One-off queries


483 Führen Sie mehrere Claude-Sessions parallel aus, um die Entwicklung zu beschleunigen, isolierte Experimente auszuführen oder komplexe Workflows zu starten.476 Führen Sie mehrere Claude-Sessions parallel aus, um die Entwicklung zu beschleunigen, isolierte Experimente auszuführen oder komplexe Workflows zu starten.

484</Tip>477</Tip>

485 478 

486Es gibt drei Hauptmöglichkeiten, parallele Sessions auszuführen:479Wählen Sie den parallelen Ansatz, der zu dem Grad der Koordination passt, den Sie selbst durchführen möchten:

487 480 

488* [Claude Code Desktop-App](/de/desktop#work-in-parallel-with-sessions): Verwalten Sie mehrere lokale Sessions visuell. Jede Session erhält ihren eigenen isolierten Worktree.481* [Worktrees](/de/worktrees): Führen Sie separate CLI-Sessions in isolierten Git-Checkouts aus, damit Änderungen nicht kollidieren

489* [Claude Code im Web](/de/claude-code-on-the-web): Führen Sie auf der sicheren Cloud-Infrastruktur von Anthropic in isolierten VMs aus.482* [Desktop-App](/de/desktop#work-in-parallel-with-sessions): Verwalten Sie mehrere lokale Sessions visuell, jede in ihrem eigenen Worktree

490* [Agent Teams](/de/agent-teams): Automatisierte Koordination mehrerer Sessions mit gemeinsamen Aufgaben, Messaging und einem Team Lead.483* [Claude Code im Web](/de/claude-code-on-the-web): Führen Sie Sessions auf der von Anthropic verwalteten Cloud-Infrastruktur in isolierten VMs aus

484* [Agent Teams](/de/agent-teams): Automatisierte Koordination mehrerer Sessions mit gemeinsamen Aufgaben, Messaging und einem Team Lead

491 485 

492Über die Parallelisierung von Arbeit hinaus ermöglichen mehrere Sessions qualitätsorientierte Workflows. Ein frischer Kontext verbessert die Code-Überprüfung, da Claude nicht durch Code, den es gerade geschrieben hat, voreingenommen ist.486Über die Parallelisierung von Arbeit hinaus ermöglichen mehrere Sessions qualitätsorientierte Workflows. Ein frischer Kontext verbessert die Code-Überprüfung, da Claude nicht durch Code, den es gerade geschrieben hat, voreingenommen ist.

493 487 


499| | `Review the rate limiter implementation in @src/middleware/rateLimiter.ts. Look for edge cases, race conditions, and consistency with our existing middleware patterns.` |493| | `Review the rate limiter implementation in @src/middleware/rateLimiter.ts. Look for edge cases, race conditions, and consistency with our existing middleware patterns.` |

500| `Here's the review feedback: [Session B output]. Address these issues.` | |494| `Here's the review feedback: [Session B output]. Address these issues.` | |

501 495 

502Sie können etwas Ähnliches mit Tests tun: lassen Sie einen Claude Tests schreiben, dann schreiben Sie einen anderen Code, um sie zu bestehen.496Sie können etwas Ähnliches mit Tests tun: Lassen Sie einen Claude Tests schreiben, dann schreiben Sie einen anderen Code, um sie zu bestehen.

503 497 

504### Fan Out über Dateien498### Fan Out über Dateien

505 499 

checkpointing.md +10 −10

Details

28* **Konversation wiederherstellen**: Zurückspulen zu dieser Nachricht, während der aktuelle Code beibehalten wird28* **Konversation wiederherstellen**: Zurückspulen zu dieser Nachricht, während der aktuelle Code beibehalten wird

29* **Code wiederherstellen**: Dateiänderungen rückgängig machen, während die Konversation beibehalten wird29* **Code wiederherstellen**: Dateiänderungen rückgängig machen, während die Konversation beibehalten wird

30* **Von hier aus zusammenfassen**: Komprimieren Sie die Konversation von diesem Punkt an in eine Zusammenfassung und geben Sie Kontextfensterplatz frei30* **Von hier aus zusammenfassen**: Komprimieren Sie die Konversation von diesem Punkt an in eine Zusammenfassung und geben Sie Kontextfensterplatz frei

31* **Abbrechen**: Kehren Sie zur Nachrichtenliste zurück, ohne Änderungen vorzunehmen31* **Nie Sinn**: Kehren Sie zur Nachrichtenliste zurück, ohne Änderungen vorzunehmen

32 32 

33Nach dem Wiederherstellen der Konversation oder dem Zusammenfassen wird die ursprüngliche Eingabe aus der ausgewählten Nachricht in das Eingabefeld wiederhergestellt, sodass Sie sie erneut senden oder bearbeiten können.33Nach dem Wiederherstellen der Konversation oder dem Auswählen von „Von hier aus zusammenfassen" wird die ursprüngliche Eingabe aus der ausgewählten Nachricht in das Eingabefeld wiederhergestellt, sodass Sie sie erneut senden oder bearbeiten können.

34 

35Das Auswählen von „Bis hier zusammenfassen" hinterlässt Sie am Ende der Konversation mit leerem Eingabefeld.

34 36 

35#### Wiederherstellen vs. zusammenfassen37#### Wiederherstellen vs. zusammenfassen

36 38 

37Die drei Wiederherstellungsoptionen setzen den Zustand zurück: Sie machen Code-Änderungen, Konversationsverlauf oder beides rückgängig. „Von hier aus zusammenfassen" funktioniert anders:39Die Wiederherstellungsoptionen setzen den Zustand zurück: Sie machen Code-Änderungen, Konversationsverlauf oder beides rückgängig. Die Zusammenfassungsoptionen komprimieren einen Teil der Konversation in eine KI-generierte Zusammenfassung, ohne Dateien auf der Festplatte zu ändern:

38 40 

39* Nachrichten vor der ausgewählten Nachricht bleiben intakt41* **Von hier aus zusammenfassen**: Nachrichten vor der ausgewählten Nachricht bleiben intakt. Die ausgewählte Nachricht und alles danach werden durch eine Zusammenfassung ersetzt. Verwenden Sie dies, um eine Nebendiskussion zu verwerfen, während Sie frühen Kontext in vollem Detail behalten.

40* Die ausgewählte Nachricht und alle nachfolgenden Nachrichten werden durch eine kompakte KI-generierte Zusammenfassung ersetzt42* **Bis hier zusammenfassen**: Nachrichten vor der ausgewählten Nachricht werden durch eine Zusammenfassung ersetzt. Die ausgewählte Nachricht und alles danach bleiben intakt, und Sie bleiben am Ende der Konversation. Verwenden Sie dies, um frühe Setup-Diskussionen zu komprimieren, während Sie aktuelle Arbeit in vollem Detail behalten.

41* Keine Dateien auf der Festplatte werden geändert

42* Die ursprünglichen Nachrichten bleiben im Sitzungstranskript erhalten, sodass Claude die Details bei Bedarf referenzieren kann

43 43 

44Dies ähnelt `/compact`, ist aber gezielt: Anstatt die gesamte Konversation zusammenzufassen, behalten Sie frühen Kontext in vollem Detail und komprimieren nur die Teile, die Platz verbrauchen. Sie können optionale Anweisungen eingeben, um zu lenken, worauf sich die Zusammenfassung konzentriert.44In 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.

45 45 

46<Note>46<Note>

47 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/how-claude-code-works#resume-or-fork-sessions) (`claude --continue --fork-session`).47 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`).

48</Note>48</Note>

49 49 

50## Häufige Anwendungsfälle50## Häufige Anwendungsfälle


85## Siehe auch85## Siehe auch

86 86 

87* [Interaktiver Modus](/de/interactive-mode) - Tastaturkürzel und Sitzungssteuerungen87* [Interaktiver Modus](/de/interactive-mode) - Tastaturkürzel und Sitzungssteuerungen

88* [Integrierte Befehle](/de/commands) - Zugriff auf Checkpoints mit `/rewind`88* [Befehle](/de/commands) - Zugriff auf Checkpoints mit `/rewind`

89* [CLI-Referenz](/de/cli-reference) - Befehlszeilenoptionen89* [CLI-Referenz](/de/cli-reference) - Befehlszeilenoptionen

Details

782 782 

783### Remote Control-Sitzung abgelaufen oder Zugriff verweigert783### Remote Control-Sitzung abgelaufen oder Zugriff verweigert

784 784 

785`--teleport` verbindet sich über die gleiche Remote Control-Sitzungsinfrastruktur, die Cloud-Sitzungen verwenden, daher werden Authentifizierungs- und Sitzungs-Ablauf-Fehler mit Remote Control-Wording angezeigt. Sie können `Remote Control session has expired` oder `Access denied` sehen. Das Verbindungs-Token ist kurzlebig und auf Ihr Konto begrenzt.785`--teleport` verbindet sich über die gleiche Remote Control-Sitzungsinfrastruktur, die Cloud-Sitzungen verwenden, daher werden Authentifizierungs- und Sitzungs-Ablauf-Fehler mit Remote Control-Wording angezeigt. Sie können `Remote Control session expired` oder `Access denied` sehen. Das Verbindungs-Token ist kurzlebig und auf Ihr Konto begrenzt.

786 786 

787* Führen Sie `/login` lokal aus, um Ihre Anmeldedaten zu aktualisieren, und verbinden Sie sich dann erneut787* Führen Sie `/login` lokal aus, um Ihre Anmeldedaten zu aktualisieren, und verbinden Sie sich dann erneut

788* Bestätigen Sie, dass Sie sich bei demselben Konto angemeldet haben, das die Sitzung besitzt788* Bestätigen Sie, dass Sie sich bei demselben Konto angemeldet haben, das die Sitzung besitzt

Details

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

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

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

27| `claude agents` | Öffnen Sie die [Agent-Ansicht](/de/agent-view), um parallele Hintergrundsitzungen zu überwachen und zu versenden. Wenn die Ausgabe weitergeleitet wird, werden stattdessen konfigurierte [Subagenten](/de/sub-agents) aufgelistet | `claude agents` |27| `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 | `claude agents` |

28| `claude attach <id>` | Verbinden Sie sich mit einer [Hintergrundsitzung](/de/agent-view#manage-sessions-from-the-shell) in diesem Terminal | `claude attach 7c5dcf5d` |28| `claude attach <id>` | Verbinden Sie sich mit einer [Hintergrundsitzung](/de/agent-view#manage-sessions-from-the-shell) in diesem Terminal | `claude attach 7c5dcf5d` |

29| `claude auto-mode defaults` | Drucken Sie die integrierten [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) Klassifiziererregeln als JSON. Verwenden Sie `claude auto-mode config`, um Ihre effektive Konfiguration mit angewendeten Einstellungen anzuzeigen | `claude auto-mode defaults > rules.json` |29| `claude auto-mode defaults` | Drucken Sie die integrierten [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) Klassifiziererregeln als JSON. Verwenden Sie `claude auto-mode config`, um Ihre effektive Konfiguration mit angewendeten Einstellungen anzuzeigen | `claude auto-mode defaults > rules.json` |

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

commands.md +1 −1

Details

26 26 

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

28 28 

29**Wenn etwas schief geht.** `/rewind` setzt Code und Gespräch zu einem Checkpoint zurück. `/doctor` und `/debug` diagnostizieren Installations- und Laufzeitprobleme, und `/feedback` meldet einen Fehler mit Sitzungskontext an.29**Wenn etwas schief geht.** `/rewind` setzt Code und Gespräch zu einem Checkpoint zurück, oder fasst einen Teil des Gesprächs zusammen. `/doctor` und `/debug` diagnostizieren Installations- und Laufzeitprobleme, und `/feedback` meldet einen Fehler mit Sitzungskontext an.

30 30 

31## Alle Befehle31## Alle Befehle

32 32 

desktop.md +5 −2

Details

148 148 

149### Führen Sie Befehle im Terminal aus149### Führen Sie Befehle im Terminal aus

150 150 

151Das integrierte Terminal ermöglicht es Ihnen, Befehle neben Ihrer Sitzung auszuführen, ohne zu einer anderen App zu wechseln. Öffnen Sie es aus dem Menü **Ansichten** oder drücken Sie **Ctrl+\`** auf macOS oder Windows. Das Terminal öffnet sich im Arbeitsverzeichnis Ihrer Sitzung und teilt die gleiche Umgebung wie Claude, sodass Befehle wie `npm test` oder `git status` die gleichen Dateien sehen, die Claude bearbeitet. Das Terminal ist nur in lokalen Sitzungen verfügbar.151Das integrierte Terminal ermöglicht es Ihnen, Befehle neben Ihrer Sitzung auszuführen, ohne zu einer anderen App zu wechseln. Öffnen Sie es aus dem Menü **Ansichten** oder drücken Sie **Ctrl+\`** auf macOS oder Windows. Das Terminal öffnet sich im Arbeitsverzeichnis Ihrer Sitzung und teilt die gleiche Umgebung wie Claude, sodass Befehle wie `npm test` oder `git status` die gleichen Dateien sehen, die Claude bearbeitet. Um eine zweite Terminal-Registerkarte zu öffnen, klicken Sie auf **+** in der Terminal-Pane-Kopfzeile oder klicken Sie mit der rechten Maustaste auf einen Ordner im Chat, um **Im Terminal öffnen** zu wählen. Das Terminal ist nur in lokalen Sitzungen verfügbar.

152 152 

153### Öffnen und bearbeiten Sie Dateien153### Öffnen und bearbeiten Sie Dateien

154 154 


296 296 

297Verwenden 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.297Verwenden 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.

298 298 

299Die Desktop-App sendet eine Betriebssystem-Benachrichtigung, wenn eine Code-Sitzung eine Aufgabe abschließt und Sie diese Sitzung gerade nicht anzeigen.

300 

299### Fragen Sie eine Seitenfrage, ohne die Sitzung zu entgleisen301### Fragen Sie eine Seitenfrage, ohne die Sitzung zu entgleisen

300 302 

301Ein Seitenchat ermöglicht es Ihnen, Claude eine Frage zu stellen, die den Kontext Ihrer Sitzung nutzt, aber nichts zum Hauptgespräch hinzufügt. Verwenden Sie ihn, wenn Sie ein Stück Code verstehen, eine Annahme überprüfen oder eine Idee erkunden möchten, ohne die Sitzung vom Kurs abzubringen.303Ein Seitenchat ermöglicht es Ihnen, Claude eine Frage zu stellen, die den Kontext Ihrer Sitzung nutzt, aber nichts zum Hauptgespräch hinzufügt. Verwenden Sie ihn, wenn Sie ein Stück Code verstehen, eine Annahme überprüfen oder eine Idee erkunden möchten, ohne die Sitzung vom Kurs abzubringen.


598Verwaltete Einstellungen überschreiben Projekt- und Benutzereinstellungen und gelten, wenn Desktop CLI-Sitzungen startet. Sie können diese Schlüssel in der [verwalteten Einstellungsdatei](/de/settings#settings-precedence) Ihrer Organisation oder remote über die Admin-Konsole festlegen.600Verwaltete Einstellungen überschreiben Projekt- und Benutzereinstellungen und gelten, wenn Desktop CLI-Sitzungen startet. Sie können diese Schlüssel in der [verwalteten Einstellungsdatei](/de/settings#settings-precedence) Ihrer Organisation oder remote über die Admin-Konsole festlegen.

599 601 

600| Schlüssel | Beschreibung |602| Schlüssel | Beschreibung |

601| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |603| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

602| `permissions.disableBypassPermissionsMode` | auf `"disable"` setzen, um Benutzer daran zu hindern, den Bypass-Berechtigungsmodus zu aktivieren. |604| `permissions.disableBypassPermissionsMode` | auf `"disable"` setzen, um Benutzer daran zu hindern, den Bypass-Berechtigungsmodus zu aktivieren. |

603| `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. |605| `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. |

604| `autoMode` | passen Sie an, was der Auto-Modus-Klassifizierer über Ihre Organisation vertraut und blockiert. Siehe [Auto-Modus konfigurieren](/de/auto-mode-config). |606| `autoMode` | passen Sie an, was der Auto-Modus-Klassifizierer über Ihre Organisation vertraut und blockiert. Siehe [Auto-Modus konfigurieren](/de/auto-mode-config). |

605| `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. |607| `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. |

606| `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. |608| `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. |

609| `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. |

607 610 

608Eine verwaltete Einstellungsdatei, die auf jedem Computer auf der Festplatte bereitgestellt wird, gilt für Desktop-Sitzungen. Verwaltete Einstellungen, die remote über die Admin-Konsole hochgeladen werden, erreichen derzeit nur CLI- und IDE-Sitzungen. Für Desktop-Bereitstellungen verteilen Sie die Datei daher über MDM oder verwenden Sie die [Admin-Konsolen-Steuerelemente](#admin-console-controls) oben.611Eine verwaltete Einstellungsdatei, die auf jedem Computer auf der Festplatte bereitgestellt wird, gilt für Desktop-Sitzungen. Verwaltete Einstellungen, die remote über die Admin-Konsole hochgeladen werden, erreichen derzeit nur CLI- und IDE-Sitzungen. Für Desktop-Bereitstellungen verteilen Sie die Datei daher über MDM oder verwenden Sie die [Admin-Konsolen-Steuerelemente](#admin-console-controls) oben.

609 612 

desktop-scheduled-tasks.md +106 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Wiederkehrende Aufgaben in Claude Code Desktop planen

6 

7> Richten Sie geplante Aufgaben in Claude Code Desktop ein, um Claude automatisch in regelmäßigen Abständen für tägliche Code-Reviews, Abhängigkeitsprüfungen oder morgendliche Briefings auszuführen.

8 

9Geplante Aufgaben starten automatisch eine neue Sitzung zu einem von Ihnen gewählten Zeitpunkt und in einer von Ihnen gewählten Häufigkeit. Verwenden Sie sie für wiederkehrende Arbeiten wie tägliche Code-Reviews, Überprüfungen von Abhängigkeitsaktualisierungen oder morgendliche Briefings, die Informationen aus Ihrem Kalender und Ihrer Inbox abrufen.

10 

11Die Seite **Routinen** der Desktop-App ermöglicht es Ihnen, sowohl lokale geplante Aufgaben als auch Remote-[Routinen](/de/routines) zu erstellen. Eine lokale Aufgabe wird auf Ihrem Computer mit direktem Zugriff auf Ihre Dateien und Tools ausgeführt, wird aber nur ausgelöst, wenn die App offen ist und Ihr Computer aktiv ist. Eine Remote-Routine wird auf der von Anthropic verwalteten Cloud-Infrastruktur ausgeführt, auch wenn Ihr Computer ausgeschaltet ist, und kann auch durch API-Aufrufe oder GitHub-Ereignisse ausgelöst werden. Diese Seite behandelt lokale geplante Aufgaben. Informationen zu Remote-Routinen und deren Trigger-Optionen finden Sie unter [Routinen](/de/routines).

12 

13## Planungsoptionen vergleichen

14 

15Claude Code offers three ways to schedule recurring or one-off work:

16 

17| | [Cloud](/en/routines) | [Desktop](/en/desktop-scheduled-tasks) | [`/loop`](/en/scheduled-tasks) |

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

19| Runs on | Anthropic cloud | Your machine | Your machine |

20| Requires machine on | No | Yes | Yes |

21| Requires open session | No | No | Yes |

22| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |

23| Access to local files | No (fresh clone) | Yes | Yes |

24| MCP servers | Connectors configured per task | [Config files](/en/mcp) and connectors | Inherits from session |

25| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |

26| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |

27| Minimum interval | 1 hour | 1 minute | 1 minute |

28 

29<Tip>

30 Use **cloud tasks** for work that should run reliably without your machine. Use **Desktop tasks** when you need access to local files and tools. Use **`/loop`** for quick polling during a session.

31</Tip>

32 

33<Note>

34 Standardmäßig werden geplante Aufgaben für den aktuellen Zustand Ihres Arbeitsverzeichnisses ausgeführt, einschließlich nicht committeter Änderungen. Aktivieren Sie den Worktree-Schalter beim Erstellen der Aufgabe, um jeder Ausführung ihren eigenen isolierten Git-Worktree zu geben, auf die gleiche Weise wie [parallele Sitzungen](/de/desktop#work-in-parallel-with-sessions) funktionieren.

35</Note>

36 

37## Erstellen Sie eine geplante Aufgabe

38 

39Klicken Sie auf **Routinen** in der Seitenleiste und dann auf **Neue Routine** und wählen Sie **Lokal**. Konfigurieren Sie diese Felder:

40 

41| Feld | Beschreibung |

42| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

43| Name | Bezeichner für die Aufgabe. Wird in Kleinbuchstaben Kebab-Case konvertiert und als Ordnername auf der Festplatte verwendet. Muss eindeutig über alle Ihre Aufgaben hinweg sein. |

44| Beschreibung | Kurze Zusammenfassung, die in der Aufgabenliste angezeigt wird. |

45| Anweisungen | Was Claude tun soll, wenn die Aufgabe ausgeführt wird. Schreiben Sie dies auf die gleiche Weise wie jede Nachricht im Eingabefeld. Die Eingabe für Anweisungen enthält Picker für den Berechtigungsmodus und das Modell, und darunter wählen Sie den Arbeitsordner und ob die Ausführung in einem isolierten Worktree erfolgen soll. |

46| Zeitplan | Wie oft die Aufgabe ausgeführt wird. Siehe [Planungsoptionen](#schedule-options) unten. |

47 

48Ein Ordner ist erforderlich, bevor Sie die Aufgabe speichern können. Wenn Sie diesen Ordner noch nicht vertraut haben, fordert Desktop Sie auf, ihn zu vertrauen, bevor Sie speichern.

49 

50Sie können auch eine Aufgabe erstellen, indem Sie in einer beliebigen Sitzung beschreiben, was Sie möchten. Zum Beispiel erstellt „Richten Sie ein tägliches Code-Review ein, das jeden Morgen um 9 Uhr ausgeführt wird" eine wiederkehrende Aufgabe, und „Erinnern Sie mich morgen um 15 Uhr, die Bereitstellung zu überprüfen" erstellt eine einmalige Aufgabe, die sich nach der Ausführung selbst deaktiviert.

51 

52## Planungsoptionen

53 

54Wählen Sie eine Voreinstellung aus dem Zeitplan-Steuerelement:

55 

56* **Manuell**: kein Zeitplan, wird nur ausgeführt, wenn Sie auf **Jetzt ausführen** klicken. Nützlich zum Speichern einer Eingabeaufforderung, die Sie bei Bedarf auslösen

57* **Stündlich**: wird jede Stunde ausgeführt

58* **Täglich**: zeigt eine Zeitauswahl an, Standard ist 9:00 Uhr Ortszeit

59* **Wochentage**: wie täglich, aber überspringt Samstag und Sonntag

60* **Wöchentlich**: zeigt eine Zeitauswahl und eine Tagesauswahl an

61 

62Für Intervalle, die die Auswahl nicht bietet, z. B. alle 15 Minuten, am ersten des Monats oder eine einzelne Ausführung zu einem bestimmten zukünftigen Zeitpunkt, bitten Sie Claude in einer beliebigen Desktop-Sitzung, den Zeitplan festzulegen. Verwenden Sie einfache Sprache; zum Beispiel „Planen Sie eine Aufgabe, um alle Tests alle 6 Stunden auszuführen."

63 

64## Wie geplante Aufgaben ausgeführt werden

65 

66Geplante Aufgaben werden auf Ihrem Computer ausgeführt. Desktop überprüft den Zeitplan jede Minute, während die App offen ist, und startet eine neue Sitzung, wenn eine Aufgabe fällig ist, unabhängig von manuellen Sitzungen, die Sie offen haben. Jede Aufgabe erhält eine kleine Verzögerung von einigen Minuten nach der geplanten Zeit, um den API-Verkehr zu staffeln. Die Verzögerung ist deterministisch: die gleiche Aufgabe startet immer mit dem gleichen Offset.

67 

68Wenn eine Aufgabe ausgelöst wird, erhalten Sie eine Desktop-Benachrichtigung und eine neue Sitzung wird unter einem Abschnitt **Geplant** in der Seitenleiste angezeigt. Öffnen Sie sie, um zu sehen, was Claude getan hat, Änderungen zu überprüfen oder auf Berechtigungsaufforderungen zu reagieren. Die Sitzung funktioniert wie jede andere: Claude kann Dateien bearbeiten, Befehle ausführen, Commits erstellen und Pull Requests öffnen.

69 

70Aufgaben werden nur ausgeführt, während die Desktop-App ausgeführt wird und Ihr Computer aktiv ist. Wenn Ihr Computer durch eine geplante Zeit schläft, wird die Ausführung übersprungen. Um Ruhezustand zu verhindern, aktivieren Sie **Computer aktiv halten** in den Einstellungen unter **Desktop-App → Allgemein**. Das Schließen des Laptop-Deckels versetzt ihn dennoch in den Ruhezustand. Für Aufgaben, die auch ausgeführt werden müssen, wenn Ihr Computer ausgeschaltet ist, oder die durch einen API-Aufruf oder ein GitHub-Ereignis ausgelöst werden sollen, erstellen Sie stattdessen eine Remote-[Routine](/de/routines).

71 

72## Verpasste Ausführungen

73 

74Wenn die App startet oder Ihr Computer aufwacht, überprüft Desktop, ob jede Aufgabe in den letzten sieben Tagen Ausführungen verpasst hat. Wenn ja, startet Desktop genau eine Nachholausführung für die zuletzt verpasste Zeit und verwirft alles Ältere. Eine tägliche Aufgabe, die sechs Tage verpasst hat, wird einmal beim Aufwachen ausgeführt. Desktop zeigt eine Benachrichtigung an, wenn eine Nachholausführung startet.

75 

76Beachten Sie dies beim Schreiben von Eingabeaufforderungen. Eine Aufgabe, die für 9 Uhr geplant ist, könnte um 23 Uhr ausgeführt werden, wenn Ihr Computer den ganzen Tag über im Ruhezustand war. Wenn das Timing wichtig ist, fügen Sie Schutzmaßnahmen zur Eingabeaufforderung selbst hinzu, zum Beispiel: „Überprüfen Sie nur die heutigen Commits. Wenn es nach 17 Uhr ist, überspringen Sie die Überprüfung und posten Sie einfach eine Zusammenfassung dessen, was verpasst wurde."

77 

78## Berechtigungen für geplante Aufgaben

79 

80Jede Aufgabe hat ihren eigenen Berechtigungsmodus, den Sie beim Erstellen oder Bearbeiten der Aufgabe festlegen. Zulassungsregeln aus `~/.claude/settings.json` gelten auch für geplante Aufgabensitzungen. Wenn eine Aufgabe im Ask-Modus ausgeführt wird und ein Tool ausführen muss, für das sie keine Berechtigung hat, bleibt die Ausführung stehen, bis Sie sie genehmigen. Die Sitzung bleibt in der Seitenleiste offen, damit Sie später antworten können.

81 

82Um Stalls zu vermeiden, klicken Sie nach dem Erstellen einer Aufgabe auf **Jetzt ausführen**, achten Sie auf Berechtigungsaufforderungen und wählen Sie für jede „immer zulassen". Zukünftige Ausführungen dieser Aufgabe genehmigen automatisch die gleichen Tools ohne Aufforderung. Sie können diese Genehmigungen auf der Detailseite der Aufgabe überprüfen und widerrufen.

83 

84## Verwalten Sie geplante Aufgaben

85 

86Klicken Sie auf eine Aufgabe in der Liste **Routinen**, um ihre Detailseite zu öffnen. Von hier aus können Sie:

87 

88* **Jetzt ausführen**: Starten Sie die Aufgabe sofort, ohne auf die nächste geplante Zeit zu warten

89* **Status**: Umschalten zwischen Aktiv und Pausiert, um geplante Ausführungen zu pausieren oder fortzusetzen, ohne die Aufgabe zu löschen

90* **Bearbeiten**: Ändern Sie die Anweisungen, den Zeitplan, den Ordner oder andere Einstellungen

91* **Verlauf überprüfen**: Sehen Sie jede vergangene Ausführung, einschließlich übersprungener Ausführungen. Bewegen Sie den Mauszeiger über einen übersprungenen Eintrag, um zu sehen, warum: Ihr Computer war im Ruhezustand, die vorherige Ausführung war noch in Bearbeitung, oder andere geplante Aufgaben wurden bereits ausgeführt. Klicken Sie auf **Mehr anzeigen**, um ältere Einträge zu laden.

92* **Zulässige Berechtigungen überprüfen**: Sehen Sie und widerrufen Sie gespeicherte Tool-Genehmigungen für diese Aufgabe aus dem Bereich **Immer zulässig**

93* **Löschen**: Entfernen Sie die Aufgabe und archivieren Sie alle Sitzungen, die sie erstellt hat. Ein Kontrollkästchen **Auch Dateien auf der Festplatte löschen** wird im Bestätigungsdialog angezeigt. Aktivieren Sie es, um auch die Datei `SKILL.md` der Aufgabe und zugehörige Daten aus `~/.claude/scheduled-tasks/` zu entfernen.

94 

95Sie können Aufgaben auch auflisten, erstellen, bearbeiten und pausieren, indem Sie Claude in einer beliebigen Desktop-Sitzung bitten. Zum Beispiel „Pausieren Sie meine Aufgabe zur Abhängigkeitsprüfung" oder „Zeigen Sie mir meine geplanten Aufgaben." Um eine Aufgabe zu löschen, verwenden Sie die Schaltfläche **Löschen** auf ihrer Detailseite.

96 

97Eine geplante Aufgabe kann auch ihren eigenen Zeitplan oder ihre Eingabeaufforderung innerhalb einer laufenden Sitzung mit dem MCP-Tool `update_scheduled_task` ändern. Dies ermöglicht es einer Aufgabe, sich selbst neu zu planen, basierend auf dem, was sie findet, zum Beispiel das Umplanen eines Code-Reviews, um früher ausgeführt zu werden, wenn es einen Release-Branch erkennt.

98 

99Um die Eingabeaufforderung einer Aufgabe auf der Festplatte zu bearbeiten, öffnen Sie `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (oder unter [`CLAUDE_CONFIG_DIR`](/de/env-vars), falls gesetzt). Die Datei verwendet YAML-Frontmatter für `name` und `description`, mit der Eingabeaufforderung als Text. Änderungen werden bei der nächsten Ausführung wirksam. Zeitplan, Ordner, Modell und aktivierter Status befinden sich nicht in dieser Datei: Ändern Sie sie über das Bearbeitungsformular oder bitten Sie Claude.

100 

101## Verwandte Ressourcen

102 

103* [Routinen](/de/routines): Führen Sie Aufgaben auf der von Anthropic verwalteten Infrastruktur nach einem Zeitplan, über einen API-Aufruf oder als Reaktion auf GitHub-Ereignisse aus, auch wenn Ihr Computer ausgeschaltet ist

104* [Eingabeaufforderungen nach einem Zeitplan ausführen](/de/scheduled-tasks): Sitzungsbezogene Planung mit `/loop` in der CLI

105* [Claude Code GitHub Actions](/de/github-actions): Führen Sie Claude nach einem Zeitplan in CI statt auf Ihrem Computer aus

106* [Verwenden Sie Claude Code Desktop](/de/desktop): Das vollständige Desktop-App-Handbuch

env-vars.md +2 −0

Details

45| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | AWS-Region für das Haiku-Klasse-Modell bei Verwendung von Bedrock oder Bedrock Mantle überschreiben |45| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | AWS-Region für das Haiku-Klasse-Modell bei Verwendung von Bedrock oder Bedrock Mantle überschreiben |

46| `ANTHROPIC_VERTEX_BASE_URL` | Überschreiben Sie die Vertex AI-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Vertex-Endpunkte oder beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Siehe [Google Vertex AI](/de/google-vertex-ai) |46| `ANTHROPIC_VERTEX_BASE_URL` | Überschreiben Sie die Vertex AI-Endpunkt-URL. Verwenden Sie für benutzerdefinierte Vertex-Endpunkte oder beim Routing durch ein [LLM-Gateway](/de/llm-gateway). Siehe [Google Vertex AI](/de/google-vertex-ai) |

47| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP-Projekt-ID für Vertex AI-Anfragen. Wird überschrieben durch `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` oder das Projekt in Ihrer `GOOGLE_APPLICATION_CREDENTIALS`-Anmeldedatei. Siehe [Google Vertex AI](/de/google-vertex-ai) |47| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP-Projekt-ID für Vertex AI-Anfragen. Wird überschrieben durch `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` oder das Projekt in Ihrer `GOOGLE_APPLICATION_CREDENTIALS`-Anmeldedatei. Siehe [Google Vertex AI](/de/google-vertex-ai) |

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

48| `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 |49| `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 |

49| `AWS_BEARER_TOKEN_BEDROCK` | Bedrock API-Schlüssel für Authentifizierung (siehe [Bedrock API-Schlüssel](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |50| `AWS_BEARER_TOKEN_BEDROCK` | Bedrock API-Schlüssel für Authentifizierung (siehe [Bedrock API-Schlüssel](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

50| `BASH_DEFAULT_TIMEOUT_MS` | Standard-Timeout für lang laufende Bash-Befehle (Standard: 120000 oder 2 Minuten) |51| `BASH_DEFAULT_TIMEOUT_MS` | Standard-Timeout für lang laufende Bash-Befehle (Standard: 120000 oder 2 Minuten) |


138| `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` |139| `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` |

139| `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) |140| `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) |

140| `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) |141| `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) |

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

141| `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) |143| `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) |

142| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Wird von Host-Plattformen gesetzt, die Claude Code einbetten und das Modell-Provider-Routing in ihrem Namen verwalten. Wenn gesetzt, werden Provider-Auswahl-, Endpunkt- und Authentifizierungsvariablen wie `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` und `ANTHROPIC_API_KEY` in Einstellungsdateien ignoriert, sodass Benutzereinstellungen das Routing des Hosts nicht überschreiben können. Die automatische Telemetrie-Abmeldung für Bedrock, Vertex und Foundry wird ebenfalls übersprungen, sodass die Telemetrie der Standard-`DISABLE_TELEMETRY`-Abmeldung folgt. Siehe [Standardverhalten nach API-Provider](/de/data-usage#default-behaviors-by-api-provider) |144| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Wird von Host-Plattformen gesetzt, die Claude Code einbetten und das Modell-Provider-Routing in ihrem Namen verwalten. Wenn gesetzt, werden Provider-Auswahl-, Endpunkt- und Authentifizierungsvariablen wie `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` und `ANTHROPIC_API_KEY` in Einstellungsdateien ignoriert, sodass Benutzereinstellungen das Routing des Hosts nicht überschreiben können. Die automatische Telemetrie-Abmeldung für Bedrock, Vertex und Foundry wird ebenfalls übersprungen, sodass die Telemetrie der Standard-`DISABLE_TELEMETRY`-Abmeldung folgt. Siehe [Standardverhalten nach API-Provider](/de/data-usage#default-behaviors-by-api-provider) |

143| `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 |145| `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 |

Details

156 156 

157### Verwendung von skills157### Verwendung von skills

158 158 

159Der `prompt`-Input akzeptiert eine [skill](/de/skills)-Invokation sowie einfachen Text:

160 

161* Für einen skill in Ihrem Repository-Verzeichnis `.claude/skills/` führen Sie `actions/checkout` vor dem Action-Schritt aus und übergeben Sie `/skill-name`.

162* Für einen skill, der in einem Plugin verpackt ist, installieren Sie das Plugin mit den Inputs `plugin_marketplaces` und `plugins` und übergeben Sie den namespaced `/plugin-name:skill-name`.

163 

164Der folgende Workflow installiert das `code-review`-Plugin und führt seinen skill bei jedem neuen oder aktualisierten Pull Request aus:

165 

159```yaml theme={null}166```yaml theme={null}

160name: Code Review167name: Code Review

161on:168on:


168 - uses: anthropics/claude-code-action@v1175 - uses: anthropics/claude-code-action@v1

169 with:176 with:

170 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}177 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

171 prompt: "Review this pull request for code quality, correctness, and security. Analyze the diff, then post your findings as review comments."178 plugin_marketplaces: "https://github.com/anthropics/claude-code.git"

172 claude_args: "--max-turns 5"179 plugins: "code-review@claude-code-plugins"

180 prompt: "/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"

173```181```

174 182 

175### Benutzerdefinierte Automatisierung mit Prompts183### Benutzerdefinierte Automatisierung mit Prompts


622Die Claude Code Action v1 verwendet eine vereinfachte Konfiguration:630Die Claude Code Action v1 verwendet eine vereinfachte Konfiguration:

623 631 

624| Parameter | Beschreibung | Erforderlich |632| Parameter | Beschreibung | Erforderlich |

625| ------------------- | ------------------------------------------------------------------- | ------------ |633| --------------------- | ---------------------------------------------------------------------------------- | ------------ |

626| `prompt` | Anweisungen für Claude (Klartext oder ein [skill](/de/skills)-Name) | Nein\* |634| `prompt` | Anweisungen für Claude (Klartext oder ein [skill](/de/skills)-Name) | Nein\* |

627| `claude_args` | CLI-Argumente, die an Claude Code übergeben werden | Nein |635| `claude_args` | CLI-Argumente, die an Claude Code übergeben werden | Nein |

636| `plugin_marketplaces` | Zeilenumbruch-getrennte Liste von Plugin-Marketplace-Git-URLs | Nein |

637| `plugins` | Zeilenumbruch-getrennte Liste von Plugin-Namen zur Installation vor der Ausführung | Nein |

628| `anthropic_api_key` | Claude API-Schlüssel | Ja\*\* |638| `anthropic_api_key` | Claude API-Schlüssel | Ja\*\* |

629| `github_token` | GitHub-Token für API-Zugriff | Nein |639| `github_token` | GitHub-Token für API-Zugriff | Nein |

630| `trigger_phrase` | Benutzerdefinierte Trigger-Phrase (Standard: "@claude") | Nein |640| `trigger_phrase` | Benutzerdefinierte Trigger-Phrase (Standard: "@claude") | Nein |

glossary.md +1 −1

Details

70 70 

71### Checkpoint71### Checkpoint

72 72 

73Ein automatischer Snapshot Ihres Codes, der vor jeder Bearbeitung durch Claude erfasst wird. Drücken Sie `Esc` zweimal oder führen Sie `/rewind` aus, um Code, Konversation oder beides auf einen früheren Punkt zurückzusetzen. Checkpoints sind lokal für die Sitzung, getrennt von Git, und verfolgen keine Änderungen, die durch das Bash-Tool vorgenommen wurden.73Ein Wiederherstellungspunkt, der bei jedem Prompt erstellt wird, den Sie senden. Claude Code erstellt Snapshots von Dateien vor jeder Bearbeitung, damit ein Checkpoint diese zurücksetzen kann. Drücken Sie `Esc` zweimal oder führen Sie `/rewind` aus, um Code, Konversation oder beides auf einen früheren Punkt zurückzusetzen, oder um einen Teil der Konversation aus einer ausgewählten Nachricht zusammenzufassen. Checkpoints sind lokal für die Sitzung, getrennt von Git, und verfolgen keine Änderungen, die durch das Bash-Tool vorgenommen wurden.

74 74 

75Weitere Informationen: [Checkpointing](/de/checkpointing)75Weitere Informationen: [Checkpointing](/de/checkpointing)

76 76 

goal.md +1 −1

Details

108 108 

109### Nicht-interaktiv ausführen109### Nicht-interaktiv ausführen

110 110 

111`/goal` funktioniert im [nicht-interaktiven Modus](/de/headless) und über [Remote Control](/de/remote-control). Das Festlegen eines Ziels mit `-p` führt die Schleife in einem einzigen Aufruf bis zur Fertigstellung aus:111`/goal` funktioniert im [nicht-interaktiven Modus](/de/headless), in der [Desktop-App](/de/desktop) und über [Remote Control](/de/remote-control). Das Festlegen eines Ziels mit `-p` führt die Schleife in einem einzigen Aufruf bis zur Fertigstellung aus:

112 112 

113```bash theme={null}113```bash theme={null}

114claude -p "/goal CHANGELOG.md has an entry for every PR merged this week"114claude -p "/goal CHANGELOG.md has an entry for every PR merged this week"

hooks.md +47 −7

Details

297| :-------------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |297| :-------------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

298| `type` | ja | `"command"`, `"http"`, `"mcp_tool"`, `"prompt"` oder `"agent"` |298| `type` | ja | `"command"`, `"http"`, `"mcp_tool"`, `"prompt"` oder `"agent"` |

299| `if` | nein | Berechtigungsregel-Syntax zum Filtern, wann dieser Hook ausgeführt wird, wie `"Bash(git *)"` oder `"Edit(*.ts)"`. Der Hook wird nur ausgeführt, wenn der Tool-Aufruf dem Muster entspricht, oder wenn ein Bash-Befehl zu komplex zum Analysieren ist. Wird nur auf Tool-Ereignisse evaluiert: `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest` und `PermissionDenied`. Bei anderen Ereignissen wird ein Hook mit `if` gesetzt nie ausgeführt. Verwendet die gleiche Syntax wie [Berechtigungsregeln](/de/permissions) |299| `if` | nein | Berechtigungsregel-Syntax zum Filtern, wann dieser Hook ausgeführt wird, wie `"Bash(git *)"` oder `"Edit(*.ts)"`. Der Hook wird nur ausgeführt, wenn der Tool-Aufruf dem Muster entspricht, oder wenn ein Bash-Befehl zu komplex zum Analysieren ist. Wird nur auf Tool-Ereignisse evaluiert: `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest` und `PermissionDenied`. Bei anderen Ereignissen wird ein Hook mit `if` gesetzt nie ausgeführt. Verwendet die gleiche Syntax wie [Berechtigungsregeln](/de/permissions) |

300| `timeout` | nein | Sekunden vor dem Abbruch. Standardwerte: 600 für Command, 30 für Prompt, 60 für Agent |300| `timeout` | nein | Sekunden vor dem Abbruch. Standardwerte: 600 für `command`, `http` und `mcp_tool`; 30 für `prompt`; 60 für `agent`. [`UserPromptSubmit`](#userpromptsubmit) senkt den Standardwert für `command`, `http` und `mcp_tool` auf 30 |

301| `statusMessage` | nein | Benutzerdefinierte Spinner-Nachricht, die angezeigt wird, während der Hook ausgeführt wird |301| `statusMessage` | nein | Benutzerdefinierte Spinner-Nachricht, die angezeigt wird, während der Hook ausgeführt wird |

302| `once` | nein | Wenn `true`, wird nur einmal pro Sitzung ausgeführt und dann entfernt. Nur für Hooks, die in [Skill-Frontmatter](#hooks-in-skills-and-agents) deklariert sind; wird in Einstellungsdateien und Agent-Frontmatter ignoriert |302| `once` | nein | Wenn `true`, wird nur einmal pro Sitzung ausgeführt und dann entfernt. Nur für Hooks, die in [Skill-Frontmatter](#hooks-in-skills-and-agents) deklariert sind; wird in Einstellungsdateien und Agent-Frontmatter ignoriert |

303 303 


558 558 

559Command-Hooks erhalten JSON-Daten über stdin und kommunizieren Ergebnisse über Exit-Codes, stdout und stderr. HTTP-Hooks erhalten die gleiche JSON als POST-Request-Body und kommunizieren Ergebnisse über den HTTP-Response-Body. Dieser Abschnitt behandelt Felder und Verhalten, die allen Ereignissen gemeinsam sind. Jeder Abschnitt eines Ereignisses unter [Hook-Ereignisse](#hook-events) enthält sein spezifisches Eingabeschema und Optionen zur Entscheidungskontrolle.559Command-Hooks erhalten JSON-Daten über stdin und kommunizieren Ergebnisse über Exit-Codes, stdout und stderr. HTTP-Hooks erhalten die gleiche JSON als POST-Request-Body und kommunizieren Ergebnisse über den HTTP-Response-Body. Dieser Abschnitt behandelt Felder und Verhalten, die allen Ereignissen gemeinsam sind. Jeder Abschnitt eines Ereignisses unter [Hook-Ereignisse](#hook-events) enthält sein spezifisches Eingabeschema und Optionen zur Entscheidungskontrolle.

560 560 

561Auf macOS und Linux werden Command-Hooks seit v2.1.139 in ihrer eigenen Sitzung ohne steuerndes Terminal ausgeführt. Der Hook-Prozess und alle untergeordneten Prozesse können `/dev/tty` nicht öffnen oder Escape-Sequenzen direkt an die Claude Code-Benutzeroberfläche senden. Windows hat kein `/dev/tty`. Um eine Nachricht dem Benutzer auf jeder Plattform anzuzeigen, geben Sie [`systemMessage`](#json-output) in der JSON-Ausgabe zurück. Um eine Desktop-Benachrichtigung auszulösen, einen Fenstertitel zu setzen oder die Glocke zu läuten, geben Sie stattdessen [`terminalSequence`](#emit-terminal-notifications) zurück.

562 

561### Gemeinsame Eingabefelder563### Gemeinsame Eingabefelder

562 564 

563Hook-Ereignisse erhalten diese Felder als JSON, zusätzlich zu ereignisspezifischen Feldern, die in jedem Abschnitt [Hook-Ereignis](#hook-events) dokumentiert sind. Für Command-Hooks kommt diese JSON über stdin an. Für HTTP-Hooks kommt sie als POST-Request-Body an.565Hook-Ereignisse erhalten diese Felder als JSON, zusätzlich zu ereignisspezifischen Feldern, die in jedem Abschnitt [Hook-Ereignis](#hook-events) dokumentiert sind. Für Command-Hooks kommt diese JSON über stdin an. Für HTTP-Hooks kommt sie als POST-Request-Body an.


685 687 

686Die stdout Ihres Hooks darf nur das JSON-Objekt enthalten. Wenn Ihr Shell-Profil beim Start Text ausgibt, kann dies die JSON-Analyse beeinträchtigen. Siehe [JSON-Validierung fehlgeschlagen](/de/hooks-guide#json-validation-failed) in der Fehlerbehebungsanleitung.688Die stdout Ihres Hooks darf nur das JSON-Objekt enthalten. Wenn Ihr Shell-Profil beim Start Text ausgibt, kann dies die JSON-Analyse beeinträchtigen. Siehe [JSON-Validierung fehlgeschlagen](/de/hooks-guide#json-validation-failed) in der Fehlerbehebungsanleitung.

687 689 

688Hook-Ausgabe, die in Kontext injiziert wird (`additionalContext`, `systemMessage` oder Plain-stdout), ist auf 10.000 Zeichen begrenzt. Ausgabe, die dieses Limit überschreitet, wird in einer Datei gespeichert und durch eine Vorschau und einen Dateipfad ersetzt, auf die gleiche Weise wie große Tool-Ergebnisse behandelt werden.690Hook-Ausgabe-Strings, einschließlich `additionalContext`, `systemMessage` und Plain-stdout, sind auf 10.000 Zeichen begrenzt. Ausgabe, die dieses Limit überschreitet, wird in einer Datei gespeichert und durch eine Vorschau und einen Dateipfad ersetzt, auf die gleiche Weise wie große Tool-Ergebnisse behandelt werden.

689 691 

690Das JSON-Objekt unterstützt drei Arten von Feldern:692Das JSON-Objekt unterstützt drei Arten von Feldern:

691 693 


694* **`hookSpecificOutput`** ist ein verschachteltes Objekt für Ereignisse, die reichere Kontrolle benötigen. Es erfordert ein `hookEventName`-Feld, das auf den Ereignisnamen gesetzt ist.696* **`hookSpecificOutput`** ist ein verschachteltes Objekt für Ereignisse, die reichere Kontrolle benötigen. Es erfordert ein `hookEventName`-Feld, das auf den Ereignisnamen gesetzt ist.

695 697 

696| Feld | Standard | Beschreibung |698| Feld | Standard | Beschreibung |

697| :--------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- |699| :----------------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

698| `continue` | `true` | Wenn `false`, stoppt Claude die Verarbeitung vollständig, nachdem der Hook ausgeführt wurde. Hat Vorrang vor allen ereignisspezifischen Entscheidungsfeldern |700| `continue` | `true` | Wenn `false`, stoppt Claude die Verarbeitung vollständig, nachdem der Hook ausgeführt wurde. Hat Vorrang vor allen ereignisspezifischen Entscheidungsfeldern |

699| `stopReason` | keine | Nachricht, die dem Benutzer angezeigt wird, wenn `continue` `false` ist. Wird Claude nicht angezeigt |701| `stopReason` | keine | Nachricht, die dem Benutzer angezeigt wird, wenn `continue` `false` ist. Wird Claude nicht angezeigt |

700| `suppressOutput` | `false` | Wenn `true`, verbirgt stdout aus dem Debug-Log |702| `suppressOutput` | `false` | Wenn `true`, verbirgt stdout aus dem Debug-Log |

701| `systemMessage` | keine | Warnmeldung, die dem Benutzer angezeigt wird |703| `systemMessage` | keine | Warnmeldung, die dem Benutzer angezeigt wird |

704| `terminalSequence` | keine | Eine Terminal-Escape-Sequenz, die Claude Code in Ihrem Namen ausgeben soll, wie eine Desktop-Benachrichtigung, ein Fenstertitel oder eine Glocke. Beschränkt auf OSC `0`/`1`/`2`/`9`/`99`/`777` und BEL. Wenn der Wert etwas außerhalb der Zulassungsliste enthält, wird das Feld ignoriert. Verwenden Sie dies anstelle des Schreibens zu `/dev/tty`, das für Hooks nicht verfügbar ist |

702 705 

703Um Claude unabhängig vom Ereignistyp vollständig zu stoppen:706Um Claude unabhängig vom Ereignistyp vollständig zu stoppen:

704 707 


706{ "continue": false, "stopReason": "Build failed, fix errors before continuing" }709{ "continue": false, "stopReason": "Build failed, fix errors before continuing" }

707```710```

708 711 

712#### Terminal-Benachrichtigungen ausgeben

713 

714Das Feld `terminalSequence` erfordert Claude Code v2.1.141 oder später.

715 

716Hooks werden ohne steuerndes Terminal ausgeführt, daher schlägt das direkte Schreiben von Escape-Sequenzen zu `/dev/tty` fehl. Geben Sie stattdessen die Escape-Sequenz im Feld `terminalSequence` zurück und Claude Code gibt sie für Sie über seinen eigenen Terminal-Schreibpfad aus. Dies ist race-frei, funktioniert innerhalb von tmux und GNU screen und funktioniert unter Windows, wo es kein `/dev/tty` gibt.

717 

718Das Feld akzeptiert einen String aus einer oder mehreren zugelassenen Escape-Sequenzen:

719 

720* OSC `0`, `1`, `2`: Fenster- und Symboltitel

721* OSC `9`: iTerm2-, ConEmu-, Windows Terminal- und WezTerm-Benachrichtigungen, einschließlich `9;4` Taskleisten-Fortschritt

722* OSC `99`: Kitty-Benachrichtigungen

723* OSC `777`: urxvt-, Ghostty- und Warp-Benachrichtigungen

724* Bare BEL

725 

726Sequenzen können mit BEL oder mit ST beendet werden. Alles außerhalb der Zulassungsliste, einschließlich CSI-Cursor- und Farbsequenzen, OSC-Palettensequenzen, OSC-8-Hyperlinks, OSC-52-Zwischenablage-Schreibvorgänge und OSC-1337, wird abgelehnt und das Feld wird ignoriert.

727 

728Das folgende Beispiel löst eine Desktop-Benachrichtigung aus einem `Notification`-Hook aus. Die Escape-Sequenz wird mit `printf`-Oktalescapes erstellt, sodass die Steuerbytes niemals auf der Shell-Befehlszeile erscheinen, und `jq -n --arg` erstellt die JSON-Ausgabe, sodass Anführungszeichen, Backslashes und Zeilenumbrüche in der Benachrichtigungsmeldung korrekt escaped werden:

729 

730```bash theme={null}

731#!/bin/bash

732# Notification-Hook: Ping des Desktops, wenn Claude Code Aufmerksamkeit benötigt.

733input=$(cat)

734title="Claude Code'

735body=$(jq -r '.message // "Needs your attention"' <<<"$input")

736seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")

737jq -nc --arg seq "$seq" '{terminalSequence: $seq}'

738```

739 

740Die Form `{ "terminalSequence": "..." }` ist die gleiche aus jeder Shell oder Sprache. Unter Windows erstellen Sie die Escape-Zeichenkette in PowerShell oder einem Skript und geben das gleiche JSON-Objekt aus.

741 

742<Note>

743 `terminalSequence` ist der unterstützte Ersatz für Hooks, die zuvor Escape-Sequenzen direkt zu `/dev/tty` schrieben. Die Zulassungsliste ist auf Sequenzen beschränkt, die den Cursor nicht bewegen oder Farben ändern können, sodass ein Hook niemals eine On-Screen-Eingabeaufforderung beschädigen kann.

744</Note>

745 

709#### Kontext für Claude hinzufügen746#### Kontext für Claude hinzufügen

710 747 

711Das Feld `additionalContext` übergibt einen String aus Ihrem Hook in Claudes Kontextfenster. Claude Code umhüllt den String in eine Systemerinnerung und fügt ihn in das Gespräch an dem Punkt ein, an dem der Hook ausgelöst wurde. Claude liest die Erinnerung bei der nächsten Modellanfrage, aber sie wird nicht als Chat-Nachricht in der Benutzeroberfläche angezeigt.748Das Feld `additionalContext` übergibt einen String aus Ihrem Hook in Claudes Kontextfenster. Claude Code umhüllt den String in eine Systemerinnerung und fügt ihn in das Gespräch an dem Punkt ein, an dem der Hook ausgelöst wurde. Claude liest die Erinnerung bei der nächsten Modellanfrage, aber sie wird nicht als Chat-Nachricht in der Benutzeroberfläche angezeigt.


989 1026 

990Wird ausgeführt, wenn der Benutzer einen Prompt einreicht, bevor Claude ihn verarbeitet. Dies ermöglicht es Ihnen, zusätzlichen Kontext basierend auf dem Prompt/Gespräch hinzuzufügen, Prompts zu validieren oder bestimmte Arten von Prompts zu blockieren.1027Wird ausgeführt, wenn der Benutzer einen Prompt einreicht, bevor Claude ihn verarbeitet. Dies ermöglicht es Ihnen, zusätzlichen Kontext basierend auf dem Prompt/Gespräch hinzuzufügen, Prompts zu validieren oder bestimmte Arten von Prompts zu blockieren.

991 1028 

1029`UserPromptSubmit`-Hooks haben ein Standard-Timeout von 30 Sekunden für `command`-, `http`- und `mcp_tool`-Typen, kürzer als das 600-Sekunden-Standard für diese Typen bei anderen Ereignissen. Da dieser Hook vor jedem Prompt ausgeführt wird und die Modellverarbeitung blockiert, bis er abgeschlossen ist, stellt ein feststeckender Hook die Sitzung still. Wenn Ihr Hook mehr Zeit benötigt, setzen Sie das Feld `timeout` im Hook-Eintrag.

1030 

992#### UserPromptSubmit-Eingabe1031#### UserPromptSubmit-Eingabe

993 1032 

994Zusätzlich zu den [gemeinsamen Eingabefeldern](#common-input-fields) erhalten UserPromptSubmit-Hooks das Feld `prompt`, das den Text enthält, den der Benutzer eingereicht hat.1033Zusätzlich zu den [gemeinsamen Eingabefeldern](#common-input-fields) erhalten UserPromptSubmit-Hooks das Feld `prompt`, das den Text enthält, den der Benutzer eingereicht hat.


2598 2637 

2599Wenn ein asynchroner Hook ausgelöst wird, startet Claude Code den Hook-Prozess und setzt sofort fort, ohne auf den Abschluss zu warten. Der Hook erhält die gleiche JSON-Eingabe über stdin wie ein synchroner Hook.2638Wenn ein asynchroner Hook ausgelöst wird, startet Claude Code den Hook-Prozess und setzt sofort fort, ohne auf den Abschluss zu warten. Der Hook erhält die gleiche JSON-Eingabe über stdin wie ein synchroner Hook.

2600 2639 

2601Nachdem der Hintergrund-Prozess beendet ist, wenn der Hook eine JSON-Response mit einem `systemMessage`- oder `additionalContext`-Feld erzeugt hat, wird dieser Inhalt Claude beim nächsten Gesprächsturn als Kontext geliefert.2640Nachdem der Hintergrund-Prozess beendet ist, wenn der Hook eine JSON-Response mit einem `additionalContext`-Feld erzeugt hat, wird dieser Inhalt Claude beim nächsten Gesprächsturn als Kontext geliefert. Ein `systemMessage`-Feld wird Ihnen angezeigt, nicht Claude.

2602 2641 

2603Benachrichtigungen über den Abschluss asynchroner Hooks werden standardmäßig unterdrückt. Um sie zu sehen, aktivieren Sie den ausführlichen Modus mit `Ctrl+O` oder starten Sie Claude Code mit `--verbose`.2642Benachrichtigungen über den Abschluss asynchroner Hooks werden standardmäßig unterdrückt. Um sie zu sehen, aktivieren Sie den ausführlichen Modus mit `Ctrl+O` oder starten Sie Claude Code mit `--verbose`.

2604 2643 


2619 exit 02658 exit 0

2620fi2659fi

2621 2660 

2622# Tests ausführen und Ergebnisse über systemMessage melden2661# Tests ausführen und Ergebnisse über additionalContext an Claude melden

2623RESULT=$(npm test 2>&1)2662RESULT=$(npm test 2>&1)

2624EXIT_CODE=$?2663EXIT_CODE=$?

2625 2664 

2626if [ $EXIT_CODE -eq 0 ]; then2665if [ $EXIT_CODE -eq 0 ]; then

2627 echo "{\"systemMessage\": \"Tests passed after editing $FILE_PATH\"}"2666 MSG="Tests passed after editing $FILE_PATH"

2628else2667else

2629 echo "{\"systemMessage\": \"Tests failed after editing $FILE_PATH: $RESULT\"}"2668 MSG="Tests failed after editing $FILE_PATH: $RESULT"

2630fi2669fi

2670jq -nc --arg msg "$MSG" '{hookSpecificOutput: {hookEventName: "PostToolUse", additionalContext: $msg}}'

2631```2671```

2632 2672 

2633Fügen Sie dann diese Konfiguration zu `.claude/settings.json` im Projekt-Root hinzu. Das Flag `async: true` ermöglicht es Claude, weiterarbeiten zu können, während Tests ausgeführt werden:2673Fügen Sie dann diese Konfiguration zu `.claude/settings.json` im Projekt-Root hinzu. Das Flag `async: true` ermöglicht es Claude, weiterarbeiten zu können, während Tests ausgeführt werden:

hooks-guide.md +5 −2

Details

865### Einschränkungen865### Einschränkungen

866 866 

867* Command-Hooks kommunizieren nur über stdout, stderr und Exit-Codes. Sie können `/`-Befehle oder Tool-Aufrufe nicht auslösen. Text, der über `additionalContext` zurückgegeben wird, wird als Systemerinnerung injiziert, die Claude als Klartext liest. HTTP-Hooks kommunizieren stattdessen über den Response-Body.867* Command-Hooks kommunizieren nur über stdout, stderr und Exit-Codes. Sie können `/`-Befehle oder Tool-Aufrufe nicht auslösen. Text, der über `additionalContext` zurückgegeben wird, wird als Systemerinnerung injiziert, die Claude als Klartext liest. HTTP-Hooks kommunizieren stattdessen über den Response-Body.

868* Hook-Timeout beträgt standardmäßig 10 Minuten, konfigurierbar pro Hook mit dem Feld `timeout` (in Sekunden).868* Hook-Timeouts variieren je nach Typ. Überschreiben Sie pro Hook mit dem Feld `timeout` in Sekunden.

869 * `command`, `http`, `mcp_tool`: 10 Minuten. `UserPromptSubmit` reduziert diese auf 30 Sekunden.

870 * `prompt`: 30 Sekunden.

871 * `agent`: 60 Sekunden.

869* `PostToolUse`-Hooks können Aktionen nicht rückgängig machen, da das Tool bereits ausgeführt wurde.872* `PostToolUse`-Hooks können Aktionen nicht rückgängig machen, da das Tool bereits ausgeführt wurde.

870* `PermissionRequest`-Hooks werden nicht im [nicht-interaktiven Modus](/de/headless) (`-p`) ausgelöst. Verwenden Sie `PreToolUse`-Hooks für automatisierte Berechtigungsentscheidungen.873* `PermissionRequest`-Hooks werden nicht im [nicht-interaktiven Modus](/de/headless) (`-p`) ausgelöst. Verwenden Sie `PreToolUse`-Hooks für automatisierte Berechtigungsentscheidungen.

871* `Stop`-Hooks werden ausgelöst, wenn Claude antwortet, nicht nur bei Aufgabenabschluss. Sie werden nicht bei Benutzerunterbrechungen ausgelöst. API-Fehler lösen stattdessen [StopFailure](/de/hooks#stopfailure) aus.874* `Stop`-Hooks werden ausgelöst, wenn Claude antwortet, nicht nur bei Aufgabenabschluss. Sie werden nicht bei Benutzerunterbrechungen ausgelöst. API-Fehler lösen stattdessen [StopFailure](/de/hooks#stopfailure) aus.


926 929 

927Claude Code zeigt einen JSON-Parsing-Fehler an, obwohl Ihr Hook-Skript gültiges JSON ausgibt.930Claude Code zeigt einen JSON-Parsing-Fehler an, obwohl Ihr Hook-Skript gültiges JSON ausgibt.

928 931 

929Wenn Claude Code einen Shell-Form-Command-Hook ausführt (einen ohne `args`), spawnt es `sh -c` auf macOS und Linux oder Git Bash auf Windows standardmäßig. Diese Shell ist nicht-interaktiv, aber Git Bash und einige Konfigurationen (wie `BASH_ENV`, das auf `~/.bashrc` zeigt) sourced trotzdem Ihr Profil. Wenn dieses Profil bedingungslose `echo`-Anweisungen enthält, wird die Ausgabe Ihrem Hook-JSON vorangestellt:932Wenn Claude Code einen Shell-Form-Command-Hook ausführt (einen ohne `args`), spawnt es `sh -c` auf macOS und Linux oder Git Bash auf Windows standardmäßig. Diese Shell ist nicht-interaktiv, aber Git Bash und einige Konfigurationen (wie `BASH_ENV`, das auf `~/.bashrc` zeigt) sourcen trotzdem Ihr Profil. Wenn dieses Profil bedingungslose `echo`-Anweisungen enthält, wird die Ausgabe Ihrem Hook-JSON vorangestellt:

930 933 

931```text theme={null}934```text theme={null}

932Shell ready on arm64935Shell ready on arm64

mcp.md +1 −1

Details

458 458 

459Viele Cloud-basierte MCP-Server erfordern Authentifizierung. Claude Code unterstützt OAuth 2.0 für sichere Verbindungen.459Viele Cloud-basierte MCP-Server erfordern Authentifizierung. Claude Code unterstützt OAuth 2.0 für sichere Verbindungen.

460 460 

461Claude Code markiert einen Remote-Server als authentifizierungsbedürftig, wenn der Server mit `401 Unauthorized` und einem `WWW-Authenticate`-Header antwortet, der auf seinen Autorisierungsserver verweist. Jeder benutzerdefinierte Server, der diese Antwort zurückgibt, erhält denselben `/mcp`-Authentifizierungsfluss wie jeder andere Remote-Server.461Claude Code markiert einen Remote-Server als authentifizierungsbedürftig, wenn der Server mit `401 Unauthorized` oder `403 Forbidden` antwortet. Jeder dieser Statuscodes kennzeichnet den Server in `/mcp`, damit Sie den OAuth-Fluss abschließen können. Ein benutzerdefinierter Server, der einen `WWW-Authenticate`-Header zurückgibt, der auf seinen Autorisierungsserver verweist, erhält die gleiche automatische Erkennung wie jeder andere Remote-Server.

462 462 

463<Steps>463<Steps>

464 <Step title="Fügen Sie den Server hinzu, der Authentifizierung erfordert">464 <Step title="Fügen Sie den Server hinzu, der Authentifizierung erfordert">

Details

51 Verfügbare Flags:51 Verfügbare Flags:

52 52 

53 | Flag | Beschreibung |53 | Flag | Beschreibung |

54 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |54 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

55 | `--name "My Project"` | Legen Sie einen benutzerdefinierten Sitzungstitel fest, der in der Sitzungsliste unter claude.ai/code sichtbar ist. |55 | `--name "My Project"` | Legen Sie einen benutzerdefinierten Sitzungstitel fest, der in der Sitzungsliste unter claude.ai/code sichtbar ist. |

56 | `--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. |56 | `--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. |

57 | `--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/common-workflows#run-parallel-claude-code-sessions-with-git-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. |57 | `--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. |

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

59 | `--verbose` | Zeigen Sie detaillierte Verbindungs- und Sitzungsprotokolle an. |59 | `--verbose` | Zeigen Sie detaillierte Verbindungs- und Sitzungsprotokolle an. |

60 | `--sandbox` / `--no-sandbox` | Aktivieren oder deaktivieren Sie [sandboxing](/de/sandboxing) für Dateisystem- und Netzwerkisolation. Standardmäßig deaktiviert. |60 | `--sandbox` / `--no-sandbox` | Aktivieren oder deaktivieren Sie [sandboxing](/de/sandboxing) für Dateisystem- und Netzwerkisolation. Standardmäßig deaktiviert. |


113 113 

114* **Öffnen Sie die Sitzungs-URL** in einem beliebigen Browser, um direkt zur Sitzung auf [claude.ai/code](https://claude.ai/code) zu gehen.114* **Öffnen Sie die Sitzungs-URL** in einem beliebigen Browser, um direkt zur Sitzung auf [claude.ai/code](https://claude.ai/code) zu gehen.

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

116* **Öffnen Sie [claude.ai/code](https://claude.ai/code) oder die Claude-App** und finden Sie die Sitzung nach Name in der Sitzungsliste. Remote Control-Sitzungen zeigen ein Computersymbol mit einem grünen Statusindikator an, wenn sie online sind.116* **Ö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.

117 117 

118Der Titel der Remote-Sitzung wird in dieser Reihenfolge gewählt:118Der Titel der Remote-Sitzung wird in dieser Reihenfolge gewählt:

119 119 


130 130 

131### Aktivieren Sie Remote Control für alle Sitzungen131### Aktivieren Sie Remote Control für alle Sitzungen

132 132 

133Standardmäßig wird Remote Control nur aktiviert, wenn Sie explizit `claude remote-control`, `claude --remote-control` oder `/remote-control` ausführen. 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` zurück, um es zu deaktivieren.133Standardmäßig wird Remote Control nur aktiviert, wenn Sie explizit `claude remote-control`, `claude --remote-control` oder `/remote-control` ausführen. 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` zurück, um es zu deaktivieren. In der Desktop-App können Sie dies auch unter **Einstellungen → Claude Code → Enable remote control by default** umschalten.

134 134 

135Mit 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).135Mit 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).

136 136 


215 215 

216### „Remote Control ist durch die Richtlinie Ihrer Organisation deaktiviert"216### „Remote Control ist durch die Richtlinie Ihrer Organisation deaktiviert"

217 217 

218Dieser Fehler hat drei unterschiedliche Ursachen. Führen Sie zunächst `/status` aus, um zu sehen, welche Anmeldemethode und welches Abonnement Sie verwenden.218Dieser Fehler hat vier unterschiedliche Ursachen. Führen Sie zunächst `/status` aus, um zu sehen, welche Anmeldemethode und welches Abonnement Sie verwenden.

219 219 

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

221* **Ihr Team- oder Enterprise-Administrator hat es nicht aktiviert**: Remote Control ist standardmäßig in diesen Plänen deaktiviert. Ein Administrator kann es unter [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) aktivieren, indem er den Schalter **Remote Control** einschaltet. Dies ist eine serverseitige Organisationseinstellung, keine [verwaltete Einstellung](/de/permissions#managed-only-settings).221* **Ihr Team- oder Enterprise-Administrator hat es nicht aktiviert**: Remote Control ist standardmäßig in diesen Plänen deaktiviert. Ein Administrator 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.

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

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

223 224 

224### „Remote credentials fetch failed"225### „Remote credentials fetch failed"

225 226 


233 234 

234* Nicht angemeldet: Führen Sie `claude` aus und verwenden Sie `/login`, um sich mit Ihrem claude.ai-Konto zu authentifizieren. API-Schlüssel-Authentifizierung wird für Remote Control nicht unterstützt.235* Nicht angemeldet: Führen Sie `claude` aus und verwenden Sie `/login`, um sich mit Ihrem claude.ai-Konto zu authentifizieren. API-Schlüssel-Authentifizierung wird für Remote Control nicht unterstützt.

235* Netzwerk- oder Proxy-Problem: Eine Firewall oder ein Proxy blockiert möglicherweise die ausgehende HTTPS-Anfrage. Remote Control erfordert Zugriff auf die Anthropic-API auf Port 443.236* Netzwerk- oder Proxy-Problem: Eine Firewall oder ein Proxy blockiert möglicherweise die ausgehende HTTPS-Anfrage. Remote Control erfordert Zugriff auf die Anthropic-API auf Port 443.

236* Sitzungserstellung fehlgeschlagen: Wenn Sie auch Session creation failed — see debug log" sehen, ist der Fehler früher in der Einrichtung aufgetreten. Überprüfen Sie, dass Ihr Abonnement aktiv ist.237* Sitzungserstellung fehlgeschlagen: Wenn Sie auch `Session creation failed — see debug log` sehen, ist der Fehler früher in der Einrichtung aufgetreten. Überprüfen Sie, dass Ihr Abonnement aktiv ist.

237 238 

238## Wählen Sie den richtigen Ansatz239## Wählen Sie den richtigen Ansatz

239 240 

sub-agents.md +6 −4

Details

158 158 

159Dies ist die empfohlene Methode zum Erstellen und Verwalten von Subagenten. Für manuelle Erstellung oder Automatisierung können Sie auch Subagenten-Dateien direkt hinzufügen.159Dies ist die empfohlene Methode zum Erstellen und Verwalten von Subagenten. Für manuelle Erstellung oder Automatisierung können Sie auch Subagenten-Dateien direkt hinzufügen.

160 160 

161Um alle konfigurierten Subagenten von der Befehlszeile aus ohne Öffnen der [Agent-Ansicht](/de/agent-view) aufzulisten, leiten Sie die Ausgabe von `claude agents` weiter. Zum Beispiel druckt `claude agents | cat` Agenten gruppiert nach Quelle und gibt an, welche durch höherrangige Definitionen überschrieben werden.

162 

163### Wählen Sie den Subagenten-Umfang161### Wählen Sie den Subagenten-Umfang

164 162 

165Subagenten sind Markdown-Dateien mit YAML-Frontmatter. Speichern Sie sie an verschiedenen Orten je nach Umfang. Wenn mehrere Subagenten denselben Namen haben, gewinnt der höherrangige Ort.163Subagenten sind Markdown-Dateien mit YAML-Frontmatter. Speichern Sie sie an verschiedenen Orten je nach Umfang. Wenn mehrere Subagenten denselben Namen haben, gewinnt der höherrangige Ort.


178 176 

179**Benutzer-Subagenten** (`~/.claude/agents/`) sind persönliche Subagenten, die in allen Ihren Projekten verfügbar sind.177**Benutzer-Subagenten** (`~/.claude/agents/`) sind persönliche Subagenten, die in allen Ihren Projekten verfügbar sind.

180 178 

179Claude 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. Halten Sie `name`-Werte über den gesamten Baum eindeutig: Wenn zwei Dateien innerhalb eines Umfangs denselben Namen deklarieren, behält Claude Code eine und verwirft die andere ohne Warnung.

180 

181Plugin-`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`.

182 

181**CLI-definierte Subagenten** werden als JSON beim Starten von Claude Code übergeben. Sie existieren nur für diese Sitzung und werden nicht auf der Festplatte gespeichert, was sie für schnelle Tests oder Automatisierungsskripte nützlich macht. Sie können mehrere Subagenten in einem einzigen `--agents`-Aufruf definieren:183**CLI-definierte Subagenten** werden als JSON beim Starten von Claude Code übergeben. Sie existieren nur für diese Sitzung und werden nicht auf der Festplatte gespeichert, was sie für schnelle Tests oder Automatisierungsskripte nützlich macht. Sie können mehrere Subagenten in einem einzigen `--agents`-Aufruf definieren:

182 184 

183<Tabs>185<Tabs>


638 640 

639Ihre 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.641Ihre 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.

640 642 

641Subagenten, die von einem aktivierten [Plugin](/de/plugins) bereitgestellt werden, erscheinen in der Typeahead-Liste als `<plugin-name>:<agent-name>`. 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. Sie können die Erwähnung auch manuell eingeben, ohne den Picker zu verwenden: `@agent-<name>` für lokale Subagenten oder `@agent-<plugin-name>:<agent-name>` für Plugin-Subagenten.643Subagenten, 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. Sie 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`.

642 644 

643**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:645**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:

644 646 


650 652 

651Dies funktioniert mit integrierten und benutzerdefinierten Subagenten, und die Wahl bleibt bestehen, wenn Sie die Sitzung fortsetzen.653Dies funktioniert mit integrierten und benutzerdefinierten Subagenten, und die Wahl bleibt bestehen, wenn Sie die Sitzung fortsetzen.

652 654 

653Für einen von einem Plugin bereitgestellten Subagenten übergeben Sie den scoped Namen: `claude --agent <plugin-name>:<agent-name>`.655Für einen von einem Plugin bereitgestellten Subagenten übergeben Sie den scoped Namen: `claude --agent <plugin-name>:<agent-name>`. Wenn das Plugin den Agenten in einem Unterordner seines `agents/`-Verzeichnisses platziert, fügen Sie den Unterordner in den scoped Namen ein, z. B. `claude --agent my-plugin:review:security`.

654 656 

655Um es zum Standard für jede Sitzung in einem Projekt zu machen, setzen Sie `agent` in `.claude/settings.json`:657Um es zum Standard für jede Sitzung in einem Projekt zu machen, setzen Sie `agent` in `.claude/settings.json`:

656 658 

Details

16 16 

17Die Spracherfassung streamt Ihre aufgenommene Audiodatei an Anthropic-Server zur Transkription. Audio wird nicht lokal verarbeitet. Der Sprache-zu-Text-Dienst ist nur verfügbar, wenn Sie sich mit einem Claude.ai-Konto authentifizieren, und ist nicht verfügbar, wenn Claude Code für die Verwendung eines Anthropic API-Schlüssels direkt, Amazon Bedrock, Google Vertex AI oder Microsoft Foundry konfiguriert ist. Die 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.17Die Spracherfassung streamt Ihre aufgenommene Audiodatei an Anthropic-Server zur Transkription. Audio wird nicht lokal verarbeitet. Der Sprache-zu-Text-Dienst ist nur verfügbar, wenn Sie sich mit einem Claude.ai-Konto authentifizieren, und ist nicht verfügbar, wenn Claude Code für die Verwendung eines Anthropic API-Schlüssels direkt, Amazon Bedrock, Google Vertex AI oder Microsoft Foundry konfiguriert ist. Die 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.

18 18 

19Die Spracherfassung benötigt auch lokalen Mikrofonzugriff, daher funktioniert sie nicht in Remote-Umgebungen wie [Claude Code im Web](/de/claude-code-on-the-web) oder SSH-Sitzungen. In WSL erfordert die Spracherfassung WSLg für Audiozugriff, das in WSL2 unter Windows 11 enthalten ist. Unter Windows 10 oder WSL1 führen Sie Claude Code stattdessen nativ unter Windows aus.19Die Spracherfassung benötigt auch lokalen Mikrofonzugriff, daher funktioniert sie nicht in Remote-Umgebungen wie [Claude Code im Web](/de/claude-code-on-the-web) oder SSH-Sitzungen. In WSL erfordert die Spracherfassung WSLg für Audiozugriff. 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.

20 20 

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

22 22 


51}51}

52```52```

53 53 

54Während die Spracherfassung aktiviert ist, zeigt die Eingabefußzeile einen `hold Space to speak`-Hinweis an, wenn die Eingabeaufforderung leer ist. Der Hinweistext ist in beiden Modi gleich und wird nicht angezeigt, wenn Sie eine [benutzerdefinierte Statuszeile](/de/statusline) konfiguriert haben.54Wä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.

55 55 

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

57 57 


155* **`Voice mode requires a Claude.ai account`**: Sie sind mit einem API-Schlüssel oder einem Drittanbieter authentifiziert. Führen Sie `/login` aus, um sich mit einem Claude.ai-Konto anzumelden.155* **`Voice mode requires a Claude.ai account`**: Sie sind mit einem API-Schlüssel oder einem Drittanbieter authentifiziert. Führen Sie `/login` aus, um sich mit einem Claude.ai-Konto anzumelden.

156* **`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).156* **`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).

157* **`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`.157* **`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`.

158* **`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.

159* **`Voice input is failing repeatedly and has been paused`**: Die Spracherfassung ist mehrmals hintereinander fehlgeschlagen und hat versucht, neue Sitzungen zu stoppen, bis eine erfolgreich ist. Dies bedeutet normalerweise, dass das Mikrofon oder der Audiostapel auf diesem Host keinen Audio erfassen kann, z. B. ein Server ohne Kopfhörer, eine Remote-Shell ohne Audio-Durchleitung oder eine verweigerte Mikrofonberechtigung. Bestätigen Sie ein funktionierendes Eingabegerät, beheben Sie die zugrunde liegende Ursache aus den obigen Einträgen und lösen Sie dann die Spracherfassung erneut aus.

158* **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.160* **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.

159* **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.161* **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.

160* **`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.162* **`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.