상세 가이드

pytmux 사용 가이드

설치부터 패널·탭·마우스·메뉴·명령·Claude 연동·토큰·원격·운영·설정·플러그인까지, pytmux 의 모든 기능을 실제 화면 스크린샷과 함께 챕터별로 안내합니다. 각 페이지 아래에는 이전·다음 챕터로 이어지는 링크가 있습니다. 처음이라면 1. 시작 · 핵심 개념부터 차례로 읽으세요. 빠르게 둘러보려면 랜딩 페이지를 먼저 보세요.

🛠 최근 수정사항 · 2026-07-30 목요일 전체 변경 내역 →

안정 넓은 텍스트를 붙여넣으면 pytmux 가 몇십 초 동안 멈추던 것을 고쳤습니다. 테두리 문자를 걷어내는 검사가 줄 길이의 제곱으로 느려졌습니다 — 공백 10만 자 한 줄 32초 → 0.0035초.
복사 Claude Code 의 ! … 명령을 긁어 복사하면 줄바꿈·들여쓰기가 섞여 그대로 붙여넣을 수 없던 것을 고쳤습니다. 앱이 스스로 접은 자리를 알아보고 펴서 클립보드에 넣습니다 — 자세한 규칙은 6장(마우스로 제어)에 있습니다.
Claude /model 로 모델을 바꿔도 상태줄 모델 배지가 한동안 옛 모델을 보이던 것을 고쳤습니다. 배지는 같은 이름을 세 프레임 연속 본 뒤 바꾸는데, 화면이 멈춰 있으면 다시 읽지 않아 세다가 얼었습니다 — 이제 바꾼 직후 곧바로 따라옵니다.
원격 직접 ssh 가 안 되는 머신에도 중간 상자를 거쳐 붙을 수 있습니다 — remote-attach <C> via <B>. 중계 상자에 pytmux 가 있으면 그 상자를 거쳐 탭들이 붙습니다(탭 이름 ⇄B>C:이름) — 자동 재연결·재시작 복원도 거쳐 가는 경로를 잊지 않습니다.
문서 소개 사이트를 최신 배포본에 맞춰 최신화했습니다. 상세 가이드 11장(원격 페더레이션)에 다중홉을 새로 넣고, 3단으로 이어진 원격 탭 이름 표기(⇄B:C:이름)와 핀이 엉뚱한 탭에 붙던 수정도 함께 실었습니다.

챕터 한눈에

아래 카드에서 원하는 주제로 바로 갈 수 있습니다. 각 챕터는 해당 기능을 빠짐없이 다룹니다.

01시작 · 핵심 개념탭 → 윈도우 → 패널 계층, 셸 영속, 제어하는 세 가지 방법. 02설치의존성 설치, 실행, pytmux 명령 등록, SSH 자동 attach. 03패널 다루기분할·포커스 이동·크기 조절·줌·swap·rotate·레이아웃·삭제. 04탭 · 윈도우생성·전환·이름·재정렬·고정(핀)·닫기, 상태표시줄. 05스크롤백 · 복사휠 스크롤백, 검색, vi/emacs 키, 복사·붙여넣기. 06마우스로 제어드래그 복사, 클릭·우클릭·휠·경계선·배지 클릭 총정리. 07메뉴 · 명령 프롬프트계층형 메뉴, 명령 프롬프트, 전체 명령 목록, 키 재바인딩. 08Claude Code 연동상태 아이콘·자동 재개·권한모드·규칙·프롬프트 이력·화면 안정성. 09토큰 사용량기간·세션·한도·경고·/usage·시나리오 사용량 팝업. 10여러 머신 토큰 동기화공식 서버(또는 자기호스팅)로 여러 컴퓨터의 사용량을 합칩니다 — 아이디 없는 패스키, 코드 한 줄 등록. 11원격 페더레이션ssh 너머 서버 attach, 분홍 탭, 머지·detach·핀, 다중홉(via), keepalive. 12재시작 · 회복작업 보존 재시작, 네트워크 응답성 표시와 재접속. 13도구 · 위젯시계·달력·ncd 트리·IME 배지·RTT 그래프·캡처·Perforce·작성창. 14설정 파일pytmux.conf 옵션 전체, :settings 팝업, 한/영 전환. 15플러그인delete-to-disable 구조, 플러그인 관리 팝업 :plugins.