가이드 목록으로
가격·2026년 9월 23일·최종 업데이트 2026년 10월 3일·14분 분량

Claude Code 가격 및 비용 — 구독과 API 중 어느 사용량부터 어떤 방식이 유리한가

많은 답변은 Anthropic의 구독 가격이나 대략적인 범위만 제시합니다. 여기서는 실제 Claude Code 세션의 구독 비용과 토큰 비용을 부가가치세, 유로 환산 및 어느 시점부터 어떤 방식이 유리한지를 포함해 나란히 비교합니다.

Claude Code 자체는 무료입니다. 비용이 발생하는 것은 뒤에서 작동하는 모델이며, 이용 방법은 두 가지입니다. 구독에는 월 요금에 Claude Code가 포함됩니다. Claude Pro는 월 $20입니다(연간 결제 시 월 $17, 선불 $200). Claude Max는 $100 또는 $200입니다. 이는 세금이 제외된 Anthropic의 미국 가격이며 지역에 따라 가격과 통화가 달라집니다. 독일의 개인 고객은 청구지 주소에 따라 Anthropic이 계산하는 부가가치세 19%를 납부합니다. 무료 요금제에는 Claude Code가 포함되지 않습니다. API 키를 사용하면 기본 요금 없이 토큰당 요금이 부과됩니다. Kunavo에서는 Claude Sonnet 5의 비용이 입력 토큰 100만 개당 $1,40, 출력 토큰 100만 개당 $7,00이며, 에이전트의 일반적인 한 단계는 약 $0,0434입니다(약 0,038 €). Anthropic은 기업 설치 환경에서 개발자 1명당 실제 작업한 하루의 평균 비용을 약 $13으로 제시합니다.

어느 방법이 더 저렴한지는 나눗셈으로 결정됩니다. Pro의 $20는 Kunavo에서 한 달에 약 460번의 이러한 단계에 해당합니다. 거의 매일 Claude Code를 사용하고 Pro의 한도로 충분하다면 대체로 Pro가 더 유리합니다. 간헐적으로 사용하는 경우에는 키를 사용하는 편이 더 저렴하며, 사용량이 적은 달의 비용은 $0입니다.

기준일: 2026년 9월 23일. Anthropic 수치는 claude.com/de/pricing, Anthropic 도움말 센터 및 API 가격 문서에서 가져왔으며, Anthropic은 가격과 요금제를 변경할 수 있습니다. Kunavo 가격은 Kunavo 모델 카탈로그에서 직접 가져왔습니다. 유로 금액은 2026년 9월 23일의 ECB 기준 환율로 환산했습니다(1 € = $1,1411). 참고용 수치입니다.

Claude Code 비용은 얼마인가요? 구독과 API 한눈에 보기

구독(Pro / Max)API 키(토큰별)
지불 금액월 $20부터 고정 월 요금(세금 제외 미국 가격)토큰당 요금, 기본 요금 없음
제한5시간마다 재설정되는 세션 한도와 주간 한도, Claude 채팅과 공유기간 제한 없음. 한도는 크레딧과 키별 한도입니다
여유로운 달전체 가격$0
집중적으로 사용하는 달한도에서 대기하거나 표준 API 가격으로 사용 크레딧 결제계속 실행되며 비용도 계속 발생
비용 확인/usage의 사용량 막대토큰 단위로 정확하게, 키별 집계
적합한 경우한 사람이 매일 일정하게 작업하는 경우간헐적인 작업, 사용자별 예산, CI 및 자동화

두 방식은 동시에 청구되지 않습니다. ANTHROPIC_AUTH_TOKEN 같은 액세스 변수가 설정되어 있는 동안 Claude Code는 키를 사용합니다. 구독 로그인 정보는 저장되어 있지만 사용되지 않으며, 사용량은 키를 통해 청구됩니다. 변수가 없으면 다시 구독이 활성화됩니다. /status에서 현재 사용 중인 방식을 확인할 수 있습니다.

구독으로 사용하는 Claude Code: Pro, Max 및 Team

Anthropic 설정 문서에 따르면 Claude Code는 Pro, Max, Team 또는 Enterprise 구독, API용 Console 계정 또는 Amazon Bedrock 같은 클라우드 제공업체를 통해 실행할 수 있으며, 무료 요금제에는 포함되지 않습니다. 여기에 이 글의 아래쪽에서 Kunavo와 함께 설명하는 LLM 게이트웨이를 통한 방법도 있습니다. claude.com/de/pricing 및 도움말 센터에 따른 세금 제외 미국 달러 가격은 2026년 9월 기준 다음과 같습니다.

플랜가격(세금 제외)사용량
Pro월 $20; 연간 결제 시 월 $17(선불 $200)기본 할당량, Claude Code 포함
Max 5x월 $100Pro보다 세션당 사용량 5배
Max 20x월 $200Pro보다 세션당 사용량 20배
Team, Standard 좌석좌석당 월 $25; 연간 결제 시 $20Pro보다 많은 사용량, 2~150명 규모의 팀용
Team, Premium 좌석좌석당 월 $125; 연간 결제 시 $100Standard 좌석의 5배 사용량
Enterprise좌석당 월 $20, 연간 결제, API 가격에 따른 사용량 요금 별도모델과 작업에 따라 비용 증가

Anthropic에 따르면 Max 가격은 웹 구독에 적용되며 모바일 앱에서는 가격이 다를 수 있습니다. 도움말 센터에 따르면 Fable 모델은 Max 및 Team Premium 좌석의 할당량에 포함되며 주간 한도의 최대 50%까지 사용할 수 있습니다. Pro 및 Team Standard 좌석에서는 Claude Code를 포함해 API 가격의 사용 크레딧으로만 실행됩니다.

부가가치세 포함 여부

Anthropic의 달러 가격은 세금 제외 가격입니다. 독일 가격 페이지의 요금제 아래에는 “표시된 가격에는 적용 가능한 세금이 포함되어 있지 않습니다.”라고 명시되어 있습니다. Anthropic은 결제 수단의 청구지 주소에 따라 세금을 계산합니다. 독일의 개인 고객에게는 부가가치세 19%가 부과됩니다(독일 부가가치세법 제12조). 개인 고객에게 제공하는 전자 서비스는 고객의 거주지에서 과세되기 때문입니다(독일 부가가치세법 제3a조 제5항).

독일에서 실제로 지불하는 금액은 결제 화면에서만 확인할 수 있습니다. 도움말 센터에 따르면 Pro 요금제는 미국에서 월 $20이며, 월 가격은 지역에 따라 다릅니다. 지원되는 경우 현지 통화로 표시되고, 일부 지역은 표시 가격에 세금이 포함되지만 다른 지역은 결제 단계에서 세금이 추가됩니다. 도움말 센터에는 유로 금액이 명시되어 있지 않으며, Anthropic은 claude.ai/upgrade에서 해당 지역의 현재 가격을 표시합니다. 웹에서 가입하면 결제할 때마다 이메일로 청구서를 받으며, 위치에 따라 향후 청구서에 적용할 부가가치세 식별번호를 등록할 수 있습니다. iOS 또는 Android 앱에서 가입하면 Apple 또는 Google이 청구합니다.

실제 가격은 한도입니다

Pro와 Max는 5시간마다 재설정되는 세션 한도와 모든 모델에 적용되는 주간 한도로 사용량을 측정합니다. 두 한도는 Claude 채팅과 Claude Code에 함께 적용됩니다. 두 도구에서 수행하는 모든 작업이 동일한 할당량에서 차감됩니다. Anthropic은 구체적인 수치를 공개하지 않습니다. 사용량 집계 기간이 적용되는 방식과 한도에 도달했을 때 도움이 되는 방법은 Claude 한도에 자세히 설명되어 있습니다.

한도에 도달한 후에도 계속 작업하려면 사용 크레딧을 활성화할 수 있습니다. Anthropic에 따르면 이 크레딧은 선불로 결제되며 표준 API 가격으로 청구됩니다. 따라서 구독에서 한도를 초과하면 어차피 API 가격을 지불하게 됩니다. 이때 캐시는 기본적으로 60분이 아니라 5분 동안만 유지됩니다. 바로 이 지점에서 자체 키가 유용합니다. Kunavo에서는 Claude 모델을 모델에 따라 Anthropic보다 30% 저렴하게 사용할 수 있습니다.

Claude Code는 무료인가요?

도구는 무료지만 사용량은 무료가 아닙니다. CLI와 VS Code 및 JetBrains용 확장 기능은 무료이며, Hooks, Skills, 서브에이전트 또는 MCP에 추가 요금은 없습니다. 비용이 발생하는 것은 모델 호출이며, 서브에이전트가 실행한 호출도 포함됩니다. 이를 위한 영구 무료 방법은 없습니다. 무료 요금제에는 Claude Code가 포함되지 않으며 API는 첫 토큰부터 요금을 부과합니다. Anthropic에 따르면 API 신규 사용자는 테스트를 위한 소액의 시작 크레딧을 받지만 영구적인 무료 요금제는 없습니다.

가장 부담이 적은 방법은 선불 키입니다. Kunavo에서는 $10부터 충전할 수 있고 월정액이 없으며 크레딧이 만료되지 않습니다. $10이면 Claude Sonnet 5을 사용해 약 230번의 에이전트 단계, 즉 캐시를 고려하지 않을 때 20단계 작업 약 12개를 처리할 수 있습니다.

API를 통한 Claude Code: 모델별 가격

키를 사용하면 요금제도 기간 제한도 없습니다. Claude Code는 다른 모든 API 트래픽과 마찬가지로 토큰당 청구됩니다. 파일과 도구 출력은 입력으로, 편집·설명·Thinking 토큰은 출력으로 계산됩니다. 토큰 100만 개당 미국 달러 가격(입력 / 출력)은 다음과 같습니다.

모델Anthropic 목록Kunavo절약액단계 하나Claude Code에서 …용
claude-haiku-4-5$1,00 / $5,00$0,70 / $3,50~30%$0,0217백그라운드 호출, 요약, 간단한 서브에이전트
claude-sonnet-4-6$3,00 / $15,00$2,10 / $10,50~30%$0,0651기존 설정을 위한 이전 세대
claude-sonnet-5$2,00 / $10,00$1,40 / $7,00~30%$0,0434일상 업무를 위한 현재 작업 모델
claude-opus-5$5,00 / $25,00$3,50 / $17,50~30%$0,1085/model claude-opus-5로 선택할 수 있는 Opus의 이전 버전
claude-opus-5-5$4,00 / $20,00$2,80 / $14,00~30%$0,0868여러 파일에 걸친 계획 및 변경(별칭 opus)
claude-fable-5$10,00 / $50,00$7,00 / $35,00~30%$0,217가장 어렵고 긴 작업

claude-opus-5의 Kunavo 가격은 $3,50 / $17,50입니다.

가격 비교를 왜곡하는 세부 사항이 있습니다. 버전 4.7 이상의 Claude 모델, 즉 Claude Sonnet 5, Claude Opus 5 및 Claude Fable 5도 Anthropic에 따르면 새로운 토크나이저를 사용하며, 동일한 텍스트에 대해 Claude Sonnet 4.6보다 약 30% 더 많은 토큰을 생성합니다. 정확한 증가량은 내용에 따라 다릅니다. 따라서 새 모델에서 동일한 작업을 수행하면 요금표만으로 예상하는 것보다 비용이 조금 더 듭니다.

캐싱이 비용을 좌우합니다

Claude Code는 매 단계마다 전체 대화를 함께 전송합니다. 따라서 입력의 대부분은 반복되는 컨텍스트이며, 프롬프트 캐싱이 바로 이 부분의 비용을 줄입니다. Kunavo는 Claude Sonnet 5에 대해 다음과 같이 계산합니다.

토큰 유형입력 가격 배수Kunavo의 Claude Sonnet 5, 100만 개당
캐시 적중0,1×$0,14
캐시 쓰기1,25×$1,75
캐시 없는 입력1×$1,40

커피를 마시며 쉬는 데도 비용이 따릅니다. API 키에서는 Anthropic 비용 문서에 따라 캐시가 기본적으로 5분 동안 유지되고, 구독에서는 1시간 동안 유지됩니다. 그보다 오래 쉬면 다음 단계에서 전체 컨텍스트를 다시 읽는 비용을 지불해야 하며, 캐시 적중이 아니라 캐시 쓰기 작업으로 청구됩니다. Claude Sonnet 5에서 컨텍스트가 200,000토큰이라면 이렇게 다시 읽는 데만 Kunavo에서 약 $0,35가 들며, 캐시가 유지되었을 때의 $0,028를 대신하게 됩니다. 긴 휴식 후 어차피 새로운 작업을 시작한다면 /clear로 시작하는 편이 낫습니다.

API를 통한 Claude Code의 월간 비용은 얼마인가요?

비용은 작업일이 아니라 에이전트 단계에 따라 발생합니다. 한 단계는 하나의 작업 안에서 모델과 주고받는 한 번의 상호작용입니다. 시스템 프롬프트, 대화 기록 및 새 파일 컨텍스트가 입력되고, 편집 또는 설명이 출력됩니다. 대략 입력 25,000토큰과 출력 1,200토큰입니다. 캐시를 의도적으로 제외한 Kunavo 가격 기준은 다음과 같습니다.

모델단계 하나작업(20단계)집중 작업일(작업 5개)집중 작업일 20일≈ 유로 환산
claude-haiku-4-5$0,0217$0,434$2,17$4338 €
claude-sonnet-4-6$0,0651$1,30$6,51$130114 €
claude-sonnet-5$0,0434$0,868$4,34$8776 €
claude-opus-5$0,1085$2,17$10,85$217190 €
claude-opus-5-5$0,0868$1,74$8,68$174152 €
claude-fable-5$0,217$4,34$21,70$434380 €

Claude Sonnet 5에서 이러한 작업일 20일의 비용은 약 $87입니다(약 76 €). Anthropic의 목록 가격이라면 $124입니다. 웜 캐시를 사용하면(입력 25,000토큰 중 20,000토큰이 캐시에서 읽히고 나머지는 새로 기록된다고 가정) 한 단계 비용은 $0,0200, 한 달 비용은 약 $40로 감소합니다.

실제 사용량과 비교하기 위해 Anthropic 비용 문서는 기업 설치 환경의 평균 비용을 개발자 1명당 실제 작업한 하루에 약 $13(약 11,39 €) 및 개발자 1명당 월 $150~250(약 131~219 €)로 제시합니다. 사용자 10명 중 9명은 실제 작업한 하루의 비용이 $30 미만입니다. 이는 기업 설치 환경의 평균값이며 Kunavo 가격이 아닙니다. Anthropic은 자체 팀의 필요량을 먼저 소규모 파일럿 그룹으로 측정할 것을 권장합니다. 자체 시나리오는 Claude 토큰 계산기에서 계산할 수 있습니다.

구독과 API: 유로 기준 손익분기점

두 방법을 동일한 기준으로 비교하면 다음과 같습니다. 월 요금 ÷ 단계당 비용 = 구독이 유리해지는 월간 단계 수입니다. Anthropic의 세금 제외 달러 가격과 캐시를 제외한 계산은 다음과 같습니다.

플랜월 세전 가격Claude Sonnet 5에서의 단계($0,0434/단계)Claude Sonnet 4.6에서의 단계($0,0651/단계)
Pro$20460(약 23개 작업)310(약 15개 작업)
Max 5x$1002.300(약 115개 작업)1.540(약 77개 작업)
Max 20x$2004.610(약 230개 작업)3.070(약 154개 작업)

유로로 계산하면: Kunavo에서 Claude Sonnet 5의 한 단계 비용은 약 0,038 €입니다. 따라서 구독 요금 1유로는 약 26단계의 비용에 해당합니다. Anthropic이 결제 화면에서 제시하는 유로 가격에 26를 곱하면 월간 단계 수 기준 손익분기점이 됩니다.

웜 캐시를 사용하면 손익분기점은 높아집니다. 그러면 20달러로 Claude Sonnet 5에서 약 1.000단계를 사용할 수 있습니다. 구독 자체에 포함된 단계 수는 Anthropic이 공개하지 않습니다. 이 표는 한도가 해당 사용량을 허용한다는 전제하에 어느 시점부터 정액제가 저렴해지는지만 보여줍니다.

결론은 다음과 같습니다. Pro는 빠르게 본전을 찾습니다. 집중 작업일 약 5(460단계)의 비용은 이미 키로 사용했을 때 $20에 도달합니다. 거의 매일 Claude Code를 사용하는 경우 Pro의 한도가 충분하다면 Pro가 더 저렴합니다. Max는 손익분기점이 훨씬 높습니다. Max 5x는 Claude Sonnet 5에서 월 약 2.300단계, 즉 약 23집중 작업일 이후에야 본전을 찾고, Claude Sonnet 4.6에서는 약 1.540단계부터입니다. 간헐적으로 작업하는 경우 이 기준보다 낮게 사용하므로 사용량이 적은 주에는 비용이 발생하지 않는 키가 더 저렴합니다. 팀에서는 사용자별 또는 CI 작업별로 키를 하나씩 사용할 수 있으며, 각각 별도의 지출 한도를 설정할 수 있습니다.

Claude Max는 이용할 가치가 있나요?

Max 5x는 Pro보다 $80 더 비쌉니다. 같은 금액으로 Kunavo에서 Claude Sonnet 5을 사용해 약 1.840단계를 처리할 수 있습니다(Claude Sonnet 4.6에서는 약 1.230). 캐시는 제외한 계산이며, 이는 한 번에 약 $2,17의 비용이 드는 50단계짜리 차단된 오후 약 37회에 해당합니다. 따라서 순수하게 계산하면 Pro가 차단하는 작업의 가치가 그 이상일 때만 Max 5x가 유리합니다. 한도에 걸리는 일이 드물다면 Pro를 유지하고 차단된 시간에만 키를 사용하는 편이 저렴합니다. 구독은 유지하면서 차단된 시간에만 키를 설정하는 방법은 Claude 한도에서 설명합니다.

자체 수치로 한 세션을 다시 계산하기

/usage는 Claude Code에서 현재 세션의 토큰 수를 새 입력, 출력, 캐시 읽기 및 캐시 쓰기로 구분해 보여줍니다. 옆의 달러 금액은 Claude Code가 목록 가격으로 로컬에서 계산한 값이며, Kunavo에서는 할인된 모델의 실제 청구액이 더 낮습니다. 다음 네 가지 수치로 다시 계산할 수 있습니다.

claude_code_kosten.py
# Was eine Claude-Code-Sitzung gekostet hat – aus ihren eigenen Token-Zahlen.
# /usage in Claude Code zeigt die vier Werte der laufenden Sitzung.
PREISE = {  # USD pro 1M Tokens auf Kunavo: (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),
}
CACHE_LESEN, CACHE_SCHREIBEN = 0.10, 1.25  # Faktoren auf den Input-Preis

def sitzungskosten(modell, neu, output, cache_lesen=0, cache_schreiben=0):
    i, o = PREISE[modell]
    return (
        neu * i                                   # frischer Input
        + output * o                              # Output inkl. Thinking-Tokens
        + cache_lesen * i * CACHE_LESEN           # Cache-Treffer
        + cache_schreiben * i * CACHE_SCHREIBEN   # Cache-Schreibvorgänge
    ) / 1_000_000

# Anthropics Beispielsitzung aus der /usage-Dokumentation:
print(round(sitzungskosten("claude-sonnet-4-6", 1_200, 5_300, 940_000, 50_000), 2))  # 0.39

Anthropic 문서의 예시 세션은 Claude Sonnet 4.6에서 실행됩니다. 새 입력 1,200토큰, 출력 5,300토큰, 캐시에서 읽은 토큰 940,000개, 기록된 토큰 50,000개입니다. 목록 가격으로는 $0.55, Kunavo에서는 $0,3868입니다. 이 중 캐시 토큰 940,000개만 계산하면 $0,20이며, 캐시가 없을 때의 $1,97보다 저렴합니다: 이 세션에서는 캐시 절감액이 세션 전체 비용보다 큽니다.

비용을 줄이는 다섯 가지 방법

  1. 캐시를 활용하세요. 이 페이지의 모델에서 캐시 적중 비용은 입력 가격의 일부에 불과한 수준이며, Claude Code는 매 단계마다 전체 대화 기록을 다시 읽습니다(캐싱 작동 방식).
  2. 작업 사이에 정리하세요. 컨텍스트는 매 단계마다 함께 전송되므로 하루 종일 이어지는 세션은 메시지가 추가될수록 비용이 증가합니다. /clear을 실행하고 새 작업을 시작하면 컨텍스트가 다시 작아집니다.
  3. 작업에 맞는 모델을 선택하세요. Anthropic에 따르면 Sonnet은 대부분의 코딩 작업에 충분하고, Opus는 아키텍처 결정과 다단계 리즈닝을 위한 모델입니다. Claude Fable 5에서의 한 단계 비용은 Claude Sonnet 5에서보다 약 5,0배입니다.
  4. 간단한 작업은 Haiku에 할당하세요. Anthropic에 따르면 ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5은 별칭 haiku과 세션 제목 같은 백그라운드 작업에 사용할 모델을 지정합니다. 여기서는 Claude Haiku 4.5, 이 페이지에서 가장 저렴한 모델입니다. 간단한 서브에이전트도 구성에서 model: haiku를 사용해 동일한 모델로 보낼 수 있습니다.
  5. 사고량을 조정하세요. Thinking 토큰은 출력으로 청구되며, 기본 예산은 모델에 따라 요청당 수만 토큰에 이를 수 있습니다. 간단한 작업에서는 /effort으로 사고량을 줄일 수 있습니다.

Kunavo로 Claude Code 설정하기

Claude Code는 ANTHROPIC_BASE_URL를 기본적으로 읽으며, Anthropic Messages API를 제공하는 모든 Endpoint와 함께 작동합니다. 플러그인도, 프록시도, 재설치도 필요하지 않습니다. 셸에서 일회성으로 터미널에 설정하거나, 영구적으로 ~/.zshrc에 설정할 수 있습니다:

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # nur der Origin, ohne /v1
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

ANTHROPIC_BASE_URL는 Origin일 뿐입니다. 경로 /v1/messages는 Claude Code가 직접 추가하므로 끝에 /v1가 있는 값은 404를 반환합니다. ANTHROPIC_API_KEY 대신 ANTHROPIC_AUTH_TOKEN를 사용하세요. Kunavo는 두 헤더에서 모두 키를 허용하지만 ANTHROPIC_AUTH_TOKEN는 즉시 적용되는 반면, Claude Code는 대화형 모드에서 ANTHROPIC_API_KEY을 먼저 확인하도록 합니다.

모델 관련 줄도 필요합니다. ANTHROPIC_MODEL가 없으면 Claude Code는 Anthropic이 현재 Opus 5.5라고 명시한 기본 모델로 시작합니다. 이 줄은 대신 Claude Sonnet 5을 시작 모델로 지정하며, 이 페이지의 모든 계산은 이 모델을 기준으로 합니다. ANTHROPIC_DEFAULT_OPUS_MODEL는 opus 별칭을 Claude Opus 5.5로 지정합니다(claude-opus-5-5, Kunavo에서는 입력 및 출력 토큰 100만 개당 $2,80 / $14,00). Opus 5.5에는 Claude Code 버전 2.1.280 이상이 필요합니다. 오래된 설치는 claude update로 최신 상태로 업데이트하세요. 반면 sonnet 별칭은 Kunavo가 제공하지 않는 Sonnet 5.5를 요구합니다. ANTHROPIC_DEFAULT_SONNET_MODEL이 없으면 /model sonnet, opusplan의 실행 단계 및 model: sonnet를 사용하는 하위 에이전트가 404로 종료됩니다. 이 줄은 별칭을 Claude Sonnet 5로 지정합니다. 변수는 영구적으로 사용자 설정의 env 블록에 넣습니다:

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

프로젝트의 .claude/settings.json에는 절대 넣지 마세요. 해당 파일은 저장소에 포함됩니다. VS Code 확장에서는 VS Code 사용자 설정의 claudeCode.environmentVariables에 변수를 넣어야 합니다. 확인하려면 /status를 실행하세요. Kunavo Endpoint가 표시된 “Anthropic base URL” 줄과 인증 토큰 줄이 나타나야 합니다. 대신 claude.ai 로그인이 표시된다면 변수가 로드되지 않은 것입니다. 전체 안내(영문): Kunavo로 Claude Code 사용하기.

가입 후 대시보드에서 키(sk-kn-…)를 생성하세요. 결제는 $10부터 시작하는 Stripe 선불 잔액으로 이루어집니다. 카드(Visa, Mastercard, American Express) 또는 Link를 사용할 수 있고, Safari 및 iOS에서는 Apple Pay, Chrome 및 Android에서는 Google Pay도 사용할 수 있습니다(각각 Wallet에 등록된 카드 필요). 오스트리아 구매자에게는 EPS도 표시됩니다. SEPA 자동이체와 PayPal은 제공되지 않습니다. Pay by Bank는 영국, 아일랜드, 핀란드 구매자에게만 결제 화면에 표시되므로 독일과 오스트리아에서는 사용할 수 없습니다. 독일의 경우 Stripe가 아직 비공개 미리보기로만 제공합니다(기준일: 2026년 10월 3일). Visa 또는 Mastercard 직불카드는 신용카드처럼 작동합니다. 가격은 달러로 표시되지만 결제 화면에는 현지 통화 금액이 표시됩니다. 잔액은 만료되지 않으며 실패한 요청에는 비용이 들지 않습니다. 각 키에는 월별 지출 한도를 설정할 수 있고, 한도에 도달하면 API가 추가 요청을 402로 거부합니다. 모든 충전 및 차감 내역은 /app/billing의 기록에 표시됩니다.

Key로 달라지는 점과 Kunavo가 대체하지 않는 것

Claude Code의 핵심 기능인 Agent, 도구, Subagent, MCP 서버는 Messages API를 통해 작동하며 그대로 유지됩니다. 반면 Remote Control과 음성 받아쓰기 기능에는 claude.ai 신원이 필요하므로 Gateway Key로는 사용할 수 없습니다.

Kunavo는 전용 할당량이나 계약상 SLA 없이 공유 용량을 통해 Claude를 제공합니다. 보장된 용량이 필요하다면 Anthropic과 직접 계약해야 합니다. 매일 프로그래밍하고 Pro의 제한으로 충분한 사용자라면 Pro가 아마 더 저렴할 것입니다. Key는 간헐적으로 사용하는 경우, 사용자별 예산이 있는 팀, CI 환경, 그리고 한도 초과 후 사용 시간에 적합합니다. Claude의 전체 비용을 Chat, API, Claude Code별로 나란히 비교한 내용은 Claude 가격에, OpenAI Agent에 대한 동일한 계산은 Codex 비용에 나와 있습니다.

자주 묻는 질문

Claude Code는 얼마인가요?

Claude Code 자체는 무료이며 모델 비용을 구독 또는 토큰 단위로 지불합니다. 구독을 이용하면 Claude Code가 Claude Pro(월 $20, 연간 결제 시 월 $17)와 Claude Max(월 $100 또는 $200)에 포함되고, Team 및 Enterprise에도 포함됩니다. 이는 세금이 제외된 Anthropic의 미국 가격이며 지역에 따라 가격과 통화가 달라집니다. 독일의 개인 고객은 19%의 부가가치세를 납부하며, Anthropic은 이를 청구 주소를 기준으로 계산합니다(2026년 9월 기준). API 키를 사용하면 기본 요금 없이 토큰 단위로 지불합니다. Kunavo에서 Claude는 100만 입력 및 출력 토큰당 Sonnet 5 $1,40 / $7,00이며, 입력 약 25,000토큰과 출력 1,200토큰을 사용하는 에이전트 단계의 비용은 약 $0,0434입니다. Anthropic 자체는 기업 설치의 경우 개발자 1인당 실제 사용일 기준 평균 약 $13이라고 설명합니다.

Claude Code는 무료인가요?

소프트웨어만 무료입니다. CLI, 편집기 확장 기능 및 구성은 무료이지만 모델 호출에는 비용이 듭니다. Anthropic에 따르면 무료 Claude 요금제에는 Claude Code가 포함되지 않으며, API는 첫 토큰부터 요금을 부과합니다. Anthropic API 신규 사용자는 테스트를 위한 소액의 시작 크레딧만 받습니다. 월정액 없이 사용하는 방법은 선불 키이며, Kunavo에서는 $10 충전부터 이용할 수 있고 크레딧이 만료되지 않습니다. 따라서 한 달 동안 코딩하지 않으면 비용은 $0입니다.

API를 통한 Claude Code의 월간 비용은 얼마인가요?

이는 근무일 수가 아니라 에이전트 단계 수에 따라 달라집니다. 하루 100단계를 20일 동안 실행하는 집중적인 한 달의 비용은 Kunavo에서 Claude Sonnet 5를 사용할 때 캐시 없이 약 $87(약 76 €)이고, 웜 캐시를 사용하면 약 $40입니다. Anthropic 목록 가격으로는 캐시 없이 $124가 됩니다. Anthropic 자체 비용 문서에서는 기업 설치 비용이 개발자 1인당 월 평균 $150–250이라고 설명합니다. 선불 키를 사용하면 사용하지 않는 달의 비용은 $0입니다.

Claude Max는 이용할 가치가 있나요?

계산상으로는 Pro가 차단하는 작업을 API 키로 처리하는 비용이 추가 요금보다 높아지는 시점입니다. Max 5x는 월 $100로, Pro보다 $80 더 비싸며, 이 $80로 Kunavo에서 캐시를 제외하고 Claude Sonnet 5를 사용해 약 1.840개의 에이전트 작업을 수행할 수 있습니다. 한도에 덜 자주 도달한다면 Pro를 유지하고 차단된 시간에는 API 키로 이어가는 편이 낫습니다. 50 단계로 오후 한 번 사용하는 비용은 약 $2,17입니다. 구독에서 한도를 초과해 작업하는 사용량 크레딧은 Anthropic이 표준 API 요금으로 청구합니다.

Claude Pro와 Max 가격에는 부가가치세가 포함되어 있나요?

Anthropic 가격 페이지의 달러 가격에는 포함되어 있지 않습니다. 구독 가격은 세금 제외로 표시됩니다. Anthropic은 결제 수단의 청구지 주소에 따라 세금을 계산합니다. 독일의 개인 고객에게는 전자 서비스가 고객의 거주지에서 과세되므로 부가가치세 19%가 적용됩니다. 다만 Anthropic 도움말 센터에 따르면 월간 가격은 지역에 따라 다르며 지원되는 경우 현지 통화로 표시됩니다. 일부 지역은 표시 가격에 세금이 이미 포함되고, 다른 지역은 결제 단계에서 세금이 추가됩니다. 최종적으로 적용되는 금액은 결제 화면에 표시되는 금액입니다. 기업은 위치에 따라 향후 청구서에 적용할 부가가치세 식별번호를 등록할 수 있습니다(2026년 9월 기준).

API가 Claude Pro 구독에 포함되어 있나요?

아니요. Claude 구독과 Claude API는 별도의 청구가 이루어지는 별도 제품이며, API를 사용하려면 Anthropic에 따라 별도의 Console 계정이 필요합니다. Claude Code에 ANTHROPIC_AUTH_TOKEN 또는 ANTHROPIC_API_KEY 같은 액세스 변수가 설정되어 있으면 Claude Code는 구독 대신 키를 사용합니다. 이 경우 요금제 한도는 적용되지 않고 사용량은 키 소유자에게 청구됩니다. 변수가 없으면 다시 구독이 활성화됩니다.

구독과 API 중 Claude Code에 더 저렴한 것은 무엇인가요?

월 요금을 단계 하나의 비용으로 나누면 됩니다. Kunavo에서 Claude Sonnet 5를 사용한 에이전트 단계 하나의 비용은 약 $0,0434이므로, Pro의 $20는 한 달에 약 460단계, 또는 단계 20개로 구성된 작업 23개에 해당합니다. 거의 매일 작업한다면 대개 이보다 많이 사용하므로 Pro의 한도가 충분한 동안에는 Pro가 더 저렴합니다. Max의 손익분기점은 훨씬 높습니다. Max 5x의 $100는 약 2.300단계에 해당합니다. 몰아서 작업하는 사용자라면 이보다 적게 사용하므로, 사용하지 않는 주에는 비용이 들지 않는 키를 이용하는 편이 더 저렴합니다.

Claude Code 비용을 줄이려면 어떻게 해야 하나요?

다섯 가지 방법이 있습니다. 프롬프트 캐시를 활용하고(캐시 적중은 입력 가격의 최대 10분의 1이며 Claude Code는 매 단계마다 전체 대화 기록을 전송합니다), 서로 독립적인 작업 사이에는 /clear로 새로 시작하고, 기본값으로 가장 큰 모델을 유지하지 말고 작업에 맞는 모델을 선택하며, 간단한 서브에이전트와 백그라운드 호출은 Claude Haiku 4.5에 할당하고(model: haiku 및 ANTHROPIC_DEFAULT_HAIKU_MODEL), 간단한 작업에서는 Thinking 토큰이 출력으로 계산되므로 /effort로 사고량을 줄이세요. ANTHROPIC_BASE_URL을 통한 더 저렴한 엔드포인트를 추가로 사용할 수 있습니다.

Claude Code로 한도에 도달하면 어떻게 되나요?

구독에서는 재설정될 때까지 세션이 중단됩니다. 세션 한도는 5시간마다, 주간 한도는 매주 정해진 시각에 재설정됩니다. 이 두 한도는 모든 모델에 적용되므로 모델을 변경해도 도움이 되지 않습니다. Opus와 같은 모델별 한도에 도달한 경우에만 다른 모델 제품군의 모델로 계속 작업할 수 있습니다. 방법은 세 가지입니다. 기다리거나, 더 높은 등급으로 변경하거나, Anthropic의 표준 API 가격 사용 크레딧 또는 환경 변수가 설정되어 있는 동안 Claude Code가 사용하는 자체 API 키로 비용을 지불하며 계속 작업할 수 있습니다.

Kunavo에서 SEPA 자동이체 또는 PayPal로 결제할 수 있나요?

아니요. 둘 다 제공되지 않습니다. Stripe 결제 화면에서는 카드(Visa, Mastercard, American Express)와 Link를 사용할 수 있습니다. Safari 및 iOS에서는 Apple Wallet에 카드를 추가한 경우 Apple Pay도 사용할 수 있고, Chrome 및 Android에서는 Google Pay를 설정한 경우 Google Pay도 사용할 수 있습니다. 오스트리아 구매자에게는 EPS도 제공됩니다. Visa 또는 Mastercard 직불카드는 신용카드처럼 작동합니다. Kunavo는 $10부터 시작하는 선불 잔액을 사용하며, 미국 달러로 가격이 책정되고 만료되지 않습니다.