Macchine Cloud

Questa pagina descrive il ciclo di vita di una macchina cmux Cloud: come crearla, quali dimensioni puoi scegliere, come si applicano i limiti del piano e come metterla in pausa, salvarla, farne un fork ed eliminarla.

Creare una macchina

Nell'app usa File › New Cloud Machine (⇧⌘Y), il menu del pulsante più, la palette dei comandi o il pulsante più nella barra laterale Cloud. La finestra chiede una dimensione e un'etichetta facoltativa.

Dalla CLI, cmux vm new crea una macchina e vi apre un workspace. Usa --detach per crearla senza aprire nulla. Se una richiesta di creazione viene ripetuta, cmux riutilizza la stessa richiesta così non ottieni due macchine.

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

Se la creazione non riesce, la notifica ti permette di riprovare, mostrare l'errore o copiarlo per una richiesta di assistenza.

Dimensioni

Ogni dimensione imposta insieme memoria, vCPU e disco. Scegli una dimensione nella finestra di creazione o con --size. Pro e Team supportano 4g, 8g e 16g (2, 4 e 8 vCPU). Max sblocca anche 24g e 32g (12 e 16 vCPU), oltre a 64g (32 vCPU).

Le nuove macchine usano 8 GB di memoria se non scegli una dimensione. Esegui cmux vm ls --json per vedere le dimensioni consentite dal tuo piano.

Limiti del piano

Le tue macchine attive condividono un unico pool di vCPU e memoria. Usa una macchina grande o diverse piccole. Le macchine in pausa non usano il pool. Il disco è impostato per ogni macchina e non fa parte del pool.

• Gli account gratuiti non possono creare macchine.
• Gli account Pro e Founder's Edition possono avere fino a 5 macchine attive che condividono 20 vCPU e 40 GB di memoria. Una macchina è attiva mentre è in esecuzione o in avvio.
• Gli account Team possono avere fino a 5 macchine attive per ogni postazione a pagamento. Ogni postazione a pagamento aggiunge 20 vCPU e 40 GB di memoria al pool del team.
• Gli account Max possono avere fino a 5 macchine attive che condividono 80 vCPU e 160 GB di memoria. Una macchina Max può usare fino a 64 GB e 32 vCPU, incluse le configurazioni da 24 GB / 12 vCPU e 32 GB / 16 vCPU; Pro e Team si fermano a 16 GB e 8 vCPU.
• Se una macchina nuova, ripresa, ingrandita o duplicata con fork superasse il pool, cmux rifiuta la richiesta e mostra quanto del pool è in uso. Metti in pausa o elimina una macchina per liberare risorse, oppure passa a 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.

Consulta la pagina dei prezzi per i prezzi attuali. Non ci sono misurazioni a consumo né addebiti per eccedenze.

Mantieni aggiornati gli agenti di programmazione

Con questa impostazione attiva, la macchina aggiorna Claude Code, Codex, OpenCode, pi e agent-browser. Controlla dopo la creazione della macchina e a ogni connessione, al massimo una volta ogni 24 ore. L'aggiornamento viene eseguito in modo separato, quindi non blocca mai la connessione.

Ogni strumento proviene dalla sua release ufficiale su GitHub ed è verificato con il digest sha256 dell'asset della release. npm non viene usato. Una release viene installata solo dopo essere stata pubblica per 3 giorni, e un aggiornamento non installa mai una versione precedente. Un agente in esecuzione mantiene i file con cui è partito, e un aggiornamento non riuscito lascia la versione attuale al suo posto.

Il risultato dell'ultimo controllo è in /etc/cmux/agent-updates.state e il log dell'aggiornamento è /var/log/cmux-agent-updates.log. Un controllo non riuscito viene ripetuto alla connessione successiva.

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

Il foglio New Machine attiva questa impostazione per impostazione predefinita. Per cambiarla su una macchina esistente, fai clic destro sulla macchina e scegli Keep Agents Up to Date, oppure esegui cmux vm agent-updates. cmux vm new mantiene le versioni dell'immagine a meno che tu non passi --agent-updates latest. Disattivando gli aggiornamenti restano le versioni già installate.

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

Gli aggiornamenti usano solo github.com, api.github.com, objects.githubusercontent.com e release-assets.githubusercontent.com. cmux consente questi host in ogni modalità di rete, incluse Allowlist e No internet, quindi una policy di rete non blocca mai gli aggiornamenti.

Ridimensionare

Puoi ingrandire una macchina senza perdere dati. Fai clic destro sulla macchina e scegli Resize machine, oppure usa cmux vm resize. Il ridimensionamento può solo ingrandire una macchina. Il disco cresce a passi di 4 GB fino a 128 GB con Pro e Team, o 256 GB con Max (Go è limitato a 16 GB). La memoria arriva fino a 16 GB e la CPU fino a 8 vCPU con Pro e Team, o fino a 64 GB e 32 vCPU con Max. Una macchina più grande usa una parte maggiore del tuo pool. Il massimo effettivo dipende dal tuo piano.

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

Pausa e ripresa

cmux vm pause arresta il calcolo della macchina. Il disco, i workspace e la cronologia dei terminali restano. I processi in esecuzione si arrestano. cmux vm resume riavvia la macchina. Anche aprire una macchina in pausa o eseguirvi un comando la avvia.

Le macchine non vanno in pausa da sole quando sono inattive. Una macchina resta in esecuzione finché non la metti in pausa o la elimini.

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

cmux vm wait attende che una macchina sia pronta. Aggiungi --wake per avviare prima una macchina in pausa. È utile negli script prima del primo comando.

Checkpoint, fork e ripristino

Un checkpoint salva il disco della macchina. Un fork crea una nuova macchina dallo stato attuale di una macchina. Il ripristino crea una nuova macchina da un checkpoint. I checkpoint includono il file d'ambiente della macchina.

Crea un checkpoint prima di una modifica rischiosa e usa un fork per provare due approcci in parallelo dallo stesso punto di partenza.

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 e Fork compaiono solo se il provider della macchina li supporta. Se un comando viene rifiutato, la macchina non supporta quell'operazione.

Rinominare

cmux vm rename imposta un'etichetta visualizzata di massimo 64 caratteri stampabili. Il nome generato resta l'ID della macchina. Usa --clear per rimuovere l'etichetta.

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

Stato e statistiche

cmux vm status mostra lo stato, la dimensione e l'indirizzo di una macchina. cmux vm stats mostra l'uso di CPU, memoria e disco senza risvegliare una macchina in pausa.

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

Eliminare

Eliminare una macchina cancella in modo permanente la macchina e tutto ciò che si trova sul suo disco. Rimuove anche gli URL pubblici della macchina e ne revoca l'accesso ai modelli. Un'eliminazione non si può annullare.

Crea prima un checkpoint se pensi che i file ti serviranno in seguito.

cmux vm rm brave-otter

Quando il piano termina

Se il tuo piano a pagamento termina, le macchine più vecchie di 7 giorni vengono bloccate. Puoi ancora elencarle, rinominarle ed eliminarle, ma non puoi aprirle, eseguire comandi, inoltrare porte o riprenderle. Le macchine e i loro file vengono conservati. Riattiva un piano per ricollegarti. La barra laterale Cloud mostra Locked e una voce di menu Upgrade to Reconnect.