XuanShu API

Установка Node.js

Установите Node.js 22 или новее в Windows, macOS и Linux и проверьте команды node и npm. Claude Code, Codex и Gemini CLI зависят от этой среды.

1. Установите Node.js (22 или новее) для своей системы

Выберите систему и выполните команды. Для Windows достаточно любого одного способа из трёх.

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

choco install nodejs-lts
node --version
npm --version

scoop install nodejs-lts
node --version
npm --version

brew install node
node --version
npm --version

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

2. Проверьте установку

Среда готова, когда node --version и npm --version выводят версию. Требуется Node.js 22 или новее. Если команда не найдена, закройте и снова откройте терминал: изменения PATH применяются только к новым терминалам.

4. Устранение неполадок

Симптом	Причина	Решение
Команда не найдена	PATH не обновился после установки или установщик его не изменил.	Закройте все терминалы и откройте новый; в Windows выйдите из системы и войдите снова.
Ошибка прав npm	Глобальные пакеты, установленные через sudo в Linux, принадлежат root.	Используйте nvm для управления Node.js, чтобы глобальная установка не требовала sudo.
Слишком старая версия	В репозиториях дистрибутивов обычно устаревший Node.js.	Переустановите через NodeSource или Homebrew, как показано выше, и убедитесь, что версия не ниже 22.