CC-Switch:AI 编码助手配置管理工具
作为开发者,在使用 Claude Code、Codex 或 Gemini CLI 等 AI 编码助手时,配置管理往往是一个痛点。不同项目可能需要使用不同的 API 接口、代理中转或供应商,手动修改 settings.json 中的 BASE_URL 和 API_KEY 不仅繁琐,还容易因格式错误导致 CLI 崩溃。
CC-Switch 是一款开源的、跨平台的桌面小工具,专门用来管理各种 AI 编码助手的配置。它最初是为 Claude Code 量身定做的,后来进化为支持多款 AI 工具的'配置大管家'。

你可以把它理解为:CC-Switch = 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,安装方式灵活。
1. macOS 安装(推荐 Homebrew)
brew tap farion1231/ccswitch
brew install --cask cc-switch
装完直接在'应用程序'里打开即可。
2. Windows 安装
前往 GitHub Releases 页面 下载最新的 .msi 安装包,双击安装。如果系统弹窗提示'SmartScreen',选择'更多信息' → '仍要运行'即可。

3. Linux 安装
下载 .deb 包安装:
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
dpkg -i cc-switch_x.x.x_amd64.deb




