Máquinas de Cloud

Esta página explica el ciclo de vida de una máquina de cmux Cloud: cómo crearla, qué tamaños puedes elegir, cómo se aplican los límites del plan y cómo pausarla, guardarla, hacer un fork y eliminarla.

Crear una máquina

En la app, usa File › New Cloud Machine (⇧⌘Y), el menú del botón más, la paleta de comandos o el botón más de la barra lateral de Cloud. El diálogo pide un tamaño y una etiqueta opcional.

Desde la CLI, cmux vm new crea una máquina y abre un espacio de trabajo en ella. Usa --detach para crearla sin abrir nada. Si se reintenta una solicitud de creación, cmux reutiliza la misma solicitud para que no obtengas dos máquinas.

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

Si la creación falla, la notificación te permite reintentar, mostrar el error o copiarlo para una solicitud de soporte.

Tamaños

Cada tamaño define a la vez la memoria, las vCPU y el disco. Elige un tamaño en el diálogo de creación o con --size. Pro y Team admiten 4g, 8g y 16g (2, 4 y 8 vCPU). Max también desbloquea 24g y 32g (12 y 16 vCPU), además de 64g (32 vCPU).

Las máquinas nuevas usan 8 GB de memoria si no eliges un tamaño. Ejecuta cmux vm ls --json para ver los tamaños que permite tu plan.

Límites del plan

Tus máquinas activas comparten un único fondo de vCPU y memoria. Ejecuta una máquina grande o varias pequeñas. Las máquinas en pausa no usan el fondo. El disco se fija por máquina y no forma parte del fondo.

• Las cuentas gratuitas no pueden crear máquinas.
• Las cuentas Pro y Founder's Edition pueden tener hasta 5 máquinas activas que comparten 20 vCPU y 40 GB de memoria. Una máquina está activa mientras está en ejecución o iniciándose.
• Las cuentas de equipo pueden tener hasta 5 máquinas activas por cada puesto de pago. Cada puesto de pago añade 20 vCPU y 40 GB de memoria al fondo del equipo.
• Las cuentas Max pueden tener hasta 5 máquinas activas que comparten 80 vCPU y 160 GB de memoria. Una máquina Max puede usar hasta 64 GB y 32 vCPU, incluidos los tamaños de 24 GB / 12 vCPU y 32 GB / 16 vCPU; Pro y Team llegan hasta 16 GB y 8 vCPU.
• Si una máquina nueva, reanudada, ampliada o bifurcada superara el fondo, cmux rechaza la solicitud y muestra cuánto del fondo está en uso. Pausa o elimina una máquina para liberar recursos, o mejora 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 página de precios para ver los precios actuales. No hay medición de uso ni cargos por exceso.

Mantener actualizados los agentes de programación

Con esta opción activada, la máquina actualiza Claude Code, Codex, OpenCode, pi y agent-browser. Comprueba después de crear la máquina y cada vez que te conectas, como máximo una vez cada 24 horas. La actualización se ejecuta de forma independiente, así que nunca bloquea la conexión.

Cada herramienta proviene de su versión oficial en GitHub y se verifica con el resumen sha256 del recurso de la versión. No se usa npm. Una versión solo se instala cuando lleva 3 días publicada, y una actualización nunca instala una versión anterior. Un agente en ejecución conserva los archivos con los que se inició, y una actualización fallida deja la versión actual en su lugar.

El resultado de la última comprobación está en /etc/cmux/agent-updates.state y el registro del actualizador en /var/log/cmux-agent-updates.log. Una comprobación fallida se repite en la siguiente conexión.

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

La hoja Nueva máquina activa esta opción de forma predeterminada. Para cambiarla en una máquina existente, haz clic derecho en la máquina y elige Mantener los agentes actualizados, o ejecuta cmux vm agent-updates. cmux vm new conserva las versiones de la imagen salvo que pases --agent-updates latest. Al desactivar las actualizaciones se conservan las versiones ya instaladas.

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

Las actualizaciones solo usan github.com, api.github.com, objects.githubusercontent.com y release-assets.githubusercontent.com. cmux permite estos hosts en todos los modos de red, incluidos Lista permitida y Sin internet, así que una política de red nunca bloquea las actualizaciones.

Cambiar tamaño

Puedes ampliar una máquina sin perder datos. Haz clic derecho en la máquina y elige Resize machine, o usa cmux vm resize. Solo se puede ampliar una máquina, no reducirla. El disco crece en incrementos de 4 GB hasta 128 GB en Pro y Team, o 256 GB en Max (Go está limitado a 16 GB). La memoria crece hasta 16 GB y la CPU hasta 8 vCPU en Pro y Team, o hasta 64 GB y 32 vCPU en Max. Una máquina más grande usa más de tu fondo. Tu plan fija el máximo real.

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

Pausar y reanudar

cmux vm pause detiene el cómputo de la máquina. El disco, los espacios de trabajo y el historial de los terminales se conservan. Los procesos en ejecución se detienen. cmux vm resume vuelve a iniciar la máquina. Abrir una máquina en pausa o ejecutar un comando en ella también la inicia.

Las máquinas no se pausan solas cuando están inactivas. Una máquina sigue en ejecución hasta que la pausas o la eliminas.

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

cmux vm wait espera a que una máquina esté lista. Añade --wake para iniciar primero una máquina en pausa. Es útil en scripts antes del primer comando.

Checkpoints, forks y restauración

Un checkpoint guarda el disco de la máquina. Un fork crea una máquina nueva a partir del estado actual de una máquina. Restaurar crea una máquina nueva a partir de un checkpoint. Los checkpoints incluyen el archivo de entorno de la máquina.

Crea un checkpoint antes de un cambio arriesgado y usa un fork para probar dos enfoques en paralelo desde el mismo punto de partida.

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 y Fork solo aparecen cuando el proveedor de la máquina los admite. Si se rechaza un comando, la máquina no admite esa operación.

Renombrar

cmux vm rename establece una etiqueta visible de hasta 64 caracteres imprimibles. El nombre generado sigue siendo el ID de la máquina. Usa --clear para quitar la etiqueta.

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

Estado y estadísticas

cmux vm status muestra el estado, el tamaño y la dirección de una máquina. cmux vm stats muestra el uso de CPU, memoria y disco sin despertar una máquina en pausa.

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

Eliminar

Eliminar una máquina borra de forma permanente la máquina y todo lo que hay en su disco. También elimina las URL públicas de la máquina y revoca su acceso a modelos. No se puede deshacer una eliminación.

Crea antes un checkpoint si crees que necesitarás los archivos más adelante.

cmux vm rm brave-otter

Cuando termina tu plan

Si tu plan de pago termina, las máquinas con más de 7 días se bloquean. Puedes seguir listándolas, renombrándolas y eliminándolas, pero no puedes abrirlas, ejecutar comandos, reenviar puertos ni reanudarlas. Las máquinas y sus archivos se conservan. Vuelve a contratar un plan para reconectarte. La barra lateral de Cloud muestra Locked y un elemento de menú Upgrade to Reconnect.