Gemini CLI 国内能用吗?停服后3条接入路线对比封面图
AI 编程约 6 分钟

Gemini CLI 国内能用吗?停服后3条接入路线对比

AI 指南··◉ 0 浏览

结论先给:Gemini CLI 国内能用,但有个前提,你自己准备一个能用的 Gemini API Key。2026 年 6 月 18 日起,Gemini CLI 已停止处理「用 Google 账号登录」的免费通道,Google AI Pro 和 Ultra 的登录方式也一并停掉。想在国内网络环境里把它跑起来,路线就三条:官方 Key 直连、自建代理、第三方 API 中转。

Gemini CLI 开源仓库 GitHub 界面,含认证方式说明

先确认现象:不是装坏了,是认证断档

如果你看到「This client is not supported for Gemini Code Assist for individuals」这句报错,别急着重装。这是认证问题,不是安装失败。Gemini CLI 本体仍是 Apache-2.0 开源、仍在维护(v0.49.0),配好 API Key 就能继续跑。它只是不再把你以前那种免费的 Google 账号登录当成合法凭证。

为什么突然就断:2026 年 6 月 18 日停服

谷歌在 2026 年 5 月发了公告、6 月 18 日落地:Gemini Code Assist 的免费个人档、以及 Gemini 的 Pro/Ultra 订阅登录通道都关闭了。对普通开发者,免费的免配置入口没了,但工具本没问题。

官方口径:迁移到 Antigravity

按 Google Cloud 的说明,后续产品已整合进 Antigravity 多代理平台,Antigravity CLI 是新的官方方向,有异步多代理能力。Gemini CLI 并没有被删,只是把免费登录换成了 Key 认证,两条路都能走。

国内三条接入路线对比

路线 怎么做 维护成本 适合谁
路线一:官方 Key 直连 拿到 Key 后直连官方接口,网络通畅即可 低 网络能直达 Google 的人
路线二:自建代理 在海外节点做反向代理,转发 Gemini API 中 有服务器、懂网络的人
路线三:第三方 API 中转 用提供 Gemini 兼容接口的中转站托管 低 不想自建代理的多数人

三条里,自建代理最可控,中转最省心但要把代码交给第三方。敏感、隐私项目建议优先自建或直连。

Gemini CLI 国内三条接入路线示意图:直连、自建代理、第三方中转

第一步:先给自己备一个 Gemini API Key

到 Google AI Studio 的 API Key 页面(aistudio.google.com/app/apikey)创建一个 key,并在 Gemini API 里把计费打开。然后让 CLI 读得到它:

  1. 打开终端,编辑 shell 配置文件(如 ~/.zshrc 或 ~/.bashrc)。
  2. 写入 export GEMINI_API_KEY="你的key"。
  3. 执行 source ~/.zshrc,让变量生效。
  4. 重启 gemini,加载后即可跑起来。

详细的 Key 获取步骤可以参考 Gemini 4 Argon API Key 获取 5 步教程;不熟悉 Gemini 生态的,把 Google AI Studio 免费白嫖与 API 教程 也顺道看一遍。

Google AI Studio 创建 Gemini CLI 所需的 API Key 界面

注意别把 Key 明文提交到 git 仓库。

走自建代理 / 中转时的认证要点

走代理或中转时,通常要把 baseUrl 换成中转站给的域名,再配一个中转站 Key,而不再用你自己的 Google Key。模型能力不变,只是帮你绕开了网络。配置这类常出问题,报错后优先检查字段有没有写对。只想先在线试一把的话,Gemini 学生认证教程 里有弄到低价额度的流程;想本地对照另一个国内可用的工具,可以看看 Grok Bot 国内使用教程。

常见报错与排查速查

报错 原因 解法
This client is not supported 还在用 Google 账号登录 改用 API Key 认证
401 验证失败 Key 复制不完整或计费未开 重新检查 Key 与账单
超时 / 连不上 直连被网络阻断 换代理或中转
429 限流 免费额度触顶 稍等或用中转套餐

预防:2026 年 9 月还有第二道限制

按公开资料,2026 年 9 月起一批不受限的 Standard Key 会被进一步收紧停用。与其反复换配置,不如一次配好一个开通计费的正规 Key 更省心。

常见问题

Gemini CLI 国内完全不能用了吗?

不是。工具没下线(Apache-2.0、仍在维护),只是 2026-06-18 免费的 Google 登录通道停了。配一个计费的 Gemini API Key 就能继续跑,直连不行就选代理或第三方中转。

不花钱还能用 Gemini CLI 吗?

官方免配置通道已关闭。想试可以用 API Key 的免费额度,用完之后按量计费;第三方中转也可能提供免费档,但限额和质量要单独评估。

GEMINI_API_KEY 怎么获取?

到 Google AI Studio(aistudio.google.com/app/apikey)申请一个 Key,并在 Gemini API 里开启计费。拿到后写进 ~/.zshrc 或 .env 的 GEMINI_API_KEY 变量即可。

走代理或中转会不会封号?

用 Key 方式接入一般没有异地登录类的认证风险,真正的顾虑是第三方中转会经手你的代码,介意隐私就用官方 Key 直连或自建代理。

Gemini CLI 和 Antigravity 是什么关系?

谷歌把 CLI 产品迁移到 Antigravity 多代理平台,Antigravity CLI 是新的官方方向;Gemini CLI 作为开源工具仍在维护,用 Key 也能接入。

评论 (0)

?
0/1

还没有评论,来发第一条吧

网站上的服务均为第三方提供,
请用户注意自行甄别。

北京酷讯互动科技有限公司

备案京ICP备2024094994号-29

© 2026 AI345 · All Rights Reserved

用户服务协议·隐私政策