HowtoAI
ai-tools2026-05-07 5 min read

Cursor 3.0 Agents Window 사용법 — 병렬 에이전트로 PR 자동화 7가지

🤖
HowtoAI 편집팀AI 전문 에디터

AI 기술을 누구나 쉽게 활용할 수 있도록 실전 가이드를 작성합니다. ChatGPT, Claude, AI 자동화, SEO 분야를 전문으로 다룹니다.

📅 2026-05-07⏱️ 5 min read🌐 how-toai.com
목차 보기

3월에 Cursor 2.x 쓰다가 3.0 업데이트 받고 나서 작업 흐름이 완전히 바뀌었어요. 가장 큰 변화는 Agents Window 추가. 같은 리팩터링 작업을 Claude Opus 4.8과 GPT-5.5에 동시에 던져서, 30분 후 둘 다 결과 보고 더 깔끔한 쪽만 머지하는 식이거든요.

결론부터 말하면 Agents Window의 값어치는 "모델을 여러 개 쓴다"가 아니라 git worktree 자동 분기에 있어요. 두 에이전트가 같은 파일을 수정해도 충돌이 안 나요. 각자 별도 브랜치(checkout)에서 돌거든요. 다만 크레딧은 띄운 에이전트 수만큼 배로 나가니까, 어떤 작업에 병렬을 쓰고 어떤 작업에 안 쓰느냐가 실제 비용을 가릅니다.

이 글은 직접 한 달 써본 뒤 정리한 7가지 실전 워크플로우예요. Pro $20·Pro+·Ultra $200 중 뭐가 본인한테 맞는지도 실제 크레딧 소모량 기준으로 정리했어요.

Cursor 3.0 코드 에디터 화면 — Agents Window가 우측 사이드바에 도킹된 상태

Cursor 3.0 핵심 변화 3가지 (2026년 4월 기준)

3.0 출시 노트에서 반드시 알아야 할 변화만 추렸어요.

1. Agents Window — 병렬 에이전트 사이드바

기존 채팅창 옆에 Agents Window 패널이 새로 생겼어요. 여기서 에이전트 여러 개를 동시에 돌릴 수 있어요. 각 에이전트는 별도 git worktree에서 작동해서 파일 충돌 0%. 작업 끝나면 패널에서 diff 보고 하나만 main에 머지.

저는 보통 동시에 2~3개 돌려요. 에이전트마다 램을 따로 먹어서, 더 늘리면 램이 넉넉하지 않은 노트북에서는 눈에 띄게 버벅댔어요.

2. /worktree 명령어 — 채팅 분리

채팅 도중 /worktree feature-x 입력하면 나머지 대화가 별도 checkout에서 진행돼요. 메인 작업 하다가 "잠깐, 이건 다른 브랜치에서 실험해보자" 할 때 컨텍스트 안 잃어요. 끝나면 그 worktree만 PR 올리면 돼요.

3. /best-of-n — 같은 작업 N개 모델 동시 실행

/best-of-n 3 "이 함수를 더 효율적으로 리팩터링해줘" 입력하면 모델 3종이 같은 작업을 병렬로 처리. 결과 3개 비교 후 최선만 채택.

저는 테스트 코드 작성문서 생성에 주로 써요. 모델별 스타일 편차가 크거든요. Claude는 테스트 케이스가 꼼꼼하고, GPT는 문서가 자연스럽고, Gemini 3 Flash는 짧고 단순해요. 작업 성격 따라 채택하면 돼요.

Cursor 3.0 가격 6단계 — 본인한테 맞는 플랜 고르기

2025년 중반에 요청 쿼터(request quota) 모델에서 크레딧 풀 모델로 전환됐어요. 한 달에 쓸 수 있는 토큰 양이 달러로 환산돼서 풀에 들어 있고, 모델별로 다르게 차감되는 구조.

플랜가격크레딧 풀추천 대상
Hobby무료매우 제한가입만, 실사용 X
Pro$20/월$20어치주 5~10시간 코딩, 1인 개발자
Pro+$60/월$60어치 (3배)주 20시간+, 병렬 에이전트 자주
Ultra$200/월거의 무제한풀타임 + 대형 코드베이스
Teams$40/사용자팀 공유 풀5인 이상 스타트업
Enterprise커스텀협상50인+, SSO·감사 로그

저는 Pro 일주일 쓰다 풀 다 떨어져서 Pro+로 옮겼어요. 병렬 에이전트가 크레딧 3배 빨리 쓰는 게 결정적이었어요. /best-of-n 5번 정도만 돌려도 Pro 풀 1/3이 사라져요.

7가지 실전 워크플로우 — 한 달 직접 써본 결과

워크플로우 1. 리팩터링은 /best-of-n 3로 모델 비교

복잡한 함수 하나를 리팩터링할 때 무조건 3 모델 병렬로 돌려요. 명령어:

/best-of-n 3 src/utils/parser.ts 의 parseInput 함수를 더 효율적이고 타입 안전하게 리팩터링.
사이드 이펙트 없이, 기존 테스트 모두 통과하도록.

결과가 도착하면 diff 보고 가장 깔끔한 거 선택. 체감: 모델을 하나씩 순서대로 돌려 비교할 때보다 확실히 빨라요. 크레딧: 띄운 에이전트 수만큼 더 나가요. 모델마다 토큰 단가가 달라서 정확히 몇 배인지는 그때그때 달라지고요.

워크플로우 2. PR 자동화 — Agent 모드 + GitHub MCP

Agents Window에서 에이전트 하나를 background mode로 돌려요. GitHub MCP 서버 연결하고 프롬프트:

오픈된 PR #234 을 검토. 코드 스타일·잠재적 버그·테스트 커버리지 체크 후
인라인 커멘트 작성. 변경 큰 이슈는 별도 issue 생성.

이렇게 하면 PR 코멘트가 자동으로 달려요. 손으로 하나씩 훑을 때보다 리뷰 회전이 확 빨라져요. 백그라운드 에이전트를 더 파고들고 싶으면 Cursor 멀티태스크·백그라운드 에이전트 7가지 활용 패턴에 실행 중 관리법이 더 자세히 있어요.

워크플로우 3. 테스트 작성은 GPT-5.5 단독

테스트 케이스는 GPT-5.5 한 모델만 쓰는 게 효율 좋아요. Claude·DeepSeek 결과가 너무 비슷해서 /best-of-n 의미 없음. 대신 단일 모델로 컨텍스트 길게 쓰는 게 더 좋음.

@codebase 의 src/services/auth/ 모듈 전체 분석 후
Vitest 단위 테스트 작성. 커버리지 90% 목표.
모든 edge case 포함, mock는 vi.mock 사용.

워크플로우 4. 문서 생성은 Claude Opus 4.8

API 문서·README·주석 보강은 Claude Opus 4.8 이 잘해요. 한국어 문체가 자연스럽고 기술 용어도 정확하게 잡아요.

저는 OpenAPI 스펙 → 한국어 README 변환에 자주 써요. 1500자 분량을 30초에 뽑아내고, 거의 손 안 대요.

워크플로우 5. 코드베이스 통째 리뷰 — Gemini 3.1 Pro 대용량 컨텍스트

전체 모놀리스 리뷰는 Gemini 3.1 Pro 가 편해요. 컨텍스트 창이 넉넉한 축이라 파일을 한 번에 여러 개 밀어 넣어도 잘 안 잘려요.

@codebase 전체 분석. 다음 관점에서 개선 제안 5개:
1. 성능 병목 의심 지점 2. 타입 안전성 약한 부분
3. 테스트 미커버 비즈니스 로직 4. 보안 위험 5. 데드 코드

크레딧 많이 먹지만(한 번에 ~$2~3), 분기에 1번 돌리면 큰 그림 잡혀요.

워크플로우 6. /worktree 로 실험 분기 분리

한참 작업하다가 "이거 다른 라이브러리로 바꿔보면 어떨까" 싶을 때 /worktree experiment-zod-to-valibot 입력. 그 시점부터 새 worktree에서 대화 진행. 메인 작업 컨텍스트 그대로 유지되고, 실험 끝나면 PR 만들거나 버리거나.

이거 하나만으로 작업 흐름 분리가 매우 깨끗해요.

워크플로우 7. MCP는 코어 5개만 — 40 ceiling 회피

처음에 욕심내서 MCP 서버 12개 등록했다가 도구 60개 넘어서 끊겼어요. 지금은 코어 5개만:

  1. Filesystem (파일 읽기/쓰기) — 8 tools
  2. Git (브랜치·커밋·diff) — 6 tools
  3. GitHub (PR·이슈·리뷰) — 9 tools
  4. Memory (장기 컨텍스트) — 4 tools
  5. Brave Search (웹 검색) — 2 tools

합계 29 tools, 11 여유. 프로젝트별로 더 필요하면 .cursor/mcp.json 에 추가.

Cursor Agents Window에서 병렬로 돌아가는 에이전트 진행률 표시

모델별 토큰 단가 — 크레딧 효율 비교 (2026년 5월)

같은 작업을 어느 모델에 던지냐에 따라 크레딧 소모가 크게 차이나요.

모델크레딧 소모컨텍스트추천 작업
Claude Opus 4.8높음넉넉함문서·복잡 리팩터링·아키텍처
Claude Sonnet 4.6보통넉넉함일상 코딩·리뷰
Gemini 3.1 Pro보통매우 넉넉함코드베이스 전체 분석
Gemini 3 Flash낮음넉넉함단순 변환·반복 작업

표의 크레딧 소모는 네 모델을 서로 견준 상대적 위치예요. 세대가 바뀌면서 플래그십 단가가 예전만큼 부담스럽지 않아진 구간도 있으니, "플래그십은 무조건 비싸다"는 인상만으로 피하고 있었다면 각 모델의 공식 가격 페이지에서 다시 계산해보세요. 컨텍스트를 길게 넣는 요청은 구간에 따라 단가가 달라지는 경우도 있어서, 예산을 잡을 때 그 부분까지 함께 확인하면 계산이 정확해져요.

: 단순 변수명 변경·import 정리 같은 자잘한 일은 Gemini 3 Flash 로 충분해요. 크레딧이 10분의 1이에요. 모델 단가는 자주 바뀌니 결제 전 각 공식 가격 페이지에서 최신 확인하세요. 다른 IDE 대안이 궁금하면 Cursor Composer 2.5 vs Windsurf SWE-1.5 가격·속도 7가지 테스트를 함께 보면 비교가 빨라요.

크레딧 절감 5가지 실전 팁

1. 시스템 프롬프트로 모델 자동 선택 가이드

.cursor/rules/01-model-selection.md 에 작성:

- 단순 변환/import 정리: gemini-3-flash 사용
- 테스트 코드: gpt-5.5 사용
- 문서·복잡 리팩터링: claude-opus-4-8 사용
- 코드베이스 전체 분석: gemini-3.1-pro 사용

이렇게 두면 Cursor가 작업 성격 보고 자동으로 모델 추천. 풀 자동은 안 되고 모델명 클릭 한 번으로 바뀜.

2. /summarize 로 컨텍스트 압축

긴 채팅 30분 넘으면 컨텍스트가 무거워서 토큰 단가 올라요. /summarize 한 번 돌리면 핵심만 요약, 그 시점부터 새 대화 흐름. 인풋 토큰이 눈에 띄게 줄어요.

3. @codebase 대신 @file 명시

@codebase 호출하면 전체 인덱스 로드해서 토큰 폭증. 특정 파일만 필요하면 @file:src/utils/parser.ts 명시.

4. Background mode 활용

Agents Window 의 background mode 토글 켜면 실시간 응답 안 받고 백그라운드 처리. 즉시 응답을 포기하는 대신 크레딧 부담이 줄어드는 구조예요. 단 결과를 받기까지 한참 기다려야 해요. 할인 여부와 폭은 요금 정책에 따라 달라지니 공식 안내에서 확인하세요.

5. /best-of-n 은 정말 중요한 결정에만

매번 /best-of-n 3 돌리면 크레딧 3배 빨리 사라져요. 리팩터링·아키텍처 결정 같이 한 번 정하면 영향 큰 작업에만 사용. 자잘한 건 단일 모델.

흔한 실수 5가지 — 한 달 쓰면서 깨진 것들

실수 1. Pro $20 으로 시작했다 일주일 만에 풀 다 씀

병렬 에이전트 신기해서 매일 /best-of-n 5번씩 돌렸더니 5일째 풀 0. 처음 한 달은 Pro+ $60 으로 시작 권장.

실수 2. MCP 12개 등록 → 40 ceiling 충돌

도구 갯수 안 세고 다 켜놨더니 "Tools exceed 40 limit" 에러. 코어 5개로 줄임.

실수 3. /worktree 안 쓰고 메인 채팅에서 실험

실험적인 변경을 메인 채팅에서 하다가 컨텍스트 더러워짐. /worktree 로 분리했어야.

실수 4. 모든 모델에 /best-of-n — 싼 모델 결과는 보통 별로

Gemini 3 Flash 는 단가가 압도적으로 싸지만, 복잡한 리팩터링은 Opus 4.8·GPT-5.5 가 훨씬 나아요. 작업 성격 안 보고 모든 모델에 다 던지는 건 낭비예요.

실수 5. background mode 안 쓰고 batch 작업 실시간 처리

긴 작업(전체 코드베이스 분석 등)은 background mode 로 돌려야 크레딧이 덜 나가요. 실시간 응답이 그렇게 중요하지 않으면 무조건 background.

3.5 업데이트 — Cloud Agents가 바꾼 것

이 글을 처음 쓴 건 5월 초인데, 그 뒤 Cursor 3.5 가 나오면서 병렬 흐름이 한 번 더 바뀌었어요. 핵심은 Cloud Agents 예요.

3.0 의 병렬 에이전트는 내 노트북 자원을 나눠 썼어요. 그래서 위에서 "2~3개까지"라고 적은 거예요. 에이전트마다 램을 따로 잡아먹으니까요. 3.5 의 Cloud Agents 는 격리된 클라우드 VM 에서 돌아요. 터미널·브라우저까지 붙은 완전한 환경이라, 내 RAM 과 무관하게 여러 개를 띄울 수 있어요.

실제로 달라지는 지점은 세 가지예요.

항목3.0 로컬 에이전트3.5 Cloud Agents
동시 실행RAM 한계로 2~3개훨씬 여유 있음
내 PC 부하에이전트당 램 점유 큼거의 없음
노트북 닫으면중단계속 진행
적합한 작업빠른 반복·디버깅긴 리팩터링·전체 테스트

저는 지금 긴 작업은 Cloud, 짧은 반복은 로컬로 나눠 써요. 전체 테스트 스위트 고치기 같은 30분짜리는 Cloud 에 던져놓고 노트북 덮고 나가요. 반대로 5분 안에 결과 보고 바로 다시 지시할 작업은 로컬이 왕복이 빨라요.

주의: Cloud Agents 는 Pro($20) 플랜에도 포함돼요. 다만 크레딧은 똑같이 나가요. "클라우드니까 공짜"가 아니라 내 RAM 만 아끼는 것이라고 이해하시면 정확해요.

자가진단 — 나는 Pro·Pro+·Ultra 중 어디인가

아래 5개 중 몇 개에 해당하는지 세보세요.

  1. 주 20시간 넘게 코딩한다
  2. /best-of-n 을 주 3회 이상 쓸 것 같다
  3. 코드베이스가 파일 500개를 넘는다
  4. 긴 작업을 Cloud Agents 로 자주 돌릴 생각이다
  5. 월 청구서가 $60 넘어도 시간이 더 아깝다
  • 0~1개 → Pro $20: 단일 모델 위주로 쓰면 한 달 버텨요
  • 2~3개 → Pro+: 3배 풀. 병렬을 습관적으로 쓰면 여기가 손익분기점이에요
  • 4~5개 → Ultra $200: 대형 코드베이스 풀타임이면 결국 여기로 와요

저는 3번·4번이 걸려서 Pro+ 에 정착했어요. 플랜 구성과 가격은 바뀌니 결제 전 Cursor 공식 가격 페이지에서 최신 확인하세요.

마무리 — 지금 IDE를 고민한다면

Agents Window 의 값어치는 "AI 가 코드를 대신 짜준다"가 아니에요. 같은 문제에 대한 서로 다른 답을 나란히 놓고 내가 고르는 것이에요. 이 차이가 중요한 이유는, 모델 하나만 쓰면 그 모델이 틀렸을 때 틀린 줄 모르고 머지하기 때문이에요.

지금 IDE 고민 중이라면 Pro+ 한 달만 써보고 결정하세요. 첫 달은 풀을 다 못 써도, 두 번째 달부터 병렬 흐름이 익숙해지며 제 값을 해요.

AI 코딩 도구 자체가 처음이라면: AI 코딩 에이전트 순위 2026 — Claude Code·Cursor·Codex 실사용 비교로 전체 판을 먼저 훑고 오는 게 나아요. 도구별 성격을 알고 나면 Cursor 의 슬래시 명령어 체계가 훨씬 빨리 붙어요.

❓ 자주 묻는 질문 (FAQ)

Cursor 3.0의 Agents Window는 기존 Composer와 뭐가 다른가요?

Composer는 한 번에 한 작업을 한 모델에게 시키는 구조였는데, Agents Window는 같은 작업을 여러 에이전트가 병렬로 git worktree 위에서 돌리는 구조예요. 예를 들어 리팩터링 하나를 Claude Opus 4.8·GPT-5.5·Gemini 3 Flash 세 모델에 동시에 던지고, 가장 깔끔한 결과만 PR로 머지할 수 있어요. 여러 개를 동시에 띄울 수 있어서, 순서대로 돌릴 때보다 대기 시간이 줄어요. 단 크레딧은 띄운 수만큼 배로 나가요.

Pro $20 플랜에서도 Agents Window 다 쓸 수 있나요?

Pro에서 기본 기능은 다 쓸 수 있어요. 다만 Pro는 크레딧 풀 $20어치라 병렬 에이전트 몇 번 돌리면 금방 소진. 헤비 유저는 Pro+ $60(3배 풀) 또는 Ultra $200을 써야 해요. 저는 처음에 Pro 쓰다 일주일 만에 풀 다 쓰고 Pro+로 옮겼어요.

/best-of-n 명령어는 정확히 어떻게 동작하나요?

/best-of-n 3 prompt 형태로 입력하면 같은 프롬프트를 모델 여러 개에 동시 실행해요. 몇 개까지 걸 수 있는지는 버전에 따라 달라지니 공식 문서에서 확인하세요. 각 결과는 별도 worktree(브랜치)에 저장되고, 사이드바에서 diff 비교 후 채택할 결과 하나만 main에 머지. 코드 품질이 모델별로 편차 큰 작업(테스트 작성·문서 생성)에 효과적이에요.

기존 VSCode 단축키는 그대로 쓸 수 있나요?

Cursor는 VSCode fork라 단축키 99% 호환돼요. Cmd+P, Cmd+Shift+P, 멀티 커서, 익스텐션까지 그대로. 단 Agents Window 호출은 신규 단축키 Cmd+Shift+A. /worktree·/best-of-n 같은 슬래시 명령어는 채팅 입력창에서 / 누르면 자동완성 떠요.

MCP 도구 40개 제한이 있다는데 실제로 부딪히나요?

기본 MCP 서버 5~6개(Filesystem·Git·Brave Search·Memory 등) 쓰면 도구가 25~30개 정도라 여유 있어요. 다만 Slack·Linear·Notion·Postgres 풀 세팅하면 50개 넘어가서 끊겨요. 해결법 ① 자주 쓰는 도구만 enabled: true 명시 ② cursor.mcp.json에 server별로 토글 ③ 프로젝트별 .cursor/mcp.json 분리. 40 ceiling은 단일 컨텍스트 안에서 한 번에 노출되는 도구 수 제한.

📚 함께 읽으면 좋은 글 (Related Posts)

AI 도구 추천 더 보기 →
구글 AI 개요 끄는 법 — 공식 도움말은 '사용 중지할 수 없다'고 적어요, 대신 되는 세 가지
ai-tools2026-08-10

구글 AI 개요 끄는 법 — 공식 도움말은 '사용 중지할 수 없다'고 적어요, 대신 되는 세 가지

구글 AI 개요를 끄는 스위치를 찾다가 못 찾으셨다면 이유가 있어요. 구글 공식 도움말이 'AI 개요는 지식 패널과 같이 Google 검색의 핵심 기능'이고 '기능을 사용 중지할 수는 없'다고 직접 적거든요. 대신 되는 건 웹 필터와 Labs 스위치, 그리고 기록 삭제 세 가지인데 각각 하는 일이 달라요. 구글 한국어 도움말 원문을 그대로 열어 갈라 정리했어요.

터미널 AI 코딩 CLI 3종 비교 2026 — 클로드 코드·코덱스·제미나이 CLI, 무료로 어디까지 되나
ai-tools2026-08-06

터미널 AI 코딩 CLI 3종 비교 2026 — 클로드 코드·코덱스·제미나이 CLI, 무료로 어디까지 되나

터미널에서 쓰는 AI 코딩 CLI 세 가지의 무료 진입 경로와 한도를 각 도구의 공식 요금·문서 페이지에서 직접 확인해 정리했어요. 클로드 코드는 무료 플랜 접근이 없다고 문서가 못 박고, 코덱스 CLI는 무료 플랜에 포함되지만 그 한도 숫자가 요금 표에 없으며, 제미나이 CLI의 개인 구글 로그인은 2026년 6월 18일에 닫혔어요. 설치 요건과 데이터 정책까지 함께 봤어요.

챗GPT 광고 설정 — 개인화를 꺼도 광고는 남고, 지운 광고 데이터는 30일 남는다
chatgpt-guide2026-08-18

챗GPT 광고 설정 — 개인화를 꺼도 광고는 남고, 지운 광고 데이터는 30일 남는다

챗GPT 광고 설정 화면에서 문서가 Ads controls 항목으로 열거하는 것은 네 줄이고, 광고를 없애는 플랜 전환은 같은 화면의 다섯 번째 줄이에요. 개인화를 꺼도 광고는 그대로 남고, 광고를 없애는 항목은 메시지 한도를 깎고, 지운 광고 데이터는 서버에서 빠지는 데 최대 30일이 걸려요. OpenAI 헬프센터 원문 문장으로 경계를 갈라 정리했어요.