Claude Code 사용량 분석 기사 요약

Zenn에 Claude Code의 사용량이 어디서 줄었는지, 개인적인 대화 기록을 모아 집계한 글이 올라왔다. 대상은 하루 동안의 수정 작업이며, 33개의 요청 내역으로 세분화되어 있다.

먼저 전제부터 말하자면, Claude Code는 요청할 때마다 지금까지의 대화 기록 전체를 요약하여 모델에 다시 보내고 있으며, 매번 같은 부분은 캐시(cache)에 저장되므로 두 번째 요청부터는 비용이 저렴해진다. 다만 유효 기간이 있다. 작성자의 기록에서는 그 시간이 1시간이었다. 시간이 지나 만료되면 다음 요청에서 긴 기록 전체를 통째로 다시 쓰게 된다.

작성자는 일반적인 입력을 1배율로 두고, 사용한 양을 환산했다.

• 캐시 읽기: 0.1배

• 쓰기(쓰기): 2배

• 출력: 5배

• 하루 총합은 약 162만이다.

• 시간이 지난 후 첫 번째, 두 번째 요청만으로 약 77만이 소모되었다.

• 실제 수정 작업에 사용된 것은 4할 남짓이었다.

총량의 절반가량이 단지 두 번의 요청으로 사라진 계산이 되었다. 또 다른 큰 지출 항목도 무거운 처리는 아니었다. 폴더 이동 중 '액세스 거부' 오류가 발생하여 원인을 조사하고 재시도한 7회 왕복이 약 19만이었다. 이 수치는 추측을 포함한 숫자라고 한다.

작성자는 원래 무거운 처리 부분이 사용량을 차지한다고 생각했지만, 집계 결과로 드러난 것은 긴 대화와 공백 시간, 그리고 왕복 횟수의 곱셈이라는 것이었다.

대책은 메모리에 주의사항을 추가하는 방향이 아니었다. 메모리는 세션마다 읽히는 메모이기 때문에, 무언가를 더 쓸수록 입력량이 늘어난다. 대신 시스템적인 방식으로 방지하는 쪽으로 기울였다.

이동 스크립트에는 재시도 기능을 통합하여 Claude와의 왕복 자체를 없앴다. UserPromptSubmit 훅(hook)을 사용하여 이전 응답으로부터 60분 이상 공백이 있을 경우 새로운 세션을 권유하는 문구를 삽입하도록 설정했다. 다음 날의 연속 작업은 새로운 세션으로 시작한다. 메모리의 인덱스 파일도 23,270바이트에서 13,849바이트로 줄였다. 세션 시작 시 토큰 수는 61,842개에서 58,255개로 감소했다.

절약의 우선순위는 '세션을 끊기' > '스크립트에 맡기기' > '훅으로 강제하기' > '메모리에 쓰기' 순서라고 결론지었다.

함정(落とし穴)도 있었다. 훅은 공백 시간만 보기 때문에, 대화가 거의 없는 세션에서도 권유 문구가 나타났다. Windows에서는 일본어 문자 깨짐이나 경로의 백슬래시로 인해 작동하지 않는 문제가 발생했다. 제한에 도달하여 중단했을 때, 진행 과정이 대화 안에만 있는 경우 회수할 수 없었다.

Claude Code로 어제 나눈 대화를 그대로 이어가고 있다면, 다음 날 아침에는 새로운 세션으로 시작해 보는 것이 좋겠다.

↓상세 내용