• 引言/背景介绍
• 主体内容
• 1. 核心功能介绍
• 功能一:一站式配置管理
• 功能二:快速切换提供商
• 功能三:MCP 服务器管理
• 功能四:Skills 插件管理(新功能)
• 功能五:Prompts 预设管理(新功能)
• 功能六:配置导入导出
• 2. 使用体验
• 安装配置
• 实际使用感受
• 使用场景案例
• 3. 对比分析
• 技术亮点(可选)
• 总结
• 获取方式
• 引用链接

引言/背景介绍

你有没有过这样的经历：

作为一名开发者,我经常需要在不同的 AI CLI 工具之间切换工作。比如今天用 Claude Code 写代码,明天用 Codex 调试,后天又想试试 Gemini CLI 的最新功能。

每次切换工具时,最让人头疼的就是改配置文件:

• • 需要手动编辑 ~/.claude/settings.json
• • 或者修改 ~/.codex/auth.json
• • 还要处理各种环境变量和 API 密钥
• • 如果配置错了,还得花时间排查问题

更麻烦的是,有时候为了测试不同的 API 服务商,我需要频繁切换配置。一天下来,改配置的时间比写代码的时间还长。这种重复性劳动不仅浪费时间,还容易打断工作流,影响开发效率。

直到最近发现了 cc-switch —— 一款开源免费的 AI CLI 配置管理工具,彻底改变了我的工作方式。用了几天后,我发现它真的挺好适合的,今天就分享给大家。

主体内容

1. 核心功能介绍

cc-switch 是一个专为 AI CLI 工具设计的配置管理助手,目前支持三大主流工具:Claude Code、Codex 和 Gemini CLI。

功能一:一站式配置管理

功能描述:
cc-switch 提供了统一的图形界面,可以管理所有 AI CLI 工具的配置。你不需要再手动编辑 JSON 文件,所有操作都可以通过点击完成。

使用场景:

• • 需要在多个 AI CLI 工具之间切换
• • 需要使用不同的 API 服务商(官方、第三方中转等)
• • 需要为不同项目配置不同的 API 密钥

操作方式:
点击"添加提供商"按钮,选择预设模板或手动配置,填写 API 信息即可。

功能二:快速切换提供商

功能描述:
配置好多个提供商后,可以通过系统托盘图标快速切换,无需打开主界面。

使用场景:

• • API 额度用完了,需要快速切换到备用服务商
• • 想要测试不同服务商的响应速度
• • 根据项目需求切换不同的配置

操作方式:
点击系统托盘图标 → 选择要启用的提供商 → 立即生效(重启 CLI 工具后生效)

功能三:MCP 服务器管理

功能描述:
统一管理 Claude、Codex、Gemini 三个工具的 MCP(Model Context Protocol)服务器配置。

使用场景:

• • 需要为不同 AI CLI 工具配置相同的 MCP 服务器
• • 需要批量管理多个 MCP 服务器
• • 需要在不同工具间同步 MCP 配置

操作方式:
点击右上角"MCP"按钮 → 添加服务器 → 配置传输类型(stdio/http/sse) → 启用/禁用同步

功能四:Skills 插件管理(新功能)

功能描述:
自动扫描 GitHub 仓库中的 Claude Skills 插件,一键安装到本地。

使用场景:

• • 想要扩展 Claude Code 的功能
• • 需要安装社区贡献的实用插件
• • 想要管理多个 Skills 插件

操作方式:
点击"Skills"按钮 → 浏览仓库 → 选择插件 → 一键安装

功能五:Prompts 预设管理(新功能)

功能描述:
创建和管理多个系统提示词预设,快速切换不同的 AI 行为模式。

使用场景:

• • 需要针对不同任务使用不同的系统提示词
• • 想要保存和复用高质量的提示词
• • 需要在多个项目间切换提示词配置

操作方式:
点击"Prompts"按钮 → 创建预设 → 编写 Markdown 提示词 → 激活应用

功能六:配置导入导出

功能描述:
支持配置的备份和恢复,自动保留最近 10 个备份版本。

使用场景:

• • 重装系统前备份配置
• • 在多台电脑间同步配置
• • 出问题时快速恢复

操作方式:
设置菜单 → 导出配置 / 导入配置

2. 使用体验

安装配置

系统要求:

• • Windows: Windows 10 及以上
• • macOS: macOS 10.15 (Catalina) 及以上
• • Linux: Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 等主流发行版

获取方式:

Windows 用户:
访问 GitHub 发布页,下载 CC-Switch-v{version}-Windows.msi 安装包或便携版 CC-Switch-v{version}-Windows-Portable.zip

macOS 用户(推荐 Homebrew 安装):

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

或者下载 CC-Switch-v{version}-macOS.zip 解压使用

注意:由于作者没有 Apple 开发者账号,首次启动可能会提示"无法确认开发者身份",请前往"系统设置" → “隐私与安全性” → 点击"仍要打开"即可。

Linux 用户:
支持 deb、rpm、AppImage、Flatpak 多种格式,按需选择。

配置步骤:

Step 1:添加第一个提供商
首次启动会自动导入现有的 Claude/Codex 配置作为默认提供商。点击"添加提供商",可以选择预设模板(官方登录、PackyCode 等)或自定义配置。

Step 2:配置 API 密钥
填写 API 密钥、Base URL 等信息,支持环境变量和配置文件两种方式。

Step 3:启用提供商
选择要使用的提供商,点击"启用"按钮。重启 CLI 工具后即可生效。

实际使用感受

我用 cc-switch 已经几天了,分享一下真实体验:

优点:

• • 直观易用: 图形界面比手动编辑 JSON 文件友好太多,配置错误率大大降低
• • 切换迅速: 系统托盘一键切换,比打开文件编辑器快多了
• • 功能全面: 不仅管理配置,还能管理 MCP、Skills、Prompts,一站式解决
• • 跨平台同步: 支持云同步目录配置,多设备同步很方便
• • 资源占用低: 基于 Tauri 开发,内存占用很小,不影响系统性能
• • 开源免费: 完全开源,代码透明,没有任何功能限制
• • 持续更新: 项目活跃度高,bug 修复及时,新功能不断

可能的不足:

• • CLI 工具需重启: 切换配置后需要重启 Claude Code/Codex/Gemini CLI 才能生效(这是底层机制决定的,非软件问题)
• • 首次配置耗时: 如果没有现成的配置,第一次添加所有提供商需要一些时间
• • 界面语言: 目前只支持中英文双语,其他语言用户可能不太友好

使用场景案例

案例 1:快速切换 API 服务商

问题描述:
我的官方 API 额度用完了,需要临时切换到第三方中转服务商,但又不想改配置文件。

解决方案:
使用 cc-switch 预先配置好多个提供商,额度用完时,点击系统托盘图标,选择备用提供商,重启 CLI 工具即可。

效果:
从原来的 5 分钟(打开文件 → 找到配置 → 编辑 → 保存 → 验证),缩短到 10 秒(点击 → 重启),效率提升 30 倍。

案例 2:多项目配置管理

问题描述:
我有个人项目(用官方 API)和公司项目(用公司提供的 API)需要频繁切换。

解决方案:
在 cc-switch 中创建两个提供商,分别配置不同的 API 密钥,根据项目需求快速切换。

效果:
不再需要每次都手动修改配置文件,避免了将公司 API 密钥误用于个人项目的风险。

案例 3:MCP 服务器批量配置

问题描述:
我想在 Claude Code 和 Codex 中都使用相同的 MCP 服务器(如 mcp-filesystem),但需要分别配置。

解决方案:
使用 cc-switch 的 MCP 管理功能,配置一次,启用同步,自动应用到所有工具。

效果:
配置时间从 10 分钟缩短到 2 分钟,且保证了配置的一致性。

3. 对比分析

与同类工具对比:

适用场景说明:

推荐使用 cc-switch 的场景:

• • 需要在多个 AI CLI 工具间频繁切换
• • 需要使用多个 API 服务商
• • 需要管理 MCP 服务器和 Skills 插件
• • 希望降低配置错误率
• • 追求极致效率的开发者

考虑其他方式的场景:

• • 只使用一个 AI CLI 工具,且很少切换配置(手动编辑足够)
• • 只使用官方 API,不需要切换服务商
• • 不希望安装额外软件

📸 配图说明: 流程对比图
需要制作：左侧手动配置流程 vs 右侧 cc-switch 流程的对比图
参考文件：./素材/cc-switch/06-流程对比.png（待设计）

技术亮点(可选)

对于技术爱好者,cc-switch 本身也很有特色:

• • 架构设计: 基于 Tauri 2.8 + React + Rust 构建,前端轻量,后端高性能
• • 数据存储: v3.8.0 升级到 SQLite + JSON 双层架构,为云同步奠定基础
• • 原子写入: 采用临时文件 + 重命名模式,防止配置损坏
• • 并发安全: 使用 Mutex 保护数据库连接,避免竞态条件
• • 测试覆盖: 前端 hooks 100% 测试覆盖率,保证代码质量

总结

用了 cc-switch 几天后,它已经融入到我的日常工作流中。每次启动电脑,它都会自动运行,静静地待在系统托盘里,需要时才发挥作用。

核心价值:

1. 1. 效率提升: 将配置切换时间从分钟级降到秒级,大幅减少重复劳动
2. 2. 降低错误: 图形界面配置比手动编辑更可靠,避免 JSON 格式错误
3. 3. 功能整合: 一站式管理配置、MCP、Skills、Prompts,无需多个工具
4. 4. 安全保障: 开源透明,无隐私风险,本地存储配置

如果你也:

• • 频繁在 Claude Code、Codex、Gemini CLI 之间切换
• • 使用多个 API 服务商,需要快速切换配置
• • 厌倦了手动编辑 JSON 配置文件
• • 想要更高效地管理 AI CLI 工具

不妨试试 cc-switch。相信我,一旦用上就回不去了。

⚠️ 使用建议:

1. 1. 初次使用: 建议先导出现有配置作为备份,然后让 cc-switch 自动导入
2. 2. 云同步: 可以将配置目录设置为云同步文件夹(Dropbox、OneDrive 等),实现多设备同步
3. 3. 定期更新: 项目活跃度高,建议开启自动更新,获取最新功能
4. 4. 社区参与: 遇到问题可以在 GitHub 提 issue,作者响应很及时

获取方式

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

当前版本: v3.10.0

支持平台: Windows / macOS / Linux

推荐安装方式:
Windows 用户: 下载 .msi 安装包或 .zip 便携版

macOS 用户:

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

Linux 用户: 选择 .deb / .rpm / .AppImage / .flatpak 任意格式

费用说明: 完全免费开源,无任何收费项

技术栈: Tauri 2.8 + React + Rust + SQLite

项目状态: 活跃维护中,最近更新: 2026-01-22

如果你也在使用 AI CLI 工具,或者对 cc-switch 有使用疑问,欢迎在评论区分享交流!

相关阅读:

• • cc-switch 完整文档[1]
• • MCP 协议详解[2]
• • Claude Code 官方文档[3]

引用链接

[1] cc-switch 完整文档: https://github.com/farion1231/cc-switch
[2] MCP 协议详解: https://modelcontextprotocol.io/
[3] Claude Code 官方文档: https://docs.anthropic.com/en/docs/claude-code