把 DeepSeek 接进 Claude Code一次踩完所有坑的实战记录本文全程 Windows 11 PowerShell Node.js 24 实测通过每一步的结论都是真跑出来的不是照抄文档。如果你在 macOS / Linux 上只有路径和环境变量的写法不同思路完全一致。为什么要折腾这件事Claude Code 是我用过最顺手的终端编程助手它不跟你聊天它直接读你的项目、改你的文件、跑你的命令。但它有两个门槛官方账号要付费订阅而且价格不便宜。DeepSeek 则便宜得多。问题在于Claude Code 只认 Anthropic 自己的 API 协议而 DeepSeek 是 OpenAI 协议——两边对不上。常见的解法是装个第三方代理LiteLLM、claude-code-router 之类把协议翻译一遍。但那意味着你要多维护一个进程多一个出错环节。实际上这个方案已经过时了。DeepSeek 官方直接提供了 Anthropic 协议兼容端点https://api.deepseek.com/anthropic不用任何中间层改一行 URL 就能直连。这是本文要讲的核心。急着用先看这份最终配置如果你只想拿到结果把下面这份 JSON 原样抄进配置文件即可第三节会告诉你文件建在哪{env:{ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,ANTHROPIC_AUTH_TOKEN:sk-你的密钥,ANTHROPIC_MODEL:deepseek-flash[1m],ANTHROPIC_DEFAULT_OPUS_MODEL:deepseek-flash[1m],ANTHROPIC_DEFAULT_SONNET_MODEL:deepseek-flash[1m],ANTHROPIC_DEFAULT_HAIKU_MODEL:deepseek-flash,CLAUDE_CODE_SUBAGENT_MODEL:deepseek-flash,CLAUDE_CODE_EFFORT_LEVEL:max,CLAUDE_CODE_AUTO_COMPACT_WINDOW:786432,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1}}别急着复制就走。这里面有个坑配置了但不知道的话你会用几倍的价格跑着本该很便宜的任务。第四节专门讲它建议至少把那一节看完。第一步安装 Claude Code前置条件很简单Node.js 18 以上Windows 用户另外需要Git for Windows。检查一下node-v git--version两条都能正常输出版本号就行。然后安装npm install-g anthropic-ai/claude-code装完验证claude--version# 2.1.310 (Claude Code)坑 1claude敲出来「不是内部或外部命令」这是新手第一个绊脚石。npm 装成功了但终端找不到命令。原因是你装 Claude Code 的那个 npm它的全局目录不在 PATH 里。这在你装了多个 Node 版本时特别常见——比如你用 nvm、Volta、或者某个 IDE 自带的 Node通过哪个 Node 装的包命令就落在哪个 Node 的目录里而 PATH 里优先的可能恰好是另一个。查清楚装到哪了npm prefix-g把这个命令输出的路径和你的 PATH 对比一下$env:PATH-split;如果它不在里面有两个办法一是把该路径加进 PATH二是切到你 PATH 里的那个 Node 重装一遍# 用绝对路径指定 node 同目录的 npm 重装C:\你的Node安装目录\npm.cmdinstall-g anthropic-ai/claude-code我推荐后者。PATH 里塞太多路径容易打架不如让命令直接落在已经在 PATH 的目录里。第二步拿 DeepSeek 密钥去 https://platform.deepseek.com/api_keys 创建一个拿到一串sk-开头的密钥。两个提醒API 余额和网页会员是两回事。充了网页端的会员不等于 API 有额度用之前先去确认账户余额。密钥是全权凭证不要写进任何要提交到 Git 的文件里。本文的配置路径在你的用户目录下不会被项目感知到这是安全的。第三步写配置文件Claude Code 支持两种配置方式环境变量或者配置文件。我推荐配置文件。原因是环境变量只对当前终端窗口有效新开一个窗口就得重设一遍而配置文件是持久的并且终端 CLI 和 VS Code 插件都能读到同一份改一次两处生效。配置文件路径系统路径WindowsC:\Users\你的用户名\.claude\settings.jsonmacOS / Linux~/.claude/settings.json这个文件默认不存在用记事本或 VS Code 新建即可。把开篇那份 JSON 填进去把密钥换成你自己的保存。别用环境变量做临时修改。我实测过settings.json的优先级高于系统环境变量。你在终端里临时$env:ANTHROPIC_MODEL xxx覆盖是无效的配置文件里的值始终胜出。想改模型老实改配置文件。坑 2PowerShell 拒绝执行claude兴冲冲敲下claude红了UnauthorizedAccess ... 无法加载文件 ...claude.ps1 ... 在此系统上禁止运行脚本原因npm 装全局命令时会生成三份启动器——claude给类 Unix shell、claude.cmd给 CMD、claude.ps1给 PowerShell。PowerShell 优先选中.ps1而 Windows 默认的 PowerShell 执行策略是Restricted禁止运行一切脚本文件。修复把当前用户的执行策略放开一档Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned-Force这个命令不需要管理员权限CurrentUser作用域只影响你自己。为什么是RemoteSigned而不是Unrestricted前者允许本地脚本自由运行但要求从网上下载的、带着「远程来源」标记的脚本必须有数字签名——安全性基本够用。后者则是来者不拒没必要为了一个 CLI 把门拆了。改完立即生效不用重启。验证一下claude--version第四步五个模型槽位一个都不能漏这是本文最重要的一节也是最容易被忽略的一环。Claude Code 不是所有请求都发给同一个模型。它内部开了五个「模型槽位」默认档、Opus 档最强、Sonnet 档、Haiku 档最快以及子 agent 单独一档。不同的活投向不同的槽位。如果你只设置了ANTHROPIC_MODEL会发生什么DeepSeek 后端有一条模型名映射规则Claude Code 发出的模型名DeepSeek 映射到计费档位claude-opus开头deepseek-v4-proPro 价贵claude-haiku/claude-sonnet开头deepseek-flashFlash 价便宜也就是说你没显式配置的那些槽位Claude Code 会按原名发过去其中 Opus 槽会被静默映射成deepseek-v4-pro并按 Pro 价格计费。这件事的可怕之处在于它不会报错不会有任何提示任务照常完成一切看起来都很正常——只是你的钱在按几倍的速度烧。V4 Pro 的单价是 Flash 的数倍而你可能全程以为自己在用便宜的那个。解法就是开篇那份配置把五个槽位全部显式钉死。缺一个都不行。顺带说明两个配置细节[1m]后缀照抄。这是 DeepSeek 官方推荐写法里带的标记。我实测过带后缀和去掉后缀两边都能正常跑通。既然官方给的是这个写法照抄最稳妥——省掉它换不来任何收益反而可能丢掉官方预留的语义空间。CLAUDE_CODE_EFFORT_LEVELmax费 token。它让模型愿意花更多轮次思考效果最好代价是消耗明显更高。跑长任务觉得烧钱快就把这行删掉或改成medium。第五步验证链路真的通了先测网络能不能到try{Invoke-WebRequest-Urihttps://api.deepseek.com/anthropic/v1/messages-Method POST -Headers {x-api-keysk-invalid;anthropic-version2023-06-01;content-typeapplication/json}-Body{model:deepseek-flash,max_tokens:1,messages:[{role:user,content:hi}]}-TimeoutSec 25-UseBasicParsing}catch{$_.Exception.Response.StatusCode}返回401就是对的——我故意用了无效密钥401 说明请求到达了 DeepSeek、路径正确、鉴权模块正常拒绝了它。如果是超时或 DNS 错误那才是网络问题。然后测真实对话claude-p回复一句话证明你能正常工作--output-format text-p是单次问答模式跑完就退出不适合聊天适合做验证和脚本集成。看到中文回复就全部打通了。坑 3那条unrecognized_model报错可以直接无视你大概率会看到这么一行混在输出里[claude-code:unrecognized_model] {model:deepseek-flash[1m],query_source:sdk}这是无害的不用管。我专门排查过一开始怀疑是[1m]后缀的锅去掉后缀重跑报错照样出现。真相是 Claude Code 内置的模型清单里根本没有 DeepSeek 的任何名字它对所有deepseek-*都会报这条——和后缀无关。它唯一的实际影响是Claude Code 内部按 Claude 官方价格估算的费用数字不准/status里看到的花费别当真。想看真实花费去 DeepSeek 后台看用量。请求照发、回答照回功能完全不受影响。别为了消掉这条报错去乱改模型名消不掉的。日常怎么用交互式主要用法cd D:\你的项目目录 claude一定要先cd到项目根目录。Claude Code 把当前工作目录当作它的工作范围目录错了就改错地方。第一次进某个目录会问你信不信任选 Yes。然后用自然语言下需求就行中文完全可以。强烈推荐在 VS Code 的集成终端里跑Ctrl打开。它改了哪个文件、改了什么左边编辑器立刻能看到 diff比在独立终端里盲改踏实得多。如果你不习惯终端官方还有 VS Code 插件侧边栏图形界面读的是同一份settings.json配置直接生效。几个常用命令命令作用/status看当前端点、模型、用量——确认是不是指向 DeepSeek/model切换模型/help全部命令Esc打断它正在做的事单次问答不进交互界面适合脚本里调用claude-p解释一下这个项目的入口文件写在最后整个方案最让我意外的是它居然不需要任何第三方代理。DeepSeek 直接实现了 Anthropic 协议兼容把原本需要一层中间件的事压缩成了「改一行 URL」。回过头看真正花时间的不是配置本身而是那些文档不会告诉你、配错了又不报错的细节五个模型槽位只填了默认那一个、其余留空会静默按高价计费、执行策略会拦住 npm 生成的.ps1、那条报错其实可以无视。这些坑每一个都能卡住半小时。希望这篇能帮你省下来。如果你的 Node 环境与文中不同npm prefix -g的结果不在 PATH 里记得先按「坑 1」处理然后再往下走。本文基于 Claude Code 2.1.310 实测。DeepSeek 的旧模型名deepseek-chat/deepseek-reasoner已于 2026 年 7 月弃用当前请用deepseek-flash/deepseek-v4-pro。
