1. 为什么要在 Windows 上用 DeepSeek 驱动 Claude Code1.1 Claude Code 的模型接入机制Claude Code 是 Anthropic 出品的命令行编程代理装好之后就是一个终端里的结对程序员你给它一个需求它能自己读代码、改文件、跑命令甚至批量重构。很多人在 macOS 和 Linux 上把它用得很顺手但一换到 Windows教程就断档了——大部分资料默认你用的是 bash默认你装好了 Node.js默认你知道~/.claude/settings.json在哪。先别急着去搜各种一键脚本我们要先搞清楚 Claude Code 的模型是怎么接进来的。它虽然叫 Claude Code但它不是一坨写死的二进制。它启动时会读几个关键环境变量ANTHROPIC_BASE_URL决定请求发到哪个地址ANTHROPIC_API_KEY决定用谁的密钥ANTHROPIC_MODEL决定调哪个模型。换句话说Claude Code 只是个壳真正干活的是后端的大模型。只要后端服务能听懂 Anthropic 的消息格式你完全可以换个模型驱动它。1.2 DeepSeek 的 Anthropic 兼容层DeepSeek 开放平台官方提供了一个 Anthropic API 兼容端点地址是https://api.deepseek.com/anthropic。这个端点实现了 Claude Code 默认使用的消息协议所以不需要任何中间转发层也不需要在本地跑额外的代理程序。简单说Claude Code 以为自己在对 Anthropic 说话实际上对面接的是 DeepSeek。这一点非常关键。市面上很多教程会教你用各种本地网关、模拟服务去骗过 Claude Code但在 Windows 上这些方案往往依赖 Docker 或者 WSL折腾一圈下来配置复杂度反而超过了工具本身能带来的收益。而 DeepSeek 的兼容层是官方提供的你只需要改四个环境变量就完成了替换。为什么有人愿意这么干最直接的原因是成本。Claude Code 这类代理工具在工作时和普通聊天不一样它会反复把整个项目上下文、文件内容、工具结果塞给模型Token 消耗非常大。如果把后端换成 DeepSeek单次请求的成本会低一个数量级长会话挂机也不心疼。对个人开发者、小团队以及有模型自主可控要求的场景来说这是个很有吸引力的方案。1.3 什么样的人适合看这篇文章这篇内容适合三类人想省钱的独立开发者已经把 DeepSeek 作为团队模型底座、希望所有工具都统一走 DeepSeek 接口的工程团队以及单纯想在 Windows 上把 Claude Code 跑起来、又不想绑定 Anthropic 账号的折腾型玩家。我会从最基础的 Node.js 安装开始讲一直讲到settings.json里的每一个字段最后再给一份踩坑清单。Windows 的环境变量语法和 bash 不一样文件路径也和 macOS 不同这些我都会标注清楚。你不需要有很深的运维经验照着一步步来就行。2. Windows 环境准备从零安装2.1 安装 Node.jsClaude Code 是 Node.js 写的所以第一件事是装 Node.js。建议装 LTS 版本需要 18 以上我建议直接上 20 或 22。Windows 下最简单的做法是打开 PowerShell执行winget install OpenJS.NodeJS.LTS装完以后新开一个终端窗口验证一下node -v npm -v两个命令都能输出版本号说明环境正常。如果 winget 不可用也可以去 Node.js 官网下载 Windows 安装包一路点下一步就行。安装包会自动把node和npm加进系统 PATH省去后面手动配置的麻烦。有个 Windows 特有的小坑如果你之前装过旧版本 Node升级之后 PowerShell 可能还是指向旧路径。这时候不要怀疑人生关掉终端重新开一个或者执行refreshenv实在不行就重启一下系统百分之九十的版本没变问题都能解决。2.2 通过 npm 安装 Claude CodeNode 就绪后安装 Claude Code 其实只有一条命令npm install -g anthropic-ai/claude-code这里必须多说一句Windows 用户尽量不要用以管理员身份运行 PowerShell来执行这条命令。全局 npm 包默认会装到你的用户目录下的%APPDATA%\npm正常情况下根本不需要管理员权限。如果你用了管理员权限反而可能把包的属主搞乱后面升级或者卸载都会遇到权限报错。装完以后验证一下claude --version如果提示claude 不是内部或外部命令不要慌。这是因为%APPDATA%\npm这个目录没有被加到 PATH 里。打开设置 → 系统 → 关于 → 高级系统设置 → 环境变量在用户变量的 Path 里加上这个路径C:\Users\你的用户名\AppData\Roaming\npm然后重开终端基本就能识别了。另外一个容易被忽略的点Claude Code 在 Windows 上执行 Bash 类工具时底层依赖 Git for Windows 自带的 bash。建议顺手装一个 Git for Windows官网下载默认安装即可。不装的话某些工具调用会报bash: command not found后面排查起来很头痛。2.3 申请并准备 DeepSeek API Key去 DeepSeek 开放平台注册账号进入 API Keys 页面创建一个新密钥。密钥长这样sk-开头的一长串字符。创建时建议你给这个 Key 起个一目了然的名称比如claude-code。因为一个账号可以建多个 Key分开管理的好处是如果某个项目里的 Key 泄露了你只需要撤销那一个不会影响别的服务。这里有个安全习惯要养成先充值再测试。DeepSeek 是按 Token 计费的虽然是后付费但如果账号余额为 0API 会直接返回 402 或者余额不足的错误你根本不知道是配置问题还是钱的问题。我见过太多人花了半小时排查配置最后发现是忘了充值。先充个 10 块 20 块够你折腾很久了。拿到 Key 后先复制到记事本里后面配置要用。注意不要把这个 Key 发到任何聊天群里也别截图发朋友圈这玩意儿就是你的钱。3. settings.json 配置全流程核心重点3.1 配置文件到底放在哪里很多教程说改~/.claude/settings.json这在 Linux 上很好理解但 Windows 用户看到~就懵了。其实在 Windows 上就是当前用户主目录下的.claude文件夹C:\Users\你的用户名\.claude\settings.json你可以在资源管理器地址栏直接输入%USERPROFILE%\.claude回车就能跳进去。如果这个目录不存在第一次运行claude命令时会自动创建你手动创建目录和文件也没有任何问题。除了用户级配置还有项目级配置在某个具体项目的根目录下创建.claude\settings.json。Claude Code 启动时会自动读取而且项目级配置会覆盖用户级配置的同名字段。这意味着你可以在全局配好 DeepSeek然后在某个项目里临时切回其他模型不用改全局文件。顺带一提VSCode 用户有时候会混淆另一个文件.vscode/settings.json。那个是编辑器自己的配置和 Claude Code 的配置文件完全两码事别搞混。3.2 env 四件套驱动 DeepSeek 的关键参数用记事本或者 VSCode 打开settings.json写入下面这份配置{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_API_KEY: sk-你的DeepSeek密钥, ANTHROPIC_MODEL: deepseek-chat, ANTHROPIC_SMALL_FAST_MODEL: deepseek-chat } }保存完成。就这么简单。但这么简单背后每个字段都有讲究我逐个拆开讲。第一ANTHROPIC_BASE_URL。这个值必须是https://api.deepseek.com/anthropic注意末尾不要带斜杠。有些人习惯性地写成anthropic/结果所有请求都 404。URL 末尾加不加斜杠在很多 HTTP 服务里都能容错但 Claude Code 拼接路径时比较较真多一个斜杠就是失败。另外http://和https://的区别也很明显一定要用 https。第二ANTHROPIC_API_KEY。这里填 DeepSeek 的 Key不是 Anthropic 的。如果你之前用过 Claude Code 的 Anthropic 账号登录这一步最容易出错——旧的 Key 还残留在环境变量里。我建议配置好 settings.json 之后再去系统环境变量里检查一下有没有历史遗留的ANTHROPIC_API_KEY如果有删掉。因为环境变量的优先级在某些情况下比配置文件高两者的 Key 不一致时会出现很诡异的错误。第三ANTHROPIC_MODEL。填deepseek-chat对应 DeepSeek 的通用对话模型日常编码够用。如果你需要深度推理能力可以填deepseek-reasoner但推理模型响应更慢、Token 消耗也更大。日常操作建议保持deepseek-chat。第四ANTHROPIC_SMALL_FAST_MODEL。很多人会漏掉这个但它其实很关键。Claude Code 内部有一些小任务比如自动生成文件摘要、给对话内容做压缩总结这些任务走的是轻量模型通道。如果不设置这个字段Claude Code 会默认找它认识的 Claude 轻量模型而 DeepSeek 的端点上根本没有这个模型任务就会报Model Not Found。把它也指定为deepseek-chat所有请求才都会稳稳落在 DeepSeek 上。3.3 配置权限让代理少打扰你env配置解决的是后端是谁的问题接下来要解决能干多少活的问题。Claude Code 默认对文件读取、编辑这类操作是信任的但执行命令行工具时会弹确认框。如果项目里每次跑个npm run build都要你点一次确认体验会非常割裂。你可以在同一个 settings.json 里加permissions节点{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_API_KEY: sk-你的DeepSeek密钥, ANTHROPIC_MODEL: deepseek-chat, ANTHROPIC_SMALL_FAST_MODEL: deepseek-chat }, permissions: { allow: [ Bash(npm run *), Bash(node *), Bash(python *) ], deny: [ Bash(rm -rf *), Bash(sudo *) ] } }这个配置的意思是允许执行 npm、node、python 开头的命令禁止执行强制删除和提权命令。规则匹配是前缀通配所以npm run dev、npm run build都会直接放行不需要每次确认。我个人的建议是对个人项目可以放宽一点但涉及删除、格式化、生产环境操作这类高危命令一律放 deny 列表。工具再聪明也只是工具误操作的风险必须由你自己设防。3.4 如何快速验证配置是否生效配置写完后不需要立刻开一个完整会话去体验。Claude Code 自带一个诊断命令claude doctor它会检查 Node 版本、配置文件位置、API Key 是否已设置、网络能否连通。如果看到类似 API key: 已设置 的字样说明配置被正确加载了。再看看有没有红色报错如果有按它的提示去修。也可以运行claude config list查看最终生效的配置项确认ANTHROPIC_BASE_URL的值确实是 DeepSeek 的地址。这一步相当于安全检查能帮你排除配置文件写错位置这种低级问题。4. 实操验证与真实任务演练4.1 首次启动看 DeepSeek 是否真正接管配置完成后在项目目录里运行claude首次启动会有一个信任提示问你是否信任当前文件夹。选Trust进入。如果一切正常你会看到一个交互式命令行界面提示符是。这时候先做一次身份确认。直接问它用一句话说明你现在是什么模型由哪家服务商提供。如果配置成功回答里会明确提到 DeepSeek。如果回答里出现 Claude 或者 Anthropic说明请求还是打到了 Anthropic 官方——大概率是环境变量残留或者配置目录不对回到上一章排查。第二个测试是让它写一个真正的代码任务。比如我在一个临时项目里输入写一个 Python 脚本统计当前目录下所有 .log 文件里 ERROR 出现的次数按次数从高到低输出前 10 行。Claude Code 会先读取目录、分析文件然后生成脚本再请求执行权限。你会看到进度提示和确认请求。确认执行后它会把结果展示在界面上。整个过程里模型驱动逻辑、工具调用、结果反馈这几个环节只要都走通了就说明 DeepSeek 已经成功接管了 Claude Code。4.2 用一个小任务感受工具链协作我再举个例子让你对驱动成功有个直观感受。还是那个日志统计任务Claude Code 生成的脚本大致会长这样import glob from collections import Counter counter Counter() for path in glob.glob(*.log): with open(path, encodingutf-8, errorsignore) as f: for line in f: if ERROR in line: counter[path] 1 for path, count in counter.most_common(10): print(f{count:6d} {path})它能写对文件读取逻辑会考虑编码异常会选中glob这种标准库方案——这些细节都来自模型本身的能力。而在 DeepSeek 接入之前这套生成、写入、执行、反馈的闭环是只属于 Claude 官方模型的功能。现在你用 DeepSeek 拿到了同样的体验这就值得高兴。实际用时你会发现DeepSeek 的响应速度也不错写代码的质量应对日常需求足够了。当然它在一些极度复杂的架构设计或者长链路重构任务上和 Claude 顶级模型仍有差距这个是模型本身的差异不是配置问题。4.3 日常使用注意事项配置好之后有三件事会影响你的长期使用体验。第一token消耗会被快速放大。Claude Code 每做一件事都会把相关文件内容、工具输出、对话历史发给模型。哪怕只是一个很小的改动一个会话下来可能消耗几万 Token。建议在项目根目录创建.claudeignore文件把node_modules、dist、build、.git这些目录排除掉减少不必要的内容上传。第二API Key 的保密不能靠自觉。我强烈建议把.claude目录加入你的项目.gitignore因为 settings.json 里躺着明文密钥。如果项目要从 Git 克隆给同事别再让密钥跟着走。第三控制会话长度。一个跑了几百轮的长会话历史记录会越来越重既费 Token 也可能让模型忘记上下文。做一段时间后直接/clear清空对话让它不带包袱地重新开始效果往往更好。5. 常见问题与排查实录5.1 报错速查表我从实际使用里整理了一份高频报错表照着排查基本能解决大半问题。报错特征可能原因解决方法Authentication failed或 HTTP 401API Key 错误、失效或环境变量里残留旧 Key重新创建 DeepSeek Key检查 settings.json 和系统环境变量Model Not Found或 HTTP 400ANTHROPIC_MODEL没设置或设置了 DeepSeek 不认识的模型名明确设为deepseek-chat或deepseek-reasonerECONNREFUSED、ENOTFOUND、超时ANTHROPIC_BASE_URL写错、末尾多斜杠、网络无法访问核对地址去掉末尾/确认网络环境能访问 api.deepseek.comclaude 不是内部或外部命令npm 全局目录没在 PATH 里把%APPDATA%\npm加到用户 PATH 并重开终端工具执行时报bash: command not found缺少 Git for Windows 提供的 bash安装 Git for Windows提示余额不足或欠费DeepSeek 账户余额为 0到平台充值后再重试对话突然中断、无响应长会话 Token 累积过多本地网络波动/clear清空会话检查网络这样一个表放在手边遇到问题先对号入座能省下不少搜索时间。5.2 Windows 专属的坑Windows 上配置这类工具和 macOS 最大的区别在于环境变量和命令行的行为。首先是 PowerShell 的变量语法。很多教程里写的是export ANTHROPIC_API_KEYxxx这是 bash 语法拿到 PowerShell 里直接执行会报错。正确做法是$env:ANTHROPIC_API_KEY sk-xxx但这样设置的环境变量只在当前终端有效关闭窗口就没了。所以我不建议用终端环境变量来长期配置直接写进 settings.json 的env字段反而最稳定一劳永逸。其次是 PATH 刷新问题。在 Windows 上安装 Node 或者修改 PATH 之后已经打开的终端窗口不会拿到新值。你必须完全关闭所有终端窗口重新打开才会生效。很多人改完 PATH 说怎么没用九成是没重开终端。再次是 curl 的坑。PowerShell 里curl是Invoke-WebRequest的别名行为完全不同于 Linux 的 curl。如果你要手动测试 DeepSeek 接口建议用curl.exe强制调用真 curlcurl.exe https://api.deepseek.com/anthropic/v1/messages -H x-api-key: sk-你的密钥 -H anthropic-version: 2023-06-01 -H content-type: application/json -d {model:deepseek-chat,max_tokens:50,messages:[{role:user,content:hi}]}如果返回一个包含content的 JSON说明 API 连通、密钥有效问题就不在服务端而在 Claude Code 的配置加载上。5.3 安全与成本提醒最后说两个容易被忽视但很重要的点。一个是权限控制。settings.json里的permissions.allow规则本质上是把命令执行的授权交给了代理。我见过有人为了省事直接写Bash(*)这就等于允许它执行任意命令。万一模型被恶意提示词诱导去执行了删除命令后果只能自己承担。安全底线不要省高危操作保持确认弹窗。另一个是成本监控。DeepSeek 虽然便宜但 Claude Code 这类工具的使用模式是高消耗、长会话积少成多依然是一笔钱。DeepSeek 平台里通常可以设置消费阈值或者查看用量明细我建议隔几天就去看一眼做到心里有数。尤其是挂机跑自动化任务的时候一个死循环可能悄悄烧掉不少 Token。我个人实际用下来的体会是DeepSeek 作为 Claude Code 的后端日常编码已经完全够用成本也确实香。你最需要花心思的不是安装那一步而是把配置结构、权限边界、密钥安全这三件事养成习惯。先跑通最小配置再逐步放开权限遇到报错先看配置再看网络多数问题都能在三分钟内定位。这套流程跑顺之后Windows 上的 Claude Code 就不再是别人家的工具了。