# Workspace Cloud e agenti

Un workspace Cloud funziona come un workspace cmux locale, ma i suoi terminali girano su una macchina nel cloud. Questa pagina tratta i terminali persistenti, l'esecuzione degli agenti, le notifiche e gli strumenti installati su ogni macchina.

## Terminali persistenti

I terminali vivono nel daemon della macchina, non sul tuo Mac. Continuano a funzionare quando chiudi un riquadro, esci da cmux, perdi il Wi-Fi o chiudi il portatile. Riapri la macchina da qualsiasi Mac con accesso effettuato e il terminale ha ancora il suo output e il suo processo in esecuzione.

Se la connessione cade, il riquadro mostra Cloud session disconnected con un pulsante Reconnect, e cmux riprova da solo.

Se il daemon della macchina si riavvia, cmux ripristina il layout del workspace, ma i processi in esecuzione non sopravvivono al riavvio.

Chiudere un workspace lascia i suoi terminali in esecuzione in modalità scollegata. Rimuovere un workspace arresta i suoi terminali.

## Eseguire agenti di codice

Claude Code, Codex, OpenCode e Pi sono installati su ogni macchina. Apri un workspace Cloud e avvia l'agente come faresti in locale. Gli hook degli agenti sono già configurati, così lo stato degli agenti e le notifiche arrivano sul tuo Mac.

cmux vm agent avvia un agente su una macchina dal tuo Mac. Con un prompt, usa la modalità one-shot dell'agente. Aggiungi --sync per caricare prima la directory corrente e --wait per attendere il risultato.

```
cmux vm agent --agent claude --machine brave-otter -- "add tests for the parser"
cmux vm agent --agent codex --machine brave-otter --sync --wait -- "fix the build"
cmux vm agent --agent opencode --new --size 16g -- "profile the importer"
```

cmux vm prompt installa una skill cmux Cloud per il tuo agente locale e stampa un prompt che gli insegna a usare le macchine Cloud.

```
cmux vm prompt --open claude
```

## Eseguire comandi

cmux vm run esegue un comando su una macchina e restituisce il suo codice di uscita. La prima esecuzione da una directory sceglie una macchina e la ricorda per quella directory per 14 giorni. Aggiungi --sync per caricare prima la directory e --pull per scaricare un risultato.

```
cmux vm run -- npm test
cmux vm run --sync --pull dist -- npm run build
cmux vm route --json
```

cmux vm exec esegue un comando breve senza terminale. Serve per controlli rapidi. Il timeout è di 30 secondi per impostazione predefinita e di 5 minuti al massimo. Per lavori lunghi usa cmux vm run, cmux vm agent o un terminale del workspace.

```
cmux vm exec brave-otter -- uname -a
cmux vm exec --timeout 120 brave-otter -- docker ps
```

## Avviare un server di sviluppo

cmux vm dev carica un progetto, capisce come avviarlo e lo apre in un workspace con il server e un browser. Rileva progetti package.json, Cargo, Go, target dev di Makefile, Django, uv, pyproject, requirements.txt e siti statici index.html. Usa --dry-run per vedere prima il piano.

```
cmux vm dev brave-otter --dry-run
cmux vm dev brave-otter . --port 3000
```

## Notifiche

cmux notify all'interno di una macchina mostra una notifica sul tuo Mac per quel terminale. Gli hook degli agenti inviano notifiche quando un agente termina, richiede un'approvazione, pone una domanda o non riesce. I titoli sono limitati a 128 byte e il corpo a 1 KB, e le raffiche sono soggette a limiti di frequenza.

```
# Inside a Cloud machine
cmux notify --title "Build" --body "Tests passed"
```

## Incollare immagini

Premi ⌘V con un'immagine negli appunti in un terminale Cloud. cmux carica l'immagine sulla macchina e incolla il percorso remoto, così Claude Code e Codex possono leggerla. Sono supportati PNG, JPEG, GIF e WebP, fino a 20 MB ciascuna e 8 immagini alla volta.

## Layout e terminali dalla CLI

cmux vm workspace crea, apre, rinomina, chiude e rimuove i workspace su una macchina. cmux vm terminal invia testo, legge l'output e attende un testo o la terminazione. cmux vm tree mostra i workspace e i terminali della macchina. cmux vm layout export e apply usano lo stesso JSON di cmux new-workspace --layout.

```
cmux vm tree brave-otter
cmux vm workspace new brave-otter --name review
cmux vm terminal send brave-otter term_2f9c "npm run dev" --keys enter
cmux vm terminal wait brave-otter term_2f9c --pattern "ready" --timeout 60
cmux vm terminal read brave-otter term_2f9c
cmux vm layout export brave-otter review > layout.json
cmux vm layout apply brave-otter layout.json --open
```

## Cosa è installato

Le macchine eseguono Ubuntu 24.04. Lavori come utente cmux con sudo senza password, non come root. Docker si avvia all'accensione.

-   Linguaggi e strumenti: Node.js LTS, Bun, Python 3.12, uv, Docker, git, GitHub CLI, ripgrep, fd, fzf, jq, tmux, sqlite3, strumenti di compilazione, vim, nano e rsync.
-   Browser e desktop: Chrome, agent-browser, un desktop VNC e Ghostty.
-   Agenti: Claude Code, Codex, OpenCode e Pi. Sono fissati su versioni testate e si aggiornano quando si aggiorna l'immagine della macchina.

Se un comando di un agente non viene trovato subito dopo la creazione di una macchina, la configurazione è ancora in corso. Il log di configurazione si trova in /tmp/cmux/provision.log.

## Accesso ai modelli

Gli agenti su una macchina possono usare l'instradamento dei modelli di cmux senza una chiave sulla macchina. La credenziale reale viene aggiunta al di fuori della macchina, quindi nessun token dell'account è memorizzato nella VM. Puoi anche accedere a un agente all'interno della macchina o caricare account per il tuo team con cmux ai-accounts upload.

```
cmux ai-accounts list
cmux ai-accounts upload claude
cmux coderouter status
```

[Documentazione di CodeRouter: account supportati, condivisione e utilizzo](https://cmux.com/it/docs/coderouter)

## La CLI di cmux all'interno di una macchina

All'interno di una macchina, il comando cmux controlla la sessione di quella macchina. Supporta tree, new-workspace, new-split, send, send-key, read-screen, terminal, layout, env, notify, open-url e self. cmux self mostra il proprietario, la macchina e le tue altre macchine. cmux vm verb peer controlla le tue altre macchine dall'interno di una macchina.

```
# Inside a Cloud machine
cmux tree
cmux new-split right
cmux self peers
cmux vm exec calm-heron -- git status
```

L'accesso, il caricamento degli account IA e i comandi del ciclo di vita delle macchine come new, delete, checkpoint, fork, resize, pause, domains, open e vpn funzionano solo sul tuo Mac.

## iPhone

L'app cmux per iOS non gestisce le macchine Cloud. Una macchina in fase di avvio appare come una scheda segnaposto.

Canonical: https://cmux.com/it/docs/cloud/workspaces

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