为什么选择 CC Switch现代 AI 编程依赖于 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes 等工具——但每个工具都有自己的配置格式。切换 API 供应商意味着手动编辑 JSON、TOML 或.env文件而在多个工具之间缺乏一个统一管理 MCP、SKILLS 的方式。CC Switch为你提供一个桌面应用来管理所有支持的 AI 工具。无需手动编辑配置文件你将获得一个可视化界面一键将供应商导入应用一键在不同的供应商之间进行切换内置 50 供应商预设、统一的 MCP、SKILLS 管理以及系统托盘即时切换功能——所有操作都基于可靠的 SQLite 数据库和原子写入机制保护你的配置不被损坏。核心优势一个应用八个工具— 在单一界面中管理 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes告别手动编辑— 50 供应商预设包括 AWS Bedrock、NVIDIA NIM 和社区中转服务一键即可切换统一 MCP、SKILLS 管理— 一个面板管理 Claude、Codex、Gemini、Grok Build、OpenCode 和 Hermes 的 MCP、SKILLS支持双向同步系统托盘快速切换— 从托盘菜单即时切换供应商无需打开完整应用云同步— 通过 Dropbox、OneDrive、iCloud 或 WebDAV 服务器在不同设备之间同步供应商数据跨平台— 基于 Tauri 2 构建的原生桌面应用支持 Windows、macOS 和 Linux小工具集合— 内置多种实用小工具解决首次安装登录确认、禁止签名、插件拓展同步等多种功能界面预览主界面概览主界面添加供应商界面功能特性完整功能列表供应商管理— 支持 8 个 AI 工具50 预设供应商复制 API Key 即可一键导入通用供应商配置— 一份配置同步到 Claude Code、Codex 和 Gemini CLI一键切换与拖拽排序— 快速切换供应商支持拖拽自定义排序代理与故障转移— 本地代理热切换、自动故障转移、熔断器、供应商健康监控应用级代理接管— 独立为每个 AI 工具配置代理精确到单个供应商核心模块MCP、Prompts 与 Skills统一 MCP 面板— 管理所有支持的 AI 工具的 MCP 服务器支持双向同步和 Deep Link 导入Prompts 管理— Markdown 编辑器跨应用同步CLAUDE.md / AGENTS.md / GEMINI.md回填保护Skills 管理— 从 GitHub 仓库或 ZIP 文件一键安装支持自定义仓库管理和软连接用量与成本追踪用量仪表盘— 跨供应商追踪支出、请求数和 Token 用量趋势图表与详细日志— 可视化数据展示详细请求日志记录自定义模型定价— 支持自定义模型价格配置会话管理器与工作区会话管理— 浏览、搜索和恢复支持的会话来源工作区编辑器— 编辑 Agent 文件AGENTS.md、SOUL.md 等支持 Markdown 预览系统与平台功能云同步— 支持 Dropbox、OneDrive、iCloud、坚果云、NAS 及 WebDAV 服务器Deep Link 支持— 通过 ccswitch:// URL 一键导入供应商、MCP 服务器、提示词和技能主题与外观— 深色/浅色/跟随系统主题切换系统集成— 开机自启、自动更新、原子写入、自动备份国际化— 支持简体中文、繁体中文、英文、日文快速开始指南基本使用添加供应商点击添加供应商 → 选择预设或创建自定义配置切换供应商主界面选择供应商 → 点击启用系统托盘直接点击供应商名称立即生效生效方式重启终端或对应的 CLI 工具以应用更改Claude Code 无需重启恢复官方登录添加官方登录预设重启 CLI 工具后按照其登录/OAuth 流程操作高级功能使用MCP 管理点击MCP按钮 → 通过模板或自定义配置添加服务器 → 切换各应用同步开关Prompts 管理点击Prompts → 使用 Markdown 编辑器创建预设 → 激活后同步到 live 文件Skills 管理点击Skills → 浏览 GitHub 仓库 → 一键安装到支持的应用会话管理点击Sessions → 浏览、搜索和恢复支持的会话来源注意首次启动可以手动导入现有 CLI 工具配置作为默认供应商。下载与安装系统要求WindowsWindows 10 及以上macOSmacOS 12 (Monterey) 及以上LinuxUbuntu 22.04 / Debian 11 / Fedora 34 等主流发行版Windows 用户从 Releases 页面下载最新版本的 CC-Switch-v{版本号}-Windows.msi 安装包或 CC-Switch-v{版本号}-Windows-Portable.zip 绿色版。macOS 用户方式一通过 Homebrew 安装推荐brew install --cask cc-switch更新brew upgrade --cask cc-switch方式二手动下载从 Releases 页面下载 CC-Switch-v{版本号}-macOS.dmg推荐或 .zip。注意CC Switch macOS 版本已通过 Apple 代码签名和公证可直接安装打开。Arch Linux 用户通过 paru 安装推荐paru -S cc-switch-binLinux 用户从 Releases 页面下载最新版本的 Linux 安装包CC-Switch-v{版本号}-Linux.debDebian/UbuntuCC-Switch-v{版本号}-Linux.rpmFedora/RHEL/openSUSECC-Switch-v{版本号}-Linux.AppImage通用Flatpak官方 Release 不包含 Flatpak 包。如需使用可从 .deb 自行构建 — 参见 flatpak/README.md。常见问题CC Switch 支持哪些 AI 工具— 支持 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes切换供应商后需要重启终端吗— 需要重启终端或对应的 CLI 工具Claude Code 除外切换供应商之后我的插件配置怎么不见了— 插件配置与供应商绑定切换供应商时会自动切换对应的插件配置macOS 安装问题— 确保系统版本符合要求如遇问题可查看官方文档为什么总有一个正在激活中的供应商无法删除— 当前激活的供应商需要先切换到其他供应商后才能删除如何切换回官方登录— 添加官方登录预设并启用然后按照官方工具的登录流程操作我的数据存储在哪里— 数据存储在应用配置目录的 SQLite 数据库中LinuxWayland NVIDIA网页内容点不动、缩放后黑屏— 这是已知的图形驱动兼容性问题建议使用 X11 会话或更新显卡驱动文档与支持如需了解各项功能的详细使用方法请查阅用户手册— 涵盖供应商管理、MCP/Prompts/Skills、代理与故障转移等全部功能。架构总览与开发指南了解项目结构、技术架构和开发指南请参考项目文档中的相关章节。
