用 CC-Switch 配置 Grok Build 教程

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

> 目标：在 CC-Switch 的 **Grok 面板**里加一条供应商，启用后 `grok` 直接可用。
>
> 地址这次**必须带 `/v1`**：`https://api.zaimod.com/v1`。原因见第三章，和 Claude Code、Gemini 那两篇正好相反，别互抄。

---

## 一、开始前

| 检查项                 | 说明                                                                          |
| ------------------- | --------------------------------------------------------------------------- |
| CC-Switch 能打开、能加供应商 | 顶部图标行可点，右上角有 `+`                                                            |
| 本机 `grok` 可用        | 敲 `grok --version`；`where grok`（Windows）或 `which -a grok` 应指向 `~/.grok/bin` |
| 令牌分组用 `Grok`        | 见下一章                                                                        |
| 路由转发保持关闭            | 左上角 `CC Switch` 字标右边的胶囊，灰色=直连                                               |

Grok 这一组**支持一键导入**，所以下面手动流程只在导入失败或要排查时用。

---

## 二、第一步：建令牌

进「令牌管理」→ 新建，分组选 **`默认分组即可`**。

两个要点：

1. **「模型限制列表」留空**。界面标签叫「模型限制列表」，不叫「模型可用列表」，按后者搜不到控件。填了而当前模型不在里面，请求直接 **403**。
2. 复制完整 Key，**不带 `Bearer ` 前缀**、不带首尾空格。

> 分组说明里写的倍率（比如 0.15x）会随成本浮动，别当常量记；看到数字变了不代表分组换了。

---

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

一键导入走「导出」按钮：

导入完**别急着收工**，打开 `~/.grok/config.toml` 看一眼 `base_url` 是不是新域名——一键导入写的是预设里的地址，预设会过时。

手动加的话：点顶部图标行第 **5** 个（那个环形回旋标），进 Grok 面板：

![](/uploads/editor/20261101/img_6ae6520d2b9fd7.95044620.png)

点右上角 `+`：

![](/uploads/editor/20261101/img_6ae65215ac0029.73964810.png)

预设里选 **APINebula**（列表第一项是「自定义配置」，官方在第二位叫 `Grok Official`）：

![](/uploads/editor/20261101/img_6ae65258781052.80836532.png)

### 表单要填六个值

![表单：客户端模型档位、API Backend、上下文窗口、请求地址](images/ccswitch-grok/05-config.png)

| 字段          | 填什么                        | 说明                                |
| ----------- | -------------------------- | --------------------------------- |
| 供应商名称       | `APINebula`                | 卡片上显示的就是它                         |
| 客户端模型档位     | `grok-4.5`（以模型广场为准）        | 写进 `config.toml` 的 `model`        |
| API Backend | `responses`                | 写进 `api_backend`，表示走 Responses 协议 |
| 上下文窗口       | `500000`（按实际）              | 写进 `context_window`，见下文           |
| API Key     | 上一步复制的 Key                 | 粘这里，凭证会写进 `~/.grok/auth.json`     |
| API 请求地址    | `https://api.zaimod.com/v1` | **必须带 `/v1`**                     |

**为什么这里要带 `/v1`**：Grok Build 会把请求发到 `{base_url}/responses`，拉模型列表走 `{base_url}/models`。填纯域名就成了 `https://api.zaimod.com/responses`，实测 404。你在第 28、35 篇看到的"纯域名"是 Claude Code 的规矩，它自己会补 `/v1/messages`——两者别混。

输入框旁的「**完整 URL**」开关保持关闭，下方提示是「填写兼容 OpenAI Response 格式的服务端点地址」。

**上下文窗口这个值要老实填**：它只是一句声明，不会真的把上游窗口变大。写 500000 而上游实际更小，平时没事，长对话会突然爆上下文。TUI 右上角那个 `10K / 1.0M` 的分母就来自这里（不同版本换算方式有差异，数值不必逐位对上，能显示就说明字段写进去了）。

**凭证落在哪**：这栏的占位文字写着「只需要填这里，下方 auth.json 会自动填充」。也就是说 CC-Switch 把 Key 写进 `~/.grok/auth.json`，不是 `config.toml`。这跟第 30 篇手工把 `api_key` 写进 `config.toml` 不一样，两套都有效，但**别同时写**，auth.json 的会赢。

### 模型映射：只用一个模型就别开

原文一句"可以按需开启"，实际代价是：映射会生成一份模型目录（`model_catalog_json`），条目**按你填的内容原样保存**——里面既承载模型名，也承载能力声明。字段没填全，对应的能力（比如图片输入）就静默失效，不报错。

只用一个模型时留着默认就行，开映射纯属给自己挖坑。

---

## 四、第三步：启用

回到列表，点 APINebula 卡片右侧的「启用」：

**怎么认哪条在生效**：正在用的那张卡片**有描边、右边没有「启用」按钮**。图上 `Grok Official` 在生效，`APINebula` 带个星标（收藏）还挂着「启用」按钮——点它才切过去。

**Grok Build 切换后必须重启终端**，这点和 Claude Code 不同：它启动时一次性读 `~/.grok/config.toml` 和 `auth.json`，运行中不刷新。

---

## 五、第四步：验证

```console
grok
```

![](/uploads/editor/20261101/img_6ae6526c39f5a8.86380655.png)

三条判据：

1. **输入框右下角显示模型名**（`Grok 4.5` 之类），来自「客户端模型档位」；
2. **右上角有 `已用 / 上限`** 的上下文用量，说明「上下文窗口」写进去了；
3. 消息下方出现 `Thought for 0.1s` / `Worked for 14s` 这类耗时行，发一句 `你好` 能正常回。

命令行自查更硬：

```bash
grok inspect     # 看最终生效的配置，被拒的字段会给 warning
grok models      # 看模型列表有没有拉全
grok -p "你好"    # 端到端跑一次，不进 TUI
```

> 截图里的 `grok 0.2.101` 已经旧了（现在是 1.0.x，一两天一版），**别拿版本号当判据**，看 `where grok` 指向 `~/.grok/bin` 更靠谱。最后一层证据仍是站内后台的「使用日志」。

---

## 六、排错

**一发消息就 401**  
先查一件反直觉的事：这台机器以前 `grok login` 过吗？跑过的话 `auth.json` 里存着 OAuth 会话，**它会压过你配的 Key**，症状是扣不到余额或直接 401。先 `grok logout` 清掉，或在配置里写明 `preferred_method = "api_key"`。再依次查分组、Key 空格、令牌状态。

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

**请求还是打到 xAI 官方**  
`grok inspect` 看 `base_url` 是不是 `https://api.zaimod.com/v1`；再确认终端里没有残留的 `XAI_API_KEY` 之类环境变量，以及 `config.toml` 里有没有旧的 `[model_providers.*]` 段在抢。

**`/model` 里看不到你配的模型**  
模型名写错，或者模型 ID 里带点号却没加引号。`[model."grok-4.5"]` 这种写法里**引号是硬要求**，裸写会被 TOML 解析成三段 key，条目错位且**不报错**。

**长对话突然报上下文超限**  
「上下文窗口」填得比上游真实窗口大。改小到实际值。

**`brew install grok` 装错了东西**

|                                                                                        |                                                          |         |
| -------------------------------------------------------------------------------------- | -------------------------------------------------------- | ------- |
| Homebrew 里那个 `grok` 是同名的正则工具，不是 xAI 的 CLI。官方安装脚本是 \`irm <https://x.ai/cli/install.ps1> | iex`（Windows）或 `curl -fsSL <https://x.ai/cli/install.sh> | bash\`。 |

---

## 七、附录：地址对照

| 位置                                    | 填什么                                                  |
| ------------------------------------- | ---------------------------------------------------- |
| CC-Switch「API 请求地址」                   | `https://api.zaimod.com/v1`                           |
| 写入 `~/.grok/config.toml` 的 `base_url` | 同上（带 `/v1`）                                          |
| 实际请求路径                                | `https://api.zaimod.com/v1/responses`、`.../v1/models` |

> 各工具的填法别互抄：**Claude Code 和 Gemini 填纯域名**，**Codex 和 Grok Build 要带 `/v1`**。差别只来自它们各自怎么拼路径。

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