AI 에이전트 비용 집계 — 그 숫자로 청구하면 안 됩니다

에이전트를 돌리면 얼마 썼는지 숫자로 알려줍니다. 편해서 그대로 갖다 쓰기 쉬운데, 공식 문서가 경고를 꽤 세게 답니다 — 그 값은 추정치지 청구 데이터가 아니고, 그 숫자로 사용자에게 청구하거나 금전적 판단을 내리지 말라는 겁니다. 게다가 직접 합산하려 들면 같은 값을 두 번 세거나, 출력량을 엉뚱하게 집계하기 딱 좋아요. 정리했습니다.

📌 30초 요약

• ★★그 숫자는 추정치입니다 — 청구에 쓰지 말라고 명시돼 있습니다.
• ★같은 차례의 메시지는 번호를 공유합니다 — 그냥 더하면 부풀려집니다.
• ★출력 수치는 자리표시자라 마지막 정리에서 읽어야 합니다.
• ⚠️ 하위 작업이 빠지는 칸이 따로 있습니다.
• 대화를 비우면 누적이 리셋됩니다 — 예산 상한도 함께.
• 짧은 세션을 반복하면 캐시가 매번 만료됩니다.

그 숫자는 추정치입니다

먼저 성격부터 분명히 해둡니다. 돌려주는 비용 값은 빌드 시점에 함께 담긴 가격표로 내 컴퓨터에서 계산한 값이에요. 그래서 가격이 바뀌었거나, 설치된 판이 그 모델을 못 알아보거나, 클라이언트가 흉내 낼 수 없는 청구 규칙이 걸리면 실제 청구액과 어긋납니다.

문서의 권고가 명확합니다 — 개발하면서 감을 잡거나 대략의 예산을 잡는 데는 쓰되, 정확한 청구가 필요하면 사용량·비용을 알려주는 정식 창구나 콘솔의 사용량 화면을 보라는 것. 그리고 못을 박습니다: 이 값으로 최종 사용자에게 청구하거나 금전적 결정을 내리지 말 것. 가성비를 따져 모델을 고른 뒤 실제로 얼마 나가는지 볼 때도 이 구분을 기억하세요.

같은 번호를 두 번 더하고 있습니다

직접 합산하려는 순간 첫 함정이 나옵니다. AI가 한 차례에 도구를 여러 개 동시에 부르면 메시지가 여러 개 나오는데, 그 메시지들이 전부 같은 번호에 같은 사용량을 달고 있습니다.

그대로 다 더하면 한 번 쓴 걸 네 번, 다섯 번 센 값이 나와요. 문서의 처방은 간단합니다 — 이미 센 번호를 기억해두고 같은 번호는 건너뛰라는 것. 도구를 병렬로 많이 부르는 작업일수록 부풀려지는 폭이 커집니다.

⚠️ 출력 수치는 자리표시자입니다

중복을 걸러내도 하나가 더 남습니다. 각 메시지에 실린 출력량은 응답이 시작될 때 보고된 값이라, 글이 다 나오기도 전에 찍힌 숫자예요. 한 번의 응답이 메시지 여럿으로 갈라져도 전부 같은 자리표시자를 답니다. 진짜 출력량은 마지막 정리 메시지에 실려 오니 거기서 읽어야 합니다. 들어온 양과 캐시 수치는 중복만 걸러내면 정확한데, 출력만 이렇게 다릅니다.

하위 작업이 빠지는 칸이 있습니다

마지막 정리 메시지에는 비용 관련 칸이 세 개 있는데, 하위 작업을 세는 방식이 서로 다릅니다. 이걸 모르고 아무거나 쓰면 실제보다 적게 잡힙니다.

칸	하위 작업을 세나
사용량	뺍니다 — 중첩되는 순간 과소 집계
총 비용	넣습니다
모델별 내역	넣습니다 — 모델별로 쪼개서
예산 초과로 끝났을 때	사용량 칸만 마지막 응답을 빠뜨림

결론은 분명합니다 — 전체를 보려면 사용량 칸이 아니라 총 비용이나 모델별 내역을 보라는 것. 모델별 내역은 가벼운 모델을 하위에 붙이고 주 작업만 상위 모델로 돌릴 때 어디서 돈이 나가는지 확인하기에도 좋습니다. 하위 작업이 얼마나 불어날지는 실행 한도를 걸어 묶어두는 쪽과 함께 봐야 하고요.

대화를 비우면 누적이 리셋됩니다

통로를 열어두고 여러 차례 주고받는 방식에서만 나오는 함정입니다. 이때는 차례마다 정리 메시지가 하나씩 오고, 그 안의 총액은 지금까지의 누적이에요. 그래서 보통은 마지막 것 하나만 읽으면 됩니다.

그런데 대화를 비우는 명령을 보내면 그 누적이 0에서 다시 시작합니다. 예산 상한도 함께 리셋되고요. 그러니 전체 총액을 구하려면 비우기 직전의 정리 메시지와 마지막 정리 메시지를 더해야 합니다. 마지막 것만 읽으면 비우기 전에 쓴 돈이 통째로 빠집니다.

📋 진행 상황도 같은 흐름에서 읽어냅니다

비용을 세려면 오가는 메시지를 훑어야 하는데, 진행 상황을 화면에 그리는 것도 같은 흐름에서 읽어냅니다. 다만 요즘 모델에서는 할 일 도구가 기본으로 빠져 있어 켜지 않으면 흔적이 아예 안 나와요. 켠 뒤에도 항목 번호가 만들 때가 아니라 결과 쪽에 실려 오니 짝을 지어 관리해야 합니다.

자주 묻는 질문 (FAQ)

Q. 짧은 작업을 자주 돌리는데 요금이 안 줄어듭니다.

캐시가 세션 사이에 만료되고 있을 수 있습니다. 같은 지시문과 맥락을 반복해 쓰면 재사용 할인이 걸리는데, 기본 보관 시간이 짧아서 세션 간격이 그보다 길면 매번 제값을 냅니다. 보관 시간을 길게 바꾸는 환경 값이 있고, 주 대화와 하위 작업에 각각 따로 지정할 수도 있어요. 다만 오래 보관하는 쓰기는 더 비싸게 매겨지니, 재사용이 실제로 늘어나는 상황인지 보고 켜세요.

Q. 세션이 죽었는데 비용을 어떻게 복구하나요?

마지막 정리 메시지의 비용 칸이 전부 0으로 올 수 있습니다. 문서가 두 단계 복구법을 줍니다 — 먼저 직전 차례의 정리 메시지를 쓰세요. 거기에 그때까지의 누적이 들어 있습니다. 한 번에 끝내는 방식이거나 첫 차례에 죽어서 앞선 정리가 없다면, 메시지들의 사용량을 번호 중복을 걸러가며 직접 합산해야 합니다. 다만 이 방법으로는 하위 작업분과 출력량, 금액은 되살릴 수 없습니다.

Q. 여러 번 호출한 총액은 어디서 보나요?

세션 전체를 합산해주는 값은 없습니다. 호출 하나하나가 자기 몫만 알려주니, 여러 번 부르는 프로그램이라면 내가 직접 누적해야 해요. 이어받기로 같은 세션을 계속 써도 마찬가지입니다. 사용자별로 나눠 집계하려면 호출할 때마다 값을 받아 내 쪽 장부에 쌓아두는 구조를 처음부터 잡아두세요. 실패한 호출도 쓴 만큼은 값이 실려 오니 빠뜨리지 말고요.

🧾 정직하게 밝혀둘 것

• 제가 장부를 맞춰본 실측이 아닙니다. 공식 문서의 집계 규칙·경고·복구 절차를 우리말로 정리했습니다.
• ★필드 이름·환경 변수·판올림 번호·가격 배수는 옮기지 않았습니다. 실제로 집계 코드를 짤 때는 원문 표를 보세요.
• ★"부풀려지는 폭이 커진다"는 제 표현이고, 문서는 같은 번호를 중복 집계하지 말라는 사실만 밝힙니다.
• 가격과 청구 규칙은 수시로 바뀝니다. 정확한 금액은 공식 사용량 화면에서 확인하세요.

✨ 정리하면

돌려주는 비용 값은 내 컴퓨터에서 계산한 추정치라, 문서가 그 숫자로 사용자에게 청구하지 말라고 못 박습니다. 직접 합산할 거라면 같은 번호를 두 번 세지 않도록 걸러내고, 출력량은 자리표시자라 마지막 정리에서 읽어야 해요. 그리고 사용량 칸은 하위 작업을 빼니 전체는 총 비용이나 모델별 내역으로 봐야 합니다. 실행량 자체를 묶는 방법은 실행 한도 정리, 하위 작업이 불어나는 구조는 하위 에이전트 정리, 가성비로 모델을 고르는 이야기는 GLM 5.2 무료 체험, 전체 비용 흐름은 AI 지출 관리 허브에 모아뒀습니다.

※ 출처: Claude 에이전트 개발 도구의 비용·사용량 추적 공식 문서(2026년 8월 31일 열람). 가격과 청구 규칙은 수시로 바뀝니다.