前阵子帮团队搭 CLI 编码助手发现大家卡在同一件事上手里有 DeepSeek 的 API key却想让 Claude Code 这个终端工具去干活。网上说法不少有的贴了一段配置有的说了个大概就跑真正讲清楚“为什么这样配”“配完怎么验证”的很少。我花了一个晚上在 Windows 上把整条路跑通从安装 Node.js 到 settings.json 落地中间踩了几个不算复杂的坑但确实每一步都能卡住人。这篇文章就是完整记录Windows 上怎么安装 Claude Code怎么用 DeepSeek 的 Anthropic 兼容端点把默认后端换成 DeepSeek以及配置文件里每个字段到底意味着什么。适合那些想用 DeepSeek 跑 Claude Code 交互体验的人也适合之前配过但始终 401/404 的朋友。1. 为什么要用 DeepSeek 驱动 Claude Code价值与边界1.1 Claude Code 的壳与 DeepSeek 的核Claude Code 是 Anthropic 出的终端编程代理你在命令行里用自然语言描述需求它能自动读项目文件、改代码、跑命令、查日志整个过程在终端里实时交互。这个“交互层”做得不错用过的应该能感受到它比普通对话框更贴近真实开发场景。但 Claude Code 默认只认 Anthropic 官方的 API 和模型。很多开发者注册 Anthropic 账号不方便或者觉得按量付费的成本偏高于是想到一个问题能不能让 Claude Code 的界面和工具体系保持不变把底层的模型换成 DeepSeek答案是能。Claude Code 本身支持通过环境变量去覆盖 API 端点地址和鉴权 token这是官方就有的能力不是绕过什么机制。把ANTHROPIC_BASE_URL指到 DeepSeek 官方的 Anthropic 兼容端点再把ANTHROPIC_AUTH_TOKEN换成 DeepSeek 的 API keyClaude Code 发出的请求就会打到 DeepSeek 的服务器上。用大白话说Claude Code 是司机DeepSeek 是发动机。你只是把发动机换了方向盘、油门、仪表盘还是原来那套。1.2 收益在哪里第一是性价比。DeepSeek 的 API 定价比 Anthropic 旗舰模型便宜不少对日常写代码、改 bug、生成单测这类任务开销能控制在很低的水平。第二是注册门槛低。DeepSeek 开放平台注册就能拿 key充值也很方便没有太多弯弯绕绕。第三是灵活性。同一份 Claude Code 配置你既可以用官方模型跑也可以用 DeepSeek 跑通过环境变量或配置文件切换本质上是一种模型路由的思路。1.3 边界要提前说清楚这不是让 Claude Code 变成 DeepSeek 官方客户端也不是克隆 Claude 模型。你用 deepseek-chat 驱动 Claude Code得到的模型行为是 DeepSeek-V3 的不是 Claude 的。Claude Code 里一些依赖 Claude 模型特性的高级功能表现会跟官方版本有差异尤其是极其复杂的多步工具调用场景偶尔会出现工具参数不匹配或执行中断的情况。另外DeepSeek 的上下文窗口跟 Claude 的不完全一样长对话、大仓库分析时要注意实时压缩历史。我的判断是日常开发足够用但不能要求它在所有场景达到官方组合的水平。适合的人群包括个人开发者做快速原型小团队想统一 CLI 工具链但控制 API 成本以及纯粹想横向对比不同模型在编码任务上表现的人。2. Windows 上的前置条件Node.js、终端和网络可达性2.1 安装 Node.js版本和 PATH 是关键Claude Code 依赖 Node.js 运行时。虽然官方目前也提供 Windows 原生安装包但 npm 方式依然是最通用、最不容易出幺蛾子的路径所以 Node.js 是必需品。去 nodejs.org 下载 LTS 版本Windows 用户直接拿 .msi 安装包。安装时注意一个细节安装向导里有个 “Add to PATH” 选项默认是勾上的别取消。很多人装完 Node.js 后终端里输入node -v提示找不到命令十有八九是这一步没注意。安装完成后新开一个终端窗口别用旧的因为 PATH 环境变量不会自动刷新。运行node -v npm -v能看到版本号就说明环境没问题。我建议用 Node.js 18 以上的 LTS 版本太老的版本跟 Claude Code 的依赖可能存在兼容性问题。2.2 终端选择Windows Terminal 是首选Claude Code 是交互式终端工具对 ANSI 转义序列有要求。Windows 自带的传统 conhost 窗口在某些情况下会显示乱码或布局错乱我直接推荐 Windows Terminal。Windows 11 自带 Windows TerminalWindows 10 去 Microsoft Store 搜一下即可安装。装完把默认终端设置为 Windows TerminalPowerShell 作为默认 shell。这样做的原因是 Claude Code 的交互界面依赖光标定位、颜色渲染、滚动区域Windows Terminal 对这几项的支持比老终端好得多。另外如果你的 PowerShell 执行策略限制脚本运行需要放开对本地脚本的约束。以管理员身份打开 PowerShell 执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser2.3 网络可达性一个容易忽略的隐形坑DeepSeek 的 API 在正常情况下可以直连但有两类环境容易出问题。一类是公司网络。企业网关或代理可能拦截外部 API 请求如果之前在同一台 Windows 机器上配置过代理环境变量里的HTTP_PROXY和HTTPS_PROXY会影响 Node.js 的请求行为。解决办法是确认这两个变量指向的代理是否正常或者暂时去掉后在终端里测试curl https://api.deepseek.com另一类是 DNS 解析异常。Windows 上偶发 DNS 缓存问题会导致请求超时可以执行ipconfig /flushdns刷新。注意这一步的目标是确保你的机器能够正常访问api.deepseek.com。如果 curl 能返回 JSON 或错误码而不是超时说明网络这一关过了。3. 两种安装路线npm 全局安装与官方 PowerShell 脚本3.1 路线 Anpm 全局安装最常见的安装方式是在终端里执行npm install -g anthropic-ai/claude-code执行后 npm 会把 claude 命令注册到全局环境。安装过程中如果看到权限相关的报错比如EPERM或EACCES在 Windows 上通常是 npm 全局目录没有写权限导致的。我用的解决办法是重新设置 npm 的全局安装目录npm config set prefix $env:APPDATA\npm然后把%APPDATA%\npm加到 PATH 环境变量里。之后重新打开终端再执行一次安装命令。安装完成后验证版本claude --version如果输出版本号说明命令已经可用。3.2 路线 B官方原生 Windows 安装脚本如果你不想在全局环境里装 Node.js 依赖或者希望 Claude Code 以独立 .msi 包的方式安装可以用 Anthropic 官方提供的安装脚本。以 PowerShell 身份执行irm https://claude.ai/install.ps1 | iex这行命令会下载安装脚本并执行脚本自动检测系统架构下载对应的 Windows 安装包并完成安装。两条路线我用下来觉得npm 方式升级方便npm update -g anthropic-ai/claude-code一条命令搞定原生安装包启动更快但升级时要重新走安装流程。日常使用选哪条都行后面的配置完全一致。3.3 安装后的最终验证不管哪条路线安装成功后建议执行claude如果配置尚未设置它会进入初始化流程可能会提示登录或输入订阅信息。此时先不要慌这是正常的等我们配置好 DeepSeek 后端后就不再需要走这套登录流程了。4. settings.json 配置详解把请求改道 DeepSeek4.1 配置文件的位置与优先级Claude Code 的配置文件采用 JSON 格式有两个层级用户级配置C:\Users\你的用户名\.claude\settings.json项目级配置项目根目录\.claude\settings.json两者同时存在时项目级配置优先级更高会覆盖用户级同名配置项。这是个很实用的机制你可以在用户级放通用的 API 地址、密钥、默认模型在项目级里只覆盖模型名比如某个仓库专攻复杂算法就单独把模型切到deepseek-reasoner。有一个血泪教训项目级配置如果存在.git仓库里很容易不小心把 API key 提交上去。我的建议是包含密钥的配置一律放用户级项目级只放和业务相关的模型偏好。4.2 最基础的一份 settings.json 长什么样用 VSCode 或任意文本编辑器在C:\Users\你的用户名\.claude\settings.json中写入{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: sk-你的DeepSeek密钥, ANTHROPIC_MODEL: deepseek-chat, ANTHROPIC_SMALL_FAST_MODEL: deepseek-chat } }这里sk-你的DeepSeek密钥需要在 DeepSeek 开放平台创建 API key创建后复制完整字符串不要有多余的空格或换行。保存文件后新开终端进入任意项目目录运行claude如果一切正常不会出现登录引导直接进入对话界面。可以在对话中输入/status查看当前使用的模型确认是不是deepseek-chat。4.3 每个 env 变量到底在干什么env块是 Claude Code 配置里的一个特殊结构它会在 Claude Code 启动时把这些环境变量注入到当前进程。这样做的效果是配置跟随工具走不污染系统全局环境变量。变量名值作用ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic将 API 请求地址指向 DeepSeek 的 Anthropic 兼容端点ANTHROPIC_AUTH_TOKENsk-xxx请求时携带的鉴权 token替代默认的 Anthropic keyANTHROPIC_MODELdeepseek-chat主对话模型负责实际编码任务ANTHROPIC_SMALL_FAST_MODELdeepseek-chat后台轻量任务模型比如生成标题、摘要、文件描述关于ANTHROPIC_SMALL_FAST_MODEL很多人忽略它但它很重要。Claude Code 内部会把一些低延迟、高吞吐的小任务单独路由到一个“小模型”上默认指向 Anthropic 的 haiku 系列。如果你只改主模型不改这个变量后台任务还是会请求官方端点轻则报模型不可用重则鉴权失败。显式把它也设为deepseek-chat所有内部请求才能统一走 DeepSeek。4.4 模型选择deepseek-chat 与 deepseek-reasonerDeepSeek 开放平台目前对外提供两个模型deepseek-chat对应 DeepSeek-V3响应快适合日常编码、重构、单测生成是 Claude Code 默认驱动的首选。deepseek-reasoner对应 DeepSeek-R1推理能力强适合复杂架构设计、疑难 bug 排查但延迟明显更高。CLI 编码工具讲究交互效率我建议日常用deepseek-chat。如果用deepseek-reasoner每一步工具调用都可能经历长时间思考整体节奏会变得很慢尤其在多轮工具调用的场景里体感像卡住一样。如果某个项目必须用推理模型可以单独在项目级配置里覆盖{ env: { ANTHROPIC_MODEL: deepseek-reasoner, ANTHROPIC_SMALL_FAST_MODEL: deepseek-chat } }这样主模型用推理能力更强的 R1后台小任务仍用 V3兼顾速度和思考深度。5. 首次启动、验证与高频故障排查5.1 如何确认请求真的打到了 DeepSeek配置好并启动 Claude Code 后第一件事不是急着写需求而是验证路由是不是真生效了。在对话里输入/status如果显示model: deepseek-chat说明主模型配置生效。然后随便让它执行一个简单任务比如“给这个项目写一个 README 框架”观察输出速度。几秒钟内开始流式返回说明链路是通的。更严谨的做法是同时登录 DeepSeek 开放平台在“用量”页面看是否出现实时的 token 消耗。只要能看到请求数在涨说明所有请求确实走到了 DeepSeek 服务端。还有一种方式用调试模式启动claude --debug。它会输出每次 API 调用的详细日志包括请求的 URL 和状态码排错时特别好用。5.2 高频错误404、401、超时与模型不存在我整理了实际使用中最常遇到的几类问题按出现频率排序。404 Not Found如果你的ANTHROPIC_BASE_URL写成了https://api.deepseek.com少了/anthropic路径Claude Code 请求时会拼接出自己的 API 路径最终拼出一个不存在的地址服务端返回 404。解决办法是在 base URL 中补全/anthropic。401 Unauthorized鉴权失败。大概率原因是 API key 复制错了或者 key 里带了空格。另一个容易被忽略的原因是 JSON 格式问题settings.json 里如果写了注释整个文件会被解析失败Claude Code 静默忽略然后自动用默认配置启动最终所有请求都因为没有正确 token 而 401。注意JSON 标准不支持注释。模型不存在如果你在ANTHROPIC_MODEL里写了deepseek-v3这类旧名称DeepSeek 服务端会返回模型不存在的错误。到 API 对接时就用官方当前文档的模型标识符deepseek-chat和deepseek-reasoner。请求超时Claude Code 默认的 API 超时时间可能对 deepseek-reasoner 不够长尤其是复杂任务需要长时间推理时可能提前中断。可以在 settings.json 里适当放宽{ apiTimeoutMinutes: 15 }apiTimeoutMinutes是 Claude Code 自己的配置项写在根级不放在env里。5.3 Windows 特有的路径与终端问题在 Windows 上配置文件目录.claude是隐藏目录默认情况下资源管理器看不到。你在C:\Users\用户名下按CtrlH显示隐藏项目就能看到。有些用户程序会生成一个用户目录里面有中文或空格比如C:\Users\张三。这种情况下配置文件路径同样按实际用户名处理不要手动硬编码绝对路径让 Claude Code 自己用%USERPROFILE%解析即可。终端显示乱码时在 PowerShell 里执行chcp 65001这会把手动会话的代码页切到 UTF-8Claude Code 输出就不会花屏。6. 日常使用中的经验与费用控制6.1 用批处理文件切换多套后端我经常需要在一台机器上同时保留 DeepSeek 和 Anthropic 官方两套配置。环境变量与配置文件同时存在时配置文件的优先级更高但如果你用的是系统环境变量方式切换起来需要反复修改系统配置很不方便。我的做法是两个批处理文件。新建claude-deepseek.batecho off set ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic set ANTHROPIC_AUTH_TOKENsk-你的DeepSeek密钥 set ANTHROPIC_MODELdeepseek-chat set ANTHROPIC_SMALL_FAST_MODELdeepseek-chat claude再建一个claude-anthropic.bat把对应的变量换成 Anthropic 官方的 key 和模型。想用哪套就双击哪个文件互不干扰。6.2 费用控制不要忽视会话累积效应Claude Code 默认会在一次会话里持续累积上下文。你改的文件越多对话轮次越长上下文里的 token 就越大费用随之上升。我在实际使用中摸索出三个控制手段。第一一个任务结束后及时用/clear清空对话历史而不是让上下文一直挂在那里。第二对长任务的中间过程用/compact压缩历史。Claude Code 会把之前的关键信息浓缩成摘要大幅减少后续请求的 token 量。第三在对话中随时用/cost查看本次会话已经消耗的金额心里有数。尤其在用 deepseek-reasoner 时它输出的 reasoning token 也计入费用长任务跑到后期成本明显上升。6.3 CLAUDE.md 的作用Claude Code 支持在项目根目录放一个CLAUDE.md文件里面写项目说明、代码规范、注意事项。每次会话启动时Claude Code 会自动读取这个文件作为上下文的一部分。我强烈建议接 DeepSeek 后把这个文件写得稍微详细一点因为 DeepSeek 在遵循复杂项目规范方面需要更明确的指令才能发挥出稳定水准。比如写清楚目录结构、测试命令、构建方式比让它现场摸索可靠得多。6.4 多工具调用场景下要留个心眼DeepSeek 的 Anthropic 兼容端点在多数场景下工作得很流畅尤其是代码生成、文件修改、命令执行这类标准工具链。但在一些非常复杂的多工具联动场景比如连续读取多个文件后再交叉修改多处引用偶尔会出现工具调用参数偏差。遇到这种情况最简单的应对是把任务拆小一次让它处理一个明确目标而不是扔给它一个“帮我重构整个模块”的大指令。拆细之后DeepSeek 的完成质量会明显上升。我自己用下来稳定运行几周后现在的工作习惯是简单任务直接对话中等任务给明确清单复杂任务拆成 3 到 4 个子任务逐项推进。把心态从“它应该理解我的全部意图”调整为“我把意图表达清楚它会执行得很好”这套组合基本可以长期服役。配置本身不复杂真正有价值的是理解它为什么这样工作。ANTHROPIC_BASE_URL像一块路由表ANTHROPIC_AUTH_TOKEN像门禁卡ANTHROPIC_MODEL和ANTHROPIC_SMALL_FAST_MODEL像岗位安排。这四个变量吃透了以后换任何兼容 Anthropic 协议的模型服务商你只需要改这几行就能接上。