作为一名开发者,在使用 Claude Code、Codex 或 Gemini CLI 等 AI 编码助手时,配置管理往往是最容易让人分心的环节。
在实际开发中,常见场景是:A 项目使用 Anthropic 官方接口,B 项目走代理中转,C 项目尝试第三方供应商。此时需要手动修改 settings.json,调整 BASE_URL 和 API_KEY。这种重复且易错的操作不仅打断思路,还增加了 Token 泄露的风险。
本文将介绍一款名为 CC-Switch 的跨平台桌面工具,它专为管理 AI 编码助手的配置而设计,支持多供应商一键切换,显著降低配置错误率并提升效率。
一、CC-Switch 简介
CC-Switch 是一个开源的桌面应用,最初针对 Claude Code 优化,现已扩展为支持多款 AI 工具的通用配置管理器。

其核心定位可概括为: AI 配置中心 + 一键切换工具 + MCP/Skills 管理工具箱
主要特性包括:
- 多配置存储:支持保存多组 API URL 和 Token,按需调用。
- 快速切换:图形化操作,无需重启终端或进程。
- 安全机制:Token 自动脱敏显示,配置文件权限锁定为 600。
- 自动备份:切换前自动备份旧配置,支持一键还原。
二、为什么选择它?
在没有此类工具时,切换配置通常涉及以下步骤:
- 打开终端。
- 编辑配置文件(如
vim ~/.claude/settings.json)。 - 查找并替换
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL。 - 保存退出,重启服务。
这一流程耗时且容易因格式错误导致服务崩溃。CC-Switch 将上述步骤简化为一次点击,同时避免了手动复制粘贴带来的安全隐患。
三、安装指南
CC-Switch 支持 Windows、macOS 和 Linux 系统。
1. macOS 安装
推荐使用 Homebrew 进行安装:
brew tap farion1231/ccswitch
brew install --cask cc-switch
安装完成后在'应用程序'中启动即可。
2. Windows 安装
前往 GitHub Releases 页面下载最新的 .msi 安装包并双击运行。若遇到 SmartScreen 提示,选择'更多信息' → '仍要运行'即可。
3. Linux 安装
下载 .deb 包并通过 dpkg 安装:
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
sudo dpkg -i cc-switch_x.x.x_amd64.deb
也支持 .AppImage 格式,下载后直接执行。
4. 验证安装
启动 CC-Switch,确认系统托盘(Windows/Linux)或菜单栏(macOS)出现图标,主界面能正常加载即表示安装成功。




