如何一键安装使用Claude Code Switch？

📌 摘要 用过 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 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 双击装完之后，任务栏右下角会出现 CC Switch 的图标，看到它就说明装好了。 ⚠️ Windows 有时候会弹 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 验证安装 启动之后主窗口会列出供应商列表，托盘也有图标，那就没问题了。