Cursor Agents Window 실전: 에이전트 병렬 작업, 이렇게 돌립니다

핵심 요약: Agents Window(Cursor 3에서 도입)는 여러 에이전트를 한 화면에서 띄우고 관리하는 관제 패널입니다. 각 에이전트는 로컬, git worktree(격리 복사본), 클라우드, SSH 원격 중 원하는 환경에서 돌릴 수 있습니다. 병렬화의 핵심 규칙은 둘: 서로 다른 파일을 만지는 독립 작업만 병렬로(같은 브랜치 동시 수정 금지 — worktree가 해결책), 그리고 사용량도 병렬로 소모된다는 것. 잘 쓰면 "기능 개발 + 테스트 보강 + 코드 조사"가 동시에 굴러가는 1인 팀 체제가 됩니다.

이 글에서 다루는 내용: 기본 사용법, 실행 환경 4종의 선택 기준, 병렬 작업 설계 패턴, 주의점.

기본 사용법

Agents Window를 열면 실행 중인 에이전트들이 카드/그리드로 보이고, 새 에이전트를 추가할 때 실행 환경을 고릅니다. 각 에이전트는 독립된 대화·작업 컨텍스트를 가지며, 클릭해서 들어가면 개별 diff 검토와 추가 지시가 가능합니다. 나란히 놓고 보는 Agent Tabs 뷰도 지원되어, "왼쪽은 기능 구현, 오른쪽은 테스트 작성"처럼 두 작업을 오가며 검토할 수 있습니다.

실행 환경 4종: 어디서 돌릴까

환경	적합한 작업	비고
로컬	지금 브랜치의 메인 작업	내 작업과 파일 충돌 주의
git worktree	같은 저장소의 병렬 작업	격리 복사본 — 병렬화의 기본값
클라우드	오래 걸리는 덩어리 작업	PC 꺼도 진행 (Cloud Agents)
SSH 원격	서버 환경 의존 작업	원격 자원에서 실행

실전 감각: 병렬을 시작하면 곧 worktree가 기본값이 됩니다. 같은 브랜치를 두 에이전트가 만지는 순간 충돌 지옥이 열리기 때문에, "에이전트 하나 = worktree 하나 = 브랜치 하나"가 안전한 공식입니다.

병렬 설계 패턴 3가지

① 개발 + 보강 병렬: 로컬에서 기능 개발(내가 검토하며) + worktree에서 테스트 보강(맡겨두고). 성격이 달라 검토 리듬이 겹치지 않습니다. ② 본작업 + 조사 병렬: 무거운 조사("이 패턴 쓰는 곳 전부 찾아 정리")를 별도 에이전트에 주면 본 작업 컨텍스트가 깨끗하게 유지됩니다. ③ 동일 작업 다중 시도: 접근이 갈리는 문제를 두 에이전트에게 다른 방식으로 시켜 결과를 비교 — 사용량이 두 배지만 막힌 문제에는 가장 빠른 길일 때가 있습니다.

주의점: 병렬의 세금

사용량. 에이전트 셋이 돌면 소모도 세 배입니다. 병렬은 "시간을 돈으로 사는" 기능이라는 걸 잊으면 월말에 놀랍니다(요금 절약 글의 원칙이 그대로 적용됩니다). 검토 병목. 에이전트는 병렬이어도 검토하는 나는 직렬입니다. 동시 3개를 넘기면 검토가 밀려 결과물이 쌓이기만 하는 경험을 하게 됩니다 — 제 상한은 "검토 대기 2개까지"입니다. 머지 순서. 병렬 결과물들이 같은 영역을 스쳤다면 머지 순서에 따라 충돌이 생기니, 독립성이 애매한 작업은 애초에 순차로 돌리는 게 낫습니다.

자주 묻는 질문 (FAQ)

Q. worktree가 뭔가요? 따로 공부해야 하나요?

A. 같은 저장소를 다른 폴더에 체크아웃하는 git 기능입니다. Agents Window가 생성·관리를 대신해주므로 개념만 알면 됩니다 — "격리된 작업 복사본"이라고 이해하면 충분합니다.

Q. 무료 플랜에서도 쓸 수 있나요?

A. 병렬 실행은 사용량 소모가 커서 무료 플랜의 한도로는 실질적으로 어렵습니다. Pro 이상에서 의미 있는 기능입니다.

Q. Claude Code의 서브에이전트와 뭐가 다른가요?

A. 방향이 다릅니다. 서브에이전트는 한 작업 안의 하위 분업(결과가 본 대화로 합쳐짐), Agents Window는 독립 작업들의 병렬 운영(각자 diff로 끝남)입니다.

한눈에 보는 요약

에이전트 하나 = worktree 하나, 독립 작업만 병렬로, 검토 대기 2개 상한, 사용량은 병렬로 나간다. 이 네 가지만 지키면 Agents Window는 1인 개발의 처리량을 실제로 바꿔주는 기능입니다.

함께 보면 좋은 글

Cursor Agent 모드는 언제 쓰는 게 좋을까?
Cursor Cloud Agents 사용법
Cursor 요금 아끼는 법 총정리

참고 자료

Cursor 공식 문서
Cursor 체인지로그 (Agents Window 도입)