# cmux Cloud

O cmux Cloud oferece máquinas Linux persistentes na nuvem que abrem como espaços de trabalho normais do cmux. Os terminais continuam rodando quando você fecha um painel, perde a rede ou desliga o notebook, então os agentes de codificação continuam trabalhando e você pode se reconectar de qualquer Mac com sessão iniciada.

O cmux Cloud está em acesso antecipado e está disponível, a menos que sua organização o desative. Para usá-lo, ative Settings › Beta Features › Cloud Machines.

## O que é uma máquina

Uma máquina é um computador persistente na nuvem que pertence a você ou à sua equipe. Ela mantém seus arquivos, ferramentas instaladas e terminais em execução. Trate-a como um animal de estimação, não como gado: você instala o que precisa uma vez e volta a ela depois.

Toda máquina executa o daemon do cmux TUI. O daemon mantém os espaços de trabalho e terminais da máquina. Um painel do cmux no seu Mac apenas exibe um terminal que vive na máquina, então fechar o painel nunca interrompe o processo.

Uma máquina pode ter muitos espaços de trabalho. O padrão usual é um espaço de trabalho por tarefa em uma máquina que você mantém, e não uma máquina nova por tarefa.

Cada máquina recebe um nome gerado, como brave-otter. Esse nome é o ID dela no app e na CLI. Você pode adicionar um rótulo de exibição, mas o ID não muda.

## O que você precisa

-   O app cmux para macOS, em execução e com sessão iniciada. A CLI do cmux se comunica com o app, e o app guarda suas credenciais.
-   Um plano pago do cmux. Contas gratuitas não podem criar máquinas. Consulte a página de preços para ver os planos atuais. [cmux.com/pricing](https://cmux.com/pt-BR/pricing)
-   Cloud Machines ativado em Settings › Beta Features, sem nenhuma política da organização que desative o Cloud.
-   Nenhuma configuração de VPN, chave SSH ou encaminhamento de portas. O cmux se conecta às suas máquinas por uma rede privada que inicia automaticamente.

## Início rápido

1.  Inicie a sessão. Use a aba Cloud na barra lateral direita ou execute o comando de login em um terminal.
2.  Crie uma máquina com File › New Cloud Machine ou ⇧⌘Y. Escolha um tamanho e um rótulo opcional. A criação continua em segundo plano, e o cmux mostra uma notificação quando a máquina estiver pronta.
3.  Abra um espaço de trabalho na máquina com ⌘Y (New Cloud Workspace). Dentro de um espaço de trabalho do Cloud, ⌘N sempre cria um espaço de trabalho local neste Mac.
4.  Execute um agente. Claude Code, Codex, OpenCode e Pi já estão instalados na máquina.

Você pode fazer o mesmo pela 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"
```

## O Cloud no app

A aba Cloud na barra lateral direita lista suas máquinas. Em cada máquina você vê seus espaços de trabalho, portas encaminhadas, telas VNC e terminais. Clique em um item para abri-lo. Você também pode abrir a árvore do Cloud como painel pela paleta de comandos com Open Cloud as Pane.

Clique com o botão direito em uma máquina para abrir um shell, criar um espaço de trabalho, abrir o desktop, abrir o cliente completo do cmux TUI, redimensioná-la, renomeá-la, copiar o endereço IP, ver o status, criar um checkpoint, fazer um fork ou excluí-la. Você também pode fixar máquinas e mudar a ordem delas.

New Cloud Machine (⇧⌘Y) e New Cloud Workspace (⌘Y) estão no menu File, no menu do botão de mais e na paleta de comandos. Você pode alterar os dois atalhos em Settings ou no cmux.json com as chaves newCloudMachine e newCloudWorkspace.

```
{
  "shortcuts": {
    "bindings": {
      "newCloudMachine": "cmd+shift+y",
      "newCloudWorkspace": "cmd+y"
    }
  }
}
```

## O Cloud pela CLI

cmux vm e cmux cloud são o mesmo comando. Execute cmux vm sem verbo para listar suas máquinas. Todo verbo tem uma página --help que funciona sem o app, e cmux vm guide imprime um guia completo em Markdown. Adicione --json a qualquer verbo para obter saída legível por máquina.

```
cmux vm              # list machines
cmux vm --help
cmux vm new --help
cmux vm guide        # full Markdown guide
cmux vm ls --json
```

## Sua máquina base

Cada conta tem uma máquina base fixada. cmux vm base a abre e a cria na primeira vez. cmux vm base reset cria uma nova máquina base e mantém a antiga, para que você não perca arquivos por acidente.

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

## Próximos passos

-   [Máquinas: tamanhos, planos, redimensionamento, pausa, snapshots e exclusão.](https://cmux.com/pt-BR/docs/cloud/machines)
-   [Espaços de trabalho e agentes: terminais duráveis, agentes, notificações e o que vem instalado.](https://cmux.com/pt-BR/docs/cloud/workspaces)
-   [Arquivos e rede: envio de arquivos, variáveis de ambiente, portas, desktop e URLs públicas.](https://cmux.com/pt-BR/docs/cloud/networking)
-   [Referência da CLI do Cloud: todos os verbos do cmux vm.](https://cmux.com/pt-BR/docs/cloud/cli)
-   [Segurança e solução de problemas: como o acesso funciona e como corrigir erros comuns.](https://cmux.com/pt-BR/docs/cloud/troubleshooting)

Canonical: https://cmux.com/pt-BR/docs/cloud

Documentation index: https://cmux.com/llms.txt