Cursor 사용법 초보 가이드
A to Z (2026 최신)
설치부터 첫 코드 완성까지 — 코딩 몰라도 따라할 수 있는 단계별 안내
📋 이 글에서 알 수 있는 것
- Cursor가 뭔지, 왜 비개발자도 쓸 수 있는지
- Windows / Mac 설치 방법과 첫 실행까지의 전 과정
- Chat · Composer · Agent 세 가지 모드의 차이와 언제 쓰는지
- 비개발자가 자주 막히는 포인트와 해결법
- 처음 써보는 사람을 위한 첫 프롬프트 실전 예시
Cursor란 무엇인가
Cursor는 AI가 내장된 코드 에디터입니다. 쉽게 말하면 "AI랑 같이 코딩하는 프로그램"인데, 핵심은 코드를 직접 짤 줄 몰라도 원하는 걸 말로 설명하면 AI가 코드를 대신 써준다는 점입니다.
2023년 Anysphere라는 회사가 출시했고, 업계에서 널리 쓰이는 VS Code(마이크로소프트의 무료 코드 에디터)를 기반으로 만들어졌습니다. 그래서 기존 VS Code 사용자라면 설치 직후 익숙한 화면이 반겨줍니다. 반대로 처음 보는 분도 생각보다 빠르게 익힐 수 있습니다.
⚡ Cursor가 다른 AI 툴과 다른 점
- 파일 단위 편집: 단순 대화가 아니라 실제 파일을 열고 수정까지 처리
- 컨텍스트 인식: 내 프로젝트 전체 구조를 AI가 파악하고 답변
- 멀티 모드: 대화(Chat) · 통합 편집(Composer) · 자율 실행(Agent) 세 가지 방식 지원
- Claude / GPT 모두 사용: Anthropic Claude, OpenAI GPT-4o 등 주요 모델 선택 가능
바이브코딩 완전 입문 가이드: Cursor vs Claude vs v0 vs Replit도 함께 읽어보세요.
설치 방법 (Windows / Mac)
Cursor 설치는 어렵지 않습니다. 공식 사이트에서 파일 하나 받아서 실행하면 끝입니다. 아래 단계를 순서대로 따라오세요.
공식 사이트 접속
cursor.com 에 접속합니다. 상단 "Download" 버튼을 클릭하면 현재 운영체제(Windows / Mac / Linux)에 맞는 설치 파일이 자동으로 감지됩니다.
설치 파일 실행
Windows는 .exe 파일, Mac은 .dmg 파일을 다운받아 실행합니다. 설치 과정은 일반 프로그램과 동일하게 "다음 → 동의 → 설치 완료" 흐름입니다.
계정 생성 또는 로그인
처음 실행하면 계정 만들기 화면이 나옵니다. 이메일 또는 구글 계정으로 가입할 수 있습니다. 이미 Cursor를 써봤다면 기존 계정으로 로그인합니다.
플랜 선택
무료 플랜(Hobby)으로 시작할 수 있습니다. 월 2,000 회 정도의 AI 자동완성과 일부 고급 모델 사용이 제한되는 대신 처음 써보는 데는 충분합니다. 유료(Pro)는 월 $20 수준입니다(작성 시점 기준, 변동 가능).
설치 파일 실행 시 "개발자를 확인할 수 없습니다" 경고가 뜰 수 있습니다. 시스템 환경설정 → 개인 정보 보호 및 보안 → "그래도 열기"를 선택하면 정상 실행됩니다.
처음 실행 후 기본 설정
로그인을 마치면 Cursor의 메인 화면이 열립니다. VS Code를 한 번도 본 적 없다면 처음엔 좀 생소할 수 있는데, 비개발자 입장에서 꼭 알아야 할 설정 두 가지만 짚고 넘어가겠습니다.
AI 모델 선택
우측 상단 또는 설정(⚙️) → Models에서 사용할 AI 모델을 고를 수 있습니다. 무료 플랜은 claude-3.5-sonnet, gpt-4o 등 주요 모델을 제한된 횟수로 사용할 수 있습니다. 익숙해지기 전에는 기본값 그대로 두어도 됩니다.
작업 폴더(프로젝트) 열기
File → Open Folder로 작업할 폴더를 지정합니다. 아직 만든 파일이 없다면 바탕화면에 새 폴더를 하나 만들고 그걸 열어도 됩니다. Cursor는 이 폴더 전체를 하나의 프로젝트로 인식해 AI에게 컨텍스트를 제공합니다.
Cursor는 기본적으로 영어 인터페이스입니다. Extensions(확장 마켓)에서 "Korean Language Pack"을 설치하면 메뉴를 한국어로 바꿀 수 있습니다. 단, AI와의 대화는 한국어로 입력해도 한국어로 잘 답해줍니다.
Chat · Composer · Agent 모드 차이
Cursor를 처음 써보면 가장 헷갈리는 게 이 세 가지 모드입니다. 각각 언제, 어떻게 쓰는지만 알면 절반은 넘어간 겁니다.
💬 대화 모드
AI와 채팅하듯 질문하고 답변을 받는 방식입니다. 코드 설명, 개념 질문, 아이디어 논의 등 "직접 파일을 수정하지 않아도 되는" 상황에 씁니다.
✍️ 통합 편집 모드
현재 열려 있는 파일 또는 여러 파일을 AI가 직접 수정합니다. "이 파일에서 버튼 색을 파란색으로 바꿔줘" 같은 실제 편집 요청에 최적입니다.
🤖 자율 실행 모드
AI가 스스로 파일을 만들고, 코드를 실행하고, 필요한 패키지까지 설치하는 자율 에이전트입니다. "간단한 할 일 앱 만들어줘" 같은 큰 작업 단위에 사용합니다.
Agent는 강력하지만 한 번의 실행으로 파일을 많이 바꾸기 때문에 결과를 예측하기 어려울 수 있습니다. 먼저 Chat으로 질문하고, Composer로 한 파일씩 수정하는 것에 익숙해진 뒤 Agent로 넘어가는 걸 권장합니다.
| 구분 | Chat | Composer | Agent |
|---|---|---|---|
| 주요 용도 | 질문·설명 | 파일 편집 | 자율 작업 |
| 파일 직접 수정 | ❌ | ✅ | ✅✅ |
| 초보자 추천도 | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| 한 번에 처리 범위 | 대화 한 번 | 파일 몇 개 | 프로젝트 전체 |
첫 프롬프트 입력 실전
이론은 이 정도면 충분합니다. 실제로 Cursor에서 AI에게 무언가를 시켜보겠습니다. 여기선 가장 간단한 예시인 "HTML 파일 만들기"로 해보겠습니다.
새 파일 만들기
왼쪽 파일 탐색기에서 마우스 오른쪽 클릭 → New File → 파일 이름을 index.html로 입력합니다.
Composer 열기
Ctrl + I (Mac: Cmd + I)를 눌러 Composer 창을 엽니다. 화면 하단 또는 우측에 입력창이 나타납니다.
프롬프트 입력
아래 예시 문장을 그대로 붙여넣고 Enter를 눌러보세요.
📝 첫 프롬프트 예시
"간단한 자기소개 웹페이지를 만들어줘.
이름은 '김바이브', 직업은 '프리랜서 디자이너'야.
배경색은 흰색, 글씨색은 진한 남색으로 하고,
가운데 정렬에 이름 크게, 직업 작게 나오게 해줘."
→ AI가 index.html 파일에 코드를 직접 작성해줍니다. "Accept" 버튼을 누르면 파일에 반영됩니다.
결과 확인하기
파일 탐색기에서 index.html을 우클릭 → "Open with Live Server" (Live Server 확장 설치 시) 또는 파일을 브라우저에 직접 드래그하면 결과를 바로 볼 수 있습니다.
수정 요청하기
마음에 들지 않는 부분이 있다면 Composer에 "글씨 색을 더 밝은 파란색으로 바꿔줘" 식으로 추가 요청을 이어가면 됩니다. 대화를 이어가듯 작업을 계속 다듬을 수 있습니다.
"더 이쁘게 해줘"보다 "배경을 연한 하늘색으로, 폰트를 더 크게, 버튼에 둥근 모서리를 넣어줘"처럼 구체적으로 말할수록 원하는 결과가 나옵니다. 막연한 요청은 AI도 막연하게 답합니다.
비개발자가 자주 막히는 포인트
Cursor를 처음 써보는 비개발자가 공통으로 마주치는 상황들입니다. 미리 알아두면 당황하지 않습니다.
"AI가 코드를 써줬는데 어디에 붙여야 할지 모르겠어요"
→ Chat이 아닌 Composer 모드로 요청하면 AI가 직접 파일에 넣어줍니다. Chat 답변의 코드를 수동으로 복사·붙여넣기할 필요가 없어집니다.
"오류가 났는데 무슨 말인지 모르겠어요"
→ 터미널에 뜬 빨간 오류 메시지를 그대로 복사해서 Chat에 붙여넣으세요. "이 오류가 왜 나는 건지, 어떻게 고치면 되는지 알려줘"라고 하면 AI가 해설해줍니다.
"Agent가 막 파일을 바꿔버려서 원래대로 돌리고 싶어요"
→ Cursor는 Git 기반의 변경 내역을 자동 추적합니다. 좌측 소스 컨트롤 아이콘(분기 아이콘)에서 "Discard Changes"로 되돌릴 수 있습니다. 큰 작업 전에는 파일을 별도로 백업해두는 습관을 들이세요.
"무료 한도가 금방 차서 더 쓸 수가 없어요"
→ 무료 플랜은 고급 모델(GPT-4o, Claude 3.5 Sonnet) 사용에 월 한도가 있습니다. 한도 초과 시 자동으로 더 가벼운 모델로 전환되거나 Pro 업그레이드를 요청받습니다. 적극적으로 쓸 계획이라면 Pro($20/월)를 고려해보세요.
자주 묻는 질문
Cursor는 완전 무료로 쓸 수 있나요?
무료 플랜(Hobby)이 있어서 기본 기능은 무료로 사용할 수 있습니다. 다만 GPT-4o·Claude 같은 고급 모델의 사용 횟수에 월 한도가 있습니다. 가볍게 입문하는 데는 무료 플랜으로 충분하고, 본격적으로 쓸 계획이라면 Pro(월 $20 수준, 작성 시점 기준)를 고려해볼 수 있습니다.
한국어로 프롬프트를 써도 되나요?
네, 한국어로 요청해도 한국어로 잘 답해줍니다. 다만 코드 안의 주석·변수명 등은 영어로 나오는 게 일반적입니다. "주석은 한국어로 써줘"라고 추가 요청하면 한국어 주석도 넣어줍니다.
코딩을 전혀 몰라도 괜찮을까요?
간단한 결과물(웹페이지, 간단한 자동화 스크립트 등)은 코딩 지식 없이도 충분히 만들 수 있습니다. 다만 복잡한 앱이나 서비스를 만들려면 AI가 생성한 코드를 어느 정도 이해할 수 있어야 문제가 생겼을 때 대처하기 편합니다. 처음엔 간단한 것부터 시작해서 점점 복잡도를 올려가는 방식을 추천합니다.
Windsurf나 다른 툴이랑 비교해서 Cursor가 더 나은가요?
어떤 툴이 "더 낫다"고 단정하기는 어렵습니다. Cursor는 레퍼런스가 많고 커뮤니티가 크다는 장점이 있고, Windsurf는 Cascade라는 컨텍스트 인식 기능으로 차별화를 꾀하고 있습니다. 두 툴 모두 무료로 시작할 수 있으니, 둘 다 써보고 자신에게 더 잘 맞는 걸 고르는 게 가장 현실적인 방법입니다.
Claude Code와 Cursor는 어떻게 다른가요?
가장 큰 차이는 인터페이스입니다. Cursor는 그래픽 에디터(GUI) 기반이라 일반 프로그램처럼 마우스로 조작합니다. 반면 Claude Code는 터미널(명령줄) 기반 CLI 도구로, 명령어를 직접 입력하는 방식이라 비개발자에게는 진입 장벽이 좀 더 높습니다. 처음 시작한다면 Cursor를 먼저 써보는 걸 권장합니다.
Cursor는 "코딩을 배운다"는 부담 없이 AI와 협업해서 결과물을 만드는 도구입니다.
처음엔 Chat으로 질문하고, Composer로 파일을 고치는 것부터 시작해보세요.
한 번 사이클을 경험하고 나면 생각보다 빠르게 손에 익습니다.
VibeLab이었습니다.