Claude Code 接 DeepSeek 完整教程
两条命令让 Claude Code 跑在 DeepSeek 上。先说一个很多旧教程里的坑:deepseek-chat 这个模型名,DeepSeek 公告的停用日期是 2026-07-24,如今已经过了,价格页也不再列出它;现在用 deepseek-flash(单价低)或 deepseek-v4-pro(规模更大、也更贵)。这篇还把 DeepSeek 的峰谷价格和 Claude 的标价放在一起比了一下。
命令取自 Magpie 官网的命令行示例,模型名与价格引自 DeepSeek 官方文档,核对于 2026-10-27。
两条命令,加一条确认
magpie provider add deepseek 你的key # 添加 DeepSeek 供应商
magpie claude deepseek/deepseek-flash # 单价低的 Flash
magpie claude deepseek/deepseek-v4-pro # 或者规模更大的 Pro(二选一)
magpie ls # 确认 Claude Code 当前用的模型
切换后,下一个 Claude Code 会话开始使用 DeepSeek。旧教程里的 deepseek-chat 已过官方停用日期,别照抄。
开始之前
- Magpie 已安装。终端里运行
magpie ls,能列出本机的 Agent 就说明装好了。还没装?先看安装教程(英文)。 - Claude Code 已安装。如果
magpie ls的列表里没有它,先启动一次 Claude Code,让它写出自己的配置文件,再重新运行magpie ls——Magpie 只显示已安装或已配置的 Agent。 - 一个 DeepSeek API key。在 DeepSeek 开放平台创建;费用从账户的充值余额或赠送余额里扣,所以账户里要有余额。
先看清模型名:deepseek-chat 已过停用日期
不少旧教程里写的是 magpie claude deepseek/deepseek-chat。DeepSeek 的更新日志(2026-04-24)写明:旧模型名 deepseek-chat 和 deepseek-reasoner 将于 2026-07-24 停用,过渡期内它们分别指向 deepseek-v4-flash 的非思考与思考模式。如今的价格页只列两个模型名:
| 模型名 | 对应版本 | 上下文 / 最大输出 |
|---|---|---|
deepseek-flash | DeepSeek-V4.1-Flash-1017 | 1M / 384K |
deepseek-v4-pro | DeepSeek-V4-Pro-0813 | 1M / 384K |
旧写法 deepseek-v4-flash 仍被接受,但对应的模型已退役,请求会由 V4.1 Flash 处理并按 Flash 价格计费。DeepSeek 的 Anthropic 接口文档还写明:不支持的模型名(不以 claude 开头)会返回 400 错误。
四步操作
-
添加 DeepSeek 供应商
magpie provider add deepseek 你的keyDeepSeek 在 Magpie 里是内置预设,供应商 id 就是
deepseek,只需要提供 key;接口地址和支持的协议,预设里已经记好。添加之后验证一下:magpie providers # 已添加的供应商、key、可用模型、谁在用 magpie provider test deepseek # 每种 API 各发一次小请求,并报告延迟key 必须在 Magpie 里添加。Magpie 不会读取 shell 里 export 的ANTHROPIC_API_KEY、OPENAI_API_KEY等环境变量——这是刻意的设计。 -
确认有哪些 DeepSeek 模型
magpie provider models deepseek # 重新向厂商拉取模型列表 magpie models # 所有 Agent 能选到的模型目录列表里应该有
deepseek-flash和deepseek-v4-pro,以你这里的实际输出为准。 -
把 Claude Code 指向 DeepSeek
magpie claude deepseek/deepseek-flash # 单价低的 Flash # 或者换成规模更大的 Pro: magpie claude deepseek/deepseek-v4-pro二选一,之后想换随时重新执行即可。模型统一写成
供应商/模型。为什么 Claude Code 能直接用 DeepSeek:DeepSeek 自己提供 Anthropic 格式的接口(
https://api.deepseek.com/anthropic),两个模型都支持;Magpie 的网关负责在 Claude Code 与 DeepSeek 之间转发,必要时做协议转换,你不用自己设环境变量。 -
确认并开始用
magpie ls # 每个 Agent 以及它当前用的模型看到 Claude Code 用的是 DeepSeek 之后,新开一个 Claude Code 会话,它就跑在 DeepSeek 上了——官方的说法是「下一个会话使用它」。
成本:DeepSeek 与 Claude 的标价对比
下面是各家官网的按量标价,单位是美元 / 每百万 token。DeepSeek 分高峰和低谷两档,低谷价是高峰价的一半。
DeepSeek(官方价格页,核对于 2026-10-27)
| 模型 | 时段 | 输入(缓存命中) | 输入(缓存未命中) | 输出 |
|---|---|---|---|---|
deepseek-flash | 高峰 | $0.006 | $0.30 | $1.20 |
| 低谷 | $0.003 | $0.15 | $0.60 | |
deepseek-v4-pro | 高峰 | $0.044 | $1.32 | $3.96 |
| 低谷 | $0.022 | $0.66 | $1.98 |
Claude 参照(Anthropic 官方价格页,核对于 2026-10-27)
| 模型 | 输入 | 缓存读取 | 输出 |
|---|---|---|---|
| Claude Sonnet 5.5 | $2.00 | $0.10 | $10.00 |
| Claude Opus 5.5 | $4.00 | $0.20 | $20.00 |
| Claude Haiku 5.5 | $0.10 | $0.01 | $0.50 |
Haiku 5.5 的价格适用于 100K token 以内的提示词;超过 100K 的请求按更高价格计费:输入 $0.50、缓存读取 $0.05、输出 $2.50。
- 高峰与低谷。高峰是 UTC 周一至周五 01:00–04:00 和 06:00–10:00(中国法定节假日除外),换算成北京时间是工作日的 09:00–12:00 和 14:00–18:00;其余时间,包括周末和中国法定节假日全天,都按低谷价。
- 和 Claude Sonnet 5.5 的标价比。以 Sonnet 5.5 为 100%:deepseek-flash 的输出价约 6%–12%、未命中输入价约 7.5%–15%;deepseek-v4-pro 的输出价约 20%–40%、未命中输入价约 33%–66%(区间两端分别是低谷价与高峰价)。
- 别只看单价。Claude Haiku 5.5 的输入价(未命中)和输出价都比 deepseek-flash 低,只有缓存命中价是 deepseek-flash 更低($0.003–$0.006,Haiku 5.5 是 $0.01),所以「DeepSeek 一定最便宜」并不成立。真正该比的是把同一个任务做完花了多少钱:要几轮、读多少上下文、缓存命中率有多高。
- 订阅用户不适用。上面只对按量付费有意义;Claude 订阅(Pro / Max)按月收费,不按 token 计价。
- 搜索 / 抓取另计。DeepSeek 价格页注明:通过 Claude Code 使用 DeepSeek API 时,服务端的搜索与抓取工具调用目前免费,从北京时间 2026-11-01 00:00 起按每千次成功请求 $0.75 计费。
- 价格会变。DeepSeek 页面写明「Product prices may vary and DeepSeek reserves the right to adjust them」。下单前以 DeepSeek 价格页和 Anthropic 价格页为准。
- 让 Magpie 按真实单价统计。用
magpie model price把价格录进去,用量台账就按你填的价格统计,规则见配置指南的 Telling Magpie what a model costs 一节(英文)。
它到底改了什么
这几步涉及的文件主要是两个:
| 文件 | 内容 |
|---|---|
~/.config/magpie/providers.json | Magpie 自己的状态:你添加的供应商、key、每个供应商暴露哪些模型。第 1 步写入这里。 |
~/.claude/settings.json | Claude Code 的配置。第 3 步只改 Magpie 文档列出的字段:provider、model,以及 opus / sonnet / haiku / fable 这几个模型别名。注释、键顺序和缩进原样保留,写入是原子操作。 |
Windows 上 Claude Code 的配置在用户目录下的 .claude\settings.json。
Claude Code 的配置里不会出现 DeepSeek 的 key,也不会出现 DeepSeek 的接口地址:它只保存要用的模型和本机网关地址 http://127.0.0.1:3425/v1,真正的 key 在 Magpie 手里,请求由网关转发。
关于「模型别名」
Claude Code 用 opus、sonnet、haiku 这几个别名来选不同档位的模型。Magpie 官网的说法是:Kimi、GLM 或 GPT 可以放在这三个别名后面。具体每个别名被写成了什么,以你机器上的文件为准——切换前后各对比一次最直观:
macOS / Linux
cp ~/.claude/settings.json ~/claude-settings.before.json # 切换前先备份
magpie claude deepseek/deepseek-flash
diff ~/claude-settings.before.json ~/.claude/settings.json # 看 Magpie 实际改了哪几行
Windows(命令提示符)
copy %USERPROFILE%\.claude\settings.json %USERPROFILE%\claude-settings.before.json
magpie claude deepseek/deepseek-flash
fc %USERPROFILE%\claude-settings.before.json %USERPROFILE%\.claude\settings.json
对比输出里如果出现 token 或 key,贴到论坛或群里之前先打码。
回滚:怎么退回原来的模型
切换只是改配置,随时能退回。三种办法,从省事到保险:
办法一:在应用里选回原生模型
在 Magpie 的菜单栏应用里,点 Claude Code 当前显示的模型,选回它原生的模型。官网的说法是:选回原生模型,Magpie 会把文件恢复成切换之前的样子。
办法二:先存一个 Profile,用命令一次性恢复
magpie save before-deepseek # 切换之前执行:把所有 Agent 当前的设置存成一个方案
# …… 用了一阵之后想退回:
magpie use before-deepseek # 一次性把所有 Agent 恢复成当时的样子
Profile 保存的是执行 save 那一刻所有 Agent 的设置,所以一定要在切换之前存;每次实验换一个名字,别把最初的快照覆盖掉。
办法三:手动恢复备份
按上一节的方法,切换前把 settings.json 备份一份;要退回时把备份拷回原位就行。
想彻底删掉 DeepSeek 这个供应商:先用上面任一办法退回,再执行 magpie provider rm deepseek。
常见问题
我照别的教程用了 deepseek-chat,现在报错怎么办?
DeepSeek 更新日志(2026-04-24)写明,旧模型名 deepseek-chat 和 deepseek-reasoner 将于 2026-07-24 停用,价格页如今也只列 deepseek-flash 和 deepseek-v4-pro。把命令里的模型名换掉即可:magpie claude deepseek/deepseek-flash。具体有哪些可用,以 magpie provider models deepseek 的输出为准。
deepseek-flash 和 deepseek-v4-pro 怎么选?
先用 Flash:单价低,DeepSeek 的更新日志称它是新架构家族里最小的模型。遇到它做不好的任务,再切到 Pro(magpie claude deepseek/deepseek-v4-pro)。按官网标价,Pro 的输出价约是 Flash 的 3.3 倍,未命中输入价约 4.4 倍,命中输入价约 7.3 倍。两者来回切换只是重新执行一次命令,切换后新开会话即可。
高峰和低谷具体怎么算?
DeepSeek 把一天分成高峰和低谷两档,低谷价是高峰价的一半。高峰时段是 UTC 周一至周五 01:00–04:00 和 06:00–10:00(中国法定节假日除外),换算成北京时间就是工作日的 09:00–12:00 和 14:00–18:00;其余时间,包括周末和中国法定节假日全天,都按低谷价。
用量里为什么出现了搜索 / 抓取费用?
DeepSeek 价格页说明:通过 DeepSeek Harness、Claude Code 或 Codex 使用 DeepSeek API 时,服务端的搜索与抓取工具调用目前免费,从北京时间 2026-11-01 00:00 起按每千次成功请求 $0.75 计费。你的会话用到联网搜索或抓取时,请留意这一项。
切换之后 Claude Code 还是原来的模型怎么办?
先确认 magpie ls 里 Claude Code 对应的已经是 DeepSeek。官方说明切换后由「下一个会话」使用新配置,所以退出当前会话、新开一个再试。如果 magpie ls 里根本没有 Claude Code,说明 Magpie 还没发现它:先启动一次 Claude Code 让它写出配置文件,再重新打开 Magpie。
怎么判断是 key 有问题,还是接口有问题?
运行 magpie provider test deepseek。它对这家供应商支持的每种 API 各发一次小请求并报告延迟,能区分「key 不对」和「这家厂商没有你的 Agent 所说协议的接口」;后一种情况由 Magpie 的网关负责协议转换。
下一步
magpie provider models 的输出和各厂商官网为准。