夜雨聆风一句话理解CC Switch
CC Switch = AI编程CLI的"配置切换器 + MCP管理器 + Skills管理器 + Prompt管理器"。
以前你用这些工具时，可能要手动改：
ANTHROPIC_API_KEY= OPENAI_API_KEY= BASE_URL= MODEL= settings.json .env AGENTS.md CLAUDE.md MCP配置
CC Switch把这些分散的配置集中到一个界面，点一下就能切换供应商、模型、API地址、MCP、技能和系统提示词。
官方GitHub明确定位："All-in-One Manager for Claude Code, Codex, Gemini CLI, OpenCode & OpenClaw"。
它主要解决什么痛点
痛点1：多个AI CLI配置太乱
现在很多人同时用这些工具：
| 工具 | 常见用途 |
| Codex CLI | OpenAI系列代码助手 |
| Gemini CLI | Google Gemini命令行工具 |
| OpenCode | 开源AI Coding Agent |
| OpenClaw | 类Claude Code/ OpenAI Codex的国产化或自建工作流工具 |
这些工具的配置格式不同：有的用JSON，有的用TOML，有的用.env，有的用CLAUDE.md或AGENTS.md。切换API Provider时经常要手动改大量文件。
CC Switch的README直接指出：现代AI Coding CLI各有配置格式，切换API Provider时经常要手动改JSON、TOML或.env文件。
痛点2：API中转站太多，手动切换麻烦
你可能有很多Provider：
官方Anthropic OpenAI官方 New API OpenRouter 硅基流动 DeepSeek Moonshot/Kimi 阿里百炼 智谱GLM 各种Claude Code中转站
手动切换很容易出错：Base URL写错、API Key混了、模型名不匹配、环境变量覆盖配置。
CC Switch的核心价值：把这些Provider保存成配置档案，需要时一键切换。它支持50+ provider presets，并支持一键导入和切换。
核心功能拆解
1. Provider管理：切换API、模型和Key
这是CC Switch最核心的功能。
你可以把不同API源保存成不同Provider，例如：
Claude官方 Claude中转站A Claude中转站B OpenAI官方 New API自建聚合 Gemini官方 OpenRouter DeepSeek Kimi GLM
每个Provider通常包含：
名称 Base URL API Key 模型名 是否启用 适配的CLI工具
然后在UI里点一下切换，或者用CLI：
cc-switch provider list cc-switch provider switch <id>
CLI版本文档里列出了这些命令，包括provider list、provider switch、provider export、provider stream-check等。
2. 支持多个AI编程工具
目前主项目支持：
Claude Code Codex Gemini CLI OpenCode OpenClaw
GitHub README和CLI版本文档都明确列出支持这五类工具。
也就是说，它不是只服务Claude Code，而是想做成一个AI Coding Agent控制台。
你可以理解成：
VS Code是代码编辑器 Claude Code / Codex / Gemini CLI是AI编程执行器 CC Switch是这些执行器的配置中控台
3. MCP Server管理
MCP是Model Context Protocol，简单说就是让AI工具连接外部能力，比如：
文件系统 浏览器 数据库 GitHub 飞书/Notion 本地脚本 搜索工具 自动化工具
以前你可能要分别给Claude Code、Codex、Gemini CLI配MCP。CC Switch提供统一MCP管理，可以添加、编辑、启用、禁用、同步MCP Server。
CLI版本里有这些命令：
cc-switch mcp list cc-switch mcp add cc-switch mcp edit <id> cc-switch mcp delete <id> cc-switch mcp enable <id> --app claude cc-switch mcp disable <id> --app claude cc-switch mcp sync cc-switch mcp import --app claude
4. Skills管理
Skills可以理解成：某个AI工具可调用的能力包。例如：
PDF处理技能 PPT生成技能 代码审查技能 ROS控制技能 营销数据分析技能 搜索技能 任务跟踪技能
CLI文档里列出了：
cc-switch skills list cc-switch skills discover <query> cc-switch skills install <name> cc-switch skills uninstall <name> cc-switch skills enable <name> cc-switch skills disable <name> cc-switch skills info <name>
文档说明它用于管理和扩展Claude Code、Codex、Gemini、OpenCode的能力。
不同AI Coding工具有不同的"项目指令文件"：
| 工具 | 常见指令文件 |
| Codex | AGENTS.md |
| Gemini CLI | GEMINI.md |
| OpenCode | AGENTS.md |
| OpenClaw | AGENTS.md |
CC Switch可以统一管理这些Prompt preset。CLI文档里说明它支持Claude的CLAUDE.md、Codex的AGENTS.md、Gemini的GEMINI.md、OpenCode/OpenClaw的AGENTS.md。
这个功能非常适合做多套工作模式：
代码审查模式 论文润色模式 公众号写作模式 机器人控制模式 AfSim仿真代码模式 Godot开发模式 Blender资产处理模式
你不用每次重写提示词，直接切换Prompt preset。
CC Switch的几个版本
1. 桌面版CC Switch
主项目是farion1231/cc-switch，使用Tauri构建，支持Windows、macOS、Linux。README里明确写了它是跨平台桌面All-in-One管理器，并且支持系统托盘快速切换、云同步、SQLite数据库等功能。
2. CLI版 cc-switch-cli
SaladDay/cc-switch-cli是命令行版本，适合服务器、自动化脚本、无图形界面环境。
例如在云服务器上部署OpenClaw，可以用CLI：
cc-switch --app openclaw provider list cc-switch --app openclaw provider switch <id> cc-switch mcp sync
它支持Claude、Codex、Gemini、OpenCode、OpenClaw，并提供provider、mcp、prompts、skills等命令。
3. Web版 cc-switch-web
cc-switch-web是一个Web化分支，主要用于云服务器、无头环境、SSH环境。它的README写明支持Web Server mode，可在cloud/headless环境里使用，并支持Basic Auth。
它和Claude Code是什么关系
很多人会误解：CC Switch不是Claude Code。
关系应该这样看：
Claude Code = AI编程执行工具 CC Switch = Claude Code等工具的配置管理器
Claude Code负责：
读代码 改代码 运行命令 执行任务 理解项目 提交git
CC Switch负责：
切换Claude Code用哪个API 切换模型 切换Base URL 管理API Key 管理MCP 管理Skills 管理Prompt 同步配置
也就是说，CC Switch不直接替你写代码，它是帮你把Claude Code/Codex/Gemini CLI这些工具管好。
一个典型使用场景
比如你本地有Claude Code，同时有这三个接口：
1. Anthropic官方API 2. New API自建中转 3. 某个Claude Code中转站
以前你要改：
export ANTHROPIC_BASE_URL=... export ANTHROPIC_API_KEY=... export ANTHROPIC_MODEL=...
或者改配置文件。
用了CC Switch后，建三个Provider：
Claude官方 Claude-NewAPI Claude-中转A
然后一键切换。当Claude官方额度不够时，切到中转站；当中转站不稳定时，切回官方；当你想测试速度时，用内置测速或stream health check。
优点
1. 大幅减少手动配置错误
不用频繁改.env、JSON、TOML、settings文件。
2. 适合多Provider用户
如果你只用一个官方Claude Code，其实没必要。但如果你有官方接口、中转接口、自建New API、OpenRouter、国产模型，那它很有用。
3. 适合AI Coding重度用户
特别是经常折腾这些的人：
Claude Code Codex OpenClaw Gemini CLI MCP Skills Agent工作流
CC Switch可以减少很多重复配置。
4. 有桌面版、CLI版、Web版
本地电脑、服务器、云环境都能覆盖。
缺点和风险
1. 第三方工具，需要注意安全
它会管理API Key，所以一定要从官方GitHub Release下载，不要随便下载别人打包的版本。
最近AI Coding工具生态里确实出现过恶意仓库伪装工具的情况。TechRadar报道过攻击者利用Claude Code热度发布带有信息窃取木马的恶意GitHub仓库。
所以要特别注意：
只从官方仓库下载 不要运行来历不明的exe 不要用别人发你的破解版 不要把高额度API Key随便导入
2. 环境变量可能覆盖它的配置
CLI文档提到，如果系统环境变量里已经有ANTHROPIC_API_KEY、OPENAI_API_KEY等，它们可能覆盖CC Switch写入的配置。
常见问题就是：CC Switch已经切换了，但Claude Code还是用旧Key。这时候多半是系统环境变量优先级更高。
3. 切换后有些工具需要重启终端
主项目FAQ说，大多数工具切换Provider后需要重启终端或CLI工具才能生效；Claude Code目前支持Provider数据热切换。所以切换后没生效，先重启终端。
推荐理解顺序
可以按这个顺序理解：
第一层：Provider
先理解API Key、Base URL、Model怎么切换。
第二层：App
理解Claude Code、Codex、Gemini CLI、OpenClaw各自配置文件在哪里。
第三层：Prompt
理解CLAUDE.md、AGENTS.md、GEMINI.md的作用。
第四层：MCP
理解AI怎么调用外部工具。
第五层：Skills
理解能力包怎么安装、启用、同步。
第六层：云端部署
再看cc-switch-web / CLI自动化。
最简单的总结
CC Switch适合"同时使用多个AI编程工具 + 多个API供应商 + MCP + Skills"的人。
它的本质不是写代码，而是做配置中控：
管理模型 管理接口 管理Key 管理MCP 管理Skills 管理Prompt 管理多工具同步
对于普通用户，它可能有点复杂。但对于同时用OpenClaw、小龙虾、Claude Code、Codex这一套的人，它就是一个很实用的"AI Coding控制面板"。
欢迎在评论区聊聊你的想法~
如果这篇文章让你有收获，别忘了点赞、分享、推荐～
也欢迎关注我的公众号，每天有AI最新资讯分享~
2群已满，3群已开，也欢迎加我微信进群
