文檔 / 快速上手

連接你的 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

外觀

跟隨設備設置,或選擇一種外觀。

暫時無法下載

無法開始下載,請重試或返回下載頁選擇其他平臺。

下載