NEXUS 使用文档

macOS 平台安装 Node.js ​

推荐安装 Node.js LTS。常见做法是 Homebrew 或官方安装包。

完整 CLI 接入流程见 macOS 快速接入。

安装 Node.js 的目标是让系统拥有 node 和 npm 两个命令。node 用来运行 JavaScript CLI，npm 用来下载和更新 Claude Code、Codex、Gemini CLI 等工具。

后面准备装的是 Codex、Gemini CLI、OpenCode 或其他 npm CLI 时，这一层基本迟早都要准备。
先把 Node.js 装稳，后面很多“装包失败”“版本太旧”“命令找不到”的问题都会少很多。

方法一：Homebrew（推荐） ​

Homebrew 会把 Node.js 安装到用户常用的命令路径里，后续升级和卸载都比较清楚。已经安装 Homebrew 的用户，优先使用这种方式。

第一次常见的犹豫是：“Homebrew 和 .pkg 到底选哪个？”
已经在用 Homebrew 管理命令行工具时，优先继续用 Homebrew；只是想先快速装上 node 和 npm 时，图形安装包也完全可以。

更重要的一点不是“哪种方式更高级”，而是先固定一种方式装好，不要同一台机器上来回混装太多套 Node.js。
混装本身不会立刻报错，但后面 which node 指到哪个路径、升级时改了哪一个版本，就会越来越难判断。

已经装了 Homebrew，直接执行：

bash
brew install node

验证：

bash
node -v
npm -v

Homebrew 首次安装或更新很慢时，先换国内镜像源，再回来安装 Node.js。常用镜像帮助页：

方法二：浏览器下载安装包 ​

不使用 Homebrew 时，可以直接安装 .pkg。这种方式更接近普通软件安装流程，适合只想先把 node 和 npm 跑起来的用户。

浏览器下载安装时，国内用户可以按这个顺序选：

  1. Node.js 中文站：https://nodejs.cn/download
  2. Node.js 镜像归档：https://npmmirror.com/mirrors/node/
  3. Node.js 英文官网：https://nodejs.org/en/download

第一次安装优先打开 Node.js 中文站。页面是中文，能直接看到 macOS 安装包和架构选项。

第一次如果看到 Current、LTS 两种版本，优先选 LTS。
LTS 更适合日常 CLI 使用，后面安装各种工具时兼容性通常更稳。

常用选择：

txt
macOS 安装包 (.pkg) -> Apple Silicon 选 ARM64，Intel 选 x64

下载后按提示完成安装，重新打开终端验证版本。

使用镜像归档时：

选择最新 LTS 版本目录：

  • Apple 芯片：优先选择 darwin-arm64
  • Intel 芯片：选择 darwin-x64
  • 不确定芯片：点左上角苹果图标，查看“关于本机”

图形安装优先选择 .pkg 安装包；压缩包适合熟悉 PATH 配置的用户。

只是想先把环境跑通时，不建议第一次就选纯压缩包手动配 PATH。
.pkg 更接近普通软件安装流程，变量和命令路径通常也更省心。

安装 Git ​

Claude Code、Codex 处理项目时会读取 Git 仓库状态、查看差异和识别当前工作目录。macOS 可以通过 Apple 命令行工具安装 Git。

安装方式建议按这个顺序选：

  1. Apple 命令行工具
  2. Homebrew
  3. Git 官网下载页

只是想先把 git 命令装上时，优先直接安装 Apple 命令行工具：

bash
xcode-select --install

安装后验证：

bash
git --version

已经在用 Homebrew，也可以：

bash
brew install git

浏览器下载入口：

想用图形安装包时，再走官网页面。

Git 装好后，Claude Code、Codex 读取项目仓库会更稳定。

只看“能不能发一条模型请求”时，Git 似乎不像 Node.js 那么显眼。
但只要后面要让 Claude Code、Codex 真正进入项目目录读代码、看差异、处理提交，Git 基本就是这类工具理解仓库状态的基础。

配置 npm 镜像 ​

npm 默认从官方 registry 下载依赖，国内网络下可能很慢。切到 npmmirror 后，安装 CLI 工具通常更快、更稳定。

这个设置只影响 npm 下载依赖，不会改变 NEXUS 的接口地址，也不会影响模型请求。

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

输出 https://registry.npmmirror.com/ 即可。

这个设置只影响 npm 下载依赖，不会改变 NEXUS 的 Base URL，也不会影响你后面配置的 Key 和模型。
很多新手第一次改镜像时会担心“是不是把模型请求也改走镜像了”，这里可以放心分开看：npm 镜像只影响安装层。

常见问题 ​

Homebrew 很慢 ​

先确认 Homebrew 本身能正常更新；必要时换镜像源后再安装。

权限问题 ​

不要把 npm 全局目录改到系统目录。优先使用 Homebrew，或使用 nvm 管理 Node.js 版本。

如果全局安装 CLI 时出现 EACCES，不要直接加 sudo。先看 npm 全局目录：

bash
npm config get prefix

通过 Homebrew 安装的 Node.js 通常不会遇到这个问题。

浏览器安装 Node.js 的机器，安装全局 CLI 时更常见的处理方式是：

bash
sudo npm install -g 包名

终端出现钥匙图标或 Password: 提示后，密码不会显示任何字符，也不会出现 *，直接输入完成后按回车即可。

明明装过了，终端里还是旧版本 ​

这通常说明你机器里可能已经存在另一套 Node.js。

先看：

bash
which node
node -v

如果 which node 指向的不是你刚安装的那一套路径，后面装 CLI 时就可能继续沿用旧版本。
这种时候先把“当前到底在用哪一套 Node.js”弄清楚，会比急着重装更有效。

命令找不到 ​

先开一个新的终端窗口，再执行：

bash
which node
which npm
which git

如果 node 查不到，重新安装 Node.js。 如果 git 查不到，先执行 xcode-select --install。

Homebrew 装了，浏览器安装包也装了，会不会冲突 ​

不一定立刻冲突，但长期来看更容易把版本和路径搞乱。
已经决定长期用 Homebrew 管命令行工具时，后面尽量继续用 Homebrew；已经用 .pkg 装稳时，也可以先保持这一套不动。

zsh 和 bash 怎么选 ​

新版本 macOS 默认是 zsh。本文里的持久化配置优先写入 ~/.zshrc。使用 bash 时，再写入 ~/.bashrc 或 ~/.bash_profile。

下一步 ​

NEXUS 使用文档

© 2026 NEXUS AI