번역 자료 / / 2025. 5. 20. 07:26

[cursor docs] Managing Context

개요

Cursor의 Managing Context 기능은 코드베이스 내에서 AI가 어떤 정보를 참고할지 효율적으로 관리할 수 있도록 도와줍니다. 이 글에서는 컨텍스트 관리의 개념, 다양한 상태, 실제 사용 방법, 그리고 실무에서의 활용 팁을 단계별로 설명합니다.

Managing Context란?

Managing Context는 Cursor에서 AI가 코드베이스의 어떤 부분을 참고할지 선택하고, 컨텍스트 윈도우의 한계를 극복하기 위해 정보를 요약하거나 생략하는 기능입니다. 이를 통해 대용량 프로젝트에서도 효율적으로 AI의 도움을 받을 수 있습니다.

컨텍스트 메뉴 활용

  • 컨텍스트 메뉴를 통해 모델에 보낼 파일, 폴더, 코드를 직접 선택할 수 있습니다.
  • 필요한 정보만 선별적으로 포함시켜, AI의 응답 품질을 높일 수 있습니다.

컨텍스트 상태

Cursor는 컨텍스트 윈도우의 크기에 따라 파일을 다음과 같이 처리합니다.

1. Condensed (요약)

  • 파일/폴더가 너무 커서 전체를 포함할 수 없을 때, 함수 시그니처, 클래스, 메서드 등 핵심 구조만 요약해서 모델에 제공합니다.
  • 모델이 필요하다고 판단하면 특정 파일을 더 확장해서 볼 수 있습니다.
  • 이 방식으로 컨텍스트 윈도우를 최대한 효율적으로 활용합니다.

2. Significantly Condensed (대폭 요약)

  • 파일이 너무 커서 요약조차 불가능할 때, 파일명만 모델에 전달됩니다.
  • 이 경우 AI는 해당 파일의 구체적 내용은 알 수 없습니다.

3. Not included (미포함)

  • 경고 아이콘이 표시된 파일/폴더는 컨텍스트 윈도우에 포함될 수 없음을 의미합니다.
  • 이로 인해 AI가 해당 코드의 내용을 참고하지 못할 수 있습니다.
상태 설명
Condensed 구조적 요소만 요약 포함
Significantly Condensed 파일명만 포함, 내용은 미포함
Not included 컨텍스트 윈도우에 포함 불가, AI가 내용 참고 불가

실제 사용 팁

  • 대용량 파일이나 폴더는 자동으로 요약되므로, 중요한 부분은 별도 파일로 분리해두면 AI가 더 잘 참고할 수 있습니다.
  • 컨텍스트 메뉴를 적극 활용해, 꼭 필요한 정보만 AI에 전달하세요.
  • 경고 아이콘이 뜨는 파일은 AI가 참고하지 못하니, 중요한 로직은 분할 관리가 유리합니다.

참고 자료

반응형
  • 네이버 블로그 공유
  • 네이버 밴드 공유
  • 페이스북 공유
  • 카카오스토리 공유