【2026最新】CC Switch下载、安装和使用保姆级教程（附安装包+图文步骤）

CC Switch安装包下载：CC Switch安装包（源自GitHub，长期维护，放心使用）

CC Switch是一款桌面端的AI编程工具API配置管理软件，主要用来解决一个很现实的痛点：开发者经常需要在不同的API提供商之间切换（官方API、国内镜像、第三方代理等），每次手动修改配置文件既繁琐又容易出错。CC Switch提供了一个统一的图形界面，让你可以一键切换Provider、同时管理多款AI编程工具的配置，内置了本地API代理、MCP服务器管理、用量统计、备份恢复等功能。

CC Switch是免费软件，在GitHub上开源。它目前支持Claude Code、OpenAI Codex、Gemini CLI、OpenCode、OpenClaw五款AI编程工具，覆盖了目前主流的AI编程助手生态。如果你是重度使用AI编程工具的开发者，手上有多个API Key需要在不同场景下切换使用，CC Switch可以把这件事从"几分钟的手动配置"变成"一键切换"。

CC Switch下载

CC Switch安装包下载：CC Switch安装包（源自GitHub，长期维护，放心使用）

Windows选择.msi文件（推荐，支持自动更新）或.zip便携版，macOS选择.zip文件，Linux根据发行版选择.deb、.rpm或.AppImage格式。

CC Switch安装

1) Windows平台安装

下载.msi文件后双击启动，按照安装向导依次点击下一步：


默认安装到 C 盘，这里建议安装到其他盘，然后点击 Next：


等待安装完成即可：


如果不想写注册表，下载Portable便携版，解压后直接运行exe文件：


需要注意的是，Windows版本已禁用"一键安装"功能，如果需要安装Claude Code等工具，请手动安装后再通过CC Switch来管理。

2) macOS平台安装

下载 .dmg 文件后双击打开，将CC Switch.app拖入「应用程序」文件夹。首次启动时会提示"未知开发者"，因为作者没有Apple开发者账号，这是正常情况。关闭提示后，前往系统设置 → 隐私与安全性，点击「仍要打开」即可正常使用。

也可以使用Homebrew安装：brew tap farion1231/ccswitch + brew install --cask CC Switch。

3) Linux平台安装

Ubuntu/Debian/Mint用户下载.deb文件，执行sudo apt install ./CC Switch-*.deb。

Fedora/RHEL用户下载.rpm文件，执行sudo dnf install ./CC Switch-*.rpm。

其他发行版可以直接下载.AppImage文件，加执行权限后运行即可：

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

CC Switch基础使用

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

1）选择要管理的应用

主界面顶部是应用切换栏，点击对应的图标（Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw）即可切换当前管理的应用。如果你只用其中某几个，可以在设置里隐藏不需要的应用。

2）添加Provider

点击右上角的+号，可以从内置预设中选择（如官方Anthropic API、DeepSeek、阿里百炼等），也可以手动填写。


需要填的信息包括：名称（便于区分的备注名）、API Key、Base URL（可选，自定义代理地址）、模型（指定默认使用的模型名称）、API格式（选择Anthropic Messages原生格式或OpenAI Chat Completions兼容格式）。

3）切换Provider

添加完多个Provider后，在列表中点击目标Provider，再点击「启用」，CC Switch会自动将配置写入对应CLI工具的配置文件。之后在终端直接运行claude命令时，就会使用新配置了。

4）健康检查

添加完Provider后，可以点击旁边的「健康检查」按钮，发送一个测试请求来验证API Key和网络连通性。这个功能很实用，能帮你快速排除是API Key的问题还是网络的问题。

CC Switch常见使用问题

有些小伙伴第一次使用CC Switch时，发现系统托盘里没有图标，这可能是因为Windows版本默认启动了但在任务栏隐藏了，可以到系统托盘区域点开小箭头查看。如果还是没有，尝试重新启动软件。

macOS用户首次启动时如果遇到"无法验证开发者"的提示，不用慌，这是在macOS较新版本上的正常安全提示，按前面的安装说明操作即可。

另外，切换Provider后如果发现对应的CLI工具没有生效，可以先检查一下是否在CC Switch里正确选中了该应用（顶部应用切换栏），因为每个应用的配置是独立管理的，在Claude Code下启用的Provider不会自动应用到Codex。

还有一个常见情况是添加的自定义Base URL不能正常调用，可以先试试内置预设中的官方地址，如果能通说明网络没问题，问题可能出在自定义代理地址的配置上。

总结

CC Switch定位很明确，解决AI编程工具API配置管理的痛点。如果你手上有多个AI编程工具（Claude Code、Codex、Gemini CLI等）和多套API配置需要管理，它可以把反复修改配置文件的麻烦事变成一键切换。

除了最核心的Provider管理功能，它还整合了MCP服务器可视化管理、用量统计、会话管理、WebDAV同步、自动备份等进阶功能，整个工具链挺完整的。如果你平时经常调试AI API、手里有几套不同的API配置、或者在多个编程工具之间切换使用，CC Switch值得装一个试试。