Node.js

Какую задачу решает

Среда, в которой программы на JavaScript работают вне браузера. Вместе с Node.js ставятся npm и npx: через них агент ставит пакеты, запускает MCP-серверы (Playwright MCP, Chrome DevTools MCP и многие другие подключаются командой npx) и собирает сайты на Next.js и Astro. Ошибка npx: command not found значит, что Node.js нет или терминал его не видит.

• Запускает MCP-серверы, которые подключаются командой npx. Без Node.js такой сервер не стартует.
• Ставит пакеты проекта из реестра npm (npm install) и запускает команды из package.json, например npm run dev.
• Собирает и запускает сайты: Next.js 16 нужен Node.js 20.9 или новее, Astro 7 - 22.12 или новее.
• Разово запускает консольную программу из реестра npm без установки: npx -y пакет@версия.

Пример результата

Установить агентом

Установи программу «Node.js». Работай по шагам и после каждого коротко говори, что сделал.

Что это за программа (каталог smyslokod.ru, официальные источники сверены 28.09.2026):
- официальный сайт: https://nodejs.org/
- исходный код: https://github.com/nodejs/node
- инструкция по установке: https://nodejs.org/en/download
- актуальная версия на 28.09.2026: 24.21.0 LTS
- лицензия: MIT
- для работы нужно (в отдельных случаях): Python, make и компилятор C/C++ - нужны, только если пакет npm собирается из исходного кода при установке (это делает node-gyp): на Mac это Xcode Command Line Tools, на Windows - Visual Studio с набором для C++

Правила:
1. Ничего не устанавливай и не меняй, пока я не скажу «да» на твой план.
2. Ставь только способами из этого промпта. Сторонние сборки, скрипты с форумов и из чужих репозиториев не бери.
3. Мои проекты не трогай: не меняй их файлы, виртуальные окружения и списки зависимостей (package.json, requirements.txt, pyproject.toml).
4. Команды с sudo, правку профиля оболочки (~/.zshrc, ~/.bashrc) и переменной PATH делай только после моего отдельного «да» на каждую.
5. Не проси у меня пароли и ключи и не выводи их. Если нужен пароль администратора, дай команду, я выполню её сам.
6. Если Node.js уже стоит, покажи все копии и их версии (which -a node, на Windows where node). Не ставь второй способ поверх первого и не меняй глобальную версию Node.js (nvm alias default, fnm default, brew link) без моего «да».
7. Если стоит nvm или fnm, ставь через него: nvm install 24 или fnm install 24.
8. Ставь ветку LTS 24, если я не попросил другую.
9. Не запускай sudo npm install -g. Если npm пишет EACCES при глобальной установке, остановись и спроси: для разового запуска хватит npx.
10. Не обновляй npm отдельно (npm install -g npm), даже если npm это предлагает: только после моего «да».
11. Если Node.js уже стоит, но версии ниже 22.12, скажи мне: Astro 7 и часть MCP-серверов на нём не запустятся, Next.js 16 не запускается ниже 20.9. Предложи поставить LTS 24 тем же способом, которым стоит старая версия.

Шаги:
0. Определи, где ты работаешь: мой компьютер, сервер или контейнер. Какая система и процессор, какие менеджеры пакетов есть (Homebrew, apt, winget, uv, pipx). Ставить нужно туда, где ты сам запускаешь команды.
   - на компьютере: установщик с сайта, Homebrew или менеджер версий nvm. Через nvm Node.js лежит в папке пользователя, и глобальные пакеты npm ставятся без sudo.
   - на сервере: менеджер версий nvm или официальный архив для Linux. Ставится на тот сервер, где агент запускает команды.
   - в контейнере: официальный Docker-образ node, например node:24-slim (так на странице загрузки), или архив с nodejs.org в образе на Ubuntu. В официальном образе Hermes Agent node, npm и npx уже есть по его Dockerfile: сначала проверь командой node -v.
1. Проверь, не стоит ли программа уже: node -v ; npx -v ; which -a node. Если стоит и запускается, ничего не ставь и переходи к шагу 5.
2. Обязательных зависимостей у программы нет, то, что нужно в отдельных случаях, перечислено выше. Проверь свободное место на диске: нужно около 215 МБ (архив для Linux весит 31-32 МБ, распакованный Node.js для arm64 занял 214 МБ); после установщика для macOS - около 320 МБ (сам .pkg весит около 94 МБ), в нём node сразу для Apple Silicon и Intel; через nvm - около 245 МБ вместе с кэшем; плюс место под пакеты npm.
3. Составь план: каким одним способом из списка ниже будешь ставить, что появится на диске и сколько места займёт, что поменяется в системе и как потом удалить. Покажи план и жди моего «да».
   Способы из официальных источников:
   - macOS и Linux, nvm: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash && \. "$HOME/.nvm/nvm.sh" && nvm install 24 (команды со страницы загрузки nodejs.org; установщик nvm дописывает три строки в профиль оболочки, Node.js ложится в ~/.nvm без sudo)
   - macOS и Linux, fnm: fnm install 24 (если fnm уже стоит; сам fnm ставится командой curl -o- https://fnm.vercel.app/install | bash, она дописывает строки в профиль оболочки, а на macOS ставит fnm через Homebrew)
   - macOS, Homebrew: brew install node@24 (формула node@24 - это LTS 24.21.0, формула node без номера ставит ветку Current 26.10.0; node@24 сама в PATH не попадает, команда brew info node@24 покажет, как её добавить)
   - macOS, установщик .pkg: open node-v24.21.0.pkg (файл со страницы загрузки, один на Apple Silicon и Intel; откроется обычный установщик macOS, пароль администратора вводишь ты; ставит node, npm и npx в /usr/local/bin)
   - Windows, установщик .msi: msiexec /i node-v24.21.0-x64.msi (файл со страницы загрузки, для ARM - node-v24.21.0-arm64.msi; откроется обычный установщик, он кладёт Node.js, npm и npx в C:\Program Files\nodejs и добавляет их в PATH)
   - Windows, winget: winget install --id OpenJS.NodeJS.LTS -e (пакет каталога winget ставит тот же .msi с nodejs.org, но версия там отстаёт: на 28.09.2026 это 24.19.0; на странице загрузки nodejs.org этого способа нет)
   - Linux, официальный архив: mkdir -p ~/.local/lib/nodejs && tar -xJf node-v24.21.0-linux-x64.tar.xz -C ~/.local/lib/nodejs (архив со страницы загрузки, для arm64 - node-v24.21.0-linux-arm64.tar.xz; сначала сверь SHA256 по SHASUMS256.txt из той же папки, потом добавь в PATH ~/.local/lib/nodejs/node-v24.21.0-linux-x64/bin (для arm64 - node-v24.21.0-linux-arm64/bin): это правка профиля оболочки, на неё нужно отдельное «да»; sudo не нужен)
4. Установи по согласованному плану. Если что-то идёт не так, как в плане, остановись и спроси.
5. Проверь результат:
   - node -v && npm -v && npx -v: программа запускается без ошибки;
   - Переведи маленький Markdown в HTML через npx с точной версией пакета, потом поставь тот же пакет в новый проект и вызови его из Node.js. Делай это во временной папке и не трогай мои файлы.
     printf '# Check\n\n- one\n- two\n' > check.md
     npx -y marked@18.0.14 -i check.md -o check.html
     npm init -y
     npm install --save-exact marked@18.0.14
     node -e "import('marked').then(m => console.log(m.marked.parse('**ok**')))"
   - если ты работаешь в папке моего проекта, покажи git status: от установки в проекте не должно появиться изменений.
6. Итог одним сообщением: что установлено, какой версии и куда, сколько места заняло, что поменялось в системе и как всё удалить (macOS и Linux, nvm: nvm deactivate && nvm uninstall 24; macOS и Linux, fnm: fnm uninstall 24; macOS, Homebrew: brew uninstall node@24; macOS, установщик .pkg: sudo rm -rf /usr/local/bin/node /usr/local/bin/npm /usr/local/bin/npx /usr/local/bin/corepack /usr/local/lib/node_modules/npm /usr/local/lib/node_modules/corepack /usr/local/include/node /usr/local/share/doc/node /usr/local/share/man/man1/node.1 && sudo pkgutil --forget org.nodejs.node.pkg && sudo pkgutil --forget org.nodejs.npm.pkg; Windows, установщик .msi: msiexec /x node-v24.21.0-x64.msi; Windows, установщик .msi: msiexec /x node-v24.21.0-arm64.msi; Windows, winget: winget uninstall --id OpenJS.NodeJS.LTS -e; Linux, официальный архив: rm -rf ~/.local/lib/nodejs/node-v24.21.0-linux-x64; Linux, официальный архив: rm -rf ~/.local/lib/nodejs/node-v24.21.0-linux-arm64).

Если на любом шаге ошибка, не чини наугад: покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/cli/nodejs#problemy

Промпт собран из официальных инструкций, сверенных 28.09.2026. Агент сначала проверит, что уже стоит, покажет план с местом на диске и способом удаления и без твоего «да» ничего не поставит.

Как ставят вручную

Способы из официальных источников, у каждого ссылка на первоисточник.

• macOS и Linux · nvm · источник

  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash && \. "$HOME/.nvm/nvm.sh" && nvm install 24

  команды со страницы загрузки nodejs.org; установщик nvm дописывает три строки в профиль оболочки, Node.js ложится в ~/.nvm без sudo

• macOS и Linux · fnm · источник

  fnm install 24

  если fnm уже стоит; сам fnm ставится командой curl -o- https://fnm.vercel.app/install | bash, она дописывает строки в профиль оболочки, а на macOS ставит fnm через Homebrew

• macOS · Homebrew · источник

  brew install node@24

  формула node@24 - это LTS 24.21.0, формула node без номера ставит ветку Current 26.10.0; node@24 сама в PATH не попадает, команда brew info node@24 покажет, как её добавить

• macOS · установщик .pkg · источник

  open node-v24.21.0.pkg

  файл со страницы загрузки, один на Apple Silicon и Intel; откроется обычный установщик macOS, пароль администратора вводишь ты; ставит node, npm и npx в /usr/local/bin

• Windows · установщик .msi · источник

  msiexec /i node-v24.21.0-x64.msi

  файл со страницы загрузки, для ARM - node-v24.21.0-arm64.msi; откроется обычный установщик, он кладёт Node.js, npm и npx в C:\Program Files\nodejs и добавляет их в PATH

• Windows · winget · источник

  winget install --id OpenJS.NodeJS.LTS -e

  пакет каталога winget ставит тот же .msi с nodejs.org, но версия там отстаёт: на 28.09.2026 это 24.19.0; на странице загрузки nodejs.org этого способа нет

• Linux · официальный архив · источник

  mkdir -p ~/.local/lib/nodejs && tar -xJf node-v24.21.0-linux-x64.tar.xz -C ~/.local/lib/nodejs

  архив со страницы загрузки, для arm64 - node-v24.21.0-linux-arm64.tar.xz; сначала сверь SHA256 по SHASUMS256.txt из той же папки, потом добавь в PATH ~/.local/lib/nodejs/node-v24.21.0-linux-x64/bin (для arm64 - node-v24.21.0-linux-arm64/bin): это правка профиля оболочки, на неё нужно отдельное «да»; sudo не нужен

Как удалить

• macOS и Linux, nvm: nvm deactivate && nvm uninstall 24
• macOS и Linux, fnm: fnm uninstall 24
• macOS, Homebrew: brew uninstall node@24
• macOS, установщик .pkg: sudo rm -rf /usr/local/bin/node /usr/local/bin/npm /usr/local/bin/npx /usr/local/bin/corepack /usr/local/lib/node_modules/npm /usr/local/lib/node_modules/corepack /usr/local/include/node /usr/local/share/doc/node /usr/local/share/man/man1/node.1 && sudo pkgutil --forget org.nodejs.node.pkg && sudo pkgutil --forget org.nodejs.npm.pkg
• Windows, установщик .msi: msiexec /x node-v24.21.0-x64.msi
• Windows, установщик .msi: msiexec /x node-v24.21.0-arm64.msi
• Windows, winget: winget uninstall --id OpenJS.NodeJS.LTS -e
• Linux, официальный архив: rm -rf ~/.local/lib/nodejs/node-v24.21.0-linux-x64
• Linux, официальный архив: rm -rf ~/.local/lib/nodejs/node-v24.21.0-linux-arm64

Что нужно для работы

• Python, make и компилятор C/C++ (в отдельных случаях) - нужны, только если пакет npm собирается из исходного кода при установке (это делает node-gyp): на Mac это Xcode Command Line Tools, на Windows - Visual Studio с набором для C++

Системы

• macOS - macOS 13.5 и новее, Apple Silicon и Intel: установщик .pkg, Homebrew, nvm или fnm.
• Windows - Windows 10 и новее, x64 и ARM64: установщик .msi или winget.
• Linux - официальный архив для x64 и arm64 (нужна glibc 2.28 и новее), nvm или fnm.

Где запускать

Ставить нужно туда, где работает агент: на твой компьютер, сервер или в контейнер.

• На компьютере - установщик с сайта, Homebrew или менеджер версий nvm. Через nvm Node.js лежит в папке пользователя, и глобальные пакеты npm ставятся без sudo.
• На сервере - менеджер версий nvm или официальный архив для Linux. Ставится на тот сервер, где агент запускает команды.
• В контейнере - официальный Docker-образ node, например node:24-slim (так на странице загрузки), или архив с nodejs.org в образе на Ubuntu. В официальном образе Hermes Agent node, npm и npx уже есть по его Dockerfile: сначала проверь командой node -v.

Сколько ресурсов нужно

Место на диске

Около 215 МБ (архив для Linux весит 31-32 МБ, распакованный Node.js для arm64 занял 214 МБ); после установщика для macOS - около 320 МБ (сам .pkg весит около 94 МБ), в нём node сразу для Apple Silicon и Intel; через nvm - около 245 МБ вместе с кэшем; плюс место под пакеты npm

Память

Сам Node.js на простой задаче занимает около 45 МБ памяти (замер в контейнере), дальше всё зависит от программы, которую он запускает.

Сеть

Нужна, чтобы скачать Node.js и пакеты из реестра npm. 28.09.2026 с сервера в России отвечали nodejs.org, registry.npmjs.org, github.com и raw.githubusercontent.com (оттуда ставится nvm); смотрели только заголовки ответов.

Кэш npm растёт с каждым новым пакетом через npx, место освобождает npm cache clean --force. У nvm свой кэш скачанных архивов (около 31 МБ на версию), его чистит nvm cache clear.

Лицензия и платные замены

Лицензия MIT. Сам Node.js идёт под MIT. В том же файле LICENSE перечислены встроенные части со своими лицензиями, например npm (Artistic License 2.0), OpenSSL (Apache 2.0) и V8. Условия важны тем, кто распространяет Node.js вместе со своим продуктом; чтобы запускать программы у себя, делать ничего не нужно. Название и логотип Node.js - товарные знаки OpenJS Foundation. Текст лицензии

Цена: Бесплатно

Платные замены

Платной замены нет: Node.js, Bun и Deno бесплатные и с открытым кодом.

Бесплатные замены

• Bun - Среда запуска JavaScript и TypeScript, её разработчики задумали как замену Node.js. Свой менеджер пакетов и команда bunx вместо npx. Лицензия MIT.
• Deno - Среда запуска JavaScript и TypeScript. По документации Deno большая часть кода для Node.js работает в ней без изменений, пакеты npm подключаются через npm: или package.json. Лицензия MIT.

О чём помнить

• Ставь Node.js одним способом. Две установки рядом (например, .pkg и nvm или Homebrew и nvm) спорят за команду node: which -a node покажет все копии, работает та, что первая в PATH.
• Для работы бери LTS, это ветка с долгой поддержкой. 28.10.2026 LTS станет ветка 26, ветка 24 получает исправления до 30.04.2028.
• npx скачивает пакет из реестра npm и сразу запускает его код. Флаг -y убирает вопрос перед скачиванием (так в документации npm), поэтому запускай пакеты, которым доверяешь, и с точной версией: npx -y пакет@1.2.3.
• В установщике .msi для Windows галочка Tools for Native Modules ставит ещё Chocolatey, Python и Visual Studio Build Tools, около 7 ГБ. Она нужна, только если пакеты npm собираются из исходного кода.
• Архив для Linux распаковывай без sudo, в свою папку: так файлы принадлежат тебе и глобальные пакеты npm ставятся без sudo. Если распаковать через sudo, файлы достанутся пользователю с номером 1001, как записано в архиве.
• Сам nvm удаляется отдельно: nvm unload, потом rm -rf ~/.nvm и строки nvm в профиле оболочки (так в README nvm).
• У установщика .pkg нет своей команды удаления: строка удаления стирает через sudo ровно те файлы, что он положил в /usr/local. Перед ней агент проверяет командой ls -l /usr/local/bin/node, что это файл от .pkg и там нет ссылки Homebrew.

Частые проблемы

Проверка

✓ Проверено 28.09.2026: Одноразовый контейнер Docker: Ubuntu 24.04.5 на arm64, официальный архив с nodejs.org.

«Проверено» ставим, только когда сами поставили программу и прогнали её на задаче. Сверка ссылок и вывод версии так не называются.

Похожие программы

• uvСтавит программы на Python в отдельные окружения, чтобы они не ломали твои проекты. Агенту нужен, чтобы поставить Whisper или yt-dlp и ничего не задеть.