Claude Pro를 구독하면 API를 쓸 수 있나요?

아니요. 구독은 claude.ai와 Claude Code를 위한 것이고, API는 Claude Console에서 API 키를 발급받아 사용량만큼 별도로 결제합니다. 두 요금 체계는 서로 무관합니다. 다만 Claude Code에서 구독 한도를 넘겼을 때 '사용 크레딧'을 켜면 초과분이 표준 API 요금으로 청구되는 옵션은 있습니다.

API에 무료로 써볼 수 있는 크레딧이 있나요?

공식 FAQ 기준으로 신규 사용자에게 API를 테스트할 수 있는 소량의 무료 크레딧이 제공됩니다. 다만 금액은 공식 문서에 명시돼 있지 않으니 Console에서 직접 확인해야 합니다.

토큰이 몇 개인지 미리 알 수 있나요?

네. 토큰 계산 엔드포인트(/v1/messages/count_tokens)로 요청을 보내기 전에 정확한 입력 토큰 수를 확인할 수 있습니다. tiktoken 같은 다른 회사 토크나이저는 Claude 토큰을 부정확하게 세니 쓰지 마세요.

요금이 예상보다 많이 나올까 걱정됩니다.

티어마다 월 지출 상한이 걸려 있고(Start $500, Build $1,000), 그보다 낮은 값으로 직접 상한을 설정할 수도 있습니다. Console의 설정 > Limits에서 조정합니다.

클로드 API 요금 정리: 모델별 가격·비용 줄이는 3가지 방법 (2026)

“클로드 API”로 검색하는 사람이 가장 먼저 부딪히는 건 요금 계산이 아니라 이 질문이다 — Pro 구독하고 있는데 왜 API 키가 없지? 결론부터 말하면 둘은 별개 결제다. 그 구조부터 정리하고, 실제로 작업 하나에 얼마가 드는지 계산해봤다.

아래 가격·한도는 platform.claude.com 가격 문서와 Rate limits 문서를 2026-07-28에 확인한 값이다. 가격은 예고 없이 바뀔 수 있으니 결제 직전 공식 페이지에서 재확인하자.

함정 먼저: 구독과 API는 다른 지갑

	Pro·Max 구독	API
쓰는 곳	claude.ai, Claude Code, Desktop	내 코드·서비스
결제 방식	월 정액	쓴 토큰만큼 후불
가입 위치	claude.ai	`platform.claude.com`
한도	세션·주간 사용량 한도	분당 토큰·요청 수 + 월 지출 상한

구독을 아무리 상위 플랜으로 올려도 API 키가 생기지 않는다. 반대로 API를 쓴다고 claude.ai 한도가 늘지도 않는다. 구독 쪽 한도 구조는 Pro와 Max 요금제를 정리한 글에서 따로 다뤘다.

접점이 하나 있긴 하다. Claude Code에서 구독 한도를 넘겼을 때 “사용 크레딧”을 켜면 초과분이 표준 API 요금으로 청구된다. 이때만 두 체계가 만난다.

시작하는 법

platform.claude.com에서 Console 계정 생성
설정 > API Keys에서 키 발급
환경변수로 내보내기 — 코드에 직접 넣지 말자

export ANTHROPIC_API_KEY="발급받은-키"

호출은 이게 최소 형태다:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 1000,
    "messages": [{"role": "user", "content": "안녕"}]
  }'

anthropic-version 헤더가 필수라는 점을 놓치기 쉽다. 파이썬은 SDK가 환경변수를 자동으로 읽어서 더 짧다:

import anthropic

client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1000,
    messages=[{"role": "user", "content": "안녕"}],
)

모델별 요금

100만 토큰(MTok) 기준이고, 입력과 출력에 각각 부과된다.

모델	입력	출력	컨텍스트
Claude Fable 5	$10	$50	1M
Claude Opus 5	$5	$25	1M
Claude Sonnet 5	$2 (도입가)	$10 (도입가)	1M
Claude Haiku 4.5	$1	$5	200K

출력이 입력의 5배라는 구조를 기억해두면 유용하다. 긴 문서를 넣고 짧게 요약받는 작업은 생각보다 싸고, 짧게 물어서 길게 받아내는 작업은 생각보다 비싸다.

⚠️ Sonnet 5 도입가는 8월 31일까지

이건 시점상 중요하다. Sonnet 5의 $2/$10은 2026년 8월 31일까지 적용되는 도입가이고, 9월 1일부터 정가 $3/$15로 오른다. 입력·출력 모두 1.5배다.

	8월 31일까지	9월 1일부터
입력	$2 / MTok	$3 / MTok
출력	$10 / MTok	$15 / MTok

Sonnet 5 기준으로 비용을 계산해 사업성을 판단하고 있다면, 9월 이후 단가로 다시 계산해봐야 한다.

실제로 얼마 드나

블로그 글 한 편(약 5,000 토큰)을 넣어서 요약(약 1,000 토큰)을 받는 작업으로 계산해봤다.

모델	입력 비용	출력 비용	합계
Opus 5	5,000 × $5 ÷ 1M = $0.025	1,000 × $25 ÷ 1M = $0.025	$0.05
Sonnet 5 (도입가)	$0.01	$0.01	$0.02
Haiku 4.5	$0.005	$0.005	$0.01

1건에 Opus 5로 $0.05, Haiku로 $0.01이다. 1,000건이면 각각 $50과 $10. 여기서 모델 선택이 5배 차이를 만든다는 게 보인다.

공식 문서가 제시하는 대규모 예시도 참고할 만하다 — 고객 지원 티켓 1만 건(건당 평균 약 3,700 토큰)을 Haiku 4.5로 처리하면 약 $37이다.

계산기를 만들어서 쓰자

매번 손으로 계산하는 건 실수하기 쉽다. 특히 캐싱이 끼면 첫 호출(쓰기)과 이후 호출(읽기) 단가가 달라서 암산이 안 된다. 스크립트로 만들어두면 편하다.

// scripts/claude-cost.mjs — Claude API 비용 계산기 (API 키 불필요, 순수 계산)
// 단가 확인일: 2026-07-28

const PRICING = {
  // [기본 입력 $/MTok, 출력 $/MTok]
  models: {
    "fable-5": [10, 50],
    "opus-5": [5, 25],
    "sonnet-5": [2, 10],   // 도입가. 2026-09-01부터 [3, 15]
    "haiku-4-5": [1, 5],
  },
  multipliers: {
    cacheWrite5m: 1.25,
    cacheWrite1h: 2,
    cacheRead: 0.1,
    batch: 0.5,
  },
};

// 한 번 호출의 비용. 캐시 토큰은 첫 호출에서 "쓰기", 이후 "읽기"로 과금된다.
function costPerCall({ model, input, output, cached, batch, isFirstCall }) {
  const [inRate, outRate] = PRICING.models[model];
  const m = PRICING.multipliers;
  const uncachedInput = Math.max(0, input - cached);

  const cacheRate = isFirstCall
    ? inRate * m.cacheWrite5m
    : inRate * m.cacheRead;

  let total =
    (uncachedInput * inRate + cached * cacheRate + output * outRate) / 1_000_000;

  if (batch) total *= m.batch;
  return total;
}

핵심은 isFirstCall 분기다. 캐시는 처음 한 번만 1.25배로 쓰고, 그 뒤로는 0.1배로 읽는다. 이걸 반영하지 않으면 캐싱 효과를 크게 과소평가하거나 과대평가하게 된다.

캐싱이 실제로 얼마나 줄이나

위 계산기로 돌려본 결과다. 긴 문서(20만 토큰)를 캐시해두고 50번 질의하는 시나리오(Opus 5, 출력 2,000 토큰):

	50건 총비용	1건당
캐싱 없음	$52.50	$1.05000
5분 캐싱	$10.84	$0.21685

79% 절감이다. 손으로 검산해보면 이렇게 나온다:

1번째 호출 (캐시 쓰기):
  (10,000 × $5) + (190,000 × $5 × 1.25) + (2,000 × $25)  ÷ 1M = $1.2875

2~50번째 호출 (캐시 읽기, 49회):
  (10,000 × $5) + (190,000 × $5 × 0.1)  + (2,000 × $25)  ÷ 1M = $0.1950
                                                          × 49 = $9.5550

합계 = $10.8425

첫 호출만 비싸고 나머지가 1/5로 떨어지는 구조라, 반복 횟수가 많을수록 이득이 커진다. 반대로 한 번만 쓸 프롬프트를 캐시하면 1.25배를 그냥 손해 본다.

원화 환산은 결제 시점 환율에 따라 달라진다. 대략적인 감을 잡으려면 위 달러 금액에 환율을 곱하면 되는데, 정확한 금액은 카드 청구 시점 기준이라 여기서는 달러로만 적었다.

비용 줄이는 3가지

1. 프롬프트 캐싱 — 반복되는 앞부분을 재사용

같은 시스템 프롬프트나 같은 문서를 여러 요청에 반복해서 넣는다면, 그 부분을 캐시해두고 읽기만 할 수 있다.

동작	기본 입력가 대비	유효 기간
5분 캐시 쓰기	1.25배	5분
1시간 캐시 쓰기	2배	1시간
캐시 읽기	0.1배	위 쓰기와 동일

손익분기가 명확하다. 5분 캐시는 읽기 1번만 발생해도 이득이고(쓰기 1.25배 + 읽기 0.1배 = 1.35배 < 안 캐시했을 때 2배), 1시간 캐시는 읽기 2번부터 이득이다.

주의할 점: 최소 캐시 길이가 모델별로 다르고, 미달하면 조용히 캐시되지 않는다. 에러도 나지 않는다.

모델	최소 캐시 길이
Claude Opus 5	512 토큰
Claude Sonnet 5	1,024 토큰
Claude Haiku 4.5	4,096 토큰

세대가 올라갈수록 줄어드는 게 아니라는 점이 함정이다 — Opus 5는 512인데 Haiku 4.5는 4,096이다. 3천 토큰짜리 프롬프트는 Opus 5에서는 캐시되고 Haiku 4.5에서는 안 된다.

2. 배치 API — 입출력 모두 50% 할인

급하지 않은 작업이라면 이게 가장 단순한 절감 수단이다. 입력과 출력 양쪽 모두 50% 할인이다.

모델	배치 입력	배치 출력
Opus 5	$2.50	$12.50
Sonnet 5 (도입가)	$1	$5
Haiku 4.5	$0.50	$2.50

대가는 응답 시간이다. 대부분 1시간 안에 끝나지만 최대 24시간까지 걸릴 수 있다. 결과는 29일간 보관된다.

캐싱과 배치 할인은 중첩된다. 둘 다 쓰면 절감폭이 곱해진다.

3. 모델 다운그레이드 — 가장 큰 지렛대

위 계산에서 봤듯 Haiku 4.5는 Opus 5의 1/5 가격이다. 분류·추출·요약 같은 단순 작업에 Opus를 쓰고 있다면 여기가 제일 큰 절감 여지다. 공식 권고도 같다 — 단순 작업엔 Haiku, 대부분의 프로덕션 작업엔 Sonnet, 가장 복잡한 추론에만 Opus.

캐싱의 숨은 이득: 한도에 잡히지 않는다

이건 요금표만 보면 안 보이는 부분이고, 처리량이 문제인 경우엔 절감보다 중요할 수 있다.

분당 입력 토큰 한도(ITPM)에 캐시 읽기 토큰은 포함되지 않는다.

토큰 종류	ITPM 한도에 포함?
`input_tokens` (캐시 안 된 입력)	✅ 포함
`cache_creation_input_tokens` (캐시 쓰기)	✅ 포함
`cache_read_input_tokens` (캐시 읽기)	❌ 미포함

공식 문서의 예시가 이해하기 쉽다 — ITPM 한도가 200만이고 캐시 히트율이 80%라면, 실질적으로 분당 1,000만 토큰을 처리할 수 있다(캐시 안 된 200만 + 캐시된 800만). 한도 증설을 요청하지 않고도 처리량을 늘리는 방법이다.

한 가지 예외: 은퇴한 Haiku 3.5는 캐시 읽기도 ITPM에 포함된다.

티어와 지출 상한

한도는 조직 단위로 걸리고, 사용 이력에 따라 자동으로 승급된다. 신규 조직은 표준 한도보다 낮게 시작할 수 있다(사기·남용 방지 목적이며 이력이 쌓이면 자동으로 올라간다).

티어	월 지출 상한	Opus 5 분당 요청	Opus 5 ITPM
Start	$500	1,000	200만
Build	$1,000	5,000	500만
Scale	$200,000	10,000	1,000만
Custom	없음	협의	협의

월 지출 상한에 도달하면 다음 달까지 API 사용이 멈춘다. 요금 폭탄이 걱정된다면 티어 상한보다 낮은 값으로 직접 상한을 설정할 수 있다(설정 > Limits).

429 에러가 나면 retry-after 헤더에 몇 초 기다려야 하는지 담겨 온다. 공식 SDK는 이걸 읽어서 자동 재시도한다.

놓치기 쉬운 추가 비용

토큰 값 말고도 붙는 게 있다.

항목	비용
웹 검색	1,000회당 $10 + 검색 결과 토큰
웹 페치	추가 비용 없음 (토큰만)
코드 실행	조직당 월 1,550시간 무료, 초과분 컨테이너당 시간당 $0.05
도구 사용	도구 정의가 입력 토큰에 포함됨

도구를 붙이면 도구 이름·설명·스키마가 전부 입력 토큰으로 계산된다는 점이 의외로 크다. MCP 서버를 여러 개 붙였을 때 사용량이 늘어나는 이유가 이것이다 — MCP 연결 글에서 안 쓰는 서버를 꺼두라고 쓴 근거다. 반대로 스킬은 호출 전까지 이름과 설명만 차지해서 훨씬 가볍다.

토큰 수 계산할 때 주의

두 가지를 알아둬야 한다.

첫째, 다른 회사 토크나이저를 쓰면 안 된다. tiktoken은 OpenAI 것이라 Claude 토큰을 부정확하게 센다. 토큰 계산 엔드포인트(/v1/messages/count_tokens)를 쓰면 요청을 보내기 전에 정확한 값을 확인할 수 있다.

import anthropic

client = anthropic.Anthropic()

with open("문서.md") as f:
    text = f.read()

resp = client.messages.count_tokens(
    model="claude-opus-5",
    messages=[{"role": "user", "content": text}],
)
print(f"{resp.input_tokens:,} 토큰 → 입력 비용 ${resp.input_tokens * 5 / 1_000_000:.4f}")

count_tokens 자체는 무료다. 큰 문서를 넣기 전에 이걸로 먼저 재보면 예상 밖의 청구를 피할 수 있다. 모델마다 결과가 다르니 실제로 쓸 모델 ID를 그대로 넣어야 한다.

둘째, Claude 4.7 이후 모델은 새 토크나이저를 쓴다. 같은 텍스트가 이전 세대보다 약 30% 더 많은 토큰으로 계산된다. 구형 모델에서 측정한 토큰 수를 그대로 가져와 비용을 추정하면 30% 적게 나온다.

정리

하려는 일	답
구독으로 API 쓰기	불가 — 별개 결제
가장 싸게 시작	Haiku 4.5 ($1/$5)
대부분의 실전 작업	Sonnet 5 — 단 8/31 이후 1.5배
반복 프롬프트 절감	프롬프트 캐싱 (읽기 0.1배)
급하지 않은 대량 처리	배치 API (50% 할인)
처리량 부족	캐싱 — 캐시 읽기는 ITPM 미포함
요금 폭탄 방지	설정 > Limits에서 지출 상한
토큰 수 확인	`count_tokens` (tiktoken 금지)

API 키를 발급받지 않고도 남에게 AI 도구를 배포하는 방법이 하나 있다 — 아티팩트를 쓰면 사용자가 자기 구독으로 요금을 부담한다. 그 구조는 클로드 아티팩트 정리에서 다뤘다.

그리고 요금을 계산할 때 자주 빠뜨리는 항목이 하나 있다 — 답변이 맞는지 검증하는 비용이다. 인용을 API가 보장해주는 Citations는 오히려 출력 토큰을 줄여주고, 로컬 대조는 아예 공짜다. 어디까지 공짜로 막을 수 있는지는 할루시네이션 검증 파이프라인에 실측과 함께 정리했다.

가격은 자주 바뀌는 영역이다. 이 글의 수치는 2026-07-28 확인 기준이고, 특히 Sonnet 5 도입가처럼 종료일이 정해진 항목은 결제 직전에 공식 가격 페이지를 다시 확인하는 게 맞다.