결제 첫 달에 볼 것 — 사용량 화면의 숫자가 전부가 아닙니다

첫 달 · 사용량 읽기

20만 토큰을 보냈는데
화면엔 50으로 찍힙니다.

오타가 아닙니다. 공식 문서에 그 예시가 그대로 실려 있습니다. 사용량 화면의 입력 토큰 수는 보낸 양 전체가 아니라 특정 지점 이후만 셉니다. 첫 달에 이걸 모르면 숫자를 반대로 읽게 됩니다.

첫 결제까지 했으면 그다음은 한 달 동안 얼마나 쓰는지 파악하는 일입니다. 그런데 사용량 화면이 생각보다 안 친절합니다. 구독과 API가 아예 다른 걸 보여주고, 숫자 하나는 대놓고 오해를 부르게 생겼습니다.

📌 30초 요약

• 구독은 설정 → 사용량에 진행바가 있습니다. 5시간 세션과 주간 두 개가 따로 돕니다.
• 빨리 닳게 하는 건 질문 수가 아니라 대화가 길어지는 것입니다.
• 프로젝트에 올린 문서는 캐시돼서 재사용분은 한도에 안 잡힙니다.
• API는 완전히 다른 두 축입니다 — 월 지출 상한과 분당 처리량.
• ⚠️ 표시되는 입력 토큰은 마지막 캐시 지점 이후만 셉니다. 총량과 다릅니다.

① 구독이면 — 진행바 두 개를 보세요

설정 → 사용량(Settings → Usage)에 들어가면 진행바가 있습니다. 문서 설명 그대로입니다.

📄 원문

"Current session: How much of your plan's five-hour session limit you've used thus far, plus the amount of time remaining"

"Weekly limits: Check when your plan's weekly usage limit resets"

→ 한도가 하나가 아니라 둘입니다. 5시간 세션이 굴러가면서, 그와 별개로 주간 한도가 따로 있습니다.

세션은 5시간 롤링이라 정해진 시각에 초기화되는 게 아니라 굴러갑니다. 주간 한도는 계정마다 정해진 고정 시각에 초기화되고요. 그리고 문서는 주간 한도를 Opus 전용과 나머지 모델로 나눠서 표시한다고 적고 있습니다 — 둘 중 하나만 차 있어도 그 모델은 막힙니다.

② 질문 수가 아니라 대화 길이가 문제입니다

"몇 번 물어보면 한도에 걸리나요"를 궁금해하시는데, 문서가 든 소모 요인은 횟수가 아닙니다.

문서가 든 소모 요인	뜻
Message length	한 번에 보내는 글이 길수록
File attachment size	붙인 파일이 클수록
Current conversation length	지금 대화창이 길수록
Tool usage	리서치·웹검색을 쓸수록
Model / effort level	어떤 모델을 얼마나 깊게 굴리느냐

세 번째가 핵심입니다. 대화가 길어지면 매 질문마다 그 앞의 내용이 통째로 다시 들어갑니다. 그래서 같은 열 개의 질문이라도 한 창에서 이어서 물으면 뒤로 갈수록 한 번의 비용이 커집니다. 주제가 바뀌면 새 대화를 여는 게 절약입니다.

💡 문서가 직접 권한 절약법

· "Batch similar requests in one message" — 비슷한 요청은 한 메시지에 몰아서

· "Refer back to previous information instead of repeating it" — 앞에 쓴 걸 다시 붙여넣지 말고 가리키기

· 코딩이면 첫 메시지에 맥락과 코드를 다 넣고, 글 편집이면 전체 원고를 한 번에 보내라고 안내합니다. 잘라서 여러 번 보내는 게 오히려 손해라는 뜻입니다.

③ 반복해서 쓸 자료는 프로젝트에 올리세요

📄 원문

"When you upload documents to a project, they're cached for future use"

"Every time you reference that content, only new/uncached portions count against your limits"

→ 같은 자료를 매번 붙여넣으면 매번 한도를 먹지만, 프로젝트에 한 번 올려두면 재사용분은 안 잡힙니다.

회사 문서, 코드베이스, 스타일 가이드처럼 여러 번 참조할 자료가 있다면 첫 달에 이걸 세팅해두는 게 가장 큰 절약입니다. 문서도 "여러 번 참조할 것은 프로젝트를 쓰라"고 그대로 권합니다.

④ API를 쓴다면 화면이 완전히 다릅니다

구독과 API를 같은 것으로 생각하시면 첫 달에 헷갈립니다. API 문서는 한도를 두 종류로 명확히 나눕니다.

종류	무엇을 막나
Spend limits	한 달에 쓸 수 있는 최대 금액. 돈을 막습니다
Rate limits	정해진 시간 안에 보낼 수 있는 양. 속도를 막습니다

월 지출 상한은 등급별로 정해져 있습니다. 문서에 표로 나옵니다.

등급	월 지출 상한
Start	500 USD
Build	1,000 USD
Scale	200,000 USD

📄 상한에 닿으면

"Once you reach your tier's spend cap, API usage pauses until the next month unless you request a higher limit."

→ 다음 달까지 멈춥니다. 상한을 등급 한도보다 낮게 직접 설정할 수도 있는데, 지출 상한을 거는 법에서 따로 다뤘습니다. 상한은 곧 멈추는 날짜라는 점만 기억하세요.

속도 제한은 분당 요청 수·분당 입력 토큰·분당 출력 토큰 세 가지로 걸립니다. 초과하면 429 오류와 함께 얼마나 기다리라는 헤더가 같이 옵니다. 그리고 문서가 짚어둔 재미있는 점 — 고정 시각에 초기화되는 게 아니라 계속 조금씩 차오릅니다.

⑤ 여기가 함정입니다 — 숫자가 총량이 아닙니다

이 글을 쓴 이유입니다. API 응답에 찍히는 입력 토큰 수는 보낸 것 전부가 아닙니다. 문서가 예시까지 들어 설명합니다.

📄 원문 예시

"For example, with a 200k token cached document and a 50 token user question, you'd see input_tokens: 50 even though the total input is 200,050 tokens."

# 실제 총 입력량은 이렇게 더해야 나옵니다
total_input_tokens = cache_read_input_tokens
                   + cache_creation_input_tokens
                   + input_tokens

input_tokens는 마지막 캐시 지점 이후 부분만 셉니다. 캐시를 쓰고 있다면 이 숫자는 실제보다 훨씬 작게 보입니다. "어? 얼마 안 썼는데?" 하고 넘어가기 딱 좋은 지점입니다.

그런데 이게 나쁜 소식만은 아닙니다. 속도 제한 계산에서는 캐시에서 읽은 토큰이 빠집니다.

✅ 캐시가 실제로 이득인 이유

"For most Claude models, only uncached input tokens count toward your ITPM rate limits."

문서의 계산 예 — 분당 200만 토큰 한도에 캐시 적중률이 높으면 실질 처리량이 그 몇 배가 됩니다. 캐시에서 읽은 몫은 한도에서 빠지니까요. 요금도 기본 입력가의 10퍼센트 수준으로 매겨진다고 적혀 있습니다.

⚠️ 다만 예외가 하나 명시돼 있습니다

Haiku 3.5는 캐시에서 읽은 토큰도 한도에 포함됩니다. 문서가 표에 † 표시로 따로 구분해뒀습니다. "캐시는 무조건 공짜로 빠진다"고 일반화하면 이 모델에서 틀립니다. 쓰시는 모델이 예외 목록에 있는지 확인하세요.

⑥ 첫 달 체크리스트

1. 첫 주에 사용량 화면을 한 번 여세요. 5시간 진행바가 어느 속도로 차는지 감을 잡는 게 목적입니다. 청구서가 아니라 내 사용 패턴을 보는 겁니다.

2. 주간 한도 초기화 시각을 적어두세요. 계정마다 다릅니다. 마감이 걸린 주에 이걸 모르면 곤란해집니다.

3. 반복 자료는 프로젝트로 옮기세요. 매번 붙여넣던 걸 한 번만 올리면 됩니다.

4. 주제가 바뀌면 새 대화를 여세요. 대화 길이가 소모 요인이라고 문서가 직접 적어뒀습니다.

5. API를 쓴다면 자기 상한을 등급 한도보다 낮게 잡으세요. 등급 상한만 믿고 있으면 사고가 났을 때 그 금액까지 갑니다.

🚫 이 글이 확인하지 못한 것

플랜별 구체적인 한도 숫자는 여기 없습니다. 문서가 "5시간 세션"과 "주간 한도"의 존재는 명시하는데 몇 메시지인지는 밝히지 않습니다. 그 문제는 한도에 숫자가 없다는 것에서 따로 다뤘습니다.

그리고 이건 한 회사 문서입니다. 다른 AI 서비스의 사용량 화면이 같은 방식일 거라고 가정하지 마세요. 다만 "표시된 숫자가 총량이 맞는지 한 번 의심하기"는 어디서나 유효합니다.

자주 묻는 것

Q. 한도에 걸리면 돈이 더 나가나요?

구독과 API가 다릅니다. 구독의 한도는 더 못 쓰게 막는 것이고, API의 지출 상한은 그 금액까지 쓰고 멈추는 것입니다. 후자는 상한을 안 걸어두면 등급 상한까지 갑니다.

Q. 출력을 길게 설정하면 한도를 더 먹나요?

API 기준으로는 아닙니다. 문서가 "최대 출력 길이 설정값은 속도 제한 계산에 들어가지 않는다"고 명시합니다 — 실제로 생성된 만큼만 셉니다. 다만 요금은 생성된 토큰에 붙으니 비용과 속도 제한은 별개로 보세요.

Q. 갑자기 많이 쓰면 문제가 되나요?

문서에 가속 제한이라는 게 따로 언급돼 있습니다. 사용량이 급격히 늘면 한도 안이어도 429가 날 수 있고, "트래픽을 점진적으로 올리라"고 안내합니다.

📌 보탬 (8월 13일) — 캐시가 실제로 걸렸는지는 따로 봐야 합니다

이 글에서 캐시 읽기가 한도에서 빠진다고 적었는데, 캐시가 걸렸다는 전제가 필요합니다. 그런데 최소 길이에 못 미치면 캐시는 조용히 실패하고 에러도 안 납니다. 최소 토큰은 모델마다 512에서 4,096까지 차이가 나서, 모델을 바꾸면 잘 되던 캐시가 안 걸리기도 합니다. 그리고 쓰기는 1.25~2배라 재사용이 적으면 오히려 손해입니다 → 프롬프트 캐싱은 조용히 실패합니다

📌 보탬 (8월 14일) — 토큰 수 자체가 달라지기도 합니다

이 글은 화면에 찍힌 토큰 수가 총량이 아니다라고 했습니다. 한 겹이 더 있었습니다 — 어떤 모델은 토큰을 세는 방식이 바뀌어 같은 텍스트가 약 30퍼센트 더 많은 토큰으로 계산됩니다. 단가가 그대로여도 청구가 늘어납니다. 모델을 바꾼 뒤 같은 작업의 입력 토큰 수를 비교해보시면 확인됩니다 → 단가가 같아도 청구는 다릅니다

📌 보탬 (8월 14일) — 사용량이 시작되는 지점은 0이 아닙니다

이 글은 화면의 숫자를 읽는 법이었는데, 그 숫자가 어디서부터 시작하는지를 따로 뜯어봤습니다. 공식 문서의 예시 세션 기준 사용자가 첫 글자를 치기 전에 이미 8,520 토큰이 실려 있고, 그중 92퍼센트는 터미널에 표시조차 안 됩니다. 무엇이 자리를 차지하는지는 /context 한 줄로 확인됩니다 → 컨텍스트의 92퍼센트는 화면에 안 보입니다

✨ 정리하면

구독은 5시간 세션 + 주간 두 개, API는 월 지출 상한 + 분당 처리량 두 개. 네 개가 서로 다른 걸 막습니다.

빨리 닳는 원인은 질문 횟수가 아니라 대화가 길어지는 것이고, 반복 자료는 프로젝트에 올리면 재사용분이 빠집니다.

그리고 화면의 입력 토큰 수를 총량으로 읽지 마세요. 20만을 보내고 50으로 보일 수 있습니다.

🧭 AI 지출 전체 그림

이 글은 결제 후 첫 달만 다뤘습니다. 개인·개발자·회사로 나눠 어디서 돈이 새는지 묶어둔 허브가 있습니다 → AI에 쓰는 돈 총정리 — 숨은 비용 7가지

🔗 같이 보면 좋은 글

• 첫 결제 전에 확인할 것 — 이 글의 앞 이야기
• 사용량에 지출 상한 거는 법 — 상한은 곧 멈추는 날짜
• 한도에 숫자가 없습니다 — 몇 번인지 안 알려주는 이유
• 관리자 화면이 보여주는 3개월 — 회사 단위로 본다면

---

확인 시점 — 2026년 8월 13일 밤. ✅ 1차 확인 : Claude 공식 도움말의 사용량 한도 모범사례 문서(설정 화면 항목·소모 요인·절약 권고·프로젝트 캐시) 및 Claude 플랫폼 문서의 속도 제한 페이지(지출 상한 표·토큰 버킷 방식·캐시 인식 ITPM·총 입력 토큰 계산식·429와 retry-after·가속 제한·최대 출력 설정값 제외·Haiku 3.5 예외 표기) 원문 직접 열람. 인용문은 모두 원문 그대로입니다. 확인하지 못한 것 : 플랜별 구체적 한도 수치(문서에 미공개) · 주간 한도의 실제 초기화 시각(계정별 상이) · 다른 AI 서비스의 사용량 표시 방식 · 한국 원화 청구 시 환산 방식. 금액과 등급 한도는 예고 없이 바뀝니다. 본인 계정의 설정 화면과 콘솔 수치를 우선하세요. 제휴·협찬 없습니다.