Gemini CLI 停服了?2026 迁移到 Antigravity CLI 完全指南

Gemini CLI 停服倒计时:6 月 18 日是死线

如果你在搜 gemini cli 停服、gemini cli 迁移 antigravity、或者 antigravity cli 怎么用,先给你一句 TL;DR:Google 已在 Google I/O 2026(2026-05-19)宣布,Gemini CLI 与 Gemini Code Assist IDE 扩展将于 2026 年 6 月 18 日停止为「免费个人版 / Google AI Pro / Google AI Ultra」用户服务,官方推荐迁移到全新的 Antigravity CLI(命令名 agy)。 企业版(Gemini Code Assist Standard/Enterprise、付费 Gemini Agent Platform API Key)不受影响。

我是 dfkai,过去一年把 Gemini CLI、Claude Code、Cursor、Codex CLI 都当主力轮着用。这次 Gemini CLI 要停,我第一时间把自己的工作环境整套迁到了 Antigravity CLI,这篇就是我实测迁移全过程的笔记——从时间线、谁受影响,到配置/Skills/插件怎么搬,再到我踩的坑。距离 6-18 只剩不到三周,别拖。

重要声明:本文版本号与时间线均来自 Google Developers Blog 等官方与多家媒体报道(2026-05-30 核实)。安装命令、agy 命令名等细节来自官方文档与 Google Cloud 社区实测文,但 Antigravity 仍在快速迭代,所有命令与路径以官方最新为准。

一、停服时间线:卡死在 6-18 这个节点

把官方公告里的关键节点拉成一条线:

时间	事件	来源
2026-05-19	Google I/O 2026 宣布 Antigravity CLI,即日起对所有人开放	官方博客
2026-05-19 起	旧 Gemini CLI 进入「弃用过渡期」,可继续用但开始引导迁移	官方博客
2026-06-18	Gemini CLI + Gemini Code Assist IDE 扩展对免费/Pro/Ultra 停止服务	官方博客
2026-06-18 起	Gemini Code Assist for GitHub 停止新安装,随后几周内停止响应请求	官方博客

注意 6-18 不是「软提醒」,是直接停止 serving 请求。也就是说那天之后你在终端敲 gemini,大概率拿到的是认证失败 / 配额错误,而不是一句温柔的提示。所以迁移这事别拖到最后一天。

实测提醒:我自己 5 月底测的时候,旧 Gemini CLI 还能正常跑,但已经会在启动时弹一条迁移横幅。这说明过渡期是真给了缓冲,但 buffer 只到 6-18。

二、谁受影响?先对号入座再决定要不要搬

这一节最关键,因为不是所有人都得迁。对照下表确认你属于哪一类:

你的身份	6-18 之后 Gemini CLI 还能用吗	要不要迁移
免费个人版(Gemini Code Assist for individuals)	❌ 停服	必须迁
Google AI Pro 订阅	❌ 停服	必须迁
Google AI Ultra 订阅	❌ 停服	必须迁
Gemini Code Assist for GitHub(个人/组织)	❌ 停新装,随后停响应	必须迁
Gemini Code Assist Standard / Enterprise 授权	✅ 继续可用,持续更新模型	不强制
付费 Gemini / Gemini Agent Platform API Key	✅ 继续可用	不强制

简单记:个人/免费/Pro/Ultra = 必须迁;企业付费授权或付费 API Key = 暂时安全。

中文场景额外提醒两点(实测踩过):

• 大陆可用性:Gemini CLI 与 Antigravity CLI 都依赖 Google 账号登录与 Google 服务可达,大陆网络环境下需要自行解决网络访问问题,且社区反馈部分地区注册存在区域限制 / 年龄验证拦截。如果你本来就因为网络原因用得别扭,这次正好是评估国产替代的时机(下文有对照)。
• 配额变化:社区反馈 Antigravity 把原来的「按天 / 5 小时窗口」配额改成了按周配额,而且有人实测同样任务消耗比 Gemini CLI 快数倍。这点官方文档未明确量化,以官方最新为准,但迁移后建议先小步试用、观察配额再上重活。

三、迁移五步:我的实测流程

下面是我本机(macOS)实测跑通的流程。Windows 用 PowerShell 对应命令即可。安装脚本与命令名以官方文档为准,这里给的是社区与官方文档实测版本。

第 0 步:备份旧配置(别跳!)

迁移前先把 Gemini CLI 的整套配置原地备份一份,出问题能回滚:

cp -r ~/.gemini ~/.gemini_backup_$(date +%Y%m%d)

我的 ~/.gemini 里有 settings.json、自定义 skills、MCP server 配置、还有项目级的 GEMINI.md 上下文文件——这些都是要搬的资产,备份后心里有底。

第 1 步:安装 Antigravity CLI(agy)

官方文档与社区实测给出的安装方式(macOS / Linux):

curl -fsSL https://antigravity.google/cli/install.sh | bash
# 确保 PATH 里有它
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Windows(管理员 PowerShell):

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

验证:

agy --version

注意:新 CLI 命令名是 agy,不再是 gemini。我第一次习惯性敲 gemini 还愣了一下。

第 2 步:登录认证

agy auth login
agy auth status

agy auth login 会拉起浏览器走 Google 账号 OAuth。我这边登录的就是原来挂 Gemini CLI 的同一个 Google AI 账号,订阅权益直接带过来,不用重新买。

第 3 步:搬配置、Skills、MCP、插件

这是搬家的核心。Antigravity 把配置目录从 ~/.gemini 换到了 ~/.antigravity,很多东西不会自动跟过来,得手动搬。

# Agent Skills:从旧目录搬到新目录
cp -r ~/.gemini/skills/* ~/.antigravity/skills/

# MCP server 配置:把旧 config 里的 mcpServers 段落迁到新 config
#   旧:~/.gemini/config.json(或 settings.json)
#   新:~/.antigravity/config.json

Extensions → Plugins:旧 Gemini CLI 的「扩展」在新体系里改叫「插件(plugins)」。社区文给出的自动迁移命令(以官方最新为准):

agy plugin import gemini
# 或部分版本:agy plugins migrate --from-gemini-extensions

Hooks:旧的 YAML 格式 hooks 需要转成 JSON,落到 ~/.antigravity/hooks.json。我这步是手动改的,YAML 字段和 JSON 基本一一对应,不复杂但要细心。

第 4 步:体检 + 卸载旧 CLI

agy doctor      # 检查配置/认证/MCP 是否就绪

agy doctor 这个思路和 Codex CLI 的 codex doctor 一样,会把环境问题一条条列出来。我第一次跑就被它点出有一个 MCP server 路径没迁对,改完再跑通过。

确认新环境没问题后,再卸载旧的 Gemini CLI:

npm uninstall -g @google/gemini-cli     # npm 装的
# 或 brew uninstall gemini-cli           # Homebrew 装的
rm -rf "$(npm config get cache)/_npx"   # 清 npx 缓存

四、迁移对照表:旧的叫什么、新的叫什么

把这张表存下来,迁移时对着搬就行(实测示意,以你环境与官方文档为准):

维度	Gemini CLI(旧)	Antigravity CLI(新)
命令名	gemini	agy
配置目录	~/.gemini/	~/.antigravity/
安装方式	npm i -g @google/gemini-cli	官方 install 脚本(agy)
实现语言	Node.js / TypeScript	Go(官方称更快更跟手)
扩展机制	Extensions	Plugins(agy plugin import gemini)
Skills	~/.gemini/skills/	~/.antigravity/skills/(手动搬)
Hooks	YAML	JSON(hooks.json)
Subagents	支持	原生支持,异步后台执行
MCP	支持	支持(配置需微调)
体检命令	—	agy doctor
开源	✅ Apache 2.0	❌ 目前闭源
配额	按天 / 5 小时窗口	改为按周(社区反馈)

五、不受影响 / 可以不迁的情况

不是每个人都得连夜搬家。以下情况你可以先按兵不动:

1. 企业授权用户:用 Gemini Code Assist Standard/Enterprise 的团队,官方明确「访问不变,持续更新模型」,可按团队节奏评估。
2. 付费 API Key 接入:你的脚本/CI 用的是付费 Gemini API Key 而非 CLI 内置登录,Gemini API 本身不在这次停服范围内,继续可用。
3. 本来就在用别的工具:如果你主力是 Claude Code 或 Cursor,Gemini CLI 只是备用,那这次停服对你影响有限——但如果你有 Gemini-only 的脚本依赖,记得趁早改路由。

六、踩坑实录(dfkai 实测)

• ACP 没了:社区反馈 Antigravity CLI 暂不支持 Agent Client Protocol(ACP),旧 Gemini CLI 里依赖 ACP 的集成会失效。我有一个外部编辑器接管的工作流就是靠 ACP,迁过来直接断,只能改方案。
• 不是 1:1 平替:官方自己都说了「不会一上来就功能完全对等(no 1:1 feature parity right out of the gate)」。Skills/Hooks/Subagents/Extensions 这四样保留了,但别预期所有旧功能都在。
• 闭源争议:旧 Gemini CLI 是 Apache 2.0 开源(GitHub 上一万多 fork),Antigravity CLI 目前闭源,仓库里基本只有 README 和演示 GIF。社区情绪不小,这也是为什么我建议不要把单一厂商工具当唯一依赖——多备一两套,迁移成本才低。
• 配额烧得快:前面提过,按周配额 + 消耗偏快,迁移后第一周我特意没把重活全压上去,先观察。

如果你正在重新评估「到底用哪个 AI 编程工具」,这次停服其实是个好契机。我把 Claude Code、Codex CLI、Antigravity CLI、Cursor 四个主流工具做过一次横向实测,详见 四工具横评 2026,里面有按场景的选型建议。

FAQ

Q1:Gemini CLI 到底哪天停?现在还能用吗? A:2026-06-18 对免费个人版 / Google AI Pro / Ultra 停止服务。在那之前仍可正常使用,但启动时会有迁移引导。企业付费授权与付费 API Key 不在此次停服范围内。以 Google 官方公告 为准。

Q2:Antigravity CLI 怎么用?命令是什么? A:命令名是 agy(不是 gemini)。装好后 agy auth login 登录 Google 账号,agy doctor 体检环境,agy --version 看版本。具体安装脚本以官方文档为准。

Q3:我的 Skills、MCP、扩展能直接搬过去吗? A:大部分核心能力(Skills、Hooks、Subagents、MCP、Extensions→Plugins)保留,但不会全自动:配置目录从 ~/.gemini 换到 ~/.antigravity,Skills 要手动复制,Hooks 要从 YAML 转 JSON,扩展用 agy plugin import gemini 导入。ACP 目前不支持。

Q4:大陆能用吗?有没有国产替代? A:Antigravity CLI 依赖 Google 账号与服务可达,大陆需自行解决网络;社区反馈部分地区有注册区域限制。如果网络是长期痛点,可以考虑把主力切到 Claude Code 配国产模型,或直接用 DeepSeek/Qwen/GLM 系工具链,选型可参考我的 四工具横评。

---

想系统搞懂 AI 编程工具的安装、迁移与工作流?我把这些实测经验整理成了完整课程,点此了解并立即订阅 →。

喵