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

hivemux 를 처음 쓰는 순서입니다. hm 으로 프로젝트를 열고, prefix Shift+C 로 Claude 를 추가하고, Option+0 으로 기다리는 세션에 가고, 사이드바 카드를 읽고, 재부팅 뒤 세션을 되찾는 방법을 다룹니다.

Source: https://hivemux.dev/ko/docs/quick-start/

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

## 시작 전 준비

먼저 hivemux 를 설치합니다. [설치](/ko/docs/install/) 페이지를 참고하세요. 아래 예시는 `~/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 는 언제 닫아도 됩니다.** 다시 열면 보던 곳으로 돌아옵니다.

```sh
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` 다음 창 번호로 창을 바꿉니다. 전체 키는 [단축키](/ko/docs/keys/) 페이지에 있습니다.

## 사이드바 읽는 법

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

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

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

## 작업 이름 붙이기

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

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

```sh
claude -n login-bug
```

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

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

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

## 하루를 마칠 때

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

## 다음 단계

- [단축키](/ko/docs/keys/): 모든 키와 마우스 동작
- [벌 사무실](/ko/docs/bee-office/): 세션마다 벌 한 마리가 일하는 사무실 창
- [다른 Mac 에서 이어서 작업](/ko/docs/another-mac/): 노트북에서 ssh 로 이어서 작업
- [Claude Code 알림](/ko/guides/claude-code-notifications/): 입력 대기·완료 알림이 오는 방식