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 已过官方停用日期,别照抄。

本页目录
  1. 开始之前
  2. 先看清模型名:deepseek-chat 已过停用日期
  3. 四步操作
  4. 成本:标价对比
  5. 它到底改了什么
  6. 回滚:怎么退回原来的模型
  7. 常见问题

开始之前

先看清模型名:deepseek-chat 已过停用日期

不少旧教程里写的是 magpie claude deepseek/deepseek-chat。DeepSeek 的更新日志(2026-04-24)写明:旧模型名 deepseek-chat 和 deepseek-reasoner 将于 2026-07-24 停用,过渡期内它们分别指向 deepseek-v4-flash 的非思考与思考模式。如今的价格页只列两个模型名:

模型名对应版本上下文 / 最大输出
deepseek-flashDeepSeek-V4.1-Flash-10171M / 384K
deepseek-v4-proDeepSeek-V4-Pro-08131M / 384K

旧写法 deepseek-v4-flash 仍被接受,但对应的模型已退役,请求会由 V4.1 Flash 处理并按 Flash 价格计费。DeepSeek 的 Anthropic 接口文档还写明:不支持的模型名(不以 claude 开头)会返回 400 错误。

四步操作

  1. 添加 DeepSeek 供应商

    magpie provider add deepseek 你的key

    DeepSeek 在 Magpie 里是内置预设,供应商 id 就是 deepseek,只需要提供 key;接口地址和支持的协议,预设里已经记好。添加之后验证一下:

    magpie providers                # 已添加的供应商、key、可用模型、谁在用
    magpie provider test deepseek   # 每种 API 各发一次小请求,并报告延迟
    key 必须在 Magpie 里添加。Magpie 不会读取 shell 里 export 的 ANTHROPIC_API_KEY、OPENAI_API_KEY 等环境变量——这是刻意的设计。
  2. 确认有哪些 DeepSeek 模型

    magpie provider models deepseek   # 重新向厂商拉取模型列表
    magpie models                     # 所有 Agent 能选到的模型目录

    列表里应该有 deepseek-flash 和 deepseek-v4-pro,以你这里的实际输出为准。

  3. 把 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 之间转发,必要时做协议转换,你不用自己设环境变量。

  4. 确认并开始用

    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。

它到底改了什么

这几步涉及的文件主要是两个:

文件内容
~/.config/magpie/providers.jsonMagpie 自己的状态:你添加的供应商、key、每个供应商暴露哪些模型。第 1 步写入这里。
~/.claude/settings.jsonClaude 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 的网关负责协议转换。

下一步

查看全部中文教程 →

usemagpie.co 是 Magpie 的非官方第三方中文指南,与项目作者 yetone 没有隶属关系。Magpie 是 MIT 协议的开源项目,官网是 usemagpie.ai,官方安装包发布在 GitHub Releases。本文的命令取自官网的命令行示例和本站的配置指南,模型名与价格类信息核对于 2026-10-27,之后版本可能变化——请以 magpie provider models 的输出和各厂商官网为准。