"Claude Code는 얼마인가요?"라는 질문의 답은 "따로 돈 내는 제품이 아닙니다"에서 시작합니다. Claude Code는 유료 플랜(Pro·Max·Team·Enterprise)에 포함되어 있고, 별도로 API(다른 프로그램이 기능을 가져다 쓰도록 연결해 주는 통로) 키로 쓰면 그때만 쓴 만큼 과금됩니다. 이 글은 2026년 7월 기준 공식 문서를 바탕으로 두 과금 경로와 플랜별 차이, 흔한 과금 함정을 정리합니다.
경로 ① 구독 플랜에 포함해서 쓰기
Pro 플랜(미국 기준 월 $20) 이상이면 Claude Code가 구독에 포함됩니다. 중요한 것은 Claude 채팅과 Claude Code가 하나의 사용량을 공유한다는 점입니다. 채팅을 많이 쓰면 Claude Code에 쓸 수 있는 양이 줄고, 그 반대도 마찬가지입니다. 사용량은 5시간 단위 세션 한도로 리셋되고, 별도로 주간 한도가 있습니다. VS Code·Cursor 등 VS Code 계열과 JetBrains IDE에서 확장으로 쓸 때도 같은 구독·같은 한도로 계산됩니다.
플랜별로 정리하면 이렇습니다.
Pro — 무료 대비 세션당 최소 5배 사용량. Claude Code와 Cowork 접근 포함. 단, Console을 통한 API 사용은 포함되지 않습니다.
Max — Pro의 5배(5x)·20배(20x) 두 티어. 전 모델 주간 한도에 더해 Sonnet 전용 주간 한도가 따로 있습니다. 구체 가격은 공식 가격 페이지(claude.com/pricing)에서 확인해 주세요.
Team — 모든 시트에 Claude Code 포함(최소 5명, 최대 150시트). Standard 시트는 Pro의 1.25배 세션 사용량이고, 사용량이 많은 구성원을 위한 Premium 시트가 따로 있습니다.
Enterprise — 신규·셀프서브 플랜은 단일 시트에 Claude·Claude Code·Cowork 접근이 모두 포함되지만, 시트비는 접근 권한만 담고 사용량은 전액 표준 API 요금으로 별도 과금됩니다. 대신 플랜 차원의 사용량 한도가 없습니다.
한도가 다 떨어지면 — usage credits
포함 사용량을 다 쓰면 두 가지 선택지가 있습니다. 리셋을 기다리거나, usage credits(포함 한도 소진 후 표준 API 요금으로 이어서 쓰는 선택 기능)를 켜는 것입니다. Settings > Usage에서 활성화하며, 켜 두지 않으면 추가 과금 없이 그냥 멈춥니다. 한도 구조 전반은 사용량 한도 가이드에서 자세히 다룹니다.
경로 ② API 키로 종량제 사용
Console 계정의 API 키로 로그인하면 구독과 무관하게 쓴 토큰만큼 과금됩니다. 공식 문서(code.claude.com/docs/en/costs)가 밝힌 기업 배포 기준 수치는 개발자당 활성일 평균 약 $13, 월 $150–250이며, 사용자의 90%는 활성일 기준 $30 미만입니다. 물론 모델 선택·코드베이스 크기·자동화 사용에 따라 편차가 큽니다.
가장 흔한 과금 함정 — API 키 환경변수
구독이 있는데도 API 요금이 청구되는 사례의 대표 원인은 ANTHROPIC_API_KEY 환경변수입니다. 이 변수가 시스템에 설정되어 있으면 Claude Code는 구독 대신 API 키를 우선 사용해 종량제로 과금합니다. 구독만으로 쓰려면 이 변수를 제거하고, 로그인 시 구독 계정("Claude account with subscription")을 선택해야 합니다. 현재 어느 쪽으로 쓰고 있는지는 Claude Code 안에서 /usage와 /status 명령으로 확인할 수 있습니다.
정리 — 나는 어느 쪽이 유리한가
개인 개발자라면 대부분 구독(Pro에서 시작, 부족하면 Max)이 예측 가능하고 유리합니다. 사용량이 들쑥날쑥한 집중 스프린트형이거나 CI(코드 자동 빌드·테스트 파이프라인) 같은 자동화에 붙이려면 API 종량제가 맞습니다. Claude Code가 처음이라면 사용법 가이드부터 보시는 것을 권합니다. 가격과 플랜은 Anthropic 정책에 따라 변경될 수 있습니다.
이 글은 2026년 7월 3일 기준 Anthropic 공식 지원 문서(support.claude.com)와 Claude Code 문서(code.claude.com/docs/en/costs)를 바탕으로 작성되었습니다.