# hivemux 제거 방법

hivemux uninstall 로 hivemux 를 지우는 방법입니다. 지워지는 tmux·Ghostty·zsh 설정 블록과 Claude Code 훅, 남는 백업 파일, Homebrew 설치본과 git 설치본을 완전히 지우는 방법까지 정리했습니다.

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

hivemux 를 지우려면 `hivemux uninstall` 을 실행합니다. `~/.tmux.conf`, Ghostty 설정, `~/.zshrc` 에서 hivemux 블록을 지우고, Claude Code 설정에서 hivemux 훅을 지우고, 사이드바를 닫습니다. 직접 쓴 설정은 그대로 두며, 저장된 배치와 백업은 `~/.local/share/hivemux` 에 남습니다.

## 설정 제거

```sh
hivemux uninstall
```

이 명령은 다음 일을 합니다.

- `~/.tmux.conf`, `~/.config/ghostty/config`, `~/.zshrc` 에서 `# >>> hivemux >>>` 와 `# <<< hivemux <<<` 사이의 블록을 지웁니다.
- `~/.claude/settings.json` 에서 hivemux 훅만 지우고 다른 훅은 그대로 둡니다.
- hivemux setup 이 켠 경우 Claude Code 설정의 `remoteControlAtStartup` 을 지웁니다.
- 실행 중인 tmux 의 사이드바를 닫습니다. 남은 키 설정은 tmux 를 다시 시작하면 사라집니다.

tmux 세션과 Claude Code 대화는 계속 실행됩니다. `hivemux uninstall` 은 다시 실행해도 안전합니다.

## 남는 파일

`~/.local/share/hivemux` 에는 저장된 배치, tmux 플러그인, 설정 백업이 남습니다. 설치 때 바꾼 파일의 원본은 백업 폴더에 시각과 함께 들어 있습니다.

```sh
ls -la ~/.local/share/hivemux/backups/
```

## 프로그램 삭제

`hivemux uninstall` 을 실행한 뒤, 설치한 방식에 맞춰 프로그램을 지웁니다.

Homebrew 로 설치했다면:

```sh
brew uninstall hivemux
```

설치 스크립트로 설치했다면 소스가 `~/.local/share/hivemux/src` 에 있습니다. 데이터 폴더를 지우면 소스와 함께 저장된 배치, 플러그인, 백업도 지워집니다.

```sh
rm -rf ~/.local/share/hivemux
```

:::caution
설정 백업이 더 필요 없을 때만 `~/.local/share/hivemux` 를 지우세요.
:::

## 다시 설치

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

자세한 내용은 [설치](/ko/docs/install/)에 있습니다.