macOS 平台

macOS 平台安装 Node.js

三大 AI 编程工具的必备运行环境

💡

重要说明
Claude Code、CodeX 和 Gemini CLI 都需要 Node.js 18+ 运行环境。如果您已安装 Node.js 18 或更高版本，可跳过本章节。验证命令：node -v

方法一：Homebrew 包管理器（推荐）

# 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

# 验证安装
node --version
npm --version

方法二：官方安装包

访问 Node.js 官网：https://nodejs.org

下载 LTS 版本的 .pkg 安装包

运行安装程序并按照提示完成安装

验证安装

打开终端，执行：

node --version
npm --version

如果显示版本号（如 v18.x.x 或更高），说明安装成功。

常见问题

Homebrew 安装慢

可以使用国内镜像：

权限问题

如果遇到权限问题，不要使用 sudo，而是修复 Homebrew 权限：

sudo chown -R $(whoami) /usr/local/bin /usr/local/lib

mac

macOS 平台#

macOS 平台安装 Node.js#

方法一：Homebrew 包管理器（推荐）#

方法二：官方安装包#

验证安装#

常见问题#

Homebrew 安装慢#

权限问题#