클로드 api 가격 — 모델별 토큰 단가와 비용 계산

클로드 API 가격은 입력 토큰 수 × 입력 단가 + 출력 토큰 수 × 출력 단가로 정해지는 종량제입니다. 2026년 10월 18일 공식 요금표 기준으로 100만 토큰당 Claude Opus 5.5가 입력 $4·출력 $20, Sonnet 5.5가 $2·$10, Haiku 5.5가 $0.10·$0.50(프롬프트 10만 토큰 이하)이고, 모든 현행 모델에서 출력 단가가 입력의 5배입니다. 같은 앞부분을 반복해서 보내면 프롬프트 캐싱으로 그 부분을 Opus·Sonnet 5.5 기준 입력 단가의 5%에 쓸 수 있고, 급하지 않은 작업은 Batch API로 전체가 절반입니다. 요청을 보내기 전에 토큰 수는 무료인 count_tokens API로 셀 수 있습니다.

1. 클로드 api 가격표 — 현행 모델 단가

공식 요금 문서의 표준 단가입니다(100만 토큰당 · 미국 달러 · 2026년 10월 18일 확인). 캐시 쓰기는 5분 캐시 기준입니다.

모델	입력	출력	캐시 쓰기 (5분)	캐시 읽기
Claude Fable 5.1	$10	$50	$12.50	$0.25
Claude Opus 5.5	$4	$20	$5	$0.20
Claude Sonnet 5.5	$2	$10	$2.50	$0.10
Claude Haiku 5.5 (프롬프트 10만 토큰 이하)	$0.10	$0.50	$0.125	$0.01
Claude Haiku 5.5 (프롬프트 10만 토큰 초과)	$0.50	$2.50	$0.625	$0.05
Claude Haiku 4.5	$1	$5	$1.25	$0.10

표에서 볼 것은 세 가지입니다.

• Haiku 5.5만 프롬프트 길이에 따라 가격이 바뀝니다. 한 요청의 입력이 10만 토큰을 넘으면 그 요청 전체가 비싼 줄로 청구되고, 이때 캐시에서 읽은 토큰도 길이에 포함됩니다. 반대로 Claude 4.6 이후의 다른 모델은 1M 컨텍스트 전체가 같은 단가입니다(문서 표현으로 90만 토큰 요청도 9천 토큰 요청과 토큰당 값이 같다).
• 캐시 읽기 할인 폭이 모델마다 다릅니다. 기본은 입력 단가의 0.1배지만 Opus 5.5·Sonnet 5.5는 0.05배, Fable 5.1은 0.025배입니다.
• 옛 모델 이름(Opus 4.x, Sonnet 4.x)도 표에 남아 있지만 현행 5.5 계열보다 비싼 경우가 많습니다. Sonnet 4.6은 입력 $3·출력 $15로 Sonnet 5.5보다 높습니다. 어떤 모델을 고를지는 클로드 오퍼스 5 비교 글에 성능과 같이 정리해 두었습니다.

2. 클로드 api 토큰 가격 — 무엇이 토큰으로 잡히나

청구서에 잡히는 토큰은 내가 입력창에 쓴 질문만이 아닙니다. 요금 문서와 SDK 타입 설명을 합치면 이렇습니다.

항목	어디에 청구되나
시스템 프롬프트·대화 기록·이미지·PDF	입력 토큰. 대화를 이어 갈수록 앞 대화가 매번 다시 입력으로 잡힘
확장 사고(thinking)	출력 토큰. usage.output_tokens_details.thinking_tokens가 과금된 출력 중 추론 분량
도구 정의(tools)와 tool_use·tool_result 블록	입력 토큰. 여기에 도구 사용용 시스템 프롬프트가 자동으로 붙음(5.5 계열은 tool_choice가 auto·none일 때 286토큰)
웹 검색 같은 서버 도구	토큰과 별도로 사용 횟수 과금. 웹 검색은 1,000회당 $10

도구를 붙이면 왜 입력 토큰이 늘어나는지, tool_result가 어떻게 오가는지는 claude tool use 글에서 요청 본문으로 확인할 수 있습니다.

⚠️ 모델을 바꾸면 같은 글도 토큰 수가 달라진다
공식 문서에 따르면 Claude 4.7 이후 모델(5.5 계열 포함)은 새 토크나이저를 써서 같은 글이 약 30% 더 많은 토큰으로 세어집니다. 정확한 차이는 내용에 따라 다릅니다. 그래서 문서는 옛 모델에서 재 둔 토큰 수로 새 모델 비용을 어림하지 말고, 쓸 모델 ID로 다시 세라고 안내합니다. 단가만 비교하면 싸 보여도 토큰이 늘어 실제 청구액이 기대만큼 안 줄 수 있습니다.

3. 클로드 api 토큰 계산 — count_tokens로 미리 세기

요청을 보내기 전에 토큰 수를 알고 싶으면 count_tokens API를 씁니다. Messages API와 같은 형식(시스템 프롬프트, 메시지, 도구, base64 이미지·PDF)을 받아 입력 토큰 수만 돌려줍니다. 파이썬 SDK로는 이렇습니다(anthropic 1.15.0 기준). API 키는 ANTHROPIC_API_KEY 환경 변수에서 읽습니다(발급은 claude api key 발급 글).

import anthropic

client = anthropic.Anthropic()

system = "너는 쇼핑몰 고객센터 상담원이다. 환불 규정에 따라 짧게 답한다."
question = "어제 받은 운동화가 사이즈가 안 맞아요. 교환되나요?"

for model in ["claude-sonnet-5-5", "claude-haiku-5-5"]:
    r = client.messages.count_tokens(
        model=model,
        system=system,
        messages=[{"role": "user", "content": question}],
    )
    print(model, r.input_tokens)

API 키 없이 SDK에 가짜 서버를 붙여 보면 이 호출은 POST /v1/messages/count_tokens로 나가고, 본문에는 model·system·messages가 그대로 들어가며, 응답은 input_tokens 하나를 가진 객체로 돌아옵니다. 공식 문서 기준으로 알아 둘 점은 이렇습니다.

• 무료입니다. 대신 분당 요청 수 한도가 있습니다(Start 5,000 · Build 10,000 · Scale 20,000 RPM). 메시지 생성 한도와는 따로 셉니다.
• 결과는 추정치라 실제 요청과 조금 다를 수 있습니다. 시스템이 최적화용으로 넣는 토큰이 섞일 수 있지만 그건 과금되지 않습니다.
• 프롬프트 캐싱은 반영하지 않습니다. 웹 검색 같은 서버 도구, MCP 커넥터, URL로 넘긴 이미지·문서는 세지 못하고 invalid_request_error가 납니다(이미지·PDF는 base64로 넘기면 셉니다).

한글이 토큰 몇 개로 잡히는지도 이 API로 직접 재는 게 정확합니다. 위 토크나이저 변경처럼 모델에 따라 값이 바뀌므로, 인터넷에 도는 "한글 몇 자 = 1토큰" 어림값보다 내 프롬프트를 내 모델로 세는 쪽을 믿으세요.

4. 요청 하나 비용 계산 — usage로 정확히

실제 청구 기준은 응답의 usage입니다. SDK 타입 설명에도 output_tokens가 과금에 쓰이는 확정값이라고 적혀 있습니다. 캐싱을 쓰면 입력이 세 칸으로 나뉘는데, 공식 문서의 합산식은 cache_read_input_tokens + cache_creation_input_tokens + input_tokens입니다. 이걸 단가표와 곱하면 요청 하나의 비용이 나옵니다.

# 100만 토큰당 달러 (2026-10-18 공식 요금표 · 표준 · 캐시 쓰기는 5분 기준)
PRICES = {
    "claude-opus-5-5":   {"in": 4.00, "out": 20.00, "write": 5.00,  "read": 0.20},
    "claude-sonnet-5-5": {"in": 2.00, "out": 10.00, "write": 2.50,  "read": 0.10},
    # Haiku 5.5 는 프롬프트 10만 토큰 이하일 때 값 (넘으면 5배)
    "claude-haiku-5-5":  {"in": 0.10, "out": 0.50,  "write": 0.125, "read": 0.01},
}

def cost_usd(model, usage):
    p = PRICES[model]
    return (
        usage.input_tokens * p["in"]
        + (usage.cache_creation_input_tokens or 0) * p["write"]
        + (usage.cache_read_input_tokens or 0) * p["read"]
        + usage.output_tokens * p["out"]
    ) / 1_000_000

resp = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=300,
    system=system,
    messages=[{"role": "user", "content": question}],
)
print("tokens:", resp.usage.input_tokens, resp.usage.output_tokens)
print(f"cost: ${cost_usd('claude-sonnet-5-5', resp.usage):.6f}")

가짜 서버가 입력 120토큰·출력 80토큰을 돌려주게 해서 돌린 출력입니다. 토큰 수는 가짜 값이고, 계산식이 맞는지만 보는 용도입니다.

tokens: 120 80
cost: $0.001040

입력 120 × $2 + 출력 80 × $10을 100만으로 나눈 값입니다. 출력이 입력보다 적은데도 비용의 77%가 출력에서 나왔습니다. 답변 길이를 줄이는 것만으로 비용이 크게 움직이는 이유입니다. 운영 중이라면 이 값을 요청마다 로그에 남겨 두면 어떤 기능이 돈을 쓰는지 바로 보입니다.

5. 클로드 api 비용 줄이기 — 캐싱·배치·모델

2만 토큰짜리 사내 문서를 앞에 붙이고 질문 100토큰·답변 200토큰을 1,000번 묻는 경우를 계산해 봤습니다. 캐싱은 첫 요청에서 5분 캐시에 한 번 쓰고 나머지 999번이 모두 캐시에 적중했다고 가정했습니다(5분 안에 다음 요청이 와야 유지됩니다).

모델	표준	프롬프트 캐싱	Batch API
Opus 5.5	$84.40	약 $8.50	$42.20
Sonnet 5.5	$42.20	약 $4.25	$21.10
Haiku 5.5	$2.11	약 $0.31	$1.06

• 프롬프트 캐싱: 앞부분이 길고 반복될수록 효과가 큽니다. 위 예에서 Sonnet 5.5 비용이 약 10분의 1이 됐습니다. 5분 캐시는 쓰기가 1.25배라 한 번만 다시 읽어도 이득이고, 1시간 캐시는 쓰기가 2배라 두 번 읽어야 이득입니다. 켜는 법은 프롬프트 캐싱 클로드 글에 있습니다.
• Batch API: 입력·출력 모두 50%입니다. 바로 답이 필요 없는 대량 작업에 맞고, 요금 문서상 캐싱 배수와 배치 할인은 겹쳐서 적용됩니다. 쓰는 법은 claude batch api 사용법 글에 정리해 두었습니다.
• 모델 고르기: 같은 일을 Haiku 5.5로 하면 Sonnet 5.5의 20분의 1입니다. 공식 요금 문서도 단순한 작업엔 Haiku, 대부분의 운영 작업엔 Sonnet, 가장 복잡한 추론엔 Opus를 고르라고 권합니다.

반대로 비용이 늘어나는 옵션도 있습니다. 미국 안에서만 추론하도록 지정(inference_geo)하면 Claude 4.6 이후 모델은 모든 토큰 단가가 1.1배가 되고, fast mode는 Opus 5.5 기준 입력 $8·출력 $40으로 표준의 2배이며 배치와 함께 쓸 수 없습니다.

자주 묻는 질문 (FAQ)

Q. 클로드 api 무료로 쓸 수 있나요?
공식 요금 문서 기준으로 새 사용자에게 테스트용 소액 무료 크레딧이 주어지고, 그 뒤로는 쓴 만큼 청구됩니다. 결제는 신용카드로 하고, 크레딧 구매와 결제 수단은 Claude Console의 Billing 페이지에서 관리합니다.

Q. ChatGPT API와 비교하면 어떤가요?
둘 다 토큰 종량제이고 출력이 입력보다 비싸다는 구조는 같지만, 단가와 토크나이저가 달라 같은 글도 토큰 수가 다르게 나옵니다. 그래서 단가표만 나란히 놓기보다 내 프롬프트를 각자 도구로 세어 비교해야 정확합니다. OpenAI 쪽 단가와 한글 토큰 세는 법은 chatgpt api 요금 글에 있습니다.

Q. 긴 문서를 넣으면 단가가 올라가나요?
Claude 4.6 이후 모델은 Haiku 5.5를 빼고 1M 컨텍스트 전체가 같은 단가입니다. Haiku 5.5만 한 요청의 프롬프트가 10만 토큰을 넘으면 입력·출력·캐시 단가가 모두 5배 줄로 바뀝니다. 요청 단위로 판단하므로, 큰 문서를 다룰 때는 요청을 나누거나 다른 모델과 비교해 보는 게 좋습니다.

마무리

정리하면 클로드 API 비용은 모델 단가 × 토큰 수이고, 토큰 수는 count_tokens로 미리 무료로 세고 usage로 정확히 확인합니다. 출력이 입력의 5배라 답변 길이가 비용을 좌우하고, 반복되는 앞부분은 캐싱, 급하지 않은 일은 배치로 줄입니다. 단가는 자주 바뀌니 예산을 잡기 전에 아래 공식 요금 문서에서 그날 값을 다시 확인하세요.

---

📚 참고 출처 (2026년 10월 18일 확인 · anthropic 파이썬 SDK 1.15.0)
· Pricing — Claude Docs
· Token counting — Claude Docs
· Prompt caching — Claude Docs
· Extended thinking — Claude Docs