tmux 입문 튜토리얼 - 설치부터 Claude Code 활용까지
✈️ tmux 입문 튜토리얼 - 설치부터 Claude Code 활용까지
🎯 개요
tmux는 터미널 하나에서 여러 창을 분할하고 관리할 수 있는 도구임 화면을 나눠서 한쪽에서 Claude Code, 다른 쪽에서 서버를 실행하는 등 멀티태스킹이 가능 터미널을 닫아도 작업이 유지되기 때문에 퇴근 후 다음 날 이어서 작업 가능 macOS에서 iTerm2와 함께 사용하면 궁합이 좋음
📋 목록
- tmux 핵심 개념
- 세션 시작과 종료
- 화면 분할 (패인)
- 윈도우 (탭처럼 사용)
- 스크롤 방법
- Claude Code와 함께 쓰기
- 단축키 전체 정리표
- 실전 연습 과제
✏️ tmux 핵심 개념
tmux는 3가지 계층 구조로 이루어져 있음
세션 (Session) → 하나의 작업 공간 (예: "프로젝트A")
└─ 윈도우 (Window) → 탭 같은 것 (예: "코드", "서버", "로그")
└─ 패인 (Pane) → 분할된 화면 조각
| 개념 | 비유 | 설명 |
|---|---|---|
| 세션 | 작업 공간 | 프로젝트 단위로 하나씩 만들어 사용 |
| 윈도우 | 브라우저 탭 | 하나의 세션 안에 여러 탭을 만들 수 있음 |
| 패인 | 분할된 화면 | 하나의 윈도우를 좌우/상하로 나눈 조각 |
접두사 키 (Prefix Key)
tmux 안에서 명령을 내리려면 항상 Ctrl+b를 먼저 누른 뒤 손을 떼고 다음 키를 누름
예: 화면을 세로로 나누려면 → Ctrl+b 누르고 손 떼고 → Shift+5(%)
💡특이사항
Ctrl+b를 누르고 반드시 손을 뗀 뒤 다음 키를 눌러야 함 동시에 누르면 작동하지 않음
✏️ 세션 시작과 종료
세션 만들기
# 이름을 붙여서 세션 시작
tmux new -s practice
화면 하단에 상태바가 나타나면 tmux 안에 들어온 것임
세션에서 빠져나오기 (detach)
Ctrl+b → d
세션은 살아있고, 나만 빠져나온 상태임
세션 목록 확인
tmux ls
세션에 다시 들어가기
tmux attach -t practice
세션 완전히 삭제
tmux kill-session -t practice
| 명령어 | 설명 |
|---|---|
tmux new -s 이름 |
새 세션 시작 |
tmux ls |
세션 목록 보기 |
tmux attach -t 이름 |
세션에 다시 접속 |
tmux kill-session -t 이름 |
세션 삭제 |
💡특이사항
detach는 세션을 종료하는 것이 아님 터미널을 닫아도 세션은 백그라운드에서 계속 살아있음
✏️ 화면 분할 (패인)
세로 분할 (좌우로 나누기)
Ctrl+b 누르고 손 떼기 → Shift+5 (= %)
결과:
┌──────────┬──────────┐
│ │ │
│ 기존 │ 새 패인 │
│ │ │
└──────────┴──────────┘
가로 분할 (상하로 나누기)
Ctrl+b 누르고 손 떼기 → Shift+' (= ")
결과:
┌─────────────────────┐
│ 기존 │
├─────────────────────┤
│ 새 패인 │
└─────────────────────┘
패인 이동
Ctrl+b → 방향키 (←↑↓→)
패인 크기 조절
Ctrl+b를 누른 상태에서 (손 떼지 말고!) → 방향키
마우스 설정이 켜져 있으면 패인 경계선을 드래그해서 크기 조절도 가능
패인 전체화면 토글
Ctrl+b → z
한 패인을 전체화면으로 확대하고, 다시 Ctrl+b → z를 누르면 원래대로 복귀
패인 닫기
Ctrl+b → x → y (확인)
또는 패인에서 exit 입력해도 닫힘
| 단축키 | 설명 |
|---|---|
Ctrl+b → % |
세로 분할 (좌우) |
Ctrl+b → " |
가로 분할 (상하) |
Ctrl+b → 방향키 |
패인 간 이동 |
Ctrl+b → x → y |
패인 닫기 |
Ctrl+b → z |
전체화면 토글 |
💡특이사항
마우스 클릭으로도 패인 이동 가능 (마우스 설정이 켜져 있는 경우) 패인 크기 조절 시에만
Ctrl+b를 누른 상태를 유지해야 함
✏️ 윈도우 (탭처럼 사용)
하나의 세션 안에서 여러 윈도우를 만들어 탭처럼 전환하며 사용 가능
Ctrl+b → c 새 윈도우 만들기
Ctrl+b → n 다음 윈도우로 이동
Ctrl+b → p 이전 윈도우로 이동
Ctrl+b → 0~9 번호로 윈도우 이동
Ctrl+b → , 윈도우 이름 변경
하단 상태바에 0:zsh 1:zsh* 형태로 윈도우 목록이 표시됨
*가 현재 활성 윈도우를 의미
| 단축키 | 설명 |
|---|---|
Ctrl+b → c |
새 윈도우 생성 |
Ctrl+b → n / p |
다음 / 이전 윈도우 |
Ctrl+b → 0~9 |
번호로 윈도우 이동 |
Ctrl+b → , |
윈도우 이름 변경 |
✏️ 스크롤 방법
tmux 안에서는 일반 스크롤이 작동하지 않음 두 가지 방법으로 스크롤 가능
방법 1 — 마우스 스크롤
마우스 설정이 켜져 있으면 트랙패드/마우스 휠로 바로 스크롤 가능
방법 2 — 키보드 스크롤
Ctrl+b → [ 스크롤 모드 진입
방향키 / Page Up/Down 스크롤
q 스크롤 모드 빠져나오기
💡특이사항
스크롤 모드에서
Space로 선택 시작 → 방향키로 범위 지정 →Enter로 복사 가능Ctrl+b → ]로 붙여넣기
✏️ Claude Code와 함께 쓰기
tmux를 사용하는 가장 실용적인 이유 중 하나
추천 레이아웃 만들기
# 1. 세션 시작
tmux new -s work
# 2. 세로 분할
# Ctrl+b → %
# 3. 왼쪽에서 Claude Code 실행
claude
# 4. 오른쪽 패인으로 이동
# Ctrl+b → →
# 5. 오른쪽에서 서버 실행, git 확인 등 자유롭게 사용
결과:
┌──────────────────────┬──────────────────┐
│ │ │
│ Claude Code │ 서버/git/테스트 │
│ (메인 작업) │ (보조 작업) │
│ │ │
└──────────────────────┴──────────────────┘
퇴근 → 출근 시나리오
# 퇴근할 때: 세션 빠져나오기 (작업 유지됨)
Ctrl+b → d
# 다음 날 출근해서
tmux attach -t work
# → Claude Code도, 서버도 그대로 유지!
💡특이사항
Claude Code가 긴 작업을 하고 있을 때 detach로 빠져나와도 작업이 계속 진행됨 나중에 attach로 돌아오면 결과 확인 가능
✏️ 단축키 전체 정리표
패인 (화면 분할)
| 단축키 | 설명 |
|---|---|
Ctrl+b → % |
세로 분할 (좌우) |
Ctrl+b → " |
가로 분할 (상하) |
Ctrl+b → 방향키 |
패인 간 이동 |
Ctrl+b → x → y |
패인 닫기 |
Ctrl+b → z |
전체화면 토글 |
Ctrl+b + 방향키 (누른 상태) |
패인 크기 조절 |
윈도우 (탭)
| 단축키 | 설명 |
|---|---|
Ctrl+b → c |
새 윈도우 생성 |
Ctrl+b → n / p |
다음 / 이전 윈도우 |
Ctrl+b → 0~9 |
번호로 윈도우 이동 |
Ctrl+b → , |
윈도우 이름 변경 |
세션
| 단축키 | 설명 |
|---|---|
Ctrl+b → d |
세션 빠져나오기 (detach) |
Ctrl+b → s |
세션 목록 보기/전환 |
Ctrl+b → r |
설정 재로드 |
스크롤
| 단축키 | 설명 |
|---|---|
Ctrl+b → [ |
스크롤 모드 진입 |
q |
스크롤 모드 종료 |
✏️ 실전 연습 과제
iTerm2에서 순서대로 따라 해볼 것
1. tmux new -s practice ← 세션 시작
2. Ctrl+b → % ← 세로 분할 (되는지 확인)
3. Ctrl+b → " ← 가로 분할
4. Ctrl+b → 방향키 ← 패인 이동 연습
5. Ctrl+b → z ← 전체화면 토글 (다시 z로 복귀)
6. Ctrl+b → x → y ← 패인 하나 닫기
7. Ctrl+b → c ← 새 윈도우 만들기
8. Ctrl+b → 0 ← 첫 번째 윈도우로 돌아가기
9. Ctrl+b → d ← 세션 빠져나오기
10. tmux attach -t practice ← 다시 접속 (그대로 남아있는지 확인)
11. tmux kill-session -t practice ← 연습 끝, 세션 삭제
💡 요약
tmux는 세션 > 윈도우 > 패인 3단계 구조로 이루어져 있음
모든 단축키는 Ctrl+b(접두사 키)를 먼저 누르고 손을 뗀 뒤 다음 키를 누르는 방식
화면 분할은 %(세로)와 "(가로)로 간단하게 가능
detach(Ctrl+b → d)로 빠져나와도 세션은 유지되어 나중에 이어서 작업 가능
Claude Code와 함께 쓰면 한 화면에서 코드 작업과 서버/테스트를 동시에 관리 가능
iTerm2에서 사용하는 것을 권장하며, Warp에서는 tmux -CC 통합 모드 사용 필요
댓글남기기