코딩을 처음 접하시는 분도 괜찮습니다. 이 글은 Windows PC에서 바이브코딩·Cursor 실습을 시작하기 전에 꼭 설치해야 하는 프로그램 3가지—Node.js, Git, Cursor를 처음부터 끝까지 따라 할 수 있도록 정리했습니다.

스크린샷과 영상을 보면서, 한 단계씩 그대로 진행해 주세요. Node.js, Git, Cursor 설치를 모두 마친 뒤, 마지막 설치 확인까지 반드시 완료해 주세요.

• 대상: 비개발자 / Windows 사용자
• 예상 소요 시간: 20-40분
• 준비물: PC 관리자 권한, 인터넷 연결, Google 계정

Mac 사용자는 Mac 설치 가이드를 참고해 주세요.

---

먼저 알아두면 좋은 것

바이브코딩으로 앱이나 웹 페이지를 만들려면, PC 안에 “만들고 실행할 수 있는 환경”이 갖춰져 있어야 합니다. 마치 요리를 하려면 배관 공사와 가스 공사가 있어야 하는 것과 같습니다.

이번에 설치하는 도구는 Node.js, Git, Cursor 세 가지입니다. 이름만 들어보면 낯설 수 있는데, 각각 어떤 프로그램인지, 바이브코딩에서 왜 필요한지만 먼저 짚고 넘어가겠습니다.

Node.js — 만든 앱을 PC에서 돌려 주는 엔진

Node.js는 웹·앱 개발에서 쓰는 실행 엔진입니다. 바이브코딩으로 AI가 만들어 준 코드를 “실제로 내 컴퓨터에서 실행”하려면 이 엔진이 있어야 합니다. 자동차에 엔진이 없으면 출발할 수 없듯, Node.js 없이는 npm run dev 같은 명령으로 만든 결과물을 미리보기할 수 없습니다.

바이브코딩 실습에서는 프로젝트를 시작할 때, 개발 서버를 띄울 때, 필요한 라이브러리를 받아올 때 거의 항상 Node.js가 뒤에서 동작합니다. 직접 코드를 많이 작성하지 않아도, Cursor 터미널에 입력하는 명령어 대부분이 Node.js 환경을 전제로 합니다.

Node.js를 설치하면 npm(노드 패키지 매니저)도 함께 설치됩니다. npm은 “이 프로젝트에 필요한 부품을 인터넷에서 받아와라”고 PC에 지시하는 도구입니다. 실습 중 npm install처럼 한 줄로 추가 도구를 설치할 때 씁니다. 처음에는 Node.js와 npm이 한 세트라고만 기억하셔도 충분합니다.

설치가 끝나면 Cursor 터미널에서 아래 같은 명령어를 쓰게 됩니다. 지금은 외울 필요 없고, “Node.js가 있어야 이런 명령이 된다” 정도만 알아두세요.

• npm install — 프로젝트에 필요한 패키지(부품)를 한꺼번에 받아옴
• npm run dev — 만든 웹·앱을 내 PC에서 미리보기 (주소는 보통 localhost:3000)
• npx — 별도 설치 없이 도구를 한 번 실행 (프로젝트 생성 등)

터미널은 이런 명령어를 입력하는 창입니다. Cursor 하단 Terminal 탭이 바로 그 역할을 합니다.

Git — 파일 변경 기록을 남기고, 되돌리고, 공유하는 도구

Git은 파일의 변경 이력을 저장·관리하는 프로그램입니다. 워드에서 “버전 기록”으로 예전 문서를 되돌리듯, 코드 파일도 “어제 상태”, “일주일 전 상태”로 되돌릴 수 있게 해 줍니다. 실습 중 AI가 코드를 수정하다가 뭔가 꼬였을 때, Git이 있으면 이전 버전으로 안전하게 돌아갈 수 있습니다.

바이브코딩 환경에서 Git은 두 가지 역할을 합니다. 첫째, 내 PC에서 프로젝트 폴더의 변경 사항을 기록합니다. 둘째, 나중에 GitHub 같은 서비스와 연결하면 만든 결과물을 온라인에 올리거나, 다른 사람과 공유할 수 있습니다. 포트폴리오를 웹에 배포하는 실습에서도 Git이 빠지지 않습니다.

코딩을 처음 시작하는 분에게 Git은 “왜 필요하지?” 싶을 수 있습니다. 하지만 바이브코딩은 AI가 코드를 빠르게 바꾸기 때문에, 기록 없이 작업하면 “언제부터 잘못됐는지” 찾기가 어렵습니다. Git은 그런 상황을 막아 주는 안전벨트 같은 존재입니다.

Cursor — AI와 함께 코드를 작성하는 실습용 편집기

Cursor는 코드를 작성·수정하는 프로그램(코드 편집기)입니다. 겉모습은 VS Code와 비슷하지만, 옆에 AI 채팅이 붙어 있어서 “로그인 페이지 만들어줘”, “버튼 색을 파란색으로 바꿔줘”처럼 말로 요청하면서 작업할 수 있습니다. 바이브코딩의 핵심 도구가 바로 이 Cursor입니다.

실습에서는 Cursor 한곳에서 거의 모든 일이 일어납니다. AI에게 지시하고, 생성된 코드를 확인하고, 터미널에 명령어를 입력하고, 파일을 저장하는 작업이 모두 Cursor 안에서 이루어집니다. 메모장이나 워드로는 코드 실행·AI 대화·터미널 사용이 한 번에 되지 않기 때문에, Cursor 설치는 선택이 아니라 필수입니다.

Cursor는 무료로 시작할 수 있고, Google 또는 GitHub 계정으로 로그인하면 바로 쓸 수 있습니다. 유료 플랜은 AI 사용량이 많아졌을 때 검토하시면 됩니다. 실습 입문 단계에서는 무료 범위로도 충분합니다.

---

세 도구를 한 번 설치해 두면, 이후 실습에서 필요한 다른 프로그램은 대부분 명령어 한두 줄로 추가할 수 있습니다. 지금은 각 도구가 “왜 필요한지” 정도만 이해하셨다면, 아래 설치 단계로 넘어가 주세요.

---

설치 전 준비 — 계정 만들기

프로그램을 설치하기 전에, Cursor·GitHub·Vercel에 미리 회원가입해 주세요. Cursor 로그인과 이후 GitHub 연동·배포 실습에 필요합니다. 이미 계정이 있다면 이 단계는 건너뛰셔도 됩니다.

• Cursor 회원가입 — Google 또는 GitHub 계정으로 가입할 수 있습니다. (실습에서는 Google 계정 로그인을 권장합니다.)
• GitHub 회원가입 — 코드 저장·공유·배포에 쓰는 계정입니다. 무료 계정으로 충분합니다.
• Vercel 회원가입 — 만든 웹사이트를 인터넷에 올리는(배포) 서비스입니다. GitHub 계정으로 가입하는 것을 권장합니다.

※ GitHub이 아니라 Google 계정으로 Vercel에 가입했다면? → 아래 자주 겪는 문제 — Vercel을 Google로 가입한 경우를 참고해 주세요.

---

설치 체크리스트

아래 순서대로 설치를 진행해 주세요.

• ☐ 1. Node.js 설치
• ☐ 2. Git 설치
• ☐ 3. Cursor 설치
• ☐ 4. Cursor 터미널에서 Git 설정

---

설치

Node.js → Git → Cursor 순서로 설치합니다. Git 사용자 설정(4단계)까지 마치면 설치 확인으로 넘어갑니다.

1. Node.js 설치

Node.js는 바이브 코딩으로 만든 앱을 내 PC에서 실행할 때 필요한 기본 엔진입니다. 웹·앱 개발 실습의 거의 모든 도구가 Node.js 위에서 동작합니다.

아래 영상을 보면서 진행해도 되고, 글의 스크린샷 순서대로 따라와도 됩니다.

1-1. Node.js 공식 사이트 접속

1. 웹 브라우저(Chrome, Edge 등)를 엽니다.
2. 주소창에 https://nodejs.org/ko 를 입력하고 Enter를 누릅니다.
3. 한국어 페이지가 열리면 준비 완료입니다.

1-2. 설치 파일 다운로드

1. 페이지 중앙의 Get Node.js® 버튼을 클릭합니다.

LTS / Current 중 뭘 골라야 하나요?

공식 페이지에서 직접 고를 경우 초록색 LTS 버튼을 누르세요.

LTS는 ‘가장 안정적인 버전’이라는 뜻이라, 비개발자에게 딱 맞습니다.

Current는 최신 실험 버전이라 실습용으로는 권장하지 않습니다.

Get Node.js® 버튼 하나만 보이면 LTS가 이미 선택된 상태이므로, 그대로 누르시면 됩니다.

1. Windows용 설치 프로그램(.msi)이 자동으로 다운로드됩니다. 파일 이름은 node-v○○.○.○-x64.msi 형태입니다. 페이지에 Windows Installer(.msi) 링크가 따로 보이면 그것을 눌러 받으셔도 됩니다.

1. 브라우저 하단이나 다운로드 폴더에서 .msi 파일을 찾습니다. 보통 다운로드 폴더에 저장됩니다.

1-3. Node.js 설치 프로그램 실행

1. 다운로드한 .msi 파일을 더블클릭해 실행합니다.

1. “이 앱이 디바이스를 변경하도록 허용하시겠습니까?” 창이 뜨면 예를 클릭합니다.
2. 설치 마법사가 열리면 Next(다음)를 눌러 진행합니다.
3. 라이선스 동의 화면 → I accept(동의) → Next.
4. 설치 경로, 구성 요소 선택 화면은 기본값 그대로 Next를 눌러 진행합니다. 특별히 바꿀 필요 없습니다.
5. Tools for Native Modules 또는 Add to PATH 항목이 보이면 체크된 상태(기본값)를 유지합니다. Add to PATH는 터미널 어디서든 node, npm 명령을 쓸 수 있게 해 주는 옵션입니다. 체크를 해제하면 설치 확인 단계에서 명령어가 인식되지 않을 수 있습니다.
6. Install(설치) → 완료되면 Finish(마침)를 누릅니다.

Node.js 설치가 끝나면 Git 설치(2단계)로 넘어갑니다. 설치 확인은 Cursor까지 설치한 뒤, 설치 확인 섹션에서 한꺼번에 진행합니다.

---

2. Git 설치

Git은 실습 중 만든 파일의 변경 이력을 저장하고, 나중에 GitHub 같은 서비스와 연결할 때 필요한 도구입니다. “어제 버전으로 되돌리기”, “팀원과 같은 파일 공유” 같은 작업의 기반이 됩니다.

2-1. Git 설치 페이지 접속

1. 브라우저에서 Git – Install for Windows 페이지를 엽니다.
2. Git for Windows/x64 Setup 링크를 클릭해 설치 파일을 다운로드합니다.

직접 링크: Git for Windows/x64 Setup

(버전 번호는 업데이트될 수 있습니다. 공식 페이지의 x64 Setup을 받으시면 됩니다.)

2-2. Git 설치 진행

1. 다운로드한 .exe 파일을 실행합니다.
2. 설치 마법사가 열리면 Next를 눌러 진행합니다.
3. Select Destination Location(설치 위치), Select Components(구성 요소) 화면이 나옵니다.

Select components 화면에서 아래 항목이 체크되어 있는지 확인합니다.

Add a git bash profile to Windows Terminal

이 옵션을 켜 두면, 나중에 Windows Terminal에서 Git Bash를 선택해 쓸 수 있습니다. 실습에서는 주로 Cursor 안의 터미널을 쓰지만, 체크해 두는 것을 권장합니다.

1. 그 외 화면(기본 에디터 선택, PATH 설정, HTTPS 설정, 줄바꿈 처리 등)은 모두 기본값(Default) 그대로 Next → Install → Finish로 마칩니다.
2. “Git Bash를 실행하시겠습니까?”가 나오면 지금은 닫아도 됩니다. Cursor에서 터미널을 쓸 예정입니다.

---

3. Cursor 설치

Cursor는 바이브 코딩 실습에서 사용할 AI 코드 편집기입니다. VS Code와 비슷한 화면에 AI 채팅이 붙어 있어, “이 기능 만들어줘”처럼 말로 요청하면서 코드를 작성할 수 있습니다.

3-1. 다운로드 및 설치

1. Cursor 다운로드 페이지에 접속합니다.
2. Windows용 Download 버튼을 눌러 설치 파일을 받습니다.
3. 다운로드한 설치 파일을 실행합니다.
4. 설치 마법사는 기본 설정 그대로 진행합니다. 특별히 변경할 항목이 없으면 Next → Install → Finish 순서로 마칩니다.

3-2. 첫 실행 및 로그인

1. 설치 후 Cursor를 실행합니다. 바탕화면 또는 시작 메뉴에서 Cursor 아이콘을 찾을 수 있습니다.
2. 처음 실행하면 Google 또는 GitHub 계정으로 로그인하라는 화면이 나옵니다. Google 계정으로 로그인해 주세요. (GitHub로도 로그인할 수 있지만, Google 계정 로그인을 권장합니다.)
3. 로그인 후 기본 단축키 안내, 테마 선택, 한국어 설정 등 초기 설정 화면이 나올 수 있습니다. 기본값으로 두거나, 한국어를 선호하시면 Language에서 Korean을 선택하시면 됩니다.

3-3. Agent 창 → Editor 창으로 바꾸기

Cursor를 처음 실행하면 Agent(에이전트) 화면이 먼저 열리는 경우가 많습니다. Agent 화면은 AI와 대화하는 데 특화된 레이아웃이고, 실습에서는 파일 목록·코드 편집·터미널이 함께 보이는 Editor(에디터) 화면을 주로 사용합니다. Git 설정(4단계)과 터미널 작업을 하려면 Editor로 바꿔 두는 것이 편합니다.

Editor로 전환하는 방법은 다음과 같습니다.

1. Cursor 창 우측 상단에 있는 Editor window 또는 IDE 버튼을 클릭합니다. (처음 한 번은 이 버튼으로 전환하는 것이 가장 확실합니다. Cursor 버전에 따라 버튼 이름이 Editor window 또는 IDE로 표시될 수 있습니다.) 또는 상단 메뉴 바에서 File을 클릭한 뒤 Open IDE(또는 Open Editor Window)를 선택해도 됩니다.
2. 한 번 Editor 화면으로 바꾼 뒤부터는 키보드 Ctrl + E로 Agent ↔ Editor를 빠르게 오갈 수 있습니다.

Editor 화면이 열리면 왼쪽(또는 설정에 따라 오른쪽)에 파일 탐색기, 가운데에 코드 편집 영역, 아래에 터미널(Ctrl + J)을 둘 수 있습니다. Agent 화면과 Editor 화면을 오가며 쓸 수 있지만, 설치 확인·Git 설정 단계에서는 Editor 화면에서 진행해 주세요.

Cursor 무료 플랜으로도 실습 시작에 충분합니다. 유료 전환은 나중에 필요할 때 검토하셔도 됩니다.

---

4. Cursor 터미널에서 Git 설정

Git을 Cursor 안에서 바로 쓰려면, “내 이름과 이메일”을 Git에 한 번 알려 주어야 합니다. GitHub에 올릴 때 누가 작업했는지 기록되도록 하는 설정입니다.

아래 단계는 모두 Cursor 프로그램 안에서 진행합니다.

4-1. 터미널 열기

1. Cursor를 실행합니다. Agent 화면이 열려 있다면 위 3-3단계대로 Editor 화면으로 전환합니다.
2. 키보드 Ctrl + J를 누릅니다. 화면 아래쪽에 패널이 열립니다.
3. 패널 상단 탭에서 Terminal을 클릭합니다. Problems, Output 등 다른 탭이 선택되어 있으면 Terminal로 바꿔 주세요.

1. 터미널 창에 $ 또는 PS로 시작하는 줄과 깜빡이는 커서가 보이면 준비 완료입니다.

4-2. Git 사용자 정보 설정

아래 명령어에서 "SIREAL", "sireal@example.com" 부분을 본인 이름·이메일로 바꿔, 한 줄씩 입력하고 Enter를 누릅니다.

git config --global user.name "SIREAL"
git config --global user.email "sireal@example.com"
git config --global init.defaultBranch main
git config --global credential.helper store
git config --global core.editor "notepad"

각 줄이 하는 일:

명령어	설명
user.name	Git 커밋(저장 기록)에 표시될 이름. 영문 권장 (예: "Sijin Jeon")
user.email	Git에 등록할 이메일. GitHub 쓸 예정이면 GitHub 가입 이메일과 맞추면 편합니다
init.defaultBranch main	새 프로젝트의 기본 브랜치 이름을 main으로 설정
credential.helper store	GitHub 등 로그인 정보를 PC에 저장해, 매번 비밀번호를 안 물어보게 함
core.editor “notepad”	Git이 메모를 열 때 Windows 메모장 사용 (Windows 전용)

따옴표 " 안에 이름·이메일을 넣는 것을 잊지 마세요. 본인 정보로 바꿔 입력하면 됩니다. 예시:

git config --global user.name "SIREAL"
git config --global user.email "sireal@example.com"

입력 후 아무 메시지가 없이 다음 줄로 넘어가면 정상입니다. Git config는 “설정 저장 완료” 메시지를 따로 띄우지 않습니다.

4-3. 터미널 화면 정리 (선택)

명령어를 많이 입력했다면 터미널을 깨끗이 비우고 싶을 수 있습니다. 아래를 입력합니다.

clear

---

설치 확인

1~4단계 설치가 모두 끝났다면, Cursor 터미널에서 프로그램이 제대로 설치됐는지 확인합니다. 4단계에서 연 터미널을 그대로 쓰셔도 되고, Cursor를 껐다 켰다면 Ctrl + J → Terminal로 다시 열어 주세요.

5. Node.js 설치 확인

Cursor 터미널에 아래 명령어를 입력하고 Enter를 누릅니다. (Cursor가 아직 없다면 Windows 시작 → powershell 검색 → Windows PowerShell 실행 후 같은 명령을 입력해도 됩니다.)

node -v

입력 방법: 터미널 창을 클릭한 뒤, node -v를 타이핑하거나 복사해서 붙여 넣고 Enter.

정상적으로 설치되었다면 v22.18.0처럼 v로 시작하는 버전 번호가 출력됩니다. 숫자가 조금 다르면(예: v24.x, v20.x) 괜찮습니다. v와 숫자가 보이면 Node.js 설치 성공입니다. 버전 번호는 PC마다 다를 수 있으며, “출시 번호”라고 생각하시면 됩니다.

'node'은(는) 내부 또는 외부 명령... 오류가 나오면 아래 “설치했는데 버전 정보가 나오지 않을 때” 또는 FAQ를 참고해 주세요.

---

6. npm 설치 확인

npm은 Node.js와 함께 설치되는 패키지 관리 도구입니다. 프로젝트마다 필요한 패키지(라이브러리) 목록을 npm install 한 번으로 받아오거나, package.json에 적힌 의존성(dependency)을 자동으로 설치할 때 씁니다. Node.js가 정상이면 npm도 함께 설치되어 있습니다. 별도 프로그램을 추가로 깔 필요는 없습니다.

Cursor 터미널에 아래를 입력합니다.

npm -v

v11.5.2처럼 버전 번호가 출력되면 npm도 정상입니다. Node.js와 마찬가지로 숫자가 조금 달라도 문제 없습니다. v10 이상이면 실습에 무리 없습니다.

버전이 너무 낮거나 npm 관련 오류가 반복되면, 아래 명령으로 npm만 최신 쪽으로 올린 뒤 다시 npm -v를 확인해 보세요. (선택 사항입니다. 정상 출력되면 건너뛰어도 됩니다.)

npm install -g npm@latest

---

7. Git·전체 설치 확인

마지막으로 Git과 세 도구 전체가 Cursor 터미널에서 동작하는지 확인합니다.

Cursor 터미널에서 아래 명령어를 하나씩 입력합니다.

git -v

node -v

npm -v

각 명령마다 버전 정보가 출력되면 설치가 모두 완료된 것입니다. 예시:

• git version 2.54.0.windows.1
• v22.18.0
• 11.5.2

숫자는 PC마다 조금 다를 수 있습니다. “버전 번호가 나온다”는 것만 확인하시면 됩니다.

세 가지 모두 버전이 보이면 Windows 바이브코딩 실습 환경 준비가 끝났습니다. Cursor를 열고 바로 실습을 시작하시면 됩니다.

설치했는데 버전 정보가 나오지 않을 때

Node.js나 Git 설치를 마쳤는데 node -v, git -v, npm -v 입력 시 버전 번호가 나오지 않거나 '…은(는) 내부 또는 외부 명령…' 오류가 나올 수 있습니다. 아래 순서대로 시도해 보세요.

1. Cursor를 완전히 종료한 뒤 다시 실행합니다.

창만 닫으면 Cursor가 백그라운드에서 계속 실행 중일 수 있습니다. Alt + F4로 창을 닫는 것만으로는 부족한 경우가 많습니다.

• 화면 우측 하단 작업 표시줄(시계·Wi-Fi·볼륨 아이콘이 있는 영역)을 확인합니다.
• ^ 또는 ▲ 아이콘을 클릭해 숨겨진 아이콘을 펼칩니다.
• Cursor 아이콘을 마우스 오른쪽 버튼으로 클릭합니다.
• Quit(종료) 또는 Exit Cursor(Cursor 종료)를 선택합니다.

Cursor를 다시 실행한 뒤 Editor 화면에서 터미널을 열고, node -v, git -v, npm -v를 다시 입력해 보세요.

1. 그래도 버전이 나오지 않으면 PC를 재부팅합니다.

설치 직후에는 Windows가 프로그램 경로(PATH)를 아직 반영하지 못한 경우가 있습니다. 재부팅 후 Cursor를 실행하고 같은 명령어를 다시 입력해 보세요.

1. 
   

   재부팅 후에도 동일하면 프로그램을 완전히 제거한 뒤 다시 설치합니다.

   
   
2. 
   

   Windows 시작 → 설정 → 앱 → 설치된 앱(또는 프로그램 추가/제거)으로 이동합니다.

   
   
3. Node.js, Git, Cursor를 각각 찾아 제거(삭제)합니다.
4. PC를 한 번 더 재부팅합니다.
5. 이 글의 1~3단계(Node.js → Git → Cursor)부터 다시 설치합니다.

Node.js 재설치 시 Add to PATH 옵션은 기본값(체크됨)을 유지하고, Git 재설치 시 “Git from the command line and also from 3rd-party software”가 선택된 상태(기본값)인지 확인하세요.

1. 위 방법을 모두 진행했는데도 해결되지 않으면, AI에게 오류 내용을 보여 주고 도움을 요청해 보세요.

Cursor 에이전트 패널 여는 방법:

• Cursor 창 우측 상단에서 톱니바퀴(설정) 바로 왼쪽에 있는 Agent(에이전트) 아이콘을 클릭합니다.
• 또는 키보드 Ctrl + Alt + B를 눌러 AI 채팅(에이전트) 패널을 열거나 닫습니다. (Editor 화면에서도 사용할 수 있습니다.)

오류를 AI에게 물어보는 방법:

• 터미널에 표시된 오류 메시지 전체를 드래그해 복사(Ctrl + C)합니다.
• 에이전트 채팅에 붙여 넣고, “Windows에서 Node.js(또는 Git) 설치 후 node -v를 입력했는데 이 오류가 납니다. 해결 방법을 알려주세요”처럼 상황을 함께 적어 질문합니다.
• Cursor로 해결이 어렵다면, 같은 오류 메시지를 ChatGPT, Gemini, Claude 등 다른 AI에 붙여 넣어 추가로 물어볼 수 있습니다. 오류 문구가 길수록 답변 정확도가 올라가므로, 터미널에 출력된 내용을 빠짐없이 복사하는 것이 좋습니다.

---

자주 겪는 문제

node, npm, git 명령어가 인식되지 않는 경우

설치 확인 단계의 “설치했는데 버전 정보가 나오지 않을 때”와 동일합니다. 요약하면:

1. Alt + F4가 아니라, 작업 표시줄 우측 하단(트레이)의 Cursor 아이콘 → Quit(종료)로 완전히 종료한 뒤 재실행합니다.
2. node -v, npm -v, git -v를 다시 입력합니다.
3. 그래도 안 되면 PC를 재부팅한 뒤 재시도합니다.
4. 그래도 안 되면 설정 → 앱 → 설치된 앱(프로그램 추가/제거)에서 Node.js·Git·Cursor를 제거하고, 재부팅 후 처음부터 다시 설치합니다.
5. 위 단계를 모두 했는데도 해결되지 않으면, Cursor 에이전트 패널(우측 상단 설정 왼쪽 Agent 아이콘, 또는 Ctrl + Alt + B)을 열어 터미널 오류를 복사해 붙여 넣고 질문하거나, ChatGPT·Gemini·Claude 등 다른 AI에 같은 오류 메시지를 붙여 넣어 해결 방법을 물어보세요.

PowerShell 실행 정책 오류가 나오는 경우 (실습 중 해당될 때만)

실습 중 npm install 등을 실행할 때 “스크립트 실행이 금지되어 있습니다” 같은 오류가 나올 수 있습니다. 그때만 Cursor 터미널에 아래를 입력합니다.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

질문이 나오면 A(모두 예)를 입력합니다.

Git 설치 후 git 명령어가 안 되는 경우

위 “node, npm, git 명령어가 인식되지 않는 경우”와 같은 순서로 진행합니다. Git만 문제일 때는 Git을 프로그램 추가/제거에서 삭제한 뒤 git-scm.com/install/windows에서 재설치하고, “Git from the command line and also from 3rd-party software” 옵션이 선택된 상태(기본값)인지 확인하세요.

회사 PC라 설치가 막히는 경우

회사 보안 정책 때문에 .exe·.msi 설치, 관리자 권한 실행, PowerShell 정책 변경이 막혀 있을 수 있습니다.

• IT 담당자에게 Node.js, Git, Cursor 설치 권한을 요청해 주세요.
• “개발·교육용 도구”라고 설명하시면 승인받는 경우가 많습니다.
• 설치가 어려우시면 실습 전에 미리 문의해 주시면, 가능한 범위에서 함께 확인해 드립니다.

Cursor 로그인이 안 되는 경우

• 회사 네트워크·VPN에서 cursor.com 접속이 차단될 수 있습니다. VPN을 끄거나, 다른 네트워크(핫스팟 등)에서 시도해 보세요.
• Google 로그인이 안 되면 GitHub 계정으로 시도해 보세요.

Vercel을 Google로 가입한 경우 — GitHub 계정 연동하기

Vercel을 Google 계정으로 먼저 만들었다면, 배포 실습 전에 GitHub 계정을 같은 Vercel 계정에 연결해 주세요. GitHub으로 다시 새로 가입하면 계정이 두 개로 나뉠 수 있으니, 기존 계정에 연동하는 방식을 권장합니다.

1. 브라우저에서 Vercel에 기존에 쓰던 Google 계정으로 로그인합니다.

2. 우측 상단 프로필 아이콘 → Account Settings(계정 설정)을 엽니다. 또는 vercel.com/account로 바로 이동합니다.

3. Authentication 항목에서 GitHub 옆 Connect(연결) 버튼을 클릭합니다.

4. GitHub 로그인·권한 승인 화면이 나오면, 실습에 쓸 GitHub 계정으로 로그인한 뒤 Authorize(승인)합니다.

5. 다시 Account Settings로 돌아와 Login Connections에 GitHub이 연결되어 있으면 완료입니다.

이후 프로젝트를 배포할 때 Import Git Repository 화면에서 GitHub 저장소가 보이면 정상적으로 연동된 것입니다. GitHub이 보이지 않으면 위 연동을 다시 확인하거나, 배포 화면에서 GitHub Install/Configure를 눌러 권한을 추가해 주세요.

---

다음에 할 일

1. Cursor를 실행하고, 새 폴더를 열어 실습 프로젝트를 시작합니다.
2. Mac을 쓰는 분은 Mac 설치 가이드를 참고해 주세요.
3. 설치 중 막히는 부분이 있으면 시리얼 블로그 댓글이나 네이버 카페에 질문을 남겨 주세요.

여기까지 완료하셨다면, Windows에서 바이브코딩을 시작할 준비가 끝났습니다.

작성: 전시진 | 시리얼(Sireal)