개요
Cursor의 Codebase Indexing 기능은 AI가 코드베이스를 더 정확하게 이해하고, 검색 결과의 품질을 높이기 위해 도입된 핵심 기능입니다. 이 글에서는 Codebase Indexing의 개념, 설정 방법, 대규모 프로젝트에서의 활용 팁, 그리고 실무에서 유용하게 쓸 수 있는 사례를 단계별로 설명합니다.
Codebase Indexing이란?
Codebase Indexing은 Cursor가 프로젝트 내의 모든 파일을 인덱싱하여, AI가 코드의 맥락을 더 잘 파악할 수 있도록 하는 기능입니다. 이를 통해 코드 검색, 자동 완성, 문맥 기반 답변의 정확도가 크게 향상됩니다.
주요 특징 및 동작 방식
- 자동 인덱싱: 프로젝트를 열면 Cursor가 자동으로 인덱싱을 시작합니다.
- 실시간 동기화: 새 파일이 추가되면 자동으로 인덱싱되어 최신 상태를 유지합니다.
- 설정 관리:
Cursor Settings > Features > Codebase Indexing에서 인덱싱 상태를 확인할 수 있습니다.
고급 설정
- 전체 파일 인덱싱: 기본적으로 모든 파일이 인덱싱됩니다.
- 인덱싱 제외 설정:
.gitignore또는.cursorignore파일을 통해 인덱싱에서 제외할 파일/폴더를 지정할 수 있습니다. - 대용량 프로젝트 최적화: 대규모 모노레포에서는
.cursorignore를 활용해 불필요한 파일의 인덱싱을 방지하면 성능과 정확도를 높일 수 있습니다.
| 설정 파일 | 설명 |
|---|---|
| .gitignore | Git과 Cursor 모두에서 무시할 파일 지정 |
| .cursorignore | Cursor에서만 무시할 파일 지정 (개인화 가능) |
멀티 루트 워크스페이스 지원
- 여러 프로젝트를 동시에 작업할 때, 각 코드베이스가 자동으로 인덱싱됩니다.
- 각 프로젝트의 컨텍스트가 Cursor에 제공되어, 여러 프로젝트 간 작업이 효율적입니다.
.cursor/rules도 모든 폴더에서 지원됩니다.
실제 사용 사례
1. 신규 파일 추가 시 자동 인덱싱
프로젝트에 새로운 파일을 추가하면 별도의 설정 없이 자동으로 인덱싱되어, AI가 즉시 해당 파일을 인식합니다.
2. 대규모 모노레포에서의 효율적 관리
수십만 개의 파일이 있는 대형 프로젝트에서는 .cursorignore를 통해 인덱싱 범위를 제한하여, 필요한 부분만 AI가 빠르게 이해하도록 할 수 있습니다.
3. 멀티 프로젝트 환경에서의 활용
여러 개의 관련 프로젝트를 동시에 작업할 때, 각 프로젝트의 컨텍스트가 자동으로 인덱싱되어 AI가 모든 코드베이스를 이해할 수 있습니다.
FAQ 요약
- 인덱싱된 코드베이스 목록 확인: 현재는 각 프로젝트에서만 인덱싱 상태를 확인할 수 있습니다.
- 전체 코드베이스 삭제: 계정 삭제 또는 개별 프로젝트에서 인덱싱을 해제해야 합니다.
- 인덱싱 파일 수 제한: Pro는 5만 개, Business는 25만 개까지 자동 인덱싱됩니다.
참고 자료
반응형
