cmux Cloud
cmux Cloud 為你提供雲端上的持久 Linux 機器,並以一般 cmux 工作區的形式開啟。關閉窗格、網路中斷或闔上筆電時,終端機都會繼續執行,因此程式設計代理可以持續工作,你也能從任何已登入的 Mac 重新連線。
什麼是機器
機器是一台屬於你或你團隊的持久雲端電腦。它會保留檔案、已安裝的工具和執行中的終端機。請把它當成長期使用的機器,而不是用完即丟的資源:需要的工具只要安裝一次,之後隨時回來繼續使用。
每台機器都會執行 cmux TUI 常駐程式。常駐程式保存機器上的工作區和終端機。Mac 上的 cmux 窗格只是顯示位於機器上的終端機,因此關閉窗格絕不會停止程序。
一台機器可以容納多個工作區。常見的做法是在一台長期保留的機器上為每個任務使用一個工作區,而不是為每個任務建立一台新機器。
每台機器都會取得一個自動產生的名稱,例如 brave-otter。這個名稱就是它在應用程式和 CLI 中的 ID。你可以加上顯示標籤,但 ID 不會改變。
你需要準備什麼
- 已執行並登入的 cmux macOS 應用程式。cmux CLI 會與應用程式通訊,你的憑證由應用程式保存。
- cmux 付費方案。免費帳號無法建立機器。目前的方案請參閱定價頁面。 cmux.com/pricing
- 已在 Settings › Beta Features 中啟用 Cloud Machines,且組織原則未停用 Cloud。
- 不需要設定 VPN、SSH 金鑰或連接埠轉送。cmux 會透過自動啟動的私人網路連線到你的機器。
快速入門
- 登入。使用右側邊欄的 Cloud 分頁,或在終端機中執行登入指令。
- 透過 File › New Cloud Machine 或 ⇧⌘Y 建立機器。選擇規格和選用的標籤。建立過程會在背景進行,機器就緒時 cmux 會顯示通知。
- 使用 ⌘Y(New Cloud Workspace)在機器上開啟工作區。在 Cloud 工作區中,按 ⌘N 一律會在這台 Mac 上建立本機工作區。
- 執行代理。機器上已預先安裝 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"