# cmux Cloud

cmux Cloud 為你提供雲端上的持久 Linux 機器，並以一般 cmux 工作區的形式開啟。關閉窗格、網路中斷或闔上筆電時，終端機都會繼續執行，因此程式設計代理可以持續工作，你也能從任何已登入的 Mac 重新連線。

cmux Cloud 目前為搶先體驗階段，除非你的組織將其停用，否則皆可使用。若要使用，請啟用 Settings › Beta Features › Cloud Machines。

## 什麼是機器

機器是一台屬於你或你團隊的持久雲端電腦。它會保留檔案、已安裝的工具和執行中的終端機。請把它當成長期使用的機器，而不是用完即丟的資源：需要的工具只要安裝一次，之後隨時回來繼續使用。

每台機器都會執行 cmux TUI 常駐程式。常駐程式保存機器上的工作區和終端機。Mac 上的 cmux 窗格只是顯示位於機器上的終端機，因此關閉窗格絕不會停止程序。

一台機器可以容納多個工作區。常見的做法是在一台長期保留的機器上為每個任務使用一個工作區，而不是為每個任務建立一台新機器。

每台機器都會取得一個自動產生的名稱，例如 brave-otter。這個名稱就是它在應用程式和 CLI 中的 ID。你可以加上顯示標籤，但 ID 不會改變。

## 你需要準備什麼

-   已執行並登入的 cmux macOS 應用程式。cmux CLI 會與應用程式通訊，你的憑證由應用程式保存。
-   cmux 付費方案。免費帳號無法建立機器。目前的方案請參閱定價頁面。 [cmux.com/pricing](https://cmux.com/zh-TW/pricing)
-   已在 Settings › Beta Features 中啟用 Cloud Machines，且組織原則未停用 Cloud。
-   不需要設定 VPN、SSH 金鑰或連接埠轉送。cmux 會透過自動啟動的私人網路連線到你的機器。

## 快速入門

1.  登入。使用右側邊欄的 Cloud 分頁，或在終端機中執行登入指令。
2.  透過 File › New Cloud Machine 或 ⇧⌘Y 建立機器。選擇規格和選用的標籤。建立過程會在背景進行，機器就緒時 cmux 會顯示通知。
3.  使用 ⌘Y（New Cloud Workspace）在機器上開啟工作區。在 Cloud 工作區中，按 ⌘N 一律會在這台 Mac 上建立本機工作區。
4.  執行代理。機器上已預先安裝 Claude Code、Codex、OpenCode 和 Pi。

也可以透過 CLI 完成相同的操作：

```
cmux auth login
cmux vm new --size 8g --name "api work"
cmux vm ls
cmux vm open brave-otter
cmux vm agent --agent claude --machine brave-otter --sync -- "fix the failing tests"
```

## 在應用程式中使用 Cloud

右側邊欄的 Cloud 分頁會列出你的機器。每台機器下方會顯示其工作區、已轉送的連接埠、VNC 顯示器和終端機。點選項目即可開啟。你也可以在指令面板中使用 Open Cloud as Pane，將 Cloud 樹狀結構開啟為窗格。

在機器上按右鍵，即可開啟 shell、建立工作區、開啟桌面、開啟完整的 cmux TUI 用戶端、調整規格、重新命名、拷貝 IP 位址、查看狀態、建立檢查點、分叉或刪除機器。你也可以釘選機器並調整它們的順序。

New Cloud Machine（⇧⌘Y）和 New Cloud Workspace（⌘Y）位於 File 選單、加號按鈕選單和指令面板中。這兩個快捷鍵都可以在設定中變更，或在 cmux.json 中透過 newCloudMachine 和 newCloudWorkspace 鍵變更。

```
{
  "shortcuts": {
    "bindings": {
      "newCloudMachine": "cmd+shift+y",
      "newCloudWorkspace": "cmd+y"
    }
  }
}
```

## 透過 CLI 使用 Cloud

cmux vm 和 cmux cloud 是同一個指令。不帶子指令執行 cmux vm 會列出你的機器。每個子指令都有不需應用程式即可使用的 --help 頁面，cmux vm guide 會輸出完整的 Markdown 指南。為任何子指令加上 --json 即可取得機器可讀的輸出。

```
cmux vm              # list machines
cmux vm --help
cmux vm new --help
cmux vm guide        # full Markdown guide
cmux vm ls --json
```

## 你的基礎機器

每個帳號都有一台釘選的基礎機器。cmux vm base 會開啟它，並在第一次使用時建立它。cmux vm base reset 會建立一台新的基礎機器並保留舊機器，因此不會意外遺失檔案。

```
cmux vm base
cmux vm base reset --reason "start clean"
```

## 後續步驟

-   [機器：規格、方案、調整規格、暫停、快照和刪除。](https://cmux.com/zh-TW/docs/cloud/machines)
-   [工作區與代理：持久終端機、代理、通知以及預先安裝的內容。](https://cmux.com/zh-TW/docs/cloud/workspaces)
-   [檔案與網路：上傳檔案、環境變數、連接埠、桌面和公開 URL。](https://cmux.com/zh-TW/docs/cloud/networking)
-   [Cloud CLI 參考：所有 cmux vm 子指令。](https://cmux.com/zh-TW/docs/cloud/cli)
-   [安全性與疑難排解：存取機制以及常見錯誤的解決方法。](https://cmux.com/zh-TW/docs/cloud/troubleshooting)

Canonical: https://cmux.com/zh-TW/docs/cloud

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