Claude Code의 캐시 미스는 히트보다 12.5배 비쌉니다. 세션 중에 무심코 캐시를 날려버리는 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
핵심 요약
Claude Code 사용 시 캐시 미스로 인한 비용 낭비를 막기 위한 5가지 주의사항을 정리했습니다.
- 캐시 비용 — 캐시 미스는 히트보다 12.5배 비싸므로 세션 시작 시 설정을 고정해야 함.
- MCP 서버 관리 — 세션 중간에 MCP를 추가하거나 제거하면 전체 캐시가 무효화됨.
- 모델 변경 — 세션 도중 모델을 바꾸면 캐시 네임스페이스가 달라져 처음부터 다시 처리됨.
- 설정 파일 수정 — CLAUDE.md 수정이나 속도 모드 변경은 시스템 캐시를 날려버림.
Anthropic의 프롬프트 캐싱 문서에 나오는 두 가지 숫자가 여러분의 토큰 비용 대부분을 설명합니다:
"5분 캐시 쓰기 토큰은 기본 입력 토큰 가격의 1.25배입니다." (출처)
"캐시 읽기 토큰은 기본 입력 토큰 가격의 0.1배입니다." (출처)
계산은 이렇습니다: 캐시 미스는 캐시 히트보다 12.5배 비쌉니다. 50,000 토큰 규모의 Claude Code 세션 접두사(시스템 + 도구 + CLAUDE.md + 초기 대화)에서 턴당 발생하는 차이는 실제 비용으로 직결되며, 대부분의 사용자는 이를 인지하지 못한 채 캐시를 날려버립니다.
Anthropic은 정확한 무효화 표를 공개하고 있습니다. 캐시는 도구 → 시스템 → 메시지 순서로 구축됩니다. 어느 단계에서든 변경이 발생하면 해당 단계와 그 이후의 모든 내용이 무효화됩니다. 따라서 모든 캐시 삭제가 동일하지는 않습니다. 어떤 것은 최근 메시지만 날리지만, 어떤 것은 도구 정의까지 거슬러 올라가 전체 접두사를 날려버립니다.
Claude Code에서 이를 유발하는 5가지 행동을 "전부 삭제"부터 "꼬리 자르기" 순으로 정리했습니다:
1. 세션 중간에 MCP 서버 설치 또는 제거 — 전부 삭제됨
Anthropic: "도구 정의(이름, 설명, 매개변수)를 수정하면 전체 캐시가 무효화됩니다." MCP 서버는 도구 정의를 등록합니다. 활성 세션 중에 claude mcp add를 추가하거나 /mcp를 실행하면 모든 캐시된 요청 상단의 tools 블록이 변경됩니다. 그 이후의 모든 것(시스템, CLAUDE.md, 전체 대화)이 1.25배의 비용으로 다시 작성됩니다.
해결책: 모든 MCP는 세션 시작 시 설치하세요. 작업 중간에 새 MCP가 필요하다면 현재 작업을 마치고 /clear를 한 뒤 추가하세요.
2. /model로 모델 전환 — 캐시 네임스페이스가 완전히 변경됨
캐시는 모델별로 적용됩니다. 세션 중간에 Sonnet에서 Opus로 전환해도 캐시는 이전되지 않습니다. 다음 턴에서 접두사가 새로 처리됩니다. UI에는 경고가 없습니다.
해결책: 세션 시작 시 모델을 선택하세요. 계획에는 Opus, 실행에는 Sonnet을 사용하되, 세션을 번갈아 바꾸지 말고 각각 별도의 세션으로 분리하세요.
3. 세션이 열려 있는 동안 CLAUDE.md 수정 — 시스템 + 메시지 삭제됨
