본문으로 건너뛰기

클로드 구독과 API 차이 — 어느 플랜에 API가 딸려 오나

개발 가이드약 8분 읽기비교표복사 양식점검 카드
핵심 요약7개 절 · 약 8분

구독과 API는 계정도 청구도 따로지만, Max·Team에는 매달 API 몫이 딸려 와요. 플랜별 몫과 쓰는 곳, 여러 명·자동화로 쓸 때 키로 나눠 쓰는 길까지 정리했어요.

읽는 분
Claude 구독을 쓰면서 API도 필요한지, 어느 플랜을 골라야 하는지 견주는 개발자·팀 담당자
끝나면
구독과 API 중 어느 쪽으로 낼지 고르고, Max·Team에 딸려 오는 API 몫을 어디에 쓸 수 있는지 알아요.
이 글의 목차 (7개 절)
01

구독과 API는 다른 상품이에요

클로드 구독(Pro·Max·Team)은 claude.ai 대화·앱·Claude Code에서 쓰는 상품이고, API는 Claude Console에서 따로 열어 쓰는 상품이에요. Console 조직도 청구도 따로예요.

예외는 Max와 Team이에요. 매달 API 크레딧이 딸려 오고, Free·Pro·Enterprise에는 없어요.

여러 명이 나눠 쓰거나 자동화로 부른다면, 키마다 한 달 한도를 거는 원포트 AI API 크레딧이 관리하기 쉬워요.

세 가지 길 견주기 — 2026년 10월 17일 확인
세 가지 길 견주기 — 2026년 10월 17일 확인
쓰는 곳Claude 구독claude.ai 웹·데스크톱·모바일 앱 대화 · Claude Code(유료 플랜)Claude Console API내 앱·자동화에서 부르는 Claude API · Console Playground원포트 AI API 크레딧내 앱·자동화에서 부르는 API · 키 하나로 여러 회사 모델
사는 곳과 계정Claude 구독claude.ai 계정에서 플랜 구독Claude Console APIConsole 조직의 Settings > Billing 「Buy credits」원포트 AI API 크레딧스쿨오더(학교)·오피스오더(회사) 주문서 · 원화
값을 매기는 방식Claude 구독플랜 정액(미화) · 5시간·주간 사용량 한도Claude Console API쓴 토큰만큼 선불 크레딧을 사용해요원포트 AI API 크레딧쓴 토큰만큼 크레딧을 사용해요
남은 몫 처리Claude 구독Max·Team의 월 API 몫은 결제 주기 끝에 사라져요Claude Console API산 크레딧은 구매일부터 1년 뒤 만료 · 환불 안 돼요원포트 AI API 크레딧개인·기업 선불 잔액은 만료되지 않아요(국고·사업비는 계약서대로)
여러 명 나눠 쓰기Claude 구독Team은 2~150명 좌석Claude Console API조직 안 워크스페이스마다 지출 상한원포트 AI API 크레딧사람마다 키 · 키마다 한 달 한도

Claude 쪽은 Anthropic 도움말과 가격표에서 옮겼어요. 플랜과 값은 바뀔 수 있어요.

02

플랜마다 API가 딸려 오는지 한눈에

Claude 플랜별 공식 값과 매달 딸려 오는 API 몫(미화)
Claude 플랜별 공식 값과 매달 딸려 오는 API 몫(미화)
Free공식 값$0매달 딸려 오는 API 몫없음비고Claude Code 없음
Pro공식 값1년 결제면 월 $17($200 선결제) · 월 결제 $20매달 딸려 오는 API 몫없음비고Claude Code 포함
Max 5x공식 값월 $100매달 딸려 오는 API 몫$100비고월 결제만
Max 20x공식 값월 $200매달 딸려 오는 API 몫$200비고월 결제만
Team 표준 좌석공식 값좌석당 1년 결제면 월 $20 · 월 결제 $25매달 딸려 오는 API 몫좌석당 $20(팀 합산)비고2~150명 팀
Team 프리미엄 좌석공식 값좌석당 1년 결제면 월 $100 · 월 결제 $125매달 딸려 오는 API 몫좌석당 $100(팀 합산)비고표준 좌석의 5배 사용량
Enterprise공식 값좌석당 월 $20(1년 결제 · 20석부터) + API 요율로 쓴 만큼매달 딸려 오는 API 몫없음비고쓴 만큼 사용료가 붙어요

2026년 10월 17일 claude.com/pricing과 Anthropic 도움말(11049741 · 17154008)로 확인했어요. 세금은 별도예요. Max 값은 웹에서 구독할 때 기준이고, 앱 값은 다를 수 있어요. Team의 API 몫은 좌석마다 따로 가지 않고 한 잔액으로 합쳐지며, 한 달 $500까지예요.

03

매달 딸려 오는 API 몫, 쓰는 곳과 못 쓰는 곳

같은 조직에 따로 산 크레딧이 있어도 월 몫을 먼저 사용해요.

연결된 조직에서 API 키를 가진 사람은 모두 같은 잔액을 써요. 사람·프로젝트별로 나누려면 Console에서 워크스페이스마다 지출 상한을 걸어요.

월 몫을 다 쓰면 산 크레딧이나 자동 재충전(auto-reload)이 있을 때 거기서 이어져요. Anthropic 영업을 거쳐 청구서로 내는 조직은 넘친 몫이 평소처럼 청구돼요. 둘 다 아니면 다음 몫이 들어올 때까지 API 호출이 멈추고, 플랜 값에 얹혀 청구되지는 않아요.

Claude Code를 구독으로 쓸지 API 키로 쓸지는 클로드 코드 가격 글에서 견줘요.

  1. 플랜에 든 지 7일이 지나야 받을 수 있어요. 앱에서 구독했어도 받는 건 claude.ai 웹에서 해요.
  2. Max는 Settings > Billing, Team은 소유자(Owner·Primary Owner)가 Organization settings > Billing에서 API credits 칸의 「Link organization」을 눌러요.
  3. 몫을 받을 Console 조직을 고르거나 새로 만들어요. 그 조직에서 Owner·Admin·Billing 역할이 있어야 해요.
  4. 조직은 하나만 연결되고 직접 바꿀 수 없어요. 바꾸려면 Anthropic 지원팀에 연락해요.
월 API 몫을 쓸 수 있는 자리
월 API 몫을 쓸 수 있는 자리
Claude API(Messages API · Message Batches API)월 API 몫써요
Claude Console의 Playground월 API 몫써요
Claude Managed Agents · Claude Agent SDK월 API 몫써요
터미널·IDE·데스크톱·웹의 대화형 Claude Code월 API 몫못 써요
플랜 사용량을 넘겨 이어 쓰는 몫(extra usage)월 API 몫못 써요
Amazon Bedrock · Google Cloud Vertex AI · Microsoft Foundry의 Claude월 API 몫못 써요
04

사용량을 넘겨 이어 쓰는 돈은 또 따로예요

Claude 쪽에서 「크레딧」이라 부르는 돈이 셋이에요.

Claude에서 크레딧이라 부르는 세 가지
Claude에서 크레딧이라 부르는 세 가지
usage credits켜는 곳Pro·Max — claude.ai Settings > Usage에서 「Enable」어디에 쓰나플랜 한도를 넘긴 대화·Claude Code를 API 표준 단가로 이어 써요언제 사라지나대부분 만료되지 않아요(일본 등 일부 지역은 구매 6개월 뒤)
월 API 크레딧켜는 곳Max·Team — 「Link organization」으로 연결한 Console 조직어디에 쓰나Claude API · Playground · Managed Agents · Agent SDK언제 사라지나결제 주기 끝
Console에서 산 크레딧켜는 곳Console Settings > Billing의 「Buy credits」어디에 쓰나Claude API · Playground · API 키로 붙인 Claude Code언제 사라지나구매일부터 1년 뒤(환불 안 돼요)
05

여러 명·자동화·들쭉날쭉할 땐 API가 나아요

ChatGPT도 API 사용을 구독과 따로 청구해요. 한 달에 얼마나 쓰면 어느 쪽이 덜 드는지는 플러스와 크레딧을 견준 글에서 셈해요.

상황별로 맞는 쪽
상황별로 맞는 쪽
혼자 매일 오래 대화맞는 쪽구독이유값이 정해져 있고 앱·웹에서 바로 써요. 계정은 원화로도 사요
터미널에서 대화형 코딩맞는 쪽구독 또는 API 키이유월 API 몫으로는 못 써요. 구독 한도로 쓰거나 API 키로 붙여요
여러 명이 한 잔액맞는 쪽API이유사람마다 키를 나누고 키마다 한도를 걸어요
자동화·배치·앱에 넣기맞는 쪽API이유구독은 사람이 앱에서 쓰는 상품이에요
달마다 사용량이 들쭉날쭉맞는 쪽API이유쓴 만큼만 크레딧을 사용해요. 구독은 덜 쓴 달에도 값이 같아요
학교·회사 구매맞는 쪽용도대로이유계정도 키도 스쿨오더·오피스오더에서 원화로 사고 증빙을 받아요
06

원포트 키로 Messages API 부르기

원포트 키로는 Anthropic SDK 모양 그대로 Messages API를 불러요. base_url은 https://oneport.kr 이고 끝에 /v1을 붙이지 않아요. SDK가 /v1/messages를 붙여요.

이 문(POST /v1/messages)은 Claude 모델만 받아요. 다른 회사 모델은 POST /v1/chat/completions로 불러요.

1 크레딧 = 부가세 포함 2원어치예요.

사람마다 키를 따로 만들어 나누고, 키마다 한 달 한도를 걸어요. 키 원문은 만들 때 한 번만 보여요.

  1. 원포트 AI API 크레딧을 사고 키를 받아요. 쓰던 키가 없으면 받을 메일로 「키 받기」 링크가 와요.
  2. 터미널에서 ONEPORT_API_KEY에 키를 넣고 아래 복사 상자를 실행해요.
  3. 답이 오면 GET /v1/key로 이 키의 오늘·이번 달 남은 한도를 봐요.
CLI · 설정

원포트 키로 Messages API 한 번 부르기

curl https://oneport.kr/v1/messages \
  -H "x-api-key: $ONEPORT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":256,"messages":[{"role":"user","content":"안녕하세요"}]}'

401 「API 키가 없어요. Authorization: Bearer 또는 x-api-key 헤더로 보내주세요.」

원인·확인
키 헤더가 빠졌거나 ONEPORT_API_KEY가 비어 있어요.
해결 방법
x-api-key 헤더에 sk-so- 로 시작하는 키가 들어가는지 봐요.

404가 나요

원인·확인
base_url 끝에 /v1을 붙이면 주소가 /v1/v1/messages가 돼요.
해결 방법
base_url을 https://oneport.kr 로 고쳐요.

429 「이 키의 이번 달 사용 한도에 닿았어요.」 또는 「이 키의 오늘 사용 한도에 닿았어요.」

원인·확인
그 키에 건 한 달 또는 하루 한도에 닿았어요. 하루 한도는 한국 시간 내일 0시에 다시 열려요. 다른 키는 그대로 불려요.
해결 방법
GET /v1/key로 남은 한도와 기한을 보고, 더 써야 하면 키 한도를 정한 관리자에게 말해요.

400 「… 이 문은 anthropic 모델만 받아요.」

원인·확인
Claude가 아닌 모델을 /v1/messages에 넣었어요.
해결 방법
채팅 모델은 OpenAI SDK의 base_url을 https://oneport.kr/v1 로 두고 불러요(POST https://oneport.kr/v1/chat/completions). pro 등급은 /v1/responses로만 불려요.
07

계정으로 살지, 키로 나눠 쓸지

용도로 갈라요. 한 사람이 앱에서 대화를 많이 쓰면 계정을, 호출·앱·여러 사람이면 키를 사요.

계정은 Claude Pro·Team·Max를 스쿨오더(학교)·오피스오더(회사)에서 개월 단위로 원화로 사요. 키는 원포트 AI API 크레딧을 사서 만들어요.

학교·회사 이름으로 사면 견적서(직인)와, 결제 방법에 따라 세금계산서(사업자등록번호나 고유번호 필요)·현금영수증·카드 매출전표를 받아요. 결재가 먼저면 견적서부터 문의해요.

자주 묻는 질문

Pro만 쓰는데 API도 같이 부를 수 있나요?

아니요. Pro에는 매달 딸려 오는 API 몫이 없어요. Console 조직을 따로 열어 크레딧을 사거나, 원포트 같은 다른 곳의 API 키를 써요.

Max의 API 몫으로 claude -p 를 돌릴 수 있나요?

연결한 Console 조직의 API 키로 직접 돌리면 돼요. 플랜으로 로그인한 채 돌리면 플랜 사용량에서 빠지고, GitHub Action·IDE 확장·데스크톱 앱이 시작한 실행은 -p 여도 Claude Code 사용으로 세어요.

Team 좌석을 늘리면 API 몫도 늘어나나요?

네. 몫이 들어올 때의 좌석 수로 다시 세요. 표준 3석과 프리미엄 2석이면 $260이고, 프리미엄 1석을 더하면 다음 주기부터 $360이에요.

출처와 확인일

함께 보면 좋은 글과 도움말

← 블로그 전체 목록 보기