Cursor에 프로젝트를 맡겼는데 문맥 한도 경고가 뜨거나 첨부한 코드가 빠져 있으면 어디부터 줄일지 막막합니다. 2026년 10월 6일 기준, 대규모 코드베이스에서 필요한 문맥을 고르고 작업을 나누는 방법을 정리했습니다.
폴더 전체를 한꺼번에 넣기보다 관련 파일과 실패 상황부터 지정하고, 탐색·수정·검증을 나눠 진행하십시오. 200k를 모든 모델의 고정 한도로 보지 않습니다. 실제 한도와 제공 기능은 현재 선택한 모델·모드의 공식 표기에서 확인해야 합니다.
코드베이스 검색과 한 번에 읽는 문맥은 구분합니다
프로젝트가 검색 대상에 있다는 것과 모든 파일이 한 요청에 들어갔다는 것은 다른 문제입니다. Cursor 공식 문서는 저장소를 이해하고 관련 코드를 찾는 기능을 안내합니다. 답변에서 다룬 파일과 실제 수정한 파일을 확인해야 “전체를 읽었다”는 설명만으로 생기는 착오를 줄일 수 있습니다.
문맥 한도는 파일 개수나 저장소 용량만으로 판단하지 않습니다. 요청문, 첨부 코드, 대화 기록과 답변에 쓸 공간이 함께 영향을 줍니다. 공식 모델 표의 기본 문맥과 최대 문맥을 확인하되, 큰 한도가 작업 정확성까지 뜻한다고 생각하지 않습니다.
관련 파일과 재현 상황부터 전달합니다
버그 수정이라면 재현 방법, 기대 결과, 실제 결과와 오류가 발생한 파일을 먼저 제시합니다. 그다음 직접 호출하는 함수와 관련 테스트를 찾아 추가합니다. 모델이 무엇을 더 읽어야 하는지 판단할 수 있도록 경로와 파일 역할을 함께 적는 방법이 좋습니다.
예를 들어 “결제 버튼에서 오류 발생”이라는 요청보다 “결제 화면의 제출 함수, API 처리 파일, 해당 검증 테스트를 읽고 원인을 설명해 달라”는 요청이 범위를 분명하게 합니다. 오류 로그도 필요한 부분만 전달합니다. 끝없이 쌓인 로그와 생성 파일을 통째로 넣기보다 문제와 연결되는 구간을 고릅니다.
| 항목 | 확인할 내용 |
|---|---|
| 탐색 | 진입 파일과 호출 관계를 확인하고 필요한 추가 파일 목록 정리 |
| 수정 | 확정한 원인과 변경 범위, 유지할 동작을 전달 |
| 검증 | 관련 테스트와 재현 절차로 실제 결과 확인 |
| 인수인계 | 변경 파일, 결정 이유, 검사 결과와 남은 문제 요약 |
| 제외 규칙 | 생성물·의존성 등 불필요한 경로와 민감 파일의 처리 규칙 확인 |
다른 AI 작업에 넘길 결과 형식은 1인 개발자 코드·자료 조사·썸네일 AI 조합에서도 예시를 볼 수 있습니다.
제외 규칙은 필요한 코드와 분리해서 정합니다
Cursor 공식 Ignore file 문서는 프로젝트 루트의 .cursorignore로 접근할 경로를 제한하는 방법을 안내합니다. 생성 결과나 외부 의존성처럼 현재 문제와 무관한 대용량 자료를 제외하면 필요한 파일을 찾는 범위를 줄일 수 있습니다. 제외 후에는 필요한 소스가 빠지지 않았는지 확인합니다.
다만 제외 규칙을 비밀정보 보호의 전부로 생각해서는 안 됩니다. 공식 문서는 에이전트가 사용하는 터미널과 MCP 도구에 같은 파일 접근 제한이 적용되지 않는다고 설명합니다. 별도로 민감한 파일을 읽지 않도록 작업 범위를 정하고, 오류 메시지를 전달할 때도 키나 인증정보가 포함되지 않았는지 확인합니다.
이번 작업에 필요하지 않은 코드를 먼저 제외하고 필요한 부분만 추가하는 순서가 좋습니다. 규칙을 너무 넓게 쓰면 원인 파일까지 숨길 수 있습니다. 파일이 없다고 답하면 경로를 다시 확인하고 제외 설정의 영향인지 점검하십시오. 제외 규칙을 추가한 뒤에도 읽은 파일 목록을 확인해야 합니다.
출처: Cursor 공식 Docs의 모델·문맥 표와 Ignore file 안내. 정확한 한도와 메뉴는 설치한 버전 및 선택한 모델의 현재 안내를 확인합니다.
문맥이 커졌다면 작업 상태를 요약합니다
오래 이어진 대화에서는 해결한 문제와 앞으로 필요한 문맥을 구분합니다. 다음 작업에 전달할 요약에는 목표, 관련 파일, 이미 결정한 내용, 변경사항, 검사 결과와 남은 문제를 넣습니다. 코드 본문을 전부 복사하기보다 다시 읽을 파일 경로를 명시하십시오.
한 번에 여러 기능을 고치기보다 원인을 확인하고 수정한 뒤 검증하는 흐름으로 나눕니다. 한도 경고가 나타나면 첨부 범위와 대화 분량을 줄이고 필요한 파일을 다시 지정합니다. 이런 방법은 불필요한 문맥을 줄이는 제안이며, 모든 토큰 오류가 사라진다는 뜻은 아닙니다.
- 현재 모델과 모드의 문맥 한도를 확인합니다.
- 재현 상황과 진입 파일을 먼저 전달합니다.
- 필요한 호출 파일과 테스트를 찾아 추가합니다.
- 탐색·수정·검증을 나눠 실제 결과를 확인합니다.
- 새 작업에는 파일 경로와 검증 결과를 요약해 넘깁니다.
자주 묻는 질문
Q. Cursor의 한도는 언제나 200k입니까?
A. 아닙니다. 공식 문서는 모델별 문맥을 구분합니다. 선택한 모델과 모드의 현재 표기를 확인하고 과거 안내를 고정값으로 적용하지 않습니다.
Q. 폴더를 첨부하면 모든 파일을 읽었다고 봐도 됩니까?
A. 실제로 참조한 파일과 전달된 범위를 확인해야 합니다. 큰 폴더 전체를 한 번에 처리했다고 가정하기보다 관련 파일을 지정하고 결과를 점검합니다.
Q. .cursorignore만 있으면 민감 파일 접근이 모두 막힙니까?
A. 공식 문서는 터미널과 MCP 도구에 같은 제한이 적용되지 않는다고 설명합니다. 파일 제외와 별도로 읽기 범위와 도구 사용 권한을 관리해야 합니다.