夜雨聆风如果你跟我一样，电脑上同时装着 Claude Code、Codex、Gemini CLI 这些 AI 编程工具，那你肯定懂那种痛苦——今天想换个模型试试，得去翻 settings.json；明天公司账号跟个人账号要来回切，又得改 ANTHROPIC_API_KEY。改来改去，手一抖还容易把配置搞崩，终端里报错一片红，心态也跟着崩。
直到我挖到了这个叫 CC Switch 的开源项目，才算真正解脱。
它是个跨平台的桌面小工具，专门帮你统一管理这些 AI 编程 CLI 工具的配置。不用手写 JSON，不用记环境变量，点几下鼠标就能在几十个供应商之间来回切。目前已经在 GitHub 上攒了将近六万颗星星，社区里用的人挺多。
先说说它能管啥
CC Switch 支持五个主流工具：Claude Code、OpenAI Codex、Gemini CLI、OpenCode 和 OpenClaw。以前这五个家伙各管各的，配置文件散落在电脑不同角落，格式还都不一样。CC Switch 把它们全拢到一个界面里，API Key、Base URL、模型名称这些杂七杂八的参数，全部可视化配置。
更爽的是它内置了 50 多个供应商预设。DeepSeek、Kimi、智谱 GLM、阿里百炼、OpenRouter、AWS Bedrock、NVIDIA NIM……基本上你听过的主流服务，点一下就能导入。不用去官网翻文档找 endpoint 地址，复制个 API Key 进去就能用。
安装其实特简单
这工具基于 Tauri 2 构建，体积很小，Windows 上安装包也就十几兆，比那些 Electron 应用轻快多了。
Windows 用户：直接去 GitHub Releases 页面下载 .msi 安装包，双击一路下一步就行。如果嫌安装麻烦，也有绿色便携版，解压就能跑。遇到系统弹窗提示"无法验证发行者"，点"更多信息"再选"仍要运行"就好。
macOS 用户：最推荐用 Homebrew，一行命令搞定：
brew tap farion1231/ccswitchbrew install --cask cc-switch当然你也可以下载 .dmg 文件，把图标拖进应用程序文件夹。第一次打开如果提示"无法验证开发者"，去系统设置的"隐私与安全性"里点一下"仍要打开"就行。
Linux 用户：Ubuntu 或 Debian 下载 .deb 包，终端里跑 sudo dpkg -i 安装。其他发行版可以用 AppImage，给个执行权限就能直接运行。Arch 用户也有社区维护的包，用 paru -S cc-switch-bin 就能装。
装好之后第一次启动，它会自动扫描你电脑上已有的 Claude Code、Codex 这些工具，把现有配置导入进来，省得你重新填一遍。
怎么用？我手把手教你
打开 CC Switch，主界面长这样，顶部一排图标对应五个工具，点哪个就管哪个。
第一步：添加供应商
点右上角的加号，会弹出一堆预设。比如你想接 DeepSeek，直接选 DeepSeek 的预设模板，然后填两个东西：API Key 和请求地址。API Key 去 DeepSeek 控制台创建，请求地址一般预设已经填好了，像 https://api.deepseek.com/anthropic 这种。给这个配置起个名字，比如"DeepSeek-个人号"，保存。
如果是比较冷门的服务商，预设里没有，就选"自定义配置"，手动填名称、Base URL、API Key、模型 ID 这些信息。CC Switch 支持 Anthropic Messages 原生格式，也支持 OpenAI Chat Completions 兼容格式，基本通吃。
第二步：模型映射
有些工具对模型名称有特定要求，比如 Claude Code 默认找 Sonnet、Opus、Haiku 这些角色。CC Switch 里可以设置模型映射，把实际的模型 ID 对应到工具需要的角色名上。比如你把 xopqwen36v35b 映射成 Sonnet，Claude Code 就能正常识别。
第三步：启用并测试
在主界面列表里，点一下你想用的供应商，再点"启用"。CC Switch 会自动把配置写入对应工具的配置文件，像 Claude Code 的 ~/.claude/settings.json 这种，完全不用你动手。
然后点供应商旁边的"测试模型"按钮，它会发一个探测请求过去，确认 API Key 和网络通路是不是通的。如果返回绿色勾，就说明搞定了。
第四步：开用
打开终端，运行 claude 或者 codex，这时候它连的就是你刚才配置好的供应商。整个过程不用重启电脑，Claude Code 甚至支持热切换，不用重开终端。
系统托盘切换超方便
CC Switch 可以常驻后台，在系统托盘里挂着。想换模型的时候，点一下托盘图标，弹出菜单直接选另一个供应商，秒切。这个对频繁对比不同模型效果的人特别友好，比如上午用 DeepSeek 写代码，下午切到 Claude Opus 做复杂任务，晚上再换到轻量模型跑简单脚本，全程不用打开主界面。
还有一些隐藏技能
MCP 和 Skills 统一管理：Claude Code、OpenCode、OpenClaw 都有自己的 MCP Server 和 Skills 配置，以前分散在各处，现在 CC Switch 把它们集中到一个面板。新增一个 MCP 服务器，可以同时下发到多个工具，不用重复配置。
本地代理模式：开启后，所有请求先经过 CC Switch 的本地代理再转发。好处是运行时也能热切换供应商，而且支持自动容灾——主供应商挂了，它会自动切到备用的。还能做格式转换，比如把 OpenAI 格式的请求转成 Anthropic 格式，让只支持一种协议的工具也能调用另一种协议的模型。
用量统计：它有个仪表盘，能看每个供应商的请求数、Token 消耗和预估花费。月底查账单的时候心里有个数，不至于被突如其来的扣费吓到。
云同步：配置可以通过 Dropbox、OneDrive、iCloud 或者 WebDAV 同步。公司电脑配好了，家里电脑登录同一个云盘账号，配置自动同步过来，不用手动复制粘贴。
自动备份：每次写入配置前，它都会先备份一份。万一改错了，随时能还原，不怕手残。
说点实在的
CC Switch 不是那种花里胡哨的工具，它解决的就是一个特别实在的痛点——配置管理。如果你只用一款工具、一个 API Key、一台电脑，那直接改配置文件确实够用了。但只要你开始折腾多个模型、多个账号、多个工具，CC Switch 的价值立刻显现。
而且它是完全开源免费的，MIT 协议，代码都在 GitHub 上公开。你的 API Key 存在本地 SQLite 数据库里，不会上传到作者的服务器，隐私这块可以放心。
GitHub 地址：https://github.com/farion1231/cc-switch