AI编程工具配置管理助手，转接API专用软件。

AI编程工具配置管理助手，专为管理 Claude Code、Codex、Gemini CLI 等 AI 编程工具的供应商配置、MCP 服务器、Skills 与 Prompt 模板而设计。

把安装、切换、MCP 和稳定性配置串成一条清晰路径

这个教程中心沿用内容中心的组织方式来讲 CC Switch，但内容全部围绕当前项目主题展开。你可以先走最短上手路线，也可以按分类深入看供应商配置、MCP 工作流和故障转移。

什么是 CC Switch?

CC Switch 是一款跨平台桌面应用，面向经常使用 AI 编程工具的开发者。它主要负责把 Claude Code、Codex、Gemini CLI 这类工具的配置管理统一起来。

你可以把它理解成一个受管应用配置中心，用来集中管理：

• Claude Code
• Claude Desktop
• Codex
• Gemini CLI
• OpenCode
• OpenClaw
• Hermes

当你需要在多个 AI 工具之间切换供应商、同步配置或接入扩展能力时，CC Switch 会比手动维护多份配置文件更高效。

解决什么问题

如果你长期使用 AI 编程工具，通常会遇到这些典型问题：

多供应商切换麻烦

同一个人可能同时在用：

• 官方 API
• 第三方中转服务
• 云厂商模型接口

没有统一管理工具时，每次切换都要手动改配置文件、环境变量或模型地址，成本很高。

配置分散，难以统一维护

Claude Code、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes 都有各自独立的配置方式。文件位置不同、格式不同、规则也不完全一样。

一旦你同时用多个工具，维护就会迅速变得零散。

无法直观看到用量和成本

很多开发者能正常调用模型，却不清楚：

• 一天到底请求了多少次
• 哪个供应商消耗最多
• 当前余额还有多少
• 哪些模型最贵

CC Switch 把这些信息尽量收拢到统一界面里，方便你做判断。

单一供应商不稳定时，工作流容易中断

如果你只依赖一个供应商，一旦该线路波动、限流或报错，正在进行的工作就会被打断。对于长任务或高频调用场景，这种问题尤其明显。

CC Switch 提供的本地代理、故障转移和健康状态机制，就是为了解决这类稳定性问题。

核心功能

供应商管理

CC Switch 最核心的能力就是供应商管理。你可以把它当成所有受管应用的统一供应商面板。

它主要解决这些事情：

• 一键切换多个 API 供应商配置
• 使用预设模板快速添加常见供应商
• 在多个应用之间共享统一供应商能力
• 管理 Claude Desktop 的第三方供应商、直连模式和模型映射
• 查询余额与用量
• 做端点测速

对于经常在 Claude Code 或 Codex 中切第三方模型的人，这部分会是最先感受到价值的区域。

扩展功能

除了供应商本身，CC Switch 还把扩展能力也放进了统一入口。

MCP 服务器

用于管理 Model Context Protocol 服务器，把更多上下文能力接到 AI 工具里。

Prompts

用于管理系统提示词预设，方便在不同场景之间快速切换。

Skills

用于安装和管理技能扩展，把稳定、可复用的工作方法沉淀下来。

代理与高可用

这部分是 CC Switch 和普通“配置切换器”拉开差距的地方。

它提供的能力包括：

• 本地代理服务
• 请求日志与用量统计
• 自动故障转移
• 熔断器机制
• 更细的 Token 用量追踪与成本估算

如果你需要让 Claude Code、Codex 或 Gemini CLI 长时间稳定运行，而不想在单一上游失败时整条链路停掉，这部分会非常重要。