简介¶

CC Switch 提供一个统一的图形界面，让你可以：

  • 保存多套 API 配置，点一下即可切换，无需手动编辑 JSON
  • 同时管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五款工具
  • 内置高性能 HTTP 代理，支持自动故障转移与请求监控
  • 可视化添加、编辑和同步 MCP 服务器配置
  • 实时查看 Token 消耗与 API 费用
  • 自动备份配置，防止误操作导致数据丢失

安装¶

GitHub Releases: https://github.com/farion1231/cc-switch/releases/latest 下载对应平台的安装包。

Windows 文件 说明
CC-Switch-vX.X.X-Windows.msi 推荐——MSI 安装包，支持自动更新
CC-Switch-vX.X.X-Windows-Portable.zip 便携版，解压即用，不写注册表

开始¶

首次启动时，CC Switch 会自动检测已安装的 CLI 工具并尝试导入现有配置，系统托盘中会出现 CC Switch 图标。

image.png

点击右上角的 + ，从内置预设中选择（如官方 Anthropic API、DeepSeek、阿里百炼等），或手动填写以下信息：

image.png

image.png

在列表中点击目标 Provider，再点击「启用」，CC Switch 会自动将配置写入对应 CLI 工具的配置文件:

image.png

在终端直接运行 claude 命令时，即会使用新配置。

MCP 服务器管理¶

在「MCP」面板中，可视化添加、编辑和删除 MCP（Model Context Protocol）服务器。配置自动同步到对应 CLI 工具，支持从已安装的应用一键导入现有 MCP 配置。

Skills 管理¶

CC Switch 支持：

  • 从 GitHub 仓库安装 Skills（内置 baoyu-skills 等预设仓库）
  • 从本地 ZIP 文件安装
  • 管理 Claude Code 和 Codex 的 Skills

会话管理器（Session Manager）¶

在「会话」页面，可浏览全部五个应用的历史对话记录，支持目录导航和会话内搜索，并自动按当前应用过滤显示。

备份管理¶

CC Switch 会定期自动备份数据库，在数据库迁移前也会自动备份。在「设置 → 备份管理」中可以：查看所有备份、重命名、删除，以及手动创建备份。

用量统计与计费¶

「用量」页面展示 Token 消耗统计，支持自动刷新、缓存命中率分析，以及按模型和 Provider 分类查看费用，帮助掌控 API 开支。

Claude Rectifier（思考签名修复）¶

当使用某些第三方 API 网关时，Claude 的 thinking block 格式可能不兼容。开启 Rectifier 后，代理层会自动修复此问题。可在「设置 → 高级」中开关。

WebDAV 自动同步¶

支持将数据库同步到 WebDAV 服务（如坚果云），实现多设备间的配置共享。内置大文件保护机制，防止误传。