# Antigravity CLI

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

Language: zh-TW

> 在 Antigravity CLI 中使用 aicentos —— 透過 API Key 模式接入

Antigravity CLI 是 Google 推出的命令列工具，支援透過 API Key 模式接入相容 Gemini API 的服務。本文件介紹如何設定 Antigravity CLI 以使用自訂 API 端點。

## 安裝

依作業系統選擇對應的安裝方式：

### macOS / Linux

```bash
curl -fsSL https://antigravity.google/cli/install.sh | bash
```

### Windows (PowerShell)

```powershell
irm https://antigravity.google/cli/install.ps1 | iex
```

### Windows (CMD)

```cmd
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
```

### 驗證安裝

```bash
agy --version
```

## 設定

### 啟用 API Key 模式

編輯 `~/.gemini/antigravity-cli/settings.json`，在現有 JSON 中加入：

```json
{
  "modelProvider": "gemini"
}
```

⚠️ **注意**：只設定 `GEMINI_API_KEY` 不會切換驗證方式。`modelProvider` 必須設為小寫的 `"gemini"`。

### 設定環境變數

```bash
export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
```

**重要說明：**

* `GOOGLE_GEMINI_BASE_URL` 填服務根位址，不要帶具體介面路徑。端點必須相容 Gemini API。
* `GEMINI_API_KEY` 填你的 API Key。
* 在啟動 `agy` 的同一個 shell 中執行以上指令。CLI 不讀取 `.env` 或 `GOOGLE_API_KEY`。

需要永久生效時，將兩個 `export` 寫入 `~/.zshrc` 或 `~/.bashrc`。

## 啟動與驗證

```bash
agy --model gemini-2.0-flash
```

頂部顯示 `Gemini API key` 後，發起一次對話。

### 常見問題排查

* **仍要求登入**：檢查 `"modelProvider": "gemini"`，離開並重新啟動 `agy`。
* **啟動時提示缺少 Key**：在目前 shell 中重新設定 `GEMINI_API_KEY`。
* **請求失敗**：檢查 API Key、服務根位址和所選模型的存取權限。

## 注意事項

* 必須同時設定 `modelProvider` 設定項和環境變數才能正常使用 API Key 模式
* 環境變數需要在啟動 CLI 的 shell 工作階段中設定，或寫入 shell 設定檔永久生效
* 服務端點必須相容 Gemini API 規範

## 相關連結

* 官方文件：[https://docs.aicentos.com/clients/antigravity-cli.html](https://docs.aicentos.com/clients/antigravity-cli.html)