Claude Max 요금제에는 월 API 크레딧이 붙어 있습니다. 금액이 작지 않아 요금제 설명에서 먼저 눈에 들어오는 항목입니다.
이 항목을 두고 흔한 오해가 하나 있습니다. 크레딧이 붙었으니 평소 쓰는 Claude Code를 그만큼 더 돌릴 수 있다고 읽는 경우입니다. 실제로는 크레딧이 쌓이는 자리가 다른 데입니다. 그래서 매달 그 금액이 버려지기도 합니다.
어느 쪽이 차감되고 어느 쪽이 아닌지, 받아 놓고도 못 쓰는 조건이 왜 생기는지를 차례로 봅니다.
짧은 답
이 크레딧은 Claude API 쪽 요금에만 쓰입니다. 앱·웹·터미널에서 로그인해 쓰는 Claude는 월정액 구독 쪽이라 여기서 차감되지 않습니다.
Claude와 Claude API는 다른 서비스다
Anthropic이 제공하는 서비스는 둘입니다.
- Claude — 앱·웹·터미널에서 로그인해 씁니다. 요금은 월정액입니다. Pro·Max·Team이 이쪽 요금제입니다
- Claude API — 내가 쓴 코드가 API 키로 부릅니다. 요금은 쓴 만큼 냅니다. 계산은 Claude Console 조직 단위로 붙습니다
이름이 닮았지만 결제가 따로 돌아갑니다. 월정액을 내도 Claude API 쪽 잔액은 생기지 않습니다. Claude API를 많이 써도 월정액 요금제의 사용량 한도는 줄지 않습니다.
여기에 혜택이 하나 붙었습니다. Max 이상 구독자에게 Claude API 쪽에서 쓸 돈을 매달 얹어 줍니다. 그게 이 크레딧입니다. 돈이 올라가는 자리는 구독 계정이 아니라 내가 연결한 Console 조직입니다.
요금제별로 얹히는 금액은 아래 표가 전부입니다.
| 요금제 | 월 크레딧 | 비고 |
|---|---|---|
| Pro | 없음 | |
| Max 5x | $100 | |
| Max 20x | $200 | |
| Team 일반 좌석 | 좌석당 $20 | 좌석별 금액을 합산 |
| Team 프리미엄 좌석 | 좌석당 $100 | 좌석별 금액을 합산 |
| Team 합산 상한 | 월 $500 | 좌석당 상한이 아님 |
| Enterprise | 없음 |
Team은 좌석별 금액이 하나로 합쳐진 뒤 위 표의 상한에서 멈춥니다. 좌석당 상한이 아니므로 좌석을 늘려도 그 선을 넘지 않습니다.
실제로 이럴 때 만난다
| 내가 하는 일 | 어느 서비스인가 | 크레딧에서 차감되나 |
|---|---|---|
| 내 스크립트에서 Messages API 호출 | Claude API | 차감됨 |
| 야간 일괄 처리를 Message Batches API로 | Claude API | 차감됨 |
| Console Playground에서 프롬프트 시험 | Claude API | 차감됨 |
| Agent SDK · Managed Agents로 에이전트 실행 | Claude API | 차감됨 |
| 터미널·IDE에서 Claude Code로 코드 수정 | Claude | 차감되지 않음 |
| 앱·웹·Cowork에서 한도를 넘겨 추가 결제 | Claude | 차감되지 않음 |
| 사내 앱이 Bedrock·Vertex AI·Foundry의 Claude 호출 | 클라우드가 제공하는 Claude | 차감되지 않음 |
가운데 열만 보면 끝납니다. Claude API라고 적힌 줄은 전부 크레딧에서 차감됩니다. 그 요금은 내가 연결한 Console 조직의 잔액에서 나갑니다. Claude라고 적힌 줄은 월정액 요금제가 받습니다. 클라우드가 제공하는 Claude 줄은 둘 다 아닙니다.
Claude Code 줄이 가장 자주 어긋나는 자리입니다. 터미널의 Claude Code는 모델을 똑같이 부릅니다. 그런데 거치는 서비스가 Claude 쪽이라 크레딧과 무관합니다.
헷갈리는 자리 — Agent SDK와 Claude Code
판별할 질문은 하나입니다. 이 호출이 Claude API를 거쳤는가.
이 호출이 Claude API를 거쳤는가
├ 예 Messages · Batches · Playground · Managed Agents · Agent SDK
│ → 월 크레딧에서 차감된다
├ 아니다 앱·웹·터미널의 Claude Code
│ → Claude 쪽. 구독 사용량 한도에서 나간다
└ 클라우드가 제공하는 Claude Bedrock · Vertex AI · Foundry
→ 그 클라우드에 청구. 크레딧과 무관
Bedrock·Vertex AI·Foundry만 결이 다릅니다. 그쪽도 API로 부르는 것은 맞습니다. 다만 제공하는 쪽이 Anthropic이 아닙니다. 클라우드 사업자가 자기 서비스로 제공하는 Claude입니다.
Agent SDK와 대화형 Claude Code는 하는 일이 닮았습니다. 그런데 거치는 서비스가 반대입니다. Agent SDK는 내 코드가 API 키로 부르니 Claude API입니다. 터미널의 Claude Code는 구독으로 로그인해 쓰니 Claude입니다.
같은 명령 안에서도 갈립니다. claude -p를 연결된 조직의 API 키로 실행하면 Claude API를 거칩니다. 구독으로 로그인한 상태로 실행하면 Claude 쪽입니다. GitHub Action·IDE 확장·데스크톱 앱에서 돌린 것은 -p를 붙여도 Claude Code 사용분입니다. 갈림길은 실행한 명령이 아니라 무엇으로 인증했는가입니다.
받아 두고 못 쓰는 경우
크레딧은 요금제만 결제하면 자동으로 들어오는 것이 아닙니다. 아래 다섯 줄이 전부 참일 때만 들어옵니다.
| 게이트 | 참이어야 하는 조건 |
|---|---|
| 자격 | 요금제가 Max 또는 Team |
| 요금제 측 역할 | Max는 구독 당사자 · Team은 Primary Owner 또는 Owner |
| 조직 측 역할 | 연결할 Console 조직에서 Owner · Admin · Billing 중 하나 |
| 가입 경과 | 해당 요금제를 7일 유지한 뒤 |
| 조직 연결 | 그 Console 조직이 다른 요금제에 연결돼 있지 않음 |
하나라도 거짓이면 그 달 크레딧은 들어오지 않습니다. 요금제 측 역할과 조직 측 역할은 비슷해 보이지만 묻는 곳이 다릅니다. 앞쪽은 요금제에서 내가 결제 당사자인지를 묻습니다. 뒤쪽은 연결 대상인 Console 조직에서 내 권한을 묻습니다. 조직 계정에서는 한 사람이 둘을 다 갖고 있지 않은 경우가 흔합니다.
1. 결제 화면에서 크레딧 항목을 연다
Max는 설정 → 결제(영문 Settings → Billing)의 API 크레딧 섹션입니다. Team은 Organization settings → Billing 입니다. [FACT-CHECK 필요] Team 경로의 한국어 라벨은 확인하지 못했습니다.
2. Claude Console 조직을 연결한다
여기서 조직 측 역할과 조직 연결 조건이 걸립니다. 한 번 고른 조직은 내가 직접 바꿀 수 없고 지원팀에 문의해야 하니 앞으로 API로 개발할 조직을 고르십시오. 가입 경과 조건을 못 채운 계정에는 경고가 뜨는 것이 아니라 연결 항목 자체가 나타나지 않습니다. 최근 도입된 혜택이라 순차 적용 중입니다. 조건을 다 채웠는데도 항목이 아직 안 보일 수 있습니다.
3. 연결 직후 잔액을 확인한다
기다리는 단계가 아닙니다. 연결을 마치면 그 조직 잔액에 금액이 바로 올라갑니다. 확인하는 자리는 Console의 결제 페이지(platform.claude.com/settings/billing)입니다.
받은 뒤에도 조건이 더 붙습니다.
- 쓰지 않은 몫은 결제 주기가 끝나면 없어집니다. 다음 달로 넘어가지 않습니다
- 연간 결제여도 크레딧은 매달 들어옵니다. 한 해 몫이 한 번에 들어오지 않습니다
- 월 크레딧은 Claude Code와 Claude 앱에 쓸 수 없습니다. 한도 초과분에도 못 씁니다. 따로 구매한 크레딧은 Claude Code에도 쓰이며 차감은 월 크레딧이 먼저입니다
- 연결된 조직의 API 키 전부가 같은 잔액을 씁니다. 팀원이 쓰면 같이 줄어듭니다
- 잔액이 바닥나도 Claude 구독 쪽으로 넘어가 과금되지 않습니다. 서비스가 달라 넘어갈 데가 없습니다. 구매 크레딧이나 자동 충전이 없으면 API 요청이 멈춥니다
정리
조건만 다시 적습니다. 이 크레딧은 Claude API 쪽 요금에만 쓰입니다. 로그인해 쓰는 Claude는 월정액 요금제가 받습니다.
받는 쪽 조건은 Console 조직 연결입니다. 연결하지 않으면 크레딧이 책정된 요금제라도 잔액이 생기지 않습니다. 쓰지 않은 몫은 결제 주기가 끝나면 사라집니다. 그래서 이번 달에 API로 돌릴 작업이 있는지를 먼저 확인하는 편이 맞습니다.
자주 묻는 질문
Q1. Claude Code에서 쓰는 요금도 이 크레딧에서 차감됩니까? 구독에 딸려 오는 월 API 크레딧에서는 차감되지 않습니다. 터미널과 IDE, 데스크톱 앱, 웹에서 로그인해 쓰는 Claude Code는 Claude 쪽이라 월정액 요금제의 사용량 한도를 씁니다. 한도를 넘겨 추가로 결제하는 금액도 구독 쪽에서 처리됩니다. 반대로 Agent SDK나 Managed Agents처럼 내 코드가 API 키로 모델을 부르는 경로는 Claude API라 이 크레딧에서 차감됩니다. 이름이 닮아 있어도 거치는 서비스가 다릅니다.
Q2. 안 쓴 크레딧은 다음 달로 넘어갑니까? 구독 요금제로 받은 월 크레딧은 넘어가지 않습니다. 연간 결제를 했더라도 한 해 몫이 한 번에 들어오는 것이 아니라 매달 들어오고 매달 사라집니다. 따로 구매해 둔 크레딧은 규정이 다릅니다. 구매일로부터 1년간 유효하고 그 기한은 연장되지 않습니다. 월 크레딧이 먼저 소진되므로 구매분이 뒤에 남습니다. 쌓아 두었다가 큰 작업에 한 번에 쓰는 계획이 성립하지 않는 쪽은 월 크레딧입니다.
Q3. Console 조직 하나를 요금제 여러 개에 연결할 수 있습니까? 연결은 일대일입니다. 요금제 하나에 Console 조직 하나가 붙으며 조직 하나는 요금제 하나에서만 크레딧을 받습니다. 이미 다른 요금제에 연결해 둔 조직을 고르면 여기서 막힙니다. 연결을 내가 직접 풀거나 바꾸는 기능은 없어 지원팀에 문의해야 합니다. 그래서 처음 고를 때 앞으로 API로 개발할 조직을 골라야 합니다. 연결된 조직의 API 키는 전부 같은 잔액을 쓰기 때문에 여러 사람이 같은 조직을 쓰고 있다면 잔액도 함께 줄어듭니다.
참고자료
- Monthly API credits for Max and Team plans — 요금제별 월 크레딧 금액, Team 합산 상한, 지급 조건(자격·요금제 측 역할·조직 측 역할·가입 경과·조직 연결), 적용 범위와 제외 범위, 이월 없음 규정, 순차 적용 안내
- How do I pay for my Claude API usage? — 구매 크레딧의 유효기간과 환불 규정, 월 크레딧과의 소진 순서, 월 크레딧의 Claude Code 적용 제외
요금제별 크레딧 금액·받는 조건·적용 범위와 크레딧 유효기간은 2026-10-26에 위 두 Anthropic 공식 지원 문서에서 확인했습니다.
약관성 정보라 금액과 조건이 바뀔 수 있으니 결제 전에 원문을 한 번 더 보십시오.
이미지 출처
- 대표 이미지: 자동 생성 텍스트 썸네일
- 도식: 자체 제작
이 글은 AI 보조로 작성하고 사람이 검수해 발행합니다. 제도·요금·가격 등은 반드시 원문에서 최종 확인하세요.
