保姆级教程：Windows 丝滑安装 Claude Code + 第三方 API 对接 DeepSeek 完整方案(含下载)

速通教程四步十分钟第一步安装claude codewinr输入cmd回车粘贴这条命令npm install -g anthropic-ai/claude-code等待片刻即可第二步创建apikey打开DeepSeek官网选择API开放平台按需冲1-2额度创建一个API-key,复制下来第三步使用ccswitch连接claude code和DeepSeek打开cc-switch(压缩包里的其中一个软件)点右侧➕选择Ds往下滑动找到apikey那栏粘贴刚才创建的apikey拉到最下面勾选1m上下文长度限制点击保存添加即可第四步打开Claude验证winr输入cmd回车命令行输入Claude即可启动Claude code若有哪一步未成功可继续看下面的若仍未解决欢迎提问相关说明一、前言最近很多小伙伴反馈 Anthropic 官方 Claude Desktop 无法直连下载且仅原生支持 Claude 系列模型想使用 DeepSeek、Kimi 等第三方大模型会直接受限。 本文分两大块Windows 系统 CMD 通过 npm 离线安装 Claude Code 客户端完整步骤解决官网打不开无法安装问题CC Switch 配置第三方 API 模型映射实现 DeepSeek 模型兼容 Claude Desktop 本地路由。前置说明官方现已不主推 npm 安装方案优先推荐官方一键脚本但国内网络环境下脚本极易超时失败因此本文提供 npm 备用安装方案适配国内 Windows 用户。二、前置环境准备安装 Node.js---------------npm 依赖 Node.js 运行未安装会直接报错先完成环境部署。打开浏览器访问 nodejs.org下载 LTS 长期稳定版安装包双击安装包一路默认下一步无需修改配置验证安装是否成功快捷键 Win R输入 cmd 回车打开命令提示符输入校验命令node --version输出类似 v18.17.0 版本号即代表安装成功若提示 “不是内部或外部命令”重启 CMD 重试仍报错则重新安装 Node.js 并勾选 Add to PATH。三、npm 全局安装 Claude Code3.1 执行安装命令在 CMD 窗口输入全局安装指令等待依赖拉取完成国内网络慢可能耗时 3-5 分钟耐心等待不要关闭窗口npm install -g anthropic-ai/claude-code3.2 校验安装成果安装结束后输入版本查看命令输出版本号即安装完成claude --version四、Claude Code 客户端更新命令后续官方推送新版本时二选一执行更新指令即可# 方式1 claude install # 方式2 claude update五、突破限制CC Switch 对接 DeepSeek 第三方模型实操截图配置后续官方推送新版本时二选一执行更新指令即可原生 Claude Desktop 仅放行 Claude 系列模型 ID调用 DeepSeek、Kimi 等第三方模型会拦截报错需要开启模型映射 本地路由配置步骤如下https://www.deepseek.com/ 需官方api创建api-key,建议复制保存5.1 开关基础配置进入「添加新供应商」页面打开顶部 需要模型映射 开关说明Claude Desktop 默认限制模型 ID接入非 Claude 系列模型必须开启此开关全程使用软件时保持本地路由处于开启状态。打开cc-switch选择DeepSeek只需要填写一个api key5.2 API 格式选择下拉框选择Anthropic Messages (原生)适配 Claude 原生请求协议。5.3 模型映射规则配置核心逻辑-模型角色绑定 Claude 原生角色分类Sonnet/Haiku-菜单显示名自定义客户端侧边栏展示的模型名称方便区分-实际请求模型填写第三方服务商真实模型 ID接口请求会以此字段下发-声明支持 1M勾选开启百万上下文窗口。模型角色菜单显示名实际请求模型支持 1M 上下文Sonnetdeepseek-v4-prodeepseek-v4-pro✅ 勾选Haikudeepseek-v4-flashdeepseek-v4-flash✅ 勾选操作按钮说明「获取模型列表」自动拉取服务商支持的全部模型 ID「添加模型」新增一行映射规则可同时接入多款大模型5.4 保存配置全部参数填写完毕点击右下角蓝色「 添加」按钮保存供应商配置即可在 Claude Desktop 内切换 DeepSeek 模型使用。六、常见问题汇总1.npm 安装超时卡住 解决方案切换淘宝镜像源CMD 执行npm config set registry https://registry.npmmirror.com2.claude --version 提示命令不存在 解决方案检查 Node.js 环境变量是否配置成功关闭全部 CMD 窗口重新打开重试3.第三方模型调用报错 400 / 模型不存在 解决方案核对「实际请求模型」字段 ID 是否与服务商文档一致确认模型映射开关已打开、本地路由正常运行。七、补充说明网络提示官方脚本安装国内网络极易超时npm 方案为国内用户最优替代方案模型拓展该映射逻辑不止适配 DeepSeekKimi、通义千问、Llama 等开源 / 商用模型均可套用相同配置模板安全提醒第三方 API 密钥妥善保管不要明文分享至公网。