Node.js viene listo en cada entorno: node, npm, npx y corepack funcionan en la terminal, en los comandos de tus agentes y en los scripts de npm. Se pueden instalar varias versiones de Node.js en paralelo, y cada proyecto usa la que pide.
Qué versión recibe un proyecto
node, npm, npx y corepack eligen la versión en este orden:
- el archivo
.nvmrco.node-versiondel proyecto (se busca desde la carpeta en la que estás hasta la raíz del proyecto en~/Code), como22,v22.11.0,lts/*onode; - la versión elegida para el proyecto en el panel o con
rdev node use; - la versión predeterminada.
Un archivo que pide una versión que no está instalada se detiene con un mensaje que te indica que la instales; rdev no la instala por sí solo. Los rangos de versiones como ^20 no se entienden; escribe la versión mayor en su lugar.
En el panel
Abre el servidor desde Servidores en la barra lateral y luego Entorno de ejecución. La tarjeta Node.js lista las versiones instaladas con su versión exacta y qué proyectos están fijados a cada una. Añadir versión de Node.js instala otra (la versión actual y las líneas LTS mantenidas: hoy la 26, la 24 y la 22); la última versión publicada de esa versión se descarga de nodejs.org y se comprueba con sus sumas de verificación publicadas. El menú ⋯ de una versión la hace predeterminada o la quita; no se pueden quitar la versión predeterminada ni una versión a la que está fijado un proyecto. En Proyectos, el lápiz junto a un proyecto lo fija a una versión o lo devuelve a la predeterminada. Esto requiere rdev 0.2.0-beta.35 o posterior.
En el servidor
rdev node list # installed and available versions, the default and the pinned projects
rdev node install 22 # the newest Node 22
rdev node default 22
rdev node use shop 22 # pin a project; rdev node use shop default undoes it
rdev node remove 24
rdev node update # the newest release of every installed version
Los agentes usan los mismos comandos, y mediante MCP rdev_node_list, rdev_node_install y rdev_node_project. Mientras una suscripción requiere atención, instalar, quitar y cambiar versiones se pausan igual que con PHP.
Paquetes globales
npm install -g funciona sin sudo, y los paquetes globales se comparten entre todas las versiones de Node.js, de modo que una CLI que instalas una vez se queda en el PATH sea cual sea la versión que use un proyecto. Un paquete con un complemento nativo se compila para la versión que lo instaló; reinstálalo después de cambiar si da problemas. Los paquetes instalados globalmente antes de rdev 0.2.0-beta.35 se quedan con la versión que había entonces; instálalos de nuevo una vez.