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

# Fehlerbehebung

> Häufige Probleme und ihre Behebung

<div id="installation-issues">
  ## Probleme bei der Installation
</div>

<AccordionGroup>
  <Accordion title="Installationsbefehl schlägt fehl (macOS / Linux / WSL)">
    Wenn das Installationsskript nicht heruntergeladen werden kann:

    1. Überprüfen Sie Ihre Internetverbindung
    2. Vergewissern Sie sich, dass curl installiert ist: `which curl`
    3. Versuchen Sie es mit ausführlicher Ausgabe: `curl -fsSL -v https://cli.devin.ai/install.sh | bash`

    Wenn Sie sich hinter einem Unternehmens-Proxy befinden, müssen Sie möglicherweise die Proxy-Einstellungen konfigurieren:

    ```bash theme={null}
    export https_proxy=http://your-proxy:port
    curl -fsSL https://cli.devin.ai/install.sh | bash
    ```
  </Accordion>

  <Accordion title="Installationsbefehl schlägt fehl (Windows)">
    Wenn das PowerShell-Installationsskript fehlschlägt:

    1. Überprüfen Sie Ihre Internetverbindung
    2. Stellen Sie sicher, dass Sie PowerShell als normaler Nutzer ausführen (nicht als Administrator, sofern nicht erforderlich)
    3. Wenn ein Fehler bei der Ausführungsrichtlinie angezeigt wird, versuchen Sie Folgendes:
       ```powershell theme={null}
       Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
       irm https://static.devin.ai/cli/setup.ps1 | iex
       ```
    4. Wenn Sie sich hinter einem Unternehmens-Proxy befinden, konfigurieren Sie die Proxy-Einstellungen in PowerShell, bevor Sie den Installationsbefehl ausführen

    Als Alternative zum PowerShell-Skript können Sie das eigenständige Installationsprogramm direkt herunterladen und ausführen:

    * [x86\_64](https://static.devin.ai/cli/devin-updater-x86_64-pc-windows.exe)
    * [ARM64](https://static.devin.ai/cli/devin-updater-aarch64-pc-windows.exe)
  </Accordion>

  <Accordion title="Zugriff während der Installation verweigert">
    Das Installationsprogramm benötigt Schreibzugriff, um die Binärdatei zu installieren. Wenn Berechtigungsfehler auftreten:

    1. Prüfen Sie, ob der Installationsort Schreibberechtigungen hat
    2. Führen Sie das Installationsprogramm nicht mit `sudo` aus — dies kann zu Problemen mit den Besitzverhältnissen führen
    3. Wenn Sie in ein Systemverzeichnis installieren, stellen Sie sicher, dass Ihr Nutzer über die entsprechenden Berechtigungen verfügt
  </Accordion>

  <Accordion title="Binärdatei nach der Installation nicht gefunden">
    Wenn die Installation abgeschlossen ist, `devin` aber nicht gefunden wird:

    **macOS / Linux / WSL:**

    1. Starten Sie Ihr Terminal neu oder führen Sie `source ~/.bashrc` (oder `~/.zshrc`) aus
    2. Prüfen Sie, ob sich der Speicherort der Binärdatei in Ihrem PATH befindet: `echo $PATH`
    3. Vergewissern Sie sich, dass die Binärdatei vorhanden ist: `ls -la ~/.local/bin/devin` (oder am während des Setup angezeigten Installationsort)

    **Windows:**

    1. Starten Sie Ihre PowerShell-Sitzung neu
    2. Prüfen Sie, ob sich der Speicherort der Binärdatei in Ihrem PATH befindet: `$env:PATH -split ';'`
    3. Vergewissern Sie sich, dass die Binärdatei am während des Setup angezeigten Installationsort vorhanden ist
  </Accordion>

  <Accordion title="'irm' oder 'iex'-Befehl nicht gefunden (Windows)">
    `irm` und `iex` sind PowerShell-Aliasse. Wenn dieser Fehler angezeigt wird, führen Sie den Installationsbefehl in Git Bash oder CMD anstelle von PowerShell aus.

    **Lösung:** Öffnen Sie **PowerShell** und führen Sie den Installationsbefehl dort aus:

    ```powershell theme={null}
    irm https://static.devin.ai/cli/setup.ps1 | iex
    ```

    Alternativ können Sie PowerShell aus Git Bash oder CMD auch explizit aufrufen:

    ```bash theme={null}
    powershell -Command "irm https://cli.devin.ai/install.ps1 | iex"
    ```

    Nach der Installation können Sie Devin CLI in **PowerShell**, **Windows Terminal** oder **Git Bash** verwenden.
  </Accordion>
</AccordionGroup>

***

<div id="authentication-issues">
  ## Authentifizierungsprobleme
</div>

<AccordionGroup>
  <Accordion title="Login schlägt fehl oder reagiert nicht mehr">
    Wenn die browserbasierte Anmeldung nicht funktioniert:

    1. Verwenden Sie für Remote-/SSH-Sitzungen den manuellen Token-Flow:
       ```bash theme={null}
       devin auth login --force-manual-token-flow
       ```
    2. Prüfen Sie, ob Ihr Browser die Authentifizierungs-URL erreichen kann
    3. Vergewissern Sie sich, dass für Ihr Enterprise-Konto der Zugriff auf Devin CLI aktiviert ist
  </Accordion>

  <Accordion title="'Nicht autorisiert' oder Berechtigungsfehler">
    Wenn nach der Anmeldung Autorisierungsfehler auftreten:

    1. Vergewissern Sie sich, dass Ihr Konto über die erforderliche Berechtigung für den Zugriff auf Devin CLI verfügt. Möglicherweise müssen Sie Ihren Admin fragen. Für Enterprise finden Sie unter [Devin Auth](/de/cli/enterprise/devin-auth#configuring-access) oder [Legacy Windsurf Auth](/de/cli/enterprise/windsurf-auth#prerequisites) Informationen zum Konfigurieren des Zugriffs.
    2. Versuchen Sie, sich abzumelden und erneut anzumelden: `devin auth logout && devin auth login`
    3. Prüfen Sie Ihren Authentifizierungsstatus: `devin auth status`
  </Accordion>

  <Accordion title="Token abgelehnt oder widerrufen">
    Devin CLI API-Token verfallen standardmäßig nicht. Wenn ein gespeicherter Token widerrufen wurde oder nicht mehr akzeptiert wird, entfernen Sie ihn, bevor Sie sich erneut anmelden:

    ```bash theme={null}
    devin auth logout && devin auth login
    ```

    um Ihre gespeicherten Zugangsdaten zu ersetzen.
  </Accordion>
</AccordionGroup>

***

<div id="network-proxy-issues">
  ## Netzwerk- und Proxy-Probleme
</div>

<AccordionGroup>
  <Accordion title="Verbindungen hinter einem Unternehmens-Proxy schlagen fehl">
    Die CLI leitet ihren ausgehenden HTTPS-Datenverkehr (Authentifizierung, Updates, Modell-API-Aufrufe, MCP-Server) über einen Proxy, wenn einer konfiguriert ist. Dafür gibt es zwei Möglichkeiten:

    **Umgebungsvariablen** — der Standard-Proxy-Modus `system` berücksichtigt diese:

    ```bash theme={null}
    export HTTPS_PROXY=http://proxy.corp.example.com:8080
    export HTTP_PROXY=http://proxy.corp.example.com:8080
    export ALL_PROXY=socks5://proxy.corp.example.com:1080   # optional, SOCKS5
    export NO_PROXY=localhost,127.0.0.1,.internal.corp      # Hosts, die umgangen werden sollen
    ```

    **`config.json`** — gilt unabhängig von der Umgebung:

    ```json theme={null}
    {
      "proxy": {
        "mode": "manual",
        "url": "http://proxy.corp.example.com:8080",
        "no_proxy": "localhost,127.0.0.1,.internal.corp"
      }
    }
    ```

    Alle Optionen finden Sie in der [`proxy`-Konfigurationsreferenz](/de/cli/reference/configuration/config-file#proxy). Unter macOS und Windows berücksichtigt der Modus `system` außerdem die plattformeigenen PAC-Einstellungen (Proxy Auto-Configuration).

    Wenn Ihr Proxy TLS-Inspektion durchführt, verwendet die CLI den Zertifikatsspeicher Ihres Betriebssystems. Installieren Sie daher die Root CA des Proxys auf Betriebssystemebene (den Schlüsselbund unter macOS, den Windows-Zertifikatsspeicher oder das CA-Bundle Ihrer Distribution unter Linux).
  </Accordion>

  <Accordion title="Vollständige HTTP-Request-Logs für das Debugging erfassen">
    Um vollständige Einblicke in den Request-Lifecycle zu erhalten (DNS, Connection-Pooling, TLS-Handshake, Header, Weiterleitungen und Wiederholungsversuche), erhöhen Sie den Log-Level mit `RUST_LOG` und spiegeln Sie die Logs mit `CHISEL_LOG_STDOUT` in Ihr Terminal:

    ```bash theme={null}
    RUST_LOG="chisel=trace,windsurf_api_client=trace,connect_rpc=trace,reqwest=trace,hyper=trace,hyper_util=trace,rustls=trace" \
      CHISEL_LOG_STDOUT=1 \
      devin auth login
    ```

    Das bringt jedes Ziel:

    * `chisel`, `windsurf_api_client`, `connect_rpc` — das eigene Request- und Authentifizierungs-Logging der CLI
    * `reqwest=trace` — Request-/Response-Verarbeitung und Weiterleitungen auf höherer Ebene
    * `hyper=trace` / `hyper_util=trace` — Verbindungsaufbau, Pooling und HTTP/1.1- & HTTP/2-Framing
    * `rustls=trace` — Details zum TLS-Handshake (nützlich bei Proxy- und Zertifikatsproblemen)

    Verwenden Sie `CHISEL_LOG_STDERR=1` anstelle von `CHISEL_LOG_STDOUT=1`, wenn Sie nicht möchten, dass Logs mit der Befehlsausgabe vermischt werden. (Stdout-Logging wird im interaktiven REPL- und ACP-Modus automatisch unterdrückt, damit deren Ausgabe nicht beschädigt wird.)

    Logs werden unabhängig von diesen Umgebungsvariablen außerdem immer in eine Log-Datei pro Lauf im Datenverzeichnis der CLI geschrieben:

    * **macOS / Linux:** `~/.local/share/devin/cli/logs/devin_<timestamp>_<pid>.log`
    * **Windows:** `%APPDATA%\devin\cli\logs\devin_<timestamp>_<pid>.log`

    <Warning>
      Logs auf Trace-Level können sensible Daten wie `Authorization`-Header und Tokens enthalten. Bereinigen Sie die Log-Ausgabe, bevor Sie sie weitergeben.
    </Warning>
  </Accordion>

  <Accordion title="Vollständige Request- und Response-Bodies prüfen">
    `RUST_LOG` macht den Request-Lifecycle sichtbar, aber nicht die vollständigen Payloads. Um komplette Request- und Response-Bodies zu erfassen, leiten Sie die CLI über einen mitlesenden Proxy wie [mitmproxy](https://mitmproxy.org/):

    ```bash theme={null}
    # Terminal 1 — starten Sie den mitlesenden Proxy:
    mitmproxy --listen-port 8080

    # Terminal 2 — leiten Sie die CLI darüber:
    export HTTPS_PROXY=http://127.0.0.1:8080
    devin auth login
    ```

    Da die CLI dem Zertifikatsspeicher des Betriebssystems vertraut, installieren Sie zuerst das CA-Zertifikat von mitmproxy (`~/.mitmproxy/mitmproxy-ca-cert.pem`) in den System-Trust-Store — andernfalls schlägt die TLS-Verbindung zum Proxy fehl.
  </Accordion>
</AccordionGroup>

***

<div id="runtime-issues">
  ## Runtime-Probleme
</div>

<AccordionGroup>
  <Accordion title="Modell nicht verfügbar">
    Wenn Fehler angezeigt werden, dass ein Modell nicht verfügbar ist:

    1. Prüfen Sie, ob in Ihrem Enterprise die verfügbaren Modelle in [Team Settings](/de/cli/enterprise/team-settings) eingeschränkt sind
    2. Vergewissern Sie sich, dass der Modellname korrekt ist — mit `/model` sehen Sie die verfügbaren Optionen
    3. Versuchen Sie es mit einem anderen Modell: `devin --model sonnet -- your prompt`
  </Accordion>

  <Accordion title="Rate Limits oder Kontingent überschritten">
    Wenn Sie an Nutzungsgrenzen stoßen:

    1. Warten Sie einige Minuten, bevor Sie es erneut versuchen
    2. Prüfen Sie im Nutzungs-Dashboard Ihrer Organisation den Status Ihres Kontingents
    3. Wenden Sie sich an Ihren Admin, wenn Sie höhere Limits benötigen
  </Accordion>

  <Accordion title="Agent scheint festzuhängen oder reagiert nicht">
    Wenn der Agent nicht mehr reagiert:

    1. Drücken Sie `Ctrl+C`, um den aktuellen Vorgang zu unterbrechen
    2. Versuchen Sie `/clear`, um eine neue Sitzung zu starten
    3. Prüfen Sie Ihre Netzwerkverbindung
    4. Starten Sie Devin CLI neu
  </Accordion>
</AccordionGroup>

***

<div id="mcp-server-issues">
  ## Probleme mit MCP-Servern
</div>

<AccordionGroup>
  <Accordion title="Server startet nicht">
    Wenn ein MCP-Server nicht startet:

    1. Prüfen Sie, ob der Befehl außerhalb der Devin CLI funktioniert:
       ```bash theme={null}
       npx -y @modelcontextprotocol/server-github
       ```
    2. Prüfen Sie, ob alle erforderlichen Umgebungsvariablen gesetzt sind
    3. Suchen Sie in der Serverausgabe nach Fehlermeldungen
  </Accordion>

  <Accordion title="Tools werden nicht angezeigt">
    Wenn MCP-Tools nicht angezeigt werden:

    1. Der Server benötigt möglicherweise einen Moment zur Initialisierung — warten Sie einige Sekunden
    2. Prüfen Sie, ob der Server in Ihrer Konfigurationsdatei korrekt konfiguriert ist
    3. Prüfen Sie, ob MCP-Server in Ihrem Enterprise unter [Team Settings](/de/cli/enterprise/team-settings) zugelassen sind
  </Accordion>

  <Accordion title="Keine Berechtigung für MCP-Tools">
    MCP-Tools fragen standardmäßig nach einer Bestätigung. Um bestimmte Tools automatisch zu genehmigen, fügen Sie sie Ihrer Berechtigungskonfiguration hinzu:

    ```json theme={null}
    {
      "permissions": {
        "allow": ["mcp__github__list_issues"]
      }
    }
    ```
  </Accordion>
</AccordionGroup>

***

<div id="getting-help">
  ## Hilfe erhalten
</div>

Wenn du weiterhin Probleme hast:

* **Support per E-Mail:** [support@cognition.ai](mailto:support@cognition.ai)
* **Fehlerbericht senden:** Verwende den Befehl `/bug` in der Devin CLI, um Probleme direkt an die Entwickler der Devin CLI zu melden
* **Nach Updates suchen:** Führe `devin update` aus, um sicherzustellen, dass du die neueste Version verwendest