1. Windows 上这套组合到底解决什么问题如果你在 Windows 上写代码又想用 Claude Code 的交互体验但手头只有 DeepSeek 的 API Key那这篇就是给你准备的。Claude Code 本身是一个跑在终端里的编码助手它能读项目文件、改代码、跑命令DeepSeek 提供兼容 Anthropic 协议的接口VS Code 则是我们日常待得最久的地方。把这三者串起来你就能在 VS Code 的对话框里直接让模型读你的工程、改你的文件而不用来回切窗口复制粘贴。适合谁已经装过 Node.js、用过命令行、想在 Windows 上把 Claude Code 接到 DeepSeek 的开发者。整条链路的关键其实只有两个一是环境变量要让 CLI 和 VS Code 扩展都能读到二是settings.json的配置骨架别写错字段。我见过太多人卡在「对话框输入没反应一会儿又跳回登录页」根因基本都是环境变量没被扩展进程继承。下面按「装环境 → 装 CLI → 配 DeepSeek → 配 VS Code → 验证 → 排错」的顺序走每一步都给可复制的命令和配置。目标是一次配通少踩环境坑。2. 前置准备Node.js、Git 与 TaoToken 的定位Claude Code CLI 是 Node.js 写的所以 Node.js 版本必须 18 以上建议直接上 20 LTS。Git 没有硬性版本要求但建议装上因为 Claude Code 有些操作会调用 git 做差异对比。检查命令node -v npm -v git --version如果node -v低于 18去 Node.js 官网下 LTS 安装包安装时勾选「Add to PATH」。装完重开一个 PowerShell 再验证别在旧窗口里试PATH 不会刷新。关于接口来源这里要区分清楚DeepSeek 官方提供 Anthropic 兼容端点你可以直接用如果你希望统一管理多个模型的 Key、做用量观测和切换也可以用 TaoToken 这类聚合入口来托管密钥。它的控制台在https://taotoken.net/apiAPI Key 在https://taotoken.net/api-keys生成。用聚合入口的好处是 Key 不散落在各个系统变量里换模型时只改一个 base_url 和 model 名。两种方式配置骨架是一样的区别只在ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN填什么。注意不管用哪种来源Key 都不要提交到 Git 仓库也不要写进项目里的.env后忘记加.gitignore。3. 安装 Claude Code CLI 并确认可执行用管理员身份打开 PowerShell走 winget 安装最省事winget install Anthropic.ClaudeCode装完必须重启 PowerShell让新的 PATH 生效。然后验证claude --version能打印版本号就说明 CLI 可用了。如果提示claude 不是内部或外部命令八成是 PATH 没刷新或者 winget 装到了用户目录但当前 shell 没读到。可以手动确认安装路径通常在%USERPROFILE%\AppData\Local\Microsoft\WinGet\Packages下把它加进用户 PATH 再重开终端。这一步只验证 CLI 本身能跑先别急着配 DeepSeek。很多人一上来就配环境变量结果 CLI 都没装好排查方向就乱了。4. 接入 DeepSeek环境变量与 settings.json 骨架4.1 临时环境变量仅当前窗口有效在 PowerShell 里直接执行下面这组适合先快速验证连通性$env:ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic $env:ANTHROPIC_AUTH_TOKEN你的 DeepSeek API Key $env:ANTHROPIC_MODELdeepseek-v4-pro[1m] $env:ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m] $env:ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m] $env:ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash $env:CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash $env:CLAUDE_CODE_EFFORT_LEVELmax然后cd进你的项目目录执行claude能进交互界面并正常回答就说明 CLI 这条链路通了。注意这种写法只在当前 PowerShell 窗口有效关掉就没了所以它只适合验证不适合长期用。4.2 settings.json 配置骨架推荐长期方案VS Code 扩展和 CLI 都会读C:\Users\你的用户名\.claude\settings.json。这个文件是持久化的比系统环境变量干净也不会把 Key 暴露到全局。骨架如下{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: 你的 DeepSeek API Key, ANTHROPIC_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-v4-flash, CLAUDE_CODE_SUBAGENT_MODEL: deepseek-v4-flash, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, CLAUDE_CODE_EFFORT_LEVEL: max } }几个字段的作用值得说清楚别照抄完不知道为什么字段作用ANTHROPIC_BASE_URL请求发往哪个兼容端点ANTHROPIC_AUTH_TOKEN鉴权用的 KeyANTHROPIC_MODEL默认主模型ANTHROPIC_DEFAULT_OPUS_MODEL映射 Opus 档位到实际模型ANTHROPIC_DEFAULT_SONNET_MODEL映射 Sonnet 档位到实际模型ANTHROPIC_DEFAULT_HAIKU_MODEL映射 Haiku 档位通常给轻量任务CLAUDE_CODE_SUBAGENT_MODEL子代理用的模型CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC关掉非必要遥测请求减少干扰CLAUDE_CODE_EFFORT_LEVEL推理投入档位如果你用 TaoToken 作为入口把ANTHROPIC_BASE_URL换成https://taotoken.net/apiANTHROPIC_AUTH_TOKEN换成在https://taotoken.net/api-keys生成的 Key 即可其余字段结构不变。想先确认模型名和可用性可以在https://taotoken.net/models里对照。注意JSON 里不能有注释也不能有多余逗号否则整个文件解析失败表现就是配置「没生效」。改完用编辑器格式化一下确认语法正确。5. VS Code 扩展安装与连通性验证先在 VS Code 扩展市场搜 Claude Code 装上然后完全重启 VS Code不是重载窗口是彻底关掉再开。扩展进程启动时才会去读settings.json。验证动作分三步第一步在 VS Code 里打开一个项目文件夹调出 Claude Code 面板输入一句简单的话比如「列出当前目录的文件」。如果它能返回文件列表说明扩展已经拿到配置并成功请求到模型。第二步如果没反应或者跳回登录页先在终端里跑一次claude确认 CLI 本身是通的。CLI 通、扩展不通问题基本就在settings.json没被读到或者字段名写错。第三步检查settings.json的路径和文件名。Windows 上容易踩的坑是文件被存成了settings.json.txt或者放到了C:\Users\你的用户名\.claude\之外的地方。用资源管理器打开「显示文件扩展名」确认一下。成功的结果是对话框输入后能持续输出、能读项目文件、能按你的指令改代码而不是转一圈回到登录界面。6. 本篇常见错误排查报错一对话框输入后无反馈随后回到登录页。这是最高频的问题根因是扩展进程没读到环境变量。解决顺序先确认settings.json存在且 JSON 合法再确认 VS Code 是完全重启的最后确认 Key 没有多余空格或换行。如果还不行才考虑用系统环境变量兜底但要清楚这会把 Key 暴露在用户变量里。报错二claude命令找不到。PATH 没刷新重开 PowerShell或 winget 安装路径没进 PATH手动加。报错三请求返回 401 或鉴权失败。Key 复制时带了空格或者用了错误的端点。DeepSeek 官方端点是https://api.deepseek.com/anthropic聚合入口是https://taotoken.net/api两者别混用。报错四模型名不识别。deepseek-v4-pro[1m]这类名字要和你实际可用的模型对齐写错会直接报模型不存在。不确定就先在模型列表里核对。报错五改了 settings.json 但没生效。除了重启 VS Code还要注意有些配置在 CLI 会话里是启动时读取的运行中的会话不会热加载退出重进。报错六系统环境变量和 settings.json 同时存在行为不一致。两者都有时优先级容易让人困惑。建议只保留一种推荐 settings.json干净且不污染全局。7. 下一步把配置沉淀成可复用流程配通之后建议把settings.json的骨架单独存一份模板换机器时直接改 Key 和 base_url 就能用。如果你后面要长期跑编码任务、用 Agent 做多步操作可以了解下 Coding Plan 这类按周期计费的方式比按量付费更好控预算入口在https://taotoken.net/coding-plan。日常想快速验证某个模型回答质量直接用模型对话页https://taotoken.net/models试一句就行不用每次都开 VS Code。真正省时间的做法是CLI 用来做一次性验证和脚本化调用VS Code 扩展用来做日常交互两者共用同一份settings.json这样配置只有一处排错时也只有一个方向。踩过的坑基本都集中在「配置没被读到」和「Key/端点写错」这两类把这两点盯住剩下的就是正常写代码了。
