Claude Code 프롬프트 캐시 만료로 인한 토큰 폭탄 방지 팁 (/clear 활용)

X(트위터)의 테크 크리에이터 루샨(@lucian__03)이 단일 세션에서 장시간 작업을 이어갈 때 발생할 수 있는 Claude Code의 프롬프트 캐시 만료 현상과 이로 인한 사용량 급차감(토큰 폭탄)을 방지하는 실무 팁을 공유했습니다.

이미지 출처: X @lucian__03

세션을 종료하지 않고 오래 방치한 뒤 "이어서 해줘" 같은 짧은 프롬프트를 한 줄만 입력하더라도, 수십만 토큰에 달하는 전체 대화 컨텍스트가 캐시 없이 처음부터 다시 연산되면서 5시간 사용량 한도가 순식간에 소진되는 메커니즘과 이를 회피하기 위한 커맨드 운용 전략을 다룹니다.

KV 캐시 만료 메커니즘과 언캐시드(Uncached) 토큰 폭탄의 원인

Claude Code는 기본적으로 프롬프트 캐싱(Prompt Caching) 기능을 활용해 시스템 지시문, CLAUDE.md, 이전 대화 내역 및 도구 실행 결과를 재사용함으로써 토큰 비용과 사용량 한도 차감을 크게 절감합니다.

그러나 세션을 오랜 시간 동안 열어둔 채 방치하면 백엔드에 보관되어 있던 캐시가 무효화(만료)됩니다.

• 서버 측 KV 캐시 보관 비용: 모델이 연산한 중간 상태(Key-Value 캐시)는 Anthropic의 고성능 GPU/서버 메모리에 보관됩니다. 비활성 세션의 대용량 캐시를 무기한 메모리에 유지하는 것은 막대한 인프라 비용이 들기 때문에 만료 시간(TTL)이 설정되어 있습니다.
• 캐시 만료 기준(TTL):
  • 메인 세션 기준: 약 1시간 동안 캐시 재사용이 발생하지 않으면 저장된 캐시가 삭제됩니다.
  • API 추가 사용 크레딧(Usage Credits) 기준: 약 5분 동안 재사용이 없으면 캐시가 삭제됩니다.
• 언캐시드 토큰 재연산 폭탄: 예를 들어 누적 컨텍스트가 약 85만 토큰(852k)에 달하는 세션을 1시간 이상 방치한 뒤 "이어서 해줘"라고 명령하면, 모델은 85만 토큰 전체를 캐시 히트 없이 처음부터 새로 읽어들입니다. 이로 인해 단 1턴의 질의만으로 5시간 롤링 사용량 한도의 2030%가 일거에 소진되는 현상이 발생합니다.

/compact의 한계와 /clear 기반 안전한 세션 리셋 전략

많은 사용자가 세션이 무거워졌을 때 대화 압축 명령어인 /compact를 사용하지만, 캐시가 이미 만료된 세션에서는 압축 작업 자체가 추가적인 토큰 소모를 유발할 수 있습니다.

• /compact 실행 시의 캐시 의존성: 캐시가 풀린(만료된) 세션에서 /compact를 실행하면, Claude Code는 지금까지의 긴 대화 전체를 요약하기 위해 처음부터 전체 토큰을 다시 읽어야 합니다. 이 과정에서 요약문 생성을 위한 대규모 언캐시드 토큰 연산이 즉시 청구됩니다.
• /clear를 통한 완전한 컨텍스트 초기화: 이전 대화의 세부 맥락을 그대로 유지할 필요가 없는 새로운 작업 단위라면, 방치된 세션을 이어가기보다는 /clear 명령어로 컨텍스트를 비우고 새 대화를 시작해야 불필요한 토큰 낭비를 원천 차단할 수 있습니다.
• 권장 실무 작업 흐름:
  1. 기능 구현이나 리팩토링의 한 단위가 완료되면, 핵심 결정 사항이나 남은 과제를 CLAUDE.md 또는 인수인계 메모에 기록합니다.
  2. 작업을 잠시 중단하거나 자리를 비우기 전 세션을 방치하기보다 정리합니다.
  3. 자리를 비운 뒤 복귀했거나 이전 작업 맥락이 불필요한 경우에는 주저 없이 /clear를 실행해 빈 컨텍스트 윈도우에서 새 세션을 시작합니다.

원문 출처

• 루샨 (@lucian__03) X 포스트: 클로드코드 토큰 아끼는 방법 - 프롬프트 캐시 만료와 /clear 활용 팁