“사이드 프로젝트 하나 굴렸을 뿐인데 한 달 API 청구서가 수십만 원” — Claude API 초심자 커뮤니티에서 정말 자주 보이는 이야기입니다. 그리고 대부분의 경우 원인은 같습니다. 모델을 작업 난이도와 무관하게 최상위로 고정하고, prompt caching을 안 켠 것.
공식 문서 기준으로 캐싱과 모델 라우팅만 제대로 적용해도 같은 트래픽에서 청구액이 수 배 단위로 줄어들 수 있습니다. 오늘은 Anthropic Claude API 사용법을 정리하면서, 모델 선택 기준, 공식 단가, 캐싱 적용법, 그리고 공식 문서에서 눈에 잘 안 띄는 함정까지 풀어보려 합니다.
모델 라인업과 실제 단가 비교 — 숫자가 다 말해줌
2026년 1월 기준 Anthropic 공식 가격표 기준입니다. Claude 4 시리즈는 Opus 4.7, Sonnet 4.6, Haiku 4.5 세 가지로 정리됐어요.
| 모델 | Input ($/1M tok) | Output ($/1M tok) | 캐시 읽기 할인 | 추천 용도 |
|---|---|---|---|---|
| Opus 4.7 | $15 | $75 | 90% off | 복잡 추론, 코드 리팩토링 |
| Sonnet 4.6 | $3 | $15 | 90% off | 90% 일반 작업의 정답 |
| Haiku 4.5 | $1 | $5 | 90% off | 분류, 요약, 대량 처리 |
“비싼 게 좋겠지” 하고 무조건 Opus만 쓰는 게 가장 흔한 실수입니다. 실무에서는 프로덕션 트래픽 대부분을 Sonnet급에서 처리하고, Opus는 라우터로 “어려운 질문”만 골라서 보내는 게 정석으로 통합니다.
여기서 의외의 포인트 하나. 최신 Haiku는 이전 세대 Sonnet에 근접한 성능을 낸다는 평가를 받습니다. 단가는 몇 분의 1인데요. 단순 분류·태깅 작업을 아직도 Opus로 돌리고 있다면 가장 먼저 손볼 지점입니다.
캐싱+라우팅으로 단가가 얼마나 깎이나 (계산 예시)
고객센터 챗봇 시나리오로 공식 단가 기준 계산을 해봅시다. 환불 정책, 결제 가이드, FAQ 30페이지 분량을 매 요청마다 system prompt에 통째로 박아 넣으면, 대화 한 번에 입력 토큰이 12,000씩 빠집니다. 월 수만 건 대화면 입력 비용만으로 청구서가 수천 달러까지 부풀 수 있는 구조예요.
여기서 두 가지만 바꾸면 됩니다. 첫째, 고정 FAQ 문서에 `cache_control: {“type”: “ephemeral”}`을 붙여 prompt cache 적용 — 캐시 읽기는 공식 문서 기준 정가 대비 대폭 할인(캐시 읽기 단가는 기본 입력의 10% 수준)됩니다. 둘째, 1차 분류는 Haiku, 복잡한 케이스만 Sonnet으로 라우팅.
반복 호출 비중이 높은 워크로드라면 이 두 가지 조합만으로 계산상 청구액이 절반 이하로 내려갑니다. 부수 효과도 있습니다. 캐시 히트가 쌓이면 first-token 응답 지연도 함께 줄어들어, 비용을 깎으면서 체감 품질이 오히려 올라가는 경우가 많습니다.
직접 호출 vs LangChain vs Bedrock — 뭐가 정답인가
이 질문 진짜 자주 받는데요. 정답은 “프로젝트 규모에 따라”입니다.
| 방식 | 진입 난이도 | 단가 | 락인 | 추천 대상 |
|---|---|---|---|---|
| Anthropic SDK 직접 | 낮음 | 표준가 | 없음 | 1인 개발, MVP, 사이드 |
| LangChain/LlamaIndex | 중간 | 표준가 + 오버헤드 | 프레임워크 종속 | 복잡한 RAG 파이프라인 |
| AWS Bedrock | 높음 (IAM 지옥) | 표준가 동일 | AWS | 엔터프라이즈, 컴플라이언스 |
사실은 9할의 경우 그냥 `pip install anthropic` 하고 SDK 직접 쓰는 게 답이에요. LangChain은 프로토타입엔 좋은데, 프로덕션에서 디버깅하려면 추상화 레이어 다 까봐야 해서 시간을 더 잡아먹습니다.
이런 분에게는 SDK 직접 추천: 월 API 비용 $500 미만, 팀 규모 5명 이하. Bedrock은 회사가 “AWS 외부 결제 안 됨” 정책일 때만 의미 있어요.
⚠️ 공식 문서에서 눈에 잘 안 띄는 함정 3가지
함정 1. Tier 1 계정의 분당 요청 한도. 신규 가입 계정은 RPM(분당 요청) 한도가 낮게 묶여 있어, 부하 테스트를 돌리면 429 에러가 폭주합니다. 누적 결제 실적에 따라 Tier가 올라가며 한도가 풀리는 구조이니, 배포 전에 콘솔에서 본인 Tier 한도부터 확인하세요.
함정 2. Streaming 켜놓고 토큰 수 안 세면 단가 추적 불가. `usage` 객체는 stream의 마지막 message_delta 이벤트에 담겨 옵니다. 이거 놓치면 월말에 청구서 보고 깜짝 놀라요.
함정 3. Prompt caching 최소 토큰 한도. Sonnet 기준 1,024 토큰 미만은 캐싱 안 됩니다. 짧은 시스템 프롬프트는 캐시 적용해도 효과 없으니 굳이 `cache_control` 안 박아도 돼요.
자주 묻는 질문
Q1. GPT-4o랑 비교하면 어느 쪽이 더 저렴한가요? 입력 단가는 Sonnet 4.6($3)이 GPT-4o($2.5)보다 약간 비쌉니다. 근데 캐싱 할인율이 Anthropic이 더 공격적이라(90% vs 50%), 같은 system prompt 반복 사용 워크로드면 Claude가 30~40% 저렴해져요.
Q2. Batch API는 언제 쓰나요? 24시간 안에만 결과 나오면 되는 작업, 예를 들어 야간 데이터 분류·요약. 50% 할인됩니다. 라이브 챗봇엔 못 쓰고요.
Q3. 한국어 토큰 효율은 어떤가요? Claude 4 시리즈 기준 한국어 1자당 평균 1.4 토큰. GPT-4 계열(1.6~1.8)보다 살짝 유리합니다.
Q4. Vision API 쓸 때 이미지 단가는? 이미지 1장당 약 1,500~1,600 토큰으로 카운트됩니다. PDF 영수증 OCR 1,000장 처리하면 input만 $4.5쯤 나와요.
Q5. 놓치기 쉬운 캐싱 팁 하나는? 캐시 브레이크포인트는 요청당 4개까지 분리할 수 있습니다(공식 문서 기준). 자주 안 바뀌는 시스템 프롬프트와 자주 바뀌는 RAG 컨텍스트를 블록으로 나눠 두면, 일부만 바뀌어도 앞부분 캐시가 살아남아 히트율이 또 한 번 점프합니다.
결론
Claude API 단가는 모델 선택과 캐싱 적용 여부로 몇 배까지 벌어집니다. 오늘 당장 할 한 가지를 고르라면, 1,024 토큰 넘는 system prompt에 `cache_control` 한 줄 추가하세요. 반복 호출 워크로드라면 이거 하나로 다음 달 청구서가 크게 달라집니다.
더 궁금한 부분, 본인 워크로드 단가 견적 같은 거 있으면 댓글로 남겨주세요. 시간 되는 대로 케이스별로 답변 드릴게요.
관련 글 더 보기
공식 사이트에서 확인하기
정확한 최신 요금과 조건은 공식 사이트에서 확인하세요. (이 글은 제휴 링크를 포함할 수 있으며, 클릭 시 본 사이트에 소정의 수수료가 지급될 수 있습니다.)
공식 사이트에서 최신 요금·기능을 확인하세요: claude.ai