Skip to content

Antigravity CLI 接入 ​

1. 安装 ​

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

2. 配置 ​

2.1 启用 API Key 模式 ​

编辑 ~/.gemini/antigravity-cli/settings.json,在现有 JSON 中添加:

json
{
  "modelProvider": "gemini"
}

WARNING

只设置 GEMINI_API_KEY 不会切换认证方式。modelProvider 必须设为小写的 "gemini"。

2.2 设置环境变量 ​

export GOOGLE_GEMINI_BASE_URL="https://codex.openai.com"
export GEMINI_API_KEY="codex_your_api_key"
  • GOOGLE_GEMINI_BASE_URL 填服务根地址,不要带具体接口路径。端点必须兼容 Gemini API。
  • GEMINI_API_KEY 填你的 API Key。
  • 在启动 agy 的同一个 shell 中执行以上命令。CLI 不读取 .env 或 GOOGLE_API_KEY。

需要永久生效时,将两个 export 写入 ~/.zshrc 或 ~/.bashrc。

3. 启动与验证 ​

bash
agy --model gemini-3.8-flash

顶部显示 Gemini API key 后,发起一次对话。

  • 仍要求登录:检查 "modelProvider": "gemini",退出并重新启动 agy。
  • 启动时提示缺少 Key:在当前 shell 中重新设置 GEMINI_API_KEY。
  • 请求失败:检查 API Key、服务根地址和所选模型的访问权限。

OpenAI-compatible gateway integration docs