# Antigravity

來源: https://docs.aicentos.com/zh-TW/clients/antigravity

Language: zh-TW

> 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](https://docs.aicentos.com/zh-TW/clients/antigravity-cli)。

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

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

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

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

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

## 測試

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

## 注意事項

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

## 相關連結

* [接入 Antigravity CLI](https://docs.aicentos.com/zh-TW/clients/antigravity-cli)