主题
macOS 平台安装 Node.js
Claude Code、CodeX 和 Gemini CLI 都需要 Node.js 18+ 运行环境。
提示
如果已安装 Node.js 18 或更高版本,可跳过此章节。验证命令:node -v
方法一:Homebrew 包管理器(推荐)
首先,如果未安装 Homebrew,执行以下命令安装:
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"然后安装 Node.js:
bash
brew install node验证版本信息:
bash
node --version
npm --version方法二:官方安装包
- 访问 Node.js 官方网站
- 下载 LTS 版本的
.pkg安装包 - 运行安装程序并按提示完成
验证安装
在终端中执行:
bash
node --version
npm --version成功显示版本号(如 v18.x.x 或更高版本)表示安装完成。
常见问题
Homebrew 安装速度慢
使用国内镜像加速:
bash
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"权限问题
避免使用 sudo,改为修复 Homebrew 权限:
bash
sudo chown -R $(whoami) /usr/local/bin /usr/local/lib下一步
环境配置完成后,继续部署相关工具: