CC-Switch 下载、安装与使用全指南
·
CC-Switch 安装与使用全指南
一、核心
| 项目 | 详情 |
|---|---|
| 下载 | 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-switch
- 推荐：
- Linux
- Debian/Ubuntu：
CC-Switch-v{版本}-Linux.deb（sudo dpkg -i 包名） - Fedora/RHEL：
CC-Switch-v{版本}-Linux.rpm（sudo rpm -i 包名） - 通用：
CC-Switch-v{版本}-Linux.AppImage（赋权后直接运行）
- Debian/Ubuntu：
三、安装步骤
Windows 安装
- 双击
.msi安装包，按向导完成安装（默认下一步即可）。 - 安装完成后启动程序，首次运行会自动创建配置目录。
macOS 安装
- DMG 安装：打开
.dmg，将CC-Switch.app拖入Applications文件夹，双击打开即可（已公证，无需额外操作）。 - Homebrew 安装：执行命令行安装，更新时用
brew upgrade --cask cc-switch。 - 若提示“无法验证开发者”，前往 系统设置 → 隐私与安全性，点击“仍然打开”。
Linux 安装
- Debian/Ubuntu：
sudo dpkg -i cc-switch_*.deb，依赖缺失时执行sudo apt -f install修复。 - Fedora/RHEL：
sudo 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.db（SQLite） - 本地设置：
~/.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 配置模板吗？
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
6
0- 0
已为社区贡献19条内容
所有评论(0)