콘텐츠로 이동
hivemux문서

hivemux 빠른 시작 - Claude Code 세션 관리

hivemux 를 설치했다면 Ghostty 를 열고 hm ~/code/api 로 프로젝트를 시작합니다. 1번 창에서 Claude 가 실행되고, 어느 세션이든 나를 기다리면 Option+0 으로 바로 갑니다. 같은 프로젝트에 Claude 를 하나 더 띄우려면 prefix 다음 Shift+C 를 누릅니다. 권장 키를 쓰면 prefix 는 Ctrl+A 입니다.

시작 전 준비

섹션 제목: “시작 전 준비”

먼저 hivemux 를 설치합니다. 설치 페이지를 참고하세요. 아래 예시는 ~/code/api 와 ~/code/web 두 폴더를 씁니다. 자기 폴더로 바꿔서 따라 하면 됩니다.

처음 쓰는 순서

섹션 제목: “처음 쓰는 순서”
  1. Ghostty 를 엽니다. 이미 tmux 안이고, 위쪽에 상태줄, 왼쪽에 사이드바가 있습니다.
  2. 프로젝트를 엽니다. hm ~/code/api 를 입력하면 api 프로젝트가 열리고 1번 창에서 Claude 가 실행됩니다.
  3. 두 번째 프로젝트를 엽니다. hm ~/code/web 을 입력합니다. 첫 번째 프로젝트는 뒤에서 계속 일합니다.
  4. 사이드바를 봅니다. Option+0 으로 기다리는 작업으로 갑니다.
  5. Claude 를 추가합니다. prefix 다음 Shift+C 로 지금 프로젝트에 이름 붙인 Claude 를 하나 더 띄웁니다.
  6. Ghostty 는 언제 닫아도 됩니다. 다시 열면 보던 곳으로 돌아옵니다.
터미널 창
hm ~/code/api
hm ~/code/web

프로젝트, 창, 칸의 관계

섹션 제목: “프로젝트, 창, 칸의 관계”

hivemux 는 tmux 개념을 작업 단위에 맞춰 씁니다.

  • 프로젝트 = tmux 세션: hm <폴더> 는 폴더 하나에 폴더 이름으로 세션 하나를 만들고, 이미 있으면 그 세션으로 이동합니다. 그 폴더 안에서는 hm 만 입력해도 됩니다.
  • 창 = 탭: 새 프로젝트에는 claude -n <이름> 으로 Claude 를 실행하는 1:claude 창과, git·개발 서버 같은 명령을 위한 2:shell 창이 생깁니다. 탭은 Ghostty 가 아니라 tmux 상태줄에 있습니다.
  • 사이드바: 모든 창 왼쪽에 같은 상태판이 붙고, 모든 프로젝트의 Claude 가 다 보입니다.

prefix s 는 세션 목록을 보여 주고, prefix 다음 창 번호로 창을 바꿉니다. 전체 키는 단축키 페이지에 있습니다.

사이드바 읽는 법

섹션 제목: “사이드바 읽는 법”

api 는 4분째 작업 중, docs 는 완료, wayfinder 는 대기, web 작업 두 개는 입력 필요로 표시된 hivemux 사이드바

카드 뜻 할 일
● 입력 필요 승인이나 답을 기다리는 중. 카드 전체가 호박색으로 깜빡이고, 시간은 기다린 시간 먼저 확인: Option+0
✓ 완료 응답을 끝냈고 아직 안 봄. 초록 선 결과 확인. 열어 보면 대기로 바뀜
◐ 작업 중 일하는 중. 빛 띠가 지나가고, 시간은 작업 시간 기다리기
○ 대기 다음 지시를 기다리는 중. 결과는 이미 봄 새 지시를 줄 때 이동

지금 보고 있는 작업은 카드 양옆에 흰 선이 생깁니다. 카드 오른쪽 위의 ⌥ 번호가 그 작업의 Option+숫자 키입니다.

작업 이름 붙이기

섹션 제목: “작업 이름 붙이기”

작업 이름은 Claude 입력창 위, /resume 목록, Claude 폰 앱, 터미널 제목에 보입니다. hm 은 폴더 이름을, prefix Shift+C 는 입력한 이름을 씁니다. 실행 중인 작업의 이름을 바꾸려면 카드를 더블클릭하거나 오른쪽 클릭 메뉴 → “이름 바꾸기”를 고릅니다. hivemux 가 그 Claude 에 /rename 을 보내고, Claude 가 일하는 중이면 끝날 때까지 기다렸다가 보냅니다.

tmux 칸에서 Claude 를 직접 실행할 때는 이름을 붙여 실행합니다.

터미널 창
claude -n login-bug

사이드바에서 새 프로젝트 열기

섹션 제목: “사이드바에서 새 프로젝트 열기”

사이드바 오른쪽 클릭 메뉴 → “새 프로젝트”를 고르면 폴더 탐색 창이 뜹니다. Enter 는 고른 폴더에서 시작하고(hm 과 같음), → / ← 는 폴더 안과 상위로 이동하며, 글자를 치면 걸러 보고, Ctrl+N 은 새 폴더를 만듭니다.

폴더 목록을 보여 주는 hivemux 새 프로젝트 폴더 탐색 창

하루를 마칠 때

섹션 제목: “하루를 마칠 때”

Ghostty 를 그냥 닫으면 됩니다. 실행 중인 Claude 는 tmux 안에서 계속 일합니다. 재부팅하면 tmux-resurrect 가 배치를 복원하고, hivemux 가 칸마다 claude --resume <id> 로 대화를 다시 엽니다. /exit 로 직접 끝낸 세션은 재개하지 않습니다. 자세한 내용은 Claude Code 세션 재개에 있습니다.

다음 단계

섹션 제목: “다음 단계”