Claude Code Windows 小白安装指南

Claude Code Windows 小白安装指南

适用系统：Windows 10 / 11 全程预计耗时：10–15 分钟 阅读说明：严格按顺序操作，每一步都做完再做下一步。遇到红字别慌，文末有「常见问题」。

这份文档会带你做什么

装好之后，你能在自己的电脑上用一个叫 claude 的命令行工具，让 AI 帮你写代码、改 bug、跑脚本。整体路线：

  1. 装 Node.js（claude code 是基于 Node 的命令行程序，必须先有这个底座）

  2. 配 国内 npm 镜像（让下载不卡）

  3. 用 npm 装 claude code 本体

  4. 装 CC Switch（一个 GUI 工具，用来管理 API 供应商，比如 DeepSeek）

  5. 在 CC Switch 里配好 DeepSeek，启动 claude code

关于 nvm 的说明（请先读这一段）

很多教程会先教你装 nvm 再装 Node。对完全的新手，本指南不推荐这条路：

  • nvm 是用来在多个 Node 版本之间切换的工具

  • 你现在只跑 claude code，只需要一个 Node 版本就够用，可能未来一两年都不用换

  • nvm 多一层安装、多一个环境变量、多一个出错点

所以本指南直接装 Node。如果你以后真要管多个 Node 版本，再回头装 nvm 也来得及（文末有「进阶：以后想装 nvm 怎么办」一节）。

第 1 步：安装 Node.js

1.1 下载

打开 Node.js 官网：

https://nodejs.org/zh-cn/download

页面上选 「LTS（长期支持版）」 + 「Windows Installer (.msi)」 + 「64-bit」，下载得到一个类似 node-v22.22.2-x64.msi 的文件。

国内下载慢？ 用华为云镜像，速度通常更快： https://mirrors.huaweicloud.com/nodejs/ 进去找最新的 v22.x.x/，下载里面的 node-v22.x.x-x64.msi。

访问下方链接

https://mirrors.huaweicloud.com/nodejs/v22.22.2/

image

 

1.2 安装

双击下载的 .msi 文件：

  1. 一路点 Next

  2. 「License Agreement」勾选 I accept，下一步

  3. 安装路径默认 C:\Program Files\nodejs\ 即可，下一步

  4. 「Custom Setup」保持默认（npm 已经包含在内），下一步

  5. 「Tools for Native Modules」这一页 不要勾 那个 Automatically install... 复选框（小白不需要 C++ 编译环境，勾了会再下几个 G 的东西），下一步

  6. 点 Install，弹出 UAC 权限提示选 是

  7. 安装完成，Finish

1.3 验证

关键：必须打开一个新的终端窗口（之前已经开着的旧窗口不认新装的程序）。

按 Win + R，输入 cmd，回车。在弹出的黑窗口里输入：

node -v
npm -v

应该看到类似输出：

v22.22.2
10.9.7

只要两行都打印出版本号，第 1 步就成功了。

提示「不是内部或外部命令」？ 见文末「常见问题 Q1」。

第 2 步：配置 npm 国内镜像

国内直连 npm 官方源（registry.npmjs.org）经常下载到一半卡死。装 claude code 之前先把镜像换成淘宝源，能省很多事。

在 cmd 窗口里执行：

npm config set registry https://registry.npmmirror.com

验证一下：

npm config get registry

应该输出：

https://registry.npmmirror.com/

以后想切回官方源（比如某天淘宝镜像有问题），执行： npm config set registry https://registry.npmjs.org

第 3 步：安装 claude code

继续在 cmd 里执行：

npm install -g @anthropic-ai/claude-code

这一步会从淘宝镜像拉取 claude code 及其依赖，正常需要 1–3 分钟。期间窗口里会刷一堆进度行，不要关，等到看到命令提示符回到 C:\Users\xxx> 就是装完了。

3.1 验证

再开一个新的 cmd 窗口（让 PATH 重新加载），输入：

claude --version

看到类似输出就说明装好了：

2.x.x (Claude Code)

提示 'claude' 不是内部或外部命令？ 见文末「常见问题 Q2」。

第 4 步：安装 CC Switch

claude code 默认连的是 Anthropic 官方 API，但官方 API 国内不好买、需要海外卡。CC Switch 是一个 GUI 工具，能让你在「DeepSeek、智谱、Kimi」等多个国产/中转供应商之间一键切换。

4.1 下载

打开 CC Switch 的 GitHub Release 页：

https://github.com/farion1231/cc-switch/releases/latest

在 Assets 里找最新版本对应的 Windows 安装包，文件名形如：

  • CC-Switch_x.x.x_x64-setup.exe（推荐，双击即装）

GitHub 下载慢或打不开？ 在原链接前面拼一个加速前缀： 把 https://github.com/... 改成 https://ghproxy.net/https://github.com/... 例如：https://ghproxy.net/https://github.com/farion1231/cc-switch/releases/latest 这样走的还是官方的同一个二进制，只是经过国内加速节点中转。

4.2 安装

双击下载的 .exe，按提示一路下一步。安装完成会在桌面或开始菜单出现 CC Switch 图标。

第 5 步：在 CC Switch 里配置 DeepSeek

5.1 拿到 DeepSeek 的 API Key

  1. 打开 DeepSeek 开放平台：https://platform.deepseek.com/

  2. 用手机号或邮箱注册并登录

  3. 左侧菜单进入 「API Keys」

  4. 点 「创建 API Key」，给它取个名字（比如 claude-code），创建后立刻复制那串以 sk- 开头的字符串

    • 重要：这个 Key 关闭弹窗后就再也看不到了，必须当场存好

  5. 顺便在 「充值」 里充点余额（最低 1 元起，调用按 token 计费，跑个简单任务几分钱）

5.2 在 CC Switch 里添加 DeepSeek

  1. 打开 CC Switch

  2. 点界面上的 「添加供应商」（按钮文字可能略有差异，找类似 "Add Provider" / "+" 的入口）

  3. 在「供应商类型」下拉里直接选 DeepSeek（CC Switch 已内置预设，URL 都帮你填好了）

  4. 把刚才复制的 API Key（sk-xxxxx...）粘贴到 API Key 字段

  5. 点 保存

  6. 在供应商列表里勾选 / 启用 DeepSeek，让它成为当前激活的供应商

5.3 启动 claude code

回到 cmd 窗口，新开一个（让 CC Switch 注入的环境变量生效），随便建个空文件夹进去：

mkdir C:\Users\%USERNAME%\claude-test
cd C:\Users\%USERNAME%\claude-test
claude

第一次启动会让你选主题（默认 Enter 即可），然后进入 claude 的交互界面。试着问一句：

你好，请用一句话介绍你自己

能正常回复，整套流程就跑通了。退出按 Ctrl + C 两次，或输入 /exit。

常见问题

Q1. 输入 node -v 提示 'node' 不是内部或外部命令

99% 是因为还在用旧的终端窗口。彻底关掉所有 cmd / PowerShell，重新开一个新窗口再试。

如果新窗口还不行：

  1. Win + R 输入 sysdm.cpl，回车

  2. 高级 → 环境变量

  3. 在「系统变量」里找 Path，双击打开

  4. 检查里面是否有 C:\Program Files\nodejs\，没有就点「新建」加上

  5. 一路确定，关掉所有终端重开

Q2. 输入 claude --version 提示 'claude' 不是内部或外部命令

npm 全局安装的命令在 %AppData%\npm 目录，PATH 里需要包含它。

  1. Win + R 输入 %AppData%\npm，回车，应该能看到 claude.cmd 这个文件

  2. 复制地址栏完整路径（类似 C:\Users\你的用户名\AppData\Roaming\npm）

  3. 按 Q1 的步骤打开「环境变量」，把这个路径加进 Path

  4. 关掉所有终端重开

Q3. npm install -g 报权限错误（EACCES / EPERM）

用管理员身份重开 cmd：开始菜单搜 cmd → 右键 → 以管理员身份运行，再执行安装命令。

Q4. CC Switch 切了 DeepSeek，但 claude 还是报 Anthropic 认证错误

CC Switch 是通过修改环境变量让 claude 切换供应商的，对已经打开的终端无效。切换完供应商，关掉旧的 cmd 窗口重开一个，再跑 claude。

Q5. claude 启动后报 model not found 或类似模型不存在错误

DeepSeek 的模型 ID 不是 claude-sonnet-x 这种。CC Switch 的 DeepSeek 预设默认会把模型映射好，如果还是报错，去 CC Switch 的 DeepSeek 配置里检查 模型 字段，常用值：

  • 主模型：deepseek-chat

  • 推理/代码模型：deepseek-reasoner

进阶：以后想装 nvm 怎么办

如果未来你接的项目要求老版本 Node（比如某个项目锁死 Node 18），就得装 nvm-windows 来切换。目前不用动。届时再做：

  1. 先完全卸载当前的 Node.js（控制面板 → 卸载程序 → 找到 Node.js → 卸载）

  2. 去 nvm-windows 的官方 Release 下载 nvm-setup.exe：

  3. 装完用 nvm install 22.22.2 + nvm use 22.22.2 切到当前文档里用的版本

  4. 然后回到本文第 2 步重新走一遍（npm 镜像 + 装 claude code，因为换了 Node 后全局包要重装）

完成后你的电脑上多了什么

名称作用怎么调起来
Node.js (含 npm) JS 运行环境 / 包管理器 cmd 里输 node / npm
claude code AI 编程命令行 cmd 里输 claude
CC Switch API 供应商管理 GUI 桌面 / 开始菜单图标
DeepSeek API Key 访问 DeepSeek 模型的凭证 已存在 CC Switch 里，不用每次填

到此结束。下次想用，任意目录下打开 cmd，输入 claude 就行。

posted @ 2026-05-29 14:44  小钰Kira  阅读(102)  评论(0)    收藏  举报