Cursor Agent 모드와 Rules로 팀 개발하기

기초약 20분4단계

Agent 모드는 Cursor가 스스로 파일을 생성·수정·실행·테스트까지 반복합니다. Rules 파일로 팀 코딩 컨벤션을 AI에게 학습시키면 코드 리뷰 시간이 절반으로 줄어요.

따라 하기

1단계 / 4

Agent 모드 활성화

  1. 1cursor.com에서 Cursor를 다운로드해 설치하고 계정으로 로그인합니다.
  2. 프로젝트 폴더를 열면(File›Open Folder) 화면 오른쪽 또는 Ctrl+L(Mac: Cmd+L)로 채팅 패널이 열립니다.
  3. 채팅 패널 상단 좌측 드롭다운에서 모드를 선택할 수 있습니다.
  4. 2Agent 모드는 Cursor가 자율적으로 여러 단계를 실행합니다.
Cursor 열기
Terminal
# ─── Cursor 모드 선택 ───────────────────────────
Ctrl+L  (⌘+L)   # 채팅 패널 열기

# 채팅 패널 좌측 드롭다운:
→ Ask    : 질문·설명 (파일 수정 없음)
→ Edit   : 선택 영역만 수정 (이전 Cmd+K)
→ Agent  : 자율 에이전트 (파일 생성·실행·반복)

# Agent 모드에서 자주 쓰는 패턴
'[기능 설명]해줘. 기존 [파일명] 구조에 맞게 구현하고,
완료 후 테스트 실행해서 통과 확인까지 해줘'

이해를 돕는 예시 그림이에요. 실제 화면과 다를 수 있어요.

Claude Code — VS Code
● app.py
def login(user, pwd):
# TODO: validate
return db.find(user)
Claude Code
이 코드에 버그가 있어?
login 함수에 SQL 인젝션 취약점이 있어요. 파라미터를 직접 전달하고 있어서...
@app.py 질문하기...⌘↵

팁 Agent 모드는 터미널 명령어도 직접 실행할 수 있습니다. npm install·git commit 등을 자동으로 실행합니다. 실행 전 허용 여부를 묻는 팝업이 표시됩니다.

처음이라 잘 모르겠다면

Cursor 설정›Features›Enable Agent Mode를 켜세요. AI가 여러 파일을 동시에 열고 복잡한 작업을 자율적으로 처리합니다.

막히면 볼 것

자주 하는 실수 3가지
  1. 1Agent 모드 실행 중 자리 비움 → 허용 팝업 놓쳐 중단 — 터미널 실행 권한을 사전에 '항상 허용'으로 설정
  2. 2.cursorrules 없이 팀 개발 → AI마다 다른 스타일 코드 생성 — .cursorrules를 Git에 포함하면 팀 전체에 자동 적용
  3. 3Composer 결과를 Accept All로 무검토 수락 → 의도치 않은 파일 삭제·수정 — 반드시 파일별 diff 검토
AI 없이 할 때와 뭐가 다른가요?

기능 설명 한 번 → Agent가 스스로 구현·테스트·디버깅까지 자동 반복

Cmd+K로 코드 생성했는데 에러 나면 또 물어보고... 반복이 너무 많아
나
Ask 모드는 매번 사람의 판단과 승인이 필요합니다.지금까지
Cursor 말고 다른 도구로 하기