Claude Code如何 接入 DeepSeek V4 Pro

如果你已经在用 Claude Code 写代码、改文件、跑命令，下一步很自然就会想到一件事：能不能把默认上游换成 DeepSeek V4？

答案是可以，而且不算麻烦。对大多数人来说，最省事的方式不是自己去翻 ~/.claude/settings.json，而是直接用 CC Switch 把这层配置接管掉。这样做的好处很实际：

• 不用自己反复改配置文件
• 切换之后更容易确认到底有没有生效
• 平时想在不同供应商之间来回切，也不会太折腾

这篇就讲最常见的一条路径：怎么把 DeepSeek V4 接进 Claude Code，并尽快确认它已经能正常工作。

开始前先准备

先确认三件事：

• 你已经安装好了 Claude Code
• 你已经安装并打开了 CC Switch，如果还没装，可以先去下载 CC Switch
• 你手里有可用的 DeepSeek API Key

如果前两样都没问题，真正决定你能不能接上的，通常就是后面这个 Key。

另外，先记住两个常见模型名：

• deepseek-v4-flash
• deepseek-v4-pro

如果你只是想先把链路接通，Flash 更适合做第一个默认模型。它更快，也更适合高频日常使用。等你后面真的开始跑复杂代码任务、长上下文分析或者多步骤推理，再切到 Pro 就行。

切到 Claude 面板

打开 CC Switch 之后，在左侧应用切换器里选 Claude。

这里要注意一下：这个入口对应的是 Claude Code，不是 Claude Desktop。两边虽然名字很像，但在 CC Switch 里是两套不同的配置入口。

如果你没有看到 Claude 这个入口，先去：

设置 → 通用 → 应用可见性

看一眼是不是被你隐藏掉了。

添加 DeepSeek 供应商

切到 Claude 面板之后，点击右上角的 + 按钮添加供应商。

第一次配置的时候，优先选：

应用专属供应商

原因很简单。你现在的目标只是先让 Claude Code 跑起来，没有必要一上来就把“多应用共享同一套供应商”这种事情也一起搞进去。

最顺手的做法一般是：

1. 在预设里选 DeepSeek
2. 让名称和端点自动填充
3. 填入你的 DeepSeek API Key
4. 如果界面支持，就点一下“获取模型”
5. 选一个默认模型
6. 点击“添加”

如果模型列表没拉下来，也不用紧张。很多时候不是这条线路不能用，只是上游没有把模型发现接口做得那么规整。这种情况下你直接手动填也可以，比如：

• deepseek-v4-flash
• deepseek-v4-pro

启用供应商

供应商加好之后，还要在卡片上点一次：

启用

这一步做完，才算真正切过去。

对 Claude Code 来说，这里有一个和别的工具不太一样的地方：它通常是可以直接热生效的。

也就是说，大多数情况下你点完启用，不需要重启终端，Claude Code 后面的请求就会走到新的供应商。

这也是很多人喜欢用 CC Switch 管 Claude Code 的原因之一。切换动作比较轻，不会每次都把当前工作流打断。

当然，热生效不代表所有环境都百分之百丝滑。如果你切完之后感觉不对，比如：

• 终端里还是像在走旧配置
• 某些请求报错但看不出是哪里错了
• 当前网络环境本来就比较复杂

那最简单的排查方式还是：先把当前终端关掉，再重新开一个。

Claude Code 支持热切换，这没问题；但真遇到奇怪状态时，重开终端仍然是最快的排错动作。

为什么能接 DeepSeek

很多人第一次会卡在这个地方：Claude Code 明明是 Anthropic 的工具，为什么能接 DeepSeek？

实际原因没有那么玄。中间真正起作用的是 CC Switch 这一层。

你可以把它理解成：Claude Code 还是按它熟悉的方式去读配置、发请求，而 CC Switch 负责把你选的上游供应商整理成它能稳定使用的那种形态。这样你平时看到的是 Claude 面板、供应商卡片、启用按钮，但底层已经被接到 DeepSeek 那边了。

所以对普通用户来说，没必要一开始就去研究一堆配置字段。先把第一条线路接通，后面再看细节，效率更高。

什么时候要看本地路由

这里有一个很容易漏掉的点：如果你接的 DeepSeek 线路依赖 CC Switch 做本地转换，那就不能只加供应商，还要确认本地路由或者路由接管已经开起来。

你可以先这样理解：

• 如果当前供应商本身就是 Claude Code 能直接消费的那种线路，很多时候不用额外管本地路由
• 如果当前线路需要 CC Switch 在中间做请求转换、格式整理或者代理接管，那本地路由就不能关

这也是为什么有些人会遇到一种看起来很怪的情况：供应商明明已经启用了，Key 也填了，但 Claude Code 还是不走这条线路。最后查下来，不是供应商本身错了，而是 本地路由根本没开。

本地路由开关在哪

如果你发现主界面上没看到本地路由相关开关，先去设置里把它显示出来。

常见路径是：

设置 → 路由 → 本地路由

如果你的版本把“在主页面显示本地路由开关”这类选项默认藏起来了，也是在这里打开。

打开之后，回到 Claude 面板，再确认两件事：

• 本地路由服务是不是已经启动
• 你当前这条 DeepSeek 线路是不是依赖它

对普通用户来说，不一定非要把路由原理研究得很清楚，但至少要知道：有些线路能直连，有些线路必须靠本地路由接住。

怎么判断是不是路由问题

如果你碰到下面这些情况，优先往本地路由这边查：

• 供应商卡片已经启用，但 Claude Code 还是没切过去
• API Key 没问题，但请求一直报格式或网关类错误
• 切完之后只有重开终端偶尔能好，状态很不稳定

这时候先做的不是继续改模型名，而是先检查：

1. CC Switch 还在不在运行
2. 本地路由或路由接管是不是开着
3. 当前线路到底是直连，还是依赖本地转换

很多时候把这三项确认完，问题就已经定位一半了。

先做一个小测试

不要一上来就拿它跑复杂仓库，先做一个非常小的验证。

最简单的做法是直接在 Claude Code 里丢一个很轻的任务，比如：

• 让它解释一小段代码
• 让它总结一个小文件
• 让它把一段需求整理成待办列表

这一步主要是看三件事：

1. 请求是不是已经真的走到了 DeepSeek
2. 当前模型是不是你刚选的那个
3. 返回结果是不是正常，没有 Key 错误、模型名错误、额度错误之类的问题

只要这个小测试能稳定跑通，后面再去跑大任务，心里就会踏实很多。

配置文件写到哪里

如果你后面要排查问题，至少知道一个最常见的路径就够了：

~/.claude/settings.json

CC Switch 在切 Claude 供应商时，通常会改这里面的相关配置，比如：

• ANTHROPIC_API_KEY
• ANTHROPIC_BASE_URL

如果你同时还在用 VS Code 里的 Claude Code 插件，而且打开了同步，CC Switch 还可能顺手更新：

~/.claude/config.json

但这里的重点不是“建议你去手改”。恰恰相反，知道这些路径只是为了排查时心里有数。平时还是让 CC Switch 去维护，最省心。

常见问题

点了启用，但 Claude Code 好像没变化

先别急着怀疑整个流程，先看最基础的几项：

• 当前供应商卡片是不是已经变成启用状态
• 你切到的到底是不是 Claude 面板，而不是别的应用面板
• 路由接管或本地路由是不是已经开启
• 终端有没有必要重开一次

很多“切了但没生效”的问题，最后都不是 DeepSeek 有问题，而是当前会话还没完全切干净。

API Key 填了，为什么还是报错

最常见的还是老三样：

• Key 本身无效
• 端点地址不对
• 模型名填错了

尤其是手动填模型的时候，要确认你填的是真实请求模型名，不是某个界面里看到的展示名称。