Gemini CLI 怎么设置代理？

Gemini CLI 是运行在终端里的命令行工具，它不会自动使用浏览器或系统代理，所以「网页能用、CLI 连不上」非常常见。解决方法有两种：在启动 Gemini CLI 的终端里设置代理环境变量，或者在代理客户端里开启 TUN 模式，让所有程序的流量都走代理。

截至 2026 年 9 月，Gemini 的地区判断同时参考出口 IP 与 Google 账号地区，节点优先选美国、日本、台湾或新加坡，避开香港。

第一步：确认本地代理端口

在 Clash Verge Rev 的设置页里找到端口设置，记下混合端口（HTTP 与 SOCKS 共用）。不同版本默认值可能不同，下文示例用 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
gemini

Windows PowerShell：

$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY = "http://127.0.0.1:7897"
$env:NO_PROXY = "localhost,127.0.0.1"
gemini

以上设置只对当前终端窗口生效。设置后可以先用一条简单命令验证出口是否已经走代理：

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

能返回 HTTP 状态码说明连通；长时间无响应则说明变量没有生效或端口填错。

第三步：环境变量无效时改用 TUN

部分运行环境不读取代理变量，或者子进程没有继承变量。这时直接开启 Clash Verge Rev 的 TUN 模式更省事，它在系统层接管流量，终端无需额外设置。开启方法见 Clash Verge Rev TUN 模式。

让设置长期生效

每次打开终端都重新输入变量很麻烦。macOS 与 Linux 用户可以把上面三行 export 写进 shell 配置文件（例如 ~/.bashrc 或 ~/.zshrc），重新打开终端后自动生效；Windows 用户可以在系统环境变量里新增同名变量，或写入 PowerShell 配置文件。需要注意，长期写入后，关闭代理客户端时终端里其他需要联网的命令也会失败，这时临时清空变量或重新打开客户端即可。

节点怎么选

Gemini CLI 的请求是持续的长连接，对丢包比延迟更敏感。建议手动固定一个美国、日本、台湾或新加坡的专线节点，关闭自动测速切换，并让浏览器登录与终端使用同一个节点，避免账号在两个地区之间来回跳动而触发验证。

常见报错对照

地区报错的完整排查可以看 Gemini 提示地区不可用怎么办。其他命令行 AI 工具的代理原理相同，Codex 的写法可参考 Codex CLI 代理设置。

总结

• Gemini CLI 不继承系统代理，需要设置 HTTPS_PROXY 与 HTTP_PROXY，或开启 TUN。
• 端口以 Clash Verge Rev 设置中显示的混合端口为准。
• NO_PROXY 加入 localhost 与 127.0.0.1，避免登录回调失败。
• 节点选美国、日本、台湾或新加坡，浏览器与终端保持同一地区。