Gemini CLI 迁移到 Antigravity CLI：配置、插件和时间线怎么处理

先说结论：这不是一次普通改名

Gemini CLI 迁移的重点不是把命令名换掉，而是先确认你的账号属于哪条产品线。Google 在迁移公告里说明，面向 Google AI Pro、Ultra 和个人免费方案的 Gemini CLI 已在 2026 年 6 月 18 日停止提供请求，消费者应转向 Antigravity CLI；通过 Gemini Code Assist Standard 或 Enterprise 使用的企业客户则维持原有访问。先分清账号，再决定是否迁，能避免把企业环境误当成个人版故障。

官方回顾 Gemini CLI 已积累超过 10 万个 GitHub star 和 6000 个合并 PR。迁移不是因为终端入口没人用，而是 Google 把产品重心转向可在后台运行的多 Agent 工作流。Antigravity CLI 以 Go 构建，并与桌面端共享 Agent harness。对日常使用者而言，真正的变化是任务可以异步继续，终端不必一直被一次长重构占住。

迁移前先保存三类东西

第一类是上下文规则，例如项目里的 GEMINI.md、AGENTS.md 和全局指令。第二类是扩展与 MCP 配置，它们往往包含团队自己的工具入口。第三类是会话凭据和登录方式。不要先卸载旧 CLI 再回头找这些文件；先记录当前路径、扩展列表和认证账号，迁移失败时才有可比较的基线。

如果你还不确定旧工具到底记录了哪些消耗，可以先看Gemini CLI Token 用量追踪，把迁移前一周的模型、日期和项目分布留一份快照。这样迁移后即使目录或来源标识改变，也能判断数据是真的下降，还是采集链路断了。

官方迁移路径怎么走

按Antigravity CLI 迁移文档，首次启动会检测并迁移 Gemini CLI 的配置、扩展和会话凭据。旧扩展也可以通过 agy plugin import gemini 导入；原有 GEMINI.md 与 AGENTS.md 上下文文件继续兼容。这里最稳妥的做法是先完成自动检测，再逐项核对，不要为了“干净安装”主动删除旧目录。

插件导入后要检查三件事：命令是否被转换成可调用的 skill，MCP 服务是否仍指向正确凭据，项目规则是否在新会话中实际生效。能列出插件不等于工具调用成功；至少执行一次只读任务，再执行一次需要工具的任务，并查看日志里调用的是不是预期服务。

用量统计别沿用旧假设

工具迁移后，模型名称、日志目录和来源字段都可能改变。跨工具统计应把“旧 Gemini CLI”和“新 Antigravity CLI”作为两个可识别来源，再在展示层合并，而不是直接把新数据写进旧来源。需要同时看多个工具时，可以参考多 AI 编程工具统一追踪的做法：保留原始来源，统一时间口径，最后再聚合。

迁移完成的标准也不是“命令能跑”。更完整的验收是：登录身份正确、项目规则生效、插件可调用、旧配置可回退、Token 数据连续。五项都过，才算真正完成 Gemini CLI 迁移；其中任何一项不确定，就先保留旧环境和迁移前快照。

先留证据、再切工具、最后核对数据，比一次性清空旧环境更稳。