Cursor AI 개발 환경 최적화 세팅하기

Cursor는 VS Code 기반의 AI IDE로, 단순 설정만으로는 성능을 제대로 끌어내기 어렵습니다.
핵심은 AI가 코드베이스를 얼마나 잘 이해하도록 만들 것인가입니다.

이 글에서는 실무에서 바로 적용 가능한 Cursor 최적화 세팅을 정리합니다.

---

1. 핵심 요약

Cursor 최적화는 다음 3가지가 가장 중요합니다.

• Codebase Indexing 활성화
• .cursorrules 정의
• 자동화 + AI 추천 설정 활성화

이 세 가지만 제대로 구성해도 생산성이 크게 달라집니다.

---

2. 기본 settings.json 최적화

아래 설정은 실무에서 가장 많이 사용하는 안정적인 구성입니다.

{
  // --- AI 기능 ---
  "editor.inlineSuggest.enabled": true,
  "cursor.suggest.enable": true,
  "cursor.chat.enableAutoApply": true,

  // --- 저장 자동화 ---
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": "explicit",
    "source.organizeImports": "explicit"
  },
  "files.autoSave": "onFocusChange",

  // --- 가독성 ---
  "editor.fontSize": 14,
  "editor.fontFamily": "'Fira Code', 'D2Coding', monospace",
  "editor.fontLigatures": true,
  "editor.lineHeight": 1.6,

  // --- UI ---
  "editor.minimap.enabled": false,
  "editor.renderLineHighlight": "all",

  // --- 커서 UX ---
  "editor.cursorBlinking": "smooth",
  "editor.cursorSmoothCaretAnimation": "on",
  "editor.smoothScrolling": true,

  // --- 코드 구조 가시성 ---
  "editor.bracketPairColorization.enabled": true,
  "editor.guides.bracketPairs": "active",
  "editor.guides.indentation": true,

  // --- 성능 최적화 ---
  "files.exclude": {
    "**/.git": true,
    "**/node_modules": true,
    "**/.next": true,
    "**/dist": true
  },
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true
  }
}

---

3. Cursor 핵심 기능 설정

3.1 Codebase Indexing

경로:

• Settings → Features → Codebase Indexing

효과:

• 프로젝트 전체 구조를 AI가 이해
• 함수, 파일, 의존성까지 문맥 인식 가능

이 설정을 하지 않으면 Cursor의 성능은 절반 수준으로 떨어집니다.

---

3.2 .cursorrules (가장 중요)

프로젝트 루트에 .cursorrules 파일을 생성합니다.

touch .cursorrules

예시:

You are an expert backend engineer.

Tech Stack:
- Node.js (NestJS)
- PostgreSQL
- Redis

Rules:
- Use clean architecture
- Prefer async/await
- Use repository pattern
- Write production-ready code

Style:
- Use camelCase
- Use strict typing

효과:

• AI 코드 스타일 일관성 확보
• 팀 규칙 강제 가능
• 불필요한 코드 생성 감소

---

3.3 모델 선택 전략

용도추천 모델

일반 개발	GPT-4o
복잡한 로직	Claude 3.5 Sonnet
빠른 반복 작업	GPT-4o mini

---

4. 필수 확장 프로그램

Cursor는 VS Code 확장을 그대로 활용할 수 있습니다.

• ESLint: 코드 품질 유지
• Prettier: 코드 포맷 통일
• GitLens: Git 히스토리 분석
• Error Lens: 에러 가시화
• Path Intellisense: import 자동완성

---

5. 생산성 향상 팁

5.1 @ 컨텍스트 활용

@service/user.service.ts 이 함수 리팩토링 해줘

특정 파일을 명시하면 AI 정확도가 크게 향상됩니다.

---

5.2 Edit vs Chat 구분

기능단축키용도

Edit	Cmd/Ctrl + K	코드 수정
Chat	Cmd/Ctrl + L	설명 및 질문

---

5.3 프롬프트 패턴

Refactor this code for performance and readability.
Keep same behavior.

간결하고 명확한 지시가 가장 좋은 결과를 만듭니다.

---

6. 대규모 프로젝트 최적화

6.1 인덱싱 제외 확장

# Add directories or file patterns to ignore during indexing (e.g. foo/ or *.csv)
"**/.git" # Git repository
"**/node_modules" # Node.js modules
"**/logs" # Logs
"**/tmp" # Temporary files
"**/coverage" # Coverage reports
"**/*.log" # Log files

효과:

• 인덱싱 속도 향상
• AI 응답 속도 개선

---

6.2 Monorepo 대응 전략

• workspace 단위 분리
• 필요한 폴더만 open
• 불필요한 디렉토리 제외

---

7. 결론

Cursor의 성능은 단순 설정이 아니라 다음 3가지로 결정됩니다.

• Codebase Indexing
• .cursorrules
• 프롬프트 작성 방식

이 세 요소를 제대로 구성하면,
기존 IDE 대비 개발 생산성이 크게 향상됩니다.