Gemini CLI 网络配置教程

Gemini CLI 需要访问 Google 的登录服务和 Gemini API，二者都对出口地区有要求。

安装#

npm install -g @google/gemini-cli
gemini --version

第一步：导入订阅并选择节点#

按 Codex CLI 教程 导入订阅。Gemini API 并非在所有地区可用，建议选择 美国、日本、新加坡 等节点，避免香港等不受支持的出口。

第二步：让 Gemini CLI 走代理#

TUN 模式（推荐）：开启后直接运行 gemini，首次使用时选择「Login with Google」，浏览器授权会自动走代理。

环境变量：

export HTTPS_PROXY=http://127.0.0.1:7897
export NO_PROXY=localhost,127.0.0.1,::1
gemini

Windows PowerShell：

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

Google 登录完成后会回调本机端口，NO_PROXY 中的 localhost 不能省略。

使用 API Key（可选）#

如果你在 Google AI Studio 创建了 API Key，也可以跳过网页登录：

export GEMINI_API_KEY="你的 key"
gemini

验证与排查#

curl -fsSL https://app.keepkite.com/check.sh | bash
gemini -p "hello"

• 提示 User location is not supported：出口地区不支持，换节点。
• 登录页面打不开或回调失败：检查 TUN 是否开启、NO_PROXY 是否包含 localhost。

更多见 故障排查。