Claude Code, 왜 자꾸 까먹을까? — 컨텍스트 관리 실전 가이드

Claude Code, 왜 자꾸 까먹을까? — 컨텍스트 관리 실전 가이드

avatar
Aurum
2026.02.11조회수 336회

Claude Code의 치명적 약점: 기억력

Claude Code는 코드를 작성하고, 파일을 읽고, 터미널 명령어를 실행하는 강력한 도구입니다. 그런데 한 가지 치명적인 약점이 있어요. 대화가 길어지면 앞에서 한 얘기를 까먹습니다.


이건 버그가 아니라 구조적 한계예요. Claude Code는 "컨텍스트 윈도우"라는 정해진 크기의 작업 공간 안에서 동작합니다.


시스템 프롬프트, 대화 히스토리, 파일 내용, 도구 실행 결과가 전부 이 공간을 나눠 씁니다. 공간이 가득 차면? "Prompt is too long" 에러가 뜨면서 아무것도 못 합니다.


저도 파일 8개를 한번에 읽히다가 이 에러를 6번 연속으로 맞았습니다. 압축도 안 되고, 되감기도 안 되고, 결국 세션을 새로 시작해야 했어요. 그 삽질 끝에 정리한 컨텍스트 관리법을 공유합니다.


1. 컨텍스트 상태 확인: /context

먼저 현재 상태를 알아야 관리할 수 있겠죠. /context 명령어를 입력하면 이런 정보가 나옵니다:

Context Usage
Model: claude-opus-4-6
Tokens: 42k / 200k (21%)

Estimated usage by category
Category        Tokens    Percentage
System prompt   6.1k      3.0%
System tools    15.7k     7.8%
...

무엇이 공간을 차지하는지 카테고리별로 보여줍니다. 작업 중간중간 확인하는 습관을 들이면, 갑자기 터지는 상황을 예방할 수 있어요.



2. 컨텍스트가 꽉 찼을 때 대처법

아직 여유가 있을 때 → /compact

대화 내용을 요약해서 압축합니다. 히스토리는 유지하면서 토큰을 절약하는 방법이에요.

/compact

특정 내용만 남기고 싶으면 지시를 추가할 수도 있습니다:

/compact 파일 ...

회원가입만 해도
이 글을 무료로 읽을 수 있어요.

이미 계정이 있으신가요?로그인하기
댓글 9
avatar
Aurum
구독자 1,740명구독중 27명
투자 웨이트 트레이닝 독서와 여행 사진찍기와 맛집