Gemini CLI 用不了了：现在该用什么

如果你的 gemini 从今年夏天开始就用不了了，问题并不在你的安装。2026-06-18，Google 停止向个人 Google 账号提供 Gemini CLI 服务，涵盖免费版、Google AI Pro 和 Google AI Ultra。重装或换一个个人账号登录都无济于事。你有三条出路：迁移到 Antigravity CLI（agy），即 Google 提供的替代品；用付费 API 密钥继续运行 Gemini CLI；或者换一个编程智能体。

Gemini CLI 发生了什么

Google 于 2026-05-19 在 Google Developers Blog 的一篇文章中宣布了这项变更，并同步发布了 GitHub 讨论（#28017）。从 2026-06-18 起，Gemini CLI 和 Gemini Code Assist IDE 扩展不再处理个人账号的请求。Google 引导这些用户转向 Antigravity CLI，并称它继承了 Gemini CLI 最重要的功能：Agent Skills、Hooks、Subagents 和 Extensions（现在叫 plugins）。

现在用个人账号登录时，浏览器会提示认证成功，但终端随后会打印这段话：

This client is no longer supported for Gemini Code Assist for individuals. To continue using Gemini, please migrate to the Antigravity suite of products.

这是 gemini-cli issue #28229 中报告的原文。一些迁移指南还提到 CLI 返回 HTTP 410 Gone。我们没有看到 Google 在文档中说明具体状态码，所以以这条消息为准：只要看到它，就说明你的登录方式已被下线。这不是配额问题。

哪些人受影响，哪些人不受影响

上表依据 Google 的公告整理。注意 Google 说的是付费 API 密钥。如果你依赖的是免费的 AI Studio 密钥，请先自己核对公告，再决定是否依赖它。

方案一：迁移到 Antigravity CLI（agy）

对大多数用 Google 账号使用 Gemini CLI 的人来说，这是 Google 预设的路线。从官方安装页面安装：

# macOS and Linux (installs ~/.local/bin/agy)
curl -fsSL https://antigravity.google/cli/install.sh | bash

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

运行 agy 并选择 Google 登录。在桌面环境下它会打开浏览器；通过 SSH 运行时，它会打印一个授权 URL：你在任意设备上打开它，再把代码粘贴回终端。正因如此，它在无头服务器上也能用。

迁移你的 Gemini CLI 配置

Google 的迁移指南说明了哪些内容会自动迁移，哪些不会：

• 首次启动：如果 agy 检测到已有的 Gemini CLI 配置，会显示一个清单，提供转换扩展和全局配置、把会话令牌移到系统密钥环，以及映射设置等选项。
• 扩展：如需手动转换，运行 agy plugin import gemini。它会把扩展转换为 Antigravity 插件，把旧版命令转换为 skills，并迁移 MCP 服务器定义。记得看一下它的输出，里面会列出已处理和已跳过的内容。
• 上下文文件：GEMINI.md 和 AGENTS.md 照常可用，无需重命名。
• Skills：把工作区 skills 从 .gemini/skills/ 移到 .agents/skills/。全局 skills 现在位于 ~/.gemini/antigravity-cli/skills/。
• MCP：服务器配置从 ~/.gemini/settings.json 移到 mcp_config.json（全局在 ~/.gemini/config/，按工作区则在 .agents/），远程服务器改用 serverUrl，不再用 url/httpUrl。

Google 还提到，Gemini CLI 的部分自定义终端主题和实验性视觉叠加层可能无法迁移。如需在 VPS 上的完整步骤（包括不用浏览器登录），请参阅在服务器上运行 Antigravity CLI。

方案二：用 API 密钥继续使用 Gemini CLI

如果你有围绕 gemini 命令写的脚本，可以改用 Google AI Studio 的付费密钥让它继续运行。根据 Gemini CLI 认证文档：

export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"
gemini
# then pick "Use Gemini API key"

Vertex AI 也可以，通过 Application Default Credentials、服务账号或 Google Cloud API 密钥接入。代价在于计费方式：按 token 付费，而不是固定的订阅费。如果你通过公司使用 Code Assist Standard 或 Enterprise，那么对你来说什么都没变。

API 密钥同样适用于 agy。设置 {"modelProvider": "gemini"}（写入 ~/.gemini/antigravity-cli/settings.json），然后导出 GEMINI_API_KEY 即可。这很适合 CI 和不便交互式登录的无头机器。

方案三：换一个编程智能体

这次停服也是一个合适的时机，重新想想 Gemini 是否仍是你想要的智能体。Claude Code 使用 Claude Pro 或 Max 套餐；Codex 使用 ChatGPT 套餐或 OpenAI API 密钥；OpenCode 开源，支持众多模型提供商。你的 AGENTS.md 可以直接带走：Codex 原生读取它，较新版本的 Claude Code 在没有 CLAUDE.md 时也会读取它。我们在 Claude Code vs Codex vs OpenCode 中对比了这三者。

Antigravity 的价格页面列出了带每周速率限制的 $0 Individual 套餐，以及额度更高的 Google AI Pro 和 Ultra。但它没有给出任何套餐的具体数字，我们也尚未确认 CLI 能用到各项配额中的多少，所以在考虑成本之前，请先查看 Google 当前的套餐页面。

我们在 Maude 中做了什么

Maude 在你自己的服务器上运行编程智能体，让你用手机操控它们。我们放弃 Gemini CLI 的原因，和你读到这篇文章的原因一样。Maude 用你自己的账号连接每个智能体，而对 Gemini CLI 来说，这意味着个人 Google 登录——这条路已经走不通了。Maude 2.0 改为支持 Antigravity CLI，与 Claude Code、Codex、OpenCode 和 Grok Build 并列。应用会在你的服务器上安装经过测试的锁定版本 agy，你在手机上登录即可：用 Google 登录（把代码粘贴回去），或者用 Gemini API 密钥。

有一点需要注意：在无头模式下，agy 无法在工具运行前停下来征求许可。需要权限的操作会被直接拒绝，并在本轮结果中报告。Maude 会显示每个被拒绝的操作，让你事后批准；批准后，它会在 agy 自己的设置里添加一条允许规则并重试。这样可行，但和 Claude Code 先询问再执行的权限请求并不一样，选用之前你应该了解这一点。

Google 也推出了自己的 Antigravity Remote Control：运行 /remote-control（在 agy 内），或者用 agy remote-control start 启动无头守护进程，然后在网页控制台中操控。如果 Antigravity 是你唯一使用的智能体，建议先试试它。

常见问题

更新内容

• 2026年10月1日 — 首次发布。内容已对照 Google 的公告、Antigravity CLI 安装与迁移文档以及 Gemini CLI 认证文档核实。