Claude Max와 Team 구독에는 2026년 10월 7일부터 매달 Claude API 크레딧이 포함됩니다. Max 5x는 월 $100, Max 20x는 월 $200, Team은 좌석 수에 따라 최대 월 $500입니다. claude.ai의 Settings > Billing(Team은 Organization settings > Billing)에 있는 API credits 항목에서 Claude Console 조직을 연결하면 그 조직의 잔액으로 들어오고, Console에 카드를 등록할 필요는 없습니다(Anthropic 공식 문서).
쓸 수 있는 곳은 직접 만든 앱이나 스크립트에서 부르는 Claude API(Messages API, Message Batches API), Console Playground, Claude Managed Agents, Claude Agent SDK입니다. 대화형 Claude Code와 Claude 앱의 추가 사용(사용 크레딧)에는 쓸 수 없고, claude -p는 연결한 조직의 API 키로 직접 실행할 때만 크레딧에서 차감됩니다. 남은 크레딧은 결제 주기가 끝나면 소멸하고 다음 달로 이월되지 않습니다. 잔액과 만료일은 Console의 Settings > Billing에 있는 Promotional credits에서 확인합니다.
아래 메뉴 이름은 영어 화면 기준입니다.
Claude Max·Team API 크레딧 금액: Max 5x $100, 20x $200, Team 최대 $500
금액은 요금제와 좌석 구성으로 정해집니다. 아래는 모두 미국 달러이며 2026년 10월 9일 기준입니다(공식 문서, 헬프센터 안내).
| 요금제 | 월간 API 크레딧 |
|---|---|
| Max 5x | $100 |
| Max 20x | $200 |
| Team Standard 좌석 | 좌석당 $20 |
| Team Premium 좌석 | 좌석당 $100 |
| 할인 Team(Nonprofit, Scientists) | Team과 같음: Standard 좌석당 $20, Premium 좌석당 $100 |
Team은 좌석별 크레딧을 하나의 잔액으로 합치고, 합계는 월 $500에서 멈춥니다. 금액은 매번 그 결제 월이 시작될 때 요금제에 있는 좌석 수로 계산합니다. 공식 예시대로 Standard 3석과 Premium 2석이면 3 × $20 + 2 × $100 = 월 $260이고, Premium 1석을 추가하면 그다음 달부터 $360이 됩니다. Premium 5석이면 이미 $500 상한에 닿으므로 좌석을 더 늘려도 크레딧은 늘지 않습니다.
Pro, Free, Enterprise 요금제는 대상이 아닙니다.
API credits 항목이 안 보일 때: 가입 7일, 요금제, 역할 확인
자격이 없는 계정에는 설정 화면에 API credits 항목 자체가 나타나지 않습니다. 항목이 보이지 않으면 아래 순서로 확인합니다.
- 요금제: Max 5x, Max 20x, Team(할인 Team 포함)인지 확인합니다. 요금제는 유효하고 결제가 정상인 상태여야 합니다.
- 가입 7일: 새로 구독했다면 대상 요금제에서 7일이 지나야 받을 수 있습니다.
- 역할: Max는 구독자 본인, Team은 Primary Owner나 Owner만 받을 수 있습니다. 일반 팀원이라면 Owner에게 연결을 요청합니다.
- 웹 브라우저: iOS나 Android 앱에서 구독한 요금제도 대상이지만, 받는 절차는 웹 브라우저의 claude.ai에서 진행합니다.
- 순차 적용: Anthropic은 며칠에 걸쳐 순차 적용한다고 안내합니다. 위 조건을 모두 갖췄는데 7일이 지나서도 보이지 않으면 지원팀에 문의합니다.
API 크레딧 받는 법: claude.ai Billing에서 Console 조직 연결
받는 작업은 Claude 요금제에 Claude Console 조직 하나를 연결하는 것입니다. 시작하기 전에 두 쪽 권한이 모두 필요합니다.
| 위치 | 필요한 역할 |
|---|---|
| Claude 요금제 | Max: 구독자 본인 / Team: Primary Owner 또는 Owner |
| Claude Console 조직 | Owner, Admin, Billing 중 하나 |
Console 조직이 없으면 platform.claude.com에서 먼저 만들거나 연결 과정에서 새로 만들 수 있습니다. 헬프센터는 Console에도 claude.ai와 같은 이메일로 로그인하라고 안내합니다.
- claude.ai에서 Settings > Billing(Max) 또는 Organization settings > Billing(Team)을 엽니다.
- API credits 항목에서 Link organization을 누릅니다.
- 크레딧을 받을 Console 조직을 고르거나 새로 만듭니다.
- Supplemental Credit Terms를 확인하고 Link organization으로 연결을 마칩니다.
- Console의 Settings > Billing에서 Promotional credits에 금액이 들어왔는지 봅니다. 여기까지 확인되면 그 조직에서 API 키를 만들어 바로 호출할 수 있습니다.
연결 중에 오류가 나면 헬프센터 안내대로 몇 시간 뒤 다시 시도합니다. Console에서 API 키를 만들고 권한을 나누는 방법은 Claude API 키 구매 전에 확인할 것에서 이어서 볼 수 있습니다.
연결할 조직 고르기: 나중에 직접 바꿀 수 없습니다
요금제 하나는 Console 조직 하나에만 연결되고, Console 조직 하나도 요금제 하나에서만 크레딧을 받습니다. 연결한 조직은 사용자가 직접 바꿀 수 없어 지원팀에 요청해야 하고, 크레딧을 여러 조직에 나눌 수도 없습니다. 연결 버튼을 누르기 전에 다음을 정해 둡니다.
- 실제로 개발할 조직인가: 시험 삼아 만든 개인 조직에 연결하면 나중에 팀 프로젝트 조직으로 옮기기 어렵습니다.
- 이미 구매 크레딧과 자동 충전이 있는 조직인가: 포함 크레딧이 먼저 쓰이지만 자동 충전은 구매 잔액만 보고 동작하므로, 월간 크레딧이 남아 있어도 충전 결제가 일어날 수 있습니다(아래 소진 항목 참고).
- Team이라면 프로젝트별 워크스페이스를 나눌 조직인가: 조직의 모든 키가 같은 잔액을 쓰므로, 워크스페이스로 나눠 한도를 걸 수 있는 조직이 관리하기 쉽습니다.
- 두 번째 Max 계정이 있는가: 한 조직은 요금제 하나에서만 받으므로 Max 계정 두 개의 크레딧을 한 조직에 모을 수 없습니다.
스타트업 프로그램으로 $1,000 API 크레딧을 받았거나 받을 예정이라면 그 크레딧의 만료와 조건은 Claude for Startups 신청 조건과 크레딧: $1,000은 6개월 뒤 만료에 정리되어 있습니다. 스타트업 프로그램의 무료 Team이 월간 API 크레딧 대상인지는 2026년 10월 9일 기준 공식 문서에 따로 적혀 있지 않습니다.
어디에 쓸 수 있나: 실행 방식별 크레딧 차감 여부와 인증 정보
크레딧은 Claude Platform(Claude Console)에서 쓸 수 있는 모든 Claude 모델에 적용됩니다. 차감 여부를 가르는 것은 도구 이름보다 어떤 인증 정보로 요청이 나가느냐입니다. 공식 문서의 대상 표는 Claude Code를 "No"로만 적고 있고, 세부 조건은 헬프센터 FAQ에 있습니다.
| 하는 일 | 월간 API 크레딧 차감 | 요청에 쓰이는 인증 정보 |
|---|---|---|
| 직접 만든 앱의 Messages API 호출 | 예 | 연결한 조직의 API 키 |
| Message Batches API 일괄 처리 | 예 | 연결한 조직의 API 키 |
| Console Playground | 예 | 연결한 조직에 로그인 |
| Claude Managed Agents | 예 | 연결한 조직의 API 키 |
| Agent SDK 스크립트 | 예 | 연결한 조직의 API 키 |
| Agent SDK를 Claude 요금제 로그인으로 실행 | 아니오(요금제 한도 사용) | claude.ai 로그인 |
claude -p를 연결 조직 키로 직접 실행 | 예(Agent SDK 사용으로 처리) | 연결한 조직의 API 키 |
claude -p를 요금제 로그인으로 실행 | 아니오(요금제 한도 사용) | claude.ai 로그인 |
| 대화형 Claude Code(터미널, IDE, 데스크톱, 웹) | 아니오 | 어느 쪽이든 대상 아님 |
| Claude Code GitHub Action, IDE 확장, 데스크톱 앱이 실행한 작업 | 아니오(-p를 붙여도 제외) | 어느 쪽이든 대상 아님 |
| Claude, Claude Code, Cowork의 추가 사용(사용 크레딧) | 아니오 | 별도 결제 |
| Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry, Claude Platform on AWS | 아니오 | 각 클라우드 계정 |
크레딧을 받아도 Claude 앱, Claude Code, Cowork의 사용량 한도는 바뀌지 않습니다. 5시간 한도나 주간 한도에 걸리는 문제는 이 크레딧으로 풀리지 않습니다.
Claude Code에서 차감되는 경우: 연결 조직 키로 돌린 claude -p
Claude Code 쪽에서 월간 API 크레딧을 쓰는 방법은 하나입니다. 터미널에서 claude -p(비대화형 모드)를 직접 실행하면서, 연결한 조직에서 만든 API 키를 ANTHROPIC_API_KEY로 넘기는 경우입니다. 같은 claude -p라도 claude.ai 계정으로 로그인한 상태에서 키 없이 실행하면 요금제 한도를 쓰고, GitHub Action처럼 다른 도구가 대신 실행하면 키가 연결 조직 것이어도 크레딧 대상이 아닙니다.
Claude Code 인증 문서에 따르면 ANTHROPIC_API_KEY 환경 변수는 /login으로 저장한 구독 로그인보다 우선합니다. 비대화형 모드(-p)에서는 키가 있으면 항상 그 키를 쓰고, 대화형 모드에서는 처음 한 번 키를 쓸지 묻고 그 선택을 기억합니다.
ANTHROPIC_API_KEY를 셸 설정에 넣으면 생기는 일
위 우선순위를 그대로 적용하면, 연결 조직의 키를 ~/.zshrc나 ~/.bashrc에 export로 넣어 두고 대화형 Claude Code에서 키 사용을 승인한 경우 그 세션은 요금제가 아니라 조직 잔액으로 청구됩니다. 대화형 Claude Code는 월간 크레딧 대상이 아니므로 다음 중 하나가 일어납니다.
- 조직에 이 월간 크레딧만 있을 때: Claude Code에
Credit balance too low · Add funds: https://platform.claude.com/settings/billing이 표시됩니다(공식 문서에 적힌 메시지). - 조직에 구매 크레딧도 있을 때: 공식 문서에 직접 적혀 있지는 않지만, 차감 순서를 따르면 이 세션 사용량은 구매 크레딧에서 나갈 것으로 보입니다.
그래서 키는 셸 설정 파일에 넣지 않고, 크레딧으로 돌릴 헤드리스 명령에만 넘기는 편이 안전합니다.
# 키 파일 경로는 예시입니다. 키를 파일에 두고 이 명령 한 번에만 환경 변수로 넘깁니다
ANTHROPIC_API_KEY="$(cat ~/.config/claude/linked-org.key)" \
claude -p "src/ 폴더의 최근 변경 내용을 세 줄로 요약해 줘"이미 export해 두었다면 unset ANTHROPIC_API_KEY로 지우면 구독 로그인으로 돌아갑니다. 대화형 세션에서 /status를 입력하면 지금 어떤 인증 정보를 쓰는지 볼 수 있고, /config의 "Use custom API key" 설정으로 키 사용 승인을 바꿀 수 있습니다(이 설정은 ANTHROPIC_API_KEY가 환경에 있을 때만 보입니다).
잔액 확인: Console Settings > Billing의 Promotional credits
잔액은 Claude Console의 Settings > Billing 화면, Promotional credits 항목에 금액과 만료일이 함께 표시됩니다. Console 계정에 조직이 여러 개 있다면 크레딧을 연결한 조직으로 전환한 뒤 확인합니다.
어디에 얼마를 썼는지는 Console의 Cost 페이지에서 추적합니다. 잔액이 예상보다 빨리 줄었다면 Cost 페이지에서 사용량이 몰린 날짜와 모델을 보고, 해당 작업의 모델이나 요청 크기를 조정합니다.
매달 소멸하나: 결제 주기 끝에 사라지고 이월되지 않습니다
월간 API 크레딧은 결제 주기마다 요금제 결제가 처리된 직후 지급됩니다. 연간 결제 요금제도 1년치를 한꺼번에 주지 않고 매달 지급합니다. 쓰지 않은 크레딧은 그 결제 주기가 끝날 때(연간 결제는 매달) 소멸하고 다음 달로 넘어가지 않습니다.
기준이 '달력 월'이 아니라 '결제 주기'라는 점이 중요합니다. 10월 20일에 결제되는 Max 구독이라면 10월 20일 무렵 크레딧이 들어오고, 다음 결제일 무렵 남은 금액이 사라집니다. 만료 날짜는 Promotional credits의 만료일에서 정확히 확인합니다.
지출 한도는 달력 월 기준이라 크레딧 주기와 어긋납니다
크레딧으로 낸 사용량도 조직의 월 지출 한도(spend cap)에 포함됩니다. 지출 한도는 매달 1일 00:00 UTC에 초기화되고, 크레딧은 결제 주기에 맞춰 들어옵니다(요금 한도 문서).
| 사용 티어 | 월 지출 한도 |
|---|---|
| Start | $500 |
| Build | $1,000 |
| Scale | $200,000 |
연결한 조직은 최소 Start 티어로 올라가고, 월간 크레딧이 $200을 넘으면 최소 Build 티어가 됩니다. 문구대로 읽으면 Max 20x의 $200은 '넘는' 금액이 아니므로 최소 Start이고, $260이나 $500을 받는 Team은 Build입니다. 실제 티어는 Console의 Rate limits 페이지에서 확인합니다. 크레딧 사용액은 상위 티어 승급 실적에는 반영되지 않습니다.
어긋남이 실제로 문제가 되는 경우를 계산해 보면 이렇습니다. Max 20x 결제일이 10월 15일이라면, 10월 1~14일에 이전 주기에서 남은 크레딧 $200을 쓰고 15일 이후 새 크레딧 $200을 또 쓸 수 있으므로 한 달력 월 안에 크레딧 사용만 $400이 지출 한도에 잡힐 수 있습니다. Start 티어 한도 $500에 구매 크레딧 사용까지 더해지면 월말 전에 한도에 닿을 수 있고, 이때는 다음 달 1일까지 HTTP 429가 돌아옵니다. 직접 설정한 한도에 걸리면 HTTP 400과 You have reached your specified API usage limits 메시지가 나옵니다.
크레딧을 다 쓰면: 구매 크레딧이 없으면 API가 멈춥니다
월간 크레딧이 0이 된 뒤의 동작은 조직의 다른 잔액에 따라 갈립니다.
| 조직 상태 | 크레딧을 다 쓴 뒤 |
|---|---|
| 구매 크레딧이 있거나 자동 충전이 켜져 있음 | 구매 크레딧으로 계속 처리되고, 자동 충전은 구매 잔액에 금액을 더함 |
| 다른 크레딧이 없음 | 다음 월간 크레딧이 들어올 때까지 API 요청이 멈춤 |
| Anthropic 영업팀을 통해 인보이스로 결제하는 조직 | 크레딧을 넘는 사용량은 평소처럼 청구 |
어느 경우든 초과 사용량이 Claude 요금제 결제로 청구되지는 않습니다. 잔액이 없을 때 API는 다음 메시지를 돌려줍니다.
Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.계속 쓰려면 Console에서 크레딧을 구매하거나 자동 충전을 켭니다. 이때 알아 둘 점이 있습니다. 차감 순서는 포함 크레딧이 먼저, 구매 크레딧이 나중이지만, 자동 충전은 구매 잔액만 보고 동작합니다. 구매 잔액이 설정한 기준선 아래에 있으면 월간 크레딧이 남아 있어도 충전 결제가 일어날 수 있으므로, 자동 충전을 켤 때는 구매 잔액과 기준선을 함께 봅니다.
팀원이 같은 잔액을 쓸 때: 워크스페이스별 지출 한도
연결한 조직의 모든 API 키와 워크스페이스는 같은 잔액을 씁니다. 키를 여러 사람이나 프로젝트에 나눠 주면 한 프로젝트의 배치 작업이 팀 전체 크레딧을 먼저 써 버릴 수 있습니다. 프로젝트마다 워크스페이스를 따로 만들고 워크스페이스 지출 한도를 걸어 두면 한도에 닿은 워크스페이스만 멈춥니다. 예를 들어 Team $500 잔액에서 사내 챗봇 워크스페이스에 $300, 실험용 워크스페이스에 $100 한도를 걸어 두면 두 워크스페이스가 합쳐 $400을 넘게 쓰지 못하므로, 최소 $100은 다른 워크스페이스 몫으로 남습니다.
$100·$200으로 몇 번 호출할 수 있나: 모델별 계산 예
얼마나 쓸 수 있는지는 고르는 모델과 요청 크기로 정해집니다. 아래는 요청 한 번에 입력 3,000토큰, 출력 500토큰을 쓰고 캐시를 쓰지 않는 표준 API 호출을 가정한 계산 예입니다. 가격은 2026년 10월 9일 기준 Claude API 가격표의 100만 토큰당 입력/출력 가격입니다.
요청당 비용 = (3,000 × 입력 가격 + 500 × 출력 가격) ÷ 1,000,000
| 모델(입력/출력, 100만 토큰당) | 요청당 비용 | $100로 | $200로 | $500로 |
|---|---|---|---|---|
| Claude Haiku 5.5 ($0.10/$0.50, 프롬프트 10만 토큰 이하) | $0.00055 | 약 181,800회 | 약 363,600회 | 약 909,000회 |
| Claude Sonnet 5.5 ($2/$10) | $0.011 | 약 9,090회 | 약 18,180회 | 약 45,450회 |
| Claude Opus 5.5 ($4/$20) | $0.022 | 약 4,545회 | 약 9,090회 | 약 22,720회 |
| Claude Fable 5.1 ($10/$50) | $0.055 | 약 1,818회 | 약 3,636회 | 약 9,090회 |
Message Batches API는 입력과 출력 모두 50% 할인이므로, 즉시 응답이 필요 없는 작업을 배치로 돌리면 같은 조건에서 횟수가 대략 두 배가 됩니다. 반대로 대화 이력이 길어지거나 도구 호출 결과가 프롬프트에 쌓이면 요청당 입력 토큰이 빠르게 늘어납니다. Haiku 5.5는 프롬프트가 10만 토큰을 넘으면 입력 $0.50, 출력 $2.50으로 비싸지고, Opus 5.5와 Sonnet 5.5는 캐시 적중 입력이 기본 입력 가격의 0.05배라 반복되는 시스템 프롬프트를 캐시하면 입력 비용이 크게 줄어듭니다.
이 표는 사용량을 보장하는 수치가 아니라 감을 잡기 위한 예입니다. 실제 지출은 Cost 페이지에서 첫 며칠 사용량을 보고 다시 계산합니다. Haiku 5.5의 가격 구간은 Claude Haiku 5.5 vs GPT-6 Luna 가격 비교: 10만 토큰 넘으면 5배, Opus 5.5의 실제 비용 계산은 Claude Opus 5.5 이용 경로·실제 비용·Opus 5 이전 점검에서 더 자세히 볼 수 있습니다.
요금제를 바꾸면: 해지·Max 20x 업그레이드·Team 좌석 변경
| 변경 | 크레딧에 생기는 일 |
|---|---|
| 해지, 대상이 아닌 요금제로 다운그레이드, 환불 | 요금제가 끝나면 새 크레딧 지급이 멈춤. 이미 받은 크레딧은 만료일까지 사용 가능 |
| Max 5x → Max 20x | 비례 계산한 크레딧을 바로 받고, 이후 결제 주기마다 $200. Google Play 구독은 늦어도 다음 갱신일까지 $200 지급 |
| Max → Team | Max 연결이 끝나고, Team 요금제가 7일 이상 유효해진 뒤 Team Owner가 팀 크레딧을 새로 받음 |
| Team 좌석 추가 | 다음 결제 월 크레딧부터 반영 |
| Team 좌석 삭제 | 갱신 때까지 좌석이 남아 있다가, 갱신 뒤 크레딧이 줄 수 있음. 상한은 계속 $500 |
Claude Max API 크레딧 자주 묻는 질문
Claude 사용 크레딧(usage credits)을 API에 쓸 수 있나요?
쓸 수 없습니다. 사용 크레딧은 Claude 앱이나 Claude Code에서 요금제 한도를 다 쓴 뒤 API 요금으로 이어서 쓰게 해 주는 별도 잔액이고, claude.ai의 Settings > Usage에서 켜며 구독료와 따로 청구됩니다. 헬프센터는 사용 크레딧과 Max에 포함된 월간 API 크레딧이 서로 다른 잔액이며, 월간 API 크레딧은 사용 크레딧 쪽에 쓰이지 않는다고 밝힙니다. 사용 크레딧은 claude.ai 계정에서 관리하는 잔액이고, API 호출에 쓰는 잔액은 Console 조직에 따로 있습니다.
6월에 발표된 Agent SDK 크레딧과 같은 건가요?
다른 것입니다. 6월에 예고된 Agent SDK 관련 변경은 2026년 6월 15일에 보류되었고, 헬프센터는 그 크레딧이 제공되지 않는다고 적고 있습니다. 10월 7일부터 제공되는 것은 Console 조직으로 받는 월간 API 크레딧이며, Agent SDK도 이 크레딧으로 쓸 수 있습니다. 구독 로그인으로 Agent SDK와 claude -p를 쓰는 기존 방식도 그대로 요금제 한도 안에서 쓸 수 있습니다(헬프센터).
Claude Pro 요금제도 API 크레딧을 받을 수 있나요?
받을 수 없습니다. 대상은 Max 5x, Max 20x, Team(할인 Team 포함)뿐이고 Free, Pro, Enterprise는 제외됩니다.
모바일 앱에서 구독한 Max도 받을 수 있나요?
받을 수 있습니다. iOS나 Android 앱에서 구독한 요금제도 대상이고, 연결 절차만 웹 브라우저의 claude.ai에서 진행합니다.
크레딧을 받으려면 Console에 카드를 등록해야 하나요?
필요 없습니다. 카드 없이 받고 쓸 수 있습니다. 다만 카드도 구매 크레딧도 없는 조직은 월간 크레딧을 다 쓰면 다음 지급일까지 API 요청이 멈춥니다.
Claude Code를 많이 쓰는데 이 크레딧으로 한도를 늘릴 수 있나요?
늘릴 수 없습니다. 크레딧은 Claude Code의 5시간 한도나 주간 한도를 바꾸지 않고, 대화형 Claude Code 세션에도 쓰이지 않습니다. 요금제별 한도 차이는 클로드 Pro·Max 사용량 한도 비교에서 볼 수 있습니다. 반복 작업을 claude -p 스크립트로 바꾸고 연결 조직 키로 실행하는 부분만 크레딧으로 옮길 수 있습니다.
Claude for Startups의 $1,000 크레딧과는 무엇이 다른가요?
스타트업 프로그램의 API 크레딧은 승인된 회사에 한 번 지급되고 지급 6개월 뒤 만료됩니다. 월간 API 크레딧은 Max·Team 구독이 유지되는 동안 결제 주기마다 들어오고 그 주기 안에 소멸합니다. 신청 조건과 Team 1년 무료 혜택은 Claude for Startups 신청 조건과 크레딧에서 확인할 수 있습니다.
