Cursor AI 설정 가이드: 설치부터 첫 프로젝트까지 (2026)

Cursor는 VS Code를 기반으로 구축된 AI 네이티브 코드 에디터로, 개발 워크플로우에 AI 지원을 직접 통합합니다. 인라인 코드 완성, 다중 파일 편집, 전체 기능을 빌드할 수 있는 에이전트 모드, 그리고 Claude Sonnet 4 및 GPT-4o와 같은 모델과의 깊은 통합을 제공합니다.

이 가이드는 설치부터 Cursor의 AI 기능을 활용한 첫 프로젝트 구축까지 모든 과정을 안내합니다.

1단계: Cursor 다운로드 및 설치

macOS

cursor.com에 접속하여 Download for Mac을 클릭합니다.
다운로드된 .dmg 파일을 엽니다.
Cursor를 Applications 폴더로 드래그합니다.
Applications에서 Cursor를 실행합니다.

# 또는 Homebrew를 통해 설치
brew install --cask cursor

Windows

cursor.com에서 .exe 설치 파일을 다운로드합니다.
설치 프로그램을 실행하고 안내를 따릅니다.
시작 메뉴에 Cursor가 나타납니다.

Linux

# AppImage 다운로드
wget https://download.cursor.com/linux/appImage/x64 -O cursor.AppImage
chmod +x cursor.AppImage
./cursor.AppImage

2단계: 초기 구성

Cursor를 처음 실행하면 온보딩 마법사가 진행됩니다.

계정 생성

Sign Up 또는 Log In을 클릭합니다.
이메일, Google 또는 GitHub 계정으로 가입합니다.
무료 Hobby 플랜(월 50회의 빠른 요청)으로 시작하게 됩니다.

VS Code 설정 가져오기

VS Code를 사용 중이었다면 Cursor에서 모든 설정을 자동으로 가져올 수 있습니다.

온보딩 중에 Import from VS Code를 선택합니다.
Cursor가 다음 항목들을 가져옵니다:
- Extensions (확장 프로그램)
- Keybindings (단축키)
- Settings (settings.json)
- Themes (테마)
- Snippets (스니펫)

온보딩 중에 이 단계를 건너뛰었다면 나중에 수행할 수 있습니다.

Cursor > Settings > General > Import VS Code Settings

테마 및 글꼴 설정

Cursor는 모든 VS Code 테마를 지원합니다. 선호하는 스타일을 설정하세요.

커맨드 팔레트를 엽니다: Cmd+Shift+P (Mac) 또는 Ctrl+Shift+P (Windows/Linux)
"Color Theme"를 입력하고 원하는 테마를 선택합니다.
글꼴 설정: Settings > Text Editor > Font Family로 이동합니다.

3단계: Cursor의 AI 기능 이해하기

프로젝트를 시작하기 전에 네 가지 주요 AI 기능을 이해해야 합니다.

기능	단축키	역할
Cursor Tab	자동 실행	타이핑 시 인라인 코드 완성 제안
Chat	`Cmd+L`	코드베이스 컨텍스트를 활용한 사이드 패널 AI 채팅
Inline Edit	`Cmd+K`	AI 지시사항으로 선택된 코드 편집
Agent Mode	`Cmd+L` > Agent	자율적인 다중 파일 편집 및 터미널 작업

Cursor Tab (자동 완성)

Cursor Tab은 타이핑을 할 때 코드를 제안하는 인라인 자동 완성 기능입니다. 파일 전체와 프로젝트 컨텍스트를 이해하여 기존의 자동 완성보다 더 강력한 기능을 제공합니다.

// 함수 작성을 시작하면 Cursor Tab이 완성해줍니다:
function calculateTax(amount: number, rate: number) {
  // Cursor Tab 제안: return amount * (rate / 100);
}

Cursor Tab은 자동으로 활성화됩니다. Tab을 눌러 제안을 수락하거나 Esc를 눌러 취소하세요.

Chat (Cmd+L)

채팅 패널에서는 Claude 또는 GPT와 코드에 대해 대화할 수 있습니다. 관련 파일들이 자동으로 컨텍스트에 포함됩니다.

주요 채팅 기능:

@-mentions: @filename을 사용하여 특정 파일, 폴더 또는 심볼을 태그합니다.
Codebase search: Cursor가 프로젝트를 인덱싱하여 시맨틱 검색을 제공합니다.
Apply 버튼: 클릭 한 번으로 코드 제안을 파일에 적용합니다.
Agent mode: 자율적인 다단계 작업 실행을 위한 토글입니다.

Inline Edit (Cmd+K)

코드를 선택하고 Cmd+K를 누른 뒤 지시사항을 입력하면 Cursor가 선택 영역을 다시 작성합니다.

코드 블록을 선택합니다.
Cmd+K를 누릅니다.
"에러 핸들링과 입력값 검증 추가해줘"라고 입력합니다.
Enter를 누릅니다.
변경 사항(diff)을 검토하고 수락(Accept) 또는 거절(Reject)합니다.

Agent Mode

에이전트 모드는 가장 강력한 기능입니다. 다음과 같은 작업이 가능합니다.

여러 파일 읽기 및 쓰기
터미널 명령 실행
패키지 설치
처음부터 끝까지 전체 기능 구축

채팅 패널에서 Agent 토글을 클릭하여 활성화할 수 있습니다.

4단계: AI 모델 설정

Cursor에서는 기능별로 사용할 AI 모델을 선택할 수 있습니다.

Settings > Models로 이동하여 설정하세요.

기능	추천 모델	이유
Chat	Claude Sonnet 4	속도와 품질의 가장 우수한 밸런스
Agent	Claude Sonnet 4	다단계 작업 수행 능력 탁월
Cursor Tab	Default (Cursor-small)	속도에 최적화됨
Inline Edit	Claude Sonnet 4 또는 GPT-4o	빠르고 정확함

본인의 API 키를 사용하여 커스텀 모델 액세스를 추가할 수도 있습니다.

Settings > Models > API Keys로 이동합니다.
Anthropic, OpenAI 또는 기타 제공자의 키를 입력합니다.
모델 드롭다운에서 커스텀 모델을 선택합니다.

// 예: 본인의 Anthropic API 키 사용 시
{
  "anthropicApiKey": "sk-ant-xxxxx",
  "preferredModel": "claude-sonnet-4-20250514"
}

5단계: 첫 프로젝트 설정하기

Cursor의 AI 기능을 사용하여 간단한 Next.js 애플리케이션을 처음부터 빌드해 보겠습니다.

프로젝트 생성

Cursor 내의 터미널(Ctrl+`` )을 열고 다음을 실행합니다.

npx create-next-app@latest my-cursor-project --typescript --tailwind --app --src-dir
cd my-cursor-project

Cursor에서 프로젝트 폴더를 엽니다: File > Open Folder > my-cursor-project

에이전트 모드로 기능 스캐폴딩하기

채팅 패널(Cmd+L)을 열고 Agent 모드를 활성화한 뒤 다음과 같이 입력합니다.

다음 기능을 포함한 작업 관리(task management) 기능을 만들어줘:
1. 모든 작업을 표시하는 /tasks 페이지
2. 제목, 설명, 우선순위 필드가 있는 "작업 추가" 폼
3. React useState를 사용하여 로컬 상태에 저장되는 작업들
4. 작업 완료 표시 및 삭제 기능
5. Tailwind CSS를 사용한 깔끔하고 현대적인 디자인

모든 타입에 TypeScript 인터페이스를 사용하고, Next.js App Router 컨벤션을 따를 것.

Cursor의 에이전트는 다음을 수행합니다:

새 파일에 작업 타입을 생성합니다.
작업 목록 컴포넌트를 빌드합니다.
작업 추가 폼을 생성합니다.
페이지 라우트를 설정합니다.
Tailwind 클래스로 스타일을 추가합니다.

여러 파일이 생성되고 편집되는 과정을 지켜보세요. 변경 사항을 적용하기 전에 각 파일을 diff 뷰에서 검토하세요.

인라인 편집으로 세부 조정하기

에이전트가 초기 코드를 생성한 후, 인라인 편집을 사용하여 특정 부분을 다듬습니다.

작업 목록 컴포넌트를 선택합니다.
Cmd+K를 누릅니다.
"드래그 앤 드롭 순서 변경 기능과 부드러운 애니메이션을 추가해줘"라고 입력합니다.
변경 사항을 검토하고 수락합니다.

디버깅을 위해 채팅 활용하기

문제가 발생하면 에러 내용을 채팅창에 붙여넣으세요.

Cmd+L을 눌러 채팅을 엽니다.
"이 에러가 발생했어:"라고 입력하고 에러 메시지를 붙여넣습니다.
채팅이 프로젝트 컨텍스트와 함께 에러를 분석하고 해결책을 제시합니다.
Apply를 클릭하여 수정 사항을 즉시 적용합니다.

6단계: 필수 설정 구성

이 설정들은 Cursor 사용 경험을 크게 향상시켜 줍니다.

Cursor Rules 파일

프로젝트 루트에 .cursorrules 파일을 생성하여 Cursor에게 프로젝트별 지침을 제공하세요.

당신은 Next.js 15 애플리케이션을 개발하는 시니어 TypeScript 개발자입니다.

기술 스택:
- Next.js 15 (App Router)
- 엄격 모드(strict mode)의 TypeScript
- 스타일링을 위한 Tailwind CSS
- 컴포넌트를 위한 shadcn/ui

규칙:
- 항상 명시적 타입을 포함한 TypeScript를 사용하십시오.
- 기본적으로 서버 컴포넌트를 사용하고, 필요한 경우에만 클라이언트 컴포넌트를 사용하십시오.
- 기존 프로젝트 구조와 명명 규칙을 따르십시오.
- 의미 있는 변수명을 사용하여 간결하고 읽기 쉬운 코드를 작성하십시오.
- 모든 비동기 작업에 에러 핸들링을 추가하십시오.
- 컴포넌트에 상호작용이 필요한 경우에만 "use client" 지시어를 사용하십시오.

권장 설정

설정(Cmd+,)을 열고 다음과 같이 구성합니다.

{
  "cursor.chat.defaultModel": "claude-sonnet-4-20250514",
  "cursor.tab.enabled": true,
  "cursor.tab.alwaysSuggest": true,
  "editor.inlineSuggest.enabled": true,
  "cursor.chat.showSuggestedFiles": true
}

유용한 단축키

단축키	동작
`Cmd+L`	AI 채팅 열기/포커스
`Cmd+K`	선택 영역 인라인 편집
`Cmd+Shift+K`	터미널 컨텍스트와 함께 인라인 편집
`Cmd+I`	Composer 열기 (다중 파일 편집)
`Tab`	자동 완성 제안 수락
`Esc`	제안 취소
`Cmd+Shift+P`	커맨드 팔레트
`Cmd+.`	퀵 픽스(Quick fix) 제안

7단계: 필수 확장 프로그램 설치

Cursor는 모든 VS Code 확장 프로그램을 지원합니다. 완벽한 환경 설정을 위해 다음 항목들을 설치하세요.

# 필수 확장 프로그램 (Cursor의 확장 패널에서 설치)
- ESLint
- Prettier
- Tailwind CSS IntelliSense
- Error Lens
- GitLens
- Auto Rename Tag

VS Code와 마찬가지로 Extensions 패널(Cmd+Shift+X)을 통해 설치할 수 있습니다.

일반적인 설정 문제 및 해결 방법

Cursor Tab이 작동하지 않음: Settings > Cursor Tab 메뉴에서 활성화되어 있는지 확인하세요. 필요한 경우 Cursor를 재시작하세요.

채팅 응답이 느림: 무료 플랜의 경우 느린 요청(slow requests)을 사용 중일 수 있습니다. Pro로 업그레이드하거나 Settings > Subscription에서 요청 할당량을 확인하세요.

VS Code에서 확장 프로그램이 가져와지지 않음: Settings > General > Import VS Code Settings로 이동하세요. 같은 기기에 VS Code가 설치되어 있어야 합니다.

에이전트 모드가 잘못된 파일 구조를 생성함: 명시적인 프로젝트 구조 가이드라인이 담긴 .cursorrules 파일을 추가하세요. 에이전트는 모든 작업 전에 이 파일을 읽습니다.

메모리 사용량이 높음: 사용하지 않는 확장 프로그램을 비활성화하세요. Cursor는 VS Code의 확장 프로그램 아키텍처를 그대로 사용하므로 확장 프로그램이 너무 많으면 속도가 느려질 수 있습니다.

Cursor Free vs. Pro: 업그레이드할 가치가 있을까?

기능	Free (무료)	Pro (월 $20)
빠른 요청(Fast requests)	월 50회	월 500회
느린 요청(Slow requests)	월 2,000회	무제한
에이전트 모드	제한적	전체 제공
우선순위 큐	없음	있음
권장 대상	학습, 사이드 프로젝트	일상적인 전문 개발 업무

대부분의 개발자에게는 Cursor가 워크플로우에 맞는지 평가하기에 무료 플랜으로도 충분합니다. 50회의 빠른 요청 제한에 정기적으로 도달한다면 Pro 플랜은 충분히 투자할 가치가 있습니다.

결론

Cursor는 2026년 현재 가장 뛰어난 AI 기반 코드 에디터 중 하나입니다. 특히 VS Code 사용자라면 설정 과정이 매우 간단합니다. 무료 플랜으로 시작하여 프로젝트를 위한 .cursorrules 파일을 설정하고, 스캐폴딩을 위한 에이전트 모드와 정교한 수정을 위한 채팅 기능을 활용해 보세요.

프로젝트에 이미지, 비디오, 대화형 아바타와 같은 AI 생성 미디어가 포함되어 있다면, Hypereal AI는 Cursor로 빌드된 애플리케이션에 자연스럽게 통합되는 개발자 친화적인 API를 제공합니다. 신용카드 없이 35 크레딧으로 무료 체험을 시작해 보세요.