설치 프로그램은 같아도 결제 경로는 둘이다

Claude Code에 Claude 계정으로 로그인하면 Pro·Max 구독의 사용량 제한 안에서 쓴다. API 키로 인증하면 모델별 입력·출력 토큰에 따라 과금된다. Pro 요금제에 Claude Code 사용권이 들어 있지만, 그것이 API 호출 비용까지 덮는다는 뜻은 아니다. 무료 플랜에는 Claude Code가 포함되지 않는다.

Claude Code 비용에 영향을 주는 인증 방식, 읽은 파일, 재시도, 청구 내역 점검표
가격표를 보기 전에 현재 터미널의 인증 경로를 확인한다.

코드 한 줄보다 저장소를 읽는 양이 더 중요할 때

작은 함수 수정이라도 처음에 대형 저장소 전체를 읽히고, 실패할 때마다 같은 문맥을 다시 보낸다면 토큰과 사용량이 빠르게 늘어난다. 사용자들의 한도 경험도 프롬프트 횟수보다는 작업 규모와 문맥 크기에 따라 갈린다. 그래서 “하루 몇 번 쓸 수 있다”는 타인의 숫자를 내 계획표에 그대로 넣으면 위험하다. 작업 디렉터리를 좁히고 필요한 파일만 지정해 시작하는 편이 더 예측 가능하다.

내 환경에서 10분만 확인해보자

  1. Claude Code를 열어 로그인 계정과 API 키 사용 여부를 확인한다. 계정이 여러 개면 특히 주의한다.
  2. 모델 선택 상태를 확인하고, 실제 할 일 중 작은 수정 하나만 시킨다.
  3. 같은 작업에서 읽힌 파일 수, 재시도 횟수, 세션 제한 알림 여부를 적는다.
  4. API로 쓴다면 콘솔 사용량과 실제 청구 내역을 본다. 구독이라면 남은 한도와 리셋 시점을 본다.

Anthropic은 Claude Code에서 모델과 사용량을 확인하는 방법을 안내한다. API로 쓴다면 청구 내역을 함께 보고, 구독으로 쓴다면 제한 알림과 재설정 시각을 확인하자. 요금이 적게 나와도 수정 결과가 틀리면 재작업 비용이 생긴다. 성공한 작업 한 건에 든 총 시간과 비용으로 비교해야 한다.

핵심

Pro·Max 구독의 한도와 API 토큰 청구는 분리해 읽자. 먼저 인증 경로를 확인하고, 큰 저장소를 계속 다시 읽히는 습관부터 줄이는 편이 가격표 비교보다 빠르다.