문서 / 빠른 시작

에이전트를 연결하고.
머신 제어는 손안에.

동일한 vm-cli 실행 파일이 터미널, 네이티브 관리자와 에이전트 작업을 지원합니다.

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을 선택해도 됩니다. AI 모델과 로그인은 에이전트 클라이언트가 제공합니다. vm-cli에는 모델이 포함되지 않습니다.

4. 로컬 머신 생성 및 시작

CLI 사용 예
.\vm-cli.exe create lab --preset modern-x64
.\vm-cli.exe start lab

이 명령은 VM을 생성하며 운영체제를 설치하지 않습니다. 필요한 설치 미디어를 연결하거나 이미 설치된 로컬 머신을 사용하세요.

생성 예제는 x64 호스트용입니다. ARM64에서는 arm64 프리셋을 선택하세요. host inspect와 preset list로 실제 환경을 확인합니다.

macOS와 Linux에서는 .\vm-cli.exe 대신 ./vm-cli를 사용합니다. chmod +x vm-cli로 실행 권한을 설정하세요.

5. 화면 열기

CLI 사용 예
.\vm-cli.exe view lab --viewer sdl

스크린샷으로 현재 화면을 확인하세요. 관찰하거나 직접 조작할 때 뷰어를 엽니다. 설치한 Skill이 제어 세션과 지원 입력 명령을 에이전트에 안내합니다.

가상 머신과 Agent Skill 도구 모음을 표시하는 vm-cli 1.1.1 Windows 관리자.

하드웨어와 설치 미디어

변경 전에 구성과 장치를 확인하세요. --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, 내부 네트워크, 유선 브리지를 지원합니다. CLI, 네이티브 GUI, Web에서 여러 네트워크 카드와 TCP/UDP 포트 전달을 관리하세요.

서명된 단일 EXE입니다. 관리자 승인으로 Windows 서비스를 처음 설치하면 이후 Agent, CLI, GUI, Web의 일상적인 브리지 작업은 반복 승인 없이 서비스를 통해 실행됩니다. 클라이언트와 서비스의 버전 및 빌드 ID는 정확히 일치해야 하며, 빌드 변경 시 서비스 업데이트를 승인해야 합니다. 원본 서명 SeLow 드라이버가 내장되어 있습니다. 호환되는 유선 Ethernet이 필요하며 호스트 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, 내부 네트워크, 유선 브리지를 지원합니다. CLI, 네이티브 GUI, Web에서 여러 네트워크 카드와 TCP/UDP 포트 전달을 관리하세요.

Linux: Ubuntu 24.04.4, NetworkManager 1.46 및 유선 Ethernet에서 검증했습니다. 브리지 준비에는 로컬 관리자 승인이 필요하며 기존 VPN 경로나 방화벽 규칙을 자동으로 변경하지 않습니다.

Mac: Intel x64 및 Apple Silicon ARM64 전용 빌드를 제공하며 Developer ID 서명과 Apple 공증을 받았습니다. macOS 12.7.6(Intel) 및 26.5.1(Apple Silicon)에서 검증했습니다. 유선 vmnet 브리지는 로컬 승인이 필요하며 Wi-Fi 브리지는 검증하지 않았습니다.

Linux ARM64 및 두 Mac 빌드의 절전 복귀 테스트는 보류했으며 검증 완료로 표시하지 않습니다.

업데이트 후 새 실행 파일에서 Agent Skill을 갱신하세요.

CLI 사용 예
./vm-cli setup --action update --clients codex
./vm-cli setup --action check --clients codex

안내 열기 · 타사 고지

에이전트로 시작하기

요청 한 번이면.
준비는 에이전트가.

웹을 읽고 컴퓨터에서 명령을 실행할 수 있는 에이전트에게 붙여 넣으세요.

CodexClaude CodeOpenCode

https://vm-cli.com/agent-install.md 를 읽고 가이드에 따라 이 컴퓨터의 운영체제와 CPU 아키텍처에 맞는 공식 vm-cli를 다운로드하고 SHA-256을 검증한 뒤 설치해 주세요. 사용하는 에이전트에 vm-cli Skill을 설정하고 도움말 명령이 작동하는지 확인해 주세요.

에이전트가 이 컴퓨터를 조작할 권한이 필요합니다. 시스템 권한 요청은 직접 확인하세요.

이제 실제 작업을 맡겨 보세요.

vm-cli로 이 컴퓨터의 기능을 확인하고 공식 카탈로그에서 호환되는 Ubuntu 시스템을 찾아 실행하도록 도와주세요. 준비되면 데스크톱을 보여 주세요.

언어

언어를 바꿔도 현재 페이지가 유지됩니다.

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

화면 모드

시스템 설정을 따르거나 화면 모드를 선택하세요.

일시적으로 다운로드할 수 없습니다

다운로드를 시작하지 못했습니다. 다시 시도하거나 다른 플랫폼을 선택하세요.

다운로드