下面按出现概率从高到低整理，包含故障现象、成因、一步到位修复方案，全部是日常配置DeepSeek时高频踩坑点。

一、Codex发送请求完全无响应、空白无输出

现象

输入代码指令后，长时间转圈、不返回任何内容，CC-Switch路由看不到请求记录。

核心原因

1. CC-Switch本地路由两项开关没全开（路由总开关、Codex专属开关缺一个）；
2. Codex只是关了窗口，后台进程残留，没真正退出重启；
3. 电脑防火墙/杀毒拦截了CC-Switch本地代理端口；
4. CC-Switch激活渠道选错，停留在空白/失效渠道。

修复

1. 进入CC-Switch设置-本地路由，两个开关全部打开；
2. 托盘右键Codex选择完全退出，等待进程消失再重启；
3. 切换到DeepSeek渠道并保存；
4. 临时关闭防火墙测试，放行127.0.0.1本地端口。

二、弹窗提示API Key无效、401认证失败

现象

Codex直接报错密钥错误、授权失败。

原因

1. 复制API Key时带前后空格、换行符；
2. DeepSeek后台该密钥已手动删除、过期；
3. 密钥额度耗尽、账户余额不足；
4. 渠道选错，密钥填进其他供应商。

修复

1. 清空输入框，重新复制sk密钥，不要连带多余空白；
2. 登录DeepSeek平台查看密钥状态，余额、调用额度；
3. 后台新建一组全新API Key替换旧密钥，保存渠道。

三、能发送请求，但模型返回报错404/接口不存在

现象

有请求日志，但直接返回接口路径错误。

原因

1. 新增渠道时没有选择预设DeepSeek，手动乱改接口地址；
2. CC-Switch版本过低，不兼容Codex协议转换；
3. 激活渠道不是DeepSeek，用了OpenAI原生地址。

修复

1. 删除旧渠道，重新新建，供应商下拉直接选DeepSeek，不修改接口；
2. 去GitHub更新CC-Switch最新Release版本；
3. 确认主界面激活渠道为DeepSeek。

四、配置全部保存，重启软件依旧无法连接模型

现象

密钥、路由、渠道全部正常，测试调用还是失败。

标准修复流程

1. 重新选中DeepSeek渠道，点击保存按钮刷新配置；
2. 彻底关闭CC-Switch，重新打开；
3. 托盘完全退出Codex客户端，重启；
4. 再次发起代码生成测试。

五、Codex只能调用OpenAI，无法读取DeepSeek模型

现象

执行/model查看模型列表，看不到DeepSeek系列模型。

原因

1. Codex启动前没打开CC-Switch本地路由；
2. Codex缓存旧代理配置，未重启刷新；
3. Codex开关未开启，路由不转发代码工具流量。

修复

1. 先开CC-Switch，开好路由双开关，再启动Codex；
2. 完全退出Codex重开，清空本地缓存配置。

六、调用时卡顿、流式输出断断续续、中途断连

现象

代码输出一半中断，加载缓慢。

原因

1. 本地路由不稳定，CC-Switch后台被系统休眠；
2. DeepSeek接口网络访问延迟高；
3. 同时多开大量AI工具抢占代理端口。

修复

1. 设置电脑禁止休眠CC-Switch；
2. 关闭其他占用代理的工具；
3. 重启CC-Switch路由刷新连接。

七、CC-Switch找不到本地路由设置页面

现象

设置列表里看不到“本地路由”选项，没有Codex开关。

原因

软件版本老旧，早期版本不支持Codex专属路由模块。

修复

前往GitHub下载最新版CC-Switch，旧版本直接卸载重装。

八、保存渠道配置后自动清空、密钥丢失

现象

填好API Key点保存，重新打开渠道页面密钥空白。

原因

1. 软件权限不足，无法写入本地配置文件；
2. 解压便携版直接运行，缺少写入权限；
3. 杀毒软件拦截CC-Switch读写配置。

修复

1. Windows右键CC-Switch选择“以管理员身份运行”；Mac授予磁盘权限；
2. 关闭杀毒实时防护后重新填写密钥保存。

九、Codex启动报错：代理端口占用

现象

Codex启动提示本地端口被占用，无法连接路由。

原因

多次重复打开CC-Switch，多进程抢占本地代理端口。

修复

全部关闭CC-Switch、Codex，打开任务管理器结束相关进程，只运行一个CC-Switch窗口。

十、渠道列表看不到刚创建的DeepSeek渠道

现象

点加号创建保存后，回到列表找不到渠道。

原因

保存时网络临时卡顿、软件闪退，配置未落地；操作时误切页面取消保存。

修复

重新新建DeepSeek渠道，粘贴密钥后等待提示保存成功再关闭弹窗。