cc-switch 是一个专为 Claude Code、Codex 和 Gemini CLI 打造的跨平台桌面助手，能帮你一键切换 AI 供应商、管理 API 代理并提供自动故障切换，是开发者调教 AI 编码工具的神器。
一、这个项目能做什么？
这个项目本质上是一个“AI 编码工具的指挥中心”。它由开发者 farion1231 及其社区贡献者共同维护。核心团队在 AI 工具集成、跨平台桌面开发（Tauri/Rust）以及本地代理技术方面非常有经验。
而且，它不只是一个简单的开关。它解决了我们在用 Claude Code 或 Gemini CLI 时最头疼的几个问题：
账号/模型切换难：它能管理多个 Provider（供应商），比如你想从官方 Claude 换到 GLM-4.6 或者自己搭的转发地址，点一下就行。
网络不稳：它内置了一个基于 Axum 的高性能本地 HTTP 代理，能接管 CLI 的流量。
配置混乱：它把所有的 MCP（模型上下文协议）、Prompt 提示词、技能（Skills）都统一管理起来了。 目标市场主要是那些深度依赖 AI 辅助编程的开发者，特别是需要高频切换不同大模型或者在不同网络环境下工作的硬核码农。
二、Github项目代码库供那些人使用？
目前这个项目在 Github 上非常活跃，Star 数正在稳步增长（已有数百颗星，建议去仓库实测最新数据），Fork 数量也显示出不少开发者在参与二次开发。
它的目标群体非常清晰：
Claude Code 深度用户：受够了频繁改配置文件的人。
追求极致编码体验的开发者：需要本地代理提速、自动 Failover（故障切换）的专业人士。
多模型折腾派：手里有各种 API Key（Gemini, Claude, DeepSeek 等）并想在编码时随时切换的人。
使用环境主要是 Windows、macOS 和 Linux 桌面系统。门槛不算高，但你得懂一点基本的 API Key 配置和 CLI 工具（比如 Claude Code）的操作。
三、有哪些有亮点的特色功能和服务？
我参与过几个 AI 工具的配置，cc-switch 的这几个亮点确实很戳人：
自动故障切换（Auto Failover）： 这是我最喜欢的。如果你现在的 API 抽风了，它能自动帮你跳到备用的 Provider 上，保证你写代码写到一半不会因为网络中断而抓狂。
SQLite + JSON 双层架构： 它把同步数据（供应商、MCP、Prompt）存在 SQLite 里，把设备相关的（窗口位置、本地路径）留在 JSON 里。这让数据非常稳，而且为以后云端同步打好了基础。
递归技能扫描： 它支持多层目录扫描 SKILL.md 文件，这意味着你可以把不同仓库的 AI 技能都塞进去，它会自动去重和管理。
本地 API 代理（Axum）： 它跑了一个本地高性能服务器，直接接管 CLI 的流量。你不需要在命令行里各种 export 代理地址，它在后台都帮你理顺了。
四、如何使用工具和服务？
1、有没有演示网址？
因为这是一个桌面应用程序，所以没有那种直接在线操作的 Web 演示版。但是你可以去它的 Github Releases 页面下载安装包直接上手。文档和更新日志（CHANGELOG）写得很详细，跟看演示差不多。
2、安装部署这个项目对环境有哪些要求？
它是基于 Tauri 写的，所以非常轻量。
Windows：Win10 及以上系统。
macOS：支持 Intel 和 Apple Silicon 芯片。
Linux：支持 WebKitGTK 的主流发行版。 你本地最好有 Node.js 环境（如果你想从源码编译的话），但直接用 release 里的二进制文件就只需要系统自带的运行库。
3、如何安装部署？
步骤非常直接，别想复杂了：
去 Releases 页面：找到最新的版本（比如 v3.9.1）。
下载对应包：Windows 下 .exe，Mac 下 .dmg，Linux 下 .zip。
安装：双击安装就行，没啥幺蛾子。
首次运行：它会自动检测你本地有没有旧的 config.json，然后自动迁移到 SQLite 数据库里。
配置 CLI：在设置里开启“Takeover”（接管），它就会自动劫持 Claude Code 等工具的流量。
4、使用的大模型是什么？
它本身不提供大模型，但它支持几乎所有主流模型。目前优化最好的是 Claude (Anthropic), Gemini (Google), 以及国产良心 GLM-4.6。它其实是给这些大模型当“管家”。
5、举例说明基本使用方法
比如你想用它来分析比特币价格走势：
你先在 cc-switch 里添加一个支持数据分析的模型（比如 Claude 3.5 Sonnet）。
在 cc-switch 的 Prompt 管理系统里预设一个“金融分析师”的提示词，专门负责解析行情。
打开 Claude Code 命令行，cc-switch 的代理会自动生效。
你直接问 AI：“帮我写个 Python 脚本抓取最近 30 天比特币价格，并画出 MACD 走势图。”
cc-switch 会确保你的请求稳定发给 Claude，并将结果反馈给你。
6、最近升级或者增加了哪些新的功能？
最新版 v3.9.x 增加了很多狠活：
加入了日语支持。
新增了开机自启功能（Registry/LaunchAgent 实现）。
优化了界面布局和动画，Tailwind CSS 降级到 v3.4 解决了部分浏览器不兼容的问题。
修复了 Gemini 配置文件写入和 Linux 渲染的陈年老 bug。
7、它还有哪些资源和工具？
它配套了一个 cc-switch-cli 版本，适合那些不喜欢 GUI、只想在终端里一把梭的极客。而且文档库里有非常详尽的 Release Note 和多语言使用说明。
五、需要哪些资源支持？
虽然它是本地运行，但要爽玩还是需要一些支撑：
API 密钥：你得有自己的 Claude 或 Gemini API Key。
云主机/VPS：如果你想自己搭中转，可能需要一台 VPS，但 cc-switch 本身是跑在本地的。
数据库：自带 SQLite，不需要你额外装。
不建议部署到 Cloudflare/Vercel：因为它是一个 Tauri 桌面端应用，重点是“本地接管”，不是 Web 服务。
六、网友提出了哪些常见问题
问：我的自定义 Endpoint（端点）升级后丢了怎么办？ 答：最新版本已经修复了这个问题，数据迁移逻辑已经非常完善了。
问：为什么 Linux 下界面显示不全？ 答：这是 WebKitGTK 渲染问题，v3.9.1 已经针对 Linux 做了专门的修复。
问：它能同时接管 Claude 和 Gemini 吗？ 答：可以，它可以针对不同的应用（Per-app takeover）独立设置是否接管。
问：怎么手动备份数据？ 答：在设置里有 SQL Import/Export 功能，支持一键导出 SQL dump。
问：为什么窗口打开是黑屏？ 答：这通常是 GPU 加速或者标题栏渲染的问题，新版已经改用系统标题栏解决了。
七、用户评价怎么样？
“以前切换 Claude 的 API 代理要改半天环境变量，现在点一下鼠标就搞定，太爽了。”（正面）
“那个自动故障切换（Failover）救了我好几次，写代码的思路再也不会被打断了。”（正面）
“UI 做得很精致，完全不像是开源项目的业余作品，很有科技感。”（正面）
“SQLite 迁移后，感觉配置加载快了很多，搜索技能也变流畅了。”（正面）
“刚开始从老版本 JSON 迁移时报了个错，虽然重启好了，但过程稍微有点心惊肉跳。”（负面）
八、与同类型项目对比有哪些亮点和不足？
对比对象：Roo Code (IDE 插件), Cline (IDE 插件), 以及简单的环境变量脚本。
vs Roo Code/Cline：
亮点：cc-switch 是系统级的，不局限于某一个 IDE。它能同时管 Claude Code, Codex 和 Gemini CLI。
不如的地方：如果你只在 VS Code 里写代码，插件可能更直接；cc-switch 需要额外开一个桌面应用。
vs 环境变量脚本：
亮点：cc-switch 有可视化界面，支持多供应商切换和自动重试，脚本做不到这么智能。
不如的地方：占用几百 MB 内存，脚本几乎不占内存。
vs 其他 AI Proxy 管理工具：
亮点：深度集成了 MCP 管理和技能扫描，这在同类工具里很少见，它更懂 AI 编码的痛点。
不如的地方：目前还没做云端同步，只能本地导出来手动搬家。
相关软件