블로그

Claude Code에서 토큰은 어디로 갈까: 9가지 손실 패턴과 2026년 해결 방법

Markdown

토큰의 73%가 Claude가 프롬프트를 보기 전에 낭비됩니다. CLAUDE.md, MCP, 기록—Claude Code에서 컨텍스트가 새는 곳과 9가지 누수 해결법.

전체 글 읽기

핵심 내용

요청을 읽기 전에 많은 토큰이 사용됩니다. 비대해진 CLAUDE.md, 이전 대화 기록을 다시 읽는 작업, MCP 서버 등이 원인입니다. 이 글은 불필요한 사용의 아홉 원인과 15분 정리 목록을 설명합니다. 절감은 세션에 달려 있으며 점유 컨텍스트, 처리 토큰, 캐시, 비용을 따로 측정해야 합니다.

한 예시에서 새 Claude Code 세션의 /context는 첫 메시지를 보내기도 전에 200K 중 60K 토큰이 사용 중이라고 표시했습니다. 프로젝트 저장소에서 실행한 것은 claude뿐이었습니다. 6만 토큰, 즉 대화를 “준비”하는 데 예산의 3분의 1을 쓴 셈입니다.

2주 후, 토큰이 정확히 어디로 갔는지 알아냈습니다. 아래에는 입력을 시작하기도 전에 토큰을 소모하는 9가지 패턴과 해결 방법을 모두 소개합니다. 수치는 Anthropic 공식 문서와 실제 세션 측정값에서 가져왔습니다.

Ailoot 문서 — 서비스를 사용하는 데 필요한 참고 자료입니다.

“프롬프트를 보내기도 전에 토큰의 73%가 낭비된다”는 말은 무슨 뜻일까?

핵심 내용

Claude가 실제 요청을 읽기 전에 많은 토큰이 사용됩니다. 비대해진 CLAUDE.md, 이전 채팅 기록을 다시 읽는 작업, MCP 서버부터 백그라운드 요약까지 나머지 여러 패턴이 원인입니다. 이는 구독 한도 문제가 아니라 컨텍스트가 작동하는 방식에 관한 문제입니다.

여기서는 9가지 패턴을 한 표에 정리하고, 실제 세션 측정값과 Anthropic의 공식 비용 관리 페이지에 나온 수치를 함께 제시합니다.

패턴손실 비중출처
1. 비대해진 CLAUDE.md——
2. 이전 기록 다시 읽기——
3. MCP 서버과거 최대 49%, Tool Search 적용 후 현재 8-15%실제 세션 측정값
4. 누적된 tool_use 출력5-15%실제 세션 측정값
5. 시스템 프롬프트 + 시스템 도구9.6% (1.6% + 8%)GitHub 이슈
6. 중복된 스킬과 플러그인2-5%사용되지 않는 스킬 설명도 컨텍스트에 포함될 수 있음
7. Plan Mode의 에이전트 팀최대 700%Anthropic 문서
8. extended thinking 예산5-20%Anthropic 문서
9. --resume 백그라운드 요약세션당 약 $0.04가 비활성 상태에서 사용됨Anthropic 문서

“73”이라는 수치가 확정적이라고 주장하지는 않겠습니다. 설정에 따라 60%일 수도, 80%일 수도 있습니다. 하지만 전반적인 양상은 맞고 각 패턴은 개별적으로 해결할 수 있습니다. 아래에서 한 번에 세 가지씩 살펴보겠습니다.

요청을 읽기 전에 Claude는 컨텍스트를 어떻게 구성할까?

핵심 내용

첫 글자를 입력하기도 전에 Claude는 시스템 프롬프트, 기본 제공 도구 설명, CLAUDE.md 파일, 연결된 MCP 서버의 도구 이름과 지침(도구 검색이 비활성화된 경우 전체 설명 포함), 메모리(memory_files)의 다섯 계층을 이미 불러옵니다. 200K 창에서는 이 내용이 60-100K를 쉽게 차지해 예산의 3분의 1에서 절반에 이를 수 있습니다. 나머지는 대화 자체와 Read/Edit 같은 도구에 쓰입니다.

GitHub 이슈 #13717 논의에서 누군가 MCP 서버 6개가 연결된 세션에서 /context를 열어 다음과 같은 내역을 얻었습니다.

컨텍스트 계층토큰200K 중 비율
시스템 프롬프트3 2001.6%
시스템 도구 (Read/Edit/Bash 등)16 1008.0%
MCP 도구 (서버 6개: google-docs + asana + calendar + slack + atlassian + gmail)98 70049.3%
메모리 파일 (memory_files, Memory tool 내보내기)3 0001.5%
여유 공간34 00017.0%
자동 압축 버퍼45 00022.5%

주목할 점은 아무것도 입력하지 않았는데도 창의 거의 절반이 차 있다는 것입니다. 여유 공간과 자동 압축 버퍼를 합쳐도 절반이 채 안 남으며, 그 공간에 메시지, Claude의 답변, 읽은 파일, 명령 출력 등 대화 전체를 담아야 합니다.

창 크기는 모델에 따라 다릅니다. Anthropic의 모델 문서에 따르면 2026년 9월 기준 Opus 4.7 이상, Sonnet 5, Fable 모델은 Pro를 포함한 모든 요금제에서 1M 토큰 창을 제공합니다. 확장 컨텍스트가 없는 Opus 4.6 및 Sonnet 4.6과 CLAUDE_CODE_DISABLE_1M_CONTEXT=1 변수를 사용해 1M을 비활성화한 세션에는 200K가 적용됩니다. 창이 커져도 비대한 컨텍스트 문제는 해결되지 않습니다. 첫 메시지를 보내기 전에 불러온 모든 내용이 매 요청마다 모델에 전달되며, 비용 문서는 컨텍스트가 많을수록 토큰도 더 많이 소비된다고 명시합니다. 구독 여부도 이를 바꾸지 않습니다. 어떤 요금제에서든 토큰이 하나 추가될 때마다 한도에 반영됩니다.

컨텍스트의 첫 3분의 1은 CLAUDE.md, 기록, MCP 중 어디로 갈까?

핵심 내용

주요 패턴 세 가지는 대화를 시작하기도 전에 컨텍스트의 36-76%를 차지합니다. CLAUDE.md는 반복 요청의 컨텍스트에 들어갑니다. 기록이 늘면 후속 요청이 더 많은 입력을 처리할 수 있으며 비용은 캐시 읽기·쓰기에도 달려 있습니다. 보편적인 지수 증가율은 없습니다. MCP 서버는 과거에 창의 최대 49%를 소비했지만, 2025년 12월~2026년 1월에 도입된 새 Tool Search 기능이 그 대부분을 줄였습니다. 그래도 많은 설정은 여전히 이전 방식을 사용합니다.

패턴 1. 모든 메시지 전에 불러오는 CLAUDE.md

이 파일은 세션당 한 번이 아니라 보내는 메시지마다 불러옵니다. 5,000토큰 CLAUDE.md는 포함된 요청에서 그만큼 공간을 쓰지만 새 입력·캐시 쓰기·읽기는 따로 계산해야 합니다. 반복 내용이 항상 일반 입력 요금으로 청구되지는 않습니다.

Anthropic 문서에는 이렇게 직접 나와 있습니다.

CLAUDE.md는 200줄 미만으로 유지하고 가장 중요한 정보만 포함하는 것을 목표로 하세요. 전문적인 지침은 필요할 때 불러오는 스킬로 옮기세요.

— Anthropic 문서, code.claude.com/docs/en/costs

프로젝트 CLAUDE.md는 180줄입니다. 워크숍 지침 작성법, TG 게시물 형식, 법률 체크리스트 등 전문적인 내용은 Skills와 business/ 폴더의 Markdown 파일로 옮겼고, Claude는 그 위치를 직접 확인할 때만 읽습니다. 두 달 전과 비교하면 기본 사용량이 60-70% 줄었습니다.

패턴 2. 모든 응답마다 대화 기록을 다시 읽음

외부에서 가장 알아채기 어려운 패턴입니다. 눈에 보이지 않기 때문입니다. 모델은 후속 요청에서 보존된 대화 컨텍스트를 받습니다. 프롬프트 캐시는 안정된 접두사를 재사용할 수 있고 압축·초기화는 보존 내용을 바꿉니다. 캐시 요금으로 비용이 낮아져도 반복 컨텍스트는 창을 차지합니다.

해결책은 서로 관련 없는 작업 사이에 /clear를 사용하는 것입니다. 제 규칙은 작업마다 새 채팅을 여는 것입니다. 작업이 길고 기록이 필요하다면 /compact로 이전 내용을 짧은 요약으로 압축한 뒤 계속 진행하세요.

이 규칙에 관한 자세한 내용과 제 세션 사례는 “하루 만에 Claude Code 한도를 소진하지 않는 법: 토큰 절약을 위한 8가지 규칙”에서 확인할 수 있습니다.

패턴 3. MCP 서버가 모든 도구를 컨텍스트에 등록함

Claude Code에서 오랫동안 문제가 됐고, 2026년까지 가장 큰 손실을 일으킨 부분입니다. 앞서 언급한 이슈 #13717에서는 연결된 MCP 서버 6개(Google Docs, Asana, Calendar, Slack, Atlassian, Gmail)가 대화 시작 전부터 98 700토큰, 즉 전체 창의 49%를 차지했습니다.

Anthropic은 2025년 12월~2026년 1월에 Tool Search 기능을 출시해 이 문제의 절반을 해결했습니다.

Anthropic 문서의 설명은 이제 다음과 같습니다.

MCP 도구 정의는 기본적으로 지연됩니다. Claude가 특정 도구를 호출하기 전까지는 이름만 컨텍스트에 들어갑니다. `/context`를 실행해 공간을 차지하는 항목을 확인하세요. 가능하면 CLI를 우선 사용하세요. `gh`, `aws`, `gcloud`, `sentry-cli` 같은 도구는 도구별 설명을 추가하지 않으므로 여전히 MCP 서버보다 효율적입니다.

— Anthropic 문서, code.claude.com/docs/en/costs

실제 사용에서는 다음과 같이 하세요.

  1. Tool Search가 포함된 버전으로 Claude Code를 업데이트하세요 (2025년 12월 이후의 모든 최신 버전).
  2. /mcp를 열어 현재 세션에 필요 없는 서버를 비활성화하세요. 설명한 사례에서는 Playwright와 shadcn 두 개만 항상 연결해 둡니다. 나머지는 한 가지 작업에만 켜고 작업 후 바로 /mcp disconnect를 실행합니다.
  3. 가능한 경우 MCP를 CLI로 대체하세요. GitHub에는 MCP 서버 대신 gh를 사용하세요. Google Calendar MCP 대신 브라우저에서 캘린더를 사용하세요.

MCP 서버가 무엇인지, 합리적으로 설정하는 방법은 “2026년 Claude Code MCP 서버: 바로 쓸 수 있는 설정 7가지와 단계별 설치법”에서 설명했습니다.

CLAUDE.md와 Skills 문제는 크기뿐 아니라 구조에도 있습니다. 지침 파일 하나인 CLAUDE.md가 핵심입니다. 추가 프로젝트 지식(대상 독자, 제품, 법률 문서, 일별 지침)은 business/ 폴더에 둡니다. 제 방법론에서 이것이 Second Brain입니다. Claude는 지금 필요한 것만 읽고, 이 단계에서 이미 컨텍스트 압축이 이뤄집니다. 전체 내용은 “Claude Code의 Second Brain”에서 확인할 수 있습니다.

또 자주 놓치는 점이 있습니다. CLAUDE.md 정리, Skills로 전환, MCP 비활성화는 첫 단계입니다. 그다음에는 각 프롬프트에 무엇을 어떤 순서로 넣을지, Plan Mode로 무엇을 넘길지, /compact로 무엇을 처리할지를 다루는 컨텍스트 엔지니어링 방법론을 적용합니다. 이 가이드는 그 구성 요소 하나를 설명합니다.

세션에 무엇이 쌓이고, 무엇은 줄일 수 없을까?

핵심 내용

네 번째 패턴은 도구 출력입니다. 읽은 모든 파일, 모든 bash 출력, 모든 MCP 서버 응답이 세션 컨텍스트에 계속 남습니다. 로그 10,000줄을 읽었다면 /clear를 할 때까지 그 내용이 남습니다. 다섯 번째 패턴은 시스템 기본 사용량입니다. 시스템 프롬프트와 기본 제공 도구 설명에 19K 토큰이 듭니다. 이를 줄일 수는 없지만, 알아두면 계산에 도움이 됩니다.

패턴 4. 세션 내내 쌓이는 도구 출력

많은 사람이 언급하지 않는 세부 사항입니다. Claude가 bash cat huge-file.log를 실행하면 명령의 전체 출력이 컨텍스트에 들어가고 세션이 끝나거나 /clear를 할 때까지 남습니다. 큰 파일을 Read로 읽는 경우도 마찬가지입니다. 10,000줄 전체가 남아 이후 모든 메시지에서 토큰을 차지합니다(패턴 2 참조).

해결책:

  1. 전부 읽는 대신 head, tail, grep을 사용하세요. Read deploy.log 대신 bash tail -100 deploy.log를 사용하세요. 출력이 즉시 10~100배 줄어듭니다.
  2. 전처리용 훅을 사용하세요. Claude가 보기 전에 bash 출력을 필터링하는 스크립트를 ~/.claude/hooks에 두세요. Anthropic 문서의 예로는 전체 테스트 출력을 출력하는 대신 npm test 2>&1 | grep -A 5 -E 'FAIL|ERROR'를 실행하는 PreToolUse 훅이 있습니다. 출력이 50~100배 압축됩니다. 자세한 내용은 “2026년 Claude Code 훅: 단계별 설정과 바로 쓸 수 있는 예제 7가지”를 참조하세요.
  3. 대용량 파일을 읽은 뒤 /clear를 사용하세요. 특정 작업을 위해 큰 파일을 읽었고 더 이상 필요하지 않다면 “혹시 몰라서” 컨텍스트에 남겨두지 말고 새 채팅을 시작하세요.

패턴 5. 시스템 프롬프트 + 시스템 도구 = 상시 기본 사용량

이 패턴은 바꿀 수 없습니다. 할 수 있는 일이 거의 없기 때문입니다. Claude Code는 시스템 프롬프트(~3 200토큰)와 기본 제공 도구(Read, Edit, Write, Bash, Glob, Grep, WebSearch, WebFetch, TodoWrite)의 설명(~16 100토큰)으로 시작합니다. 합치면 줄일 수 없는 상시 기본 사용량이 19 300토큰입니다.

실제로는 이렇게 하면 됩니다.

  • 인지하기. 19K의 기본 “세금”을 염두에 두세요. 200K 창이라면 다른 모든 항목에 쓸 수 있는 양은 200K - 19K = 181K입니다(CLAUDE.md, MCP, 자동 압축 버퍼 제외). 1M 창에는 공간이 더 많지만 이 “세금”은 매 요청마다 발생합니다.
  • 반복 처리를 측정하기. 기본 내용은 창을 차지하고 후속 요청에도 반복될 수 있습니다. 세션당 한 번 과금이 아니므로 입력·캐시 쓰기·캐시 읽기·출력 합계를 분리하세요.

Skills, 플러그인, 에이전트 팀에서는 토큰이 어디서 낭비될까?

핵심 내용

여섯 번째 패턴은 스킬과 플러그인의 중복 등록입니다. Vercel의 연구에 따르면 세션 중 스킬의 56%는 한 번도 호출되지 않지만 컨텍스트에 계속 로드됩니다. 일곱 번째 패턴은 에이전트 팀입니다. Plan Mode에서 Claude 인스턴스를 여러 개 실행하면 전체 토큰 소비량이 단일 세션보다 약 7배 증가합니다. Anthropic은 이 점을 문서에 명시했습니다.

패턴 6. Skills와 플러그인이 두 번 등록될 수 있음

이 문제는 2025년 말 Claude Code에 플러그인이 도입되면서 나타났습니다. 스킬을 추가하는 플러그인을 설치하면 해당 스킬이 컨텍스트에 들어갑니다. ~/.claude/skills/에 비슷한 사용자 스킬도 설치되어 있다면 그것도 로드됩니다. 때로는 중복되기도 합니다.

Vercel은 AI 스택 연구에서 수치를 공유했습니다. 세션 중 스킬의 56%가 한 번도 호출되지 않지만 설명은 컨텍스트에 계속 로드됩니다. 스킬 설명 하나당 100토큰이라면 스킬 100개에서 최대 5 600토큰이 “짐”으로 추가됩니다.

해결 방법:

  1. /context에서 실제 사용량을 확인하세요. Skills 항목이 3K를 넘으면 정리하세요.
  2. ls ~/.claude/skills/를 실행해 실제로 설치된 스킬을 확인하세요. 한 달 넘게 사용하지 않은 스킬은 제거하세요.
  3. /plugin remove로 시험 삼아 설치한 뒤 잊고 있던 플러그인을 제거하세요.

Skills의 올바른 구조와 CLAUDE.md와의 차이는 “2026년 Claude Code Skills: 개인 스킬 라이브러리 구축법”에서 설명합니다.

패턴 7. Plan Mode의 에이전트 팀은 7배 더 많은 토큰을 사용함

에이전트 팀은 Claude Code가 병렬 모델 인스턴스 여러 개를 실행하는 기능입니다. 각 인스턴스는 자체 컨텍스트를 가집니다. Anthropic 문서에는 이렇게 직접 나와 있습니다.

팀원이 Plan Mode에서 작업하면 에이전트 팀은 일반 세션보다 약 7배 더 많은 토큰을 사용합니다. 각자 자체 컨텍스트 창을 가지고 별도의 Claude 인스턴스로 실행되기 때문입니다. 팀원별 소비량을 제한하려면 팀 작업을 작고 독립적으로 유지하세요.

— Anthropic 문서, code.claude.com/docs/en/costs

즉, Plan Mode의 팀원 5명은 병렬 세션 5개와 같습니다. 각 세션이 자체 시스템 기본 사용량, CLAUDE.md 사본, MCP 도구를 불러옵니다. 전체 토큰 소비량은 비선형적으로 증가합니다.

해결 방법:

  1. 팀원에게 Sonnet 또는 Haiku를 사용하세요. 팀을 조정하는 리드에만 Opus를 사용하세요. 단가는 낮아질 수 있지만 고정 절감을 가정하지 말고 각 구성원의 전체 작업 비용과 품질을 측정하세요.
  2. 팀 규모를 작게 유지하세요. 10명 대신 2~3명을 사용하세요.
  3. 비활성 팀원을 정리하세요. 작업이 끝났는데도 팀원이 계속 실행 중이면 백그라운드에서 토큰을 계속 소모합니다.

Plan Mode에 관한 자세한 내용과 실제로 유용한 상황은 “Claude Code의 Plan Mode: 단계별 가이드와 2026년 4단계”에서 확인하세요.

보지 않는 동안 Claude는 무엇에 토큰을 청구할까?

핵심 내용

여덟 번째 패턴은 extended thinking입니다. Claude는 답변하기 전에 “소리 내어” 생각하며 이 사고 토큰은 출력 토큰으로 계산됩니다. 복잡한 작업의 기본 예산은 수만 토큰입니다. 아홉 번째 패턴은 백그라운드 요약입니다. 입력하지 않는 동안에도 Claude Code는 --resume을 위해 이전 세션을 처리하고 요약을 저장합니다. 비활성 상태에서 세션당 약 $0.04가 사용됩니다.

패턴 8. 개입하지 않아도 토큰을 쓰는 extended thinking

Extended thinking은 Claude가 답변 전에 숨겨진 사고 블록에서 해결책을 “생각하는” 모드입니다. 계산상 이 토큰들은 일반 응답처럼 계산되는 출력 토큰이지만 채팅에서는 보이지 않습니다.

Anthropic 문서에 따르면:

어려운 계획 및 추론 작업의 결과를 크게 개선하므로 extended thinking은 기본적으로 활성화되어 있습니다. 사고 토큰은 출력으로 청구되며 모델에 따라 기본 예산이 요청당 수만 토큰에 이를 수 있습니다.

— Anthropic 문서, code.claude.com/docs/en/costs

즉, 복잡한 요청 하나에서 사고 토큰 10-30K가 예산을 “잠식”할 수 있지만 채팅에는 짧은 요약만 표시됩니다.

해결 방법:

  1. 간단한 작업에는 /effort low를 사용하세요. 사고 예산을 최저 수준으로 줄입니다.
  2. 환경 변수 MAX_THINKING_TOKENS=8000을 설정해 상한을 지정하세요.
  3. Claude가 “생각할” 필요가 없는 매우 일상적인 작업에서는 /config → thinking 비활성화를 선택하세요.

복잡한 아키텍처나 다단계 추론처럼 thinking이 유용한 경우와 그렇지 않은 경우는 “Claude Code의 Sonnet 또는 Opus 4.7: 2026년 모델과 /effort 선택법”에서 설명합니다.

패턴 9. 유휴 상태에서도 백그라운드 요약이 실행됨

규모는 아주 작지만 흥미로운 패턴입니다. Claude Code는 claude --resume 명령을 위해 이전 세션을 요약하는 백그라운드 프로세스를 실행합니다. 입력하지 않을 때도 이 프로세스가 돌아갑니다.

Anthropic은 관련 문서에서 이를 명시적으로 설명합니다.

Claude Code는 대화 요약(이전 세션을 압축해 claude --resume에 사용하는 백그라운드 작업)과 명령 처리 등 유휴 상태에서도 백그라운드 기능에 토큰을 사용합니다. 이러한 백그라운드 프로세스는 활발한 상호작용이 없어도 토큰을 소량 사용하며, 일반적으로 세션당 $0.04 미만입니다.

— Anthropic 문서, code.claude.com/docs/en/costs

세션당 4센트는 큰 문제가 아닙니다. 하지만 하루에 세션 10개를 열어 둔다면 하루에 이미 $0.40, 한 달에 $12를 유휴 상태에서 소비합니다. 당장 필요하지 않은 세션은 닫으세요. 인덱스에서 /resume으로 세션을 복원할 수 있으므로 계속 열어 둘 필요는 없습니다.

손실 측정법: /context 명령과 유의 사항

핵심 내용

Claude Code의 /context 명령은 현재 토큰이 어디에 쓰이는지 보여 줍니다. 그러나 알려진 버그가 있습니다. 과거에는 도구별 오버헤드를 각 도구마다 따로 계산해 MCP 도구 사용량을 3배로 과대 표시했습니다. Anthropic은 최신 버전에서 이를 수정했습니다. /context 보고서에서 MCP가 30K를 넘으면 먼저 Claude Code를 업데이트한 다음 다시 측정하세요.

먼저 명령부터 살펴보겠습니다. Claude Code에서 /context를 열거나 계산을 위해 /usage를 실행하면 다음과 같은 결과가 표시됩니다.

Context window: 200 000 tokens

System prompt:        3 200 (1.6%)
System tools:        16 100 (8.0%)
MCP tools:           12 600 (6.3%)
CLAUDE.md:            4 800 (2.4%)
Memory files:         3 000 (1.5%)
Conversation:        18 400 (9.2%)
Free space:         141 900 (71.0%)

이는 첫 정리 후의 일반적인 상시 기본 사용량입니다. 좋습니다. 창의 71%가 비어 있습니다.

알려진 /context 버그: MCP 사용량을 3배 과대 표시

/context는 도구별 오버헤드를 각 도구에 대해 따로 계산해 실제 MCP 사용량보다 약 3배 높게 표시했습니다.

Cameron에 따르면 Anthropic은 현재 버전에서 이 문제를 수정했으며, 이제 같은 XcodeBuildMCP에 대해 12 600을 표시합니다. 따라서 다음과 같이 하세요.

  1. /context에서 MCP 도구가 50K 이상으로 표시된다면 오래된 Claude Code 버전을 쓰고 있을 수 있습니다. 업데이트하세요.
  2. MCP가 8-15K라면 정상입니다. Tool Search를 사용할 때 실제 비용에 해당합니다.
  3. 새 버전에서 MCP가 30-50K라면 실제로 사용하지 않는 서버가 많이 연결된 것입니다. /mcp에서 연결을 해제하세요.

/context 외에 확인할 항목

/usage는 지난 24시간 또는 7일 동안의 요금제 사용량을 표시합니다. Pro와 Max에서는 스킬, 서브에이전트, 플러그인, 개별 MCP 서버별 내역을 볼 수 있습니다. 어떤 스킬이 가장 많이 소모하는지 파악하는 데 유용합니다.

/cost는 API 사용자용입니다. 현재 세션의 비례 배분 비용을 달러로 표시합니다. Pro/Max 구독자용은 아닙니다. 이들에게는 필요하지 않습니다.

/usage-credits는 Pro/Max에서 월간 지출 한도를 설정할 수 있게 합니다. 스크립트로 실행한 에이전트 팀이 실수로 신용카드 한도를 모두 쓰는 일을 막고 싶을 때 유용합니다.

15분 만에 Claude Code 컨텍스트 정리하기

핵심 내용

여덟 단계로 피할 수 있는 컨텍스트를 줄이세요. 여유 70%나 사용량 40–50% 감소는 보장되지 않으며 한 시점의 컨텍스트로 세션 총사용량을 측정할 수 없습니다. 대부분 1-2분이면 됩니다. 가장 큰 효과를 내는 CLAUDE.md 정리와 사용하지 않는 MCP 연결 해제에는 각각 5분이 걸립니다. 순서대로 진행하고 빠뜨리지 마세요.

Claude Code에서 프로젝트를 열고 다음 단계를 진행하세요.

  1. /context — 현재 내역을 적어 둡니다. 기준선이 됩니다.
  2. /clear — 채팅에 현재 작업과 관련 없는 기록이 쌓였다면 실행합니다. 새 창을 시작합니다.
  3. ls -la ~/.claude/skills/ — 설치된 스킬을 확인합니다. 한 달 동안 사용하지 않은 스킬은 제거하세요. 명령: rm -rf ~/.claude/skills/[skill-name] (또는 인터페이스에서 폴더를 삭제하세요).
  4. /plugin list — 플러그인도 같은 방법으로 확인합니다. 사용하지 않는 것은 /plugin remove <name>으로 제거하세요.
  5. /mcp — 연결된 MCP 서버를 확인합니다. 현재 작업에 필요한 서버만 남기고 나머지는 /mcp disconnect <name>으로 연결 해제하세요.
  6. 편집기에서 CLAUDE.md를 여세요. 파일이 200줄을 넘으면 전문 지침을 Skills (~/.claude/skills/[topic]/SKILL.md)로 옮기세요. 핵심 파일은 100-200줄, 주제별 Skills는 5-15개를 목표로 하세요. 자세한 안내는 “2026년 CLAUDE.md 구성법: 바로 쓰는 템플릿과 6가지 규칙”에서 확인할 수 있습니다.
  7. /effort를 확인하세요 — 간단한 작업에는 /effort low를 사용하세요. 높은 사고 예산은 복잡한 아키텍처에만 필요합니다.
  8. 마지막으로 /context를 측정하세요. 1단계의 결과와 비교합니다.

설명한 세션에서는 정리 후 점유 컨텍스트가 60–80K에서 25–30K로 줄었습니다. 이는 순간 점유량 변화이지 총 처리 토큰이나 비용의 고정 절감 증거가 아닙니다. 절감을 주장하려면 같은 작업의 전체 실행을 캐시와 출력을 포함해 비교하세요.

컨텍스트를 정리하는 것보다 Sonnet이나 Haiku로 전환하는 편이 나은 때는?

핵심 내용

컨텍스트 정리가 항상 가장 비용 효율적인 조치는 아닙니다. 텍스트 수정, 템플릿 생성, 서식 지정처럼 대부분 일상적인 작업을 한다면 토큰 단가가 낮은 모델로 비용을 줄일 수 있지만 전환만으로 고정 토큰 감소가 입증되지는 않습니다. 토크나이저, 추론, 출력 길이, 재시도가 실제 수를 바꿉니다. 복잡한 아키텍처, 다단계 추론, 까다로운 버그 디버깅에는 여전히 Opus가 필요합니다. 작업에 따라 선택하세요.

Anthropic의 모델 문서에는 다음과 같이 나와 있습니다.

Sonnet은 대부분의 코딩 작업을 잘 처리하며 Opus보다 저렴합니다. Opus는 복잡한 아키텍처 결정과 다단계 추론을 위해 아껴 두세요. 세션 중 모델을 바꾸려면 /model을 사용하거나 /config에서 기본값을 설정하세요. 간단한 서브에이전트 작업에는 설정에서 model: haiku를 지정하세요.

— Anthropic 문서, code.claude.com/docs/en/costs

입력 토큰 가격의 대략적인 비교(2026년 5월 27일 기준):

모델입력 1M당 가격용도
Opus 4.7$15아키텍처, 복잡한 다단계 추론, 어려운 디버깅
Sonnet 4.5$3일반적인 코딩 작업의 80%: 수정, 리팩터링, 테스트, 문서 작성
Haiku 4.5$1서식 지정, 간단한 파싱, 서브에이전트 작업, 일상적인 텍스트 수정

제 설정은 다음과 같습니다.

  1. 기본값은 Sonnet 4.5. /config → default model에서 설정합니다. 작업의 80%를 처리합니다.
  2. 정말 어려운 작업(아키텍처 선택, 난해한 버그 진단, 새 제품 개발)에서는 직접 /model opus를 실행합니다.
  3. 테스트와 서식 지정에는 /model haiku를 사용합니다. 또는 서브에이전트 설정에서 model: haiku를 지정합니다.
  4. /effort는 모델과 별개입니다. /effort low와 함께 Opus를 사용할 수 있습니다. 강력한 모델을 최소한의 사고 설정으로 사용해 중간 난도 작업에 빠르게 답할 수 있습니다.

모델을 바꾸는 것보다 컨텍스트 정리가 더 나은 경우:

  • 컨텍스트가 50% 넘게 차 있다면 먼저 정리하세요.
  • 컨텍스트는 괜찮지만 작업이 복잡하다면 일반 effort로 Opus를 사용하세요.
  • 컨텍스트는 괜찮고 작업이 일상적이라면 Haiku를 사용하세요.

모델과 effort의 자세한 비교는 “Claude Code의 Sonnet 또는 Opus 4.7: 2026년 모델과 /effort 선택법”을 참조하세요.

어떤 팁은 사용량을 절약하기는커녕 늘릴까?

핵심 내용

블로그에는 단기적으로는 효과가 있어도 시간이 지나면 작업 흐름을 망치는 조언이 자주 등장합니다. 대표적인 세 가지는 “MCP를 모두 삭제하라”, “CLAUDE.md를 잊고 모든 내용을 프롬프트에 넣어라”, “항상 Plan Mode로 작업하라”입니다. 모두 한 가지 문제를 해결하는 대신 새로운 문제 세 가지를 만듭니다. 하나씩 살펴보겠습니다.

안티패턴 1. “MCP를 전부 삭제하라. 토큰을 잡아먹는다”

가장 흔한 실수는 귀찮아서 전부 삭제하는 것입니다. 맞습니다. 과거에는 MCP가 컨텍스트를 최대 49%까지 차지했지만 Tool Search 이후 8-15%로 줄었습니다. 그리고 MCP는 직접 만들어야 할 실제 도구를 제공합니다. MCP를 전부 삭제하면 수동 작업으로 돌아가게 되고, 절약한 토큰보다 더 많은 시간이 “소모”됩니다.

올바른 방법은 정기적으로 실제 사용하는 MCP 서버만 남기는 것입니다. 저는 랜딩 페이지 테스트용 Playwright와 인터페이스 생성용 shadcn을 유지합니다. 나머지는 작업 하나에만 사용합니다.

안티패턴 2. “CLAUDE.md를 쓰지 말고 모든 내용을 프롬프트에 직접 넣어라”

“논리적”으로 들립니다. CLAUDE.md가 모든 요청에 로드된다면 로드하지 않으면 되지 않을까요? 실제로는 CLAUDE.md가 없으면 매 메시지마다 같은 지침을 직접 입력하게 되고 Claude는 메시지 사이의 컨텍스트를 잊습니다. 즉, 토큰이 줄어드는 게 아니라 더 많이 듭니다. 단지 다른 경로로 들어올 뿐입니다.

올바른 방법은 CLAUDE.md를 100-200줄로 간결하게 유지하면서 핵심만 넣고 전문 내용은 Skills에 두는 것입니다. 자세한 내용은 “2026년 CLAUDE.md 구성법”을 참조하세요.

안티패턴 3. “항상 Plan Mode로 작업하라”

코드베이스를 먼저 살펴보고 계획을 제안해야 하는 복잡한 작업에는 Plan Mode가 훌륭한 도구입니다. 하지만 에이전트 팀을 통해 작업하면 평균 7배 더 많은 토큰을 사용합니다 (Anthropic 문서). README의 오타를 고치는 단순한 작업에서 Plan Mode를 쓰면 직접 수정하는 것보다 토큰을 7배 더 씁니다.

올바른 방법은 30분 이상 걸리는 복잡한 작업에 Plan Mode를 사용하는 것입니다. 짧은 작업은 Plan Mode 없이 바로 요청하세요. 각 모드를 언제 쓸지에 관한 내용은 “Claude Code의 Plan Mode: 단계별 가이드와 2026년 4단계”에서 확인할 수 있습니다.

출처

Ailoot에서 더 많은 자료를 확인할 수 있습니다.

자세히 보기

Claude Code에서 토큰은 어디로 갈까: 9가지 손실 패턴과 2026년 해결 방법: 자주 묻는 질문

토큰 단가가 낮으면 사용 토큰도 반드시 줄어드나요?

아닙니다. 단가는 토큰 가격이고 실제 수는 토크나이저, 추론, 출력, 재시도에 달려 있습니다. 같은 작업의 전체 실행을 비교한 뒤 토큰이나 비용 감소를 주장하세요.

/context는 세션 전체 청구액을 보여주나요?

아닙니다. 현재 컨텍스트 점유량입니다. 처리량·비용은 입력, 캐시 쓰기·읽기, 출력 합계를 따로 확인하세요. 반복 기본 텍스트는 단순한 세션당 한 번 요금이 아닙니다.

모든 글