Cursor AI 에디터 완전 가이드 | VS Code 기반 AI 코딩 도구 실전 활용

· 15분 읽기 · 수정 초급 튜토리얼
Cursor AI 에디터 완전 가이드 | VS Code 기반 AI 코딩 도구 실전 활용

이 글의 핵심

Cursor는 VS Code 기반의 AI 코딩 에디터입니다. Tab 자동완성, AI Chat, Composer(에이전트 모드)를 통해 전체 기능 코드 작성, 버그 수정, 코드베이스 탐색을 AI와 함께 할 수 있습니다.

Cursor란?

Cursor는 VS Code를 포크(fork)한 AI 중심 코드 에디터입니다. 2024년부터 급격히 성장해 2026년 현재 AI 코딩 도구 중 가장 많이 사용되는 에디터가 됐습니다.

기존 에디터와 다른 점:

일반 에디터: 코드 작성 → 검색 → 문서 확인 → 다시 코드 작성
Cursor:      "이 기능 추가해줘" → AI가 파일 생성·수정 → 검토 → 적용

설치 및 기본 설정

설치

cursor.com에서 다운로드 (macOS, Windows, Linux 지원)

VS Code 확장 프로그램과 설정을 마이그레이션:

  • 처음 실행 시 VS Code 설정 자동 가져오기 제안

모델 설정

Cursor Settings → Models에서 선택:

모델특징
claude-sonnet-4-6최신, 빠른 응답, 코드 품질 우수
claude-opus-4-5가장 강력, 복잡한 작업
gpt-4o빠른 속도, 일반 작업
cursor-small매우 빠름, 간단한 자동완성

자신의 API 키 사용 (권장)

Cursor Settings → Models → Add Model → API Key 입력

  • 요청 횟수 제한 없음
  • 최신 모델 즉시 사용 가능
  • 비용은 실제 사용량만 청구

핵심 기능 1: Tab 자동완성

커서를 두면 AI가 다음 코드를 예측하여 제안합니다.

아래는 calculate_fibonacci 함수 구현 예제입니다. 위에서 설명한 핵심 로직을 담고 있습니다.

def calculate_fibonacci(n: int) ->  # Tab을 누르면...
# → def calculate_fibonacci(n: int) -> list[int]:
#        if n <= 0:
#            return []
#        elif n == 1:
#            return [0]
#        ...

팁: 주석으로 의도를 먼저 설명하면 더 정확한 코드 생성

# 사용자 인증 미들웨어: JWT 토큰 검증 후 user_id를 request에 추가
def auth_middleware(request):  # Tab → 전체 구현 자동 생성

핵심 기능 2: AI Chat (Ctrl+L / Cmd+L)

코드에 대해 질문하거나 수정을 요청합니다.

@ 참조 활용

터미널에서 다음 명령어를 실행합니다.

@파일명        특정 파일을 컨텍스트에 추가
@폴더명        폴더 전체를 컨텍스트에 추가
@Codebase      전체 코드베이스에서 관련 코드 검색
@Web           웹 검색으로 최신 정보 참조
@Docs          지정한 공식 문서 참조
#파일명        현재 파일의 특정 부분 지정

실전 사용 예시:

터미널에서 다음 명령어를 실행합니다.

# 에러 디버깅
이 에러가 왜 발생하는지 설명해줘:
TypeError: Cannot read property 'map' of undefined
  at @src/components/PostList.tsx:23

# 코드 리뷰
@src/api/auth.ts 이 인증 코드의 보안 취약점을 찾아줘

# 코드베이스 탐색
@Codebase 사용자 인증은 어디서 처리되나요?

# 공식 문서 참조
@Docs[React 18] Suspense와 함께 데이터 패칭하는 best practice 알려줘

핵심 기능 3: Composer (Ctrl+I / Cmd+I)

에이전트 모드 — 여러 파일을 자동으로 생성하고 수정합니다.

사용 예시

터미널에서 다음 명령어를 실행합니다.

프롬프트: "사용자 프로필 수정 기능을 추가해줘.
- PUT /api/users/:id 엔드포인트
- 닉네임, 프로필 이미지 URL 수정 가능
- 유효성 검사 포함
- 기존 auth 미들웨어 사용"

→ Cursor가 자동으로:
  ✅ src/routes/users.ts 수정
  ✅ src/validators/userValidator.ts 생성
  ✅ src/types/user.ts 업데이트
  ✅ tests/users.test.ts 생성

Composer 실전 팁

터미널에서 다음 명령어를 실행합니다.

# 1. 명확한 컨텍스트 제공
@src/models/User.ts @src/routes/ 를 참고해서 
새로운 Comment 모델과 CRUD API를 추가해줘

# 2. 단계적 접근
먼저 Comment 모델만 만들어줘 (마이그레이션 포함)
→ 검토 후 →
이제 Comment API 라우터를 추가해줘

# 3. 체크포인트 활용
각 단계에서 Composer가 만든 변경사항을 검토하고
문제가 있으면 "이 파일은 그대로 두고 나머지만 수정해줘"

.cursorrules 설정

프로젝트 루트에 .cursorrules 파일을 만들어 AI의 동작을 정의합니다.

Python 프로젝트 예시

터미널에서 다음 명령어를 실행합니다.

# .cursorrules
You are an expert Python developer working on a FastAPI project.

## 코드 스타일
- Python 3.12+ 기능 적극 활용 (match/case, type hints 등)
- 함수는 반드시 타입 힌트 포함
- 변수명은 snake_case, 클래스명은 PascalCase
- 줄 길이 최대 100자

## 프레임워크 규칙
- FastAPI의 의존성 주입 시스템 사용 (Depends)
- Pydantic v2 모델 사용
- 비동기 처리: async/await 우선
- 에러 처리: HTTPException 사용

## 금지 사항
- global 변수 사용 금지
- print() 대신 logging 사용
- 하드코딩된 값은 환경변수로 분리

## 테스트
- pytest 사용
- 각 함수마다 단위 테스트 작성
- given/when/then 패턴 사용

TypeScript 프로젝트 예시

터미널에서 다음 명령어를 실행합니다.

# .cursorrules
You are an expert TypeScript developer working on a Next.js 15 project.

## 기술 스택
- Next.js 15 (App Router)
- TypeScript strict mode
- Tailwind CSS + shadcn/ui
- Zustand (상태 관리)
- React Query (서버 상태)

## 코드 규칙
- Server Components 우선 사용
- 클라이언트 컴포넌트는 'use client' 명시 최소화
- 타입 any 사용 금지
- interface 대신 type 사용

## 파일 구조
- 컴포넌트: src/components/[기능]/[컴포넌트명].tsx
- 서버 액션: src/actions/[기능].ts
- API 라우트: src/app/api/[기능]/route.ts

Cursor vs VS Code + Copilot 비교

기능CursorVS Code + Copilot
Tab 자동완성⭐⭐⭐⭐⭐⭐⭐⭐⭐
멀티파일 편집✅ Composer❌
코드베이스 검색✅ @Codebase⚡ 제한적
에이전트 모드✅❌
모델 선택✅ 다양GPT-4o 위주
VS Code 플러그인✅ 호환✅ 네이티브
가격$20/월 Pro$10/월
프라이버시코드 서버 전송코드 서버 전송

실전 워크플로우

새 기능 추가 (Composer 활용)

터미널에서 다음 명령어를 실행합니다.

1. Cmd+I 로 Composer 열기
2. 컨텍스트 추가: @관련파일들
3. 요청 작성:
   "결제 처리 기능 추가. 
    Stripe SDK 사용. 
    @src/models/Order.ts 의 Order 모델 참고.
    실패 시 재시도 로직 포함."
4. 생성된 파일 검토 (diff 뷰어)
5. Accept All 또는 개별 Accept

버그 수정 (Chat 활용)

터미널에서 다음 명령어를 실행합니다.

1. 에러 메시지 복사
2. Cmd+L 로 Chat 열기
3. 에러 붙여넣기 + @현재파일
4. "이 에러 원인과 수정 방법 알려줘"
5. 제안 코드를 Apply 버튼으로 적용

코드 리뷰 자동화

터미널에서 다음 명령어를 실행합니다.

# Git diff를 Chat에 붙여넣고:
"이 변경사항에서:
1. 잠재적 버그
2. 성능 문제
3. 보안 취약점
을 찾아줘"

유용한 단축키

단축키 (Mac)기능
TabAI 제안 수락
EscAI 제안 거부
Cmd+LAI Chat 열기
Cmd+IComposer 열기
Cmd+K인라인 편집
Cmd+Shift+LChat에 선택 코드 추가
Cmd+EnterComposer에서 전체 코드베이스 검색 포함

마치며

Cursor는 단순한 자동완성 도구가 아니라 AI와 협업하는 방식 자체를 바꾸는 에디터입니다. 특히 새 기능 추가, 코드베이스 탐색, 리팩토링에서 생산성이 크게 향상됩니다.

관련 글: