准备工作：配置必需的 Node.js 环境
Claude Code CLI 是一个基于 Node.js 的工具，其成功安装和运行严格依赖于系统中的 Node.js 版本。
为什么必须使用较新版本的 Node.js？
Claude Code 的开发者在其包配置中明确指定了所支持的 Node.js 最低版本。如果使用低于要求的版本进行安装，包管理器 (npm) 会无法正确处理依赖关系，并抛出一系列警告，最终导致安装失败或即使安装完成也无法运行。
例如，在 Node.js v14 的环境中尝试安装，会收到如下错误日志：
npm WARN notsup Unsupported engine for @anthropic-ai/[email protected]: wanted: {"node":">=18.0.0"}(current: {"node":"14.18.3","npm":"6.14.15"})npm WARN notsup Not compatible with your version of node/npm: @anthropic-ai/[email protected]
这行日志清晰地指出：claude-code 包要求 (wanted) Node.js 版本大于等于 18.0.0，但当前环境的版本是 14.18.3，因此不兼容。忽略这些警告将导致后续使用时出现问题。
检查并安装正确的 Node.js 版本
- 确认版本要求：请确保输出的版本号为 v18.0.0 或更高。
- 安装与管理 (推荐使用 nvm)：如果版本不符，强烈建议使用 nvm (Node Version Manager) 来进行安装和版本管理。nvm 可以在同一台电脑上维护多个 Node.js 版本并轻松切换。完成切换后，再次运行
node -v进行确认。- 安装 nvm：
- macOS / Linux: 参考 nvm-sh/nvm GitHub 官方指南。
- Windows: 使用 nvm-windows（适配 Windows 的 nvm 版本），具体步骤如下（Node.js 自带 npm 包管理器，旧版本 Node/npm 会与 nvm 管理的版本冲突，需先彻底清理）：
- 备份 npm 自定义配置（可选）：按
Win + R输入%AppData%\npm打开文件夹，若存在etc\npmrc文件，复制到桌面备份；无该文件则直接跳过。 - 卸载旧版 Node.js：打开「控制面板」→「程序和功能」，找到所有名称包含「Node.js」的程序，右键选择「卸载」并按提示完成。
- 删除 Node/npm 残留文件夹：
- 按
Win + R输入C:\Program Files\nodejs（或C:\Program Files (x86)\nodejs），若文件夹存在则删除； - 再次按
Win + R分别输入%AppData%\npm和%AppData%\npm-cache，若文件夹存在则删除。
- 按
- 下载 nvm-windows 1.2.2 安装包：打开 ，下拉到「Assets」（资源）区域，点击 下载（新手推荐此一键安装包）。
- 备份 npm 自定义配置（可选）：按
- 安装 nvm：
