Claude Code 대화 비용을 줄이는 프롬프트 캐싱 원리
Claude Code는 같은 대화를 이어갈 때 이전에 보낸 일부를 임시로 저장해 다시 사용한다. 이미 저장된 앞부분은 전체 비용의 10%만 청구되고, 새로 덧붙인 부분만 일반 비용으로 처리된다.
이 방식은 이며, 요청의 시작 부분인 모델, , 프로젝트 정보, 전체 대화 기록이 최근 저장된 내용과 맞는지 확인한다. 기본 은 5분이다.
그래서 Claude Code를 토큰당 과금 방식으로 쓰는 경우, 대화를 이어가기까지 5분을 넘기면 다음 요청에서 전체 대화 기록을 다시 제값으로 계산할 수 있다. 캐시는 현재 대화 상태를 일정 시간 동안 저장하는 ‘쓰기’가 일어날 때 만들어지며, 유효 시간은 5분 또는 1시간 단위로 다뤄진다.
핵심 포인트
- Claude Code는 이어지는 대화의 앞부분을 저장해 재사용할 수 있다.
- 이미 캐시된 앞부분은 전체 비용의 10%만 청구된다.
- 기본 은 5분이라, 5분 넘게 멈추면 비용 이점이 사라질 수 있다.
- 은 요청의 시작 부분이 이전 캐시와 맞는지 확인하는 방식이다.
- 긴 Claude Code 작업에서는 대화 간격도 비용 관리 요소가 된다.