為什麼「Antigravity 2.0 CLI」在終端機特別容易逾時或連不上

2026 年 5 月 19 至 20 日 Google I/O 上,Google 正式推出 Google Antigravity 2.0——這不是舊版 Gemini CLI 的小改版,而是一套獨立的 Agent 平台:包含可並行編排多個 Agent 的桌面應用、以 Go 重寫的 Antigravity CLI、Antigravity SDK,以及透過 Gemini API 提供的 Managed Agents。底層模型換成專為 Agent 工作流優化的 Gemini 3.5 Flash,官方也明確引導原 Gemini CLI 用戶在 2026 年 6 月 18 日前遷移至 Antigravity CLI。對剛在 I/O 後搶先試用的開發者來說,最惱人的往往不是功能本身,而是終端機裡 Agent 指令長時間無回應間歇性逾時,或 OAuth 登入流程卡在「等待瀏覽器授權」卻一直轉圈。

與單純呼叫 generativelanguage.googleapis.com 的 Gemini CLI 相比,Antigravity 生態的連線面更廣:安裝腳本來自 antigravity.google,CLI 透過系統金鑰圈或 Google Sign-In 做授權時會觸及 accounts.google.comoauth2.googleapis.com;實際推理與工具呼叫則走 Gemini API 各端點;桌面版與 CLI 共用同一套 Agent Harness,意味著背景同步、插件下載也可能打到其他 *.googleapis.com*.gstatic.com 子網域。只要其中任意一段在 Clash 規則裡被送回 DIRECT(直連),或 Go 版 CLI 的子行程沒有讀到 HTTPS_PROXY,你在 TUI 裡看到的就會是 Managed Agent 啟動失敗、子 Agent 無回應,或是看似與網路無關的 TLS/憑證錯誤。

本篇切入角度是「新 CLI 代理排錯」,而非重複舊 Gemini CLI 教程:當你使用 Clash Verge Rev(Mihomo/Clash.Meta 系)時,最有效的起手式不是立刻開全域 TUN,而是先用分流規則把 Antigravity 與 Google AI 相關主機穩定導向可信的代理策略群組,再在必要時補齊終端機環境變數——這也是標題裡「分流規則與環境變數實測」真正在意的事情。

I/O 2026 背景:Antigravity 2.0 與 Gemini CLI 遷移須知

在動手改代理之前,先釐清平台邊界,避免把「舊 Gemini CLI 設定」原封不動套在新平台上卻漏掉新增網域:

  • Antigravity 2.0 桌面版:Agent Manager 型 GUI,可並行編排多個 Agent、spawn 子 Agent,適合本機工作區重度編排;與獨立下載的 Antigravity IDE(含 VS Code 式編輯器與 SSH/WSL)是不同安裝包,請以 antigravity.google/download 確認你裝的是哪一種。
  • Antigravity CLI:鍵盤優先的 TUI,與桌面版共用同一 Agent Engine;安裝指令為 curl -fsSL https://antigravity.google/cli/install.sh | bash(Windows 用 PowerShell 版)。遠端 SSH 環境下授權會改為印出 URL 在本機瀏覽器完成,這條路徑同樣受代理影響。
  • Managed Agents(Gemini API):透過 Interactions API 一次呼叫即可在隔離 Linux 環境中啟動具推理、工具呼叫能力的 Agent,Powered by Gemini 3.5 Flash;本機 SDK 發起的控制面請求仍需穩定連線 Gemini API
  • Gemini CLI 停服時程:2026 年 6 月 18 日起,面向 Google AI Pro/Ultra 免費用戶的 Gemini CLI 將停止服務;企業版 Gemini Code Assist 授權用戶仍可繼續使用 Gemini CLI,但官方已將主力轉向 Antigravity 生態。

若你從 Gemini CLI 遷移過來,HTTPS_PROXY 與 Clash 規則的大方向通常可沿用;但請務必在遷移後重新觀察連線紀錄,因為 Antigravity 會新增 antigravity.google 等主機,Managed Agents 也可能觸發更多 API 子路徑。

規則分流與全域 TUN:什麼時候用哪一種

先把責任切開:代理分流回答「這個目的地網域要走哪個策略」;系統代理/TUN回答「有多少比例的連線會真的進到 Clash」。在 Clash Verge Rev 的日常使用中,多數開發者會先開啟系統 Proxy,讓支援系統設定的程式自動把 HTTP 流量送到本機 mixed-port;只有在規則怎麼改都像沒命中、或連線列表完全看不到 Antigravity 相關請求時,才把TUN 模式當成「放大鏡」來驗證路由層行為,而不是預設開到底。

模式 優點 風險/成本 較適合的訊號
規則分流+系統代理 精準、對本機服務影響較小;便於把設定片段貼進團隊文件 需維護網域清單與順序;Go CLI 不吃系統 Proxy 時要另外 export 連線紀錄已有請求,但策略欄位顯示 DIRECT
全域 TUN 能涵蓋更多忽略環境變數的底層連線;利於 A/B 對照 與公司 VPN、零信任客戶端或其他路由程式並存時較易打架 規則看似正確,但 Antigravity CLI 子行程仍從意外出口離開
僅手動環境變數 對單一倉庫或一次性指令能快速試錯 在多個終端機分頁、IDE 與背景工作中容易漂移 你已確認只有某條 Antigravity 指令需要硬指定 Proxy

實務判斷可以很機械:連線清單完全沒有 Antigravity/Google API 相關條目 ⟶ 先檢查系統代理開關與埠號;清單條目但策略錯誤 ⟶ 先調規則集順序;策略正確但延遲或逾時仍頻繁 ⟶ 再往節點品質、IPv6 雙棧、Gemini 3.5 Flash 遠端限流方向查。

小提示:Antigravity CLI 以 Go 撰寫,對 HTTPS_PROXY 的支援通常優於部分 Node 系 CLI,但仍可能因 TUI 子行程或 SSH 遠端登入流程而略過系統 Proxy。請以連線紀錄為準,而非假設「Go 程式一定自動走代理」。

開始改設定前請先對齊的三個事實

想把「改了 YAML 卻完全沒反應」機率壓低,請先確認:

  • 目前生效的是哪一份設定檔?Verge Rev 常有訂閱合併檔、本機覆寫與「啟用中」設定並存;請在 UI 確認你編輯的那份已被載入與套用。
  • mixed-port 是否與 HTTPS_PROXY/IDE 設定一致:升級或還原備份後埠號變更是常見陷阱;Antigravity CLI 安裝腳本本身也需要能連上 antigravity.google,若安裝階段就失敗,請先排除代理再談執行期逾時。
  • 是否有第二套 VPN/零信任/安全軟體同時改寫路由:Antigravity 2.0 桌面版與 CLI 可能同時在背景同步設定;兩套程式搶路由時,連線紀錄可能在 Clash 端看似正常,封包卻在另一層被攔截。

第一步:用連線紀錄定位「是哪個 Antigravity/Google 主機在直連」

打開 Clash Verge Rev 的即時連線檢視,在另一個終端機視窗重現一次會失敗的 Antigravity CLI 操作(例如觸發 Agent 推理、OAuth 登入或 Managed Agent API 呼叫)。當錯誤訊息出現或 TUI 長時間卡住時,立刻在列表中以關鍵字過濾:

  • antigravity.google:CLI 安裝、更新、文件與部分產品頁面;I/O 2026 後新用戶首次 curl | bash 安裝時若直連失敗,連 CLI 都裝不上。
  • generativelanguage.googleapis.comGemini API(Generative Language API)的典型主機;Antigravity Agent 推理與 Managed Agents 控制面常經此端點。
  • oauth2.googleapis.comaccounts.google.com:Antigravity CLI 的 Google Sign-In 與金鑰圈回退授權流程;SSH 遠端模式下需在另一台機器開瀏覽器,兩端網路都要通。
  • ai.google.devaistudio.google.com:若你在 Google AI Studio 測 Managed Agents 後回到 CLI,可能出現額外 API 閘道連線。
  • gstatic.comgoogleusercontent.com:靜態資源或使用者內容;以連線清單中反覆出現的紀錄為準決定是否納入白名單。

若條目顯示 DIRECT,但它明顯是你希望走海外出口的低延遲連線,請把辨識出的完整主機名稱或可靠後綴記下來。若列表裡完全沒有這類條目,請優先懷疑請求沒進 Clash:回到系統代理開關、Go CLI 是否略過本機 Proxy,再決定要不要暫時啟用 TUN 做對照。

第二步:把 Antigravity 與 Gemini API 相關後綴接到正確的策略群組

下方片段僅為結構示意,請將 PROXY-GROUP-YOU-USE替換為你設定檔內實際存在的策略群組名稱,並將整段放在會一次吃掉大型 CDN、雲端供應商或區域直連的規則集之前

# Example — replace PROXY-GROUP-YOU-USE; keep above broad DIRECT / CN rule-sets
DOMAIN-SUFFIX,antigravity.google,PROXY-GROUP-YOU-USE
DOMAIN-SUFFIX,generativelanguage.googleapis.com,PROXY-GROUP-YOU-USE
DOMAIN-SUFFIX,googleapis.com,PROXY-GROUP-YOU-USE
DOMAIN-SUFFIX,google.ai,PROXY-GROUP-YOU-USE
DOMAIN-SUFFIX,ai.google.dev,PROXY-GROUP-YOU-USE
DOMAIN-SUFFIX,accounts.google.com,PROXY-GROUP-YOU-USE
DOMAIN-SUFFIX,oauth2.googleapis.com,PROXY-GROUP-YOU-USE
# Append DOMAIN-SUFFIX lines you observe in Verge Rev connection list

為什麼把 antigravity.google放在最前面?因為這是 Antigravity 2.0 生態的專屬網域,舊 Gemini CLI 規則集裡往往沒有;若你只複製上一份「Gemini CLI 代理教程」的 YAML 而沒補這行,可能出現「API 通了但 CLI 裝不上或無法檢查更新」的詭異組合。確認 Antigravity CLI 穩定後,再依連線紀錄縮窄 googleapis.com 的匹配範圍,避免拖慢不相關 Google 服務。

若你使用上游維護的 RULE-SET,請特別檢查是否含有把通用雲端 IP 段或 GEOIP 規則放在很前面的版本;開發者 API 類服務最常卡在「粗大規則先匹配」。解法通常是上移精確 DOMAIN-SUFFIX,而不是盲目刪除整套訂閱。

合規提醒:請在遵守所在地法規以及你與 Google/所用服務供應方條款前提下使用本文流程;下列內容僅描述常見網路排錯方法,不包含規避監管、濫用 API 配額或未經授權存取的意圖。

第三步:HTTPS_PROXYALL_PROXY 應該寫在哪

「環境變數寫在哪」等同於在問:是哪個父行程啟動了正在跑 Antigravity CLI 的那個 shell?常見情境如下:

  • macOS/Linux 互動式 zsh/bash:export HTTPS_PROXY=http://127.0.0.1:<mixed-port>寫進 ~/.zshrc~/.bashrc;Antigravity CLI 的 TUI 會在該 shell 下啟動,修改後請新開終端機分頁再試。
  • SSH 遠端開發:遠端機器上的 Antigravity CLI 需能連 Google API;若授權 URL 要在本機瀏覽器開啟,請確認遠端與本機兩端的代理策略各自覆蓋對應網域,不要只配一邊。
  • IDE 內建終端:Antigravity IDE 或 VS Code 式環境的整合終端可能繼承 GUI 行程環境而非登入 shell;可在 IDE 設定中加入啟動前 export,或用 wrapper 腳本先設定再啟動 CLI。
  • Windows PowerShell:可用 $env:HTTPS_PROXY="http://127.0.0.1:埠"做單次驗證,確認無誤後再寫入使用者環境變數;PowerShell 版安裝腳本 irm https://antigravity.google/cli/install.ps1 | iex 同樣受影響。

實務上我會以 NO_PROXY保留 127.0.0.1,localhost,::1與公司內部網段,避免把內部 Git、套件倉庫誤送往海外節點;Antigravity Agent 若需在本機執行工具命令,本機迴環位址必須維持直連。

瀏覽 Clash/Mihomo 各桌面用戶端下載聚合

第四步:Managed Agents 與 Gemini 3.5 Flash 的額外連線考量

若你不只跑 Antigravity CLI TUI,還透過 SDK 或腳本呼叫 Gemini API 的 Managed Agents(Interactions API),連線模式會多一層:

  • 控制面請求:建立 Agent、下達指令、輪詢狀態——這些 HTTPS 請求從你的本機或 CI 環境發出,必須確保 generativelanguage.googleapis.com 等端點走穩定出口;這與 CLI 排錯邏輯相同。
  • 執行面(隔離環境):Agent 在 Google Cloud 隔離 Linux 中跑程式碼時,運算本身不經你的 Clash;但若回傳結果或 webhook 需連回你本機服務,請確認 NO_PROXY與防火牆規則不會誤攔。
  • Gemini 3.5 Flash 高吞吐:官方在 Antigravity 內宣稱可達極高 token/秒速率;這意味著單次 Agent 任務可能產生更密集、更長時間的 API 連線。若節點對長連線或 HTTP/2 不友善,錯誤常以「Agent 逾時」而非明確代理錯誤呈現——此時先換節點再懷疑規則。

第五步:用 curl 與實際 Antigravity CLI 做最短驗證迴圈

調整規則與環境變數後,建議依序進行:

  1. 使用 curl -v並透過 --proxy http://127.0.0.1:<mixed-port>https://antigravity.googlehttps://generativelanguage.googleapis.com不含 API 金鑰的連線探測,確認 TLS 與路由鏈路暢通。
  2. 撤除 --proxy,在「與平常相同」的 shell 環境下重跑;若此次失敗而前一步成功,代表 Antigravity CLI 或其相依程式沒有吃到系統 Proxy/環境變數,應回到上一節調整啟動脈絡。
  3. 執行會實際觸發 Gemini 3.5 Flash 推理的 Antigravity CLI 指令(例如會修改多檔案的 Agent 任務),邊觀察 Verge Rev 連線清單的策略欄位;若策略正確但延遲仍高,再切換節點或檢查 IPv6 相容性。
  4. 若使用 Managed Agents SDK,以最小範例腳本呼叫 Interactions API,確認控制面與 CLI 走同一套代理設定。

這個迴圈能把問題從模糊的「Antigravity 不穩」拆成可描述分支:代理鏈故障、antigravity.google 漏網、環境脈絡錯誤,或純粹遠端限流與節點品質。

第六步:訂閱品質與節點型態如何放大「逾時感」

即使規則與環境變數都對了,下列因素仍會讓 Antigravity Agent「感覺一直在逾時」:

  • 多 Agent 並行:Antigravity 2.0 桌面版可同時跑多個 Agent,CLI 也可 spawn 子 Agent;並行 HTTPS 連線對節點穩定性要求更高。
  • 長連線與串流:Gemini 3.5 Flash 的高吞吐推理可能維持較長的 HTTP 連線;部分節點對此類流量不友善。
  • IPv6 與雙棧:部分網路會讓 AAAA 記錄走不同出口;值得暫時觀察 IPv6 行為與實際命中策略。
  • 時間不同步:OAuth 與 API 金鑰驗證對時鐘敏感;虛擬機與 WSL 切換後尤應先校時。

仍未解時可再對照的快速清單

  • 連線紀錄完全沒有 Antigravity/Google API 網域:優先檢查系統代理開關、mixed-port、Go CLI 是否內建忽略 Proxy。
  • 能裝 CLI 但 Agent 呼叫逾時:檢查 generativelanguage.googleapis.com 是否 DIRECT;Gemini CLI 舊規則可能缺 antigravity.google 但 API 規則已存在——兩者要分開驗。
  • 桌面版正常、CLI 異常:桌面 GUI 可能走不同網路堆疊;對 CLI 單獨 export HTTPS_PROXY 後再試。
  • SSH 遠端授權失敗:確認遠端能連 accounts.google.com,本機能開授權 URL;兩端代理策略需各自覆蓋。
  • 只有在特定節點出問題:先更換後端再談規則,避免把節點故障誤判成 YAML 錯誤。

為什麼 Antigravity 2.0 場景下,Clash 生態比封閉加速器更好收斂

Google 在 I/O 2026 把 Antigravity 做成跨桌面、CLI、SDK 與 Gemini API 的完整平台,網域與端點會隨版本快速迭代——今天新增 antigravity.google,明天 Managed Agents 可能再開新子路徑。許多「一鍵加速」類工具把應用清單寫死在自家程式裡,當 Google 調整基礎設施時,你只能等待更新;對需要頻繁呼叫 Gemini API、同時還得連公司內網的 Agent 工作流來說,這種黑箱會放大不確定性。

Clash搭配 Clash Verge RevMihomo核心,讓你能用同一套可版控的設定,在「看得到連線紀錄」的前提下迭代代理分流規則,並用 HTTPS_PROXY精準補強 Antigravity CLI 的終端脈絡——當 Gemini 3.5 Flash 或 Antigravity 2.0 再推新版本時,多半是調整幾行規則就能跟上,而不是整套重裝。相較把全部網路行為押在全域 TUN,強調規則與環境變數並用的作法,對長時間開著代理寫程式、並行跑多個 Managed Agent 的人通常更省力:對外 API 走穩定出口,內網與本機測試維持直連,問題發生時也更容易還原真實路徑。

立即免費下載 Clash,為 Antigravity 2.0 CLI 與 Gemini API 建立可複製的代理設定 →