본문 바로가기
AI

Cursor AI 가이드: Agent, Plan, Debug, Ask 모드 차이점과 모델 선택 팁

by devdrawer 2026. 3. 4.

Cursor AI, 모드가 왜 이렇게 많나요?

최근 개발자들 사이에서 가장 핫한 에디터인 Cursor AI를 쓰다 보면, 채팅창 하단에 있는 여러 가지 모드 때문에 당황할 때가 있습니다. "그냥 코드 짜달라고 하면 되는 거 아닌가?" 싶지만, 각 모드의 성격을 이해하면 작업 효율이 2배 이상 올라갑니다.

이 모드들의 차이는 마치 '요리 전문팀'의 역할 분담과 같습니다. 상황에 따라 어떤 전문가를 불러야 할지 아래 비유를 통해 쉽게 알아봅시다.

💡 핵심 비유:
  • Ask: 레시피를 물어보는 질문 답변가 (읽기 전용)
  • Plan: 요리 시작 전 순서를 짜는 전략가 (설계 우선)
  • Agent: 직접 칼을 들고 요리하는 메인 셰프 (코드 자동 수정)
  • Debug: 탄 맛의 원인을 찾아 고치는 분석가 (버그 추적)


1. 4가지 모드 상세 비교

① Ask 모드 (지식 탐색)

Ask 모드는 코드를 수정하지 않고 오직 '답변'만 합니다. "이 함수가 무슨 일을 해?", "이 프로젝트 구조 좀 설명해줘" 같은 질문에 최적화되어 있습니다. 기존 코드를 망칠까 봐 걱정될 때 가장 안전하게 사용할 수 있는 모드입니다.

② Plan 모드 (전략 수립)

Plan 모드는 복잡한 기능을 구현하기 전에 '설계도'를 먼저 그리는 단계입니다. 바로 코드를 작성하지 않고, "어떤 파일을 수정할지", "어떤 로직으로 짤지" 먼저 제안합니다. 사용자가 이 계획을 승인하면 그때 코드로 옮기기 때문에 대규모 리팩토링이나 신규 기능 구현 시 실수를 줄여줍니다.

③ Agent 모드 (자동 실행)

Cursor의 꽃이라 불리는 Agent 모드는 가장 강력합니다. 스스로 파일을 읽고, 코드를 작성하고, 심지어 터미널 명령어를 실행해 테스트까지 진행합니다. 마치 숙련된 주니어 개발자에게 업무를 통째로 맡기는 것과 같습니다.

④ Debug 모드 (오류 해결)

Debug 모드는 버그 해결에 특화되어 있습니다. 단순히 코드를 고치는 게 아니라, 오류의 원인을 찾기 위해 로그를 심거나 가설을 세워 테스트합니다. 원인을 알 수 없는 에러가 발생했을 때 '해결사'로 투입하면 제격입니다.


2. Search Models: 어떤 모델을 써야 할까?

모드만큼 중요한 것이 바로 AI 모델(Brain)의 선택입니다. 현재 Cursor에서는 다음과 같은 모델들을 선택할 수 있습니다.

모델명 특징 추천 모드
Claude 3.5 Sonnet 코딩 실력이 가장 뛰어나고 빠름 Agent, Debug
GPT-4o 범용적인 논리력이 좋음 Ask, Plan
o1-preview / mini 추론 능력이 압도적 (생각하는 AI) Complex Debug, Plan

팁: 'Auto' 설정을 사용하면 Cursor가 작업의 복잡도에 따라 적절한 모델을 자동으로 골라주기도 합니다.


3. 한눈에 보는 상황별 모드 선택표

  • 단순히 코드를 이해하고 싶을 때 → Ask
  • 새로운 기능을 어떻게 만들지 고민될 때 → Plan
  • 반복적인 코딩 작업을 빨리 끝내고 싶을 때 → Agent
  • 에러 메시지가 왜 뜨는지 도무지 모를 때 → Debug

이제 상황에 맞는 모드 선택으로 더 스마트한 개발 라이프를 즐겨보세요!