Skip to main content

컨텍스트 관리

빠른 참조

  • 컨텍스트 = Cline이 프로젝트에 대해 알고 있는 정보
  • 컨텍스트 창 = Cline이 한 번에 보유할 수 있는 정보의 양
  • 프로젝트 지식을 유지하려면 컨텍스트 파일을 사용하십시오.
  • 컨텍스트 창이 가득 차면 재설정하십시오.

컨텍스트 및 컨텍스트 창 이해​

무한한 컨텍스트의 세계에서 컨텍스트 창은 Cline이 현재 사용할 수 있는 것입니다.

Cline과 함께 작업하는 것을 철저하고 적극적인 팀원과 협력하는 것이라고 생각하십시오.

컨텍스트가 구축되는 방식​

Cline은 두 가지 방식으로 컨텍스트를 적극적으로 구축합니다.

  1. 자동 컨텍스트 수집 (즉, Careti 주도)
    • 관련 파일을 사전에 읽습니다.
    • 프로젝트 구조를 탐색합니다.
    • 패턴 및 관계를 분석합니다.
    • 종속성 및 가져오기를 매핑합니다.
    • 명확한 질문을 합니다.
  2. 사용자 안내 컨텍스트
    • 특정 파일 공유
    • 문서 제공
    • Cline의 질문에 답변
    • 초점 영역 안내
    • 디자인 생각 및 요구 사항 공유

핵심 사항: Cline은 수동적이지 않습니다. 프로젝트를 이해하기 위해 적극적으로 노력합니다. 특히 계획 모드에서는 탐색하도록 하거나 초점을 안내할 수 있습니다.

컨텍스트 및 컨텍스트 창​

컨텍스트를 당신과 Cline이 공유하는 화이트보드라고 생각하십시오.

  • 컨텍스트는 사용 가능한 모든 정보입니다.
    • Cline이 발견한 것
    • 당신이 공유한 것
    • 대화 기록
    • 프로젝트 요구 사항
    • 이전 결정
  • 컨텍스트 창은 화이트보드 자체의 크기입니다.
    • 토큰으로 측정됩니다(1토큰 ≈ 영어 단어의 3/4).
    • 각 모델에는 고정된 크기가 있습니다.
      • Claude Sonnet 4: 1,000,000 토큰
      • Qwen3 Coder: 256,000 토큰
      • Gemini 2.5 Pro: 1,000,000+ 토큰
      • GPT-5: 400,000 토큰
    • 화이트보드가 가득 차면 Cline은 공간을 확보하기 위해 대화를 자동으로 요약합니다.

중요: 큰 컨텍스트 창이 있다고 해서 완전히 채워야 한다는 의미는 아닙니다. 대부분의 모델은 더 높은 제한을 주장하더라도 400-500K 토큰 부근에서 품질이 저하되기 시작합니다. 어수선한 화이트보드처럼 너무 많은 정보는 중요한 것에 집중하기 어렵게 만들 수 있습니다.

컨텍스트 창 진행률 표시줄 이해​

Cline은 진행률 표시줄을 통해 컨텍스트 창 사용량을 시각적으로 모니터링할 수 있는 방법을 제공합니다.

컨텍스트 창 진행률 표시줄

표시줄 읽기​

  • ↑는 입력 토큰(LLM으로 보낸 내용)을 보여줍니다.
  • ↓는 출력 토큰(LLM이 생성한 내용)을 보여줍니다.
  • 진행률 표시줄은 컨텍스트 창을 얼마나 사용했는지 시각화합니다.
  • 총계는 모델의 최대 용량(예: Claude Sonnet 4의 경우 1M)을 보여줍니다.

표시줄을 주시해야 할 때​

  • 긴 코딩 세션 중
  • 여러 파일로 작업할 때
  • 복잡한 작업을 시작하기 전
  • Cline이 컨텍스트를 잃는 것처럼 보일 때

팁: 자동 압축을 사용하면 Cline이 긴 대화를 자동으로 처리할 수 있습니다. 포커스 체인과 결합하면 진행 상황을 잃지 않고 여러 컨텍스트 창에 걸쳐 있는 복잡한 프로젝트에서 작업할 수 있습니다.

자동 컨텍스트 관리​

Cline은 컨텍스트를 자동으로 관리하는 지능적인 기능을 포함합니다.

계속 켜두어야 할 기본 설정​

포커스 체인 - v3.25에서 기본적으로 활성화됩니다. Cline은 작업 시작 시 할 일 목록을 생성하고 스레드가 벗어나지 않도록 컨텍스트에 유지합니다. 마크다운을 편집하여 단계를 추가하거나 재정렬할 수 있으며 Cline은 이에 적응할 것입니다. 포커스 체인에 대해 자세히 알아보기.

자동 압축 - 항상 켜져 있습니다. 컨텍스트 창이 제한에 도달하면 Cline은 포괄적인 요약을 생성하고, 부풀려진 기록을 대체하고, 중단된 지점에서 계속합니다. 결정, 코드 변경 및 상태가 보존됩니다. 자동 압축에 대해 자세히 알아보기.

고급 컨텍스트 도구​

컨텍스트 관리에 더 많은 제어가 필요할 때:

심층 계획 (/deep-planning)​

실질적인 기능, 리팩토링 또는 통합을 위한 것입니다. Cline은 코드베이스를 조사하고, 목표 질문을 한 다음, implementation_plan.md를 작성합니다. 정제되고 가치 있는 컨텍스트로 새로운 작업을 생성합니다. 심층 계획에 대해 자세히 알아보기.

새 작업 (/newtask)​

자연스러운 전환점에서 중요한 내용만 새로운 작업으로 패키징합니다. 연구 후 구현을 위한 깨끗한 시작 또는 팀원 간의 깔끔한 핸드오프. 새 작업에 대해 자세히 알아보기.

Smol (/smol)​

모멘텀을 유지하기 위해 대화를 제자리에서 압축합니다. 흐름을 깨고 싶지 않을 때 디버깅 또는 탐색 작업 중에 이상적입니다. Smol에 대해 자세히 알아보기.

Careti 컨텍스트 시스템 (AGENTS.md + .agents/context)​

장기 프로젝트를 위한 표준 컨텍스트 체계입니다. Careti AGENTS.md + .agents/context 폴더로 프로젝트 규칙과 컨텍스트를 관리합니다. Careti 컨텍스트 시스템 및 Careti 규칙을 확인하세요.

컨텍스트 파일 작업​

컨텍스트 파일은 세션 전반에 걸쳐 이해를 유지하는 데 도움이 됩니다. AI 비서가 프로젝트를 이해하는 데 특별히 도움이 되도록 설계된 문서 역할을 합니다.

컨텍스트 파일에 대한 접근 방식​

  1. 상시 프로젝트 컨텍스트 (Careti 컨텍스트 시스템)

    • AGENTS.md + .agents/context 폴더로 구성
    • 규칙/워크플로는 온디맨드로 로딩
    • 예시: .agents/context/coding-standards.md, .agents/context/api-guidelines.md
    • 장기 실행 프로젝트 및 팀에 유용합니다.

  2. 작업별 컨텍스트

    • 특정 구현 작업을 위해 생성됨

    • 요구 사항, 제약 조건 및 결정 문서화

    • 예시:

      # auth-system-implementation.md

      ## 요구 사항

      -   OAuth2 구현
      -   Google 및 GitHub 지원
      -   인증 엔드포인트에 대한 속도 제한

      ## 기술적 결정

      -   공급자 통합을 위해 Passport.js 사용
      -   세션 관리를 위해 JWT 사용
      -   속도 제한을 위해 Redis 사용

  3. 지식 이전 문서

    • 계획 모드로 전환해 지금까지의 성과와 다음 단계를 문서화합니다.
    • 문서 요약을 프로젝트 폴더에 기록하거나 새 작업의 컨텍스트로 사용합니다.
    • 필요하면 /newtask로 안전하게 핸드오프합니다.

컨텍스트 파일을 효과적으로 사용하는 방법​

  1. 구조 및 형식
    • 명확하고 일관된 구성 사용
    • 관련 예시 포함
    • 관련 개념 연결
    • 정보를 집중적으로 유지
  2. 유지 관리
    • 중요한 변경 후 업데이트
    • 컨텍스트 파일 버전 관리
    • 오래된 정보 제거
    • 주요 결정 문서화

실용적인 팁​

  1. 새 프로젝트 시작
    • Cline이 코드베이스를 탐색하도록 허용
    • 구조 및 패턴에 대한 질문에 답변
    • 기본 컨텍스트 파일 설정 고려
    • 주요 설계 결정 문서화
  2. 지속적인 개발
    • 중요한 변경 사항으로 컨텍스트 파일 업데이트
    • 관련 문서 공유
    • 복잡한 논의를 위해 계획 모드 사용
    • 필요할 때 새로운 세션 시작
  3. 팀 프로젝트
    • 공통 컨텍스트 파일 공유(프로젝트 루트에 .agents/context 파일 사용 고려)
    • 아키텍처 결정 문서화
    • 일관된 패턴 유지
    • 문서 최신 상태 유지

보너스 컨텍스트 팁​

  • 링크를 @ 멘션하고 웹 페이지의 컨텍스트를 Cline에 추가할 수 있습니다(문서, 블로그 등).
  • MCP 서버를 활용하여 외부 지식 기반에서 컨텍스트를 가져올 수 있습니다.
  • 스크린샷은 이미지 입력을 지원하는 모델의 컨텍스트로 사용할 수 있습니다.

결론​

Cline은 이미 많은 컨텍스트 작업을 수행합니다. 포커스 체인, 자동 압축 및 계획 흐름은 긴 시간 동안 스레드를 그대로 유지하도록 설계되었습니다. 목표는 Cline이 세션 전반에 걸쳐 프로젝트에 대한 일관된 이해를 유지하도록 돕는 것입니다.

기억하십시오: 목표는 모든 단계에서 중요한 것만 볼 수 있도록 하는 것입니다.