🪟 왜 Windows 환경 세팅이 따로 필요한가

바이브코딩 관련 가이드를 검색하면 macOS 기준으로 작성된 글이 많습니다. 터미널 명령어, 설치 방법, 경로 구조가 macOS와 Windows에서 다르기 때문에, macOS용 가이드를 그대로 따라하면 Windows에서는 에러가 납니다.

Windows에서 바이브코딩 환경을 세팅할 때 가장 많이 막히는 부분은 세 가지입니다. 터미널 선택(cmd vs PowerShell), 환경변수(PATH) 문제, 그리고 권한 설정입니다. 이 글은 Windows 사용자만을 위해 이 세 가지 함정을 피하면서 처음부터 끝까지 환경을 세팅하는 방법을 안내합니다.

Windows 10 또는 Windows 11을 기준으로 작성했습니다. Windows 8 이하에서는 일부 명령어(winget 등)가 동작하지 않을 수 있습니다.

📌 시작 전 확인사항

환경 세팅을 시작하기 전에 아래 두 가지를 먼저 확인하세요.

💻 Windows 버전 확인

Win+R을 누르고 winver를 입력하면 현재 Windows 버전을 확인할 수 있습니다. Windows 10 버전 1809 이상 또는 Windows 11이면 이 가이드의 모든 내용을 따라할 수 있습니다.

🔑 관리자 권한 확인

일부 설치 과정에서 관리자 권한이 필요합니다. 본인 계정이 관리자인지 확인하려면 시작 메뉴에서 "설정" → "계정"을 열어보세요. 계정 이름 아래에 "관리자"라고 표시되면 됩니다. 관리자가 아닌 경우 일부 설치 단계에서 "이 앱이 변경을 수행하도록 허용하시겠습니까?" 팝업이 뜰 때 관리자 비밀번호가 필요합니다.

🖥️ 1단계: PowerShell 열기와 기본 사용법

Windows에는 여러 터미널이 있습니다. 명령 프롬프트(cmd), PowerShell, Windows 터미널 등이 있는데, 바이브코딩에서는 PowerShell을 사용합니다. PowerShell이 cmd보다 최신이고, winget 같은 패키지 관리 명령어를 기본 지원하기 때문입니다.

📥 PowerShell 여는 방법

시작 메뉴에서 "PowerShell"을 검색하고 클릭하면 열립니다. 또는 Win+X를 누른 뒤 "Windows PowerShell"을 선택해도 됩니다. Windows 11에서는 "Windows 터미널"이 기본인데, 이 안에서 PowerShell 탭이 자동으로 열립니다.

📌 알아두면 좋은 기본 조작

동작	방법
명령어 붙여넣기	마우스 오른쪽 클릭 또는 `Ctrl+V`
실행 중 명령 중단	`Ctrl+C`
이전 명령어 다시 보기	위쪽 화살표(↑)
화면 지우기	`cls` 입력 후 Enter

복사한 명령어를 PowerShell에 붙여넣을 때는 Ctrl+V를 사용하세요. 과거에는 마우스 오른쪽 클릭만 가능했지만, Windows 10 이후로는 Ctrl+V도 동작합니다.

📦 2단계: winget 확인

winget은 Windows에 내장된 패키지 관리자입니다. App Store에서 앱을 설치하듯이, 터미널에서 명령어 한 줄로 프로그램을 설치할 수 있게 해줍니다. Windows 10(1809 이상)과 Windows 11에는 기본으로 포함돼 있습니다.

PowerShell에서 아래 명령어를 실행해보세요.

winget --version

버전 번호(예: v1.7.xxx)가 나오면 winget이 정상 동작하는 것입니다. "명령어를 찾을 수 없습니다"가 나오면 Microsoft Store에서 "앱 설치 관리자"를 검색해서 업데이트하세요.

winget이 동작하지 않는 환경이라면 각 도구의 공식 사이트에서 설치 파일을 직접 다운로드해도 됩니다. 이 가이드에서는 두 가지 방법을 모두 안내합니다.

🔧 3단계: Git 설치

Git은 코드의 변경 이력을 관리하는 도구입니다. 바이브코딩에서 AI에게 여러 번 수정을 요청할 때, 마음에 들었던 이전 상태로 돌아갈 수 있게 해주는 안전장치입니다.

📥 winget으로 설치 (추천)

winget install --id Git.Git -e --source winget

설치가 끝나면 PowerShell을 닫고 새로 열어야 합니다. 기존 터미널에는 Git의 PATH가 반영되지 않은 상태이기 때문입니다.

📥 공식 사이트에서 설치

winget이 안 되면 Git 공식 다운로드 페이지에서 "Windows"를 클릭해 설치 파일을 다운로드합니다. 설치 마법사에서 모든 옵션은 기본값(Next)으로 진행하되, "Adjusting your PATH environment" 화면에서 "Git from the command line and also from 3rd-party software"가 선택돼 있는지 확인하세요.

✅ 설치 확인

새 PowerShell을 열고 아래 명령어를 실행하세요.

git --version

git version 2.x.x가 나오면 성공입니다.

📌 Git 초기 설정

설치 후 사용자 이름과 이메일을 등록해야 합니다. 커밋(저장)할 때 누가 변경했는지 기록하는 용도입니다.

git config --global user.name "내 이름"
git config --global user.email "my@email.com"

📗 4단계: Node.js 설치

Node.js는 JavaScript 코드를 실행하는 환경입니다. AI가 만들어준 웹 프로젝트를 내 컴퓨터에서 돌려보려면 반드시 필요합니다. 프로젝트를 생성하는 명령어(npx create-next-app)도 Node.js가 있어야 동작합니다.

📥 winget으로 설치 (추천)

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

이 명령어는 자동으로 LTS(안정 버전)를 설치합니다. 설치 후 PowerShell을 닫고 새로 여세요.

📥 공식 사이트에서 설치

Node.js 공식 사이트에서 LTS 버전을 다운로드합니다. 설치 마법사에서 기본값으로 진행하세요. "Automatically install the necessary tools" 체크박스는 체크하지 않아도 됩니다. 이 옵션은 C++ 빌드 도구를 추가 설치하는 것인데, 바이브코딩 입문에는 불필요하고 설치 시간만 크게 늘어납니다.

✅ 설치 확인

새 PowerShell에서 아래 세 가지를 확인하세요.

node -v
npm -v
npx -v

세 가지 모두 버전 번호가 나오면 정상입니다. npm과 npx는 Node.js를 설치하면 자동으로 함께 설치됩니다.

💙 5단계: VS Code 설치

VS Code(Visual Studio Code)는 코드를 작성하고 편집하는 프로그램입니다. AI 코딩 확장 프로그램(Copilot, Cursor 연동 등)을 설치할 수 있는 가장 범용적인 편집기입니다.

📥 winget으로 설치 (추천)

winget install --id Microsoft.VisualStudioCode -e --source winget

📥 공식 사이트에서 설치

VS Code 공식 사이트에서 Windows용 설치 파일을 다운로드합니다. 설치할 때 "PATH에 추가" 옵션을 반드시 체크하세요. 이 옵션이 있어야 터미널에서 code . 명령어로 현재 폴더를 VS Code에서 바로 열 수 있습니다.

✅ 설치 확인

PowerShell을 닫고 새로 연 뒤 아래 명령어를 실행하세요.

code --version

버전 번호가 나오면 정상입니다. 인식되지 않으면 VS Code를 실행한 뒤 Ctrl+Shift+P → "Shell Command: Install 'code' command in PATH"를 실행하세요.

✅ 6단계: 전체 점검

세 가지 도구가 모두 설치됐는지 한 번에 확인하는 방법입니다. PowerShell을 새로 열고 아래 명령어를 순서대로 실행하세요.

git --version
node -v
npm -v
code --version

명령어	정상 결과	실패 시 원인
`git --version`	`git version 2.x.x`	Git 미설치 또는 PATH 미등록
`node -v`	`v20.x.x` 등	Node.js 미설치 또는 PATH 미등록
`npm -v`	`10.x.x` 등	Node.js 설치 불완전
`code --version`	버전 번호	VS Code PATH 미등록

네 가지 모두 버전 번호가 나오면 개발환경 세팅이 완료된 것입니다.

🚀 7단계: 첫 프로젝트로 최종 검증

도구 설치만으로는 "진짜 동작하는지" 확신하기 어렵습니다. 실제로 프로젝트를 하나 만들어서 브라우저에서 확인하는 것이 가장 확실한 검증입니다.

📁 프로젝트 생성

바탕화면이나 원하는 폴더에서 PowerShell을 열고 아래 명령어를 실행하세요.

npx create-next-app@latest my-first-site

여러 옵션을 물어보는데, 모두 기본값(Enter)으로 진행하면 됩니다.

▶️ 개발 서버 실행

cd my-first-site
npm run dev

터미널에 http://localhost:3000이 표시됩니다. 이 주소를 웹 브라우저에 붙여넣어 Next.js 기본 페이지가 나타나면 모든 환경 세팅이 정상입니다. 개발 서버를 종료하려면 Ctrl+C를 누르세요.

🎯 VS Code에서 프로젝트 열기

프로젝트 폴더에서 아래 명령어를 실행하면 VS Code가 열립니다.

code .

VS Code가 열리면 Ctrl+` (백틱)을 눌러 내장 터미널을 열 수 있습니다. 앞으로는 별도 PowerShell을 열 필요 없이 VS Code 안에서 코드 편집과 명령어 실행을 모두 할 수 있습니다.

⚠️ Windows에서 자주 발생하는 문제와 해결

🚫 "이 시스템에서 스크립트를 실행할 수 없습니다"

PowerShell의 실행 정책(Execution Policy) 때문에 발생합니다. PowerShell을 관리자 권한으로 열고(시작 메뉴에서 PowerShell을 마우스 오른쪽 클릭 → "관리자 권한으로 실행") 아래 명령어를 실행하세요.

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

"Y"를 입력하면 적용됩니다. 이 설정은 로컬에서 작성한 스크립트와 서명된 원격 스크립트를 실행할 수 있게 해줍니다. 보안상 문제가 없는 안전한 설정입니다.

🚫 "명령어를 찾을 수 없습니다" (PATH 문제)

가장 흔한 문제입니다. 설치는 됐지만 시스템 환경변수(PATH)에 프로그램 경로가 등록되지 않은 경우에 발생합니다.

해결 순서:

먼저 PowerShell을 닫고 새로 열어보세요. 대부분 이것으로 해결됩니다.
그래도 안 되면 컴퓨터를 재시작하세요. 일부 설치 프로그램은 재시작 후에 PATH가 적용됩니다.
재시작 후에도 안 되면 수동으로 PATH를 추가합니다.

수동 PATH 추가 방법:

시작 메뉴에서 "환경 변수"를 검색 → "시스템 환경 변수 편집" → 환경 변수 버튼 클릭 → 사용자 변수에서 "Path"를 선택 → 편집 → 새로 만들기 → 경로를 추가합니다.

도구	기본 설치 경로
Git	`C:\Program Files\Git\cmd`
Node.js	`C:\Program Files\nodejs\`
VS Code	`C:\Users\{사용자명}\AppData\Local\Programs\Microsoft VS Code\bin`

🚫 winget이 동작하지 않음

Windows 10에서 winget이 인식되지 않는 경우, Microsoft Store를 열고 "앱 설치 관리자"를 검색해서 업데이트하세요. 회사/학교 관리 PC에서 Microsoft Store가 차단된 경우에는 winget을 사용할 수 없으므로 각 도구의 공식 사이트에서 직접 다운로드해야 합니다.

🚫 Node.js 설치 후 npm이 안 됨

드물게 Node.js는 설치됐는데 npm이 인식되지 않는 경우가 있습니다. Node.js를 완전히 삭제("프로그램 추가/제거"에서 Node.js 삭제)하고 다시 설치하는 게 가장 빠릅니다. 삭제 전에 C:\Users\{사용자명}\AppData\Roaming\npm 폴더도 함께 삭제하면 깔끔합니다.

🚫 방화벽/백신이 설치를 차단

회사나 학교 PC에서는 보안 프로그램이 설치를 차단하는 경우가 있습니다. "차단됨" 또는 "접근 거부" 메시지가 나오면 IT 담당자에게 문의하거나, 개인 PC에서 진행하는 것을 권장합니다. 보안 프로그램을 임의로 끄는 것은 권장하지 않습니다.

🔄 cmd vs PowerShell vs Windows 터미널

Windows에는 터미널이 여러 개 있어서 처음에는 혼란스럽습니다. 각각의 차이와 추천을 정리합니다.

터미널	특징	추천 여부
명령 프롬프트(cmd)	오래된 기본 터미널, 기능 제한적	비추천
PowerShell	최신 기본 터미널, winget 지원	추천
Windows 터미널	탭 지원, PowerShell/cmd 통합	추천 (Win 11 기본)
VS Code 내장 터미널	코드 편집과 명령어를 한 곳에서	가장 추천

바이브코딩을 시작한 뒤에는 VS Code 내장 터미널을 주로 사용하게 됩니다. 코드를 수정하면서 바로 명령어를 실행할 수 있어서 작업 흐름이 끊기지 않습니다.

💡 Windows 환경 세팅 시 알아두면 좋은 팁

📌 설치 순서는 Git → Node.js → VS Code

이 순서를 지키면 VS Code가 Git을 자동으로 인식하고, Node.js 명령어(npx)를 바로 사용할 수 있습니다. 순서를 바꿔도 동작하지만, VS Code에서 Git 연동이 자동으로 안 될 수 있어서 추가 설정이 필요해집니다.

📌 폴더 경로에 한글이나 공백이 있으면 주의

프로젝트를 만들 폴더 경로에 한글이나 공백이 포함되면 일부 도구에서 에러가 발생할 수 있습니다. C:\Users\사용자\바탕화면\내 프로젝트 대신 C:\projects\my-first-site처럼 영문 경로를 사용하는 것이 안전합니다.

📌 터미널을 닫고 새로 여는 습관

Windows에서 프로그램을 설치한 뒤 "명령어를 찾을 수 없습니다"가 나오면, 대부분 터미널을 닫고 새로 여는 것만으로 해결됩니다. 환경변수는 터미널이 시작될 때 한 번만 읽히기 때문입니다. 문제가 생기면 가장 먼저 시도할 행동입니다.

📌 Windows Defender 실시간 보호와 개발 속도

Windows Defender의 실시간 보호 기능이 node_modules 폴더의 수천 개 파일을 검사하면서 프로젝트 생성과 실행이 느려질 수 있습니다. 프로젝트 폴더를 Windows Defender의 제외 목록에 추가하면 속도가 개선됩니다. "Windows 보안" → "바이러스 및 위협 방지" → "설정 관리" → "제외 추가"에서 프로젝트 폴더를 추가하세요.

⚡ 한 번에 끝내기: VibeStart 활용

위 과정을 하나씩 따라하기 어렵다면 VibeStart를 이용해보세요. Windows를 선택하면 Git, Node.js, VS Code 설치에 필요한 명령어를 단계별로 제공합니다. 각 명령어를 복사해서 PowerShell에 붙여넣기만 하면 되고, 환경변수 문제와 실행 정책 설정까지 자동으로 처리됩니다.

🪟 왜 Windows 환경 세팅이 따로 필요한가

📌 시작 전 확인사항

💻 Windows 버전 확인

🔑 관리자 권한 확인

🖥️ 1단계: PowerShell 열기와 기본 사용법

📥 PowerShell 여는 방법

📌 알아두면 좋은 기본 조작

📦 2단계: winget 확인

🔧 3단계: Git 설치

📥 winget으로 설치 (추천)

📥 공식 사이트에서 설치

✅ 설치 확인

📌 Git 초기 설정

📗 4단계: Node.js 설치

📥 winget으로 설치 (추천)

📥 공식 사이트에서 설치

✅ 설치 확인

💙 5단계: VS Code 설치

📥 winget으로 설치 (추천)

📥 공식 사이트에서 설치

✅ 설치 확인

✅ 6단계: 전체 점검

🚀 7단계: 첫 프로젝트로 최종 검증

📁 프로젝트 생성

▶️ 개발 서버 실행

🎯 VS Code에서 프로젝트 열기

⚠️ Windows에서 자주 발생하는 문제와 해결

🚫 "이 시스템에서 스크립트를 실행할 수 없습니다"

🚫 "명령어를 찾을 수 없습니다" (PATH 문제)

🚫 winget이 동작하지 않음

🚫 Node.js 설치 후 npm이 안 됨

🚫 방화벽/백신이 설치를 차단

🔄 cmd vs PowerShell vs Windows 터미널

💡 Windows 환경 세팅 시 알아두면 좋은 팁

📌 설치 순서는 Git → Node.js → VS Code

📌 폴더 경로에 한글이나 공백이 있으면 주의

📌 터미널을 닫고 새로 여는 습관

📌 Windows Defender 실시간 보호와 개발 속도

⚡ 한 번에 끝내기: VibeStart 활용

🔗 관련 글

📑 참고 자료