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

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

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 세션 여러 개 동시에 쓰기에서 자세히 설명합니다.

요구 사항

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

한 줄 설치

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

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

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

자세한 내용은 설치 페이지에 있고, 설치한 뒤에는 빠른 시작을 따라 하면 됩니다.

개인정보와 네트워크

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

라이선스

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