---

🌌你好！这里是 晓雨的笔记本 在所有感兴趣的领域扩展知识，感谢你的陪伴与支持~ 👋 欢迎添加文末好友，不定期掉落福利资讯

---

写在最前面

版权声明：本文为原创，遵循 CC 4.0 BY-SA 协议。转载请注明出处。

适合人群：

• 已经知道 CC-Switch 是什么
• 已经会基本安装和切换 Provider
• 想系统理解 CC-Switch 能做什么
• 想把 Claude Code、Codex、Gemini CLI 等工具统一管理起来

这篇不是入门安装教程，而是“进阶功能说明 + 实战用法”。

---

一、CC-Switch 的定位

CC-Switch 不是单纯的“Claude 切换器”。

更准确地说，它是：

AI 编程 CLI 工具的统一配置管理中心。

它主要解决的问题是：

• 不同 AI CLI 工具配置格式不同
• Claude Code、Codex、Gemini CLI、OpenCode 各有各的配置文件
• 每个工具都要单独配置 API Key
• MCP、Skills、Prompt 分散在不同目录
• 切换 Provider 很麻烦
• 多模型、多中转、多 API 管理困难

CC-Switch 的作用就是：

把这些复杂配置集中到一个图形化界面里统一管理。

---

二、CC-Switch 支持哪些 AI 编程工具？

目前 CC-Switch 主要支持以下 AI CLI / Agent 工具：

工具	说明
Claude Code	Anthropic 的 AI 编程 CLI
Codex CLI	OpenAI 的 AI 编程 CLI
Gemini CLI	Google Gemini 命令行工具
OpenCode	开源 AI 编程 Agent 工具
OpenClaw	AI 编程 Agent 工具
Hermes Agent	Agent 类 AI 编程工具

也就是说，CC-Switch 的核心优势不是只支持某一个工具，而是：

一个软件同时管理多个 AI 编程 CLI。

---

三、核心功能总览

CC-Switch 进阶功能可以分为 10 大类：

1. Provider 管理
2. 模型切换
3. 多端点配置
4. API Key 管理
5. MCP 管理
6. Skills 管理
7. Prompts 管理
8. 本地代理与路由
9. 健康检查与测速
10. 配置同步与导入导出

下面逐个讲。

---

四、Provider 管理

Provider 是 CC-Switch 最核心的功能。

4.1 Provider 是什么？

Provider 可以理解为：

一个 AI 服务配置。

它通常包括：

• API 地址
• API Key
• 模型名称
• 请求格式
• 代理设置
• 模型分层配置
• 是否启用

举例：

Provider	说明
Anthropic 官方	Claude 官方接口
OpenAI 官方	GPT / Codex 官方接口
DeepSeek 官方	DeepSeek 模型接口
Gemini 官方	Google Gemini 接口
第三方中转	国内或海外 API 转发服务
本地模型服务	Ollama / Local API

---

4.2 Provider 管理能做什么？

CC-Switch 支持：

• 添加 Provider
• 编辑 Provider
• 删除 Provider
• 复制 Provider
• 启用 Provider
• 导入 Provider
• 导出 Provider
• 测试 Provider
• 查看当前启用 Provider

这意味着你可以同时保存很多套配置。

比如：

名称	用途
Claude 官方	高质量规划
Codex 官方	日常写代码
DeepSeek 中转	低成本批量开发
Gemini 长上下文	长文档分析
本地模型	离线测试

需要哪个就切哪个。

---

五、一键切换模型

这是 CC-Switch 最常用的功能。

以前你可能需要手动改：

• JSON
• TOML
• env
• settings
• config
• AGENTS.md
• CLAUDE.md

现在只需要：

1. 打开 CC-Switch
2. 选择目标 Provider
3. 点击 Switch / 启用
4. 重新打开 CLI 工具

就可以完成切换。

---

六、多工具统一切换

这是进阶用户最需要的功能。

你可以为不同工具分别设置 Provider。

例如：

工具	当前 Provider
Claude Code	Claude Sonnet
Codex	OpenAI Codex
Gemini CLI	Gemini 2.5 Pro
OpenCode	DeepSeek

这样你可以同时使用多个 AI 编程工具，而不是反复改配置。

---

七、Codex 支持

这是现在非常重要的功能。

因为很多用户发现：

Claude 成本高，而 Codex 在很多开发任务中性价比更高。

CC-Switch 支持 Codex 的意义在于：

• Codex 配置不用手改
• Codex Provider 可以图形化管理
• Codex API Key 可以统一保存
• Codex 的 AGENTS.md 可以统一管理
• Codex 的 MCP 可以统一同步
• Codex 的 Skills 可以统一管理

对 Codex 用户来说，CC-Switch 可以极大减少配置复杂度。

---

八、MCP 管理

MCP 是 CC-Switch 的一个进阶重点。

8.1 MCP 是什么？

MCP 全称：Model Context Protocol。

可以理解为：

让 AI 工具连接外部能力的插件协议。

例如：

• 文件系统 MCP
• 浏览器 MCP
• GitHub MCP
• 数据库 MCP
• Playwright MCP
• Chrome DevTools MCP
• 搜索 MCP

有了 MCP，AI 不只是聊天，而是可以调用工具。

---

8.2 CC-Switch 的 MCP 管理能做什么？

CC-Switch 支持统一管理 MCP 服务器。

功能包括：

• 添加 MCP
• 编辑 MCP
• 删除 MCP
• 启用 MCP
• 禁用 MCP
• 导入已有 MCP 配置
• 同步 MCP 到不同工具
• 校验 MCP 命令是否可用
• 支持多个 AI CLI 共用 MCP 配置

---

8.3 MCP 支持的传输方式

常见包括：

类型	说明
stdio	本地命令方式，最常见
HTTP	通过 HTTP 服务连接
SSE	Server-Sent Events 流式连接

新手最常见的是：

stdio

也就是通过本地命令启动 MCP 服务。

---

8.4 MCP 适合什么场景？

场景	是否适合 MCP
让 AI 操作浏览器	适合
让 AI 访问数据库	适合
让 AI 读 GitHub 仓库	适合
让 AI 搜索网页	适合
只是写普通代码	不一定需要

结论：

MCP 是增强 AI 能力的工具，不是新手必须配置的东西。

---

九、Skills 管理

Skills 是另一个重要进阶功能。

9.1 Skills 是什么？

Skills 可以理解为：

给 AI 安装的“专业技能包”。

比如：

• 前端开发 Skill
• Python 项目 Skill
• 论文写作 Skill
• 安全审计 Skill
• 数据分析 Skill
• Rust 开发 Skill
• React 项目 Skill

Skill 通常包括：

• 指令说明
• 工作流程
• 示例
• 脚本
• 模板

---

9.2 CC-Switch 的 Skills 管理能做什么？

CC-Switch 可以：

• 安装 Skill
• 启用 Skill
• 禁用 Skill
• 删除 Skill
• 同步 Skill 到不同工具
• 管理 Claude / Codex / Gemini / OpenCode 的 Skills

这对多工具用户很重要。

比如你写了一个“React 项目规范 Skill”，可以同步给：

• Claude Code
• Codex
• Gemini CLI
• OpenCode

这样不同 Agent 都遵守同一套开发规则。

---

十、Prompts 管理

Prompts 是很多人忽略但非常有用的功能。

10.1 Prompt 管理是什么？

不同 AI 编程工具都有自己的项目提示词文件。

例如：

工具	Prompt 文件
Claude Code	CLAUDE.md
Codex	AGENTS.md
Gemini CLI	GEMINI.md
OpenCode	AGENTS.md
Hermes	AGENTS.md

这些文件的作用是告诉 AI：

• 你是什么角色
• 这个项目怎么开发
• 编码规范是什么
• 禁止做什么
• 测试命令是什么
• 提交规范是什么

---

10.2 CC-Switch 的 Prompts 功能

它可以：

• 创建 Prompt 预设
• 编辑 Prompt
• 启用 Prompt
• 禁用 Prompt
• 切换 Prompt
• 管理不同工具的 Prompt 文件
• 使用 Markdown 编辑器编辑

---

10.3 Prompt 示例

例如你可以写一个“严格代码审查模式”：

你是一个严格的高级代码审查员。
修改代码前必须先阅读项目结构。
不要随意删除文件。
每次修改后必须说明修改原因。
优先保证安全性、可维护性和可测试性。

也可以写一个“快速开发模式”：

你是一个高效的全栈开发助手。
目标是快速完成 MVP。
优先实现功能，再考虑优化。
必要时可以创建新文件。

通过 CC-Switch，你可以快速切换不同工作模式。

---

十一、本地代理与路由

这是高级功能。

11.1 为什么需要本地代理？

因为不同 AI CLI 使用的 API 格式不完全一样。

有时你会遇到：

• Claude 格式
• OpenAI 格式
• Gemini 格式
• 中转格式
• 本地模型格式

它们不一定兼容。

本地代理可以帮助做：

• 请求转发
• 格式转换
• Provider 热切换
• 失败重试
• 故障转移
• 健康检测

---

11.2 本地代理适合谁？

适合：

• 多 Provider 用户
• 中转用户
• 本地模型用户
• 高频开发者
• 团队用户
• 希望自动容灾的人

新手不一定要开。

---

十二、健康检查与测速

CC-Switch 支持对 Provider 做检查。

常见检查包括：

• API 是否可用
• Key 是否有效
• 延迟是否正常
• 流式输出是否正常
• 余额 / 配额是否可见
• 模型列表是否能获取

这对中转 API 特别有用。

因为中转服务经常会出现：

• 某个模型不可用
• 流式失败
• 延迟高
• Key 失效
• 余额不足

有健康检查后，你能快速判断问题出在哪里。

---

十三、系统托盘快速切换

CC-Switch 支持系统托盘。

也就是：

• Windows 右下角
• macOS 顶部菜单栏
• Linux 托盘区域

你可以直接在托盘里：

• 查看当前 Provider
• 快速切换 Provider
• 按应用切换 Provider

不用每次打开主窗口。

---

十四、配置导入与同步

CC-Switch 支持从已有配置导入。

例如你之前已经配置过：

• Claude Code
• Codex
• Gemini CLI
• OpenCode

CC-Switch 可以读取已有配置，然后统一管理。

也可以把 CC-Switch 里的配置同步回工具自己的配置文件。

这叫：

双向同步。

---

十五、配置数据库

CC-Switch 会把配置保存在本地数据库中。

通常是 SQLite。

这样做的好处：

• 配置更稳定
• 不容易写坏文件
• 可以统一管理
• 可以做状态记录
• 可以支持导入导出

---

十六、Web 版本与 CLI 版本

除了桌面版，相关生态中还包括：

• 桌面版本
• Web 版本
• CLI 版本

适合不同场景。

16.1 桌面版

适合普通用户。

特点：

• 图形界面
• 操作简单
• 新手友好

16.2 Web 版本

适合服务器用户。

比如你在远程服务器上跑 AI CLI，不能打开桌面应用，就可以通过 Web 界面管理。

16.3 CLI 版本

适合高级用户。

可以用命令行完成：

• 列出 Provider
• 切换 Provider
• 同步 MCP
• 管理 Prompt
• 管理 Skills
• 做健康检查

---

十七、典型实战玩法

17.1 低成本 Codex 主力方案

适合多数用户。

用途	工具
主力写代码	Codex
配置管理	CC-Switch
高难规划	Claude
长上下文	Gemini

原因：

• Codex 成本更低
• Claude 只用于复杂任务
• CC-Switch 负责快速切换

---

17.2 多 Provider 容灾方案

你可以配置：

Provider	用途
OpenAI 官方	稳定主力
第三方中转 A	备用
第三方中转 B	备用
本地模型	离线测试

一旦某个 Provider 出问题，就快速切换。

---

17.3 团队统一配置方案

团队可以统一：

• Provider 命名
• Prompt 模板
• MCP 配置
• Skills 目录
• 模型选择规范

避免每个人本地配置不一样。

---

十八、推荐的新手进阶路线

阶段一：只学 Provider

目标：

• 会添加 Provider
• 会切换 Provider
• 会测试 Key

阶段二：学习 Codex 管理

目标：

• 用 CC-Switch 管理 Codex
• 配置 AGENTS.md
• 切换 OpenAI / 中转 API

阶段三：学习 Prompts

目标：

• 写项目规范
• 写开发模式
• 写审查模式

阶段四：学习 MCP

目标：

• 配置文件系统 MCP
• 配置浏览器 MCP
• 配置 GitHub MCP

阶段五：学习 Skills

目标：

• 安装社区 Skill
• 编写自己的 Skill
• 同步到 Codex / Claude

阶段六：学习代理与容灾

目标：

• 使用本地代理
• 配置备用 Provider
• 做健康检查

---

十九、哪些功能新手最该先用？

如果你是刚进阶，不要一上来全学。

优先顺序：

优先级	功能	建议
1	Provider 管理	必学
2	Codex 支持	强烈推荐
3	Prompt 管理	很实用
4	MCP 管理	进阶再学
5	Skills 管理	进阶再学
6	本地代理	高级用户
7	CLI 自动化	高级用户

---

二十、常见问题

20.1 CC-Switch 是不是只能管理 Claude？

不是。

它现在已经是多 AI CLI 管理器。

支持 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 等。

---

20.2 Codex 可以用 CC-Switch 管理吗？

可以。

Codex 是 CC-Switch 的重要支持对象之一。

可以管理：

• Provider
• API Key
• MCP
• Skills
• AGENTS.md Prompt

---

20.3 MCP 和 Skills 有什么区别？

简单说：

功能	作用
MCP	给 AI 外部工具能力
Skills	给 AI 专业工作流程

MCP 像“工具接口”。

Skills 像“技能说明书”。

---

20.4 Prompt 和 Skill 有什么区别？

Prompt 通常是项目级规则。

Skill 通常是某类任务的专用能力包。

例如：

• Prompt：这个项目必须用 TypeScript
• Skill：如何开发 React 表单组件

---

20.5 本地代理一定要开吗？

不一定。

普通用户只用 Provider 切换就够了。

本地代理更适合：

• 多 Provider
• 中转
• 容灾
• 高级路由
• 格式转换

---

二十一、总结

CC-Switch 的进阶能力可以用一句话总结：

它把 Claude Code、Codex、Gemini CLI、OpenCode 等 AI 编程工具的 Provider、MCP、Skills、Prompts、代理和配置同步统一到一个地方管理。

对于普通用户，它最有用的是：

• 一键切换 Provider
• 管理 Codex
• 降低 Claude 使用成本
• 快速切换模型

对于高级用户，它最有用的是：

• 统一 MCP
• 统一 Skills
• 统一 Prompt
• 本地代理路由
• 健康检查
• 多 Provider 容灾
• 团队配置统一

如果你已经入门 CC-Switch，下一步最建议学的是：

1. Codex Provider 管理
2. AGENTS.md Prompt 管理
3. MCP 同步
4. Skills 同步
5. 本地代理与健康检查

---

hello，这里是 晓雨的笔记本 。如果你喜欢我的文章，欢迎三连给我鼓励和支持：👍点赞 📁 关注 💬评论，我会给大家带来更多有用有趣的文章。
原文链接 👉 ，⚡️更新更及时。

欢迎大家点开下面名片，添加好友交流。