跳到正文

Antigravity CLI

用 Gemini API Key 和自訂 Base URL,把 Google Antigravity CLI(agy)連到 HopBase 的 Gemini 原生介面。

Antigravity CLI(指令 agy)是 Google 的終端機程式設計代理。它支援用 Gemini API Key 登入並改寫 Base URL,直接使用 Gemini 原生協定,所以不需要任何轉換,把 Base URL 指向 HopBase 即可。

設定項值
modelProvider(settings.json)gemini
GEMINI_API_KEY控制台建立的密鑰
GOOGLE_GEMINI_BASE_URLhttps://api.hop-base.com
請求的介面POST /v1beta/models/{model}:streamGenerateContent?alt=sse

已在正式環境用 agy 1.5.12 實測:讀寫和修改檔案、執行 shell 指令、並行與連續工具呼叫、多輪續接(--continue)、長上下文、圖片輸入,以及從建立專案、撰寫程式到執行測試的完整程式設計任務皆可使用。

密鑰要包含 Gemini 分組:

建立密鑰時選取Gemini 官方直連(企業級)。agy 的主力模型與它在背景自動呼叫的輔助模型都在這個分組裡;密鑰不含該分組時會回傳 404。

設定 Antigravity CLI

安裝

macOS 用 Homebrew 安裝:

brew install --cask antigravity-cli
agy --version

其他系統依 Antigravity CLI 官方頁面的說明安裝。改用 API Key 與自訂 Base URL 需要 1.1.13 或更新版本。

把登入方式設為 Gemini API Key

編輯使用者目錄下的 ~/.gemini/antigravity-cli/settings.json(不存在就新建):

{
  "modelProvider": "gemini"
}

值必須是小寫的 gemini。只設定環境變數而不改這一項時,agy 仍會走 Google 帳號登入。

設定密鑰和 Base URL

export GEMINI_API_KEY=sk-your-key
export GOOGLE_GEMINI_BASE_URL=https://api.hop-base.com

想長期生效,把這兩行寫進 ~/.zshrc 或 ~/.bashrc。

GOOGLE_GEMINI_BASE_URL 只寫根網址,不要加 /v1beta 等路徑。agy 只讀取啟動它的終端機裡的環境變數,不讀 .env 檔案,也不讀 GOOGLE_API_KEY。

啟動並選擇模型

agy --model gemini-4-argon-medium
# 或者單次執行
agy -p "Explain this repository" --model gemini-4-hydrogen-low

選擇模型

agy 的模型名稱是「HopBase 模型 ID + 思考檔位後綴」,後綴對應請求裡的 thinkingLevel,檔位越高思考越久、用量越多。agy models 列出的是 agy 內建清單,以下面這張表為準:

HopBase 模型可用後綴範例
gemini-4-argon-low / -medium / -highagy --model gemini-4-argon-medium
gemini-4-carbon-low / -medium / -highagy --model gemini-4-carbon-high
gemini-4-hydrogen-low / -medium / -highagy --model gemini-4-hydrogen-low
gemini-4-neon-low / -medium / -highagy --model gemini-4-neon-medium
gemini-3.8-flash-low / -medium / -highagy --model gemini-3.8-flash-medium

價格見模型列表。

agy 會在背景呼叫輔助模型:

agy 每執行一步,會額外用 gemini-3.1-flash-lite-preview 或 gemini-3.8-flash 做一次安全審核。這些請求同樣計費,會出現在控制台的使用紀錄裡。

已知限制

  • 整段輸出:回答不是逐字串流回傳,而是產生完後一次性回傳。長回答或高思考檔位時,畫面會先等待一段時間再整段出現,這不是當掉。
  • -xhigh 檔位暫不支援:agy 清單裡的 -xhigh 後綴請改用 -high。
  • 中斷仍計費:按 Ctrl+C 中斷時,已經送出的那次請求仍會在伺服器端跑完並計費。

下一步