Cursor AI 대형 레포 실전 경험담: Claude 3.5 Sonnet 컨텍스트 한계와 원인 분석

대형 레포지토리에서 Cursor AI를 열면 이런 일이 생겨요. AI가 엉뚱한 파일을 참조하거나, 이미 수정한 코드를 되돌리거나, 갑자기 맥락을 잃어버린 것 같은 답변을 내놓는 거예요. Cursor가 나쁜 도구여서가 아니에요. Claude 3.5 Sonnet의 컨텍스트 윈도우가 실제 대형 레포 환경에서 어떻게 작동하는지 이해하면, 이 현상이 꽤 자연스럽게 보여요. 2026년 현재, AI 에디터를 팀 단위로 도입하는 기업이 빠르게 늘면서 이 문제는 단순 불편을 넘어 개발 생산성 설계의 핵심 변수가 됐어요.

핵심 요약

• Claude 3.5 Sonnet의 컨텍스트 윈도우는 최대 200K 토큰이지만, Cursor AI가 실제로 모델에 넘기는 유효 컨텍스트는 레포 구조와 설정에 따라 10K~40K 수준으로 줄어드는 경우가 많아요.
• 10만 줄 이상 대형 레포에서는 관련 파일 선택 자체가 병목이 되며, AI가 “잘못된 파일"을 참조하는 현상의 주 원인이 바로 이 인덱싱 한계예요.
• Claude Code(CLI)로 전환한 개발자들의 Reddit 경험담에 따르면, 같은 Claude 3.5 Sonnet 모델이라도 컨텍스트 관리 방식 차이가 작업 품질에 두드러진 차이를 만들었어요.
• Cursor의 .cursorignore 설정과 @file 명시 참조로 유효 컨텍스트를 수동 제어하는 게, 2026년 현재 가장 현실적인 대응이에요.

대형 레포와 AI 에디터, 뭐가 달라요?

Cursor AI 에디터가 처음 나왔을 때, 많은 팀이 기대했어요. “이제 AI가 레포 전체를 이해하겠구나.” 실제로 Cursor는 레포지토리 전체를 인덱싱하고, 질문할 때 관련 파일을 자동으로 컨텍스트에 넣어줘요.

그런데 실전은 달랐어요.

Cursor가 인덱싱하는 방식은 벡터 임베딩 기반 유사도 검색이에요. “이 질문과 비슷한 파일"을 골라서 모델에 넣는 거예요. 5천 줄짜리 소규모 레포에선 꽤 잘 돼요. 그런데 마이크로서비스 구조에 10개 이상 서비스, 20만 줄 이상 코드베이스라면? 유사도 기반 검색이 실제 의존성 관계를 제대로 못 잡는 경우가 잦아져요.

예를 들어 auth 서비스를 수정하면서 user-profile 서비스의 DTO 변경 사항을 물으면, AI가 관련 없는 다른 서비스 파일을 가져오는 일이 생겨요. Cursor가 멍청한 게 아니에요. 임베딩 유사도상 그 파일이 더 가까워 보인 거예요.

Claude 3.5 Sonnet의 최대 컨텍스트는 200K 토큰, 약 15만 단어예요. 이론상 꽤 넉넉해요. 그런데 Cursor는 실제로 200K 전부를 쓰지 않아요. 모델 응답 속도, 비용, 안정성을 고려해서 실질적으로 주입하는 컨텍스트는 훨씬 작아요. 2026년 기준 Cursor 공식 문서에는 “프로젝트 크기와 관련성에 따라 컨텍스트가 자동 조정된다"고 명시돼 있지만, 정확한 토큰 수는 공개하지 않아요.

실전에서 드러나는 세 가지 한계

파일 선택 오류: “엉뚱한 파일 문제”

대형 레포에서 가장 많이 겪는 증상이에요. Cursor가 자동으로 참조 파일을 고를 때, 의존성 그래프가 아닌 텍스트 유사도를 기준으로 삼아서 발생해요.

shanepark.tistory.com의 Claude Code vs Cursor 비교 사용기에 따르면, 이 현상은 특히 “공통 유틸리티가 여러 모듈에서 쓰이는 모노레포 구조"에서 두드러졌어요. 같은 utils.ts 파일명이 세 군데 있는 상황에서 Cursor는 의도와 다른 파일을 가져왔고, 이를 눈치채지 못한 채 그 파일 기준으로 수정이 진행됐죠.

해결책은 생각보다 간단해요. @file 명시 참조로 직접 파일을 지정하거나, .cursorignore로 불필요한 디렉터리를 제외하면 유효 컨텍스트 품질이 올라가요.

컨텍스트 소진: “세션 중반 품질 저하”

긴 대화를 이어가다 보면 어느 순간부터 AI 답변 품질이 떨어지는 느낌이 들 때가 있어요. 착각이 아니에요.

Claude 3.5 Sonnet의 컨텍스트 윈도우가 대화 기록으로 채워지면, 처음에 넣었던 코드 파일 일부가 자연스럽게 밀려나요. 특히 긴 코드 스니펫을 여러 번 붙여넣으면서 작업하면 토큰이 빠르게 소모돼요. jjeongil.tistory.com의 Claude Code 설정 가이드에서도 “세션을 주기적으로 리셋하거나, /clear 명령어로 컨텍스트를 비우는 습관"을 권장하고 있어요.

멀티파일 리팩토링: “절반만 바뀐 코드”

3개 이상 파일을 동시에 수정해야 하는 리팩토링 작업에서 한계가 뚜렷하게 나타나요. 모델이 파일 A를 수정하는 동안 파일 B의 변경 맥락을 충분히 유지하지 못해서, “파일 A는 수정됐는데 파일 B는 그냥 둔” 상태가 되는 거예요.

r/ClaudeAI Reddit 스레드에서 Cursor에서 Claude Code CLI로 전환한 개발자들은 이 문제를 “Cursor의 컨텍스트 관리 방식이 대화형이라 장기 작업에 약하다"고 설명했어요. CLI 방식은 파일을 명시적으로 지정해 넘기기 때문에, 대형 멀티파일 작업에서 더 일관된 결과를 냈다고 해요.

Cursor vs Claude Code CLI: 같은 모델, 다른 경험

같은 Claude 3.5 Sonnet 모델이지만, 인터페이스에 따라 체감 품질이 달라져요.

Cursor가 나쁜 도구가 아니에요. 5만 줄 이하 레포, 단일 언어 프로젝트, UI 개발 중심 작업에서는 여전히 생산성이 높아요. 반면 마이크로서비스, 대규모 모노레포, 복잡한 의존성 구조에서는 Claude Code CLI가 더 예측 가능한 결과를 냈다는 게 Reddit 실사용자들이 공통으로 말하는 내용이에요.

그래서 어떻게 써야 해요?

레포 규모별로 나눠볼게요.

5만 줄 이하: Cursor 기본 설정으로 충분해요. .cursorignore에 node_modules, dist, build 폴더만 제외해도 컨텍스트 품질이 눈에 띄게 올라가요.

5만~15만 줄: Cursor를 쓰되, @file 명시 참조를 습관화하세요. 멀티파일 작업 시작 전에 관련 파일을 직접 지정하고 들어가는 게 훨씬 안정적이에요. 긴 세션은 중간에 새 채팅으로 리셋하는 걸 권해요.

15만 줄 이상: Claude Code CLI 도입을 검토할 때예요. 진입 장벽이 있지만, 컨텍스트를 직접 제어할 수 있어서 대형 리팩토링 작업에서 일관성이 높아요. 단순 작업은 Cursor, 복잡한 멀티파일 작업은 CLI로 나눠 쓰는 팀도 많아요.

공통 팁 세 가지:

• 세션 시작 시 현재 작업 맥락을 짧게 요약해서 먼저 주입하기
• 코드 스니펫을 붙여넣을 때 필요한 부분만 잘라서 넘기기
• Cursor Rules(.cursorrules)에 레포 구조 개요를 적어두면 매 세션 컨텍스트 절약 가능

앞으로 6개월, 무엇을 지켜봐야 할까요?

Cursor는 2026년 초 기준으로 컨텍스트 관리 개선을 포함한 업데이트를 꾸준히 내놓고 있어요. 특히 의존성 그래프 기반 파일 선택 기능은 로드맵에 공개된 항목이에요. 이게 실제로 배포되면 대형 레포 경험이 상당히 달라질 거예요.

Anthropic의 Claude 3.5 Sonnet 자체도 컨텍스트 활용 효율이 지속적으로 올라오고 있어요. 같은 200K 윈도우라도 “어떤 정보를 얼마나 잘 기억하느냐"가 버전마다 달라지거든요.

핵심 요약이에요:

• 대형 레포에서의 한계는 모델 문제가 아니라 컨텍스트 관리 방식 문제예요
• Cursor의 자동 인덱싱은 중소 규모에서 강점, 대형 레포에서는 직접 제어가 더 나아요
• Claude Code CLI는 같은 모델로 더 예측 가능한 결과를 원할 때 유효한 선택지예요
• .cursorignore, @file 명시, 세션 리셋 세 가지만 잘 써도 체감 품질이 달라져요

지금 팀의 레포는 몇 줄인가요? 그 숫자가 어떤 도구를 선택할지보다, “어떻게 쓸지"를 결정하는 더 중요한 변수예요.

참고자료

1. Claude Code 잘 쓰는 법: 2026년 생산성 높이는 설정, 플러그인, MCP 서버 가이드 :: 쵸코쿠키의 연습장
2. 클로드 코드 vs 커서 비교 사용기 - Shane’s planet - 티스토리
3. r/ClaudeAI on Reddit: I moved from Cursor to Claude Code (CLI). Here is what I learned about Sub-age

Photo by Possessed Photography on Unsplash