作为一名开发者,在使用 Claude Code、Codex 或 Gemini CLI 等 AI 编码助手时,配置管理往往成为痛点。
想象一下这个场景:你在 A 项目用 Anthropic 官方接口,B 项目用代理中转,C 项目想试试某家供应商……于是你开始手动修改 settings.json,调整 BASE_URL,粘贴新的 API_KEY,操作繁琐且容易出错。
今天介绍 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 安装包,双击安装。
如果系统弹窗提示


