手把手教你在 Claude Code 中接入 DeepSeek-V4

Claude Code 的价值，在于把代码理解、修改、执行和验证整合进同一条工作链路；而模型层的选择，决定了这条链路的响应速度、推理质量和成本结构。

如果你已经在使用 Claude Code，又希望把底层模型切换到 DeepSeek-V4，这篇文章可以直接帮你完成配置。

本文不讲空泛概念，只解决一件事：通过 cc-switch 把 Claude Code 的 Provider 切到 DeepSeek，并完成可用验证。

为什么是 DeepSeek-V4

根据 DeepSeek 官方文档，当前 DeepSeek-V4 体系至少包含两个核心模型：

deepseek-v4-flash：偏向低延迟和高性价比，适合高频交互、日常编码补全、命令式协作。
deepseek-v4-pro：偏向更强的复杂推理与稳定输出，适合重构、疑难排障、长链路任务。

对 Claude Code 这类 Agent 型工具来说，模型是否支持稳定的 API 兼容模式非常关键。DeepSeek 官方已经提供兼容式接入能力，因此可以借助 cc-switch 以较低改造成本完成切换。

前置条件

在开始之前，默认你已经满足以下条件：

已安装 Claude Code
已安装 cc-switch
本机可以正常访问 DeepSeek 开放平台

如果以上环境已经具备，下面直接进入正式配置。

第一步：注册 DeepSeek 账号并创建 API Key

先进入官方平台完成注册，并充值少量余额即可开始测试。

DeepSeek 开放平台
DeepSeek API Keys 页面

获取keys

注册完成后，进入 API Keys 页面创建密钥。后续在 cc-switch 中配置 Provider 时，会直接用到这串 API Key。

第二步：在 cc-switch 中新增 Claude Code Provider

打开 cc-switch，进入 Claude Code Provider 配置界面，新增一个 Provider。

打开CC Switch 添加 Claude Code Provider 添加配置

这里的目标很明确：新增一条指向 DeepSeek 的模型通道，供 Claude Code 在运行时调用。

第三步：选择厂商为 DeepSeek

在 Provider 类型中，选择 DeepSeek。

选择厂商模型选择DeepSeek

这一步本质上是在告诉 cc-switch：后续请求将转发到 DeepSeek 的模型服务，而不是默认供应商。

第四步：填写 API Key，并启用完整 URL

将刚才创建的 API Key 填入对应字段，同时勾选完整 URL 选项。

填写API Key 勾选完整URL

如果你所在的环境对网关、代理或兼容地址有额外要求，这一步通常也是最容易出错的位置，因此建议填完后再检查一遍。

第五步：高级选项中选择 Anthropic Message（原生）

在高级配置中，将 API 格式 设为 Anthropic Message（原生）。

高级选项 API格式 Anthropic Message (原生)

这一步是整套配置能否跑通的关键。Claude Code 本身围绕 Anthropic 风格的消息协议工作，因此这里必须选择兼容的消息格式，才能让请求结构正确落到 DeepSeek 侧。

第六步：配置模型映射

参考官方文档：

DeepSeek API 文档

当前可重点关注以下模型：

deepseek-v4-flash
deepseek-v4-pro
deepseek-chat（官方标注将于 2026-07-24 弃用）
deepseek-reasoner（官方标注将于 2026-07-24 弃用）

模型映射

模型映射建议这样选：

日常编码、频繁调用、成本敏感：deepseek-v4-flash
复杂问题、长上下文、多步骤推理：deepseek-v4-pro

如果你只是先把链路跑通，优先填 deepseek-v4-flash 即可；如果更看重复杂任务质量，再切到 deepseek-v4-pro。

deepseek-v4-flash

第七步：保存配置

配置完成后，滚动到底部并保存。

配置完成，滚动鼠标到底部，点击保存

到这一步为止，Provider 的静态配置已经完成，接下来只差启用。

第八步：启用 DeepSeek 配置

在 Provider 列表中启用刚刚创建的 DeepSeek 配置。

启用Deepseek配置

启用之后，Claude Code 才会真正将请求路由到这套模型配置。

第九步：在终端中启动 Claude Code 并切换模型

回到终端，执行 claude，进入 Claude Code。

终端输入 claude 命令，切换模型

如果你的 Provider 和模型映射已经配置正确，这里就可以直接使用 DeepSeek 提供的模型能力完成后续开发任务。

第十步：做一次最小可用验证

输入一句最简单的测试语句，例如：

复制代码

你好，我是谁？

测试模型

只要模型能正常返回内容，说明整条调用链已经打通：

Claude Code 负责 Agent 交互
cc-switch 负责 Provider 转发
DeepSeek-V4 负责底层生成与推理

结语

这套方案的核心价值，不是"把一个模型换成另一个模型"这么简单，而是把 Claude Code 的工程化工作流，与 DeepSeek-V4 的模型能力真正接到一起。

一旦链路打通，你后面做的就不只是问答，而是补全、改代码、跑命令、读项目、做重构、查问题这一整套开发动作。

如果你想要一个稳、快、成本可控的默认配置，优先使用 deepseek-v4-flash；如果你在处理复杂仓库、疑难问题或者高强度推理任务，直接切到 deepseek-v4-pro 会更合适。