# hivemux 소개 - Claude Code 세션용 tmux 사이드바

hivemux 는 macOS 용 무료 오픈소스 tmux 사이드바입니다. 여러 Claude Code 세션의 실행 중·입력 대기·완료 상태를 한눈에 보여 주고, Option+0 으로 나를 기다리는 세션에 바로 이동하게 해 줍니다.

Source: https://hivemux.dev/ko/docs/

hivemux 는 모든 Claude Code 세션을 실행 중·입력 대기·완료 상태로 보여 주고, 나를 기다리는 세션으로 바로 이동하게 해 주는 tmux 사이드바입니다. macOS 에서 동작하는 무료 오픈소스(MIT)이며, `Option+0` 을 누르면 가장 오래 기다린 세션으로, `Option+1` ~ `Option+9` 를 누르면 그 번호의 세션으로 바로 갑니다.

[Image: api, docs, wayfinder, web 프로젝트 상자에 Claude Code 세션 카드가 나열되고, 입력 필요 카드 두 개가 Claude Code 수정 승인 화면 옆에 보이는 hivemux 사이드바]

## hivemux 가 하는 일

Claude Code 세션을 여러 개 동시에 돌리면 어느 세션이 내 승인을 기다리는지 찾기가 어렵습니다. hivemux 는 모든 tmux 창 왼쪽에 사이드바를 붙이고, 모든 tmux 세션의 Claude Code 세션을 프로젝트별로 묶어 보여 줍니다.

- **세션별 실시간 상태:** 카드마다 작업 이름(Claude 가 정한 대화 제목), 상태(작업 중, 입력 필요, 완료, 대기), 경과 시간이 나옵니다. 입력이 필요한 카드는 호박색으로 깜빡입니다.
- **바로 이동 키:** `Option+1` … `9` 는 다른 프로젝트에 있어도 그 Claude 로 이동합니다. `Option+0` 은 가장 오래 기다린 Claude, 없으면 아직 안 본 완료 작업으로 갑니다.
- **호출판:** 맨 위 상태줄 오른쪽에 입력이 필요한 작업(호박색)과 끝났지만 안 본 작업(초록)이 `Option` 번호 배지로 뜹니다. 배지를 누르면 그 작업으로 갑니다.
- **알림:** 작업이 입력을 기다리거나 끝나면 macOS 알림이 뜹니다. 지금 보고 있는 작업은 알리지 않습니다.
- **끊기지 않는 세션:** 터미널을 닫아도 tmux 가 세션을 살려 둡니다. 재부팅하면 tmux-resurrect 가 배치를 복원하고 hivemux 가 칸마다 `claude --resume <id>` 를 실행합니다.
- **프로젝트:** `hm ~/code/api` 로 폴더 하나에 tmux 세션 하나를 열고, 이름 붙인 Claude 창과 셸 창을 함께 만듭니다.
- **다른 Mac 에서 이어서 작업:** `hivemux connect` 로 노트북에서 다른 Mac 의 tmux 에 ssh 로 붙어 같은 사이드바, 알림, 개발 서버 포트를 그대로 씁니다.
- **벌 사무실:** Claude 세션마다 벌 한 마리가 일하는 사무실 창을 따로 띄울 수 있습니다. 일할 때는 타자를 치고, 입력이 필요하면 질문 창구로 뛰어갑니다.

## 사용 대상

Mac 에서 Claude Code 세션을 두 개 이상 동시에 쓰면서, 승인을 기다리는 세션을 찾으려고 터미널 탭을 하나씩 넘기고 싶지 않은 개발자를 위한 도구입니다. 이런 작업 방식은 [Claude Code 세션 여러 개 동시에 쓰기](/ko/guides/run-multiple-claude-code-sessions/)에서 자세히 설명합니다.

## 요구 사항

- macOS (Linux 도 동작할 가능성이 높지만 시험하지 않았습니다)
- tmux 3.3 이상, jq, git, python3 (Xcode Command Line Tools)
- 로그인된 [Claude Code](https://code.claude.com)
- [Ghostty](https://ghostty.org) 권장. 다른 터미널에서도 `tmux` 를 직접 실행하면 동작합니다.

## 한 줄 설치

```sh
curl -fsSL https://hivemux.dev/install.sh | bash
```

Homebrew 로 설치할 수도 있습니다.

```sh
brew install esteban-eg-kim/tap/hivemux
hivemux setup
```

자세한 내용은 [설치](/ko/docs/install/) 페이지에 있고, 설치한 뒤에는 [빠른 시작](/ko/docs/quick-start/)을 따라 하면 됩니다.

## 개인정보와 네트워크

hivemux 는 서버도 텔레메트리도 없습니다. Mac 안에서만 동작하며 Claude Code 훅 이벤트와 tmux 상태를 읽습니다. 네트워크 요청은 Claude 를 업데이트할 때 최신 Claude Code 버전을 확인하는 것(npm 레지스트리 또는 Homebrew API), GitHub 에서 hivemux 와 tmux 플러그인을 받거나 업데이트하는 것, 직접 연결하는 Mac 으로의 ssh·mosh 접속뿐입니다. 자세한 내용은 [동작 원리](/ko/docs/how-it-works/)에 있습니다.

## 라이선스

hivemux 는 MIT 라이선스입니다. 독립 프로젝트이며 Anthropic 과 관련이 없고 Anthropic 의 보증을 받지 않았습니다. "Claude" 와 "Claude Code" 는 Anthropic 의 상표입니다.