claude code switch安装利用指南：一键切换多Claude API

📌 择要
用过 Claude Code 的人应该都踩过这个坑——每换一次 API 供应商，就得翻出设置文件手动改，改完还得重启终端，情况变量偶然候设了等重启就没了。CC Switch 就是为相识决这个贫苦搞出来的开源桌面工具，核心就是把 Claude Code、Codex、Gemini CLI 这几个工具的 API 设置同一塞进一个可视化界面管，体系托盘挂着，想切哪个右键点一下就行。
这篇以 weecoding 为例（国内直连 Claude，按量付费，不消梯子，用了快半年了挺稳的）把完备流程写下来。从装软件到配好 API 跑起来，顺带把 MCP 同一管、Skills 批量装这些我自己在用的功能也带一带，末了列了几个我踩过的坑，应该够用。
📋 目次

• 一、CC Switch 是什么
  
• 二、安装 CC Switch
  
  
  
  • 2.1 Windows
    
  • 2.2 macOS
    
  • 2.3 Linux
    
  • 2.4 验证安装
    
  
  
• 三、注册 weecoding 获取 API Key
  
• 四、在 CC Switch 中添加 weecoding
  
  
  
  • 4.1 添加供应商
    
  • 4.2 启用设置
    
  • 4.3 验证收效
    
  
  
• 五、一样寻常利用：一键切换
  
• 六、进阶：MCP / Skills / Prompts 管理
  
• 七、常见题目
  
• 八、配套资源
  

一、CC Switch 是什么

CC Switch 是个开源的跨平台桌面工具，重要干一件事：把你手头全部 AI 编程 CLI 的 API 供应商设置同一管起来。
我用它之前，每次换个 API 都要手动编辑 JSON、重启终端，偶然候忘了改哪个文件还得翻老半天。如今装了之后根本就不消管了，托盘挂着，右键菜单三秒切换。
大概有这几块东西用得上：
功能阐明供应商管理添加、编辑、删除多个 API 供应商，一键切换体系托盘常驻右下角，右键菜单秒切MCP 同一管理跨 CLI 同一管理 MCP 服务器Skills 管理从 GitHub 一键安装 Claude Skills深链接导入ccswitch:// 协议，一键导入设置如今接入的工具（我常用前两个）：
CLI 工具阐明Claude CodeAnthropic 官方 CLICodexOpenAI 的 AI 编程工具OpenCode开源 AI 编程助手Gemini CLIGoogle 的 AI 下令行工具二、安装 CC Switch

三个平台装法不一样，找自己对应的看就行。
2.1 Windows

去 GitHub Releases 页面下载 .msi 安装包：

1. https://github.com/farion1231/cc-switch/releases

复制代码

双击装完之后，使命栏右下角会出现 CC Switch 的图标，看到它就阐明装好了。

⚠️ Windows 偶然候会弹 SmartScreen 安全提示，点「更多信息」→「仍要运行」就行。嫌贫苦的话也可以下 .zip 便携版，解压直接跑，不消安装。

2.2 macOS

1. # ── Homebrew 安装（推荐）──────────────────
2. brew tap farion1231/ccswitch
3. brew install --cask cc-switch

复制代码

⚠️ 第一次打开大概提示「无法验证开辟者」，去「体系设置」→「隐私与安全性」那边点「仍要打开」，大概直接右键图标选「打开」也行。

2.3 Linux

1. # ── Ubuntu / Debian ──────────────────────
2. wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_3.10.x_amd64.deb
3. sudo dpkg -i cc-switch_3.10.x_amd64.deb
5. # ── Arch Linux ───────────────────────────
6. paru -S cc-switch-bin
8. # ── AppImage（通用）─────────────────────
9. chmod +x cc-switch-3.10.x.AppImage
10. ./cc-switch-3.10.x.AppImage

复制代码

⚠️ ARM64 的呆板先跑一下 sudo apt install xdg-utils，否则大概起不来。

2.4 验证安装

启动之后主窗口会列出供应商列表，托盘也有图标，那就没题目了。假如你之前手动配过 ~/.claude/settings.json，CC Switch 启动时会自己检测到并导入，不消重新填。
三、注册 weecoding 获取 API Key

先去注册个账号：

1. https://www.weecoding.com

复制代码

微信扫码登录，新账号有免费体验额度可以先试试。
登进去之后，进「密钥管理」→「创建新密钥」，把天生的 sk- 开头的那串密钥复制下来备用。

四、在 CC Switch 中添加 weecoding

4.1 添加供应商

打开 CC Switch，右上角有个 「+」 按钮，大概找 「Add Provider」，点进去。

按下面这个填：
字段填写内容Provider NameweecodingBase URLhttps://api.weecoding.comAPI Keysk-你的密钥

⚠️ Base URL 末了别加斜杠，加了的话 Claude Code 拼接 API 路径时会出现双斜杠，然后就报错了。

填完点「Add」。

4.2 启用设置

供应商列表里找到刚加的 weecoding，点「Enable」，按钮变成「Active」状态就是收效了。

点完 Enable，软件就自动帮你写好 ~/.claude/settings.json 了，大概长如许，不消自己动：

1. {
2.   "env": {
3.     "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
4.     "ANTHROPIC_BASE_URL": "https://api.weecoding.com",
5.     "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
6.     "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
7.     "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
8.     "ANTHROPIC_MODEL": "claude-opus-4-6",
9.     "ANTHROPIC_REASONING_MODEL": "claude-opus-4-6-thinking"
10.   },
11.   "includeCoAuthoredBy": false
12. }

复制代码

4.3 验证收效

1. # ── 启动 Claude Code 验证 ─────────────────
2. claude

复制代码

起来之后任意问一句话，能回复就阐明接通了。

⚠️ 假如提示 Invalid API Key，先确认密钥有没有复制完备（sk- 前缀要带上，前后不能有空格），Base URL 有没有填对。还不可就点供应商旁边的「康健查抄」按钮，一样寻常能看到详细报错缘故原由。

五、一样寻常利用：一键切换

多个供应商都配好之后，一样寻常用法就很简朴了——右键托盘图标，选你要用的谁人，完事。不必要重启终端，也不消管设置文件在哪。

六、进阶：MCP / Skills / Prompts 管理

API 供应商配好之后，CC Switch 另有几个地方值得看一下，省去不少重复劳动。
6.1 MCP 服务器

顶部切到「MCP」标签。从前我在 Claude Code 和 Gemini CLI 各自配了一套 MCP，改的时间双方都得改，挺烦的。CC Switch 这里配一次，stdio、http、sse 都支持，几个工具共用同一份，省心一些。

6.2 Skills

「Skills」标签页会去扫 GitHub 上公开的 Skills 堆栈，列出来之后打个勾就装了。比手动 clone 再配路径快不少。

6.3 Prompts

「Prompts」标签管多套体系提示词预设。我自己有个写代码用的、一个写文档用的，切场景的时间点一下同步到 CLAUDE.md，不消每次手动粘。
七、常见题目

记几个我自己碰到过大概看群里有人问的：
Windows 用户名是中文，启动报路径错误
数据库文件路径走的是 %USERPROFILE%\.cc-switch\cc-switch.db，中文路径偶然候会炸。换个英文用户名是最干净的解法，大概用便携版绕开。
切换供应商之后 Claude Code 好像没有换
不是 bug，Claude Code 读设置是启动时读的。把当前会话关掉重开就行。
跑着跑着出现 429 Too Many Requests
重装之后设置没了
重装之前先把 ~/.cc-switch/cc-switch.db 备份一下，全部供应商设置都在这个文件里。
八、配套资源

weecoding 的设置模板直接复制进 CC Switch 导入就行，不消手填：

1. {
2.   "name": "weecoding",
3.   "baseUrl": "https://api.weecoding.com",
4.   "apiKey": "sk-你的API密钥"
5. }

复制代码

• CC Switch 下载： https://github.com/farion1231/cc-switch/releases
  
• weecoding 注册： https://www.weecoding.com
  

📖 文章保举

配好 CC Switch 只是出发点，这几篇接着看：

• VS Code 安装设置 Claude Code 插件教程（3分钟搞定）
  
• 2026全网首个企业级claude中转服务平台利用阐明
  
• 好用的claude国内中转平台来了，小同伴们无脑上车