1. Windows 下 Claude Code 对接 DeepSeek 的完整场景拆解Claude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、跑命令、改代码。它默认只认 Claude 系列模型但通过兼容 Anthropic Messages 协议的第三方 API 网关就能把请求转发到 DeepSeek 这类模型上。这篇教程聚焦 Windows 环境从零把 Claude Code 装好、配好、跑通适合想在本地用 DeepSeek 写代码、又不想折腾复杂环境的开发者。很多人卡在第一步官网下载页打不开或者一键脚本跑到一半超时。我实测下来Windows 上用 npm 全局安装是最稳的路子配合一个兼容层把 Base URL 指向第三方网关就能让 Claude Code 说上 DeepSeek 的话。整个流程分四块装 Node.js、npm 装 Claude Code、配置 API 网关、验证连通性。每一步我都会给出可直接复制的命令和配置片段照着敲就行。先说清楚这套方案能做什么。装完之后你在任意项目目录下敲claude它会启动一个交互式终端你输入自然语言需求它调用 DeepSeek 模型返回代码修改建议并可以直接落盘。适合谁适合已经会用命令行、想低成本体验 AI 编程助手的 Windows 用户。不适合谁如果你完全没碰过 CMD 或 PowerShell建议先花十分钟熟悉基本命令再来。这里有个关键概念要提前讲明白Claude Code 本身是个客户端它不绑定具体模型。真正决定用哪个模型的是你配置的 Base URL 和 API Key。把 Base URL 指向一个兼容 Anthropic 协议的网关再填上网关发的 KeyClaude Code 就会把请求发到网关网关再转发给 DeepSeek。所以整条链路是Claude Code → 兼容网关 → DeepSeek。理解了这个后面配置就不会晕。我试过直接在 Windows 上跑官方脚本网络波动大的时候十次有三次失败。npm 方案虽然多一步装 Node.js但胜在可控失败了大不了重跑一条命令。下面从环境准备开始一步步来。2. TaoToken 前置准备拿到 Base URL 和 API Key在配置 Claude Code 之前你需要一个兼容 Anthropic Messages 协议的 API 网关。TaoToken 提供的就是这个能力它把 DeepSeek 等模型的接口包装成 Claude Code 能识别的格式你只需要一个 Base URL 和一个 API Key。先访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号。注册过程不复杂邮箱加密码即可。登录后进入控制台找到 API Keys 页面点创建新密钥。创建时建议给密钥起个能认出来的名字比如windows-claude-code方便以后管理。创建完立刻复制因为页面刷新后完整密钥就不再显示了。复制下来的 Key 长这样sk-开头的一串字符。把它先存到记事本里等会儿配置要用。注意不要把这个 Key 贴到公开的代码仓库或聊天群里泄露了别人就能用你的额度。接下来确认 Base URL。TaoToken 的 API 入口是 https://taotoken.net/api 这个地址就是你要填到 Claude Code 配置里的 Base URL。注意末尾不要多加斜杠也不要带路径就填到/api为止。如果你还想在浏览器里先试试模型能不能通可以打开模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 选一个 DeepSeek 模型发一句话能正常回复说明账号和额度都没问题。这一步不是必须的但能提前排除账号层面的问题。关于模型 IDTaoToken 上 DeepSeek 系列常用的有deepseek-chat、deepseek-reasoner等。具体用哪个可以在模型对话页面的下拉框里看到当前可用的列表。记下你打算用的那个 ID配置时要填进去。额度方面新账号一般有试用额度够你跑通验证和写几个小项目。如果额度用完控制台里有充值入口按需充一点即可。这里不展开讲价格因为不同时期活动不一样以控制台实际显示为准。拿到这三样东西——Base URL、API Key、Model ID——就可以进入下一步配置了。如果你还想用 Coding Plan 做长期编码任务可以看 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 不过本篇先聚焦单次接入。3. 可复制配置npm 安装与环境变量设置这一节是全文的核心所有命令和配置都可以直接复制。先装 Node.js再装 Claude Code最后写配置文件。3.1 安装 Node.js打开浏览器访问 nodejs.org下载 LTS 长期稳定版。双击安装包一路默认下一步注意安装向导里有个 “Add to PATH” 的勾选项保持勾选状态。装完后验证按Win R输入cmd回车在命令行里敲node --version如果输出类似v20.11.0的版本号说明装好了。如果提示 “不是内部或外部命令”关掉所有 CMD 窗口重新打开再试还不行就重新安装 Node.js确认勾了 Add to PATH。3.2 npm 全局安装 Claude Code在 CMD 里执行npm install -g anthropic-ai/claude-code国内网络慢的话这一步可能跑三到五分钟耐心等别关窗口。如果卡住不动先换镜像源再重跑npm config set registry https://registry.npmmirror.com npm install -g anthropic-ai/claude-code装完验证claude --version输出版本号就成功了。后续更新用claude update或claude install都行。3.3 写 settings 配置文件Claude Code 读取配置的位置在用户目录下的.claude文件夹。在 CMD 里执行以下命令创建目录并写入配置mkdir %USERPROFILE%\.claude然后用记事本创建文件%USERPROFILE%\.claude\settings.json内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的APIKey粘贴在这里, ANTHROPIC_MODEL: deepseek-chat, ANTHROPIC_SMALL_FAST_MODEL: deepseek-chat } }把sk-你的APIKey粘贴在这里替换成你刚才复制的真实 Keydeepseek-chat替换成你要用的模型 ID。ANTHROPIC_SMALL_FAST_MODEL是给轻量任务用的填同一个模型即可。如果你更习惯用环境变量而不是配置文件也可以在 CMD 里临时设置set ANTHROPIC_BASE_URLhttps://taotoken.net/api set ANTHROPIC_AUTH_TOKENsk-你的APIKey set ANTHROPIC_MODELdeepseek-chat但这种方式关掉窗口就失效推荐还是用 settings.json。3.4 三件套对照表配置里最关键的就是三件套对照下面确认配置项填写内容说明Base URLhttps://taotoken.net/api兼容 Anthropic 协议的网关入口API Keysk- 开头的密钥在控制台 API Keys 页面创建Model IDdeepseek-chat 等在模型对话页面确认可用 ID这三样缺一不可。Base URL 填错会连不上Key 填错会 401Model ID 填错会报模型不存在。4. 验证请求首次运行与成功结果配置写好后进入任意一个项目目录在 CMD 里敲cd /d D:\你的项目目录 claude第一次启动会看到 Claude Code 的欢迎界面提示你当前使用的模型。如果配置正确它会显示你设置的模型 ID。然后你可以输入一句话测试比如帮我看看当前目录下有哪些文件并解释 package.json 的作用正常情况下它会调用 DeepSeek 模型几秒后返回文件列表和对 package.json 的说明。这就说明整条链路通了。如果你想用一条命令做纯连通性验证不进入交互模式可以这样claude -p 用一句话说明什么是递归-p参数表示单次提问后退出。如果返回了一句合理的解释说明 API 调用成功。如果报错往下看第五节。成功的结果有几个特征响应在几秒内返回内容与你的提问相关没有出现 “connection refused” 或 “401” 之类的字样。我实测下来DeepSeek 的响应速度在正常网络下是可以接受的复杂问题会慢一些但不会卡死。验证通过后你就可以在项目里正常用了。比如让它读某个文件、改某个函数、生成测试用例。Claude Code 会先读文件再给建议你确认后它才落盘不会擅自改你的代码。如果你在验证时想换个模型试试直接改 settings.json 里的ANTHROPIC_MODEL字段重启 claude 即可。不用重新装任何东西。5. 本篇常见报错排查清单配置过程中最容易碰到几类报错这里逐个对照解决。报错一401 Unauthorized完整报错类似API error 401: invalid api key。原因是 Key 填错或过期。检查 settings.json 里的ANTHROPIC_AUTH_TOKEN是否完整有没有多余空格。如果 Key 是在别处复制的重新去控制台创建一个新的再试。注意 Key 只在创建时显示一次如果当时没复制只能重建。报错二local proxy failed / connection refused报错里出现local proxy failed或ECONNREFUSED通常是 Base URL 填错。确认填的是https://taotoken.net/api不要多斜杠不要带/v1之类的路径。另外检查本机网络是否正常能不能打开网页。报错三reading choices / unexpected response报错里出现reading choices或unexpected response format说明网关返回的格式和 Claude Code 预期的不一致。这种情况多半是 Base URL 指向了不兼容 Anthropic 协议的接口。确认你用的是 TaoToken 的/api入口而不是其他 OpenAI 格式的地址。报错四OAuth / login required如果启动时提示要登录 Anthropic 账号或走 OAuth说明 Claude Code 没读到你的 settings.json。检查文件路径是否为%USERPROFILE%\.claude\settings.json文件名有没有写错JSON 格式是否合法可以用在线 JSON 校验工具检查。另外确认没有同时设置冲突的环境变量。报错五model not found报错提示模型不存在检查ANTHROPIC_MODEL填的 ID 是否在可用列表里。去模型对话页面确认当前可用的 DeepSeek 模型 ID复制准确的字符串填进去。报错六npm 安装超时前面提过换镜像源即可npm config set registry https://registry.npmmirror.com然后重跑安装命令。如果还是慢检查本机网络或者换个时间段再试。排查时有个通用思路先确认三件套Base URL、Key、Model ID都对再看配置文件路径和格式最后看网络。大部分问题出在前两步。6. 继续深入从验证到日常编码跑通验证只是开始。日常用 Claude Code 写代码时有几个实用技巧能让你更顺手。第一把常用项目的配置固化下来。如果你有多个项目用不同的模型可以在项目根目录放一个.claude/settings.json它会覆盖用户目录的全局配置。这样切项目时不用改全局文件。第二善用-p做脚本化调用。比如你想在 CI 里让 Claude Code 检查代码风格可以写claude -p 检查 src 目录下的代码是否有明显的空指针风险 report.txt第三模型选择上日常补全和简单问答用deepseek-chat就够复杂推理任务可以切到deepseek-reasoner。切换只需改 settings.json 里的模型 ID重启 claude。如果你打算长期用 Claude Code 做编码任务可以了解一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它针对高频编码场景做了额度优化。另外接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有更详细的协议说明遇到兼容性问题可以查。最后提醒一句API Key 妥善保管不要提交到 Git 仓库。可以在项目里加.claude/到.gitignore避免配置泄露。整套流程走下来从装 Node.js 到验证成功顺利的话二十分钟内能搞定。卡住了就回到第五节对照报错大部分问题都有现成解法。 
长河君 · 2026/10/4 14:05:01 · 阅读 1.2k 保姆级教程：Windows 下 Claude Code 对接 DeepSeek 第三方 API 完整方案（含 npm 安装与下载）
1. Windows 下 Claude Code 对接 DeepSeek 的完整场景拆解Claude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、跑命令、改代码。它默认只认 Claude 系列模型但通过兼容 Anthropic Messages 协议的第三方 API 网关就能把请求转发到 DeepSeek 这类模型上。这篇教程聚焦 Windows 环境从零把 Claude Code 装好、配好、跑通适合想在本地用 DeepSeek 写代码、又不想折腾复杂环境的开发者。很多人卡在第一步官网下载页打不开或者一键脚本跑到一半超时。我实测下来Windows 上用 npm 全局安装是最稳的路子配合一个兼容层把 Base URL 指向第三方网关就能让 Claude Code 说上 DeepSeek 的话。整个流程分四块装 Node.js、npm 装 Claude Code、配置 API 网关、验证连通性。每一步我都会给出可直接复制的命令和配置片段照着敲就行。先说清楚这套方案能做什么。装完之后你在任意项目目录下敲claude它会启动一个交互式终端你输入自然语言需求它调用 DeepSeek 模型返回代码修改建议并可以直接落盘。适合谁适合已经会用命令行、想低成本体验 AI 编程助手的 Windows 用户。不适合谁如果你完全没碰过 CMD 或 PowerShell建议先花十分钟熟悉基本命令再来。这里有个关键概念要提前讲明白Claude Code 本身是个客户端它不绑定具体模型。真正决定用哪个模型的是你配置的 Base URL 和 API Key。把 Base URL 指向一个兼容 Anthropic 协议的网关再填上网关发的 KeyClaude Code 就会把请求发到网关网关再转发给 DeepSeek。所以整条链路是Claude Code → 兼容网关 → DeepSeek。理解了这个后面配置就不会晕。我试过直接在 Windows 上跑官方脚本网络波动大的时候十次有三次失败。npm 方案虽然多一步装 Node.js但胜在可控失败了大不了重跑一条命令。下面从环境准备开始一步步来。2. TaoToken 前置准备拿到 Base URL 和 API Key在配置 Claude Code 之前你需要一个兼容 Anthropic Messages 协议的 API 网关。TaoToken 提供的就是这个能力它把 DeepSeek 等模型的接口包装成 Claude Code 能识别的格式你只需要一个 Base URL 和一个 API Key。先访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号。注册过程不复杂邮箱加密码即可。登录后进入控制台找到 API Keys 页面点创建新密钥。创建时建议给密钥起个能认出来的名字比如windows-claude-code方便以后管理。创建完立刻复制因为页面刷新后完整密钥就不再显示了。复制下来的 Key 长这样sk-开头的一串字符。把它先存到记事本里等会儿配置要用。注意不要把这个 Key 贴到公开的代码仓库或聊天群里泄露了别人就能用你的额度。接下来确认 Base URL。TaoToken 的 API 入口是 https://taotoken.net/api 这个地址就是你要填到 Claude Code 配置里的 Base URL。注意末尾不要多加斜杠也不要带路径就填到/api为止。如果你还想在浏览器里先试试模型能不能通可以打开模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 选一个 DeepSeek 模型发一句话能正常回复说明账号和额度都没问题。这一步不是必须的但能提前排除账号层面的问题。关于模型 IDTaoToken 上 DeepSeek 系列常用的有deepseek-chat、deepseek-reasoner等。具体用哪个可以在模型对话页面的下拉框里看到当前可用的列表。记下你打算用的那个 ID配置时要填进去。额度方面新账号一般有试用额度够你跑通验证和写几个小项目。如果额度用完控制台里有充值入口按需充一点即可。这里不展开讲价格因为不同时期活动不一样以控制台实际显示为准。拿到这三样东西——Base URL、API Key、Model ID——就可以进入下一步配置了。如果你还想用 Coding Plan 做长期编码任务可以看 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 不过本篇先聚焦单次接入。3. 可复制配置npm 安装与环境变量设置这一节是全文的核心所有命令和配置都可以直接复制。先装 Node.js再装 Claude Code最后写配置文件。3.1 安装 Node.js打开浏览器访问 nodejs.org下载 LTS 长期稳定版。双击安装包一路默认下一步注意安装向导里有个 “Add to PATH” 的勾选项保持勾选状态。装完后验证按Win R输入cmd回车在命令行里敲node --version如果输出类似v20.11.0的版本号说明装好了。如果提示 “不是内部或外部命令”关掉所有 CMD 窗口重新打开再试还不行就重新安装 Node.js确认勾了 Add to PATH。3.2 npm 全局安装 Claude Code在 CMD 里执行npm install -g anthropic-ai/claude-code国内网络慢的话这一步可能跑三到五分钟耐心等别关窗口。如果卡住不动先换镜像源再重跑npm config set registry https://registry.npmmirror.com npm install -g anthropic-ai/claude-code装完验证claude --version输出版本号就成功了。后续更新用claude update或claude install都行。3.3 写 settings 配置文件Claude Code 读取配置的位置在用户目录下的.claude文件夹。在 CMD 里执行以下命令创建目录并写入配置mkdir %USERPROFILE%\.claude然后用记事本创建文件%USERPROFILE%\.claude\settings.json内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的APIKey粘贴在这里, ANTHROPIC_MODEL: deepseek-chat, ANTHROPIC_SMALL_FAST_MODEL: deepseek-chat } }把sk-你的APIKey粘贴在这里替换成你刚才复制的真实 Keydeepseek-chat替换成你要用的模型 ID。ANTHROPIC_SMALL_FAST_MODEL是给轻量任务用的填同一个模型即可。如果你更习惯用环境变量而不是配置文件也可以在 CMD 里临时设置set ANTHROPIC_BASE_URLhttps://taotoken.net/api set ANTHROPIC_AUTH_TOKENsk-你的APIKey set ANTHROPIC_MODELdeepseek-chat但这种方式关掉窗口就失效推荐还是用 settings.json。3.4 三件套对照表配置里最关键的就是三件套对照下面确认配置项填写内容说明Base URLhttps://taotoken.net/api兼容 Anthropic 协议的网关入口API Keysk- 开头的密钥在控制台 API Keys 页面创建Model IDdeepseek-chat 等在模型对话页面确认可用 ID这三样缺一不可。Base URL 填错会连不上Key 填错会 401Model ID 填错会报模型不存在。4. 验证请求首次运行与成功结果配置写好后进入任意一个项目目录在 CMD 里敲cd /d D:\你的项目目录 claude第一次启动会看到 Claude Code 的欢迎界面提示你当前使用的模型。如果配置正确它会显示你设置的模型 ID。然后你可以输入一句话测试比如帮我看看当前目录下有哪些文件并解释 package.json 的作用正常情况下它会调用 DeepSeek 模型几秒后返回文件列表和对 package.json 的说明。这就说明整条链路通了。如果你想用一条命令做纯连通性验证不进入交互模式可以这样claude -p 用一句话说明什么是递归-p参数表示单次提问后退出。如果返回了一句合理的解释说明 API 调用成功。如果报错往下看第五节。成功的结果有几个特征响应在几秒内返回内容与你的提问相关没有出现 “connection refused” 或 “401” 之类的字样。我实测下来DeepSeek 的响应速度在正常网络下是可以接受的复杂问题会慢一些但不会卡死。验证通过后你就可以在项目里正常用了。比如让它读某个文件、改某个函数、生成测试用例。Claude Code 会先读文件再给建议你确认后它才落盘不会擅自改你的代码。如果你在验证时想换个模型试试直接改 settings.json 里的ANTHROPIC_MODEL字段重启 claude 即可。不用重新装任何东西。5. 本篇常见报错排查清单配置过程中最容易碰到几类报错这里逐个对照解决。报错一401 Unauthorized完整报错类似API error 401: invalid api key。原因是 Key 填错或过期。检查 settings.json 里的ANTHROPIC_AUTH_TOKEN是否完整有没有多余空格。如果 Key 是在别处复制的重新去控制台创建一个新的再试。注意 Key 只在创建时显示一次如果当时没复制只能重建。报错二local proxy failed / connection refused报错里出现local proxy failed或ECONNREFUSED通常是 Base URL 填错。确认填的是https://taotoken.net/api不要多斜杠不要带/v1之类的路径。另外检查本机网络是否正常能不能打开网页。报错三reading choices / unexpected response报错里出现reading choices或unexpected response format说明网关返回的格式和 Claude Code 预期的不一致。这种情况多半是 Base URL 指向了不兼容 Anthropic 协议的接口。确认你用的是 TaoToken 的/api入口而不是其他 OpenAI 格式的地址。报错四OAuth / login required如果启动时提示要登录 Anthropic 账号或走 OAuth说明 Claude Code 没读到你的 settings.json。检查文件路径是否为%USERPROFILE%\.claude\settings.json文件名有没有写错JSON 格式是否合法可以用在线 JSON 校验工具检查。另外确认没有同时设置冲突的环境变量。报错五model not found报错提示模型不存在检查ANTHROPIC_MODEL填的 ID 是否在可用列表里。去模型对话页面确认当前可用的 DeepSeek 模型 ID复制准确的字符串填进去。报错六npm 安装超时前面提过换镜像源即可npm config set registry https://registry.npmmirror.com然后重跑安装命令。如果还是慢检查本机网络或者换个时间段再试。排查时有个通用思路先确认三件套Base URL、Key、Model ID都对再看配置文件路径和格式最后看网络。大部分问题出在前两步。6. 继续深入从验证到日常编码跑通验证只是开始。日常用 Claude Code 写代码时有几个实用技巧能让你更顺手。第一把常用项目的配置固化下来。如果你有多个项目用不同的模型可以在项目根目录放一个.claude/settings.json它会覆盖用户目录的全局配置。这样切项目时不用改全局文件。第二善用-p做脚本化调用。比如你想在 CI 里让 Claude Code 检查代码风格可以写claude -p 检查 src 目录下的代码是否有明显的空指针风险 report.txt第三模型选择上日常补全和简单问答用deepseek-chat就够复杂推理任务可以切到deepseek-reasoner。切换只需改 settings.json 里的模型 ID重启 claude。如果你打算长期用 Claude Code 做编码任务可以了解一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它针对高频编码场景做了额度优化。另外接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有更详细的协议说明遇到兼容性问题可以查。最后提醒一句API Key 妥善保管不要提交到 Git 仓库。可以在项目里加.claude/到.gitignore避免配置泄露。整套流程走下来从装 Node.js 到验证成功顺利的话二十分钟内能搞定。卡住了就回到第五节对照报错大部分问题都有现成解法。