구독과 API는 계정도 청구도 따로지만, Max·Team에는 매달 API 몫이 딸려 와요. 플랜별 몫과 쓰는 곳, 여러 명·자동화로 쓸 때 키로 나눠 쓰는 길까지 정리했어요.
- 읽는 분
- Claude 구독을 쓰면서 API도 필요한지, 어느 플랜을 골라야 하는지 견주는 개발자·팀 담당자
- 끝나면
- 구독과 API 중 어느 쪽으로 낼지 고르고, Max·Team에 딸려 오는 API 몫을 어디에 쓸 수 있는지 알아요.
이 글의 목차 (7개 절)
구독과 API는 다른 상품이에요
클로드 구독(Pro·Max·Team)은 claude.ai 대화·앱·Claude Code에서 쓰는 상품이고, API는 Claude Console에서 따로 열어 쓰는 상품이에요. Console 조직도 청구도 따로예요.
예외는 Max와 Team이에요. 매달 API 크레딧이 딸려 오고, Free·Pro·Enterprise에는 없어요.
여러 명이 나눠 쓰거나 자동화로 부른다면, 키마다 한 달 한도를 거는 원포트 AI API 크레딧이 관리하기 쉬워요.
| 항목 | Claude 구독 | Claude Console API | 원포트 AI API 크레딧 |
|---|---|---|---|
| 쓰는 곳 | 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 도움말과 가격표에서 옮겼어요. 플랜과 값은 바뀔 수 있어요.
플랜마다 API가 딸려 오는지 한눈에
| 플랜 | 공식 값 | 매달 딸려 오는 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까지예요.
매달 딸려 오는 API 몫, 쓰는 곳과 못 쓰는 곳
같은 조직에 따로 산 크레딧이 있어도 월 몫을 먼저 사용해요.
연결된 조직에서 API 키를 가진 사람은 모두 같은 잔액을 써요. 사람·프로젝트별로 나누려면 Console에서 워크스페이스마다 지출 상한을 걸어요.
월 몫을 다 쓰면 산 크레딧이나 자동 재충전(auto-reload)이 있을 때 거기서 이어져요. Anthropic 영업을 거쳐 청구서로 내는 조직은 넘친 몫이 평소처럼 청구돼요. 둘 다 아니면 다음 몫이 들어올 때까지 API 호출이 멈추고, 플랜 값에 얹혀 청구되지는 않아요.
Claude Code를 구독으로 쓸지 API 키로 쓸지는 클로드 코드 가격 글에서 견줘요.
- 플랜에 든 지 7일이 지나야 받을 수 있어요. 앱에서 구독했어도 받는 건 claude.ai 웹에서 해요.
- Max는 Settings > Billing, Team은 소유자(Owner·Primary Owner)가 Organization settings > Billing에서 API credits 칸의 「Link organization」을 눌러요.
- 몫을 받을 Console 조직을 고르거나 새로 만들어요. 그 조직에서 Owner·Admin·Billing 역할이 있어야 해요.
- 조직은 하나만 연결되고 직접 바꿀 수 없어요. 바꾸려면 Anthropic 지원팀에 연락해요.
| 쓰는 자리 | 월 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 몫못 써요 |
사용량을 넘겨 이어 쓰는 돈은 또 따로예요
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년 뒤(환불 안 돼요) |
여러 명·자동화·들쭉날쭉할 땐 API가 나아요
ChatGPT도 API 사용을 구독과 따로 청구해요. 한 달에 얼마나 쓰면 어느 쪽이 덜 드는지는 플러스와 크레딧을 견준 글에서 셈해요.
| 상황 | 맞는 쪽 | 이유 |
|---|---|---|
| 혼자 매일 오래 대화 | 맞는 쪽구독 | 이유값이 정해져 있고 앱·웹에서 바로 써요. 계정은 원화로도 사요 |
| 터미널에서 대화형 코딩 | 맞는 쪽구독 또는 API 키 | 이유월 API 몫으로는 못 써요. 구독 한도로 쓰거나 API 키로 붙여요 |
| 여러 명이 한 잔액 | 맞는 쪽API | 이유사람마다 키를 나누고 키마다 한도를 걸어요 |
| 자동화·배치·앱에 넣기 | 맞는 쪽API | 이유구독은 사람이 앱에서 쓰는 상품이에요 |
| 달마다 사용량이 들쭉날쭉 | 맞는 쪽API | 이유쓴 만큼만 크레딧을 사용해요. 구독은 덜 쓴 달에도 값이 같아요 |
| 학교·회사 구매 | 맞는 쪽용도대로 | 이유계정도 키도 스쿨오더·오피스오더에서 원화로 사고 증빙을 받아요 |
원포트 키로 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원어치예요.
사람마다 키를 따로 만들어 나누고, 키마다 한 달 한도를 걸어요. 키 원문은 만들 때 한 번만 보여요.
- 원포트 AI API 크레딧을 사고 키를 받아요. 쓰던 키가 없으면 받을 메일로 「키 받기」 링크가 와요.
- 터미널에서 ONEPORT_API_KEY에 키를 넣고 아래 복사 상자를 실행해요.
- 답이 오면 GET /v1/key로 이 키의 오늘·이번 달 남은 한도를 봐요.
원포트 키로 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로만 불려요.
계정으로 살지, 키로 나눠 쓸지
용도로 갈라요. 한 사람이 앱에서 대화를 많이 쓰면 계정을, 호출·앱·여러 사람이면 키를 사요.
계정은 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이에요.
출처와 확인일
- Anthropic 유료 구독과 Console 구분 안내 · 2026년 10월 17일 확인
- Anthropic 플랜 포함 API 크레딧 안내 · 2026년 10월 17일 확인
함께 보면 좋은 글과 도움말
- 개발 가이드클로드 코드가 멈췄을 때 — 내 API 키로 이어 쓰고 되돌리기클로드 코드가 세션·주간 몫을 다 써 멈췄을 때 — 모델만 바꾸면 되는 경우를 먼저 가르고, 원포트 API 키로 이어 쓴 뒤 리셋이 지나면 구독으로 되돌려요.
- 개발 가이드클로드 코드·Cursor 팀 사용량 관리 — 개발자마다 키 나누고 상한 정하기개발팀이 Claude Code·Cursor 를 쓸 때 한 지갑에서 개발자마다 API 키를 나누고, 키마다 한 달·하루에 쓸 수 있는 양을 정해 두는 길이에요.
- 결제·증빙챗지피티 월 29,000원 vs 크레딧 충전 — 질문 횟수별 손익 기준표한 달 질문 횟수와 문서 첨부 빈도에 따라 월 정액 구독과 만료 없는 크레딧 충전 중 어느 쪽이 알맞은지 비교해요.
- 도움말 매뉴얼클로드 코드(Claude Code) 가격 — 구독과 API, 원화로 쓰는 길Claude Code 를 Pro·Max·팀 구독으로 쓸 때와 API 키로 쓸 때 드는 돈을 Anthropic 공식 값으로 견주고, 원화로 사서 쓰는 길을 정리했어요.
- 도움말 매뉴얼Claude(클로드) API 결제가 안 될 때Claude 콘솔에서 크레딧 결제가 막히거나 카드가 거절될 때 확인할 것, 영수증 찾는 곳, 원화로 사는 다른 길이에요.
- 도움말 매뉴얼OpenAI·Claude API 를 원화로 사고 세금계산서 받기AI 회사에 직접 사면 달러로만 사는 API 크레딧을 원화로 사서 키 하나로 쓰고, 기관 증빙을 받아요.