正文
如果你已经装好了 CC Switch，并且打算把它接到 五猫 API，那这篇教程可以直接照着做。
CC Switch 的配置逻辑比单纯改配置文件更直观，本质上就是完成下面几步：
- 新增一个统一供应商
- 选择正确的预设类型
- 填写 API 地址和 API Key
- 启用你要用的应用
- 为应用选择模型
只要这几个步骤没填错，通常一次就能跑通。
一、开始前要准备什么
正式配置前，先确认你已经准备好了这些内容：
- 已经安装并能正常打开
CC Switch - 一个可用的
五猫 API Key - 明确自己要使用的应用，例如
Claude、Codex或Gemini
如果你还没有安装 CC Switch，建议先从官方发布页获取对应版本后再继续配置。
二、关键配置速查
先把下面几项记住，其他高级选项可以先保持默认：
| 配置项 | 建议填写 | 说明 |
|---|---|---|
| 供应商类型 | 统一供应商 | 方便集中管理多个应用 |
| 预设类型 | NewAPI | 按 CC Switch 内置预设选择 |
| 名称 | 五猫 API | 也可以自定义成你容易识别的名字 |
| API 地址 | https://api.wucat.cc | 这里使用根地址，不是 /v1 |
| API Key | 你的五猫 API Key | 从后台复制，不建议手打 |
| 启用的应用 | 只开当前要用的应用 | 例如只用 Codex 就只开 Codex |
| 模型配置 | 选择当前要用的模型 | 先跑通一个模型即可 |
最容易出错的地方
- API 地址填成了控制台地址，而不是接口地址
- 把
https://api.wucat.cc/v1填进了CC Switch的供应商地址栏 API Key填成了账号密码- 一次性把所有应用都打开，结果自己反而分不清当前在测哪个
三、配置步骤
1. 打开 CC Switch
先启动 CC Switch，进入供应商管理界面。
2. 新增供应商
点击右上角的 +，新增一个供应商。
这里建议直接选择：
统一供应商
使用统一供应商的好处是，后面你无论接 Claude、Codex 还是其他兼容应用，都更容易统一管理。
3. 选择预设类型
在预设类型里选择：
NewAPI
这里不要随意选其他预设，因为不同预设对应的接口适配方式可能不同。
4. 填写基础信息
下面这几个字段是最核心的：
- 名称：
五猫 API - API 地址：
https://api.wucat.cc - API Key：你的五猫 API Key
你可以参考下面这份文字版配置示意：
供应商类型：统一供应商
预设类型：NewAPI
名称：五猫 API
API 地址：https://api.wucat.cc
API Key：替换成你的五猫 API Key为什么这里用根地址而不是 /v1
这一点和前面的 OpenClaw 不一样。
我已经核过原始 CC Switch 文档结构，它填写的是供应商根地址的方式；同时我也验证了五猫接口现状：
https://api.wucat.cc可以正常访问到网关入口CC Switch原教程的字段逻辑也是“填根地址 + 用预设适配”
所以在 CC Switch 里，这里建议填：
https://api.wucat.cc而不是：
https://api.wucat.cc/v15. 启用你要用的应用
填好基础信息后，不需要一上来就把所有应用都打开。
建议只启用当前要测试的那个应用，例如：
- 只用
Codex，就只开Codex - 只用
Claude，就只开Claude
这样更容易排错，也更容易知道当前到底是哪条链路在工作。
6. 选择模型
给已启用的应用选择模型时，先选一个你最常用、最稳定的模型即可。
第一次配置的目标不是把所有模型都配满，而是先确认整条链路是通的。
7. 保存并返回列表检查
保存后，回到供应商列表，重点确认两件事：
- 刚刚新增的
五猫 API供应商已经出现在列表里 - 你启用的应用和模型配置都还在
只要列表中能正常看到，就说明基础保存通常已经成功。
四、怎么判断配置成功
配置完成后，建议直接看下面 3 点：
CC Switch供应商列表中能看到刚刚配置的五猫 API- 已启用的应用能正常选择到你设置的模型
- 发起一条简单请求后能正常返回内容
你可以直接用这句做测试：
你好，简单介绍一下你自己。如果没有出现地址错误、鉴权失败、连接失败这类问题，并且请求能正常返回内容，就说明配置已经生效。
五、常见问题排查
1. 我只用 Codex，需要把 Claude 和 Gemini 一起打开吗
不需要。
第一次配置时，只开当前你要用的那个应用就行。等后面真的需要别的应用，再回来补开。
2. API 地址和 API Key 怎么区分
这两个字段最容易混：
- API 地址：接口入口，是网址，例如
https://api.wucat.cc - API Key：访问凭证，是一串令牌密钥
一个负责“往哪里发”，一个负责“你是谁”，缺一不可。
3. 返回 401 或鉴权失败怎么办
优先检查下面几项：
- API Key 是否复制完整
- API Key 前后是否多了空格
- 当前 Key 是否可用
- 账户额度或配额是否正常
这类问题通常和地址无关，大多数都是令牌本身的问题。
4. 模型不知道选哪个怎么办
第一次接入时，不要一开始就纠结模型池。
建议先选一个你最常用的模型，把供应商配置跑通。等链路稳定后，再去慢慢补充其他模型。
5. 地址到底为什么不是 /v1
这个问题很常见，因为很多 OpenAI 兼容客户端确实会直接要求填 /v1。
但 CC Switch 这里不一样，它的供应商配置方式是：
- 先选供应商预设
- 再由预设去适配接口调用
所以这篇教程里，CC Switch 使用根地址：
https://api.wucat.cc而不是其他工具里常见的 /v1 写法。
