> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Local Hands für Devin-Cloud-Sitzungen

> Lassen Sie eine Devin-Cloud-Sitzung über Devin Desktop oder devin connect Befehle ausführen und Dateien auf Ihrem eigenen Computer bearbeiten – mit Ihrer Genehmigung für jeden Tool-Aufruf.

Local Hands (Zugriff auf den lokalen Rechner) ermöglichen es einer Devin-Cloud-Sitzung, Befehle auszuführen und mit Dateien auf Ihrem eigenen Computer zu arbeiten. Setzen Sie sie ein, wenn die Aufgabe etwas erfordert, das nur auf Ihrem Rechner vorhanden ist: einen lokalen Checkout mit nicht committeten Änderungen, ein Gerät in Ihrem Netzwerk, ein Tool, das Ihr VPN benötigt, oder Logs eines lokalen Builds.

Ihr Computer ersetzt nicht die VM der Sitzung. Devin behält seine VM und erhält zusätzlich einen zweiten Satz Tools, die auf Ihrem Rechner laufen. Die beiden Maschinen haben getrennte Dateien, Arbeitsverzeichnisse und Umgebungen; Devin überträgt Daten zwischen ihnen nur über Tool-Aufrufe, die Sie genehmigen, etwa das Kopieren einer Datei.

> [!NOTE]
>
> Local Hands werden schrittweise eingeführt. Wenn Sie die Einstellung **Local Hands** nicht sehen, ist die Funktion für Ihre Organisation noch nicht verfügbar.

> [!NOTE]
>
> **Local Hands** ist der Name der Funktion; auf der Zugriffskarte und in den Toasts heißt sie **Zugriff auf den lokalen Rechner**. Im Sitzungs-Header wird ein verbundener Rechner als **Local Hands** angezeigt. Local Hands sind nicht zu verwechseln mit [Devin Connect](/de/enterprise/deployment/devin-connect), das Devin Zugriff auf private Netzwerke gewährt.

## So funktioniert es

**1. Devin fordert Zugriff an**

Wenn für eine Aufgabe Ihre Maschine benötigt wird, postet Devin in der Sitzung eine Karte **Local machine access requested**. Die Karte nennt den Grund und den Zeitpunkt, zu dem die Anfrage abläuft. In Devin Desktop enthält sie eine Schaltfläche **Approve**, im Browser einen `devin connect`-Befehl mit einem Kopplungscode. Sie können dies auch direkt anfordern, zum Beispiel mit „run the tests on my local machine“.

**2. Sie verbinden Ihre Maschine**

Genehmigen Sie die Anfrage auf der Maschine, die Devin verwenden soll: Klicken Sie in Devin Desktop auf **Approve**, oder führen Sie `devin connect` in einem Terminal aus. Siehe [Maschine verbinden](#connect-your-machine).

**3. Devin verwendet die lokalen Tools**

Die lokalen Tools von Devin stehen nun zur Verfügung, und im Header erscheint der Chip **Local Hands**. Sie genehmigen jeden Tool-Aufruf einzeln, sofern Sie nicht die [Umgehung](#bypass-local-permissions) aktivieren.

**4. Die Verbindung endet**

Die Verbindung endet, wenn Sie den Zugriff widerrufen, `devin connect` beenden, das Devin-Desktop-Fenster schließen, in dem die Anfrage genehmigt wurde, oder wenn die Sitzung endet. Die lokalen Tools stehen dann nicht mehr zur Verfügung.

## Voraussetzungen

* Eine Cloud-Sitzung, deren Eigentümer Sie sind. Devin stellt den Kopplungscode für das Konto des Sitzungseigentümers aus, sodass andere Personen, die die Sitzung ansehen, ihre Maschine nicht verbinden können. Sitzungen ohne Nutzer, der den Zugriff genehmigen kann – etwa geplante Sitzungen, Automatisierungen und API-Sitzungen, die von einem Service-Benutzer ausgeführt werden –, können keine Maschine anfordern.
* Die [Devin CLI](/de/cli) oder [Devin Desktop](/de/desktop/introducing-devin-desktop) auf der zu verbindenden Maschine, angemeldet mit demselben Devin-Konto, dem die Sitzung gehört. Führen Sie für die CLI `devin auth login` aus.
* Die Einstellung **Local Hands** ist für Ihre Organisation aktiviert. Siehe [Verfügbarkeit](#availability).

## Ihre Maschine verbinden

Am einfachsten geht es mit Devin Desktop: Öffnen Sie dort die Sitzung und klicken Sie auf **Approve**. Wenn Sie im Browser arbeiten, führen Sie den Befehl `devin connect` aus der Karte in einem Terminal auf der Maschine aus, die Sie verbinden möchten.

Eine Anfrage ist nur einmal verwendbar (single-use) und läuft 10 Minuten, nachdem Devin sie gestellt hat, ab. Eine neue Anfrage ersetzt eine ältere, und der ältere Kopplungscode ist dann nicht mehr gültig.

**Devin Desktop**

Öffnen Sie die Sitzung in Devin Desktop. Auf der Karte werden **Approve** und **Decline** angezeigt. Klicken Sie auf **Approve**, um die Maschine zu verbinden, auf der Devin Desktop läuft. Sie benötigen weder einen Kopplungscode noch ein Terminal. Wenn Sie die CLI bevorzugen, klicken Sie auf **Use the terminal instead**, um den Befehl anzuzeigen.

**Terminal**

Kopieren Sie den Befehl aus der Karte und führen Sie ihn auf der Maschine aus, die Sie verbinden möchten:

```bash theme={null}
devin connect <CODE>
```

Mit dem Ausführen des Befehls erteilen Sie die Genehmigung. Eine weitere Bestätigung ist nicht erforderlich. Der Befehl läuft im Vordergrund, gibt jeden Tool-Aufruf von Devin aus und hält die Verbindung offen, bis die Sitzung endet oder Sie `Ctrl+C` drücken.

**devin --cloud**

Bei einer Cloud-Sitzung, die Sie mit [`devin --cloud`](/de/cli/cloud) gestartet haben, wird die Maschine des Terminals automatisch verbunden, sobald Devin Zugriff anfordert. Jeder Tool-Aufruf erfordert jedoch weiterhin Ihre Genehmigung.

Ist die Anfrage abgelaufen, klicken Sie in Devin Desktop auf der Karte auf **Connect this machine** oder im Browser auf **Request a new code**.

### Sichtbarkeit der Sitzung

Wenn Sie eine Maschine mit einer Sitzung verbinden, die Ihnen gehört, stellt Devin die Sitzung auf privat: Nur Sie können ihr Nachrichten senden. So wird verhindert, dass andere Personen in Ihrer Organisation eine Sitzung steuern, die Befehle auf Ihrem Computer ausführen kann.

Um die Sichtbarkeit der Sitzung unverändert zu lassen, übergeben Sie `--public`:

```bash theme={null}
devin connect --public <CODE>
```

## Was Devin auf Ihrer Maschine tun kann

Devin kann Shell-Befehle ausführen, Dateien lesen und durchsuchen, Dateien erstellen und bearbeiten sowie Dateien zwischen Ihrer Maschine und der VM der Sitzung kopieren. Bildschirm, Tastatur und Maus Ihrer Maschine kann Devin nicht steuern. [Computer Use](/de/work-with-devin/computer-use) bezieht sich ausschließlich auf die VM der Sitzung.

## Genehmigungen

Standardmäßig wird jeder lokale Tool-Aufruf angehalten und Sie werden um Bestätigung gebeten. Die Sitzung zeigt das Tool und seine Argumente mit drei Optionen an:

* **Allow once**: Diesen Aufruf ausführen.
* **Allow for this session**: Diesen Aufruf und alle weiteren Aufrufe desselben Tools ohne Nachfrage ausführen, bis die Verbindung zur Maschine getrennt wird.
* **Deny**: Diesen Aufruf ablehnen. Devin erkennt die Ablehnung und kann einen anderen Ansatz versuchen.

Ihre [Berechtigungsregeln](/de/cli/reference/permissions) der Devin CLI gelten auch für lokale Tool-Aufrufe. Eine `allow`-Regel führt einen passenden Aufruf ohne Nachfrage aus, eine `deny`-Regel blockiert ihn, und bei einer `ask`-Regel wird jedes Mal nachgefragt. Dazu gehören auch Regeln, die Ihre Organisation in den [Team Settings](/de/cli/enterprise/team-settings) festlegt.

### Lokale Berechtigungen umgehen

Um die Bestätigungsabfrage bei jedem einzelnen Aufruf abzuschalten, klicken Sie auf der Zugriffskarte oder im Menü **Local Hands** auf **Bypass local permissions**. Lokale Tool-Aufrufe werden dann ohne Rückfrage ausgeführt, bis die Verbindung zur Maschine getrennt wird. Ausstehende Anfragen werden sofort genehmigt.

Damit jede Verbindung im Umgehungsmodus startet, setzen Sie [`local_tools_bypass_permissions`](/de/cli/reference/configuration/config-file#local_tools_bypass_permissions-user-only) in Ihrer Devin CLI-Konfiguration. Wenn Sie die Umgehung in der Sitzung aktivieren oder deaktivieren, aktualisiert die CLI diese Einstellung.

> [!WARNING]
>
> Bei aktivierter Umgehung kann Devin ohne Rückfrage Befehle ausführen und Dateien auf Ihrem Computer ändern. Verwenden Sie sie nur für Sitzungen und Aufgaben, denen Sie vertrauen.

### Aufrufe, die immer eine Genehmigung erfordern

Integrierte Regeln sorgen dafür, dass bestimmte Aufrufe jedes Mal eine Genehmigung erfordern, selbst wenn die Umgehung aktiviert ist. Auch **Allow for this session** und Ihre eigenen `allow`-Regeln genehmigen diese Aufrufe nicht. Betroffen sind Dateien mit Anmeldedaten und private Schlüssel, Rechteausweitung, destruktive Befehle, Shell-Interpreter, Secret-Speicher sowie Schreibzugriffe auf Shell-Profile und die Git-Konfiguration. Die Genehmigungskarte gibt an, warum ein Aufruf eine ausdrückliche Genehmigung erfordert. Für Ihre `ask`-Regeln und die `ask`-Regeln Ihrer Organisation gilt dasselbe.

## Verbindung trennen oder Zugriff widerrufen

* **Zugriff widerrufen**: Klicken Sie auf der Zugriffskarte oder im Menü **Local Hands** auf **Zugriff widerrufen**. Devin verliert sofort den Zugriff auf die lokalen tools.
* **CLI beenden**: Drücken Sie `Ctrl+C` in dem Terminal, in dem `devin connect` läuft.
* **Devin Desktop schließen**: Die Verbindung endet, wenn Sie das Devin Desktop-Fenster schließen, in dem die Anfrage genehmigt wurde, oder Devin Desktop beenden.
* **Sitzung beenden**: Die Verbindung wird getrennt, sobald die Sitzung endet.

`devin connect` stellt die Verbindung nach einer kurzen Netzwerkunterbrechung selbstständig wieder her. Bleibt die Maschine offline oder beenden Sie den Befehl, zeigt der Chip die Maschine als getrennt an. Um die Verbindung wiederherzustellen, bitten Sie Devin, erneut Zugriff anzufordern, und verwenden Sie den neuen Code.

## Verfügbarkeit

Organisationsadministratoren steuern diese Funktion über den Schalter **Local Hands** unter [**Settings > Devin**](https://app.devin.ai/settings/devin). Bei Organisationen, die keinem Enterprise angehören, ist der Schalter standardmäßig aktiviert, bei Organisationen innerhalb eines Enterprise standardmäßig deaktiviert.

Local Hands sind nicht verfügbar, wenn:

* die Sitzung ein [Security Profile](/de/product-guides/security-profiles) verwendet.
* [native Bereitstellungen](/de/product-guides/deployment-capabilities) für Ihre Organisation deaktiviert sind.
* die Sitzung keinen Nutzer hat, der den Zugriff genehmigen kann (geplante Sitzungen, Automatisierungen und API-Sitzungen über einen service-user).

## Fehlerbehebung

| Symptom | Vorgehensweise |
| - | - |
| Die Karte meldet, dass die Anfrage abgelaufen ist | Klicken Sie auf **Request a new code** (oder in Devin Desktop auf **Connect this machine**) |
| Die Karte meldet, dass diese Anfrage durch eine neuere ersetzt wurde | Verwenden Sie den Befehl auf der neuesten Karte |
| Devin Desktop fordert Sie auf, sich auf dieser Maschine anzumelden | Melden Sie sich in Devin Desktop bei Devin an oder führen Sie den Befehl `devin connect` in einem Terminal aus |
| `devin connect` meldet, dass lokale tools ein Devin-Konto erfordern | Führen Sie `devin auth login` aus und melden Sie sich mit Devin an |
| Die Karte zeigt im Browser keine Schaltfläche **Approve** an | Ein Browser kann keine tools auf Ihrer Maschine ausführen. Führen Sie den Befehl `devin connect` in einem Terminal aus oder öffnen Sie die Sitzung in Devin Desktop. |
| Ein Aufruf fragt erneut nach, obwohl Sie die Umgehung aktiviert haben | Es handelt sich um einen der [Aufrufe, die immer nachfragen](#calls-that-always-ask) |

## Weitere Ressourcen

> **[Devin Cloud in der CLI](/de/cli/cloud)**
>
> Cloud-Sitzungen direkt aus Ihrem Terminal starten und steuern

> **[CLI-Berechtigungen](/de/cli/reference/permissions)**
>
> allow-, ask- und deny-Regeln für Tool-Aufrufe festlegen

> **[An Cloud-Devins übergeben](/de/work-with-devin/devin-handoff)**
>
> Eine lokale Aufgabe in eine Cloud-Sitzung verlagern

> **[Computer Use](/de/work-with-devin/computer-use)**
>
> Wie Devin den Desktop seiner eigenen VM verwendet


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.