[AI] 4. Claude Code 병렬 처리로 효율 극대화하기 - cmux 활용하기

1. [AI] Claude Code 병렬 처리로 효율 극대화하기 - git worktree 기본 개념

2. [AI] Claude Code 병렬 처리로 효율 극대화하기 (claude --worktree)

3. [AI] Claude Code 병렬 처리로 효율 극대화하기 - tmux 활용하기

4. [AI] Claude Code 병렬 처리로 효율 극대화하기 - cmux 활용하기

5. [AI] Claude Code 병렬 처리로 효율 극대화하기 - cmux, worktree, omc 병렬 처리하기 (.omc/handoffs, .omc/shared_memory.json)

1. 왜 cmux인가?

cmux는 단순한 터미널이 아니라 AI 에이전트(Claude Code, Aider 등)의 오케스트레이션을 위해 개발된 macOS 네이티브 작업 공간임. tmux와 비교했을 때 다음과 같은 독보적인 장점이 있음.

• 네이티브 가벼움 & 고성능: Electron 기반의 무거운 GUI가 아님. Swift와 AppKit으로 작성된 네이티브 앱이며, 요즘 핫한 고성능 터미널 Ghostty(libghostty) 기반이라 GPU 가속 덕분에 엄청나게 빠르고 부드러움.
• 내장 브라우저 패널 가동: 터미널 옆에 웹뷰 패널을 나란히 띄울 수 있음. 단순히 화면을 보는 게 아니라 agent-browser API가 연동되어 있어, Claude Code가 개발 서버 로그를 보면서 내장 브라우저 스냅샷을 읽고 직접 요소를 클릭하며 디버깅함.
• 에이전트 맞춤형 UI/UX: tmux처럼 단축키를 꼬지 않아도 마우스 드래그 앤 드롭으로 패널을 쪼갤 수 있고, Claude가 입력을 기다릴 때 사이드바에서 스마트 알림을 때려주므로 멀티태스킹 맥락을 잃지 않음.

2. 환경 구축

설치

$ brew tap manaflow-ai/cmux
$ brew install --cask cmux

 

cmux 오픈

$ cd my-project
$ open -a cmux .

 

패널 추가 cmd + D

 

왼쪽, 오른쪽 패널 중 하나에 클로드코드를 실행하고 나머지 작업 수행

$ claude

 

만약 웹뷰 브라우저가 필요하면 cmd + shift + L을 눌러서 주소창에 내 로컬 서버 주소(http://localhost:3000)를 입력

이 상태가 되면 다음과 같은 완벽한 삼분할 화면이 완성됨.

• 왼쪽 패널: Swift/TypeScript 코드를 수정하는 공간
• 오른쪽 패널: Claude Code가 내 코드를 모니터링하며 리팩토링 및 버그 수정을 때리는 공간
• 내장 브라우저 패널: Claude가 고친 화면이 실시간 반영(HMR)되는 공간이자, Claude가 직접 UI 테스트를 수행하는 공간

이 환경에서는 Claude에게 "오른쪽 패널 로그 보고 에러 잡은 다음에, 브라우저 패널에서 버튼 정상 작동하는지 스냅샷 찍어서 확인해 줘" 같은 고차원 명령이 터미널 안에서 다이렉트로 가능해짐.

• 클로드코드 답변이 오면 왼쪽 패널에서 알려 줄 수 있음 (아래 사진)

 

응용) cmux 하나에 gemini같은 브라우저를 띄우고 하나의 화면에서 사용할 수 있음

단축키

주요 단축키) tmux처럼 Prefix 키를 누를 필요 없이 Cmd 조합으로 수행

• Cmd + D : 화면 좌우 분할 (오른쪽에 Claude 띄우기)
• Cmd + Shift + D : 화면 위아래 분할 (아래에 로그/서버 띄우기)
• Cmd + Shift + L : 터미널 옆에 내장 브라우저 열기/닫기
• Cmd + Shift + U : Claude가 내 답변 기다리는 패널로 즉시 이동 (알림 추적)
• Cmd + option + 좌우방향키 : 탭 이동
• Cmd + shift + [ or ] : 상단 탭 이동

 

사용 시나리오

• 화면 쪼개기: Cmd + D로 화면 쪼개고 한쪽은 내 코딩 창, 다른 쪽은 claude 가동.
• 브라우저 띄우기: Cmd + Shift + L로 내장 브라우저 열고 로컬 서버(localhost:3000) 접속.
• Claude에게 명령 던지기: Claude에게 "내장 브라우저 스냅샷 찍어서(cmux browser snapshot) 화면 확인하고 버그 고쳐줘"라고 프롬프트 입력.