クラウドマシン
このページでは、cmux Cloudマシンのライフサイクルを説明します。作成方法、選べるサイズ、プランの上限、一時停止、スナップショット、フォーク、削除について扱います。
マシンを作成する
アプリでは、ファイル › 新規クラウドマシン（⇧⌘Y）、プラスボタンのメニュー、コマンドパレット、またはクラウドサイドバーのプラスボタンを使います。表示されるシートでサイズと任意のラベルを指定します。
CLIでは、cmux vm new がマシンを作成し、そのマシン上でワークスペースを開きます。何も開かずに作成するには --detach を使います。作成リクエストが再試行された場合、cmuxは同じリクエストを再利用するため、マシンが2台できることはありません。
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）も利用できます。
| サイズ | メモリ | vCPU | ディスク | プラン |
|---|---|---|---|---|
4g | 4 GB | 2 | 16 GB | 有料プラン |
8g | 8 GB | 4 | 32 GB | 有料プラン |
16g | 16 GB | 8 | 64 GB | 有料プラン |
24g | 24 GB | 12 | 96 GB | Max |
32g | 32 GB | 16 | 128 GB | Max |
64g | 64 GB | 32 | 128 GB | Max |
サイズを選ばない場合、新しいマシンは8 GBのメモリを使います。プランで使えるサイズを確認するには cmux vm ls --json を実行します。
プランの上限
アクティブなマシンは、vCPUとメモリの1つのプールを共有します。大きなマシン1台でも、小さなマシン数台でも使えます。一時停止中のマシンはプールを使いません。ディスクはマシンごとに設定され、プールには含まれません。
- 無料アカウントではマシンを作成できません。
- ProおよびFounder's Editionアカウントでは、20 vCPUと40 GBのメモリを共有するアクティブなマシンを最大5台まで持てます。実行中または起動中のマシンがアクティブとして数えられます。
- Teamアカウントでは、有料シート1つにつきアクティブなマシンを最大5台まで持てます。有料シート1つごとに、チームのプールに20 vCPUと40 GBのメモリが追加されます。
- Maxアカウントでは、80 vCPUと160 GBのメモリを共有するアクティブなマシンを最大5台まで持てます。Maxの1台のマシンは最大64 GB、32 vCPUまで使え、24 GB / 12 vCPUと32 GB / 16 vCPUのサイズも含まれます。ProとTeamは16 GB、8 vCPUまでです。
- 新規作成、再開、サイズ変更、フォークでプールを超える場合、cmuxはリクエストを拒否し、プールの使用量を表示します。マシンを一時停止または削除してリソースを空けるか、Maxにアップグレードしてください。
- プランの上限より大きいマシンはロックされます。一覧表示と削除はできますが、アップグレードするまで開く、コマンドを実行する、再開する、サイズを変更することはできません。
現在の価格は料金ページを参照してください。従量課金や超過料金はありません。
コーディングエージェントを最新に保つ
この設定をオンにすると、マシンは Claude Code、Codex、OpenCode、pi、agent-browser を更新します。確認はマシンの作成後と接続のたびに行われ、24 時間に最大 1 回です。更新はバックグラウンドで切り離して実行されるため、接続を妨げることはありません。
各ツールは公式の 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 を実行します。cmux vm new は --agent-updates latest を指定しない限りイメージのバージョンを保持します。更新をオフにしても、インストール済みのバージョンはそのまま残ります。
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 は「許可リスト」や「インターネットなし」を含むすべてのネットワークモードでこれらのホストを許可するため、ネットワークポリシーが更新を妨げることはありません。
サイズ変更
データを失わずにマシンを大きくできます。マシンを右クリックして「マシンのサイズを変更」を選ぶか、cmux vm resize を使います。サイズ変更は拡大のみです。ディスクは4 GB単位で、ProとTeamでは最大128 GB、Maxでは256 GBまで拡大できます（Goは16 GBまで）。メモリとCPUは、ProとTeamでは最大16 GB、8 vCPU、Maxでは最大64 GB、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 180cmux vm wait はマシンの準備ができるまで待ちます。--wake を付けると、一時停止中のマシンを先に起動します。スクリプトで最初のコマンドを実行する前に便利です。
チェックポイント、フォーク、復元
チェックポイントはマシンのディスクを保存します。フォークはマシンの現在の状態から新しいマシンを作ります。復元はチェックポイントから新しいマシンを作ります。チェックポイントにはマシンの環境ファイルも含まれます。
危険な変更の前にはチェックポイントを作り、同じ出発点から2つのアプローチを並行して試すときはフォークを使います。
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>チェックポイントとフォークは、マシンのプロバイダーが対応している場合にのみ表示されます。コマンドが拒否された場合、そのマシンはその操作に対応していません。
名前の変更
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日を超えたマシンはロックされます。一覧表示、名前の変更、削除はできますが、開く、コマンドを実行する、ポートを転送する、再開することはできません。マシンとファイルは保持されます。再びアップグレードすると再接続できます。クラウドサイドバーには「ロック中」と「アップグレードして再接続」メニュー項目が表示されます。