클로드 코드 요금제는 Claude 도움말 기준으로 크게 두 갈래입니다. Pro나 Max 구독에 포함된 사용량으로 쓰는 방법과, 토큰을 쓴 만큼 API 요금으로 내는 방법입니다. 도움말은 이 둘을 "서로 다른 시스템"이라고 못 박습니다. 그래서 결제 전에 가장 먼저 볼 것은 가격표보다 어느 쪽으로 로그인되어 있는지입니다.
이 글은 Claude 도움말 센터의 "Use Claude Code with your Pro or Max plan" 문서(문서 날짜 2026년 8월 19일 표기)와 Claude Code 문서의 비용 관리 페이지(2026년 10월 4일 기준)의 내용만 옮긴 것이며, 구독료 금액은 문서가 가격 페이지(claude.com/pricing)를 보라고 안내하므로 적지 않았습니다. 요금제와 한도는 바뀔 수 있으니 결제 직전에는 내 화면을 한 번 더 확인하세요.
구독으로 쓰는 길과 API로 쓰는 길
도움말 문서에 따르면 Pro나 Max 구독이 있으면 웹·데스크톱·모바일의 Claude와 터미널의 Claude Code를 하나의 구독으로 함께 씁니다. 연결 방법은 구독이 활성화된 상태에서 Claude Code를 설치하고, 처음 실행할 때 Claude에 쓰는 것과 같은 계정으로 로그인하는 것입니다.
반대쪽 길은 Claude Console의 종량제(PAYG)입니다. 비용 관리 문서는 "Claude Code는 API 토큰 사용량으로 과금한다"고 설명하고, 구독 요금제 가격은 따로 가격 페이지를 보라고 안내합니다. 이미 콘솔 종량제로 로그인한 상태라면 Claude Code 안에서 /login을 실행해 구독으로 바꾸라고 문서가 알려 줍니다.
| 구분 | 구독(Pro·Max) | 콘솔 종량제(API) |
|---|---|---|
| 과금 방식 | 구독에 포함된 사용량, 한도에 닿으면 대기·추가 선택 | 토큰 사용량만큼 API 요금 |
| 로그인 | Claude 계정(웹과 같은 계정) | Claude Console 계정 또는 API 키 |
| 사용량 공유 | Claude와 Claude Code가 같은 한도를 나눠 씀 | 해당 없음 |
| 가격 확인 | claude.com/pricing (문서 안내) | 표준 API 요금 |
표에서 눈에 띄는 줄은 사용량 공유입니다. 문서는 Pro와 Max 모두 한도가 Claude와 Claude Code 사이에서 공유되어, 두 도구의 모든 활동이 같은 한도에서 차감된다고 적었습니다. 채팅을 많이 쓴 날은 코딩에 쓸 몫이 줄 수 있다는 뜻입니다.
구독인데 API 요금이 나가는 경우
도움말 문서가 별도 "Important" 문단으로 강조하는 부분입니다. 시스템에 ANTHROPIC_API_KEY 환경 변수가 설정되어 있으면, Claude Code는 구독 대신 그 API 키로 인증합니다. 그 결과 구독에 포함된 사용량이 아니라 API 사용 요금이 청구됩니다. 구독을 결제해 놓고도 이 변수 하나 때문에 따로 요금이 나갈 수 있다는 설명입니다.
그래서 처음 연결할 때는 이 순서로 보면 안전합니다.
1. 로그인 화면에서 Claude 구독 계정을 골랐는지 봅니다.
2. 이미 콘솔 종량제로 들어가 있었다면 /login으로 구독으로 전환합니다.
3. 구독 계정 선택지가 안 보이면 /logout으로 완전히 로그아웃하고, claude update를 실행하고, 터미널을 완전히 껐다 켠 뒤, 다시 claude를 실행해 올바른 계정을 고릅니다. 문서가 안내하는 4단계입니다.
4. 환경 변수에 API 키가 잡혀 있는지는 별도 문서("Manage API key environment variables in Claude Code")를 보라고 도움말이 연결해 둡니다.
한도에 닿으면 무엇을 고를 수 있나
문서는 한도에 닿았을 때의 선택지를 플랜별로 나눠 적었습니다.
- Pro 사용자: 한도에 계속 닿고 큰 저장소를 다룬다면 Max 5x로 올리기, 사용량 크레딧(usage credits) 켜기, 콘솔 계정으로 바꿔 API 크레딧 사기, 한도가 초기화될 때까지 기다리기
- Max 사용자: Max 5x라면 계속 한도에 닿을 때 Max 20x로 올리기, 사용량 크레딧 켜기, 콘솔 API 크레딧 사기, 초기화까지 기다리기
여기서 헷갈리기 쉬운 것이 사용량 크레딧과 API 크레딧입니다. 사용량 크레딧은 구독을 유지한 채 한도를 넘어서도 계속 쓰게 해 주는 장치이고, 비용 관리 문서에 따르면 Claude Code 안에서 /usage-credits를 실행하면 브라우저의 설정 화면이 열립니다. Pro·Max 구독자는 그 화면의 "Usage credits" 항목에서 크레딧을 켜고 끄고, 잔액과 이번 달 사용액, 월 지출 한도를 확인할 수 있다고 적혀 있습니다.
이 명령은 API 키로 인증한 상태에서는 쓸 수 없고, /login으로 claude.ai 구독에 로그인한 뒤에만 쓸 수 있다는 점도 문서에 있습니다. 반면 API 크레딧은 표준 API 요금으로 청구되며, 구독 요금제 가격과는 다른 체계입니다.
API 크레딧 자동 충전을 피하려면
도움말 문서는 API 크레딧을 쓰기로 했을 때의 결제를 이렇게 설명합니다. 사용량은 표준 API 요금으로 청구되고, 콘솔 계정에서 자동 충전(auto-reload)을 켜 두었다면 잔액이 줄 때 크레딧이 자동으로 추가됩니다. 자동 충전은 Claude Code가 아니라 Claude Console 계정에서 관리하는 별개의 기능이라고 합니다.
구독 범위 안에서만 쓰고 싶을 때 문서가 안내하는 방법은 세 가지입니다.
- API 크레딧을 쓰겠냐는 선택지가 나오면 거절합니다.
- 사용 기간이 초기화될 때까지 기다린 뒤 다시 씁니다.
- /status 명령으로 남은 사용량을 확인합니다.
선택지 자체가 뜨지 않게 하고 싶다면, 터미널에서 claude logout을 실행한 뒤 claude login으로 Pro나 Max 구독 계정만 인증하고 콘솔 자격 증명은 추가하지 않으면 됩니다. 도움말은 이렇게 하면 한도에 닿아도 API 크레딧 사용을 묻는 안내가 나오지 않는다고 설명합니다. 문서의 요약 문장도 같은 방향입니다. API 크레딧으로 넘어가는 모든 전환에는 사용자의 명시적 동의가 필요하다는 것입니다.
사용량은 어디서 확인하나
비용 관리 문서에서 /usage 화면은 구독자와 API 사용자에게 다르게 읽힙니다. 화면 위쪽의 Session 블록은 API 토큰 사용량을 보여 주는 것으로 API 사용자를 위한 칸이라고 하고, Pro나 Max 구독자는 사용량이 구독에 포함되어 있어 이 세션 비용 숫자가 청구 기준이 아니라고 적혀 있습니다. 구독자는 같은 화면에서 플랜 사용량 막대와 활동 통계, 사용량 내역을 본다고 합니다.
그러니 구독으로 쓰면서 /usage의 달러 표시를 보고 놀랄 필요는 없다는 설명입니다. 다만 같은 문서가 Claude Code가 이 달러 값을 토큰 수로 계산해 보여 주는 것이라고 밝히므로, 실제 청구는 결제 화면에서 확인해야 합니다.
비용 관리 문서에는 참고용 평균도 있습니다. 기업 환경 전체에서 개발자 한 명의 평균 비용은 활동한 날 기준 약 13달러, 한 달 기준 150~250달러이고, 사용자의 90%는 활동한 날 30달러 아래였다고 합니다. 개인 구독 비용이 아니라 API 과금 기준의 기업 사례이므로, 내 사용량의 기준으로 삼기보다 종량제가 얼마나 달라질 수 있는지 가늠하는 용도로만 보세요. 같은 문서는 비용이 모델 선택, 저장소 크기, 여러 인스턴스를 동시에 돌리는지 같은 사용 방식에 따라 크게 달라진다고 적었습니다.
Team·Enterprise는 따로 봅니다
이 글에서 다룬 도움말 문서는 개인이 Pro나 Max 구독으로 쓰는 경우를 대상으로 한다고 첫머리에 적혀 있습니다. 회사의 Team이나 Enterprise 플랜 소속이라면 "Use Claude Code with your Team or Enterprise plan" 문서를 보라고 안내합니다. 비용 관리 문서도 Team·Enterprise는 구성원의 좌석 허용량에서 차감되고, 콘솔과 클라우드 제공업체는 조직이 토큰 단위로 과금받는다고 구분합니다. 여러 로그인 방식이 섞인 조직에서는 각자 로그인한 방식대로 계량됩니다.
반대로 개인 Pro·Max 구독에는 관리할 조직이 없기 때문에, 비용 관리 문서는 사용량 크레딧으로 나간 지출을 본인이 직접 확인하라고 안내합니다. 확인 위치는 앞에서 본 /usage-credits가 여는 설정 화면의 사용량 크레딧 항목이고, 문서는 빠른 모드(fast mode)로 쓴 사용량도 같은 자리에서 확인하라고 적었습니다. 회사 계정으로 로그인했는지 개인 계정으로 로그인했는지에 따라 읽어야 할 문서가 갈리니, 처음 로그인할 때 어떤 계정을 골랐는지부터 기억해 두세요.
결제하기 전에 이 순서로 확인하세요
1. 내가 쓸 길을 정합니다. 웹의 Claude와 함께 쓰는 구독인지, 쓴 만큼 내는 API 종량제인지부터 고릅니다.
2. 구독이라면 가격은 claude.com/pricing에서 확인합니다. 이 글의 두 문서에는 구독료 금액이 적혀 있지 않습니다.
3. 터미널에서 ANTHROPIC_API_KEY 변수가 설정되어 있는지 봅니다. 있으면 구독이 아니라 API 요금으로 쓰일 수 있습니다.
4. 처음 로그인할 때 Claude 구독 계정을 골랐는지 확인하고, 콘솔로 들어갔다면 /login으로 바꿉니다.
5. 한도에 닿았을 때를 미리 정합니다. 기다릴지, 사용량 크레딧을 켤지, 한 단계 위 플랜으로 갈지, API 크레딧으로 넘어갈지 정해 두면 안내 화면에서 헷갈리지 않습니다.
6. API 크레딧으로 넘어가기로 했다면 콘솔의 자동 충전 설정을 먼저 확인합니다.
7. 평소에는 /status와 /usage로 남은 사용량을 봅니다.
확인 자료
- Use Claude Code with your Pro or Max plan (Claude 도움말 센터)
- Manage costs effectively (Claude Code Docs)
이 글은 위 두 문서(2026년 10월 4일 기준)에 적힌 내용만 옮겼습니다. 요금제와 사용 한도는 바뀔 수 있으니 결제 직전에 공식 화면에서 다시 확인하세요.