Antigravity 裝不起來？地區限制、CPU 架構與六種常見錯誤排查

「照著教學裝，結果它就是跑不起來。」

Antigravity 的安裝本身只有一行指令，所以出問題的時候特別讓人困惑，你什麼都沒做錯，但它就是不動。這篇把常見的失敗情況分成六類，每一類告訴你怎麼判斷、怎麼處理。

（正常流程請先看 Antigravity 安裝與設定完整指南與 CLI 安裝與設定教學。）

‼️ 資料來源：下面的指令與參數取自 Google Antigravity 官方文件（查證於 2026 年 7 月）。這個產品更新很快，執行前請對照你手上版本的官方文件，以實際輸出為準。

先確認你裝的是哪一個

Antigravity 現在有幾種形式，講「裝不起來」之前先確認你在裝的是哪個，因為問題完全不同：

情況一：下載頁面打不開，或顯示無法使用

這通常不是你的問題，是可用地區的限制。Google 的新產品在推出初期常常分批開放，不是所有國家同時能用。

怎麼判斷：如果下載頁面本身就打不開、或登入之後顯示帳號無法使用這項服務，而不是安裝過程失敗，那多半是這一類。

怎麼處理：去官方頁面確認目前開放的地區與方案，這個名單會變，而且變得很快，任何第三方文章寫的清單（包含這篇）都可能已經過期，一定要看官方最新公告。

‼️ 另外提醒：用 VPN 繞過地區限制去註冊，可能違反服務條款，帳號有被停用的風險。要用在正式工作上的工具，不建議這樣搞。

情況二：CPU 架構不對

現在的電腦分成兩種架構：傳統的 x64（Intel、AMD）和 ARM64（Apple Silicon 的 M 系列、部分 Windows 筆電）。下載錯版本，會出現「無法開啟」或閃退，而且錯誤訊息通常不會告訴你是架構問題。

怎麼確認你的機器是哪一種：

• Mac：左上角蘋果選單 → 關於這台 Mac，看晶片寫的是 Intel 還是 Apple M 系列。
• Windows：設定 → 系統 → 系統資訊，看「系統類型」。
• Linux：終端機打 uname -m，回 x86_64 是 x64，回 aarch64 是 ARM64。

用 CLI 的安裝腳本通常不用煩惱這個，因為腳本會自己偵測。會踩到架構問題的多半是手動下載安裝檔的人。

情況三：裝好了，但打指令說「找不到命令」

這是 CLI 最常見的問題，而且原因很單純：PATH 沒設好。

安裝腳本預設會幫你改 shell 設定檔，但有兩種情況會失效：

• 你用了 --skip-path 參數：那就要自己把 ~/.local/bin 加進 PATH。
• 你裝完沒有重開終端機：設定檔改了但目前這個 shell 還沒重新載入。關掉重開就好。

‼️ 一個很容易誤判的變形

互動式終端機裡打 agy 可以跑，但寫進腳本或排程就說找不到，這不是安裝失敗，是排程環境載入的設定檔跟你的登入 shell 不同，PATH 也就不一樣。

解法是在腳本裡用完整路徑，不要靠 PATH：把 agy ... 改成 /home/你的帳號/.local/bin/agy ... 就解決了。

情況四：授權卡住

本機的授權會自動開瀏覽器，通常沒問題。會卡住的是遠端主機或容器，那裡沒有瀏覽器。

官方對這種情況有設計：CLI 會印出一段授權網址，你複製到自己電腦的瀏覽器打開、登入後拿到一組英數代碼，貼回遠端終端機即可。

‼️ 要注意用互動模式連線（例如 docker run -it），背景模式看不到那段網址，你會以為它當掉了。詳細做法看 Antigravity 裝進 Docker 怎麼跑。

如果要換帳號或清掉登入狀態，用 /logout，它會中斷連線並把驗證資料從系統 keyring 移除。

情況五：裝起來了，但一直要你確認權限

這不是壞掉，是設計。代理人每次要執行指令都會問過你。覺得太吵的話有兩個方向：

• 用 /permissions 調整權限設定。
• 沙箱開啟時，確認框會提供「這個指令我信任」的選項，逐步把安全的操作放行。

不建議一開始就用 --dangerously-skip-permissions 全部跳過，這個參數的名字本身就是警告。取捨怎麼判斷看 Sandbox 模式該開不該開。

情況六：裝好也能跑，但很快就不能用了

這通常不是技術問題，是額度用完了。免費方案的額度有限，認真派工很快就會撞到上限。實際的額度機制與方案差異看 Antigravity 免費版夠用嗎。

一張排查順序表

結論

Antigravity 的安裝問題，八成落在三類：地區沒開放、架構下載錯、PATH 沒設好。這三個判斷完，剩下的多半是授權流程沒走對，而不是真的裝壞了。

我們自己也在做 AI 產品：Ocean Bot 業務助理、玄燈命理 DestineAI、PiMe AI 形象照，以及陪跑者 PACER 這個 AI 原生官網，都收在作品案例裡，可以看看落地之後實際長什麼樣。

如果你的公司想導入但卡在環境、權限或帳號配置，我們 AI 自動化開發可以幫你把這段走完。跟我們聊聊。