이 글을 쓰는 이유
Claude Code의 비용을 검색하면 같은 페이지를 마흔 번 만나게 된다. 요금제 등급이 담긴 표, 한도에 관한 문단, 그리고 그 주에 작성자가 마침 무엇을 만들고 있었는지에 따라 달라지는 결론. 그 표는 정확하고 거의 쓸모없다. 입장료를 얼마 내는지는 알려주지만, 같은 요금제, 같은 저장소에서 화요일 세션이 월요일보다 세 배 무겁게 느껴진 이유는 알려주지 않는다.
두 번째 질문에는 산수로 된 답이 있고, 그 답은 이미 당신의 컴퓨터에 있다. 이 글은 그것을 짚어 간다. 턴이 실제로 무엇을 다시 보내는지, 청구서의 네 줄 중 무엇이 지배적인지, 그리고 일상적인 작업에서 낭비가 어디에 숨어 있는지. 제품은 마지막 삼분의 일까지 비켜 두겠다. 방법 자체는 제품 없이도 성립하고, 무언가를 사야만 작동하는 비용 분석은 비용 분석이 아니기 때문이다.
청구서를 설명하는 하나의 곱셈
턴은 모델로 가는 왕복 한 번이다. 하네스가 압축하거나 당신이 처음부터 다시 시작하지 않는 한, 지금까지의 대화 전부가 그 턴에 함께 간다. 그게 전부다. 한 번 읽은 파일이 한 번만 과금되지 않는 이유이기도 하다. 우리 문서는 이를 token-turn이라는 하나의 단위로 정리한다. token에 그 내용이 컨텍스트에 살아남는 턴 수를 곱한 값이다.
8,000 token × 30턴 = 240,000 token-turn
15,000 token × 37턴 = 555,000 token-turn
두 번 읽어 보라. 대부분이 이 문제에 가지고 오는 직관을 뒤집기 때문이다. 코드를 덜 쓰는 도구가 가장 많이 아끼는 도구가 아니다. 이미 쓰인 것을 컨텍스트에서 걷어내는 도구가 그렇다. 4번째 턴에 도착해 끝까지 떠나지 않는 15k 파일은 1번째 턴에 도착하는 8k 파일보다 세 배 넘게 비싸다. 그리고 사람들이 보통 최적화하려 드는 쪽은 두 번째다.
네 줄, 한 줄이 아니다: 청구서의 구성
Anthropic의 청구서는 입력을 세 구간으로 나눈다. 새 입력, 캐시 쓰기, 캐시 읽기, 그리고 출력이 더해진다. 이 구분이 중요한 이유는 세 입력 구간의 가격이 같지 않고, 세션이 길어질수록 서로 반대 방향으로 움직이기 때문이다. 캐시 읽기는 기본 입력 가격의 일부만큼만 청구되는데, 캐시 읽기가 매 턴 일어난다는 점을 떠올리면 싸다는 말이 달라진다. 캐시 쓰기는 일반 입력보다 비싸고, 캐시가 만료되기 전에 그 블록이 다시 읽혀야만 본전을 뽑는다.
그 기한이 대부분의 가격 글이 빼먹는 부분이다. 프롬프트 캐시는 짧은 기간의 임대이고, 기간이 끝나면 계량기가 리셋된다. Utilities 데모의 캐시 타이머는 바로 이 때문에 있다. 몇 분간 유휴 상태가 되면 따뜻한 캐시가 식는 과정을 보여주므로, 긴 점심이 조용히 다음 턴의 가격을 올리는 순간을 지켜볼 수 있다. 비율은 가격표에 따라 바뀌지만, 구조는 바뀌지 않는다.
실제로 프롬프트 수가 같은 두 세션의 비용이 크게 달라지는 이유가 여기 있다. 하나는 안정적인 접두부를 유지하며 따뜻하게 남는다. 다른 하나는 컨텍스트 맨 앞의 파일을 고치고, 세 턴마다 접두부를 깨고, 그때마다 캐시를 다시 쓰는 값을 치른다.
token은 실제로 어디로 가는가
평범한 업무일에서 피할 수 있었던 무게의 대부분은 다섯 가지 범주가 차지한다. 어느 것도 특별하지 않다. 모두 일이 끝난 뒤 로컬 기록에서 확인할 수 있다.
1. 계속 다시 읽히는 컨텍스트
보내는 모든 메시지는 대화 전체를 끌고 간다. 40번째 턴에서도 3번째 턴에 연 파일은 여전히 기차에 오르고, 자리를 차지하고, 요금이 매겨진다. 흔한 해법인 새 세션은 효과가 있지만, 사람들은 시점을 잘못 고른다. 대화가 길게 느껴질 때 다시 시작하지, 왕복당 비용이 컨텍스트를 다시 세우는 비용을 넘는 순간에 다시 시작하지는 않는다. 이 둘은 다른 지점이고, 갱신이 이득이 되는 곳은 그중 하나뿐이다.
2. 함수 하나를 위해 읽는 파일 전체
에이전트에게 validate()를 고쳐 달라고 하면 보통 auth.ts 전체가 딸려 온다. 그러면 그 파일 전체가 남은 턴 동안 컨텍스트에 남고, 대부분은 무관하다. 같은 낭비가 반대 방향에서도 나타난다. 판단에 필요한 것은 처음 스무 줄이었는데 육백 줄이 일치하는 검색 결과를 돌려받는 경우다.
3. 아무도 읽지 않는 도구 출력
구백 줄을 찍는 테스트 실행, 모노레포의 빌드 로그, 파라미터 하나를 확인하려 가져온 문서 페이지의 HTML. 기록은 이 모두를 보관한다. 모델은 필요하든 아니든 다음 턴에 이 모두를 읽는다.
4. 코드가 컴파일되지 않는다는 걸 알아내는 데 쓰는 턴
편집이 반영되고, 에이전트가 끝났다고 말하고, 당신이 다음 일을 요청하고, 그제서야 누군가 빌드를 돌린다. 이제 컴파일러라면 2초에 알려줬을 문법 오류를 발견하는 왕복 한 번, 그것을 고치는 왕복 한 번, 그리고 그 둘이 컨텍스트에 남는 비용이 더해진다. 평범한 오후에는 다섯 항목 중 가장 조용한 항목이지만, 우리 경험으로는 지켜보기에 가장 답답한 항목이다.
5. 서두가 붙은 답변
"좋은 질문입니다. 제가 하려는 일을 설명드리겠습니다." 이 문장은 출력 token으로 한 번, 그 뒤로는 매 턴 입력 token으로 값을 치르게 한다. 답변이 이제 기록의 일부이기 때문이다. 습관 하나에 마흔 턴을 곱하면 청구서의 한 줄이 된다.
요금제 등급이 바꾸는 것과 바꾸지 않는 것
Claude Code 요금제는 구간 단위로 계량된다. 5시간 블록과 주간 상한이 있고, 그 구조가 가격 논의가 계속 제자리를 도는 이유다. 더 큰 요금제는 더 높은 가격에 여유를 산다. 15k 파일이 매 턴 15k로 청구된다는 사실을 바꾸지 않고, 재읽기를 싸게 만들지도 않는다. 충분히 여러 번 업그레이드하면 낭비도 요금제를 따라 커진다.
정직하게 말하면, 하는 일이 정말로 크다면 더 큰 요금제가 맞는 구매다. 먼저 물어야 할 것은 일이 큰지, 아니면 컨텍스트가 그저 무거운지다. 밖에서 보면 똑같아 보이지만 해법은 아주 다르다.
무엇이든 결정하기 전에 측정하라
이 글이 구체적일 수 있는 이유는 숫자가 로컬에 있기 때문이다. Claude Code는 턴마다 실제 token 사용량이 담긴 기록을 디스크에 쓰고, 측정 계층은 아무것도 어디로도 보내지 않고 그것을 읽을 수 있다. 우리의 Metering 프런트가 그 일을 하며 무료다. Deep Scan은 저장된 대화를 훑어 지출을 출처별로 나누고, Harness History는 끝난 세션마다 영수증을 열어 주며, Inside the Wallet은 새 입력, 캐시 읽기, 캐시 쓰기, 출력을 모델별로 나누고, Plan Usage는 각 구간이 한도 갱신 전까지 무엇을 만들어 냈는지 보여 준다.
평균이 아니라 지난주 가장 지저분한 세션부터 시작하라. 평균은 문제의 형태를 감춘다. 형태가 바로 당신이 손댈 수 있는 것이다. 2번째 턴에 읽은 거대한 파일 하나, 중간에 끼어든 로그 하나, 육백 token을 늘어놓은 뒤 서른 번 다시 읽힌 답변 하나.
HarnessUp이 들어갈 자리
이제 우리가 무언가를 파는 부분이므로, 숫자와 그에 필요한 요금제를 함께 밝힌다. HarnessUp은 Claude Code와 Codex의 공식 훅을 통해 작동하는 로컬 계층이다. 프록시도, MCP 서버도, 당신의 token이나 키를 읽는 무엇도 아니다. 열 개의 프런트에 걸쳐 151개의 도구가 있고, Savings 프런트의 상당 부분은 위의 다섯 범주에 하나씩 대응한다.
Renew Session은 계속하는 것이 다시 시작하는 것보다 비싸지는 턴을 표시하며, 실제 이력을 바탕으로 측정한 반사실 실험에서 그 전환은 과금된 컨텍스트의 73%에 도달했다. Code Finder는 큰 파일을 처음 읽을 때 골격을 돌려주고 본문은 요청이 있을 때만 준다. Delta Read는 에이전트가 이미 본 파일 구간을 거부한다. Head Limit은 백과사전 같은 grep 결과에 상한을 둔다. Terminal Guide와 Output Diet는 긴 로그의 시작, 끝, 오류 줄을 남긴다. First Pass는 편집 직후 컴파일하므로 깨진 빌드가 자기 턴을 하나 쓰는 대신 다음 턴에 함께 간다. Response Diet는 서두 문구를 잘라 낸다. Memory State는 컨텍스트 파일을 불변 조각으로 돌려 배치하고 4.27%의 컨텍스트와 298턴의 생존을 측정했다.
우리가 가진 가장 큰 숫자는 덜 화려하고 더 유용하다. 메시지 끝에서 모델 턴을 쓰지 않고 빌드를 실행하는 Build Now는 2,769회의 빌드와 일어나지 않은 806.7M 입력 token 재읽기를 기록했다. 이 숫자 중 어느 것도 당신의 것이 아니다. 그것은 계측기가 실행한 기계에서 측정한 값이며, 반사실을 제시하는 정직한 방식이다. 패널이 당신의 절감을 추정치와 따로 보여 주는 이유이기도 하다.
이 분석이 약속하지 않는 것
세션의 모든 token이 낭비는 아니며, 그렇다고 주장하는 도구는 쉽게 확인할 수 있는 거짓말을 하는 것이다. 필요한 파일을 읽는 것은 낭비가 아니다. 다음 턴에 그것을 다시 읽는 것은 모델의 기억에 대해 내는 세금이고, 그 세금의 일부는 작업의 값이다. 산수의 요점은 더 좁다. 과제가 요구한 것과 하네스가 용인한 것을 분리하고, 그중 무엇에 값을 치를지 정하는 것이다.
더 싼 세션이 더 빠른 세션이라고 약속하지도 않는다. 로그를 압축하거나 서두를 잘라 내면 모델이 보는 것이 달라지고, 잘라 낸 디테일이 사실은 중요했던 경우도 있다. 그래서 여기 있는 모든 도구는 되돌릴 수 있고, 측정 계층은 무료다. 거래를 받아들이기 전에 볼 수 있어야 하기 때문이다.