Gemini CLI 国内怎么用?安装、Google 登录、终端代理一次讲清
Gemini CLI 是 Google 开源的命令行 AI 编程助手,在终端里读代码、改文件、执行命令,用 Google 账号登录就有免费额度。在国内用,常卡在三处:
- 终端里一直连不上、超时
- 浏览器里的 Google 登录页打不开
- 提示所在地区不支持
为什么
连不上:Gemini CLI 要连的 Google 服务在墙外。而且浏览器能上不代表终端能上 —— 系统代理只对浏览器和大部分图形软件生效,命令行程序要单独设置。
地区不支持:Gemini 不对中国大陆和香港提供服务。出口在香港照样会被拒,很多人卡在这里以为是网络问题。
登录打不开:Gemini CLI 第一次运行会打开浏览器走 Google 登录,浏览器那边也必须连着 VPN。
第一步:安装
Gemini CLI 需要 Node.js 20 或更高版本。npm 官方源在国内慢,可以临时用国内镜像:
npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com
第二步:让终端走代理
方法一(Windows 推荐):在 DopeVpn 里打开「增强模式」,所有程序都会走 VPN,终端也不用再设置。
方法二:在终端里设置代理环境变量。DopeVpn 桌面版默认的本地代理端口是 2080(被占用时会自动换一个)。
macOS / Linux:
export HTTPS_PROXY=http://127.0.0.1:2080
export HTTP_PROXY=http://127.0.0.1:2080
Windows PowerShell:
$env:HTTPS_PROXY="http://127.0.0.1:2080"
$env:HTTP_PROXY="http://127.0.0.1:2080"
只对当前终端窗口有效,想一直生效就写进 shell 的配置文件。
第三步:登录
在项目目录里运行 gemini,选择用 Google 账号登录,会打开浏览器。浏览器先连上 VPN,登录完回到终端就能用了。
账号建议:Google 账号的语言和地区不要设成中国大陆,两步验证提前配好验证器 App 或备用码 —— 手机上的「Google 提示」在国内经常收不到。
常见报错
- 超时 / 连接失败:终端没走代理,回到第二步。
- 地区不支持 / 403:出口在香港或其它不支持的地区。
- 登录页一直转圈:浏览器没连 VPN。
用 DopeVpn 的话
Gemini CLI 用到的 Google AI 接口(Code Assist、Gemini API、AI Studio)在 DopeVpn 的 AI 专线名单里,会自动从 Gemini 支持的地区出去,不会因为你选了香港节点就被拒,也不用来回切节点。
注册送 3 天试用(每天 2GB,不用绑卡):
注册即送 3 天免费试用,装好 app 一键连接,畅游全球互联网
免费开始使用 →