Yunseon Hong

archive / / #개발

Claude Max·Team에 매달 API 크레딧이 붙는다 - 받는 법과 못 쓰는 곳

Yunseon Hong · 3분 읽기

Max 5x는 월 $100, 20x는 $200, Team은 최대 $500까지 Claude API 크레딧을 준다. Console 조직을 연결해야 받을 수 있고, 한 번 연결하면 직접 못 바꾼다. 클로드 코드 대화형 세션에는 못 쓴다.

주말에 온 Claude Code 뉴스레터 맨 끝 “Other news”에 한 줄로 지나간 소식이 있었다. Max와 Team 플랜에 매달 API 크레딧이 들어간다는 내용이다.

데스크톱 앱 개편이 메일 대부분을 차지했는데, 구독료를 내는 입장에서는 이게 제일 실속 있는 소식인 것 같다. 설정에 들어가 보니 실제로 칸이 생겨 있었다.

claude.ai 설정의 결제 화면. 맥스 플랜(Pro 대비 5배) 아래에 '새로 생성' 표시가 붙은 API 크레딧 칸이 있고, 'Max 5x 플랜에는 매월 $100 USD의 API 크레딧이 포함되어 있습니다. 크레딧을 받으려면 API 조직을 연결하세요.'라는 문구와 '조직 연결' 버튼이 보인다.

아래는 도움말 센터 안내와 Claude Platform 문서 기준이고 2026년 10월 19일에 확인했다.

얼마나 주나

플랜월 크레딧
Max 5x$100
Max 20x$200
Team Standard 좌석좌석당 $20
Team Premium 좌석좌석당 $100

Team은 좌석별 금액을 합쳐 한 덩어리로 받고 합계는 $500에서 막힌다. Standard 3석, Premium 2석이면 월 $260이다. 비영리·연구자 할인 Team도 금액은 같다.

Free, Pro, Enterprise는 대상이 아니다. 새로 가입했으면 7일이 지나야 받을 수 있다. iOS나 Android 앱에서 결제한 구독도 되지만 받는 건 웹 브라우저의 claude.ai에서 해야 한다.

받는 법

크레딧은 claude.ai 계정이 아니라 Claude Console(platform.claude.com)의 조직으로 들어간다. 그래서 둘을 잇는 단계가 있다.

  1. claude.ai에서 설정 > 결제(Max) 또는 조직 설정 > 결제(Team)로 간다.
  2. API 크레딧 칸의 조직 연결을 누른다.
  3. 기존 Console 조직을 고르거나 새로 만든다.
  4. 크레딧 약관을 확인하고 연결한다.

Console 쪽 결제 수단은 필요 없다. 들어온 크레딧은 Console의 Billing 페이지 Promotional credits 칸에 금액과 만료일이 같이 찍힌다.

권한도 양쪽에 필요하다. Max는 구독자 본인, Team은 Primary Owner나 Owner여야 하고 Console 조직에서는 Owner·Admin·Billing 중 하나여야 한다. 문서는 claude.ai와 같은 이메일로 Console에 로그인하라고 권한다.

연결 전에 한 번 생각할 것

연결한 조직은 직접 바꿀 수 없다. 플랜 하나에 조직 하나, 조직 하나에 플랜 하나만 걸린다. 나중에 옮기려면 지원팀에 문의해야 한다.

그래서 나는 아직 연결 버튼을 안 눌렀다. 문서도 “실제로 만들 조직에 연결하라”고 한다. Console 조직이 여럿이라면 크레딧으로 무엇을 만들지부터 정하고 연결하는 게 맞는 것 같다.

조직 안의 API 키와 워크스페이스는 전부 같은 잔액을 나눠 쓴다. 프로젝트별로 상한을 두고 싶으면 워크스페이스를 나누고 워크스페이스 지출 한도를 건다.

어디에 쓰고 어디에 못 쓰나

쓸 수 있는 곳은 Claude API(Messages, Message Batches), Console Playground, Claude Managed Agents, Claude Agent SDK다.

못 쓰는 곳이 더 중요하다.

  • 터미널·IDE·데스크톱·웹의 대화형 Claude Code
  • Claude, Claude Code, Cowork에서 한도를 넘겼을 때의 추가 사용량
  • Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry의 Claude

다시 말해 클로드 코드 사용량을 늘려주는 게 아니다. 플랜 한도는 그대로다.

헷갈리는 게 claude -p다. 연결한 조직의 API 키로 직접 돌리면 크레딧에서 나가고 Claude 플랜으로 로그인한 상태면 플랜 한도에서 나간다. GitHub Action, IDE 확장, 데스크톱 앱이 띄운 실행은 키와 상관없이 클로드 코드 사용으로 쳐서 크레딧 대상이 아니다.

남으면, 모자라면

크레딧은 결제 주기마다 플랜 결제 직후에 들어오고 연간 결제여도 매달 들어온다. 이월되지 않는다. 주기가 끝나면 남은 건 사라진다.

구매한 크레딧이 있으면 이 크레딧부터 쓰고 넘어간다. 구매분도 자동 충전도 없으면 API 요청이 다음 크레딧까지 멈춘다. 플랜 쪽으로 청구되는 일은 없다고 명시되어 있다.

잔액이 바닥나면 API는 이런 응답을 돌려준다.

Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.

덤으로 연결된 조직은 사용 등급(usage tier)이 최소 Start로 올라간다. 월 크레딧이 $200을 넘는 Team이면 최소 Build다. 다만 이 크레딧 사용액이 상위 등급 승급 실적으로 잡히지는 않는다.

플랜이 바뀔 때도 정해져 있다. 해지하거나 Pro로 내리면 새 크레딧은 끊기지만 받아둔 건 만료일까지 쓴다. Max 5x에서 20x로 올리면 일할 계산된 크레딧이 바로 들어오고 Max에서 Team으로 옮기면 Max 쪽 연결은 끊긴다.

같은 메일에 있던 것 하나

Claude Code 2.1.299(10월 14일)부터 터미널에서 20만 토큰이 넘는 대화를 54분쯤 놔두면 1시간짜리 프롬프트 캐시가 만료되기 전에 알아서 압축한다. 돌아와서 메시지를 보낼 때 대화 전체가 아니라 요약만 다시 처리하니 사용량이 덜 나간다.

끄려면 settings.json에 "idleCompaction": false를 넣는다. 최소 토큰 기준은 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS로 바꿀 수 있다. 크레딧과 달리 이건 업데이트만 하면 바로 적용되니, 체감은 이쪽이 더 클지도 모르겠다.

여튼 $100이 매달 사라지는 건 아까우니, 이번 주에 조직부터 정리하고 Managed Agents로 뭔가 하나 돌려봐야겠다. 돌려보면 따로 정리할 생각이다.

shareXFacebookLinkedIn

keep reading

datepostcategory
클로드 코드를 폰에서 이어받는 법 - Remote Control 설정 정리#개발
Claude Code 세션 간 메시징 정리#개발
ccbar를 Claude Code 플러그인 디렉터리에 제출했다#개발