CC Switch 完全指南：让 AI 编程工具无缝切换任意模型
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 编程代理，同时无需改变任何使用习惯。
二、安装与初始设置（Windows）
1. 下载安装包
- 访问 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.6（Anthropic 协议，用于 Claude Code）本地 Ollama（OpenAI 协议，用于其他客户端）
需要切换时，只需在界面中点击启用/禁用即可，客户端完全无感。
注：
博客：
https://blog.csdn.net/badao_liumang_qizhi
四、配置实战：接入讯飞星辰 MaaS 免费模型
下面以接入讯飞星辰 MaaS 平台的免费 Qwen 模型为例，演示完整的配置步骤。
前置条件
- 已在 讯飞星辰 MaaS 平台 注册账号，创建应用，并获取：
- modelId（如
xfyun-qwen3.6-35b-a3b） - HTTP 协议的 APIKey
- modelId（如
操作步骤
- 打开 CC Switch 主界面，点击右上角「创建」按钮。
- 在弹出的窗口中，选择「自定义配置」（或类似入口，用于手动填入所有参数）。
- 按以下表格填入信息：
| 字段 | 应填入的内容 | 说明 |
|---|---|---|
| 配置名称 | 任意，例如讯飞 Qwen3.6 | 仅用于识别，不影响功能 |
| Provider | Anthropic | 因为要供给 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 还支持：
- Codex
- OpenClaw
- Hermes
- 以及任何兼容 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 编程体验。