Claude Code 프롬프트 캐시 만료 시간 측정 실험
아침 내내 Claude Code로 작업하다가 점심을 먹으러 나갔다가 돌아와서 메시지를 하나 더 보낸다. 첫 응답은 느리고 사용량이 갑자기 뛴다. 보통 원인은 프롬프트 캐시다. 캐시가 만료되면 다음 메시지에서 전체 대화를 다시 처리해야 하기 때문이다.
그런데 캐시는 실제로 얼마나 오래 가는 걸까? 어떤 가이드는 5분이라고 하고, 어떤 곳은 1시간이라고 하며, 2026년 4월에는 이에 대한 큰 논란도 있었다. 그냥 기다렸다가 측정한 사람은 찾지 못해서, 직접 해 보았다.
실험
- Claude Code 2.1.295, Opus 5.5, 중간 수준 노력, 구독으로 로그인, 헤드리스(
-p), MCP 서버 없음
- 1차: 작은 벽돌 깨기 게임을 하나의
index.html로 작성
- 0, 4, 6, 15, 30, 55 또는 65분 대기
- 같은 세션에서 2차(
--resume): "Make the ball red and slightly faster."
- 각 대기 시간은 별도 세션으로 진행했고, 모두 서로 1분 이내에 시작했으며, 두 번씩 실행함(2026년 10월 20일)
캐시가 5분간 유지된다면 비용은 4분과 6분 사이에서 급증해야 한다. 1시간간 유지된다면 55분과 65분 사이에서 급증해야 한다.
결과
다음 메시지의 첫 모델 호출, 두 번 실행한 평균값. 비용은 Claude Code의 API 목록가 추정치다.
| 대기 시간 | 캐시에서 읽은 토큰 수 | 캐시에 쓴 토큰 수 | 다음 메시지 비용 |
|---|---|---|---|
| 0분 | 41,436 | 496 | $0.039 |
| 4분 | 43,232 | 466 | $0.042 |
| 6분 | 42,440 | 496 | $0.042 |
| 15분 | 43,076 | 502 | $0.041 |
| 30분 | 42,636 | 494 | $0.043 |
| 55분 | 43,183 | 502 | $0.043 |
| 65분 | 15,925 | 27,460 | $0.253 |
55분까지는 아무 변화가 없었다. 65분에서는 캐시가 사라졌다. 27,460토큰을 다시 써야 했고, 같은 메시지 비용이 507% 더 비쌌다. 두 번의 실행 결과도 일치했다. 로그의 모든 캐시 쓰기는 ephemeral_1h였다.
왜 1시간이고, 언제 5분인가
Claude Code 문서에 따르면 기본 수명은 로그인 방식에 따라 달라진다:
| 로그인 방식 | 주 대화 | 서브에이전트, 컴팩션 등 |
|---|---|---|
| 구독, 포함된 사용량 범위 내 | 1시간 | 5분 |
| 구독, 사용량 크레딧 사용 | 5분 | 5분 |
| API 키 또는 클라우드 제공업체 | 5분 | 5분 |
Opus 5.5에서는 1시간 캐시 쓰기 비용이 백만 토큰당 $8이고(일반 입력 대비 +100%), 캐시 읽기는 $0.20(-95%)이다. 그래서 만료 비용은 대화가 길수록 커진다. 200,000토큰짜리 대화를 다시 쓰는 데만 메시지를 보내기도 전에 약 $1.60이 든다.
오래 쉬기 전에
우리는 대기 시간만 측정했으며, 아래 내용은 문서에 나온 것이다:
- 1시간 이내: 아무것도 하지 않는다.
- 긴 휴식, 같은 작업: 떠나기 전에
/compact를 실행한다. 캐시가 따뜻할 때는 저렴하고, 다시 캐시해야 할 것은 작은 요약본뿐이다.
- 긴 휴식, 새 작업:
/clear를 사용한다(문서상 비용이 들지 않는다고 한다).
- 확인: v2.1.251부터
/usage는 캐시가 따뜻한지 차가운지를 보여준다.
- TTL을 직접 선택:
promptCacheTtl(5m또는1h, v2.1.242+).claude -p "hello" --output-format json을 실행하고ephemeral_1h_input_tokens와ephemeral_5m_input_tokens중 무엇이 나오는지 확인하면 된다.
작은 프로젝트와 두 번의 실행이므로, 정확한 수치는 예시로 받아들여야 한다. 가격표, 더 큰 세션에서의 계산, 제한 사항을 포함한 전체 글은 여기 있다:
👉 https://tokensave.app/blog/claude-code-cache-break-cost
원시 로그와 CSV는 CC BY 4.0으로 공개되어 있다.
출처
- 원문: https://dev.to/jaehyun_cho_0dff271e0d2e5/i-paused-claude-code-for-0-to-65-minutes-to-see-when-the-prompt-cache-expires-4ggl (2026-10-20 · Johmisking)