🧷 tmux 정리본 (Cheat Sheet + 사용 가이드)

tmux는 여러 개의 터미널 세션을 생성하고 관리할 수 있게 해주는 터미널 멀티플렉서이다. 한 세션 안에 여러 개의 윈도우(window) → 패널(pane) 을 둘 수 있다.

구조: 세션(Session) > 윈도우(Window) > 패널(Pane)

이 글은 tmux 로드맵의 입문 단계다. 설정·플러그인·자동화로 이어지는 전체 학습 경로는 로드맵에서.

---

1. 설치

brew install tmux         # macOS
sudo apt-get install tmux # Ubuntu
sudo yum install tmux     # CentOS

---

2. 설정 파일

tmux 설정은 ~/.tmux.conf 에 작성한다. tmux 실행 시 자동 로드되며, 재로드는 아래 명령어로 가능:

tmux source-file ~/.tmux.conf

---

3. 세션(Session)

● 세션 생성

tmux
tmux new
tmux new-session
tmux new -s sessionname

● 세션 접속

tmux attach
tmux attach-session
tmux a
tmux a -t sessionname

● 세션 종료

tmux kill-session
tmux kill-session -t sessionname

● 자주 쓰는 단축키

단축키	설명
Ctrl+b + $	세션 이름 변경
Ctrl+b + d	세션 detach
Ctrl+b + )	다음 세션
Ctrl+b + (	이전 세션
Ctrl+b + w	세션/창 리스트 보기

---

4. 윈도우(Window)

브라우저 탭처럼 하나의 세션 안에서 여러 창을 사용할 수 있다.

● 단축키

단축키	설명
Ctrl+b + c	새 윈도우 생성
Ctrl+b + n	다음 윈도우
Ctrl+b + p	이전 윈도우
Ctrl+b + l	마지막으로 사용한 윈도우
Ctrl+b + 숫자	번호로 이동
Ctrl+b + '	이름으로 검색하여 이동
Ctrl+b + ,	윈도우 이름 변경
Ctrl+b + .	윈도우 번호 변경
Ctrl+b + &	윈도우 종료
Ctrl+b + f	윈도우 검색
Ctrl+b + z	패널 확대/축소(toggle zoom)

● 윈도우 합치기/분리 등

(Ctrl+b + : 로 명령창 열기)

join-pane -s 2 -t 1      # 2번을 집어서 → 1번 옆에 합치기 (2가 이동)
join-pane -h -s 2 -t 1   # 오른쪽에 붙이기(-h) / -v면 아래에 붙이기
join-pane -b -s 2 -t 1   # -b(before): 반대쪽(왼쪽/위)에 붙이기
break-pane -s 1 -t 2     # 1번 윈도우를 2번 윈도우로 분리
swap-pane -s 1 -t 2      # 두 패널 자리 교환
swap-window -s 1 -t 2    # 두 윈도우 자리 교환
move-window -s 1 -t 5    # 윈도우 1을 빈 번호 5로 옮기기(교환 아님)
move-window -r           # 윈도우 번호 빈칸 없이 재정렬(0,3,7 → 0,1,2)

-s/-t가 매번 헷갈린다면 — 이게 join/swap의 핵심이자 tmux 명령 전반의 공통 문법이다.

• -s(source)는 움직이는 것, -t(target)는 도착지. source가 target 쪽으로 간다. (swap은 자리 교환이라 방향이 대칭)
• 값은 그냥 숫자가 아니라 주소다. 형식은 왼쪽부터 큰 단위 → 세션:윈도우.패널 (work:2.1). 생략한 자리는 “현재”로 채워진다: -t 1=현재 세션의 윈도우 1, -t .1=현재 윈도우의 패널 1. 점(.)이 있으면 패널, 없으면 윈도우.
• 각 자리엔 이름·번호 둘 다 되지만, 실무 조합은 정해져 있다 — 강제 규칙이 아니라 “번호가 있고 화면에 보이느냐”의 차이다:
  • 세션: 애초에 번호가 없으니 이름 (tmux new -s work로 붙인 그 이름).
  • 윈도우: 상태 바에 2:logs로 번호·이름 다 보이니 아무거나. -t 2도 -t logs도 동작 (짧은 번호가 편함).
  • 패널: 이름이 없고 번호도 안 보이니, Ctrl+b + q로 확인 후 번호. → 그래서 work:2.1(이름:번호.번호)이 가장 흔한 꼴.
• -s를 생략하면 현재(또는 마크된) 패널이 source다. 의도치 않게 딸려가니 스크립트·바인딩에선 -s를 명시.
• join-pane에서 현재 윈도우를 source로 지정하면 에러. source는 다른 윈도우여야 한다.
• 세션 경계도 넘는다. 주소 앞에 세션:을 붙이면 join-pane·swap-window가 다른 세션으로도 동작한다: join-pane -s work:2 -t home:1.
• 번호가 헷갈리면 Ctrl+b + q로 패널 번호를 화면에 띄워 확인.

---

5. 패널(Pane)

윈도우 내부를 여러 영역으로 나누어 사용할 수 있다.

● 패널 분리(split)

단축키	설명
Ctrl+b + %	세로 분할 (vertical)
Ctrl+b + "	가로 분할 (horizontal)

● 패널 이동

단축키	설명
Ctrl+b + ← / → / ↑ / ↓	방향키로 이동
Ctrl+b + o	다음 패널
Ctrl+b + ;	이전 패널
Ctrl+b + { / }	패널 위치 이동
Ctrl+b + !	패널을 새 윈도우로 분리
Ctrl+b + x	패널 종료
Ctrl+b + Ctrl+o	패널 순환(swap)

● 패널 크기 조절

(Ctrl+b + : 명령창에서 실행)

resize-pane -D
resize-pane -U
resize-pane -L
resize-pane -R

resize-pane -D 10  # 10칸 변경
resize-pane -U 10
resize-pane -L 10
resize-pane -R 10

ctrl + b 를 누르고 option + 방향키로 사이즈 조절 (macOS)

---

6. 복사/붙여넣기(Copy Mode)

● 진입/종료

• Ctrl+b + [ : 복사모드 진입
• Ctrl+b + ] : 붙여넣기

● 복사모드 단축키

아래 표는 vi 키 기준이다. tmux 기본은 emacs 키맵이므로, h/j/k/l·g/G 같은 vi 이동을 쓰려면 ~/.tmux.conf에 한 줄이 필요하다.

setw -g mode-keys vi

키	설명
Space	선택 시작
Enter	선택 복사
Esc	선택 취소
g / G	위/아래 끝 이동
h/j/k/l	방향 이동
/	검색
#	paste buffer 목록
q	종료

---

7. 스크롤

• 키보드로: Ctrl+b + [ → ↑/↓
• 마우스로 스크롤하려면 .tmux.conf에 추가:

set -g mouse on

---

8. Tmux Plugin Manager (TPM)

플러그인 설치·구성과 대표 플러그인별 설명, 복붙용 .tmux.conf 블록은 별도 글에 정리해두었다: Tmux 설정 & 플러그인 설명

---

9. Resurrect/Continuum 팁

세션을 kill했는데도 다시 살아나는 경우가 있다면 tmux-resurrect + tmux-continuum의 자동 복원 기능 때문이다. @continuum-restore 'on' 상태에서는 tmux 시작 시점에 마지막 저장 상태를 자동으로 복원한다.

● 복원 데이터 저장 위치

~/.local/share/tmux/resurrect/

● 복원 데이터 삭제(초기화)

tmux kill-server
rm -rf ~/.local/share/tmux/resurrect/*

● 자동 복원 끄기

set -g @continuum-restore 'off'