코딩 속도를 혁신적으로 높여주는 AI 코드 에디터, 커서(Cursor) 알아보기

코딩 실력을 한 단계 업그레이드하고 싶으신가요? 아니면 코딩 경험이 전혀 없는데도 프로그램을 만들어보고 싶으신가요? 그렇다면 **커서(Cursor)**라는 도구를 주목해보세요! 커서는 Visual Studio Code(VS Code)와 유사한 코드 에디터이지만, 인공지능(AI)의 도움으로 코딩 속도를 훨씬 빠르게 만들어줍니다.

Cursor AI란 무엇인가요?

Cursor는 VS Code와 유사한 코드 에디터로, AI의 도움을 받아 코딩 속도를 크게 향상시키도록 설계되었습니다. 코딩 경험이 없어도 기본적인 프로그램을 만들고 코딩 방법을 배우는 데 도움을 줄 수 있으며, 경험이 많은 개발자에게는 코딩 속도를 극적으로 높여주고 대규모 코드베이스에서도 작업할 수 있게 해줍니다. Cursor는 데스크톱 애플리케이션으로 컴퓨터에 설치하여 컴퓨터의 파일에서 작업합니다. 웹 브라우저에서 실행되는 다른 도구와는 다릅니다. 무료로 시작할 수 있으며, 무료 플랜에는 2주간의 Pro 평가판이 포함됩니다.

Cursor의 4가지 핵심 기능

Cursor가 가진 강력한 네 가지 기능은 다음과 같습니다.

프로젝트 맞춤형 AI 규칙 설정
- 어디서 찾을 수 있나요? File > Preferences > Cursor settings
- 무엇을 하나요? AI가 특정 프로젝트의 특성을 이해하고 그에 맞춰 코드 제안이나 가이드라인을 제공하도록 설정할 수 있습니다. 예를 들어, 특정 코딩 스타일이나 아키텍처 규칙을 AI가 따르도록 지시할 수 있죠.
.cursorignore 파일을 통한 AI 편집 범위 제한
- 무엇을 하나요? Git의 .gitignore 파일과 비슷하게, .cursorignore 파일을 사용해서 AI가 특정 파일이나 폴더(예: 테스트 코드, 중요한 설정 파일)를 건드리지 않도록 설정할 수 있습니다. 이는 프로젝트의 안정성을 지키는 데 매우 중요합니다.
.cursor 폴더를 활용한 전역 규칙 관리
- 무엇을 하나요? 프로젝트 루트에 .cursor 폴더를 만들고, 이 안에 마크다운(MD) 파일로 설계 문서나 요구사항 등을 넣어둘 수 있습니다. 이 파일들은 AI가 프로젝트의 전반적인 맥락과 규칙을 이해하는 데 활용되어, 더 정확하고 일관된 코드 제안을 가능하게 합니다.
사용자 편집 컨텍스트 인식
- 무엇을 하나요? Cursor의 AI는 개발자가 직접 코드를 수정하는 과정을 지켜보고 학습합니다. 이를 통해 단순히 정해진 규칙을 따르는 것을 넘어, 개발자의 의도와 코딩 스타일을 파악하여 더욱 정확하고 유용한 코드 제안을 해줄 수 있습니다. 마치 옆에서 함께 코딩하는 똑똑한 동료 같은 역할을 합니다.

이러한 기능들 덕분에 Cursor는 개발자들이 더 효율적으로 코드를 작성하고, 프로젝트를 관리하며, AI와 효과적으로 협업할 수 있도록 돕습니다.

Cursor UI 개요

Cursor는 VS Code를 기반으로 하므로 VS Code에 익숙하다면 쉽게 사용할 수 있습니다. 주요 패널은 다음과 같습니다:

상단 메뉴: 다양한 기능을 수행할 수 있는 메뉴들이 있습니다. 특히 파일(File) > 기본 설정(Preferences) > Cursor 설정(Cursor settings) 및 VS Code 설정(vs code settings)에서 Cursor의 작동 방식을 구성할 수 있습니다.
왼쪽 파일 탐색기: 컴퓨터의 폴더를 보여주며 다른 파일로 빠르게 이동할 수 있습니다. 파일을 추가하거나 폴더를 추가할 수 있습니다.
중앙 패널 (에디터): 현재 보고 있는 파일의 내용을 표시합니다. 코드를 볼 수 있으며, 여기서 변경하면 자동 완성 및 제안과 같은 기능과 AI 기능을 사용할 수 있습니다. 특정 코드를 선택하고 Ctrl/Cmd+K를 눌러 AI 기능을 사용할 수도 있습니다.
하단 터미널 (Terminal): 컴퓨터에서 명령을 실행할 수 있는 곳입니다. 터미널에서도 Ctrl + K를 눌러 AI의 도움을 받아 명령을 생성할 수 있습니다.
오른쪽 AI 채팅 패널 (AI Chat Panel): 코드 에디터에 내장된 ChatGPT와 유사합니다. 가지고 있는 모든 파일을 인식하고 모든 파일에 걸쳐 변경을 수행할 수 있습니다. 이 패널이 Cursor AI와의 상호 작용 대부분이 일어나는 가장 중요한 패널입니다.

커서 AI의 핵심: AI 채팅 패널

AI 채팅 패널은 커서 AI와의 상호 작용이 가장 많이 일어나는 곳입니다. 이곳에는 여러 중요한 기능들이 있습니다:

입력창 (Input Box): AI에게 질문하거나 코드를 작성하도록 지시하는 프롬프트를 입력하는 곳입니다.
컨텍스트 추가 (Add Context): AI가 요청을 처리할 때 고려하도록 추가적인 컨텍스트를 제공할 수 있습니다.
모드 드롭다운 (Mode Dropdown): 커서 AI의 작동 방식을 선택합니다.
- Agent 모드: 코드를 변경하거나 기능을 구현할 때 사용합니다. AI가 코드를 작성하고 파일에 직접 수정 사항을 적용합니다.
- Ask 모드: 코드에 대해 질문하거나, 코드 구조를 배우거나, 애플리케이션 설계를 요청할 때 사용합니다. 코드를 직접 수정하지는 않고 답변만 제공합니다.
모델 드롭다운 (Model Dropdown): Cursor는 OpenAI 및 Anthropic과 같은 회사에서 제공하는 최첨단 AI 모델을 사용합니다. 개인적으로는 Claude 3.5 Sonnet이 코딩에 가장 좋은 모델이며 많은 전문 개발자들이 이 의견을 공유한다고 합니다. Claude 3.7 Sonnet도 있지만 초기 인상으로는 불필요한 코드를 너무 많이 작성하는 경향이 있어 3.5 Sonnet을 선호한다고 합니다.
이미지 추가: 참조용으로 이미지를 추가할 수 있습니다.
채팅 기록: 이전 채팅 기록을 볼 수 있습니다.
새로운 채팅 생성: 새로운 채팅 세션을 시작할 수 있습니다. 새로운 기능을 작업할 때는 일반적으로 새 채팅을 시작하는 것이 좋습니다. 이전 채팅의 컨텍스트가 새로운 작업에 방해가 되어 성능이 저하될 수 있기 때문입니다. 이전 채팅의 요약을 포함하여 새 채팅을 시작하는 기능도 있습니다.

AI Agent를 사용한 코드 작업 워크플로우

Agent 모드는 커서 AI의 가장 강력한 기능 중 하나입니다. 코드를 작성하고 수정하며 심지어 명령을 실행하기도 합니다.

명령 실행: 프로젝트 초기화와 같은 명령을 AI가 제안하고, 사용자가 승인하면 직접 실행해줍니다. YOLO mode 설정을 켜면 자동 실행도 가능하지만, 명령을 확인하는 것이 더 안전할 때가 많습니다.
자동 오류 복구: Agent는 실행 중 발생한 오류를 스스로 식별하고 다른 접근 방식을 시도하여 문제를 해결하려고 합니다.
파일 생성 및 수정: Agent는 필요한 파일을 자동으로 생성하고 코드로 채웁니다. 기존 파일을 수정하기도 합니다. 수정된 코드에는 제거된 줄(빨간색)과 추가된 줄(녹색/노란색)이 표시됩니다. 전체 파일을 수락하고 나중에 추가 변경 사항을 반복하는 것이 일반적으로 가장 좋습니다.
반복 작업: Agent가 처음부터 완벽한 코드를 작성하지 못할 수도 있습니다. 이때 중요한 것은 AI에게 어떤 부분이 잘 작동했고 어떤 부분을 변경해야 하는지 알려주는 것입니다. 이렇게 대화를 통해 코드를 반복적으로 개선해나가는 것이 일반적인 Agent 모드 워크플로우입니다.
체크포인트 복원: 이전 메시지로 돌아가 ‘체크포인트 복원’ 버튼을 클릭하여 이전 코드 버전으로 되돌릴 수 있습니다.
Lint 오류 확인: 코드 구조 오류(linter errors)가 발생하면 Agent가 자동으로 이를 식별하고 수정할 수 있지만, 명시적으로 lint 오류를 확인하도록 요청할 수도 있습니다.

새로운 기능을 개발할 때는 보통 새로운 채팅을 시작하는 것이 좋습니다. 이전 채팅의 컨텍스트가 너무 많아지면 AI 모델의 성능에 오히려 방해가 될 수 있기 때문입니다. 하지만 이전 대화의 컨텍스트를 어느 정도 유지하고 싶다면, 이전 채팅의 요약을 포함하여 새 채팅을 시작하는 기능도 있습니다.

Ask 모드를 사용한 작업 워크플로우

Ask 모드는 코드를 직접 변경하는 대신 정보를 얻거나 아이디어를 구체화하는 데 사용됩니다.

코드 설명: 코드를 선택하고 Ask 모드로 설명을 요청하면, AI가 해당 코드가 무엇을 하는지 자세히 설명해줍니다. 특정 함수나 훅(Hook)과 같은 개념에 대해 질문하고 자세한 설명을 들을 수도 있습니다. 코딩을 배우는 초보자에게 매우 유용한 기능입니다.
설계 제안: 복잡한 시스템이나 기능을 어떻게 설계할지 Ask 모드로 질문할 수 있습니다. AI가 전체적인 아키텍처나 파일 구조 등에 대한 제안을 제공해줍니다.

효율적인 컨텍스트 관리

커서 AI를 효과적으로 사용하려면 AI가 어떤 정보를 고려해야 하는지 잘 지정해주는 것이 중요합니다. AI 채팅 패널의 ‘컨텍스트 추가’ 기능과 프롬프트에서 @ 기호를 사용하여 다양한 컨텍스트를 제공할 수 있습니다.

파일 태그하기 (@): @ 기호를 사용하여 특정 파일을 채팅 컨텍스트에 추가할 수 있습니다. 대규모 코드베이스에서 작업할 때 AI Agent가 관련 코드에 집중하도록 지시하는 가장 강력한 도구입니다. 여러 파일을 태그하여 서로 다른 계층(UI, API 통합, 백엔드 서버)에 걸친 전체 스택 기능을 구현하도록 지시할 수 있습니다. Agent는 태그된 모든 컨텍스트를 고려하고 관련 파일을 수정할 수 있습니다.
공식 문서 (@Doc): @Doc을 사용하여 내장된 공식 문서를 추가할 수 있습니다. 예를 들어 @Doc openAI를 태그하면 Cursor가 해당 문서를 인식합니다. 웹에서 문서를 찾아 복사/붙여넣기 할 필요가 없습니다.
웹 검색 (@web): @web을 태그하면 커서가 직접 웹 검색을 수행하고 그 결과를 바탕으로 답변을 생성합니다. 특정 라이브러리의 최신 사용법 등을 찾을 때 유용합니다.
링크 (URL): 특정 웹 페이지나 GitHub 이슈 링크를 붙여 넣으면 커서가 해당 페이지의 내용을 읽고 컨텍스트로 활용합니다.
이미지: 이미지 파일을 붙여 넣어 디자인 참조 등으로 활용할 수 있습니다.

고급 기능

몇 가지 고급 기능도 언급되었습니다.

.gitignore: .gitignore 파일의 내용을 인식하여 여기에 나열된 파일은 컨텍스트 창에 추가하지 않습니다. 민감한 환경 변수 등이 포함된 파일은 .gitignore에 추가하는 것이 좋습니다. cursorignore라는 Cursor 전용 파일도 같은 기능을 합니다.
cursor rules 파일: 프로젝트의 루트 디렉터리에 cursor_rules 파일을 생성하면 여기에 작성된 내용이 Cursor가 어떤 작업을 수행할 때마다 항상 컨텍스트에 추가됩니다. 특정 방식으로 작업하거나 AI가 항상 특정 지침을 따르도록 할 때 유용합니다 (예: 테스트 주도 개발을 하도록 지시). 매 요청마다 다른 요구사항이 있다면 유용하지 않을 수도 있습니다.
MCPs : Anthropic이 만든 새로운 개념으로, AI Agent와 AI 도구를 다른 데이터 소스에 연결하기 위한 표준 프로토콜입니다. MCP 서버는 Agent가 데이터를 검색하거나 제출하기 위해 호출할 수 있는 엔드포인트를 정의합니다. 아직 초기 단계의 개념이지만, 브라우저 로그를 가져와 문제 해결에 사용하는 등 가능성이 큰 것으로 보입니다.

다른 유용한 AI 기능

AI 채팅 패널 외에도 커서에는 코딩 속도를 높여주는 다양한 AI 기능이 내장되어 있습니다.

자동 완성 (Autocomplete): 코드를 입력하는 동안 AI가 다음 코드를 자동으로 제안해줍니다. Tab 키를 눌러 빠르게 적용할 수 있으며, 변수 이름이나 속성 이름을 기억하지 못할 때 특히 유용합니다. 여러 줄에 걸친 코드도 한 번에 제안하기도 합니다.
인라인 코드 에디터 (Inline Code Editor): Ctrl + K를 눌러 코드 일부를 선택하고 AI에게 해당 부분에 대한 특정 변경을 지시할 수 있습니다. 하지만 Agent 모드를 사용하여 여러 파일에 걸쳐 광범위한 변경을 하는 것이 더 효율적일 때가 많습니다.
명령 생성: 터미널에서 Command + K (Mac) 또는 Ctrl + K (Windows)를 눌러 원하는 작업을 설명하면, AI가 해당 작업을 수행하는 명령어를 생성해줍니다. 정확한 명령어 구문이 기억나지 않을 때 편리합니다.

마무리하며

커서는 AI를 활용하여 코딩 워크플로우를 혁신적으로 개선하는 강력한 도구입니다. 초보자에게는 코딩 학습을 돕고, 숙련된 개발자에게는 개발 속도를 극적으로 향상시킬 수 있습니다. Agent 모드를 통한 코드 자동 생성 및 수정, Ask 모드를 통한 학습 및 설계, 그리고 다양한 컨텍스트 관리 기능은 커서를 다른 AI 도구와 차별화하는 핵심입니다. 처음부터 완벽하지 않더라도 AI Agent와 대화하며 코드를 반복적으로 개선해나가는 과정이 커서 활용의 핵심이니, 주저하지 말고 사용해보세요.

Cursor IDE의 설정

Cursor IDE의 Settings(설정) 화면입니다. 아래는 해당 화면의 구성 요소와 각 항목에 대한 설명입니다:

🔧 좌측 메뉴

General: 일반 설정 (현재 선택됨)
Features: 기능 관련 설정
Models: 사용할 AI 모델 설정
Rules: 코드 룰 관련 설정
MCP: MCP 설정
Indexing: 인덱싱 설정
Beta: 베타 기능 관련 설정

📄 오른쪽 설정 세부 내용

✅ Account (계정 정보)

Pro 계정으로 로그인됨.
현재 로그인된 이메일: jinicoding@gmail.com
버튼:
- Manage: 계정 관리
- Log out: 로그아웃

🔄 VS Code Import

VS Code의 확장 프로그램, 설정, 키 바인딩을 가져올 수 있음.
Import 버튼: VS Code 설정 가져오기 기능

🎨 Appearance (화면 스타일 및 동작)

Cursor의 편집기 UI와 동작을 설정할 수 있는 항목들:
- Open editor settings: 폰트, 자동 저장, 줄 바꿈 등 편집기 설정 링크
- Configure keyboard shortcuts: 키보드 단축키 설정 링크
- Ctrl + Shift + P: 커맨드 팔레트 열기 (VS Code처럼 명령어 실행 가능)

🔒 Privacy mode (개인정보 보호 모드)

코드가 Cursor 측에 저장되지 않도록 설정할 수 있는 기능
옵션:
- Disabled (data shared with Cursor): 개인정보 보호 모드 비활성화 상태. 코드와 프롬프트가 Cursor에 공유됨.
설명: 이 설정은 계정 수준이 아닌 기기 수준(machine-level) 설정임

🧠 Cursor Tab

✅ 기본적으로 활성화되어 있음
설명:
Cursor Tab은 이전 명칭인 **Copilot++**에서 발전된 기능으로, 여러 줄의 코드 변경을 제안할 수 있는 강력한 AI 기능입니다.

🔹 Partial accepts

⬜ Ctrl + → 단축키로 제안된 코드의 다음 단어만 수락 가능
활성화 안 됨 (기본 상태)

전체 줄이 아닌 제안된 다음 단어 단위로 수락할 수 있는 기능입니다.

💬 Suggestions in Comments

✅ 주석 안에서도 제안 활성화

코드 주석(//, #)에서도 AI 코드 제안을 받게 됩니다.
주석 기반 설명을 자동으로 보완할 수 있어 문서화 작업에 유용합니다.

⚪ Show whitespace only changes

⬜ 공백만 바뀐 변경 사항도 표시할지 여부

줄 간 공백 수정 제안도 보고 싶을 때 사용합니다.
일반적으로 의미 없는 변경은 무시하기 때문에 비활성화되어 있음이 일반적입니다.

🔁 Auto Import

✅ 필요한 모듈 자동 import 기능 (TypeScript만 지원)

예: useState 사용 시 자동으로 import { useState } from 'react'를 추가해줌
현재는 TypeScript에서만 동작합니다.

🧪 Auto Import for Python (Beta)

⬜ 파이썬 자동 import 기능 (베타)

아직 실험 중인 기능이므로 기본은 꺼져 있으며, 활성화 시 Python에서도 자동 import 시도

✅ 요약

Cursor Tab은 Copilot을 대체할 수 있는 고급 코드 제안 기능입니다.
여러 줄 수정, 주석 제안, 자동 모듈 import, 그리고 단어 단위 수락 기능이 포함되어 있으며, TypeScript 중심이지만 일부 기능은 Python도 지원 준비 중입니다.

🧠 Chat 설정 전체 설명 (위에서 아래 순서대로)

1. Default new chat mode

새로 열리는 챗의 기본 모드 설정입니다.
예: Agent, Ask, Manual 등 모드 중 선택 가능
기본값은 Agent입니다.

2. Chat text size

챗 메시지 텍스트 크기를 설정합니다.
예: Default, Small, Large 등 선택 가능

3. ✅ Auto-refresh chats

일정 시간 채팅이 비활성화되면 새로운 챗을 자동 생성합니다.

4. ✅ Auto-scroll to bottom

새로운 메시지가 생성되면 채팅 창을 자동으로 맨 아래로 스크롤합니다.

5. ✅ Auto-apply to files outside context in Manual mode

Manual 모드에서 현재 문맥(context) 밖의 파일에도 자동으로 수정 사항을 적용합니다.

6. Include project structure (BETA)

프로젝트 구조(디렉토리 트리)를 단순화된 형태로 제공하여, 모델이 전체 레이아웃을 더 잘 이해하도록 돕습니다.

7. Full folder contents

트리 구조 대신 폴더 전체 내용을 전부 포함하도록 설정합니다.

8. Enable auto-run mode

사용자 확인 없이 도구를 자동으로 실행하게 합니다 (예: 파일 작성, 명령 실행 등).
매우 강력하지만 주의가 필요한 기능입니다.

9. Command allowlist

자동 실행을 허용할 명령어를 수동으로 등록합니다. (위험도 낮은 명령만 허용 추천)

10. Command denylist

자동 실행을 절대 허용하지 않을 명령어를 등록합니다. (보안 필수 기능)

11. Delete file protection

에이전트가 파일을 삭제하지 못하도록 차단하는 옵션입니다.

12. MCP tools protection

MCP 툴(MCP 기능 관련 도구)을 자동 실행하지 못하도록 차단합니다.

13. ✅ Dot files protection

.gitignore, .env 등 숨김(dot) 파일을 수정하지 못하도록 보호합니다.

14. ✅ Outside workspace protection

현재 워크스페이스 외부의 파일을 생성/수정하지 못하도록 차단합니다.

15. Dialog ‘Don’t ask again’ preferences

‘다시 묻지 않기(Don’t ask again)’를 설정한 대화창 목록을 관리합니다.

16. Collapse input box pills in pane or editor

입력창의 토큰(pill)을 압축해서 공간을 절약하는 UI 옵션입니다.

17. ✅ Iterate on lints

Agent 모드에서 린트 오류(linter errors)를 자동으로 반복 수정합니다.
코드 품질 관리에 매우 유용합니다.

18. Hierarchical Cursor Ignore

.cursorignore 파일의 내용을 하위 디렉토리까지 적용합니다.
이 설정은 Cursor 재시작이 필요합니다.

19. ✅ Auto-accept diffs

작업 디렉토리에서 벗어난 변경사항은 **자동으로 승인(diff 수락)**합니다.
버전 관리와 협업 시 편리하지만, 자동 적용이므로 주의 필요.

20. Custom modes (BETA)

사용자 지정 모드(Custom Mode)를 생성할 수 있습니다.
아직 실험적 기능입니다.

21. Play sound on finish (BETA)

챗 응답이 완료되었을 때 소리를 재생합니다.

22. Auto Group Changes (BETA)

챗 세션에서 AI가 생성한 변경사항들을 자동으로 그룹화하여 정리해줍니다.

23. ✅ Web Search Tool (BETA)

Agent 또는 Ask 모드에서 웹 검색 기능을 활성화합니다.
→ 모델이 최신 정보나 외부 지식을 검색해서 반영할 수 있습니다.

🧾 요약 추천 설정

기능	추천 여부
✅ Auto-refresh / Auto-scroll	✅ 편의성 향상
✅ Iterate on lints	✅ 코드 품질 유지
✅ Web Search Tool	✅ 최신 정보 반영
✅ Dot/Outside protection	✅ 보안 필수
❌ Enable auto-run	❌ 민감 작업 시 주의 필요
⚠️ Auto-accept diffs	팀 작업 시 주의

Cursor IDE의 “Docs / Editor / Terminal” 설정 화면입니다. 이 화면은 문서 관리, 코드 편집기 설정, 터미널 사용과 관련된 기능들을 조정하는 영역입니다.

📝 Docs

Manage the custom docs that you’ve added.
→ 사용자 정의 문서를 추가하고 관리할 수 있는 영역입니다.

현재는 문서가 없음.
→ "@Add" 명령을 사용하면 대화나 코드 편집 중 문서를 생성할 수 있습니다.
+ Add new doc 버튼을 눌러 수동으로 문서를 생성할 수도 있습니다.

✏️ Editor

코드 편집기에서의 작동 방식 설정

항목	설명
✅ Show chat/edit tooltip	코드 강조 부분 근처에 채팅 또는 편집 툴팁 표시
⬜ Auto parse inline edit links	`^` / `⌘` + K 입력 시 붙여넣은 링크 자동 파싱
✅ Auto select for Ctrl/⌘ + K	단축키로 코드 수정 시 자동으로 수정 대상 영역 선택
✅ Use themed diff backgrounds	변경사항(diff)을 배경색으로 강조 (테마 기반)
⬜ Use character-level diffs	변경사항을 문자 단위로 표시 (기본은 단어 또는 줄 단위)

💻 Terminal

터미널에서 보이는 힌트 및 동작 설정

항목	설명
✅ Terminal hint	터미널 하단에 명령 힌트 표시
✅ Show terminal hover hint	터미널 위에 마우스를 올리면 ‘챗에 추가’ 등 힌트 표시
⬜ Use preview box for terminal Ctrl+K	꺼져 있으면, 터미널 응답이 셸에 직접 출력됨켜면 Ctrl+K로 미리보기 창에 응답 표시

✅ 요약 추천

기능	추천 여부	이유
Show chat/edit tooltip	✅	코드와 연동된 AI 피드백을 직관적으로 받을 수 있음
Auto select for Ctrl+K	✅	편집 대상 자동 선택으로 생산성 향상
Themed diff backgrounds	✅	가독성 향상
Character-level diffs	⚠️	민감한 텍스트 비교 필요할 때만
Terminal hints	✅	초보자에게 유용한 안내 기능
Preview box for terminal	⚠️	출력이 바로 필요한 작업에는 비활성화 추천

Cursor IDE의 모델 설정 화면입니다. 여기서는 어떤 **언어 모델(LLM)**들을 사용할지 선택하고, 필요 시 API Key를 입력할 수 있습니다.

🔧 Model Names

다양한 LLM(대형 언어 모델)을 Cursor에 추가하거나 활성화하여 사용할 수 있는 설정입니다.
OpenAI, Anthropic, Google, xAI 등 다양한 회사의 모델을 사용할 수 있으며, 보통 OpenRouter와 연동됩니다.

✅ 선택된 모델 (현재 사용 가능 상태)

claude-3.5-sonnet
claude-3.7-sonnet-thinking
gemini-2.5-pro-preview-05-06
gpt-4.1
o3 (Mistral 계열로 추정됨)

⬜ 선택 가능하지만 비활성화된 모델

claude-3.5-haiku, claude-3.7-sonnet
cursor-small (Cursor 자체 모델로 추정)
deepseek-r1, deepseek-v3.1 (DeepSeek 사의 모델)
gemini-2.5-flash-preview-04-17, gemini-2.5-pro-exp-03-25 (Google Gemini)
gpt-4, gpt-4o (OpenAI 모델)
grok-3-beta, grok-3-mini-beta (xAI, Elon Musk의 회사)
o4-mini (Mistral 또는 다른 오픈모델 기반으로 추정)

➕ `+ Add model`

OpenRouter 또는 API를 통해 직접 모델 추가 가능

🔐 OpenAI API Key

OpenAI의 공식 API 키를 넣으면, Cursor에서 GPT-4, GPT-4o 등 OpenAI 모델을 직접 API로 호출하여 사용할 수 있습니다.

안내 사항:

your OpenAI key 링크 클릭 시 OpenAI에서 키 발급 가능
Pro 요금제보다 비용이 더 들 수 있음
일부 커스텀 기능은 작동하지 않을 수 있음
입력 후 Verify 버튼으로 유효성 확인 필요

🧾 요약 정리

항목	내용
모델 선택	다양한 최신 LLM 선택 가능 (Claude, GPT, Gemini, Grok 등)
병렬 사용 가능	여러 모델을 동시에 선택해 필요에 따라 전환
API 키 사용	OpenAI 키를 넣으면 GPT 모델 직접 사용 가능 (요금 주의)
활용 예시	Claude로 코멘트 생성, GPT-4로 리팩토링, Gemini로 문서화 등 작업 가능

Cursor IDE의 Rules 설정 화면입니다.
이곳은 AI에게 전달될 규칙(Rules)을 설정하여, 코드 작성, 편집, 자동화 작업 시 개인 또는 프로젝트의 선호 스타일과 기준을 따르도록 만드는 기능입니다.

🧠 Rules 란?

AI 모델이 사용자의 개인적 선호나 프로젝트 컨벤션을 이해하고 일관되게 코드 생성/수정/응답하도록 하는 설정입니다.
예: “항상 함수형 코드로 작성해줘”, “짧게 답변해줘”, “React에서는 Hooks만 써줘” 등

👤 User Rules (사용자 규칙)

이 항목은 모든 채팅, Composer, Ctrl+K 세션에 적용됩니다.
사용자의 글로벌 규칙을 설정할 수 있습니다.
예시: "Use concise comments. Always write async functions using arrow syntax."

📌 입력된 규칙은 모든 세션에서 AI에게 전달되어, 사용자의 코드 스타일을 일관되게 따르도록 돕습니다.

🏗️ Project Rules (프로젝트 규칙)

특정 프로젝트에 맞춘 규칙. 프로젝트의 코드베이스 컨벤션이나 구조에 맞춰 AI가 응답하도록 합니다.

.cursorrules 파일 또는 직접 입력으로 규칙 추가 가능
버튼: + Add new rule – 프로젝트에 새 규칙 추가
현재는 설정된 프로젝트 규칙 없음
동기화됨: 프로젝트와 연결되어 Git으로 관리 가능

📂 Include .cursorrules file

✅ 선택됨 (활성화 상태)

.cursorrules 파일을 요청 시 포함하지 않도록 설정되어 있음
끄면 .cursorrules 파일을 AI 요청에 포함시켜, 해당 규칙을 반영함

🔚 요약

항목	설명
User Rules	모든 프로젝트/대화에 공통 적용되는 개인 규칙 설정
Project Rules	특정 프로젝트 코드 스타일/구조에 맞춘 규칙
.cursorrules 포함 여부	해당 규칙 파일을 AI에게 전달할지 여부 제어

✍️ 활용 예시

User Rule 예시: Always write Python code using type hints and dataclasses. Keep responses under 10 lines.
Project Rule 예시: In this project, use tabs instead of spaces. Avoid using lodash. Always use ES6 imports.

Cursor IDE의 MCP Servers 설정 화면입니다.
여기서 MCP는 Model Context Protocol의 약자로, LLM에게 새로운 툴(tool)을 연결해주는 확장 시스템입니다. 이 설정을 통해 에이전트가 더 많은 기능을 실행할 수 있도록 툴을 활성화/관리합니다.

🧠 MCP (Model Context Protocol)란?

MCP는 Cursor Agent에게 추가적인 명령어/도구 세트를 제공하여, 코드 작업이나 프로젝트 관리 등을 자동화할 수 있게 합니다.
예: initialize_project, update_task, fix_dependencies 같은 명령을 AI가 직접 실행 가능

⚠️ 경고 메시지

“You have 48 tools from enabled servers. Too many tools can degrade performance, and some models may not respect more than 40 tools.”
✅ 현재 48개의 MCP 툴이 활성화되어 있음
❗ 툴이 너무 많으면 성능 저하가 발생할 수 있으며, 일부 모델은 40개 이상의 툴을 인식하지 못할 수 있음

🔧 MCP 서버 목록

🔹 1. `taskmaster-ai`

상태: ✅ 활성화됨 (초록색 토글)
제공 툴 목록:
- initialize_project, models, get_task, add_task, remove_task …
- analyze_project_complexity, fix_dependencies, validate_dependencies 등 총 20+ 개의 도구 제공
명령 실행 방식: npx -y --package=task-master-ai task-master-ai

🔸 2. `task-master-ai (Project Managed)`

이 MCP 서버는 프로젝트와 연동된 MCP 서버입니다.
툴 목록은 위와 동일
상태: ✅ 활성화됨

🛠 주요 기능 예시

툴 이름	기능
`initialize_project`	새 프로젝트 초기화
`get_task`, `next_task`	현재 또는 다음 할 일(task) 불러오기
`add_task`, `remove_task`	태스크 추가/삭제
`analyze_project_complexity`	프로젝트 복잡도 분석
`fix_dependencies`	의존성 문제 자동 수정

📘 상단 버튼

+ Add new global MCP server
→ 새 MCP 서버를 추가할 수 있음
(예: 자체 개발한 툴킷 서버, 외부 도구 연동 등)

✅ 요약

항목	설명
MCP 기능	Cursor Agent가 다양한 자동화 명령어를 실행할 수 있도록 툴을 추가
현재 상태	MCP 서버 2개, 총 48개 툴 활성화 중
주의사항	40개 초과 시 일부 모델에서 동작이 불안정할 수 있음
추천 조치	사용하지 않는 MCP 서버 또는 툴 비활성화 고려

Cursor IDE의 Codebase Indexing(코드베이스 인덱싱) 설정 화면입니다.
이 기능은 Cursor가 **코드 전체에 대한 이해도를 높이기 위해 파일을 분석(인덱싱)**하고, AI 모델이 더 정확하고 맥락 있는 답변을 할 수 있도록 돕는 핵심 기능입니다.

🔍 Codebase Indexing란?

Embedding과 메타데이터를 기반으로 프로젝트 전체 구조와 내용을 이해하도록 Cursor에 학습시키는 기능입니다.
즉, 특정 파일만이 아닌 전체 프로젝트 흐름을 AI가 파악하게 됩니다.

📊 상단 상태 정보

Synced (1,930 files)
→ 현재 총 1,930개의 파일이 인덱싱되어 있으며, 100% 동기화 완료 상태입니다.
Resync Index
→ 코드 변경 이후 인덱싱을 다시 수행할 수 있습니다.
Delete Index
→ 인덱스를 제거하여 코드베이스 분석을 초기화할 수 있습니다.

⚙️ 상세 설정 항목

✅ Index new folders by default

새 폴더가 열릴 때 자동으로 인덱싱되도록 설정
비활성화하면 수동으로 Compute Index 버튼을 눌러야 인덱싱됩니다.
단, 50,000개 이상 파일이 있는 폴더는 자동 인덱싱 제외됨

📁 Ignore files

.gitignore 외에도 인덱싱 대상에서 제외할 파일 목록을 추가로 지정할 수 있습니다.
“Configure ignored files” 클릭 시 설정 가능
포함된 전체 파일 목록도 See all included files에서 확인 가능

✅ Git graph file relationships

Git 기록을 바탕으로 파일 간 관계를 분석하여,
“어떤 파일이 다른 파일에 영향을 줬는지”,
“변경 흐름”,
“커밋 단위 구조” 등을 이해시킵니다.
내용:
- 코드는 로컬에 저장되지만,
- 커밋 메타데이터(SHA, 변경 횟수, 이름 난독화 등)는 서버에 저장됨
선택 옵션: default, disabled 등

☁️ 클라우드와 로컬의 역할

코드 자체는 로컬에 저장
임베딩과 메타데이터만 클라우드에 저장
설명 링크: cloud → Cursor 문서 페이지 연결

✅ 요약

항목	설명
인덱싱 목적	AI가 프로젝트 전체를 이해하도록 도와줌
동기화 상태	현재 1,930개 파일이 인덱싱 완료
자동 인덱싱	새 폴더가 열리면 자동 인덱싱 (활성화됨)
무시할 파일 설정	`.gitignore` 외의 무시할 파일 직접 설정 가능
Git 기반 분석	파일 간 관계, 커밋 흐름 분석 가능 (옵션 활성화됨)

Cursor IDE의 Beta features(베타 기능) 설정 화면입니다.
이 화면에서는 아직 정식 출시되지 않았지만 시험적으로 제공 중인 기능들을 설정할 수 있습니다.

🧪 Beta Features

🔁 Update frequency (업데이트 주기)

업데이트를 얼마나 자주 받을 것인지 설정하는 항목입니다.

현재 선택: Standard
옵션 예시:
- Standard – 일반적인 안정된 릴리스
- Early Access – 새 기능을 가장 빠르게 받음 (단, 불안정할 수 있음)

📌 주의: Early Access는 최신 기능을 빠르게 체험할 수 있지만 버그 발생 가능성이 있음

📝 Notepads

✅ 활성화됨

Chat과 Composer 사이에 문맥(Context)을 공유할 수 있게 하는 기능입니다.
예를 들어, 채팅 중 작성한 생각이나 흐름을 Composer 편집기로 바로 연동해 이어갈 수 있음

🐞 Bug Finder

현재 git diff를 기준으로 코드 내 버그를 탐지하는 기능

설명: 변경된 부분에만 초점을 맞춰 AI가 버그를 찾아주는 기능
사용 위치: Cursor 좌측 사이드바의 Bug Finder 탭

🔗 "Check out the Bug Finder tab in the Activity Bar." 문구 클릭 시 해당 탭으로 이동 가능

☁️ Background Agent

클라우드 상에서 에이전트를 실행할 수 있는 기능 (현재 비활성화됨)

설명: 로컬이 아닌 클라우드에서 AI 에이전트를 실행할 수 있게 함
장점: 컴퓨팅 자원을 덜 사용하면서도 지속적인 작업 가능
상태: 아직 베타이므로 실험적 사용 권장

✅ 요약

기능	상태	설명
업데이트 주기	Standard	안정적 버전 유지
Notepads	✅ 활성화	챗 ↔ Composer 간 문맥 공유
Bug Finder	❗ 수동 사용 필요	git diff 기준 버그 탐지 도구
Background Agent	❌ 비활성화	클라우드에서 에이전트 실행 (실험적 기능)

Cursor AI란 무엇인가요?

Cursor의 4가지 핵심 기능

Cursor UI 개요

커서 AI의 핵심: AI 채팅 패널

AI Agent를 사용한 코드 작업 워크플로우

Ask 모드를 사용한 작업 워크플로우

효율적인 컨텍스트 관리

고급 기능

다른 유용한 AI 기능

마무리하며

Cursor IDE의 설정

🔧 좌측 메뉴

📄 오른쪽 설정 세부 내용

✅ Account (계정 정보)

🔄 VS Code Import

🎨 Appearance (화면 스타일 및 동작)

🔒 Privacy mode (개인정보 보호 모드)

🧠 Cursor Tab

🔹 Partial accepts

💬 Suggestions in Comments

⚪ Show whitespace only changes

🔁 Auto Import

🧪 Auto Import for Python (Beta)

✅ 요약

🧠 Chat 설정 전체 설명 (위에서 아래 순서대로)

1. Default new chat mode

2. Chat text size

3. ✅ Auto-refresh chats

4. ✅ Auto-scroll to bottom

5. ✅ Auto-apply to files outside context in Manual mode

6. Include project structure (BETA)

7. Full folder contents

8. Enable auto-run mode

9. Command allowlist

10. Command denylist

11. Delete file protection

12. MCP tools protection

13. ✅ Dot files protection

14. ✅ Outside workspace protection

15. Dialog ‘Don’t ask again’ preferences

16. Collapse input box pills in pane or editor

17. ✅ Iterate on lints

18. Hierarchical Cursor Ignore

19. ✅ Auto-accept diffs

20. Custom modes (BETA)

21. Play sound on finish (BETA)

22. Auto Group Changes (BETA)

23. ✅ Web Search Tool (BETA)

🧾 요약 추천 설정

📝 Docs

✏️ Editor

💻 Terminal

✅ 요약 추천

🔧 Model Names

✅ 선택된 모델 (현재 사용 가능 상태)

⬜ 선택 가능하지만 비활성화된 모델

➕ + Add model

🔐 OpenAI API Key

안내 사항:

🧾 요약 정리

🧠 Rules 란?

👤 User Rules (사용자 규칙)

🏗️ Project Rules (프로젝트 규칙)

📂 Include .cursorrules file

🔚 요약

✍️ 활용 예시

🧠 MCP (Model Context Protocol)란?

⚠️ 경고 메시지

🔧 MCP 서버 목록

🔹 1. taskmaster-ai

🔸 2. task-master-ai (Project Managed)

🛠 주요 기능 예시

📘 상단 버튼

✅ 요약

🔍 Codebase Indexing란?

📊 상단 상태 정보

⚙️ 상세 설정 항목

✅ Index new folders by default

📁 Ignore files

✅ Git graph file relationships

➕ `+ Add model`

🔹 1. `taskmaster-ai`

🔸 2. `task-master-ai (Project Managed)`