用 CC Switch 切换 Gemini CLI 到 6星中转
Gemini CLI 的接入方式会随版本和兼容层变化。使用 CC Switch 时，优先按 6星中转 一键导入生成的字段为准；手动核对时，通常使用 https://www.6xin.cc/ 这类带末尾斜杠的根地址。
先看结论：Gemini CLI 速填表
| 配置项 | 6星中转 应该怎么填 | 错了会怎样 |
|---|---|---|
| 应用页 | 在 CC Switch 顶部选择 Gemini。 | 配置写错应用页时，Gemini CLI 不会读取。 |
| API URL | 优先使用 6星中转 一键导入结果；手动核对通常是 https://www.6xin.cc/。 |
删掉末尾斜杠或套用 Codex 的 /v1 写法，可能导致路径异常。 |
| API Key | 使用能访问 Gemini 模型的 6星中转 令牌。 | 权限不足、模型不可见或请求直接失败。 |
| 验证方式 | 重开终端，发短问答，再查 6星中转 用量日志。 | 只看 CLI 启动成功，不能证明请求走 6星中转。 |
看这篇前
请先看 通用概念与配置，确认你已经知道 Provider、API URL、API Key、Model 的含义。本页只写 Gemini CLI 专属注意事项。
一、什么情况适合切 Gemini CLI
| 场景 | 是否适合 | 建议 |
|---|---|---|
| 官方账号受地区、网络或额度影响 | 适合 | 保存 6星中转 Provider，按需切换。 |
| 多个 Gemini 模型或分组并存 | 适合 | 按用途建 Provider，例如 6星中转-Gemini-fast、6星中转-Gemini-long。 |
| 测试环境和正式环境要隔离 | 适合 | 拆分令牌和 Provider，避免生产任务误用测试额度。 |
| 只偶尔试一次 Gemini | 可选 | 可以先用 6星中转 API 直测，再决定是否长期保存配置。 |
二、开始前准备
- 安装 Gemini CLI，并确认终端能执行。
- 在 6星中转 创建 Gemini 相关模型可用的令牌。
- 在模型广场复制当前可用的 Gemini 模型 ID。
gemini --version| 你需要的值 | 填写内容 | 注意 |
|---|---|---|
| API URL | https://www.6xin.cc/ |
优先使用一键导入结果；手动核对时保留末尾斜杠。 |
| API Key | sk-你的 6星中转 令牌 |
需要访问 Gemini 相关模型。 |
| Model | Gemini 可用模型 ID | 以 6星中转 模型广场为准，不要凭官方原名猜。 |
三、在 CC Switch 里添加 Gemini 配置
打开 CC Switch
顶部应用切换到 Gemini。
添加 Provider
名称建议写成 6星中转-Gemini 或带模型、用途后缀。
填写 6星中转 配置
API URL 使用一键导入结果，手动填时通常是 https://www.6xin.cc/。API Key 填 Gemini 分组可用令牌。
保存并启用
保存后点击 Enable，关闭旧 Gemini 终端，重开后测试。
| 字段 | 示例 | 说明 |
|---|---|---|
| Name | 6星中转-Gemini | 本地显示名。 |
| Provider / App | Gemini | 写入 Gemini CLI 配置。 |
| API URL | https://www.6xin.cc/ | 保留末尾斜杠；以一键导入为准。 |
| API Key | sk-你的令牌 | Gemini 可用令牌。 |
| Model | Gemini 可用模型 ID | 从 6星中转 模型广场复制。 |
四、为什么强调末尾斜杠
部分 Gemini CLI 或兼容层版本会按根地址拼接路径。末尾斜杠缺失时，某些路径拼接和重定向会变得不稳定。CC Switch 一键导入会尽量按应用规则生成字段；手动核对时，不要随手删掉最后的 /。
/v1；Codex 的重点是必须带 /v1；Gemini 的重点是按导入结果保留根地址格式，尤其不要删末尾斜杠。
五、验证切到 6星中转
- 关闭旧 Gemini CLI 终端。
- 打开新终端。
- 启动 Gemini CLI。
- 发送短句验证。
gemini回复：连接成功能正常返回后，到 6星中转 用量日志按时间点核对请求。如果日志中没有记录，说明 Gemini CLI 可能仍在走旧配置。
六、完成标准
| 检查项 | 应该看到什么 | 不满足时回到哪里 |
|---|---|---|
| CC Switch 启用项 | Gemini 应用下 6星中转-Gemini 处于使用中。 |
添加 Gemini 配置 |
| API URL | 优先使用一键导入结果；手动核对时是 https://www.6xin.cc/。 |
斜杠规则 |
| 新终端短问答 | Gemini CLI 能正常回复“连接成功”。 | 验证切到 6星中转 |
| 6星中转 用量日志 | 能看到刚才那次 Gemini 请求。 | 常见误区 |
七、版本或项目配置覆盖时怎么查
Gemini CLI 会读取用户设置、项目设置、环境变量和命令行参数。CC Switch 启用后仍失败时，先确认有没有这些覆盖来源。
| 覆盖来源 | 怎么安全检查 | 处理方式 |
|---|---|---|
| 环境变量 | test -n "$GEMINI_API_KEY" && echo GEMINI_API_KEY=setprintenv GEMINI_MODEL |
如果变量指向旧模型或旧认证方式，先清理当前终端变量再测。 |
| 用户设置 | 检查 ~/.gemini/settings.json 里是否写死模型或认证字段。 |
保留需要的字段，移除和 6星中转 冲突的旧配置。 |
| 项目设置 | 检查项目内 .gemini/settings.json。 |
如果只有某个项目失败，优先改项目级配置。 |
项目 .env |
只确认变量名，不打印完整令牌。 | 避免旧 GEMINI_API_KEY 覆盖 CC Switch 的配置。 |
| CLI 版本差异 | gemini --version |
版本变化后，优先重新使用 6星中转 一键导入，不要沿用旧字段猜测。 |
八、失败时按这个顺序排查
Gemini CLI 的字段会受版本影响，排障时优先相信 6星中转 一键导入结果。手动配置失败时，先确认路径格式，再看令牌分组、模型 ID 和本机网络。
确认 Gemini Provider 已启用
CC Switch 顶部应用必须在 Gemini 页，目标 6星中转-Gemini Provider 处于使用中。
重新导入或核对字段
如果手动填完失败，优先回 6星中转 令牌页重新使用一键导入。导入结果和手写字段不一致时，以导入结果为准。
保留根地址格式
手动核对时使用 https://www.6xin.cc/，不要删掉末尾斜杠，也不要套用 Codex 的 /v1 写法。
核对令牌和模型 ID
permission denied 多半是 Gemini 分组不匹配；model not found 多半是模型 ID 没有从 6星中转 模型广场复制。
看网络和 6星中转 日志
超时先检查本机网络、代理和状态页。短请求返回后，再到 6星中转 用量日志确认请求确实进了平台。
这些情况先停下来，不要继续猜 Gemini 字段
Gemini CLI 的字段会随版本变化。手动配置失败时，优先回到 6星中转 一键导入结果，不要混用 Codex 的 /v1 规则或官方模型名。
| 现象 | 先停止什么 | 下一步只做这一件事 |
|---|---|---|
| 路径异常 | 不要继续套用 Codex 地址。 | 重新一键导入；手动核对时保留 https://www.6xin.cc/。 |
permission denied |
不要换成无关模型。 | 检查令牌是否属于 Gemini 可用分组。 |
model not found |
不要照搬官方原始模型名。 | 回到 6星中转 模型广场复制当前可用模型 ID。 |
| 6星中转 日志没有记录 | 不要只看本地 CLI 报错。 | 检查网络、代理和 Provider 是否真的启用。 |
九、切回原来的后端
在 Gemini 配置列表里启用原来的 Provider，然后关闭当前 Gemini 终端并重新打开。不要只看 CC Switch 状态，必须用一次短请求验证。
十、常见误区
| 现象 | 原因 | 处理 |
|---|---|---|
| 路径异常 | API URL 末尾斜杠被删，或版本字段不匹配。 | 优先重新从 6星中转 一键导入；手动时用 https://www.6xin.cc/。 |
| permission denied | 令牌不在 Gemini 可用分组里。 | 重建 Gemini 可用令牌或更换可用模型。 |
model not found |
模型 ID 与 6星中转 模型广场当前公开 ID 不一致。 | 不要照搬官方原始模型名，回模型广场复制。 |
| connection timeout | 本机网络、代理或 DNS 问题。 | 先访问 6星中转 主站和状态页，再看代理设置。 |
| 启用后仍失败 | 旧终端没重开，或项目级配置覆盖。 | 关闭所有 Gemini 终端，重开后再测。 |
十一、日常使用建议
- 先用短问答验证，再跑长任务，避免错误配置消耗额度。
- 排查顺序固定为：网络 → 令牌分组 → API URL → 模型 ID。
- 同一台机器上多个 Gemini 分组建议拆开命名。
- 令牌泄露后立刻在 6星中转 控制台删除，再回 CC Switch 替换。
Gemini CLI 仍然不通时，提交这些定位信息
Gemini CLI 的定位重点是版本、根地址格式、末尾斜杠、模型 ID 和项目配置覆盖。不要把 Claude 或 Codex 的地址规则照搬过来。
| 信息 | 建议内容 | 不要提供什么 |
|---|---|---|
| 版本和入口 | Gemini CLI 版本、启动方式、是否通过 CC Switch 切换。 | 不要只写“最新版”。 |
| Provider 配置 | Provider 名称、API URL 格式、模型 ID、启用时间。 | 不要提交完整 API Key。 |
| 配置覆盖 | 是否有项目级配置、旧终端、旧环境变量或多 Provider 并存。 | 不要只贴最终报错。 |
| 6星中转 回证 | 短问答是否成功，用量日志是否有对应时间点和模型。 | 不要提交隐私 prompt 或客户数据。 |