玄枢API玄枢API

玄枢API

Node.js 环境安装

在 Windows、macOS、Linux 安装 Node.js 22 或更高版本，并验证 node 与 npm 命令可用。Claude Code、Codex、Gemini CLI 都依赖这个环境。

1. 按系统安装 Node.js（22 或更高）

选择你的系统，复制命令执行。三种 Windows 方式任选一种即可。

# 官网安装包（推荐）
# 打开 https://nodejs.org 下载 LTS 安装包，双击按提示安装
node --version
npm --version

2. 验证安装

node --version 与 npm --version 都能输出版本号，说明环境就绪。Node.js 需要 22 或更高版本；如果命令提示找不到，关闭并重新打开终端再试一次，因为 PATH 变更只对新开的终端生效。

4. 常见问题排查

现象原因处理
命令未找到安装后 PATH 未刷新，或安装器未写入 PATH。关闭所有终端后重新打开；Windows 可注销一次再登录。
npm 权限错误Linux 下用 sudo 装的全局包属于 root。优先用 nvm 管理 Node.js，避免全局安装需要 sudo。
版本过低系统仓库自带的 Node.js 通常滞后。用上面的 NodeSource 或 Homebrew 方式重装，确认版本不低于 22。