Skip to content

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

方法二:官方安装包

  1. 访问 Node.js 官方网站
  2. 下载 LTS 版本的 .pkg 安装包
  3. 运行安装程序并按提示完成

验证安装

在终端中执行:

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

下一步

环境配置完成后,继续部署相关工具:

和谐、友善、互助、开心