🧷 tmux 설정과 TPM 플러그인 — .tmux.conf 실전 가이드

이 글은 tmux 로드맵의 설정 + Plugin 사용 구간이다. TPM으로 기본 플러그인을 관리하는 방법과 일상 사용에서 체감되는 tmux 자체 옵션을 함께 정리한다. 플러그인을 쓰는 게 아니라 직접 만드는 법은 tmux 플러그인은 어떻게 만드나에서.

📦 TPM (Tmux Plugin Manager)

set -g @plugin 'tmux-plugins/tpm'

👉 역할

tmux 플러그인을 설치·업데이트·삭제하는 플러그인 관리자다. 플러그인을 수동 설치할 수도 있으므로 필수 구성요소는 아니지만, 여러 플러그인을 함께 관리할 때 편리하다.

---

⬇ 설치

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

.tmux.conf 작성 후 tmux 안에서 prefix + I(Ctrl+b → I)로 플러그인을 설치한다.

---

📚 TPM 기반 기본 구성

1. tmux-plugins/tmux-sensible

set -g @plugin 'tmux-plugins/tmux-sensible'

✔ 역할

tmux의 기본값을 더 합리적인 설정(sane defaults) 로 변경해주는 플러그인. 기본 키 설정, 패널 동작, 기타 비직관적 설정들을 개선해 주기 때문에 필수 플러그인으로 널리 사용됨.

---

2. tmux-plugins/tmux-resurrect

set -g @plugin 'tmux-plugins/tmux-resurrect'
set -g @resurrect-capture-pane-contents 'on'

✔ 역할

tmux 세션을 “부활(resurrect)” 시켜주는 플러그인. 저장된 시점의 세션, 윈도우, 패널 레이아웃, 실행 중 명령 등을 복원해줌.

✔ 기능

• prefix + Ctrl-s → 세션 상태 저장
• prefix + Ctrl-r → 세션 복원
• 패널 내용까지 저장하려면 @resurrect-capture-pane-contents='on' 필요

---

3. tmux-plugins/tmux-continuum

set -g @plugin 'tmux-plugins/tmux-continuum'
set -g @continuum-restore 'on'

✔ 역할

tmux-resurrect를 기반으로 자동 백업 + 자동 복원 기능을 제공.

✔ 기능

• 자동 저장 (기본 15분 간격)
• 시스템 재부팅 후 tmux 자동 복원
• 개발 환경 그대로 복구 가능

👉 tmux-resurrect의 상위 확장 플러그인

세션 매니저(tmuxinator·smug)는 여기 플러그인과 다른 축이다. resurrect는 떠 있던 세션을 저장→복원하고, 세션 매니저는 tmux 밖의 외부 CLI로 레이아웃을 처음부터 선언→생성한다. TPM 플러그인이 아니라 별도 도구이며, 3단계 세션 부트스트랩에서 다룬다.

---

4. jimeh/tmux-themepack

set -g @plugin 'jimeh/tmux-themepack'
set -g @themepack 'powerline/default/cyan'

✔ 역할

다양한 상태바(theme) 를 제공하는 테마 플러그인.

✔ 효과

• Powerline 스타일 적용 가능
• 색상 조합을 쉽게 변경
• 테마 파일을 직접 수정할 필요 없음

---

5. christoomey/vim-tmux-navigator

set -g @plugin 'christoomey/vim-tmux-navigator'

✔ 역할

Vim/Neovim 패널과 Tmux 패널 사이를 Ctrl+h/j/k/l 로 자연스럽게 이동할 수 있게 해줌.

✔ 효과

• Vim 창 ↔ tmux pane 이동이 직관적
• Vim 사용자의 필수 플러그인

---

📎 더 찾기 · awesome-tmux (10.1k⭐, 유지 중) — 위 플러그인들 너머의 플러그인·설정·아티클을 카테고리별로 모아둔 커뮤니티 인덱스. 플러그인 대부분은 tmux-plugins org에 semi-공식으로 모여 있다(TPM 14.9k⭐·resurrect 12.9k⭐).

---

⚙ 기타 tmux 설정

기본 터미널 및 마우스 활성화

set -g default-terminal "tmux-256color"
set -g mouse on

설명

• tmux-256color: tmux 내부 terminfo로, 256색·이탤릭·True Color를 제대로 알린다. 과거 흔히 쓰던 screen-256color는 더 보수적인 fallback일 뿐이라, terminfo만 있으면 tmux-256color가 권장값이다. (아래 True Color 설정과 한 쌍)
• 만약 tmux-256color 적용 후 색이 깨지면 해당 terminfo가 없는 환경이다. screen-256color로 되돌리거나 terminfo를 설치한다.
• mouse on: 마우스로 패널 크기 조절, 선택, 스크롤 가능

---

🏁 TPM 초기화

run '~/.tmux/plugins/tpm/tpm'

tmux conf 맨 마지막 줄에 위치해야 함.

---

🧩 최종 .tmux.conf (플러그인 설명 포함)

# --- TPM ---
set -g @plugin 'tmux-plugins/tpm'

# --- Plugin list ---
set -g @plugin 'tmux-plugins/tmux-sensible'       # sane tmux defaults
set -g @plugin 'tmux-plugins/tmux-resurrect'      # save & restore tmux sessions
set -g @plugin 'tmux-plugins/tmux-continuum'      # auto-save & auto-restore
set -g @plugin 'jimeh/tmux-themepack'             # tmux status bar themes
set -g @plugin 'christoomey/vim-tmux-navigator'   # navigate between vim <-> tmux with Ctrl-hjkl

# --- Theme config ---
set -g @themepack 'powerline/default/cyan'

# --- Resurrect settings ---
set -g @resurrect-capture-pane-contents 'on'
set -g @continuum-restore 'on'

# --- Tmux settings ---
set -g default-terminal "tmux-256color"   # 색 깨지면 screen-256color로 fallback
set -g mouse on

# --- Initialize TPM (must be last) ---
run '~/.tmux/plugins/tpm/tpm'

---

자주 쓰는 .tmux.conf 설정

TPM으로 관리하는 플러그인과 별도로, tmux 자체 옵션 중 일상 사용에 영향을 주는 설정을 모았다. 아래 항목은 위 플러그인 설치 절차와 독립적으로 적용할 수 있다.

ESC 지연 줄이기

set -sg escape-time 0

Vim/Neovim에서 ESC와 Alt 계열 입력을 구분하기 위해 tmux가 기다리는 시간을 없앤다. 반응은 빨라지지만 일부 터미널·키 조합에서 Alt/Meta 입력 판별에 영향을 줄 수 있으므로 문제가 있다면 작은 값으로 조정한다.

True Color

먼저 tmux 안에서 사용할 terminal description을 정한다.

set -g default-terminal "tmux-256color"

tmux-256color terminfo가 시스템에 존재하는지는 확인한다.

infocmp -x tmux-256color

tmux 3.2+에서는 바깥 terminal emulator가 RGB color를 지원한다는 사실을 terminal-features로 알려주는 방식이 우선이다.

예를 들어 Ghostty·xterm 계열 TERM 값에 맞춰 다음처럼 설정할 수 있다.

set -as terminal-features ",xterm*:RGB"

환경에 따라 TERM 패턴은 달라질 수 있으므로 tmux 밖에서 다음을 먼저 확인한다.

echo "$TERM"

구버전 tmux까지 고려해야 한다면 terminal-overrides의 Tc 확장을 사용할 수 있다.

set -as terminal-overrides ",xterm*:Tc"

RGB
→ 공식 terminfo capability 이름

Tc
→ tmux가 제공해 온 확장 capability

무조건 *256col*에 True Color를 선언하기보다 실제 바깥 terminal emulator의 TERM과 기능을 확인한 뒤 설정하는 편이 안전하다.

마우스

set -g mouse on

패널 선택·크기 조절·스크롤 등 mouse integration을 활성화한다.

패널과 키 바인딩

분할 시 현재 경로 유지

bind '"' split-window -v -c "#{pane_current_path}"
bind % split-window -h -c "#{pane_current_path}"

새 pane을 현재 pane의 working directory에서 시작한다.

패널 정보 표시

set -g pane-border-status bottom
set -g pane-border-format " #P #{pane_current_command} "

pane 번호와 현재 command를 border에 표시한다.

copy-mode에 vi 키 사용

setw -g mode-keys vi

copy-mode의 key table을 vi 스타일로 사용한다.

세션 트리 정렬

bind s choose-tree -Zs -O name

choose-tree를 이름 기준으로 정렬해 연다. tmux 버전에 따라 option 동작이 달라질 수 있으므로 바인딩이 실패하면 현재 tmux list-commands와 man page를 확인한다.

적용·검증

tmux source-file ~/.tmux.conf

설정 파일을 수정해도 이미 실행 중인 tmux server에는 자동 반영되지 않는다. True Color는 infocmp -x tmux-256color와 tmux 밖의 $TERM을 확인한다.