2026-11-02 · 6 min read

Claude Code 청구서의 돈은 어디로 가는가

AI API 지출을 한 줄씩 읽기: 모든 요청에 있는 세 가지 숫자, 에이전트 청구를 조용히 지배하는 메커니즘, 그리고 청구서를 감사 가능하게 만드는 세 가지 질문.

월간 API 청구서는 질문을 발견하기에 최악의 장소입니다. 무엇에 썼는지는 알려주지만 어디로 갔는지는 절대 알려주지 않죠 — 코딩 에이전트라면 그 행선지는 처음 보면 정말 의외입니다. 이 글은 청구 대시보드를 열기 전 모든 개발자가 갖추길 바라는 사고방식입니다.

먼저 공개합니다: 나는 Claude Code와 OpenAI SDK 도구를 위한 API 게이트웨이 Teapot Router를 운영합니다. 하지만 이 글의 내용은 그것과 무관합니다 — 아래의 해부는 Anthropic 호환 어떤 엔드포인트에도 똑같이 적용됩니다.

모든 줄은 세 가지 숫자

코딩 에이전트의 요청은 세 구성 요소로 과금됩니다. 들여야 할 반사신경: 청구서에 놀랐을 때 '어떤 모델이 비싼가'가 아니라 줄을 펴고 '세 숫자 중 무엇이 움직였는가'를 묻는 것.

  1. 프롬프트 토큰 — 모델이 읽는 모든 것: 시스템 프롬프트, 프로젝트 맥락, 지금까지의 대화, 도구 결과. 긴 세션에서 이것이 '당신의 질문'인 경우는 거의 없고, 답하기 위해 다시 읽은 모든 것까지 포함입니다.
  2. 완료 토큰 — 모델이 되돌려 쓰는 것: 코드, 추론, 도구 호출. 에이전트 청구에서는 보통 소수입니다.
  3. 캐시 읽기/쓰기 — 프롬프트 캐시 과금. 읽기는 크게 할인되고 쓰기는 캐시 생성 비용입니다. 도구와 엔드포인트가 캐시를 잘 쓰는지에 따라 실효 단가가 크게 달라집니다.

조용한 주인공: 컨텍스트는 매번 재전송된다

Claude Code 같은 에이전트는 통신상 무상태입니다. 매 턴마다 클라이언트는 대화를 처음부터 다시 보냅니다 — 시스템 프롬프트, 파일 맥락, 이전 도구 결과까지. 세션의 15번째 메시지는 15개를 한 번에 물은 것과 같은 과금이 됩니다. 결함이 아니라 프로토콜의 작동 방식이지만, 직관에 반하는 두 가지 사실을 설명합니다:

저렴한 모델의 긴 세션이 비싼 모델의 짧은 세션보다 비쌀 수 있다. 그리고 ROI가 가장 좋은 해법은 보통 할인 찾기가 아니라 컨텍스트 관리 — 낡은 도구 출력 정리, 세션을 작게 유지, 캐시가 일하게 두기 — 입니다.

세 가지 레버, 정직한 순서로

요금표를 손대기 전에, 정직하게 아끼는 순서대로:

  1. 작업에 맞는 모델 고르기. 상투적인 편집과 검색에 플래그십은 필요 없고, 어려운 설계 요청에 필요합니다. 작업별 라우팅이 가장 큰 정공법입니다.
  2. 캐시를 실제로 작동시키기. 프롬프트 캐시 읽기는 콜드 토큰보다 한 자리 수 저렴합니다. 안정적인 시스템 프롬프트와 세션 구조가 어떤 요금표보다 효과적입니다.
  3. 구독 vs 종량 — 자신의 사용 패턴으로 계산하기. 한 모델에 집중된 사용이면 정액이 이기고, 다양하고 불규칙하고 여러 도구에 분산되면 종량이 이깁니다. 만능 답은 없고 당신의 계산만 있습니다.

어떤 공급자에게도 물어야 할 세 가지 질문

어떤 엔드포인트를 쓰든, 이 세 가지가 블랙박스를 감사 로그로 바꿉니다:

  1. 요청별 비용·토큰·레이턴시를 볼 수 있는가 — 월간 합계만이 아니라. 내보내기도 가능해야 합니다.
  2. 기계 판독 가능한 가격표가 있는가. 커밋 전에 스크립트로 비용을 계산할 수 있는가. 로그인 없는 공개 JSON 엔드포인트가 최소선이라고 봅니다.
  3. 미사용 잔액은 어떻게 되는가 — 유효기간, 환불 정책, 수수료는. '그냥 계속 있는다'는 분위기가 아니라 문서화된 정책이어야 합니다.

프라이버시: 코드를 엔드포인트로 흘려보내는 이상

무엇이 보관되는지 물으세요. Teapot Router는 과금 메타데이터만 보관하고 프롬프트/응답 아카이브는 없습니다 — 그리고 당사를 포함해 어떤 벤더의 '제로 로그' 마케팅도 믿지 말고 검증해야 합니다.

비용 최적화 전문가가 될 필요는 없습니다. 필요한 것은 청구서가 '응답 가능'한 것입니다: 대시보드를 열고, 해당 줄을 찾고, 숫자의 이름을 댈 수 있는 것. 엔드포인트가 그걸 주면 모든 놀람은 지원 티켓이 아니라 한 줄 설명이 됩니다.

FAQ

긴 Claude Code 세션이 메시지당 더 비싼 이유는?

매 턴마다 지금까지의 대화가 재전송되어, 15번째 메시지는 1번째보다 훨씬 큰 프롬프트에 대해 과금됩니다. 토큰 단가가 같아도 세션이 길수록 메시지당 비용이 늘어납니다.

캐시가 청구를 줄이나요?

네, 크게: 프롬프트 캐시 읽기는 콜드 토큰보다 한 자리 수 저렴합니다. 프롬프트를 안정적으로 유지하고 세션을 작게 유지하면 같은 맥락에 전액을 지불하지 않아도 됩니다.

요청별 비용을 감사하려면?

워크스페이스에서 요청별 비용·토큰·레이턴시와 내보내기를 제공하고, 대조할 수 있는 기계 판독 가격표가 있는 엔드포인트를 쓰세요. 그 조합이 청구서를 감사 로그로 만듭니다.

All posts