Devin Desktop (ehemals Windsurf) – Einrichtung

Windsurf heißt jetzt Devin Desktop und basiert auf ACP: Binden Sie Claude Code als ACP-Agent an, dessen Umgebung auf QCode zeigt

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

Auf einen Blick¶

⚠️ 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 ist jetzt um ACP (Agent Client Protocol) 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¶

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 und Umgebungsvariablen.

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

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.

⚠️ 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 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¶

Verwandte Themen¶

• ACP-Übersicht — dasselbe Setup deckt auch Zed und JetBrains ab
• Umgebungsvariablen
• Endpunkte & API-Pfade