macOS 平台安装 Node.js

在 macOS 上配置 Node.js 运行环境，为使用 Claude Code 等 AI 编程工具做准备。

安装方法

方法一：使用 Homebrew（推荐）

Homebrew 是 macOS 最流行的包管理器。

brew install node

安装完成后验证：

node --version
npm --version

方法二：官方安装包

1. 访问 Node.js 官网
2. 下载 macOS LTS 版本（.pkg 文件）
3. 双击运行安装程序
4. 按提示完成安装

方法三：使用 nvm

nvm (Node Version Manager) 可以管理多个 Node.js 版本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

重启终端后安装 Node.js：

nvm install 18
nvm use 18
nvm alias default 18

验证安装

node --version   # 应输出 v18.x.x
npm --version    # 应输出 9.x.x

常见问题

Homebrew 下载慢？

可以切换到国内镜像源：

# 替换 Homebrew 镜像
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
brew update

权限问题？

如果遇到 npm 全局安装权限问题，推荐使用 nvm 代替 Homebrew 安装，nvm 自动处理权限问题。

或者使用以下命令修复：

sudo chown -R $(whoami) ~/.npm

配置环境变量

设置 API Key 环境变量：

# 添加到 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_AUTH_TOKEN="your-api-key-here"
export ANTHROPIC_BASE_URL="https://ai.nebulatrip.com"

然后重新加载配置：

source ~/.zshrc   # 或 source ~/.bashrc

下一步

安装完成后，您可以继续：

• 部署 Claude Code — 安装和配置 Claude Code
• 部署 CodeX — 安装和配置 CodeX
• 部署 Gemini CLI — 安装和配置 Gemini CLI