> ## 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.

# Konfiguration

> So konfigurierst du das Verhalten der Devin CLI mit Konfigurationsdateien

Devin CLI wird über JSON-Dateien (mit Kommentarunterstützung) auf Nutzer- und Projektebene konfiguriert. Diese Konfigurationsdateien steuern das Modell des Agenten, Berechtigungen, MCP-Server und mehr.

***

<div id="config-file-locations">
  ## Speicherorte von Konfigurationsdateien
</div>

<Tabs>
  <Tab title="Nutzerkonfiguration">
    **Pfad:** `~/.config/devin/config.json`

    Ihre persönlichen Standardeinstellungen, die für alle Projekte gelten. Hier legen Sie Ihr bevorzugtes Modell, Design und globale Berechtigungen fest.

    Sie können in diesem Verzeichnis auch eine Datei `AGENTS.md` ablegen (`~/.config/devin/AGENTS.md`), um [globale Regeln](/de/cli/extensibility/rules#global-rules) zu definieren, die für jedes Projekt gelten.

    <Note>
      Unter Windows lautet dieser Pfad `%APPDATA%\devin\config.json` (normalerweise `C:\Users\<you>\AppData\Roaming\devin\config.json`).
    </Note>

    ```json theme={null}
    {
      "agent": { "model": "claude-sonnet-4.5" },
      "permissions": {
        "allow": ["Read(**)", "Exec(git)"]
      }
    }
    ```
  </Tab>

  <Tab title="Projektkonfiguration">
    **Pfad:** `.devin/config.json` (im Stammverzeichnis Ihres Projekts)

    Gemeinsam genutzte Team-Konfiguration, die in die Versionsverwaltung eingecheckt wird. Verwenden Sie sie für projektspezifische MCP-Server, Berechtigungsrichtlinien und Import-Einstellungen.

    ```json theme={null}
    {
      "permissions": {
        "allow": ["Exec(npm run)", "Read(src/**)"],
        "deny": ["Exec(sudo)"]
      },
      "mcpServers": {
        "github": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-github"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Lokale Überschreibungen">
    **Pfad:** `.devin/config.local.json`

    Persönliche Überschreibungen für dieses Projekt, die nicht in git eingecheckt werden (und automatisch von git ignoriert werden). Verwenden Sie sie für Secrets, API-Schlüssel und persönliche Einstellungsüberschreibungen.

    ```json theme={null}
    {
      "mcpServers": {
        "github": {
          "env": { "GITHUB_TOKEN": "ghp_your_token" }
        }
      }
    }
    ```
  </Tab>
</Tabs>

***

<div id="what-you-can-configure">
  ## Was Sie konfigurieren können
</div>

<CardGroup cols={2}>
  <Card title="Modell" icon="brain" href="/de/cli/models">
    Wählen Sie, welches KI-Modell den Agenten steuert — von Claude Opus über GPT 5.2 bis hin zu Gemini 3.
  </Card>

  <Card title="Berechtigungen" icon="shield" href="/de/cli/reference/permissions">
    Genehmigen Sie sichere Aktionen vorab, blockieren Sie gefährliche und steuern Sie, was der Agent ohne Rückfrage tun darf.
  </Card>

  <Card title="MCP-Server" icon="server" href="/de/cli/extensibility/mcp/configuration">
    Verbinden Sie externe Tool-Server für GitHub, Linear, Datenbanken und eigene APIs.
  </Card>

  <Card title="Importe aus externen Tools" icon="arrow-right-to-bracket" href="/de/cli/extensibility/rules">
    Importieren Sie Regeln, Skills und Konfigurationen aus Cursor, Windsurf und Claude Code.
  </Card>
</CardGroup>

***

<div id="quick-start">
  ## Schnellstart
</div>

Der schnellste Einstieg ist, im Stammverzeichnis Ihres Projekts eine `.devin/config.json` zu erstellen:

```json theme={null}
{
  "permissions": {
    "allow": [
      "Read(**)",
      "Exec(git)",
      "Exec(npm run)"
    ]
  }
}
```

Dadurch werden Dateizugriffe und gängige Befehle im Voraus genehmigt, sodass der Agent Sie nicht für jede Aktion um Erlaubnis bittet.

<Tip>
  Sie können Devin CLI auch interaktiv konfigurieren: Wenn der Agent um Erlaubnis bittet, können Sie festlegen, dass die Entscheidung für das nächste Mal in Ihrer Projekt- oder Nutzerkonfiguration gespeichert wird.
</Tip>

***

<div id="project-vs-user-settings">
  ## Projekt- vs. Nutzer-Settings
</div>

Nicht alle Settings sind auf jeder Ebene verfügbar. Projektkonfigurationen (`.devin/config.json` und `.devin/config.local.json`) unterstützen:

* **`permissions`** — Regeln zum Zulassen, Verweigern und Nachfragen
* **`mcpServers`** — Definitionen für MCP-Server
* **`read_config_from`** — Import von Settings aus Cursor, Windsurf und Claude
* **`hooks`** — Lifecycle-Hooks ([siehe Hooks](/de/cli/extensibility/hooks/overview))

Alle anderen Settings — einschließlich `agent` (Modell), `theme_mode`, `unicode_mode`, `show_path`, `sandbox` und anderer Anzeige- und Verhaltensoptionen — sind **ausschließlich in der Nutzer-Konfiguration verfügbar** und können nur in der Nutzer-Konfiguration gesetzt werden (`~/.config/devin/config.json`; `%APPDATA%\devin\config.json` unter Windows).

***

<div id="configuration-precedence">
  ## Konfigurationspriorität
</div>

Bei Settings, die mehrere Ebenen unterstützen, haben Quellen mit höherer Priorität Vorrang:

| Priorität      | Quelle                                                                              | Geteilt?                               |
| -------------- | ----------------------------------------------------------------------------------- | -------------------------------------- |
| 1 (höchste)    | Organisations- / Team-Settings                                                      | Ja (unternehmensweit)                  |
| 2              | Sitzungsfreigaben (interaktive Genehmigungen)                                       | Nein (im Arbeitsspeicher)              |
| 3              | Lokal im Projekt (`.devin/config.local.json`)                                       | Nein (per `.gitignore` ausgeschlossen) |
| 4              | Projekt (`.devin/config.json`)                                                      | Ja (committed)                         |
| 5 (niedrigste) | Nutzer (`~/.config/devin/config.json`; `%APPDATA%\devin\config.json` unter Windows) | Nein (persönlich)                      |

Berechtigungen werden ebenenübergreifend zusammengeführt, während MCP-Server nach Namen zusammengeführt werden (bei Servern mit demselben Namen hat die Quelle mit höherer Priorität Vorrang).

<Note>
  Settings auf Organisationsebene (Enterprise) können **niemals** durch Projekt- oder Nutzerkonfigurationen überschrieben werden. Unter [Konfigurationspriorität](/de/cli/reference/configuration/global-vs-local) findest du alle Details dazu, wie das Zusammenführen funktioniert.
</Note>

***

<div id="limitations">
  ## Einschränkungen
</div>

<Warning>
  Devin CLI unterstützt keine `.codeiumignore`-Dateien. Wenn Sie die Autovervollständigung von Codeium verwenden und Ausschlussmuster konfiguriert haben, werden diese Muster von Devin CLI nicht berücksichtigt.
</Warning>

***

<div id="learn-more">
  ## Mehr erfahren
</div>

<CardGroup cols={2}>
  <Card title="Vollständige Konfigurationsreferenz" icon="file-code" href="/de/cli/reference/configuration/config-file">
    Vollständige Liste aller Konfigurationsoptionen und ihrer Formate.
  </Card>

  <Card title="Konfigurationspriorität" icon="layer-group" href="/de/cli/reference/configuration/global-vs-local">
    Wie globale, projektweite und lokale Settings zusammenwirken und zusammengeführt werden.
  </Card>
</CardGroup>