Windows VSCode Claude Code 接入 DeepSeek-V4 全流程教程2026年最新 更新时间2026年8月 适用场景国内用户无 Anthropic 账号/无国际网络通过 DeepSeek API 接入 Claude Code⚠️ 重要DeepSeek 旧模型名deepseek-chat、deepseek-reasoner已于2026年7月24日下线必须使用新模型名目录环境准备安装 Node.js安装 Claude Code CLI安装 VSCode 插件注册 DeepSeek 并获取 API Key配置文件详解与正确写法验证配置是否成功常见问题1. 环境准备安装 Node.jsClaude Code 基于 Node.js 运行需要先安装 Node.js推荐 LTS 长期支持版。1.1 下载 Node.js访问 Node.js 官网下载页面 https://nodejs.org/下载Windows Installer (.msi)版本推荐LTS长期支持版目前为v22.x。⚠️ 不要下载奇数版本如 v23、v25这些是实验版不稳定。1.2 安装 Node.js双击下载的.msi文件一路点Next下一步默认安装到C:\Program Files\nodejs\。安装程序会自动将 Node.js 添加到系统环境变量 PATH无需手动配置。1.3 验证安装打开PowerShell按 WinX选择终端或Windows PowerShell执行node-v npm-v正常输出示例v22.14.0 10.9.02. 安装 Claude Code CLI 如果只使用 VSCode 插件可以跳过 CLI 安装直接进入第3步安装插件。但安装 CLI 有助于调试且 CLI 本身功能更完整。2.1 使用 npm 全局安装在 PowerShell 中执行npm install-g anthropic-ai/claude-code安装过程约 10~30 秒取决于网络看到类似以下输出即为成功added 9 packages in 10s2.2 验证安装claude--version正常输出2.1.227 (Claude Code)3. 安装 VSCode 插件3.1 下载安装 VSCode如已有可跳过 https://code.visualstudio.com/下载 Windows 版安装过程同样一路 Next。3.2 安装 Claude Code 扩展打开 VSCode按CtrlShiftX打开扩展面板在搜索框中输入Claude Code找到由Anthropic发布的官方插件点击安装3.3 重启 VSCode安装完成后VSCode 左侧活动栏会出现Claude 图标一个抽象的 Claude 标志。4. 注册 DeepSeek 并获取 API KeyClaude Code 默认连接 Anthropic 官方 API需要信用卡和海外账号国内用户可以通过 DeepSeek 提供的Anthropic 兼容端点接入。4.1 注册 DeepSeek Platform 账号访问 https://platform.deepseek.com点击注册/登录支持手机号、邮箱完成实名认证国内合规要求4.2 创建 API Key登录后左侧导航栏点击API Keys点击创建 API Key填写一个名称如claude-code点击创建立刻复制 Key保存到本地只显示一次⚠️ Key 格式为sk-xxxxxxxxxxxxxxxx妥善保管不要泄露给他人。4.3 充值最低 1 元DeepSeek API 按用量计费充值入口在用户中心最低充值1元人民币即可满足日常使用。5. 配置文件详解与正确写法⚠️ 这是最关键的一步配置写错一个字符就会报错。5.1 配置文件路径Claude Code 的配置文件位于用户目录下C:\Users\你的用户名\.claude\settings.json你的用户名可在 PowerShell 中执行以下命令查看$env:USERNAME5.2 创建配置文件打开 PowerShell依次执行以下命令# 创建 .claude 目录New-Item-ItemType Directory-Path$env:USERPROFILE\.claude-Force# 打开配置文件记事本notepad$env:USERPROFILE\.claude\settings.json记事本会弹出空白文件将下面的完整配置内容粘贴进去然后保存CtrlS{env:{ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,ANTHROPIC_AUTH_TOKEN:sk-你的DeepSeekAPIKey,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}}5.3 替换你的 API Key把sk-你的DeepSeekAPIKey替换为你在 DeepSeek Platform 获取的真实 Key例如ANTHROPIC_AUTH_TOKEN:sk-18bac0db1efe4d3c9e840cf1657b92405.4 配置项说明配置项正确值说明ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic✅ DeepSeek 的 Anthropic 兼容端点注意是/anthropic后缀不是根路径ANTHROPIC_AUTH_TOKEN你的 DeepSeek API Key从 DeepSeek Platform 获取ANTHROPIC_MODELdeepseek-v4-pro[1m]DeepSeek V4 主模型1M 上下文ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m]Claude Code 内部调用 OpUS 模型时映射到这里ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m]Claude Code 内部调用 Sonnet 模型时映射到这里ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flashClaude Code 内部调用 Haiku 模型时映射到这里CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash子任务使用的快速模型CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1禁用非必要流量官方遥测等国内必须设5.5 常见错误写法务必避免❌错误1BASE_URL 写成了 OpenAI 端点ANTHROPIC_BASE_URL:https://api.deepseek.comDeepSeek 的根路径是 OpenAI 协议Claude Code 用 Anthropic 协议访问会报错。必须带/anthropic后缀。❌错误2使用了已下线的旧模型名ANTHROPIC_MODEL:deepseek-chatdeepseek-chat和deepseek-reasoner已于2026年7月24日下线必须改用deepseek-v4-pro[1m]。❌错误3缺少内部模型映射如果只配了ANTHROPIC_MODELClaude Code 内部调用 Opus/Sonnet/Haiku 子模型时会找不到导致部分功能报错。必须配置全部 4 个模型映射。6. 验证配置是否成功6.1 重启 VSCode必须完全关闭 VSCode所有窗口然后重新打开使新配置生效。6.2 测试对话在 VSCode 中打开任意文件夹项目点击左侧Claude 图标在对话框中输入你好如果正常回复说明配置成功 ✅6.3 跳过登录提示VSCode 插件可能提示登录不用管点击右上角的“跳过登录”或直接忽略即可——因为我们用的是 DeepSeek API不需要 Anthropic 账号。7. 常见问题Q1PowerShell 提示 “claude 不是内部或外部命令”原因npm 全局安装路径未加入 PATH。解决重启 PowerShell 窗口如果仍不行检查 npm 全局安装位置npm list-g anthropic-ai/claude-code查看输出中的路径将该路径下的bin目录加入 PATH 环境变量。Q2Claude Code 提示 “There’s an issue with the selected model”原因模型名写错使用了已下线的deepseek-chat或 BASE_URL 写错缺少/anthropic后缀。解决重新检查settings.json确保第5步的配置完全正确然后完全重启 VSCode。Q3提示需要登录/登录失败原因配置未生效或配置文件路径不对。解决确认文件在C:\Users\用户名\.claude\settings.json确认 VSCode 已完全关闭并重启在 PowerShell 中验证配置文件内容Get-Content$env:USERPROFILE\.claude\settings.jsonQ4API 调用报错 “401 Unauthorized”原因API Key 填错或 Key 已失效。解决重新到 https://platform.deepseek.com/api_keys 检查 Key 是否正确确认账户余额充足。Q5响应很慢或超时原因DeepSeek API 服务器在国内响应速度正常较快如果很慢可能是网络问题或 API 限流。解决检查 DeepSeek Platform 的用量统计确认是否触发了 Rate Limit。Q6想用其他国内模型如豆包、硅基流动以下提供参考配置方法完全相同只需修改配置文件中的 URL 和模型名豆包字节跳动{env:{ANTHROPIC_BASE_URL:https://ark.cn-beijing.volces.com/api/coding,ANTHROPIC_AUTH_TOKEN:你的豆包API Key,ANTHROPIC_MODEL:doubao-seed-2.0-code,ANTHROPIC_DEFAULT_OPUS_MODEL:doubao-seed-2.0-code,ANTHROPIC_DEFAULT_SONNET_MODEL:doubao-seed-2.0-code,ANTHROPIC_DEFAULT_HAIKU_MODEL:doubao-seed-2.0-code,CLAUDE_CODE_SUBAGENT_MODEL:doubao-seed-2.0-code}}硅基流动SiliconFlow{env:{ANTHROPIC_BASE_URL:https://api.siliconflow.cn/v1,ANTHROPIC_AUTH_TOKEN:你的硅基流动API Key,ANTHROPIC_MODEL:deepseek-ai/DeepSeek-V3,ANTHROPIC_DEFAULT_OPUS_MODEL:deepseek-ai/DeepSeek-V3,ANTHROPIC_DEFAULT_SONNET_MODEL:deepseek-ai/DeepSeek-V3,ANTHROPIC_DEFAULT_HAIKU_MODEL:deepseek-ai/DeepSeek-V3,CLAUDE_CODE_SUBAGENT_MODEL:deepseek-ai/DeepSeek-V3}}使用建议Claude Code 工作模式选择在 VSCode 中使用 Claude Code 时可以选择不同的工作模式模式说明适用场景Manual每次修改前需确认✅ 推荐默认安全可控Edit automatically自动修改代码批量重构时用Plan先分析计划确认后再执行复杂任务Auto安全操作自动执行有风险时询问效率优先Effort 滑块控制 AI 思考深度Low快速响应适合简单修改Medium适中默认推荐High深度分析适合复杂重构总结本文完整覆盖了以下内容✅ 安装 Node.jsLTS 版✅ 通过 npm 安装 Claude Code CLI✅ 安装 VSCode Claude Code 官方插件✅ 注册 DeepSeek Platform 并获取 API Key✅ 正确配置settings.jsonAnthropic 兼容端点 新模型名✅ 验证配置是否生效✅ 常见问题排查按照以上步骤操作即可在 Windows VSCode 环境下免费使用 Claude Code 接入 DeepSeek-V4 模型进行 AI 辅助编程。 如果觉得有帮助欢迎在 CSDN 评论区留言交流 
`)
