Antigravity CLI

手动安装

如果本机还没有 agy 命令，请先按系统完成官方安装。Antigravity CLI 的命令名是 agy，不是 antigravity。

打开官方安装文档，按页面提供的 Windows 安装方式完成安装。

重新打开终端后检查版本：

agy --version

使用官方安装脚本：

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

也可以使用 Homebrew：

brew install antigravity-cli

重新打开终端后检查版本：

agy --version

使用官方安装脚本：

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

重新打开终端后检查版本：

agy --version

更多子命令和参数可参考 Antigravity CLI 官方命令参考。

手动接入

Antigravity CLI 的 Google 登录和 Gemini API Key 模式是两种不同的认证方式。接入球球Token 时，设置 modelProvider: "gemini"，再通过环境变量提供令牌和接口地址；不要在 CLI 中继续使用 Google OAuth 登录。

创建配置目录。
cmd
```
mkdir "%USERPROFILE%\.gemini\antigravity-cli"
```
bash
```
mkdir -p ~/.gemini/antigravity-cli
```
bash
```
mkdir -p ~/.gemini/antigravity-cli
```
配置文件位置为 Windows 的 %USERPROFILE%\.gemini\antigravity-cli\settings.json，或 macOS/Linux 的 ~/.gemini/antigravity-cli/settings.json。
新建或更新 settings.json。

如果文件中已有其他配置，只加入或替换 modelProvider，不要覆盖其余字段。
json
```
{
"modelProvider": "gemini"
}
```
设置 Gemini API Key 和 Gemini 兼容根地址。

Base URL 使用根地址，不要追加 /v1。将 sk-your-token 替换为 Gemini CLI 分组的令牌。
cmd
```
setx GEMINI_API_KEY "sk-your-token"
setx GOOGLE_GEMINI_BASE_URL "https://api.qiuqiutoken.net"
```
setx 写入用户级环境变量，但不会更新当前已经打开的终端。
bash
```
export GEMINI_API_KEY="sk-your-token"
export GOOGLE_GEMINI_BASE_URL="https://api.qiuqiutoken.net"
```
如需长期生效，请将这两行加入 ~/.zshrc。
bash
```
export GEMINI_API_KEY="sk-your-token"
export GOOGLE_GEMINI_BASE_URL="https://api.qiuqiutoken.net"
```
如需长期生效，请将这两行加入 ~/.bashrc 或当前使用的 shell 配置文件。
如果环境中同时存在 GOOGLE_API_KEY 和 GEMINI_API_KEY，CLI 会优先使用 GOOGLE_API_KEY；请先移除或取消前者。
关闭正在运行的 Antigravity CLI，确保环境变量已加载后重新启动。
cmd
```
cd your-project-folder
agy
```
bash
```
cd your-project-folder
agy
```
bash
```
cd your-project-folder
agy
```

验证接入

先列出当前可用模型，再启动交互式 CLI：

agy models
agy

如果仍然出现 Google 登录页面，检查 settings.json 的路径和 modelProvider 拼写，然后完全退出并重新启动 CLI。