Windows 平台安装 Node.js
Claude Code、Codex、Gemini CLI 等工具都依赖 Node.js 环境。推荐直接安装 LTS 版本。
完整 CLI 接入流程见 Windows 快速接入。
本文里的 PowerShell 命令，统一放在 管理员身份运行 的 PowerShell 里执行更稳。这样安装 Node.js、Git 和后面的全局 CLI 时更少遇到权限不足。
安装 Node.js 的目标不是“多装一个软件”，而是让系统拥有 node 和 npm 两个命令。node 用来运行 JavaScript CLI，npm 用来下载和更新 Claude Code、Codex、Gemini CLI 等工具。
后面准备装的是下面这些工具时：
- Claude Code 的 npm 版本
- Codex
- Gemini CLI
- OpenCode
- 其他 npm 全局安装的 AI CLI
那 Node.js 基本都绕不过去。先把这一层装稳，后面很多“命令不存在”“npm 装不上”“版本太旧”的问题都会少很多。
方法一：浏览器下载安装包（推荐）
浏览器下载安装时，国内用户可以按这个顺序选：
- Node.js 中文站：https://nodejs.cn/download
- Node.js 镜像归档：https://npmmirror.com/mirrors/node/
- Node.js 英文官网：https://nodejs.org/en/download
第一次安装优先打开 Node.js 中文站。页面是中文，能直接看到 Windows 安装包、macOS 安装包和不同架构选项，新手不容易点错。
第一次最容易犹豫的是“应该选 Current 还是 LTS”。
不是为了测试最新特性时，优先选 LTS。LTS 的意义不是“更旧”，而是生态兼容性通常更稳，后面装 CLI 时踩版本坑的概率更低。
Windows 常用选择：
txt
Windows 安装包 (.msi) -> 64 位下载后双击安装，保持默认选项。安装完成后重新打开终端。
使用镜像归档时：
- 打开最新的 LTS 版本目录
- Windows 64 位电脑选择
node-v版本号-x64.msi - 下载后双击安装
安装选项保持默认即可。看到 Add to PATH 时不要取消，它会把 node 和 npm 加进系统命令路径。
Add to PATH 的作用，就是让你后面在 PowerShell 里直接输入：
powershell
node -v
npm -v系统也能认得这两个命令。
如果这一步被取消，软件可能已经装上了，但终端里还是会表现成“命令不存在”。
方法二：包管理器安装
使用 Winget
powershell
winget install OpenJS.NodeJS.LTS使用 Chocolatey
powershell
choco install nodejs-lts使用 Scoop
powershell
scoop install nodejs-lts安装 Git
Claude Code、Codex 处理代码仓库时经常会调用 Git。建议在安装 CLI 工具前先装好 Git。
Git 装好后，这些工具才能更准确地读取仓库状态、查看改动、生成 diff，也能在 Windows 上提供 Git Bash 这个更接近 Linux 的终端环境。
安装方式建议按这个顺序选：
- 直接用
winget - Git for Windows 官方站
- Git 官网下载页
不想手动找安装包，或者浏览器下载慢时，优先直接用 winget：
powershell
winget install --id Git.Git -e --source winget浏览器下载入口：
- Git 官网：https://git-scm.com/download/win
- Git for Windows：https://gitforwindows.org/
下载慢时，可以使用可信的软件管家或镜像源里的 Git for Windows 安装包。安装后能正常输出 git --version 即可继续。
安装时保持默认选项。安装完成后，开始菜单里会多出 Git Bash，适合运行需要类 Linux shell 的工具。
只看“能不能装 CLI”时，很容易觉得 Git 可有可无。
但只要你后面要让 Claude Code、Codex 这类工具处理真实项目，Git 基本就是它们理解当前仓库状态的基础设施之一。
验证安装
验证不是走流程，而是确认命令已经写入 PATH。只有下面三条都能输出版本号，后续工具安装才不会因为“命令不存在”中断。
powershell
node -v
npm -v
git --version能正常输出版本号就说明环境好了。
想再确认得彻底一点，可以顺手看：
powershell
where node
where npm
where git只要这些命令都能定位到实际路径，后面大多数 CLI 安装问题就不会再停留在“环境根本没装好”这一层。
建议再配置 npm 镜像源。它可以加快 npm 下载速度，减少安装 CLI 时卡在依赖下载的情况：
powershell
npm config set registry https://registry.npmmirror.com
npm config get registry第二行输出 https://registry.npmmirror.com/ 就生效了。
终端怎么选
- PowerShell：Windows 默认终端，适合复制本文里的 PowerShell 命令。
- CMD：兼容旧命令，日常配置优先使用 PowerShell。
- Git Bash：安装 Git 后自带，更适合运行 Claude Code 这类会调用 shell 的工具。
优先用 PowerShell。遇到 Claude Code 执行 shell 命令异常时，再改用 Git Bash 或 WSL。
后面在 PowerShell 里遇到：
txt
running scripts is disabled on this system那通常不是 Node.js 没装好，而是 PowerShell 执行策略还没放开。
这种情况直接回 Windows 快速接入 处理执行策略，再继续往下装 CLI 会更顺。
常见问题
提示“不是内部或外部命令”
这是环境变量没生效。先关掉当前终端，再重新打开；还不行就重启电脑。
还不行就检查：
powershell
where node
where npm
where git查不到路径，说明安装目录没有写进 PATH。重新安装 Node.js 或 Git，并保留默认 PATH 选项。
安装失败
先检查：
- 是否被杀毒软件拦截
- 是否没有管理员权限
- 是否下载了错误的安装包架构
Node.js、Cherry Studio、Claude Code 等新工具主要面向 Windows 10/11。旧系统遇到兼容问题时，建议升级系统或改用受支持环境。
npm 安装很慢
先确认镜像源：
powershell
npm config get registry不是 https://registry.npmmirror.com/ 时重新设置：
powershell
npm config set registry https://registry.npmmirror.com如果公司网络拦截 HTTPS，可以换手机热点确认是否为网络策略问题。
明明装过了，版本却不是刚装的那个
这通常说明你机器里可能已经有旧版 Node.js，当前终端读到的是旧路径。
优先检查：
powershell
where node
node -v如果 where node 显示了多个路径，就先弄清当前到底在用哪一个，再决定是保留一个版本，还是清理旧版本。