컨텍스트와 토큰 관리
클로드 코드를 잘 쓰는 사람과 못 쓰는 사람의 가장 큰 차이는 "컨텍스트 관리"에서 갈립니다. 이 장에서는 왜 컨텍스트를 관리해야 하는지, 그리고 어떻게 관리하는지를 다룹니다.
1. 컨텍스트란?
컨텍스트(context)는 클로드가 현재 답변을 만들기 위해 참고하는 "기억의 창"입니다. 여기에는 다음이 모두 포함됩니다.
컨텍스트에는 한계(예: 200K 토큰)가 있습니다. 그리고 중요한 사실이 하나 있습니다.
2. 컨텍스트가 길수록 똑똑해지지 않습니다
많은 분이 "대화를 많이 할수록 클로드가 내 프로젝트를 더 잘 이해하겠지"라고 생각합니다. 사실은 반대인 경우가 많습니다.
컨텍스트가 길어지고 불필요한 내용이 쌓일수록, 모델은 정작 중요한 정보를 놓치고 답변 품질이 떨어집니다. 여러 연구에서도 컨텍스트가 길어질수록 중간에 있는 정보를 잘 활용하지 못하고 성능이 저하되는 현상이 확인되었습니다.
- 관련 연구(NoLiMa): https://arxiv.org/abs/2502.05167
웹에서 클로드와 대화가 길어지면 "새 대화를 시작하라"는 안내가 나오는 것도 같은 이유입니다.
3. 컨텍스트 관리 3대 명령어
| 명령어 | 동작 | 언제 쓰나 |
|---|---|---|
/context | 현재 토큰 분포를 시각화 | 컨텍스트 상태 점검 |
/clear | 대화를 완전히 초기화 | 새 작업을 시작할 때 |
/compact | 대화를 요약해 축소 | 맥락은 유지하며 토큰만 줄일 때 |
3.1 /context — 상태 점검
/context로 지금 컨텍스트에 무엇이 얼마나 차 있는지 확인하세요. 사람이 입력한 메시지뿐 아니라 시스템 프롬프트, MCP 등이 차지하는 양도 함께 보입니다. 컨텍스트가 절반 이상 차 있다면 정리할 때가 된 것입니다.
3.2 /clear — 새 작업의 시작
새로운 주제나 작업으로 넘어갈 때는 /clear로 비우는 것이 기본입니다. 파일은 그대로 유지되니 안심하세요. "작업 하나 = 세션 하나" 정도로 생각하면 좋습니다.
3.3 /compact — 맥락 유지하며 축소
작업을 이어가야 하는데 대화가 길어졌다면 /compact로 요약합니다. 핵심 맥락은 남기고 토큰만 줄입니다. 특히 하루 작업을 마칠 때 /compact로 요약해두고, 다음 날 그 요약을 바탕으로 이어가면 효율적입니다.
4. 토큰 절약 실전 팁
클로드 코드는 사용량(토큰)에 따라 한도가 소진됩니다. 다음 방법으로 토큰을 아낄 수 있습니다.
| 방법 | 명령/동작 | 효과 |
|---|---|---|
| 모델 다운그레이드 | /model로 Haiku/Sonnet 전환 | 단순 작업의 비용 절감 |
| 대화 요약 | /compact | 긴 대화를 축소 |
| 세션 초기화 | /clear | 불필요한 대화 제거 |
| 직접 실행 | ! Bash 모드 | 간단한 명령은 클로드를 안 거침 |
| 파일 콕 집기 | @파일명 | 엉뚱한 파일 탐색 방지 |
실전 전략
- 반복·단순 작업 → Haiku 모델 + Bash 모드 적극 활용
- 복잡한 설계·디버깅 → Opus/Sonnet 모델
- 작업 단위마다
/clear로 새출발 /context로 컨텍스트 상태를 수시 점검하는 습관 들이기
다음 장에서는 이 명령어들을 하나의 작업 흐름으로 엮어, 실제 프로젝트를 진행하는 전체 워크플로우를 살펴봅니다.