클로드 API 구독 차이: 구독으로 쓸 때와 API 키로 쓸 때 요금은 이렇게 달라요
클로드 구독은 월 정액을 내고 정해진 사용 한도 안에서 채팅과 Claude Code를 쓰는 방식이에요. API는 내가 만든 프로그램에서 클로드를 불러 쓰고, 쓴 만큼(토큰 단위로) 따로 결제하는 방식이고요. 이름은 둘 다 클로드지만 계정도, 청구도, 한도도 완전히 따로 돌아가요.
먼저 결론만
- 구독은 월 정액에 사용 한도가 있고, API는 한도 없이 쓴 만큼 요금이 쌓여요.
- Claude Code는 구독으로도 API 키로도 쓸 수 있는데, API 키 환경변수가 켜져 있으면 구독이 있어도 API 요금이 나가요.
- 개인이 가볍게 쓰면 구독, 서비스처럼 크게 돌릴 거면 API가 맞아요.
클로드 구독과 API는 뭐가 다른가요?
표로 먼저 보면 이래요. 공식 가격 페이지와 도움말을 2026년 10월에 다시 읽고 정리했어요.
| 구독(Pro·Max) | API | |
|---|---|---|
| 요금 | 월 정액이에요. 한국 결제 기준 Pro는 월 22달러(연간 결제 시 1년 220달러), Max는 월 110달러부터예요(부가세 10% 포함). Max에는 매달 API 크레딧도 들어 있어요 | 쓴 만큼 토큰 단위로 결제해요 |
| 쓰는 곳 | claude.ai 웹·앱, 그리고 Claude Code | 내가 만든 프로그램과 개발자 콘솔 |
| 한도 | 5시간 단위와 주간 사용 한도가 있어요. 채팅과 Claude Code가 같은 한도를 나눠 써요 | 정해진 한도 없이 쓴 만큼 청구돼요 |
| 한도에 닿으면 | 기다리거나, 더 큰 플랜으로 올리거나, 사용 크레딧을 켜서 API 요금으로 이어 쓸 수 있어요 | 멈추지 않고 요금이 계속 쌓여요 |
| 인증 방식 | 클로드 계정 로그인 | API 키(비밀 문자열) |
구독 쪽에서 눈여겨볼 건 “한도”예요. 한도는 구독이 요금 폭탄을 막아 주는 안전장치이기도 해요. 그래서 한도에 닿아도 알아서 돈이 더 나가지는 않아요. 사용 크레딧을 직접 켜 두었을 때만 그때부터 API 요금으로 이어져요. Claude Code에서도 API 크레딧으로 넘어가기 전에 동의를 묻고요.
API 요금은 어떻게 계산되나요?
API는 글자를 토큰이라는 조각으로 쪼개서 센 다음, 모델마다 정해진 값을 곱해서 요금을 매겨요. 단위는 100만 토큰(MTok)이고, 넣은 글(입력)과 받은 글(출력) 값이 달라요. 지금 공식 가격 페이지에 나와 있는 값은 이래요.
| 모델 | 입력 | 출력 |
|---|---|---|
| Fable 5.1 | 10달러 | 50달러 |
| Opus 5.5 | 4달러 | 20달러 |
| Sonnet 5.5 | 2달러 | 10달러 |
| Haiku 5.5 | 0.1달러* | 0.5달러* |
2026년 10월 기준
100만 토큰당 가격이에요. *Haiku 5.5는 프롬프트가 10만 토큰 이하일 때 가격이고, 넘으면 입력 0.5달러, 출력 2.5달러예요. 예전 모델인 Haiku 4.5(입력 1달러, 출력 5달러)는 지금 공식 페이지에서 '레거시 모델'로 분류돼 있어요. 비동기로 한꺼번에 처리하는 배치를 쓰면 50% 할인된다는 안내도 있어요. 가격은 바뀔 수 있으니 결제 전에 claude.com/pricing에서 다시 확인하세요.
숫자만 보면 감이 안 와서 하나만 계산해 봤어요. Sonnet 5.5로 입력 2,000토큰, 출력 3,000토큰짜리 요청을 보내면 입력 0.004달러에 출력 0.03달러를 더해 약 0.034달러예요. 글 30편이면 대략 1달러고요. 다만 이건 한 번 묻고 한 번 답하는 단순한 경우예요. Claude Code는 파일을 읽고 대화가 길어질수록 앞의 내용을 매번 다시 들고 가서, 실제로는 훨씬 더 많이 써요.
Claude Code에서는 어느 쪽 요금이 나가나요?
Claude Code는 구독으로도, API 키로도 쓸 수 있어요. 구독으로 로그인하면 채팅과 같은 한도를 나눠 쓰고, Console 계정이나 API 키로 쓰면 쓴 만큼 결제돼요. 여기서 제일 조심할 게 하나 있어요. 컴퓨터에 ANTHROPIC_API_KEY 환경변수가 설정돼 있으면, Claude Code가 구독 대신 그 API 키를 써요. 공식 안내에도 구독이 아니라 API 사용 요금이 청구된다고 나와 있어요. 구독을 내고 있는데도 API 요금까지 내는 일이 생길 수 있다는 거예요.
내가 지금 어느 쪽인지 확인하는 방법이 있어요. 구독으로 쓰는 중이라면 /status로 남은 사용량을 볼 수 있고, API 키로 쓰는 중이라면 /cost로 이번 세션에서 쓴 금액을 볼 수 있어요. 구독으로 되돌리려면 환경변수를 지우고 /login으로 구독 계정에 다시 로그인하면 돼요.
제가 이 부분을 유독 신경 쓰는 이유는 본편 2에 적어 둔 일 때문이에요. 예전에 API가 유료인 줄도 모르고 쓰다가 3일 만에 40만 원이 나간 적이 있거든요. 그 뒤로 프로그램에 API 키를 기본값으로 넣지 않았어요.
구독으로 프로그램을 자동으로 불러도 되나요?
이 글을 쓰려고 공식 안내를 다시 읽다가 알게 된 게 있어요. Anthropic은 2026년 6월에 Agent SDK와 터미널의 claude -p(비대화형 모드) 사용을 구독 한도에서 빼고, 별도의 월 크레딧(Pro는 20달러)으로 옮기겠다고 발표했어요. 그런데 6월 15일에 이 변경을 일시 중지했어요. 그 뒤 10월 7일에 공식 안내가 다시 바뀌었어요. Max와 Team 플랜에는 월간 API 크레딧이 생겼고, 이 크레딧으로 Agent SDK와 claude -p도 쓸 수 있어요. 그리고 지금도 Agent SDK와 claude -p를 구독의 사용 한도로 쓰는 방식은 그대로 된다고 적혀 있어요.
정리하면 지금은 구독으로 claude -p를 부르는 방식이 공식 안내에 언급된 방식이에요. 하지만 정책이 바뀔 수 있는 부분이라, 이 방식으로 자동화를 만들었다면 가끔 공식 도움말을 확인하는 게 좋아요. 그리고 같은 안내에 팀이 공유하는 대규모 자동화에는 API 키를 쓰라는 권고도 있었어요. 제 생각에도 규모가 커지거나 남에게 서비스로 제공할 거라면 API 쪽이 요금 계산이 예측 가능해서 안전해요.
그럼 저는 어떻게 나눠 쓰나요?
저는 Pro 플랜으로 월 22달러가 결제돼요. 기본 가격 20달러에 부가세 10%가 붙은 금액이고, 한국어 공식 가격 페이지에도 이 금액으로 나와요. 블로그 글쓰기는 이 구독으로 돌리고, 가벼운 문구 작업은 내 컴퓨터의 올라마가, 이미지는 제미나이 API가 맡아요. 클로드 API 키는 예비로만 두고 평소에는 쓰지 않아요. 전체 구조는 본편 2에 있어요.
그래서 뭘 고르면 되나요?
답은 쓰는 방식에 달렸어요. 채팅으로 쓰고, 가끔 Claude Code로 코딩을 맡기고, 블로그 글을 몇 편 쓰게 하는 정도라면 구독이 마음 편해요. 한도에 막히는 불편은 있어도 요금이 알아서 불어나지는 않거든요. 반대로 내 서비스에 클로드를 넣어서 다른 사람들이 쓰게 하거나, 하루 종일 큰 작업을 자동으로 돌릴 거라면 API가 맞아요. 한도가 없는 대신 요금 한도는 내가 직접 관리해야 해요. 둘을 같이 쓴다면 API 키가 어디에 설정돼 있는지부터 꼭 확인하세요.
API, API 키, 토큰, CLI 같은 말이 낯설다면 AI 용어 정리 글에 쉽게 풀어 뒀어요.
자주 묻는 질문
Q. 클로드 구독이 있으면 API도 무료로 쓸 수 있나요?
Free와 Pro는 아니에요. 구독은 claude.ai와 Claude Code를 쓰는 계정이고, API는 개발자 콘솔에서 따로 크레딧을 충전해 쓰는 별개의 결제예요. 다만 Max 요금제에는 Claude Platform에서 쓸 수 있는 API 크레딧이 매달 들어 있어요(Max 5x 월 100달러, Max 20x 월 200달러). 이 크레딧은 Claude Console 조직에 받아서 API 키로 쓰는 것이라 Claude Code(대화형)나 claude.ai에는 쓸 수 없어요. 다 쓰면 따로 충전한 크레딧이 없는 한 다음 달 크레딧이 들어올 때까지 API 요청이 멈추고, 구독 요금으로 청구되지는 않아요.
Q. 구독 한도에 닿으면 자동으로 돈이 나가나요?
기본적으로는 아니에요. 사용 크레딧을 직접 켜 두었거나, Claude Code에서 API 크레딧으로 넘어가겠다고 동의한 경우에만 API 요금으로 이어져요.
Q. Claude Code를 쓰는데 갑자기 요금이 나왔어요. 왜 그럴까요?
컴퓨터에 ANTHROPIC_API_KEY 환경변수가 설정돼 있으면 구독 대신 API 키가 쓰여서 그럴 수 있어요. /cost로 지출을 확인하고, 환경변수를 지운 뒤 /login으로 구독 계정에 다시 로그인해 보세요.
Q. 무료 플랜으로 Claude Code를 쓸 수 있나요?
공식 요금제 비교표에서 Claude Code는 Pro 이상 유료 플랜부터 포함돼요. 무료 플랜에서는 쓸 수 없어요.
Q. API 가격은 모델마다 다른가요?
네, 모델마다 입력과 출력 가격이 달라요. 큰 모델일수록 비싸고, 가장 작은 Haiku 계열이 가장 저렴해요.
요금제는 자주 바뀌어요. 결제 전에는 항상 공식 가격 페이지와 도움말을 한 번 더 확인하는 게 제일 안전해요.
