🚀 Cursor란 무엇이고, 바이브코딩에 왜 쓰는가

Cursor는 AI가 내장된 코드 에디터입니다. VS Code와 거의 동일한 인터페이스를 사용하면서, 에디터 안에서 AI에게 직접 코딩을 요청할 수 있습니다. 별도 브라우저나 ChatGPT 창을 오가지 않아도 되기 때문에 바이브코딩에서 작업 흐름이 끊기지 않습니다.

기존 VS Code 사용자라면 설정, 확장 프로그램, 단축키를 그대로 가져올 수 있습니다. 새로 처음 시작하는 분이라도 VS Code를 다루는 글에서 배운 내용이 Cursor에도 그대로 적용됩니다. 이 글은 Cursor를 처음 설치하고, AI와 대화하면서 첫 프로젝트를 만드는 과정까지 안내합니다.

📋 설치 전 확인 사항

Cursor를 설치하기 전에 몇 가지를 먼저 확인하세요.

💻 시스템 요구 사항

항목	Windows	macOS
OS 버전	Windows 10 이상	macOS 12 (Monterey) 이상
RAM	8GB 이상 권장	8GB 이상 권장
디스크 공간	약 500MB	약 500MB
인터넷	설치 및 AI 기능 사용 시 필요	설치 및 AI 기능 사용 시 필요

📌 Node.js와 Git 사전 설치

Cursor 자체는 Node.js나 Git 없이도 설치됩니다. 하지만 바이브코딩으로 웹 프로젝트를 만들려면 두 도구가 필요합니다. 아직 설치하지 않았다면 먼저 진행하세요.

터미널에서 git --version과 node --version을 입력해서 버전 번호가 출력되면 준비 완료입니다.

📥 Cursor 다운로드 및 설치

🪟 Windows 설치

브라우저에서 cursor.com에 접속합니다.
메인 화면의 "Download" 버튼을 클릭하면 Windows용 설치 파일(.exe)이 자동으로 다운로드됩니다.
다운로드된 .exe 파일을 실행합니다.
설치 마법사가 열리면 안내에 따라 "다음"을 클릭합니다. 기본 설정 그대로 진행하면 됩니다.
설치가 완료되면 Cursor가 자동으로 실행됩니다.

설치 경로를 바꾸고 싶지 않다면 기본값을 그대로 두세요. 대부분의 사용자에게 기본 설치 경로가 가장 안전합니다.

🍎 macOS 설치

cursor.com에 접속합니다.
"Download" 버튼을 클릭하면 macOS용 .dmg 파일이 다운로드됩니다.
다운로드된 .dmg 파일을 더블 클릭합니다.
Cursor 아이콘을 Applications 폴더로 드래그합니다.
Applications 폴더에서 Cursor를 더블 클릭해 실행합니다.

처음 실행할 때 "인터넷에서 다운로드한 앱입니다"라는 보안 경고가 나올 수 있습니다. "열기"를 클릭하면 정상적으로 시작됩니다. Apple Silicon(M1/M2/M3/M4) Mac이라면 별도 설정 없이 네이티브로 동작합니다.

🔧 첫 실행과 초기 설정

Cursor를 처음 실행하면 몇 가지 설정 화면이 나타납니다.

🎨 테마 선택

다크 테마 또는 라이트 테마 중 하나를 선택합니다. 나중에 설정에서 언제든 변경할 수 있으므로 편한 것을 고르면 됩니다.

📦 VS Code 설정 가져오기

이전에 VS Code를 사용했다면 "Import VS Code Settings" 옵션을 선택하세요. 확장 프로그램, 설정, 키바인딩이 자동으로 가져와집니다. VS Code를 사용한 적 없다면 이 단계를 건너뛰세요.

🔑 계정 생성 및 로그인

Cursor의 AI 기능을 사용하려면 계정이 필요합니다.

"Sign Up" 또는 "Log In" 버튼을 클릭합니다.
이메일, Google, 또는 GitHub 계정으로 가입할 수 있습니다.
무료 플랜(Hobby)으로 시작하면 됩니다. 한 달에 2,000회의 자동완성과 50회의 느린 프리미엄 요청을 사용할 수 있습니다.

가입 후 에디터 오른쪽 상단에 프로필 아이콘이 보이면 로그인이 정상적으로 된 것입니다.

⌨️ 키바인딩 선택

VS Code 스타일 키바인딩이 기본으로 선택됩니다. VS Code에 익숙하다면 그대로 두세요. 다른 에디터(Vim, Emacs 등)에 익숙하다면 해당 옵션을 선택할 수 있습니다.

🤖 Cursor의 AI 기능 살펴보기

Cursor에는 세 가지 주요 AI 기능이 있습니다.

💬 Chat (채팅)

Ctrl+L(macOS: Cmd+L)을 누르면 오른쪽에 채팅 패널이 열립니다. 여기서 AI에게 코드 작성, 설명, 수정 등을 자유롭게 요청할 수 있습니다.

예시 요청	설명
"이 파일의 코드를 설명해줘"	현재 열린 파일의 코드 설명
"로그인 폼 컴포넌트 만들어줘"	새 코드 생성
"이 에러 어떻게 고쳐?"	에러 메시지를 보고 해결 방법 제안

채팅 패널에서 @ 기호를 사용하면 특정 파일이나 폴더를 참조하도록 지정할 수 있습니다. @파일이름을 입력하면 AI가 해당 파일의 내용을 기반으로 답변합니다.

✏️ Inline Edit (인라인 편집)

코드의 특정 부분을 선택한 뒤 Ctrl+K(macOS: Cmd+K)를 누르면 인라인 편집 창이 나타납니다. "이 함수를 TypeScript로 변환해줘"처럼 선택한 코드에 대한 수정을 요청하면, AI가 바로 그 자리에서 코드를 수정합니다. 변경 사항은 diff 형태로 보여주기 때문에 수락하기 전에 무엇이 바뀌는지 확인할 수 있습니다.

🔮 Tab (자동완성)

코드를 작성하는 중에 AI가 다음에 올 코드를 자동으로 제안합니다. Tab을 누르면 제안을 수락하고, Esc를 누르면 무시합니다. 함수 이름만 입력해도 AI가 함수 본문 전체를 제안하는 경우가 많습니다.

📁 첫 프로젝트 만들기

Cursor 설치와 설정이 끝났으니 실제로 프로젝트를 만들어보겠습니다.

📌 프로젝트 폴더 생성

내장 터미널을 엽니다 (Ctrl+` 또는 메뉴에서 터미널 → 새 터미널).
프로젝트를 만들 위치로 이동합니다.

# Windows
cd C:\Users\사용자이름\Documents

# macOS
cd ~/Documents

새 폴더를 만들고 이동합니다.

mkdir my-first-project
cd my-first-project

📌 AI에게 프로젝트 생성 요청

Ctrl+L(macOS: Cmd+L)로 채팅을 열고 아래처럼 요청합니다.

이 폴더에 Next.js 프로젝트를 만들어줘. TypeScript를 사용하고, 
App Router를 쓰는 기본 구조로 만들어줘.

AI가 터미널에서 실행할 명령어를 알려줍니다. 보통 다음과 같은 명령어를 제안합니다.

npx create-next-app@latest . --typescript --app --eslint

AI가 제안한 명령어를 터미널에서 실행하면 프로젝트가 생성됩니다. 설치 중 선택지가 나오면 AI가 추천한 옵션대로 선택하세요.

📌 개발 서버 실행

프로젝트 생성이 완료되면 개발 서버를 실행합니다.

npm run dev

터미널에 http://localhost:3000 주소가 표시되면 성공입니다. 브라우저에서 이 주소를 열면 Next.js 기본 페이지가 보입니다.

📌 AI에게 페이지 수정 요청

개발 서버가 실행 중인 상태에서 app/page.tsx 파일을 열고, 채팅(Ctrl+L)에서 요청합니다.

이 페이지를 간단한 자기소개 페이지로 바꿔줘. 
이름, 한 줄 소개, 좋아하는 것 3가지를 표시해줘.

AI가 코드를 수정해주면 브라우저에서 localhost:3000을 새로고침해보세요. 내가 요청한 대로 페이지가 바뀌어 있습니다. 이것이 바이브코딩의 기본 흐름입니다.

✅ 설치 확인 점검 목록

모든 과정이 정상적으로 진행됐는지 아래 항목을 확인하세요.

항목	확인 방법	정상 신호
Cursor 설치	Cursor 앱 실행	에디터 화면이 열림
계정 로그인	오른쪽 상단 프로필 아이콘	프로필 아이콘 표시
AI 채팅	`Ctrl+L`로 채팅 열기	채팅 패널 표시, 응답 정상
터미널	Ctrl+`로 터미널 열기	터미널 프롬프트 표시
Node.js 연동	터미널에서 `node --version`	버전 번호 출력
프로젝트 생성	`npx create-next-app` 실행	프로젝트 파일 생성됨
개발 서버	`npm run dev` 실행	`localhost:3000` 접속 가능

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

🚫 설치 파일 실행 시 보안 경고가 뜸

Windows에서 "Windows가 PC를 보호했습니다" 메시지가 나타날 수 있습니다. "추가 정보"를 클릭한 뒤 "실행"을 누르면 됩니다. Cursor는 공식 사이트에서 배포하는 서명된 설치 파일이므로 안전합니다.

macOS에서 "확인되지 않은 개발자" 경고가 뜨면 시스템 설정 → 개인 정보 보호 및 보안에서 "확인 없이 열기"를 선택하세요.

🚫 AI 기능이 동작하지 않음

로그인이 안 돼 있거나 무료 사용량이 소진됐을 수 있습니다. 오른쪽 상단 프로필 아이콘을 클릭해서 로그인 상태와 잔여 사용량을 확인하세요. 네트워크 방화벽이 Cursor의 API 요청을 차단하는 경우에도 동작하지 않으므로, 회사나 학교 네트워크에서는 개인 네트워크로 전환해보세요.

🚫 VS Code 설정 가져오기가 안 됨

VS Code가 설치돼 있어야 설정을 가져올 수 있습니다. VS Code가 설치돼 있는데도 안 되면, Cursor를 종료하고 다시 실행해보세요. 설정 가져오기는 처음 실행 시에만 안내가 나오며, 이후에는 Settings → General에서 수동으로 가져올 수 있습니다.

🚫 터미널에서 node 명령어가 인식되지 않음

Node.js가 설치되지 않았거나 PATH에 등록되지 않은 경우입니다. Node.js 설치 가이드를 따라 설치한 뒤, Cursor를 완전히 종료하고 다시 열어야 PATH가 반영됩니다.

🆓 Cursor 무료 플랜과 유료 플랜 비교

항목	Hobby (무료)	Pro ($20/월)
자동완성	2,000회/월	무제한
느린 프리미엄 요청	50회/월	무제한 (빠른 요청 500회 포함)
모델 선택	제한적	GPT-4o, Claude Sonnet 등

바이브코딩 입문 단계에서는 무료 플랜으로 충분합니다. AI 요청 횟수가 부족하다고 느껴지면 그때 Pro 플랜을 고려하세요. 무료 사용량은 매달 초에 리셋됩니다.

💡 Cursor를 더 잘 쓰는 팁

📌 프롬프트를 구체적으로 작성하기

"버튼 만들어줘"보다 "파란색 배경에 흰색 텍스트인 '제출' 버튼을 만들어줘. 호버 시 배경이 진한 파란색으로 변하게 해줘"처럼 구체적으로 요청하면 원하는 결과를 더 빠르게 얻을 수 있습니다.

📌 @파일 참조 활용하기

채팅에서 @파일이름을 사용하면 AI가 해당 파일을 참고해서 답변합니다. 여러 파일을 동시에 참조할 수도 있습니다. 프로젝트의 맥락을 AI에게 전달하면 더 정확한 코드를 생성합니다.

📌 diff를 꼭 확인하기

AI가 수정한 코드는 항상 diff(변경 비교)를 보여줍니다. 초록색은 추가된 부분, 빨간색은 삭제된 부분입니다. 수락하기 전에 AI가 의도하지 않은 부분까지 수정하지 않았는지 확인하는 습관을 들이세요.

⚡ 한 번에 끝내기: VibeStart 활용

Git, Node.js, VS Code 등 개발 환경 설치가 아직 안 됐다면 VibeStart를 이용해보세요. 운영체제에 맞는 설치 명령어를 단계별로 안내합니다. 환경 설치를 끝낸 뒤 Cursor를 설치하면 바로 바이브코딩을 시작할 수 있습니다.

Cursor 설치 방법과 첫 프로젝트 만들기: Windows/macOS 완벽 가이드 (2026)