Claude Code 接入 DeepSeek：配置与费用

📍 文件与编程进阶：Claude Code

适用信息

• 适合谁：新手和中级
• 需要准备：装好 Claude Code（见安装教程）；DeepSeek 开放平台账号和 API Key，按用量付费
• 中国大陆能否直接用：能。Anthropic 不向中国大陆（含港澳）提供服务，Claude 官方账号用不了；这条路线不需要 Anthropic 账号，模型全部用 DeepSeek，是大陆读者用 Claude Code 的办法。另外两条路线见 TraeCode 和 DeepSeek Harness
• 核对日期：2026-09-26（Claude Code 2.1.283）；模型版本、价格、联网搜索收费和关闭办法核对于 2026-10-19（Claude Code 2.1.303），联网搜索开始收费的日子 2026-11-02 复查过

这篇适合已经装好 Claude Code、希望使用 DeepSeek API 的读者。 API 是供程序调用模型的接口；它与免费聊天入口是两种服务，不要把「网页聊天免费」理解为「在 Claude Code 中也免费」。

如果只是想开始用 AI，先走免费新手路线。如果你已经有可用的 Claude 或组织服务，可以跳过本篇，直接做第一次文件任务。在中国大陆，Claude 官方账号用不了，这篇就是你用 Claude Code 要走的一步。

本文于 2026 年 9 月 26 日核对官方文档与配置示例，2026 年 10 月 19 日又核对了模型版本、价格和联网搜索的收费；未调用付费 API，也未完成大陆网络和新账户的现场测试。能否登录、连接速度与实际支出，应由你的运行结果和账单确认。

先确认三个前提

1. claude --version 能显示版本号；还不能运行，先看安装教程。
2. 可以访问 DeepSeek 开放平台，并有自己可用的 API Key 和账户额度。还没有的，按下面三步准备（按钮名称以平台页面为准）：
   • 登录（或注册）DeepSeek 开放平台；
   • 在充值页面先充一小笔，够跑几次练习就行；
   • 在 API Keys 页面创建 Key，马上复制，存进密码管理器。离开页面后就看不到完整的 Key 了，丢了只能新建一个。
3. 知道这次模型请求会发给 DeepSeek，练习使用虚构或允许交给该服务处理的材料。

DeepSeek 提供 Claude Code 官方接入说明，因此我们以它核对模型端点和参数。安装方法与系统要求另以 Claude Code 自己的安装文档为准，两家文档的安装部分可能存在更新时差。

环境变量完整配置

环境变量是传给程序的一组名称和值。在下面的方式中，它们只作用于当前终端，以及从这里启动的程序；不会自动传给所有已打开的应用。

先新开一个终端窗口。若电脑已有公司配置、其他服务或长期保存的凭据，先确认配置归属，不要把几套 Key 与服务地址混在一起。下面不修改 shell 启动文件，也不把 Key 写进项目。

Mac／Linux

先单独运行这一行，粘贴自己的 DeepSeek API Key，按回车。输入不回显，也不把 Key 作为命令文字写进 shell 历史：

read -r -s ANTHROPIC_AUTH_TOKEN

接着运行：

export ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
export CLAUDE_CODE_EFFORT_LEVEL="max"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

Windows PowerShell

先单独运行第一行，在提示出现后输入 Key：

$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new("", (Read-Host "DeepSeek API Key" -AsSecureString)).Password

再运行其余配置：

$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_MODEL = "deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL = "deepseek-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL = "max"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW = "786432"

模型名含方括号，保留引号。上述值按本次核验的 DeepSeek 接入页填写；不要把旧教程的模型名和新参数拼成另一套配置。

关闭这个终端及由它启动的程序后，这一轮临时设置不会保留到新终端。验证成功后，再按个人或组织的凭据管理方式决定是否长期保存。隐藏输入只避免屏幕回显和命令历史记录，不代表进程中的 Key 已加密存放。

每组变量负责什么

变量	这次配置的作用
ANTHROPIC_BASE_URL	指向 DeepSeek 的 Anthropic 格式兼容入口
ANTHROPIC_AUTH_TOKEN	提供 DeepSeek API Key，不是 Claude 账号密码
ANTHROPIC_MODEL	设置主会话使用的模型
ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL	显式指定这些模型别名对应的实际模型
CLAUDE_CODE_SUBAGENT_MODEL	指定子任务代理使用的模型
CLAUDE_CODE_EFFORT_LEVEL	设置思考力度；此处沿用官方示例，不表示所有任务都应追求最高力度
CLAUDE_CODE_AUTO_COMPACT_WINDOW	调整自动压缩上下文的窗口设置；新手先保留官方示例值

[1m] 是 Claude Code 的长上下文标记，不是另一款 DeepSeek 模型。别名设置和上下文行为还应结合 Claude Code 模型配置说明理解。

先验证一个小任务

在刚才配置的同一个终端进入新建的空练习目录，按第一次任务启动手动确认模式，完成 draft.txt 的生成与读取。

验证分三步：

• 程序能启动：只证明工具可运行，还不能说明模型连接成功。
• 小任务完成：实际生成并读回了预期文件，说明这次请求和文件操作完成。
• 提供方用量有记录：去 DeepSeek 后台核对对应时间的模型与费用，确认账单归属。

不要让模型自报「我是什么模型」作为唯一证据。界面名称、模型别名和服务端映射可能不同。

不要运行会输出全部环境变量的命令来分享报错。求助时提供版本、服务地址、模型名和脱敏后的错误文字，遮住 Key；Key 泄漏后应在提供方后台撤销并重新生成，仅删除截图或加入 .gitignore 不足以撤回泄漏。

DeepSeek 的模型怎么选

本次核验中，官方价目表列出以下两条模型线：

API 模型名	官方当前对应版本	本篇怎么使用
deepseek-flash	DeepSeek-V4.1-Flash-1017	作为本文配置示例的主模型
deepseek-v4-pro	DeepSeek-V4-Pro-0813	有明确比较需求时再单独测试，按自己的结果和费用判断

2026-10-17，DeepSeek 把 deepseek-flash 背后的模型从 V4.1 Flash 更新为 V4.1-Flash-1017 版本，模型名和单价都没变，上面的配置不用改。（官方更新日志）

旧名称 deepseek-v4-flash 仍被接受，但官方说明其请求现在由 DeepSeek-V4.1-Flash-1017 服务，按 Flash 计费。因此旧名称能运行，不代表仍在使用旧版模型。模型与价格说明

还有一个容易误解的地方：DeepSeek 兼容服务会把收到的部分 Claude 模型名映射到自己的模型。官方说明 claude-opus 前缀对应 V4 Pro，claude-sonnet 和 claude-haiku 前缀对应 Flash；不是在 DeepSeek 账单里购买 Claude。服务端模型映射

本文把几个常见别名显式设成 Flash，是为了让示例选择清楚。不要只为「更强」就切模型；先保留同一份材料和验收标准，再比较是否改善了结果。若更换主模型，也要检查子任务和别名是否仍指向原来的模型。

成本怎样看，为什么不写固定月费

Token 是模型计量文本的单位，与中文字数并非固定一一对应。输入、输出、输入缓存是否命中，以及当前模型和计费时段，都会影响费用。缓存命中，指这次请求开头和之前发过的内容相同、服务端可以直接复用的那部分，单价低得多。

截至 2026-10-19，DeepSeek 的中文价目表按人民币／百万 Token列价，英文价目表按美元／百万 Token列价。人民币价是中文价目表直接标的，不是拿美元价按汇率换算出来的。以下只列高峰单价，方便核对字段；实际扣费和时段规则以现行价目表与账户账单为准：

模型	计费项	人民币（中文价目表）	美元（英文价目表）
deepseek-flash	输入（缓存命中）	0.04 元	$0.006
deepseek-flash	输入（缓存未命中）	2 元	$0.30
deepseek-flash	输出	8 元	$1.20
deepseek-v4-pro	输入（缓存命中）	0.30 元	$0.044
deepseek-v4-pro	输入（缓存未命中）	9 元	$1.32
deepseek-v4-pro	输出	27 元	$3.96

高峰时段是北京时间周一至周五（不含中国法定节假日）9:00–12:00 和 14:00–18:00，也就是 UTC 01:00–04:00 和 06:00–10:00。其余时间，包括周末和法定节假日全天，都是闲时，价格是高峰的一半。在海外的读者，按自己所在的时区换算，不要用自己这边的「晚上」直接推算。

粗算方式是：分别用这三类 Token 数除以一百万、乘对应单价，再相加。一个代理任务可能读多次材料、调用多次模型，不能只数自己发出的一句话。DeepSeek 接入说明还指出，联网搜索会产生额外模型请求和 Token 费用；搜索本身从 2026-11-01 起也要按次收费，见下面一节。联网搜索计费说明

第一次可先记录一次小任务的模型、时间、输入输出用量和实际扣费，连续观察几种自己的任务后再定预算。费用比较要用同类任务和实际账单，不能从一个人的单次结果推算所有人的月费。

联网搜索：北京时间 2026-11-01 起另外按次收费

Claude Code 遇到需要查网上资料的问题时，模型会自己决定要不要调用 WebSearch（联网搜索）工具；接的是 DeepSeek，这些搜索就由 DeepSeek 的搜索服务来做。DeepSeek 在 2026-10-17 的公告里说：在 Claude Code、Codex 和 DeepSeek Harness 里用 DeepSeek API 时，已经会用到它的 Search（搜索）和 Fetch（抓取网页）两个接口，这部分原来不收费，北京时间 2026-11-01 00:00 起按次收费（2026-11-02 复查：官方价目页上「目前未计费」那半句还没删，开始的日子没变）。（官方公告；这次更新对 App、API、Harness 用户各有什么影响，见 DeepSeek 换新版那篇）

一次大概多少钱：截至 2026-10-19，中文价目表写的是 Search、Fetch 各「每 1,000 次成功请求」5 元（英文价目表是 $0.75），也就是每次成功请求 0.005 元，100 次成功请求 0.5 元。按官方的计费说明，只有成功并且有结果的请求才计费，失败、没搜到、超时都不计费。不过搜到的内容还要交给模型去读、去总结，这部分照常按 Token 计费，所以一次搜索的总花费不止 0.005 元。另外，Claude Code 的文档写着它的一次搜索在后台最多会查 8 次；接 DeepSeek 时一次搜索按几次请求计费，官方没有写，11 月以后以自己的账单为准。

不想让它上网查资料，用 Claude Code 自己的权限设置就能关（官方说明）：

• 搜之前先问你：在手动确认模式（界面上显示 Manual）下，Claude Code 联网搜索之前会先问你，不同意就不会搜；但如果你在这个项目里选过「Yes, and don’t ask again」（以后不再问），或者设置里允许了 WebSearch，以后就不问了。新版 Claude Code 不加参数启动时默认是自动模式（auto），接 DeepSeek 时 auto 大概率用不了，会从 Manual 开始，以状态栏显示为准；照第一次任务的办法启动，就是手动确认模式。在自动模式下或者跳过权限确认时，搜之前不一定会问。
• 只关这一次：启动时加一个参数，把搜索和抓取网页两个工具一起关掉，只对这一次启动有效：

claude --disallowedTools "WebSearch,WebFetch"

• 一直关着：在设置文件 ~/.claude/settings.json（Windows 上是用户目录下的 .claude\settings.json）里写上下面这段。文件里原来已经有内容的，不要整个覆盖：已经有 permissions 的，把 "WebSearch", "WebFetch" 加进它的 deny 列表（没有 deny 就在 permissions 里加上这一行）；没有 permissions 的，把这一段加在最外层的大括号里。各项之间用英文逗号隔开，最后一项后面不要多打逗号，格式写错了 Claude Code 下次启动会报设置错误：

{
  "permissions": {
    "deny": ["WebSearch", "WebFetch"]
  }
}

为什么建议连 WebFetch（抓取网页）也一起关：按 Claude Code 的文档，WebFetch 是在你自己的电脑上把网页取回来，再另起一次模型调用提炼要点（这一次按 Token 计费）；照这个说法，它不经过 DeepSeek 的 Fetch 接口。但 DeepSeek 的公告只笼统地说在 Claude Code 里会用到 Search 和 Fetch，没说是哪个工具触发的。两个一起关最不容易漏；想保留读网页的能力，也可以只关 WebSearch，11 月以后看账单再定。关掉以后 Claude Code 就不能用这两个工具上网查资料，需要时再删掉这条设置。本站在 Claude Code 2.1.303 上试过这两种写法（让 Claude Code 连本机一个模拟的服务地址，没有连真实的 DeepSeek 服务）：设置生效后，它发给模型的请求里就不再带这两个工具了，和官方文档写的一致。

接入成功，不代表所有功能都一样

兼容接口有明确的支持范围。当前官方资料显示，Flash 支持图片输入，V4 Pro 的模型表则标为不支持；「DeepSeek API 完全不能看图」的旧说法已经不适用。模型能力表

DeepSeek 的 Anthropic 兼容表也区分了图片、文档和工具相关消息类型，并非所有字段都支持。读取文字文件、直接发送 PDF 文档块、分析图片、操作屏幕是不同能力，不能从其中一项推导出全部可用。处理真实文件前，应先用小样本检查所选模型、客户端和文件格式这条完整链路。接口兼容详情

模型请求仍会经网络发送。Claude Code 自身也可能有更新、遥测等连接；设置模型地址不等于把程序变成离线工具。还有一处不管接哪家模型都会连 Anthropic：WebFetch（抓取网页的工具）访问网址前，会先把域名发给 api.anthropic.com 做安全检查，这个地址连不上时抓网页就会失败，处理办法见下面的排错表。需要调整这些行为时查看 Claude Code 数据与网络说明，不要为排错关闭证书校验或把「禁用遥测」理解成「资料不会发送」。

常见问题与坑

现象	检查顺序
关掉终端后配置消失	本文使用临时变量；重新配置，确认成功后再决定长期保存方式
认证失败或仍进入别的登录流程	检查当前终端的服务地址、凭据来源和原有设置是否冲突，不公开打印 Key
模型结果与预期不符	检查主模型、别名、子任务设置及提供方用量记录，不只看界面名称
余额不足	查 API 账户状态，不拿聊天会员或免费聊天额度代替
超时、繁忙或限流	记录报错和时间，参考提供方状态与错误说明，避免连续重复提交同一任务
内容截断或任务越来越慢	先缩小文件和任务范围，再核对模型、上下文与输出限制，不盲目抬高参数
文字任务成功，图片或 PDF 失败	查具体模型能力及兼容消息类型，不能以文字请求成功证明其他类型也支持
文字任务正常，只有抓取网页失败	可能是连不上 api.anthropic.com，WebFetch 的安全检查没通过。可以在设置文件（如 ~/.claude/settings.json）里加 "skipWebFetchPreflight": true 关掉这项检查；关掉后，再用 WebFetch 权限规则限制它能访问哪些网站。官方说明

Claude Code 配置有用户、项目和组织等不同层级；已有环境中出现冲突，先查看配置来源与优先级，再按官方排障处理。

不想用 DeepSeek？

先看你的现有工具能否完成任务。若确实要更换提供方，应从对方官方接入文档确认 Claude Code 支持情况、账户条件、端点、模型名与价格，不能假定「随便换三个变量」就有完整兼容性。

公司已提供服务时先沿用组织配置；想免费学习日常用法，回到聊天练习。选择服务的目的，是让任务顺利完成，而不是凑齐所有模型账号。

装好了，下一步看什么

• 第一次文件任务：在新练习目录完成一次读取、改写和核对。
• 读文件、改文件：逐步学习文件操作。
• 什么是 Claude Code：还不确定是否需要这个工具时，先判断任务。