Cloud 워크스페이스와 에이전트

Cloud 워크스페이스는 로컬 cmux 워크스페이스처럼 동작하지만, 터미널은 클라우드 머신에서 실행됩니다. 이 페이지는 영구 터미널, 에이전트 실행, 알림, 그리고 모든 머신에 설치된 도구를 다룹니다.

영구 터미널

터미널은 Mac이 아니라 머신의 데몬에 있습니다. 패널을 닫거나, cmux를 종료하거나, Wi-Fi가 끊기거나, 노트북을 닫아도 계속 실행됩니다. 로그인된 어떤 Mac에서든 머신을 다시 열면 터미널의 출력과 실행 중인 프로세스가 그대로 있습니다.

연결이 끊기면 패널에 Cloud session disconnected와 Reconnect 버튼이 표시되고, cmux가 자동으로 재시도합니다.

머신의 데몬이 재시작되면 cmux는 워크스페이스 레이아웃을 복원하지만, 실행 중이던 프로세스는 재시작 후 남아 있지 않습니다.

워크스페이스를 닫으면 터미널은 분리된 상태로 계속 실행됩니다. 워크스페이스를 제거하면 터미널이 중지됩니다.

코딩 에이전트 실행

모든 머신에 Claude Code, Codex, OpenCode, Pi가 설치되어 있습니다. Cloud 워크스페이스를 열고 로컬에서처럼 에이전트를 시작하세요. 에이전트 훅이 이미 설정되어 있어 에이전트 상태와 알림이 Mac으로 전달됩니다.

cmux vm agent는 Mac에서 머신의 에이전트를 시작합니다. 프롬프트를 주면 에이전트의 원샷 모드를 사용합니다. 현재 디렉터리를 먼저 업로드하려면 --sync를, 결과를 기다리려면 --wait를 붙입니다.

cmux vm agent --agent claude --machine brave-otter -- "add tests for the parser"
cmux vm agent --agent codex --machine brave-otter --sync --wait -- "fix the build"
cmux vm agent --agent opencode --new --size 16g -- "profile the importer"

cmux vm prompt는 로컬 에이전트용 cmux Cloud 스킬을 설치하고, Cloud 머신 사용법을 알려주는 프롬프트를 출력합니다.

cmux vm prompt --open claude

명령 실행

cmux vm run은 머신에서 명령을 실행하고 종료 코드를 반환합니다. 어떤 디렉터리에서 처음 실행하면 머신을 하나 고르고, 그 디렉터리에 대해 14일 동안 기억합니다. 디렉터리를 먼저 업로드하려면 --sync를, 결과를 다운로드하려면 --pull을 붙입니다.

cmux vm run -- npm test
cmux vm run --sync --pull dist -- npm run build
cmux vm route --json

cmux vm exec는 터미널 없이 짧은 명령을 실행합니다. 빠른 확인용입니다. 시간 제한은 기본 30초, 최대 5분입니다. 오래 걸리는 작업에는 cmux vm run, cmux vm agent, 또는 워크스페이스 터미널을 사용하세요.

cmux vm exec brave-otter -- uname -a
cmux vm exec --timeout 120 brave-otter -- docker ps

개발 서버 시작

cmux vm dev는 프로젝트를 업로드하고, 시작 방법을 찾아, 서버와 브라우저가 있는 워크스페이스에서 엽니다. package.json 프로젝트, Cargo, Go, Makefile dev 타깃, Django, uv, pyproject, requirements.txt, 정적 index.html 사이트를 감지합니다. 먼저 계획을 확인하려면 --dry-run을 사용하세요.

cmux vm dev brave-otter --dry-run
cmux vm dev brave-otter . --port 3000

알림

머신 안에서 cmux notify를 실행하면 해당 터미널에 대한 알림이 Mac에 표시됩니다. 에이전트 훅은 에이전트가 완료되었을 때, 승인이 필요할 때, 질문할 때, 실패했을 때 알림을 보냅니다. 제목은 128바이트, 본문은 1 KB로 제한되며, 한꺼번에 몰리는 알림에는 속도 제한이 적용됩니다.

# Inside a Cloud machine
cmux notify --title "Build" --body "Tests passed"

이미지 붙여넣기

클립보드에 이미지가 있는 상태에서 Cloud 터미널에서 ⌘V를 누르세요. cmux가 이미지를 머신에 업로드하고 원격 경로를 붙여넣으므로 Claude Code와 Codex가 이미지를 읽을 수 있습니다. PNG, JPEG, GIF, WebP를 지원하며, 이미지당 최대 20 MB, 한 번에 8개까지 가능합니다.

CLI에서 레이아웃과 터미널 다루기

cmux vm workspace는 머신의 워크스페이스를 만들고, 열고, 이름을 바꾸고, 닫고, 제거합니다. cmux vm terminal은 텍스트를 보내고, 출력을 읽고, 특정 텍스트나 종료를 기다립니다. cmux vm tree는 머신의 워크스페이스와 터미널을 보여줍니다. cmux vm layout export와 apply는 cmux new-workspace --layout과 같은 JSON을 사용합니다.

cmux vm tree brave-otter
cmux vm workspace new brave-otter --name review
cmux vm terminal send brave-otter term_2f9c "npm run dev" --keys enter
cmux vm terminal wait brave-otter term_2f9c --pattern "ready" --timeout 60
cmux vm terminal read brave-otter term_2f9c
cmux vm layout export brave-otter review > layout.json
cmux vm layout apply brave-otter layout.json --open

설치된 도구

머신은 Ubuntu 24.04에서 실행됩니다. root가 아니라, 비밀번호 없이 sudo를 쓸 수 있는 사용자 cmux로 작업합니다. Docker는 부팅 시 시작됩니다.

• 언어와 도구: Node.js LTS, Bun, Python 3.12, uv, Docker, git, GitHub CLI, ripgrep, fd, fzf, jq, tmux, sqlite3, 빌드 도구, vim, nano, rsync.
• 브라우저와 데스크톱: Chrome, agent-browser, VNC 데스크톱, Ghostty.
• 에이전트: Claude Code, Codex, OpenCode, Pi. 테스트된 버전으로 고정되어 있으며, 머신 이미지가 업데이트될 때 함께 업데이트됩니다.

머신을 만든 직후 에이전트 명령을 찾을 수 없다면 아직 설정이 진행 중인 것입니다. 설정 로그는 /tmp/cmux/provision.log에 있습니다.

모델 접근

머신의 에이전트는 머신에 키를 두지 않고도 cmux의 모델 라우팅을 사용할 수 있습니다. 실제 자격 증명은 머신 외부에서 추가되므로 VM에는 계정 토큰이 저장되지 않습니다. 머신 안에서 에이전트에 로그인하거나, cmux ai-accounts upload로 팀용 계정을 업로드할 수도 있습니다.

cmux ai-accounts list
cmux ai-accounts upload claude
cmux coderouter status

CodeRouter 문서: 지원 계정, 공유, 사용량

머신 안의 cmux CLI

머신 안에서 cmux 명령은 해당 머신의 세션을 제어합니다. tree, new-workspace, new-split, send, send-key, read-screen, terminal, layout, env, notify, open-url, self를 지원합니다. cmux self는 소유자, 현재 머신, 다른 머신을 보여줍니다. cmux vm verb peer를 사용하면 머신 안에서 다른 머신을 제어할 수 있습니다.

# Inside a Cloud machine
cmux tree
cmux new-split right
cmux self peers
cmux vm exec calm-heron -- git status

로그인, AI 계정 업로드, 그리고 new, delete, checkpoint, fork, resize, pause, domains, open, vpn 같은 머신 수명 주기 명령은 Mac에서만 실행됩니다.

iPhone

cmux iOS 앱은 Cloud 머신을 관리하지 않습니다. 시작 중인 머신은 자리 표시자 카드로 표시됩니다.