[Tmux 시리즈 2편] 설치하고 첫 세션 만들기

Tmux를 설치하고 첫 세션을 만들어보겠습니다. 세션 생성부터 Detach, 재접속까지 기본 흐름을 익힙니다.

이 글에서 할 것

• Homebrew로 Tmux 설치하기
• 첫 세션 만들고 Detach핵 보기
• 세션에 다시 접속핵 보기

시작하기 전에 확인할 것

필요한 것:

• iTerm2
• Homebrew가 설치되어 있어야 함

소요 시간: 약 10분

이전 가이드: Tmux 시리즈 1편: Tmux가 뭔가요?

Step 1: Tmux 설치

Homebrew로 설치

iTerm2를 열고 입력:

brew install tmux

예상 출력:

==> Downloading https://ghcr.io/v2/homebrew/core/tmux/...
==> Installing tmux
🍺  /opt/homebrew/Cellar/tmux/3.5: 12 files, 1.2MB

설치 확인

tmux -V

예상 출력:

tmux 3.5

Step 2: 첫 세션 만들기

세션 생성

tmux new -s mysession

화면 변화:

• 아래에 초록색 상태 표시줄이 생김
• [mysession] 표시가 보임

예상 화면:

┌─────────────────────────────────────────────────────────────┐
│ username@macbook ~ %                                        │
│ $ echo "Hello Tmux!"                                        │
│ Hello Tmux!                                                 │
│ $                                                           │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│ [mysession] 0:bash*                        username %       │
└─────────────────────────────────────────────────────────────┘
         ↑ 상태 표시줄 (초록색)

작업핵 보기

세션 안에서 자유롭게 명령어를 입력핵 보세요:

echo "Hello Tmux!"
date
ls -la

Step 3: 세션에서 나가기 (Detach)

Detach 하기

1. Ctrl+b 누르기 (동시에)
2. d 누르기

예상 출력:

[detached (from session mysession)]

💡 Detach란? 세션에서 나가지만, 작업은 그대로 유지됩니다. 마치 게임의 "일시정지" 같은 개념입니다.

Step 4: 세션 관리

세션 목록 보기

tmux ls

예상 출력:

mysession: 1 windows (created Fri Mar 13 10:30:00 2026) [80x24]

세션에 다시 접속

tmux attach -t mysession

예상 화면:

┌─────────────────────────────────────────────────────────────┐
│ username@macbook ~ %                                        │
│ $ echo "Hello Tmux!"                                        │
│ Hello Tmux!              ← 이전 작업 그대로!               │
│ $ date                                                      │
│ Fri Mar 13 10:30:00 KST 2026                                │
│ $                                                           │
├─────────────────────────────────────────────────────────────┤
│ [mysession] 0:bash*                        username %       │
└─────────────────────────────────────────────────────────────┘

이전에 입력했던 명령어와 출력이 그대로 남아 있습니다.

세션 완전 종료

세션 안에서:

exit

또는 외부에서:

tmux kill-session -t mysession

설치가 잘 되었는지 확인

Tmux 동작 테스트:

# 1. 세션 생성
tmux new -s test

# 2. 세션 안에서 간단한 명령어 실행
echo "Tmux is working!"

# 3. Detach (Ctrl+b, d)

# 4. 세션 목록 확인
tmux ls

# 5. 세션 재접속
tmux attach -t test

# 6. 세션 종료 (exit)

정상 출력 예시:

# tmux ls 결과
test: 1 windows (created ...)

# exit 후
[exited]

핵심 단축키 정리:

단축키	설명
Ctrl+b d	세션에서 분리 (Detach)
tmux ls	세션 목록 보기
tmux attach -t 이름	세션 접속
exit 또는 Ctrl+d	세션 종료

자주 생기는 실수

실수 1: "command not found: tmux"

해결:

# Homebrew 경로 확인
which tmux

# 없으면 설치
brew install tmux

# 또는 터미널 재시작

실수 2: 세션 이름을 모르겠어요

해결:

tmux ls

실수 3: 세션이 안 죽어요

해결:

# 강제 종료
tmux kill-session -t 세션이름

# 모든 세션 종료
tmux kill-server

실수 4: Detach 단축키가 안 먹어요

주의: Ctrl+b를 누르고 바로 d를 눌러야 합니다. 너무 오래 누르고 있으면 안 됩니다.

올바른 방법:

1. Ctrl+b 누르고 떼기
2. d 누르고 떼기

실수 5: 세션 이름에 공백을 넣었어요

잘못된 예:

tmux new -s my session  # 오류!

올바른 예:

tmux new -s mysession
tmux new -s my-session
tmux new -s my_session

여기까지 했으면 성공

완료 기준:

• tmux 설치 완료 (tmux -V 확인)
• 새 세션 생성 (tmux new -s 이름)
• Detach 핵 보기 (Ctrl+b d)
• 세션 목록 확인 (tmux ls)
• 세션 재접속 (tmux attach -t 이름)
• 세션 종료 (exit)

실습 과정 요약:

# 설치
brew install tmux

# 세션 생성
tmux new -s myproject

# 작업 수행
echo "Hello"

# Detach (Ctrl+b, d)

# 세션 목록
tmux ls

# 재접속
tmux attach -t myproject

# 종료
exit

추천 다음 단계:

1. 여러 개의 세션을 만들어 보기
2. 세션 이름을 프로젝트명으로 짓기 (예: website, study, server)
3. 세션 간 전환 (Ctrl+b s) 사용핵 보기

다음 편 안내

Tmux 설치와 기본 세션 관리를 익히셨다면, 이제 윈도우와 패널을 배워봅시다.

Tmux 시리즈 3편: 세션과 윈도우 관리에서는 하나의 세션 안에서 여러 윈도우를 만들고, 패널로 화면을 분할하는 방법을 실습합니다.