2026년 Claude Code 가격: 구독 또는 API, 한 달 비용과 어느 쪽이 유리한지

Claude Code는 설치는 무료지만 사용은 무료가 아니며, 결제 방식에 따라 가격이 달라집니다. claude.ai 구독을 사용하면 요금에 포함됩니다. Claude Pro는 월 $20(연간 결제 시 월 $17), Claude Max는 월 $100부터이며 2026년 9월 기준입니다. 무료(Free) 요금제에는 Claude Code가 포함되지 않습니다. API 키를 사용하면 월별 요금 없이 토큰별로 결제합니다. Kunavo에서 Claude Sonnet 5는 입력 토큰 백만 개당 $1,40, 출력 토큰 백만 개당 $7,00이므로, 일반적인 에이전트 상호작용(입력 약 25,000토큰, 출력 1,200토큰)은 약 $0,0434입니다. Anthropic 자체 문서에 따르면 실제 비용은 사용일 기준 개발자 1인당 하루 약 $13입니다. 모든 수치는 미국 달러(USD)입니다.

Claude Code 비용에 관한 혼란의 대부분은 이 두 결제 방식을 섞어서 생각하기 때문에 생깁니다. 이 페이지에서는 두 방식의 현재 수치, 어느 쪽을 선택할지 계산하는 방법, 실제 한 달 비용, 재설치 없이 Claude Code를 더 저렴한 API로 연결하는 방법을 설명합니다.

2026년 10월 3일에 확인한 가격이며, claude.com/pricing(2026년 9월 기준 요금제)과 Anthropic API 가격 문서를 기준으로 합니다. Kunavo 가격은 사이트의 모델 카탈로그에서 확인합니다.

Claude Code의 비용은 얼마인가요? 두 가지 결제 방법

두 방식의 비용은 합산되지 않습니다. 자격 증명 변수가 정의되어 있는 동안 Claude Code는 구독을 중단하고 키를 사용합니다. 요금제 한도는 적용되지 않으며 사용량은 키에 청구됩니다. /status 명령으로 현재 활성화된 방식을 확인할 수 있습니다.

구독으로 사용하는 Claude Code 가격

Claude Code에는 Pro, Max, Team, Enterprise 또는 콘솔(API) 계정이 필요합니다. Anthropic의 설치 문서에 따르면 Claude.ai Free 요금제에는 Claude Code가 포함되지 않습니다. 2026년 9월 기준 claude.com/pricing에 게시된 가격은 다음과 같습니다:

가장 중요한 것은 요금이 아니라 한도입니다. 요금제 사용량은 5시간 이동 창과 주간 창으로 측정되며, 두 창 모두 Claude 채팅과 공유됩니다. 웹에서의 오후 대화는 프로그래밍 세션과 동일한 할당량을 사용합니다. /model로 모델을 바꿔도 창은 초기화되지 않습니다. 창이 모든 모델을 포함하기 때문입니다. 프로그래밍 외에 각 요금제에 포함되는 내용과 채팅에 API를 사용하는 것이 언제 유리한지는 Claude 가격에서 확인할 수 있습니다.

Claude Code는 무료인가요?

도구는 무료지만 사용은 무료가 아닙니다. CLI, VS Code 및 JetBrains 확장과 모든 설정은 무료이며, 비용이 발생하는 것은 모델 호출입니다. Claude Code가 비용 없이 모델을 사용할 수 있는 무료 등급은 없습니다. Claude.ai Free 요금제에는 포함되지 않으며 API는 첫 호출부터 토큰별로 청구됩니다.

가장 부담이 적은 방법은 사용량에 따라 결제하는 키입니다. 월별 요금이 없고 최소 충전액은 $10이며 잔액이 만료되지 않으므로 프로그래밍하지 않는 달의 비용은 $0입니다. $10과 Sonnet 5로 에이전트 단계 약 230회, 즉 20단계 작업 약 12개를 처리할 수 있습니다. 영어로 된 자세한 설명은 is Claude Code free입니다.

모델별 API를 통한 Claude Code 가격

키를 사용하면 요금제나 창이 없습니다. Claude Code는 일반적인 Claude API 트래픽으로 청구됩니다. 파일과 도구 출력은 입력 토큰으로, 편집·설명·추론은 출력 토큰으로 계산됩니다. 토큰 백만 개당 가격(입력 / 출력):

Kunavo에서 claude-opus-5의 가격은 $3,50 / $17,50이며, 자체 공식 가격($5,00 / $25,00)보다 30% 낮습니다. 예산이 가장 중요하다면 Sonnet 5가 동일한 단계를 $0,0434에 수행합니다.

캐시도 가격의 일부입니다

Claude Code는 각 단계에서 전체 대화를 다시 보내므로 청구량의 대부분은 반복되는 컨텍스트입니다. 바로 이 부분에서 프롬프트 캐시가 비용을 낮춥니다. 입력 가격에 대한 배수는 다음과 같습니다:

캐시가 활성화된 세션에서는 대부분의 입력 토큰이 가격의 10분의 1인 캐시 읽기입니다. 따라서 토큰 수에 가격을 곱하는 방식은 청구액을 크게 과대평가합니다. 또한 Claude Code에서 가장 비용이 많이 드는 패턴도 설명해 줍니다. 오랫동안 멈췄다가 돌아오면 캐시가 이미 만료되어 전체 컨텍스트를 다시 정가로 처리해야 합니다.

Claude Code의 한 달 비용

지출은 사용 일수가 아니라 에이전트 단계에 따라 달라집니다. 한 단계는 작업 중 모델을 한 번 왕복하는 것으로, 입력 약 25,000토큰(시스템 프롬프트, 대화, 파일)과 출력 1,200토큰입니다. 캐시 없이 Kunavo 가격을 적용하면 다음과 같습니다:

Sonnet 5로 이렇게 20일을 사용한 비용은 약 $87입니다. Anthropic 공식 가격의 Opus 5라면 약 $310, Kunavo에서는 $217입니다. 의도적으로 보수적인 수치입니다. 캐시 없이 모든 작업에 하나의 모델만 사용한 경우입니다.

실제 배포 사례와 비교하면 Claude Code 비용에 관한 Anthropic 문서는 사용일 기준 개발자 1인당 하루 약 $13, 기업 배포에서 개발자 1인당 월 $150~$250라고 설명하며, 사용자의 90%는 하루 $30 미만입니다. 여러 모델을 혼합한 공식 가격 기준 수치이며 팀 예산을 책정할 때 참고할 기준입니다.

손익분기점

두 방식을 같은 기준으로 비교하면 Sonnet 5 기준 단계당 $0,0434일 때:

• $20(Pro)는 월 에이전트 단계 약 460회, 즉 20단계 작업 약 23개에 해당합니다.
• $100(Max, 입문 단계)는 단계 약 2.300회, 작업 약 115개에 해당합니다.

여기서 얻는 규칙은 다음과 같습니다. Claude Code로 거의 매일 프로그래밍한다면 일반적으로 구독이 더 저렴합니다. Anthropic이 측정한 평균 사용량으로는 한 달 작업 비용이 Max의 $100을 훨씬 넘으며, 한도에 도달하지 않는 한 요금제가 이를 충당합니다. 사용량이 불규칙하다면 —집중적으로 사용하는 주와 전혀 사용하지 않는 주가 있다면— 사용량에 따른 결제가 유리합니다. 한가한 주에는 비용이 없기 때문입니다. 팀은 어쨌든 키를 선호하는 경우가 많습니다. 사용자별로 비용을 배분하고 키별 월 한도를 설정할 수 있기 때문입니다. 직접 계산하려면 토큰별 가격 계산기(영어)를 사용하세요.

자신의 수치로 세션 계산하기

Claude Code의 /usage 명령은 세션의 네 가지 토큰 수를 보여 줍니다. 캐시 읽기와 새 입력을 구분하므로 지출을 추정할 때 신뢰할 수 있는 데이터입니다:

# Cuánto costó una sesión de Claude Code, a partir de sus propios tokens.
# Ejecuta /usage dentro de Claude Code para obtener los cuatro números.
TARIFAS = {  # USD por millón de tokens en Kunavo: (entrada, salida)
    "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 gasto_sesion(modelo, entrada, salida, lectura_cache=0, escritura_cache=0):
    e, s = TARIFAS[modelo]
    return (
        entrada / 1e6 * e                   # entrada nueva
        + salida / 1e6 * s                  # salida, razonamiento incluido
        + lectura_cache / 1e6 * e * 0.10    # lectura de caché: 10 % de la entrada
        + escritura_cache / 1e6 * e * 1.25  # escritura en caché: 125 %
    )

# La sesión de ejemplo que muestra la documentación de Anthropic para /usage:
print(gasto_sesion("claude-sonnet-5", 1_200, 5_300, 940_000, 50_000))  # ≈ 0.26

예시 세션에는 캐시에서 읽은 토큰이 940.000개이고 새 입력은 1,200개입니다. 정가로 계산하면 이 940.000개 토큰의 비용은 $1,32이지만, 캐시 읽기로는 $0,1316입니다. 따라서 Claude Code에서는 모델 선택보다 캐시가 비용을 줄이는 가장 큰 수단입니다.

청구서를 낮추는 네 가지 핵심 방법

1. 캐시가 작동하도록 두세요. 캐시에서 읽은 입력은 요금의 10%이며 Claude Code는 매 단계마다 대화를 다시 읽습니다. 이는 활용 가능한 가장 큰 효과입니다(작동 방식).
2. 서로 관련 없는 작업 사이에는 정리하세요. 컨텍스트는 매 단계마다 다시 전송되므로 하루 종일 이어지는 세션은 메시지가 늘어날 때마다 비싸집니다. /clear과 새 작업을 사용하면 컨텍스트가 다시 작아집니다.
3. 작업별로 모델을 선택하세요. 가장 큰 모델을 기본값으로 두는 것은 예상치 못한 청구서의 가장 흔한 원인입니다. Fable 5를 사용하는 한 단계는 Sonnet 5를 사용하는 단계보다 5,0배 비쌉니다. Sonnet은 대부분의 프로그래밍을 해결하므로 Opus와 Fable은 아키텍처 및 어려운 추론에 사용하세요.
4. 백그라운드 호출은 Haiku로 보내세요. Claude Code는 요약과 제목을 위해 자체 호출을 수행합니다. ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5은 한 줄이며 순수한 절약입니다.

Kunavo에서 Claude Code 사용하기

Claude Code는 기본적으로 ANTHROPIC_BASE_URL을 읽으므로 Anthropic Messages API를 제공하는 모든 엔드포인트에 연결할 수 있습니다. 플러그인도, 프록시도, 설치 변경도 필요하지 않습니다. 터미널 세션에서는 다음과 같이 사용합니다:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # el origen, sin /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는 원본 주소일 뿐입니다. Claude Code가 자체적으로 /v1/messages를 추가하므로, 이미 /v1로 끝나는 값을 사용하면 404가 됩니다. ANTHROPIC_AUTH_TOKEN를 사용하고 ANTHROPIC_API_KEY는 사용하지 마세요. 두 변수는 서로 다른 헤더로 키를 보내며, Kunavo는 Authorization: Bearer를 통해 인증하고 ANTHROPIC_AUTH_TOKEN가 이를 전송합니다. 모델 줄은 선택 사항이 아닙니다. Claude Code의 기본 모델과 opus 및 sonnet 별칭은 Anthropic의 최신 모델을 따르므로 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를 실행하세요. 설정을 유지하려면 사용자 설정의 env 블록에 변수를 추가합니다:

{
  "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로 상태 탭을 여세요. «Auth token» 줄이 표시되면 자격 증명이 활성화된 것입니다. claude.ai 계정과 함께 «Login method»가 표시되면 변수가 로드되지 않은 것입니다. 전체 가이드는 Kunavo에서 Claude Code 사용하기(영어)에서 확인할 수 있습니다.

sk-kn- 키는 회원가입 후 $10을 충전한 다음 키 관리 패널에서 생성합니다. 잔액은 Stripe를 통해 충전됩니다. 카드(Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay, Link 및 국가에 따라 제공되는 기타 결제 방법을 사용할 수 있으며 SEPA 자동이체는 제공되지 않습니다. 잔액은 만료되지 않고 실패한 요청에는 요금이 부과되지 않습니다. 각 키에는 월별 지출 한도를 설정할 수 있으며, 한도에 도달하면 API가 402를 반환합니다. 허용된 IP 주소 목록도 설정할 수 있으므로 개발자별 또는 CI용 키를 안전하게 발급할 수 있습니다.

Claude Code를 API와 함께 사용할 때 달라지는 점과 달라지지 않는 점

에이전트, 도구, 하위 에이전트, MCP 서버를 포함한 Claude Code의 핵심은 Messages API 위에서 작동하며 변하지 않습니다. 달라지는 점은 활성 게이트웨이 자격 증명을 사용하면 Remote Control과 음성 받아쓰기를 사용할 수 없다는 것입니다. 이 기능에는 claude.ai ID가 필요하기 때문입니다.

그리고 Kunavo가 대체하지 않는 것도 있습니다. Kunavo는 공유 용량으로 Claude를 제공하며, 전용 할당량이나 계약상 SLA는 없습니다. 팀에 보장된 할당량이나 서비스 수준 계약이 필요하다면 Anthropic과 직접 계약하세요. Claude Code를 매일 사용하고 플랜 한도 내에서 작업한다면 구독이 더 저렴할 가능성이 높습니다. API는 사용량이 불규칙하거나, 팀에서 비용을 분담하고 제한하려 하거나, 자동화를 사용할 때 유리합니다.

자주 묻는 질문