Claude Code에는 완전히 다른 두 가지 가격 체계가 있으며, 비용에 관한 혼란의 대부분은 이 둘을 섞어서 생각하기 때문에 생깁니다. claude.ai 구독은 사용량 제한이 있는 월간 요금제에 도구를 포함합니다. API 키는 구독이나 한도 없이 토큰 단위로 청구됩니다. 이 페이지에서는 두 방식의 최신 수치, 선택을 위한 계산, 실제 작업 한 달의 비용, 그리고 프랑스에서 결제하는 방법을 함께 다룹니다.
가격 확인일: 2026년 10월 3일 claude.com/pricing 및 Anthropic API 가격 문서와 대조했습니다. Kunavo의 토큰 가격은 모델 카탈로그에서 실시간으로 읽어옵니다.
두 방식을 나란히 비교
| 구독(Pro / Max) | API 키(사용량 기준) | |
|---|---|---|
| 지불 항목 | 월 $20부터인 월간 요금제 | 구독 없이 토큰 단위로 결제 |
| 제한 | 5시간 이동 창 및 Claude 채팅과 공유되는 주간 한도 | 없음 — 사용한 만큼 결제 |
| 코딩하지 않는 한 달 | 전액 청구 | $0 |
| 사용량이 많은 한 달 | 한도 적용 — 막히고 기다려야 함 | 작업을 따라가고 청구서도 따라감 |
| 프랑스에서 결제 | 달러로 월별 자동 결제 | 카드, Apple Pay, Google Pay, Link, 선불 잔액 |
구독 비용
Claude Code는 claude.ai의 유료 요금제에 포함됩니다. Anthropic의 설치 문서에는 무료 요금제로는 Claude Code에 액세스할 수 없다고 명시되어 있습니다. Pro는 월 $20(연간 결제 시 월 $17, 한 번에 $200)이며 요금제 한도 내에서 작업하는 개발자 1명을 지원합니다. Max는 월 $100부터 시작하며, 이러한 한도에 계속 걸리는 사용자를 위한 요금제입니다. 등급은 Pro 사용량 한도의 배수(5x, 20x)로 제시됩니다. Team 및 Enterprise는 좌석별 할당량과 관리자를 위한 지출 관리 기능을 추가합니다.
프랑스에서 중요한 세부 사항은 두 가지입니다. 자동 결제는 달러로 매월 이루어지며, 은행의 해외 통화 거래 수수료가 매월 적용됩니다. 또한 사용량 한도는 Claude 채팅과 공유되므로 오후 내내 대화하면 코드 세션과 동일한 시간 창을 사용하게 됩니다.
API 방식의 비용
여기에는 구독이 없습니다. 토큰 단위로 결제합니다. 가격은 1M 토큰당 USD이며, 직접 비교할 수 있도록 Anthropic의 공개 가격도 옆에 표시합니다.
| 모델 | Kunavo 입력/출력 | Anthropic 공개 가격(입력 / 출력) |
|---|---|---|
| claude-haiku-4-5 | $0.70 / $3.50 | $1.00 / $5.00 |
| claude-sonnet-4-6 | $2.10 / $10.50 | $3.00 / $15.00 |
| claude-sonnet-5 | $1.40 / $7.00 | $2.00 / $10.00 |
| claude-opus-5 | $3.50 / $17.50 | $5.00 / $25.00 |
캐시된 입력은 입력 요금의 10%로 청구되고, 5분 캐시 쓰기는 125%로 청구됩니다. Claude Code는 각 단계마다 전체 대화를 다시 읽으므로 실제 청구액을 좌우하는 것은 모델 선택보다 이 두 계수입니다.
한 단계의 실제 비용
“에이전트 단계”란 작업 내부에서 모델과 한 번 왕복하는 것을 뜻합니다. 입력에는 시스템 프롬프트 + 대화 + 파일 컨텍스트가, 출력에는 편집 또는 설명이 포함됩니다. 측정 결과는 약 입력 25,000토큰 / 출력 1,200토큰입니다. Kunavo 가격으로 계산하면 다음과 같습니다.
| 모델 | 한 단계 | 20단계 작업 |
|---|---|---|
| claude-haiku-4-5 | $0.022 | $0.43 |
| claude-sonnet-5 | $0.043 | $0.87 |
| claude-opus-5 | $0.109 | $2.17 |
손익분기점
손익분기점은 작업 일수가 아니라 단계 수로 결정됩니다. Sonnet 5에서 단계당 $0.043일 때, 월 $20의 Pro 구독은 월 약 460단계, 즉 약 23개의 20단계 작업과 같습니다. 그보다 적게 사용하면 사용량 기준 결제가 더 저렴하고 코딩하지 않는 달에는 비용이 들지 않습니다. 그보다 많이 사용하면 요금제 한도에 도달할 때까지 구독이 더 저렴합니다.
직접 계산하려면 Claude Code에서 /usage를 실행하고 다음 네 숫자를 기록하세요.
# Ce qu'a coûté une session Claude Code, à partir de ses tokens.
# Lancez /usage dans Claude Code pour récupérer les quatre nombres réels.
RATES = { # USD par 1M de tokens chez 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),
"claude-opus-5-5": (2.80, 14.00),
}
def cout_session(model, inp, out, cache_read=0, cache_write=0):
i, o = RATES[model]
return (
inp / 1e6 * i # input neuf
+ out / 1e6 * o # output, tokens de raisonnement inclus
+ cache_read / 1e6 * i * 0.10 # lecture de cache : 10% du tarif input
+ cache_write / 1e6 * i * 1.25 # écriture de cache 5 min : 125%
)
print(cout_session("claude-sonnet-5", 1_200, 5_300, 940_000, 50_000))Claude Code를 Kunavo로 연결하기
Claude Code는 Anthropic과 호환되는 모든 엔드포인트와 통신할 수 있습니다. 설치나 사용 방식을 바꾸지 않고 사용량 기준 방식으로 전환하려면 환경 변수 두 개면 충분합니다.
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 오류를 반환합니다. ANTHROPIC_DEFAULT_OPUS_MODEL 행은 별칭을 Opus 5.5(claude-opus-5-5)로 고정하며 Claude Code v2.1.280 이상이 필요합니다(그렇지 않으면 claude update를 실행하세요). 반면 sonnet 별칭은 Kunavo가 제공하지 않는 Sonnet 5.5를 요청하므로 ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet이 없으면 opusplan의 실행 단계와 sonnet으로 설정된 하위 에이전트가 404 오류로 실패합니다. 키는 /app/keys에서 생성합니다. 전체 단계별 안내는 키 설정 가이드에 있으며, CLI 대신 Kilo Code를 사용한다면 Claude와 함께 Kilo Code 설정하기를 참조하세요.
비용을 줄이는 네 가지 방법
- 프롬프트 캐싱을 작동하게 두세요. 캐시된 입력은 입력 요금의 10%이며, Claude Code는 각 단계마다 전체 대화를 다시 읽습니다. 이것만으로도 가장 강력한 방법입니다. 캐시 문서를 참조하세요.
- 서로 관련 없는 작업 사이에는 컨텍스트를 비우세요. 하나의 긴 세션을 계속 유지하면 각 단계마다 입력 토큰이 늘어납니다.
- 문제의 크기에 따라 모델을 선택하세요. 가장 큰 모델을 기본값으로 두지 마세요. Haiku와 Opus 사이의 단계당 비용 차이는 위 표에서 대략적으로 확인할 수 있습니다.
- 내부 호출을 Haiku로 보내세요.
ANTHROPIC_DEFAULT_HAIKU_MODEL를 사용하면 Claude Code가 자체적으로 수행하는 보조 호출이 가장 저렴한 모델로 전송됩니다.
프랑스에서 결제하기
구독은 카드에서 달러로 매월 인출되는 방식입니다. API 키 경로는 카드(Visa, Mastercard, Amex), Apple Pay, Google Pay 및 한 번에 충전할 수 있는 Link를 지원하는 Stripe 결제로 진행됩니다. 프랑스에서는 Pay by Bank를 사용할 수 없습니다. 이 결제 화면에서는 영국, 아일랜드 및 핀란드 구매자에게만 제공됩니다(Stripe에서 프랑스는 비공개 프리뷰 단계입니다). 선불 지갑이므로 최소 충전액은 $10이며 잔액은 만료되지 않습니다. 한 달 동안 코딩하지 않아도 인출되지 않습니다. 자세한 내용은 청구 문서를 참조하세요.
OpenAI의 에이전트와 비교하고 있나요? Codex에 대한 동일한 계산은 Codex 가격에서 확인할 수 있습니다.
자주 묻는 질문
Claude Code의 가격은 얼마인가요?
지불 방식에 따라 두 가지 가격이 있습니다. claude.ai 구독을 이용하면 Claude Code가 요금제에 포함됩니다. Pro는 월 $20(연간 결제 시 월 $17, 한 번에 $200)이고 Max는 월 $100부터입니다. API 키를 사용하면 구독 없이 토큰 단위로 결제합니다. 2026년 10월 3일 기준으로 Anthropic은 Claude Sonnet 5를 1M 토큰당 입력 $2.00 / 출력 $10.00으로, Claude Opus 5를 $5.00 / $25.00로 표시하며, 자체 문서에서는 실제 사용 비용을 활성 사용일 기준 개발자 1명당 약 $13, 즉 개발자 1명당 월 $150–250로 추정합니다. Kunavo에서는 동일한 모델이 $1.40 / $7.00 및 $3.50 / $17.50입니다.
Claude Code는 무료인가요?
CLI, 에디터 확장 기능 및 모든 설정은 무료입니다. 모델 호출은 무료가 아니며, 아무 비용도 지불하지 않고 Claude Code가 모델을 호출할 수 있는 무료 등급도 없습니다. Anthropic의 설치 문서에는 Claude.ai 무료 요금제가 Claude Code에 대한 액세스를 제공하지 않는다고 명시되어 있습니다. 가장 부담이 적은 방법은 구독 없이 사용량에 따라 결제하는 API 키입니다.
구독과 API 키 중 어느 쪽이 더 저렴한가요?
실행하는 에이전트 단계 수에 따라 달라지며, 작업한 날짜 수에 따라 달라지지 않습니다. 한 단계는 약 25,000 입력 토큰과 1,200 출력 토큰이며, Kunavo 요금 기준 Claude Sonnet 5에서 $0.043입니다. $20 Pro 구독은 따라서 한 달에 약 460단계, 즉 20단계 작업 약 23개에 해당합니다. 이보다 적으면 종량제가 더 저렴하고 코딩하지 않는 달에는 비용이 들지 않습니다. 이보다 많으면 사용량 한도에 도달할 때까지 구독이 유리합니다.
Claude Max의 5x 및 20x 제한은 무엇인가요?
구독에서는 사용량이 5시간의 이동 시간 창과 Claude 채팅과 공유되는 주간 한도로 제한됩니다. Max 등급은 Pro 사용량 한도의 배수(5x, 20x)로 설명되며, 동일한 시간 창을 사용하되 한도가 더 높습니다. 한도에 도달하면 다음 시간 창을 기다려야 합니다. API 키 방식에는 시간 창이 전혀 없으며, 사용한 만큼 결제합니다.
Claude Pro 구독으로 API에 액세스할 수 있나요?
아니요. claude.ai 구독과 Claude API 키는 별개의 제품이며 별도로 청구되고 서로 합산되지 않습니다. ANTHROPIC_AUTH_TOKEN과 같은 인증 변수와 API 키가 설정되어 있으면 Claude Code는 세션이 아니라 키를 사용합니다. 이 경우 요금제 한도는 적용되지 않고 사용량은 키 소유자에게 청구됩니다. 변수를 제거하면 Claude Code는 다시 구독을 사용합니다.
Claude Code 비용을 줄이려면 어떻게 해야 하나요?
효과가 큰 순서로 네 가지 방법이 있습니다. 프롬프트 캐싱이 작동하도록 두세요(캐시된 입력은 입력 요금의 10%로 청구되며 Claude Code는 각 단계마다 전체 대화를 다시 읽습니다). 서로 관련 없는 두 작업 사이에는 긴 세션을 계속 유지하지 말고 컨텍스트를 비우세요. 가장 큰 모델을 기본값으로 두기보다 문제의 크기에 따라 모델을 선택하세요. 그리고 ANTHROPIC_DEFAULT_HAIKU_MODEL을 통해 Claude Code의 내부 호출을 Haiku로 보내세요. ANTHROPIC_BASE_URL을 더 저렴한 엔드포인트로 지정하는 것도 이 네 가지 방법에 추가됩니다.