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