문서의 모든 페이지를 검색하려면 두 글자 이상 입력하세요.

↑ ↓ 이동 ↵ 열기 esc 닫기

rdev 사용하기

Node.js 버전

Node.js는 모든 환경에 준비되어 있습니다. node, npm, npx, corepack은 터미널, 에이전트의 명령어, npm 스크립트에서 동작합니다. 여러 Node.js 버전을 나란히 설치할 수 있으며, 각 프로젝트는 요청한 버전을 사용합니다.

프로젝트가 사용하는 버전

node, npm, npx, corepack은 다음 순서로 버전을 선택합니다.

  1. 프로젝트의 .nvmrc 또는 .node-version 파일(현재 폴더에서 ~/Code의 프로젝트 루트까지 찾습니다). 예: 22, v22.11.0, lts/*, node
  2. 패널이나 rdev node use로 프로젝트에 지정한 버전
  3. 기본 버전

설치되지 않은 버전을 요청하는 파일이 있으면 설치하라는 메시지와 함께 중단되며, rdev가 직접 설치하지 않습니다. ^20 같은 버전 범위는 인식하지 못하므로 메이저 버전을 대신 입력하세요.

패널에서

사이드바의 서버에서 서버를 열고 런타임을 선택하세요. Node.js 카드에는 설치된 버전이 정확한 릴리스와 각 버전에 고정된 프로젝트와 함께 표시됩니다. Node.js 버전 추가는 다른 버전을 설치합니다(현재 릴리스와 유지 관리되는 LTS 라인: 현재 26, 24, 22). 해당 버전의 최신 릴리스를 nodejs.org에서 다운로드하고 공개된 체크섬으로 검증합니다. 버전의 ⋯ 메뉴는 해당 버전을 기본으로 지정하거나 제거합니다. 기본 버전과 프로젝트가 고정된 버전은 제거할 수 없습니다. 프로젝트에서 프로젝트 옆의 연필 아이콘은 프로젝트를 특정 버전에 고정하거나 기본값으로 되돌립니다. 이 기능에는 rdev 0.2.0-beta.35 이상이 필요합니다.

서버에서

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

에이전트도 같은 명령어를 사용하며, MCP로는 rdev_node_list, rdev_node_install, rdev_node_project를 사용합니다. 구독에 조치가 필요한 동안에는 PHP와 마찬가지로 버전 설치, 제거, 전환이 일시 중지됩니다.

전역 패키지

npm install -g는 sudo 없이 동작하며, 전역 패키지는 모든 Node.js 버전이 공유하므로 한 번 설치한 CLI는 프로젝트가 어떤 버전을 사용하든 PATH에 남아 있습니다. 네이티브 애드온이 있는 패키지는 설치한 버전용으로 빌드되므로, 전환한 후 문제가 생기면 다시 설치하세요. rdev 0.2.0-beta.35 이전에 전역으로 설치한 패키지는 당시의 버전에 남아 있으므로 한 번 다시 설치하세요.