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

# Devin Local

> Nutzen Sie den Devin Local Agent in Devin Desktop: das Agenten-Framework der Devin CLI mit Subagents, Sandboxing, Planungsmodus, Worktrees und Berechtigungen.

Devin Local ist unser Agenten-Framework der nächsten Generation, das auch [Devin CLI](https://cli.devin.ai) zugrunde liegt.

Es läuft auf Ihrer Maschine, hat Zugriff auf Ihre lokalen Dateien, Tools und Ihre Umgebung und ist der primäre lokale Agent für Devin Desktop.

> [card] [Modi](https://docs.devin.ai/de/desktop/devin-local/modes.md)
>
> Code, Intelligent, Ask, Plan und Bypass Permissions sowie Planen vor der Implementierung.

> [card] [Anpassungen](https://docs.devin.ai/de/desktop/devin-local/customizations.md)
>
> Plugins, Fähigkeiten, MCP-Server, Hooks und Regeln sowie die Oberfläche, die anzeigt, was eine Sitzung geladen hat.

> [card] [Berechtigungen](https://docs.devin.ai/de/desktop/devin-local/permissions.md)
>
> Allow-, Ask- und Sperrregeln, Genehmigungsanfragen und Berechtigungen für MCP-Tools.

> [card] [Worktrees](https://docs.devin.ai/de/desktop/devin-local/worktrees.md)
>
> Sitzungen in einem Git-Worktree ausführen und die Änderungen zurück in Ihren Workspace mergen.

## Wichtige Funktionen

### Token-Effizienz

Der Devin Local Agent ist auf Prompt-Caching ausgelegt, sodass die meisten Aufgaben für dasselbe Ergebnis weniger Tokens verwenden.

### Subagents

Der Devin Local Agent kann unabhängige [Subagents](https://docs.devin.ai/de/cli/subagents.md) starten, die Teilaufgaben bearbeiten – entweder im Vordergrund oder im Hintergrund. Subagents nutzen dieselben Tools und denselben Codebasis-Kontext wie der übergeordnete Agent, arbeiten jedoch in einer eigenen Unterhaltungskette.

Subagents werden über den Schalter **Subagents (Preview)** in `Devin Settings` gesteuert.

Neben den integrierten Profilen können Sie eigene Subagents als Markdown-Dateien unter `agents/` definieren. Dafür stehen zwei Varianten des Aufbaus zur Verfügung:

* **Einzelne Datei** – `agents/<name>.md`; der Dateiname wird zum Bezeichner des Profils.
* **Verzeichnis** – `agents/<name>/AGENT.md`; der Verzeichnisname wird zum Bezeichner des Profils.

In der [Subagents-Dokumentation](https://docs.devin.ai/de/cli/subagents.md) erfahren Sie, wo diese Verzeichnisse erkannt werden und wie Sie ein Profil konfigurieren.

### Sandboxing

Der Devin Local Agent unterstützt Sandboxing auf Betriebssystemebene. Ist es aktiviert, erzwingt die Sandbox Folgendes:

* **Dateisystem-Isolation** — beschreibbare Pfade werden aus Ihren [Berechtigungsbereichen](https://docs.devin.ai/de/desktop/devin-local/permissions.md) abgeleitet, und `Read(...)`-Sperrregeln verbergen Pfade vor Befehlen, die in der Sandbox ausgeführt werden
* **Netzwerkfilterung** — Zulassungs- und Sperrlisten für Domänen legen fest, welche Ziele der Agent erreichen kann

Enterprise-Admins können das Sandbox-Verhalten über die [Teameinstellungen](https://cli.devin.ai/docs/enterprise/team-settings#sandbox-enforcement) organisationsweit erzwingen – etwa indem sie den Sandbox-Modus für alle Nutzer vorschreiben und organisationsweite Regeln zur Domänenfilterung konfigurieren.

### Quick Review

[Quick Review](https://docs.devin.ai/de/desktop/quick-review.md) ist ein eigener Subagent im Devin Local Agent, der Ihnen schnelles Feedback zu Ihren Änderungen gibt.

## Agent wechseln

Neue Registerkarten starten mit Devin Local, sofern Sie keinen bevorzugten Agent ausgewählt haben. Ist Devin Local für Sie nicht verfügbar, verwendet die Registerkarte stattdessen den ersten auswählbaren [ACP-Agent](https://docs.devin.ai/de/desktop/acp.md). Ist gar kein Agent verfügbar, zeigt sie die Standard-UI für neue Registerkarten an und wartet, bis ein Agent verfügbar ist. Den Agent für *neue* Unterhaltungen können Sie jederzeit über die Agentenauswahl unten rechts in Devin Desktop ändern. Devin Local lässt sich auch dann auswählen, wenn die Verbindung noch hergestellt wird.

![](https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-switcher.png?fit=max\&auto=format\&n=WE51TvKjsiyk1ZHl\&q=85\&s=5206df1ec64b71ae0463d56f7453aff3)

### Agent-Einstellungen

Wenn Devin Local nicht in der Agentenauswahl angezeigt wird, müssen Sie es möglicherweise in den `Devin Settings` aktivieren:

1. Öffnen Sie die Befehlspalette mit `Cmd+Shift+P` (macOS) oder `Ctrl+Shift+P` (Windows/Linux)
2. Öffnen Sie `Devin User Settings`
3. Klicken Sie auf die Registerkarte „Agents“
4. Aktivieren Sie den Schalter für den Agenten „Devin Local“
5. Starten Sie Devin Desktop neu

![](https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-settings.png?fit=max\&auto=format\&n=WE51TvKjsiyk1ZHl\&q=85\&s=b0f42c5d3d679c55c450fd9067c34303)

### Enterprise-Admins

Devin Local ist ein gebündelter Agent, den Devin Desktop vom Server abruft. Ob er in der Agentenauswahl angezeigt wird, steuert die Teameinstellung **Devin Local Agent**:

* In **Team**- und anderen Non-Enterprise-Tarifen ist er standardmäßig verfügbar (sofern dieser Zugriff nicht für ein einzelnes Mitglied deaktiviert wurde).
* In **Enterprise**-Tarifen ist er standardmäßig aktiviert; ein Administrator kann ihn für Mitglieder deaktivieren.

Enterprise-Admins verwalten diese Einstellung im Dashboard der Teameinstellungen:

* **Devin Enterprise-Admins** — **Settings → Enterprise → Devin Desktop** (`app.devin.ai/org/{orgName}/settings/desktop`). Verwenden Sie unter **Features** den Schalter **Devin Local Agent** („Allow members to use the Devin Local agent in Devin Desktop and delegate tasks to Devin's terminal agent via ACP“).
* **Windsurf Enterprise-Admins** — das [Windsurf-Dashboard](https://windsurf.com/team/settings).

Ist diese Einstellung aktiviert, wird Devin Local allen Mitgliedern nach einem Neustart von Devin Desktop in der Agentenauswahl angezeigt. Eine Einrichtung pro Nutzer oder eine benutzerdefinierte [Konfiguration der ACP-Registrierung](https://docs.devin.ai/de/desktop/acp.md#team-registry-configuration) ist nicht erforderlich.

## Eingeschränkter Modus

Wenn ein Workspace im **eingeschränkten Modus** geöffnet ist, stehen darin keine Agenten zur Verfügung: Devin Local und sämtliche [ACP-Agenten](https://docs.devin.ai/de/desktop/acp.md) sind deaktiviert, und [Hooks](https://docs.devin.ai/de/desktop/devin-local/customizations.md#hooks) werden weder geladen noch ausgeführt.

Agenten stehen wieder zur Verfügung, sobald sich der Workspace nicht mehr im eingeschränkten Modus befindet.

## Teilen von Unterhaltungen

Wählen Sie in Devin Desktop im Aktionsmenü unterhalb einer abgeschlossenen Eingabe **Share conversation**; in der Devin CLI oder einem anderen ACP-Client führen Sie `/share` aus. Der Agent lädt ein bereinigtes Transkript hoch (Secrets geschwärzt, System-Prompts und Tool-Definitionen entfernt) und gibt einen Link zurück, den Sie mit Ihrem Team teilen können. Das Teilen wird nur angeboten, wenn Ihre Organisation Teilen von Unterhaltungen erlaubt, Sie mit einem Devin-Konto angemeldet sind (nicht mit einem reinen Windsurf-Konto) und der Client das Teilen unterstützt.

## Analysen

Aktivitäten von Devin Local werden in der Datenquelle [`cascade_runs`](https://docs.devin.ai/de/desktop/accounts/api-reference/cascade-analytics) (Modellnutzung, gesendete Nachrichten und Credit-Verbrauch), der Datenquelle [`cascade_tool_usage`](https://docs.devin.ai/de/desktop/accounts/api-reference/cascade-analytics) (Anzahl der Aufrufe je Tool, etwa Code Edit, Run Command, Search Web und MCP Tool), der Datenquelle [`cascade_lines`](https://docs.devin.ai/de/desktop/accounts/api-reference/cascade-analytics) (täglich vom Agent geschriebenen Codezeilen) sowie in der [Cascade-Datenquelle](https://docs.devin.ai/de/desktop/accounts/analytics-api#cascade-data) der Custom Analytics API erfasst.

Devin Local erfasst keine vorgeschlagenen Zeilen oder „Modi“: Eine Bearbeitung wird erst nach Ihrer Genehmigung ausgeführt. Daher entsprechen akzeptierte Zeilen den vorgeschlagenen Zeilen, und das Feld `mode` in `cascade_runs` wird nicht befüllt.

Die Devin CLI meldet keine Analysedaten für [hybride Deployments](https://devin.ai/blog/self-hosted-deployment-maintenance-mode).

## Enterprise-Steuerungen

Enterprise-Admins können den Devin Local Agent über [Team Settings](https://windsurf.com/team/settings) konfigurieren, einschließlich [neuer Steuerungsoptionen, die nur mit dem Devin Local Agent verfügbar sind](https://cli.devin.ai/docs/enterprise/team-settings):

* **Sandbox-Erzwingung** - Sandbox-Modus für alle Nutzer vorschreiben und organisationsweite Regeln zur Domainfilterung konfigurieren
* **Granulare Berechtigungen** - Steuern, welche Action der Agent mit detaillierteren Berechtigungen ausführen kann
* **Netzwerkerzwingung** - Den Netzwerkzugriff über zugelassene und blockierte Domains steuern

Die Einstellung der Organisation zum Teilen von Unterhaltungen wird berücksichtigt: Ist das Teilen für die Organisation deaktiviert, bietet der Devin Local Agent weder **Share conversation** noch `/share` an.

Außerdem kann die Steuerung „Enable Cascade“ verwendet werden, um den veralteten Cascade-Agent vollständig zu deaktivieren und sicherzustellen, dass Ihr Team die neuen Steuerungsoptionen nutzt, die mit Devin CLI verfügbar sind.

### Nicht unterstützte Enterprise-Steuerungen

Die folgenden veralteten Enterprise-Steuerungen werden mit dem Devin Local Agent nicht unterstützt:

* **Tool-Aufrufe auf den Workspace beschränken** - Standardmäßig kann der Devin Local Agent Dateien nur innerhalb des Workspace lesen und bearbeiten.
  Benutzerdefinierte [Berechtigungen](https://cli.devin.ai/docs/reference/permissions) sind ein flexiblerer Ersatz, mit dem sich dieselben Regeln nachbilden lassen.
* **Globale Tool-Aufrufe deaktiviert** - Wenn Sie Tool-Aufrufe zuvor vollständig deaktiviert haben, schreiben Sie stattdessen eine entsprechende [Berechtigungsrichtlinie](https://cli.devin.ai/docs/reference/permissions) für die Devin CLI.

Die folgenden veralteten Steuerungen werden weiterhin als Fallback durchgesetzt, wenn Sie noch keine Enterprise-CLI-Berechtigungskonfiguration implementiert haben:

* **Terminal-Befehle automatisch ausführen** - Der Devin Local Agent verwendet sein eigenes [Berechtigungsmodell](https://cli.devin.ai/docs/reference/permissions) anstelle von Stufen für die automatische Ausführung; wir empfehlen, dieses stattdessen zu verwenden, aber die alte Steuerung wird weiterhin als Fallback durchgesetzt.
* **Terminal-Allowlists** - Implementieren Sie eine entsprechende [Berechtigungsrichtlinie](https://cli.devin.ai/docs/reference/permissions) für die Devin CLI, um bestimmte Terminal-Befehle zuzulassen.
* **Terminal-Denylists** - Implementieren Sie eine entsprechende [Berechtigungsrichtlinie](https://cli.devin.ai/docs/reference/permissions) für die Devin CLI, um bestimmte Terminal-Befehle zu blockieren.

## Weiterführende Informationen

* [Devin-CLI-Schnellstart](https://cli.devin.ai/docs)
* [Wichtige Befehle](https://cli.devin.ai/docs/essential-commands)
* [Übersicht zur Erweiterbarkeit](https://cli.devin.ai/docs/extensibility)
* [Teameinstellungen](https://cli.devin.ai/docs/enterprise/team-settings)


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