Claude Code 캐시 미스 비용 12.5배 주의
Cache miss in Claude Code costs 12.5× more than a hit. Here are 5 things you do mid session that quietly trigger it
·2026.05.24 11:43
Claude Code 사용 시 특정 동작이 프롬프트 캐시를 무효화하여 비용을 12.5배 급증시킬 수 있습니다.
Anthropic의 프롬프트 캐싱(Prompt Caching) 가격 정책을 분석한 결과, 캐시 미스(Cache miss)는 캐시 히트(Cache hit)보다 12.5배 더 비싼 비용이 발생합니다. 이는 캐시 쓰기 토큰이 기본 입력의 1.25배인 반면, 캐시 읽기 토큰은 0.1배이기 때문입니다.
캐시는 도구(tools) $\to$ 시스템(system) $\to$ 메시지(messages) 순서로 구축되며, 상위 레벨의 변경은 그 하위의 모든 캐시를 무효화합니다. Claude Code 세션 중 캐시를 무효화하여 비용을 높이는 주요 요인은 다음과 같습니다.
- MCP 서버 설치 또는 제거: 세션 도중 MCP 서버를 추가하거나 제거하면 도구 정의(tools)가 변경되어 전체 캐시가 무효화됩니다. MCP는 세션 시작 시 미리 설치하는 것이 경제적입니다.
- 모델 전환 (
/model): 캐시는 모델별로 별도 관리되므로, 세션 중간에 모델을 변경하면 기존 캐시를 사용할 수 없습니다.
이 요약은 원문 이해를 돕기 위한 큐레이션입니다. 저작권은 원저작자에게 있으며, 정확한 내용과 맥락은 원문을 확인하세요.
요약 오류, 출처 표기 문제, 삭제 요청은 문의 · 건의로 알려주세요.