# Google Antigravity Remote Control: come controllare l'agente dal telefono
> Come abilitare Remote Control in Google Antigravity su desktop e nella CLI: l'interruttore, il daemon agy remote-control e cosa fare in caso di problemi di connessione.
Source: https://ailoot.ai/blog/it/antigravity-remote-control-phone/
Canonical: https://ailoot.ai/blog/it/antigravity-remote-control-phone/
Language: it
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-009
Revision: sha256-97a6718dbfeb1b8dd65b60369ce00b93437d4b044e802db0fb8fd53d4a8abb25
[Documentazione Ailoot](https://ailoot.ai/docs/) — materiali di riferimento sull'utilizzo del servizio.
In breve
In Antigravity 2.0 desktop, Remote Control si abilita con un interruttore in Settings → App. Puoi collegarti a una sessione su antigravity.google.com usando lo stesso account Google. Antigravity CLI dispone di due modalità: `/remote-control` (o il flag `--remote-control`) apre un tunnel per tutta la durata della sessione del terminale, mentre `agy remote-control start` avvia un daemon in background senza un terminale aperto. Su Linux, il daemon continua a funzionare dopo la disconnessione e si avvia dopo un riavvio; su Windows, per farlo è necessario installarlo come amministratore; su macOS e con un'installazione standard di Windows, riprende al successivo accesso. Il computer deve essere acceso e connesso a Internet. La funzionalità potrebbe non essere disponibile a causa delle regole dell'account o dell'organizzazione oppure delle condizioni del piano.
Se non hai ancora installato Antigravity, inizia con una panoramica di [cos'è Google Antigravity e come installarlo](https://ailoot.ai/blog/it/google-antigravity/). Questa guida è pensata per quando un agente sta già svolgendo un'attività lunga (refactoring, esecuzione di test, migrazione delle dipendenze) e devi allontanarti dalla scrivania mantenendo il controllo della sessione.
## Cos'è Remote Control e perché ti serve
Remote Control è una funzionalità di Google Antigravity che ti consente di collegarti in modo sicuro alle sessioni desktop e CLI sui tuoi computer e di controllarle da qualsiasi browser web. Secondo la descrizione ufficiale, le attività più impegnative—per esempio il refactoring completo di un sottosistema, una lunga esecuzione di test o una migrazione complessa delle dipendenze—possono richiedere molto tempo. Remote Control ti consente di gestire una sessione mentre sei lontano dal computer, mantenendo locale l'intero ambiente di sviluppo.
La funzionalità è disponibile sia nell'app desktop 2.0 sia nella CLI, la versione di Antigravity per terminale (`agy`), ma l'attivazione e il comportamento differiscono nei due casi.
## Abilitare Remote Control in Antigravity 2.0 desktop
Puoi abilitare Remote Control nelle impostazioni dell'app:
1. Apri il pannello **Settings** con `Cmd + ,` (o `Ctrl + ,` su Linux e Windows), oppure fai clic sul pulsante **Settings** in fondo al pannello sinistro.
2. Vai alla sezione **App**.
3. Imposta su **On** l'interruttore **Enable Remote Control**.
4. *(Facoltativo)* Imposta un **Nickname**, ad esempio `workstation-primary` o `server-machine`, così potrai riconoscere facilmente questo computer nell'elenco dei dispositivi connessi.
### Collegarsi da un telefono o da un altro browser
Per aprire una sessione remota:
1. Apri un browser su qualsiasi dispositivo e vai alla [Dashboard di Antigravity Remote Control](https://antigravity.google.com). Su un telefono puoi anche installare l'app web nella schermata Home per ricevere notifiche push quando l'agente termina un'attività o ti chiede una risposta.
2. Accedi con lo stesso account Google che usi sul computer.
3. Seleziona il computer desiderato nel selettore dei dispositivi.
4. Una volta connesso, puoi vedere le conversazioni attive, avviare nuove attività per l'agente e visualizzare i piani di implementazione e gli artefatti.
Se il computer non compare nell'interfaccia web, le istruzioni ufficiali indicano di verificare tre cose: che l'interruttore **Enable Remote Control** sia attivo sul computer che esegue Antigravity; che il computer sia connesso a Internet e non sia entrato in modalità sospensione; e che l'app desktop e il browser usino lo stesso account Google.
Se la connessione di rete si interrompe temporaneamente sul dispositivo che stai usando per collegarti, l'interfaccia web proverà a riconnettersi automaticamente. Le attività in background dell'agente e i comandi avviati dal terminale continueranno a essere eseguiti sul computer con Antigravity senza interruzioni, purché resti connesso a Internet.
Diagramma: l'interruttore Remote Control su un laptop trasferisce il controllo a un telefono quando si accede con lo stesso account
Come funziona Remote Control nell'app desktop: attiva l'interruttore sul computer, poi accedi dal telefono con lo stesso account Google.
## Le due modalità di Remote Control nella CLI di Antigravity
La CLI offre due modalità: una modalità interattiva legata a uno specifico processo del terminale e un daemon headless in background che viene eseguito senza un terminale aperto.
### Modalità interattiva: `/remote-control`
Puoi abilitare Remote Control nella sessione interattiva `agy` corrente senza riavviare la CLI. Esegui questo comando nella riga di input:
```
/remote-control
```
Secondo la descrizione ufficiale, la CLI apre una connessione, un tunnel inverso, per la sessione corrente e stampa il nome host insieme a un link alla conversazione attiva, da aprire su un altro dispositivo:
```
Remote control on for this session.
Hostname: devbox-swift-falcon
Open https://antigravity.google.com/r/?p=c%2F on another device to continue this conversation.
```
Apri il link in un browser su un laptop, tablet o telefono, accedi con lo stesso account Google che usi nella CLI e continua a lavorare nella sessione tramite l'interfaccia web di Antigravity.
Per disattivare il tunnel senza terminare la sessione del terminale locale:
```
/remote-control off
```
Puoi avviare la CLI con Remote Control già abilitato usando un flag all'avvio:
```
agy --remote-control
```
La modalità interattiva è legata al processo `agy`: quando esci dalla CLI (`/exit`, `Ctrl+C`, `Ctrl+D`) o chiudi la finestra del terminale, il tunnel Remote Control termina automaticamente e la sessione scompare dalla dashboard. Ogni processo CLI interattivo ha un ID sessione e un nome host distinti, quindi puoi eseguire contemporaneamente `agy --remote-control` in più schede del terminale o directory di lavoro.
Quando ti colleghi a una sessione CLI interattiva da un browser, i due lati si sincronizzano in tempo reale. Le richieste dal dispositivo remoto arrivano direttamente al terminale locale, mentre il ragionamento dell'agente, le chiamate agli strumenti e le modifiche al codice sono visibili nell'interfaccia remota. Se l'agente si ferma per chiedere conferma (`y`/`n`) o pone una domanda di approfondimento, puoi rispondere dal telefono o dal terminale locale. Le impostazioni fanno eccezione: non puoi modificarle dall'interfaccia web remota, ma solo dalla CLI stessa.
### Daemon headless: `agy remote-control start`
La seconda modalità è un daemon persistente in background che si registra come servizio del sistema operativo. È disponibile quando il computer è acceso e connesso a Internet; il comportamento dopo la disconnessione e il riavvio dipende dalla piattaforma.
```
agy remote-control start
```
Il daemon si registra come servizio del sistema operativo (un servizio utente systemd su Linux, un LaunchAgent su macOS o un'attività pianificata su Windows) e si avvia subito, senza una finestra del terminale aperta.
Usa `agy remote-control status` per vedere il nome della voce. Seleziona quindi questo computer nella [Dashboard di Antigravity Remote Control](https://antigravity.google.com) e continua a lavorare tramite l'interfaccia web di Antigravity.
Il daemon è controllato da tre comandi:
```
agy remote-control start Register and start the daemon
agy remote-control status Show the daemon's status and instance name
agy remote-control stop Stop the daemon and unregister it
```
Il daemon usa le credenziali con cui hai effettuato l'accesso alla CLI. L'accesso alla CLI è separato da quello all'editor desktop Antigravity sullo stesso computer; nel browser, usa lo stesso account Google della CLI.
Puoi impostare il nome del computer del daemon headless con il flag `--name` all'avvio:
```
agy remote-control start --name "my-workstation"
```
Eseguendo di nuovo `start --name` con un nuovo valore, il nome del computer viene modificato.
Se non imposti un nome, al primo avvio il daemon ne genera uno facile da ricordare (ad esempio `my-machine-distant-plume`); `agy remote-control status` mostra il nome attuale. Puoi rinominarlo anche nel file delle impostazioni: apri `~/.gemini/config/config.json` su Linux/macOS oppure `%USERPROFILE%\.gemini\config\config.json` su Windows, modifica il valore di `cliRemoteControlHostname`, salva il file ed esegui di nuovo `agy remote-control start` per riavviare il daemon. Il nuovo nome comparirà nella dashboard dopo il riavvio del servizio; le modifiche al file non hanno effetto mentre il daemon è in esecuzione.
Nel file ci sono due campi simili. `cliRemoteControlHostname` è il nome del daemon CLI usato in questo caso. `remoteControlHostname` è un campo separato per l'editor desktop Antigravity sullo stesso computer; in Antigravity 2.0 puoi modificarlo in **Settings → App**.
### Comportamento del daemon dopo la disconnessione e il riavvio
Il comportamento dipende dal sistema operativo:
| Comportamento | Linux | macOS | Windows |
|----|----|----|----|
| Avvio | All'avvio; non è richiesto l'accesso | All'accesso | All'avvio (se installato da un amministratore); altrimenti all'accesso |
| Continua a funzionare dopo la disconnessione | Sì | No; riprende al successivo accesso | Sì, se configurato per avviarsi all'avvio |
| Si ripristina automaticamente dopo un errore | Sì | Sì | Sì, fino a tre tentativi di riavvio, poi al successivo avvio o quando viene eseguito di nuovo `agy remote-control start` |
### Dettagli specifici per Windows
Per registrare il daemon per l'avvio automatico **all'avvio del sistema** è necessario eseguirlo come amministratore. Puoi usare PowerShell o il normale prompt dei comandi. Il comando `start` funziona anche da una finestra normale, ma dopo la disconnessione o il riavvio il daemon riprenderà solo al successivo accesso, non all'avvio. I comandi `status` e `stop` funzionano da una finestra normale senza privilegi elevati.
### Quale modalità scegliere
| Criterio | Interattiva (`/remote-control` / `agy --remote-control`) | Daemon headless (`agy remote-control start`) |
|----|----|----|
| Ambito | Una sessione interattiva del terminale | L'intero computer (servizio del sistema operativo in background) |
| Ciclo di vita | Attiva mentre Remote Control è abilitato e la sessione del terminale è in esecuzione | Sopravvive alla disconnessione e ai riavvii su Linux e su Windows se installato da un amministratore; su macOS e con un'installazione standard di Windows riprende al successivo accesso |
| Nome della voce | Nuovo per ogni sessione (ad esempio `host-swift-falcon`) | Un nome permanente per il computer (`--name` o `cliRemoteControlHostname`) |
| Concorrenza | Più sessioni del terminale contemporaneamente su un computer | Un daemon per computer |
| Link diretto | La CLI stampa un link alla conversazione attiva | Accesso tramite il selettore dei dispositivi su antigravity.google.com |
| Ideale per | Allontanarsi da un'attività attiva nel terminale e continuarla da un telefono o browser | Accesso remoto persistente a una workstation o a un server mentre il computer è acceso e connesso a Internet, nel rispetto delle condizioni del sistema operativo |
La modalità interattiva è sufficiente per gestire un'attività in corso dal telefono. Se hai bisogno di accedere da remoto senza un terminale aperto, usa il daemon headless, nel rispetto delle condizioni del tuo sistema operativo.
Diagramma: il tunnel della sessione scompare quando il terminale viene chiuso; il daemon in background viene eseguito senza un terminale aperto
Differenza tra le modalità CLI: il tunnel interattivo è attivo solo mentre il terminale è aperto; il daemon headless funziona senza un terminale aperto (in base alle condizioni del sistema operativo indicate nella tabella sopra).
## Cosa fare in caso di problemi di connessione
Problemi e soluzioni indicati nella documentazione ufficiale:
| Cosa vedi | Perché | Cosa fare |
|----|----|----|
| `Remote control is not enabled for your account` | Le regole dell'account o dell'organizzazione non hanno abilitato la funzionalità Remote Control | Contatta l'amministratore del tuo spazio di lavoro oppure verifica se il tuo piano supporta Remote Control |
| La voce scompare dalla dashboard (CLI) | `/remote-control` e `agy --remote-control` creano tunnel che si disconnettono automaticamente quando esci dalla sessione interattiva (`/exit`, `Ctrl+C`) o esegui `/remote-control off` | Se vuoi che il computer resti disponibile senza un terminale aperto, installa il daemon headless con `agy remote-control start` |
| Nella dashboard compaiono diverse voci CLI dello stesso computer | Ogni sessione CLI interattiva ha un proprio nome host; è normale quando sono aperti più terminali | Non è necessario intervenire; è il comportamento previsto |
| Il computer non compare nella dashboard (daemon) | Potrebbe esserci un problema di accesso alla CLI | Esegui `agy remote-control status`; se segnala un problema di accesso, esegui `agy`, accedi di nuovo e poi esegui ancora una volta `agy remote-control start` |
| La modifica del nome non ha avuto effetto | Il nome viene letto all'avvio del daemon | Esegui di nuovo `agy remote-control start` per riavviare il daemon |
| Su Windows, il daemon si avvia solo all'accesso, non all'avvio del sistema | Il comando `start` è stato eseguito senza privilegi di amministratore | Esegui di nuovo `agy remote-control start` da una finestra con privilegi elevati |
| La connessione continua a interrompersi e a ristabilirsi | Un vecchio daemon installato tramite lo script di installazione potrebbe essere ancora registrato e competere con quello nuovo per la connessione | Esegui di nuovo `agy remote-control start`; il vecchio servizio viene rimosso automaticamente |
| Nella dashboard compaiono due voci simili per un computer | Una voce è l'editor, l'altra è il daemon CLI; sono intenzionalmente separate | Rinomina la voce che vuoi distinguere |
| Il computer non compare nella dashboard web (desktop) | L'interruttore potrebbe essere disattivato, potrebbe mancare la connessione Internet, il computer potrebbe essere in sospensione oppure potrebbero essere in uso account Google diversi | Controlla l'interruttore **Enable Remote Control**, la connessione Internet del computer e che non sia in sospensione; verifica inoltre che l'account corrisponda su entrambi i dispositivi |
Per una diagnosi più approfondita, controlla i log del daemon: su Linux esegui `journalctl --user -u antigravity-cli-daemon -n 50`; su macOS controlla `~/Library/Logs/antigravity-cli-daemon.log`; su Windows controlla il file `cli-*.log` più recente in `%USERPROFILE%\.gemini\antigravity-cli\log`.
Il daemon headless consente l'accesso senza un terminale aperto anche quando sei lontano, nel rispetto delle condizioni operative del computer e del sistema operativo. Se non ti serve più l'accesso persistente, arresta il daemon con `agy remote-control stop`.
È disponibile un articolo separato sul [controllo remoto in Claude Code](https://ailoot.ai/blog/it/claude-code-remote-control-phone/). Per controllare un altro agente tramite Telegram, consulta la [configurazione di Hermes Agent in Telegram](https://ailoot.ai/blog/it/hermes-agent-telegram-setup/).
## E adesso?
Se lavori nella CLI e vuoi allontanarti dall'attività corrente, inizia dalla modalità interattiva. Lascia aperto il terminale: se lo chiudi, il tunnel si disconnette e la voce della sessione scompare dalla dashboard. Per accedere al computer senza un terminale aperto, usa il daemon rispettando le limitazioni del tuo sistema operativo.
### Fonti
- [Antigravity Remote Control: documentazione ufficiale](https://antigravity.google/docs/remote-control.md)
- [Antigravity Features: panoramica delle funzionalità della versione 2.0](https://antigravity.google/docs/features.md)
- [Antigravity Getting Started: installazione della CLI](https://antigravity.google/docs/getting-started.md)
Altri materiali sono disponibili su [Ailoot](https://ailoot.ai/).
## Domande frequenti
### Perché la sessione remota scompare quando chiudo il terminale?
Il Remote Control interattivo appartiene al processo agy in esecuzione: chiuderlo interrompe il tunnel. Per accedere senza terminale aperto, usa il daemon headless e controlla le sue condizioni di avvio nel sistema operativo.
### Cosa controllo se il computer non compare nella dashboard?
Verifica che sia attivo e online, che Remote Control sia abilitato e che il browser usi lo stesso account Google del desktop o della CLI. Per una sessione daemon controlla agy remote-control status per problemi di accesso o servizio.
## Ailoot · L’azienda e il suo portafoglio di progetti
Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.
L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.
Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.