最近要给机器装个 AI Agent(Claude Code),发现传统的安装方式(先装 Node,再配 nvm/n,再装 agent)步骤太多、环境也容易搞乱。用 pnpm 一条龙搞定:pnpm 本身就能管理 Node.js 运行时,装完 pnpm 连 Node 都不用自己装,直接让 pnpm 拉取 Node LTS,再全局安装 agent 即可,整个过程干净、快速、可复现。
前提:Linux / macOS 环境(Windows 建议用 WSL),已安装 curl。
1. 安装 pnpm
curl -fsSL https://get.pnpm.io/install.sh | sh -
安装完成后,脚本会自动把 pnpm 加入 PATH。如果提示找不到命令,重开一个终端,或执行 source ~/.bashrc(zsh 用户为 ~/.zshrc)后验证:
pnpm -v
2. 用 pnpm 安装 Node.js LTS
不需要手动下载 Node.js 安装包,pnpm 自带的 runtime 管理命令一键搞定:
pnpm runtime set node lts -g
该命令会下载并全局启用 Node.js LTS 版本,验证:
node -v
npm -v
说明:
pnpm runtime(别名rt)除了node,还支持deno、bun。以后想升级 Node,再执行一次pnpm runtime set node lts -g即可,不用碰 nvm 这类工具。
3. 全局安装 Claude Code
pnpm add -g @anthropic-ai/claude-code@latest
验证安装:
claude --version
运行 claude 进入交互界面,登录账号后即可使用。
4. 更新 pnpm
升级 pnpm 本身也很简单,一行命令搞定:
pnpm self-update
也可以指定升级到某个版本:pnpm self-update 10、pnpm self-update 10.6.5。如果 self-update 不可用,直接重跑一遍第 1 步的安装脚本同样能更新到最新版。
更新完验证:
pnpm -v
其他 Agent 同理
同样是 npm 包的话,换包名就行:
pnpm add -g @openai/codex@latest
pnpm add -g @google/gemini-cli
常见问题
-
下载慢/超时:可切换 npm 镜像源后重试:
pnpm config set registry https://registry.npmmirror.com -
升级 Agent:重新执行
pnpm add -g @anthropic-ai/claude-code@latest即可覆盖为最新版。 -
Windows 本机:
get.pnpm.io/install.sh是 shell 脚本,Windows 请通过corepack或 scoop 安装 pnpm,或在 WSL 中使用本文步骤。