SpyBara
Go Premium

Documentation 2026-11-06 23:01 UTC to 2026-11-07 23:58 UTC

6 files changed +25 −27. View all changes and history on the product overview
2026
Thu 12 21:00 Wed 11 22:59 Tue 10 21:57 Mon 9 23:02 Sun 8 22:58 Sat 7 23:58 Fri 6 23:01 Thu 5 23:03 Wed 4 23:59 Tue 3 23:58 Mon 2 23:57 Sun 1 23:57

desktop.md +8 −3

Details

549Eine lokale Sitzung wird verbunden, wenn Sie Remote Control für sie einschalten oder wenn sie sich beim Start automatisch verbindet:549Eine lokale Sitzung wird verbunden, wenn Sie Remote Control für sie einschalten oder wenn sie sich beim Start automatisch verbindet:

550 550 

551* **Sie schalten es für diese Sitzung ein**: mit dem Schalter **Remote Control** der Sitzung oder durch Eingabe von `/remote-control` in ihr Eingabefeld.551* **Sie schalten es für diese Sitzung ein**: mit dem Schalter **Remote Control** der Sitzung oder durch Eingabe von `/remote-control` in ihr Eingabefeld.

552* **Sie verbindet sich beim Start**: Neue Sitzungen verbinden sich automatisch, solange **Connect new sessions to Remote Control** unter **Settings > Code** oder **Settings > Claude Code** eingeschaltet ist. Wenn Sie diese Einstellung nie geändert haben, folgt Desktop [`remoteControlAtStartup`](https://code.claude.com/docs/de/settings-reference#remotecontrolatstartup) in Ihren Benutzer- oder verwalteten Einstellungen und danach der Standardeinstellung Ihrer Organisation.552* **Sie verbindet sich beim Start**: Neue Sitzungen verbinden sich automatisch, solange **Connect new sessions to Remote Control** unter **Settings > Code** oder **Settings > Claude Code** eingeschaltet ist, es sei denn, [`remoteControlAtStartup`](https://code.claude.com/docs/de/settings-reference#remotecontrolatstartup) ist in verwalteten Einstellungen auf `false` gesetzt. Wenn Sie **Connect new sessions to Remote Control** nie geändert haben, verwendet Desktop `remoteControlAtStartup` aus Ihren Benutzer- oder verwalteten Einstellungen. Wenn keine davon den Wert festlegt, verwendet Desktop die Standardeinstellung Ihrer Organisation oder, falls keine vorhanden ist, seine eigene.

553 553 

554Um zu sehen, ob eine Sitzung verbunden ist, prüfen Sie den Schalter **Remote Control** in der Karte **Environment** des [Sitzungsdetailbereichs](#see-session-details).554Um zu sehen, ob eine Sitzung verbunden ist, prüfen Sie den Schalter **Remote Control** in der Karte **Environment** des [Sitzungsdetailbereichs](#see-session-details).

555 555 

556Um Sitzungen von Ihren anderen Geräten fernzuhalten, schalten Sie Remote Control auf der gewünschten Ebene aus:556#### Sitzungen von Ihren anderen Geräten fernhalten

557 

558Schalten Sie Remote Control für eine Sitzung, für Sitzungen auf diesem Computer oder für Computer aus, die Sie verwalten:

557 559 

558* **Eine Sitzung**: Schalten Sie ihren Schalter **Remote Control** aus. In einer Sitzung, die sich beim Start verbunden hat, lässt die Eingabe von `/remote-control` Remote Control eingeschaltet und zeigt `Remote Control is already on. This session connected automatically when it started.` an. Klicken Sie in dieser Zeile auf **Turn off**, um die Verbindung zu trennen.560* **Eine Sitzung**: Schalten Sie ihren Schalter **Remote Control** aus. In einer Sitzung, die sich beim Start verbunden hat, lässt die Eingabe von `/remote-control` Remote Control eingeschaltet und zeigt `Remote Control is already on. This session connected automatically when it started.` an. Klicken Sie in dieser Zeile auf **Turn off**, um die Verbindung zu trennen.

559* **Neue Desktop-Sitzungen auf diesem Computer**: Schalten Sie **Connect new sessions to Remote Control** unter **Settings > Code** oder **Settings > Claude Code** aus. Wenn die Einstellung bereits als ausgeschaltet angezeigt wird, schalten Sie sie ein und wieder aus, damit Desktop Ihre Auswahl speichert. Nach dem Speichern hat sie Vorrang vor `remoteControlAtStartup` und den Standardwerten.561* **Neue Desktop-Sitzungen auf diesem Computer**: Schalten Sie **Connect new sessions to Remote Control** unter **Settings > Code** oder **Settings > Claude Code** aus. Wenn die Einstellung bereits als ausgeschaltet angezeigt wird, schalten Sie sie ein und wieder aus, damit Desktop Ihre Auswahl speichert. Nach dem Speichern verbinden sich neue Sitzungen nicht automatisch, selbst wenn `remoteControlAtStartup` oder ein Standardwert dies vorsieht.

560* **Jede Sitzung auf diesem Computer, einschließlich der CLI**: Setzen Sie [`disableRemoteControl`](https://code.claude.com/docs/de/settings-reference#disableremotecontrol) in `~/.claude/settings.json` auf `true`, um zu verhindern, dass sich Sitzungen verbinden. Eine Sitzung, die beim Speichern der Datei bereits verbunden war, bleibt verbunden, bis Sie Remote Control für sie ausschalten.562* **Jede Sitzung auf diesem Computer, einschließlich der CLI**: Setzen Sie [`disableRemoteControl`](https://code.claude.com/docs/de/settings-reference#disableremotecontrol) in `~/.claude/settings.json` auf `true`, um zu verhindern, dass sich Sitzungen verbinden. Eine Sitzung, die beim Speichern der Datei bereits verbunden war, bleibt verbunden, bis Sie Remote Control für sie ausschalten.

563* **Desktop-Sitzungen auf Computern, die Sie verwalten**: Wenn Sie `remoteControlAtStartup` in der [höchstrangigen MDM-Richtlinie oder verwalteten Einstellungsdatei](https://code.claude.com/docs/de/managed-settings.md#how-claude-code-combines-managed-sources) eines Computers auf `false` setzen, verbinden sich Sitzungen dort nicht automatisch, selbst wenn der Schlüssel in [serververwalteten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) auf `true` gesetzt ist. Verwenden Sie hierfür keinen `HKCU`-Registrierungswert auf Benutzerebene. Benutzer können Remote Control für eine Sitzung weiterhin selbst einschalten; um dies zu verhindern, verwenden Sie die [Admin-Konsole](#admin-console-controls). Erfordert Claude Desktop v4.4212.0 oder höher.

561 564 

562Um eine Sitzung auszublenden, die bereits auf Ihren anderen Geräten angezeigt wird, archivieren Sie sie in Desktop. Desktop archiviert auch die Remote-Control-Kopie der Sitzung, sodass sie aus der Standard-Sitzungsliste auf diesen Geräten verschwindet. Informationen zum Anzeigen oder Löschen dort finden Sie unter [Sitzungen archivieren](https://code.claude.com/docs/de/claude-code-on-the-web.md#archive-sessions).565Um eine Sitzung auszublenden, die bereits auf Ihren anderen Geräten angezeigt wird, archivieren Sie sie in Desktop. Desktop archiviert auch die Remote-Control-Kopie der Sitzung, sodass sie aus der Standard-Sitzungsliste auf diesen Geräten verschwindet. Informationen zum Anzeigen oder Löschen dort finden Sie unter [Sitzungen archivieren](https://code.claude.com/docs/de/claude-code-on-the-web.md#archive-sessions).

563 566 


2014| `disableSshSavedPasswords` | auf `true` setzen, damit Desktop nicht mehr anbietet, SSH-Passwörter zu speichern, und die zuvor gespeicherten weder verwendet noch anzeigt. Das Einschalten löscht diese nicht. Wird nur aus verwalteten Einstellungen gelesen. Erfordert Claude Desktop v1.49585.0 oder später. |2017| `disableSshSavedPasswords` | auf `true` setzen, damit Desktop nicht mehr anbietet, SSH-Passwörter zu speichern, und die zuvor gespeicherten weder verwendet noch anzeigt. Das Einschalten löscht diese nicht. Wird nur aus verwalteten Einstellungen gelesen. Erfordert Claude Desktop v1.49585.0 oder später. |

2015| `managedMcpServers` | übertragen Sie MCP-Serverkonfigurationen an alle Benutzer. Nur in Drittanbieter-Desktop-Bereitstellungen (3P) verfügbar. Geben Sie in jedem Eintrag einen Transport von `"http"`, `"sse"` oder `"stdio"`, Verbindungsdetails und optional eine `toolPolicy`-Zuordnung an, um einzuschränken, welche Tools dieses Servers Benutzer aufrufen können. Stellen Sie diesen Schlüssel über die verwaltete Einstellungsdatei, MDM oder eine Claude-Apps-Gateway-Richtlinie [`desktop`-Block](https://code.claude.com/docs/de/claude-apps-gateway-config#claude-desktop-overlay) bereit, da Drittanbieter-Bereitstellungen keine Admin-Konsolen-Einstellungen erhalten. Um diesen Schlüssel über das Gateway bereitzustellen, benötigen Sie Claude Code v2.1.232 oder später auf dem Gateway-Server. Dies ist der eigene Schlüssel der Desktop-App; Claude Code liest eine eigene [gleichnamige verwaltete Einstellung](https://code.claude.com/docs/de/managed-mcp.md#provide-servers-through-managed-settings) mit einer anderen Eintragsform. |2018| `managedMcpServers` | übertragen Sie MCP-Serverkonfigurationen an alle Benutzer. Nur in Drittanbieter-Desktop-Bereitstellungen (3P) verfügbar. Geben Sie in jedem Eintrag einen Transport von `"http"`, `"sse"` oder `"stdio"`, Verbindungsdetails und optional eine `toolPolicy`-Zuordnung an, um einzuschränken, welche Tools dieses Servers Benutzer aufrufen können. Stellen Sie diesen Schlüssel über die verwaltete Einstellungsdatei, MDM oder eine Claude-Apps-Gateway-Richtlinie [`desktop`-Block](https://code.claude.com/docs/de/claude-apps-gateway-config#claude-desktop-overlay) bereit, da Drittanbieter-Bereitstellungen keine Admin-Konsolen-Einstellungen erhalten. Um diesen Schlüssel über das Gateway bereitzustellen, benötigen Sie Claude Code v2.1.232 oder später auf dem Gateway-Server. Dies ist der eigene Schlüssel der Desktop-App; Claude Code liest eine eigene [gleichnamige verwaltete Einstellung](https://code.claude.com/docs/de/managed-mcp.md#provide-servers-through-managed-settings) mit einer anderen Eintragsform. |

2016 2019 

2020Wenn Sie eine Funktion mit `browserExternalPageTools`, `disableMobileSimulatorTools` oder `disableBrowserExternalNavigation` in der [ranghöchsten MDM-Richtlinie oder verwalteten Einstellungsdatei](https://code.claude.com/docs/de/managed-settings.md#how-claude-code-combines-managed-sources) eines Computers ausschalten, bleibt die Funktion dort ausgeschaltet. Sie bleibt auch dann ausgeschaltet, wenn Ihre [Server-verwalteten Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md) diesen Schlüssel nicht setzen oder die Funktion zulassen. Verwenden Sie hierfür keinen `HKCU`-Registrierungswert auf Benutzerebene. Um die Funktion wieder einzuschalten, entfernen Sie den Wert überall dort, wo Sie ihn gesetzt haben. Erfordert Claude Desktop v4.4212.0 oder später.

2021 

2017Welche verwalteten Einstellungen eine Desktop-Sitzung erreichen, hängt davon ab, wo diese Sitzung ausgeführt wird. Modellbeschränkungen wie [`availableModels`](https://code.claude.com/docs/de/model-config#restrict-model-selection) werden in Desktop-Claude-Code-Sitzungen auf die gleiche Weise durchgesetzt wie in der Terminal-CLI; siehe [Oberflächenabdeckung](https://code.claude.com/docs/de/model-config.md#surface-coverage).2022Welche verwalteten Einstellungen eine Desktop-Sitzung erreichen, hängt davon ab, wo diese Sitzung ausgeführt wird. Modellbeschränkungen wie [`availableModels`](https://code.claude.com/docs/de/model-config#restrict-model-selection) werden in Desktop-Claude-Code-Sitzungen auf die gleiche Weise durchgesetzt wie in der Terminal-CLI; siehe [Oberflächenabdeckung](https://code.claude.com/docs/de/model-config.md#surface-coverage).

2018 2023 

2019* **Lokale Sitzungen auf diesem Computer**: Eine verwaltete Einstellungsdatei, die auf der Festplatte bereitgestellt wird, gilt. Verwaltete Einstellungen, die remote über die Admin-Konsole hochgeladen werden, erreichen diese Sitzungen auch auf Anthropics API, wenn sich die Sitzung mit einer [berechtigten Anmeldung](https://code.claude.com/docs/de/server-managed-settings.md#platform-availability) authentifiziert, und folgen dabei der gleichen [Rangfolge der Einstellungen](https://code.claude.com/docs/de/settings.md#settings-precedence) wie die Terminal-CLI.2024* **Lokale Sitzungen auf diesem Computer**: Eine verwaltete Einstellungsdatei, die auf der Festplatte bereitgestellt wird, gilt. Verwaltete Einstellungen, die remote über die Admin-Konsole hochgeladen werden, erreichen diese Sitzungen auch auf Anthropics API, wenn sich die Sitzung mit einer [berechtigten Anmeldung](https://code.claude.com/docs/de/server-managed-settings.md#platform-availability) authentifiziert, und folgen dabei der gleichen [Rangfolge der Einstellungen](https://code.claude.com/docs/de/settings.md#settings-precedence) wie die Terminal-CLI.

hooks.md +1 −1

Details

2166| Feld | Beschreibung |2166| Feld | Beschreibung |

2167| :- | :- |2167| :- | :- |

2168| `behavior` | `"allow"` erteilt die Berechtigung, `"deny"` lehnt sie ab. [deny- und ask-Regeln](https://code.claude.com/docs/de/permissions.md#manage-permissions) werden weiterhin ausgewertet, sodass ein Hook, der `"allow"` zurückgibt, eine passende deny-Regel nicht überschreibt |2168| `behavior` | `"allow"` erteilt die Berechtigung, `"deny"` lehnt sie ab. [deny- und ask-Regeln](https://code.claude.com/docs/de/permissions.md#manage-permissions) werden weiterhin ausgewertet, sodass ein Hook, der `"allow"` zurückgibt, eine passende deny-Regel nicht überschreibt |

2169| `updatedInput` | Nur für `"allow"`: Ändert die Eingabeparameter des Tools vor der Ausführung. Ersetzt das gesamte Eingabeobjekt, daher müssen unveränderte Felder zusammen mit den geänderten enthalten sein. Die geänderte Eingabe wird erneut gegen deny- und ask-Regeln ausgewertet |2169| `updatedInput` | Nur für `"allow"`: ändert die Eingabeparameter des Tools vor der Ausführung. Ersetzt das gesamte Eingabeobjekt, also nehmen Sie unveränderte Felder zusammen mit den geänderten auf. Die geänderte Eingabe wird erneut gegen deny- und ask-Regeln ausgewertet. `AskUserQuestion` und `ExitPlanMode` [benötigen dieses Feld](#allow-with-updatedinput) |

2170| `updatedPermissions` | Nur für `"allow"`: Array von anzuwendenden [Einträgen zur Berechtigungsaktualisierung](#permission-update-entries), etwa zum Hinzufügen einer allow-Regel oder zum Ändern des Berechtigungsmodus der Sitzung |2170| `updatedPermissions` | Nur für `"allow"`: Array von anzuwendenden [Einträgen zur Berechtigungsaktualisierung](#permission-update-entries), etwa zum Hinzufügen einer allow-Regel oder zum Ändern des Berechtigungsmodus der Sitzung |

2171| `message` | Nur für `"deny"`: Teilt Claude mit, warum die Berechtigung abgelehnt wurde |2171| `message` | Nur für `"deny"`: Teilt Claude mit, warum die Berechtigung abgelehnt wurde |

2172| `interrupt` | Nur für `"deny"`: Bei `true` wird Claude gestoppt |2172| `interrupt` | Nur für `"deny"`: Bei `true` wird Claude gestoppt |

hooks-guide.md +4 −14

Details

421 421 

422Überspringen Sie den Genehmigungsdialog für Tool-Aufrufe, die Sie immer erlauben. Dieses Beispiel genehmigt automatisch `ExitPlanMode`, das Tool, das Claude aufruft, wenn es die Präsentation eines Plans abgeschlossen hat und fragt, ob es fortfahren soll, sodass Sie nicht jedes Mal gefragt werden, wenn ein Plan fertig ist.422Überspringen Sie den Genehmigungsdialog für Tool-Aufrufe, die Sie immer erlauben. Dieses Beispiel genehmigt automatisch `ExitPlanMode`, das Tool, das Claude aufruft, wenn es die Präsentation eines Plans abgeschlossen hat und fragt, ob es fortfahren soll, sodass Sie nicht jedes Mal gefragt werden, wenn ein Plan fertig ist.

423 423 

424Anders als bei den obigen Exit-Code-Beispielen muss Ihr Hook für die automatische Genehmigung eine JSON-Entscheidung auf stdout schreiben. Claude Code führt `PermissionRequest`-Hooks aus, wenn es Sie gleich um eine Berechtigung bitten würde, und wenn Ihr Hook `"behavior": "allow"` zurückgibt, beantwortet Claude Code die Anfrage in Ihrem Namen.424Anders als bei den obigen Exit-Code-Beispielen muss Ihr Hook für die automatische Genehmigung eine JSON-Entscheidung auf stdout schreiben. Claude Code führt `PermissionRequest`-Hooks aus, wenn es Sie gleich um eine Berechtigung bitten würde, und wenn Ihr Hook `"behavior": "allow"` zurückgibt, beantwortet Claude Code die Anfrage in Ihrem Namen. Bei einem Tool, das [eine Benutzerinteraktion erfordert](https://code.claude.com/docs/de/hooks.md#allow-with-updatedinput), wie etwa `ExitPlanMode`, benötigt die Erlaubnis zusätzlich `updatedInput`, andernfalls ignoriert Claude Code sie und zeigt die Abfrage trotzdem an.

425 425 

426Der Matcher beschränkt den Hook ausschließlich auf `ExitPlanMode`, sodass keine anderen Abfragen betroffen sind. Fügen Sie Folgendes zu `~/.claude/settings.json` hinzu:426Der Matcher beschränkt den Hook ausschließlich auf `ExitPlanMode`, sodass keine anderen Abfragen betroffen sind. Fügen Sie Folgendes zu `~/.claude/settings.json` hinzu:

427 427 


434 "hooks": [434 "hooks": [

435 {435 {

436 "type": "command",436 "type": "command",

437 "command": "echo '{\"hookSpecificOutput\": {\"hookEventName\": \"PermissionRequest\", \"decision\": {\"behavior\": \"allow\"}}}'"437 "command": "jq -c '{hookSpecificOutput: {hookEventName: \"PermissionRequest\", decision: {behavior: \"allow\", updatedInput: .tool_input}}}'"

438 }438 }

439 ]439 ]

440 }440 }


453>453>

454> Claude Code speichert ihn nie als `defaultMode`.454> Claude Code speichert ihn nie als `defaultMode`.

455 455 

456Um die Sitzung auf `acceptEdits` umzuschalten, schreibt Ihr Hook dieses JSON auf stdout:456Um die Sitzung auf `acceptEdits` umzuschalten, ersetzen Sie die `command`-Zeile in diesem Hook durch die folgende:

457 457 

458```json theme={null}458```json theme={null}

459{459"command": "jq -c '{hookSpecificOutput: {hookEventName: \"PermissionRequest\", decision: {behavior: \"allow\", updatedInput: .tool_input, updatedPermissions: [{type: \"setMode\", mode: \"acceptEdits\", destination: \"session\"}]}}}'"

460 "hookSpecificOutput": {

461 "hookEventName": "PermissionRequest",

462 "decision": {

463 "behavior": "allow",

464 "updatedPermissions": [

465 { "type": "setMode", "mode": "acceptEdits", "destination": "session" }

466 ]

467 }

468 }

469}

470```460```

471 461 

472Halten Sie den Matcher so eng wie möglich. Ein Matching auf `.*` oder ein leerer Matcher würde jede Berechtigungsabfrage für Tools automatisch genehmigen, einschließlich Dateischreibvorgängen und Shell-Befehlen. Den vollständigen Satz an Entscheidungsfeldern finden Sie in der [PermissionRequest-Referenz](https://code.claude.com/docs/de/hooks.md#permissionrequest-decision-control).462Halten Sie den Matcher so eng wie möglich. Ein Matching auf `.*` oder ein leerer Matcher würde jede Berechtigungsabfrage für Tools automatisch genehmigen, einschließlich Dateischreibvorgängen und Shell-Befehlen. Den vollständigen Satz an Entscheidungsfeldern finden Sie in der [PermissionRequest-Referenz](https://code.claude.com/docs/de/hooks.md#permissionrequest-decision-control).

mcp.md +6 −4

Details

252 252 

253Die Statuse in dieser Liste melden eine Konfigurationsentscheidung statt eines Verbindungsversuchs, daher gibt Claude Code sie aus, ohne sich mit dem Server zu verbinden:253Die Statuse in dieser Liste melden eine Konfigurationsentscheidung statt eines Verbindungsversuchs, daher gibt Claude Code sie aus, ohne sich mit dem Server zu verbinden:

254 254 

255* ``⏸ Pending approval (run `claude` to approve)``: ein Server mit Projekt-Geltungsbereich aus `.mcp.json`, den Sie noch nicht genehmigt haben. Claude Code zeigt ihn sowohl in `claude mcp list` als auch in `claude mcp get <name>` an. Führen Sie `claude` interaktiv aus, um ihn zu prüfen und zu genehmigen.255* ``⏸ Pending approval (run `claude` to approve)``: ein projektbezogener Server aus `.mcp.json`, den Sie noch nicht genehmigt haben. Claude Code zeigt ihn sowohl in `claude mcp list` als auch in `claude mcp get <name>` an. Führen Sie `claude` interaktiv aus, um ihn zu prüfen und zu genehmigen.

256* `✘ Rejected (see disabledMcpjsonServers in settings)`: ein `.mcp.json`-Server, den ein [`disabledMcpjsonServers`](https://code.claude.com/docs/de/settings-reference#disabledmcpjsonservers)-Eintrag ablehnt. Claude Code zeigt ihn nur in `claude mcp get <name>`.256* `✘ Rejected (see disabledMcpjsonServers in settings)`: ein `.mcp.json`-Server, den ein [`disabledMcpjsonServers`](https://code.claude.com/docs/de/settings-reference#disabledmcpjsonservers)-Eintrag ablehnt. Claude Code zeigt ihn nur in `claude mcp get <name>`.

257* `⊘ Disabled for this project (re-enable via /mcp)`: ein Server, den die [`disabledMcpServers`](#disable-a-server-without-removing-it)-Liste des Projekts nennt. Claude Code zeigt ihn sowohl in `claude mcp list` als auch in `claude mcp get <name>`. Schalten Sie den Server über das `/mcp`-Panel wieder ein.257* `⊘ Disabled for this project (re-enable via /mcp)`: ein Server, den die [`disabledMcpServers`](#disable-a-server-without-removing-it)-Liste des Projekts nennt. Claude Code zeigt ihn sowohl in `claude mcp list` als auch in `claude mcp get <name>`. Schalten Sie den Server über das `/mcp`-Panel wieder ein.

258* `✘ Blocked by enterprise managed policy`: ein Server, den eine der Richtlinien Ihrer Organisation ablehnt. Claude Code zeigt ihn sowohl in `claude mcp list` als auch in `claude mcp get <name>` an. Ein Server, der durch eine Allowlist, eine Denylist oder eine andere Einschränkung in der [verwalteten MCP-Konfiguration](https://code.claude.com/docs/de/managed-mcp.md#how-restrictions-appear-to-users) blockiert wird, ist in beiden Befehlen ausgeblendet, statt mit diesem Status angezeigt zu werden. Fragen Sie Ihren Administrator, welche Richtlinie den Server blockiert.258* `✘ Blocked by enterprise managed policy`: ein Server, den eine der Richtlinien Ihrer Organisation ablehnt. Claude Code zeigt ihn sowohl in `claude mcp list` als auch in `claude mcp get <name>` an. Ein Server, der durch eine Allowlist, eine Denylist oder eine andere Einschränkung in der [verwalteten MCP-Konfiguration](https://code.claude.com/docs/de/managed-mcp.md#how-restrictions-appear-to-users) blockiert wird, ist in beiden Befehlen ausgeblendet, statt mit diesem Status angezeigt zu werden. Fragen Sie Ihren Administrator, welche Richtlinie den Server blockiert.


596 596 

597#### Den Aufruf mit einem Task beantworten597#### Den Aufruf mit einem Task beantworten

598 598 

599Antworten Sie nur dann mit einem Task, wenn die Anfrage die Erweiterung enthält, sonst erhält Claude den Tool-Fehler `Unsupported result type 'task' for tools/call`. Claude erhält denselben Fehler, wenn `taskId`, `status`, `createdAt`, `lastUpdatedAt` oder `ttlMs` fehlt. Das Task-Objekt ist das JSON-RPC-`result` Ihrer `tools/call`-Antwort, benötigt kein `content`-Array und enthält hier die optionalen Felder `statusMessage` und `pollIntervalMs`:599Antworten Sie nur dann mit einer Aufgabe, wenn die Anfrage die Erweiterung enthält, andernfalls schlägt der Aufruf mit dem Tool-Fehler `Unsupported result type 'task' for tools/call` fehl. Der Aufruf schlägt auf die gleiche Weise fehl, wenn Ihre Antwort keine `taskId` oder keinen gültigen `status` hat. Das Aufgabenobjekt ist das JSON-RPC-`result` Ihrer `tools/call`-Antwort, benötigt kein `content`-Array und enthält hier die optionalen Felder `statusMessage` und `pollIntervalMs`:

600 600 

601```json theme={null}601```json theme={null}

602{602{


616| `resultType` | Setzen Sie es auf `"task"`, um die Antwort als Task zu kennzeichnen. Ohne das Feld liest Claude Code die Antwort als gewöhnliches Ergebnis |616| `resultType` | Setzen Sie es auf `"task"`, um die Antwort als Task zu kennzeichnen. Ohne das Feld liest Claude Code die Antwort als gewöhnliches Ergebnis |

617| `taskId` | Erforderlich. Höchstens 128 druckbare ASCII-Zeichen ohne Leerzeichen, sonst erhält Claude einen Tool-Fehler, der mit `MCP server "<name>" returned a malformed task handle for tool "<tool>"` beginnt. Halten Sie die ID über Verbindungen hinweg beantwortbar, da Claude Code nach einem Fortsetzen über eine neue Verbindung danach fragt |617| `taskId` | Erforderlich. Höchstens 128 druckbare ASCII-Zeichen ohne Leerzeichen, sonst erhält Claude einen Tool-Fehler, der mit `MCP server "<name>" returned a malformed task handle for tool "<tool>"` beginnt. Halten Sie die ID über Verbindungen hinweg beantwortbar, da Claude Code nach einem Fortsetzen über eine neue Verbindung danach fragt |

618| `status` | Erforderlich. Einer der Werte `working`, `input_required`, `completed`, `failed` oder `cancelled`. Ein anderer Wert führt zum Fehler `Unsupported result type` |618| `status` | Erforderlich. Einer der Werte `working`, `input_required`, `completed`, `failed` oder `cancelled`. Ein anderer Wert führt zum Fehler `Unsupported result type` |

619| `createdAt`, `lastUpdatedAt`, `ttlMs` | Erforderlich, wobei `ttlMs` `null` sein darf. Claude Code verwirft einen Task nicht, weil seine `ttlMs` abgelaufen ist |619| `createdAt`, `lastUpdatedAt`, `ttlMs` | Von der Tasks-Erweiterung verlangt, und `ttlMs` darf `null` sein. Claude Code verwirft eine Aufgabe nicht, weil ihr `ttlMs` abgelaufen ist |

620| `pollIntervalMs` | Optional, aber nicht `null`. Millisekunden zwischen `tasks/get`-Anfragen, begrenzt auf 250 bis 30000. Claude Code verwendet 2000, wenn das Feld fehlt, und liest den Wert aus jeder `tasks/get`-Antwort erneut |620| `pollIntervalMs` | Optional. Millisekunden zwischen `tasks/get`-Anfragen, begrenzt auf einen Bereich von 250 bis 30000. Claude Code verwendet 2000, wenn das Feld fehlt oder `null` ist, und liest den Wert aus jeder `tasks/get`-Antwort erneut |

621| `statusMessage` | Optional. `/tasks` zeigt den Wert aus Ihrer neuesten `tasks/get`-Antwort an, nicht aus dieser ersten, und eine Antwort ohne das Feld leert ihn. Eine [Statusmeldung von Claude Code](#status-messages-on-an-mcp-task) kann an seine Stelle treten |621| `statusMessage` | Optional. `/tasks` zeigt den Wert aus Ihrer neuesten `tasks/get`-Antwort an, nicht aus dieser ersten, und eine Antwort ohne das Feld leert ihn. Eine [Statusmeldung von Claude Code](#status-messages-on-an-mcp-task) kann an seine Stelle treten |

622 622 

623Claude Code akzeptiert eine Aufgabenantwort, die `createdAt`, `lastUpdatedAt` oder `ttlMs` weglässt oder `pollIntervalMs` auf `null` setzt. Vor v2.1.317 schlug der Aufruf stattdessen mit dem Fehler `Unsupported result type` fehl. Um auch mit diesen Versionen zu funktionieren, senden Sie die drei Felder, die die Tasks-Erweiterung verlangt, und senden Sie `pollIntervalMs` als Zahl oder gar nicht.

624 

623Bei einem HTTP- oder claude.ai-Konnektor-Server muss die Task-Antwort innerhalb des [Timers pro Anfrage](#time-limits-on-mcp-tool-calls) beginnen. Nehmen Sie daher den Auftrag an und antworten Sie zuerst, und erledigen Sie dann die Arbeit.625Bei einem HTTP- oder claude.ai-Konnektor-Server muss die Task-Antwort innerhalb des [Timers pro Anfrage](#time-limits-on-mcp-tool-calls) beginnen. Nehmen Sie daher den Auftrag an und antworten Sie zuerst, und erledigen Sie dann die Arbeit.

624 626 

625#### Status, Ergebnisse und Fragen melden627#### Status, Ergebnisse und Fragen melden

sandboxing.md +1 −0

Details

41 41 

42* **Integrierte Datei- und Web-Tools**: Tools wie Read, Edit, Write, WebFetch und WebSearch folgen stattdessen [Berechtigungsregeln](https://code.claude.com/docs/de/permissions.md). Ein `denyRead`-Eintrag hält das Read-Tool nicht auf, und `allowedDomains` schränkt WebFetch nicht ein42* **Integrierte Datei- und Web-Tools**: Tools wie Read, Edit, Write, WebFetch und WebSearch folgen stattdessen [Berechtigungsregeln](https://code.claude.com/docs/de/permissions.md). Ein `denyRead`-Eintrag hält das Read-Tool nicht auf, und `allowedDomains` schränkt WebFetch nicht ein

43* **Andere Prozesse, die Claude Code startet**: Befehls-[Hooks](https://code.claude.com/docs/de/hooks.md), lokale [MCP-Server](https://code.claude.com/docs/de/mcp.md), [Plugin-Monitore](https://code.claude.com/docs/de/plugins/components.md#monitors), [LSP-Server](https://code.claude.com/docs/de/tools-reference.md#lsp-tool-behavior) und Hilfsbefehle wie Ihr [Statuszeilen](https://code.claude.com/docs/de/statusline.md)-Befehl und `apiKeyHelper` laufen mit Ihrem vollen Zugriff43* **Andere Prozesse, die Claude Code startet**: Befehls-[Hooks](https://code.claude.com/docs/de/hooks.md), lokale [MCP-Server](https://code.claude.com/docs/de/mcp.md), [Plugin-Monitore](https://code.claude.com/docs/de/plugins/components.md#monitors), [LSP-Server](https://code.claude.com/docs/de/tools-reference.md#lsp-tool-behavior) und Hilfsbefehle wie Ihr [Statuszeilen](https://code.claude.com/docs/de/statusline.md)-Befehl und `apiKeyHelper` laufen mit Ihrem vollen Zugriff

44* **Mods**: Ein [Mod](https://code.claude.com/docs/de/plugins/mods/overview.md) führt eigenen Code innerhalb von Claude Code aus, daher laufen seine Dateizugriffe, Netzwerkanfragen und mit [`$.process`](https://code.claude.com/docs/de/plugins/mods/api#reach-files-processes-and-the-network) gestartete Programme nicht in einer Sandbox. Siehe [Worauf ein Mod zugreifen kann](https://code.claude.com/docs/de/plugins/mods/overview.md#what-a-mod-can-reach)

44 45 

45Einige Shell-Befehle laufen je nach Ihren Einstellungen ebenfalls außerhalb der Sandbox:46Einige Shell-Befehle laufen je nach Ihren Einstellungen ebenfalls außerhalb der Sandbox:

46 47 

setup.md +5 −5

Details

40>40>

41> **macOS, Linux, WSL:**41> **macOS, Linux, WSL:**

42>42>

43> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}43> ```bash theme={null}

44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash

45> ```45> ```

46>46>


48>48>

49> **Windows PowerShell:**49> **Windows PowerShell:**

50>50>

51> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}51> ```powershell theme={null}

52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex

53> ```53> ```

54>54>

55> **Windows CMD:**55> **Windows CMD:**

56>56>

57> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}57> ```batch theme={null}

58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

59> ```59> ```

60>60>


72 72 

73> [tab] Homebrew73> [tab] Homebrew

74>74>

75> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}75> ```bash theme={null}

76> brew install --cask claude-code76> brew install --cask claude-code

77> ```77> ```

78>78>


84 84 

85> [tab] WinGet85> [tab] WinGet

86>86>

87> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}87> ```powershell theme={null}

88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode

89> ```89> ```

90>90>