Cursor AI — Copilot을 넘어선 에이전트급 코드 에디터
지금 어떤 코드 에디터를 쓰고 계신가요? VS Code에 GitHub Copilot을 붙여서 쓰시는 분이 많을 것입니다. 자동완성은 편리하지만, 한 가지 결정적 한계가 있습니다. 커서를 올린 그 줄만 도와줄 뿐, 프로젝트 전체 구조를 이해하지 못합니다.
Cursor AI는 이 문제를 해결합니다. 프로젝트 전체 파일을 읽고 이해하며, 여러 파일을 동시에 수정하고, 외부 문서까지 참조하는 에이전트급 코드 에디터입니다. 이 글에서는 .cursorrules 설정부터 Composer로 여러 파일을 한 번에 수정하는 방법까지, Cursor AI의 핵심 기능을 처음부터 끝까지 다룹니다.
1. Cursor vs Copilot — 3가지 결정적 차이
“Cursor가 Copilot보다 뭐가 좋은데?” 가장 많이 받는 질문부터 시작하겠습니다. 세 가지로 정리합니다.
첫째, Codebase-Aware
Cursor는 프로젝트 전체 파일을 읽고 이해합니다. VS Code와 Copilot은 현재 파일 위주로 동작하지만, Cursor는 프로젝트의 다른 파일, 설정, 의존성까지 참고해서 코드를 제안합니다. “이 프로젝트에서 이 함수는 어떻게 쓰이고 있어?”라고 물으면 정확히 답합니다. 다른 파일에서 import하는 함수의 시그니처, 사용 패턴, 테스트 코드까지 한 번에 파악합니다.
둘째, Multi-File Edit
Copilot은 한 줄, 한 함수 단위로 제안하지만, Cursor의 Composer 기능은 여러 파일을 동시에 수정합니다. “이 API 엔드포인트 추가하고, 프론트엔드에서 호출하는 코드도 만들어줘”라고 하면, 백엔드 파일과 프론트엔드 파일을 동시에 편집합니다. 수동으로 파일을 오가며 반복 작업할 필요가 없습니다.
셋째, @ Mentions
채팅창에서 @ 기호를 쳐서 특정 파일, 특정 문서, 심지어 웹 페이지를 참조하게 할 수 있습니다. @package.json 지금 쓰는 버전에 맞게 코드 수정해줘 같은 작업이 가능합니다. 프로젝트 내부 파일뿐 아니라, 외부 라이브러리 공식 문서, 웹 검색 결과까지 참조 컨텍스트에 넣을 수 있습니다.
2. 설치와 초기 설정
설치는 간단합니다. cursor.com에서 다운로드하면 됩니다. Cursor는 VS Code를 포크한 에디터이므로, 기존 VS Code 확장 프로그램과 설정을 그대로 가져올 수 있습니다. 처음 실행하면 VS Code 설정 가져오기 버튼이 나오는데, 클릭 한 번이면 마이그레이션이 끝납니다.
여기서 중요한 것은 모델 선택입니다. Cursor는 여러 AI 모델을 지원합니다:
- Claude 3.5 Sonnet — 코드 작성에 가장 적합. 복잡한 리팩토링과 멀티 파일 수정에서 강세
- GPT-4o — 일반적인 질문, 문서 작성, 코드 설명에 적합
- 무료 모델 — 기본 기능 체험용
Settings에서 기본 모델을 Claude로 설정하는 것을 추천합니다. 무료 플랜은 기본 기능을 쓸 수 있고, Pro 플랜은 월 20달러로 더 많은 요청과 고급 기능(Composer 고급 모델 등)을 제공합니다.
3. .cursorrules — 프로젝트 규칙을 AI에게 학습시키기
.cursorrules 파일은 Cursor의 핵심 기능 중 하나입니다. 프로젝트 루트에 이 파일을 만들면, Cursor가 이 프로젝트에서 지켜야 할 규칙을 학습합니다.
예시: Python/FastAPI 프로젝트
# .cursorrules
You are an expert in Python, FastAPI, and PostgreSQL.
- Always use type hints
- Use async/await for database operations
- Follow PEP 8 strictly
- Prefer dependency injection over global state
- Write docstrings in Google style
- Error handling: use custom exception classes, not bare except이 파일이 있으면 Cursor가 코드를 생성할 때 이 규칙들을 따릅니다. 예를 들어 async를 안 쓴 코드를 제안하지 않고, 타입 힌트 없는 함수를 만들지 않습니다.
꿀팁: 프로젝트 구조 설명 추가
.cursorrules에 프로젝트 구조를 설명해 주면 더 좋습니다:
# 프로젝트 구조
이 프로젝트는 모놀리스 구조입니다.
src/ 아래에 모듈별로 디렉토리가 나뉘어 있습니다.
공통 유틸리티는 src/shared/에 있습니다.
테스트는 tests/ 디렉토리에 있습니다.이렇게 적어두면 Cursor가 새 파일을 어디에 만들어야 할지 압니다. 팀 단위로 쓸 때는 .cursorrules를 Git에 커밋해서, 팀원 전체가 동일한 코딩 표준을 Cursor에게 학습시킬 수 있습니다.
4. Composer (Ctrl+I) — 자연어로 멀티 파일 수정
Cursor의 가장 강력한 기능은 Composer입니다. Ctrl+I(macOS는 Cmd+I)를 누르면 Composer가 열립니다. 자연어로 여러 파일을 동시에 수정할 수 있는 기능입니다.
실전 예시
Composer에 다음과 같이 입력합니다:
“사용자 프로필에 avatar URL 필드를 추가해줘. DB 모델, API 엔드포인트, 프론트엔드 컴포넌트 전부 수정해.”
이렇게 입력하면 Composer가 세 개의 파일을 동시에 열고, 각각에 필요한 변경사항을 보여줍니다. Accept 버튼을 누르면 한 번에 적용됩니다.
이게 VS Code + Copilot과 가장 큰 차이입니다. Copilot으로 이 작업을 하려면 모델 파일을 열고 수정하고, API 파일을 열고 수정하고, 프론트엔드 파일을 열고 수정하는 세 번의 작업이 필요합니다. Cursor는 한 번에 처리합니다.
주의사항
Composer가 여러 파일을 수정하니까, 변경사항을 꼭 Git diff로 확인하세요. AI가 만들었다고 무조건 맞는 것이 아닙니다. 특히 기존 비즈니스 로직을 건드릴 때는 한 줄 한 줄 검토해야 합니다. Composer는 강력한 도구이지만, 최종 결정은 개발자가 내려야 합니다.
5. @ Mentions과 Chat
Cursor의 채팅 기능에서 @ 기호를 쓰면 다양한 것을 참조할 수 있습니다:
| 명령 | 기능 | 활용 예시 |
|---|---|---|
@파일명 |
특정 파일의 내용 참조 | 현재 작업 중인 파일의 의존성 확인 |
@폴더명 |
폴더 내 모든 파일 참조 | 모듈 전체 구조 파악 |
@web |
웹 검색으로 최신 문서 참조 | 프레임워크 최신 API 확인 |
@docs |
인기 라이브러리 문서 직접 참조 | React, Vue, FastAPI 공식 문서 |
@터미널 |
터미널 출력 참조 | 에러 메시지 원인 분석 |
실전 팁: 에러 디버깅
에러가 발생했을 때 에러 메시지를 그대로 복사해서 채팅창에 붙여넣고 @터미널을 참조하면, Cursor가 터미널 출력을 읽고 원인을 분석해 줍니다. 스택 트레이스의 어떤 라인이 문제인지, 어떤 파일의 어떤 함수에서 발생했는지 추적하고 수정 방법을 제안합니다.
최신 문서 검색
@web Next.js 15의 app router에서 layout을 중첩하는 최신 방식을 찾아줘라고 하면, Cursor가 웹을 검색해서 최신 공식 문서를 바탕으로 답변합니다. 프레임워크 버전이 올라가면서 바뀐 API를 확인할 때 특히 유용합니다.
6. 실전 워크플로우 — 3가지 핵심 패턴
패턴 1: 새 기능 개발
- 설계 논의: 채팅창에 “이 기능을 추가하려고 하는데, 어떤 파일들을 수정해야 할까?”라고 물어봅니다. Cursor가 프로젝트 구조를 분석해서 관련 파일 목록을 제시합니다.
- Composer 작성: 설계가 확정되면 Composer로 실제 코드를 작성합니다. 여러 파일을 한 번에 수정합니다.
- 코드 리뷰: 채팅창에서 “방금 수정한 코드에서 보안 문제가 있을까?”라고 물어봅니다. SQL 인젝션, XSS, 인증 누락 등을 점검합니다.
패턴 2: 리팩토링
거대한 함수를 선택하고 Command+K(macOS) / Ctrl+K(Windows)로 인라인 편집을 시작합니다. “이 함수를 3개의 작은 함수로 분리해줘”라고 하면, 즉시 제안이 나옵니다. 단일 책임 원칙을 적용한 분리 방식을 제안하고, 각 함수의 역할을 주석으로 설명해 줍니다.
패턴 3: 테스트 작성
함수를 선택하고 “이 함수에 대한 단위 테스트를 pytest로 만들어줘”라고 합니다. 정상 케이스뿐 아니라 엣지 케이스(빈 입력, 경계값, 예외 상황)까지 자동으로 고려해 줍니다. 테스트 커버리지를 높이는 데 효과적입니다.
이 세 가지 워크플로우만 익숙해져도, 개발 속도가 확연히 올라갑니다.
요약: Cursor AI 시작 가이드
Cursor는 Copilot의 자동완성을 넘어, 프로젝트 전체를 이해하고 여러 파일을 동시에 수정하는 에이전트급 도구입니다. 핵심은 세 가지입니다:
.cursorrules로 프로젝트 규칙을 학습시키고- Composer로 멀티 파일 편집을 하고
- @ mentions으로 외부 문서까지 참조
처음이시라면 무료 플랜으로 시작해서 .cursorrules와 Command+K 인라인 편집부터 연습해 보세요. 익숙해지면 Composer로 멀티 파일 수정을 시도하고, 마지막으로 @ mentions으로 외부 문서 참조까지 확장하면 됩니다.
더 읽어보기
- Cursor 공식 홈페이지 — 다운로드 및 최신 기능 확인
- Cursor 공식 문서 — .cursorrules, Composer, Chat 상세 가이드
- Anthropic Claude — Cursor에서 사용하는 주력 AI 모델
이 채널에서 매주 AI 개발 도구 실전 가이드를 다루고 있습니다. 구독과 알림 설정 부탁드립니다.
