大约 1 分钟
Gemini 手动配置
本页用于 Gemini CLI 的手动接入，并说明与官方默认认证方式的差异。
一、配置文件位置
| 系统 | 路径 |
|---|---|
| Windows | %USERPROFILE%\\.gemini\\.env |
| macOS | ~/.gemini/.env |
| Linux | ~/.gemini/.env |
二、写入 .env 配置
GOOGLE_GEMINI_BASE_URL=https://www.yuzhixiaolongxia.com
GEMINI_API_KEY=替换为你的Gemini分组令牌
GEMINI_MODEL=gemini-2.5-pro令牌来源：
- 在控制台创建 Gemini 分组令牌：/docs/register/4-token.html
三、Gemini 的认证差异说明
官方生态常见的是 Google 原生认证链路；在本平台接入时使用的是统一 API 网关，因此你需要：
- 使用平台提供的
GEMINI_API_KEY - 使用平台网关地址作为
GOOGLE_GEMINI_BASE_URL
不要混用 Google 原生 Key 与本平台 Key。
四、验证步骤
- 重开终端
- 执行：
gemini- 输入短问题测试，能正常返回即成功
五、常见错误
| 现象 | 原因 | 处理方式 |
|---|---|---|
permission denied | 令牌权限不对 | 重建 Gemini 分组令牌 |
model not found | 模型名不可用 | 改用分组支持模型名 |
region unavailable | 网络/地区限制 | 切换网络后重试 |
| 改完 .env 仍失败 | 终端缓存旧环境 | 完全退出终端再启动 |
六、稳定使用建议
- 首次接入后先跑最小测试任务
- 长任务前检查余额和限额
- 如果是团队环境，统一
.env模板并分发
回到章节首页：/docs/cli/