作为开发者,在使用 Claude Code、Codex 或 Gemini CLI 等 AI 编码助手时,配置管理往往是一个痛点。不同项目可能需要使用不同的接口供应商(如 Anthropic 官方、代理中转或其他第三方),手动修改 settings.json 中的 BASE_URL 和 API_KEY 容易出错且打断工作流。
CC-Switch 概述
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,安装方式灵活。
macOS 安装(推荐 Homebrew)
brew tap farion1231/ccswitch
brew install --cask cc-switch
装完直接在'应用程序'里打开就行。
Windows 安装
去 GitHub Releases 页面 下载最新的 .msi 安装包,双击安装。如果系统弹窗提示


