安装 Claude Code 完整指南（用户级 Node.js 环境）

本指南适用于Ubuntu 系统下的普通用户无需sudo权限通过nvmNode Version Manager在用户目录下安装 Node.js 22并全局安装anthropic-ai/claude-code工具。 前置条件系统已安装curl和git如未安装请执行sudo apt install curl git -y需要 sudo。拥有一个普通用户账户如 zhangsan能访问互联网可能需要代理或国内镜像。 安装步骤一键复制执行1. 安装 nvm使用 Gitee 镜像解决 GitHub 访问慢# 克隆 nvm 仓库到用户目录 git clone https://gitee.com/mirrors/nvm.git ~/.nvm # 加载 nvm 到当前 shell export NVM_DIR$HOME/.nvm [ -s $NVM_DIR/nvm.sh ] \. $NVM_DIR/nvm.sh # 永久生效写入 ~/.bashrc echo export NVM_DIR$HOME/.nvm ~/.bashrc echo [ -s $NVM_DIR/nvm.sh ] \. $NVM_DIR/nvm.sh ~/.bashrc2. 可选配置 nvm 使用国内镜像加速 Node.js 下载echo export NVM_NODEJS_ORG_MIRRORhttps://mirrors.tuna.tsinghua.edu.cn/nodejs-release ~/.bashrc source ~/.bashrc3. 安装 Node.js 22 并设为默认版本nvm install 22 nvm alias default 22 nvm use 224. 验证 Node.js 版本node -v # 应输出 v22.x.x which node # 应指向 ~/.nvm/versions/node/v22.x.x/bin/node5. 配置 npm 使用淘宝镜像加速包下载npm config set registry https://registry.npmmirror.com6. 清理可能的残留避免 ENOTEMPTY 错误# 强制清理 npm 缓存 npm cache clean --force # 删除可能遗留的 claude-code 目录如果存在 rm -rf ~/.nvm/versions/node/*/lib/node_modules/anthropic-ai/claude-code 2/dev/null7. 全局安装 Claude Codenpm install -g anthropic-ai/claude-code # 如果下载仍然缓慢可临时指定镜像源 npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com8. 验证安装claude --version # 显示版本号即成功9. 配置 Claude Code 的环境变量核心步骤9.1 打开配置文件mkdir -p ~/.claude nano ~/.claude/settings.json9.2 填写 Claude Code 配置复制即可{ env: { ANTHROPIC_AUTH_TOKEN: sk-XXX, ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, API_TIMEOUT_MS: 3000000, ANTHROPIC_MODEL: deepseek-v4-pro }, theme: dark }将 ANTHROPIC_AUTH_TOKEN的API Key 替换成自己的。将你使用的模型url ANTHROPIC_BASE_URL换成你使用的模型url之后保存Ctrl O → 回车退出Ctrl X 总结本指南采用nvm 国内镜像的组合实现了无需sudo的 Node.js 22 安装和 Claude Code 部署有效规避了权限和网络问题适合在共享环境或个人开发机中复用。