Claude Code를 무료로 사용할 수 있을까? 설치, 구독, API

Claude Code 클라이언트는 별도 비용 없이 설치할 수 있지만, Claude.ai Free 요금제에는 Claude Code가 포함되지 않습니다. 실제 요청을 보내려면 유료 Claude 요금제, Console/API billing 또는 지원되는 third-party provider가 필요합니다. 무료 설치와 무료 모델 사용은 같은 뜻이 아닙니다.

Claude Code에서 무료인 것과 유료인 것

클라이언트를 다운로드하고 설치하는 데 별도의 요금은 없습니다. 하지만 설치만으로 모델 액세스가 제공되지는 않습니다. Claude Code는 유료 Claude 요금제, Claude Console 또는 지원되는 엔터프라이즈 플랫폼을 통해 인증해야 합니다.

공식 Claude Code 설정 가이드는 Claude.ai Free 요금제에 Claude Code access가 포함되지 않는다고 명시합니다. 실제 요청에는 유료 Claude 요금제, Claude Console/API 과금 또는 지원되는 타사 제공업체가 필요합니다. Claude 가격 페이지는 변경될 수 있는 현재 유료 요금제 기능과 한도를 확인할 때만 사용하세요.

“Claude Code는 무료다”라는 표현은 보통 클라이언트 자체만 의미합니다. 모델 요청은 유료 요금제 제공량를 사용하거나 과금 대상 API 토큰을 소비합니다.

구독과 API는 동일한 잔액을 공유하지 않음

• 유료 Claude 요금제: Claude.ai 계정으로 OAuth 로그인하며 usage는 Claude와 Claude Code의 공용 한도에 집계됩니다. /usage에서는 Session의 dollar estimate가 아닌 요금제 bar를 확인합니다.
• Anthropic Console: API는 token과 workspace limit에 따라 과금됩니다. 실제 비용은 Claude Console Usage에서 확인합니다.
• BetterToken API: 본인의 BetterToken API Key와 Base URL을 사용하며 실제 usage는 BetterToken Dashboard에서 확인합니다.

Claude 구독은 API balance를 만들지 않고 API 충전도 Pro나 Max를 활성화하지 않습니다. Claude Code에는 credential priority가 있어 ANTHROPIC_API_KEY가 저장된 구독 로그인보다 우선할 수 있습니다. 예상 밖 과금이 보이면 /status에서 active authentication을 확인하고 현재 mode의 /usage를 확인하세요.

/usage의 Session dollar value는 현재 session token으로 계산한 local estimate이며 invoice가 아닙니다. 구독자는 요금제 bar를, API 사용자는 provider dashboard를 확인합니다. Key나 sign-in을 바꾼 뒤 /status와 /usage를 반복하고 key, token, credential file을 공개하지 마세요.

Claude 구독이 적합한 경우

유료 요금제는 한 사람이 interactive하게 사용하며 Claude 제품을 하나의 계정에서 이용하려는 경우에 적합합니다. Terminal과 다른 Claude surface가 한도를 공유합니다. Unlimited가 아니므로 결제 당일 limit, 지원 국가와 결제 방식, 합산 usage, team administration 필요 여부를 확인하세요.

API가 적합한 경우

오래된 글의 수치가 아니라 현재 model과 rate로 계산하세요. 현재 BetterToken 가격 열기

API는 usage-based cost, automation, CI, team, 분리된 key와 budget에 적합합니다. Anthropic API 직접 연결은 Console billing과 limit를 사용합니다. BetterToken은 별도 계정, 본인의 API Key, Anthropic-compatible Base URL을 사용하며 연결 시 결제 방식, model, 가격을 확인합니다.

Claude Code용 BetterToken Base URL은 /v1 없는 https://bettertoken.ai입니다. 전체 설정은 현재 Claude Code setup page를 따르세요.

잘못된 제품에 이중으로 결제하지 않는 선택법

Claude user plan과 별도 API workflow 중 무엇이 필요한지, key와 결제 기록을 어디에 둘지, provider가 지역과 결제 방식을 지원하는지 확인합니다. 결제 시나리오는 러시아의 Claude Code: 구독 또는 API를 참고하세요. 이 글은 무료 설치의 경계만 다룹니다.

자주 묻는 질문

무료 Claude.ai 요금제에서 Claude Code를 쓸 수 있나요?

아니요. 현재 문서에 따르면 유료 요금제, Console/API 또는 지원되는 third-party provider가 필요합니다.

Client 설치에 별도 비용이 있나요?

아니요. 비용은 model access와 usage에 발생하며 command download 자체에는 부과되지 않습니다.

Claude 구독에 Anthropic API balance가 포함되나요?

아니요. 별도 billing system입니다. /status에서 active method를 확인할 수 있습니다.

BetterToken이 Claude 구독을 판매하나요?

아니요. BetterToken은 본인의 account와 key를 쓰는 독립 API access이며 Claude Pro, Max 또는 공유 Claude.ai account가 아닙니다.

결론

Claude Code는 설치만 무료입니다. 실제 작업에는 유료 model access가 필요합니다. 구독이나 API를 선택하고 /status로 authentication을 확인한 뒤 limit와 cost를 평가하세요.

오래된 수치 없이 API cost 확인하기

Model ID, availability, rate는 바뀔 수 있습니다. BetterToken catalog의 현재 input, output, cache Token 가격으로 계산하고 minimal test 후 실제 Dashboard 차감과 비교하세요. 이는 Claude 구독 가격이 아닌 별도 API budget입니다.