cmux Cloud

cmux Cloud는 일반 cmux 워크스페이스로 열리는 영구적인 Linux 머신을 클라우드에서 제공합니다. 패널을 닫거나, 네트워크가 끊기거나, 노트북을 닫아도 터미널은 계속 실행되므로 코딩 에이전트는 작업을 이어가고, 로그인된 어떤 Mac에서든 다시 연결할 수 있습니다.

cmux Cloud는 얼리 액세스 단계이며 조직에서 비활성화하지 않은 경우 사용할 수 있습니다. 사용하려면 Settings › Beta Features › Cloud Machines를 켜세요.

머신이란

머신은 사용자 또는 팀에 속한 영구적인 클라우드 컴퓨터입니다. 파일, 설치한 도구, 실행 중인 터미널을 그대로 유지합니다. 쓰고 버리는 자원이 아니라 오래 쓰는 컴퓨터로 다루세요. 필요한 것을 한 번 설치하고 나중에 다시 돌아와 사용합니다.

모든 머신에서는 cmux TUI 데몬이 실행됩니다. 데몬은 머신의 워크스페이스와 터미널을 보관합니다. Mac의 cmux 패널은 머신에 있는 터미널을 보여줄 뿐이므로, 패널을 닫아도 프로세스는 절대 멈추지 않습니다.

머신 한 대에 여러 워크스페이스를 둘 수 있습니다. 작업마다 새 머신을 만드는 대신, 계속 사용하는 머신에서 작업마다 워크스페이스를 하나씩 쓰는 방식이 일반적입니다.

각 머신에는 brave-otter 같은 이름이 자동으로 생성됩니다. 이 이름이 앱과 CLI에서 머신의 ID입니다. 표시 레이블을 추가할 수 있지만 ID는 바뀌지 않습니다.

필요한 것

실행 중이고 로그인된 cmux macOS 앱. cmux CLI는 앱과 통신하며, 자격 증명은 앱이 보관합니다.
cmux 유료 플랜. 무료 계정은 머신을 만들 수 없습니다. 현재 플랜은 가격 페이지를 확인하세요. cmux.com/pricing
Settings › Beta Features에서 Cloud Machines가 켜져 있고 조직 정책에서 Cloud를 비활성화하지 않아야 합니다.
VPN, SSH 키, 포트 포워딩 설정이 필요 없습니다. cmux는 자동으로 시작되는 사설 네트워크를 통해 머신에 연결합니다.

빠른 시작

로그인합니다. 오른쪽 사이드바의 Cloud 탭을 사용하거나 터미널에서 로그인 명령을 실행하세요.
File › New Cloud Machine 또는 ⇧⌘Y로 머신을 만듭니다. 크기와 선택 사항인 레이블을 고릅니다. 생성은 백그라운드에서 진행되며, 머신이 준비되면 cmux가 알림을 표시합니다.
⌘Y(New Cloud Workspace)로 머신에서 워크스페이스를 엽니다. Cloud 워크스페이스 안에서 ⌘N을 누르면 항상 이 Mac에 로컬 워크스페이스가 생성됩니다.
에이전트를 실행합니다. Claude Code, Codex, OpenCode, Pi가 머신에 이미 설치되어 있습니다.

CLI에서도 같은 작업을 할 수 있습니다:

cmux auth login
cmux vm new --size 8g --name "api work"
cmux vm ls
cmux vm open brave-otter
cmux vm agent --agent claude --machine brave-otter --sync -- "fix the failing tests"

앱에서 Cloud 사용하기

오른쪽 사이드바의 Cloud 탭에 머신 목록이 표시됩니다. 각 머신 아래에는 워크스페이스, 포워딩된 포트, VNC 디스플레이, 터미널이 표시됩니다. 항목을 클릭하면 열립니다. 명령 팔레트에서 Open Cloud as Pane을 사용해 Cloud 트리를 패널로 열 수도 있습니다.

머신을 오른쪽 클릭하면 셸 열기, 워크스페이스 만들기, 데스크톱 열기, 전체 cmux TUI 클라이언트 열기, 크기 조정, 이름 변경, IP 주소 복사, 상태 확인, 체크포인트 만들기, 포크, 삭제를 할 수 있습니다. 머신을 고정하거나 순서를 바꿀 수도 있습니다.

New Cloud Machine(⇧⌘Y)과 New Cloud Workspace(⌘Y)는 File 메뉴, 더하기 버튼 메뉴, 명령 팔레트에 있습니다. 두 단축키 모두 설정에서 바꾸거나 cmux.json의 newCloudMachine, newCloudWorkspace 키로 바꿀 수 있습니다.

{
  "shortcuts": {
    "bindings": {
      "newCloudMachine": "cmd+shift+y",
      "newCloudWorkspace": "cmd+y"
    }
  }
}

CLI에서 Cloud 사용하기

cmux vm과 cmux cloud는 같은 명령입니다. 하위 명령 없이 cmux vm을 실행하면 머신 목록이 표시됩니다. 모든 하위 명령에는 앱 없이도 볼 수 있는 --help 페이지가 있으며, cmux vm guide는 전체 Markdown 가이드를 출력합니다. 어떤 하위 명령에든 --json을 붙이면 기계가 읽을 수 있는 출력을 얻습니다.

cmux vm              # list machines
cmux vm --help
cmux vm new --help
cmux vm guide        # full Markdown guide
cmux vm ls --json

기본 머신

각 계정에는 고정된 기본 머신이 한 대 있습니다. cmux vm base는 이 머신을 열고, 처음 실행할 때 만듭니다. cmux vm base reset은 새 기본 머신을 만들고 이전 머신도 유지하므로 실수로 파일을 잃지 않습니다.

cmux vm base
cmux vm base reset --reason "start clean"

다음 단계

이 페이지가 도움이 되었나요?

이슈 등록