[Claude Code] 컨텍스트 관리

1. Claude Code에서의 컨텍스트

- 클로드 코드가 현재 세션에서 기억하고 있는 모든 대화 내용과 작업 정보를 의미한다. 그만큼 기억할 수 있는 공간이 필요하며, 기억 공간이 부족해질 상황을 대비하기 위해 컨텍스트 관리가 필요하다.

 

 

2. /context

- 현재 컨텍스트 상태와 사용량을 확인하는 명령이다.

- 먼저 모델 정보(Sonnet 4.6)와 토큰 사용량/한도를 보여주고, 카테고리별 추정 사용량을 보여준다.

 

카테고리별 사용량 항목

- System prompt: 클로드 행동(코딩) 지침 및 규칙 정보

- System tools: 클로드가 사용할 수 있는 도구들. 파일 읽기, 명령어 실행, git 등이 포함됨

- Memory files: CLAUDE.md 같은 프로젝트 설정 파일. 매 메시지마다 로드됨

- Skills: 특정 작업의 구체적인 지침을 파일로 저장해둔 것. 매 메시지마다 로드되는 Memory files과 달리, 관련 작업시에만 로드된다는 차이점이 있음.

- Messages: 대화 기록. 60~70% 이상으로 너무 길어지면 /compact 명령으로 압축 권장

- Free space: 실제 여유 공간. 30% 이하로 떨어지면 /compact 명령으로 압축하거나 새 세션 시작 권장

- Autocompact buffer: 자동 압축을 위한 예비 공간

 

3. /compact

- 컨텍스트를 압축하여 이용 공간 및 토큰을 효율적으로 관리하기 위한 명령

- 주로 대화 내용을 압축하는데 많이 쓰임

- 시스템 프롬프트, 도구, 메모리 파일은 그대로 유지됨

- 압축 과정에 정보 손실이 발생할 수 있으니 압축하는게 항상 좋은 것은 아니다. 공간을 너무 많이 차지한다고 판단했을 때 압축하는 것이 좋다.

- 뒤에 옵션으로 어떤 부분 위주로 압축하고 싶은지 설명할 수도 있다. 선택사항이다.

- 압축 후 Ctrl + O 단축키로 전체 압축 과정을 요약해서 확인할 수 있다.