Claude Code 캐시 미스는 히트보다 12.5배 비싸다: 무심코 캐시를 날리는 5가지 행동

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를 설치하세요. 작업 중간에 새 도구가 필요하면 현재 작업을 끝내고 /clear를 한 뒤 추가하세요.

2. /model로 모델 변경 — 캐시 네임스페이스 전체 변경

캐시는 모델별로 적용됩니다. 세션 중간에 Sonnet에서 Opus로 전환해도 캐시가 마이그레이션되지 않으며, 다음 턴에서 접두사가 새로 처리됩니다. UI에는 경고가 없습니다.

해결책: 세션 시작 시 모델을 선택하세요. 계획에는 Opus, 실행에는 Sonnet을 쓰되, 계속 전환하지 말고 세션을 분리하세요.

3. 세션이 열려 있는 동안 CLAUDE.md 수정 — 시스템 + 메시지 초기화

CLAUDE.md 내용은 시스템 프롬프트 영역의 일부로 전달됩니다. Anthropic의 무효화 규칙에 따라 시스템 수준의 변경은 시스템 캐시와 그 위에 구축된 모든 메시지 캐시를 무효화합니다. CLAUDE.md의 한 줄만 수정하고 저장한 뒤 다음 메시지를 보내면, CLAUDE.md 아래의 접두사가 다시 작성됩니다.