tmux 단축키 정리: 세션, 윈도, 패널 명령어 모음
tmux 단축키와 명령어를 세션, 윈도, 패널 관리 순서로 정리했습니다. Ctrl+b 접두 키부터 분할, 이동, 복사, 종료까지 Claude Code와 Codex를 터미널에서 오래 실행할 때 필요한 명령을 예시와 함께 설명합니다.
목차
세 줄로 먼저 읽기
이번 방문에서 한 편은 바로 볼 수 있습니다.
tmux 단축키를 먼저 찾는 이유
tmux는 터미널 세션을 유지하면서 하나의 창 안에서 여러 작업 화면을 관리하는 터미널 멀티플렉서입니다. 터미널을 닫거나 SSH 연결이 끊겨도 세션을 남겨 둘 수 있어, 오래 걸리는 테스트와 Claude Code, Codex 작업을 실행할 때 유용합니다.
처음 익힐 tmux 단축키는 Ctrl+b d입니다. Ctrl+b를 먼저 누르고 손을 뗀 뒤 d를 누르면 현재 세션에서 빠져나옵니다. 실행 중인 프로세스는 계속 남아 있으므로, 나중에 같은 세션으로 다시 들어가면 작업 화면이 그대로 보입니다.
위 화면처럼 한 윈도 안에 여러 패널을 만들면 편집기와 로그, 테스트 명령이 한 화면에 놓입니다. 화면 구성은 단축키로 바꿀 수 있고, 세션 이름은 셸 명령어로 관리합니다. tmux 공식 위키의 Getting Started 가이드도 같은 기본 구조를 세션, 윈도, 패널 순서로 설명합니다.
tmux의 단축키는 일반 키 하나가 아니라 접두 키(prefix)와 두 번째 키를 조합합니다. 기본 접두 키는 Ctrl+b입니다. 아래 표에서 Prefix라고 표시한 항목은 Ctrl+b를 함께 누른 뒤 두 키를 모두 놓는다는 뜻입니다. 맥에서는 Command가 아닌 Control을 씁니다. 기존 설정에서 접두 키를 바꿨다면 그 설정이 우선합니다.
이 글은 tmux가 설치된 맥 또는 리눅스 터미널 기준입니다. tmux -V로 버전이 나오는지 먼저 확인합니다. 설치가 필요하다면 tmux 기본 사용 안내를 먼저 읽습니다. 프로그램이 실행되는 컴퓨터를 끄거나 재부팅하면 세션이 사라지고, 잠자기 중에는 작업이 계속 진행되지 않을 수 있습니다.
본문의 패널은 tmux 공식 용어인 페인(pane)을 뜻합니다. 윈도(window)는 터미널 탭처럼 화면을 전환하는 단위이며 윈도우 운영체제와는 다른 말입니다.
처음이라면 아래의 AI 없이 첫 세션을 만들고 다시 연결하기부터 연습한 뒤 이 표를 찾아보세요. 이미 세션을 쓰는 분은 필요한 단축키만 골라 확인하면 됩니다.
tmux 단축키 한눈에 보기
세션과 윈도 관리
세션은 하나의 작업 묶음입니다. 프로젝트별로 세션을 만들고, 한 세션 안에서 윈도와 패널을 나누면 작업 위치를 기억하기 쉽습니다.
| 단축키 | 기능 | 사용하는 순간 |
|---|---|---|
Prefix d | 현재 세션에서 빠져나오기 | 작업을 계속 실행한 채 터미널로 돌아갈 때 |
Prefix c | 새 윈도 만들기 | 같은 세션에서 새 터미널이 필요할 때 |
Prefix n | 다음 윈도로 이동 | 오른쪽 윈도로 이동할 때 |
Prefix p | 이전 윈도로 이동 | 왼쪽 윈도로 이동할 때 |
Prefix w | 윈도 목록 열기 | 이름을 보고 이동할 때 |
Prefix , | 현재 윈도 이름 바꾸기 | server, claude, tests처럼 구분할 때 |
Prefix & | 확인 후 현재 윈도 닫기 | 윈도 안의 모든 패널과 작업을 끝낼 때 |
Prefix l | 직전 윈도로 이동 | 방금 사용한 윈도와 오갈 때 |
패널 분할과 이동
패널은 한 윈도 안에서 나눈 터미널 영역입니다. 서버를 실행하는 패널, AI 코딩 도구를 실행하는 패널, 테스트 명령을 실행하는 패널을 나눠 두면 화면을 바꾸는 횟수가 줄어듭니다.
| 단축키 | 기능 | 사용하는 순간 |
|---|---|---|
Prefix % | 화면을 좌우로 나누기 | 두 터미널을 나란히 볼 때 |
Prefix " | 화면을 위아래로 나누기 | 로그와 명령 입력을 함께 볼 때 |
Prefix o | 다음 패널로 이동 | 패널을 순서대로 확인할 때 |
Prefix 방향키 | 해당 방향의 패널로 이동 | 원하는 패널로 바로 갈 때 |
Prefix z | 현재 패널을 전체 화면으로 전환 | 한 패널의 로그를 크게 볼 때 |
Prefix x | 확인 후 현재 패널 닫기 | 해당 패널과 그 안의 작업을 끝낼 때 |
Prefix q | 패널 번호 표시 | 번호를 보고 이동할 때 |
Prefix x와 Prefix &는 화면 숨기기가 아니라 종료 명령입니다. 기본 설정에서는 확인 질문이 나오며 n으로 취소합니다. Prefix z를 다시 누르면 확대 전 배치로 돌아옵니다. Prefix w 목록은 방향키로 고르고 Enter로 이동하며 q로 닫습니다.
Prefix %에서 %는 키보드 배열에 따라 Shift+5를 눌러 입력합니다. Prefix "도 같은 방식으로 큰따옴표를 넣습니다. 화면을 분할한 뒤에는 Prefix 방향키가 Prefix o보다 빠르게 느껴지는 경우가 많습니다.
상태줄은 현재 세션과 윈도 위치를 확인하는 곳입니다. Prefix w로 윈도 목록을 열었을 때도 이 이름이 기준이 되므로, 오래 실행하는 작업에는 Prefix ,로 윈도 이름을 붙여 두는 편이 좋습니다.
스크롤과 복사
터미널에 출력된 로그는 화면을 넘어가면 바로 사라진 것처럼 보입니다. tmux의 복사 모드를 쓰면 이전 출력으로 올라가 내용을 확인하고 텍스트를 복사합니다.
| 단축키 | 기능 |
|---|---|
Prefix [ | 복사 모드 시작 |
방향키 또는 PageUp | 화면 위아래로 이동 |
emacs 방식은 Esc, vi 방식은 q | 복사 모드 종료 |
Prefix ] | tmux 버퍼에 복사한 내용 붙여 넣기 |
Prefix ? | 현재 키 바인딩 목록 보기 |
tmux의 복사 버퍼는 운영체제의 클립보드와 별개입니다. 기본 키 설정이 emacs인지 vi인지에 따라 선택 키도 다릅니다. tmux 안의 빈 명령창에서 tmux show-options -w mode-keys를 입력해 mode-keys emacs 또는 mode-keys vi를 확인합니다.
먼저 echo 'copy-test'를 실행합니다. Prefix [로 들어가 방향키로 출력된 copy-test의 첫 글자에 커서를 옮깁니다. emacs 방식이면 Ctrl+Space로 선택을 시작하고 문자열 전체가 선택되도록 이동한 뒤 Alt+w로 복사합니다. vi 방식이면 Space로 선택을 시작하고 문자열 전체가 선택되도록 이동한 뒤 Enter로 복사합니다. 강조된 영역에 첫 글자부터 마지막 글자까지 들어 있는지 확인합니다. 맥에서는 Option 키가 Alt 신호를 보내도록 설정되어 있어야 하며, 그렇지 않으면 Esc를 누르고 놓은 뒤 w를 누르는 방법을 사용할 수 있습니다. Ctrl+Space가 입력 언어를 바꾸면 선택이 시작되지 않으므로 복사 모드에서 나와 키 설정을 확인합니다. 설정이나 터미널이 키를 가로채면 공식 매뉴얼의 복사 모드에서 현재 바인딩을 확인합니다.
복사가 끝나면 빈 명령창에서 tmux show-buffer로 내용이 copy-test인지 확인합니다. Prefix ]는 이 버퍼를 현재 프로그램에 입력하는 키입니다. 여러 줄 명령이 들어 있으면 실행될 수 있으므로, 모르는 내용을 작업 중인 명령창에 붙여 넣지 않습니다. 같은 방법으로 copy-again을 출력해 선택과 복사를 반복하면 됩니다. 화면 기록은 저장 한도가 있으므로 과거 출력이 전부 남는 것은 아닙니다.
tmux 세션을 만드는 명령어
단축키는 이미 열린 세션을 조작할 때 쓰고, 세션을 만들거나 다시 연결할 때는 셸에서 tmux 명령어를 실행합니다. 세션, 윈도, 패널을 각각 독립된 대상으로 생각하면 명령어를 외우기 쉽습니다.
| 명령어 | 기능 | 예시 |
|---|---|---|
tmux new -s 이름 | 이름을 정한 새 세션 만들기 | tmux new -s my-app |
tmux ls | 실행 중인 세션 목록 보기 | tmux ls |
tmux attach -t 이름 | 기존 세션에 다시 연결하기 | tmux attach -t my-app |
tmux kill-session -t 이름 | 세션 종료하기 | tmux kill-session -t my-app |
tmux rename-session -t 이전 새이름 | 세션 이름 바꾸기 | tmux rename-session -t 0 api |
tmux new-window -n 이름 | 이름을 정한 윈도 만들기 | tmux new-window -n tests |
tmux split-window -h | 좌우 패널 만들기 | tmux split-window -h |
tmux split-window -v | 위아래 패널 만들기 | tmux split-window -v |
AI 없이 첫 세션을 만들고 다시 연결하기
현재 터미널에 tmux new -s key-practice를 입력합니다. 상태줄에 key-practice가 보이면 그 안에서 echo 'first-check'를 실행합니다. 화면에 같은 문자가 출력되어야 합니다.
이제 Prefix d로 화면을 분리합니다. 바깥 터미널에서 다음을 한 줄씩 실행합니다.
tmux ls
tmux attach -t key-practice목록에 key-practice가 있고 다시 연결한 화면에 first-check가 남아 있으면 성공입니다. echo 'second-check'를 실행한 뒤 다시 분리하고 연결해 두 번째 출력도 확인해 보세요. 연습을 마치면 이 연습 세션의 빈 명령창에서 exit를 입력합니다. 페인이 하나인 예제이므로 세션도 종료됩니다.
duplicate session 오류는 같은 이름이 이미 있다는 뜻입니다. 본인의 연습 세션이면 다시 연결하고, 다른 작업인지 모르면 기존 세션을 종료하지 말고 새 이름으로 연습합니다. 이름을 바꾸면 생성과 연결 명령에서 같은 이름을 사용해야 합니다.
tmux attach만 실행하면 목록을 묻는 대신 기존 세션 하나를 선택해 연결합니다. 여러 세션이 있으면 -t 뒤에 이름을 지정하는 편이 혼동을 줄입니다. 위 표의 kill-session은 해당 세션 전체를 종료하므로 화면에서 나올 때 쓰지 않습니다.
Claude Code와 Codex를 tmux에서 실행하는 방법
tmux와 AI 코딩 도구의 역할은 다릅니다. tmux는 터미널 화면과 세션을 유지하고, Claude Code와 Codex는 프로젝트 파일을 읽고 수정하는 작업을 수행합니다. 두 기능을 한 도구로 생각하지 않으면 명령어를 눌러야 하는 위치도 헷갈리지 않습니다.
패널 두 개로 나누기
아래는 두 도구가 이미 설치되고 로그인된 분을 위한 선택 예제입니다. 연습에 두 도구를 모두 설치할 필요는 없습니다. 각각의 사용량 한도와 비용이 적용되며, tmux가 AI 이용료를 대신하지 않습니다. 먼저 실제 작업할 프로젝트 폴더로 이동해 pwd로 위치를 확인합니다. 왼쪽 패널에서 Claude Code를 실행하고 오른쪽 패널에서 Codex를 실행합니다.
tmux new -s ai-work세션 안에서 다음 순서로 실행합니다.
1. claude 실행
2. Ctrl+b를 누른 뒤 %를 눌러 좌우로 분할
3. codex 실행한 패널에서 코드를 수정하고 다른 패널에서 테스트 결과나 리뷰를 확인합니다. 두 에이전트가 같은 파일을 동시에 수정하게 두면 변경 내용이 충돌할 수 있으므로, 한쪽은 읽기와 검토만 맡기고 실제 변경도 확인합니다. 화면을 나누거나 읽기만 요청하는 것 자체가 파일 수정 권한을 차단하지는 않습니다.
긴 작업을 실행하고 터미널을 닫기
서버 실행이나 테스트처럼 시간이 오래 걸리는 작업은 tmux 세션 안에서 실행합니다. 아래 npm run build는 Node.js 프로젝트의 package.json에 build 명령이 등록된 경우에만 사용하는 예시입니다. 아무 폴더에서나 실행하는 연습 명령이 아닙니다. 해당 프로젝트 폴더에서 시작합니다.
tmux new -s build
npm run build작업을 계속 실행한 채 화면에서 빠져나오려면 Prefix d를 사용합니다. 다시 접속한 뒤 출력이 멈췄는지, 프로세스가 끝났는지 확인하려면 다음 명령어를 실행합니다.
tmux attach -t buildSSH로 서버에 접속해 작업할 때도 같은 방식이 적용됩니다. 원격 작업은 SSH로 접속한 서버 안에서 tmux를 시작해야 합니다. 다시 접속할 때도 같은 서버와 사용자 계정에서 세션에 연결합니다. 내 노트북에서 tmux를 켠 뒤 SSH를 실행하는 것만으로 원격 프로그램의 실행이 보장되지는 않습니다. 다만 서버 자체가 재부팅되거나 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 ls목록에 세션이 없으면 같은 컴퓨터와 사용자 계정인지 먼저 확인합니다. 다른 소켓을 쓰도록 설정한 환경에서도 목록이 다를 수 있습니다. 맞는 환경인데 세션이 없다면 종료되었을 가능성을 확인합니다. 목록에는 있는데 연결되지 않는다면 이름을 정확히 확인한 뒤 다음 명령어를 실행합니다.
tmux attach -t 세션이름tmux 안에서 또 tmux를 실행했을 때
$TMUX 환경 변수가 설정되어 있으면 이미 tmux 안에 있다는 뜻입니다. 이 상태에서 다시 tmux new를 실행하면 접두 키와 화면 구조가 겹쳐 헷갈릴 수 있습니다. 현재 세션을 확인하려면 다음 명령어를 실행합니다. 첫 결과가 비어 있으면 일반적으로 tmux 밖입니다. 세션 안에서는 둘째 명령이 세션:윈도번호.패널번호를 보여 줍니다. 밖으로 나가려면 Prefix d를 사용합니다.
echo "$TMUX"
tmux display-message -p '#S:#I.#P'자주 묻는 질문
tmux에서 가장 먼저 외울 단축키는 무엇인가요?
Prefix d와 Prefix c, Prefix n, Prefix p를 먼저 외우면 됩니다. 세션에서 빠져나오고, 새 윈도를 만들고, 윈도 사이를 이동하는 기본 흐름을 만들 수 있습니다.
tmux를 종료하면 실행 중인 Claude Code도 종료되나요?
Prefix d로 세션에서 빠져나오는 것은 tmux 세션을 종료하는 동작이 아닙니다. 프로세스는 계속 실행됩니다. Prefix &, Prefix x, tmux kill-session처럼 윈도나 세션을 종료하는 명령을 실행하면 안에서 실행한 프로세스도 종료될 수 있습니다.
tmux 세션은 컴퓨터를 재부팅한 뒤에도 남아 있나요?
컴퓨터가 실행 중이고 tmux 서버가 살아 있는 동안 유지됩니다. 재부팅 뒤에는 기존 프로세스와 세션이 자동으로 복원되지 않으므로, 필요한 작업은 별도의 프로세스 관리자나 재시작 설정이 필요합니다.
tmux와 터미널 탭은 무엇이 다른가요?
터미널 탭은 터미널 애플리케이션이 관리하는 화면이고, tmux 세션은 터미널 안에서 별도로 실행되는 작업 공간입니다. SSH 연결이 끊겨도 작업을 유지해야 하거나 서버에서 여러 작업을 묶어 관리할 때 tmux가 더 적합합니다.
참고 자료
3줄 요약
-
tmux는 터미널 세션을 유지하면서 하나의 창 안에서 여러 작업 화면을 관리하는 터미널 멀티플렉서입니다.
-
기본 단축키는 Ctrl+b를 먼저 누른 뒤 두 번째 키를 누르며 세션, 윈도, 패널을 각각 관리합니다.
-
tmux new -s 이름으로 세션을 만들고 Ctrl+b d로 빠져나온 뒤 tmux attach -t 이름으로 작업 화면을 다시 엽니다.
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
tmux에서 실행 중인 작업을 계속 둔 채 터미널 화면만 빠져나오려면 어떤 단축키를 사용해야 할까요?
이 글이 도움이 되었나요?
AI 검색에 인용되려면 먼저 크롤링과 색인이 되어야 합니다. 그 순서를 다룹니다
코스 전체 보기 →
새 글과 AI 소식을 메일로 받아 보세요
AI가 바꾸는 일과 도구, 측정 실무 이야기를 매주 한 번 보내 드려요.