文章目录一、CC-Switch配置解决什么问题二、CC-Switch下载安装前要准备什么1. 一个有效的 DeepSeek API Key2. 确认自己的操作系统三、CC-Switch 下载安装包地址四、分平台安装步骤Windows 安装macOS 安装Linux 安装五、配置第一步新增 API 渠道六、配置第二步创建 DeepSeek 供应商并绑定 API Key七、配置第三步开启本地路由八、配置第四步激活 DeepSeek 渠道九、配置第五步重启 Codex 客户端十、怎么确认配置已经生效十一、常见问题CC-Switch 是一款跨平台的 AI 模型 API 渠道管理工具用于统一转发和代理各家大模型的 API 请求。它适配 Codex、Claude Code 等 AI 编程工具支持在多个模型渠道之间自由切换。把 CC-Switch 与 DeepSeek 搭配使用可以让 Codex 客户端稳定调用 DeepSeek 大模型解决调用失败、无响应、密钥无效等问题。本文按配置顺序完整讲解 CC-Switch 的下载安装、DeepSeek 供应商创建、本地路由开启、渠道切换、Codex 生效设置与配置验证方法。一、CC-Switch配置解决什么问题Codex 客户端默认调用的模型范围有限想换用 DeepSeek 这类模型直接在客户端里改配置往往行不通。CC-Switch 的作用是摆在中间做转发客户端只管连本地端口由 CC-Switch 把请求转给对应模型服务商。项目说明使用工具CC-Switch跨平台桌面应用开源项目调用模型DeepSeek 大模型 API生效客户端Codex 客户端适配系统Windows、macOS、Linux配置耗时几分钟内可完成典型用途代码生成、代码调试、项目重构、BUG 修复配置完成后日常使用只需要在 CC-Switch 里点一下切换渠道不用再动 Codex 的设置。二、CC-Switch下载安装前要准备什么1. 一个有效的 DeepSeek API Key在 DeepSeek 官方平台申请格式为sk-开头的专属字符串。需要注意API Key 属于账户私有凭证必须由使用者本人申请。不要使用来源不明的密钥也不要把它分享给他人更不要写进任何公开的配置示例里。2. 确认自己的操作系统CC-Switch 在 Windows、macOS、Linux 上都提供了对应安装包但三者的安装方式不同。先确认系统版本再对号入座看第三章。三、CC-Switch 下载安装包地址CC-Switch 安装包下载https://gitee.com/yjaz2026/cc-switch四、分平台安装步骤Windows 安装双击下载的 MSI 安装程序跟随向导点下一步。安装路径可以自定义建议不要装在 C 盘省点系统盘空间。安装完成后勾选桌面快捷方式直接启动软件。如果下载的是便携版解压后双击主程序就能打开不需要执行安装流程。macOS 安装方式一命令行安装。打开终端执行brew tap farion1231/ccswitch brew install --cask CC-Switch方式二手动安装。解压 ZIP 包把程序拖入应用程序文件夹。Linux 安装Debian / Ubuntu 系统终端执行sudo apt install ./CC-Switch-*.debFedora 系统终端执行sudo dnf install ./CC-Switch-*.rpmAppImage 文件添加执行权限后直接运行即可。三个平台装完后有一个共同点首次打开 CC-Switch 无需注册登录直接进入主界面就能开始配置。五、配置第一步新增 API 渠道渠道是 API 转发的基础先建一个专属的 DeepSeek 调用渠道。在软件顶部导航栏找到并点击OpenAI 图标入口。所有大模型渠道的配置都在这个模块里完成。查看软件右上角点击【】新增按钮弹出渠道创建配置窗口。进入新增渠道页面接下来填写 DeepSeek 的供应商参数。六、配置第二步创建 DeepSeek 供应商并绑定 API Key这一步是整套配置的核心。API Key 填错或缺失会直接导致调用失败填写时要格外仔细。在新增渠道的预设供应商下拉列表中选择【DeepSeek】。选中后软件会自动匹配 DeepSeek 模型的基础接口参数接口地址不用手动填。选择供应商后向下滚动页面找到API Key 专属输入框。这项是核心必填项默认没有内容。把提前申请好的有效 API Key 完整粘贴进去。保存前核对三项密钥没有多余空格、没有字符缺失、未过期也未注销。确认无误后点击页面底部的**【保存】按钮**DeepSeek 供应商渠道创建完成。七、配置第三步开启本地路由大量 Codex 调用失败的案例根源都在本地路由没开。即便渠道和密钥完全正确路由未开启时 API 也无法转发Codex 会毫无反应。这一步必须完整操作。返回 CC-Switch 主界面进入设置功能模块。在设置列表中找到本地路由选项点击进入配置页面。依次开启两个核心开关缺一不可开关作用状态路由总开关全局转发总入口关闭后所有模型渠道失效开启Codex 专属开关单独适配 Codex 客户端的转发权限开启开启后软件会自动保存路由配置不需要手动确认。日常使用中保持这两个开关处于开启状态避免误触关闭。八、配置第四步激活 DeepSeek 渠道路由配好后还要手动激活新建的 DeepSeek 渠道软件才会默认转发 DeepSeek 的模型请求。回到 CC-Switch 主界面的渠道列表。在列表里找到刚建好的【DeepSeek】渠道点击选中。确认界面显示当前激活渠道为 DeepSeek别停留在默认渠道或其他模型渠道上否则前面的配置等于白做。九、配置第五步重启 Codex 客户端配置改完后Codex 不会自动识别新的代理路由必须重启才能读到 CC-Switch 的转发配置。完全退出 Codex 客户端后台进程一并关闭避免残留进程影响配置加载。重新打开 Codex 客户端软件会自动读取本地 CC-Switch 的路由代理参数。重启完成后就能通过 DeepSeek API 使用代码生成、代码调试、项目重构、BUG 修复等功能。十、怎么确认配置已经生效配置是否真的生效不用靠猜可以通过下面几个现象判断检查项生效的表现未生效的表现CC-Switch 渠道列表DeepSeek 渠道处于选中状态停留在默认渠道本地路由设置页两个开关均为开启任一开关为关闭Codex 调用测试能返回模型回复内容长时间无响应或直接报错API Key 状态后台显示正常、有可用额度提示无效、过期或额度耗尽四项都正常说明链路已经打通。如果其中某一项对不上按下一章的对照表定位。十一、常见问题CC-Switch 支持哪些系统Windows、macOS、Linux 均可使用各平台都提供了对应的安装包格式。首次打开需要注册账号吗不需要。装完首次打开软件直接进入主界面就能开始渠道配置。DeepSeek 的 API Key 从哪里获取在 DeepSeek 官方平台申请属于账户私有凭证。不要使用来源不明的密钥也不要分享给他人。为什么渠道和密钥都对Codex 还是没反应优先检查本地路由。路由总开关与 Codex 专属开关需要同时开启缺一个都无法完成转发。配置完成后必须重启 Codex 吗必须。Codex 不会自动识别新的代理路由需要完全退出含后台进程后重新打开。修改配置后需要重新保存吗本地路由开关开启后会自动保存不需要手动确认。渠道参数的改动则需要点保存按钮才会生效。可以让多个客户端共用一个渠道吗CC-Switch 本身就是渠道管理工具支持多模型渠道切换。某个客户端能否调用取决于对应客户端专属开关是否开启。换电脑后要重新配置吗要。CC-Switch 的渠道配置保存在本地换设备后需重新安装软件并走一遍本文的配置流程。