Node.js 与 Claude-Code 环境部署指南
本文介绍在 E 盘部署 Node.js 环境并安装 claude-code 的完整流程及路径冲突解决方案。
一、准备工作：安装 Node.js（E 盘部署）
1. 下载 Node.js
- 官网地址：Node.js 中文网
- 选择Windows 64 位安装包（.msi 格式），下载后双击安装。
2. 关键步骤：自定义安装到 E 盘
- 安装时选择'Custom'自定义路径，将安装目录改为
E:\Node.js（避免默认 C 盘占用空间）； - 勾选'Add to PATH'（自动添加系统变量，后续可省手动配置步骤）。
二、踩坑 1：npm 被错误生成为'文件'而非'文件夹'
安装完成后打开 E:\Node.js 目录，会发现一个名为 npm 的文件（而非文件夹）——这是后续路径冲突的根源！
解决方法：手动修正 npm 目录
- 打开
E:\Node.js，删除名为npm的文件（注意不要删npm.cmd/npm.ps1）； - 在同一目录下新建一个名为
npm的文件夹；
打开 PowerShell，执行以下命令配置 npm 路径：
# 解除 PowerShell 脚本执行限制（临时生效）
Set-ExecutionPolicy Bypass -Scope Process
# 配置 npm 全局包路径到 E 盘新建的文件夹
npm config set prefix "E:\Node.js\npm"
# 配置 npm 缓存路径
npm config set cache "E:\Node.js\npm-cache"
三、安装 Git：为什么需要 Git？
很多 npm 包（包括 claude-code）的依赖会从 GitHub 拉取资源，安装 Git 能避免'依赖拉取失败'的问题。
1. 下载 Git
- 官网地址：Git 下载页
- 选择'64-bit Git for Windows Setup'，默认安装即可（会自动添加到系统变量）。
2. 验证安装
打开 PowerShell 执行：
git --version
显示版本号即安装成功。
四、配置国内镜像源：解决安装速度慢的问题
默认 npm 源在国外，安装包会很慢，需切换到国内镜像：
常用国内镜像源（选其一）
华为云镜像
npm config set registry https://mirrors.huaweicloud.com/repository/npm/
腾讯云镜像
npm config set registry http://mirrors.cloud.tencent.com/npm/
