cmuxcmux
/docs
cmux Cloud概要
cmux Cloud

cmux Cloud

cmux Cloudは、通常のcmuxワークスペースとして開ける永続的なLinuxマシンをクラウド上に提供します。ペインを閉じても、ネットワークが切れても、ノートパソコンを閉じてもターミナルは動き続けるため、コーディングエージェントは作業を続けられ、サインイン済みのどのMacからでも再接続できます。

cmux Cloudは早期アクセス中で、組織によって無効化されていない限り利用できます。利用するには、設定 › ベータ機能 › クラウドマシン をオンにしてください。

マシンとは

マシンは、あなたまたはチームに属する永続的なクラウドコンピュータです。ファイル、インストール済みのツール、実行中のターミナルを保持します。使い捨てではなく長く使うものとして扱ってください。必要なものを一度インストールし、後で戻ってきて使います。

すべてのマシンでcmux TUIデーモンが動作しています。デーモンはマシンのワークスペースとターミナルを保持します。Mac上のcmuxペインはマシン上にあるターミナルを表示しているだけなので、ペインを閉じてもプロセスは止まりません。

1台のマシンに多数のワークスペースを置けます。タスクごとに新しいマシンを作るのではなく、使い続けるマシン上でタスクごとに1つのワークスペースを使うのが一般的です。

各マシンには brave-otter のような名前が自動で付きます。この名前がアプリとCLIでのマシンIDです。表示ラベルを追加できますが、IDは変わりません。

必要なもの

  • 起動済みでサインイン済みのcmux macOSアプリ。cmux CLIはアプリと通信し、認証情報はアプリが保持します。
  • cmuxの有料プラン。無料アカウントではマシンを作成できません。現在のプランは料金ページを参照してください。 cmux.com/pricing
  • 設定 › ベータ機能 でクラウドマシンがオンになっており、組織のポリシーでCloudが無効化されていないこと。
  • VPN、SSH鍵、ポートフォワーディングの設定は不要です。cmuxは自動的に起動するプライベートネットワーク経由でマシンに接続します。

クイックスタート

  1. サインインします。右サイドバーのクラウドタブを使うか、ターミナルでログインコマンドを実行します。
  2. ファイル › 新規クラウドマシン または ⇧⌘Y でマシンを作成します。サイズと任意のラベルを選びます。作成はバックグラウンドで進み、マシンの準備ができるとcmuxが通知します。
  3. ⌘Y（新規クラウドワークスペース）でマシン上にワークスペースを開きます。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

右サイドバーのクラウドタブにマシンが一覧表示されます。各マシンの下には、ワークスペース、転送中のポート、VNCディスプレイ、ターミナルが表示されます。項目をクリックすると開きます。コマンドパレットの「Cloudをペインで開く」で、Cloudツリーをペインとして開くこともできます。

マシンを右クリックすると、シェルを開く、ワークスペースを作成する、デスクトップを開く、cmux TUIクライアントを開く、サイズを変更する、名前を変更する、IPアドレスをコピーする、状態を確認する、チェックポイントを作成する、フォークする、削除する、といった操作ができます。マシンをピン留めしたり、並び順を変えたりすることもできます。

新規クラウドマシン（⇧⌘Y）と新規クラウドワークスペース（⌘Y）は、ファイルメニュー、プラスボタンのメニュー、コマンドパレットにあります。どちらのショートカットも、設定または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

ベースマシン

各アカウントにはピン留めされたベースマシンが1台あります。cmux vm base はそれを開き、初回は作成します。cmux vm base reset は新しいベースマシンを作成し、古いマシンも残すため、誤ってファイルを失うことはありません。

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

次のステップ

このページは役に立ちましたか？
Issue を作成