Antigravity CLI

Antigravity CLI 是 Google 推出的命令行工具，支持通过 API Key 模式接入兼容 Gemini API 的服务。本文档介绍如何配置 Antigravity CLI 以使用自定义 API 端点。

安装复制锚点链接

根据操作系统选择对应的安装方式：

macOS / Linux复制锚点链接

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

Windows (PowerShell)复制锚点链接

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

Windows (CMD)复制锚点链接

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

验证安装复制锚点链接

agy --version

配置复制锚点链接

启用 API Key 模式复制锚点链接

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

{
  "modelProvider": "gemini"
}

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

设置环境变量复制锚点链接

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。

启动与验证复制锚点链接

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