자동 컨텍스트 요약

대화가 모델의 컨텍스트 창 제한에 가까워지면 Cline은 자동으로 대화를 요약하여 공간을 확보하고 작업을 계속합니다.

작동 방식

Cline은 대화 중에 토큰 사용량을 모니터링합니다. 제한에 가까워지면 다음을 수행합니다.

1. 발생한 모든 일에 대한 포괄적인 요약을 생성합니다.
2. 모든 기술 세부 정보, 코드 변경 사항 및 결정을 보존합니다.
3. 대화 기록을 요약으로 대체합니다.
4. 중단된 지점에서 정확히 계속합니다.

이러한 일이 발생하면 요약 도구 호출이 표시되며, 채팅 보기에서 다른 API 호출과 마찬가지로 총 비용을 보여줍니다.

이것이 중요한 이유

이전에는 Cline이 컨텍스트 제한에 도달하면 이전 메시지를 잘라냈습니다. 이는 대화 초기의 중요한 컨텍스트를 잃는 것을 의미했습니다.

이제 요약 기능을 통해:

• 모든 기술적 결정 및 코드 패턴이 보존됩니다.
• 파일 변경 사항 및 프로젝트 컨텍스트가 그대로 유지됩니다.
• Cline은 자신이 수행한 모든 작업을 기억합니다.
• 중단 없이 훨씬 더 큰 프로젝트에서 작업할 수 있습니다.

tip

컨텍스트 요약은 포커스 체인과 아름답게 시너지를 이룹니다. 포커스 체인이 활성화되면 할 일 목록이 요약 전반에 걸쳐 유지됩니다. 이는 Cline이 각 재설정을 통해 그를 안내하는 할 일 목록을 따라가면서 여러 컨텍스트 창에 걸쳐 있는 장기적인 작업을 수행할 수 있음을 의미합니다.

기술 세부 정보

요약은 이미 사용 중인 동일한 모델을 사용하여 구성된 API 공급자를 통해 이루어집니다. 프롬프트 캐싱을 활용하여 비용을 최소화합니다.

1. Cline은 요약 프롬프트를 사용하여 대화 요약을 요청합니다.

2. 요약이 생성되면 Cline은 대화 기록을 Cline에게 작업을 계속하도록 요청하고 요약을 컨텍스트로 제공하는 연속 프롬프트로 대체합니다.

자동 요약이 시작되는 시점에 대한 모델마다 다른 컨텍스트 창 임계값이 있습니다. context-window-utils.ts에서 임계값이 어떻게 결정되는지 확인할 수 있습니다.

비용 고려 사항

요약은 대화에서 기존 프롬프트 캐시를 활용하므로 다른 도구 호출과 거의 동일한 비용이 듭니다.

대부분의 입력 토큰은 이미 캐시되어 있으므로 주로 요약 생성(출력 토큰)에 대한 비용을 지불하게 되므로 매우 비용 효율적입니다.

체크포인트로 컨텍스트 복원

체크포인트를 사용하여 요약이 발생하기 전의 작업 상태를 복원할 수 있습니다. 이는 컨텍스트를 실제로 잃지 않는다는 것을 의미합니다. 항상 대화의 이전 버전으로 되돌릴 수 있습니다.

note

요약 도구 호출 전에 메시지를 편집하면 체크포인트와 유사하게 작동하여 대화를 해당 지점으로 복원할 수 있습니다.

차세대 모델 지원

자동 압축은 차세대 모델에 훨씬 더 잘 작동하는 것으로 밝혀진 고급 LLM 기반 요약을 사용합니다. 현재 다음 모델에 대해 이 기능을 지원합니다.

• Claude 4 시리즈
• Gemini 2.5 시리즈
• GPT-5
• Grok 4

note

다른 모델을 사용하는 경우, 설정에서 자동 압축이 활성화되어 있더라도 Cline은 자동으로 표준 규칙 기반 컨텍스트 잘림 방식으로 대체됩니다.