Claude Code 프롬프트 캐시: 무효화 요인과 확인 방법
Things that quietly break your prompt cache in Claude Code (and a few that don’t)
·2026.11.01 11:58
핵심 내용
모델 전환과 MCP 서버 추가는 캐시를 무효화하지만 파일 편집은 아니며 구독 기본 TTL은 1시간이다
자세히 보기
- 모델 전환, 노력 수준 변경, 빠른 모드 토글, 도구 검색 없는 MCP 서버 추가는 시스템 프롬프트나 모델 컨텍스트를 변경하여 프롬프트 캐시를 무효화함
- 파일 편집, 권한 모드 변경(plan mode with opusplan 제외), 스킬, 명령어, 출력 스타일 변경, 서브에이전트 생성은 캐시를 무효화하지 않음
- 구독의 기본 TTL은 1시간이지만 API 키나 클라우드 제공사는 5분이며, 1시간 쓰기 비용은 5분을 초과하는 무효화가 발생해야 회수 가능함
- /usage(v2.1.251+)로 히트율과 미스 원인을 확인하거나, claude -p를 --output-format json과 함께 두 번 실행하여 cache_creation_input_tokens와 cache_read_input_tokens를 비교함
이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.