大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



摘要：用 Claude Code 的人都懂那种痛：想换个供应商，得翻配置文件、改 API 地址、换 Key、重启终端，手抖一下配置就废了。CC-Switch 是一款开源桌面工具，50+ 供应商预设、一键切换、系统托盘热切换，还统一管理 MCP、Skills、Prompts、费用追踪……本文从安装到上手全流程拆解。

---

哈喽，大家好，我是顾北！

说说我最近一次被 Claude Code 配置搞崩的经历。

那天下午想切到另一家中转服务商试试效果，操作流程大概是这样的：

1. 打开文件管理器，翻到 ~/.claude/ 目录
2. 找到 claude_desktop_config.json（有时候文件名还记不准）
3. 用编辑器打开，眯着眼睛找 baseURL 和 apiKey 字段
4. 手动改地址和 Key，祈祷自己没有多打一个引号或少打一个逗号
5. 保存，关掉终端，重新打开
6. 跑一个命令测试是否生效

整个过程大概要五分钟，听起来不长，但每一步都在打断你的注意力。最惨的一次我把 JSON 格式搞坏了，Claude Code 直接起不来，花了十分钟排查才发现少了一个右括号。

如果你也用 Claude Code，这种感觉你一定懂。

问题的根子在于：Claude Code 本身是个命令行工具，它不管理供应商，只读配置文件。 想切换，只能自己动手改。想同时管多个 AI CLI 工具？每个工具的配置格式还不一样——Claude Code 用 JSON，有的用 TOML，有的用 .env……

就在我快被这件事搞烦的时候，我发现了 CC-Switch。

一句话：CC-Switch 是一个专门服务于 AI 编程 CLI 工具的桌面供应商管理器。

开源地址：https://github.com/farion1231/cc-switch目前已有 44,000+ Star，36 个版本迭代，90 位贡献者。最新版本 v3.13.0（2026-04-10）。

它支持的工具涵盖当前最主流的五款 AI 编程 CLI：

• Claude Code（Anthropic）
• Codex（OpenAI）
• Gemini CLI（Google）
• OpenCode
• OpenClaw

技术栈是 Rust + Tauri 2 + React/TypeScript，跨平台支持 Windows、macOS、Linux，MIT 开源。用 Rust 写后端的好处是内存安全、启动快、包体积小——桌面工具该有的样子。

它的核心设计理念也很直接：你不应该去手动编辑配置文件。所有供应商配置都存在一个 SQLite 数据库里，切换的时候 CC-Switch 负责把对应的配置写入到各工具读取的文件里。原子写入（临时文件 + 重命名），不会出现写一半断掉导致配置损坏的情况。

 供应商管理：50+ 预设，一键切换

这是 CC-Switch 最核心的功能，也是我用得最频繁的。

内置了 50+ 供应商预设，涵盖：

• 官方渠道（Anthropic、OpenAI、Google 原生）
• 云厂商（AWS Bedrock、NVIDIA NIM、Azure）
• 国内主流中转服务（SiliconFlow、MiniMax 等）
• 社区常见的中转节点

添加一个新供应商的流程是：点「添加供应商」→ 从预设列表选 → 填入你的 API Key → 保存。就这三步，连 Base URL 都帮你填好了。

切换供应商有两种方式：

1. 主界面切换：选中供应商，点「启用」
2. 系统托盘快切：右键托盘图标，直接点供应商名字，秒生效

特别说一下 Claude Code 的热切换——不需要重启终端。其他工具切换后需要重启对应的 CLI 才生效，但 Claude Code 是个例外，CC-Switch 可以直接热刷新它的配置。这在你工作到一半想换个模型/供应商时非常有用。

 本地代理与故障转移

这个功能对重度用户来说很有价值，但可能不是所有人第一时间会用到。

CC-Switch 支持开启一个本地代理，作为你本机 AI CLI 工具和远端 API 之间的中间层。它能做的事包括：

• 格式自动转换：有些中转服务的 API 格式和 Anthropic 官方略有差异，本地代理帮你抹平这个差异
• 多供应商自动故障转移：配置多个供应商后，一个挂了自动切到下一个，不中断你的工作
• 熔断保护：某个供应商连续失败次数超过阈值，自动暂停请求，避免无效等待
• 健康监控：实时监控各供应商的可用状态

对于经常遇到「API 超时」或者「这个服务今天又不稳定」的人来说，这个功能可以大大减少被中断的次数。

里 MCP 统一管理

用过 Claude Code MCP（Model Context Protocol）扩展的人应该知道，配置 MCP 服务器是另一件麻烦事——每个工具都有自己的配置位置，手动在四五个地方维护同一份 MCP 服务器列表真的很烦。

CC-Switch 提供了一个统一的 MCP 管理面板，一次配置，可以同步到所有支持的工具（Claude Code、Codex、OpenCode、OpenClaw）。

特别好用的是 Deep Link 导入：如果 MCP 服务器提供商给了你一个 ccswitch:// 开头的链接，点一下就自动导入配置，不用手动填。

 Prompts 管理

用 Claude Code 的人大概率都有自己的 CLAUDE.md——里面是你告诉 AI 的项目背景、代码规范、行为准则等。

CC-Switch 的 Prompts 功能提供了一个 Markdown 编辑器，可以：

• 统一管理不同工具的提示词文件（CLAUDE.md、AGENTS.md、GEMINI.md）
• 一次编辑，跨应用同步
• 防覆盖保护：切换供应商时不会意外覆盖你正在使用的提示词

 Skills 管理

Claude Code Skills（也就是「斜杠命令」插件体系）最近越来越完善，社区里各种好用的 Skill 也在涌现。

CC-Switch 支持直接从 GitHub 仓库或 ZIP 包一键安装 Skills，安装完之后会自动 symlink 到对应工具的目录，所有已安装的 Skills 在一个面板里统一管理。

这个SKill管理可以重点说一下。

它支持从本地一键导入已有的Skill配置信息。

还有我觉得比较人性化的一个方面就是它支持直接从Github仓库和skills.sh中找到你需要的Skill一键安装。

这样就不需要再打开仓库或者打开skills.sh自己下载或者让AI帮你安装了。

 用量与费用追踪

这个功能救了我好几次——月底看账单吓一跳之前，可以提前知道自己花了多少。

Dashboard 里可以看到：

• 每日/每月请求数、Token 用量
• 费用趋势折线图
• 详细的每次请求日志（时间、模型、Token、费用）
• 支持自定义每个模型的单价——如果你用的是中转服务，可以按实际费率填

 会话管理

CC-Switch 可以读取各 AI CLI 工具保存在本地的对话历史，提供一个统一的浏览、搜索、恢复界面。

找之前那次对话要回顾某个方案？不用去翻终端历史，直接在 CC-Switch 里搜关键词，点开就能看。

☁️ 云同步

如果你有多台设备（比如公司台式机和家里的 MacBook），CC-Switch 支持把配置目录指向一个同步盘：

• Dropbox、OneDrive、iCloud——直接改配置目录到对应的同步文件夹
• 自建 NAS 或任意 WebDAV 服务器也支持

这样所有的供应商配置、MCP 服务器、提示词……换台设备打开 CC-Switch 就能用上，不用重新配一遍。

安装

Windows（推荐）

1. 打开 GitHub Releases 页面：https://github.com/farion1231/cc-switch/releases/latest
2. 下载 CC-Switch-vX.X.X-Windows.msi（安装版）或 CC-Switch-vX.X.X-Windows-Portable.zip（便携版）
3. MSI 版双击安装，一路下一步；便携版解压直接运行 exe

系统要求：Windows 10 及以上。

macOS

推荐用 Homebrew：

 brew tap farion1231/ccswitch brew install --cask cc-switch 

或者到 Releases 页下载 .dmg，已经过 Apple 公证，直接双击安装，无需额外操作。

更新时：

 brew upgrade --cask cc-switch 

Linux

到 Releases 页根据你的发行版下载：

• CC-Switch-vX.X.X-Linux.deb（Debian/Ubuntu）
• CC-Switch-vX.X.X-Linux.rpm（Fedora/RHEL）
• CC-Switch-vX.X.X-Linux.AppImage（通用）

Arch Linux 用户：

 paru -S cc-switch-bin 

首次启动

首次打开 CC-Switch，它会检测你本机已安装的 AI CLI 工具。如果你之前已经配置过 Claude Code（比如已经有 API Key 在配置文件里），可以选择导入现有配置作为默认供应商。

这一步很重要——它会把你已有的配置读进来，不会丢失之前的设置。

添加第一个供应商

1. 点击主界面的「添加供应商」按钮
2. 在预设列表里找到你要用的服务商（比如 SiliconFlow、官方 Anthropic 等）
3. 填入你的 API Key（Base URL 已经帮你填好了）
4. 点保存

如果用的是小众服务商没有预设，选「自定义」，手动填 Base URL 和 API Key 就行。

切换供应商

方式一：主界面

• 在供应商列表里选中目标供应商，点「启用」即可

方式二：系统托盘

• 点击任务栏/菜单栏的 CC-Switch 图标，直接点供应商名字，立即切换

切换后：

• Claude Code：无需重启，直接生效（热切换）
• 其他工具：重启对应的终端或 CLI 工具后生效

回到官方登录

如果你想切回 Anthropic 官方（用 OAuth 登录而不是 API Key），操作流程是：

1. 在预设里找到「官方登录」预设，添加并启用
2. 重启 Claude Code
3. 按照 Claude Code 的登录提示走 OAuth 流程

之后你可以在官方登录和第三方供应商之间自由切换，CC-Switch 会帮你记住两边的配置。

数据在哪里

所有数据都存在本地：

如果你担心数据安全，所有内容都在这几个目录里，可以随时备份或迁移。

坦白说，CC-Switch 的功能有点超出我最初的预期。

我最开始只是想解决「换 API Key 太烦」这个问题，结果用了之后发现 MCP 统一管理、费用追踪这些功能也悄悄成了日常必用的东西。现在 MCP 服务器配了一堆，每次在 CC-Switch 里统一管，再也不用去各个工具的配置文件里翻来翻去。

有一点值得单独说：系统托盘的快切功能改变了我使用 AI 编程工具的方式。以前换供应商是一个「决定要做的任务」，现在变成了一个「顺手的动作」。这种摩擦感的消失，真的会让你更愿意去尝试不同的服务，找到最适合当前任务的那个。

当然也不是没有地方可以改进——比如移动端暂时没有配套，跨设备同步还是要依赖外部网盘。但对于桌面开发者的日常来说，它解决的问题已经足够核心了。

AI 编程工具的生态正在快速扩张：Claude Code、Codex、Gemini CLI……各家都在跑，API 供应商生态更是百花齐放。这种繁荣对开发者是好事，但随之而来的「多工具管理」问题也会越来越突出。

CC-Switch 给出的答案是：一个统一的管理入口。不管你用哪家的服务，不管你偏好哪款 CLI 工具，进来都在一个地方管。这个思路在工具越来越多的未来会越来越有价值。

如果你也在日常用 Claude Code 或者其他 AI 编程 CLI 工具，CC-Switch 值得花十分钟装上试试。

GitHub 地址：https://github.com/farion1231/cc-switch

我是顾北，关注我，解锁更多好玩好用的AI工具，谢谢你阅读我的文章，我们下期再见！