← 回 AUTOMOVIE 操作手冊

🤖 Antigravity CLI (agy) 安裝與認證指南

Windows 11 下安裝 Google 的終端 AI 代理工具 Antigravity CLI， 並設定成 AUTOMOVIE 可以呼叫的樣子。以下步驟已在本機實際安裝並驗證指令可正常執行。

關於這份指南的誠實聲明 以下「安裝」與「呼叫測試」的部分是在本機實際執行並確認成功的（版本 1.1.9）。 但「登入認證」畫面的部分，因為本機已經是登入狀態，沒有刻意登出重新測試整個流程 （這樣做會影響到本機正在使用中的環境），所以認證步驟是依據 CLI 的一般行為模式描述， 若實際畫面跟這裡描述的不完全一樣，請以畫面上的指示或 官方文件為準。

1安裝

Windows 11 內建 winget，開啟 PowerShell（不用系統管理員權限）執行：

winget install Google.AntigravityCLI

安裝完成後關閉再重新開啟一個新的終端機視窗（讓 PATH 生效），確認安裝成功：

agy --version

正常會顯示版本號，例如 1.1.9。

找不到 agy 指令？ winget 安裝完會把執行檔放在 %LOCALAPPDATA%\Microsoft\WinGet\Packages\Google.AntigravityCLI_...\agy.exe， 通常會自動加進 PATH。如果新開的終端機還是抓不到指令，執行 agy install 可以手動重新設定 PATH。

2登入認證

Antigravity CLI 目前沒有獨立的 agy login 或 agy auth 子指令（截至 1.1.9 版）。認證是跟 Google 帳號綁定的， 一般這類工具的認證方式是：

  1. 第一次執行任何指令時（例如互動模式 agy 或非互動模式 agy -p "你好"），CLI 偵測到尚未登入，會自動開啟瀏覽器導向 Google 帳號登入頁面
  2. 在瀏覽器裡用你的 Google 帳號完成登入、授權
  3. 授權完成後回到終端機，CLI 會顯示登入成功，之後的指令就不會再要求登入

認證狀態與相關設定會存在使用者資料夾底下（本機實測觀察到的路徑，僅供參考， 不同版本可能調整）： 

%USERPROFILE%\.antigravity\
%USERPROFILE%\.gemini\antigravity-cli\
%USERPROFILE%\.gemini\antigravity\
如果沒有自動跳出瀏覽器 請直接查看終端機輸出的文字，通常會印出一個登入用的網址，複製貼到瀏覽器手動開啟即可。 若仍無法登入，以 官方文件 或 官方支援頁 的最新說明為準。

3驗證能不能正常讀圖回答

登入完成後，用一張隨便的圖片測試非互動模式（-p 是 --print 的縮寫）：

agy -p "描述這張圖片的內容: C:\path\to\image.jpg"

如果 agy 提示需要權限才能讀取檔案，代表 headless／非互動模式下， 需要讀檔案這類動作預設會被擋下（沒有畫面可以互動確認）， 這時候加上 --dangerously-skip-permissions 讓它自動放行： 

agy -p "描述這張圖片的內容: C:\path\to\image.jpg" --dangerously-skip-permissions
這個旗標安全嗎？ --dangerously-skip-permissions 會讓 agy 自動放行所有工具權限請求， 範圍比「只允許讀檔」更廣。在 AUTOMOVIE 裡使用是可接受的，因為程式固定只會叫它 「讀一張截圖、描述內容」這一種操作，不會給它任意指令。若你要在其他場景手動使用 agy， 請自行評估這個旗標的風險。

4填進 AUTOMOVIE

回到 AUTOMOVIE 的「設定（AI CLI）」區塊，有兩種方式：

  1. 按「🔍 自動偵測我電腦上裝了什麼」，找到 Antigravity CLI 後按「使用這個」 ——已經是驗證過能用的完整指令，直接套用即可
  2. 或手動填入「AI 指令模板」欄位： 
    agy -p "{prompt} 圖片路徑: {image}" --dangerously-skip-permissions

填好後按「測試」，會用一張內建的範例截圖實際呼叫一次，確認整條路徑真的通。