Claude Code 비용은 얼마? 토큰 요금 완벽 정리

결론부터

• ✦Claude Code 과금은 두 가지: Claude Pro나 Max 구독에 포함(월 정액)되거나, Anthropic API를 통해 토큰당 종량 과금.
• ✦토큰당 단가는 모델(Opus > Sonnet > Haiku)과 토큰 종류에 따라 달라집니다——출력이 가장 비싸고, 캐시 읽기가 가장 싸며 입력의 약 10분의 1입니다.
• ✦원시 토큰 수가 어마어마해 보이는 건 코딩 세션이 방대한 캐시 컨텍스트를 반복 재사용하기 때문——다만 그 캐시 읽기는 입력 단가의 약 10%로 과금되므로 실제 비용은 숫자가 암시하는 것보다 훨씬 작습니다.
• ✦당신이 얼마를 썼는지 아는 유일한 방법은 당신 자신의 사용량을 보는 것. Token Forest 대시보드는 당신의 로그에서 로컬로, 완전히 오프라인으로 추정합니다.

Claude Code의 두 가지 과금 방식

'Claude Code가 비싼가'에 답하기 전에, 당신이 어느 계량기에 올라타 있는지부터 알아야 합니다. 계량기는 두 개이고, 작동 방식이 완전히 다릅니다.

1. Claude Pro 또는 Max 구독(월 정액)

Claude Pro와 Max 등급은 Claude Code를 웹·데스크톱·모바일 Claude와 하나로 묶어 제공합니다. 정해진 월 요금을 내면 Claude Code 사용량은 채팅과 같은 공유 한도에서 차감됩니다——토큰당 청구서는 없습니다. 사용량은 금액이 아니라 롤링 한도(짧은 롤링 시간 창에 주간 상한이 더해짐)로 제한되므로 비용은 예측 가능하지만, 많이 쓴 날엔 창이 초기화될 때까지 벽에 부딪힐 수 있습니다. 2026-07-11 기준 Pro는 월 약 20달러, Max는 월 약 100달러(Pro의 약 5배 용량)와 200달러(약 20배)입니다. 현재 한도는 Anthropic 요금제 페이지에서 확인하세요.

2. Anthropic API를 통한 종량 과금

대신 API 키로 Claude Code에 인증하면, 모든 토큰이 표준 API 단가로 과금되고 상한이 없습니다——하루 종일 무겁게 돌려도 시간 창에 막히지 않지만, 청구서는 사용량에 그대로 비례해 늘어납니다. 함정 하나: 환경에 ANTHROPIC_API_KEY가 설정돼 있으면 Claude Code는 구독이 아니라 그 키를 사용하므로, 바로 옆에 Pro/Max가 있는데도 모르는 사이에 API 요금이 쌓일 수 있습니다.

요령: 사용량이 꾸준하고 적당하면 대개 구독이 더 싸고 예산도 잡기 쉽습니다. 들쭉날쭉하거나 매우 무거우면 API 과금이 시간 창을 없애 주지만 계량기는 멈추지 않습니다. 어느 쪽이든, 과다 지불 여부를 알려주는 건 원시 총량이 아니라 실제 토큰 구성입니다.

네 가지 토큰——그리고 왜 원시 숫자는 무섭게 보이는가

Claude 요청은 매번 토큰을 네 종류로 나누며, 가격이 서로 다릅니다. 이 구성을 이해하는 것이 자기 비용을 읽는 가장 큰 열쇠입니다.

• ✦입력(Input)——당신이 보내는 토큰: 프롬프트, 파일, 대화 기록. 모델의 기본 입력 단가로 과금.
• ✦출력(Output)——Claude가 생성해 돌려주는 토큰. 가장 비싼 종류로, 보통 입력의 약 5배.
• ✦캐시 쓰기(Cache write)——큰 컨텍스트(시스템 프롬프트, 큰 파일)를 재사용하려고 처음 저장할 때. 입력보다 약간 비쌈: 단기 캐시 약 1.25배, 장기 약 2배.
• ✦캐시 읽기(Cache read)——이후 요청에서 이미 캐시된 컨텍스트를 재사용할 때. 압도적으로 가장 싼 종류로 약 0.1배——입력의 10분의 1.

Claude Code 같은 코딩 agent는 캐시에 크게 의존합니다: 같은 프로젝트 파일과 지시가 턴마다 다시 전송되므로, 원시 토큰 수의 큰 몫이 캐시 읽기입니다. 그래서 대표 숫자가 어마어마해 보입니다. 하지만 캐시 읽기는 입력의 약 10분의 1이라, 돈으로 환산하면 숫자가 암시하는 것보다 훨씬 적습니다.

직관에 어긋나는 지점: Token Forest 자체의 6주 샘플에서 캐시 읽기가 실제 비용의 약 57%를 차지했고, 입력과 출력을 합쳐도 약 24%에 그쳤습니다——나머지는 캐시 쓰기입니다. 캐시 읽기는 단가는 싸지만 양이 너무 많아 결국 쌓입니다. 원시 토큰 총량은 비용을 부풀려 보이게 합니다. 중요한 건 금액으로 가중한 구성입니다.

모델 선택이 비용을 좌우하는 방식

토큰 구성 다음으로 큰 지렛대는 어떤 모델을 돌리느냐입니다. Claude 등급은 성능과 가격을 맞바꿉니다: Opus는 가장 강력하고 가장 비싸며, Sonnet은 중간, Haiku는 가장 싸고 빠릅니다. 모든 모델에서 출력 토큰은 입력의 약 5배이고, 캐시 읽기는 항상 입력의 약 10분의 1입니다. 아래 단가는 100만 토큰(MTok)당이며 2026-07-11에 Anthropic 요금 페이지에서 확인한 것입니다——가격은 바뀌므로 특정 시점의 스냅샷으로 보고 최신 숫자는 출처에서 확인하세요.

실전 결론: 뭐든 Opus로 돌리면 토큰당 비용이 Haiku의 약 5배입니다. 많은 워크플로가 일상적인 편집엔 더 싼 모델을 쓰고, 어려운 추론에만 최상위 등급을 남겨 둡니다. 그게 값어치가 있는지는 전적으로 당신의 작업에 달렸고——이 또한 결국 당신 자신의 숫자로만 판단할 수 있습니다.

그래서, Claude Code는 비쌀까?

솔직히: 상황에 따라 다르며, 원시 토큰 카운터는 최악의 판단 근거입니다. Pro나 Max 구독이라면 Claude Code 비용은 토큰이 아무리 흘러가도 그 정액 월 요금 그대로입니다. API 과금이라면 비용은 실제 토큰 구성을 따라가며——캐시 읽기가 10분의 1 가격으로 대부분을 차지하기 때문에, 대다수 사람의 실제 지출은 그 무시무시한 원시 총량이 암시하는 것보다 훨씬 낮습니다. 유일하게 정직한 답은 당신 자신의 로그에서 나온 당신의 답입니다.

실제 비용을 보는 법——로컬, 오프라인

Token Forest는 Claude Code(및 OpenAI Codex)가 이미 당신 컴퓨터에 기록해 둔 사용 로그를 읽어, 쉬운 말의 비용 추정치로 바꿉니다. 토큰 수, 모델 이름, 타임스탬프만 사용하며——소스 코드, 프롬프트, 대화 내용은 절대 읽지 않습니다——네트워크를 완전히 꺼도 작동합니다. 아무것도 업로드되지 않습니다.

1. 1Windows 또는 macOS용 Token Forest(무료 퍼블릭 베타)를 설치하고 로컬 Claude Code와 Codex 로그를 읽게 하세요.
2. 2'사용량(Usage)' 뷰를 열어 일·주·월 차트, 모델별 분해, 번 레이트 수치, 프로젝트별 분해를 확인하세요.
3. 3'대화(Chats)' 뷰를 열면 대화 하나당 한 줄——그 네 가지 토큰과 추정 비용——이 나와, 어떤 세션이 실제로 돈을 썼는지 짚어낼 수 있습니다.
4. 4'성장(Growth)' 뷰에서는 지출을 자라나는 픽셀 나무로 지켜보며, 단계마다 '이 나무 ≈ $X' 표시가 붙습니다.

대시보드의 비용 수치는 내장 가격표에 기반한 추정치입니다——로컬에서 계산되며 Anthropic이나 OpenAI의 실제 청구서와 다를 수 있습니다. '내 토큰이 어디로 가는가'를 빠르고 사적으로 파악하는 수단으로 쓰고, 정확한 금액은 공식 청구서와 대조하세요.

터미널파인가요? ccusage는 ryoppippi가 만든 독립 오픈소스 CLI로, 같은 Claude Code 로그를 읽어 비용 리포트를 텍스트로 출력합니다. Token Forest는 그 프런트엔드가 아니라 시각적 대안입니다——같은 발상, 다른 표현. 당신 워크플로에 맞는 쪽을 쓰세요.