用 CC-Switch 配置 Claude Code · 接入API中转站

## CC-Switch 配置 Claude Code · 接入API中转站
## 一、这篇解决什么问题

CC-Switch 是管理 AI 编程工具接入配置的桌面工具。这篇只讲一件事：**用 CC-Switch 把 Claude Code 接到中转站**，从建令牌到三种方式验证。

四篇文档的分工：

| 文档                       | 场景                                      |
| ------------------------ | --------------------------------------- |
| 本篇                       | 用 CC-Switch 管 Claude Code（图形界面、可一键切回官方） |
| 《CCSwitch 配置 Codex 教程》   | 同样的流程，换成 Codex（填法不同，别互抄）                |
| 《ClaudeCode CLI 与插件配置教程》 | 不装管理工具，手写 `~/.claude/settings.json`     |
| 《CCSwitch 下载安装与入门教程》     | 还没装 CC-Switch                           |

**两条路二选一**：第四章（一键导入）和第五章（手动添加）是并行路径，做完任一条即可。

## 二、准备

- CC-Switch 已安装并能正常打开；
- 本机已装 **Claude Code CLI**（VS Code 插件版也读同一份配置）；
- 站内要有一枚令牌，分组选 **`Claude Code全球高防`** 或 **`满血Claude Code`**。

> 注意看分组说明：`Claude Code全球高防` 写着"限制客户端满血MAX号池！**仅在CC内使用**"。这类分组只服务 Claude Code 这一种客户端，拿它去配 Codex 或其它工具大概率不通——一个工具一枚对应分组的令牌，别混用。

## 三、第一步：创建令牌

**1. 打开控制台「令牌管理」**，点新建。

**2. 名称随意**（例如 `claude`），**分组选 `默认即可`**。

**3. 模型限制列表留空**。填了模型却漏掉 Claude Code 实际请求的那个，请求会返回 **403**——不是 Key 错，只是这枚令牌不允许用该模型。

**4. 提交后回列表，在「密钥」列点复制**，拿到完整 Key。

## 四、第二步（捷径）：一键导入

暂不支持

## 五、第三步（手动）：在 CC-Switch 里添加供应商

### 5.1 进入 Claude Code 页

打开 CC-Switch，点**顶部图标行里的第一个**（Claude Code 图标）：

![](/uploads/editor/20261101/img_6ae63d54b2f986.83834376.png)

进入后点右上角 **「+」添加供应商**：

![](/uploads/editor/20261101/img_6ae63d5e0b7685.96384807.png)

> 顶部这一排图标就是各客户端的切换入口，图标下有数量角标的表示已经配了几张卡片。当前版本的 CC-Switch 没有左侧工具列表——有教程写"左侧选择"，那是更早的界面。

### 5.2 选预设

添加页顶部两个标签：**Claude 供应商 / 统一供应商**，停在「Claude 供应商」。下方预设列表第一项是 **「自定义配置」**，其后是各家服务商预设。

**推荐走「自定义配置」**，地址自己填，不会被预设带偏。

也可以选 **APINebula 预设**，但**必须手动把「请求地址」改掉**——预设里存的是老域名，页面底部那行小字写得很清楚："只需填写 API Key，请求地址已预设"，意思是它会替你填好，而填好的是旧的。

![](/uploads/editor/20261101/img_6ae63dc6415d38.05802416.png)

### 5.3 填三个字段

| 字段      | 填什么                                                 |
| ------- | --------------------------------------------------- |
| 供应商名称   | 随意，显示在卡片上                                           |
| API Key | 粘贴上一步复制的令牌                                          |
| 请求地址    | `https://api.zaimod.com` —— **纯域名，不带 `/v1`，结尾不要加斜杠** |

输入框下方的提示语是原话：**"填写兼容 Claude API 的服务端点地址，不要以斜杠结尾"**。

为什么是纯域名：Claude Code 会自己在后面拼 `/v1/messages`。写成 `https://api.zaimod.com/v1` 会变成 `/v1/v1/messages`（404）；写成 `https://api.zaimod.com/` 这种带尾斜杠的形式，不同版本拼接结果不一致，干脆别加。

### 5.4 看一眼配置 JSON

往下滚，展开「高级选项」下方的 **「配置 JSON」**，能看到这张卡片实际会写进 `~/.claude/settings.json` 的内容，大致是：

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zaimod.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "model": "sonnet",
  "alwaysThinkingEnabled": true,
  "effortLevel": "high",
  "showThinkingSummaries": true,
  "theme": "auto"
}
```

三个值得知道的点：

- **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: "1"`** 是关掉遥测、自动更新检查等非必要请求。中转站场景建议保留——省得这些后台请求也去消耗你的额度或报无谓的错。
- **`model: "sonnet"`** 是全局默认档位，不是具体模型 ID。真正的模型交给服务端按档位解析，所以这张预设**不需要**填四个 `ANTHROPIC_DEFAULT_*_MODEL` 变量（手写配置才需要，见另一篇）。
- 预设里还有个 **`includeCoAuthoredBy: false`**，这是关掉提交时的 AI 署名。它自 Claude Code v2.0.62 起**已弃用**，新版建议写成 `"attribution": {"commit": "", "pr": "", "sessionUrl": false}`；留着旧字段不会报错，但可能被忽略。

上方还有几个勾选框：**应用通用配置**（勾着，右侧可「编辑通用配置」）、隐藏 AI 署名、Teammates 模式、启用 Tool Search、最大强度思考、禁用自动升级。默认值对大多数人是合适的，只有"最大强度思考"会明显增加消耗，按需开。

### 5.5 模型映射：这里可以开

和 Codex 那篇相反，**Claude Code 这边允许开模型映射**：

- 点「获取模型列表」，再从列表里给 **Sonnet / Opus / Fable / Haiku** 四个档位分别指定实际请求的模型；
- **只有模型本身支持 1M 上下文时才勾 1M**；
- 不指定就留空，走服务端默认模型——大多数人这样用就够了。

两个页面口径为什么相反：Codex 的映射会生成 `model_catalog_json` **覆盖整个模型目录**（连能力声明一起写死），条目填不全图片就发不进去；Claude Code 这里的映射只是"档位 → 模型 ID"的替换，不动能力声明，所以可以放心开。

> 勾了 1M 不等于真的买到 1M 窗口。它只是告诉客户端"按长上下文对待"，上游实际窗口更小时，长对话照样会爆上下文。

### 5.6 保存

点右下角 **「+ 添加」**。

## 六、第四步：启用

回供应商列表，在新卡片右侧点 **「启用」**：

启用后 CC-Switch 把这张卡片的配置写进 `~/.claude/settings.json`。切换**只替换连接相关的字段**（地址、Key、模型），你自己加的 hooks、权限规则、注释都会留着。

> **别被卡片副标题骗**：卡片上那行地址显示的是「官网链接」，不是你填的请求地址。改完地址后卡片上仍然是旧域名，很容易以为没生效。核对要看两处：添加页的「配置 JSON」，或直接打开 `~/.claude/settings.json` 看 `ANTHROPIC_BASE_URL`。

## 七、第五步：启动测试

### 7.1 VS Code 插件

打开 VS Code，在 Claude Code 面板发：

```console
你好
```

能正常返回即成功。

![](/uploads/editor/20261101/img_6ae63e12c7e425.78268402.png)

### 7.2 Claude Code CLI

终端执行：

```bash
claude
```

能进对话界面、能正常收发即成功。

![](/uploads/editor/20261101/img_6ae63e20c93698.92097175.png)

启动屏有一处判据很好用：左下角显示 **`API Usage Billing`** 说明在走 API 计费（中转生效）；显示 `Claude Pro / Max` 说明还在官方订阅里。会话里输入 `/status` 能看到当前的 Base URL 与模型。

**最硬的判据**仍是站内控制台「使用日志」有没有新记录——界面能聊、日志为空，等于请求没走中转。

## 八、排错

### 8.1 报 401

Key 没复制全、令牌被禁用、分组选错。检查「API Key」里有没有残留空格或引号；确认分组是 `Claude Code全球高防` 或 `满血Claude Code`。

### 8.2 报 403

模型限制列表填了模型、但没包含 Claude Code 正在请求的那个。把这枚令牌的模型限制清空（留空 = 全部模型）再试。

### 8.3 地址看着改对了却不生效

先排除两个假象：

- 卡片副标题显示的是官网链接，不代表请求地址（见第六章提示）；
- 改了地址但没点「保存 / 添加」，或者改的是另一张卡片。

真正的核对点只有一个：`~/.claude/settings.json` 里 `env.ANTHROPIC_BASE_URL` 的值。

### 8.4 切完还是官方账号

Claude Code 是热切换，重开会话即可；如果还显示 `Claude Pro / Max`，检查终端里是否残留 `ANTHROPIC_API_KEY` 环境变量——它的优先级高于配置文件，会把你的中转配置压掉。

### 8.5 VS Code 插件没变化

Claude Code 的插件与 CLI 共用 `~/.claude/settings.json`，但插件只在启动时读取。**重启 VS Code**（不是只重开面板）才会应用新配置。

### 8.6 想切回官方

在供应商列表选内置的 **Claude Official** 卡片点启用，重开会话后按提示 `/login`。之后可以在官方与中转卡片之间自由切换，不用反复登录。

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