速通教程:(四步十分钟)
第一步(安装claude code):
win+r
输入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验证):
win+r
输入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 Code
3.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 key
5.2 API 格式选择
下拉框选择:Anthropic Messages (原生),适配 Claude 原生请求协议。
5.3 模型映射规则配置
核心逻辑:
-模型角色:绑定 Claude 原生角色分类(Sonnet/Haiku);
-菜单显示名:自定义客户端侧边栏展示的模型名称,方便区分;
-实际请求模型:填写第三方服务商真实模型 ID,接口请求会以此字段下发;
-声明支持 1M:勾选开启百万上下文窗口。
| 模型角色 | 菜单显示名 | 实际请求模型 | 支持 1M 上下文 |
|---|---|---|---|
| Sonnet | deepseek-v4-pro | deepseek-v4-pro | ✅ 勾选 |
| Haiku | deepseek-v4-flash | deepseek-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 方案为国内用户最优替代方案;
模型拓展:该映射逻辑不止适配 DeepSeek,Kimi、通义千问、Llama 等开源 / 商用模型均可套用相同配置模板;
安全提醒:第三方 API 密钥妥善保管,不要明文分享至公网。