macOS 14.0 이상
AGPL-3.0 오픈소스
cmux, 써봤더니 tmux랑 완전히 달랐습니다
Claude Code를 두세 개씩 동시에 돌리다가 어느 에이전트가 입력을 기다리는지 헷갈려 본 적 있다면, cmux가 그 문제를 어떻게 해결하는지 직접 확인해봤습니다. 처음엔 tmux 대체제인 줄 알았는데, 구조 자체가 달랐습니다.
cmux가 뭔지 한 줄로 정리하면
결론부터 말씀드리면, cmux는 AI 코딩 에이전트를 병렬로 관리하는 데 특화된 macOS 전용 터미널 앱입니다. Claude Code, Codex, Gemini CLI 같은 에이전트를 여러 개 동시에 돌릴 때, 어느 에이전트가 응답을 기다리는지 한눈에 파악하는 것이 핵심 기능이에요.
manaflow.ai 팀이 만들었고, AGPL-3.0 라이선스로 GitHub에 소스 코드가 전부 공개되어 있습니다. 완전히 무료예요. 출시한 지 얼마 안 됐는데 GitHub 스타가 8,100개를 넘었습니다. (출처: manaflow-ai/cmux GitHub, 2026.03.28 기준) 이 속도가 의미하는 건 하나입니다 — AI 에이전트를 여러 개 돌리는 개발자들이 그만큼 많아졌다는 뜻이에요.
💡 공식 GitHub README와 공식 사이트를 같이 놓고 보니 이런 차이가 보였습니다 — cmux는 터미널 기능을 AI 에이전트 관리 목적으로 다시 설계한 도구지, 기존 터미널 멀티플렉서의 연장선이 아닙니다. “AI 에이전트 대시보드가 붙은 터미널”이라고 보는 게 더 정확합니다.
tmux랑 같은 거 아닌가요? — 구조부터 다릅니다
많은 분들이 cmux를 “tmux의 GUI 버전” 정도로 생각하시는데, 써보면 그 생각이 바뀝니다. 가장 결정적인 차이는 프로세스 유지 여부예요.
tmux는 터미널 안에서 돌아가는 서버 프로세스입니다. SSH 연결이 끊어지거나 터미널 창을 꺼도 세션이 백그라운드에서 살아있어요. 반면 cmux는 독립된 macOS 앱이라서, 앱을 종료하면 실행 중이던 Claude Code 세션이나 개발 서버도 같이 종료됩니다. (출처: cmux 공식 GitHub README — Session restore 섹션)
| 항목 | tmux | cmux |
|---|---|---|
| 동작 방식 | 터미널 내 서버 프로세스 | 독립 macOS 앱 (Swift+AppKit) |
| 종료 후 프로세스 유지 | ✅ 유지됨 | ❌ 종료됨 |
| SSH 원격 서버 세션 | ✅ 적합 | ❌ 부적합 |
| AI 에이전트 알림 시스템 | ❌ 없음 | ✅ 내장 (알림 링·배지·팝오버) |
| 내장 브라우저 | ❌ | ✅ WebKit 기반, 스크립터블 |
| 플랫폼 | Linux, macOS, WSL | macOS 14.0 이상 전용 |
| 학습 곡선 | 높음 (프리픽스 키 방식) | 낮음 (⌘ 기반 macOS 단축키) |
SSH로 원격 서버에서 오래 돌리는 작업이 필요하다면 tmux가 맞습니다. 로컬 맥에서 AI 에이전트를 여러 개 병렬로 굴리는 용도라면 cmux가 훨씬 편합니다. 두 도구가 경쟁 관계가 아니라는 뜻이에요 — cmux 안에서 tmux 세션을 열 수도 있고요.
Ghostty 쓰는 사람, 안 쓰는 사람 모두 상관없는 이유
cmux를 처음 접하면 “Ghostty 써야 쓸 수 있는 건가?”라는 질문이 자주 나옵니다. 공식 FAQ에 딱 이렇게 나옵니다 — “cmux는 Ghostty의 포크가 아닙니다.” (출처: cmux 공식 사이트 FAQ)
구조를 보면 이해가 쉬운데, 웹 브라우저 앱이 WebKit을 렌더링 엔진으로만 가져다 쓰는 것처럼, cmux는 Ghostty의 렌더링 엔진인 libghostty를 렌더링 목적으로만 사용합니다. Ghostty 앱 자체와는 별개예요. Ghostty가 설치되어 있지 않아도 cmux는 문제없이 동작합니다.
💡 이걸 같이 놓고 보면 의미가 달라집니다 — Ghostty의 GPU 가속 렌더링 성능을 그대로 쓰면서도, AI 에이전트 관리용 워크스페이스·알림·브라우저를 독립적으로 얹은 구조입니다. Ghostty를 쓰던 분은 ~/.config/ghostty/config 파일의 폰트·테마 설정이 cmux에서 그대로 적용됩니다. 처음 쓰는 분은 기본 설정만으로도 충분하고요.
설치는 Homebrew로 두 줄이면 끝납니다. brew tap manaflow-ai/cmux 실행 후 brew install --cask cmux. DMG 파일로 설치하면 Sparkle 프레임워크를 통한 자동 업데이트까지 지원됩니다. macOS 14.0 이상, Apple Silicon·Intel 모두 지원합니다.
알림 시스템 — 에이전트 5개를 동시에 돌려도 놓치지 않는 방법
cmux가 만들어진 직접적인 이유가 여기 있습니다. 공식 GitHub README 제작자 섹션에 이렇게 나옵니다 — Claude Code의 macOS 알림은 항상 “Claude is waiting for your input”이라는 동일한 문구만 표시되어서, 탭이 많아지면 어떤 세션에서 온 건지 알 수 없었다고요. (출처: manaflow-ai/cmux GitHub, Why cmux 섹션)
cmux는 이 문제를 여러 겹으로 해결합니다. 에이전트가 입력을 기다리는 패널에 파란색 링이 생기고, 사이드바의 워크스페이스 탭에 읽지 않은 알림 배지가 붙고, macOS 데스크톱 알림도 뜨는데 이때 어떤 워크스페이스의 어떤 패널인지 맥락을 같이 보여줍니다.
⌘⇧U — 이 단축키 하나가 핵심입니다
에이전트가 여러 개 돌아갈 때 어느 패널로 가야 할지 찾아다닐 필요 없이, ⌘⇧U 하나로 가장 최근에 응답을 기다리는 패널로 바로 점프합니다. Claude Code 훅과 연동하면 세션이 완료되거나 에이전트가 멈출 때 자동으로 알림을 보내도록 설정할 수도 있어요.
Claude Code 훅 연동은 bash 스크립트 파일을 ~/.claude/hooks/에 넣고, ~/.claude/settings.json에서 훅을 등록하면 됩니다. (출처: cmux 공식 Notifications 문서) 셸 스크립트 수준이라서 Claude Code 설정을 한 번이라도 만져본 분이라면 어렵지 않습니다.
알림 전송은 CLI 명령어로도 됩니다. cmux notify --title "빌드 완료" --body "테스트 통과"처럼 쓰면 돼서, 빌드 스크립트 끝에 붙여두면 오래 걸리는 작업이 끝났을 때 자동으로 알려줍니다. 기다리는 동안 딴 작업을 해도 놓치지 않아요.
내장 브라우저, 보는 용도가 아닙니다
cmux에 WebKit 브라우저가 내장되어 있다고 하면 “개발 서버 미리보기용이겠네”라고 생각하기 쉽습니다. 막상 공식 문서를 보면 다릅니다.
cmux의 내장 브라우저는 Vercel 팀이 만든 agent-browser의 API를 포팅한 것으로, AI 에이전트가 브라우저를 직접 조작할 수 있도록 설계되어 있습니다. 접근성 트리 스냅샷, 요소 클릭, 폼 입력, JavaScript 실행 같은 브라우저 자동화 명령을 CLI를 통해 터미널에서 직접 실행할 수 있어요. (출처: cmux 공식 사이트) Claude Code가 개발 서버 페이지와 상호작용하면서 UI 버그를 스스로 확인하는 시나리오가 가능합니다.
💡 공식 발표문과 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다 — 내장 브라우저의 진짜 역할은 사람이 결과를 확인하는 것이 아니라, AI 에이전트가 웹 인터페이스를 검증하는 루프를 자동화하는 것에 있습니다. 에이전트가 코드를 수정하고, 개발 서버에서 결과를 직접 확인하고, 다시 코드를 고치는 사이클을 사람 개입 없이 돌릴 수 있어요.
⌘⇧L로 현재 패널 옆에 브라우저를 분할해서 열 수 있고, 브라우저 단축키는 Safari 기본값을 따릅니다. 주소 바 포커스(⌘L), 뒤로/앞으로(⌘[/]), 개발자 도구(⌥⌘I).
이런 상황이면 cmux가 맞지 않습니다
cmux가 모든 상황에 답은 아닙니다. 지금 기준으로 세 가지 상황에서는 다른 도구를 선택하는 게 낫습니다.
① 원격 서버에서 장시간 작업을 유지해야 하는 경우. SSH 연결이 끊어져도 세션을 살려야 한다면 tmux 또는 Zellij가 맞습니다. cmux는 앱을 종료하면 프로세스도 같이 끊어지기 때문에, 서버에서 돌아가는 빌드·학습·배포 작업을 관리하는 용도로는 부적합합니다.
② Windows 또는 Linux 환경인 경우. cmux는 현재 macOS 14.0 이상 전용입니다. Swift + AppKit으로 만든 네이티브 앱이라서 다른 플랫폼 지원 계획이 공식 로드맵에 명시되지 않았습니다. Windows·Linux 환경에서 비슷한 멀티 에이전트 관리가 필요하다면 다른 접근법을 찾아야 합니다.
③ 에이전트를 한 개만 쓰는 경우. 공식 사이트 FAQ에도 직접 나옵니다 — “Claude Code를 1개만 쓴다면 cmux 필요 없을 수 있어요.” 여러 에이전트를 동시에 관리하는 상황이 아니라면, 기존 Ghostty나 iTerm2로 충분합니다.
⚠️ 세션 복원 범위 주의 — cmux를 재시작하면 워크스페이스 레이아웃과 작업 디렉토리, 브라우저 URL은 복원되지만, 실행 중이던 Claude Code·vim·개발 서버 같은 프로세스는 복원되지 않습니다. (출처: cmux GitHub README) 복원이라는 단어 때문에 tmux처럼 완전히 살아난다고 오해하면 당황할 수 있습니다.
Q&A
마치며
cmux를 한 줄로 정리하면 — AI 에이전트 여러 개를 동시에 굴릴 때, 어느 에이전트가 기다리는지 헷갈리는 문제를 해결하려고 만든 도구입니다. tmux 대체제가 아니에요. 목적 자체가 다른 도구입니다.
솔직히 말하면, 에이전트를 하나씩만 쓰는 방식이라면 굳이 설치할 이유가 없습니다. 그런데 Claude Code 두세 개를 동시에 돌리면서 각각 다른 컴포넌트를 작업시키는 방식에 익숙해진 분이라면, 어느 세션이 멈춰있는지 찾아다니는 게 생각보다 많은 집중력을 잡아먹는다는 걸 알 거예요. cmux는 그 문제에 대한 답입니다.
macOS 전용이라는 한계, 프로세스가 앱 종료 시 날아간다는 한계는 분명합니다. 그 한계를 알고 쓰는 거라면, 지금 당장 써볼 만한 도구예요. 무료고, GitHub에 소스가 열려 있고, 설치도 brew 두 줄이니까요.
본 포스팅 참고 자료
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. cmux는 활발히 개발 중인 오픈소스 프로젝트로, 버전 업데이트에 따라 기능 및 인터페이스가 달라질 수 있습니다. 최신 정보는 공식 GitHub 및 공식 사이트에서 확인하세요.
댓글 남기기