从 Gemini CLI 迁移到 Antigravity CLI 完整指南
为什么要从 Gemini CLI 迁移？
Google 在 2026 年 5 月 19 日宣布：Gemini CLI 将于 6 月 18 日停止为个人用户提供服务。所有免费、Google AI Pro、Ultra 账户都会受影响。
替代品是 Antigravity CLI（二进制名 agy）。不是简单改名——它是 Antigravity 2.0 平台的终端入口，用 Go 重写，比旧的 Node.js 版 Gemini CLI 快不少。
好消息：核心工作流全部保留。Agent Skills、Hooks、Subagents、Extensions（现在叫 Plugins）都能迁移过去。
谁需要迁移？
| 用户类型 | 是否需要迁移 |
|---|---|
| 免费 Gemini Code Assist 个人用户 | ✅ |
| Google AI Pro / Ultra 订阅 | ✅ |
| Gemini Code Assist Standard / Enterprise | ❌ |
| 使用 Google Cloud API Key | ❌ |
如果你 which gemini 能找到二进制，并且不是企业账户，就需要迁移。
怎么安装 Antigravity CLI？
macOS / Linux 一行搞定：
curl -fsSL https://antigravity.google/cli/install.sh | bash安装完成后二进制在 ~/.local/bin/agy。如果终端找不到命令：
export PATH="$HOME/.local/bin:$PATH"
# 写入 .bashrc 持久化
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc验证：
agy --version怎么把 Gemini CLI 配置导入？
Antigravity CLI 提供了一条命令导入：
agy plugin import gemini这会自动处理大部分配置。但有几个地方需要手动检查：
需要手动调整的部分
| 原 Gemini CLI | Antigravity CLI | 说明 |
|---|---|---|
.gemini/skills/ | .agents/skills/ | 目录名变了 |
MCP 配置中的 url 字段 | serverUrl | 远程 MCP 服务器字段改名 |
GEMINI.md | 保持不变 | 两个都认，不用改 |
AGENTS.md | 保持不变 | 两个都认 |
MCP 配置迁移示例
旧的 Gemini CLI 格式：
{
"mcpServers": {
"my-server": {
"url": "https://my-mcp-server.example.com/sse"
}
}
}新的 Antigravity CLI 格式（改 url 为 serverUrl）：
{
"mcpServers": {
"my-server": {
"serverUrl": "https://my-mcp-server.example.com/sse"
}
}
}本地 MCP（用 command 启动的）不需要改。
迁移完怎么验证？
# 进入你的项目目录
cd your-project
# 启动 agy，确认技能和 MCP 都加载正常
agy
# 在 TUI 里输入 /tools 查看已加载的工具
/tools如果之前的 Skills 和 MCP 工具都能列出来，迁移就成功了。
踩过的坑
Token 消耗暴增。 Antigravity CLI 默认使用 Gemini 3.5 Flash，这个模型比旧的 Gemini 3 吃 token 多很多。社区有人反馈同样的任务消耗翻了好几倍。如果你是按量付费，注意观察用量。
WSL 认证不持久。 在 WSL 里用 agy 需要安装 gnome-keyring，否则每次启动都要重新认证。
旧 Antigravity 1.0 用户注意。 5 月 19 日的自动更新会清空 1.0 的配置。如果你之前用 Antigravity 1.0，需要从头重建 AGENTS.md。
时间线总结
| 日期 | 事件 |
|---|---|
| 5 月 19 日 | Antigravity CLI 发布，30 天迁移窗口开始 |
| 5.20 - 6.17 | 并行期，两个 CLI 都能用 |
| 6 月 18 日 | Gemini CLI 个人版停服 |
别等最后一天。现在就装上 agy，跑几个真实任务确认没问题。