클로드 Max를 쓰다가 주간 한도에 걸렸는데, 구독에 API 크레딧도 포함된다는 소식을 봤다면 먼저 이 둘을 나눠야 합니다. API 크레딧을 받아도 Claude 앱이나 대화형 Claude Code의 한도는 늘어나지 않습니다. 작업을 이어갈 수 있는지는 크레딧 액수보다 지금 어떤 방식으로 Claude를 쓰는지에 달려 있습니다.
2026년 10월 24일 공식 도움말 기준으로, 이 글은 이미 Max·Team을 쓰는 사람이 자신의 작업에 혜택을 쓸 수 있는지 판단하고 받을 곳을 확인하는 안내입니다. API를 처음 연결하거나 코딩 작업을 스크립트로 옮기는 구현 과정까지 다루지는 않습니다.
지금 하는 일이 어디에 해당하나요
API는 Claude 화면에서 대화하는 대신, 프로그램이 Claude에 요청을 보내는 통로입니다. 월간 API 크레딧은 그 개발자 플랫폼에서 발생하는 사용료를 내는 잔액입니다. 구독의 대화 횟수를 충전하는 쿠폰은 아닙니다.
| 현재 작업 | 월간 API 크레딧 사용 |
|---|---|
| 터미널·IDE·데스크톱·웹에서 대화형 Claude Code 사용 | 대상 아님. 구독 한도도 그대로 |
| Claude·Claude Code·Cowork의 추가 사용 | 대상 아님 |
| 직접 만든 앱의 Claude API, Console Playground, Managed Agents | 대상 |
직접 실행한 Agent SDK 또는 claude -p |
연결한 Console 조직의 API 키를 쓸 때 대상 |
같은 SDK·claude -p를 구독 로그인으로 실행 |
크레딧이 아니라 구독 한도 사용 |
| GitHub Action·IDE 확장·Claude 데스크톱 앱이 시작한 실행 | -p를 붙여도 대상 아님 |
예를 들어, 편집기에서 Claude와 대화하며 홈페이지를 고치던 사람이 크레딧을 받는다고 그 대화가 자동으로 재개되지는 않습니다. 반면 직접 만든 프로그램이 문서를 Claude API로 분류하고 있다면, 연결한 조직의 크레딧을 쓸 수 있습니다. 같은 모델을 사용해도 들어가는 통로가 다릅니다.
claude -p는 대화 없이 요청을 실행하는 방식입니다. 이름에 Claude가 붙었다고 전부 같은 잔액에서 빠지는 것은 아닙니다. 직접 실행했는지, 연결한 조직의 API 키를 쓰는지까지 확인해야 합니다. 이 혜택 때문에 평소 개발 환경의 인증을 무턱대고 바꾸지는 마세요. 키를 바꾸는 일은 단순한 무료 혜택 신청이 아니라 청구 경로를 바꾸는 일이기도 합니다.
받을 수 있는 요금제와 먼저 확인할 조건
Max 5x는 결제 주기마다 100달러, Max 20x는 200달러의 API 크레딧을 받습니다. Team은 Standard 좌석당 20달러, Premium 좌석당 100달러를 합쳐 팀 전체 최대 500달러입니다. 팀원 각자에게 500달러씩 주는 것은 아닙니다. 할인 Team 요금제도 대상이며 Free·Pro·Enterprise는 제외됩니다.
구독은 활성 상태이고 결제가 정상이어야 하며, 새 구독자는 대상 요금제를 7일 이상 사용해야 합니다. Max는 구독자 본인, Team은 Primary Owner나 Owner가 신청합니다. 연결할 Console 조직에서도 Owner·Admin·Billing 중 하나의 역할이 필요합니다.
카드 등록은 필수가 아닙니다. iOS·Android에서 구독했더라도 신청은 웹 브라우저의 claude.ai에서 합니다. API를 쓸 계획이 없고 대화형 Claude Code만 더 쓰려는 상황이라면, 이 혜택을 받으려고 요금제를 올릴 이유는 없습니다.
신청은 한 번, 조직 선택은 신중하게
Console 조직은 개발자 플랫폼에서 API 사용량과 비용을 묶어 관리하는 단위입니다. 개인 시험용 조직과 실제 서비스 조직이 따로 있다면, 앞으로 어떤 쪽에서 사용할지 먼저 정하세요. 요금제 하나는 조직 하나에만 연결할 수 있고, 조직을 바꾸려면 지원팀에 요청해야 합니다. 한 조직도 여러 요금제의 크레딧을 모아 받을 수 없습니다.
- 웹에서 claude.ai에 로그인합니다. Max는 Settings → Billing, Team 소유자는 Organization settings → Billing을 엽니다.
- API credits → Link organization을 선택합니다.
- 받을 Console 조직을 고르거나 새로 만듭니다. 기존 조직이 여러 개라면 이름과 용도를 다시 확인한 뒤 연결을 마칩니다.
- Claude Console의 Billing에서 연결한 조직의 크레딧 금액과 만료일을 확인합니다. 금액과 만료일이 보이는 것이 수령 확인입니다.
공식 도움말은 Console에도 claude.ai와 같은 이메일로 로그인할 것을 권합니다. 연결 오류가 나면 몇 시간 뒤 다시 시도하라고 안내합니다. 이 글을 위해 실제 계정 연결이나 API 호출을 실행한 것은 아니며, 위 경로는 현재 공식 안내를 옮긴 것입니다.
메뉴가 없거나, 잔액을 다 쓰면
API credits가 없다면 먼저 대상 요금제인지, 가입 7일이 지났는지, 신청 권한이 있는지 확인합니다. 모바일 앱이 아니라 웹에서도 보이지 않는지 확인하세요. 공식 안내에는 순차 적용 중이라는 설명도 있습니다. 조건을 갖췄는데 계속 보이지 않으면 새 조직을 반복 생성하기보다 지원팀에 문의하는 편이 낫습니다.
크레딧은 달력의 매월 1일이 아니라 구독 결제 주기에 맞춰 들어오고, 남은 금액은 다음 주기로 이월되지 않습니다. 연간 구독도 크레딧은 매달 지급됩니다. 정확한 종료일은 Console에 표시된 만료일로 확인하세요.
월간 크레딧은 구매한 크레딧보다 먼저 쓰입니다. 소진 뒤 다른 구매 잔액이나 자동 충전이 있다면 API 사용이 계속될 수 있고, 다른 잔액이 없다면 다음 지급까지 요청이 멈춥니다. 영업팀을 통한 청구 계약이 있다면 초과분은 기존 계약대로 청구됩니다. 초과 사용료가 Claude 구독료에 자동 합산되는 구조는 아닙니다.
Team은 조직의 API 키 사용자들이 잔액을 함께 씁니다. 실험용 작업 하나가 전부 소진하지 않도록, 팀 소유자는 필요하면 Console의 워크스페이스별 지출 한도를 검토할 수 있습니다.
지금 필요한 것이 대화형 코딩 한도의 해소라면 API 크레딧과는 별개의 문제로 보세요. 이미 API로 돌리는 작업이 있다면, 새 결제를 하기 전에 대상 조직과 남은 크레딧·만료일을 확인하는 것이 먼저입니다. 아직 API를 쓰지 않는다면 소멸이 아까워서 급히 자동화를 만들 필요는 없습니다. 옮길 만한 반복 업무가 생겼을 때 활용해도 됩니다.