여러 Claude Code 에이전트를 병렬로 실행하는 방법
병렬 Claude Code 작업에는 격리, 가시성, 입력이 필요한 세션을 빠르게 찾는 방법이 필요합니다. cmux는 각 작업에 보이는 워크스페이스를 주고 Claude 세션을 나란히 실행해도 읽기 쉽게 유지합니다.
안전한 병렬 워크플로
작업마다 브랜치, worktree, 체크아웃, 저장소 폴더 또는 사용자 지정 워크스페이스를 하나 만들고, 각각을 cmux에서 열어 에이전트를 평소처럼 실행한 뒤, hooks, OSC, cmux notify에서 온 읽지 않음 단축키와 cmux 알림으로 확인이 필요한 세션을 리뷰하세요. Claude Code, Codex, OpenCode는 그대로 에이전트이고, cmux는 감독 화면을 담당합니다.
| 방식 | 격리 | 가시성 | 가장 적합한 용도 |
|---|---|---|---|
| 작업당 터미널 탭 하나 | 수동 | 약함 | 작은 실험 |
| tmux 패널 | 수동 | 중간 | 원격 shell 워크플로 |
| 수동 Git worktree | 강함 | 수동 | 신중한 병렬 작업 |
| cmux 워크스페이스 | 기존 브랜치/worktree 설정과 함께 동작 | 강함 | macOS에서 여러 Claude 세션을 보이게 유지 |
| cmux claude-teams | teammate 세션을 네이티브 패널로 매핑 | 강함 | tmux/iTerm2 패널 대신 네이티브 cmux 분할을 쓰는 Claude Code 에이전트 팀 |
모든 작업에 보이는 위치를 주기
병렬 에이전트에서 가장 흔한 실패는 어떤 터미널이 어떤 작업을 맡고 있는지 놓치는 것입니다. cmux 워크스페이스는 사이드바에 브랜치, 디렉터리, 포트, 최신 출력을 표시합니다.
알림 링을 리뷰 큐로 사용
에이전트가 hooks, OSC 99/777 또는 cmux notify를 통해 cmux 알림을 내보내면 cmux는 워크스페이스를 읽지 않음으로 표시하고 패널에 링을 표시합니다. Cmd+Shift+U는 최신 읽지 않음 항목으로 이동합니다. Cmd+Control+U는 현재 항목을 가장 오래된 읽지 않음으로 표시하고 다음 최신 읽지 않음으로 이동합니다. 여러 에이전트가 동시에 끝날 때 유용합니다.
Claude Code를 그대로 유지
cmux는 Claude Code, Codex, OpenCode를 대체하지 않습니다. 기존 계정과 설정으로 같은 CLI를 실행하고, cmux가 워크스페이스, 알림, 소켓 자동화를 터미널 세션 주변에 추가합니다.
맞을 때 teammate mode 사용
Claude Code teammate mode에서 cmux는 tmux 스타일 teammate 패널을 네이티브 cmux 분할로 변환할 수 있어, 생성된 teammate도 사이드바 메타데이터와 알림과 함께 보이게 유지됩니다.
FAQ
cmux가 Git worktree를 자동으로 만들나요?
기본적으로는 아닙니다. cmux는 브랜치, worktree, 다중 저장소, Git 없음, code-to-main, 원격 개발 흐름 주변에 워크스페이스를 만들도록 스크립팅할 수 있으므로 프로젝트에 맞는 저장소 구성을 유지할 수 있습니다.
Claude Code와 Codex를 나란히 실행할 수 있나요?
네. cmux는 에이전트에 무관하므로 Claude Code, Codex, OpenCode 및 다른 CLI 에이전트를 별도 워크스페이스에서 동시에 실행할 수 있습니다.
병렬 에이전트에서 가장 중요한 단축키는 무엇인가요?
Cmd+Shift+U는 최신 읽지 않음 항목으로 이동하므로 핵심 감독 단축키입니다. Cmd+Control+U는 현재 항목을 가장 오래된 읽지 않음으로 표시하고 다음 최신 읽지 않음 항목으로 이동하고 싶을 때 유용합니다.
cmux는 macOS용 무료 오픈 소스입니다.