클로드 코드 토큰·컨텍스트 관리법 2026 — 비용 줄이는 공식 기준

컨텍스트 창은 AI가 한 세션에서 알고 있는 모든 것이 담기는 공간입니다. 공식 문서는 여기에 지시, 읽은 파일, 스스로의 답변, 화면에는 보이지 않는 내용까지 들어간다고 설명합니다. AI는 매 메시지마다 지금까지의 대화를 다시 읽기 때문에, 대화가 길어질수록 한 번 주고받는 비용도 같이 올라갑니다.

한계에 가까워지면 자동 압축이 작동합니다. 공식 문서는 한계에 가까워지면 자동으로 압축하므로 컨텍스트가 가득 찬다고 세션이 끝나지는 않는다고 밝힙니다. 즉 대화가 끊기는 것이 아니라 앞부분이 요약으로 바뀌는 것이며, 요약은 줄거리를 남기고 세부는 버립니다.

두 명령의 성격은 다릅니다. compact 명령은 대화를 구조화된 요약으로 대체합니다. 요약할 때 보존되는 것은 요청과 의도, 핵심 기술 개념, 살펴보거나 수정한 파일, 오류와 그 해결 과정, 남은 작업 같은 것들입니다.

clear 명령은 완전히 새 세션으로 시작합니다. 공식 비용 문서는 관련 없는 작업으로 전환할 때 clear를 실행하라고 권합니다. 예전 대화가 다음에 필요한 파일 자리를 밀어내고, 메시지마다 비용을 먹기 때문입니다. 이어서 할 일이면 압축을, 다른 일로 넘어가면 초기화를 쓰는 편이 안전합니다.

압축 후에도 사라지지 않는 것이 있습니다. 공식 문서에 따르면 프로젝트 루트의 규칙 파일은 디스크에서 다시 읽어 세션에 다시 넣어 줍니다. 그래서 남겨야 할 것은 대화가 아니라 파일이라는 결론이 나옵니다.

프롬프트 캐싱은 반복되는 앞부분을 다시 처리하지 않게 해 주는 기능입니다. 공식 문서는 프롬프트의 특정 접두사부터 재개할 수 있게 해 처리 시간과 비용을 줄인다고 설명합니다. 다만 오해하기 쉬운 지점이 있습니다.

캐시에는 수명이 있습니다. 기본 수명은 5분이고, 추가 비용을 내면 1시간 옵션도 있습니다. 처음 저장할 때는 오히려 비싼데, 캐시 쓰기 비용은 기본 입력가의 1.25배(5분)나 2배(1시간)이며 읽을 때 싸지는 구조입니다. 짧은 프롬프트는 아예 캐시되지 않는데, 모델마다 최소 토큰 수가 정해져 있고 그보다 짧으면 표시를 해도 무시되며 오류도 뜨지 않습니다. 자리를 오래 비웠다가 돌아오면 첫 메시지가 유독 비싼 이유가 여기에 있습니다.

무거운 작업을 하위 작업으로 넘기면 컨텍스트를 아낄 수 있습니다. 공식 문서는 서브에이전트가 그 작업을 자기 컨텍스트에서 처리하고 요약만 돌려준다고 설명합니다. 다만 공짜는 아니며, 에이전트 팀 기능은 일반 세션보다 약 7배 많은 토큰을 쓴다고 명시돼 있습니다.

규칙 파일도 상시 비용입니다. 공식 비용 문서는 규칙 파일이 세션 시작 시 컨텍스트에 로드되므로 꼭 필요한 것만 담아 200줄 미만을 목표로 하라고 안내합니다. MCP 도구 정의는 기본적으로 지연 로딩이지만, 쓰지 않는 서버는 꺼 두라는 안내도 함께 있습니다.

오늘 바로 적용할 수 있는 것들도 정리해 둘 만합니다. 주제가 바뀌면 clear, 하던 일을 이어가면 compact를 쓰고, 필요하면 초점을 지정해 요약을 요청할 수 있습니다. 지금 무엇이 컨텍스트를 차지하는지는 별도 명령으로 바로 확인할 수 있고, 규칙 파일은 200줄 아래로 유지하며, 안 쓰는 MCP 서버는 꺼 두고, 로그·테스트·리서치처럼 출력이 긴 작업은 하위 작업으로 넘기는 것이 공식 문서가 공통으로 권하는 방향입니다.

"토큰을 몇 분의 몇으로 줄인다"는 제목의 글을 여러 번 봤지만, 공식 문서에는 그런 배수가 없습니다. 공식 문서가 밝힌 수치는 캐시 읽기가 기본가의 0.1배(일부 모델은 0.025배), 캐시 쓰기가 1.25배에서 2배, 배치 처리 시 50% 할인이라는 정도입니다. 배수를 약속하는 글은 근거를 확인하기 어려워 그대로 옮기지 않는 편이 안전합니다. 대신 컨텍스트가 어떻게 차오르는지 구조를 이해하면 비용은 자연스럽게 관리됩니다. 요령을 찾기보다 무엇이 컨텍스트를 차지하는지부터 확인하는 것이 먼저입니다.

컨텍스트가 꽉 차면 대화가 끊기나요?

아닙니다. 자동 압축이 작동합니다. 다만 세부 내용이 요약으로 대체되므로, 중요한 것은 파일에 남겨 두어야 합니다.

clear를 하면 비용 집계도 초기화되나요?

공식 문서에 그렇게 적혀 있습니다. clear로 새 세션이 시작되면 다음 세션의 누적 비용은 0에서 시작합니다.

서브에이전트를 쓰면 토큰이 절약되나요?

항상 그렇지는 않습니다. 자기 컨텍스트에서 토큰을 쓰기 때문에, 결과가 방대한 작업에만 쓰는 것이 안전합니다.

비용은 요령이 아니라 구조로 줄어듭니다. 무엇이 컨텍스트를 차지하는지 알면 어디를 비워야 할지도 알 수 있습니다. 정확한 최신 수치는 공식 가격 문서에서 확인하는 것이 가장 안전합니다.

• Anthropic — Managing Claude's context (https://code.claude.com/docs/en/context-window, 확인일 2026-09-18)
• Anthropic — Managing costs (https://code.claude.com/docs/en/costs, 확인일 2026-09-18)
• Anthropic — Prompt caching (https://platform.claude.com/docs/en/build-with-claude/prompt-caching, 확인일 2026-09-18)
• Anthropic — Sub-agents (https://code.claude.com/docs/en/sub-agents, 확인일 2026-09-18)
• Anthropic — Pricing (https://claude.com/pricing, 확인일 2026-09-18)