Gemini CLI 怎么设置代理

Gemini CLI 需要连哪些地方

使用 Gemini CLI 时，网络请求大致分两段：

1. 登录：通过浏览器完成 Google 账号授权，再把结果交回本机的命令行；
2. 调用模型：命令行持续向 Google 的接口发送请求并接收回复。

两段都需要能访问 Google 的服务。浏览器那一段通常已经走了系统代理，问题多出在命令行这一段。

方法一：TUN 模式

上图为星岛梦在珠海联通骨干网下的全节点测试，落地 IP 纯净度高，无 Cloudflare 人机阻断，完美适配 ChatGPT 与 Claude。

TUN 模式会接管整台电脑的流量，Gemini CLI 不需要任何额外配置。打开客户端的 TUN 开关（Clash Verge Rev 需先安装服务模式），保持规则模式，确认 Google 相关流量走的是支持地区的节点即可。

方法二：环境变量

先在客户端里查看混合端口或 HTTP 端口，常见是 7890 或 7897，以你自己客户端显示的为准。

macOS / Linux

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

写入 ~/.zshrc 或 ~/.bashrc 可以长期生效。

Windows PowerShell（当前窗口）

$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:HTTP_PROXY="http://127.0.0.1:7890"

Windows CMD（当前窗口）

set HTTPS_PROXY=http://127.0.0.1:7890
set HTTP_PROXY=http://127.0.0.1:7890

Windows 长期生效

可以用 setx 写入用户环境变量，写入后对新打开的终端窗口生效：

setx HTTPS_PROXY http://127.0.0.1:7890
setx HTTP_PROXY http://127.0.0.1:7890

怎么确认变量已经生效

设置之后，可以先在同一窗口里查看变量值，确认没有拼写错误：

echo $HTTPS_PROXY

Windows PowerShell 用 echo $env:HTTPS_PROXY，CMD 用 echo %HTTPS_PROXY%。输出为空说明变量没有设置成功，或者你是在另一个窗口里设置的。另外要注意，变量值要以 http:// 开头，端口要填客户端的混合端口或 HTTP 端口，而不是 SOCKS 专用端口。

登录环节的注意事项

• 浏览器和命令行用同一个地区：浏览器授权和命令行请求的出口地区不一致，可能导致授权异常；
• 本地回调：如果登录时浏览器显示成功、命令行却一直等待，可以加上 NO_PROXY=localhost,127.0.0.1，让本地地址不走代理；
• 账号类型：个人 Google 账号和公司、学校的 Workspace 账号权限不同，Workspace 账号可能需要管理员开启相关服务。

节点怎么选

命令行工具一次任务可能持续较长时间，中途网络断开就要重来，所以节点的稳定性比速度更重要：

• 选 Gemini 支持地区的节点，美国、日本、新加坡等是常见选择，以 Google 官方公布的可用地区为准；
• 在客户端里给 Google 相关流量所在的策略组固定一个节点，不要设置成自动测速切换；
• 浏览器登录时用的节点和命令行使用的节点保持同一地区；
• 晚高峰经常超时，可以考虑线路更稳定的中转或专线节点。

验证网络是否通

在同一个终端窗口执行：

curl -I https://generativelanguage.googleapis.com

Windows PowerShell 中请用 curl.exe。能返回 HTTP 状态码说明网络已通；超时说明代理没生效，检查端口和客户端状态。

常见问题

网络通了但提示地区不支持？ 中国大陆和香港不在 Gemini 的支持范围内。先确认出口 IP 所在地区，再检查 Google 账号本身关联的国家或地区，详见 Gemini 地区不支持怎么解决。

设置了变量，换个窗口又不行了？ export、$env:、set 都只对当前窗口有效，需要写进配置文件或用 setx。

和 Claude Code、Codex 的设置一样吗？ 思路一样，都是让终端走代理。差别主要在登录方式和出口地区要求，可对照 AI 工具使用专题 里的其他文章。