这篇就是奔着把这个前置环境彻底讲透去的,话不多说,直接从为什么绕不开Node.js开始。
1. 为什么装Claude Code必须先搞定Node.js
1.1 Node.js到底是干什么的
很多第一次接触Claude Code的朋友,一看到“请先安装Node.js”就懵了:我用的明明是一个AI编程助手,怎么还要装编程环境?这跟Java程序的JRE、Python程序的解释器是一回事——Claude Code本身是用JavaScript/TypeScript写的命令行工具,而JavaScript代码不能凭空在操作系统里跑,需要有一个“运行时”来解释执行它。浏览器就是个典型的JavaScript运行时,只不过它被限制在网页里;Node.js则是把JavaScript从这个限制里解放出来,让你能在终端、服务器、桌面系统上直接运行JS代码。
npm又是另一个关键角色。你可以把它理解成“Node世界的应用商店”,绝大多数JavaScript工具链都通过npm分发和安装,Claude Code就是其中之一。npm随着Node.js一起安装,所以这条依赖链就串起来了:想要用npm安装Claude Code,就得先有Node.js;想要让Claude Code以后能正常升级、加载依赖,也得靠Node.js这个底座。不装它,后面连安装命令都跑不起来,卡在第一步非常难受。
1.2 为什么我不建议你直接装“最新版”
打开Node.js官网,你会看到两个下载按钮:左边是LTS(Long Term Support,长期维护版),右边是Current(尝鲜版)。很多急性子用户直奔右边,觉得版本越高越厉害,这恰恰是后面一堆报错的开端。
Claude Code官方给出的运行要求是Node.js 18及以上版本,这个门槛不算高,但问题在于第三方工具链、依赖包往往不会第一时间适配最新版Node。我记得有段时间不少人在终端里看到“a later version of node.js”这类的提示,其实就是你本地Node版本太低,不满足某个依赖的最低要求。反过来,如果你装的是Current尝鲜版,也容易踩到某些依赖还没来得及兼容的坑。搜索热词里那个“error installing 24.20.0: node.js v24.20.0 is not yet released or is not available”就是典型反面教材——有人照着网上的教程去装一个根本不存在的、脑补出来的小版本号,结果浪费了大量时间。
所以我的建议很简单:装官网左侧那个LTS版本,别碰Current。LTS版本意味着官方会持续打补丁维护很多年,稳定性优先级最高,Claude Code这种持续迭代的工具,对LTS的兼容性是最好的。如果机器上已经有Node,先跑一句node -v看看版本号,低于18就老老实实升到LTS。
1.3 装Node.js的三条路线怎么选
安装Node.js主要有三种方式:官方安装包、系统包管理器、版本管理器(nvm)。我给不同人群的建议完全不同。
如果你是Windows用户,或者只是想尽快把Claude Code跑起来的普通用户,直接用官方安装包最省心,下载一个.msi文件,双击点“下一步”就完事,PATH环境变量它会自动帮你配好。macOS用户也差不多,官方pkg或者通过Homebrew安装都很合适。Linux用户则要留心一个坑:用apt或yum直接从系统源装Node,版本通常非常老旧。比如某些Ubuntu LTS版本自带的Node只有10.x或12.x,压根不满足Claude Code的18+要求。所以Linux下更推荐用nvm(Node Version Manager)来装,后面我会单独讲。
版本管理器适合两类人:一类是需要在多个Node版本之间反复横跳的开发者,另一类是Linux下不想被系统源坑的人。它相当于一个“Node版本切换器”,想用18就用18,想切到20就切到20,不需要卸载重装。不过对纯小白来说,这东西多了一层概念负担,如果在Windows上还非得用nvm-windows去折腾,性价比不高。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Windows下安装Node.js的完整实操
2.1 下载安装包这一步最关键
Windows用户请直接打开Node.js官网下载页面,找到标注着“LTS”的版本,点下载。这里要特别盯紧两件事:第一,别点成右侧的Current版;第二,系统位数要选对,现在绝大多数电脑都是64位系统,下载Windows Installer (.msi)的64位版本,看不出位数就右键“此电脑”看属性,x64就是64位。
下载完成后双击.msi文件进入安装向导。第一次装的时候,一路Next没什么问题,但有几个关键点必须注意。第一页勾选“I accept the terms in the License Agreement”之后,安装路径建议保持默认的C:\Program Files\nodejs,不要自以为是地改成中文路径或者带空格的奇怪路径,后面全局安装依赖时容易出各种幺蛾子。到“Custom Setup”这一步,默认全选即可,尤其要确认“Add to PATH”这个选项是勾选状态,它会把Node和npm的目录写进系统环境变量,少了这一步,你打开终端敲node -v就提示“不是
