CC Switch 完全指南：让 AI 编程工具无缝切换任意模型
CC Switch 是一款运行在本地电脑上的开源工具，它充当 AI 客户端与模型服务之间的"翻译官"和"调度中心"。借助它，你可以让原本只支持特定模型（比如 Claude）的编程工具，轻松调用其他厂商的免费或廉价模型——例如魔芋AI平台提供的 Qwen 3.6、GLM 5 等，并且在整个过程中无需修改任何代码。
本指南将系统介绍 CC Switch 的核心概念、安装流程、配置方法、常用功能以及排错技巧，帮助你彻底掌握这一利器。
一、CC Switch 能做什么？
CC Switch 的核心能力是 本地 API 请求的拦截、协议转换与转发。当它运行时：
- 拦截：自动捕捉你电脑上 AI 客户端（如 Claude Code）发出的 HTTP 请求。
- 转换：将请求的格式调整为与目标模型服务兼容的协议。
- 替换：将原请求中的 API Key、端点地址替换为你预先配置的 Key 和地址。
- 回传：把模型回复封装成客户端可识别的格式，完整返回。
最终效果就是：Claude Code 以为自己正在调用 Anthropic 的云端模型，实际却在与魔芋AI对话。这种"移花接木"的能力，使你可以零成本体验顶级 AI 编程代理，同时无需改变任何使用习惯。
二、安装与初始设置（Windows）
1. 下载安装包
访问 CC Switch 官网
点击 “立即下载”，选择 Windows (.exe) 版本。
2. 安装程序
双击下载的 .exe 文件，跟随安装向导完成安装。
过程中若弹出防火墙权限提示，请 务必允许访问网络，这是 CC Switch 正常工作的基础。
安装完成后，桌面会出现快捷方式，同时系统托盘中会常驻 CC Switch 图标。
3. 启动与界面概览
双击桌面图标打开主窗口。
左侧区域是 配置列表，默认可能为空。
右侧区域显示 实时日志与状态信息。
右上角的 「创建」 按钮，是添加新模型配置的入口。
右键点击系统托盘图标，可以快速启用/禁用代理、查看版本或退出程序。
三、核心概念：Provider 与 Config
理解 CC Switch 的两个基础概念，能让配置过程更顺畅：
- Provider（提供商）：表示一个模型服务的"协议类型"，例如 Anthropic（对应 Claude 系列）、OpenAI 等。选择正确的 Provider 决定了请求会被转换成哪种 API 格式。
- Config（配置）：一个具体的模型连接设置，包含 Provider、API Key、请求地址、模型 ID 等信息。你可以为一个 Provider 创建多个 Config，并通过一键启用来快速切换模型。
例如，你可以创建两条配置：
- 魔芋AI Qwen 3.6（Anthropic 协议，用于 Claude Code）
- 本地 Ollama（OpenAI 协议，用于其他客户端）
需要切换时，只需在界面中点击启用/禁用即可，客户端完全无感。
注：博客：https://blog.csdn.net/badao_liumang_qizhi
四、配置实战：接入魔芋AI平台模型
下面以接入魔芋AI平台的模型为例，演示完整的配置步骤。
前置条件
已在 魔芋AI平台 注册账号，创建应用，并获取：
- modelId（如 qwen3.6-35b 或 glm-5-32b）
- APIKey
操作步骤
打开 CC Switch 主界面，点击右上角 「创建」 按钮。
在弹出的窗口中，选择 「自定义配置」（或类似入口，用于手动填入所有参数）。
按以下表格填入信息：
| 配置名称 | 任意，例如 魔芋AI Qwen3.6 | 仅用于识别，不影响功能 |
| Provider | Anthropic | 因为要供给 Claude Code 使用，必须选对协议 |
| API Key | 从魔芋AI平台复制的 APIKey | 注意区分不同权限的 Key |
| 请求地址 | https://api.moyuai.com/v1/anthropic | 魔芋AI专门为兼容 Anthropic 协议提供的端点 |
| 模型 ID | 从魔芋AI平台复制的 modelId | 必须与平台页面完全一致，如 qwen3.6-35b |
填写完成后，点击 「测试模型」 按钮。如果返回"连接成功"或得到有效响应，说明配置无误。
点击 「保存」，然后 启用 该配置（将开关拨至 On 状态）。
至此，CC Switch 已完成所有准备工作，静待客户端连接。
五、与 Claude Code 联合使用
Claude Code 完全指南：从安装到精通
确保 CC Switch 正在运行，且上一步创建的配置处于 启用 状态。
打开命令提示符（cmd）或 PowerShell，切换到你的项目目录。
输入 claude 启动 Claude Code。
此时，Claude Code 发出的请求已被 CC Switch 拦截并转发到魔芋AI。你可以直接开始交互，例如：
用 Python 写一个带重试机制的网络请求函数。
Claude Code 会正常返回代码，整个过程零成本。
注意：使用过程中，Claude Code 界面可能仍显示模型为"Claude"，但实际推理已由魔芋AI聚合的模型完成，属于正常现象。
六、更多实用功能
1. 多模型快速切换
创建多条配置后，在 CC Switch 主界面中一键启用/禁用即可切换模型，无需重启客户端。例如：
- 代码对话用魔芋AI Qwen 3.6（高性价比）
- 处理私密项目时，一键切回本地 Ollama 模型（离线）
2. 实时请求日志
主窗口右侧实时记录每一次转发的请求详情：时间戳、目标模型、请求方法、状态码等。这为调试网络、检查模型响应提供了极大便利。
3. 全局代理与智能分流
CC Switch 默认会自动调整系统代理，确保 AI 工具的请求被正确拦截。你可以在设置中调整代理规则，避免影响其他软件的网络连接。
4. 客户端兼容性
除 Claude Code 外，CC Switch 还支持：
- Codex
- OpenClaw
- Hermes
- 以及任何兼容 OpenAI 或 Anthropic 协议的终端工具
七、常见问题与排错
| Claude Code 启动后提示"无法连接 API" | 检查 CC Switch 是否运行且对应配置已启用；在 CC Switch 中执行"测试模型"确认连通性；确保 Claude Code 未设置 ANTHROPIC_API_KEY 环境变量 |
| 测试模型连接失败 | 重新核对 API Key、请求地址是否正确（注意 /anthropic 与 /v1 的区别）；检查网络能否正常访问魔芋AI域名 |
| 模型回复质量不佳或报错 | 检查模型 ID 是否与魔芋AI平台完全一致；尝试用 /compact 命令清理过长的上下文 |
| 关闭 CC Switch 后 Claude Code 无法工作 | 这是预期行为，因为请求转发中断。重新打开 CC Switch 即可恢复，或直接修改环境变量让 Claude Code 使用原服务 |
| 其他软件网络异常 | 在 CC Switch 设置中调整代理模式，或临时退出 CC Switch |
八、卸载与清理
如果不再需要使用 CC Switch：
通过 Windows 的"添加或删除程序"找到 CC Switch 并执行卸载。
卸载后，系统代理设置会自动恢复，不会留下残留配置。
九、总结
CC Switch 打破了 AI 工具与模型之间的绑定关系，赋予了开发者自由选择和组合的自由。它以极低的资源占用、简洁的操作和强大的协议兼容性，将"多模型聚合平台 + 收费客户端"的"移花接木"方案变成现实。
配合本指南的安装与配置步骤，你应该能在十分钟内完成从零到可用，将诸如魔芋AI平台聚合的高性能模型（如 Qwen、GLM 等）无缝接入 Claude Code，享受高效、经济且可控的 AI 编程体验。
这种组合方式的优势在于，你既可以使用熟悉的 Claude Code 交互体验，又能通过平台灵活切换不同模型，能根据需求自动选择最合适的模型，既避免了厂商绑定，又降低了多模型管理的复杂度，让开发者可以更灵活地组合使用不同模型的优势。
