文档 / 快速上手

连接你的 Agent。
保留对机器的掌控。

同一个 vm-cli 程序服务于终端、原生管理器和 Agent 工作流。

1. 下载匹配的程序

选择适合宿主和 CPU 架构的下载。在 Windows 上,进入程序所在目录运行以下命令。

下载

2. 查看版本与帮助

可复制的 CLI 用法示例
.\vm-cli.exe version
.\vm-cli.exe --help

完整英文 CLI 手册

3. 安装 Agent Skill

可复制的 CLI 用法示例
.\vm-cli.exe setup --clients codex

也可以打开管理器,选择 Agent Skill。Agent 客户端仍使用自己的 AI 模型和登录方式,vm-cli 不包含模型。

4. 创建并启动本地虚拟机

可复制的 CLI 用法示例
.\vm-cli.exe create lab --preset modern-x64
.\vm-cli.exe start lab

这会创建虚拟机,并不会安装操作系统。按需挂载合适的安装介质,或使用已有系统的本地虚拟机。

这里的创建示例适用于 x64 宿主。在 ARM64 上请选择 arm64 预设。使用 host inspect 和 preset list 查看实际环境。

macOS 和 Linux 使用 ./vm-cli 代替 .\vm-cli.exe,并用 chmod +x vm-cli 为下载的文件添加执行权限。

5. 打开画面

可复制的 CLI 用法示例
.\vm-cli.exe view lab --viewer sdl

用截图查看当前画面。需要观察或接管时打开查看器。让已安装的 Skill 引导 Agent 使用控制会话和受支持的输入命令。

vm-cli 1.1.1 Windows 管理器,显示虚拟机列表和工具栏上的 Agent Skill 入口。

硬件与安装介质

修改前先检查配置与设备。需要 --revision 的操作应使用 config show 返回的版本号。完整 CLI 手册解释了 media attach、存储、网络和输入控制权。

可复制的 CLI 用法示例
.\vm-cli.exe config show lab
.\vm-cli.exe device list lab
.\vm-cli.exe media list lab

你的虚拟机,跨电脑统一管理。

本机和已登记电脑上的虚拟机,在同一个列表里。用镜像创建副本、调整硬件、接管画面,命令行、原生管理器和浏览器都能完成。

Windows · x64 · macOS · Apple Silicon ARM64 · macOS · Intel x64 · Linux · x64 · Linux · ARM64

可复制的 CLI 用法示例
vm-cli ls
vm-cli ps
vm-cli run --image ./images/dev --on local --name dev-copy
vm-cli run --image cloud://dev-images:v3 --on office-win --name dev-remote

虚拟机在你自己的电脑上运行。Cloud 保存镜像、帮助设备发现彼此,不包含云端电脑租用。

打开指南

版本 · Windows x64 ·

Windows:让虚拟机连成网络

独立 NAT、共享 NAT、内部网络和有线桥接。支持多网卡与 TCP/UDP 端口转发,CLI、原生 GUI、Web 均可管理。

仍是一个已签名 EXE。首次经管理员批准安装 Windows 服务,之后 Agent、CLI、GUI、Web 的日常桥接操作通过服务完成,无需反复提权。客户端与服务的版本号、构建 ID 必须完全一致;更换构建时需批准服务更新。内嵌原版签名 SeLow 驱动,使用兼容的有线网卡,宿主 IP、网关和 DNS 保持原位。 本次修复宿主机向虚拟机传输大文件缓慢,以及物理网卡重连后的连接恢复。准备桥接时,服务仅管理所选网卡的 IPv4 大包发送设置,可能短暂重连;撤销该网卡最后一个桥接授权后恢复原设置。 本版还修复了授权撤销后现有桥接连接的及时关闭,并改善共享 NAT 的传输响应。

Windows x64 · 2026-10-25 · 1.1.1

更新后,请用新版程序刷新 Agent Skill。

可复制的 CLI 用法示例
.\vm-cli.exe setup --action update --clients codex
.\vm-cli.exe setup --action check --clients codex

Windows 网络功能手册 · 打开指南 · 第三方声明

版本 · Linux / macOS · 2026-10-25

Linux 与 Mac:让虚拟机连成网络

独立 NAT、共享 NAT、内部网络和有线桥接。支持多网卡与 TCP/UDP 端口转发,CLI、原生 GUI、Web 均可管理。

Linux:已在 Ubuntu 24.04.4、NetworkManager 1.46 有线环境验证。宿主桥接准备需要本机管理员批准,不会自动更改现有 VPN 路由或防火墙规则。

Mac:分别提供 Intel x64 和 Apple Silicon ARM64 版本,均已签名并通过 Apple 公证。实测系统为 Intel macOS 12.7.6、Apple Silicon macOS 26.5.1。有线 vmnet 桥接需要本机授权;Wi-Fi 桥接不在已验证范围。

Linux ARM64 和两种 Mac 的休眠恢复测试暂缓,不宣称已经验证。

更新后,请用新版程序刷新 Agent Skill。

可复制的 CLI 用法示例
./vm-cli setup --action update --clients codex
./vm-cli setup --action check --clients codex

打开指南 · 第三方声明

从你的 AGENT 开始

发出一句请求。
让 Agent 准备就绪。

把这段请求发给能够阅读网页、在你电脑上执行命令的 Agent。

CodexClaude CodeOpenCode

请阅读 https://vm-cli.com/agent-install.md,按照指南下载适合这台电脑操作系统和 CPU 架构的官方 vm-cli,校验 SHA-256,完成安装,为我使用的 Agent 配置 vm-cli Skill,并检查帮助命令能正常运行。

Agent 需要获得在这台电脑上操作的权限。系统弹出的授权提示,请由你本人确认。

然后,交给它一个真正的任务。

请用 vm-cli 检查这台电脑的能力,在官方目录中寻找兼容的 Ubuntu 系统,帮我运行起来,准备好后打开桌面给我看。

语言

选择语言,保留当前页面。

Englishen简体中文zh-CN繁體中文zh-TWEspañolesFrançaisfrDeutschdePortuguês (Brasil)pt-BRРусскийru日本語ja한국어koالعربيةarहिन्दीhi

外观

跟随设备设置,或选择一种外观。

暂时无法下载

无法开始下载,请重试或返回下载页选择其他平台。

下载