
"you've hit your limit" 이 문장이 무서운 분들께
클로드 코드(Claude Code)를 열심히 쓰다 보면 한 번쯤은 보게 되는 문장이 있죠.
"you've hit your limit."
할 일은 산더미인데 AI는 멈춰버리고, 기껏 잡아놨던 맥락도 다 날아가는 그 황당함. 저도 처음엔 그냥 "메시지를 너무 많이 보냈나 보다" 하고 넘겼어요.
그런데 사실 이건 메시지 수의 문제가 아니었어요. 구조적인 이유가 따로 있었고, 그걸 알고 나면 같은 요금제로도 훨씬 더 많이 쓸 수 있어요.
오늘은 클로드 코드가 왜 토큰을 빠르게 소진하는지, 그리고 5가지 습관만으로 한도 걱정을 없애는 방법을 정리해 드릴게요.
토큰이 뭔지부터 짚고 가요
토큰은 AI가 텍스트를 처리하는 최소 단위예요. 한국어 기준으로 한 글자가 약 2~3토큰, 영어 단어 하나는 1~2토큰 정도예요. Claude는 메시지 수가 아니라 이 토큰의 누적량으로 사용량을 계산해요.
여기서 한 가지 중요한 점이 있어요. Claude의 사용 한도는 자정에 리셋되지 않아요. 최근 5시간 동안 사용한 토큰만 한도에 포함되고, 5시간이 지난 토큰은 자동으로 빠지는 방식이에요. 즉, 사용 시간을 분산하면 같은 요금제로도 훨씬 더 오래 쓸 수 있어요.
그런데 문제는 "내가 얼마나 보냈느냐"가 아니에요. Claude Code가 내부적으로 어떻게 토큰을 쓰는지가 핵심이에요.
충격적인 사실, 토큰의 95.7%는 복습에 쓰인다
많은 분들이 모르는 진짜 이유가 여기 있어요.
Claude Code는 메시지를 받을 때마다 이전 대화를 처음부터 끝까지 다시 읽어요. 매번요.
실제 분석 데이터를 보면 80개 세션, 38,000개 대화 턴을 분석했을 때 전체 토큰 사용량의 95.7%가 이전 대화를 다시 읽는 데 쓰였어요. 사용자가 새로 입력한 내용은 단 0.03%에 불과했고요. 100분 중 96분은 AI가 과거를 복습하고, 4분만 실제 작업을 하는 셈이에요.
대화가 길어질수록 이 낭비는 기하급수적으로 커져요. 100개 이상 메시지가 쌓인 채팅창에서는 메시지당 평균 500토큰 기준으로 250만 토큰 이상을 소모하는데, 그중 98.5%는 이전 대화를 다시 읽는 데 쓰여요.
2026년 3월에는 Claude Code v2.1.100 버전이 매 요청마다 약 2만 개의 불필요한 토큰을 추가하는 버그가 발견되기도 했어요. 사용자들이 예상보다 40% 빠르게 할당량을 소모했던 사건이었죠. 이처럼 토큰 구조를 모르면 내가 모르는 사이에 계속 손해를 보게 돼요.
오해 하나, 메시지를 줄이면 되겠지?
많은 분들이 "짧게 자주 보내면 토큰이 절약되겠지"라고 생각하죠. 오히려 반대예요.
질문 3개를 따로 나눠 보내면 컨텍스트 로딩이 3번 발생해요. 3개를 한 번에 묶어 보내면 1번으로 줄어들어요. 질문을 쪼갤수록 오히려 더 많은 토큰을 쓰는 구조예요.
또 하나 놓치는 포인트가 있어요. 잘못된 답변을 받았을 때 "이렇게 하지 마"라는 후속 메시지를 보내는 분들 많죠. 이것도 손해예요. 원본 메시지의 편집(Edit) 기능을 눌러 수정하고 다시 생성하면 이전 대화가 쌓이지 않아서 토큰이 절약돼요. 작은 습관 하나가 쌓이면 하루에 쓸 수 있는 작업량이 완전히 달라져요.
실전 해결책 1, 슬래시 명령어 4가지 제대로 활용하기
Claude Code에는 토큰 관리에 직접 도움이 되는 슬래시 명령어가 4가지 있어요.
첫 번째는 /context(또는 최신 버전의 /usage)예요. 현재 대화창이 얼마나 채워졌는지 확인할 수 있어요. CLAUDE.md 파일 크기에 따라 처음부터 쓰는 토큰량이 달라지는데, 파일이 730줄이면 세션 시작 시 3만 토큰을 쓰지만 180줄이면 5천 토큰으로 시작할 수 있어요.
두 번째는 /clear예요. 완전히 새로운 대화를 시작하는 명령어예요. 그냥 치면 맥락이 날아가니, 먼저 "지금까지 한 것 정리해줘. 결정된 것, 안 정해진 것, 다음 할 일까지"라고 입력해서 요약본을 복사한 다음 /clear를 치고 새 창에 붙여 넣으면 맥락은 이어가면서 토큰은 대폭 줄어들어요.
세 번째는 /compact예요. AI가 이전 대화를 자동으로 요약해 교체하는 기능이에요. 중요한 점은, 대화창이 꽉 찬 상태에서 쓰면 요약의 질이 떨어질 수 있어요. 60~70% 시점에 쓰는 게 훨씬 효과적이에요. "/compact API 사용법과 코드 샘플을 중심으로 압축해줘"처럼 보존할 내용을 직접 지정할 수도 있어요.
네 번째는 /rewind예요. AI가 틀린 답변을 했을 때 그 기록을 그냥 두면 다음 요청에서 틀린 내용까지 다시 읽어요. /rewind를 쓰거나 ESC 키를 두 번 누르면 원하는 시점으로 돌아가서 낭비된 토큰을 회수할 수 있어요.
실전 해결책 2, 대화창 60~70%에서 리셋해야 하는 데이터 근거
왜 꽉 채우지 않고 60~70%에서 리셋해야 할까요? 경험칙이 아니라 데이터 기반의 이유가 있어요.
Anthropic 공식 벤치마크 기준으로 Opus 모델은 256K 토큰 시점에서 93%의 정확성을 보였지만, 100만 토큰에 가까워지면 76%로 성능이 떨어졌어요. 컨텍스트 크기를 10K에서 100K로 늘렸을 때 정확도가 20~50%까지 하락한다는 연구 결과도 있어요.
컨텍스트가 많다고 더 잘하는 게 아니에요. AI도 정보가 너무 많이 쌓이면 성능이 저하돼요. Claude Code를 쓰다가 응답이 느려지거나 엉뚱한 대답이 나온다면, 토큰 한계에 가까워진 상태일 가능성이 높아요. 꽉 채운 채로 쓰는 건 돈도 낭비하고 성능도 낭비하는 이중 손해예요.
실전 해결책 3, CLAUDE.md를 200줄 이하로 유지하기
CLAUDE.md 파일은 Claude에게 프로젝트 규칙을 알려주는 지침 파일이에요. 이 파일은 새 대화창을 열 때마다 자동으로 로딩돼요.
5,000토큰 크기의 CLAUDE.md가 있다면, 메시지를 보낼 때마다 매번 5,000토큰의 기본 비용이 발생해요. 다른 작업을 하고 있어도 상관없이요.
2026년 분석에 따르면, 모든 지식을 CLAUDE.md에 몰아넣는 대신 필요할 때만 로드되는 스킬(skills) 아키텍처로 분리한 결과 세션당 약 15,000토큰을 절약할 수 있었어요. 82% 개선된 수치예요.
실제로 730줄이었던 CLAUDE.md를 102줄로 줄이면 파일 용량이 9.4K에서 약 2K 수준으로 내려와요. Anthropic 공식 문서도 CLAUDE.md를 200줄 이하로 유지하라고 명시하고 있어요.
매일 반드시 필요한 핵심 규칙만 남기고, 특정 작업에만 필요한 내용은 별도 파일로 분리해 필요할 때만 불러오는 방식이 가장 효과적이에요.
실전 해결책 4, 파일 포맷 세팅과 Plan 모드 활용
PDF나 DOCX 파일을 그대로 Claude에게 넘기면 손해예요.
글씨 외에도 폰트, 색깔, 표, 테두리, 페이지 번호 같은 시각적 정보가 가득한데, AI에게는 이게 전부 불필요한 토큰이에요. 이런 서식 정보가 전체 토큰의 90% 이상을 차지하는 경우도 있어요.
HTML을 마크다운으로 변환하면 평균 87%, 최대 91.5%까지 토큰이 감소해요. PDF나 DOCX도 마크다운 형태로 변환해 사용하면 3분의 1에서 절반까지 줄어들 수 있어요.
또 하나는 Plan 모드 활용이에요. Shift+Tab을 눌러 구현 전에 Plan 모드로 들어가면 잘못된 경로로 인한 낭비를 줄일 수 있어요. 계획을 먼저 세우는 데 약간의 토큰을 쓰더라도 수정 없이 한 번에 끝내는 것이 훨씬 효율적이에요.
실전 해결책 5, 모델을 골라 써야 하는 이유
모든 작업에 Opus를 쓸 필요가 없어요.
API 기준으로 Opus는 Sonnet보다 토큰당 비용이 5배 더 높아요. Opus 4.7로 업그레이드되면서 이전 4.6 버전보다 토큰을 최소 1.35배 더 사용하게 됐고, /effort(노력 레벨)를 Max로 설정하면 토큰이 2.7배까지 차이날 수 있다는 분석도 나와 있어요. 아무 생각 없이 Opus로만 돌리면 같은 작업량도 훨씬 빠르게 한도에 도달해요.
단순한 요약, 번역, 정보 정리 같은 작업은 Haiku나 Sonnet으로도 충분해요. 깊은 추론이나 복잡한 아키텍처 설계에만 Opus를 쓰는 게 맞아요.
서브 에이전트를 활용하는 것도 효과적이에요. "Haiku 모델로 새 서브 에이전트를 만들어 이 뉴스레터들을 한국어로 요약해줘"처럼 저렴한 모델에게 반복 작업을 맡기고, 메인 Claude는 정말 중요한 작업에만 쓰는 방식이에요. Plan 모드에서는 Opus의 깊은 추론을 쓰고, 실제 코드 작성 단계에서는 Sonnet으로 자동 전환하는 전략도 추천돼요. "생각은 비싸게, 실행은 싸게" 원칙이에요.
오늘 당장 실천할 수 있는 5가지 체크리스트
지금까지 이야기한 내용을 정리하면 이렇게 돼요.
/usage로 현재 사용량을 확인하고, 60~70%가 넘으면 요약 후 리셋을 준비하세요.
CLAUDE.md 파일이 200줄을 넘는다면 오늘 바로 줄이세요. 핵심만 남기고 나머지는 별도 파일로 분리해요.
질문은 쪼개지 말고 한 번에 묶어서 보내고, 수정이 필요할 때는 후속 메시지 대신 Edit 기능을 쓰세요.
PDF, DOCX 파일은 마크다운으로 변환 후 사용하고, 큰 작업은 Plan 모드로 계획부터 잡으세요.
단순 작업은 Haiku나 Sonnet 서브 에이전트에게 위임하고, Opus는 복잡한 추론에만 아껴 쓰세요.
이 다섯 가지 습관만 들여도 하루에 한 번도 한도 초과 없이 두 배의 작업을 처리할 수 있어요. 토큰은 줄이되 성능은 유지하는 것, 그게 Claude Code를 진짜 잘 쓰는 기술이에요.
'IT > AI' 카테고리의 다른 글
| AI 에이전트 시대, 데이터를 쥔 회사보다 허가를 쥔 회사가 이기는 이유 (1) | 2026.07.06 |
|---|---|
| 클로드 코드 feature-dev 플러그인, 바이브 코딩이 '진짜 개발'로 바뀌는 이유 (1) | 2026.07.06 |
| 구글 제미나이 3.5 라이브 번역, 기존 번역 앱과 근본적으로 달라진 3가지 이유 (0) | 2026.07.05 |
| 클로드 페이블 5(Claude Fable 5) 출시와 전격 중단, 역대 최강 AI가 3일 만에 막힌 이유 (1) | 2026.07.05 |
| 바이브코딩으로 월 3400만원 쓰는 창업자, AI 코딩 에이전트에 절대 설계를 맡기지 않는 이유 (1) | 2026.07.05 |