tmux 사용법, 터미널 멀티플렉서로 압도적인 AI 작업 생산성 만들기

AI 에이전트 덕분에 개발자의 작업 방식이 완전히 바뀌었습니다. 이전처럼 개발자가 직접 코드를 작성하고 확인하지 않아도 여러 AI 에이전트를 동시에 활용해 동시다발적으로 작업을 처리할 수 있어 생산성과 효율성을 크게 높일 수 있습니다. 이 병렬 작업 환경의 중심에 있는 도구가 바로 ‘tmux’입니다.
tmux는 하나의 터미널 안에서 여러 작업을 동시에 관리할 수 있는 터미널 멀티플렉서입니다. 하나의 터미널 안에서 화면을 나누고 여러 AI 에이전트를 동시에 실행할 수 있습니다. 터미널을 닫아도 세션이 유지되기 때문에 작업 흐름이 끊기지 않고 이어집니다.
이 글에서는 tmux가 무엇인지, 일반 터미널과 어떻게 다른지, AI 코딩 에이전트 환경에서 어떻게 활용할 수 있는지를 설치 방법부터 기본 사용법까지 단계별로 정리했습니다.
tmux 핵심 요약
- tmux는 터미널 작업을 유지하는 도구입니다. 하나의 터미널 안에서 여러 작업을 동시에 관리하고, 세션 단위로 작업 상태를 유지할 수 있습니다. 서버 개발, 원격 접속, 배포, 로그 확인처럼 터미널 기반 작업이 많은 환경에서 유용합니다.
- AI 코딩 환경에서 병렬 작업을 돕습니다 tmux는 여러 pane을 나눠 Claude Code 같은 AI CLI 도구와 로그, 테스트 화면을 동시에 띄울 수 있습니다. AI 에이전트 작업을 한 화면에서 나눠 관리하면 작업 흐름을 더 빠르고 안정적으로 확인할 수 있습니다.
- 핵심 구조는 Session, Window, Pane입니다 Session은 전체 작업 공간, Window는 작업 탭, Pane은 화면을 나눈 분할 영역입니다. 이 구조를 이해하면 개발 서버, 테스트, 로그 확인, Git 작업을 목적별로 분리해 관리할 수 있습니다.
- 세션 관리와 기본 설정에 주의해야 합니다 tmux는 접속이 끊겨도 작업을 유지하지만, 전원 종료나 재부팅이 발생하면 세션이 사라질 수 있습니다.
- 또한 기본 히스토리 한도, 마우스 비활성화, Windows 사용 시 WSL 필요 같은 설정 요소를 확인해야 합니다.
tmux란 무엇인가?

tmux는 하나의 터미널 안에서 여러 작업을 동시에 관리할 수 있게 해주는 터미널 멀티플렉서입니다. 터미널 화면을 여러 개로 나눠도 작업 상태를 유지하며, 필요할 때 다시 이어서 볼 수 있게 해주는 도구입니다.
작업을 하나의 세션 안에 담아두고, 터미널에서 잠시 빠져나와도 작업을 계속 유지할 수 있습니다. 이런 이유로 tmux는 서버 개발, 원격 작업, 배포, 로그 확인, 데이터 처리처럼 터미널 기반 작업이 많은 환경에서 자주 사용됩니다.
일반 터미널과 tmux의 차이
일반 터미널은 기본적으로 하나의 창에서 하나의 작업 흐름을 처리하는 방식에 가깝습니다. 여러 작업을 동시에 보려면 터미널 창을 여러 개 열거나 탭을 계속 전환해야 합니다.
tmux는 이와 다르게 하나의 터미널 안에서 여러 작업 공간을 만들 수 있습니다. 화면을 좌우 또는 위아래로 나눠 개발 서버, 로그, 테스트 명령어를 동시에 확인할 수 있고, 작업별로 창을 나눠 관리할 수도 있습니다. 하나의 세션 안에서 화면을 분할해 여러 명령어를 동시에 실행할 수 있습니다.
AI 코딩 시대, 왜 tmux가 필요할까?

AI 에이전트 환경에 가장 적합한 터미널 환경 지원
tmux를 사용하면 하나의 터미널 안에서 여러 AI 에이전트를 동시에 실행할 수 있습니다. 이전에는 개발자가 일일이 코드를 입력하고 감독해야 했지만, AI 에이전트 시대가 되며 동시다발적으로 여러 개의 작업을 진행할 수 있습니다.
tmux는 개발자의 원활한 병렬 작업을 위해 화면 분할(pane)과 독립적인 작업 단위(window)를 지원합니다. 한쪽 pane에서는 Claude Code가 새 기능을 구현하고, 다른 pane에서는 Gemini CLI가 코드를 리팩토링하는 방식으로 여러 작업을 동시에 처리할 수 있습니다.
Claude Code 문서에서도 Ai 에이전트 병렬 작업을 위해 tmux 사용을 권장할 정도로 tmux를 사용할 경우 같은 시간 안에 처리할 수 있는 작업량이 늘어나 생산성과 작업 속도를 동시에 높일 수 있습니다.
작업이 끊기지 않는 안정적인 터미널 환경
tmux를 사용하면 터미널 접속이 끊겨도 작업이 중단되지 않습니다.
일반 터미널에서는 SSH 연결이 끊기는 순간 실행 중이던 작업도 함께 종료됩니다. 반면 tmux는 작업을 세션 안에 담아두기 때문에 접속이 끊겨도 세션은 서버에서 계속 살아있습니다.
덕분에 AI 모델 학습, 데이터 처리, 장시간 배포 작업처럼 네트워크 상태와 무관하게 끝까지 돌아가야 하는 작업을 안심하고 실행할 수 있습니다.
tmux 기본 개념 이해하기

tmux는 하나의 터미널 안에서 여러 작업을 Session, Window, Pane 단위로 나누어 관리합니다. 이 세 가지 개념만 이해하면 tmux 명령어도 훨씬 쉽게 익힐 수 있습니다.
Session: 작업을 유지하는 가장 큰 단위
Session은 tmux에서 가장 큰 작업 단위입니다. 하나의 프로젝트나 작업 흐름을 담아두는 독립적인 작업 공간으로, AI 챗봇 프로젝트라면 chatbot, 웹 서비스 개발이라면 web-project처럼 이름을 정해 만들 수 있습니다.
핵심은 이 세션이 현재 터미널 연결과 분리되어 유지된다는 점입니다. 터미널 창을 닫거나 SSH 연결이 끊겨도 세션 안의 작업은 계속 유지됩니다.
Window: 세션 안에서 나누는 작업 탭
Window는 하나의 Session 안에 만드는 작업 탭입니다. 브라우저에서 여러 탭을 열어두는 것처럼, 하나의 세션 안에 여러 개의 window를 만들 수 있습니다. 개발 서버는 server window에서 실행하고, 테스트는 test window에서 실행하고, Git 명령어는 git window에서 처리하는 방식으로 작업 목적별로 터미널을 분리할 수 있습니다.
Pane: 하나의 화면을 나누는 분할 영역
Pane은 하나의 Window 안에서 화면을 나눈 영역입니다. 하나의 터미널 화면을 좌우 또는 위아래로 나누어 여러 작업을 동시에 볼 수 있습니다.
한쪽에서는 개발 서버를 실행하고, 다른 쪽에서는 로그를 확인하고, 또 다른 영역에서는 테스트 명령어를 실행하는 구성이 가능합니다.
tmux의 전체 구조를 정리하면 다음과 같습니다.

tmux 기본 사용법

tmux 설치 방법
tmux는 대부분의 운영체제에서 패키지 매니저 명령어 한 줄이면 설치가 끝납니다. 2026년 5월 9일 기준 현재 최신 안정 버전은 3.6a입니다.
macOS에서 설치하는 방법
Homebrew가 설치되어 있다면 아래 명령어 하나로 설치됩니다.
| brew install tmux |
Homebrew가 없다면 공식 사이트(https://brew.sh)에서 먼저 설치합니다.
Linux에서 설치하는 방법
Ubuntu/Debian 계열은 다음 명령어를 사용합니다.
| sudo apt update && sudo apt install tmux |
Fedora, RHEL/CentOS, Arch Linux는 각각 아래 명령어를 사용합니다.
# Fedora
| sudo dnf install tmux |
# RHEL / CentOS
| sudo yum install tmux |
# Arch Linux
sudo pacman -S tmux |
Windows에서 설치하는 방법
Windows에서 tmux를 사용하려면 WSL2(Windows Subsystem for Linux)를 통해 설치하는 방식이 가장 표준적입니다. WSL2를 사용하기 위해 WSL을 설치합니다.
# PowerShell (관리자 권한)
| wsl --install |
# WSL 내부에서
sudo apt update sudo apt install tmux |
위의 명령어를 입력하면 비밀번호 입력창이 나옵니다. 비밀번호를 입력하면 설치가 진행됩니다.

설치가 완료되면 tmux를 입력해 실행합니다(소문자로 입력해야 실행이 됩니다. 대문자로 입력시 실행되지 않습니다). 화면 하단에 초록색 상태바가 나타나면 정상적으로 실행된 것입니다.
Session 만들기
Session은 tmux에서 작업을 담아두는 독립적인 공간입니다. AI 코딩 작업으로 여러 프로젝트를 동시에 진행하거나 세션을 나눠 관리할 때 작업 맥락을 유지한 채 빠르게 전환할 수 있습니다.
| tmux new -s 세션이름 (ex. tmux new -s ai-project) |
위의 명령어를 입력하면 이름이 있는 세션이 만들어집니다. 예를 들어 AI 프로젝트용 세션을 만들고 싶다면 다음과 같이 입력합니다.
화면 분할 하기
# 좌우 분할 Ctrl + b 누른 뒤 %

# 위아래 분할 Ctrl + b 누른 뒤 "

tmux에서 가장 자주 쓰는 기능입니다. 하나의 화면을 좌우 또는 위아래로 나눌 수 있습니다.
pane 간 이동
Ctrl + b 누른 뒤 방향키

분할된 pane 사이를 이동할 때는 위의 단축키를 사용합니다.
분할 선 이동
Ctrl + b 누른 뒤 Alt + 방향키

화면 간격 조정을 위해 분할선을 이용할 때 위의 단축키를 사용합니다.
Detach / Attach
| Ctrl + b 누른 뒤 d |
# 세션에서 빠져나오기
| tmux ls |
# 세션 목록 확인
| tmux attach -t ai-project |
# 세션으로 다시 들어가기
세션에서 빠져나올 때는 Detach를 사용합니다. 세션이 종료되는 것이 아니라 작업을 유지한 채 빠져나오는 것입니다.
Session 종료
| tmux kill-session -t ai-project |
더 이상 필요 없는 세션은 위의 명령어로 완전히 종료합니다.
* Detach는 세션을 유지한 채 빠져나오는 것이고, kill은 세션을 완전히 삭제하는 것입니다. 작업 중인 세션을 실수로 종료하지 않도록 주의합니다.
tmux 주요 단축키, 한 눈에 확인하세요.
tmux의 모든 단축키는 Ctrl + b를 먼저 누른 뒤 입력합니다.
세션
단축키 | 기능 |
Ctrl + b, d | 세션에서 빠져나오기 (Detach) |
Ctrl + b, $ | 세션 이름 변경 |
Ctrl + b, s | 세션 목록 보기 |
Window
단축키 | 기능 |
Ctrl + b, c | 새 window 만들기 |
Ctrl + b, 숫자 | 해당 번호 window로 이동 |
Ctrl + b, & | 현재 window 닫기 |
Ctrl + b, , | window 이름 변경 |
Pane
단축키 | 기능 |
Ctrl + b, % | 좌우 분할 |
Ctrl + b, " | 위아래 분할 |
Ctrl + b, 방향키 | pane 간 이동 |
Ctrl + b, Alt + 방향키 | pane 크기 조절 |
Ctrl + b, x | 현재 pane 닫기 |
Ctrl + b, z | 현재 pane 전체화면 전환 |
tmux에서 마우스 모드 활성화하는 방법
tmux는 기본적으로 마우스 조작이 비활성화되어 있습니다. 아래 방법으로 설정하면 마우스로 pane을 클릭하거나 크기를 조절할 수 있습니다.
| nano ~/.tmux.conf |
위의 명령어를 입력해 설정 파일을 열거나 새로 만듭니다.

| set -g mouse on |
설정 화면이 열리면 파일 안에 위의 명령어를 입력한 뒤 Ctrl + O를 누르고 저장한 뒤 Ctrl + X를 눌러 화면을 닫습니다.

명령어를 집적 입력하기 위해 Ctrl + b 누른 뒤 :을 누르면 하단에 노란색으로 명령어가 입력된 화면이 나옵니다.

source-file ~/.tmux.conf
위의 명령어를 입력하고 Enter를 누릅니다. 적용이 완료되면 마우스로 pane을 클릭해 이동하거나 경계선을 드래그해 크기를 조절할 수 있습니다.
tmux에서 Claude Code 실행하기
AI CLI를 활용한 에이전트 실행을 위해 tmux에서 Claude Code를 사용하는 방법을 정리했습니다.
tumx를 활용하면 여러 개의 화면에서 각각의 작업을 실행할 수 있어 작업 생산성을 높일 수 있습니다. Claude Code를 실행하기 위해 cluade 명령어를 입력합니다.

Claude Code의 모드를 선택하는 화면이 나옵니다. 기호에 맞게 선택합니다.

Claude Code에서 로그인 방법을 선택하는 화면이 나옵니다.
1. Claude account with subscription
별도의 API 키 없이 기존 계정으로 바로 로그인할 수 있습니다. Pro 이상의 플랜에서 선택할 수 있습니다.
2. Anthropic Console account
API 크레딧 기반으로 사용하는 방식입니다. console.anthropic.com에서 API 키를 발급받아 연동합니다.
구독 플랜이 있다면 1번을 선택하는 것이 가장 간단합니다. Enter를 누르면 브라우저 로그인 화면으로 이동합니다.

1번을 선택하면 터미널에 URL이 표시됩니다. 해당 URL을 복사해 브라우저에 붙여넣고 Claude 계정으로 로그인하면 인증 코드가 발급됩니다. 이 코드를 터미널의 입력창에 붙여넣으면 계정 연동이 완료됩니다.

로그인이 되면 현재 작업 폴더를 신뢰할 수 있는지 묻는 보안 확인 화면이 나옵니다. 1번 Yes, I trust this folder가 선택된 상태에서 Enter를 눌러 Claude Code가 시작합니다.

tmux의 각 pane에서 Claude Code를 실행하면 한 화면 안에서 여러 작업창을 동시에 띄울 수 있습니다.

각 pane이 독립적으로 동작하기 때문에 한쪽에서는 코드를 작성하고 다른 쪽에서는 오류를 수정하는 등 여러 작업을 동시에 진행할 수 있어 개발 속도를 크게 높일 수 있습니다.
tmux 사용 시 주의사항 4가지

전원 종료 및 재부팅 시 세션이 초기화됩니다
tmux는 터미널을 닫아도 세션이 유지되지만, 컴퓨터 전원이 꺼지거나 재부팅되면 실행 중이던 모든 세션과 작업 내역이 사라집니다.
이를 방지하려면 tmux-resurrect 같은 플러그인을 설치해 세션을 자동 복원할 수 있도록 설정하는 것이 좋습니다.
기본 히스토리 줄 수가 짧습니다
tmux의 기본 히스토리 한도는 2,000줄로 설정되어 있습니다. 개발 서버를 오래 켜두거나 긴 로그가 쌓이면 이전 기록이 잘려나갈 수 있습니다.
.tmux.conf 설정 파일에서 히스토리 한도를 50,000줄 정도로 늘려두는 것을 권장합니다.
마우스 조작이 기본적으로 비활성화되어 있습니다
tmux를 처음 설치하면 마우스로 pane을 클릭하거나 크기를 조절하는 기능이 꺼져 있습니다.
키보드 단축키가 불편하다면 설정에서 mouse on 옵션을 활성화해 사용하는 것이 편리합니다.
Windows에서는 직접 설치가 불가능합니다
tmux는 macOS와 Linux 기반 도구로 Windows 환경에서는 직접 설치가 되지 않습니다. Windows 사용자는 WSL(Windows Subsystem for Linux)을 먼저 설치한 뒤 그 안에서 tmux를 설치하고 사용해야 합니다.
AI 에이전트 생산성을 배로 높이는 콘텐츠 3가지
Codex Goal 사용법, 목표만 설정하면 끝까지 간다