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

本指南适用于 Ubuntu 系统 下的普通用户（无需 sudo 权限），通过 nvm（Node Version Manager）在用户目录下安装 Node.js 22，并全局安装 @anthropic-ai/claude-code 工具。

📋 前置条件

系统已安装 curl 和 git （如未安装，请执行 sudo apt install curl git -y，需要 sudo）。

拥有一个普通用户账户（如 zhangsan），能访问互联网（可能需要代理或国内镜像）。

🚀 安装步骤（一键复制执行）

1. 安装 nvm（使用 Gitee 镜像，解决 GitHub 访问慢）

bash 复制代码

# 克隆 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"' >> ~/.bashrc

2. （可选）配置 nvm 使用国内镜像加速 Node.js 下载

bash 复制代码

echo 'export NVM_NODEJS_ORG_MIRROR=https://mirrors.tuna.tsinghua.edu.cn/nodejs-release' >> ~/.bashrc
source ~/.bashrc

3. 安装 Node.js 22 并设为默认版本

bash 复制代码

nvm install 22
nvm alias default 22
nvm use 22

4. 验证 Node.js 版本

bash 复制代码

node -v   # 应输出 v22.x.x
which node  # 应指向 ~/.nvm/versions/node/v22.x.x/bin/node

5. 配置 npm 使用淘宝镜像（加速包下载）

bash 复制代码

npm config set registry https://registry.npmmirror.com

6. 清理可能的残留（避免 ENOTEMPTY 错误）

bash 复制代码

# 强制清理 npm 缓存
npm cache clean --force

# 删除可能遗留的 claude-code 目录（如果存在）
rm -rf ~/.nvm/versions/node/*/lib/node_modules/@anthropic-ai/claude-code 2>/dev/null

7. 全局安装 Claude Code

bash 复制代码

npm install -g @anthropic-ai/claude-code

# 如果下载仍然缓慢，可临时指定镜像源：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

8. 验证安装

bash 复制代码

claude --version   # 显示版本号即成功

9. 配置 Claude Code 的环境变量（核心步骤）

9.1 打开配置文件

bash 复制代码

mkdir -p ~/.claude
nano ~/.claude/settings.json

9.2 填写 Claude Code 配置（复制即可）

bash 复制代码

{
  "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 部署，有效规避了权限和网络问题，适合在共享环境或个人开发机中复用。