CC-Switch 下载、安装与使用配置指南【2026.5.29】

一、CC‑Switch 简介

CC‑Switch 是开源跨平台桌面工具,一键管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenClaw 等 AI 工具的 API 配置,支持多供应商密钥快速切换、用量统计、会话管理,彻底告别手动改配置文件。


二、官方渠道



三、下载(全平台)

1. Windows
  • 安装版(MSI):下载 CC-Switch-v{版本}-Windows.msi
  • 绿色便携版:下载 CC-Switch-v{版本}-Windows-Portable.zip,解压即用
2. macOS
  • Homebrew(推荐):
bash 复制代码
brew tap farion1231/ccswitch
brew install --cask cc-switch
  • 手动 DMG:下载 CC-Switch-v{版本}-macOS.dmg,拖入应用程序
3. Linux
  • Debian/Ubuntu:.deb 包 sudo dpkg -i
  • AppImage:chmod +x 后直接运行

四、安装步骤

Windows(MSI)
  1. 双击 .msi → 同意协议 → 选路径 → 完成
  2. 便携版:解压后运行 CC-Switch.exe
macOS(DMG)
  1. 双击 DMG → 将 CC Switch.app 拖入应用程序
  2. 首次打开提示"无法验证开发者":系统设置 → 隐私与安全性 → 仍然打开
Linux(Debian)
bash 复制代码
sudo dpkg -i CC-Switch-v{版本}-Linux.deb

五、使用教程(核心流程)

1. 首次启动

打开后自动扫描已安装的 AI 工具(Claude Code、Codex 等),界面左侧为工具列表,右侧为配置区。

2. 添加 API 供应商(以小麦API为例)
  1. 点击「添加供应商」→ 填写:

    • 名称:自定义(如"小麦API")
    • API 地址:https://api.xiaomai.win/v1
    • API Key:你的密钥
    • 模型映射:按默认或自定义
  2. 保存后,在工具下拉菜单中选择该供应商即可一键切换。

3. 一键切换供应商
  1. 左侧选择目标工具(如 Claude Code)
  2. 顶部供应商下拉 → 选已添加的供应商 → 自动写入配置并生效
4. Claude Desktop 特殊配置(v3.15+)
  • 内置路由转发,解决新版第三方 API 封锁
  • 直接在 CC‑Switch 中配置模型映射,无需额外代理
5. 常用功能
  • 用量统计:查看各供应商/工具的调用次数与额度
  • 会话管理:保存/切换会话,支持恢复历史对话
  • 故障切换:主供应商失效时自动切换到备用

六、常见问题

  1. macOS 打开提示"无法验证开发者"

    系统设置 → 隐私与安全性 → 下滑点「仍然打开」

  2. Windows 杀毒误报

    加信任/白名单,官方开源无恶意代码

  3. 切换后不生效

    重启对应 AI 工具;检查 API Key 与地址是否正确


七、安全提醒

  • 仅从 GitHub Releases 下载,拒绝付费/充值/登录要求
  • 所有配置本地存储,不上传服务器
相关推荐
小毛球.17 分钟前
第 3 篇:IDEA 最新版下载与完整安装教程(Mac)
java·macos·intellij-idea·idea
ShineWinsu1 小时前
对于Qt:QFormLayout常见属性以及方法的解析
开发语言·c++·qt·面试·客户端·表单·qformlayout
Thanks_ks1 小时前
Python 的垃圾回收——引用计数撑起日常,分代回收收拾残局
python·内存管理·垃圾回收·循环引用·引用计数·gc 模块·weakref
CyrusYiVPP1 小时前
实测 uv 0.13.7:同一套包,pip 装 94 秒,它只用 19 秒
人工智能·python
Misnearch2 小时前
ScheduledExecutorService
java·线程池
yiangL_2 小时前
Python 学习笔记:递归、turtle绘图、字符串与函数
笔记·python·学习
ashiho3 小时前
【LeetCode hot 100】3. 无重复字符的最长子串 (三种解法)
java·数据结构·后端·算法·leetcode·滑动窗口
lula8883 小时前
PVC-U、PVC-C、PVC-O 差一个字母,差的是三种增强路线
python
T_Wizard3 小时前
AI 回复为什么要转圈 3 秒才「啪」一下全出来?把流式输出拆开看,顺便踩了 6 个坑
java·ai编程
CoderYanger3 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第二弹)
java·数据库·面试·职场和发展·java-ee·tomcat·mybatis