🧷 tmux 유용한 설정 정리 (.tmux.conf 기준)

실제로 쓰는 .tmux.conf에서 체감이 큰 옵션만 따로 모았다. 목적은 “왜 이 옵션을 두는지”를 잊지 않게 기록하는 것이다.

이 글은 tmux 로드맵의 1단계(설정 다듬기) 다.

1. 기본 동작

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을 활성화한다.

2. 패널과 키 바인딩

분할 시 현재 경로 유지

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 스타일로 사용한다.

3. 세션 트리 정렬

bind s choose-tree -Zs -O name

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

4. TPM 플러그인

플러그인 목록·역할과 설정은 Tmux 설정 & 플러그인 설명에 따로 둔다. 이 글에서는 tmux core option만 다룬다.

5. 적용과 리로드

TPM을 사용한다면 초기화는 플러그인 선언 뒤에 둔다.

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

현재 server에 설정을 다시 읽히려면:

tmux source-file ~/.tmux.conf

확인 순서

색이나 키 입력이 이상할 때는 설정을 더 붙이기 전에 다음 순서로 확인한다.

1. tmux 밖 TERM 확인
2. tmux 안 TERM 확인
3. tmux-256color terminfo 존재 여부 확인
4. terminal-features / terminal-overrides 확인
5. 애플리케이션(Neovim 등) 설정 확인

터미널 기능 문제는 tmux 한 층만의 문제가 아닐 수 있으므로 밖 terminal → tmux → 안쪽 application 순으로 범위를 좁힌다.