Claude Code 토큰 아끼는 꿀팁 - Anthropic도 인정한 버그에서 발견
2026.04.15


Claude Code 설정 파일에서 "DISABLE_TELEMETRY": "1"을 제거하면 프롬프트 캐시가 5분 TTL에서 1시간 TTL로 업그레이드되어 토큰 소모량을 크게 줄일 수 있습니다. 이는 Anthropic이 공식 인정한 버그입니다.
Claude Code를 사용하다 보면 토큰이 생각보다 빨리 소모되는 경험을 하게 됩니다. 많은 사람들이 개인 정보 보호를 위해 설정 파일에 "DISABLE_TELEMETRY": "1"을 추가해두는데, 이 설정이 오히려 토큰을 더 많이 쓰게 만드는 원인이었습니다.
Claude Code GitHub 이슈 #45381에서 공식 확인된 버그입니다. Anthropic 측도 해당 이슈를 CLOSED(종결)로 처리했습니다.
왜 DISABLE_TELEMETRY가 토큰에 영향을 주나?
핵심은 프롬프트 캐시 TTL(Time-To-Live)입니다.
Claude Code는 반복되는 컨텍스트(시스템 프롬프트, CLAUDE.md 내용 등)를 캐시에 저장해서 토큰을 아낍니다. 이 캐시의 유지 시간이 TTL인데, 두 종류가 있습니다.
TTL 종류 | 캐시 유지 시간 | 효과 |
|---|---|---|
5분 TTL | 5분 동안만 캐시 유지 | 캐시 미스가 잦아 토큰 소모↑ |
1시간 TTL | 1시간 동안 캐시 유지 | 캐시 히트율 높아 토큰 소모↓ |
문제는 DISABLE_TELEMETRY=1을 설정하면, 이 텔레메트리 비활성화 로직이 내부 실험 게이트(Statsig 피처 플래그) 조회도 함께 막아버린다는 점입니다. 결과적으로 1시간 TTL을 받을 자격이 있는 계정도 1시간 TTL이 활성화되지 않아 5분 TTL에 머무르게 됩니다.
실제로 얼마나 차이가 날까?
GitHub 이슈에 재현 코드가 공개됐습니다. 동일한 작업을 두 상태에서 실행하면:
DISABLE_TELEMETRY 설정 시:
ephemeral_1h_input_tokens = 0 ← 1시간 캐시 비활성화
ephemeral_5m_input_tokens = 8,094 ← 5분 캐시만 작동
DISABLE_TELEMETRY 미설정 시:
ephemeral_1h_input_tokens = 8,215 ← 1시간 캐시 정상 작동
ephemeral_5m_input_tokens = 0Max 플랜 사용자 기준으로 25M+ 캐시 토큰을 낭비하고 있었다는 GitHub 이슈 댓글 제보도 있었습니다.
해결책 — 설정 파일에서 한 줄 제거
Claude Code 설정 파일(~/.claude/settings.json 또는 프로젝트의 .claude/settings.json)을 열고 다음 줄을 제거합니다.
// 이 줄을 제거하세요
"DISABLE_TELEMETRY": "1"단, 에러 리포팅을 끄고 싶다면 아래 줄은 유지해도 됩니다.
// 이 줄은 유지 가능 (캐시에 영향 없음)
"DISABLE_ERROR_REPORTING": "1"변경 후 Claude Code를 재시작하면 적용됩니다.
실전에서 어떻게 쓸 수 있을까?
토큰 사용 현황 직접 확인하는 방법
설정 변경 전후를 비교하고 싶다면, Claude Code 세션 로그에서 캐시 토큰 수치를 직접 확인할 수 있습니다.
# 세션 로그 위치
~/.claude/projects/[프로젝트 경로]/[session-id].jsonl로그에서 ephemeral_1h_input_tokens 값이 0이 아닌 숫자라면 1시간 TTL이 정상 작동 중입니다.
DISABLE_TELEMETRY 없이 개인 정보를 보호하는 방법
텔레메트리를 끄면서도 캐시 성능을 유지하려면, 전체를 비활성화하는 대신 에러 리포팅만 선택적으로 끄는 방식을 권장합니다.
{
"env": {
"DISABLE_ERROR_REPORTING": "1"
}
}자주 묻는 질문
DISABLE_TELEMETRY를 제거하면 어떤 데이터가 수집되나요?
Claude Code는 사용 통계, 세션 메타데이터 등을 수집합니다. 제거해도 대화 내용 자체는 수집 대상이 아닙니다. 자세한 내용은 Anthropic의 데이터 사용 정책(code.claude.com/docs/en/data-usage)에서 확인할 수 있습니다.
설정 변경 후 효과가 바로 나타나나요?
Claude Code를 재시작한 뒤 첫 요청부터 적용됩니다. 캐시가 처음 쌓이기까지는 첫 1~2회 요청에서 캐시 미스가 발생할 수 있습니다.
Max 플랜이 아니어도 1시간 TTL을 받을 수 있나요?
네. Pro 플랜 이상에서도 1시간 TTL은 적용 가능합니다. 단, Anthropic의 실험 게이트 조건이 계정마다 다를 수 있으므로 실제 로그에서 ephemeral_1h_input_tokens 값을 확인해보는 것이 가장 정확합니다.
한 발 더 — 나의 생각
이 버그에서 흥미로운 건 버그 자체보다 발견 경위입니다.
"텔레메트리를 끄면 토큰이 더 든다"는 건 직관적으로 전혀 예상하기 어려운 인과관계입니다. 이걸 발견한 사람은 세션 로그를 직접 파싱해서 캐시 토큰 수치를 비교해봤습니다. 즉, 블랙박스처럼 쓰는 게 아니라 내부 동작을 들여다본 사람만 알 수 있었던 문제입니다.
개인정보 보호를 위해 텔레메트리를 끈 사람들이 정작 더 많은 토큰을 소모하고 있었다는 아이러니도 인상적입니다. 의도는 반대였는데 결과가 반대로 나온 케이스죠.
이 버그는 이미 종결 처리됐습니다. 하지만 지금 당장 설정을 확인해볼 이유는 충분합니다. 특히 Max 플랜처럼 사용량이 많은 계정일수록, DISABLE_TELEMETRY 설정 하나가 얼마나 많은 토큰을 낭비하고 있었는지 직접 확인해보면 꽤 놀랄 수 있습니다.
원문: https://x.com/AlexZio00/status/2043883749126090859
참고: https://github.com/anthropics/claude-code/issues/45381
