前言
在 Linux 环境下准备安装使用 Claude,配置步骤类似于 Windows。首先需要安装 Node.js 和 npm,然后执行 Claude 的安装。
使用 sudo apt-get install nodejs npm 安装依赖。
然后安装 Claude:
npm install -g @anthropic-ai/claude-code
结果并不太顺利,报错如下:

问题原因
以上报错主要有两个:Node.js 版本过低和目录权限不足。
- Node.js 版本过低:当前版本为 10.19.0,但 Claude Code 要求 Node.js >= 18.0.0。
- 系统目录权限不足:默认安装路径
/usr/local/lib需要 sudo 权限才能写入。
解决方案
步骤 1:安装 Node Version Manager (nvm)
nvm 是一个工具,可以让你在同一台机器上轻松安装、切换和管理多个 Node.js 版本。这是解决版本冲突的最佳方案。
通过以下命令安装 nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
安装完成后,重新启动终端或执行 source ~/.bashrc(如果是 zsh 则执行 source ~/.zshrc)来加载 nvm。
步骤 2:使用 nvm 安装新版 Node.js
安装一个满足 Claude Code 要求的 Node.js 长期支持(LTS)版本,例如 v18 或 v20。
nvm install 18
nvm use 18
nvm alias default 18
安装完成后,请验证版本是否正确:
node -v
npm -v
步骤 3:配置 npm 全局安装路径
为了避免权限错误,最好的方法是将 npm 的全局包安装路径设置到当前用户拥有写权限的目录下,而不是系统级的 /usr/local/lib。
创建一个新的全局安装目录:
mkdir ~/.npm-global
配置 npm 使用此新路径:
npm config set prefix '~/.npm-global'
将新路径添加到系统的 PATH 环境变量中,这样终端才能找到全局安装的命令。
编辑你的 shell 配置文件(如 ~/.bashrc 或 ~/.zshrc),在文件末尾添加一行:


