最近要给机器装个 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,还支持 denobun。以后想升级 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 10pnpm 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 中使用本文步骤。