cmaven

작업노트

:bulb: 터미널 멀티플렉서 tmux의 세션 관리, 화면 분할, 단축키 등 기본 사용법을 작성한다.

[01] tmux란?

tmux(terminal multiplexer)는 하나의 터미널에서 여러 세션·윈도우·패널을 동시에 운영하는 도구다. SSH 접속이 끊겨도 세션이 유지되므로, 서버에서 장시간 실행하는 작업에 사용한다.

개념 설명
Session tmux의 최상위 단위. 독립적인 작업 공간. 이름을 붙여 관리 가능
Window 세션 안의 탭. 여러 개를 만들어 전환 가능
Pane 윈도우를 분할한 개별 터미널 영역

모든 tmux 단축키는 Prefix 키(Ctrl + b)를 먼저 누른 뒤 다음 키를 입력한다.

:bulb: Ctrl + b를 누르고 손을 뗀 후 다음 키를 입력한다. 동시에 누르는 것이 아니다.

[02] 설치



1
2
3
4
5



# Ubuntu / Debian
sudo apt install tmux

# macOS (Homebrew)
brew install tmux

버전 확인:



1



tmux -V

출력 예:



1



tmux 3.3a

[03] Session 생성 및 관리

3-1. 새 세션 생성

(A) 이름 없이 생성



1



tmux

(B) 이름을 지정해서 생성 (권장)



1



tmux new -s mywork

출력 예 (하단 상태 표시줄):



1



[mywork] 0:bash*                                         "hostname" 10:00 06-Mar-26

상태 표시줄 왼쪽에 세션 이름 [mywork]가 표시된다.

옵션 설명:

명령 설명
tmux new 새 세션 생성 (new-session의 축약)
-s mywork 세션 이름을 mywork로 지정

3-2. 세션에서 빠져나오기 (Detach)

세션을 종료하지 않고 백그라운드로 내려보내는 방법이다. SSH 연결이 끊겨도 세션은 서버에서 계속 실행된다.



1



Ctrl + b → d

출력 예:



1



[detached (from session mywork)]

3-3. 세션 목록 확인



1



tmux ls

출력 예:



1
2



mywork: 1 windows (created Thu Mar  6 10:00:00 2026)
deploy: 2 windows (created Thu Mar  6 09:30:00 2026)

3-4. 세션에 다시 접속 (Attach)



1
2
3
4
5
6
7
8



# 이름으로 접속
tmux attach -t mywork

# 축약형
tmux a -t mywork

# 세션이 하나뿐이면 이름 생략 가능
tmux a

출력 예 (접속 후 상태 표시줄):



1



[mywork] 0:bash*                                         "hostname" 10:05 06-Mar-26

옵션 설명:

명령 설명
tmux attach 세션에 재접속 (attach-session의 축약)
-t mywork 접속할 세션 이름 지정

3-5. 세션 종료



1
2
3
4
5
6
7
8



# 세션 안에서 종료
exit

# 외부에서 특정 세션 종료
tmux kill-session -t mywork

# 모든 세션 종료
tmux kill-server

3-6. 세션 단축키 요약

단축키 설명
Ctrl + b → d 현재 세션에서 Detach (세션 유지)
Ctrl + b → s 세션 목록 보기 및 전환
Ctrl + b → $ 현재 세션 이름 변경

[04] 화면 분할 (Pane)

4-1. 화면 분할



1
2
3
4
5



# 좌우 분할 (수직 분할선)
Ctrl + b → %

# 상하 분할 (수평 분할선)
Ctrl + b → "

분할 예시:



1
2
3
4
5
6
7
8
9
10
11



┌─────────────┬─────────────┐
│             │             │  ← Ctrl+b % (좌우 분할)
│   pane 0    │   pane 1    │
│             │             │
└─────────────┴─────────────┘

┌─────────────────────────────┐
│          pane 0             │  ← Ctrl+b " (상하 분할)
├─────────────────────────────┤
│          pane 1             │
└─────────────────────────────┘

4-2. 패널 간 이동

방향키로 이동



1



Ctrl + b → ↑ / ↓ / ← / →

순서대로 이동 (다음/이전 패널)



1
2



Ctrl + b → o       # 다음 패널로 이동
Ctrl + b → ;       # 직전에 사용한 패널로 이동

패널 번호로 이동



1



Ctrl + b → q       # 패널 번호 표시

출력 예 (번호가 잠깐 화면에 표시됨):



1
2
3
4
5



┌─────────────┬─────────────┐
│             │             │
│      0      │      1      │
│             │             │
└─────────────┴─────────────┘

번호가 표시되는 동안 해당 숫자 키를 누르면 그 패널로 이동한다.



1



Ctrl + b → q → 1   # 1번 패널로 이동

4-3. 패널 크기 조절

Prefix 입력 후 방향키를 누르면 패널 경계를 이동할 수 있다.



1



Ctrl + b → Alt + ↑ / ↓ / ← / →

또는 Prefix 입력 후 아래 방법으로도 가능하다.



1
2
3
4



Ctrl + b → :resize-pane -D 5   # 아래로 5칸 축소
Ctrl + b → :resize-pane -U 5   # 위로 5칸 확장
Ctrl + b → :resize-pane -L 5   # 왼쪽으로 5칸 축소
Ctrl + b → :resize-pane -R 5   # 오른쪽으로 5칸 확장

4-4. 패널 닫기



1
2
3
4
5



# 패널 안에서 셸 종료
exit

# 또는 단축키
Ctrl + b → x    # 현재 패널 닫기 (확인 메시지 표시)

출력 예 (확인 메시지):



1



kill pane mywork:0.1? (y/n)

y를 누르면 해당 패널이 닫힌다.

4-5. 패널 레이아웃 자동 변경



1



Ctrl + b → Space    # 레이아웃 순환 (even-horizontal → even-vertical → main-horizontal → ...)

4-6. 패널 단축키 요약

단축키 설명
Ctrl + b → % 좌우(수직) 분할
Ctrl + b → " 상하(수평) 분할
Ctrl + b → 방향키 인접한 패널로 이동
Ctrl + b → o 다음 패널로 순환 이동
Ctrl + b → ; 직전 패널로 이동
Ctrl + b → q 패널 번호 표시
Ctrl + b → q → 번호 해당 번호 패널로 이동
Ctrl + b → x 현재 패널 닫기
Ctrl + b → Space 레이아웃 순환
Ctrl + b → z 현재 패널 전체화면 전환 (토글)

[05] Window 관리

패널이 한 윈도우를 나눈 영역이라면, 윈도우는 브라우저의 탭에 해당한다.

5-1. 윈도우 단축키 요약

단축키 설명
Ctrl + b → c 새 윈도우 생성
Ctrl + b → w 윈도우 목록 보기 및 전환
Ctrl + b → n 다음 윈도우로 이동
Ctrl + b → p 이전 윈도우로 이동
Ctrl + b → 숫자 해당 번호 윈도우로 이동 (0~9)
Ctrl + b → , 현재 윈도우 이름 변경
Ctrl + b → & 현재 윈도우 닫기

[06] 스크롤 (Copy Mode)

tmux는 기본적으로 마우스 휠 스크롤이 되지 않는다. Copy Mode로 진입해야 위아래로 스크롤할 수 있다.

6-1. Copy Mode 진입/종료



1
2



Ctrl + b → [     # Copy Mode 진입 (스크롤 활성화)
q                # Copy Mode 종료 (스크롤 비활성화)

:bulb: Copy Mode 진입 후 터미널 하단에 [0/100] 같은 스크롤 위치 표시가 나타난다.

6-2. Copy Mode 내 이동 단축키

단축키 설명
↑ / ↓ 한 줄씩 위/아래 이동
Page Up / Page Down 한 화면씩 위/아래 이동
Ctrl + u / Ctrl + d 반 화면씩 위/아래 이동
g 버퍼 맨 위로 이동
G 버퍼 맨 아래로 이동
q Copy Mode 종료

6-3. 마우스 스크롤 활성화 (선택)

매번 Ctrl+b [ 없이 마우스 휠로 스크롤하려면 ~/.tmux.conf에 아래를 추가한다:



1



set -g mouse on

적용:



1



tmux source-file ~/.tmux.conf

:bulb: 마우스 모드를 켜면 마우스 클릭으로 패널 전환도 가능해진다.

[07] 전체 단축키 요약

구분 단축키 설명
세션 Ctrl+b d 세션 Detach
  Ctrl+b s 세션 목록 및 전환
  Ctrl+b $ 세션 이름 변경
윈도우 Ctrl+b c 새 윈도우 생성
  Ctrl+b w 윈도우 목록
  Ctrl+b n / p 다음 / 이전 윈도우
  Ctrl+b 숫자 번호로 윈도우 이동
  Ctrl+b , 윈도우 이름 변경
패널 Ctrl+b % 좌우 분할
  Ctrl+b " 상하 분할
  Ctrl+b 방향키 패널 이동
  Ctrl+b o 다음 패널 순환
  Ctrl+b q 패널 번호 표시
  Ctrl+b z 패널 전체화면 토글
  Ctrl+b x 현재 패널 닫기
  Ctrl+b Space 레이아웃 순환
스크롤 Ctrl+b [ Copy Mode 진입 (스크롤 활성화)
  q Copy Mode 종료 (스크롤 비활성화)
  Page Up / Down 한 화면씩 이동
기타 Ctrl+b ? 전체 단축키 목록 보기
  Ctrl+b : tmux 명령어 입력 모드

참고