클라우드 머신

이 페이지는 cmux Cloud 머신의 수명 주기를 설명합니다. 머신을 만드는 방법, 고를 수 있는 크기, 플랜 한도가 적용되는 방식, 그리고 일시 중지, 스냅샷, 포크, 삭제하는 방법을 다룹니다.

머신 만들기

앱에서는 File › New Cloud Machine(⇧⌘Y), 더하기 버튼 메뉴, 명령 팔레트, 또는 Cloud 사이드바의 더하기 버튼을 사용합니다. 표시되는 시트에서 크기와 선택 사항인 레이블을 입력합니다.

CLI에서는 cmux vm new가 머신을 만들고 그 머신에서 워크스페이스를 엽니다. 아무것도 열지 않고 만들려면 --detach를 사용합니다. 생성 요청이 재시도되면 cmux가 같은 요청을 재사용하므로 머신이 두 대 생기지 않습니다.

cmux vm new
cmux vm new --size 16g --name "search index"
cmux vm new --detach --json

생성에 실패하면 알림에서 재시도하거나, 오류를 보거나, 지원 요청용으로 오류를 복사할 수 있습니다.

크기

각 크기는 메모리, vCPU, 디스크를 함께 정합니다. 생성 시트나 --size로 크기를 고릅니다. Pro와 Team은 4g, 8g, 16g(2, 4, 8 vCPU)를 지원합니다. Max는 24g와 32g(12, 16 vCPU), 그리고 64g(32 vCPU)도 잠금 해제합니다.

크기를 고르지 않으면 새 머신은 8 GB 메모리를 사용합니다. cmux vm ls --json을 실행하면 플랜에서 허용하는 크기를 볼 수 있습니다.

플랜 한도

활성 머신은 하나의 vCPU 및 메모리 풀을 공유합니다. 큰 머신 한 대를 실행하거나 작은 머신 여러 대를 실행할 수 있습니다. 일시 중지된 머신은 풀을 사용하지 않습니다. 디스크는 머신마다 따로 정해지며 풀에 포함되지 않습니다.

• 무료 계정은 머신을 만들 수 없습니다.
• Pro 및 Founder's Edition 계정은 vCPU 20개와 40 GB 메모리를 공유하는 활성 머신을 최대 5대까지 가질 수 있습니다. 실행 중이거나 시작 중인 머신이 활성 머신입니다.
• Team 계정은 유료 시트 하나당 활성 머신을 최대 5대까지 가질 수 있습니다. 유료 시트 하나마다 팀 풀에 vCPU 20개와 40 GB 메모리가 추가됩니다.
• Max 계정은 vCPU 80개와 160 GB 메모리를 공유하는 활성 머신을 최대 5대까지 가질 수 있습니다. Max 머신 한 대는 64 GB와 vCPU 32개까지 사용할 수 있으며, 24 GB / 12 vCPU와 32 GB / 16 vCPU 크기도 포함됩니다. Pro와 Team은 16 GB와 vCPU 8개까지입니다.
• 새로 만들거나, 재개하거나, 크기를 늘리거나, 포크한 머신이 풀을 넘게 되면 cmux는 요청을 거부하고 풀 사용량을 보여 줍니다. 머신을 일시 중지하거나 삭제해 리소스를 확보하거나 Max로 업그레이드하세요.
• A machine larger than your plan allows is locked. You can list and delete it, but you cannot open it, run commands on it, resume it, or resize it until you upgrade.

현재 가격은 가격 페이지를 확인하세요. 사용량 기반 과금이나 초과 요금은 없습니다.

코딩 에이전트를 최신 상태로 유지

이 설정을 켜면 머신이 Claude Code, Codex, OpenCode, pi, agent-browser를 업데이트합니다. 머신을 만든 뒤와 연결할 때마다 확인하며, 24시간에 최대 한 번입니다. 업데이트는 분리된 상태로 실행되므로 연결을 막지 않습니다.

각 도구는 공식 GitHub 릴리스에서 가져오며, 릴리스 에셋의 sha256 다이제스트로 검증합니다. npm은 사용하지 않습니다. 릴리스는 공개된 지 3일이 지난 후에만 설치되며, 업데이트가 이전 버전을 설치하는 일은 없습니다. 실행 중인 에이전트는 시작할 때의 파일을 계속 사용하고, 업데이트가 실패하면 현재 버전이 그대로 남습니다.

마지막 확인 결과는 /etc/cmux/agent-updates.state에, 업데이트 로그는 /var/log/cmux-agent-updates.log에 있습니다. 실패한 확인은 다음 연결 때 다시 실행됩니다.

cat /etc/cmux/agent-updates.state
tail /var/log/cmux-agent-updates.log

새 머신 시트에서는 이 설정이 기본으로 켜져 있습니다. 기존 머신에서 바꾸려면 머신을 오른쪽 클릭하고 에이전트를 최신 상태로 유지를 선택하거나 cmux vm agent-updates를 실행하세요. cmux vm new는 --agent-updates latest를 전달하지 않으면 이미지의 버전을 유지합니다. 업데이트를 끄면 이미 설치된 버전이 유지됩니다.

cmux vm new --agent-updates latest
cmux vm agent-updates brave-otter
cmux vm agent-updates brave-otter image

업데이트는 github.com, api.github.com, objects.githubusercontent.com, release-assets.githubusercontent.com만 사용합니다. cmux는 허용 목록과 인터넷 없음을 포함한 모든 네트워크 모드에서 이 호스트를 허용하므로, 네트워크 정책이 업데이트를 막지 않습니다.

크기 조정

데이터 손실 없이 머신을 더 크게 만들 수 있습니다. 머신을 오른쪽 클릭하고 Resize machine을 선택하거나 cmux vm resize를 사용합니다. 크기 조정은 머신을 키우는 것만 가능합니다. 디스크는 Pro와 Team에서 4 GB 단위로 최대 128 GB, Max에서 최대 256 GB까지 늘릴 수 있습니다(Go는 16 GB로 제한됩니다). 메모리와 CPU는 Pro와 Team에서 최대 16 GB와 8 vCPU, Max에서 최대 64 GB와 32 vCPU까지 늘릴 수 있습니다. 머신이 클수록 풀을 더 많이 사용합니다. 실제 최대치는 플랜에 따라 정해집니다.

cmux vm resize brave-otter --memory 16G
cmux vm resize brave-otter --cpu 8 --disk 128G

일시 중지와 재개

cmux vm pause는 머신의 컴퓨팅을 중지합니다. 디스크, 워크스페이스, 터미널 기록은 유지되고, 실행 중인 프로세스는 중지됩니다. cmux vm resume은 머신을 다시 시작합니다. 일시 중지된 머신을 열거나 그 머신에서 명령을 실행해도 머신이 시작됩니다.

머신은 유휴 상태여도 스스로 일시 중지되지 않습니다. 일시 중지하거나 삭제할 때까지 계속 실행됩니다.

cmux vm pause brave-otter
cmux vm resume brave-otter
cmux vm wait brave-otter --wake --timeout 180

cmux vm wait는 머신이 준비될 때까지 기다립니다. --wake를 붙이면 일시 중지된 머신을 먼저 시작합니다. 스크립트에서 첫 명령을 실행하기 전에 유용합니다.

체크포인트, 포크, 복원

체크포인트는 머신의 디스크를 저장합니다. 포크는 머신의 현재 상태에서 새 머신을 만듭니다. 복원은 체크포인트에서 새 머신을 만듭니다. 체크포인트에는 머신의 환경 변수 파일도 포함됩니다.

위험한 변경 전에는 체크포인트를 만들고, 같은 출발점에서 두 가지 접근 방식을 동시에 시도할 때는 포크를 사용하세요.

cmux vm checkpoint brave-otter --name before-migration
cmux vm snapshot ls brave-otter
cmux vm restore <snapshot-id>
cmux vm fork brave-otter --name try-b
cmux vm snapshot rm brave-otter <snapshot-id>

Checkpoint와 Fork는 머신의 프로바이더가 지원할 때만 표시됩니다. 명령이 거부되면 해당 머신이 그 작업을 지원하지 않는 것입니다.

이름 변경

cmux vm rename은 표시 레이블을 설정하며, 인쇄 가능한 문자 최대 64자까지 가능합니다. 자동 생성된 이름은 머신의 ID로 유지됩니다. 레이블을 지우려면 --clear를 사용합니다.

cmux vm rename brave-otter "billing api"
cmux vm rename brave-otter --clear

상태와 통계

cmux vm status는 머신의 상태, 크기, 주소를 보여줍니다. cmux vm stats는 일시 중지된 머신을 깨우지 않고 CPU, 메모리, 디스크 사용량을 보여줍니다.

cmux vm status brave-otter
cmux vm stats brave-otter

삭제

머신을 삭제하면 머신과 디스크의 모든 내용이 영구적으로 삭제됩니다. 머신의 공개 URL도 제거되고 모델 접근 권한도 취소됩니다. 삭제는 되돌릴 수 없습니다.

나중에 파일이 필요할 것 같다면 먼저 체크포인트를 만드세요.

cmux vm rm brave-otter

플랜이 종료되면

유료 플랜이 종료되면 생성된 지 7일이 지난 머신은 잠깁니다. 목록 보기, 이름 변경, 삭제는 여전히 할 수 있지만, 열기, 명령 실행, 포트 포워딩, 재개는 할 수 없습니다. 머신과 파일은 유지됩니다. 다시 업그레이드하면 다시 연결할 수 있습니다. Cloud 사이드바에 Locked와 Upgrade to Reconnect 메뉴 항목이 표시됩니다.