# Подключение Devin Desktop (ранее Windsurf)

> **Последняя проверка**: 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](https://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](https://devin.ai/desktop) теперь построен вокруг **[ACP (Agent Client Protocol)](/docs/ide/acp)**:
он выступает хостом, а вы подключаете любого агента, говорящего на 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

```bash
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](/docs/ide/acp) и [Переменные окружения](/docs/getting-started/environment).

Сначала убедитесь, что CLI работает из терминала:

```bash
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](https://docs.devin.ai/desktop/acp).

> ⚠️ Официальное предупреждение: пока рабочая область открыта в **Restricted Mode**, **все** агенты —
> и Devin Local, и ACP — недоступны, а хуки не загружаются. Это первое, что стоит проверить, если в
> списке не появилось ни одного агента.

После подключения откройте сессию в Devin Desktop: обычный ответ означает, что расходуется ваша
квота QCode.

## Проверка, что трафик действительно идёт в QCode

Откройте [probe.qcode.cc](https://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](/docs/ide/acp) — та же настройка покрывает Zed и JetBrains
- [Переменные окружения](/docs/getting-started/environment)
- [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths)