Cursor 설치 방법을 찾고 계신가요? Cursor는 AI가 내장된 코드 에디터로, 바이브코딩의 핵심 도구입니다. 이 글에서는 Windows와 macOS에서 Cursor를 설치하고, AI와 대화하며 첫 프로젝트를 만드는 과정까지 단계별로 안내합니다.
• AI로 코딩을 시작하고 싶은데 어떤 도구를 쓸지 모르는 분
• VS Code는 써봤는데 AI 기능이 내장된 에디터가 궁금한 분
• “Cursor 설치하세요”라는 안내를 보고 방법을 찾는 분
📖 목차
🚀 Cursor란 무엇이고 바이브코딩에 왜 쓰는가
Cursor는 VS Code 기반의 AI 코드 에디터입니다. 에디터 안에서 AI에게 직접 코딩을 요청할 수 있기 때문에 ChatGPT 창과 에디터를 오가는 번거로움이 없습니다. VS Code와 인터페이스가 거의 동일해서, VS Code 사용 경험이 있다면 별도 학습 없이 바로 사용할 수 있습니다.
바이브코딩에서 Cursor가 인기 있는 이유는 명확합니다. 코드를 선택하고 AI에게 수정을 요청하면 바로 그 자리에서 코드가 변경됩니다. 별도 복사-붙여넣기 과정이 필요 없어서 작업 흐름이 끊기지 않습니다. 처음 코딩을 시작하는 분이라도 AI에게 “로그인 폼 만들어줘”라고 말하면 바로 결과물을 받을 수 있습니다.
📋 설치 전 확인 사항
Cursor를 설치하기 전에 몇 가지를 확인해야 합니다. 시스템 요구 사항을 만족하지 않으면 설치 후 정상 동작하지 않을 수 있기 때문입니다.
💻 시스템 요구 사항
| 항목 | Windows | macOS |
|---|---|---|
| OS 버전 | Windows 10 이상 | macOS 12 (Monterey) 이상 |
| RAM | 8GB 이상 권장 | 8GB 이상 권장 |
| 디스크 공간 | 약 500MB | 약 500MB |
| 인터넷 | 설치 및 AI 기능에 필요 | 설치 및 AI 기능에 필요 |
📌 Node.js와 Git은 미리 설치하세요
Cursor 자체는 Node.js 없이도 실행됩니다. 하지만 바이브코딩으로 웹 프로젝트를 만들려면 Node.js와 Git이 필요합니다. 터미널에서 git --version과 node --version을 입력했을 때 버전 번호가 나오면 준비 완료입니다. 아직이라면 아래 가이드를 먼저 진행하세요.
📥 Cursor 다운로드 및 설치 (Windows/macOS)
🪟 Windows 설치 순서
Windows에서 Cursor를 설치하는 과정은 일반 프로그램 설치와 동일합니다.
- 브라우저에서 cursor.com에 접속합니다.
- 메인 화면의 “Download” 버튼을 클릭하면 Windows용
.exe파일이 자동으로 다운로드됩니다. - 다운로드된
.exe파일을 더블 클릭해 실행합니다. - 설치 마법사가 열리면 “다음”을 클릭하며 진행합니다. 설치 경로는 기본값 그대로 두는 것이 안전합니다.
- 설치가 완료되면 Cursor가 자동으로 실행됩니다.
SmartScreen 경고가 뜨면 “추가 정보” → “실행”을 클릭하세요. Cursor는 공식 사이트에서 배포하는 서명된 설치 파일이므로 안전합니다.
🍎 macOS 설치 순서
- cursor.com에 접속합니다.
- “Download” 버튼을 클릭하면
.dmg파일이 다운로드됩니다. - 다운로드된
.dmg파일을 더블 클릭합니다. - Cursor 아이콘을 Applications 폴더로 드래그합니다.
- Applications 폴더에서 Cursor를 더블 클릭해 실행합니다.
“인터넷에서 다운로드한 앱입니다” 보안 경고가 나오면 “열기”를 클릭하면 됩니다. Apple Silicon(M1/M2/M3/M4) Mac이라면 별도 설정 없이 네이티브로 동작합니다.
🔧 첫 실행과 초기 설정
Cursor를 처음 실행하면 몇 가지 초기 설정 화면이 나타납니다. 이 과정은 5분 이내로 끝납니다.
🎨 테마 선택
다크 테마 또는 라이트 테마 중 하나를 선택합니다. 코딩 작업에는 다크 테마가 눈의 피로를 줄여주지만, 취향에 따라 선택하면 됩니다. 나중에 설정에서 언제든 변경 가능합니다.
📦 VS Code 설정 가져오기
이전에 VS Code를 사용했다면 “Import VS Code Settings” 옵션을 선택하세요. 확장 프로그램, 사용자 설정, 단축키가 자동으로 가져와집니다. VS Code를 사용한 적 없다면 이 단계를 건너뛰면 됩니다.
🔑 계정 생성 및 로그인
Cursor의 AI 기능을 사용하려면 계정이 필요합니다. 이메일, Google, 또는 GitHub 계정으로 가입할 수 있습니다. 무료 플랜(Hobby)으로 시작하면 한 달에 자동완성 2,000회와 느린 프리미엄 요청 50회를 사용할 수 있습니다. 에디터 오른쪽 상단에 프로필 아이콘이 보이면 로그인이 정상적으로 완료된 것입니다.
⌨️ 키바인딩 선택
VS Code 스타일이 기본으로 선택됩니다. VS Code에 익숙하다면 그대로 두세요. Vim이나 Emacs 같은 다른 에디터에 익숙한 분은 해당 옵션을 선택할 수 있습니다.
🤖 Cursor의 AI 기능 3가지
Cursor가 일반 코드 에디터와 다른 점은 세 가지 AI 기능에 있습니다. 각 기능이 어떤 상황에서 유용한지 알아두면 바이브코딩 효율이 크게 올라갑니다.
💬 Chat — AI와 대화하며 코딩하기
Ctrl+L (macOS: Cmd+L)을 누르면 오른쪽에 채팅 패널이 열립니다. 여기서 코드 작성, 설명, 수정 등을 자유롭게 요청할 수 있습니다.
| 요청 예시 | 설명 |
|---|---|
| “이 파일의 코드를 설명해줘” | 현재 열린 파일의 코드 분석 |
| “로그인 폼 컴포넌트 만들어줘” | 새 코드 생성 요청 |
| “이 에러 어떻게 고쳐?” | 에러 해결 방법 제안 |
채팅에서
@파일이름을 입력하면 AI가 해당 파일을 참고해서 답변합니다. 여러 파일을 동시에 참조할 수도 있어서 프로젝트 맥락을 AI에게 정확히 전달할 수 있습니다.
✏️ Inline Edit — 코드를 선택하고 바로 수정
코드의 특정 부분을 드래그해 선택한 뒤 Ctrl+K (macOS: Cmd+K)를 누르면 인라인 편집 창이 열립니다. “이 함수를 TypeScript로 변환해줘”처럼 요청하면 AI가 그 자리에서 코드를 수정합니다. 변경 사항은 diff(차이 비교) 형태로 보여주기 때문에 수락 전에 무엇이 바뀌는지 확인할 수 있습니다.
🔮 Tab 자동완성 — 코딩하는 도중에 AI가 제안
코드를 작성하는 중에 AI가 다음에 올 코드를 자동으로 예측합니다. Tab을 누르면 제안을 수락하고, Esc를 누르면 무시합니다. 함수 이름만 입력해도 본문 전체를 제안하는 경우가 많아서 반복 작업이 크게 줄어듭니다.
📁 첫 프로젝트 만들기 — AI와 함께
설치와 설정이 끝났으니 실제로 프로젝트를 만들어보겠습니다. 아래 과정을 따라가면 5분 안에 웹 페이지가 뜨는 것을 확인할 수 있습니다.
📌 프로젝트 폴더 만들기
Cursor에서 터미널을 열고(Ctrl+`) 프로젝트를 만들 위치로 이동합니다.
# Windows
cd C:\Users\사용자이름\Documents
mkdir my-first-project
cd my-first-project
# 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가 추천한 옵션대로 선택하면 됩니다. 패키지 설치가 끝나면 프로젝트 파일이 생성된 것을 확인할 수 있습니다.
📌 개발 서버 실행하기
npm run dev터미널에 http://localhost:3000 주소가 표시되면 성공입니다. 브라우저에서 이 주소를 열면 Next.js 기본 페이지가 보입니다. 여기까지 오면 Cursor 설치부터 프로젝트 생성까지 완료된 것입니다.
📌 AI에게 페이지 수정 요청해보기
개발 서버가 실행 중인 상태에서 app/page.tsx 파일을 열고, 채팅(Ctrl+L)에서 요청합니다.
이 페이지를 간단한 자기소개 페이지로 바꿔줘.
이름, 한 줄 소개, 좋아하는 것 3가지를 표시해줘.AI가 코드를 수정해주면 브라우저에서 localhost:3000을 새로고침해보세요. 내가 요청한 대로 페이지가 바뀌어 있습니다. 이것이 바이브코딩의 기본 루프입니다 — AI에게 요청 → 코드 수정 → 결과 확인 → 다시 요청.
✅ 설치 확인 점검 목록
모든 과정이 정상적으로 됐는지 아래 항목을 하나씩 확인해보세요.
| 항목 | 확인 방법 | 정상 신호 |
|---|---|---|
| Cursor 설치 | Cursor 앱 실행 | 에디터 화면 열림 |
| 계정 로그인 | 오른쪽 상단 확인 | 프로필 아이콘 표시 |
| AI 채팅 | Ctrl+L 입력 | 채팅 패널 열리고 AI 응답 |
| 터미널 | Ctrl+` 입력 | 터미널 프롬프트 표시 |
| Node.js 연동 | 터미널에서 node --version |
v22.x.x 같은 버전 출력 |
| 프로젝트 생성 | npx create-next-app 실행 |
프로젝트 파일 생성됨 |
| 개발 서버 | npm run dev 실행 |
localhost:3000 접속 가능 |
⚠️ 자주 발생하는 문제와 해결
🚫 AI 기능이 동작하지 않을 때
로그인이 안 돼 있거나 무료 사용량이 소진됐을 가능성이 큽니다. 오른쪽 상단 프로필 아이콘을 클릭해서 로그인 상태와 잔여 사용량을 확인하세요. 회사나 학교 네트워크에서는 방화벽이 Cursor의 API 요청을 차단할 수 있으므로, 개인 네트워크로 전환해보면 해결되는 경우가 많습니다.
🚫 VS Code 설정을 가져올 수 없을 때
VS Code가 설치돼 있어야 설정을 가져올 수 있습니다. 설치돼 있는데도 안 되면 Cursor를 완전히 종료하고 다시 실행해보세요. “Import” 안내는 첫 실행 시에만 나타나며, 이후에는 Settings → General에서 수동으로 가져올 수 있습니다.
🚫 터미널에서 node 명령어가 인식되지 않을 때
Node.js가 설치되지 않았거나 시스템 PATH에 등록되지 않은 경우입니다. Node.js를 설치한 뒤 Cursor를 완전히 종료하고 다시 열어야 PATH가 반영됩니다. Windows라면 PowerShell을 관리자 권한으로 열어 node --version을 확인해보세요.
🚫 create-next-app 실행 중 에러가 나올 때
가장 흔한 원인은 Node.js 버전이 너무 낮거나, 네트워크 문제로 패키지 다운로드에 실패한 경우입니다. node --version으로 v18 이상인지 확인하고, 네트워크가 안정적인 환경에서 다시 시도하세요. 그래도 안 되면 npm cache clean --force 후 재시도합니다.
🆓 무료 플랜 vs 유료 플랜 비교
| 항목 | Hobby (무료) | Pro ($20/월) |
|---|---|---|
| 자동완성 | 2,000회/월 | 무제한 |
| 느린 프리미엄 요청 | 50회/월 | 무제한 (빠른 500회 포함) |
| 모델 선택 | 제한적 | GPT-4o, Claude Sonnet 등 |
바이브코딩 입문 단계에서는 무료 플랜으로 충분합니다. 요청 횟수가 부족하다고 느껴질 때 Pro 플랜을 고려하세요. 무료 사용량은 매달 초에 리셋됩니다.
💡 Cursor를 더 잘 쓰는 실전 팁
📌 프롬프트를 구체적으로 작성하기
“버튼 만들어줘”보다 “파란색 배경에 흰색 텍스트인 ‘제출’ 버튼을 만들어줘. 호버 시 배경이 진한 파란색으로 변하게 해줘”처럼 구체적으로 요청하면 원하는 결과를 훨씬 빠르게 얻을 수 있습니다. 색상, 크기, 위치, 동작까지 명시하면 AI의 추측이 줄어듭니다.
📌 diff를 반드시 확인하기
AI가 수정한 코드는 항상 diff(변경 비교)를 보여줍니다. 초록색은 추가된 부분, 빨간색은 삭제된 부분입니다. 수락하기 전에 AI가 의도하지 않은 곳까지 수정하지 않았는지 확인하는 습관을 들이세요. 이 습관 하나만으로도 많은 문제를 예방할 수 있습니다.
📌 에러 메시지를 그대로 AI에게 전달하기
에러가 발생하면 에러 메시지를 복사해서 채팅에 그대로 붙여넣으세요. “에러 났어요”보다 “이 에러가 나오는데 어떻게 고칠까?”가 훨씬 정확한 해결책을 받을 수 있습니다. 터미널의 빨간 글자 전체를 복사하는 것이 가장 좋습니다.
Cursor가 나에게 맞는지 확신이 안 서면, AI 코딩 도구 비교 (Copilot vs Cursor vs Claude)로 먼저 비교 해보는 게 좋아요.
⚠️ 면책 고지
여기까지 따라오셨다면 Cursor 설치부터 첫 프로젝트 생성, AI 활용까지 모두 완료한 것입니다. 읽어주셔서 감사합니다.
❓ FAQ
질문을 누르면 답변이 펼쳐집니다.
Q. Cursor는 VS Code와 완전히 같은 건가요?
Cursor는 VS Code를 기반(fork)으로 만들어졌습니다. 인터페이스와 확장 프로그램이 거의 동일하지만, AI 채팅, 인라인 편집, 자동완성 등 AI 전용 기능이 추가돼 있습니다. VS Code 확장 프로그램 대부분이 Cursor에서도 동작합니다.
Q. Cursor와 VS Code를 동시에 설치해도 되나요?
네, 문제없습니다. 두 프로그램은 별도로 설치되고 독립적으로 실행됩니다. 같은 프로젝트를 두 에디터에서 동시에 열 수도 있지만, 파일 충돌을 피하려면 한 번에 하나만 편집하는 것이 안전합니다.
Q. 무료 플랜 사용량이 다 쓰면 어떻게 되나요?
자동완성과 프리미엄 요청이 비활성화되지만, 에디터 자체는 계속 사용할 수 있습니다. 매달 초에 사용량이 리셋되므로 기다리거나, Pro 플랜으로 업그레이드하면 바로 사용 가능합니다.
Q. Cursor에서 한국어로 AI에게 요청해도 되나요?
네, 한국어로 요청하면 한국어로 답변합니다. 다만 코드 주석이나 변수명은 영어를 권장합니다. 프롬프트는 한국어, 코드는 영어가 가장 효율적인 조합입니다.
Q. Cursor는 인터넷 없이도 사용 가능한가요?
에디터 자체는 오프라인에서도 열리지만, AI 기능(채팅, 인라인 편집, 자동완성)은 서버 통신이 필요합니다. AI 기능 없이 일반 코드 에디터로만 사용하는 것은 가능합니다.
Q. Apple Silicon Mac에서 별도 설정이 필요한가요?
아닙니다. Cursor는 Apple Silicon(M1/M2/M3/M4)에서 네이티브로 동작합니다. 별도의 Rosetta 설정이나 추가 다운로드 없이 바로 사용할 수 있습니다.
Q. Cursor에서 Python 프로젝트도 만들 수 있나요?
네, Cursor는 VS Code 기반이므로 Python, Java, Go 등 모든 언어를 지원합니다. Python 확장을 설치하면 디버깅과 AI 지원을 함께 받을 수 있습니다.
Q. VS Code 확장 프로그램이 Cursor에서도 작동하나요?
대부분 작동합니다. VS Code Marketplace의 확장 프로그램을 Cursor에서 검색하고 설치할 수 있습니다. 간혹 호환되지 않는 확장이 있을 수 있지만 대다수는 정상 동작합니다.
Q. Cursor를 삭제하고 싶으면 어떻게 하나요?
Windows에서는 설정 → 앱 → Cursor 삭제, macOS에서는 Applications 폴더에서 Cursor를 휴지통으로 이동하면 됩니다. 설정 파일까지 완전히 제거하려면 사용자 폴더의 .cursor 디렉토리도 삭제하세요.
Q. Cursor 유료 플랜은 환불이 가능한가요?
Cursor 공식 사이트의 결제 정책을 확인하세요. 일반적으로 구독 취소는 즉시 가능하며, 결제 기간이 끝날 때까지 Pro 기능을 사용할 수 있습니다.
🔗 관련 글
- 바이브코딩 시작 전 개발환경 세팅 완벽 가이드
- 바이브코딩용 VS Code 설정 가이드
- Node.js 설치부터 바이브코딩 시작까지 3단계
- 터미널 처음 사용하는 비전공자를 위한 가이드
- 바이브코딩에 Git이 필요한 이유 + 5분 설치 가이드
📚 참고 자료
