
一、下载v3.16.12026-06-01国内高速备用夸克网盘https://pan.quark.cn/s/d6152047213b含全平台v3.16.1包WindowsWin10 x64安装版自动更新CC-Switch-v3.16.1-Windows.msi便携版免安装CC-Switch-v3.16.1-Windows-Portable.zipmacOS12Intel/Apple Silicon镜像CC-Switch-v3.16.1-macOS_Universal.dmgLinuxUbuntu22.04/Debian11/Fedora34Debian/Ubuntucc-switch_3.16.1_amd64.debFedora/RHELCC-Switch-v3.16.1-Linux-x86_64.rpmAppImageCC-Switch-v3.16.1-Linux-x86_64.AppImage二、安装步骤Windows安装版MSI推荐双击.msi→ 同意协议 → 自定义安装路径建议非C盘完成后从开始菜单启动便携版ZIP解压到固定目录直接运行CC-Switch.exe无需安装。macOSHomebrew推荐brew tap farion1231/ccswitch brewinstall--caskcc-switch手动DMG双击.dmg→ 将CC Switch.app拖入「应用程序」首次启动提示“未知开发者”时前往系统设置→隐私与安全性→仍要打开。LinuxDebian/Ubuntusudodpkg-icc-switch_3.16.1_amd64.debsudoapt-finstall-y# 依赖修复如需要Fedora/RHELsudorpm-iCC-Switch-v3.16.1-Linux-x86_64.rpmAppImage通用chmodx CC-Switch-v3.16.1-Linux-x86_64.AppImage ./CC-Switch-v3.16.1-Linux-x86_64.AppImage三、首次配置核心1. 安装AI CLI工具必备CC-Switch仅管理配置需手动安装目标工具Claude Codenpminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.comCodexnpminstall-gopenai/codex--registryhttps://registry.npmmirror.comGemini CLInpminstall-ggoogle/gemini-cli--registryhttps://registry.npmmirror.com2. 添加API供应商以Claude Code为例启动CC-Switch → 右上角**** → 选择供应商如Anthropic、DeepSeek、GLM、Kimi等50预设。填写Provider Name自定义别名如“Anthropic-官方”Base URLAPI地址如Anthropichttps://api.anthropic.comAPI Key你的密钥点击Add保存自动同步到Claude Code配置文件。3. 一键切换与验证顶部工具栏选择目标工具Claude Code/Codex等下拉选择已配置供应商 → 一键切换终端执行claude code确认生效。四、常见问题Windows SmartScreen阻止点更多信息→仍要运行。macOS“无法验证开发者”系统设置→隐私与安全性→仍要打开。配置不生效重启CC-Switch或手动删除~/.claude-code后重新添加供应商。五、核心功能多供应商密钥一键切换支持50模型系统托盘快速访问、配置导入导出、MCP统一管理跨平台配置同步、用量统计、会话历史管理。