Gemini CLI 今日正式停用！完整迁移至后继者 agy 的步骤指南

从 Gemini CLI（6月18日停用）到后继者 “Antigravity CLI (agy)” 的完整迁移指南

今天突然发现 Gemini CLI 无法使用，相信很多人都感到惊讶。在开发者大会 “Google I/O 2026” 上，Google 宣布将于 2026 年 6 月 18 日正式停用深受许多开发者喜爱的命令行 AI 工具 “Gemini CLI” 的个人及免费服务。与此同时，用户正在向全新的终端 AI 助手后继者 “Antigravity CLI（命令名：agy）” 进行迁移。

虽然 Gemini CLI 作为开源交互式 CLI 赢得了极高的人气，但此次迁移将提供更加强大的功能，例如更快的执行二进制文件以及后台并行自主任务处理。在本文中，我们将全面解释停用期限的影响范围、新命令 “agy” 的强大特性、具体的迁移步骤，以及旧版 Gemini CLI 的干净卸载方法。

停用影响范围与迁移背景

自 2025 年 6 月开源发布以来，Gemini CLI 建立了一个非常活跃的社区，在 GitHub 上积累了超过 10 万个 Star，并合并了 6,000 多个 Pull Request。此次向包含 “闭源化” 在内的后继工具的彻底过渡，在开发者社区中引发了褒贬不一的巨大争议。

此次停用及迁移截止日期 “2026 年 6 月 18 日” 主要适用于免费用户、Google AI Pro/Ultra 计划订阅者以及个人 Gemini Code Assist 用户。另一方面，通过企业级 Standard/Enterprise 许可或通过 Vertex AI 等 Google Cloud 使用 Gemini CLI 的用户目前不受影响，可以继续使用旧版 CLI。然而，鉴于未来所有的功能开发都将集中在 Antigravity CLI 上，从长远来看，考虑迁移是明智之举。

后继工具 “Antigravity CLI (agy)” 的性能与新功能

新工具 “Antigravity CLI（命令名：agy）” 彻底脱离了传统的 TypeScript/Node.js 实现，改用 Go 语言重写。因此，内存消耗大幅降低，启动和响应速度显著提升。此外，通过采用最先进的 “Gemini 3.5 Flash” 作为标准模型，它可以比以往任何 class 都更流畅地处理复杂的开发工作流程。

最引人注目 revamped 新功能是 “异步并行后台子代理 (Sub-Agents)”。诸如大规模代码重构、文档生成以及测试自动化等耗时任务均可在后台执行，使您能够在不阻塞终端操作屏幕的情况下并行开展工作。此外，还提供了丰富的快捷方式来提高交互式开发效率，例如在交互过程中输入 “@” 来选择并附加文件，或使用 “!” 直接调用 Shell 命令。\n

对比项目	Gemini CLI (gemini)	Antigravity CLI (agy)
实现语言	TypeScript (Node.js)	Go
启动/运行速度	普通	极快 / 内存高效
多代理支持	不支持（单一任务）	支持（后台异步并行）
开发/分发模型	开源 (Apache 2.0)	闭源

迁移至 Antigravity CLI 的逐步操作指南

迁移过程非常简单，主要通过遵循以下步骤执行：\n

步骤 1：安装 在 macOS 或 Linux 环境中，在终端运行以下安装命令。

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

对于 Windows 环境（PowerShell），运行以下命令：

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

步骤 2: 首次运行与认证 安装完成后，在终端运行 agy 命令。浏览器将自动打开并启动 Google OAuth 身份验证流程。使用您在旧版 Gemini CLI 中使用的 Google 账号登录。\n

步骤 3：导入现有配置 通过运行以下命令，Gemini CLI 的 MCP 서버 설정, 快捷键绑定以及允许的命令等环境设置将自动导入到 Antigravity CLI 中。 agy plugin import gemini

步骤 4：微调 MCP 配置 导入后，检查 MCP 服务器配置文件 mcp_config.json。在设置内部的连接目标规范中，传统的 url 字段已更改为 serverUrl。如果发生连接错误，请手动更新该描述。\n

步骤 5：迁移项目 Skills 目录 如果您在项目中使用自定义定义的 Agent Skills，则需要将内容从旧版 Skills 放置目录 .gemini/skills/ 迁移（复制或重命名）到新路径 .agents/skills/。

mkdir -p .agents/skills && cp -r .gemini/skills/* .agents/skills/\n

步骤 6：运行验证 最后，运行 agy doctor 命令对设置和连接状态进行诊断测试。如果未检测到问题，则迁移完成。

停用后旧版 Gemini CLI 的卸载步骤

完成向 Antigravity CLI 的迁移后，建议将系统中不再使用的旧版 Gemini CLI 彻底清除（卸载）。

1. 移除全局包

Gemini CLI 通常作为全局 npm 包安装。运行以下命令进行卸载：

npm uninstall -g @google/gemini-cli

* 如果在 macOS/Linux 上遇到权限错误，请在命令前加上 sudo 并重新运行。

2. 删除配置文件及缓存

由于凭证信息和本地配置仍会保留，因此请删除不需要的目录。对于 macOS/Linux，删除 ~/.config/gemini-cli 目录。

rm -rf ~/.config/gemini-cli

对于 Windows（PowerShell），使用以下命令删除配置文件和缓存：

Remove-Item -Recurse -Force $env:USERPROFILE\.config\gemini-cliRemove-Item -Recurse -Force $env:LOCALAPPDATA\gemini-cli

3. 清理身份验证凭证

删除保存在操作系统凭证存储中的旧 OAuth 令牌。对于 Windows，打开 “凭据管理器”，并在 “Windows 凭据” 下删除与 google-gemini-cli 或 gemini-cli 相关的注册条目。对于 macOS，使用 “钥匙串访问” 应用搜索并删除类似的关联条目。

若您对转向闭源有所顾虑的替代工具

对于对 Antigravity CLI 的闭源转变有所顾虑的开发者，可以使用以下几种优秀的开源替代方案：

1. Claude Code：

由 Anthropic 提供的最新终端代理工具，具有先进的代码理解和工具执行能力。

2. Aider:

一款可以与各种 LLM（如 GPT-4o 或 Claude 3.5 Sonnet）集成的命令行聊天工具，作为一个完全开源的项目，具有极高的可定制性。

3. GitHub Copilot CLI:

GitHub 官方的 CLI 工具，能够与 GitHub 生态系统紧密集成并运行。

4. Ollama + open-webui:

在完全本地的环境中运行 LLM 的解决方案，使您能够 100% 自主管理隐私。

总结

基于 Go 的 agy 提供了极快的启动速度，并充满了提高开发效率的功能，例如异步并行处理。相反，令人惊讶的是 Gemini 至今甚至都不支持子代理 (Sub-Agents)，但这是一个迁移至 agy 的绝佳契机。

【来源】