Одна виртуальная машина для каждого проекта
Изолированная песочница с инструментальной цепочкой (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
-
Перейдите в папку проекта. Откройте терминал и выполните
cdв нужную директорию. -
Запустите devvm. Он покажет, что получит новая виртуальная машина для этой папки: инструментальные цепочки, которые определяются по файлам проекта. Подтвердите создание ВМ или настройте её — выберите инструментальные цепочки, агентов по написанию кода, слои, сетевой уровень и размер.
-
Запустите агента. devvm откроет командную оболочку (shell) внутри ВМ по тому же пути, что и на вашем компьютере; приглашение будет начинаться с
(devvm)— запустите тамclaude.-
Повторный запуск
devvmв той же папке откроет ту же ВМ. -
В разделе Ваша первая ВМ — всё остальное.
-
|
Примечание
|
При первом запуске devvm задаёт несколько вопросов, устанавливающих параметры по умолчанию для всех новых ВМ и базового образа: размер и агенты по написанию кода для новых ВМ, а также дополнительные компоненты базового образа. Базовый образ собирается один раз — это занимает несколько минут. Последующие ВМ запускаются за секунды. |
|
Совет
|
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?
-
Изоляция: каждая папка проекта получает собственную ВМ, которая монтирует только эту папку по тому же пути, что и на вашем компьютере (к чему имеет доступ ВМ).
-
Сетевые уровни: новые ВМ по умолчанию получают уровень со списком разрешённых хостов (allowlist), то есть могут подключаться только к тем хостам, которые вы явно разрешили (сетевые уровни).
-
Секреты остаются у вас: на любом уровне ваши секреты — например, токен GitHub или токен Claude Code — хранятся на вашем компьютере.
-
Агент работает в песочнице: вы запускаете агента в оболочке ВМ, так что устанавливать его на свой компьютер не нужно.
-
Готова за секунды: каждая ВМ — это копия базового образа, а инструментальные цепочки используются совместно в режиме только для чтения (образы).
-
Никакая песочница не закрывает все уязвимости: несколько простых привычек закрывают большинство из того, с чем devvm не справится сам, — прочитайте Безопасная работа, прежде чем доверять ВМ важный проект.
Работа с клоном
По умолчанию ВМ монтирует папку вашего проекта, и ВМ с редактором работают с одними и теми же файлами. С флагом --clone ВМ получает собственный клон репозитория — ничто внутри неё не может затронуть ваше рабочее дерево или .git, а результаты работы попадают в ваш репозиторий только тогда, когда вы сами их забираете:
devvm --clone # создать ВМ с собственным клоном и открыть в ней оболочку
git fetch devvm # позже, на этом компьютере, забрать результаты работы ВМ как devvm/<branch>
git log -p main..devvm/main # просмотреть их перед слиянием
Подробности — в разделе Работа с клоном.
Документация
Документация размещена на devvm.dev, исходные файлы — в папке docs/.
-
Начало работы: установка devvm, первая ВМ и наиболее часто используемые команды.
-
Использование devvm: образы и инструменты, клоны, связи между ВМ, порты и размер, агенты по написанию кода, SSH и редакторы, устранение неполадок.
-
Безопасная работа: привычки, которые обеспечат вашу безопасность, сетевые уровни, защита
.gitи векторы атак. -
Бэкенды: Lima, на котором работают ВМ, и всё, что он им предоставляет.
-
Сравнение с другими инструментами: чем devvm отличается от Docker Sandboxes и других песочниц.
-
Справочник CLI: все команды с аргументами и флагами.
-
Как это работает: внутреннее устройство devvm — для проверки заявлений и анализа безопасности.
-
Участие в разработке: сборка, тестирование и написание документации.
Безопасность и участие в разработке
-
Об уязвимостях сообщайте в соответствии с инструкциями в SECURITY.md.
-
Правила сборки, тестирования и написания документации — в CONTRIBUTING.md и на страницах Участие в разработке.