作为日常使用 AI 编码助手的开发者,你一定接触过 Claude Code、Codex 或 Gemini CLI 等工具。它们能显著提升效率,但配置管理往往是个痛点。
想象一下这样的场景:A 项目用 Anthropic 官方接口,B 项目走代理中转,C 项目尝试新供应商……于是你开始重复操作:打开 settings.json,修改 BASE_URL,粘贴新的 API_KEY,稍有不慎一个多余的空格就会导致 CLI 报错。
这种重复且易错的操作确实繁琐。今天分享一个能优化这一流程的工具——CC-Switch。它类似 AI 工具的'万能遥控器',支持一键切换配置。
CC-Switch 是什么?
CC-Switch 是一款开源的跨平台桌面小工具,专为管理各类 AI 编码助手的配置而设计。最初针对 Claude Code 开发,现已扩展为支持多款 AI 工具的'配置中心'。

你可以将其理解为:AI 配置中心 + 一键切换神器 + MCP/Skills 管理工具箱。
核心特性:
- 多配置存储:支持保存多组 API URL 和 Token,随时调用。
- 一键秒切:点击即可切换配置,无需关闭终端或重启服务。
- 安全保护:Token 自动脱敏显示,配置文件权限锁定为 600。
- 自动备份:切换前自动备份旧配置,误操作可快速还原。
为什么需要它?
回顾没有 CC-Switch 时的传统流程:
- 打开终端。
- 输入
vim ~/.claude/settings.json。 - 定位
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL。 - 手动复制粘贴新 Token 和 URL。
- 保存退出并重启 Claude Code。
这套流程耗时且容易打断开发思路。若每日多次切换,效率损耗明显。此外,手动编辑配置文件存在格式错误导致崩溃的风险,甚至可能因截图泄露 Token。
CC-Switch 将上述步骤简化为:点击图标 → 选择配置 → 完成。
安装指南
CC-Switch 支持 Windows、macOS 和 Linux,安装方式灵活。
macOS 安装(推荐 Homebrew)
brew tap farion1231/ccswitch
brew install --cask cc-switch
安装完成后在'应用程序'中启动即可。
Windows 安装
前往 GitHub Releases 页面 下载最新的 .msi 安装包并双击运行。如遇 SmartScreen 提示,选择'更多信息'→'仍要运行'即可。





