先把工具装好
下载安装 CC Switch
如果你还不知道 CC Switch 是什么，可以把它理解成“Claude Code 配置管理器”。它不是模型，也不是聊天软件；它只是帮你把 API 地址和密钥写到正确的位置。
为什么需要 CC Switch
不用手动改配置文件
Claude Code 的 API 地址、密钥、模型等配置本来可以手动写文件，但小白很容易填错位置。CC Switch 把这些配置做成界面或命令。
以后切换更方便
如果你以后有多个 API 服务或多个密钥，可以在 CC Switch 里保存多个配置，需要哪个就切哪个。
更容易排查问题
配置集中在一个地方，Base URL、Token、当前启用配置都能直接看见，出了问题更好排查。
推荐：安装桌面版
如果你是 Windows 用户，可以直接下载我们已经缓存好的最新版安装包。这个文件来自 CC Switch 官方 GitHub Release。
- 当前版本
v3.14.1- 文件名
CC-Switch-v3.14.1-Windows.msi- 大小
- 约 12 MB
- SHA256
82131ae0fb57dbea5ab8d1b67c67408e0fdf6b5b5c9136e7061aebaba7a4bc1b
Windows 用户怎么选？
不会选的话，直接点上面的“下载 Windows 安装包”。下载完成后双击 .msi 文件，一路按安装向导操作即可。
其它系统下载方式
如果你不是 Windows，打开官网后按你的电脑系统下载。
- 官网
- https://ccswitch.ai/
- 官方 Release
- GitHub Release v3.14.1
- Windows
- 优先使用本站上方的
.msi下载按钮。 - macOS
- 可以下载安装包，也可以用 Homebrew 安装。
- Linux
- 根据你的发行版选择
.deb、.rpm或.AppImage。
macOS Homebrew 安装
brew tap farion1231/ccswitch
brew install --cask cc-switch命令行版 cc-switch
如果你习惯用终端，也可以安装命令行版。它主要通过命令管理 Claude Code 配置。
npm install -g @hobeeliu/cc-switch第一次使用可以运行：
cc-switch init
桌面版和命令行版不是必须都装
新手选一个就够了。你如果不知道选哪个，就先装桌面版，界面更直观。
CC Switch 不只可以配 Claude Code
如果你的 CC Switch 版本支持 Codex 或 OpenAI 兼容服务商，也可以直接用它写入 Codex 配置。具体填写方式请看 在 Codex 客户端使用。
装完后怎么确认
- 桌面版：能打开 CC Switch 主界面。
- 命令行版：终端运行
cc-switch list不报“command not found”。 - 确认电脑上也已经安装了 Claude Code，因为 CC Switch 只是配置管理器，不替代 Claude Code。