摘要：CLI 在终端里运行，既不读浏览器代理也常不读系统代理，于是网页正常、命令行报错。要么在启动终端里设代理变量，要么开 TUN；节点选美国、日本、台湾或新加坡。
一分钟速查
- 设变量：HTTPS_PROXY 与 HTTP_PROXY 指向本地端口。
- 开 TUN：变量无效时更省事。
- NO_PROXY：加 localhost 与 127.0.0.1，避免登录回调失败。
- 节点：美国、日本、台湾或新加坡，避开香港。
第一步：确认本地代理端口
在客户端设置页找端口设置，记下混合端口。不同版本默认值可能不同，下文示例用 7897，请替换成你看到的端口。
第二步：在终端设置环境变量
设置代理变量
macOS、Linux 或 WSL 使用 bash/zsh：
export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897
export NO_PROXY=localhost,127.0.0.1
验证出口
设置后用一条简单命令验证出口是否已走代理：
curl -I https://generativelanguage.googleapis.com
能返回 HTTP 状态码说明连通；长时间无响应说明变量没生效或端口填错。
第三步：环境变量无效时改用 TUN
部分运行环境不读代理变量，或子进程没继承变量。这时直接开客户端的 TUN 模式更省事，它在系统层接管流量，终端无需额外设置。
让设置长期生效
每次开终端重输变量很麻烦。macOS/Linux 用户把 export 写进 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc），Windows 用户在系统环境变量里新增同名变量。注意长期写入后，关代理客户端时终端里其他联网命令也会失败，临时清变量或重开客户端即可。
关于 Gemini CLI 代理的 3 个误区
- 「网页能用 CLI 就能用」——终端多数不读系统代理，要设变量或开 TUN；
- 「设一次变量永久有效」——export 只对当前会话有效，长期要写配置文件；
- 「香港节点延迟低最好」——Gemini 地区判断参考出口 IP 与账号地区，香港要避开。