环境检查

装客户端之前先花一分钟确认：这台机器能不能跑 Node.js 工具链。三条命令足够了。

为什么要做这一步

Claude Code、Codex CLI 这类命令行客户端都是 Node.js 程序，通过 npm 安装。 机器上没有 Node.js，或者 Node.js 装了但命令行找不到它，后面所有安装命令都会失败， 报出来的错还五花八门。先在这里验一遍，比事后排查省事得多。

三条命令

打开终端，逐条执行：

1. 检查 Node.js

node -v

2. 检查 npm

npm -v

3. 看全局装了哪些包

npm list -g --depth-0

正常的话：

• 第 1 条输出形如 v22.x.x 这样的版本号
• 第 2 条输出形如 10.x.x 这样的版本号
• 第 3 条列出全局包清单。刚装好的机器这里可能是空的或只有 npm/corepack，属于正常， 不是错误

也可以用一条命令一次跑完：

一次跑完三条

node -v && npm -v && npm list -g --depth-0

怎么打开终端

系统	打开方式
Windows	开始菜单搜索「PowerShell」或「Windows Terminal」。装了 WSL 也可以在 WSL 里跑
macOS	Command + 空格 搜「终端」/ Terminal，或从「应用程序 → 实用工具」打开
Linux	Ctrl + Alt + T，或在应用列表里找「终端」

command not found 是什么意思

看到下面这类输出，说明系统不认识这条命令：

bash: node: command not found
zsh: command not found: node
'node' 不是内部或外部命令，也不是可运行的程序或批处理文件。

这不是 Node 坏了，而是三种情况之一：

1. 根本没装 Node.js —— 最常见
2. 装了，但不在 PATH 里 —— 系统不知道去哪儿找这个可执行文件。 macOS / Linux 上手动解压安装包（而不是用 nvm 或包管理器装）很容易出现这种情况
3. 装了但当前终端窗口没刷新 —— 装完新软件后，已经开着的终端不会自动更新 PATH

修复顺序：

1. 先关掉终端重新开一个，再跑一次 node -v
2. 还是不行，就按下一节重新装一遍 Node.js
3. 如果确定装过（比如文件确实在磁盘上），那就是 PATH 问题。 最省事的做法是卸载后改用 nvm（版本管理器）重装，它会自动把 PATH 配好

区分「全局命令找不到」和「安装报权限错」

两个错误经常一起出现但原因完全不同：

• command not found —— PATH 问题，或没装
• EACCES permission denied / permission denied —— 权限问题， 不要用 sudo npm install -g 硬装，那是把坑挖深

正确做法见本节末尾。

装 Node.js

推荐：用版本管理器

版本管理器负责装 Node、切版本、并自动写好 PATH，比手动装省心， 也是排查上面第 2、3 类问题的根治办法。

系统	工具
macOS / Linux	nvm（Node Version Manager）或 fnm
Windows	nvm-windows 或 fnm
macOS 用 Homebrew 的用户	brew install node 也可以

Windows 上不要混用

Windows 的 nvm-windows 和 macOS/Linux 的 nvm 是两个不同的项目，命令不通用， 装的时候看清自己下的是哪个。另外，如果机器上已经有官方安装包装的 Node， 先卸载再装 nvm，否则两者会抢 PATH。

备选：官方安装包

到 Node.js 官网下载 LTS（长期支持）版本的安装包，一路下一步即可：

Node.js 官网

https://nodejs.org/

• 优先选 LTS 而不是 Current。LTS 更稳，兼容性更好
• 不要装太老的版本。装完用 node -v 确认一下
• 安装过程不要勾选自动编译原生模块之类的旧选项（新版本安装包一般也没有）

Linux 用户注意

发行版自带的 apt install nodejs 往往版本很旧，也不一定带 npm。 建议用 nvm，或按 Node.js 官网提供的官方源方式安装。

装完必须做的两件事

1. 关掉所有已打开的终端窗口，重新开一个（PATH 才会生效）
2. 重跑一次三条检查命令，确认都有输出

重新验证环境

node -v && npm -v

全局安装报权限错误怎么办

npm install -g 报 EACCES 或 permission denied，说明 npm 想往系统目录写但没有权限。

不要用 sudo 压过去，那会让后续所有全局包都归 root 所有，之后不用 sudo 就装不了。

正确做法二选一：

1. 改用 nvm 装 Node —— 全局包会装在你的用户目录下，根本不会碰到权限问题（推荐）
2. 配置 npm 的用户级全局目录：

改 npm 全局目录（macOS / Linux）

mkdir -p ~/.npm-globalnpm config set prefix ~/.npm-globalexport PATH=~/.npm-global/bin:$PATH

最后那行 export 要写进 ~/.bashrc 或 ~/.zshrc 才会永久生效。 改完重开终端，再跑一次 npm list -g --depth-0 确认能正常输出。

网络慢 / 安装卡住

如果 npm install -g 长时间没反应或超时，是访问 npm 官方源慢的问题， 可以先确认网络能通，再考虑换源。

换源只影响下载 npm 包

换 npm 源解决的是「装客户端工具慢」。 它和 FluxToken 的接口端点是两回事——端点用哪个是另一码事，见端点与域名。

环境没问题了，下一步

• 接入客户端 —— 一键导入或手动配置
• 创建 API 令牌 —— 还没建令牌的话先建

环境检查只涉及本机工具链，不涉及计费和分组，所以这页没有价格信息。