Google Antigravity Remote Control：如何用手機控制代理程式

如果你尚未安裝 Antigravity，請先閱讀 Google Antigravity 是什麼，以及如何安裝的概覽。這份指南適用於代理程式正在處理長時間任務（重構、執行測試、遷移相依套件），而你需要離開座位但仍想掌控工作階段的情況。

Remote Control 是什麼，以及為什麼需要它#

Remote Control 是 Google Antigravity 的一項功能，讓你能透過任何網頁瀏覽器，安全地連線並控制你電腦上的桌面與 CLI 工作階段。根據官方說明，大型任務可能需要很長時間，例如完整重構子系統、長時間執行測試，或複雜的相依套件遷移。Remote Control 讓你在離開電腦時仍能管理工作階段，同時將整個開發環境留在本機。

此功能適用於桌面應用程式 2.0 和 CLI（Antigravity 的終端機版本 agy），但兩者的啟用方式和運作方式不同。

在桌面版 Antigravity 2.0 啟用 Remote Control#

你可以在應用程式設定中啟用 Remote Control：

1. 按 Cmd + ,（Linux 和 Windows 上按 Ctrl + ,）開啟 Settings 面板，或點選左側面板底部的 Settings 按鈕。
2. 前往 App 區段。
3. 將 Enable Remote Control 切換為 On。
4. (選填) 設定 Nickname，例如 workstation-primary 或 server-machine，方便你在已連線裝置清單中辨認這台電腦。

從手機或其他瀏覽器連線

若要開啟遠端工作階段：

1. 在任何裝置上開啟瀏覽器，前往 Antigravity Remote Control Dashboard。在手機上，你也可以將網頁應用程式安裝到主畫面；代理程式完成任務或要求你回覆時，就會收到推播通知。
2. 使用你在桌面版上使用的相同 Google 帳戶登入。
3. 在裝置切換器中選取所需的電腦。
4. 連線後，你可以查看進行中的對話、為代理程式開始新任務，以及檢視實作計畫和成果。

如果網頁介面中沒有顯示該電腦，官方說明建議檢查三件事：執行 Antigravity 的電腦上已開啟 Enable Remote Control 開關；該電腦已連上網際網路且沒有進入睡眠；桌面應用程式和瀏覽器使用相同的 Google 帳戶。

如果你用來連線的裝置暫時失去網路連線，網頁介面會嘗試自動重新連線。只要執行 Antigravity 的電腦仍連上網際網路，代理程式的背景任務和從終端機啟動的命令就會在該電腦上不受影響地繼續執行。

Antigravity CLI 中的兩種 Remote Control 模式#

CLI 有兩種模式：與特定終端機程序綁定的互動模式，以及不需要開啟終端機即可執行的背景無頭守護程序。

互動模式：/remote-control

你可以在目前的互動式 agy 工作階段中啟用 Remote Control，不必重新啟動 CLI。在輸入列執行：

/remote-control

根據官方說明，CLI 會為目前的工作階段開啟連線（反向通道），並印出主機名稱和連結，讓其他裝置開啟進行中的對話：

Remote control on for this session.
Hostname: devbox-swift-falcon
Open https://antigravity.google.com/r/<instance-id>?p=c%2F<conversation-id> on another device to continue this conversation.

在筆電、平板或手機的瀏覽器中開啟此連結，使用你在 CLI 中使用的相同 Google 帳戶登入，接著便可透過 Antigravity 網頁介面繼續這個工作階段。

若要在不結束本機終端機工作階段的情況下停用通道：

/remote-control off

你也可以在啟動時使用旗標，讓 CLI 一開始就啟用 Remote Control：

agy --remote-control

互動模式與 agy 程序綁定：退出 CLI（/exit、Ctrl+C、Ctrl+D）或關閉終端機視窗時，Remote Control 通道會自動結束，工作階段項目也會從儀表板消失。每個互動式 CLI 程序都有自己的工作階段 ID 和主機名稱，因此你可以在數個終端機分頁或工作目錄中同時執行 agy --remote-control。

從瀏覽器連線至互動式 CLI 工作階段時，兩端會即時同步。遠端裝置送出的要求會直接傳到本機終端機，而代理程式的推理、工具呼叫和程式碼變更則會顯示在遠端介面中。如果代理程式暫停並要求確認（y/n）或提出後續問題，你可以用手機或本機終端機回覆。設定是例外：你無法透過遠端網頁介面變更設定，只能在 CLI 本身操作。

無頭守護程序：agy remote-control start

第二種模式是持續執行的背景守護程序，會註冊為作業系統服務。只要電腦開機並連上網際網路，就能使用此服務；登出和重新開機後的行為則依平台而異。

agy remote-control start

守護程序會註冊為作業系統服務（Linux 上為 systemd 使用者服務、macOS 上為 LaunchAgent，或 Windows 上為排程工作），並立即啟動，不需要開啟終端機視窗。

使用 agy remote-control status 查看項目名稱。接著在 Antigravity Remote Control Dashboard 選取這台電腦，並透過 Antigravity 網頁介面繼續操作。

以下三個命令可控制守護程序：

agy remote-control start     註冊並啟動守護程序
agy remote-control status    顯示守護程序狀態和執行個體名稱
agy remote-control stop      停止守護程序並取消註冊

守護程序會使用你登入 CLI 時所用的憑證。在同一台電腦上，登入 CLI 和登入 Antigravity 桌面編輯器是分開的；在瀏覽器中，請使用與 CLI 相同的 Google 帳戶。

你可以在啟動時使用 --name 旗標設定無頭守護程序的電腦名稱：

agy remote-control start --name "my-workstation"

再次使用新的值執行 start --name，即可重新命名電腦。

如果你沒有設定名稱，守護程序會在首次啟動時產生一個易記的名稱（例如 my-machine-distant-plume）；agy remote-control status 會顯示目前名稱。你也可以在設定檔中重新命名：在 Linux/macOS 上開啟 ~/.gemini/config/config.json，或在 Windows 上開啟 %USERPROFILE%\\.gemini\\config\\config.json，修改 cliRemoteControlHostname 的值、儲存檔案，再執行 agy remote-control start 重新啟動守護程序。服務重新啟動後，新名稱就會出現在儀表板上；守護程序執行期間，檔案變更不會生效。

檔案中有兩個相似欄位。cliRemoteControlHostname 是此處所說的 CLI 守護程序名稱。remoteControlHostname 則是同一台電腦上的 Antigravity 桌面編輯器所用的獨立欄位；在 Antigravity 2.0 中，你可以於 Settings → App 修改此值。

守護程序在登出和重新開機後的行為

行為依作業系統而異：

Windows 專屬細節

若要在系統開機時註冊守護程序以便自動啟動，必須以管理員身分執行。你可以使用 PowerShell 或一般命令提示字元。一般視窗也能執行 start 命令，但登出或重新開機後，守護程序只會在下次登入時恢復，不會在開機時啟動。使用一般視窗且不提升權限，也能執行 status 和 stop 命令。

要選擇哪種模式

互動模式足以讓你用手機管理目前的任務。如果你需要在沒有開啟終端機的情況下遠端存取，請依照作業系統條件使用無頭守護程序。

遇到連線問題時的處理方式#

官方說明文件中的問題與解決方式：

若要進行更深入的診斷，請查看守護程序記錄：Linux 上執行 journalctl --user -u antigravity-cli-daemon -n 50；macOS 上查看 ~/Library/Logs/antigravity-cli-daemon.log；Windows 上查看 %USERPROFILE%\\.gemini\\antigravity-cli\\log 中最新的 cli-*.log。

無頭守護程序可讓你在沒有開啟終端機時存取電腦，包括人在外出時；但仍須符合電腦和作業系統的執行條件。如果你不再需要持續存取，請用 agy remote-control stop 停止守護程序。

另有一篇介紹 Claude Code 中的遠端控制的文章。若要透過 Telegram 控制另一個代理程式，請參閱在 Telegram 中設定 Hermes Agent。

接下來#

如果你使用 CLI 並想暫時離開目前的任務，請先使用互動模式。保持終端機開啟：如果將它關閉，通道就會中斷，工作階段項目也會從儀表板消失。若要在沒有開啟終端機的情況下存取電腦，請依照作業系統限制使用守護程序。

更多資料請見 Ailoot。