@anthropic-ai/claude-code 安装报错 Node.js 版本过低解决方法
问题描述
安装 @anthropic-ai/claude-code 时报错：
npm WARN EBADENGINE Unsupported engine {
npm WARN EBADENGINE package: '@anthropic-ai/[email protected]',
npm WARN EBADENGINE required: { node: '>=18.0.0' },
npm WARN EBADENGINE current: { node: 'v16.20.1', npm: '9.7.1' }
}
该错误表明当前 Node.js 版本为 v16.20.1，而 @anthropic-ai/claude-code 包要求 Node.js 版本不低于 v18.0.0。
解决方案：升级 Node.js
建议将 Node.js 升级到 v18 或更高版本。以下是三种主流方法：
方法一：使用 nvm（推荐）
适用于开发环境，可灵活管理多个版本。
- 安装 nvm（如未安装）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
- 使配置生效：
重启终端或执行
source ~/.bashrc（或~/.zshrc）。 - 安装并切换到 v18+ 版本：
nvm install --lts
# 或指定版本
nvm install 18.19.0
- 设置为默认版本（可选）：
nvm alias default node
方法二：使用 Conda（适用于 Anaconda 环境）
如果你处于 (base) 环境中，可直接通过 Conda 更新：
conda install -c conda-forge nodejs=20
方法三：使用 NodeSource 仓库（Linux/Ubuntu）
适用于服务器或生产环境：
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
验证与重新安装
升级完成后，请执行以下步骤：
- 检查版本：
node -v
确保显示 v18.x.x 或更高版本。
- ： 如果使用 nvm 管理版本，通常无需 ：
