# クラウドマシン

このページでは、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 180
```

cmux 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日を超えたマシンはロックされます。一覧表示、名前の変更、削除はできますが、開く、コマンドを実行する、ポートを転送する、再開することはできません。マシンとファイルは保持されます。再びアップグレードすると再接続できます。クラウドサイドバーには「ロック中」と「アップグレードして再接続」メニュー項目が表示されます。

Canonical: https://cmux.com/ja/docs/cloud/machines

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