Gemini CLI 停服：Antigravity CLI 迁移教程（2026）
发布于 2026年9月8日
如果你最近发现 Gemini CLI 突然连不上了，不是你的网络问题：Google 已于 2026 年 6 月 18 日正式停止 Gemini CLI 对个人用户的服务，接班者是在 Google I/O 2026 上发布的 Antigravity CLI（命令名 agy）。这个拥有十万级 GitHub star 的开源明星项目就此谢幕，继任者换成了闭源形态，也引发了不小的社区争议。这篇教程讲清楚停服时间线、谁受影响、Antigravity CLI 怎么装怎么用，以及怎么把你原来的 Gemini CLI 配置一条命令搬过去。
发生了什么：Gemini CLI 停服时间线
- 2026 年 5 月 19 日：Google I/O 2026 宣布 Gemini CLI 退役，同日发布接班者 Antigravity CLI，开启 30 天迁移窗口。
- 2026 年 6 月 18 日：Gemini CLI 与 IDE 里的 Gemini Code Assist 扩展端点停止响应个人用户请求——免费用户、Google AI Pro、Google AI Ultra 订阅用户都在内。
- 不受影响的两类人：持企业版许可（Standard/Enterprise）的用户，以及用付费 Gemini API Key 直连的用户，暂可继续使用。
开源仓库还在，但服务已断
Gemini CLI 的开源代码仓库并没有删除，你依然可以编译运行它——但对个人账号的官方端点已经关闭，登录个人 Google 账号会拿不到响应。想继续留在 Google 生态，迁移到 Antigravity CLI 是官方唯一指定的出路。
Antigravity CLI 是什么
Antigravity CLI 是 Google Antigravity 产品家族的终端形态——和 Antigravity IDE（谷歌的 agentic 编辑器，站内有专文介绍）同属一个体系，用同一个 Google 账号登录。定位与 Gemini CLI 一致：跑在终端里的 AI 编程 agent，读代码、改文件、执行命令。默认模型是 Gemini 3 Pro，据多方报道还提供包括第三方模型在内的多款模型可选。与前任最大的不同有两点：一是闭源；二是命令名从 gemini 换成了 agy，配置体系也做了不小的调整（详见下文迁移一节）。
安装与首次运行
bash
# macOS / Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
# Windows（PowerShell）
irm https://antigravity.google/cli/install.ps1 | iex
# 重开终端后验证
agy --version首次运行 agy 会依次问你三件事：同意服务条款、选择主题、确认信任当前文件夹。关键的一步在最后——它会弹出 Migration options（迁移选项），检测到本机装过 Gemini CLI 时会提示「Import extensions from Gemini CLI」，直接确认即可自动搬家。登录方式仍是浏览器授权 Google 账号，且原生支持 SSH 远程场景。
从 Gemini CLI 迁移：一条命令 + 三个坑
如果首次运行时跳过了迁移向导，事后也可以用命令补做：
bash
# 导入 Gemini CLI 的扩展与配置
agy plugin import gemini配置文件的新旧对应关系如下，迁移后建议逐项核对：
| 内容 | Gemini CLI（旧） | Antigravity CLI（新） |
|---|---|---|
| 全局 MCP 配置 | ~/.gemini/settings.json | ~/.gemini/antigravity-cli/mcp_config.json |
| 工作区 MCP 配置 | .gemini/settings.json | .agents/mcp_config.json |
| 工作区技能 | .gemini/skills/ | .agents/skills/（需手动移动） |
| 上下文文件 | GEMINI.md / AGENTS.md | 不变，继续生效 |
| 查看扩展 | gemini extension list | agy plugin list |
最容易踩的坑：MCP 字段 url 改名 serverUrl
远程 MCP 服务器配置里，旧的 "url" 字段在 Antigravity CLI 中必须改名为 "serverUrl"。不改不报错，但远程 MCP 服务器会静默失败——你会以为配好了，实际根本没连上。迁移后务必打开新的 mcp_config.json 逐个检查。另外两个小坑：工作区技能目录不会自动搬，要手动从 .gemini/skills/ 挪到 .agents/skills/；自定义主题暂不支持。
免费额度与模型
用个人 Google 账号（普通 Gmail）登录即可免费使用，默认给到较高的 Gemini 3 Pro 额度，日常开发够用——有报道称免费档约每天 1000 次请求，也有说法是免费档按周限流、Google AI Pro/Ultra 订阅用户额度每 5 小时刷新且享有优先级。官方没有给出统一的公开数字，且额度政策随时可能调整，以你登录后界面实际显示为准。横向对比的话，这个免费额度明显比 Claude Code、Codex CLI 免费能给的量大方，是目前「零成本跑终端 agent」最能打的选项之一。
国内怎么用
和 Gemini CLI 时代一样，两个前提没变：一个 Google 账号，以及国际互联网访问环境。满足条件的话，上面的安装命令和免费额度对国内用户同样有效。如果网络条件不允许，务实的选择是国产替代：Qwen Code 本身就是从 Gemini CLI 改造而来的开源项目，命令习惯几乎无缝衔接，还免费；iFlow CLI、CodeBuddy Code 也都有免费额度。这几款站内都有单独的实测教程，Gemini CLI 的老用户可以平滑过渡。
从 Gemini CLI 到 Antigravity CLI，工具名字和配置路径变了，但「在终端里用自然语言驱动 AI 写代码」这件事只会越来越主流。工具会一代代换，真正保值的是方法：怎么把需求拆成 AI 能稳定执行的任务、怎么写好上下文文件、怎么审出 AI 代码里的坑。想系统掌握这套用 AI 编程工具做出完整产品的能力，欢迎来 IMAI 看看我们的体系化实战课程。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程