Node.js 环境安装

Claude Code、Codex CLI、OpenCode 等 AI 编程工具均依赖 Node.js 运行环境。如果你还没有安装，请先完成此步骤再继续。

Windows

方法一：官方下载（推荐）

1. 访问 nodejs.org，下载 LTS 版本

2. 双击安装包，按提示完成安装

安装程序会询问是否安装额外的构建工具（如 Python、Visual Studio Build Tools），按任意键继续即可，这些工具在使用 npm 安装原生模块时会用到。

3. 安装完成后重启终端

macOS

方法一：Homebrew（推荐）

brew install node

如果尚未安装 Homebrew，先执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

方法二：官方下载

访问 nodejs.org，下载 macOS LTS 安装包后双击安装。

Linux

Ubuntu / Debian

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS / RHEL

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

验证安装

安装完成后，运行以下命令确认 Node.js 和 npm 均可正常使用：

node --version
npm --version

两个命令均应输出版本号。推荐使用 Node.js 20 或更高版本（Node.js 20 为当前 LTS 版本）。

npm 镜像加速（国内用户）

切换命令：

npm config set registry https://registry.npmmirror.com

验证是否已切换：

npm config get registry

如需恢复官方源：

npm config set registry https://registry.npmjs.org

常见问题：Windows PowerShell 执行策略报错

这是一个在 Windows PowerShell 中非常常见的报错。出现这个问题的原因是 Windows 系统默认的安全策略（执行策略）禁止运行脚本，导致无法执行 npm.ps1 这个脚本文件。

以下是彻底解决此问题的方法：

解决步骤：修改 PowerShell 执行策略

你可以通过修改当前用户的执行策略来允许运行本地脚本。这非常安全，且能一劳永逸地解决 npm 及其他 Node.js 全局模块的运行问题。

1. 以管理员身份运行 PowerShell

虽然修改当前用户权限有时不需要管理员权限，但为了确保操作成功，建议你：

• 右键点击"开始"菜单（或按 Win + X）。
• 选择 Windows PowerShell (管理员) 或 终端 (管理员)。

2. 输入并执行以下命令

将下面的代码复制并粘贴到 PowerShell 中，然后按回车键：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 确认修改

系统会弹出一长串关于执行策略更改的提示，并询问你是否要更改。

• 输入 Y 或 A，然后按回车键确认。

4. 验证是否成功

重新输入你之前的命令来测试：

npm --version

如果成功输出了 npm 的版本号（例如 10.x.x），说明报错已经解决！

下一步

Node.js 安装完成后，即可配置以下 AI 编程工具：

• Claude Code — 基于终端的 AI 编程助手
• Codex CLI — OpenAI 的终端编程智能体
• OpenCode — 开源终端 AI 编程助手
• Cursor — 基于 VS Code 的 AI 代码编辑器，含面向 OpenAI 兼容客户端的 Chat Completions API 参考要点