Gemini CLI 国内怎么用?Clash Verge访问配置指南

Gemini CLI 受到开发者关注后,许多国内用户会遇到安装包下载缓慢、登录页面无法打开、授权回调失败,以及命令行调用模型超时等问题。这里的关键通常不是“节点能不能打开某个网页”,而是 Gemini CLI 的不同请求是否都经过了正确的代理路径。浏览器、桌面客户端和终端程序可能使用不同的网络设置,因此需要把 Clash Verge 的配置、系统代理和终端环境变量分别确认。

本文以 Clash Verge 或 Clash Verge Rev 的常见桌面操作为例,说明如何导入订阅、选择可用节点、配置分流规则,并让 Gemini CLI 使用本地代理端口。不同版本的客户端界面名称可能略有差异,实际端口、内核版本和配置字段应以当前安装版本显示的内容为准。Gemini 服务的地区可用性、账号政策和接口限制也可能变化,使用前应遵守相关服务条款,不要把代理配置或账号凭据公开分享。

先理解 Gemini CLI 需要访问哪些网络路径

Gemini CLI 并不是只连接一个固定网址。首次运行时,可能需要访问登录页面、账号授权服务、回调地址和模型 API;安装或更新过程中,包管理器还可能访问 npm 仓库及其依赖下载地址。即使浏览器可以打开 Gemini 网页,也不能直接证明命令行已经具备同样的访问条件。

命令行工具常见的网络请求可以分为三类。第一类是安装和更新请求,例如通过 npm、其他包管理器或安装脚本获取软件包;第二类是 OAuth 登录过程,包括浏览器授权和本地回调;第三类是运行期间的模型请求,通常需要保持 HTTPS 连接稳定,并正确处理域名解析、TLS 握手和长时间响应。

环节 常见表现 优先检查项目
安装与更新 下载超时、依赖获取失败 终端代理变量、包管理器配置、节点连通性
账号授权 登录页打不开、授权后返回失败 浏览器代理、回调端口、防火墙和系统时间
模型调用 请求超时、连接中断、返回网络错误 API 请求是否进 Clash、规则命中情况、节点稳定性

因此,排查时不要一开始就反复更换配置文件。先确认 Clash Verge 正在运行,再确认 Gemini CLI 使用的是哪个本地代理端口,最后通过连接记录判断目标请求是否命中了预期策略组。只有这三步都成立,才有必要继续分析账号、地区或模型权限问题。

安装并准备 Clash Verge

建议使用仍在维护、能够运行 Mihomo 或兼容内核的 Clash Verge 类客户端。安装后先不要急着开启 TUN,也不要同时启动多个代理软件。多个客户端可能争抢系统代理、端口和默认路由,使浏览器与终端分别走向不同实例,最后出现“有的程序正常、有的程序失败”的混合现象。

打开 Clash Verge 后,先确认以下几项状态:

在 Clash 配置中,常见的本地监听设置类似下面的示例。它只用于说明字段关系,不建议直接覆盖订阅配置:

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

mixed-port 可以在一个端口上同时接收常见的 HTTP 和 SOCKS 代理请求,适合桌面程序和命令行工具共用。如果客户端分别显示 HTTP 端口和 SOCKS 端口,应根据工具支持情况选择对应协议。allow-lan: false 表示只允许本机访问,普通个人电脑一般不需要打开局域网代理。除非确实要给其他设备使用,否则不要为了“连接更方便”而把端口暴露到局域网或公网。

如果 Clash Verge 的系统代理开关打开,但终端仍然无法联网,不要立即认定客户端失效。很多终端程序只读取环境变量,不会自动读取 Windows 或 macOS 的系统代理设置。下一步应为终端显式设置代理,再观察连接结果。

导入订阅并选择稳定节点

在 Clash Verge 的配置或订阅页面添加服务商提供的订阅地址,然后执行更新。订阅链接通常包含账户识别信息,应当像密码一样保存,不要粘贴到公开 issue、聊天群或截图中。导入成功后,检查配置是否能够正常解析,节点列表、策略组和规则是否完整显示。

选择节点时,不要只看延迟数字。延迟测试往往只代表某个测试地址的往返时间,而 Gemini CLI 更依赖 HTTPS 建连成功率、持续传输稳定性和长连接表现。一个延迟较低但频繁断流的节点,可能不如延迟稍高却稳定的节点适合模型请求。

观察指标 参考意义 实际选择建议
延迟 反映测试目标的响应速度 用于初筛,不作为唯一标准
连接成功率 反映建立代理连接的稳定程度 优先选择连续测试较稳定的节点
持续响应 反映长请求或较大响应是否容易中断 适合模型调用、代码分析和长输出场景
策略组状态 反映规则命中后实际使用的出口 确认 Gemini 相关请求没有误走 DIRECT

如果订阅提供“节点选择”“自动选择”或“故障转移”策略组,初次排查可以先手动指定一个已知稳定的节点。自动选择适合日常使用,但它可能在测试过程中切换出口,使问题复现条件变得不稳定。等登录和模型调用确认正常后,再恢复自动策略或配置健康检查。

配置 Gemini 相关分流规则

规则分流的目标不是把所有流量都强制交给代理,而是让登录服务、模型 API 和必要的依赖域名进入合适的策略组。实际域名可能随 Gemini CLI 版本、认证方式和服务端调整而变化,因此不应只凭一份旧配置中的域名列表判断是否完整。最可靠的方法是先运行一次操作,在 Clash Verge 的连接记录中查看真实请求,再根据域名和用途补充规则。

如果订阅已经提供 AI 服务或 Google 服务规则,优先使用订阅自带的策略组,避免在覆写中重复添加互相冲突的规则。手工调整时,应把特定规则放在宽泛规则之前,并确保最终的 MATCH 位于规则列表末尾。下面是表达分流思路的简化示例,具体域名和策略组名称需要按当前配置修改:

rules:
  - DOMAIN-SUFFIX,googleapis.com,AI
  - DOMAIN-SUFFIX,googleusercontent.com,AI
  - DOMAIN-SUFFIX,generativelanguage.googleapis.com,AI
  - MATCH,主策略

示例中的 AI 必须是配置中已经存在的策略组名称。如果策略组实际叫“节点选择”或“Proxy”,规则写成不存在的名称会导致配置校验失败或运行行为异常。某些服务还会使用账号登录、授权和静态资源域名,不能假设模型 API 的一个域名就覆盖全部流程。

规则顺序同样重要。如果前面存在一条范围很大的直连规则,后面的 AI 规则不会再被检查;如果所有请求都被一条全局代理规则提前接管,局部直连规则也可能失效。修改后应重新载入配置,并在连接详情中查看命中的规则、策略组和最终出口。

动手设置 Gemini CLI 的终端代理

下面以本机 Clash Verge 的 mixed-port 为 7890 进行示例。若你的客户端显示的是其他端口,应将命令中的 7890 替换为实际值。设置前先在 Clash Verge 中打开系统代理或确认内核已运行,然后用显式代理命令测试普通 HTTPS 请求:

curl -I -x http://127.0.0.1:7890 https://example.com

如果这条命令返回响应头,说明终端能够连接本地 Clash 端口,并且 Clash 至少可以处理一个 HTTPS 目标。若返回 connection refused,优先检查端口和内核状态;若一直超时,则查看节点、规则和防火墙。普通网站测试成功后,还应观察 Clash 连接列表,确认请求确实被当前实例接收。

Windows 设置方法

在 PowerShell 中,可以为当前窗口设置临时环境变量:

$Env:http_proxy = "http://127.0.0.1:7890"
$Env:https_proxy = "http://127.0.0.1:7890"
$Env:HTTP_PROXY = "http://127.0.0.1:7890"
$Env:HTTPS_PROXY = "http://127.0.0.1:7890"

gemini

如果使用 CMD,可以执行:

set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890
gemini

环境变量只对当前终端窗口或由该窗口启动的进程生效。关闭窗口后,临时设置通常不会继续存在。建议先采用临时方式验证,确认 Gemini CLI 正常后,再决定是否写入 PowerShell 配置文件或系统环境变量。长期写入前要考虑办公网络、其他项目和内网地址是否也会被代理,避免给不需要代理的工具带来副作用。

macOS 与 Linux 设置方法

在 Bash 或 Zsh 中,可以先导出小写和大写变量:

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

gemini

如果使用 SOCKS 端口,也可以根据程序支持情况设置 all_proxy:

export all_proxy=socks5h://127.0.0.1:7891
export ALL_PROXY=socks5h://127.0.0.1:7891

socks5h 中的 h 表示目标域名由代理端解析,有助于减少本地 DNS 污染或解析失败造成的影响。不过并不是所有 Node.js 依赖或命令行程序都会自动支持 all_proxy,因此 HTTP mixed-port 通常更容易作为第一种测试方案。设置变量后,先执行安装、登录或模型调用,并同步查看 Clash 连接日志。

  1. 确认端口:从 Clash Verge 的设置或运行信息中读取实际 HTTP、SOCKS 或 mixed-port。
  2. 测试本地代理:使用 curl 显式指定代理,排除环境变量拼写问题。
  3. 设置当前会话:根据操作系统导出代理变量,不要立即修改全局配置。
  4. 启动 CLI:在同一个终端窗口中执行 Gemini CLI,确保变量能够被子进程继承。
  5. 查看连接记录:确认授权和 API 请求进入 Clash,并命中预期策略组。

登录、安装与模型调用故障排查

安装失败时,先区分是包管理器无法下载,还是安装完成后运行失败。可以检查包管理器是否读取了代理变量,并查看错误中出现的域名。如果只有某个依赖域名失败,应在 Clash 连接记录中确认它是超时、TLS 错误、DNS 失败还是被规则送往了直连。不要把所有错误都归因于 Gemini 服务本身。

登录流程通常比普通网页访问更复杂。浏览器可能通过 Clash 系统代理打开授权页面,但 CLI 启动的本地回调服务仍被防火墙拦截;也可能浏览器完成了登录,却没有将回调正确返回给正在等待的终端进程。遇到授权后卡住时,可以检查终端是否仍在监听回调端口、系统是否弹出了防火墙提示,以及浏览器地址栏中的回调页面是否被代理规则错误处理。

如果登录页能打开但授权失败,检查系统日期和时间是否准确,确认浏览器没有同时启用另一个代理扩展,并避免在多个终端窗口重复启动登录流程。部分认证流程会绑定临时状态或回调端口,旧进程没有退出时,新进程可能无法接收正确的返回信息。

模型调用超时则重点查看三段路径:CLI 到本地 Clash 端口、Clash 到节点出口、节点到模型服务。第一段失败通常表现为拒绝连接或代理变量无效;第二段失败通常表现为节点超时、TLS 建连失败或连接频繁重置;第三段还可能受到账号权限、地区限制、配额和模型名称有效性的影响。网络恢复后,如果服务端仍返回明确的权限或配额错误,就应转向账号和项目设置检查,而不是继续更换端口。

现象 可能原因 处理顺序
connection refused 端口错误、内核未启动或端口被占用 确认 Clash 运行状态和监听端口
请求长时间超时 节点不稳定、规则走直连或 DNS 异常 看连接记录,再更换稳定节点
浏览器成功、CLI 失败 终端未读取系统代理 设置 http_proxy 与 https_proxy
登录后无法返回 CLI 回调端口、防火墙或旧进程冲突 关闭旧进程并检查本地回调
返回权限或配额错误 账号、地区、项目或服务端限制 确认网络正常后检查账户状态

为了缩小范围,可以暂时把 Clash 日志等级调到 info 或更详细级别,重新执行一次操作,观察请求是否出现以及最终命中的策略。问题确认后恢复普通日志等级。不要在日志、截图或公开反馈中暴露订阅地址、访问令牌、账号邮箱和控制接口密钥。

稳定使用与安全注意事项

登录成功后,建议将节点选择、系统代理和终端变量整理成可复现的状态。不要长期依赖“浏览器刚好能打开”的临时条件。可以保留一个稳定策略组,定期更新订阅,并在更新后检查 AI 规则是否仍然存在。订阅更新后如果策略组名称改变,原有覆写规则可能指向不存在的目标,需要重新校验。

普通网页访问、代码仓库、包管理器和 Gemini API 不一定适合完全相同的分流策略。把所有流量都交给代理会增加延迟和资源消耗,把所有流量都设置为直连又可能导致 CLI 请求失败。更合理的做法是使用规则模式,让明确需要代理的服务进入指定策略组,国内网站和局域网地址按实际需要直连。

TUN 模式可以接管更多不遵循系统代理的程序,但它涉及虚拟网卡、DNS、路由和系统权限,排查难度高于普通系统代理。第一次配置 Gemini CLI 时,建议先用 mixed-port 加环境变量完成验证,再考虑是否开启 TUN。如果启用 TUN 后出现 DNS 循环、局域网无法访问或其他软件异常,应分别检查虚拟网卡、DNS 模式和绕过列表,不要同时修改多个部分。

最后,订阅地址和 API 凭据都属于敏感信息。不要把包含认证参数的 URL 写入公开脚本,也不要将终端历史记录、完整 YAML 或环境变量截图上传到公共平台。使用共享电脑时,退出账号并清理持久化凭据;在公司或学校网络中使用代理,还应遵守所在网络的管理规定。

下载Clash