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

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

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

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

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

Claude 구독과 API는 서로 다른 과금 방식

Claude.ai를 통해 로그인하면 Claude Code usage가 유료 요금제에 포함되며, 다른 Claude 서비스와 요금제의 전체 사용량 한도을 공유합니다. Claude Console로 인증하면 토큰 기반 API 과금이 적용됩니다. 실제 비용은 모델, 컨텍스트 크기, 작업량에 따라 달라집니다.

• 유료 Claude 요금제: 포함 사용량이 있는 구독 과금입니다. 사용량은 요금제의 공유 제공량에 집계되며 /usage와 Settings → Usage에서 확인합니다. 이미 요금제가 있고 대화형 작업을 할 때 적합합니다.
• Claude Console / API: 토큰 기반 과금입니다. 사용량은 API 조직과 Workspace에 집계되며, 세션은 /usage에서, 실제 과금은 Claude Console에서 확인합니다. API 과금, 예산, 조직 액세스를 별도로 관리할 때 적합합니다.

구독 인증과 API 인증을 혼동하지 않는 방법

Claude Code는 정해진 우선순위에 따라 인증 정보를 선택합니다. ANTHROPIC_API_KEY 환경 변수는 /login을 통한 OAuth 인증보다 우선합니다. 대화형 모드에서는 감지된 키 사용 권한을 한 번 묻고, 비대화형 -p 모드에서는 변수가 설정되어 있으면 키를 자동으로 사용합니다.

값을 출력하지 않고 변수가 설정되었는지 확인할 수 있습니다.

if [ "${ANTHROPIC_API_KEY+x}" = x ]; then
  printf '%s\n' 'Variable is set'
else
  printf '%s\n' 'Variable is not set'
fi

그런 다음 Claude Code 안에서 /status를 실행하세요. Login method 줄에는 현재 인증 방식이 표시되고, API Key를 사용 중이면 API key 줄이 추가로 나타납니다.

구독을 사용하려 했는데 환경 키가 활성화되어 있다면 현재 세션에서 다음 명령으로 제거하세요.

unset ANTHROPIC_API_KEY

이후 /status를 다시 실행합니다. 인증 정보 파일을 직접 삭제하지 말고, 저장된 계정을 바꿀 때는 공식 /logout과 /login 명령을 사용하세요.

/usage에서 사용량과 한도 읽기

/usage 상단의 Session 영역은 현재 세션의 input, output, cache read, cache write token 통계를 보여 줍니다. 달러 표시는 토큰 수를 바탕으로 로컬에서 계산되며 실제 청구액과 다를 수 있습니다.

API 사용자에게 이 영역은 세션 사용량를 추정하는 데 유용하지만, 공식 과금 기록는 Claude Console의 Usage 페이지입니다. /clear를 실행하면 새 세션의 카운터가 다시 시작됩니다.

Pro, Max, Team, Enterprise 구독자는 Claude Code 사용량이 요금제에 포함됩니다. 따라서 Session 달러 추정액는 구독에 청구되는 금액이 아닙니다. 같은 화면에서 구독자는 요금제 usage bar, 활동 통계, skills, subagents, plugins, MCP servers별 세부 내역을 볼 수 있습니다.

d와 w 키는 세부 내역의 범위를 최근 24시간과 7일 사이에서 전환합니다. 이 정보는 현재 컴퓨터의 로컬 기록에서 가져오므로 다른 기기나 claude.ai의 활동는 포함하지 않습니다.

현재 조건을 확인할 곳

다음 네 공식 페이지에서 이 주제를 확인할 수 있습니다.

• Claude Plans & Pricing — 현재 Claude Code를 포함하는 요금제와 명시된 한도
• Manage costs effectively — /usage 읽는 방법, API 과금 확인 위치, 한도 작동 방식
• Authentication — 로그인 방식, 인증 정보 우선순위, /status, /login, /logout
• Claude Console Usage — API 조직의 실제 usage와 비용

가격, 한도 크기, 기능 구성을 영구적인 값으로 기록하지 마세요. 결제하거나 인증 방식을 바꾸기 전에 현재 가격 페이지를 열어 확인하세요.

Claude Code 액세스 방식 선택하기

어떤 방식을 선택할지는 사용량을 어디에 집계해야 하는지에 따라 달라집니다.

1. 이미 유료 Claude 요금제이 있고 대화형으로 작업합니다. /login으로 로그인하고 /status의 Login method를 확인한 뒤 /usage에서 요금제 bar를 모니터링하세요.
2. organization에서 별도 API 과금과 지출 한도이 필요합니다. Claude Console 액세스를 사용하고 로컬 Session 추정액가 아니라 Console의 실제 청구액을 확인하세요.
3. Claude Code를 브라우저가 없는 CI나 스크립트에서 실행합니다. API 액세스도 한 가지 방법이지만 유일한 선택은 아닙니다. 공식 문서는 claude setup-token으로 만드는 장기 구독 OAuth 토큰도 지원합니다. 현재 활성화된 인증 방식에 따라 사용량의 결제 경로가 결정됩니다.
4. 유료 요금제 한도을 모두 사용했습니다. 한도 초기화를 기다리거나 요금제를 변경하거나 계정에서 제공되는 경우 usage credit을 활성화할 수 있습니다. 추가 사용량은 표준 API 요금로 청구됩니다.

액세스 방식을 바꾼 뒤 두 가지를 다시 확인하세요. /status는 “어떤 계정이 활성화되어 있는가?”에 답하고, /usage는 “지금 어떤 한도 또는 사용량 기록가 보이는가?”에 답합니다.

결제 경로를 지역별로 비교해야 한다면 별도의 regional guide도 참고할 수 있습니다. 이 페이지에서는 무료 클라이언트 설치와 유료 모델 액세스의 좁은 차이에만 집중합니다.

자주 묻는 질문

Free 요금제에서 Claude Code를 사용할 수 있나요?

현재 가격 페이지에서는 Claude Code가 유료 요금제에 포함되어 있고 Free에는 포함되어 있지 않습니다. 별도 구매 없이 클라이언트를 설치할 수는 있지만, 모델 요청에는 지원되는 유료 액세스 방식이 필요합니다.

구독 중인데 /usage에 dollar가 표시되는 이유는 무엇인가요?

현재 세션에서 사용된 token의 API 비용을 로컬에서 추정한 값입니다. 구독자의 청구액이 아닙니다. 같은 화면의 요금제 usage bar를 확인하세요.

API Key가 Claude Code를 구독에서 API 과금으로 전환할 수 있나요?

그렇습니다. ANTHROPIC_API_KEY가 설정되어 있고 사용이 승인되었다면 subscription OAuth보다 우선합니다. /status에서 현재 활성화된 방식을 확인하세요.

정확한 API 청구액은 어디에서 볼 수 있나요?

Claude Console에서 확인합니다. /usage의 Session 영역은 로컬 추정치 용도이며 실제 청구액과 다를 수 있습니다.

다음 단계: Claude Code용 API access

Claude Code에 별도의 API budget과 자신의 key를 사용하기로 했다면 Claude Code API 페이지를 확인하세요. 이는 Claude subscription이 아니라 BetterToken API integration이므로 설정 전에 current fields와 limits를 다시 확인해야 합니다.