(2/3) Cursor, 현업에서 진짜 쓸 기능만 골라 정리
📚 AI IDE 현업 활용 시리즈 (전체 3편)
- Antigravity, 현업에서 진짜 쓸 기능만 골라 정리
- Cursor, 현업에서 진짜 쓸 기능만 골라 정리 ← 지금 글
- AI IDE × Claude Code 하이브리드 셋업 — Antigravity / Cursor 각각에 끼워 쓰기
Summary
1편 에서 Antigravity 를 다뤘다면, 2편은 Cursor 차례에요. Cursor 는 VS Code 위에 AI 레이어를 얹은 형태라 진입 비용이 낮고, 2026 들어 Background Agents / BugBot / Parallel Agents 같이 “에이전트가 따로 돌면서 PR 까지 만들어 오는” 기능이 많이 늘었습니다. 이 글에선 그 변화 중에 현업에서 바로 손에 잡히는 것들 만 골라 정리해요.
💡 이 글에서 다루는 것
- 기본기: Tab 자동완성 / Cmd-K / Composer
- Agent Mode 와 Composer 2.5
- Background Agents — 클라우드에서 PR 까지
- BugBot — PR 리뷰 + 자동 수정 제안
- Parallel Agents — git worktree 기반 8병렬
.cursor/rules/*.mdc로 프로젝트 룰 패키지화- @ 컨텍스트 — file / folder / codebase / docs / web / git
- MCP — Postgres / Sentry / Linear / Slack 연결
- 모델 선택과 비용 / Privacy Mode
- 안 좋은 점 / 도입 전 체크
1. 기본기 — Tab / Cmd-K / Composer
Cursor 를 처음 켜면 보이는 3개의 입력 진입점이에요. 셋 다 자주 씁니다.
| 입력 | 트리거 | 어떨 때 |
|---|---|---|
| Tab 자동완성 | 그냥 코드 작성 중 | 한 줄~여러 줄 완성. Copilot 강화판. 함수 시그니처 보고 본문 채우기 |
| Cmd-K 인라인 편집 | 선택 영역 + ⌘K |
“이 함수 비동기로 바꿔줘” 같은 지역적인 변경 |
| Composer | ⌘I / ⌘L |
여러 파일 한 번에 바꾸기. 새 파일 생성도 가능 |
Cmd-K 는 “범위가 명확한 작업”, Composer 는 “범위를 모델이 잡아야 하는 작업” 으로 나눠 쓰면 깔끔합니다.
💡 자주 빼먹는 팁
선택 영역 없이⌘K를 누르면 새 코드를 그 자리에 생성해줘요. 마우스로 잡지 않고 커서만 둔 채로 호출 가능.
2. Agent Mode 와 Composer 2.5
Composer 안에 Agent Mode 가 들어가 있는데, 이게 2026 에서 가장 많이 강해진 부분이에요. 켜면 모델이:
- 코드베이스를 알아서 읽고
- 필요한 파일을 골라서 열고
- 새 파일을 만들고
- 터미널 명령을 직접 실행하고
- 에러를 보고 다시 고치고
- 결과를 검증할 때까지 반복
까지 사람이 매 단계 지정하지 않아도 진행합니다. Composer 2.5 부터는 긴 작업(여러 단계에 걸친 리팩토링, 패키지 마이그레이션 등) 에서 안정성이 눈에 띄게 좋아졌어요.
✅ 현업 활용 포인트
“이 모듈을 vitest 에서 jest 로 옮겨줘. 테스트가 통과할 때까지 돌려” 같이 목표만 주고 검증까지 위임하는 작업에 잘 어울려요. 한두 단계 작업은 Cmd-K 가 더 빠릅니다.
3. Background Agents — 클라우드에서 PR 까지
작년만 해도 “Cursor 는 로컬 도구” 였는데, 이제 작업을 로컬 바깥으로 보낼 수 있습니다. Background Agent 는 클라우드 격리 sandbox 에서 동작하면서:
- GitHub 이슈 읽기
- 새 브랜치 따기
- 커밋 / 푸시
- PR 까지 draft 로 올리기
까지 자동으로 합니다. 2026-02 업데이트에서 자기 변경분을 스스로 평가하고, 동작 결과를 비디오 / 로그 / 스크린샷으로 정리해서 PR 본문에 붙여줘요. “다 했어요” 가 아니라 “이렇게 동작합니다” 까지 증거가 같이 옴.
✅ 잘 어울리는 작업
- 이슈 트래커에 정리된 자잘한 버그 fix
- 의존성 버전업 / lint 룰 적용
- 마이그레이션처럼 시간은 걸리지만 단계가 정형적인 작업
⚠️ 주의
사내 코드가 외부 sandbox 로 나가는 구조라 보안팀 승인 / Privacy Mode 설정을 먼저 정리해야 합니다.
4. BugBot — PR 리뷰 + 자동 수정 제안
BugBot 은 원래 PR 에 코멘트만 달던 도구였는데, 2026-02 부터 “fixer” 로 승격됐어요. 흐름이 이렇게 바뀌었습니다.
1) BugBot 이 PR diff 를 읽고 잠재 버그 탐지
2) 진짜 문제라고 판단되면, 자기 클라우드 에이전트를 띄움
3) 수정 후 테스트 돌려서 동작 확인
4) PR 에 "이렇게 고치면 됩니다" 제안 (suggest changes 형태)
내부 발표 기준 해결률(resolution rate) 80%대 로, 단순 리뷰 봇보다 한 단계 위. 리뷰어가 봐야 할 코멘트가 줄어드는 효과가 큽니다.
⚠️ 100% 는 아닙니다
도메인 로직 버그(비즈니스 규칙 위반)는 여전히 못 잡는 경우가 많아요. 코드 패턴 버그(null check, off-by-one, race, 잘못된 await) 에 강합니다. 사람 리뷰의 면제가 아니라 “1차 필터” 로 잡고 들어가는 게 안전.
5. Parallel Agents — git worktree 기반 8병렬
2026-02 에 들어온 기능. 한 코드베이스의 서로 다른 브랜치/디렉토리를 git worktree 로 떠서 에이전트 최대 8명을 동시에 굴릴 수 있어요. Antigravity 의 Agent Manager 와 비슷한 그림이지만, Cursor 는 git worktree 라는 익숙한 git 메커니즘 위에 얹은 게 특징입니다.
| 시나리오 | 어떻게 |
|---|---|
| 같은 PR 여러 접근 비교 | 같은 이슈를 worktree 3개에 띄워 다른 모델/프롬프트로 시도 → 결과 비교 |
| 마이크로서비스 동시 변경 | 서비스별 디렉토리/브랜치를 worktree 로 분리 → 에이전트별 할당 |
| 리뷰 대응 + 다음 작업 병렬 | 한 worktree 는 리뷰 코멘트 반영, 다른 하나는 다음 티켓 진행 |
git worktree 위라서 로컬 디스크 사용량은 좀 늘어나지만, IDE 가 worktree 경로/브랜치 컨텍스트를 같이 관리해줘서 헷갈리지 않아요.
6. .cursor/rules/*.mdc — 프로젝트 룰 패키지화
Cursor 의 컨텍스트 엔지니어링 핵심이에요. 프로젝트 루트에 .cursor/rules/ 폴더를 만들고 룰을 작은 .mdc 파일로 쪼개서 두는 방식.
.cursor/
└── rules/
├── api-conventions.mdc
├── react-patterns.mdc
├── db-migration.mdc
└── security-checklist.mdc
각 .mdc 는 frontmatter + 본문 구조.
---
description: 사내 REST API 컨벤션 — 응답 포맷, 에러 코드, 페이지네이션
globs: ["src/api/**/*.ts"]
alwaysApply: false
---
# API 응답 표준
모든 응답은 다음 envelope 를 따른다.
...
description매칭되는 요청이 들어올 때만 컨텍스트에 로드 (progressive disclosure)globs특정 경로 작업할 때만 자동 첨부alwaysApply: true항상 시스템 프롬프트에 포함
✅ 현업 활용 포인트
코딩 컨벤션 / 보안 체크리스트 / 데이터 모델 룰 같은 걸 룰 파일로 쪼개면 새 멤버가 합류해도 동일한 규칙으로 에이전트가 동작해요. 룰 자체를 PR 리뷰 대상으로 삼는 것도 가능.
7. @ 컨텍스트 — file / folder / codebase / docs / web / git
채팅 / Composer 입력창에서 @ 로 호출하는 컨텍스트 인젝션 방식이에요. 자주 쓰는 것만.
| 멘션 | 무엇 | 언제 |
|---|---|---|
@File |
특정 파일 | “이 파일 기준으로 비슷한 형태로” |
@Folder |
폴더 전체 | 한 모듈 전체 맥락 |
@Codebase |
인덱스된 코드베이스 검색 | “이 함수 어디서 호출돼?” |
@Docs |
공식 문서 (라이브러리) | API 사용법 정확히 |
@Web |
실시간 웹 검색 | 최신 변경/이슈 확인 |
@Git |
git diff / 커밋 | “이 PR 의 변경 의도” |
@Codebase 가 가장 자주 쓰는 카드인데, 사전 인덱싱이 켜져 있어야 정확해요. 큰 모노레포는 인덱스에서 일부 폴더를 제외해서 메모리를 아끼는 게 일반적입니다.
8. MCP — 실제 시스템에 손 뻗기
Antigravity 도 그렇지만 Cursor 의 MCP 도 같은 표준이에요. Cursor 설정에서 MCP 서버를 등록하면 에이전트가 외부 시스템을 도구처럼 다룹니다.
자주 붙이는 서버
- Postgres — 운영 DB 스키마 / 쿼리 결과를 직접 참조
- GitHub — PR 만들고 리뷰 코멘트 읽기
- Sentry — 최근 에러를 가져와서 원인 분석
- Linear — 티켓 읽고 자동으로 브랜치 작업
- Slack — 진행 결과를 채널에 보고
사람: "Sentry 의 최근 24시간 에러 중에 빈도 높은 거 3개 뽑아서 원인 분석"
에이전트:
1) MCP 로 Sentry 쿼리
2) 에러 stack trace 와 관련 코드(@Codebase) 매칭
3) 의심 라인 정리 + 재현 시나리오 제안
🚨 주의
MCP 서버는 보통 개발자 토큰을 들고 동작합니다. Postgres MCP 가 운영 DB 자격증명을 들고 있으면 에이전트가 DELETE 까지 칠 수 있다는 의미예요. 운영 환경엔 읽기 전용 자격증명으로 분리하고, 가능한 한 stg/local 만 연결하는 게 안전.
9. 모델 선택과 비용 / Privacy Mode
Cursor 는 한 IDE 안에서 여러 모델을 라디오 버튼처럼 골라요. 현시점 자주 쓰는 후보.
| 모델 | 쓸 자리 |
|---|---|
| Claude Sonnet 4.5 | 리팩토링 / 디버깅 / 코드 리뷰 (논리적인 작업) |
| Gemini 3 Pro | UI / 다중 파일 생성 / 시각 자료 동반 작업 |
| GPT-5 | 빠른 한 번에 끝나는 작업 / Composer 가벼운 호출 |
| 빠른 모델 (cheap tier) | Tab 자동완성 / 단순 인라인 편집 |
같은 작업이라도 Composer/Agent 는 비싼 모델, Tab 자동완성은 가벼운 모델 로 분리해서 비용을 관리하는 게 일반적이에요.
Privacy Mode 는 “Cursor 가 사용자 코드를 학습용으로 저장하지 않게” 하는 모드인데, 사내 도입할 때는 거의 필수 옵션이에요. 팀 단위로 강제 가능.
10. 안 좋은 점 / 도입 전 체크
가려진 단점들도 짚고 갑니다.
- 🚨 Background Agent 는 sandbox 가 외부라는 점을 보안팀이 가장 먼저 본다. 사내 코드 정책에 따라 도입 가능 여부가 갈림. Privacy Mode + 팀 플랜의 SSO/감사 로그가 사실상 필수.
- ⚠️ 인덱스가 크면 무거움 — 모노레포에서 첫 인덱싱이 길고, 메모리도 꽤 먹음.
.cursorignore로 빌드 산출물/벤더 디렉토리 빼는 게 첫 단계. - ⚠️ VS Code 확장 호환성은 100% 가 아님 — Marketplace 와 별도 카탈로그라 사용하던 확장 일부는 못 쓸 수 있음. 도입 전 자주 쓰는 확장 리스트로 점검.
- ⚠️ Agent 가 터미널을 직접 친다 —
rm,git reset같은 위험한 명령을 자동 승인 모드로 두면 사고 가능. 자동 승인 화이트리스트를 보수적으로 잡는 걸 추천. - ⚠️ 요금제 변경이 잦음 — 2025~2026 사이에 Pro / Ultra / Team 구조가 여러 번 조정됐어요. 도입 시점의 사용량 가정이 6개월 뒤에는 안 맞을 수 있음.
마무리
Cursor 의 차별점을 한 문장으로 줄이면 “익숙한 VS Code 위에 에이전트와 클라우드 워크플로우가 얹힌 IDE” 정도예요. Antigravity 가 “에이전트 N명을 굴리는 관제실” 쪽이라면, Cursor 는 “내 손에 있는 IDE 가 점점 자동화 도구로 자라는” 방향이에요. 둘 다 쓸모 있지만 진입 곡선과 기존 환경과의 마찰이 다르니, 팀 상황에 맞게 고르면 됩니다.
일단 오늘은 여기까지…..
다음 글에서는 시리즈 마지막으로 Antigravity / Cursor 각각에 Claude Code 를 같이 끼워 쓰는 하이브리드 셋업 흐름(MCP, 룰/스킬 패키지화, 권한 분리)을 정리해볼게요.
← 이전 글 (1/3) Antigravity, 현업에서 진짜 쓸 기능만 골라 정리 ｜ 다음 글 → (3/3) AI IDE × Claude Code 하이브리드 셋업