本文整理自B站教程视频《CC-Switch完整使用指南》，通过Ai好记视频转图文整理，以下为精炼整理后的内容。
用过Claude Code一段时间之后，大多数人都会遇到同一个问题：配置文件散落在好几个地方。
Skills装了十几个，MCP服务器配了一堆，系统提示词按项目不同各有一套，模型供应商有时候还要切换。想改一个配置，得翻三四个文件，改完了还担心哪里漏掉了。
CC-Switch就是为了解决这个问题而设计的，把Skills、MCP、模型供应商、系统提示词这些分散的配置，收拢到一套统一的管理方式下，切换、更新、回滚都在一个地方完成。
CC-Switch是什么，核心概念先理清
CC-Switch本质上是一个Claude Code的配置管理层，不替代原有的配置文件，而是在上面加了一层统一的管理入口。
Claude Code本身的配置分散在几个位置：
- ~/.claude/settings.json，全局配置，包含默认模型、权限、工具白名单等
- ~/.claude/CLAUDE.md，全局系统提示词和行为规则
- 项目根目录的.claude/settings.json，项目级配置
- 项目根目录的CLAUDE.md，项目级系统提示词
- MCP服务器配置，散落在settings.json的mcpServers字段里
- Skills，安装在~/.claude/skills/目录下
CC-Switch做的事情是把上面这些东西的管理逻辑统一化，让你不需要逐个文件去改，通过配置模板和切换命令一次性管理。
安装与初始化
前置条件：Claude Code已安装，Node.js环境可用。
git clone https://github.com/\[repo\]/cc-switch
~/.claude/tools/cc-switch cd ~/.claude/tools/cc-switch && npm
install node cc-switch.js --version
初始化完成后，CC-Switch会在~/.claude/cc-switch/目录下生成配置结构：
~/.claude/cc-switch/
profiles/ # 配置档案
default.json
templates/ # 系统提示词模板
snapshots/ # 配置快照（用于回滚）
Skills统一管理
Skills是Claude Code里最容易积累混乱的部分，装多了不知道哪些在用，哪些已经过期。
查看当前已安装的Skills：
node cc-switch.js skills list
CC-Switch支持在档案（profile）里声明这个档案需要哪些Skills，切换档案时自动激活对应的Skills组合：
{
"skills": {
"enabled": "code-review", "tdd", "deep-research",
"disabled": "legacy-deploy", "old-db-helper"
} }
切换档案时，CC-Switch读取这个声明，自动调整Skills状态，不用一个一个手动改。
超过30天未被任何档案声明的Skills，可以用cc-switch.js skills prune清理。
MCP服务器配置与管理
MCP服务器的配置默认写在settings.json的mcpServers字段里，项目多了之后来回改很容易出错。CC-Switch的方式是每个档案声明自己需要的MCP服务器列表，切换时自动更新：
{
"mcpServers": {
"active": "filesystem", "github", "postgres",
"inactive": "redis", "elasticsearch"
} }
临时添加一个MCP服务器测试，不污染正式配置：
node cc-switch.js mcp add --name "my-server" --command "npx" --args
"-y @myorg/mcp-server" --temp
--temp标志表示只在当前会话生效，Claude Code重启后自动移除，适合测试新的MCP服务器。
模型供应商切换
在档案里声明模型配置，切换档案时CC-Switch自动更新对应的环境变量指向：
{
"model": {
"provider": "anthropic",
"model": "claude-opus-4-5",
"apiKeyEnv": "ANTHROPIC_API_KEY"
} }
切换到使用OpenAI兼容接口的本地模型：
{
"model": {
"provider": "openai-compatible",
"baseUrl": "http://localhost:11434/v1",
"model": "qwen2.5-coder:32b",
"apiKeyEnv": "LOCAL_API_KEY"
} }
不切换整个档案只换模型：
node cc-switch.js model use claude-sonnet-4-6 node cc-switch.js
model use claude-haiku-4-5
系统提示词统一管理
CC-Switch的模板继承机制解决了CLAUDE.md各项目各自为政的问题。
在templates/base.md里维护基础规范，各项目的CLAUDE.md只写差异部分：
@extends base
项目特定规范
- 使用PostgreSQL，不用ORM
- API接口统一返回 {code, data, message} 结构
构建时CC-Switch合并模板和项目配置，生成最终的CLAUDE.md，通用规范不需要在每个项目里重复写。
更新基础模板后同步到所有项目：
node cc-switch.js prompt sync --all
档案切换与快照
保存当前配置为快照
node cc-switch.js snapshot save "before-client-project"
切换档案
node cc-switch.js profile use work-backend node cc-switch.js profile
use personal-research
回滚到快照
node cc-switch.js snapshot restore "before-client-project"
实际使用场景
场景一，白天工作项目晚上个人项目配置完全不同，建两个档案，早上切work晚上切personal，Skills、MCP、系统提示词一次性全部切换。
场景二，给团队统一分发配置，把档案文件提交到团队仓库，每人执行import命令，配置立刻同步，不需要人工对齐。
场景三，测试新MCP服务器，用--temp临时添加，测完觉得好用再写入档案，Claude Code重启就清掉，不影响正式配置。
FAQ
Q：CC-Switch会直接修改我的settings.json吗？
A：会，但每次操作前会自动备份到snapshots目录，可以随时回滚。建议第一次使用前手动备份一次settings.json。
Q：档案里没有声明的配置项，切换后会被清掉吗？
A：不会，CC-Switch只管理档案里声明的部分，其他配置保持原样。
Q：多人协作项目，每个人本地配置不同怎么处理？
A：把团队基础档案放进仓库（不含API Key），个人差异用profile.local.json覆盖，local文件加入.gitignore。
Q：支持Windows吗？
A：Node.js跨平台，主要功能在Windows下可用，部分shell命令集成建议用WSL2。
Q：跟直接编辑settings.json比，CC-Switch的优势在哪？
A：在于「档案」概念，一个档案对应一套完整的工作上下文，切换场景时一条命令搞定，不用逐个文件改，也不用担心漏改了哪个地方。
以上内容由 Ai好记 转录整理。
Ai好记 是一款音视频转图文笔记的 AI学习助手，支持B站、抖音、小宇宙等平台链接及本地音视频文件，转入后自动生成精华速览、思维导图和结构化笔记，帮助你把几小时的视频内容变成可搜索、可复习的图文笔记。