CC-Switch 下载、安装与使用全指南

CC-Switch 下载、安装与使用全指南CC-Switch 是一款开源跨平台桌面工具用于统一管理 Claude Code、Codex、Gemini CLI、OpenCode 及 OpenClaw等 AI 编程 CLI 的配置与切换支持系统托盘快速切换、MCP/Skills/Prompts 统一管理内置 50 供应商预设无需手动编辑配置文件。一、核心信息速览项目详情下载https://pan.quark.cn/s/d6152047213b支持平台Windows 10、macOS 12、Linux (Ubuntu 22.04/Debian 11/Fedora 34)核心功能多模型一键切换、MCP统一管理、Skills/Prompts 管理、API 测速、配置备份安装方式官方安装包 / 包管理器 / 便携版二、下载方式前往CC-Switch 下载获取最新版https://pan.quark.cn/s/d6152047213b按系统选择安装包Windows推荐CC-Switch-v{版本}-Windows.msi安装版一键部署备选CC-Switch-v{版本}-Windows-Portable.zip绿色便携版解压即用macOS推荐CC-Switch-v{版本}-macOS.dmg已公证直接安装命令行brew tap farion1231/ccswitch brew install --cask cc-switchLinuxDebian/UbuntuCC-Switch-v{版本}-Linux.debsudo dpkg -i 包名Fedora/RHELCC-Switch-v{版本}-Linux.rpmsudo rpm -i 包名通用CC-Switch-v{版本}-Linux.AppImage赋权后直接运行三、安装步骤Windows 安装双击.msi安装包按向导完成安装默认下一步即可。安装完成后启动程序首次运行会自动创建配置目录。macOS 安装DMG 安装打开.dmg将CC-Switch.app拖入Applications文件夹双击打开即可已公证无需额外操作。Homebrew 安装执行命令行安装更新时用brew upgrade --cask cc-switch。若提示“无法验证开发者”前往系统设置 → 隐私与安全性点击“仍然打开”。Linux 安装Debian/Ubuntusudo dpkg -i cc-switch_*.deb依赖缺失时执行sudo apt -f install修复。Fedora/RHELsudo rpm -i cc-switch_*.rpm。AppImage下载后右键赋权chmod x 包名双击运行。四、快速上手5 分钟1. 首次启动与添加 Provider打开 CC-Switch主界面清晰直观。点击Add Provider选择预设如 Claude Code、Codex、Kimi 等或手动自定义。输入API Key与基地址自定义供应商需填写点击保存。2. 启用与切换 Provider选中已添加的配置点击Enable主界面或右键系统托盘图标直接切换。生效说明Claude Code 支持热切换无需重启终端。其他 CLI 工具需重启终端或工具以加载新配置。3. 高级功能按需启用MCP 管理进入 MCP 页签添加服务器支持 stdio/http/sse一键同步到所有客户端。Skills 安装进入 Skills 页签搜索 GitHub 热门仓库一键安装/卸载。Prompts 管理用 Markdown 编辑提示词模板激活后同步到对应工具。API 测速在 Provider 管理中查看节点延迟选择最优节点。配置备份自动保留最近 10 个版本支持导入导出防止配置损坏。五、常见问题与解决方案问题解决方法切换后配置不生效重启终端/Cli 工具Claude Code 除外macOS 无法打开系统设置 → 隐私与安全性 → 允许打开删除不了当前激活的 Provider先切换到其他配置再删除闲置项系统保留至少 1 个有效配置配置丢失从备份目录恢复~/.cc-switch/backups/想切回官方供应商添加“官方登录”预设重启工具后执行登录/OAuth 流程六、数据存储路径配置数据库~/.cc-switch/cc-switch.dbSQLite本地设置~/.cc-switch/settings.json备份文件~/.cc-switch/backups/自动保留 10 个版本Skills 目录~/.cc-switch/skills/七、总结CC-Switch 解决了多 AI 编程 CLI 配置切换繁琐、管理分散的痛点通过可视化界面实现一键切换、统一管理适合重度使用 Claude Code、Codex、Gemini CLI 等工具的开发者。安装后建议先完成基础配置再根据需求启用 MCP/Skills 等高级功能提升开发效率。需要我根据你的系统Windows/macOS/Linux提供定制化安装命令和首个 Provider 配置模板吗