Cursor에서 백그라운드 에이전트를 사용한 자동화
Cursor 1.0은 백그라운드 에이전트를 도입했습니다. 이는 AI 에이전트가 IDE를 차단하지 않고 백그라운드에서 작업을 실행할 수 있게 하는 강력한 기능입니다. 이 가이드는 백그라운드 에이전트를 설정, 관리하고 최대 생산성을 위해 활용하는 방법을 다룹니다.
백그라운드 에이전트란?
백그라운드 에이전트는 다음을 가능하게 합니다:
- 장기 실행 작업——다른 작업을 하는 동안 계속 실행
- 병렬 처리——여러 개의 독립적인 작업을 동시에 처리
- 비동기 작업——테스트, 빌드 및 분석 등
- 예약된 작업——특정 시간에 실행
전제 조건
- Cursor 버전 1.0 이상
- Pro 이상 요금제(백그라운드 에이전트는 유료 요금제가 필요할 수 있음)
- 독립적으로 실행할 수 있는 작업이 있는 프로젝트
백그라운드 에이전트 시작
방법 1: 컨텍스트 메뉴
- Composer 열기(
Cmd/Ctrl + I) - 작업 설명 입력
- ... 메뉴(추가 작업) 클릭
- 백그라운드에서 실행 선택
방법 2: 명령
@background 전체 코드베이 스를 분석하여 보안 취약점을 찾고 결과를 보고하세요.
방법 3: 키보드 단축키
- 작업 작성
Cmd/Ctrl + Shift + B누르기(구성된 경우)- 에이전트가 백그라운드에서 시작
백그라운드 에이전트 사용 사례
1. 코드베이스 분석
[백그라운드] 전체 코드베이스를 스캔하고:
1. 모든 TODO 주석 찾기
2. 더 이상 사용되지 않는 API 사용 식별
3. 테스트 커버리지가 없는 파일 나열
4. 잠재적 메모리 누수 감지
5. 코드 중복 보고
완료 시 요약 보고서 제공.
2. 테스트 실행
[백그라운드] 전체 테스트 스위트 실행:
1. 모든 단위 테스트 실행
2. 통합 테스트 실행
3. 커버리지 보고서 생성
4. 결과를 test-results/에 저장
완료 시 통과/실패 요약으로 알려주세요.
3. 문서 생성
[백그라운드] API 문서 생성:
1. src/의 모든 공개 함수/클래스 스캔
2. 누락된 곳에 JSDoc/docstring 생성
3. docs/api/에 마크다운 문서 생성
4. 탐색 색인 생성
기존 스타일을 src/utils/helpers.ts에서 사용.
4. 대규모 코드베이스 리팩토링
[백그라운드] 오류 처리 리팩토링:
1. 모든 try/catch 블록 찾기
2. 오류 메시지 표준화
3. 구조화된 오류 로깅 추가
4. 사용자 지정 오류 클래스 생성
전체 코드베이스에 변경 사항 적용.
백그라운드 에이전트 관리
활성 에이전트 보기
-
백그라운드 에이전트 패널 열기:
- 보기 > 모양 > 백그라운드 에이전트 표시
- 또는 사이드바 아이콘 사용
-
실행 중인 모든 에이전트 보기:
- 작업 설명
- 시작 시간
- 현재 상태
- 진행 표시기
에이전트 상태
| 상태 | 설명 | 작업 |
|---|---|---|
| 실행 중 | 에이전트가 적극적으로 작업 중 | 진행 상황 모니터링 |
| 일시 중지됨 | 에이전트가 수동으로 일시 중지됨 | 재개 또는 취소 |
| 완료됨 | 작업이 성공적으로 완료됨 | 결과 보기 |
| 실패함 | 작업에 오류가 발생함 | 로그 검토 |
| 취소됨 | 작업이 사용자에 의해 중지됨 | 필요 시 다시 시작 |
에이전트 제어
# 에이전트 일시 중지
cursor agent:pause <agent-id>
# 에이전트 재개
cursor agent:resume <agent-id>
# 에이전트 취소
cursor agent:cancel <agent-id>
# 에이전트 로그 보기
cursor agent:logs <agent-id>
에이전트 출력 및 결과
결과 유형
-
파일 변경: 에이전트가 파일을 수정함
- 소스 제어 패널에서 검토
- 커밋 전 diff 보기
-
보고서: 생성 된 요약
- 지정된 위치에 저장
- 또는 알림 패널에 표시
-
알림: 상태 업데이트
- 완료 시 데스크톱 알림
- Cursor 아이콘의 배지
결과 접근
백그라운드 에이전트가 완료되면:
- 알림이 표시됨(활성화된 경우)
- Cursor 도크/작업 표시줄에 배지 표시
- 결과 패널이 자동으로 열림
- 변경된 파일이 소스 제어에 나타남
모범 사례
작업 세분화
큰 작업을 더 작은 백그라운드 에이전트로 나누기:
# 좋음: 구체적이고 독립적인 작업
[백그라운드] 인증 모듈 오류 처리 리팩토링
[백그라운드] 결제 모듈 오류 처리 리팩토링
[백그라운드] 알림 모듈 오류 처리 리팩토링
# 덜 이상적: 하나의 거대한 작업
[백그라운드] 전체 앱의 모든 오류 처리 리팩토링
리소스 관리
동시 백그라운드 에이전트 제한:
# 권장 최대 동시 에이전트 수
- CPU 집약적 작업(리팩토링, 분석)의 경우 2-3개
- I/O 바운드 작업(문서, 보고서)의 경우 5개 이상
체크포인트
장시간 작업의 경우 체크포인트 사용:
[백그라운드] 데이터베이스 스키마 마이그레이션:
1. 백업 생성
2. 마이그레이션 스크립트 실행
3. 데이터 무결성 확인
4. 롤백 스크립트 생성
각 단계 후 진행 상황 저장.
중단된 경우 마지막 체크포인트부터 재개.
모니터링 및 로그
에이전트 로그 보기
- 백그라운드 에이전트 패널 열기
- 완료된 에이전트 클릭
- 전체 실행 로그 보기
- 타임스탬프 및 작업 확인
로그 구조
[2026-06-25 10:00:00] 에이전트 시작: "코드베이스 보안 스캔"
[2026-06-25 10:00:05] 읽기: src/auth/login.ts
[2026-06-25 10:00:10] 읽기: src/auth/register.ts
[2026-06-25 10:00:15] 분석 완료: 3개 취약점 발견
[2026-06-25 10:00:20] 보고서 작성: security-report.md
[2026-06-25 10:00:25] 에이전트 성공적으로 완료
백그라운드 에이전트용 모델 선택
다양한 모델이 다양한 백그라운드 작업에 적합합니다:
| 작업 유형 | 권장 모델 | 이유 |
|---|---|---|
| 코드 분석 | Claude 3.5 Sonnet | 철저하고 정확함 |
| 리팩토링 | GPT-4o | 빠르고 신뢰할 수 있음 |
| 문서 | Gemini 1.5 Pro | 긴 컨텍스트 |
| 테스트 | Claude 3.5 Sonnet | 우수한 엣지 케이스 감지 |
| 보안 감사 | Claude 3 Opus | 심층 분석 |
설정에서 기본 모델 구성:
{
"backgroundAgents": {
"defaultModel": "claude-3-5-sonnet",
"maxConcurrent": 3,
"autoNotify": true
}
}
문제 해결
| 문제 | 해결책 |
|---|---|
| 에이전트가 시작되지 않음 | 요금제 한도 확인; 업그레이드가 필요할 수 있음 |
| 에이전트가 사라짐 | 백그라운드 에이전트 패널에서 오류 확인 |
| 결과가 저장되지 않음 | 작업 설명에서 출력 경로 지정 |
| 에이전트가 멈춤 | 취소하고 다시 시작; 입력을 기다릴 수 있음 |
| CPU 사용량 높음 | 동시 에이전트 줄이기; 더 가벼운 모델 사용 |
예시: 완전한 백그라운드 워크플로우
# 아침: 분석 시작
[백그라운드] 코드베이스의 기술 부채를 분석하세요.
우선순위가 지정된 리팩토링 작업 목록을 생성하세요.
# 에이전트가 실행되는 동안 계속 코딩...
# 에이전트 완료
[알림] "분석 완료: 12개의 리팩토링 기회 발견"
# 결과 검토
열기: analysis-results/refactoring-tasks.md
# 백그라운드에서 리팩토링 시작
[백그라운드] 분석에서 상위 3개 리팩토링 작업을 구현하세요.
# 다른 작업 계속...
# 편할 때 변경 사항 검토
소스 제어 패널에서 diff 확인