tmux 단축키 정리: 세션, 윈도, 패널 명령어 모음

tmux 단축키를 먼저 찾는 이유

tmux는 터미널 세션을 유지하면서 하나의 창 안에서 여러 작업 화면을 관리하는 터미널 멀티플렉서입니다. 터미널을 닫거나 SSH 연결이 끊겨도 세션이 남아 있어서, 오래 걸리는 테스트나 Claude Code, Codex 작업을 실행할 때 많이 씁니다.

가장 먼저 익힐 단축키는 Ctrl+b d입니다. 현재 세션에서 화면만 빠져나오는 키이고, 안에서 실행 중인 프로세스는 계속 실행됩니다. 나중에 같은 세션으로 다시 들어가면 빠져나올 때의 작업 화면이 그대로 보입니다.

위 화면처럼 한 윈도 안에 패널을 여러 개 만들면 편집기와 로그, 테스트 명령을 한 화면에서 함께 볼 수 있습니다. 화면 구성은 단축키로 바꾸고, 세션은 셸 명령어로 만들고 관리합니다. tmux 공식 위키의 Getting Started 가이드도 이 구조를 세션, 윈도, 패널 순서로 설명합니다.

tmux 단축키는 키 하나가 아니라 접두 키(prefix)와 두 번째 키의 조합입니다. 기본 접두 키는 Ctrl+b이고, 아래 표의 Prefix는 이 키를 뜻합니다. 맥에서도 Command가 아니라 Control을 씁니다. 접두 키를 바꾼 설정 파일이 있다면 그 설정이 적용됩니다.

Prefix d를 누르는 순서

1. 11. Ctrl+bCtrl과 b를
   함께 누름
2. 22. 두 키 모두 놓기화면에는
   아무것도 안 뜸
3. 33. 두 번째 키d를 누르면
   세션에서 빠져나옴

2단계에서 손을 떼지 않고 Ctrl+b를 누른 채 d를 누르면 아무 일도 일어나지 않는 것처럼 보입니다.

이 글은 tmux가 설치된 맥이나 리눅스 터미널 기준입니다. tmux -V를 입력해 버전 번호가 나오면 설치돼 있고, 설치 방법은 tmux 기본 사용 안내에 있습니다.

tmux 세션은 프로그램이 실행되는 컴퓨터가 켜져 있는 동안만 유지됩니다. 그 컴퓨터를 끄거나 재부팅하면 세션도 사라지고, 잠자기에 들어가면 작업이 멈추거나 늦어집니다.

tmux 단축키 한눈에 보기

tmux 화면은 세 단위로 나뉘고, 큰 단위 안에 작은 단위가 들어갑니다. 이 글의 패널은 tmux 공식 용어인 페인(pane)과 같은 말입니다. 윈도(window)는 터미널 탭처럼 화면을 바꾸는 단위이고, 운영체제 윈도우와는 다른 말입니다.

세션, 윈도, 패널과 자주 쓰는 키

1. 11. 세션프로젝트별 작업 묶음
   Prefix d로 빠져나옴
2. 22. 윈도세션 안의 탭
   Prefix c로 만들고 n, p로 이동
3. 33. 패널윈도를 나눈 구역
   Prefix %로 좌우 분할

세션과 윈도 관리

세션은 하나의 작업 묶음입니다. 프로젝트마다 세션을 만들고 그 안에서 윈도와 패널을 나누면 어떤 작업을 어디서 돌리는지 기억하기 쉽습니다.

패널 분할과 이동

패널은 한 윈도 안에서 나눈 터미널 구역입니다. 서버를 실행하는 패널, AI 코딩 도구를 실행하는 패널, 테스트 명령을 실행하는 패널을 나눠 두면 화면을 바꾸는 횟수가 줄어듭니다.

%와 "는 키보드 배열에 따라 Shift를 함께 눌러 입력합니다. 흔히 쓰는 배열에서 %는 Shift+5입니다. 화면을 나눈 뒤에는 순서대로 도는 Prefix o보다 Prefix 방향키를 쓰면 원하는 패널로 바로 갑니다. Prefix z를 한 번 더 누르면 확대 전 배치로 돌아오고, Prefix w 목록에서는 방향키로 고른 뒤 Enter로 이동하고 q로 닫습니다.

가장 조심할 것은 화면에서 빠져나오는 키와 작업을 끝내는 키를 혼동하는 일입니다.

빠져나오는 키와 끝내는 키

키나 명령	안의 작업 유지	확인 질문
Prefix d	제공	–
Prefix z	제공	–
Prefix x	제공하지 않음	제공
Prefix &	제공하지 않음	제공
tmux kill-session -t 이름	제공하지 않음	–

화면 아래의 상태줄에 지금 세션과 윈도 위치가 나옵니다. Prefix w로 윈도 목록을 열 때도 이 이름이 기준이 되므로, 오래 실행하는 작업에는 Prefix ,로 윈도 이름을 붙여 두는 편이 좋습니다.

스크롤과 복사

터미널 로그는 화면을 넘어가면 사라진 것처럼 보입니다. tmux의 복사 모드에 들어가면 이전 출력으로 올라가 내용을 다시 보고 텍스트를 복사할 수 있습니다.

선택과 복사 키는 키 설정이 emacs 방식인지 vi 방식인지에 따라 다릅니다. tmux 안의 빈 명령창에서 tmux show-options -w mode-keys를 입력하면 mode-keys emacs나 mode-keys vi 중 하나가 나옵니다.

키 설정에 따른 복사 모드 키

동작	emacs 방식	vi 방식
선택 시작	Ctrl+Space	Space
복사	Alt+w	Enter
복사 모드 종료	Esc	q

빌드 로그에 나온 오류 메시지 한 줄을 복사하는 경우를 예로 들면 순서는 이렇습니다.

로그 한 줄을 복사해 붙여 넣는 순서

1. 11. 복사 모드Prefix [ 로 들어가
   방향키로 위로 이동
2. 22. 선택 시작오류 문장 첫 글자에서
   Ctrl+Space나 Space
3. 33. 복사마지막 글자까지 이동 뒤
   Alt+w나 Enter
4. 44. 버퍼 확인빈 명령창에서
   tmux show-buffer
5. 55. 붙여 넣기넣을 곳에서
   Prefix ]

3단계 전에는 강조된 구역에 첫 글자부터 마지막 글자까지 들어 있는지 봅니다. Ctrl+Space가 입력 언어 전환 단축키로 잡혀 있으면 선택이 시작되지 않으니, 복사 모드에서 나와 운영체제의 키 설정을 바꿉니다. 터미널 앱이 다른 키를 가로챌 때는 공식 매뉴얼의 복사 모드에서 현재 바인딩을 찾습니다.

tmux 복사 버퍼는 운영체제 클립보드와 따로 관리됩니다. 그래서 4단계에서 tmux show-buffer로 내용을 먼저 보고, 5단계의 Prefix ]는 tmux 안의 프로그램에 붙여 넣을 때 씁니다. 버퍼에 여러 줄 명령이 들어 있으면 Prefix ]를 누르는 순간 실행될 수 있으므로, 내용을 모르는 버퍼는 작업 중인 명령창에 붙여 넣지 않습니다. 화면 기록에는 저장 한도가 있어서 아주 오래된 출력은 남지 않습니다.

tmux 세션을 만드는 명령어

단축키는 이미 열린 세션 안에서 쓰고, 세션을 만들거나 다시 연결할 때는 셸에서 tmux 명령어를 실행합니다.

세션을 만들고 빠져나왔다 다시 연결하기

프로젝트 폴더에서 my-app 세션을 만들고, 작업을 둔 채 빠져나왔다가 돌아오는 순서입니다.

1. 터미널에서 tmux new -s my-app을 입력합니다. 상태줄에 my-app이 보이면 세션 안에 들어온 것입니다.
2. 세션 안에서 서버 실행이나 테스트처럼 오래 걸리는 명령을 시작합니다.
3. Prefix d를 누릅니다. [detached (from session my-app)]가 표시되며 바깥 터미널로 돌아옵니다.
4. tmux ls를 입력해 목록에 my-app이 있는지 봅니다.
5. tmux attach -t my-app을 입력합니다. 빠져나오기 전의 화면과 출력이 그대로 보이면 성공입니다.

터미널

> tmux new -s my-app

상태줄에 [my-app] 표시, 명령 실행 뒤 Ctrl+b, d

[detached (from session my-app)]

> tmux ls

my-app: 1 windows (created Sun Oct 4 10:12:03 2026)

목록에 세션 이름이 있으면 다시 붙을 수 있습니다

> tmux attach -t my-app

작업이 끝나 세션까지 닫으려면 세션 안에서 프로그램을 끝낸 뒤 빈 명령창에 exit를 입력합니다. 패널이 하나뿐인 세션은 이때 함께 종료됩니다.

duplicate session 오류는 같은 이름의 세션이 이미 있다는 뜻입니다. 내가 만든 세션이면 tmux attach -t my-app으로 들어가고, 누구의 작업인지 모르는 세션이면 종료하지 말고 다른 이름으로 새 세션을 만듭니다. 다른 이름으로 새 세션을 만들었다면 다시 연결할 때도 그 이름을 씁니다.

-t 없이 tmux attach만 입력하면 기존 세션 하나에 바로 연결됩니다. 세션이 여러 개라면 -t 뒤에 이름을 적어야 원하는 세션으로 갑니다. 표의 kill-session은 그 세션 전체를 끝내는 명령이라 화면에서 빠져나올 때 쓰지 않습니다.

Claude Code와 Codex를 tmux에서 실행하는 방법

tmux와 AI 코딩 도구는 하는 일이 다릅니다. tmux는 터미널 화면과 세션을 유지하고, Claude Code와 Codex는 프로젝트 파일을 읽고 고칩니다. 그래서 Ctrl+b로 시작하는 키는 tmux가 받고, 그 밖의 입력은 지금 선택한 패널의 AI 도구가 받습니다.

패널 두 개로 나누기

두 도구가 설치돼 있고 로그인까지 마친 상태를 전제로 합니다. 사용량 한도와 요금은 도구마다 따로 적용됩니다. 먼저 작업할 프로젝트 폴더로 이동해 pwd로 위치를 확인하고 세션을 만듭니다.

왼쪽에 Claude Code, 오른쪽에 Codex 띄우기

1. 11. claude 실행세션 첫 패널에서
   Claude Code 시작
2. 22. 좌우 분할Prefix %
   오른쪽에 새 패널
3. 33. codex 실행새 패널에서
   Codex 시작
4. 44. 패널 오가기Prefix 방향키로
   입력할 패널 선택

한 패널에서 코드를 고치고, 다른 패널에서 테스트 결과나 리뷰를 봅니다. 두 에이전트가 같은 파일을 동시에 고치면 변경 내용이 충돌하므로 한쪽에는 읽기와 검토만 맡깁니다. 다만 읽기만 하라고 요청해도 그 도구의 파일 수정 권한이 막히지는 않으니, 실제로 바뀐 파일이 없는지도 봅니다.

긴 작업을 실행하고 터미널을 닫기

빌드나 테스트처럼 오래 걸리는 작업은 tmux 세션 안에서 실행합니다. 아래의 npm run build는 Node.js 프로젝트의 package.json에 build 명령이 등록돼 있을 때 쓰는 예이므로, 그 프로젝트 폴더에서 시작합니다.

작업을 계속 실행한 채 화면에서 빠져나오려면 Prefix d를 누릅니다. 나중에 출력이 어디까지 진행됐는지, 프로세스가 끝났는지 보려면 다시 연결합니다.

SSH로 서버에 접속해 작업할 때도 방식은 같지만, tmux를 어디서 시작했는지가 결과를 정합니다.

tmux를 시작한 곳에 따른 원격 작업 유지

시작한 방법	SSH가 끊겨도 유지	서버 재부팅 뒤 유지
서버에 SSH로 접속한 뒤 그 안에서 tmux 시작	제공	제공하지 않음
내 노트북의 tmux 안에서 SSH 접속	제공하지 않음	제공하지 않음
tmux 없이 SSH 창에서 바로 실행	제공하지 않음	제공하지 않음

내 노트북의 tmux는 노트북 쪽 터미널만 지켜 주므로, 연결이 끊기면 원격 프로그램은 따로 보호받지 못합니다. 서버 자체가 재부팅되거나 서버의 tmux 프로세스가 종료되면 세션도 남지 않습니다.

tmux 단축키가 작동하지 않을 때

Ctrl+b를 눌렀는데 아무 변화가 없을 때

접두 키 Ctrl+b는 눌러도 화면에 아무 글자가 뜨지 않습니다. 누른 뒤 두 키를 모두 놓고 두 번째 키를 눌러야 합니다. Ctrl+b를 계속 누른 채 d를 누르면 동작하지 않는 것처럼 보입니다.

Ctrl+b가 Claude Code에 전달되지 않을 때

tmux 안에서 Claude Code를 실행하면 Ctrl+b를 tmux가 먼저 가져갑니다. Claude Code의 Ctrl+B는 실행 중인 Bash 명령을 백그라운드로 보내는 단축키라서 tmux 기본 접두 키와 겹칩니다. Claude Code 문서는 tmux 안에서 이 동작을 쓰려면 Ctrl+B를 두 번 누르라고 안내합니다.

세션 이름을 찾지 못할 때

먼저 세션 목록을 봅니다.

목록에 세션이 없으면 세션을 만든 컴퓨터에 같은 사용자 계정으로 접속했는지부터 봅니다. tmux가 다른 소켓을 쓰도록 설정한 환경에서도 목록이 다르게 나옵니다. 환경이 맞는데도 없다면 세션이 이미 종료된 것입니다. 목록에는 있는데 연결되지 않는다면 이름을 한 글자씩 맞춘 뒤 다시 입력합니다.

tmux 안에서 또 tmux를 실행했을 때

tmux 안에서 다시 tmux new를 실행하면 접두 키와 화면 구조가 겹쳐 어느 세션을 조작하는지 알기 어려워집니다. 지금 tmux 안인지는 두 명령으로 확인합니다.

터미널

> echo "$TMUX"

/tmp/tmux-501/default,41237,0

> tmux display-message -p '#S:#I.#P'

my-app:0.1

세션 my-app, 0번 윈도, 1번 패널 안에 있다는 뜻입니다

첫 명령의 결과가 비어 있으면 tmux 밖입니다. 값이 나오면 이미 tmux 안이므로 새 세션을 만들지 말고, 밖으로 나가려면 Prefix d를 누릅니다.

자주 묻는 질문

tmux에서 가장 먼저 외울 단축키는 무엇인가요?

Prefix d, Prefix c, Prefix n, Prefix p 네 개입니다. 세션에서 빠져나오고, 새 윈도를 만들고, 윈도 사이를 오가는 기본 흐름이 이 네 키로 됩니다.

tmux를 종료하면 실행 중인 Claude Code도 종료되나요?

Prefix d는 화면에서 빠져나오는 키이고 세션을 끝내지 않으므로 Claude Code는 계속 실행됩니다. Prefix &, Prefix x, tmux kill-session처럼 윈도나 세션을 닫는 명령을 실행하면 그 안의 프로세스도 함께 종료될 수 있습니다.

tmux 세션은 컴퓨터를 재부팅한 뒤에도 남아 있나요?

컴퓨터가 켜져 있고 tmux 서버가 살아 있는 동안만 유지됩니다. 재부팅하면 기존 프로세스와 세션은 복원되지 않으므로, 재부팅 뒤에도 다시 실행돼야 하는 작업은 별도의 프로세스 관리자나 재시작 설정으로 실행합니다.

tmux와 터미널 탭은 무엇이 다른가요?

터미널 탭은 터미널 앱이 관리하는 화면이고, tmux 세션은 터미널 안에서 따로 실행되는 작업 공간입니다. SSH 연결이 끊겨도 작업을 유지해야 하거나 서버에서 여러 작업을 묶어 관리할 때는 tmux가 맞습니다.

참고 자료

• tmux 공식 GitHub 저장소
• tmux 매뉴얼
• Claude Code 대화형 모드 공식 문서
• Claude Code 명령어 공식 문서

3줄 요약

1. tmux는 터미널 세션을 유지하면서 하나의 창 안에서 여러 작업 화면을 관리하는 터미널 멀티플렉서입니다.

2. 기본 단축키는 Ctrl+b를 먼저 누른 뒤 두 번째 키를 누르는 방식이며 이 조합으로 세션, 윈도, 패널을 각각 관리합니다.

3. tmux new -s 이름으로 세션을 만들고 Ctrl+b d로 빠져나온 뒤 tmux attach -t 이름으로 작업 화면을 다시 엽니다.