平时做技术实践时,很多问题不是概念不会,而是细节没串起来。拿“在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-flashdeepseek-v4-prodeepseek-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 会更合适。
结合项目来看,以上就是在Claude Code中接入DeepSeek-V4的完整指南的详细内容,更多关于Claude Code接入DeepSeek-V4的资料请关注脚本之家其它相关文章!