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

0 阅读5分钟

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 页面

00.jpg 获取keys

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

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

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

01.jpg 打开CC Switch 添加 Claude Code Provider 添加配置

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

第三步:选择厂商为 DeepSeek

在 Provider 类型中,选择 DeepSeek

02.jpg 选择厂商模型 选择DeepSeek

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

第四步:填写 API Key,并启用完整 URL

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

03.jpg 填写API Key 勾选完整URL

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

第五步:高级选项中选择 Anthropic Message(原生)

在高级配置中,将 API 格式 设为 Anthropic Message(原生)

04.jpg 高级选项 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 弃用)

05.jpg

模型映射

模型映射建议这样选:

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

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

06.jpg deepseek-v4-flash

第七步:保存配置

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

07.jpg

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

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

第八步:启用 DeepSeek 配置

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

08.jpg

启用Deepseek配置

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

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

回到终端,执行 claude,进入 Claude Code

09.jpg 终端输入 claude 命令 ,切换模型

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

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

输入一句最简单的测试语句,例如:

 
你好,我是谁?

10.jpg

测试模型

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

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

结语

这套方案的核心价值,不是“把一个模型换成另一个模型”这么简单,而是把 Claude Code 的工程化工作流,与 DeepSeek-V4 的模型能力真正接到一起。
一旦链路打通,你后面做的就不只是问答,而是补全、改代码、跑命令、读项目、做重构、查问题这一整套开发动作。

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