cmux에서 Claude Code와 Codex 함께 쓰기: 초보자 공식 실전 가이드
퀀텀점프클럽 정상록5분 읽기1 viewscmux가 필요한 이유
Claude Code와 Codex를 각각 다른 터미널에서 실행할 수는 있습니다. 하지만 구현 로그, 리뷰 결과, dev server, 브라우저가 여러 앱에 흩어지면 중요한 오류와 완료 신호를 놓치기 쉽습니다.
cmux는 workspace, pane, Surface라는 세 단위로 작업을 정리합니다.
- workspace: 프로젝트나 결과 단위 작업방
- pane: 가로·세로로 분할한 화면 영역
- Surface: 한 pane 안에 열리는 터미널·브라우저·Markdown 탭
중요한 점은 에이전트 수가 아닙니다. 누가 코드를 쓰고, 누가 검토하며, 어디서 실행 결과를 확인하는지가 눈에 보여야 합니다.
초보자에게 권하는 3분할
가장 안정적인 시작 구성은 다음과 같습니다.
| 위치 | 역할 | 추천 도구 |
|---|---|---|
| 왼쪽 | 구현과 테스트 | Claude Code 또는 Codex 중 한 명 |
| 오른쪽 위 | 변경점 리뷰 | writer가 아닌 다른 에이전트 |
| 오른쪽 아래 | 실행 상태 | 테스트, 빌드, dev server |
Cmd + D로 오른쪽을 분할하고, Cmd + Shift + D로 아래를 분할합니다. Option + Cmd + 방향키로 pane 사이를 이동할 수 있습니다.
같은 checkout에서는 writer를 한 명만 두세요. Claude Code와 Codex가 같은 파일을 동시에 수정하면 덮어쓰기, 포맷 충돌, 테스트 결과 오판이 생길 수 있습니다.
Claude Code와 Codex 역할을 나누는 법
초보자에게는 병렬 실행보다 순차 리뷰 루프가 빠릅니다.
- Claude Code에 Goal, Context, Constraints, Done When을 전달합니다.
- Claude Code가 구현과 테스트를 끝냅니다.
- Codex에 수정하지 말고 CRITICAL/HIGH 문제만 검토하도록 요청합니다.
- 발견 사항을 writer에게 전달해 수정합니다.
- cmux 내장 브라우저로 실제 사용자 흐름을 확인합니다.
codex review --uncommitted \
"수정하지 말고 CRITICAL/HIGH 문제만 검토하세요.\n정확성, 보안, 데이터 손실 가능성을 우선하고\n파일과 라인을 제시하세요."
Codex가 구현 담당이라면 Claude Code를 claude --permission-mode plan으로 시작해 읽기 전용 reviewer로 사용할 수 있습니다.
탭 1–9와 workspace 1–9 단축키
여기서 가장 많이 헷갈립니다.
Cmd + 1…9: 해당 workspace로 바로 이동Control + 1…9: 현재 pane 안의 해당 탭(Surface)으로 바로 이동
세 번째 프로젝트 작업방으로 이동하려면 Cmd + 3, 현재 pane의 세 번째 탭으로 이동하려면 Control + 3입니다.
함께 기억하면 좋은 기본 단축키는 다음과 같습니다.
| 단축키 | 기능 |
|---|---|
Cmd + N | 새 workspace |
Cmd + P | workspace 검색 |
Cmd + T | 새 탭 |
Cmd + Shift + ] / [ | 다음·이전 탭 |
Cmd + Shift + T | 마지막으로 닫은 탭 복구 |
Cmd + Shift + L | 내장 브라우저 열기 |
Cmd + I | 알림 보기 |
기본 단축키는 Settings 또는 ~/.config/cmux/cmux.json에서 바꿀 수 있습니다.
브라우저 QA와 diff 확인
코드가 맞아 보인다는 것만으로는 완료가 아닙니다. 실제 화면과 변경 범위를 확인해야 합니다.
cmux browser open http://localhost:3000
cmux diff --source unstaged
cmux markdown open plan.md
완료 전에는 정상 흐름과 실패 흐름을 재현하고, 브라우저 콘솔 오류를 확인하며, 요청과 관계없는 파일이나 시크릿이 diff에 들어가지 않았는지 검토하세요.
worktree는 언제 쓰나요?
두 에이전트가 정말 동시에 코드를 써야 하고 기능 경계가 겹치지 않을 때만 사용합니다.
claude --worktree feature-auth
git worktree add ../project-codex-fix -b codex/fix
codex -C ../project-codex-fix
같은 파일을 수정하는 작업은 병렬화하지 마세요. 각 worktree에서 테스트와 빌드를 따로 통과시킨 뒤 하나씩 병합하는 편이 안전합니다.
공식 가이드 무료 열람
QJC가 설치, 역할 분리, 프롬프트, 브라우저 QA, worktree, 세션 복구, 단축키 전체표를 한 문서로 정리했습니다. 로그인 후 회사명·인원수·직책을 등록하면 웹 가이드와 PDF 소장본을 무료로 볼 수 있습니다.
공식 참고자료
- OFFICIAL · cmux Getting Started · 2026-07-23 확인
- OFFICIAL · cmux Keyboard Shortcuts · 2026-07-23 확인
- OFFICIAL · cmux Skills · 2026-07-23 확인
- OFFICIAL · cmux Session Restore · 2026-07-23 확인
- OFFICIAL · cmux CLI Reference · 2026-07-23 확인
- OFFICIAL · cmux Claude Code Teams · 2026-07-23 확인
제품 업데이트로 화면과 단축키가 달라질 수 있습니다. 차이가 있으면 cmux Settings와 최신 공식 문서를 우선하세요.
