# 入門指南

cmux 是一個基於 Ghostty 的輕量原生 macOS 終端機，用於管理多個 AI 程式碼代理。它具備垂直分頁、通知面板和基於 socket 的控制 API。

## 安裝

### DMG（推薦）

[下載 Mac 版](https://cmux.com/zh-TW/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）並執行**Shell 指令：將「cmux」安裝至 PATH**。它會把內建的 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:// 連結和 shell 腳本在 cmux 而非「終端機」中開啟，請在選單列選擇**cmux > 將 cmux 設為預設終端機**，或在指令面板中執行**將 cmux 設為預設終端機**。

## 自動更新

cmux 透過 Sparkle 自動檢查更新。當有可用更新時，你會在標題列看到一個更新提示。你也可以透過選單列的 cmux > 檢查更新手動檢查。

## 工作階段還原（目前行為）

重新啟動後，cmux 僅還原佈局和中繼資料：

cmux 尚不支援還原即時程序狀態。活躍的終端機應用程式工作階段（如 Claude Code、tmux 和 vim）在應用程式重啟後不會恢復。

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

## 系統需求

-   macOS 14.0 或更新版本
-   Apple Silicon 或 Intel Mac

Canonical: https://cmux.com/zh-TW/docs/getting-started

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