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

先确认现象:不是装坏了,是认证断档
如果你看到「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 API Key
到 Google AI Studio 的 API Key 页面(aistudio.google.com/app/apikey)创建一个 key,并在 Gemini API 里把计费打开。然后让 CLI 读得到它:
- 打开终端,编辑 shell 配置文件(如 ~/.zshrc 或 ~/.bashrc)。
- 写入
export GEMINI_API_KEY="你的key"。 - 执行
source ~/.zshrc,让变量生效。 - 重启 gemini,加载后即可跑起来。
详细的 Key 获取步骤可以参考 Gemini 4 Argon API Key 获取 5 步教程;不熟悉 Gemini 生态的,把 Google AI Studio 免费白嫖与 API 教程 也顺道看一遍。

注意别把 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 也能接入。

京ICP备2024094994号-29