새 프로젝트에 Cursor 세팅하는 순서: 10분 체크리스트

핵심 요약: 새 저장소를 열 때마다 하는 세팅을 순서로 굳혀두면 10분입니다: ① 인덱싱 완료 대기(상태 표시줄 확인 — 이거 안 기다리고 시작하면 초반 답변 품질이 떨어집니다) ② .cursorignore(시크릿·대용량 산출물 제외) ③ 베이스 Rule 1개(팀 관례 30줄) ④ 영역 Rule 2~3개(globs로 파일 타입별) ⑤ @Docs 색인(주력 프레임워크 문서) ⑥ 프라이버시 모드 확인(회사 코드면 필수). 이 순서대로면 "AI가 우리 프로젝트를 아는 상태"에서 첫 작업을 시작할 수 있습니다.

이 글에서 다루는 내용: 6단계 상세와 이유, 단계별 소요 시간, 팀 저장소에 커밋할 것들.

① 인덱싱 완료 대기 (2~5분, 커피 타임)

프로젝트를 처음 열면 Cursor가 코드베이스 시맨틱 인덱스를 만듭니다. 이게 @codebase 검색과 자동 컨텍스트 수집의 기반이라, 끝나기 전에 질문을 시작하면 "프로젝트를 모르는 AI"와 대화하게 됩니다. 상태 표시줄의 인덱싱 표시가 끝날 때까지 기다리세요 — 체크리스트에서 가장 쉬운데 가장 자주 생략되는 단계입니다.

② .cursorignore (2분)

인덱싱·컨텍스트에서 제외할 것들을 등록합니다. 두 부류입니다 — 보안: .env, *.pem, credentials/ (읽히면 안 되는 것, 시크릿 보안 글 참고), 노이즈: 빌드 산출물, 대용량 데이터 파일, 생성 코드 (읽혀봐야 컨텍스트 낭비인 것). .gitignore와 별개라는 점을 기억하세요 — .gitignore는 커밋을, .cursorignore는 AI의 읽기를 막습니다.

③ 베이스 Rule 하나 (3분)

.cursor/rules/base.mdc에 alwaysApply로 프로젝트 상식을 30줄 이내로: 언어·응답 규칙, 스타일 관례, "새 의존성은 물어보고", "테스트 실패 상태로 마무리 금지" 같은 것들. 여기서 욕심내지 않는 게 요령입니다 — 항상 로드되는 규칙이므로 짧을수록 좋고, 긴 내용은 다음 단계로 넘깁니다.

④ 영역 Rule 2~3개 (5분)

파일 타입별로 globs 규칙을 나눕니다 — Python 규칙, 프론트엔드 규칙, 테스트 규칙 정도면 시작으로 충분합니다. 복사해 쓸 수 있는 예시는 Rules 레시피 글에 5개를 정리해 뒀습니다. 처음부터 완벽할 필요 없습니다 — "리뷰에서 두 번 지적한 것을 규칙으로 승격"하는 운영을 시작하는 게 중요합니다.

⑤ @Docs 색인 (2분)

설정 → Docs에서 주력 프레임워크의 공식 문서 URL을 추가합니다. 특히 최근 메이저 버전이 나온 프레임워크일수록 효과가 큽니다 — 모델의 학습 데이터가 구버전 문법을 기억하고 있는 문제를 @Docs가 상쇄합니다(멘션 활용법은 @멘션 총정리). 사내 API 문서가 웹에 있다면 그것도 추가 대상입니다.

⑥ 프라이버시 모드 확인 (30초)

회사 코드라면 시작 전에 설정에서 프라이버시 모드 활성 여부를 확인하세요. Teams 워크스페이스면 관리자 강제가 걸려 있는지, 개인이면 직접 켰는지 (상세 글). 첫 프롬프트를 보내기 전에 확인하는 게 의미 있는 유일한 시점입니다.

팀이라면: 커밋할 것들

②~④의 산출물(.cursorignore, .cursor/rules/)은 저장소에 커밋하세요. 다음 팀원은 이 체크리스트가 ①⑤⑥만 남고, 무엇보다 팀 전체의 AI 출력 품질이 같은 기준선에서 시작합니다. 도입기 팀의 정착 장치에 대해서는 팀 도입 글에서 더 다뤘습니다.

세팅을 굳히고 달라진 것

이 순서를 굳히기 전에는 새 프로젝트 첫날의 AI 경험이 늘 나빴습니다 — 프로젝트를 모르는 답변에 실망하고, 그제서야 Rules를 만들기 시작하는 패턴이었죠. 순서를 체크리스트로 만든 뒤로는 첫 작업부터 "일주일 같이 일한 AI" 수준에서 시작합니다. 10분의 선투자가 이후 모든 상호작용의 기준 품질을 올리는, 아마 Cursor에서 가장 이율 좋은 투자일 겁니다.

자주 묻는 질문 (FAQ)

Q. 기존 프로젝트에도 같은 순서를 적용하면 되나요?

A. 네, 순서는 동일합니다. 이미 쓰던 프로젝트라면 ②(.cursorignore)와 ③④(Rules)만 채워도 체감이 큽니다.

Q. Rules를 처음에 몇 개나 만들어야 하나요?

A. 베이스 1 + 영역 2~3이면 충분합니다. 나머지는 운영하면서 "반복 지적 → 규칙 승격"으로 자연스럽게 늘리세요. 처음부터 10개를 만들면 대부분 안 쓰입니다.

Q. CLAUDE.md 같은 파일은 없나요?

A. Cursor에서는 .cursor/rules/의 alwaysApply 규칙이 그 역할입니다. Claude Code와 병행한다면 CLAUDE.md와 베이스 Rule의 내용을 맞춰두면 두 도구가 같은 관례로 일합니다.

한눈에 보는 요약

인덱싱 대기 → .cursorignore → 베이스 Rule → 영역 Rules → @Docs → 프라이버시 확인. 10분이면 되고, 팀은 산출물을 커밋해서 다음 사람의 10분도 아껴주세요.

함께 보면 좋은 글

Cursor Rules 실전 레시피 5가지
Cursor @멘션 총정리 (2026년 기준)
Cursor 설치 및 초기 설정 방법

참고 자료

Rules 공식 문서 (Cursor Docs)
Cursor 공식 문서