
用 AI 代理寫程式,常遇到一個麻煩是專案和執行環境其實放在另一台機器上,例如租來的 VPS、家裡的 Linux 主機或公司的開發機。以前要嘛把程式碼搬回自己電腦,要嘛在遠端裝 CLI 版從終端機操作。Google Antigravity 在 2026 年 11 月 17 日推出的 App 2.33.0 版,加入了「Connect over SSH」功能,App 可以直接透過 SSH 連到遠端 Linux 主機,讓專案、代理、Git worktree 和終端機都在主機上執行。
官方文件寫明,關掉視窗或讓筆電進入睡眠,主機上的代理會繼續工作,下次連回去再接上就好。不過這個功能對遠端主機有不少限制,最重要的一點是遠端只支援 64 位元 Linux,macOS 和 Windows 都不能當遠端主機。阿正老師這篇把需求、連線步驟和常見錯誤整理清楚,也提醒一下安全上要注意的地方。
文章目錄
一、Antigravity 的 SSH 連線是什麼?
Antigravity 是 Google 推出的 AI 代理開發平台,有桌面 App、CLI 和各家編輯器的延伸模組。這次的 SSH 功能只在 Antigravity App 上提供。連線時,App 會透過電腦上的 OpenSSH 自動在遠端主機安裝一個伺服器程式,之後專案、AI 代理、Git worktree、終端機和各種自訂設定都直接在主機上執行,本機的 App 只負責顯示和操作。
如果你平常習慣在終端機工作,官方也說明可以改在主機上安裝 Antigravity CLI,自己用 ssh 登入後使用。想了解 Windows 上的 CLI 操作,可參考站上的 Antigravity CLI 完全教學。

| 官方網站 | https://antigravity.google/ |
| 本站下載站版本 | 2.33.0(發布日期:2026-11-20) |
| SSH 功能所需版本 | Antigravity App 2.33.0 以上(2026 年 11 月 17 日推出) |
| 支援系統 | 本機 App:macOS、Windows、Linux;遠端主機:64 位元 Linux(x86_64 或 arm64) |
| 費用 | 未訂閱 Google AI Pro 或 Ultra 的個人帳號有每週更新的基本額度。Pro 和 Ultra 的額度較高。SSH 說明頁未標示方案限制 |
| SSH 支援的登入帳號 | 個人 Google 帳號、Google Workspace、Pay As You Go、Gemini Enterprise |
| 軟體下載 | [本站下載點]。若本站版號低於 SSH 功能需求,請到官方網站取得新版 |
二、SSH、Remote Control、Remote Agents 差在哪
Antigravity 現在有三種「遠端」用法,名稱很像,用途不同。官方文件整理的差異如下。
| 方式 | 代理在哪裡執行 | 從哪裡操作 | 主機端要準備什麼 |
|---|---|---|---|
| Connect over SSH | 你的遠端 Linux 主機 | Antigravity App | 不用另外安裝,App 透過 OpenSSH 自動設定 |
| Remote Control | 你自己的桌機或伺服器 | 網頁瀏覽器 | 安裝並登入 App 或 CLI |
| Remote Agents(Pro/Ultra) | Google 代管的環境 | App、CLI 或網頁瀏覽器 | 不用,附上程式庫或檔案即可 |
簡單分辨的方式是看「程式碼和代理放在哪」。專案在自己的 Linux 主機上,想用 App 介面操作,就用 SSH;人在外面想用手機或別台電腦的瀏覽器遙控家裡正在跑的 Antigravity,用 Remote Control;不想自己準備機器,交給 Google 的環境跑,才是 Remote Agents。家裡的電腦是 Mac mini 或 Windows 的讀者,因為不能當 SSH 遠端主機,想遠端操作時要改用 Remote Control。
三、使用前檢查:本機與遠端主機需求
連線前,先依官方文件逐項確認本機與遠端主機的需求。
| 本機電腦 | Antigravity App 2.33.0 以上(macOS、Windows 或 Linux),並安裝 OpenSSH(PATH 裡找得到 ssh 或 ssh.exe,或用環境變數 ANTIGRAVITY_SSH_BIN 指定) |
| 遠端作業系統 | 64 位元 Linux(x86_64 或 arm64),glibc 2.26 以上,例如 Ubuntu 18.04、Debian 10、RHEL 8 以後。macOS、Windows 與使用 musl 的 Linux(例如 Alpine)不支援 |
| SSH 連接埠轉送 | 主機(以及經過的跳板主機)的 sshd_config 要允許 AllowTcpForwarding yes(或 local) |
| 儲存空間與網路 | 主機能連外 HTTPS;家目錄可寫入、可執行,伺服器裝在 ~/.antigravity-hub-server/,代理資料放在 ~/.gemini/ |
四、連線步驟:從 App 連到 SSH 主機
確認需求後,在 Antigravity App 裡依下面四步連線。官方提供三種開啟 SSH 對話框的方式,挑一種習慣的就好。
Step 1|開啟 SSH 對話框 三種方式任選其一。側邊欄(Software Engineering 版面)點 Projects 旁的 Create New Project,選 SSH Host…;或按 Cmd+Shift+P(macOS)/Ctrl+Shift+P(Windows、Linux)開命令面板,執行 Connect to SSH Host…;也可以用參數 --ssh-host=<主機> 啟動 App。
Step 2|選擇或輸入主機 清單會列出最近連過的主機(Recent)和 ~/.ssh/config 裡設定的主機(SSH Config)。也可以直接輸入主機別名、[使用者@]主機[:埠號] 或 ssh://[使用者@]主機[:埠號]。要用另一份設定檔,點 Choose File…。
Step 3|連線並驗證 按 Connect。Antigravity 會自動使用你的 OpenSSH 金鑰、ssh-agent 和 ProxyJump 設定。在 macOS 和 Linux 上,主機金鑰確認、金鑰密語、密碼、兩步驟驗證碼和安全金鑰觸碰都會在 App 裡提示;Windows 如果沒有跳出這些提示,官方建議先把金鑰載入 ssh-agent,並在終端機手動執行一次 ssh 主機,讓 known_hosts 記錄主機。
Step 4|登入 Antigravity 帳號 標題列顯示「(SSH: 主機)」的新視窗開啟後,依提示登入。登入流程在本機瀏覽器完成,憑證會存到遠端主機上。
常用的主機建議先寫進 ~/.ssh/config,之後在清單裡直接點選即可。官方文件的範例格式如下(以下 IP 為文件用的範例位址,請換成自己的主機資料)。
Host devbox HostName 203.0.113.10 User alice Port 22 IdentityFile ~/.ssh/id_ed25519 ProxyJump jump.example.com
寫了具體名稱的 Host(不含 *、?、! 萬用字元)才會出現在 SSH Config 清單裡;像 Host * 這種萬用規則連線時仍會套用。另外,Antigravity 會在連線指令上強制關閉 ForwardAgent、ForwardX11、ControlMaster 等設定,所以 config 裡這幾項不會生效。
五、SSH 視窗裡能做什麼、哪些功能不一樣
每台主機會開在獨立視窗,標題列和側邊欄底部都會標示「SSH: 主機」。在這個視窗裡,建立專案時瀏覽的是遠端的檔案系統;代理的工具、終端機、沙盒與權限設定也都在主機上執行。Skills、規則、hooks、MCP 伺服器與外掛,則從主機上的 ~/.gemini/ 和專案資料夾載入。
跟本機視窗相比,下面幾個功能不一樣。
- 內建瀏覽器 側邊的瀏覽器面板不會出現,網址會用本機的預設瀏覽器開啟。/browser 指令連的是遠端主機上開啟遠端偵錯的 Chrome。
- 語音與媒體 語音模式和聽寫會詢問是否允許主機使用麥克風,鏡頭與螢幕存取維持停用。
- 本機檔案動作 「在 IDE 中開啟」「在 Finder(或檔案總管)中顯示」等本機操作會隱藏。
斷線或關閉視窗後,主機上的代理會不會停,官方整理如下表。
| 動作 | 視窗與 SSH 通道 | 主機上的伺服器與代理 |
|---|---|---|
| 關閉視窗 | 關閉並中斷 SSH | 繼續執行,隨時可以連回去 |
| 筆電睡眠或網路中斷 | 自動重試,或手動按 Reconnect | 繼續執行,恢復連線後接回 |
| 重新啟動或更新 App | 重新開啟 SSH 視窗並連線;如果要更新忙碌中的遠端伺服器,App 會先詢問 Restart 或 Later | 除非為了更新而重啟,否則繼續執行 |
| 執行 Stop SSH Server… | 關閉並中斷 SSH | 停止主機上的代理與伺服器 |
想回到本機工作又不想斷線,點側邊欄的「SSH: 主機」選 This Computer,或從命令面板執行 Switch to This Computer。
六、常見錯誤碼與解法
連線失敗時,點通知上的 Show Details 可以看到錯誤碼。主機端的伺服器紀錄放在 ~/.antigravity-hub-server/data/ 底下的 ls-*.log。官方列出的常見錯誤整理如下。
| 錯誤碼 | 原因 | 處理方式 |
|---|---|---|
| AUTH_FAILED | SSH 驗證失敗 | 先在終端機測試 ssh 主機,檢查 IdentityFile 或用 ssh-add -l 確認金鑰 |
| HOSTKEY_REJECTED | known_hosts 缺少或與主機金鑰不符 | 先向管理者核對主機金鑰指紋。確認是預期的金鑰變更後,再用 ssh-keygen -R 主機移除舊紀錄並重新驗證 |
| FORWARDING_PROHIBITED | 主機關閉了連接埠轉送 | 請目標主機與跳板主機的管理者確認 sshd_config 是否允許 AllowTcpForwarding yes 或 local |
| UNSUPPORTED_HOST | 主機不是 64 位元 Linux、glibc 太舊或使用 musl | 換成符合需求的 Linux 主機 |
| CONNECTION_FAILED/CONNECTION_CLOSED | 找不到 ssh 程式、主機連不到或通道中斷 | 檢查 ssh -V、ssh 主機,再按 Reconnect |
| INSTALL_FAILED | 遠端伺服器安裝失敗 | 用 df -h ~ 檢查空間、確認家目錄不是 noexec,並讓 ~/.bashrc 在非互動模式下不輸出文字 |
| SSH_CONFIG_INVALID | 設定檔有錯、權限不安全或編碼不對 | 修正提示的那一行;自訂設定檔在 macOS、Linux 上用 chmod 600 |
官方文件另外列了 INVALID_DESTINATION(主機格式錯誤)、SHARED_HOME_UNSUPPORTED(另一台共用同一個網路家目錄的主機已在執行遠端伺服器)、LS_START_FAILED 等錯誤碼,遇到時可以到官方〈Connect over SSH〉頁面的 Troubleshooting 段落查詢。
七、安全提醒與移除方式
透過 SSH 連線後,AI 代理執行的指令會直接作用在遠端主機上,而且關掉視窗後代理還會繼續跑。阿正老師建議注意以下幾點。
- 先用測試機或不含正式資料的主機熟悉操作,不要一開始就連正式環境的伺服器。
- 確認 Antigravity 的權限與終端機沙盒設定,需要時讓代理在執行指令前先徵求同意。
- 用完確定不再需要代理運作時,執行 Stop SSH Server… 停止主機上的伺服器與代理,不要只關視窗。
- 登入憑證會存在遠端主機上,多人共用的主機要特別留意帳號權限。
如果之後不想用了,官方說明的移除方式是先執行 Stop SSH Server…,再刪除主機上的 ~/.antigravity-hub-server 資料夾;要連同儲存的對話和設定一起刪掉,再刪除 ~/.gemini。
⚠️ ~/.gemini 也可能存放同一台主機上 Antigravity CLI 的設定與資料,刪除前先確認裡面沒有還要用的內容。
八、阿正老師的總結
專案放在自己的 Linux 主機或 VPS,想用 App 介面讓 AI 代理工作
→ Connect over SSH。App 更新到 2.33.0 以上,連線前確認遠端主機和 SSH 設定符合需求。
家裡是 Mac 或 Windows 電腦,人在外面想遙控
→ Remote Control。這兩種系統不能當 SSH 遠端主機,改用瀏覽器遙控。
習慣在終端機裡工作
→ 在主機上裝 Antigravity CLI,自己 ssh 登入使用即可。
想多了解 Antigravity 目前的模型與分工方式,可以接著看站上的 Gemini Orchestrator 教學;同時用 Antigravity、Claude Code、Codex 的讀者,也可以參考 T3 Code 介紹。
小結:先確認主機是 64 位元 Linux,再談遠端開發
Antigravity 的 SSH 連線讓程式碼和代理留在主機上,本機只負責操作,關閉 App 的 SSH 視窗或讓本機進入睡眠時,遠端主機上正在執行的代理會繼續工作。連線前請參考第三節,確認遠端系統和連接埠轉送設定。也別忘了,代理在主機上執行的每個指令都是真的,權限設定要先想清楚。
你會把 Antigravity 連到哪一台主機上用呢?歡迎在下面留言跟阿正老師分享!









