클로드 코드 프롬프트 캐시 쓰기를 5분·1시간으로 나눠 보는 OpenTelemetry 설정법

클로드 코드 v2.1.300부터 OpenTelemetry api_request 이벤트에 cache_creation_5m_tokens와 cache_creation_1h_tokens가 실린다. cache_creation_tokens 하나로 묶여 있던 캐시 쓰기 토큰을 수명별로 나눠 볼 수 있어서, 1시간 캐시를 켠 뒤 쓰기 비용이 얼마나 늘었는지 확인할 때 쓴다.

1. 텔레메트리를 켜고 로그 이벤트를 내보낸다. 처음에는 console로 터미널에 찍어 본다.

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=console
claude

1. claude_code.api_request 이벤트에서 두 값을 비교한다. 캐시 수명은 본 대화와 서브에이전트에 따로 정한다.

export CLAUDE_CODE_PROMPT_CACHE_TTL=1h
export CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL=5m

API 요금으로 치면 5분 캐시 쓰기는 기본 입력 단가의 1.25배, 1시간 캐시 쓰기는 2배다. 1시간 캐시를 켠 뒤 쓰기 토큰만 늘고 cache_read_tokens가 그만큼 늘지 않았다면 5분으로 되돌릴지 따져 본다. 두 속성은 아직 체인지로그에만 있다. 설명 문서의 api_request 항목에는 cache_creation_tokens만 나온다.