tmux 단축키는 운영체제와 관계없이 대부분 동일하다. 이 글에서는 공통 단축키를 중심으로 정리하고, 복사/붙여넣기만 macOS / Windows(WSL) 환경 차이를 따로 정리했다.
가장 중요한 개념: Prefix
tmux의 모든 단축키는 prefix 키를 먼저 누른 후 원하는 키를 누르는 방식으로 동작한다.
기본 prefix: Ctrl + b
사용 예시:
prefix + c(새 윈도우) →Ctrl + b누르고, 손을 뗀 다음c누르기prefix + 방향키(pane 이동) →Ctrl + b누르고, 손을 뗀 다음↑↓←→누르기
이 글에서
prefix는 모두Ctrl + b를 의미한다. prefix 키는 변경 가능하지만 기본값을 그대로 쓰는 경우가 많다.
Prefix와 관련된 키
| 기능 | 키 조합 | 설명 |
|---|---|---|
| 단축키 목록 | prefix + ? |
현재 모든 키 바인딩 목록 표시 |
| 커맨드 모드 | prefix + : |
하단에 tmux 명령어 입력 |
세션(Session)
세션은 tmux의 최상위 단위다. 여러 프로젝트를 세션으로 나누어 관리할 수 있다.
단축키
| 기능 | 키 조합 | 설명 |
|---|---|---|
| detach | prefix + d |
현재 세션에서 분리 (백그라운드로) |
| 세션 선택 | prefix + s |
세션 목록에서 선택 |
| 이전 세션 | prefix + ( |
이전 세션으로 전환 |
| 다음 세션 | prefix + ) |
다음 세션으로 전환 |
쉘 명령어
| 기능 | 명령어 | 설명 |
|---|---|---|
| 세션 목록 | tmux ls |
세션 리스트 출력 |
| 새 세션 | tmux new -s <name> |
이름 지정하여 생성 |
| 세션 접속 | tmux attach -t <name> |
특정 세션에 다시 접속 |
| 세션 종료 | tmux kill-session -t <name> |
특정 세션 종료 |
| 전체 종료 | tmux kill-server |
모든 세션 종료 |
윈도우(Window)
윈도우는 세션 안의 탭 같은 개념이다.
| 기능 | 키 조합 | 설명 |
|---|---|---|
| 새 윈도우 | prefix + c |
새 윈도우 생성 |
| 윈도우 목록 | prefix + w |
목록에서 선택 |
| 다음 윈도우 | prefix + n |
다음 윈도우로 이동 |
| 이전 윈도우 | prefix + p |
이전 윈도우로 이동 |
| 번호로 이동 | prefix + 0-9 |
해당 번호 윈도우로 이동 |
| 마지막 윈도우 | prefix + l |
바로 전 윈도우로 이동 |
| 이름 변경 | prefix + , |
현재 윈도우 이름 변경 |
| 인덱스 변경 | prefix + . |
윈도우 순서 변경 |
| 윈도우 종료 | prefix + & |
현재 윈도우 종료 |
Pane
Pane은 윈도우를 분할한 화면 영역이다.
분할 및 이동
| 기능 | 키 조합 | 설명 |
|---|---|---|
| 가로 분할 | prefix + " |
위/아래로 분할 |
| 세로 분할 | prefix + % |
좌/우로 분할 |
| Pane 이동 | prefix + 방향키 |
상/하/좌/우 pane 이동 |
| 다음 pane | prefix + o |
다음 pane 선택 |
| 이전 pane | prefix + ; |
마지막 활성 pane으로 이동 |
| 번호 표시 | prefix + q |
각 pane 번호 잠시 표시 |
| Pane 종료 | prefix + x |
현재 pane 종료 |
| 전체 화면 | prefix + z |
현재 pane 전체 화면 토글 |
레이아웃
| 기능 | 키 조합 | 설명 |
|---|---|---|
| 레이아웃 순회 | prefix + Space |
미리 정의된 레이아웃 순차 적용 |
| Pane 회전 | prefix + Ctrl + o |
pane 순서 반시계 방향 회전 |
| 위치 교환 | prefix + { / } |
이전/다음 pane과 교환 |
크기 조절
| 기능 | 키 조합 | 설명 |
|---|---|---|
| 미세 조절 | prefix + Ctrl + 방향키 |
1 cell씩 조절 |
| 크게 조절 | prefix + Alt + 방향키 |
5 cell씩 조절 |
크기 조절은 키를 누른 상태로 유지하면 계속 조절된다.
복사 / 붙여넣기
tmux 자체 복사 기능은 OS와 무관하게 동일하지만, 시스템 클립보드와 연동하는 방식은 환경에 따라 다르다.
공통 tmux 키
| 기능 | 키 조합 | 설명 |
|---|---|---|
| copy-mode 진입 | prefix + [ |
스크롤 및 텍스트 선택 모드 |
| 붙여넣기 | prefix + ] |
마지막 버퍼 붙여넣기 |
| 버퍼 선택 | prefix + = |
버퍼 목록에서 선택 후 붙여넣기 |
copy-mode 내 이동 (vi 모드 기준)
tmux 기본은 emacs 모드지만, 대부분 vi 모드로 설정해서 사용한다.
| 기능 | 키 | 설명 |
|---|---|---|
| 위로 스크롤 | k 또는 ↑ |
한 줄 위로 |
| 아래로 스크롤 | j 또는 ↓ |
한 줄 아래로 |
| 페이지 업 | Ctrl + u |
반 페이지 위로 |
| 페이지 다운 | Ctrl + d |
반 페이지 아래로 |
| 맨 위로 | g |
버퍼 처음으로 |
| 맨 아래로 | G |
버퍼 끝으로 |
| 검색 | / |
아래로 검색 |
| 역검색 | ? |
위로 검색 |
| 다음 검색 | n |
다음 일치 항목 |
| 종료 | q |
copy-mode 종료 |
macOS 설정
터미널 자체 복사(Cmd + C)를 써도 되지만, tmux copy-mode에서 시스템 클립보드로 바로 복사하려면 설정이 필요하다.
.tmux.conf:
setw -g mode-keys vi
bind-key -T copy-mode-vi v send-keys -X begin-selection
bind-key -T copy-mode-vi y send-keys -X copy-pipe "pbcopy"
이렇게 설정하면:
prefix + [로 copy-mode 진입v로 선택 시작y로 복사 → macOS 클립보드로 전달
Windows / WSL 설정
Windows Terminal을 쓴다면 터미널 자체 복사(Ctrl + Shift + C)가 가장 간단하다.
tmux copy-mode에서 Windows 클립보드로 보내려면:
.tmux.conf:
setw -g mode-keys vi
bind-key -T copy-mode-vi v send-keys -X begin-selection
bind-key -T copy-mode-vi y send-keys -X copy-pipe "clip.exe"
기타
| 기능 | 키 조합 | 설명 |
|---|---|---|
| 시계 표시 | prefix + t |
화면 중앙에 시계 표시 |
| 메시지 로그 | prefix + ~ |
tmux 메시지 로그 보기 |
| 설정 리로드 | prefix + : 후 source-file ~/.tmux.conf |
설정 다시 불러오기 |
prefix + r로 설정 리로드를 하려면.tmux.conf에bind r source-file ~/.tmux.conf를 추가해야 한다.
자주 쓰는 조합 요약
| 작업 | 단축키 |
|---|---|
| 세션 분리 | Ctrl+b → d |
| 세션 목록 | Ctrl+b → s |
| 윈도우 생성 | Ctrl+b → c |
| 윈도우 이동 | Ctrl+b → 0-9 |
| Pane 가로 분할 | Ctrl+b → " |
| Pane 세로 분할 | Ctrl+b → % |
| Pane 이동 | Ctrl+b → 방향키 |
| Pane 전체 화면 | Ctrl+b → z |
| 스크롤/복사 | Ctrl+b → [ |
| 붙여넣기 | Ctrl+b → ] |
참고
prefix + ?로 전체 키 바인딩을 항상 확인할 수 있다.- vi 모드를 쓰려면
setw -g mode-keys vi를.tmux.conf에 추가한다.