CC-Switch（配置管理工具）

CC-Switch 是一个图形化配置工具，适合不想手动编辑配置文件的用户。你可以在界面里选择工具类型、填入 API Key、Base URL 和模型，再把配置切换给目标客户端。

快速复制

先把常用配置准备好，再进入 CC-Switch 填写。API Key 需要从 SuperToken 控制台复制，这里不展示你的私密 Key。

选择 API 节点

两个节点共用同一套 API Key、模型和接口路径。

通用 Base URLhttps://api.supertoken.cc

OpenAI 兼容 Base URLhttps://api.supertoken.cc/v1

当前选择：默认节点。Claude Code、CC-Switch 等通常使用不带 /v1 的地址；Codex、Cursor 和 OpenAI SDK 通常使用带 /v1 的地址。

通用 Base URL

https://api.supertoken.cc

CC-Switch、Claude Code 等工具常用，不带 /v1。

OpenAI 兼容 Base URL

https://api.supertoken.cc/v1

Cursor、Codex、OpenAI SDK 常用。

默认模型示例

gpt-5.5

可替换为模型广场中当前可用的模型名。

模型列表测试

curl https://api.supertoken.cc/v1/models -H "Authorization: Bearer 你的SuperToken API Key"

验证 Key 和网关是否能正常访问。

使用步骤

1. 安装 CC-Switch

先安装并打开 CC-Switch，然后再开始添加和配置供应商。

推荐使用 Homebrew 安装：

bash

brew tap farion1231/ccswitch
brew install --cask cc-switch

也可以从 CC-Switch GitHub Releases 手动下载 macOS 版本安装包后打开使用。

2. 选择对应的模型选项

先在 CC-Switch 中选择你要使用的工具或模型类型。

CC-Switch 历史界面的供应商列表与顶部工具类型入口 — **在 CC-Switch 中选择目标工具类型**CC-Switch 历史界面，版本未记录来源：SuperToken 现有 CC-Switch 实拍，仅用于辨认入口核对日期：2026-07-14不含完整 API Key；配置值以当前正文为准

3. 配置 API Key、Base URL 和默认模型

进入配置页面后，主要填写这几项：

API Key：你的 SuperToken API Key
Base URL：复制上方所选节点的“通用 Base URL”
默认模型：填写模型广场中你要使用的对应模型

旧截图不能当配置值

仓库原有配置截图使用了历史示例地址，与当前 API 地址不一致，因此本版不再展示该图。请从上方复制 https://api.supertoken.cc（默认节点）或 https://hk.supertoken.cc（香港节点）；不要从旧截图抄写 https://supertoken.cc。

4. 测试是否连通

配置完成后，点击测试，确认当前配置是否可以正常连接。

看到“运行正常”只说明当前测试动作拿到了成功结果。继续完成以下验收：

保存并切换到这条供应商配置。
关闭并重新打开 CC-Switch，确认字段仍存在。
打开目标客户端，明确选择对应模型并发送一次新请求。
在 SuperToken 控制台核对同一时间和模型的请求记录。

如果测试失败，按统一错误决策表检查 Key、协议、Base URL、模型和额度；不要直接重建所有配置。

CC-Switch（配置管理工具） ​

快速复制 ​

选择 API 节点

使用步骤 ​

1. 安装 CC-Switch ​

2. 选择对应的模型选项 ​

3. 配置 API Key、Base URL 和默认模型 ​

4. 测试是否连通 ​