Gemini CLI 替代方案：根据工作流和 API 控制能力选择

Gemini CLI 并未退役，但其免费入口已经关闭——因此“替代方案”会分裂成两个不同的决策。该仓库仍在维护：google-gemini/gemini-cli 未归档，采用 Apache-2.0 许可证，最近一次推送为 2026 年 9 月 21 日；npm 稳定版 @google/gemini-cli 为 0.60.0，于 2026 年 9 月 15 日发布，每日仍在构建 nightly 版本，且没有弃用标志（已通过 GitHub 和 npm API 于 2026 年 9 月 21 日检查）。结束的是访问权限。如果你离开是因为登录已停止工作，你需要新的访问权限。如果你离开是因为想在代理后面使用自己的端点，你需要新的客户端——而第二个问题由协议壁垒决定，而不是偏好。

先澄清一个问题，再讨论任何数字。名为 Gemini 的加密货币交易所也发布自己的“Gemini API”文档和费率表，MacPaw 销售一款名为 Gemini 2 的 macOS 重复文件查找器，而 gemini:// 协议也有自己的终端浏览器。它们的价格都不属于本页面。Google 自己的名称也分成六种——Gemini CLI、Antigravity CLI、Gemini Code Assist、Gemini 应用订阅、Gemini API 和 Gemini Enterprise Agent Platform——因此下面的每个数字都会说明其来源。

人们现在离开 Gemini CLI 的原因

Google 于 2026 年 5 月 19 日宣布将 Gemini CLI 过渡到 Antigravity CLI，并表示：“2026 年 6 月 18 日，Gemini CLI 和 Gemini Code Assist IDE 扩展将停止为 Google AI Pro 和 Ultra 提供请求服务，也将停止为免费使用该服务的用户提供请求服务。”Google 的消费者弃用页面最后更新于 2026 年 9 月 2 日，并补充说明：“你将无法再使用 Login with Google 选项访问 IDE 扩展或 Gemini CLI”；Standard 和 Enterprise 订阅“保持不变”，受影响用户可以迁移到 Antigravity 系列。

请预期会有一个过时来源与上述所有内容相矛盾。main 上的 README 仍宣传“使用个人 Google 账号时每分钟 60 个请求、每天 1,000 个请求”，还重复宣传免费层级两次，并且完全没有提到 Antigravity 或 6 月 18 日（已于 2026 年 9 月 21 日抓取）。Google 标注日期的弃用页面才是较新的依据；README 是陷阱。

第二个陷阱是订阅价格锚点。Google AI列出的免费层级为 $0，Plus 为每月 $4.99，Pro 为每月 $19.99；Google 的2026 年 5 月 19 日公告则列出 Ultra 为每月 $100 和 $200——但这些都是 Gemini 应用订阅，而 Pro 恰好是过渡公告所称已停止提供服务的层级，同时受影响的还有 Ultra 和面向个人用户的免费 Code Assist。该订阅页面没有任何层级被记录为可购买 Gemini CLI 配额。Ultra 的数字是否仍然有效，未在当前价格页面上验证；订阅页面完全没有列出 Ultra。

留下来：免费入口关闭后 Gemini CLI 的成本

仍有两条按量计费路径。许可证路径按席位购买，而 Gemini Code Assist 配额（页脚日期为 2026 年 9 月 18 日）按请求数设定上限，并说明每日限制“汇总计算通过 Gemini CLI 或代理模式与任何模型版本或系列（例如 Pro、Flash）进行的所有交互”——因此一次提示可能消耗多个请求，切换到更便宜的模型也不会增加余量。

价格于 2026 年 9 月 21 日从Google 的 Gemini 价格页面读取；该页面还显示按小时计算的等值价格，并说明订阅按月计费。API 密钥路径则按 token 计费。Gemini API 定价页面最后更新于 2026 年 9 月 16 日，其中列出了这两个模型以及其他模型；Flash 的数字是有日期限制的介绍性价格，之后会提高，这正是博客文章中的数字容易过时的类型。

同一页面列出 Batch API，成本降低 50%，并按标准费率的一半列出这些模型的批处理列。请注意 Pro 的上下文分层：代理循环每一步都会重新发送上下文，因此只引用低于 200k 的数字会低估成本。此处未提取缓存、grounding 和工具调用项目，因此应将这些视为基础 token 费率，而不是总成本。Gemini CLI 配额会更详细地介绍请求计数部分。

决定候选名单的协议壁垒

Gemini CLI 确实支持自定义端点。其仓库内配置参考说明，GOOGLE_GEMINI_BASE_URL 可覆盖“Gemini API 请求的默认基础 URL（使用 gemini-api-key 身份验证时）”，除非目标是 localhost，否则必须使用 HTTPS；另有单独的 GOOGLE_VERTEX_BASE_URL 用于 Google 后来重命名为 Gemini Enterprise Agent Platform 的路径。Google 的渲染文档网站完全没有列出基础 URL 覆盖，因此该变量记录在仓库中，却未出现在发布的网站上——它确实存在，只是很容易被忽略。

真正的限制在于线路格式。在main 上发布的源代码中，该 URL 被传递给 @google/genai SDK，作为 httpOptions.baseUrl，并将 vertexai 设为 false，因此每个请求都会以 Google 原生 Gemini 协议发出，而且身份验证枚举既没有 OpenAI 兼容选项，也没有 Anthropic 选项。默认情况下，密钥通过 x-goog-api-key 标头传递；同一文件读取 GEMINI_API_KEY_AUTH_MECHANISM，将其设为 bearer 后，密钥会通过 Authorization 标头传递到 gemini-api-key 和 vertex-ai 路径——这只改变标头，不改变线路格式，因此也无法绕过限制。该源代码还包含一个未记录的 GATEWAY 身份验证类型：只要设置了 GOOGLE_GEMINI_BASE_URL，就会从环境中选择它——优先级高于 GEMINI_API_KEY，仅低于显式的 Google 登录和 Vertex 开关——并且其密钥会回退为空字符串。配置文档中完全没有出现“gateway”一词；它是从代码中读取出来的，而不是 API 契约，并且仍然使用原生协议，因此什么也解决不了。

Kunavo 提供 /v1/chat/completions、/v1/messages 和 /v1/responses。于 2026 年 9 月 21 日重新探测：api.kunavo.com/v1/models 返回 401，而 /v1beta/models 和 /v1beta/models/<model>:generateContent 均返回 404。Kunavo 不是 GOOGLE_GEMINI_BASE_URL 的有效目标，假装可以使用只会浪费你一个下午。应更换客户端，而不是端点。

Kunavo 也不提供 embedding、文本转语音或语音转文本模型，因此需要其中任何功能的工作流，都必须在该步骤继续使用现有提供商。

Antigravity CLI 也受到同一协议壁垒限制。其安装和身份验证文档说明，你可以“使用自己的 Gemini API 密钥运行，而不是使用已登录的 Google 账号”，并设置 GOOGLE_GEMINI_BASE_URL 来访问“不同的 Gemini 兼容端点”——是 Gemini 兼容，而不是 OpenAI 兼容。另一方面，其方案页面说明，目前不支持“通过自带密钥或自带端点来获得额外的速率额度”。这两项说明彼此兼容，而限定条件至关重要：你可以使用自己的密钥运行，但这样不会增加订阅配额。其Individual 层级列为每月 $0（已于 2026 年 9 月 21 日检查），且任何层级都没有列出数值速率限制。请严格理解该层级的包含内容：其下方列表列出模型访问权限、无限 Tab 补全、无限命令请求和“基本每周速率限制”，但没有提到 CLI——该页面唯一将 CLI 列在其中的方案，是通过 Google Cloud 提供的组织方案。该页面也没有回答免费层级是否可以访问 agy。

哪种替代方案适合哪种离开原因

状态于 2026 年 9 月 21 日从 GitHub REST API 和 npm 注册表读取。关于 OpenCode 有一项注意事项：另一个 opencode-ai/opencode 仓库自 2025 年 9 月起已归档，后续作为 Crush 继续，因此在那里找到的配置或价格描述的是 Crush 的谱系，而不是 OpenCode 的谱系。请在 Crush 与 OpenCode 对比中比较二者，并参阅 Qwen Code 定价了解其路由成本。

哪些内容会迁移，哪些内容会被留下

Qwen Code 是最短的迁移路径，因此值得精确核算。双方文档均于 2026 年 9 月 21 日读取：Gemini CLI 的配置参考和扩展参考，以及 Qwen Code 的设置和身份验证页面。下面关于谱系的说法来自 Qwen Code 自己的README，其中说明该项目最初基于 Gemini CLI v0.8.2，并在 Qwen Code v0.1 时停止与上游同步。

Antigravity 路径有自己的迁移说明，而且范围比初读时更窄：其CLI 概览称，引导流程“支持一次性导入，以自动迁移现有的 Gemini CLI 扩展、技能和设置”。它明确列出了这三项，但没有提及聊天历史、检查点和 Shell 历史记录——这既不是对它们的承诺，也不是否定。

对于 Qwen Code 路径，完整改动只是一个合并后的设置块。在环境中设置密钥，将基础 URL 指向 API 的 /v1 根路径，而不是完整的 chat-completions 路径，并将 GEMINI.md 保留在上下文列表中，以便继续加载现有项目指令：

{
  "context": { "fileName": ["QWEN.md", "GEMINI.md"] },
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-4-6",
        "name": "Claude Sonnet 4.6 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": { "KUNAVO_API_KEY": "sk-kn-..." },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "claude-sonnet-4-6" }
}

回滚成本很低，值得在开始前安排好。这些操作都不会触及你的 Gemini CLI 安装：Qwen Code 设置不会改动 ~/.gemini/；如果你仍持有 Code Assist Standard 或 Enterprise 许可证，或仍有付费 Gemini 密钥，gemini 会完全按之前的方式继续工作。在新客户端上端到端完成一个真实任务之前，请继续为原路径提供资金。无论如何，先将 ~/.gemini/settings.json 复制到安全位置——它是最可能被手动编辑两次的文件。

新客户端的示例估算

这是说明性的 token 算术，不是测得的任务成本，也不是账单上限。假设一次代理会话包含 10 个步骤，每一步发送 60,000 个未缓存输入 token——循环会在每一步重新发送上下文——并接收 1,500 个输出 token：输入总计 600,000，输出总计 15,000。模型中不包含缓存、工具调用开销或重试，实际会话的差异可能大于下面的差距。费率是实时的Kunavo 目录每百万 token 价格。

离开客户端并不意味着离开模型系列：Kunavo 目录中同时提供 Gemini、Claude 和 GPT 模型，因此 Qwen Code 或 OpenCode 设置仍可以调用 Gemini 3.8 Flash。请查看当天的实时目录，了解列出的内容。Kunavo 目录金额是计费下限，而不是上限——上游报告费用后，账单金额取目录成本与上游成本乘以适用加价之间的较大值。预付余额的最低充值额为$10，这是资金最低限额，而不是任务费用或订阅费用；请参阅计费详情。

请注意该表回答的是哪个问题。列出的最低费率与完成任务的最低成本是不同的说法：一个低费率但需要三次尝试的模型，成本可能高于一次成功完成任务的模型。先根据费率列出候选项，然后在自己的仓库上测量一个范围明确的任务，并查看账户实际记录的成本。

完成设置并检查第一个任务

Kunavo 为最接近的迁移路径发布了设置参考。这是已发布的配置页面，而不是兼容性测试——此处尚未对 Qwen Code 与 Kunavo 端点进行运行时测试，本页面上的其他客户端也没有进行此类测试。请从 Qwen Code 集成指南开始；如果其他方案更符合你的离开原因，也可以查看 OpenCode、Crush、Cline 和 Aider 页面。准备为密钥充值时，请创建 Kunavo 账号。

仍在决定是否要切换客户端？Gemini CLI 与 Claude Code直接比较两者的工作流，而OpenCode 提供商对比则从另一端讨论相同的路由问题。

常见问题

仓库和 npm 状态、Google 的弃用与定价页面、Antigravity 的安装与方案文档，以及 Qwen Code 自己的配置文档，均于 2026 年 9 月 21 日检查；Kunavo 端点探测也于同日重新运行。本页面的任何内容都未经过运行时测试：没有安装任何 CLI，也没有针对任何端点运行会话。Kunavo token 费率来自实时目录，美元示例是说明性的 token 算术。