在Claude Code中接入DeepSeek-V4的完整指南

Written by

in

文章目录
  • 根据 DeepSeek 官方文档,当前 DeepSeek-V4 体系至少包含两个核心模型: deepseek-v4-flash:偏向低延迟和高性价比,适合高频交互、日常编码补全、命令式协作。 deepseek-v4-pro:偏向更强的复杂推理与稳定输出,适合重构、疑难排障、长链路任务。 对 Claude Code 这类 Agent 型工具来说,模型是否支持稳定的 API 兼容模式非常关键。DeepSeek 官方已经提供兼容式接入能力,因此可以借助 cc-switch 以较低改造成本完成切换。
  • 在开始之前,默认你已经满足以下条件: 已安装 Claude Code 已安装 cc-switch 本机可以正常访问 DeepSeek 开放平台 如果以上环境已经具备,下面直接进入正式配置。
  • 先进入官方平台 完成注册,并充值少量余额即可开始测试。 DeepSeek 开放平台 DeepSeek API Keys 页面 获取keys 注册完成后,进入 API Keys 页面创建密钥。后续在 cc-switch 中配置 Provider 时,会直接用到这串 API Key。
  • 打开 cc-switch,进入 Claude Code Provider 配置界面,新增一个 Provider。 打开CC Switch 添加 Claude Code Provider 添加配置 这里的目标很明确:新增一条指向 DeepSeek 的模型通道,供 Claude Code 在运行时调用。
  • 在 Provider 类型中,选择 DeepSeek。 选择厂商模型 选择DeepSeek 这一步本质上是在告诉 cc-switch:后续请求将转发到 DeepSeek 的模型服务,而不是默认供应商。
  • 将刚才创建的 API Key 填入对应字段,同时勾选完整 URL 选项。 填写API Key 勾选完整URL 如果你所在的环境对网关、代理或兼容地址有额外要求,这一步通常也是最容易出错的位置,因此建议填完后再检查一遍。
  • 在高级配置中,将 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 的静态配置已经完成,接下来只差启用。
  • 在 Provider 列表中启用刚刚创建的 DeepSeek 配置。 启用Deepseek配置 启用之后,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 会更合适。 以上就是在Claude Code中接入DeepSeek-V4的完整指南的详细内容,更多关于Claude Code接入DeepSeek-V4的资料请关注风君子博客其它相关文章!
  • 目录
    • 为什么是 DeepSeek-V4
    • 前置条件
    • 第一步:注册 DeepSeek 账号并创建 API Key
    • 第二步:在 cc-switch 中新增 Claude Code Provider
    • 第三步:选择厂商为 DeepSeek
    • 第四步:填写 API Key,并启用完整 URL
    • 第五步:高级选项中选择 Anthropic Message(原生)
    • 第六步:配置模型映射
    • 第七步:保存配置
    • 第八步:启用 DeepSeek 配置
    • 第九步:在终端中启动 Claude Code 并切换模型
    • 第十步:做一次最小可用验证
    • 结语

    Claude Code 的价值,在于把代码理解、修改、执行和验证整合进同一条工作链路;而模型层的选择,决定了这条链路的响应速度、推理质量和成本结构。
    如果你已经在使用 Claude Code,又希望把底层模型切换到 DeepSeek-V4,这篇文章可以直接帮你完成配置。

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

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

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

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

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

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

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

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

    • DeepSeek 开放平台
    • DeepSeek API Keys 页面

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

    获取keys

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

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

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

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

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

    在 Provider 类型中,选择 DeepSeek

    第三步:选择厂商为 DeepSeek

    选择厂商模型 选择DeepSeek

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

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

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

    填写API Key 勾选完整URL

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

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

    第五步:高级选项中选择 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

    第六步:配置模型映射_图2

    deepseek-v4-flash

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

    第七步:保存配置

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

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

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

    第八步:启用 DeepSeek 配置

    启用Deepseek配置

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

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

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

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

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

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

     
    你好,我是谁?
    

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

    测试模型

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

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

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

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

    以上就是在Claude Code中接入DeepSeek-V4的完整指南的详细内容,更多关于Claude Code接入DeepSeek-V4的资料请关注风君子博客其它相关文章!

    站内搜索