雲端機器

本頁說明 cmux Cloud 機器的生命週期：如何建立、可選擇哪些規格、方案限制如何套用，以及如何暫停、建立快照、分叉和刪除機器。

建立機器

在應用程式中，使用 File › New Cloud Machine（⇧⌘Y）、加號按鈕選單、指令面板，或 Cloud 側邊欄中的加號按鈕。出現的面板會要求你選擇規格並填寫選用的標籤。

在 CLI 中，cmux vm new 會建立機器並在其上開啟工作區。使用 --detach 可只建立而不開啟任何內容。如果建立要求被重試，cmux 會沿用同一個要求，因此不會產生兩台機器。

cmux vm new
cmux vm new --size 16g --name "search index"
cmux vm new --detach --json

如果建立失敗，你可以從通知中重試、顯示錯誤，或拷貝錯誤以提交支援要求。

規格

每種規格會同時決定記憶體、vCPU 和磁碟。可以在建立面板中或透過 --size 選擇規格。 Pro 和 Team 支援 4g、8g 和 16g（2、4 和 8 vCPU）。Max 也會解鎖 24g 和 32g（12 和 16 vCPU），以及 64g（32 vCPU）。

如果不選擇規格，新機器會使用 8 GB 記憶體。執行 cmux vm ls --json 可查看你的方案允許的規格。

方案限制

你的使用中機器共用同一個 vCPU 和記憶體資源池。你可以執行一台大機器，也可以執行幾台小機器。已暫停的機器不會占用資源池。磁碟按每台機器個別設定，不計入資源池。

• 免費帳號無法建立機器。
• Pro 和 Founder's Edition 帳號最多可擁有 5 台使用中的機器，共用 20 個 vCPU 和 40 GB 記憶體。正在執行或正在啟動的機器即為使用中的機器。
• Team 帳號每個付費席位最多可擁有 5 台使用中的機器。每個付費席位會為團隊資源池增加 20 個 vCPU 和 40 GB 記憶體。
• Max 帳號最多可擁有 5 台使用中的機器，共用 80 個 vCPU 和 160 GB 記憶體。單台 Max 機器最多可使用 64 GB 和 32 個 vCPU，包含 24 GB / 12 vCPU 與 32 GB / 16 vCPU 規格；Pro 和 Team 的上限為 16 GB 和 8 個 vCPU。
• 如果新建、恢復、擴充或分叉的機器會超出資源池，cmux 會拒絕該請求，並顯示資源池的已用量。暫停或刪除一台機器以釋出資源，或升級到 Max。
• A machine larger than your plan allows is locked. You can list and delete it, but you cannot open it, run commands on it, resume it, or resize it until you upgrade.

目前的價格請參閱定價頁面。不依用量計費，也沒有超額費用。

讓程式碼代理保持最新

開啟此設定後，機器會更新 Claude Code、Codex、OpenCode、pi 和 agent-browser。機器建立後以及每次連線時都會檢查，每 24 小時最多一次。更新在背景獨立執行，因此不會阻擋連線。

每個工具都來自其官方 GitHub 版本，並以發布資產的 sha256 摘要進行驗證。不使用 npm。版本發布滿 3 天後才會安裝，更新絕不會安裝較舊的版本。執行中的代理會繼續使用啟動時的檔案，更新失敗時目前版本保持不變。

上次檢查的結果在 /etc/cmux/agent-updates.state 中，更新程式的記錄在 /var/log/cmux-agent-updates.log 中。失敗的檢查會在下次連線時重新執行。

cat /etc/cmux/agent-updates.state
tail /var/log/cmux-agent-updates.log

「新增機器」面板預設開啟此設定。若要為現有機器變更，請在機器上按右鍵並選擇「讓代理保持最新」，或執行 cmux vm agent-updates。除非傳入 --agent-updates latest，否則 cmux vm new 會保留映像檔中的版本。關閉更新後，已安裝的版本會保留。

cmux vm new --agent-updates latest
cmux vm agent-updates brave-otter
cmux vm agent-updates brave-otter image

更新只使用 github.com, api.github.com, objects.githubusercontent.com 和 release-assets.githubusercontent.com。cmux 在所有網路模式下都允許這些主機，包括「允許清單」和「不連網」，因此網路政策不會阻擋更新。

調整規格

你可以在不遺失資料的情況下擴大機器。在機器上按右鍵並選擇 Resize machine，或使用 cmux vm resize。調整規格只能擴大機器。磁碟以 4 GB 為單位，在 Pro 和 Team 中最多擴充到 128 GB，在 Max 中最多擴充到 256 GB（Go 限制為 16 GB）。在 Pro 和 Team 中，記憶體最多 16 GB，CPU 最多 8 vCPU；在 Max 中，記憶體最多 64 GB，CPU 最多 32 vCPU。機器越大，占用的資源池越多。實際上限由你的方案決定。

cmux vm resize brave-otter --memory 16G
cmux vm resize brave-otter --cpu 8 --disk 128G

暫停與繼續

cmux vm pause 會停止機器的運算資源。磁碟、工作區和終端機歷史記錄會保留，執行中的程序則會停止。cmux vm resume 會再次啟動機器。開啟已暫停的機器或在其上執行指令也會啟動它。

機器閒置時不會自動暫停。機器會持續執行，直到你暫停或刪除它。

cmux vm pause brave-otter
cmux vm resume brave-otter
cmux vm wait brave-otter --wake --timeout 180

cmux vm wait 會等待機器就緒。加上 --wake 可先啟動已暫停的機器。這在腳本執行第一個指令之前很實用。

檢查點、分叉與還原

檢查點會儲存機器的磁碟。分叉會以某台機器目前的狀態建立一台新機器。還原會以檢查點建立一台新機器。檢查點包含機器的環境變數檔案。

在進行有風險的變更之前先建立檢查點；想從同一個起點平行嘗試兩種做法時，請使用分叉。

cmux vm checkpoint brave-otter --name before-migration
cmux vm snapshot ls brave-otter
cmux vm restore <snapshot-id>
cmux vm fork brave-otter --name try-b
cmux vm snapshot rm brave-otter <snapshot-id>

只有在機器的供應商支援時，才會顯示 Checkpoint 和 Fork。如果指令被拒絕，表示該機器不支援此操作。

重新命名

cmux vm rename 會設定顯示標籤，最多 64 個可列印字元。自動產生的名稱仍是機器的 ID。使用 --clear 可移除標籤。

cmux vm rename brave-otter "billing api"
cmux vm rename brave-otter --clear

狀態與統計

cmux vm status 會顯示機器的狀態、規格和位址。cmux vm stats 會顯示 CPU、記憶體和磁碟使用量，且不會喚醒已暫停的機器。

cmux vm status brave-otter
cmux vm stats brave-otter

刪除

刪除機器會永久刪除該機器及其磁碟上的所有內容，也會移除該機器的公開 URL 並撤銷其模型存取權。刪除後無法復原。

如果之後可能還需要這些檔案，請先建立檢查點。

cmux vm rm brave-otter

方案結束後

如果你的付費方案結束，建立超過 7 天的機器會被鎖定。你仍然可以列出、重新命名和刪除這些機器，但無法開啟、執行指令、轉送連接埠或繼續執行它們。機器及其檔案會保留。重新升級即可重新連線。Cloud 側邊欄會顯示 Locked 以及 Upgrade to Reconnect 選單項目。