外观
macOS 平台安装 Node.js
Claude Code、Codex CLI、Gemini CLI 都基于 Node.js，需要先装好运行环境。
需要什么版本
Node.js 18 或更高版本，推荐当前 LTS（20 或 22）。
方法一：官方安装包
- 打开 https://nodejs.org/zh-cn
- 下载标着 LTS 的 macOS Installer（
.pkg） - 双击安装，按提示完成
验证：
bash
node -v
npm -v方法二：Homebrew（推荐）
Mac 上最省心的方式：
bash
# 如果还没装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js
brew install node
# 验证
node -vApple Silicon 与 Intel
Homebrew 会自动选择匹配你芯片架构的版本，M 系列和 Intel 机器都不用特殊处理。
方法三：nvm（需要多版本切换）
bash
brew install nvm
mkdir -p ~/.nvm
# 把下面两行加入 ~/.zshrc
export NVM_DIR="$HOME/.nvm"
[ -s "$(brew --prefix nvm)/nvm.sh" ] && \. "$(brew --prefix nvm)/nvm.sh"
# 重新加载配置后
nvm install --lts
nvm use --lts安装客户端工具
bash
npm install -g @anthropic-ai/claude-code
npm install -g @openai/codex
npm install -g @google/gemini-cli全局安装权限
如果报 EACCES 权限错误，不要用 sudo npm install -g（会导致后续一堆权限问题）。正确做法是：
bash
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc然后再执行安装命令。
常见问题
提示 command not found: node
PATH 没生效。执行 source ~/.zshrc，或者关掉终端重开。
提示需要 Xcode Command Line Tools
某些依赖需要编译，安装一下即可：
bash
xcode-select --installnpm 安装慢
bash
npm config set registry https://registry.npmmirror.com