Claude Code 요금제 가이드 2026: Pro, Max, Team, API와 손익분기점

“Pro를 결제했는데 왜 API 비용이 또 청구됐을까?” Claude Code 비용을 처음 정리할 때 가장 많이 생기는 혼란이다. 구독 사용량, 한도 이후의 추가 사용량, API 키로 실행한 자동화를 하나의 지갑처럼 생각하면 실제 청구 경로를 설명할 수 없다.

같은 Claude Code 명령을 실행하더라도 인증 방식과 실행 모드에 따라 차감되는 곳이 달라진다. 비용을 판단하려면 작업마다 인증 방식, 대화형인지 자동화인지, 사용 모델, 한도 도달 여부, 추가 과금 허용 여부를 함께 기록해야 한다. 단순 요금표만으로는 “이번 작업이 무엇을 썼는가”라는 운영 질문에 답할 수 없다.

이 글은 2026년 7월 22일 기준으로 공식 Claude 플랜 및 가격, Claude API 가격, Claude Code 비용 관리, Pro 및 Max의 Claude Code 과금 안내, Agent SDK 최신 과금 공지를 대조해 검증했다. 가격은 바뀔 수 있으므로 구매나 갱신 직전에는 공식 페이지를 다시 확인해야 한다.

먼저 기억할 다섯 가지

• 터미널이나 IDE에서 구독 계정으로 인증한 대화형 Claude Code는 Pro, Max, Team, Enterprise의 플랜 사용 한도를 소모한다.
• 플랜 한도 이후의 추가 사용량은 별도 종량제다. 사용자가 추가 사용을 활성화했을 때만 구독료와 별도로 청구된다.
• claude -p, Claude Agent SDK, 서드파티 앱을 위한 별도 월간 크레딧 제안은 중단됐고 현재 이용할 수 없다. 구독 인증으로 실행하면 여전히 구독 한도를 사용한다.
• ANTHROPIC_API_KEY로 인증한 자동화는 Claude API 종량제이므로 예산, 알림, 재시도 횟수와 중단 조건을 따로 둬야 한다.
• 한 번 한도에 도달했다고 바로 업그레이드하지 말고, 7일 동안 중단 시간과 절약 시간, 검토 후 재작업을 측정한 뒤 결정한다.

과금 경로부터 분리하기

어느 지갑에서 비용이 나가는지는 인증 방식이 결정하고, 구독 한도가 어떻게 쓰이는지는 실행 모드가 결정한다.

flowchart TD
  A[Claude Code 사용] --> B{인증 방식}
  B -->|구독 OAuth| C[Pro / Max / Team 한도]
  B -->|API 키| E[Claude API 종량제]
  C --> D{실행 모드}
  D -->|대화형 터미널 또는 IDE| I[플랜 사용 한도]
  D -->|claude -p 또는 Agent SDK| I
  C --> F{플랜 한도 도달}
  F -->|대기| G[한도 초기화]
  F -->|추가 사용 승인| H[표준 API 요금으로 추가 과금]

Pro 또는 Max로 인증한 대화형 세션은 Claude 웹, 데스크톱, 모바일 앱과 사용량을 공유한다. 사용 제한에는 5시간 단위의 순환 한도와 주간 한도가 함께 적용된다. 모델, 대화 길이, 읽는 파일 수, 도구 호출에 따라 소비량이 달라지므로 고정된 “메시지 몇 회”로 환산할 수는 없다.

Anthropic은 원래 2026년 6월 15일부터 claude -p와 Agent SDK에 별도 월간 크레딧을 적용할 계획이었다. 그러나 6월 16일 업데이트에서 이 변경을 중단했다. 현재 받을 수 있거나 사용할 수 있는 별도 크레딧은 없다. 구독 OAuth로 실행한 claude -p와 Agent SDK는 구독 사용 한도에서 차감되고, API 키 인증은 계속 API 종량제로 청구된다. 도움말 상단 배너 아래에 남아 있는 내용은 과거 제안이므로 현재 예산에 반영하면 안 된다.

2026년 7월 22일 공식 플랜 기준

선택지	공개 가격	적합한 경우	결제 전에 확인할 항목
Pro	연 $200 결제 시 월 환산 $17, 또는 월 $20	학습, 가벼운 수정, 간헐적 코드 리뷰	실제 업무가 7일 동안 몇 번 멈췄는가
Max 5x	월 $100	매일 개발하는 개인과 긴 세션	대기 손실이 월 $100보다 큰가
Max 20x	월 $200	여러 저장소를 다루는 고강도 작업	Max 5x 주간 한도가 납기를 위협하는가
Team Standard	연간 결제 시 좌석당 월 $20, 월간 결제 시 $25	SSO와 중앙 결제가 필요한 2–150명 조직	관리자 기능이 팀 플랜 비용을 정당화하는가
Team Premium	연간 결제 시 좌석당 월 $100, 월간 결제 시 $125	코딩 사용량이 많은 일부 구성원	누가 Standard의 5배 사용량을 실제로 필요로 하는가
Enterprise	좌석당 월 $20에 API 사용료 별도	SCIM, 감사 로그, 보존, 세밀한 통제가 필요한 조직	보안 요건과 종량제 예산을 확정했는가
Claude API	모델별 token 종량제	CI, 야간 작업, 측정 가능한 자동화	상한, 알림, 재시도, 중단 조건이 있는가

세금, 지역, 모바일 앱스토어 가격은 다를 수 있다. Max는 월간 결제만 제공된다. Team 조직은 Standard와 Premium 좌석을 섞을 수 있으므로 전원을 Premium으로 바꾸기 전에 측정 가능한 소규모 파일럿을 운영하는 편이 낫다.

Claude Code에 맡길 범위와 사람이 결정할 범위

업무	Claude Code에 맡길 일	사람이 결정할 일
사용 로그 정리	작업, 시간, 한도 도달, 모델을 CSV 형식으로 통일	중단된 시간의 금전적 가치
API 비용 추정	입력, 출력, 캐시 token으로 월 비용 계산	필요한 품질과 허용 가능한 모델
플랜 비교	공개 가격을 하나의 표로 정규화	세금, 계약, 해지, 보안 조건
비용 절감	과도한 로그, 오래된 맥락, 비싼 모델 사용 탐색	어느 단계까지 낮은 성능의 모델을 허용할지
팀 배정	측정값을 바탕으로 좌석 후보 순위 제시	Premium 대상자와 지출 승인자

“가장 싼 플랜을 골라 줘”라고만 요청하면 납기 위험과 검토 비용이 빠진다. 계산, 데이터 정리, 후보 생성은 Claude Code에 맡길 수 있지만 사업 영향, 계약과 권한에 관한 책임은 사람이 가져야 한다.

사용 사례 1: 개인 개발자가 Pro를 7일간 측정한다

입력: 작업명, 시작·종료 시각, 한도로 중단된 횟수, 재작업 시간.

출력: 주간 절약 시간, 중단 비용, Max의 손익분기점.

사람의 확인: 한도가 실제 납기에 영향을 줬는가, 아니면 프롬프트 축소와 깨끗한 맥락으로 해결할 수 있는가?

버그 수정, 작은 기능, 테스트, 문서는 Pro부터 시작한다. 유효한 작업이 반복해서 멈추고 기다리는 가치가 Pro와 Max 5x의 월 $80 차이를 넘을 때 Max 5x를 검토한다. 원인이 큰 로그나 오래된 대화라면 먼저 Claude Code 컨텍스트와 token 최적화를 적용해 입력을 줄인다.

사용 사례 2: 소규모 팀이 좌석 유형을 섞는다

입력: 구성원별 활동 일수, 업무 유형, 한도 도달, 검토 후 재작업, 필요한 관리 기능.

출력: Standard 및 Premium 후보와 90일 파일럿 예산.

사람의 확인: SSO, 퇴사자 계정 회수, 감사, 데이터 보존, 조달 기준을 충족하는가?

Team은 2–150명을 지원한다. 마이그레이션, 장시간 리뷰, 대규모 리팩터링을 맡은 일부 구성원에게 Premium을 시험하고 나머지는 Standard로 시작한다. 사용량을 늘리는 결정이 무분별한 권한 확대로 이어지지 않도록 Claude Code 권한 설정 가이드와 함께 검토한다.

사용 사례 3: 정기 작업에 구독 한도와 API 예산을 구분한다

입력: 일일 실행 횟수, 입력·출력 token, 캐시 사용량, 재시도 횟수.

출력: 월 예상 비용, 성공 1회당 비용, 자동 중단 조건.

사람의 확인: 비대화형 작업을 구독 한도에서 실행할지, API 키를 사용해 명시적인 종량제 예산으로 관리할지?

CI 로그 요약, 의존성 업데이트 PR 초안, 티켓 분류는 결과와 실행량을 측정하기 쉽다. 반대로 범위 없는 기능 구현은 정기 작업에 적합하지 않다. 모든 실행에 시작·종료 시각, 인증 방식, 실행 모드, 모델, 실패 원인을 남긴다. 예산 제한이 없는 재시도 루프는 성공한 작업 자체보다 더 큰 비용을 만들 수 있다.

바로 실행하는 Claude API 비용 계산기

2026년 7월 22일 기준 Sonnet 5의 출시 특별 가격은 8월 31일까지 적용된다. 입력은 MTok당 $2, 출력은 $10, 5분 캐시 쓰기는 $2.50, 캐시 읽기는 $0.20이다. 9월 1일부터 예정된 표준 가격은 입력 $3, 출력 $15, 캐시 쓰기 $3.75, 캐시 읽기 $0.30이다.

Opus 4.8은 입력과 출력이 각각 MTok당 $5와 $25이며 캐시 쓰기 $6.25, 읽기 $0.50이다. Haiku 4.5는 입력 $1, 출력 $5, 캐시 쓰기 $1.25, 읽기 $0.10이다.

// estimate-claude-api-cost.mjs
const rates = {
  sonnet5Intro: { input: 2, output: 10, cacheWrite: 2.5, cacheRead: 0.2 },
  sonnet5Standard: { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.3 },
  opus48: { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.5 },
  haiku45: { input: 1, output: 5, cacheWrite: 1.25, cacheRead: 0.1 },
};

const [model = "sonnet5Intro", days = "20", input = "0.8", output = "0.15",
  cacheWrite = "0.05", cacheRead = "0.4"] = process.argv.slice(2);
const rate = rates[model];
if (!rate) throw new Error(`Unknown model: ${model}`);

const usage = [days, input, output, cacheWrite, cacheRead].map(Number);
if (usage.some((value) => !Number.isFinite(value) || value < 0)) {
  throw new Error("Usage values must be non-negative numbers");
}

const [activeDays, inputMTok, outputMTok, writeMTok, readMTok] = usage;
const dailyUSD = inputMTok * rate.input + outputMTok * rate.output
  + writeMTok * rate.cacheWrite + readMTok * rate.cacheRead;

console.log(JSON.stringify({
  model,
  activeDays,
  dailyUSD: Number(dailyUSD.toFixed(2)),
  monthlyUSD: Number((dailyUSD * activeDays).toFixed(2)),
}, null, 2));

실행 명령은 다음과 같다.

node estimate-claude-api-cost.mjs sonnet5Intro 20 0.8 0.15 0.05 0.4

예제 결과는 활동일 하루 $3.31, 20일 기준 $66.10이다. 실제 예산을 계산할 때는 예제 token 값을 API 응답이나 청구 데이터의 실측값으로 바꿔야 한다.

Max 손익분기점 계산하기

고정 요금제가 유리한지는 사용 횟수가 아니라 실제로 절약한 시간의 가치로 비교한다.

// plan-break-even.mjs
const [plan = "Max 5x", price = "100", hourlyValue = "50", savedHours = "3"] =
  process.argv.slice(2);
const values = [price, hourlyValue, savedHours].map(Number);
if (values.some((value) => !Number.isFinite(value) || value < 0)) {
  throw new Error("Price, hourly value, and saved hours must be non-negative numbers");
}

const [monthlyPriceUSD, hourUSD, hours] = values;
const breakEvenHours = hourUSD === 0 ? null : monthlyPriceUSD / hourUSD;
const savedValueUSD = hourUSD * hours;

console.log(JSON.stringify({
  plan,
  monthlyPriceUSD,
  savedValueUSD,
  netValueUSD: savedValueUSD - monthlyPriceUSD,
  breakEvenHours,
}, null, 2));

node plan-break-even.mjs "Max 5x" 100 50 3

시간당 가치가 $50이라면 Max 5x는 한 달에 2시간을 실제로 절약했을 때 손익분기점에 도달한다. 출력 검토, 잘못된 변경 수정, 실패 복구에 쓴 시간은 절약 가치에서 빼야 한다.

청구 예상이 어긋나는 여섯 가지 함정

1. ANTHROPIC_API_KEY가 환경에 남아 있다

원인: 구독 인증을 쓰려 했더라도 유효한 API 키가 있으면 작업이 API 과금 경로로 들어갈 수 있다.

해결: 긴 작업 전에 /status로 인증 방식을 확인한다. 구독 로그인으로 돌아가려면 PowerShell에서 Remove-Item Env:ANTHROPIC_API_KEY, bash에서 unset ANTHROPIC_API_KEY를 실행한 뒤 /login을 다시 사용한다.

2. /usage의 달러 표시를 청구서로 해석한다

원인: 세션의 달러 금액은 API 사용자를 위한 로컬 추정치이며 Pro나 Max 구독 청구서가 아니다.

해결: 구독 사용량은 플랜 한도 표시로 보고, API 청구는 Claude Console을 기준으로 확인한다.

3. 중단된 Agent SDK 크레딧 제안을 예산에 넣는다

원인: 공식 도움말 하단에는 시행 전 계획이 역사 자료로 남아 있지만, 현재 상단 공지는 변경 중단과 별도 크레딧 미제공을 명시한다.

해결: 과거 계획을 사용 가능한 잔액으로 보지 않는다. 각 작업을 interactive, agent-sdk-subscription, api-key로 표시하고 현재 인증 경로에 따라 계산한다.

4. 연간 결제의 월 환산액을 실제 월 결제로 본다

원인: Pro의 $17은 연 $200를 먼저 결제했을 때의 월평균이지, 매달 $17씩 결제하는 옵션이 아니다.

해결: 예산표에서 당장 나가는 현금과 월 환산 비용을 별도 열로 관리한다.

5. 모델이 달라도 같은 문장의 token 수가 같다고 가정한다

원인: Anthropic 설명에 따르면 Sonnet 5와 Opus 4.7 이상이 사용하는 새 tokenizer는 같은 고정 텍스트에서 이전 tokenizer보다 약 30% 많은 token을 만들 수 있다. 차이는 작업 특성에 따라 달라진다.

해결: 가격표의 MTok 단가만 비교하지 말고, 대표 입력을 고정해 각 후보 모델을 직접 측정한다.

6. 한도에 닿을 때마다 업그레이드한다

원인: 지나치게 긴 로그, 무관한 파일, 오래된 대화, 범위가 큰 작업은 피할 수 있는 사용량을 만든다.

해결: 입력을 필터링하고 작업을 나눈 뒤 새 세션에서 다시 측정한다. 7일간의 실제 업무가 계속 중단될 때만 업그레이드를 검토한다.

매주 15분 의사결정 루프

1. /status로 인증 방식을, /usage로 플랜 사용 상태를 확인한다.
2. 작업별 모델, 한도 도달, 절약 시간, 재작업 시간을 한 줄로 기록한다.
3. 자동화는 실행 횟수와 입력·출력·캐시 쓰기·캐시 읽기 token을 합산한다.
4. 두 계산기를 실행해 API 예상 비용과 플랜 손익분기점을 갱신한다.
5. 비효율적인 컨텍스트 사용과 실제 한도 부족을 분리한다.
6. 구독이나 계약을 바꾸기 직전에 공식 가격과 Agent SDK 최신 공지를 다시 확인한다.

처음 시작한다면 Claude Code 시작 가이드부터 확인하고, 종량제 구조를 더 자세히 계산하려면 LLM API 비용 가이드를 읽으면 된다.

비용 통제를 저장소에 적용하기

Claude Code Setup Guide는 인증, 권한, CLAUDE.md, hooks, CI 통제를 한 흐름으로 정리하려는 독자를 위한 이 글의 유일한 다음 단계다. 영어로 제공되는 유료 가이드이며, 가격 비교에 그치지 않고 API 키 혼용, 예산 누락, 검증 누락을 예방하는 데 초점을 둔다.

실제로 확인한 결과

API 계산기는 Sonnet 5 출시 특별 가격, 활동일 20일, 하루 입력 0.8 MTok, 출력 0.15 MTok, 캐시 쓰기 0.05 MTok, 캐시 읽기 0.4 MTok으로 실행했다. 결과는 하루 $3.31, 월 $66.10이었다. 손익분기점 계산기는 Max 5x 월 $100과 시간당 가치 $50을 넣었을 때 월 2시간을 반환했다. 알 수 없는 모델과 음수 입력은 오류로 종료된다. 이는 계산 로직을 확인한 결과이며 실제 청구를 증명하지 않는다. 구독료는 Claude Billing에서, API 사용료는 Claude Console에서 확인해야 한다.