CC Switch 接入 TokenGo 中转服务
学习如何在 CC Switch 中配置 TokenGo 中转服务，使用 GPT 和 Claude 系列模型，实现供应商管理。
CC Switch 简介v3.13.0
CC Switch 是一款跨平台桌面 All-in-One 辅助工具，专为 Claude Code、Codex、OpenCode 和 OpenClaw 等 AI 编程助手设计。 它提供了统一的供应商管理和灵活配置功能，让您能够更高效地使用 OpenAI GPT 和 Anthropic Claude 系列模型。
双供应商支持
统一管理 OpenAI GPT 和 Anthropic Claude 两大模型系列
灵活配置
支持预设模板和自定义配置，满足各种场景需求
用量统计
实时监控 API 调用量和费用，合理控制成本
快速开始
安装指南
CC Switch 支持 Windows 和 macOS 平台。请根据您的操作系统选择对应的安装方式。
系统要求
| 平台 | 最低版本 | 架构支持 |
|---|---|---|
| Windows | Windows 10+ | x64, ARM64 |
| macOS | macOS 11+ | Intel, Apple Silicon |
macOS 安装
# 使用 Homebrew 安装
brew install --cask cc-switch
# 或下载 DMG 安装包
# https://github.com/farion1231/cc-switch/releasesWindows 安装
# 使用 winget 安装
winget install farion1231.cc-switch
# 或使用 Scoop
scoop bucket add extras
scoop install cc-switch界面概览
CC Switch 采用简洁直观的界面设计，主要包含以下几个核心区域：
导航栏
供应商卡片区
功能面板
系统托盘
快速上手
按照以下步骤，您可以在 5 分钟内完成 CC Switch 的基础配置并开始使用。
添加第一个供应商
{
"name": "AI 服务",
"type": "openai",
"base_url": "https://ai.ssgoo.net/v1",
"api_key": "sk-xxx (从后台 API 密钥中获取)",
"models": ["gpt-4o", "gpt-4-turbo", "claude-3.5-sonnet"]
}验证连接
激活供应商
启动 CLI 工具
恭喜！
个性化配置
CC Switch 提供丰富的个性化选项，您可以根据使用习惯和需求进行调整。
基础设置
| 选项 | 说明 | 默认值 |
|---|---|---|
| 界面语言 | 支持简体中文、繁体中文、英语、日语 | 跟随系统 |
| 主题模式 | 浅色、深色、跟随系统 | 跟随系统 |
| 开机自启 | 系统启动时自动运行 CC Switch | 关闭 |
| 轻量模式 | 最小化时释放内存，降低资源占用 | 关闭 |
配置文件位置
# macOS
~/Library/Application Support/cc-switch/
# Windows
%APPDATA%\cc-switch\云同步
添加供应商
CC Switch 支持三种方式添加供应商：使用预设模板、自定义配置和统一供应商模式。
使用预设模板
预设模板已内置常见服务商的配置，您只需填写 API Key 即可快速完成配置：
| 预设名称 | 服务商 | 支持模型 |
|---|---|---|
| OpenAI | OpenAI | GPT-4o, GPT-4 Turbo, GPT-3.5 Turbo |
| Anthropic | Anthropic | Claude 3.5 Sonnet, Claude 3 Opus, Claude 3 Haiku |
自定义 API 配置
对于第三方中转服务或私有部署，使用自定义配置：
{
"name": "TokenGo AI 服务",
"type": "openai-compatible",
"base_url": "https://ai.ssgoo.net/v1",
"api_key": "sk-xxx (从后台 API 密钥中获取)",
"models": [
{
"id": "gpt-4o",
"name": "GPT-4o",
"context_length": 128000
},
{
"id": "claude-3.5-sonnet",
"name": "Claude 3.5 Sonnet",
"context_length": 200000
}
],
"options": {
"timeout": 60000,
"retry_count": 3,
"full_url_mode": false
}
}完整 URL 模式
full_url_mode 后，base_url 将被视为完整的请求端点，不再自动拼接路径。适用于部分非标准 API。统一供应商
统一供应商功能允许您将多个 API Key 合并为一个供应商，系统将自动进行负载均衡和故障转移。
{
"name": "TokenGo AI 负载均衡",
"type": "unified",
"base_url": "https://ai.ssgoo.net/v1",
"keys": [
{ "key": "sk-xxx (从后台获取密钥1)", "weight": 2 },
{ "key": "sk-xxx (从后台获取密钥2)", "weight": 1 }
],
"strategy": "weighted-round-robin"
}切换供应商
CC Switch 提供多种方式切换当前活动的供应商，满足不同场景的使用需求。
主界面切换
在主界面双击供应商卡片即可激活。激活的供应商会显示高亮边框和「活动中」标签。
系统托盘切换
右键点击系统托盘图标，在弹出菜单中选择目标供应商。v3.13.0 新增按应用分级菜单，避免菜单过长。
快捷键切换
| 快捷键 | 功能 |
|---|---|
| ⌘/Ctrl + 1-9 | 快速切换到对应序号的供应商 |
| ⌘/Ctrl + ↑/↓ | 切换到上一个/下一个供应商 |
| ⌘/Ctrl + Shift + P | 打开供应商快速选择面板 |
生效方式
ANTHROPIC_API_KEY）。新启动的终端会话将使用新配置，已运行的 CLI 工具可能需要重启才能生效。编辑供应商
点击供应商卡片上的编辑按钮（或右键菜单选择「编辑」）可修改已保存的配置。
可编辑项目
- 供应商名称和图标
- API 端点地址 (Base URL)
- API Key（支持查看已保存的 Key）
- 模型列表和默认模型
- 超时时间、重试次数等高级选项
回填机制
编辑已激活的供应商时，修改会立即生效并同步到环境变量。系统会自动检测变更并提示是否需要重启相关 CLI 工具。
排序与复制
拖拽排序
长按供应商卡片并拖动可调整显示顺序。排序会影响快捷键切换的序号（⌘+1 对应第一个供应商）。
复制供应商
右键菜单选择「复制」可基于现有配置创建新供应商，适用于需要配置多个相似供应商的场景（如同一服务的不同 API Key）。
注意
用量查询
CC Switch 支持查询各供应商的 API 用量和剩余额度，帮助您合理控制成本。
支持的查询类型
| 供应商类型 | 支持查询 | 展示信息 |
|---|---|---|
| 官方订阅 (OpenAI/Claude) | ✓ 自动 | 剩余额度、重置日期 |
| Token Plan | ✓ 模板启用 | 已用 Token、剩余 Token |
| TokenGo AI 中转 | ✓ 模板启用 | 余额查询 |
配置用量查询
{
"name": "第三方中转",
"usage_query": {
"enabled": true,
"endpoint": "/v1/dashboard/billing/usage",
"template": "openai-compatible",
"refresh_interval": 300
}
}用量统计
查看详细的 API 调用统计，包括请求次数、Token 用量、响应时间和费用估算。
统计维度
- 按供应商统计用量分布
- 按模型统计调用频率
- 按时间段查看趋势图表
- 按应用统计各工具的使用情况
费用估算
配置各模型的单价后，CC Switch 可自动计算预估费用，帮助您控制 API 开支。
模型检查
测试供应商连接状态、模型可用性和响应延迟，确保配置正确可用。
检测项目
| 检测项 | 说明 |
|---|---|
| 连接测试 | 验证 API 端点可达性 |
| 认证测试 | 验证 API Key 有效性 |
| 模型列表 | 获取可用模型列表 |
| 流式检测 | 测试 SSE 流式响应是否正常 |
| 延迟测试 | 测量请求往返延迟 |
流式检测