CC-Switch教程：统一管理Skills、MCP、模型供应商、系统提示词等多项配置

本文整理自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 npminstall node cc-switch.js --version初始化完成后CC-Switch会在~/.claude/cc-switch/目录下生成配置结构~/.claude/cc-switch/profiles/ # 配置档案default.jsontemplates/ # 系统提示词模板snapshots/ # 配置快照用于回滚Skills统一管理Skills是Claude Code里最容易积累混乱的部分装多了不知道哪些在用哪些已经过期。查看当前已安装的Skillsnode cc-switch.js skills listCC-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.jsmodel use claude-haiku-4-5系统提示词统一管理CC-Switch的模板继承机制解决了CLAUDE.md各项目各自为政的问题。在templates/base.md里维护基础规范各项目的CLAUDE.md只写差异部分extends base项目特定规范使用PostgreSQL不用ORMAPI接口统一返回 {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 profileuse personal-research回滚到快照node cc-switch.js snapshot restore “before-client-project”实际使用场景场景一白天工作项目晚上个人项目配置完全不同建两个档案早上切work晚上切personalSkills、MCP、系统提示词一次性全部切换。场景二给团队统一分发配置把档案文件提交到团队仓库每人执行import命令配置立刻同步不需要人工对齐。场景三测试新MCP服务器用–temp临时添加测完觉得好用再写入档案Claude Code重启就清掉不影响正式配置。FAQQCC-Switch会直接修改我的settings.json吗A会但每次操作前会自动备份到snapshots目录可以随时回滚。建议第一次使用前手动备份一次settings.json。Q档案里没有声明的配置项切换后会被清掉吗A不会CC-Switch只管理档案里声明的部分其他配置保持原样。Q多人协作项目每个人本地配置不同怎么处理A把团队基础档案放进仓库不含API Key个人差异用profile.local.json覆盖local文件加入.gitignore。Q支持Windows吗ANode.js跨平台主要功能在Windows下可用部分shell命令集成建议用WSL2。Q跟直接编辑settings.json比CC-Switch的优势在哪A在于「档案」概念一个档案对应一套完整的工作上下文切换场景时一条命令搞定不用逐个文件改也不用担心漏改了哪个地方。以上内容由 Ai好记 转录整理。Ai好记 是一款音视频转图文笔记的 AI学习助手支持B站、抖音、小宇宙等平台链接及本地音视频文件转入后自动生成精华速览、思维导图和结构化笔记帮助你把几小时的视频内容变成可搜索、可复习的图文笔记。