클로드 코드 사용량 확인, 남은 한도가 궁금할 때 이 순서로 보면 된다

클로드 코드 사용량 확인은 대화 입력창에 /usage를 입력하거나 웹의 사용량 설정을 여는 것부터 시작한다. 작업을 얼마나 더 할 수 있는지 궁금하면 구독 한도의 사용 비율과 초기화 시각을 보고, 날짜별로 쓴 토큰이 궁금하면 ccusage로 로컬 기록을 조회하면 된다. 화면의 달러 금액은 예상 비용이다. 구독자의 추가 청구액과 구분해서 읽어야 한다.

이 글에서 알 수 있는 것

• /usage에서 남은 한도와 세션 비용을 읽는 순서
• Claude 기록만 조회하는 ccusage 명령과 결과의 의미
• 한도에 걸렸을 때 재시작이나 요금제 변경 전에 확인할 항목

Claude Code 2.1.263과 ccusage 20.0.20을 실행해 확인했다. 개인 사용량 수치는 공개하지 않고, 실제로 나타난 항목과 따라 할 수 있는 명령을 정리했다. 개인 Pro·Max 구독으로 대화형 CLI를 쓰는 경우가 중심이다. 회사 계정의 조직별 한도나 별도 API 청구는 관리자 설정에 따라 달라진다.

2026년 9월 14일부터 주간 한도는 어떻게 바뀌었나?

2026년 9월 13일 오후 11시 59분(PT)에 Claude Code의 임시 주간 한도 50% 상향은 종료됐다. 다만 프로모션 전 수준으로 모두 돌아간 것은 아니다. Anthropic은 2026년 9월 14일부터 대상 플랜의 Claude Code 주간 한도를 프로모션 전보다 25% 높은 수준으로 유지한다고 공식 도움말을 갱신했다.

구분	프로모션 전을 100으로 둔 설명용 지수	적용 범위
2026년 5월 13일~9월 13일 임시 프로모션	150	Claude Code 주간 한도
2026년 9월 14일부터	125	Claude Code 주간 한도
5시간 사용 한도	변화 없음	이번 프로모션 대상이 아님

대상은 Pro·Max·Team과 좌석 기반 Enterprise 플랜이다. Free와 사용량 기반 Enterprise 좌석은 해당하지 않는다. 변경은 Claude Code의 CLI·IDE 확장·데스크톱·웹에 적용되며, 일반 Claude 웹·데스크톱·모바일과 Claude Cowork의 한도는 이 변경에 포함되지 않는다.

위 100·150·125는 절대 토큰 수나 질문 횟수가 아니라 변화폭을 비교하기 위한 지수다. 계정에 표시된 비율만으로 실제 작업량이 얼마나 줄었는지를 단정할 수는 없다. 현재 적용 상태는 /usage의 주간 항목과 초기화 시각으로 확인한다. 경고 배너와 Usage 화면이 다르면 즉시 한쪽을 정답으로 단정하지 말고 확인 시각·모델·작업 종류·양쪽 화면을 함께 남겨 두는 편이 좋다.

이 변경 내용은 2026년 9월 14일 확인한 Anthropic의 Claude Code 주간 한도 프로모션 공식 도움말에 근거한다.

클로드 코드 사용량 확인, 어디서 무엇을 보면 되나?

지금 계속 작업할 수 있는지는 구독 한도에서, 지난 작업에 쓴 양은 토큰 기록에서 확인한다. 둘을 구분해 두면 서로 다른 숫자가 나와도 읽기 쉽다.

궁금한 것	확인할 곳	읽어야 할 항목
지금 더 작업할 수 있나?	Claude Code의 /usage	사용 비율과 Resets 시각
현재 대화에서 얼마나 썼나?	/usage 위쪽 Session	토큰과 예상 비용
날짜별로 얼마나 썼나?	ccusage의 Claude 일별 보고서	날짜·토큰·모델·예상 비용
브라우저에서 한도를 보고 싶나?	Claude 설정의 사용량 화면	계정의 플랜 사용량

여기서 말하는 사용량은 하나의 숫자가 아니다. 구독 한도는 일정 기간 안에 쓸 수 있는 양이고, 세션 토큰은 현재 대화에서 처리한 양이다. ccusage의 일별 합계는 이 컴퓨터에 남은 기록을 날짜별로 모은 값이다.

웹에서 사용량과 초기화 시각은 어디서 보나?

터미널을 열지 않아도 Claude 웹 사용량 설정에서 구독 한도를 확인할 수 있다. Claude Code에서 쓰는 계정과 같은 계정으로 로그인한다. 메뉴로 찾을 때는 프로필 메뉴 → 설정(Settings) → 사용량(Usage) 순서로 연다.

1. 현재 세션(Current session)에서 5시간 구간의 사용 비율과 초기화까지 남은 시간을 본다. Claude Code의 대화 한 개에 쓴 토큰 수와는 다른 항목이다.
2. 주간 한도(Weekly limits)에서 각 항목의 사용 비율과 초기화 시각을 함께 본다. 현재 세션에 여유가 있어도 주간 한도에 걸렸다면 세션 초기화만 기다려서는 해결되지 않을 수 있다. 표시되는 모델 구분은 내 계정 화면을 따른다.
3. 추가 사용량·크레딧(Usage credits)은 기본 구독 한도와 따로 읽는다. 기본 한도를 다 쓴 뒤 유료로 이어 쓰는 설정이므로, 잔액이나 지출 한도를 남은 무료 사용량으로 해석하지 않는다. 한도를 조회하는 데 추가 결제를 켤 필요는 없다.

예를 들어 현재 세션에 80% 사용이라고 나오면 그 구간 한도의 약 20%가 남았다는 뜻이다. 앞으로 질문을 20번 더 보낼 수 있다는 뜻은 아니다. 이는 화면을 읽는 방법을 설명하기 위한 가상 수치이며, 실제 내 잔여량은 로그인한 화면에서 확인한다.

로그인 화면이 나오면 먼저 로그인한 뒤 위 사용량 링크를 다시 연다. CLI와 값이 다르면 계정이 같은지 확인하고 양쪽을 새로 조회한다. 웹 채팅과 Claude Code는 구독 한도를 공유하므로 웹에서 한 작업도 영향을 줄 수 있다. API 키로 쓰는 경우의 토큰·비용은 Claude Console 사용량에서 별도로 확인한다.

이 웹 안내는 2026년 9월 9일 확인한 Claude 공식 사용량 도움말에 근거한다. 개인 Pro·Max 구독을 중심으로 설명했으며 조직 계정과 플랜에 따라 표시 항목이 다를 수 있다.

화면으로 보기: 메뉴와 기본 구독 한도

아래 두 장은 VibeCoderJournal의 사용량 안내에 공개된 화면을 항목 설명을 위해 발췌 인용한 것이다. 직접 촬영한 내 계정 화면이 아니다. 원문은 2026년 8월 10일 공개됐으며, 촬영일은 명시돼 있지 않다. 표시된 비율·날짜·금액은 화면 예시로 읽는다. 이미지를 누르면 크게 볼 수 있다.

왼쪽 Usage가 사용량 메뉴다. Current session의 30% used는 해당 구간에서 사용한 비율, Resets in 3 hr 11 min은 초기화까지 남은 시간이다. 아래 Weekly limits → All models의 5% used는 주간 사용 비율이다. 두 막대는 서로 다른 기간이므로 각각 읽는다.

가운데 ‘temporarily boosted’ 상자는 당시의 임시 한도 안내다. 캡처에 적힌 8월 프로모션은 현재 혜택을 뜻하지 않는다. 지금 적용되는 한도와 모델별 항목은 본인 계정 화면에서 확인한다.

화면으로 보기: 유료 크레딧은 별도 항목

Monthly spend limit은 월 지출 한도, Current balance는 크레딧 잔액이다. 화면의 $100.00은 남은 무료 사용량이 아니다. 기본 구독 한도를 조회하기 위해 이 기능을 켜거나 Buy usage credits를 누를 필요는 없다. 캡처의 할인 표시도 현재 제공 여부를 별도로 확인해야 한다.

사용량 링크에서 업그레이드 안내가 나온다면 로그인 계정의 플랜을 확인한다. 이번에 직접 확인한 Free 계정에서는 사용량 화면 대신 Pro·Max 안내가 표시됐다.

/usage는 어디에 입력하고 어떻게 읽나?

터미널에서 claude로 대화 화면을 연 뒤, Claude Code의 입력창에 아래 명령을 넣는다. 일반 셸에 바로 입력하는 명령과는 위치가 다르다.

/usage

직접 연 화면에는 위쪽부터 Session, Current session, Current week (all models)가 표시됐다. 이름이 비슷한 앞의 두 항목을 구분해서 읽는 게 핵심이다.

Session은 지금 대화의 기록이다. 토큰 수와 Total cost가 나온다. 확인용으로 새로 연 대화는 모델 요청을 보내지 않아 이 비용이 0으로 표시됐다. 그런데 그 아래 구독 사용 비율은 이미 사용한 만큼 표시돼 있었다. 새 창을 열었다고 계정 한도까지 초기화된 것이 아니라는 뜻이다.

Current session은 현재 한도 구간이다. 사용한 비율과 Resets 뒤의 초기화 시각을 확인한다. 이어지는 주간 항목도 함께 본다. 현재 구간에 여유가 있어도 주간 항목이나 계정에 표시되는 추가 제한에 도달하면 계속 쓰지 못할 수 있다.

화면에는 모델별 주간 항목도 나타났다. 다만 특정 모델의 별도 한도가 모든 계정에 항상 있다고 단정할 수는 없다. 내 계정에 실제로 표시된 항목과 초기화 시각을 기준으로 판단하는 편이 정확하다.

위쪽 비용 숫자를 보고 구독료 외에 돈이 붙었다고 놀랄 필요는 없다. Claude Code 공식 비용 안내는 이 값을 토큰으로 계산한 추정치로 설명한다. Pro·Max 구독자의 일반 구독 사용분을 그대로 청구하는 숫자가 아니다. 별도로 켠 사용량 크레딧이나 API 결제는 따로 확인해야 한다.

/cost와는 무엇이 다른가?

이번에 확인한 2.1.263에서는 /cost도 /usage와 같은 사용량 화면을 열었다. 예전 설명대로 두 명령을 완전히 다른 화면으로 외울 필요가 없다. 우선 /usage로 열고 위쪽 세션 기록과 아래쪽 구독 한도를 나눠 읽으면 된다.

화면 구성이 다르면 터미널에서 claude --version으로 버전을 확인한다. 이 글의 직접 실행 결과는 위 버전 기준이며, 오래된 설치 환경까지 같이 표시된다고 볼 수는 없다.

남은 토큰과 한도 초기화 시각은 어떻게 확인하나?

구독 화면은 남은 토큰의 고정 총량보다 사용 비율과 초기화 시각을 확인하는 용도로 읽는 게 맞다. 같은 횟수로 요청해도 대화 길이, 모델, 작업 복잡도와 노력 수준에 따라 사용량이 달라진다. Claude의 사용량·길이 제한 안내도 이 차이를 설명한다.

가령 사용 비율이 절반이라고 해서 앞으로 같은 질문을 정확히 같은 횟수만큼 보낼 수 있다는 뜻은 아니다. 짧은 문장 수정을 하다가 큰 프로젝트 분석으로 바꾸면 한도가 줄어드는 속도도 달라질 수 있다. 다음 작업이 큰지 작은지와 화면에 표시된 초기화 시각을 함께 보는 게 실용적이다.

브라우저에서는 Claude의 설정에서 사용량을 연다. 같은 계정의 Claude 채팅과 Claude Code는 구독 사용량을 공유하므로, 터미널 작업이 적었던 날에도 채팅 사용 때문에 여유가 줄 수 있다. Pro·Max에서 Claude Code를 사용하는 공식 안내에서 공유 범위를 확인할 수 있다.

Showing last-known usage라는 표시가 있다면 마지막으로 불러온 값이다. 공식 안내에 따르면 조회 실패 시 최근 60분 안에 불러온 값이 표시될 수 있다. 이때는 r로 다시 조회하거나 웹의 사용량 화면과 비교한다. 오래된 값을 지금 남은 양으로 오해하지 않는 게 중요하다.

날짜별 토큰은 ccusage로 어떻게 확인하나?

ccusage는 컴퓨터에 저장된 사용 기록을 읽어 보고서를 만드는 외부 도구다. 계정 전체의 남은 구독 한도를 조회하는 명령과 용도가 다르다. 여러 날의 기록을 살펴보고 어느 날 사용이 늘었는지 찾을 때 쓴다.

Node.js와 npm을 쓸 수 있는 일반 터미널에서 아래 명령을 실행한다. Claude Code 대화창 밖에서 입력해야 한다.

npx --yes ccusage@20.0.20 \
  claude daily --offline

확인한 버전을 그대로 실행하도록 버전 번호를 고정했다. 이 버전의 기본 보고서는 여러 AI 코딩 도구를 함께 다룬다. 위 명령에 claude를 넣은 이유는 Claude 기록만 보기 위해서다. 최신 버전으로 바꿀 때는 ccusage 공식 명령 옵션도 함께 확인한다.

--offline은 Claude 모델의 가격을 조회할 때 캐시된 가격 자료를 쓰는 옵션이다. 처음 패키지를 내려받는 과정에는 인터넷 연결이 필요할 수 있다. 이 옵션이 모든 통신을 막는다는 뜻이나, 실행 프로그램의 보안을 보증한다는 뜻은 아니다.

특정 날짜만 확인하려면 시작일과 종료일을 넣는다. 아래는 2026-09-06 하루만 조회한 명령이다.

npx --yes ccusage@20.0.20 \
  claude daily \
  --since 20260906 --until 20260906 \
  --offline --json

직접 실행한 결과에는 daily와 totals가 있었고, 해당 날짜의 기록이 나왔다. 일별 기록에는 입력·출력 토큰, 캐시 생성·읽기 토큰, 사용 모델과 totalCost가 포함됐다. --json은 표 대신 구조화된 텍스트로 받는 옵션이므로, 눈으로 볼 때는 생략해도 된다.

보고서의 비용은 기록과 가격 자료를 바탕으로 한 값이다. 실제 결제 내역과 일치한다고 가정하면 안 된다. ccusage 일별 보고서 설명과 함께 날짜별로 사용이 늘어난 지점을 찾는 용도로 쓰는 편이 좋다.

다른 컴퓨터에서 한 작업이나 웹 채팅은 이 로컬 기록에 모두 들어 있지 않다. 로그를 지웠거나 저장 경로가 다른 경우에도 보고서가 비어 있을 수 있다. 기록이 없다는 이유만으로 계정 사용량이 없다고 판단하지 않는다.

한도가 부족하면 무엇부터 바꾸면 되나?

먼저 한도에 도달한 것인지, 한 대화가 너무 길어진 것인지 구분한다. 사용량 제한은 일정 기간의 작업량에 관한 것이고, 길이 제한은 한 대화가 담을 수 있는 정보량에 관한 것이다. 새 대화를 여는 것만으로 해결되는 문제가 다르다.

1. 한도 항목과 초기화 시각을 기록한다. 현재 구간, 주간, 추가 모델 항목 중 어느 곳에 걸렸는지부터 본다. 매일 자정에 모두 풀린다고 가정하지 않는다.
2. 사용이 늘어난 작업을 찾는다. ccusage로 날짜를 좁히고 그날 어떤 일을 했는지 되짚는다. 긴 대화에서 반복 수정했는지, 여러 작업을 동시에 돌렸는지 확인할 수 있다.
3. 다음 작업의 범위를 줄여 본다. 예를 들어 프로젝트 전체를 한 번에 고쳐 달라고 요청했다면, 오류가 난 화면과 관련 파일부터 확인하도록 범위를 좁힌다. 결과를 확인하고 다음 수정을 요청하면 불필요한 반복을 줄이는 데 도움이 된다.

새 작업으로 넘어갈 때 대화를 정리하는 방법은 클로드 코드 기본 사용법에서 이어서 볼 수 있다. 다만 /clear로 새 세션을 열어도 이미 사용한 구독 한도가 돌아오는 것은 아니다.

이렇게 확인해도 필요한 작업을 자주 멈추게 된다면 클로드 코드 요금제와 비용 안내로 넘어가 플랜을 비교한다. 비교 전에 적어 둘 것은 “어떤 작업에서, 어느 한도에, 얼마나 자주 걸렸는가”다. 이 기록이 있어야 요금제를 바꾸는 이유가 분명해진다. 추가 사용량 크레딧을 선택하는 경우에는 별도 비용과 지출 한도도 함께 확인한다.

자주 묻는 질문

사용량 플러그인을 꼭 설치해야 하나?

남은 구독 한도를 한 번 확인하려면 /usage부터 열면 된다. 날짜별 기록이 필요할 때 ccusage를 추가하고, 항상 보이는 상태 표시가 필요해졌을 때 별도 도구를 검토해도 늦지 않다.

/usage의 비용이 구독료보다 큰데 추가 결제되나?

그 숫자만으로 추가 결제를 판단할 수 없다. 일반 구독 사용량의 세션 비용은 추정치다. 사용량 크레딧을 켰는지, API 키로 인증한 세션인지, 실제 결제 화면에는 무엇이 표시되는지 따로 확인한다.

터미널을 껐다 켜면 한도가 초기화되나?

계정의 구독 한도는 초기화되지 않는다. 새 대화의 기록과 계정 전체의 한도는 별개다. 화면의 Resets 시각을 기준으로 확인한다.

설치나 계정 설정부터 다시 살펴보고 싶다면 클로드 코드 시작 가이드에서 현재 단계에 맞는 글을 찾을 수 있다.

검증 기준

• 마지막 업데이트일: 2026-09-09
• 확인 환경: macOS 26.5.2, Claude Code 2.1.263의 Max 계정에서 /usage·/cost 실행, Node.js 22.22.0에서 ccusage 20.0.20 일별 조회. 공유 한도와 결제 설명은 공식 문서를 대조했다.
• 주요 근거: Claude Code 비용 안내 · Pro·Max 사용 안내 · 사용량과 길이 제한 · ccusage 일별 보고서 · ccusage 명령 옵션