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

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

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

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

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

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

 

• 앞선 글에서 claude --worktree를 활용해 독립된 병렬 세션을 띄우는 방법을 알아봄.
• 이 방식을 실전에서 쓰려면 터미널 창(또는 탭)을 여러 개 열어서 왔다 갔다 해야 함. 하지만 터미널 창이 많아지면 어떤 창에서 어떤 Claude가 돌고 있는지 헷갈리고 관리하기 번거로움.
• 이때 터미널 멀티플렉서인 tmux를 결합하면 단 하나의 터미널 화면 안에서 나(Human)와 여러 대의 Claude 세션을 완벽하게 통제할 수 있음. 실전 구축 방법을 정리.

1. 왜 tmux인가?

tmux(Terminal Multiplexer)는 단일 터미널 화면을 여러 개의 윈도우와 패널(Pane)로 쪼개서 쓸 수 있게 해주는 도구임. Claude Code 워크트리 방식과 결합했을 때 다음과 같은 강력한 장점이 있음.

• 한 화면에서 모니터링: 화면을 3등분 하여 왼쪽은 내 작업 공간, 오른쪽 위는 '버그 잡는 Claude', 오른쪽 아래는 '테스트 짜는 Claude'의 진행 상황을 한눈에 볼 수 있음.
• 세션 유지 (Background 구동): Claude에게 무거운 리팩토링을 시켜두고 터미널 앱을 실수로 끄거나 ssh 연결이 끊겨도, 백그라운드에서 Claude는 멈추지 않고 계속 일을 수행함.

2. 실전 환경 구축하기

macOS 기준으로 Homebrew를 통해 간단히 설치할 수 있음.

$ brew install tmux

💻 3분 완성 실전 화면 분할 프로세스

이제 터미널을 열고 하나의 화면을 쪼개서 나와 Claude의 협업 공간을 만들어봄.

1. 새로운 tmux 세션 시작 프로젝트 폴더로 이동한 뒤 tmux를 실행함.

$ cd my-project
$ tmux new -s claude-coop

2. 화면 세로로 쪼개기 (내 공간 / Claude 공간 분리)

• tmux 단축키인 Ctrl + b를 누른 뒤 %를 누르면 화면이 좌우(세로)로 반등 됨.
• 왼쪽 화면: 내가 원래 하던 개발 작업을 계속 진행함.

3. 오른쪽 화면을 가로로 한 번 더 쪼개기 (Claude 2대 가동)

• Ctrl + b 누른 뒤 o(알파벳)를 눌러 오른쪽 화면으로 포커스를 이동함.
• Ctrl + b 누른 뒤 "(따옴표)를 누르면 오른쪽 화면이 위아래(가로)로 쪼개짐.

4. 각각의 공간에서 Claude --worktree 실행 이제 쪼개진 오른쪽 위/아래 화면에서 각각 워크트리 명령어를 던져줌.

• 오른쪽 위 화면 (Pane 2):

  $ claude -w refactor-ui
  

• 오른쪽 아래 화면 (Pane 3):

  $ claude -w fix-bug
  

이 상태가 되면 왼쪽에서는 내가 코딩을 하고, 오른쪽 스크린에서는 Claude 2대가 실시간으로 파일 구조를 분석하고 테스트를 돌리는 모습을 한눈에 박진감 있게 구경할 수 있음.

3. 필수 tmux 단축키 요약

이 워크플로우를 매끄럽게 쓰기 위해 딱 3가지 단축키만 외우면 됨. (모든 단축키는 Ctrl + b를 먼저 누른 뒤 손을 떼고 다음 키를 입력해야 함)

분류	기능	명령어 / 단축키
세션 (Session)	새 세션 생성	tmux new -s project-name
	세션 목록 확인	tmux ls
	세션 재접속 (Attach)	tmux attach -t project-name
	세션 분리 (Detach)	Ctrl + b 누른 후 d
윈도우 (Window)	새 윈도우 생성	Ctrl + b 누른 후 c
	다음 윈도우로 이동	Ctrl + b 누른 후 n
팬 (Pane)	화면 수직 분할	Ctrl + b 누른 후 %
	화면 수평 분할	Ctrl + b 누른 후 "
	팬 간 이동	Ctrl + b 누른 후 방향키

요약

• git worktree가 병렬 처리를 위한 '공간의 격리'를 제공했다면, tmux는 그 격리된 공간들을 한눈에 제어하는 '시각적 격리 및 관리'를 제공함.
• 롱런(Long-running)하는 AI 작업을 백그라운드에 안정적으로 던져두기 위해 tmux 도입은 필수적임.
• 이 삼각 편대(git worktree + claude code + tmux)를 구축하는 것이 현재 터미널 환경에서 AI와 인간이 협업할 수 있는 가장 최적의 아키텍처임.