大约 1 分钟
CC-Switch 配置 Gemini
本页说明如何通过 CC-Switch 配置 Gemini CLI。
一、准备信息
- 已完成通用步骤：/docs/ccswitch/1-common.html
- 已创建 Gemini 分组令牌：/docs/register/4-token.html
- 本机可执行
gemini --version
参数：
- API 地址：
https://www.yuzhixiaolongxia.com/v1 - API Key：Gemini 分组令牌
二、配置流程
- 打开 CC-Switch，进入
Providers - 新建配置，应用选择
Gemini Base URL填https://www.yuzhixiaolongxia.com/v1- 填入
API Key - 模型填写当前分组支持的 Gemini 模型名
- 保存并启用
提示：
- Gemini 的模型名和官方原始命名可能不同，以平台分组实际可用列表为准
- 如果你配置了多个 Gemini 分组，建议逐个命名避免混淆
三、验证方式
gemini进入会话后发送一条短问题，能够正常返回即表示生效。
四、常见错误
| 现象 | 原因 | 处理方式 |
|---|---|---|
permission denied | 令牌分组权限不足 | 重新创建 Gemini 分组令牌 |
model not found | 模型别名不匹配 | 使用分组支持的模型名 |
connection timeout | 网络或代理问题 | 先做网络连通检查 |
| 启用后仍失败 | CLI 仍在读旧配置 | 关闭终端并重开 |
五、建议
- 先用短问答验证，再执行长任务
- 遇到地区限制或网络波动时，优先检查网络和代理配置
- 令牌泄露风险较高时，立即删除并重建
上一步：Codex 配置
下一步：CC-Switch CLI