Mac 에서 tmux 사용

🚀 터미널의 자유를 선사하는 tmux: 정의부터 실전 튜토리얼까지

터미널에서 작업을 하다가 실수로 창을 닫아 공들여 작성하던 코드가 날아가거나, 실행 중이던 프로세스가 중단된 경험이 있으신가요? 혹은 Ghostty 같은 터미널에서 화면을 쪼개 쓰고 싶은데 설정이 복잡해 보였나요?

이 모든 고민을 한 방에 해결해 줄 도구, tmux를 소개합니다.

---

1. tmux란 무엇인가?

tmux는 Terminal MUltiplexor의 약자로, 하나의 터미널 창에서 여러 개의 가상 터미널 세션을 관리할 수 있게 해주는 도구입니다.

🌟 왜 써야 하나요?

• 세션 유지(Persistence): 터미널 연결이 끊기거나 창을 닫아도, 서버나 로컬의 작업은 배경에서 계속 돌아갑니다.
• 화면 분할: 하나의 창을 가로/세로로 쪼개어 코드 편집기, 로그 창, 클로드 코드를 동시에 볼 수 있습니다.
• 작업 이어하기: 사무실에서 작업하던 환경 그대로 집에서 다시 접속해 이어서 작업할 수 있습니다.

---

2. 설치하기

대부분의 환경에서 패키지 매니저로 간단히 설치할 수 있습니다.

• macOS: brew install tmux
• Linux (Ubuntu): sudo apt update && sudo apt install tmux

---

3. 핵심 개념: 세션, 윈도우, 패널

tmux를 잘 다루려면 세 가지 계층 구조를 이해해야 합니다.

1. Session(세션): 전체 작업 단위 (예: '나의 앱 프로젝트')
2. Window(윈도우): 세션 내의 탭 (웹 브라우저의 탭과 유사)
3. Pane(패널): 하나의 윈도우 내에서 쪼개진 화면들

---

4. 실전 튜토리얼: 세션 관리하기

✅ 세션 만들기 (시작)

단순히 tmux라고 쳐도 되지만, 이름을 지정하는 습관을 들이는 것이 좋습니다.

# 'project-a'라는 이름의 세션 생성 및 진입
tmux new -s project-a

✅ 세션 숨기기 (Detach)

작업 중에 터미널을 꺼야 하거나 다른 일을 해야 할 때, 현재 상태를 유지하며 빠져나옵니다.

• 단축키: Ctrl + b를 누른 뒤 손을 떼고 d를 누릅니다.
• 터미널에 [detached]라고 뜨면 성공입니다.

✅ 세션 목록 확인

현재 배경에서 돌아가고 있는 세션들이 무엇인지 확인합니다.

tmux ls

✅ 세션 다시 연결하기 (Attach)

나갔던 세션으로 다시 돌아가 작업 내용을 확인합니다.

# 이름이 'project-a'인 세션에 다시 연결
tmux attach -t project-a

# 가장 최근 세션에 연결하고 싶을 때 (축약형)
tmux a

✅ 세션 제거하기 (Kill)

작업이 완전히 끝나서 세션을 종료하고 싶을 때 사용합니다. (세션 내부에서 exit를 입력해도 됩니다.)

# 특정 세션 종료
tmux kill-session -t project-a

# 모든 세션 종료
tmux kill-server

---

5. 자주 쓰는 화면 분할 단축키

모든 단축키는 Ctrl + b (Prefix)를 먼저 누른 후에 작동합니다.

기능	단축키 (Ctrl + b 누른 후)
세로 분할	%
가로 분할	"
패널 간 이동	방향키
현재 패널 닫기	x (또는 exit 입력)
현재 패널 전체화면/해제	z (Zoom)

---

💡 마치며: 클로드 코드(Claude Code)와의 궁합

최근 AI 코딩 도구인 클로드 코드를 사용하신다면 tmux는 필수입니다. 복잡한 리팩토링이나 테스트를 클로드에게 시켜놓고, Detach(Ctrl+b, d) 기능을 통해 터미널을 끄고 퇴근하세요. 다음 날 다시 Attach하면 완료된 작업 결과가 여러분을 기다리고 있을 것입니다!

---