LEARN · ARTICLE

用 Google Antigravity CLI 免費跑 Gemini

發布 2026-11-09更新 2026-11-09作者 Rock Lee

作者：Rock Lee 實測日期：2026-11-09（Asia/Taipei）

為什麼寫這篇

終端機裡直接叫模型做雜活很方便，但很多人卡在「要不要先申請 GEMINI_API_KEY」。我這台機器上裝的是 Google Antigravity CLI（指令 agy）：在已經用個人 Google 帳號登入的前提下，可以指定 Gemini 3.8 Flash 做單次 --print 呼叫，走帳號登入額度，不是環境變數裡的 GEMINI_API_KEY。

邊界：這不是「完全免費、額度無限」。本次只確認登入後能跑通 Flash；精確每日上限我沒從 CLI 測出來，請以後台為準。

終端機裡的 agy 透過你登入的 Google 帳號呼叫雲端模型（示意圖，AI 生成）

實測環境

項目	本機實測值
二進位	安裝在使用者目錄的 `agy`（`which agy` 可找到）
版本	`1.5.3`（`agy --version`）
登入	已用個人 Google 帳號登入（不公開帳號或 token）
雜活模型	`gemini-3.8-flash-low`

步驟

1. 確認指令與版本

which agy
agy --version

預期版本字串為 1.5.3。若找不到，檢查使用者目錄下的 bin 是否在 PATH。

2. 列出模型

agy models

確認清單裡有 gemini-3.8-flash-low。名單會隨帳號／產品更新，以你機器當下輸出為準。

3. 看 print 相關參數

雜活常用：-p／--print、--model、--print-timeout、--disable-slash-commands、--output-format。

4. 跑一則單次提示

agy --model gemini-3.8-flash-low   --print-timeout 120s   --disable-slash-commands   -p "用繁體中文一句話回答：你是哪個模型？然後用兩行列出你能做的兩件實用小事。不要使用任何工具、不要讀檔、不要建立檔案。"

同一天最短 ping：

agy --model gemini-3.8-flash-low --print-timeout 60s --disable-slash-commands -p "只回覆四個字：測試成功"

5. 問模型自己的常見限制（參考）

另跑一則請它列出執行限制（仍是 print、不用工具）。回覆提到逾時／沙盒、讀寫上限、受保護網頁不易抓——當作操作提醒，不是官方 SLA。

結果

樣本一 exit code 0；樣本二亦 0。解讀：

已 Google 登入時，不必設 GEMINI_API_KEY 也能呼叫 Flash。
--print 適合腳本化；AI 初稿仍須人工核對。
CLI id gemini-3.8-flash-low 與模型自稱「Gemini 3.8 Flash」對應即可。

耗時會隨網路變化；請用自己的 time 測量，不寫成官方 SLA。

和「開 IDE 代理」的差別

agy 也可進較長代理工作階段（可能讀檔、改檔）。本篇只示範 `--print` 單次問答，較好控制「不要讀憑證、不要亂寫檔」。

踩坑紀錄

忘記 --print-timeout。
提示裡有 / 卻沒加 --disable-slash-commands。
把密鑰貼進 -p。
習慣性開 --dangerously-skip-permissions。
能跑通 ≠ 知道今日剩餘額度。

常見問題

Q1：一定要 `GEMINI_API_KEY` 嗎？ 本次已登入時呼叫 Flash 不需要；其他方案未測。 Q2：這算免費嗎？ 有登入額度可用，但不是永久免費無限保證。 Q3：可以改用其他模型嗎？ agy models 有列出；本篇只實測 Flash low。 Q4：怎麼安裝？ 跟官方文件；不要來路不明的 curl | bash。

複製這段給你的 AI agent

目標：在已安裝 Google Antigravity CLI（agy）且已完成人類 Google 登入的機器上，用 Gemini Flash 跑一則唯讀雜活。

前提：
- 指令名稱：agy（若 PATH 沒有，先 which agy；不要擅自下載不明二進位）。
- 禁止讀取或輸出任何憑證、oauth token、API key、密碼檔。
- 禁止破壞性指令（刪除系統目錄、格式化、亂改 SSH 設定等）。
- 不要把使用者的帳號或 token 寫進回報。

步驟：
1. 執行：agy --version ；記錄版本字串。
2. 執行：agy models ；確認模型 id（雜活優先 gemini-3.8-flash-low）。
3. 執行：
   agy --model gemini-3.8-flash-low --print-timeout 120s --disable-slash-commands -p "<任務：只回答問題，不要用工具、不要寫檔>"
4. 把 stdout 與 exit code 回報給人類；若非 0，附上錯誤摘要（遮罩密鑰）。

驗收：有版本號、有模型清單摘錄、有一次成功的 print 回覆；回報中無任何密鑰字串。

安全：付款、帳號綁定、瀏覽器登入步驟留給人類。