저널 Uncategorized

Claude Max·Ultra·Team 월간 API 크레딧 정리: 플랜별 금액, 연결 순서, Claude Code에 못 쓰는 이유와 소멸 규칙

구독 카드에서 나온 동그란 토큰들이 다리를 건너 노트북과 작은 로봇이 있는 개발 작업 공간으로 흘러가고, 위에는 매달 갱신을 뜻하는 달력과 순환 화살표가 떠 있는 AI 생성 설명 일러스트
AI로 생성한 설명용 일러스트이며 실제 사건의 사진이 아닙니다.

Claude를 Max나 Team 요금제로 쓰고 있다면 결제 화면에 ‘API credits’라는 항목이 생겼을 수 있습니다. 채팅 앱과 Claude Code 구독료와는 별개로, 내가 만든 프로그램이나 자동화가 Claude API를 부를 때 쓸 수 있는 돈을 매달 넣어 주는 제도입니다.

다만 저절로 쓰이지는 않습니다. 개발자용 계정(Claude Console 조직)을 한 번 연결해야 크레딧이 들어오고, 쓰지 않은 금액은 다음 달로 넘어가지 않습니다. 무엇보다 많은 사람이 기대하는 Claude Code 사용량 확장에는 쓸 수 없습니다.

이 글은 Anthropic 고객센터 안내와 Claude Platform 공식 문서를 2026년 11월 22일에 다시 확인해, 플랜별 금액과 연결 순서, 적용 범위, 놓치기 쉬운 규칙을 정리한 것입니다.

1. 무엇이 생겼나: 플랜별 월 크레딧 금액

Claude 공식 릴리스 노트에 따르면 이 제도는 2026년 10월 7일 Claude Haiku 5.5 출시와 함께 발표됐고, 며칠에 걸쳐 순차 적용됐습니다. 확인 시점의 고객센터 안내와 플랫폼 문서가 적은 월 금액은 다음과 같습니다. 모두 미국 달러 기준입니다.

  • Max: 월 100달러
  • Ultra: 월 200달러
  • Team Standard 좌석: 좌석당 20달러
  • Team Premium 좌석: 좌석당 100달러
  • 할인 Team 플랜(비영리·과학자): 일반 Team과 같은 좌석당 금액

Team은 좌석별 금액을 하나로 합쳐 지급하고, 합계는 월 500달러가 상한입니다. 공식 문서의 예시대로 Standard 3석과 Premium 2석이면 월 260달러이고, Premium 1석을 더하면 다음 달부터 360달러가 됩니다.

Free, Pro, Enterprise 플랜은 대상이 아닙니다. 출시 직후 일부 해설 기사(Developers Digest 등)는 Max 5x 100달러, Max 20x 200달러로 구분했지만, 확인 시점 공식 문서는 Max와 Ultra라는 이름으로 적고 있습니다. 내 플랜이 어느 쪽에 해당하는지는 결제 화면에서 확인하는 것이 정확합니다.

2. 어디에 쓸 수 있고 어디에 못 쓰나

이 크레딧은 Claude Platform, 즉 Anthropic이 직접 운영하는 개발자용 API에서만 쓰입니다. 공식 문서가 밝힌 적용 범위는 다음과 같습니다.

  • 쓸 수 있음: Claude API(Messages API, Message Batches API), Console의 Playground, Claude Managed Agents, Claude Agent SDK
  • 쓸 수 없음: 터미널·IDE·데스크톱·웹에서 대화형으로 쓰는 Claude Code, Claude 앱의 추가 사용량(extra usage), Amazon Bedrock·Google Cloud Vertex AI·Microsoft Foundry 같은 클라우드 경유 이용, 연동 결제(linked billing)로 청구되는 외부 앱 사용

가장 헷갈리는 부분은 Claude Code를 화면 없이 실행하는 claude -p 명령입니다. 고객센터 FAQ에 따르면 연결한 Console 조직의 API 키로 직접 실행하면 Agent SDK 사용으로 계산돼 크레딧이 적용됩니다. 반대로 Claude 요금제 계정으로 로그인한 상태에서 실행하면 지금처럼 요금제 사용 한도에서 차감됩니다. GitHub Action, IDE 확장, 데스크톱 앱이 시작한 실행은 -p를 붙여도 Claude Code 사용으로 보고 크레딧을 쓰지 않습니다.

또 크레딧은 Claude 앱이나 Claude Code의 사용 한도를 늘려 주지 않습니다. 앱에서 한도에 걸렸을 때 크레딧이 대신 쓰이는 구조가 아니므로, 둘은 서로 다른 지갑이라고 생각하는 편이 쉽습니다.

선으로 나뉜 두 양동이 중 왼쪽에는 노트북으로 채팅하는 사람이, 오른쪽에는 토큰이 깔때기와 톱니바퀴를 거쳐 로봇과 서버로 이어지는 API 흐름이 있고, 바깥의 자물쇠 달린 터미널 창은 크레딧 적용 대상이 아님을 나타내는 개념도
AI로 생성한 설명용 일러스트

3. 받는 조건과 연결 순서

조건은 많지 않지만 역할과 대기 기간을 확인해야 합니다.

  • 대상 플랜이 활성 상태이고 미납이 없어야 합니다.
  • 새로 가입했다면 대상 플랜을 7일 이상 유지해야 신청 항목이 보입니다.
  • iOS·Android 앱에서 결제한 구독도 대상이지만, 신청은 웹 브라우저의 claude.ai에서 합니다.
  • Claude Platform에 카드를 따로 등록할 필요는 없습니다.
  • Max·Ultra는 구독자 본인, Team은 Primary Owner 또는 Owner가 신청합니다. Console 조직에서도 권한이 필요한데, 고객센터는 Owner·Admin·Billing을, 플랫폼 문서는 Admin·Billing을 적고 있어 표현이 조금 다릅니다.

연결 순서는 다음과 같습니다.

  1. claude.ai에서 Max·Ultra는 설정 > 결제(Settings > Billing), Team은 조직 설정 > 결제(Organization settings > Billing)로 들어갑니다.
  2. API credits 영역에서 ‘Link organization’을 누릅니다.
  3. 크레딧을 받을 Console 조직을 고르거나 새로 만듭니다.
  4. 보충 크레딧 약관을 확인하고 연결을 확정합니다.
  5. platform.claude.com의 결제(Billing) 페이지 ‘Promotional credits’ 항목에서 금액과 만료일을 확인한 뒤 API 키를 만들어 씁니다.

연결은 한 번만 가능하고, 각 Console 조직도 한 플랜에서만 크레딧을 받을 수 있습니다. 연결한 조직은 직접 바꿀 수 없고 지원팀에 문의해야 하므로, 실제로 개발할 조직을 골라 연결하는 것이 좋습니다. 고객센터는 Console에 claude.ai와 같은 이메일로 로그인하라고 안내하며, 연결 중 오류가 나면 몇 시간 뒤 다시 시도하라고 적고 있습니다.

4. 갱신·소멸·공유: 크레딧이 움직이는 규칙

크레딧은 매 결제 주기마다 요금제 결제가 처리된 직후 들어옵니다. 연간 결제여도 크레딧은 매달 나눠 들어옵니다. 쓰지 않은 금액은 그 주기가 끝나면 사라지고 이월되지 않습니다.

  • 사용 순서: 이 크레딧이 직접 구매한 크레딧보다 먼저 쓰입니다. 자동 충전(auto-reload)은 구매한 잔액만 기준으로 작동해, 포함 크레딧이 남아 있어도 구매 잔액이 기준 이하로 내려가면 충전될 수 있습니다.
  • 조직 공유: 연결된 조직의 모든 API 키와 워크스페이스가 같은 잔액을 씁니다. 프로젝트별로 나누고 싶다면 워크스페이스를 따로 만들고 워크스페이스 지출 한도를 걸어야 합니다.
  • 지출 상한과의 관계: 크레딧으로 쓴 금액도 조직의 월 지출 상한에 포함됩니다. 지출 상한은 매월 1일 초기화되지만 크레딧은 결제 주기 기준으로 들어와 날짜가 어긋날 수 있습니다.
  • 사용 등급: 연결된 조직은 최소 Start 등급으로 올라가고, 월 크레딧이 200달러를 넘으면 최소 Build 등급이 됩니다. 이 크레딧 사용액은 더 높은 등급으로 올라가는 실적에는 반영되지 않습니다.

잔액이 바닥나면 구매 크레딧이 있는 경우 그쪽에서 이어서 차감되고, 없으면 다음 달 크레딧이 들어올 때까지 API 요청이 멈춥니다. 공식 문서는 이 경우 요금이 Claude 요금제로 청구되지 않는다고 밝혔습니다. 다만 Anthropic 영업팀과 계약해 청구서로 결제하는 조직은 초과분이 평소처럼 청구됩니다.

가운데 동전 저장통에서 파이프 네 개가 각 작업 공간으로 이어지고 파이프마다 밸브와 게이지가 달려 있으며, 한 공간은 잔량이 바닥나 일시정지 표시가 떠 있고 뒤쪽 달력은 한 장이 넘어가며 월 단위 소멸을 표현한 개념도
AI로 생성한 설명용 일러스트

5. 100달러로 어느 정도 쓸 수 있을까: 공식 단가로 계산해 보기

얼마나 쓸 수 있는지는 모델과 요청 크기에 따라 크게 달라집니다. 아래는 공식 가격표의 확인 시점 단가(100만 토큰당 입력·출력)를 바탕으로 편집부가 계산한 예시입니다. 실제 사용량을 측정한 결과가 아니며, 캐시·세금·환율은 반영하지 않았습니다.

  • 단가: Haiku 5.5 입력 0.10달러·출력 0.50달러(프롬프트 10만 토큰 이하), Sonnet 5.5 입력 2달러·출력 10달러, Opus 5.5 입력 4달러·출력 20달러
  • 가정: 요청 1건에 입력 3,000토큰, 출력 1,000토큰
  • Haiku 5.5: 건당 약 0.0008달러, 100달러로 약 12만 5천 건
  • Sonnet 5.5: 건당 약 0.016달러, 100달러로 약 6,250건
  • Opus 5.5: 건당 약 0.032달러, 100달러로 약 3,125건

공식 문서는 크레딧을 아끼는 방법으로 작업에 맞는 모델 고르기, 반복되는 맥락에 프롬프트 캐싱 쓰기, 즉시 답이 필요 없는 작업에 50% 저렴한 Message Batches API 쓰기를 권합니다. 가격 문서는 Claude 4.7 이후 모델이 새 토크나이저를 써서 같은 글도 이전보다 약 30% 많은 토큰으로 계산될 수 있다고 적고 있으니, 실제 비용은 Console의 비용(Cost) 페이지에서 확인하는 것이 안전합니다.

해설 사이트 Believemy도 비슷한 방식으로 이메일 답장 초안 기준 사용량을 추정했는데, 이런 수치는 모두 가정에 따른 계산이라는 점을 기억해 두면 좋습니다.

6. 주의점과 정리

신청 전후로 다음을 확인해 두면 낭비를 줄일 수 있습니다.

  • Claude Code 한도 대책이 아닙니다. 대화형 Claude Code와 앱 추가 사용량에는 쓰이지 않습니다.
  • 조직 선택은 신중하게. 한 번 연결하면 직접 바꿀 수 없습니다.
  • 매달 사라집니다. 이월되지 않으므로 쓸 계획이 있는 자동화나 시험 프로젝트가 있을 때 의미가 큽니다.
  • 키 관리가 곧 비용 관리입니다. 조직 안의 모든 키가 같은 잔액을 쓰니, 팀이라면 워크스페이스별 지출 한도를 먼저 거는 편이 좋습니다.
  • 플랜을 바꾸면 규칙도 바뀝니다. 해지·환불·하위 플랜 변경 시 새 크레딧은 끊기고 남은 크레딧은 만료일까지 쓸 수 있습니다. Max에서 Ultra로 올리면 일할 계산된 크레딧이 바로 들어오고, Max·Ultra에서 Team으로 옮기면 기존 연결이 끝나 Team 소유자가 7일 뒤 다시 신청해야 합니다.
  • 지역 조건은 결제 화면에서 확인하세요. 확인한 공식 문서에는 국가 제한이 따로 적혀 있지 않았지만, 7일이 지나도 항목이 보이지 않으면 플랜·역할을 확인하고 지원팀에 문의하라고 안내합니다.

정리하면, 이 크레딧은 Max·Ultra·Team 구독자에게 ‘내 프로그램용 API 비용’을 매달 일정액 지원하는 제도입니다. 앱이나 Claude Code를 더 쓰게 해 주는 장치가 아니라, Console 조직을 연결해 API·Agent SDK·Managed Agents를 시험해 볼 수 있는 별도 예산에 가깝습니다. 금액과 대상은 바뀔 수 있으므로 신청 직전에 고객센터 안내를 다시 확인하시기 바랍니다.

출처(2026년 11월 22일 확인)

AI로 생성한 설명용 일러스트이며 실제 사건의 사진이 아닙니다.