# 시작하기

cmux는 여러 AI 코딩 에이전트를 관리하기 위해 Ghostty 기반으로 구축된 경량 네이티브 macOS 터미널입니다. 세로 탭, 알림 패널, 소켓 기반 제어 API를 제공합니다.

## 설치

### DMG (권장)

[Mac용 다운로드](https://cmux.com/ko/download/confirmation?dl=1)

.dmg 파일을 열고 cmux를 응용 프로그램 폴더로 드래그하세요. cmux는 Sparkle을 통해 자동 업데이트되므로 한 번만 다운로드하면 됩니다.

### Homebrew

```
brew tap manaflow-ai/cmux
brew install --cask cmux
```

나중에 업데이트하려면:

```
brew upgrade --cask cmux
```

처음 실행할 때 macOS가 확인된 개발자의 앱을 열지 확인할 수 있습니다. **열기**를 클릭하여 진행하세요.

## 설치 확인

cmux를 열면 다음이 표시됩니다:

-   왼쪽에 세로 탭 사이드바가 있는 터미널 창
-   이미 열려 있는 하나의 초기 워크스페이스
-   입력 준비가 된 Ghostty 기반 터미널

## CLI 설정

cmux에는 자동화를 위한 커맨드라인 도구가 포함되어 있습니다. cmux 터미널 안에서는 자동으로 작동합니다. 다른 터미널에서 사용하려면 명령어 팔레트(⌘⇧P)를 열고 **셸 명령어: PATH에 'cmux' 설치**를 실행하세요. 번들된 CLI를 /usr/local/bin에 링크하며, 해당 폴더에 권한이 필요하면 관리자 암호를 묻습니다.

또는 심볼릭 링크를 직접 만드세요:

```
sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux
```

그러면 다음과 같은 명령을 실행할 수 있습니다:

```
cmux list-workspaces
cmux notify --title "Build Complete" --body "Your build finished"
```

## cmux를 기본 터미널로 설정

Finder에서 여는 ssh:// 링크와 셸 스크립트를 터미널 대신 cmux에서 열려면 메뉴 막대에서 **cmux > cmux를 기본 터미널로 설정**을 선택하거나, 명령어 팔레트에서 **cmux를 기본 터미널로 설정**을 실행하세요.

## 자동 업데이트

cmux는 Sparkle을 통해 자동으로 업데이트를 확인합니다. 업데이트가 있으면 타이틀바에 업데이트 알림이 표시됩니다. 메뉴 바에서 cmux > 업데이트 확인을 통해 수동으로 확인할 수도 있습니다.

## 세션 복원 (현재 동작)

재시작 후 cmux는 레이아웃과 메타데이터만 복원합니다:

cmux는 아직 라이브 프로세스 상태를 복원하지 않습니다. Claude Code, tmux, vim 등의 활성 터미널 앱 세션은 앱 재시작 후 복원되지 않습니다.

See the [session restore guide](https://cmux.com/ko/docs/session-restore) for agent hook setup and the supported resume matrix.

## 요구 사항

-   macOS 14.0 이상
-   Apple Silicon 또는 Intel Mac

Canonical: https://cmux.com/ko/docs/getting-started

Documentation index: https://cmux.com/llms.txt