Cursor: 초보자를 위한 완벽한 튜토리얼 (2026)

Cursor는 인공지능을 직접 통합한 코드 에디터예요. 외부 AI 어시스턴트와 달리 Cursor는 너의 전체 프로젝트를 이해하고 타이핑하면서 맥락에 맞는 코드를 제안해줘. 프로그래밍을 시작하는 입장에서 보면, 이 도구 덕분에 수백 가지 문법을 외우지 않고도 작동하는 코드를 작성할 수 있어. 이 튜토리얼에서는 Cursor를 설치하고, 첫 번째 설정을 하고, 핵심 기능을 사용하는 방법을 알려줄 거야. 자주 하는 실수와 시간을 절약하는 팁도 배울 수 있어. 이 가이드를 따라가기 위해 미리 경험이 필요하지 않아.

Cursor가 뭐고 초보자가 왜 써야 할까?

Cursor는 Visual Studio Code 기반의 코드 에디터인데, GPT-4나 Claude 같은 AI 모델을 실시간으로 탑재하고 있어. 실제로는 자연스러운 말로 문장을 쓰면 Cursor가 해당하는 코드를 만들어주고, 한 번의 클릭으로 받아들이거나 수정할 수 있어.

일반 에디터와의 차이점이 뭘까? Cursor는 너의 프로젝트 전체(파일, 폴더, 의존성)를 읽어서 이미 작성한 코드와 일관성 있는 코드를 제안해줘. 한 파일에서 함수를 만들면, Cursor는 다른 파일에서 자동으로 그 함수를 사용할 수 있게 해줘. 너가 다시 복사할 필요가 없어.

초보자에게 왜 유용할까:

• 문법 외울 필요 없음: 원하는 걸 한국말로 설명하면 Cursor가 코드로 번역해줘
• 예제로 배우기: 함수, 반복문, 조건문을 어떻게 구조화하는지 바로 볼 수 있어
• 즉시 오류 수정: 코드를 테스트하기도 전에 Cursor가 오류를 찾아줘
• 시간 절약: Stack Overflow에서 헤매는 시간을 줄이고 프로젝트 만드는 데 집중할 수 있어

Cursor 공식 문서에 따르면, 이 도구는 최대 50,000줄의 코드를 맥락으로 분석할 수 있어. 초보자 입장에서는 프로젝트가 커져도 Cursor가 계속 도움이 된다는 뜻이야.

Cursor 설치하고 설정하는 방법

Cursor 설치는 5분도 안 걸리고 기술적 지식이 전혀 필요 없어. Windows, macOS, Linux 모두 정확한 단계를 알려줄게.

Cursor 다운로드하기

1. cursor.sh로 가
2. "Download" 버튼을 눌러 (사이트가 자동으로 너의 운영체제를 감지해)
3. 다운로드된 파일을 실행해 (Windows는 .exe, macOS는 .dmg, Linux는 .AppImage)
4. 설치 마법사를 따라가 ("다음"을 계속 누르면 돼)

첫 실행과 초기 설정

처음 열면 Cursor가 세 가지를 물어봐:

• 계정 연결: Google, GitHub 계정으로 로그인하거나 이메일로 계정을 만들 수 있어
• AI 모델 선택: 다양한 기능을 원하면 GPT-4를 선택하고, 복잡한 코드를 다루면 Claude Sonnet을 선택해 (둘 다 제한된 버전은 무료야)
• VS Code 설정 가져오기: 이미 Visual Studio Code를 써봤다면 Cursor가 너의 확장 프로그램과 단축키를 가져올 수 있어

로그인하면 메인 화면이 나타나. Visual Studio Code처럼 생겼어: 왼쪽에 파일 탐색 바, 중앙에 코드 에디터, 아래에 터미널이 있어.

필수 설정 조정하기

Ctrl + , (Windows/Linux) 또는 Cmd + , (macOS)를 눌러서 설정을 열어. 우선 이 세 가지를 바꿔:

• 자동 완성: "Cursor Tab"을 켜서 타이핑하면서 AI가 코드를 제안하게 해
• 기본 모델: GPT-4 Turbo (속도와 품질의 좋은 균형) 또는 Claude 3.5 Sonnet (맥락 이해가 더 좋음)을 선택해
• Privacy Mode: 기밀 프로젝트를 다룬다면 코드가 Cursor 서버로 전송되지 않게 비활성화해 (Pro 버전에서 가능)

더 자세한 설치 가이드가 필요하면 Windows에서 Claude Code 설치하기 튜토리얼을 확인해봐.

Cursor 초보자를 위한 5가지 핵심 기능

Cursor는 AI와 상호작용하는 4가지 모드를 제공하는데, 각각 다른 목적에 맞춰져 있어. 실제로 어떻게 쓰는지 알려줄게.

1. Cursor Tab: 똑똑한 자동 완성

Cursor Tab은 휴대폰의 자동 완성처럼 작동하는데, 코드용이야. 타이핑을 시작하면 Cursor가 다음 부분을 회색으로 제안해줘. Tab을 눌러서 받아들이면 돼.

예시: function calculer라고 타이핑하면 Cursor가 자동으로 이렇게 제안해:

function calculerMoyenne(notes) {
  const somme = notes.reduce((a, b) => a + b, 0);
  return somme / notes.length;
}

함수가 뭘 하는지 설명할 필요도 없어. 함수 이름만 봐도 Cursor가 알아차려.

2. Cmd K: 기존 코드 수정하기

코드 일부를 선택하고 Cmd + K (macOS) 또는 Ctrl + K (Windows/Linux)를 누른 다음, 뭘 바꾸고 싶은지 설명해.

예시: 세금 포함 가격을 계산하는 함수가 있는데 10% 할인을 추가하고 싶어. 함수를 선택하고 "10% 할인 추가해"라고 입력하면 Cursor가 코드를 직접 수정해줘.

3. Cmd L: 맥락 있는 채팅

Cmd + L (macOS) 또는 Ctrl + L (Windows/Linux)을 눌러서 화면 오른쪽에 채팅창을 열어. 코드에 대해 질문하거나 설명을 요청하거나 새로운 기능을 만들 수 있어.

ChatGPT와의 차이점? Cursor는 너의 모든 파일에 접근할 수 있어. "데이터베이스를 어떻게 연결해?"라고 물으면 Cursor가 너가 PostgreSQL을 쓴다는 걸 보고 맞춤형 답변을 줘. 일반적인 답변이 아니라.

4. Cmd I: 처음부터 코드 만들기

Cmd + I (macOS) 또는 Ctrl + I (Windows/Linux)을 눌러서 떠있는 에디터를 열어. 한국말로 뭘 만들고 싶은지 설명하면 Cursor가 완전한 코드를 만들어줘.

예시: "이름, 이메일, 메시지 필드가 있는 연락처 양식 만들어"라고 하면 Cursor가 필요한 HTML, CSS, JavaScript를 모두 만들어줘.

5. Composer 모드: 여러 파일 한 번에 만들기

Composer 모드 (Cmd + Shift + I 또는 Ctrl + Shift + I)는 여러 파일에 걸친 완전한 기능을 한 번에 만들 수 있게 해줘.

예시: "회원가입, 로그인, 로그아웃 기능이 있는 인증 시스템 만들어"라고 하면 Cursor가 백엔드 라우트, 프론트엔드 양식, 세션 관리를 모두 만들어줘.

이런 기능들은 Claude Code 필수 명령어 글에서 더 자세히 설명했는데, 비슷한 논리를 따르고 있어.

Cursor로 첫 번째 실제 프로젝트 만들기

Cursor를 배우는 가장 좋은 방법은 30분 안에 작동하는 미니 프로젝트를 만드는 거야. 예시로 할 일 목록(to-do list)을 단계별로 만들어볼게.

1단계: 새 프로젝트 만들기

1. Cursor를 열어
2. "File" > "Open Folder" 클릭
3. 바탕화면에 새 폴더를 만들어 ("my-todo-list"라고 이름 지어)
4. 그 폴더를 선택해

2단계: 기본 구조 만들기

Cmd + I (또는 Ctrl + I)를 누르고 이렇게 입력해:

"HTML, CSS, JavaScript로 할 일 목록을 만들어. 사용자가 할 일을 추가하고, 완료로 표시하고, 삭제할 수 있어야 해."

Cursor가 세 개의 파일을 만들어: index.html, style.css, script.js. "Accept"를 클릭해서 만들어.

3단계: 프로젝트 테스트하기

1. 왼쪽 바에서 index.html을 오른쪽 클릭해
2. "Open with Live Server" 선택해 (확장 프로그램이 없으면 Cursor가 자동으로 설치해줄 거야)
3. 브라우저가 열리고 작동하는 할 일 목록이 보여

4단계: 기능 추가하기

브라우저를 닫아도 할 일이 남아있게 하고 싶어? script.js의 모든 내용을 선택하고 Cmd + K를 누른 다음:

"할 일을 브라우저의 localStorage에 저장해"

Cursor가 코드를 수정해서 이 기능을 추가해줄 거야. 페이지를 새로고침하고, 할 일을 추가하고, 브라우저를 닫고, 다시 열어봐. 할 일이 그대로 있을 거야.

5단계: 생성된 코드 이해하기

이해 안 가는 코드 줄을 선택하고 Cmd + L을 누른 다음: "이 줄을 10살 아이도 이해하게 설명해줘".

Cursor가 기술 용어 없이 한국말로 쉽게 설명해줄 거야.

이런 프로젝트 중심의 접근법이 Skilzy의 핵심 방식이야. 우리 방법론에서 더 알아볼 수 있어.

Cursor 사용할 때 자주 하는 실수와 피하는 법

AI가 있어도 학습을 방해하는 함정에 빠질 수 있어. 가장 흔한 5가지 실수와 해결책을 알려줄게.

실수 1: 코드를 읽지 않고 다 받아들이기

Cursor가 빠르게 코드를 만들어주니까 생각 없이 "Accept"를 누르기 쉬워. 근데 코드가 뭘 하는지 모르면 나중에 고장 났을 때 고칠 수 없어.

해결책: 생성된 모든 줄을 읽어. 이해 안 가는 부분을 선택하고 Cmd + L로 설명을 요청해.

실수 2: 너무 막연한 지시 주기

"웹사이트 만들어"는 부족해. Cursor는 맥락이 필요해: 어떤 종류의 사이트? 몇 페이지? 어떤 기능?

해결책: 구체적으로 써. "양식 만들어" 대신 "이름, 이메일, 메시지 필드가 있는 연락처 양식을 만들어. 제출 버튼을 누르면 확인 알림이 나타나야 해"라고 써.

실수 3: 의존성 확인 안 하기

Cursor가 React나 Tailwind CSS 같은 외부 라이브러리가 필요한 코드를 만들 수 있는데, 너한테 미리 알려주지 않을 수도 있어.

해결책: 코드를 만든 후에 터미널을 열어 (Ctrl + `) Cursor가 package.json 파일을 만들었는지 확인해. 있으면 npm install을 입력해서 의존성을 설치해.

실수 4: 자동 저장 안 하기

Cursor가 수정할 때마다 자동으로 저장하지 않아.

해결책: 설정에서 자동 저장을 켜 (Ctrl + ,를 누르고 "Auto Save"를 찾아서 "afterDelay" 선택).

실수 5: 버전 관리 안 하기

Cursor가 뭔가 잘못 만들어서 모든 게 깨져도 되돌릴 방법이 없어. Git이 없으면 말이야.

해결책: 프로젝트 시작할 때 Git을 초기화해. 터미널을 열고 git init을 입력한 다음 git add .와 git commit -m "첫 번째 커밋"을 입력해. 기능을 완성할 때마다 커밋해.

Cursor로 시간 절약하는 고급 팁

기초를 익히고 나면 이 기법들로 코딩 속도를 2배로 높일 수 있어. 실제로 쓸 수 있는 5가지 팁을 알려줄게.

개인 규칙 사용하기 (.cursorrules)

프로젝트 루트에 .cursorrules 파일을 만들어서 Cursor에게 영구적인 지시를 줄 수 있어.

파일 내용 예시:

- 항상 한국말로 변수 이름을 지어
- 모든 함수에 한 줄 설명을 달아
- 일반 함수보다 화살표 함수를 선호해

Cursor가 코드를 만들 때마다 이 규칙을 적용할 거야.

개인 스니펫 만들기

스니펫은 자주 쓰는 코드 조각이야. Cmd + Shift + P (또는 Ctrl + Shift + P)를 누르고 "Snippets: Configure User Snippets"를 입력해서 자주 쓰는 코드를 위한 스니펫을 만들어.

예시: 이메일 검증 함수를 위한 스니펫.

채팅에서 @멘션 사용하기

채팅 (Cmd + L)에서 @파일이름으로 특정 파일을 언급할 수 있어. Cursor가 그 파일에만 집중해서 답변할 거야.

예시: "@script.js 이 반복문을 어떻게 최적화할 수 있어?"

"Apply" 자동 모드 켜기

설정에서 "Auto-apply suggestions"를 켜면 Cursor가 매번 확인을 요청하지 않고 바로 수정을 적용해.

주의: Cursor에 익숙해진 후에만 이 옵션을 켜. 아니면 이해 못 하는 코드를 받아들일 수도 있어.

Cursor와 Claude Code 함께 쓰기

반복적인 작업(파일 이름 바꾸기, 테스트 만들기 등)을 자동화하고 싶으면 Claude Code를 Cursor와 함께 써봐. 두 도구가 잘 어울려.

Cursor 무료 vs Cursor Pro: 뭐가 달라?

Cursor 무료 버전은 한 달에 GPT-4 요청 50개와 하루 자동 완성 200개를 줘. 초보자가 시작하기에는 충분해. 근데 Cursor Pro (월 20달러)를 쓰면 뭐가 달라질까:

기능	무료	Pro
GPT-4 요청	50/월	무제한
자동 완성	200/일	무제한
Privacy Mode	없음	있음
Claude 모델	제한됨	전체 접근
우선 지원	없음	있음

우리 추천: 무료 버전부터 시작해. 하루에 2시간 이상 코딩하고 한계에 도달하면 Pro로 업그레이드해. 아니면 무료로 계속 써도 괜찮아.

AI 학습을 더 깊이 있게 하고 싶으면 초보자를 위한 AI 배우기: 어디서 시작할까? 가이드를 확인해봐.

마무리

Cursor는 첫 날부터 작동하는 프로젝트를 만들 수 있게 해줘서 코드 배우기를 완전히 바꿔놨어. 설치는 5분, 핵심 기능은 1시간이면 배우고, 첫 프로젝트는 30분이면 만들 수 있어. 간단한 미니 프로젝트(할 일 목록, 계산기, 양식)부터 시작해. Cmd + L로 모든 질문을 해. 생성된 모든 코드 줄을 읽어서 이해해. 무료 버전으로 충분하고, 나중에 정기적으로 코딩하면 Pro로 업그레이드할 수 있어. 가장 중요한 건 매일 연습하는 거야. 15분이라도 좋아.

Skilzy의 모든 프로그램을 확인해서 실제 프로젝트로 코딩을 배워봐.