开源终端代理突然谢幕:个人版停服后,一批开发者被迫迁往 Antigravity CLI
开源终端代理突然谢幕:个人版停服后,一批开发者被迫迁往 Antigravity CLI
2026 年 6 月 18 日,一批开发者打开终端,输入 gemini,得到的不是熟悉的模型响应,而是一次无法绕过的拒绝。个人账号、Google One 用户,以及依赖 Gemini Code Assist 个人版的人,被统一切断;官方仓库顶部只留下一句冷静的说明:Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026(见 README.md 第 1–8 行)。
这不是一次功能迭代,而是一次"产品让位"。开源终端代理被关停,同时谷歌把开发者引向闭源的 Antigravity CLI。本文不写情怀,只做三件事:把时间线里容易被忽略的边界条件摆清楚,用仓库源码证明"哪些能力真的会丢",最后给出一份按依赖顺序排列的迁移决策清单——因为对一个团队来说,最贵的成本从来不是重新装一个 CLI,而是那些被悄悄绑在旧工具上的自动化链路。
一条公告、三个时间点,以及第四个被忽略的时间点
社区讨论里通常只记住一个日期:6 月 18 日。但从工程视角看,这次切换其实包含四个节点,每个节点的含义完全不同。
第一个节点:2025 年 6 月 25 日,开源亮相。 Apache-2.0 许可、每天 1000 次请求额度、百万级上下文,让 Gemini CLI 在几天内成为终端 AI 代理的事实标准之一。彼时的卖点是"开源 + 免费额度",而这两点恰好也是今天崩塌得最彻底的两点。
第二个节点:2026 年 5 月的 Google I/O 与官方博客。 官方口径是要把精力集中到"为当今多智能体(multi-agent)现实而构建的单一产品"上,Antigravity CLI 被定位为共享同一套后端、可编排多个智能体的统一入口。官方同时承认:"它不会一上来就实现 1:1 的功能对等"——这句话是整个事件里信息量最大的一句,因为它没有给出对等的时间表。
第三个节点:2026 年 6 月 18 日,生效日。 生效范围写得非常精确,也正因为精确而显得残酷:Google AI Pro、AI Ultra、免费用户失去对 Gemini CLI、Gemini Code Assist IDE 插件、GitHub 版 Code Assist 的访问权;企业许可用户和持有 API key 的用户不受影响。也就是说,"个人版停服"这句话是准确的,但它掩盖了一个更重要的事实——被停掉的是"用账号登录换额度"这条路径,而不是这个仓库。
第四个节点,几乎没人讨论:2026 年 10 月,仓库还在发版。 当前工作区的 package.json 版本号是 0.67.0-nightly.20261020.gb041de017,最后一次提交时间是 2026-10-23。docs/changelogs/index.md 里的版本公告一路排到 v0.54(2026-08-06),主题依旧是上下文管理、安全策略、评估体系。换句话说,开源项目没有死,死的是它的"消费者版本"叙事:同一个代码库继续为 API key 与企业管理场景服务,只是不再是普通开发者的默认入口。
这也是为什么本文的判断不是"迁移或死守",而是:你究竟站在哪条认证通道上? 这条通道决定了你还有多少选择权。
决定命运的从来不是命令行,而是认证方式
先把官方文档里的"客户分层"翻译成工程语言。docs/get-started/authentication.mdx 里那张表其实已经把答案写好:个人 Google 账号走 Sign in with Google,企业/学校/Workspace 账号需要额外绑定 GCP 项目,AI Studio 用户走 Gemini API key,云上用户走 Vertex AI。而在这次变更之后,这四条路径的命运彻底分叉:
| 认证方式 | 变更后状态 | 依据 |
|---|---|---|
| Google 账号(免费 / AI Pro / Ultra) | 个人版通道关闭,被引导至 Antigravity CLI | README.md 顶部提示 |
| 企业 Gemini Code Assist Standard / Enterprise 许可 | 保留,配额仍按席位计算 | docs/resources/quota-and-pricing.md |
| Gemini API key(付费 / 按量) | 保留,按 token 计费 | 同上,"Pay as you go" 章节 |
| Vertex AI | 保留,走动态共享配额 | 同上 |
注意这张表里一个反直觉的细节:同样是 Google 账号登录,个人账号和企业账号的技术实现路径本就不同。packages/core/src/code_assist/setup.ts 里的 setupUser() 会先读 GOOGLE_CLOUD_PROJECT / GOOGLE_CLOUD_PROJECT_ID 环境变量;如果项目 ID 缺失,就走 loadRes.ineligibleTiers 的资格判定分支,最终由 IneligibleTierError 把服务端返回的 reasonMessage 直接抛给用户:
function throwIneligibleOrProjectIdError(res: LoadCodeAssistResponse): never {
if (res.ineligibleTiers && res.ineligibleTiers.length > 0) {
throw new IneligibleTierError(res.ineligibleTiers);
}
throw new ProjectIdRequiredError();
}
而免费层(UserTierId.FREE)在 onboarding 时使用的是受管的 Google Cloud 项目,代码注释写得很直白:
if (tier.id === UserTierId.FREE) {
// The free tier uses a managed google cloud project. Setting a project in the
// `onboardUser` request causes a `Precondition Failed` error.
onboardReq = { tierId: tier.id, cloudaicompanionProject: undefined, metadata: coreClientMetadata };
}
"受管项目"意味着资格判定权完全在服务端。这也解释了一个常见的误判:"我把代码 fork 下来自己编译,是不是就能继续用?"——不能。 你的额度、模型可用性、甚至是否被允许登录,都由服务端按账号类型决定,客户端只是呈现结果。
还有一条更硬的边界写在 FAQ 里:docs/resources/faq.md 明确指出,用第三方软件或服务去"蹭"Gemini CLI 的 OAuth 认证访问后端,属于违反条款,可能导致账号被立即停用。对那些在开源 CLI 上搭了一层自定义代理、把 OAuth 当免费 API 用的团队来说,这等于提前宣判:这条技术路线在合规上从来没有被允许过,只是一直没有被执行。
至于文档里那张"个人账号每天 1000 次请求、Pro 1500、Ultra 2000"的配额表——它仍然躺在 docs/resources/quota-and-pricing.md 里,但描述的已经是旧世界。文档滞后于公告,而公告滞后于服务端开关,这本身就是一次值得记下的运维教训。
停服不是"下架",是内置在源码里的持续劝导
如果只看公告,你会以为迁移靠自觉。但翻开源码会发现,仓库里有一整套为"送你去 Antigravity"而写的代码,而且写得相当认真。
第一处:平台感知的安装命令注入。 packages/cli/src/ui/utils/antigravityUtils.ts 把三个平台的安装方式硬编码进产品:
export function getAntigravityInstallInfo(): AntigravityInstallInfo | null {
if (process.platform === 'win32') {
if (process.env['PSModulePath']) {
return { platformName: 'Windows (PowerShell)',
installCmd: 'irm https://antigravity.google/cli/install.ps1 | iex' };
}
return { platformName: 'Windows (Command Prompt)',
installCmd: 'curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd' };
} else if (process.platform === 'darwin' || process.platform === 'linux') {
return { platformName: 'macOS/Linux', installCmd: 'curl -fsSL https://antigravity.google/cli/install.sh | bash' };
}
return null;
}
第二处:不可衰减的横幅。 packages/cli/src/ui/hooks/useBanner.ts 里,普通横幅最多展示 5 次就会被本地持久化计数压掉,但 Antigravity 相关文案被显式豁免:
const showBanner =
activeText !== '' &&
(currentBannerCount < DEFAULT_MAX_BANNER_SHOWN_COUNT ||
activeText.includes('Antigravity'));
并且在展示时自动拼接安装命令:
if (showBanner && activeText.includes('Antigravity')) {
const info = getAntigravityInstallInfo();
if (info) bannerText += `\n \nTo install run "${chalk.bold(info.installCmd)}"`;
}
一行 includes('Antigravity') 的字符串判断,决定了这条提示永远关不掉。产品意图无需讨论,代码已经表达了优先级。
第三处:斜杠命令里的迁移入口。 packages/cli/src/ui/commands/helpCommand.ts 把 /help 变成了迁移向导:只要参数里同时出现 antigravity 与 install/migrate,就直接输出平台对应的安装命令,而不是常规帮助信息。
第四处:内置技能。 packages/core/src/skills/builtin/antigravity-support/SKILL.md 是一个随包内置的 Agent Skill,用来回答"怎么装、怎么迁"的问题。它给出的迁移步骤是四步:检查 node/git/shell 等前置条件、跑安装脚本让 agy 进入 PATH、用 agy --version 验证、在项目根目录直接运行 agy 并由初始化助手处理信任策略。
这里必须泼一盆冷水:社区不少"迁移实录"声称可以自动扫描并导入旧配置(技能包、MCP 服务器、GEMINI.md)。但仓库内这条内置技能的原文只承诺"引导你导入或配置信任策略",并没有任何自动搬迁 skills/MCP 配置的命令。在没有官方迁移工具源码可查的前提下,把工时按"人工盘点"来预算,才是安全的做法。
第五处,也是最容易被忽视的一处:迁移是按"环境变量"识别,而不是按"目录"。 packages/core/src/ide/detect-ide.ts 里,IDE 探测的第一优先级就是 ANTIGRAVITY_CLI_ALIAS:
export function detectIdeFromEnv(): IdeInfo {
if (process.env['ANTIGRAVITY_CLI_ALIAS']) return IDE_DEFINITIONS.antigravity;
if (process.env['__COG_BASHRC_SOURCED']) return IDE_DEFINITIONS.devin;
...
}
在 packages/core/src/ide/ide-installer.ts 里,Antigravity 的 companion 扩展安装走的是反向调用——用 Antigravity 自己的 CLI 把 Gemini CLI 的 VS Code 插件装进去:
const fallbackCommands = this.platform === 'win32' ? ['agy.cmd', 'antigravity.cmd'] : ['agy', 'antigravity'];
...
child_process.spawnSync(commandPath,
['--install-extension', 'google.gemini-cli-vscode-ide-companion', '--force'],
{ stdio: 'pipe', shell: this.platform === 'win32' });
这段代码里有一个值得表扬的安全细节:ANTIGRAVITY_CLI_ALIAS 会先用 /^[a-zA-Z0-9.\-_/\\]+$/ 做白名单校验,不合法就丢弃,避免环境变量被注入成任意命令。对一个"迁移胶水层"而言,这是合格的做法。
停服是如何下发的:远程实验开关,而不是一次版本发布
真正让人后背发凉的技术点在这里。README 里那句"已被替换"并不是硬编码在客户端里的常量,而是通过 Code Assist 的远程实验开关下发的。
看 packages/core/src/config/config.ts:
async getBannerTextNoCapacityIssues(): Promise<string> {
await this.ensureExperimentsLoaded();
return this.experiments?.flags[ExperimentFlags.BANNER_TEXT_NO_CAPACITY_ISSUES]?.stringValue ?? '';
}
async getBannerTextCapacityIssues(): Promise<string> {
await this.ensureExperimentsLoaded();
return this.experiments?.flags[ExperimentFlags.BANNER_TEXT_CAPACITY_ISSUES]?.stringValue ?? '';
}
对应 packages/core/src/code_assist/experiments/flagNames.ts 中的 BANNER_TEXT_NO_CAPACITY_ISSUES: 45740199 与 BANNER_TEXT_CAPACITY_ISSUES: 45740200——注意还有一个"容量问题"变体,意味着官方可以按服务端负载,给不同用户下发不同口径的提示文案。
同一套机制也用于模型降级。packages/cli/src/ui/components/ModelDialog.tsx 依据 config.getProModelNoAccessSync() 决定是否把 Pro 系列从模型列表里整体过滤:
if (!hasAccessToProModel) {
// Filter out all Pro models for free tier
return options.filter((option) => !isProModel(option.value));
}
而该开关在 packages/core/src/config/config.ts 里的实现是:
getProModelNoAccessSync(): boolean {
if (this.contentGeneratorConfig?.authType !== AuthType.LOGIN_WITH_GOOGLE &&
this.contentGeneratorConfig?.authType !== AuthType.COMPUTE_ADC) return false;
return this.experiments?.flags[ExperimentFlags.PRO_MODEL_NO_ACCESS]?.boolValue ?? false;
}
顺带说明为什么"AI Pro 用户也会被拦":/model 里真正被禁的不是"全部模型",而是 Pro 档位。历史上免费层被剥离 Pro 模型,用的就是这条通道;它也正好演示了开源客户端 + 闭源控制面的组合能做什么——代码你可以审计、可以 fork,但决定你今晚能不能用 Pro 的那一位,在服务端。
结合这张图看更直观:这是 Gemini CLI 自带的可视化调试入口(general.devtools 打开后可以看到 TUI 的组件树),你能清楚看到 ContextSummaryDisplay、InputPrompt、Footer 这些节点,也能看到配额与上下文提示是怎么嵌进界面的。这种级别的不透明性清零,正是闭源替代品最难补齐的部分。
真正会丢的东西:不是模型,是那圈"你自己加的护栏"
把"能力缩水"说成"模型变差了"是偷懒。对团队而言,Gemini CLI 的价值不在于它调哪个模型,而在于它把一整套可编程接口暴露给了你,而这些接口大多依赖"开源 + 本地文件"这两个前提。
先看开发者每天看见的那一面:
这张图里的信息密度就是被停掉的那部分体验:WriteFile 工具调用可见、GEMINI.md 文件计数可见、MCP 服务器数量可见、沙箱状态与审批模式可见。可观测性本身就是功能。
具体盘点会丢什么,可以按"是否有代码级证据"来分类:
1. 无头与结构化输出。 docs/cli/headless.md 定义了 -p/--prompt 触发非交互模式、--output-format json 返回单对象、流式 JSONL 返回 init/message/tool_use/tool_result/result 事件,以及标准退出码。几乎所有 CI 脚本、代码审查机器人、批量重构流水线都长在这套契约上,而它没有出现在"首日功能对等"的清单里。
2. ACP 协议接入。 docs/cli/acp-mode.md 里 gemini --acp 通过 stdio 跑 JSON-RPC 2.0,把 CLI 变成 IDE 可调用的 agent server,并且允许 IDE 在 initialize 握手时反向暴露自己的 MCP 工具。JetBrains、Zed 这类集成的稳定性,靠的就是这个开源协议实现。
3. 策略引擎与钩子。 docs/reference/policy-engine.md 允许用 TOML 定义 toolName + commandPrefix + decision + priority,把"禁止 rm -rf"这类规则落到文件里;docs/hooks/index.md 则允许在 SessionStart、BeforeTool 等事件上同步拦截。这两者合起来构成企业内网真正的安全边界——注意官方在 docs/cli/enterprise.md 里也坦白了:这些机制"不是密不透风的安全边界",但它们足以挡住误操作与合规审计。
4. 四层设置合并。 同一篇企业文档给出了优先级:system-defaults.json → ~/.gemini/settings.json → <project>/.gemini/settings.json → settings.json(系统覆盖),数组与对象类型会合并。这套"IT 可强制下发、开发者可局部覆盖"的模型,是开源版被企业采纳的关键,迁移时必须逐条确认新工具是否支持等价物。
5. 会话与可移植资产。 docs/cli/session-management.md 显示会话存放在 ~/.gemini/tmp/<project_hash>/chats/,支持按索引/ID 恢复、/resume 浏览器、以及 chat checkpoint;v0.43 起还支持会话导出/导入。这些是本地文件,不会自动跟着你搬到新工具里。
6. 技能发现路径的互操作。 docs/cli/skills.md 的四级发现顺序里有一个别有用心的设计:~/.agents/skills/ 与 .agents/skills/ 是 .gemini/skills/ 的别名,且同级内优先级更高。官方说法是"为跨 AI 工具管理 agent 专属知识提供可互操作路径"。这是全文唯一一条"迁移友好"的设计,也是你该立刻用起来的:把团队技能迁到 .agents/skills/,下次换工具时资产不用重写。
至于社区最激烈的抱怨——配额。多方反馈提到,Pro 用户在 Antigravity CLI 上"6 到 7 次提示词就打到上限",而过去用 Gemini CLI 做完整项目"只消耗 13% 配额"。这类数字无法从仓库验证,只能作为用户侧体感证据看待;但有一点可以从代码侧确认:既然 Pro 档位访问权本就可以由远程开关控制(见上一节),那么"配额更紧"在实现上没有任何障碍。"更贵"不一定写在价目表上,它也可能写在阈值里。
反而被补齐的部分:多智能体、Gemini 4,以及谷歌自己的"先迁为敬"
只讲缩水是不客观的。官方给 Antigravity CLI 的定位是统一后端 + 多智能体编排,这套架构确实解决了一个真实问题:Gemini CLI 时代的 subagent 是"进程内的专家角色"(见 docs/core/subagents.md,每个 subagent 有独立上下文与受限工具集),而多智能体现实需要的是跨会话、可后台并行、可共享状态的编排能力,这在单机 CLI 架构里很难优雅实现。
更硬的一条证据在 README 第二段:"Gemini CLI has not been optimized for Gemini 4 Argon. To use Gemini 4 Argon, please use Antigravity." 这句话的分量比"停服公告"更重——它意味着即使你靠企业许可或 API key 留在了开源版,你也不在最新模型的优化路径上。仓库里能查到的最新模型开关是 GEMINI_3_1_PRO_LAUNCHED、LATEST_FLASH_GA_LAUNCHED(见 flagNames.ts),以及 docs/changelogs/preview.md 里那条"Add Banner about Gemini CLI not being optimized for Gemini 4"的提交记录;在 packages/ 全量检索 argon / gemini 4,找不到任何模型 ID 或路由分支。模型支持不是靠社区 PR 就能补上的,它取决于服务端授权。
最能说明谷歌态度的,其实是这个仓库自己的 changelog。docs/changelogs/index.md 的 v0.54.0(2026-08-06)写着:
PR Automation & Antigravity Agent: Integrated the Antigravity agent runner with dual-locking Firestore concurrency controls to secure the PR generator.
也就是说,这个开源项目自己的 PR 自动化,已经跑在 Antigravity 的 agent runner 上了(对应 tools/caretaker-agent/cloudrun/pr-generator)。官方没有要求开发者做一件自己没做的事——他们先迁了。
还有一个颇具讽刺意味的细节:packages/cli/src/commands/hooks/migrate.ts 里保留着 gemini hooks migrate --from-claude,用于把 Claude Code 的 hooks 迁进 Gemini CLI。这个项目曾经是别人的迁移目的地,现在成了别人的迁移来源。 工具链生态的忠诚度,大概就是这个量级。
还在观望的团队,请按这个顺序决策
迁移的失败往往不是因为选错工具,而是因为排查顺序错了:先动脚本,最后才发现认证根本走不通。下面这个顺序按"依赖倒置"排列,每一步都能用仓库里的东西自查。
第 0 步:先定性,你是"个人"还是"组织"。 打开终端跑一次 gemini。如果能在 /stats model 里看到配额(见 docs/resources/quota-and-pricing.md 的"Check usage and limits"),说明你还活着;如果直接撞上 IneligibleTierError 或 429,说明你已经在新世界的门外。不要试图用 OAuth 绕——FAQ 已经把这条路定性为违规。
第 1 步:盘认证资产,而不是盘模型偏好。 列出所有用到 Gemini 的地方,按四种认证归类:个人 Google 登录、企业 Code Assist 许可、Gemini API key、Vertex AI。这一步的产出应该是"哪些流水线会断",而不是"我们该用哪个模型"。只有后两类能让你继续留在开源 CLI 上,其余都必须迁。
第 2 步:盘"非交互契约"。 这是最容易低估的迁移成本。全仓搜索你的调用点:
grep -rn -- "--output-format\|--prompt\|-p \|--acp" .github/ scripts/ tools/ 2>/dev/null
凡是命中 --output-format json、--acp、退出码判断的地方,都要在新工具上重新验证一遍 schema 与语义,而不是只验证"能不能跑通"。ACP 尤其危险:它背后连的是 IDE,断掉的表现是"插件突然不工作",而不是报错。
第 3 步:把"策略"从工具里抽出来。 现在就把 ~/.gemini/policies/*.toml 里的规则、hooksConfig 的拦截逻辑,翻译成与工具无关的描述(哪些命令必须 deny、哪些路径必须 ask、哪些事件必须留痕)。策略是资产,TOML 只是载体。 迁移时你搬的是策略;如果只搬文件,就得重新发明一遍。
第 4 步:先把可移植资产搬走,再谈工具。 把团队技能从 .gemini/skills/ 平移到 .agents/skills/(docs/cli/skills.md 明确同级别名优先),把知识从 GEMINI.md 里剥离出与工具无关的部分;会话记录留在 ~/.gemini/tmp/<project_hash>/chats/ 不会自己走,重要结论用会话导出功能落成文件。资产先自由,工具后选型。
第 5 步:小范围灰度,只盯三件事。 一个非核心仓库、一条 CI 流水线、一个 IDE 集成。验收指标不要设"体验是否更好",而要设三条硬指标:同等任务的配额消耗比、工具调用失败率、以及回滚路径是否还存在。最后一条最关键——开源版还有个"降级到 API key 按量计费"的兜底,闭源版没有。
第 6 步:接受一个不完美的事实。 如果你的团队重度依赖 hooks 自研安全扫描、依赖策略引擎做合规、依赖无头 JSON 输出做自动化,那么在 Antigravity 侧你需要重新确认这些能力是否以插件形式存在(官方口径是 Agent Skills、Hooks、Subagents、Extensions 会通过插件提供),而不是假设"它应该也有"。对等没有时间表,就不能把它写进项目计划。
结语:这次谢幕真正的教训,不是"别用免费额度"
过去两年,开源终端代理的吸引力被简化成两个词:开源、免费。这次事件把这层叙事撕开了:免费额度是服务端给的,开源只是客户端的许可证。 当控制面在别人手里,"我可以自己编译"这件事的防御价值,远低于人们以为的水平。
但也不是全无收获。这次变更意外暴露出一批真正可迁移的设计实践:把技能放在 .agents/skills/ 这种跨工具路径下、把安全策略写成与工具无关的规则、把 CI 契约收敛到结构化输出而不是屏幕文本、把会话与知识落成本地文件。做到这四点,下一次"突然谢幕"来临时,你损失的只是一个命令名,而不是三年的工作流。
对仍在使用开源版的团队来说,最理性的姿态可能是:把它当成一条"企业/API 专属通道"继续用,同时把每一处对它的依赖都标注上"可替换"标签。毕竟 README 顶部那句提示已经写得很清楚了——Gemini CLI 没有被优化到最新模型上。一个工具可以继续维护,也可以继续开源,但它已经不再是你能力上限的那块天花板了。

