Cursor v2.1 기준
IT / AI
Cursor 에이전트 모드, 공식 문서로 확인한 5가지 진짜 작동 조건
에이전트 모드를 쓰는 개발자는 이제 Cursor 사용자 중 다수입니다. 그런데 막상 쓰고 나면 “생각보다 비싸다”, “대화가 길어지면 이상해진다”는 말이 많습니다. 공식 문서에 나와 있는 실제 작동 조건을 그대로 가져와 정리했습니다.
에이전트 모드가 기본이 된 배경 — 수치부터 보면 명확합니다
Cursor 에이전트 모드는 지금 사실상 주력 기능입니다. Cursor 공식 블로그(cursor.com/ko/blog/third-era, 2026.02.26)에 나온 내부 수치를 그대로 보면, 2025년 3월에는 Tab 사용자가 에이전트 사용자보다 2.5배 많았습니다. 그런데 지금은 반대입니다. 에이전트 사용자가 Tab 사용자보다 2배 많습니다. 이 역전은 1년도 안 걸렸습니다.
💡 공식 발표문에 나온 수치와 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다 — Cursor 내부에서 머지되는 PR의 35%는 이미 클라우드 VM 위에서 자율로 동작하는 에이전트가 만들고 있습니다. 즉, Cursor 팀 스스로 에이전트 모드로 Cursor를 개발하고 있다는 뜻입니다.
같은 기간 에이전트 사용량은 15배 이상 증가했습니다. 단순히 “써보는 사람이 늘었다”는 말로 설명하기 어려운 수치입니다. 모델 자체가 더 많은 컨텍스트를 다루고, 더 긴 작업을 이어갈 수 있게 되면서 개발자 습관이 통째로 바뀐 것입니다. (출처: Cursor 공식 블로그 ‘AI 소프트웨어 개발의 세 번째 시대’, 2026.02.26)
에이전트 모드 4가지 — 뭘 언제 써야 하는가
Cursor v2.1 기준으로 에이전트 모드는 4가지입니다. Agent, Ask, Plan, Debug. 대부분은 그냥 Agent 하나만 씁니다. 그런데 공식 문서(cursor.com/ko/help/ai-features/agent)를 보면 각각 쓰는 시점이 명확히 다릅니다.
| 모드 | 가장 적합한 상황 | 파일 직접 편집 |
|---|---|---|
| Agent | 기능 개발, 리팩터링, 버그 수정 | ✅ 예 |
| Ask | 코드 이해, 아키텍처 파악 | ❌ 읽기 전용 |
| Plan | 복잡한 기능, 접근 방식 먼저 검토할 때 | ✅ 계획 승인 후 |
| Debug | 런타임 증거가 필요한 까다로운 버그 | ✅ 예 |
한 가지 놓치기 쉬운 점이 있습니다. 모드를 전환하면 새로운 컨텍스트 창이 시작됩니다. Agent로 한참 대화하다 Plan으로 넘어가면 이전 맥락이 초기화됩니다. 공식 문서에 “최상의 결과를 위해 작업을 바꿀 때는 새 채팅을 시작하라”고 명시돼 있는데, 모르고 쓰면 작업 흐름이 끊깁니다.
모드 전환은 Shift+Tab으로 순환하거나, 패널 드롭다운에서 직접 선택하면 됩니다.
Plan Mode가 없으면 비용이 더 나오는 이유
에이전트 모드에서 Plan 없이 바로 작업을 맡기면 에이전트가 자체 판단으로 코드베이스를 탐색하고, 파일을 열고, 수정을 반복합니다. 이 과정에서 토큰을 예상보다 훨씬 많이 씁니다. Cursor 공식 모범 사례 문서(cursor.com/ko/blog/agent-best-practices, 2026.01.09)는 이렇게 적습니다: “가장 큰 효과를 보는 방법은 코드를 작성하기 전에 먼저 계획을 세우는 것”. 이건 단순히 작업 품질 이야기가 아닙니다. 계획 없이 시작하면 에이전트가 중간에 방향을 잃고 같은 오류를 반복 수정하는 루프에 빠지고, 그 루프가 곧 비용입니다.
💡 “Plan Mode를 쓰면 작업이 느려지지 않을까”라고 생각하기 쉬운데, 실제로는 반대입니다 — 계획 단계에서 방향을 한 번 잡으면 에이전트의 수정 반복 횟수가 줄고, 토큰 사용량이 줄며, 결과물도 더 깔끔하게 나옵니다. 시카고 대학교 연구(Cursor 공식 블로그 인용)에서도 숙련된 개발자는 코드를 생성하기 전에 계획을 세울 가능성이 더 높다고 나왔습니다.
Plan Mode 실제 사용 흐름
Shift+Tab을 누르면 Plan Mode로 전환됩니다. 에이전트가 코드베이스를 탐색한 뒤 추가 질문을 던지고, 파일 경로와 코드 참조가 포함된 구현 계획을 Markdown으로 뽑아줍니다. 승인하기 전까지는 코드를 건드리지 않습니다. 계획을 .cursor/plans/에 저장하면 팀 문서로도 쓸 수 있습니다. v2.1 업데이트(cursor.com/ko/changelog/2-1)에서는 Plan 생성 중 대화형 UI가 추가됐고, ⌘+F로 계획 내부 검색도 됩니다.
대화 길어지면 에이전트가 집중력을 잃는 조건
에이전트 모드를 쓰다 보면 대화를 오래 이어갈수록 뭔가 이상해지는 느낌이 옵니다. 에이전트가 이전에 수정한 파일을 다시 건드리거나, 아까 해결했던 문제를 또 해결하려 합니다. 이건 실제 작동 방식 때문입니다. 대화가 길어질수록 컨텍스트 창에 잡음이 쌓입니다. 요약과 이전 응답이 쌓이면서 에이전트가 지금 무엇이 중요한지 혼동하기 시작하는 것입니다.
💡 Cursor 공식 모범 사례 문서를 보면 “에이전트가 집중력을 잃는다”는 표현을 그대로 씁니다 — 에이전트의 효과가 눈에 띄게 떨어진다고 느껴지면 새 대화를 시작하라고 명시하고 있습니다. 즉, 에이전트 세션 하나를 프로젝트 전체에 걸쳐 끝까지 이어가는 건 권장하지 않는 방식입니다.
새 대화를 시작해야 할 때 vs 이어가야 할 때
공식 문서에 딱 이렇게 나와 있습니다. 다른 기능으로 넘어갈 때, 에이전트가 같은 실수를 반복할 때, 논리적인 작업 단위가 하나 끝났을 때는 새 채팅을 시작하는 게 맞습니다. 반대로 같은 기능을 계속 다듬고 있거나, 방금 만든 것을 디버깅 중이라면 대화를 이어가도 됩니다.
새 대화를 시작할 때 이전 내용을 통째로 복사해 붙여넣는 건 비효율적입니다. @Past Chats를 쓰면 에이전트가 필요한 컨텍스트만 선별해서 가져옵니다. 불필요한 잡음 없이 핵심만 이어받는 방식입니다.
v2.1 기준으로 Instant Grep(베타)가 추가됐습니다. 에이전트가 실행하는 grep 명령이 즉시 완료됩니다. 대화가 길어질 때 코드베이스 탐색 속도가 병목이 되던 문제가 개선된 부분입니다. (출처: cursor.com/ko/changelog/2-1)
요금제별 실효 한도 — $20짜리가 $400이 되는 구조
솔직히 이 부분이 핵심입니다. Cursor 요금제는 현재 취미용(무료), Pro+($60/월), Ultra($200/월), Teams($40/user/월) 구조입니다. (출처: cursor.com/ko/pricing, 2026.03.28 기준) 겉으로 보이는 가격과 실제 사용 비용이 달라지는 조건이 있습니다.
⚠️ 에이전트 모드 + 장시간 컨텍스트 조합에서 실효 비용이 급등합니다
Medium 분석 기사(2026.02.17)에 나온 실측 계산을 그대로 가져왔습니다. Claude Sonnet 4.5 기준으로 단일 에이전트 작업에서 입력 35만 토큰 + 출력 2만 토큰이 발생하면 비용은 약 $1.35입니다. 이전 요청 단가 $0.04와 비교하면 약 34배입니다. 이게 하루에 몇 번씩 반복되면 월 청구서가 달라집니다.
| 요금제 | 월 구독료 | 사용량 배율 | 에이전트 장기 작업 시 추가 비용 |
|---|---|---|---|
| 취미용(Free) | $0 | 제한 | 한도 초과 시 중단 |
| Pro+ | $60/월 | 약 3배 | 초과분 크레딧 별도 과금 |
| Ultra | $200/월 | 약 20배 | 헤비 워크플로 대상 |
| Teams | $40/user/월 | 개별 수준 | 팀 단위 사용량 애널리틱스 제공 |
Hacker News에서 “$350 과금을 일주일 만에 썼다”는 후기가 나왔고, TechCrunch는 Cursor CEO가 불명확한 가격 정책에 대해 공식 사과했다고 보도했습니다. (TechCrunch, 2025.07.07) 5인 팀이 6주 만에 $4,600을 쓴 사례도 공개된 바 있습니다. 이건 Cursor가 나쁜 서비스라는 이야기가 아닙니다. 에이전트 모드를 적극적으로 쓰면 구독료 개념으로 접근해서는 안 된다는 의미입니다.
💡 Auto 모드를 쓰면 Cursor가 비용 효율적인 모델을 자동 선택합니다. 그런데 공식 문서에 “unlimited”는 Auto를 선택했을 때만 조건부로 적용된다고 나와 있습니다. 프런티어 모델을 직접 지정하면 별도 크레딧이 소모됩니다.
비용 폭탄을 피하는 3가지 실전 설정법
공식 문서에 나온 방법과 실제 사용 흐름을 교차해보니 비용을 줄이면서 에이전트 품질을 유지하는 방법이 세 가지로 정리됩니다.
.cursor/rules/ 경로에 Markdown 파일로 프로젝트 규칙을 저장하면, 에이전트가 매 대화마다 같은 내용을 다시 탐색하지 않아도 됩니다. 실행할 빌드 명령, 코드 스타일, 참조할 대표 파일 경로 정도만 적어두면 됩니다. Rules가 없으면 에이전트가 매번 같은 것을 찾아다니며 토큰을 씁니다. 공식 문서에 “에이전트가 같은 실수를 반복할 때만 규칙을 추가하라”고 되어 있지만, 시작부터 최소 빌드 명령은 넣어두는 게 낫습니다.
같은 프롬프트를 여러 모델에 동시에 돌리는 게 Cursor의 병렬 에이전트 기능입니다. 한 모델이 막혔을 때 다른 결과물을 고르면 됩니다. 더 나은 결과를 얻기 위해 에이전트를 같은 문제에 반복 실행하는 것보다 훨씬 효율적입니다. 드롭다운에서 여러 모델을 고르고 한 번에 돌리면 됩니다.
cursor.com/agents에서 클라우드 에이전트를 띄우면 노트북을 닫아도 작업이 진행됩니다. 원격 VM에서 독립적으로 돌기 때문입니다. 그런데 이걸 모든 작업에 쓰면 비용이 커집니다. 공식 모범 사례 문서에서 클라우드 에이전트는 “다른 작업을 하다가 발견한 버그 수정, 테스트 생성, 문서 업데이트” 같은 유형에 맞는다고 나옵니다. 실시간으로 계속 지시해야 하는 작업은 로컬 에이전트가 더 적합합니다.
Q&A
Q1. Cursor 에이전트 모드는 무료로 쓸 수 있나요?
취미용(무료) 플랜에서도 에이전트 요청이 가능하지만 한도가 있습니다. 한도를 초과하면 작업이 중단되고, 계속 쓰려면 유료 플랜으로 전환해야 합니다. 에이전트 모드를 실제로 활용하려면 Pro+($60/월) 이상을 기준으로 생각하는 게 현실적입니다. (출처: cursor.com/ko/pricing, 2026.03.28 기준)
Q2. Plan Mode와 Agent 모드 중 뭘 먼저 써야 하나요?
여러 파일에 걸쳐 작업하거나, 작업 범위가 크다면 Plan Mode로 먼저 계획을 잡은 뒤 Agent로 실행하는 순서가 낫습니다. 단순 버그 수정이나 이미 여러 번 해본 작업은 바로 Agent를 써도 됩니다. (출처: Cursor 공식 에이전트 모범 사례 문서)
Q3. 에이전트가 만든 코드는 믿을 수 있나요?
공식 문서에 “AI가 작성한 코드는 반드시 리뷰가 필요하다”고 명시돼 있습니다. 겉으로 맞아 보이지만 미묘하게 틀릴 수 있다는 점도 공식적으로 인정하는 부분입니다. Agent가 작업을 마친 뒤 Review → Find Issues를 실행하거나, PR에 Bugbot을 연동하면 자동 리뷰를 받을 수 있습니다.
Q4. Sub-agent(하위 에이전트)는 뭔가요?
Cursor 에이전트는 리서치, 셸 명령, 브라우저 상호작용 같은 특화 작업을 처리하기 위해 하위 에이전트를 병렬로 실행할 수 있습니다. 각 하위 에이전트는 자체 컨텍스트 창에서 실행되고 결과를 메인 대화로 반환합니다. .cursor/agents/ 경로에 Markdown 파일을 추가해 직접 만들 수도 있습니다.
Q5. 비용이 갑자기 많이 나오는 걸 어떻게 확인하나요?
Settings → General → Manage Account → Billing & Invoices에서 현재 사용량과 청구 내역을 확인할 수 있습니다. Teams 플랜에서는 사용량 애널리틱스 대시보드가 별도로 제공됩니다. 에이전트를 적극적으로 쓴다면 Auto 모드를 기본으로 두고, 프런티어 모델은 필요할 때만 지정하는 방식이 비용 관리에 효과적입니다.
마치며
Cursor 에이전트 모드는 분명히 강력합니다. Tab 중심으로 쓰던 개발자들이 1년 안에 에이전트 중심으로 넘어온 데는 이유가 있습니다. 그런데 막상 쓰다 보면 “이게 이렇게 비용이 나오나?”라는 당혹감을 먼저 겪는 경우가 많습니다.
이 글에서 정리한 내용의 핵심은 결국 하나입니다. 에이전트 모드를 쓴다는 건 구독 서비스를 쓰는 게 아니라 클라우드 인프라를 돌리는 것과 비슷한 감각으로 접근해야 한다는 점입니다. Plan Mode로 먼저 방향을 잡고, Rules를 만들어 불필요한 탐색을 줄이고, 대화 단위를 적절히 끊어가는 것. 이 세 가지만 챙겨도 비용과 결과물 품질이 동시에 나아집니다.
주관적으로 보면, 에이전트 기반 개발 흐름이 완전히 자리를 잡으려면 아직 넘어야 할 부분들이 있습니다. Cursor 스스로 “산업 규모에서는 불안정한 테스트 하나가 모든 에이전트 실행을 중단시킨다”고 공식 블로그에서 인정했습니다. 지금은 그 과도기입니다. 그래도 지금 당장 쓸 수 있는 것 중 가장 실용적인 선택지인 건 변함이 없습니다.
본 포스팅 참고 자료
- Cursor 공식 — Agent 모드 헬프 문서 (cursor.com/ko/help/ai-features/agent)
- Cursor 공식 블로그 — AI 소프트웨어 개발의 세 번째 시대 (cursor.com/ko/blog/third-era)
- Cursor 공식 블로그 — 에이전트와 함께 코딩할 때의 모범 사례 (cursor.com/ko/blog/agent-best-practices)
- Cursor 공식 Changelog 2.1 (cursor.com/ko/changelog/2-1)
- TechCrunch — Cursor apologizes for unclear pricing changes (2025.07.07)
- Medium — When Cursor silently raised their price by over 20× (2026.02.17)
본 포스팅은 2026년 3월 28일 기준 Cursor v2.1 공식 문서와 공식 블로그를 참고해 작성했습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능·요금이 변경될 수 있습니다. 최신 정보는 cursor.com 공식 페이지에서 확인하세요.
댓글 남기기