Máquinas do Cloud

Esta página explica o ciclo de vida de uma máquina do cmux Cloud: como criá-la, quais tamanhos você pode escolher, como os limites do plano se aplicam e como pausar, fazer checkpoints, forks e excluí-la.

Criar uma máquina

No app, use File › New Cloud Machine (⇧⌘Y), o menu do botão de mais, a paleta de comandos ou o botão de mais na barra lateral do Cloud. A janela pede um tamanho e um rótulo opcional.

Pela CLI, cmux vm new cria uma máquina e abre um espaço de trabalho nela. Use --detach para criá-la sem abrir nada. Se uma solicitação de criação for repetida, o cmux reutiliza a mesma solicitação para que você não fique com duas máquinas.

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

Se a criação falhar, a notificação permite tentar de novo, mostrar o erro ou copiá-lo para uma solicitação de suporte.

Tamanhos

Cada tamanho define memória, vCPU e disco juntos. Escolha um tamanho na janela de criação ou com --size. Pro e Team oferecem 4g, 8g e 16g (2, 4 e 8 vCPU). O Max também libera 24g e 32g (12 e 16 vCPU), além de 64g (32 vCPU).

Máquinas novas usam 8 GB de memória quando você não escolhe um tamanho. Execute cmux vm ls --json para ver os tamanhos que seu plano permite.

Limites do plano

Suas máquinas ativas compartilham um único conjunto de vCPUs e memória. Rode uma máquina grande ou várias pequenas. Máquinas pausadas não usam o conjunto. O disco é definido por máquina e não faz parte do conjunto.

• Contas gratuitas não podem criar máquinas.
• Contas Pro e Founder's Edition podem ter até 5 máquinas ativas que compartilham 20 vCPUs e 40 GB de memória. Uma máquina está ativa enquanto está em execução ou iniciando.
• Contas de equipe podem ter até 5 máquinas ativas por assento pago. Cada assento pago adiciona 20 vCPUs e 40 GB de memória ao conjunto da equipe.
• Contas Max podem ter até 5 máquinas ativas que compartilham 80 vCPUs e 160 GB de memória. Uma máquina Max pode usar até 64 GB e 32 vCPUs, incluindo os tamanhos de 24 GB / 12 vCPU e 32 GB / 16 vCPU; Pro e Team ficam limitados a 16 GB e 8 vCPUs.
• Se uma máquina nova, retomada, redimensionada ou bifurcada ultrapassar o conjunto, o cmux recusa a solicitação e mostra quanto do conjunto está em uso. Pause ou exclua uma máquina para liberar recursos, ou faça upgrade para o 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.

Consulte a página de preços para ver os valores atuais. Não há medição de uso nem cobrança por excedente.

Manter agentes de programação atualizados

Com esta opção ativada, a máquina atualiza Claude Code, Codex, OpenCode, pi e agent-browser. Ela verifica depois que a máquina é criada e sempre que você se conecta, no máximo uma vez a cada 24 horas. A atualização roda de forma independente, então nunca bloqueia a conexão.

Cada ferramenta vem da sua versão oficial no GitHub e é verificada pelo digest sha256 do arquivo da versão. O npm não é usado. Uma versão só é instalada depois de estar pública há 3 dias, e uma atualização nunca instala uma versão mais antiga. Um agente em execução mantém os arquivos com que começou, e uma atualização com falha mantém a versão atual.

O resultado da última verificação fica em /etc/cmux/agent-updates.state, e o log do atualizador em /var/log/cmux-agent-updates.log. Uma verificação com falha roda de novo na próxima conexão.

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

A janela New Machine ativa esta opção por padrão. Para mudar em uma máquina existente, clique com o botão direito na máquina e escolha Keep Agents Up to Date, ou execute cmux vm agent-updates. cmux vm new mantém as versões da imagem, a menos que você passe --agent-updates latest. Desativar as atualizações mantém as versões já instaladas.

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

As atualizações usam apenas github.com, api.github.com, objects.githubusercontent.com e release-assets.githubusercontent.com. O cmux permite esses hosts em todos os modos de rede, incluindo Allowlist e No internet, então uma política de rede nunca bloqueia as atualizações.

Redimensionar

Você pode aumentar uma máquina sem perder dados. Clique com o botão direito na máquina e escolha Resize machine, ou use cmux vm resize. O redimensionamento só pode aumentar uma máquina. O disco cresce em passos de 4 GB até 128 GB no Pro e no Team, ou 256 GB no Max (o Go é limitado a 16 GB). A memória cresce até 16 GB e a CPU até 8 vCPU no Pro e no Team, ou até 64 GB e 32 vCPU no Max. Uma máquina maior usa mais do seu conjunto. Seu plano define o máximo real.

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

Pausar e retomar

cmux vm pause interrompe a computação da máquina. O disco, os espaços de trabalho e o histórico dos terminais permanecem. Os processos em execução param. cmux vm resume inicia a máquina novamente. Abrir uma máquina pausada ou executar um comando nela também a inicia.

As máquinas não pausam sozinhas quando estão ociosas. Uma máquina continua rodando até você pausá-la ou excluí-la.

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

cmux vm wait espera até que uma máquina esteja pronta. Adicione --wake para iniciar antes uma máquina pausada. Isso é útil em scripts antes do primeiro comando.

Checkpoints, forks e restauração

Um checkpoint salva o disco da máquina. Um fork cria uma nova máquina a partir do estado atual de uma máquina. A restauração cria uma nova máquina a partir de um checkpoint. Os checkpoints incluem o arquivo de ambiente da máquina.

Use um checkpoint antes de uma mudança arriscada e use um fork para testar duas abordagens em paralelo a partir do mesmo ponto 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 e Fork aparecem apenas quando o provedor da máquina oferece suporte a eles. Se um comando for recusado, a máquina não oferece suporte a essa operação.

Renomear

cmux vm rename define um rótulo de exibição com até 64 caracteres imprimíveis. O nome gerado continua sendo o ID da máquina. Use --clear para remover o rótulo.

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

Status e estatísticas

cmux vm status mostra o estado, o tamanho e o endereço de uma máquina. cmux vm stats mostra o uso de CPU, memória e disco sem acordar uma máquina pausada.

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

Excluir

Excluir uma máquina apaga permanentemente a máquina e tudo o que está no disco dela. Isso também remove as URLs públicas da máquina e revoga seu acesso aos modelos. Não é possível desfazer uma exclusão.

Crie um checkpoint antes se achar que vai precisar dos arquivos depois.

cmux vm rm brave-otter

Quando seu plano termina

Se o seu plano pago terminar, as máquinas com mais de 7 dias são bloqueadas. Você ainda pode listá-las, renomeá-las e excluí-las, mas não pode abri-las, executar comandos, encaminhar portas nem retomá-las. As máquinas e seus arquivos são mantidos. Assine novamente para se reconectar. A barra lateral do Cloud mostra Locked e um item de menu Upgrade to Reconnect.