Claude Code는 무료인가요? 무료인 것과 아닌 것, 한 달 비용

Claude Code CLI는 무료로 설치할 수 있습니다. 실행은 무료가 아닙니다. Claude Code가 수행하는 모든 작업 — 파일 읽기, 편집 제안, 명령 실행, 결과 확인 — 은 누군가 비용을 지불하는 model call입니다. Anthropic은 새 API 계정에 테스트용 소액 무료 credit을 제공하지만, 해당 grant를 넘어서는 무료 tier는 없습니다 — credit을 모두 사용하면 모든 호출에 비용이 청구됩니다.

비용은 두 가지 결제 경로 중 어떤 것을 선택하느냐에 전적으로 달려 있습니다 — claude.ai 구독 또는 토큰당 청구되는 API key — 그리고 두 방식은 매우 다른 사용 패턴에 적합합니다. 구독 없이 실행하는 가장 저렴한 방법은 종량제 key입니다. Kunavo에서는 모든 Claude model이 Anthropic 정가보다 30% 저렴하고, 월 요금 없이 $10 충전부터 사용할 수 있으며, 설정은 몇 개의 환경 변수로 끝납니다(아래 참조). 실제 계산은 다음과 같습니다.

무료인 것과 무료가 아닌 것

무료로 이용하는 유일한 방법은 게스트 패스입니다. 자격을 갖춘 Pro 및 Max 구독자는 Claude 유료 요금제를 처음 이용하는 사람에게 Claude Code가 포함된 Pro 7일 체험 패스를 공유할 수 있습니다. 패스는 /passes 명령으로 확인할 수 있습니다. 패스 수량은 제한되어 있고 만료될 수 있으므로 Claude Code를 체험하기 위한 방법이지 무료로 계속 사용하기 위한 방법은 아닙니다(Anthropic 게스트 패스 안내, 2026-10-10 확인). Free 요금제에는 Claude Code가 포함되지 않습니다.

Codex는 반대 사례입니다. ChatGPT Free 요금제에는 데스크톱 앱에서 사용할 수 있는 Codex가 포함됩니다(사용 한도 적용). 자세한 비교는 Codex는 무료인가요?에서 확인할 수 있습니다.

결제 방법 두 가지

두 방식은 중첩되지 않으며, 어떤 방식이 활성화되어 있는지가 중요합니다. ANTHROPIC_AUTH_TOKEN 또는 ANTHROPIC_API_KEY와 같은 credential 변수가 설정되어 있으면 Claude Code는 저장된 claude.ai 로그인 대신 해당 변수를 사용합니다. 구독은 일시 중지된 채 사용되지 않고, 구독 한도는 적용되지 않으며, 사용량은 key에 청구됩니다. 변수를 해제하면 Claude Code는 구독으로 돌아갑니다. 지금 어떤 방식이 활성화되어 있는지 확인하려면 /status를 실행하세요.

실제 한 달 비용

비용은 달력상의 날짜가 아니라 agentic step에 따라 달라집니다. Claude Code는 매 step마다 system prompt, 대화 내용 및 새로운 파일 컨텍스트를 다시 보내므로, 하나의 step은 채팅 메시지보다 큽니다 — 일반적으로 입력 토큰 약 25,000개와 출력 토큰 1,200개입니다. claude-sonnet-5에서 Kunavo 요금을 적용하면 다음과 같습니다:

이는 최적화되지 않은 수치입니다 — prompt caching 없이 모든 작업을 주 model에서 처리한 경우입니다. 가볍거나 탐색적인 사용은 월 한 자릿수 달러 수준이지만, 부담이 커지는 구간은 매일 지속적으로 수행하는 agentic 작업이며, 바로 이 지점에서 토큰당 요금이 누적됩니다. 비용 계산기에서 직접 계산하거나, 구독 tier, model별 전체 요금표 및 두 경로 간 손익분기점을 확인하려면 Claude Code 가격을 참조하세요. 위의 “Anthropic 정가 기준” 열은 Anthropic 공식 API 가격에서 가져온 것으로, 각 Claude model의 현재 토큰당 정가와 여기에서 동일한 model에 부과되는 비용을 나란히 보여 줍니다.

실행하는 가장 저렴한 방법

Claude Code는 ANTHROPIC_BASE_URL를 기본적으로 읽으므로 Anthropic Messages API를 제공하는 모든 엔드포인트에서 작동합니다 — plugin도, 수정된 binary도, 별도로 관리해야 하는 proxy도 필요하지 않습니다. 이것이 더 낮은 토큰당 요금으로 사용하는 지원 경로입니다:

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

주요 모델에서 목록 가격보다 약 30% 저렴하고, 동일한 모델과 동일한 CLI를 사용합니다. 모델 관련 줄은 그대로 유지하세요. Claude Code의 기본 내장 모델과 opus 및 sonnet 별칭은 Anthropic의 최신 모델을 따르며, Kunavo가 아직 그중 하나를 제공하지 않으면 요청이 404를 반환합니다. sonnet 별칭은 Sonnet 5.5를 요청하지만 Kunavo는 이를 제공하지 않으므로 ANTHROPIC_DEFAULT_SONNET_MODEL가 고정하지 않는 한 /model sonnet, opusplan의 실행 단계 및 sonnet으로 설정된 서브에이전트가 404를 반환합니다. opus 고정값은 Opus 5.5이며 Claude Code v2.1.280 이상이 필요합니다. 이전 버전이 설치되어 있다면 claude update를 실행하세요. $10 충전부터 종량제로 사용할 수 있고 월별 요금이 없으며 잔액도 만료되지 않으므로, 실제로 아무것도 하지 않는 달에는 비용이 전혀 들지 않습니다. 전체 안내는 Claude Code 설정 가이드에서 확인하세요. 이미 요금제를 사용 중인데 사용 한도에 계속 도달한다면, Claude 한도에 도달하면 어떻게 되는지에서 요금제를 유지하면서 서비스가 중단된 시간대에 키를 추가하는 손익분기 계산을 제공합니다.

실제로 수치를 바꾸는 네 가지 방법

1. 백그라운드 작업을 Haiku로 라우팅하세요. Claude Code는 요약과 제목을 위해 자체 호출을 생성합니다. ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 ($0.70 / $3.50 per 1M)를 사용하면 이를 가장 저렴한 model로 옮길 수 있습니다. 한 줄만 추가해 지속적으로 절약할 수 있습니다 — Anthropic Claude API 가격 목록에는 이 전환 대상이 되는 model별 요금이 공식 요금과 할인 요금으로 나란히 표시되어 있습니다.
2. 새 작업으로 시작하세요. 각 step마다 컨텍스트가 다시 전송되므로 하나의 장기 세션은 제곱에 비례해 비싸집니다. 새 작업은 다시 작은 컨텍스트로 시작합니다.
3. prompt caching을 활용하세요. 캐시된 입력에는 입력 요금의 10%가 청구됩니다. 매 step마다 안정적인 접두사를 다시 보내는 루프에서는 이것이 이용 가능한 가장 큰 단일 절약 방법입니다(작동 방식).
4. key에 상한을 설정하세요. 편집기에 대시보드에서 지출 한도가 있는 자체 key를 부여하세요. 폭주하는 루프가 예상치 못한 비용이 아니라 상한 내 비용으로 제한됩니다.

사람들이 이 주제에서 자주 잘못 이해하는 것

“Claude Code는 오픈 소스이므로 무료다”

client를 무료로 설치할 수 있다는 사실은 model call과 아무 관계가 없습니다. CLI는 저렴한 부분이고, 비용은 inference에서 발생합니다.

“Claude Pro 구독에 API가 포함된다”

그렇지 않습니다. 구독과 API key는 서로 다른 과금 체계를 가진 별도의 제품입니다 — 하나는 claude.ai가, 다른 하나는 console.anthropic.com이 처리합니다. Pro는 구독 경로를 통한 Claude Code 사용만 지원하며, key를 통한 사용에는 적용되지 않습니다.

“작은 model을 사용하면 무료 tier가 있을 것이다”

더 저렴할 뿐, 무료는 아닙니다. claude-haiku-4-5는 1M당 $0.70 / $3.50로 Sonnet의 일부 비용에 불과하지만, 여전히 요금이 청구됩니다.

“gateway를 사용하면 Anthropic에 비용을 내지 않아도 된다”

여전히 inference 비용을 지불합니다 — 다만 다른 요율로, 다른 업체에 지불할 뿐입니다. 달라지는 것은 가격과 과금 모델이지, 비용이 발생하는지 여부가 아닙니다.

자주 묻는 질문