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 URL | https://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。
- 使用任何第三方分支或代理前,請自行評估其安全性與後續維護情況。