지난달에 개발자 커뮤니티 슬랙에서 한 친구가 물어봤어요. “Cursor AI 쓰는데 왜 이렇게 느리고, 자꾸 엉뚱한 코드 뱉어요?” 화면 공유해서 보니까… 그냥 VSCode에서 확장 프로그램 깔듯이 기본 설정으로 쓰고 있더라고요. 솔직히 저도 처음엔 그랬습니다. 설치하고 3일은 그냥 탭 자동완성 도구로만 썼어요. 근데 제대로 세팅하고 나서 체감이 완전히 달라졌습니다. 이 글은 그 삽질의 결과물입니다.
- 🔧 Cursor AI가 뭔지, 왜 2026년 지금도 핫한지
- ⚡ 설치 직후 반드시 건드려야 할 핵심 설정 5가지
- 📊 GPT-4o vs Claude 3.5 Sonnet — Cursor 안에서 뭘 써야 하나
- 🚫 절대로 하지 말아야 할 실수 7가지
- 💡 실무에서 바로 쓰는 .cursorrules 템플릿 공개
- ❓ FAQ — 진짜로 많이 물어보는 것들만
Cursor AI가 뭔지, 그리고 2026년 왜 아직도 선택해야 하나
Cursor는 VSCode 포크 기반의 AI 네이티브 에디터입니다. 단순 자동완성이 아니라 코드베이스 전체를 컨텍스트로 인식하고, 대화하듯 코드를 수정할 수 있다는 게 핵심이에요. 2026년 현재 기준으로 경쟁자는 GitHub Copilot, Windsurf, Zed AI 등이 있지만, Cursor가 여전히 선택받는 이유는 세 가지입니다.
- @Codebase 인덱싱: 프로젝트 전체를 벡터 DB로 저장해서 “저 함수가 어디서 호출돼?” 같은 질문이 됩니다.
- 멀티모달 입력: 스크린샷이나 피그마 캡처를 붙여넣으면 그걸 보고 컴포넌트를 짜줍니다.
- 모델 선택 자유도: GPT-4o, Claude 3.5/3.7 Sonnet, Gemini 1.5 Pro를 상황에 따라 바꿔 쓸 수 있습니다.
2026년 기준 Pro 플랜 요금은 월 $20 (약 27,000원)이고, 팀 플랜은 사용자당 월 $40입니다. 무료 플랜도 있지만 월 2,000 회 요청 제한이 있어서 실무에선 한계가 빠르게 옵니다.
설치 직후 반드시 건드려야 할 핵심 설정 5가지
① Cursor Settings → Models → 기본 모델 변경
기본값이 GPT-4o로 되어 있는 경우가 많은데, 리팩토링이나 복잡한 로직 설계에는 claude-3-5-sonnet-20241022가 체감상 훨씬 낫습니다. 단순 자동완성은 GPT-4o Mini로 두면 속도가 빠르고 토큰 소모도 줄어요.
② .cursorrules 파일 프로젝트 루트에 배치
이게 없으면 Cursor는 아무 맥락 없이 일반적인 코드만 뱉습니다. 프로젝트마다 기술 스택, 코딩 컨벤션, 절대 하지 말아야 할 패턴을 명시해주면 완전히 달라져요.
# .cursorrules 예시
- 언어: TypeScript strict mode
- 프레임워크: Next.js 14 App Router
- 스타일: Tailwind CSS, shadcn/ui
- 절대 any 타입 사용 금지
- 컴포넌트는 반드시 named export
- API 호출은 항상 try-catch로 감쌀 것
③ Privacy Mode 활성화 (보안 중요 프로젝트)
Settings → Privacy → “Privacy Mode” ON. 이 설정을 켜면 코드가 Cursor 서버에 저장되거나 학습에 사용되지 않습니다. 금융, 의료, 사내 내부 프로젝트라면 이거 안 키면 보안팀한테 혼납니다.
④ Docs 인덱싱 추가
Chat 창에서 @Docs 메뉴 → 자주 쓰는 라이브러리 공식 문서 URL 추가. 예: Next.js 공식 문서, Prisma docs, Supabase docs. 이걸 해두면 “최신 App Router에서 서버 액션 어떻게 써?” 같은 질문에 환각 없이 정확하게 답합니다.
⑤ Composer vs Chat 용도 구분
Cmd+K(인라인 편집), Cmd+L(Chat), Cmd+Shift+I(Composer) 세 가지를 다르게 써야 합니다. 파일 1개 수정은 Cmd+K, 여러 파일에 걸친 기능 추가는 Composer. 이거 헷갈려서 Chat에다 “파일 20개 수정해줘” 하면 느리고 맥락 끊겨서 망합니다.
GPT-4o vs Claude 3.5 Sonnet — Cursor 안에서 실측 비교
| 항목 | GPT-4o | Claude 3.5 Sonnet | Gemini 1.5 Pro |
|---|---|---|---|
| 코드 생성 속도 | ⚡⚡⚡ 빠름 | ⚡⚡ 보통 | ⚡⚡⚡ 빠름 |
| 복잡한 리팩토링 | 보통 | ★★★★★ 최상 | 보통 |
| 긴 컨텍스트 유지 | 128K 토큰 | 200K 토큰 | 1M 토큰 |
| 한국어 지시문 이해 | ★★★★ | ★★★★★ | ★★★ |
| 환각(틀린 코드) 빈도 | 낮음 | 매우 낮음 | 중간 |
| 추천 사용 시나리오 | 빠른 스니펫, 탭완성 | 설계, 리팩토링, 코드리뷰 | 대규모 레거시 분석 |
실무에서 제가 쓰는 방식은 이렇습니다. 평소 자동완성은 GPT-4o Mini로 두고, Composer로 기능 개발할 때는 Claude 3.5 Sonnet으로 전환합니다. 속도 대비 코드 품질이 가장 균형 잡혀 있어요. 레거시 Django 프로젝트처럼 파일이 300개 넘어가는 분석은 Gemini 1.5 Pro가 맥락을 더 오래 유지합니다.
실무에서 바로 쓰는 .cursorrules 템플릿
국내외 시니어 개발자들이 GitHub에 공유하는 .cursorrules 레포(awesome-cursorrules 등)를 참고하되, 팀 스펙에 맞게 수정하는 게 핵심입니다. 아래는 Next.js + TypeScript + Prisma 스택 기준 실전 템플릿입니다.
You are an expert in TypeScript, Next.js 14 App Router, Prisma ORM, and Tailwind CSS.
Code Style:
- Use Korean comments for complex business logic
- Prefer functional components with explicit return types
- Use Zod for all input validation
- Database queries must always include error handling
Never:
- Use `any` or `unknown` without justification
- Write synchronous file I/O
- Create default exports for components
- Skip loading and error states in async components
이 파일 하나 잘 만들면 “왜 자꾸 다른 패턴으로 코드를 써?” 하는 불만이 90% 이상 사라집니다. 팀 단위라면 Git에 커밋해서 팀 전체가 공유하세요.
절대로 하지 말아야 할 실수 7가지
- 🚫 맥락 없이 “이거 고쳐줘”: 어느 파일의 어떤 함수인지, 왜 고쳐야 하는지를 항상 명시하세요. “src/app/api/user/route.ts의 POST 핸들러에서 Prisma 트랜잭션 빠진 거 추가해줘”가 정답.
- 🚫 Composer로 너무 큰 작업 한 번에 요청: “쇼핑몰 전체 만들어줘”는 안 됩니다. 기능 단위(장바구니 추가 로직, 결제 훅 분리 등)로 쪼개야 품질이 나옵니다.
- 🚫 .cursorrules 없이 협업: 팀원마다 다른 패턴의 코드가 나옵니다. 첫날 설정이 나중에 리뷰 시간을 아껴줍니다.
- 🚫 생성된 코드 그대로 커밋: Cursor가 뱉은 코드를 읽지도 않고 커밋하면 나중에 디버깅할 때 본인이 짠 코드인지 AI가 짠 코드인지도 모릅니다. 반드시 리뷰하세요.
- 🚫 Privacy Mode 없이 내부 시스템 개발: 사내 인사 시스템, 금융 데이터 관련 코드는 Privacy Mode 필수입니다.
- 🚫 오래된 모델 그대로 방치: Cursor는 모델 업데이트가 빠릅니다. 3개월에 한 번은 Settings → Models 들어가서 더 나은 버전 나왔는지 확인하세요.
- 🚫 에러 메시지 잘라서 붙여넣기: 스택 트레이스 전체를 복붙해야 합니다. “TypeError: Cannot read properties of undefined” 이것만 붙여넣으면 Cursor도 모릅니다. 어느 파일 몇 번째 줄인지까지 주세요.
실제 사례 — 1인 스타트업 CTO가 쓰는 방식
제가 아는 SaaS 창업자분은 Cursor + .cursorrules + Supabase 조합으로 혼자서 MVP를 6주 만에 출시했습니다. 그분이 공유한 팁 중 가장 인상적이었던 건 “기능 스펙 문서를 .md 파일로 프로젝트에 넣고 @파일명으로 참조한다”는 거예요.
예를 들어 spec-payment.md에 결제 플로우를 글로 써두고, Composer에서 @spec-payment.md 보고 Stripe 웹훅 핸들러 작성해줘라고 하면 스펙대로 코드가 나옵니다. Notion이나 Confluence에 있는 내용을 Markdown으로 프로젝트에 떨궈두는 습관 하나로 AI 활용도가 2배 이상 올라간다고 했어요.
해외 레퍼런스로는 Vercel의 공식 블로그와 Cursor 공식 Discord가 가장 빠르게 최신 팁이 올라옵니다. 특히 Discord의 #tips-and-tricks 채널은 전 세계 개발자들이 .cursorrules 파일을 실시간으로 공유하는 곳이라 북마크 필수입니다.
FAQ
Q1. Cursor AI를 쓰면 GitHub Copilot은 지워야 하나요?
결론부터 말하면, 같이 쓰면 충돌납니다. 특히 자동완성 제안이 두 개가 동시에 뜨면서 에디터가 버벅이는 증상이 생깁니다. Cursor로 완전히 이전하는 걸 추천드리고, 만약 회사가 GitHub Copilot 라이선스를 강제한다면 Cursor의 자동완성만 끄고 Chat/Composer 기능만 쓰는 방식으로 병행할 수 있습니다. Settings → Editor → Enable Autocomplete 체크 해제하면 됩니다.
Q2. Pro 플랜 월 $20인데 토큰 한도가 있나요? 얼마나 쓰면 막히나요?
2026년 현재 기준으로 Pro 플랜은 Claude, GPT-4o 기준 월 500회 “Fast Request”가 포함되고, 초과 시 “Slow” 큐로 전환됩니다. 하루 종일 풀타임 개발자 기준으로 Composer를 무분별하게 쓰면 2~3주 안에 소진될 수 있어요. 해결책은 짧은 코드 수정은 Cmd+K (인라인)으로, 긴 대화가 필요한 것만 Composer로 쓰는 습관입니다. GPT-4o Mini는 별도 무제한이라 자동완성 모델로 설정해두면 아낄 수 있습니다.
Q3. 회사 레거시 코드(Java, Spring 10년 된 것)에도 효과 있나요?
효과 있습니다. 단, Codebase 인덱싱이 제대로 되어 있어야 해요. 프로젝트를 열고 첫 인덱싱이 완료될 때까지 기다리세요(규모에 따라 5~20분). 그 이후 @Codebase로 “UserService에서 트랜잭션 빠진 메서드 찾아줘”라고 하면 레거시에서도 꽤 잘 찾아냅니다. Java는 타입이 명확해서 오히려 컨텍스트 파악이 잘 됩니다. 다만 XML 기반 Spring 설정파일이 많으면 그 부분은 맥락을 직접 설명해줘야 합니다.
한 줄 평: 세팅 15분에 투자 못 하면서 AI가 왜 내 말을 못 알아듣냐고 하면 안 됩니다. .cursorrules 하나 잘 만드는 게 프롬프트 엔지니어링보다 10배 낫습니다.
✍️ 끝으로 한마디: 도구는 그냥 설치하면 70점, 제대로 세팅하면 150점입니다. 이 글에서 소개한 설정 중 딱 하나만 오늘 바로 적용하라면 .cursorrules 파일 만들기입니다. 10분 투자로 하루 1~2시간 줄어드는 경험, 직접 해보시면 압니다.
📚 관련된 다른 글도 읽어 보세요
- Why I Almost Missed My Ferry — The 2025 Honest Guide to Traveling the Greek Islands on a Budget
- 어릴 때 이것 키워주지 않으면 후회해도 소용없어요 — 2026년 기준 수학 사고력 조기교육 완벽 가이드
- 2026년 가성비 쩌는 싱글몰트 위스키 Top3 — 이거 모르면 돈 낭비입니다
태그: []
Leave a Reply