macOS 平台安装 Node.js

AI 编程工具的常用运行环境。

重要说明

Claude Code 和 Codex 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

方法二：官方安装包

1. 访问 Node.js 官网：https://nodejs.org
2. 下载 LTS 版本的 .pkg 安装包。
3. 运行安装程序并按照提示完成安装。

验证安装

打开终端，执行：

node --version
npm --version

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

常见问题

Homebrew 安装慢

可以使用国内镜像：

export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"

权限问题

如果遇到权限问题，不要直接使用 sudo 安装 Node.js，而是先修复 Homebrew 权限：

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

下一步

✅ 环境准备完成！

现在您可以继续安装 Claude Code、Codex CLI、Codex Desktop 或 OpenCode 了。

• 安装 Claude Code
• 安装 Codex CLI
• 安装 Codex Desktop
• 安装 OpenCode