CC-Switch 配置 GLM教程

# CC-Switch 配置 GLM（精简流程）

> 目标：在 CC-Switch 的 **Claude Code 面板**里加一条 GLM 供应商，启用后 `claude` 直接可用。GLM 是借 Claude Code 的 Anthropic 协议接进去的，**没有独立的 GLM 面板**——你打开的是 Claude Code 那一栏，不是新工具。
>
> 地址统一写作 `https://api.zaimod.com`：**纯域名，不带 `/v1`，结尾不要加斜杠。**

---

## 一、开始前

| 检查项                     | 说明                         |
| ----------------------- | -------------------------- |
| CC-Switch 能打开、能加供应商     | 顶部图标行可点，右上角有 `+`           |
| 本机 `claude` 可用          | 敲 `claude --version` 能出版本号 |
| 令牌分组用 `智谱-自部署` 或 `智谱-官` | 二选一，别选成别的模型的组              |
| GLM 只吃文本                | 图片发不进去，这是模型能力，不是配置错        |

**路由转发保持关闭**。左上角 `CC Switch` 字标右边那个胶囊开关，灰色=直连。GLM 走 Claude Code 自己的配置文件直连就行；开了路由要求 CC-Switch 一直开着，你一退出就回直连、正在跑的会话会断。

**GLM 没有一键导入**。令牌列表那个「导出」对 GLM 分组不生效（Gemini、Codex、Claude 那几组才有），所以这条只能手动加，步骤见下。

---

## 二、第一步：建令牌

进站内「令牌管理」→ 新建，分组选 **`智谱-自部署`** 或 **`默认分组`**。

去列表里复制 Key：

两个要点：

1. **「模型限制列表」留空**。界面标签叫「模型限制列表」，不叫「模型可用列表」，按后者在面板上是搜不到的。留空=这枚令牌所有模型都能用；填了而当前模型不在里面，请求直接 **403**。
2. 复制时**别带上 `Bearer ` 前缀**，也别带首尾空格——粘进 CC-Switch 时这两个都是隐形雷。

---

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

点顶部图标行**最左边**那个（Claude Code，图标里是个 A 字），进 Claude Code 面板：

再点右上角的 `+`：

在「预设供应商」里选 **APINebula**（列表第一项是「自定义配置」，预设在它后面）：

填这几项：

| 字段      | 填什么                        | 说明                      |
| ------- | -------------------------- | ----------------------- |
| 供应商名称   | `APINebula` 或你记得住的名字       | 卡片上显示的就是它               |
| API Key | 上一步复制的 Key                 | 粘这里，下面地址会自动代入           |
| 请求地址    | `https://api.zaimod.com`    | 纯域名、不带 `/v1`、**不以斜杠结尾** |
| API 格式  | `Anthropic Messages（原生）`   | 保持默认，别换成 OpenAI 兼容      |
| 认证字段    | `ANTHROPIC_AUTH_TOKEN（默认）` | 写进 settings.json 的变量名   |

关于**请求地址**这栏，三件事一起说清：

- 输入框旁边有个「**完整 URL**」开关，**保持关闭**。关着=CC-Switch 自己往后拼 `/v1/messages`；打开=把你填的整串当完整请求路径，这时不带 `/v1/messages` 就一定 404。
- 输入框下方原话是「不以斜杠结尾」。写成 `https://api.zaimod.com/` 会不会出错取决于版本，但不是必要风险，去掉末尾斜杠最省心。
- 写成 `/v1` 会变成 `/v1/v1/messages`，实测 404。

关于**认证字段**：默认的 `ANTHROPIC_AUTH_TOKEN` 就够了。要是改成 `ANTHROPIC_API_KEY`，而你机器上恰好有同名的系统环境变量，**环境变量的优先级更高**，会把你写在配置里的 Key 盖掉——这是"配了却没生效"的常见原因。

### 展开「高级选项」，把五行模型填满

![](/uploads/editor/20261101/img_6ae6468f7272d1.88221248.png)

这块是全篇最容易漏的地方。它有三列，含义完全不同：

| 列       | 作用                                | 对应                               |
| ------- | --------------------------------- | -------------------------------- |
| 显示名称    | 只影响 `/model` 菜单里显示什么              | `ANTHROPIC_DEFAULT_*_MODEL_NAME` |
| 实际请求模型  | 真正发出去的 model ID                   | `ANTHROPIC_DEFAULT_*_MODEL`      |
| 声明支持 1M | 只给 Claude Code 的上下文能力声明，不改变上游真实窗口 | 长上下文后缀                           |

Claude Code 内部按**五个角色**要模型：`Sonnet`、`Opus`、`Fable`、`Haiku`、`Subagent`。GLM 是一个模型顶五个角色，所以这五行**都要填同一个模型名**——只填一两行是最典型的半成品配置。

- **Subagent 那行的显示名称是固定的**，写着「不显示在 /model 菜单」，不用管也不用改，只填它右边的实际请求模型。
- 漏填的症状不是报错：主对话看着正常，一让它动手改代码就卡住不动——因为后台摘要、标题、子任务走的是 Haiku 和 Subagent 这两档。
- 模型名以模型广场里 `智谱-*` 分组**当前可用**的为准，下文图里的 `glm-5.2` 只是当时的值，别照抄。
- 右侧有「一键设置」和「获取模型列表」两个按钮：前者把同一个模型灌满所有行，后者从接口拉分组里的模型。
- **「声明支持 1M」按真实情况勾**。勾上后横幅里的模型名会变成 `glm-5.2[1m]` 这种带后缀的样子，但那只是一句声明——真窗口没这么大，长对话照样会爆。

### 顺手删掉推理参数

GLM 没有 Claude Code 那套推理档位。CC-Switch 的预设 JSON 里常带 `effortLevel`、`alwaysThinkingEnabled` 这类字段，加完供应商后打开 `~/.claude/settings.json`，**把它们删掉**（`env` 里的 `ANTHROPIC_BASE_URL`、`ANTHROPIC_AUTH_TOKEN`、五个模型变量要留着）。

留着不一定报错，但等于给它派了个做不到的活。删掉更干净。

---

## 四、第三步：启用

回到 Claude Code 供应商列表，点 GLM 那条卡片右侧的「启用」：

**怎么认哪条在生效**：正在用的那条**有描边、右边不再显示「启用」按钮**。图上 `Claude Official` 是当前生效的，它旁边还挂着「不支持路由」的灰标（官方订阅不能走本地路由）；`APINebula` 挂着「启用」按钮，说明还没切过去。

**Claude Code 是热切换**：点启用的瞬间，配置就写进 `~/.claude/settings.json` 了，正在跑的会话下一条消息就用新配置——**不需要重开终端**。如果你用的是 VS Code 插件，建议把 VS Code 窗口重载一次，插件进程是启动时读配置的。

---

## 五、第四步：验证

直接跑：

```console
claude
```

![](/uploads/editor/20261101/img_6ae6463050a1e4.70793852.png)

三条判据，一起对上才算通：

1. **启动屏左下角显示模型名 + `API Usage Billing`**。显示 `Claude Pro` / `Claude Max` 说明还在官方订阅里，配置没生效。
2. 模型名如果带 `[1m]` 后缀，说明你勾了「声明支持 1M」——这一步不勾就没有。
3. 发一句 `你好`，能正常回。

再补两个命令级核对：

- `/status` —— 看 Base URL 是不是 `https://api.zaimod.com`、模型是不是你填的那个；
- `/model` —— 看显示名称有没有按你填的出来（Subagent 那行本来就不显示）。

> 图上那句 `You have launched claude in your home directory` 是提醒你在用户主目录启动，不是配置问题。动手前先 `cd` 进项目目录会清爽很多。

---

## 六、排错

**一发消息就 401**  
分组选错（比如拿别的模型的组）、Key 带了空格或 `Bearer `、令牌被禁用、认证字段填的变量名和你环境里的空值变量撞了。

**403**  
九成是「模型限制列表」里填了东西而当前模型不在里面。清空再试。

**回复的还是 Claude 官方**  
看 `~/.claude/settings.json` 里 `ANTHROPIC_BASE_URL` 是不是新域名；再查终端里有没有 `export ANTHROPIC_API_KEY`——它会盖掉配置文件。

**`/model` 里看不到 glm**  
「显示名称」那列没填（只填了实际请求模型），或者那一行压根没保存。Subagent 那行不显示是正常的。

**能启动，一发消息就报模型不存在**  
「实际请求模型」写了分组里没有的 ID。去模型广场核对该分组当前可用的模型名。

**图片发不进去**  
GLM 不支持图片输入，换支持多模态的模型或分组；这不是配置能解决的。

---

## 七、附录：地址对照

| 位置                                                  | 填什么                                 |
| --------------------------------------------------- | ----------------------------------- |
| CC-Switch「请求地址」                                     | `https://api.zaimod.com`             |
| 写入 `~/.claude/settings.json` 的 `ANTHROPIC_BASE_URL` | 同上（不带 `/v1`）                        |
| 实际请求路径                                              | `https://api.zaimod.com/v1/messages` |

> 同一个站点在不同工具里填法不同，别互抄：**Claude Code 和 Gemini 填纯域名**，**Codex 和 Grok Build 要带 `/v1`**。差别来自各自怎么拼路径，不是站点有两套地址。

上一篇：CC-Switch 配置 Gemini{else}上一篇：没有了下一篇：CC-Switch 配置 Grok Build{else}下一篇：没有了