Claude Code의 "컨텍스트 로트(Context Rot)" 관리 방법 (Anthropic 권장 워크플로우)

Claude Code 세션을 시작할 때는 잘 되다가 메시지 15번쯤 넘어가면 버그 수정하느라 엉망인 루프에 빠진다면, 당신은 컨텍스트 로트(context rot)를 겪고 있는 겁니다.

저는 Anthropic의 세션 관리 문서를 파고들어 왜 세션이 그렇게 빨리 저하되는지 알아냈고, 이를 해결하기 위한 워크플로우를 만들었습니다. 핵심 요약은 다음과 같습니다:

• CLAUDE.md를 200줄 미만으로 유지하세요. 이 파일은 세션을 시작할 때마다 컨텍스트에 로드됩니다. 일종의 보이지 않는 토큰 세금이죠. 빌드 명령어와 핵심 규칙만 엄격하게 적어두세요.
• API 문서를 복사해서 붙여넣지 마세요. Google의 NotebookLM으로 MCP 서버를 설정하세요. Claude가 사양을 확인해야 할 때, NotebookLM에 쿼리를 보내서 수천 개의 토큰을 잡아먹는 대신 관련 단락만 가져오게 하세요.
• /compact 명령어를 직접 제어하세요. 컨텍스트가 꽉 찼을 때(모델 성능이 가장 떨어질 때) 자동으로 컴팩트가 실행되게 두지 마세요. 다음과 같이 선제적으로 실행하세요: /compact focus on the auth refactor, drop the test debugging.
• 버그를 3번 이상 수정하려고 하지 마세요. 채팅 기록에 남아있는 실패한 코드는 모델의 추론 능력을 오염시킵니다(앵커링 문제). 2번째 시도에서도 실패하면 /rewind (Esc Esc)를 사용하여 실패 기록을 삭제하거나 /clear로 초기화하세요.

MCP 설정에 필요한 모든 터미널 명령어와 Anthropic의 컨텍스트 툴킷을 위한 요약 표를 제 블로그에 노션 스타일로 깔끔하게 정리해 두었습니다.

🔗 전체 내용 확인하기: mindwiredai.com - Claude Code Habits Wasting Your Tokens

이번 주에 여러분의 API 크레딧을 아끼는 데 도움이 되길 바랍니다!