Claude Code 接 DeepSeek最省事的办法是装 cc-switch把 DeepSeek 加进去点启用。但很多人就卡在这一步要么点测试显示失败要么测试通过了一敲claude就报错或者一直转圈不动。我翻了 B站和小红书的评论区“到这一步测试失败是啥情况”“为什么我添加 deepseek 到 ccswitch 后测试失败了”下面都是一串“我也是”。我在自己的 Windows 11 上把常见的几种情况都真实复现了一遍下面按报错对号入座。测试环境Windows 11Windows Terminal PowerShellcc-switch 3.20.4Claude Code 2.1.283模型 deepseek-v4-pro。报错是我用临时配置故意造出来的假 key、少写一个横杠的模型名、写错的地址没动 cc-switch 里正常的那张卡片。先知道一件事测试通过 ≠ 能用新版 cc-switchv3.16.3 以后卡片上的「检测连通」只看这个地址能不能连上。官方手册写得很清楚只要服务器有任何响应哪怕是 401、403、404都算“连通正常”它不检查你的 API key也不检查模型名。所以下面这个“DeepSeek 连通正常”只说明网络和地址没问题真正要看的是打开终端敲claude随便问一句看它报什么错。下面四种看报错里的关键字就能分清。情况一401 Authentication Failskey 不对401 Authentication Fails, Your api key: ****0000 is invalid (request_id: ...) · Retrying in 10s · attempt 6/10最坑的地方它不会马上告诉你会自己重试 10 次attempt 6/10就是第 6 次看起来就像卡死了。碰到一直转圈先按Esc停下来看看红字写的是什么。原因API key 不对。最常见的是复制的时候多了空格或者少复制了一截。解决去 DeepSeek 开放平台新建一个 API key整段复制在 cc-switch 里点 DeepSeek 卡片上的编辑把 key 粘进去保存。情况二API Error: 400 … supported API model names模型名写错API Error: 400 The supported API model names are deepseek-flash, deepseek-v4-pro, but you passed deepseek-v4pro.原因模型名写错了。这条报错其实很好心它直接告诉你支持哪几个模型名、你传的是哪个。我这里故意把deepseek-v4-pro少写了一个横杠就不认了。解决照着报错里的名字改一个字母都不能差。模型名以 DeepSeek 官方文档为准我写这篇时是deepseek-v4-pro和deepseek-flash。很早以前加的供应商卡片不会自动更新手册里说卡片保存的是创建时的预设快照模型名可能已经过时了。最省事的办法删掉旧卡片用 cc-switch 自带的 DeepSeek 预设重新加一个。旧版 cc-switch 测试报 HTTP 400v3.16.3 之前测试会真的发一句话用的是一个默认测试模型。B站有人贴过“已向「DeepSeek」用模型「gpt-5.4-mini」发送 hiHTTP 400”就是拿 gpt 开头的模型名去问 DeepSeek当然不认。把测试模型改成 DeepSeek 的或者直接升级 cc-switch。情况三Connection dropped地址不对或网络不通Connection dropped (ECONNRESET) · Retrying in 4s · attempt 5/10原因连不上服务器。要么地址填错了我这里故意把.com写成了.con要么网络不通。它同样会一直重试。在 cc-switch 里点测试的话这种情况会显示“无法连通”。解决别自己手敲地址。添加时直接选 cc-switch 自带的 DeepSeek 预设地址会自动填成https://api.deepseek.com/anthropic你只需要填 API key。电脑开着加速器代理软件的先关掉再试。DeepSeek 是国内服务用不着它评论区也有人遇到连不上被提醒“是不是开着魔法”。情况四402 Insufficient Balance没钱了API Error: 402 Insufficient Balance这个我没法演示因为我账号里有余额上面是评论区网友贴的原话。DeepSeek 官方错误码里 402 就是余额不足。原因DeepSeek 网页和 App 聊天是免费的但接到 Claude Code 里走的是 APIAPI 要单独充值和网页版不是一回事。解决去 DeepSeek 开放平台充值先充几块钱就能试。改完记得这三步不管改了哪一项在 cc-switch 里点一下「启用」把终端关掉重新打开一个再敲claude打开时如果先冒出一大段黄色英文说deepseek-v4-pro isnt described by this versions model catalog...那是提示不是报错不用管。第一次进还会问你信不信任当前文件夹默认选中的是 “No, exit”要先按 ↓ 选到 “Yes, I trust this folder” 再回车问一句能正常回答就是好了小结报错里的关键字原因解决测试显示“连通正常”一用就报错测试只看地址不检查 key 和模型名终端敲 claude 问一句看具体报错401 Authentication Fails一直 RetryingAPI key 不对先按 Esc重新建 key整段复制粘贴400 … supported API model names模型名写错或过时照报错里的名字改旧卡片删掉用预设重加Connection dropped / 测试“无法连通”地址不对或开着加速器用自带预设只填 key关掉加速器402 Insufficient BalanceAPI 余额不足去开放平台充值和网页版免费是两回事整个过程我录了视频B站搜 BV1xXaB6PETo 可以看。还是不行的话把完整报错贴在评论区API key 记得打码我帮你看是哪一种。我是老杨卖了 15 年混凝土自学 AI 一年现在专门啃 AI 工具的报错。