Skip to Content
aicentos

Antigravity

Google Antigravity 目前不支援自訂 Base URL —— 說明限制與可用的替代方案

最後更新於:

Antigravity 是 Google 推出的代理式 IDE。需要先說明一個前提:官方版本的 Antigravity 桌面 IDE 不支援自訂 API 端點,也不提供 BYOK(自帶金鑰),模型選擇器裡是一份由 Google 維護的固定清單,目前無法指向 aicentos。

本文說明這一限制的依據、驗證方法,以及三條可用的替代路徑。

為什麼不能直接接入

Google 的帳號方案文件明確表示,Antigravity 暫不支援自帶模型或自帶端點。社群中流傳的若干設定項(例如在 ~/.antigravity/settings.json 裡寫 antigravity.ai.provider、antigravity.openai-compatible.endpoint)並非官方支援的鍵,實測表現為請求不路由到自訂端點,或靜默回落到預設模型,且模型選擇器裡不會出現自訂條目。

換句話說,這個問題不是「設定寫錯了」,而是目前版本沒有開放這個能力。IDE 的 Settings → Models 裡也沒有 Base URL 欄位可填。

需要填寫的設定

欄位值
API Key控制台建立的 Key
Base URLhttps://aicentos.com/v1
模型控制台「模型廣場」中的模型名稱

上表是 aicentos 側的通用參數,供下面任一種替代方案使用。

替代方案

方案一:改用 Antigravity CLI(推薦,僅限 Gemini 協定)

同名的命令列工具 agy 支援端點覆蓋,透過 GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY 即可接入,但只接受 Gemini 協定、只能呼叫 Gemini 系列模型。具體步驟見 接入 Antigravity CLI。

如果你的需求是「在終端機裡用 Antigravity 的互動方式」,這條最省事。

方案二:把本地模型或第三方服務包成 MCP 工具

Antigravity 的 Customizations 面板支援註冊 MCP Server。可以把本地服務封裝成 MCP 工具掛進去,作為一個可呼叫的工具使用。需要注意:這不會替換 IDE 的推理模型,只是給代理多了一個工具。

方案三:社群分支或本地代理

  • 社群分支 open-antigravity 支援任意 OpenAI 相容端點與自訂模型,是官方版本之外最乾淨的路徑。
  • 也有人用本地攔截代理改寫 IDE 的對外流量。這條路沒有官方支援,設定脆弱、升級即失效,不建議在正式環境使用。

測試

無論選哪條路徑,先用一句簡單提示詞確認連通,再正式投入使用。Agent 類任務建議先跑一個小儲存庫。

注意事項

  • 不要把「設定項看似存在」當成「功能可用」。IDE 裡的 antigravity.* 鍵多為社群猜測,寫入後不報錯但也不生效。
  • 如果你需要的是 OpenAI 相容協定、或想呼叫 Claude / GPT 系列模型,Antigravity 桌面版目前無法滿足,請優先考慮 Cursor、Windsurf 等支援自訂 Base URL 的用戶端。
  • Antigravity CLI 與桌面 IDE 是兩套設定,CLI 的端點覆蓋不會影響 IDE。
  • 使用任何第三方分支或代理前,請自行評估其安全性與後續維護情況。

相關連結