📌 摘要
每次切换 Claude API 供应商都要手动改配置文件?环境变量重启后消失?CC Switch 是专为解决这个痛点而生的开源桌面工具,提供可视化界面统一管理 Claude Code、Codex、Gemini CLI 的全部 API 供应商配置,系统托盘常驻、右键一键秒切。本文以 weelinking(国内直连 Claude,按量付费)为例,完整演示三步操作:安装 CC Switch(Windows / macOS / Linux 全平台)→ 注册 weelinking 获取 API Key → 在 CC Switch 中添加并启用,附 MCP 统一管理、Skills 批量安装、Prompts 预设等进阶功能入口,以及 4 个高频踩坑的解决方法。
📋 目录
- 一、CC Switch 是什么
- 二、安装 CC Switch
- 2.1 Windows
- 2.2 macOS
- 2.3 Linux
- 2.4 验证安装
- 三、注册 weelinking 获取 API Key
- 四、在 CC Switch 中添加 weelinking
- 4.1 添加供应商
- 4.2 启用配置
- 4.3 验证生效
- 五、日常使用:一键切换
- 六、进阶:MCP / Skills / Prompts 管理
- 七、常见问题
- 八、配套资源
🔴 🔴 🔴 国内丝滑使用 Claude? 👉 本文全系使用 weelinking,全系模型支持 👈

一、CC Switch 是什么
CC Switch 是开源跨平台桌面工具,专为管理 Claude Code / Codex / Gemini CLI 的 API 供应商配置而生。
核心能力:
| 供应商管理 | 添加、编辑、删除多个 API 供应商,一键切换 |
| 系统托盘 | 常驻右下角,右键菜单秒切 |
| MCP 统一管理 | 跨 CLI 统一管理 MCP 服务器 |
| Skills 管理 | 从 GitHub 一键安装 Claude Skills |
| 深链接导入 | ccswitch:// 协议,一键导入配置 |
支持的 AI 编程工具:
| Claude Code | Anthropic 官方 CLI |
| Codex | OpenAI 的 AI 编程工具 |
| OpenCode | 开源 AI 编程助手 |
| Gemini CLI | Google 的 AI 命令行工具 |
二、安装 CC Switch
2.1 Windows
前往 GitHub Releases 下载 .msi 安装包:
https://github.com/farion1231/cc-switch/releases

双击 .msi 按向导安装,完成后任务栏托盘区出现 CC Switch 图标。
⚠️ 若弹出 SmartScreen 提示,点「更多信息」→「仍要运行」即可。不想安装可下载 .zip 便携版直接运行。
2.2 macOS
# ── Homebrew 安装(推荐)──────────────────
brew tap farion1231/ccswitch
brew install –cask cc-switch
⚠️ 首次打开提示「无法验证开发者」:「系统设置」→「隐私与安全性」→「仍要打开」,或右键图标 → 「打开」。
2.3 Linux
# ── Ubuntu / Debian ──────────────────────
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_3.10.x_amd64.deb
sudo dpkg -i cc-switch_3.10.x_amd64.deb
# ── Arch Linux ───────────────────────────
paru -S cc-switch-bin
# ── AppImage(通用)─────────────────────
chmod +x cc-switch-3.10.x.AppImage
./cc-switch-3.10.x.AppImage
⚠️ ARM64 用户需先安装依赖:sudo apt install xdg-utils
2.4 验证安装
启动后主窗口显示供应商列表,托盘出现图标即为成功。若此前已手动配置过 ~/.claude/settings.json,CC Switch 会自动检测并导入。
三、注册 weelinking 获取 API Key
第一步: 注册
https://api.weelinking.com/register?aff=EkqDmLGT

微信扫码登录,新用户自动获得体验额度。
第二步: 创建 API Key
进入「密钥管理」→「创建新密钥」,复制以 sk- 开头的密钥。

weelinking 配置参数:
| Base URL | https://api.weelinking.com |
| API Key | 控制台创建,sk- 开头 |
| 支持模型 | Claude Sonnet / Opus 全系列 |
四、在 CC Switch 中添加 weelinking
4.1 添加供应商
启动 CC Switch,点击右上角 「+」 或 「Add Provider」。

按以下信息填写:
| Provider Name | weelinking |
| Base URL | https://api.weelinking.com |
| API Key | sk-你的密钥 |

⚠️ Base URL 末尾不要加斜杠,否则 Claude Code 拼接路径时会出现双斜杠错误。
点击「Add」完成添加。

4.2 启用配置
在供应商列表中找到 weelinking,点击「Enable」,按钮变为「Active」即生效。

CC Switch 自动将以下内容写入 ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
"ANTHROPIC_BASE_URL": "https://api.weelinking.com",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_MODEL": "claude-opus-4-6",
"ANTHROPIC_REASONING_MODEL": "claude-opus-4-6-thinking"
},
"includeCoAuthoredBy": false
}
4.3 验证生效
# ── 启动 Claude Code 验证 ─────────────────
claude
启动后输入任意问题,收到正常回复即接入成功。

⚠️ 若提示 Invalid API Key:检查密钥是否完整(含 sk- 前缀,无多余空格),Base URL 是否正确,或点击供应商旁「健康检查」按钮排查。
五、日常使用:一键切换
配置多个供应商后,右键系统托盘图标即可秒切,无需重启终端。

六、进阶:MCP / Skills / Prompts 管理
6.1 MCP 服务器统一管理
点击顶部「MCP」标签,支持 stdio、http、sse 三种类型,一次配置,Claude Code / Codex / Gemini CLI 共享。

6.2 Skills 批量安装
点击「Skills」标签,自动扫描 GitHub 公开 Skills 仓库,勾选即装。

6.3 Prompts 管理
点击「Prompts」标签,管理多套系统提示词预设,同步到 CLAUDE.md / AGENTS.md / GEMINI.md,场景切换一键生效。
七、常见问题
| Windows 用户名含中文导致路径错误 | 使用英文用户名,数据库路径:%USERPROFILE%\\.cc-switch\\cc-switch.db |
| 切换供应商后 Claude Code 未生效 | 关闭当前 Claude Code 会话后重新打开 |
| 429 Too Many Requests | 在 weelinking 控制台检查限速配置或联系支持提升额度 |
| 全量重装后配置丢失 | 重装前备份 ~/.cc-switch/cc-switch.db |
八、配套资源
// ── weelinking 供应商配置模板(可直接导入 CC Switch)──
{
"name": "weelinking",
"baseUrl": "https://api.weelinking.com",
"apiKey": "sk-你的API密钥"
}
- CC Switch 下载: https://github.com/farion1231/cc-switch/releases
- weelinking 注册: https://api.weelinking.com/register?aff=EkqDmLGT
📖 推荐阅读
如果这篇对你有帮助,以下文章你也会喜欢:
- Claude Code 省 Token 终极指南:从烧钱到精打细算 — 接了 weelinking 按量付费,做到终极省钱
- CC Switch 完全安装指南:5 分钟配置好 Claude Code 的多 API 切换神器,全程接入 weelinking — 可以丝滑无缝切换多平台的API
- 把 Claude Code 用成工程工具:8 条黄金法则与一套可复用工作流 — CC Switch 配置好之后,这 8 条法则能让你的 Claude Code 效率再翻一倍
🔴 🔴 🔴 国内廉价稳定使用 Claude? 👉 本文丝滑使用 weelinking,高性价比,全系模型支持 👈




