给每个项目文件夹开一台独立的虚拟机:工具链按项目文件自动识别,Claude Code、Codex 这些 agent 直接在虚拟机里跑,而你的密钥和配置留在本机。
发布时间:2026 年 11 月 11 日|项目:devvmhq/devvm(近 7 天新建,约 537 Star,MIT 许可)|来源:项目 README 与官方文档 devvm.dev
一、它解决的问题
把 agent 放进真实项目,它看得见你的 home 目录、你的 token、你其它的代码仓库。权限给多了不安全,给少了它干不了活。devvm 把边界划在”项目文件夹”这一层:每个项目一台虚拟机,这台虚拟机只挂载它对应的那个文件夹,路径和你本机完全一致。你在宿主机上看到的是同一个目录,VM 里看到的也是它,但别的东西它碰不到。
二、几个实打实的设计
- 秒级就绪:每台 VM 都是同一张基础镜像的副本,工具链在 VM 之间只读共享,所以第一台建你要等几分钟,后面都是秒级
- 工具链自动识别:文件夹里有 package.json 就给 node,识别规则在文档的 toolchains 页里列全了,不用手写 Dockerfile
- agent 住进沙箱:Claude Code、Codex、opencode、pi 都在 VM 内运行,设置、技能、MCP 跟着你走,不用装到宿主机上;
devvm agent import可以把本机已有 agent 的配置和登录状态导进去 - 网络分层:新 VM 默认走白名单层,只能连你明确允许的主机
- 密钥不出本机:不管你选哪一层网络,GitHub token、Claude Code token 这类密钥都留在宿主机
- 克隆模式:运行时加克隆参数,VM 拿到的是仓库自己的 clone,碰不到你的工作树和 .git,成果要 fetch 回来才算数:
devvm --clone
- 可扩展:内置 docker、nix、desktop 三个层,也能用
devvm layer new自己造
三、安装
macOS 用 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,它会逐项检查这台机器缺什么、怎么补。
- 要求:macOS 13 或更新,或 Linux;arm64 或 x86_64;Lima 2.2 以上
- 官方测试过 Apple Silicon Mac 与 Linux(arm64 / x86_64),尚未在 Intel Mac 上测试
- 每个版本都用 minisign 签名,公钥是
RWSjzFsn7ETaijKJ2y7F4DtZobXmyv+LmdclJwZP/KmAkLUwOCzWF/2b,官方文档给了校验安装脚本的具体步骤——curl | bash这种写法,先验签再执行比较稳妥
四、上手只有两步
cd ~/some-project devvm
它会先列出这台新 VM 将得到的工具链,你确认或自定义(工具链、要装哪些 agent、层、网络层、容量),然后给你一个 shell。提示符以 (devvm) 开头,说明你已经在虚拟机里,在这里跑 claude 就行。同一个目录再跑一次 devvm,打开的是同一台 VM。
两个小细节:首次运行会问你几个默认项(新 VM 的容量、装哪些 agent、基础镜像的附加组件),基础镜像在那时构建一次;Claude Code 第一次启动前要在 VM 里登录,用 devvm agent login claude 走一遍,登录凭据会留在你的机器上。
五、适合谁,以及别指望它什么
- 适合:同时维护多个项目、又想让 agent 进来干活的开发者;想给 agent 划死权限边界的人;在 macOS 上但项目需要 Linux 工具链的人
- 不适合:只用 Windows 的人(当前只支持 macOS 与 Linux);已经用容器方案管好一切、不觉得有缺口的人
- 别指望:沙箱不能堵住所有漏洞,README 自己就写了这句话,并让用户先去读 Safety 文档再信任一台 VM。它能保证的是边界清楚,不是绝对安全
六、许可
MIT 许可(Copyright 2026 w3cj),可自由使用、修改、分发,包括商用。
来源
- 项目仓库:github.com/devvmhq/devvm
- 官方文档:devvm.dev/docs
本文据项目 README 与 LICENSE 整理,命令与要求为原文档口径;实际安装前建议按官方 Safety 文档评估权限范围。