不再手改配置文件换供应商：AI 编程工具 CC Switch 快速上手-平芜编程栈

不再手改配置文件换供应商：AI 编程工具 CC Switch 快速上手

【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch

周五下午，你打开 .env 改 Claude Code 的 base_url，切到 Codex 发现又是 TOML，还得再查 Gemini CLI 的写法。写代码半小时，换 key 花了一小时。CC Switch 就是冲这个痛点来的：它用一个桌面应用统一管理 Claude Code、Codex、Gemini CLI 等八大 AI 编程工具的供应商配置，一键切换，不再翻文件。

它到底是什么

一句话：CC Switch 是一款免费开源的跨平台桌面应用，覆盖 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes Agent 八个工具，把供应商配置、MCP、技能管理收进同一个可视化界面。整套设计走"最小侵入"路线——即使卸载它，你的 CLI 工具照常能用，因为它写的本来就是工具自己读的那些配置文件。各项功能的细节可查用户手册。

主界面：所有供应商和状态一览

三平台怎么装

Windows：装完即用

从 Releases 页下载最新 .msi 安装包（也有免安装的绿色版），装完在开始菜单和桌面都有入口，首次启动会自动检测系统里已装的 AI 工具。

macOS：一条 brew 命令

习惯 Homebrew 的话，这是全文唯一的命令：

brew install --cask cc-switch

直接下 DMG 也可以，官方包已做 Apple 签名和公证，双击打开不会报"无法验证开发者"。

Linux：按发行版挑一个

Debian/Ubuntu 用 .deb，Fedora/RHEL 用 .rpm，也可以拿 AppImage 赋予执行权限直接跑。Ubuntu 22.04、Debian 11 这类主流版本都兼容。

日常怎么用

第一次配供应商：挑个预设，贴 Key 就行

解决"只有官方账号，想再接一个"的问题。主界面点"添加供应商"，从 50 多个预设（DeepSeek、智谱、Kimi、MiniMax 等）里挑一个，只需填 API Key，请求地址已预置，不用查文档。工具里已有配置的话，首次启动时还能导入为默认供应商，第一天起就出现在列表里。

挑一个预设，只填 Key 就行

高频切 key：托盘里点，不用开窗口

在两个订阅或工作、个人账号之间来回切的人，最常用的是系统托盘菜单：点一下供应商名称立即生效，不用打开主窗口。主界面里也能拖拽排序，把最常用的顶到最上面。有个细节值得记一下：多数 CLI 工具启动时才读配置，切完要重启终端；Claude Code 是例外，热切换，不重启。

团队同步配置：深度链接一键导入

解决"同事也想用同一套配置"。导出 JSON 文件，或者生成 ccswitch:// 深度链接，对方点开链接，供应商直接导入，不用在群里贴 key。只有一台机器的话这条可以跳过，云同步在下一节。

再往后一步

供应商挂了自动切，格式不合自动转

本地代理服务可以和供应商切换配合使用：主供应商失败时自动故障转移到备用的，熔断器避免连续失败把整个链路拖垮，还会定期做健康检查。另一个常见场景是格式不兼容——比如想在 Claude Desktop 里跑 DeepSeek 的模型。打开"模型映射/本地路由"开关，CC Switch 会在本地做协议转换和模型名映射，让对端以为自己在调官方模型。

把菜单里的模型名映射到真实请求模型

钱花在哪：用量仪表盘与自定义定价

用量仪表盘跨供应商记录支出、请求数和 Token 用量，有趋势图，也能翻到逐条请求的日志。每个模型的手动定价都可以自己维护，对比"订阅还是按量付费更划算"时，看这块面板就行。

会话、MCP、技能：资产一起管

会话管理器可以浏览、搜索并恢复多来源的对话历史；MCP 面板把六个工具的 MCP 服务器放在一处管理，支持双向同步和深度链接导入；技能支持从 GitHub 仓库或 ZIP 包一键安装；提示词预设可跨应用同步。这几样属于"资产"，统一管理比单独换供应商更省心。

卡住了：三个最高频的情况

切完供应商不生效现象：换了供应商，CLI 还在走旧的 key。原因：多数工具只在启动时读一次配置。解法：重启终端或对应 CLI 工具即可，Claude Code 不用重启。

切完发现插件配置"没了"现象：新启用的供应商少了原来的插件。原因：新供应商是空白创建的，通用数据没跟着走。解法：编辑供应商时用"从当前供应商提取"把通用数据存进通用配置，新建时勾选"应用通用配置"。

激活中的供应商删不掉现象：每个工具至少有一个激活供应商拒绝删除。原因：这是设计——全删了该工具就没法用了。解法：留着就好，不常用该工具可在设置里关掉它的显示。

技术一眼

前端 React + TypeScript，后端 Rust 用 Tauri 2 构建，数据存 SQLite 并做原子写入保护，代码按命令→服务→DAO→数据库分层，配置不会出现"写一半损坏"。

打开 CC Switch，添加第一个供应商，把换 key 这件事交给它。官网 ccswitch.io 可下载，新特性跟进 CHANGELOG.md。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

不再手改配置文件换供应商：AI 编程工具 CC Switch 快速上手