Cursor AI 처음 시작하는 사람을 위한 실전 가이드

2026년 6월 26일 · AI 도구 · 10분 읽기

Cursor는 AI가 코드를 직접 작성하고 수정해주는 코드 에디터입니다. VS Code 기반이라 익숙한 인터페이스를 유지하면서 AI 기능이 추가된 형태입니다. 설치 후 처음 열면 뭐부터 해야 할지 막막한 경우가 많습니다. 이 글에서는 Cursor를 처음 시작할 때 알아야 할 것들을 실용적으로 정리합니다.

Cursor의 핵심 기능 3가지

Cursor에는 여러 기능이 있지만, 처음에 알아야 할 것은 세 가지입니다.

1. Tab 자동완성

코드를 작성하면 AI가 다음에 올 코드를 예측해서 회색으로 보여줍니다. 맞다 싶으면 Tab 키를 누르면 코드가 삽입됩니다. 처음에는 무시하다가도 쓰다 보면 없으면 불편할 정도로 편리한 기능입니다.

2. Cmd+K (인라인 편집)

코드 블록을 선택한 후 Cmd+K(윈도우는 Ctrl+K)를 누르면 해당 코드만 수정하도록 AI에게 지시할 수 있습니다. "이 함수를 async/await로 바꿔줘", "여기에 에러 처리 추가해줘" 같은 지시를 하면 AI가 그 부분만 고쳐줍니다.

3. Composer (Cmd+I)

가장 강력한 기능입니다. Cmd+I를 누르면 Composer가 열립니다. 여기서는 파일을 새로 만들거나, 여러 파일을 동시에 수정하거나, 기능 전체를 처음부터 만들도록 지시할 수 있습니다. 바이브 코딩의 핵심이 이 Composer입니다.

처음 설정할 때 해야 할 것

모델 선택

Cursor는 여러 AI 모델을 지원합니다. Settings → Models에서 선택할 수 있습니다.

• claude-3-5-sonnet: 코딩 작업에서 가장 좋은 성능을 보이는 경우가 많습니다
• GPT-4o: 빠른 응답이 필요할 때 유용합니다
• cursor-small: 빠르고 간단한 자동완성에 적합합니다

어떤 모델이 좋은지는 작업에 따라 다릅니다. 처음에는 기본값으로 써보고, 결과가 마음에 안 들면 다른 모델을 시도해보세요.

.cursorrules 파일 만들기

프로젝트 루트에 .cursorrules 파일을 만들면 AI가 항상 그 규칙에 따라 코드를 작성합니다. 예를 들어:

- TypeScript를 사용한다
- Next.js 14 App Router 기준으로 작성한다
- 컴포넌트는 함수형으로 작성한다
- CSS는 Tailwind를 사용한다
- 한국어로 주석을 작성한다

이 파일 하나로 AI가 매번 같은 방식으로 코드를 작성하게 됩니다. 프레임워크나 언어를 바꿨는데 AI가 계속 예전 방식으로 코드를 작성한다면 이 파일을 확인해보세요.

Composer를 효과적으로 사용하는 방법

구체적으로 요청하기

"로그인 기능 만들어줘"보다 "이메일과 비밀번호로 로그인하는 기능을 만들어줘. Supabase Auth를 사용하고, 로그인 성공하면 /dashboard로 이동해야 해. 에러가 나면 폼 아래에 한국어로 에러 메시지를 보여줘"처럼 구체적으로 요청할수록 원하는 결과가 나올 가능성이 높아집니다.

컨텍스트 파일 추가하기

Composer 입력창에서 @파일명을 입력하면 해당 파일을 컨텍스트로 추가할 수 있습니다. AI가 기존 코드 구조를 참고해서 일관성 있는 코드를 만들 수 있습니다. 예를 들어 "이미 만들어진 UserCard 컴포넌트(@components/UserCard.tsx)와 같은 스타일로 ProductCard 컴포넌트를 만들어줘"처럼 쓸 수 있습니다.

한 번에 너무 많이 요청하지 않기

한 번의 요청에 너무 많은 것을 담으면 AI가 중간 어딘가에서 실수를 하거나, 일부를 빠뜨리는 경우가 있습니다. 기능을 작은 단위로 나눠서 요청하고, 각 단계가 잘 동작하는지 확인한 후 다음 단계로 넘어가는 것이 안전합니다.

처음에 자주 하는 실수들

AI가 수정한 코드를 확인하지 않고 적용하기

Cursor가 코드를 수정할 때 변경 사항이 diff 형태로 보입니다. Accept 버튼을 누르기 전에 어떤 부분이 바뀌었는지 확인하세요. AI가 의도하지 않은 부분을 함께 수정하거나, 기존에 있던 중요한 코드를 삭제하는 경우도 있습니다.

에러가 나면 무조건 AI에게 던지기

에러가 나면 바로 Composer에 붙여넣고 싶어지지만, 먼저 에러 메시지를 직접 읽어보는 습관이 중요합니다. 에러 메시지 자체에 원인이 적혀있는 경우가 많습니다. AI에게 가져가기 전에 30초만 에러 메시지를 직접 읽어보세요.

긴 대화에서 컨텍스트가 오염되기

Composer에서 대화가 길어지면 AI가 앞에서 한 내용을 잘못 기억하거나, 모순된 답변을 하는 경우가 있습니다. 새로운 기능을 만들기 시작할 때는 새 Composer 채팅을 시작하는 것이 좋습니다.

무료 플랜으로 시작하기

Cursor는 무료 플랜으로도 시작할 수 있습니다. 다만 무료 플랜은 월 사용량 제한이 있습니다. 처음에는 무료로 시작해서 얼마나 쓰게 되는지 파악한 후, 필요에 따라 Pro 플랜으로 업그레이드하는 것을 권장합니다. 유료 플랜($20/월)은 더 많은 고성능 모델 사용량을 제공합니다.

Cursor로도 안 되는 순간

Cursor가 강력하지만, 모든 문제를 해결해주지는 않습니다. AI가 계속 같은 에러를 반복하거나, 코드가 점점 복잡해지면서 더 이상 개선이 안 되는 느낌이 든다면 멈추고 상황을 다시 파악하는 것이 필요합니다. 이럴 때는 지금까지 만든 코드의 구조를 먼저 정리한 후, 새로 접근하는 것이 더 빠를 수 있습니다.