CC-Switch 配置 Gemini教程

# CC-Switch 配置 Gemini流程

> 你已经装好 CC-Switch，也已经加过别的供应商，所以这篇**只讲本次要做的事**：新建一个 Gemini-反重力 分组的令牌 → 在 CC-Switch 的 Gemini 面板加一条供应商 → 启用 → 重开 `gemini` 验证。
>
> 站点地址统一写作 `https://api.zaimod.com`。**Gemini 这一栏填纯域名，不带 `/v1`，也不带结尾斜杠。**

---

## 一、和其他几篇的分工

| 文档                                     | 适合看的情况                           |
| -------------------------------------- | -------------------------------- |
| 《CC-Switch 下载安装与入门教程》                  | 还没装 CC-Switch、不知道三种模式是什么         |
| 《GeminiCLI旧版配置教程》/《AntigravityCLI配置教程》 | 不想用 CC-Switch，手工改 `.env` 或环境变量   |
| **本篇**                                 | CC-Switch 已经在用，只想再挂一个 Gemini 供应商 |

三篇都能让 `gemini` 跑起来，**但别同时配**：CC-Switch 会写同一份 `~/.gemini/.env`，手工配的那份会被覆盖（或反过来覆盖它），出问题时分不清是谁写的。

---

## 二、动手前确认三件事

| 检查项                   | 怎么确认                            |
| --------------------- | ------------------------------- |
| CC-Switch 能正常打开、能加供应商 | 主界面顶部那排图标能点，右上角有 `+`            |
| 本机 `gemini` 命令可用      | 开一个终端敲 `gemini --version`，能出版本号 |
| 令牌分组选 `Gemini-反重力`    | 见下一章，**这个分组名别选错**               |

**还有一个开关要确认是关的**：CC-Switch 左上角 `CC Switch` 字标右边那个胶囊开关，就是路由转发。灰色=关（直连），蓝色=开。

![](/uploads/editor/20261101/img_6ae641d49a2cd2.68858225.png)

> **为什么建议保持直连**：路由模式下所有请求先打到本机 `127.0.0.1:15721` 再转发出去，这就要求 **CC-Switch 必须一直开着**——你一退出，它自动回直连，正在跑的会话会断。直连模式下写进去的是真地址真 Key，关掉 CC-Switch 也不影响。所以除非你需要"多个工具共用一条聚合模型列表"，否则这个问题上按原页面说的做：别开。

---

## 三、第一步：建令牌（一分钟）

进站内「令牌管理」→ 新建，分组选择。

## 四、第二步：加供应商

有两条路，选一条就行。

### 4.1 一键导入（推荐先试）

令牌列表右侧操作列里点「**导出**」，跟着提示走，配置会直接写进 CC-Switch。

> **方向别弄反**：按钮叫「导出」，站在站内视角是"从站点导出到 CC-Switch"。如果点了没反应，多半是浏览器拦了自定义协议（地址栏右侧会有个被拦的提示），允许一次再点；还是不行就走下面的手动。

### 4.2 手动添加

点顶部图标行里的 Gemini 图标（第 4 个，菱形那颗 ✦），进 Gemini 面板，再点右上角的 `+`。

在「预设供应商」里选 **APINebula**——注意列表**第一项是「自定义配置」**，想完全自己填可以选它，预设在后面。

表单里真正要你动手的只有两处：

| 字段      | 填什么                     | 说明                      |
| ------- | ----------------------- | ----------------------- |
| 供应商名称   | `APINebula` 或你自己记得住的名字  | 卡片上显示的就是它               |
| API Key | 上一步复制的 Key              | 填这里，下方地址会自动代入           |
| 请求地址    | `https://api.zaimod.com` | **纯域名**，不带 `/v1`，不带结尾斜杠 |
| 模型      | 留默认，或点「获取模型列表」挑一个       | 见下                      |
| 官网链接    | 可以不管                    | 只是卡片副标题                 |

**请求地址这一栏是整篇最需要动手的地方**：预设里写死的是旧域名，选预设不会让它跟着变。改成 `https://api.zaimod.com` 之后，Gemini CLI 拼出来的才是 `https://api.zaimod.com/v1beta/models/...`。如果你手一滑写成 `/v1`，会变成 `/v1/v1beta/...`，直接 404。

**关于「模型」栏**：留默认就用 Gemini CLI 自己的默认模型；想锁定具体模型，点右边的「获取模型列表」从分组里挑。手填也可以，但**要以模型广场里 `Gemini-反重力` 分组当前可用的为准**，写一个分组里没有的模型名，症状是能启动、一发消息就报模型不存在。

> 关于**模型映射**：Gemini 这边的映射是"把某个内部档位指向你指定的模型名"，和 Codex 那边"开了映射会覆盖模型能力声明、图片进不去"不是一回事。这里按需开、不开也行，不改默认值最省事。

填完点右下角「添加」。

---

## 五、第三步：启用，以及多条供应商怎么切

回到 Gemini 列表，在刚加的卡片右侧点「启用」。

**怎么判断哪条在生效**：正在用的那条卡片**有描边、右边不再显示「启用」按钮**；没在用的才挂着「启用」。图上 `Google Official` 已生效，`APINebula` 还没启用——点它的「启用」就换过去了。

你既然已经加过多条，日常切换有两个入口：

- **面板里**：点目标卡片的「启用」，配置文件立刻被改写；
- **托盘图标右键**：选 Gemini 面板 → 点供应商名，连窗口都不用开。这个在写代码写到一半时最省事。

切走的供应商配置不会丢，CC-Switch 会把它存档，下次点回来一键还原。你在某个供应商下手工加的插件、Hook、MCP、注释也会被保留——切换只替换地址、Key、模型、协议这几个关键字段。

---

## 六、第四步：验证

Gemini CLI 是**启动时读** `~/.gemini/.env` 和 `~/.gemini/settings.json`，运行中的会话不会用上新的 Key。所以必须退出后重跑：

```console
gemini
```

进去之后发一句 `你好`。

![](/uploads/editor/20261101/img_6ae6423e4c9fb9.97323474.png)

三条判据，同时对得上才算配好：

1. 横幅里出现 **`Authenticated with gemini-api-key`** ——如果是让你用 Google 账号登录，说明 Key 没被读到；
2. 界面底部/右下角显示你刚才设的**模型名**（图里是 `gemini-3.5-flash`）；
3. 回复正常返回。

想更硬一点，直接看它写了什么：

```bash
# macOS / Linux
cat ~/.gemini/.env
```

```powershell
# Windows PowerShell
Get-Content $env:USERPROFILE\.gemini\.env
```

里面应该是 `GEMINI_API_KEY=` 你的 Key、和 `GOOGLE_GEMINI_BASE_URL=https://api.zaimod.com`。这两行在，配置就是落盘了的。最后一层证据是站内后台的「使用日志」——有记录就一定是走的中转。

---

## 七、排错

**7.1 一发消息就 401**

按这个顺序查：分组是不是选成了 `Gemini`（那是给 `agy` 用的）；Key 有没有带空格或 `Bearer `；令牌有没有被禁用。

**7.2 403**

九成是「模型限制列表」里填了东西，而当前模型不在里面。把那一栏清空再试。

**7.3 还是提示登录 Google 账号 / 请求打到官方**

- 没重开 `gemini`，还在用旧会话；
- 或者终端里 `export` 过 `GOOGLE_GEMINI_BASE_URL` / `GEMINI_API_KEY`。**环境变量的优先级高于 `.env`**，`.env` 里写得再对也会被盖掉——`unset` 掉，或者干脆关掉这个终端重开。

**7.4 面板上看地址还是旧的**

卡片副标题那行显示的是**官网链接**，不是你填的请求地址，所以改完地址卡片看起来没变是正常的。要核对就看 `~/.gemini/.env`，或者面板里的「配置 JSON」。

**7.5 模型列表拉不出来 / 模型名报不存在**

「获取模型列表」依赖接口返回，拉不到就手填；填之前先在模型广场确认 `Gemini-反重力` 分组里到底有哪些模型，别照抄别人的截图——截图会过时。

**7.6 之前好好的，重启 CC-Switch 后断了**

你开的是路由模式，退出 CC-Switch 就回直连，而直连用的是卡片里存的地址。要么保持直连，要么让 CC-Switch 常驻。

---

上一篇：CC-Switch 配置 Claude Code{else}上一篇：没有了下一篇：CC-Switch 配置 GLM{else}下一篇：没有了