Antigravity CLI 接入

先说结论

当前服务已经支持 Gemini 兼容接口，可用于 Antigravity CLI。

背景

Antigravity CLI 是 Google 于 2026 年 5 月 19 日 Google I/O 大会发布的终端 AI 编程工具，是 Gemini CLI 的继任者。可执行文件名为 agy，使用 Go 语言重写，性能更好，原生支持 SSH 远程工作流。

Gemini CLI 将于 2026 年 6 月 18 日停止为个人（免费、Pro、Ultra）用户提供服务，企业用户可继续使用。

1. 安装

Antigravity CLI 通过官方脚本安装，无需 Node.js。

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

2. 配置

Antigravity CLI 沿用 Gemini CLI 的环境变量，支持通过以下三个变量接入自定义网关：

环境变量	说明
GOOGLE_GEMINI_BASE_URL	网关服务根地址，替换 Google 默认端点
GEMINI_API_KEY	你的 API Key
GEMINI_MODEL	默认使用的模型

配置示例：

export GOOGLE_GEMINI_BASE_URL="https://codex.openai.com"
export GEMINI_API_KEY="codex_your_api_key"
export GEMINI_MODEL="gemini-3.5-flash"

TIP

GOOGLE_GEMINI_BASE_URL 填写服务根地址，不需要带具体接口路径。Antigravity CLI 会自动拼接 API 路径。

如果你只需要在当前 shell 会话中临时测试，直接 export 以上三个变量后执行 agy 即可。

如果你希望永久生效，可以将上述 export 语句加入你的 shell 配置文件，例如 ~/.zshrc 或 ~/.bashrc，然后执行 source ~/.zshrc（或 source ~/.bashrc）使其生效。

3. 启动

agy

首次启动时，Antigravity CLI 会通过系统浏览器完成 Google 账号登录。在 SSH 远程环境中，CLI 会检测到 SSH 会话并打印授权 URL，你可以在本地浏览器中完成登录。

4. 验证

启动后在 Antigravity CLI 中发起一次对话，如果能正常收到回复，说明接入成功。

如果遇到鉴权错误，请确认 GEMINI_API_KEY 是否正确，以及 GOOGLE_GEMINI_BASE_URL 是否指向正确的服务地址。

5. 从 Gemini CLI 迁移

如果你之前使用的是 Gemini CLI，以下变更需要注意：

• 可执行文件从 gemini 改为 agy
• 环境变量（GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY、GEMINI_MODEL）保持不变，无需修改
• 扩展（extensions）变更为插件（plugins），可执行 agy plugin import gemini 一键迁移
• Workspace Skills 路径从 .gemini/skills/ 迁移至 .agents/skills/
• MCP 配置从 .gemini/mcp_config.json 迁移至 .agents/mcp_config.json，远程服务器字段名由 url 改为 serverUrl
• 上下文文件（GEMINI.md、AGENTS.md）保持兼容，无需修改