Claude Code 프롬프트 캐싱 메커니즘과 비용 최적화

Claude Code는 Prefix Caching 방식을 사용하여 이전 대화 내용을 캐싱합니다. 대화의 시작 부분(시스템 프롬프트, 프로젝트 컨텍스트, 대화 기록 등)이 일치할 경우, 해당 부분은 **기존 입력 비용의 약 10%(0.1x)**라는 저렴한 가격으로 처리됩니다.

캐싱 효율을 결정하는 핵심 요소는 다음과 같습니다:

• Prefix 일치 여부: 대화 중간에 이전 컨텍스트를 수정하면 캐시 미스(Cache Miss)가 발생하며, 이 경우 전체 컨텍스트에 대해 다시 비용이 청구됩니다.
• TTL(Time To Live): 캐시 유지 시간은 인증 방식에 따라 5분 또는 1시간으로 설정됩니다. 5분 TTL 설정 시, 대화 흐름이 5분 이상 끊기면 다음 턴에서 전체 컨텍스트 비용이 다시 발생하므로 주의가 필요합니다.
• 캐시 비용 구조:
  • Cache Read: 약 10% (기존 캐시 사용 시)
  • Cache Write (5m TTL): 1.25x
  • Cache Write (1h TTL): 2x

활성 세션은 캐시 히트(Cache Hit)가 발생할 때마다 TTL이 갱신되어 캐시 상태가 유지됩니다.