Settings Popup

설정 팝업 (:settings)

pytmux의 거의 모든 설정은 하나의 통합 설정 화면에서 보고 바꿀 수 있습니다. 설정이 config 파일·런타임 명령·서버 옵션·플러그인 전용 화면에 흩어져 있던 것을 한 곳에 모은 화면으로, 값을 바꾸면 즉시 적용되고 영속됩니다.

여는 법

• 명령 프롬프트에서: ESC → : → settings 입력 후 Enter
  • 별칭(같은 화면): config, preferences, prefs, 옵션
• 메뉴에서: 메뉴(prefix + Enter) → ⚙ 설정…

화면 구성

• 좌측 — 카테고리 세로 탭: 표시 · 입력 · 동작 · 상태줄 · Claude · 고급 · 키 탭을 클릭(또는 Tab)하면 우측 목록에서 그 카테고리 위치로 점프합니다.
• 우측 — 전체 설정 목록(스크롤): 카테고리별 dim 헤더(── 표시 ──)로 묶인 단일 목록. 각 행은 설정 이름 + 현재값/선택지를 보여 줍니다.

조작

키 / 동작	효과
↑ ↓	행 이동
← → (또는 값 클릭)	값 변경 — 즉시 적용 + 영속
Enter	문자열 설정은 입력 모달, 링크 행은 전용 화면 열기
Tab / 카테고리 탭 클릭	해당 카테고리로 점프
Esc · [x] · 바깥 클릭	닫기

행 종류에 따라 ←→가 다르게 동작합니다.

• 켜기/끄기(bool) — 켜짐 ⇄ 꺼짐 토글
• 선택지(enum) — 한 줄에 펼친 선택지를 순환(예: 탭 바 표시 항상 / 자동)
• 숫자(ratio·int) — ‹ 0.18 ›처럼 증감(흐리게 세기, 상태줄 갱신 주기 등)
• 문자열(str) — Enter로 입력 모달을 열어 값 입력(prefix, 시작 경로, 상태줄 포맷 등)
• 링크(link) — Enter/클릭으로 그 기능의 전용 화면을 엽니다(Claude·플러그인 항목)

값은 변경 즉시 반영되며, 백엔드에 따라 알맞은 경로로 저장됩니다 — 표시/입력/동작 설정은 config 파일에, 서버 옵션(단일 테두리·자동 이름 등)은 서버 옵션에, 언어는 로케일 설정에 기록됩니다. 일부 항목은 (재시작 시 발효)로 표시됩니다(예: VT 파서).

카테고리별 설정

표시

설정	종류	설명
비활성 패널 흐리게	bool	비활성 패널을 흐리게 표시
흐리게 세기	ratio	흐림 강도(0.0–0.8)
탭 바 표시	enum	항상 / 자동(2개 이상일 때만)
상태줄 위치	enum	아래 / 위
단일 패널 테두리	bool	패널이 하나일 때 테두리 생략
패널 헤더 표시	bool	패널 상단 이름/상태 표시
언어	enum	한국어 / English

입력

설정	종류	설명
마우스	bool	마우스 조작 사용
복사 모드 키	enum	vi / emacs 키맵
휠 스크롤백	bool	alt 화면에서 휠로 스크롤백
prefix 키	str	prefix 키 조합(기본 Ctrl-b)

동작

설정	종류	설명
새 패널 시작 경로	str	새 패널의 작업 디렉토리
터미널 제목 설정	bool	OSC 제목을 창 제목에 반영
상태줄 갱신 주기(초)	int	상태줄 갱신 간격(1–60)
탭 자동 이름	bool	활성 프로그램으로 탭 이름 자동
활동/벨 모니터	bool	비활성 탭의 활동·벨 표시
패널 동기화	bool	입력을 모든 패널에 동시 전송
리페인트 병합	bool	출력 폭증 시 리페인트 병합
중첩 자동 어태치	bool	중첩 세션 자동 승격
VT 파서	enum	pyte / native (재시작 시 발효)

상태줄

설정	종류	설명
status-left / status-right	str	좌/우 상태줄 포맷 문자열
status-bg / status-fg	str	상태줄 배경/전경 색

Claude · 고급(링크 행)

Enter/클릭으로 전용 화면을 엽니다.

• Claude: 토큰 절감 설정(token-saver) · 모델 선택 · 시작 규칙(claude-rules) · 토큰 로그 → 자세한 내용은 Claude-Code-Plugins
• 고급: 플러그인 관리(plugins) · 키 바인딩 목록(list-keys)

키 (읽기 전용)

키 탭은 ESC 모드·prefix 모드의 내장 키와 사용자 바인딩을 읽기 전용 레퍼런스로 보여 줍니다(여기서는 값을 바꾸지 않습니다). 전체 키 목록은 User-Manual의 키 바인딩 레퍼런스를 참고하세요.

---

관련 문서

• User-Manual — 전체 사용법·키 바인딩·명령 레퍼런스
• Claude-Code-Plugins — Claude 관련 링크 항목의 전용 화면들
• Plugin-System — plugins 링크가 여는 플러그인 관리