✅ 一、下载v3.16.12026-06-01 官方版国内备用高速 https://pan.quark.cn/s/d6152047213b各平台安装包Assets 里找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.dmgHomebrew推荐brew tap farion1231/ccswitch brewinstall--caskcc-switchLinuxUbuntu22.04/Debian11/Fedora34Debian/Ubuntucc-switch_3.16.1_amd64.debFedora/RHELCC-Switch-v3.16.1-Linux.x86_64.rpmAppImage通用CC-Switch-v3.16.1-Linux.AppImage✅ 二、安装步骤WindowsMSI 安装版双击.msi→ 同意协议 → 建议改路径到非中文目录如 D:\CCSwitch。下一步 → 勾选桌面快捷方式 → 安装 → 完成后启动。Windows便携版解压Portable.zip到全英文无空格路径双击CC-Switch.exe直接运行配置保存在文件夹data目录。macOSDMG双击.dmg→ 将CC Switch.app拖入「应用程序」。首次启动提示“未知开发者”系统设置 → 隐私与安全性 → 点击「仍要打开」。LinuxDebian/Ubuntusudodpkg-icc-switch_3.16.1_amd64.debsudoapt-finstall-y# 依赖缺失时修复AppImagechmodx CC-Switch-v3.16.1-Linux.AppImage ./CC-Switch-v3.16.1-Linux.AppImage✅ 三、首次启动基础配置必做启动后自动扫描已安装的 AI CLIClaude Code、Codex、Gemini CLI 等。左上角设置 → 通用勾选跳过 Claude Code 初次登录校验、自动接管本地 Claude 配置文件~/.claude.json。端口默认 18789保存。✅ 四、添加 API 供应商核心右上角**Add Provider新增服务商**。选预设如 Anthropic、DeepSeek、Kimi、智谱 GLM或自定义Custom。示例1官方 Anthropic名称自定义如 Claude 官方BaseURLhttps://api.anthropic.comAPI Key官网获取的sk-密钥模型claude-sonnet-4/haiku等。示例2自定义第三方中转如 ZenMux名称ZenMux自定义BaseURL中转地址如https://zenmux.ai/api/anthropicAPI Key服务商sk-密钥API 格式选 Anthropic 或 OpenAI 兼容。保存后在列表选中 → 点击启用自动写入对应 CLI 配置文件。健康检查点击「健康检查」验证 Key 与连通性。✅ 五、切换与使用顶部切换栏选目标 CLI如 Claude Code。供应商列表点选 → 启用 → 终端直接运行claude/codex等命令即可生效。常用 CLI 配置文件路径Claude Code~/.claude/settings.jsonCodex~/.codex/auth.jsonGemini CLI~/.gemini/config.json。✅ 六、常见问题Windows 安全提示允许运行添加信任。macOS 无法验证隐私与安全性 → 仍要打开。Linux 托盘不显示GNOME安装gnome-shell-extension-appindicator并重启。报错“配置文件无权限”右键文件夹 → 属性 → 完全控制。