macOS에서 한글 IME가 활성화된 상태로 tmux prefix(Ctrl+B) 이후 키를 누르면 한글 자모(ㅈ, ㅊ 등)가 입력되어 단축키가 동작하지 않는 문제를 겪어본 적 있으신가요? 이 글에서는 macism을 활용해 이 문제를 깔끔하게 해결하는 방법을 소개합니다.

원리

Ctrl+B를 누르는 순간 macism으로 영문 입력으로 자동 전환한 뒤 prefix 모드에 진입합니다. 이후 누르는 키는 영문으로 들어가므로 단축키가 정상 동작합니다.

1. macism 설치

cd /tmp
git clone https://github.com/laishulu/macism.git
cd macism
make
sudo cp macism /usr/local/bin/macism

설치 확인:

macism
# 현재 입력 소스 출력됨 (예: com.apple.keylayout.ABC)

2. tmux 설정 추가

~/.tmux.conf 또는 ~/.config/tmux/tmux.conf에 아래 내용을 추가합니다:

# 한글 상태에서 prefix 단축키 안 먹히는 문제 해결
# Ctrl+B 누르면 자동으로 영문 전환 후 prefix 모드 진입
set -g prefix M-F12
bind-key -T root C-b run-shell -b "/usr/local/bin/macism com.apple.keylayout.ABC" \; switch-client -T prefix
bind-key -T prefix C-b send-keys C-b

설정 적용:

tmux source ~/.tmux.conf

동작 방식

  1. set -g prefix M-F12 — 기본 prefix를 실제로 누를 일 없는 키로 변경합니다.
  2. bind-key -T root C-b ... — Ctrl+B를 root 테이블에서 직접 가로채서:
    - run-shell -b macism ... — 백그라운드로 입력 소스를 영문(ABC)으로 전환
    - switch-client -T prefix — prefix 키 테이블로 진입
  3. bind-key -T prefix C-b send-keys C-b — 중첩 tmux에서 Ctrl+B Ctrl+B로 내부 세션에 prefix를 전달합니다.

참고 사항

  • macOS 전용입니다 (macism이 macOS Input Source Manager를 사용)
  • tmux 3.0 이상 필요 (switch-client -T 지원)
  • Ctrl+B 이후 다음 키를 누르기까지 수십 ms면 충분하므로 체감 지연 없음