# Antigravity CLI

来源: https://docs.aicentos.com/clients/antigravity-cli

Language: zh-CN

> 在 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)