安裝與登入
Antigravity CLI 原生支援 macOS、Linux 與 Windows，用一行指令就能安裝。本頁說明安裝、第一次啟動、三種登入方式，以及常見問題。
安裝
macOS 與 Linux
執行檔會放在 ~/.local/bin/agy。
Windows（PowerShell）
Windows（命令提示字元）
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows 的執行檔會放在 C:\Users\<使用者名稱>\AppData\Local\agy\bin。
安裝程式的選項
安裝程式提供兩個選項，多數人不需要用到：
| 選項 | 作用 |
|---|---|
--skip-aliases |
不清除 shell 設定檔中的舊別名 |
--skip-path |
不自動把 agy 加進 shell 設定檔的 PATH |
裝完後，開新的終端機視窗執行 agy。如果出現 command not found，代表安裝目錄還不在 PATH：macOS／Linux 請把 ~/.local/bin 加進 PATH，Windows 則加入上面的 agy\bin 目錄。
第一次啟動
在任一專案資料夾內輸入 agy。第一次會請你做三件事：
- 選擇色彩配置（color scheme）。
- 選擇顯示模式：Alt-Screen（全螢幕介面）或 Inline（接在終端機捲動內容之後）。
- 確認信任這個工作目錄（workspace trust），代理才會開始索引檔案。
如果機器上還留有 Gemini CLI 的設定，CLI 會偵測到並詢問要不要遷移，見 從 Gemini CLI 遷移。
登入方式
Google 帳號（預設）
在本機，CLI 會使用作業系統的安全金鑰圈（keyring）儲存憑證，並開啟瀏覽器讓你完成登入。透過 SSH 連線時，CLI 偵測到是遠端環境，會印出一組專屬授權網址，讓你在自己電腦的瀏覽器完成授權。
個人帳號只要有任何一種 Antigravity 方案（含免費）就能使用；企業帳號需啟用 Gemini Enterprise 或 Google Cloud 憑證。
Gemini API key
不想用 Google 帳號登入時，可以改用 API key：
- 編輯
~/.gemini/antigravity-cli/settings.json，把modelProvider設為gemini。 - 在環境變數設定
GEMINI_API_KEY。
自訂端點
要連到相容 Gemini 的其他伺服器，設定環境變數 GOOGLE_GEMINI_BASE_URL。
登出
在 CLI 的輸入框輸入 /logout，會清除已儲存的憑證。
檢查是否成功
啟動 agy 後看到輸入框、能輸入問題並收到回覆，就代表安裝與登入完成。想確認目前帳號可以用哪些模型，可以在終端機（不進入 TUI）執行：
推薦影音
簡述：繁體中文示範，同時在 Linux（Ubuntu）與 Windows（PowerShell）安裝 agy、設定 PATH，並示範用 Google Cloud 專案（GCP）完成驗證，適合無法直接使用個人 Google AI 方案的讀者。
安裝完成後，繼續看 第一次使用。