Gemini CLI 怎么配置 API Key 和代理地址？Sublyx 接入方法

准备工作

• 运行 gemini --help，确认当前安装包提供的认证、模型和配置选项。
• 查阅该安装版本对应的 Gemini CLI 文档，确认 API Key 变量和自定义 Base URL 字段。
• 在 Sublyx 创建 API Key，并从 模型列表复制当前可用的 Gemini 模型 ID。

具体配置

若当前版本采用常见的 Key 环境变量，可在当前 Shell 设置：

export GEMINI_API_KEY=your-sublyx-key

PowerShell 对应写法为：

$env:GEMINI_API_KEY = "your-sublyx-key"

然后在当前版本明确提供的 OpenAI 兼容服务商或自定义端点配置中填写：

配置项	值
Base URL	https://api.sublyx.org/v1
API Key	你的 Sublyx API Key
Model	模型列表中的 Gemini 模型 ID

不要猜测 Base URL 环境变量名。若当前版本只支持 Google 原生 Gemini 端点、不支持 OpenAI 兼容自定义端点，就不能仅靠替换 Key 和地址接入 Sublyx。若你需要的是网络代理，应按系统方式设置 HTTPS_PROXY，它与 API Base URL 不是同一个概念。

最小验证请求

在运行 Gemini CLI 前，先直接验证 Sublyx Key、模型 ID 与网络：

curl https://api.sublyx.org/v1/chat/completions \
  -H "Authorization: Bearer $SUBLYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_GEMINI_MODEL_ID",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "只回复 OK"}]
  }'

接口验证成功后，再按 gemini --help 显示的非交互调用方式发送同样的短提示；具体参数名以当前安装版本为准。

常见错误

现象	处理方法
仍请求 Google 官方域名	当前 Base URL 配置未生效，或该版本不支持自定义兼容端点。
401	确认 CLI 实际读取的是哪一个 Key 变量，并清除冲突的旧凭据。
404	检查兼容地址是否为 https://api.sublyx.org/v1，以及客户端是否重复追加路径。
model not found	从模型列表复制准确模型 ID，不把 Google 展示名当作 API ID。
连接超时	区分系统网络代理与 API Base URL；参考 API 超时排查方法逐段定位。

安全说明

不要把真实 Key 写入仓库中的 .env、Shell 脚本或公开 issue。优先使用用户级安全存储或仅在当前终端注入环境变量；日志和截图中应遮盖 Key。接口与认证概览见 Sublyx 文档，兼容网关的能力边界见 AI API 聚合网关指南。