언제 필요한가요?
이 가이드는 OpenCode를 터미널(TUI) 방식으로 설치할 때 필요한 Node.js 설치 방법을 설명합니다. OpenCode Desktop 앱만 사용할 예정이라면 이 과정을 건너뛰어도 됩니다.
1. 다운로드 및 설치
-
사이트 접속
- Node.js 공식 웹사이트에 접속합니다.
- 링크: https://nodejs.org/ko
-
다운로드 페이지 이동
- 메인 화면이나 메뉴에서 ‘다운로드’ 또는 ‘Get Node.js’ 버튼을 클릭합니다.

- 메인 화면이나 메뉴에서 ‘다운로드’ 또는 ‘Get Node.js’ 버튼을 클릭합니다.
-
설치 파일 다운로드
- 운영체제(Windows 등)에 맞는 설치 프로그램을 선택합니다.
- **‘Windows Installer (.msi)‘**를 선택하여 다운로드합니다.
- 팁: 안정적인 사용을 원하시면 ‘LTS’ 버전을, 최신 기능을 원하시면 ‘Current’ 버전을 선택하세요. (OpenCode TUI 사용 시 최신 버전 권장)
-
설치 진행
- 다운로드 폴더에서 받은
.msi파일을 실행합니다. - 설치 마법사의 안내에 따라
Next를 눌러 설치를 완료합니다. (기본 설정대로 진행하셔도 무방합니다.)
- 다운로드 폴더에서 받은
2. 설치 확인
Node.js가 정상적으로 설치되었는지 명령 프롬프트(CMD)에서 확인합니다.
-
CMD 실행
Windows키 +R을 누르고cmd를 입력하거나, 시작 메뉴에서 명령 프롬프트를 실행합니다.
-
버전 확인 명령어 입력
- 아래 두 명령어를 각각 입력하여 버전 숫자가 나오는지 확인합니다.
node -v npm -v
- 아래 두 명령어를 각각 입력하여 버전 숫자가 나오는지 확인합니다.
-
결과 확인
- 아래 사진처럼
v20.x.x와 같은 버전 번호가 출력되면 성공적으로 설치된 것입니다.
- 아래 사진처럼