Cursor Background Agent vs 로컬, 언제 무엇을

Cursor Background Agent는 “채팅을 붙잡고 한 턴씩 스티어링”이 아니라 작업을 맡기고 자리를 비운 뒤, 증거와 함께 돌아오는 제품/워크플로입니다. 공식 문서에서는 이 계열을 지금 Cloud Agents라고도 부릅니다. 이 글은 VM·PR 셋업 재탕이 아니라 킥오프 → 비동기 실행 → 리뷰 축만 정리합니다.

인접 글 cursor-cloud-vs-local-agent는 Cloud VM·브랜치/PR 핸드오프 기준입니다. 여기서는 **백그라운드는 언제? · 로컬과 차이는? · 리뷰는?**만 다룹니다. 요금·플랜·토큰·제휴 링크는 없습니다. 근거는 What are background agents?, Cloud Agents, Agent overview입니다.

백그라운드는 언제?

한 줄 답: 범위가 이미 닫혀 있고, 노트북을 붙잡지 않아도 되며, 끝나면 증거(로그·테스트·아티팩트·PR)로 검증할 수 있을 때 Background를 고릅니다.

Background(비동기 장시간 에이전트)를 고르는 신호:

신호왜 Background인가
장시간분~시간 단위로 계획·편집·명령·테스트를 이어감. 로컬 세션을 열어둘 필요 없음
자리 비움원격에서 끝까지 돌고 proof와 함께 보고
범위가 명확Goal·재현 명령·경로·비목표가 한 덩어리로 적혀 있음
병렬로컬 채팅 한 줄을 막지 않고 여러 작업을 동시에 맡김
검증 가능빌드/테스트/스크린샷·로그를 결과물에 붙일 수 있음

실무 킥오프 체크:

  1. Done 정의가 명령 exit 0 또는 “PR + 아티팩트”처럼 객관적인가?
  2. 스코프(경로)·비목표가 한 문단에 있는가?
  3. 미커밋 로컬 실험에 의존하지 않는가? (원격은 보통 깨끗한 git 상태에서 시작; dirty 작업은 커밋/stash 후)
  4. 시크릿·네트워크·의존성이 원격 환경에 이미 있는가?
  5. 지금 당장 follow-up으로 방향을 틀어야 하면 → 아직 로컬.

복붙용 킥오프 뼈대:

Background task (async):
Goal: <outcome + proof>
Repro / Done (must exit 0):
  <exact command>
Scope: <paths>
Out of scope: <list>
Do not ask mid-run; report blockers with log + command.

경계: cursor-cloud-vs-local-agent는 “Cloud를 골라 PR을 연다”는 실행 장소·핸드오프 글입니다. 이 절은 비동기로 맡길 만큼 준비가 됐는지입니다.

로컬과 차이는?

한 줄 답: 로컬 Agent는 열린 워크스페이스에 붙어 즉시 스티어링하고, Background는 자리를 비운 채 끝까지 돌린 뒤 결과로 대화합니다. 도구 목록보다 피드백 루프·컨텍스트·롤백이 갈립니다.

축로컬 (사이드페인 Agent)Background (비동기)
루프큐·Steer·즉시 follow-up킥오프 후 보고·아티팩트 중심
컨텍스트미저장 버퍼, 로컬-only 파일, 디버거·보드원격 클론·환경에 올린 것
롤백세션 Checkpoints(Git과 별개)브랜치/커밋·런 단위로 검토
중단노트북 절전·세션 종료에 민감원격에서 계속
적합모호한 설계, 짧은 패치, 하드웨어/VPN범위 고정·장시간·병렬

로컬이 나은 경우:

  1. 설계가 아직 흐릴 때 — Ask/Plan에 가깝게 묻고 합의 후 작은 패치.
  2. 미저장·로컬-only 파일이나 USB/보드/사내 VPN 도구가 필요할 때.
  3. 한두 문장으로 방향을 자주 틀어야 할 때 (Steer/큐).
  4. Background 환경에 같은 재현이 아직 안 될 때 — 로컬에서 명령을 먼저 고정.
  5. 팀 정책상 원격에 올리면 안 되는 데이터가 섞일 때.

로컬도 터미널·브라우저·편집을 합니다. 차이는 “할 수 있느냐”가 아니라 누가 옆에 앉아 스티어링하느냐입니다. Background는 그 옆자리를 비우는 계약입니다.

리뷰는?

한 줄 답: Background 결과는 채팅 한 줄 요약이 아니라 proof 묶음으로 리뷰합니다. 아티팩트·재현 명령·diff 범위·비목표 침범 여부를 체크하고, 모호하면 로컬에서만 이어서 닫습니다.

리뷰 체크리스트:

[ ] Done 명령(또는 합의 테스트)이 green인가? 로그/아티팩트 첨부됐는가?
[ ] diff가 Scope 경로 안인가? Out of scope를 건드렸으면 되돌리거나 티켓 분리
[ ] 시크릿·자격증명이 커밋/로그에 새지 않았는가?
[ ] PR/브랜치가 있으면 CI required와 메시지·스크린샷이 맞는가?
[ ] “에이전트가 됐다 함”만 있고 재현 없으면 → 리뷰 미완료
[ ] 남은 일(네이밍·엣지·로컬-only 검증)만 로컬 Agent에 넘겼는가?

리뷰 순서 제안:

  1. Proof 먼저 — 테스트 로그, 스크린샷/영상, 에이전트 URL.
  2. Scope diff — 경로·파일 수가 킥오프와 같은지.
  3. 위험 표면 — 인증, 마이그레이션, 공개 API, 시크릿 스캔.
  4. 수용 또는 환승 — 통과면 머지/다음 단계, 실패·모호하면 재현 명령 + 실패 로그를 로컬 채팅에 붙여 짧은 수정.

문서상 Background/Cloud 계열은 변경을 검증하며 비디오·스크린샷·로그를 붙이고, 필요하면 remote desktop으로 직접 확인한다고 안내합니다. 리뷰의 핵심은 “믿기”가 아니라 같은 Done 명령을 사람(또는 CI)이 다시 볼 수 있는가입니다.

한 줄 정리: Background = 준비된 비동기 킥오프, 로컬 = 즉시 스티어링, 리뷰 = proof·스코프·시크릿. Cloud VM/PR 핸드오프 글과 축이 다릅니다.

FAQ

Background와 Cloud Agent는 다른 제품인가요?

문서에서는 Background agents를 장시간 원격 실행으로 설명하고, Cursor에서 이를 Cloud Agents라고 부릅니다. UI·옛 문서에 Background가 보이면 같은 계열로 보면 됩니다. 이 글은 이름보다 비동기 워크플로·리뷰에 초점을 둡니다.

weekly cursor-cloud-vs-local-agent와 무엇이 다른가요?

그 글은 Cloud VM·PR·핸드오프 선택 기준입니다. 이 글은 백그라운드 킥오프 타이밍, 로컬과의 루프 차이, 결과 리뷰 체크리스트입니다.

Move to Cloud 하면 로컬 dirty 파일이 가나요?

문서 안내상 대화 맥락은 넘어가도 미커밋 dirty 파일은 스냅샷되지 않는 경우가 있습니다. Background에 최신 상태를 넘기려면 커밋 또는 stash 후 킥오프하는 편이 안전합니다.

리뷰 없이 머지해도 되나요?

아니오. Background proof는 리뷰 입력이지 머지 승인 자체가 아닙니다. CI required·사람 eval·시크릿 정책은 그대로입니다.

출처 (Sources)