클로드 코드 요금제, 뭘 써야 본전인가 — 내 한 달 사용량을 API 요금으로 환산해봤다

클로드 코드 요금제를 고를 때 제일 많이 나오는 질문이 “API로 쓰면 얼마 나오느냐”입니다. 요금표만 봐서는 답이 안 나옵니다. 토큰을 얼마나 쓰는지 모르기 때문입니다.

그래서 제 컴퓨터에 남은 클로드 코드 로그를 전부 모아 실제로 쓴 토큰을 API 정가로 환산해봤습니다. 이 블로그 글쓰기·테마 수정·배포를 거의 전부 클로드 코드로 하는, 꽤 무거운 사용자의 한 달입니다. 끝에 직접 재볼 수 있는 스크립트도 붙였습니다.

클로드 코드 요금제는 지금 몇 개고 얼마인가

2026년 9월 28일 claude.com/pricing과 지원 문서 기준입니다. 클로드 코드는 무료 플랜을 뺀 유료 플랜에 모두 들어 있습니다.

요금제 선택에서 가장 중요한 예외가 하나 있습니다. Fable 5.1(과 Fable 5)은 Pro 플랜 한도에 들어가지 않습니다. Pro에서 Fable을 쓰면 처음부터 추가 사용량, 즉 API 정가로 과금됩니다. Max는 주간 한도의 50%까지 Fable을 추가 비용 없이 쓸 수 있고, Fable은 다른 모델보다 한도를 빨리 씁니다. 나머지 모델(Opus 5.5·Sonnet 5 등)은 Pro에서도 한도 안에서 씁니다.

구독 한도는 두 겹입니다. 5시간마다 리셋되는 세션 한도와 계정마다 정해진 요일·시각에 리셋되는 주간 한도입니다. 한도는 클로드 앱(웹·데스크톱·모바일)과 클로드 코드가 같이 씁니다. 한도를 넘기면 추가 사용량(usage credits)을 살 수 있는데, 이건 API 정가로 과금됩니다.

API 가격은 모델마다 다릅니다(100만 토큰당, 2026-09-28 공식 가격표).

Sonnet 5의 2달러/10달러는 원래 8월 31일까지의 도입가였는데, 9월 1일로 예정됐던 인상이 취소돼 정가가 됐습니다. Sonnet 5를 포함한 4.6 이후 모델은 100만 토큰 컨텍스트 전체가 할증 없이 같은 단가입니다.

한 달 로그를 API 요금으로 바꾸면 얼마인가?

클로드 코드는 대화마다 ~/.claude/projects/ 아래에 JSONL 로그를 남깁니다. 응답 한 건마다 usage 필드에 입력·출력·캐시 토큰이 기록됩니다. 8월 29일부터 9월 27일까지 30일 치를 모았습니다.

하루로 나누면 사용한 날 기준 중앙값 147달러, 가장 많이 쓴 날(9월 1일)은 237달러, 가장 적게 쓴 날도 14달러였습니다.

이 기간 로그에서 “한도에 도달했다”는 오류 메시지는 한 번도 나오지 않았습니다. 하루를 자정부터 5시간 단위로 끊어 보면 한 구간에 가장 많이 쓴 게 126달러어치였습니다. 실제 5시간 창은 자정 기준으로 나뉘지 않기 때문에 이 구간 계산은 근사치입니다.

왜 이렇게 많이 나왔나 — 비용의 80%는 캐시였다

처음엔 출력(클로드가 쓴 코드와 글)이 대부분일 줄 알았습니다. 아니었습니다.

이유는 에이전트의 작동 방식에 있습니다. 클로드 코드는 파일을 읽고, 명령을 실행하고, 결과를 다시 보는 걸 한 세션에 수십~수백 번 반복합니다. 매 턴마다 지금까지의 대화 전체를 다시 모델에 넣습니다. 캐시 덕분에 싸게 읽긴 하지만(Fable 5.1 기준 정가의 40분의 1), 대화가 길어질수록 그 “다시 읽기”가 쌓입니다. 제 로그의 캐시 읽기는 30일에 32억 토큰이었습니다.

캐시 쓰기가 44%나 되는 건 클로드 코드가 대부분 1시간짜리 캐시를 쓰기 때문입니다. 1시간 캐시는 쓰기 단가가 입력의 2배라, 새 파일을 읽거나 긴 도구 결과를 받을 때마다 비싸게 적립됩니다.

여기서 두 가지를 알 수 있습니다.

1. 코딩 에이전트는 API 종량제와 궁합이 나쁩니다. 같은 일을 채팅으로 하면 출력만 내면 되지만, 에이전트는 맥락을 계속 다시 읽습니다. 구독이 이 부분을 정액으로 흡수해줍니다.
2. 대화를 짧게 끊으면 한도도 덜 닳습니다. 작업 단위가 끝나면 /clear로 새로 시작하는 습관이 캐시 읽기를 줄입니다. 공식 문서도 대화 길이와 모델이 한도 소모에 영향을 준다고 설명합니다. CLAUDE.md와 도구 설명을 가볍게 유지하는 방법은 컨텍스트 점검 글에 정리해뒀습니다.

더 싼 모델로 썼다면 API가 나았을까?

제 사용량의 78%(2,221달러)는 가장 비싼 Fable 5.1이었습니다. 같은 토큰을 전부 더 싼 모델로 돌렸다고 가정하고 다시 계산했습니다(모델마다 토크나이저 차이는 무시한 단순 환산).

가장 싼 Haiku 4.5로만 써도 520달러, 구독료의 2.6배입니다. 매일 몇 시간씩 에이전트를 돌리는 사용 패턴이면 모델을 바꿔도 API가 구독을 못 이깁니다.

그럼 나는 어떤 요금제를 써야 하나?

기준은 “하루 API 환산액” 하나로 충분합니다. 구독료를 30일로 나누면 이렇습니다.

제 가장 가벼운 날(14달러)도 Max 20x 하루 환산의 2배였습니다. 시간 단위로 쪼개 보면, 사용한 157시간의 한 시간 중앙값이 실제 모델 기준 15.6달러, 전부 Sonnet 5로 쳐도 4.8달러였습니다. 하루 30분(약 2.4달러)만 써도 Pro 하루 환산의 3배가 넘습니다. 클로드 코드를 매일 쓴다면 API보다 구독이 거의 확실히 쌉니다. 남는 질문은 “어느 등급이냐”인데, 이건 한도로 정합니다.

구독 한도는 달러나 토큰으로 공개돼 있지 않습니다. 공식적으로 나온 건 배수(5배, 20배)뿐입니다. 제 경우 Max 20x에서 5시간 구간에 126달러어치를 써도 한도에 안 걸렸으니, 단순 비례로 Pro는 5시간에 적어도 6달러어치 이상이라는 것까지만 짐작할 수 있습니다. 주간 한도가 따로 있고 Fable은 한도를 더 빨리 쓰기 때문에 이 계산이 그대로 맞지는 않습니다.

그래서 실전 순서는 이렇게 권합니다.

1. Pro로 시작합니다. 월 20달러로 클로드 코드가 되는지부터 확인합니다. 단, Fable 5.1을 주력으로 쓸 거라면 Pro는 건너뛰고 Max부터 시작합니다.
2. 일주일 동안 한도에 걸린 횟수를 셉니다. 한두 번이면 Pro로 충분하고, 거의 매일이면 Max 5x로 올립니다.
3. Max 5x에서도 매일 걸리면 Max 20x입니다. 월 100달러 차이가 아까우면, 걸렸을 때 추가 사용량(API 정가)을 사는 것과 비교합니다. Max 5x 한도를 넘는 부분만 사도 한 달에 100달러를 넘는다면 20x가 쌉니다. 한 달 API 환산이 2,837달러인 제 사용량이면 거의 확실히 넘습니다.

내 사용량을 직접 재보는 법

아래 스크립트는 제가 이 글에 쓴 계산을 그대로 줄인 것입니다. 파이썬 3만 있으면 되고, 로그를 읽기만 하고 아무것도 보내지 않습니다. 최근 30일 로그를 API 정가로 환산해 모델별 합계를 보여줍니다.

import json, glob, os, datetime as dt
# 100만 토큰당 (입력, 출력, 캐시 읽기) — 2026-09-28 공식 가격
P = {"claude-fable-5-1": (10, 50, .25), "claude-fable-5": (10, 50, 1.0),
     "claude-opus-5-5": (4, 20, .20), "claude-opus-5": (5, 25, .50),
     "claude-opus-4-8": (5, 25, .50), "claude-sonnet-5": (2, 10, .20),
     "claude-sonnet-4-6": (3, 15, .30), "claude-haiku-4-5-20251001": (1, 5, .10)}
since = dt.datetime.now(dt.timezone.utc) - dt.timedelta(days=30)
seen, total, skipped = set(), {}, set()
for f in glob.glob(os.path.expanduser("~/.claude/projects/**/*.jsonl"), recursive=True):
    for line in open(f, errors="ignore"):
        if '"usage"' not in line:
            continue
        try:
            d = json.loads(line)
        except ValueError:
            continue
        m = d.get("message") or {}
        u, model, ts = m.get("usage"), m.get("model"), d.get("timestamp")
        if not u or not ts or not model or model.startswith("<"):
            continue
        if model not in P:
            skipped.add(model)
            continue
        if dt.datetime.fromisoformat(ts.replace("Z", "+00:00")) < since:
            continue
        key = (m.get("id"), d.get("requestId"))
        if key in seen:
            continue
        seen.add(key)
        pin, pout, pread = P[model]
        cc = u.get("cache_creation") or {}
        w5 = cc.get("ephemeral_5m_input_tokens", 0)
        w1 = cc.get("ephemeral_1h_input_tokens", 0)
        cost = (u.get("input_tokens", 0) * pin + u.get("output_tokens", 0) * pout
                + w5 * pin * 1.25 + w1 * pin * 2
                + u.get("cache_read_input_tokens", 0) * pread) / 1e6
        total[model] = total.get(model, 0) + cost
for k, v in sorted(total.items(), key=lambda x: -x[1]):
    print(f"{k:28} ${v:,.0f}")
print(f"{'합계':28} ${sum(total.values()):,.0f}")
if skipped:
    print("가격표에 없어 뺀 모델:", ", ".join(sorted(skipped)))

주의할 점이 세 가지 있습니다.

• 같은 응답이 로그에 여러 줄로 남기 때문에 메시지 ID로 중복을 빼야 합니다. 안 빼면 2~3배로 부풀려집니다.
• 가격표(P)에 없는 모델은 합계에서 빠지고 마지막 줄에 이름이 나옵니다. 쓰는 모델이 있다면 P에 단가를 추가하세요.
• 내 컴퓨터에서 쓴 것만 잡힙니다. 웹의 클로드 코드나 다른 PC 사용분, 클로드 앱 채팅은 빠집니다.
• 나오는 금액은 “API였다면 냈을 돈”이지 실제 청구액이 아닙니다. 구독 중이라면 추가로 나가는 돈은 없습니다.

이 값을 30으로 나눠 위 표의 하루 환산액과 비교하면 됩니다.

자주 헷갈리는 것들

검증 기록: 2026-09-28 실측. 사용량은 이 블로그 운영에 쓰는 맥 한 대의 ~/.claude/projects JSONL(서브에이전트 포함)에서 2026-08-29 00:00~09-27 24:00(KST) 30일 구간의 assistant 응답 usage 를 (message.id, requestId) 로 중복 제거해 합산했다. 캐시 쓰기는 cache_creation 의 5분·1시간 구분을 따라 입력 단가의 1.25배·2배로 계산했다. 단가는 2026-09-28 공식 API 가격표(Fable 5.1 캐시 읽기 $0.25, Opus 5.5 $0.20 포함). 요금제 가격·배수와 Fable 의 플랜별 취급(Pro 는 추가 사용량, Max 는 주간 한도 50%)은 같은 날 claude.com/pricing 과 지원 문서 원문에서 확인했고 가격표 캡처도 같은 날이다. 계정은 Max 20x(설정 파일의 rate limit tier 로 확인). “한도 도달 0건”은 같은 기간 로그에서 한도 초과 오류 메시지를 검색한 결과다. 5시간 구간은 자정 기준 고정 구간으로 나눈 근사치이며, 실제 세션 창과 다를 수 있다. 저가 모델 가정 환산은 토크나이저 차이를 무시한 단순 계산이다. 시간 단위 중앙값은 KST 시(hour) 단위로 묶은 157개 구간 기준이다.