Gemini CLI 代理怎么设置：HTTP_PROXY 与 HTTPS_PROXY
了解 Gemini CLI 的 HTTP(S) 代理设置方式，按当前版本配置 HTTPS_PROXY、HTTP_PROXY，并验证主模型请求是否经过代理。
Gemini CLI 代理怎么设置：HTTP_PROXY 与 HTTPS_PROXY
配置 Gemini CLI 代理 IP 前，先确认当前版本读取的代理环境变量及支持的协议，再从设置变量的同一终端启动 CLI。代理环境变量决定请求是否尝试经由指定网络出口连接；HTTP、HTTPS、SOCKS5 是接入协议，不代表代理 IP 的住宅属性或质量。
先确认当前 Gemini CLI 版本读取哪些代理变量
先记录 Gemini CLI 版本、操作系统和安装方式，再查看该版本文档或帮助信息，确认它实际读取哪些代理变量以及支持哪些协议。不要预设 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 或 SOCKS5 一定可用；官方配置说明见 Gemini CLI 配置文档。
为当前终端的 Gemini CLI 主模型请求设置 HTTP(S) 代理
以下示例针对 Gemini CLI 主模型请求的 HTTP(S) 代理环境变量；不据此推断 MCP、沙箱或工具子进程一定继承同一设置。先记录安装版本，并确认该版本支持相应变量，再从设置变量的同一终端启动 CLI：
```powershell
$env:HTTPS_PROXY = "http://主机:端口"
$env:HTTP_PROXY = "http://主机:端口"
gemini --help
gemini
```
```bash
export HTTPS_PROXY="http://主机:端口"
export HTTP_PROXY="http://主机:端口"
gemini --help
gemini
```
以上分别是 PowerShell 与 Linux/macOS shell 设置当前终端变量的示例。是否读取变量取决于 Gemini CLI 版本；核实版本文档与 gemini --help 后，再用低风险主模型请求及代理日志验证。不要把含凭证 URL 写入共享脚本、命令历史或截图。本节不提供 SOCKS5/ALL_PROXY 配置承诺，因为当前可核实的官方读取链未确认支持它们。
临时使用后可清除本节设置的变量：PowerShell 用 Remove-Item Env:HTTP_PROXY,Env:HTTPS_PROXY -ErrorAction SilentlyContinue；Linux/macOS 用 unset HTTP_PROXY HTTPS_PROXY。若变量原本已存在，先记录原值并在结束后恢复。
检查 Gemini CLI 是否经过代理并连通服务
从设置变量的同一终端发起一条低风险主模型请求，结合代理侧连接日志确认该请求是否经过代理。MCP、沙箱和工具子进程需分别验证各自网络路径。CLI 无法连接代理时，可参照已发布的代理 IP 连接排查表检查主机、端口和认证。
| 现象 | 检查项 | 下一步 |
|---|---|---|
| CLI 未读代理设置 | 变量名称、大小写、启动终端及版本行为 | 对照当前版本官方说明 |
| 代理认证失败 | 主机、端口、凭证格式和凭证字符转义 | 修正接入参数并保护凭证 |
| 网络正常但服务报错 | CLI/API 认证、配额、服务状态和请求参数 | 按服务端错误分层排查 |
FAQ
设置 HTTPS_PROXY 后，怎么确认 Gemini CLI 确实走了代理？
从设置变量的同一终端启动 CLI，发起一条低风险请求，并结合进程环境、客户端或代理日志、出口检测确认请求路径。仅看到变量已设置，不能证明当前版本的 CLI 已读取它。
HTTP 和 SOCKS5 哪个更适合？
本文示例使用 HTTP(S) 代理变量。当前版本是否支持其它代理协议，应查该版本文档；设置未确认读取的变量不能证明请求已使用相应代理。协议本身也不能说明代理 IP 的住宅/机房属性或业务结果。