Cloud-Maschinen

Diese Seite erklärt den Lebenszyklus einer cmux Cloud-Maschine: wie du sie erstellst, welche Größen du wählen kannst, welche Planlimits gelten und wie du sie pausierst, sicherst, forkst und löschst.

Maschine erstellen

Nutze in der App File › New Cloud Machine (⇧⌘Y), das Menü der Plus-Schaltfläche, die Befehlspalette oder die Plus-Schaltfläche in der Cloud-Seitenleiste. Der Dialog fragt nach einer Größe und optional einem Label.

In der CLI erstellt cmux vm new eine Maschine und öffnet einen Workspace darauf. Mit --detach erstellst du sie, ohne etwas zu öffnen. Wird eine Erstellungsanfrage wiederholt, verwendet cmux dieselbe Anfrage erneut, damit du nicht zwei Maschinen erhältst.

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

Schlägt die Erstellung fehl, kannst du sie über die Benachrichtigung erneut versuchen, den Fehler anzeigen oder ihn für eine Supportanfrage kopieren.

Größen

Jede Größe legt Arbeitsspeicher, vCPU und Festplatte gemeinsam fest. Wähle eine Größe im Erstellungsdialog oder mit --size. Pro und Team unterstützen 4g, 8g und 16g (2, 4 und 8 vCPU). Max schaltet zusätzlich 24g und 32g (12 und 16 vCPU) sowie 64g (32 vCPU) frei.

Neue Maschinen erhalten 8 GB Arbeitsspeicher, wenn du keine Größe wählst. Führe cmux vm ls --json aus, um die Größen zu sehen, die dein Plan erlaubt.

Planlimits

Deine aktiven Maschinen teilen sich einen Pool aus vCPUs und Arbeitsspeicher. Betreibe eine große Maschine oder mehrere kleine. Pausierte Maschinen belegen den Pool nicht. Die Festplatte gilt pro Maschine und gehört nicht zum Pool.

• Kostenlose Konten können keine Maschinen erstellen.
• Pro- und Founder's-Edition-Konten können bis zu 5 aktive Maschinen haben, die sich 20 vCPUs und 40 GB Arbeitsspeicher teilen. Eine Maschine ist aktiv, solange sie läuft oder startet.
• Team-Konten können pro bezahltem Platz bis zu 5 aktive Maschinen haben. Jeder bezahlte Platz fügt dem Pool des Teams 20 vCPUs und 40 GB Arbeitsspeicher hinzu.
• Max-Konten können bis zu 5 aktive Maschinen haben, die sich 80 vCPUs und 160 GB Arbeitsspeicher teilen. Eine Max-Maschine kann bis zu 64 GB und 32 vCPUs nutzen, einschließlich der Größen 24 GB / 12 vCPU und 32 GB / 16 vCPU; Pro und Team enden bei 16 GB und 8 vCPUs.
• Würde eine neue, fortgesetzte, vergrößerte oder geforkte Maschine den Pool überschreiten, lehnt cmux die Anfrage ab und zeigt, wie viel vom Pool belegt ist. Pausiere oder lösche eine Maschine, um Ressourcen freizugeben, oder führe ein Upgrade auf Max durch.
• 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.

Aktuelle Preise findest du auf der Preisseite. Es gibt keine nutzungsbasierte Abrechnung und keine Überschreitungsgebühren.

Coding-Agents aktuell halten

Ist diese Einstellung aktiv, aktualisiert die Maschine Claude Code, Codex, OpenCode, pi und agent-browser. Sie prüft nach dem Erstellen der Maschine und bei jedem Verbinden, höchstens einmal alle 24 Stunden. Das Update läuft losgelöst im Hintergrund und blockiert das Verbinden nie.

Jedes Tool kommt aus seinem offiziellen GitHub-Release und wird mit dem sha256-Digest des Release-Assets geprüft. npm wird nicht verwendet. Ein Release wird erst installiert, wenn es seit 3 Tagen öffentlich ist, und ein Update installiert nie eine ältere Version. Ein laufender Agent behält die Dateien, mit denen er gestartet ist, und ein fehlgeschlagenes Update lässt die aktuelle Version bestehen.

Das Ergebnis der letzten Prüfung steht in /etc/cmux/agent-updates.state, das Log des Updaters in /var/log/cmux-agent-updates.log. Eine fehlgeschlagene Prüfung läuft beim nächsten Verbinden erneut.

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

Im Dialog Neue Maschine ist diese Einstellung standardmäßig aktiv. Um sie für eine bestehende Maschine zu ändern, klicke mit der rechten Maustaste auf die Maschine und wähle Agents aktuell halten, oder führe cmux vm agent-updates aus. cmux vm new behält die Versionen des Images, außer du übergibst --agent-updates latest. Wenn du Updates ausschaltest, bleiben die installierten Versionen erhalten.

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

Updates nutzen nur github.com, api.github.com, objects.githubusercontent.com und release-assets.githubusercontent.com. cmux erlaubt diese Hosts in jedem Netzwerkmodus, auch bei Zulassungsliste und Kein Internet, daher blockiert eine Netzwerkrichtlinie Updates nie.

Größe ändern

Du kannst eine Maschine ohne Datenverlust vergrößern. Klicke mit der rechten Maustaste auf die Maschine und wähle Resize machine, oder nutze cmux vm resize. Eine Maschine lässt sich nur vergrößern. Die Festplatte wächst in 4-GB-Schritten bis 128 GB bei Pro und Team oder 256 GB bei Max (Go ist auf 16 GB begrenzt). Arbeitsspeicher und CPU wachsen bei Pro und Team bis 16 GB und 8 vCPU, bei Max bis 64 GB und 32 vCPU. Eine größere Maschine belegt mehr von deinem Pool. Das tatsächliche Maximum legt dein Plan fest.

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

Pausieren und fortsetzen

cmux vm pause stoppt die Rechenleistung der Maschine. Festplatte, Workspaces und Terminalverlauf bleiben erhalten. Laufende Prozesse werden beendet. cmux vm resume startet die Maschine wieder. Auch das Öffnen einer pausierten Maschine oder das Ausführen eines Befehls darauf startet sie.

Maschinen pausieren nicht von selbst, wenn sie im Leerlauf sind. Eine Maschine läuft weiter, bis du sie pausierst oder löschst.

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

cmux vm wait wartet, bis eine Maschine bereit ist. Füge --wake hinzu, um eine pausierte Maschine zuerst zu starten. Das ist in Skripten vor dem ersten Befehl nützlich.

Checkpoints, Forks und Wiederherstellung

Ein Checkpoint sichert die Festplatte der Maschine. Ein Fork erstellt eine neue Maschine aus dem aktuellen Zustand einer Maschine. Eine Wiederherstellung erstellt eine neue Maschine aus einem Checkpoint. Checkpoints enthalten die Umgebungsdatei der Maschine.

Erstelle einen Checkpoint vor einer riskanten Änderung, und nutze einen Fork, um zwei Ansätze parallel vom selben Ausgangspunkt aus zu testen.

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 und Fork erscheinen nur, wenn der Anbieter der Maschine sie unterstützt. Wird ein Befehl abgelehnt, unterstützt die Maschine diesen Vorgang nicht.

Umbenennen

cmux vm rename setzt ein Anzeigelabel mit bis zu 64 druckbaren Zeichen. Der generierte Name bleibt die ID der Maschine. Mit --clear entfernst du das Label.

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

Status und Statistiken

cmux vm status zeigt Zustand, Größe und Adresse einer Maschine. cmux vm stats zeigt die Auslastung von CPU, Arbeitsspeicher und Festplatte, ohne eine pausierte Maschine aufzuwecken.

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

Löschen

Das Löschen einer Maschine entfernt die Maschine und alles auf ihrer Festplatte dauerhaft. Außerdem werden die öffentlichen URLs der Maschine entfernt und ihr Modellzugriff widerrufen. Das Löschen lässt sich nicht rückgängig machen.

Erstelle vorher einen Checkpoint, wenn du die Dateien später vielleicht noch brauchst.

cmux vm rm brave-otter

Wenn dein Plan endet

Endet dein kostenpflichtiger Plan, werden Maschinen, die älter als 7 Tage sind, gesperrt. Du kannst sie weiterhin auflisten, umbenennen und löschen, aber nicht öffnen, keine Befehle darauf ausführen, keine Ports weiterleiten und sie nicht fortsetzen. Die Maschinen und ihre Dateien bleiben erhalten. Führe ein Upgrade durch, um dich wieder zu verbinden. Die Cloud-Seitenleiste zeigt Locked und den Menüeintrag Upgrade to Reconnect.