1편 tmux 첫걸음에서는 터미널 안에서 실행하는 tmux로 Claude Code 세션을 살려 두는 법을 정리했습니다. 2편은 요즘 자주 보이는 cmux입니다. 이름이 비슷해서 tmux를 대신하는 도구로 오해하기 쉬운데, cmux는 맥 전용 터미널 앱이고 하는 일도 다릅니다. 1편의 tmux와 나란히 놓고, 어떻게 쓰는지와 다른 도구와 무엇이 다른지 정리합니다.
내용은 cmux 공식 저장소(manaflow-ai/cmux)의 README와 문서, v0.64 기준입니다.
cmux는 맥 전용 터미널 앱입니다
cmux는 macOS에서만 돌아가는 터미널 앱입니다. iTerm, Ghostty, Wave와 같은 자리에 있습니다. 화면 그리기는 Ghostty 엔진(libghostty)을 쓰고, 앱은 Electron이 아니라 Swift와 AppKit으로 만든 네이티브 앱이라 가볍습니다. 기존 Ghostty 설정 파일의 테마, 글꼴, 색을 그대로 읽고, 오픈소스(GPL)이며 무료입니다. 올해 1월에 공개되어 GitHub 별이 2만 7천 개를 넘었습니다.
1편의 tmux는 앱이 아니라 터미널 안에서 실행하는 명령어였습니다. 그래서 둘은 하나를 고르는 관계가 아니라, cmux라는 창 안에서 tmux를 쓸 수도 있는 관계입니다.
만든 사람은 Claude Code와 Codex를 여러 개 띄워 놓고 일하다가, macOS 알림이 늘 "Claude is waiting for your input"뿐이라 어느 세션이 부르는지 알 수 없었고 탭이 많아지자 제목도 안 읽혔다고 합니다. 그래서 터미널은 그대로 두고 "어느 에이전트가 나를 기다리는지"가 보이게 만든 것이 cmux입니다.
1편 tmux와 나란히 보면
가장 큰 차이는 실행 중인 프로그램을 누가 붙들고 있느냐입니다. tmux는 뒤에서 도는 tmux 서버가 붙들고 있어서 창을 닫거나 SSH가 끊겨도 프로그램이 계속 돕니다. cmux는 앱이 프로그램을 띄우므로 앱을 끄면 프로그램도 끝납니다. 대신 다시 켜면 화면 배치와 지난 출력을 되살리고, Claude Code 같은 에이전트는 지난 대화로 이어서 다시 시작합니다.
| 항목 | tmux (1편) | cmux |
|---|---|---|
| 정체 | 터미널 안에서 실행하는 명령어 | 터미널 앱 |
| 돌아가는 곳 | macOS, Linux, 원격 서버 | macOS만 |
| 창이나 앱을 닫으면 | 프로그램은 계속 돌고 나중에 다시 붙음 | 프로그램은 끝남. 다시 켜면 배치·폴더·출력 복원, 에이전트는 대화 이어서 재시작 |
| 재부팅 후 | resurrect·continuum 플러그인을 깔면 배치·폴더 복원 | 기본으로 배치·폴더·출력 복원, 에이전트 대화 재개 |
| 조작 | Ctrl+b 다음 키 | Cmd 단축키, 마우스, 명령 팔레트 |
| 에이전트 알림 | 없음 | 패널 테두리, 사이드바, 알림 패널 |
| 브라우저 | 없음 | 내장, 에이전트가 조작 가능 |
한 줄로 줄이면 tmux는 "프로그램을 살려 두는 도구", cmux는 "여러 에이전트를 한눈에 보고 다루는 창"입니다.
설치와 기본 사용법
공식 사이트나 GitHub 릴리스에서 DMG를 받아 응용 프로그램 폴더로 옮기거나, Homebrew로 설치합니다. 업데이트는 앱이 알아서 합니다.
$ brew tap manaflow-ai/cmux $ brew install --cask cmux
용어는 이렇게 대응합니다. cmux의 작업 공간(workspace)은 사이드바의 세로 탭 하나로 tmux의 세션에 가깝고, 그 안의 탭(surface)과 패널(pane)이 tmux의 창과 패널입니다. 1편에서 익힌 tmux 단축키를 cmux로 옮기면 다음과 같습니다.
| 하고 싶은 것 | tmux (1편) | cmux |
|---|---|---|
| 좌우로 나누기 | Ctrl+b % | Cmd+D |
| 위아래로 나누기 | Ctrl+b " | Cmd+Shift+D |
| 옆 패널로 이동 | Ctrl+b 방향키 | Option+Cmd+방향키 |
| 새 탭(창) | Ctrl+b c | Cmd+T |
| 새 작업 공간(세션) | tmux new -s 이름 | Cmd+N |
| 작업 공간 이동 | Ctrl+b s 후 선택 | Cmd+1~8 |
| 패널 닫기 | Ctrl+b x | Cmd+W |
| 지난 상태 다시 불러오기 | Ctrl+b Ctrl+r (플러그인) | Cmd+Shift+O |
| 브라우저 열기 | 없음 | Cmd+Shift+L |
| 알림 패널 / 안 읽은 곳으로 | 없음 | Cmd+I / Cmd+Shift+U |
알림 링과 대화 재개는 에이전트 훅을 깔아야 제대로 동작합니다. 에이전트 CLI를 먼저 설치한 다음 한 번 실행합니다. Claude Code, Codex, Gemini, OpenCode, Cursor CLI, Copilot 등이 지원 목록에 있습니다.
# 찾을 수 있는 에이전트에 모두 훅 설치 $ cmux hooks setup
이후 cmux를 끄면 상태가 저장되고, 다시 켜면 창과 패널 배치, 작업 폴더, 찍혀 있던 출력, 브라우저 주소가 돌아오고 에이전트는 지난 대화로 이어서 시작합니다. 1편에서 tmux에 플러그인을 깔아 얻은 것을 cmux는 기본으로 해 주는 셈입니다. 다만 개발 서버나 빌드처럼 돌고 있던 프로그램의 상태 자체는 저장하지 않습니다.
cmux 안에서 tmux 같이 쓰기
앱을 꺼도, 업데이트되거나 멈춰도 프로그램이 계속 돌아야 한다면 cmux에 들어 있는 tmux 기능을 씁니다. 평소 터미널은 그대로 두고, 이름 붙인 세션만 tmux 서버가 붙들게 하는 방식입니다. 1편의 tmux new -s work와 같은 역할입니다.
# 살려 둘 세션 만들기 (폴더와 첫 명령 지정) $ cmux local-tmux start work --cwd ~/src/project --command 'npm run dev' $ cmux local-tmux list $ cmux local-tmux attach work $ cmux local-tmux close work
이 세션은 cmux를 끄거나 업데이트해도 살아 있지만, 1편의 tmux와 마찬가지로 재부팅, 로그아웃, 전원 차단에서는 끝납니다. 맥을 꺼도 작업이 돌아야 하면 원격 서버에서 돌려야 하고, cmux는 이를 위해 cmux ssh-tmux를 제공합니다.
다른 도구와 무엇이 다른가
AI 에이전트를 여러 개 돌리는 사람을 위한 도구가 요즘 많습니다. 자주 비교되는 것들과 나란히 놓으면 cmux의 자리가 보입니다.
| 도구 | 성격 | 운영체제 | 에이전트 관련 특징 |
|---|---|---|---|
| tmux (1편) | 터미널 안의 명령어 | macOS, Linux, 서버 | 없음. 대신 창을 닫거나 SSH가 끊겨도 프로그램이 산다 |
| cmux | 네이티브 터미널 앱 | macOS만 | 기다리는 에이전트 알림, 세로 탭에 브랜치·PR·포트, 에이전트가 조작하는 브라우저, 재시작 시 대화 재개 |
| Orca | 에이전트 작업 환경(ADE), Electron | macOS, Windows, Linux, 모바일 앱 | 에이전트마다 별도 git worktree, 한 프롬프트를 여러 에이전트에 돌려 결과 비교, GitHub·Linear 연동, 휴대폰으로 확인 |
| Wave | AI가 들어간 터미널 앱 | macOS, Windows, Linux | 터미널 출력을 읽는 AI 도우미(내 API 키나 로컬 모델), 터미널·편집기·브라우저를 블록으로 배치, 끊겨도 다시 이어지는 SSH |
| iTerm2 | 오래된 맥 터미널 앱 | macOS만 | 에이전트 전용 기능은 없지만 tmux와 연동(tmux -CC)이 잘 됨 |
차이를 정리하면 이렇습니다.
- cmux는 터미널을 바꾸지 않는 쪽입니다. 작업 방식을 정해 주지 않고, 터미널과 브라우저, 알림, 명령만 줍니다. 공식 문서도 "해결책이 아니라 재료"라고 소개합니다.
- Orca는 작업 방식까지 정해 주는 쪽입니다. 에이전트마다 worktree를 나누고 결과를 비교해 합치는 흐름이 앱에 들어 있습니다. 윈도우나 리눅스에서도 써야 하면 Orca가 맞습니다.
- tmux는 어디서나 돌고 프로그램을 살려 둡니다. 화면 편의는 없지만, 원격 서버나 오래 도는 작업에서는 여전히 기본입니다.
어떻게 고르면 좋을까
| 상황 | 추천 |
|---|---|
| 맥에서 Claude Code 여러 개를 띄우고 오가며 일한다 | cmux + 훅 설치 |
| 개발 서버나 긴 작업이 앱을 꺼도 돌아야 한다 | cmux local-tmux, 또는 일반 터미널에서 tmux |
| 윈도우·리눅스도 쓰고, 에이전트 결과를 비교해 고르고 싶다 | Orca |
| 원격 서버, 맥을 꺼도 돌아야 하는 작업 | 서버에서 tmux (1편) |
보는 창은 cmux에, 살려 둬야 하는 작업은 tmux에 맡긴다고 생각하면 1편과 2편이 한 그림으로 이어집니다.
참고: manaflow-ai/cmux README와 local-tmux 문서, stablyai/orca, wavetermdev/waveterm. 1편: tmux 첫걸음