Подключение Devin Desktop (ранее Windsurf)
Windsurf стал Devin Desktop и построен вокруг ACP: подключите Claude Code как ACP-агента с окружением, направленным на QCode
Содержание
Последняя проверка: 2026-09-18 · 📄 По официальной документации (Devin Desktop 3.10.31 (выпуск 2026-09-16))
Кратко¶
| Параметр | Описание |
|---|---|
| Доступные модели | зависит от подключаемого ACP-агента: Claude ✅ (подключить Claude Agent / Claude Code с окружением на QCode) · GPT / китайские — по агенту · Gemini ❌ |
| Протокол и Base URL | переменные агента: ANTHROPIC_BASE_URL=https://api.qcode.cc/api |
| Где настраивается | вкладка Agents в Devin User Settings либо ~/.windsurf/acp/registry.json (Windows: %USERPROFILE%\AppData\Roaming\Code\User\acp\registry.json); переменные окружения агенту задают настройкой devin.acp.agentEnv.<agentName> |
| Официальная документация | docs.devin.ai |
⚠️ Windsurf переименован. 2026-06-02 Cognition переименовала Windsurf в Devin Desktop и выпустила обновление «по воздуху». Пункт за пунктом вендор обещал перенос тарифов, цен, настроек и расширений; про горячие клавиши и MCP-подключения построчных обещаний нет, и мы их тоже не сверяли. Прежний агент Cascade удалён: в FAQ на тот момент было «remains available through July», но фактически удаление зафиксировано в CHANGELOG версии v3.9.19 (8 сентября 2026) — «Cascade has been removed». Теперь Devin Local — единственный встроенный агент.
Devin Desktop теперь построен вокруг ACP (Agent Client Protocol): он выступает хостом, а вы подключаете любого агента, говорящего на ACP — Claude Code, Codex CLI, OpenCode и другие. Из нового: Command Center в стиле канбан, Spaces для группировки задач, локальный агент Devin Local (по описанию вендора, та же архитектура, что у Devin CLI) и Codemaps.
Как использовать QCode: путь через ACP — единственный¶
Поля для произвольного Base URL во встроенном BYOK в Devin Desktop нет: поиск по официальному индексу документации по словам BYOK / bring your own / custom endpoint / base URL / model override не даёт ни одного совпадения, а список моделей — это фиксированный каталог внутри тарифа. Использовать свой ключ и квоту QCode можно только подключив собственного агента через ACP:
🔑 Devin Desktop запускает ACP-агентов как дочерние процессы по требованию и обменивается с ними JSON-RPC по stdio (официальная формулировка). Официальных способа передать агенту переменные окружения два: кнопка "..." на вкладке Agents в Devin User Settings и настройка
devin.acp.agentEnv.<agentName>вsettings.json. Наследует ли агент окружение вашей оболочки — вендор слово в слово не обещает: обычно да, но гарантии нет, поэтому в шаге 1 конфигурация кладётся в файл самого агента. Настройте Claude Code CLI на QCode один раз — и сессии внутри Devin Desktop пойдут туда же.
Шаг 1: направьте Claude Code на QCode¶
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_ваш_ключ_QCode"
Из материкового Китая используйте https://asia.qcode.cc/api.
Надёжнее прописать это в блоке
envфайла~/.claude/settings.json, а не в profile оболочки: GUI-приложение, запущенное с ярлыка, не читает~/.zshrc— это самая частая причина сбоя. См. Обзор ACP и Переменные окружения.
Сначала убедитесь, что CLI работает из терминала:
claude -p "reply with exactly: OK"
Шаг 2: подключите агента в Devin Desktop¶
Встроенный агент только один — Devin Local. Codex CLI, Claude Agent, OpenCode, Junie и Gemini CLI в официальной документации перечислены как Example agents: это сторонние ACP-агенты, чей бинарник вы должны установить сами (официально: из соображений безопасности Devin Desktop не скачивает дистрибутивы агентов из реестра). Начиная с v3.10.23 (2026-09-10) ACP включён всегда, а прежний переключатель Enable ACP убран. Как подключить:
- палитра команд (
Cmd/Ctrl + Shift + P) →Devin User Settings→ вкладка Agents → включите нужных ACP-агентов -
либо правьте локальный реестр:
~/.windsurf/acp/registry.jsonна macOS / Linux (для Devin Desktop Next —~/.windsurf-next/acp/registry.json), на Windows —%USERPROFILE%\AppData\Roaming\Code\User\acp\registry.json -
команда палитры
Open Local ACP Registry Configоткрывает этот файл; после правки выполнитеReload ACP Connections— весь клиент перезапускать не нужно
Ключи и ограничения — в официальной ACP-документации Devin.
⚠️ Официальное предупреждение: пока рабочая область открыта в Restricted Mode, все агенты — и Devin Local, и ACP — недоступны, а хуки не загружаются. Это первое, что стоит проверить, если в списке не появилось ни одного агента.
После подключения откройте сессию в Devin Desktop: обычный ответ означает, что расходуется ваша квота QCode.
Проверка, что трафик действительно идёт в QCode¶
Откройте probe.qcode.cc и введите свой API-ключ. Только что выполненная
сессия должна появиться в списке запросов (с моделью, токенами и длиной контекста). Если её нет,
агент не унаследовал окружение — вернитесь к шагу 1 и используйте вариант с
~/.claude/settings.json.
Диагностика¶
| Симптом | Причина | Решение |
|---|---|---|
| В терминале работает, в Devin Desktop ошибка авторизации | Запуск из GUI не читает окружение оболочки | Используйте блок env в ~/.claude/settings.json |
| Не найти Cascade | Удалён из Devin Desktop в v3.9.19 (2026-09-08) | Используйте Devin Local либо подключите ACP-агента |
| Нет поля для Base URL | В официальной документации нет ни BYOK, ни настраиваемой точки | Только подключение агента через ACP |
| В probe нет запросов | Сессия не прошла через QCode | Проверьте, унаследовал ли агент окружение |
Смежные документы¶
- Обзор ACP — та же настройка покрывает Zed и JetBrains
- Переменные окружения
- Точки доступа и форматы API