# Devin Desktop (ehemals Windsurf) – Einrichtung

> **Zuletzt überprüft**: 2026-09-18 · 📄 Laut offizieller Dokumentation (Devin Desktop 3.10.31 (veröffentlicht am 2026-09-16))

## Auf einen Blick

| Element | Details |
|---|---|
| Verfügbare Modelle | abhängig vom eingebundenen ACP-Agent: Claude ✅ (Claude Agent / Claude Code mit Umgebung, die auf QCode zeigt) · GPT / chinesische Modelle je nach Agent · Gemini ❌ |
| Protokoll & Base URL | die Umgebung des Agents: `ANTHROPIC_BASE_URL=https://api.qcode.cc/api` |
| Konfiguration | im Tab „Agents“ der Devin-Benutzereinstellungen oder in `~/.windsurf/acp/registry.json` (Windows: `%USERPROFILE%\AppData\Roaming\Code\User\acp\registry.json`); die Umgebung eines Agents legen Sie über die Einstellung `devin.acp.agentEnv.<agentName>` fest |
| Offizielle Dokumentation | [docs.devin.ai](https://docs.devin.ai) |

> **⚠️ Windsurf wurde umbenannt.** Am 2026-06-02 hat Cognition **Windsurf in Devin Desktop umbenannt** und
> per Over-the-Air-Update ausgeliefert. Was der Anbieter einzeln zugesagt hat, waren Pläne, Preise,
> Einstellungen und Erweiterungen; Tastenbelegungen und MCP-Verbindungen sind nicht einzeln garantiert,
> und wir haben sie nicht einzeln überprüft. Der ursprüngliche **Cascade-Agent wurde entfernt**: Die FAQ
> sagten damals, dass er „bis Juli verfügbar bleibt“, aber die Entfernung erfolgte tatsächlich im
> **v3.9.19-Changelog (8. September 2026)** – „**Cascade** has been removed“ – womit
> **Devin Local der einzige in Devin Desktop integrierte Agent ist**.

[Devin Desktop](https://devin.ai/desktop) ist jetzt um **[ACP (Agent Client Protocol)](/docs/ide/acp)** herum aufgebaut:
Es fungiert als Host, und Sie können jeden ACP-fähigen Agent anbinden – Claude Code, Codex CLI, OpenCode
und weitere. Neue Funktionen umfassen ein Command Center im Kanban-Stil, Spaces zum Gruppieren von Aufgaben,
einen lokalen Agenten **Devin Local** (der Anbieter beschreibt ihn so, dass er sich die Architektur mit Devin CLI teilt) und Codemaps.

## Die richtige Nutzung von QCode: ACP ist der einzige Weg

Devin Desktop bietet **keine** BYOK-Eingabefelder, in die Sie eine beliebige Base URL eingeben könnten: Eine
Suche im offiziellen Dokumentationsindex nach BYOK / bring your own / custom endpoint / base URL / model override
ergibt **nichts**, und die Modellliste ist ein fester Katalog, der an Ihren Tarif gebunden ist. Um Ihren QCode-API-Key
und Ihr Kontingent zu nutzen, müssen Sie **Ihren eigenen Agent über ACP anbinden**:

> 🔑 Devin Desktop startet ACP-Agenten bei Bedarf als **Kindprozesse** und kommuniziert über JSON-RPC
> auf stdio mit ihnen (offizielle Formulierung). Die beiden dokumentierten Möglichkeiten, einem Agenten
> Umgebungsvariablen mitzugeben, sind die „...“-Schaltfläche im Tab **Agents** der Devin-Benutzereinstellungen und
> die Einstellung `devin.acp.agentEnv.<agentName>` in `settings.json`. Ob der Agent auch Ihre
> Shell-Umgebung erbt, wird vom Anbieter **nicht ausdrücklich zugesagt** – in der Regel stimmt das, ist aber nicht garantiert,
> weshalb Schritt 1 die Konfiguration in die eigene Datei des Agenten legt.

## Schritt 1: Claude Code auf QCode richten

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_qcode_key"
```

Von Festlandchina aus nutzen Sie `https://asia.qcode.cc/api`.

> **Robuster**: Legen Sie diese in den `env`-Block von `~/.claude/settings.json`, statt in eine Shell-
> Profildatei – eine GUI-App, die über ein Icon gestartet wird, liest `~/.zshrc` nicht, was der häufigste
> Fehler ist. Siehe [ACP-Übersicht](/docs/ide/acp) und [Umgebungsvariablen](/docs/getting-started/environment).

Bestätigen Sie zunächst in einem Terminal, dass die CLI funktioniert:

```bash
claude -p "reply with exactly: OK"
```

## Schritt 2: Den Agent in Devin Desktop anbinden

**Der einzige integrierte Agent ist Devin Local.** Die offizielle Dokumentation listet Codex CLI, Claude Agent,
OpenCode, Junie und Gemini CLI als *Beispiel-Agenten* auf – Drittanbieter-ACP-Agenten, die Sie anbinden können,
**deren Binärdateien Sie jedoch selbst installieren müssen** (die Dokumentation besagt, dass Devin Desktop aus
Sicherheitsgründen keine Agent-Distributionen aus der Registry herunterlädt). Seit v3.10.23 (2026-09-10) ist ACP
immer aktiviert und der alte **Enable ACP**-Schalter ist entfallen. So binden Sie einen Agent an:

- Command Palette (`Cmd/Ctrl + Shift + P`) → `Devin User Settings` → Tab **Agents** → schalten Sie die
  gewünschten ACP-Agenten ein
- oder bearbeiten Sie die lokale Registry: `~/.windsurf/acp/registry.json` auf macOS / Linux
  (`~/.windsurf-next/acp/registry.json` für Devin Desktop Next) und
  `%USERPROFILE%\AppData\Roaming\Code\User\acp\registry.json` auf Windows
- `Open Local ACP Registry Config` in der Command Palette öffnet diese Datei direkt; nach dem Bearbeiten führen Sie
  `Reload ACP Connections` aus – ein vollständiger Neustart ist nicht erforderlich

Schlüssel und Limits: [Offizielle ACP-Dokumentation von Devin](https://docs.devin.ai/desktop/acp).

> ⚠️ Offizielle Warnung: Solange ein Workspace im **Restricted Mode** geöffnet ist, sind **alle** Agenten – sowohl Devin Local
> als auch ACP-Agenten – nicht verfügbar, und Hooks werden weder geladen noch ausgeführt. Prüfen Sie dies zuerst, wenn überhaupt kein
> Agent angezeigt wird.

Nach dem Anbinden öffnen Sie eine Sitzung in Devin Desktop. Eine normale Antwort bedeutet, dass Ihr QCode-Kontingent genutzt wird.
## Prüfen, dass der Traffic wirklich über QCode läuft

Öffnen Sie [probe.qcode.cc](https://probe.qcode.cc) und geben Sie Ihren API-Key ein. Die soeben ausgeführte Sitzung sollte in der Request-Liste erscheinen (mit Modell, Tokens und Kontextlänge). **Falls nicht, hat der Agent Ihre Umgebung nicht geerbt** — kehren Sie zu Schritt 1 zurück und verwenden Sie die Form mit `~/.claude/settings.json`.

## Problembehandlung

| Symptom | Ursache | Lösung |
|---------|-------|-----|
| Funktioniert im Terminal, schlägt bei der Authentifizierung in Devin Desktop fehl | Der GUI-Start liest nicht die Shell-Umgebung | Verwenden Sie den `env`-Block in `~/.claude/settings.json` |
| Cascade ist verschwunden | In v3.9.19 (2026-09-08) entfernt | Verwenden Sie Devin Local oder hängen Sie einen ACP-Agent an |
| Kein Feld für die Eingabe einer Base URL | Die offizielle Dokumentation enthält keinen BYOK- / Custom-Endpunkt-Eintrag | Hängen Sie Ihren Agent über ACP an |
| In probe erscheint nichts | Die Sitzung lief nicht über QCode | Prüfen Sie, ob der Agent die Umgebung geerbt hat |

## Verwandte Themen

- [ACP-Übersicht](/docs/ide/acp) — dasselbe Setup deckt auch Zed und JetBrains ab
- [Umgebungsvariablen](/docs/getting-started/environment)
- [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths)