1. 개요 📦
Cursor는 Anysphere Inc.에서 개발한 AI 기반 코드 에디터로, Visual Studio Code 기반 인터페이스에 자연어 기반 코드 생성, 자동 완성, 코드베이스 질문 등 AI 기능이 통합되어 있습니다X (formerly Twitter)+8Cursor+8GitHub+8.
- AI가 코드 컨텍스트를 이해하고 다음 편집을 예측합니다
- 자연어 지시(prompt)로 함수나 클래스 생성, 수정 가능
- 전체 코드베이스를 색인하여 질문 기반 참조가 가능
- “Privacy Mode” 활성화 시 코드가 원격으로 저장되지 않으며 SOC 2 인증을 받아 보안 수준도 확보됨위키백과+1
2. 설치 및 처음 시작하기
- 다운로드: 공식 페이지에서 Windows / macOS / Linux용 설치 파일 다운로드위키백과CursorMedium
- 설치 및 실행: 설치 프로그램 실행 → 로그인 또는 회원가입 → 자동으로 일부는 VS Code 설정(테마, 키바인딩 등) 가져오기 옵션 제공
- 요구사항:
3. 핵심 기능 소개
▶ Tab 자동 완성
▶ Inline Edit
- 코드 블록 선택
-
Ctrl+K
입력 - “make this function calculate Fibonacci”처럼 자연어로 지시 입력
- Cursor가 해당 기능을 생성하거나 수정, 문서화까지 자동 처리Cursor
▶ Agent 채팅
-
Ctrl+I
키로 채팅 패널 열기 - 예: “Add tests for this function and run them” 입력
- Cursor가 테스트 파일 생성 → 코드 작성 → 실행 및 결과 반영까지 처리Cursor+1
▶ Background Agent (백그라운드 에이전트)
-
Ctrl+E
로 백그라운드 에이전트 패널 열기 - 예: “Find and fix bugs” 등 지시 시 VM 생성, 코드 탐색, 버그 제안 및 수정 포함
- 복잡한 작업을 자동으로 수행하고 결과 리뷰 가능Cursor
4. 규칙(Rules) 및 프로젝트 관리
Cursor 규칙(.cursor/rules
)
-
.cursor/rules/
디렉토리에.mdc
형식으로 저장 - 프로젝트 특화 코드 스타일, 아키텍처 규칙, 워크플로우 자동화 등에 사용Cursor+1
규칙 종류
- Project Rules: 프로젝트별, 버전 제어됨
- User Rules: 사용자 전체에 적용
- Auto‑attached, Always Apply, Agent Requested, Manual 등 다양한 동작 방식 설정 가능Cursor
5. 고급 사용 팁 & 모범 사례
🔧 YOLO 모드
- 설정에서 YOLO 모드 활성화
- 프롬프트에 허용/거부 명령 및 테스트 허용 목록 정의
- Cursor가 테스트, 빌드, 디렉토리 생성 등을 자동 실행하며 오류 없을 때까지 반복 수정Builder.io
✅ 테스트 주도 개발
- AI에게 먼저 테스트 작성 → 코드 작성 → 테스트 통과까지 자동 반복 요청 가능
- 반복적 요약과 자가 검증용 코드 품질 확보 방식Builder.io
📁 instructions.md와 workflow_state.md 활용
-
instructions.md
: 워크플로우 목적 및 제약 조건 명시 -
workflow_state.md
: 단계별 계획, 상태, 로그 저장 구조 - Cursor가 자동 흐름 계획 기반 작업 수행 가능forum.cursor.com+1
💡 .cursorrules
파일 & Notepad 활용
-
프로젝트마다
.cursorrules
에 일관된 스타일이나 처리 규칙 정의 - Chat에서 반복할 프롬프트나 설명을 Notepad에 저장, 재사용 기능 추천Reddit+1
6. 빠른 시작 가이드 (Quickstart)
-
Git 설치 후 예제 리포지토리 복제 및 Cursor 실행
bash복사편집
git clone git@github.com:voxelize/voxelize.git cd voxelize cursor .
- Tab으로 자동 완성
-
Inline Edit (
Ctrl+K
)으로 코드 기능 변경 -
Agent Chat (
Ctrl+I
)으로 테스트 생성 및 실행 -
Background Agent (
Ctrl+E
)를 통한 오토 버그 탐지 및 수정Cursor
7. 참고 및 추천 학습 자료
- Cursor 공식 문서: Welcome, Quickstart, Rules 등 각 기능에 대한 상세 설명Cursor+2Cursor+2
-
Reddit 커뮤니티의 사용 후기와 팁 공유:
.cursorrules
, Notepad 사용법 등Cursor - 블로그 및 활용 사례: YOLO 모드, 자동 테스트 전략 등Builder.io
8. 요약 테이블
항목 | 설명 |
---|---|
설치 지원 OS | Windows, macOS, Linux |
핵심 기능 | Tab 자동완성, Inline Edit, Agent Chat, Background Agent |
코드베이스 이해도 | 전체 색인, 자연어 질의 |
규칙 시스템 | .cursor/rules , 프로젝트/사용자 규칙 |
고급 기능 | YOLO 모드, 테스트 주도 개발, instructions.md 워크플로 |
보안 및 개인정보 | Privacy Mode, SOC 2 인증 |