Cursor Custom Mode 완벽 가이드

AI 코드 에디터 Cursor는 기본적으로 Agent, Ask, Manual 모드 등 다양한 AI 지원 모드를 제공하지만, 최근에는 사용자의 워크플로우에 맞춰 AI의 동작과 도구, 프롬프트를 직접 커스터마이즈할 수 있는 Custom Mode(커스텀 모드) 기능을 베타로 도입했습니다. 이 글에서는 Custom Mode의 개념, 설정 방법, 활용 예시, 그리고 실전 팁까지 한 번에 정리합니다.

Custom Mode란?

Custom Mode는 Cursor에서 제공하는 다양한 AI 도구와 프롬프트(지침)를 조합해, 나만의 맞춤형 AI 모드를 만드는 기능입니다. 예를 들어, 코드 리팩터링에만 집중하는 모드, 학습/설명에 특화된 모드, 대담하게 자동 적용하는 YOLO 모드 등, 목적에 따라 AI의 행동과 사용 도구를 세밀하게 제어할 수 있습니다.

기본 제공 모드: Agent, Ask, Manual
Custom Mode: 사용자가 직접 도구, 프롬프트, 단축키, 아이콘 등을 조합해 생성

Custom Mode는 현재 베타 기능이며, 향후 더 많은 설정 옵션과 파일 기반 공유(.cursor/modes.json)도 지원될 예정입니다.

Custom Mode 활성화 방법

설정 진입: Settings → Features → Chat → Custom modes에서 Custom Mode 기능을 활성화합니다.
모드 추가: 채팅 모드 메뉴에서 Add custom mode를 클릭합니다.
세부 설정:
- 이름, 아이콘, 단축키 지정
- 사용할 도구(예: Search, Edit, Terminal 등) 선택
- Custom Instructions(프롬프트) 입력
저장 및 사용: 생성한 모드는 기존 모드와 동일하게 선택해 사용할 수 있습니다.

향후 .cursor/modes.json 파일을 통해 프로젝트별로 모드를 정의/공유하는 기능도 추가될 예정입니다.

Custom Mode 예시

아래는 공식 문서와 커뮤니티에서 추천하는 Custom Mode 예시입니다.

👨‍🎓 Learn Mode (학습/설명 특화)

도구: 모든 Search
프롬프트: "개념을 자세히 설명하고, 해결책 제시 전 반드시 추가 질문을 해주세요."

🔄 Refactor Mode (리팩터링 전용)

도구: Edit & Reapply
프롬프트: "기존 코드 구조 개선에만 집중하고, 새로운 기능 추가는 하지 마세요."

📝 Plan Mode (계획 수립)

도구: Codebase, Read file, Terminal
프롬프트: "구현 계획만 작성하고, 직접 코드는 수정하지 마세요. 결과는 plan.md에 정리하세요."

📚 Research Mode (정보 수집)

도구: Codebase, Web, Read file, Search files
프롬프트: "여러 소스에서 충분히 정보를 수집한 뒤에만 솔루션을 제안하세요."

💥 Yolo Mode (자동 적용/대담한 변경)

도구: 모든 도구 + Auto-apply, Auto-run 활성화
프롬프트: "최소한의 확인만 받고, 적극적으로 변경을 적용하세요."

🐛 Debug Mode (디버깅 집중)

도구: Search, Terminal, Edit & Reapply
프롬프트: "문제 원인을 충분히 조사한 뒤, 정확한 수정만 제안하세요."

실전 활용 팁

목적별로 모드를 나눠 사용: 예를 들어, 코드 리뷰, 문서화, 리팩터링, 학습 등 목적별로 Custom Mode를 만들어두면 AI의 답변 품질과 효율이 크게 향상됩니다.
팀 내 공유: 향후 .cursor/modes.json 파일이 지원되면, 팀원들과 동일한 Custom Mode를 공유해 일관된 개발 문화를 만들 수 있습니다.
프롬프트 최적화: Custom Instructions에 팀의 개발 규칙, 코드 스타일, 커뮤니케이션 방식 등을 명확히 적어두면 AI가 더욱 일관성 있게 동작합니다.
도구 제한: 불필요한 도구를 제외하면, AI가 더 집중적으로 원하는 작업만 수행하도록 유도할 수 있습니다.