手动配置 Gemini

参考文档中，Gemini 的手动配置方式比较直接：进入配置目录后创建 .env 文件，再写入请求地址、密钥和模型名。

提示

Gemini 这类客户端最容易出错的地方，是把 .env 放错目录，或者变量名写成了别的工具格式。建议严格按本页示例填写。

第一步：打开 Gemini 配置目录

根据系统选择对应命令，打开 Gemini 的配置目录。

start "" "%USERPROFILE%\\.gemini"

open "$HOME/.gemini"

第二步：创建 .env

在 ~/.gemini 目录下创建 .env 文件：

GOOGLE_GEMINI_BASE_URL=https://waihub.top
GEMINI_API_KEY=sk-xxxxxxxx
GEMINI_MODEL=gpt-5.4

推荐做法

第一次接入时，先只测试一个确定可用的模型。等接口验证通过后，再逐步补充更多模型配置。

第三步：填写 Waihub 实际参数

其中：

• GOOGLE_GEMINI_BASE_URL 填 Waihub 提供的 Gemini 渠道地址
• GEMINI_API_KEY 填 Waihub 后台生成的 Gemini 对应密钥
• GEMINI_MODEL 填 Waihub 实际可用的 Gemini 模型名

第四步：启动 Gemini 验证

保存后，在终端运行：

gemini

建议先发起一轮简单对话，例如：

hello

如果接口地址、密钥和模型名都正确，通常这里就能直接得到响应。

发起一次简单对话，确认是否成功。

注意事项

• .env 文件需要放在 ~/.gemini 目录下
• 模型名称需要以 Waihub 实际提供的名称为准
• 遇到调用失败时，先确认地址和 key，再考虑是否是模型名问题

注意

如果客户端不支持自定义 endpoint，那么即使 .env 填写正确，也不会真正走 Waihub 渠道。这种情况要先确认客户端能力边界。