Tmux cheatsheet (202605)

• 2026-05 : 수정
• 2017-07-14: 윈도우에서 session 관리
• 2017-07-10: tmux copy & paste
  {:.right-history}

터미널 명령은 $ tmux 로 표현하고, Tmux window 에서 Prefix key 키 조합은 는 C{:.keyword} 표기하고, Meta key인 Alt는 M{:.keyword}으로 표기한다 - Tmux Start 참조.

---

tmux.conf 사용

여기서는 .tmux.conf 를 활용해, 기능키/메타키 연결해서 기본 Prefix key인 Ctrl+b 를 Ctrl+a로 사용하고 마우스를 활성화 하고 사용한다.

.tmux.conf

• 기능키 Ctrl+A 지정.
• mouse mode 활성화

set -g prefix C-a
bind C-a send-prefix
unbind C-b
set -g mouse on

편집한 .tmux.conf 설정을 tmux 에 탑재한다.

1. tmux 세션 사용중

C-r : 설정 파일을 새로고침합니다 

2. tmux source 사용

tmux source ~/.tmux.conf

---

Tmux 세션

tmux 세션을 만들고, 세션에서 window를 구성하고, window 안에 pane에 대해서 요약

새로운 세션 시작하기

$ tmux                        #새로운 새션
$ tmux new -s session_name    #session_name으로 새로운 세션

세션을 dettach하면 세션은 저장된다. 사용하지 않으면 kill로 종료한다.

세션 이용하기

$ tmux ls
$ tmux list-session
$ tmux list-windows         # Window 목록

열린 세션에 붙기.

• 세션 번호중 낮은 번호에 우선해서 접속한다.

$ tmux attach
$ tmux at
$ tmux a

특정 세션에 접속하기

• 세션 번호 혹은 이름으로 접속한다.

$ tmux a -t session_name

세션 마감하기

$ tmux kill-session session_name

Tmux로 접속한 session은 처음 한개의 Window를 갖는다. window 안에서 session, window, pane을 관리한다. 각 윈도우는 한 개 이상의 Pane 구획으로 나누어 사용할 수 있다.

Tmux pane

Tmux window를 여러 분할면 pane으로 나눠 사용한다.

C-%          #수직으로 나누기
C-"          #수평으로 나누기
C-z          #현재 pane 확대 및 돌아오기
C-{          #현재 pane을 이전 pane 위치로 이동
C-}          #현재 pane을 다음 pane 위치로 이동
C-Arrow      #앞,뒤 pane을 방향키로 이동
C-M+Arrow    #pane 크기를 방향키에 따라 변경
C-spacebar   #pane 방향 전환 (수직<->수평)
C-!          #현재 pane을 새 window로 분리
C-x          #pane 종료
C-[          #pane에서 스크롤 기능을 활성화

Tmux copy & paste

tmux 는 자체 버퍼에 터미널에서 선택한 영역의 텍스트를 복사해서 사용할 수 있다.

C-[         # copy mode
Ctrl+space  # 복사할 영역을 선택한다. 터미널에 영역이 선택되어 보인다.
Ctrl+w      # 선택한 영역을 복사한다.
C-]         # 붙여 넣는다.

Tmux Window

현재 세션 이용

C-s            #Session 목록
C-$            #Session 이름 변경

세션에서 여러 윈도우를 추가 해서 사용할 수 있다.

C-c          #새로운 윈도우 생성

여러 윈도우는 윈도우 순서에 따라 현재 윈도우 화면을 교환 할 수 있다.

C-w          #윈도우 목록
C-1 ...      #지정 윈도우 번호로 전환: 0,1,...
C-p          #이전 윈도우로 이동
C-n          #다음 윈도우로 이동
C-l          #가장 마지막 윈도우로 이동
C-,          #현재 윈도우 이름 변경
C-&          #현재 윈도우 제거

현재 세션에서 나온다. 세션은 백그라운드에서 실행된다.

C-d          #현재 세션을 빠져 나온다 (detach)
C-D          #빠져나올 세션을 선택할 수 있다.

• detach 는 외부 터미널에서 tmux detach 를 실행하면 현재 tmux 세션이 분리된다.

Session transition

Tmux window 상태에서 여러 세션 사이의 전환 단축키;

C-$          # 현재 세션 이름 바꾸기
C-(          # 이전 세션으로 전환
C-)          # 다음 세션으로 전환
C-L          # 사용한 세션중 마지막 세션으로 전환
C-s          # 사용 가능한 세션 목록

단, 시스템 버퍼는 별도의 플러그인을 사용한다.

Terminal

문제가 tmux 내부의 문제인지, 아니면 SSH 연결 자체의 문제인지 분리해야 합니다.

Ctrl + b 후 d를 누르거나 (만약 Ctrl이 안 먹힌다면 다른 SSH 창을 열어) tmux detach를 시도하여 tmux 밖으로 나옵니다.

tmux 밖(우분투 순정 쉘)에서도 Ctrl + C 등이 안 먹히고 ^C 등으로 찍힌다면 윈도우 파워셀/SSH 프로그램 문제입니다.

tmux 밖에서는 잘 된다면 tmux 자체의 설정이나 버퍼 문제입니다. 이 경우 해당 tmux 세션을 완전히 종료(exit)하고 새로 만들어야 할 수 있습니다.

---

Tmux 관련글

1. Tmux 시작
2. Tmux cheatsheet
3. spicycode/tmux.conf
4. My Tmux Configuration