Codex, Claude Agent и OpenCode в Devin Desktop через ACP
MarkdownПошаговая настройка Codex, Claude Agent и OpenCode в Devin Desktop через ACP: установка CLI, конфигурация реестра, Spaces, тарифы и ограничения.
Читать статью полностью
ACP за две минуты
Ключевая идея
ACP — открытый протокол, который связывает редактор с ИИ-агентом. Он распространяется по лицензии Apache 2.0 и использует JSON-RPC. С его помощью в одном редакторе можно запускать агентов OpenAI, Anthropic, Google и независимых разработчиков через общий интерфейс.
В августе 2025 года Zed Industries выпустила открытую спецификацию Agent Client Protocol. К концу того же года к проекту официально присоединилась JetBrains, а в декабре поддержка появилась в IDE 25.3 RC. Задача протокола — стандартизировать связь редактора с агентом: раньше для каждой пары «редактор — агент» требовалась отдельная интеграция.
Agent Client Protocol — открытый стандарт, упрощающий интеграцию любого агента с любым редактором.
ACP часто сравнивают с LSP, протоколом для языковых серверов. После публикации LSP Microsoft редакторам больше не требовалось создавать отдельное подключение для каждого языка. Языковые серверы стали работать по общему стандарту, а любой совместимый редактор смог подключить их.
По состоянию на июнь 2026 года спецификация версии 1 стабильна. Официальные SDK доступны для TypeScript, Python, Rust, Java и Kotlin. Поддержку ACP объявили двенадцать редакторов и продуктов: Zed, создатель протокола, поддерживает его изначально; JetBrains IDE — начиная с версии 2025.3; также поддержку заявили VS Code, Neovim, Emacs и marimo. Devin Desktop от Cognition вышел 2 июня 2026 года и сделал ACP одной из центральных частей интерфейса.
Материалы Ailoot собраны в документации.
Какие инструменты нужны для подключения агента к Devin Desktop через ACP?
Ключевая идея
Понадобятся Devin Desktop версии 3.0.21 или новее (выпуск состоялся 4 июня 2026 года), тариф Pro, Max или Teams, а также CLI Codex, Claude и OpenCode. Без установленных командных инструментов редактор не сможет запустить агентов.
В Devin Desktop доступ к сторонним агентам через ACP зависит от тарифа. На бесплатном плане Free эта возможность отключена. В документации Cognition сказано:
Агенты ACP доступны пользователям тарифов Pro, Max и Teams.
Тариф Pro стоит 20 долларов в месяц и подойдёт для знакомства с несколькими агентами. Max стоит 200 долларов в месяц и рассчитан на тех, кто постоянно использует Devin Cloud в фоновом режиме. Teams обходится в 80 долларов за команду плюс 40 долларов за каждого участника; он предназначен для совместной работы и общих Spaces.
Главное ограничение ACP в Devin Desktop: редактор не устанавливает агентов из реестра автоматически.
Devin Desktop пока не загружает дистрибутивы агентов непосредственно из реестра.
Поэтому CLI Codex, Claude и OpenCode нужно установить заранее самостоятельно. После установки исполняемых файлов их можно добавить в редактор.
Краткие команды для macOS и Linux:
# Codex CLI от OpenAI
npm install -g @openai/codex
# Claude Code от Anthropic; для ACP далее понадобится адаптер claude-agent-acp
npm install -g @anthropic-ai/claude-code
# OpenCode с открытым исходным кодом
curl -fsSL https://opencode.ai/install | bash
Проверьте после установки, что команды доступны через PATH:
codex --version
claude --version
opencode --version
Если одна из команд не запускается, проверьте путь установки npm-пакета и результат выполнения curl. Продолжать настройку имеет смысл только после успешной установки всех нужных CLI.
Где Devin Desktop хранит список агентов
Ключевая идея
Список агентов Devin Desktop хранится в ~/.windsurf/acp/registry.json. Это JSON-файл с объектами, содержащими идентификатор, имя, версию, описание и путь к исполняемому файлу для каждой платформы. Для подключения собственного агента используется тот же формат; редактор прочитает обновлённый список при следующем запуске.
Cognition сохранила знакомый путь Windsurf вместо перехода на каталог .devin, поэтому прежние конфигурации можно использовать и дальше.
Локальный реестр Devin Desktop находится в `~/.windsurf/acp/registry.json`, а Devin Desktop Next использует `~/.windsurf-next/acp/registry.json`.
Пример записи для одного агента:
{
"id": "codex-cli",
"name": "Codex",
"version": "0.42.0",
"description": "OpenAI's coding agent",
"authors": ["OpenAI"],
"license": "Apache-2.0",
"distribution": {
"binary": {
"darwin-arm64": {
"path": "/opt/homebrew/bin/codex",
"args": ["--acp"]
},
"darwin-x64": {
"path": "/usr/local/bin/codex",
"args": ["--acp"]
},
"linux-x64": {
"path": "/usr/local/bin/codex",
"args": ["--acp"]
},
"win32-x64": {
"path": "C:\\Program Files\\codex\\codex.exe",
"args": ["--acp"]
}
}
}
}
Важнее всего параметр path: он указывает, где находится исполняемый файл CLI. При установке через npm это может быть путь вроде ~/.nvm/.../node/.../bin/codex или /usr/local/bin/codex. Точное расположение покажет команда which codex.
Параметр args задаёт аргументы запуска, которые Devin Desktop передаст агенту. Флаг --acp запускает CLI как ACP-сервер, обменивающийся сообщениями с редактором по JSON-RPC через stdin и stdout. Без этого параметра инструмент запускается в обычном интерактивном режиме, который редактор не распознает как ACP-агента.
Перед изменением реестра сохраните его копию. Некорректный JSON может помешать запуску всех ACP-агентов:
cp ~/.windsurf/acp/registry.json ~/.windsurf/acp/registry.json.backup
Затем откройте файл в редакторе и добавьте объект агента в массив agents.
Подключение Codex CLI от OpenAI
Ключевая идея
Codex CLI устанавливается через npm. Авторизуйтесь командой codex auth login, добавьте запись в registry.json и включите агента в настройках Devin. В приведённых далее тестах Codex быстрее выполнял простые задачи, где важнее скорость, чем глубокий разбор.
Сначала войдите в учётную запись, чтобы CLI мог обращаться к сервису:
codex auth login
Команда откроет браузер. При наличии подписки ChatGPT Plus или Team вход выполняется через учётную запись ChatGPT, без отдельного API-ключа. В противном случае потребуется ключ с platform.openai.com.
Проверьте работу CLI в обычном режиме:
codex run "напиши hello world на python"
Если вы получили ответ и в ~/.codex/sessions/ появилась запись, значит CLI работает. Теперь можно настраивать подключение к редактору.
Добавьте агента в ~/.windsurf/acp/registry.json. Используйте формат из предыдущего раздела, а путь к файлу найдите командой which codex:
which codex
# /opt/homebrew/bin/codex
Чтобы включить агента, откройте палитру команд Devin Desktop:
- На macOS нажмите
Cmd+Shift+P. - На Windows или Linux нажмите
Ctrl+Shift+P.
Вызовите команду Devin User Settings, затем откройте вкладку Agents. После изменения реестра Codex должен появиться в списке. Включите переключатель рядом с его именем.
В Agent Command Center появится отдельная колонка Codex: туда можно отправить задачу для выполнения.
В описанных в статье тестах простая задача «добавь логирование в эту функцию» заняла у Codex около 8 секунд; для Claude потребовалось 16 секунд, а для OpenCode — 22 секунды.
Codex может подойти, когда:
- Нужно быстро получить типовой код без длительного анализа.
- Вы последовательно вносите небольшие изменения в скрипты и обвязку.
- Есть готовая спецификация и решение достаточно очевидно.
Для сложных задач с архитектурными компромиссами Codex может упустить часть деталей. Для кода с высокими юридическими требованиями стоит тщательно оценить результат и при необходимости привлечь другой инструмент. Если вам важна тонкая настройка рабочих правил, изучите возможности конфигурации Claude.
Подключение Claude Agent от Anthropic
Ключевая идея
Для использования Claude Agent через ACP в Devin Desktop сочетаются CLI Claude Code и адаптер claude-agent-acp. Адаптер запускает Claude Code как ACP-сервер. Авторизация выполняется через подписку Claude Pro или API-ключ Anthropic. В приведённом примере сильной стороной этого варианта названа работа с большими кодовыми базами и сложными рассуждениями.
Anthropic не выпускает отдельный ACP-бинарный файл под названием Claude Agent. В Devin Desktop используется Claude Code с адаптером claude-agent-acp, опубликованным в репозитории проекта протокола под лицензией Apache 2.0.
Сначала выполните вход в Claude Code:
claude auth login
Подписки Claude Pro или Max позволяют войти через личную учётную запись. Без них потребуется API-ключ с console.anthropic.com.
Проверьте CLI:
claude "перепиши эту функцию, чтобы она возвращала Result<T, E>"
Если команда ответила, установите адаптер и подключите его к редактору.
Установите адаптер:
npm install -g @agentclientprotocol/claude-agent-acp
Добавьте запись в registry.json. В поле path должен быть путь к адаптеру, а не к claude:
{
"id": "claude-agent",
"name": "Claude Agent",
"version": "0.4.0",
"description": "Anthropic's coding agent (community ACP adapter)",
"authors": ["Anthropic", "ACP community"],
"license": "Apache-2.0",
"distribution": {
"binary": {
"darwin-arm64": {
"path": "/opt/homebrew/bin/claude-agent-acp",
"args": []
}
}
}
}
После этого включите агента во вкладке Agents в Devin Settings.
В описанных в статье испытаниях Claude Agent лучше справлялся с крупной задачей: разделить компонент из 600 строк на три файла, сохранив импорты и тесты. В том же примере Codex дважды упустил, что компонент используется в трёх местах.
У Claude Agent могут быть следующие ограничения:
- На простых задачах он может работать медленнее Codex.
- При оплате через API расходы могут быть выше, чем при использовании подписки.
Подключение OpenCode: вариант с открытым исходным кодом
Ключевая идея
OpenCode — ACP-агент с открытым исходным кодом. Он совместим с API, поддерживающими OpenAI API, и локальными моделями через Ollama. Установка и работа с локальной моделью бесплатны; можно запускать кодовые задачи офлайн или на локальных моделях, например Qwen.
OpenCode появился как открытая альтернатива Claude Code в начале 2026 года. По состоянию на июнь его репозиторий набрал более 30 тысяч звёзд, документация была переведена на десять языков, а готовые конфигурации предусматривали Ollama и vLLM.
Установите OpenCode с помощью скрипта:
curl -fsSL https://opencode.ai/install | bash
Проверьте версию:
opencode --version
Затем задайте используемую модель. Для полностью локальной работы запустите Ollama и укажите её адрес в настройках OpenCode:
opencode config set provider ollama
opencode config set base_url http://localhost:11434
opencode config set model qwen3.5-coder:32b
Добавьте OpenCode в registry.json:
{
"id": "opencode",
"name": "OpenCode",
"version": "0.18.1",
"description": "Open source coding agent",
"authors": ["OpenCode community"],
"license": "MIT",
"distribution": {
"binary": {
"darwin-arm64": {
"path": "/usr/local/bin/opencode",
"args": ["acp"]
}
}
}
}
Включите агента в настройках Devin Desktop.
В приведённых в статье тестах OpenCode с Qwen 3.5 Coder выполнял задачу за 22–25 секунд. Для Codex и Claude в тех же примерах указано 8–16 секунд. Локальный запуск не требует оплаты API, однако скорость и качество зависят от оборудования и выбранной модели.
OpenCode может быть полезен, если:
- У вас есть локальная видеокарта и нужно работать офлайн.
- Вы делаете учебный проект и не хотите оплачивать API.
- Вы хотите сравнить локальные модели с облачными.
Перед выбором OpenCode учитывайте, что открытые модели могут уступать Claude по качеству, а локальные модели при работе с контекстом свыше 50K токенов способны терять детали. Скорость также зависит от оборудования и выбранной модели.
Spaces: общий контекст для агентов
Ключевая идея
Spaces — это рабочие группы Devin Desktop, в которых агенты могут учитывать работу друг друга. Создайте отдельный Space для проекта: тогда, например, Claude сможет продолжить работу Codex над тестом без повторного описания задачи. Spaces доступны на тарифе Pro.
Ранее агенты в Windsurf работали в отдельных сессиях: запустив Cascade, а затем Codex, пользователь не мог передать одному агенту сведения о действиях другого. Cognition предлагает для совместной работы Spaces.
Spaces созданы для того, чтобы связанные агенты могли обмениваться контекстом и совместно решать задачи.
В Space агенты получают доступ к следующему контексту:
- Изменениям в файлах, которые внесли другие агенты.
- Истории недавних задач и решений.
- Общим инструкциям проекта, например
CLAUDE.mdилиAGENTS.md. - Активным pull request и комментариям к ним.
Чтобы создать Space:
- Откройте Agent Command Center с помощью кнопки в верхней панели Devin Desktop.
- Нажмите
New Spaceв правом верхнем углу. - Привяжите к Space папку проекта.
- Добавьте нужных агентов из тех, что включены в Settings.
Пример последовательной работы трёх агентов:
- Codex создаёт в Space первую версию реализации.
- Claude Agent изучает результат, проводит проверку кода и улучшает сложные места.
- OpenCode готовит тесты для итогового варианта.
Все три агента используют общий AGENTS.md с правилами проекта и один файл задачи. Передавать контекст вручную заново не нужно.
В описанном в статье опыте с тремя проектами указаны два наблюдения: время от постановки задачи до готового pull request сократилось примерно на треть благодаря отсутствию пересказов, но вмешиваться вручную приходилось чаще, поскольку Codex и Claude иногда предлагали несовместимые изменения. Чёткие инструкции в AGENTS.md помогают согласовать работу.
Если у вас ещё нет AGENTS.md, пригодится руководство как использовать AGENTS.md и CLAUDE.md вместе: в нём описан общий файл инструкций для трёх агентов.
Как выбрать агента для задачи
Ключевая идея
Ниже приведены пять способов распределить задачи между Codex, Claude Agent и OpenCode в Devin Desktop. Выбор зависит от характера работы и нужного результата.
Сценарий 1. Типовая функция за 30 минут
Для CRUD-операций с новой таблицей, простой формы или страницы сайта можно начать с Codex. Он быстро подготовит вариант, который останется проверить перед использованием. Для такой задачи Claude может потратить больше времени на анализ, а OpenCode — уступить по скорости.
Сценарий 2. Архитектурное решение с компромиссами
Если нужно решить, выделять ли часть приложения в отдельный сервис или оставить её в монолите, либо выбрать Redux или Zustand для существующего проекта, полезно сравнить аргументы и последствия. В статье для такого разбора предлагается Claude: одного краткого ответа Codex может быть недостаточно для оценки компромиссов.
Сценарий 3. Тестирование уже написанного кода
После реализации можно поручить тесты другому агенту. Claude подходит для сложной бизнес-логики, а OpenCode можно использовать для интеграционных тестов API. В любом случае проверьте, что тесты охватывают важные граничные случаи.
Сценарий 4. Разработка без интернета
В самолёте, поезде или месте без связи облачные Codex и Claude недоступны, если для их работы необходим API. OpenCode с Ollama и локальной моделью позволяет продолжить разработку офлайн, хотя качество ответа может быть ниже.
Сценарий 5. Сравнение нескольких решений
Если вы не уверены в выбранном подходе, отправьте одну задачу всем трём агентам в Spaces. Сопоставьте ответы и выберите подходящий или объедините их. Это увеличит расход токенов, поэтому такой способ стоит применять для значимых задач.
В описанном в статье рабочем ритме 60% задач поручались Codex ради скорости, 30% — Claude ради качества, 10% — OpenCode для офлайн-работы. Раз в неделю сложную задачу запускали в Spaces сразу для всех трёх агентов, чтобы сравнить их предложения.
Тариф Devin Desktop и подписки агентов
Ключевая идея
Подключение ACP-агентов в Devin Desktop доступно на тарифах Pro (20 долларов в месяц), Max (200 долларов) и Teams (80 долларов за команду плюс 40 долларов за участника). Подписки на Codex и Claude оплачиваются отдельно.
После оплаты Devin Desktop для каждого агента может понадобиться собственная подписка или API-доступ:
- Codex — ChatGPT Plus или Team (от 20 долларов) либо API-ключ OpenAI с оплатой по факту использования.
- Claude Agent — Claude Pro (20 долларов), Max или API-ключ Anthropic.
- OpenCode — бесплатно при запуске локальной модели через Ollama.
Используйте учётные записи в соответствии с условиями поставщика; не передавайте одну учётную запись нескольким людям, если это запрещено такими условиями.
В расчёте на июнь 2026 года базовые подписки для связки из трёх агентов оценивались примерно в 60 долларов в месяц: Devin Pro (20), ChatGPT Plus (20) и Claude Pro (20). Если отказаться от Claude и оставить Codex с OpenCode, сумма составит 40 долларов.
Чем ACP отличается от MCP
Ключевая идея
ACP соединяет редактор и агента, а MCP связывает агента с инструментами и данными, например базой данных, файлами или API. Один агент может общаться с редактором через ACP, а со своими инструментами — через MCP. Эти протоколы решают разные задачи и дополняют друг друга.
ACP и MCP иногда смешивают, поскольку оба относятся к протоколам для агентных систем и могут использовать JSON-RPC. Различие состоит в том, какие компоненты они соединяют.
MCP (Model Context Protocol), разработанный Anthropic, позволяет подключать агента к источникам данных и инструментам. Через MCP-сервер агент может получать доступ к базе данных, файлам, API GitHub или Notion, а затем выбирать подходящий инструмент для работы.
ACP (Agent Client Protocol), созданный Zed и JetBrains, связывает редактор с агентом. IDE передаёт агенту выделенный фрагмент кода, открытые файлы и вызванную команду, а агент возвращает изменения, запросы на подтверждение или сведения о ходе задачи.
Один агент может использовать ACP для связи с редактором, а MCP — для взаимодействия с инструментами. Например, схема может выглядеть так:
┌─────────────────┐
│ Devin Desktop │ ← редактор
└────────┬────────┘
│ ACP (Apache 2.0, JSON-RPC поверх stdio)
┌────────▼────────┐
│ Claude Agent │ ← агент
└────────┬────────┘
│ MCP (Anthropic, JSON-RPC поверх HTTP или stdio)
┌────────▼────────┐
│ MCP-сервер │ ← инструмент (БД, файлы, API)
└─────────────────┘
Больше примеров настройки MCP приведено в отдельном руководстве MCP-серверы для Claude Code.
Ограничения по состоянию на июнь 2026 года
Ключевая идея
В Devin Desktop ACP используется в рабочей версии, но у интеграции есть ограничения. CLI агентов нужно устанавливать вручную, а некоторые расширенные возможности редактора могут поддерживаться только Devin Local.
По итогам двух недель испытаний, описанных в статье, выделены три ограничения.
Реестр не устанавливает CLI. Devin Desktop ожидает, что бинарные файлы агентов уже установлены. Заранее подготовленный скрипт может упростить установку, но этот шаг важно учитывать при настройке.
Некоторые возможности доступны не всем агентам. Согласно описанию в статье, редактирование нескольких файлов в одной транзакции полностью поддерживается только Devin Local. Codex и Claude через ACP получают команды на изменение файлов по одному. Для большинства задач это может быть достаточно, но при масштабном рефакторинге нескольких файлов следует учитывать различия.
Возможны конфликты параллельных изменений. Если два агента одновременно редактируют один файл в Space, одна версия может перезаписать другую. Если интерфейс не показывает конфликт, распределите между агентами разные файлы либо разрешите конфликт слияния вручную через pull request.
По сведениям JetBrains, поддержка ACP в IDE 25.3 RC находится в бета-версии:
Как развивается экосистема ACP
Ключевая идея
Список редакторов и агентов, совместимых с ACP, расширяется. В статье приводится оценка: в марте 2026 года экосистема включала более 25 агентов, а к июню в каталоге zed.dev/acp было указано свыше 60. Эти значения относятся к приведённому снимку экосистемы на тот момент.
ACP — один из развивающихся стандартов для агентных систем. Рядом с ним используются и другие протоколы:
- MCP от Anthropic связывает агента с инструментами и данными.
- A2A, представленный Google в апреле 2025 года, предназначен для взаимодействия независимых агентов без центрального координатора.
- ACP от Zed и JetBrains соединяет редактор с агентом.
Поддержка протоколов и планы поставщиков могут меняться, поэтому проверяйте актуальные объявления Cursor, Replit Agent и других редакторов. Если разные редакторы и агенты поддерживают общий протокол, пользователям становится проще подключать новые инструменты без отдельной интеграции для каждой пары.
Для разработчика это упрощает знакомство с новыми моделями без установки нескольких приложений. Если условия поставщика изменятся или сервис перестанет работать, совместимый агент можно будет подключить к другому редактору, поддерживающему ACP.
Настройка нескольких агентов — лишь часть рабочего процесса. Чтобы совместная работа давала полезный результат, сформулируйте общие правила проекта, передавайте каждому агенту необходимый контекст и согласуйте порядок изменений. Это помогает переключать инструменты и сохранять последовательность работы.
Источники
Познакомьтесь с Ailoot.
Подробнее
Вопросы и ответы
Почему агент не появился после изменения registry.json?
Проверьте установку его CLI, путь к настоящему исполняемому файлу и включение в Devin Settings → Agents. Реестр описывает запуск инструмента, но не устанавливает его и не выполняет авторизацию.
Заменяет ли ACP протокол MCP?
Нет. ACP соединяет редактор с агентом, а MCP — агента с инструментами и данными. В одном процессе агент может использовать ACP для редактора и MCP для базы данных.