devvm: изолированная ВМ для каждого проекта и AI-агента

Одна виртуальная машина для каждого проекта

Изолированная песочница с инструментальной цепочкой (toolchain) вашего проекта, готовая к работе — как для вас, так и для агента по написанию кода.

Установка

На macOS установите devvm с помощью Homebrew — он также установит Lima:

brew trust --formula devvmhq/tap/devvm
brew install devvmhq/tap/devvm

На Linux воспользуйтесь скриптом установки — он работает и на macOS и спрашивает разрешения перед установкой Lima, QEMU или открытием доступа к /dev/kvm:

curl -fsSL https://github.com/devvmhq/devvm/releases/latest/download/install.sh | bash

После этого запустите devvm doctor — команда проверит, всё ли необходимое есть на вашем компьютере, и подскажет, как установить недостающее.

Каждый релиз подписан ключом minisign: RWSjzFsn7ETaijKJ2y7F4DtZobXmyv+LmdclJwZP/KmAkLUwOCzWF/2b. В разделе Проверка скрипта установки описано, как проверить скрипт с его помощью перед запуском.

  • Требования: macOS 13 или новее, либо Linux, на архитектуре arm64 или x86_64, с Lima 2.2 или новее (требования Lima).

  • Протестировано на Mac с чипом Apple silicon, а также на Linux с arm64 и x86_64; на Intel Mac пока не тестировалось.

  • Раздел Установка содержит полный список требований и параметры скрипта установки, а Обновление и удаление расскажет, что делать дальше.

Быстрый старт

cd ~/some-project
devvm
  1. Перейдите в папку проекта. Откройте терминал и выполните cd в нужную директорию.

  2. Запустите devvm. Он покажет, что получит новая виртуальная машина для этой папки: инструментальные цепочки, которые определяются по файлам проекта. Подтвердите создание ВМ или настройте её — выберите инструментальные цепочки, агентов по написанию кода, слои, сетевой уровень и размер.

  3. Запустите агента. devvm откроет командную оболочку (shell) внутри ВМ по тому же пути, что и на вашем компьютере; приглашение будет начинаться с (devvm) — запустите там claude.

    • Повторный запуск devvm в той же папке откроет ту же ВМ.

    • В разделе Ваша первая ВМ — всё остальное.

Примечание

При первом запуске devvm задаёт несколько вопросов, устанавливающих параметры по умолчанию для всех новых ВМ и базового образа: размер и агенты по написанию кода для новых ВМ, а также дополнительные компоненты базового образа. Базовый образ собирается один раз — это занимает несколько минут. Последующие ВМ запускаются за секунды.

Совет

Claude Code требует авторизации перед первым запуском. Выполните devvm agent login claude из ВМ — данные сохранятся на вашем компьютере (Вход в Claude Code).

Что поддерживается

  • Инструментальные цепочки: devvm определяет их по файлам проекта — папка с package.json автоматически получает node. Полный список — на странице инструментальные цепочки.

  • Агенты по написанию кода: Claude Code, Codex, opencode, pi и Cursor CLI запускаются внутри ВМ вместе с вашими настройками, навыками и серверами MCP. devvm хранит их настройки и данные авторизации в собственном хранилище, а devvm agent import копирует их из агента, которым вы уже пользуетесь на своём компьютере (агенты по написанию кода).

  • Слои: встроенные слои docker, nix и desktop, а также собственные, создаваемые командой devvm layer new (слои).

  • Бэкенд: devvm запускает ВМ на Lima (бэкенды).

Зачем использовать devvm?

  • Изоляция: каждая папка проекта получает собственную ВМ, которая монтирует только эту папку по тому же пути, что и на вашем компьютере (к чему имеет доступ ВМ).

  • Сетевые уровни: новые ВМ по умолчанию получают уровень со списком разрешённых хостов (allowlist), то есть могут подключаться только к тем хостам, которые вы явно разрешили (сетевые уровни).

  • Секреты остаются у вас: на любом уровне ваши секреты — например, токен GitHub или токен Claude Code — хранятся на вашем компьютере.

  • Агент работает в песочнице: вы запускаете агента в оболочке ВМ, так что устанавливать его на свой компьютер не нужно.

  • Готова за секунды: каждая ВМ — это копия базового образа, а инструментальные цепочки используются совместно в режиме только для чтения (образы).

  • Никакая песочница не закрывает все уязвимости: несколько простых привычек закрывают большинство из того, с чем devvm не справится сам, — прочитайте Безопасная работа, прежде чем доверять ВМ важный проект.

Работа с клоном

По умолчанию ВМ монтирует папку вашего проекта, и ВМ с редактором работают с одними и теми же файлами. С флагом --clone ВМ получает собственный клон репозитория — ничто внутри неё не может затронуть ваше рабочее дерево или .git, а результаты работы попадают в ваш репозиторий только тогда, когда вы сами их забираете:

devvm --clone                 # создать ВМ с собственным клоном и открыть в ней оболочку
git fetch devvm               # позже, на этом компьютере, забрать результаты работы ВМ как devvm/<branch>
git log -p main..devvm/main   # просмотреть их перед слиянием

Подробности — в разделе Работа с клоном.

Документация

Документация размещена на devvm.dev, исходные файлы — в папке docs/.

Безопасность и участие в разработке

Лицензия

MIT

© 2026 meganuke