Skip to main content
Cursor는 VS Code를 기반으로 한 AI-first 코드 에디터입니다. 코드 자동완성, 인라인 편집, AI 채팅을 통해 개발 속도를 높여줍니다.

​
주요 특징

기능설명단축키
Tab 자동완성다음 코드를 예측하여 제안Tab
Inline Edit선택 영역을 자연어로 편집Cmd+K
Chat코드베이스 맥락 기반 AI 대화Cmd+L
Composer멀티파일 동시 생성/편집 에이전트Cmd+I
@ 참조파일, 심볼, 문서를 대화에 첨부@파일명

​
설치 및 초기 설정

1

Cursor 다운로드

cursor.com에서 OS에 맞는 버전을 다운로드합니다.
2

VS Code 설정 가져오기

최초 실행 시 VS Code 확장과 설정을 자동으로 마이그레이션할 수 있습니다. 기존 VS Code 사용자라면 Import 옵션을 선택하세요.
3

AI 모델 설정

Settings > Models에서 사용할 모델을 선택합니다.
모델특징
Claude Sonnet빠른 응답, 코드 생성에 최적
Claude Opus깊은 분석, 복잡한 리팩토링
GPT-4o범용 코드 작업
모델은 작업 유형에 따라 Chat과 Composer에서 각각 다르게 설정할 수 있습니다.
4

프로젝트 열기

문서 저장소 루트(docs.json이 있는 디렉토리)를 엽니다.

​
Rules for AI 설정

프로젝트 루트에 .cursorrules 파일을 생성하면 AI 동작을 커스터마이즈할 수 있습니다. 
## Project Rules
- 이 프로젝트는 Mintlify 기반 문서 사이트입니다
- MDX 파일 편집 시 Mintlify 컴포넌트를 사용하세요
- 한국어로 작성하되 기술 용어는 영어 유지
- 코드 예시는 실행 가능한 상태로 작성하세요
.cursorrules는 프로젝트 단위 설정입니다. 전역 설정은 Settings > General > Rules for AI에서 관리합니다.

​
핵심 키보드 단축키

동작macOS설명
AI 채팅 열기Cmd+L사이드바에서 AI 대화 시작
인라인 편집Cmd+K선택 영역에 AI 편집 지시
ComposerCmd+I멀티파일 에이전트 실행
파일 참조@파일명채팅에 특정 파일 컨텍스트 추가
코드베이스 검색@codebase전체 프로젝트 맥락으로 질문
문서 참조@docs외부 문서를 컨텍스트에 추가
터미널 AICmd+K (터미널)터미널에서 명령어 생성

​
실무 활용

코드를 선택한 뒤 Cmd+K를 누르면 자연어로 편집을 지시할 수 있습니다.
  • “이 함수에 타입 가드 추가해줘”
  • “에러 핸들링을 try-catch로 감싸줘”
  • “이 로직을 async/await으로 변환해줘”
결과를 미리보기로 확인한 뒤 Enter로 적용, Esc로 취소합니다.
Cmd+I로 Composer를 열면 여러 파일을 동시에 생성하거나 편집할 수 있습니다.
  • “API 라우트와 타입 정의, 테스트 파일을 함께 만들어줘”
  • “이 컴포넌트를 3개 파일로 분리해줘”
Agent 모드를 활성화하면 터미널 명령어 실행까지 자동화됩니다.
채팅에서 @를 입력하면 다양한 컨텍스트를 추가할 수 있습니다.
  • @파일명 — 특정 파일 내용 첨부
  • @codebase — 전체 프로젝트 검색 후 관련 코드 자동 선택
  • @docs — 등록한 외부 문서 참조
  • @web — 웹 검색 결과 참조
Mintlify 스킬을 설치하면 Cursor가 문서 컴포넌트를 인식합니다.
npx skills add https://mintlify.com/docs
AGENTS.md에 프로젝트 용어와 스타일 가이드를 추가하세요.
Composer Agent 모드는 파일 생성/삭제와 터미널 명령을 자동 실행합니다. 중요한 프로젝트에서는 Git 커밋 후 사용하세요.