Claude Code 요금【2026년판】— 구독과 API 종량제, 실제 금액과 손익분기점

Claude Code에는 완전히 별개의 두 가지 요금 체계가 있으며, “얼마나 드는가”에 대한 혼란은 거의 모두 이 둘을 혼동해서 생깁니다. claude.ai 구독은 사용량 한도가 있는 정액제에 도구가 포함된 형태입니다. API 키는 월정액 없는 토큰 종량제이며 한도가 없습니다. 이 페이지에는 두 경로의 현재 수치, 선택 계산법, 한 달 실제 비용, 그리고 일본에서 결제하는 방법을 한곳에 정리했습니다.

요금은 2026년 10월 3일에 확인: claude.com/pricing 및 Anthropic API 요금 문서를 참조하세요. Kunavo의 토큰 단가는 모델 카탈로그에서 실시간으로 불러옵니다.

두 경로 나란히 보기

구독 비용

Claude Code는 claude.ai 유료 플랜에 포함됩니다. Anthropic의 설치 문서에는 무료 플랜에서는 Claude Code를 사용할 수 없다고 명시되어 있습니다. Pro는 월 $20(연간 결제 시 월 환산 $17, 일시불 $200)이며 플랜 한도 내에서 작업하는 개발자 1명에게 해당합니다. Max는 월 $100부터이며 한도에 계속 도달하는 사용자를 위한 것입니다. Team 및 Enterprise에는 시트 단위 할당량과 관리자용 지출 제어가 추가됩니다.

일본에서 특히 중요한 점은 두 가지입니다. 결제가 달러 기준 정기 결제이므로 해외 결제를 지원하는 신용카드가 필요하고 카드사의 해외 이용 수수료가 매월 추가됩니다. 또 하나는 사용량 한도가 Claude 채팅과 공유된다는 점입니다. 오후 내내 채팅으로 논의하면 코딩 세션도 같은 사용량 산정 시간 구간의 한도를 소모합니다.

API 경로의 비용

이 경로에는 월정액이 없고 토큰 단위로 결제합니다. 1M 토큰당 USD 기준이며, 직접 비교할 수 있도록 Anthropic의 공식 표를 나란히 표시합니다.

캐시된 입력은 입력 요금의 10%, 5분 캐시 쓰기는 125%로 청구됩니다. Claude Code는 매 단계 전체 대화를 다시 읽으므로 실제 운영 청구액은 주로 이 두 계수에 의해 결정됩니다. 모델 선택보다 더 큰 영향을 미칩니다.

1단계의 실제 비용

“에이전트 단계”란 하나의 작업에서 모델과 한 번 왕복하는 것을 의미합니다. 입력은 시스템 프롬프트 + 대화 + 파일 컨텍스트이고, 출력은 한 번의 편집 또는 설명입니다. 실제 측정치는 대략 입력 25,000 / 출력 1,200 토큰입니다. Kunavo 요금 기준:

손익분기점

손익분기점은 근무한 날짜가 아니라 실행한 단계 수로 결정됩니다. Sonnet 5의 1단계 비용이 $0.043라면 월 $20 Pro는 약 460단계, 20단계 작업 기준 약 23건에 해당합니다. 이보다 적게 사용하면 종량제가 더 저렴하고 사용하지 않은 달에는 $0입니다. 더 많이 사용하면 플랜 한도에 도달하기 전까지 구독이 유리합니다.

자신의 실제 수치를 알고 싶다면 Claude Code에서 /usage를 실행해 네 가지 토큰 수를 확인하고 그대로 입력하세요:

# Claude Code 1 セッションの実費を、そのセッションのトークン数から出す。
# 4 つの実数は Claude Code の中で /usage を実行すれば取れる。
RATES = {  # Kunavo の 1M トークンあたり USD: (input, output)
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-4-6": (2.10, 10.50),
    "claude-sonnet-5":   (1.40, 7.00),
    "claude-opus-5":     (3.50, 17.50),
}

def session_cost(model, inp, out, cache_read=0, cache_write=0):
    i, o = RATES[model]
    return (
        inp / 1e6 * i                   # 新規入力
        + out / 1e6 * o                 # 出力（thinking トークンを含む）
        + cache_read / 1e6 * i * 0.10   # キャッシュ読み出し: 入力レートの 10%
        + cache_write / 1e6 * i * 1.25  # 5 分キャッシュ書き込み: 125%
    )

print(session_cost("claude-sonnet-5", 1_200, 5_300, 940_000, 50_000))

Claude Code를 Kunavo로 연결하기

Claude Code는 Anthropic 호환 엔드포인트라면 어디와도 통신할 수 있습니다. 환경 변수 두 개를 설정하면 CLI 설치와 사용 방식은 바꾸지 않고 종량제 경로로 전환할 수 있습니다:

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

모델 지정 행은 Claude Code의 기본 모델과 opus 별칭이 가리키는 최신 Opus를 Kunavo가 아직 제공하지 않는 경우 첫 요청이 404가 되는 것을 방지합니다. sonnet 별칭은 Kunavo가 제공하지 않는 Sonnet 5.5를 가리키므로 ANTHROPIC_DEFAULT_SONNET_MODEL 행이 없으면 /model sonnet, opusplan 실행 단계 및 model: sonnet로 지정한 서브에이전트가 모두 404가 됩니다. opus 별칭은 Opus 5.5(claude-opus-5-5)에 고정되며 Claude Code v2.1.280 이상이 필요합니다. 이전 버전이라면 claude update로 업데이트하세요. 키는 /app/keys에서 발급합니다. 자세한 절차는 Claude Code에 API 키를 설정하는 가이드, 오류가 발생했을 때는 401 오류 해결 방법을 참조하세요.

기업에서 사용하는 경우

구독 측의 Team / Enterprise는 시트 단위 요금에 관리자용 지출 제어를 더한 형태로 좌석마다 월 요금이 발생합니다. API 키 측에는 시트 개념이 없으며 하나의 선불 잔액을 여러 사람과 여러 컴퓨터가 공유하고, 키를 나누어 용도별(개발자별, CI, 배치) 사용량을 분리할 수 있습니다. 좌석이 채워지지 않는 달이나 사람에게 귀속되지 않는 자동 실행이 많은 경우 종량제가 시트 요금보다 예측하기 쉽습니다. 사용량은 사용량 API에서 키별로 조회할 수 있습니다.

비용을 줄이는 네 가지 방법

1. 프롬프트 캐시를 활성화하세요. 캐시된 입력은 입력 요금의 10%입니다. Claude Code는 매 단계 전체 대화를 다시 읽으므로 이것만으로도 가장 큰 조정 수단입니다. 자세한 내용은 캐시 문서를 참조하세요.
2. 관련 없는 작업 사이에는 컨텍스트를 지우세요. 하나의 긴 세션을 계속 이어가면 매 단계의 입력 토큰이 계속 늘어납니다.
3. 문제의 규모에 맞춰 모델을 선택하세요. 기본 모델을 가장 큰 모델로 설정하지 마세요. 위 표처럼 Haiku와 Opus는 단계당 비용이 약 10배 차이 납니다.
4. 내부 호출을 Haiku로 보내세요. ANTHROPIC_DEFAULT_HAIKU_MODEL를 사용하면 Claude Code 자체의 보조 호출을 더 저렴한 모델로 보낼 수 있습니다.

일본에서 결제하기

구독은 달러로 청구되는 정기 결제이며 해외 결제가 가능한 신용카드가 필요합니다. API 키의 결제 경로는 Stripe 체크아웃이며, JCB를 포함한 카드(Visa, Mastercard, Amex, JCB, UnionPay), Apple Pay, Google Pay 및 Link를 지원합니다. 선불 지갑 방식으로 최소 충전액은 $10이고 잔액은 만료되지 않습니다. 코드를 작성하지 않은 달에는 청구되지 않습니다. 국내 사업자로서의 표시 사항은 특정상거래법에 따른 표시에 정리되어 있으며, 청구 관련 자세한 내용은 청구 문서에서 확인할 수 있습니다.

요금 외 실무 — CLAUDE.md 작성법, 권한 설정, 사용량 한도가 닫힌 후 계속하는 방법 — 은 Claude Code 사용법에 정리되어 있습니다. Codex 측 종량제와 비교하려면 Codex 요금에서 동일한 계산 방식으로 비교합니다. 구독 사용량 한도에 도달했을 때의 선택지는 Claude Pro 제한에 정리했습니다.

자주 묻는 질문