快速结论
CC Switch 3.18 是一个 MIT 开源的 Tauri 桌面配置管理器，用同一界面管理八个 AI 编程工具：Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes。它能导入、保存和切换 Provider 配置，统一管理 MCP、Skills 与提示词，并提供会话浏览、用量记录、项目配置快照、云同步和本地代理接管。适合同时使用多个客户端、多个官方或自建端点，且已经被 JSON、TOML、环境变量和不同目录格式拖累的进阶开发者。
它也是高信任软件。数据库会保存 Provider、MCP、提示词和 Skills 配置；本地代理可能看到请求、响应、token 用量和路由状态；云同步可把 Provider 数据复制到 Dropbox、OneDrive、iCloud 或 WebDAV；深链和第三方 Skills 能写入配置；部分 OAuth 功能会保存刷新令牌。3.18 已加强日志脱敏和权限，但“本地桌面应用”不能自动消除这些风险。本站不默认推荐，团队应先审查源码与发布制品，在隔离账号中验证，并优先采用官方登录或直接官方 API，而不是因 README 中的赞助链接选择第三方 relay。
核心功能
- 八工具统一管理：覆盖 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 与 Hermes。
- Provider 配置与切换：导入官方、自定义和兼容端点配置，通过桌面界面或系统托盘切换。
- MCP、Skills 与提示词同步：在支持的客户端间同步 MCP server、Agent Skills 和 CLAUDE.md、AGENTS.md、GEMINI.md 等提示文件。
- 本地代理与格式转换：为多个客户端提供接管、协议转换、热切换、故障转移、熔断、健康检查和请求修正。
- 用量与会话：读取支持客户端的本地会话，记录请求、token 和自定义模型价格，用于趋势与成本分析。
- 项目配置快照：保存 Provider、MCP、Skills 和提示词状态，在不同项目工作流间切换。
- 云同步与备份：使用自定义目录或 WebDAV 同步配置，并对本地数据库和配置执行备份。
- 跨平台发布：提供 Windows、macOS 和 Linux 制品；macOS 构建标注代码签名与公证，部分制品另附
.sig，GitHub 发布页展示 SHA-256 摘要。
适合人群
- 同时维护多个 AI 编程 CLI 与桌面客户端，需要统一配置入口的开发者。
- 使用多个官方 API、自建网关或企业端点，需要明确切换和用量记录的团队。
- 愿意阅读发布说明、备份配置、核对密钥文件并测试恢复路径的高级用户。
- 想统一管理 MCP、Skills、提示词和会话，但仍保留各客户端原生文件的人。
- 不适合无法审查第三方端点、准备把生产密钥交给未经批准桌面软件，或要求集中式企业审计和强身份治理的组织。
使用场景
最安全的起点不是一次导入所有账号，而是选一个非生产 Provider 和一个客户端。备份原始配置，安装后检查 ~/.cc-switch/ 数据库、设置、备份和日志目录，再测试导入、切换、退出与恢复官方登录。对比切换前后实际配置文件，确认公共片段没有把某个 Provider 的密钥、endpoint 或模型错误同步到另一个客户端。Claude Code 可热切换部分 Provider 数据，其他工具通常仍需重启，不要把界面显示“已启用”当成进程已经采用新配置。
本地代理适合协议转换和故障转移，但会成为新的敏感中间层。只绑定本机需要的接口，限制监听地址，关闭不必要的请求记录，检查日志轮转和脱敏，并禁止未经批准的自动 failover 把客户代码转到不同供应商。用量看板是本地估算和日志汇总，不等同于供应商账单；模型别名、缓存 token、会话重放和自定义价格都可能造成差异。关键成本应与上游控制台对账。
价格与版本
截至 2026-07-21，CC Switch 当前版本为 3.18.0，采用 MIT 许可证，官方软件免费，没有需要向 CC Switch 充值的商业版。唯一官方渠道为 ccswitch.io、github.com/farion1231/cc-switch 与其 GitHub Releases。模型 API、第三方 Provider、云盘或 WebDAV、网络和团队运维费用均不包含在软件“免费”中。
3.18.0 把 Grok Build 加为第八个受管工具，并新增 xAI OAuth、用量重建和日志安全修复。部分受管 OAuth 会复用其他官方客户端的公开身份，发布说明明确提示上游可能不支持并可能带来账号限制；这是可选高风险功能，不应与普通 API Key 配置等同。升级会迁移本地数据库，历史日志不会被追溯脱敏。更新前应备份 ~/.cc-switch/cc-switch.db 与配置目录，阅读升级说明，并检查旧日志是否含敏感信息。
国内访问与使用体验
CC Switch 客户端本地运行，中文界面和跨平台安装降低了配置门槛，但每个 Provider 的可达性、注册、付款和模型服务仍各自独立。软件能写入一个 endpoint，不代表该服务在中国大陆合法、稳定或得到上游授权。本文不提供任何网络线路或 relay 推荐。组织应只接入已完成采购、安全和法务审查的官方 API、自建服务或批准供应商。
云同步是便利功能，也是数据外传边界。Provider 记录可能包含 API Key、URL、OAuth 信息或组织配置；将配置目录放入 Dropbox、OneDrive、iCloud、NAS 或 WebDAV 前，应确认同步范围、端到端保护、共享成员、版本历史、删除、离职回收和设备丢失处置。若没有明确需要，保持本地存储更稳妥。不要同步调试日志、数据库备份和密钥文件到个人云盘。
优点
- 一个界面覆盖八个当前 AI 编程工具，减少手工编辑多种配置格式。
- MIT 开源，Tauri、React 与 Rust 实现可供安全和运维团队审查。
- MCP、Skills、提示词、Provider 和项目快照形成较完整的配置工作台。
- 本地代理支持协议转换、熔断和故障转移，适合受控的兼容性测试。
- 3.18 加强持久日志脱敏、崩溃记录和用量重复计数修复。
- 发布页为各制品展示 SHA-256，部分平台附带签名文件，macOS 构建标注签名和公证。
不足
- 密钥、OAuth、配置、代理、日志和会话集中在一个应用中，故障影响面扩大。
- 云同步可能把 Provider 和凭据数据复制到多个设备与第三方存储。
- 本地代理能读取和转换请求；错误路由可能把代码或提示发送给非预期 Provider。
- 历史旧日志不会自动脱敏，升级后分享日志前仍需人工检查。
- README 含大量第三方 relay 赞助与推荐链接，这些服务不是 CC Switch 产品，也未因被列出而获得本站背书。
- OAuth 复用、协议转换和第三方订阅接入可能触及上游条款并带来账号风险。
- 社区桌面应用无法替代企业级密钥托管、RBAC、集中审计和供应商治理。
替代品对比
| 工具 | 更适合谁 | 主要优势 | 需要注意 |
|---|---|---|---|
| Cherry Studio | 需要多模型桌面对话、知识库和助手管理的人 | 用户对话与模型聚合体验完整 | 不是专门的八客户端配置切换器 |
| OpenCode | 想直接使用开源终端 Agent 的开发者 | 客户端本身开放且支持多 Provider | 不负责统一管理全部外部客户端配置 |
| Claude Code | 只用 Anthropic 官方终端流程的人 | 官方登录与原生 Agent 能力 | 多 Provider 切换不是核心目标 |
| Codex | 只需 OpenAI 编码 Agent 的团队 | 官方任务与代码工作流 | 第三方代理和跨客户端配置需另行治理 |
| Gemini CLI | Google 生态与开源终端客户端用户 | 官方 Gemini 接入、配置路径较直接 | 不统一其他七个客户端 |
常见问题 FAQ
CC Switch 3.18 支持几个工具？
八个：Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes。旧页面的七工具说法已过时。
CC Switch 是免费和开源的吗？
是，当前代码采用 MIT 许可证，官方软件免费。模型 API、第三方 Provider 和云存储仍可能收费；任何冒充 CC Switch 要求充值的网站都不属于官方产品。
API Key 和 OAuth token 存在哪里？
Provider、MCP、提示词和 Skills 等主要数据位于 ~/.cc-switch/cc-switch.db，设备设置与备份在同目录体系。某些 OAuth 功能使用独立文件保存刷新令牌。应按敏感凭据保护整个目录，而不只保护一个 .env。
发布制品如何核验？
只从官方 GitHub Releases 下载，核对版本与 GitHub 展示的 SHA-256。对附有 .sig 的 AppImage、Windows MSI 或 macOS tar 制品，按项目更新机制核验签名；macOS 还应检查代码签名和公证。摘要只能证明文件匹配发布页，不能代替源码与供应链审查。
README 里的第三方 relay 是 CC Switch 官方服务吗？
不是。它们是赞助商、Provider 预设或外部注册链接，各自运营、计费和处理数据。不要因出现在 README 就假定模型真实、合规、安全或有官方 SLA。
可以开启云同步保存所有配置吗？
技术上可以使用同步目录或 WebDAV，但应先确认是否包含密钥、OAuth 或组织 endpoint。团队环境应使用批准的密钥管理和同步策略，不要默认把完整数据库与日志放入个人云盘。
总结
CC Switch 3.18 解决了真实痛点：八个 AI 编程工具各有 Provider、MCP、Skills、提示词和会话格式，统一工作台能显著减少配置摩擦。但它不是无风险的“切换按钮”，而是密钥仓库、本地代理、日志系统、同步客户端和配置写入器的组合。采用前要核验官方制品、备份与恢复，最小化密钥和日志，限制代理路由，审查云同步，并把第三方 relay 链接视为未独立验证的外部服务。个人多工具用户可以小范围试用；企业团队应先完成供应商、身份、密钥、日志和数据流审查。